Enum Error 

#[non_exhaustive]
pub enum Error<DataSourceError, CommitmentTreeError, SelectionError, FeeError, ChangeErrT, NoteRefT> {
    DataSource(DataSourceError),
    CommitmentTree(ShardTreeError<CommitmentTreeError>),
    NoteSelection(SelectionError),
    Change(ChangeError<ChangeErrT, NoteRefT>),
    Proposal(ProposalError),
    ProposalNotSupported,
    AccountIdNotRecognized,
    KeyNotRecognized,
    AccountCannotSpend,
    BalanceError(BalanceError),
    InsufficientFunds {
        available: Zatoshis,
        required: Zatoshis,
    },
    ScanRequired,
    Builder(Error<FeeError>),
    Payment(PaymentError),
    UnsupportedChangeType(PoolType),
    NoSupportedReceivers(Box<UnifiedAddress>),
    KeyNotAvailable(PoolType),
    NoteMismatch(NoteId),
    Address(ConversionError<&'static str>),
    AddressNotRecognized(TransparentAddress),
    ExpiryHeightBelowTargetHeight {
        expiry_height: BlockHeight,
        min_target_height: BlockHeight,
    },
    ExpiryHeightConflictsWithCanonicalCrossing {
        requested: BlockHeight,
    },
    RecipientAddressExpiry {
        payment_index: usize,
        error: AddressExpiryError,
    },
    Pczt(PcztError),
}

Errors that can occur as a consequence of wallet operations.

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.

DataSource(DataSourceError)

An error occurred retrieving data from the underlying data source

CommitmentTree(ShardTreeError<CommitmentTreeError>)

An error in computations involving the note commitment trees.

NoteSelection(SelectionError)

An error in note selection

Change(ChangeError<ChangeErrT, NoteRefT>)

An error in change selection during transaction proposal construction

Proposal(ProposalError)

An error in transaction proposal construction

ProposalNotSupported

The proposal was structurally valid, but tried to do one of these unsupported things:

• spend a prior shielded output;
• pay to an output pool for which the corresponding feature is not enabled;
• pay to a TEX address if the “transparent-inputs” feature is not enabled.
• a proposal step has no inputs

AccountIdNotRecognized

No account could be found corresponding to a provided ID.

KeyNotRecognized

No account could be found corresponding to a provided spending key.

AccountCannotSpend

The given account cannot be used for spending, because it is unable to maintain an accurate balance.

BalanceError(BalanceError)

Zcash amount computation encountered an overflow or underflow.

InsufficientFunds

Unable to create a new spend because the wallet balance is not sufficient.

Fields

available: Zatoshis

required: Zatoshis

ScanRequired

The wallet must first perform a scan of the blockchain before other operations can be performed.

Builder(Error<FeeError>)

An error occurred building a new transaction.

Payment(PaymentError)

An error occurred constructing a payment for the transaction.

UnsupportedChangeType(PoolType)

Attempted to send change to an unsupported pool.

This is indicative of a programming error; execution of a transaction proposal that presumes support for the specified pool was performed using an application that does not provide such support.

NoSupportedReceivers(Box<UnifiedAddress>)

Attempted to create a spend to an unsupported Unified Address receiver

KeyNotAvailable(PoolType)

A proposed transaction cannot be built because it requires spending an input of a type for which a key required to construct the transaction is not available.

NoteMismatch(NoteId)

A note being spent does not correspond to either the internal or external full viewing key for an account.

Address(ConversionError<&'static str>)

An error occurred parsing the address from a payment request.

AddressNotRecognized(TransparentAddress)

Available on crate feature transparent-inputs only.

The address associated with a record being inserted was not recognized as belonging to the wallet.

ExpiryHeightBelowTargetHeight

The caller requested a nonzero target expiry height below the proposal’s minimum target height. Zero remains valid because it disables expiry.

Fields

expiry_height: BlockHeight

min_target_height: BlockHeight

ExpiryHeightConflictsWithCanonicalCrossing

The caller requested an expiry height for a step that is a canonical ZIP 318 crossing.

Such a step takes its expiry from the ZIP 318 rolling window, which every crossing in the same period shares; a caller-chosen expiry would single it out and undo the shape the unpadded bundle and bucketed anchor were chosen to produce. Those are already fixed by the time the transaction is built, so the conflict is reported rather than silently resolved. Pass None to accept the canonical expiry.

Fields

requested: BlockHeight

RecipientAddressExpiry

A ZIP 316 Revision 2 recipient address of the payment at the given index has expired, or has expiry metadata that conflicts with the transaction’s expiry height. A currently-valid address should be obtained for the intended recipient.

Fields

payment_index: usize

error: AddressExpiryError

Pczt(PcztError)

Available on crate feature pczt only.

An error occurred while working with PCZTs.

Trait Implementations

impl<DataSourceError: Debug, CommitmentTreeError: Debug, SelectionError: Debug, FeeError: Debug, ChangeErrT: Debug, NoteRefT: Debug> Debug for Error<DataSourceError, CommitmentTreeError, SelectionError, FeeError, ChangeErrT, NoteRefT>

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

Formats the value using the given formatter.

impl<DE, TE, SE, FE, CE, N> Display for Error<DE, TE, SE, FE, CE, N>

where DE: Display, TE: Display, SE: Display, FE: Display, CE: Display, N: Display,

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

Formats the value using the given formatter.

impl<DE, TE, SE, FE, CE, N> Error for Error<DE, TE, SE, FE, CE, N>

where DE: Debug + Display + Error + 'static, TE: Debug + Display + Error + 'static, SE: Debug + Display + Error + 'static, FE: Debug + Display + 'static, CE: 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<DE, TE, SE, FE, CE, N> From<BalanceError> for Error<DE, TE, SE, FE, CE, N>

fn from(e: BalanceError) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<ConversionError<&'static str>> for Error<DE, TE, SE, FE, CE, N>

fn from(value: ConversionError<&'static str>) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<Error<FE>> for Error<DE, TE, SE, FE, CE, N>

fn from(e: Error<FE>) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<Error> for Error<DE, TE, SE, FE, CE, N>

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<Error> for Error<DE, TE, SE, FE, CE, N>

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<Error> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<Error> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<Error> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<InputSelectorError<DE, SE, CE, N>> for Error<DE, TE, SE, FE, CE, N>

fn from(e: InputSelectorError<DE, SE, CE, N>) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<OrchardError> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: OrchardError) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<PcztError> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: PcztError) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<ProposalError> for Error<DE, TE, SE, FE, CE, N>

fn from(e: ProposalError) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<SaplingError> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: SaplingError) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<ShardTreeError<TE>> for Error<DE, TE, SE, FE, CE, N>

fn from(e: ShardTreeError<TE>) -> Self

Converts to this type from the input type.

impl<DE, TE, SE, FE, CE, N> From<TransparentError> for Error<DE, TE, SE, FE, CE, N>

Available on crate feature pczt only.

fn from(e: TransparentError) -> Self

Converts to this type from the input type.