Struct ElectrumClient 

pub struct ElectrumClient { /* private fields */ }

Electrum protocol client.

Provides async methods for querying Bitcoin blockchain data via Electrum protocol.

Example

use rustywallet_electrum::{ElectrumClient, ClientConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Connect to server
    let client = ElectrumClient::new("electrum.blockstream.info").await?;
     
    // Check balance
    let balance = client.get_balance("1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa").await?;
    println!("Balance: {} satoshis", balance.confirmed);
     
    Ok(())
}

Implementations

impl ElectrumClient

pub async fn new(server: &str) -> Result<Self>

Create a new client with SSL connection to the specified server.

Uses default port 50002 for SSL.

pub async fn with_config(config: ClientConfig) -> Result<Self>

Create a new client with custom configuration.

pub async fn get_balance(&self, address: &str) -> Result<Balance>

Get balance for a single address.

Arguments

• address - Bitcoin address (P2PKH, P2SH, P2WPKH, P2WSH, P2TR)

Returns

• Balance with confirmed and unconfirmed amounts in satoshis

pub async fn get_balance_scripthash(&self, scripthash: &str) -> Result<Balance>

Get balance using scripthash directly.

pub async fn get_balances(&self, addresses: &[&str]) -> Result<Vec<Balance>>

Get balances for multiple addresses in a single batch request.

This is much more efficient than calling get_balance multiple times.

Arguments

• addresses - Slice of Bitcoin addresses

Returns

• Vector of Balance in the same order as input addresses

pub async fn get_balances_scripthash( &self, scripthashes: &[String], ) -> Result<Vec<Balance>>

Get balances using scripthashes directly (batch).

pub async fn list_unspent(&self, address: &str) -> Result<Vec<Utxo>>

List unspent outputs (UTXOs) for an address.

Arguments

• address - Bitcoin address

Returns

• Vector of Utxo for the address

pub async fn list_unspent_scripthash( &self, scripthash: &str, ) -> Result<Vec<Utxo>>

List unspent outputs using scripthash directly.

pub async fn get_transaction(&self, txid: &str) -> Result<String>

Get raw transaction by txid.

Arguments

• txid - Transaction ID (hex)

Returns

• Raw transaction hex string

pub async fn broadcast(&self, raw_tx: &str) -> Result<String>

Broadcast a signed transaction.

Arguments

• raw_tx - Signed transaction in hex format

Returns

• Transaction ID if broadcast successful

pub async fn get_history(&self, address: &str) -> Result<Vec<TxHistory>>

Get transaction history for an address.

Arguments

• address - Bitcoin address

Returns

• Vector of TxHistory entries

pub async fn get_history_scripthash( &self, scripthash: &str, ) -> Result<Vec<TxHistory>>

Get transaction history using scripthash directly.

pub async fn server_version(&self) -> Result<ServerVersion>

Get server version information.

Also performs protocol version negotiation.

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

Ping the server to check connection.

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

Get the current block height.

pub async fn estimate_fee(&self, blocks: u32) -> Result<f64>

Get estimated fee rate (satoshis per kilobyte).

Arguments

• blocks - Target confirmation blocks (e.g., 1, 6, 144)