Register a transaction for merkle proof delivery.
/watchRegisters a transaction ID (txid) for merkle proof monitoring.
When the merkle proof for the transaction becomes available (i.e. the
transaction is confirmed in a block), the service delivers the proof
to the supplied callbackUrl via HTTP POST.
Idempotency: Registering the same txid with the same
callbackUrl more than once is safe; subsequent registrations are
deduplicated by the store.
Validation errors: The service validates both the txid format
(must be a 64-character hex string) and the callbackUrl format
(must be a valid HTTP or HTTPS URL). Invalid input returns 400 with
a JSON error object.
Body application/json
Transaction ID of the Bitcoin transaction to monitor. Must be a 64-character lowercase or uppercase hexadecimal string.
HTTP or HTTPS URL that will receive the merkle proof when it becomes available. The service issues an HTTP POST to this URL with the proof payload.
Response
Registration accepted.
Indicates successful registration.
Human-readable confirmation message.
Validation failure. Possible error messages:
"txid is required""invalid txid format: must be a 64-character hex string""callbackUrl is required""invalid callbackUrl: must be a valid HTTP/HTTPS URL""invalid request body"
Human-readable description of the error.
Storage failure or other internal error.
Human-readable description of the error.