mirror of https://github.com/jmcorgan/fips.git synced 2026-07-22 07:48:26 +00:00

Files

Johnathan Corgan 2941705b95 Session 63: Routing protocol design review and limitations

- Document flood convergence limitation: visited bloom filter prevents
  loops but not convergent duplicates; request_id dedup elevated to
  protocol requirement in gossip protocol propagation rules
- Document capacity-blind greedy routing limitation with locally-measured
  link quality mitigation (no protocol-level cost claims to prevent
  adversarial traffic attraction)
- Add discovery path accumulation enhancement opportunity: signed per-hop
  entries enable source peer bias, router hints, and cache seeding
- Correct visited filter description in both routing and gossip docs

2026-02-06 15:26:03 +00:00

fips-architecture.md

Truncate NodeAddr from 32 bytes to 16 bytes (first 128 bits of SHA-256)

2026-02-06 14:32:15 +00:00

fips-gossip-protocol.md

Session 63: Routing protocol design review and limitations

2026-02-06 15:26:03 +00:00

fips-intro.md

Truncate NodeAddr from 32 bytes to 16 bytes (first 128 bits of SHA-256)

2026-02-06 14:32:15 +00:00

fips-routing.md

Session 63: Routing protocol design review and limitations

2026-02-06 15:26:03 +00:00

fips-session-protocol.md

Truncate NodeAddr from 32 bytes to 16 bytes (first 128 bits of SHA-256)

2026-02-06 14:32:15 +00:00

fips-state-machines.md

Standardize naming conventions across docs and source

2026-02-06 04:03:32 +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

fips-wire-protocol.md

Standardize naming conventions across docs and source

2026-02-06 04:03:32 +00:00

README.md

Unify Noise IK for both link and session layers

2026-02-02 02:25:39 +00:00

spanning-tree-dynamics.md

Standardize naming conventions across docs and source

2026-02-06 04:03:32 +00:00

README.md

FIPS Design Documents

Protocol design specifications and analysis for the Federated Interoperable Peering System.

Suggested Reading Order

Start with the high-level architecture, then work through session flow, routing concepts, and finally the wire-level protocol details.

1. Introduction and Overview

Document	Description
fips-intro.md	Protocol introduction: goals, concepts, architecture

2. Protocol Flow (How Traffic Works)

Document	Description
fips-session-protocol.md	End-to-end session flow, Noise IK encryption, terminology

3. Routing (How Packets Find Their Way)

Document	Description
fips-routing.md	Routing concepts: bloom filters, discovery, greedy routing
spanning-tree-dynamics.md	Tree protocol behavior: convergence, partitions, recovery
fips-gossip-protocol.md	Wire formats: TreeAnnounce, FilterAnnounce, Lookup messages

4. Link Layer (How Peer Connections Work)

Document	Description
fips-wire-protocol.md	Transport layer: Noise IK, session indices, roaming, security
fips-transports.md	Transport-specific: UDP, Ethernet, Tor, radio characteristics

Implementation

Document	Description
fips-architecture.md	Software architecture: entities, state machines, configuration
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

Document Cross-References

                      fips-intro.md
                           │
              ┌────────────┴────────────┐
              ▼                         ▼
    fips-session-protocol.md    fips-architecture.md
              │                         │
    ┌─────────┴─────────┐               ▼
    ▼                   ▼         fips-transports.md
fips-routing.md   fips-wire-protocol.md
    │       │
    ▼       ▼
spanning-tree-dynamics.md ←→ fips-gossip-protocol.md