Enum ProposalError

pub enum ProposalError {
    RequestTotalInvalid,
    Overflow,
    BalanceError {
        input_total: Zatoshis,
        output_total: Zatoshis,
    },
    ShieldingInvalid,
    AnchorNotFound(BlockHeight),
    ReferenceError(StepOutput),
    StepDoubleSpend(StepOutput),
    ChainDoubleSpend(PoolType, TxId, u32),
    PaymentPoolsMismatch,
    SpendsChange(StepOutput),
    EphemeralOutputLeftUnspent(StepOutput),
    PaysTexFromShielded,
    EphemeralOutputsInvalid,
}

Errors that can occur in construction of a Step.

Variants

RequestTotalInvalid

The total output value of the transaction request is not a valid Zcash amount.

Overflow

The total of transaction inputs overflows the valid range of Zcash values.

BalanceError

The input total and output total of the payment request are not equal to one another. The sum of transaction outputs, change, and fees is required to be exactly equal to the value of provided inputs.

Fields

input_total: Zatoshis

output_total: Zatoshis

ShieldingInvalid

The is_shielding flag may only be set to true under the following conditions:

• The total of transparent inputs is nonzero
• There exist no Sapling inputs
• There provided transaction request is empty; i.e. the only output values specified are change and fee amounts.

AnchorNotFound(BlockHeight)

No anchor information could be obtained for the specified block height.

ReferenceError(StepOutput)

A reference to the output of a prior step is invalid.

StepDoubleSpend(StepOutput)

An attempted double-spend of a prior step output was detected.

ChainDoubleSpend(PoolType, TxId, u32)

An attempted double-spend of an output belonging to the wallet was detected.

PaymentPoolsMismatch

There was a mismatch between the payments in the proposal’s transaction request and the payment pool selection values.

SpendsChange(StepOutput)

The proposal tried to spend a change output. Mark the ChangeValue as ephemeral if this is intended.

EphemeralOutputLeftUnspent(StepOutput)

Available on crate feature transparent-inputs only.

A proposal step created an ephemeral output that was not spent in any later step.

PaysTexFromShielded

Available on crate feature transparent-inputs only.

The proposal included a payment to a TEX address and a spend from a shielded input in the same step.

EphemeralOutputsInvalid

Available on crate feature transparent-inputs only.

The change strategy provided to input selection failed to correctly generate an ephemeral change output when needed for sending to a TEX address.

Trait Implementations

impl Clone for ProposalError

fn clone(&self) -> ProposalError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ProposalError

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

Formats the value using the given formatter.

impl Display for ProposalError

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

Formats the value using the given formatter.

impl Error for ProposalError

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<ProposalError> for Error<DE, TE, SE, FE, CE, N>

fn from(e: ProposalError) -> Self

Converts to this type from the input type.