Skip to content

RefundExhaustedError

Represents an invalid bytecode error that occurs when the gas refund limit is exhausted. EVM transaction execution metadata level error

Refund exhausted errors can occur due to:

  • The transaction exceeding the gas refund limit.

To debug a refund exhausted error:

  1. Review Gas Usage: Ensure that the gas usage in the contract is within the refund limits.
  2. Use TEVM Tracing: Utilize TEVM tracing to step through the contract execution and identify excessive gas usage.

Example

import { RefundExhaustedError } from '@tevm/errors'
try {
// Some operation that can throw a RefundExhaustedError
} catch (error) {
if (error instanceof RefundExhaustedError) {
console.error(error.message);
// Handle the refund exhausted error
}
}

Param

A human-readable error message.

Param

Additional parameters for the BaseError.

Extends

Constructors

new RefundExhaustedError()

new RefundExhaustedError(message?, args?, tag?): RefundExhaustedError

Constructs a RefundExhaustedError. Represents an invalid bytecode error that occurs when the gas refund limit is exhausted. EVM transaction execution metadata level error

Refund exhausted errors can occur due to:

  • The transaction exceeding the gas refund limit.

To debug a refund exhausted error:

  1. Review Gas Usage: Ensure that the gas usage in the contract is within the refund limits.
  2. Use TEVM Tracing: Utilize TEVM tracing to step through the contract execution and identify excessive gas usage.

Parameters

message?: string = 'Refund exhausted error occurred.'

Human-readable error message.

args?: RefundExhaustedErrorParameters = {}

Additional parameters for the BaseError.

tag?: string = 'RefundExhaustedError'

The tag for the error.}

Returns

RefundExhaustedError

Overrides

ExecutionError.constructor

Defined in

packages/errors/src/ethereum/ethereumjs/RefundExhausted.js:69

Properties

_tag

_tag: string

Same as name, used internally.

Inherited from

ExecutionError._tag

Defined in

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


cause

cause: any

Inherited from

ExecutionError.cause

Defined in

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


code

code: number

Inherited from

ExecutionError.code

Defined in

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


details

details: string

Inherited from

ExecutionError.details

Defined in

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


docsPath

docsPath: undefined | string

Path to the documentation for this error.

Inherited from

ExecutionError.docsPath

Defined in

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


message

message: string

Human-readable error message.

Inherited from

ExecutionError.message

Defined in

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


metaMessages

metaMessages: undefined | string[]

Additional meta messages for more context.

Inherited from

ExecutionError.metaMessages

Defined in

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


name

name: string

The name of the error, used to discriminate errors.

Inherited from

ExecutionError.name

Defined in

node_modules/.pnpm/typescript@5.6.2/node_modules/typescript/lib/lib.es5.d.ts:1076


shortMessage

shortMessage: string

Inherited from

ExecutionError.shortMessage

Defined in

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


stack?

optional stack: string

Inherited from

ExecutionError.stack

Defined in

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


version

version: string

Inherited from

ExecutionError.version

Defined in

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


code

static code: number = -32000

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

Inherited from

ExecutionError.code

Defined in

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


EVMErrorMessage

static EVMErrorMessage: EvmErrorMessage = EVMErrorMessage.REFUND_EXHAUSTED

Defined in

packages/errors/src/ethereum/ethereumjs/RefundExhausted.js:51


prepareStackTrace()?

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

Optional override for formatting stack traces

Parameters

err: Error

stackTraces: CallSite[]

Returns

any

See

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

Inherited from

ExecutionError.prepareStackTrace

Defined in

node_modules/.pnpm/@types+node@22.7.3/node_modules/@types/node/globals.d.ts:143


stackTraceLimit

static stackTraceLimit: number

Inherited from

ExecutionError.stackTraceLimit

Defined in

node_modules/.pnpm/@types+node@22.7.3/node_modules/@types/node/globals.d.ts:145

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

Defined in

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

Defined in

node_modules/.pnpm/@types+node@22.7.3/node_modules/@types/node/globals.d.ts:136

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

Defined in

node_modules/.pnpm/bun-types@1.1.29/node_modules/bun-types/globals.d.ts:1630

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

Defined in

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