StackOverflowError

Represents an invalid bytecode error that occurs when there is a stack overflow during execution. This error is typically encountered when an operation causes the stack to exceed its limit.

Stack overflow errors can occur due to:

Excessive recursion leading to too many function calls.
Bugs in smart contract logic that cause infinite loops or excessive stack usage.
Incorrect management of stack operations (e.g., pushing too many items onto the stack).

To debug a stack overflow error:

Review Contract Logic: Ensure that your smart contract logic correctly handles recursion and stack operations.
Optimize Stack Usage: Refactor your code to reduce stack usage, such as minimizing the depth of recursive calls.
Use TEVM Tracing: Utilize TEVM tracing to step through the transaction and inspect stack changes.
Use Other Tools: Use other tools with tracing such as Foundry.

Ethereumjs Source: Refer to the source file where this error can occur.

Example

try {
  // Some operation that can throw a StackOverflowError
} catch (error) {
  if (error instanceof StackOverflowError) {
    console.error(error.message);
    // Handle the stack overflow error
  }
}

Param

A human-readable error message.

Param

Additional parameters for the BaseError.

Extends

ExecutionError

Constructors

new StackOverflowError()

new StackOverflowError(message?, args?): StackOverflowError

Constructs a StackOverflowError. Represents an invalid bytecode error that occurs when there is a stack overflow during execution. This error is typically encountered when an operation causes the stack to exceed its limit.

Stack overflow errors can occur due to:

Excessive recursion leading to too many function calls.
Bugs in smart contract logic that cause infinite loops or excessive stack usage.
Incorrect management of stack operations (e.g., pushing too many items onto the stack).

To debug a stack overflow error:

Review Contract Logic: Ensure that your smart contract logic correctly handles recursion and stack operations.
Optimize Stack Usage: Refactor your code to reduce stack usage, such as minimizing the depth of recursive calls.
Use TEVM Tracing: Utilize TEVM tracing to step through the transaction and inspect stack changes.
Use Other Tools: Use other tools with tracing such as Foundry.

Ethereumjs Source: Refer to the source file where this error can occur.

Parameters

• message?: string= 'Stack overflow error occurred.'

Human-readable error message.

• args?: StackOverflowErrorParameters= {}

Additional parameters for the BaseError.

Returns

StackOverflowError

Overrides

ExecutionError.constructor

Source

packages/errors/src/ethereum/ethereumjs/StackOverflowError.js:75

Properties

_tag

_tag: string

Same as name, used internally.

Inherited from

ExecutionError._tag

Source

packages/errors/src/ethereum/ethereumjs/StackOverflowError.js:92

cause

cause: any

Inherited from

ExecutionError.cause

Source

packages/errors/src/ethereum/BaseError.js:114

code

code: number

Error code, analogous to the code in JSON RPC error.

Inherited from

ExecutionError.code

Source

packages/errors/src/ethereum/BaseError.js:112

details

details: string

Inherited from

ExecutionError.details

Source

packages/errors/src/ethereum/BaseError.js:91

docsPath

docsPath: undefined | string

Path to the documentation for this error.

Inherited from

ExecutionError.docsPath

Source

packages/errors/src/ethereum/BaseError.js:96

message

message: string

Human-readable error message.

Inherited from

ExecutionError.message

Source

node_modules/.pnpm/typescript@5.4.5/node_modules/typescript/lib/lib.es5.d.ts:1077

metaMessages

metaMessages: undefined | string[]

Additional meta messages for more context.

Inherited from

ExecutionError.metaMessages

Source

packages/errors/src/ethereum/BaseError.js:100

name

name: "ExecutionError" = 'ExecutionError'

The name of the error, used to discriminate errors.

Inherited from

ExecutionError.name

Source

packages/errors/src/ethereum/ExecutionErrorError.js:82

shortMessage

shortMessage: string

Inherited from

ExecutionError.shortMessage

Source

packages/errors/src/ethereum/BaseError.js:104

stack?

optional stack: string

Inherited from

ExecutionError.stack

Source

node_modules/.pnpm/typescript@5.4.5/node_modules/typescript/lib/lib.es5.d.ts:1078

version

version: string

Inherited from

ExecutionError.version

Source

packages/errors/src/ethereum/BaseError.js:108

prepareStackTrace()?

static optional prepareStackTrace: (err, stackTraces) => any

Optional override for formatting stack traces

See

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Parameters

• err: Error

• stackTraces: CallSite[]

Returns

any

Inherited from

ExecutionError.prepareStackTrace

Source

node_modules/.pnpm/@types+node@20.14.2/node_modules/@types/node/globals.d.ts:28

stackTraceLimit

static stackTraceLimit: number

Inherited from

ExecutionError.stackTraceLimit

Source

node_modules/.pnpm/@types+node@20.14.2/node_modules/@types/node/globals.d.ts:30

Methods

walk()

walk(fn?): unknown

Walks through the error chain.

Parameters

• fn?: Function

A function to execute on each error in the chain.

Returns

unknown

The first error that matches the function, or the original error.

Inherited from

ExecutionError.walk

Source

packages/errors/src/ethereum/BaseError.js:137

captureStackTrace()

captureStackTrace(targetObject, constructorOpt)

static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

• targetObject: object

• constructorOpt?: Function

Returns

void

Inherited from

ExecutionError.captureStackTrace

Source

node_modules/.pnpm/@types+node@20.14.2/node_modules/@types/node/globals.d.ts:21

captureStackTrace(targetObject, constructorOpt)

static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

• targetObject: object

• constructorOpt?: Function

Returns

void

Inherited from

ExecutionError.captureStackTrace

Source

node_modules/.pnpm/bun-types@1.1.12/node_modules/bun-types/globals.d.ts:1613