[**tevm**](../../README.md) *** [tevm](../../modules.md) / [errors](../README.md) / ExecutionError # Class: ExecutionError Represents an error that occurs when an execution error happens on the Ethereum node. This error is typically encountered when there is a general execution error that does not fit more specific categories. The error code -32015 is a non-standard extension used for EVM execution errors. ## Example ```ts try { // Some operation that can throw an ExecutionError } catch (error) { if (error instanceof ExecutionError) { console.error(error.message); // Handle the execution error } } ``` ## Param A human-readable error message. ## Param Additional parameters for the BaseError. ## Extends - [`BaseError`](BaseError.md) ## Extended by - [`CommonMismatchError`](CommonMismatchError.md) - [`EipNotEnabledError`](EipNotEnabledError.md) - [`AuthCallUnsetError`](AuthCallUnsetError.md) - [`BLS12381FpNotInFieldError`](BLS12381FpNotInFieldError.md) - [`BLS12381InputEmptyError`](BLS12381InputEmptyError.md) - [`BLS12381InvalidInputLengthError`](BLS12381InvalidInputLengthError.md) - [`BLS12381PointNotOnCurveError`](BLS12381PointNotOnCurveError.md) - [`CreateCollisionError`](CreateCollisionError.md) - [`InitcodeSizeViolationError`](InitcodeSizeViolationError.md) - [`InsufficientBalanceError`](InsufficientBalanceError.md) - [`InvalidBeginSubError`](InvalidBeginSubError.md) - [`InvalidBytecodeResultError`](InvalidBytecodeResultError.md) - [`InvalidCommitmentError`](InvalidCommitmentError.md) - [`InvalidEofFormatError`](InvalidEofFormatError.md) - [`InvalidInputLengthError`](InvalidInputLengthError.md) - [`InvalidJumpError`](InvalidJumpError.md) - [`InvalidJumpSubError`](InvalidJumpSubError.md) - [`InvalidKzgInputsError`](InvalidKzgInputsError.md) - [`InvalidOpcodeError`](InvalidOpcodeError.md) - [`InvalidProofError`](InvalidProofError.md) - [`InvalidReturnSubError`](InvalidReturnSubError.md) - [`OutOfRangeError`](OutOfRangeError.md) - [`RefundExhaustedError`](RefundExhaustedError.md) - [`StackOverflowError`](StackOverflowError.md) - [`StackUnderflowError`](StackUnderflowError.md) - [`StaticStateChangeError`](StaticStateChangeError.md) - [`StopError`](StopError.md) - [`ValueOverflowError`](ValueOverflowError.md) ## Constructors ### Constructor > **new ExecutionError**(`message`, `args?`, `tag?`): `ExecutionError` Constructs an ExecutionError. #### Parameters | Parameter | Type | Description | | ------ | ------ | ------ | | `message` | `string` | Human-readable error message. | | `args?` | [`ExecutionErrorParameters`](../type-aliases/ExecutionErrorParameters.md) | Additional parameters for the BaseError. | | `tag?` | `string` | The tag for the error. | #### Returns `ExecutionError` #### Overrides [`BaseError`](BaseError.md).[`constructor`](BaseError.md#constructor) ## Properties | Property | Modifier | Type | Description | Inherited from | | ------ | ------ | ------ | ------ | ------ | | `_tag` | `public` | `string` | More discriminated version of name. Can be used to discriminate between errors with the same name. | [`BaseError`](BaseError.md).[`_tag`](BaseError.md#_tag) | | `cause` | `public` | `any` | - | [`BaseError`](BaseError.md).[`cause`](BaseError.md#cause) | | `code` | `public` | `number` | - | [`BaseError`](BaseError.md).[`code`](BaseError.md#code) | | `details` | `public` | `string` | - | [`BaseError`](BaseError.md).[`details`](BaseError.md#details) | | `docsPath` | `public` | `string` \| `undefined` | - | [`BaseError`](BaseError.md).[`docsPath`](BaseError.md#docspath) | | `message` | `public` | `string` | - | [`BaseError`](BaseError.md).[`message`](BaseError.md#message) | | `metaMessages` | `public` | `string`[] \| `undefined` | - | [`BaseError`](BaseError.md).[`metaMessages`](BaseError.md#metamessages) | | `name` | `public` | `string` | - | [`BaseError`](BaseError.md).[`name`](BaseError.md#name) | | `shortMessage` | `public` | `string` | - | [`BaseError`](BaseError.md).[`shortMessage`](BaseError.md#shortmessage) | | `stack?` | `public` | `string` | - | [`BaseError`](BaseError.md).[`stack`](BaseError.md#stack) | | `version` | `public` | `string` | - | [`BaseError`](BaseError.md).[`version`](BaseError.md#version) | | `code` | `static` | `number` | The error code for ExecutionError. | - | | `stackTraceLimit` | `static` | `number` | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | [`BaseError`](BaseError.md).[`stackTraceLimit`](BaseError.md#stacktracelimit) | ## Methods ### walk() > **walk**(`fn?`): `unknown` Walks through the error chain. #### Parameters | Parameter | Type | Description | | ------ | ------ | ------ | | `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 [`BaseError`](BaseError.md).[`walk`](BaseError.md#walk) *** ### captureStackTrace() > `static` **captureStackTrace**(`targetObject`, `constructorOpt?`): `void` Creates a `.stack` property on `targetObject`, which when accessed returns a string representing the location in the code at which `Error.captureStackTrace()` was called. ```js const myObject = {}; Error.captureStackTrace(myObject); myObject.stack; // Similar to `new Error().stack` ``` The first line of the trace will be prefixed with `${myObject.name}: ${myObject.message}`. The optional `constructorOpt` argument accepts a function. If given, all frames above `constructorOpt`, including `constructorOpt`, will be omitted from the generated stack trace. The `constructorOpt` argument is useful for hiding implementation details of error generation from the user. For instance: ```js function a() { b(); } function b() { c(); } function c() { // Create an error without stack trace to avoid calculating the stack trace twice. const { stackTraceLimit } = Error; Error.stackTraceLimit = 0; const error = new Error(); Error.stackTraceLimit = stackTraceLimit; // Capture the stack trace above function b Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace throw error; } a(); ``` #### Parameters | Parameter | Type | | ------ | ------ | | `targetObject` | `object` | | `constructorOpt?` | `Function` | #### Returns `void` #### Inherited from [`BaseError`](BaseError.md).[`captureStackTrace`](BaseError.md#capturestacktrace) *** ### isError() > `static` **isError**(`error`): `error is Error` Indicates whether the argument provided is a built-in Error instance or not. #### Parameters | Parameter | Type | | ------ | ------ | | `error` | `unknown` | #### Returns `error is Error` #### Inherited from [`BaseError`](BaseError.md).[`isError`](BaseError.md#iserror) *** ### prepareStackTrace() > `static` **prepareStackTrace**(`err`, `stackTraces`): `any` #### Parameters | Parameter | Type | | ------ | ------ | | `err` | `Error` | | `stackTraces` | `CallSite`[] | #### Returns `any` #### See https://v8.dev/docs/stack-trace-api#customizing-stack-traces #### Inherited from [`BaseError`](BaseError.md).[`prepareStackTrace`](BaseError.md#preparestacktrace)