Installing paxd CLI

What is paxd CLI?

The paxd CLI is the command-line tool for interacting with the Paxeer blockchain. It manages wallets, sends transactions, queries network data, and performs validator operations.

Prerequisites

Go 1.23+: Installation instructions are available here.

Installation

To install paxd, locate the version you wish to use on the paxeer releases page.

Then, execute the following commands with the version that you picked:

git clone https://github.com/paxeer-network/paxeer-chain
cd paxeer-chain
git checkout [VERSION]
make install

You can verify that paxd was installed correctly by running:

paxd version

Troubleshooting Installation

If you encounter an error like command not found: paxd, you may need to set your GOPATH environment variable.

Use go env GOPATH to find your GOPATH
Add the following lines to your ~/.bashrc or ~/.zshrc:

export GOPATH=[your GOPATH from step 1]
export PATH=$PATH:$GOPATH/bin

For more information see here.

Command Overview

Run paxd to see all available commands:

paxd
Start paxeer app

Usage:
  paxd [command]

Available Commands:
  add-genesis-account      Add a genesis account to genesis.json
  blocktest                run EF blocktest
  collect-gentxs           Collect genesis txs and output a genesis.json file
  compact                  Compact the application DB fully (only if it is a levelDB)
  config                   Create or query an application CLI configuration file
  debug                    Tool for helping with debugging your application
  ethreplay                replay EVM transactions
  export                   Export state to JSON
  gentx                    Generate a genesis tx carrying a self delegation
  help                     Help about any command
  init                     Initialize private validator, p2p, genesis, and application configuration files
  keys                     Manage your application's keys
  latest_version           Prints the latest version of the app DB
  migrate                  Migrate genesis to a specified target version
  prune                    Prune app history states by keeping the recent heights and deleting old heights
  query                    Querying subcommands
  rollback                 rollback state by one height
  start                    Run the full node
  status                   Query remote node for status
  tools                    A set of useful tools for paxeer chain
  tx                       Transactions subcommands
  validate-genesis         validates the genesis file at the default location or at the location passed as an arg
  version                  Print the application binary version information

Flags:
  -h, --help                help for paxd
      --home string         directory for config and data (default "~/.paxeer")
      --log_format string   The logging format (json|plain)
      --log_level string    The logging level (trace|debug|info|warn|error|fatal|panic)
      --trace               print out full stack trace on errors

Use "paxd [command] --help" for more information about a command.

Adding a Wallet

Create a new wallet:

paxd keys add $NAME

Output:

- name: [YOUR_KEY_NAME]
  type: local
  address: pax1[GENERATED_ADDRESS]
  evm_address: ""
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"[PUBLIC_KEY]"}'
  mnemonic: ""

**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_24_WORD_MNEMONIC_PHRASE]

Please replace $NAME with the name you would like to use for this key. This will generate a seed phrase and store the account in the CLI for use.

Important: Write this mnemonic down and store it in a safe place. Never share your seed phrase with anyone.

Alternatively, if you would like to import an existing seed phrase, you can add the --recover flag:

paxd keys add $NAME --recover

Output:

This will prompt you to enter your seed phrase, allowing you to import an existing wallet into the CLI.

> Enter your bip39 mnemonic
[ENTER_YOUR_EXISTING_MNEMONIC_PHRASE_HERE]

- name: [YOUR_WALLET_NAME]
  type: local
  address: pax1[RECOVERED_ADDRESS]
  evm_address: ""
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"[PUBLIC_KEY]"}'
  mnemonic: ""

EVM Wallet Compatibility

Paxeer supports two coin types:

Coin type 118 (default): Standard Cosmos address format
Coin type 60: Ethereum-compatible address format for EVM wallets

Creating an EVM-Compatible Wallet

paxd keys add $NAME --coin-type=60

Output:

- name: [YOUR_KEY_NAME]
  type: local
  address: pax1[GENERATED_ADDRESS]
  evm_address: ""
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"[PUBLIC_KEY]"}'
  mnemonic: ""

**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_24_WORD_MNEMONIC_PHRASE]

evm_address is shown as empty here because it's only displayed after the key first broadcasts a transaction or is associated on-chain. The 0x address is deterministically derived from the secp256k1 public key.

Importing an Existing EVM Wallet

paxd keys add $NAME --coin-type=60 --recover

Output:

> Enter your bip39 mnemonic
> [ENTER_YOUR_EXISTING_MNEMONIC_PHRASE_HERE]

- name: [YOUR_WALLET_NAME]
  type: local
  address: pax1[RECOVERED_ADDRESS]
  evm_address: ""
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"[PUBLIC_KEY]"}'
  mnemonic: ""

You'll be prompted to enter your existing 12 or 24-word mnemonic phrase.

Use coin type 60 when you want to use the same address across EVM-compatible chains or import from MetaMask. Use the default coin type 118 for standard Cosmos operations.

Managing Wallets

paxd keys list

Output:

- name: [YOUR_WALLET_NAME]
  type: local
  address: pax1[WALLET_ADDRESS]
  evm_address: [EVM_ADDRESS]
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"[PUBLIC_KEY]"}'
  mnemonic: ""
  ...

List all wallets, or show a specific wallet:

paxd keys show $NAME

Output:

- name: [YOUR_WALLET_NAME]
  type: local
  address: pax1[WALLET_ADDRESS]
  evm_address: [EVM_ADDRESS]
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"[PUBLIC_KEY]"}'
  mnemonic: ""

Deleting Wallets

paxd keys delete $NAME

Output:

Key reference will be deleted. Continue? [y/N]: y
Key deleted forever (uh oh!)

This permanently removes the wallet from your local keyring.

Uninstalling paxd

If you need to remove paxd from your system, you can delete the binary from your $GOPATH/bin directory:

rm $(go env GOPATH)/bin/paxd