Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Configuration

There are four categories of Base configuration:

  • Consensus Parameters: Fixed at genesis or changeable through privileged accounts or protocol upgrades.
  • Policy Parameters: Changeable without breaking consensus, within protocol-imposed constraints.
  • Admin Roles: Accounts that can upgrade contracts, change role owners, or update protocol parameters. Typically cold/multisig wallets.
  • Service Roles: Accounts used for day-to-day operations. Typically hot wallets.

Consensus Parameters

ParameterDescriptionAdministrator
Batch Inbox AddressL1 address where batcher transactions are postedStatic
Batcher HashVersioned hash of the authorized batcher sender(s)System Config Owner
Chain IDUnique chain ID for transaction signature validationStatic
Proof Maturity DelayTime between proving and finalizing a withdrawal. 7 days.L1 Proxy Admin
Dispute Game FinalityTime for Guardian to blacklist a game before withdrawals finalize. 3.5 days.L1 Proxy Admin
Respected Game TypeGame type OptimismPortal accepts for withdrawal finalization. CANNON (0); may fall back to PERMISSIONED_CANNON (1).Guardian
Fault Game Max DepthMaximum depth of fault dispute game trees. 73.Static
Fault Game Split DepthDepth after which claims correspond to VM state commitments. 30.Static
Max Game Clock DurationMaximum time on a dispute game team's chess clock. 3.5 days.Static
Game Clock ExtensionClock credit when a team's remaining time falls below CLOCK_EXTENSION. 3 hours.Static
Bond Withdrawal DelayTime before dispute game bonds can be withdrawn. 7 days.Static
Min Large Preimage SizeMinimum preimage size for the PreimageOracle large proposal process. 126,000 bytes.Static
Large Preimage Challenge PeriodChallenge window before large preimage proposals are published. 24 hours.Static
Fault Game Absolute PrestateVM state commitment used as the fault proof VM starting pointStatic
Fault Game Genesis BlockInitial anchor state block number. Any finalized block between bedrock and fault proof activation; 0 from genesis.Static
Fault Game Genesis Output RootOutput root at the Fault Game Genesis BlockStatic
Fee ScalarMarkup on transactions relative to raw L1 data cost. Fee margin between 0%–50%.System Config Owner
Gas LimitL2 block gas limit. ≤ 200,000,000 gas.System Config Owner
Genesis StateInitial chain state including all predeploy code and storage. Standard predeploys and preinstalls only.Static
L2 Block TimeInterval at which L2 blocks are produced via derivation. 1 or 2 seconds.L1 Proxy Admin
Sequencing Window SizeMax batch submission gap before L1 fallback triggers. 3,600 L1 blocks (12 hours at 12s L1 block time).Static
Start BlockL1 block where SystemConfig was first initializedL1 Proxy Admin
Superchain TargetSuperchainConfig and ProtocolVersions addresses for cross-L2 config. Mainnet or Sepolia.Static
Governance TokenOP governance token. Disabled.n/a
Operator Fee ParamsOperator fee scalar and constant for fee calculation. Standard values are 0; non-zero for non-standard configurations such as op-succinct.System Config Owner
DA Footprint Gas ScalarScalar for DA footprint calculationSystem Config Owner
Minimum Base FeeMinimum base fee on L2System Config Owner

Policy Parameters

ParameterDescriptionAdministrator
Data Availability TypeWhether the batcher posts data as blobs or calldata. Ethereum (Blobs or Calldata); Alt-DA not supported.Batch Submitter
Batch Submission FrequencyFrequency of batcher transaction submissions to L1. ≤ 1,800 L1 blocks (6 hours at 12s L1 block time).Batch Submitter
Output FrequencyFrequency of output root submissions to L1. ≤ 43,200 L2 blocks (24 hours at 2s L2 block time); must be non-zero. Deprecated once fault proofs are enabled.L1 Proxy Admin

Admin Roles

RoleDescriptionAdministers
L1 Proxy AdminProxyAdmin from the latest op-contracts release, authorized to upgrade L1 contractsL1 contracts
L1 ProxyAdmin OwnerAuthorized to update the L1 Proxy Admin. 0x5a0Aae59D09fccBdDb6C6CcEB07B7279367C3d2AL1 Proxy Admin
L2 Proxy AdminProxyAdmin at 0x4200000000000000000000000000000000000018, authorized to upgrade L2 contractsPredeploys
L2 ProxyAdmin OwnerAliased L1 ProxyAdmin Owner; upgrades L2 contracts via ProxyAdmin. 0x6B1BAE59D09fCcbdDB6C6cceb07B7279367C4E3bL2 Proxy Admin
System Config OwnerAuthorized to change values in the SystemConfig contractBatch Submitter, Sequencer P2P Signer, Fee Scalar, Gas Limit

Service Roles

RoleDescriptionAdministrator
Batch SubmitterAuthenticates batches submitted to L1System Config Owner
ChallengerInteracts with permissioned dispute games. Active only when respected game type is PERMISSIONED_CANNON. 0x9BA6e03D8B90dE867373Db8cF1A58d2F7F006b3AL1 Proxy Admin
GuardianPauses L1 withdrawals, blacklists dispute games, sets respected game type in OptimismPortal. 0x09f7150D8c019BeF34450d6920f6B3608ceFdAf2L1 Proxy Admin
ProposerCreates permissioned dispute games on L1. Active only when respected game type is PERMISSIONED_CANNON.L1 Proxy Admin
Sequencer P2P SignerSigns unsafe/pre-submitted blocks at the P2P layerSystem Config Owner