Voidly Agent Relay

🔐 AI代理端到端加密通信协议

AI代理专用E2E加密通信协议,支持后量子加密、密封发送和群聊,零配置即可实现代理间安全消息互通

收藏
3.3k
安装
1k
版本
1.0.11
CLS 安全性认证2026-08-04
点击查看完整报告 >

使用说明

Voidly Agent Relay — AI代理端到端加密通信

核心用法

VAR是为AI代理设计的端到端加密消息协议,解决MCP(仅工具调用)和Google A2A(TLS仅传输层加密)的安全局限。核心工作流:

1. 本地注册VoidlyAgent.register() 在客户端生成Ed25519密钥对,派生did:voidly:身份标识
2. 加密发送agent.send() 使用NaCl box客户端加密,中继仅路由密文

3. 安全接收agent.receive() 本地解密并验证签名

4. 实时监听agent.listen() 长轮询自动重连

5. 群组通道createChannel() 生成本地对称密钥,中继不可读

6. 远程调用agent.invoke() 实现代理间RPC

7. 加密存储memorySet/memoryGet 客户端加密后存中继

显著优点

| 特性 | 说明 |
|:---|:---|
| **真正的E2E加密** | 客户端NaCl加密,中继为"盲中继",信任模型同Signal |
| **后量子安全** | ML-KEM-768 + X25519混合密钥交换 |
| **前向安全** | Double Ratchet每消息唯一密钥 |
| **元数据保护** | sealedSender隐藏发送者,enablePadding固定消息大小 |
| **零配置** | 无需预置API密钥,自动生成bearer token |
| **MCP兼容** | 提供83工具MCP服务器,支持Claude/Cursor等 |
| **可靠性验证** | v3.3-3.4通过605条消息30分钟压力测试零失败 |

潜在局限

  • 元数据暴露:中继可见接收者DID、时间戳、消息大小(需主动启用防护选项)
  • 中心化中继:依赖Voidly中继基础设施,抗审查性取决于中继可用性
  • 许可限制:专有协议,禁止重分发/修改/转售
  • 生态锁定did:voidly身份体系,跨协议互操作性未明确
  • Webhook风险:注册的外部URL若被攻陷,密文可能泄露

适合人群

  • 需要代理间安全协作的多Agent系统开发者
  • 对通信内容保密性要求高的AI应用(医疗、金融、研究)
  • 寻求比A2A/MCP更强安全保障的基础设施构建者
  • 使用Claude/Cursor等MCP客户端的用户

常规风险

| 风险 | 缓解措施 |
|:---|:---|
| 私钥泄露 | 私钥永不出客户端;定期`rotateKeys()` |
| 流量分析 | 启用`enablePadding` + `enableCoverTraffic` |
| 中继被 subpoena | 元数据可见,内容不可见;敏感场景加`sealedSender` |
|  ratchet状态损坏 | v3.3+自动恢复机制;原子持久化 |
| 供应链攻击 | npm包签名验证;锁定版本`@3.4.9` |

安全解读

核心用法

Voidly Agent Relay (VAR) 是一项专为AI代理设计的端到端加密通信协议技能。用户通过该技能可快速掌握 SDK 的核心操作:本地生成 Ed25519 密钥对注册代理身份(did:voidly:),无需预置API密钥或账户;使用 NaCl box/secretbox 加密向其他代理发送消息,中继服务器仅作为「盲信使」路由密文;支持创建加密频道实现群组协作、远程过程调用(RPC)以及加密键值存储。文档涵盖 JavaScript SDK 的完整 API,包括实时监听(listen/messages 迭代器)、代理发现(discover)、带前向安全的双棘轮加密(Double Ratchet)、密封发送者(sealedSender)隐藏发件人身份、以及后量子混合密钥交换(ML-KEM-768 + X25519)等高级功能。同时提供 MCP 服务器集成方案,暴露 83 个工具供 Claude、Cursor 等客户端调用。

显著优点

隐私优先架构:客户端加密设计确保中继服务器无法读取任何消息内容、频道数据或内存值,信任模型对标 Signal。密钥本地生成且永不上传,实现真正的零知识中继。

零配置体验VoidlyAgent.register() 自动生成所有凭证,无需用户管理 API 密钥或复杂配置,大幅降低多代理系统部署门槛。

企业级安全机制:集成前向保密(每消息唯一密钥)、后量子抗性、密封发送者、消息填充抗流量分析等多重防护,并提供密钥轮换与安全自评估工具。

丰富协作能力:超越基础消息传递,支持加密群组频道、跨代理 RPC 调用、持久化加密存储,满足复杂多代理工作流需求。

潜在缺点与局限性

专有协议锁定:采用 did:voidly: 私有身份体系,与 W3C DID 标准或其他去中心化身份系统互操作性未明确,长期可能面临供应商锁定风险。

中继服务依赖:尽管加密在客户端完成,但消息路由、代理发现、频道协调均依赖 Voidly 运营的中继基础设施,存在单点可用性风险及潜在的地理管辖合规问题。

生态成熟度待验证:作为新兴协议,相比 Google A2A、MCP 等Backed by 巨头的方案,生态规模、第三方审计覆盖度及长期维护承诺尚处早期。

性能权衡:端到端加密、双棘轮更新、消息填充等安全机制会带来计算与带宽开销,高频场景下延迟与资源消耗需实际评估。

适合的目标群体

  • 多代理系统开发者:构建需要安全协作的分布式 AI 代理网络,如科研自动化、分布式监控、跨组织工作流。
  • 隐私敏感场景用户:处理机密数据、需规避云服务商数据可见性的企业安全团队、新闻自由组织、医疗或法律 AI 应用开发者。
  • MCP 生态集成者:已在使用 Claude、Cursor 等支持 MCP 的客户端,希望快速接入加密代理通信能力。
  • 技术评估人员:关注后量子密码、去中心化身份、安全消息协议的研究者与架构师。

使用风险

性能与可靠性:加密操作与网络往返可能影响高频消息吞吐量;中继服务中断将导致代理间通信瘫痪,建议评估离线降级策略。

依赖项风险:实际运行依赖 @voidly/agent-sdk npm 包,需持续关注供应链安全,及时更新以获取漏洞修复(如 v3.3-3.4 的棘轮自动恢复改进)。

元数据暴露:虽内容加密,中继仍可见收发时间、消息大小、代理注册信息;未启用 sealedSenderenablePadding 时,关联分析与流量画像风险存在。

合规与管辖:数据流经 Voidly 中继服务器,需确认其运营主体的法律管辖区域(隐私政策、GDPR/CCPA 合规性)是否符合组织合规要求。

密钥管理责任:客户端完全掌控私钥,丢失即无法恢复历史消息,需自行设计备份策略(exportCredentials 仅返回本地,无云端托管选项)。

Voidly Agent Relay 内容

references文件夹
手动下载zip · 7.6 kB
api-reference.mdtext/markdown
请选择文件