# v0.5：可查询、可对账、可观测的链结算平台

本页保留 v0.5 的订单、索引和对账协议背景；v0.6 已独立实现[固定价限量发售](../02-architecture/flash-sale-design.md)，并把两类业务的消息队列改为 RabbitMQ。下文 Kafka 描述是旧版传输，不作为当前配置或测试结论。总体进度见[现状](../00-overview/current-progress.md)，当前操作和证据见[验收](../04-testing/sale-acceptance.md)与[测试](../04-testing/sale-testing.md)。

本版落实生产架构阶段 A。保持模块化单体，撮合仍是纯单写者；注册登录、管理员和模拟资产体系保留。钱包交易采用原有非托管 EIP-712 授权，不引入金库、自动高可用或新的资金账本。

## 数据与执行顺序

```mermaid
flowchart LR
  Wallet[钱包签单] --> Admission[认证验签及准入]
  Admission --> Journal[SQLite FULL 命令日志]
  Journal --> Core[单写者撮合]
  Core --> Views[订单/成交投影及 outbox]
  Views --> Queue[Kafka 或本地分发]
  Queue --> Tasks[PG 或 SQLite 任务 / raw / nonce]
  Tasks --> EVM[原子结算合约]
  EVM --> Receipt[receipt 校验与确认]
  Receipt --> Journal
  EVM --> Index[已确认事件索引及块游标]
  Views --> Check[只读对账]
  Tasks --> Check
  Index --> Check
```

日志是订单状态权威；任务库是发送原交易的权威；链是实际资产转移权威。索引保存于 chain-views.db，可从区块 0 重建，不能据它重新签名或直接修改核心。每次索引最多 64 个已确认块，逐块验证 parent hash、固定 blockHash 获取日志，事件与游标在一个事务中落盘。未达确认深度的浅重组只影响 receipt 等待；已索引块变化视为深重组，停止进程，由人工核查，绝不自动回滚最终成交。

旧 v0.4 日志仍为 schema 1，不改 Domain 编码。任务 schema 2 事务增加 version 列：旧任务版本为 0，未知时间保留 0；新任务记创建/更新时间、原因、区块高度。Save 使用版本比较更新，拒绝陈旧写入、终态退回以及已经保存的 raw/hash/nonce 改写。INCLUDED→BROADCAST 允许表示浅重组；未知回包仍复用原交易。

## 查询协议

新增 GET /api/web3/history/{orders|trades|tasks|events}，limit 1–100、wallet 可选、cursor 可选。游标绑定数据集、类型、钱包、初始上界和最后 ID；降序 keyset，不使用 OFFSET。列表成员有固定插入上界，但对象状态在后续页读取时可能更新，不承诺跨页快照。trades 只显示最终 CONFIRMED 意图；尚未确认的旧意图之后确认，需刷新第一页面重新看。任务和事件不公开 raw。

GET /api/web3/tasks/{id} 提供任务详情、原因、版本与两笔订单；保留旧 /tasks 数组接口。前端新增订单/成交/任务/事件分页、钱包筛选及任务详情，保留原下单和未知回包恢复。

## 对账与告警

回环诊断 GET /check 从同一投影读事务取得水位和全部对象，重放该水位内日志，对比完整订单/意图及守恒量。另核对任务终态、交易锚点和索引事件。异步分发、核心已确认但任务尚未保存、索引已追到但核心未确认归类 lag；稳定终态冲突归类 difference。对账不等于钱包储备证明，绝不自动修钱、补发交易或跳过日志。运行时数据集绑定核验防止读错任务库。

周期采样在外围运行；指标包括请求耗时 histogram、索引高度/落后块数、任务待处理/最老年龄、outbox 积压、对账差异/延迟和 worker 错误。采样失败显式暴露失败指标，不用零冒充健康。Prometheus 告警规则提供持续积压、索引落后、对账差异、采样失败和错误增长；默认阈值为教学值，部署时按链出块时间和确认深度调整。

## 验证与边界

验证迁移/版本冲突、分页超过 100 项及游标隔离、日志和投影损坏、事件与游标原子性/重启/重组、真实 Anvil/钱包浏览器/三中间件/容器与原模拟回归。报告写入独立 evidence-v0.5，历史报告保留。公共链、云机器、Windows 原生启动及 HA 不以本地验证替代。

阶段 B 的交易替换/nonce 窗口/坏消息隔离，阶段 C 的公共测试网，阶段 D 的复制/fencing/分区保持后续工作。索引从零扫链适合本地演示，公共链需部署起始高度迁移和 RPC 限额策略；10 万条核心历史预算与无快照边界仍保留。

独立读池：日志/投影的 WAL 读取与唯一写连接分开，每读池1连接；SQLite读池query_only，PG任务Reader独立1连接，owner与任务写池仍分别占用专用/业务连接。TestReadSnapshotDoesNotBlockWriter 保持旧水位快照时仍能完成新命令，避免对账占住唯一写池。查询仍有CPU/磁盘与WAL保留成本，需要超时和后续增量策略。

对账还离线验签任务原交易：raw编码、sender、chain/to/value、hash/nonce与calldata都按当前域核对；不需relayer私钥、不调用发送RPC。终态对账测试额外损坏raw，必须报TASK_RAW_INVALID，检查不会尝试修复或广播。
