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

Files

T

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

128-bit truncated SHA-256 provides adequate collision resistance
(2^64 birthday bound, 2^128 pre-image) while cutting per-packet
header overhead nearly in half, aligning with Yggdrasil's approach
and IPv6 address size.

Code changes:
- NodeAddr inner type [u8; 32] → [u8; 16], from_pubkey takes first 16 bytes
- DATA_HEADER_SIZE 68 → 36, signing_bytes capacity 80 → 48
- proof_bytes capacity 40 → 24
- Updated all make_node_addr test helpers and size assertion tests

Doc changes:
- All wire format tables and offset calculations updated
- AncestryEntry size 112 → 96 bytes
- Packet size examples recalculated throughout

2026-02-06 14:32:15 +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

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

2026-02-06 14:32:15 +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

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

2026-02-06 14:32:15 +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