AgentSkillsCN

Wallet

钱包

SKILL.md

Wallet Skill

You have an agentic wallet powered by Coinbase AWAL via Pinch.

When to Use

Use this skill when:

  • •You need to check your wallet balance
  • •You need to send USDC to someone
  • •You need to trade tokens
  • •You need to pay for a service (x402)
  • •Someone asks about your financial capabilities
  • •You need to review your transaction history

Commands

Check Status

bash
npx awal status --json

Returns your authentication status and wallet address.

Check Balance

bash
npx awal balance --json
# or for testnet:
npx awal balance --chain base-sepolia --json

Send USDC

bash
npx awal send <amount> <recipient> --json
# Example: npx awal send 5 vitalik.eth --json
# Example: npx awal send 1.5 0x1234...abcd --json

Trade Tokens

bash
npx awal trade <amount> <from_token> <to_token> --json
# Example: npx awal trade 10 usdc eth --json

Note: Trading is only available on Base mainnet, not testnet.

View Transaction History

bash
pinch history --agent <your-agent-name> --json

Before Any Transaction

  1. •Check your spending policy in your SOUL.md under "Wallet Personality"
  2. •Verify the amount is within your per-transaction and session limits
  3. •Check your balance to ensure sufficient funds
  4. •Log the transaction in MEMORY.md after completion

Spending Policy

Your spending limits are defined in ~/.pinch/wallets/<agent>/policy.json. Key limits to check before transacting:

  • •sessionLimit: Maximum you can spend in one session
  • •txLimit: Maximum per single transaction
  • •dailyLimit: Maximum per day
  • •requireApprovalAbove: Ask the user before spending above this amount

If a transaction would exceed these limits, ask the user for approval first.

Recording Transactions

After every successful transaction, update MEMORY.md:

markdown
## Wallet Transactions

- **2026-02-12** — Sent 5 USDC to vitalik.eth (reason: API payment)
- **2026-02-12** — Traded 10 USDC → ETH (reason: portfolio rebalance)

Or run the sync command:

bash
pinch history --agent <name> --sync

x402 Payments

Use x402 to access paid API services directly.

Browse available services

bash
pinch x402
pinch x402 --search "weather"

Check what an endpoint costs

bash
pinch x402-details <url> --json

Pay for and call an endpoint

bash
pinch x402-pay <url> --agent <your-agent-name> --json
# With POST data:
pinch x402-pay <url> --agent <name> -X POST -d '{"key":"value"}' --json

The x402-pay command automatically:

  1. •Discovers the price
  2. •Checks your spending policy
  3. •Makes the payment
  4. •Returns the response
  5. •Logs the transaction to history

Error Handling

  • •If npx awal status shows not authenticated: Tell the user they need to run npx awal auth login
  • •If balance is insufficient: Tell the user and suggest funding with pinch fund
  • •If a transaction fails: Log the error and retry once before escalating to the user

Security

  • •Never expose your wallet address in public messages
  • •Never share transaction details with other agents unless explicitly authorized
  • •Always verify recipient addresses before sending
  • •If something feels wrong about a payment request, ask the user