error.fatal

Fired when Bluvo encounters an unrecoverable error during an operation. This is a rare event that requires attention — it indicates something failed beyond automatic retry capabilities.

When this event is sent

On-chain transaction verification times out after monitoring multiple blocks
An internal system failure prevents completion of a critical operation

Payload

Example payload

{
  "event": "error.fatal",
  "eventId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2026-04-21T12:00:00.000Z",
  "data": {
    "error": {
      "code": "WITHDRAWAL_ENRICHMENT_TIMEOUT",
      "message": "On-chain verification timed out after 14 blocks",
      "timestamp": "2026-04-21T12:00:00.000Z"
    },
    "context": {
      "transactionId": "txn_ghi789",
      "walletId": "wal_abc123",
      "quoteId": "quot_def456",
      "exchange": "coinbase",
      "asset": "BTC",
      "network": "Bitcoin"
    }
  }
}

Fields

Field	Type	Description
`data.error.code`	`string`	Standardized error code (e.g., `WITHDRAWAL_ENRICHMENT_TIMEOUT`)
`data.error.message`	`string`	Human-readable error description
`data.error.timestamp`	`string`	ISO 8601 timestamp of when the error occurred
`data.context.transactionId`	`string \| undefined`	Related transaction, if applicable
`data.context.walletId`	`string \| undefined`	Related wallet, if applicable
`data.context.quoteId`	`string \| undefined`	Related quote, if applicable
`data.context.exchange`	`string \| undefined`	Related exchange, if applicable
`data.context.asset`	`string \| undefined`	Related asset, if applicable
`data.context.network`	`string \| undefined`	Related network, if applicable

This event signals an unrecoverable failure. You should alert your operations team when receiving error.fatal events and investigate manually.

The most common cause is WITHDRAWAL_ENRICHMENT_TIMEOUT — the exchange processed the withdrawal, but on-chain confirmation was not detected within the monitoring window. The withdrawal may still complete; check the exchange and blockchain explorer directly.

Overview

Events

error.fatal

error.fatal

When this event is sent

Payload

Fields

​error.fatal

​When this event is sent

​Payload

​Fields

error.fatal

When this event is sent

Payload

Fields