@arbitrum/nitro-contracts 3.1.0 → 3.2.0-beta.0

package/src/precompiles/ArbOwner.sol

@@ -33,6 +33,34 @@ interface ArbOwner {
     /// @notice Retrieves the list of chain owners
     function getAllChainOwners() external view returns (address[] memory);
 
+    /// @notice Sets the NativeTokenManagementFrom time
+    /// @notice Available in ArbOS version 41 and above
+    function setNativeTokenManagementFrom(
+        uint64 timestamp
+    ) external;
+
+    /// @notice Add account as a native token owner
+    /// @notice Available in ArbOS version 41 and above
+    function addNativeTokenOwner(
+        address newOwner
+    ) external;
+
+    /// @notice Remove account from the list of native token owners
+    /// @notice Available in ArbOS version 41 and above
+    function removeNativeTokenOwner(
+        address ownerToRemove
+    ) external;
+
+    /// @notice See if the user is a native token owner
+    /// @notice Available in ArbOS version 41 and above
+    function isNativeTokenOwner(
+        address addr
+    ) external view returns (bool);
+
+    /// @notice Retrieves the list of native token owners
+    /// @notice Available in ArbOS version 41 and above
+    function getAllNativeTokenOwners() external view returns (address[] memory);
+
     /// @notice Set how slowly ArbOS updates its estimate of the L1 basefee
     function setL1BaseFeeEstimateInertia(
         uint64 inertia
@@ -49,21 +77,33 @@ interface ArbOwner {
     ) external;
 
     /// @notice Set the computational speed limit for the chain
+    /// @notice Starting from ArbOS version 50, continues to set the legacy single-constraint speed limit value.
+    /// @notice It does not modify the multi-constraint pricing model configuration. To configure multiple constraints, use `setGasPricingConstraints`.
     function setSpeedLimit(
         uint64 limit
     ) external;
 
-    /// @notice Set the maximum size a tx (and block) can be
+    /// @notice Set the maximum size a tx can be
     function setMaxTxGasLimit(
         uint64 limit
     ) external;
 
+    /// @notice Set the maximum size a block can be
+    /// @notice Available in ArbOS version 50 and above
+    function setMaxBlockGasLimit(
+        uint64 limit
+    ) external;
+
     /// @notice Set the L2 gas pricing inertia
+    /// @notice Starting from ArbOS version 50, continues to set the single-constraint pricing inertia value.
+    /// @notice It does not modify the multi-constraint pricing model configuration. To configure multiple constraints, use `setGasPricingConstraints`.
     function setL2GasPricingInertia(
         uint64 sec
     ) external;
 
     /// @notice Set the L2 gas backlog tolerance
+    /// @notice Starting from ArbOS version 50, continues to set the single-constraint backlog tolerance value.
+    /// @notice It does not modify the multi-constraint pricing model configuration. There is no tolerance for backlogged gas in the new multi-constraint pricing model.
     function setL2GasBacklogTolerance(
         uint64 sec
     ) external;
@@ -72,6 +112,7 @@ interface ArbOwner {
     function getNetworkFeeAccount() external view returns (address);
 
     /// @notice Get the infrastructure fee collector
+    /// @notice Available in ArbOS version 5 and above
     function getInfraFeeAccount() external view returns (address);
 
     /// @notice Set the network fee collector
@@ -80,6 +121,7 @@ interface ArbOwner {
     ) external;
 
     /// @notice Set the infrastructure fee collector
+    /// @notice Available in ArbOS version 5 and above
     function setInfraFeeAccount(
         address newInfraFeeAccount
     ) external;
@@ -112,15 +154,19 @@ interface ArbOwner {
         uint256 pricePerUnit
     ) external;
 
+    /// @notice Set how much L1 charges per non-zero byte of calldata
+    /// @notice Available in ArbOS version 50 and above
+    function setParentGasFloorPerToken(
+        uint64 floorPerToken
+    ) external;
+
     /// @notice Sets the base charge (in L1 gas) attributed to each data batch in the calldata pricer
     function setPerBatchGasCharge(
         int64 cost
     ) external;
 
-    /**
-     * @notice Sets the Brotli compression level used for fast compression
-     * Available in ArbOS version 12 with default level as 1
-     */
+    /// @notice Sets the Brotli compression level used for fast compression
+    /// @notice Available in ArbOS version 20 and above
     function setBrotliCompressionLevel(
         uint64 level
     ) external;
@@ -131,90 +177,131 @@ interface ArbOwner {
     ) external;
 
     /// @notice Releases surplus funds from L1PricerFundsPoolAddress for use
+    /// @notice Available in ArbOS version 10 and above
     function releaseL1PricerSurplusFunds(
         uint256 maxWeiToRelease
     ) external returns (uint256);
 
     /// @notice Sets the amount of ink 1 gas buys
+    /// @notice Available in ArbOS version 30 and above
     /// @param price the conversion rate (must fit in a uint24)
     function setInkPrice(
         uint32 price
     ) external;
 
     /// @notice Sets the maximum depth (in wasm words) a wasm stack may grow
+    /// @notice Available in ArbOS version 30 and above
     function setWasmMaxStackDepth(
         uint32 depth
     ) external;
 
     /// @notice Sets the number of free wasm pages a tx gets
+    /// @notice Available in ArbOS version 30 and above
     function setWasmFreePages(
         uint16 pages
     ) external;
 
     /// @notice Sets the base cost of each additional wasm page
+    /// @notice Available in ArbOS version 30 and above
     function setWasmPageGas(
         uint16 gas
     ) external;
 
     /// @notice Sets the maximum number of pages a wasm may allocate
+    /// @notice Available in ArbOS version 30 and above
     function setWasmPageLimit(
         uint16 limit
     ) external;
 
     /// @notice Sets the maximum size of the uncompressed wasm code in bytes
+    /// @notice Available in ArbOS version 30 and above
     function setWasmMaxSize(
         uint32 size
     ) external;
 
     /// @notice Sets the minimum costs to invoke a program
+    /// @notice Available in ArbOS version 30 and above
     /// @param gas amount of gas paid in increments of 256 when not the program is not cached
     /// @param cached amount of gas paid in increments of 64 when the program is cached
     function setWasmMinInitGas(uint8 gas, uint16 cached) external;
 
     /// @notice Sets the linear adjustment made to program init costs.
+    /// @notice Available in ArbOS version 30 and above
     /// @param percent the adjustment (100% = no adjustment).
     function setWasmInitCostScalar(
         uint64 percent
     ) external;
 
     /// @notice Sets the number of days after which programs deactivate
+    /// @notice Available in ArbOS version 30 and above
     function setWasmExpiryDays(
         uint16 _days
     ) external;
 
     /// @notice Sets the age a program must be to perform a keepalive
+    /// @notice Available in ArbOS version 30 and above
     function setWasmKeepaliveDays(
         uint16 _days
     ) external;
 
     /// @notice Sets the number of extra programs ArbOS caches during a given block
+    /// @notice Available in ArbOS version 30 and above
     function setWasmBlockCacheSize(
         uint16 count
     ) external;
 
     /// @notice Adds account as a wasm cache manager
+    /// @notice Available in ArbOS version 30 and above
     function addWasmCacheManager(
         address manager
     ) external;
 
     /// @notice Removes account from the list of wasm cache managers
+    /// @notice Available in ArbOS version 30 and above
     function removeWasmCacheManager(
         address manager
     ) external;
 
     /// @notice Sets serialized chain config in ArbOS state
+    /// @notice Available in ArbOS version 11 and above
     function setChainConfig(
         string calldata chainConfig
     ) external;
 
-    /**
-     * @notice Sets the increased calldata price feature on or off (EIP-7623)
-     * Available in ArbOS version 40 with default as false
-     */
+    /// @notice Sets the increased calldata price feature on or off (EIP-7623)
+    /// @notice Available in ArbOS version 40 and above with default as false
     function setCalldataPriceIncrease(
         bool enable
     ) external;
 
+    /// @notice Set the backlogged amount of gas burnt used by the single-constraint pricing model only.
+    /// @notice To configure backlogs for the multi-constraint pricing model, use `setGasPricingConstraints()`.
+    /// @param backlog The backlog value in gas units to assign to the single-constraint pricing model.
+    function setGasBacklog(
+        uint64 backlog
+    ) external;
+
+    /// @notice Sets the list of gas pricing constraints for the multi-constraint pricing model.
+    /// @notice Replaces the existing constraints configuration and sets each constraint's starting backlog value.
+    /// @notice All existing backlogs are replaced by the provided values.
+    /// @notice Any changes to gas targets, inertia, or starting backlogs may cause immediate price fluctuations.
+    /// @notice Operators are fully responsible for the resulting behavior and should adjust parameters carefully.
+    /// @notice Use `ArbGasInfo.getGasPricingConstraints()` to retrieve the current configuration.
+    /// @notice Model selection:
+    /// @notice - If one or more constraints are provided, the chain switches to the multi-constraint pricing model
+    /// @notice   and uses exactly the provided parameters.
+    /// @notice - If zero constraints are provided, the chain uses the single-constraint pricing model.
+    /// @notice   In that case, the single-constraint backlog can be set via `setBacklog`, which you may derive from multi-constraint
+    /// @notice   parameters if desired.
+    /// @notice Available in ArbOS version 50 and above.
+    /// @param constraints Array of triples (gas_target_per_second, adjustment_window_seconds, starting_backlog_value)
+    ///        - gas_target_per_second: target gas usage per second for the constraint (uint64, gas/sec)
+    ///        - adjustment_window_seconds: time over which the price will rise by a factor of e if demand is 2x the target (uint64, seconds)
+    ///        - starting_backlog_value: initial backlog for this constraint (uint64, gas units)
+    function setGasPricingConstraints(
+        uint64[3][] calldata constraints
+    ) external;
+
     /// Emitted when a successful call is made to this precompile
     event OwnerActs(bytes4 indexed method, address indexed owner, bytes data);
 }

package/src/precompiles/ArbOwnerPublic.sol

@@ -12,11 +12,9 @@ interface ArbOwnerPublic {
         address addr
     ) external view returns (bool);
 
-    /**
-     * @notice Rectify the list of chain owners
-     * If successful, emits ChainOwnerRectified event
-     * Available in ArbOS version 11
-     */
+    /// @notice Rectify the list of chain owners
+    /// @notice If successful, emits ChainOwnerRectified event
+    /// @notice Available in ArbOS version 11 and above
     function rectifyChainOwner(
         address ownerToRectify
     ) external;
@@ -24,6 +22,21 @@ interface ArbOwnerPublic {
     /// @notice Retrieves the list of chain owners
     function getAllChainOwners() external view returns (address[] memory);
 
+    /// @notice Retrieves the timestamp from when the native token management
+    /// modifications are enabled.
+    /// @notice Available in ArbOS version 50 and above
+    function getNativeTokenManagementFrom() external view returns (uint64);
+
+    /// @notice See if the user is a native token owner
+    /// @notice Available in ArbOS version 41 and above
+    function isNativeTokenOwner(
+        address addr
+    ) external view returns (bool);
+
+    /// @notice Retrieves the list of native token owners
+    /// @notice Available in ArbOS version 41 and above
+    function getAllNativeTokenOwners() external view returns (address[] memory);
+
     /// @notice Gets the network fee collector
     function getNetworkFeeAccount() external view returns (address);
 
@@ -31,20 +44,23 @@ interface ArbOwnerPublic {
     function getInfraFeeAccount() external view returns (address);
 
     /// @notice Get the Brotli compression level used for fast compression
+    /// @notice Available in ArbOS version 20 and above
     function getBrotliCompressionLevel() external view returns (uint64);
 
+    /// @notice Get how much L1 charges per non-zero byte of calldata
+    /// @notice Available in ArbOS version 50 and above
+    function getParentGasFloorPerToken() external view returns (uint64);
+
     /// @notice Get the next scheduled ArbOS version upgrade and its activation timestamp.
-    /// Returns (0, 0) if no ArbOS upgrade is scheduled.
-    /// Available in ArbOS version 20.
+    /// @notice Returns (0, 0) if no ArbOS upgrade is scheduled.
+    /// @notice Available in ArbOS version 20 and above
     function getScheduledUpgrade()
         external
         view
         returns (uint64 arbosVersion, uint64 scheduledForTimestamp);
 
-    /**
-     * @notice Checks if the increased calldata price feature (EIP-7623) is enabled
-     * Available in ArbOS version 40 with default as false
-     */
+    /// @notice Checks if the increased calldata price feature (EIP-7623) is enabled
+    /// @notice Available in ArbOS version 40 with default as false
     function isCalldataPriceIncreaseEnabled() external view returns (bool);
 
     event ChainOwnerRectified(address rectifiedOwner);

package/src/precompiles/ArbWasm.sol

@@ -7,6 +7,7 @@ pragma solidity >=0.4.21 <0.9.0;
 /**
  * @title Methods for managing user programs
  * @notice Precompiled contract that exists in every Arbitrum chain at 0x0000000000000000000000000000000000000071.
+ * @notice Available in ArbOS version 30 and above
  */
 interface ArbWasm {
     /// @notice Activate a wasm program

package/src/precompiles/ArbWasmCache.sol

@@ -7,6 +7,7 @@ pragma solidity >=0.4.21 <0.9.0;
 /**
  * @title Methods for managing Stylus caches
  * @notice Precompiled contract that exists in every Arbitrum chain at 0x0000000000000000000000000000000000000072.
+ * @notice Available in ArbOS version 30 and above
  */
 interface ArbWasmCache {
     /// @notice See if the user is a cache manager.
@@ -19,6 +20,7 @@ interface ArbWasmCache {
     function allCacheManagers() external view returns (address[] memory managers);
 
     /// @dev Deprecated, replaced with cacheProgram
+    /// @notice Available in ArbOS version 30 only
     function cacheCodehash(
         bytes32 codehash
     ) external;
@@ -27,6 +29,7 @@ interface ArbWasmCache {
     /// @notice Reverts if the programs have expired.
     /// @notice Caller must be a cache manager or chain owner.
     /// @notice If you're looking for how to bid for position, interact with the chain's cache manager contract.
+    /// @notice Available in ArbOS version 31 and above
     function cacheProgram(
         address addr
     ) external;

package/src/precompiles/ArbosActs.sol

@@ -44,5 +44,15 @@ interface ArbosActs {
         uint256 l1BaseFeeWei
     ) external;
 
+    function batchPostingReportV2(
+        uint256 batchTimestamp,
+        address batchPosterAddress,
+        uint64 batchNumber,
+        uint64 batchCalldataLength,
+        uint64 batchCalldataNonZeros,
+        uint64 batchExtraGas,
+        uint256 l1BaseFeeWei
+    ) external;
+
     error CallerNotArbOS();
 }

package/src/precompiles/LICENSE.md

@@ -0,0 +1,116 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Offchain Labs
+
+Licensed Work:        Arbitrum Nitro Contracts
+                      The Licensed Work is (c) 2021-2024 Offchain Labs
+
+Additional Use Grant: You may use the Licensed Work in a production environment solely
+                      to provide a point of interface to permit end users or applications
+                      utilizing the Covered Arbitrum Chains to interact and query the
+                      state of a Covered Arbitrum Chain, including without limitation
+                      validating the correctness of the posted chain state, or to deploy
+                      and operate (x) a blockchain that settles to a Covered Arbitrum Chain
+                      or (y) a blockchain in accordance with, and subject to, the [Arbitrum
+                      Expansion Program Term of Use](https://docs.arbitrum.foundation/aep/ArbitrumExpansionProgramTerms.pdf). For purposes of this
+                      Additional Use Grant, the "Covered Arbitrum Chains" are 
+                      (a) Arbitrum One (chainid:42161), Arbitrum Nova (chainid:42170), 
+                      Arbitrum Rinkeby testnet/Rinkarby (chainid:421611),Arbitrum Nitro
+                      Goerli testnet (chainid:421613), and Arbitrum Sepolia Testnet
+                      (chainid:421614); (b) any future blockchains authorized to be
+                      designated as Covered Arbitrum Chains by the decentralized autonomous
+                      organization governing the Arbitrum network; and (c) any “Layer 3”
+                      Arbitrum-based blockchain that is built on and settles to another
+                      Covered Arbitrum Chain.
+
+
+
+Change Date:          Dec 31, 2028
+
+Change License:       Apache License Version 2.0
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/src/precompiles/README.md

@@ -0,0 +1,11 @@
+# Nitro Precompile Interfaces
+
+Solidity interfaces for Arbitrum Nitro precompiled contracts.
+
+## Overview
+
+This repository contains the Solidity interface definitions for Arbitrum Nitro's precompiled contracts.
+
+## License
+
+Licensed under BUSL-1.1. See individual files for specific license information.

package/src/precompiles/foundry.toml

@@ -0,0 +1,20 @@
+[profile.default]
+src = ''
+
+[fmt]
+line_length = 100
+tab_width = 4
+bracket_spacing = false
+int_types = "long"
+multiline_func_header = "params_first"
+quote_style = "double"
+number_underscore = "preserve"
+hex_underscore = "remove"
+single_line_statement_blocks = "preserve"
+override_spacing = false
+wrap_comments = false
+ignore = []
+contract_new_lines = false
+sort_imports = false
+
+# See more config options https://github.com/foundry-rs/foundry/tree/master/config

package/src/precompiles/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@arbitrum/nitro-precompile-interfaces",
+  "version": "41.0.0",
+  "description": "Solidity interfaces for Arbitrum Nitro precompiled contracts",
+  "author": "Offchain Labs, Inc.",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/offchainlabs/nitro-precompile-interfaces.git"
+  },
+  "files": [
+    "*.sol",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "bugs": {
+    "url": "https://github.com/offchainlabs/nitro-precompile-interfaces/issues"
+  },
+  "scripts": {
+    "build": "forge build",
+    "format": "forge fmt"
+  },
+  "private": false
+}

package/src/precompiles/yarn.lock

@@ -0,0 +1,4 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+

package/src/rollup/AbsRollupEventInbox.sol

@@ -50,11 +50,17 @@ abstract contract AbsRollupEventInbox is
 
     function rollupInitialized(
         uint256 chainId,
-        string calldata chainConfig
+        string calldata chainConfig,
+        uint256 dataCostEstimate
     ) external override onlyRollup {
         require(bytes(chainConfig).length > 0, "EMPTY_CHAIN_CONFIG");
         uint8 initMsgVersion = 1;
-        uint256 currentDataCost = _currentDataCostToReport();
+        uint256 currentDataCost;
+        if (dataCostEstimate != 0) {
+            currentDataCost = dataCostEstimate;
+        } else {
+            currentDataCost = _currentDataCostToReport();
+        }
         bytes memory initMsg =
             abi.encodePacked(chainId, initMsgVersion, currentDataCost, chainConfig);
         uint256 num = _enqueueInitializationMsg(initMsg);

package/src/rollup/BOLDUpgradeAction.sol

@@ -8,7 +8,6 @@ import "@openzeppelin/contracts-upgradeable/utils/Create2Upgradeable.sol";
 import "@openzeppelin/contracts/proxy/transparent/ProxyAdmin.sol";
 import "./RollupProxy.sol";
 import "./RollupLib.sol";
-import "./RollupAdminLogic.sol";
 
 struct Node {
     // Hash of the state of the chain as of this node
@@ -392,7 +391,8 @@ contract BOLDUpgradeAction {
             anyTrustFastConfirmer: address(0), // fast confirmer would be migrated from the old rollup if existed
             numBigStepLevel: NUM_BIGSTEP_LEVEL,
             challengeGracePeriodBlocks: CHALLENGE_GRACE_PERIOD_BLOCKS,
-            bufferConfig: bufferConfig
+            bufferConfig: bufferConfig,
+            dataCostEstimate: 0
         });
     }
 

package/src/rollup/BridgeCreator.sol

@@ -18,7 +18,7 @@ import "../bridge/IBridge.sol";
 import "@openzeppelin/contracts/access/Ownable.sol";
 import "@openzeppelin/contracts/proxy/transparent/ProxyAdmin.sol";
 
-contract BridgeCreator is Ownable {
+contract BridgeCreator {
     BridgeTemplates public ethBasedTemplates;
     BridgeTemplates public erc20BasedTemplates;
 
@@ -45,25 +45,11 @@ contract BridgeCreator is Ownable {
     constructor(
         BridgeTemplates memory _ethBasedTemplates,
         BridgeTemplates memory _erc20BasedTemplates
-    ) Ownable() {
+    ) {
         ethBasedTemplates = _ethBasedTemplates;
         erc20BasedTemplates = _erc20BasedTemplates;
     }
 
-    function updateTemplates(
-        BridgeTemplates calldata _newTemplates
-    ) external onlyOwner {
-        ethBasedTemplates = _newTemplates;
-        emit TemplatesUpdated();
-    }
-
-    function updateERC20Templates(
-        BridgeTemplates calldata _newTemplates
-    ) external onlyOwner {
-        erc20BasedTemplates = _newTemplates;
-        emit ERC20TemplatesUpdated();
-    }
-
     function _createBridge(
         bytes32 create2Salt,
         address adminProxy,

package/src/rollup/Config.sol

@@ -38,6 +38,8 @@ struct Config {
     uint8 numBigStepLevel;
     uint64 challengeGracePeriodBlocks;
     BufferConfig bufferConfig;
+    /// @notice Parent chain's base fee estimate for rollup initialization, if 0 block.basefee will be used
+    uint256 dataCostEstimate;
 }
 
 struct ContractDependencies {

package/src/rollup/IRollupAdmin.sol

@@ -150,10 +150,22 @@ interface IRollupAdmin {
     ) external;
 
     /**
-     * @notice Set base stake required for an assertion
-     * @param newBaseStake maximum avmgas to be used per block
+     * @notice Decrease the base stake required for creating an assertion
+     * @dev    Can only be called on permissioned chains with whitelist enabled
+     *         Can only be called when there is exactly one stake on a pending assertion - this ensures a linear chain of assertions
+     *         Cannot be called immediately after genesis since there are no pending assertions
+     *         After decreasing the base stake the current staker will still have full stake locked up. They can release it by creating a new staker with the
+     *         new smaller amount, and using it to create a child of the latest pending assertion. This will make the old staker inactive and withdrawable.
+     * @param newBaseStake New base stake to be set. Must be less than current base stake, otherwise use increaseBaseStake
+     * @param latestNextInboxPosition The nextInboxPosition of the only pending latestStakedAssertion
      */
-    function setBaseStake(
+    function decreaseBaseStake(uint256 newBaseStake, uint64 latestNextInboxPosition) external;
+
+    /**
+     * @notice Increase the base stake required for creating an assertion
+     * @param newBaseStake New base stake to be set. Must be greater than current base stake, otherwise use reduceBaseStake
+     */
+    function increaseBaseStake(
         uint256 newBaseStake
     ) external;
 

package/src/rollup/IRollupEventInbox.sol

@@ -17,5 +17,9 @@ interface IRollupEventInbox {
 
     function updateRollupAddress() external;
 
-    function rollupInitialized(uint256 chainId, string calldata chainConfig) external;
+    function rollupInitialized(
+        uint256 chainId,
+        string calldata chainConfig,
+        uint256 l1BaseFeeEstimate
+    ) external;
 }