Learn how to use Relay with a deposit address for instant bridging.
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 thedepositAddressOnly
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 30 seconds after the quote is generated, a new quote will automatically be generated post-deposit to account for gas fluctuation. This can change the amount received to be different than the quoted value.
All relay EVM deposit addresses being and end with the character d
(not case-sensitive). This is to help us with reducing the indexing search space.
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 transactions, 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.
useDepositAddress
must be set to true
refundTo
must be set when useDepositAddress
is being used.
This is the address that refunds will be sent to in case of an issue.