Blockchain event detected

Edit online

A wallet-level blockchain event has been detected on chain, such as a deposit. This webhook is available only for Tier‑1 chains.

Webhook event

wallet.blockchainevent.detected

Body

Field	Type	Required
id	string	Yes
date	string (date-time)	Yes
kind	enum (string)	Yes
data	object	Yes
timestampSent	integer	Yes
deliveryAttempt	integer	Yes
retryOf	string	No

{
  "id": "<string>",
  "date": "2023-11-07T05:31:56Z",
  "kind": "wallet.blockchainevent.detected",
  "data": {
    "blockchainEvent": {
      "kind": "Erc20Transfer",
      "walletId": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
      "network": "Ethereum",
      "direction": "Out",
      "blockNumber": 19036906,
      "timestamp": "2024-01-18T23:03:59.000Z",
      "txHash": "0x8e88793607610a83798eb5ec6dde861f3e459c7e4a22e78b0d2e675b86d0d1e7",
      "index": "134",
      "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "from": "0xea09cf8a006493566f8a8fd3d0b32ebff5939d6a",
      "to": "0xc42754e6f79f15082613b2b4ebead83dcf8116b6",
      "value": "1000000",
      "decimals": 6,
      "fee": "1542993669053672",
      "metadata": {
        "asset": {
          "symbol": "USDC",
          "decimals": 6,
          "verified": true
        },
        "fee": {
          "symbol": "ETH",
          "decimals": 18,
          "verified": true
        }
      }
    },
    "wallet": {
      "id": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
      "network": "Ethereum",
      "address": "0x00e3495cf6af59008f22ffaf32d4c92ac33dac47",
      "name": "trading hot wallet",
      "signingKey": {
        "id": "key-6ece3-9l565-xxxxxxxxxxxxxxxx",
        "scheme": "ECDSA",
        "curve": "secp256k1",
        "publicKey": "e2375c8c9e87bfcd0be8f29d76c818cabacd51584f72cb2222d49a13b036d84d3d"
      },
      "status": "Active",
      "dateCreated": "2023-04-14T20:41:28.715Z",
      "custodial": true,
      "tags": []
    }
  },
  "timestampSent": 123,
  "deliveryAttempt": 2,
  "retryOf": "<string>"
}

Response

Respond with a 200 status code to acknowledge that the event was successfully received. If your endpoint returns any status other than 200, IBM Digital Asset Haven considers the delivery failed and retries the webhook later.