laantungir/fips
1
0
Fork 0
mirror of https://github.com/jmcorgan/fips.git synced 2026-07-22 07:48:26 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
4890940bb7ba71f07b93f55bc72035924e111800
fips/docs/design/README.md
Johnathan Corgan 4890940bb7 Session 49: Wire protocol design with session indices 
- Add fips-wire-protocol.md: comprehensive packet dispatch design
  - Wire format: discriminator byte + session indices for O(1) dispatch
  - WireGuard-style roaming: crypto authority, not address
  - Security: rate limiting, replay protection, state machine strictness
  - Transport considerations for UDP, TCP, Tor

- Rename fips-protocol-flow.md → fips-session-protocol.md

- Update fips-design.md wire format section
  - Replace TLV with discriminator + index format
  - Cross-reference fips-wire-protocol.md for details

- Update cross-references in all design docs
2026-02-01 16:28:16 +00:00

2.2 KiB
Raw Blame History

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