CLI Reference

The Tenzro CLI (tenzro) provides full control over node operations, wallet management, model serving, staking, governance, identity, payments, agents, and more. All commands communicate with a running tenzro-node via JSON-RPC.

Installation

# macOS / Linux
curl -sSL https://get.tenzro.network | sh

# Or build from source
cargo install --path crates/tenzro-cli

# Verify installation
tenzro version

Global Options

tenzro [OPTIONS] <COMMAND>

Options:
  -v, --verbose        Enable verbose logging
      --format <text|json>  Output format (default: text)
  -h, --help           Show help
  -V, --version        Show version

Command Groups

Command	Description	Subcommands
join	One-click network participation	Provisions identity, wallet, hardware profile
node	Node management	start, stop, status
wallet	Wallet operations	create, import, balance, send, list
model	Model management	list, info, download, serve, stop, delete, endpoints, endpoint
stake	Staking operations	deposit, withdraw, info
governance	On-chain governance	list, propose, vote
provider	Provider management	register, status, models, pricing, list
schedule	Provider availability scheduling	set, show, enable, disable
inference	Inference requests	request, status
identity	TDIP identity management	register, resolve, list, document, add-credential, add-service
payment	Payment protocols (MPP / x402)	challenge, pay, sessions, receipt, info
agent	AI agent operations	register, list, send, spawn, run-task, create-swarm, terminate-swarm, list-templates, spawn-template
canton	Canton/DAML integration	domains, contracts, submit
escrow	Escrow and payment channels	create, release, open-channel, close-channel, delegate, settle, get-settlement
task	Task marketplace	list, post, get, cancel, quote, assign, complete
marketplace	Agent marketplace	list, get, register
skill	Skill registry	list, register, search, use, get
tool	Tool registry (MCP servers)	list, register, search, use, get
token	Token management	create, info, list, balance, wrap, transfer
contract	Contract deployment	deploy
bridge	Cross-chain bridge	quote, execute, status, routes
debridge	deBridge DLN cross-chain	search, create-tx, swap, status
lifi	LI.FI bridge aggregator	chains, tokens, routes, quotes, status
nft	NFT operations (ERC-721/1155)	create-collection, mint, transfer, list
compliance	ERC-3643 compliance	kyc, freeze, unfreeze, attestation
crosschain	ERC-7802 cross-chain tokens	mint, burn
events	Event streaming	subscribe, history, webhooks
crypto	Cryptographic operations	sign, verify, encrypt, decrypt, hash, keygen
tee	TEE operations	detect, attest, verify, seal, unseal, providers
zk	Zero-knowledge proofs	prove, verify, keygen, circuits
custody	MPC wallet custody	create, export, import, rotate, limits, session
app	Application management	register, users, funding, sponsoring, stats
ceremony	ZK trusted setup ceremony	init, contribute, verify, finalize, status

Standalone Commands

Command	Description
chat	Interactive REPL for AI model chat with session history
hardware	Detect and display hardware profile (CPU, GPU, TEE)
set-username	Set your Tenzro username
faucet	Request testnet TNZO tokens (100 TNZO, 24h cooldown)
info	Show network information
version	Show version information

Common Examples

Wallet Operations

# Create a new wallet
tenzro wallet create --name my-wallet

# Import an existing identity (provisions wallet)
tenzro wallet import --did "did:tenzro:human:abc123"

# Check balance (calls eth_getBalance)
tenzro wallet balance

# Send TNZO to another address
tenzro wallet send --to 0xRecipient... --amount 10.0

# List all accounts
tenzro wallet list

Model Serving

# List available models
tenzro model list

# Download a model from HuggingFace
tenzro model download gemma3-270m

# Serve a model (registers as provider + starts serving)
tenzro model serve gemma3-270m

# Interactive chat
tenzro chat gemma3-270m

# Stop serving
tenzro model stop gemma3-270m

Identity and Payments

# Register a human identity
tenzro identity register --type human --name "Alice"

# Register a machine identity
tenzro identity register --type machine --name "trading-bot"

# Create a payment challenge (MPP or x402)
tenzro payment challenge --protocol mpp --amount 1000000000000000000

# Pay via MPP
tenzro payment pay --protocol mpp --challenge-id ch_123...

Staking and Governance

# Stake TNZO as a validator
tenzro stake deposit --amount 10000 --role validator

# Check voting power
tenzro stake info

# List governance proposals
tenzro governance list

# Vote on a proposal
tenzro governance vote --proposal-id prop_001 --vote yes

Agent Operations

# Register a new agent
tenzro agent register --name "research-agent"

# List agent templates in the marketplace
tenzro marketplace list

# Spawn an agent from a template
tenzro agent spawn-template --template-id tmpl_001

# Send a message to another agent
tenzro agent send --to agent_002 --message "Analyze this data"

Output Formats

All commands support --format json for machine-readable output:

# JSON output for scripting
tenzro wallet balance --format json

# Pipe to jq
tenzro model list --format json | jq '.models[].name'

RPC Endpoint

By default, the CLI connects to http://127.0.0.1:8545. Override with the --rpc flag:

# Connect to testnet
tenzro --rpc https://rpc.tenzro.network wallet balance

# Connect to local node on custom port
tenzro --rpc http://127.0.0.1:9545 info

← API Reference Next: SDK Overview →