Files
fips/docs/design
Johnathan Corgan b54c347e76 Session 40: Reconcile design docs with protocol flow decisions
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
2026-01-31 18:28:14 +00:00
..
2026-01-30 05:38:58 +00:00

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