SolClaw — Non-Custodial USDC Payments by Name

What This Does

SolClaw lets AI agents send and receive USDC on Solana using human-readable names instead of wallet addresses. Your keys stay on your machine — the CLI signs transactions locally.

Key Features:

Non-custodial: Your private key never leaves your machine
Name-based: Send to "Alice" instead of base58 addresses
On-chain: Everything stored on Solana, no trusted intermediary
Full-featured: Batch, split, subscriptions, allowances, invoices, spending caps

Quick Start (5 commands)

# 1. Initialize your agent
npx solclaw-cli init --name "MyAgent"

# 2. Get SOL for gas
npx solclaw-cli faucet

# 3. Register on-chain (creates your vault)
npx solclaw-cli register

# 4. Get USDC from Circle faucet -> paste your vault address
#    https://faucet.circle.com (Solana Devnet)

# 5. Send USDC!
npx solclaw-cli send --to "SolClaw" --amount 1 --memo "Hello!"

Already Have a Wallet?

# Import from Solana CLI keypair file
solclaw init --name "MyAgent" --keypair ~/.config/solana/id.json

# Import from base58 private key
solclaw init --name "MyAgent" --private-key "your_base58_private_key..."

# Export your keypair (for backup or migration)
solclaw export                    # base58 format
solclaw export --format json      # Solana CLI format
solclaw export --quiet            # key only, no warnings

CLI Command Reference

Setup Commands

Command	Description
`init --name <n>`	Generate keypair, create config
`register`	Register on-chain, create vault
`faucet`	Request SOL airdrop
`whoami`	Show identity, balances, config

Payment Commands

Command	Description
`send --to <n> --amount <n>`	Send USDC by name
`deposit --amount <n>`	Move USDC from wallet to vault
`withdraw --amount <n>`	Move USDC from vault to wallet
`balance [--name <n>]`	Check USDC balance
`batch --payments <json>`	Pay multiple agents
`split --amount <n> --recipients <json>`	Split proportionally
`refund --to <n> --amount <n> --reason <text>`	Issue refund

Subscriptions

# Create recurring payment
solclaw subscribe create --to "Service" --amount 10 --interval 86400

# Execute due subscription (anyone can crank)
solclaw subscribe execute --sender "Me" --receiver "Service"

# Cancel subscription
solclaw subscribe cancel --receiver "Service"

# List subscriptions
solclaw subscribe list

Allowances (ERC-20 style)

# Approve another agent to pull USDC
solclaw allowance approve --spender "Worker" --amount 100

# Pull from an allowance (spender calls this)
solclaw allowance pull --owner "Boss" --amount 50 --memo "Weekly pay"

# Increase allowance
solclaw allowance increase --spender "Worker" --amount 50

# Revoke allowance
solclaw allowance revoke --spender "Worker"

# Check allowance
solclaw allowance check --owner "Boss" --spender "Worker"

Invoices (Payment Requests)

# Create invoice (request payment)
solclaw invoice create --payer "Client" --amount 100 --memo "Project work"

# Pay an invoice
solclaw invoice pay --id 1

# Reject an invoice
solclaw invoice reject --id 1

# Cancel your invoice
solclaw invoice cancel --id 1

# List invoices
solclaw invoice list --status pending

Safety & Info

# Set daily spending limit
solclaw spending-cap set --limit 100

# Check spending cap
solclaw spending-cap check

# Check reputation score
solclaw reputation

# Transaction history
solclaw history --limit 20

API Endpoints (Read-Only)

The API is stateless and read-only. Use it to query on-chain data.

Endpoint	Method	Description
`/api/health`	GET	Check API status
`/api/balance/:name`	GET	Get vault balance
`/api/resolve/:name`	GET	Resolve name to addresses
`/api/agents`	GET	List all registered agents
`/api/leaderboard`	GET	Top agents by volume
`/api/reputation/:name`	GET	Get reputation score
`/api/subscriptions`	GET	List subscriptions
`/api/due`	GET	Get due subscriptions

Example API Calls

# Check balance
curl https://solclaw.xyz/api/balance/MyAgent

# Get reputation
curl https://solclaw.xyz/api/reputation/MyAgent

# View leaderboard
curl https://solclaw.xyz/api/leaderboard?sort=reputation

Security Model

Non-Custodial: Private keys stored in ~/.config/solclaw/keypair.json with 600 permissions
Local Signing: All transactions signed on your machine
No Server Keys: API is read-only, never touches private keys
On-Chain Authority: Vault operations require wallet signature
Spending Caps: Optional daily limits to prevent runaway spending

Bring Your Own Wallet

SolClaw supports importing existing Solana wallets:

Solana CLI format: --keypair ~/.config/solana/id.json
Base58 private key: --private-key "your_key..."
Export for backup: solclaw export

Your existing wallet works seamlessly with SolClaw. Import once, use the same keypair across tools.

Planned for Mainnet

Phantom/Backpack wallet adapter
Ledger hardware wallet support
Multi-sig vaults

Technical Details

Item	Value
Program ID	`J4qipHcPyaPkVs8ymCLcpgqSDJeoSn3k1LJLK7Q9DZ5H`
USDC Mint	`4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU`
Network	Solana Devnet
CLI Config	`~/.config/solclaw/`

Commerce Loop Example

# 1. Agent registers
solclaw init --name "Merchant"
solclaw faucet && solclaw register

# 2. Merchant creates invoice for customer
solclaw invoice create --payer "Customer" --amount 50 --memo "Order #1234"

# 3. Customer pays invoice
solclaw invoice pay --id 1

# 4. Set up recurring service
solclaw subscribe create --to "Merchant" --amount 10 --interval 2592000

# 5. Check merchant reputation
solclaw reputation --name "Merchant"

Get Devnet Tokens

SOL: https://faucet.solana.com or solclaw faucet
USDC: https://faucet.circle.com → Solana Devnet → paste vault address

solclaw

Safety Notice

Copy this and send it to your AI assistant to learn