Struct OpChainSpec

pub struct OpChainSpec {
    pub inner: ChainSpec,
}

Available on crate feature optimism only.

OP stack chain spec type.

Fields

inner: ChainSpec

ChainSpec.

Implementations

impl OpChainSpec

pub const fn new(inner: ChainSpec) -> OpChainSpec

impl OpChainSpec

pub fn decode_holocene_base_fee( &self, parent: &Header, timestamp: u64, ) -> Result<u64, EIP1559ParamError>

Extracts the Holocene 1599 parameters from the encoded extra data from the parent header.

Caution: Caller must ensure that holocene is active in the parent header.

See also Base fee computation

pub fn next_block_base_fee( &self, parent: &Header, timestamp: u64, ) -> Result<Uint<256, 4>, EIP1559ParamError>

Read from parent to determine the base fee for the next block

See also Base fee computation

Methods from Deref<Target = ChainSpec>

pub fn chain(&self) -> Chain

Get information about the chain itself

pub fn is_ethereum(&self) -> bool

Returns true if this chain contains Ethereum configuration.

pub fn is_optimism_mainnet(&self) -> bool

Returns true if this chain is Optimism mainnet.

pub fn paris_block(&self) -> Option<u64>

Returns the known paris block, if it exists.

pub fn genesis(&self) -> &Genesis

Get the genesis block specification.

To get the header for the genesis block, use Self::genesis_header instead.

pub fn genesis_header(&self) -> &Header

Get the header for the genesis block.

pub fn sealed_genesis_header(&self) -> SealedHeader

Get the sealed header for the genesis block.

pub fn initial_base_fee(&self) -> Option<u64>

Get the initial base fee of the genesis block.

pub fn base_fee_params_at_timestamp(&self, timestamp: u64) -> BaseFeeParams

Get the [BaseFeeParams] for the chain at the given timestamp.

pub fn base_fee_params_at_block(&self, block_number: u64) -> BaseFeeParams

Get the [BaseFeeParams] for the chain at the given block number

pub fn genesis_hash(&self) -> FixedBytes<32>

Get the hash of the genesis block.

pub fn genesis_timestamp(&self) -> u64

Get the timestamp of the genesis block.

pub fn get_final_paris_total_difficulty(&self) -> Option<Uint<256, 4>>

Returns the final total difficulty if the Paris hardfork is known.

pub fn final_paris_total_difficulty( &self, block_number: u64, ) -> Option<Uint<256, 4>>

Returns the final total difficulty if the given block number is after the Paris hardfork.

Note: technically this would also be valid for the block before the paris upgrade, but this edge case is omitted here.

pub fn hardfork_fork_filter<H>(&self, fork: H) -> Option<ForkFilter>

where H: Hardfork + Clone,

Get the fork filter for the given hardfork

pub fn display_hardforks(&self) -> DisplayHardforks

Returns the hardfork display helper.

pub fn hardfork_fork_id<H>(&self, fork: H) -> Option<ForkId>

where H: Hardfork + Clone,

Get the fork id for the given hardfork.

pub fn shanghai_fork_id(&self) -> Option<ForkId>

Convenience method to get the fork id for [EthereumHardfork::Shanghai] from a given chainspec.

pub fn cancun_fork_id(&self) -> Option<ForkId>

Convenience method to get the fork id for [EthereumHardfork::Cancun] from a given chainspec.

pub fn latest_fork_id(&self) -> ForkId

Convenience method to get the latest fork id from the chainspec. Panics if chainspec has no hardforks.

pub fn fork_filter(&self, head: Head) -> ForkFilter

Creates a [ForkFilter] for the block described by [Head].

pub fn fork_id(&self, head: &Head) -> ForkId

Compute the [ForkId] for the given [Head] following eip-6122 spec.

Note: In case there are multiple hardforks activated at the same block or timestamp, only the first gets applied.

pub fn bootnodes(&self) -> Option<Vec<NodeRecord>>

Returns the known bootnode records for the given chain.

Methods from Deref<Target = ChainHardforks>

pub fn len(&self) -> usize

Total number of hardforks.

pub fn is_empty(&self) -> bool

Checks if the fork list is empty.

pub fn fork<H>(&self, fork: H) -> ForkCondition

where H: Hardfork,

Retrieves [ForkCondition] from fork. If fork is not present, returns [ForkCondition::Never].

pub fn get<H>(&self, fork: H) -> Option<ForkCondition>

where H: Hardfork,

Retrieves [ForkCondition] from fork if it exists, otherwise None.

pub fn fork_block<H>(&self, fork: H) -> Option<u64>

where H: Hardfork,

Retrieves the fork block number or timestamp from fork if it exists, otherwise None.

pub fn forks_iter( &self, ) -> impl Iterator<Item = (&(dyn Hardfork + 'static), ForkCondition)>

Get an iterator of all hardforks with their respective activation conditions.

pub fn last(&self) -> Option<(Box<dyn Hardfork>, ForkCondition)>

Get last hardfork from the list.

pub fn is_fork_active_at_timestamp<H>(&self, fork: H, timestamp: u64) -> bool

where H: Hardfork,

Convenience method to check if a fork is active at a given timestamp.

pub fn is_fork_active_at_block<H>(&self, fork: H, block_number: u64) -> bool

where H: Hardfork,

Convenience method to check if a fork is active at a given block number.

Trait Implementations

impl Clone for OpChainSpec

fn clone(&self) -> OpChainSpec

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OpChainSpec

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

Formats the value using the given formatter.

impl Deref for OpChainSpec

type Target = ChainSpec

The resulting type after dereferencing.

fn deref(&self) -> &<OpChainSpec as Deref>::Target

Dereferences the value.

impl EthChainSpec for OpChainSpec

type Header = Header

The header type of the network.

fn chain(&self) -> Chain

Returns the [Chain] object this spec targets.

fn base_fee_params_at_block(&self, block_number: u64) -> BaseFeeParams

Get the [BaseFeeParams] for the chain at the given block.

fn base_fee_params_at_timestamp(&self, timestamp: u64) -> BaseFeeParams

Get the [BaseFeeParams] for the chain at the given timestamp.

fn deposit_contract(&self) -> Option<&DepositContract>

Returns the deposit contract data for the chain, if it’s present

fn genesis_hash(&self) -> FixedBytes<32>

The genesis hash.

fn prune_delete_limit(&self) -> usize

The delete limit for pruner, per run.

fn display_hardforks(&self) -> Box<dyn Display>

Returns a string representation of the hardforks.

fn genesis_header(&self) -> &<OpChainSpec as EthChainSpec>::Header

The genesis header.

fn genesis(&self) -> &Genesis

The genesis block specification.

fn bootnodes(&self) -> Option<Vec<NodeRecord>>

The bootnodes for the chain, if any.

fn is_optimism(&self) -> bool

Returns true if this chain contains Optimism configuration.

fn chain_id(&self) -> u64

Returns the chain id number

fn is_ethereum(&self) -> bool

Returns true if this chain contains Ethereum configuration.

impl EthereumHardforks for OpChainSpec

fn get_final_paris_total_difficulty(&self) -> Option<Uint<256, 4>>

Returns the final total difficulty if the Paris hardfork is known.

fn final_paris_total_difficulty( &self, block_number: u64, ) -> Option<Uint<256, 4>>

Returns the final total difficulty if the given block number is after the Paris hardfork.

fn is_shanghai_active_at_timestamp(&self, timestamp: u64) -> bool

Convenience method to check if [EthereumHardfork::Shanghai] is active at a given timestamp.

fn is_cancun_active_at_timestamp(&self, timestamp: u64) -> bool

Convenience method to check if [EthereumHardfork::Cancun] is active at a given timestamp.

fn is_prague_active_at_timestamp(&self, timestamp: u64) -> bool

Convenience method to check if [EthereumHardfork::Prague] is active at a given timestamp.

fn is_osaka_active_at_timestamp(&self, timestamp: u64) -> bool

Convenience method to check if [EthereumHardfork::Osaka] is active at a given timestamp.

fn is_byzantium_active_at_block(&self, block_number: u64) -> bool

Convenience method to check if [EthereumHardfork::Byzantium] is active at a given block number.

fn is_spurious_dragon_active_at_block(&self, block_number: u64) -> bool

Convenience method to check if [EthereumHardfork::SpuriousDragon] is active at a given block number.

fn is_homestead_active_at_block(&self, block_number: u64) -> bool

Convenience method to check if [EthereumHardfork::Homestead] is active at a given block number.

fn is_paris_active_at_block(&self, block_number: u64) -> Option<bool>

The Paris hardfork (merge) is activated via block number. If we have knowledge of the block, this function will return true if the block number is greater than or equal to the Paris (merge) block.

impl From<Genesis> for OpChainSpec

fn from(genesis: Genesis) -> OpChainSpec

Converts to this type from the input type.

impl From<OpChainSpec> for ChainSpec

fn from(value: OpChainSpec) -> ChainSpec

Converts to this type from the input type.

impl Hardforks for OpChainSpec

fn fork<H>(&self, fork: H) -> ForkCondition

where H: Hardfork,

Retrieves [ForkCondition] from fork. If fork is not present, returns [ForkCondition::Never].

fn forks_iter( &self, ) -> impl Iterator<Item = (&(dyn Hardfork + 'static), ForkCondition)>

Get an iterator of all hardforks with their respective activation conditions.

fn fork_id(&self, head: &Head) -> ForkId

Compute the [ForkId] for the given [Head] following eip-6122 spec

fn latest_fork_id(&self) -> ForkId

Returns the [ForkId] for the last fork.

fn fork_filter(&self, head: Head) -> ForkFilter

Creates a [ForkFilter] for the block described by [Head].

fn is_fork_active_at_timestamp<H>(&self, fork: H, timestamp: u64) -> bool

where H: Hardfork,

Convenience method to check if a fork is active at a given timestamp.

fn is_fork_active_at_block<H>(&self, fork: H, block_number: u64) -> bool

where H: Hardfork,

Convenience method to check if a fork is active at a given block number.

impl OpHardforks for OpChainSpec

fn is_bedrock_active_at_block(&self, block_number: u64) -> bool

Convenience method to check if OpHardfork::Bedrock is active at a given block number.

fn is_regolith_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Regolith is active at given block timestamp.

fn is_canyon_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Canyon is active at given block timestamp.

fn is_ecotone_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Ecotone is active at given block timestamp.

fn is_fjord_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Fjord is active at given block timestamp.

fn is_granite_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Granite is active at given block timestamp.

fn is_holocene_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Holocene is active at given block timestamp.

fn is_isthmus_active_at_timestamp(&self, timestamp: u64) -> bool

Returns true if Isthmus is active at given block timestamp.

impl PartialEq for OpChainSpec

fn eq(&self, other: &OpChainSpec) -> 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 OpChainSpec

impl StructuralPartialEq for OpChainSpec

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 1792 bytes