Skip to main content
Relay deposit addresses allow users to bridge and swap assets by sending tokens to a deposit address. Request a deposit address for the bridging or swapping pair, send the source asset to that address, and Relay executes the bridge or swap to deliver the target asset on the destination chain. This works seamlessly for wallet funding with Privy’s client-side SDKs, server-side SDKs, and REST API.

​
Resources

Relay docs

Relay deposit address documentation.

​
Prerequisites

If you have not set up Privy yet, choose the SDK of your choice to integrate Privy in your project.

​
Integrating Relay deposit addresses

1

1. Request deposit address from Relay API

Request a deposit address from Relay’s API by making a POST request to https://api.relay.link/quote with deposit address enabled. This generates a unique deposit address that cannot be reused.
curl --request POST \
  --url 'https://api.relay.link/quote' \
  --header 'Content-Type: application/json' \
  --data '{
    "user": "0xF0AE622e463fa757Cf72243569E18Be7Df1996cd",
    "originChainId": 8453,
    "originCurrency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "destinationChainId": 10,
    "destinationCurrency": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "tradeType": "EXACT_INPUT",
    "recipient": "0xF0AE622e463fa757Cf72243569E18Be7Df1996cd",
    "amount": "100000000",
    "usePermit": false,
    "useExternalLiquidity": false,
    "referrer": "privy.io",
    "useDepositAddress": true,
    "refundTo": "0xF0AE622e463fa757Cf72243569E18Be7Df1996cd"
  }'
See the body parameters for this request below.
When using deposit addresses, set useDepositAddress to true, refundTo to the refund recipient address, and tradeType to EXACT_INPUT. Only exact input bridging is supported for deposit addresses.
2

2. Extract deposit address and requestId

The quote response contains a steps array with information for how to execute your bridge/swap.Specifically, extract the depositAddress from quote.steps[0].depositAddress and the requestId from quote.steps[0].requestId. The depositAddress is where you send tokens, and the requestId is used to track the bridge status.
const depositAddress = quote.steps[0].depositAddress;
const requestId = quote.steps[0].requestId;
3

3. Send funds to deposit address

Send tokens to the deposit address. Relay bridges or swaps the assets and sends them to the recipient address on the destination chain.

​
Check bridge status

After sending funds to the deposit address, your app can monitor the bridge status using the requestId from the quote response.

​
Conclusion

With Privy and Relay deposit addresses, your app can enable cross-chain funding for embedded wallets. Relay executes the bridge or swap, and users can fund wallets on any supported chain. For limitations, edge cases, and advanced use cases, refer to the Relay deposit addresses documentation, or reach out to us in Slack.