# Commands

This section describes the commands available from terrad, the command line interface that connects a running terrad process.

# add-genesis-account

Adds a genesis account to genesis.json.

Syntax

terrad add-genesis-account <address-or-key-name> '<amount><coin-denominator>,<amount><coin-denominator>'

Example

terrad add-genesis-account acc1 '200000000uluna,550000ukrw'

# collect-gentxs

Collects genesis transactions and outputs them to genesis.json.

Syntax

terrad collect-gentxs

# debug

Helps debug the application. For a list of syntax and subcommands, see the debug subcommands.

# export

Exports the state to JSON.

Syntax

terrad export

# gentx

Adds a genesis transaction to genesis.json.

Syntax

terrad gentx <key-name> <amount><coin-denominator>

Example

terrad gentx myKey 1000000uluna --home=/path/to/home/dir --keyring-backend=os --chain-id=test-chain-1 \
    --moniker="myValidator" \
    --commission-max-change-rate=0.01 \
    --commission-max-rate=1.0 \
    --commission-rate=0.07 \
    --details="..." \
    --security-contact="..." \
    --website="..."

# help

Shows help information.

Syntax

terrad help

# init

Initializes the configuration files for a validator and a node.

Syntax

terrad init <moniker>

Example

terrad init myNode

# keys

Manages Keyring commands. For a list of syntax and subcommands, see the keys subcommands.

# migrate

Migrates the source genesis into the target version and prints to STDOUT.

Syntax

terrad migrate <path-to-genesis-file>

Example

terrad migrate /genesis.json --chain-id=testnet --genesis-time=2020-04-19T17:00:00Z --initial-height=4000

# query

Manages queries. For a list of syntax and subcommands, see the query subcommands.

# rosetta

Creates a Rosetta server.

Syntax

terrad rosetta

# start

Runs the full node application with Tendermint in or out of process. By default, the application runs with Tendermint in process.

Syntax

terrad start

# status

Displays the status of a remote node.

Syntax

terrad status

# tendermint

Manages the Tendermint protocol. For a list of subcommands, see

# testnet

Creates a testnet with the specified number of directories and populates each directory with the necessary files.

Syntax

terrad testnet

Example

terrad testnet --v 6 --output-dir ./output --starting-ip-address 192.168.10.2

# tx

Retrieves a transaction by its hash, account sequence, or signature. For a list of full syntax and subcommands, see the tx subcommands.

Syntax to query by hash

terrad query tx <hash>

Syntax to query by account sequence

terrad query tx --type=acc_seq <address>:<sequence>

Syntax to query by signature

terrad query tx --type=signature <sig1_base64,sig2_base64...>

# txs

Retrieves transactions that match the specified events where results are paginated.

Syntax

terrad query txs --events '<event>' --page <page-number> --limit <number-of-results>

Example

terrad query txs --events 'message.sender=cosmos1...&message.action=withdraw_delegator_reward' --page 1 --limit 30

# unsafe-reset-all

Resets the blockchain database, removes address book files, and resets data/priv_validator_state.json to the genesis state.

Syntax

terrad unsafe-reset-all

# validate-genesis

Validates the genesis file at the default location or at the location specified.

Syntax

terrad validate-genesis </path-to-file>

Example

terrad validate-genesis </genesis.json>

# version

Returns the version of Terra you're running.

Syntax

terrad version