> ## Documentation Index
> Fetch the complete documentation index at: https://optimism-373f39ad-sdm-docs-revisit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# op-reth Releases

> Release history for op-reth. OP Stack execution layer built on Reth.

**op-reth** is the OP Stack execution layer (EL) built on [Reth](https://reth.rs), a modular, high-performance Rust Ethereum node. It is the recommended execution client for OP Stack chains, replacing op-geth.

<Update label="August 13, 2026" description="v2.4.2" tags={["Latest", "Stable"]}>
  > \[!IMPORTANT]
  > **Upgrade strongly recommended:** this release contains various bug fixes. Upgrading is strongly recommended for both chain operators and validators.

  > \[!IMPORTANT]
  > **op-rbuilder:** if you run op-rbuilder, an upgrade to [v0.4.13](https://github.com/flashbots/op-rbuilder/releases/tag/op-rbuilder%2Fv0.4.13) is also strongly recommended as it received some of the same fixes via its last maintenance upgrade contained in this version.

  > \[!NOTE]
  > **Proofs ExEx** received several stability and correctness improvements (#22146, #22177, #22256).

  > \[!WARNING]
  > **Deprecation:** The historical proofs v1 database format will be deprecated by Aug 31st. Start migrating all your proof nodes to the new v2 format (it is also much more efficient) by regenerating the proofs db at v2 for the required block range.

  > \[!WARNING]
  > **Deprecation:** The `import-op` + `import-receipts-op` commands will be deprecated by Aug 31st. If you need continued support for these, please reach out to us.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.4.2)
</Update>

<Update label="July 31, 2026" description="v2.4.1" tags={["Stable"]}>
  > \[!CAUTION]
  > **Breaking change — forwarded txpool admission is now opt-in** ([#22053](https://github.com/ethereum-optimism/optimism/pull/22053)).
  > Nodes that relied on forwarded transactions being admitted to the pool must now enable this explicitly, or they will silently stop accepting them.

  > \[!CAUTION]
  > The historical proofs v1 database format will be deprecated by Aug 31st. Start migrating all your proof nodes to the new v2 format (it is also much more efficient) by regenerating the proofs db at v2 for the required block range.

  > \[!CAUTION]
  > The `import-op` + `import-receipts-op` commands will be deprecated by Aug 31st. If you need continued support for these, please reach out to us.

  > \[!IMPORTANT]
  > Two further transaction-pool admission changes affect which transactions are accepted:
  > L1-info deposit gas is now reserved in the pool gas limit for op-geth parity ([#21548](https://github.com/ethereum-optimism/optimism/pull/21548)),
  > and the Isthmus operator fee is reserved in the pool balance check ([#21609](https://github.com/ethereum-optimism/optimism/pull/21609)).
  > Secure (`wss://`) flashblocks endpoints now work — previously any `wss://` flashblocks URL panicked on the first TLS handshake ([#21898](https://github.com/ethereum-optimism/optimism/pull/21898)).

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.4.1)
</Update>

<Update label="July 20, 2026" description="v2.4.0" tags={["Stable"]}>
  > \[!NOTE]
  > **Optional upgrade.** New extension points: `OpPoolBuilder` transaction ordering and validator are now injectable ([#21531](https://github.com/ethereum-optimism/optimism/pull/21531)), and `op-alloy-network` makes its reqwest dependency opt-in ([#21175](https://github.com/ethereum-optimism/optimism/pull/21175)). Also fixes Prometheus metric-bucket draining in the op-proofs CLI ([#21596](https://github.com/ethereum-optimism/optimism/pull/21596)). No consensus or operator-facing behavior changes.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.4.0)
</Update>

<Update label="June 26, 2026" description="v2.3.3" tags={["Stable"]}>
  > \[!Warning]
  > **This is a mandatory release for all node operators.** It includes the [Mainnet](https://github.com/ethereum-optimism/superchain-registry/blob/c90d86d2ed13541f16daf5ce8707c688723ca039/superchain/configs/mainnet/op.toml#L24) timestamps for the Karst hardfork. (as of `c90d86d`)
  >
  > The following Mainnet chains will activate on **1783526401 (Wed Jul 8 2026 16:00:01 UTC)**, pending governance approval: op, ink, zora, mode, lisk, metal, unichain, soneium, ethernity, tbn
  >
  > **Reminder:** op-geth has reached [end of support](https://docs.optimism.io/notices/op-geth-deprecation), so you must be running op-reth to support the karst activation. For more details on this network upgrade see our [notice page](https://docs.optimism.io/notices/upgrade-19).

  > \[!IMPORTANT]
  > **Operators must use op-node/v1.19.1+ with this release.** Prior versions of op-node will not work with this version of op-reth after Karst due to a new engine API method (`getPayloadV5`) used after Karst. See the [notice page](https://docs.optimism.io/notices/upgrade-19) for more details about recommended versions (including flashblocks components).

  op-reth can now load OP Sepolia and OP Mainnet timestamps from the superchain registry. If you are a node operator for either of those chains, you do not need to specify a custom genesis file with the `--chain` flag.

  > \[!CAUTION]
  > **Mandatory upgrade.** Fixes eth\_estimateGas after the Karst hardfork.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.3.3)
</Update>

<Update label="June 26, 2026" description="v2.3.2" tags={["Stable"]}>
  ### Please use [op-reth v2.3.3](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth%2Fv2.3.3) instead. It contains a bug fix for `eth_estimateGas`.

  ***

  > \[!Warning]
  > **This is a mandatory release for all node operators.** It includes the [Mainnet](https://github.com/ethereum-optimism/superchain-registry/blob/c90d86d2ed13541f16daf5ce8707c688723ca039/superchain/configs/mainnet/op.toml#L24) timestamps for the Karst hardfork. (as of `c90d86d`)
  >
  > The following Mainnet chains will activate on **1783526401 (Wed Jul 8 2026 16:00:01 UTC)**, pending governance approval: op, ink, zora, mode, lisk, metal, unichain, soneium, ethernity, tbn
  >
  > **Reminder:** op-geth has reached [end of support](https://docs.optimism.io/notices/op-geth-deprecation), so you must be running op-reth to support the karst activation. For more details on this network upgrade see our [notice page](https://docs.optimism.io/notices/upgrade-19).

  > \[!IMPORTANT]
  > **Operators must use op-node/v1.19.1+ with this release.** Prior versions of op-node will not work with this version of op-reth after Karst due to a new engine API method (`getPayloadV5`) used after Karst. See the [notice page](https://docs.optimism.io/notices/upgrade-19) for more details about recommended versions (including flashblocks components).

  op-reth can now load OP Sepolia and OP Mainnet timestamps from the superchain registry. If you are a node operator for either of those chains, you do not need to specify a custom genesis file with the `--chain` flag.

  **Update**: we are aware of an issue impacting calls to `eth_estimateGas` after Karst has activated. We have a fix that will be released in op-reth/v2.3.3 prior to mainnet activation. The [notice page](https://docs.optimism.io/notices/upgrade-19#for-app-developers) has more details.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.3.2)
</Update>

<Update label="June 5, 2026" description="v2.3.1" tags={["Stable"]}>
  > \[!IMPORTANT]
  >
  > This release fixes a deadlock bug that would cause a node to stall, and supersedes the v2.2.5 and v2.3.0 releases.

  > \[!WARNING]
  > This is a mandatory release for all node operators. It includes [Sepolia](https://github.com/ethereum-optimism/superchain-registry/blob/c90d86d2ed13541f16daf5ce8707c688723ca039/superchain/configs/sepolia/op.toml#L25) and [Mainnet](https://github.com/ethereum-optimism/superchain-registry/blob/c90d86d2ed13541f16daf5ce8707c688723ca039/superchain/configs/mainnet/op.toml#L24) timestamps for the Karst hardfork.  (as of `c90d86d`)
  >
  > **Operators must upgrade before the scheduled hard fork times.**
  >
  > The following Sepolia chains will activate on **`1781712001` (Wed Jun 17 2026 16:00:01 UTC)**: op, ink, zora, mode, lisk, metal, unichain, soneium-minato, ethernity, creator-chain-testnet
  >
  > The following Mainnet chains will optimistically activate on **`1783526401` (Wed Jul 8 2026 16:00:01 UTC)**, pending governance approval: op, ink, zora, mode, lisk, metal, unichain, soneium, ethernity, tbn
  >
  > **Reminder**: op-geth has reached [end of support](https://docs.optimism.io/notices/op-geth-deprecation), so you must be running op-reth to support the karst activation. For more details on this network upgrade see our [notice page](https://docs.optimism.io/notices/upgrade-19).

  **OP Sepolia:**

  * Due to a bug in op-reth, the Karst activation timestamp is **not** loaded from the Superchain Registry for `op-sepolia` and `op`. You must configure it manually by providing a genesis file passed via `--chain `. Download the pre-built genesis file and pass it directly — do not edit the file.
  * [Download genesis.json](https://storage.googleapis.com/oplabs-opc-artifacts/chains/op-sepolia/genesis-karst.json).
  * The genesis file must **not** include an `osakaTime` field. The pre-built file linked above is compatible with `op-reth v2.3.1` as-is. Both the SCR loading bug and this restriction will be fixed in a following op-reth release so this won't be necessary for OP Mainnet.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.3.1)
</Update>

<Update label="May 18, 2026" description="v2.2.3" tags={["Stable"]}>
  > \[!IMPORTANT]
  > This release contains support for historical proofs storage format v2. It can be enabled by setting `--proofs-history.storage-version=v2`. Note that the proofs data has to be reinitialized if switching to the new storage version format. See [the docs](https://docs.optimism.io/node-operators/reference/op-reth-historical-proof-config#op-reth-historical-proof-configuration) for further details.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.2.3)
</Update>

<Update label="May 11, 2026" description="v2.2.2" tags={["Stable"]}>
  This is a bug fix release of op-reth.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.2.2)
</Update>

<Update label="May 4, 2026" description="v2.2.1" tags={["Stable"]}>
  > \[!CAUTION]
  > **Recomended upgrade for operators running op-reth v2.0.0 and above with historical proofs activated**
  > This upgrade fixes some errors in op-reth for historical proofs computation and bumps reth to v2.2.0.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.2.1)
</Update>

<Update label="April 29, 2026" description="v2.2.0" tags={["Stable"]}>
  This release includes bug fixes, updates to NUT bundle types, and removes deprecated ProtocolVersions support.

  This version includes Superchain Registry updates for Worldchain and is a required update for that network

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.2.0)
</Update>

<Update label="April 21, 2026" description="v2.1.0" tags={["Stable"]}>
  > \[!IMPORTANT]
  > This is a strongly recommended release as it bumps the underlying reth dependency to its official 2.0.0 release.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.1.0)
</Update>

<Update label="April 15, 2026" description="v2.0.0" tags={["Stable"]}>
  ## Description

  This release ports most of the changes from `reth 2.0` into `op-reth`. It also ports `op-revm` to `ethereum-optimism/optimism`, completing the migration of the op-variants of paradigm/tempo crates to `ethereum-optimism/optimism`.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v2.0.0)
</Update>

<Update label="April 2, 2026" description="v1.11.5" tags={["Stable"]}>
  ## What's Changed in op-reth/v1.11.5

  * fix(proofs-exex): error if state unavailable instead of falling back to historical provider by @dhyaniarun1993 in [#19855](https://github.com/ethereum-optimism/optimism/pull/19855)
  * fix(op-alloy): resolve `NetworkWallet` conflict with alloy 1.8 by @suchapalaver in [#19756](https://github.com/ethereum-optimism/optimism/pull/19756)
  * feat(op-reth): Drop interop transactions after reorg by @wwared in [#19814](https://github.com/ethereum-optimism/optimism/pull/19814)

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v1.11.5)
</Update>

<Update label="March 17, 2026" description="v1.11.3" tags={["Stable"]}>
  > \[!WARNING]
  > **This is an essential bug fix release for all chains. See the upstream release notes ([https://github.com/paradigmxyz/reth/releases/tag/v1.11.1](https://github.com/paradigmxyz/reth/releases/tag/v1.11.1), [https://github.com/paradigmxyz/reth/releases/tag/v1.11.2](https://github.com/paradigmxyz/reth/releases/tag/v1.11.2) and [https://github.com/paradigmxyz/reth/releases/tag/v1.11.3](https://github.com/paradigmxyz/reth/releases/tag/v1.11.3)) for guidance regarding backwards compatibility.**

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v1.11.3)
</Update>

<Update label="February 20, 2026" description="v1.11.0" tags={["Stable"]}>
  ## Description

  First `op-reth` release from the optimism monorepo.

  Major changes:

  * Imports historical proofs generation tooling to `op-reth`

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-reth/v1.11.0)
</Update>