authenticate-wallet

🔐 安全双因素钱包认证网关

🥥38总安装量 11评分人数 15
100% 的用户推荐

基于 Awal CLI 的钱包认证技能,通过邮箱 OTP 双因素验证实现安全登录,为后续支付、交易等操作提供身份保障。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信来源(Github / Microsoft / 官方仓库)
  • ✅ 无代码注入风险:严格限定 npx awal CLI 白名单,禁止任意 Bash 命令执行
  • ✅ 无任意代码执行:所有工具调用均经过前缀过滤,无法构造恶意命令
  • ⚠️ 敏感数据受限访问:可获取钱包地址与余额(公开或授权信息),但私钥由 awal CLI 隔离管理
  • ✅ 网络操作受限:仅通过 awal CLI 进行认证通信,无直接外部网络请求能力
  • ✅ 无文件系统访问:不涉及任何本地文件读写操作

使用说明

核心用法

authenticate-wallet 是一款专为 Awal 支付钱包设计的认证技能,解决用户与 AI Agent 在钱包操作前的身份验证问题。其核心流程采用双因素认证机制:首先通过 npx awal@latest auth login <email>> 向用户邮箱发送 6 位数字 OTP 验证码并获取 flowId,随后使用 npx awal@latest auth verify <flowId> <otp>> 完成验证。技能同时提供状态检查(status)、余额查询(balance)、地址获取(address)和钱包界面唤起(show)等辅助功能,所有命令均支持 --json 输出便于程序解析。

显著优点

该技能的最大优势在于安全架构的严谨性。通过严格的白名单机制,仅允许特定的 npx awal@latest 命名空间下的 CLI 命令,彻底杜绝了代码注入和任意命令执行风险。OTP 双因素认证机制有效防范重放攻击,flowId 会话绑定确保认证链路的完整性。此外,技能设计充分考虑了人机协作场景:当 Agent 具备邮件访问能力时可自动完成闭环认证,否则可引导用户人工输入验证码,灵活性极高。JSON 输出支持使其能无缝集成到自动化工作流中。

潜在缺点与局限性

作为 v0.1.0 初期版本,该技能存在若干局限。首先,强依赖外部 CLI 工具 npx awal@latest,若 npm 包遭遇供应链攻击或作者发布恶意更新,将直接影响安全性(尽管 @latest 标签通常指向稳定版)。其次,认证流程必须依赖邮箱服务,在无邮件访问场景下需要用户手动介入,可能打断自动化体验。此外,技能本身不处理私钥管理,所有敏感操作由 awal CLI 在隔离环境中执行,这意味着用户无法直接审计底层签名逻辑,需信任 awal 团队的安全实现。

适合的目标群体

该技能主要面向三类用户:一是需要 AI Agent 代管加密支付的开发者,可构建自动化的 USDC 转账、薪资发放等应用;二是DeFi 协议集成方,希望为用户提供对话式钱包交互体验;三是企业财务自动化场景,如定期查询钱包余额、监控资金流入等。对于普通个人用户,若已使用 Awal 钱包,该技能可简化其与 AI 助手的协作流程。

使用风险

常规风险包括:依赖项风险——需持续关注 awal npm 包的更新动态,及时修补潜在漏洞;网络稳定性——认证流程涉及与 Awal 服务器的多次往返,弱网环境可能导致 OTP 过期;OTP 社会工程风险——用户可能在钓鱼诱导下泄露验证码,需配合安全教育使用。性能方面,邮件投递延迟可能影响实时性要求高的场景。

authenticate-wallet 内容

手动下载zip · 1.4 kB
SKILL.mdtext/markdown
请选择文件