Crosschain Transaction Guide (BTC)

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

Crosschain transactions using the Wanchain Desktop Wallet

$BTC crosschain transaction from Wanchain to Bitcoin

Step 1: Enable wanBTC and BTC on the Wanchain Desktop Wallet.

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.

Step 2: Enabling BTC crosschain functionality.

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.

Step 3: Initiate a crosschain transaction to move your $BTC from Wanchain to Bitcoin.

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.

Step 4: Wait for your crosschain transaction to complete. It is now processing.

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.

Step 5: Confirm the receipt of your funds. Your crosschain transaction is now complete!

Once your transaction is complete, you’ll see your BTC balance update, and the crosschain transaction status change to “Success”.

$BTC crosschain transaction from Bitcoin to Wanchain

Step 1: Initiate a crosschain transaction to move your $BTC from Bitcoin to Wanchain.

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.

Step 2: Wait for your crosschain transaction to complete. It is now processing.

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.

Step 3: Confirm the receipt of your funds. Your crosschain transaction is complete!

Once your crosschain transaction is complete, you’ll see your $BTC balance on Bitcoin update, and the crosschain transaction status change to “Success”.

Crosschain transactions using the WanBridge web portal

$BTC crosschain transaction from Wanchain to Bitcoin

Step 1: Make sure you have the appropriate wallets installed.

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.

Download Metamask here.

Step 2: Visit the WanBridge web portal and connect your wallet.

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.

Step 3: Initiate a crosschain transaction to move your $BTC from Wanchain to Bitcoin.

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.

Step 4: Wait for your crosschain transaction to complete. It is now processing.

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.

Step 5: Confirm the receipt of your funds. Your crosschain transaction is 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”.

$BTC crosschain transaction from Bitcoin to Wanchain

Step 1: Make sure you have the appropriate wallets installed.

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.

Step 2: Visit the WanBridge web portal.

Step 3: Initiate a crosschain transaction to move your $BTC from Bitcoin to Wanchain.

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”.

Step 4: Manually send your $BTC to the One-time Address.

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”.

Step 5: Wait for your crosschain transaction to complete. It is now processing.

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.

Step 6: Confirm the receipt of your funds. Your crosschain transaction is 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”.