Node RequirementsTo use the query and tx commands, your evmd node must either:
  • Be fully synced with the network you’re interacting with, OR
  • Be configured to use an external RPC endpoint in ~/.evmd/config/client.toml
Example client.toml configuration:
# The network chain ID
chain-id = "myapp-1"
# The keyring's backend
keyring-backend = "os"
# CLI output format
output = "text"
# <host>:<port> to CometBFT RPC interface for this chain
node = "tcp://localhost:26657"
# Transaction broadcasting mode (sync|async)
broadcast-mode = "sync"
To use an external RPC, update the node field to point to a public or private RPC endpoint.

​
Global Flags

These flags are available for all commands:
FlagDescriptionDefault
-b, --broadcast-modeTransaction broadcasting mode (sync|async)sync
--chain-idSpecify Chain ID for sending Tx
--feesFees to pay along with transaction (e.g., 10atest)
--fromName or address of private key with which to sign
--gas-adjustmentAdjustment factor to multiply against the estimate returned by tx simulation1
--gas-pricesGas prices to determine the transaction fee (e.g., 10atest)
--homeDirectory for config and data~/.evmd
--keyring-backendSelect keyring’s backendos
--log_formatThe logging format (json|plain)plain
--log_levelThe logging levelinfo
--log_no_colorDisable colored logs
--node<host>:<port> to CometBFT RPC interfacetcp://localhost:26657
--tracePrint out full stack trace on errors

​
Commands

​
Starting the Node

evmd start

​
Node Initialization

evmd init my-node --chain-id cosmos-evm-1

​
Node Status

evmd status

​
Transaction Indexing

evmd index-eth-tx forward

​
Examples

​
Complete Workflows

# Create new Cosmos account
evmd keys add my-account

# Save mnemonic safely!
# Address will be shown as cosmos1...

​
Configuration

  • Configuration directory: ~/.evmd/
  • Key storage: Managed by the keyring backend (os, file, test)
  • Node configuration: ~/.evmd/config/config.toml
  • App configuration: ~/.evmd/config/app.toml
If you use the --home flag upon initializing the light client, the root/config directory will be generated there