subxt-rpcs 0.50.1

Make RPC calls to Substrate based nodes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

// Copyright 2019-2026 Parity Technologies (UK) Ltd.
// This file is dual-licensed as Apache-2.0 or GPL-3.0.
// see LICENSE for license details.

//! RPC types and client for interacting with a substrate node.
//!
//! An RPC client is instantiated and then used to create some methods, for instance
//! [`crate::methods::ChainHeadRpcMethods`], which defines the calls that can be made with it.
//! The core RPC client bits are:
//!
//! - [`RpcClientT`] is the underlying dynamic RPC implementation. This provides
//!   the low level [`RpcClientT::request_raw`] and [`RpcClientT::subscribe_raw`]
//!   methods.
//! - [`RpcClient`] is the higher level wrapper around this, offering
//!   the [`RpcClient::request`] and [`RpcClient::subscribe`] methods.
//!
//! We then expose implementations here (depending on which features are enabled)
//! which implement [`RpcClientT`] and can therefore be used to construct [`RpcClient`]s.
//!
//! - **jsonrpsee**: Enable an RPC client based on `jsonrpsee`.
//! - **light-client**: Enable an RPC client which uses the Smoldot light client under
//!   the hood to communicate with the network of choice.
//! - **reconnecting-rpc-client**: Enable an RPC client based on `jsonrpsee` which handles
//!   reconnecting automatically in the event of network issues.
//! - **mock-rpc-client**: Enable a mock RPC client that can be used in tests.
//!

crate::macros::cfg_jsonrpsee! {
    mod jsonrpsee_impl;
    pub use jsonrpsee::core::client::Client as JsonrpseeRpcClient;
    pub use jsonrpsee_impl::client as jsonrpsee_client;
}

crate::macros::cfg_unstable_light_client! {
    mod lightclient_impl;
    pub use subxt_lightclient::LightClientRpc as LightClientRpcClient;
    pub use subxt_lightclient::LightClient;
}

crate::macros::cfg_reconnecting_rpc_client! {
   pub mod reconnecting_rpc_client;
   pub use reconnecting_rpc_client::RpcClient as ReconnectingRpcClient;
}

crate::macros::cfg_mock_rpc_client! {
    pub mod mock_rpc_client;
    pub use mock_rpc_client::MockRpcClient;
}

pub mod round_robin_rpc_client;
pub use round_robin_rpc_client::RoundRobinRpcClient;

mod rpc_client;
mod rpc_client_t;

pub use rpc_client::{RpcClient, RpcParams, RpcSubscription, rpc_params};
pub use rpc_client_t::{RawRpcFuture, RawRpcSubscription, RawValue, RpcClientT};