Struct jsonrpc::client::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>(transport: T) -> Client

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

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>

Available on crate feature simple_http only.

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

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

Available on crate features simple_http and proxy only.

Creates a new JSON_RPC client using a HTTP-Socks5 proxy transport.

Trait Implementations

impl Debug for Client

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

Formats the value using the given formatter.

impl<T: Transport> From<T> for Client

fn from(t: T) -> Client

Converts to this type from the input type.