Struct ServerClient 

pub struct ServerClient { /* private fields */ }

A live connection to the server. Cloneable handle; cloning shares the same underlying socket.

Implementations

impl ServerClient

pub async fn connect( url: &str, dial: &DialMode, identity: Arc<Identity>, rooms: Vec<String>, ) -> Result<(Self, UnboundedReceiver<ServerEvent>)>

Open a connection, send the initial hello, and return the client plus a stream of ServerEvents.

• url: ws://<onion>:80/ws (onion), wss://relay/ws (clearnet TLS), or ws://host:port/ws (clearnet plain / tests).
• dial: how to physically reach it — one of the transport “doors” (Socks5 for onion via Tor, Tls for wss://, Direct for ws://).
• identity: our identity, used to answer the relay’s auth Challenge (huddle 1.1.4). The connector signs the challenge nonce and sends the pubkey + signature in Hello; the relay rejects us otherwise.

pub fn publish(&self, room: &str, id: &str, payload: &[u8]) -> Result<()>

Send a room’s opaque wire bytes to the server for fan-out.

pub fn send_direct( &self, to: &str, room: &str, id: &str, payload: &[u8], ) -> Result<()>

huddle 1.2: deliver payload straight to recipient to’s fingerprint, independent of room membership (1:1 DMs, friend requests). The server delivers it live to every connection to has open, or queues it in their mailbox when they’re offline. room is the opaque tag the recipient files it under.

pub fn subscribe(&self, room: &str) -> Result<()>

Assert membership of a room so the server mailboxes us when offline.

pub fn unsubscribe(&self, room: &str) -> Result<()>

pub fn create_connect_token(&self) -> Result<()>

huddle 1.2.1: ask the relay to mint a short-lived connect code bound to our identity. The reply arrives as ServerEvent::ConnectToken.

pub fn redeem_connect_token(&self, token: &str) -> Result<()>

huddle 1.2.1: ask the relay to resolve a connect code to its owner. The reply arrives as ServerEvent::ConnectTokenResolved.

pub fn fetch(&self) -> Result<()>

Ask the server to re-drain our mailbox.

pub fn ping(&self) -> Result<()>

Trait Implementations

impl Clone for ServerClient

fn clone(&self) -> ServerClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.