Skip to content
Tevm Docs
Blog

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 -32000 is a standard Ethereum JSON-RPC error code indicating a generic server error, which is often used for various transaction-related errors including nonce issues.

Example

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

Constructors

new NonceTooHighError()

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

Constructs a NonceTooHighError.

Parameters

• message: string

Human-readable error message.

• args?: NonceTooHighErrorParameters = {}

Additional parameters for the BaseError.

• tag?: string = 'NonceTooHigh'

The tag for the error.

Returns

NonceTooHighError

Overrides

BaseError.constructor

Defined in

packages/errors/src/ethereum/NonceTooHighError.js:59

Properties

_tag

_tag: string

Same as name, used internally.

Inherited from

BaseError._tag

Defined in

packages/errors/src/ethereum/NonceTooHighError.js:72

cause

cause: any

Inherited from

BaseError.cause

Defined in

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

code

code: number

Error code (-32000), standard Ethereum JSON-RPC error code for server errors.

Inherited from

BaseError.code

Defined in

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

details

details: string

Inherited from

BaseError.details

Defined in

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

docsPath

docsPath: undefined | string

Path to the documentation for this error.

Inherited from

BaseError.docsPath

Defined in

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

message

message: string

Human-readable error message.

Inherited from

BaseError.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

BaseError.metaMessages

Defined in

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

name

name: string

The name of the error, used to discriminate errors.

Inherited from

BaseError.name

Defined in

packages/errors/src/ethereum/NonceTooHighError.js:71

shortMessage

shortMessage: string

Inherited from

BaseError.shortMessage

Defined in

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

stack?

optional stack: string

Inherited from

BaseError.stack

Defined in

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

version

version: string

Inherited from

BaseError.version

Defined in

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

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

BaseError.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

BaseError.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

BaseError.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

BaseError.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

BaseError.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

BaseError.captureStackTrace

Defined in

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