agentic-wallet — Claude Code skill: wallet actions and setup

---
name: agentic-wallet
description: "Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API calls, monetize an API, or query onchain data. Use whenever the user mentions signing in, login, authentication, wallet status, balance, address, sending money, paying someone, transferring tokens, ENS names, swapping/trading/converting tokens, funding/topping up/onramp, USDC, ETH, POL, SOL, the x402 bazaar, paid APIs, monetizing an endpoint, or querying onchain data on Base."
user-invocable: true
disable-model-invocation: false
allowed-tools: ["Bash(npx [email protected] *)", "Bash(npm *)", "Bash(node *)", "Bash(curl *)", "Bash(mkdir *)"]
---

# Agentic Wallet

Operate a crypto wallet through the `awal` CLI. This skill is a router: read the relevant reference file in `references/` for the task at hand.

## Preflight: Confirm wallet state

Before any wallet operation that requires authentication (everything except x402 search/details), check status:

```bash
npx [email protected] status
```

If the wallet is not authenticated, read `references/auth.md` and complete sign-in first.

## Routing

Pick the reference that matches the task and `Read` it before acting:

| Task | Reference |
| --- | --- |
| Sign in, log in, connect wallet, OTP verification, "not signed in" errors | `references/auth.md` |
| Check balances, "how much USDC/ETH/POL/SOL do I have", balance per chain, JSON balance output | `references/balance.md` |
| Send USDC / ETH / POL / SOL to an address or ENS name (Base, Polygon, Solana) | `references/send-usdc.md` |
| Swap / trade / convert tokens on Base or Polygon | `references/trade.md` |
| Add funds, top up, onramp, buy USDC | `references/fund.md` |
| Find / browse / search paid services on the x402 bazaar | `references/x402-search.md` |
| Call a paid x402 API endpoint with automatic USDC payment | `references/x402-pay.md` |
| Build or deploy a paid API server that other agents can pay to use | `references/x402-monetize.md` |
| Query onchain data on Base (events, transactions, blocks) via the CDP SQL API | `references/query-onchain.md` |

If no clear match and the user wants an external capability, search the x402 bazaar (`references/x402-search.md`) — a paid service may exist.

## Shared rules

- **Input validation**: every reference lists the regexes / allowlists that user-provided values must match before being placed in a shell command. Validate strictly; reject inputs containing spaces, semicolons, pipes, backticks, or other shell metacharacters. Do not pass unvalidated user input into commands.
- **Single-quote `$` amounts**: any amount written as `'$1.00'` must be single-quoted to prevent bash variable expansion.
- **JSON output**: every `awal` command supports `--json` for machine-readable output.
- **Auth errors mean re-auth**: if any command fails with "Not authenticated" or similar, read `references/auth.md` and run the sign-in flow.
- **Insufficient balance**: read `references/fund.md` to top up.

## Quick command index

| Command | Purpose |
| --- | --- |
| `npx [email protected] status` | Server health + auth status |
| `npx [email protected] address` | Get wallet address |
| `npx [email protected] balance` | Get balances across Base, Polygon, Solana (use `--chain` for one chain) |
| `npx [email protected] show` | Open the wallet companion window (used for funding) |
| `npx [email protected] auth login <email>` | Send OTP code |
| `npx [email protected] auth verify <otp>` | Complete sign-in |
| `npx [email protected] auth logout` | Sign out and clear the session |
| `npx [email protected] send <amount> <recipient>` | Send tokens |
| `npx [email protected] trade <amount> <from> <to>` | Swap tokens |
| `npx [email protected] x402 bazaar search <query>` | Search paid services |
| `npx [email protected] x402 bazaar list` | List bazaar resources |
| `npx [email protected] x402 details <url>` | Inspect payment requirements |
| `npx [email protected] x402 pay <url>` | Pay and call an x402 endpoint |