Enum RuntimeError

pub enum RuntimeError {
    InvokeError(InvokeError),
    Metering(Box<dyn Any + Send>),
    InstanceImage(Box<dyn Any + Send>),
    User(Box<dyn Any + Send>),
}

A RuntimeError is an error that describes why the attempt to fully execute some Wasm has failed.

These reasons vary from the Wasm trapping or otherwise failing directly to user controlled conditions such as metering running out of gas or a user host function returning a custom error type directly.

Variants

InvokeError(InvokeError)

An error relating to the invocation of a Wasm function.

Metering(Box<dyn Any + Send>)

A metering triggered error value.

An error of this type indicates that it was returned by the metering system.

InstanceImage(Box<dyn Any + Send>)

A frozen state of Wasm used to pause and resume execution. Not strictly an “error”, but this happens while executing and therefore is a RuntimeError from the persective of the caller that expected the code to fully execute.

User(Box<dyn Any + Send>)

A user triggered error value.

An error returned from a host function.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

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<InvokeError> for RuntimeError

fn from(other: InvokeError) -> RuntimeError

Converts to this type from the input type.

impl From<RuntimeError> for CallError

fn from(runtime_err: RuntimeError) -> Self

Converts to this type from the input type.

impl From<RuntimeError> for Error

fn from(runtime_err: RuntimeError) -> Self

Converts to this type from the input type.

impl PartialEq for RuntimeError

fn eq(&self, _other: &RuntimeError) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.