Komodo Swing Wallet User Guide

From Komodo Platform Wiki
Jump to: navigation, search

You can install the Komodo Swing Wallet on Linux, Windows, and MacOS operating systems. Be aware, though, that the MacOS version is still in beta - use at your own risk!

1 About the Komodo Swing Wallet[edit]

The Komod Swing Wallet is designed to provide a simple graphical interface that tracks:

  • the number of Komodo coins you own
  • the interest you earn on coins in your wallet
  • transactions that you make (sending and receiving Komodo coins in your wallet). 

If you need to track multiple currencies, you might find the Agama wallet (still in beta) better suited to your needs.

2 Prerequisites[edit]

Before you install the wallet, you'll need Komodo itself installed on your machine. Follow the instructions on the Komodo Git page at https://github.com/jl777/komodo to clone and install it.

If you have a wallet and/or privatekeys already installed on your machine, make sure you back them up before installing the Komodo Swing Wallet!

3 Install the wallet[edit]

3.1 Linux[edit]

Follow the installation instructions: How To Install Komodo in Linux or  KomodoGUI instructions on GitHub.

3.2 Windows[edit]

  1. Download the latest setup package from https://supernet.org/en/products/komodo-swing-wallet
  2. Click on the Download button under the Windows heading.
  3. Run the downloaded setup file (it should be named something like komodoGUI_setup.exe).
  4. Select an install folder, or click Next to use the default location.
    Let the setup run.
  5. Click Close to finish the installation.

Complete pictorial instruction can be found here: How to use the Swing Wallet

3.3 MacOS (beta)[edit]

  1. Download the latest setup package from https://supernet.org/en/products/komodo-swing-wallet
  2. Click on the Download button under the Mac OS heading.
  3. Unzip and run the downloaded setup file (it should be named something like komodoOSX.zip).
  4. Select an install folder, or click Next to use the default location.
    Let the setup run.
  5. Click Close to finish the installation.

4 Configure the wallet[edit]

4.1 Windows[edit]

If you allow, the Komodo Swing Wallet will automatically create its own configuration file when you first run it. You can also create the configuration file manually.

The configuration file is named komodo.conf and stored in %appdata%\Komodo\.

4.2 Linux[edit]

You can create the configuration file manually using a text editor. See the configuration file walkthrough below for the required settings.

4.3 MacOS[edit]

If you allow, the Komodo Swing Wallet will automatically create its own configuration file when you first run it. You can also create the configuration file manually.

The configuration file is named komodo.conf and stored in ~/Library/Application Support/Komodo.

4.4 Configuration file walkthrough[edit]

4.4.1 Authentication[edit]

Authentication for the network, never give out your password! Normally created automatically with komodorpcuser as username and a generated password.
rpcuser=yourUsername
rpcpassword=yourPasswort_ChangeItToSomethingSecure_525234

4.4.2 Connection details[edit]

Standard settings:

daemon=1
rpcallowip=127.0.0.1
rpcbind=127.0.0.1
server=1

Connect via a SOCKS5 proxy:

proxy=127.0.0.1:9050
Bind to given address and always listen on it:
bind=<addr>

Note: Use [host]:port notation for IPv6.

Bind to given address and whitelist peers connecting to it:

whitebind=<addr>

Note: Use [host]:port notation for IPv6.

Connect to a specific peer:

addnode=78.47.196.146:8333

Use as many addnode= settings as you like.

Set a maximum number of inbound+outbound connections:

maxconnections=

4.5 Install ZCash proving and verifying keys[edit]

This occurs automatically on Windows and MacOS installations.

On Linux installations you'll need to add them manually:

  1. Download the proving key.
  2. Download the verifying key.
  3. Add them to the KomodoGUI installation folder.

5 Run Komodo Swing Wallet[edit]

5.1 Linux[edit]

 

5.2 Windows[edit]

Run the Komodo Swing Wallet by starting KomodoGUI.exe.

When you first run the KomodoGUI program, it will ask permission to create a configuration file. If you allow, it will automatically create the file and then download a proving key and verifying key. You might receive a Windows Firewall warning at some point during this process; ensure that Private networks checkbox is ticked and click Allow access. This will ensure that it can access the internet to download blockchain data. 

5.3 MacOS[edit]

 

6 Import private keys and seeds[edit]

6.1 Import Iguana privatekey and seed[edit]

If you have an existing Komodo wallet with Iguana, you can import the privatekey and seed rather than transferring funds. See Part 4 - Restore KMD private key & Iguana seed in this article: How to Use the Swing Wallet.

7 Transfer KMD to your new Komodo Swing Wallet[edit]

To transfer KMD to your Komodo Swing wallet, you'll need a wallet address. This is analogous to a bank account number, except that you can create multiple address strings that all point to the one wallet.

To use your default address:

  1. Click on the Own addresses tab.
  2. Right-click on the address displayed - it will be a string of letters and numbers something like this: RH6VLpseC2KnW7bTe5mWrcL8xguDGNva72 - and select Copy value from the menu.

To use a new address:

  1. Click on the Own addresses tab.
  2. Click on either New T (Transparent) address or New Z (Private) address.
  3. Right-click on the address displayed - it will be a string of letters and numbers something like this: RH6VLpseC2KnW7bTe5mWrcL8xguDGNva72 - and select Copy value from the menu.

7.1 Transparent vs private addresses[edit]

There are two types of wallet address available in Zcash: transparent and private. Transparent addresses are similar to Bitcoin addresses; they're visible in the blockchain and can be viewed by users who are currently verifying a particular transaction. Private addresses, on the other hand, fully utilize Zcash's zero-knowledge proving system, and therefore can't be viewed by other users.

8 Back up your Komodo Swing Wallet[edit]

We recommend that you back up your wallet regularly. To do this, just copy the wallet.dat file to a safe location (for example, an encrypted memory stick).

The wallet.dat file is located:

  • Linux: /home/username/.komodo
  • Windows: %AppData\Roaming\Komodo
  • Mac: ~/Library/Application Support/Komodo

9 Troubleshooting[edit]

9.1 My wallet takes too long to load[edit]

The Komodo Swing wallet loads a blockchain index every time it starts. If you're finding that this takes too much time, and you can't solve it by improving network or CPU access, you might find that the Agama wallet is a better choice for you. It's currently in beta, but it does allow for basilisk mode, a lightweight operations mode that does not download blockchains.

9.2 How can I tell if I'm earning interest?[edit]

See this support article: How to double-check you are getting interest using lockTime.