DefensiveNullCheckError

Represents an error that occurs when a defensive null check is tripped. This error should never be thrown and indicates a bug in the Tevm VM if it is Thrown

Defensive null check errors can occur due to:

• Checking what should be an impossible null value, indicating a bug in TEVM.

To handle this error take the following steps:

• ensure you did not modify the tevm VM in any unsupported way.
• Open an issue with a minimal reproducable example

Example

import { DefensiveNullCheckError } from '@tevm/errors'
function assertNotNull<T>(value: T | null): T {
  const name = 'bob'
  const firstLetter = name[0]
  if (firstLetter === undefined) {
    throw new DefensiveNullCheckError('Null value encountered in assertNotNull')
  }
  return value
}

Param

A human-readable error message.

Param

Additional parameters for the BaseError.

Extends

• InternalError

Constructors

new DefensiveNullCheckError()

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

Constructs a DefensiveNullCheckError.

Parameters

• message?: string = 'Defensive null check error occurred.'

Human-readable error message.

• args?: DefensiveNullCheckErrorParameters = {}

Additional parameters for the BaseError.

• tag?: string = 'DefensiveNullCheckError'

The tag for the error.

Returns

DefensiveNullCheckError

Overrides

InternalError.constructor

Defined in

packages/errors/src/defensive/DefensiveNullCheckError.js:57

Properties

_tag

_tag: string

Same as name, used internally.

Inherited from

InternalError._tag

Defined in

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

---

cause

cause: any

Inherited from

InternalError.cause

Defined in

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

---

code

code: number

Error code, analogous to the code in JSON RPC error.

Inherited from

InternalError.code

Defined in

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

---

details

details: string

Inherited from

InternalError.details

Defined in

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

---

docsPath

docsPath: undefined | string

Path to the documentation for this error.

Inherited from

InternalError.docsPath

Defined in

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

---

message

message: string

Human-readable error message.

Inherited from

InternalError.message

Defined in

node_modules/.pnpm/typescript@5.5.2/node_modules/typescript/lib/lib.es5.d.ts:1077

---

meta

meta: undefined | object

Optional object containing additional information about the error.

Inherited from

InternalError.meta

Defined in

packages/errors/src/ethereum/InternalErrorError.js:64

---

metaMessages

metaMessages: undefined | string[]

Additional meta messages for more context.

Inherited from

InternalError.metaMessages

Defined in

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

---

name

name: string

The name of the error, used to discriminate errors.

Inherited from

InternalError.name

Defined in

node_modules/.pnpm/typescript@5.5.2/node_modules/typescript/lib/lib.es5.d.ts:1076

---

shortMessage

shortMessage: string

Inherited from

InternalError.shortMessage

Defined in

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

---

stack?

optional stack: string

Inherited from

InternalError.stack

Defined in

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

---

version

version: string

Inherited from

InternalError.version

Defined in

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

---

prepareStackTrace()?

static optional prepareStackTrace: (err, stackTraces) => any

Optional override for formatting stack traces

See

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Parameters

• err: Error

• stackTraces: CallSite[]

Returns

any

Inherited from

InternalError.prepareStackTrace

Defined in

node_modules/.pnpm/@types+node@20.14.8/node_modules/@types/node/globals.d.ts:28

---

stackTraceLimit

static stackTraceLimit: number

Inherited from

InternalError.stackTraceLimit

Defined in

node_modules/.pnpm/@types+node@20.14.8/node_modules/@types/node/globals.d.ts:30

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

InternalError.walk

Defined in

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

---

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

InternalError.captureStackTrace

Defined in

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

captureStackTrace(targetObject, constructorOpt)

static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

• targetObject: object

• constructorOpt?: Function

Returns

void

Inherited from

InternalError.captureStackTrace

Defined in

node_modules/.pnpm/@types+node@22.1.0/node_modules/@types/node/globals.d.ts:22

captureStackTrace(targetObject, constructorOpt)

static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

• targetObject: object

• constructorOpt?: Function

Returns

void

Inherited from

InternalError.captureStackTrace

Defined in

node_modules/.pnpm/bun-types@1.1.18/node_modules/bun-types/globals.d.ts:1613

captureStackTrace(targetObject, constructorOpt)

static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

• targetObject: object

• constructorOpt?: Function

Returns

void

Inherited from

InternalError.captureStackTrace

Defined in

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