Use Anemos Wallet

Preface

The Anemos Blockchain provides a wallet application that allows users to interact with the Anemos blockchain without the need to run a node. This is ideal for users who do not wish to operate a node but still want to create a personal wallet to manage their funds. This tutorial will guide you step-by-step on how to use the wallet application.

Download

To get started, download and extract the Anemos CLI file from here. Once you have downloaded and extracted the Anemos CLI file, you can proceed to the next step.

Wallet Commands

In this section, we will explore various wallet commands that help you create, manage, and recover your Anemos wallet.

Create a Wallet

To create a new wallet, run the following command:

./anemos-wallet --path <PATH-To-NEW-WALLET> create

anemos-wallet.exe --path <PATH-To-NEW-WALLET> create

Replace <PATH-To-NEW-WALLET> with the file path where you want to create the wallet.

Recover Wallet

If you lose your wallet or forget your password, you can recover it by running this command:

./anemos-wallet --path <PATH-To-NEW-WALLET> recover

anemos-wallet.exe --path <PATH-To-NEW-WALLET> recover

Replace <PATH-To-NEW-WALLET> with the file path where you want to restore the wallet.

Wallet Password

You can change the wallet password by running this command:

./anemos-wallet password

anemos-wallet.exe password

This command changes the password for the default_wallet if there is one, or sets a new password.

Wallet Seed

You can obtain the wallet seed by running this command:

./anemos-wallet seed

anemos-wallet.exe seed

The wallet seed is encrypted within your wallet, and you’ll need to enter the wallet password to access it.

Address Commands

In this section, we’ll cover address commands that help you manage your wallet addresses.

Creating New Address

You can create a new address by running this command:

./anemos-wallet address new

anemos-wallet.exe address new

Based on PIP-8, an address string conducts its type and usage. By default, the above command creates an account address. If you want to create a validator address instead, you can use the --type validator option with the command like this:

./anemos-wallet address new --type validator

anemos-wallet.exe address new --type validator

You can also assign a label to your address to better organize your address book.

List of Addresses

To view the list of wallet addresses, use this command:

./anemos-wallet address all --balance --stake

anemos-wallet.exe address all --balance --stake

• --balance: Displays the balance for each address.
• --stake: Displays the stake for each address.

Both flags are optional and can be used individually or together.

Get Public Key

To obtain the public key for a specific address, run this command:

./anemos-wallet address pub <ADDRESS>

anemos-wallet.exe address pub <ADDRESS>

Replace <ADDRESS> with the address for which you want to retrieve its public key.

Get Private Key

You can get the private key of your address by this command:

./anemos-wallet address priv <ADDRESS>

anemos-wallet.exe address priv <ADDRESS>

Replace <ADDRESS> with the address for which you want to retrieve its private key.

Get Address Balance

You can get the balance of your address by this command:

./anemos-wallet address balance <ADDRESS>

anemos-wallet.exe address balance <ADDRESS>

Replace <ADDRESS> with the address for which you want to retrieve your balance.

Transaction Commands

In this section, we’ll cover transaction commands that help you create, sign, and broadcast transactions on the Anemos Blockchain. You’ll need to provide the password to sign the transaction. Please note that once a transaction is broadcasted, it cannot be reversed.

Sending Transfer Transaction

To create, sign, and broadcast a Transfer transaction, use the following command:

./anemos-wallet send transfer <FROM> <TO> <AMOUNT>

anemos-wallet.exe send transfer <FROM> <TO> <AMOUNT>

In this command, <FROM> should be one of the addresses in your wallet as the sender address, and <TO> is the receiver address.

Sending Bond Transaction

To create, sign, and broadcast a Bond transaction, use the following command:

./anemos-wallet send bond <FROM> <TO> <AMOUNT>

anemos-wallet.exe send bond <FROM> <TO> <AMOUNT>

In this command, <FROM> should be one of the addresses in your wallet as the sender address, and <TO> is the receiver validator address.

If the validator associated with this address does not exist yet, you need to provide the public key to create it:

./anemos-wallet send bond --pub <PUBLIC_KEY> <FROM> <TO> <AMOUNT>

anemos-wallet.exe send bond --pub <PUBLIC_KEY> <FROM> <TO> <AMOUNT>

Replace <PUBLIC_KEY> with the validator’s public key, which is the public key of the <TO> address.

Sending Unbond Transaction

To create, sign, and broadcast a Unbond transaction, use the following command:

./anemos-wallet send unbond <ADDRESS>

anemos-wallet.exe send unbond <ADDRESS>

In this command, <ADDRESS> is the address of the validator that you want to unbond.

Sending Withdraw Transaction

To create, sign, and broadcast a Withdraw transaction, use the following command:

./anemos-wallet send withdraw <FROM> <TO> <AMOUNT>

anemos-wallet.exe send withdraw <FROM> <TO> <AMOUNT>

FAQ

Database is locked (SQLITE_BUSY) Error

This error happens when the wallet database is opened by more than one process at the same time. By default, Anemos node starts the wallet in locked mode, which prevents external tools (like anemos-wallet) from accessing the wallet. This avoids conflicts, but it can cause this error if another tool tries to connect.

To allow external access, change this config and restart the node:

[wallet]
  lock_mode = false