> ## Documentation Index
> Fetch the complete documentation index at: https://bluvo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# error.fatal

> Sent when an unrecoverable error occurs

## 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

```json Example payload theme={null}
{
  "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 |

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

<Info>
  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.
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.