Network upgrade overview

This section has information on how to upgrade your Mainnet and Testnet nodes for new network upgrades. The network upgrade naming scheme after the Bedrock upgrade has a geology themed name based on the next letter in the english alphabet.

Activations

Network upgrades are activated by timestamps. Failing to upgrade your node before the timestamp will cause a chain divergence. You will need to resync your node to reconcile the chain. Optimistic activation times refer to times that are pending governance approval.

Summary of changes

These are the summaries of each network upgrade changes ordered by the most recent activation. These are a reflection of the Superchain Upgrades Specifications (opens in a new tab)

Granite (opens in a new tab)

The Granite upgrade limits bn256Pairing precompile input size and reduces the Channel Timeout.

• Limit bn256Pairing precompile input size (opens in a new tab)
• Reduce Channel Timeout to 50 (opens in a new tab)

Fjord (opens in a new tab)

The Fjord upgrade includes the RIP-7212 precompile, FastLZ gas pricing, Brotli channel compression, and several protocol parameter changes.

• RIP-7212: Precompile for secp256r1 (opens in a new tab)
• Brotli channel compression (opens in a new tab)
• FastLZ gas pricing
  • FastLZ L1 fee cost calculation (opens in a new tab)
  • Upgraded GasPriceOracle to compute FastLZ (opens in a new tab)
  • L1 gas cost changes (opens in a new tab)
• Protocol parameter changes
  • Max sequencer drift becomes constant (opens in a new tab)
  • Channel constant increases (opens in a new tab)
• Fjord hardfork activation block (opens in a new tab)

Ecotone (opens in a new tab)

The Ecotone upgrade contains the Dencun upgrade from L1, and adopts EIP-4844 blobs for data-availability.

Cancun (Execution Layer):

• EIP-1153: Transient storage opcodes (opens in a new tab)
• EIP-4844: Shard Blob Transactions (opens in a new tab)
• Blob transactions are disabled (opens in a new tab)
• EIP-4788: Beacon block root in the EVM (opens in a new tab)
• The L1 beacon block root is embedded into L2 (opens in a new tab)
• The Beacon roots contract deployment is automated (opens in a new tab)
• EIP-5656: MCOPY - Memory copying instruction (opens in a new tab)
• EIP-6780: SELFDESTRUCT only in same transaction (opens in a new tab)
• EIP-7516: BLOBBASEFEE opcode (opens in a new tab)
• BLOBBASEFEE always pushes 1 onto the stack (opens in a new tab)

Deneb (Consensus Layer): not applicable to L2

• EIP-7044: Perpetually Valid Signed Voluntary Exits (opens in a new tab)
• EIP-7045: Increase Max Attestation Inclusion Slot (opens in a new tab)
• EIP-7514: Add Max Epoch Churn Limit (opens in a new tab)

Data Availability (DA) upgrade:

• Blobs Data Availability: support blobs DA the L1 Data-retrieval stage (opens in a new tab).
• Rollup fee update: support blobs DA in L1 Data Fee computation (opens in a new tab)
• Auto-upgrading and extension of the L1 Attributes Predeployed Contract (opens in a new tab) (also known as L1Block predeploy)

Delta (opens in a new tab)

The Delta upgrade consists of a single consensus-layer feature: Span Batches (opens in a new tab).

The Delta upgrade uses a L2 block-timestamp activation-rule, and is specified only in the rollup-node (delta_time).

Canyon (opens in a new tab)

The Canyon upgrade contains the Shapella upgrade from L1 and some minor protocol fixes.

• EIP-3651: Warm COINBASE (opens in a new tab)
• EIP-3855: PUSH0 instruction (opens in a new tab)
• EIP-3860: Limit and meter initcode (opens in a new tab)
• EIP-4895: Beacon chain push withdrawals as operations (opens in a new tab)
• Withdrawals are prohibited in P2P Blocks (opens in a new tab)
• Withdrawals should be set to the empty array with Canyon (opens in a new tab)
• EIP-6049: Deprecate SELFDESTRUCT (opens in a new tab)
• Modifies the EIP-1559 Denominator (opens in a new tab)
• Channel Ordering Fix (opens in a new tab)
• Adds the deposit nonce & deposit nonce version to the deposit receipt hash (opens in a new tab)
• Deploys the create2Deployer to 0x13b0D85CcB8bf860b6b79AF3029fCA081AE9beF2 (opens in a new tab)

The Canyon upgrade uses a L2 block-timestamp activation-rule, and is specified in both the rollup-node (canyon_time) and execution engine (config.canyonTime). Shanghai time in the execution engine should be set to the same time as the Canyon time.

Bedrock

The Bedrock upgrade transitioned the OP Stack from its legacy design to a modern modular architecture. This new design separates the OP Stack into distinct consensus, execution, and settlement layers, enabling more efficient integration of future improvements and facilitating the growth of a Superchain ecosystem.

Upgrade process

Network upgrades follow this general process in which the features included in the upgrade are put into a release version cut from the develop branch and then the software is deployed on production networks.

More information

• To check for the latest node software, see the Software Releases.
• For more information on the governance process see the governance documentation (opens in a new tab).