Verified Agent Identity

核心用法

verified-agent-identity 是一套基于 Billions Network 的去中心化身份管理技能，采用 iden3 自证身份协议实现 AI Agent 的自我主权身份（SSI）。核心工作流包含三个环节：身份创建、人机关联、验证证明。

身份创建：通过 createNewEthereumIdentity.js 生成基于 Ethereum 的 DID（去中心化标识符），支持随机生成或导入现有私钥，输出符合 did:iden3:billions:main:{id} 格式的标识符。

人机关联：使用 linkHumanToAgent.js 将 Agent 身份绑定至人类所有者，底层依赖 ERC-8004 Agent Registry 与 Attestation Registry 完成链上注册和所有权证明，确保每个 Agent 有唯一的人类责任主体。

验证交互：通过 generateChallenge.js/signChallenge.js/verifySignature.js 实现双向身份验证——Agent 可证明自己身份，也可验证其他 DID 持有者身份，全程采用 JWS（JSON Web Signature）标准格式。

显著优点

1. 合规就绪：明确的人机绑定机制满足欧盟 AI Act、中国《生成式人工智能服务管理暂行办法》对"人工介入"和"责任追溯"的要求
2. 密码学严谨：基于 iden3 成熟的零知识证明体系，支持选择性披露，避免过度数据暴露
3. 链上可验证：所有身份声明与证明均可在 Billions Network 查询，具备不可篡改的审计轨迹
4. 密钥托管灵活：支持可选的 BILLIONS_NETWORK_MASTER_KMS_KEY 环境变量加密私钥，兼顾安全性与可用性

潜在局限

• 网络依赖：需连接 Billions Network 主网，离线场景无法完成链上验证
• 技术门槛：DID、JWS、ERC-8004 等概念对普通用户存在认知负担
• 生态早期：相比 ENS、World ID 等成熟方案，Billions 网络验证节点和应用集成有限
• 私钥风险：未配置 KMS 时私钥以明文存储于本地文件系统，需严格文件权限控制

适合人群

• 需要合规部署的 B2B AI Agent 服务商
• 构建可验证 Agent 网络的 DAO 或协议团队
• 对身份溯源有强监管要求的金融、医疗 AI 应用开发者

常规风险

• 私钥泄露：$HOME/.openclaw/billions/kms.json 若权限配置不当可能导致身份被盗用
• 钓鱼挑战：验证流程中若未核对挑战值来源，可能签署恶意构造的 payload
• 链上关联公开：DID 与人类身份的绑定关系在链上公开可查，存在去匿名化风险
• 脚本执行风险：Node.js 脚本依赖本地运行环境，供应链攻击可能污染执行代码

核心用法

verified-agent-identity 是一个基于iden3自主主权身份协议的去中心化身份管理工具，专为AI代理设计。该技能允许AI代理在Billions Network上创建和管理自己的去中心化标识符（DID），并将这些身份与人类所有者关联验证。

主要功能模块：

• 身份创建：通过createNewEthereumIdentity.js生成新的以太坊身份，支持随机生成或从现有私钥导入
• 身份管理：getIdentities.js列出本地存储的所有DID身份，支持多身份切换
• 挑战-响应验证：generateChallenge.js生成随机挑战，signChallenge.js使用私钥签名证明身份所有权
• 人机关联：linkHumanToAgent.js一站式完成挑战签名和验证URL生成，建立代理与人类所有者的信任链
• 签名验证：verifySignature.js验证第三方签名以确认DID所有权

典型工作流：
1. 检查现有身份 → 2. 创建新身份（如需要）→ 3. 生成/接收挑战 → 4. 签名响应 → 5. 链上验证关联

显著优点

• 协议标准化：基于iden3/PolygonID成熟协议，与以太坊生态完全兼容，DID格式遵循W3C标准
• 安全架构完善：采用AES-256-GCM加密私钥，支持通过BILLIONS_NETWORK_MASTER_KMS_KEY环境变量启用加密存储
• 依赖可信：使用经过审计的官方SDK（@0xpolygonid/js-sdk、@iden3/js-iden3-core、ethers），无已知CVE漏洞
• 零信任验证：挑战-响应机制确保身份所有权可密码学证明，无需依赖中心化机构
• 互操作性：生成的DID可在整个PolygonID生态中使用，支持跨应用身份复用
• 行为可审计：所有网络请求仅指向可信端点（resolver.privado.id、billions.network基础设施），无数据外泄风险

潜在缺点与局限性

• 密钥管理依赖用户配置：若未设置主密钥环境变量，私钥以明文存储于~/.openclaw/billions/kms.json，存在泄露风险
• 技术门槛较高：需要理解DID、iden3协议、挑战-响应机制等概念，非技术用户上手困难
• 单点故障风险：主密钥丢失将导致无法解密已加密私钥，且没有恢复机制
• 网络依赖：身份解析依赖Billions Network和Privado ID的RPC服务，存在可用性风险
• 许可证不明确：技能声明为UNLICENSED，商业用途需谨慎评估依赖库兼容性

适合人群

• AI代理开发者：需要为自主代理建立可验证数字身份的构建者
• DeFi/DAO参与者：需要人机身份绑定以满足合规要求的协议运营者
• 隐私计算研究者：探索自主主权身份（SSI）与AI结合的前沿开发者
• 企业级AI部署：需要满足GDPR等合规要求、具备可审计身份链的B端场景

常规风险

| 风险类型 | 级别 | 说明 |

|---------|------|------|

| 密钥泄露 | 中 | 明文存储时若目录权限配置不当可能导致私钥泄露 |

| 主密钥丢失 | 高 | 丢失`BILLIONS_NETWORK_MASTER_KMS_KEY`将无法恢复加密私钥 |

| 身份伪造 | 低 | 挑战-响应机制密码学安全，但需确保挑战值不可预测 |

| 供应链攻击 | 低 | 依赖官方SDK，但仍需警惕npm包篡改 |

| 网络钓鱼 | 中 | 用户可能被骗签署恶意构造的挑战 |

关键安全建议：

• 生产环境务必配置BILLIONS_NETWORK_MASTER_KMS_KEY并设置目录权限chmod 700 ~/.openclaw/billions
• 使用专用身份密钥，切勿复用持有资产的以太坊钱包
• 定期轮换身份密钥，备份主密钥至安全离线存储