Expand description
Direct-peer live pub/sub assembled over the portable routing module.
Experimental: callers supply VERIFIED policies and peer address hints. No invitation verification, group encryption, retained delivery or identity storage yet. This module must not be presented as secure group management. Traffic is direct QUIC/TLS, bound to the authenticated peer’s identity; no forwarding through other endpoints. Only locally installed policies authorize.
Modules§
- resources
- Authorized immutable byte transfers. Catalogs and recipient grants belong to the caller; this module binds a short-lived read capability to a verified workspace endpoint and runs the standard iroh-blobs range/verification engine. No file bytes enter the message journal and no file-size ceiling is imposed.
Structs§
- Admission
Report - Acceptance of an operation. Publications enter consumer queues; this is not a delivery/read receipt. Subscription operations update interest. A timeout may have occurred after admission; retry semantics are not implemented yet.
- Capacity
Counts - Connections closed to make room, and connections refused for lack of it, since this device started.
- Connection
Budget - Clone one budget into all endpoints on a device. Workspace identities and connection caches remain independent. Data cannot consume the control reserve.
- Control
Client - Cloneable outbound control handle. It owns only the connection and cancellation handles, so a runtime task can finish a multi-request exchange without borrowing the mutable node queue.
- Control
Request - Control
Timing - Where control requests spent their time.
inquiry: answered by the inquiry responder, whole service time.host_wait: queued until the host took it.host_service: taken by the host until it replied. - Message
- Message
Receiver - Node
- Peer
Path - Relay
Options - Caller-supplied relay transport settings for a controlled qualification or an operator-managed relay deployment.
- Timing
- One duration series, in microseconds.
- Topic
- Transport
Metrics - Local endpoint counters. These include transport overhead and retransmission, not application delivery receipts. They reset when the endpoint is opened.
Enums§
- Delivery
Class - Payload-neutral queue behavior declared by the publishing adapter.
- Error
- Network
Profile - Address discovery and path policy; never workspace authority.
- Permissions
- Topic authorization is independent from subscription interest.
Constants§
- MAX_
CONTROL_ REPLY - Maximum encoded control reply, for preflight before committing a side effect.
Type Aliases§
- Inquiry
Responder - Answers an inquiry: a control request that asks for committed state and
changes nothing.
Nonemeans “not an inquiry” and passes the request to the host queue unchanged. It runs off the network workers and may run many at once, so it must only read. This layer does not know what is being asked; the responder validates the peer and the payload. - PeerId
- Authenticated endpoint key, not a workspace member or human identity.
- Workspace
Id