Struct HttpClient

pub struct HttpClient { /* private fields */ }

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

An HTTP Relay client.

Cheaply clonable.

Implementations

impl Client

pub fn public_key(&self) -> PublicKey

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

The public key for this client

pub async fn connect(&self) -> Result<Conn, ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Connects to a relay Server and returns the underlying relay connection.

Returns ClientError::Closed if the Client is closed.

If there is already an active relay connection, returns the already connected crate::relay::RelayConn.

pub async fn note_preferred(&self, is_preferred: bool)

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Let the server know that this client is the preferred client

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

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Get the local addr of the connection. If there is no current underlying relay connection or the Client is closed, returns None.

pub async fn ping(&self) -> Result<Duration, ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Send a ping to the server. Return once we get an expected pong.

There must be a task polling recv_detail to process the pong response.

pub async fn send_pong(&self, data: [u8; 8]) -> Result<(), ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Send a pong back to the server.

If there is no underlying active relay connection, it creates one before attempting to send the pong message.

If there is an error sending pong, it closes the underlying relay connection before returning.

pub async fn send( &self, dst_key: PublicKey, b: Bytes, ) -> Result<(), ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Send a packet to the server.

If there is no underlying active relay connection, it creates one before attempting to send the message.

If there is an error sending the packet, it closes the underlying relay connection before returning.

pub async fn close(self) -> Result<(), ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Close the http relay connection.

pub async fn close_for_reconnect(&self) -> Result<(), ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Disconnect the http relay connection.

pub async fn is_connected(&self) -> Result<bool, ClientError>

👎Deprecated: This crate has been renamed from ‘iroh-net’ to ‘iroh’, please use the new crate

Returns true if the underlying relay connection is established.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.