Enum Error 

pub enum Error {
    InsufficientLiquidCycleBalance(InsufficientLiquidCycleBalance),
    CallPerformFailed(CallPerformFailed),
    CallRejected(CallRejected),
    CandidDecodeFailed(CandidDecodeFailed),
}

Represents errors that can occur during inter-canister calls.

This is the top-level error type for the inter-canister call API.

This encapsulates all possible errors that can arise, including:

• Insufficient liquid cycle balance.
• ic0.call_perform failed.
• Asynchronously rejected.
• Candid decoding of the response failed.

Variants

InsufficientLiquidCycleBalance(InsufficientLiquidCycleBalance)

The liquid cycle balance is insufficient to perform the call.

CallPerformFailed(CallPerformFailed)

The ic0.call_perform operation failed.

CallRejected(CallRejected)

The inter-canister call is rejected.

CandidDecodeFailed(CandidDecodeFailed)

The response from the inter-canister call could not be decoded as Candid.

This variant wraps errors that occur when attempting to decode the response into the expected Candid type.

Trait Implementations

impl CallErrorExt for Error

fn is_clean_reject(&self) -> bool

Checks if the error is a clean reject. A clean reject means that there must be no state changes on the callee side.

fn is_immediately_retryable(&self) -> bool

Determines if the failed call can be retried immediately within the update method that’s handling the error, as opposed to relying on a background timer or heartbeat.

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<CallFailed> for Error

fn from(e: CallFailed) -> Self

Converts to this type from the input type.

impl From<CallPerformFailed> for Error

fn from(source: CallPerformFailed) -> Self

Converts to this type from the input type.

impl From<CallRejected> for Error

fn from(source: CallRejected) -> Self

Converts to this type from the input type.

impl From<CandidDecodeFailed> for Error

fn from(source: CandidDecodeFailed) -> Self

Converts to this type from the input type.

impl From<InsufficientLiquidCycleBalance> for Error

fn from(source: InsufficientLiquidCycleBalance) -> Self

Converts to this type from the input type.

impl From<OnewayError> for Error

fn from(e: OnewayError) -> Self

Converts to this type from the input type.