Web3 交易系统
系统架构

链上交易可行性分析

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

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

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

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

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

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

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

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

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

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

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

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

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等于挂单所需资金”的测试不变量,不能混在一个数里还沿用旧守恒断言。提现意图可靠持久化后,外围发送器组装、签名、广播交易。

示意状态:

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不再拥有决定最终资产转移成功的权限。

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. 规范与资料入口#

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

v0.5 对链方案的落实#

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

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