当前基线:模拟 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 本地索引不冒充通用跨链重组框架或安全审计。