Skip to content

Clarify gas requirements for call execution docs #257

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pedromcunha merged 3 commits into from
Mar 5, 2026
Merged

Clarify gas requirements for call execution docs #257

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1a1255d
Clarify origin chain gas requirement for call execution and link to S…
warengonzaga Feb 23, 2026
b9f78aa
Add cross-link to Gasless Swaps page per Pedro's feedback
warengonzaga Feb 23, 2026
1719b19
Merge branch 'main' into waren/cus-414-clarify-gas-requirements-for-c…
warengonzaga Feb 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion references/api/api_guides/calling-integration-guide.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,13 @@ You can use Relay cross-chain execution to perform any action (tx) on any chain.

## Before you start

<Warning>
**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.
</Warning>

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
Expand Down Expand Up @@ -967,6 +971,9 @@ 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.
- [**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.
Expand Down
4 changes: 4 additions & 0 deletions use-cases/calling.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<Note>
**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.
</Note>

## 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.
Expand Down