Struct L1BlockInfo

pub struct L1BlockInfo {
    pub l1_base_fee: U256,
    pub l1_fee_overhead: Option<U256>,
    pub l1_base_fee_scalar: U256,
    pub l1_blob_base_fee: Option<U256>,
    pub l1_blob_base_fee_scalar: Option<U256>,
    /* private fields */
}

L1 block info

We can extract L1 epoch data from each L2 block, by looking at the setL1BlockValues transaction data. This data is then used to calculate the L1 cost of a transaction.

Here is the format of the setL1BlockValues transaction data:

setL1BlockValues(uint64 _number, uint64 _timestamp, uint256 _basefee, bytes32 _hash, uint64 _sequenceNumber, bytes32 _batcherHash, uint256 _l1FeeOverhead, uint256 _l1FeeScalar)

For now, we only care about the fields necessary for L1 cost calculation.

Fields

l1_base_fee: U256

The base fee of the L1 origin block.

l1_fee_overhead: Option<U256>

The current L1 fee overhead. None if Ecotone is activated.

l1_base_fee_scalar: U256

The current L1 fee scalar.

l1_blob_base_fee: Option<U256>

The current L1 blob base fee. None if Ecotone is not activated, except if empty_scalars is true.

l1_blob_base_fee_scalar: Option<U256>

The current L1 blob base fee scalar. None if Ecotone is not activated.

Implementations

impl L1BlockInfo

pub fn try_fetch<DB: Database>( db: &mut DB, spec_id: OpSpec, ) -> Result<L1BlockInfo, DB::Error>

Try to fetch the L1 block info from the database.

pub fn data_gas(&self, input: &[u8], spec_id: OpSpec) -> U256

Calculate the data gas for posting the transaction on L1. Calldata costs 16 gas per byte after compression.

Prior to fjord, calldata costs 16 gas per non-zero byte and 4 gas per zero byte.

Prior to regolith, an extra 68 non-zero bytes were included in the rollup data costs to account for the empty signature.

pub fn calculate_tx_l1_cost(&self, input: &[u8], spec_id: OpSpec) -> U256

Calculate the gas cost of a transaction based on L1 block data posted on L2, depending on the OpSpec passed.

Trait Implementations

impl Clone for L1BlockInfo

fn clone(&self) -> L1BlockInfo

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for L1BlockInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for L1BlockInfo

fn default() -> L1BlockInfo

Returns the “default value” for a type.

impl PartialEq for L1BlockInfo

fn eq(&self, other: &L1BlockInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for L1BlockInfo

impl StructuralPartialEq for L1BlockInfo