> 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/nolus/useful-commands.md).

# Useful Commands

Everyday Nolus service, wallet and validator commands.

**Mainnet · `pirin-1`**

Commands use the `wallet` key name. Transaction examples ask for confirmation. Replace quoted address placeholders and review amounts before signing. `1 NLS = 1,000,000 unls`.

## Service operations

### Status

Check the systemd unit.

```bash
sudo systemctl status nolusd --no-pager
```

### Logs

Follow recent logs.

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

### Restart

Restart the node process.

```bash
sudo systemctl restart nolusd
```

### Stop

Stop the node.

```bash
sudo systemctl stop nolusd
```

### Start

Start the node.

```bash
sudo systemctl start nolusd
```

### Sync status

Check height and catching\_up.

```bash
curl -fsS http://127.0.0.1:26657/status | jq '.result.sync_info'
```

### Version

Show the installed binary version.

```bash
nolusd version --long
```

## Key management

### Create

Create a wallet and securely store its recovery phrase.

```bash
nolusd keys add wallet
```

### Recover

Import a wallet interactively.

```bash
nolusd keys add wallet --recover
```

### List

List local keys.

```bash
nolusd keys list
```

### Address

Show the account address.

```bash
nolusd keys show wallet -a
```

### Balance

Query token balances.

```bash
nolusd query bank balances "$(nolusd keys show wallet -a)"
```

## Tokens

### Send

Send 1 token to the chosen recipient.

```bash
nolusd tx bank send wallet "RECIPIENT_ADDRESS" 1000000unls --chain-id pirin-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.0025unls
```

### Delegate

Delegate 1 token to a validator.

```bash
nolusd tx staking delegate "VALIDATOR_ADDRESS" 1000000unls --from wallet --chain-id pirin-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.0025unls
```

### Withdraw rewards

Withdraw delegation rewards.

```bash
nolusd tx distribution withdraw-all-rewards --from wallet --chain-id pirin-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.0025unls
```

## Validator operations

### Details

Query your validator record.

```bash
nolusd query staking validator "$(nolusd keys show wallet --bech val -a)"
```

### Commission and rewards

Withdraw rewards and validator commission.

```bash
nolusd tx distribution withdraw-rewards "$(nolusd keys show wallet --bech val -a)" --commission --from wallet --chain-id pirin-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.0025unls
```

### Unjail

Use only after correcting the cause of jailing and meeting unjail conditions.

```bash
nolusd tx slashing unjail --from wallet --chain-id pirin-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.0025unls
```

## Governance

### Proposals

List governance proposals.

```bash
nolusd query gov proposals
```

### Vote

Replace 123 with the proposal you have reviewed.

```bash
nolusd tx gov vote 123 yes --from wallet --chain-id pirin-1 --gas auto --gas-adjustment 1.5 --gas-prices 0.0025unls
```
