SMIP-MWP-Rust

SMIP-MWP-Rust is the Rust workspace for the SMIP-MWP datapath stack: crypto, routing, AF_XDP integration, CLI control-plane glue, and benchmark tooling. The repository is currently in active development on main. CI builds the workspace, runs tests, validates the bridge contract, and exercises the chaos benchmark/report gates.

This patch branch adds Multi-Channel Routing (MCR) spraying integration: routing table extensions, datapath hooks, bench harness flags, and documentation. See docs/mcr_architecture.md for details.

Current State

• Workspace crates: afxdp, bench, benchmark, cli, crypto, datapath, routing, and wire.
• Validation entry points: cargo test --workspace --all-targets, make verify-bridge, and make performance-envelope.
• Generated validation artifacts live under benchmark/, docs/perf/, and tools/bench_results/.
• The bridge validation wrapper is committed at tools/validation/verify_bridge.sh.
• Last verified locally: workspace tests, bridge validation, and the median/7-rep chaos gate configuration used by CI.

Quick Start

git clone https://github.com/rwilliamspbg-ops/SMIP-MWP-Rust.git
cd SMIP-MWP-Rust
source $HOME/.cargo/env
# Run the full test suite and bridge validation
cargo test --workspace --all-targets
make verify-bridge

# Run the chaos benchmark validation (CI-style)
SMIP-MWP-Rust is the Rust workspace for the SMIP-MWP datapath stack: crypto, routing, AF_XDP integration, CLI control-plane glue, and benchmark tooling. The repository is actively developed; CI builds the workspace, runs tests, validates the bridge contract, and exercises benchmark/chaos gates.

This workspace contains an active Multi-Channel Routing (MCR) feature (experimental). See [docs/mcr_architecture.md](docs/mcr_architecture.md) for architecture notes and the benchmark artifacts in `tools/bench_results/` for recent run outputs.
MOHAWK_MCR_CHANNELS=3 MOHAWK_MCR_SPRAY_MODE=primary ./tools/benchmark/run_chaos_epyc_profile.sh

Installation & Usage

Prerequisites:

• Rust toolchain (stable), Cargo
• For AF_XDP runs: Linux with AF_XDP-capable NIC and root privileges
• The repository contains active benchmark and profiling work (see tools/bench_results/ and benchmark/). Recent work includes allocator-pressure reductions on the datapath hot path and updates to the CI MCR baseline.
• Optional: Python3 for report generation Note: the CI MCR baseline file (tools/bench_results/ci_baseline_mcr.txt) was recently updated to reflect pinned smoke runs; merging that baseline requires a perf review / perf-approval according to repo policy.

Install and run locally:

# Build workspace
cargo build --release
## Badges & Status

- CI: build/test gates — top-level workflow ([`.github/workflows/ci.yml`](.github/workflows/ci.yml))
- Bench harness & remote bench workflows: `bench-harness.yml` and `remote-bench.yml`
- License: AGPL-3.0
- Rust toolchain: pinned via `rust-toolchain.toml` (workspace uses the Rust stable toolchain)

# Run the datapath binary (example):
# METRICS_SOCKET=/tmp/mohawk.metrics.sock MOHAWK_IFACE=ens1f0 target/release/mohawk-node

# Enable/disable MCR and tune channels via environment variables:
export MOHAWK_MCR_ENABLED=1           # 0|1 (default: 1)
 
When running local smoke or chaos benchmarks that affect CI baselines, prefer the harness scripts in `tools/` and follow the pinned run instructions in `benchmark/` or `tools/bench_results/FLAMEGRAPH_RUN.md` for flamegraph capture on self-hosted hosts.
export MOHAWK_MCR_SPRAY_MODE=primary  # primary|full (default: primary)
export MOHAWK_MCR_CHANNELS=3          # 1|3|5 (default: 3)
export MOHAWK_MCR_HASH_SEED=0xDEADBEEF

Repository Layout

• crypto/ - key exchange, session derivation, and AEAD helpers
• datapath/ - forwarding hot path and datapath tests
• afxdp/ - AF_XDP ring integration and mocks
• routing/ - route table and predictive routing
• bench/ - Criterion microbench harness and smoke-run utilities
• benchmark/ - chaos benchmark harness and performance envelope docs
• cli/ - binary entrypoint and bridge contract wiring
• wire/ - packet header marshal/parse and zero-copy view
• tools/ - benchmark, validation, plotting, and stress scripts

Validation And Performance

• benchmark/README.md explains the chaos benchmark harness and CI contract gate.
• docs/perf/README.md indexes checked-in Criterion and routing-sweep artifacts.
• RELEASE.md is the changelog for notable repo-level changes.

Notes

• The top-level CI workflow runs build, workspace tests, smoke validation, bridge validation, chaos report gating, and benchmark assertions.
• Validation runs may leave generated CSVs and reports in the working tree; those are derived artifacts, not source.
• The project is licensed under AGPL-3.0. See LICENSE for the full text.