Wanwallet 3.0 Cross chain transactions (BTC, ERC20)
Notes:
-
With 3.0 release, Wanwallet now supports cross-chain transactions with Ethereum, Bitcoin and also ERC20 tokens.
-
Previous versions of Wanwallet still work as usual after release of Wanwallet 3.0, but new features like Bitcoin & ERC20 cross-chain transactions require Wanwallet 3.0 or later, so we strongly encourage you to update to the latest version of Wanwallet.
-
For users of previous versions, we strongly recommend backing up keystore files in a safe location before upgrading to Wanwallet 3.0 to prevent any kind of data loss, though the upgrading process will not alter existing keystore files in any way.
-
This instruction guide is for Wanwallet 3.0 GUI in which users can send BTC & ERC20 tokens to Wanchain and withdraw BTC & ERC20 tokens from Wanchain to Bitcoin and to Ethereum respectively.
-
ERC20 token used as example in this instruction manual is MKR. Wanwallet 3.0 also supports other ERC20 tokens, please use Wanwallet 3.0 or later, or refer to Wanchain’s Explorer – Token page, for complete list of ERC20 tokens supported.
-
Wanwallet will support more ERC20 tokens in the future. Actually Wanwallet 3.0 or later can support cross-chain transaction of all kinds of ERC20 token, given necessary implementation by Wanchain Foundation for them.
-
ERC20 token issuing party doesn’t have any implementation/adaptation work to do in order to be supported by Wanchain’s cross-chain ability.
-
Users can choose between BTC/ETH/WAN main network and test network in Wanwallet.
-
This version combines BTC/ETH light wallet and WAN full node wallet.
Terminology
-
WBTC: Wanchain Bitcoin Crosschain Token, BTC symbol on Wanchain.
-
WMKR: Wanchain MKR Crosschain Token, MKR symbol on Wanchain. MKR being an ERC20 token on Ethereum.
-
HTLC: Hashed Timelock Contracts.
Download Wanwallet 2.0 installation file from https://wanchain.org/product
*Wanwallet 2.0 supports Linux, Windows, MacOS, please download corresponding installation file for your OS.
Extract the file, run, and click the "LAUNCH APPLICATION" button to start the wallet
For Linux users:
Setup by CLI: sudo dpkg -i WanWalletGui-linux64-2.X.X.deb
-
Start by CLI for main network:
wanwalletgui -
Start by CLI for test network:
wanwalletgui --network testnet -
Or click Wanwalletgui to start under
/usr/local/bin/
Wanwallet 2.0 works with both main and test networks of Wanchain and Ethereum.
Below you can see the Wanchain accounts overview page (also the default start-up page), you can access it anytime by clicking on the Wanchain logo on the upper-left corner
Use the menu option below (Develop--->Network) to switch between main network (default network) and test network.
These 2 options allow you to create new WAN or new ETH account.
The "CREATE ACCOUNT" button in the upper-right corner only creates new WAN account
You can also import existing WAN or ETH account using wallet keystore file
Backup feature opens local keystore files location of WAN or ETH accounts
Crosschain transactions are under this tab
Before you make a crosschain transaction, please check WAN and ETH balance in your account in Wanwallet GUI or with links below.
Main network：
Test network：
Click the "ETH >> WETH" tab below to send ETH to Wanchain
Enter your password then press “OK” button to send the transaction.
In the "Transaction history" tab, click on the “Confirm" button to finalize the cross-chain transaction process once it turned red.
If you do not confirm before the HTLC countdown ends, it means you choose to cancel the transaction and refund the ETH from the locked account. The "Confirm" button changes to "Cancel" and you can click it to cancel the transaction once it turned red
Once the “Confirm” button turned red, click it to access “Confirm Transaction” page.
Enter the password then click “OK” button to finalize transaction
Once the “Cancel” button turned red (after countdown ends), click it to access “Cancel Transaction” page.
Enter the password then click “OK” button to cancel the transaction
If you have ETH balance on Wanchain (WETH balance), you can send WETH back to Ethereum.
Click the "WETH >> ETH" tab below to perform this kind of cross-chain transaction.
The process is similar to the ETH to Wanchain one, please refer to section 7 for details about how to confirm or cancel the transaction.
You can also perform normal Ethereum transaction in Wanwallet GUI.
Click the "Normal transaction" tab below, fill source and destination accounts, transaction amount, fee preference, then click "SEND"
