// SPDX-License-Identifier: MIT
pragma solidity >=0.7.6 <0.9;

import "../../IFlareSystemsManager.sol";

/**
 * FlareSystemsManager internal interface.
 */
interface IIFlareSystemsManager is IFlareSystemsManager {

    /// Event emitted when triggering voter registration fails.
    event TriggeringVoterRegistrationFailed(uint24 rewardEpochId);
    /// Event emitted when closing expired reward epoch fails.
    event ClosingExpiredRewardEpochFailed(uint24 rewardEpochId);
    /// Event emitted when setting clean-up block number fails.
    event SettingCleanUpBlockNumberFailed(uint64 blockNumber);

    /**
     * Uptime vote hash for given reward epoch id.
     */
    function uptimeVoteHash(uint256 _rewardEpochId) external view returns (bytes32);

    /**
     * Rewards hash for given reward epoch id.
     */
    function rewardsHash(uint256 _rewardEpochId) external view returns (bytes32);

    /**
     * Number of weight based claims for given reward epoch id and reward manager id.
     * @param _rewardEpochId Reward epoch id.
     * @param _rewardManagerId Reward manager id.
     */
    function noOfWeightBasedClaims(uint256 _rewardEpochId, uint256 _rewardManagerId) external view returns (uint256);

    /**
     * Number of weight based claims hash for given reward epoch id.
     * @param _rewardEpochId Reward epoch id.
     */
    function noOfWeightBasedClaimsHash(uint256 _rewardEpochId) external view returns (bytes32);

    /**
     * Maximum duration of random acquisition phase, in seconds.
     */
    function randomAcquisitionMaxDurationSeconds() external view returns (uint64);

    /**
     * Maximum duration of random acquisition phase, in blocks.
     */
    function randomAcquisitionMaxDurationBlocks() external view returns (uint64);

    /**
     * Time before reward epoch end when new signing policy initialization starts, in seconds.
     */
    function newSigningPolicyInitializationStartSeconds() external view returns (uint64);

    /**
     * Minimum delay before new signing policy can be active, in voting rounds.
     */
    function newSigningPolicyMinNumberOfVotingRoundsDelay() external view returns (uint32);

    /**
     * Reward epoch expiry offset, in seconds.
     */
    function rewardExpiryOffsetSeconds() external view returns (uint32);

    /**
     * Minimum duration of voter registration phase, in seconds.
     */
    function voterRegistrationMinDurationSeconds() external view returns (uint64);

    /**
     * Minimum duration of voter registration phase, in blocks.
     */
    function voterRegistrationMinDurationBlocks() external view returns (uint64);

    /**
     * Minimum duration of submit uptime vote phase, in seconds.
     */
    function submitUptimeVoteMinDurationSeconds() external view returns (uint64);

    /**
     * Minimum duration of submit uptime vote phase, in blocks.
     */
    function submitUptimeVoteMinDurationBlocks() external view returns (uint64);

    /**
     * Signing policy threshold, in parts per million.
     */
    function signingPolicyThresholdPPM() external view returns (uint24);

    /**
     * Minimum number of voters for signing policy.
     */
    function signingPolicyMinNumberOfVoters() external view returns (uint16);

    /**
     * Timestamp when current reward epoch should end, in seconds since UNIX epoch.
     */
    function currentRewardEpochExpectedEndTs() external view returns (uint64 _currentRewardEpochExpectedEndTs);

    /**
     * The last voting round id that was initialized.
     */
    function lastInitializedVotingRoundId() external view returns (uint32 _lastInitializedVotingRoundId);

    /**
     * The reward epoch id that will expire next.
     */
    function rewardEpochIdToExpireNext() external view returns (uint24 _rewardEpochIdToExpireNext);

    /**
     * Returns reward epoch start info.
     * @param _rewardEpochId Reward epoch id.
     * @return _rewardEpochStartTs Reward epoch start timestamp (0 if not started yet).
     * @return _rewardEpochStartBlock Reward epoch start block number (0 if not started yet).
     */
    function getRewardEpochStartInfo(uint24 _rewardEpochId)
        external view
        returns(
            uint64 _rewardEpochStartTs,
            uint64 _rewardEpochStartBlock
        );

    /**
     * Returns random acquisition info.
     * @param _rewardEpochId Reward epoch id.
     * @return _randomAcquisitionStartTs Random acquisition start timestamp (0 if not started yet).
     * @return _randomAcquisitionStartBlock Random acquisition start block number (0 if not started yet).
     * @return _randomAcquisitionEndTs Random acquisition end timestamp (0 if not ended yet).
     * @return _randomAcquisitionEndBlock Random acquisition end block number (0 if not ended yet).
     */
    function getRandomAcquisitionInfo(uint24 _rewardEpochId)
        external view
        returns(
            uint64 _randomAcquisitionStartTs,
            uint64 _randomAcquisitionStartBlock,
            uint64 _randomAcquisitionEndTs,
            uint64 _randomAcquisitionEndBlock
        );

    /**
     * Returns signing policy sign info for voter.
     * @param _rewardEpochId Reward epoch id.
     * @param _voter Voter address.
     * @return _signingPolicySignTs Timestamp when voter signed the signing policy (0 if not signed).
     * @return _signingPolicySignBlock Block number when voter signed the signing policy (0 if not signed).
     */
    function getVoterSigningPolicySignInfo(uint24 _rewardEpochId, address _voter)
        external view
        returns(
            uint64 _signingPolicySignTs,
            uint64 _signingPolicySignBlock
        );

    /**
     * Returns signing policy sign info.
     * @param _rewardEpochId Reward epoch id.
     * @return _signingPolicySignStartTs Signing policy sign start timestamp (0 if not started yet).
     * @return _signingPolicySignStartBlock Signing policy sign start block number (0 if not started yet).
     * @return _signingPolicySignEndTs Signing policy sign end timestamp (0 if not ended yet).
     * @return _signingPolicySignEndBlock Signing policy sign end block number (0 if not ended yet).
     */
    function getSigningPolicySignInfo(uint24 _rewardEpochId)
        external view
        returns(
            uint64 _signingPolicySignStartTs,
            uint64 _signingPolicySignStartBlock,
            uint64 _signingPolicySignEndTs,
            uint64 _signingPolicySignEndBlock
        );

    /**
     * Returns voter's submit uptime vote info.
     * @param _rewardEpochId Reward epoch id.
     * @param _voter Voter address.
     * @return _uptimeVoteSubmitTs Timestamp when voter submitted the uptime vote (0 if not submitted).
     * @return _uptimeVoteSubmitBlock Block number when voter submitted the uptime vote (0 if not submitted).
     */
    function getVoterUptimeVoteSubmitInfo(uint24 _rewardEpochId, address _voter)
        external view
        returns(
            uint64 _uptimeVoteSubmitTs,
            uint64 _uptimeVoteSubmitBlock
        );

    /**
     * Returns uptime vote sign info for voter.
     * @param _rewardEpochId Reward epoch id.
     * @param _voter Voter address.
     * @return _uptimeVoteSignTs Timestamp when voter signed the uptime vote (0 if not signed).
     * @return _uptimeVoteSignBlock Block number when voter signed the uptime vote (0 if not signed).
     */
    function getVoterUptimeVoteSignInfo(uint24 _rewardEpochId, address _voter)
        external view
        returns(
            uint64 _uptimeVoteSignTs,
            uint64 _uptimeVoteSignBlock
        );

    /**
     * Returns uptime vote sign start info.
     * @param _rewardEpochId Reward epoch id.
     * @return _uptimeVoteSignStartTs Uptime vote sign start timestamp (0 if not started yet).
     * @return _uptimeVoteSignStartBlock Uptime vote sign start block number (0 if not started yet).
     */
    function getUptimeVoteSignStartInfo(uint24 _rewardEpochId)
        external view
        returns(
            uint64 _uptimeVoteSignStartTs,
            uint64 _uptimeVoteSignStartBlock
        );

    /**
     * Returns rewards sign info for voter.
     * @param _rewardEpochId Reward epoch id.
     * @param _voter Voter address.
     * @return _rewardsSignTs Timestamp when voter signed the rewards (0 if not signed).
     * @return _rewardsSignBlock Block number when voter signed the rewards (0 if not signed).
     */
    function getVoterRewardsSignInfo(uint24 _rewardEpochId, address _voter)
        external view
        returns(
            uint64 _rewardsSignTs,
            uint64 _rewardsSignBlock
        );

    /**
     * Returns rewards sign info.
     * @param _rewardEpochId Reward epoch id.
     * @return _rewardsSignStartTs Rewards sign start timestamp (0 if not started yet).
     * @return _rewardsSignStartBlock Rewards sign start block number (0 if not started yet).
     * @return _rewardsSignEndTs Rewards sign end timestamp (0 if not ended yet).
     * @return _rewardsSignEndBlock Rewards sign end block number (0 if not ended yet).
     */
    function getRewardsSignInfo(uint24 _rewardEpochId)
        external view
        returns(
            uint64 _rewardsSignStartTs,
            uint64 _rewardsSignStartBlock,
            uint64 _rewardsSignEndTs,
            uint64 _rewardsSignEndBlock
        );
}