Skip to content

Documentation / @etherfold/core / GenerationInstantiationError

Class: GenerationInstantiationError ​

Defined in: packages/core/src/receivingContainer.ts:498

A STORED GENERATION THAT COULD NOT BE MADE TO FOLD, so the pointer did NOT move onto it (ADR-0092).

Raised by a pointer move onto a generation this container holds no fold for, when the host's instantiateGeneration cannot turn the stored bundle into one: no bytes are stored for it, the loader refused them, the identity they hash to is not the one the generation is registered under, or the fold's factories threw.

ONLY BROKEN CODE is refused. A generation on a DIFFERENT stream than this container can name (a filter change's predecessor) is not: nothing here fetches its stream, so it is the freeze a filter change already is, and the pointer moves onto it with that said out loud (promote).

REFUSED rather than moved-and-reported, because the move is the one thing that can still be declined: moving the pointer onto a generation nothing folds would have a deployment serve a state frozen at a known point while it went on folding the one the operator rejected -- the inverted state ADR-0092 exists to remove. Declining leaves everything exactly as it was, and the operator reads why.

Extends ​

  • Error

Constructors ​

Constructor ​

new GenerationInstantiationError(id, why, options?): GenerationInstantiationError

Defined in: packages/core/src/receivingContainer.ts:501

Parameters ​

id ​

GenerationId

why ​

string

options? ​
cause? ​

unknown

Returns ​

GenerationInstantiationError

Overrides ​

Error.constructor

Properties ​

cause? ​

optional cause?: unknown

Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es2022.error.d.ts:24

Inherited from ​

Error.cause


id ​

readonly id: GenerationId

Defined in: packages/core/src/receivingContainer.ts:502


message ​

message: string

Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es5.d.ts:1075

Inherited from ​

Error.message


name ​

readonly name: "GenerationInstantiationError" = 'GenerationInstantiationError'

Defined in: packages/core/src/receivingContainer.ts:499

Overrides ​

Error.name


stack? ​

optional stack?: string

Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.es5.d.ts:1076

Inherited from ​

Error.stack


why ​

readonly why: string

Defined in: packages/core/src/receivingContainer.ts:503

Methods ​

isError() ​

static isError(error): error is Error

Defined in: node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/lib/lib.esnext.error.d.ts:21

Indicates whether the argument provided is a built-in Error instance or not.

Parameters ​

error ​

unknown

Returns ​

error is Error

Inherited from ​

Error.isError