IVoterWhitelister
Interface for managers of the FTSO whitelist .
Only addresses registered in this contract can submit data to the FTSO system.
Events
VoterChilled
event VoterChilled (
address voter ,
uint256 untilRewardEpoch
)
Emitted when an account is chilled from the voter whitelist.
Parameters
Type
Description
voter
address
Address of the chilled account.
untilRewardEpoch
uint256
Epoch ID when the chill will be lifted.
VoterRemovedFromWhitelist
event VoterRemovedFromWhitelist (
address voter ,
uint256 ftsoIndex
)
Emitted when an account is removed from the voter whitelist.
Parameters
Type
Description
voter
address
Address of the removed account.
ftsoIndex
uint256
Index of the FTSO in which it was registered.
VoterWhitelisted
event VoterWhitelisted (
address voter ,
uint256 ftsoIndex
)
Emitted when an account is added to the voter whitelist.
Parameters
Type
Description
voter
address
Address of the added account.
ftsoIndex
uint256
Index of the FTSO to which it has been registered.
Functions
chilledUntilRewardEpoch
function chilledUntilRewardEpoch (
address _voter
) external view returns (
uint256 );
In case of providing bad prices (e.g. collusion), the voter can be chilled for a few reward epochs.
A voter can whitelist again from a returned reward epoch onwards.
Parameters
Type
Description
_voter
address
Address of the queried data provider.
Returns
Type
Description
[0]
uint256
uint256 ID of the epoch where the data provider can start submitting prices again.
defaultMaxVotersForFtso
function defaultMaxVotersForFtso (
) external view returns (
uint256 );
Maximum number of voters in the whitelist for a new FTSO.
Returns
Type
Description
[0]
uint256
uint256 Default maximum allowed voters.
getFtsoWhitelistedPriceProviders
function getFtsoWhitelistedPriceProviders (
uint256 _ftsoIndex
) external view returns (
address []);
Gets whitelisted price providers for the FTSO at a given index.
Parameters
Type
Description
_ftsoIndex
uint256
Queried index.
Returns
Type
Description
[0]
address[]
Array of addresses of the whitelisted data providers.
getFtsoWhitelistedPriceProvidersBySymbol
function getFtsoWhitelistedPriceProvidersBySymbol (
string _symbol
) external view returns (
address []);
Gets whitelisted price providers for the FTSO with a specified symbol.
Parameters
Type
Description
_symbol
string
Queried symbol.
Returns
Type
Description
[0]
address[]
Array of addresses of the whitelisted data providers.
maxVotersForFtso
function maxVotersForFtso (
uint256 _ftsoIndex
) external view returns (
uint256 );
Maximum number of voters in the whitelist for a specific FTSO.
Adjustable separately for each index.
Parameters
Type
Description
_ftsoIndex
uint256
Index of the FTSO.
Returns
Type
Description
[0]
uint256
uint256 Maximum allowed voters.
requestFullVoterWhitelisting
function requestFullVoterWhitelisting (
address _voter
) external returns (
uint256 [] _supportedIndices,
bool [] _success);
Requests whitelisting an account to act as a data provider for all active FTSOs.
May be called by any address, including the voter itself.
Parameters
Type
Description
_voter
address
Address of the voter to be whitelisted.
Returns
Type
Description
_supportedIndices
uint256[]
Array of currently supported FTSO indices.
_success
bool[]
Array of success flags by FTSO index.
requestWhitelistingVoter
function requestWhitelistingVoter (
address _voter ,
uint256 _ftsoIndex
) external ;
Requests whitelisting an account to act as a data provider for a specific FTSO.
Reverts if the vote power of the account is too low.
May be called by any address, including the voter itself.
Parameters
Type
Description
_voter
address
Address of the voter to be whitelisted.
_ftsoIndex
uint256
Index of the FTSO.