Skip to main content

​
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

FieldTypeDescription
data.error.codestringStandardized error code (e.g., WITHDRAWAL_ENRICHMENT_TIMEOUT)
data.error.messagestringHuman-readable error description
data.error.timestampstringISO 8601 timestamp of when the error occurred
data.context.transactionIdstring | undefinedRelated transaction, if applicable
data.context.walletIdstring | undefinedRelated wallet, if applicable
data.context.quoteIdstring | undefinedRelated quote, if applicable
data.context.exchangestring | undefinedRelated exchange, if applicable
data.context.assetstring | undefinedRelated asset, if applicable
data.context.networkstring | undefinedRelated 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.