Source Code
Overview
ETH Balance
0 ETH
More Info
ContractCreator
Multichain Info
N/A
| Transaction Hash |
Method
|
Block
|
From
|
To
|
Amount
|
||||
|---|---|---|---|---|---|---|---|---|---|
Latest 25 internal transactions (View All)
Advanced mode:
| Parent Transaction Hash | Method | Block |
From
|
To
|
Amount
|
||
|---|---|---|---|---|---|---|---|
| Submit Report Ex... | 1498589 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1498581 | 13 days ago | 0 ETH | ||||
| Submit Report Da... | 1498581 | 13 days ago | 0 ETH | ||||
| Submit Consensus... | 1498574 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1498574 | 13 days ago | 0 ETH | ||||
| Get Consensus Ve... | 1498574 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1498573 | 13 days ago | 0 ETH | ||||
| Get Consensus Ve... | 1498573 | 13 days ago | 0 ETH | ||||
| Submit Report Ex... | 1498245 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1498240 | 13 days ago | 0 ETH | ||||
| Submit Report Da... | 1498240 | 13 days ago | 0 ETH | ||||
| Submit Consensus... | 1498234 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1498234 | 13 days ago | 0 ETH | ||||
| Get Consensus Ve... | 1498234 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1498234 | 13 days ago | 0 ETH | ||||
| Get Consensus Ve... | 1498234 | 13 days ago | 0 ETH | ||||
| Submit Report Ex... | 1497902 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1497895 | 13 days ago | 0 ETH | ||||
| Submit Report Da... | 1497895 | 13 days ago | 0 ETH | ||||
| Submit Consensus... | 1497888 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1497888 | 13 days ago | 0 ETH | ||||
| Get Consensus Ve... | 1497888 | 13 days ago | 0 ETH | ||||
| Get Last Process... | 1497887 | 13 days ago | 0 ETH | ||||
| Get Consensus Ve... | 1497887 | 13 days ago | 0 ETH | ||||
| Submit Report Ex... | 1497568 | 13 days ago | 0 ETH |
Loading...
Loading
Loading...
Loading
Contract Name:
AccountingOracle
Compiler Version
v0.8.9+commit.e5eed63a
Optimization Enabled:
Yes with 200 runs
Other Settings:
istanbul EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-FileCopyrightText: 2025 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 /* See contracts/COMPILERS.md */ pragma solidity 0.8.9; import {SafeCast} from "@openzeppelin/contracts-v4.4/utils/math/SafeCast.sol"; import {ILidoLocator} from "contracts/common/interfaces/ILidoLocator.sol"; import {ReportValues} from "contracts/common/interfaces/ReportValues.sol"; import {ILazyOracle} from "contracts/common/interfaces/ILazyOracle.sol"; import {UnstructuredStorage} from "contracts/0.8.9/lib/UnstructuredStorage.sol"; import {BaseOracle} from "./BaseOracle.sol"; interface IReportReceiver { function handleOracleReport(ReportValues memory values) external; } interface IOracleReportSanityChecker { function checkExitedValidatorsRatePerDay(uint256 _exitedValidatorsCount) external view; function checkExtraDataItemsCountPerTransaction(uint256 _extraDataListItemsCount) external view; function checkNodeOperatorsPerExtraDataItemCount(uint256 _itemIndex, uint256 _nodeOperatorsCount) external view; } interface IStakingRouter { function updateExitedValidatorsCountByStakingModule( uint256[] calldata moduleIds, uint256[] calldata exitedValidatorsCounts ) external returns (uint256); function reportStakingModuleExitedValidatorsCountByNodeOperator( uint256 stakingModuleId, bytes calldata nodeOperatorIds, bytes calldata exitedValidatorsCounts ) external; function onValidatorsCountsByNodeOperatorReportingFinished() external; } interface IWithdrawalQueue { function onOracleReport(bool isBunkerMode, uint256 prevReportTimestamp, uint256 currentReportTimestamp) external; } contract AccountingOracle is BaseOracle { using UnstructuredStorage for bytes32; using SafeCast for uint256; error LidoLocatorCannotBeZero(); error AdminCannotBeZero(); error LidoCannotBeZero(); error IncorrectOracleMigration(uint256 code); error SenderNotAllowed(); error InvalidExitedValidatorsData(); error UnsupportedExtraDataFormat(uint256 format); error UnsupportedExtraDataType(uint256 itemIndex, uint256 dataType); error DeprecatedExtraDataType(uint256 itemIndex, uint256 dataType); error CannotSubmitExtraDataBeforeMainData(); error ExtraDataAlreadyProcessed(); error UnexpectedExtraDataHash(bytes32 consensusHash, bytes32 receivedHash); error UnexpectedExtraDataFormat(uint256 expectedFormat, uint256 receivedFormat); error ExtraDataItemsCountCannotBeZeroForNonEmptyData(); error ExtraDataHashCannotBeZeroForNonEmptyData(); error UnexpectedExtraDataItemsCount(uint256 expectedCount, uint256 receivedCount); error UnexpectedExtraDataIndex(uint256 expectedIndex, uint256 receivedIndex); error InvalidExtraDataItem(uint256 itemIndex); error InvalidExtraDataSortOrder(uint256 itemIndex); event ExtraDataSubmitted(uint256 indexed refSlot, uint256 itemsProcessed, uint256 itemsCount); event WarnExtraDataIncompleteProcessing(uint256 indexed refSlot, uint256 processedItemsCount, uint256 itemsCount); struct ExtraDataProcessingState { uint64 refSlot; uint16 dataFormat; bool submitted; uint64 itemsCount; uint64 itemsProcessed; uint256 lastSortingKey; bytes32 dataHash; } /// @notice An ACL role granting the permission to submit the data for a committee report. bytes32 public constant SUBMIT_DATA_ROLE = keccak256("SUBMIT_DATA_ROLE"); /// @dev Storage slot: ExtraDataProcessingState state bytes32 internal constant EXTRA_DATA_PROCESSING_STATE_POSITION = keccak256("lido.AccountingOracle.extraDataProcessingState"); bytes32 internal constant ZERO_BYTES32 = bytes32(0); ILidoLocator public immutable LOCATOR; /// /// Initialization & admin functions /// constructor( address lidoLocator, uint256 secondsPerSlot, uint256 genesisTime ) BaseOracle(secondsPerSlot, genesisTime) { if (lidoLocator == address(0)) revert LidoLocatorCannotBeZero(); LOCATOR = ILidoLocator(lidoLocator); } function initialize( address admin, address consensusContract, uint256 consensusVersion, uint256 lastProcessingRefSlot ) external { if (admin == address(0)) revert AdminCannotBeZero(); _initialize(admin, consensusContract, consensusVersion, lastProcessingRefSlot); _updateContractVersion(2); _updateContractVersion(3); // ¯\_(ツ)_/¯ } function finalizeUpgrade_v3(uint256 consensusVersion) external { _updateContractVersion(3); _setConsensusVersion(consensusVersion); } /// /// Data provider interface /// struct ReportData { /// /// Oracle consensus info /// /// @dev Version of the oracle consensus rules. Current version expected /// by the oracle can be obtained by calling getConsensusVersion(). uint256 consensusVersion; /// @dev Reference slot for which the report was calculated. If the slot /// contains a block, the state being reported should include all state /// changes resulting from that block. The epoch containing the slot /// should be finalized prior to calculating the report. uint256 refSlot; /// /// CL values /// /// @dev The number of validators on consensus layer that were ever deposited /// via Lido as observed at the reference slot. uint256 numValidators; /// @dev Cumulative balance of all Lido validators on the consensus layer /// as observed at the reference slot. uint256 clBalanceGwei; /// @dev Ids of staking modules that have more exited validators than the number /// stored in the respective staking module contract as observed at the reference /// slot. uint256[] stakingModuleIdsWithNewlyExitedValidators; /// @dev Number of ever exited validators for each of the staking modules from /// the stakingModuleIdsWithNewlyExitedValidators array as observed at the /// reference slot. uint256[] numExitedValidatorsByStakingModule; /// /// EL values /// /// @dev The ETH balance of the Lido withdrawal vault as observed at the reference slot. uint256 withdrawalVaultBalance; /// @dev The ETH balance of the Lido execution layer rewards vault as observed /// at the reference slot. uint256 elRewardsVaultBalance; /// @dev The shares amount requested to burn through Burner as observed /// at the reference slot. The value can be obtained in the following way: /// `(coverSharesToBurn, nonCoverSharesToBurn) = IBurner(burner).getSharesRequestedToBurn() /// sharesRequestedToBurn = coverSharesToBurn + nonCoverSharesToBurn` uint256 sharesRequestedToBurn; /// /// Decision /// /// @dev The ascendingly-sorted array of withdrawal request IDs obtained by calling /// WithdrawalQueue.calculateFinalizationBatches. Empty array means that no withdrawal /// requests should be finalized. uint256[] withdrawalFinalizationBatches; /// @dev Whether, based on the state observed at the reference slot, the protocol should /// be in the bunker mode. bool isBunkerMode; /// /// Liquid Staking Vaults /// /// @dev Merkle Tree root of the vaults data. bytes32 vaultsDataTreeRoot; /// @notice CID of the published Merkle tree of the vault data. string vaultsDataTreeCid; /// /// Extra data — the oracle information that allows asynchronous processing in /// chunks, after the main data is processed. The oracle doesn't enforce that extra data /// attached to some data report is processed in full before the processing deadline expires /// or a new data report starts being processed, but enforces that no processing of extra /// data for a report is possible after its processing deadline passes or a new data report /// arrives. /// /// Extra data is an array of items, each item being encoded as follows: /// /// 3 bytes 2 bytes X bytes /// | itemIndex | itemType | itemPayload | /// /// itemIndex is a 0-based index into the extra data array; /// itemType is the type of extra data item; /// itemPayload is the item's data which interpretation depends on the item's type. /// /// Items should be sorted ascendingly by the (itemType, ...itemSortingKey) compound key /// where `itemSortingKey` calculation depends on the item's type (see below). /// /// ---------------------------------------------------------------------------------------- /// /// itemType=0 (EXTRA_DATA_TYPE_STUCK_VALIDATORS): stuck validators by node operators. /// itemPayload format: /// /// | 3 bytes | 8 bytes | nodeOpsCount * 8 bytes | nodeOpsCount * 16 bytes | /// | moduleId | nodeOpsCount | nodeOperatorIds | stuckValidatorsCounts | /// /// moduleId is the staking module for which exited keys counts are being reported. /// /// nodeOperatorIds contains an array of ids of node operators that have total stuck /// validators counts changed compared to the staking module smart contract storage as /// observed at the reference slot. Each id is a 8-byte uint, ids are packed tightly. /// /// nodeOpsCount contains the number of node operator ids contained in the nodeOperatorIds /// array. Thus, nodeOpsCount = byteLength(nodeOperatorIds) / 8. /// /// stuckValidatorsCounts contains an array of stuck validators total counts, as observed at /// the reference slot, for the node operators from the nodeOperatorIds array, in the same /// order. Each count is a 16-byte uint, counts are packed tightly. Thus, /// byteLength(stuckValidatorsCounts) = nodeOpsCount * 16. /// /// nodeOpsCount must not be greater than maxNodeOperatorsPerExtraDataItem specified /// in OracleReportSanityChecker contract. If a staking module has more node operators /// with total stuck validators counts changed compared to the staking module smart contract /// storage (as observed at the reference slot), reporting for that module should be split /// into multiple items. /// /// Item sorting key is a compound key consisting of the module id and the first reported /// node operator's id: /// /// itemSortingKey = (moduleId, nodeOperatorIds[0:8]) /// /// ---------------------------------------------------------------------------------------- /// /// itemType=1 (EXTRA_DATA_TYPE_EXITED_VALIDATORS): exited validators by node operators. /// /// The payload format is exactly the same as for itemType=EXTRA_DATA_TYPE_STUCK_VALIDATORS, /// except that, instead of stuck validators counts, exited validators counts are reported. /// The `itemSortingKey` is calculated identically. /// /// ---------------------------------------------------------------------------------------- /// /// The oracle daemon should report exited/stuck validators counts ONLY for those /// (moduleId, nodeOperatorId) pairs that contain outdated counts in the staking /// module smart contract as observed at the reference slot. /// /// Extra data array can be passed in different formats, see below. /// /// @dev Format of the extra data. /// /// Currently, only the EXTRA_DATA_FORMAT_EMPTY=0 and EXTRA_DATA_FORMAT_LIST=1 /// formats are supported. See the constant defining a specific data format for /// more info. /// uint256 extraDataFormat; /// @dev Hash of the extra data. See the constant defining a specific extra data /// format for the info on how to calculate the hash. /// bytes32 extraDataHash; /// @dev Number of the extra data items. /// /// Must be set to zero if the oracle report contains no extra data. /// uint256 extraDataItemsCount; } uint256 public constant EXTRA_DATA_TYPE_STUCK_VALIDATORS = 1; uint256 public constant EXTRA_DATA_TYPE_EXITED_VALIDATORS = 2; /// @notice The extra data format used to signify that the oracle report contains no extra data. /// /// The `extraDataHash` in `ReportData` must be set to a `ZERO_BYTES32` /// uint256 public constant EXTRA_DATA_FORMAT_EMPTY = 0; /// @notice The list format for the extra data array. Used when the oracle reports contains extra data. /// /// When extra data is included in a report, it may be split across one or more transactions. /// Each transaction contains: /// 1) A 32-byte keccak256 hash of the next transaction's data (or `ZERO_BYTES32` if none), /// 2) A chunk of report items (an array of items). /// /// | 32 bytes | X bytes | /// | Next transaction's data hash or `ZERO_BYTES32` | array of items | /// /// The `extraDataHash` in `ReportData` is calculated as shown in the example below: /// /// ReportData.extraDataHash := hash0 /// hash0 := keccak256(| hash1 | extraData[0], ... extraData[n] |) /// hash1 := keccak256(| hash2 | extraData[n + 1], ... extraData[m] |) /// ... /// hashK := keccak256(| ZERO_BYTES32 | extraData[x + 1], ... extraData[extraDataItemsCount] |) /// uint256 public constant EXTRA_DATA_FORMAT_LIST = 1; /// @notice Submits report data for processing. /// /// @param data The data. See the `ReportData` structure's docs for details. /// @param contractVersion Expected version of the oracle contract. /// /// Reverts if: /// - The caller is not a member of the oracle committee and doesn't possess the /// SUBMIT_DATA_ROLE. /// - The provided contract version is different from the current one. /// - The provided consensus version is different from the expected one. /// - The provided reference slot differs from the current consensus frame's one. /// - The processing deadline for the current consensus frame is missed. /// - The keccak256 hash of the ABI-encoded data is different from the last hash /// provided by the hash consensus contract. /// - The provided data doesn't meet safety checks. /// function submitReportData(ReportData calldata data, uint256 contractVersion) external { _checkMsgSenderIsAllowedToSubmitData(); _checkContractVersion(contractVersion); _checkConsensusData(data.refSlot, data.consensusVersion, keccak256(abi.encode(data))); uint256 prevRefSlot = _startProcessing(); _handleConsensusReportData(data, prevRefSlot); } /// @notice Triggers the processing required when no extra data is present in the report, /// i.e. when extra data format equals EXTRA_DATA_FORMAT_EMPTY. /// function submitReportExtraDataEmpty() external { _submitReportExtraDataEmpty(); } /// @notice Submits report extra data in the EXTRA_DATA_FORMAT_LIST format for processing. /// /// @param data The extra data chunk. See docs for the `EXTRA_DATA_FORMAT_LIST` /// constant for details. /// function submitReportExtraDataList(bytes calldata data) external { _submitReportExtraDataList(data); } struct ProcessingState { /// @notice Reference slot for the current reporting frame. uint256 currentFrameRefSlot; /// @notice The last time at which a data can be submitted for the current reporting frame. uint256 processingDeadlineTime; /// @notice Hash of the main report data. Zero bytes if consensus on the hash hasn't been /// reached yet for the current reporting frame. bytes32 mainDataHash; /// @notice Whether the main report data for the current reporting frame has already been /// submitted. bool mainDataSubmitted; /// @notice Hash of the extra report data. Should be ignored unless `mainDataSubmitted` /// is true. bytes32 extraDataHash; /// @notice Format of the extra report data for the current reporting frame. Should be /// ignored unless `mainDataSubmitted` is true. uint256 extraDataFormat; /// @notice Whether any extra report data for the current reporting frame has been submitted. bool extraDataSubmitted; /// @notice Total number of extra report data items for the current reporting frame. /// Should be ignored unless `mainDataSubmitted` is true. uint256 extraDataItemsCount; /// @notice How many extra report data items are already submitted for the current /// reporting frame. uint256 extraDataItemsSubmitted; } /// @notice Returns data processing state for the current reporting frame. /// @return result See the docs for the `ProcessingState` struct. /// function getProcessingState() external view returns (ProcessingState memory result) { ConsensusReport memory report = _storageConsensusReport().value; result.currentFrameRefSlot = _getCurrentRefSlot(); if (report.hash == ZERO_BYTES32 || result.currentFrameRefSlot != report.refSlot) { return result; } result.processingDeadlineTime = report.processingDeadlineTime; result.mainDataHash = report.hash; uint256 processingRefSlot = LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256(); result.mainDataSubmitted = report.refSlot == processingRefSlot; if (!result.mainDataSubmitted) { return result; } ExtraDataProcessingState memory extraState = _storageExtraDataProcessingState().value; result.extraDataHash = extraState.dataHash; result.extraDataFormat = extraState.dataFormat; result.extraDataSubmitted = extraState.submitted; result.extraDataItemsCount = extraState.itemsCount; result.extraDataItemsSubmitted = extraState.itemsProcessed; } /// /// Implementation & helpers /// function _initialize( address admin, address consensusContract, uint256 consensusVersion, uint256 lastProcessingRefSlot ) internal { _setupRole(DEFAULT_ADMIN_ROLE, admin); BaseOracle._initialize(consensusContract, consensusVersion, lastProcessingRefSlot); } function _handleConsensusReport( ConsensusReport memory /* report */, uint256 /* prevSubmittedRefSlot */, uint256 prevProcessingRefSlot ) internal override { ExtraDataProcessingState memory state = _storageExtraDataProcessingState().value; if (state.refSlot == prevProcessingRefSlot && (!state.submitted || state.itemsProcessed < state.itemsCount)) { emit WarnExtraDataIncompleteProcessing(prevProcessingRefSlot, state.itemsProcessed, state.itemsCount); } } function _checkMsgSenderIsAllowedToSubmitData() internal view { address sender = _msgSender(); if (!hasRole(SUBMIT_DATA_ROLE, sender) && !_isConsensusMember(sender)) { revert SenderNotAllowed(); } } function _handleConsensusReportData(ReportData calldata data, uint256 prevRefSlot) internal { if (data.extraDataFormat == EXTRA_DATA_FORMAT_EMPTY) { if (data.extraDataHash != ZERO_BYTES32) { revert UnexpectedExtraDataHash(ZERO_BYTES32, data.extraDataHash); } if (data.extraDataItemsCount != 0) { revert UnexpectedExtraDataItemsCount(0, data.extraDataItemsCount); } } else { if (data.extraDataFormat != EXTRA_DATA_FORMAT_LIST) { revert UnsupportedExtraDataFormat(data.extraDataFormat); } if (data.extraDataItemsCount == 0) { revert ExtraDataItemsCountCannotBeZeroForNonEmptyData(); } if (data.extraDataHash == ZERO_BYTES32) { revert ExtraDataHashCannotBeZeroForNonEmptyData(); } } uint256 slotsElapsed = data.refSlot - prevRefSlot; IStakingRouter stakingRouter = IStakingRouter(LOCATOR.stakingRouter()); IWithdrawalQueue withdrawalQueue = IWithdrawalQueue(LOCATOR.withdrawalQueue()); _processStakingRouterExitedValidatorsByModule( stakingRouter, data.stakingModuleIdsWithNewlyExitedValidators, data.numExitedValidatorsByStakingModule, slotsElapsed ); withdrawalQueue.onOracleReport( data.isBunkerMode, GENESIS_TIME + prevRefSlot * SECONDS_PER_SLOT, GENESIS_TIME + data.refSlot * SECONDS_PER_SLOT ); IReportReceiver(LOCATOR.accounting()).handleOracleReport( ReportValues( GENESIS_TIME + data.refSlot * SECONDS_PER_SLOT, slotsElapsed * SECONDS_PER_SLOT, data.numValidators, data.clBalanceGwei * 1e9, data.withdrawalVaultBalance, data.elRewardsVaultBalance, data.sharesRequestedToBurn, data.withdrawalFinalizationBatches ) ); ILazyOracle(LOCATOR.lazyOracle()).updateReportData( GENESIS_TIME + data.refSlot * SECONDS_PER_SLOT, data.vaultsDataTreeRoot, data.vaultsDataTreeCid ); _storageExtraDataProcessingState().value = ExtraDataProcessingState({ refSlot: data.refSlot.toUint64(), dataFormat: data.extraDataFormat.toUint16(), submitted: false, dataHash: data.extraDataHash, itemsCount: data.extraDataItemsCount.toUint16(), itemsProcessed: 0, lastSortingKey: 0 }); } function _processStakingRouterExitedValidatorsByModule( IStakingRouter stakingRouter, uint256[] calldata stakingModuleIds, uint256[] calldata numExitedValidatorsByStakingModule, uint256 slotsElapsed ) internal { if (stakingModuleIds.length != numExitedValidatorsByStakingModule.length) { revert InvalidExitedValidatorsData(); } if (stakingModuleIds.length == 0) { return; } for (uint256 i = 1; i < stakingModuleIds.length; ) { if (stakingModuleIds[i] <= stakingModuleIds[i - 1]) { revert InvalidExitedValidatorsData(); } unchecked { ++i; } } for (uint256 i = 0; i < stakingModuleIds.length; ) { if (numExitedValidatorsByStakingModule[i] == 0) { revert InvalidExitedValidatorsData(); } unchecked { ++i; } } uint256 newlyExitedValidatorsCount = stakingRouter.updateExitedValidatorsCountByStakingModule( stakingModuleIds, numExitedValidatorsByStakingModule ); uint256 exitedValidatorsRatePerDay = (newlyExitedValidatorsCount * (1 days)) / (SECONDS_PER_SLOT * slotsElapsed); IOracleReportSanityChecker(LOCATOR.oracleReportSanityChecker()).checkExitedValidatorsRatePerDay( exitedValidatorsRatePerDay ); } function _submitReportExtraDataEmpty() internal { ExtraDataProcessingState memory procState = _storageExtraDataProcessingState().value; _checkCanSubmitExtraData(procState, EXTRA_DATA_FORMAT_EMPTY); if (procState.submitted) revert ExtraDataAlreadyProcessed(); IStakingRouter(LOCATOR.stakingRouter()).onValidatorsCountsByNodeOperatorReportingFinished(); _storageExtraDataProcessingState().value.submitted = true; emit ExtraDataSubmitted(procState.refSlot, 0, 0); } function _checkCanSubmitExtraData(ExtraDataProcessingState memory procState, uint256 format) internal view { _checkMsgSenderIsAllowedToSubmitData(); ConsensusReport memory report = _storageConsensusReport().value; if (report.hash == ZERO_BYTES32 || procState.refSlot != report.refSlot) { revert CannotSubmitExtraDataBeforeMainData(); } _checkProcessingDeadline(); if (procState.dataFormat != format) { revert UnexpectedExtraDataFormat(procState.dataFormat, format); } } struct ExtraDataIterState { uint256 index; uint256 itemType; uint256 dataOffset; uint256 lastSortingKey; // config address stakingRouter; } function _submitReportExtraDataList(bytes calldata data) internal { ExtraDataProcessingState memory procState = _storageExtraDataProcessingState().value; _checkCanSubmitExtraData(procState, EXTRA_DATA_FORMAT_LIST); if (procState.itemsProcessed == procState.itemsCount) { revert ExtraDataAlreadyProcessed(); } bytes32 dataHash = keccak256(data); if (dataHash != procState.dataHash) { revert UnexpectedExtraDataHash(procState.dataHash, dataHash); } // load the next hash value assembly { dataHash := calldataload(data.offset) } ExtraDataIterState memory iter = ExtraDataIterState({ index: procState.itemsProcessed > 0 ? procState.itemsProcessed - 1 : 0, itemType: 0, dataOffset: 32, // skip the next hash bytes lastSortingKey: procState.lastSortingKey, stakingRouter: LOCATOR.stakingRouter() }); _processExtraDataItems(data, iter); uint256 itemsProcessed = iter.index + 1; if (dataHash == ZERO_BYTES32) { if (itemsProcessed != procState.itemsCount) { revert UnexpectedExtraDataItemsCount(procState.itemsCount, itemsProcessed); } procState.submitted = true; procState.itemsProcessed = uint64(itemsProcessed); procState.lastSortingKey = iter.lastSortingKey; _storageExtraDataProcessingState().value = procState; IStakingRouter(iter.stakingRouter).onValidatorsCountsByNodeOperatorReportingFinished(); } else { if (itemsProcessed >= procState.itemsCount) { revert UnexpectedExtraDataItemsCount(procState.itemsCount, itemsProcessed); } // save the next hash value procState.dataHash = dataHash; procState.itemsProcessed = uint64(itemsProcessed); procState.lastSortingKey = iter.lastSortingKey; _storageExtraDataProcessingState().value = procState; } emit ExtraDataSubmitted(procState.refSlot, procState.itemsProcessed, procState.itemsCount); } function _processExtraDataItems(bytes calldata data, ExtraDataIterState memory iter) internal { uint256 dataOffset = iter.dataOffset; uint256 maxNodeOperatorsPerItem = 0; uint256 maxNodeOperatorItemIndex = 0; uint256 itemsCount; uint256 index; uint256 itemType; while (dataOffset < data.length) { /// @solidity memory-safe-assembly assembly { // layout at the dataOffset: // | 3 bytes | 2 bytes | X bytes | // | itemIndex | itemType | itemPayload | let header := calldataload(add(data.offset, dataOffset)) index := shr(232, header) itemType := and(shr(216, header), 0xffff) dataOffset := add(dataOffset, 5) } if (iter.lastSortingKey == 0) { if (index != 0) { revert UnexpectedExtraDataIndex(0, index); } } else if (index != iter.index + 1) { revert UnexpectedExtraDataIndex(iter.index + 1, index); } iter.index = index; iter.itemType = itemType; iter.dataOffset = dataOffset; /// @dev The EXTRA_DATA_TYPE_STUCK_VALIDATORS item type was deprecated in the Triggerable Withdrawals update. /// The mechanism for handling stuck validator keys is no longer supported and has been removed. if (itemType == EXTRA_DATA_TYPE_STUCK_VALIDATORS) { revert DeprecatedExtraDataType(index, itemType); } if (itemType != EXTRA_DATA_TYPE_EXITED_VALIDATORS) { revert UnsupportedExtraDataType(index, itemType); } uint256 nodeOpsProcessed = _processExtraDataItem(data, iter); if (nodeOpsProcessed > maxNodeOperatorsPerItem) { maxNodeOperatorsPerItem = nodeOpsProcessed; maxNodeOperatorItemIndex = index; } assert(iter.dataOffset > dataOffset); dataOffset = iter.dataOffset; unchecked { // overflow is not possible here ++itemsCount; } } assert(maxNodeOperatorsPerItem > 0); IOracleReportSanityChecker(LOCATOR.oracleReportSanityChecker()) .checkExtraDataItemsCountPerTransaction(itemsCount); IOracleReportSanityChecker(LOCATOR.oracleReportSanityChecker()).checkNodeOperatorsPerExtraDataItemCount( maxNodeOperatorItemIndex, maxNodeOperatorsPerItem ); } function _processExtraDataItem(bytes calldata data, ExtraDataIterState memory iter) internal returns (uint256) { uint256 dataOffset = iter.dataOffset; uint256 moduleId; uint256 nodeOpsCount; uint256 nodeOpId; bytes calldata nodeOpIds; bytes calldata valuesCounts; if (dataOffset + 35 > data.length) { // has to fit at least moduleId (3 bytes), nodeOpsCount (8 bytes), // and data for one node operator (8 + 16 bytes), total 35 bytes revert InvalidExtraDataItem(iter.index); } /// @solidity memory-safe-assembly assembly { // layout at the dataOffset: // | 3 bytes | 8 bytes | nodeOpsCount * 8 bytes | nodeOpsCount * 16 bytes | // | moduleId | nodeOpsCount | nodeOperatorIds | validatorsCounts | let header := calldataload(add(data.offset, dataOffset)) moduleId := shr(232, header) nodeOpsCount := and(shr(168, header), 0xffffffffffffffff) nodeOpIds.offset := add(data.offset, add(dataOffset, 11)) nodeOpIds.length := mul(nodeOpsCount, 8) // read the 1st node operator id for checking the sorting order later nodeOpId := shr(192, calldataload(nodeOpIds.offset)) valuesCounts.offset := add(nodeOpIds.offset, nodeOpIds.length) valuesCounts.length := mul(nodeOpsCount, 16) dataOffset := sub(add(valuesCounts.offset, valuesCounts.length), data.offset) } if (moduleId == 0) { revert InvalidExtraDataItem(iter.index); } unchecked { // firstly, check the sorting order between the 1st item's element and the last one of the previous item // | 2 bytes | 19 bytes | 3 bytes | 8 bytes | // | itemType | 00000000 | moduleId | nodeOpId | uint256 sortingKey = (iter.itemType << 240) | (moduleId << 64) | nodeOpId; if (sortingKey <= iter.lastSortingKey) { revert InvalidExtraDataSortOrder(iter.index); } // secondly, check the sorting order between the rest of the elements uint256 tmpNodeOpId; for (uint256 i = 1; i < nodeOpsCount;) { /// @solidity memory-safe-assembly assembly { tmpNodeOpId := shr(192, calldataload(add(nodeOpIds.offset, mul(i, 8)))) i := add(i, 1) } if (tmpNodeOpId <= nodeOpId) { revert InvalidExtraDataSortOrder(iter.index); } nodeOpId = tmpNodeOpId; } // update the last sorting key with the last item's element iter.lastSortingKey = ((sortingKey >> 64) << 64) | nodeOpId; } if (dataOffset > data.length || nodeOpsCount == 0) { revert InvalidExtraDataItem(iter.index); } IStakingRouter(iter.stakingRouter) .reportStakingModuleExitedValidatorsCountByNodeOperator(moduleId, nodeOpIds, valuesCounts); iter.dataOffset = dataOffset; return nodeOpsCount; } /// /// Storage helpers /// struct StorageExtraDataProcessingState { ExtraDataProcessingState value; } function _storageExtraDataProcessingState() internal pure returns (StorageExtraDataProcessingState storage r) { bytes32 position = EXTRA_DATA_PROCESSING_STATE_POSITION; assembly { r.slot := position } } }
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
pragma solidity ^0.8.0;
/**
* @dev External interface of AccessControl declared to support ERC165 detection.
*/
interface IAccessControl {
/**
* @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
*
* `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
* {RoleAdminChanged} not being emitted signaling this.
*
* _Available since v3.1._
*/
event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
/**
* @dev Emitted when `account` is granted `role`.
*
* `sender` is the account that originated the contract call, an admin role
* bearer except when using {AccessControl-_setupRole}.
*/
event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Emitted when `account` is revoked `role`.
*
* `sender` is the account that originated the contract call:
* - if using `revokeRole`, it is the admin role bearer
* - if using `renounceRole`, it is the role bearer (i.e. `account`)
*/
event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) external view returns (bool);
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {AccessControl-_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) external view returns (bytes32);
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been granted `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) external;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol)
pragma solidity ^0.8.0;
import "./IAccessControl.sol";
/**
* @dev External interface of AccessControlEnumerable declared to support ERC165 detection.
*/
interface IAccessControlEnumerable is IAccessControl {
/**
* @dev Returns one of the accounts that have `role`. `index` must be a
* value between 0 and {getRoleMemberCount}, non-inclusive.
*
* Role bearers are not sorted in any particular way, and their ordering may
* change at any point.
*
* WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
* you perform all queries on the same block. See the following
* https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
* for more information.
*/
function getRoleMember(bytes32 role, uint256 index) external view returns (address);
/**
* @dev Returns the number of accounts that have `role`. Can be used
* together with {getRoleMember} to enumerate all bearers of a role.
*/
function getRoleMemberCount(bytes32 role) external view returns (uint256);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
pragma solidity ^0.8.0;
import "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/math/SafeCast.sol)
pragma solidity ^0.8.0;
/**
* @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow
* checks.
*
* Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
* easily result in undesired exploitation or bugs, since developers usually
* assume that overflows raise errors. `SafeCast` restores this intuition by
* reverting the transaction when such an operation overflows.
*
* Using this library instead of the unchecked operations eliminates an entire
* class of bugs, so it's recommended to use it always.
*
* Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing
* all math on `uint256` and `int256` and then downcasting.
*/
library SafeCast {
/**
* @dev Returns the downcasted uint224 from uint256, reverting on
* overflow (when the input is greater than largest uint224).
*
* Counterpart to Solidity's `uint224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toUint224(uint256 value) internal pure returns (uint224) {
require(value <= type(uint224).max, "SafeCast: value doesn't fit in 224 bits");
return uint224(value);
}
/**
* @dev Returns the downcasted uint128 from uint256, reverting on
* overflow (when the input is greater than largest uint128).
*
* Counterpart to Solidity's `uint128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toUint128(uint256 value) internal pure returns (uint128) {
require(value <= type(uint128).max, "SafeCast: value doesn't fit in 128 bits");
return uint128(value);
}
/**
* @dev Returns the downcasted uint96 from uint256, reverting on
* overflow (when the input is greater than largest uint96).
*
* Counterpart to Solidity's `uint96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toUint96(uint256 value) internal pure returns (uint96) {
require(value <= type(uint96).max, "SafeCast: value doesn't fit in 96 bits");
return uint96(value);
}
/**
* @dev Returns the downcasted uint64 from uint256, reverting on
* overflow (when the input is greater than largest uint64).
*
* Counterpart to Solidity's `uint64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toUint64(uint256 value) internal pure returns (uint64) {
require(value <= type(uint64).max, "SafeCast: value doesn't fit in 64 bits");
return uint64(value);
}
/**
* @dev Returns the downcasted uint32 from uint256, reverting on
* overflow (when the input is greater than largest uint32).
*
* Counterpart to Solidity's `uint32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toUint32(uint256 value) internal pure returns (uint32) {
require(value <= type(uint32).max, "SafeCast: value doesn't fit in 32 bits");
return uint32(value);
}
/**
* @dev Returns the downcasted uint16 from uint256, reverting on
* overflow (when the input is greater than largest uint16).
*
* Counterpart to Solidity's `uint16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toUint16(uint256 value) internal pure returns (uint16) {
require(value <= type(uint16).max, "SafeCast: value doesn't fit in 16 bits");
return uint16(value);
}
/**
* @dev Returns the downcasted uint8 from uint256, reverting on
* overflow (when the input is greater than largest uint8).
*
* Counterpart to Solidity's `uint8` operator.
*
* Requirements:
*
* - input must fit into 8 bits.
*/
function toUint8(uint256 value) internal pure returns (uint8) {
require(value <= type(uint8).max, "SafeCast: value doesn't fit in 8 bits");
return uint8(value);
}
/**
* @dev Converts a signed int256 into an unsigned uint256.
*
* Requirements:
*
* - input must be greater than or equal to 0.
*/
function toUint256(int256 value) internal pure returns (uint256) {
require(value >= 0, "SafeCast: value must be positive");
return uint256(value);
}
/**
* @dev Returns the downcasted int128 from int256, reverting on
* overflow (when the input is less than smallest int128 or
* greater than largest int128).
*
* Counterpart to Solidity's `int128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*
* _Available since v3.1._
*/
function toInt128(int256 value) internal pure returns (int128) {
require(value >= type(int128).min && value <= type(int128).max, "SafeCast: value doesn't fit in 128 bits");
return int128(value);
}
/**
* @dev Returns the downcasted int64 from int256, reverting on
* overflow (when the input is less than smallest int64 or
* greater than largest int64).
*
* Counterpart to Solidity's `int64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*
* _Available since v3.1._
*/
function toInt64(int256 value) internal pure returns (int64) {
require(value >= type(int64).min && value <= type(int64).max, "SafeCast: value doesn't fit in 64 bits");
return int64(value);
}
/**
* @dev Returns the downcasted int32 from int256, reverting on
* overflow (when the input is less than smallest int32 or
* greater than largest int32).
*
* Counterpart to Solidity's `int32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*
* _Available since v3.1._
*/
function toInt32(int256 value) internal pure returns (int32) {
require(value >= type(int32).min && value <= type(int32).max, "SafeCast: value doesn't fit in 32 bits");
return int32(value);
}
/**
* @dev Returns the downcasted int16 from int256, reverting on
* overflow (when the input is less than smallest int16 or
* greater than largest int16).
*
* Counterpart to Solidity's `int16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*
* _Available since v3.1._
*/
function toInt16(int256 value) internal pure returns (int16) {
require(value >= type(int16).min && value <= type(int16).max, "SafeCast: value doesn't fit in 16 bits");
return int16(value);
}
/**
* @dev Returns the downcasted int8 from int256, reverting on
* overflow (when the input is less than smallest int8 or
* greater than largest int8).
*
* Counterpart to Solidity's `int8` operator.
*
* Requirements:
*
* - input must fit into 8 bits.
*
* _Available since v3.1._
*/
function toInt8(int256 value) internal pure returns (int8) {
require(value >= type(int8).min && value <= type(int8).max, "SafeCast: value doesn't fit in 8 bits");
return int8(value);
}
/**
* @dev Converts an unsigned uint256 into a signed int256.
*
* Requirements:
*
* - input must be less than or equal to maxInt256.
*/
function toInt256(uint256 value) internal pure returns (int256) {
// Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
require(value <= uint256(type(int256).max), "SafeCast: value doesn't fit in an int256");
return int256(value);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
pragma solidity ^0.8.0;
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
// Inspired by OraclizeAPI's implementation - MIT licence
// https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
if (value == 0) {
return "0";
}
uint256 temp = value;
uint256 digits;
while (temp != 0) {
digits++;
temp /= 10;
}
bytes memory buffer = new bytes(digits);
while (value != 0) {
digits -= 1;
buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
value /= 10;
}
return string(buffer);
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
if (value == 0) {
return "0x00";
}
uint256 temp = value;
uint256 length = 0;
while (temp != 0) {
length++;
temp >>= 8;
}
return toHexString(value, length);
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _HEX_SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/structs/EnumerableSet.sol)
pragma solidity ^0.8.0;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position of the value in the `values` array, plus 1 because index 0
// means a value is not in the set.
mapping(bytes32 => uint256) _indexes;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._indexes[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We read and store the value's index to prevent multiple reads from the same storage slot
uint256 valueIndex = set._indexes[value];
if (valueIndex != 0) {
// Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 toDeleteIndex = valueIndex - 1;
uint256 lastIndex = set._values.length - 1;
if (lastIndex != toDeleteIndex) {
bytes32 lastvalue = set._values[lastIndex];
// Move the last value to the index where the value to delete is
set._values[toDeleteIndex] = lastvalue;
// Update the index for the moved value
set._indexes[lastvalue] = valueIndex; // Replace lastvalue's index to valueIndex
}
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the index for the deleted slot
delete set._indexes[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._indexes[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
return set._values[index];
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function _values(Set storage set) private view returns (bytes32[] memory) {
return set._values;
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
return _values(set._inner);
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(AddressSet storage set) internal view returns (address[] memory) {
bytes32[] memory store = _values(set._inner);
address[] memory result;
assembly {
result := store
}
return result;
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(UintSet storage set) internal view returns (uint256[] memory) {
bytes32[] memory store = _values(set._inner);
uint256[] memory result;
assembly {
result := store
}
return result;
}
}// SPDX-FileCopyrightText: 2023 Lido <[email protected]> // SPDX-License-Identifier: MIT // See contracts/COMPILERS.md pragma solidity 0.8.9; library Math { function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /// @notice Tests if x ∈ [a, b) (mod n) /// function pointInHalfOpenIntervalModN(uint256 x, uint256 a, uint256 b, uint256 n) internal pure returns (bool) { return (x + n - a) % n < (b - a) % n; } /// @notice Tests if x ∈ [a, b] (mod n) /// function pointInClosedIntervalModN(uint256 x, uint256 a, uint256 b, uint256 n) internal pure returns (bool) { return (x + n - a) % n <= (b - a) % n; } }
/*
* SPDX-License-Identifier: MIT
*/
pragma solidity 0.8.9;
/**
* @notice Aragon Unstructured Storage library
*/
library UnstructuredStorage {
function getStorageBool(bytes32 position) internal view returns (bool data) {
assembly { data := sload(position) }
}
function getStorageAddress(bytes32 position) internal view returns (address data) {
assembly { data := sload(position) }
}
function getStorageBytes32(bytes32 position) internal view returns (bytes32 data) {
assembly { data := sload(position) }
}
function getStorageUint256(bytes32 position) internal view returns (uint256 data) {
assembly { data := sload(position) }
}
function setStorageBool(bytes32 position, bool data) internal {
assembly { sstore(position, data) }
}
function setStorageAddress(bytes32 position, address data) internal {
assembly { sstore(position, data) }
}
function setStorageBytes32(bytes32 position, bytes32 data) internal {
assembly { sstore(position, data) }
}
function setStorageUint256(bytes32 position, uint256 data) internal {
assembly { sstore(position, data) }
}
}// SPDX-FileCopyrightText: 2023 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 pragma solidity 0.8.9; import { SafeCast } from "@openzeppelin/contracts-v4.4/utils/math/SafeCast.sol"; import { UnstructuredStorage } from "../lib/UnstructuredStorage.sol"; import { Versioned } from "../utils/Versioned.sol"; import { AccessControlEnumerable } from "../utils/access/AccessControlEnumerable.sol"; import { IReportAsyncProcessor } from "./HashConsensus.sol"; interface IConsensusContract { function getIsMember(address addr) external view returns (bool); function getCurrentFrame() external view returns ( uint256 refSlot, uint256 reportProcessingDeadlineSlot ); function getChainConfig() external view returns ( uint256 slotsPerEpoch, uint256 secondsPerSlot, uint256 genesisTime ); function getFrameConfig() external view returns (uint256 initialEpoch, uint256 epochsPerFrame); function getInitialRefSlot() external view returns (uint256); } abstract contract BaseOracle is IReportAsyncProcessor, AccessControlEnumerable, Versioned { using UnstructuredStorage for bytes32; using SafeCast for uint256; error AddressCannotBeZero(); error AddressCannotBeSame(); error VersionCannotBeSame(); error UnexpectedChainConfig(); error SenderIsNotTheConsensusContract(); error InitialRefSlotCannotBeLessThanProcessingOne(uint256 initialRefSlot, uint256 processingRefSlot); error RefSlotMustBeGreaterThanProcessingOne(uint256 refSlot, uint256 processingRefSlot); error RefSlotCannotDecrease(uint256 refSlot, uint256 prevRefSlot); error NoConsensusReportToProcess(); error ProcessingDeadlineMissed(uint256 deadline); error RefSlotAlreadyProcessing(); error UnexpectedRefSlot(uint256 consensusRefSlot, uint256 dataRefSlot); error UnexpectedConsensusVersion(uint256 expectedVersion, uint256 receivedVersion); error HashCannotBeZero(); error UnexpectedDataHash(bytes32 consensusHash, bytes32 receivedHash); error SecondsPerSlotCannotBeZero(); event ConsensusHashContractSet(address indexed addr, address indexed prevAddr); event ConsensusVersionSet(uint256 indexed version, uint256 indexed prevVersion); event ReportSubmitted(uint256 indexed refSlot, bytes32 hash, uint256 processingDeadlineTime); event ReportDiscarded(uint256 indexed refSlot, bytes32 hash); event ProcessingStarted(uint256 indexed refSlot, bytes32 hash); event WarnProcessingMissed(uint256 indexed refSlot); struct ConsensusReport { bytes32 hash; uint64 refSlot; uint64 processingDeadlineTime; } /// @notice An ACL role granting the permission to set the consensus /// contract address by calling setConsensusContract. bytes32 public constant MANAGE_CONSENSUS_CONTRACT_ROLE = keccak256("MANAGE_CONSENSUS_CONTRACT_ROLE"); /// @notice An ACL role granting the permission to set the consensus /// version by calling setConsensusVersion. bytes32 public constant MANAGE_CONSENSUS_VERSION_ROLE = keccak256("MANAGE_CONSENSUS_VERSION_ROLE"); /// @dev Storage slot: address consensusContract bytes32 internal constant CONSENSUS_CONTRACT_POSITION = keccak256("lido.BaseOracle.consensusContract"); /// @dev Storage slot: uint256 consensusVersion bytes32 internal constant CONSENSUS_VERSION_POSITION = keccak256("lido.BaseOracle.consensusVersion"); /// @dev Storage slot: uint256 lastProcessingRefSlot bytes32 internal constant LAST_PROCESSING_REF_SLOT_POSITION = keccak256("lido.BaseOracle.lastProcessingRefSlot"); /// @dev Storage slot: ConsensusReport consensusReport bytes32 internal constant CONSENSUS_REPORT_POSITION = keccak256("lido.BaseOracle.consensusReport"); uint256 public immutable SECONDS_PER_SLOT; uint256 public immutable GENESIS_TIME; /// /// Initialization & admin functions /// constructor(uint256 secondsPerSlot, uint256 genesisTime) { if (secondsPerSlot == 0) revert SecondsPerSlotCannotBeZero(); SECONDS_PER_SLOT = secondsPerSlot; GENESIS_TIME = genesisTime; } /// @notice Returns the address of the HashConsensus contract. /// function getConsensusContract() external view returns (address) { return CONSENSUS_CONTRACT_POSITION.getStorageAddress(); } /// @notice Sets the address of the HashConsensus contract. /// function setConsensusContract(address addr) external onlyRole(MANAGE_CONSENSUS_CONTRACT_ROLE) { _setConsensusContract(addr, LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256()); } /// @notice Returns the current consensus version expected by the oracle contract. /// /// Consensus version must change every time consensus rules change, meaning that /// an oracle looking at the same reference slot would calculate a different hash. /// function getConsensusVersion() external view returns (uint256) { return CONSENSUS_VERSION_POSITION.getStorageUint256(); } /// @notice Sets the consensus version expected by the oracle contract. /// function setConsensusVersion(uint256 version) external onlyRole(MANAGE_CONSENSUS_VERSION_ROLE) { _setConsensusVersion(version); } /// /// Data provider interface /// /// @notice Returns the last consensus report hash and metadata. /// function getConsensusReport() external view returns ( bytes32 hash, uint256 refSlot, uint256 processingDeadlineTime, bool processingStarted ) { ConsensusReport memory report = _storageConsensusReport().value; uint256 processingRefSlot = LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256(); return ( report.hash, report.refSlot, report.processingDeadlineTime, report.hash != bytes32(0) && report.refSlot == processingRefSlot ); } /// /// Consensus contract interface /// /// @notice Called by HashConsensus contract to push a consensus report for processing. /// /// Note that submitting the report doesn't require the processor to start processing it right /// away, this can happen later (see `getLastProcessingRefSlot`). Until processing is started, /// HashConsensus is free to reach consensus on another report for the same reporting frame an /// submit it using this same function, or to lose the consensus on the submitted report, /// notifying the processor via `discardConsensusReport`. /// function submitConsensusReport(bytes32 reportHash, uint256 refSlot, uint256 deadline) external { _checkSenderIsConsensusContract(); uint256 prevSubmittedRefSlot = _storageConsensusReport().value.refSlot; if (refSlot < prevSubmittedRefSlot) { revert RefSlotCannotDecrease(refSlot, prevSubmittedRefSlot); } uint256 prevProcessingRefSlot = LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256(); if (refSlot <= prevProcessingRefSlot) { revert RefSlotMustBeGreaterThanProcessingOne(refSlot, prevProcessingRefSlot); } if (_getTime() > deadline) { revert ProcessingDeadlineMissed(deadline); } if (refSlot != prevSubmittedRefSlot && prevProcessingRefSlot != prevSubmittedRefSlot) { emit WarnProcessingMissed(prevSubmittedRefSlot); } if (reportHash == bytes32(0)) { revert HashCannotBeZero(); } emit ReportSubmitted(refSlot, reportHash, deadline); ConsensusReport memory report = ConsensusReport({ hash: reportHash, refSlot: refSlot.toUint64(), processingDeadlineTime: deadline.toUint64() }); _storageConsensusReport().value = report; _handleConsensusReport(report, prevSubmittedRefSlot, prevProcessingRefSlot); } /// @notice Called by HashConsensus contract to notify that the report for the given ref. slot /// is not a conensus report anymore and should be discarded. This can happen when a member /// changes their report, is removed from the set, or when the quorum value gets increased. /// /// Only called when, for the given reference slot: /// /// 1. there previously was a consensus report; AND /// 1. processing of the consensus report hasn't started yet; AND /// 2. report processing deadline is not expired yet; AND /// 3. there's no consensus report now (otherwise, `submitConsensusReport` is called instead). /// /// Can be called even when there's no submitted non-discarded consensus report for the current /// reference slot, i.e. can be called multiple times in succession. /// function discardConsensusReport(uint256 refSlot) external { _checkSenderIsConsensusContract(); ConsensusReport memory submittedReport = _storageConsensusReport().value; if (refSlot < submittedReport.refSlot) { revert RefSlotCannotDecrease(refSlot, submittedReport.refSlot); } else if (refSlot > submittedReport.refSlot) { return; } uint256 lastProcessingRefSlot = LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256(); if (refSlot <= lastProcessingRefSlot) { revert RefSlotAlreadyProcessing(); } _storageConsensusReport().value.hash = bytes32(0); _handleConsensusReportDiscarded(submittedReport); emit ReportDiscarded(submittedReport.refSlot, submittedReport.hash); } /// @notice Returns the last reference slot for which processing of the report was started. /// function getLastProcessingRefSlot() external view returns (uint256) { return LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256(); } /// /// Descendant contract interface /// /// @notice Initializes the contract storage. Must be called by a descendant /// contract as part of its initialization. /// function _initialize( address consensusContract, uint256 consensusVersion, uint256 lastProcessingRefSlot ) internal virtual { _initializeContractVersionTo(1); _setConsensusContract(consensusContract, lastProcessingRefSlot); _setConsensusVersion(consensusVersion); LAST_PROCESSING_REF_SLOT_POSITION.setStorageUint256(lastProcessingRefSlot); _storageConsensusReport().value.refSlot = lastProcessingRefSlot.toUint64(); } /// @notice Returns whether the given address is a member of the oracle committee. /// function _isConsensusMember(address addr) internal view returns (bool) { address consensus = CONSENSUS_CONTRACT_POSITION.getStorageAddress(); return IConsensusContract(consensus).getIsMember(addr); } /// @notice Called when the oracle gets a new consensus report from the HashConsensus contract. /// /// Keep in mind that, until you call `_startProcessing`, the oracle committee is free to /// reach consensus on another report for the same reporting frame and re-submit it using /// this function, or lose consensus on the report and ask to discard it by calling the /// `_handleConsensusReportDiscarded` function. /// function _handleConsensusReport( ConsensusReport memory report, uint256 prevSubmittedRefSlot, uint256 prevProcessingRefSlot ) internal virtual; /// @notice Called when the HashConsensus contract loses consensus on a previously submitted /// report that is not processing yet and asks to discard this report. Only called if there is /// no new consensus report at the moment; otherwise, `_handleConsensusReport` is called instead. /// function _handleConsensusReportDiscarded(ConsensusReport memory report) internal virtual {} /// @notice May be called by a descendant contract to check if the received data matches /// the currently submitted consensus report. Reverts otherwise. /// function _checkConsensusData(uint256 refSlot, uint256 consensusVersion, bytes32 hash) internal view { ConsensusReport memory report = _storageConsensusReport().value; if (refSlot != report.refSlot) { revert UnexpectedRefSlot(report.refSlot, refSlot); } uint256 expectedConsensusVersion = CONSENSUS_VERSION_POSITION.getStorageUint256(); if (consensusVersion != expectedConsensusVersion) { revert UnexpectedConsensusVersion(expectedConsensusVersion, consensusVersion); } if (hash != report.hash) { revert UnexpectedDataHash(report.hash, hash); } } /// @notice Called by a descendant contract to mark the current consensus report /// as being processed. Returns the last ref. slot which processing was started /// before the call. /// /// Before this function is called, the oracle committee is free to reach consensus /// on another report for the same reporting frame. After this function is called, /// the consensus report for the current frame is guaranteed to remain the same. /// function _startProcessing() internal returns (uint256) { ConsensusReport memory report = _storageConsensusReport().value; if (report.hash == bytes32(0)) { revert NoConsensusReportToProcess(); } _checkProcessingDeadline(report.processingDeadlineTime); uint256 prevProcessingRefSlot = LAST_PROCESSING_REF_SLOT_POSITION.getStorageUint256(); if (prevProcessingRefSlot == report.refSlot) { revert RefSlotAlreadyProcessing(); } LAST_PROCESSING_REF_SLOT_POSITION.setStorageUint256(report.refSlot); emit ProcessingStarted(report.refSlot, report.hash); return prevProcessingRefSlot; } /// @notice Reverts if the processing deadline for the current consensus report is missed. /// function _checkProcessingDeadline() internal view { _checkProcessingDeadline(_storageConsensusReport().value.processingDeadlineTime); } function _checkProcessingDeadline(uint256 deadlineTime) internal view { if (_getTime() > deadlineTime) revert ProcessingDeadlineMissed(deadlineTime); } /// @notice Returns the reference slot for the current frame. /// function _getCurrentRefSlot() internal view returns (uint256) { address consensusContract = CONSENSUS_CONTRACT_POSITION.getStorageAddress(); (uint256 refSlot, ) = IConsensusContract(consensusContract).getCurrentFrame(); return refSlot; } /// /// Implementation & helpers /// function _setConsensusVersion(uint256 version) internal { uint256 prevVersion = CONSENSUS_VERSION_POSITION.getStorageUint256(); if (version == prevVersion) revert VersionCannotBeSame(); CONSENSUS_VERSION_POSITION.setStorageUint256(version); emit ConsensusVersionSet(version, prevVersion); } function _setConsensusContract(address addr, uint256 lastProcessingRefSlot) internal { if (addr == address(0)) revert AddressCannotBeZero(); address prevAddr = CONSENSUS_CONTRACT_POSITION.getStorageAddress(); if (addr == prevAddr) revert AddressCannotBeSame(); (, uint256 secondsPerSlot, uint256 genesisTime) = IConsensusContract(addr).getChainConfig(); if (secondsPerSlot != SECONDS_PER_SLOT || genesisTime != GENESIS_TIME) { revert UnexpectedChainConfig(); } uint256 initialRefSlot = IConsensusContract(addr).getInitialRefSlot(); if (initialRefSlot < lastProcessingRefSlot) { revert InitialRefSlotCannotBeLessThanProcessingOne(initialRefSlot, lastProcessingRefSlot); } CONSENSUS_CONTRACT_POSITION.setStorageAddress(addr); emit ConsensusHashContractSet(addr, prevAddr); } function _checkSenderIsConsensusContract() internal view { if (_msgSender() != CONSENSUS_CONTRACT_POSITION.getStorageAddress()) { revert SenderIsNotTheConsensusContract(); } } function _getTime() internal virtual view returns (uint256) { return block.timestamp; // solhint-disable-line not-rely-on-time } /// /// Storage helpers /// struct StorageConsensusReport { ConsensusReport value; } function _storageConsensusReport() internal pure returns (StorageConsensusReport storage r) { bytes32 position = CONSENSUS_REPORT_POSITION; assembly { r.slot := position } } }
// SPDX-FileCopyrightText: 2023 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 pragma solidity 0.8.9; import { SafeCast } from "@openzeppelin/contracts-v4.4/utils/math/SafeCast.sol"; import { Math } from "../lib/Math.sol"; import { AccessControlEnumerable } from "../utils/access/AccessControlEnumerable.sol"; /// @notice A contract that gets consensus reports (i.e. hashes) pushed to and processes them /// asynchronously. /// /// HashConsensus doesn't expect any specific behavior from a report processor, and guarantees /// the following: /// /// 1. HashConsensus won't submit reports via `IReportAsyncProcessor.submitConsensusReport` or ask /// to discard reports via `IReportAsyncProcessor.discardConsensusReport` for any slot up to (and /// including) the slot returned from `IReportAsyncProcessor.getLastProcessingRefSlot`. /// /// 2. HashConsensus won't accept member reports (and thus won't include such reports in calculating /// the consensus) that have `consensusVersion` argument of the `HashConsensus.submitReport` call /// holding a diff. value than the one returned from `IReportAsyncProcessor.getConsensusVersion()` /// at the moment of the `HashConsensus.submitReport` call. /// interface IReportAsyncProcessor { /// @notice Submits a consensus report for processing. /// /// Note that submitting the report doesn't require the processor to start processing it right /// away, this can happen later (see `getLastProcessingRefSlot`). Until processing is started, /// HashConsensus is free to reach consensus on another report for the same reporting frame an /// submit it using this same function, or to lose the consensus on the submitted report, /// notifying the processor via `discardConsensusReport`. /// function submitConsensusReport(bytes32 report, uint256 refSlot, uint256 deadline) external; /// @notice Notifies that the report for the given ref. slot is not a conensus report anymore /// and should be discarded. This can happen when a member changes their report, is removed /// from the set, or when the quorum value gets increased. /// /// Only called when, for the given reference slot: /// /// 1. there previously was a consensus report; AND /// 1. processing of the consensus report hasn't started yet; AND /// 2. report processing deadline is not expired yet; AND /// 3. there's no consensus report now (otherwise, `submitConsensusReport` is called instead). /// /// Can be called even when there's no submitted non-discarded consensus report for the current /// reference slot, i.e. can be called multiple times in succession. /// function discardConsensusReport(uint256 refSlot) external; /// @notice Returns the last reference slot for which processing of the report was started. /// /// HashConsensus won't submit reports for any slot less than or equal to this slot. /// function getLastProcessingRefSlot() external view returns (uint256); /// @notice Returns the current consensus version. /// /// Consensus version must change every time consensus rules change, meaning that /// an oracle looking at the same reference slot would calculate a different hash. /// /// HashConsensus won't accept member reports any consensus version different form the /// one returned from this function. /// function getConsensusVersion() external view returns (uint256); } /// @notice A contract managing oracle members committee and allowing the members to reach /// consensus on a hash for each reporting frame. /// /// Time is divided in frames of equal length, each having reference slot and processing /// deadline. Report data must be gathered by looking at the world state at the moment of /// the frame's reference slot (including any state changes made in that slot), and must /// be processed before the frame's processing deadline. /// /// Frame length is defined in Ethereum consensus layer epochs. Reference slot for each /// frame is set to the last slot of the epoch preceding the frame's first epoch. The /// processing deadline is set to the last slot of the last epoch of the frame. /// /// This means that all state changes a report processing could entail are guaranteed to be /// observed while gathering data for the next frame's report. This is an important property /// given that oracle reports sometimes have to contain diffs instead of the full state which /// might be impractical or even impossible to transmit and process. /// contract HashConsensus is AccessControlEnumerable { using SafeCast for uint256; error InvalidChainConfig(); error NumericOverflow(); error AdminCannotBeZero(); error ReportProcessorCannotBeZero(); error DuplicateMember(); error AddressCannotBeZero(); error InitialEpochIsYetToArrive(); error InitialEpochAlreadyArrived(); error InitialEpochRefSlotCannotBeEarlierThanProcessingSlot(); error EpochsPerFrameCannotBeZero(); error NonMember(); error UnexpectedConsensusVersion(uint256 expected, uint256 received); error QuorumTooSmall(uint256 minQuorum, uint256 receivedQuorum); error InvalidSlot(); error DuplicateReport(); error EmptyReport(); error StaleReport(); error NonFastLaneMemberCannotReportWithinFastLaneInterval(); error NewProcessorCannotBeTheSame(); error ConsensusReportAlreadyProcessing(); error FastLanePeriodCannotBeLongerThanFrame(); event FrameConfigSet(uint256 newInitialEpoch, uint256 newEpochsPerFrame); event FastLaneConfigSet(uint256 fastLaneLengthSlots); event MemberAdded(address indexed addr, uint256 newTotalMembers, uint256 newQuorum); event MemberRemoved(address indexed addr, uint256 newTotalMembers, uint256 newQuorum); event QuorumSet(uint256 newQuorum, uint256 totalMembers, uint256 prevQuorum); event ReportReceived(uint256 indexed refSlot, address indexed member, bytes32 report); event ConsensusReached(uint256 indexed refSlot, bytes32 report, uint256 support); event ConsensusLost(uint256 indexed refSlot); event ReportProcessorSet(address indexed processor, address indexed prevProcessor); struct FrameConfig { uint64 initialEpoch; uint64 epochsPerFrame; uint64 fastLaneLengthSlots; } /// @dev Oracle reporting is divided into frames, each lasting the same number of slots. /// /// The start slot of the next frame is always the next slot after the end slot of the previous /// frame. /// /// Each frame also has a reference slot: if the oracle report contains any data derived from /// onchain data, the onchain data should be sampled at the reference slot. /// struct ConsensusFrame { // frame index; increments by 1 with each frame but resets to zero on frame size change uint256 index; // the slot at which to read the state around which consensus is being reached; // if the slot contains a block, the state should include all changes from that block uint256 refSlot; // the last slot at which a report can be reported and processed uint256 reportProcessingDeadlineSlot; } struct ReportingState { // the last reference slot any report was received for uint64 lastReportRefSlot; // the last reference slot a consensus was reached for uint64 lastConsensusRefSlot; // the last consensus variant index uint64 lastConsensusVariantIndex; } struct MemberState { // the last reference slot a report from this member was received for uint64 lastReportRefSlot; // the variant index of the last report from this member uint64 lastReportVariantIndex; } struct ReportVariant { // the reported hash bytes32 hash; // how many unique members from the current set reported this hash in the current frame uint64 support; } /// @notice An ACL role granting the permission to modify members list members and /// change the quorum by calling addMember, removeMember, and setQuorum functions. bytes32 public constant MANAGE_MEMBERS_AND_QUORUM_ROLE = keccak256("MANAGE_MEMBERS_AND_QUORUM_ROLE"); /// @notice An ACL role granting the permission to disable the consensus by calling /// the disableConsensus function. Enabling the consensus back requires the possession /// of the MANAGE_QUORUM_ROLE. bytes32 public constant DISABLE_CONSENSUS_ROLE = keccak256("DISABLE_CONSENSUS_ROLE"); /// @notice An ACL role granting the permission to change reporting interval duration /// and fast lane reporting interval length by calling setFrameConfig. bytes32 public constant MANAGE_FRAME_CONFIG_ROLE = keccak256("MANAGE_FRAME_CONFIG_ROLE"); /// @notice An ACL role granting the permission to change fast lane reporting interval /// length by calling setFastLaneLengthSlots. bytes32 public constant MANAGE_FAST_LANE_CONFIG_ROLE = keccak256("MANAGE_FAST_LANE_CONFIG_ROLE"); /// @notice An ACL role granting the permission to change еру report processor /// contract by calling setReportProcessor. bytes32 public constant MANAGE_REPORT_PROCESSOR_ROLE = keccak256("MANAGE_REPORT_PROCESSOR_ROLE"); /// Chain specification uint64 internal immutable SLOTS_PER_EPOCH; uint64 internal immutable SECONDS_PER_SLOT; uint64 internal immutable GENESIS_TIME; /// @dev A quorum value that effectively disables the oracle. uint256 internal constant UNREACHABLE_QUORUM = type(uint256).max; bytes32 internal constant ZERO_HASH = bytes32(0); /// @dev An offset from the processing deadline slot of the previous frame (i.e. the last slot /// at which a report for the prev. frame can be submitted and its processing started) to the /// reference slot of the next frame (equal to the last slot of the previous frame). /// frame[i].reportProcessingDeadlineSlot := frame[i + 1].refSlot - DEADLINE_SLOT_OFFSET uint256 internal constant DEADLINE_SLOT_OFFSET = 0; /// @dev Reporting frame configuration FrameConfig internal _frameConfig; /// @dev Oracle committee members states array MemberState[] internal _memberStates; /// @dev Oracle committee members' addresses array address[] internal _memberAddresses; /// @dev Mapping from an oracle committee member address to the 1-based index in the /// members array mapping(address => uint256) internal _memberIndices1b; /// @dev A structure containing the last reference slot any report was received for, the last /// reference slot consensus report was achieved for, and the last consensus variant index ReportingState internal _reportingState; /// @dev Oracle committee members quorum value, must be larger than totalMembers // 2 uint256 internal _quorum; /// @dev Mapping from a report variant index to the ReportVariant structure mapping(uint256 => ReportVariant) internal _reportVariants; /// @dev The number of report variants uint256 internal _reportVariantsLength; /// @dev The address of the report processor contract address internal _reportProcessor; /// /// Initialization /// constructor( uint256 slotsPerEpoch, uint256 secondsPerSlot, uint256 genesisTime, uint256 epochsPerFrame, uint256 fastLaneLengthSlots, address admin, address reportProcessor ) { if (slotsPerEpoch == 0) revert InvalidChainConfig(); if (secondsPerSlot == 0) revert InvalidChainConfig(); SLOTS_PER_EPOCH = slotsPerEpoch.toUint64(); SECONDS_PER_SLOT = secondsPerSlot.toUint64(); GENESIS_TIME = genesisTime.toUint64(); if (admin == address(0)) revert AdminCannotBeZero(); if (reportProcessor == address(0)) revert ReportProcessorCannotBeZero(); _setupRole(DEFAULT_ADMIN_ROLE, admin); uint256 farFutureEpoch = _computeEpochAtTimestamp(type(uint64).max); _setFrameConfig(farFutureEpoch, epochsPerFrame, fastLaneLengthSlots, FrameConfig(0, 0, 0)); _reportProcessor = reportProcessor; } /// /// Time /// /// @notice Returns the immutable chain parameters required to calculate epoch and slot /// given a timestamp. /// function getChainConfig() external view returns ( uint256 slotsPerEpoch, uint256 secondsPerSlot, uint256 genesisTime ) { return (SLOTS_PER_EPOCH, SECONDS_PER_SLOT, GENESIS_TIME); } /// @notice Returns the time-related configuration. /// /// @return initialEpoch Epoch of the frame with zero index. /// @return epochsPerFrame Length of a frame in epochs. /// @return fastLaneLengthSlots Length of the fast lane interval in slots; see `getIsFastLaneMember`. /// function getFrameConfig() external view returns ( uint256 initialEpoch, uint256 epochsPerFrame, uint256 fastLaneLengthSlots ) { FrameConfig memory config = _frameConfig; return (config.initialEpoch, config.epochsPerFrame, config.fastLaneLengthSlots); } /// @notice Returns the current reporting frame. /// /// @return refSlot The frame's reference slot: if the data the consensus is being reached upon /// includes or depends on any onchain state, this state should be queried at the /// reference slot. If the slot contains a block, the state should include all changes /// from that block. /// /// @return reportProcessingDeadlineSlot The last slot at which the report can be processed by /// the report processor contract. /// function getCurrentFrame() external view returns ( uint256 refSlot, uint256 reportProcessingDeadlineSlot ) { ConsensusFrame memory frame = _getCurrentFrame(); return (frame.refSlot, frame.reportProcessingDeadlineSlot); } /// @notice Returns the earliest possible reference slot, i.e. the reference slot of the /// reporting frame with zero index. /// function getInitialRefSlot() external view returns (uint256) { return _getInitialFrame().refSlot; } /// @notice Sets a new initial epoch given that the current initial epoch is in the future. /// /// @param initialEpoch The new initial epoch. /// function updateInitialEpoch(uint256 initialEpoch) external onlyRole(DEFAULT_ADMIN_ROLE) { FrameConfig memory prevConfig = _frameConfig; if (_computeEpochAtTimestamp(_getTime()) >= prevConfig.initialEpoch) { revert InitialEpochAlreadyArrived(); } _setFrameConfig( initialEpoch, prevConfig.epochsPerFrame, prevConfig.fastLaneLengthSlots, prevConfig ); if (_getInitialFrame().refSlot < _getLastProcessingRefSlot()) { revert InitialEpochRefSlotCannotBeEarlierThanProcessingSlot(); } } /// @notice Updates the time-related configuration. /// /// @param epochsPerFrame Length of a frame in epochs. /// @param fastLaneLengthSlots Length of the fast lane interval in slots; see `getIsFastLaneMember`. /// function setFrameConfig(uint256 epochsPerFrame, uint256 fastLaneLengthSlots) external onlyRole(MANAGE_FRAME_CONFIG_ROLE) { // Updates epochsPerFrame in a way that either keeps the current reference slot the same // or increases it by at least the minimum of old and new frame sizes. uint256 timestamp = _getTime(); uint256 currentFrameStartEpoch = _computeFrameStartEpoch(timestamp, _frameConfig); _setFrameConfig(currentFrameStartEpoch, epochsPerFrame, fastLaneLengthSlots, _frameConfig); } /// /// Members /// /// @notice Returns whether the given address is currently a member of the consensus. /// function getIsMember(address addr) external view returns (bool) { return _isMember(addr); } /// @notice Returns whether the given address is a fast lane member for the current reporting /// frame. /// /// Fast lane members is a subset of all members that changes each reporting frame. These /// members can, and are expected to, submit a report during the first part of the frame called /// the "fast lane interval" and defined via `setFrameConfig` or `setFastLaneLengthSlots`. Under /// regular circumstances, all other members are only allowed to submit a report after the fast /// lane interval passes. /// /// The fast lane subset consists of `quorum` members; selection is implemented as a sliding /// window of the `quorum` width over member indices (mod total members). The window advances /// by one index each reporting frame. /// /// This is done to encourage each member from the full set to participate in reporting on a /// regular basis, and identify any malfunctioning members. /// /// With the fast lane mechanism active, it's sufficient for the monitoring to check that /// consensus is consistently reached during the fast lane part of each frame to conclude that /// all members are active and share the same consensus rules. /// /// However, there is no guarantee that, at any given time, it holds true that only the current /// fast lane members can or were able to report during the currently-configured fast lane /// interval of the current frame. In particular, this assumption can be violated in any frame /// during which the members set, initial epoch, or the quorum number was changed, or the fast /// lane interval length was increased. Thus, the fast lane mechanism should not be used for any /// purpose other than monitoring of the members liveness, and monitoring tools should take into /// consideration the potential irregularities within frames with any configuration changes. /// function getIsFastLaneMember(address addr) external view returns (bool) { uint256 index1b = _memberIndices1b[addr]; unchecked { return index1b > 0 && _isFastLaneMember(index1b - 1, _getCurrentFrame().index); } } /// @notice Returns all current members, together with the last reference slot each member /// submitted a report for. /// function getMembers() external view returns ( address[] memory addresses, uint256[] memory lastReportedRefSlots ) { return _getMembers(false); } /// @notice Returns the subset of the oracle committee members (consisting of `quorum` items) /// that changes each frame. /// /// See `getIsFastLaneMember`. /// function getFastLaneMembers() external view returns ( address[] memory addresses, uint256[] memory lastReportedRefSlots ) { return _getMembers(true); } /// @notice Sets the duration of the fast lane interval of the reporting frame. /// /// See `getIsFastLaneMember`. /// /// @param fastLaneLengthSlots The length of the fast lane reporting interval in slots. Setting /// it to zero disables the fast lane subset, allowing any oracle to report starting from /// the first slot of a frame and until the frame's reporting deadline. /// function setFastLaneLengthSlots(uint256 fastLaneLengthSlots) external onlyRole(MANAGE_FAST_LANE_CONFIG_ROLE) { _setFastLaneLengthSlots(fastLaneLengthSlots); } function addMember(address addr, uint256 quorum) external onlyRole(MANAGE_MEMBERS_AND_QUORUM_ROLE) { _addMember(addr, quorum); } function removeMember(address addr, uint256 quorum) external onlyRole(MANAGE_MEMBERS_AND_QUORUM_ROLE) { _removeMember(addr, quorum); } function getQuorum() external view returns (uint256) { return _quorum; } function setQuorum(uint256 quorum) external { // access control is performed inside the next call _setQuorumAndCheckConsensus(quorum, _memberStates.length); } /// @notice Disables the oracle by setting the quorum to an unreachable value. /// function disableConsensus() external { // access control is performed inside the next call _setQuorumAndCheckConsensus(UNREACHABLE_QUORUM, _memberStates.length); } /// /// Report processor /// function getReportProcessor() external view returns (address) { return _reportProcessor; } function setReportProcessor(address newProcessor) external onlyRole(MANAGE_REPORT_PROCESSOR_ROLE) { _setReportProcessor(newProcessor); } /// /// Consensus /// /// @notice Returns info about the current frame and consensus state in that frame. /// /// @return refSlot Reference slot of the current reporting frame. /// /// @return consensusReport Consensus report for the current frame, if any. /// Zero bytes otherwise. /// /// @return isReportProcessing If consensus report for the current frame is already /// being processed. Consensus can be changed before the processing starts. /// function getConsensusState() external view returns ( uint256 refSlot, bytes32 consensusReport, bool isReportProcessing ) { refSlot = _getCurrentFrame().refSlot; (consensusReport,,) = _getConsensusReport(refSlot, _quorum); isReportProcessing = _getLastProcessingRefSlot() == refSlot; } /// @notice Returns report variants and their support for the current reference slot. /// function getReportVariants() external view returns ( bytes32[] memory variants, uint256[] memory support ) { if (_reportingState.lastReportRefSlot != _getCurrentFrame().refSlot) { return (variants, support); } uint256 variantsLength = _reportVariantsLength; variants = new bytes32[](variantsLength); support = new uint256[](variantsLength); for (uint256 i = 0; i < variantsLength; ++i) { ReportVariant memory variant = _reportVariants[i]; variants[i] = variant.hash; support[i] = variant.support; } } struct MemberConsensusState { /// @notice Current frame's reference slot. uint256 currentFrameRefSlot; /// @notice Consensus report for the current frame, if any. Zero bytes otherwise. bytes32 currentFrameConsensusReport; /// @notice Whether the provided address is a member of the oracle committee. bool isMember; /// @notice Whether the oracle committee member is in the fast lane members subset /// of the current reporting frame. See `getIsFastLaneMember`. bool isFastLane; /// @notice Whether the oracle committee member is allowed to submit a report at /// the moment of the call. bool canReport; /// @notice The last reference slot for which the member submitted a report. uint256 lastMemberReportRefSlot; /// @notice The hash reported by the member for the current frame, if any. /// Zero bytes otherwise. bytes32 currentFrameMemberReport; } /// @notice Returns the extended information related to an oracle committee member with the /// given address and the current consensus state. Provides all the information needed for /// an oracle daemon to decide if it needs to submit a report. /// /// @param addr The member address. /// @return result See the docs for `MemberConsensusState`. /// function getConsensusStateForMember(address addr) external view returns (MemberConsensusState memory result) { ConsensusFrame memory frame = _getCurrentFrame(); result.currentFrameRefSlot = frame.refSlot; (result.currentFrameConsensusReport,,) = _getConsensusReport(frame.refSlot, _quorum); uint256 index = _memberIndices1b[addr]; result.isMember = index != 0; if (index != 0) { unchecked { --index; } // convert to 0-based MemberState memory memberState = _memberStates[index]; result.lastMemberReportRefSlot = memberState.lastReportRefSlot; result.currentFrameMemberReport = result.lastMemberReportRefSlot == frame.refSlot ? _reportVariants[memberState.lastReportVariantIndex].hash : ZERO_HASH; uint256 slot = _computeSlotAtTimestamp(_getTime()); result.canReport = slot <= frame.reportProcessingDeadlineSlot && frame.refSlot > _getLastProcessingRefSlot(); result.isFastLane = _isFastLaneMember(index, frame.index); if (!result.isFastLane && result.canReport) { result.canReport = slot > frame.refSlot + _frameConfig.fastLaneLengthSlots; } } } /// @notice Used by oracle members to submit hash of the data calculated for the given /// reference slot. /// /// @param slot The reference slot the data was calculated for. Reverts if doesn't match /// the current reference slot. /// /// @param report Hash of the data calculated for the given reference slot. /// /// @param consensusVersion Version of the oracle consensus rules. Reverts if doesn't /// match the version returned by the currently set consensus report processor, /// or zero if no report processor is set. /// function submitReport(uint256 slot, bytes32 report, uint256 consensusVersion) external { _submitReport(slot, report, consensusVersion); } /// /// Implementation: time /// function _setFrameConfig( uint256 initialEpoch, uint256 epochsPerFrame, uint256 fastLaneLengthSlots, FrameConfig memory prevConfig ) internal { if (epochsPerFrame == 0) revert EpochsPerFrameCannotBeZero(); if (fastLaneLengthSlots > epochsPerFrame * SLOTS_PER_EPOCH) { revert FastLanePeriodCannotBeLongerThanFrame(); } _frameConfig = FrameConfig( initialEpoch.toUint64(), epochsPerFrame.toUint64(), fastLaneLengthSlots.toUint64() ); if (initialEpoch != prevConfig.initialEpoch || epochsPerFrame != prevConfig.epochsPerFrame) { emit FrameConfigSet(initialEpoch, epochsPerFrame); } if (fastLaneLengthSlots != prevConfig.fastLaneLengthSlots) { emit FastLaneConfigSet(fastLaneLengthSlots); } } function _getCurrentFrame() internal view returns (ConsensusFrame memory) { return _getFrameAtTimestamp(_getTime(), _frameConfig); } function _getInitialFrame() internal view returns (ConsensusFrame memory) { return _getFrameAtIndex(0, _frameConfig); } function _getFrameAtTimestamp(uint256 timestamp, FrameConfig memory config) internal view returns (ConsensusFrame memory) { return _getFrameAtIndex(_computeFrameIndex(timestamp, config), config); } function _getFrameAtIndex(uint256 frameIndex, FrameConfig memory config) internal view returns (ConsensusFrame memory) { uint256 frameStartEpoch = _computeStartEpochOfFrameWithIndex(frameIndex, config); uint256 frameStartSlot = _computeStartSlotAtEpoch(frameStartEpoch); uint256 nextFrameStartSlot = frameStartSlot + config.epochsPerFrame * SLOTS_PER_EPOCH; return ConsensusFrame({ index: frameIndex, refSlot: uint64(frameStartSlot - 1), reportProcessingDeadlineSlot: uint64(nextFrameStartSlot - 1 - DEADLINE_SLOT_OFFSET) }); } function _computeFrameStartEpoch(uint256 timestamp, FrameConfig memory config) internal view returns (uint256) { return _computeStartEpochOfFrameWithIndex(_computeFrameIndex(timestamp, config), config); } function _computeStartEpochOfFrameWithIndex(uint256 frameIndex, FrameConfig memory config) internal pure returns (uint256) { return config.initialEpoch + frameIndex * config.epochsPerFrame; } function _computeFrameIndex(uint256 timestamp, FrameConfig memory config) internal view returns (uint256) { uint256 epoch = _computeEpochAtTimestamp(timestamp); if (epoch < config.initialEpoch) { revert InitialEpochIsYetToArrive(); } return (epoch - config.initialEpoch) / config.epochsPerFrame; } function _computeTimestampAtSlot(uint256 slot) internal view returns (uint256) { // See: github.com/ethereum/consensus-specs/blob/dev/specs/bellatrix/beacon-chain.md#compute_timestamp_at_slot return GENESIS_TIME + slot * SECONDS_PER_SLOT; } function _computeSlotAtTimestamp(uint256 timestamp) internal view returns (uint256) { return (timestamp - GENESIS_TIME) / SECONDS_PER_SLOT; } function _computeEpochAtSlot(uint256 slot) internal view returns (uint256) { // See: github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#compute_epoch_at_slot return slot / SLOTS_PER_EPOCH; } function _computeEpochAtTimestamp(uint256 timestamp) internal view returns (uint256) { return _computeEpochAtSlot(_computeSlotAtTimestamp(timestamp)); } function _computeStartSlotAtEpoch(uint256 epoch) internal view returns (uint256) { // See: github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#compute_start_slot_at_epoch return epoch * SLOTS_PER_EPOCH; } function _getTime() internal virtual view returns (uint256) { return block.timestamp; // solhint-disable-line not-rely-on-time } /// /// Implementation: members /// function _isMember(address addr) internal view returns (bool) { return _memberIndices1b[addr] != 0; } function _getMemberIndex(address addr) internal view returns (uint256) { uint256 index1b = _memberIndices1b[addr]; if (index1b == 0) { revert NonMember(); } unchecked { return uint256(index1b - 1); } } function _addMember(address addr, uint256 quorum) internal { if (_isMember(addr)) revert DuplicateMember(); if (addr == address(0)) revert AddressCannotBeZero(); _memberStates.push(MemberState(0, 0)); _memberAddresses.push(addr); uint256 newTotalMembers = _memberStates.length; _memberIndices1b[addr] = newTotalMembers; emit MemberAdded(addr, newTotalMembers, quorum); _setQuorumAndCheckConsensus(quorum, newTotalMembers); } function _removeMember(address addr, uint256 quorum) internal { uint256 index = _getMemberIndex(addr); uint256 newTotalMembers = _memberStates.length - 1; assert(index <= newTotalMembers); MemberState memory memberState = _memberStates[index]; if (index != newTotalMembers) { address addrToMove = _memberAddresses[newTotalMembers]; _memberAddresses[index] = addrToMove; _memberStates[index] = _memberStates[newTotalMembers]; _memberIndices1b[addrToMove] = index + 1; } _memberStates.pop(); _memberAddresses.pop(); _memberIndices1b[addr] = 0; emit MemberRemoved(addr, newTotalMembers, quorum); if (memberState.lastReportRefSlot > 0) { // member reported at least once ConsensusFrame memory frame = _getCurrentFrame(); if (memberState.lastReportRefSlot == frame.refSlot && _getLastProcessingRefSlot() < frame.refSlot ) { // member reported for the current ref. slot and the consensus report // is not processing yet => need to cancel the member's report --_reportVariants[memberState.lastReportVariantIndex].support; } } _setQuorumAndCheckConsensus(quorum, newTotalMembers); } function _setFastLaneLengthSlots(uint256 fastLaneLengthSlots) internal { FrameConfig memory frameConfig = _frameConfig; if (fastLaneLengthSlots > frameConfig.epochsPerFrame * SLOTS_PER_EPOCH) { revert FastLanePeriodCannotBeLongerThanFrame(); } if (fastLaneLengthSlots != frameConfig.fastLaneLengthSlots) { _frameConfig.fastLaneLengthSlots = fastLaneLengthSlots.toUint64(); emit FastLaneConfigSet(fastLaneLengthSlots); } } /// @dev Returns start and past-end incides (mod totalMembers) of the fast lane members subset. /// function _getFastLaneSubset(uint256 frameIndex, uint256 totalMembers) internal view returns (uint256 startIndex, uint256 pastEndIndex) { uint256 quorum = _quorum; if (quorum >= totalMembers) { startIndex = 0; pastEndIndex = totalMembers; } else { startIndex = frameIndex % totalMembers; pastEndIndex = startIndex + quorum; } } /// @dev Tests whether the member with the given `index` is in the fast lane subset for the /// given reporting `frameIndex`. /// function _isFastLaneMember(uint256 index, uint256 frameIndex) internal view returns (bool) { uint256 totalMembers = _memberStates.length; (uint256 flLeft, uint256 flPastRight) = _getFastLaneSubset(frameIndex, totalMembers); unchecked { return ( flPastRight != 0 && Math.pointInClosedIntervalModN(index, flLeft, flPastRight - 1, totalMembers) ); } } function _getMembers(bool fastLane) internal view returns ( address[] memory addresses, uint256[] memory lastReportedRefSlots ) { uint256 totalMembers = _memberStates.length; uint256 left; uint256 right; if (fastLane) { (left, right) = _getFastLaneSubset(_getCurrentFrame().index, totalMembers); } else { right = totalMembers; } addresses = new address[](right - left); lastReportedRefSlots = new uint256[](addresses.length); for (uint256 i = left; i < right; ++i) { uint256 iModTotal = i % totalMembers; MemberState memory memberState = _memberStates[iModTotal]; uint256 k = i - left; addresses[k] = _memberAddresses[iModTotal]; lastReportedRefSlots[k] = memberState.lastReportRefSlot; } } /// /// Implementation: consensus /// function _submitReport(uint256 slot, bytes32 report, uint256 consensusVersion) internal { if (slot == 0) revert InvalidSlot(); if (slot > type(uint64).max) revert NumericOverflow(); if (report == ZERO_HASH) revert EmptyReport(); uint256 memberIndex = _getMemberIndex(_msgSender()); MemberState memory memberState = _memberStates[memberIndex]; uint256 expectedConsensusVersion = _getConsensusVersion(); if (consensusVersion != expectedConsensusVersion) { revert UnexpectedConsensusVersion(expectedConsensusVersion, consensusVersion); } uint256 timestamp = _getTime(); uint256 currentSlot = _computeSlotAtTimestamp(timestamp); FrameConfig memory config = _frameConfig; ConsensusFrame memory frame = _getFrameAtTimestamp(timestamp, config); if (slot != frame.refSlot) revert InvalidSlot(); if (currentSlot > frame.reportProcessingDeadlineSlot) revert StaleReport(); if (currentSlot <= frame.refSlot + config.fastLaneLengthSlots && !_isFastLaneMember(memberIndex, frame.index) ) { revert NonFastLaneMemberCannotReportWithinFastLaneInterval(); } if (slot <= _getLastProcessingRefSlot()) { // consensus for the ref. slot was already reached and consensus report is processing if (slot == memberState.lastReportRefSlot) { // member sends a report for the same slot => let them know via a revert revert ConsensusReportAlreadyProcessing(); } else { // member hasn't sent a report for this slot => normal operation, do nothing return; } } uint256 variantsLength; if (_reportingState.lastReportRefSlot != slot) { // first report for a new slot => clear report variants _reportingState.lastReportRefSlot = uint64(slot); variantsLength = 0; } else { variantsLength = _reportVariantsLength; } uint64 varIndex = 0; bool prevConsensusLost = false; while (varIndex < variantsLength && _reportVariants[varIndex].hash != report) { ++varIndex; } if (slot == memberState.lastReportRefSlot) { uint64 prevVarIndex = memberState.lastReportVariantIndex; assert(prevVarIndex < variantsLength); if (varIndex == prevVarIndex) { revert DuplicateReport(); } else { uint256 support = --_reportVariants[prevVarIndex].support; if (support == _quorum - 1) { prevConsensusLost = true; } } } uint256 support; if (varIndex < variantsLength) { support = ++_reportVariants[varIndex].support; } else { support = 1; _reportVariants[varIndex] = ReportVariant({hash: report, support: 1}); _reportVariantsLength = ++variantsLength; } _memberStates[memberIndex] = MemberState({ lastReportRefSlot: uint64(slot), lastReportVariantIndex: varIndex }); emit ReportReceived(slot, _msgSender(), report); if (support >= _quorum) { _consensusReached(frame, report, varIndex, support); } else if (prevConsensusLost) { _consensusNotReached(frame); } } function _consensusReached( ConsensusFrame memory frame, bytes32 report, uint256 variantIndex, uint256 support ) internal { if (_reportingState.lastConsensusRefSlot != frame.refSlot || _reportingState.lastConsensusVariantIndex != variantIndex ) { _reportingState.lastConsensusRefSlot = uint64(frame.refSlot); _reportingState.lastConsensusVariantIndex = uint64(variantIndex); emit ConsensusReached(frame.refSlot, report, support); _submitReportForProcessing(frame, report); } } function _consensusNotReached(ConsensusFrame memory frame) internal { if (_reportingState.lastConsensusRefSlot == frame.refSlot) { _reportingState.lastConsensusRefSlot = 0; emit ConsensusLost(frame.refSlot); _cancelReportProcessing(frame); } } function _setQuorumAndCheckConsensus(uint256 quorum, uint256 totalMembers) internal { if (quorum <= totalMembers / 2) { revert QuorumTooSmall(totalMembers / 2 + 1, quorum); } // we're explicitly allowing quorum values greater than the number of members to // allow effectively disabling the oracle in case something unpredictable happens uint256 prevQuorum = _quorum; if (quorum != prevQuorum) { _checkRole( quorum == UNREACHABLE_QUORUM ? DISABLE_CONSENSUS_ROLE : MANAGE_MEMBERS_AND_QUORUM_ROLE, _msgSender() ); _quorum = quorum; emit QuorumSet(quorum, totalMembers, prevQuorum); } if (_computeEpochAtTimestamp(_getTime()) >= _frameConfig.initialEpoch) { _checkConsensus(quorum); } } function _checkConsensus(uint256 quorum) internal { uint256 timestamp = _getTime(); ConsensusFrame memory frame = _getFrameAtTimestamp(timestamp, _frameConfig); if (_computeSlotAtTimestamp(timestamp) > frame.reportProcessingDeadlineSlot) { // a report for the current ref. slot cannot be processed anymore return; } if (_getLastProcessingRefSlot() >= frame.refSlot) { // a consensus report for the current ref. slot is already being processed return; } (bytes32 consensusReport, int256 consensusVariantIndex, uint256 support) = _getConsensusReport(frame.refSlot, quorum); if (consensusVariantIndex >= 0) { _consensusReached(frame, consensusReport, uint256(consensusVariantIndex), support); } else { _consensusNotReached(frame); } } function _getConsensusReport(uint256 currentRefSlot, uint256 quorum) internal view returns (bytes32 report, int256 variantIndex, uint256 support) { if (_reportingState.lastReportRefSlot != currentRefSlot) { // there were no reports for the current ref. slot return (ZERO_HASH, -1, 0); } uint256 variantsLength = _reportVariantsLength; variantIndex = -1; report = ZERO_HASH; support = 0; for (uint256 i = 0; i < variantsLength; ++i) { uint256 iSupport = _reportVariants[i].support; if (iSupport >= quorum) { variantIndex = int256(i); report = _reportVariants[i].hash; support = iSupport; break; } } return (report, variantIndex, support); } /// /// Implementation: report processing /// function _setReportProcessor(address newProcessor) internal { address prevProcessor = _reportProcessor; if (newProcessor == address(0)) revert ReportProcessorCannotBeZero(); if (newProcessor == prevProcessor) revert NewProcessorCannotBeTheSame(); _reportProcessor = newProcessor; emit ReportProcessorSet(newProcessor, prevProcessor); ConsensusFrame memory frame = _getCurrentFrame(); uint256 lastConsensusRefSlot = _reportingState.lastConsensusRefSlot; uint256 processingRefSlotPrev = IReportAsyncProcessor(prevProcessor).getLastProcessingRefSlot(); uint256 processingRefSlotNext = IReportAsyncProcessor(newProcessor).getLastProcessingRefSlot(); if ( processingRefSlotPrev < frame.refSlot && processingRefSlotNext < frame.refSlot && lastConsensusRefSlot == frame.refSlot ) { bytes32 report = _reportVariants[_reportingState.lastConsensusVariantIndex].hash; _submitReportForProcessing(frame, report); } } function _getLastProcessingRefSlot() internal view returns (uint256) { return IReportAsyncProcessor(_reportProcessor).getLastProcessingRefSlot(); } function _submitReportForProcessing(ConsensusFrame memory frame, bytes32 report) internal { IReportAsyncProcessor(_reportProcessor).submitConsensusReport( report, frame.refSlot, _computeTimestampAtSlot(frame.reportProcessingDeadlineSlot) ); } function _cancelReportProcessing(ConsensusFrame memory frame) internal { IReportAsyncProcessor(_reportProcessor).discardConsensusReport(frame.refSlot); } function _getConsensusVersion() internal view returns (uint256) { return IReportAsyncProcessor(_reportProcessor).getConsensusVersion(); } }
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/AccessControl.sol)
//
// A modified AccessControl contract using unstructured storage. Copied from tree:
// https://github.com/OpenZeppelin/openzeppelin-contracts/tree/6bd6b76/contracts/access
//
/* See contracts/COMPILERS.md */
pragma solidity 0.8.9;
import "@openzeppelin/contracts-v4.4/access/IAccessControl.sol";
import "@openzeppelin/contracts-v4.4/utils/Context.sol";
import "@openzeppelin/contracts-v4.4/utils/Strings.sol";
import "@openzeppelin/contracts-v4.4/utils/introspection/ERC165.sol";
/**
* @dev Contract module that allows children to implement role-based access
* control mechanisms. This is a lightweight version that doesn't allow enumerating role
* members except through off-chain means by accessing the contract event logs. Some
* applications may benefit from on-chain enumerability, for those cases see
* {AccessControlEnumerable}.
*
* Roles are referred to by their `bytes32` identifier. These should be exposed
* in the external API and be unique. The best way to achieve this is by
* using `public constant` hash digests:
*
* ```
* bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
* ```
*
* Roles can be used to represent a set of permissions. To restrict access to a
* function call, use {hasRole}:
*
* ```
* function foo() public {
* require(hasRole(MY_ROLE, msg.sender));
* ...
* }
* ```
*
* Roles can be granted and revoked dynamically via the {grantRole} and
* {revokeRole} functions. Each role has an associated admin role, and only
* accounts that have a role's admin role can call {grantRole} and {revokeRole}.
*
* By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
* that only accounts with this role will be able to grant or revoke other
* roles. More complex role relationships can be created by using
* {_setRoleAdmin}.
*
* WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
* grant and revoke this role. Extra precautions should be taken to secure
* accounts that have been granted it.
*/
abstract contract AccessControl is Context, IAccessControl, ERC165 {
struct RoleData {
mapping(address => bool) members;
bytes32 adminRole;
}
/// @dev Storage slot: mapping(bytes32 => RoleData) _roles
bytes32 private constant ROLES_POSITION = keccak256("openzeppelin.AccessControl._roles");
function _storageRoles() private pure returns (mapping(bytes32 => RoleData) storage _roles) {
bytes32 position = ROLES_POSITION;
assembly { _roles.slot := position }
}
bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
/**
* @dev Modifier that checks that an account has a specific role. Reverts
* with a standardized message including the required role.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*
* _Available since v4.1._
*/
modifier onlyRole(bytes32 role) {
_checkRole(role, _msgSender());
_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) public view override returns (bool) {
return _storageRoles()[role].members[account];
}
/**
* @dev Revert with a standard message if `account` is missing `role`.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*/
function _checkRole(bytes32 role, address account) internal view {
if (!hasRole(role, account)) {
revert(
string(
abi.encodePacked(
"AccessControl: account ",
Strings.toHexString(uint160(account), 20),
" is missing role ",
Strings.toHexString(uint256(role), 32)
)
)
);
}
}
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) public view override returns (bytes32) {
return _storageRoles()[role].adminRole;
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_grantRole(role, account);
}
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_revokeRole(role, account);
}
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been revoked `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) public virtual override {
require(account == _msgSender(), "AccessControl: can only renounce roles for self");
_revokeRole(role, account);
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event. Note that unlike {grantRole}, this function doesn't perform any
* checks on the calling account.
*
* [WARNING]
* ====
* This function should only be called from the constructor when setting
* up the initial roles for the system.
*
* Using this function in any other way is effectively circumventing the admin
* system imposed by {AccessControl}.
* ====
*
* NOTE: This function is deprecated in favor of {_grantRole}.
*/
function _setupRole(bytes32 role, address account) internal virtual {
_grantRole(role, account);
}
/**
* @dev Sets `adminRole` as ``role``'s admin role.
*
* Emits a {RoleAdminChanged} event.
*/
function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
bytes32 previousAdminRole = getRoleAdmin(role);
_storageRoles()[role].adminRole = adminRole;
emit RoleAdminChanged(role, previousAdminRole, adminRole);
}
/**
* @dev Grants `role` to `account`.
*
* Internal function without access restriction.
*/
function _grantRole(bytes32 role, address account) internal virtual {
if (!hasRole(role, account)) {
_storageRoles()[role].members[account] = true;
emit RoleGranted(role, account, _msgSender());
}
}
/**
* @dev Revokes `role` from `account`.
*
* Internal function without access restriction.
*/
function _revokeRole(bytes32 role, address account) internal virtual {
if (hasRole(role, account)) {
_storageRoles()[role].members[account] = false;
emit RoleRevoked(role, account, _msgSender());
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/AccessControlEnumerable.sol)
//
// A modified AccessControlEnumerable contract using unstructured storage. Copied from tree:
// https://github.com/OpenZeppelin/openzeppelin-contracts/tree/6bd6b76/contracts/access
//
/* See contracts/COMPILERS.md */
pragma solidity 0.8.9;
import "@openzeppelin/contracts-v4.4/access/IAccessControlEnumerable.sol";
import "@openzeppelin/contracts-v4.4/utils/structs/EnumerableSet.sol";
import "./AccessControl.sol";
/**
* @dev Extension of {AccessControl} that allows enumerating the members of each role.
*/
abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {
using EnumerableSet for EnumerableSet.AddressSet;
/// @dev Storage slot: mapping(bytes32 => EnumerableSet.AddressSet) _roleMembers
bytes32 private constant ROLE_MEMBERS_POSITION = keccak256("openzeppelin.AccessControlEnumerable._roleMembers");
function _storageRoleMembers() private pure returns (
mapping(bytes32 => EnumerableSet.AddressSet) storage _roleMembers
) {
bytes32 position = ROLE_MEMBERS_POSITION;
assembly { _roleMembers.slot := position }
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns one of the accounts that have `role`. `index` must be a
* value between 0 and {getRoleMemberCount}, non-inclusive.
*
* Role bearers are not sorted in any particular way, and their ordering may
* change at any point.
*
* WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
* you perform all queries on the same block. See the following
* https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
* for more information.
*/
function getRoleMember(bytes32 role, uint256 index) public view override returns (address) {
return _storageRoleMembers()[role].at(index);
}
/**
* @dev Returns the number of accounts that have `role`. Can be used
* together with {getRoleMember} to enumerate all bearers of a role.
*/
function getRoleMemberCount(bytes32 role) public view override returns (uint256) {
return _storageRoleMembers()[role].length();
}
/**
* @dev Overload {_grantRole} to track enumerable memberships
*/
function _grantRole(bytes32 role, address account) internal virtual override {
super._grantRole(role, account);
_storageRoleMembers()[role].add(account);
}
/**
* @dev Overload {_revokeRole} to track enumerable memberships
*/
function _revokeRole(bytes32 role, address account) internal virtual override {
super._revokeRole(role, account);
_storageRoleMembers()[role].remove(account);
}
}// SPDX-FileCopyrightText: 2022 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 pragma solidity 0.8.9; import "../lib/UnstructuredStorage.sol"; contract Versioned { using UnstructuredStorage for bytes32; event ContractVersionSet(uint256 version); error NonZeroContractVersionOnInit(); error InvalidContractVersionIncrement(); error UnexpectedContractVersion(uint256 expected, uint256 received); /// @dev Storage slot: uint256 version /// Version of the initialized contract storage. /// The version stored in CONTRACT_VERSION_POSITION equals to: /// - 0 right after the deployment, before an initializer is invoked (and only at that moment); /// - N after calling initialize(), where N is the initially deployed contract version; /// - N after upgrading contract by calling finalizeUpgrade_vN(). bytes32 internal constant CONTRACT_VERSION_POSITION = keccak256("lido.Versioned.contractVersion"); uint256 internal constant PETRIFIED_VERSION_MARK = type(uint256).max; constructor() { // lock version in the implementation's storage to prevent initialization CONTRACT_VERSION_POSITION.setStorageUint256(PETRIFIED_VERSION_MARK); } /// @notice Returns the current contract version. function getContractVersion() public view returns (uint256) { return CONTRACT_VERSION_POSITION.getStorageUint256(); } function _checkContractVersion(uint256 version) internal view { uint256 expectedVersion = getContractVersion(); if (version != expectedVersion) { revert UnexpectedContractVersion(expectedVersion, version); } } /// @dev Sets the contract version to N. Should be called from the initialize() function. function _initializeContractVersionTo(uint256 version) internal { if (getContractVersion() != 0) revert NonZeroContractVersionOnInit(); _setContractVersion(version); } /// @dev Updates the contract version. Should be called from a finalizeUpgrade_vN() function. function _updateContractVersion(uint256 newVersion) internal { if (newVersion != getContractVersion() + 1) revert InvalidContractVersionIncrement(); _setContractVersion(newVersion); } function _setContractVersion(uint256 version) private { CONTRACT_VERSION_POSITION.setStorageUint256(version); emit ContractVersionSet(version); } }
// SPDX-FileCopyrightText: 2025 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 // See contracts/COMPILERS.md // solhint-disable-next-line lido/fixed-compiler-version pragma solidity >=0.5.0; /** * Interface to connect AccountingOracle with LazyOracle and force type consistency */ interface ILazyOracle { function updateReportData( uint256 _timestamp, bytes32 _vaultsDataTreeRoot, string memory _vaultsDataReportCid ) external; }
// SPDX-FileCopyrightText: 2025 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 // See contracts/COMPILERS.md // solhint-disable-next-line lido/fixed-compiler-version pragma solidity >=0.4.24 <0.9.0; interface ILidoLocator { function accountingOracle() external view returns(address); function depositSecurityModule() external view returns(address); function elRewardsVault() external view returns(address); function lido() external view returns(address); function oracleReportSanityChecker() external view returns(address); function burner() external view returns(address); function stakingRouter() external view returns(address); function treasury() external view returns(address); function validatorsExitBusOracle() external view returns(address); function withdrawalQueue() external view returns(address); function withdrawalVault() external view returns(address); function postTokenRebaseReceiver() external view returns(address); function oracleDaemonConfig() external view returns(address); function validatorExitDelayVerifier() external view returns (address); function triggerableWithdrawalsGateway() external view returns (address); function accounting() external view returns (address); function predepositGuarantee() external view returns (address); function wstETH() external view returns (address); function vaultHub() external view returns (address); function vaultFactory() external view returns (address); function lazyOracle() external view returns (address); function operatorGrid() external view returns (address); /// @notice Returns core Lido protocol component addresses in a single call /// @dev This function provides a gas-efficient way to fetch multiple component addresses in a single call function coreComponents() external view returns( address elRewardsVault, address oracleReportSanityChecker, address stakingRouter, address treasury, address withdrawalQueue, address withdrawalVault ); /// @notice Returns addresses of components involved in processing oracle reports in the Lido contract /// @dev This function provides a gas-efficient way to fetch multiple component addresses in a single call function oracleReportComponents() external view returns( address accountingOracle, address oracleReportSanityChecker, address burner, address withdrawalQueue, address postTokenRebaseReceiver, address stakingRouter, address vaultHub ); }
// SPDX-FileCopyrightText: 2025 Lido <[email protected]> // SPDX-License-Identifier: GPL-3.0 // See contracts/COMPILERS.md // solhint-disable-next-line lido/fixed-compiler-version pragma solidity >=0.5.0; struct ReportValues { /// @notice timestamp of the block the report is based on. All provided report values is actual on this timestamp uint256 timestamp; /// @notice seconds elapsed since the previous report uint256 timeElapsed; /// @notice total number of Lido validators on Consensus Layers (exited included) uint256 clValidators; /// @notice sum of all Lido validators' balances on Consensus Layer uint256 clBalance; /// @notice withdrawal vault balance uint256 withdrawalVaultBalance; /// @notice elRewards vault balance uint256 elRewardsVaultBalance; /// @notice stETH shares requested to burn through Burner uint256 sharesRequestedToBurn; /// @notice the ascendingly-sorted array of withdrawal request IDs obtained by calling /// WithdrawalQueue.calculateFinalizationBatches. Can be empty array if no withdrawal to finalize uint256[] withdrawalFinalizationBatches; }
{
"optimizer": {
"enabled": true,
"runs": 200
},
"evmVersion": "istanbul",
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"libraries": {}
}Contract ABI
API[{"inputs":[{"internalType":"address","name":"lidoLocator","type":"address"},{"internalType":"uint256","name":"secondsPerSlot","type":"uint256"},{"internalType":"uint256","name":"genesisTime","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AddressCannotBeSame","type":"error"},{"inputs":[],"name":"AddressCannotBeZero","type":"error"},{"inputs":[],"name":"AdminCannotBeZero","type":"error"},{"inputs":[],"name":"CannotSubmitExtraDataBeforeMainData","type":"error"},{"inputs":[{"internalType":"uint256","name":"itemIndex","type":"uint256"},{"internalType":"uint256","name":"dataType","type":"uint256"}],"name":"DeprecatedExtraDataType","type":"error"},{"inputs":[],"name":"ExtraDataAlreadyProcessed","type":"error"},{"inputs":[],"name":"ExtraDataHashCannotBeZeroForNonEmptyData","type":"error"},{"inputs":[],"name":"ExtraDataItemsCountCannotBeZeroForNonEmptyData","type":"error"},{"inputs":[],"name":"HashCannotBeZero","type":"error"},{"inputs":[{"internalType":"uint256","name":"code","type":"uint256"}],"name":"IncorrectOracleMigration","type":"error"},{"inputs":[{"internalType":"uint256","name":"initialRefSlot","type":"uint256"},{"internalType":"uint256","name":"processingRefSlot","type":"uint256"}],"name":"InitialRefSlotCannotBeLessThanProcessingOne","type":"error"},{"inputs":[],"name":"InvalidContractVersionIncrement","type":"error"},{"inputs":[],"name":"InvalidExitedValidatorsData","type":"error"},{"inputs":[{"internalType":"uint256","name":"itemIndex","type":"uint256"}],"name":"InvalidExtraDataItem","type":"error"},{"inputs":[{"internalType":"uint256","name":"itemIndex","type":"uint256"}],"name":"InvalidExtraDataSortOrder","type":"error"},{"inputs":[],"name":"LidoCannotBeZero","type":"error"},{"inputs":[],"name":"LidoLocatorCannotBeZero","type":"error"},{"inputs":[],"name":"NoConsensusReportToProcess","type":"error"},{"inputs":[],"name":"NonZeroContractVersionOnInit","type":"error"},{"inputs":[{"internalType":"uint256","name":"deadline","type":"uint256"}],"name":"ProcessingDeadlineMissed","type":"error"},{"inputs":[],"name":"RefSlotAlreadyProcessing","type":"error"},{"inputs":[{"internalType":"uint256","name":"refSlot","type":"uint256"},{"internalType":"uint256","name":"prevRefSlot","type":"uint256"}],"name":"RefSlotCannotDecrease","type":"error"},{"inputs":[{"internalType":"uint256","name":"refSlot","type":"uint256"},{"internalType":"uint256","name":"processingRefSlot","type":"uint256"}],"name":"RefSlotMustBeGreaterThanProcessingOne","type":"error"},{"inputs":[],"name":"SecondsPerSlotCannotBeZero","type":"error"},{"inputs":[],"name":"SenderIsNotTheConsensusContract","type":"error"},{"inputs":[],"name":"SenderNotAllowed","type":"error"},{"inputs":[],"name":"UnexpectedChainConfig","type":"error"},{"inputs":[{"internalType":"uint256","name":"expectedVersion","type":"uint256"},{"internalType":"uint256","name":"receivedVersion","type":"uint256"}],"name":"UnexpectedConsensusVersion","type":"error"},{"inputs":[{"internalType":"uint256","name":"expected","type":"uint256"},{"internalType":"uint256","name":"received","type":"uint256"}],"name":"UnexpectedContractVersion","type":"error"},{"inputs":[{"internalType":"bytes32","name":"consensusHash","type":"bytes32"},{"internalType":"bytes32","name":"receivedHash","type":"bytes32"}],"name":"UnexpectedDataHash","type":"error"},{"inputs":[{"internalType":"uint256","name":"expectedFormat","type":"uint256"},{"internalType":"uint256","name":"receivedFormat","type":"uint256"}],"name":"UnexpectedExtraDataFormat","type":"error"},{"inputs":[{"internalType":"bytes32","name":"consensusHash","type":"bytes32"},{"internalType":"bytes32","name":"receivedHash","type":"bytes32"}],"name":"UnexpectedExtraDataHash","type":"error"},{"inputs":[{"internalType":"uint256","name":"expectedIndex","type":"uint256"},{"internalType":"uint256","name":"receivedIndex","type":"uint256"}],"name":"UnexpectedExtraDataIndex","type":"error"},{"inputs":[{"internalType":"uint256","name":"expectedCount","type":"uint256"},{"internalType":"uint256","name":"receivedCount","type":"uint256"}],"name":"UnexpectedExtraDataItemsCount","type":"error"},{"inputs":[{"internalType":"uint256","name":"consensusRefSlot","type":"uint256"},{"internalType":"uint256","name":"dataRefSlot","type":"uint256"}],"name":"UnexpectedRefSlot","type":"error"},{"inputs":[{"internalType":"uint256","name":"format","type":"uint256"}],"name":"UnsupportedExtraDataFormat","type":"error"},{"inputs":[{"internalType":"uint256","name":"itemIndex","type":"uint256"},{"internalType":"uint256","name":"dataType","type":"uint256"}],"name":"UnsupportedExtraDataType","type":"error"},{"inputs":[],"name":"VersionCannotBeSame","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"addr","type":"address"},{"indexed":true,"internalType":"address","name":"prevAddr","type":"address"}],"name":"ConsensusHashContractSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"version","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"prevVersion","type":"uint256"}],"name":"ConsensusVersionSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"version","type":"uint256"}],"name":"ContractVersionSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"refSlot","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"itemsProcessed","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"itemsCount","type":"uint256"}],"name":"ExtraDataSubmitted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"refSlot","type":"uint256"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"}],"name":"ProcessingStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"refSlot","type":"uint256"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"}],"name":"ReportDiscarded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"refSlot","type":"uint256"},{"indexed":false,"internalType":"bytes32","name":"hash","type":"bytes32"},{"indexed":false,"internalType":"uint256","name":"processingDeadlineTime","type":"uint256"}],"name":"ReportSubmitted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"refSlot","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"processedItemsCount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"itemsCount","type":"uint256"}],"name":"WarnExtraDataIncompleteProcessing","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"refSlot","type":"uint256"}],"name":"WarnProcessingMissed","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"EXTRA_DATA_FORMAT_EMPTY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"EXTRA_DATA_FORMAT_LIST","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"EXTRA_DATA_TYPE_EXITED_VALIDATORS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"EXTRA_DATA_TYPE_STUCK_VALIDATORS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"GENESIS_TIME","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LOCATOR","outputs":[{"internalType":"contract ILidoLocator","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MANAGE_CONSENSUS_CONTRACT_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MANAGE_CONSENSUS_VERSION_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SECONDS_PER_SLOT","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SUBMIT_DATA_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"refSlot","type":"uint256"}],"name":"discardConsensusReport","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"consensusVersion","type":"uint256"}],"name":"finalizeUpgrade_v3","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getConsensusContract","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getConsensusReport","outputs":[{"internalType":"bytes32","name":"hash","type":"bytes32"},{"internalType":"uint256","name":"refSlot","type":"uint256"},{"internalType":"uint256","name":"processingDeadlineTime","type":"uint256"},{"internalType":"bool","name":"processingStarted","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getConsensusVersion","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getContractVersion","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getLastProcessingRefSlot","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getProcessingState","outputs":[{"components":[{"internalType":"uint256","name":"currentFrameRefSlot","type":"uint256"},{"internalType":"uint256","name":"processingDeadlineTime","type":"uint256"},{"internalType":"bytes32","name":"mainDataHash","type":"bytes32"},{"internalType":"bool","name":"mainDataSubmitted","type":"bool"},{"internalType":"bytes32","name":"extraDataHash","type":"bytes32"},{"internalType":"uint256","name":"extraDataFormat","type":"uint256"},{"internalType":"bool","name":"extraDataSubmitted","type":"bool"},{"internalType":"uint256","name":"extraDataItemsCount","type":"uint256"},{"internalType":"uint256","name":"extraDataItemsSubmitted","type":"uint256"}],"internalType":"struct AccountingOracle.ProcessingState","name":"result","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"admin","type":"address"},{"internalType":"address","name":"consensusContract","type":"address"},{"internalType":"uint256","name":"consensusVersion","type":"uint256"},{"internalType":"uint256","name":"lastProcessingRefSlot","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"setConsensusContract","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"version","type":"uint256"}],"name":"setConsensusVersion","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"reportHash","type":"bytes32"},{"internalType":"uint256","name":"refSlot","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"}],"name":"submitConsensusReport","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"consensusVersion","type":"uint256"},{"internalType":"uint256","name":"refSlot","type":"uint256"},{"internalType":"uint256","name":"numValidators","type":"uint256"},{"internalType":"uint256","name":"clBalanceGwei","type":"uint256"},{"internalType":"uint256[]","name":"stakingModuleIdsWithNewlyExitedValidators","type":"uint256[]"},{"internalType":"uint256[]","name":"numExitedValidatorsByStakingModule","type":"uint256[]"},{"internalType":"uint256","name":"withdrawalVaultBalance","type":"uint256"},{"internalType":"uint256","name":"elRewardsVaultBalance","type":"uint256"},{"internalType":"uint256","name":"sharesRequestedToBurn","type":"uint256"},{"internalType":"uint256[]","name":"withdrawalFinalizationBatches","type":"uint256[]"},{"internalType":"bool","name":"isBunkerMode","type":"bool"},{"internalType":"bytes32","name":"vaultsDataTreeRoot","type":"bytes32"},{"internalType":"string","name":"vaultsDataTreeCid","type":"string"},{"internalType":"uint256","name":"extraDataFormat","type":"uint256"},{"internalType":"bytes32","name":"extraDataHash","type":"bytes32"},{"internalType":"uint256","name":"extraDataItemsCount","type":"uint256"}],"internalType":"struct AccountingOracle.ReportData","name":"data","type":"tuple"},{"internalType":"uint256","name":"contractVersion","type":"uint256"}],"name":"submitReportData","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"submitReportExtraDataEmpty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes","name":"data","type":"bytes"}],"name":"submitReportExtraDataList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}]Contract Creation Code
60e06040523480156200001157600080fd5b50604051620042b4380380620042b48339810160408190526200003491620000da565b8181620000726000197f4dd0f6662ba1d6b081f08b350f5e9a6a7b15cf586926ba66f753594928fa64a6620000d660201b62000e701790919060201c565b816200009157604051636ed243a560e01b815260040160405180910390fd5b60809190915260a0526001600160a01b038316620000c257604051637b3fe65f60e01b815260040160405180910390fd5b50506001600160a01b031660c0526200011f565b9055565b600080600060608486031215620000f057600080fd5b83516001600160a01b03811681146200010857600080fd5b602085015160409095015190969495509392505050565b60805160a05160c0516140d2620001e26000396000818161031f0152818161120a01528181611a4001528181611ad501528181611cb701528181611ec3015281816125f20152818161299301528181612a81015261309b01526000818161051a01528181611bdb01528181611c3301528181611d9601528181611f9401526123d101526000818161029b01528181611bb001528181611c0401528181611d6201528181611dc401528181611f65015281816123a7015261305c01526140d26000f3fe608060405234801561001057600080fd5b50600436106102055760003560e01c80638aa104351161011a578063a217fddf116100ad578063d43812171161007c578063d4381217146104dc578063d547741f146104ef578063eb990c5914610502578063f288246114610515578063fa565b051461053c57600080fd5b8063a217fddf1461038b578063ad5cac4e1461048f578063c469c307146104b6578063ca15c873146104c957600080fd5b80639010d07c116100e95780639010d07c1461042f57806391d14854146104425780639290281b146104555780639cc23c791461046857600080fd5b80638aa10435146103935780638d5914741461039b5780638f55b571146103ae5780638f7797c2146103b657600080fd5b806336568abe1161019d57806357a782891161016c57806357a782891461031a5780635be204251461035957806360d64d3814610361578063672690b41461020a57806374facb9b1461038b57600080fd5b806336568abe146102c557806336eca5a7146102d857806346e1f576146102eb578063560f97cb1461031257600080fd5b8063248a9ca3116101d9578063248a9ca3146102705780632f2ff15d14610283578063304b9071146102965780633584d59c146102bd57600080fd5b80625418e11461020a57806301ffc9a714610225578063063f36ad1461024857806306c373da1461025d575b600080fd5b610212600181565b6040519081526020015b60405180910390f35b610238610233366004613685565b610544565b604051901515815260200161021c565b61025b6102563660046136af565b61056f565b005b61025b61026b3660046136db565b610770565b61021261027e36600461374c565b61077e565b61025b61029136600461377a565b6107a0565b6102127f000000000000000000000000000000000000000000000000000000000000000081565b6102126107c2565b61025b6102d336600461377a565b6107df565b61025b6102e63660046137aa565b610859565b6102127f65fa0c17458517c727737e4153dd477fa3e328cf706640b0f68b1a285c5990da81565b610212600281565b6103417f000000000000000000000000000000000000000000000000000000000000000081565b6040516001600160a01b03909116815260200161021c565b6102126108b9565b6103696108d1565b604080519485526020850193909352918301521515606082015260800161021c565b610212600081565b610212610979565b61025b6103a936600461374c565b6109a3565b6103416109d7565b6103be6109ef565b60405161021c91906000610120820190508251825260208301516020830152604083015160408301526060830151151560608301526080830151608083015260a083015160a083015260c0830151151560c083015260e083015160e083015261010080840151818401525092915050565b61034161043d3660046137f4565b610bd1565b61023861045036600461377a565b610bfd565b61025b61046336600461374c565b610c35565b6102127fc31b1e4b732c5173dc51d519dfa432bad95550ecc4b0f9a61c2a558a2a8e434181565b6102127f04a0afbbd09d5ad397fc858789da4f8edd59f5ca5098d70faa490babee945c3b81565b61025b6104c4366004613816565b610c4b565b6102126104d736600461374c565b610c95565b61025b6104ea36600461374c565b610cb9565b61025b6104fd36600461377a565b610dfc565b61025b610510366004613833565b610e19565b6102127f000000000000000000000000000000000000000000000000000000000000000081565b61025b610e66565b60006001600160e01b03198216635a05180f60e01b1480610569575061056982610e74565b92915050565b610577610ea9565b60008051602061405d833981519152546001600160401b0316808310156105c05760405163431d301760e11b815260048101849052602481018290526044015b60405180910390fd5b60006105d860008051602061403d8339815191525490565b9050808411610604576040516360a41e4960e01b815260048101859052602481018290526044016105b7565b824211156106285760405163537bacdf60e11b8152600481018490526024016105b7565b8184141580156106385750818114155b156106695760405182907f800b849c8bf80718cf786c99d1091c079fe2c5e420a3ba7ba9b0ef8179ef2c3890600090a25b8461068757604051635b18a69f60e11b815260040160405180910390fd5b604080518681526020810185905285917faed7d1a7a1831158dcda1e4214f5862f450bd3eb5721a5f322bf8c9fe1790b0a910160405180910390a2600060405180606001604052808781526020016106de87610eea565b6001600160401b031681526020016106f586610eea565b6001600160401b039081169091528151600080516020613f5d83398151915255602082015160008051602061405d833981519152805460408501518416600160401b026fffffffffffffffffffffffffffffffff1990911692909316919091179190911790559050610768818484610f56565b505050505050565b61077a828261107d565b5050565b600090815260008051602061401d833981519152602052604090206001015490565b6107a98261077e565b6107b381336115cb565b6107bd838361162f565b505050565b60006107da60008051602061403d8339815191525490565b905090565b6001600160a01b038116331461084f5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084016105b7565b61077a828261165e565b61086161168d565b61086a816116e9565b6108a38260200135836000013584604051602001610888919061398a565b6040516020818303038152906040528051906020012061171f565b60006108ad61181e565b90506107bd8382611944565b60006107da60008051602061407d8339815191525490565b600080808080600080516020613f5d83398151915260408051606081018252825481526001909201546001600160401b038082166020850152600160401b90910416908201529050600061093160008051602061403d8339815191525490565b8251602084015160408501519293509091821580159061095d57508385602001516001600160401b0316145b92996001600160401b0392831699509116965090945092505050565b60006107da7f4dd0f6662ba1d6b081f08b350f5e9a6a7b15cf586926ba66f753594928fa64a65490565b7fc31b1e4b732c5173dc51d519dfa432bad95550ecc4b0f9a61c2a558a2a8e43416109ce81336115cb565b61077a82612159565b60006107da600080516020613fdd8339815191525490565b6040805161012081018252600080825260208201819052918101829052606081018290526080810182905260a0810182905260c0810182905260e08101829052610100810182905290600080516020613f5d83398151915260408051606081018252825481526001909201546001600160401b038082166020850152600160401b90910416908201529050610a826121dc565b825280511580610aa3575080602001516001600160401b0316826000015114155b15610aac575090565b6040808201516001600160401b031660208401528151908301526000610ade60008051602061403d8339815191525490565b60208301516001600160401b0316811460608501819052909150610b0157505090565b50506040805160e08082018352600080516020613fbd833981519152546001600160401b03808216845261ffff600160401b830481166020860190815260ff600160501b8504161515968601968752600160581b8404831660608701908152600160981b90940483166080808801918252600080516020613f7d8339815191525460a0808a0191909152600080516020613f9d8339815191525460c0998a01819052918b019190915291519092169088015294511515938601939093525182169084015290511661010082015290565b6000828152600080516020613ffd83398151915260205260408120610bf69083612271565b9392505050565b600091825260008051602061401d833981519152602090815260408084206001600160a01b0393909316845291905290205460ff1690565b610c3f600361227d565b610c4881612159565b50565b7f04a0afbbd09d5ad397fc858789da4f8edd59f5ca5098d70faa490babee945c3b610c7681336115cb565b61077a82610c9060008051602061403d8339815191525490565b6122b8565b6000818152600080516020613ffd8339815191526020526040812061056990612511565b610cc1610ea9565b60408051606081018252600080516020613f5d83398151915254815260008051602061405d833981519152546001600160401b0380821660208401819052600160401b909204169282019290925290821015610d4857602081015160405163431d301760e11b8152600481018490526001600160401b0390911660248201526044016105b7565b80602001516001600160401b0316821115610d61575050565b6000610d7960008051602061403d8339815191525490565b9050808311610d9a576040516252e2c960e41b815260040160405180910390fd5b6000600080516020613f5d8339815191525581602001516001600160401b03167fe21266bc27ee721ac10034efaf7fd724656ef471c75b8402cd8f07850af6b6768360000151604051610def91815260200190565b60405180910390a2505050565b610e058261077e565b610e0f81336115cb565b6107bd838361165e565b6001600160a01b038416610e4057604051636b35b1b760e01b815260040160405180910390fd5b610e4c8484848461251b565b610e56600261227d565b610e60600361227d565b50505050565b610e6e612531565b565b9055565b60006001600160e01b03198216637965db0b60e01b148061056957506301ffc9a760e01b6001600160e01b0319831614610569565b600080516020613fdd833981519152546001600160a01b0316336001600160a01b031614610e6e5760405163fef4d83160e01b815260040160405180910390fd5b60006001600160401b03821115610f525760405162461bcd60e51b815260206004820152602660248201527f53616665436173743a2076616c756520646f65736e27742066697420696e203660448201526534206269747360d01b60648201526084016105b7565b5090565b6040805160e081018252600080516020613fbd833981519152546001600160401b03808216808452600160401b830461ffff166020850152600160501b830460ff16151594840194909452600160581b820481166060840152600160981b909104166080820152600080516020613f7d8339815191525460a0820152600080516020613f9d8339815191525460c0820152908214801561101b57508060400151158061101b575080606001516001600160401b031681608001516001600160401b0316105b15610e6057817f801a93267f699b033e11b662b16b36c41b6f9a59a5b5ad967d4cb84232e523c28260800151836060015160405161106f9291906001600160401b0392831681529116602082015260400190565b60405180910390a250505050565b6040805160e081018252600080516020613fbd833981519152546001600160401b038082168352600160401b820461ffff166020840152600160501b820460ff16151593830193909352600160581b810483166060830152600160981b90049091166080820152600080516020613f7d8339815191525460a0820152600080516020613f9d8339815191525460c082015261111981600161274e565b80606001516001600160401b031681608001516001600160401b03161415611154576040516313f2ae7160e11b815260040160405180910390fd5b60008383604051611166929190613ad8565b604051809103902090508160c0015181146111a45760c082015160405163d2b3f3cf60e01b81526004810191909152602481018290526044016105b7565b8335905060006040518060a00160405280600085608001516001600160401b0316116111d15760006111e2565b600185608001516111e29190613afe565b6001600160401b0316815260200160008152602001602081526020018460a0015181526020017f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663ef6c064c6040518163ffffffff1660e01b815260040160206040518083038186803b15801561126157600080fd5b505afa158015611275573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112999190613b26565b6001600160a01b0316905290506112b185858361282b565b80516000906112c1906001613b43565b9050826114425783606001516001600160401b0316811461130d576060840151604051631c4de3e160e11b81526001600160401b039091166004820152602481018290526044016105b7565b60016040858101919091526001600160401b03828116608080880182905260608681015160a08a018190528951600080516020613fbd833981519152805460208d0151948d015192881669ffffffffffffffffffff1990911617600160401b61ffff909516949094029390931768ffffffffffffffffff60501b1916600160581b919096160294909417600160501b1767ffffffffffffffff60981b1916600160981b90930292909217909155600080516020613f7d8339815191529190915560c0860151600080516020613f9d83398151915255830151815163db3c7ba760e01b815291516001600160a01b039091169163db3c7ba791600480830192600092919082900301818387803b15801561142557600080fd5b505af1158015611439573d6000803e3d6000fd5b5050505061156e565b83606001516001600160401b03168110611487576060840151604051631c4de3e160e11b81526001600160401b039091166004820152602481018290526044016105b7565b60c084018390526001600160401b038181166080860181905260608481015160a088018190528751600080516020613fbd833981519152805460208b015160408c0151958c015193881669ffffffffffffffffffff1990921691909117600160401b61ffff909216919091021768ffffffffffffffffff60501b1916600160501b9415159490940267ffffffffffffffff60581b191693909317600160581b91909516029390931767ffffffffffffffff60981b1916600160981b909202919091179055600080516020613f7d83398151915255600080516020613f9d8339815191528390555b835160808501516060860151604080516001600160401b039384168152918316602083015291909216917f6d8abc91d336688c551c9bae92a74fa116852ac20bb9b2df4c12bd2fcf1cd46a910160405180910390a2505050505050565b6115d58282610bfd565b61077a576115ed816001600160a01b03166014612b7c565b6115f8836020612b7c565b604051602001611609929190613b87565b60408051601f198184030181529082905262461bcd60e51b82526105b791600401613bfc565b6116398282612d17565b6000828152600080516020613ffd833981519152602052604090206107bd9082612d8d565b6116688282612da2565b6000828152600080516020613ffd833981519152602052604090206107bd9082612e16565b336116b87f65fa0c17458517c727737e4153dd477fa3e328cf706640b0f68b1a285c5990da82610bfd565b1580156116cb57506116c981612e2b565b155b15610c48576040516323dada5360e01b815260040160405180910390fd5b60006116f3610979565b905080821461077a576040516303abe78360e21b815260048101829052602481018390526044016105b7565b60408051606081018252600080516020613f5d83398151915254815260008051602061405d833981519152546001600160401b0380821660208401819052600160401b90920416928201929092529084146117a557602081015160405163490b8d4560e11b81526001600160401b039091166004820152602481018590526044016105b7565b60006117bd60008051602061407d8339815191525490565b90508084146117e957604051632a37dd3d60e11b815260048101829052602481018590526044016105b7565b8151831461181757815160405163642c75c760e11b81526004810191909152602481018490526044016105b7565b5050505050565b60408051606081018252600080516020613f5d8339815191525480825260008051602061405d833981519152546001600160401b038082166020850152600160401b909104169282019290925260009161188b576040516364dfc18f60e01b815260040160405180910390fd5b6118a181604001516001600160401b0316612ec1565b60006118b960008051602061403d8339815191525490565b905081602001516001600160401b03168114156118e8576040516252e2c960e41b815260040160405180910390fd5b6020828101516001600160401b031660008051602061403d833981519152819055835160405190815290917ff73febded7d4502284718948a3e1d75406151c6326bde069424a584a4f6af87a910160405180910390a292915050565b6101a08201356119b7576101c0820135156119805760405163d2b3f3cf60e01b8152600060048201526101c083013560248201526044016105b7565b6101e0820135156119b257604051631c4de3e160e11b8152600060048201526101e083013560248201526044016105b7565b611a2a565b6001826101a00135146119e45760405163396e5b8360e01b81526101a083013560048201526024016105b7565b6101e0820135611a075760405163f1ff5c1760e01b815260040160405180910390fd5b6101c0820135611a2a57604051630862a50360e31b815260040160405180910390fd5b6000611a3a826020850135613c2f565b905060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663ef6c064c6040518163ffffffff1660e01b815260040160206040518083038186803b158015611a9757600080fd5b505afa158015611aab573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611acf9190613b26565b905060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166337d5fe996040518163ffffffff1660e01b815260040160206040518083038186803b158015611b2c57600080fd5b505afa158015611b40573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b649190613b26565b9050611b8a82611b776080880188613c46565b611b8460a08a018a613c46565b88612ee5565b6001600160a01b0381166396992fed611bab61016088016101408901613c8f565b611bd57f000000000000000000000000000000000000000000000000000000000000000088613cac565b611bff907f0000000000000000000000000000000000000000000000000000000000000000613b43565b611c2d7f000000000000000000000000000000000000000000000000000000000000000060208b0135613cac565b611c57907f0000000000000000000000000000000000000000000000000000000000000000613b43565b6040516001600160e01b031960e086901b168152921515600484015260248301919091526044820152606401600060405180830381600087803b158015611c9d57600080fd5b505af1158015611cb1573d6000803e3d6000fd5b505050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316639624e83e6040518163ffffffff1660e01b815260040160206040518083038186803b158015611d0e57600080fd5b505afa158015611d22573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d469190613b26565b6001600160a01b0316634e9b09256040518061010001604052807f00000000000000000000000000000000000000000000000000000000000000008960200135611d909190613cac565b611dba907f0000000000000000000000000000000000000000000000000000000000000000613b43565b8152602001611de97f000000000000000000000000000000000000000000000000000000000000000088613cac565b81526040808a0135602083015201611e0960608a0135633b9aca00613cac565b815260c0890135602082015260e089013560408201526101008901356060820152608001611e3b6101208a018a613c46565b8080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050509152506040516001600160e01b031960e084901b168152611e8f9190600401613ccb565b600060405180830381600087803b158015611ea957600080fd5b505af1158015611ebd573d6000803e3d6000fd5b505050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316632e39045c6040518163ffffffff1660e01b815260040160206040518083038186803b158015611f1a57600080fd5b505afa158015611f2e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f529190613b26565b6001600160a01b031663a37c62c0611f8e7f00000000000000000000000000000000000000000000000000000000000000006020890135613cac565b611fb8907f0000000000000000000000000000000000000000000000000000000000000000613b43565b610160880135611fcc6101808a018a613d68565b6040518563ffffffff1660e01b8152600401611feb9493929190613dae565b600060405180830381600087803b15801561200557600080fd5b505af1158015612019573d6000803e3d6000fd5b505050506040518060e001604052806120358760200135610eea565b6001600160401b03168152602001612051876101a00135613191565b61ffff1681526000602082015260400161206f6101e0880135613191565b61ffff16815260006020820181905260408201526101c0870135606090910152600080516020613fbd8339815191528151815460208401516040850151606086015160808701516001600160401b0395861669ffffffffffffffffffff1990951694909417600160401b61ffff909416939093029290921768ffffffffffffffffff60501b1916600160501b9115159190910267ffffffffffffffff60581b191617600160581b918416919091021767ffffffffffffffff60981b1916600160981b929091169190910217815560a0820151600182015560c0909101516002909101555050505050565b600061217160008051602061407d8339815191525490565b90508082141561219457604051631d7c761b60e21b815260040160405180910390fd5b6121ab60008051602061407d833981519152839055565b604051819083907ffa5304972d4ec3e3207f0bbf91155a49d0dfa62488f9529403a2a49e4b29a89590600090a35050565b6000806121f5600080516020613fdd8339815191525490565b90506000816001600160a01b03166372f79b136040518163ffffffff1660e01b8152600401604080518083038186803b15801561223157600080fd5b505afa158015612245573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122699190613dd8565b509392505050565b6000610bf683836131f4565b612285610979565b612290906001613b43565b81146122af5760405163167679d560e01b815260040160405180910390fd5b610c488161321e565b6001600160a01b0382166122df576040516303988b8160e61b815260040160405180910390fd5b60006122f7600080516020613fdd8339815191525490565b9050806001600160a01b0316836001600160a01b0316141561232c576040516321a55ce160e11b815260040160405180910390fd5b600080846001600160a01b031663606c0c946040518163ffffffff1660e01b815260040160606040518083038186803b15801561236857600080fd5b505afa15801561237c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123a09190613dfc565b92509250507f0000000000000000000000000000000000000000000000000000000000000000821415806123f457507f00000000000000000000000000000000000000000000000000000000000000008114155b1561241257604051635401d0a160e11b815260040160405180910390fd5b6000856001600160a01b0316636095012f6040518163ffffffff1660e01b815260040160206040518083038186803b15801561244d57600080fd5b505afa158015612461573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906124859190613e2a565b9050848110156124b257604051631e779ad160e11b815260048101829052602481018690526044016105b7565b6124c9600080516020613fdd833981519152879055565b836001600160a01b0316866001600160a01b03167f25421480fb7f52d18947876279a213696b58d7e0e5416ce5e2c9f9942661c34c60405160405180910390a3505050505050565b6000610569825490565b61252660008561327d565b610e60838383613287565b6040805160e081018252600080516020613fbd833981519152546001600160401b038082168352600160401b820461ffff166020840152600160501b820460ff16151593830193909352600160581b810483166060830152600160981b90049091166080820152600080516020613f7d8339815191525460a0820152600080516020613f9d8339815191525460c08201526125cd81600061274e565b8060400151156125f0576040516313f2ae7160e11b815260040160405180910390fd5b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663ef6c064c6040518163ffffffff1660e01b815260040160206040518083038186803b15801561264957600080fd5b505afa15801561265d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906126819190613b26565b6001600160a01b031663db3c7ba76040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156126bb57600080fd5b505af11580156126cf573d6000803e3d6000fd5b5050505060016126ea600080516020613fbd83398151915290565b8054911515600160501b0260ff60501b19909216919091179055805160408051600080825260208201526001600160401b03909216917f6d8abc91d336688c551c9bae92a74fa116852ac20bb9b2df4c12bd2fcf1cd46a910160405180910390a250565b61275661168d565b60408051606081018252600080516020613f5d8339815191525480825260008051602061405d833981519152546001600160401b038082166020850152600160401b90910416928201929092529015806127ca575080602001516001600160401b031683600001516001600160401b031614155b156127e85760405163a74cb4e560e01b815260040160405180910390fd5b6127f06132fa565b81836020015161ffff16146107bd576020830151604051630eb3232760e21b815261ffff9091166004820152602481018390526044016105b7565b60408101516000808080805b878610156129815750506060850151600585019488013560e881901c9160d89190911c61ffff169061289157811561288c5760405163067db80560e31b815260006004820152602481018390526044016105b7565b6128d5565b865161289e906001613b43565b82146128d55786516128b1906001613b43565b60405163067db80560e31b81526004810191909152602481018390526044016105b7565b81875260208701819052604087018690526001811415612912576040516332ef1f1160e11b815260048101839052602481018290526044016105b7565b6002811461293d57604051634166218d60e11b815260048101839052602481018290526044016105b7565b600061294a8a8a8a613325565b90508581111561295b578095508294505b8688604001511161296e5761296e613e43565b8760400151965083600101935050612837565b6000851161299157612991613e43565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663f5e6d50f6040518163ffffffff1660e01b815260040160206040518083038186803b1580156129ea57600080fd5b505afa1580156129fe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a229190613b26565b6001600160a01b031663c9bace93846040518263ffffffff1660e01b8152600401612a4f91815260200190565b60006040518083038186803b158015612a6757600080fd5b505afa158015612a7b573d6000803e3d6000fd5b505050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663f5e6d50f6040518163ffffffff1660e01b815260040160206040518083038186803b158015612ad857600080fd5b505afa158015612aec573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b109190613b26565b60405163057e0f6960e41b815260048101869052602481018790526001600160a01b0391909116906357e0f6909060440160006040518083038186803b158015612b5957600080fd5b505afa158015612b6d573d6000803e3d6000fd5b50505050505050505050505050565b60606000612b8b836002613cac565b612b96906002613b43565b6001600160401b03811115612bad57612bad613e59565b6040519080825280601f01601f191660200182016040528015612bd7576020820181803683370190505b509050600360fc1b81600081518110612bf257612bf2613e6f565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110612c2157612c21613e6f565b60200101906001600160f81b031916908160001a9053506000612c45846002613cac565b612c50906001613b43565b90505b6001811115612cc8576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110612c8457612c84613e6f565b1a60f81b828281518110612c9a57612c9a613e6f565b60200101906001600160f81b031916908160001a90535060049490941c93612cc181613e85565b9050612c53565b508315610bf65760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e7460448201526064016105b7565b612d218282610bfd565b61077a57600082815260008051602061401d833981519152602090815260408083206001600160a01b0385168085529252808320805460ff1916600117905551339285917f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d9190a45050565b6000610bf6836001600160a01b03841661351d565b612dac8282610bfd565b1561077a57600082815260008051602061401d833981519152602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000610bf6836001600160a01b03841661356c565b600080612e44600080516020613fdd8339815191525490565b604051631951c03760e01b81526001600160a01b03858116600483015291925090821690631951c0379060240160206040518083038186803b158015612e8957600080fd5b505afa158015612e9d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bf69190613e9c565b80421115610c485760405163537bacdf60e11b8152600481018290526024016105b7565b838214612f0557604051637540f08160e11b815260040160405180910390fd5b83612f0f57610768565b60015b84811015612f7c578585612f27600184613c2f565b818110612f3657612f36613e6f565b90506020020135868683818110612f4f57612f4f613e6f565b9050602002013511612f7457604051637540f08160e11b815260040160405180910390fd5b600101612f12565b5060005b84811015612fca57838382818110612f9a57612f9a613e6f565b9050602002013560001415612fc257604051637540f08160e11b815260040160405180910390fd5b600101612f80565b50604051632af5128960e21b81526000906001600160a01b0388169063abd44a2490613000908990899089908990600401613eb9565b602060405180830381600087803b15801561301a57600080fd5b505af115801561302e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906130529190613e2a565b90506000613080837f0000000000000000000000000000000000000000000000000000000000000000613cac565b61308d8362015180613cac565b6130979190613eeb565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663f5e6d50f6040518163ffffffff1660e01b815260040160206040518083038186803b1580156130f257600080fd5b505afa158015613106573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061312a9190613b26565b6001600160a01b031663e72980f4826040518263ffffffff1660e01b815260040161315791815260200190565b60006040518083038186803b15801561316f57600080fd5b505afa158015613183573d6000803e3d6000fd5b505050505050505050505050565b600061ffff821115610f525760405162461bcd60e51b815260206004820152602660248201527f53616665436173743a2076616c756520646f65736e27742066697420696e203160448201526536206269747360d01b60648201526084016105b7565b600082600001828154811061320b5761320b613e6f565b9060005260206000200154905092915050565b6132477f4dd0f6662ba1d6b081f08b350f5e9a6a7b15cf586926ba66f753594928fa64a6829055565b6040518181527ffddcded6b4f4730c226821172046b48372d3cd963c159701ae1b7c3bcac541bb9060200160405180910390a150565b61077a828261162f565b613291600161365f565b61329b83826122b8565b6132a482612159565b6132bb60008051602061403d833981519152829055565b6132c481610eea565b600080516020613f5d833981519152600101805467ffffffffffffffff19166001600160401b0392909216919091179055505050565b610e6e600080516020613f5d83398151915260010154600160401b90046001600160401b0316612ec1565b6040810151600090818080368181818a613340896023613b43565b1115613365578951604051635d84060560e11b815260048101919091526024016105b7565b878c01358060e81c97506001600160401b038160a81c16965050600b88018c019350600886029250833560c01c945082840191506010860290508b81830103975086600014156133ce578951604051635d84060560e11b815260048101919091526024016105b7565b600085604089901b60f08d60200151901b171790508a60600151811161340d578a51604051630cf5139d60e11b815260048101919091526024016105b7565b600060015b88811015613457576008810287013560c01c915060010187821161344f578c51604051630cf5139d60e11b815260048101919091526024016105b7565b819750613412565b505067ffffffffffffffff1916851760608b01528a881180613477575085155b1561349b578951604051635d84060560e11b815260048101919091526024016105b7565b89608001516001600160a01b031663c8ac498088868686866040518663ffffffff1660e01b81526004016134d3959493929190613f0d565b600060405180830381600087803b1580156134ed57600080fd5b505af1158015613501573d6000803e3d6000fd5b5050505060408a01979097525092955050505050509392505050565b600081815260018301602052604081205461356457508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610569565b506000610569565b60008181526001830160205260408120548015613655576000613590600183613c2f565b85549091506000906135a490600190613c2f565b90508181146136095760008660000182815481106135c4576135c4613e6f565b90600052602060002001549050808760000184815481106135e7576135e7613e6f565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061361a5761361a613f46565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610569565b6000915050610569565b613667610979565b156122af5760405163184e52a160e21b815260040160405180910390fd5b60006020828403121561369757600080fd5b81356001600160e01b031981168114610bf657600080fd5b6000806000606084860312156136c457600080fd5b505081359360208301359350604090920135919050565b600080602083850312156136ee57600080fd5b82356001600160401b038082111561370557600080fd5b818501915085601f83011261371957600080fd5b81358181111561372857600080fd5b86602082850101111561373a57600080fd5b60209290920196919550909350505050565b60006020828403121561375e57600080fd5b5035919050565b6001600160a01b0381168114610c4857600080fd5b6000806040838503121561378d57600080fd5b82359150602083013561379f81613765565b809150509250929050565b600080604083850312156137bd57600080fd5b82356001600160401b038111156137d357600080fd5b830161020081860312156137e657600080fd5b946020939093013593505050565b6000806040838503121561380757600080fd5b50508035926020909101359150565b60006020828403121561382857600080fd5b8135610bf681613765565b6000806000806080858703121561384957600080fd5b843561385481613765565b9350602085013561386481613765565b93969395505050506040820135916060013590565b6000808335601e1984360301811261389057600080fd5b83016020810192503590506001600160401b038111156138af57600080fd5b8060051b36038313156138c157600080fd5b9250929050565b81835260006001600160fb1b038311156138e157600080fd5b8260051b8083602087013760009401602001938452509192915050565b8015158114610c4857600080fd5b8035613917816138fe565b919050565b6000808335601e1984360301811261393357600080fd5b83016020810192503590506001600160401b0381111561395257600080fd5b8036038313156138c157600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b602081528135602082015260208201356040820152604082013560608201526060820135608082015260006139c26080840184613879565b6102008060a08601526139da610220860183856138c8565b92506139e960a0870187613879565b9250601f19808786030160c0880152613a038585846138c8565b945060c088013560e0880152610100935060e08801358488015261012091508388013582880152613a3682890189613879565b94509150610140818887030181890152613a518686856138c8565b9550613a5e818a0161390c565b9450506101609150613a738288018515159052565b61018093508188013584880152613a8c8489018961391c565b945091506101a0818887030181890152613aa7868685613961565b908901356101c0898101919091528901356101e0808a01919091529098013592909601919091525093949350505050565b8183823760009101908152919050565b634e487b7160e01b600052601160045260246000fd5b60006001600160401b0383811690831681811015613b1e57613b1e613ae8565b039392505050565b600060208284031215613b3857600080fd5b8151610bf681613765565b60008219821115613b5657613b56613ae8565b500190565b60005b83811015613b76578181015183820152602001613b5e565b83811115610e605750506000910152565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613bbf816017850160208801613b5b565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613bf0816028840160208801613b5b565b01602801949350505050565b6020815260008251806020840152613c1b816040850160208701613b5b565b601f01601f19169190910160400192915050565b600082821015613c4157613c41613ae8565b500390565b6000808335601e19843603018112613c5d57600080fd5b8301803591506001600160401b03821115613c7757600080fd5b6020019150600581901b36038213156138c157600080fd5b600060208284031215613ca157600080fd5b8135610bf6816138fe565b6000816000190483118215151615613cc657613cc6613ae8565b500290565b6000602080835261012083018451828501528185015160408501526040850151606085015260608501516080850152608085015160a085015260a085015160c085015260c085015160e085015260e0850151610100808187015250818151808452610140870191508483019350600092505b80831015613d5d5783518252928401926001929092019190840190613d3d565b509695505050505050565b6000808335601e19843603018112613d7f57600080fd5b8301803591506001600160401b03821115613d9957600080fd5b6020019150368190038213156138c157600080fd5b848152836020820152606060408201526000613dce606083018486613961565b9695505050505050565b60008060408385031215613deb57600080fd5b505080516020909101519092909150565b600080600060608486031215613e1157600080fd5b8351925060208401519150604084015190509250925092565b600060208284031215613e3c57600080fd5b5051919050565b634e487b7160e01b600052600160045260246000fd5b634e487b7160e01b600052604160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b600081613e9457613e94613ae8565b506000190190565b600060208284031215613eae57600080fd5b8151610bf6816138fe565b604081526000613ecd6040830186886138c8565b8281036020840152613ee08185876138c8565b979650505050505050565b600082613f0857634e487b7160e01b600052601260045260246000fd5b500490565b858152606060208201526000613f27606083018688613961565b8281036040840152613f3a818587613961565b98975050505050505050565b634e487b7160e01b600052603160045260246000fdfe9d565e483b8608dc09e04eff85533859683d2eeaa6ebc28af53a92d7dba3eea6f9f2bb418c2b91bec33476bd883cf719692d3c9eed6e03bb161098abe08fa63ef9f2bb418c2b91bec33476bd883cf719692d3c9eed6e03bb161098abe08fa63ff9f2bb418c2b91bec33476bd883cf719692d3c9eed6e03bb161098abe08fa63db0e01b719c2c32a677822ce1584cb6a66e576ee3c2c506b9621dbe626355aa658f8c450dae5029cd48cd91dd9db65da48fb742893edfc7941250f6721d93cbbe9a627a5d4aa7c17f87ff26e3fe9a42c2b6c559e8b41a42282d0ecebb17c0e4d3c9bdcd6eb2e956ecf03d8d27bee4c163f9b5c078aa69020d618e76513b5d0a949d565e483b8608dc09e04eff85533859683d2eeaa6ebc28af53a92d7dba3eea72767d6892477f8d2750fb44e817c9aed93d34d3c6be4101ed58bcac692c99e9ca2646970667358221220a6ab491ead1e6635f35943b81329b31ea56b01e8c1559ee6dc81b4da0024bf8b64736f6c63430008090033000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea291980000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000067d81118
Deployed Bytecode
0x608060405234801561001057600080fd5b50600436106102055760003560e01c80638aa104351161011a578063a217fddf116100ad578063d43812171161007c578063d4381217146104dc578063d547741f146104ef578063eb990c5914610502578063f288246114610515578063fa565b051461053c57600080fd5b8063a217fddf1461038b578063ad5cac4e1461048f578063c469c307146104b6578063ca15c873146104c957600080fd5b80639010d07c116100e95780639010d07c1461042f57806391d14854146104425780639290281b146104555780639cc23c791461046857600080fd5b80638aa10435146103935780638d5914741461039b5780638f55b571146103ae5780638f7797c2146103b657600080fd5b806336568abe1161019d57806357a782891161016c57806357a782891461031a5780635be204251461035957806360d64d3814610361578063672690b41461020a57806374facb9b1461038b57600080fd5b806336568abe146102c557806336eca5a7146102d857806346e1f576146102eb578063560f97cb1461031257600080fd5b8063248a9ca3116101d9578063248a9ca3146102705780632f2ff15d14610283578063304b9071146102965780633584d59c146102bd57600080fd5b80625418e11461020a57806301ffc9a714610225578063063f36ad1461024857806306c373da1461025d575b600080fd5b610212600181565b6040519081526020015b60405180910390f35b610238610233366004613685565b610544565b604051901515815260200161021c565b61025b6102563660046136af565b61056f565b005b61025b61026b3660046136db565b610770565b61021261027e36600461374c565b61077e565b61025b61029136600461377a565b6107a0565b6102127f000000000000000000000000000000000000000000000000000000000000000c81565b6102126107c2565b61025b6102d336600461377a565b6107df565b61025b6102e63660046137aa565b610859565b6102127f65fa0c17458517c727737e4153dd477fa3e328cf706640b0f68b1a285c5990da81565b610212600281565b6103417f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea29198081565b6040516001600160a01b03909116815260200161021c565b6102126108b9565b6103696108d1565b604080519485526020850193909352918301521515606082015260800161021c565b610212600081565b610212610979565b61025b6103a936600461374c565b6109a3565b6103416109d7565b6103be6109ef565b60405161021c91906000610120820190508251825260208301516020830152604083015160408301526060830151151560608301526080830151608083015260a083015160a083015260c0830151151560c083015260e083015160e083015261010080840151818401525092915050565b61034161043d3660046137f4565b610bd1565b61023861045036600461377a565b610bfd565b61025b61046336600461374c565b610c35565b6102127fc31b1e4b732c5173dc51d519dfa432bad95550ecc4b0f9a61c2a558a2a8e434181565b6102127f04a0afbbd09d5ad397fc858789da4f8edd59f5ca5098d70faa490babee945c3b81565b61025b6104c4366004613816565b610c4b565b6102126104d736600461374c565b610c95565b61025b6104ea36600461374c565b610cb9565b61025b6104fd36600461377a565b610dfc565b61025b610510366004613833565b610e19565b6102127f0000000000000000000000000000000000000000000000000000000067d8111881565b61025b610e66565b60006001600160e01b03198216635a05180f60e01b1480610569575061056982610e74565b92915050565b610577610ea9565b60008051602061405d833981519152546001600160401b0316808310156105c05760405163431d301760e11b815260048101849052602481018290526044015b60405180910390fd5b60006105d860008051602061403d8339815191525490565b9050808411610604576040516360a41e4960e01b815260048101859052602481018290526044016105b7565b824211156106285760405163537bacdf60e11b8152600481018490526024016105b7565b8184141580156106385750818114155b156106695760405182907f800b849c8bf80718cf786c99d1091c079fe2c5e420a3ba7ba9b0ef8179ef2c3890600090a25b8461068757604051635b18a69f60e11b815260040160405180910390fd5b604080518681526020810185905285917faed7d1a7a1831158dcda1e4214f5862f450bd3eb5721a5f322bf8c9fe1790b0a910160405180910390a2600060405180606001604052808781526020016106de87610eea565b6001600160401b031681526020016106f586610eea565b6001600160401b039081169091528151600080516020613f5d83398151915255602082015160008051602061405d833981519152805460408501518416600160401b026fffffffffffffffffffffffffffffffff1990911692909316919091179190911790559050610768818484610f56565b505050505050565b61077a828261107d565b5050565b600090815260008051602061401d833981519152602052604090206001015490565b6107a98261077e565b6107b381336115cb565b6107bd838361162f565b505050565b60006107da60008051602061403d8339815191525490565b905090565b6001600160a01b038116331461084f5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084016105b7565b61077a828261165e565b61086161168d565b61086a816116e9565b6108a38260200135836000013584604051602001610888919061398a565b6040516020818303038152906040528051906020012061171f565b60006108ad61181e565b90506107bd8382611944565b60006107da60008051602061407d8339815191525490565b600080808080600080516020613f5d83398151915260408051606081018252825481526001909201546001600160401b038082166020850152600160401b90910416908201529050600061093160008051602061403d8339815191525490565b8251602084015160408501519293509091821580159061095d57508385602001516001600160401b0316145b92996001600160401b0392831699509116965090945092505050565b60006107da7f4dd0f6662ba1d6b081f08b350f5e9a6a7b15cf586926ba66f753594928fa64a65490565b7fc31b1e4b732c5173dc51d519dfa432bad95550ecc4b0f9a61c2a558a2a8e43416109ce81336115cb565b61077a82612159565b60006107da600080516020613fdd8339815191525490565b6040805161012081018252600080825260208201819052918101829052606081018290526080810182905260a0810182905260c0810182905260e08101829052610100810182905290600080516020613f5d83398151915260408051606081018252825481526001909201546001600160401b038082166020850152600160401b90910416908201529050610a826121dc565b825280511580610aa3575080602001516001600160401b0316826000015114155b15610aac575090565b6040808201516001600160401b031660208401528151908301526000610ade60008051602061403d8339815191525490565b60208301516001600160401b0316811460608501819052909150610b0157505090565b50506040805160e08082018352600080516020613fbd833981519152546001600160401b03808216845261ffff600160401b830481166020860190815260ff600160501b8504161515968601968752600160581b8404831660608701908152600160981b90940483166080808801918252600080516020613f7d8339815191525460a0808a0191909152600080516020613f9d8339815191525460c0998a01819052918b019190915291519092169088015294511515938601939093525182169084015290511661010082015290565b6000828152600080516020613ffd83398151915260205260408120610bf69083612271565b9392505050565b600091825260008051602061401d833981519152602090815260408084206001600160a01b0393909316845291905290205460ff1690565b610c3f600361227d565b610c4881612159565b50565b7f04a0afbbd09d5ad397fc858789da4f8edd59f5ca5098d70faa490babee945c3b610c7681336115cb565b61077a82610c9060008051602061403d8339815191525490565b6122b8565b6000818152600080516020613ffd8339815191526020526040812061056990612511565b610cc1610ea9565b60408051606081018252600080516020613f5d83398151915254815260008051602061405d833981519152546001600160401b0380821660208401819052600160401b909204169282019290925290821015610d4857602081015160405163431d301760e11b8152600481018490526001600160401b0390911660248201526044016105b7565b80602001516001600160401b0316821115610d61575050565b6000610d7960008051602061403d8339815191525490565b9050808311610d9a576040516252e2c960e41b815260040160405180910390fd5b6000600080516020613f5d8339815191525581602001516001600160401b03167fe21266bc27ee721ac10034efaf7fd724656ef471c75b8402cd8f07850af6b6768360000151604051610def91815260200190565b60405180910390a2505050565b610e058261077e565b610e0f81336115cb565b6107bd838361165e565b6001600160a01b038416610e4057604051636b35b1b760e01b815260040160405180910390fd5b610e4c8484848461251b565b610e56600261227d565b610e60600361227d565b50505050565b610e6e612531565b565b9055565b60006001600160e01b03198216637965db0b60e01b148061056957506301ffc9a760e01b6001600160e01b0319831614610569565b600080516020613fdd833981519152546001600160a01b0316336001600160a01b031614610e6e5760405163fef4d83160e01b815260040160405180910390fd5b60006001600160401b03821115610f525760405162461bcd60e51b815260206004820152602660248201527f53616665436173743a2076616c756520646f65736e27742066697420696e203660448201526534206269747360d01b60648201526084016105b7565b5090565b6040805160e081018252600080516020613fbd833981519152546001600160401b03808216808452600160401b830461ffff166020850152600160501b830460ff16151594840194909452600160581b820481166060840152600160981b909104166080820152600080516020613f7d8339815191525460a0820152600080516020613f9d8339815191525460c0820152908214801561101b57508060400151158061101b575080606001516001600160401b031681608001516001600160401b0316105b15610e6057817f801a93267f699b033e11b662b16b36c41b6f9a59a5b5ad967d4cb84232e523c28260800151836060015160405161106f9291906001600160401b0392831681529116602082015260400190565b60405180910390a250505050565b6040805160e081018252600080516020613fbd833981519152546001600160401b038082168352600160401b820461ffff166020840152600160501b820460ff16151593830193909352600160581b810483166060830152600160981b90049091166080820152600080516020613f7d8339815191525460a0820152600080516020613f9d8339815191525460c082015261111981600161274e565b80606001516001600160401b031681608001516001600160401b03161415611154576040516313f2ae7160e11b815260040160405180910390fd5b60008383604051611166929190613ad8565b604051809103902090508160c0015181146111a45760c082015160405163d2b3f3cf60e01b81526004810191909152602481018290526044016105b7565b8335905060006040518060a00160405280600085608001516001600160401b0316116111d15760006111e2565b600185608001516111e29190613afe565b6001600160401b0316815260200160008152602001602081526020018460a0015181526020017f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b031663ef6c064c6040518163ffffffff1660e01b815260040160206040518083038186803b15801561126157600080fd5b505afa158015611275573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112999190613b26565b6001600160a01b0316905290506112b185858361282b565b80516000906112c1906001613b43565b9050826114425783606001516001600160401b0316811461130d576060840151604051631c4de3e160e11b81526001600160401b039091166004820152602481018290526044016105b7565b60016040858101919091526001600160401b03828116608080880182905260608681015160a08a018190528951600080516020613fbd833981519152805460208d0151948d015192881669ffffffffffffffffffff1990911617600160401b61ffff909516949094029390931768ffffffffffffffffff60501b1916600160581b919096160294909417600160501b1767ffffffffffffffff60981b1916600160981b90930292909217909155600080516020613f7d8339815191529190915560c0860151600080516020613f9d83398151915255830151815163db3c7ba760e01b815291516001600160a01b039091169163db3c7ba791600480830192600092919082900301818387803b15801561142557600080fd5b505af1158015611439573d6000803e3d6000fd5b5050505061156e565b83606001516001600160401b03168110611487576060840151604051631c4de3e160e11b81526001600160401b039091166004820152602481018290526044016105b7565b60c084018390526001600160401b038181166080860181905260608481015160a088018190528751600080516020613fbd833981519152805460208b015160408c0151958c015193881669ffffffffffffffffffff1990921691909117600160401b61ffff909216919091021768ffffffffffffffffff60501b1916600160501b9415159490940267ffffffffffffffff60581b191693909317600160581b91909516029390931767ffffffffffffffff60981b1916600160981b909202919091179055600080516020613f7d83398151915255600080516020613f9d8339815191528390555b835160808501516060860151604080516001600160401b039384168152918316602083015291909216917f6d8abc91d336688c551c9bae92a74fa116852ac20bb9b2df4c12bd2fcf1cd46a910160405180910390a2505050505050565b6115d58282610bfd565b61077a576115ed816001600160a01b03166014612b7c565b6115f8836020612b7c565b604051602001611609929190613b87565b60408051601f198184030181529082905262461bcd60e51b82526105b791600401613bfc565b6116398282612d17565b6000828152600080516020613ffd833981519152602052604090206107bd9082612d8d565b6116688282612da2565b6000828152600080516020613ffd833981519152602052604090206107bd9082612e16565b336116b87f65fa0c17458517c727737e4153dd477fa3e328cf706640b0f68b1a285c5990da82610bfd565b1580156116cb57506116c981612e2b565b155b15610c48576040516323dada5360e01b815260040160405180910390fd5b60006116f3610979565b905080821461077a576040516303abe78360e21b815260048101829052602481018390526044016105b7565b60408051606081018252600080516020613f5d83398151915254815260008051602061405d833981519152546001600160401b0380821660208401819052600160401b90920416928201929092529084146117a557602081015160405163490b8d4560e11b81526001600160401b039091166004820152602481018590526044016105b7565b60006117bd60008051602061407d8339815191525490565b90508084146117e957604051632a37dd3d60e11b815260048101829052602481018590526044016105b7565b8151831461181757815160405163642c75c760e11b81526004810191909152602481018490526044016105b7565b5050505050565b60408051606081018252600080516020613f5d8339815191525480825260008051602061405d833981519152546001600160401b038082166020850152600160401b909104169282019290925260009161188b576040516364dfc18f60e01b815260040160405180910390fd5b6118a181604001516001600160401b0316612ec1565b60006118b960008051602061403d8339815191525490565b905081602001516001600160401b03168114156118e8576040516252e2c960e41b815260040160405180910390fd5b6020828101516001600160401b031660008051602061403d833981519152819055835160405190815290917ff73febded7d4502284718948a3e1d75406151c6326bde069424a584a4f6af87a910160405180910390a292915050565b6101a08201356119b7576101c0820135156119805760405163d2b3f3cf60e01b8152600060048201526101c083013560248201526044016105b7565b6101e0820135156119b257604051631c4de3e160e11b8152600060048201526101e083013560248201526044016105b7565b611a2a565b6001826101a00135146119e45760405163396e5b8360e01b81526101a083013560048201526024016105b7565b6101e0820135611a075760405163f1ff5c1760e01b815260040160405180910390fd5b6101c0820135611a2a57604051630862a50360e31b815260040160405180910390fd5b6000611a3a826020850135613c2f565b905060007f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b031663ef6c064c6040518163ffffffff1660e01b815260040160206040518083038186803b158015611a9757600080fd5b505afa158015611aab573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611acf9190613b26565b905060007f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b03166337d5fe996040518163ffffffff1660e01b815260040160206040518083038186803b158015611b2c57600080fd5b505afa158015611b40573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b649190613b26565b9050611b8a82611b776080880188613c46565b611b8460a08a018a613c46565b88612ee5565b6001600160a01b0381166396992fed611bab61016088016101408901613c8f565b611bd57f000000000000000000000000000000000000000000000000000000000000000c88613cac565b611bff907f0000000000000000000000000000000000000000000000000000000067d81118613b43565b611c2d7f000000000000000000000000000000000000000000000000000000000000000c60208b0135613cac565b611c57907f0000000000000000000000000000000000000000000000000000000067d81118613b43565b6040516001600160e01b031960e086901b168152921515600484015260248301919091526044820152606401600060405180830381600087803b158015611c9d57600080fd5b505af1158015611cb1573d6000803e3d6000fd5b505050507f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b0316639624e83e6040518163ffffffff1660e01b815260040160206040518083038186803b158015611d0e57600080fd5b505afa158015611d22573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d469190613b26565b6001600160a01b0316634e9b09256040518061010001604052807f000000000000000000000000000000000000000000000000000000000000000c8960200135611d909190613cac565b611dba907f0000000000000000000000000000000000000000000000000000000067d81118613b43565b8152602001611de97f000000000000000000000000000000000000000000000000000000000000000c88613cac565b81526040808a0135602083015201611e0960608a0135633b9aca00613cac565b815260c0890135602082015260e089013560408201526101008901356060820152608001611e3b6101208a018a613c46565b8080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050509152506040516001600160e01b031960e084901b168152611e8f9190600401613ccb565b600060405180830381600087803b158015611ea957600080fd5b505af1158015611ebd573d6000803e3d6000fd5b505050507f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b0316632e39045c6040518163ffffffff1660e01b815260040160206040518083038186803b158015611f1a57600080fd5b505afa158015611f2e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f529190613b26565b6001600160a01b031663a37c62c0611f8e7f000000000000000000000000000000000000000000000000000000000000000c6020890135613cac565b611fb8907f0000000000000000000000000000000000000000000000000000000067d81118613b43565b610160880135611fcc6101808a018a613d68565b6040518563ffffffff1660e01b8152600401611feb9493929190613dae565b600060405180830381600087803b15801561200557600080fd5b505af1158015612019573d6000803e3d6000fd5b505050506040518060e001604052806120358760200135610eea565b6001600160401b03168152602001612051876101a00135613191565b61ffff1681526000602082015260400161206f6101e0880135613191565b61ffff16815260006020820181905260408201526101c0870135606090910152600080516020613fbd8339815191528151815460208401516040850151606086015160808701516001600160401b0395861669ffffffffffffffffffff1990951694909417600160401b61ffff909416939093029290921768ffffffffffffffffff60501b1916600160501b9115159190910267ffffffffffffffff60581b191617600160581b918416919091021767ffffffffffffffff60981b1916600160981b929091169190910217815560a0820151600182015560c0909101516002909101555050505050565b600061217160008051602061407d8339815191525490565b90508082141561219457604051631d7c761b60e21b815260040160405180910390fd5b6121ab60008051602061407d833981519152839055565b604051819083907ffa5304972d4ec3e3207f0bbf91155a49d0dfa62488f9529403a2a49e4b29a89590600090a35050565b6000806121f5600080516020613fdd8339815191525490565b90506000816001600160a01b03166372f79b136040518163ffffffff1660e01b8152600401604080518083038186803b15801561223157600080fd5b505afa158015612245573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122699190613dd8565b509392505050565b6000610bf683836131f4565b612285610979565b612290906001613b43565b81146122af5760405163167679d560e01b815260040160405180910390fd5b610c488161321e565b6001600160a01b0382166122df576040516303988b8160e61b815260040160405180910390fd5b60006122f7600080516020613fdd8339815191525490565b9050806001600160a01b0316836001600160a01b0316141561232c576040516321a55ce160e11b815260040160405180910390fd5b600080846001600160a01b031663606c0c946040518163ffffffff1660e01b815260040160606040518083038186803b15801561236857600080fd5b505afa15801561237c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123a09190613dfc565b92509250507f000000000000000000000000000000000000000000000000000000000000000c821415806123f457507f0000000000000000000000000000000000000000000000000000000067d811188114155b1561241257604051635401d0a160e11b815260040160405180910390fd5b6000856001600160a01b0316636095012f6040518163ffffffff1660e01b815260040160206040518083038186803b15801561244d57600080fd5b505afa158015612461573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906124859190613e2a565b9050848110156124b257604051631e779ad160e11b815260048101829052602481018690526044016105b7565b6124c9600080516020613fdd833981519152879055565b836001600160a01b0316866001600160a01b03167f25421480fb7f52d18947876279a213696b58d7e0e5416ce5e2c9f9942661c34c60405160405180910390a3505050505050565b6000610569825490565b61252660008561327d565b610e60838383613287565b6040805160e081018252600080516020613fbd833981519152546001600160401b038082168352600160401b820461ffff166020840152600160501b820460ff16151593830193909352600160581b810483166060830152600160981b90049091166080820152600080516020613f7d8339815191525460a0820152600080516020613f9d8339815191525460c08201526125cd81600061274e565b8060400151156125f0576040516313f2ae7160e11b815260040160405180910390fd5b7f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b031663ef6c064c6040518163ffffffff1660e01b815260040160206040518083038186803b15801561264957600080fd5b505afa15801561265d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906126819190613b26565b6001600160a01b031663db3c7ba76040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156126bb57600080fd5b505af11580156126cf573d6000803e3d6000fd5b5050505060016126ea600080516020613fbd83398151915290565b8054911515600160501b0260ff60501b19909216919091179055805160408051600080825260208201526001600160401b03909216917f6d8abc91d336688c551c9bae92a74fa116852ac20bb9b2df4c12bd2fcf1cd46a910160405180910390a250565b61275661168d565b60408051606081018252600080516020613f5d8339815191525480825260008051602061405d833981519152546001600160401b038082166020850152600160401b90910416928201929092529015806127ca575080602001516001600160401b031683600001516001600160401b031614155b156127e85760405163a74cb4e560e01b815260040160405180910390fd5b6127f06132fa565b81836020015161ffff16146107bd576020830151604051630eb3232760e21b815261ffff9091166004820152602481018390526044016105b7565b60408101516000808080805b878610156129815750506060850151600585019488013560e881901c9160d89190911c61ffff169061289157811561288c5760405163067db80560e31b815260006004820152602481018390526044016105b7565b6128d5565b865161289e906001613b43565b82146128d55786516128b1906001613b43565b60405163067db80560e31b81526004810191909152602481018390526044016105b7565b81875260208701819052604087018690526001811415612912576040516332ef1f1160e11b815260048101839052602481018290526044016105b7565b6002811461293d57604051634166218d60e11b815260048101839052602481018290526044016105b7565b600061294a8a8a8a613325565b90508581111561295b578095508294505b8688604001511161296e5761296e613e43565b8760400151965083600101935050612837565b6000851161299157612991613e43565b7f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b031663f5e6d50f6040518163ffffffff1660e01b815260040160206040518083038186803b1580156129ea57600080fd5b505afa1580156129fe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a229190613b26565b6001600160a01b031663c9bace93846040518263ffffffff1660e01b8152600401612a4f91815260200190565b60006040518083038186803b158015612a6757600080fd5b505afa158015612a7b573d6000803e3d6000fd5b505050507f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b031663f5e6d50f6040518163ffffffff1660e01b815260040160206040518083038186803b158015612ad857600080fd5b505afa158015612aec573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b109190613b26565b60405163057e0f6960e41b815260048101869052602481018790526001600160a01b0391909116906357e0f6909060440160006040518083038186803b158015612b5957600080fd5b505afa158015612b6d573d6000803e3d6000fd5b50505050505050505050505050565b60606000612b8b836002613cac565b612b96906002613b43565b6001600160401b03811115612bad57612bad613e59565b6040519080825280601f01601f191660200182016040528015612bd7576020820181803683370190505b509050600360fc1b81600081518110612bf257612bf2613e6f565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110612c2157612c21613e6f565b60200101906001600160f81b031916908160001a9053506000612c45846002613cac565b612c50906001613b43565b90505b6001811115612cc8576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110612c8457612c84613e6f565b1a60f81b828281518110612c9a57612c9a613e6f565b60200101906001600160f81b031916908160001a90535060049490941c93612cc181613e85565b9050612c53565b508315610bf65760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e7460448201526064016105b7565b612d218282610bfd565b61077a57600082815260008051602061401d833981519152602090815260408083206001600160a01b0385168085529252808320805460ff1916600117905551339285917f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d9190a45050565b6000610bf6836001600160a01b03841661351d565b612dac8282610bfd565b1561077a57600082815260008051602061401d833981519152602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000610bf6836001600160a01b03841661356c565b600080612e44600080516020613fdd8339815191525490565b604051631951c03760e01b81526001600160a01b03858116600483015291925090821690631951c0379060240160206040518083038186803b158015612e8957600080fd5b505afa158015612e9d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bf69190613e9c565b80421115610c485760405163537bacdf60e11b8152600481018290526024016105b7565b838214612f0557604051637540f08160e11b815260040160405180910390fd5b83612f0f57610768565b60015b84811015612f7c578585612f27600184613c2f565b818110612f3657612f36613e6f565b90506020020135868683818110612f4f57612f4f613e6f565b9050602002013511612f7457604051637540f08160e11b815260040160405180910390fd5b600101612f12565b5060005b84811015612fca57838382818110612f9a57612f9a613e6f565b9050602002013560001415612fc257604051637540f08160e11b815260040160405180910390fd5b600101612f80565b50604051632af5128960e21b81526000906001600160a01b0388169063abd44a2490613000908990899089908990600401613eb9565b602060405180830381600087803b15801561301a57600080fd5b505af115801561302e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906130529190613e2a565b90506000613080837f000000000000000000000000000000000000000000000000000000000000000c613cac565b61308d8362015180613cac565b6130979190613eeb565b90507f000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea2919806001600160a01b031663f5e6d50f6040518163ffffffff1660e01b815260040160206040518083038186803b1580156130f257600080fd5b505afa158015613106573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061312a9190613b26565b6001600160a01b031663e72980f4826040518263ffffffff1660e01b815260040161315791815260200190565b60006040518083038186803b15801561316f57600080fd5b505afa158015613183573d6000803e3d6000fd5b505050505050505050505050565b600061ffff821115610f525760405162461bcd60e51b815260206004820152602660248201527f53616665436173743a2076616c756520646f65736e27742066697420696e203160448201526536206269747360d01b60648201526084016105b7565b600082600001828154811061320b5761320b613e6f565b9060005260206000200154905092915050565b6132477f4dd0f6662ba1d6b081f08b350f5e9a6a7b15cf586926ba66f753594928fa64a6829055565b6040518181527ffddcded6b4f4730c226821172046b48372d3cd963c159701ae1b7c3bcac541bb9060200160405180910390a150565b61077a828261162f565b613291600161365f565b61329b83826122b8565b6132a482612159565b6132bb60008051602061403d833981519152829055565b6132c481610eea565b600080516020613f5d833981519152600101805467ffffffffffffffff19166001600160401b0392909216919091179055505050565b610e6e600080516020613f5d83398151915260010154600160401b90046001600160401b0316612ec1565b6040810151600090818080368181818a613340896023613b43565b1115613365578951604051635d84060560e11b815260048101919091526024016105b7565b878c01358060e81c97506001600160401b038160a81c16965050600b88018c019350600886029250833560c01c945082840191506010860290508b81830103975086600014156133ce578951604051635d84060560e11b815260048101919091526024016105b7565b600085604089901b60f08d60200151901b171790508a60600151811161340d578a51604051630cf5139d60e11b815260048101919091526024016105b7565b600060015b88811015613457576008810287013560c01c915060010187821161344f578c51604051630cf5139d60e11b815260048101919091526024016105b7565b819750613412565b505067ffffffffffffffff1916851760608b01528a881180613477575085155b1561349b578951604051635d84060560e11b815260048101919091526024016105b7565b89608001516001600160a01b031663c8ac498088868686866040518663ffffffff1660e01b81526004016134d3959493929190613f0d565b600060405180830381600087803b1580156134ed57600080fd5b505af1158015613501573d6000803e3d6000fd5b5050505060408a01979097525092955050505050509392505050565b600081815260018301602052604081205461356457508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610569565b506000610569565b60008181526001830160205260408120548015613655576000613590600183613c2f565b85549091506000906135a490600190613c2f565b90508181146136095760008660000182815481106135c4576135c4613e6f565b90600052602060002001549050808760000184815481106135e7576135e7613e6f565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061361a5761361a613f46565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610569565b6000915050610569565b613667610979565b156122af5760405163184e52a160e21b815260040160405180910390fd5b60006020828403121561369757600080fd5b81356001600160e01b031981168114610bf657600080fd5b6000806000606084860312156136c457600080fd5b505081359360208301359350604090920135919050565b600080602083850312156136ee57600080fd5b82356001600160401b038082111561370557600080fd5b818501915085601f83011261371957600080fd5b81358181111561372857600080fd5b86602082850101111561373a57600080fd5b60209290920196919550909350505050565b60006020828403121561375e57600080fd5b5035919050565b6001600160a01b0381168114610c4857600080fd5b6000806040838503121561378d57600080fd5b82359150602083013561379f81613765565b809150509250929050565b600080604083850312156137bd57600080fd5b82356001600160401b038111156137d357600080fd5b830161020081860312156137e657600080fd5b946020939093013593505050565b6000806040838503121561380757600080fd5b50508035926020909101359150565b60006020828403121561382857600080fd5b8135610bf681613765565b6000806000806080858703121561384957600080fd5b843561385481613765565b9350602085013561386481613765565b93969395505050506040820135916060013590565b6000808335601e1984360301811261389057600080fd5b83016020810192503590506001600160401b038111156138af57600080fd5b8060051b36038313156138c157600080fd5b9250929050565b81835260006001600160fb1b038311156138e157600080fd5b8260051b8083602087013760009401602001938452509192915050565b8015158114610c4857600080fd5b8035613917816138fe565b919050565b6000808335601e1984360301811261393357600080fd5b83016020810192503590506001600160401b0381111561395257600080fd5b8036038313156138c157600080fd5b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b602081528135602082015260208201356040820152604082013560608201526060820135608082015260006139c26080840184613879565b6102008060a08601526139da610220860183856138c8565b92506139e960a0870187613879565b9250601f19808786030160c0880152613a038585846138c8565b945060c088013560e0880152610100935060e08801358488015261012091508388013582880152613a3682890189613879565b94509150610140818887030181890152613a518686856138c8565b9550613a5e818a0161390c565b9450506101609150613a738288018515159052565b61018093508188013584880152613a8c8489018961391c565b945091506101a0818887030181890152613aa7868685613961565b908901356101c0898101919091528901356101e0808a01919091529098013592909601919091525093949350505050565b8183823760009101908152919050565b634e487b7160e01b600052601160045260246000fd5b60006001600160401b0383811690831681811015613b1e57613b1e613ae8565b039392505050565b600060208284031215613b3857600080fd5b8151610bf681613765565b60008219821115613b5657613b56613ae8565b500190565b60005b83811015613b76578181015183820152602001613b5e565b83811115610e605750506000910152565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613bbf816017850160208801613b5b565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613bf0816028840160208801613b5b565b01602801949350505050565b6020815260008251806020840152613c1b816040850160208701613b5b565b601f01601f19169190910160400192915050565b600082821015613c4157613c41613ae8565b500390565b6000808335601e19843603018112613c5d57600080fd5b8301803591506001600160401b03821115613c7757600080fd5b6020019150600581901b36038213156138c157600080fd5b600060208284031215613ca157600080fd5b8135610bf6816138fe565b6000816000190483118215151615613cc657613cc6613ae8565b500290565b6000602080835261012083018451828501528185015160408501526040850151606085015260608501516080850152608085015160a085015260a085015160c085015260c085015160e085015260e0850151610100808187015250818151808452610140870191508483019350600092505b80831015613d5d5783518252928401926001929092019190840190613d3d565b509695505050505050565b6000808335601e19843603018112613d7f57600080fd5b8301803591506001600160401b03821115613d9957600080fd5b6020019150368190038213156138c157600080fd5b848152836020820152606060408201526000613dce606083018486613961565b9695505050505050565b60008060408385031215613deb57600080fd5b505080516020909101519092909150565b600080600060608486031215613e1157600080fd5b8351925060208401519150604084015190509250925092565b600060208284031215613e3c57600080fd5b5051919050565b634e487b7160e01b600052600160045260246000fd5b634e487b7160e01b600052604160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b600081613e9457613e94613ae8565b506000190190565b600060208284031215613eae57600080fd5b8151610bf6816138fe565b604081526000613ecd6040830186886138c8565b8281036020840152613ee08185876138c8565b979650505050505050565b600082613f0857634e487b7160e01b600052601260045260246000fd5b500490565b858152606060208201526000613f27606083018688613961565b8281036040840152613f3a818587613961565b98975050505050505050565b634e487b7160e01b600052603160045260246000fdfe9d565e483b8608dc09e04eff85533859683d2eeaa6ebc28af53a92d7dba3eea6f9f2bb418c2b91bec33476bd883cf719692d3c9eed6e03bb161098abe08fa63ef9f2bb418c2b91bec33476bd883cf719692d3c9eed6e03bb161098abe08fa63ff9f2bb418c2b91bec33476bd883cf719692d3c9eed6e03bb161098abe08fa63db0e01b719c2c32a677822ce1584cb6a66e576ee3c2c506b9621dbe626355aa658f8c450dae5029cd48cd91dd9db65da48fb742893edfc7941250f6721d93cbbe9a627a5d4aa7c17f87ff26e3fe9a42c2b6c559e8b41a42282d0ecebb17c0e4d3c9bdcd6eb2e956ecf03d8d27bee4c163f9b5c078aa69020d618e76513b5d0a949d565e483b8608dc09e04eff85533859683d2eeaa6ebc28af53a92d7dba3eea72767d6892477f8d2750fb44e817c9aed93d34d3c6be4101ed58bcac692c99e9ca2646970667358221220a6ab491ead1e6635f35943b81329b31ea56b01e8c1559ee6dc81b4da0024bf8b64736f6c63430008090033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea291980000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000067d81118
-----Decoded View---------------
Arg [0] : lidoLocator (address): 0xD7c1B80fA86965B48cCA3aDcCB08E1DAEa291980
Arg [1] : secondsPerSlot (uint256): 12
Arg [2] : genesisTime (uint256): 1742213400
-----Encoded View---------------
3 Constructor Arguments found :
Arg [0] : 000000000000000000000000d7c1b80fa86965b48cca3adccb08e1daea291980
Arg [1] : 000000000000000000000000000000000000000000000000000000000000000c
Arg [2] : 0000000000000000000000000000000000000000000000000000000067d81118
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.