Enum TransactionSubmitError 

#[non_exhaustive]
pub enum TransactionSubmitError {
    OperationAlreadyExists(OperationAlreadyExistsError),
    TransactionTooLarge {
        size: usize,
        max: usize,
    },
    NoPrimaryModule {
        unit: AmountUnit,
    },
    PrimaryModule(Box<dyn Error + Send + Sync>),
    Database(DatabaseError),
    StateMachines(AddStateMachinesError),
    InsufficientFunds(InsufficientBalanceError),
}

A failure to build, submit or complete a client transaction.

Covers the whole path a transaction takes on the client: balancing it with the primary module, recording its operation, registering its state machines, and waiting for the primary module’s outputs to finalize. Submission to the federation itself is driven by a state machine and is not reported here.

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.

OperationAlreadyExists(OperationAlreadyExistsError)

The operation the transaction would be recorded under already exists.

TransactionTooLarge

The finalized transaction is larger than the federation accepts.

Fields

size: usize

The size of the encoded transaction.

max: usize

The largest transaction the federation accepts.

NoPrimaryModule

No primary module can hold funds of this unit, so the transaction cannot be balanced.

Fields

unit: AmountUnit

The unit that could not be balanced.

PrimaryModule(Box<dyn Error + Send + Sync>)

The primary module failed to balance the transaction or to complete its outputs. An insufficient balance is reported as Self::InsufficientFunds instead.

Database(DatabaseError)

Writing the transaction to the database failed.

StateMachines(AddStateMachinesError)

The transaction’s state machines could not be registered.

InsufficientFunds(InsufficientBalanceError)

The primary module holds too little balance to fund the transaction.

Implementations

impl TransactionSubmitError

pub fn is_insufficient_funds(&self) -> bool

Whether this failure means the primary module cannot fund the transaction, as opposed to a failure of the client, the database or the federation.

Trait Implementations

impl Debug for TransactionSubmitError

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

Formats the value using the given formatter.

impl Display for TransactionSubmitError

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

Formats the value using the given formatter.

impl Error for TransactionSubmitError

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 From<AddStateMachinesError> for TransactionSubmitError

fn from(source: AddStateMachinesError) -> Self

Converts to this type from the input type.

impl From<DatabaseError> for TransactionSubmitError

fn from(source: DatabaseError) -> Self

Converts to this type from the input type.

impl From<InsufficientBalanceError> for TransactionSubmitError

fn from(source: InsufficientBalanceError) -> Self

Converts to this type from the input type.

impl From<OperationAlreadyExistsError> for TransactionSubmitError

fn from(source: OperationAlreadyExistsError) -> Self

Converts to this type from the input type.