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:

npx awal@2.12.1 status

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

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.

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.

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