BoltParametersV1.sol

// SPDX-License-Identifier: MIT
pragma solidity 0.8.25;

import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import {UUPSUpgradeable} from "@openzeppelin/contracts/proxy/utils/UUPSUpgradeable.sol";

/// @title Bolt Parameters
/// @notice The BoltParameters contract contains all the parameters for the Bolt protocol.
/// @dev This contract is upgradeable using the UUPSProxy pattern. Storage layout remains fixed across upgrades
/// with the use of storage gaps.
/// See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
/// To validate the storage layout, use the Openzeppelin Foundry Upgrades toolkit.
/// You can also validate manually with forge: forge inspect <contract> storage-layout --pretty
contract BoltParametersV1 is OwnableUpgradeable, UUPSUpgradeable {
    // =========== CONSTANTS ========= //
    /// @dev See EIP-4788 for more info
    address internal constant BEACON_ROOTS_CONTRACT = 0x000F3df6D732807Ef1319fB7B8bB8522d0Beac02;

    /// @notice The EIP-4788 time window in slots
    uint256 internal constant EIP4788_WINDOW = 8191;
    // =========== STORAGE =========== //

    // --> Storage layout marker: 0 bits

    /// @notice Duration of an epoch in seconds.
    uint48 public EPOCH_DURATION;

    /// @notice Duration of the slashing window in seconds.
    uint48 public SLASHING_WINDOW;

    /// @notice Whether to allow unsafe registration of validators
    /// @dev Until the BLS12_381 precompile is live, we need to allow unsafe registration
    /// which means we don't check the BLS signature of the validator pubkey.
    bool public ALLOW_UNSAFE_REGISTRATION;
    // --> Storage layout marker: 48 + 48 + 8 = 104 bits

    /// @notice The maximum duration of a challenge before it is automatically considered valid.
    uint48 public MAX_CHALLENGE_DURATION;

    /// @notice The challenge bond required to open a challenge.
    uint256 public CHALLENGE_BOND;

    /// @notice The maximum number of blocks to look back for block hashes in the EVM.
    uint256 public BLOCKHASH_EVM_LOOKBACK;

    /// @notice The number of slots to wait before considering a block justified by LMD-GHOST.
    uint256 public JUSTIFICATION_DELAY;

    /// @notice The timestamp of the eth2 genesis block.
    uint256 public ETH2_GENESIS_TIMESTAMP;

    /// @notice The duration of a slot in seconds.
    uint256 public SLOT_TIME;

    /// @notice The minimum stake required for an operator to be considered active in wei.
    uint256 public MINIMUM_OPERATOR_STAKE;
    // --> Storage layout marker: 7 words

    /**
     * @dev This empty reserved space is put in place to allow future versions to add new
     * variables without shifting down storage in the inheritance chain.
     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
     * This can be validated with the Openzeppelin Foundry Upgrades toolkit.
     *
     * Total storage slots: 50
     */
    uint256[43] private __gap;

    /// @notice Error emitted when a beacon block root is not found
    error BeaconRootNotFound();

    // ============== INITIALIZER ============== //

    /// @notice The initializer for the BoltManager contract.
    /// @param _epochDuration The epoch duration.
    function initialize(
        address _owner,
        uint48 _epochDuration,
        uint48 _slashingWindow,
        uint48 _maxChallengeDuration,
        bool _allowUnsafeRegistration,
        uint256 _challengeBond,
        uint256 _blockhashEvmLookback,
        uint256 _justificationDelay,
        uint256 _eth2GenesisTimestamp,
        uint256 _slotTime,
        uint256 _minimumOperatorStake
    ) public initializer {
        __Ownable_init(_owner);

        EPOCH_DURATION = _epochDuration;
        SLASHING_WINDOW = _slashingWindow;
        ALLOW_UNSAFE_REGISTRATION = _allowUnsafeRegistration;
        MAX_CHALLENGE_DURATION = _maxChallengeDuration;
        CHALLENGE_BOND = _challengeBond;
        BLOCKHASH_EVM_LOOKBACK = _blockhashEvmLookback;
        JUSTIFICATION_DELAY = _justificationDelay;
        ETH2_GENESIS_TIMESTAMP = _eth2GenesisTimestamp;
        SLOT_TIME = _slotTime;
        MINIMUM_OPERATOR_STAKE = _minimumOperatorStake;
    }

    function _authorizeUpgrade(
        address newImplementation
    ) internal override onlyOwner {}

    // ========= ADMIN METHODS ========= //

    /// @notice Enable or disable the use of the BLS precompile
    /// @param allowUnsafeRegistration Whether to allow unsafe registration of validators
    function setAllowUnsafeRegistration(
        bool allowUnsafeRegistration
    ) public onlyOwner {
        ALLOW_UNSAFE_REGISTRATION = allowUnsafeRegistration;
    }

    /// @notice Set the max challenge duration.
    /// @param maxChallengeDuration The maximum duration of a challenge before it is automatically considered valid.
    function setMaxChallengeDuration(
        uint48 maxChallengeDuration
    ) public onlyOwner {
        MAX_CHALLENGE_DURATION = maxChallengeDuration;
    }

    /// @notice Set the required challenge bond.
    /// @param challengeBond The challenge bond required to open a challenge.
    function setChallengeBond(
        uint256 challengeBond
    ) public onlyOwner {
        CHALLENGE_BOND = challengeBond;
    }

    /// @notice Set the minimum operator stake.
    /// @param minimumOperatorStake The minimum stake required for an operator to be considered active in wei.
    function setMinimumOperatorStake(
        uint256 minimumOperatorStake
    ) public onlyOwner {
        MINIMUM_OPERATOR_STAKE = minimumOperatorStake;
    }

    /// @notice Set the justification delay.
    /// @param justificationDelay The number of slots to wait before considering a block final.
    function setJustificationDelay(
        uint256 justificationDelay
    ) public onlyOwner {
        JUSTIFICATION_DELAY = justificationDelay;
    }
}