mirror of
https://github.com/jmcorgan/fips.git
synced 2026-08-09 00:04:54 +00:00
Wire Protocol (fips-wire-protocol.md): - Renamed to "FIPS Wire Protocol and Transport Layer Management" - Updated intro describing transport layer purpose - Documented reconnection handling approach (Option C) - Clarified UDP as expected majority for initial deployments Session Protocol (fips-session-protocol.md): - Renamed to "FIPS Session Protocol Flow" - Documented decisions throughout (removed alternatives analysis) - Corrected Noise patterns: Link=IK, Session=KK - Consolidated section 4 with fips-routing.md reference - Rewrote section 5 terminology with decisions - Merged duplicate crypto primitives sections - Added route determination and packet forwarding details
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-wire-protocol.md | Wire protocol: format, session indices, roaming, replay protection, DoS defense |
| 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 |
| fips-state-machines.md | Phase-based state machine pattern: peer lifecycle, transitions, timeout handling |
| fips-session-protocol.md | Session protocol: traffic flow, crypto sessions, terminology |