Celestia CLI Cheatsheet

This cheatsheet provides a collection of commonly used CLI commands for Celestia node operators. It’s designed for easy copying and pasting, with a few conventions:

  • Capitalized words are placeholders.
  • Use specific endpoints for consistency.
  • Always include --chain-id and --node flags.
  • Query commands output in JSON format and are piped through jq.

Account Management

  • Create a New Account: 

        celestia-appd keys add <account_name> --keyring-backend <keyring_backend>

  • List All Accounts: 

        celestia-appd keys list --keyring-backend <keyring_backend>

  • Show Account Details: 

        celestia-appd keys show <account_name> --keyring-backend <keyring_backend>

Bank: Send Tokens 

    celestia-appd tx bank send <sender_address> <receiver_address> <amount>utia \
  --chain-id celestia \
  --node https://celestia-rpc.chainroot.io:443 --gas=auto --gas-adjustment=1.5 \
  --from <your_key>

Staking: Delegate Tokens 

    celestia-appd tx staking delegate <validator_address> <amount>utia \
  --chain-id celestia \
  --node https://celestia-rpc.chainroot.io:443 --gas=auto --gas-adjustment=1.5 \
  --from <your_key>

Governance: Vote on Proposal 

    celestia-appd tx gov vote PROPOSAL_NUMBER VOTE_OPTION \
  --chain-id celestia \
  --node https://celestia-rpc.chainroot.io:443 --gas=auto --gas-adjustment=1.5 \
  --from <your_key>
  • Note: VOTE_OPTION can be yes, no, no_with_veto, or abstain.

Querying the Blockchain

  • Get Blockchain Status: 

        celestia-appd status

  • Query Account Balances: 

        celestia-appd query bank balances <account_address> --chain-id celestia --node https://celestia-rpc.chainroot.io:443

Advanced Commands

  • Simulate a Transaction: 

        celestia-appd tx simulate --from <your_key> [additional flags]

  • Broadcast a Transaction: 

        celestia-appd tx broadcast <tx_file> --chain-id celestia --node https://celestia-rpc.chainroot.io:443

Remember, always double-check your commands and configurations. For a complete list of commands and options, use celestia-appd --help or consult the Celestia documentation.