Struct Client

pub struct Client { /* private fields */ }

A JSON-RPC client.

Creates 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: T) -> Client

where T: Transport,

Creates a new client with the given transport.

pub fn build_request<'a>( &self, method: &'a str, params: Option<&'a 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>(&self, method: &str, args: Option<&RawValue>) -> Result<R, Error>

where R: for<'a> Deserialize<'a>,

Makes a request and deserializes 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<(), Error>

Formats the value using the given formatter.

impl<T> From<T> for Client

where T: Transport,

fn from(t: T) -> Client

Converts to this type from the input type.