Johnathan Corgan
d71e48b0f2
Module reorganization, identity test coverage, design doc corrections
...
Module reorganization:
- Split identity.rs (930 lines) into identity/ directory module:
mod.rs, node_addr.rs, address.rs, peer.rs, local.rs, auth.rs,
encoding.rs, tests.rs — following established bloom/, tree/, noise/
pattern
- Group TUN, DNS, and ICMPv6 into upper/ module as the IPv6 adaptation
layer: move tun.rs, icmp.rs, node/dns.rs into upper/
Identity test coverage (28 new tests, 52 total):
- Encoding error paths: invalid npub/nsec length, bad hex input
- NodeAddr: Debug, Display, as_slice, AsRef, Hash
- FipsAddress: from_slice, From trait, Debug, Display, Eq+Hash
- PeerIdentity: from_pubkey_full, pubkey_full parity paths, Debug
- Identity: keypair, pubkey_full, Debug
- AuthChallenge: from_bytes
Design doc corrections (fips-software-architecture.md):
- Identity struct: npub+nsec fields → keypair: Keypair with accessors
- Node struct: TunInterface → TunState, Transport → TransportHandle,
Peer → PeerSlot
- Peer section: monolithic Peer → two-phase PeerSlot (PeerConnection +
ActivePeer) with HandshakeState/ConnectivityState
- ActivePeer: npub → identity: PeerIdentity, ancestry Vec → Option,
declaration/inbound_filter wrapped in Option
- BloomState: add 4 missing fields, fix update_debounce type
- DiscoveredPeer: field name and type corrections
2026-02-15 17:11:58 +00:00
Johnathan Corgan
20467f5650
Design doc audit: correct 7 code/doc divergences across 5 documents
...
Systematic review identified 12 divergences between design docs and
implementation. Corrected 7, deferred 3 for further analysis.
Changes:
- Session tie-breaker: npub → node_addr ordering
- Dual cache architecture: CoordCache (50K, TTL 300s) and RouteCache
(10K, LRU) with correct names, sizes, and eviction policies
- LookupResponse routing: greedy-only → find_next_hop + reverse-path
- Discovery TTL default: 8 → 64
- Parent selection: v1 depth-only algorithm, cost metrics marked v2
- Leaf-only mode: implementation status note added
- Data overhead: 36-byte → 38-byte header
- Verification pass fixed stale cache/header refs in session protocol doc
2026-02-14 19:26:25 +00:00
Johnathan Corgan
73129f16d7
Rename design docs for clarity, reorganize node architecture diagram
...
- fips-architecture.md → fips-software-architecture.md with all
cross-references updated (4 files)
- fips-transport-abstraction.svg → fips-node-architecture.svg, moved
from Transport Abstraction section to Architecture Overview in
fips-intro.md
- Added descriptive paragraph for node architecture diagram covering
three-layer design (application interfaces, router core, transports)
2026-02-13 15:03:06 +00:00
Johnathan Corgan