Uses eth_feeHistory
(an EIP-1559 feature) to obtain information about gas fees from a range of
blocks that have occurred recently on a network.
To learn more, see these resources:
The arguments to this function.
The desired end of the requested block range. Can be "latest" if you want to start from the latest successful block or the number of a known past block.
An EthQuery instance that wraps a provider for the network in question.
How many total blocks to fetch. Note that if this is more than 1024,
multiple calls to eth_feeHistory
will be made.
A set of numbers between 1 and 100 which will dictate how
priorityFeesByPercentile
in each returned block will be formed. When Ethereum runs the
eth_feeHistory
method, for each block it is considering, it will first sort all transactions by
the priority fee. It will then go through each transaction and add the total amount of gas paid
for that transaction to a bucket which maxes out at the total gas used for the whole block. As
the bucket fills, it will cross percentages which correspond to the percentiles specified here,
and the priority fees of the first transactions which cause it to reach those percentages will be
recorded. Hence, priorityFeesByPercentile
represents the priority fees of transactions at key
gas used contribution levels, where earlier levels have smaller contributions and later levels
have higher contributions.
The list of blocks and their fee data, sorted from oldest to newest.
Generated using TypeDoc
number - The number of the block, as a BN.
baseFeePerGas - The base fee per gas for the block in WEI, as a BN.
gasUsedRatio - A number between 0 and 1 that represents the ratio between the gas paid for the block and its set gas limit.
priorityFeesByPercentile - The priority fees paid for the transactions in the block that occurred at particular levels at which those transactions contributed to the overall gas used for the block, indexed by those percentiles. (See docs for {@link fetchBlockFeeHistory} for more on how this works.)