mirror of
https://github.com/jmcorgan/fips.git
synced 2026-07-30 19:46:15 +00:00
Johnathan Corgan
5d190885ec
Add comprehensive design doc for FIPS protocol message flow covering: - DNS-based identity cache priming (npub.fips format) - TUN reader processing pipeline - Crypto session (Noise KK with secp256k1) vs routing session distinction - Combined establishment model (routing + crypto in single round-trip) - Noise KK pattern with ChaCha20-Poly1305, AEAD-only authentication - Route discovery via bloom filters and LookupRequest flooding - Crossing hellos handling with deterministic tie-breaker (lower npub wins) Includes reconciliation section tracking alignment with existing design docs (fips-routing.md terminology updates pending).
FIPS Design Documents
Protocol design specifications and analysis for the Federated Interoperable Peering System.
Protocol Design
| Document | Description |
|---|---|
| fips-design.md | Core protocol specification: goals, architecture, identity, addressing, spanning tree |
| fips-routing.md | Routing architecture: Bloom filters, discovery protocol, session establishment |
| fips-transports.md | Transport protocol characteristics: UDP, Ethernet, Tor, radio, and other link types |
| spanning-tree-dynamics.md | Detailed study of spanning tree gossip protocol behavior and convergence |
Implementation
| Document | Description |
|---|---|
| fips-architecture.md | Software architecture: entities, state machines, transport abstractions, configuration |
| fips-architecture-review.md | Architecture review issues and resolution status |
| fips-tun-driver.md | TUN interface driver: reader/writer threads, ICMPv6, packet flow |