Web3 交易系统
报告与验证记录

2026-10-12 v0.5:业务闭环架构开发与验证

本轮按用户授权落实生产架构阶段 A:模块化单体、完整链历史、已确认事件索引、跨系统只读对账与基础告警。模拟 v0.3 的注册/登录/管理员和资产逻辑保留,链模式不共享赠币。设计见 v0.5,部署见 链部署。

实际改动#

  • history.go / Web3History.tsx:订单、最终成交、任务、事件 keyset 分页,钱包筛选,公开详情;原 state 最近100项与原 tasks 数组兼容保留。OpenAPI升级0.5.0并生成TS,游标绑定数据集、筛选与插入上界,各页状态可更新。
  • tasks.go:旧任务表事务升级 schema 2、version CAS、不可回退终态、已签raw/hash/nonce保护、创建/更新时间和原因。旧时间为0,不捏造历史;日志 schema 1及Domain编码不变。
  • index.go:固定blockHash读取确认块日志,父块连续性、事件唯一键、事件/游标同事务,从创世补拉且每轮64块,重启不丢/不重复;深重组停止,不自动回滚filled。
  • reconcile.go:固定完整投影水位后独立重放日志,检查全部订单/意图/守恒/outbox/任务/索引事件,核对SQL状态与payload;PG只读快照为REPEATABLE READ。差异与异步lag分开,无自动修钱或补发。
  • observability.go / main:结算、索引、采样独立调度;30秒观测、请求耗时histogram、索引落后、最老任务/outbox、对账差异/lag、采样失败与worker错误。只在回环开放/check与metrics;8条Prometheus规则,未配置消息通知。
  • 全部当前文档/目标同步,历史设计注明适用版本,历史 reports/evidence不改写。新增源码、测试、前端、脚本与部署配置均有中文注释。

实际执行证据#

验证 证据与结果
常规全套 verify、最终verify:格式、mod verify、vet、Go、race、前端44单元、契约生成、构建与SIGKILL恢复
新模块单元 首轮完整链包、最终race:分页、迁移/CAS、事务失败、重启/重组、损坏/终态对账、公开契约与诊断
真实EVM合约 contracts:真实Anvil原子交换、maker价、部分成交、重复/签名/cancel/授权撤回回滚
本地链+浏览器 JSON、日志、截图:12组检查,包括完整历史、详情与原签单刷新恢复
Redis/PG/Kafka race组件、完整链、最终完整链:去重、缓存水位、限流、owner、历史/索引/对账和故障恢复
当前只读容器 构建、闭环:scratch UID10001、命名卷、host网络、原交易恢复及索引/对账
原模拟浏览器 8场景:注册/双账户交易/管理员/分页/待确认恢复全部通过
覆盖率 语句汇总、HTML、逐项JSON:全仓库语句64.1%,backend82.6%,chaintrade见下方统计;链E2E进程不计Go语句覆盖
告警规则 Prometheus配置、promtool用例:8条规则语法,差异/停滞触发与健康不误报,另有指标格式校验;未运行Alertmanager通知
依赖审计 Go、frontend、contracts:Go可达0,另2导入包/1模块未调用漏洞;npm各0。仅代表本次扫描

保留的失败与修正#

首次取消索引等待失败断言最新事件应为CANCELLED,但索引还停在MATCHED。receipt、取消扫描、完整索引各有独立调度;成交对账追平不意味着取消索引已到链头。修正测试为明确等待取消事件可查询,未改资产数据、未跳过事件。后续本地/中间件/容器通过。

前端新历史状态提示使用独立 aria-live,保留原交易页唯一status语义,避免旧浏览器用例选中两个status。新读取在切换类型/钱包后中断旧请求,游标重置,后台业务不受中断影响。

环境、清理与边界#

WSL/Linux、Go1.26.9、Node22.22.3、npm12.0.2;真实Anvil、Redis7.4.2、Postgres17.4、Kafka3.9.0。测试使用随机端口、临时目录和新增PG数据库,不覆盖旧dataset;中间件停止但保留卷,链容器命名卷也保留。源码无Git仓库,不编造commit或远程CI成绩。

没有重新给出容量数字:Apply、FULL受理、HTTP与链最终成交不同;30秒全量对账、每轮64块、单sender和每单一个pending有资源边界。公共链/云/原生Windows/真实钱包扩展兼容性、长时链拥塞、硬件断电、安全审计、交易替换/nonce窗口/DLQ、HA/fencing/复制/分区未完成。Prometheus规则验证不等于生产告警送达,钱包交易对账不等于储备证明。

独立读池:日志/投影的 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,检查不会尝试修复或广播。

最后指标 lint 提示缺少 HELP 说明,保留 初始结果,已补每个 counter/gauge/histogram 的 HELP/TYPE 并通过 promtool。Docker Hub镜像代理DNS失败后改用固定 quay.io Prometheus 镜像,未修改宿主daemon配置。只做规则/指标校验,没有宣称实际通知送达。

最终注释/文档核对见 函数注释、文档链接及围栏、环境、源码摘要。摘要基于当前源码文件,不包含依赖/生成构建产物,不编造commit。

最终链包 Go 语句覆盖率为 55.6%,模块汇总见 coverage-summary。覆盖率不是分支覆盖或正确率;web3server 入口仍为0,真实链/E2E在独立进程验证。

— 本篇阅读完毕 —
来源:Web3 交易系统 / docs / reports/2026-10-12-v0.5.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭