Crosschain Transaction Guide (BTC)
Last updated
Last updated
An in-depth guide outlining how to complete a Bitcoin crosschain transaction using both the Wanchain Desktop Wallet and the WanBridge web portal.
This guide will demonstrate four separate crosschain transactions:
$BTC from Wanchain to Bitcoin using the Wanchain Desktop Wallet
$BTC from Bitcoin to Wanchain using the Wanchain Desktop Wallet
$BTC from Wanchain to Bitcoin using the WanBridge web portal with Metamask
$BTC from Bitcoin to Wanchain using the WanBridge web portal
Navigate to Wallet → More Tokens.
Scroll down until you see BTC. Then, click the stars next to wanBTC and BTC. As in the screenshot below.
$BTC and $wanBTC wallets are now enabled and appear in your portfolio overview.
Navigate to Cross Chain → More Tokens.
Scroll down until you see BTC. Then, click the star next to Bitcoin <-> Wanchain. As in the screenshot below.
Navigate to Cross Chain → BTC → Bitcoin <-> Wanchain.
Since you are moving $BTC from Wanchain to Bitcoin, click “Convert” next to your wanBTC balance, as in the screenshot below. $BTC on Wanchain is called $wanBTC.
Select which of your $BTC wallets you would like to receive the $BTC on Bitcoin, enter the amount of $wanBTC to convert, then click “Next”. Optionally, you can select “Send Everything” to move your entire $wanBTC balance to Bitcoin.
Confirm that all the details are correct then click “Send”. This will initiate the crosschain transaction.
While your crosschain transaction is processing, the status will change three times:
Lock Request Sent — A lock request has been sent to Wanchain’s bridge nodes.
Locked — Your wanBTC is now locked with Wanchain’s bridge nodes.
Success — Your crosschain transaction is now complete.
Note: The speed of the crosschain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
While your crosschain transaction is processing, you can click the status to view more detailed information.
Once your transaction is complete, you’ll see your BTC balance update, and the crosschain transaction status change to “Success”.
Navigate to Cross Chain → BTC → Bitcoin <-> Wanchain
Since you are moving $BTC from Bitcoin to Wanchain, click “Convert” near your BTC balance, as in the screenshot below.
Select which of your $WAN wallets you would like to receive the $wanBTC on Wanchain, enter the amount of $BTC to convert, then click “Next”. Optionally, you can select “Send Everything” to move your entire $BTC balance to Wanchain.
Confirm that all the details are correct then click “Send”. This will initiate the crosschain transaction.
While your crosschain transaction is processing, the status will change three times:
Lock Request Sent — A lock request has been sent to Wanchain’s bridge nodes.
Locked — Your wanBTC is now locked with Wanchain’s bridge nodes.
Success — Your crosschain transaction is now complete.
Note: The speed of the crosschain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
While your crosschain transaction is processing, you can click the status to view more detailed information as we did before.
Once your crosschain transaction is complete, you’ll see your $BTC balance on Bitcoin update, and the crosschain transaction status change to “Success”.
Before completing decentralised crosschain 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 crosschain transaction. Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks.
Click “Connect to Wallet”.
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 “BTC” from the drop-down menu. Then, choose “Wanchain” and “Bitcoin” as your From and To networks, respectively. Finally, input your destination address in the “Recipient” field as well as the amount of $BTC you want to send crosschain. Click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
Confirm that all the details are correct then click “Confirm”.
Confirm the transaction by clicking “Confirm” in the MetaMask pop-up window.
While your crosschain transaction is processing, the status will change three times:
Processing (1/2)
Processing (2/2)
Success
Note: The speed of the crosschain 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 crosschain transaction is complete, you’ll see your $BTC balance on your Bitcoin address, and the crosschain transaction status change to “Success”.
Before completing decentralised crosschain 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 crosschain transaction. When transferring from networks that do not support native smart contracts, you will be instructed to manually send a transaction to initiate the crosschain transaction. It is highly recommended to only use a wallet that you own and control.
Select “BTC” from the drop-down menu. Then, choose “Bitcoin” and “Wanchain” as your From and To networks, respectively. Finally, input your destination address in the “Recipient” field as well as the amount of $BTC you want to send crosschain. Click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
Confirm that all the details are correct then click “Confirm”.
Copy the One-time Address and manually transfer the listed amount of $BTC using the Bitcoin wallet of your choice. It is highly recommended to use a Bitcoin wallet that you own and control.
Note: Be sure to send the correct amount of $BTC, as indicated. Send the entire amount as ONE transaction.
Read the warning and click “Confirm”.
While your crosschain transaction is processing, the status will change three times:
Processing (1/2)
Processing (2/2)
Success
Note: The speed of the crosschain 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 crosschain transaction is complete, you’ll see your $BTC balance on Wanchain (called $wanBTC), and the crosschain transaction status change to “Success”.
Join our Telegram Tech Support channel. Our support team is standing by and happy to help!
Note: If you receive a DM offering help, block them immediately. Admins will never DM you first! Never share your seed words with anyone, period.
