nautilus_trader Lighter 适配器第三方许可审计L2 签名器依赖来源、固定修订与验证机制全解析【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader本篇技术指南以 Lighter 适配器第三方许可文档 为核心系统梳理 nautilus_trader 中nautilus-lightercrate 的 L2 交易签名器Schnorr over ECgFp5 Poseidon2所依赖的三方密码学材料Thomas Pornin 的 MIT 许可参考实现pornin/ecgfp5、Apache-2.0 许可的行为参考elliottech/poseidon_crypto以及官方lighter-pythonSDK 的编译签名者 oracle。读者将掌握每个第三方组件的具体用途、许可文本与固定修订的落盘位置、测试向量如何被固定与复现、以及 git 依赖如何被隔离在publishfalse的 fuzz crate 之外从而理解一个生产级交易引擎如何在引入外部密码学参考的同时保持 crates.io 发布图纯净与许可合规。文档背景L2 签名器为何需要第三方材料nautilus-lighter是 NautilusTrader 针对去中心化现货与永续合约交易所 Lighter 的适配器 crate。Lighter 通过自定义零知识 rollup 在 Ethereum 上结算订单由链下 sequencer 撮合交易以非托管方式由用户自有密钥授权见 Lighter 适配器 README。该 crate 内置了一个 L2 交易签名器其技术栈为Schnorr 签名基于ecgfp5 椭圆曲线Pornin, 2022曲线定义在Goldilocks 素数p 2^64 - 2^32 1的五次扩展域GF(p^5)之上以Poseidon2作为绑定哈希。这些原语并非从零闭门造车而是以公开规范与宽松许可参考为基准编写。这正是在 signing 模块文档注释 中明确声明的工程策略。因此第三方许可文档承担着三重职责归属与许可合规逐一列出被参考的第三方材料及其许可协议来源固定明确固定到具体上游修订commit保证可复现性验证边界说明哪些材料进入发布包图、哪些被隔离以及等价性验证如何执行。第三方组件一Thomas Pornin 的ecgfp5参考实现MIT用途与角色ecgfp5是 Pornin 发表的EcGFp5: a Specialized Elliptic CurveIACR ePrint 2022/274论文的配套参考 Rust 实现。在nautilus-lighter中它的角色是阅读参考reading referencesrc/signing/field/下的 Goldilocks 域Fp与五次扩展域GF(p^5)实现src/signing/curve/下的ecgfp5曲线与标量实现。这些 Rust 代码是依据论文并参考 Pornin 的代码原创编写的并非直接复制其实现。从 signing 模块文档注释 可以看到设计上的关键论证两套实现不共享代码血统no code lineage——Pornin 的实现自 2022 年起随论文公开并被多个下游零知识项目复用而本仓库的实现是从论文出发、以其代码为阅读参考写成的。这意味着通过差分测试门槛的缺陷必须同时以相同方式存在于两套实现中这在工程上几乎不可能。许可与归属项目内容版权归属Copyright (c) 2022 Thomas Pornin许可协议MIT License上游来源pornin/ecgfp5github 仓库完整许可文本MIT-pornin-ecgfp5.txt参考代码的消费方式与发布隔离许可文档强调了一个关键工程决策参考 crate 本身只被publishfalse的 fuzz crate 消费即fuzz/pornin/子 crate。从 fuzz/pornin/Cargo.toml 可以核实[package] name nautilus-lighter-fuzz version 0.0.0 edition 2024 publish false # Never publish to crates.io [dependencies] # ecgfp5 is Pornins reference Rust implementation (zero transitive deps; pinned by commit). ecgfp5 { git https://github.com/pornin/ecgfp5, rev ce059c6d1e1662db437aecbf3db6bb67fe63c716, version 0.1.0 } nautilus-lighter { path ../.. }这份配置印证了许可文档中的三点声明commit 固定通过rev ce059c6d1e1662db437aecbf3db6bb67fe63c716将参考实现钉死到具体上游修订零传递依赖ecgfp5不引入任何传递依赖隔离面干净不进入 crates.io 发布图publish false确保nautilus-lighter在 crates.io 上发布时包图中没有任何 git 依赖从而规避了 crates.io 不允许 git 依赖的发布约束。同时[workspace] members [.]将该 fuzz crate 独立成独立 workspace进一步与主发布包解耦。差分模糊测试验证许可文档指出fuzz/pornin/fuzz_targets/fuzz_pornin_diff_*.rs目标对每个公开代数操作断言字节级等价。实际的 fuzz 目标有三个见 fuzz/pornin/fuzz_targets/fuzz_pornin_diff_algebra.rs覆盖Fp5的加/减/乘/负/求逆以及Scalar的加/减/乘/负fuzz_pornin_diff_scalar_mul.rs任意基点上的标量乘法fuzz_pornin_diff_decode.rs点解码。主 fuzz 目录fuzz/fuzz_targets/下还包含针对签名器自身的覆盖引导目标如fuzz_point_decode.rs、fuzz_scalar_mul_ct_diff.rs常时标量乘差分、fuzz_verify.rs、fuzz_signature_codec.rs、fuzz_compute_tx_hash.rs、fuzz_hash_no_pad.rs与fuzz_auth_message.rs。README 中说明这些目标需要在仓库根目录执行make install-tools安装cargo-fuzz并以 nightly 工具链运行。第三方组件二elliottech/poseidon_cryptoApache-2.0用途与角色Go 语言库elliottech/poseidon_crypto在本 crate 中扮演**行为参考behavioral reference**角色src/signing/hash/下的 Poseidon2 哈希实现src/signing/schnorr/下 Lighter 在ecgfp5之上施加的 Schnorr 绑定。与ecgfp5不同poseidon_crypto 的定位不是阅读参考而是参数事实来源Lighter 特定参数集round constants 轮常数、MDS matrices 矩阵作为事实从上游抽取测试向量则复现自上游以验证端到端等价。许可、固定修订与归属项目内容固定修订fbd3713966eeeb9496166db9b599d4a3bb7b9e2b提交于 2026-04-10版权归属elliottech/poseidon_crypto贡献者许可协议Apache License 2.0上游来源elliottech/poseidon_cryptogithub 仓库完整许可文本Apache-2.0-poseidon-crypto.txt许可文档特别注明固定修订被记录在测试向量的元数据metadata中即下游可以直接从 fixture 反查所依赖的上游版本形成可审计的追溯链。测试向量固定与复现许可文档列出五个被逐字复现reproduced verbatim的测试向量文件全部位于 crates/adapters/lighter/test_data/ 目录测试向量文件覆盖层signing_field_goldilocks_vectors.jsonGoldilocks 域Fpsigning_field_quintic_vectors.json五次扩展域GF(p^5)signing_curve_ecgfp5_vectors.jsonecgfp5 曲线signing_hash_poseidon2_vectors.jsonPoseidon2 哈希signing_schnorr_vectors.jsonSchnorr 签名这些文件与签名器自身的 oracle fixturessigning_tx_oracle.json、signing_auth_token_oracle.json一起构成了许可文档所描述的与上游 Go 参考逐层向量对齐vector parity的验证基础。README 中将其总结为四层独立验证门的第一层。第三方组件三elliottech/lighter-pythonSDKApache-2.0用途与角色官方 Python SDK 的用途与前两者不同它的编译签名者compiled signer被用于生成 oracle fixtures而非链接进 crate。脚本位于 tests/oracle-py/generate_oracle.py它通过ctypes加载官方 SDK 分发的编译签名者对覆盖交易关键 L2 交易类型的确定性输入运行签名器输出 JSON fixture生成的 fixture 被src/signing/tx/encode.rs的测试消费用于字节等价测试byte-equivalence tests。许可文档明确限定了边界编译签名者不被 vendored 进本仓库也不链接进 crate——只有生成的 fixture 输出被提交。从脚本头部注释可以看到实现细节签名器的SignedHash是交易体元素的确定性 Poseidon2 哈希而签名本身使用随机采样的 noncek因此签名字节在不同运行间会变化——fixture 在签名器固定修订移动时重新生成测试将sig视为单个合法见证valid witness而非相等性目标。脚本还固定了上游版本与修订UPSTREAM_VERSION 1.1.2、UPSTREAM_REVISION 6957dd8a1b36894ca9580be0d51de30aeea3bd4a并镜像了 lighter-go 的交易类型判别值如 L2 create/cancel/modify order、APPROVE_INTEGRATOR 45等。许可与归属项目内容版权归属elliottech/lighter-python贡献者许可协议Apache License 2.0公开 SDK 仓库上游来源elliottech/lighter-pythongithub 仓库完整许可文本与 poseidon_crypto 共享 Apache-2.0-poseidon-crypto.txt同一 Apache-2.0 文本这是许可管理上一个值得注意的实践两个 Apache-2.0 上游共享同一份许可文本文件避免了重复存放而pornin/ecgfp5的 MIT 文本则单独存放形成两种许可协议的清晰分区。许可合规的工程实践总结综合许可文档与仓库实现可以提炼出 nautilus-lighter 在处理第三方密码学材料时的五条可复用准则角色分级区分阅读参考ecgfp5以论文为本、代码为辅与行为参考/参数事实源poseidon_crypto不同角色采用不同的验证强度修订固定git 依赖通过rev字段钉死ecgfp5 固定于ce059c6d...行为参考通过测试向量元数据记录修订poseidon_crypto 固定于fbd37139...oracle 通过脚本内常量固定lighter-python 固定于6957dd8a...发布隔离publish false 独立 workspace 将 git 依赖彻底隔离在 crates.io 发布图之外保证nautilus-lighter发布包无 git 依赖字节级验证差分 fuzz 目标对每个公开代数操作断言与参考实现字节相等测试向量逐字复现并提交到test_data/编译签名者 oracle 提供端到端输出对照许可文本落盘每个第三方组件的完整许可文本与归属、来源、修订信息一并提交在 licenses/ 目录形成可审计、可追溯的合规档案。值得注意的是许可文档与 README 均强调对 Lighter sequencer 最终接受什么与 Lighter 本身进行的回环测试round-trip testing仍是最终正确性门——第三方验证解决的是与参考实现一致而实际交易的最终裁决权在交易所侧。此外官方lighter-go/lighter-pythonSDK 包装的是闭源编译签名者见 signing 模块文档注释本 crate 的原创 Rust 实现正是为了在不依赖闭源二进制的前提下完成 L2 交易签名同时通过上述多层验证保证行为等价。【免费下载链接】nautilus_traderProduction-grade Rust-native trading engine with deterministic event-driven architecture项目地址: https://gitcode.com/GitHub_Trending/na/nautilus_trader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考