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

Methods

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

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

Formats the value using the given formatter.