mirror of https://github.com/jmcorgan/fips.git synced 2026-08-09 08:14:42 +00:00

Files

T

Johnathan Corgan 0076e9930c Session 48: Wire format design and logging improvements

Wire format:
- Add HandshakeMessageType enum (NoiseIKMsg1=0x01, NoiseIKMsg2=0x02)
- Define unified TLV framing for handshake and post-handshake messages
- Update fips-design.md and fips-protocol-flow.md with wire format details

Initialization:
- Defer TUN setup until after peer connections initiated
- Order: packet channel → transports → peers → TUN

Logging cleanup:
- Consolidate node/TUN info logs into aligned multi-line format
- TUN shutdown: single start/stop message, remove intermediate noise
- Remove ip link show callout and redundant Starting node message
- Change UDP transport stopped to debug level

2026-02-01 05:18:59 +00:00

fips-architecture-review.md

Complete FIPS architecture review cleanup

2026-01-29 18:17:07 +00:00

fips-architecture.md

Session 41: Peer authentication protocol design

2026-01-31 19:13:15 +00:00

fips-design.md

Session 48: Wire format design and logging improvements

2026-02-01 05:18:59 +00:00

fips-protocol-flow.md

Session 48: Wire format design and logging improvements

2026-02-01 05:18:59 +00:00

fips-routing.md

Session 40: Reconcile design docs with protocol flow decisions

2026-01-31 18:28:14 +00:00

fips-state-machines.md

Separate protocol layers: link vs session message types

2026-02-01 03:19:54 +00:00

fips-transports.md

Restructure config to match sysctl-style paths

2026-01-29 19:49:37 +00:00

fips-tun-driver.md

Add TUN driver design document

2026-01-30 05:38:58 +00:00

README.md

Session 43: CLI config option and state machine design

2026-01-31 23:33:02 +00:00

spanning-tree-dynamics.md

Resolve architecture review items and reconcile terminology

2026-01-29 17:00:33 +00:00

README.md

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
fips-state-machines.md	Phase-based state machine pattern: peer lifecycle, transitions, timeout handling
fips-protocol-flow.md	Protocol message flow: packet channel, event loop, dispatching