@t402/cli

# Global install
pnpm add -g @t402/cli
 
# Or run directly
npx @t402/cli

# Create a new wallet
t402 wallet create
 
# Check balances
t402 wallet balance
 
# Make a paid HTTP request (automatic 402 handling)
t402 request https://api.example.com/premium
 
# Send a direct payment
t402 pay 0xRecipientAddress 1.50 --network eip155:8453

t402 wallet create

t402 wallet import "word1 word2 word3 ... word12"

t402 wallet show

# Check default network
t402 wallet balance
 
# Check specific network
t402 wallet balance --network eip155:42161
 
# Show all networks including zero balances
t402 wallet balance --all

t402 wallet export --force

t402 wallet clear --force

t402 pay <to> <amount> [options]

# Pay 1.50 USDT0 on Base
t402 pay 0xRecipient... 1.50
 
# Pay on Arbitrum
t402 pay 0xRecipient... 0.50 --network eip155:42161
 
# Gasless payment (no ETH needed)
t402 pay 0xRecipient... 1.00 --gasless

t402 pay-invoice <url> [options]

# Pay the first payment option
t402 pay-invoice https://api.example.com/premium
 
# Pay with gasless mode, selecting second option
t402 pay-invoice https://api.example.com/data --gasless --index 1

t402 request <url> [options]

# Simple GET with auto-payment
t402 request https://api.example.com/data
 
# POST with body
t402 request https://api.example.com/generate \
  -X POST \
  -H "Content-Type:application/json" \
  -d '{"prompt": "Hello world"}'
 
# Verbose output (shows payment details)
t402 request https://api.example.com/data -v
 
# Dry run (inspect 402 response without paying)
t402 request https://api.example.com/data --dry-run
 
# Save response to file
t402 request https://api.example.com/image -o output.png
 
# Prefer specific network
t402 request https://api.example.com/data --network eip155:42161
 
# Gasless request
t402 request https://api.example.com/data --gasless

1. GET https://api.example.com/data
2. ← 402 Payment Required (accepts: exact, eip155:8453, $0.01)
3. Sign payment authorization (EIP-3009)
4. GET https://api.example.com/data + Payment-Signature header
5. ← 200 OK + response body

t402 config show

t402 config get defaultNetwork
t402 config get facilitatorUrl
t402 config get testnet
t402 config get rpcEndpoints

t402 config set defaultNetwork eip155:42161
t402 config set facilitatorUrl https://my-facilitator.example.com
t402 config set testnet true

t402 config rpc eip155:8453 https://my-base-rpc.example.com
t402 config rpc eip155:42161 https://my-arbitrum-rpc.example.com

t402 config reset --force

t402 config path
# ~/.config/t402/config.json (macOS/Linux)

# Show mainnet networks
t402 info
 
# Show all networks (mainnet + testnet)
t402 info --all
 
# Show testnet networks only
t402 info --testnet

# Gasless direct payment
t402 pay 0xRecipient... 1.00 --gasless
 
# Gasless HTTP request
t402 request https://api.example.com/data --gasless
 
# Gasless invoice payment
t402 pay-invoice https://api.example.com/premium --gasless

# Enable testnet mode
t402 config set testnet true
 
# Network auto-adjusts to testnet equivalent
t402 wallet balance
# Shows Base Sepolia balance instead of Base Mainnet
 
# Make testnet payments
t402 request https://staging.api.example.com/data
 
# Switch back to mainnet
t402 config set testnet false

import { getConfig, setConfig, formatAmount, parseAmount } from '@t402/cli'
 
// Read configuration
const network = getConfig('defaultNetwork')   // "eip155:8453"
const isTestnet = getConfig('testnet')        // false
 
// Set configuration
setConfig('defaultNetwork', 'eip155:42161')
 
// Format amounts
formatAmount('1000000', 6)    // "1.00"
parseAmount('1.50', 6)        // "1500000"

# Morning: Check balances
t402 wallet balance --all
 
# Make API calls throughout the day
t402 request https://api.weather.com/forecast?city=tokyo
t402 request https://api.ai.example.com/generate \
  -X POST -d '{"prompt": "Summarize this article"}'
 
# Pay a specific invoice
t402 pay-invoice https://data.example.com/dataset/2024

# Check balance on specific network
t402 wallet balance --network eip155:42161
 
# Pay on Arbitrum
t402 pay 0xMerchant... 5.00 --network eip155:42161
 
# Request preferring Optimism
t402 request https://api.example.com/data --network eip155:10

# Batch payments from file
while IFS=, read -r address amount; do
  t402 pay "$address" "$amount" --network eip155:8453
done < payments.csv
 
# Check if endpoint requires payment
t402 request https://api.example.com/data --dry-run 2>/dev/null
if [ $? -eq 0 ]; then
  echo "Payment required"
fi