IIFtsoManager#

event AccruingUnearnedRewardsFailed(
    uint256 epochId
)

Unexpected failure while accruing unearned rewards. This should be a rare occurrence.

event ChillingNonrevealingDataProvidersFailed(
)

Unexpected failure. This should be a rare occurrence.

event CleanupBlockNumberManagerFailedForBlock(
    uint256 blockNumber
)

Unexpected failure. This should be a rare occurrence.

event ClosingExpiredRewardEpochFailed(
    uint256 rewardEpoch
)

Unexpected failure. This should be a rare occurrence.

event DistributingRewardsFailed(
    address ftso,
    uint256 epochId
)

Unexpected failure while distributing rewards. This should be a rare occurrence.

event FallbackMode(
    bool fallbackMode
)

Emitted when the fallback mode of the FTSO manager changes its state. Fallback mode is a recovery mode, where only data from a trusted subset of FTSO data providers is used to calculate the final price.

The FTSO Manager enters the fallback mode when ALL FTSOs are in fallback mode.

event FinalizingPriceEpochFailed(
    contract IIFtso ftso,
    uint256 epochId,
    enum IFtso.PriceFinalizationType failingType
)

Unexpected failure while finalizing a price epoch. This should be a rare occurrence.

event FtsoAdded(
    contract IIFtso ftso,
    bool add
)

Emitted when a new FTSO has been added or an existing one has been removed.

event FtsoDeactivationFailed(
    contract IIFtso ftso
)

Unexpected failure. This should be a rare occurrence.

event FtsoFallbackMode(
    contract IIFtso ftso,
    bool fallbackMode
)

Emitted when the fallback mode of an FTSO changes its state.

event InitializingCurrentEpochStateForRevealFailed(
    contract IIFtso ftso,
    uint256 epochId
)

Unexpected failure while initializing a price epoch. This should be a rare occurrence.

event PriceEpochFinalized(
    address chosenFtso,
    uint256 rewardEpochId
)

Emitted when a price epoch ends, this is, after the reveal phase, when final prices are calculated.

event RewardEpochFinalized(
    uint256 votepowerBlock,
    uint256 startBlock
)

Emitted when a reward epoch ends and rewards are available.

event UpdatingActiveValidatorsTriggerFailed(
    uint256 rewardEpoch
)

Unexpected failure. This should be a rare occurrence.

event UseGoodRandomSet(
    bool useGoodRandom,
    uint256 maxWaitForGoodRandomSeconds
)

Emitted when the requirement to provide good random numbers has changed.

As part of the FTSO protocol, data providers must submit a random number along with their price reveals. When good random numbers are enforced, all providers that submit a hash must then submit a reveal with a random number or they will be punished. This is a measure against random number manipulation.

function activate(
) external;

Activates FTSO manager (daemonize will run jobs).

function active(
) external view returns (
    bool);

Returns whether the FTSO Manager is active or not.

function addFtso(
    contract IIFtso _ftso
) external;

Adds FTSO to the list of managed FTSOs, to support a new price pair. All FTSOs in a multi-asset FTSO must be managed by the same FTSO manager.

function addFtsosBulk(
    contract IIFtso[] _ftsos
) external;

Adds a list of FTSOs to the list of managed FTSOs, to support new price pairs. All FTSOs in a multi-asset FTSO must be managed by the same FTSO manager.

function currentRewardEpochEnds(
) external view returns (
    uint256);

Returns when the current reward epoch finishes.

function daemonize(
) external returns (
    bool);

Implement this function to receive a trigger from the FlareDaemon. The trigger method is called by the validator right at the end of block state transition.

function getContractName(
) external view returns (
    string);

Implement this function to allow updating daemonized contracts through the AddressUpdater.

function getCurrentPriceEpochData(
) external view returns (
    uint256 _priceEpochId,
    uint256 _priceEpochStartTimestamp,
    uint256 _priceEpochEndTimestamp,
    uint256 _priceEpochRevealEndTimestamp,
    uint256 _currentTimestamp);

Returns timing information for the current price epoch. All intervals are half-closed: end time is not included. All timestamps are in seconds since UNIX epoch.

See the FTSO page for information about the different submission phases.

function getCurrentPriceEpochId(
) external view returns (
    uint256 _priceEpochId);

Returns current price epoch ID.

function getCurrentRewardEpoch(
) external view returns (
    uint256);

Returns current reward epoch ID (the one currently running).

function getElasticBandWidthPPMFtso(
    contract IIFtso _ftso
) external view returns (
    uint256);

Returns the secondary band's width in PPM (parts-per-million) of the median value, for a given FTSO.

function getFallbackMode(
) external view returns (
    bool _fallbackMode,
    contract IIFtso[] _ftsos,
    bool[] _ftsoInFallbackMode);

Returns whether the FTSO Manager is currently in fallback mode.

In this mode only submissions from trusted providers are used.

function getFtsos(
) external view returns (
    contract IIFtso[] _ftsos);

Returns the list of currently active FTSOs.

function getLastUnprocessedPriceEpochData(
) external view returns (
    uint256 _lastUnprocessedPriceEpoch,
    uint256 _lastUnprocessedPriceEpochRevealEnds,
    bool _lastUnprocessedPriceEpochInitialized);

Returns information regarding the currently unprocessed price epoch. This epoch is not necessarily the last one, in case the network halts for some time due to validator node problems, for example.

function getPriceEpochConfiguration(
) external view returns (
    uint256 _firstPriceEpochStartTs,
    uint256 _priceEpochDurationSeconds,
    uint256 _revealEpochDurationSeconds);

Returns the current values for price epoch timing configuration.

See the FTSO page for information about the different submission phases.

function getRewardEpochConfiguration(
) external view returns (
    uint256 _firstRewardEpochStartTs,
    uint256 _rewardEpochDurationSeconds);

Returns the current values for reward epoch timing configuration.

See the Reward epochs box.

function getRewardEpochData(
    uint256 _rewardEpochId
) external view returns (
    struct IIFtsoManager.RewardEpochData);

Returns data regarding a specific reward epoch ID.

function getRewardEpochToExpireNext(
) external view returns (
    uint256);

Return reward epoch that will expire next, when a new reward epoch is initialized.

Reward epochs older than 90 days expire, and any unclaimed rewards in them become inaccessible.

function getRewardEpochVotePowerBlock(
    uint256 _rewardEpoch
) external view returns (
    uint256);

Returns the vote power block that was used for a past reward epoch.

function getRewardExpiryOffsetSeconds(
) external view returns (
    uint256);

Returns the currently configured reward expiration time.

function notInitializedFtsos(
    contract IIFtso
) external view returns (
    bool);

Returns whether an FTSO has been initialized.

function removeFtso(
    contract IIFtso _ftso
) external;

Removes an FTSO from the list of managed FTSOs. Reverts if FTSO is used in a multi-asset FTSO. Deactivates the _ftso.

function replaceFtso(
    contract IIFtso _ftsoToAdd,
    bool copyCurrentPrice,
    bool copyAssetOrAssetFtsos
) external;

Replaces one FTSO with another with the same symbol. All FTSOs in a multi-asset FTSO must be managed by the same FTSO manager. Deactivates the old FTSO.

function replaceFtsosBulk(
    contract IIFtso[] _ftsosToAdd,
    bool copyCurrentPrice,
    bool copyAssetOrAssetFtsos
) external;

Replaces a list of FTSOs with other FTSOs with the same symbol. All FTSOs in a multi-asset FTSO must be managed by the same FTSO manager. Deactivates the old FTSOs.

function rewardEpochDurationSeconds(
) external view returns (
    uint256);

Currently configured reward epoch duration.

function rewardEpochs(
    uint256 _rewardEpochId
) external view returns (
    uint256 _votepowerBlock,
    uint256 _startBlock,
    uint256 _startTimestamp);

Returns information about a reward epoch.

function rewardEpochsStartTs(
) external view returns (
    uint256);

Time when the current reward epoch started.

function setFallbackMode(
    bool _fallbackMode
) external;

Sets whether the FTSO Manager is currently in fallback mode. In this mode only submissions from trusted providers are used.

function setFtsoAsset(
    contract IIFtso _ftso,
    contract IIVPToken _asset
) external;

Sets the asset tracked by an FTSO.

function setFtsoAssetFtsos(
    contract IIFtso _ftso,
    contract IIFtso[] _assetFtsos
) external;

Sets an array of FTSOs to be tracked by a multi-asset FTSO. FTSOs implicitly determine the FTSO assets.

function setFtsoFallbackMode(
    contract IIFtso _ftso,
    bool _fallbackMode
) external;

Sets whether an FTSO is currently in fallback mode. In this mode only submissions from trusted providers are used.

function setGovernanceParameters(
    uint256 _updateTs,
    uint256 _maxVotePowerNatThresholdFraction,
    uint256 _maxVotePowerAssetThresholdFraction,
    uint256 _lowAssetUSDThreshold,
    uint256 _highAssetUSDThreshold,
    uint256 _highAssetTurnoutThresholdBIPS,
    uint256 _lowNatTurnoutThresholdBIPS,
    uint256 _elasticBandRewardBIPS,
    uint256 _rewardExpiryOffsetSeconds,
    address[] _trustedAddresses
) external;

Sets governance parameters for FTSOs

function setInitialRewardData(
    uint256 _nextRewardEpochToExpire,
    uint256 _rewardEpochsLength,
    uint256 _currentRewardEpochEnds
) external;

Set reward data to values from old ftso manager. Can only be called before activation.

function switchToFallbackMode(
) external returns (
    bool);

This function will be called after an error is caught in daemonize. It will switch the contract to a simpler fallback mode, which hopefully works when full mode doesn't. Not every contract needs to support fallback mode (FtsoManager does), so this method may be empty. Switching back to normal mode is left to the contract (typically a governed method call). This function may be called due to low-gas error, so it shouldn't use more than ~30.000 gas.