Documentação Técnica // Oficial
Especificação Oficial do Protocolo KIX
A presente documentação descreve a arquitetura estrutural do protocolo KIX e as diretrizes técnicas que fundamentam sua infraestrutura como um ecossistema financeiro soberano, modular e escalável na segunda camada (Layer 2) do Bitcoin.
1. Desacoplamento entre Operação e Acesso
O princípio arquitetônico central do protocolo KIX baseia-se na separação estrita entre a camada de execução de software e a interface de acesso do usuário.
Operador KIX (A Camada Cofre): Consiste na máquina física ou servidor virtual (VPS) responsável pela operação. Atua como um ambiente isolado onde operam os nós da rede e onde o material criptográfico (chaves privadas) é estritamente mantido.
Terminal de Operação (A Camada Janela): Dispositivos móveis, como smartphones, atuam exclusivamente como terminais de comando. Não armazenam chaves privadas; sua função é emitir instruções (ex: criação de faturas) via interfaces padronizadas (gRPC/Runes, NWC ou WebSockets). Este isolamento garante que o comprometimento físico do terminal não resulte na exposição ou perda de fundos.
2. Motor de Execução (Core Lightning)
Para garantir a escalabilidade da rede e a viabilidade operacional em hardwares variados, o protocolo KIX adota o Core Lightning (CLN) como motor de execução preferencial.
- Otimização de Recursos: O CLN apresenta alta eficiência no consumo de memória (variando entre 50MB e 150MB de RAM). Esta característica viabiliza uma alta densidade de nós por hardware, superando implementações mais custosas.
- Escalabilidade Local (Soberania em Massa): A arquitetura suporta a execução simultânea de múltiplas instâncias isoladas de CLN conectadas a um único nó do Bitcoin Core local. Exige-se parametrização avançada do nó base (ajustes em
rpcthreads e dbcache) e armazenamento SSD NVMe para suportar I/O concorrente.
3. Topologia Híbrida (Integração de Light Clients)
O protocolo padroniza a capacidade de operação descentralizada sem a obrigatoriedade da manutenção de um nó completo (Full Node) na ponta operacional.
- Light Clients via Plugins: Utilizando extensões nativas (como folgore ou sauron), a instância CLN delega a validação do estado da blockchain a um indexador remoto (Esplora).
- Minimização de Requisitos: Derruba a exigência de armazenamento de 1TB (IBD completo) para menos de 1GB, permitindo que o KIX rode em hardware modesto ou legado com sincronização instantânea.
4. Infraestrutura Central de Indexação
Para cenários onde múltiplos nós leves dependem de um indexador comum (Esplora público ou coletivo), a infraestrutura central deve seguir:
- Requisitos de Hardware: Servidores Bare Metal multicore, discos Enterprise NVMe em RAID e capacidade massiva de RAM (128GB a 256GB).
- Arquitetura de Cache: RAM intensiva para manter o RocksDB disponível, combinada a um proxy reverso (NGINX) com cache de requisições redundantes para evitar quedas no "efeito manada" durante a mineração de blocos.
5. Escalabilidade Horizontal (Nuvem K8s)
Para implantações KIX orientadas a Cloud/SaaS de larga escala, o Docker Compose é substituído por Kubernetes (K8s).
- Gestão de Estado: Orquestração via StatefulSets, garantindo acesso a volumes imutáveis (Persistent Volumes) para prevenir corrupção no estado dos canais Lightning.
- Isolamento Total: Segmentação via Namespaces e NetworkPolicies, criando barreiras criptográficas rígidas entre nós de diferentes comerciantes.
6. Perfis Oficiais de Implantação KIX
O ecossistema é modularizado em quatro perfis de implantação para adaptar-se à capacidade técnica e necessidade de soberania do operador:
| Perfil (Deploy) |
Arquitetura Técnica |
Cenário Ideal |
KIX Horizon Nó Satélite (MVP) |
CLN Local + Esplora Terceirizado |
Custo zero de infraestrutura pesada na ponta. Chaves privadas com o comerciante e indexação na nuvem. |
KIX Fleet Nuvem Gerenciada |
Kubernetes + CLN Isolados |
Foco em conveniência e escala. O comerciante não quer gerenciar hardware nenhum. |
KIX Fortress Bunker Soberano |
Bitcoin Core Local + CLN Local |
Zero confiança em terceiros (Trustless). Exige hardware robusto e controle total da blockchain. |
KIX Nexus Ponte Modular |
CLN KIX + Alby Hub |
Usuários que priorizam interfaces visuais modulares de terceiros operando sob as regras do KIX. |