Enum ProgramsError 

pub enum ProgramsError {
    Storage(StorageError),
    NotActivated,
    VersionMismatch {
        program: u64,
        params: u64,
    },
    Expired,
    InvalidParamsUpgrade(&'static str),
    UpToDate,
    KeepaliveTooSoon,
    NeedsUpgrade,
    InsufficientGas {
        needed: u64,
        have: u64,
    },
    ReturnDataOutOfGas,
    Activation {
        reason: String,
    },
    Execution {
        reason: String,
    },
}

Errors raised by the Stylus programs subsystem.

Variants

Storage(StorageError)

Underlying storage failure.

NotActivated

open_program_at was called for a code hash that has not been activated (its stored version is 0).

VersionMismatch

The program’s stored version does not match the version recorded in the current Stylus params.

Fields

program: u64

Version recorded on the program itself.

params: u64

Version expected by the active Stylus params.

Expired

The program’s age exceeds the configured expiry window.

InvalidParamsUpgrade(&'static str)

upgrade_to_version / upgrade_to_arbos_version was called from a state that does not satisfy the required precondition (e.g. trying to upgrade past a version that hasn’t been reached).

UpToDate

activate_program was invoked for a program that is already at the current Stylus version and within its expiry window.

KeepaliveTooSoon

program_keepalive was invoked before enough time has elapsed since the last activation/keepalive.

NeedsUpgrade

The program’s stored version is older than the active Stylus version and an upgrade is required before this operation.

InsufficientGas

A Stylus call was attempted with insufficient gas to cover the call cost (memory + init/cached gas).

Fields

needed: u64

Gas required to cover the call cost.

have: u64

Gas available at the call site.

ReturnDataOutOfGas

The Stylus call returned data whose EVM-equivalent memory cost exceeds the gas that was available at call entry. All remaining gas is consumed.

Activation

The prover-machine activation step (WASM compile/validate) failed with a runtime-supplied diagnostic.

Fields

reason: String

Diagnostic message preserved from the activation backend.

Execution

The user-supplied call dispatcher reported a runtime error (e.g. a trap or non-success outcome).

Fields

reason: String

Diagnostic message preserved from the Stylus runtime.

Trait Implementations

impl Clone for ProgramsError

fn clone(&self) -> ProgramsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProgramsError

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

Formats the value using the given formatter.

impl Display for ProgramsError

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

Formats the value using the given formatter.

impl Error for ProgramsError

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<ProgramsError> for ArbosStateError

fn from(source: ProgramsError) -> Self

Converts to this type from the input type.

impl From<StorageError> for ProgramsError

fn from(source: StorageError) -> Self

Converts to this type from the input type.