[**tevm**](../../README.md) *** [tevm](../../modules.md) / [errors](../README.md) / InvalidOpcodeError # Class: InvalidOpcodeError Represents an invalid bytecode/contract error that occurs when an invalid opcode is encountered during EVM execution. This error is typically encountered when the bytecode contains an opcode that is not recognized by the EVM. Invalid opcode errors can occur due to: - Typographical errors in the bytecode. - Using opcodes that are not supported by the selected EVM version or hardfork. To debug an invalid opcode error: 1. **Review Bytecode**: Ensure that the bytecode provided is correct and does not contain any invalid opcodes. 2. **Verify Common Configuration**: Ensure you are using a `common` with the correct hardfork and EIPs that support the opcodes used by your contract. 3. **Use TEVM Tracing**: Utilize TEVM tracing to step through the bytecode execution and identify where the invalid opcode is encountered. 4. **Inspect Contract Code**: Manually inspect the contract code to ensure it compiles correctly and does not include any invalid opcodes. ## Example ```typescript import { InvalidOpcodeError } from '@tevm/errors' try { // Some operation that can throw an InvalidOpcodeError } catch (error) { if (error instanceof InvalidOpcodeError) { console.error(error.message); // Handle the invalid opcode error } } ``` ## Param A human-readable error message. ## Param Additional parameters for the BaseError. ## Extends - [`ExecutionError`](ExecutionError.md) ## Constructors ### Constructor > **new InvalidOpcodeError**(`message?`, `args?`, `tag?`): `InvalidOpcodeError` #### Parameters | Parameter | Type | Description | | ------ | ------ | ------ | | `message?` | `string` | Human-readable error message. | | `args?` | [`InvalidOpcodeErrorParameters`](../type-aliases/InvalidOpcodeErrorParameters.md) | Additional parameters. | | `tag?` | `string` | Internal error tag. | #### Returns `InvalidOpcodeError` #### Overrides [`ExecutionError`](ExecutionError.md).[`constructor`](ExecutionError.md#constructor) ## Properties | Property | Modifier | Type | Description | Inherited from | | ------ | ------ | ------ | ------ | ------ | | `_tag` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`_tag`](ExecutionError.md#_tag) | | `cause` | `public` | `any` | - | [`ExecutionError`](ExecutionError.md).[`cause`](ExecutionError.md#cause) | | `code` | `public` | `number` | - | [`ExecutionError`](ExecutionError.md).[`code`](ExecutionError.md#code) | | `details` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`details`](ExecutionError.md#details) | | `docsPath` | `public` | `string` \| `undefined` | - | [`ExecutionError`](ExecutionError.md).[`docsPath`](ExecutionError.md#docspath) | | `message` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`message`](ExecutionError.md#message) | | `metaMessages` | `public` | `string`[] \| `undefined` | - | [`ExecutionError`](ExecutionError.md).[`metaMessages`](ExecutionError.md#metamessages) | | `name` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`name`](ExecutionError.md#name) | | `shortMessage` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`shortMessage`](ExecutionError.md#shortmessage) | | `stack?` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`stack`](ExecutionError.md#stack) | | `version` | `public` | `string` | - | [`ExecutionError`](ExecutionError.md).[`version`](ExecutionError.md#version) | | `code` | `static` | `number` | The error code for ExecutionError. | [`ExecutionError`](ExecutionError.md).[`code`](ExecutionError.md#code-1) | | `EVMErrorMessage` | `static` | `string` | - | - | | `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. | [`ExecutionError`](ExecutionError.md).[`stackTraceLimit`](ExecutionError.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 [`ExecutionError`](ExecutionError.md).[`walk`](ExecutionError.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 [`ExecutionError`](ExecutionError.md).[`captureStackTrace`](ExecutionError.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 [`ExecutionError`](ExecutionError.md).[`isError`](ExecutionError.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 [`ExecutionError`](ExecutionError.md).[`prepareStackTrace`](ExecutionError.md#preparestacktrace)