# CLI Reference

## Quick Reference

| Command | Description | Reference |
|---------|-------------|-----------|
| `balance` | Check SOMA balance | [Common Commands](https://docs.soma.org/reference/cli/common/#balance) |
| `send` | Send SOMA to a recipient | [Common Commands](https://docs.soma.org/reference/cli/common/#send) |
| `transfer` | Transfer an object | [Common Commands](https://docs.soma.org/reference/cli/common/#transfer) |
| `pay` | Pay SOMA to multiple recipients | [Common Commands](https://docs.soma.org/reference/cli/common/#pay) |
| `stake` | Stake SOMA with a validator or model | [Common Commands](https://docs.soma.org/reference/cli/common/#stake) |
| `unstake` | Withdraw staked SOMA | [Common Commands](https://docs.soma.org/reference/cli/common/#unstake) |
| `faucet` | Request test SOMA | [Common Commands](https://docs.soma.org/reference/cli/common/#faucet) |
| `status` | Show network status | [Common Commands](https://docs.soma.org/reference/cli/common/#status) |
| `objects` | Query owned objects | [Query Commands](https://docs.soma.org/reference/cli/queries/#objects) |
| `tx` | Inspect and execute transactions | [Query Commands](https://docs.soma.org/reference/cli/queries/#tx) |
| `wallet` | Manage addresses and keys | [Management Commands](https://docs.soma.org/reference/cli/management/#wallet) |
| `env` | Manage environments | [Management Commands](https://docs.soma.org/reference/cli/management/#env) |
| `model` | Register and manage models | [Submission Commands](https://docs.soma.org/reference/cli/submissions/#model) |
| `target` | List targets and submit data | [Submission Commands](https://docs.soma.org/reference/cli/submissions/#target) |
| `validator` | Validator operations | [Operators & Nodes](https://docs.soma.org/reference/cli/operators/#validator) |
| `start` | Start nodes and services | [Operators & Nodes](https://docs.soma.org/reference/cli/operators/#start) |
| `network` | Inspect network configuration | [Operators & Nodes](https://docs.soma.org/reference/cli/operators/#network) |
| `genesis` | Bootstrap a new network | [Operators & Nodes](https://docs.soma.org/reference/cli/operators/#genesis) |
| `keytool` | Low-level key management | [Operators & Nodes](https://docs.soma.org/reference/cli/operators/#keytool) |
| `completions` | Generate shell completions | [Operators & Nodes](https://docs.soma.org/reference/cli/operators/#completions) |

## Transaction Processing Arguments
**Note:** These flags apply to all state-modifying commands (`send`, `transfer`, `pay`, `stake`, `unstake`, `model commit`, `model reveal`, etc.).

| Option | Description |
|--------|-------------|
| `--tx-digest` | Compute the transaction digest and print it without executing |
| `--simulate` | Perform a dry run (simulation) without executing |
| `--serialize-unsigned-transaction` | Serialize unsigned transaction data as base64 instead of executing |
| `--serialize-signed-transaction` | Serialize signed transaction data as base64 instead of executing |

## Configuration

| File | Description |
|------|-------------|
| `~/.soma/soma.yaml` | Client config: RPC URL, active environment, active address |
| `soma.keystore` | Encrypted keystore for account keys |
| `network-config.yaml` | Local network validator configs (created by `genesis`) |
| `genesis.blob` | Serialized genesis state (created by `genesis`) |
| `fullnode-config.yaml` | Fullnode configuration (created by `start localnet`) |

## Environment Variables

| Variable | Description |
|----------|-------------|
| `RUST_LOG` | Set log verbosity (e.g. `info`, `debug`, `soma=trace`) |