From 1a1255d997c9f81bf28259cfaefbeef2b30fe23a Mon Sep 17 00:00:00 2001 From: Waren Gonzaga Date: Mon, 23 Feb 2026 10:07:37 +0800 Subject: [PATCH 1/2] Clarify origin chain gas requirement for call execution and link to Smart Accounts Based on customer feedback (CUS-414 / SE-1402) where an integrator was confused that "pay with any token" implied zero native gas was needed. These changes make it explicit that EOA wallets still need origin chain gas and point to Smart Accounts for truly gasless flows. Co-Authored-By: Claude Opus 4.6 --- references/api/api_guides/calling-integration-guide.mdx | 8 +++++++- use-cases/calling.mdx | 4 ++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/references/api/api_guides/calling-integration-guide.mdx b/references/api/api_guides/calling-integration-guide.mdx index f17ecf2..279d2a2 100644 --- a/references/api/api_guides/calling-integration-guide.mdx +++ b/references/api/api_guides/calling-integration-guide.mdx @@ -12,9 +12,13 @@ You can use Relay cross-chain execution to perform any action (tx) on any chain. ## Before you start + + **Origin chain gas required**: The user must have a small amount of native gas token (e.g., ETH) on the origin chain to submit the deposit transaction. While Relay handles destination chain execution and deducts fees from the user's tokens, the initial on-chain deposit still requires native gas — this is an EVM-level requirement. If your users have **zero native tokens**, you'll need to use [Smart Accounts](/references/api/api_guides/smart_accounts/smart-accounts) (EIP-7702 or ERC-4337) or [Sponsored Execution](/features/sponsored-execution) for a fully gasless flow. + + While not mandatory for integration, doing the following will improve the UX for your users considerably: -* **Verify user balance** - Confirm user has sufficient funds for amount \+ fees +* **Verify user balance** - Confirm user has sufficient funds for amount \+ fees, including native gas on the origin chain for the deposit transaction * **Check chain support** - Confirm both origin and destination chains are supported * **Validate quote** - Quotes are revalidated when being filled, keep your quotes as fresh as possible. * **Handle errors** - Implement proper error handling for API requests and transaction failures @@ -967,6 +971,8 @@ const txs = [ ## See Also +- [**Smart Accounts**](/references/api/api_guides/smart_accounts/smart-accounts): Enable fully gasless transactions where users hold zero native tokens, using EIP-7702 or ERC-4337. +- [**Sponsored Execution**](/features/sponsored-execution): Execute gasless transactions where the transaction signer and gas payer are different addresses. - [**App Fees**](/features/app-fees): Monetize your integration by adding a fee (in bps) to every quote. - [**Fee Sponsorship**](/features/fee-sponsorship): Sponsor fees for your users to reduce friction and improve the user experience. - [**Handling Errors**](/references/api/api_core_concepts/errors): Handle quote errors when using the Relay API. diff --git a/use-cases/calling.mdx b/use-cases/calling.mdx index 4f7dcf9..8b75623 100644 --- a/use-cases/calling.mdx +++ b/use-cases/calling.mdx @@ -7,6 +7,10 @@ description: "Execute transactions across any chain, pay with any token" Relay supports cross-chain transaction execution for arbitrary cross-chain transactions. This means a user can execute any call on any chain and pay with any token on any other chain. This feature is perfect for cross-chain checkout experiences as well as full chain abstraction. + + **Gas requirement**: With standard EOA wallets, the user still needs a small amount of native gas token (e.g., ETH) on the **origin chain** to broadcast the initial deposit transaction. Relay handles all destination chain gas and deducts fees from the user's tokens, but the origin chain submission requires native gas. For a fully gasless experience where users hold **zero native tokens**, see [Smart Accounts](/references/api/api_guides/smart_accounts/smart-accounts) (EIP-7702 or ERC-4337). These require a [partner account](/features/sponsored-execution). + + ## How it Works Relay's cross-chain execution is powered by cross-chain intents. This model results in low-cost, low-latency (1-10 seconds) cross-chain transactions. When a user wishes to perform a cross-chain action, they submit the call data to get a quote from relayers for execution. When they accept the quote, the order is validated and they submit a transfer to the [Relay Depository Contract](/references/protocol/overview). A relayer then instantly fills the transaction on the destination chain before unlocking the funds on the origin. From b9f78aad88ba2a5a1396a370ecb435bddde87c6c Mon Sep 17 00:00:00 2001 From: Waren Gonzaga Date: Mon, 23 Feb 2026 11:38:22 +0800 Subject: [PATCH 2/2] Add cross-link to Gasless Swaps page per Pedro's feedback Co-Authored-By: Claude Opus 4.6 --- references/api/api_guides/calling-integration-guide.mdx | 3 ++- use-cases/calling.mdx | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/references/api/api_guides/calling-integration-guide.mdx b/references/api/api_guides/calling-integration-guide.mdx index 279d2a2..c2652ea 100644 --- a/references/api/api_guides/calling-integration-guide.mdx +++ b/references/api/api_guides/calling-integration-guide.mdx @@ -13,7 +13,7 @@ You can use Relay cross-chain execution to perform any action (tx) on any chain. ## Before you start - **Origin chain gas required**: The user must have a small amount of native gas token (e.g., ETH) on the origin chain to submit the deposit transaction. While Relay handles destination chain execution and deducts fees from the user's tokens, the initial on-chain deposit still requires native gas — this is an EVM-level requirement. If your users have **zero native tokens**, you'll need to use [Smart Accounts](/references/api/api_guides/smart_accounts/smart-accounts) (EIP-7702 or ERC-4337) or [Sponsored Execution](/features/sponsored-execution) for a fully gasless flow. + **Origin chain gas required**: The user must have a small amount of native gas token (e.g., ETH) on the origin chain to submit the deposit transaction. While Relay handles destination chain execution and deducts fees from the user's tokens, the initial on-chain deposit still requires native gas — this is an EVM-level requirement. If your users have **zero native tokens**, see [Gasless Swaps](/features/gasless-swaps) to find the right approach, or use [Smart Accounts](/references/api/api_guides/smart_accounts/smart-accounts) (EIP-7702 or ERC-4337) / [Sponsored Execution](/features/sponsored-execution) for a fully gasless flow. While not mandatory for integration, doing the following will improve the UX for your users considerably: @@ -971,6 +971,7 @@ const txs = [ ## See Also +- [**Gasless Swaps**](/features/gasless-swaps): Find the right gasless approach for your app — permit-based, ERC-4337, or EIP-7702. - [**Smart Accounts**](/references/api/api_guides/smart_accounts/smart-accounts): Enable fully gasless transactions where users hold zero native tokens, using EIP-7702 or ERC-4337. - [**Sponsored Execution**](/features/sponsored-execution): Execute gasless transactions where the transaction signer and gas payer are different addresses. - [**App Fees**](/features/app-fees): Monetize your integration by adding a fee (in bps) to every quote. diff --git a/use-cases/calling.mdx b/use-cases/calling.mdx index 8b75623..0ea42fd 100644 --- a/use-cases/calling.mdx +++ b/use-cases/calling.mdx @@ -8,7 +8,7 @@ description: "Execute transactions across any chain, pay with any token" Relay supports cross-chain transaction execution for arbitrary cross-chain transactions. This means a user can execute any call on any chain and pay with any token on any other chain. This feature is perfect for cross-chain checkout experiences as well as full chain abstraction. - **Gas requirement**: With standard EOA wallets, the user still needs a small amount of native gas token (e.g., ETH) on the **origin chain** to broadcast the initial deposit transaction. Relay handles all destination chain gas and deducts fees from the user's tokens, but the origin chain submission requires native gas. For a fully gasless experience where users hold **zero native tokens**, see [Smart Accounts](/references/api/api_guides/smart_accounts/smart-accounts) (EIP-7702 or ERC-4337). These require a [partner account](/features/sponsored-execution). + **Gas requirement**: With standard EOA wallets, the user still needs a small amount of native gas token (e.g., ETH) on the **origin chain** to broadcast the initial deposit transaction. Relay handles all destination chain gas and deducts fees from the user's tokens, but the origin chain submission requires native gas. For a fully gasless experience where users hold **zero native tokens**, see [Gasless Swaps](/features/gasless-swaps) to find the right approach for your app, or explore [Smart Accounts](/references/api/api_guides/smart_accounts/smart-accounts) (EIP-7702 or ERC-4337) directly. ## How it Works