> ## Documentation Index
> Fetch the complete documentation index at: https://docs.optimism.io/llms.txt
> Use this file to discover all available pages before exploring further.

# op-contracts Releases

> Release history for op-contracts. OP Stack L1 and L2 smart contracts.

**op-contracts** contains the L1 and L2 smart contracts for the OP Stack. See the [contract reference](https://devdocs.optimism.io/contracts-bedrock) for interface documentation and architecture details.

<Update label="May 29, 2026" description="v7.0.0-rc.4" tags={["Release Candidate"]}>
  ## What's Changed in op-contracts/v7.0.0-rc.4

  * feat(contracts-bedrock): scale ResourceConfig to fit smaller gasLimits (v7.0.0)
  * Merge pull request #20981 from ethereum-optimism/jm/revert-xlayer-layout-fix
  * Revert "fix(l2cm): preserve XLayer LiquidityController minters across upgrade "
  * fix(l2cm): preserve XLayer LiquidityController minters across upgrade
  * fix: filter prerelease OPCM release tags (cherry-pick of #20617)
  * feat: make l2cm default path in devfeature bitmap
  * chore(ci): clean up contracts CI and RPC secrets
  * fix(contracts): reject oz v5 initializable in opcm
  * chore(rust/scr): update superchain registry for rust crates
  * feat: zk go deployer
  * fix(contracts): fail closed resolving semver target branch
  * chore(contracts-bedrock): drop v1 mention from \_decodeDisputeGameImpl natspec
  * interop: add OPContractsManagerMigrationValidator for post-migration validation
  * fix(op-fetcher): guard against zero mipsImpl before calling oracle()
  * chore(contracts-bedrock): fix contract typos
  * Revert "chore(rust): bump revm to 38 "
  * Revert "Delete .circleci/Untitled "
  * docs(opcm): acknowledge Initializable upgrade limitations
  * test(contracts): cover VerifyOPCM runSingle lazy setup
  * fix: ZK Game Quality Review Fixes
  * chore(rust): bump revm to 38
  * test: add ZKDisputeGame unit and integration test coverage
  * fix(contracts-bedrock): skip lint fix during CI
  * Delete .circleci/Untitled
  * feat(contracts): enforce EIP-7825 gas cap in NUT bundle validation
  * feat(l2cm): support X Layer LiquidityController in L2CM upgrade path
  * feat: add SP1Adapter
  * fix: add intrinsic gas deduction to l2 fork tests
  * chore(contracts): remove 7 unreferenced interfaces
  * test(contracts): skip VerifyOPCM\_Run\_Test on coverage only, not unoptimized
  * chore(contracts): remove unused SchemaResolver abstract base
  * fix(contracts): skip ZKDisputeGame in VerifyOPCM when feature disabled
  * refactor: revenue share cleanup
  * fix: l2cm fma followup
  * feat: opcm zk roots
  * chore(deployer): remove OPCMv1 migration, upgrade, and dev feature code
  * contracts: delete unused interop contracts
  * fix(l2cm): guard CGT feature activation and liquidity controller renounce ownership

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

<Update label="March 16, 2026" description="v6.0.0" tags={["Latest", "Stable"]}>
  This is the contracts release for [Upgrade 18](https://gov.optimism.io/t/upgrade-18-custom-gas-token-v2-and-kona-proofs/10576). The main changes in this release are:

  * Custom Gas Token v2: gated behind the CUSTOM\_GAS\_TOKEN feature flag in SystemConfig and is intended for new chains that enable it at deployment.
  * Creator Pattern Dispute Game Refactor: efficient deployment of dispute game contracts, allowing one single implementation to be used for all chains (which is then cloned and configured separately for each chain).
  * Cannon + Kona: This upgrade adds a [new game type](https://github.com/ethereum-optimism/optimism/blob/b9dc5808f61c160de048fb7db39a04fe4fba4574/packages/contracts-bedrock/src/dispute/lib/Types.sol#L76-L77) to use [Kona Proof](https://github.com/ethereum-optimism/optimism/tree/develop/kona/crates/proof/proof) with the Cannon [Fault Proof VM](https://specs.optimism.io/fault-proof/index.html#fault-proof-vm). It does not change the respected game type.

  The audit results [are published here](https://github.com/ethereum-optimism/optimism/blob/develop/docs/security-reviews/2026_01-U18-Cantina.pdf).

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

<Update label="January 16, 2026" description="v6.0.0-rc.2" tags={["Release Candidate"]}>
  Refer to [`op-contracts/v6.0.0`](https://github.com/ethereum-optimism/optimism/releases/tag/op-contracts%2Fv6.0.0) for full release notes for this release (it's the "finalized" version tag on the same commit).

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

<Update label="December 19, 2025" description="v5.0.0+l2-rev-share-contracts" tags={["Release Candidate"]}>
  ## Overview

  This release introduces **Revenue Sharing**, an opt-in mechanism for configurable distribution of L2 transaction fees between Optimism and chain operators.

  ***

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-contracts/v5.0.0%2Bl2-rev-share-contracts)
</Update>

<Update label="October 28, 2025" description="v5.0.0" tags={["Stable"]}>
  > \[!WARNING]
  > The `op-deployer/justfile` file in this release MUST NOT be used for deployments, as it will result in you deploying with an old MIPS version. Please use the latest `op-deployer/v*` release instead to deploy contracts contained in this commit

  This release adds support for configuring the minimum base fee and DA footprint gas scalar variables, which affect features activating with the Jovian hardfork.

  Cannon has been updated to support versions of op-program that are compiled with Go 1.24.

  The OPCM version includes changes to prepare for supporting the [Kona](https://github.com/op-rs/kona) fault proof program in a future release and the `CANNON_KONA` game type has been added.

  For details of individual contract versions and standard deployments, please see the below links in the superchain registry:

  * [Sepolia](https://github.com/ethereum-optimism/superchain-registry/blob/80818cd29c28a37be79e2f31fe5cd2a8254fc58c/validation/standard/standard-versions-sepolia.toml#L6-L25)
  * [Mainnet](https://github.com/ethereum-optimism/superchain-registry/blob/80818cd29c28a37be79e2f31fe5cd2a8254fc58c/validation/standard/standard-versions-mainnet.toml#L6-L25)

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

<Update label="October 27, 2025" description="v5.0.0-rc.2" tags={["Release Candidate"]}>
  This release adds support for configuring the minimum base fee and DA footprint gas scalar variables, which affect features activating with the Jovian hardfork. It also includes support for Go 1.24 in the Cannon fault proof VM.

  For details of individual contract versions and standard deployments, please see the below links in the superchain registry:

  * [Sepolia](https://github.com/ethereum-optimism/superchain-registry/blob/0cc526c0acdfffac5b1966bf7465406e41f33b00/validation/standard/standard-versions-sepolia.toml#L6-L25)
  * [Mainnet](https://github.com/ethereum-optimism/superchain-registry/blob/0cc526c0acdfffac5b1966bf7465406e41f33b00/validation/standard/standard-versions-mainnet.toml#L6-L25)

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

<Update label="October 2, 2025" description="v4.1.0" tags={["Stable"]}>
  This is the `op-contracts` release associated with the [Upgrade 16a protocol upgrade](https://docs.optimism.io/notices/upgrade-16a).

  For contract versions and implementation addresses in this release, please refer to the superchain-registry:

  [Sepolia versions](https://github.com/ethereum-optimism/superchain-registry/blob/df4e953b384b7fb6dad14676fc5d9a9a994e5748/validation/standard/standard-versions-sepolia.toml#L7)
  [Mainnet versions](https://github.com/ethereum-optimism/superchain-registry/blob/df4e953b384b7fb6dad14676fc5d9a9a994e5748/validation/standard/standard-versions-mainnet.toml#L7)

  The associated governance proposal can be found [here](https://gov.optimism.io/t/maintenance-upgrade-proposal-u16a/10288). Deployment operations should be executed using the associated op-deployer release.

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

<Update label="August 15, 2025" description="v2.2.0" tags={["Stable"]}>
  This `op-contracts` release modifies the `op-contracts/v2.0.0` OPCM.

  It removes the conditional upgrades of the SuperchainConfig and protocol versions proxies which currently prevents chains that are at `op-contracts/v1.8.0` from upgrading their contracts via the `v2.0.0` OPCM.

  Chains which use their own SuperchainConfig, rather than sharing it with OP Mainnet or OP Sepolia, should continue to use the OPCM  from `op-contracts/v2.0.0`.

  For contract versions and implementation addresses in this release; please refer to the superchain-registry:

  * [Sepolia versions](https://github.com/ethereum-optimism/superchain-registry/blob/802e9b18739ae1a674fc609ca3a51e556b128b97/validation/standard/standard-versions-mainnet.toml#L145)
  * [Mainnet versions](https://github.com/ethereum-optimism/superchain-registry/blob/802e9b18739ae1a674fc609ca3a51e556b128b97/validation/standard/standard-versions-sepolia.toml#L145)

  Deployment operations should be executed using the associated `op-deployer` release.

  **Full Changelog**: [https://github.com/ethereum-optimism/optimism/compare/op-contracts/v2.0.0...op-contracts/v2.2.0](https://github.com/ethereum-optimism/optimism/compare/op-contracts/v2.0.0...op-contracts/v2.2.0)

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

<Update label="June 19, 2025" description="v4.0.0-rc.8" tags={["Release Candidate"]}>
  This is the op-contracts release intended for the forthcoming [Upgrade 16 protocol upgrade](https://docs.optimism.io/notices/upgrade-16).

  For contract versions and implementation addresses in this release; please refer to the superchain-registry:

  * [Sepolia versions](https://github.com/ethereum-optimism/superchain-registry/blob/6b65f330434d46e24abc9ef78852ac3fa1cba4ec/validation/standard/standard-versions-sepolia.toml#L7)
  * [Mainnet versions](https://github.com/ethereum-optimism/superchain-registry/blob/6b65f330434d46e24abc9ef78852ac3fa1cba4ec/validation/standard/standard-versions-mainnet.toml#L7)

  The associated governance proposal can be found [here](https://gov.optimism.io/t/upgrade-16-proposal-interop-contracts-stage-1-and-go-1-23-support-in-cannon/10037).

  Deployment and upgrade operations should be executed using the associated op-deployer release (link to be updated after [this PR](https://github.com/ethereum-optimism/superchain-registry/pull/1079) is merged)

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

<Update label="July 21, 2025" description="v4.0.0" tags={["Stable"]}>
  This is the op-contracts release associated with the recently passed [Upgrade 16 protocol upgrade](https://docs.optimism.io/notices/upgrade-16).

  For contract versions and implementation addresses in this release; please refer to the superchain-registry:

  * [Sepolia versions](https://github.com/ethereum-optimism/superchain-registry/blob/6b65f330434d46e24abc9ef78852ac3fa1cba4ec/validation/standard/standard-versions-sepolia.toml#L7)
  * [Mainnet versions](https://github.com/ethereum-optimism/superchain-registry/blob/6b65f330434d46e24abc9ef78852ac3fa1cba4ec/validation/standard/standard-versions-mainnet.toml#L7)
    The associated governance proposal can be found [here](https://gov.optimism.io/t/upgrade-16-proposal-interop-contracts-stage-1-and-go-1-23-support-in-cannon/10037).

  Deployment operations should be executed using the associated `op-deployer` release.

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

<Update label="May 8, 2025" description="v3.0.0" tags={["Stable"]}>
  # Overview

  This release upgrades the fault proof to use multithreaded Cannon64 and introduces operator fee pricing. It updates the addresses for the EIP-2935 predeploys.

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

<Update label="March 7, 2025" description="v3.0.0-rc.1" tags={["Release Candidate"]}>
  # Overview

  This release candidate upgrades the fault proof to use multithreaded Cannon64 and introduces operator fee pricing.

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

<Update label="April 2, 2025" description="v2.0.0" tags={["Stable"]}>
  # Overview

  This contracts release updates all of the L1 contracts as part of [Upgrade 13](https://gov.optimism.io/t/upgrade-proposal-13-opcm-and-incident-response-improvements/9739), the first OP Contracts Manager upgrade.

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

<Update label="February 25, 2025" description="v2.0.0-rc.1" tags={["Release Candidate"]}>
  # Overview

  This release candidates updates all of the L1 contracts as part of the first OP Contracts Manager upgrade.

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

<Update label="January 10, 2025" description="v1.8.0" tags={["Stable"]}>
  # Overview

  This release is suitable for the L1 contracts as part of the Holocene network upgrade.

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

<Update label="November 25, 2024" description="v1.8.0-rc.3" tags={["Release Candidate"]}>
  # Overview

  This release is suitable for the L1 contracts as part of the Holocene network upgrade.

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

<Update label="November 19, 2024" description="v1.8.0-rc.2" tags={["Release Candidate"]}>
  # Overview

  This release is suitable for the L1 contracts as part of the Holocene network upgrade.

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

<Update label="November 6, 2024" description="v1.8.0-rc.1" tags={["Release Candidate"]}>
  # Overview

  This release is suitable for the L1 contracts as part of the Holocene network upgrade.

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

<Update label="September 16, 2024" description="v.1.7.0-beta.1+l2-contracts" tags={["Release Candidate"]}>
  # Overview

  This release is suitable for generating L2 genesis. The L1 contract deployments should be done with another release.

  [View full release on GitHub →](https://github.com/ethereum-optimism/optimism/releases/tag/op-contracts/v.1.7.0-beta.1%2Bl2-contracts)
</Update>

<Update label="September 13, 2024" description="v2.0.0-beta.3" tags={["Release Candidate"]}>
  ## Overview

  This set of contracts includes the Custom Gas Token feature.  The tagged commit includes updates in which the `plasma` feature was renamed to `AltDA`, therefore this release is compatible with the new `AltDA` configurations.

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