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

# Events

> Every event KeyPair can deliver, with its data payload

## Deposits

> [accordion] deposit.sighted
>
> A deposit was seen on-chain but hasn't reached the confirmation depth
> this asset requires yet. Informational — don't credit a balance on
> this alone.
>
> ```json theme={null}
> { "count": 1, "chain": "tron", "toHeight": 100 }
> ```

> [accordion] deposit.confirmed
>
> Reached the required confirmation depth and posted to the
> customer's account. Safe to treat as final for this asset's
> reorg risk.
>
> ```json theme={null}
> { "count": 1, "chain": "tron", "toHeight": 119 }
> ```

> [accordion] deposit.reorged
>
> A chain reorg dropped a block a deposit had confirmed under. Rare,
> and only fires for assets where this is possible at all — treat the
> affected balance as under review until you hear otherwise.
>
> ```json theme={null}
> { "count": 1, "chain": "tron" }
> ```

## Withdrawals

> [accordion] withdrawal.finalised
>
> The chain confirmed the payout. `providerRef` matches the
> `providerRef` your withdrawal call returned.
>
> ```json theme={null}
> { "providerRef": "0xabc…" }
> ```

> [accordion] withdrawal.failed
>
> The chain rejected it, or it could not be confirmed within policy —
> funds are returned to the source account. `reason` is
> human-readable, for your logs.
>
> ```json theme={null}
> { "providerRef": "0xabc…", "reason": "destination blocked" }
> ```

## Reconciliation

> [accordion] reconciliation.drift
>
> A scheduled reconciliation run found the ledger disagreeing with
> custody. Treat as an operational alert, not a customer-facing event
> — page someone.
>
> ```json theme={null}
> {
>   "status": "drift",
>   "findings": [
>     {
>       "code": "CUSTODY_SHORTFALL",
>       "severity": "critical",
>       "message": "custody holds 0 of USDT_TRON but customers are owed 249750000"
>     }
>   ]
> }
> ```


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