Skip to content

Wanwallet 3.0 Cross chain transactions (BTC, ERC20)

Jump to bottom
albert-fu edited this page Dec 7, 2018 · 1 revision

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.

1) Download

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: wanwalletgui                

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

  • Or click Wanwalletgui to start under /usr/local/bin/

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.

Main network：

Test network：

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

Confirm transaction

Once the “Confirm” button turned red, click it to access “Confirm Transaction” page.

Enter the password then click “OK” button to finalize transaction

Cancel 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"

Home

Getting started

Developer Tools

FAQ

Clone this wiki locally