mohawk-nexus

Mohawk Nexus es el espacio de trabajo raíz de integración para la pila de red Mohawk. Agrega varios componentes en un solo repositorio para que puedan construirse, validarse y probarse juntos. Estructura del espacio de trabajo - SMIP-MWP: Plano de control en Go que cubre integración AF_XDP, enrutamiento, enlaces criptográficos e ingesta de solicitudes de puente. - SMIP-MWP-Rust: Plano de datos en Rust con pipeline de reenvío, plano de datos de alto rendimiento y herramientas CLI. - Sovereign-Mohawk-Proto: Definiciones de protocolo, evolución de esquemas y activos de verificación formal. - bridge: Esquema canónico de puente, manifiesto y ejemplos de solicitudes utilizados por la validación raíz. - scripts: Asistentes de generación, validación y prueba a nivel de espacio de trabajo. - go.work une los módulos de Go. Requisitos y configuración Go (1.26.1 fijado para builds reproducibles; se espera que 1.22+ funcione en la mayoría de flujos locales), Python 3.8+, Docker para ejecuciones de rendimiento/carga contenedorizadas, y toolchain de Rust solo para pruebas locales del plano de datos. Una configuración de devcontainer fija Go para Codespaces/Dev Containers, e incluye instrucciones para instalación local sin sudo. Compatibilidad de dispositivos Una matriz describe perfiles soportados: servidores Linux x86_64 con NICs compatibles con AF_XDP (acelerado), servidores/nodos periféricos Linux arm64, Raspberry Pi/SBCs ARM, máquinas de desarrollo macOS y Windows, y Kubernetes gestionado sin pods privilegiados (portátil). El plano de datos AF_XDP acelerado es solo Linux; los flujos portátiles cubren control, FL y servicios SWIP más validación de puente. Los perfiles de ejecución son portátiles, acelerados y experimentales. Uso Los objetivos Make comunes incluyen bootstrap, status, verify, generate-bridge, validate-bridge, verify-go, bridge-smoke y verify-rust. Un quickstart local de FL construye y ejecuta un coordinador con dos clientes mediante docker-compose. Los harnesses de rendimiento y estrés se ejecutan con scripts/bench.sh y un Dockerfile de estrés, escribiendo salidas de benchmark y artefactos pprof en SMIP-MWP/benchmarks/. Capacidades - Plano de datos de alto rendimiento: Reenviador en Rust más integración AF_XDP para procesamiento de paquetes de baja latencia. - Criptografía conectable: Primitivas simétricas y asimétricas con cifrado/descifrado in-place para reducir asignaciones. - Validación de contrato de puente: Esquema canónico y manifiesto con validadores raíz y verificaciones SHA256 reproducibles para cargas de ejemplo. - Harness de prueba integrados que producen artefactos repetibles y perfiles pprof. - Verificación amigable con CI: make verify ejecuta validación raíz sin depender de SHAs de subrepositorios no publicados. - Ejecuciones de rendimiento contenedorizadas mediante Dockerfiles y scripts. El README también reporta cifras de micro-benchmarks internos (reenvío, dispersión multi-ruta, criptografía, sesión/enrutamiento, AF_XDP) en hardware AMD EPYC, con la advertencia de que los resultados dependen de CPU, kernel, NIC y configuración de bypass de kernel. Nota que el proyecto prioriza seguridad, métodos formales, dispersión multi-ruta y características soberanas sobre tasas máximas de paquetes. La herramienta de contrato de puente incluye scripts para regenerar artefactos canónicos, regenerar constantes SDK de puente para Go/Rust/Python/TypeScript, y validar el manifiesto y hashes; bridge/bridge_contract.version.json rastrea versiones de esquema y manifiesto. CI ejecuta make verify desde la raíz del repositorio. El espacio de trabajo es multi-licencia porque agrega componentes con diferentes licencias upstream, documentadas en LICENSE y LICENSES.md.