Files
synapse/docs/00-record/2026-06-29-v1-draft-discussion.md
2026-06-29 02:12:44 +08:00

4.7 KiB
Raw Permalink Blame History

会议记录:v1 草案讨论会

日期:2026-06-29 时长:1 session 主题:灵隙 v1 版本身份协议草案讨论 & 版本规划


会议议题

围绕 v1 身份协议草案 的技术方案与版本规划进行讨论。


决议事项

决议一:签名机制统一为非对称签名

项目 内容
结论 直接统一到非对称签名体系
默认算法 Ed25519(高效、安全)
兼容算法 ECDSA-P256(跨链互操作)、ECDSA-secp256k1(兼容以太坊系)
HMAC 定位 降级为可信内网链路的可选优化,不作为协议层的签名方案
影响范围 Raw协议 第4章签名机制需重写,统一为公钥签名;signature 字段含义从 HMAC 变更为 Ed25519/ECDSA 签名值;signature_algorithm 字段保留,默认值改为 Ed25519

决议二:区块链作为身份协议的核心组成部分

项目 内容
结论 区块链不是可选插件,而是身份协议的核心层
定位 三层发现架构中,区块链作为"最终一致性源"(Source of Truth)
默认基础设施 每个 Synapse 网络应至少有一个链上注册表,作为 Agent 身份的最终存证
兼容性 支持多链:Ethereum(高价值)、Polygon(高频)、联盟链(企业)
混合模式 本地缓存 + DHT 做快速查找,区块链做最终验证和仲裁

决议三:DHT 分阶段实现

阶段 范围 说明
Phase 1(v1.0) 广播查询 + 中心目录 小型网络(<100 Agent),用灵脉 Meridian 作为可选目录,无 DHT
Phase 2(v1.1) 分层 DHT 中等规模(100-10000 Agent),引入分层路由
Phase 3(v1.2) 完整 Kademlia + 隐私保护 + 密钥轮换 大规模网络(>10000 Agent),支持密钥轮换和隐私保护

决议四:七大组件实现推迟到 v1.1

项目 内容
结论 v1 版本聚焦协议层定义(数据格式、消息类型、行为约束),不做具体落地实现
v1 范围 Raw / A2A / A2N / P2A 四个协议规范 + 去中心化身份草案
v1.1 范围 七大组件(灵脉/灵玺/灵鉴/灵泊/灵瞰/灵衡/灵枢)的具体落地实现
v1.2 范围 完整 Kademlia DHT、隐私保护机制、密钥轮换、跨链互操作

补充讨论要点

1. 协议层与实现层的明确边界

v1 的身份草案目前包含部分实现细节(如 Solidity 合约代码),需要在 v2 版本中剥离:

  • 协议层(v1):只定义 AgentID 格式、签名算法、消息类型、生命周期状态机
  • 实现层(v1.1+):具体的区块链合约实现、DHT 协议栈、缓存策略

2. AgentID 命名空间治理

问题 方案
namespace 的分配 官方保留 synapse: 前缀;企业自定义采用反向域名(如 com.mycompany.agent:)
alias 全局唯一性 不要求全局唯一,仅在本地或联盟内有效
DID 兼容 did:synapse: 独立成体系,与 namespace:key_hash:alias 格式并存

3. 签名算法选择理由

选择 Ed25519 作为默认算法的原因:

  • 比 ECDSA-P256 快 2-3 倍
  • 固定长度签名(64 字节),便于编码和存储
  • 抗侧信道攻击,实现简单
  • 所有主流语言均有成熟实现

4. 区块链选择建议

场景 推荐 理由
开发/测试 本地 Hardhat 私链 零成本、完全可控
企业联盟 Hyperledger Fabric / 联盟链 隐私、可审计
公网生产 Ethereum L2(Arbitrum/Optimism) 低 Gas 成本、继承 L1 安全
高频场景 Polygon / Solana 确认快、成本低

附录:关联文档

文档 说明 关系
v1 身份草案 现有 v1 身份协议草案 本次讨论的基础文档
身份草案 v2 根据本次决议更新的草案 基于本次决议生成
Raw协议 原始协议定义 签名方案受影响需更新
v1 索引 v1 版本索引 版本范围需更新

后续行动

事项 负责人 目标版本 状态
更新 Raw 协议签名方案 - v1.0 待办
更新身份草案为 v2 版本 ✅ 已完成 v1.0 完成
更新 v1 索引文件版本范围 - v1.0 待办
起草七大组件规范 - v1.1 待启动
起草 DHT 实现规范 - v1.1 待启动
链上合约实现 - v1.1 待启动