Cross-Chain Deposit

​

Overview

The Cross-Chain Deposit endpoint enables deposits from chains other than Arbitrum into your margin wallet. It handles the entire process of bridging tokens and depositing them into your account automatically.

​

Request Body

​

Process Flow

The cross-chain deposit process follows these steps:

1. Check if token approval is needed
2. If needed, approve token (separate transaction)
3. Execute cross-chain transfer
4. Automatic conversion to Arbitrum USDC
5. Automatic deposit into margin wallet

​

Response Fields

​

Initial Check Response

​

Deposit Response

​

Example Usage

​

Example Responses

​

When Approval Needed

{
  "needsApproval": true,
  "approvalCalldata": "0x095ea7b3...",
  "spenderAddress": "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"
}

​

When Ready for Deposit

{
  "calldata": "0x4d595245...",
  "routerAddress": "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789"
}

​

Implementation Notes

• Higher fees compared to direct Arbitrum deposits due to cross-chain operations
• Transaction time varies based on source chain and network conditions
• Amount is automatically converted to USDC on Arbitrum
• Requires two transactions if token approval is needed
• Uses Squid Router for cross-chain transfers

​

Best Practices

1. Always Check Approval First

   • Call endpoint first without sending any transactions
   • Handle approval if needed before proceeding

2. Handle Network-Specific Requirements

   • Different chains may have different token decimals
   • Gas fees vary by network
   • Transaction confirmation times vary

3. Error Handling

   • Implement proper timeout handling
   • Account for potential cross-chain delays
   • Verify final deposit in margin wallet

​

Error Responses

The endpoint will return a 400 status code for:

• Invalid or missing userAddress
• Invalid fromChainId
• Invalid amount format
• Unsupported token or chain
• Invalid token address

A 500 status code will be returned for:

• Router contract errors
• Bridge service unavailability
• Other internal errors