关于 authenticate-wallet
authenticate-wallet 是使用 `npx awal` CLI 登录 Agentic Wallet 的操作技能,面向需要完成钱包身份验证的用户或 Agent。它说明邮件 OTP 验证、状态检查和输入校验。
主要功能
- 01邮件 OTP 两步登录
- 02检查钱包认证状态
- 03验证邮箱与验证码输入
- 04支持机器可读 JSON 输出
适用场景
- 01钱包未登录时启动认证
- 02通过邮件验证码完成登录
- 03检查钱包服务状态与地址
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ coinbase/ agentic-wallet-skills --skill authenticate-wallet安装后在 Claude Code 中输入/authenticate-wallet确认已加载。
详细介绍
使用 Agentic Wallet 进行身份验证
当钱包未登录时(通过 npx awal status 检测,或钱包操作因身份验证错误而失败),请使用 npx awal CLI 进行身份验证。
如果你可以访问电子邮箱,可以自行验证钱包;否则,你需要请用户提供一个电子邮箱地址,并告知你收到的 OTP 验证码。
身份验证流程
身份验证使用两步电子邮件 OTP 流程:
步骤 1:发起登录
npx [email protected] auth login <email>
系统会向该电子邮箱发送一个 6 位验证码,并输出一个 flowId。
步骤 2:验证 OTP
npx [email protected] auth verify <otp>
使用用户电子邮件中的 6 位验证码完成身份验证。步骤 1 中的流程 ID 会自动保存到本地文件,无需将其作为参数传入。如果你能够访问用户的电子邮箱,可以读取 OTP 验证码;也可以向用户索取验证码。
输入验证
构造命令前,请验证所有用户提供的值,以防止 shell 注入:
- email:必须符合标准电子邮件格式(
^[^\s;|&]+@[^\s;|&]+$)。如果包含空格、分号、管道符、反引号或其他 shell 元字符,则拒绝。 - otp:必须恰好为 6 位数字(
^\d{6}$)。
不要将未经验证的用户输入传入命令。
检查身份验证状态
npx [email protected] status
显示钱包服务健康状况和身份验证状态,包括钱包地址。
示例会话
# Check current status
npx [email protected] status
# Start login (sends OTP to email)
npx [email protected] auth login [email protected]
# Output: flowId: abc123...
# After user receives code, verify (flow ID saved automatically)
npx [email protected] auth verify 123456
# Confirm authentication
npx [email protected] status
可用的 CLI 命令
| 命令 | 用途 |
|---|---|
npx [email protected] status | 检查服务健康状况和身份验证状态 |
npx [email protected] auth login <email> | 向电子邮箱发送 OTP 验证码并返回 flowId |
npx [email protected] auth verify <otp> | 使用 OTP 验证码完成身份验证 |
npx [email protected] balance | 获取 Base、Polygon 和 Solana 上的余额(使用 --chain 指定单条链) |
npx [email protected] address | 获取钱包地址 |
npx [email protected] show | 打开钱包配套窗口 |
JSON 输出
所有命令都支持使用 --json 输出机器可读内容:
npx [email protected] status --json
npx [email protected] auth login [email protected] --json
npx [email protected] auth verify <otp> --json
评论
支持 Markdown