> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bluvo.dev/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>