wallet-verifier-mcp

🏗️ Wallet4Agent — 技術スタックの概要

人、企業、サービス、他のエージェントとやり取りできる、信頼性の高いAIエージェントを構築する開発者向け

Wallet4Agentは、AIエージェントが現実世界で安全に動作するために必要な信頼レイヤーを提供します。
このドキュメントでは、プラットフォームを支える技術コンポーネント、標準、アイデンティティの仕組みについて説明します。

---

1. 🎯 Wallet4Agentの目的

AIエージェントは、ますます多くの操作を実行し、データにアクセスし、連携するようになっています。
これらを安全に行うには、次のことができなければなりません。

• 🆔 自分が何者かを証明する
• 👤 誰が所有または管理しているかを証明する
• 📄 検証可能なクレデンシャルを保持する
• 🔐 操作やデータに安全に署名する
• 🔗 ユーザー、企業、他のエージェントを信頼する
• 🪪 脆弱なAPIキーを使わずに外部システムで認証する

Wallet4AgentはAIエージェントに次の機能を提供します。

• DIDベースのアイデンティティ
• クレデンシャルを保管する安全なウォレット
• クラウドKMSに支えられた署名キー
• OIDC4VCI、OIDC4VP、SD‑JWT、JSON-LD、OAuth2との相互運用性
• エージェント向けのMCPサーバーインターフェース

すべて標準に基づいており、相互運用が可能です。

---

2. 🧱 アーキテクチャの概要

Wallet4Agentは、連携する3つのレイヤーで構成されています。

2.1 🖥️ MCP サーバー（Model Context Protocol）

• 単一のエンドポイント：
  POST https://wallet4agent.com/mcp
• すべての操作をツールとして公開します。
  • アイデンティティの作成
  • クレデンシャルの発行
  • 検証フロー
  • 署名操作
  • 設定

2.2 👛 アイデンティティウォレット

次の情報を管理します。

• エージェントのDIDとDIDドキュメント
• 保存されたクレデンシャル（SD‑JWT VC、VC JSON‑LD）
• リンクされた検証可能なプレゼンテーション
• ウォレットのメタデータとサービスエンドポイント

2.3 🔐 認可・検証レイヤー

次をサポートします。

• OAuth2アクセストークン
• OIDC4VCI（クレデンシャル発行）
• OIDC4VP（プレゼンテーション）
• ユーザー検証フロー
• エージェント間認証

複雑な暗号処理とアイデンティティのロジックはすべてWallet4Agent側で処理されます。
エージェントはMCPツールを呼び出すだけです。

---

3. 🆔 アイデンティティレイヤー（DIDとDIDドキュメント）

各AIエージェントには、W3C DID Core仕様に準拠した**分散型識別子（DID）**が付与されます。

Wallet4Agentは、次の2つのDIDメソッドをサポートしています。

---

3.1 🌐 did:web（DNSベースのアイデンティティ）

ドメインに紐付けられたDIDです。

did:web:wallet4agent.com:<agent-id>

⭐ 特徴：

• HTTPSを使って簡単に解決できます
• DIDドキュメントの配置場所：
  https://wallet4agent.com/did/<agent-id>
• SaaSエージェントに最適です
• 人が読みやすく、インフラとの親和性が高いです
• 企業やプラットフォームに紐付けられたAIエージェントに適しています

🔗 DID:webの仕様：
https://www.w3.org/TR/did-spec-registries/#did-method-web

---

3.2 ⛓️ did:cheqd（台帳ベースのアイデンティティ）

Cheqdの分散型台帳に紐付けられたDIDです。

did:cheqd:<network>:<identifier>

⭐ 特徴：

• 改ざん耐性のあるDIDドキュメントが台帳上に保存されます
• 台帳にアンカーされたキー、ローテーション、サービスエンドポイントをサポートします
• 次の用途に最適です。
  • 高保証のアイデンティティ
  • 規制対象の環境
  • 信頼レジストリ
  • 分散型コンプライアンスエコシステム

🔗 DID:cheqdの仕様：
https://docs.cheqd.io/identity/

---

4. 📄 DIDドキュメント

DIDメソッドにかかわらず、DIDドキュメントは次の情報を公開します。

• 🔑 公開鍵
• 🔐 認証方式
• 📌 サービスエンドポイント
• 🧾 リンクされた検証可能なプレゼンテーション
• 🧬 キーの種類（JWK、Ed25519など）

次の場合、DIDドキュメントは自動的に更新されます。

• キーがローテーションされたとき
• 新しい開発者キーまたはエージェントキーが登録されたとき
• クレデンシャルがリンクされたVPとして公開されたとき
• 認証方式が変更されたとき

外部エージェントやサービスは、DIDドキュメントを使って署名、クレデンシャル、リンクされた証明を検証します。

---

5. 🔗 リンク付き検証可能なプレゼンテーション（Linked VP）

Linked VP を使用すると、Wallet4Agent は検証可能なクレデンシャルを参照として DID Document 内に公開できます。

これが重要な理由：

• 公開クレデンシャルを発見できるようになります
• 第三者がエージェントの能力を検証できます
• 次の用途に役立ちます：
  • 企業の委任事項
  • エージェントの能力
  • サービスの信頼性を示す情報
  • コンプライアンスの証明

対応フォーマット：

• 🟦 SD‑JWT VC
• 🟩 JWT‑VC / JWT‑VP
• 🟪 JSON‑LD VC / VP

仕様：
https://identity.foundation/linked-vp/spec/v1.0.0/

---

6. 🔐 暗号技術と鍵管理

6.1 🗝️ Cloud KMS を利用した鍵（エクスポート不可）

各エージェントには専用のクラウド KMS 鍵があります。

用途：

• 検証可能なプレゼンテーションへの署名
• OIDC4VCI における鍵の所有証明
• OAuth2 クライアント認証用の JWT
• 内部の署名操作

メリット：

• 秘密鍵がKMS の外に出ることはありません
• エージェントの ID が安全な実行環境に紐付けられます
• 高い保証レベルの署名

6.2 🔑 開発者が提供する鍵

開発者は追加の公開 JWK を登録できます：

• OAuth private_key_jwt 用
• 独自の鍵を管理するエージェントフレームワーク用
• 企業の署名鍵用

Wallet4Agent は公開鍵を保存し、開発者は秘密鍵を保持します。

---

7. 🔑 認証方式

Wallet4Agent は、エージェント認証フローを3 種類サポートしています：

7.1 🔹 エージェント個人アクセストークン（PAT）

Authorization: Bearer <agent_pat>

開発やローカルエージェントに適した、シンプルで効果的な方法です。

7.2 🔹 OAuth2 クライアントクレデンシャル

エージェントは次を受け取ります：

• client_id = エージェントの DID
• client_secret

次のように交換します：

grant_type=client_credentials

ほとんどの本番環境のリクエストに最適です。

7.3 🔹 OAuth2 private_key_jwt

最も強固な方法です：

• 開発者が公開 JWK を登録します
• エージェントが秘密鍵で JWT に署名します
• Wallet4Agent が登録済みの公開 JWK を使用して検証します

ハードウェアで保護された鍵やエンタープライズインフラストラクチャに適しています。

---

8. 🧾 クレデンシャルの発行（OIDC4VCI）

Wallet4Agent は、完全なクレデンシャル発行フローを処理します：

• 発行者のメタデータを取得する
• OAuth トークンを取得する
• エージェントの KMS 鍵で署名した鍵の所有証明を作成する
• クレデンシャルをリクエストする
• アテステーションとして保存する

対応フォーマット：

• 🟦 SD‑JWT VC
• 🟩 VC JSON‑LD

エージェントは MCP ツールを呼び出すだけで、プロトコルレベルの処理はすべて Wallet4Agent が行います。

---

9. 🧪 検証（OIDC4VP）

Wallet4Agent は次の検証をサポートしています：

• 自然人
• 他のエージェント
• クレデンシャルに基づくアクセス

エージェントは次の操作を実行できます：

• ユーザー検証を開始する
• ステータスをポーリングする
• 検証済み属性を安全に受け取る
• ピアエージェントを認証する

エージェントが機密トークンを見ることはありません。返されるのは、導出された安全なクレームのみです。

---

10. 📦 クレデンシャルの保存と取得

Wallet4Agent はクレデンシャルをアテステーションとして保存します。これには次が含まれます：

• フォーマット
• 発行者
• VCT/VC タイプ
• 有効期限
• 暗号化されたペイロード
• 公開ステータス（Linked VP 用）

エージェントは次の操作を実行できます：

• 自身のクレデンシャルを一覧表示する
• 新しいクレデンシャルを受け入れる
• 他のエージェントのクレデンシャルにアクセスする（公開されている場合）

---

11. 🌐 OAuth 保護対象リソースのメタデータ

次の場所で公開されます：

/.well-known/oauth-protected-resource/mcp

次の情報が含まれます：

• 対応する認証方式
• リソース識別子
• 信頼できる認可サーバー

OAuth2 クライアントやゲートウェイによる自動設定が可能になります。

---

12. 🛡️ 責任ある AI 機能

Wallet4Agent は、人間が関与する要件をサポートしています：

{
  "always_human_in_the_loop": true
}

次の用途に使用されます：

• 高リスクの操作
• 機密性の高いクレデンシャルの受け入れ
• 人間によるレビューへのエスカレーション

---

🧩 13. 開発者向け概要

エージェント開発者にとって、Wallet4Agent は次の機能を提供します。

機能	得られるもの
🆔 エージェントのアイデンティティ	DID + DID Document
🔑 認証	Dev PAT、Agent PAT、OAuth2 Client Credentials、private_key_jwt
🔐 暗号鍵	Cloud KMS 署名、エクスポート不可
📜 クレデンシャルの発行	OIDC4VCI を完全サポート（SD-JWT VC と VC JSON-LD）
✅ クレデンシャルの検証	シンプルな MCP ツールと安全な派生クレームを使った OIDC4VP
👤 人とのインタラクション	QR コード → ウォレット → 検証済み属性
🤝 エージェント間の信頼	他のエージェントのクレデンシャルを検査する機能（認可されている場合）
⚙️ 設定	認証モード、鍵、ポリシーをすべて MCP 経由で管理可能
🛡️ セキュリティ	KMS、OAuth2、DID のローテーションと鍵の更新、ロール分離されたトークン

AI エージェントは検証可能なデジタルエンティティとなり、セキュリティと説明責任を維持しながら、分散型および規制対象のデジタルアイデンティティのエコシステムに参加できます。

---

メンテナー： Wallet4Agent (Web3 Digital Wallet / Talao )
フィードバックや追加ドキュメントについては、Wallet4Agent のウェブサイトにある連絡先をご利用ください。

標準	目的	リンク
DID Core	DID の中核仕様	https://www.w3.org/TR/did-core/
Linked Verifiable Presentations	DID Documents 内の公開 VC	https://identity.foundation/linked-vp/spec/v1.0.0/
OIDC4VCI	クレデンシャルの発行	https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html
OIDC4VP	クレデンシャルの提示	https://openid.net/specs/openid-4-verifiable-presentations-1_0.html
W3C Verifiable Credentials	VC データモデル	https://www.w3.org/TR/vc-data-model-2.0/
SD-JWT VC (IETF)	選択的開示クレデンシャル形式	https://www.ietf.org/archive/id/draft-ietf-oauth-sd-jwt-vc-12.html