Web3 交易系统
开发与源码

原项目静态审计

当前基线:模拟 v0.3 保留,独立链模式升级为 v0.5。新增完整历史查询、任务版本保护、已确认事件索引、只读对账和基础告警,见 设计、执行报告。历史报告与证据保留原版本。

历史 v0.4 变更记录(当前增量见页首 v0.5):原项目静态审计结论保留历史范围。当前链模式独立实现EIP712授权与原子结算,不沿用原项目共享钱包转账/float模型;新增依赖审计和修复证据记录在v0.4报告。 当前链实现见v0.5架构,操作见开发、测试、部署,证据见本轮报告。

阅读说明:本页保留该阶段设计/审计背景;当前实现以总体架构、v0.3 设计及测试完善报告为准,候选与计划不等于当前交付。

调研日期:2026-10-09。仓库:anthdm/crypto-exchange,审计提交:591fa0029c034a0b76fe91b61b2350485ff9fbab,提交时间 2022-10-20。使用固定提交链接,避免未来分支变化后行号失效。

本次阅读全部业务源码及现有订单簿测试,未启动 Ganache、未运行原项目测试或竞态检测。下面是静态证据与推导,标明需要后续实验的部分;没有把仓库 README 当作性能证明。

1. 需求列出的问题#

问题 源码证据 实际影响 新方案
浮点金额与数量 orderbook.go L13–34、L67–70 小数比较和减法不精确,Size==0 判断不可靠;float 价档键可能分裂 decimal 全链路,精确 tick 键,金额字符串
查询每次排序 L336–343;删除同价单 L100–111 深度查询反复 O(P log P),删除订单重新排序 开源红黑树、最佳价缓存、链表 FIFO
随机订单 ID L42–49 仅 1000 万个随机候选,发生碰撞会覆盖索引;不是唯一 ID 外围持久定序,首次下单序号作 ID
流动性不足 panic L198–220 正常业务拒绝进入异常路径;是否终止进程取决于调用 goroutine/恢复机制 IOC 明确余量及有类型业务错误
无持久化与流水 Orderbook 状态在 L175–195;未发现命令日志、数据库和恢复路径 进程退出后订单与成交丢失 外围持久化输入屏障、确定性核心、异步投影与重放

2. 进一步发现的问题#

编号 发现与源码证据 可推导的复现场景 改进与测试
A01 PlaceLimitOrder L249–281 只入簿,不检查反向最佳价 卖盘 100,买入限价 105,只挂单,形成交叉簿 可成交限价单立即撮合,剩余再挂单
A02 CancelOrder L306–313 不加锁,读取接口也访问可变 slices/maps,Asks/Bids 查询会排序并写切片 并发撤单、下单、读簿存在数据竞争;可能 map 并发读写 全局单写者、不可变结果、外围只读投影;race 测试
A03 server L184–213 只持有 ex.mu,订单尺寸与 Limit 却由另一对象更新 检查 Limit 非 nil 后仍可能在访问 Price 前被撮合清空;不是正确保护 不跨组件共享订单指针
A04 server L307–313 忽略 ID 解析错误,未检查订单存在;最佳价 L267–302 未检查市场存在 非数字撤单 ID、不存在订单或未知市场可触发 nil 解引用 严格校验、404/409 与空簿 null
A05 Fill L130–137 清同价队列但未移除 ob.Orders;撤单依赖 o.Limit 已成交订单仍在全局索引,撤单时 Limit nil;活动与历史混淆 终态从活动索引移除,历史读模型独立
A06 Orders.Less L40 按墙钟排序;删除时 swap-tail 后 sort.Sort 相同时间戳的相对顺序不稳定,接入构造时间也不等于引擎受理顺序 FIFO 使用日志序号,不依赖时间戳
A07 PlaceMarketOrder L242–244 无条件读最后成交 初始空簿提交零量市价单可能绕过体积检查,访问 Trades[-1] 拒绝零量,空簿明确错误
A08 server L393–421 未统一校验 side/type/market/size/price 负量/负价无明确拒绝,未知 type 仍可能返回订单 ID 而无业务效果 DTO 语法和组合校验 + 核心状态校验
A09 均价 L347–351 对成交价简单平均 100 成交 1、200 成交 9,返回 150,正确 VWAP 是 190;空 matches 还有除零 按成交量加权,只用于展示
A10 httpErrorHandler L121–123 只打印 err,没有写错误响应 客户端无法得到确定状态码与错误结构 统一错误码及 request_id
A11 handleMatches L424–445 撮合后直接转 ETH,没有报价资产对付、余额冻结及结算状态 订单已成交却转账失败,或仅单边 ETH 转账;匹配和转账结果不一致 首版模拟双资产账户,链上操作外置为后续资金业务
A12 L444 int64(SizeFilled) 再 big.NewInt,Ethereum tx value 单位为 wei 0.5 被截成 0,1 ETH 若按该变量语义理解会只传 1 wei,缺少单位转换 金额和资产单位明确;链上扩展采用精确整数最小单位
A13 L445 未检查 transferETH 返回值;L451–479 每次获取 nonce,无确认/重试协议 并发同账户转账可能 nonce 冲突;广播成功不等于最终确认;费用接口失败 log.Fatal 链上扩展单独 nonce 管理、待确认状态、失败补偿;首版不接链
A14 server.go 的启动配置把演示私钥写入源码,链 ID 与 RPC 固定 演示密钥与真实密钥边界不清,环境不可配置 新项目无钱包私钥;未来 secret 配置和独立 signer
A15 client.go L27–50 等 HTTP 方法使用 DefaultClient,无 timeout、无 Body.Close、未核对 status 连接资源泄漏、错误响应按成功解析、请求无限等待 context/timeout、关闭 body、规范客户端契约
A16 maker.go L55–101 continue 跳过 <-ticker.C;main.go L13–14 sleep 猜测服务就绪 空簿或窄价差情况下循环可能高频打接口,启动存在时序依赖 独立确定性 seed 工具、显式 readiness、统一生命周期
A17 Trades、账户订单集合和全量查询无保留/分页界限;未见幂等协议 内存和响应随运行增长;请求重试可能重复业务效果 历史分页、有限通道、幂等与资源预算
A18 orderbook_test.go 主要覆盖顺序基础场景,TestLimit 仅打印 未覆盖恢复、并发、交叉簿、精度、非法输入、资金守恒、HTTP 错误 场景 + 不变量 + 故障注入,不仅断言实现细节

3. 审计结论与使用边界#

本项目的关键改进不止替换几种数据结构,而是把受理、持久化、状态更新和客户端观察分别定义清楚。原项目中“HTTP 锁”“订单簿锁”“链上转账”之间没有形成完整的一致性协议,因此局部补锁无法回答恢复和结算问题。

新项目可保留价格时间优先的业务概念;结构性改写使用独立模块,不整体搬运原代码。已读取原仓库 LICENCE,正文为 MIT 授权条款;若后来复制代码,保留对应版权和许可证声明。所有第三方库按自身许可证记录。

以上复现为源码推导,不在面试中表述为“已复现的线上事故”。开发后用新的可重现实验展示改进能力。

v0.5 可核对依据#

新能力依据本地源码与真实执行报告:索引 index.go、查询 history.go、CAS tasks.go、对账 reconcile.go、观测 observability.go,以及 production_test.go / scripts/web3_check.mjs。LMAX 单写者是结构思路,不声称使用 Java Disruptor 库;confirmed-only 本地索引不冒充通用跨链重组框架或安全审计。

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