Events

Deposits

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.

{ "count": 1, "chain": "tron", "toHeight": 100 }

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.

{ "count": 1, "chain": "tron", "toHeight": 119 }

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.

{ "count": 1, "chain": "tron" }

Withdrawals

withdrawal.finalised

The chain confirmed the payout. providerRef matches the providerRef your withdrawal call returned.

{ "providerRef": "0xabc…" }

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.

{ "providerRef": "0xabc…", "reason": "destination blocked" }

Reconciliation

reconciliation.drift

A scheduled reconciliation run found the ledger disagreeing with custody. Treat as an operational alert, not a customer-facing event — page someone.

{
  "status": "drift",
  "findings": [
    {
      "code": "CUSTODY_SHORTFALL",
      "severity": "critical",
      "message": "custody holds 0 of USDT_TRON but customers are owed 249750000"
    }
  ]
}

Get started

Core concepts

Webhooks

Deposits

Withdrawals

Reconciliation