[**tevm**](../../README.md) *** [tevm](../../modules.md) / [errors](../README.md) / ContractExecutionFailedError # Class: ContractExecutionFailedError Represents an error that occurs when the execution of a smart contract fails. This error is typically encountered when a smart contract's execution reverts or encounters an exception during its operation. It can be due to various reasons such as failing assertions, out-of-gas errors, or other contract-specific logic failures. The error code -32015 is a non-standard extension used by some Ethereum clients to indicate a contract execution failure. ## Example ```ts try { const result = await client.call({ to: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e', data: '0x...' // encoded function call }) } catch (error) { if (error instanceof ContractExecutionFailedError) { console.error('Contract execution failed:', error.message); console.log('Check the contract logic or input parameters'); } } ``` ## Param A human-readable error message. ## Param Additional parameters for the BaseError. ## Extends - [`BaseError`](BaseError.md) ## Constructors ### Constructor > **new ContractExecutionFailedError**(`message`, `args?`, `tag?`): `ContractExecutionFailedError` Constructs a ContractExecutionFailedError. #### Parameters | Parameter | Type | Description | | ------ | ------ | ------ | | `message` | `string` | Human-readable error message. | | `args?` | [`ContractExecutionFailedErrorParameters`](../type-aliases/ContractExecutionFailedErrorParameters.md) | Additional parameters for the BaseError. | | `tag?` | `string` | The tag for the error. | #### Returns `ContractExecutionFailedError` #### Overrides [`BaseError`](BaseError.md).[`constructor`](BaseError.md#constructor) ## Properties | Property | Modifier | Type | Description | Inherited from | | ------ | ------ | ------ | ------ | ------ | | `_tag` | `public` | `string` | - | [`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 ContractExecutionFailedError. | - | | `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)