ethereum-gas-estimator-accuracy
收藏资源简介:
该数据集记录了七个独立以太坊 RPC 提供商对 gas 费用的估算建议,以及区块实际要求的 gas 费用。数据集的目的是评估不同提供商 gas 估算的准确性,揭示提供商之间的差异及其系统性原因。数据集包含三个表格:e29_gas_estimators 记录每个提供商在某个时刻的 gas 建议及其关联的区块高度;e29_eth_block_fees 记录每个区块的基础费用、实际支付的优先费用百分位数及 gas 使用比例;e30_gas_estimator_accuracy 将每个提供商的建议与对应区块的实际要求进行对比,得出充分性(sufficient_priority)和超额支付比例(overpay_priority)等指标。数据规模在 100K 到 1M 行之间,仅涵盖以太坊主网,采用七个无需 API 密钥的提供商,采样间隔为 20 秒,覆盖约 12 秒的区块,因此大部分区块被覆盖但非全部。数据以 Parquet 格式存储,按年月分区。适用任务包括时间序列预测、gas 费用估算准确性分析、区块链经济研究等。注意事项:数据仅代表特定窗口期(2026-08-31 至 2026-09-06),不包含历史建议,且部分建议可能因提供商失败而标记为错误,而非零值。许可为 ODC-BY,使用需注明出处。
This dataset records gas fee estimation suggestions from seven independent Ethereum RPC providers, along with the actual gas fees required by blocks. The purpose of the dataset is to evaluate the accuracy of gas estimations from different providers, revealing differences and their systemic causes. The dataset contains three tables: e29_gas_estimators records each providers gas suggestions at a given time along with the associated block height; e29_eth_block_fees records the base fee, actual paid priority fee percentiles, and gas usage ratio for each block; e30_gas_estimator_accuracy compares each providers suggestions with the actual requirements of the corresponding blocks, yielding metrics such as sufficient_priority and overpay_priority. The data size ranges from 100K to 1M rows, covering only the Ethereum mainnet, using seven providers that do not require API keys, with a sampling interval of 20 seconds, covering approximately 12-second blocks, so most blocks are covered but not all. The data is stored in Parquet format, partitioned by year and month. Applicable tasks include time series forecasting, gas fee estimation accuracy analysis, and blockchain economic research. Notes: The data only represents a specific window period (2026-08-31 to 2026-09-06), does not include historical suggestions, and some suggestions may be marked as errors due to provider failures rather than zero values. The license is ODC-BY, and attribution is required when using.
数据集概述
名称:Ethereum gas estimator accuracy
提供方:DataForge (dataforge-labs)
许可协议:ODC-BY(允许自由使用,需注明来源)
核心内容
该数据集记录了 7 个独立 RPC 提供商对以太坊 gas 费用的实时建议,以及这些建议所对应的区块实际所需费用。数据主要解决了以下问题:
- 不对称性:RPC 提供商的建议是瞬时的,事后无法追溯;而区块实际费用记录在链上,永久可查。该数据集通过实时采集,将两者关联起来。
- 核心价值:可用于评估不同 RPC 提供商 gas 费用估算的准确性与差异,支持时间序列预测与基准测试。
数据表结构
| 表名 | 内容描述 |
|---|---|
e29_gas_estimators |
每个提供商在某一时刻的 gas 建议,并标注其所在的区块高度。 |
e29_eth_block_fees |
每个区块的基础费、实际支付的优先费百分位数、gas 使用率。 |
e30_gas_estimator_accuracy |
每个提供商的建议与其所针对区块实际费用的对比评分结果。 |
关键发现
- 提供商之间存在系统性分歧:在相同区块内,
eth_gasPrice的中位差异为 7.3%,而eth_maxPriorityFeePerGas的差异高达 100%。部分提供商(如 MEV 保护型 RPC)由于看到的订单流不同,其建议存在本质差异,而非采样误差。 - 建议与区块匹配方式:每条建议都携带提供商报告时的头部区块编号,因此建议天然对应下一区块,并在后续区块中进行评分,无需依赖时间戳匹配,避免了常见的对齐误差。
数据解读与使用说明
- 关键字段:
sufficient_priority判断建议是否足以让交易在目标时间范围内被打包;overpay_priority表示建议值与实际清盘费用的比值(1.0 表示精确)。 - 清盘费用定义:采用区块中实际支付优先费的 10 百分位数(
cleared_p10_gwei)作为参考,而非最小值。数据同时提供 5 百分位数和中位数,便于使用者自行定义。 - 特殊值处理:当清盘费用为零时,
sufficient_priority为真,overpay_priority为 null(而非无穷大)。
数据范围与限制
- 网络:仅以太坊主网。L2 网络(如 Base、Optimism、Polygon、Arbitrum)虽经过探测,但各提供商之间差异极小(0%–0.3%),不纳入本数据集。
- 提供商选择:仅包含无需 API 密钥即可访问的 7 个 RPC 提供商,偏向服务于零售钱包的端点。
- 采样频率:每 20 秒采样一次,而以太坊出块时间约 12 秒,因此大多数区块被覆盖,但并非全部。
- 数据分区:采用 parquet 格式,按
dataset/YYYY/MM/目录存储。当前公开版本为固定 7 天样本窗口(2026-08-31 至 2026-09-06),完整历史数据需另行申请。
其他说明
- 错误处理:提供商请求失败时会记录错误,不会被记录为 gas 建议值为零,以确保区分“失败”和“真实的零小费”。
- 数据集清单:
e0_run_manifest表完整列出每个采集窗口的轮询次数与失败次数,该表不受窗口限制,全文公开。 - 加载示例:提供 Python 代码示例,可通过
huggingface_hub下载并读取e30_gas_estimator_accuracy表中的数据。




