circle-wallet

Circle Wallet Skill

USDC wallet operations for OpenClaw agents via Circle Developer-Controlled Wallets.

Features

Installation

clawhub install circle-wallet
cd ~/.openclaw/workspace/skills/circle-wallet
npm install
npm link

Quick Start

1. Get API Key

2. Setup

New users:

circle-wallet setup --api-key your-api-key

Existing users:

circle-wallet configure --api-key your-key --entity-secret your-secret

3. Create Wallet & Get Funds

circle-wallet create "My Wallet"
circle-wallet drip                    # Testnet only
circle-wallet balance

4. Send USDC

circle-wallet send 0x... 10 --from 0x...

All Commands

# Setup
circle-wallet setup --api-key                           # Generate and register entity secret
circle-wallet configure --api-key  --entity-secret   # Use existing credentials
circle-wallet config                                         # View configuration
Chains
circle-wallet chains                   # List all supported blockchains
circle-wallet chains --show-tokens     # Show USDC token IDs
circle-wallet chains --mainnet         # Mainnets only
circle-wallet chains --testnet         # Testnets only
Wallets
circle-wallet create [name] [--chain ]   # Create new SCA wallet
circle-wallet list                                    # List all wallets with balances
circle-wallet balance [wallet-id]                     # Check balance
Transactions
circle-wallet send   [--from ]  # Auto-detects chain from wallet
circle-wallet drip [address]                                       # Get testnet USDC (sandbox only)

Supported Chains

Mainnets (10): APTOS, ARB, AVAX, BASE, ETH, MONAD, OP, MATIC, SOL, UNI

Testnets (11): APTOS-TESTNET, ARB-SEPOLIA, ARC-TESTNET, AVAX-FUJI, BASE-SEPOLIA, ETH-SEPOLIA, MONAD-TESTNET, OP-SEPOLIA, MATIC-AMOY, SOL-DEVNET, UNI-SEPOLIA

Use circle-wallet chains --show-tokens to see USDC token IDs for each chain.

Usage Examples

Multi-Chain Wallets

# Create wallets on different chains (default: ARC-TESTNET for sandbox)
circle-wallet create "Arc Wallet" --chain ARC-TESTNET
circle-wallet create "Base Wallet" --chain BASE-SEPOLIA
circle-wallet create "Polygon Wallet" --chain MATIC-AMOY
Send automatically uses the correct chain for each wallet
circle-wallet send 0xRecipient... 5 --from 0xArcWallet...
circle-wallet send 0xRecipient... 3 --from 0xPolygonWallet...

# Create two wallets
circle-wallet create "Wallet 1"
circle-wallet create "Wallet 2"
Fund first wallet
circle-wallet drip
Send from wallet 1 to wallet 2 (using addresses)
circle-wallet send 0xWallet2Address... 5 --from 0xWallet1Address...

User: "Check my wallet balance"
Agent: [circle-wallet balance] "You have 42.5 USDC"
User: "Send 10 USDC to 0x123..."
Agent: [circle-wallet send 0x123... 10] "Sent! TX: 0xabc..."

circle-wallet create "My Wallet"

circle-wallet drip              # Testnet only
Or fund wallet externally for mainnet

circle-wallet configure --api-key  --entity-secret 

1. Get API Key

circle-wallet setup --api-key your-api-key

circle-wallet configure --api-key your-key --entity-secret your-secret

circle-wallet create "My Wallet"
circle-wallet drip                    # Testnet only
circle-wallet balance

circle-wallet send 0x... 10 --from 0x...

Credentials stored in: ~/.openclaw/circle-wallet/

Environment variables:

"No wallet configured"

circle-wallet create "My Wallet"

"Insufficient balance"

circle-wallet drip              # Testnet only
Or fund wallet externally for mainnet

"Entity secret already registered"

circle-wallet configure --api-key  --entity-secret 

"Invalid Ethereum address format" Address must be 0x followed by 40 hexadecimal characters.