Struct RelayManager 

pub struct RelayManager { /* private fields */ }

A connected relay client: the persistent identity, registration loops and live sessions, plus the transport that exposes it to iroh.

Implementations

impl RelayManager

pub fn start(options: RelayManagerOptions, own_node: PublicKey) -> Result<Self>

Start registration with the configured relays and build the transport for iroh. The transport advertises a custom address carrying own_node.

Errors

Returns an error if the relay identity cannot be loaded or generated, or if the TLS configuration cannot be built.

pub fn transport(&self) -> SyncthingRelayTransport

The transport to install on the iroh endpoint.

pub fn local_addr(&self) -> CustomAddr

The custom address this node advertises.

pub fn relay_id(&self) -> [u8; 32]

The relay device id of this node (SHA-256 of its certificate).

pub fn remember_node(&self, relay_id: &[u8; 32], node: PublicKey)

Record the iroh node id owning a peer relay id so inbound datagrams from that peer can be attributed.

pub async fn test_relay(&self, url: &str) -> Result<TestRelayReport>

Test whether url accepts our registration. A fresh TLS join request is made; receiving the “joined” or “already connected” responses both prove the relay knows our identity.

Errors

Returns an error if the relay is unreachable, misbehaving, or rejects our identity.

pub async fn shutdown(&self)

Stop all registration loops and sessions.

Trait Implementations

impl Clone for RelayManager

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RelayManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.