Enum SpendFailureStage 

pub enum SpendFailureStage {
    Signing,
    Broadcast,
    Confirmation,
}

Where an attempt died.

Coarse and stable on purpose: the point is which STEP failed, because that is what tells a person whether their money is at risk. This distinction is load-bearing and MUST NOT be flattened into a bare “failed”. A client that collapses it is structurally unable to tell someone the truth about their own money.

Variants

Signing

The spend could not be built or signed. No signed bundle ever existed, so nothing could reach a mempool and nothing moved.

Broadcast

A signed bundle was rejected by the mempool, as far as this node saw. The bundle may still have reached the network by another route, or been accepted after the rejection this node observed.

Confirmation

The bundle went out and the chain then reported it could not succeed.

Implementations

impl SpendFailureStage

pub fn money_may_have_moved(self) -> bool

Could the money have moved anyway, despite the attempt failing at this stage?

Signing is the only stage that answers NO, and it answers structurally: no signed bundle existed, so there was nothing that could reach a mempool. Broadcast and Confirmation both happen AFTER a valid signed bundle exists, and neither observation proves absence — a rejection this node saw does not bind a network it does not fully observe.

This is the ONE place the distinction is decided. Every consumer asks the stage rather than re-listing the variants, so the “it did not happen” claim cannot be re-attached to a stage that never earned it. Written as an exhaustive match so adding a stage is a compile error here, forcing whoever adds it to choose a side.

pub const fn token(self) -> &'static str

The stable lowercase wire token.

Trait Implementations

impl Clone for SpendFailureStage

fn clone(&self) -> SpendFailureStage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SpendFailureStage

impl Debug for SpendFailureStage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SpendFailureStage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SpendFailureStage

impl PartialEq for SpendFailureStage

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SpendFailureStage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SpendFailureStage