relayprotocol · pedromcunha · Sep 8, 2026 · Sep 8, 2026
diff --git a/.changeset/api-types-nullable-amounts.md b/.changeset/api-types-nullable-amounts.md
diff --git a/packages/hooks/CHANGELOG.md b/packages/hooks/CHANGELOG.md
@@ -1,5 +1,58 @@
 # @reservoir0x/relay-kit-hooks
 
+## 5.0.0
+
+### Major Changes
+
+- c7ba781: `paths` and `routes` now track the current Relay API. Three endpoints are gone, request
+  amount fields are nullable, and deposit addresses, fee sponsorship and route racing gained
+  new options.
+
+  **Breaking**
+
+  - `/execute/swap`, `/requests/{requestId}/signature` and `/requests/{requestId}/signature/v2`
+    are removed from `paths` and from the exported `routes` array. Quotes come from
+    `POST /quote/v2`. `SwapBreakdown` and `Execute['breakdown']` are unchanged — the SDK now
+    declares that shape directly instead of deriving it from `/execute/swap`.
+  - On `GET /requests/v2` and `GET /requests/v3`, amount-bearing fields are now `string | null`
+    rather than `string | undefined`: `appFees[]` / `paidAppFees[]` (`recipient`, `bps`,
+    `amount`, `amountUsd`, `amountUsdCurrent`), `data.fees.*` (`usd`, `amount`,
+    `amountFormatted`) and `data.route.*` currency amounts (`amount`, `amountFormatted`,
+    `amountUsd`, `minimumAmount`). This reaches `useRequests`, `queryRequests` and
+    `useDepositAddressStatus`. Passing one of these into a `string | undefined` slot no longer
+    compiles — use `?? undefined`, or widen the receiving type to accept `null`.
+  - `ChainVM` gains `'hederavm'`. An exhaustive `switch` over `ChainVM` with a `never`
+    fallthrough needs the new case.
+  - `GET /config/v2` no longer accepts `currency: "degen"` or `"usdh"`, and `GET /prices/rates`
+    no longer returns `DEGEN`. Remove references to those literals; `"ausd"` is now accepted.
+
+  **Added**
+
+  - `GET /deposit-addresses/v2` returns a deposit address with its `deposits` and `sweeps`
+    history, and `POST /deposit-addresses/{depositAddressId}/disable/v2` disables one.
+    `/quote` and `/quote/v2` responses now carry `requestId` and, on deposit-address steps,
+    `depositAddressId`.
+  - Quote request options: `subsidizationBps` (share of each sponsored fee component the
+    sponsor covers, applied before `maxSubsidizationAmount`), `indicativeQuote`,
+    `referencePrice`, `useRouteRacing` and `routeRacingMinUsdSize`. `subsidizationBps` is
+    echoed back in `feeSponsorship` on quotes and requests.
+  - `GET /requests/v3` accepts a `referrer` filter (requires `apiKey`) and returns `apiKeyName`
+    and `blockedAddresses` to the request's creator integrator. `GET /requests/v2` responses
+    carry a `deprecation` block with its sunset and successor.
+  - `MANUAL_REFUND_REQUIRED` joins `refundFailReason`; `GET /intents/status/v3` now reports
+    `failReason` and `refundFailReason`; `GET /withdrawals/status` returns `txHash`;
+    `hederavm` joins the chain VM types.
+
+  **Deprecated**
+
+  - The `strict` quote parameter is ignored by `/quote/v2`; deposit-address creation follows
+    the requested trade type.
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 4.0.4
 
 ### Patch Changes

diff --git a/packages/hooks/package.json b/packages/hooks/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@relayprotocol/relay-kit-hooks",
-  "version": "4.0.4",
+  "version": "5.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/relayprotocol/relay-kit.git",

diff --git a/packages/relay-bitcoin-wallet-adapter/CHANGELOG.md b/packages/relay-bitcoin-wallet-adapter/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @reservoir0x/relay-bitcoin-wallet-adapter
 
+## 21.0.0
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 20.0.3
 
 ### Patch Changes

diff --git a/packages/relay-bitcoin-wallet-adapter/package.json b/packages/relay-bitcoin-wallet-adapter/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@relayprotocol/relay-bitcoin-wallet-adapter",
-    "version": "20.0.3",
+    "version": "21.0.0",
     "description": "A Bitcoin adapter for use in @relayprotocol/relay-sdk",
     "type": "module",
     "source": "./src/index.ts",

diff --git a/packages/relay-ethers-wallet-adapter/CHANGELOG.md b/packages/relay-ethers-wallet-adapter/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @reservoir0x/relay-ethers-wallet-adapter
 
+## 33.0.0
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 32.0.3
 
 ### Patch Changes

diff --git a/packages/relay-ethers-wallet-adapter/package.json b/packages/relay-ethers-wallet-adapter/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@relayprotocol/relay-ethers-wallet-adapter",
-    "version": "32.0.3",
+    "version": "33.0.0",
     "description": "An adapter used to convert an ethersjs signer to an Adapted Wallet for use in the @relayprotocol/relay-sdk",
     "type": "module",
     "source": "./src/index.ts",

diff --git a/packages/relay-lighter-wallet-adapter/CHANGELOG.md b/packages/relay-lighter-wallet-adapter/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @relayprotocol/relay-lighter-wallet-adapter
 
+## 4.0.0
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 3.0.3
 
 ### Patch Changes

diff --git a/packages/relay-lighter-wallet-adapter/package.json b/packages/relay-lighter-wallet-adapter/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@relayprotocol/relay-lighter-wallet-adapter",
-    "version": "3.0.3",
+    "version": "4.0.0",
     "description": "A Lighter adapter for use in @relayprotocol/relay-sdk",
     "type": "module",
     "source": "./src/index.ts",

diff --git a/packages/relay-svm-wallet-adapter/CHANGELOG.md b/packages/relay-svm-wallet-adapter/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @reservoir0x/relay-svm-wallet-adapter
 
+## 22.0.0
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 21.0.4
 
 ### Patch Changes

diff --git a/packages/relay-svm-wallet-adapter/package.json b/packages/relay-svm-wallet-adapter/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@relayprotocol/relay-svm-wallet-adapter",
-    "version": "21.0.4",
+    "version": "22.0.0",
     "description": "An SVM (Solana Virtual Machine) adapter for use in @relayprotocol/relay-sdk",
     "type": "module",
     "source": "./src/index.ts",

diff --git a/packages/relay-ton-wallet-adapter/CHANGELOG.md b/packages/relay-ton-wallet-adapter/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @relayprotocol/relay-ton-wallet-adapter
 
+## 4.0.0
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 3.0.3
 
 ### Patch Changes

diff --git a/packages/relay-ton-wallet-adapter/package.json b/packages/relay-ton-wallet-adapter/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@relayprotocol/relay-ton-wallet-adapter",
-    "version": "3.0.3",
+    "version": "4.0.0",
     "description": "A TON wallet adapter for use in @relayprotocol/relay-sdk",
     "type": "module",
     "source": "./src/index.ts",

diff --git a/packages/relay-tron-wallet-adapter/CHANGELOG.md b/packages/relay-tron-wallet-adapter/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @relayprotocol/relay-tron-wallet-adapter
 
+## 10.0.0
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 9.0.3
 
 ### Patch Changes

diff --git a/packages/relay-tron-wallet-adapter/package.json b/packages/relay-tron-wallet-adapter/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@relayprotocol/relay-tron-wallet-adapter",
-    "version": "9.0.3",
+    "version": "10.0.0",
     "description": "A Tron adapter for use in @relayprotocol/relay-sdk",
     "type": "module",
     "source": "./src/index.ts",

diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md
@@ -1,5 +1,53 @@
 # @reservoir0x/relay-sdk
 
+## 8.0.0
+
+### Major Changes
+
+- c7ba781: `paths` and `routes` now track the current Relay API. Three endpoints are gone, request
+  amount fields are nullable, and deposit addresses, fee sponsorship and route racing gained
+  new options.
+
+  **Breaking**
+
+  - `/execute/swap`, `/requests/{requestId}/signature` and `/requests/{requestId}/signature/v2`
+    are removed from `paths` and from the exported `routes` array. Quotes come from
+    `POST /quote/v2`. `SwapBreakdown` and `Execute['breakdown']` are unchanged — the SDK now
+    declares that shape directly instead of deriving it from `/execute/swap`.
+  - On `GET /requests/v2` and `GET /requests/v3`, amount-bearing fields are now `string | null`
+    rather than `string | undefined`: `appFees[]` / `paidAppFees[]` (`recipient`, `bps`,
+    `amount`, `amountUsd`, `amountUsdCurrent`), `data.fees.*` (`usd`, `amount`,
+    `amountFormatted`) and `data.route.*` currency amounts (`amount`, `amountFormatted`,
+    `amountUsd`, `minimumAmount`). This reaches `useRequests`, `queryRequests` and
+    `useDepositAddressStatus`. Passing one of these into a `string | undefined` slot no longer
+    compiles — use `?? undefined`, or widen the receiving type to accept `null`.
+  - `ChainVM` gains `'hederavm'`. An exhaustive `switch` over `ChainVM` with a `never`
+    fallthrough needs the new case.
+  - `GET /config/v2` no longer accepts `currency: "degen"` or `"usdh"`, and `GET /prices/rates`
+    no longer returns `DEGEN`. Remove references to those literals; `"ausd"` is now accepted.
+
+  **Added**
+
+  - `GET /deposit-addresses/v2` returns a deposit address with its `deposits` and `sweeps`
+    history, and `POST /deposit-addresses/{depositAddressId}/disable/v2` disables one.
+    `/quote` and `/quote/v2` responses now carry `requestId` and, on deposit-address steps,
+    `depositAddressId`.
+  - Quote request options: `subsidizationBps` (share of each sponsored fee component the
+    sponsor covers, applied before `maxSubsidizationAmount`), `indicativeQuote`,
+    `referencePrice`, `useRouteRacing` and `routeRacingMinUsdSize`. `subsidizationBps` is
+    echoed back in `feeSponsorship` on quotes and requests.
+  - `GET /requests/v3` accepts a `referrer` filter (requires `apiKey`) and returns `apiKeyName`
+    and `blockedAddresses` to the request's creator integrator. `GET /requests/v2` responses
+    carry a `deprecation` block with its sunset and successor.
+  - `MANUAL_REFUND_REQUIRED` joins `refundFailReason`; `GET /intents/status/v3` now reports
+    `failReason` and `refundFailReason`; `GET /withdrawals/status` returns `txHash`;
+    `hederavm` joins the chain VM types.
+
+  **Deprecated**
+
+  - The `strict` quote parameter is ignored by `/quote/v2`; deposit-address creation follows
+    the requested trade type.
+
 ## 7.0.3
 
 ### Patch Changes

diff --git a/packages/sdk/package.json b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@relayprotocol/relay-sdk",
-  "version": "7.0.3",
+  "version": "8.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/relayprotocol/relay-kit.git",

diff --git a/packages/ui/CHANGELOG.md b/packages/ui/CHANGELOG.md
@@ -1,5 +1,59 @@
 # @reservoir0x/relay-kit-ui
 
+## 12.0.0
+
+### Major Changes
+
+- c7ba781: `paths` and `routes` now track the current Relay API. Three endpoints are gone, request
+  amount fields are nullable, and deposit addresses, fee sponsorship and route racing gained
+  new options.
+
+  **Breaking**
+
+  - `/execute/swap`, `/requests/{requestId}/signature` and `/requests/{requestId}/signature/v2`
+    are removed from `paths` and from the exported `routes` array. Quotes come from
+    `POST /quote/v2`. `SwapBreakdown` and `Execute['breakdown']` are unchanged — the SDK now
+    declares that shape directly instead of deriving it from `/execute/swap`.
+  - On `GET /requests/v2` and `GET /requests/v3`, amount-bearing fields are now `string | null`
+    rather than `string | undefined`: `appFees[]` / `paidAppFees[]` (`recipient`, `bps`,
+    `amount`, `amountUsd`, `amountUsdCurrent`), `data.fees.*` (`usd`, `amount`,
+    `amountFormatted`) and `data.route.*` currency amounts (`amount`, `amountFormatted`,
+    `amountUsd`, `minimumAmount`). This reaches `useRequests`, `queryRequests` and
+    `useDepositAddressStatus`. Passing one of these into a `string | undefined` slot no longer
+    compiles — use `?? undefined`, or widen the receiving type to accept `null`.
+  - `ChainVM` gains `'hederavm'`. An exhaustive `switch` over `ChainVM` with a `never`
+    fallthrough needs the new case.
+  - `GET /config/v2` no longer accepts `currency: "degen"` or `"usdh"`, and `GET /prices/rates`
+    no longer returns `DEGEN`. Remove references to those literals; `"ausd"` is now accepted.
+
+  **Added**
+
+  - `GET /deposit-addresses/v2` returns a deposit address with its `deposits` and `sweeps`
+    history, and `POST /deposit-addresses/{depositAddressId}/disable/v2` disables one.
+    `/quote` and `/quote/v2` responses now carry `requestId` and, on deposit-address steps,
+    `depositAddressId`.
+  - Quote request options: `subsidizationBps` (share of each sponsored fee component the
+    sponsor covers, applied before `maxSubsidizationAmount`), `indicativeQuote`,
+    `referencePrice`, `useRouteRacing` and `routeRacingMinUsdSize`. `subsidizationBps` is
+    echoed back in `feeSponsorship` on quotes and requests.
+  - `GET /requests/v3` accepts a `referrer` filter (requires `apiKey`) and returns `apiKeyName`
+    and `blockedAddresses` to the request's creator integrator. `GET /requests/v2` responses
+    carry a `deprecation` block with its sunset and successor.
+  - `MANUAL_REFUND_REQUIRED` joins `refundFailReason`; `GET /intents/status/v3` now reports
+    `failReason` and `refundFailReason`; `GET /withdrawals/status` returns `txHash`;
+    `hederavm` joins the chain VM types.
+
+  **Deprecated**
+
+  - The `strict` quote parameter is ignored by `/quote/v2`; deposit-address creation follows
+    the requested trade type.
+
+### Patch Changes
+
+- Updated dependencies [c7ba781]
+  - @relayprotocol/relay-kit-hooks@5.0.0
+  - @relayprotocol/relay-sdk@8.0.0
+
 ## 11.0.6
 
 ### Patch Changes

diff --git a/packages/ui/package.json b/packages/ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@relayprotocol/relay-kit-ui",
-  "version": "11.0.6",
+  "version": "12.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/relayprotocol/relay-kit.git",