NautilusTrader Derive 适配器基准测试深度解析:入站解码、签名与分发管道的性能剖析
NautilusTrader Derive 适配器基准测试深度解析:入站解码、签名与分发管道的性能剖析
本文基于 crates/adapters/derive/benches/BENCHMARKS.md 展开,系统讲解 NautilusTrader 中 Derive 交易适配器的四组 Criterion 基准测试套件(data、exec、micros、signing):其测量环境与复现方法、每条基准的语义定义、实测数据表,以及源码层面的性能结论(如 RawValue 单趟解码、EIP-712 签名主导执行路径等)。读完本文,你将掌握 Derive 适配器端到端热路径的成本分布,能够在自己的机器上复现这套基准,并用 micros.rs 组件分解快速定位管道性能回归的来源。
基准测试定位:文档即基线
Derive(Derive.xyz)是一个基于链上结算的衍生品交易所,其 NautilusTrader 适配器位于 crates/adapters/derive,核心 crate 名为 nautilus-derive。适配器需要同时处理两套截然不同的工作负载:一是高频的 WebSocket 行情入站流(盘口增量、ticker、成交、资金费率、期权 Greeks 等),二是每次下单都必须执行的链上签名路径(EIP-712 订单签名 + REST 请求鉴权)。
依据仓库根目录 BENCHMARKING.md 中"基准即文档"(Benchmarks are documentation)的原则,本文件记录的是热路径的构成、实测输入与成本快照,供后续优化和回归对照使用。文中所有数字均于 2026-05-30 在 AMD Ryzen Threadripper 9980X 上测得(rustc 1.95.0,bench-lto profile:release 优化 + lto = "fat" + codegen-units = 1,且保留 debug = full 调试符号)。CPU governor 固定为 performance,并通过 setarch -R 关闭 ASLR;套件先完整跑一遍以预热缓存、稳定时钟,再进行正式测量——冷启动首次运行会令每行数字虚高约 10%。
需要强调的是:绝对数值因机器而异,只有同机对比(same-machine deltas)才有意义。该文件的刷新时机为"实质性性能变更时或发布前",同时更新测量日期。
如何复现:环境控制与命令序列
由于基准对 CPU 频率、ASLR、缓存与散热状态敏感,复现必须遵循严格的环境控制流程:
# 1. 锁定 CPU 为 performance 调度器(需要 root)
sudo cpupower frequency-set -g performance
# 2. 关闭 ASLR 并执行预热运行(结果不计入)
setarch -R cargo bench -p nautilus-derive --profile bench-lto \
--bench data --bench exec --bench micros --bench signing # warm-up
# 3. 正式测量
setarch -R cargo bench -p nautilus-derive --profile bench-lto \
--bench data --bench exec --bench micros --bench signing # measured
# 4. 恢复默认 governor
sudo cpupower frequency-set -g powersave # restore default
--profile bench-lto 与 cargo bench 默认的 bench profile 的关键区别在于:bench-lto 增加 lto = "fat" 与 codegen-units = 1,与生产 release 二进制保持一致,因此发布到 BENCHMARKS.md 的基线数字必须使用 bench-lto(详见 BENCHMARKING.md 的 Measurement requirements 一节)。更完整的降噪策略见仓库根目录 BENCHMARKING.md。
四个 bench 目标在 crates/adapters/derive/Cargo.toml 中注册(harness = false,即使用 Criterion 自带 harness),共享 benches/common/mod.rs 中的 fixture 与工具函数。入站 fixture 直接 include_str! 引入 test_data 下真实抓取的交易所数据,在 bench 设置阶段由 subscription_frame 包装成线上投递的 JSON-RPC subscription 信封,因此基准输入与解析器测试语料保持同步。
入站管道(data.rs):原始 WS 字节到 Nautilus 域类型
data.rs 测量的是从原始 WebSocket 帧字节到 Nautilus 域类型的完整入站链路,覆盖:帧解码(单趟解析为类型化帧)+ 频道解码(原始 payload 字节到类型化结构体)+ 解析 + Nautilus 类型构造。基准循环内无 I/O、无异步运行时、无 channel,仅测纯 CPU 计算。
各行的输入来自 test_data 的真实捕获(benches/common/mod.rs 中 fixtures 模块定义了频道与数据):
book_deltas:orderbook.ETH-PERP.1.10频道,盘口快照增量(ws_orderbook_eth.json)quotes/mark_price/index_price/funding_rate:ticker_slim.ETH-PERP.1000频道,perp slim ticker(ws_ticker_slim_eth.json)trades:trades.perp.ETH频道,公开成交(ws_trade_eth.json)bars:REST OHLCV 路径(http_public_candles_eth.json),因为 Derive 没有 WS K 线频道,该行解码 candle 记录并构造Baroption_greeks:ticker_slim.ETH-20260627-3500-C.1000期权频道(ws_ticker_slim_eth_call.json)
行序从最基础的行情流(盘口增量)向下经过 ticker 衍生流(quotes/mark/index/funding/bars),最后是期权专属的 Greeks 流:
| Bench | Median | Throughput |
|---|---|---|
inbound_pipeline/book_deltas |
473 ns | 2.12 M/s |
inbound_pipeline/quotes |
1.64 µs | 610 k/s |
inbound_pipeline/trades |
742 ns | 1.35 M/s |
inbound_pipeline/mark_price |
1.59 µs | 631 k/s |
inbound_pipeline/index_price |
1.59 µs | 631 k/s |
inbound_pipeline/funding_rate |
1.57 µs | 639 k/s |
inbound_pipeline/bars |
670 ns | 1.49 M/s |
inbound_pipeline/option_greeks |
2.35 µs | 426 k/s |
从源码看(benches/data.rs),每条基准都走同一条调用链:DeriveWsFrame::parse(帧层)→ 频道解析(如 parse_orderbook_msg / parse_ticker_msg / parse_trades_msg)→ 域解析(parse_orderbook_deltas、parse_ticker_quote、parse_trade_tick、parse_candle_record、parse_option_greeks 等,均位于 src/websocket/parse.rs)。价格与数量精度由 ETH-PERP 合约属性决定:PRICE_PRECISION = 2(tick_size 0.01)、SIZE_PRECISION = 3(amount_step 0.001)。
执行管道(exec.rs):策略命令到待发送的线上字节
exec_pipeline 测量从策略命令(OrderAny / cancel)到"可发送的线上字节"的整条出站路径:
submit_limit/submit_market/modify:覆盖签名路径private/order与private/replace,完整流程为 normalize(订单归一化)→ ABI encode → EIP-712 签名 → JSON 序列化。submit_market额外携带限价保护参数(Some(dec!(3500)))cancel:覆盖无签名路径private/cancel(构建参数 + 序列化)
Derive 只支持 Limit 与 Market 两种订单类型,因此没有止损单(stop-order)基准行。
| Bench | Median | Throughput |
|---|---|---|
exec_pipeline/submit_limit |
42.1 µs | 23.8 k/s |
exec_pipeline/submit_market |
42.1 µs | 23.7 k/s |
exec_pipeline/modify |
42.1 µs | 23.7 k/s |
exec_pipeline/cancel |
45.8 ns | 21.8 M/s |
出站负载构造由 src/http/query.rs 的 order_to_derive_payload / order_replace_to_derive_payload 完成。基准中使用的签名上下文(SESSION_KEY、钱包地址、SUBACCOUNT_ID = 30769、EXPIRY_SEC 取远未来时间戳以通过 EIP-712 过期守卫)定义了签名基准的固定输入。
签名基准(signing.rs):EIP-712 与 EIP-191 的成本解剖
signing.rs 把执行路径中最昂贵的部件单独抽出来测:
sign_trade_action:EIP-712 订单签名(ABI encode + keccak + secp256k1),每笔订单提交支付一次。基准构造SignedAction::new后调用action.sign(signer)rest_auth_headers:EIP-191 时间戳签名(build_rest_auth_headers_at),每个 HTTP 读请求支付一次signer_from_key:secp256k1 私钥展开(PrivateKeySigner::from_str),客户端启动时支付一次abi_encode_trade:TradeModuleData的 ABI 编码,签名前的一小步nonce_next:NonceManager::next_nonce_at的非ce 分配
| Bench | Median |
|---|---|
sign_trade_action |
42.0 µs |
rest_auth_headers |
40.9 µs |
signer_from_key |
31.6 µs |
abi_encode_trade |
236 ns |
nonce_next |
45.8 ns |
签名上下文常量(ACTION_TYPEHASH、domain_separator_for(DeriveEnvironment::Mainnet)、trade_module_address_for(...))来自 src/signing 模块;这些是与 Derive 链上合约绑定的一级常量,也是后续"Exec 为签名主导"结论的输入前提。
分发管道(dispatch):线上 WS 负载到执行事件
dispatch 组测量交易所 WS 负载(DeriveOrdersSubscriptionData、DeriveTradesSubscriptionData)经 ExecutionEventEmitter 发出事件的链路,覆盖 解析 + 去重 + 身份查找 + 事件构造,核心函数为 src/execution.rs 的 dispatch_orders_payload / dispatch_trades_payload:
orders_untracked:转发原始状态报告(未注册身份,WsDispatchState为空)orders_tracked:解析注册身份并发出OrderAccepted事件(状态中预注册alpha-strategy标签对应的OrderIdentity)trades_fill:解析注册身份并发出OrderFilled事件
| Bench | Median | Throughput |
|---|---|---|
dispatch/orders_untracked |
8.53 µs | 117 k/s |
dispatch/orders_tracked |
9.01 µs | 111 k/s |
dispatch/trades_fill |
8.45 µs | 118 k/s |
分发基准使用 Criterion 的 iter_batched,每次迭代都基于全新的 WsDispatchState(setup 闭包中重建,不计时),因此测到的是 解析 + 去重 + 身份查找 + ExecutionEventEmitter 发送。注意:channel 发送会引入方差,这组行比入站与执行组噪声更大。common::bench_emitter 返回与 unbounded channel 绑定的 emitter,基准在每次 setup 前调用 drain 清空接收端,避免队列跨样本累积影响方差;接收端必须保持存活,否则 send_order_event 会退化为 warn 日志的空操作而扭曲测量。
组件分解(micros.rs):定位时间花在哪里
当入站或执行基准出现回归时,micros.rs 提供诊断性分解,把管道数字拆成可比的组成部分:
decode_only:原始字节 → 类型化消息的成本(帧信封解码 + 频道from_value解码)parse_only:类型化消息 → Nautilus 域类型的成本,与对应的decode_only相加应约等于data.rs的入站数字atom/*:Decimal、Price、UUID4、TradeId 构造与分发状态churn 的原子成本
| Bench | Median |
|---|---|
decode_only/orderbook |
423 ns |
decode_only/ticker |
1.56 µs |
parse_only/orderbook_deltas |
49.9 ns |
parse_only/trade |
32.2 ns |
parse_only/ticker_quote |
36.6 ns |
parse_only/order_report |
90.7 ns |
parse_only/fill_report |
109 ns |
atom/decimal_from_str |
6.97 ns |
atom/price_from_decimal_dp |
6.54 ns |
atom/price_combined |
12.3 ns |
atom/trade_id_new |
8.89 ns |
atom/uuid4_new |
12.9 ns |
atom/state_construct_primed |
4.11 µs |
atom/state_drop_primed |
1.13 µs |
atom/dedup_trade_hit |
11.6 ns |
parse_only/order_report 与 parse_only/fill_report(对应 src/http/parse.rs 的 parse_derive_order_to_report / parse_derive_trade_to_fill_report)分解的是 dispatch 端到端执行的入站执行报告路径。
关键性能结论:五条可从源码验证的规律
1. 入站解码规避了 Value 中间层
src/websocket/messages.rs 中 WsSubscriptionPayload.data 以 serde_json::value::RawValue(原始 payload 字节)持有,而非解码后的 Value:帧层单趟解析为类型化结构,捕获 params.data 为 RawValue,各频道解析器再直接把这些字节解码进各自的类型化结构。整个入站路径都不会把帧或庞大的 data 子树物化为 serde_json::Value 树。这一优化使每条入站行相比旧的 Value 解码方案大约减半(如 decode_only/ticker 从 3.11 µs 降到 1.56 µs,book_deltas 从 1.06 µs 降到 0.47 µs)。
2. 入站仍由解码主导
decode_only 占 book_deltas 约 90%(473 ns 中的 423 ns),占 quotes 约 95%(1.64 µs 中的 1.56 µs)。解析本身极快:盘口增量解析低于 50 ns,quote/trade 低于 40 ns;Decimal、Price、UUID4、TradeId 构造全部低于 15 ns。这解释了为什么优化解析逻辑对入站整体收益有限——瓶颈在 JSON 解码本身。
3. 四条 ticker 衍生行在生产中共用一次解码
quotes、mark_price、index_price、funding_rate 各自测量的是独立 DeriveTickerMsg 解码(约 1.56 µs)加一个低于 40 ns 的解析,因此都落在约 1.6 µs。但生产环境中,实时数据客户端只解码一次 ticker 帧,再从这一条消息派生出全部四条流——把四行数字相加会重复计数。它们的共同杠杆是 ticker 解码,而非各流各自的解析。
4. option_greeks 是最重的入站行
期权 slim ticker 在共享 ticker 字段之外还携带 option_pricing 块(delta/gamma/vega/theta/rho、隐含波动率、forward),因此 option_greeks 以 2.35 µs 成为入站最重行(见 benches/common/mod.rs 的 TICKER_OPTION fixture 说明)。
5. 执行路径签名绑定
sign_trade_action(EIP-712:ABI encode + keccak + secp256k1)为 42.0 µs,主导了 submit_limit/submit_market/modify(均约 42.1 µs);ABI encode(236 ns)与 JSON 序列化与之相比是噪声。cancel 无需签名,仅 46 ns。不改变签名方案的优化无法移动签名行的数字。rest_auth_headers(EIP-191)约 41 µs,因为它执行的是同一次 secp256k1 签名。signer_from_key 的 31.6 µs 私钥展开在客户端构造 signer 时执行一次,按订单摊销,不计入单笔成本。
6. 稳态分发状态远便宜于逐次重建
分发基准每次迭代重建 WsDispatchState(构造 4.11 µs + drop 1.13 µs,均不计时),而生产状态长期存活,稳态去重命中(atom/dedup_trade_hit)仅约 12 ns。因此生产分发的实际开销是解析 + 去重 + 身份查找 + 事件发送,而不是状态 churn。
何时刷新这份基准
依据 BENCHMARKING.md 的 Recording results 规范:当发生实质性性能变更或发布前,应显式刷新本文件并更新测量日期。提交到 BENCHMARKING.md 的数字必须使用 bench-lto profile 并记录测量上下文(CPU 型号、内核/操作系统、Rust 工具链、构建 profile)。若要进一步验证改动,可将运行纳入 CI 的 CodSpeed CPU 模拟比较,或用 cargo bench 的 Criterion 基线功能做本地背靠背对比;涉及 Python 端 PyO3 调用成本时,则应改用 Python 基准(见 scripts/benchmark-backtest-versions.py 的驱动模式)。
对于希望深入 Derive 适配器实现细节的读者,建议继续阅读:入站解析实现 src/websocket/parse.rs、出站负载构建 src/http/query.rs、分发与身份解析 src/execution.rs、签名与 nonce 管理 src/signing,以及基准输入所依赖的真实交易所抓包 test_data/perps 与 test_data/options。