Ethereum BUSD transfer notifications, delivered as webhooks

POST /webhooks/chainhook HTTP/1.1
Host: api.example.com
Content-Type: application/json
User-Agent: chainhook/1.x
X-Webhook-Id: 01a0fbfd-4fe4-7a3c-8f21-6b9d0e4c7a15
X-Webhook-Signature: 7a12d02673420517279805cf8188a1a62c6f69706161ba5cf0a8ec91ea66b8e3

{
  "id": "01a0fbfd-4fe4-7a3c-8f21-6b9d0e4c7a15",
  "event": "transfer.detected",
  "created_at": "2026-10-02T09:41:17Z",
  "webhook_id": "01a0fbf2-fadc-7c3e-9b1a-4d6f2e8a5c71",
  "data": {
    "network": "ethereum",
    "direction": "in",
    "type": "token",
    "transaction_hash": "0xdaf7068dc860066b2f74bd5cc1181cc2512681f580f2aec6171c0ef3dac503ec",
    "transfer_index": 57,
    "block_number": 26239201,
    "block_hash": "0xe9dcf5f9c1a0475f8ea1fb9a215efaebd0e0db95bb92ae120cf86a9008a8ba48",
    "block_timestamp": "2026-10-02T09:41:05Z",
    "confirmations": 12,
    "from": "0x5bf5a1da194ed738308ecbfcfa38f6e1dc50ace5",
    "to": "0x5b8ddac816baad6111c7c7b39c88355c00ba7ea1",
    "currency": "BUSD",
    "amount": "250",
    "amount_raw": "250000000000000000000",
    "decimals": 18,
    "contract_address": "0x4fabb145d64652a948d72533023f6e7a623c7c53"
  }
}

import crypto from 'node:crypto';
import express from 'express';

const app = express();

app.post(
  '/webhooks/chainhook',
  express.raw({ type: 'application/json' }),
  (req, res) => {
    const signature = req.get('X-Webhook-Signature') ?? '';
    const expected = crypto
      .createHmac('sha256', process.env.CHAINHOOK_SIGNING_SECRET)
      .update(req.body)
      .digest('hex');

    const valid =
      signature.length === expected.length &&
      crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));

    if (!valid) {
      return res.sendStatus(401);
    }

    const event = JSON.parse(req.body);
    // Skip event.id if you've already processed it.

    res.sendStatus(200);
  },
);