Enum CommandFailure 

pub enum CommandFailure {
    NotSent(String),
    Ambiguous(String),
    VenueRejected(String),
}

Classifies why a state-changing order command failed, by the evidence available.

Adapters keep their own error types and map each submit, modify, or cancel failure to one variant, including the batch and list forms, so the same wire condition classifies identically across venues. A definitive venue acceptance or update is not a failure and carries no variant.

This axis is independent of retryability. Retryability answers whether to send the request again; this answers whether the venue may already have acted on the first attempt. An error can be both, either, or neither.

Variants

NotSent(String)

A deterministic local failure proves the command was never transmitted.

A terminal rejection event is valid for this evidence.

Ambiguous(String)

The venue outcome is undefined; the command may still have been applied.

A terminal event is never valid for this evidence. Leave the command in flight for a stream update, query, poll, or reconciliation to resolve it either way.

VenueRejected(String)

The venue explicitly declared the command rejected.

A terminal rejection event is valid for this evidence.

Implementations

impl CommandFailure

pub fn not_sent(reason: impl Into<String>) -> Self

Creates a new CommandFailure::NotSent with the given reason.

pub fn ambiguous(reason: impl Into<String>) -> Self

Creates a new CommandFailure::Ambiguous with the given reason.

pub fn venue_rejected(reason: impl Into<String>) -> Self

Creates a new CommandFailure::VenueRejected with the given reason.

Trait Implementations

impl Clone for CommandFailure

fn clone(&self) -> CommandFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandFailure

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

Formats the value using the given formatter.

impl Eq for CommandFailure

impl PartialEq for CommandFailure

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CommandFailure