Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Wanwallet 2.0 Cross chain transactions
With 2.0 release, Wanwallet now supports cross-chain transactions with Ethereum.
Previous versions of Wanwallet still work as usual after release of Wanwallet 2.0, but new features like cross-chain transactions require Wanwallet 2.0 or later.
For users of previous versions, we strongly recommend backing up keystore files in a safe location before upgrading to Wanwallet 2.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 2.0 GUI in which users can send ETH to Wanchain and withdraw ETH from Wanchain to Ethereum.
Users can choose between ETH/WAN main network and test network.
This version combines ETH light wallet and WAN full node wallet.
WETH: Wanchain Ethereum Crosschain Token, ETH symbol on Wanchain.
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.
2) Installation and launch
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:
Start by CLI for test network:
wanwalletgui --network testnet
Or click Wanwalletgui to start under
3) Toggle between main net and test network
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.
4) Create/Import accounts
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
5) Cross-chain transactions
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.
6) Send ETH to Wanchain
Click the "ETH >> WETH" tab below to send ETH to Wanchain
Enter your password then press “OK” button to send the transaction.
7) Confirm/Cancel 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
8) Send WETH to Ethereum
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.
9) Normal Ethereum transactions
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"