Skip to main content

CSFeeOracle

CSFeeOracle.sol is a utility contract responsible for the execution of the CSM Oracle report once the consensus is reached in the HashConsensus.sol contract, namely, transforming non-distributed rewards to non-claimed rewards stored on the CSFeeDistributor.sol and reporting the latest root of rewards distribution Merkle tree to the CSFeeDistributor.sol. Alongside rewards distribution, a contract manages strikes data delivery to the CSStrikes.sol. A contract is Inherited from the BaseOracle.sol from Lido on Ethereum (LoE) core.

Changes in v2:

  • Added strikes reporting support;

Upgradability​

The contract uses OssifiableProxy for upgradability.

State Variables​

SUBMIT_DATA_ROLE​

An ACL role granting the permission to submit the data for a committee report.

bytes32 public constant SUBMIT_DATA_ROLE = keccak256("SUBMIT_DATA_ROLE");

PAUSE_ROLE​

An ACL role granting the permission to pause accepting oracle reports

bytes32 public constant PAUSE_ROLE = keccak256("PAUSE_ROLE");

RESUME_ROLE​

An ACL role granting the permission to resume accepting oracle reports

bytes32 public constant RESUME_ROLE = keccak256("RESUME_ROLE");

RECOVERER_ROLE​

An ACL role granting the permission to recover assets

bytes32 public constant RECOVERER_ROLE = keccak256("RECOVERER_ROLE");

FEE_DISTRIBUTOR​

ICSFeeDistributor public immutable FEE_DISTRIBUTOR;

STRIKES​

ICSStrikes public immutable STRIKES;

MANAGE_CONSENSUS_CONTRACT_ROLE​

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");

MANAGE_CONSENSUS_VERSION_ROLE​

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");

SECONDS_PER_SLOT​

uint256 public immutable SECONDS_PER_SLOT;

GENESIS_TIME​

uint256 public immutable GENESIS_TIME;

Functions​

resume​

Resume accepting oracle reports

function resume() external onlyRole(RESUME_ROLE);

pauseFor​

Pause accepting oracle reports for a duration seconds

function pauseFor(uint256 duration) external onlyRole(PAUSE_ROLE);

Parameters

NameTypeDescription
durationuint256Duration of the pause in seconds

submitReportData​

Submit the data for a committee report

function submitReportData(ReportData calldata data, uint256 contractVersion) external whenResumed;

Parameters

NameTypeDescription
dataReportDataData for a committee report
contractVersionuint256Version of the oracle consensus rules

getConsensusContract​

Returns the address of the HashConsensus contract.

function getConsensusContract() external view returns (address);

setConsensusContract​

Sets the address of the HashConsensus contract.

function setConsensusContract(address addr) external onlyRole(MANAGE_CONSENSUS_CONTRACT_ROLE);

getConsensusVersion​

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);

setConsensusVersion​

Sets the consensus version expected by the oracle contract.

function setConsensusVersion(uint256 version) external onlyRole(MANAGE_CONSENSUS_VERSION_ROLE);

getConsensusReport​

Data provider interface

Returns the last consensus report hash and metadata.

Zero hash means that either there have been no reports yet, or the report for refSlot was discarded.

function getConsensusReport()
    external
    view
    returns (bytes32 hash, uint256 refSlot, uint256 processingDeadlineTime, bool processingStarted);

submitConsensusReport​

Consensus contract interface

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;

discardConsensusReport​

Called by HashConsensus contract to notify that the report for the given ref. slot is not a consensus 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
  2. processing of the consensus report hasn't started yet; AND
  3. report processing deadline is not expired yet (enforced by HashConsensus); AND
  4. there's no consensus report now (otherwise, submitConsensusReport is called instead) (enforced by HashConsensus). 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;

getLastProcessingRefSlot​

Returns the last reference slot for which processing of the report was started.

function getLastProcessingRefSlot() external view returns (uint256);

Events​

ConsensusHashContractSet​

event ConsensusHashContractSet(address indexed addr, address indexed prevAddr);

ConsensusVersionSet​

event ConsensusVersionSet(uint256 indexed version, uint256 indexed prevVersion);

ReportSubmitted​

event ReportSubmitted(uint256 indexed refSlot, bytes32 hash, uint256 processingDeadlineTime);

ReportDiscarded​

event ReportDiscarded(uint256 indexed refSlot, bytes32 hash);

ProcessingStarted​

event ProcessingStarted(uint256 indexed refSlot, bytes32 hash);

WarnProcessingMissed​

event WarnProcessingMissed(uint256 indexed refSlot);