reth_optimism_chainspec/
lib.rs

1//! OP-Reth chain specs.
2
3#![doc(
4    html_logo_url = "https://raw.githubusercontent.com/paradigmxyz/reth/main/assets/reth-docs.png",
5    html_favicon_url = "https://avatars0.githubusercontent.com/u/97369466?s=256",
6    issue_tracker_base_url = "https://github.com/paradigmxyz/reth/issues/"
7)]
8#![cfg_attr(docsrs, feature(doc_cfg))]
9#![cfg_attr(not(test), warn(unused_crate_dependencies))]
10#![cfg_attr(not(feature = "std"), no_std)]
11
12// About the provided chain specs from `res/superchain-configs.tar`:
13// The provided `OpChainSpec` structs are built from config files read from
14// `superchain-configs.tar`. This `superchain-configs.tar` file contains the chain configs and
15// genesis files for all chains. It is created by the `fetch_superchain_config.sh` script in
16// the `res` directory. Where all configs are where initial loaded from
17// <https://github.com/ethereum-optimism/superchain-registry>. See the script for more details.
18//
19// The file is a tar archive containing the following files:
20// - `genesis/<environment>/<chain_name>.json.zz`: The genesis file compressed with deflate. It
21//   contains the initial accounts, etc.
22// - `configs/<environment>/<chain_name>.json`: The chain metadata file containing the chain id,
23//   hard forks, etc.
24//
25// For example, for `UNICHAIN_MAINNET`, the `genesis/mainnet/unichain.json.zz` and
26// `configs/mainnet/base.json` is loaded and combined into the `OpChainSpec` struct.
27// See `read_superchain_genesis` in `configs.rs` for more details.
28//
29// To update the chain specs, run the `fetch_superchain_config.sh` script in the `res` directory.
30// This will fetch the latest chain configs from the superchain registry and create a new
31// `superchain-configs.tar` file. See the script for more details.
32
33extern crate alloc;
34
35mod base;
36mod base_sepolia;
37mod basefee;
38
39pub mod constants;
40mod dev;
41mod op;
42mod op_sepolia;
43
44#[cfg(feature = "superchain-configs")]
45mod superchain;
46#[cfg(feature = "superchain-configs")]
47pub use superchain::*;
48
49pub use base::BASE_MAINNET;
50pub use base_sepolia::BASE_SEPOLIA;
51pub use basefee::*;
52pub use dev::OP_DEV;
53pub use op::OP_MAINNET;
54pub use op_sepolia::OP_SEPOLIA;
55
56/// Re-export for convenience
57pub use reth_optimism_forks::*;
58
59use alloc::{boxed::Box, vec, vec::Vec};
60use alloy_chains::Chain;
61use alloy_consensus::{proofs::storage_root_unhashed, BlockHeader, Header};
62use alloy_eips::eip7840::BlobParams;
63use alloy_genesis::Genesis;
64use alloy_hardforks::Hardfork;
65use alloy_primitives::{B256, U256};
66use derive_more::{Constructor, Deref, From, Into};
67use reth_chainspec::{
68    BaseFeeParams, BaseFeeParamsKind, ChainSpec, ChainSpecBuilder, DepositContract,
69    DisplayHardforks, EthChainSpec, EthereumHardforks, ForkFilter, ForkId, Hardforks, Head,
70};
71use reth_ethereum_forks::{ChainHardforks, EthereumHardfork, ForkCondition};
72use reth_network_peers::NodeRecord;
73use reth_optimism_primitives::ADDRESS_L2_TO_L1_MESSAGE_PASSER;
74use reth_primitives_traits::{sync::LazyLock, SealedHeader};
75
76/// Chain spec builder for a OP stack chain.
77#[derive(Debug, Default, From)]
78pub struct OpChainSpecBuilder {
79    /// [`ChainSpecBuilder`]
80    inner: ChainSpecBuilder,
81}
82
83impl OpChainSpecBuilder {
84    /// Construct a new builder from the base mainnet chain spec.
85    pub fn base_mainnet() -> Self {
86        let mut inner = ChainSpecBuilder::default()
87            .chain(BASE_MAINNET.chain)
88            .genesis(BASE_MAINNET.genesis.clone());
89        let forks = BASE_MAINNET.hardforks.clone();
90        inner = inner.with_forks(forks);
91
92        Self { inner }
93    }
94
95    /// Construct a new builder from the optimism mainnet chain spec.
96    pub fn optimism_mainnet() -> Self {
97        let mut inner =
98            ChainSpecBuilder::default().chain(OP_MAINNET.chain).genesis(OP_MAINNET.genesis.clone());
99        let forks = OP_MAINNET.hardforks.clone();
100        inner = inner.with_forks(forks);
101
102        Self { inner }
103    }
104}
105
106impl OpChainSpecBuilder {
107    /// Set the chain ID
108    pub fn chain(mut self, chain: Chain) -> Self {
109        self.inner = self.inner.chain(chain);
110        self
111    }
112
113    /// Set the genesis block.
114    pub fn genesis(mut self, genesis: Genesis) -> Self {
115        self.inner = self.inner.genesis(genesis);
116        self
117    }
118
119    /// Add the given fork with the given activation condition to the spec.
120    pub fn with_fork<H: Hardfork>(mut self, fork: H, condition: ForkCondition) -> Self {
121        self.inner = self.inner.with_fork(fork, condition);
122        self
123    }
124
125    /// Add the given forks with the given activation condition to the spec.
126    pub fn with_forks(mut self, forks: ChainHardforks) -> Self {
127        self.inner = self.inner.with_forks(forks);
128        self
129    }
130
131    /// Remove the given fork from the spec.
132    pub fn without_fork(mut self, fork: OpHardfork) -> Self {
133        self.inner = self.inner.without_fork(fork);
134        self
135    }
136
137    /// Enable Bedrock at genesis
138    pub fn bedrock_activated(mut self) -> Self {
139        self.inner = self.inner.paris_activated();
140        self.inner = self.inner.with_fork(OpHardfork::Bedrock, ForkCondition::Block(0));
141        self
142    }
143
144    /// Enable Regolith at genesis
145    pub fn regolith_activated(mut self) -> Self {
146        self = self.bedrock_activated();
147        self.inner = self.inner.with_fork(OpHardfork::Regolith, ForkCondition::Timestamp(0));
148        self
149    }
150
151    /// Enable Canyon at genesis
152    pub fn canyon_activated(mut self) -> Self {
153        self = self.regolith_activated();
154        // Canyon also activates changes from L1's Shanghai hardfork
155        self.inner = self.inner.with_fork(EthereumHardfork::Shanghai, ForkCondition::Timestamp(0));
156        self.inner = self.inner.with_fork(OpHardfork::Canyon, ForkCondition::Timestamp(0));
157        self
158    }
159
160    /// Enable Ecotone at genesis
161    pub fn ecotone_activated(mut self) -> Self {
162        self = self.canyon_activated();
163        self.inner = self.inner.with_fork(EthereumHardfork::Cancun, ForkCondition::Timestamp(0));
164        self.inner = self.inner.with_fork(OpHardfork::Ecotone, ForkCondition::Timestamp(0));
165        self
166    }
167
168    /// Enable Fjord at genesis
169    pub fn fjord_activated(mut self) -> Self {
170        self = self.ecotone_activated();
171        self.inner = self.inner.with_fork(OpHardfork::Fjord, ForkCondition::Timestamp(0));
172        self
173    }
174
175    /// Enable Granite at genesis
176    pub fn granite_activated(mut self) -> Self {
177        self = self.fjord_activated();
178        self.inner = self.inner.with_fork(OpHardfork::Granite, ForkCondition::Timestamp(0));
179        self
180    }
181
182    /// Enable Holocene at genesis
183    pub fn holocene_activated(mut self) -> Self {
184        self = self.granite_activated();
185        self.inner = self.inner.with_fork(OpHardfork::Holocene, ForkCondition::Timestamp(0));
186        self
187    }
188
189    /// Enable Isthmus at genesis
190    pub fn isthmus_activated(mut self) -> Self {
191        self = self.holocene_activated();
192        self.inner = self.inner.with_fork(OpHardfork::Isthmus, ForkCondition::Timestamp(0));
193        self
194    }
195
196    /// Enable Jovian at genesis
197    pub fn jovian_activated(mut self) -> Self {
198        self = self.isthmus_activated();
199        self.inner = self.inner.with_fork(OpHardfork::Jovian, ForkCondition::Timestamp(0));
200        self
201    }
202
203    /// Enable Interop at genesis
204    pub fn interop_activated(mut self) -> Self {
205        self = self.jovian_activated();
206        self.inner = self.inner.with_fork(OpHardfork::Interop, ForkCondition::Timestamp(0));
207        self
208    }
209
210    /// Build the resulting [`OpChainSpec`].
211    ///
212    /// # Panics
213    ///
214    /// This function panics if the chain ID and genesis is not set ([`Self::chain`] and
215    /// [`Self::genesis`])
216    pub fn build(self) -> OpChainSpec {
217        let mut inner = self.inner.build();
218        inner.genesis_header =
219            SealedHeader::seal_slow(make_op_genesis_header(&inner.genesis, &inner.hardforks));
220
221        OpChainSpec { inner }
222    }
223}
224
225/// OP stack chain spec type.
226#[derive(Debug, Clone, Deref, Into, Constructor, PartialEq, Eq)]
227pub struct OpChainSpec {
228    /// [`ChainSpec`].
229    pub inner: ChainSpec,
230}
231
232impl OpChainSpec {
233    /// Converts the given [`Genesis`] into a [`OpChainSpec`].
234    pub fn from_genesis(genesis: Genesis) -> Self {
235        genesis.into()
236    }
237}
238
239impl EthChainSpec for OpChainSpec {
240    type Header = Header;
241
242    fn chain(&self) -> Chain {
243        self.inner.chain()
244    }
245
246    fn base_fee_params_at_timestamp(&self, timestamp: u64) -> BaseFeeParams {
247        self.inner.base_fee_params_at_timestamp(timestamp)
248    }
249
250    fn blob_params_at_timestamp(&self, timestamp: u64) -> Option<BlobParams> {
251        self.inner.blob_params_at_timestamp(timestamp)
252    }
253
254    fn deposit_contract(&self) -> Option<&DepositContract> {
255        self.inner.deposit_contract()
256    }
257
258    fn genesis_hash(&self) -> B256 {
259        self.inner.genesis_hash()
260    }
261
262    fn prune_delete_limit(&self) -> usize {
263        self.inner.prune_delete_limit()
264    }
265
266    fn display_hardforks(&self) -> Box<dyn core::fmt::Display> {
267        // filter only op hardforks
268        let op_forks = self.inner.hardforks.forks_iter().filter(|(fork, _)| {
269            !EthereumHardfork::VARIANTS.iter().any(|h| h.name() == (*fork).name())
270        });
271
272        Box::new(DisplayHardforks::new(op_forks))
273    }
274
275    fn genesis_header(&self) -> &Self::Header {
276        self.inner.genesis_header()
277    }
278
279    fn genesis(&self) -> &Genesis {
280        self.inner.genesis()
281    }
282
283    fn bootnodes(&self) -> Option<Vec<NodeRecord>> {
284        self.inner.bootnodes()
285    }
286
287    fn is_optimism(&self) -> bool {
288        true
289    }
290
291    fn final_paris_total_difficulty(&self) -> Option<U256> {
292        self.inner.final_paris_total_difficulty()
293    }
294
295    fn next_block_base_fee(&self, parent: &Header, target_timestamp: u64) -> Option<u64> {
296        if self.is_jovian_active_at_timestamp(parent.timestamp()) {
297            compute_jovian_base_fee(self, parent, target_timestamp).ok()
298        } else if self.is_holocene_active_at_timestamp(parent.timestamp()) {
299            decode_holocene_base_fee(self, parent, target_timestamp).ok()
300        } else {
301            self.inner.next_block_base_fee(parent, target_timestamp)
302        }
303    }
304}
305
306impl Hardforks for OpChainSpec {
307    fn fork<H: Hardfork>(&self, fork: H) -> ForkCondition {
308        self.inner.fork(fork)
309    }
310
311    fn forks_iter(&self) -> impl Iterator<Item = (&dyn Hardfork, ForkCondition)> {
312        self.inner.forks_iter()
313    }
314
315    fn fork_id(&self, head: &Head) -> ForkId {
316        self.inner.fork_id(head)
317    }
318
319    fn latest_fork_id(&self) -> ForkId {
320        self.inner.latest_fork_id()
321    }
322
323    fn fork_filter(&self, head: Head) -> ForkFilter {
324        self.inner.fork_filter(head)
325    }
326}
327
328impl EthereumHardforks for OpChainSpec {
329    fn ethereum_fork_activation(&self, fork: EthereumHardfork) -> ForkCondition {
330        self.fork(fork)
331    }
332}
333
334impl OpHardforks for OpChainSpec {
335    fn op_fork_activation(&self, fork: OpHardfork) -> ForkCondition {
336        self.fork(fork)
337    }
338}
339
340impl From<Genesis> for OpChainSpec {
341    fn from(genesis: Genesis) -> Self {
342        use reth_optimism_forks::OpHardfork;
343        let optimism_genesis_info = OpGenesisInfo::extract_from(&genesis);
344        let genesis_info =
345            optimism_genesis_info.optimism_chain_info.genesis_info.unwrap_or_default();
346
347        // Block-based hardforks
348        let hardfork_opts = [
349            (EthereumHardfork::Frontier.boxed(), Some(0)),
350            (EthereumHardfork::Homestead.boxed(), genesis.config.homestead_block),
351            (EthereumHardfork::Tangerine.boxed(), genesis.config.eip150_block),
352            (EthereumHardfork::SpuriousDragon.boxed(), genesis.config.eip155_block),
353            (EthereumHardfork::Byzantium.boxed(), genesis.config.byzantium_block),
354            (EthereumHardfork::Constantinople.boxed(), genesis.config.constantinople_block),
355            (EthereumHardfork::Petersburg.boxed(), genesis.config.petersburg_block),
356            (EthereumHardfork::Istanbul.boxed(), genesis.config.istanbul_block),
357            (EthereumHardfork::MuirGlacier.boxed(), genesis.config.muir_glacier_block),
358            (EthereumHardfork::Berlin.boxed(), genesis.config.berlin_block),
359            (EthereumHardfork::London.boxed(), genesis.config.london_block),
360            (EthereumHardfork::ArrowGlacier.boxed(), genesis.config.arrow_glacier_block),
361            (EthereumHardfork::GrayGlacier.boxed(), genesis.config.gray_glacier_block),
362            (OpHardfork::Bedrock.boxed(), genesis_info.bedrock_block),
363        ];
364        let mut block_hardforks = hardfork_opts
365            .into_iter()
366            .filter_map(|(hardfork, opt)| opt.map(|block| (hardfork, ForkCondition::Block(block))))
367            .collect::<Vec<_>>();
368
369        // We set the paris hardfork for OP networks to zero
370        block_hardforks.push((
371            EthereumHardfork::Paris.boxed(),
372            ForkCondition::TTD {
373                activation_block_number: 0,
374                total_difficulty: U256::ZERO,
375                fork_block: genesis.config.merge_netsplit_block,
376            },
377        ));
378
379        // Time-based hardforks
380        let time_hardfork_opts = [
381            // L1
382            // we need to map the L1 hardforks to the activation timestamps of the correspondong op
383            // hardforks
384            (EthereumHardfork::Shanghai.boxed(), genesis_info.canyon_time),
385            (EthereumHardfork::Cancun.boxed(), genesis_info.ecotone_time),
386            (EthereumHardfork::Prague.boxed(), genesis_info.isthmus_time),
387            // OP
388            (OpHardfork::Regolith.boxed(), genesis_info.regolith_time),
389            (OpHardfork::Canyon.boxed(), genesis_info.canyon_time),
390            (OpHardfork::Ecotone.boxed(), genesis_info.ecotone_time),
391            (OpHardfork::Fjord.boxed(), genesis_info.fjord_time),
392            (OpHardfork::Granite.boxed(), genesis_info.granite_time),
393            (OpHardfork::Holocene.boxed(), genesis_info.holocene_time),
394            (OpHardfork::Isthmus.boxed(), genesis_info.isthmus_time),
395            (OpHardfork::Jovian.boxed(), genesis_info.jovian_time),
396            (OpHardfork::Interop.boxed(), genesis_info.interop_time),
397        ];
398
399        let mut time_hardforks = time_hardfork_opts
400            .into_iter()
401            .filter_map(|(hardfork, opt)| {
402                opt.map(|time| (hardfork, ForkCondition::Timestamp(time)))
403            })
404            .collect::<Vec<_>>();
405
406        block_hardforks.append(&mut time_hardforks);
407
408        // Ordered Hardforks
409        let mainnet_hardforks = OP_MAINNET_HARDFORKS.clone();
410        let mainnet_order = mainnet_hardforks.forks_iter();
411
412        let mut ordered_hardforks = Vec::with_capacity(block_hardforks.len());
413        for (hardfork, _) in mainnet_order {
414            if let Some(pos) = block_hardforks.iter().position(|(e, _)| **e == *hardfork) {
415                ordered_hardforks.push(block_hardforks.remove(pos));
416            }
417        }
418
419        // append the remaining unknown hardforks to ensure we don't filter any out
420        ordered_hardforks.append(&mut block_hardforks);
421
422        let hardforks = ChainHardforks::new(ordered_hardforks);
423        let genesis_header = SealedHeader::seal_slow(make_op_genesis_header(&genesis, &hardforks));
424
425        Self {
426            inner: ChainSpec {
427                chain: genesis.config.chain_id.into(),
428                genesis_header,
429                genesis,
430                hardforks,
431                // We assume no OP network merges, and set the paris block and total difficulty to
432                // zero
433                paris_block_and_final_difficulty: Some((0, U256::ZERO)),
434                base_fee_params: optimism_genesis_info.base_fee_params,
435                ..Default::default()
436            },
437        }
438    }
439}
440
441impl From<ChainSpec> for OpChainSpec {
442    fn from(value: ChainSpec) -> Self {
443        Self { inner: value }
444    }
445}
446
447#[derive(Default, Debug)]
448struct OpGenesisInfo {
449    optimism_chain_info: op_alloy_rpc_types::OpChainInfo,
450    base_fee_params: BaseFeeParamsKind,
451}
452
453impl OpGenesisInfo {
454    fn extract_from(genesis: &Genesis) -> Self {
455        let mut info = Self {
456            optimism_chain_info: op_alloy_rpc_types::OpChainInfo::extract_from(
457                &genesis.config.extra_fields,
458            )
459            .unwrap_or_default(),
460            ..Default::default()
461        };
462        if let Some(optimism_base_fee_info) = &info.optimism_chain_info.base_fee_info &&
463            let (Some(elasticity), Some(denominator)) = (
464                optimism_base_fee_info.eip1559_elasticity,
465                optimism_base_fee_info.eip1559_denominator,
466            )
467        {
468            let base_fee_params = if let Some(canyon_denominator) =
469                optimism_base_fee_info.eip1559_denominator_canyon
470            {
471                BaseFeeParamsKind::Variable(
472                    vec![
473                        (
474                            EthereumHardfork::London.boxed(),
475                            BaseFeeParams::new(denominator as u128, elasticity as u128),
476                        ),
477                        (
478                            OpHardfork::Canyon.boxed(),
479                            BaseFeeParams::new(canyon_denominator as u128, elasticity as u128),
480                        ),
481                    ]
482                    .into(),
483                )
484            } else {
485                BaseFeeParams::new(denominator as u128, elasticity as u128).into()
486            };
487
488            info.base_fee_params = base_fee_params;
489        }
490
491        info
492    }
493}
494
495/// Helper method building a [`Header`] given [`Genesis`] and [`ChainHardforks`].
496pub fn make_op_genesis_header(genesis: &Genesis, hardforks: &ChainHardforks) -> Header {
497    let mut header = reth_chainspec::make_genesis_header(genesis, hardforks);
498
499    // If Isthmus is active, overwrite the withdrawals root with the storage root of predeploy
500    // `L2ToL1MessagePasser.sol`
501    if hardforks.fork(OpHardfork::Isthmus).active_at_timestamp(header.timestamp) &&
502        let Some(predeploy) = genesis.alloc.get(&ADDRESS_L2_TO_L1_MESSAGE_PASSER) &&
503        let Some(storage) = &predeploy.storage
504    {
505        header.withdrawals_root =
506            Some(storage_root_unhashed(storage.iter().filter_map(|(k, v)| {
507                if v.is_zero() {
508                    None
509                } else {
510                    Some((*k, (*v).into()))
511                }
512            })));
513    }
514
515    header
516}
517
518#[cfg(test)]
519mod tests {
520    use alloc::string::String;
521    use alloy_genesis::{ChainConfig, Genesis};
522    use alloy_primitives::b256;
523    use reth_chainspec::{test_fork_ids, BaseFeeParams, BaseFeeParamsKind};
524    use reth_ethereum_forks::{EthereumHardfork, ForkCondition, ForkHash, ForkId, Head};
525    use reth_optimism_forks::{OpHardfork, OpHardforks};
526
527    use crate::*;
528
529    #[test]
530    fn test_storage_root_consistency() {
531        use alloy_primitives::{B256, U256};
532        use std::str::FromStr;
533
534        let k1 =
535            B256::from_str("0x0000000000000000000000000000000000000000000000000000000000000001")
536                .unwrap();
537        let v1 =
538            U256::from_str("0x0000000000000000000000000000000000000000000000000000000000000000")
539                .unwrap();
540        let k2 =
541            B256::from_str("0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc")
542                .unwrap();
543        let v2 =
544            U256::from_str("0x000000000000000000000000c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d3c0d30016")
545                .unwrap();
546        let k3 =
547            B256::from_str("0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103")
548                .unwrap();
549        let v3 =
550            U256::from_str("0x0000000000000000000000004200000000000000000000000000000000000018")
551                .unwrap();
552        let origin_root =
553            B256::from_str("0x5d5ba3a8093ede3901ad7a569edfb7b9aecafa54730ba0bf069147cbcc00e345")
554                .unwrap();
555        let expected_root =
556            B256::from_str("0x8ed4baae3a927be3dea54996b4d5899f8c01e7594bf50b17dc1e741388ce3d12")
557                .unwrap();
558
559        let storage_origin = vec![(k1, v1), (k2, v2), (k3, v3)];
560        let storage_fix = vec![(k2, v2), (k3, v3)];
561        let root_origin = storage_root_unhashed(storage_origin);
562        let root_fix = storage_root_unhashed(storage_fix);
563        assert_ne!(root_origin, root_fix);
564        assert_eq!(root_origin, origin_root);
565        assert_eq!(root_fix, expected_root);
566    }
567
568    #[test]
569    fn base_mainnet_forkids() {
570        let mut base_mainnet = OpChainSpecBuilder::base_mainnet().build();
571        base_mainnet.inner.genesis_header.set_hash(BASE_MAINNET.genesis_hash());
572        test_fork_ids(
573            &BASE_MAINNET,
574            &[
575                (
576                    Head { number: 0, ..Default::default() },
577                    ForkId { hash: ForkHash([0x67, 0xda, 0x02, 0x60]), next: 1704992401 },
578                ),
579                (
580                    Head { number: 0, timestamp: 1704992400, ..Default::default() },
581                    ForkId { hash: ForkHash([0x67, 0xda, 0x02, 0x60]), next: 1704992401 },
582                ),
583                (
584                    Head { number: 0, timestamp: 1704992401, ..Default::default() },
585                    ForkId { hash: ForkHash([0x3c, 0x28, 0x3c, 0xb3]), next: 1710374401 },
586                ),
587                (
588                    Head { number: 0, timestamp: 1710374400, ..Default::default() },
589                    ForkId { hash: ForkHash([0x3c, 0x28, 0x3c, 0xb3]), next: 1710374401 },
590                ),
591                (
592                    Head { number: 0, timestamp: 1710374401, ..Default::default() },
593                    ForkId { hash: ForkHash([0x51, 0xcc, 0x98, 0xb3]), next: 1720627201 },
594                ),
595                (
596                    Head { number: 0, timestamp: 1720627200, ..Default::default() },
597                    ForkId { hash: ForkHash([0x51, 0xcc, 0x98, 0xb3]), next: 1720627201 },
598                ),
599                (
600                    Head { number: 0, timestamp: 1720627201, ..Default::default() },
601                    ForkId { hash: ForkHash([0xe4, 0x01, 0x0e, 0xb9]), next: 1726070401 },
602                ),
603                (
604                    Head { number: 0, timestamp: 1726070401, ..Default::default() },
605                    ForkId { hash: ForkHash([0xbc, 0x38, 0xf9, 0xca]), next: 1736445601 },
606                ),
607                (
608                    Head { number: 0, timestamp: 1736445601, ..Default::default() },
609                    ForkId { hash: ForkHash([0x3a, 0x2a, 0xf1, 0x83]), next: 1746806401 },
610                ),
611                // Isthmus
612                (
613                    Head { number: 0, timestamp: 1746806401, ..Default::default() },
614                    ForkId { hash: ForkHash([0x86, 0x72, 0x8b, 0x4e]), next: 0 }, /* TODO: update timestamp when Jovian is planned */
615                ),
616                // // Jovian
617                // (
618                //     Head { number: 0, timestamp: u64::MAX, ..Default::default() }, /* TODO:
619                // update timestamp when Jovian is planned */     ForkId { hash:
620                // ForkHash([0xef, 0x0e, 0x58, 0x33]), next: 0 }, ),
621            ],
622        );
623    }
624
625    #[test]
626    fn op_sepolia_forkids() {
627        test_fork_ids(
628            &OP_SEPOLIA,
629            &[
630                (
631                    Head { number: 0, ..Default::default() },
632                    ForkId { hash: ForkHash([0x67, 0xa4, 0x03, 0x28]), next: 1699981200 },
633                ),
634                (
635                    Head { number: 0, timestamp: 1699981199, ..Default::default() },
636                    ForkId { hash: ForkHash([0x67, 0xa4, 0x03, 0x28]), next: 1699981200 },
637                ),
638                (
639                    Head { number: 0, timestamp: 1699981200, ..Default::default() },
640                    ForkId { hash: ForkHash([0xa4, 0x8d, 0x6a, 0x00]), next: 1708534800 },
641                ),
642                (
643                    Head { number: 0, timestamp: 1708534799, ..Default::default() },
644                    ForkId { hash: ForkHash([0xa4, 0x8d, 0x6a, 0x00]), next: 1708534800 },
645                ),
646                (
647                    Head { number: 0, timestamp: 1708534800, ..Default::default() },
648                    ForkId { hash: ForkHash([0xcc, 0x17, 0xc7, 0xeb]), next: 1716998400 },
649                ),
650                (
651                    Head { number: 0, timestamp: 1716998399, ..Default::default() },
652                    ForkId { hash: ForkHash([0xcc, 0x17, 0xc7, 0xeb]), next: 1716998400 },
653                ),
654                (
655                    Head { number: 0, timestamp: 1716998400, ..Default::default() },
656                    ForkId { hash: ForkHash([0x54, 0x0a, 0x8c, 0x5d]), next: 1723478400 },
657                ),
658                (
659                    Head { number: 0, timestamp: 1723478399, ..Default::default() },
660                    ForkId { hash: ForkHash([0x54, 0x0a, 0x8c, 0x5d]), next: 1723478400 },
661                ),
662                (
663                    Head { number: 0, timestamp: 1723478400, ..Default::default() },
664                    ForkId { hash: ForkHash([0x75, 0xde, 0xa4, 0x1e]), next: 1732633200 },
665                ),
666                (
667                    Head { number: 0, timestamp: 1732633200, ..Default::default() },
668                    ForkId { hash: ForkHash([0x4a, 0x1c, 0x79, 0x2e]), next: 1744905600 },
669                ),
670                // Isthmus
671                (
672                    Head { number: 0, timestamp: 1744905600, ..Default::default() },
673                    ForkId { hash: ForkHash([0x6c, 0x62, 0x5e, 0xe1]), next: 0 }, /* TODO: update timestamp when Jovian is planned */
674                ),
675                // // Jovian
676                // (
677                //     Head { number: 0, timestamp: u64::MAX, ..Default::default() }, /* TODO:
678                // update timestamp when Jovian is planned */     ForkId { hash:
679                // ForkHash([0x04, 0x2a, 0x5c, 0x14]), next: 0 }, ),
680            ],
681        );
682    }
683
684    #[test]
685    fn op_mainnet_forkids() {
686        let mut op_mainnet = OpChainSpecBuilder::optimism_mainnet().build();
687        // for OP mainnet we have to do this because the genesis header can't be properly computed
688        // from the genesis.json file
689        op_mainnet.inner.genesis_header.set_hash(OP_MAINNET.genesis_hash());
690        test_fork_ids(
691            &op_mainnet,
692            &[
693                (
694                    Head { number: 0, ..Default::default() },
695                    ForkId { hash: ForkHash([0xca, 0xf5, 0x17, 0xed]), next: 3950000 },
696                ),
697                // London
698                (
699                    Head { number: 105235063, ..Default::default() },
700                    ForkId { hash: ForkHash([0xe3, 0x39, 0x8d, 0x7c]), next: 1704992401 },
701                ),
702                // Bedrock
703                (
704                    Head { number: 105235063, ..Default::default() },
705                    ForkId { hash: ForkHash([0xe3, 0x39, 0x8d, 0x7c]), next: 1704992401 },
706                ),
707                // Shanghai
708                (
709                    Head { number: 105235063, timestamp: 1704992401, ..Default::default() },
710                    ForkId { hash: ForkHash([0xbd, 0xd4, 0xfd, 0xb2]), next: 1710374401 },
711                ),
712                // OP activation timestamps
713                // https://specs.optimism.io/protocol/superchain-upgrades.html#activation-timestamps
714                // Canyon
715                (
716                    Head { number: 105235063, timestamp: 1704992401, ..Default::default() },
717                    ForkId { hash: ForkHash([0xbd, 0xd4, 0xfd, 0xb2]), next: 1710374401 },
718                ),
719                // Ecotone
720                (
721                    Head { number: 105235063, timestamp: 1710374401, ..Default::default() },
722                    ForkId { hash: ForkHash([0x19, 0xda, 0x4c, 0x52]), next: 1720627201 },
723                ),
724                // Fjord
725                (
726                    Head { number: 105235063, timestamp: 1720627201, ..Default::default() },
727                    ForkId { hash: ForkHash([0x49, 0xfb, 0xfe, 0x1e]), next: 1726070401 },
728                ),
729                // Granite
730                (
731                    Head { number: 105235063, timestamp: 1726070401, ..Default::default() },
732                    ForkId { hash: ForkHash([0x44, 0x70, 0x4c, 0xde]), next: 1736445601 },
733                ),
734                // Holocene
735                (
736                    Head { number: 105235063, timestamp: 1736445601, ..Default::default() },
737                    ForkId { hash: ForkHash([0x2b, 0xd9, 0x3d, 0xc8]), next: 1746806401 },
738                ),
739                // Isthmus
740                (
741                    Head { number: 105235063, timestamp: 1746806401, ..Default::default() },
742                    ForkId { hash: ForkHash([0x37, 0xbe, 0x75, 0x8f]), next: 0 }, /* TODO: update timestamp when Jovian is planned */
743                ),
744                // Jovian
745                // (
746                //     Head { number: 105235063, timestamp: u64::MAX, ..Default::default() }, /*
747                // TODO: update timestamp when Jovian is planned */     ForkId {
748                // hash: ForkHash([0x26, 0xce, 0xa1, 0x75]), next: 0 }, ),
749            ],
750        );
751    }
752
753    #[test]
754    fn base_sepolia_forkids() {
755        test_fork_ids(
756            &BASE_SEPOLIA,
757            &[
758                (
759                    Head { number: 0, ..Default::default() },
760                    ForkId { hash: ForkHash([0xb9, 0x59, 0xb9, 0xf7]), next: 1699981200 },
761                ),
762                (
763                    Head { number: 0, timestamp: 1699981199, ..Default::default() },
764                    ForkId { hash: ForkHash([0xb9, 0x59, 0xb9, 0xf7]), next: 1699981200 },
765                ),
766                (
767                    Head { number: 0, timestamp: 1699981200, ..Default::default() },
768                    ForkId { hash: ForkHash([0x60, 0x7c, 0xd5, 0xa1]), next: 1708534800 },
769                ),
770                (
771                    Head { number: 0, timestamp: 1708534799, ..Default::default() },
772                    ForkId { hash: ForkHash([0x60, 0x7c, 0xd5, 0xa1]), next: 1708534800 },
773                ),
774                (
775                    Head { number: 0, timestamp: 1708534800, ..Default::default() },
776                    ForkId { hash: ForkHash([0xbe, 0x96, 0x9b, 0x17]), next: 1716998400 },
777                ),
778                (
779                    Head { number: 0, timestamp: 1716998399, ..Default::default() },
780                    ForkId { hash: ForkHash([0xbe, 0x96, 0x9b, 0x17]), next: 1716998400 },
781                ),
782                (
783                    Head { number: 0, timestamp: 1716998400, ..Default::default() },
784                    ForkId { hash: ForkHash([0x4e, 0x45, 0x7a, 0x49]), next: 1723478400 },
785                ),
786                (
787                    Head { number: 0, timestamp: 1723478399, ..Default::default() },
788                    ForkId { hash: ForkHash([0x4e, 0x45, 0x7a, 0x49]), next: 1723478400 },
789                ),
790                (
791                    Head { number: 0, timestamp: 1723478400, ..Default::default() },
792                    ForkId { hash: ForkHash([0x5e, 0xdf, 0xa3, 0xb6]), next: 1732633200 },
793                ),
794                (
795                    Head { number: 0, timestamp: 1732633200, ..Default::default() },
796                    ForkId { hash: ForkHash([0x8b, 0x5e, 0x76, 0x29]), next: 1744905600 },
797                ),
798                // Isthmus
799                (
800                    Head { number: 0, timestamp: 1744905600, ..Default::default() },
801                    ForkId { hash: ForkHash([0x06, 0x0a, 0x4d, 0x1d]), next: 0 }, /* TODO: update timestamp when Jovian is planned */
802                ),
803                // // Jovian
804                // (
805                //     Head { number: 0, timestamp: u64::MAX, ..Default::default() }, /* TODO:
806                // update timestamp when Jovian is planned */     ForkId { hash:
807                // ForkHash([0xcd, 0xfd, 0x39, 0x99]), next: 0 }, ),
808            ],
809        );
810    }
811
812    #[test]
813    fn base_mainnet_genesis() {
814        let genesis = BASE_MAINNET.genesis_header();
815        assert_eq!(
816            genesis.hash_slow(),
817            b256!("0xf712aa9241cc24369b143cf6dce85f0902a9731e70d66818a3a5845b296c73dd")
818        );
819        let base_fee = BASE_MAINNET.next_block_base_fee(genesis, genesis.timestamp).unwrap();
820        // <https://base.blockscout.com/block/1>
821        assert_eq!(base_fee, 980000000);
822    }
823
824    #[test]
825    fn base_sepolia_genesis() {
826        let genesis = BASE_SEPOLIA.genesis_header();
827        assert_eq!(
828            genesis.hash_slow(),
829            b256!("0x0dcc9e089e30b90ddfc55be9a37dd15bc551aeee999d2e2b51414c54eaf934e4")
830        );
831        let base_fee = BASE_SEPOLIA.next_block_base_fee(genesis, genesis.timestamp).unwrap();
832        // <https://base-sepolia.blockscout.com/block/1>
833        assert_eq!(base_fee, 980000000);
834    }
835
836    #[test]
837    fn op_sepolia_genesis() {
838        let genesis = OP_SEPOLIA.genesis_header();
839        assert_eq!(
840            genesis.hash_slow(),
841            b256!("0x102de6ffb001480cc9b8b548fd05c34cd4f46ae4aa91759393db90ea0409887d")
842        );
843        let base_fee = OP_SEPOLIA.next_block_base_fee(genesis, genesis.timestamp).unwrap();
844        // <https://optimism-sepolia.blockscout.com/block/1>
845        assert_eq!(base_fee, 980000000);
846    }
847
848    #[test]
849    fn latest_base_mainnet_fork_id() {
850        assert_eq!(
851            ForkId { hash: ForkHash([0x86, 0x72, 0x8b, 0x4e]), next: 0 },
852            BASE_MAINNET.latest_fork_id()
853        )
854    }
855
856    #[test]
857    fn latest_base_mainnet_fork_id_with_builder() {
858        let base_mainnet = OpChainSpecBuilder::base_mainnet().build();
859        assert_eq!(
860            ForkId { hash: ForkHash([0x86, 0x72, 0x8b, 0x4e]), next: 0 },
861            base_mainnet.latest_fork_id()
862        )
863    }
864
865    #[test]
866    fn is_bedrock_active() {
867        let op_mainnet = OpChainSpecBuilder::optimism_mainnet().build();
868        assert!(!op_mainnet.is_bedrock_active_at_block(1))
869    }
870
871    #[test]
872    fn parse_optimism_hardforks() {
873        let geth_genesis = r#"
874    {
875      "config": {
876        "bedrockBlock": 10,
877        "regolithTime": 20,
878        "canyonTime": 30,
879        "ecotoneTime": 40,
880        "fjordTime": 50,
881        "graniteTime": 51,
882        "holoceneTime": 52,
883        "isthmusTime": 53,
884        "optimism": {
885          "eip1559Elasticity": 60,
886          "eip1559Denominator": 70
887        }
888      }
889    }
890    "#;
891        let genesis: Genesis = serde_json::from_str(geth_genesis).unwrap();
892
893        let actual_bedrock_block = genesis.config.extra_fields.get("bedrockBlock");
894        assert_eq!(actual_bedrock_block, Some(serde_json::Value::from(10)).as_ref());
895        let actual_regolith_timestamp = genesis.config.extra_fields.get("regolithTime");
896        assert_eq!(actual_regolith_timestamp, Some(serde_json::Value::from(20)).as_ref());
897        let actual_canyon_timestamp = genesis.config.extra_fields.get("canyonTime");
898        assert_eq!(actual_canyon_timestamp, Some(serde_json::Value::from(30)).as_ref());
899        let actual_ecotone_timestamp = genesis.config.extra_fields.get("ecotoneTime");
900        assert_eq!(actual_ecotone_timestamp, Some(serde_json::Value::from(40)).as_ref());
901        let actual_fjord_timestamp = genesis.config.extra_fields.get("fjordTime");
902        assert_eq!(actual_fjord_timestamp, Some(serde_json::Value::from(50)).as_ref());
903        let actual_granite_timestamp = genesis.config.extra_fields.get("graniteTime");
904        assert_eq!(actual_granite_timestamp, Some(serde_json::Value::from(51)).as_ref());
905        let actual_holocene_timestamp = genesis.config.extra_fields.get("holoceneTime");
906        assert_eq!(actual_holocene_timestamp, Some(serde_json::Value::from(52)).as_ref());
907        let actual_isthmus_timestamp = genesis.config.extra_fields.get("isthmusTime");
908        assert_eq!(actual_isthmus_timestamp, Some(serde_json::Value::from(53)).as_ref());
909
910        let optimism_object = genesis.config.extra_fields.get("optimism").unwrap();
911        assert_eq!(
912            optimism_object,
913            &serde_json::json!({
914                "eip1559Elasticity": 60,
915                "eip1559Denominator": 70,
916            })
917        );
918
919        let chain_spec: OpChainSpec = genesis.into();
920
921        assert_eq!(
922            chain_spec.base_fee_params,
923            BaseFeeParamsKind::Constant(BaseFeeParams::new(70, 60))
924        );
925
926        assert!(!chain_spec.is_fork_active_at_block(OpHardfork::Bedrock, 0));
927        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Regolith, 0));
928        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Canyon, 0));
929        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Ecotone, 0));
930        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Fjord, 0));
931        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Granite, 0));
932        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Holocene, 0));
933
934        assert!(chain_spec.is_fork_active_at_block(OpHardfork::Bedrock, 10));
935        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Regolith, 20));
936        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Canyon, 30));
937        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Ecotone, 40));
938        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Fjord, 50));
939        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Granite, 51));
940        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Holocene, 52));
941    }
942
943    #[test]
944    fn parse_optimism_hardforks_variable_base_fee_params() {
945        let geth_genesis = r#"
946    {
947      "config": {
948        "bedrockBlock": 10,
949        "regolithTime": 20,
950        "canyonTime": 30,
951        "ecotoneTime": 40,
952        "fjordTime": 50,
953        "graniteTime": 51,
954        "holoceneTime": 52,
955        "isthmusTime": 53,
956        "optimism": {
957          "eip1559Elasticity": 60,
958          "eip1559Denominator": 70,
959          "eip1559DenominatorCanyon": 80
960        }
961      }
962    }
963    "#;
964        let genesis: Genesis = serde_json::from_str(geth_genesis).unwrap();
965
966        let actual_bedrock_block = genesis.config.extra_fields.get("bedrockBlock");
967        assert_eq!(actual_bedrock_block, Some(serde_json::Value::from(10)).as_ref());
968        let actual_regolith_timestamp = genesis.config.extra_fields.get("regolithTime");
969        assert_eq!(actual_regolith_timestamp, Some(serde_json::Value::from(20)).as_ref());
970        let actual_canyon_timestamp = genesis.config.extra_fields.get("canyonTime");
971        assert_eq!(actual_canyon_timestamp, Some(serde_json::Value::from(30)).as_ref());
972        let actual_ecotone_timestamp = genesis.config.extra_fields.get("ecotoneTime");
973        assert_eq!(actual_ecotone_timestamp, Some(serde_json::Value::from(40)).as_ref());
974        let actual_fjord_timestamp = genesis.config.extra_fields.get("fjordTime");
975        assert_eq!(actual_fjord_timestamp, Some(serde_json::Value::from(50)).as_ref());
976        let actual_granite_timestamp = genesis.config.extra_fields.get("graniteTime");
977        assert_eq!(actual_granite_timestamp, Some(serde_json::Value::from(51)).as_ref());
978        let actual_holocene_timestamp = genesis.config.extra_fields.get("holoceneTime");
979        assert_eq!(actual_holocene_timestamp, Some(serde_json::Value::from(52)).as_ref());
980        let actual_isthmus_timestamp = genesis.config.extra_fields.get("isthmusTime");
981        assert_eq!(actual_isthmus_timestamp, Some(serde_json::Value::from(53)).as_ref());
982
983        let optimism_object = genesis.config.extra_fields.get("optimism").unwrap();
984        assert_eq!(
985            optimism_object,
986            &serde_json::json!({
987                "eip1559Elasticity": 60,
988                "eip1559Denominator": 70,
989                "eip1559DenominatorCanyon": 80
990            })
991        );
992
993        let chain_spec: OpChainSpec = genesis.into();
994
995        assert_eq!(
996            chain_spec.base_fee_params,
997            BaseFeeParamsKind::Variable(
998                vec![
999                    (EthereumHardfork::London.boxed(), BaseFeeParams::new(70, 60)),
1000                    (OpHardfork::Canyon.boxed(), BaseFeeParams::new(80, 60)),
1001                ]
1002                .into()
1003            )
1004        );
1005
1006        assert!(!chain_spec.is_fork_active_at_block(OpHardfork::Bedrock, 0));
1007        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Regolith, 0));
1008        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Canyon, 0));
1009        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Ecotone, 0));
1010        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Fjord, 0));
1011        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Granite, 0));
1012        assert!(!chain_spec.is_fork_active_at_timestamp(OpHardfork::Holocene, 0));
1013
1014        assert!(chain_spec.is_fork_active_at_block(OpHardfork::Bedrock, 10));
1015        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Regolith, 20));
1016        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Canyon, 30));
1017        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Ecotone, 40));
1018        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Fjord, 50));
1019        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Granite, 51));
1020        assert!(chain_spec.is_fork_active_at_timestamp(OpHardfork::Holocene, 52));
1021    }
1022
1023    #[test]
1024    fn parse_genesis_optimism_with_variable_base_fee_params() {
1025        use op_alloy_rpc_types::OpBaseFeeInfo;
1026
1027        let geth_genesis = r#"
1028    {
1029      "config": {
1030        "chainId": 8453,
1031        "homesteadBlock": 0,
1032        "eip150Block": 0,
1033        "eip155Block": 0,
1034        "eip158Block": 0,
1035        "byzantiumBlock": 0,
1036        "constantinopleBlock": 0,
1037        "petersburgBlock": 0,
1038        "istanbulBlock": 0,
1039        "muirGlacierBlock": 0,
1040        "berlinBlock": 0,
1041        "londonBlock": 0,
1042        "arrowGlacierBlock": 0,
1043        "grayGlacierBlock": 0,
1044        "mergeNetsplitBlock": 0,
1045        "bedrockBlock": 0,
1046        "regolithTime": 15,
1047        "terminalTotalDifficulty": 0,
1048        "terminalTotalDifficultyPassed": true,
1049        "optimism": {
1050          "eip1559Elasticity": 6,
1051          "eip1559Denominator": 50
1052        }
1053      }
1054    }
1055    "#;
1056        let genesis: Genesis = serde_json::from_str(geth_genesis).unwrap();
1057        let chainspec = OpChainSpec::from(genesis.clone());
1058
1059        let actual_chain_id = genesis.config.chain_id;
1060        assert_eq!(actual_chain_id, 8453);
1061
1062        assert_eq!(
1063            chainspec.hardforks.get(EthereumHardfork::Istanbul),
1064            Some(ForkCondition::Block(0))
1065        );
1066
1067        let actual_bedrock_block = genesis.config.extra_fields.get("bedrockBlock");
1068        assert_eq!(actual_bedrock_block, Some(serde_json::Value::from(0)).as_ref());
1069        let actual_canyon_timestamp = genesis.config.extra_fields.get("canyonTime");
1070        assert_eq!(actual_canyon_timestamp, None);
1071
1072        assert!(genesis.config.terminal_total_difficulty_passed);
1073
1074        let optimism_object = genesis.config.extra_fields.get("optimism").unwrap();
1075        let optimism_base_fee_info =
1076            serde_json::from_value::<OpBaseFeeInfo>(optimism_object.clone()).unwrap();
1077
1078        assert_eq!(
1079            optimism_base_fee_info,
1080            OpBaseFeeInfo {
1081                eip1559_elasticity: Some(6),
1082                eip1559_denominator: Some(50),
1083                eip1559_denominator_canyon: None,
1084            }
1085        );
1086        assert_eq!(
1087            chainspec.base_fee_params,
1088            BaseFeeParamsKind::Constant(BaseFeeParams {
1089                max_change_denominator: 50,
1090                elasticity_multiplier: 6,
1091            })
1092        );
1093
1094        assert!(chainspec.is_fork_active_at_block(OpHardfork::Bedrock, 0));
1095
1096        assert!(chainspec.is_fork_active_at_timestamp(OpHardfork::Regolith, 20));
1097    }
1098
1099    #[test]
1100    fn test_fork_order_optimism_mainnet() {
1101        use reth_optimism_forks::OpHardfork;
1102
1103        let genesis = Genesis {
1104            config: ChainConfig {
1105                chain_id: 0,
1106                homestead_block: Some(0),
1107                dao_fork_block: Some(0),
1108                dao_fork_support: false,
1109                eip150_block: Some(0),
1110                eip155_block: Some(0),
1111                eip158_block: Some(0),
1112                byzantium_block: Some(0),
1113                constantinople_block: Some(0),
1114                petersburg_block: Some(0),
1115                istanbul_block: Some(0),
1116                muir_glacier_block: Some(0),
1117                berlin_block: Some(0),
1118                london_block: Some(0),
1119                arrow_glacier_block: Some(0),
1120                gray_glacier_block: Some(0),
1121                merge_netsplit_block: Some(0),
1122                shanghai_time: Some(0),
1123                cancun_time: Some(0),
1124                prague_time: Some(0),
1125                terminal_total_difficulty: Some(U256::ZERO),
1126                extra_fields: [
1127                    (String::from("bedrockBlock"), 0.into()),
1128                    (String::from("regolithTime"), 0.into()),
1129                    (String::from("canyonTime"), 0.into()),
1130                    (String::from("ecotoneTime"), 0.into()),
1131                    (String::from("fjordTime"), 0.into()),
1132                    (String::from("graniteTime"), 0.into()),
1133                    (String::from("holoceneTime"), 0.into()),
1134                    (String::from("isthmusTime"), 0.into()),
1135                    (String::from("jovianTime"), 0.into()),
1136                ]
1137                .into_iter()
1138                .collect(),
1139                ..Default::default()
1140            },
1141            ..Default::default()
1142        };
1143
1144        let chain_spec: OpChainSpec = genesis.into();
1145
1146        let hardforks: Vec<_> = chain_spec.hardforks.forks_iter().map(|(h, _)| h).collect();
1147        let expected_hardforks = vec![
1148            EthereumHardfork::Frontier.boxed(),
1149            EthereumHardfork::Homestead.boxed(),
1150            EthereumHardfork::Tangerine.boxed(),
1151            EthereumHardfork::SpuriousDragon.boxed(),
1152            EthereumHardfork::Byzantium.boxed(),
1153            EthereumHardfork::Constantinople.boxed(),
1154            EthereumHardfork::Petersburg.boxed(),
1155            EthereumHardfork::Istanbul.boxed(),
1156            EthereumHardfork::MuirGlacier.boxed(),
1157            EthereumHardfork::Berlin.boxed(),
1158            EthereumHardfork::London.boxed(),
1159            EthereumHardfork::ArrowGlacier.boxed(),
1160            EthereumHardfork::GrayGlacier.boxed(),
1161            EthereumHardfork::Paris.boxed(),
1162            OpHardfork::Bedrock.boxed(),
1163            OpHardfork::Regolith.boxed(),
1164            EthereumHardfork::Shanghai.boxed(),
1165            OpHardfork::Canyon.boxed(),
1166            EthereumHardfork::Cancun.boxed(),
1167            OpHardfork::Ecotone.boxed(),
1168            OpHardfork::Fjord.boxed(),
1169            OpHardfork::Granite.boxed(),
1170            OpHardfork::Holocene.boxed(),
1171            EthereumHardfork::Prague.boxed(),
1172            OpHardfork::Isthmus.boxed(),
1173            OpHardfork::Jovian.boxed(),
1174            // OpHardfork::Interop.boxed(),
1175        ];
1176
1177        for (expected, actual) in expected_hardforks.iter().zip(hardforks.iter()) {
1178            assert_eq!(&**expected, &**actual);
1179        }
1180        assert_eq!(expected_hardforks.len(), hardforks.len());
1181    }
1182
1183    #[test]
1184    fn json_genesis() {
1185        let geth_genesis = r#"
1186{
1187    "config": {
1188        "chainId": 1301,
1189        "homesteadBlock": 0,
1190        "eip150Block": 0,
1191        "eip155Block": 0,
1192        "eip158Block": 0,
1193        "byzantiumBlock": 0,
1194        "constantinopleBlock": 0,
1195        "petersburgBlock": 0,
1196        "istanbulBlock": 0,
1197        "muirGlacierBlock": 0,
1198        "berlinBlock": 0,
1199        "londonBlock": 0,
1200        "arrowGlacierBlock": 0,
1201        "grayGlacierBlock": 0,
1202        "mergeNetsplitBlock": 0,
1203        "shanghaiTime": 0,
1204        "cancunTime": 0,
1205        "bedrockBlock": 0,
1206        "regolithTime": 0,
1207        "canyonTime": 0,
1208        "ecotoneTime": 0,
1209        "fjordTime": 0,
1210        "graniteTime": 0,
1211        "holoceneTime": 1732633200,
1212        "terminalTotalDifficulty": 0,
1213        "terminalTotalDifficultyPassed": true,
1214        "optimism": {
1215            "eip1559Elasticity": 6,
1216            "eip1559Denominator": 50,
1217            "eip1559DenominatorCanyon": 250
1218        }
1219    },
1220    "nonce": "0x0",
1221    "timestamp": "0x66edad4c",
1222    "extraData": "0x424544524f434b",
1223    "gasLimit": "0x1c9c380",
1224    "difficulty": "0x0",
1225    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
1226    "coinbase": "0x4200000000000000000000000000000000000011",
1227    "alloc": {},
1228    "number": "0x0",
1229    "gasUsed": "0x0",
1230    "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
1231    "baseFeePerGas": "0x3b9aca00",
1232    "excessBlobGas": "0x0",
1233    "blobGasUsed": "0x0"
1234}
1235        "#;
1236
1237        let genesis: Genesis = serde_json::from_str(geth_genesis).unwrap();
1238        let chainspec = OpChainSpec::from_genesis(genesis);
1239        assert!(chainspec.is_holocene_active_at_timestamp(1732633200));
1240    }
1241
1242    #[test]
1243    fn json_genesis_mapped_l1_timestamps() {
1244        let geth_genesis = r#"
1245{
1246    "config": {
1247        "chainId": 1301,
1248        "homesteadBlock": 0,
1249        "eip150Block": 0,
1250        "eip155Block": 0,
1251        "eip158Block": 0,
1252        "byzantiumBlock": 0,
1253        "constantinopleBlock": 0,
1254        "petersburgBlock": 0,
1255        "istanbulBlock": 0,
1256        "muirGlacierBlock": 0,
1257        "berlinBlock": 0,
1258        "londonBlock": 0,
1259        "arrowGlacierBlock": 0,
1260        "grayGlacierBlock": 0,
1261        "mergeNetsplitBlock": 0,
1262        "bedrockBlock": 0,
1263        "regolithTime": 0,
1264        "canyonTime": 0,
1265        "ecotoneTime": 1712633200,
1266        "fjordTime": 0,
1267        "graniteTime": 0,
1268        "holoceneTime": 1732633200,
1269        "isthmusTime": 1742633200,
1270        "terminalTotalDifficulty": 0,
1271        "terminalTotalDifficultyPassed": true,
1272        "optimism": {
1273            "eip1559Elasticity": 6,
1274            "eip1559Denominator": 50,
1275            "eip1559DenominatorCanyon": 250
1276        }
1277    },
1278    "nonce": "0x0",
1279    "timestamp": "0x66edad4c",
1280    "extraData": "0x424544524f434b",
1281    "gasLimit": "0x1c9c380",
1282    "difficulty": "0x0",
1283    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
1284    "coinbase": "0x4200000000000000000000000000000000000011",
1285    "alloc": {},
1286    "number": "0x0",
1287    "gasUsed": "0x0",
1288    "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
1289    "baseFeePerGas": "0x3b9aca00",
1290    "excessBlobGas": "0x0",
1291    "blobGasUsed": "0x0"
1292}
1293        "#;
1294
1295        let genesis: Genesis = serde_json::from_str(geth_genesis).unwrap();
1296        let chainspec = OpChainSpec::from_genesis(genesis);
1297        assert!(chainspec.is_holocene_active_at_timestamp(1732633200));
1298
1299        assert!(chainspec.is_shanghai_active_at_timestamp(0));
1300        assert!(chainspec.is_canyon_active_at_timestamp(0));
1301
1302        assert!(chainspec.is_ecotone_active_at_timestamp(1712633200));
1303        assert!(chainspec.is_cancun_active_at_timestamp(1712633200));
1304
1305        assert!(chainspec.is_prague_active_at_timestamp(1742633200));
1306        assert!(chainspec.is_isthmus_active_at_timestamp(1742633200));
1307    }
1308
1309    #[test]
1310    fn display_hardorks() {
1311        let content = BASE_MAINNET.display_hardforks().to_string();
1312        for eth_hf in EthereumHardfork::VARIANTS {
1313            assert!(!content.contains(eth_hf.name()));
1314        }
1315    }
1316}