Struct Client

pub struct Client { /* private fields */ }

A JSON-RPC client.

Create a new Client using one of the transport-specific constructors:

• Client::simple_http for the built-in bare-minimum HTTP transport

Implementations

impl Client

pub fn with_transport<T: Transport>(transport: T) -> Client

Creates a new client with the given transport.

pub fn build_request<'a>( &self, method: &'a str, params: &'a [Box<RawValue>], ) -> Request<'a>

Builds a request.

To construct the arguments, one can use one of the shorthand methods [jsonrpc::arg] or [jsonrpc::try_arg].

pub async fn send_request( &self, request: Request<'_>, ) -> Result<Response, Error>

Sends a request to a client

pub async fn send_batch( &self, requests: &[Request<'_>], ) -> Result<Vec<Option<Response>>, Error>

Sends a batch of requests to the client. The return vector holds the response for the request at the corresponding index. If no response was provided, it’s None.

Note that the requests need to have valid IDs, so it is advised to create the requests with [build_request].

pub async fn call<R: for<'a> Deserialize<'a>>( &self, method: &str, args: &[Box<RawValue>], ) -> Result<R, Error>

Make a request and deserialize the response.

To construct the arguments, one can use one of the shorthand methods [jsonrpc::arg] or [jsonrpc::try_arg].

impl Client

pub async fn simple_http( url: &str, user: Option<String>, pass: Option<String>, ) -> Result<Client, Error>

Create a new JSON-RPC client using a bare-minimum HTTP transport.

Trait Implementations

impl Debug for Client

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

Formats the value using the given formatter.