Enum IcrcError 

pub enum IcrcError {
    AgentBuild {
        endpoint: String,
        reason: String,
    },
    InvalidPrincipal {
        field: &'static str,
        reason: String,
    },
    InvalidSubaccountHex {
        reason: String,
    },
    InvalidSubaccountLength {
        bytes: usize,
    },
    InvalidTransactionPage {
        reason: String,
    },
    CandidEncode {
        message: &'static str,
        reason: String,
    },
    AgentCall {
        method: &'static str,
        reason: String,
    },
    CandidDecode {
        message: &'static str,
        reason: String,
    },
}

IcrcError

Error surfaced by generic ICRC validation, report building, and live calls.

Variants

AgentBuild

The selected endpoint could not construct a replica agent.

Fields

endpoint: String

Rejected replica endpoint.

reason: String

Agent construction failure.

InvalidPrincipal

A supplied principal field could not be parsed.

Fields

field: &'static str

Request field containing the principal.

reason: String

Principal parsing failure.

InvalidSubaccountHex

The supplied subaccount is not valid hexadecimal.

Fields

reason: String

Hexadecimal decoding failure.

InvalidSubaccountLength

The decoded subaccount does not contain exactly 32 bytes.

Fields

bytes: usize

Observed decoded subaccount length.

InvalidTransactionPage

Ledger or archive evidence violates the requested page bounds or callback provenance.

Fields

reason: String

Source-result invariant that failed.

CandidEncode

The typed Candid request could not be encoded.

Fields

message: &'static str

Wire operation whose encoding or decoding failed.

reason: String

Transport, encoding, or decoding failure detail.

AgentCall

The read-only replica query failed.

Fields

method: &'static str

Replica method or archive callback context.

reason: String

Transport, encoding, or decoding failure detail.

CandidDecode

The response violates its typed Candid contract or decoder budget.

Fields

message: &'static str

Wire operation whose encoding or decoding failed.

reason: String

Transport, encoding, or decoding failure detail.

Trait Implementations

impl Debug for IcrcError

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

Formats the value using the given formatter.

impl Display for IcrcError

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

Formats the value using the given formatter.

impl Error for IcrcError

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<IcrcError> for IcrcAccountTransactionError

fn from(source: IcrcError) -> Self

Converts to this type from the input type.