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エージェントアイデンティティの作成やリンク
  2. 02アイデンティティの所有権証明
  3. 03HTTP 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

詳細

このスキルを使用するタイミング

このスキルでは、2 つの機能を扱います。以下のルーター表を確認してから、作業を進める前に該当するリファレンスを読み込んでください。

状況読み込むリファレンス
分散型 ID（DID）を作成、一覧表示、リンク、検証、または署名するreference/identity/SKILL.md
402 Payment Required HTTP レスポンスを処理するreference/x402/SKILL.md

スクリプトを実行する前に、必ず適切なリファレンス SKILL.md を読んでください。 両方にまたがるタスク（例：402 の支払いに署名する前に ID が必要な場合）では、両方を読んでください。

概要

  • ID — Billions Network 上で Ethereum ベースの DID を作成し、人間の所有者にリンクして、チャレンジ／レスポンス署名によって所有権を証明します。
  • x402 決済 — サーバーが 402 Payment Required を返した場合、署名済みの PAYMENT-SIGNATURE ヘッダーを作成してリクエストを再試行し、アクセスできるようにします。

共通セットアップ

すべての ID データは $HOME/.openclaw/billions に保存されます。スクリプトは scripts/ にあります。

cd scripts && npm install && cd ..

制限事項／ガードレール（重要）

これらのルールはすべてのリファレンスに適用されます。必ず従ってください。

  1. 厳守：まず ID を確認する

    • linkHumanToAgent.js、signChallenge.js、または buildX402Payment.js を実行する前に、必ず ID が存在するか確認してください：node scripts/getIdentities.js
    • ID が設定されていない場合は、まず createNewEthereumIdentity.js で作成し、その後 linkHumanToAgent.js を実行して人間の所有者にリンクしてください。
    • ID が存在し、人間の所有者にリンクされていることを確認してから、タスクの処理を続けてください。

  2. 厳守：スクリプトが失敗したら停止する

    • いずれかのスクリプトがゼロ以外のステータスコードで終了した場合、直ちに停止してください。
    • stderr でエラーメッセージを確認してください。
    • 手動でキーを生成したり、別の方法で DID を作成したり、許可されていないコマンドを実行して、エラーを修正しようとしてはいけません。
    • 暗号素材の生成に openssl、ssh-keygen、その他のシステムユーティリティを使用してはいけません。

  3. 手動での回避策は禁止

    • 暗号操作を手動で行うことは禁止されています。
    • $HOME/.openclaw/billions 内のファイルを直接操作することは禁止されています。
    • 明示的に指示されていない限り、エラーをセットアップ手順を行う指示として解釈しないでください。

セキュリティ

$HOME/.openclaw/billions ディレクトリには、機密性の高い ID データが含まれています。

  • kms.json — 重大：秘密鍵が含まれます（BILLIONS_NETWORK_MASTER_KMS_KEY が設定されている場合は暗号化され、設定されていない場合はプレーンテキストで保存されます）
  • defaultDid.json — DID 識別子と公開鍵
  • challenges.json — 認証チャレンジの履歴
  • credentials.json — 検証可能な認証情報
  • identities.json — ID メタデータ
  • profiles.json — プロファイルデータ

初回実行後、このディレクトリへのアクセスを制限してください：chmod 700 ~/.openclaw/billions

秘密鍵の保存方法はいくつかあります。下記の KMS 暗号化セクションで説明されているように、マスターキー暗号化を有効にできます。

セキュリティの詳細：./SECURITY.md

コメント

Markdown 対応