wallet-verifier-mcp

🏗️ Wallet4Agent — 技术栈概览

面向能够与个人、公司、服务和其他 Agent 互动的可信 AI Agent 开发者

Wallet4Agent 提供 AI Agent 在现实世界中安全运行所需的信任层。
本文档介绍该平台背后的技术组件、标准和身份机制。

---

1. 🎯 Wallet4Agent 的用途

AI Agent 正在承担越来越多的操作、访问数据并开展协作。
要安全地完成这些工作，它们必须能够：

• 🆔 证明自己的身份
• 👤 证明谁拥有或控制它们
• 📄 持有可验证凭证
• 🔐 安全地签署操作和数据
• 🔗 信任用户、公司和其他 Agent
• 🪪 在不依赖脆弱 API 密钥的情况下向外部系统进行身份验证

Wallet4Agent 为 AI Agent 提供：

• 基于 DID 的身份
• 用于存放凭证的安全钱包
• 由云 KMS 支持的签名密钥
• 与 OIDC4VCI、OIDC4VP、SD‑JWT、JSON-LD、OAuth2 的互操作性
• 面向 Agent 的 MCP 服务接口

所有功能均基于标准构建，并可互操作。

---

2. 🧱 架构概览

Wallet4Agent 由三个协同工作的层构成：

2.1 🖥️ MCP 服务（Model Context Protocol）

• 单一端点：
  POST https://wallet4agent.com/mcp
• 将所有操作作为工具提供：
  • 身份创建
  • 凭证签发
  • 验证流程
  • 签名操作
  • 配置

2.2 👛 身份钱包

管理：

• Agent 的 DID 和 DID Document
• 已存储的凭证（SD‑JWT VC、VC JSON‑LD）
• 关联的可验证展示
• 钱包元数据和服务端点

2.3 🔐 授权与验证层

支持：

• OAuth2 访问令牌
• OIDC4VCI（凭证签发）
• OIDC4VP（展示）
• 用户验证流程
• Agent 间身份验证

所有复杂的加密和身份逻辑都由 Wallet4Agent 处理。
你的 Agent 只需调用 MCP 工具。

---

3. 🆔 身份层（DID 和 DID Document）

每个 AI Agent 都会获得符合 W3C DID Core 规范的去中心化标识符（DID）。

Wallet4Agent 支持两种 DID 方法：

---

3.1 🌐 did:web（基于 DNS 的身份）

一种以域名为锚定的 DID。

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

⭐ 特征：

• 可通过 HTTPS 轻松解析
• DID Document 位于：
  https://wallet4agent.com/did/<agent-id>
• 非常适合 SaaS Agent
• 易于阅读，且便于与基础设施集成
• 适用于企业或平台关联的 AI Agent

🔗 DID:web 规范：
https://www.w3.org/TR/did-spec-registries/#did-method-web

---

3.2 ⛓️ did:cheqd（基于账本的身份）

一种以 Cheqd 去中心化账本为锚定的 DID。

did:cheqd:<network>:<identifier>

⭐ 特征：

• 防篡改的 DID Document 存储在账本上
• 支持以账本为锚定的密钥、密钥轮换和服务端点
• 适用于：
  • 高可信身份
  • 受监管环境
  • 信任注册表
  • 去中心化合规生态系统

🔗 DID:cheqd 规范：
https://docs.cheqd.io/identity/

---

4. 📄 DID Documents

无论采用哪种 DID 方法，DID Document 都会公开：

• 🔑 公钥
• 🔐 身份验证方法
• 📌 服务端点
• 🧾 关联的可验证展示
• 🧬 密钥类型（JWK、Ed25519 等）

以下情况发生时，DID Document 会自动更新：

• 密钥轮换
• 注册新的开发者密钥或 Agent 密钥
• 凭证作为关联 VP 发布
• 身份验证方法发生变化

外部 Agent 和服务会使用 DID Document 来验证签名、凭证和关联证明。

---

5. 🔗 链接式可验证演示（Linked VP）

Linked VP 允许 Wallet4Agent 将可验证凭证作为引用发布在 DID 文档中。

这很重要，因为：

• 公开凭证可供发现
• 第三方可以验证 Agent 的能力
• 适用于：
  • 企业授权
  • Agent 能力
  • 服务信任信号
  • 合规性证明

支持的格式：

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

规范：
https://identity.foundation/linked-vp/spec/v1.0.0/

---

6. 🔐 密码学与密钥管理

6.1 🗝️ 由云 KMS 支持的密钥（不可导出）

每个 Agent 都有专属的云 KMS 密钥。

用于：

• 为可验证演示签名
• 在 OIDC4VCI 中证明密钥所有权
• 用于 OAuth2 客户端身份验证的 JWT
• 内部签名操作

优势：

• 私钥绝不会离开 KMS
• Agent 身份与安全的执行环境绑定
• 高保障级别的签名

6.2 🔑 开发者提供的密钥

开发者可以注册其他公有 JWK：

• 用于 OAuth private_key_jwt
• 用于自行管理密钥的 Agent 框架
• 用于企业签名密钥

Wallet4Agent 存储公有密钥；开发者保留私钥。

---

7. 🔑 身份验证方法

Wallet4Agent 支持三种 Agent 身份验证流程：

7.1 🔹 Agent 个人访问令牌（PAT）

Authorization: Bearer <agent_pat>

简单有效，适用于开发或本地 Agent。

7.2 🔹 OAuth2 客户端凭据

Agent 会收到：

• client_id = Agent DID
• client_secret

然后使用以下内容进行交换：

grant_type=client_credentials

适用于大多数生产环境请求。

7.3 🔹 OAuth2 private_key_jwt

安全性最高的方法：

• 开发者注册公有 JWK
• Agent 使用其私钥对 JWT 签名
• Wallet4Agent 使用已注册的公有 JWK 对其进行验证

适用于硬件支持的密钥和企业基础设施。

---

8. 🧾 凭证签发（OIDC4VCI）

Wallet4Agent 负责处理完整的凭证签发流程：

• 获取签发方元数据
• 获取 OAuth 令牌
• 使用 Agent 的 KMS 密钥签署密钥所有权证明
• 请求凭证
• 将凭证存储为证明

支持的格式：

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

Agent 只需调用 MCP 工具——所有协议级工作均由 Wallet4Agent 完成。

---

9. 🧪 验证（OIDC4VP）

Wallet4Agent 支持验证：

• 自然人
• 其他 Agent
• 基于凭证的访问

Agent 可以：

• 启动用户验证
• 轮询状态
• 安全地接收经过验证的属性
• 对等 Agent 身份验证

Agent 不会看到敏感令牌；返回的只有经过派生处理的安全声明。

---

10. 📦 凭证存储与检索

Wallet4Agent 将凭证存储为证明，包括：

• 格式
• 签发方
• VCT/VC 类型
• 有效期
• 加密后的负载
• 发布状态（用于 Linked VP）

Agent 可以：

• 列出自己的凭证
• 接收新凭证
• 访问其他 Agent 的凭证（如果已发布）

---

11. 🌐 OAuth 受保护资源元数据

发布于：

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

包含：

• 支持的身份验证方法
• 资源标识符
• 受信任的授权服务器

支持 OAuth2 客户端和网关自动配置。

---

12. 🛡️ 负责任 AI 功能

Wallet4Agent 支持人在回路中的要求：

{
  "always_human_in_the_loop": true
}

用于：

• 高风险操作
• 敏感凭证的接收
• 升级至人工审核

---

🧩 13. 面向开发者的总结

如果你是 Agent 开发者，Wallet4Agent 为你提供：

功能	你将获得什么
🆔 Agent 身份	DID + DID Document
🔑 身份验证	开发者 PAT、Agent PAT、OAuth2 Client Credentials、private_key_jwt
🔐 加密密钥	Cloud KMS 签名，不可导出
📜 凭证签发	完整支持 OIDC4VCI（SD-JWT VC 和 VC JSON-LD）
✅ 凭证验证	通过简单的 MCP 工具和安全的派生声明实现 OIDC4VP
👤 人机交互	二维码 → 钱包 → 已验证的属性
🤝 Agent 间信任	能够检查其他 Agent 的凭证（需获得授权）
⚙️ 配置	可通过 MCP 管理身份验证模式、密钥和策略
🛡️ 安全性	KMS、OAuth2、DID 轮换与密钥更新、按角色分离的令牌

你的 AI Agent 将成为可验证的数字实体，能够参与去中心化且受监管的数字身份生态系统，同时保障安全性和问责能力。

---

维护者： 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