Wanchain Bridge User Manual (New Version)
Last updated
Last updated
The new version of the Wanchain Bridge introduces several major improvements:
Performance
Increased transaction speed and efficiency.
Features
Added support for direct token selection mode and select-chain-then-token mode.
Added support for more blockchains and asset types.
Added support for new extension wallets.
Added support for disconnecting and switching between connected wallets.
Added support for connecting separate EVM wallets and Non-EVM wallets when transferring assets between EVM chains and Non-EVM chains.
Added a toggle to only display XFlows & CCTP routes.
Added cross-chain transaction time estimates.
Added a dashboard and liquidity page to view Wanchain Bridge statistics.
Added a dark mode.
Added a history page.
Added an NFT bridge page to display all supported NFT collections and available NFTs.
This guide will demonstrate five separate cross-chain transactions:
$ETH from Ethereum to Wanchain using the WanBridge web portal with Metamask.
$ADA from Cardano to Wanchain using the WanBridge web portal with Nami wallet.
$BTC from Bitcoin to Wanchain using the WanBridge web portal and an external BTC wallet.
NFT cross-chain transaction from Ethereum to BNB Chain using the WanBridge web portal with Metamask.
$WAN from Wanchain to XDC Network using the MetaMask mobile app.
Before completing decentralised cross-chain transactions using the WanBridge web portal, you need to ensure you have access to the correct wallet(s). You must have wallets for each network involved in the cross-chain transaction. Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks. Also ensure you have the correct non-EVM wallets installed if you are interacting with non-EVM chains.
Click on the "Connect wallet" button in the top right corner, and connect to an EVM Compatible wallet that supports Ethereum, such as Metamask.
Click “MetaMask”
If this is your first time using the WanBridge web portal, you will first need to give permission to connect your wallet. Follow the MetaMask prompts by clicking “Next” then “Connect” as instructed.
Select the “From Chain” as Ethereum and the “Asset” as ETH.
Note: This will automatically switch the network to Ethereum if your MetaMask is on another network.
Select the “To Chain” as Wanchain, which will automatically fill in your connected wallet address. If you wish to use a different destination address, you can click the Edit button, then enter your address and click save.
Enter the amount you wish to cross-chain transfer, then click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
After confirming the information is correct, click the "Confirm" button, then click “Confirm” in the MetaMask pop-up to confirm the transaction.
Your cross-chain transaction is now processing, please be patient. On the cross-chain history tab, you’ll the status will change two times:
In Progress (1/2)
In Progress (2/2)
Success
Note: The speed of the cross-chain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
Once your cross-chain transaction is complete, you’ll see your $ETH balance on Wanchain (called $wanETH) and the cross-chain transaction status change to “success”.
Before completing decentralised cross-chain transactions using the WanBridge web portal, you need to ensure you have access to the correct wallet(s). You must have wallets for each network involved in the cross-chain transaction. Nami is a popular wallet that grants you access to the Cardano blockchain network. Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks.
Click on the "Connect wallet" button in the top right corner, and connect to a Cardano Compatible wallet, such as Nami.
Select the “From Chain” as Cardano and the “Asset” as ADA.
Select the “To Chain” as Wanchain. Click the small wallet icon on the right side of the input box to connect a Wanchain-supported extension wallet such as MetaMask, then select your address from the list. You can also click the Edit button, enter your address manually, then click the green check mark to save.
Enter the amount you wish to cross-chain transfer, then click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
After confirming the information is correct, click the "Confirm" button, then click “Sign” in the Nami pop-up to confirm the transaction.
Your cross-chain transaction is now processing, please be patient. On the cross-chain history tab, you’ll the status will change two times:
In Progress (1/2)
In Progress (2/2)
Success
Note: The speed of the cross-chain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
Once your cross-chain transaction is complete, you’ll see your $ADA balance on Wanchain (called $wanADA) and the cross-chain transaction status change to “success”.
Before completing decentralised cross-chain transactions using the WanBridge web portal, you need to ensure you have access to the correct wallet(s). Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks. As BTC will be sent from an external wallet, use any Bitcoin wallet of your choice.
Click on the "Connect wallet" button in the top right corner, and connect to an EVM Compatible wallet that supports Wanchain, such as Metamask.
Select the “From Chain” as Bitcoin and the “Asset” as BTC.
Select the “To Chain” as Wanchain. Click the small wallet icon on the right side of the input box to connect a Wanchain-supported extension wallet such as MetaMask, then select your address from the list. You can also click the Edit button, enter your address manually, then click the green check mark to save.
Enter the amount you wish to cross-chain transfer, then click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
After confirming the information is correct, click the "Confirm" button.
Confirm the information is correct, copy the one-time Bitcoin address, then send the amount of BTC shown to the one time address. Only send one transaction with the correct amount, do not send multiple transactions. Once you have sent your BTC, click “Confirm”, then confirm the pop-up too.
Your cross-chain transaction is now processing, please be patient. On the cross-chain history tab, you’ll the status will change two times:
In Progress (1/2)
In Progress (2/2)
Success
Note: The speed of the cross-chain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
Once your cross-chain transaction is complete, you’ll see your $BTC balance on Wanchain (called $wanBTC) and the cross-chain transaction status change to “success”.
Before completing decentralised cross-chain transactions using the WanBridge web portal, you need to ensure you have access to the correct wallet(s). Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks. Also ensure you have the correct non-EVM wallets installed if you are interacting with non-EVM chains.
Click on the "Connect wallet" button in the top right corner, and connect to an EVM Compatible wallet that supports Ethereum, such as Metamask.
For the “Source Chain”, select Ethereum, then select the Collection (e.g., GMPD). Note: This will automatically switch the network to Ethereum if you are on a different network. Confirm in the Metamask pop-up to switch networks.
Select the NFTs you wish to cross-chain transfer under the collection you chose.
For the “Destination Chain”, select BNB Chain. Your connected MetaMask address will automatically be filled as the destination address. If you wish to cross-chain transfer to a different address, click the edit button, then enter your address and click the green check mark to save.
Click “Confirm” to proceed.
Confirm all information is correct, then click the “Confirm” button and confirm the MetaMask pop-up.
Your cross-chain transaction is now processing, please be patient. On the cross-chain history tab, you’ll the status will change two times:
In Progress (1/2)
In Progress (2/2)
Success
Note: The speed of the cross-chain NFT transaction is entirely dependent on the networks involved. Transactions involving slower networks like Ethereum may take several minutes or more to complete.
Once your cross-chain NFT transaction is complete, you’ll see your NFT on BNB Chain and the cross-chain transaction status change to “success”.
Before completing decentralised cross-chain transactions using mobile, you’ll need a mobile wallet installed such as MetaMask Mobile. WanBridge Web Portal is accessible through MetaMask Mobile’s built-in browser.
Note: Cross-chain transactions on mobile are limited to EVM chains only for now.
On the MetaMask Mobile app, navigate to the built in browser and visit the WanBridge Web Portal. Click on the "Connect Wallet" button bottom, then select MetaMask,. This will connect your MetaMask Mobile address.
Select the “From Chain” as Wanchain and the “Assset” as WAN.
Select the “To Chain” as XDC Network. Your MetaMask address will automatically be filled. You can also click the Edit button, enter your address manually, then press the green check mark to save.
Enter the amount you wish to cross-chain transfer, then press “Next”.
After confirming the information is correct, press the "Confirm" button, then press “Confirm” in the MetaMask pop-up to confirm the transaction.
Your cross-chain transaction is now processing, please be patient. On the cross-chain history tab, you’ll the status will change two times:
In Progress (1/2)
In Progress (2/2)
Success
Note: The speed of the cross-chain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
Once your cross-chain transaction is complete, you’ll see your $WAN balance on XDC Network and the cross-chain transaction status change to “success”.
In order to cross-chain transfer assets, the network connected to your wallet must match the selected “From” chain. There are two ways to switch wallet networks:
Method one: When selecting the From chain, the WanBridge web portal will automatically switch the wallet network, requiring the user to manually confirm the network switch in the pop-up.
Method two: If not supported or automatic network switching fails, open the extension wallet and manually select the corresponding network.
You can see which assets are supported for cross-chain and which assets you currently own on the blockchain through the Assets selection window.
The new WanBridge offers two modes for selecting chains and tokens: the direct token selection mode and the select-chain-then-token mode.
Direct token selection mode: On the default page, simply click the Asset dropdown button. You will see a list of all assets supported by WanBridge in the Asset dropdown box, including your own asset information. Directly select the asset you need to cross-chain (filtering both Chain and Asset at the same time).
Select-chain-then-token mode: Alternatively, you can select the “From” chain first, and then select the assets on that chain (filter Chain -> then filter Asset).
The duration of cross-chain transactions depends on the networks involved. Networks like Ethereum and Bitcoin will be slower than faster networks like BNB Chain and Tron for example.
On the new WanBridge, an estimated time on the confirm page is shown. If a transaction has not succeeded after an extended period, such as over 3 hours, you can contact us for inquiries and processing at techsupport@wanchain.org
In general, the bridge fee for a cross-chain transaction consists of network fee and service fee. You can see the bridge fee in detail on the WanBridge frontend when you conduct a specific cross-chain transaction.
