Transport Subsystem (``fleetmesh_node.transport``) ========================================= The ``fleetmesh_node.transport`` package implements the multi-rung transport ladder. Traffic automatically ascends through available rungs based on peer capabilities, firewall conditions, and cryptographic policies. Transport Ladder Architecture ----------------------------- The Transport Router evaluates outbound routes across a prioritized ladder sorted by rank (lowest rank is attempted first): 1. **FIPS Rung** (Rank 5, mTLS / Datagram): Hardware-enforced mutual authentication using NIST-approved curves and FIPS 140-3 validated cryptography. 2. **Iroh Rung** (Rank 10, QUIC): Direct, encrypted point-to-point datagrams with ALPN negotiation, DERP relay hole punching, and high throughput. 3. **Rhio Rung** (Rank 12, NATS JetStream): Micro-datacenter cluster synchronization delivering through local Unix domain socket IPC to the Rhio sidecar daemon. 4. **P2Panda Rung** (Rank 15, Append-Only Operation Chains): Peer-to-peer delivery wrapping DIDComm messages into signed p2panda operations published to local append-only logs and synced peers. 5. **Relay Rung** (Rank 30, WebSocket): Outbound-only fallback over public or private Nostr relays. Guarantees reachability behind strict firewalls and NATs. Telemetry Metric Tags ^^^^^^^^^^^^^^^^^^^^^ The router reports successful deliveries via the ``metric_tags()`` method. Telemetry dynamically records delivery counts across all active rungs (including pluggable rungs whenever ``success_counts[rung] > 0``), ensuring complete visibility into multi-protocol routing efficiency. Transport Router ---------------- .. automodule:: fleetmesh_node.transport.router :members: :undoc-members: :show-inheritance: Ladder State Machine -------------------- .. automodule:: fleetmesh_node.transport.ladder :members: :undoc-members: :show-inheritance: Rung Base Contract ------------------ .. automodule:: fleetmesh_node.transport.rung :members: :undoc-members: :show-inheritance: Relay Rung Implementation ------------------------- .. automodule:: fleetmesh_node.transport.relay_rung.core :members: :undoc-members: :show-inheritance: Iroh QUIC Rung -------------- .. experimental:: .. automodule:: fleetmesh_node.transport.iroh_rung.core :members: :undoc-members: :show-inheritance: FIPS Transport Rung ------------------- .. experimental:: .. automodule:: fleetmesh_node.transport.fips_rung.core :members: :undoc-members: :show-inheritance: mDNS Local Discovery -------------------- .. automodule:: fleetmesh_node.transport.mdns :members: :undoc-members: :show-inheritance: DNS TXT Resolution ------------------ .. automodule:: fleetmesh_node.transport.dnstxt :members: :undoc-members: :show-inheritance: DIDComm Inbound Handler ----------------------- .. automodule:: fleetmesh_node.transport.didcomm_inbound :members: :undoc-members: :show-inheritance: Pluggable Protocol Host ----------------------- .. automodule:: fleetmesh_node.transport.host :members: :undoc-members: :show-inheritance: