Skip to main content

Preparing for Fjord and Granite Dual Upgrade + Introduction of Fault Proofs

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

Fjord and Granite Upgrade​

The upgrade will take place on October 28, 2024.

Following the recent rollout of the Ecotone upgrade to Soneium Minato, which included the Dencun upgrade from Ethereum mainnet and adopted EIP-4844 blobs for data availability, this is now the second upgrade for Soneium Minato. This upgrade will port Soneium Minato to Granite, the latest version of the Optimism OP stack, paving the way for Soneium's integration into the Superchain. Notably, this upgrade combines two network upgrades: Fjord and Granite.

The most important upgrades include:

  • The introduction of the RIP-7212 precompile to reduce gas costs for many smart wallet applications.
  • Support for Brotli batch compression, which results in approximately 5-15% lower data availability costs, while also improving the robustness of L1 data pricing.
  • An increase to the max-sequencer-drift parameter, now hardcoded to give chain operators more time to respond to L1 node issues without risking a potential L2 chain halt.

A full description of the upgrade is available on Optimism governance and documentation:

For Node Operators​

warning

Soneium Minato node operators must complete the upgrade of their nodes before Monday, October 28, 2024, 09:00:00 GMT+0000.

Soneium Minato node operators must restart their nodes using the latest version of the Soneium Minato node. Please follow the instructions outlined below.

Manual Upgrade​

  1. Download the latest op-node and op-geth releases from the Soneium Minato GitHub repository:
wget https://github.com/Soneium/soneium-node/releases/download/1.9.3-e81c50de-1727294020/op-node
wget https://github.com/Soneium/soneium-node/releases/download/1.101408.0-stable-5c2e7586/geth
  1. Stop the op-geth service.
  2. Update your systemd service configuration for op-geth to include the Fjord and Granite fork timestamps:
./bin/geth \
    # Omitting all above parameters
    # Add the following 2 lines:
    # Set the timestamp for Fjord and Granite hardfork           
    --override.fjord=1730106000 \
    --override.granite=1730106000
  1. Start the op-geth service.
  2. Stop the op-node service.
  3. Update your systemd service configuration for op-node to include the Fjord and Granite fork timestamps:
./bin/op-node \
    # Omitting all above parameters 
    # Add the following 2 lines: 
    # Set the timestamp for Fjord and Granite hardfork           
    --override.fjord=1730106000 \
    --override.granite=1730106000
  1. Start the op-node service.

Alternatively, full instructions for installing the binaries can also be found in the README of the Soneium Minato node.

Docker​

Clone the Soneium Minato node GitHub repository, configure the required environment variables, and run the node by following the instructions provided in the repository.

For Developers​

Developers on Soneium Minato should be aware of changes related to gas price usage and estimation:

  • The getL1GasUsed method of the GasPriceOracle contract is deprecated in Granite, as it does not accurately estimate the gas used for a transaction. If you are calculating fees, please use the getL1Fee method or the getL1FeeUpperBound method on the GasPriceOracle instead. Further information is available in the Optimism documentation.
  • The L1GasUsed field of the transaction receipt is deprecated, as it does not capture the L1 blob gas used by a transaction, and it will be removed in a future network upgrade. Users can continue to use the L1Fee field to retrieve the L1 fee for a given transaction.

All client-side tooling remains unaffected by the upgrade.

For Users​

There is no impact for end users.

Introduction of Fault Proofs​

The upgrade will take place in early November 2024.

This upgrade will introduce permissioned fault proofs to Soneium Minato and align it with other Superchains in the ecosystem.

For Users​

With this upgrade, the withdrawal finalisation period will be extended to 7 days. As a result, all withdrawals that are not finalised before the upgrade will need to be re-proven and wait for finalisation again once the upgrade is complete.

  • You can re-prove by executing the withdrawal proving flow once more.
  • Any withdrawal initiated less than 7 days before the upgrade will not be finalised before the upgrade executes. As a result, these withdrawals can only be finalised 7 days after the upgrade is complete. For example, a withdrawal initiated 6 days before the upgrade would take a total of 13 days to finalise. You may want to consider waiting until after the upgrade is complete to initiate a withdrawal during this 7-day period.

For Bridge Operators​

Please make sure your users are aware that Soneium Minato withdrawals will now take a minimum of 7 days, and review your bridging logic to confirm that the updated L1 contracts are being utilized.

For detailed information on the changes, please also refer to the Optimism Fault Proof notice.

For Node Operators and Developers​

The fault proof contract upgrades will occur in a single atomic transaction, updating all affected L1 contracts at once. Neither node operators nor developers will need to take any action.