diff --git a/features/deposit-addresses.mdx b/features/deposit-addresses.mdx index f3429cd..3bbdce9 100644 --- a/features/deposit-addresses.mdx +++ b/features/deposit-addresses.mdx @@ -960,6 +960,7 @@ curl -X GET "https://api.relay.link/requests/v2?depositAddress= "address": "0xb353e49aa47514fb579d6ba6594c768379a96515", "depositAddressType": "open", "depositor": "0xb353e49aa47514fb579d6ba6594c768379a96515", + "depositTxHash": "0x41ce037184d661c35f102c961c88f587d137c611bf928389a562ff139ad51d4b", }, "data": { "slippageTolerance": "50", diff --git a/references/api/api_guides/webhooks.mdx b/references/api/api_guides/webhooks.mdx index afa2f01..f0c50bd 100644 --- a/references/api/api_guides/webhooks.mdx +++ b/references/api/api_guides/webhooks.mdx @@ -51,6 +51,7 @@ Relay Webhooks specifically stream transaction statuses for both cross and same- "address": "0x..", "depositAddressType": "open", // open / strict "depositor": "0x..", //nullable + "depositTxHash": "0x..", //nullable — origin-chain tx hash of the depositor's transfer into the deposit address }, //nullable "requestId": "0x...", "details": null, diff --git a/references/api/changelog.mdx b/references/api/changelog.mdx index f88f5f6..d7f5923 100644 --- a/references/api/changelog.mdx +++ b/references/api/changelog.mdx @@ -3,6 +3,10 @@ title: "API Changelog" description: "Record of breaking changes, deprecations, and notable additions to the Relay API" --- +## 2026-05-27 — `depositAddress` payloads add `depositTxHash` + +**Added** — `GET /requests/v2` and the `request.status.updated` webhook/websocket event: the `depositAddress` object now includes `depositTxHash`, the origin-chain transaction hash of the depositor's transfer into the deposit address. This is distinct from `inTxHashes`, which tracks the sweep from the deposit address to the Relay depository. The field is `null` until the depositor's transfer is observed, and is omitted on non-deposit-address requests (where `depositAddress` itself is `null`). + ## 2026-05-26 — Webhook payload adds `details`, `failReason`, `refundFailReason` **Added** — `request.status.updated` webhook: the `data` object now includes `details`, `failReason`, and `refundFailReason`, matching the corresponding fields on [`GET /intents/status/v3`](/references/api/get-intents-status-v3). `failReason` returns `"N/A"` on non-failure statuses and the recorded reason (or `"UNKNOWN"`) on `failure`/`fallback`/`refund` statuses. `refundFailReason` defaults to `"N/A"` when no refund-leg failure is recorded. `details` is `null` when no additional context is available.