Skip to main content

Create a New Account (CLI)

Security Notice

⚠️ ALWAYS back up your key and/or mnemonic after creating a new account ⚠️

Store it in a secure location accessible only to you, such as a password manager, or written down in a safe place.

Quickstart tl;dr ​

Add a new wallet:

pocketd keys add $USER

Retrieve the address:

pocketd keys show $USER -a

Table of Contents ​

This guide will walk you through creating a new wallet on the Pocket Network.

What is a keyring backend?​

Before proceeding, it's critical to understand the implications of keyring backends for securing your wallet.

By default, --keyring-backend=test is used for demonstration purposes in this documentation, suitable for initial testing.

In production, operators should consider using a more secure keyring backend such as os, file, or kwallet. For more information on keyring backends, refer to the Cosmos SDK Keyring documentation.

Prerequisites: Install pocketd​

Ensure you have pocketd installed on your system.

Follow the installation guide specific to your operating system.

Creating a new wallet Wallet​

To create a new wallet, use the pocketd keys add command followed by your desired wallet name. This will generate a new address and mnemonic phrase for your wallet.

pocketd keys add <insert-your-desired-wallet-name-here>

After running the command, you'll receive an output similar to the following:

- address: pokt1beef420
  name: myNewWallet
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A31T7iUyr6SwT5Wyy3BNgRqlObq3FqYpW4cTAkfE+6c2"}'
  type: local


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

your seed mnemonic phase here

Backing Up Your Wallet​

After creating your wallet, YOU MUST back up your mnemonic phrase. This phrase is the key to your wallet, and losing it means losing access to your funds.

Here are some tips for securely backing up your mnemonic phrase:

  • Write it down on paper and store it in multiple secure locations.
  • Consider using a password manager to store it digitally, ensuring the service is reputable and secure.
  • Avoid storing it in plaintext on your computer or online services prone to hacking.

🔑 HD Derivation Path​

pocketd supports BIP-0044-compatible HD wallets, with POKT registered under coin_type = 635 (path_component = 0x8000027b). This assignment is defined in SLIP-0044.

The default derivation path used is:

m/44'/635'/0'/0/0

To use this path, run:

pocketd keys add --coin-type=635

You can view additional options with:

pocketd keys add --help

References: