Skip to main content

Preparing for Pectra Breaking Changes on Soneium

danger

This notice was updated on Fri Mar 14 to address a recently discovered bug in op-node. Soneium Minato node operators, please carefully review the updated instructions below and ensure that you are running the specified release versions.

In preparation for the upcoming Ethereum Pectra hardfork, which combines the Prague (execution layer) and Electra (consensus layer) upgrades, the OP stack will undergo a two-step upgrade process to ensure full utilization of the Pectra enhancements. As part of the Superchain, Soneium will implement these upgrades accordingly.

The first step ensures that OP stack chains remain compatible after the Pectra upgrade is activated on Ethereum L1. The second step, to be executed later, will fully enable OP stack chains to support Pectra's new features for L2s.

This page outlines the breaking changes that will affect Soneium node operators, developers, and users.

Soneium Minato​

warning

The upgrade will take place on March 3, 2025.

With the activation of the Pectra hardfork on Ethereum Sepolia L1 at the timestamp 1741159776 (Wed, Mar 5 at 07:29:36 UTC), Soneium Minato Testnet will be the first to undergo the initial upgrade phase, ensuring compatibility with Pectra.

For Node Operators​

Soneium Minato node operators must upgrade to the latest op-geth and op-node releases before the Pectra activation date for Ethereum Sepolia. Additionally, a bug fix for op-node requires adjusting the rollup.json file to explicitly include Soneium Minato's EIP-1559 parameters.

danger

The node upgrade procedure depends on the type of node being operated:

  • Full Node Operators: Operators running Soneium Minato full nodes (i.e., those using op-geth with the gcmode=full flag) must first complete an intermediate upgrade step, as outlined in the v1.101411.8 release notes of op-geth.
  • Archive Node Operators: Operators running archive nodes (i.e., those using op-geth with the gcmode=archive flag) can skip the intermediate upgrade step and upgrade directly to the latest releases listed below.
note

L1 Service Operators: Node operators maintaining their own L1 services (i.e., Sepolia RPC and Beacon API) must also upgrade their clients for Pectra.

Please update your Soneium Minato nodes to the following latest releases:

You can find the adjusted configuration files in the Soneium Node section. For more details, refer to the Optimism documentation.

note

Resolving Diverged Nodes​

If your node has diverged from the Minato network, you can resolve the issue using one of the following methods:

  1. Re-sync from scratch: Reset your node setup with the updated configuration files.
  2. Rollback using op-wheel: Revert your node to a block preceding the divergence. For safety, select a block from approximately two hours before the divergence occurred.

For detailed instructions on this, please refer to the Optimism documentation.

For Developers​

There is no impact for developers.

For Users​

There is no impact for end users.

Soneium Mainnet​

warning

The upgrade date for Soneium Mainnet is to be determined.

On This Page