📦 Verified Agent Identity — 已验证的 Agent 身份

何时使用此 Skill 让 AI agent 在 Billions Network 上创建并管理自己的身份，并将这些身份与一个人类所有者绑定。

• 需要将 agent 身份绑定到所有者时
• 需要签署 challenge 时
• 需要将人类绑定到 agent 的 DID 时
• 需要验证签名以确认身份所有权时
• 使用共享 JWT token 进行认证时
• 需要创建和管理去中心化身份时

安装插件后，运行以下命令创建身份并绑定到人类 DID：

cd scripts && npm install && cd ..
# 步骤 1：创建新身份（若尚不存在）
node scripts/createNewEthereumIdentity.js
# 步骤 2：一次性签署 challenge 并生成验证链接
node scripts/linkHumanToAgent.js --challenge '{"name":,"description":}'

作用域 所有身份数据存储于 $HOME/.openclaw/billions，兼容 OpenClaw 插件。

脚本说明

createNewEthereumIdentity.js 命令：node scripts/createNewEthereumIdentity.js [--key ] 功能：在 Billions Network 创建新身份。提供 --key 则使用该私钥，否则生成随机密钥；创建后自动设为默认。 示例：

# 生成随机身份
node scripts/createNewEthereumIdentity.js
# 使用已有私钥（带 0x）
node scripts/createNewEthereumIdentity.js --key 0x1234567890abcdef...
# 使用已有私钥（不带 0x）
node scripts/createNewEthereumIdentity.js --key 1234567890abcdef...

输出：DID 字符串，如 did:iden3:billions:main:2VmAk7fGHQP5FN2jZ8X9Y3K4W6L1M...

getIdentities.js 命令：node scripts/getIdentities.js 功能：列出本地存储的所有 DID 身份，便于操作前确认。 示例：node scripts/getIdentities.js 输出：JSON 数组

[
  {
    "did": "did:iden3:billions:main:2VmAk...",
    "publicKeyHex": "0x04abc123...",
    "isDefault": true
  }
]

generateChallenge.js 命令：node scripts/generateChallenge.js --did 功能：为指定 DID 生成随机 challenge。 示例：node scripts/generateChallenge.js --did did:iden3:billions:main:2VmAk... 输出：challenge 字符串（如 8472951360） 副作用：在 $HOME/.openclaw/billions/challenges.json 中存储 challenge。

signChallenge.js 命令：node scripts/signChallenge.js --challenge [--did ] 功能：用 DID 私钥签署 challenge，生成 JWS token 以证明所有权。 示例：node scripts/signChallenge.js --challenge 8472951360 输出：{"success":true}

linkHumanToAgent.js 命令：node scripts/linkHumanToAgent.js --challenge [--did ] 功能：签署 challenge 并将人类用户绑定到 agent DID，生成验证请求。底层通过 Billions ERC-8004 Registry 注册 agent，并在 Billions Attestation Registry 创建所有权证明。 示例：node scripts/linkHumanToAgent.js --challenge '{"name":"MyAgent","description":"AI persona"}' 输出：{"success":true}

verifySignature.js 命令：node scripts/verifySignature.js --did --token 功能：验证已签署的 challenge，确认 DID 所有权。 示例：node scripts/verifySignature.js --did did:iden3:billions:main:2VmAk... --token eyJhbGciOiJFUzI1NkstUi... 输出：成功则提示“Signature verified successfully”，失败则返回错误信息。

限制与护栏（关键） 关键规则必须严格遵守：

• 严格：先检查身份

运行 linkHumanToAgent.js 或 signChallenge.js 前，务必执行 node scripts/getIdentities.js 若未配置身份，禁止继续，须先用 createNewEthereumIdentity.js 创建。

• 严格：脚本失败即停

任何脚本返回非零退出码时，必须立即停止，查看 stderr 错误信息。 禁止手动“修复”：不得自行生成密钥、通过其他方式创建 DID 或运行未授权命令。 禁止使用 openssl、ssh-keygen 等系统工具生成加密材料。

• 禁止手动绕过

不得执行任何手动加密操作。