Struct Client 

pub struct Client {
    pub rpc_client: RpcClient,
    /* private fields */
}

Primary entry point used throughout the SDK to interact with the node.

Fields

rpc_client: RpcClient

Implementations

impl Client

pub async fn new(endpoint: &str) -> Result<Client, Error>

Connects to an endpoint and returns a ready-to-use client.

Retries automatically if the reqwest feature is enabled and retry defaults to true.

Errors

Returns Err(Error) if the transport cannot be initialized or the handshake fails.

pub async fn new_ext(endpoint: &str, retry: bool) -> Result<Client, Error>

Connects to an endpoint; set retry to false if you prefer failing fast during startup.

Internally wraps with_retry_on_error so transient errors (network hiccups, etc.) are retried when retry is true.

pub async fn from_rpc_client(rpc_client: RpcClient) -> Result<Client, RpcError>

Builds a client from an existing RPC transport.

Errors

Propagates any failure returned by OnlineClient::new.

pub async fn from_components( rpc_client: RpcClient, online_client: OnlineClient, ) -> Result<Client, RpcError>

Wraps pre-built components into a handy client handle.

Useful when creating mock transports for testing.

pub fn init_tracing(json_format: bool) -> Result<(), TryInitError>

Initializes tracing in plain text or JSON format.

Calling this more than once will return an error from tracing_subscriber.

pub fn online_client(&self) -> OnlineClient

Hands back the underlying OnlineClient for advanced uses.

pub fn tx(&self) -> TransactionApi

Gives you a helper for crafting and sending transactions.

The returned TransactionApi clones this client and issues RPCs lazily.

pub fn block(&self, block_id: impl Into<HashStringNumber>) -> BlockApi

Builds a block helper rooted at the height or hash you pass in.

See BlockApi for available views (transactions, events, raw extrinsics).

pub fn chain(&self) -> ChainApi

Provides low-level RPC helpers when you need finer control.

The returned ChainApi exposes retry toggles and raw RPC wrappers.

pub fn best(&self) -> Best

Provides quick access to the best (head) block view.

Use the returned Best helper to fetch head metadata or block info repeatedly.

pub fn finalized(&self) -> Finalized

Provides quick access to finalized block information.

The returned Finalized helper exposes convenience methods similar to Best.

pub fn is_global_retries_enabled(&self) -> bool

Reports whether automatic retries are currently enabled.

pub fn set_global_retries_enabled(&self, value: bool)

Turns automatic retries on or off for new requests.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.