> For the complete documentation index, see [llms.txt](https://service.block-pro.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://service.block-pro.net/mainnet/dora/useful-commands.md).

# Useful Commands

Everyday Dora Mainnet service, wallet and validator commands.

**Mainnet · `vota-ash` · dorad**

Commands match the [Installation](https://service.block-pro.net/mainnet/dora/installation.md) guide: service `dorad`, home `$HOME/.dora`, key `wallet` and local RPC `http://127.0.0.1:26657`. Replace uppercase placeholders before running a command.

Amounts use `peaka`: **1 DORA = 1000000000000000000 peaka**. Transaction commands estimate gas and ask for confirmation.

## Service operations

### Start the node

Start the systemd service.

```bash
sudo systemctl start dorad
```

### Stop the node

Stop the service cleanly.

```bash
sudo systemctl stop dorad
```

### Restart the node

Restart after an approved configuration change.

```bash
sudo systemctl restart dorad
```

### Service status

Show whether the node is active.

```bash
sudo systemctl status dorad --no-pager -l
```

### Follow logs

Stream logs. Ctrl+C exits the view.

```bash
sudo journalctl -u dorad -f -o cat
```

### Check version

Read the executable of the active `dorad.service` process. Expect `v1.1.0` after the upgrade. The existing BlockPro Mainnet unit uses `/root/go/bin/dorad`.

```bash
systemctl is-active --quiet dorad.service &&
sudo "/proc/$(systemctl show dorad.service -p MainPID --value)/exe" version
```

### Check synchronization

Verify network, latest block and catching\_up.

```bash
curl -fsS http://127.0.0.1:26657/status | jq '.result | {chain: .node_info.network, height: .sync_info.latest_block_height, time: .sync_info.latest_block_time, catching_up: .sync_info.catching_up}'
```

### Count connected peers

Show the local P2P peer count.

```bash
curl -fsS http://127.0.0.1:26657/net_info | jq -r .result.n_peers
```

### Show node ID

Read your public P2P identity.

```bash
dorad comet show-node-id --home "$HOME/.dora"
```

## Key management

Store wallet recovery words privately. Use the restore command only for a wallet you own, and enter the phrase interactively.

### Create a wallet

Create the encrypted wallet key.

```bash
dorad keys add wallet --keyring-backend file --home "$HOME/.dora"
```

### Restore a wallet

Recover an existing key from its mnemonic.

```bash
dorad keys add wallet --recover --keyring-backend file --home "$HOME/.dora"
```

### List keys

List locally stored public key information.

```bash
dorad keys list --keyring-backend file --home "$HOME/.dora"
```

### Show account address

Read the address used for balances and transfers.

```bash
dorad keys show wallet -a --keyring-backend file --home "$HOME/.dora"
```

### Show validator address

Read the operator address used for staking queries.

```bash
dorad keys show wallet --bech val -a --keyring-backend file --home "$HOME/.dora"
```

## Tokens

### Check balance

Query token balances in base units.

```bash
dorad query bank balances "$(dorad keys show wallet -a --keyring-backend file --home "$HOME/.dora")" --node http://127.0.0.1:26657 --output json
```

### Send tokens

Replace RECIPIENT and AMOUNTpeaka. Verify the recipient and amount before confirming.

```bash
dorad tx bank send wallet RECIPIENT AMOUNTpeaka --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Delegate

Replace VALIDATOR\_ADDRESS with a valoper address and set the amount.

```bash
dorad tx staking delegate VALIDATOR_ADDRESS AMOUNTpeaka --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Withdraw rewards

Withdraw delegation rewards from the selected validator.

```bash
dorad tx distribution withdraw-rewards VALIDATOR_ADDRESS --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Redelegate

Move a delegation between validators, subject to network redelegation rules.

```bash
dorad tx staking redelegate SOURCE_VALIDATOR DESTINATION_VALIDATOR AMOUNTpeaka --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Unbond tokens

Begin the unbonding period; tokens are not immediately spendable.

```bash
dorad tx staking unbond VALIDATOR_ADDRESS AMOUNTpeaka --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Check a transaction

Wait for inclusion, then inspect the result before repeating a transfer.

```bash
dorad query tx TX_HASH --node http://127.0.0.1:26657 --output json
```

## Validator operations

Use [Validator](https://service.block-pro.net/mainnet/dora/validator.md) for initial registration. Investigate the reason for jailing before attempting to unjail.

### Validator status

Read staking status and jailed state.

```bash
dorad query staking validator "$(dorad keys show wallet --bech val -a --keyring-backend file --home "$HOME/.dora")" --node http://127.0.0.1:26657 --output json
```

### Consensus public key

Read the public key; do not expose priv\_validator\_key.json.

```bash
dorad comet show-validator --home "$HOME/.dora"
```

### Signing information

List slashing/signing records and find your consensus address.

```bash
dorad query slashing signing-infos --node http://127.0.0.1:26657 --output json
```

### Withdraw commission and rewards

Withdraw for your own validator operator address.

```bash
dorad tx distribution withdraw-rewards "$(dorad keys show wallet --bech val -a --keyring-backend file --home "$HOME/.dora")" --commission --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Edit validator details

Replace the example display name; change only the fields you intend.

```bash
dorad tx staking edit-validator --new-moniker "YOUR_MONIKER" --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Unjail

Run only after fixing downtime and meeting the chain's unjailing conditions. Tombstoned validators cannot be unjailed.

```bash
dorad tx slashing unjail --from wallet --keyring-backend file --home "$HOME/.dora" --chain-id vota-ash --node http://127.0.0.1:26657 --gas auto --gas-adjustment 1.5 --gas-prices 100000000000peaka
```

### Check staking parameters

Read validator limits, denomination and the unbonding time.

```bash
dorad query staking params --node http://127.0.0.1:26657 --output json
```

## Governance and upgrades

### Check the upgrade plan

Read the pending plan from your local node. The approved target is `v1.1.0` at height `18223900`. The plan clears after activation.

```bash
dorad query upgrade plan --node http://127.0.0.1:26657 --output json
```

### Read Proposal #28

Read the passed software-upgrade proposal. Voting is closed.

```bash
dorad query gov proposal 28 --node http://127.0.0.1:26657 --output json
```

The proposal can also be read on the [official explorer](https://vota-explorer.dorafactory.org/doravota/gov/28).

### Check the completed upgrade

On your own node, read the recorded height for `v1.1.0`. After activation, expect `18223900`. A zero or missing result indicates that the node has no completed record for this plan.

```bash
dorad query upgrade applied v1.1.0 --node http://127.0.0.1:26657 --output json
```

[Proposal #28](https://vota-explorer.dorafactory.org/doravota/gov/28) · [Upgrade guide](https://service.block-pro.net/mainnet/dora/upgrade.md) · [Official release](https://github.com/DoraFactory/doravota/releases/tag/v1.1.0)
