SDKUI Kit
API
API
Behavior changePOST /quote,POST /quote/v2, andPOST /price: same-chain Solana quotes now reject at quote time when the compiled deposit transaction would exceed 1232 bytes, matching the existing behavior for Solana-origin cross-chain quotes (see the 2026-05-29 entry). Previously same-chain oversized quotes returned200with steps the wallet could not serialize.POST /quote,POST /quote/v2, andPOST /price: the Solana deposit-transaction size gate now enforces the raw 1232-byte wire limit. Quotes between 1173 and 1232 bytes — valid on the wire as returned — are now accepted, and the previously reserved 60-byte compute-budget headroom is advisory. Clients that prepend compute-budget instructions at send time are responsible for checking their remaining room against the returned steps. This reverses the 2026-07-09 change that had cut the effective quote-time limit to 1172 bytes.
POST /quote,POST /quote/v2, andPOST /price: the responseerrorCodeenum gainsSOLANA_TX_TOO_LARGE, returned with400when the compiled Solana deposit transaction would exceed Solana’s 1232-byte wire limit and cannot be signed or broadcast. The responsemessagereports the measured transaction size and how many bytes it lands over, so clients can see how far over the quote is without recompiling the message themselves. See Handling Quote Errors and Solana Support.
API
API
AddedGET /intents/status/v3: the response now includesfailReasonandrefundFailReason, matching the fields already returned onGET /requests/v3and therequest.status.updatedwebhook / websocket event.failReasonreturns"N/A"on non-failure statuses and the recorded reason (or"UNKNOWN") onfailure,fallback, andrefundstatuses.refundFailReasondefaults to"N/A"when no refund-leg failure is recorded. Integrators polling status can now read these values directly without a follow-up call toGET /requests/v3. See Handling Execution Errors for the full enum.GET /intents/status/v3,GET /requests/v3, and therequest.status.updatedwebhook: therefundFailReasonenum gainsMANUAL_REFUND_REQUIRED, returned when the refund leg could not be automatically executed and requires manual intervention (for example, when the origin funds cannot be programmatically returned to the depositor).
API
API
AddedGET /requests/v3: the responsedataobject now includesapiKeyName, the display name of the API key that created the request. It is returned only when the caller authenticates with an API key belonging to the request’s owning integrator and passesincludeAuthenticatedData=true— the same gate asdata.referreranddata.platformFee.nullwhen the owning API key has no name set. See the migration guide.
APISDKUI Kit
API
Behavior changeGET /requests/v2:429responses now return a route-specific body —message,successor,migrationGuide— distinct from the generic rate-limit body used by every other endpoint. NoRetry-Afterheader or field is emitted. Migrate toGET /requests/v3— see the sunset timeline.
GET /requests/v3: thefiltersAND/OR parameter now acceptsnullas a null-check operator on any recognised key.{"depositAddress": null}matches requests where the field is empty (does not exist);{"not:depositAddress": null}matches requests where the field is present. Null-checks work across identity, address, chain, currency, and status-style fields, including the compositeuserfilter and the case-insensitivecurrencyInSymbol/currencyOutSymbolfields. Arrays that mixnullwith real values for the same key return400. See the migration guide.GET /requests/v2: every response now carriesDeprecation,Sunset, andLinkheaders pointing toGET /requests/v3and the migration guide, on2xx,4xx, and5xxalike. TheDeprecationheader is a structured-field Date (@<unix-seconds>),Sunsetis an RFC 7231 HTTP-date, andLinkincludes three relations —deprecation,sunset, andsuccessor-version. The three headers are also listed in the API’sAccess-Control-Expose-Headers, so browser clients usingfetchorXMLHttpRequestcan read them cross-origin.GET /requests/v2: the200response body gains a top-leveldeprecationobject withmessage,deprecatedAt,throttledFrom,sunsetAt,successor, andmigrationGuide, mirroring the header timeline for clients that read the body rather than headers.
RelayKit
SDK7.0.1 — Patch- Sync SDK types (
fb843c4)
11.0.2 — Patch- Add Robinhood Chain, Linea, Monad, Soneium, MegaETH, and Tempo to Uniswap Wallet’s supported chains (
78bf766)
APIUI Kit
API
AddedGET /requests/v3: the new opt-inincludeTotalboolean query parameter (defaults tofalse) returns an exacttotalfield on the response with the count of requests matching the current filters, independent oflimitandcontinuation. The count reflects all matches across the full data window, not just the returned page. Because computing the exact count adds meaningful query latency, keepincludeTotaloff on the hot list-fetch path and enable it only when the total is needed (e.g. rendering a “X of Y results” header). Pagination behavior is unchanged.
RelayKit
UI Kit11.0.1 — Patch- Normalize Uniswap Wallet connector name so its chain restrictions apply (
4ed6905)
API
API
Behavior changeGET /requests/v3: for requests where an origin deposit was observed on-chain but no fill was ever attempted (for example, a double-spent Bitcoin deposit that fails before solve),data.route.actual.origin.inputCurrencynow reflects the actual deposited amount and currency instead of mirroringdata.route.quoted.origin.inputCurrency.data.route.actual.origin.outputCurrencyisnullin this case — no fill occurred, so no output currency was observed — anddata.route.actual.destinationcontinues to fall back todata.route.quoted.destination. Previously the entiredata.route.actualobject silently mirroreddata.route.quotedon these rows, hiding the real deposit amount from integrators reading the actual-side fields. Requests that reached a fill attempt are unaffected.GET /requests/v3: for TON-origin requests,data.inTxs[].txHashis now the bare 64-character hex transaction hash, suitable for opening on Tonviewer at/transaction/{TX_HASH}. Previously this field returned an internal composite identifier that had to be parsed before it could be linked to an explorer. Non-TON origins anddata.outTxs[]are unaffected. This mirrors the fix previously shipped forGET /requests/v2on 2026-06-19.
APIUI Kit
API
Behavior changePOST /quote,POST /quote/v2, andPOST /price: transient failures that previously collapsed into a generic500witherrorCode: "UNKNOWN_ERROR"are now classified. Transient infrastructure failures (including raw transport timeouts) return503witherrorCode: "SERVICE_UNAVAILABLE", transient price-feed failures return503witherrorCode: "PRICE_FETCH_FAILED", and quote requests for token pairs that cannot be priced return400witherrorCode: "UNSUPPORTED_CURRENCY". Only genuinely unclassified failures still return500 UNKNOWN_ERROR. Both503codes are retryable — see Handling Quote Errors.
POST /quote,POST /quote/v2, andPOST /price: the responseerrorCodeenum gainsSERVICE_UNAVAILABLEandPRICE_FETCH_FAILEDfor transient upstream failures where the request should be retried.GET /requests/v3: the elevated per-key rate limit is now 20 requests per second, up from the previously shared 10 rps bucket.GET /requestsandGET /requests/v2continue at 10 rps. Default (non-elevated) limits are unchanged. See Elevated Rate Limits.
RelayKit
UI Kit11.0.0 — Major-
Migrate wallet balance fetching from Dune (sunset) to Codex (
e426f05) Breaking changes:duneConfigprovider option removed — usecodexConfig({ apiBaseUrl?, apiKey? }). The default api base url ishttps://graph.codex.io; override it to proxy requests and protect your api key.useDuneBalanceshook removed — useuseCodexBalances(address, queryOptions). The mainnet/testnet parameter is gone; balances are fetched from Codex-supported networks and filtered by your configured chains.isDuneBalanceremoved fromuseCurrencyBalance’s return value.useMultiWalletBalancesno longer takes the mainnet/testnet parameter.
- New
useSolanaBalancehook: selected SVM tokens (Solana and Eclipse) now fetch balances directly from the chain’s RPC (native viagetBalance, SPL viagetTokenAccountsByOwner) instead of an indexer, so post-swap balances are fresh and the aggressive periodic refetch workaround is gone. The internal eclipse-only balance hook is gone; Eclipse flows through the same path. - Native SVM balances (SOL, Eclipse ETH) in the consolidated token selector list are fetched from their RPCs and merged with Codex results, since Codex does not index native SVM balances (nor Eclipse at all). Their USD values come from Codex prices for wrapped SOL / mainnet WETH.
- Spam filtering: Codex’s
removeScamsplus anisScamdrop, and a liquidity heuristic replacing Dune’s spam scoring — tokens whose pool liquidity is under $1k or below the balance’s usd value have their usd value stripped so they can’t crowd out real holdings in the token selector (balances still display). - Known loss: Soon balances are gone from the token selector list; Soon is no longer a supported chain.
11.0.0 — Patch- Restrict Robinhood Wallet to its supported chains (
d8c713c)
API
API
Behavior changeGET /requests/v3,GET /intents/status/v3, and therequest.status.updatedwebhook: gasless/executefailure rows that previously returnedfailReason: "UNKNOWN"when a broadcast succeeded but the transaction was never included, or when the transaction was never accepted for broadcast, now return one of the two new reasons.
GET /requests/v3,GET /intents/status/v3, and therequest.status.updatedwebhook: the responsefailReasonenum gainsTRANSACTION_SUBMISSION_FAILED, returned when the fill transaction could not be broadcast to the network (RPC unavailable, signer unavailable, or pre-broadcast rejection — no transaction hash exists), andTRANSACTION_NOT_INCLUDED, returned when the fill transaction was broadcast but never included onchain before Relay’s retry and gas-bump window elapsed. See Handling Execution Errors for the full enum.
UI KitHooks
RelayKit
UI Kit10.0.1 — Patch- Complete the RefundReason error mapping. Every failReason code in the API schema now resolves to a specific user-facing explanation instead of falling back to the generic unknown-issue message, matching the copy used on relay.link and the developer dashboard. (
f1a9fd8)
10.0.1 — Patch- Gracefully handle broken token/chain logo images. ChainTokenIcon now falls back to the token symbol avatar and ChainIcon hides itself when the logo fails to load, instead of rendering a broken-image placeholder. (
628ad74)
10.0.1, Hooks 4.0.1 — Patch- fix: block token contract addresses in recipient field (
23e4ecf)
API
API
DeprecatedGET /requests/v2is deprecated as of today. It keeps working for now, but its rate limit will be progressively reduced each month until it is fully retired on November 24, 2026. Migrate to v3 before then — see the sunset timeline.
POST /quoteandPOST /quote/v2: when a blocklisted wallet recipient reaches destination simulation and the token contract rejects the transfer, the responseerrorCodeis stillDESTINATION_TX_FAILEDbut themessageis nowRecipient cannot receive this token (blocked by the token contract). Try a different recipient address.instead of the genericDestination transaction failed. Error classification is unchanged.
POST /quoteandPOST /quote/v2: an explicitly providedrecipientis now validated before quoting. Recipients that fail address validation for the destination chain return400witherrorCode: "INVALID_ADDRESS". Recipients that resolve to a supported token contract (which cannot receive tokens — e.g. passing the destination-chain USDC contract asrecipient) return400with the newerrorCode: "INVALID_RECIPIENT". Requests that omitrecipientare unaffected — the implicitrecipient = userpath is not revalidated. Previously these requests surfaced asDESTINATION_TX_FAILEDafter simulation. See Handling Quote Errors.GET /requests/v3: the recommended Requests API. It requiresx-api-key, adds a broad filter/search/sort surface, and returns a cleaner, consolidated response. See the migration guide.
SDKUI KitHooks
RelayKit
SDK7.0.0, UI Kit 10.0.0, Hooks 4.0.0 — Major-
Migrate the Requests API from v2 to v3 (breaking). (
07dda45)useRequests/queryRequestsanduseDepositAddressStatusnow callGET /requests/v3and return the v3 response shape.GET /requests/v3requires a Relay API key (x-api-key). Since these hooks run client-side, the key is not sent from Relay Kit — you must pointbaseApiUrlat a proxy that injectsx-api-keyserver-side. This is now required to use the UI kit. See the package README.- Response shape changes handled across the SDK/hooks/UI:
inTxs[].hash/outTxs[].hash→txHash;data.metadata.currencyIn/currencyOut/currencyGasTopupremoved — currencies for display are now derived fromdata.route(origininputCurrency/ destinationoutputCurrency, withactual→quotedand same-chain fallbacks);failReason/refundFailReasonarenullinstead of"N/A"; newsubmittedstatus. hashrequest filter removed; lookups by transaction hash now use the unifiedtermsearch.RelayKitProvidernow warns (client-side) whenbaseApiUrlpoints directly at the Relay API instead of a proxy: aconsole.errorif anapiKeyis also set (it would be exposed in the browser), otherwise aconsole.warnthat/requests/v3will fail without a proxy. Suppress withacknowledgeApiKeyExposure: true.- Removed the
secureBaseUrloption fromRelayKitProviderand theuseSecureBaseUrlprop fromSwapWidget. All Relay API traffic now flows through the singlebaseApiUrl, which must be a proxy — the proxy is responsible for any gas-sponsorship logic (and injectingx-api-key) server-side.
10.0.0 — Patch- fix: update wallet rejection errors in swap widget (
b4a3f7c)
UI Kit
API
API
Behavior changePOST /quote/v2: the Solana deposit-transaction size check on cross-chain Solana-origin quotes now reserves 60 bytes of headroom for the compute-budget instructions wallets and SDKs prepend at send time, so quotes are rejected when the compiled deposit transaction would exceed 1172 bytes (1232 minus 60). Previously the check ran at the raw 1232-byte limit and could return200with calldata that no longer fit once the client added its compute-budget instructions. The400response body now names the effective limit and the reserved-bytes reason. Continue to usemaxRouteLengthorincludedOriginSwapSourcesto keep transactions under the limit — see Solana Support.
SDKUI KitHooksAdapters
RelayKit
SDK6.1.3, UI Kit 9.1.3, Hooks 3.0.24, Bitcoin adapter 19.0.3, Ethers adapter 31.0.3, Lighter adapter 2.0.3, SVM adapter 20.0.3, TON adapter 2.0.3, Tron adapter 8.0.3 — Patch- Embed sourcesContent in published sourcemaps so they resolve without the unpublished src directory (
0020895)
9.1.3 — Patch- Hide non-deposit-address chains (incl. TON) from origin selector unless VM has wallet support (
4ac9782)
API
API
BreakingPOST /quoteandPOST /quote/v2: the opt-in request flagincludeProtocolSignatureis renamed toincludeProtocolData. The previous name is no longer honored. Integrators that were passingincludeProtocolSignature: trueto receiveprotocol.v2.orderSignaturemust switch toincludeProtocolData: true. Setting this opt-in may increase quote response latency.
POST /quoteandPOST /quote/v2: when the quote is settled through the Relay settlement protocol, the response’sprotocol.v2block now includeshubType(currently always"onchain") alongsideorderId. WithincludeProtocolData: true,protocol.v2.orderSignature— the solver’s ECDSA signature overorderId— is also returned, so integrators can validate an onchainorderIdagainst the quoted intent usingecrecoverwithout a follow-up API call.
SDK
SDKUI KitAdapters
RelayKit
SDK6.1.0, UI Kit 9.1.0, TON adapter 2.0.0 — Minor- Add TON support: new
@relayprotocol/relay-ton-wallet-adapterpackage exportingadaptTonWallet, plustonvmsupport across the SDK (vmType, TON receipt, transaction step messages, dead address) and UI kit (native TON balance, token selector). (4711f4b)
SDK
SDKUI KitAdapters
RelayKit
SDK6.0.0, UI Kit 9.0.0 — Major- Remove Sui support (
4149ded)
6.0.0, UI Kit 9.0.0, Tron adapter 7.0.0 — Patch- Fix native TRX handling on Tron: forward call_value on the deposit transaction (was sending 0 TRX) and fix the native-TRX sentinel address (the wrong sentinel made native TRX fall through to a failing balanceOf call). (
b61e540)
API
API
BreakingPOST /quote,POST /quote/v2, andPOST /price:slippageToleranceandlatePaymentSlippageToleranceare now validated as integer strings in the range0–10000basis points. Values outside that range — including negative integers and values greater than10000— return400witherrorCode: "INVALID_SLIPPAGE_TOLERANCE". Previously, negative values were accepted at quote time and produced refund outcomes downstream, and values above10000were accepted, effectively removing the minimum-output floor. Non-integer strings onPOST /pricepreviously returned500; they now return400with the sameINVALID_SLIPPAGE_TOLERANCEcode as the other endpoints. See Handling Quote Errors.
API
API
Behavior changeGET /requests/v2: for TON-origin requests,data.inTxs[].hashis now the bare 64-character hex transaction hash, suitable for opening on Tonviewer at/transaction/{TX_HASH}. Previously this field returned an internal composite identifier that had to be parsed before it could be linked to an explorer. Non-TON origins anddata.outTxs[]are unaffected.
GET /chains: the TON entry now exposesexplorerPaths.transactionas/transaction/{TX_HASH}, so clients building explorer URLs can read the canonical Tonviewer path from the API rather than hardcoding/tx/{TX_HASH}.
SDKUI Kit
API
API
Behavior changeGET /requests/v2: when a deposit is detected as reorged out or canonically failed on Base, the matching entry indata.inTxs[]now reportsstatus: "failure". Previously the top-level requeststatuscould flip to"failure"while the correspondingdata.inTxs[].statusremained"success", leaving integrators that key their deposit UI offdata.inTxs[0].statusshowing a succeeded deposit. Historical rows are not backfilled; the new behavior applies to detections going forward.
GET /requests/v2: faileddata.inTxs[]entries can now include ametadata.reorgobject with detection context. Fields:detectedAt(unix millis),source(detector component),reason(short code), and optionaldetails,failReason,action("fill"or"refund"),blockNumber,blockHash,receiptStatus. The object is only populated when the failure was caught by the reorg/finality path; deposits that fail through other paths are unaffected.
API
API
Behavior changePOST /quote/v2: quote attempts that fail because of a transient upstream RPC error now returnerrorCode: "REQUEST_TIMED_OUT"on timeout orerrorCode: "RPC_HTTP_ERROR"for other transient RPC failures. Previously these were misclassified aserrorCode: "DESTINATION_TX_FAILED", which suggested an on-chain revert and was treated as non-retryable.DESTINATION_TX_FAILEDis now returned only for genuine destination reverts. Both new codes are retryable — see Handling Quote Errors.
API
API
BreakingPOST /quote/v2: Solana-origin quotes routed through a third-party aggregator now return400when the generated deposit transaction would exceed Solana’s 1232-byte limit. Previously these requests returned200with calldata that could not be serialized or executed client-side. UsemaxRouteLengthorincludedOriginSwapSourcesto keep transactions under the limit — see Solana Support.
API
API
Behavior changeGET /intents/status/v3and therequest.status.updatedwebhook/websocket event: requests with a Bitcoin origin deposit now transition topendingas soon as the deposit is observed in the Bitcoin mempool, instead of waiting for the first block confirmation. Thependingstatus no longer implies block inclusion for Bitcoin origins; block-confirmation policy continues to govern when the request progresses tosubmitted,success,failure, orrefund. EVM and other non-Bitcoin origins are unchanged.
API
API
AddedGET /requests/v2and therequest.status.updatedwebhook/websocket event: thedepositAddressobject now includesdepositTxHash, the origin-chain transaction hash of the depositor’s transfer into the deposit address. This is distinct frominTxHashes, which tracks the sweep from the deposit address to the Relay depository. The field isnulluntil the depositor’s transfer is observed, and is omitted on non-deposit-address requests (wheredepositAddressitself isnull).
APIUI Kit
API
Addedrequest.status.updatedwebhook: thedataobject now includesdetails,failReason, andrefundFailReason, matching the corresponding fields onGET /intents/status/v3.failReasonreturns"N/A"on non-failure statuses and the recorded reason (or"UNKNOWN") onfailure/fallback/refundstatuses.refundFailReasondefaults to"N/A"when no refund-leg failure is recorded.detailsisnullwhen no additional context is available.
RelayKit
UI Kit8.0.10 — Patch- Update CEX address url (
4d73aeb)
API
API
Breaking-
POST /authorize(Hyperliquid nonce-mapping flow): the EIP-712RelayNonceMappingdomainversionis bumped from"1"to"2", and theNonceMappingtyped-data struct gains a newdepositor(address) field. The/authorizerequest body must include a matchingdepositorfield. Integrators that pass the API-returnedsignpayload straight to their wallet (and POSTpost.bodyverbatim) require no code change. Integrators that hand-roll the authorize step must sign the new typed-data shape and forwarddepositorfromsteps[0].items[0].data.sign.value.depositor. See Hyperliquid Support for the updated payload shapes.
API
API
Behavior changePOST /execute: raw-call simulation failures now return a decodederrorlabel,message,requestId, and optionaldetailsobject when Relay can decode the revert trace. Thedetailsobject includes the top-level frame, innermost reverting frame, full reverting path, and decoded revert data for both subsidized and non-subsidized gasless execution flows.
API
API
Behavior changeGET /intents/status/v3: failure rows that previously returnedfailReason: "UNKNOWN"now return a specific reason where one is available. Failed same-chain swap attempts returnTRANSACTION_REVERTED, and refund rows triggered by duplicate deposits against the same request returnDOUBLE_SPEND. No new enum members were introduced for these two cases.
GET /intents/status/v3: the responsefailReasonenum gainsTRANSACTION_TOO_LARGE, returned when the serialized fill transaction exceeded the origin chain or RPC payload size limit. The enum also gainsSOLVER_BALANCE_TOO_LOW, returned when the solver could not construct or send the fill because its source-side balance (or available UTXOs) was insufficient.
SDKUI Kit
APISDKUI Kit
API
Behavior changePOST /quote/v2withuseDepositAddress: trueandstrict: true: a deposit larger than the quotedamountnow fills the quoted amount and refunds the excess torefundToin a separate refund leg, instead of scaling the fill up to the deposited amount. Exact payments still fill normally and underpayments still fail and refund.refundToremains required for strict deposit addresses.
RelayKit
SDK5.2.6 — Patch- Sync api types (
a443358)
8.0.8 — Patch- Differentiate hyperliquid usdc pills (
22aa1f9)
APISDKUI Kit
API
BreakingPOST /quote/v2: same-chain swap requests whose quoted USD value is greater than0and less than$0.05now return400witherrorCode: "AMOUNT_TOO_LOW". Previously these requests returned200with calldata that reverted on-chain. Wrap and unwrap quotes (e.g. same-chainETH↔WETH) and quotes that include attached calls continue to be accepted at any size.
RelayKit
SDK5.2.5 — Patch- Sync api types (
ef54ef1)
8.0.7 — Patch- Fix gap in token selector’s suggested tokens (
31cd7b4)
SDKAdapters
SDK
RelayKit
SDK5.2.3 — Patch- Support atomic batching for zero-reset approval swap flows (e.g. USDT on Ethereum).
canBatchTransactionsandprepareBatchTransactionnow accept any number of leadingapprovesteps before the terminalswap/deposit, so wallets that support EIP-5792 collapse theapprove(0) → approve(amount) → swapsequence into a singlewallet_sendCallsinstead of three separate prompts. (eeb4695)
SDKUI KitHooks
RelayKit
SDK5.2.2, UI Kit 8.0.4, Hooks 3.0.12 — Patch- Sync api types and add depositing step to deposit address status (
8d8aa50)
8.0.4 — Patch- Use spotClearinghouseState for Spot USDC and unified Hyperliquid accounts. Adds a new useHyperliquidAccountMode hook to detect the user’s account abstraction mode, and routes balance queries through spotClearinghouseState for unified/portfolio-margin accounts where the Perps USDC balance is reported under spot. (
38dabc0)
UI Kit
UI Kit
RelayKit
UI Kit8.0.2 — Patch- Fix CSS layer scoping and priority for host app compatibility (
26b2fc7)
8.0.1 — Patch- Fix CSS being tree-shaken in production builds by declaring styles.css as (
887f0e0)
8.0.0 — Major- Migrate styling system from Panda CSS to Tailwind CSS (
4c6d8d2)
8.0.0 — Patch- Optimize Font Awesome imports to use individual icon paths (
0e44e49)
HooksAdapters
SDKUI KitHooks
SDKUI Kit
UI KitAdapters
SDKUI Kit
RelayKit
SDK5.1.1, UI Kit 7.1.2 — Patch- Refactor token selector currency metadata fetching (
f851b3c)
7.1.2 — Patch- Implement AGW logic when hyperliquid is selected as destination (
00cad1c)
7.1.2 — Patch- Add same chain selector (
8aa2bca)
7.1.2 — Patch- Universal max amount buffering (
c7da389)
UI KitHooks
SDKUI Kit
SDKUI Kit
SDKUI KitHooks
RelayKit
SDK5.0.0 — Major- Move configureViemChain, configureDynamicChains, and fetchChainConfigs to new /chain-utils subpath to reduce bundle size (
7d8cfef)
7.0.5 — Patch- Remove twitter share button (
cb3b9e9)
3.0.2 — Patch- Move configureViemChain, configureDynamicChains, and fetchChainConfigs to new /chain-utils subpath to reduce bundle size (
7d8cfef)
SDKUI Kit
SDKUI KitHooks
UI KitAdapters
SDKUI Kit
RelayKit
SDK3.2.0, UI Kit 6.1.0 — Minor- Integrate hyperliquid direct deposits (
2519846)
3.2.0 — Patch- Support API key parameter in
createClientSDK method (b1dbfb7)
6.1.0 — Patch- Update porto wallet compatibility (
3910284)
6.1.0 — Patch- Phantom support – add monad and hyperevm (
84e79a8)
UI Kit
SDKUI Kit
SDKUI KitAdapters
RelayKit
SDK3.1.0, UI Kit 5.1.0, Tron adapter 1.0.0 — Minor- Add Tron adapter and balance logic (
5108307)
5.1.1 — Patch- Update mobile percentage buttons (
70badbb)
5.1.1 — Patch- Improve mobile ui for slippage configuration (
5c80c9a)
5.1.1 — Patch- Add clear input button to custom address modal (
38ea2b6)
UI Kit
UI Kit
UI Kit
SDKUI Kit
SDKUI Kit
SDKUI KitAdapters
RelayKit
SDK2.4.5, UI Kit 4.0.18, Bitcoin adapter 10.0.6 — Patch- Add bitcoin public key to quote params (
e3a9e1d)
2.4.5, UI Kit 4.0.18 — Patch- Refactor max slippage ui to be more pronounced (
967e95b)
4.0.17 — Patch- Add transaction count check for explicit deposits (
eb3a8fb)
4.0.17 — Patch- Update swap event data (
1ad6ac3)
UI Kit
UI Kit
UI Kit
SDKUI Kit
SDKUI Kit
UI KitHooks
UI KitAdapters
SDKUI KitHooksAdapters
SDKUI KitHooks
SDKUI KitHooksAdapters
UI Kit
SDKUI Kit
SDKUI Kit
UI KitHooks
RelayKit
UI Kit2.15.8 — Patch- Add log to AGW check error (
fbb50ac)
2.15.8 — Patch- Add usd values to swap events (
1627058)
2.15.8 — Patch- Use max slippage between user input and quote for display (
54e4628)
2.15.8, Hooks 1.11.1 — Patch- Add relay trending tokens to token selector (
7985e6b)
2.15.8 — Patch- Enable more v2 protocol chains (
a95050e)
UI Kit
UI Kit
Adapters
UI Kit
SDKUI KitHooksAdapters
RelayKit
SDK2.3.0, UI Kit 2.15.0, Hooks 1.11.0, Bitcoin adapter 9.0.0, Ethers adapter 21.0.0, SVM adapter 10.0.0 — Minor- Upgrade viem to >=2.26.0 (
aee47ea)
2.2.0, UI Kit 2.14.0 — Minor- Upgrade sdk types and add custom logic for blast protocol v2 configuration (
3dbf1be)
2.14.0 — Patch- Check custom address against CEX address list (
dad85e2)
UI Kit
SDKUI Kit
UI KitHooks
RelayKit
UI Kit2.12.0 — Minor- Switch to Dune’s Sim api for token balances (
e3e114e)
2.12.0 — Patch- Hide display of batch txs on success step (
9c81150)
2.12.0 — Patch- Improve usd fee display (
b6e92a9)
2.12.0 — Patch- Adds toggle to switch between token amount and usd input (
37479c3)
2.12.0, Hooks 1.10.4 — Patch- Remove referrer from requests api calls (
3471571)
SDKUI KitHooks
RelayKit
SDK2.1.2, UI Kit 2.11.3, Hooks 1.10.2 — Patch- Update endpoints (
1d8da8a)
2.1.2, UI Kit 2.11.3 — Patch- Add hypevm to vmtypes for destination (
6049aa6)
2.11.3 — Patch- Ellipsify conversion rate + add tooltip to prevent overflow (
8d5e07c)
2.11.3 — Patch- Fix cropped token selector text (
c3a562f)
2.11.3 — Patch- Decrease high fee warning threshold to 1.5% (
3aabf44)
1.10.3 — Patch- Allow headers to be configured from query functions (
1da754c)
SDKUI Kit
SDKUI KitHooks
RelayKit
SDK2.1.0, UI Kit 2.11.0, Hooks 1.10.0 — Minor- Deduplicate request IDs (
bb63fc9)
2.1.0 — Patch- Optimize same chain swapping to skip intent status if slower than receipt (
758f8a7)
2.11.1 — Patch- Fix solana address regex (
f073269)
2.11.0 — Patch- Add copy for new refund reason (
73334f9)
2.11.0 — Patch- Add better handling for eclipse rpc balance errors (
d0971ec)
2.11.0 — Patch- Allow selecting wallet before selecting chain (
b30f584)
2.11.0 — Patch- Add context to wallet_selector events (
42aa03d)
2.11.0 — Patch- Fix distorted token images (
dc9da43)
2.11.0 — Patch- Capture quote to be used in TransactionModal (
4d75f3a)
UI Kit
UI Kit
UI Kit
SDKUI Kit
SDKUI Kit
SDKUI KitHooksAdapters
RelayKit
SDK2.0.1, UI Kit 2.10.6, Hooks 1.9.11, Bitcoin adapter 6.0.1, Ethers adapter 18.0.1, SVM adapter 7.0.1 — Patch- Lock viem version to patch only to avoid breaking changes (
dab775f)
2.10.6 — Patch- Add status to quote error (
1df049b)
2.10.6 — Patch- Adjust gas top up copy (
e572905)
SDKUI KitAdapters
SDKUI Kit
UI Kit
SDKUI Kit
SDKUI KitAdapters
SDKUI KitHooks
RelayKit
SDK1.7.3 — Patch- Add ability to override default logger (
bc85ead)
2.9.13, Hooks 1.9.6 — Patch- Add a quoteRequestId when requests and receiving a quote (
052745e)
2.9.13, Hooks 1.9.6 — Patch- Improve quote and swap analytics (
fe54a20)
2.9.13 — Patch- Rename quote events (
c3c4a53)
SDKUI Kit
SDKUI Kit
RelayKit
SDK1.7.1, UI Kit 2.9.11 — Patch- Add fallback mechanism when InternalJSONRPC occurrs (
effd487)
1.7.1, UI Kit 2.9.11 — Patch- Sync sdk types and update sugested tokens to use logoURI from featured tokens (
af85e2a)
2.9.11 — Patch- Render fallback token placeholder using symbol initial (
afdb901)
2.9.11 — Patch- Add sei to ME wallet compatibility (
b2af4e9)
2.9.11 — Patch- Max Button gas estimation improvements for evm (
6416987)
SDKUI KitHooks
SDKUI KitHooks
UI Kit
SDKUI Kit
UI Kit
UI Kit
SDKUI KitHooks
RelayKit
SDK1.6.13 — Patch-
Breaking Changes: (
bf8dbdb)relay-kit-hooks: UpdateduseTokenListshook to use/currencies/v2API with new response structurerelay-kit-ui: Redesigned token selector component with improved architecture- Removed chain selector in favor of unified token selector component
- Removed
defaultToTokenanddefaultFromTokenprops - Added
toToken,setToToken,fromToken,setFromTokenprops - Added
disableInputAutoFocusandpopularChainIdsconfiguration options
2.9.1 — Patch- Fix token setters (
40c1910)
2.9.0, Hooks 1.9.0 — Minor-
Breaking Changes: (
bf8dbdb)relay-kit-hooks: UpdateduseTokenListshook to use/currencies/v2API with new response structurerelay-kit-ui: Redesigned token selector component with improved architecture- Removed chain selector in favor of unified token selector component
- Removed
defaultToTokenanddefaultFromTokenprops - Added
toToken,setToToken,fromToken,setFromTokenprops - Added
disableInputAutoFocusandpopularChainIdsconfiguration options
2.9.0 — Patch- Allow dune base api to fallback to default (
12c8e59)
UI Kit
RelayKit
UI Kit2.8.0 — Minor- Refactor dune api config (
ccff74e)
2.8.0 — Patch- OnrampModal: reset recipient if vm changes and recipient is now invalid (
7e7df25)
2.8.0 — Patch- Add a prop to disable paste address wallet option (
36bad1d)
2.8.0 — Patch- Fix conversion rate display bug (
cff46c3)
2.8.0 — Patch- Add a short cache for balance queries to optimize dune usage (
5b70dc4)
SDKUI Kit
SDKUI Kit
UI Kit
SDKUI KitHooks
RelayKit
SDK1.6.9, UI Kit 2.7.14, Hooks 1.8.5 — Patch- Add scripts for statically bundling versions (
bc77582)
1.6.9, UI Kit 2.7.14 — Patch- Handle custom block explorer transaction page (
cdc8d92)
2.7.14 — Patch- Detect changes to destination chain and select supporting wallet (
7f6c958)
2.7.14 — Patch- Improve Deposit address logic in TokenSelector (
842b547)
2.7.14 — Patch- Fix a bug where changing the chain to a different vm would not find the supported linked wallet (
72f7f75)
SDKUI Kit
RelayKit
SDK1.6.8 — Patch- Update Tron dead address (
3993eb3)
2.7.13 — Patch- Add analytic events for chain select (
3b733af)
2.7.13 — Patch- Rename connect CTA to “Connect Wallet” (
38bfb4c)
2.7.13 — Patch- Fix approval tx display on swap confirmation screen (
2b603a3)
2.7.12 — Patch- Remove duplicate price impact warning (
8376d7f)
2.7.12 — Patch- Fix bug where deposit address origin prevented connecting a destination wallet (
63be014)
UI Kit
SDKUI KitHooks
SDKUI Kit
UI Kit
UI Kit
UI Kit
SDKUI KitHooks
RelayKit
SDK1.6.4 — Patch- SDK config option to omit gas fee estimates (
0ccd0d7)
2.7.1 — Patch- Fix dialog and dropdown menu incompatibility (
5af363f)
2.7.0, Hooks 1.8.0 — Minor- Remove usePrice hook, queryPrice action, and PriceResponse type (
df2820a)
2.7.0 — Patch- Remap max liquidity error (
2aaf42a)
SDKUI Kit
UI Kit
RelayKit
UI Kit2.6.10 — Patch- Fix slippage displayed for same-chain-swaps (
5be1e1d)
2.6.9 — Patch- Fix slippage config bug on rerender (
6772e0f)
2.6.8 — Patch- Add slippage configuration component (
c876fdf)
2.6.8 — Patch- Fix ChainTokenIcon fallback dimensions (
914af94)
2.6.8 — Patch- Fix onramping dollar formatting (
46e6c73)
2.6.8 — Patch- Increase width of onramp widget (
1cabbd1)
UI Kit
SDKUI Kit
RelayKit
SDK1.6.2, UI Kit 2.6.3 — Patch- Sync api types, append moonpay id to relay request (
1bf4aa7)
1.6.2, UI Kit 2.6.3 — Patch- Fix solver status timeout ui bug and split error into sub error (
4215d2e)
2.6.5 — Patch- Fix onramping bugs (
a89bedd)
2.6.4 — Patch- Fix onramp modal parseUnits error with eth amount (
7c7d3ce)
2.6.3 — Patch- Fix onramping bugs: hide suggested tokens, avoid same chain swaps (
869d750)
2.6.3 — Patch- OnrampModal bugs (
620e41d)
2.6.3 — Patch- Fix useEnsResolver hook undefined address (
773f61e)
UI KitHooks
UI Kit
UI Kit
SDKUI KitHooksAdapters
RelayKit
SDK1.6.0, UI Kit 2.5.0, Hooks 1.6.0, Bitcoin adapter 3.0.0, Ethers adapter 15.0.0, SVM adapter 4.0.0 — Minor- Add support for batch transactions (
3ae98ed)
1.6.0, UI Kit 2.5.0, Hooks 1.6.0, Bitcoin adapter 3.0.0, Ethers adapter 15.0.0, SVM adapter 4.0.0 — Patch- Add support for EIP-5792 batch transactions (
80aba91)
2.5.0 — Patch- Remove usePrice hook usage from widget (
e7f0acc)
SDKUI KitHooksAdapters
UI Kit
UI Kit
UI KitHooks
SDKUI Kit
SDKUI KitAdapters
UI Kit
UI Kit
UI KitHooks
RelayKit
UI Kit2.3.1 — Patch- Optimize usePrice hook by moving baseChainId validation to SwapWidgetRenderer and removing checkExternalLiquiditySupport prop. This improves performance by skipping invalid canonical routes based on baseChainId relationships. (
d5b3c66)
2.3.1 — Patch- Spacing for DepositAddressModal (
cb7ded3)
1.4.12 — Patch- feat: optimize usePrice hook to skip invalid canonical routes (
1a593b5)
UI KitHooks
RelayKit
UI Kit2.3.0 — Minor- Deposit Address fallback functionality (
561b396)
2.3.0 — Patch- Remove trailing zeros from formatted amount (
aa034bd)
2.3.0 — Patch- Include additional parameters when generating tx urls (
dc6b34c)
1.4.11 — Patch- Deposit Address fallback functionality (
561b396)
SDKUI Kit
UI Kit
UI Kit
UI Kit
SDKUI Kit
UI Kit
RelayKit
UI Kit2.2.19 — Patch- Hide route selector in fee breakdown in single chain mode (
fa63f61)
2.2.18 — Patch- Allow overriding chain to connector list (
4fffded)
2.2.17 — Patch- Remove route selector from single chain mode (
d1fd8ae)
2.2.17 — Patch- Add chain icon to token selector in single chain mode (
604b9f6)
2.2.17 — Patch- Fix switch tokens button border theme (
ce675ba)
SDKUI KitHooksAdapters
SDKUI Kit
SDKUI Kit
SDKUI Kit
RelayKit
SDK1.4.3, UI Kit 2.2.12 — Patch- Update solana dead address (
3dd7177)
2.2.11 — Patch- Remove support for setting unverified tokens from the chain selector (
f9b6975)
2.2.11 — Patch- Update token uri fallback styling (
5745538)
2.2.10 — Patch- Update unverified token modal to link out to block explorer’s token page (
6c52029)
2.2.10 — Patch- Fix token selector trigger overflow (
40aece0)
2.2.10 — Patch- Fix pending balance bug breaking ui (
aceb483)
SDKUI Kit
UI Kit
RelayKit
UI Kit2.2.8 — Patch- Double time estimate for bitcoin (
742a49a)
2.2.7 — Patch- Make selector theme optional (
87b0bca)
2.2.6 — Patch- Add disclaimer messaging in confirmation modal with long canonical relays (
a1e9418)
2.2.6 — Patch- Add widget selector theme variable (
bd1ec82)
2.2.6 — Patch- Fix 0 price impact (
b68e6c1)
UI KitHooks
RelayKit
UI Kit2.2.5 — Patch- Fix parallel quoting when quote returns errror but price does not (
47c6c04)
2.2.5 — Patch- Remove stroke from route selector when focused (
fc902d3)
2.2.4 — Patch- Fix double route ui issue where price error shows up alongside valid quote data (
321a64e)
2.2.3 — Patch- Expand bitcoin address validation to taproot and base58 (
104fe18)
2.2.2, Hooks 1.4.2 — Patch- Fetch price and quote in parallel to improve price accuracy in SwapWidget (
f18951c)
SDKUI KitHooksAdapters
SDKUI Kit
UI Kit
UI Kit
SDKUI Kit
UI Kit
SDKUI Kit
RelayKit
SDK1.3.2, UI Kit 2.0.3 — Patch- Fix wallet switching in ChainWidget, fix sdk convert viem chain to RelayChain helper (
277bfc5)
2.0.3 — Patch- Removed max button when Solana balance is less than minimum buffer. (
1edca7c)
2.0.2 — Patch- Added a buffer of 0.02 minimum when selecting max for a Solana balance (
78e5d13)
2.0.2 — Patch- Fix solana custom address prompt (
b1526cb)
2.0.1 — Patch- Fix solana balance cached after swapping (
dc387e3)
SDKUI Kit
SDKUI KitHooksAdapters
SDKUI Kit
UI Kit
UI Kit
UI Kit
UI Kit
RelayKit
UI Kit1.3.13 — Patch- Fix token selector chain filter bug (
f409525)
1.3.12 — Patch- Use default token list when chain is filtered (
6001f8d)
1.3.11 — Patch- Chain selector improvements (
2c6ead0)
1.3.10 — Patch- Add styling support for undefined tokens in new swap widget (
9b623c2)
SDKUI KitHooksAdapters
SDKUI Kit
RelayKit
SDK1.2.0 — Minor- Better handling of transaction in flight and post transaction ui, handle refund status when polling for transaction success (
9e14a17)
1.3.8 — Patch- Better handling of transaction in flight and post transaction ui, handle refund status when polling for transaction success (
9e14a17)
UI Kit
RelayKit
UI Kit1.3.6 — Patch- Fix analytics in TransactionModal (
7a1a4c7)
1.3.5 — Patch- Update balance display for solana (
7d3f84d)
1.3.4 — Patch- Update solana token selector logic (
785b732)
1.3.3 — Patch- Prevent switch token button in swap widget when swapping to solana token (
3ae5fee)
SDKUI Kit
RelayKit
SDK1.1.1 — Patch- Update sdk api types (
28ed450)
1.3.2 — Patch- Reduce swap conversion rate from 5 decimals to 2 decimals (
98bf004)
1.3.2 — Patch- Link out to to chain block explorer in review quote ux (
4473144)
1.3.2 — Patch- Handle 0s time estimate (
6363308)
1.3.2 — Patch- Improve custom wallet address modal ux (
35d5e43)
1.3.2 — Patch- Improve tx error messaging (
2cd9327)
1.3.2 — Patch- Reset custom address when switching to token from solana to evm chain (
b940e97)
1.3.2 — Patch- Price Impact ui tweaks (
a42142d)
UI KitHooks
SDKUI KitHooks
SDKUI Kit
UI Kit
SDK
UI KitHooks
SDKUI KitHooksAdapters
RelayKit
SDK1.0.10, UI Kit 1.1.10, Hooks 1.0.15, Ethers adapter 9.0.10 — Patch- Add review quote step, refactor modal renderers
1.0.10, Hooks 1.0.15 — Patch- Add usePrice hook (
2d22eec)
1.1.10 — Patch- Fix dollar formatting sub 0 and price impact spacing (
af694ab)
1.1.10 — Patch- Color coding price impact (
e231382)
SDKUI Kit
RelayKit
SDK1.0.9, UI Kit 1.1.8 — Patch- Better contextualize actions based on operation (
3648ec3)
1.0.9 — Patch- Add blockProductionLagging to RelayChain (
be74a6a)
1.1.8 — Patch- Only show fill time on success page if sub 10s (
ea3e6c5)
1.1.8 — Patch- Export TokenSelector component (
d5b3f82)
UI Kit
RelayKit
UI Kit1.1.7 — Patch- Reset canonical selection on ChainWidget unless supported (
7445bbf)
1.1.6 — Patch- Add txHashes to success and error events (
433ca57)
1.1.6 — Patch- Add transaction validating event (
7c8fb89)
1.1.5 — Patch- Update chain display in token select ui (
4cf2285)
1.1.4 — Patch- Sort token selector by total value usd and balance (
02c5ea0)
SDKUI Kit
SDKUI KitHooks
Hooks
SDKUI Kit
UI Kit
SDKUI KitHooks
RelayKit
SDK1.0.5, UI Kit 1.0.11, Hooks 1.0.8 — Patch- Move wallet chain id check to further in the flow (
1945809)
1.0.11 — Patch- Fix button color when token selector is locked (
ffb9ebe)
1.0.10 — Patch- Add lock token params to swap widget” (
b093883)
1.0.9 — Patch- Update powered by reservoir to use logo (
577658a)
1.0.9 — Patch- Fix total price impact copy (
525e523)
1.0.9, Hooks 1.0.7 — Patch- Add onSuccess and onError callbacks for SwapWidget (
813be48)
SDKUI Kit
SDKUI KitHooks
RelayKit
SDK1.0.3 — Patch- Optimize the way we import lodash (
772b657)
1.0.7 — Patch- Add app fee to breakdown ui (
5759936)
1.0.7 — Patch- Fix info icon alignment (
0c7e56c)
1.0.7 — Patch- Fix input icon position (
a3d4c06)
1.0.7 — Patch- Filter token search by configured tokens (
0a8325b)
1.0.5 — Patch- Add useRelayConfig hook (
2922c29)
SDKUI KitHooksAdapters
RelayKit
SDK1.0.2, UI Kit 1.0.5, Hooks 1.0.4, Ethers adapter 9.0.2 — Patch- Strip layers from generated ui kit stylesheet (
ce46e72)
1.0.6 — Patch- Add app name and fees to RelayKitProvider options (
7aa524c)
1.0.6 — Patch- Add token change callbacks (
9ad0dda)
1.0.6 — Patch- Fix theme override selector (
7a073f8)
1.0.4, Hooks 1.0.3 — Patch- Make tanstack query a peer dependency (
592feb1)
1.0.3 — Patch- Make wagmi a peer dependency (
ac60282)
1.0.2, Hooks 1.0.2 — Patch- Fix esm import errors (
2c6d3da)
SDKUI KitHooksAdapters
SDK
SDK
RelayKit
SDK0.6.0 — Minor- Upgrade getSolverCapacity method to use config v2 api (
309af6e)
0.6.0 — Patch- Add square icons to Relay Chain (
96db714)
0.6.0 — Patch- Move sdk methods to actions (
47a8aed)
0.6.0 — Patch- Add progress state (
31fecc5)
0.6.0 — Patch- Improve typescript fee execute types (
bce691b)
SDK
SDKAdapters
SDK
SDK
SDK
SDK
SDK
SDK
SDK
SDKAdapters
SDKAdapters