v1.101511.0

Overview

This is a recommended release for all node operators. It mainly includes the latest changes from upstream go-ethereum/v1.15.11 (#15829). The previous op-geth release was based on go-ethereum/v1.15.3.

It also includes new metrics for the miner throttling API (#606)

🤝 The corresponding op-node release is v1.13.3

What's Changed

• sync-superchain: remove use of declare -A for ancient bash compatibility by @sebastianst in #582
• core,params: Check implied fork times during genesis setup by @sebastianst in #587
• core/genesis: warn log if there is no L2toL1MP storage with Isthmus by @geoknee in #590
• core: remove duplicate call to CheckConfigForkOrder by @zhiqiangxu in #594
• core: remove unused interoptypes by @protolambda in #601
• miner: add miner/maxDATxSize and miner/maxDABlockSize gauge metrics and update when setMaxDASize is called by @haardikk21 in #606
• all: Merge go-ethereum v1.15.11 by @sebastianst in #602
• all: Merge upstream geth v1.15.7 by @sebastianst in #571
• all: Merge upstream geth v1.15.10 by @sebastianst in #593

New Contributors

• @haardikk21 made their first contribution in #606

Full Changelog: v1.101503.4...v1.101511.0

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101511.0

v1.101503.4 - Isthmus Mainnet

Isthmus Mainnet

Important

This is a required upgrade for any Mainnet Superchain node by May 9 as it contains the Isthmus activation on that date. It is unnecessary for other networks.

This is the Isthmus release for the Mainnet Superchain. It schedules the activation of the Isthmus fork on Fri May 9 16:00:00 UTC 2025 (unix timestamp 1746806401).
The following Mainnet chains have the Isthmus upgrade scheduled at this timestamp: arena-z, base, bob, ethernity, ink, lisk, lyra, metal, mint, mode, op, orderly, polynomial, snax, soneium, tbn, unichain, zora. It is mandatory to upgrade nodes for those chains before May 9.

🤝 The corresponding mandatory op-node release is v1.13.2.

Chain operators also need to upgrade their batchers to op-batcher/v1.12.0 before activating Isthmus on their chains.

What's Changed

• sr: Prepare Isthmus Mainnet release by @sebastianst in #580

Full Changelog: v1.101503.3...v1.101503.4

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.4

v1.101503.3 - Worldchain Sepolia Fix

This release fixes the Worldchain Sepolia genesis configuration (#577). It is not required for any other chain.

Important

For Sepolia Superchain nodes, please look at the required prior release v1.101503.2.

🤝 The corresponding op-node release is v1.13.1.

What's Changed

• rpc: RPC recording functions by @protolambda in #562
• interop: fix debug message in miner/worker by @pcw109550 in #557
• txpool: Reorganize Filter Checks by @axelKingsley in #572
• sr: update to 84838da8305c55bdd28c0eea1fd4fd65c097e296 to fix Worldchain by @sebastianst in #577

New Contributors

• @pcw109550 made their first contribution in #557

Full Changelog: v1.101503.2...v1.101503.3

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.3

v1.101503.2 - Isthmus Sepolia

Isthmus Sepolia

Important

This is a required upgrade for any Sepolia Superchain node by Apr 17 as it contains the Isthmus activation on that date. It is a recommended upgrade for all chain operators because it contains an important bug fix of the transaction pool.

This is the Isthmus release for the Sepolia Superchain. It schedules the activation of the Isthmus fork on Thu Apr 17 16:00:00 UTC 2025 (unix timestamp 1744905600).
The following Sepolia chains have the Isthmus upgrade scheduled at this timestamp: base, creator-chain-testnet, ethernity, ink, metal, mode, op, soneium-minato, unichain, zora, lisk. It is mandatory to upgrade nodes for those chains before Apr 17.

🤝 The corresponding mandatory op-node release is v1.13.0.

Chain operators also need to upgrade their batchers to op-batcher/v1.12.0 before activating Isthmus on their chains.

Warning

This release cannot be used to sync worldchain (both sepolia or mainnet) from genesis, or any partially synced node at or before Feb 20, 2025, when Worldchain updated the EIP-1559 parameters via the SystemConfig. It contains a wrong EIP-1559 elasticity at genesis that will lead to a BAD BLOCK during sync. Use the older release v1.101503.1. We will publish a fix for Worldchain soon.

Transaction Pool Fixes (#558 #567)

The transaction pool got fixed to properly handle rollup cost (L1 Costs and Operator Fees (Isthmus only)) accounting. This was a longstanding bug that may sometimes have cause transactions to get rejected from the pool even thought the sender had enough balance, or the other way around where transactions could get accepted into the pool but then never get included because the sender's balance was too low.

What's Changed

• eth/catalyst: validate withdrawalsRoot in NewPayloadV4 by @geoknee in #544
• interop: Access List Ingress Filtering by @axelKingsley in #540
• interop: Check Access Lists in Builder by @axelKingsley in #541
• accounts/abi: estimate gas with access-list by @protolambda in #546
• Fix operator fee deposit by @sebastianst in #552
• superchain: Support reading superchain configs from arbitrary data. by @ajsutton in #556
• core/txpool: Take total rollup cost into account (L1 + operator fee) by @sebastianst in #558
• sr: update to 877ef2c1dc37b3cdc083819b2acb3e86881711ff (Isthmus Sepolia release) by @sebastianst in #566
• core/txpool: fix rollup cost accounting by @sebastianst in #567

Full Changelog: v1.101503.1...v1.101503.2

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.2

v1.101503.1

This release fixes a regression in serving eth_feeHistory RPC method, and adds snaxchain config.

It is recommended for all users to upgrade.

What's Changed

• eth: fix OP-Stack fee-history RPC by @protolambda in #543
• Update superchain-registry@84bce73573f130008d84bae6e924163bab589a11 by @geoknee in #545

Full Changelog: v1.101503.0...v1.101503.1

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.1

v1.101503.0 - Pectra L1 readiness

❗ All node operators must upgrade to this op-geth release.

The corresponding op-node release is v1.12.0, see its release nodes for details on a bug that hit Sepolia OP chains when Sepolia activated Pectra.

Upstream go-ethereum update

This release contains all upstream geth changes up to release v1.15.3.

What's Changed

• upgrade circleci-utils by @raffaele-oplabs in #514
• interop: New sequencer executing message check API by @Inphi in #521
• eth/interop: use checkMessagesV2, but fallback to V1 if not found by @protolambda in #522
• all: Merge go-ethereum v1.15.0 by @sebastianst in #525
• forkdiff: update base to geth/v1.15.0 by @sebastianst in #527
• isthmus: operator fee by @yuwen01 in #388
• fix: remove requests queue processing by @meyer9 in #532
• fix: solves eth_createAccessList unmarshaling error by @sebaespindola in #524
• superchain: Add optional fork PectraBlobSchedule by @sebastianst in #533
• Merge go-ethereum v1.15.3 by @geoknee in #530
• Update latest signer for optimism to prague by @meyer9 in #535
• superchain: update SR to 08e3fe429c776a532c2b6dc09571fc13e6dba5d4 by @sebastianst in #537
• superchain: update SR to cb1b645b35813b8dd3a900b9f99c46614e466a2c by @sebastianst in #538

New Contributors

• @yuwen01 made their first contribution in #388
• @sebaespindola made their first contribution in #524

Full Changelog: v1.101500.1...v1.101503.0

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101503.0

v1.101500.1 - Ink Mainnet Holocene Update

Ink Mainnet Holocene Update

❗ Ink Mainnet node operators must upgrade to this release before Wed 26 Feb 2025 15:00:00 UTC. This release bumps the Holocene activation time for Ink Mainnet to 1742396400 # Wed 19 Mar 2025 15:00:00 UTC. All other node operators can ignore this release.

🤝 Corresponding op-node release: v1.11.2

What's Changed

• feat: ensure no requests are included in isthmus blocks by @meyer9 in #498
• node: Enable debug rpc in authrpc if enabled in http by @zhiqiangxu in #512
• Add Jovian time config by @mdehoog in #463
• ci: only mark finalized releases as 'latest' by @sebastianst in #515
• sr: update to 68ebaf81202ee7e21638232c54404074a49a63f6 by @sebastianst in #516

Full Changelog: v1.101500.0...v1.101500.1

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101500.1

v1.101500.0 - L1 Pectra Readiness

L1 Pectra Readiness

❗ All node operators must upgrade to this release by the time their chain's L1 activates Pectra.
❗ If you run a full node, don't directly upgrade to this release, but start up once with version v1.101411.8. See its release notes for more details. Archival nodes don't need to follow this upgrade path.

Corresponding op-node release: v1.11.0

This release prepares the OP Stack to handle L1 chains activating Pectra. It includes all changes from the go-ethereum upstream release 1.14.11 and a subset of changes from the 1.15.0 release, all commits on master up to f0e8a3e fix README.md (ethereum/go-ethereum#31076). In particular, support for the new SetCode transaction type 4 is included.

The superchain-registry bindings are also updated to pull in new chain configurations. It is not included as a Go module any more, but instead bundled inside the repo since this release. Downstream dependencies like the Optimism monorepo also use the bundled configurations of op-geth going forward.

What's Changed

• all: update to geth v1.14.12 by @protolambda in #452
• Add bindings for SR2.0 by @mslipper in #466
• feat: add Isthmus fork rules by @meyer9 in #471
• Add getters for SR2 superchain tomls by @mslipper in #476
• Align HoloceneTime printout in banner by @geoknee in #477
• Separate loading config and genesis files by @mslipper in #482
• crypto: add IsOnCurve check (#31100) by @sebastianst in #485
• chore: add missing Isthmus chain config options by @meyer9 in #484
• scr: Update superchain-registry by @sebastianst in #486
• all: Merge upstream pre-v1.15.0, based on #474, plus review fixes by @protolambda in #480
• fix(db): improve log for NewDatabaseWithFreezer. by @scharissis in #488
• ci: Remove check releases job by @ajsutton in #489
• cmd/geth: add RollupEnableTxPoolAdmissionFlag to node flags by @pengin7384 in #434
• feat: ensure requests array empty post-Isthmus by @meyer9 in #478
• feat: add BLS precompile size limits for Isthmus by @meyer9 in #490
• eth/catalyst: Check that extraData is empty in newPayload pre-Holocene by @sebastianst in #492
• Use CrossUnsafe for Interop Ingress Filter by @axelKingsley in #428
• node: Enable miner rpc in authrpc if enabled in http by @ferranbt in #491
• pathdb: Pathdb full write-buffer check by @protolambda in #497
• Add bootnodes ran by UL by @trianglesphere in #502
• sr: update to 4e0b67b7fa7d652d613e6f2f0e73d9656023c770 to add uni-mainnet by @sebastianst in #505

New Contributors

• @meyer9 made their first contribution in #471
• @scharissis made their first contribution in #488
• @pengin7384 made their first contribution in #434
• @ferranbt made their first contribution in #491

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101500.0

Full Changelog: v1.101411.5...v1.101500.0

v1.101411.8 - upgrade path to v1.101500.0

This release contains a fix to the upstream journaling code (b79c44a) to ensure no critical state is lost when upgrading full nodes and the journal is thrown away due to a journal format update. Any full node operator who intends to upgrade their v1.101411.x op-geth node to v1.101500.0 should first restart their node once with this release. When you run this release and shut it down again, search the shutdown logs for a message

Persisting dirty state to disk

and its buffer_layers argument. It should be lower than 128. If that's the case, you can safely go on to upgrade to v1.101500.0.

As steps:

• You're running v1.101411.x
• Start up v1.101411.8 once, let it run for a while, shut down.
• Check shutdown logs for Persisting dirty state to disk message, check that buffer_layers argument is <128
• You're good to upgrade to v1.101500.0

The background is that updating the upstream geth dependencies between v1.101411.x and v1.101500.0, there were two journal format updates in the underlying geth versions from v1.14.11 to v1.15.0. This causes the journal do be dropped at startup of the new release v1.101500.0. A full node should be able to recover from this, but we suspect a bug in geth (ethereum/go-ethereum#31131) means that more than 128 layers are part of the journal, so when it's thrown away at startup, the node may be missing critical state and needs to heal its state.

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101411.8

Full Changelog: v1.101411.6...v1.101411.8

v1.101411.6 - P2P Fix

❗ All node operators are strongly recommended to upgrade to this release. It contains an urgent security fix (CVE-2025-24883). This fix is the only difference to the prior release v1.101411.5.

Also upgrade your L1 go-ethereum nodes to v1.14.13, which contains the same fix.

🚢 Docker Image: https://us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101411.6

Full Changelog: v1.101411.5...v1.101411.6