ZLV | REPOSITÓRIO TÉCNICO KIX

KIX é um Framework de Soberania Comercial projetado para permitir que comerciantes façam a transição de sistemas centralizados e monitorados para a rede Bitcoin Lightning. Ele foi projetado para imitar a experiência de uso do Pix no Brasil, funcionando efetivamente como um “Pixel Paralelo” que contorna vigilância financeira e bloqueios arbitrários de bancos.

🇧🇷 A Estratégia do "Pix": Engenharia Cognitiva

No Brasil, o Estado realizou o maior treinamento em massa da história: ensinou mais de 150 milhões de pessoas a usar QR codes para pagamentos instantâneos. O KIX captura essa doutrina.

Mimetismo: O KIX não pede que o usuário aprenda “cripto”. Ele apenas pede que escaneie o Pixel Rosa.
Secessão Econômica: Aproveitando o hábito do fluxo do Pix, o KIX substitui a supervisão do Banco Central por um motor de pagamentos peer-to-peer baseado em Lightning.
Alinhamento de Incentivos: “Por que dar 8% para o banco e para o Estado quando você pode ficar com 5% e dar 3% ao cliente em pontos de dinheiro sólido?”

🏗️ Arquitetura do Sistema

┌────────────────────────────┐ │ Merchant UI │ │ (KIX Dashboard-homepage) │ └─────────┬──────────────────┘ │ ▼ ┌───────────────────┐ │ LNbits │ │ Payment Engine │ └─────────┬─────────┘ │ ▼ ┌───────────────────┐ │ Lightning Node │ │ Phoenixd / Alby │ └─────────┬─────────┘ │ ┌─────────────┴─────────────┐ │ │ ▼ ▼ Tor Hidden Service VPS Gateway (.onion access) (Port 80)

O sistema utiliza encapsulamento com Docker para fornecer escalabilidade horizontal em um único host. Cada instância contém:

Dashboard: Interface web centralizada (Homepage) para gerenciamento.
Engine (LNbits): Um poderoso processador de pagamentos Lightning.
Vault (Phoenixd / Alby Hub): Gerenciamento seguro de chaves e conexão com nó Lightning leve.
Tor Bridge: Container baseado em Alpine que gera URLs Onion únicas em tempo real.

🚀 Primeiros Passos

1. Requisitos

Docker & Docker Compose
Privilégios sudo (gerenciamento de volumes e Tor)
Se o Tor demorar para gerar chaves: sudo apt install haveged

2. Métodos de Instalação e Deploy

Método	Script	Descrição
1. Soberano	`kix_tor_sovereign.sh`	Máxima secessão, Tor (.onion). Executa LNbits com Alby Hub.
2. Phoenixd	`kix_phoenixd.sh`	Nó Phoenix multi-instância ultra leve + LNbits + Tor.
3. VPS Dedicada	`kix_vps_dedicated.sh`	Deploy público em clearnet (porta 80).
4. Híbrido	`kix_vps_shared.sh`	Exposição de nó doméstico através de um VPS usando túnel seguro.

2.1 Método Phoenixd Multi-Hunter (Recomendado)

Utiliza o orquestrador para implantar nós isolados com volumes únicos.

sudo chmod +x kix_phoenixd.sh
./kix_phoenixd.sh v1

Isolamento: Cria diretórios ~/PHOENIX_[ID] para evitar colisão de dados. O LNbits é configurado automaticamente com a API do Phoenixd.

⚠️ IMPORTANTE: O Phoenix abre o primeiro canal automaticamente. Os primeiros ~20.000 sats são usados para abertura de canal. É FUNDAMENTAL guardar a seed.dat. Ela é a única forma de recuperar fundos.

2.2 Método Soberano (Tor + Alby Hub)

Configuração de máxima soberania via serviço oculto .onion.

sudo chmod +x kix_tor_sovereign.sh
./kix_tor_sovereign.sh 1

2.4 Método VPS Compartilhado + Bridge (Híbrido)

Topologia: Home Node → Secure Tunnel → Public VPS Gateway. Requer túnel WireGuard/Tailscale pré-configurado.

./kix_vps_shared.sh
./kix_vps_bridge.sh

🧰 Gerenciamento e Monitoramento

Verificar carga: htop
Monitorar containers: sudo docker stats
Limpar volumes: sudo docker volume prune -f

🔐 AVISO DE SEGURANÇA: KIX é uma ferramenta de autonomia. Você é o único responsável por suas chaves, segurança do nó e conformidade. Not your keys, not your coins.

📦 Metadados do Repositório

Tópicos: bitcoin, lightning-network, lnbits, phoenixd, privacy, sovereignty