# 原项目静态审计

> 当前基线：模拟 v0.3 保留，独立链模式升级为 v0.5。新增完整历史查询、任务版本保护、已确认事件索引、只读对账和基础告警，见 [设计](../07-history/v0.5-design.md)、[执行报告](../reports/2026-10-12-v0.5.md)。历史报告与证据保留原版本。

> 历史 v0.4 变更记录（当前增量见页首 v0.5）：原项目静态审计结论保留历史范围。当前链模式独立实现EIP712授权与原子结算，不沿用原项目共享钱包转账/float模型；新增依赖审计和修复证据记录在v0.4报告。 当前链实现见[v0.5架构](../07-history/v0.5-design.md)，操作见[开发](web3-development.md)、[测试](../04-testing/web3-testing.md)、[部署](../05-deployment/web3-deployment.md)，证据见[本轮报告](../reports/2026-10-12-v0.4.md)。


阅读说明：本页保留该阶段设计/审计背景；当前实现以[总体架构](../02-architecture/architecture.md)、[v0.3 设计](../07-history/v0.3-design.md)及[测试完善报告](../reports/2026-10-11-test-hardening.md)为准，候选与计划不等于当前交付。

调研日期：2026-10-09。仓库：[anthdm/crypto-exchange](https://github.com/anthdm/crypto-exchange)，审计提交：`591fa0029c034a0b76fe91b61b2350485ff9fbab`，提交时间 2022-10-20。使用固定提交链接，避免未来分支变化后行号失效。

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

## 1. 需求列出的问题

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

## 2. 进一步发现的问题

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