Enum BitcoinError 

pub enum BitcoinError {
    Rpc(Error),
    AddressGeneration(String),
    TransactionNotFound(String),
    InsufficientConfirmations {
        current: u32,
        required: u32,
    },
    InvalidAddress(String),
    NetworkMismatch {
        address_network: Network,
        configured_network: Network,
    },
    ConnectionFailed(String),
    ConnectionTimeout {
        timeout_secs: u64,
    },
    ConnectionPoolExhausted,
    Wallet(String),
    PaymentMismatch {
        expected: u64,
        received: u64,
    },
    Underpayment {
        expected: u64,
        received: u64,
        shortfall: u64,
    },
    Overpayment {
        expected: u64,
        received: u64,
        excess: u64,
    },
    TransactionReplaced {
        original_txid: String,
        replacement_txid: String,
    },
    FeeEstimationFailed {
        target_blocks: u32,
        reason: String,
    },
    UtxoNotFound {
        txid: String,
        vout: u32,
    },
    BroadcastFailed(String),
    Reorganization {
        height: u64,
        expected_hash: String,
        actual_hash: String,
    },
    OrderNotFound {
        address: String,
    },
    PaymentExpired {
        created_at: String,
        expiry_hours: u32,
    },
    InvalidTransaction(String),
    MempoolRejection {
        reason: String,
    },
    InvalidXpub(String),
    DerivationFailed(String),
    AddressNotInWallet(String),
    LimitExceeded(String),
    InsufficientFunds(String),
    RpcError(String),
    Validation(String),
    Psbt(String),
    NotFound(String),
    InvalidInput(String),
}

Variants

Rpc(Error)

Bitcoin Core RPC communication error

AddressGeneration(String)

Address generation failed

TransactionNotFound(String)

Transaction not found in the blockchain

InsufficientConfirmations

Transaction does not have enough confirmations

Fields

current: u32

required: u32

InvalidAddress(String)

Invalid Bitcoin address format

NetworkMismatch

Network mismatch between address and configured network

Fields

address_network: Network

configured_network: Network

ConnectionFailed(String)

Connection to Bitcoin Core failed

ConnectionTimeout

Connection timeout

Fields

timeout_secs: u64

ConnectionPoolExhausted

Connection pool exhausted

Wallet(String)

Wallet operation failed

PaymentMismatch

Payment amount mismatch

Fields

expected: u64

received: u64

Underpayment

Underpayment detected

Fields

expected: u64

received: u64

shortfall: u64

Overpayment

Overpayment detected

Fields

expected: u64

received: u64

excess: u64

TransactionReplaced

Transaction was replaced (RBF)

Fields

original_txid: String

replacement_txid: String

FeeEstimationFailed

Fee estimation failed

Fields

target_blocks: u32

reason: String

UtxoNotFound

UTXO not found

Fields

txid: String

vout: u32

BroadcastFailed(String)

Transaction broadcast failed

Reorganization

Block reorganization detected

Fields

height: u64

expected_hash: String

actual_hash: String

OrderNotFound

Order not found for payment

Fields

address: String

PaymentExpired

Payment expired

Fields

created_at: String

expiry_hours: u32

InvalidTransaction(String)

Invalid transaction format

MempoolRejection

Mempool rejection

Fields

reason: String

InvalidXpub(String)

Invalid extended public key (xpub/zpub)

DerivationFailed(String)

HD wallet derivation failed

AddressNotInWallet(String)

Address not found in wallet

LimitExceeded(String)

Transaction limit exceeded

InsufficientFunds(String)

Insufficient funds

RpcError(String)

Generic RPC error (for string-based errors)

Validation(String)

Validation error

Psbt(String)

PSBT error

NotFound(String)

Resource not found

InvalidInput(String)

Invalid input

Implementations

impl BitcoinError

pub fn is_recoverable(&self) -> bool

Check if this error is recoverable (can be retried)

pub fn is_payment_error(&self) -> bool

Check if this error indicates a payment issue

pub fn underpayment(expected: u64, received: u64) -> Self

Create an underpayment error

pub fn overpayment(expected: u64, received: u64) -> Self

Create an overpayment error

Trait Implementations

impl Debug for BitcoinError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for BitcoinError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for BitcoinError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for BitcoinError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for BitcoinError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for BitcoinError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for BitcoinError

fn from(err: ParseError) -> Self

Converts to this type from the input type.