Skip to content
Tevm Docs
Blog

NonceTooLowError

Represents an error that occurs when the nonce value is too low for a transaction.

This error is typically encountered when a transaction is submitted with a nonce that is lower than the current nonce for the sender’s account. In Ethereum, nonces are used to ensure transactions are processed in the correct order and to prevent double-spending.

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: 5 // Assuming this nonce is too low
  })
} catch (error) {
  if (error instanceof NonceTooLowError) {
    console.error('Nonce too low:', error.message);
    console.log('Try increasing 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 NonceTooLowError()

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

Constructs a NonceTooLowError.

Parameters

• message: string

Human-readable error message.

• args?: NonceTooLowErrorParameters = {}

Additional parameters for the BaseError.

• tag?: string = 'NonceTooLow'

The tag for the error.

Returns

NonceTooLowError

Overrides

BaseError.constructor

Defined in

packages/errors/src/ethereum/NonceTooLowError.js:58

Properties

_tag

_tag: string

Same as name, used internally.

Inherited from

BaseError._tag

Defined in

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

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/NonceTooLowError.js:70

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