Authenticate Wallet 是一个专为开发者设计的命令行工具，用于处理与 Payments Wallet 相关的身份验证流程。当钱包未登录或在进行交易、充值等操作时遇到认证错误（如‘未登录’提示），该工具可快速完成钱包的登录与连接。其核心机制采用两步式邮箱验证码（OTP）流程：首先通过 `npx awal@latest auth login ` 向指定邮箱发送6位数字验证码并返回一个临时 flowId；随后使用 `npx awal@latest auth verify ` 输入收到的验证码完成身份绑定。整个过程无需图形界面，完全通过终端命令执行，极大提升了自动化脚本和 CI/CD 环境中的集成效率。此外，工具还提供状态检查、余额查询、地址获取及钱包窗口展示等功能，支持 JSON 格式输出以满足机器可读需求。
核心功能特点
- 支持两步邮箱 OTP 认证流程，安全便捷地完成钱包登录
- 提供完整的 CLI 命令集，涵盖状态检查、认证、余额查询等常用功能
- 兼容 JSON 输出模式，便于集成到自动化脚本或开发工具链中
- 自动检测钱包登录状态，避免因未认证导致的交易失败
适用场景
该工具主要适用于需要频繁调用钱包功能的开发场景，尤其是在无人值守的自动化环境中。例如，在持续集成（CI）系统中部署支付接口测试时，若钱包未登录会导致交易失败，此时可通过 `npx awal status` 检测状态，再结合邮箱接收 OTP 的方式自动完成认证，确保后续操作顺利进行。对于远程协助场景，如技术支持人员帮助用户连接钱包，也可通过引导用户查看邮箱中的验证码来完成授权，而无需直接访问用户设备。此外，任何涉及 USDC 转账、充值或合约交互的应用，只要出现‘未登录’错误，均可使用此工具快速恢复钱包连接状态。由于其轻量级设计和命令行驱动特性，它特别适合嵌入到脚本化工作流中，实现从认证到执行的完整闭环。