mohawk-nexus

Mohawk Nexus é o workspace raiz de integração para a pilha de rede Mohawk. Ele agrega vários componentes em um único repositório para que possam ser construídos, validados e testados em conjunto. Layout do workspace - SMIP-MWP: Plano de controle Go cobrindo integração de host AF_XDP, roteamento, bindings de criptografia e ingestão de solicitações de bridge. - SMIP-MWP-Rust: Datapath Rust com pipeline de encaminhamento, plano de dados de alto desempenho e ferramentas CLI. - Sovereign-Mohawk-Proto: Definições de protocolo, evolução de esquema e ativos de verificação formal. - bridge: Esquema canônico de bridge, manifesto e exemplos de solicitações usados pela validação raiz. - scripts: Helpers de geração, validação e teste em nível de workspace. - go.work une os módulos Go. Requisitos e configuração Go (1.26.1 fixado para builds reproduzíveis; 1.22+ esperado para funcionar na maioria dos fluxos de trabalho locais), Python 3.8+, Docker para execuções de desempenho/estresse em contêineres, e um toolchain Rust apenas ao executar testes locais do datapath Rust. Uma configuração devcontainer fixa o Go para Codespaces/Dev Containers, e instruções são fornecidas para uma instalação local do Go sem sudo. Compatibilidade de dispositivos Uma matriz descreve perfis suportados: servidores Linux x86_64 com NICs capazes de AF_XDP (acelerado), servidores/nós de borda Linux arm64, Raspberry Pi/SBCs ARM, máquinas de desenvolvimento macOS e Windows, e Kubernetes gerenciado sem pods privilegiados (portátil). O datapath AF_XDP acelerado é exclusivo para Linux; fluxos de trabalho portáteis cobrem controle, serviços FL e SWIP, além de validação de bridge. Os perfis de runtime são portátil, acelerado e experimental. Uso Alvos Make comuns incluem bootstrap, status, verify, generate-bridge, validate-bridge, verify-go, bridge-smoke e verify-rust. Um quickstart FL local constrói e executa um coordenador com dois clientes via docker-compose. Harnesses de desempenho e estresse são executados via scripts/bench.sh e um Dockerfile de estresse, gravando saída de benchmark e artefatos pprof sob SMIP-MWP/benchmarks/. Capacidades - Datapath de alto desempenho: Forwarder Rust mais integração AF_XDP para processamento de pacotes de baixa latência. - Criptografia plugável: Primitivas simétricas e assimétricas com criptografia/descriptografia in-place para reduzir alocações. - Validação de contrato de bridge: Esquema canônico e manifesto com validadores de propriedade raiz e verificações SHA256 reproduzíveis para payloads de exemplo. - Harnesses de teste integrados produzindo artefatos repetíveis e perfis pprof. - Verificação amigável a CI: make verify executa validação em nível raiz sem depender de SHAs de sub-repositórios não publicados. - Execuções de desempenho em contêineres via Dockerfiles e scripts. O README também relata figuras internas de micro-benchmark (encaminhamento, spray multi-caminho, criptografia, sessão/roteamento, AF_XDP) em hardware AMD EPYC, com a ressalva de que os resultados dependem de CPU, kernel, NIC e configuração de bypass de kernel. Ele observa que o projeto prioriza segurança, métodos formais, spray multi-caminho e recursos soberanos sobre taxas máximas brutas de pacotes. Ferramentas de contrato de bridge incluem scripts para regenerar artefatos canônicos, regenerar constantes de bridge SDK para Go/Rust/Python/TypeScript, e validar o manifesto e hashes; bridge/bridge_contract.version.json rastreia versões de esquema e manifesto. CI executa make verify a partir da raiz do repositório. O workspace é multi-licença porque agrega componentes com diferentes licenças upstream, documentadas em LICENSE e LICENSES.md.