Enum BaseUpgrade 

#[non_exhaustive]
pub enum BaseUpgrade {
    Bedrock,
    Regolith,
    Canyon,
    Delta,
    Ecotone,
    Fjord,
    Granite,
    Holocene,
    PectraBlobSchedule,
    Isthmus,
    Jovian,
    Azul,
    Beryl,
    Cobalt,
    Denim,
    Zenith,
}

Available on crate feature base only.

The canonical Base network upgrade.

This single enum spans two domains:

• the execution fork ladder (BaseUpgrade::EXECUTION_VARIANTS) that maps onto the reth/revm hardfork schedule, and
• the contract-backed upgrade set (BaseUpgrade::CONTRACT_VARIANTS) that is keyed by the L1 upgrade-signal contract hardforkId strings and the genesis [UpgradeConfig] timestamp fields.

Real network upgrades are listed in chronological order. Bedrock is execution-only (block-activated, not contract-backed), while Delta and PectraBlobSchedule are contract-backed config upgrades that do not change EVM execution and therefore never enter the execution fork ladder.

Denim is the fourth Base-specific network upgrade. It is unscheduled for now, but it is a first-class upgrade: contract-backed and part of the execution fork ladder, so live chains can activate it once an activation time is configured.

Zenith is a hardfork for future experimental features. It is genesis-configurable but not contract-backed, since the L1 upgrade-signal contract does not yet recognise it.

When building a list of upgrades for a chain, it’s still expected to zip with EthereumHardfork.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Bedrock

Bedrock: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#bedrock.

Regolith

Regolith: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#regolith.

Canyon

Canyon: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#canyon.

Delta

Delta: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#delta.

Ecotone

Ecotone: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#ecotone.

Fjord

Fjord: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#fjord

Granite

Granite: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#granite

Holocene

Holocene: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/superchain-upgrades.md#holocene

PectraBlobSchedule

Pectra blob schedule: an optional fork present on Base Sepolia chains that observed the L1 Pectra network upgrade with the reference node <=v1.11.1 sequencing the network.

Isthmus

Isthmus: https://github.com/ethereum-optimism/specs/blob/main/specs/protocol/isthmus/overview.md

Jovian

Jovian: Base network upgrade.

Azul

Azul: First Base-specific network upgrade.

Beryl

Beryl: Second Base-specific network upgrade.

Cobalt

Cobalt: Third Base-specific network upgrade.

Denim

Denim: Fourth Base-specific network upgrade. Unscheduled for now.

Zenith

Zenith: hardfork for future experimental features.

Implementations

impl BaseUpgrade

pub const VARIANTS: &'static [BaseUpgrade]

All hardfork variants

pub const fn name(&self) -> &'static str

Returns variant as str.

impl BaseUpgrade

pub const LATEST: BaseUpgrade = Self::Beryl

Latest Base upgrade used by default.

pub const EXECUTION_VARIANTS: [BaseUpgrade; 13]

The execution fork ladder, in activation order.

These are the upgrades that participate in the reth/revm hardfork schedule. Excludes the contract-only Delta and PectraBlobSchedule upgrades, and Zenith, which does not yet change EVM execution.

pub const CONTRACT_VARIANTS: [BaseUpgrade; 14]

The contract-backed upgrade set, in activation order.

These are the upgrades addressable by the L1 upgrade-signal contract and stored in the genesis [UpgradeConfig]. Excludes block-activated Bedrock and Zenith, which is activated via genesis config only until the L1 upgrade-signal contract is updated to recognise it.

Order is load-bearing: map_schedule and ScheduleId::pin attribute onchain schedule entries to hardforks by position, and the ProtocolVersions contract keys upgrades by ascending append-only registration id with names kept offchain. This order MUST match the contract’s registration order — reordering silently misattributes every activation timestamp. Only ever append.

pub const fn is_execution(self) -> bool

Returns true if this upgrade participates in the execution fork ladder.

pub const fn is_contract_backed(self) -> bool

Returns true if this upgrade is contract-backed (i.e. signaled by the L1 upgrade-signal contract and stored in [UpgradeConfig]). False for block-activated Bedrock and for Zenith, which is activated via genesis config only until the L1 upgrade-signal contract is updated.

pub const fn execution_idx(self) -> Option<usize>

Returns this upgrade’s index within EXECUTION_VARIANTS, or None for contract-only upgrades that are absent from the execution fork ladder.

pub const fn contract_id(self) -> &'static str

Returns the canonical snake_case contract upgrade ID used by the L1 upgrade-signal contract and metrics.

Note this differs from name (PascalCase), which is the reth/execution hardfork identity.

pub const fn execution_hardfork(self) -> Option<EthereumHardfork>

Returns the Ethereum execution hardfork activated by this upgrade, if any.

pub const fn from_ethereum_hardfork( fork: EthereumHardfork, ) -> Option<BaseUpgrade>

Returns the Base upgrade that carries the given Ethereum hardfork on Base.

pub fn from_contract_fork_name(name: &str) -> Option<BaseUpgrade>

Returns the contract-backed upgrade represented by an execution, Base, or contract alias name. Returns None for unknown names and for non-contract-backed upgrades (Bedrock).

pub fn normalized_hardfork_id(upgrade_id: &str) -> String

Normalizes a contract upgrade ID for matching (lowercase, stripping whitespace, _, -).

pub fn from_chain_and_timestamp( chain_id: u64, timestamp: u64, ) -> Option<BaseUpgrade>

Returns the active upgrade at the given timestamp for the specified chain.

Trait Implementations

impl BaseUpgradeExt for BaseUpgrade

fn into_eth_spec(self) -> SpecId

Converts the Base upgrade into its matching Ethereum execution spec.

fn forks_for(cfg: &ChainConfig) -> [(BaseUpgrade, ForkCondition); 13]

Returns the execution fork ladder with activation conditions for the given chain config.

fn from_timestamp(chain_spec: impl Upgrades, timestamp: u64) -> BaseUpgrade

Returns the active Base upgrade at the given timestamp.

fn mainnet() -> [(BaseUpgrade, ForkCondition); 13]

Base mainnet list of execution upgrades.

fn sepolia() -> [(BaseUpgrade, ForkCondition); 13]

Base Sepolia list of execution upgrades.

fn devnet() -> [(BaseUpgrade, ForkCondition); 13]

Devnet list of execution upgrades.

fn zeronet() -> [(BaseUpgrade, ForkCondition); 13]

Base Zeronet list of execution upgrades.

impl Clone for BaseUpgrade

fn clone(&self) -> BaseUpgrade

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BaseUpgrade

impl Debug for BaseUpgrade

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

Formats the value using the given formatter.

impl Default for BaseUpgrade

fn default() -> BaseUpgrade

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BaseUpgrade

fn deserialize<__D>( __deserializer: __D, ) -> Result<BaseUpgrade, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BaseUpgrade

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

Formats the value using the given formatter.

impl Eq for BaseUpgrade

impl From<BaseSpecId> for BaseUpgrade

fn from(spec: BaseSpecId) -> BaseUpgrade

Converts to this type from the input type.

impl From<BaseUpgrade> for FoundryHardfork

fn from(value: BaseUpgrade) -> FoundryHardfork

Converts to this type from the input type.

impl From<BaseUpgrade> for BaseSpecId

fn from(upgrade: BaseUpgrade) -> BaseSpecId

Converts to this type from the input type.

impl From<FoundryHardfork> for BaseUpgrade

fn from(fork: FoundryHardfork) -> BaseUpgrade

Converts to this type from the input type.

impl FromStr for BaseUpgrade

type Err = ParseHardforkError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<BaseUpgrade, <BaseUpgrade as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hardfork for BaseUpgrade

fn name(&self) -> &'static str

Fork name.

fn boxed(&self) -> Box<dyn Hardfork + '_>

Returns boxed value.

impl Hash for BaseUpgrade

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for BaseUpgrade

fn cmp(&self, other: &BaseUpgrade) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for BaseUpgrade

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for BaseUpgrade

fn partial_cmp(&self, other: &BaseUpgrade) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for BaseUpgrade

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BaseUpgrade

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: 1 byte

Size for each variant:

• Bedrock: 0 bytes
• Regolith: 0 bytes
• Canyon: 0 bytes
• Delta: 0 bytes
• Ecotone: 0 bytes
• Fjord: 0 bytes
• Granite: 0 bytes
• Holocene: 0 bytes
• PectraBlobSchedule: 0 bytes
• Isthmus: 0 bytes
• Jovian: 0 bytes
• Azul: 0 bytes
• Beryl: 0 bytes
• Cobalt: 0 bytes
• Denim: 0 bytes
• Zenith: 0 bytes