Enum Error

#[non_exhaustive]
pub enum Error {
    InvalidMagic,
    MissingUtxo,
    InvalidSeparator,
    PsbtUtxoOutOfbounds,
    InvalidKey(Key),
    InvalidProprietaryKey,
    DuplicateKey(Key),
    UnsignedTxHasScriptSigs,
    UnsignedTxHasScriptWitnesses,
    MustHaveUnsignedTx,
    NoMorePairs,
    UnexpectedUnsignedTx {
        expected: Box<Transaction>,
        actual: Box<Transaction>,
    },
    NonStandardSighashType(u32),
    HashParse(Error),
    InvalidPreimageHashPair {
        hash_type: PsbtHash,
        preimage: Box<[u8]>,
        hash: Box<[u8]>,
    },
    CombineInconsistentKeySources(Box<ExtendedPubKey>),
    ConsensusEncoding,
}

Ways that a Partially Signed Transaction might fail.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidMagic

Magic bytes for a PSBT must be the ASCII for “psbt” serialized in most significant byte order.

MissingUtxo

Missing both the witness and non-witness utxo.

InvalidSeparator

The separator for a PSBT must be 0xff.

PsbtUtxoOutOfbounds

Returned when output index is out of bounds in relation to the output in non-witness UTXO.

InvalidKey(Key)

Known keys must be according to spec.

InvalidProprietaryKey

Non-proprietary key type found when proprietary key was expected

DuplicateKey(Key)

Keys within key-value map should never be duplicated.

UnsignedTxHasScriptSigs

The scriptSigs for the unsigned transaction must be empty.

UnsignedTxHasScriptWitnesses

The scriptWitnesses for the unsigned transaction must be empty.

MustHaveUnsignedTx

A PSBT must have an unsigned transaction.

NoMorePairs

Signals that there are no more key-value pairs in a key-value map.

UnexpectedUnsignedTx

Attempting to combine with a PSBT describing a different unsigned transaction.

Fields

expected: Box<Transaction>

Expected

actual: Box<Transaction>

Actual

NonStandardSighashType(u32)

Unable to parse as a standard sighash type.

HashParse(Error)

Parsing errors from bitcoin_hashes

InvalidPreimageHashPair

The pre-image must hash to the correponding psbt hash

Fields

hash_type: PsbtHash

Hash-type

preimage: Box<[u8]>

Pre-image

hash: Box<[u8]>

Hash value

CombineInconsistentKeySources(Box<ExtendedPubKey>)

Conflicting data during combine procedure: global extended public key has inconsistent key sources

ConsensusEncoding

Serialization error in bitcoin consensus-encoded structures

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(err: Error) -> Error

Converts to this type from the input type.

impl Hash for Error

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Error

fn cmp(&self, other: &Error) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Error

fn partial_cmp(&self, other: &Error) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Error

impl StructuralPartialEq for Error