Expand description
rusty_esp_iroh-bridge — the Janus bridge (N3).
A std process (a Pi, a P4, a laptop) holds one iroh endpoint and
fronts N radio neighbours that cannot run iroh themselves: a C6 over
ESP-NOW, a LoRa node. Each neighbour links to the bridge with
rusty_esp_signal’s authenticated session (the neighbour’s key stays on
the neighbour; the bridge keeps the session), sends its own signed
manifest, and its telemetry is re-framed onto janus/media/1. The
home computer asks the bridge Request::Neighbours and gets each
neighbour’s DID, manifest and signature verbatim — it verifies the
neighbour, not the bridge.
radio::Radiois the seam a Pi fills with a serial-attached C6 or SX1262;radio::FakeBusis the host’s.neighbour::BridgeCoreis the whole neighbour state machine, driven one frame at a time and free of threads.Bridgeruns the radio loop on a thread and hands the iroh node its two seams: aNeighbourSourceand a media factory fornbrt.sim::NeighbourSimis the neighbour’s side, for tests and the example.
Re-exports§
pub use neighbour::BridgeCore;pub use neighbour::BridgeCounters;pub use neighbour::CODEC_NEIGHBOUR_TELEMETRY;pub use neighbour::Event;pub use neighbour::NeighbourPacket;pub use neighbour::Reach;pub use radio::BROADCAST;pub use radio::FakeBus;pub use radio::FakeRadio;pub use radio::PeerAddr;pub use radio::Radio;
Modules§
- neighbour
- The bridge’s side of every neighbour: the
rusty_esp_signalhandshake answered, the session kept, the neighbour’s own signed manifest received and verified, its telemetry attributed. - radio
- The radio seam: what the bridge needs from an ESP-NOW or LoRa attachment, and an in-memory bus that stands in for one on the host.
- sim
- The neighbour’s side, on the host: what a C6 or a LoRa node does over
rusty_esp_signalto appear behind a bridge. A firmware implements the same four steps over its radio; this is the reference the tests and the example drive.
Structs§
- Bridge
- The radio loop and the fan-out of its events.
- Core
Handle - A
NeighbourSourceover the shared core. - DynRng
- A boxed
Rngas a sized one: the link’s handshake takes&mut impl Rng, and a core that owns any RNG needs this shim. - HostRng
- The operating system’s random source as the family’s
Rngseam, for the bridge’s handshakes on a host.