#rpc-client #transport #json-rpc-client #low-level #request #alloy #ethereum

linera-alloy-rpc-client

Low-level Ethereum JSON-RPC client implementation

1 unstable release

0.1.0 Jun 1, 2024

#40 in #json-rpc-client

Download history 37/week @ 2024-06-21 65/week @ 2024-06-28 19/week @ 2024-07-05 78/week @ 2024-07-12 55/week @ 2024-07-19 127/week @ 2024-07-26 68/week @ 2024-08-02 117/week @ 2024-08-09 99/week @ 2024-08-16 70/week @ 2024-08-23 126/week @ 2024-08-30 225/week @ 2024-09-06 265/week @ 2024-09-13 323/week @ 2024-09-20 136/week @ 2024-09-27 163/week @ 2024-10-04

917 downloads per month
Used in 7 crates (3 directly)

MIT/Apache

190KB
3.5K SLoC

linera-alloy-rpc-client

Low-level Ethereum JSON-RPC client implementation.

Usage

Usage of this crate typically means instantiating an RpcClient<T> over some Transport. The RPC client can then be used to make requests to the RPC server. Requests are captured as RpcCall futures, which can then be polled to completion.

For example, to make a simple request:

// Instantiate a new client over a transport.
let client: ReqwestClient = ClientBulider::default().http(url);

// Prepare a request to the server.
let request = client.request("eth_blockNumber", ());

// Poll the request to completion.
let block_number = request.await.unwrap();

Batch requests are also supported:

// Instantiate a new client over a transport.
let client: ReqwestClient = ClientBulider::default().http(url);

// Prepare a batch request to the server.
let batch = client.new_batch();

// Batches serialize params immediately. So we need to handle the result when
// adding calls.
let block_number_fut = batch.add_call("eth_blockNumber", ()).unwrap();
let balance_fut = batch.add_call("eth_getBalance", address).unwrap();

// Make sure to send the batch!
batch.send().await.unwrap();

// After the batch is complete, we can get the results.
// Note that requests may error separately!
let block_number = block_number_fut.await.unwrap();
let balance = balance_fut.await.unwrap();

Dependencies

~19–33MB
~565K SLoC