Builders
Node Operators
Network Upgrades

Network Upgrade Overview

⚠️

Read this notice to prepare for Fjord.

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.

| Upgrade | Governance Approval | PNC Mainnet Activations | | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | Fjord | TBD | Optimistically Wed Jul 10 16:00:01 UTC 2024 (1720627201) | Wed May 29 16:00:00 UTC 2024 (1716998400) | | Ecotone | approved | Thu Mar 14 00:00:01 UTC 2024 (1710374401) | Wed Feb 21 17:00:00 UTC 2024 (1708534800) | | Delta | approved | Thu Feb 22 00:00:00 UTC 2024 (1708560000) | Fri Dec 22 00:00:00 UTC 2023 (1703203200) | | Canyon | approved| Thu Jan 11 17:00:01 UTC 2024 (1704992401) | Tue Nov 14 17:00:00 UTC 2023 (1699981200) |

Summary of Changes

These are the summary of each network upgrade changes order by the most recent activation. These are a reflection of the Superchain Upgrades Specifications

Fjord

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

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

Ecotone

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

Cancun (Execution Layer):

Deneb (Consensus Layer): not applicable to L2

Data Availability (DA) upgrade:

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

Delta

The Delta upgrade consists of a single consensus-layer feature: Span Batches.

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

Canyon

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

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.

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.

"Baking" on a network means the node software has been deployed and is live. Engineers take this time to observe the behavior of the software on production networks.

Node Software Release Timeline

Devnet

  • Devnet Upgrade Notice Period is for core developers to upgrade the node software on an internal devnet prior to the activation timestamp.
  • Upgrade Activates on Devnet
  • Baking on Devnet

Testnet

  • Testnet Upgrade Notice Period is to allow testnet node operators to upgrade the node software on testnet prior to the activation timestamp.
  • Upgrade Activates on Testnet
  • Baking on Testnet

Mainnet

  • Governance Voting Review Period is when the Pinnacle Chain's governance system reviews proposals, including network upgrade proposals.
  • Governance Voting Period is when the Pinnacle Chain's governance system votes on proposals.
  • Veto Period is when the Citizens' House of the governance system can veto a protocol upgrade that has been approved by the Token House.
  • Cut Mainnet Release
  • Mainnet Upgrade Notice Period is to allow mainnet node operators to upgrade the node software on mainnet prior to the activation timestamp.
  • Upgrade Activated

More Information

  • To check for the latest node software, see the Software Releases.
  • For more information on the governance process see the governance documentation.
TroubleshootingJSON-RPC API