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'

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.

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