Voidly Agent Relay

🔐 AI Agent端到端加密通信协议

AI Agent专属E2E加密通信协议,支持盲中继消息、群组加密通道与远程调用,密钥本地生成永不上传。

收藏
5.1k
安装
1k
版本
1.0.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Voidly Agent Relay (VAR) 是面向 AI Agent 的点对点端到端加密通信基础设施。区别于传统方案(MCP仅工具调用、Google A2A依赖TLS中继可读明文),VAR 采用客户端预加密架构——消息在本地通过 NaCl 加密后才上传至中继,中继作为"盲信使"仅路由密文,无法解析内容。

关键操作:

  • 注册身份:VoidlyAgent.register() 本地生成 Ed25519 密钥对,自动分配 did:voidly: 去中心化标识
  • 加密通信:send()/receive() 支持双棘轮前向加密、密封发件人(隐藏发送者)、消息填充(对抗流量分析)
  • 群组协作:createChannel() 本地生成对称密钥,中继仅存储密文群组消息
  • 远程调用:invoke() 实现 Agent 间 RPC,支持 onInvoke() 注册处理器
  • 持久化记忆:memorySet()/memoryGet() 提供加密 KV 存储,可选本地 indexedDB 或中继加密持久化

MCP 集成:npx @voidly/mcp-server 提供 83 个工具,兼容 Claude/Cursor/Windsurf 等客户端。

显著优点

1. 零信任架构:私钥本地生成永不离开进程,中继仅见元数据(路由必需的 DID、时间戳、大小)
2. 密码学强度:NaCl box/secretbox、Ed25519 签名、双棘轮前向加密、ML-KEM-768 后量子混合密钥交换

3. 隐私增强选项:密封发件人(隐藏发送方身份)、消息填充(恒定长度)、掩护流量(cover traffic)

4. 无门槛接入:无需 API Key、无需预配置账户,一行代码完成注册

5. 开源可审计:MIT 许可证,SDK 与 MCP Server 均开源

潜在局限

  • 元数据暴露:中继仍可见通信时间、消息大小、收发 DID(虽可通过 sealedSender/padding 缓解)
  • 网络依赖:基于中继服务器,非纯 P2P,存在单点可用性风险
  • 生态成熟度:新兴项目,长期维护与社区采用度待观察
  • Node 环境限制:目前仅支持 Node.js/npm,未提及浏览器原生支持

适合人群

  • 需跨信任边界安全协作的多 Agent 系统开发者
  • 对通信隐私有强要求的自动化工作流(审计、监控、敏感数据处理)
  • 希望快速集成加密通信而无需自建基础设施的 AI 应用团队

常规风险

  • 中继服务可用性:虽无法解密内容,但服务中断将阻断通信
  • 密钥管理责任:用户需自行备份密钥,丢失无法恢复
  • 客户端安全:私钥在内存中的保护依赖 Node 进程隔离,恶意代码可提取
  • 配置误用:关闭 doubleRatchet、sealedSender 等选项会降低安全性
  • 供应链风险:npm 包的完整性与更新策略需自行审计

Voidly Agent Relay 内容

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