solclaw

SolClaw — Non-Custodial USDC Payments by Name What This Does

SolClaw lets AI 代理s 发送 and 接收 USDC on Solana using human-readable names instead of wallet 添加resses. Your keys stay on your machine — the 命令行工具 签名s transactions locally.

Key Features:

Non-custodial: Your private key never leaves your machine Name-based: 发送 to "Alice" instead of base58 添加resses On-chAIn: Everything stored on Solana, no trusted intermediary Full-featured: Batch, split, subscriptions, allowances, invoices, spending caps Quick 启动 (5 commands) # 1. 初始化 your 代理 npx solclaw-命令行工具 init --name "My代理"

# 2. 获取 SOL for gas npx solclaw-命令行工具 faucet

# 3. Register on-chAIn (创建s your vault) npx solclaw-命令行工具 register

# 4. 获取 USDC from Circle faucet -> paste your vault 添加ress # https://faucet.circle.com (Solana Devnet)

# 5. 发送 USDC! npx solclaw-命令行工具 发送 --to "SolClaw" --amount 1 --memo "Hello!"

Already Have a Wallet? # 导入 from Solana 命令行工具 keypAIr file solclaw init --name "My代理" --keypAIr ~/.config/solana/id.json

# 导入 from base58 private key solclaw init --name "My代理" --private-key "your_base58_private_key..."

# 导出 your keypAIr (for 备份 or 迁移) solclaw 导出 # base58 格式化 solclaw 导出 --格式化 json # Solana 命令行工具 格式化 solclaw 导出 --quiet # key only, no 警告s

命令行工具 Command Reference 设置up Commands Command Description init --name 生成 keypAIr, 创建 config register Register on-chAIn, 创建 vault faucet 请求 SOL AIrdrop whoami Show 身份, balances, config Payment Commands Command Description 发送 --to --amount 发送 USDC by name deposit --amount Move USDC from wallet to vault withdraw --amount Move USDC from vault to wallet balance [--name ] 检查 USDC balance batch --payments Pay multiple 代理s split --amount --recipients Split proportionally refund --to --amount --reason Issue refund Subscriptions # 创建 recurring payment solclaw subscribe 创建 --to "服务" --amount 10 --interval 86400

# 执行 due subscription (anyone can crank) solclaw subscribe 执行 --发送er "Me" --接收r "服务"

# Cancel subscription solclaw subscribe cancel --接收r "服务"

# 列出 subscriptions solclaw subscribe 列出

Allowances (ERC-20 style) # 应用rove another 代理 to pull USDC solclaw allowance 应用rove --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"

# 检查 allowance solclaw allowance 检查 --owner "Boss" --spender "Worker"

Invoices (Payment 请求s) # 创建 invoice (请求 payment) solclaw invoice 创建 --payer "命令行工具ent" --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

# 列出 invoices solclaw invoice 列出 --状态 pending

Safety & 信息 # 设置 dAIly spending limit solclaw spending-cap 设置 --limit 100

# 检查 spending cap solclaw spending-cap 检查

# 检查 reputation score solclaw reputation

# Transaction 历史 solclaw 历史 --limit 20

API 端点s (Read-Only)

The API is 状态less and read-only. Use it to 查询 on-chAIn data.

端点 Method Description /API/健康 获取 检查 API 状态 /API/balance/:name 获取 获取 vault balance /API/resolve/:name 获取 Resolve name to 添加resses /API/代理s 获取 列出 all registered 代理s /API/leaderboard 获取 Top 代理s by volume /API/reputation/:name 获取 获取 reputation score /API/subscriptions 获取 列出 subscriptions /API/due 获取 获取 due subscriptions Example API Calls # 检查 balance curl https://solclaw.xyz/API/balance/My代理

# 获取 reputation curl https://solclaw.xyz/API/reputation/My代理

# View leaderboard curl https://solclaw.xyz/API/leaderboard?排序=reputation

Security 模型 Non-Custodial: Private keys stored in ~/.config/solclaw/keypAIr.json with 600 权限s Local 签名ing: All transactions 签名ed on your machine No Server Keys: API is read-only, never touches private keys On-ChAIn Authority: Vault operations require wallet 签名ature Spending Caps: Optional dAIly limits to 预防 运行away spending Bring Your Own Wallet

SolClaw supports 导入ing existing Solana wallets:

Solana 命令行工具 格式化: --keypAIr ~/.config/solana/id.json Base58 private key: --private-key "your_key..." 导出 for 备份: solclaw 导出

Your existing wallet works seamlessly with SolClaw. 导入 once, use the same keypAIr across 工具s.

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 命令行工具 Config ~/.config/solclaw/ Commerce Loop Example # 1. 代理 registers solclaw in