跳到正文
← 使用教程

0xArchive L4订单簿能续读吗?核检查点、队列和缺口恢复

链小知 · 进阶 · 核验 · 依官方文档整理

区分在簿状态和订单生命周期,按已保存材料核序列、分页与版本。

开始前准备

  • 准备自己已有的脱敏材料与请求参数,保留对象、时间、单位和权限说明;缺值不补零。

1. 先锁场所家族和记录深度

Hyperliquid core/Spot/HIP-3/HIP-4分别走自己的L4路径;Lighter为L3,不能套L4状态。L2聚合价位、L4在簿逐订单、order-history/order-flow生命周期各自独立。core/HIP-3 native L2最多20层,全深度/l2由L4派生且历史起点不同,depth=200不让旧native路由变全深度。保存family、symbol、route/schema与时间。

检查结果:场所、深度、在簿状态和生命周期分开,没有用L2替代L4。

2. 固定版本、时点与检查点

新契约REST头为0xArchive-Version:2026-10-01,WebSocket连接URL用同日version;省略则保留旧形状。REST通常RFC3339时间,整数毫秒用_ms后缀;L4旧样例订单timestamp仍整数,新版本改字符串并附timestamp_ms,未知入队时点可null。保留实际响应版本,不按当前日期自动升级解析。checkpoint_timestamp、last_block_number与diffs_applied分别核,0代表干净检查点。

检查结果:版本、原时间形态、检查点和区块明确,旧/新字段未盲目混合。

3. 按服务器顺序与队列位置更新

L4订阅先l4_snapshot,再有序l4_batch;书页按queue priority排列,不能只按timestamp重排。new-order diff的insert_before有值则插在指定order ID之前,无值才追加队尾;保留bn/oid及原顺序。生命周期l4_orders也使用l4_batch但不等在簿diff,core/HIP-3只带accepted,Spot/HIP-4还可能带rejected与status原因,不能把所有事件直接插入书。

检查结果:队列位置、事件类别和原顺序有依据,未仅按时间或状态名重建。

4. 分页与覆盖信号不当市场静默

history/diff保留start/end/limit/过滤,cursor原样传并保持其它参数不变;meta.has_more=false才结束,短页仍可有下一页。coverage_from/notice可说明范围早于该symbol,range_before_coverage与unsupported_for_venue是错误,不是零挂单。L4 bid_count/ask_count可为未按depth截断的全检查点计数,不能当所见数组长度;总量与截断深度分开。

检查结果:覆盖、终止标志和截断范围分别核,空页或错误未当市场无订单。

5. 遇缺口停止输出并重建

发现sequence/replay gap应把状态标为不安全、停止输出,并从新快照/检查点重建或重跑限定窗口,不能跳掉事件继续宣称完整。先保证一symbol能跟上,允许降UI刷新而不能丢书事件;本篇只核已有材料,未连接或重放。REST与WebSocket认证不同,托管MCP另用OAuth;已读文档不证明本人权限、真实队列或重建结果正确。

检查结果:缺口分支和恢复证据明确,未在未知状态输出完整订单簿。

怎样确认完成

  • 得到带family、版本、检查点、序列和恢复缺项的记录;真实数据流、队列重建与本人权限未验证。

常见错误与边界

  • L2价格/数量多为十进制字符串,L4价格/数量为数值,逐路由核类型。
  • 可重放、当前覆盖和原始首次公开可得性不是同一证明。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据