CLI Reference

Command-line interface for interacting with Bitplanet blockchain.

Overview

The evmd CLI provides commands for:

• Querying blockchain state

• Submitting transactions

• Managing keys and accounts

• Node configuration and status

Query Commands

Bank Module

Query all balances:

evmd query bank balances cosmos1... --output json

Query specific denomination:

evmd query bank balances cosmos1... --denom bplcoin --output json

Query total supply:

evmd query bank total --output json

Staking Module

Query all validators:

evmd query staking validators --output json | jq

Query specific validator:

evmd query staking validator cosmosvaloper1... --output json

Query delegations:

evmd query staking delegations cosmos1... --output json

Governance Module

Query all proposals:

evmd query gov proposals --output json

Query specific proposal:

evmd query gov proposal 1 --output json

Query votes for proposal:

evmd query gov votes 1 --output json

Distribution Module

Query delegator rewards:

evmd query distribution rewards cosmos1... --output json

Query rewards from specific validator:

evmd query distribution rewards cosmos1... cosmosvaloper1... --output json

Node Status

Check node status:

evmd status | jq

Check sync status:

evmd status | jq '.SyncInfo'

Transaction Commands

Bank Module

Send tokens:

evmd tx bank send acc0 cosmos1... 1000000bplcoin \
  --chain-id 9001 \
  --from acc0 \
  --gas auto \
  --gas-adjustment 1.5 \
  --yes

Staking Module

Delegate to validator:

evmd tx staking delegate cosmosvaloper1... 1000000bplcoin \
  --from acc0 \
  --chain-id 9001 \
  --gas auto \
  --gas-adjustment 1.5 \
  --yes

Undelegate from validator:

evmd tx staking unbond cosmosvaloper1... 1000000bplcoin \
  --from acc0 \
  --chain-id 9001 \
  --gas auto \
  --gas-adjustment 1.5 \
  --yes

Redelegate between validators:

evmd tx staking redelegate \
  cosmosvaloper1_source... \
  cosmosvaloper1_dest... \
  1000000bplcoin \
  --from acc0 \
  --chain-id 9001 \
  --gas auto \
  --gas-adjustment 1.5 \
  --yes

Governance Module

Vote on proposal:

evmd tx gov vote 1 yes \
  --from acc0 \
  --chain-id 9001 \
  --yes

Vote options:

• yes: Vote in favor

• no: Vote against

• abstain: Abstain from voting

• no_with_veto: Vote against with veto power

Submit text proposal:

evmd tx gov submit-proposal \
  --title "Proposal Title" \
  --description "Proposal Description" \
  --type Text \
  --deposit 1000000bplcoin \
  --from acc0 \
  --chain-id 9001 \
  --yes

Distribution Module

Withdraw rewards:

evmd tx distribution withdraw-rewards cosmosvaloper1... \
  --from acc0 \
  --chain-id 9001 \
  --yes

Withdraw all rewards:

evmd tx distribution withdraw-all-rewards \
  --from acc0 \
  --chain-id 9001 \
  --yes

Key Management

List keys:

evmd keys list

Add new key:

evmd keys add mykey

Import key from mnemonic:

evmd keys add mykey --recover

Export key:

evmd keys export mykey

Show key address:

evmd keys show mykey --address

Show key as JSON:

evmd keys show mykey --output json

Gas Configuration

Auto Gas Estimation

--gas auto --gas-adjustment 1.5

The --gas-adjustment multiplier adds a buffer to the estimated gas.

Manual Gas Setting

--gas 200000

Gas Price

--gas-prices 0.001bplcoin

Direct Fee Setting

--fees 1000000bplcoin

Output Formats

JSON output:

--output json

Text output (default):

--output text

Pipe to jq for formatting:

evmd query bank balances cosmos1... --output json | jq

Common Flags

Transaction Flags

• --chain-id: Chain identifier (default: 9001)

• --from: Name or address of key to sign with

• --gas: Gas limit (or "auto" for estimation)

• --gas-adjustment: Gas adjustment multiplier (default: 1.0)

• --gas-prices: Gas prices (e.g., "0.001bplcoin")

• --fees: Transaction fees

• --yes: Skip confirmation prompt

• --broadcast-mode: Transaction broadcast mode (sync, async, block)

Query Flags

• --output: Output format (json, text)

• --height: Block height to query

• --node: RPC endpoint (default: tcp://localhost:26657)

Configuration

Initialize config:

evmd config chain-id 9001
evmd config node tcp://localhost:26657
evmd config output json

View config:

evmd config

Set specific config value:

evmd config <key> <value>

Node Commands

Initialize node:

evmd init <moniker> --chain-id 9001

Start node:

evmd start

Reset node data:

evmd tendermint unsafe-reset-all

Show node ID:

evmd tendermint show-node-id

Show validator info:

evmd tendermint show-validator

---

Related: REST API Reference | gRPC API Reference