Agama Wallet User Guide

From Komodo Platform Wiki
Jump to: navigation, search

This article draft is done, but there are two questions I still have:

1. should we tell people how to find their private keys? does it need to be converted to WIF? I'm unable to get things working properly to be able to test this

2. install instructions that are mentioned on the Agama website mention using the Export Keys setting as part of this initial setup. (If I remember correctly, it's done right after logging into your wallet and activating a coin.) Why? What should people do with the address list and Wif key list?)


Agama Wallet is an accessible, multi-currency wallet that all ages, demographics, and backgrounds can use to manage their cryptocurrency funds. This page will guide you through installing, running, and using Agama Wallet.

Warning: Our wallet is in early beta! Please don’t use it as your primarily cryptocurrency wallet.

1 Installing and running Agama Wallet[edit]

To install and run Agama Wallet on Windows, Mac, or Linux distributions, download the latest installer release for your operating system from the SuperNET website. To install a specific version and view release notes, see the collection of past Agama releases on GitHub. Unzip the downloaded file and run the Agama executable file. Agama Wallet is portable; you can place the extracted Agama folder anywhere and run the Agama application without installing first.

To ensure Agama functions properly, open the following ports in your firewall or router:

  • 7778 (all modes)
  • 7779 (all modes)
  • 7771 (Native mode)

When you run Agama, you must choose an Agama mode. Select Native only to gain extra stability and performance by downloading the entire blockchain or select Normal start to have the option of saving disk space with Basilisk mode. We recommend using Native only the first time you run Agama to make sure it generates your wallet.dat file. After selecting a mode, the login window appears.

2 Logging in to Agama Wallet[edit]

To use Agama Wallet, you can either create a new wallet, log in to a previously created wallet, or import a private key of a wallet you have created and used elsewhere. For more information on using other wallets in Agama, see Importing a wallet's private key.

To create a new Agama Wallet or log into an existing Agama Wallet:

  1. Run the Agama Wallet application. Click Activate coin
  2. Select a cryptocurrency coin type (such as Komodo (KMD)) that you want to access this session. To use multiple currencies, click the plus (+) button to add additional coin types. You can also add other currency types after logging into your wallet. For more information, see Activating multiple currencies.
  3. Select an Agama Wallet mode for each coin type. In this example, we will use Basilisk mode to avoid storing the blockchain. For more information on the different modes, see Agama Operation Modes
  4. Click Activate Coin. If you have an account (a wallet seed), paste or type it in Wallet Seed to open your wallet. If you don’t have a wallet, click Create new wallet and continue with the following steps.
  5. To use a randomly-generated seed, select a wallet seed type. Make sure to securely save and back up your wallet seed and never share your seed with anyone. Encrypting your seed before storing and storing in multiple locations (physical and digital) are other ways to increase security of your seed. 
    • Iguana uses 24-word seeds (256 bits)
    • Waves wallet uses 15-word seeds
    • NXT wallet uses 12-word seeds
  6. To create your own seed, enable Custom wallet seed. Custom seeds may be easier to memorize; however, they are often less secure than a randomly-generated seed. Never use anything meaningful or predictable in your seed (i.e. lyrics, quotes, or phrases) and ensure it's at least 64 characters long. We recommend using a random password generator even when creating a custom wallet seed. 
  7. Copy and paste your wallet seed into Confirm wallet seed. Make sure to save (backup) your wallet seed in two more more safe, private places as seeds are a security measure used to recover your wallet funds if you lose your wallet (and the wallet.dat file) or login information. Wallet seeds ensure no one else can import your wallet information.
  8. Click Register.
  9. On the main login page, enter your Wallet Seed and click Sign In. Your Agama Wallet opens in a new window.

If the operation mode you selected requires downloading the blockchain, you can monitor download progress using the progress bar at the top of the wallet.

When setting up a wallet for the first time, we recommend logging out and logging in a second time with your wallet seed to make sure it's correct and that you saved it properly. Make sure that wallet's address hasn't changed after logging in again.

3 Completing transactions[edit]

Wallet addresses are used to send currency between wallets. They are strings of letters and numbers and are similar to a bank account number, and Your wallet will have a different address for each type of currency and new addresses are generated after each successful transaction for added privacy. All addresses that have been generated for your wallet are associated with your account forever. They are safe to re-use to receive future payments, but we recommend using a unique address for all transactions.

If you want to see all your addresses, click Receive at the top of the wallet. To return to the wallet's main page, click Dashboard

3.1 Receiving currency[edit]

To receive coins, in the Wallets tab, click on the desired currency and then copy your wallet address at the top of the wallet. Give this address to the sender.

3.2 Sending currency[edit]

To send currency:

  1. In the Wallets tab, click the desired currency and mode in the left hand pane, and then click Send at the top of the wallet.
  2. Enter the details of your transaction. Select your address in Send From, enter the receiver's address in Send To, and then enter the amount of coins to send. Adding a transaction Fee is optional.
  3. Click Send to review the amount you are sending, the mandatory transaction fee, and how much the receiver will have added to their wallet, and then click Confirm. Your transaction is processed.

In the Fill Send Form step, you can select between two ways to make and send transactions in Agama (in Basilisk mode):

  1. Disable Alternative send method (sendtoaddressAPI) to create a raw transaction from the local cache data (if available) and use the API for broadcasting signed raw transaction bytes. Enable Don't Send Transaction. Just give me signed transaction bytes. if you want extra privacy. In this case, you will only get a long string (transaction byte) and not broadcast the signed transaction. You can generate these transaction bytes on an offline computer, take the bytes to any other computer, and then broadcast it over the network without using or logging into your wallet. 
  2. Issue the addresses, amount, and fee info to the sendtoaddress API to create the transaction bytes and broadcast. This fetches the latest data from the network instead of looking locally. This method may take more time to process the transaction depending on how many big, unspent transactions there are in that wallet's address. (Enable Alternative send method (sendtoaddressAPI))

4 Activating multiple currencies[edit]

Agama Wallet allows you to use multiple cryptocurrencies at the same time within a single wallet interface.

To add another currency to your wallet, click Activate Coin at the top of the wallet, select the desired currency and Agama Wallet Mode, and then click Activate.

You can also save a preset list of coin types and operation modes that you want to activate again in future sessions. After adding all desired currencies in the Select Coin window, click the arrow ($or;) next to the first currency and select Save Selection. When you start your next session in Agama Wallet, select Load Selection from the same menu to automatically populate the window with your saved currencies and operation modes.

If the operation mode you selected requires downloading the blockchain, you can monitor download progress using the progress bar at the top of the wallet.

5 Importing a wallet's private key[edit]

Importing your private key will allow you to work with a wallet you have created previously. Make sure any private key you import belongs to a wallet containing a currency supported by Agama.

  1. Click on the Iguana avatar on the upper right corner of the Agama window, and then click Settings.
  2. Click Import Keys.
  3. Copy your external wallet private key and paste it into the text field and then click Import Private Key.

You should now be able to see and use your coin balance in the imported wallet.

6 Backing up your wallet[edit]

You must create a backup of your wallet to protect your assets against computer failures, loss, or human error. Store backups of your wallet seed string in two or more safe locations (virtual and physical) to reduce risk as much as possible. We recommend backing up your wallet every time you create an outgoing transaction.

Backup requirements differ depending on what Agama Wallet mode you are running:

Basilisk Mode: Backup wallet seed only. Each seed generates the same address when you log in.

Full Mode: Backup wallet seed only. (Q - no individual address backup required yet?)

Native Mode: Backup secret private keys saved in wallet.dat. These keys are not generated from your seed like in the other modes. You must copy and paste wallet.dat file into another folder each time you generate new addresses. We recommend renaming your new backed up wallet.dat file with the current date, so you always know which file is the latest backup.

Your wallet.dat file is in the following location:

  • Linux: /home/username/.komodo
  • Windows: C:\Users\[CurrentUser]\AppData\Roaming\Komodo  
  • Mac: ~/Library/Application Support/Komodo

Note: If you are having trouble locating the AppData directory in Windows, make sure hidden folders are visible. If you can't find your wallet.dat file, try running Agama in Native mode.

6.1 Backing up wallet.dat[edit]

Once a copy of wallet.dat has been made, encrypt it, and put it in two or more safe locations to reduce risk as much as possible. A basic backup protects against damage and loss, but encrypting your wallet protects against theft. Make sure to backup wallet.dat often to make sure all recent currency change addresses and all new currency addresses are included in your backup.

If storing a wallet backup in the cloud, ensure the storage service always uses password authentication and never stores your encryption key on their servers. If using Dropbox, make sure to encrypt your backup before uploading; Dropbox stores encryption keys on their servers so pre-internet encryption is required for maximum security. Make sure to create a password that is memorable but secure.

7 Recovering a wallet[edit]

To recover a wallet, log in to Agama using your seed. Your seed deterministically produces the same set of private keys. If Agama doesn't recreate your wallet.dat file, try running Agama in Native only mode (and then switch back to Normal start if desired).

8 Getting support and providing feedback[edit]

To get help, visit our Support Page.

If you encounter a bug, you can report it directly to our developers on our Slack channel #testing-agama. Your help is greatly appreciated!