mirror of
https://github.com/jmcorgan/fips.git
synced 2026-08-09 08:14:42 +00:00
Align terminology and cross-references across all FIPS design documents based on decisions made in fips-protocol-flow.md (Session 39). Key changes: - Distinguish "Routing Session" (hop-by-hop cache) from "Crypto Session" (end-to-end Noise KK encryption) throughout all docs - Add handshake_payload field to SessionSetup/SessionAck for combined establishment of routing and crypto sessions - Update fips-design.md encryption section to reference Noise KK - Add SessionSetup (0x06), SessionAck (0x07), CoordsRequired (0x08) message types - Add Crypto Session Management config section to fips-architecture.md - Add cross-references to fips-protocol-flow.md in all design docs - Update reconciliation tracking in protocol-flow.md §7
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 |