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

v0.6 实现与验证记录

本轮按“能够手动跑完验收”的要求实现发售业务,并根据用户中途确认把消息队列从 Kafka 改为 RabbitMQ。历史报告和证据不修改。本页对应当前源码,环境和命令见测试说明,逐步操作见验收手册。

实际完成#

新增 FlashSale 合约、独立 Go saleserver/flashsale、钱包会话、SQL 库存与资格事务、outbox/inbox、签名 Worker、确认索引、安全过期回收、回环对账/指标、OpenAPI 与生成类型、活动页和本地 EIP1193 双钱包。发售复用既有 ERC20,到账后进入原二级市场,不把库存写入单写者 Engine。

RabbitMQ 适配由两个业务共享:持久 quorum 队列、persistent 消息、mandatory、publisher confirm、prefetch、SQL 后手动 ack、重连与原 ID 重投;发售坏消息进 SQL 隔离,交易永久坏消息进入 .dead。compose、入口环境变量、测试和当前文档同步,移除 Go 的 franz-go 依赖。旧 Kafka 卷/报告保留,不提供自动迁移旧 broker 未落库消息的工具。

前端使用 Carbon 纯色和直角布局:四步主操作、实时库存/余额、明确倒计时、钱包切换、刷新恢复、交易观察和失败提示、移动端先显示购买面板。余额加载前不误报不足,资格恢复完成前不发新请求,禁用浏览器存储时阻止无法恢复的操作。使用真实本地链签名和转币,不伪造成功状态。

Windows 入口独立安装 bin/windows-sale 依赖,处理 Anvil POSIX postinstall 和 PowerShell UTF8 BOM 兼容;本轮原生启动成功。早期 backend 目录同步、恢复进程死锁及静态路径回归已修复;Windows 文件级同步仍不等价于 Unix 目录 fsync。

本轮实际结果#

  • 原生 Windows 全 Go 测试和 go vet 通过。
  • WSL Linux 全包 race 通过。
  • SQLite 发售组件、真实响应 OpenAPI 契约、坏消息隔离通过;PG 适配同一组测试通过,SQLite 文件重开项明确跳过。
  • 真实 RabbitMQ 发布确认、persistent、未 ack 重投、连接重建和死信通过。
  • 合约编译通过;Settlement 和 FlashSale 两组真实 Anvil 测试通过。
  • 前端 46 个单元用例、三个生成契约一致性、格式、类型与生产构建通过。
  • SQLite 与 PG/Redis/RabbitMQ 两种独立链集成:真实购买、精确币差、重复/权限、硬杀恢复、链停止时拒绝新准入且不按本地时间回收、确认过期后回收、深重组持久冻结;稳定锚点对账差异为零。
  • 浏览器验证桌面/390px、刷新恢复、购买成功、售罄按钮;一键完整环境进一步验证 A 发售购买后卖出、B 买入,两张二级订单 FILLED。
  • 原二级市场完整 RabbitMQ/PG/Redis 模拟验证通过:pending/finalized、守恒、重试、撤单、分页/索引/对账、广播硬杀复用原 raw/hash/nonce、浅/深重组。
  • npm 依赖审计初次发现问题,更新 Vite、minimatch override 和 follow-redirects;复查无已知漏洞。不是独立安全审计。

证据保存在 evidence-sale-v0.6 ↗。passed 标识、日志、实际交易 hash、截图和失败 fixture 单独保存;没有新容量结论。

开发中发现并修复的问题#

问题 修复与证明
本地 signer key 长度错误 使用固定公开测试字符串导出的 32 字节 key;合约/Go 跨语言签名和真实购买通过
既有资格重试绕过请求键 重试也走事务校验,跨活动同键返回冲突;集成保留断言
坏消息 JSON 部分解码后 dataset 正确导致永久重试 统一 receiveRecord 分类;永久错隔离,SQL 错重试;单测证明
Expire 锚点只检查 hash 同时验证持久块 timestamp,禁止伪造时间回收
PG 测试共享游标/数据 每个组件用例独立随机 schema,测试后仅清自己 schema
Store.Open 错误路径先关 DB 后回滚 先 rollback 再 Close,避免等待未释放连接
重组测试回退后使用缓存高度 直接 eth_blockNumber 填到原确认水位;初次失败证据保留
原交易集成 Windows 启动无 exe 后缀 按平台构建/启动同一真实路径;完整回归通过
Windows PowerShell 中文尾部乱码吞行 新入口保存 UTF8 BOM,原生脚本验证
WSL 空闲后关闭 Docker 本轮脚本维持自己的 WSL 保活子进程,退出只清自身

交付边界#

已交付本地手动验收和可复现自动化,不宣称生产发布。公共测试网/云、真实扩展、合约审计、长期容量、硬件断电、生产多节点 RabbitMQ、自动 HA、备份整体恢复、owner 运营 UI、密钥轮换和 EIP1271 仍未覆盖。

默认演示 SQLite 与完整 PG 模式清楚区分。现有二级市场本金来自钱包,发售 seller 库存预存属于新增保管边界;每钱包不等于每人,确认深度不等于所有链的协议 finalized。历史 Kafka 成绩不重命名成 RabbitMQ 成绩。

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