Skip to main content

Create a new Wallet

New wallets can be created a number of ways but this guide will focus on using the archwayd core daemon or the Developer CLI. For installing and accessing archwayd see the Archway Docker installation instructions. For instructions on how to install and setup the developer CLI review our installation guide.


While additional options for creating wallets are covered in this article, 3rd party tools are not supported or maintained by Archway directly

Using the Archway Daemon

The command to add a new account using the archwayd daemon is:

archwayd keys add ${ACCOUNT_LABEL}

Where ${ACCOUNT_LABEL} represents a human readable label for you account. Account labels help keep track of which account is which, especially pertinent if you're managing multiple Archway accounts.

Example account creation:

archwayd keys add demo
Enter keyring passphrase:

- name: demo
type: local
address: archway1cnfpa4n3pnrdfsrj3glmnq08u64mfmgu7nym9t
pubkey: archwaypub1addwnpepqgr0thwj5f4yvmndeqzxw3fvc6avchgvkyufrm5uvmguqjys8zj4guqdpyh
mnemonic: ""
threshold: 0
pubkeys: []

**Important** write this mnemonic phrase in a safe place.
It is the only way to recover your account if you ever forget your password.

# Mnemonic seed words here...

After securing your mnemonic, you can delete your bash history to ensure no one can retrieve it

history -c
rm -rf ~/.bash_history`

Using the Developer CLI

Creating an account with the developer CLI is similar to using the daemon (archwayd), but has the benefit of making it easy to switch between Dockerized and native built versions of Archway core.

Read the developer instructions for creating a wallet

Using a Ledger device (hardware wallet)

When you initialize your Ledger, a 24-word mnemonic is generated and stored in the device. This mnemonic is compatible with Cosmos and Cosmos accounts can be derived from it. The following steps help make your Ledger compatible with the Archway daemon.

  1. Download the Ledger Live app
  2. Connect your Ledger via USB and update to the latest firmware
  3. From the Ledger Live app store, download the Cosmos application. You may have to enable Dev Mode in the settings of Ledger Live to be able to download it.
  4. Navigate to the Cosmos app on your Ledger device
  5. Create your account with the archwayd daemon using the flag --ledger
archwayd keys add ${ACCOUNT_LABEL} --ledger

Creating Ledger accounts will only work if the Ledger is charged, plugged in and unlocked.

Using a Browser Extension (Keplr)

A popular wallet for Cosmos-based coins is Keplr, a wallet that offers a similar user experience to MetaMask on Ethereum. For instructions regarding downloading, installing and setting up Keplr see Keplr's own installation guide

After installing the extension, open Keplr by selecting its icon from your browser toolbar. If you haven't created an account yet, you'll see a screen like this:

Select Create new account to see the following form:

A Mnemonic Seed phrase is generated specifically for your account. Use this phrase to recover your account in the case your browser extension becomes corrupted or you forget your password.

When logged into Keplr with a valid account, the extension presents us with the following screen where we can view account balances and perform actions like sending payments or executing calls to smart contracts.

Viewing and Switching between Cosmos tokens

Select the Cosmos dropdown on top of the window to switch the view to other Cosmos-based crypto tokens.