Skip to main content

Documentation Index

Fetch the complete documentation index at: https://base-a060aa97-roethke-refactor-docs-icp.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

Changelog

This section tracks configuration changes to the Base networks, including updates to block building, network fees, and other network parameters.

Base Mainnet

DateChangeDocumentation
February 19, 2026Increased Minimum Base Fee to 5,000,000 weiMinimum Base Fee
February 4, 2026Increased EIP-1559 Denominator to 125EIP-1559 Fee Parameters
February 2, 2026Increased Minimum Base Fee to 2,000,000 weiMinimum Base Fee
January 22, 2026Increased Minimum Base Fee to 1,000,000 weiMinimum Base Fee
December 18, 2025Increased Minimum Base Fee to 500,000 weiMinimum Base Fee
December 4, 2025Enabled Minimum Base Fee (200,000 wei)Minimum Base Fee
September 17, 2025Enabled Per-Transaction Gas MaximumPer-Transaction Gas Maximum
September 11, 2025Ended testing Per-Transaction Gas MaximumPer-Transaction Gas Maximum
September 10, 2025Started testing Per-Transaction Gas MaximumPer-Transaction Gas Maximum
July 7, 2025Enabled FlashblocksFlashblocks
May 15, 2025Ended testing FlashblocksFlashblocks
May 15, 2025Started testing FlashblocksFlashblocks

Base Sepolia

DateChangeDocumentation
February 19, 2026Increased Minimum Base Fee to 5,000,000 weiMinimum Base Fee
February 10, 2026Increased EIP-1559 Denominator to 125EIP-1559 Fee Parameters
February 10, 2026Increased Minimum Base Fee to 2,000,000 weiMinimum Base Fee
November 20, 2025Enabled Minimum Base Fee (200,000 wei)Minimum Base Fee
September 3, 2025Enabled Per-Transaction Gas MaximumPer-Transaction Gas Maximum
February 25, 2025Enabled FlashblocksFlashblocks