Operators

Create a Wallet

Create a BitSong wallet using the bitsongd CLI for the Crescendo-1 testnet.

If you have the bitsongd binary installed (see Node Setup), you can create a wallet directly from the command line.

Create a Key

Generate a new key

bitsongd keys add my-wallet --keyring-backend test

This outputs your new address (starting with bitsong1) and a 24-word mnemonic phrase.

Save your mnemonic phrase in a safe place. It is the only way to recover your wallet. Anyone with access to your mnemonic has full control of your funds.

Verify your address

bitsongd keys show my-wallet -a --keyring-backend test

This prints your bitsong1... address, which you can use to request testnet tokens.

Check your balance

bitsongd query bank balances $(bitsongd keys show my-wallet -a --keyring-backend test)

Recover an Existing Wallet

If you already have a mnemonic from a previous wallet, you can recover it:

bitsongd keys add my-wallet --recover --keyring-backend test

You will be prompted to enter your 24-word mnemonic phrase.

List All Wallets

bitsongd keys list --keyring-backend test
The --keyring-backend test flag stores keys unencrypted on disk. This is fine for testnets but never use this on mainnet.

Next Steps

Get Testnet Tokens

Request free BTSG tokens from the Crescendo-1 faucet.

Join as Validator

Use your wallet to create a validator and start signing blocks.
Copyright © 2026