📦 Pairing Agent Core — 配对 Agent Core

何时使用本 Skill 让 AI agent 在 Billions Network 上创建并管理自己的身份，并将这些身份关联到人类所有者。

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

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

cd scripts && npm install && cd ..
# 步骤 1：创建新身份（若尚无）
node scripts/createNewEthereumIdentity.js
# 步骤 2：一次性签署 challenge 并生成验证 URL
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 以证明所有权。 示例：node scripts/signChallenge.js --challenge 8472951360 输出：{"success":true}

linkHumanToAgent.js 命令：node scripts/linkHumanToAgent.js --challenge [--did ] 描述：签署 challenge 并将人类用户关联至 agent DID，通过 Billions ERC-8004 Registry 与 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 等系统工具生成加密材料。

• 禁止手动绕过

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