Enum soroban_wasmi::errors::InstantiationError

pub enum InstantiationError {
    InvalidNumberOfImports {
        required: usize,
        given: usize,
    },
    ImportsExternalsMismatch {
        expected: ExternType,
        actual: Extern,
    },
    SignatureMismatch {
        expected: FuncType,
        actual: FuncType,
    },
    Table(TableError),
    Memory(MemoryError),
    Global(GlobalError),
    ElementSegmentDoesNotFit {
        table: Table,
        offset: u32,
        amount: u32,
    },
    FoundStartFn {
        index: u32,
    },
    TooManyInstances,
}

An error that may occur upon instantiation of a Wasm module.

Variants

InvalidNumberOfImports

Encountered when trying to instantiate a Wasm module with a non-matching number of external imports.

Fields

required: usize

The number of imports required by the Wasm module definition.

given: usize

The number of imports given by the faulty Wasm module instantiation.

ImportsExternalsMismatch

Caused when a given external value does not match the type of the required import for module instantiation.

Fields

expected: ExternType

The expected external value for the module import.

actual: Extern

The actually found external value for the module import.

SignatureMismatch

Caused when a function has a mismatching signature.

Fields

expected: FuncType

The expected function signature for the function import.

actual: FuncType

The actual function signature for the function import.

Table(TableError)

Occurs when an imported table does not satisfy the required table type.

Memory(MemoryError)

Occurs when an imported memory does not satisfy the required memory type.

Global(GlobalError)

Occurs when an imported global variable does not satisfy the required global type.

ElementSegmentDoesNotFit

Caused when an element segment does not fit into the specified table instance.

Fields

table: Table

The table of the element segment.

offset: u32

The offset to store the amount of elements into the table.

amount: u32

The amount of elements with which the table is initialized at the offset.

FoundStartFn

Caused when the start function was unexpectedly found in the instantiated module.

Fields

index: u32

The index of the found start function.

TooManyInstances

Trait Implementations

impl Debug for InstantiationError

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

Formats the value using the given formatter.

impl Display for InstantiationError

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

Formats the value using the given formatter.

impl Error for InstantiationError

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<GlobalError> for InstantiationError

fn from(error: GlobalError) -> Self

Converts to this type from the input type.

impl From<InstantiationError> for Error

fn from(error: InstantiationError) -> Self

Converts to this type from the input type.

impl From<MemoryError> for InstantiationError

fn from(error: MemoryError) -> Self

Converts to this type from the input type.

impl From<TableError> for InstantiationError

fn from(error: TableError) -> Self

Converts to this type from the input type.