Struct jsonrpc::client::Client

pub struct Client { /* fields omitted */ }

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 fn send_request(&self, request: Request<'_>) -> Result<Response, Error>

Sends a request to a client

pub 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 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 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

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

Formats the value using the given formatter.