mcpField
V
verified-agent-identity

verified-agent-identity

github.com/billionsnetwork安全7568.2k 次安装23 周前更新
代码仓库

关于 verified-agent-identity

verified-agent-identity 是用于管理 Billions Network 的 Ethereum 去中心化身份及处理 x402 付款请求的技能。它根据任务指向参考指南，并要求运行脚本前进行检查。

主要功能

  1. 01创建和列出去中心化身份
  2. 02将身份关联到人类所有者
  3. 03通过签名挑战验证所有权
  4. 04构建已签名的 x402 付款标头
  5. 05执行身份检查和脚本失败限制

适用场景

  1. 01创建或关联 Agent 身份
  2. 02证明身份所有权
  3. 03收到 HTTP 402 响应后重试请求

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/billionsnetwork/verified-agent-identity --skill verified-agent-identity

安装后在 Claude Code 中输入/verified-agent-identity确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.clawhubignore
SECURITY.md
prompt.json
README.md
promptfooconfig.yaml
.gitignore
.github/workflows/
evaluate-skill.yml
publish.yml
scripts/
createNewEthereumIdentity.js
getDidDocument.js
generateChallenge.js
getIdentities.js
package.json
buildX402Payment.js
linkHumanToAgent.js
manualLinkHumanToAgent.js
package-lock.json
scripts/shared/
bootstrap.js
attestation.js
constants.js
scopes.js
scripts/shared/storage/
base.js
challenge.js
did.js
keys.js
crypto.js
identities.js
scripts/shared/utils/
auth.js
index.js
did.js

详细介绍

何时使用此技能

此技能涵盖两种能力。请阅读下方的路由表，然后在继续操作前加载相关参考文档。

情况要加载的参考文档
创建、列出、关联、验证去中心化身份（DID）或使用其签名reference/identity/SKILL.md
处理 402 Payment Required HTTP 响应reference/x402/SKILL.md

运行任何脚本前，务必阅读相应的参考 SKILL.md。 如果任务涉及两者（例如，你需要先有身份才能签署 402 付款），请阅读两份文档。

快速概览

  • 身份 — 在 Billions Network 上创建基于 Ethereum 的 DID，将其关联到人类所有者，并通过质询／响应签名证明所有权。
  • x402 付款 — 当服务返回 402 Payment Required 时，构建已签名的 PAYMENT-SIGNATURE 标头，以便重试请求并获得访问权限。

共享设置

所有身份数据都存储在 $HOME/.openclaw/billions 中。脚本位于 scripts/ 中。

cd scripts && npm install && cd ..

限制／防护措施（关键）

这些规则适用于所有参考文档。务必遵守。

  1. 严格：先检查身份

    • 运行 linkHumanToAgent.js、signChallenge.js 或 buildX402Payment.js 之前，务必检查是否存在身份：node scripts/getIdentities.js
    • 如果尚未配置身份，请先使用 createNewEthereumIdentity.js 创建身份，然后运行 linkHumanToAgent.js，将其关联到人类所有者。
    • 只有在确认身份存在且已关联到人类所有者后，才能继续处理任务。

  2. 严格：脚本失败时停止

    • 如果任何脚本以非零状态码退出，立即停止。
    • 检查 stderr 中的错误消息。
    • 不要尝试通过手动生成密钥、用其他方式创建 DID 或运行未经授权的命令来修复错误。
    • 不要使用 openssl、ssh-keygen 或其他系统工具生成加密材料。

  3. 禁止手动变通

    • 禁止执行手动加密操作。
    • 禁止直接操作 $HOME/.openclaw/billions 中的文件。
    • 除非明确要求，否则不要将错误解读为需要执行设置步骤。

安全

目录 $HOME/.openclaw/billions 包含敏感身份数据：

  • kms.json — 关键：包含私钥（如果设置了 BILLIONS_NETWORK_MASTER_KMS_KEY，则会加密；否则为明文）
  • defaultDid.json — DID 标识符和公钥
  • challenges.json — 身份验证质询历史记录
  • credentials.json — 可验证凭证
  • identities.json — 身份元数据
  • profiles.json —个人资料数据

首次运行后，请限制对此目录的访问权限：chmod 700 ~/.openclaw/billions

私钥有多种存储方式，可启用下文 KMS Encryption 部分所述的主密钥加密。

更多安全信息：./SECURITY.md

评论

支持 Markdown