Struct Client 

pub struct Client { /* private fields */ }

Session against one deployed relay.

The credential is per-client, not process-global. Two clients in the same process may use different keys.

Implementations

impl Client

pub fn new(config: ClientConfig) -> Result<Self>

pub fn from_credential( server: impl Into<String>, credential: Credential, keep_alive: bool, namespace: Option<u64>, ) -> Self

Build a client from an already-parsed credential.

pub fn notify_network_change(&self)

Notify workers after a host network/resume event. This does not mark services healthy.

pub fn server(&self) -> &str

pub fn namespace(&self) -> Option<u64>

pub fn admin(&self) -> Result<Admin>

Administrator RPCs. Fails locally when the session is not an admin key.

pub async fn register(&self, request: RegisterRequest) -> Result<Registration>

Publish a local service on the relay under request.key.

Returns as soon as the worker is spawned; the handle’s Registration::wait_ready is what waits for the relay to accept it.

pub async fn connect(&self, request: ConnectRequest) -> Result<Connection>

Subscribe to a registered service and forward it from a local listener.

Returns as soon as the worker is spawned; the handle’s Connection::wait_ready is what waits for the local listener to bind and the relay to confirm the service.

pub async fn list_keys(&self) -> Result<Vec<String>>

Service keys visible to this credential’s namespace.

pub async fn service_status( &self, key: impl Into<String>, ) -> Result<Vec<ServiceConnection>>

pub async fn remote_id(&self) -> Result<RemoteId>

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.