Bridge

Bridge supported assets between W Chain and other networks using W Swap’s Bridge page. This guide covers supported chains and tokens, approvals, transaction statuses, and best practices.

Overview

  • Networks Supported: Ethereum, BNB Chain, and W Chain

  • Native Tokens: ETH (Ethereum), BNB (BNB Chain), WCO (W Chain)

  • Purpose: Move supported assets cross‑chain to trade or provide liquidity on W Chain

  • Finality: A validator-based process confirms bridge transfers; funds are minted or released when votes reach quorum

Supported Assets

  • From Ethereum → W Chain:

    • USDT

    • USDC

  • From BNB Chain → W Chain:

    • bUSDT

    • bUSDC

    • XRP (BEP‑20)

    • DOGE (BEP‑20)

    • SOL (BEP‑20)

  • From W Chain → Ethereum or BNB Chain:

    • Tokens mirrored on W Chain including USDT, USDC, and Binance‑peg variants (bUSDT, bUSDC), plus XRP, DOGE, SOL for BNB Chain direction.

Note:

  • Token availability depends on the selected From/To networks. The Bridge page filters assets accordingly.

  • On W Chain, bridged tokens have distinct addresses; always verify the token symbol and address shown in the UI.

  • Chain IDs:

    • Ethereum Mainnet: 1

    • BNB Chain Mainnet: 56

    • W Chain Mainnet: 171717

  • Explorers (used by the DApp):

    • Ethereum: https://etherscan.io/tx/<hash>

    • BNB Chain: https://bscscan.com/tx/<hash>

    • W Chain: https://scan.w-chain.com/tx/<hash>

Testnets (if applicable):

  • Sepolia (Ethereum): 11155111

  • BNB Chain Testnet: 97

  • W Chain Testnet: 71117 (Explorer: https://scan-testnet.w-chain.com/tx/<hash>)

Prerequisites

  • A supported EVM wallet (e.g., Rabby—recommended for enhanced safety—or MetaMask).

  • Gas on the source chain (ETH for Ethereum, BNB for BNB Chain, WCO for W Chain).

  • The token you want to bridge in your source chain wallet.

Bridging Steps

  1. Open the Bridge page and connect your wallet.

  2. In From, choose the source network (Ethereum / BNB Chain / W Chain). In To, choose the destination.

  3. Select a supported asset for the chosen route; use the token selector or search.

  4. Enter the amount to bridge. The UI shows any limits/fees and estimated arrival.

  5. If prompted, click Approve to grant the bridge contract permission to transfer your token.

  6. Click Bridge and confirm in your wallet.

  7. Track status in the Confirm modal and Bridge History. Typical statuses include:

    • Transaction Initialized

    • Transaction Pending

    • Transaction Submitted

    • Transaction Awaiting Validators Votes

    • Transaction Successful (funds arrive on destination)

    • Transaction Failed or Rejected

Arrival and Claiming:

  • No manual claim step is generally required. Funds are credited on the destination chain once validators finalize the transfer.

  • The DApp provides explorer links for both source and destination transactions.

Fees and Timing

  • Fees vary by route and token. They are displayed before you confirm the bridge.

  • Timing depends on source chain congestion and validator finalization. Expect longer times during network congestion.

Bridge History

  • Use Bridge History to review previous transfers, current status, and retry or reference transaction hashes as needed.

Troubleshooting

  • Approval Required: Approve the specific token on the source chain before bridging.

  • Unsupported Route: Switch networks or choose a supported asset for the selected From/To pair.

  • Pending Too Long: Check the explorer links and try again during lower congestion; ensure adequate gas.

  • Rejected/Failed: Review wallet prompts, increase gas settings if necessary, and retry.

Safety Tips

  • Only bridge tokens listed by the DApp; do not paste arbitrary addresses.

  • Confirm the From and To networks are correct before submitting.

  • Maintain sufficient gas on both sides if you plan to interact immediately after bridging.

FAQs

  • Can I bridge directly to trade? Yes—bridge first to W Chain, then use the Trade page.

  • Do I need to claim funds? No, funds arrive automatically after validator finalization.

  • Where do I find transaction links? In the modal and history, linking to etherscan.io, bscscan.com, and scan.w-chain.com.

Last updated