# Soraecho Agent Chain 设计方案 v1.0

**Date**: 2026-08-05  
**Status**: Draft（待评审）  
**Authors**: Soraecho Core Team  
**Target**: Maian OS Team, 社区  

---

## 1. 背景与动机

### 1.1 现状

Soraecho ANP 网络已完成：
- ✅ Phase 4.4 DID 认证（Ed25519 签名）
- ✅ Phase 4.5 E2E 加密（ChaCha20-Poly1305）
- ✅ Phase 4.7 结算预研（SettlementProof/Queue 已完成）
- ✅ AgentCard 含 `chain_address` + `supports_settlement` 字段

**缺失**：A2A 调用后的实际结算（链上转账）尚未实现。

### 1.2 KOAN Chain 的问题

KOAN Chain 开发遇到严重阻碍，导致：
- 结算层无法按时交付
- Soraecho 生态进度被阻塞
- 与 Maian OS 的对接缺少结算能力

### 1.3 新方案：Soraecho Agent Chain

**核心思路**：在 Soraecho ANP 基础上扩展一条**专门为 Agent 服务的区块链**，Maian OS 作为链节点提供网络服务。

**优势**：
1. **自主可控**：不再依赖第三方链的进度和接口
2. **Agent 原生**：链上功能专为 Agent 经济设计（信誉锚定/争议仲裁/DID）
3. **深度绑定**：Maian OS 节点 = 验证者，网络即生态
4. **技术一致**：Go 技术栈，与现有 Soraecho 代码无缝集成
5. **渐进迁移**：Phase A 中心化账本可立即给 Maian OS 使用

---

## 2. 架构设计

### 2.1 三层架构

```
┌─────────────────────────────────────────────────────────┐
│ Layer 3: 生态应用层                                      │
│   Agent 市场 / 预言机 / 信誉社交 / 结算 UI / 治理         │
├─────────────────────────────────────────────────────────┤
│ Layer 2: Soraecho Agent Chain（新）                      │
│   结算账本 / 信誉锚定 / DID 注册 / 争议仲裁 / Token 经济  │
│   共识: PoA → BFT（Maian OS 节点 = 验证者）              │
│   VM: 可选 EVM（智能合约）                                │
├─────────────────────────────────────────────────────────┤
│ Layer 1: Soraecho ANP（现有，不变）                      │
│   A2A 通信 / DHT 发现 / E2E 加密 / Chat / Presence      │
│   ↑ SettlementProof 桥接 ↓                              │
└─────────────────────────────────────────────────────────┘
```

**关键原则**：
- **Soraecho ANP 保持独立**：通信层不依赖链，链是可选扩展
- **桥接方式**：A2A 调用完成后生成 `SettlementProof`，提交到链
- **渐进式**：Phase A 中心化账本 → Phase B PoA 多节点 → Phase C 去中心化

### 2.2 链与 ANP 的桥接

```
A2A 调用完成
    ↓
生成 SettlementProof（已有）
    ↓
提交到 Agent Chain（新）
    ↓
链上执行转账（SORAE Token）
    ↓
结算结果同步回 ANP（信誉更新）
```

**桥接数据结构**（复用现有 SettlementProof）：

```go
type SettlementProof struct {
    ProofID       string    `json:"proof_id"`
    TaskID        string    `json:"task_id"`
    CallerDID     string    `json:"caller_did"`
    TargetDID     string    `json:"target_did"`
    Amount        float64   `json:"amount"`        // SORAE amount
    Currency      string    `json:"currency"`       // "SORAE"
    Timestamp     time.Time `json:"timestamp"`
    CallerSig     string    `json:"caller_signature,omitempty"`
    TargetSig     string    `json:"target_signature,omitempty"`
    CallerChain   string    `json:"caller_chain_address,omitempty"`
    TargetChain   string    `json:"target_chain_address,omitempty"`
    Status        string    `json:"settlement_status"` // pending/confirmed/failed
    BatchID       string    `json:"batch_id,omitempty"`
}
```

---

## 3. 技术选型（深度评估）

### 3.1 共识机制对比

| 方案 | 共识 | 开发成本 | 安全性 | 去中心化 | 适合度 |
|------|------|---------|--------|---------|--------|
| **CometBFT (Cosmos SDK)** | BFT | 中 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ 推荐 |
| **Substrate** | BABE/GRANDPA | 高 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ Maian OS 是 Rust |
| **轻量 PoA** | PoA | 低 | ⭐⭐ | ⭐ | ⭐⭐⭐ 最快上线 |
| **自研 BFT** | 自研 | 极高 | ⭐ | ⭐ | ❌ 不推荐 |
| **EVM 侧链 (Geth fork)** | PoA | 中 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐ 非 Agent 原生 |

**推荐：CometBFT（Cosmos SDK）**

理由：
1. **Go 原生**：Cosmos SDK 是 Go，与 Soraecho 技术栈完全一致
2. **成熟稳定**：Cosmos 生态已验证（Binance Chain、Osmosis 等）
3. **模块化**：可以只启用需要的功能（结算/信誉/DID），不引入多余模块
4. **IBC 兼容**：未来可与其他链互操作
5. **Maian OS 集成**：Maian OS 可以用 Go 写轻节点或 RPC 代理

**备选：轻量 PoA 起步**（如果 Cosmos SDK 太重）
- 用 Go 写一个简化 PoA 共识（基于 Tendermint 论文）
- 验证者集合由 DID 白名单管理
- 1-2 周可上线

### 3.2 智能合约 VM

| 方案 | 说明 | 推荐度 |
|------|------|--------|
| **无 VM** | 链只处理原生交易（转账/结算/信誉），无智能合约 | ⭐⭐⭐ Phase A/B |
| **EVM** | 兼容以太坊智能合约 | ⭐⭐⭐⭐ Phase C（生态兼容） |
| **WASM** | 高性能，Cosmos SDK 原生支持 | ⭐⭐⭐⭐ Phase C（Agent 原生） |
| **MoveVM** | 安全，但生态小 | ⭐⭐ |

**推荐：Phase A/B 无 VM，Phase C 加 EVM/WASM**

理由：
- 初期只需要原生交易（转账/结算/DID 注册）
- 后期需要智能合约时，Cosmos SDK 可以加 `evm` 模块（如 `ethermint`）

### 3.3 代币标准

| 标准 | 说明 | 推荐度 |
|------|------|--------|
| **Cosmos Coin** | Cosmos SDK 原生代币（如 `usorae`） | ⭐⭐⭐⭐ 原生 |
| **ERC-20 兼容** | EVM 模块内的 ERC-20 | ⭐⭐⭐ 兼容生态 |
| **SPL Token** | Solana 标准 | ❌ 技术栈不匹配 |

**推荐：Cosmos Coin 原生 + ERC-20 接口兼容**

---

## 4. 经济模型（Tokenomics）

### 4.1 代币基本信息

| 项目 | 内容 |
|------|------|
| **代币名称** | Soraecho Agent Token |
| **代币符号** | **SORAE** |
| **总供应量** | 1,000,000,000 SORAE（10 亿） |
| **小数位** | 6（最小单位：1 microSORAE = 10^-6 SORAE） |
| **初始分配** | 见 4.3 |

### 4.2 代币用途

| 用途 | 说明 | 优先级 |
|------|------|--------|
| **结算** | A2A 调用的支付（Agent 服务费用） | P0 |
| **Gas** | 链上交易的 Gas 费用 | P0 |
| **质押** | 验证者质押（PoA → PoS 过渡） | P1 |
| **信誉锚定** | 信誉分数上链需要质押 | P1 |
| **治理** | 协议升级投票 | P2 |
| **市场** | Agent 市场购买/订阅 | P2 |

### 4.3 初始分配

| 分配方 | 比例 | 数量 | 解锁方式 |
|--------|------|------|---------|
| **核心团队** | 20% | 200M | 4 年线性解锁（1 年 cliff） |
| **Maian OS 节点** | 15% | 150M | 按节点贡献释放（见 4.5） |
| **社区激励** | 25% | 250M | 生态奖励（A2A 调用激励/流动性挖矿） |
| **生态基金** | 15% | 150M | 投资/合作/Grant |
| **公开销售** | 10% | 100M | 分批发售（IDO/IEO） |
| **空投** | 5% | 50M | 早期用户/开发者空投 |
| **国库** | 10% | 100M | DAO 治理控制 |

### 4.4 代币释放曲线

```
总供应量：1B SORAE
├── 初始流通：150M（15%，空投+公开销售+部分社区）
├── 年释放率：约 20%（前 4 年）
└── 4 年后：全部解锁
```

### 4.5 Maian OS 节点激励

Maian OS 节点作为验证者/服务提供者，获得：

| 激励类型 | 说明 | 数量 |
|---------|------|------|
| **验证者奖励** | 每个区块的 Gas 费分成 | 动态 |
| **A2A 中继奖励** | 中继 A2A 调用的奖励 | 0.1 SORAE/调用 |
| **信誉背书奖励** | 为 Agent 背书（DID 签名）的奖励 | 1 SORAE/月/Agent |
| **数据提供奖励** | 提供链下数据（预言机）的奖励 | 动态 |

**节点准入门槛**（PoA 阶段）：
- 最低质押：10,000 SORAE
- DID 认证：需要 `did:anp:` 或 `did:anp:human:` 身份
- 在线率：> 95%（否则罚没部分质押）

### 4.6 手续费模型

| 交易类型 | Gas 费 | 说明 |
|---------|-------|------|
| **转账** | 0.001 SORAE | 简单价值转移 |
| **A2A 结算** | 0.01 SORAE | SettlementProof 上链 |
| **DID 注册** | 1 SORAE | 永久存储 |
| **信誉更新** | 0.1 SORAE | 定期锚定 |
| **智能合约** | 动态 | EVM 执行 |

**Gas 费分配**：
- 70% 给验证者（Maian OS 节点）
- 20% 销毁（通缩）
- 10% 进国库（DAO 治理）

---

## 5. 功能模块设计

### 5.1 结算模块（Phase A 核心）

**功能**：处理 A2A 调用的结算（转账 + 记录）

**交易类型**：
```go
type SettlementTx struct {
    ProofID     string  // SettlementProof.ProofID
    TaskID      string  // A2A Task ID
    From        string  // caller chain address
    To          string  // target chain address
    Amount      int64   // SORAE amount (micro)
    Nonce       uint64  // 防重放
    Signature   string  // Ed25519 签名
}
```

**流程**：
1. ANP 网络生成 `SettlementProof`
2. 提交 `SettlementTx` 到链
3. 验证签名 + 余额
4. 执行转账
5. 更新 `SettlementProof.Status = "confirmed"`

### 5.2 DID 模块

**功能**：Agent/Human DID 在链上注册和解析

**链上 DID 文档**：
```go
type OnChainDID struct {
    DID         string    // did:anp:xxx
    Controller  string    // 控制者（Agent/Human）
    PublicKey   string    // Ed25519 公钥
    ChainAddr   string    // 链上地址
    RegisteredAt time.Time
    ExpiresAt   time.Time // 需要续期（防止 DID 膨胀）
}
```

**注册费用**：1 SORAE（防止 DID 滥用）

### 5.3 信誉模块

**功能**：Agent 信誉分数定期锚定到链（不可篡改）

**链上信誉记录**：
```go
type OnChainReputation struct {
    DID         string
    Score       float64 // 0-100
    TotalCalls  int
    SuccessRate float64
    AnchoredAt  time.Time
    AnchorProof string // ANP 网络的 Merkle Root
}
```

**锚定频率**：每周一次（或每 100 次调用）

### 5.4 争议仲裁模块

**功能**：A2A 调用失败时的争议处理

**仲裁流程**：
1. 调用方提交争议（附 `SettlementProof` + 证据）
2. 质押 10 SORAE（败诉没收）
3. 随机选择 3-5 个验证者投票
4. 多数决
5. 胜诉方获得质押金

**仲裁费用**：败诉方承担

---

## 6. 实施路线图

### Phase A：中心化账本（1-2 周）— 立即可用

**目标**：给 Maian OS 一个可用的结算 API，不阻塞对方

**内容**：
- [ ] 基于现有 `SettlementQueue` 实现中心化账本
- [ ] 添加余额管理（内存 + 持久化）
- [ ] 实现转账端点（`POST /api/v1/chain/transfer`）
- [ ] 实现余额查询（`GET /api/v1/chain/balance/{addr}`）
- [ ] 实现交易查询（`GET /api/v1/chain/tx/{tx_id}`）
- [ ] 集成 `SettlementProof` 提交（自动转账）

**交付**：Maian OS 可以调用结算 API

### Phase B：PoA 多节点链（3-4 周）

**目标**：去中心化，Maian OS 节点作为验证者

**内容**：
- [ ] 技术选型确认（CometBFT vs 轻量 PoA）
- [ ] 实现 PoA 共识（验证者集合管理）
- [ ] Maian OS 节点注册为验证者（DID 绑定）
- [ ] SettlementProof 作为交易载荷上链
- [ ] 区块浏览器（简单 Web UI）
- [ ] 链上余额/交易查询端点

**交付**：多节点 PoA 测试网

### Phase C：Agent 原生功能（4-6 周）

**目标**：链上功能专为 Agent 经济设计

**内容**：
- [ ] DID 注册上链（DID 模块）
- [ ] 信誉锚定（信誉模块）
- [ ] 争议仲裁（仲裁模块）
- [ ] EVM/WASM 智能合约支持（可选）
- [ ] Agent 市场（链上上架/下架）
- [ ] Tokenomics 部署（SORAE 代币）

**交付**：功能完整的 Agent Chain 测试网

### Phase D：主网与生态（8-12 周）

**目标**：主网上线，生态启动

**内容**：
- [ ] 安全审计（共识/智能合约）
- [ ] 公开销售/空投
- [ ] 主网启动（PoA → PoS 过渡）
- [ ] 与 Soraecho ANP 主网集成
- [ ] Maian OS 主网节点
- [ ] 治理启动（DAO）
- [ ] 生态 Grant 计划

**交付**：Soraecho Agent Chain 主网

---

## 7. 风险评估与对策

### 7.1 技术风险

| 风险 | 概率 | 影响 | 对策 |
|------|------|------|------|
| **共识实现复杂** | 中 | 高 | 用成熟框架（CometBFT），不自研 |
| **链与 ANP 桥接失败** | 低 | 高 | 复用现有 SettlementProof，增量开发 |
| **性能瓶颈** | 中 | 中 | Phase A 中心化，Phase B 优化 |
| **智能合约安全** | 中 | 高 | Phase C 才加 VM，充分审计 |

### 7.2 经济风险

| 风险 | 概率 | 影响 | 对策 |
|------|------|------|------|
| **代币价值归零** | 中 | 高 | 实用优先（结算需求驱动价值） |
| **节点中心化** | 高 | 中 | PoA 阶段接受，Phase D 过渡到 PoS |
| **恶意验证者** | 低 | 高 | 质押罚没机制（PoS 阶段） |
| **代币分配不公** | 中 | 中 | 社区激励占比 25%，透明释放 |

### 7.3 生态风险

| 风险 | 概率 | 影响 | 对策 |
|------|------|------|------|
| **Maian OS 不配合** | 低 | 高 | 深度绑定，Maian OS 是验证者 |
| **开发者不采用** | 中 | 高 | 提供 SDK/文档/激励 |
| **监管风险** | 中 | 高 | 合规优先，Token 实用化（非证券） |

---

## 8. 与 Maian OS 的协作

### 8.1 Maian OS 的角色

| 角色 | 说明 |
|------|------|
| **验证者节点** | 参与共识，验证交易 |
| **网络服务提供者** | 提供 RPC/索引/区块浏览器服务 |
| **A2A 中继** | 见证 A2A 调用，作恶成本高 |
| **DID 背书** | 为 Agent 提供身份背书 |
| **生态入口** | Maian OS 用户 = 链用户 |

### 8.2 协作接口

| 接口 | 说明 | 进度 |
|------|------|------|
| **Settlement API** | ANP → Chain 的结算提交 | Phase A |
| **验证者注册** | Maian OS 节点注册为验证者 | Phase B |
| **DID 解析** | 链上 DID 解析 | Phase C |
| **信誉锚定** | ANP 信誉 → 链上锚定 | Phase C |

### 8.3 协作时间表

| 时间 | Maian OS 侧 | Soraecho 侧 |
|------|------------|------------|
| **Week 1-2** | 评审本方案 | 完成 Phase A |
| **Week 3-4** | 准备验证者节点 | 完成 Phase B（PoA） |
| **Week 5-8** | 测试网验证者 | 完成 Phase C（功能） |
| **Week 9-12** | 主网节点 | 完成 Phase D（主网） |

---

## 9. 与 KOAN Chain 的关系

### 9.1 并行方案

- **Soraecho Agent Chain**：自主开发，进度可控
- **KOAN Chain**：如果 KOAN 复活，可以兼容（EVM 接口）

### 9.2 兼容策略

如果 KOAN Chain 后续完成：
- Agent Chain 可以作为 KOAN 的 Layer 2（结算汇总）
- 或作为独立链，KOAN 作为跨链桥接目标

---

## 10. 下一步行动

### 10.1 立即（本周）

1. **评审本方案**：Soraecho 团队 + Maian OS 团队
2. **确认技术选型**：CometBFT vs 轻量 PoA
3. **启动 Phase A**：基于现有 SettlementQueue 实现中心化账本

### 10.2 短期（1-2 周）

1. **Phase A 交付**：结算 API 上线，Maian OS 可用
2. **写 Phase B 详细设计**：共识/验证者管理/交易格式
3. **Maian OS 对接**：确认验证者节点规格

### 10.3 中期（1-3 月）

1. **Phase B 测试网**：PoA 多节点
2. **SORAE Tokenomics 细化**：释放曲线/激励计算
3. **社区预热**：公开方案，收集反馈

---

## 11. 总结

| 项目 | 内容 |
|------|------|
| **方案** | Soraecho Agent Chain（Agent 专用链） |
| **技术选型** | CometBFT（推荐）或轻量 PoA |
| **代币** | SORAE（10 亿总量） |
| **Maian OS 角色** | 验证者节点 + 网络服务 |
| **Phase A** | 1-2 周，中心化账本，立即可用 |
| **Phase B** | 3-4 周，PoA 测试网 |
| **Phase C** | 4-6 周，Agent 原生功能 |
| **Phase D** | 8-12 周，主网上线 |
| **与 KOAN 关系** | 并行，兼容 EVM |

---

**End of Design Document v1.0**