Struct exocore_discovery::client::Client

pub struct Client { /* fields omitted */ }

Discovery service client.

The discovery service is a simple REST API on which clients can push temporary payload for which the server generates a random PIN. Another client can then retrieve that payload by using the generated random PIN. Once a payload is consumed, it is deleted.

Implementations

impl Client

pub fn new<U: IntoUrl>(base_url: U) -> Result<Client, Error>

Creates a new client instance.

pub async fn create(
    &self,
    payload: &[u8],
    expect_reply: bool
) -> Result<CreatePayloadResponse, Error>

Creates a new payload on the server. If successfully created, the response contains a unique pin that can be used by another client to retrieve the payload.

pub async fn get<P: TryInto<Pin>>(&self, pin: P) -> Result<Payload, Error>

Gets a payload by unique pin created by the call to create by another client.

pub async fn get_loop<P: TryInto<Pin>>(
    &self,
    pin: P,
    timeout: Duration
) -> Result<Payload, Error>

Gets a payload by unique pin created by the call to create by another client and retries fetching if it hasn’t been found it until timeout.

pub async fn reply(
    &self,
    reply_pin: Pin,
    reply_token: ReplyToken,
    payload: &[u8],
    expect_reply: bool
) -> Result<CreatePayloadResponse, Error>

Replies to a payload on the server using the given reply pin and authentication token. If successfully created, the response contains can be retrieved using the reply pin.