Skip to main content

Crate arachne_node

Crate arachne_node 

Source
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§

AdmissionReport
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.
CapacityCounts
Connections closed to make room, and connections refused for lack of it, since this device started.
ConnectionBudget
Clone one budget into all endpoints on a device. Workspace identities and connection caches remain independent. Data cannot consume the control reserve.
ControlClient
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.
ControlRequest
ControlTiming
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
MessageReceiver
Node
PeerPath
RelayOptions
Caller-supplied relay transport settings for a controlled qualification or an operator-managed relay deployment.
Timing
One duration series, in microseconds.
Topic
TransportMetrics
Local endpoint counters. These include transport overhead and retransmission, not application delivery receipts. They reset when the endpoint is opened.

Enums§

DeliveryClass
Payload-neutral queue behavior declared by the publishing adapter.
Error
NetworkProfile
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§

InquiryResponder
Answers an inquiry: a control request that asks for committed state and changes nothing. None means “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.
WorkspaceId