Skip to Content
Welcome to our new docs! šŸŽ‰
OperateKeys & walletsConsensus node keys

Create a wallet with celestia-app

For this guide, we will go over how you can generate a Celestia wallet using celestia-app.

Prerequisites

Note, you do not need to install celestia-node for this tutorial.

Keyring backend

First, create an application CLI configuration file:

celestia-appd config keyring-backend test

keyring-backend configures the keyring’s backend, where the keys are stored.

Options are: os|file|kwallet|pass|test|memory.

You can learn more on the Cosmos documentationĀ  or Go Package documentationĀ .

Create a wallet

You can pick whatever wallet name you want. For our example we used ā€œvalidatorā€ as the wallet name:

celestia-appd keys add validator --interactive

Save the mnemonic output as this is the only way to recover your validator wallet in case you lose it!

To check all your wallets you can run:

celestia-appd keys list

Key management

# listing keys celestia-appd keys list # adding keys celestia-appd keys add <KEY_NAME> # deleting keys celestia-appd keys delete <KEY_NAME> # renaming keys celestia-appd keys rename <CURRENT_KEY_NAME> <NEW_KEY_NAME>

Importing and exporting keys

Import an encrypted and ASCII-armored private key into the local keybase.

celestia-appd keys import <KEY_NAME> <KEY_FILE>

Example usage:

celestia-appd keys import amanda ./keyfile.txt

Export a private key from the local keyring in encrypted and ASCII-armored format:

celestia-appd keys export <KEY_NAME> # you will then be prompted to set a password for the encrypted private key: Enter passphrase to encrypt the exported key:

After you set a password, your encrypted key will be displayed.

Fund a wallet

For the public celestia address, you can fund the previously created wallet via DiscordĀ  by sending this message to either the #mocha-faucet or #arabica-faucet channel:

$request celestia1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Wait to see if you get a confirmation that the tokens have been successfully sent. To check if tokens have arrived successfully to the destination wallet run the command below replacing the public address with your own:

celestia-appd start celestia-appd query bank balances celestia1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Refer to the ports section of the celestia-node troubleshooting page for information on which ports are required to be open on your machine.

Feel stuck? Go to our Discord!

Last updated on