op-contracts contains the L1 and L2 smart contracts for the OP Stack. See the contract reference for interface documentation and architecture details.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.
This is the contracts release for Upgrade 18. 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 to use Kona Proof with the Cannon Fault Proof VM. It does not change the respected game type.
Refer to
op-contracts/v6.0.0 for full release notes for this release (it’s the “finalized” version tag on the same commit).View full release on GitHub →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 →
[!WARNING] TheThis 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 fault proof program in a future release and theop-deployer/justfilefile in this release MUST NOT be used for deployments, as it will result in you deploying with an old MIPS version. Please use the latestop-deployer/v*release instead to deploy contracts contained in this commit
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:View full release on GitHub →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:View full release on GitHub →
This is the
op-contracts release associated with the Upgrade 16a protocol upgrade.For contract versions and implementation addresses in this release, please refer to the superchain-registry:Sepolia versions
Mainnet versionsThe associated governance proposal can be found here. Deployment operations should be executed using the associated op-deployer release.View full release on GitHub →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: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.0View full release on GitHub →This is the op-contracts release intended for the forthcoming Upgrade 16 protocol upgrade.For contract versions and implementation addresses in this release; please refer to the superchain-registry:The associated governance proposal can be found here.Deployment and upgrade operations should be executed using the associated op-deployer release (link to be updated after this PR is merged)View full release on GitHub →
This is the op-contracts release associated with the recently passed Upgrade 16 protocol upgrade.For contract versions and implementation addresses in this release; please refer to the superchain-registry:
- Sepolia versions
- Mainnet versions The associated governance proposal can be found here.
op-deployer release.View full release on GitHub →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 →Overview
This release candidate upgrades the fault proof to use multithreaded Cannon64 and introduces operator fee pricing.View full release on GitHub →Overview
This contracts release updates all of the L1 contracts as part of Upgrade 13, the first OP Contracts Manager upgrade.View full release on GitHub →Overview
This release candidates updates all of the L1 contracts as part of the first OP Contracts Manager upgrade.View full release on GitHub →Overview
This release is suitable for the L1 contracts as part of the Holocene network upgrade.View full release on GitHub →Overview
This release is suitable for the L1 contracts as part of the Holocene network upgrade.View full release on GitHub →Overview
This release is suitable for the L1 contracts as part of the Holocene network upgrade.View full release on GitHub →Overview
This release is suitable for the L1 contracts as part of the Holocene network upgrade.View full release on GitHub →Overview
This release is suitable for generating L2 genesis. The L1 contract deployments should be done with another release.View full release on GitHub →Overview
This set of contracts includes the Custom Gas Token feature. The tagged commit includes updates in which theplasma feature was renamed to AltDA, therefore this release is compatible with the new AltDA configurations.View full release on GitHub →