Contract Source Code (Solidity Standard Json-Input format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Similar
• Submit Audit
• Compare

// SPDX-License-Identifier: AGPL-3.0

pragma solidity 0.8.28;
import "../../PolygonZkEVMGlobalExitRootL2.sol";
import "../lib/Hashes.sol";
import "../../v2/interfaces/IGlobalExitRootManagerL2SovereignChain.sol";
import "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";

/**
 * Contract responsible for managing the exit roots for the Sovereign chains and global exit roots
 */
contract GlobalExitRootManagerL2SovereignChain is
    PolygonZkEVMGlobalExitRootL2,
    IGlobalExitRootManagerL2SovereignChain,
    Initializable
{
    // Current contract version
    string public constant GER_SOVEREIGN_VERSION = "al-v0.3.0";

    // globalExitRootUpdater address
    address public globalExitRootUpdater;

    // globalExitRootRemover address
    // In case of initializing a chain with Full execution proofs, this address should be set to zero, otherwise, some malicious sequencer could insert invalid global exit roots, claim, go back and the execution would be correctly proved.
    address public globalExitRootRemover;

    // Inserted GER counter
    /// @custom:oz-renamed-from insertedGERCount
    uint256 internal _legacyInsertedGERCount;

    // Value of the global exit roots hash chain after last insertion
    bytes32 public insertedGERHashChain;

    // Value of the removed global exit roots hash chain after last removal
    bytes32 public removedGERHashChain;

    // This account will be able to accept globalExitRootUpdater role
    address public pendingGlobalExitRootUpdater;

    // This account will be able to accept globalExitRootRemover role
    address public pendingGlobalExitRootRemover;

    /**
     * @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.
     */
    uint256[50] private _gap;

    /**
     * @dev Emitted when a new global exit root is inserted and added to the hash chain
     */
    event UpdateHashChainValue(
        bytes32 indexed newGlobalExitRoot,
        bytes32 indexed newHashChainValue
    );

    /**
     * @dev Emitted when the global exit root is removed and added to the removal hash chain
     */
    event UpdateRemovalHashChainValue(
        bytes32 indexed removedGlobalExitRoot,
        bytes32 indexed newRemovalHashChainValue
    );

    /**
     * @dev Emitted when the GlobalExitRootUpdater starts the two-step transfer role setting a new pending GlobalExitRootUpdater.
     * @param currentGlobalExitRootUpdater The current GlobalExitRootUpdater.
     * @param pendingGlobalExitRootUpdater The new pending GlobalExitRootUpdater.
     */
    event TransferGlobalExitRootUpdater(
        address currentGlobalExitRootUpdater,
        address pendingGlobalExitRootUpdater
    );

    /**
     * @dev Emitted when the GlobalExitRootRemover starts the two-step transfer role setting a new pending GlobalExitRootRemover.
     * @param currentGlobalExitRootRemover The current GlobalExitRootUpdater.
     * @param pendingGlobalExitRootRemover The new pending GlobalExitRootUpdater.
     */
    event TransferGlobalExitRootRemover(
        address currentGlobalExitRootRemover,
        address pendingGlobalExitRootRemover
    );

    /**
     * @dev Emitted when the pending GlobalExitRootUpdater accepts the GlobalExitRootUpdater role.
     * @param oldGlobalExitRootUpdater The previous GlobalExitRootUpdater.
     * @param newGlobalExitRootUpdater The new GlobalExitRootUpdater.
     */
    event AcceptGlobalExitRootUpdater(
        address oldGlobalExitRootUpdater,
        address newGlobalExitRootUpdater
    );

    /**
     * @dev Emitted when the pending GlobalExitRootRemover accepts the GlobalExitRootRemover role.
     * @param oldGlobalExitRootRemover The previous GlobalExitRootRemover.
     * @param newGlobalExitRootRemover The new GlobalExitRootRemover.
     */
    event AcceptGlobalExitRootRemover(
        address oldGlobalExitRootRemover,
        address newGlobalExitRootRemover
    );

    /**
     * @param _bridgeAddress PolygonZkEVMBridge contract address
     */
    constructor(
        address _bridgeAddress
    ) PolygonZkEVMGlobalExitRootL2(_bridgeAddress) {
        _disableInitializers();
    }

    /**
     * @notice Initialize contract
     * Note this initialize function is exactly the same as the last version, therefore no modifications needed
     * @param _globalExitRootUpdater setting the globalExitRootUpdater.
     * @param _globalExitRootRemover In case of initializing a chain with Full execution proofs, this address should be set to zero, otherwise, some malicious sequencer could insert invalid global exit roots, claim and go back and the execution would be correctly proved.
     */
    function initialize(
        address _globalExitRootUpdater,
        address _globalExitRootRemover
    ) external virtual initializer {
        /// @dev _globalExitRootRemover can be set to zero if the chain doesn't want to have this feature
        if (_globalExitRootUpdater == address(0)) {
            revert InvalidZeroAddress();
        }

        // set globalExitRootUpdater
        globalExitRootUpdater = _globalExitRootUpdater;
        emit AcceptGlobalExitRootUpdater(address(0), globalExitRootUpdater);

        // set globalExitRootRemover
        globalExitRootRemover = _globalExitRootRemover;
        emit AcceptGlobalExitRootRemover(address(0), globalExitRootRemover);
    }

    modifier onlyGlobalExitRootUpdater() {
        // Only allowed to be called by GlobalExitRootUpdater or coinbase if GlobalExitRootUpdater is zero
        if (globalExitRootUpdater == address(0)) {
            if (block.coinbase != msg.sender) {
                revert OnlyGlobalExitRootUpdater();
            }
        } else {
            if (globalExitRootUpdater != msg.sender) {
                revert OnlyGlobalExitRootUpdater();
            }
        }
        _;
    }

    modifier onlyGlobalExitRootRemover() {
        // Only allowed to be called by GlobalExitRootRemover
        if (globalExitRootRemover != msg.sender) {
            revert OnlyGlobalExitRootRemover();
        }
        _;
    }

    /**
     * @notice Insert a new global exit root
     * @dev After inserting the new global exit root, the hash chain value is updated.
     *      A hash chain is being used to make optimized proof generations of GERs.
     * @param _newRoot new global exit root to insert
     */
    function insertGlobalExitRoot(
        bytes32 _newRoot
    ) external onlyGlobalExitRootUpdater {
        // do not insert GER if already set
        if (globalExitRootMap[_newRoot] == 0) {
            globalExitRootMap[_newRoot] = block.timestamp;
            // Update hash chain value
            insertedGERHashChain = Hashes.efficientKeccak256(
                insertedGERHashChain,
                _newRoot
            );

            // Emit update event
            emit UpdateHashChainValue(_newRoot, insertedGERHashChain);
        } else {
            revert GlobalExitRootAlreadySet();
        }
    }

    /**
     * @notice Remove global exit roots
     * @dev After removing a global exit root, the removal hash chain value is updated.
     *      A hash chain is being used to make optimized proof generations of removed GERs.
     * @param gersToRemove Array of gers to remove
     */
    function removeGlobalExitRoots(
        bytes32[] calldata gersToRemove
    ) external onlyGlobalExitRootRemover {
        // @dev A memory variable is used to reduce sload/sstore operations while looping
        bytes32 nextRemovalHashChainValue = removedGERHashChain;
        for (uint256 i = 0; i < gersToRemove.length; i++) {
            // Check if the GER exists
            bytes32 gerToRemove = gersToRemove[i];
            if (globalExitRootMap[gerToRemove] == 0) {
                revert GlobalExitRootNotFound();
            }
            // Encode new removed GERs to generate the nextRemovalHashChainValue
            nextRemovalHashChainValue = Hashes.efficientKeccak256(
                nextRemovalHashChainValue,
                gerToRemove
            );

            // Remove the GER from the map
            delete globalExitRootMap[gerToRemove];

            // Emit the removal event
            emit UpdateRemovalHashChainValue(
                gerToRemove,
                nextRemovalHashChainValue
            );
        }
        // Update the removedGERHashChain
        removedGERHashChain = nextRemovalHashChainValue;
    }

    ///////////////////////////////////
    //   Role transfer functions    //
    /////////////////////////////////

    /**
     * @notice Starts the globalExitRootUpdater role transfer
     * This is a two step process, the pending globalExitRootUpdater must accepted to finalize the process
     * @param _newGlobalExitRootUpdater Address of the new globalExitRootUpdater
     */
    function transferGlobalExitRootUpdater(
        address _newGlobalExitRootUpdater
    ) external onlyGlobalExitRootUpdater {
        if (_newGlobalExitRootUpdater == address(0)) {
            revert InvalidZeroAddress();
        }

        pendingGlobalExitRootUpdater = _newGlobalExitRootUpdater;

        emit TransferGlobalExitRootUpdater(
            globalExitRootUpdater,
            _newGlobalExitRootUpdater
        );
    }

    /**
     * @notice Allow the current pending globalExitRootUpdater to accept the globalExitRootUpdater role
     */
    function acceptGlobalExitRootUpdater() external {
        if (msg.sender != pendingGlobalExitRootUpdater) {
            revert OnlyPendingGlobalExitRootUpdater();
        }

        address oldGlobalExitRootUpdater = globalExitRootUpdater;
        globalExitRootUpdater = pendingGlobalExitRootUpdater;
        pendingGlobalExitRootUpdater = address(0);

        emit AcceptGlobalExitRootUpdater(
            oldGlobalExitRootUpdater,
            globalExitRootUpdater
        );
    }

    /**
     * @notice Start the globalExitRootRemover role transfer in a two-step process
     * @param _newGlobalExitRootRemover new pending globalExitRootRemover address
     */
    function transferGlobalExitRootRemover(
        address _newGlobalExitRootRemover
    ) external onlyGlobalExitRootRemover {
        pendingGlobalExitRootRemover = _newGlobalExitRootRemover;

        emit TransferGlobalExitRootRemover(
            globalExitRootRemover,
            _newGlobalExitRootRemover
        );
    }

    /**
     * @notice Allow the current pending globalExitRootRemover to accept the globalExitRootRemover role
     */
    function acceptGlobalExitRootRemover() external {
        if (msg.sender != pendingGlobalExitRootRemover) {
            revert OnlyPendingGlobalExitRootRemover();
        }

        address oldGlobalExitRootRemover = globalExitRootRemover;
        globalExitRootRemover = pendingGlobalExitRootRemover;
        pendingGlobalExitRootRemover = address(0);

        emit AcceptGlobalExitRootRemover(
            oldGlobalExitRootRemover,
            globalExitRootRemover
        );
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.1) (proxy/utils/Initializable.sol)

pragma solidity ^0.8.2;

import "../../utils/AddressUpgradeable.sol";

/**
 * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
 * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
 * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
 * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
 *
 * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
 * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
 * case an upgrade adds a module that needs to be initialized.
 *
 * For example:
 *
 * [.hljs-theme-light.nopadding]
 * ```
 * contract MyToken is ERC20Upgradeable {
 *     function initialize() initializer public {
 *         __ERC20_init("MyToken", "MTK");
 *     }
 * }
 * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
 *     function initializeV2() reinitializer(2) public {
 *         __ERC20Permit_init("MyToken");
 *     }
 * }
 * ```
 *
 * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
 * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
 *
 * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
 * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
 *
 * [CAUTION]
 * ====
 * Avoid leaving a contract uninitialized.
 *
 * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
 * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
 * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
 *
 * [.hljs-theme-light.nopadding]
 * ```
 * /// @custom:oz-upgrades-unsafe-allow constructor
 * constructor() {
 *     _disableInitializers();
 * }
 * ```
 * ====
 */
abstract contract Initializable {
    /**
     * @dev Indicates that the contract has been initialized.
     * @custom:oz-retyped-from bool
     */
    uint8 private _initialized;

    /**
     * @dev Indicates that the contract is in the process of being initialized.
     */
    bool private _initializing;

    /**
     * @dev Triggered when the contract has been initialized or reinitialized.
     */
    event Initialized(uint8 version);

    /**
     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
     * `onlyInitializing` functions can be used to initialize parent contracts.
     *
     * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
     * constructor.
     *
     * Emits an {Initialized} event.
     */
    modifier initializer() {
        bool isTopLevelCall = !_initializing;
        require(
            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
            "Initializable: contract is already initialized"
        );
        _initialized = 1;
        if (isTopLevelCall) {
            _initializing = true;
        }
        _;
        if (isTopLevelCall) {
            _initializing = false;
            emit Initialized(1);
        }
    }

    /**
     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
     * used to initialize parent contracts.
     *
     * A reinitializer may be used after the original initialization step. This is essential to configure modules that
     * are added through upgrades and that require initialization.
     *
     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
     * cannot be nested. If one is invoked in the context of another, execution will revert.
     *
     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
     * a contract, executing them in the right order is up to the developer or operator.
     *
     * WARNING: setting the version to 255 will prevent any future reinitialization.
     *
     * Emits an {Initialized} event.
     */
    modifier reinitializer(uint8 version) {
        require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
        _initialized = version;
        _initializing = true;
        _;
        _initializing = false;
        emit Initialized(version);
    }

    /**
     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
     * {initializer} and {reinitializer} modifiers, directly or indirectly.
     */
    modifier onlyInitializing() {
        require(_initializing, "Initializable: contract is not initializing");
        _;
    }

    /**
     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called
     * through proxies.
     *
     * Emits an {Initialized} event the first time it is successfully executed.
     */
    function _disableInitializers() internal virtual {
        require(!_initializing, "Initializable: contract is initializing");
        if (_initialized < type(uint8).max) {
            _initialized = type(uint8).max;
            emit Initialized(type(uint8).max);
        }
    }

    /**
     * @dev Returns the highest version that has been initialized. See {reinitializer}.
     */
    function _getInitializedVersion() internal view returns (uint8) {
        return _initialized;
    }

    /**
     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
     */
    function _isInitializing() internal view returns (bool) {
        return _initializing;
    }
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)

pragma solidity ^0.8.1;

/**
 * @dev Collection of functions related to the address type
 */
library AddressUpgradeable {
    /**
     * @dev Returns true if `account` is a contract.
     *
     * [IMPORTANT]
     * ====
     * It is unsafe to assume that an address for which this function returns
     * false is an externally-owned account (EOA) and not a contract.
     *
     * Among others, `isContract` will return false for the following
     * types of addresses:
     *
     *  - an externally-owned account
     *  - a contract in construction
     *  - an address where a contract will be created
     *  - an address where a contract lived, but was destroyed
     * ====
     *
     * [IMPORTANT]
     * ====
     * You shouldn't rely on `isContract` to protect against flash loan attacks!
     *
     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
     * constructor.
     * ====
     */
    function isContract(address account) internal view returns (bool) {
        // This method relies on extcodesize/address.code.length, which returns 0
        // for contracts in construction, since the code is only stored at the end
        // of the constructor execution.

        return account.code.length > 0;
    }

    /**
     * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
     * `recipient`, forwarding all available gas and reverting on errors.
     *
     * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
     * of certain opcodes, possibly making contracts go over the 2300 gas limit
     * imposed by `transfer`, making them unable to receive funds via
     * `transfer`. {sendValue} removes this limitation.
     *
     * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
     *
     * IMPORTANT: because control is transferred to `recipient`, care must be
     * taken to not create reentrancy vulnerabilities. Consider using
     * {ReentrancyGuard} or the
     * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
     */
    function sendValue(address payable recipient, uint256 amount) internal {
        require(address(this).balance >= amount, "Address: insufficient balance");

        (bool success, ) = recipient.call{value: amount}("");
        require(success, "Address: unable to send value, recipient may have reverted");
    }

    /**
     * @dev Performs a Solidity function call using a low level `call`. A
     * plain `call` is an unsafe replacement for a function call: use this
     * function instead.
     *
     * If `target` reverts with a revert reason, it is bubbled up by this
     * function (like regular Solidity function calls).
     *
     * Returns the raw returned data. To convert to the expected return value,
     * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
     *
     * Requirements:
     *
     * - `target` must be a contract.
     * - calling `target` with `data` must not revert.
     *
     * _Available since v3.1._
     */
    function functionCall(address target, bytes memory data) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, "Address: low-level call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
     * `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, 0, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but also transferring `value` wei to `target`.
     *
     * Requirements:
     *
     * - the calling contract must have an ETH balance of at least `value`.
     * - the called Solidity function must be `payable`.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value
    ) internal returns (bytes memory) {
        return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
    }

    /**
     * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
     * with `errorMessage` as a fallback revert reason when `target` reverts.
     *
     * _Available since v3.1._
     */
    function functionCallWithValue(
        address target,
        bytes memory data,
        uint256 value,
        string memory errorMessage
    ) internal returns (bytes memory) {
        require(address(this).balance >= value, "Address: insufficient balance for call");
        (bool success, bytes memory returndata) = target.call{value: value}(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
        return functionStaticCall(target, data, "Address: low-level static call failed");
    }

    /**
     * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
     * but performing a static call.
     *
     * _Available since v3.3._
     */
    function functionStaticCall(
        address target,
        bytes memory data,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        (bool success, bytes memory returndata) = target.staticcall(data);
        return verifyCallResultFromTarget(target, success, returndata, errorMessage);
    }

    /**
     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
     *
     * _Available since v4.8._
     */
    function verifyCallResultFromTarget(
        address target,
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal view returns (bytes memory) {
        if (success) {
            if (returndata.length == 0) {
                // only check isContract if the call was successful and the return data is empty
                // otherwise we already know that it was a contract
                require(isContract(target), "Address: call to non-contract");
            }
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    /**
     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
     * revert reason or using the provided one.
     *
     * _Available since v4.3._
     */
    function verifyCallResult(
        bool success,
        bytes memory returndata,
        string memory errorMessage
    ) internal pure returns (bytes memory) {
        if (success) {
            return returndata;
        } else {
            _revert(returndata, errorMessage);
        }
    }

    function _revert(bytes memory returndata, string memory errorMessage) private pure {
        // Look for revert reason and bubble it up if present
        if (returndata.length > 0) {
            // The easiest way to bubble the revert reason is using memory via assembly
            /// @solidity memory-safe-assembly
            assembly {
                let returndata_size := mload(returndata)
                revert(add(32, returndata), returndata_size)
            }
        } else {
            revert(errorMessage);
        }
    }
}

// SPDX-License-Identifier: AGPL-3.0

pragma solidity 0.8.28;
import "./interfaces/IBasePolygonZkEVMGlobalExitRoot.sol";

/**
 * Contract responsible for managing the exit roots for the L2 and global exit roots
 * The special zkRom variables will be accessed and updated directly by the zkRom
 */
contract PolygonZkEVMGlobalExitRootL2 is IBasePolygonZkEVMGlobalExitRoot {
    /////////////////////////////
    // Special zkRom variables
    ////////////////////////////

    // Store every global exit root: Root --> timestamp
    // Note this variable is updated only by the zkRom
    mapping(bytes32 => uint256) public globalExitRootMap;

    // Rollup exit root will be updated for every PolygonZkEVMBridge call
    // Note this variable will be readed by the zkRom
    bytes32 public lastRollupExitRoot;

    ////////////////////
    // Regular variables
    ///////////////////

    // PolygonZkEVM Bridge address
    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
    address public immutable bridgeAddress;

    /**
     * @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.
     */
    uint256[50] private _gap;

    /**
     * @param _bridgeAddress PolygonZkEVMBridge contract address
     */
    constructor(address _bridgeAddress) {
        bridgeAddress = _bridgeAddress;
    }

    /**
     * @notice Update the exit root of one of the networks and the global exit root
     * @param newRoot new exit tree root
     */
    function updateExitRoot(bytes32 newRoot) external {
        if (msg.sender != bridgeAddress) {
            revert OnlyAllowedContracts();
        }

        lastRollupExitRoot = newRoot;
    }
}

// SPDX-License-Identifier: AGPL-3.0

pragma solidity ^0.8.20;

interface IBasePolygonZkEVMGlobalExitRoot {
    /**
     * @dev Thrown when the caller is not the allowed contracts
     */
    error OnlyAllowedContracts();

    /**
     * @dev Thrown when the caller is not the coinbase neither the globalExitRootUpdater
     */
    error OnlyGlobalExitRootUpdater();

    /**
     * @dev Thrown when trying to call a function that only the pending GlobalExitRootUpdater can call.
     */
    error OnlyPendingGlobalExitRootUpdater();

    /**
     * @dev Thrown when the caller is not the globalExitRootRemover
     */
    error OnlyGlobalExitRootRemover();

    /**
     * @dev Thrown when trying to call a function that only the pending GlobalExitRootRemover can call.
     */
    error OnlyPendingGlobalExitRootRemover();

    /**
     * @dev Thrown when trying to insert a global exit root that is already set
     */
    error GlobalExitRootAlreadySet();

    /**
     * @dev Thrown when trying to remove a ger that doesn't exist
     */
    error GlobalExitRootNotFound();

    /**
     * @dev Thrown when trying to call a function with an input zero address
     */
    error InvalidZeroAddress();

    function updateExitRoot(bytes32 newRollupExitRoot) external;

    function globalExitRootMap(
        bytes32 globalExitRootNum
    ) external returns (uint256);
}

// SPDX-License-Identifier: AGPL-3.0

pragma solidity ^0.8.20;
import "../../interfaces/IBasePolygonZkEVMGlobalExitRoot.sol";

interface IGlobalExitRootManagerL2SovereignChain is
    IBasePolygonZkEVMGlobalExitRoot
{
    /**
     * @notice Get the globalExitRootUpdater address
     * This variable is exposed to be used by a BridgeL2Sovereign modifier
     */
    function globalExitRootRemover() external view returns (address);
}

// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/Hashes.sol)

pragma solidity ^0.8.20;

/**
 * @dev Library of standard hash functions.
 * @notice This code is a copy from OpenZeppelin Contracts v5.1.0 (utils/cryptography/Hashes.sol) with a minor change:
 *         function visibility is modified from 'private' to 'internal' so it can be used in other contracts.
 * @notice OpenZeppelin already did this change: https://github.com/OpenZeppelin/openzeppelin-contracts/commit/441dc141ac99622de7e535fa75dfc74af939019c
 *         to be included in next version of OpenZeppelin Contracts.
 * _Available since v5.1._
 */
library Hashes {
    /**
     * @dev Implementation of keccak256(abi.encode(a, b)) that doesn't allocate or expand memory.
     */
    function efficientKeccak256(
        bytes32 a,
        bytes32 b
    ) internal pure returns (bytes32 value) {
        assembly ("memory-safe") {
            mstore(0x00, a)
            mstore(0x20, b)
            value := keccak256(0x00, 0x40)
        }
    }
}

{
  "evmVersion": "shanghai",
  "optimizer": {
    "enabled": true,
    "runs": 999999
  },
  "outputSelection": {
    "*": {
      "*": [
        "evm.bytecode",
        "evm.deployedBytecode",
        "abi"
      ]
    }
  }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"_bridgeAddress","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"GlobalExitRootAlreadySet","type":"error"},{"inputs":[],"name":"GlobalExitRootNotFound","type":"error"},{"inputs":[],"name":"InvalidZeroAddress","type":"error"},{"inputs":[],"name":"OnlyAllowedContracts","type":"error"},{"inputs":[],"name":"OnlyGlobalExitRootRemover","type":"error"},{"inputs":[],"name":"OnlyGlobalExitRootUpdater","type":"error"},{"inputs":[],"name":"OnlyPendingGlobalExitRootRemover","type":"error"},{"inputs":[],"name":"OnlyPendingGlobalExitRootUpdater","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldGlobalExitRootRemover","type":"address"},{"indexed":false,"internalType":"address","name":"newGlobalExitRootRemover","type":"address"}],"name":"AcceptGlobalExitRootRemover","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"oldGlobalExitRootUpdater","type":"address"},{"indexed":false,"internalType":"address","name":"newGlobalExitRootUpdater","type":"address"}],"name":"AcceptGlobalExitRootUpdater","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"currentGlobalExitRootRemover","type":"address"},{"indexed":false,"internalType":"address","name":"pendingGlobalExitRootRemover","type":"address"}],"name":"TransferGlobalExitRootRemover","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"currentGlobalExitRootUpdater","type":"address"},{"indexed":false,"internalType":"address","name":"pendingGlobalExitRootUpdater","type":"address"}],"name":"TransferGlobalExitRootUpdater","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"newGlobalExitRoot","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newHashChainValue","type":"bytes32"}],"name":"UpdateHashChainValue","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"removedGlobalExitRoot","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newRemovalHashChainValue","type":"bytes32"}],"name":"UpdateRemovalHashChainValue","type":"event"},{"inputs":[],"name":"GER_SOVEREIGN_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptGlobalExitRootRemover","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"acceptGlobalExitRootUpdater","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"bridgeAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"globalExitRootMap","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"globalExitRootRemover","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"globalExitRootUpdater","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_globalExitRootUpdater","type":"address"},{"internalType":"address","name":"_globalExitRootRemover","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_newRoot","type":"bytes32"}],"name":"insertGlobalExitRoot","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"insertedGERHashChain","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastRollupExitRoot","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingGlobalExitRootRemover","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingGlobalExitRootUpdater","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"gersToRemove","type":"bytes32[]"}],"name":"removeGlobalExitRoots","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"removedGERHashChain","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_newGlobalExitRootRemover","type":"address"}],"name":"transferGlobalExitRootRemover","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_newGlobalExitRootUpdater","type":"address"}],"name":"transferGlobalExitRootUpdater","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"newRoot","type":"bytes32"}],"name":"updateExitRoot","outputs":[],"stateMutability":"nonpayable","type":"function"}]

608060405234801561000f575f5ffd5b506004361061012f575f3560e01c806365f0e347116100ad57806391eb796d1161007d578063c053902a11610063578063c053902a14610306578063f5c2f0921461030e578063f5d2f04b14610316575f5ffd5b806391eb796d146102bf578063a3c573eb146102df575f5ffd5b806365f0e3471461022a57806368328bc11461023d5780636ee160d0146102505780637c314ce314610299575f5ffd5b8063163bbb46116101025780632d5ddf2b116100e85780632d5ddf2b146101e457806333d6247d14610204578063485cc95514610217575f5ffd5b8063163bbb46146101bc578063257b3632146101c5575f5ffd5b806301fd9044146101335780630e1bbf9f1461014f57806312da06b21461016457806314770a9314610177575b5f5ffd5b61013c60015481565b6040519081526020015b60405180910390f35b61016261015d366004610d4e565b61031f565b005b610162610172366004610d6e565b6104b2565b603a546101979073ffffffffffffffffffffffffffffffffffffffff1681565b60405173ffffffffffffffffffffffffffffffffffffffff9091168152602001610146565b61013c60375481565b61013c6101d3366004610d6e565b5f6020819052908152604090205481565b6039546101979073ffffffffffffffffffffffffffffffffffffffff1681565b610162610212366004610d6e565b6105fe565b610162610225366004610d85565b610672565b610162610238366004610db6565b610956565b61016261024b366004610d4e565b610a6f565b61028c6040518060400160405280600981526020017f616c2d76302e332e30000000000000000000000000000000000000000000000081525081565b6040516101469190610e27565b6034546101979062010000900473ffffffffffffffffffffffffffffffffffffffff1681565b6035546101979073ffffffffffffffffffffffffffffffffffffffff1681565b6101977f0000000000000000000000002a3dd3eb832af982ec71669e178424b10dca2ede81565b610162610b41565b610162610c4a565b61013c60385481565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff166103805741331461037b576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6103d7565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff1633146103d7576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8116610424576040517ff6b2911f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603980547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff8381169182179092556034546040805162010000909204909316815260208101919091527f1b87468e424189ebdac99fd548646bdb9a48aa9708cfae9f96e6b2e76aee842591015b60405180910390a150565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff166105135741331461050e576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b61056a565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff16331461056a576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8181526020819052604081205490036105cc575f818152602081815260408083204290556037548352908390529020603781905560405182907f65d3bf36615f1f02a134d12dfa9ea6b1d4a52386e825973cd27ddb70895c2319905f90a350565b6040517f1f97a58200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b3373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000002a3dd3eb832af982ec71669e178424b10dca2ede161461066d576040517fb49365dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600155565b603454610100900460ff16158080156106925750603454600160ff909116105b806106ac5750303b1580156106ac575060345460ff166001145b61073c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201527f647920696e697469616c697a6564000000000000000000000000000000000000606482015260840160405180910390fd5b603480547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00166001179055801561079a57603480547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff166101001790555b73ffffffffffffffffffffffffffffffffffffffff83166107e7576040517ff6b2911f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603480547fffffffffffffffffffff0000000000000000000000000000000000000000ffff166201000073ffffffffffffffffffffffffffffffffffffffff86811682029290921792839055604080515f81529190930490911660208201527f8002020f64e628e4e2ff674f8bb88c2709216fc10e3ccdca75ac257faf494236910160405180910390a1603580547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff8416908117909155604080515f815260208101929092527fabb4abb224bcd13da954d8616357fc9fcf0ccb7057f6dd0fbb7b10624c924ec5910160405180910390a1801561095157603480547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b60355473ffffffffffffffffffffffffffffffffffffffff1633146109a7576040517fa34ddeb100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6038545f5b82811015610a67575f8484838181106109c7576109c7610e90565b9050602002013590505f5f8281526020019081526020015f20545f03610a19576040517ff4a66f9d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f9283526020818152604080852083865291859052808520859055519093849183917faafec9380147d2b2b14fe23b1343cbaa1b07f86c5adb060bd28cdf1af4c6f0d491a3506001016109ac565b506038555050565b60355473ffffffffffffffffffffffffffffffffffffffff163314610ac0576040517fa34ddeb100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603a80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff8381169182179092556035546040805191909316815260208101919091527fea76dc66cb4397b7afec1a503c40b50f296f45c8a3e32d9f3eee2f7e07e7fba791016104a7565b60395473ffffffffffffffffffffffffffffffffffffffff163314610b92576040517f5f063f0100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603480546039805473ffffffffffffffffffffffffffffffffffffffff808216620100009081027fffffffffffffffffffff0000000000000000000000000000000000000000ffff861617958690557fffffffffffffffffffffffff000000000000000000000000000000000000000090921690925560408051938290048316808552919094049091166020830152917f8002020f64e628e4e2ff674f8bb88c2709216fc10e3ccdca75ac257faf49423691016104a7565b603a5473ffffffffffffffffffffffffffffffffffffffff163314610c9b576040517f7ca4d27a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60358054603a805473ffffffffffffffffffffffffffffffffffffffff8082167fffffffffffffffffffffffff0000000000000000000000000000000000000000808616821790965594909116909155604080519190921680825260208201939093527fabb4abb224bcd13da954d8616357fc9fcf0ccb7057f6dd0fbb7b10624c924ec591016104a7565b803573ffffffffffffffffffffffffffffffffffffffff81168114610d49575f5ffd5b919050565b5f60208284031215610d5e575f5ffd5b610d6782610d26565b9392505050565b5f60208284031215610d7e575f5ffd5b5035919050565b5f5f60408385031215610d96575f5ffd5b610d9f83610d26565b9150610dad60208401610d26565b90509250929050565b5f5f60208385031215610dc7575f5ffd5b823567ffffffffffffffff811115610ddd575f5ffd5b8301601f81018513610ded575f5ffd5b803567ffffffffffffffff811115610e03575f5ffd5b8560208260051b8401011115610e17575f5ffd5b6020919091019590945092505050565b602081525f82518060208401525f5b81811015610e535760208186018101516040868401015201610e36565b505f6040828501015260407fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f83011684010191505092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffdfea2646970667358221220f5c89bf26cacc257da76607320ba2ac49a940587d51505154578a304aab38e3f64736f6c634300081c0033

0x608060405234801561000f575f5ffd5b506004361061012f575f3560e01c806365f0e347116100ad57806391eb796d1161007d578063c053902a11610063578063c053902a14610306578063f5c2f0921461030e578063f5d2f04b14610316575f5ffd5b806391eb796d146102bf578063a3c573eb146102df575f5ffd5b806365f0e3471461022a57806368328bc11461023d5780636ee160d0146102505780637c314ce314610299575f5ffd5b8063163bbb46116101025780632d5ddf2b116100e85780632d5ddf2b146101e457806333d6247d14610204578063485cc95514610217575f5ffd5b8063163bbb46146101bc578063257b3632146101c5575f5ffd5b806301fd9044146101335780630e1bbf9f1461014f57806312da06b21461016457806314770a9314610177575b5f5ffd5b61013c60015481565b6040519081526020015b60405180910390f35b61016261015d366004610d4e565b61031f565b005b610162610172366004610d6e565b6104b2565b603a546101979073ffffffffffffffffffffffffffffffffffffffff1681565b60405173ffffffffffffffffffffffffffffffffffffffff9091168152602001610146565b61013c60375481565b61013c6101d3366004610d6e565b5f6020819052908152604090205481565b6039546101979073ffffffffffffffffffffffffffffffffffffffff1681565b610162610212366004610d6e565b6105fe565b610162610225366004610d85565b610672565b610162610238366004610db6565b610956565b61016261024b366004610d4e565b610a6f565b61028c6040518060400160405280600981526020017f616c2d76302e332e30000000000000000000000000000000000000000000000081525081565b6040516101469190610e27565b6034546101979062010000900473ffffffffffffffffffffffffffffffffffffffff1681565b6035546101979073ffffffffffffffffffffffffffffffffffffffff1681565b6101977f0000000000000000000000002a3dd3eb832af982ec71669e178424b10dca2ede81565b610162610b41565b610162610c4a565b61013c60385481565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff166103805741331461037b576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6103d7565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff1633146103d7576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8116610424576040517ff6b2911f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603980547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff8381169182179092556034546040805162010000909204909316815260208101919091527f1b87468e424189ebdac99fd548646bdb9a48aa9708cfae9f96e6b2e76aee842591015b60405180910390a150565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff166105135741331461050e576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b61056a565b60345462010000900473ffffffffffffffffffffffffffffffffffffffff16331461056a576040517fc758fc1a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8181526020819052604081205490036105cc575f818152602081815260408083204290556037548352908390529020603781905560405182907f65d3bf36615f1f02a134d12dfa9ea6b1d4a52386e825973cd27ddb70895c2319905f90a350565b6040517f1f97a58200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b3373ffffffffffffffffffffffffffffffffffffffff7f0000000000000000000000002a3dd3eb832af982ec71669e178424b10dca2ede161461066d576040517fb49365dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600155565b603454610100900460ff16158080156106925750603454600160ff909116105b806106ac5750303b1580156106ac575060345460ff166001145b61073c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201527f647920696e697469616c697a6564000000000000000000000000000000000000606482015260840160405180910390fd5b603480547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00166001179055801561079a57603480547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff166101001790555b73ffffffffffffffffffffffffffffffffffffffff83166107e7576040517ff6b2911f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603480547fffffffffffffffffffff0000000000000000000000000000000000000000ffff166201000073ffffffffffffffffffffffffffffffffffffffff86811682029290921792839055604080515f81529190930490911660208201527f8002020f64e628e4e2ff674f8bb88c2709216fc10e3ccdca75ac257faf494236910160405180910390a1603580547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff8416908117909155604080515f815260208101929092527fabb4abb224bcd13da954d8616357fc9fcf0ccb7057f6dd0fbb7b10624c924ec5910160405180910390a1801561095157603480547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b60355473ffffffffffffffffffffffffffffffffffffffff1633146109a7576040517fa34ddeb100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6038545f5b82811015610a67575f8484838181106109c7576109c7610e90565b9050602002013590505f5f8281526020019081526020015f20545f03610a19576040517ff4a66f9d00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f9283526020818152604080852083865291859052808520859055519093849183917faafec9380147d2b2b14fe23b1343cbaa1b07f86c5adb060bd28cdf1af4c6f0d491a3506001016109ac565b506038555050565b60355473ffffffffffffffffffffffffffffffffffffffff163314610ac0576040517fa34ddeb100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603a80547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff8381169182179092556035546040805191909316815260208101919091527fea76dc66cb4397b7afec1a503c40b50f296f45c8a3e32d9f3eee2f7e07e7fba791016104a7565b60395473ffffffffffffffffffffffffffffffffffffffff163314610b92576040517f5f063f0100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b603480546039805473ffffffffffffffffffffffffffffffffffffffff808216620100009081027fffffffffffffffffffff0000000000000000000000000000000000000000ffff861617958690557fffffffffffffffffffffffff000000000000000000000000000000000000000090921690925560408051938290048316808552919094049091166020830152917f8002020f64e628e4e2ff674f8bb88c2709216fc10e3ccdca75ac257faf49423691016104a7565b603a5473ffffffffffffffffffffffffffffffffffffffff163314610c9b576040517f7ca4d27a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60358054603a805473ffffffffffffffffffffffffffffffffffffffff8082167fffffffffffffffffffffffff0000000000000000000000000000000000000000808616821790965594909116909155604080519190921680825260208201939093527fabb4abb224bcd13da954d8616357fc9fcf0ccb7057f6dd0fbb7b10624c924ec591016104a7565b803573ffffffffffffffffffffffffffffffffffffffff81168114610d49575f5ffd5b919050565b5f60208284031215610d5e575f5ffd5b610d6782610d26565b9392505050565b5f60208284031215610d7e575f5ffd5b5035919050565b5f5f60408385031215610d96575f5ffd5b610d9f83610d26565b9150610dad60208401610d26565b90509250929050565b5f5f60208385031215610dc7575f5ffd5b823567ffffffffffffffff811115610ddd575f5ffd5b8301601f81018513610ded575f5ffd5b803567ffffffffffffffff811115610e03575f5ffd5b8560208260051b8401011115610e17575f5ffd5b6020919091019590945092505050565b602081525f82518060208401525f5b81811015610e535760208186018101516040868401015201610e36565b505f6040828501015260407fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f83011684010191505092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffdfea2646970667358221220f5c89bf26cacc257da76607320ba2ac49a940587d51505154578a304aab38e3f64736f6c634300081c0033

396:10644:6:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;773:33:2;;;;;;;;;160:25:7;;;148:2;133:18;773:33:2;;;;;;;;8874:432:6;;;;;;:::i;:::-;;:::i;:::-;;6426:613;;;;;;:::i;:::-;;:::i;1587:43::-;;;;;;;;;;;;949:42:7;937:55;;;919:74;;907:2;892:18;1587:43:6;773:226:7;1238:35:6;;;;;;586:52:2;;;;;;:::i;:::-;;;;;;;;;;;;;;;1467:43:6;;;;;;;;;1555:192:2;;;;;;:::i;:::-;;:::i;4728:693:6:-;;;;;;:::i;:::-;;:::i;7332:1152::-;;;;;;:::i;:::-;;:::i;10103:325::-;;;;;;:::i;:::-;;:::i;580:58::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;682:36::-;;;;;;;;;;;;1001;;;;;;;;;989:38:2;;;;;9432:484:6;;;:::i;10554:::-;;;:::i;1356:34::-;;;;;;8874:432;5585:21;;;;;:35;:21;5581:304;;5640:14;5658:10;5640:28;5636:101;;5695:27;;;;;;;;;;;;;;5636:101;5581:304;;;5771:21;;;;;:35;:21;5796:10;5771:35;5767:108;;5833:27;;;;;;;;;;;;;;5767:108;9011:39:::1;::::0;::::1;9007:97;;9073:20;;;;;;;;;;;;;;9007:97;9114:28;:56:::0;;;::::1;;::::0;;::::1;::::0;;::::1;::::0;;;9229:21:::1;::::0;9186:113:::1;::::0;;9229:21;;;::::1;::::0;;::::1;2831:74:7::0;;2936:2;2921:18;;2914:83;;;;9186:113:6::1;::::0;2804:18:7;9186:113:6::1;;;;;;;;8874:432:::0;:::o;6426:613::-;5585:21;;;;;:35;:21;5581:304;;5640:14;5658:10;5640:28;5636:101;;5695:27;;;;;;;;;;;;;;5636:101;5581:304;;;5771:21;;;;;:35;:21;5796:10;5771:35;5767:108;;5833:27;;;;;;;;;;;;;;5767:108;6581:17:::1;:27:::0;;;::::1;::::0;;;;;;;:32;;6577:456:::1;;6629:17;:27:::0;;;::::1;::::0;;;;;;;6659:15:::1;6629:45:::0;;6793:20:::1;::::0;962:15:5;;990;;;;1027:21;;6727:20:6::1;:126:::0;;;6906:52:::1;::::0;6927:8;;6906:52:::1;::::0;;;::::1;6426:613:::0;:::o;6577:456::-:1;6996:26;;;;;;;;;;;;;;1555:192:2::0;1619:10;:27;1633:13;1619:27;;1615:87;;1669:22;;;;;;;;;;;;;;1615:87;1712:18;:28;1555:192::o;4728:693:6:-;3291:13:0;;;;;;;3290:14;;3336:34;;;;-1:-1:-1;3354:12:0;;3369:1;3354:12;;;;:16;3336:34;3335:108;;;-1:-1:-1;3415:4:0;1476:19:1;:23;;;3376:66:0;;-1:-1:-1;3425:12:0;;;;;:17;3376:66;3314:201;;;;;;;3210:2:7;3314:201:0;;;3192:21:7;3249:2;3229:18;;;3222:30;3288:34;3268:18;;;3261:62;3359:16;3339:18;;;3332:44;3393:19;;3314:201:0;;;;;;;;3525:12;:16;;;;3540:1;3525:16;;;3551:65;;;;3585:13;:20;;;;;;;;3551:65;4983:36:6::1;::::0;::::1;4979:94;;5042:20;;;;;;;;;;;;;;4979:94;5120:21;:46:::0;;;::::1;::::0;::::1;::::0;;::::1;::::0;::::1;::::0;;;::::1;::::0;;;;5181:62:::1;::::0;;-1:-1:-1;2831:74:7;;5221:21:6;;;::::1;::::0;;::::1;2936:2:7::0;2921:18;;2914:83;5181:62:6::1;::::0;2804:18:7;5181:62:6::1;;;;;;;5291:21;:46:::0;;;::::1;;::::0;::::1;::::0;;::::1;::::0;;;5352:62:::1;::::0;;-1:-1:-1;2831:74:7;;2936:2;2921:18;;2914:83;;;;5352:62:6::1;::::0;2804:18:7;5352:62:6::1;;;;;;;3640:14:0::0;3636:99;;;3670:13;:21;;;;;;3710:14;;-1:-1:-1;3575:36:7;;3710:14:0;;3563:2:7;3548:18;3710:14:0;;;;;;;3636:99;3258:483;4728:693:6;;:::o;7332:1152::-;6021:21;;:35;:21;6046:10;6021:35;6017:100;;6079:27;;;;;;;;;;;;;;6017:100;7581:19:::1;::::0;7545:33:::1;7610:769;7630:23:::0;;::::1;7610:769;;;7713:19;7735:12;;7748:1;7735:15;;;;;;;:::i;:::-;;;;;;;7713:37;;7768:17;:30;7786:11;7768:30;;;;;;;;;;;;7802:1;7768:35:::0;7764:105:::1;;7830:24;;;;;;;;;;;;;;7764:105;898:13:5::0;962:15;;;997:4;990:15;;;1043:4;1027:21;;;8167:30:6;;;;;;;;;;8160:37;;;8255:113;1027:21:5;;;;990:15;;8255:113:6::1;::::0;::::1;-1:-1:-1::0;7655:3:6::1;;7610:769;;;-1:-1:-1::0;8430:19:6::1;:47:::0;-1:-1:-1;;7332:1152:6:o;10103:325::-;6021:21;;:35;:21;6046:10;6021:35;6017:100;;6079:27;;;;;;;;;;;;;;6017:100;10236:28:::1;:56:::0;;;::::1;;::::0;;::::1;::::0;;::::1;::::0;;;10351:21:::1;::::0;10308:113:::1;::::0;;10351:21;;;::::1;2831:74:7::0;;2936:2;2921:18;;2914:83;;;;10308:113:6::1;::::0;2804:18:7;10308:113:6::1;2657:346:7::0;9432:484:6;9508:28;;;;9494:10;:42;9490:114;;9559:34;;;;;;;;;;;;;;9490:114;9649:21;;;9704:28;;;9649:21;9704:28;;;9649:21;9680:52;;;;;;;;;;;9742:41;;;;;;;9799:110;;;9649:21;;;;;;2831:74:7;;;9878:21:6;;;;;;;2936:2:7;2921:18;;2914:83;9649:21:6;9799:110;;2804:18:7;9799:110:6;2657:346:7;10554:484:6;10630:28;;;;10616:10;:42;10612:114;;10681:34;;;;;;;;;;;;;;10612:114;10771:21;;;10826:28;;;10771:21;10826:28;;;10802:52;;;;;;;;;10864:41;;;;;;;10921:110;;;10771:21;;;;2831:74:7;;;2936:2;2921:18;;2914:83;;;;10921:110:6;;2804:18:7;10921:110:6;2657:346:7;196:196;264:20;;324:42;313:54;;303:65;;293:93;;382:1;379;372:12;293:93;196:196;;;:::o;397:186::-;456:6;509:2;497:9;488:7;484:23;480:32;477:52;;;525:1;522;515:12;477:52;548:29;567:9;548:29;:::i;:::-;538:39;397:186;-1:-1:-1;;;397:186:7:o;588:180::-;647:6;700:2;688:9;679:7;675:23;671:32;668:52;;;716:1;713;706:12;668:52;-1:-1:-1;739:23:7;;588:180;-1:-1:-1;588:180:7:o;1186:260::-;1254:6;1262;1315:2;1303:9;1294:7;1290:23;1286:32;1283:52;;;1331:1;1328;1321:12;1283:52;1354:29;1373:9;1354:29;:::i;:::-;1344:39;;1402:38;1436:2;1425:9;1421:18;1402:38;:::i;:::-;1392:48;;1186:260;;;;;:::o;1451:610::-;1537:6;1545;1598:2;1586:9;1577:7;1573:23;1569:32;1566:52;;;1614:1;1611;1604:12;1566:52;1654:9;1641:23;1687:18;1679:6;1676:30;1673:50;;;1719:1;1716;1709:12;1673:50;1742:22;;1795:4;1787:13;;1783:27;-1:-1:-1;1773:55:7;;1824:1;1821;1814:12;1773:55;1864:2;1851:16;1890:18;1882:6;1879:30;1876:50;;;1922:1;1919;1912:12;1876:50;1975:7;1970:2;1960:6;1957:1;1953:14;1949:2;1945:23;1941:32;1938:45;1935:65;;;1996:1;1993;1986:12;1935:65;2027:2;2019:11;;;;;2049:6;;-1:-1:-1;1451:610:7;-1:-1:-1;;;1451:610:7:o;2066:586::-;2215:2;2204:9;2197:21;2178:4;2247:6;2241:13;2290:6;2285:2;2274:9;2270:18;2263:34;2315:1;2325:140;2339:6;2336:1;2333:13;2325:140;;;2450:2;2434:14;;;2430:23;;2424:30;2419:2;2400:17;;;2396:26;2389:66;2354:10;2325:140;;;2329:3;2514:1;2509:2;2500:6;2489:9;2485:22;2481:31;2474:42;2643:2;2573:66;2568:2;2560:6;2556:15;2552:88;2541:9;2537:104;2533:113;2525:121;;;2066:586;;;;:::o;3622:184::-;3674:77;3671:1;3664:88;3771:4;3768:1;3761:15;3795:4;3792:1;3785:15

ipfs://f5c89bf26cacc257da76607320ba2ac49a940587d51505154578a304aab38e3f