# 链上交易可行性分析

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

日期：2026-10-12。依据当前模拟 ETH-USDT、单市场、单实例、Go 单写者、SQLite 日志/投影架构。本文件保留A/B/C/D方案比较；B受限版本已在独立v0.4模式实现并于本地Anvil验证，见[v0.4设计](../07-history/v0.4-design.md)和[报告](../reports/2026-10-12-v0.4.md)。公共链真实资金仍未启用。

**结论：能接入，但要先明确“资产在链上”还是“每笔成交在链上”。**链上充值提现可以保留当前主要交易模型；链下撮合、链上结算需要重新设计成交与资金状态机；把当前 Go Engine 直接放到 EVM 链上不可行，需要用智能合约重写执行逻辑。

用户进一步明确“后端为主、少量智能合约”后，推荐收敛为B的受限版本，具体中间件职责、最小合约和分阶段路线见[后端＋Web3方案](backend-web3-roadmap.md)。下面A/B/C/D仍是可行性比较；第8节原先A起步的建议不作为最新定位的必经阶段。

## 1. 四条路线与现有项目的关系

| 路线 | 钱/订单最终由谁裁决 | 当前撮合引擎能否保留 | 改造量与适用目标 |
| --- | --- | --- | --- |
| A：链上充值提现，链下成交记账 | 链上确定出入金，平台账本确定内部交易 | 可以，扩充资金命令和出入金状态 | 相对最小；展示交易所资金闭环，但每笔交易仍不在链上 |
| B：链下订单簿撮合，链上原子结算 | 合约核验订单授权和资产转移，链上决定成交是否完成 | 可保留排序/匹配；现有即时资金结算不可直接沿用 | 较大；真正展示自有订单簿的链上结算 |
| C：全部链上订单簿与撮合 | 合约/链上交易顺序 | 算法可参考，Go运行时不能作为EVM执行代码 | 最大；主要变成智能合约项目，受Gas/链吞吐约束 |
| D：钱包调用现成DEX换币 | 现成协议合约与资金池/订单协议 | 一般不参与最终成交 | 快速实现链上Swap；项目主线从自有撮合变为DEX接入 |

钱包登录只证明某人控制某地址，不会自动让订单成交上链。将数据库成交摘要写链也是存证，不等于链上验证和转移交易资产。金库合约如果由平台授权提现，仍有平台托管信任，不能仅因“合约保管”就称完全非托管。

## 2. 当前代码有什么可以复用，什么必须改变

| 当前事实与源码 | 可复用部分 | 链上扩展要求 |
| --- | --- | --- |
| [engine.go](../../backend/engine.go)：单写者、红黑树/FIFO、冻结、maker价成交 | 顺序状态机、索引、幂等、确定性重放 | RPC/签名验证/链扫描仍在外围；B需拆开匹配与确认结算 |
| 同文件place成交时立即move双方资产，Trade视为成交事实 | A的内部交易结算可保留 | B先生成候选成交/结算意图，链上完成后才生成确认成交事实 |
| [http.go](../../backend/http.go)：EnsureFunding注册/登录初始化10ETH与100000USDT | 模拟教学继续保留 | 真实资产模式不能送这些余额，也不能把管理员CREDIT当实际储备 |
| [types.go](../../backend/types.go)：仅PLACE/CANCEL/CREDIT、ETH数量4位/USDT6位 | 字符串/decimal规则、命令结构思想 | 资产标识、原子单位、出入金/结算命令、链上引用与状态 |
| [runtime.go](../../backend/runtime.go)：先日志再Apply、异步投影、原键确认 | 记录外部结果后再更新状态、故障重放 | 发交易的持久化任务、签名交易/nonce追踪；重放不能重新广播历史交易 |
| [store.go](../../backend/store.go)：journal/auth权威，views派生 | 三库职责与目录锁 | 链上新增资产权威；外部任务/扫描水位不全是可删除的查询缓存 |
| [auth.go](../../backend/auth.go)：邮箱登录与会话 | 可继续保留 | 钱包绑定、签名挑战、防重放、链/地址作用域；钱包与管理员权限分开 |
| 页面注册/交易/管理/待确认恢复 | 交互框架、请求幂等 | 钱包授权、网络切换、Gas、交易哈希、等待确认/失败/重组展示 |

现有模拟账户和历史日志不能直接“升级成真实资产”。应启用独立模式/数据目录/市场标识，只由真实入金或合约确认生成真实余额；原模拟数据保留为演示。新增状态机要做引擎/日志版本兼容，而不是让同一历史Command在新程序里产生另一种含义。

## 3. 路线A：最快保留Go项目主线

交易过程仍是：先把币存入平台受控地址或金库，内部订单成交由Go记账，用户提现时再转到钱包。内部10笔成交不需要10笔链交易；它是链上资产支撑的链下交易所。

```mermaid
flowchart LR
    W[用户钱包] --> V[链上金库或充值地址]
    V --> S[外围扫描与最终性判断]
    S --> J[记录入金确认命令]
    J --> E[单写者：余额/撮合/提现冻结]
    E --> O[持久化提现意图]
    O --> R[外围交易发送器]
    R --> W
    R --> S
```

### 3.1 充值怎样入账

外围扫描按chainId、资产合约白名单、金库事件或受控入金方式识别充值，校验收款地址与归属、金额和链上执行结果。记录txHash/logIndex/blockHash/blockNumber，未达到所选链的最终性条件先保持待确认。

达到条件后提交DEPOSIT_CONFIRMED命令，携稳定业务ID和外部事实，经过FULL日志后核心增加余额。事件交付可能重复，幂等避免重复入账；链扫描使用重叠区间补拉、块哈希检查与持久水位，不能只依赖WebSocket。

事件身份要同时保留交易/日志身份与块归属；同笔交易可能在重组后重新入块，不能仅把新blockHash拼成全新入金键再多记一笔。确认前处理孤块撤回；确认后意外深重组需异常处置和资产对账，不能在核心实时调用RPC猜余额。

原生ETH没有ERC-20 Transfer日志。金库可以提供明确deposit入口/事件；直接向地址转账是另一套识别流程，普通交易扫描还可能漏内部转账。第一阶段建议限定一种受支持入金路径，明确拒绝/不自动识别的情况。

### 3.2 提现怎样避免“重试多转一次”

先由单写者受理WITHDRAW_REQUEST，验证账户可用余额、费用/金额规则并转入提现保留资金，生成稳定withdrawalId。资金此时不能用于下单。应区分订单冻结与提现保留，扩充当前“Frozen等于挂单所需资金”的测试不变量，不能混在一个数里还沿用旧守恒断言。提现意图可靠持久化后，外围发送器组装、签名、广播交易。

示意状态：

```text
REQUESTED → RESERVED → SIGNED → BROADCAST → INCLUDED → FINALIZED
                                ↘ UNKNOWN（继续查询，不能解冻/再转）
                 确定失败/安全取消 → REJECTED_OR_FAILED → RELEASED
```

记录发送账户nonce、签名原始交易、txHash及替换关系，RPC超时后查询原交易；可安全重发同一签名交易，不能随便用新nonce转同一笔。nonce由受控外围发送器协调，链上nonce与业务withdrawalId作用不同。

receipt status成功也不等于所有业务已确认：还要检查预期事件/实际转账效果及最终性。仅交易未查到、手续费太低或超时都不能证明失败，不能立即释放资金。失败确认通过新日志命令回核心；正常重放只重建状态，不再次转账。

最终需逐资产对账：链上储备与用户总负债、提现保留、费用/平台自有资产、已发但未最终确认的流出分别核算。管理员凭空注资会形成无储备负债，真实资产不能沿用模拟增发权限。

### 3.3 A的优势与局限

单写者核心不等区块，可继续高效撮合，已有资金与恢复测试价值很大；新难点集中在链适配、出入金和对账。用户必须信任平台内部账务、提现授权与密钥管理。若用户要求“每笔成交链上原子交换”，A未满足该目标。

## 4. 路线B：链下撮合、链上结算

该方案能保留价格时间优先和高效订单簿，又让资产交换由合约检查完成。Go不再拥有决定最终资产转移成功的权限。

```mermaid
flowchart LR
    W[钱包签署订单] --> A[外围验证签名与订单域]
    A --> E[单写者订单簿：匹配/预留]
    E --> I[持久化结算意图]
    I --> R[外围relayer发送交易]
    R --> C[合约核验两边授权/价格/数量/nonce]
    C --> T[原子转移两种资产]
    T --> S[扫描receipt/事件/最终性]
    S --> J[结算结果写入日志]
    J --> E
```

### 4.1 第一版可以如何简化

选择一个EVM本地/测试网络，一对明确白名单的测试ERC-20：MockWETH与MockUSDT。用户签限价订单，先支持一种限价成交规则及部分成交；合约原子执行双方token转移。没有足够余额/授权，整笔链交易回滚。

WETH是包装ETH，不是随便给原生ETH换个显示名称；ERC-20 transferFrom不能直接扣另一钱包的原生ETH。若后续支持ETH，在入口/出口单独wrap/unwrap，并处理精度和失败。

签单与ERC-20 approve是不同授权：签单表示允许按指定条件成交，approve允许特定合约转移token。有签名不代表有余额或allowance，也不代表用户不会稍后撤授权/转走币。

### 4.2 合约必须约束什么

订单签名可用EIP-712结构化数据。域至少绑定协议版本、chainId和verifyingContract；内容约束maker、资产地址、数量/价格表达、接收地址、nonce或salt、deadline等。实际字段与价格整数换算需要明确规格。

EIP-712本身不提供完整防重放，合约还需存已成交累计数量/已用nonce、撤单/批量失效状态。部分成交不能每次用“该订单还没完全使用”重复吃原总量。支持合约钱包时需要EIP-1271校验，不只有EOA签名恢复。

核验买卖两边授权、限价和剩余数量、成交价格/费用、代币白名单，原子完成交付。使用成熟SafeERC20处理返回行为、重入防护和权限模块；某些真实token有费用/重基/黑名单等特性，不能假定所有ERC-20都和Mock相同。第一版明确支持的代币行为。

本地FIFO是服务端承诺，合约只验签名/数量/价格并不证明平台公平排序。若要链上可验证价格时间公平性，还需额外协议；用户/其他relayer可能争先结算，公开mempool也会影响执行次序。

### 4.3 最大改造：匹配不是已经结算

当前place每撮合一次就增加买方ETH、卖方USDT，并生成不可变Trade。直接在它后面补一笔链转账，链转账失败时账本已经“成功”，不能靠HTTP报错恢复一致性。

B需拆为：候选匹配→锁定待结算数量/资源→外部交易→链上确认→正式成交/到账；确定失败则按明确规则释放或恢复可撮合余量。需要区分订单状态、撮合批次状态、链上交易状态，不能把所有等待统称OPEN或FILLED。

若允许待结算资产继续被下一笔订单使用，就形成未确认信用并把失败向后传递。第一版禁止这样用，或选择预存金库与可验证额度方案。此选择决定账户账本和合约资金模型，必须先定再开发。

非预存方案用签名+allowance换简单入场，但本地冻结不能冻结钱包余额，可能有多笔链交易竞争同一资金；预存金库可更好控制资金，却要设计真实预留/提现互斥。两者不是“加个RPC配置”就可互换。

### 4.4 撤单、过期与失败也是协议的一部分

删除本地订单簿只停止当前服务撮合，已经签过的订单可能仍能被链上执行。需合约取消orderHash或推进nonce，并清楚显示本地取消与链上失效差别；取消与成交谁先链上执行，以合约状态为准。

deadline在合约按链时间判断；外围可以提前阻止提交或产生过期命令，但不能让重放Engine读取当前时间重新裁决历史命令。Gas失败、签名失效、余额/allowance不足、重组、其他执行者抢先成交均需恢复测试。

批结算降低部分固定开销，但会扩大整批回滚影响；第一版可先两单原子成交，之后按Gas与失败率设计批次。不是任意数量成交都能塞进一个区块。

## 5. 外围链组件如何与可靠日志衔接

至少新增这些职责，不需要把它们都拆成微服务：

| 组件 | 职责 | 不该做的事情 |
| --- | --- | --- |
| wallet/auth外围 | 挑战、签名、钱包绑定/网络检查 | 相信客户端传钱包地址就已认证 |
| ChainAdapter | RPC、receipt/事件、整数单位转换 | 在Engine内部联网 |
| Scanner | 块哈希/最终性、补拉、重复/重组处理 | WS断了就永久漏事件 |
| Outbox/IntentStore | 待发送业务意图、状态与业务ID | 依赖一条已发WS消息作为可靠任务 |
| TxSender | 签名、nonce、raw tx、替换/重试 | RPC超时新建一笔同业务转账 |
| Reconciler | 链上事实与账本/意图对账 | 查一次余额就覆盖核心资金 |

outbox必须可恢复且在发送前已可靠持久化。可以将确定性意图随业务投影一起事务写入，扫描器补齐落后投影；但worker发送/签名产生的raw tx、nonce及尝试状态并非普通Engine投影的可再生输出，需要权威持久化，不能rebuild-views时删除。

只有journal中的业务意图并不能在崩溃后推知“外围已经签过并广播了哪笔nonce交易”。为每种外部动作定义可靠提交/查询/恢复协议，保持withdrawalId/settlementId与链交易的关联。日志重放必须无外部副作用。

现有processed_seq/result_seq仍可表示本地命令进度；新增txHash/blockHash/confirmation/finality字段，不能用本地applied_seq当链上确认高度。页面应分别显示“已受理”“已匹配”“已发链交易”“已最终结算”。

## 6. 金额与资产身份不能继续只写ETH/USDT

资产标识应含chainId、token地址（或明确native标记）、decimals。不同链/地址的同名USDT不是同一资产；跨链桥资产也不能默认为原生官方币。合约地址/网络先确认，不在本文随意选主网地址。

链上使用整数原子单位：EVM原生ETH通常18位，ERC-20按具体资产配置/核验，不假定都18位。订单最小数量0.0001ETH可以保持，但充值钱包余额可能有更小尾数。

当前ETH账户解析最多4位会拒绝或无法表示小额链资金，应将订单步长与账户资产精度分开；账户存整数文本或精确decimal并显式转换。超额尾数保留或按公开规则处理，不静默截断。链整数不能经float64/JS Number，也不能直接当int64，uint256范围需要大整数与明确上限。

按当前价格2位、数量4位，成交额最多6位，对6位quote token有利；换其它资产精度/费用规则后不一定整除，需要写舍入/尘埃/费用规则并做Go与Solidity结果一致性测试。

## 7. 钱包接入与工具复用

前端可选viem配wagmi及支持EIP-1193的浏览器钱包；Go可使用go-ethereum的RPC/ABI/交易绑定；合约测试用Foundry/Anvil，或团队熟悉的Hardhat；合约基础复用OpenZeppelin。最终已选ethers、go-ethereum、OpenZeppelin、solc与Anvil；viem/wagmi/Hardhat未引入。

钱包登录可参考EIP-4361：挑战包含域名/URI、nonce、chainId、签发/到期信息，后端验证并一次性消费nonce；邮箱绑定钱包需双方身份的明确验证。不论哪种登录，管理员角色仍由服务端授权，不是连接特定钱包就自动提升权限。

先确定链/资产/结算模型，再挑兼容版本并锁依赖。不要求自己实现ECDSA/密码学/ERC-20底层库，也不将现成DEX的交易路由复制成自有撮合成果。

## 8. 建议开发路径与验收门槛

对这个面向Go面试的新手项目，建议先做A的本地链/测试网资金闭环，保留现有核心性能主线；如果明确要求每笔成交链上结算，再作为独立B版本改造。A不是自动升级B的数据迁移捷径。

1. 先定一条链、一个市场、托管/非托管目标，独立数据与资产标识；确定状态机和合约规格，不动现有模拟历史。
2. Anvil+MockToken+钱包连接/签名，建立合约测试与Go日志输入的确定性边界。
3. A：合约入金事件、去重/确认、提现冻结与可靠发送、失败/重组对账；真实资产模式关闭赠送资金和无储备注资。
4. B：EIP-712订单/部分成交/撤单/原子交付，重构待结算资金与订单状态，明确何时回包、到账和可提现。
5. 上测试网做双钱包交易/提现及故障验证，记录网络、合约版本/地址、RPC、Gas、真实成功率/确认延迟，再评估主网。

测试至少覆盖：重复事件、RPC响应丢失、广播前后进程崩溃、同nonce替换、交易revert/卡住、链重组、合约取消与成交竞争、跨链/跨合约签名重放、部分成交不超量、allowance变化、合约重入/异常token行为、金额转换/尘埃、恢复后不重复转账、权威outbox与views重建边界。

真实资产上线需要合约审阅/审计、密钥与资金权限分离及对账运维，这些是新增资金路径的实际工程工作；本地/测试网演示不能替代。当前链、资产地址和托管目标未选定，因此本文不给Gas成本/TPS承诺，也不执行部署或真实交易。

## 9. 性能与面试讲法会怎样变化

A的内部订单处理依然可以快，出入金确认速度取决于链；B本地匹配快不等于链上成交快，端到端受区块、Gas、批大小、RPC与最终性约束。链下Go并发压测成绩不能套成链上吞吐。

可以准确讲：“复用单写者订单簿，外部链事件持久化后进入确定性资金状态机；可靠意图驱动外部转账，幂等与恢复处理未知结果。”若实现B，再补：“匹配与结算分离，合约验双方授权并原子交付，链上确认才确认为成交。”当前可按v0.4报告讲已完成部分；全量链事件补拉、托管出入金仍只能方案讨论。

## 10. 规范与资料入口

- [ERC-20：EIP-20](https://eips.ethereum.org/EIPS/eip-20)
- [结构化签名：EIP-712](https://eips.ethereum.org/EIPS/eip-712)
- [合约钱包签名：EIP-1271](https://eips.ethereum.org/EIPS/eip-1271)
- [钱包登录：EIP-4361](https://eips.ethereum.org/EIPS/eip-4361)
- [Ethereum JSON-RPC](https://ethereum.org/en/developers/docs/apis/json-rpc/)
- [OpenZeppelin ERC-20/SafeERC20](https://docs.openzeppelin.com/contracts/5.x/api/token/erc20)
- [Foundry Anvil](https://getfoundry.sh/anvil/overview/)
- [Go Ethereum合约绑定](https://geth.ethereum.org/docs/developers/dapp-developer/native-bindings)
- [Uniswap协议概览](https://docs.uniswap.org/contracts/v3/overview)

本轮核对了本地源码。官方网页检索遇环境DNS解析失败，以上为资料入口，未据此声称核验最新协议部署、工具版本或当前网络参数。选链/资产后需重新查官方文档。本地基础设计参见[架构](architecture.md)、[数据生命周期](../05-deployment/data-lifecycle.md)、[面试Q&A](../06-interview/interview-qa.md)。

## v0.5 对链方案的落实

链下撮合/链上结算主线已补已确认事件索引和对账。索引是查询证据，receipt 校验→持久 CONFIRMED 命令才推进 filled；不会因两条读取路径重复成交。浅重组留在未确认任务层，深重组停止服务。尚未引入托管金库、批次证明、跨链或自定义公链。
