agentic-wallet

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

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.

通过

awal

CLI操作加密货币钱包。本Skill是一个路由工具：针对当前任务阅读

references/

目录下的相关参考文件。

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

bash

npx awal@2.10.0 status

If the wallet is not authenticated, read

references/auth.md

and complete sign-in first.

在执行任何需要身份验证的钱包操作（除x402搜索/详情查询外的所有操作）之前，先检查状态：

bash

npx awal@2.10.0 status

如果钱包未完成身份验证，请先阅读

references/auth.md

并完成登录。

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.

选择与任务匹配的参考文件，并在操作前

阅读

它：

任务	参考文件
登录、连接钱包、OTP验证、“未登录”错误	`references/auth.md`
查看余额、“我有多少USDC/ETH/POL/SOL”、单链余额、JSON格式余额输出	`references/balance.md`
向地址或ENS名称发送USDC/ETH/POL/SOL（Base、Polygon、Solana链）	`references/send-usdc.md`
在Base或Polygon链上兑换/交易/转换代币	`references/trade.md`
充值、入金、购买USDC	`references/fund.md`
在x402集市查找/浏览/搜索付费服务	`references/x402-search.md`
调用付费x402 API端点并自动完成USDC支付	`references/x402-pay.md`
构建或部署可供其他Agent付费使用的API服务器	`references/x402-monetize.md`
通过CDP SQL API查询Base链上数据（事件、交易、区块）	`references/query-onchain.md`

如果没有明确匹配的任务，且用户需要外部功能，请搜索x402集市（

references/x402-search.md

）——可能存在对应的付费服务。

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.

输入验证：每个参考文件都列出了用户提供的值在放入shell命令前必须匹配的正则表达式/允许列表。严格验证；拒绝包含空格、分号、管道符、反引号或其他shell元字符的输入。请勿将未验证的用户输入传入命令。
金额单引号包裹：任何以
```
'$1.00'
```
形式书写的金额必须用单引号包裹，以避免bash变量展开。
JSON输出：每个
```
awal
```
命令都支持
```
--json
```
参数以生成机器可读的输出。
身份验证错误需重新验证：如果任何命令因“未验证”或类似错误失败，请阅读
```
references/auth.md
```
并执行登录流程。
余额不足：请阅读
```
references/fund.md
```
进行充值。

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

命令	用途
`npx awal@2.10.0 status`	服务器状态 + 身份验证状态
`npx awal@2.10.0 address`	获取钱包地址
`npx awal@2.10.0 balance`	获取Base、Polygon、Solana链的余额（使用 `--chain` 参数指定单链）
`npx awal@2.10.0 show`	打开钱包配套窗口（用于充值）
`npx awal@2.10.0 auth login <email>`	发送OTP验证码
`npx awal@2.10.0 auth verify <otp>`	完成登录
`npx awal@2.10.0 send <amount> <recipient>`	发送代币
`npx awal@2.10.0 trade <amount> <from> <to>`	兑换代币
`npx awal@2.10.0 x402 bazaar search <query>`	搜索付费服务
`npx awal@2.10.0 x402 bazaar list`	列出集市资源
`npx awal@2.10.0 x402 details <url>`	查看支付要求详情
`npx awal@2.10.0 x402 pay <url>`	支付并调用x402端点