Appearance

Documentation / @etherfold/core / IngestionRefusedError

Class: IngestionRefusedError ​

Defined in: packages/core/src/errors.ts:757

A refusal from the receiver that no re-send will fix.

The counterpart of UnexpectedFromBlockError, and the distinction is the whole of a sender's retry policy. A cursor refusal is RESUMABLE: it carries the block to re-send from and recovery is automatic. Everything else -- a foreign {source, config}, a malformed envelope, a payload that is not the range it claims, a bad token, a server hosting no processor -- is a MISCONFIGURATION. Retrying it changes nothing, and retrying it forever is the failure mode this type exists to make impossible to write by accident.

It carries the transport's own status so an operator sees which wall was hit, and never the credential that was presented.

Extends ​

  • Error

Constructors ​

Constructor ​

new IngestionRefusedError(status, code, message): IngestionRefusedError

Defined in: packages/core/src/errors.ts:762

Parameters ​

status ​

number

The transport's status, e.g. an HTTP 400, 401 or 501.

code ​

string

The receiver's own error code, e.g. context-mismatch, invalid-batch, unauthorized.

message ​

string

Returns ​

IngestionRefusedError

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

code ​

readonly code: string

Defined in: packages/core/src/errors.ts:766

The receiver's own error code, e.g. context-mismatch, invalid-batch, unauthorized.

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

Defined in: packages/core/src/errors.ts:758

Overrides ​

Error.name

retryable ​

readonly retryable: false = false

Defined in: packages/core/src/errors.ts:760

The whole point of the type: no block number, and no amount of waiting, makes this right.

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

status ​

readonly status: number

Defined in: packages/core/src/errors.ts:764

The transport's status, e.g. an HTTP 400, 401 or 501.

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