Struct jsonrpc::client::Client

pub struct Client { /* private fields */ }

A JSON-RPC client.

Create a new Client using one of the transport-specific constructors e.g., Client::simple_http for a 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 crate::arg or crate::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.

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

Returns

The return vector holds the response for the request at the corresponding index. If no response was provided, it’s None.

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 crate::arg or crate::try_arg.

impl Client

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

Creates 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.