mirror of
https://github.com/jmcorgan/fips.git
synced 2026-07-22 07:48:26 +00:00
SVG diagrams for fips-intro: architecture, mesh topology, transport abstraction
Replace three ASCII art diagrams in fips-intro.md with SVG images: - Architecture overview: 5-node 4-hop path with layered node boxes - Mesh topology: 8-node network with spanning tree highlighted - Transport abstraction: full node stack with 10 transport plugins
This commit is contained in:
@@ -65,23 +65,12 @@ routing logic works regardless of the underlying transport mix.
|
||||
|
||||
## Architecture Overview
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Application Layer │
|
||||
│ (native FIPS API, or IPv6 via TUN adapter) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ FIPS Router │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
|
||||
│ │ Identity │ │ Spanning │ │ Bloom Filter │ │
|
||||
│ │ (npub) │ │ Tree │ │ Routing Table │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ Transport Abstraction │
|
||||
│ ┌────────┐ ┌──────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │
|
||||
│ │ UDP │ │ Ethernet │ │ WiFi │ │ Radio │ │ Onion │ │
|
||||
│ └────────┘ └──────────┘ └────────┘ └────────┘ └────────┘ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||

|
||||
|
||||
Each link uses a different transport, but the end-to-end session encryption
|
||||
is independent of the transport mix. Intermediate nodes decrypt the link
|
||||
layer to make routing decisions, then re-encrypt for the next hop. They
|
||||
cannot read the session-layer payload.
|
||||
|
||||
Applications can use the native FIPS datagram service directly, or access the
|
||||
mesh through an IPv6 adaptation layer (TUN device) for compatibility with
|
||||
@@ -255,6 +244,8 @@ See [fips-wire-protocol.md](fips-wire-protocol.md) for link encryption and
|
||||
|
||||
## Spanning Tree Protocol
|
||||
|
||||

|
||||
|
||||
The spanning tree is a subset of the full mesh network that connects all nodes,
|
||||
forming a tree structure rooted at a deterministically-elected node. Each node
|
||||
selects a single parent, and the resulting tree serves as the routing backbone.
|
||||
@@ -411,24 +402,7 @@ A **transport** is a physical or logical interface: a UDP socket, an Ethernet
|
||||
NIC, a Tor client, a radio modem. A **link** is a connection instance to a
|
||||
specific peer over a transport.
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ FIPS Node │
|
||||
│ ┌─────────────────────────────────┐ │
|
||||
│ │ Router Core │ │
|
||||
│ └──────────┬──────────┬───────────┘ │
|
||||
│ │ │ │
|
||||
│ ┌──────┴────┐ ┌───┴─────┐ │
|
||||
│ │ UDP │ │ LoRa │ │
|
||||
│ │ Transport │ │Transport│ │
|
||||
│ └────┬──────┘ └────┬────┘ │
|
||||
└───────────┼─────────────┼──────────────┘
|
||||
│ │
|
||||
┌────┴────┐ ┌─────┴────┐
|
||||
│Internet │ │ Radio │
|
||||
│ Peers │ │ Peers │
|
||||
└─────────┘ └──────────┘
|
||||
```
|
||||

|
||||
|
||||
### Multi-Transport Bridging
|
||||
|
||||
|
||||
Reference in New Issue
Block a user