Gas

Examples

Note

These examples are a Jupyter notebook. Grab the original notebook here

gas

In [1]:

from ctc import evm

Get Individual Block Gas Stats¶

In [2]:

block_gas_stats = await evm.async_get_block_gas_stats(14000000)

block_gas_stats

Out[2]:

{'base_fee': 139.541559304,
 'min_gas_price': 140.0,
 'median_gas_price': 142.203313325,
 'mean_gas_price': 152.89720574486594,
 'max_gas_price': 230.0,
 'gas_used': 8119826,
 'gas_limit': 30058561,
 'n_transactions': 112}

Aggregate Multiple Block Gas Stats¶

In [3]:

blocks_gas_stats = await evm.async_get_blocks_gas_stats(
    start_block=14000000,
    end_block=14000100
)

blocks_gas_stats

Out[3]:

{'min_base_fee': 116.684032033,
 'median_base_fee': 180.458274018,
 'mean_base_fee': 5607626126.755782,
 'max_base_fee': 212809153921,
 'min_gas_price': 116.684032033,
 'min_median_gas_price': 119.184032033,
 'min_mean_gas_price': 133.06055913633344,
 'min_max_gas_price': 136.014552098,
 'median_min_gas_price': 180.43562949,
 'median_median_gas_price': 181.55053352,
 'median_mean_gas_price': 188.3772817841438,
 'median_max_gas_price': 285.4267255985,
 'mean_min_gas_price': 177.06014014478572,
 'mean_median_gas_price': 178.64983315020413,
 'mean_gas_price': 187.39525476608267,
 'mean_max_gas_price': 587.4157569185102,
 'max_min_gas_price': 237.755849363,
 'max_median_gas_price': 238.255849363,
 'max_mean_gas_price': 305.68400393096164,
 'max_gas_price': 20263.608159707,
 'min_gas_used': 0,
 'median_gas_used': 14518894.0,
 'mean_gas_used': 15731316.811881188,
 'max_gas_used': 30099037,
 'min_gas_limit': 29912200,
 'median_gas_limit': 30029069.0,
 'mean_gas_limit': 30029179.643564355,
 'max_gas_limit': 30136881,
 'min_n_transactions': 0,
 'median_n_transactions': 191.0,
 'mean_n_transactions': 201.12871287128712,
 'max_n_transactions': 482,
 'n_blocks': 101}

Reference

async ctc.evm.async_get_block_gas_stats(block, normalize=True, provider=None)

get gas statistics for a given block

Parameters

block (BlockNumberReference | Block) –
normalize (bool) –
provider (ProviderSpec) –

Return type

BlockGasStats

async ctc.evm.async_get_blocks_gas_stats(blocks=None, start_block=None, end_block=None, normalize=True, provider=None)

get gas statistics aggregated over multiple blocks

Parameters

blocks (Sequence[BlockNumberReference] | None) –
start_block (BlockNumberReference | None) –
end_block (BlockNumberReference | None) –
normalize (bool) –
provider (ProviderSpec) –

Return type

BlocksGasStats

class ctc.evm.BlockGasStats(**kwargs)

base_fee: int | float | None

gas_limit: int

gas_used: int

max_gas_price: int | float | None

mean_gas_price: float | None

median_gas_price: int | float | None

min_gas_price: int | float | None

n_transactions: int

class ctc.evm.BlocksGasStats(**kwargs)

max_base_fee: int | float | None

max_gas_limit: int | float | None

max_gas_price: int | float | None

max_gas_used: int | float | None

max_mean_gas_price: int | float | None

max_median_gas_price: int | float | None

max_min_gas_price: int | float | None

max_n_transactions: int | float | None

mean_base_fee: int | float | None

mean_gas_limit: int | float | None

mean_gas_price: int | float | None

mean_gas_used: int | float | None

mean_max_gas_price: int | float | None

mean_median_gas_price: int | float | None

mean_min_gas_price: int | float | None

mean_n_transactions: int | float | None

median_base_fee: int | float | None

median_gas_limit: int | float | None

median_gas_used: int | float | None

median_max_gas_price: int | float | None

median_mean_gas_price: int | float | None

median_median_gas_price: int | float | None

median_min_gas_price: int | float | None

median_n_transactions: int | float | None

min_base_fee: int | float | None

min_gas_limit: int | float | None

min_gas_price: int | float | None

min_gas_used: int | float | None

min_max_gas_price: int | float | None

min_mean_gas_price: int | float | None

min_median_gas_price: int | float | None

min_n_transactions: int | float | None

n_blocks: int