How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/coinbase/agentic-wallet-skills --skill agentic-walletBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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 awal@2.12.1 statusIf 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
awalcommand supports--jsonfor machine-readable output. - Auth errors mean re-auth: if any command fails with "Not authenticated" or similar, read
references/auth.mdand run the sign-in flow. - Insufficient balance: read
references/fund.mdto top up.
Quick command index
| 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 |
