Enum ProposalDecodingError 

#[non_exhaustive]
pub enum ProposalDecodingError<DbError> {
    NoSteps,
    Zip321(Zip321Error),
    NullInput(usize),
    TxIdInvalid(TryFromSliceError),
    ValuePoolNotSupported(i32),
    InputRetrieval(DbError),
    InputNotFound(TxId, PoolType, u32),
    BalanceInvalid,
    MemoInvalid(Error),
    VersionInvalid(u32),
    FeeRuleNotSupported(FeeRule),
    ProposalInvalid(ProposalError),
    EmptyShieldedInputs(ShieldedPool),
    TransparentMemo,
    InvalidChangeRecipient(PoolType),
    InvalidEphemeralRecipient(PoolType),
    ConfirmationsPolicyInvalid,
    OrchardPaymentProhibited,
    MissingShieldedAnchor,
    ProposedVersionInvalid(u32),
}

Errors that can occur in the process of decoding a Proposal from its protobuf representation.

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.

NoSteps

The encoded proposal contained no steps.

Zip321(Zip321Error)

The ZIP 321 transaction request URI was invalid.

NullInput(usize)

A proposed input was null.

TxIdInvalid(TryFromSliceError)

A transaction identifier string did not decode to a valid transaction ID.

ValuePoolNotSupported(i32)

An invalid value pool identifier was encountered.

InputRetrieval(DbError)

A failure occurred trying to retrieve an unspent note or UTXO from the wallet database.

InputNotFound(TxId, PoolType, u32)

The unspent note or UTXO corresponding to a proposal input was not found in the wallet database.

BalanceInvalid

The transaction balance, or a component thereof, failed to decode correctly.

MemoInvalid(Error)

Failed to decode a ZIP-302-compliant memo from the provided memo bytes.

VersionInvalid(u32)

The serialization version returned by the protobuf was not recognized.

FeeRuleNotSupported(FeeRule)

The fee rule specified by the proposal is not supported by the wallet.

ProposalInvalid(ProposalError)

The proposal violated balance or structural constraints.

EmptyShieldedInputs(ShieldedPool)

An inputs field for the given protocol was present, but contained no input note references.

TransparentMemo

A memo field was provided for a transparent output.

InvalidChangeRecipient(PoolType)

Change outputs to the specified pool are not supported.

InvalidEphemeralRecipient(PoolType)

Ephemeral outputs to the specified pool are not supported.

ConfirmationsPolicyInvalid

The encoded confirmations policy was not valid (for example, a zero confirmation count or trusted confirmations exceeding untrusted).

OrchardPaymentProhibited

A payment was directed to the Orchard pool while Ironwood is active at the proposal’s target height. Once Ironwood is active, Orchard-receiver payments target the Ironwood pool and only change may return to Orchard, so such a payment cannot appear in a well-formed proposal.

MissingShieldedAnchor

A proposal step produces a shielded bundle (it spends shielded notes, pays to a shielded pool, or returns shielded change) but its encoded anchor height is the zero sentinel. Every shielded-tree lookup the step performs — including the dummy spends that pad an output-only bundle — must be bound to a real anchor, so this combination cannot appear in a well-formed proposal.

ProposedVersionInvalid(u32)

The proposal specified an explicit transaction version header that the wallet does not recognize.

Trait Implementations

impl<DbError: Clone> Clone for ProposalDecodingError<DbError>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<DbError: Debug> Debug for ProposalDecodingError<DbError>

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

Formats the value using the given formatter.

impl<E: Display> Display for ProposalDecodingError<E>

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

Formats the value using the given formatter.

impl<E: Error + 'static> Error for ProposalDecodingError<E>

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> From<Zip321Error> for ProposalDecodingError<E>

fn from(value: Zip321Error) -> Self

Converts to this type from the input type.