Skip to content

BlockGasLimitExceededError

Represents an error that occurs when the block gas limit has been exceeded.

This error is typically encountered when a transaction or set of transactions in a block consume more gas than the block’s gas limit allows. Each block in Ethereum has a maximum amount of gas that can be used by all transactions within it.

The error code -32006 is a non-standard extension used by some Ethereum clients to indicate this specific condition.

Example

try {
const result = await client.sendTransaction({
// ... transaction details
})
} catch (error) {
if (error instanceof BlockGasLimitExceededError) {
console.error('Block gas limit exceeded:', error.message);
console.log('Consider splitting the transaction or waiting for a block with more available gas');
}
}

Param

A human-readable error message.

Param

Additional parameters for the BaseError.

Extends

Constructors

new BlockGasLimitExceededError()

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

Constructs a BlockGasLimitExceededError.

Parameters

message: string

Human-readable error message.

args?: BlockGasLimitExceededErrorParameters = {}

Additional parameters for the BaseError.

tag?: string = 'BlockGasLimitExceededError'

The tag for the error.

Returns

BlockGasLimitExceededError

Overrides

BaseError.constructor

Defined in

packages/errors/src/ethereum/BlockGasLimitExceededError.js:61

Properties

_tag

_tag: "BlockGasLimitExceeded" = 'BlockGasLimitExceeded'

Same as name, used internally.

Overrides

BaseError._tag

Defined in

packages/errors/src/ethereum/BlockGasLimitExceededError.js:83


cause

cause: any

Inherited from

BaseError.cause

Defined in

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


code

code: number

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


meta

meta: undefined | object

Optional object containing additional information about the error.

Defined in

packages/errors/src/ethereum/BlockGasLimitExceededError.js:76


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: "BlockGasLimitExceeded" = 'BlockGasLimitExceeded'

The name of the error, used to discriminate errors.

Overrides

BaseError.name

Defined in

packages/errors/src/ethereum/BlockGasLimitExceededError.js:89


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


code

static code: number = -32006

Error code (-32006), a non-standard extension for this specific error.

Defined in

packages/errors/src/ethereum/BlockGasLimitExceededError.js:52


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