Enum soroban_wasmi::errors::ErrorKind

#[non_exhaustive]
pub enum ErrorKind {
    TrapCode(TrapCode),
    Message(Box<str>),
    I32ExitStatus(i32),
    Host(Box<dyn HostError>),
    Global(GlobalError),
    Memory(MemoryError),
    Table(TableError),
    Linker(LinkerError),
    Instantiation(InstantiationError),
    Fuel(FuelError),
    Func(FuncError),
    Read(ReadError),
    Wasm(BinaryReaderError),
    Translation(TranslationError),
    Limits(EnforcedLimitsError),
}

An error that may occur upon operating on Wasm modules or module instances.

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.

TrapCode(TrapCode)

A trap code as defined by the WebAssembly specification.

Message(Box<str>)

A message usually provided by Wasmi users of host function calls.

I32ExitStatus(i32)

An i32 exit status usually used by WASI applications.

Host(Box<dyn HostError>)

A trap as defined by the WebAssembly specification.

Global(GlobalError)

A global variable error.

Memory(MemoryError)

A linear memory error.

Table(TableError)

A table error.

Linker(LinkerError)

A linker error.

Instantiation(InstantiationError)

A module instantiation error.

Fuel(FuelError)

A fuel error.

Func(FuncError)

A function error.

Read(ReadError)

Encountered when there is a problem with the Wasm input stream.

Wasm(BinaryReaderError)

Encountered when there is a Wasm parsing or validation error.

Translation(TranslationError)

Encountered when there is a Wasm to Wasmi translation error.

Limits(EnforcedLimitsError)

Encountered when an enforced limit is exceeded.

Implementations

impl ErrorKind

pub fn as_trap_code(&self) -> Option<TrapCode>

Returns a reference to TrapCode if ErrorKind is a TrapCode.

pub fn as_i32_exit_status(&self) -> Option<i32>

Returns a i32 if ErrorKind is an ErrorKind::I32ExitStatus.

pub fn as_host(&self) -> Option<&dyn HostError>

Returns a dynamic reference to HostError if ErrorKind is a HostError.

pub fn as_host_mut(&mut self) -> Option<&mut dyn HostError>

Returns a dynamic reference to HostError if ErrorKind is a HostError.

pub fn into_host(self) -> Option<Box<dyn HostError>>

Returns the HostError if ErrorKind is a HostError.

Trait Implementations

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Display for ErrorKind

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

Formats the value using the given formatter.

impl Error for ErrorKind

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.