Enum StylusError 

pub enum StylusError {
    Memory(MemoryAccessError),
    Internal(String),
    Backend(String),
    Logical(String),
    OutOfInk,
    Exit(u32),
    Compile(String),
    Instantiation(String),
    Activation(String),
    InvalidProgram(&'static str),
    Decompression(String),
    Run(String),
    MissingGlobal(String),
    UnsupportedDictionaryVersion(u16),
}

All failure modes raised by the Stylus runtime.

Variants

Memory(MemoryAccessError)

WASM linear-memory access (read/write) failed, typically because a host function received an out-of-bounds pointer from the program.

Internal(String)

A host function detected an unrecoverable internal condition (e.g. the underlying journal returned an error during sload/sstore). Surfaces from the WASM trap as UserOutcome::Failure.

Backend(String)

The backing store failed while reading program/fragment data. This is an infrastructure failure that must abort the block, not revert the call.

Logical(String)

A host function rejected its inputs on semantic grounds (e.g. emit_log called in a static context, malformed topic data). Surfaces as UserOutcome::Failure.

OutOfInk

The program exhausted its ink budget mid-host-call. Surfaces as UserOutcome::OutOfInk.

Exit(u32)

The program returned voluntarily via exit_early(status). A non-zero status is reported as UserOutcome::Revert.

Compile(String)

Wasmer module compilation or serialization failed. Carries the rendered wasmer error since the underlying type varies across compilation backends.

Instantiation(String)

Wasmer instance creation failed (import binding, memory export, or start function).

Activation(String)

activate_program failed at the prover-machine level. Wraps the rendered error from the activation pipeline.

InvalidProgram(&'static str)

The contract bytecode does not satisfy Stylus structural requirements (e.g. missing discriminant or unsupported dictionary).

Decompression(String)

Brotli decompression of the Stylus payload failed.

Run(String)

TypedFunction::call returned a non-trap error that could not be downcast to StylusError. The original message is preserved.

MissingGlobal(String)

A required wasmer global export was missing or had the wrong type.

UnsupportedDictionaryVersion(u16)

The compile/runtime version requested for a Stylus program is not supported by this build. The version is read from contract storage and is therefore considered attacker-influenced — bad values must surface as a typed error rather than panic.

Implementations

impl StylusError

pub fn internal<T>(error: impl Into<String>) -> Result<T, StylusError>

Construct an Internal failure in an Err(_).

pub fn logical<T>(error: impl Into<String>) -> Result<T, StylusError>

Construct a Logical failure in an Err(_).

pub fn out_of_ink<T>() -> Result<T, StylusError>

Construct an OutOfInk failure in an Err(_).

Trait Implementations

impl Debug for StylusError

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

Formats the value using the given formatter.

impl Display for StylusError

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

Formats the value using the given formatter.

impl Error for StylusError

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

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<MemoryAccessError> for StylusError

fn from(source: MemoryAccessError) -> Self

Converts to this type from the input type.