Deposit Address
Learn how to use Relay with a deposit address for instant bridging.
Relay supports instantly and cheaply bridging from a variety of EVM and non-EVM chain to any token. We are now launching deposit addresses to allow users to bridge without connecitng a wallet. Users can send funds to a designated address and Relay will instantly deposit the correct tokens on the destination chain in the user’s wallet. This is a great way for users to quickly start transacting on a new chain!
How It Works
A deposit address is linked to a single bridge request. They are generated on-demand, and they cannot be reused. To enable using a deposit address for your bridge, you will need to set the useDepositAddress
body parameter to true
in the quote request.
Failures via deposit addresses are extremely rare, but are still possible. If something goes wrong, we will default to manually handling refunds. If you wish to automatically receive refunds on the origin chain, specify the refundTo
address. This will mean refunds will automatically be issued on origin in case of any filling failures.
The deposit transaction requires no calldata. You just need to send any value to the
address specified in the API request response data. As long as this amount is enough to cover any gas or relay fees, it will be automatically bridged based on the route requested in the initial quote.
Deposit addresses are supported for most major currencies. Supported currencies can be queried via the currencies API by specifying the depositAddressOnly
body parameter to true
.
When using deposit addresses, there are more relayer gas fees associated with bridges. Typically about 33,000 extra gas is required than regular native bridges, and about 70,000 more for ERC-20 bridges. For very small bridges, we don’t recommend using deposit addresses since so much gas is required.
If a deposit occurs more than than 30 seconds after the quote is generated, a new quote will automatically be generated post-depositto account for gas fluctuation. This can change the amount received to be different than the quoted value.
Edge Cases
We have automatic handling for common edge cases that can occur when using deposit addresses;
- Depositing to the Wrong Chain — For example, if the bridge request requires a deposit on Base but the funds are deposited on Optimism, this amount is bridged to the destination chain originally requested as long as its enough to cover the fees and gas associated with the bridge. Please note that this will mean a new quote will be generated in-flight. NOTE: This is only supported for native ETH, see limitations.
- Double Spend — If funds are deposited to the same deposit addressed twice, we automatically refund the second deposit amount to the refundTo address if its specified. Otherwise, the funds require manual intervention.
- Extra Funds are Received — If the user deposits more funds than what is quoted, the quote will be regenerated to account for this surplus amount and the bridge will still be filled.
- Less Funds are Received — If the user deposits less funds than what is quoted, a new quote will be generated to account for the lower amount, and the bridge will be filled.
Limitations
- Calldata execution on destination is not allowed.
- The deposit transaction must come from an EOA, we do not index funds that are transfered via an internal transaction only, i.e account abstracted wallets.
- If an ERC20 is sent to the wrong chain, it is currently not supported to be auto-bridged like it is for ETH.
- Only exact input brigding is allowed. Specifying exact output will not work.
- When non-supported currency or NFTs are sent to the deposit address, we currently do not support recovering of those assets.
Debugging
When looking up the status of a bridge or fetching the request data, please use the requestId
and our Get Execution Status API.
The transaction hash of the deposit transaction cannot be used to lookup the status of the bridge for deposit address bridges.
To help with debugging transaction, make sure to store the requestId
along with other data (quotes, transactions,
bridges, etc). The requestId
is unique to Relay’s database and will be returned with the quote.
Example Request
You will find an example below of sending 0.01 ETH from Base to Optimism.
useDepositAddress
must be set totrue
refundTo
must be set whenuseDepositAddress
is being used. This is the address that refunds will be sent to in case of an issue.