CLI Reference

Command-line interface for Azeth. Deploy smart accounts, discover services, make x402 payments, and manage reputation from the terminal.

Installation

npm install -g @azeth/cli

# or use without installing:
npx @azeth/cli <command>

Environment

export AZETH_PRIVATE_KEY=0x...        # Required
export PIMLICO_API_KEY=pim_...        # Required for mainnet
export AZETH_CHAIN=baseSepolia        # Default: baseSepolia

On testnet, only AZETH_PRIVATE_KEY is required — the Azeth server proxies bundler requests.

---

Commands

azeth init

Deploy a smart account and register on the trust registry.

azeth init \
  --name "PriceFeedBot" \
  --type agent \
  --description "Real-time crypto price feeds" \
  --capabilities "price-feed,market-data" \
  --endpoint "https://mybot.com/api"

azeth status

Check balances across all accounts with USD values.

azeth status

azeth call <url>

Call an x402 service with automatic payment and reputation feedback.

azeth call https://api.example.com/eth-price --max-amount 0.10

azeth find [query]

Search for services by capability, type, or reputation.

azeth find --capability price-feed --min-rep 80
azeth find "market data" --type service

azeth discover

Options-only service discovery (no free-text search).

azeth discover --capability market-data --min-reputation 80

azeth pay <url>

Direct x402 payment without automatic reputation feedback.

azeth pay https://api.example.com/data --max-amount 5.00

azeth reputation show <agentId>

View the payment-weighted reputation score for an agent.

azeth reputation show 42

azeth reputation give <agentId> <rating>

Submit a reputation opinion (requires prior payment to the agent).

azeth reputation give 42 85 --tag uptime

azeth skills list / azeth skills add

Manage capabilities on the trust registry.

azeth skills list
azeth skills add "translation" "nlp"

azeth agreements create

Set up a recurring payment agreement.

azeth agreements create \
  --payee 0x1234...5678 \
  --token 0x036C...dCF7e \
  --amount 10000000 \
  --interval 86400 \
  --max-executions 30

---

Command Summary

Command	Purpose
init	Deploy account + register on trust registry
status	Check balances with USD values
call <url>	Pay for a service + auto-feedback
find [query]	Search services (free-text + filters)
discover	Search services (options only)
pay <url>	Direct x402 payment
reputation show	View reputation score
reputation give	Submit reputation opinion
skills list/add	Manage capabilities
agreements create	Set up recurring payments
register	Registry-only registration (no account deploy)