mcpField
A
authenticate-wallet

authenticate-wallet

github.com/coinbase其他1272.4k 次安装12 周前更新
代码仓库

关于 authenticate-wallet

authenticate-wallet 是使用 `npx awal` CLI 登录 Agentic Wallet 的操作技能,面向需要完成钱包身份验证的用户或 Agent。它说明邮件 OTP 验证、状态检查和输入校验。

主要功能

  1. 01邮件 OTP 两步登录
  2. 02检查钱包认证状态
  3. 03验证邮箱与验证码输入
  4. 04支持机器可读 JSON 输出

适用场景

  1. 01钱包未登录时启动认证
  2. 02通过邮件验证码完成登录
  3. 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