# Useful Command

### 🔑 Key management <a href="#key-management" id="key-management"></a>

**Add new key**

```
achillesd keys add wallet
```

**Recover existing key**

```
achillesd keys add wallet --recover
```

**List all keys**

```
achillesd keys list
```

**Delete key**

```
achillesd keys delete wallet
```

**Export key to a file**

```
achillesd keys export wallet
```

**Import key from a file**

```
achillesd keys import wallet wallet.backup
```

**Query wallet balance**

```
achillesd q bank balances $(achillesd keys show wallet -a)
```

### 👷 Validator management <a href="#validator-management" id="validator-management"></a>

Please make sure you have adjusted **moniker**, **identity**, **details** and **website** to match your values.

**Create new validator**

```
achillesd tx staking create-validator <(cat <<EOF
{
  "pubkey": $(lumerad comet show-validator),
  "amount": "1000000uodis",
  "moniker": "YOUR_MONIKER_NAME",
  "identity": "YOUR_KEYBASE_ID",
  "website": "YOUR_WEBSITE_URL",
  "security": "YOUR_SECURITY_EMAIL",
  "details": "YOUR_DETAILS",
  "commission-rate": "0.05",
  "commission-max-rate": "0.20",
  "commission-max-change-rate": "0.05",
  "min-self-delegation": "1"
}
EOF
) \
--chain-id ithaca-1 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.25uodis \
-y
```

**Edit existing validator**

```
achillesd tx staking edit-validator \
--new-moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id ithaca-1 \
--commission-rate 0.05 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.25uodis \
-y
```

**Unjail validator**

```
achillesd tx slashing unjail --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Jail reason**

```
achillesd query slashing signing-info $(achillesd comet show-validator)
```

**List all active validators**

```
achillesd q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
```

**List all inactive validators**

```
achillesd q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
```

**View validator details**

```
achillesd q staking validator $(achillesd keys show wallet --bech val -a)
```

### 💲 Token management <a href="#token-management" id="token-management"></a>

**Withdraw rewards from all validators**

```
achillesd tx distribution withdraw-all-rewards --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Withdraw commission and rewards from your validator**

```
achillesd tx distribution withdraw-rewards $(achillesd keys show wallet --bech val -a) --commission --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Delegate tokens to yourself**

```
achillesd tx staking delegate $(achillesd keys show wallet --bech val -a) 1000000uodis --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Delegate tokens to validator**

```
achillesd tx staking delegate <TO_VALOPER_ADDRESS> 1000000uodis --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Redelegate tokens to another validator**

```
achillesd tx staking redelegate $(achillesd keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000uodis --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Unbond tokens from your validator**

```
achillesd tx staking unbond $(achillesd  keys show wallet --bech val -a) 1000000uodis --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Send tokens to the wallet**

```
achillesd tx bank send wallet <TO_WALLET_ADDRESS> 1000000uodis--from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

### 🗳 Governance <a href="#governance" id="governance"></a>

**List all proposals**

```
achillesd query gov proposals
```

**View proposal by id**

```
achillesd query gov proposal 1
```

**Vote ‘Yes’**

```
achillesd tx gov vote 1 yes --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Vote ‘No’**

```
achillesd tx gov vote 1 no --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Vote ‘Abstain’**

```
achillesd tx gov vote 1 abstain --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

**Vote ‘NoWithVeto’**

```
achillesd tx gov vote 1 NoWithVeto --from wallet --chain-id ithaca-1 --gas-adjustment 1.4 --gas auto --gas-prices 0.25uodis -y
```

### ⚡️ Utility <a href="#utility" id="utility"></a>

**Update ports**

```
CUSTOM_PORT=110
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}58\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}57\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}60\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}56\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}66\"%" $HOME/.achilles/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}17\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}80\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}90\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}91\"%" $HOME/.achilles/config/app.toml
```

**Update Indexer**

**Disable indexer**

```
sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.achilles/config/config.toml
```

**Enable indexer**

```
sed -i -e 's|^indexer *=.*|indexer = "kv"|' $HOME/.achilles/config/config.toml
```

**Update pruning**

```
sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
  $HOME/.achilles/config/app.toml
```

### 🚨 Maintenance <a href="#maintenance" id="maintenance"></a>

**Get validator info**

```
achillesd status 2>&1 | jq .ValidatorInfo
```

**Get sync info**

```
achillesd status 2>&1 | jq .SyncInfo
```

**Get node peer**

```
echo $(achillesd comet show-node-id)'@'$(curl -4s ifconfig.me)':'$(cat $HOME/.achilles/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
```

**Check if validator key is correct**

```
[[ $(achillesd q staking validator $(achillesd keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(achillesd status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"
```

**Get live peers**

```
curl -sS http://localhost:16957/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
```

**Set minimum gas price**

```
sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.25uodis\"/" $HOME/.achilles/config/app.toml
```

**Enable prometheus**

```
sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.achilles/config/config.toml
```

**Reset chain data**

```
achillesd comet unsafe-reset-all --keep-addr-book --home $HOME/.achilles --keep-addr-book
```

**Remove node**

Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your **priv\_validator\_key.json**!

```
cd $HOME
sudo systemctl stop achilles.service
sudo systemctl disable achilles.service
sudo rm /etc/systemd/system/achilles.service
sudo systemctl daemon-reload
rm -f $(which achilles)
rm -rf $HOME/.achilles
rm -rf $HOME/Achilles
```

### ⚙️ Service Management <a href="#service-management" id="service-management"></a>

**Reload service configuration**

```
sudo systemctl daemon-reload
```

**Enable service**

```
sudo systemctl enable achilles.service
```

**Disable service**

```
sudo systemctl disable achilles.service
```

**Start service**

```
sudo systemctl start achilles.service
```

**Stop service**

```
sudo systemctl stop achilles.service
```

**Restart service**

```
sudo systemctl restart achilles.service
```

**Check service status**

```
sudo systemctl status achilles.service
```

**Check service logs**

```
sudo journalctl -u achilles.service -f --no-hostname -o cat
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.codeblocklabs.com/blockchain-nodes/odiseo/useful-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.