Struct SvNodeClient 

pub struct SvNodeClient { /* private fields */ }

Client for communicating with a Bitcoin SV node.

This client manages both JSON-RPC and REST API connections to a Bitcoin SV node. The client is cloneable and safe for concurrent use - clones share the same underlying connection pool for efficient resource usage.

Example

use bitcoinsv_rpc::{NodeClient, SvNodeClient};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = SvNodeClient::new(
        "http://localhost:8332",
        Some("user".to_string()),
        Some("password".to_string()),
    )?;

    let hash = client.get_best_block_hash().await?;
    println!("Best block: {}", hash);

    // Clone the client for concurrent use
    let client2 = client.clone();
    let (hash1, hash2) = tokio::join!(
        client.get_best_block_hash(),
        client2.get_best_block_hash(),
    );

    Ok(())
}

Implementations

impl SvNodeClient

pub fn new( url: &str, username: Option<String>, password: Option<String>, ) -> Result<Self>

Creates a new client connection to a Bitcoin SV node.

Arguments

• url - The base URL of the node (e.g., “http://localhost:8332”)
• username - Optional RPC username for authentication
• password - Optional RPC password for authentication

Errors

Returns an error if the URL is invalid.

Trait Implementations

impl Clone for SvNodeClient

fn clone(&self) -> SvNodeClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl NodeClient for SvNodeClient

fn get_best_block_hash<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<BlockHash>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the hash of the best (tip) block in the longest blockchain.

fn get_block_header<'life0, 'life1, 'async_trait>( &'life0 self, block_hash: &'life1 BlockHash, ) -> Pin<Box<dyn Future<Output = Result<BlockHeader>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the block header for the specified block hash.

fn get_block<'life0, 'life1, 'async_trait>( &'life0 self, block_hash: &'life1 BlockHash, ) -> Pin<Box<dyn Future<Output = Result<Block>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns the complete block data for the specified block hash.