Skip to main content
Bridging allows you to transfer stablecoincurrencies across different blockchain networks. This enables you to move assets from one chain to another, such as transferring USDC from Ethereum to Polygon or Solana.

​
How Bridging Works

Bridging follows a simple three-step process:
  1. Create a bridge – Initiate a bridge request with your source and destination chains
  2. Review quote – Examine the transfer fees, estimated time, and quote validity period
  3. Accept bridge – Confirm the transaction to execute the cross-chain transfer

​
Quote Validity

Quotes are time-sensitive and typically expire within 24 hours. This ensures you get current network conditions and prevents stale pricing. If a quote expires before you accept it, you’ll need to create a new bridge request to get updated information.

​
Transaction Structure

When you create a bridge, the API response includes detailed information about the transaction: 
{
  "transferType": "WALLET.BRIDGE",
  "transferDetails": {
    "id": "9ccafd0f-e47f-43c2-8693-13741b67d638",
    "requestId": "1d860428-1d0b-47c5-9e65-98961ff59215",
    "createdAt": "2025-02-24T17:44:54.781519+00:00",
    "updatedAt": "2025-02-24T17:57:01.185+00:00",
    "amount": 0.01,
    "status": "COMPLETED",
    "source": {
      /* Source */
    },
    "destination": {
      /* Destination */
    },
    "receipt": {
      /* Receipt */
    },
    "failedReason": null,
    "fee": null,
    "quoteInformation": {
      /* Quote */
    }
  }
}

{
  "userId": "a804f891-b63c-4b36-99ee-0aa83e6facde",
  "walletAddress": "0xE9cfBf1D690565579D823264170eE357f80e9A34",
  "chain": "POLYGON",
  "currency": "usdc"
}

{
  "userId": "a804f891-b63c-4b36-99ee-0aa83e6facde",
  "walletAddress": "0x17f043FB0a39334641beD627551AC095941157B0",
  "chain": "ETHEREUM",
  "currency": "usdc"
}

{
  "sendGross": {
    "amount": "0.01",
    "currency": "usdc"
  },
  "sendNet": {
    "amount": "0.01",
    "currency": "usdc"
  },
  "railFee": {
    "amount": "0",
    "currency": "usdc"
  },
  "receiveGross": {
    "amount": "0.01",
    "currency": "usdc"
  },
  "receiveNet": {
    "amount": "0.01",
    "currency": "usdc"
  },
  "rate": "1",
  "expiresAt": "2025-02-25T17:44:54.781Z"
}

{
  "transactionHash": "0x17f043FB0a39334641beD627551AC095941157B0",
  "operations": {
    "mint": {
      "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac",
      "chain": "ETHEREUM"
    },
    "burn": {
      "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac",
      "chain": "POLYGON"
    },
    "approve": {
      "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac",
      "chain": "POLYGON"
    }
  }
}

​
Transaction Status

Bridge transactions progress through several statuses:
  • CREATED: Bridge request has been created and is awaiting processing
  • PROCESSING: Cross-chain operations are being executed
  • COMPLETED: Assets have been successfully transferred to the destination chain
  • FAILED: Bridge failed (check failedReason for details)

​
Quote Information

The quote includes both gross and net amounts for both sending and receiving:
  • sendGross: Total amount you’re sending from the source chain
  • sendNet: Net amount after any rail fees are deducted
  • receiveGross: Total amount you’ll receive on the destination chain
  • receiveNet: Net amount you’ll actually receive
  • rate: Exchange rate between the currencies (typically 1:1 for same-asset bridges)
  • expiresAt: When the quote expires and you’ll need a new one

​
Bridging Operations

Bridging involves several blockchain operations that are tracked in the response:
  • Mint – Creates new tokens on the destination chain
  • Burn – Destroys tokens on the source chain
  • Approve – Authorizes the bridge contract to spend your tokens
Each operation includes transaction hashes and user operation hashes for complete traceability across both chains.
Bridge operations may take several minutes to complete depending on network congestion and the specific chains involved. You can track the progress using the transaction hashes provided in the operations object.

​
Try it out

Bridge USDC from ETH to SOL

Learn how to bridge stablecoins between chains
⌘I