Enum ChangeError

pub enum ChangeError<E, NoteRefT> {
    InsufficientFunds {
        available: Zatoshis,
        required: Zatoshis,
    },
    DustInputs {
        transparent: Vec<OutPoint>,
        sapling: Vec<NoteRefT>,
        orchard: Vec<NoteRefT>,
    },
    StrategyError(E),
    BundleError(&'static str),
}

Errors that can occur in computing suggested change and/or fees.

Variants

InsufficientFunds

Insufficient inputs were provided to change selection to fund the required outputs and fees.

Fields

available: Zatoshis

The total of the inputs provided to change selection

required: Zatoshis

The total amount of input value required to fund the requested outputs, including the required fees.

DustInputs

Some of the inputs provided to the transaction have value less than the marginal fee, and could not be determined to have any economic value in the context of this input selection.

This determination is potentially conservative in the sense that inputs with value less than or equal to the marginal fee might be excluded, even though in practice they would not cause the fee to increase. Inputs with value greater than the marginal fee will never be excluded.

The ordering of the inputs in each list is unspecified.

Fields

transparent: Vec<OutPoint>

The outpoints for transparent inputs that could not be determined to have economic value in the context of this input selection.

sapling: Vec<NoteRefT>

The identifiers for Sapling inputs that could not be determined to have economic value in the context of this input selection.

orchard: Vec<NoteRefT>

Available on crate feature orchard only.

The identifiers for Orchard inputs that could not be determined to have economic value in the context of this input selection.

StrategyError(E)

An error occurred that was specific to the change selection strategy in use.

BundleError(&'static str)

The proposed bundle structure would violate bundle type construction rules.

Trait Implementations

impl<E: Clone, NoteRefT: Clone> Clone for ChangeError<E, NoteRefT>

fn clone(&self) -> ChangeError<E, NoteRefT>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<E: Debug, NoteRefT: Debug> Debug for ChangeError<E, NoteRefT>

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

Formats the value using the given formatter.

impl<CE: Display, N: Display> Display for ChangeError<CE, N>

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

Formats the value using the given formatter.

impl<E, N> Error for ChangeError<E, N>

where E: Debug + Display + Error + 'static, N: Debug + Display + 'static,

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<E, S, C, N> From<ChangeError<C, N>> for InputSelectorError<E, S, C, N>

fn from(err: ChangeError<C, N>) -> Self

Converts to this type from the input type.

impl<E: PartialEq, NoteRefT: PartialEq> PartialEq for ChangeError<E, NoteRefT>

fn eq(&self, other: &ChangeError<E, NoteRefT>) -> 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<E: Eq, NoteRefT: Eq> Eq for ChangeError<E, NoteRefT>

impl<E, NoteRefT> StructuralPartialEq for ChangeError<E, NoteRefT>