Enum IcrcAccountTransactionError 

pub enum IcrcAccountTransactionError {
    InvalidSourceEndpoint {
        value: String,
        reason: String,
    },
    InvalidPageSize {
        page_size: u32,
        max_page_size: u32,
    },
    InvalidListLimit {
        limit: u32,
    },
    InvalidMaxPages {
        max_pages: u32,
    },
    InvalidCursor {
        value: String,
        reason: String,
    },
    Query(IcrcError),
    IndexDiscovery {
        ledger_canister_id: String,
        source: IcrcError,
    },
    IndexUnavailable {
        ledger_canister_id: String,
        reason: String,
    },
    IndexLedgerMismatch {
        index_canister_id: String,
        expected_ledger_canister_id: String,
        actual_ledger_canister_id: String,
    },
    IndexQuery {
        index_canister_id: String,
        message: String,
    },
    IncompleteCollection {
        index_canister_id: Option<String>,
        pages_fetched: u32,
        rows_fetched: usize,
        last_cursor: Option<String>,
        reason: String,
    },
    CollectionPage {
        index_canister_id: Option<String>,
        pages_fetched: u32,
        rows_fetched: usize,
        last_cursor: Option<String>,
        source: Box<Self>,
    },
    CollectionIndexMismatch {
        expected_index_canister_id: String,
        actual_index_canister_id: String,
    },
    InvalidCache {
        path: PathBuf,
        reason: String,
    },
    InvalidRefreshAttempt {
        path: PathBuf,
        reason: String,
    },
}

IcrcAccountTransactionError

Error surfaced while resolving and querying an ICRC account index.

Variants

InvalidSourceEndpoint

A cache identity omitted its endpoint.

Fields

value: String

Rejected endpoint.

reason: String

Validation failure.

InvalidPageSize

A page or refresh requested an unsupported page size.

Fields

page_size: u32

Rejected page size.

max_page_size: u32

Largest supported page size.

InvalidListLimit

A cache view requested no rows.

Fields

limit: u32

Rejected view limit.

InvalidMaxPages

A diagnostic refresh bound cannot prove any collection progress.

Fields

max_pages: u32

Rejected page bound.

InvalidCursor

A caller supplied a non-decimal or otherwise invalid candid Nat cursor.

Fields

value: String

Rejected cursor text.

reason: String

Validation failure.

Query(IcrcError)

A ledger, index, principal, Candid, or transport operation failed.

IndexDiscovery

ICRC-106 discovery could not be queried or decoded.

Fields

ledger_canister_id: String

Ledger queried for index discovery.

source: IcrcError

Underlying transport or Candid failure.

IndexUnavailable

ICRC-106 discovery did not yield an index canister.

Fields

ledger_canister_id: String

Ledger queried for index discovery.

reason: String

Discovery result explaining why no index is usable.

IndexLedgerMismatch

The selected index reports a different ledger identity.

Fields

index_canister_id: String

Index whose ledger_id response was checked.

expected_ledger_canister_id: String

Ledger requested by the caller.

actual_ledger_canister_id: String

Ledger reported by the index.

IndexQuery

The index returned an application-level account-history error.

Fields

index_canister_id: String

Index that returned the error.

message: String

Index-provided error message.

IncompleteCollection

Complete collection stopped before the source API was exhausted.

Fields

index_canister_id: Option<String>

Verified index used for collection when resolution completed.

pages_fetched: u32

Successfully fetched pages.

rows_fetched: usize

Rows retained.

last_cursor: Option<String>

Last exclusive cursor when present.

reason: String

Reason the collection could not be proven complete.

CollectionPage

A page fetch failed after collection had begun.

Fields

index_canister_id: Option<String>

Verified index used for collection when resolution completed.

pages_fetched: u32

Successfully fetched pages before the failure.

rows_fetched: usize

Rows retained before the failure.

last_cursor: Option<String>

Last exclusive cursor when present.

source: Box<Self>

Underlying typed page failure.

CollectionIndexMismatch

A custom collection source returned evidence for a different explicit index.

Fields

expected_index_canister_id: String

Index explicitly requested by the caller.

actual_index_canister_id: String

Index claimed by the completed collection.

InvalidCache

A complete cache failed semantic validation.

Fields

path: PathBuf

Cache path.

reason: String

Validation failure.

InvalidRefreshAttempt

A refresh-attempt sidecar failed semantic validation.

Fields

path: PathBuf

Attempt sidecar path.

reason: String

Validation failure.

Trait Implementations

impl Debug for IcrcAccountTransactionError

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

Formats the value using the given formatter.

impl Display for IcrcAccountTransactionError

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

Formats the value using the given formatter.

impl Error for IcrcAccountTransactionError

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.