Об этом проекте

Mohawk Nexus — это корневое интеграционное рабочее пространство для сетевого стека Mohawk. Оно объединяет несколько компонентов в одном репозитории, чтобы их можно было собирать, проверять и тестировать вместе. Структура рабочего пространства - SMIP-MWP: управляющая плоскость на Go, охватывающая интеграцию AF_XDP, маршрутизацию, криптографические привязки и обработку мостовых запросов. - SMIP-MWP-Rust: плоскость данных на Rust с конвейером пересылки, высокопроизводительной плоскостью данных и инструментами CLI. - Sovereign-Mohawk-Proto: определения протоколов, эволюция схем и средства формальной верификации. - bridge: каноническая мостовая схема, манифест и примеры запросов, используемые корневой проверкой. - scripts: вспомогательные средства генерации, проверки и тестирования на уровне рабочего пространства. - go.work связывает модули Go вместе. Требования и настройка Go (версия 1.26.1 зафиксирована для воспроизводимых сборок; для большинства локальных рабочих процессов ожидается работа с версией 1.22+), Python 3.8+, Docker для контейнерных прогонов производительности и нагрузочных тестов, а также инструментарий Rust только при локальном запуске тестов плоскости данных на Rust. Конфигурация devcontainer фиксирует Go для Codespaces/Dev Containers, и предоставлены инструкции для локальной установки Go без прав sudo. Совместимость устройств Матрица описывает поддерживаемые профили: серверы Linux x86_64 с сетевыми картами, поддерживающими AF_XDP (ускоренный режим), серверы Linux arm64 и граничные узлы, Raspberry Pi/ARM SBC, машины разработчиков на macOS и Windows, а также управляемый Kubernetes без привилегированных подов (переносимый режим). Ускоренная плоскость данных AF_XDP доступна только на Linux; переносимые рабочие процессы охватывают управление, сервисы FL и SWIP, а также проверку моста. Профили выполнения: переносимый, ускоренный и экспериментальный. Использование Общие цели Make включают bootstrap, status, verify, generate-bridge, validate-bridge, verify-go, bridge-smoke и verify-rust. Локальный краткий старт FL собирает и запускает координатор с двумя клиентами через docker-compose. Нагрузочные и стресс-тесты производительности запускаются через scripts/bench.sh и стрессовый Dockerfile, записывая результаты бенчмарков и артефакты pprof в SMIP-MWP/benchmarks/. Возможности - Высокопроизводительная плоскость данных: пересылка на Rust плюс интеграция AF_XDP для обработки пакетов с низкой задержкой. - Подключаемая криптография: симметричные и асимметричные примитивы с шифрованием/дешифрованием на месте для уменьшения выделений памяти. - Проверка мостового контракта: каноническая схема и манифест с валидаторами, принадлежащими корню, и воспроизводимыми проверками SHA256 для примеров полезных нагрузок. - Интегрированные тестовые стенды, создающие повторяемые артефакты и профили pprof. - Проверка, удобная для CI: make verify запускает проверку на корневом уровне без зависимости от SHA неопубликованных подрепозиториев. - Контейнерные прогоны производительности через Dockerfile и скрипты. В README также приводятся внутренние показатели микробенчмарков (пересылка, многоадресное распыление, криптография, сессии/маршрутизация, AF_XDP) на оборудовании AMD EPYC с оговоркой, что результаты зависят от конфигурации CPU, ядра, сетевой карты и обхода ядра. Отмечается, что проект ставит приоритет на безопасность, формальные методы, многоадресное распыление и суверенные функции выше максимальной скорости пакетов. Инструментарий мостового контракта включает скрипты для перегенерации канонических артефактов, перегенерации констант SDK моста для Go/Rust/Python/TypeScript и проверки манифеста и хешей; bridge/bridge_contract.version.json отслеживает версии схемы и манифеста. CI запускает make verify из корня репозитория. Рабочее пространство имеет несколько лицензий, поскольку объединяет компоненты с разными исходными лицензиями, что задокументировано в LICENSE и LICENSES.md.