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.

Terminology

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. Extract the file, run, and click the “LAUNCH APPLICATION” button below to start the wallet.

For MacOS:

For MacOS:

3) Click to start.

For Linux: Setup by CLI: sudo dpkg -i WanWalletGui-linux64–2.0.X.deb

Start by CLI for main network: wanwalletgui

Start by CLI for test network: wanwalletgui- -network testnet

Click here to start: 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.

4) Use the menu option below (Develop — ->Network) to switch between main network (default network) and test network.

5) 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.

6) Before you make a crosschain transaction, please check WAN and ETH balance in your account in Wanwallet GUI or with links below.

Main network：

ETH:

WAN:

Test network：

ETH:

WAN: 13.58.108.244

7) Click the “ETH >> WETH” tab below to send ETH to Wanchain.

Enter your password then press “OK” button to send the transaction.

8) 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

9) 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 8 for details about how to confirm or cancel the transaction.

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