BSV blockchainBSV blockchain

ARC Merkle proof callback (inbound to overlay node)

POST/arc-ingest

ARC POSTs this to the URL specified in X-CallbackUrl when a submitted transaction has been mined and a Merkle path is available.

In the ts-stack overlay, the endpoint is /arc-ingest on the overlay node itself (see OverlayExpress.ts). The overlay node must register this URL with ARC at submission time via the X-CallbackUrl header.

The overlay node calls engine.handleNewMerkleProof(txid, merklePath, blockHeight) upon receiving this callback.

Header Parameters

Authorizationstring

Bearer token matching the X-CallbackToken value set at submission time. The overlay node verifies this token before processing.

Body application/json

txidstringrequired

Transaction ID of the mined transaction.

merklePathstringrequired

Hex-encoded Merkle path (BUMP format).

blockHeightintegerrequired

Block height at which the transaction was mined.

blockHashstring

Hash of the block containing this transaction (optional, not always present).

timestampstring<date-time>

Timestamp of the callback.

Response

Callback accepted and processed.

statusstring
messagestring

Bad request.

statusstring
messagestring
Request
curl -X POST "https://arc.taal.com/arc-ingest" \
  -H "Content-Type: application/json" \
  -H "Authorization: <Authorization>" \
  -d '{
  "txid": "string",
  "merklePath": "string",
  "blockHeight": 0,
  "blockHash": "string",
  "timestamp": "1970-01-01T00:00:00.000Z"
}'
Response
{
  "status": "string",
  "message": "string"
}