Struct BitcoinClient 

pub struct BitcoinClient { /* private fields */ }

Bitcoin Core RPC client wrapper with automatic reconnection

Examples

use kaccy_bitcoin::{BitcoinClient, BitcoinNetwork};

let client = BitcoinClient::new(
    "http://localhost:8332",
    "rpcuser",
    "rpcpassword",
    BitcoinNetwork::Testnet,
)?;

// Check connection health
let is_healthy = client.health_check()?;
println!("Bitcoin node healthy: {}", is_healthy);

Implementations

impl BitcoinClient

pub fn new( url: &str, user: &str, password: &str, network: BitcoinNetwork, ) -> Result<Self>

Create a new Bitcoin RPC client

Examples

use kaccy_bitcoin::{BitcoinClient, BitcoinNetwork};

let client = BitcoinClient::new(
    "http://localhost:18443",
    "user",
    "pass",
    BitcoinNetwork::Regtest,
)?;

pub fn with_config( url: &str, user: &str, password: &str, network: BitcoinNetwork, reconnect_config: ReconnectConfig, ) -> Result<Self>

Create a new Bitcoin RPC client with custom reconnection config

pub fn network(&self) -> BitcoinNetwork

Get the configured network

pub fn health_check(&self) -> Result<bool>

Check if the connection is healthy

pub fn get_blockchain_info(&self) -> Result<GetBlockchainInfoResult>

Get blockchain info

pub fn get_network_info(&self) -> Result<GetNetworkInfoResult>

Get network info

pub fn get_block_height(&self) -> Result<u64>

Get current block height

pub fn get_best_block_hash(&self) -> Result<BlockHash>

Get best block hash

pub fn get_new_address( &self, label: Option<&str>, ) -> Result<Address<NetworkUnchecked>>

Generate a new address

pub fn get_received_by_address( &self, address: &Address, min_confirmations: Option<u32>, ) -> Result<Amount>

Get amount received by address

pub fn get_transaction(&self, txid: &Txid) -> Result<GetTransactionResult>

Get transaction by ID

pub fn get_raw_transaction( &self, txid: &Txid, ) -> Result<GetRawTransactionResult>

Get raw transaction

pub fn list_unspent( &self, min_conf: Option<usize>, max_conf: Option<usize>, addresses: Option<&[&Address<NetworkChecked>]>, ) -> Result<Vec<ListUnspentResultEntry>>

Get unspent transactions for an address

pub fn get_balance(&self) -> Result<Amount>

Get wallet balance

pub fn validate_address(&self, address: &str) -> Result<AddressValidation>

Validate an address (basic validation without RPC)

pub fn get_mempool_info(&self) -> Result<GetMempoolInfoResult>

Get mempool info

pub fn estimate_smart_fee(&self, conf_target: u16) -> Result<Option<f64>>

Estimate smart fee (sats/vB)

impl BitcoinClient

pub fn get_node_status(&self) -> Result<NodeStatus>

Get comprehensive node status

pub fn list_since_block( &self, block_hash: Option<&BlockHash>, target_confirmations: Option<usize>, ) -> Result<ListSinceBlockResult>

List transactions since a specific block

pub fn get_address_info(&self, address: &str) -> Result<AddressInfo>

Get detailed address info including balance

pub fn send_raw_transaction(&self, tx_hex: &str) -> Result<Txid>

Send raw transaction to the network

pub fn get_block_hash(&self, height: u64) -> Result<BlockHash>

Get block by height

pub fn test_mempool_accept(&self, tx_hex: &str) -> Result<bool>

Test mempool accept for a transaction

pub fn generate_to_address( &self, blocks: u64, address: &Address, ) -> Result<Vec<BlockHash>>

Generate blocks to an address (regtest only)

pub fn send_to_address(&self, address: &Address, amount: Amount) -> Result<Txid>

Send to an address

pub fn invalidate_block(&self, block_hash: &BlockHash) -> Result<()>

Invalidate a block (regtest only)

pub fn reconsider_block(&self, block_hash: &BlockHash) -> Result<()>

Reconsider a block (regtest only)