Enum ExitCode 

#[repr(i32)]
pub enum ExitCode {
    Ok = 0,
    Panic = -1,
    InterruptionCalled = -3,
    RootCallOnly = -1_002,
    MalformedBuiltinParams = -1_003,
    CallDepthOverflow = -1_004,
    NonNegativeExitCode = -1_005,
    UnknownError = -1_006,
    InputOutputOutOfBounds = -1_007,
    PrecompileError = -1_008,
    NotSupportedBytecode = -1_009,
    StateChangeDuringStaticCall = -1_010,
    CreateContractSizeLimit = -1_011,
    CreateContractCollision = -1_012,
    CreateContractStartingWithEF = -1_013,
    OutOfMemory = -1_014,
    UnreachableCodeReached = -2_001,
    MemoryOutOfBounds = -2_002,
    TableOutOfBounds = -2_003,
    IndirectCallToNull = -2_004,
    IntegerDivisionByZero = -2_005,
    IntegerOverflow = -2_006,
    BadConversionToInteger = -2_007,
    StackOverflow = -2_008,
    BadSignature = -2_009,
    OutOfFuel = -2_010,
    UnknownExternalFunction = -2_011,
    UnexpectedFatalExecutionFailure = -3_001,
    MissingStorageSlot = -3_002,
}

Exit codes representing various execution outcomes and error conditions.

This enum defines the possible exit codes that can be returned by the execution environment.

The codes are grouped into several categories:

• Basic status codes (0 to -2)
• Fluentbase-specific error codes (-1000 and below)
• Trap error codes (-2000 and below)

Note: Exit codes cannot be positive, as positive values are used to represent call indices in interrupted executions.

Exit codes are used to represent the outcome of execution across different environments. This makes their interpretation somewhat nuanced.

Within applications, developers can use any exit code, but there are conventions:

1. Ok (0) — Indicates successful execution.
2. Panic (-1) — Controlled application reverts (intended error, no gas penalty).
3. Any other code is treated as an error with a gas penalty and is mapped to Err (-2).

Technically, developers can return trap codes, but it’s generally pointless: they are replaced by the Err (-2) code and still incur gas penalties. If the error code cannot be determined, it is mapped to UnknownError (-1006), which also results in a gas fine.

The SDK provides helper functions such as evm_exit and evm_panic to simplify returning error codes. These produce Solidity-compatible error outputs.

The exit function remains available to all developers. In some cases, an application may want to simulate trap behavior or explicitly exit with a gas penalty to comply with gas consumption standards (for instance, EVM runtime).

This behavior is similar to Solidity, where only three exit codes are supported:

• For legacy contracts: Ok = 1, Revert = 0, Err = 2
• For EOF contracts: Ok = 0, Revert = 1, Err = 2

Basic Status Codes

• Ok (0) - Successful execution
• Panic (-1) - Execution panic
• Err (-2) - General error

Fluentbase Error Codes

• RootCallOnly - Operation restricted to root-level calls
• MalformedBuiltinParams - Invalid parameters passed to builtin function
• CallDepthOverflow - Call stack depth exceeded limit
• NonNegativeExitCode - Exit code must be negative
• UnknownError - Unspecified error condition
• InputOutputOutOfBounds - I/O operation exceeded bounds
• PrecompileError - Error in precompiled contract execution

Trap Error Codes

• UnreachableCodeReached - Execution reached unreachable code
• MemoryOutOfBounds - Memory access violation
• TableOutOfBounds - Table access violation
• IndirectCallToNull - Attempted call to null function pointer
• IntegerDivisionByZero - Division by zero
• IntegerOverflow - Integer overflow occurred
• BadConversionToInteger - Invalid integer conversion
• StackOverflow - Stack limit exceeded
• BadSignature - Invalid function signature
• OutOfFuel - Insufficient gas/fuel for execution
• GrowthOperationLimited - Growth operation exceeded limits
• UnresolvedFunction - Function not found

Variants

Ok = 0

Execution is finished without errors

Panic = -1

Panic is produced by a program (aka revert)

InterruptionCalled = -3

An interruption created by runtime (only for system contracts)

RootCallOnly = -1_002

Function can only be invoked as the root entry call

MalformedBuiltinParams = -1_003

Builtin function received malformed or invalid parameters

CallDepthOverflow = -1_004

Exceeded maximum allowed call stack depth

NonNegativeExitCode = -1_005

Exit code must be non-negative, but a negative value was used

UnknownError = -1_006

Generic catch-all error for unknown failures

InputOutputOutOfBounds = -1_007

I/O operation tried to read/write outside allowed buffer bounds

PrecompileError = -1_008

An error happens inside a precompiled contract

NotSupportedBytecode = -1_009

Passed bytecode into executor is not supported

StateChangeDuringStaticCall = -1_010

State changed inside immutable call (static=true)

CreateContractSizeLimit = -1_011

Create a contract size limit reached (limit depends on the application type)

CreateContractCollision = -1_012

There is a collision on the contract creation (the same address is derived)

CreateContractStartingWithEF = -1_013

Created contract starts with invalid bytes (0xEF).

OutOfMemory = -1_014

A program runs out of memory (max memory pages reached)

UnreachableCodeReached = -2_001

Execution reached a code path marked as unreachable

MemoryOutOfBounds = -2_002

Memory access outside the allocated memory range

TableOutOfBounds = -2_003

Table index access outside the allocated table range

IndirectCallToNull = -2_004

Indirect function call attempted with a null function reference

IntegerDivisionByZero = -2_005

Division or remainder by zero occurred

IntegerOverflow = -2_006

Integer arithmetic operation overflowed the allowed range

BadConversionToInteger = -2_007

Invalid conversion to integer (e.g., from NaN or out-of-range value)

StackOverflow = -2_008

Stack reached its limit (overflow or underflow)

BadSignature = -2_009

Function signature mismatch in a call

OutOfFuel = -2_010

Execution ran out of allocated fuel/gas

UnknownExternalFunction = -2_011

Call an undefined or unregistered external function

UnexpectedFatalExecutionFailure = -3_001

An unexpected fatal execution failure (node should panic or terminate the execution)

MissingStorageSlot = -3_002

Missing storage slot

Implementations

impl ExitCode

pub const fn from_repr(discriminant: i32) -> Option<ExitCode>

Try to create Self from the raw representation

impl ExitCode

pub fn is_trap_code(&self) -> bool

Check if the exit code represents a trap code

impl ExitCode

pub fn is_ok(&self) -> bool

pub fn is_revert(&self) -> bool

Returns whether the result is a revert.

pub fn is_error(&self) -> bool

pub fn is_fatal_exit_code(&self) -> bool

Check if the exit code represents a fatal error

Fatal exit code means that the application terminated unexpectedly, for example, by having out of fuel or memory out of bounds. It means that we can’t handle the output state of this contract gracefully.

pub const fn into_i32(self) -> i32

Trait Implementations

impl Clone for ExitCode

fn clone(&self) -> ExitCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExitCode

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

Formats the value using the given formatter.

impl Default for ExitCode

fn default() -> ExitCode

Returns the “default value” for a type.

impl Display for ExitCode

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

Formats the value using the given formatter.

impl Error for ExitCode

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<&TrapCode> for ExitCode

fn from(value: &TrapCode) -> Self

Converts to this type from the input type.

impl From<ExitCode> for i32

fn from(value: ExitCode) -> Self

Converts to this type from the input type.

impl From<TrapCode> for ExitCode

fn from(value: TrapCode) -> Self

Converts to this type from the input type.

impl From<i32> for ExitCode

fn from(value: i32) -> Self

Converts to this type from the input type.

impl Hash for ExitCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ExitCode

fn eq(&self, other: &ExitCode) -> 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.

impl Copy for ExitCode

impl Eq for ExitCode

impl StructuralPartialEq for ExitCode