Enum bdk::Error

pub enum Error {
    InvalidU32Bytes(Vec<u8>),
    Generic(String),
    ScriptDoesntHaveAddressForm,
    SingleRecipientMultipleOutputs,
    SingleRecipientNoInputs,
    NoRecipients,
    NoUtxosSelected,
    OutputBelowDustLimit(usize),
    InsufficientFunds {
        needed: u64,
        available: u64,
    },
    BnBTotalTriesExceeded,
    BnBNoExactMatch,
    UnknownUTXO,
    TransactionNotFound,
    TransactionConfirmed,
    IrreplaceableTransaction,
    FeeRateTooLow {
        required: FeeRate,
    },
    FeeTooLow {
        required: u64,
    },
    MissingKeyOrigin(String),
    Key(KeyError),
    ChecksumMismatch,
    SpendingPolicyRequired(KeychainKind),
    InvalidPolicyPathError(PolicyError),
    Signer(SignerError),
    InvalidProgressValue(f32),
    ProgressUpdateError,
    InvalidOutpoint(OutPoint),
    Descriptor(Error),
    AddressValidator(AddressValidatorError),
    Encode(Error),
    Miniscript(Error),
    BIP32(Error),
    Secp256k1(Error),
    JSON(Error),
    Hex(Error),
    PSBT(Error),
    Electrum(Error),
    Esplora(EsploraError),
    CompactFilters(CompactFiltersError),
    Sled(Error),
}

Errors that can be thrown by the Wallet

Variants

InvalidU32Bytes(Vec<u8>)

Wrong number of bytes found when trying to convert to u32

Generic(String)

Generic error

ScriptDoesntHaveAddressForm

This error is thrown when trying to convert Bare and Public key script to address

SingleRecipientMultipleOutputs

Found multiple outputs when single_recipient option has been specified

SingleRecipientNoInputs

single_recipient option is selected but neither drain_wallet nor manually_selected_only are

NoRecipients

Cannot build a tx without recipients

NoUtxosSelected

manually_selected_only option is selected but no utxo has been passed

OutputBelowDustLimit(usize)

Output created is under the dust limit, 546 satoshis

InsufficientFunds

Wallet's UTXO set is not enough to cover recipient's requested plus fee

Fields of InsufficientFunds

needed: u64

Sats needed for some transaction

available: u64

Sats available for spending

BnBTotalTriesExceeded

Branch and bound coin selection possible attempts with sufficiently big UTXO set could grow exponentially, thus a limit is set, and when hit, this error is thrown

BnBNoExactMatch

Branch and bound coin selection tries to avoid needing a change by finding the right inputs for the desired outputs plus fee, if there is not such combination this error is thrown

UnknownUTXO

Happens when trying to spend an UTXO that is not in the internal database

TransactionNotFound

Thrown when a tx is not found in the internal database

TransactionConfirmed

Happens when trying to bump a transaction that is already confirmed

IrreplaceableTransaction

Trying to replace a tx that has a sequence >= 0xFFFFFFFE

FeeRateTooLow

When bumping a tx the fee rate requested is lower than required

Fields of FeeRateTooLow

required: FeeRate

Required fee rate (satoshi/vbyte)

FeeTooLow

When bumping a tx the absolute fee requested is lower than replaced tx absolute fee

Fields of FeeTooLow

required: u64

Required fee absolute value (satoshi)

MissingKeyOrigin(String)

In order to use the TxBuilder::add_global_xpubs option every extended key in the descriptor must either be a master key itself (having depth = 0) or have an explicit origin provided

Key(KeyError)

Error while working with keys

ChecksumMismatch

Descriptor checksum mismatch

SpendingPolicyRequired(KeychainKind)

Spending policy is not compatible with this KeychainKind

InvalidPolicyPathError(PolicyError)

Error while extracting and manipulating policies

Signer(SignerError)

Signing error

InvalidProgressValue(f32)

Progress value must be between 0.0 (included) and 100.0 (included)

ProgressUpdateError

Progress update error (maybe the channel has been closed)

InvalidOutpoint(OutPoint)

Requested outpoint doesn't exist in the tx (vout greater than available outputs)

Descriptor(Error)

Error related to the parsing and usage of descriptors

AddressValidator(AddressValidatorError)

Error that can be returned to fail the validation of an address

Encode(Error)

Encoding error

Miniscript(Error)

Miniscript error

BIP32(Error)

BIP32 error

Secp256k1(Error)

An ECDSA error

JSON(Error)

Error serializing or deserializing JSON data

Hex(Error)

Hex decoding error

PSBT(Error)

Partially signed bitcoin transaction error

Electrum(Error)

Electrum client error

Esplora(EsploraError)

Esplora client error

CompactFilters(CompactFiltersError)

Compact filters client error)

Sled(Error)

Sled database error

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

pub fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<AddressValidatorError> for Error

pub fn from(err: AddressValidatorError) -> Self

Performs the conversion.

impl From<CompactFiltersError> for Error

pub fn from(other: CompactFiltersError) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for CompactFiltersError

This is supported on crate feature compact_filters only.

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Self

Performs the conversion.

impl From<EsploraError> for Error

pub fn from(err: EsploraError) -> Self

Performs the conversion.

impl From<KeyError> for Error

pub fn from(key_error: KeyError) -> Error

Performs the conversion.

impl From<PolicyError> for Error

pub fn from(err: PolicyError) -> Self

Performs the conversion.

impl From<SignerError> for Error

pub fn from(err: SignerError) -> Self

Performs the conversion.