CLI Reference

Complete reference for the nonos command-line interface.

---

Global Options

nonos [OPTIONS] <COMMAND>

Option	Short	Description
--config <PATH>	-c	Custom config file path
--data-dir <PATH>	-d	Custom data directory
--log-level <LEVEL>	-l	Log level: trace, debug, info, warn, error
--quiet	-q	Suppress non-essential output
--json	-j	Output in JSON format
--version	-V	Print version information
--help	-h	Print help information

---

Commands

Node Operations

nonos init

Initialize a new node configuration.

nonos init [OPTIONS]

Option	Description
--reward-address <ADDR>	Ethereum address for rewards (required)
--name <NAME>	Human-readable node name
--force	Overwrite existing configuration

Example:

nonos init --reward-address 0x742d35Cc6634C0532925a3b844Bc9e7595f8A888 --name "my-node"

---

nonos run

Start the daemon.

nonos run [OPTIONS]

Option	Description
--systemd	Enable systemd integration (notify, watchdog)
--foreground	Run in foreground (default)
--pidfile <PATH>	Write PID to file

Example:

nonos run --systemd

---

nonos stop

Stop a running daemon.

nonos stop [OPTIONS]

Option	Description
--graceful	Wait for pending operations (default)
--force	Immediate shutdown
--timeout <SECS>	Graceful shutdown timeout

---

nonos status

Check daemon status.

nonos status [OPTIONS]

Option	Description
--watch	Continuous status updates
--interval <SECS>	Update interval for --watch

Output:

NONOS Status
══════════════════════════════════════════════════════
Status:     Running
Uptime:     2d 14h 32m
Node ID:    12D3KooWGzB...
Peers:      47 connected
Quality:    94.2%
Stake:      50,000 NOX (Gold)
Rewards:    127.5 NOX pending
══════════════════════════════════════════════════════

---

nonos info

Display detailed node information.

nonos info [OPTIONS]

Option	Description
--full	Include all details
--network	Network information only
--identity	Identity information only

---

Staking Commands

nonos stake status

Show current staking status.

nonos stake status

Output:

Stake Status
══════════════════════════════════════════════════════
Address:        0x742d35Cc6634C0532925a3b844Bc9e7595f8A888
Staked:         50,000 NOX
Tier:           Gold (1.5x multiplier)
Available:      5,000 NOX (in wallet)
Pending:        0 NOX
══════════════════════════════════════════════════════

---

nonos stake deposit

Deposit NOX tokens to stake.

nonos stake deposit <AMOUNT> [OPTIONS]

Option	Description
--max	Deposit entire wallet balance
--gas-price <GWEI>	Custom gas price
--dry-run	Simulate without executing

Example:

nonos stake deposit 10000
nonos stake deposit --max

---

nonos stake withdraw

Withdraw staked NOX tokens.

nonos stake withdraw <AMOUNT> [OPTIONS]

Option	Description
--all	Withdraw entire stake
--force	Skip confirmation

Example:

nonos stake withdraw 5000
nonos stake withdraw --all

---

nonos stake tiers

Display staking tier information.

nonos stake tiers

Output:

Staking Tiers
══════════════════════════════════════════════════════
  Tier       │ Minimum      │ Multiplier │ Status
─────────────┼──────────────┼────────────┼────────────
  Bronze     │ 1,000 NOX    │ 1.0x       │
  Silver     │ 10,000 NOX   │ 1.2x       │
▸ Gold       │ 50,000 NOX   │ 1.5x       │ CURRENT
  Platinum   │ 200,000 NOX  │ 2.0x       │
  Diamond    │ 1,000,000 NOX│ 2.5x       │
══════════════════════════════════════════════════════

---

nonos stake tier

Change staking tier.

nonos stake tier <TIER>

Tiers: bronze, silver, gold, platinum, diamond

Example:

nonos stake tier platinum

---

Rewards Commands

nonos rewards status

Show pending rewards.

nonos rewards status [OPTIONS]

Option	Description
--epoch	Show current epoch details

Output:

Rewards Status
══════════════════════════════════════════════════════
Pending:        127.5 NOX
Current Epoch:  #42 (Day 5 of 7)
Quality Score:  94.2%
Streak:         3 epochs (+15% bonus)
Est. Epoch:     ~180 NOX
══════════════════════════════════════════════════════

---

nonos rewards claim

Claim pending rewards.

nonos rewards claim [OPTIONS]

Option	Description
--gas-price <GWEI>	Custom gas price
--dry-run	Simulate without executing

---

nonos rewards history

Show reward history.

nonos rewards history [OPTIONS]

Option	Description
--limit <N>	Number of entries (default: 10)
--epoch <N>	Show specific epoch
--csv	Output as CSV

---

nonos rewards auto

Configure auto-claiming.

nonos rewards auto [OPTIONS]

Option	Description
--enable	Enable auto-claim
--disable	Disable auto-claim
--threshold <NOX>	Minimum to trigger claim

Example:

nonos rewards auto --enable --threshold 100

---

Network Commands

nonos peers list

List connected peers.

nonos peers list [OPTIONS]

Option	Description
--limit <N>	Number of peers to show
--sort <FIELD>	Sort by: latency, uptime, quality

Output:

Connected Peers (47)
══════════════════════════════════════════════════════
  Peer ID          │ Latency  │ Region    │ Quality
───────────────────┼──────────┼───────────┼──────────
  12D3KooWHxB...   │ 12ms     │ EU-West   │ 98%
  12D3KooWGz3...   │ 45ms     │ US-East   │ 95%
  12D3KooWPq1...   │ 89ms     │ Asia-SE   │ 92%
  ...
══════════════════════════════════════════════════════

---

nonos peers connect

Manually connect to a peer.

nonos peers connect <MULTIADDR>

Example:

nonos peers connect /dns4/node.example.com/tcp/9000/p2p/12D3KooWHxB...

---

nonos peers disconnect

Disconnect from a peer.

nonos peers disconnect <PEER_ID>

---

Identity Commands

nonos identity generate

Generate a new ZK identity.

nonos identity generate [OPTIONS]

Option	Description
--name <NAME>	Human-readable label

---

nonos identity list

List all identities.

nonos identity list

Output:

ZK Identities
══════════════════════════════════════════════════════
  ID    │ Name       │ Created     │ Status
────────┼────────────┼─────────────┼──────────
  #1    │ default    │ 2024-01-15  │ Active
  #2    │ shopping   │ 2024-02-20  │ Active
  #3    │ old-id     │ 2023-11-01  │ Revoked
══════════════════════════════════════════════════════

---

nonos identity prove

Generate a membership proof.

nonos identity prove <ID> [OPTIONS]

Option	Description
--nullifier <HEX>	Specific nullifier to use
--output <FILE>	Write proof to file

---

nonos identity revoke

Revoke an identity.

nonos identity revoke <ID> [OPTIONS]

Option	Description
--force	Skip confirmation

---

Diagnostic Commands

nonos check

Run diagnostic checks.

nonos check [COMPONENT]

Components: all, network, storage, hardware, config

Example:

nonos check
nonos check network

Output:

NONOS Diagnostics
══════════════════════════════════════════════════════
  Check              │ Status  │ Details
─────────────────────┼─────────┼─────────────────────
  Configuration      │ ✓ OK    │ Valid config.toml
  Node Identity      │ ✓ OK    │ Keys loaded
  Network Port       │ ✓ OK    │ 9000/tcp accessible
  Bootstrap Peers    │ ✓ OK    │ 3 reachable
  Ethereum RPC       │ ✓ OK    │ Connected
  Storage            │ ✓ OK    │ 45 GB available
  Hardware           │ ⚠ WARN  │ 3.5 GB RAM (4 GB rec.)
══════════════════════════════════════════════════════

---

nonos stats

Show network statistics.

nonos stats [OPTIONS]

Option	Description
--live	Real-time updates
--interval <SECS>	Update interval

---

nonos logs

View daemon logs.

nonos logs [OPTIONS]

Option	Description
--follow	Stream new logs
--lines <N>	Number of lines
--level <LEVEL>	Filter by level
--component <NAME>	Filter by component

---

Dashboard

nonos dash

Launch the TUI dashboard.

nonos dash [OPTIONS]

Option	Description
--refresh <MS>	Refresh rate (default: 1000)

Features:

• Real-time metrics visualization

• Peer map

• Reward tracking

• Log viewer

• Quality score graphs

---

Configuration Commands

nonos config show

Display current configuration.

nonos config show [SECTION]

Sections: all, node, network, staking, rewards, services

---

nonos config set

Set a configuration value.

nonos config set <KEY> <VALUE>

Example:

nonos config set node.name "my-new-name"
nonos config set services.cache_size_mb 512

---

nonos config reset

Reset configuration to defaults.

nonos config reset [OPTIONS]

Option	Description
--keep-identity	Preserve node identity

---

System Integration

nonos systemd

Generate systemd service file.

nonos systemd [OPTIONS]

Option	Description
--output-dir <PATH>	Output directory
--user <USER>	Service user
--install	Install and enable service

---

Environment Variables

Variable	Description	Default
NONOS_WALLET_KEY	Ethereum private key	Required
NONOS_DATA_DIR	Data directory	~/.nonos
NONOS_CONFIG	Config file path	~/.nonos/config.toml
NONOS_API_PORT	API port	8420
NONOS_P2P_PORT	P2P port	9000
NONOS_LOG_LEVEL	Log level	info
NONOS_RPC_URL	Ethereum RPC URL	Public node

Exit Codes

Code	Meaning
0	Success
1	General error
2	Configuration error
3	Network error
4	Blockchain error
5	Insufficient stake
126	Permission denied
127	Command not found

---

See also: Configuration Guide for detailed configuration options