Struct DarkfidRpcClient

pub struct DarkfidRpcClient {
    rpc_client: RwLock<Option<RpcClient>>,
}

A RPC client for interacting with a Darkfid JSON-RPC endpoint, enabling communication with Darkfid blockchain nodes. Supports connection management, request handling, and graceful shutdowns. Implemented for shared access across ownership boundaries using Arc, with connection state managed via an RwLock.

Fields

rpc_client: RwLock<Option<RpcClient>>

JSON-RPC client used to communicate with the Darkfid daemon. A value of None indicates no active connection. The RwLock allows the client to be shared across ownership boundaries while managing the connection state.

Implementations

impl DarkfidRpcClient

pub async fn get_block_by_height(&self, height: u32) -> Result<BlockInfo>

Retrieves a block from at a given height returning the corresponding [BlockInfo].

pub async fn get_last_confirmed_block(&self) -> Result<(u32, String)>

Retrieves the last confirmed block returning the block height and its header hash.

impl DarkfidRpcClient

pub fn new() -> Self

Creates a new client with an inactive connection.

pub async fn connected(&self) -> Result<bool>

Checks if there is an active connection to Darkfid.

pub async fn connect( &self, endpoint: Url, ex: Arc<Executor<'static>>, ) -> Result<()>

Establishes a connection to the Darkfid node, storing the resulting client if successful. If already connected, logs a message and returns without connecting again.

pub async fn stop(&self) -> Result<()>

Closes the connection with the connected darkfid, returning if there is no active connection. If the connection is stopped, sets rpc_client to None.

pub async fn request( &self, method: &str, params: &JsonValue, ) -> Result<JsonValue>

Sends a request to the client’s Darkfid JSON-RPC endpoint using the given method and parameters. Returns the received response or an error if no active connection to Darkfid exists.

async fn ping(&self) -> Result<bool>

Sends a ping request to the client’s darkfid endpoint to verify connectivity, returning true if the ping is successful or an error if the request fails.

Trait Implementations

impl Default for DarkfidRpcClient

fn default() -> Self

Returns the “default value” for a type.