skilld
All skills
coinbase avatar

/agentic-wallet

@70cb79c official
by coinbasecoinbase/agentic-wallet-skills127 stars
56

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/coinbase/agentic-wallet-skills/agentic-wallet

This session only. Nothing lands on disk.

SKILL.md

≈148 tokens always: the name and description. ≈815 when used: this file. ≈13k more on demand in 9 files.

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.

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 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

Source: SKILL.md on GitHub

Third-party checks

1 alert1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill provides comprehensive crypto wallet functionality and x402 payment integration using Coinbase's 'awal' CLI and associated libraries. It handles authentication, balance tracking, token transfers, and trading while emphasizing strict input validation to prevent command injection. It also guides developers in building and monetizing their own APIs with x402 payments.

  • Socket1mo

    1 alert: gptSecurity

  • Snyk1mo

    Risk: HIGH · 3 issues

Provenance

Signed by skilld at 70cb79c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Steadyupdated 2 months ago

Capability

What it can do
Runs commands
user-invocable
true
disable-model-invocation
false
All 5 allowed tools
Bash(npx awal@2.12.1 *)Bash(npm *)Bash(node *)Bash(curl *)Bash(mkdir *)

Topics

  • CLI
  • crypto
  • wallet
  • usdc
  • eth
  • solana
  • polygon
  • x402
  • onchain
  • base

README badge

README badge for coinbase/agentic-wallet-skills

What it does

Operates a crypto wallet via the `awal` CLI to sign in, check balances, send USDC/ETH/POL/SOL across Base/Polygon/Solana, swap tokens, fund the wallet, and discover or pay for services on the x402 bazaar. Use when the user needs wallet authentication, balance checks, token transfers, trading, onramp, or access to paid APIs that accept x402 payments.

Generated from the current SKILL.md.

Frequently asked

What blockchains does this skill support?
Base, Polygon, and Solana. Balance checks and sends work across all three; token swaps are limited to Base and Polygon.
Do I need to authenticate before using the wallet?
Yes, except for x402 bazaar search and details. Run `npx awal@2.10.0 status` first; if not authenticated, read `references/auth.md` to sign in with an OTP code.
What tokens can I send or trade?
The skill explicitly supports USDC, ETH, POL, and SOL. Token swaps are available on Base and Polygon via the trade command.
What is the x402 protocol and how does it work?
x402 is a payment protocol for discovering and calling paid APIs. You can search the x402 bazaar for services, pay USDC automatically to call them, or monetize your own API endpoint so other agents can pay to use it.
Can I query blockchain data directly?
Yes, the skill includes a `query-onchain` reference for querying events, transactions, and blocks on Base using the CDP SQL API.

Generated from the current SKILL.md. These answers refresh after source changes.