[**tevm**](../../README.md)
***
[tevm](../../modules.md) / [errors](../README.md) / NonceTooHighError
# Class: NonceTooHighError
Represents an error that occurs when the nonce value is too high for a transaction.
This error is typically encountered when a transaction is submitted with a nonce that is higher
than the expected next nonce for the sender's account. In Ethereum, nonces must be used in strict
sequential order to ensure transactions are processed correctly.
The error code -32003 is a standard Ethereum JSON-RPC error code indicating a transaction rejected,
which is used when a transaction is not accepted for processing due to validation failures
such as incorrect nonce values.
## Example
```ts
try {
await client.sendTransaction({
from: '0x1234567890123456789012345678901234567890',
to: '0x0987654321098765432109876543210987654321',
value: '0x1',
nonce: 100 // Assuming this nonce is too high
})
} catch (error) {
if (error instanceof NonceTooHighError) {
console.error('Nonce too high:', error.message);
console.log('Try decreasing the nonce or use `await client.getTransactionCount(address)` to get the correct nonce');
}
}
```
## Param
A human-readable error message.
## Param
Additional parameters for the BaseError.
## Extends
- [`BaseError`](BaseError.md)
## Constructors
### Constructor
> **new NonceTooHighError**(`message`, `args?`, `tag?`): `NonceTooHighError`
Constructs a NonceTooHighError.
#### Parameters
| Parameter | Type | Description |
| ------ | ------ | ------ |
| `message` | `string` | Human-readable error message. |
| `args?` | [`NonceTooHighErrorParameters`](../type-aliases/NonceTooHighErrorParameters.md) | Additional parameters for the BaseError. |
| `tag?` | `string` | The tag for the error. |
#### Returns
`NonceTooHighError`
#### 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 NonceTooHighError. | - |
| `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)