Struct MasqueRelayClient 

pub struct MasqueRelayClient { /* private fields */ }

MASQUE Relay Client

Manages a connection to a MASQUE relay server and provides APIs for sending and receiving datagrams through the relay.

Implementations

impl MasqueRelayClient

pub fn new(relay_address: SocketAddr, config: RelayClientConfig) -> Self

Create a new relay client (not yet connected)

pub fn relay_address(&self) -> SocketAddr

Get relay server address

pub async fn public_address(&self) -> Option<SocketAddr>

Get our public address (if known)

pub async fn state(&self) -> RelayConnectionState

Get current connection state

pub async fn is_connected(&self) -> bool

Check if connected

pub async fn connection_duration(&self) -> Option<Duration>

Get connection duration

pub fn stats(&self) -> Arc<RelayClientStats>

Get statistics

pub fn create_connect_request(&self) -> ConnectUdpRequest

Create a CONNECT-UDP Bind request

pub async fn handle_connect_response( &self, response: ConnectUdpResponse, ) -> RelayResult<()>

Handle the CONNECT-UDP response from the relay

pub async fn handle_capsule( &self, capsule: Capsule, ) -> RelayResult<Option<Capsule>>

Handle an incoming capsule from the relay

pub async fn get_or_create_context( &self, target: SocketAddr, ) -> RelayResult<(VarInt, Option<Capsule>)>

Get or create a context for a target address

Returns the context ID and an optional capsule to send (COMPRESSION_ASSIGN).

pub async fn create_datagram( &self, target: SocketAddr, payload: Bytes, ) -> RelayResult<(Datagram, Option<Capsule>)>

Create a datagram for sending to a target

If a context exists and is active, returns a compressed datagram. Otherwise returns an uncompressed datagram (if allowed).

pub async fn decode_datagram( &self, data: &[u8], ) -> RelayResult<(SocketAddr, Bytes)>

Decode an incoming datagram from the relay

pub fn record_sent(&self, bytes: usize)

Record a sent datagram

pub async fn close(&self)

Close the relay connection

pub async fn active_contexts(&self) -> Vec<VarInt>

Get list of active context IDs

Trait Implementations

impl Debug for MasqueRelayClient

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

Formats the value using the given formatter.