l2-preconfirmation-reliability
收藏资源简介:
该数据集名为“L2 排序器预确认可靠性”,用于记录L2排序器(sequencer)在交易最终在L1上确认前所做出的包含承诺是否被遵守。数据集包含两种类型的行:心跳(heartbeat),记录unsafe head领先safe head的延迟;以及违规(violation),记录承诺被打破的事件。每个样本包含检查数量(n_checked)、失败数量(n_failed)、行类型(row_type)等字段。其中lag_blocks字段仅在safe_tag_plausible为真时才有意义。数据以Parquet格式存储,按收集窗口(年/月)分区,并提供固定7天的样本窗口供评估。数据规模约为100K到1M条记录,适用于时间序列预测、可靠性分析等任务。请注意:由于采样间隔(每几秒一次),部分违规可能无法被捕获;该数据集仅包含9条OP-stack链,不能推广到其他架构;安全头延迟在不同链间差异巨大,建议与自身历史比较而非跨链比较。
The dataset is named L2 sequencer pre-confirmation reliability, used to record whether the inclusion promises made by the L2 sequencer before the transaction is finally confirmed on L1 are kept. It contains two types of rows: heartbeat, which records the delay of unsafe head ahead of safe head; and violation, which records events where promises are broken. Each sample includes fields such as n_checked, n_failed, row_type, etc. The lag_blocks field is meaningful only when safe_tag_plausible is true. Data is stored in Parquet format, partitioned by collection window (year/month), and provides a fixed 7-day sample window for evaluation. The data scale is approximately 100K to 1M records, suitable for tasks such as time series forecasting and reliability analysis. Note: Due to the sampling interval (every few seconds), some violations may not be captured; the dataset only contains 9 OP-stack chains and cannot be generalized to other architectures; safe head lag varies significantly across chains, and it is recommended to compare with own history rather than cross-chain comparison.
数据集概述:L2 排序器预确认可靠性
本数据集记录了 Layer-2(L2)区块链网络中,排序器(Sequencer)对其交易预确认承诺的实际兑现情况,核心在于捕捉并验证那些“承诺但未履行”的少数违约事件,其价值主要体现在违约记录的稀缺性以及零违约记录的可信度上。
1. 数据集核心内容与结构
- 数据集名称:
dataforge-labs/l2-preconfirmation-reliability - 主要内容: 记录了 L2 排序器在交易于 L1 最终确认之前,所做出的包含承诺是否真的兑现。由于被替换的区块原始版本不会被保留,因此只有主动记录原始信息的主体才能观察到违约行为。
- 数据表:
e14_l2_preconf: 主要数据表,每行代表一个“心跳”(Heartbeat)记录或一个“违约”(Violation)事件。- 心跳: 记录不安全头区块(unsafe head)领先于安全头区块(safe head)的距离。
- 违约: 记录实际发生的承诺未兑现事件。
row_type字段: 用于区分数据行是“心跳”还是“违约”。- 关键字段:
n_checked: 实际已验证的承诺数量。n_failed: 未能完成检查的数量。lag_blocks: 安全头区块落后于不安全头区块的数量。safe_tag_plausible: 一个布尔标志,指出lag_blocks字段是否有效。
- 数据格式与获取: 数据以 Parquet 格式存储,按收集时间窗口分片,目录结构为
dataset/YYYY/MM/。提供了 Python 代码示例用于通过huggingface_hub库下载和加载数据。
2. 数据覆盖范围与重要说明
- 数据窗口: 数据具有一个固定的 7 天采样窗口,起始于数据集自身收集的首日,覆盖时间跨度为 2026-08-26 至 2026-09-01。该窗口不会更新。
- 数据规模: 数据行数在 100,000 到 1,000,000 之间(100K<n<1M)。
- 覆盖链: 数据覆盖 9 条 OP-Stack 架构的链,由9个独立的排序器运营商运行。因此,数据可用于比较这些链之间的表现,但因架构单一,不能将其结论泛化至其他不同架构的 Rollup。
- 不完全监测: 由于不安全头区块每几秒采样一次,两个采样点之间被提出并被替换的区块无法被捕捉到。这意味着数据会低估违约数量,绝不会高估。
3. 使用时的关键注意事项
lag_blocks字段的有效性: 当safe_tag_plausible为false时,lag_blocks字段没有意义。这是因为个别链的公共端点间歇性提供过时的安全标签,导致数据出现异常。建议按此标志位进行过滤,而不是按链名称排除。- 安全头区块差距巨大: 各链在正常运行状态下的安全头区块滞后量差异巨大(从几十个区块到几千个,甚至出现数千万的极端值)。因此,应比较链自身的历史数据,而不是在不同链之间进行绝对数值比较。
lag_blocks的数据价值: 端点自身的不一致性被认为是公共基础设施运行的客观事实,因此该字段被保留,以便用户了解数据源的真实状态。
4. 数据全集与元数据
- 运行清单: 名为
e0_run_manifest的表列出了每个收集窗口的轮询次数和失败次数。该表以完整形式发布,不包含在固定的7天窗口内。窗口之间的数据空缺是真实存在的,无法事后填补,数据中也没有任何插值。 - 完整历史数据: 完整的收集历史数据为私有数据,可通过数据集的“讨论”标签页申请获取。
5. 许可与引用
- 许可证: 采用 ODC-BY (Open Data Commons Attribution License) 许可。
- 引用要求: 允许自由使用数据,但需注明出处:“DataForge (dataforge-labs)”。





