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

v0.3 当前架构完成与验证报告

历史记录:下方结果与产物属于当时执行,不因后续源码注释/修复而自动更新。最新正确性与故障收集更正见测试完善报告,当前文档一致性见文档审阅报告。原始证据保留,不改写历史成绩。

日期:2026-10-11。用户授权连续开发直到目前架构完成,本轮以既有 P1–P7 为验收范围。单市场/单实例模拟交易,LMAX 单写者核心保持;P8 快照/Redis/分区、高可用与真实链上资产保持独立扩展。设计见v0.3,当前完成矩阵见开发计划。没有 Git 仓库,不编造提交号。

后续测试更正:上一轮 crash_windows_test.go 的 GOOS 文件名使 Linux 未收集精确六窗口用例。本报告原先把该组当作已执行不准确;当时仅普通 crash_check SIGKILL 等已实际运行。本轮改名为 crash_recovery_test.go 后六窗口已实测通过,并修复响应/幂等记忆/投影副本问题,最新证据见测试完善报告。下文旧容量、容器、发布包与漏洞证据均保留为上一轮历史版本,不能代替包含本轮修复的成绩。

1. 本版完成内容#

  • 完整用户/认证与资金审计分页,前端各自翻页;资金结果明确拒绝/重复确认,新增可重建 credit_audit。公共盘口与成交历史路由落地,多笔同 seq 成交分页不遗漏。
  • 运行与恢复有界批投影:整批 FULL 原子事务,提交后释放额度;恢复跳过已投影前缀、补落后部分。旧 schema=0/新 schema=1 业务摘要兼容,seq/hash/未知格式拒绝启动。
  • 独立回环 metrics/标准 pprof、固定标签/数量与阶段计时;核心不读时钟/IO。资源预算配置校验、外围 JSON slog、WS 主动关闭与业务排空。
  • exchangectl init-admin/check/backup/restore/rebuild-views:同一目录锁,独立重放逐表对账,checkpoint/manifest/SHA256/fsync,恢复到新目录;保留坏投影,权威数据不删改。
  • 精确崩溃窗口/事务回滚/过载/取消等待/守恒/权限/容量与恢复基线;verify/E2E/container/load/release 脚本、CI 文件与可校验发布包。
  • 新代码充分中文注释,更新目标/架构/规范/测试/云与容器部署/过程/阅读指南/51 问 QA/精简稿。Go 生成路由与目录拆分按当前 ADR 保留手写/紧凑包,通过静态依赖和契约测试保障边界。

2. 验证结果与原始证据#

检查 实际结果 / 证据
格式、go mod verify、vet、完整测试、race 最终 verify 脚本通过,原始输出
OpenAPI 真实响应 / TS 生成一致性 / build / format 通过,含新增分页/公共路由;verify 输出可复核
精确 SIGKILL R01–R06 更正:上一轮 Linux 未收集,不能由 verify-final 证明;本轮改名后六窗口实际通过,见测试完善报告
事务/背压/退出 单条/批内第二条投影失败全回滚;容量拒绝无日志;取消等待不释放可靠额度;WS 关闭/序号耗尽受控
对账/恢复/损坏 本地 backup/restore 保留会话/订单/余额/原键;manifest 坏字节拒绝;权威坏库/未知 schema/hash/缺口/超前投影拒绝;坏 views 保留重建
领域/随机序列 固定 seed 混合命令逐步检查资金/冻结守恒,1025 match 无部分效果,2^53 后 ID 字符串
浏览器 最终 8 passed,20.1s,含 runner 时间非性能成绩;输出
最终运行镜像 非 root/只读/真实静态页/嵌入契约、重启、在线维护锁拒绝、停机备份恢复到新目录、会话/资金/幂等均通过;输出、资源与 manifest
npm audit 最终 0 vulnerabilities,输出
govulncheck 可达漏洞 0、导入 package 漏洞 0;1 个 required module 漏洞无调用路径,未假称所有模块零漏洞;输出
发布包 v0.3.0 后端/工具/前端/部署/build-info/SHA256SUMS 打包成功并逐文件核验;输出

金额 fuzz 以 2 workers 实际运行 3s,24754 次执行通过,另见 fuzz;不以 fuzz 目标文件存在当成绩。最终 19 份 Markdown 本地链接/代码围栏、26 个 Go 文件格式及 shell/Python 语法检查通过;Compose config 解析和发布包 SHA256SUMS 全部通过。断电、真实磁盘满/fsync 硬件故障、云实机和远程 GitHub CI 未执行,不能由模拟错误/SIGKILL 或 workflow 文件存在替代。

3. 环境与实验方法#

环境为 Linux WSL2 6.6.87.2 amd64、AMD Ryzen AI 7 H 350,16 逻辑 CPU、约 15GiB WSL 可见内存。源代码 /mnt/d,性能数据目录 Linux /tmp(ext4 虚拟盘);不是裸机 SSD。默认 GOMAXPROCS=16,当前 Go 1.26.9、Node 22.22.3、SQLite driver v1.60.1(运行内嵌 3.53.4)、decimal1.4.0/GoDS1.18.1。环境原始信息见environment。

最终核心/日志/恢复实验顺序执行;Go 1.26.0 初轮探索输出与补丁升级后的最终输出分开。最终数据引用 bench-final-* 和 load-go.json,不混用探索阶段数字。短时实验不设不稳定墙钟阈值作为所有 CI 测试门槛。

4. 分层性能#

4.1 核心与日志#

最终 核心/日志原始输出,300ms 每个子基准:

基准 实际耗时 分配 定义/边界
CoreDedupe 76.95ns/op 31B / 2 alloc 既有键确认,无 JSON/hash/网络/存储
CorePlaceCancel 3977ns/op 4511B / 135 alloc 一次下单+一次撤单;每 256 对重置核心,输入预置
CoreMatchPair 9398ns/op 10080B / 302 alloc maker 下单+taker 完整成交,不是单命令 TPS
Journal FULL batch1 2.581ms/批 978B / 15 alloc 已编码输入,仅 SQLite commit
Journal FULL batch16 2.721ms/批 3688B / 148 alloc 没有额外 1ms 聚批等待
Journal FULL batch64 2.891ms/批 13701B / 580 alloc 不含核心/投影/HTTP,不能直接视为完整吞吐

纯核心耗时不是可靠 HTTP 容量。decimal/对象副本分配明显,先记录证据,不未经需要替换金额模型或加入对象池。日志批提交摊销同步写但没有取消耐久屏障。

4.2 开放到达率真实 HTTP#

Go net/http 固定 128 工作者、客户端积压最多 256,延迟从计划到达至响应结束,含客户端排队;每档 5 秒。90% 新 LIMIT GTC 小额不交叉买挂单(0.01×0.0001)、10% 同一已成功键确认。低价减少前序成交干扰,该负载不是多笔跨档撮合/真实生产混合业务。发生器和服务同机、同一持续增长历史,未同时跑其他压力实验。

计划请求/秒 实际完成 2xx/秒 p50 ms p95 ms p99 ms 客户端丢弃 服务拒绝/网络失败
100 100.09 5.14 5.91 6.55 0 0
500 499.23 8.61 11.88 16.12 0 0
1000 998.94 8.54 12.20 16.56 0 0
2000 1996.35 8.98 13.74 17.15 0 0
4000 3991.72 10.08 16.96 29.18 0 0
8000 7545.48 43.68 55.10 59.64 1914 0

100–4000 档无丢弃/拒绝,4000 档约 3992 完成请求/秒,其中 90% 为新挂单,不能把所有请求叫新订单/成交。8000 档 1914/40000 计划请求因客户端积压被丢弃;约 7545 完成/秒不满足全接收条件,也不是最大服务容量证明。客户端丢弃请求没有网络/服务处理,不把这部分遗漏当作低延迟成功。

最终累计创建 68475 单,冻结 USDT 精确 0.068475,available+frozen 保持 100000;全部订单遍历无重复,投影追上水位、服务 SIGTERM 退出 0。最大采样堆约 154MB(HeapAlloc 采样,不是进程 RSS/峰值保证),活动订单/去重随历史增长。完整各档状态、计数/水位/堆与对账见load-go.json。

Python 初轮 100–1000 档通过,高档发生器大量丢弃,说明工具也是瓶颈;原始 load.json、stress保留,但不用 Python 高档推断服务上限。Go 发生器替代后保留同一计划至完成统计和有界预算,未偷偷扩大成无限客户端队列。

4.3 恢复#

最终 恢复原始输出 每个样本 1 次:

历史 时间 分配总字节(非峰值) 条件
10000 同键 CREDIT 确认 48.62ms 16.38MB 既有完整投影,核心从头重建,热 OS 缓存
100000 同键 CREDIT 确认 307.20ms 154.74MB 业务/去重状态固定,不代表10万新单
100000 交易命令 1125.33ms 737.45MB 2 次资金命令+49999 maker/taker 对,真实成交/终态/去重增长;已有完整投影,热 OS 缓存

本版选定的 10万命令热缓存恢复目标 <30s 通过;这不包括冷 OS 缓存、启动 quick_check、缺失投影全量重建及所有负载,也不是“任何10万命令都1秒”。可复现重建 CLI 验证正确性,但没有把其全量成本混成已投影恢复数据。

5. 发现的问题与修复#

  1. Go 1.26.0 标准库扫描有 30 个可达漏洞(升级前),最高修复版本 1.26.9。升级工具链、Docker/CI、x/crypto0.58.0/sys0.49.0 后回归通过。扫描工具旧版构建工具链选择错误/依赖变更中途缺 sum,修正使用明确 Go1.26.9 和固定 x/vuln1.9.0,依赖变更结束后重跑;最新结果上述可复核。
  2. 启动重放旧实现只按 payload,未检查表 seq/摘要/未知 schema;补检查与受控错误恢复,坏 journal 保留不跳过。新 schema 不改变业务摘要,旧键升级重试不冲突。
  3. 逐条投影事务和恢复对已投影前缀做 SQL 会放大成本;有界批事务、前缀跳过、迁移成功标记,测试整批失败回滚,FULL 不变。
  4. 管理页分页后管理员可在历史页,注资恢复测试原先假设首屏有管理员。改为真实翻用户页,再选择目标;页面仍允许确认已保存的原内容。
  5. 首轮分页测试以 innerText 与 textContent 空白差异错误比较;改比单个邮箱单元格。Chromium offline 开关没有实际关闭已有 WS,改捕获/关闭真实 socket 并核对新 socket 数量与连接状态,不冒称全网断网。
  6. 首轮容器用了自动 HostPort,Docker restart 重新分配端口导致客户端继续访问旧地址;改随机选择后固定映射端口,再验证完整恢复通过。原失败不是应用耐久丢失。
  7. 发布脚本 go list -m all 为不参与构建的测试工具依赖请求默认代理超时;改用 go version -m 记录实际构建依赖,staging 完成后才发布,保留首轮未完成目录、不覆盖用户产物。
  8. 收尾 Compose config 检查发现编辑替换误改了环境变量插值,修正为合法单一 CookieSecure 配置。重新解析通过;release 在构建前增加 Compose 校验,重新打包并核验 SHA256SUMS,旧未修正包保留但不作为交付包。
  9. HTTP Shutdown 不关闭已升级 socket,补显式 WS 生命周期关闭/额度回收测试;先停止业务受理并排空,再结束 HTTP,避免退出期间持续新业务。

6. 发布与复现#

发布包:exchange-v0.3.0.tar.gz ↗,build-info 的 git_commit 为 null,未伪造提交。SHA256SUMS 覆盖后端/离线工具/前端/部署/构建元信息,验证通过。临时服务/测试目录由脚本清理;容器/命名卷保留为已停止资源供复查。

最终容器 web3-v03-1791708380693051394,卷 web3-v03-data-1791708380693051394,镜像 exchange-demo:v0.3-verified(image ID sha256:be5abaffbae97c280fede9585d215844990dbbf143634702dd27ddbd0a9d63da);根目录和恢复目录都保留在该验证卷。未修改其他容器/用户 Docker daemon。

bash scripts/verify.sh
GOTOOLCHAIN=go1.26.9 go run golang.org/x/vuln/cmd/govulncheck@v1.9.0 ./...
npm --prefix frontend audit --audit-level=high
python3 scripts/e2e_check.py
python3 scripts/container_check.py
go test -run '^$' -bench 'BenchmarkCore|BenchmarkJournal' -benchmem -benchtime=300ms ./backend
go test -run '^$' -bench 'BenchmarkReplay' -benchmem -benchtime=1x ./backend
CGO_ENABLED=0 go build -trimpath -o bin/loadcheck ./cmd/loadcheck
python3 scripts/load_check.py --driver go --rates 100,500,1000,2000,4000,8000 --seconds 5 --output /tmp/exchange-load.json
bash scripts/release.sh

release 拒绝覆盖既有版本目录,重跑先选择新的独立产物目录或保留前次版本。维护操作/云主机/容器步骤见部署手册。

7. 完成边界#

当前模拟单市场架构 P1–P7 实现、本地正确性/故障/性能/浏览器/运行镜像与离线运维已完成。标准 Dockerfile 在线构建仍因用户配置镜像源 docker.mirrors.ustc.edu.cn DNS 失败,输出;未改 daemon 或将此失败算通过。真实云服务器/域名/安全组/证书未提供,未执行云部署;GitHub workflow 尚未远程执行。

真实断电、磁盘满/fsync硬件失败、长时间生产混合压力/冷缓存恢复、邮箱验证/密码找回/MFA、真实资金/多市场、高可用/防双主、在线一致备份、日志截断/有界去重未实现或验证。P8 快照/Redis/分区仍是依据需求和 profiling 决定的下一阶段,不属于本轮已实现宣称。sessionStorage 仍只保证同标签刷新,完整备份恢复 ID 不能补回备份后历史。

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