用途:调用 x402 付费 API 端点,并在 Base 网络上自动以 USDC 完成支付。
主要能力:使用 npx awal@2.10.0 x402 pay 命令发起请求,支持指定 HTTP 方法(默认 GET)、JSON 请求体、查询参数、自定义请求头、最大支付金额(USDC 原子单位,1000000 = $1.00)以及 JSON 输出。
使用方式:先确认钱包已初始化并认证,运行 npx awal@2.10.0 status;未认证时参考 authenticate-wallet 技能。命令语法:npx awal@2.10.0 x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]。示例:npx awal@2.10.0 x402 pay https://example.com/api/weather;POST 示例:npx awal@2.10.0 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}';限制金额:--max-amount 100000。
输入校验:url 须以 https:// 或 http:// 开头,拒绝含空格、分号、管道、反引号或 shell 元字符;data 须为合法 JSON 并用单引号包裹;max-amount 须为正整数。含 $ 的金额务必用单引号防止 bash 变量展开。
前提与限制:钱包须已认证且有足够 USDC 余额(可用 npx awal@2.10.0 balance 查看);若不知端点 URL,可先用 search-for-service 技能查找。常见错误:未认证需先运行 awal auth login <email>;提示 No X402 payment requirements found 说明该 URL 可能不是 x402 端点;余额不足需充值 USDC。