Warning! Contract bytecode has been changed and doesn't match the verified one. Therefore, interaction with this smart contract may be risky.
- Contract name:
- FtsoRewardManager
- Optimization enabled
- true
- Compiler version
- v0.7.6+commit.7338295f
- Optimization runs
- 200
- Verified at
- 2022-07-13T21:16:32.261723Z
Constructor Arguments
0000000000000000000000004598a6c05910ab914f0cbaaca1911cd337d10d29000000000000000000000000baf89d873d198ff78e72d2745b01cba3c6e5be6b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000007d0
Arg [0] (address) : 0x4598a6c05910ab914f0cbaaca1911cd337d10d29
Arg [1] (address) : 0xbaf89d873d198ff78e72d2745b01cba3c6e5be6b
Arg [2] (address) : 0x0000000000000000000000000000000000000000
Arg [3] (uint256) : 3
Arg [4] (uint256) : 2000
contracts/tokenPools/implementation/FtsoRewardManager.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "../interface/IIFtsoRewardManager.sol"; import "../lib/DataProviderFee.sol"; import "../../utils/implementation/AddressSet.sol"; import "../../addressUpdater/implementation/AddressUpdatable.sol"; import "../../ftso/interface/IIFtsoManager.sol"; import "../../governance/implementation/Governed.sol"; import "../../token/implementation/WNat.sol"; import "../../utils/implementation/SafePct.sol"; import "../../inflation/implementation/Supply.sol"; import "@openzeppelin/contracts/utils/ReentrancyGuard.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; /** * FTSORewardManager is in charge of: * - distributing rewards according to instructions from FTSO Manager * - allowing claims for rewards */ //solhint-disable-next-line max-states-count contract FtsoRewardManager is IIFtsoRewardManager, Governed, ReentrancyGuard, AddressUpdatable { using SafePct for uint256; using SafeMath for uint256; using DataProviderFee for DataProviderFee.State; using AddressSet for AddressSet.State; struct RewardClaim { // used for storing reward claim info bool claimed; // indicates if reward has been claimed uint256 amount; // amount claimed } struct RewardState { // used for local storage of reward state address[] dataProviders; // positional array of addresses representing data providers uint256[] weights; // positional array of numbers representing reward weights uint256[] amounts; // positional array of numbers representing reward amounts bool[] claimed; // positional array of booleans indicating if reward has already been claimed } string internal constant ERR_FTSO_MANAGER_ONLY = "ftso manager only"; string internal constant ERR_INFLATION_ONLY = "inflation only"; string internal constant ERR_OUT_OF_BALANCE = "out of balance"; string internal constant ERR_CLAIM_FAILED = "claim failed"; string internal constant ERR_REWARD_MANAGER_DEACTIVATED = "reward manager deactivated"; string internal constant ERR_AFTER_DAILY_CYCLE = "after daily cycle"; string internal constant ERR_NO_CLAIMABLE_EPOCH = "no epoch with claimable rewards"; string internal constant ERR_EXECUTOR_ONLY = "claim executor only"; string internal constant ERR_RECIPIENT_NOT_ALLOWED = "recipient not allowed"; string internal constant ERR_ALREADY_ENABLED = "already enabled"; uint256 constant internal MAX_BIPS = 1e4; uint256 constant internal ALMOST_SEVEN_FULL_DAYS_SEC = 7 days - 1; uint256 constant internal MAX_BURNABLE_PCT = 20; uint256 constant internal FIRST_CLAIMABLE_EPOCH = uint(-1); bool public override active; uint256 public override firstClaimableRewardEpoch; // first epochs will not be claimable - those epochs will // happen before the token generation event for Flare launch. // id of the first epoch to expire. Closed = expired and unclaimed funds sent back uint256 private nextRewardEpochToExpire; // reward epoch when setInitialRewardData is called (set to +1) - used for forwarding closeExpiredRewardEpoch uint256 private initialRewardEpoch; /** * @dev Provides a mapping of reward epoch ids to an address mapping of unclaimed rewards. */ mapping(uint256 => mapping(address => uint256)) private epochProviderUnclaimedRewardWeight; mapping(uint256 => mapping(address => uint256)) private epochProviderUnclaimedRewardAmount; mapping(uint256 => mapping(address => uint256)) private epochProviderVotePowerIgnoringRevocation; mapping(uint256 => mapping(address => uint256)) private epochProviderRewardAmount; mapping(uint256 => mapping(address => mapping(address => RewardClaim))) private epochProviderClaimerReward; mapping(uint256 => uint256) private totalRewardEpochRewards; mapping(uint256 => uint256) private claimedRewardEpochRewards; DataProviderFee.State private dataProviderFee; // mapping reward owner address => executor set mapping(address => AddressSet.State) private claimExecutorSet; // mapping reward owner address => claim recipient address mapping(address => AddressSet.State) private allowedClaimRecipientSet; // Totals uint256 private totalAwardedWei; // rewards that were distributed uint256 private totalClaimedWei; // rewards that were claimed in time uint256 private totalExpiredWei; // rewards that were not claimed in time and expired uint256 private totalUnearnedWei; // rewards that were unearned (ftso fallback) and thus not distributed uint256 private totalBurnedWei; // rewards that were unearned or expired and thus burned uint256 private totalInflationAuthorizedWei; uint256 private totalInflationReceivedWei; uint256 private totalSelfDestructReceivedWei; uint256 private lastInflationAuthorizationReceivedTs; uint256 private dailyAuthorizedInflation; uint256 private lastBalance; /// addresses IIFtsoManager public ftsoManager; address private inflation; WNat public wNat; Supply public supply; // for redeploy address public immutable oldFtsoRewardManager; address public newFtsoRewardManager; modifier mustBalance { _; _checkMustBalance(); } modifier onlyFtsoManager () { _checkOnlyFtsoManager(); _; } modifier onlyIfActive() { _checkOnlyActive(); _; } modifier onlyInflation { require(msg.sender == inflation, ERR_INFLATION_ONLY); _; } modifier onlyRewardExecutorAndAllowedRecipient(address _rewardOwner, address _recipient) { _checkExecutorAndAllowedRecipient(_rewardOwner, _recipient); _; } constructor( address _governance, address _addressUpdater, address _oldFtsoRewardManager, uint256 _feePercentageUpdateOffset, uint256 _defaultFeePercentage ) Governed(_governance) AddressUpdatable(_addressUpdater) { oldFtsoRewardManager = _oldFtsoRewardManager; dataProviderFee.feePercentageUpdateOffset = _feePercentageUpdateOffset; dataProviderFee.defaultFeePercentage = _defaultFeePercentage; firstClaimableRewardEpoch = FIRST_CLAIMABLE_EPOCH; } /** * @notice Allows a percentage delegator to claim rewards. * @notice This function is intended to be used to claim rewards in case of delegation by percentage. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function claimReward( address payable _recipient, uint256[] memory _rewardEpochs ) external override onlyIfActive mustBalance nonReentrant returns (uint256 _rewardAmount) { _rewardAmount = _claimOrWrapReward(msg.sender, _recipient, _rewardEpochs, false); } /** * @notice Allows a percentage delegator to claim and wrap rewards. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by percentage. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function claimAndWrapReward( address payable _recipient, uint256[] memory _rewardEpochs ) external override onlyIfActive mustBalance nonReentrant returns (uint256 _rewardAmount) { _rewardAmount = _claimOrWrapReward(msg.sender, _recipient, _rewardEpochs, true); } /** * @notice Allows a percentage delegator to claim and wrap rewards. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by percentage. * @notice The caller does not have to be the owner, but must be approved by the owner to claim on his behalf. * this approval is done by calling `addClaimExecutor`. * @notice It is actually safe for this to be called by anybody (nothing can be stolen), but by limiting who can * call, we allow the owner to control the timing of the calls. * @param _rewardOwner address of the reward owner * @param _recipient address of the recipient; must be either _rewardOwner or one of the addresses * allowed by the _rewardOwner * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function claimAndWrapRewardByExecutor( address _rewardOwner, address payable _recipient, uint256[] memory _rewardEpochs ) external override onlyIfActive mustBalance nonReentrant onlyRewardExecutorAndAllowedRecipient(_rewardOwner, _recipient) returns (uint256 _rewardAmount) { _rewardAmount = _claimOrWrapReward(_rewardOwner, _recipient, _rewardEpochs, true); } /** * @notice Allows the sender to claim rewards from specified data providers. * @notice This function is intended to be used to claim rewards in case of delegation by amount. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function claimRewardFromDataProviders( address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders ) external override onlyIfActive mustBalance nonReentrant returns (uint256 _rewardAmount) { _rewardAmount = _claimOrWrapRewardFromDataProviders(msg.sender, _recipient, _rewardEpochs, _dataProviders, false); } /** * @notice Allows the sender to claim and wrap rewards from specified data providers. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by amount. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function claimAndWrapRewardFromDataProviders( address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders ) external override onlyIfActive mustBalance nonReentrant returns (uint256 _rewardAmount) { _rewardAmount = _claimOrWrapRewardFromDataProviders(msg.sender, _recipient, _rewardEpochs, _dataProviders, true); } /** * @notice Allows the sender to claim and wrap rewards from specified data providers. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by amount. * @notice The caller does not have to be the owner, but must be approved by the owner to claim on his behalf. * this approval is done by calling `addClaimExecutor`. * @notice It is actually safe for this to be called by anybody (nothing can be stolen), but by limiting who can * call, we allow the owner to control the timing of the calls. * @param _rewardOwner address of the reward owner * @param _recipient address of the recipient; must be either _rewardOwner or one of the addresses * allowed by the _rewardOwner * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function claimAndWrapRewardFromDataProvidersByExecutor( address _rewardOwner, address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders ) external override onlyIfActive mustBalance nonReentrant onlyRewardExecutorAndAllowedRecipient(_rewardOwner, _recipient) returns (uint256 _rewardAmount) { _rewardAmount = _claimOrWrapRewardFromDataProviders(_rewardOwner, _recipient, _rewardEpochs, _dataProviders, true); } /** * Set the addresses of executors, who are allowed to call claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. * @param _executors The new executors. All old executors will be deleted and replaced by these. */ function setClaimExecutors(address[] memory _executors) external override { claimExecutorSet[msg.sender].replaceAll(_executors); emit ClaimExecutorsChanged(msg.sender, _executors); } /** * Set the addresses of allowed recipients in the methods claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. * Apart from these, the reward owner is always an allowed recipient. * @param _recipients The new allowed recipients. All old recipients will be deleted and replaced by these. */ function setAllowedClaimRecipients(address[] memory _recipients) external override { allowedClaimRecipientSet[msg.sender].replaceAll(_recipients); emit AllowedClaimRecipientsChanged(msg.sender, _recipients); } /** * @notice Activates reward manager (allows claiming rewards) */ function activate() external override onlyImmediateGovernance { require(inflation != address(0) && address(ftsoManager) != address(0) && address(wNat) != address(0) && address(supply) != address(0), "contract addresses not set"); active = true; } /** * @notice Enable claiming for current and all future reward epochs */ function enableClaims() external override onlyImmediateGovernance { require (firstClaimableRewardEpoch == FIRST_CLAIMABLE_EPOCH, ERR_ALREADY_ENABLED); firstClaimableRewardEpoch = getCurrentRewardEpoch(); emit RewardClaimsEnabled(firstClaimableRewardEpoch); } /** * @notice Deactivates reward manager (prevents claiming rewards) */ function deactivate() external override onlyImmediateGovernance { active = false; } function setDailyAuthorizedInflation(uint256 _toAuthorizeWei) external override onlyInflation { dailyAuthorizedInflation = _toAuthorizeWei; totalInflationAuthorizedWei = totalInflationAuthorizedWei.add(_toAuthorizeWei); lastInflationAuthorizationReceivedTs = block.timestamp; emit DailyAuthorizedInflationSet(_toAuthorizeWei); } function receiveInflation() external payable override mustBalance onlyInflation { (uint256 currentBalance, ) = _handleSelfDestructProceeds(); totalInflationReceivedWei = totalInflationReceivedWei.add(msg.value); lastBalance = currentBalance; // If there are accrued rewards pending to burn, do so... _burnUnearnedRewards(); emit InflationReceived(msg.value); } /** * @notice Accrue unearned rewards for price epoch. * @dev Typically done when ftso in fallback or because of insufficient vote power. * Simply accrue them so they will not distribute and burn them later. */ function accrueUnearnedRewards( uint256 _epochId, uint256 _priceEpochDurationSeconds, uint256 _priceEpochEndTime // end time included in epoch ) external override onlyFtsoManager { uint256 totalPriceEpochReward = _getTotalPriceEpochRewardWei(_priceEpochDurationSeconds, _priceEpochEndTime); totalUnearnedWei = totalUnearnedWei.add(totalPriceEpochReward); emit UnearnedRewardsAccrued(_epochId, totalPriceEpochReward); } /** * @notice Distributes rewards to data providers accounts, according to input parameters. * @dev must be called with totalWeight > 0 and addresses.length > 0 */ function distributeRewards( address[] memory _addresses, uint256[] memory _weights, uint256 _totalWeight, uint256 _epochId, address _ftso, uint256 _priceEpochDurationSeconds, uint256 _currentRewardEpoch, uint256 _priceEpochEndTime, // end time included in epoch uint256 _votePowerBlock ) external override onlyFtsoManager { // FTSO manager should never call with bad values. assert (_totalWeight != 0 && _addresses.length != 0); uint256 totalPriceEpochReward = _getTotalPriceEpochRewardWei(_priceEpochDurationSeconds, _priceEpochEndTime); uint256[] memory rewards = new uint256[](_addresses.length); rewards[0] = totalPriceEpochReward; _weights[0] = _totalWeight; uint256 i = _addresses.length - 1; while (true) { rewards[i] = rewards[0].mulDiv(_weights[i], _weights[0]); epochProviderUnclaimedRewardAmount[_currentRewardEpoch][_addresses[i]] += rewards[i]; epochProviderUnclaimedRewardWeight[_currentRewardEpoch][_addresses[i]] = wNat.votePowerOfAt(_addresses[i], _votePowerBlock).mul(MAX_BIPS); epochProviderRewardAmount[_currentRewardEpoch][_addresses[i]] += rewards[i]; if (epochProviderVotePowerIgnoringRevocation[_currentRewardEpoch][_addresses[i]] == 0) { epochProviderVotePowerIgnoringRevocation[_currentRewardEpoch][_addresses[i]] = wNat.votePowerOfAtIgnoringRevocation(_addresses[i], _votePowerBlock); } if (i == 0) { break; } rewards[0] -= rewards[i]; _weights[0] -= _weights[i]; i--; } totalRewardEpochRewards[_currentRewardEpoch] += totalPriceEpochReward; // Update total awarded with amount distributed totalAwardedWei = totalAwardedWei.add(totalPriceEpochReward); emit RewardsDistributed(_ftso, _epochId, _addresses, rewards); } /** * @notice Allows data provider to set (or update last) fee percentage. * @param _feePercentageBIPS number representing fee percentage in BIPS * @return Returns the reward epoch number when the setting becomes effective. */ function setDataProviderFeePercentage(uint256 _feePercentageBIPS) external override returns (uint256) { uint256 rewardEpoch = dataProviderFee.setDataProviderFeePercentage(_feePercentageBIPS, getCurrentRewardEpoch()); emit FeePercentageChanged(msg.sender, _feePercentageBIPS, rewardEpoch); return rewardEpoch; } /** * @notice Set initial reward data values - only if oldRewardManager is set * @dev Should be called at the time of switching to the new reward manager, can be called only once */ function setInitialRewardData() external onlyGovernance { require(!active && oldFtsoRewardManager != address(0) && initialRewardEpoch == 0 && nextRewardEpochToExpire == 0, "not initial state"); initialRewardEpoch = getCurrentRewardEpoch().add(1); // in order to distinguish from 0 nextRewardEpochToExpire = ftsoManager.getRewardEpochToExpireNext(); firstClaimableRewardEpoch = IIFtsoRewardManager(oldFtsoRewardManager).firstClaimableRewardEpoch(); } /** * @notice Sets new ftso reward manager which will take over closing expired reward epochs * @dev Should be called at the time of switching to the new reward manager, can be called only once */ function setNewFtsoRewardManager(address _newFtsoRewardManager) external onlyGovernance { require(newFtsoRewardManager == address(0), "new ftso reward manager already set"); newFtsoRewardManager = _newFtsoRewardManager; } /** * @notice Collects funds from expired reward epoch and totals. * @dev Triggered by ftsoManager on finalization of a reward epoch. * Operation is irreversible: when some reward epoch is closed according to current * settings of parameters, it cannot be reopened even if new parameters would * allow it since nextRewardEpochToExpire in ftsoManager never decreases. */ function closeExpiredRewardEpoch(uint256 _rewardEpoch) external override { require (msg.sender == address(ftsoManager) || msg.sender == newFtsoRewardManager, "only ftso manager or new ftso reward manager"); require(nextRewardEpochToExpire == _rewardEpoch, "wrong reward epoch id"); if (oldFtsoRewardManager != address(0) && _rewardEpoch < initialRewardEpoch) { IIFtsoRewardManager(oldFtsoRewardManager).closeExpiredRewardEpoch(_rewardEpoch); } uint256 expiredWei = totalRewardEpochRewards[_rewardEpoch] - claimedRewardEpochRewards[_rewardEpoch]; totalExpiredWei = totalExpiredWei.add(expiredWei); emit RewardClaimsExpired(_rewardEpoch); nextRewardEpochToExpire = _rewardEpoch + 1; } /** * @notice Returns information on epoch reward * @param _rewardEpoch reward epoch number * @return _totalReward number representing the total epoch reward * @return _claimedReward number representing the amount of total epoch reward that has been claimed */ function getEpochReward( uint256 _rewardEpoch ) external view override returns (uint256 _totalReward, uint256 _claimedReward) { _totalReward = totalRewardEpochRewards[_rewardEpoch]; _claimedReward = claimedRewardEpochRewards[_rewardEpoch]; } /** * @notice Returns the Inflation contract address. * @dev Inflation receivers must have a reference to Inflation in order to receive native tokens for claiming. * @return The inflation address */ function getInflationAddress() external view override returns(address) { return inflation; } /** * @notice Returns the state of rewards for `_beneficiary` at `_rewardEpoch` * @param _beneficiary address of reward beneficiary * @param _rewardEpoch reward epoch number * @return _dataProviders positional array of addresses representing data providers * @return _rewardAmounts positional array of reward amounts * @return _claimed positional array of boolean values indicating if reward is claimed * @return _claimable boolean value indicating if rewards are claimable * @dev Reverts when queried with `_beneficary` delegating by amount */ function getStateOfRewards( address _beneficiary, uint256 _rewardEpoch ) external view override returns ( address[] memory _dataProviders, uint256[] memory _rewardAmounts, bool[] memory _claimed, bool _claimable ) { uint256 currentRewardEpoch = getCurrentRewardEpoch(); _claimable = _isRewardClaimable(_rewardEpoch, currentRewardEpoch); if (_claimable || (_rewardEpoch == currentRewardEpoch && _rewardEpoch >= firstClaimableRewardEpoch)) { RewardState memory rewardState = _getStateOfRewards(_beneficiary, _rewardEpoch, false); _dataProviders = rewardState.dataProviders; _rewardAmounts = rewardState.amounts; _claimed = rewardState.claimed; } } /** * @notice Returns the state of rewards for `_beneficiary` at `_rewardEpoch` from `_dataProviders` * @param _beneficiary address of reward beneficiary * @param _rewardEpoch reward epoch number * @param _dataProviders positional array of addresses representing data providers * @return _rewardAmounts positional array of reward amounts * @return _claimed positional array of boolean values indicating if reward is claimed * @return _claimable boolean value indicating if rewards are claimable */ function getStateOfRewardsFromDataProviders( address _beneficiary, uint256 _rewardEpoch, address[] memory _dataProviders ) external view override returns ( uint256[] memory _rewardAmounts, bool[] memory _claimed, bool _claimable ) { uint256 currentRewardEpoch = getCurrentRewardEpoch(); _claimable = _isRewardClaimable(_rewardEpoch, currentRewardEpoch); if (_claimable || (_rewardEpoch == currentRewardEpoch && _rewardEpoch >= firstClaimableRewardEpoch)) { RewardState memory rewardState = _getStateOfRewardsFromDataProviders( _beneficiary, _rewardEpoch, _dataProviders, false ); _rewardAmounts = rewardState.amounts; _claimed = rewardState.claimed; } } /** * @notice Returns the start and the end of the reward epoch range for which the reward is claimable * @return _startEpochId the oldest epoch id that allows reward claiming * @return _endEpochId the newest epoch id that allows reward claiming */ function getEpochsWithClaimableRewards() external view override returns (uint256 _startEpochId, uint256 _endEpochId) { (_startEpochId, _endEpochId) = _getEpochsWithClaimableRewards(); } /** * @notice Returns the array of claimable epoch ids for which the reward has not yet been claimed * @param _beneficiary address of reward beneficiary * @return _epochIds array of epoch ids * @dev Reverts when queried with `_beneficary` delegating by amount */ function getEpochsWithUnclaimedRewards(address _beneficiary) external view override returns (uint256[] memory _epochIds) { (uint256 startId, uint256 endId) = _getEpochsWithClaimableRewards(); uint256 count = endId - startId + 1; bool[] memory unclaimed = new bool[](count); uint256 unclaimedCount = 0; for (uint256 i = 0; i < count; i++) { RewardState memory rewardState = _getStateOfRewards(_beneficiary, startId + i, true); for (uint256 j = 0; j < rewardState.claimed.length; j++) { if (!rewardState.claimed[j] && rewardState.amounts[j] > 0) { unclaimed[i] = true; unclaimedCount++; break; } } } _epochIds = new uint256[](unclaimedCount); uint256 index = 0; for (uint256 i = 0; i < count; i++) { if (unclaimed[i]) { _epochIds[index] = startId + i; index++; } } } /** * @notice Returns the information on unclaimed reward of `_dataProvider` for `_rewardEpoch` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing the data provider * @return _amount number representing the unclaimed amount * @return _weight number representing the share that has not yet been claimed */ function getUnclaimedReward( uint256 _rewardEpoch, address _dataProvider ) external view override returns (uint256 _amount, uint256 _weight) { _amount = epochProviderUnclaimedRewardAmount[_rewardEpoch][_dataProvider]; _weight = epochProviderUnclaimedRewardWeight[_rewardEpoch][_dataProvider]; } /** * @notice Returns the information on rewards and initial vote power of `_dataProvider` for `_rewardEpoch` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing the data provider * @return _rewardAmount number representing the amount of rewards * @return _votePowerIgnoringRevocation number representing the vote power ignoring revocations */ function getDataProviderPerformanceInfo( uint256 _rewardEpoch, address _dataProvider ) external view override returns (uint256 _rewardAmount, uint256 _votePowerIgnoringRevocation) { _rewardAmount = epochProviderRewardAmount[_rewardEpoch][_dataProvider]; _votePowerIgnoringRevocation = epochProviderVotePowerIgnoringRevocation[_rewardEpoch][_dataProvider]; } /** * @notice Returns the information on claimed reward of `_dataProvider` for `_rewardEpoch` by `_claimer` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing the data provider * @param _claimer address representing the claimer * @return _claimed boolean indicating if reward has been claimed * @return _amount number representing the claimed amount */ function getClaimedReward( uint256 _rewardEpoch, address _dataProvider, address _claimer ) external view override returns(bool _claimed, uint256 _amount) { RewardClaim storage rewardClaim = epochProviderClaimerReward[_rewardEpoch][_dataProvider][_claimer]; _claimed = rewardClaim.claimed; _amount = rewardClaim.amount; } /** * @notice Returns the current fee percentage of `_dataProvider` * @param _dataProvider address representing data provider */ function getDataProviderCurrentFeePercentage(address _dataProvider) external view override returns (uint256) { return dataProviderFee._getDataProviderFeePercentage(_dataProvider, getCurrentRewardEpoch()); } /** * @notice Returns the fee percentage of `_dataProvider` at `_rewardEpoch` * @param _dataProvider address representing data provider * @param _rewardEpoch reward epoch number */ function getDataProviderFeePercentage( address _dataProvider, uint256 _rewardEpoch ) external view override returns (uint256 _feePercentageBIPS) { require(getInitialRewardEpoch() <= _rewardEpoch && _rewardEpoch <= getCurrentRewardEpoch().add(dataProviderFee.feePercentageUpdateOffset), "invalid reward epoch"); return dataProviderFee._getDataProviderFeePercentage(_dataProvider, _rewardEpoch); } /** * @notice Returns the scheduled fee percentage changes of `_dataProvider` * @param _dataProvider address representing data provider * @return _feePercentageBIPS positional array of fee percentages in BIPS * @return _validFromEpoch positional array of block numbers the fee setings are effective from * @return _fixed positional array of boolean values indicating if settings are subjected to change */ function getDataProviderScheduledFeePercentageChanges( address _dataProvider ) external view override returns ( uint256[] memory _feePercentageBIPS, uint256[] memory _validFromEpoch, bool[] memory _fixed ) { return dataProviderFee.getDataProviderScheduledFeePercentageChanges(_dataProvider, getCurrentRewardEpoch()); } /** * @notice Return reward epoch that will expire, when new reward epoch is initialized * @return Reward epoch id that will expire next */ function getRewardEpochToExpireNext() external view override returns (uint256) { return nextRewardEpochToExpire; } /** * @notice Return token pool supply data * @return _lockedFundsWei Foundation locked funds (wei) * @return _totalInflationAuthorizedWei Total inflation authorized amount (wei) * @return _totalClaimedWei Total claimed amount (wei) */ function getTokenPoolSupplyData() external view override returns ( uint256 _lockedFundsWei, uint256 _totalInflationAuthorizedWei, uint256 _totalClaimedWei ) { return (0, totalInflationAuthorizedWei, totalClaimedWei.add(totalBurnedWei)); } function feePercentageUpdateOffset() external view returns (uint256) { return dataProviderFee.feePercentageUpdateOffset; } function defaultFeePercentage() external view returns (uint256) { return dataProviderFee.defaultFeePercentage; } function getTotals() external view returns ( uint256 _totalAwardedWei, uint256 _totalClaimedWei, uint256 _totalExpiredWei, uint256 _totalUnearnedWei, uint256 _totalBurnedWei, uint256 _totalInflationAuthorizedWei, uint256 _totalInflationReceivedWei, uint256 _totalSelfDestructReceivedWei, uint256 _lastInflationAuthorizationReceivedTs, uint256 _dailyAuthorizedInflation ) { return ( totalAwardedWei, totalClaimedWei, totalExpiredWei, totalUnearnedWei, totalBurnedWei, totalInflationAuthorizedWei, totalInflationReceivedWei, totalSelfDestructReceivedWei, lastInflationAuthorizationReceivedTs, dailyAuthorizedInflation ); } /** * Get the addresses of executors, who are allowed to call claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. */ function claimExecutors(address _rewardOwner) external view override returns (address[] memory) { return claimExecutorSet[_rewardOwner].list; } /** * Get the addresses of allowed recipients in the methods claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. * Apart from these, the reward owner is always an allowed recipient. */ function allowedClaimRecipients(address _rewardOwner) external view override returns (address[] memory) { return allowedClaimRecipientSet[_rewardOwner].list; } /** * @notice Implement this function for updating inflation receiver contracts through AddressUpdater. */ function getContractName() external pure override returns (string memory) { return "FtsoRewardManager"; } /** * @notice Return reward epoch vote power block * @param _rewardEpoch reward epoch number */ function getRewardEpochVotePowerBlock(uint256 _rewardEpoch) public view override returns (uint256) { return ftsoManager.getRewardEpochVotePowerBlock(_rewardEpoch); } /** * @notice Return current reward epoch number */ function getCurrentRewardEpoch() public view override returns (uint256) { return ftsoManager.getCurrentRewardEpoch(); } /** * @notice Return initial reward epoch number * @return _initialRewardEpoch initial reward epoch number */ function getInitialRewardEpoch() public view override returns (uint256 _initialRewardEpoch) { (, _initialRewardEpoch) = initialRewardEpoch.trySub(1); } function _handleSelfDestructProceeds() internal returns (uint256 _currentBalance, uint256 _expectedBalance) { _expectedBalance = lastBalance.add(msg.value); _currentBalance = address(this).balance; if (_currentBalance > _expectedBalance) { // Then assume extra were self-destruct proceeds totalSelfDestructReceivedWei = totalSelfDestructReceivedWei.add(_currentBalance).sub(_expectedBalance); } else if (_currentBalance < _expectedBalance) { // This is a coding error assert(false); } } /** * @notice Burn rewards if there are any pending to burn, up to the maximum allowable. * @dev This is meant to be called once per day, right after inflation is received. * There is a max allowable pct to burn so that the contract does not run out * of funds for rewarding. */ function _burnUnearnedRewards() internal { // Are there any rewards to burn? uint256 rewardsToBurnWei = totalUnearnedWei.add(totalExpiredWei).sub(totalBurnedWei); if (rewardsToBurnWei > 0) { // Calculate max rewards that can be burned uint256 maxToBurnWei = address(this).balance.mulDiv(MAX_BURNABLE_PCT, 100); uint256 toBurnWei = 0; // Calculate what we will burn if (rewardsToBurnWei > maxToBurnWei) { toBurnWei = maxToBurnWei; } else { toBurnWei = rewardsToBurnWei; } // Any to burn? if (toBurnWei > 0) { // Get the burn address; make it payable address payable burnAddress = payable(supply.burnAddress()); // Accumulate what we are about to burn totalBurnedWei = totalBurnedWei.add(toBurnWei); // Update lastBalance before transfer, to avoid reentrancy warning // (though there can not be any reentrancy due to transfer(0) or die() on known contract) lastBalance = lastBalance.sub(toBurnWei); // Burn //slither-disable-next-line arbitrary-send burnAddress.transfer(toBurnWei); // Emit event to signal what we did emit RewardsBurned(toBurnWei); } } } /** * @notice Allows a percentage delegator to claim rewards. * @notice This function is intended to be used to claim rewards in case of delegation by percentage. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function _claimOrWrapReward( address _rewardOwner, address payable _recipient, uint256[] memory _rewardEpochs, bool _wrap ) internal returns (uint256 _rewardAmount) { _handleSelfDestructProceeds(); uint256 currentRewardEpoch = getCurrentRewardEpoch(); for (uint256 i = 0; i < _rewardEpochs.length; i++) { if (!_isRewardClaimable(_rewardEpochs[i], currentRewardEpoch)) { continue; } RewardState memory rewardState = _getStateOfRewards(_rewardOwner, _rewardEpochs[i], true); uint256 amount = _claimReward(_rewardOwner, _recipient, _rewardEpochs[i], rewardState); claimedRewardEpochRewards[_rewardEpochs[i]] += amount; _rewardAmount += amount; } if (_wrap) { _sendWrappedRewardTo(_recipient, _rewardAmount); } else { _transferReward(_recipient, _rewardAmount); } //slither-disable-next-line reentrancy-eth // guarded by nonReentrant lastBalance = address(this).balance; } /** * @notice Allows the sender to claim the rewards from specified data providers. * @notice This function is intended to be used to claim rewards in case of delegation by amount. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @param _wrap should reward be wrapped immediatelly * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function _claimOrWrapRewardFromDataProviders( address _rewardOwner, address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders, bool _wrap ) internal returns (uint256 _rewardAmount) { _handleSelfDestructProceeds(); uint256 currentRewardEpoch = getCurrentRewardEpoch(); for (uint256 i = 0; i < _rewardEpochs.length; i++) { if (!_isRewardClaimable(_rewardEpochs[i], currentRewardEpoch)) { continue; } RewardState memory rewardState; rewardState = _getStateOfRewardsFromDataProviders(_rewardOwner, _rewardEpochs[i], _dataProviders, true); uint256 amount = _claimReward(_rewardOwner, _recipient, _rewardEpochs[i], rewardState); claimedRewardEpochRewards[_rewardEpochs[i]] += amount; _rewardAmount += amount; } if (_wrap) { _sendWrappedRewardTo(_recipient, _rewardAmount); } else { _transferReward(_recipient, _rewardAmount); } //slither-disable-next-line reentrancy-eth // guarded by nonReentrant lastBalance = address(this).balance; } /** * @notice Claims `_rewardAmounts` for `_dataProviders`. * @dev Internal function that takes care of reward bookkeeping * @param _recipient address representing the recipient of the reward * @param _rewardEpoch reward epoch number * @param _rewardState object holding reward state * @return Returns the total reward amount. */ function _claimReward( address _rewardOwner, address payable _recipient, uint256 _rewardEpoch, RewardState memory _rewardState ) internal returns (uint256) { uint256 totalRewardAmount = 0; for (uint256 i = 0; i < _rewardState.dataProviders.length; i++) { if (_rewardState.claimed[i]) { continue; } address dataProvider = _rewardState.dataProviders[i]; uint256 rewardWeight = _rewardState.weights[i]; if (rewardWeight > 0) { epochProviderUnclaimedRewardWeight[_rewardEpoch][dataProvider] -= rewardWeight; // can not underflow } uint256 rewardAmount = _rewardState.amounts[i]; if (rewardAmount > 0) { epochProviderUnclaimedRewardAmount[_rewardEpoch][dataProvider] -= rewardAmount; // can not underflow totalClaimedWei += rewardAmount; totalRewardAmount += rewardAmount; } RewardClaim storage rewardClaim = epochProviderClaimerReward[_rewardEpoch][dataProvider][_rewardOwner]; rewardClaim.claimed = true; rewardClaim.amount = rewardAmount; emit RewardClaimed({ dataProvider: dataProvider, whoClaimed: _rewardOwner, sentTo: _recipient, rewardEpoch: _rewardEpoch, amount: rewardAmount }); } return totalRewardAmount; } /** * @notice Transfers `_rewardAmount` to `_recipient`. * @param _recipient address representing the reward recipient * @param _rewardAmount number representing the amount to transfer * @dev Uses low level call to transfer funds. */ function _transferReward(address payable _recipient, uint256 _rewardAmount) internal { if (_rewardAmount > 0) { // transfer total amount (state is updated and events are emitted in _claimReward) /* solhint-disable avoid-low-level-calls */ //slither-disable-next-line arbitrary-send // amount always calculated by _claimReward (bool success, ) = _recipient.call{value: _rewardAmount}(""); /* solhint-enable avoid-low-level-calls */ require(success, ERR_CLAIM_FAILED); } } /** * @notice Wrap (deposit) `_rewardAmount` to `_recipient` on WNat. * @param _recipient address representing the reward recipient * @param _rewardAmount number representing the amount to transfer */ function _sendWrappedRewardTo(address payable _recipient, uint256 _rewardAmount) internal { if (_rewardAmount > 0) { // transfer total amount (state is updated and events are emitted in _claimReward) //slither-disable-next-line arbitrary-send // amount always calculated by _claimReward wNat.depositTo{value: _rewardAmount}(_recipient); } } /** * @notice Implementation of the AddressUpdatable abstract method. */ function _updateContractAddresses( bytes32[] memory _contractNameHashes, address[] memory _contractAddresses ) internal override { inflation = _getContractAddress(_contractNameHashes, _contractAddresses, "Inflation"); ftsoManager = IIFtsoManager(_getContractAddress(_contractNameHashes, _contractAddresses, "FtsoManager")); wNat = WNat(payable(_getContractAddress(_contractNameHashes, _contractAddresses, "WNat"))); supply = Supply(_getContractAddress(_contractNameHashes, _contractAddresses, "Supply")); } function _getDistributableFtsoInflationBalance() internal view returns (uint256) { return totalInflationAuthorizedWei .sub(totalAwardedWei) .sub(totalUnearnedWei); } function _getRemainingPriceEpochCount( uint256 _fromThisTs, uint256 _priceEpochDurationSeconds ) internal view returns (uint256) { // Get the end of the daily period uint256 dailyPeriodEndTs = lastInflationAuthorizationReceivedTs.add(ALMOST_SEVEN_FULL_DAYS_SEC); require(_fromThisTs <= dailyPeriodEndTs, ERR_AFTER_DAILY_CYCLE); return dailyPeriodEndTs.sub(_fromThisTs).div(_priceEpochDurationSeconds) + 1; } /** * @notice Returns the reward to distribute for a given price epoch. * @param _priceEpochDurationSeconds Number of seconds for a price epoch. * @param _priceEpochEndTime Datetime stamp of the end of the price epoch * @return Price epoch reward in wei * @dev Based on a daily distribution and period. */ function _getTotalPriceEpochRewardWei( uint256 _priceEpochDurationSeconds, uint256 _priceEpochEndTime // end time included in epoch ) internal view returns (uint256) { return _getDistributableFtsoInflationBalance() .div(_getRemainingPriceEpochCount(_priceEpochEndTime, _priceEpochDurationSeconds)); } /** * @notice Returns the state of rewards for `_beneficiary` at `_rewardEpoch`. * @dev Internal function * @param _beneficiary address of reward beneficiary * @param _rewardEpoch reward epoch number * @param _zeroForClaimed boolean value that enables skipping amount computation for claimed rewards * @return _rewardState object holding reward state * @dev Reverts when queried with `_beneficary` delegating by amount. */ function _getStateOfRewards( address _beneficiary, uint256 _rewardEpoch, bool _zeroForClaimed ) internal view returns (RewardState memory _rewardState) { uint256 votePowerBlock = getRewardEpochVotePowerBlock(_rewardEpoch); // setup for data provider reward bool dataProviderClaimed = _isRewardClaimed(_rewardEpoch, _beneficiary, _beneficiary); // gather data provider reward info uint256 dataProviderRewardWeight; RewardClaim memory dataProviderReward; if (dataProviderClaimed) { if (!_zeroForClaimed) { // weight is irrelevant dataProviderReward.amount = _getClaimedReward(_rewardEpoch, _beneficiary, _beneficiary); } } else { dataProviderRewardWeight = _getRewardWeightForDataProvider(_beneficiary, _rewardEpoch, votePowerBlock); dataProviderReward.amount = _getRewardAmount(_rewardEpoch, _beneficiary, dataProviderRewardWeight); } // flag if data is to be included dataProviderReward.claimed = dataProviderClaimed || dataProviderReward.amount > 0; // setup for delegation rewards address[] memory delegates; uint256[] memory bips; (delegates, bips, , ) = wNat.delegatesOfAt(_beneficiary, votePowerBlock); // reward state setup _rewardState.dataProviders = new address[]((dataProviderReward.claimed ? 1 : 0) + delegates.length); _rewardState.weights = new uint256[](_rewardState.dataProviders.length); _rewardState.amounts = new uint256[](_rewardState.dataProviders.length); _rewardState.claimed = new bool[](_rewardState.dataProviders.length); // data provider reward if (dataProviderReward.claimed) { _rewardState.dataProviders[0] = _beneficiary; _rewardState.claimed[0] = dataProviderClaimed; _rewardState.weights[0] = dataProviderRewardWeight; _rewardState.amounts[0] = dataProviderReward.amount; } // delegation rewards if (delegates.length > 0) { uint256 delegatorBalance = wNat.balanceOfAt(_beneficiary, votePowerBlock); for (uint256 i = 0; i < delegates.length; i++) { uint256 p = (dataProviderReward.claimed ? 1 : 0) + i; _rewardState.dataProviders[p] = delegates[i]; _rewardState.claimed[p] = _isRewardClaimed(_rewardEpoch, delegates[i], _beneficiary); if (_rewardState.claimed[p]) { if (!_zeroForClaimed) { // weight is irrelevant _rewardState.amounts[p] = _getClaimedReward(_rewardEpoch, delegates[i], _beneficiary); } } else { _rewardState.weights[p] = _getRewardWeightForDelegator( delegates[i], delegatorBalance.mulDiv(bips[i], MAX_BIPS), _rewardEpoch ); _rewardState.amounts[p] = _getRewardAmount( _rewardEpoch, delegates[i], _rewardState.weights[p] ); } } } } /** * @notice Returns the state of rewards for `_beneficiary` at `_rewardEpoch` from `_dataProviders` * @param _beneficiary address of reward beneficiary * @param _rewardEpoch reward epoch number * @param _dataProviders positional array of addresses representing data providers * @param _zeroForClaimed boolean value that enables skipping amount computation for claimed rewards * @return _rewardState object holding reward state */ function _getStateOfRewardsFromDataProviders( address _beneficiary, uint256 _rewardEpoch, address[] memory _dataProviders, bool _zeroForClaimed ) internal view returns (RewardState memory _rewardState) { uint256 votePowerBlock = getRewardEpochVotePowerBlock(_rewardEpoch); uint256 count = _dataProviders.length; _rewardState.dataProviders = _dataProviders; _rewardState.weights = new uint256[](count); _rewardState.amounts = new uint256[](count); _rewardState.claimed = new bool[](count); for (uint256 i = 0; i < count; i++) { _rewardState.claimed[i] = _isRewardClaimed(_rewardEpoch, _dataProviders[i], _beneficiary); if (_rewardState.claimed[i]) { if (!_zeroForClaimed) { // weight is irrelevant _rewardState.amounts[i] = _getClaimedReward(_rewardEpoch, _dataProviders[i], _beneficiary); } continue; } if (_dataProviders[i] == _beneficiary) { _rewardState.weights[i] = _getRewardWeightForDataProvider( _beneficiary, _rewardEpoch, votePowerBlock ); } else { uint256 delegatedVotePower = wNat.votePowerFromToAt(_beneficiary, _dataProviders[i], votePowerBlock); _rewardState.weights[i] = _getRewardWeightForDelegator( _dataProviders[i], delegatedVotePower, _rewardEpoch ); } _rewardState.amounts[i] = _getRewardAmount( _rewardEpoch, _dataProviders[i], _rewardState.weights[i] ); } } /** * @notice Reports if rewards for `_rewardEpoch` are claimable. * @param _rewardEpoch reward epoch number * @param _currentRewardEpoch number of the current reward epoch */ function _isRewardClaimable(uint256 _rewardEpoch, uint256 _currentRewardEpoch) internal view returns (bool) { if (_rewardEpoch < nextRewardEpochToExpire || _rewardEpoch >= _currentRewardEpoch || _rewardEpoch < firstClaimableRewardEpoch) { // reward expired and closed or current or future or before claming enabled return false; } return true; } /** * @notice Returns the start and the end of the reward epoch range for which the reward is claimable * @return _startEpochId the oldest epoch id that allows reward claiming * @return _endEpochId the newest epoch id that allows reward claiming */ function _getEpochsWithClaimableRewards() internal view returns ( uint256 _startEpochId, uint256 _endEpochId ) { _startEpochId = nextRewardEpochToExpire; uint256 currentRewardEpochId = getCurrentRewardEpoch(); require(currentRewardEpochId > 0, ERR_NO_CLAIMABLE_EPOCH); _endEpochId = currentRewardEpochId - 1; } /** * @notice Reports if reward at `_rewardEpoch` for `_dataProvider` has already been claimed by `_claimer`. * @param _rewardEpoch reward epoch number * @param _dataProvider address representing a data provider * @param _claimer address representing a reward claimer */ function _isRewardClaimed( uint256 _rewardEpoch, address _dataProvider, address _claimer ) internal view returns (bool) { return epochProviderClaimerReward[_rewardEpoch][_dataProvider][_claimer].claimed; } /** * @notice Returns the reward amount at `_rewardEpoch` for `_dataProvider` claimed by `_claimer`. * @param _rewardEpoch reward epoch number * @param _dataProvider address representing a data provider * @param _claimer address representing a reward claimer */ function _getClaimedReward( uint256 _rewardEpoch, address _dataProvider, address _claimer ) internal view returns (uint256) { return epochProviderClaimerReward[_rewardEpoch][_dataProvider][_claimer].amount; } /** * @notice Returns the reward amount for `_dataProvider` at `_rewardEpoch` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing a data provider * @param _rewardWeight number representing reward weight */ function _getRewardAmount( uint256 _rewardEpoch, address _dataProvider, uint256 _rewardWeight ) internal view returns (uint256) { if (_rewardWeight == 0) { return 0; } uint256 unclaimedRewardAmount = epochProviderUnclaimedRewardAmount[_rewardEpoch][_dataProvider]; if (unclaimedRewardAmount == 0) { return 0; } uint256 unclaimedRewardWeight = epochProviderUnclaimedRewardWeight[_rewardEpoch][_dataProvider]; if (_rewardWeight == unclaimedRewardWeight) { return unclaimedRewardAmount; } assert(_rewardWeight < unclaimedRewardWeight); return unclaimedRewardAmount.mulDiv(_rewardWeight, unclaimedRewardWeight); } /** * @notice Returns reward weight for `_dataProvider` at `_rewardEpoch` * @param _dataProvider address representing a data provider * @param _rewardEpoch reward epoch number * @param _votePowerBlock block number used to determine the vote power for reward computation */ function _getRewardWeightForDataProvider( address _dataProvider, uint256 _rewardEpoch, uint256 _votePowerBlock ) internal view returns (uint256) { uint256 dataProviderVotePower = wNat.undelegatedVotePowerOfAt(_dataProvider, _votePowerBlock); uint256 votePower = wNat.votePowerOfAt(_dataProvider, _votePowerBlock); if (dataProviderVotePower == votePower) { // shortcut, but also handles (unlikely) zero vote power case return votePower.mul(MAX_BIPS); } assert(votePower > dataProviderVotePower); uint256 rewardWeight = 0; // weight share based on data provider undelagated vote power if (dataProviderVotePower > 0) { rewardWeight += dataProviderVotePower.mul(MAX_BIPS); } // weight share based on data provider fee uint256 feePercentageBIPS = dataProviderFee._getDataProviderFeePercentage(_dataProvider, _rewardEpoch); if (feePercentageBIPS > 0) { rewardWeight += (votePower - dataProviderVotePower).mul(feePercentageBIPS); } return rewardWeight; } /** * @notice Returns reward weight at `_rewardEpoch` for delegator delegating `_delegatedVotePower` to `_delegate`. * @param _delegate address representing a delegate (data provider) * @param _delegatedVotePower number representing vote power delegated by delegator * @param _rewardEpoch reward epoch number */ function _getRewardWeightForDelegator( address _delegate, uint256 _delegatedVotePower, uint256 _rewardEpoch ) internal view returns (uint256) { if (_delegatedVotePower == 0) { return 0; } uint256 rewardWeight = 0; // reward weight determined by vote power share uint256 feePercentageBIPS = dataProviderFee._getDataProviderFeePercentage(_delegate, _rewardEpoch); if (feePercentageBIPS < MAX_BIPS) { rewardWeight += _delegatedVotePower.mul(MAX_BIPS - feePercentageBIPS); } return rewardWeight; } function _getExpectedBalance() private view returns(uint256 _balanceExpectedWei) { return totalInflationReceivedWei .add(totalSelfDestructReceivedWei) .sub(totalClaimedWei) .sub(totalBurnedWei); } function _checkExecutorAndAllowedRecipient(address _rewardOwner, address _recipient) private view { require(claimExecutorSet[_rewardOwner].index[msg.sender] != 0, ERR_EXECUTOR_ONLY); require(_recipient == _rewardOwner || allowedClaimRecipientSet[_rewardOwner].index[_recipient] != 0, ERR_RECIPIENT_NOT_ALLOWED); } function _checkMustBalance() private view { require(address(this).balance == _getExpectedBalance(), ERR_OUT_OF_BALANCE); } function _checkOnlyFtsoManager() private view { require (msg.sender == address(ftsoManager), ERR_FTSO_MANAGER_ONLY); } function _checkOnlyActive() private view { require(active, ERR_REWARD_MANAGER_DEACTIVATED); } }
contracts/token/interface/IICleanable.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IICleanable { /** * Set the contract that is allowed to call history cleaning methods. */ function setCleanerContract(address _cleanerContract) external; /** * Set the cleanup block number. * Historic data for the blocks before `cleanupBlockNumber` can be erased, * history before that block should never be used since it can be inconsistent. * In particular, cleanup block number must be before current vote power block. * @param _blockNumber The new cleanup block number. */ function setCleanupBlockNumber(uint256 _blockNumber) external; /** * Get the current cleanup block number. */ function cleanupBlockNumber() external view returns (uint256); }
contracts/token/implementation/CheckPointable.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "../lib/CheckPointHistory.sol"; import "../lib/CheckPointsByAddress.sol"; import "../lib/CheckPointHistoryCache.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; /** * @title Check Pointable ERC20 Behavior * @notice ERC20 behavior which adds balance check point features. **/ abstract contract CheckPointable { using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; using CheckPointsByAddress for CheckPointsByAddress.CheckPointsByAddressState; using CheckPointHistoryCache for CheckPointHistoryCache.CacheState; using SafeMath for uint256; // The number of history cleanup steps executed for every write operation. // It is more than 1 to make as certain as possible that all history gets cleaned eventually. uint256 private constant CLEANUP_COUNT = 2; // Private member variables CheckPointsByAddress.CheckPointsByAddressState private balanceHistory; CheckPointHistory.CheckPointHistoryState private totalSupply; CheckPointHistoryCache.CacheState private totalSupplyCache; // Historic data for the blocks before `cleanupBlockNumber` can be erased, // history before that block should never be used since it can be inconsistent. uint256 private cleanupBlockNumber; // Address of the contract that is allowed to call methods for history cleaning. address public cleanerContract; /** * Emitted when a total supply cache entry is created. * Allows history cleaners to track total supply cache cleanup opportunities off-chain. */ event CreatedTotalSupplyCache(uint256 _blockNumber); // Most cleanup opportunities can be deduced from standard event // Transfer(from, to, amount): // - balance history for `from` (if nonzero) and `to` (if nonzero) // - total supply history when either `from` or `to` is zero modifier notBeforeCleanupBlock(uint256 _blockNumber) { require(_blockNumber >= cleanupBlockNumber, "CheckPointable: reading from cleaned-up block"); _; } modifier onlyCleaner { require(msg.sender == cleanerContract, "Only cleaner contract"); _; } /** * @dev Queries the token balance of `_owner` at a specific `_blockNumber`. * @param _owner The address from which the balance will be retrieved. * @param _blockNumber The block number when the balance is queried. * @return _balance The balance at `_blockNumber`. **/ function balanceOfAt(address _owner, uint256 _blockNumber) public virtual view notBeforeCleanupBlock(_blockNumber) returns (uint256 _balance) { return balanceHistory.valueOfAt(_owner, _blockNumber); } /** * @notice Burn current token `amount` for `owner` of checkpoints at current block. * @param _owner The address of the owner to burn tokens. * @param _amount The amount to burn. */ function _burnForAtNow(address _owner, uint256 _amount) internal virtual { uint256 newBalance = balanceOfAt(_owner, block.number).sub(_amount, "Burn too big for owner"); balanceHistory.writeValue(_owner, newBalance); balanceHistory.cleanupOldCheckpoints(_owner, CLEANUP_COUNT, cleanupBlockNumber); totalSupply.writeValue(totalSupplyAt(block.number).sub(_amount, "Burn too big for total supply")); totalSupply.cleanupOldCheckpoints(CLEANUP_COUNT, cleanupBlockNumber); } /** * @notice Mint current token `amount` for `owner` of checkpoints at current block. * @param _owner The address of the owner to burn tokens. * @param _amount The amount to burn. */ function _mintForAtNow(address _owner, uint256 _amount) internal virtual { uint256 newBalance = balanceOfAt(_owner, block.number).add(_amount); balanceHistory.writeValue(_owner, newBalance); balanceHistory.cleanupOldCheckpoints(_owner, CLEANUP_COUNT, cleanupBlockNumber); totalSupply.writeValue(totalSupplyAt(block.number).add(_amount)); totalSupply.cleanupOldCheckpoints(CLEANUP_COUNT, cleanupBlockNumber); } /** * @notice Total amount of tokens at a specific `_blockNumber`. * @param _blockNumber The block number when the _totalSupply is queried * @return _totalSupply The total amount of tokens at `_blockNumber` **/ function totalSupplyAt(uint256 _blockNumber) public virtual view notBeforeCleanupBlock(_blockNumber) returns(uint256 _totalSupply) { return totalSupply.valueAt(_blockNumber); } /** * @notice Total amount of tokens at a specific `_blockNumber`. * @param _blockNumber The block number when the _totalSupply is queried * @return _totalSupply The total amount of tokens at `_blockNumber` **/ function _totalSupplyAtCached(uint256 _blockNumber) internal notBeforeCleanupBlock(_blockNumber) returns(uint256 _totalSupply) { // use cache only for the past (the value will never change) require(_blockNumber < block.number, "Can only be used for past blocks"); (uint256 value, bool cacheCreated) = totalSupplyCache.valueAt(totalSupply, _blockNumber); if (cacheCreated) emit CreatedTotalSupplyCache(_blockNumber); return value; } /** * @notice Transmit token `_amount` `_from` address `_to` address of checkpoints at current block. * @param _from The address of the sender. * @param _to The address of the receiver. * @param _amount The amount to transmit. */ function _transmitAtNow(address _from, address _to, uint256 _amount) internal virtual { balanceHistory.transmit(_from, _to, _amount); balanceHistory.cleanupOldCheckpoints(_from, CLEANUP_COUNT, cleanupBlockNumber); balanceHistory.cleanupOldCheckpoints(_to, CLEANUP_COUNT, cleanupBlockNumber); } /** * Set the cleanup block number. */ function _setCleanupBlockNumber(uint256 _blockNumber) internal { require(_blockNumber >= cleanupBlockNumber, "Cleanup block number must never decrease"); require(_blockNumber < block.number, "Cleanup block must be in the past"); cleanupBlockNumber = _blockNumber; } /** * Get the cleanup block number. */ function _cleanupBlockNumber() internal view returns (uint256) { return cleanupBlockNumber; } /** * @notice Update history at token transfer, the CheckPointable part of `_beforeTokenTransfer` hook. * @param _from The address of the sender. * @param _to The address of the receiver. * @param _amount The amount to transmit. */ function _updateBalanceHistoryAtTransfer(address _from, address _to, uint256 _amount) internal virtual { if (_from == address(0)) { // mint checkpoint balance data for transferee _mintForAtNow(_to, _amount); } else if (_to == address(0)) { // burn checkpoint data for transferer _burnForAtNow(_from, _amount); } else { // transfer checkpoint balance data _transmitAtNow(_from, _to, _amount); } } // history cleanup methods /** * Set the contract that is allowed to call history cleaning methods. */ function _setCleanerContract(address _cleanerContract) internal { cleanerContract = _cleanerContract; } /** * Delete balance checkpoints that expired (i.e. are before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _owner balance owner account address * @param _count maximum number of checkpoints to delete * @return the number of checkpoints deleted */ function balanceHistoryCleanup(address _owner, uint256 _count) external onlyCleaner returns (uint256) { return balanceHistory.cleanupOldCheckpoints(_owner, _count, cleanupBlockNumber); } /** * Delete total supply checkpoints that expired (i.e. are before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _count maximum number of checkpoints to delete * @return the number of checkpoints deleted */ function totalSupplyHistoryCleanup(uint256 _count) external onlyCleaner returns (uint256) { return totalSupply.cleanupOldCheckpoints(_count, cleanupBlockNumber); } /** * Delete total supply cache entry that expired (i.e. is before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _blockNumber the block number for which total supply value was cached * @return the number of cache entries deleted (always 0 or 1) */ function totalSupplyCacheCleanup(uint256 _blockNumber) external onlyCleaner returns (uint256) { require(_blockNumber < cleanupBlockNumber, "No cleanup after cleanup block"); return totalSupplyCache.deleteAt(_blockNumber); } }
contracts/token/lib/PercentageDelegation.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "./CheckPointHistory.sol"; import "./DelegationHistory.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; import "../../utils/implementation/SafePct.sol"; /** * @title PercentageDelegation library * @notice Only handles percentage delegation * @notice A library to manage a group of _delegates for allocating voting power by a delegator. **/ library PercentageDelegation { using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; using DelegationHistory for DelegationHistory.CheckPointHistoryState; using SafeMath for uint256; using SafePct for uint256; uint256 public constant MAX_BIPS = 10000; string private constant MAX_BIPS_MSG = "Max delegation bips exceeded"; /** * @dev `DelegationState` is the state structure used by this library to contain/manage * a grouing of _delegates (a PercentageDelegation) for a delegator. */ struct DelegationState { // percentages by _delegates DelegationHistory.CheckPointHistoryState delegation; } /** * @notice Add or replace an existing _delegate with allocated vote power in basis points. * @param _self A DelegationState instance to manage. * @param _delegate The address of the _delegate to add/replace * @param _bips Allocation of the delegation specified in basis points (1/100 of 1 percent) * @dev If you send a `_bips` of zero, `_delegate` will be deleted if one * exists in the delegation; if zero and `_delegate` does not exist, it will not be added. */ function addReplaceDelegate( DelegationState storage _self, address _delegate, uint256 _bips ) internal { // Check for max delegation basis points assert(_bips <= MAX_BIPS); // Change the delegate's percentage _self.delegation.writeValue(_delegate, _bips); // check the total require(_self.delegation.totalValueAtNow() <= MAX_BIPS, MAX_BIPS_MSG); } /** * @notice Get the total of the explicit vote power delegation bips of all delegates at given block. * @param _self A DelegationState instance to manage. * @param _blockNumber The block to query. * @return _totalBips The total vote power bips delegated. */ function getDelegatedTotalAt( DelegationState storage _self, uint256 _blockNumber ) internal view returns (uint256 _totalBips) { return _self.delegation.totalValueAt(_blockNumber); } /** * @notice Get the total of the bips vote power delegation bips of all _delegates. * @param _self A DelegationState instance to manage. * @return _totalBips The total vote power bips delegated. */ function getDelegatedTotal( DelegationState storage _self ) internal view returns (uint256 _totalBips) { return _self.delegation.totalValueAtNow(); } /** * @notice Given a _delegate address, return the bips of the vote power delegation. * @param _self A DelegationState instance to manage. * @param _delegate The delegate address to find. * @param _blockNumber The block to query. * @return _bips The percent of vote power allocated to the delegate address. */ function getDelegatedValueAt( DelegationState storage _self, address _delegate, uint256 _blockNumber ) internal view returns (uint256 _bips) { return _self.delegation.valueOfAt(_delegate, _blockNumber); } /** * @notice Given a delegate address, return the bips of the vote power delegation. * @param _self A DelegationState instance to manage. * @param _delegate The delegate address to find. * @return _bips The percent of vote power allocated to the delegate address. */ function getDelegatedValue( DelegationState storage _self, address _delegate ) internal view returns (uint256 _bips) { return _self.delegation.valueOfAtNow(_delegate); } /** * @notice Returns lists of delegate addresses and corresponding values at given block. * @param _self A DelegationState instance to manage. * @param _blockNumber The block to query. * @return _delegates Positional array of delegation addresses. * @return _values Positional array of delegation percents specified in basis points (1/100 or 1 percent) */ function getDelegationsAt( DelegationState storage _self, uint256 _blockNumber ) internal view returns ( address[] memory _delegates, uint256[] memory _values ) { return _self.delegation.delegationsAt(_blockNumber); } /** * @notice Returns lists of delegate addresses and corresponding values. * @param _self A DelegationState instance to manage. * @return _delegates Positional array of delegation addresses. * @return _values Positional array of delegation percents specified in basis points (1/100 or 1 percent) */ function getDelegations( DelegationState storage _self ) internal view returns ( address[] memory _delegates, uint256[] memory _values ) { return _self.delegation.delegationsAtNow(); } /** * Get all percentage delegations active now. * @param _self A CheckPointHistoryState instance to manage. * @return _length The number of delegations. * @return _delegations . **/ function getDelegationsRaw( DelegationState storage _self ) internal view returns ( uint256 _length, mapping(uint256 => DelegationHistory.Delegation) storage _delegations ) { return _self.delegation.delegationsAtNowRaw(); } /** * Get the number of delegations. * @param _self A DelegationState instance to manage. * @param _blockNumber The block number to query. * @return _count Count of delegations at the time. **/ function getCountAt( DelegationState storage _self, uint256 _blockNumber ) internal view returns (uint256 _count) { return _self.delegation.countAt(_blockNumber); } /** * Get the number of delegations. * @param _self A DelegationState instance to manage. * @return _count Count of delegations at the time. **/ function getCount( DelegationState storage _self ) internal view returns (uint256 _count) { return _self.delegation.countAt(block.number); } /** * @notice Get the total amount (absolute) of the vote power delegation of all delegates. * @param _self A DelegationState instance to manage. * @param _balance Owner's balance. * @return _totalAmount The total vote power amount delegated. */ function getDelegatedTotalAmountAt( DelegationState storage _self, uint256 _balance, uint256 _blockNumber ) internal view returns (uint256 _totalAmount) { return _self.delegation.scaledTotalValueAt(_balance, MAX_BIPS, _blockNumber); } /** * @notice Clears all delegates. * @param _self A DelegationState instance to manage. * @dev Delegation mode remains PERCENTAGE, even though the delgation is now empty. */ function clear(DelegationState storage _self) internal { _self.delegation.clear(); } /** * Delete at most `_count` of the oldest checkpoints. * At least one checkpoint at or before `_cleanupBlockNumber` will remain * (unless the history was empty to start with). */ function cleanupOldCheckpoints( DelegationState storage _self, uint256 _count, uint256 _cleanupBlockNumber ) internal returns (uint256) { return _self.delegation.cleanupOldCheckpoints(_count, _cleanupBlockNumber); } }
contracts/inflation/implementation/Supply.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "../interface/IISupply.sol"; import "../../tokenPools/interface/IITokenPool.sol"; import "../../token/lib/CheckPointHistory.sol"; import "../../token/lib/CheckPointHistoryCache.sol"; import "../../governance/implementation/Governed.sol"; import "../../addressUpdater/implementation/AddressUpdatable.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; /** * @title Supply contract * @notice This contract maintains and computes various native token supply totals. **/ contract Supply is IISupply, Governed, AddressUpdatable { using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; using CheckPointHistoryCache for CheckPointHistoryCache.CacheState; using SafeMath for uint256; address payable private constant BURN_ADDRESS = 0x000000000000000000000000000000000000dEaD; struct SupplyData { IITokenPool tokenPool; uint256 totalLockedWei; uint256 totalInflationAuthorizedWei; uint256 totalClaimedWei; } string internal constant ERR_INFLATION_ONLY = "inflation only"; string internal constant ERR_TOKEN_POOL_ALREADY_ADDED = "token pool already added"; string internal constant ERR_INITIAL_GENESIS_AMOUNT_ZERO = "initial genesis amount zero"; CheckPointHistory.CheckPointHistoryState private circulatingSupplyWei; CheckPointHistoryCache.CacheState private circulatingSupplyWeiCache; uint256 immutable public initialGenesisAmountWei; uint256 immutable public totalExcludedSupplyWei; // Foundation supply, distribution treasury, team escrow uint256 public distributedExcludedSupplyWei; uint256 public totalLockedWei; // Amounts temporary locked and not considered in the inflatable supply uint256 public totalInflationAuthorizedWei; uint256 public totalClaimedWei; SupplyData[] public tokenPools; address public inflation; // balance of burn address at last check - needed for updating circulating supply uint256 private burnAddressBalance; // events event AuthorizedInflationUpdateError(uint256 actual, uint256 expected); modifier onlyInflation { require(msg.sender == inflation, ERR_INFLATION_ONLY); _; } constructor( address _governance, address _addressUpdater, uint256 _initialGenesisAmountWei, uint256 _totalExcludedSupplyWei, IITokenPool[] memory _tokenPools ) Governed(_governance) AddressUpdatable(_addressUpdater) { require(_initialGenesisAmountWei > 0, ERR_INITIAL_GENESIS_AMOUNT_ZERO); initialGenesisAmountWei = _initialGenesisAmountWei; totalExcludedSupplyWei = _totalExcludedSupplyWei; _increaseCirculatingSupply(_initialGenesisAmountWei.sub(_totalExcludedSupplyWei)); for (uint256 i = 0; i < _tokenPools.length; i++) { _addTokenPool(_tokenPools[i]); } _updateCirculatingSupply(BURN_ADDRESS); } /** * @notice Updates circulating supply * @dev Also updates the burn address amount */ function updateCirculatingSupply() external override onlyInflation { _updateCirculatingSupply(BURN_ADDRESS); } /** * @notice Updates authorized inflation and circulating supply - emits event if error * @param _inflationAuthorizedWei Authorized inflation * @dev Also updates the burn address amount */ function updateAuthorizedInflationAndCirculatingSupply( uint256 _inflationAuthorizedWei ) external override onlyInflation { // Save old total inflation authorized value to compare with after update. uint256 oldTotalInflationAuthorizedWei = totalInflationAuthorizedWei; _updateCirculatingSupply(BURN_ADDRESS); // Check if new authorized inflation was distributed and updated correctly. if (totalInflationAuthorizedWei != oldTotalInflationAuthorizedWei.add(_inflationAuthorizedWei)) { emit AuthorizedInflationUpdateError(totalInflationAuthorizedWei - oldTotalInflationAuthorizedWei, _inflationAuthorizedWei); } } /** * @notice Adds token pool so it can call updateTokenPoolDistributedAmount method when some tokens are distributed * @param _tokenPool Token pool address * @param _increaseDistributedSupplyByAmountWei If token pool was given initial supply from excluded supply, increase distributed value by this amount */ function addTokenPool( IITokenPool _tokenPool, uint256 _increaseDistributedSupplyByAmountWei ) external onlyGovernance { _increaseDistributedSupply(_increaseDistributedSupplyByAmountWei); _addTokenPool(_tokenPool); _updateCirculatingSupply(BURN_ADDRESS); } /** * @notice Increase distributed supply when excluded funds are released to a token pool or team members * @param _amountWei Amount to increase by */ function increaseDistributedSupply(uint256 _amountWei) external onlyGovernance { _increaseDistributedSupply(_amountWei); _updateCirculatingSupply(BURN_ADDRESS); } /** * @notice Descrease distributed supply if excluded funds are no longer locked to a token pool * @param _amountWei Amount to decrease by */ function decreaseDistributedSupply(uint256 _amountWei) external onlyGovernance { distributedExcludedSupplyWei = distributedExcludedSupplyWei.sub(_amountWei); _decreaseCirculatingSupply(_amountWei); _updateCirculatingSupply(BURN_ADDRESS); } /** * @notice Get approximate circulating supply for given block number from cache - only past block * @param _blockNumber Block number * @return _circulatingSupplyWei Return approximate circulating supply for last known block <= _blockNumber */ function getCirculatingSupplyAtCached( uint256 _blockNumber ) external override returns(uint256 _circulatingSupplyWei) { // use cache only for the past (the value will never change) require(_blockNumber < block.number, "Can only be used for past blocks"); (_circulatingSupplyWei,) = circulatingSupplyWeiCache.valueAt(circulatingSupplyWei, _blockNumber); } /** * @notice Get approximate circulating supply for given block number * @param _blockNumber Block number * @return _circulatingSupplyWei Return approximate circulating supply for last known block <= _blockNumber */ function getCirculatingSupplyAt( uint256 _blockNumber ) external view override returns(uint256 _circulatingSupplyWei) { return circulatingSupplyWei.valueAt(_blockNumber); } /** * @notice Get total inflatable balance (initial genesis amount + total claimed - total excluded/locked amount) * @return _inflatableBalanceWei Return inflatable balance */ function getInflatableBalance() external view override returns(uint256 _inflatableBalanceWei) { return initialGenesisAmountWei .add(totalClaimedWei) .sub(totalExcludedSupplyWei.sub(distributedExcludedSupplyWei)) .sub(totalLockedWei); } /** * Return the burn address (a constant). */ function burnAddress() external pure returns (address payable) { return BURN_ADDRESS; } /** * @notice Implementation of the AddressUpdatable abstract method. */ function _updateContractAddresses( bytes32[] memory _contractNameHashes, address[] memory _contractAddresses ) internal override { inflation = _getContractAddress(_contractNameHashes, _contractAddresses, "Inflation"); } function _increaseCirculatingSupply(uint256 _increaseBy) internal { circulatingSupplyWei.writeValue(circulatingSupplyWei.valueAtNow().add(_increaseBy)); } function _decreaseCirculatingSupply(uint256 _descreaseBy) internal { circulatingSupplyWei.writeValue(circulatingSupplyWei.valueAtNow().sub(_descreaseBy)); } function _updateCirculatingSupply(address _burnAddress) internal { uint256 len = tokenPools.length; for (uint256 i = 0; i < len; i++) { SupplyData storage data = tokenPools[i]; uint256 newTotalLockedWei; uint256 newTotalInflationAuthorizedWei; uint256 newTotalClaimedWei; (newTotalLockedWei, newTotalInflationAuthorizedWei, newTotalClaimedWei) = data.tokenPool.getTokenPoolSupplyData(); assert(newTotalLockedWei.add(newTotalInflationAuthorizedWei) >= newTotalClaimedWei); // updates total inflation authorized with daily authorized inflation uint256 dailyInflationAuthorizedWei = newTotalInflationAuthorizedWei.sub(data.totalInflationAuthorizedWei); totalInflationAuthorizedWei = totalInflationAuthorizedWei.add(dailyInflationAuthorizedWei); // updates circulating supply uint256 claimChange = newTotalClaimedWei.sub(data.totalClaimedWei); _increaseCirculatingSupply(claimChange); totalClaimedWei = totalClaimedWei.add(claimChange); if (newTotalLockedWei >= data.totalLockedWei) { uint256 lockChange = newTotalLockedWei - data.totalLockedWei; _decreaseCirculatingSupply(lockChange); totalLockedWei = totalLockedWei.add(lockChange); } else { // if founds are unlocked, they are returned to excluded amount uint256 lockChange = data.totalLockedWei - newTotalLockedWei; distributedExcludedSupplyWei = distributedExcludedSupplyWei.sub(lockChange); totalLockedWei = totalLockedWei.sub(lockChange); } // update data data.totalLockedWei = newTotalLockedWei; data.totalInflationAuthorizedWei = newTotalInflationAuthorizedWei; data.totalClaimedWei = newTotalClaimedWei; } _updateBurnAddressAmount(_burnAddress); } function _updateBurnAddressAmount(address _burnAddress) internal { uint256 newBalance = _burnAddress.balance; _decreaseCirculatingSupply(newBalance.sub(burnAddressBalance)); burnAddressBalance = newBalance; } function _addTokenPool(IITokenPool _tokenPool) internal { uint256 len = tokenPools.length; for (uint256 i = 0; i < len; i++) { if (_tokenPool == tokenPools[i].tokenPool) { revert(ERR_TOKEN_POOL_ALREADY_ADDED); } } tokenPools.push(); tokenPools[len].tokenPool = _tokenPool; } function _increaseDistributedSupply(uint256 _amountWei) internal { assert(totalExcludedSupplyWei.sub(distributedExcludedSupplyWei) >= _amountWei); _increaseCirculatingSupply(_amountWei); distributedExcludedSupplyWei = distributedExcludedSupplyWei.add(_amountWei); } }
contracts/token/interface/IIVPToken.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import "../../userInterfaces/IVPToken.sol"; import "../../userInterfaces/IGovernanceVotePower.sol"; import "./IIVPContract.sol"; import "./IIGovernanceVotePower.sol"; import "./IICleanable.sol"; interface IIVPToken is IVPToken, IICleanable { /** * Set the contract that is allowed to set cleanupBlockNumber. * Usually this will be an instance of CleanupBlockNumberManager. */ function setCleanupBlockNumberManager(address _cleanupBlockNumberManager) external; /** * Sets new governance vote power contract that allows token owners to participate in governance voting * and delegate governance vote power. */ function setGovernanceVotePower(IIGovernanceVotePower _governanceVotePower) external; /** * @notice Get the total vote power at block `_blockNumber` using cache. * It tries to read the cached value and if not found, reads the actual value and stores it in cache. * Can only be used if `_blockNumber` is in the past, otherwise reverts. * @param _blockNumber The block number at which to fetch. * @return The total vote power at the block (sum of all accounts' vote powers). */ function totalVotePowerAtCached(uint256 _blockNumber) external returns(uint256); /** * @notice Get the vote power of `_owner` at block `_blockNumber` using cache. * It tries to read the cached value and if not found, reads the actual value and stores it in cache. * Can only be used if _blockNumber is in the past, otherwise reverts. * @param _owner The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_owner` at `_blockNumber`. */ function votePowerOfAtCached(address _owner, uint256 _blockNumber) external returns(uint256); /** * Return vote powers for several addresses in a batch. * @param _owners The list of addresses to fetch vote power of. * @param _blockNumber The block number at which to fetch. * @return A list of vote powers. */ function batchVotePowerOfAt( address[] memory _owners, uint256 _blockNumber ) external view returns(uint256[] memory); }
contracts/genesis/interface/IFtsoManagerGenesis.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IFtsoManagerGenesis { function getCurrentPriceEpochId() external view returns (uint256 _priceEpochId); }
contracts/token/implementation/Delegatable.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "../lib/PercentageDelegation.sol"; import "../lib/ExplicitDelegation.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; import "../../utils/implementation/SafePct.sol"; import "../lib/VotePower.sol"; import "../lib/VotePowerCache.sol"; import "../../userInterfaces/IVPContractEvents.sol"; /** * @title Delegateable ERC20 behavior * @notice An ERC20 Delegateable behavior to delegate voting power * of a token to delegates. This contract orchestrates interaction between * managing a delegation and the vote power allocations that result. **/ contract Delegatable is IVPContractEvents { using PercentageDelegation for PercentageDelegation.DelegationState; using ExplicitDelegation for ExplicitDelegation.DelegationState; using SafeMath for uint256; using SafePct for uint256; using VotePower for VotePower.VotePowerState; using VotePowerCache for VotePowerCache.CacheState; enum DelegationMode { NOTSET, PERCENTAGE, AMOUNT } // The number of history cleanup steps executed for every write operation. // It is more than 1 to make as certain as possible that all history gets cleaned eventually. uint256 private constant CLEANUP_COUNT = 2; string constant private UNDELEGATED_VP_TOO_SMALL_MSG = "Undelegated vote power too small"; // Map that tracks delegation mode of each address. mapping(address => DelegationMode) private delegationModes; // `percentageDelegations` is the map that tracks the percentage voting power delegation of each address. // Explicit delegations are tracked directly through votePower. mapping(address => PercentageDelegation.DelegationState) private percentageDelegations; mapping(address => ExplicitDelegation.DelegationState) private explicitDelegations; // `votePower` tracks all voting power balances VotePower.VotePowerState private votePower; // `votePower` tracks all voting power balances VotePowerCache.CacheState private votePowerCache; // Historic data for the blocks before `cleanupBlockNumber` can be erased, // history before that block should never be used since it can be inconsistent. uint256 private cleanupBlockNumber; // Address of the contract that is allowed to call methods for history cleaning. address public cleanerContract; /** * Emitted when a vote power cache entry is created. * Allows history cleaners to track vote power cache cleanup opportunities off-chain. */ event CreatedVotePowerCache(address _owner, uint256 _blockNumber); // Most history cleanup opportunities can be deduced from standard events: // Transfer(from, to, amount): // - vote power checkpoints for `from` (if nonzero) and `to` (if nonzero) // - vote power checkpoints for percentage delegatees of `from` and `to` are also created, // but they don't have to be checked since Delegate events are also emitted in case of // percentage delegation vote power change due to delegators balance change // - Note: Transfer event is emitted from VPToken but vote power checkpoint delegationModes // must be called on its writeVotePowerContract // Delegate(from, to, priorVP, newVP): // - vote power checkpoints for `from` and `to` // - percentage delegation checkpoint for `from` (if `from` uses percentage delegation mode) // - explicit delegation checkpoint from `from` to `to` (if `from` uses explicit delegation mode) // Revoke(from, to, vp, block): // - vote power cache for `from` and `to` at `block` // - revocation cache block from `from` to `to` at `block` /** * Reading from history is not allowed before `cleanupBlockNumber`, since data before that * might have been deleted and is thus unreliable. */ modifier notBeforeCleanupBlock(uint256 _blockNumber) { require(_blockNumber >= cleanupBlockNumber, "Delegatable: reading from cleaned-up block"); _; } /** * History cleaning methods can be called only from the cleaner address. */ modifier onlyCleaner { require(msg.sender == cleanerContract, "Only cleaner contract"); _; } /** * @notice (Un)Allocate `_owner` vote power of `_amount` across owner delegate * vote power percentages. * @param _owner The address of the vote power owner. * @param _priorBalance The owner's balance before change. * @param _newBalance The owner's balance after change. * @dev precondition: delegationModes[_owner] == DelegationMode.PERCENTAGE */ function _allocateVotePower(address _owner, uint256 _priorBalance, uint256 _newBalance) private { // Get the voting delegation for the _owner PercentageDelegation.DelegationState storage delegation = percentageDelegations[_owner]; // Track total owner vp change uint256 ownerVpAdd = _newBalance; uint256 ownerVpSub = _priorBalance; // Iterate over the delegates (uint256 length, mapping(uint256 => DelegationHistory.Delegation) storage delegations) = delegation.getDelegationsRaw(); for (uint256 i = 0; i < length; i++) { DelegationHistory.Delegation storage dlg = delegations[i]; address delegatee = dlg.delegate; uint256 value = dlg.value; // Compute the delegated vote power for the delegatee uint256 priorValue = _priorBalance.mulDiv(value, PercentageDelegation.MAX_BIPS); uint256 newValue = _newBalance.mulDiv(value, PercentageDelegation.MAX_BIPS); ownerVpAdd = ownerVpAdd.add(priorValue); ownerVpSub = ownerVpSub.add(newValue); // could optimize next lines by checking that priorValue != newValue, but that can only happen // for the transfer of 0 amount, which is prevented by the calling function votePower.changeValue(delegatee, newValue, priorValue); votePower.cleanupOldCheckpoints(delegatee, CLEANUP_COUNT, cleanupBlockNumber); emit Delegate(_owner, delegatee, priorValue, newValue); } // (ownerVpAdd - ownerVpSub) is how much the owner vp changes - will be 0 if delegation is 100% if (ownerVpAdd != ownerVpSub) { votePower.changeValue(_owner, ownerVpAdd, ownerVpSub); votePower.cleanupOldCheckpoints(_owner, CLEANUP_COUNT, cleanupBlockNumber); } } /** * @notice Burn `_amount` of vote power for `_owner`. * @param _owner The address of the _owner vote power to burn. * @param _ownerCurrentBalance The current token balance of the owner (which is their allocatable vote power). * @param _amount The amount of vote power to burn. */ function _burnVotePower(address _owner, uint256 _ownerCurrentBalance, uint256 _amount) internal { // revert with the same error as ERC20 in case transfer exceeds balance uint256 newOwnerBalance = _ownerCurrentBalance.sub(_amount, "ERC20: transfer amount exceeds balance"); if (delegationModes[_owner] == DelegationMode.PERCENTAGE) { // for PERCENTAGE delegation: reduce owner vote power allocations _allocateVotePower(_owner, _ownerCurrentBalance, newOwnerBalance); } else { // for AMOUNT delegation: is there enough unallocated VP _to burn if explicitly delegated? require(_isTransmittable(_owner, _ownerCurrentBalance, _amount), UNDELEGATED_VP_TOO_SMALL_MSG); // burn vote power votePower.changeValue(_owner, 0, _amount); votePower.cleanupOldCheckpoints(_owner, CLEANUP_COUNT, cleanupBlockNumber); } } /** * @notice Get whether `_owner` current delegation can be delegated by percentage. * @param _owner Address of delegation to check. * @return True if delegation can be delegated by percentage. */ function _canDelegateByPct(address _owner) internal view returns(bool) { // Get the delegation mode. DelegationMode delegationMode = delegationModes[_owner]; // Return true if delegation is safe _to store percents, which can also // apply if there is not delegation mode set. return delegationMode == DelegationMode.NOTSET || delegationMode == DelegationMode.PERCENTAGE; } /** * @notice Get whether `_owner` current delegation can be delegated by amount. * @param _owner Address of delegation to check. * @return True if delegation can be delegated by amount. */ function _canDelegateByAmount(address _owner) internal view returns(bool) { // Get the delegation mode. DelegationMode delegationMode = delegationModes[_owner]; // Return true if delegation is safe to store explicit amounts, which can also // apply if there is not delegation mode set. return delegationMode == DelegationMode.NOTSET || delegationMode == DelegationMode.AMOUNT; } /** * @notice Delegate `_amount` of voting power to `_to` from `_from` * @param _from The address of the delegator * @param _to The address of the recipient * @param _senderCurrentBalance The senders current balance (not their voting power) * @param _amount The amount of voting power to be delegated **/ function _delegateByAmount( address _from, address _to, uint256 _senderCurrentBalance, uint256 _amount ) internal virtual { require (_to != address(0), "Cannot delegate to zero"); require (_to != _from, "Cannot delegate to self"); require (_canDelegateByAmount(_from), "Cannot delegate by amount"); // Get the vote power delegation for the sender ExplicitDelegation.DelegationState storage delegation = explicitDelegations[_from]; // the prior value uint256 priorAmount = delegation.getDelegatedValue(_to); // Delegate new power if (_amount < priorAmount) { // Prior amount is greater, just reduce the delegated amount. // subtraction is safe since _amount < priorAmount votePower.undelegate(_from, _to, priorAmount - _amount); } else { // Is there enough undelegated vote power? uint256 availableAmount = _undelegatedVotePowerOf(_from, _senderCurrentBalance).add(priorAmount); require(availableAmount >= _amount, UNDELEGATED_VP_TOO_SMALL_MSG); // Increase the delegated amount of vote power. // subtraction is safe since _amount >= priorAmount votePower.delegate(_from, _to, _amount - priorAmount); } votePower.cleanupOldCheckpoints(_from, CLEANUP_COUNT, cleanupBlockNumber); votePower.cleanupOldCheckpoints(_to, CLEANUP_COUNT, cleanupBlockNumber); // Add/replace delegate delegation.addReplaceDelegate(_to, _amount); delegation.cleanupOldCheckpoints(_to, CLEANUP_COUNT, cleanupBlockNumber); // update mode if needed if (delegationModes[_from] != DelegationMode.AMOUNT) { delegationModes[_from] = DelegationMode.AMOUNT; } // emit event for delegation change emit Delegate(_from, _to, priorAmount, _amount); } /** * @notice Delegate `_bips` of voting power to `_to` from `_from` * @param _from The address of the delegator * @param _to The address of the recipient * @param _senderCurrentBalance The senders current balance (not their voting power) * @param _bips The percentage of voting power in basis points (1/100 of 1 percent) to be delegated **/ function _delegateByPercentage( address _from, address _to, uint256 _senderCurrentBalance, uint256 _bips ) internal virtual { require (_to != address(0), "Cannot delegate to zero"); require (_to != _from, "Cannot delegate to self"); require (_canDelegateByPct(_from), "Cannot delegate by percentage"); // Get the vote power delegation for the sender PercentageDelegation.DelegationState storage delegation = percentageDelegations[_from]; // Get prior percent for delegate if exists uint256 priorBips = delegation.getDelegatedValue(_to); uint256 reverseVotePower = 0; uint256 newVotePower = 0; // Add/replace delegate delegation.addReplaceDelegate(_to, _bips); delegation.cleanupOldCheckpoints(CLEANUP_COUNT, cleanupBlockNumber); // First, back out old voting power percentage, if not zero if (priorBips != 0) { reverseVotePower = _senderCurrentBalance.mulDiv(priorBips, PercentageDelegation.MAX_BIPS); } // Calculate the new vote power if (_bips != 0) { newVotePower = _senderCurrentBalance.mulDiv(_bips, PercentageDelegation.MAX_BIPS); } // Delegate new power if (newVotePower < reverseVotePower) { // subtraction is safe since newVotePower < reverseVotePower votePower.undelegate(_from, _to, reverseVotePower - newVotePower); } else { // subtraction is safe since newVotePower >= reverseVotePower votePower.delegate(_from, _to, newVotePower - reverseVotePower); } votePower.cleanupOldCheckpoints(_from, CLEANUP_COUNT, cleanupBlockNumber); votePower.cleanupOldCheckpoints(_to, CLEANUP_COUNT, cleanupBlockNumber); // update mode if needed if (delegationModes[_from] != DelegationMode.PERCENTAGE) { delegationModes[_from] = DelegationMode.PERCENTAGE; } // emit event for delegation change emit Delegate(_from, _to, reverseVotePower, newVotePower); } /** * @notice Get the delegation mode for '_who'. This mode determines whether vote power is * allocated by percentage or by explicit value. * @param _who The address to get delegation mode. * @return Delegation mode */ function _delegationModeOf(address _who) internal view returns (DelegationMode) { return delegationModes[_who]; } /** * @notice Get the vote power delegation `delegationAddresses` * and `_bips` of an `_owner`. Returned in two separate positional arrays. * @param _owner The address to get delegations. * @param _blockNumber The block for which we want to know the delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) */ function _percentageDelegatesOfAt( address _owner, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns ( address[] memory _delegateAddresses, uint256[] memory _bips ) { PercentageDelegation.DelegationState storage delegation = percentageDelegations[_owner]; address[] memory allDelegateAddresses; uint256[] memory allBips; (allDelegateAddresses, allBips) = delegation.getDelegationsAt(_blockNumber); // delete revoked addresses for (uint256 i = 0; i < allDelegateAddresses.length; i++) { if (votePowerCache.revokedFromToAt(_owner, allDelegateAddresses[i], _blockNumber)) { allBips[i] = 0; } } uint256 length = 0; for (uint256 i = 0; i < allDelegateAddresses.length; i++) { if (allBips[i] != 0) length++; } _delegateAddresses = new address[](length); _bips = new uint256[](length); uint256 destIndex = 0; for (uint256 i = 0; i < allDelegateAddresses.length; i++) { if (allBips[i] != 0) { _delegateAddresses[destIndex] = allDelegateAddresses[i]; _bips[destIndex] = allBips[i]; destIndex++; } } } /** * @notice Checks if enough undelegated vote power exists to allow a token * transfer to occur if vote power is explicitly delegated. * @param _owner The address of transmittable vote power to check. * @param _ownerCurrentBalance The current balance of `_owner`. * @param _amount The amount to check. * @return True is `_amount` is transmittable. */ function _isTransmittable( address _owner, uint256 _ownerCurrentBalance, uint256 _amount ) private view returns(bool) { // Only proceed if we have a delegation by _amount if (delegationModes[_owner] == DelegationMode.AMOUNT) { // Return true if there is enough vote power _to cover the transfer return _undelegatedVotePowerOf(_owner, _ownerCurrentBalance) >= _amount; } else { // Not delegated by _amount, so transfer always allowed return true; } } /** * @notice Mint `_amount` of vote power for `_owner`. * @param _owner The address of the owner to receive new vote power. * @param _amount The amount of vote power to mint. */ function _mintVotePower(address _owner, uint256 _ownerCurrentBalance, uint256 _amount) internal { if (delegationModes[_owner] == DelegationMode.PERCENTAGE) { // Allocate newly minted vote power over delegates _allocateVotePower(_owner, _ownerCurrentBalance, _ownerCurrentBalance.add(_amount)); } else { votePower.changeValue(_owner, _amount, 0); votePower.cleanupOldCheckpoints(_owner, CLEANUP_COUNT, cleanupBlockNumber); } } /** * @notice Revoke the vote power of `_to` at block `_blockNumber` * @param _from The address of the delegator * @param _to The delegatee address of vote power to revoke. * @param _senderBalanceAt The sender's balance at the block to be revoked. * @param _blockNumber The block number at which to revoke. */ function _revokeDelegationAt( address _from, address _to, uint256 _senderBalanceAt, uint256 _blockNumber ) internal notBeforeCleanupBlock(_blockNumber) { require(_blockNumber < block.number, "Revoke is only for the past, use undelegate for the present"); // Get amount revoked uint256 votePowerRevoked = _votePowerFromToAtNoRevokeCheck(_from, _to, _senderBalanceAt, _blockNumber); // Revoke vote power votePowerCache.revokeAt(votePower, _from, _to, votePowerRevoked, _blockNumber); // Emit revoke event emit Revoke(_from, _to, votePowerRevoked, _blockNumber); } /** * @notice Transmit `_amount` of vote power `_from` address `_to` address. * @param _from The address of the sender. * @param _to The address of the receiver. * @param _fromCurrentBalance The current token balance of the transmitter. * @param _toCurrentBalance The current token balance of the receiver. * @param _amount The amount of vote power to transmit. */ function _transmitVotePower( address _from, address _to, uint256 _fromCurrentBalance, uint256 _toCurrentBalance, uint256 _amount ) internal { _burnVotePower(_from, _fromCurrentBalance, _amount); _mintVotePower(_to, _toCurrentBalance, _amount); } /** * @notice Undelegate all vote power by percentage for `delegation` of `_who`. * @param _from The address of the delegator * @param _senderCurrentBalance The current balance of message sender. * precondition: delegationModes[_who] == DelegationMode.PERCENTAGE */ function _undelegateAllByPercentage(address _from, uint256 _senderCurrentBalance) internal { DelegationMode delegationMode = delegationModes[_from]; if (delegationMode == DelegationMode.NOTSET) return; require(delegationMode == DelegationMode.PERCENTAGE, "undelegateAll can only be used in percentage delegation mode"); PercentageDelegation.DelegationState storage delegation = percentageDelegations[_from]; // Iterate over the delegates (address[] memory delegates, uint256[] memory _bips) = delegation.getDelegations(); for (uint256 i = 0; i < delegates.length; i++) { address to = delegates[i]; // Compute vote power to be reversed for the delegate uint256 reverseVotePower = _senderCurrentBalance.mulDiv(_bips[i], PercentageDelegation.MAX_BIPS); // Transmit vote power back to _owner votePower.undelegate(_from, to, reverseVotePower); votePower.cleanupOldCheckpoints(_from, CLEANUP_COUNT, cleanupBlockNumber); votePower.cleanupOldCheckpoints(to, CLEANUP_COUNT, cleanupBlockNumber); // Emit vote power reversal event emit Delegate(_from, to, reverseVotePower, 0); } // Clear delegates delegation.clear(); delegation.cleanupOldCheckpoints(CLEANUP_COUNT, cleanupBlockNumber); } /** * @notice Undelegate all vote power by amount delegates for `_from`. * @param _from The address of the delegator * @param _delegateAddresses Explicit delegation does not store delegatees' addresses, * so the caller must supply them. */ function _undelegateAllByAmount( address _from, address[] memory _delegateAddresses ) internal returns (uint256 _remainingDelegation) { DelegationMode delegationMode = delegationModes[_from]; if (delegationMode == DelegationMode.NOTSET) return 0; require(delegationMode == DelegationMode.AMOUNT, "undelegateAllExplicit can only be used in explicit delegation mode"); ExplicitDelegation.DelegationState storage delegation = explicitDelegations[_from]; // Iterate over the delegates for (uint256 i = 0; i < _delegateAddresses.length; i++) { address to = _delegateAddresses[i]; // Compute vote power _to be reversed for the delegate uint256 reverseVotePower = delegation.getDelegatedValue(to); if (reverseVotePower == 0) continue; // Transmit vote power back _to _owner votePower.undelegate(_from, to, reverseVotePower); votePower.cleanupOldCheckpoints(_from, CLEANUP_COUNT, cleanupBlockNumber); votePower.cleanupOldCheckpoints(to, CLEANUP_COUNT, cleanupBlockNumber); // change delagation delegation.addReplaceDelegate(to, 0); delegation.cleanupOldCheckpoints(to, CLEANUP_COUNT, cleanupBlockNumber); // Emit vote power reversal event emit Delegate(_from, to, reverseVotePower, 0); } return delegation.getDelegatedTotal(); } /** * @notice Check if the `_owner` has made any delegations. * @param _owner The address of owner to get delegated vote power. * @return The total delegated vote power at block. */ function _hasAnyDelegations(address _owner) internal view returns(bool) { DelegationMode delegationMode = delegationModes[_owner]; if (delegationMode == DelegationMode.NOTSET) { return false; } else if (delegationMode == DelegationMode.AMOUNT) { return explicitDelegations[_owner].getDelegatedTotal() > 0; } else { // delegationMode == DelegationMode.PERCENTAGE return percentageDelegations[_owner].getCount() > 0; } } /** * @notice Get the total delegated vote power of `_owner` at some block. * @param _owner The address of owner to get delegated vote power. * @param _ownerBalanceAt The balance of the owner at that block (not their vote power). * @param _blockNumber The block number at which to fetch. * @return _votePower The total delegated vote power at block. */ function _delegatedVotePowerOfAt( address _owner, uint256 _ownerBalanceAt, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns(uint256 _votePower) { // Get the vote power delegation for the _owner DelegationMode delegationMode = delegationModes[_owner]; if (delegationMode == DelegationMode.NOTSET) { return 0; } else if (delegationMode == DelegationMode.AMOUNT) { return explicitDelegations[_owner].getDelegatedTotalAt(_blockNumber); } else { // delegationMode == DelegationMode.PERCENTAGE return percentageDelegations[_owner].getDelegatedTotalAmountAt(_ownerBalanceAt, _blockNumber); } } /** * @notice Get the undelegated vote power of `_owner` at some block. * @param _owner The address of owner to get undelegated vote power. * @param _ownerBalanceAt The balance of the owner at that block (not their vote power). * @param _blockNumber The block number at which to fetch. * @return _votePower The undelegated vote power at block. */ function _undelegatedVotePowerOfAt( address _owner, uint256 _ownerBalanceAt, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns(uint256 _votePower) { // Return the current balance less delegations or zero if negative uint256 delegated = _delegatedVotePowerOfAt(_owner, _ownerBalanceAt, _blockNumber); bool overflow; uint256 result; (overflow, result) = _ownerBalanceAt.trySub(delegated); return result; } /** * @notice Get the undelegated vote power of `_owner`. * @param _owner The address of owner to get undelegated vote power. * @param _ownerCurrentBalance The current balance of the owner (not their vote power). * @return _votePower The undelegated vote power. */ function _undelegatedVotePowerOf( address _owner, uint256 _ownerCurrentBalance ) internal view returns(uint256 _votePower) { return _undelegatedVotePowerOfAt(_owner, _ownerCurrentBalance, block.number); } /** * @notice Get current delegated vote power `_from` delegator delegated `_to` delegatee. * @param _from Address of delegator * @param _to Address of delegatee * @return _votePower The delegated vote power. */ function _votePowerFromTo( address _from, address _to, uint256 _currentFromBalance ) internal view returns(uint256 _votePower) { DelegationMode delegationMode = delegationModes[_from]; if (delegationMode == DelegationMode.NOTSET) { return 0; } else if (delegationMode == DelegationMode.PERCENTAGE) { uint256 _bips = percentageDelegations[_from].getDelegatedValue(_to); return _currentFromBalance.mulDiv(_bips, PercentageDelegation.MAX_BIPS); } else { // delegationMode == DelegationMode.AMOUNT return explicitDelegations[_from].getDelegatedValue(_to); } } /** * @notice Get delegated the vote power `_from` delegator delegated `_to` delegatee at `_blockNumber`. * @param _from Address of delegator * @param _to Address of delegatee * @param _fromBalanceAt From's balance at the block `_blockNumber`. * @param _blockNumber The block number at which to fetch. * @return _votePower The delegated vote power. */ function _votePowerFromToAt( address _from, address _to, uint256 _fromBalanceAt, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns(uint256 _votePower) { // if revoked, return 0 if (votePowerCache.revokedFromToAt(_from, _to, _blockNumber)) return 0; return _votePowerFromToAtNoRevokeCheck(_from, _to, _fromBalanceAt, _blockNumber); } /** * @notice Get delegated the vote power `_from` delegator delegated `_to` delegatee at `_blockNumber`. * Private use only - ignores revocations. * @param _from Address of delegator * @param _to Address of delegatee * @param _fromBalanceAt From's balance at the block `_blockNumber`. * @param _blockNumber The block number at which to fetch. * @return _votePower The delegated vote power. */ function _votePowerFromToAtNoRevokeCheck( address _from, address _to, uint256 _fromBalanceAt, uint256 _blockNumber ) private view returns(uint256 _votePower) { // assumed: notBeforeCleanupBlock(_blockNumber) DelegationMode delegationMode = delegationModes[_from]; if (delegationMode == DelegationMode.NOTSET) { return 0; } else if (delegationMode == DelegationMode.PERCENTAGE) { uint256 _bips = percentageDelegations[_from].getDelegatedValueAt(_to, _blockNumber); return _fromBalanceAt.mulDiv(_bips, PercentageDelegation.MAX_BIPS); } else { // delegationMode == DelegationMode.AMOUNT return explicitDelegations[_from].getDelegatedValueAt(_to, _blockNumber); } } /** * @notice Get the current vote power of `_who`. * @param _who The address to get voting power. * @return Current vote power of `_who`. */ function _votePowerOf(address _who) internal view returns(uint256) { return votePower.votePowerOfAtNow(_who); } /** * @notice Get the vote power of `_who` at block `_blockNumber` * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. */ function _votePowerOfAt( address _who, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns(uint256) { // read cached value for past blocks to respect revocations (and possibly get a cache speedup) if (_blockNumber < block.number) { return votePowerCache.valueOfAtReadonly(votePower, _who, _blockNumber); } else { return votePower.votePowerOfAtNow(_who); } } /** * @notice Get the vote power of `_who` at block `_blockNumber`, ignoring revocation information (and cache). * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. Result doesn't change if vote power is revoked. */ function _votePowerOfAtIgnoringRevocation( address _who, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns(uint256) { return votePower.votePowerOfAt(_who, _blockNumber); } /** * Return vote powers for several addresses in a batch. * Only works for past blocks. * @param _owners The list of addresses to fetch vote power of. * @param _blockNumber The block number at which to fetch. * @return _votePowers A list of vote powers corresponding to _owners. */ function _batchVotePowerOfAt( address[] memory _owners, uint256 _blockNumber ) internal view notBeforeCleanupBlock(_blockNumber) returns(uint256[] memory _votePowers) { require(_blockNumber < block.number, "Can only be used for past blocks"); _votePowers = new uint256[](_owners.length); for (uint256 i = 0; i < _owners.length; i++) { // read through cache, much faster if it has been set _votePowers[i] = votePowerCache.valueOfAtReadonly(votePower, _owners[i], _blockNumber); } } /** * @notice Get the vote power of `_who` at block `_blockNumber` * Reads/updates cache and upholds revocations. * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. */ function _votePowerOfAtCached( address _who, uint256 _blockNumber ) internal notBeforeCleanupBlock(_blockNumber) returns(uint256) { require(_blockNumber < block.number, "Can only be used for past blocks"); (uint256 vp, bool createdCache) = votePowerCache.valueOfAt(votePower, _who, _blockNumber); if (createdCache) emit CreatedVotePowerCache(_who, _blockNumber); return vp; } /** * Set the cleanup block number. */ function _setCleanupBlockNumber(uint256 _blockNumber) internal { require(_blockNumber >= cleanupBlockNumber, "Cleanup block number must never decrease"); require(_blockNumber < block.number, "Cleanup block must be in the past"); cleanupBlockNumber = _blockNumber; } /** * Get the cleanup block number. */ function _cleanupBlockNumber() internal view returns (uint256) { return cleanupBlockNumber; } /** * Set the contract that is allowed to call history cleaning methods. */ function _setCleanerContract(address _cleanerContract) internal { cleanerContract = _cleanerContract; } // history cleanup methods /** * Delete vote power checkpoints that expired (i.e. are before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _owner vote power owner account address * @param _count maximum number of checkpoints to delete * @return the number of checkpoints deleted */ function votePowerHistoryCleanup(address _owner, uint256 _count) external onlyCleaner returns (uint256) { return votePower.cleanupOldCheckpoints(_owner, _count, cleanupBlockNumber); } /** * Delete vote power cache entry that expired (i.e. is before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _owner vote power owner account address * @param _blockNumber the block number for which total supply value was cached * @return the number of cache entries deleted (always 0 or 1) */ function votePowerCacheCleanup(address _owner, uint256 _blockNumber) external onlyCleaner returns (uint256) { require(_blockNumber < cleanupBlockNumber, "No cleanup after cleanup block"); return votePowerCache.deleteValueAt(_owner, _blockNumber); } /** * Delete revocation entry that expired (i.e. is before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _from the delegator address * @param _to the delegatee address * @param _blockNumber the block number for which total supply value was cached * @return the number of revocation entries deleted (always 0 or 1) */ function revocationCleanup( address _from, address _to, uint256 _blockNumber ) external onlyCleaner returns (uint256) { require(_blockNumber < cleanupBlockNumber, "No cleanup after cleanup block"); return votePowerCache.deleteRevocationAt(_from, _to, _blockNumber); } /** * Delete percentage delegation checkpoints that expired (i.e. are before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _owner balance owner account address * @param _count maximum number of checkpoints to delete * @return the number of checkpoints deleted */ function percentageDelegationHistoryCleanup(address _owner, uint256 _count) external onlyCleaner returns (uint256) { return percentageDelegations[_owner].cleanupOldCheckpoints(_count, cleanupBlockNumber); } /** * Delete explicit delegation checkpoints that expired (i.e. are before `cleanupBlockNumber`). * Method can only be called from the `cleanerContract` (which may be a proxy to external cleaners). * @param _from the delegator address * @param _to the delegatee address * @param _count maximum number of checkpoints to delete * @return the number of checkpoints deleted */ function explicitDelegationHistoryCleanup(address _from, address _to, uint256 _count) external onlyCleaner returns (uint256) { return explicitDelegations[_from].cleanupOldCheckpoints(_to, _count, cleanupBlockNumber); } }
contracts/token/lib/CheckPointHistory.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "@openzeppelin/contracts/math/Math.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; import "@openzeppelin/contracts/utils/SafeCast.sol"; /** * @title Check Point History library * @notice A contract to manage checkpoints as of a given block. * @dev Store value history by block number with detachable state. **/ library CheckPointHistory { using SafeMath for uint256; using SafeCast for uint256; /** * @dev `CheckPoint` is the structure that attaches a block number to a * given value; the block number attached is the one that last changed the * value **/ struct CheckPoint { // `value` is the amount of tokens at a specific block number uint192 value; // `fromBlock` is the block number that the value was generated from uint64 fromBlock; } struct CheckPointHistoryState { // `checkpoints` is an array that tracks values at non-contiguous block numbers mapping(uint256 => CheckPoint) checkpoints; // `checkpoints` before `startIndex` have been deleted // INVARIANT: checkpoints.endIndex == 0 || startIndex < checkpoints.endIndex (strict!) // startIndex and endIndex are both less then fromBlock, so 64 bits is enough uint64 startIndex; // the index AFTER last uint64 endIndex; } /** * @notice Binary search of _checkpoints array. * @param _checkpoints An array of CheckPoint to search. * @param _startIndex Smallest possible index to be returned. * @param _blockNumber The block number to search for. */ function _indexOfGreatestBlockLessThan( mapping(uint256 => CheckPoint) storage _checkpoints, uint256 _startIndex, uint256 _endIndex, uint256 _blockNumber ) private view returns (uint256 index) { // Binary search of the value by given block number in the array uint256 min = _startIndex; uint256 max = _endIndex.sub(1); while (max > min) { uint256 mid = (max.add(min).add(1)).div(2); if (_checkpoints[mid].fromBlock <= _blockNumber) { min = mid; } else { max = mid.sub(1); } } return min; } /** * @notice Queries the value at a specific `_blockNumber` * @param _self A CheckPointHistoryState instance to manage. * @param _blockNumber The block number of the value active at that time * @return _value The value at `_blockNumber` **/ function valueAt( CheckPointHistoryState storage _self, uint256 _blockNumber ) internal view returns (uint256 _value) { uint256 historyCount = _self.endIndex; // No _checkpoints, return 0 if (historyCount == 0) return 0; // Shortcut for the actual value (extra optimized for current block, to save one storage read) // historyCount - 1 is safe, since historyCount != 0 if (_blockNumber >= block.number || _blockNumber >= _self.checkpoints[historyCount - 1].fromBlock) { return _self.checkpoints[historyCount - 1].value; } // guard values at start uint256 startIndex = _self.startIndex; if (_blockNumber < _self.checkpoints[startIndex].fromBlock) { // reading data before `startIndex` is only safe before first cleanup require(startIndex == 0, "CheckPointHistory: reading from cleaned-up block"); return 0; } // Find the block with number less than or equal to block given uint256 index = _indexOfGreatestBlockLessThan(_self.checkpoints, startIndex, _self.endIndex, _blockNumber); return _self.checkpoints[index].value; } /** * @notice Queries the value at `block.number` * @param _self A CheckPointHistoryState instance to manage. * @return _value The value at `block.number` **/ function valueAtNow(CheckPointHistoryState storage _self) internal view returns (uint256 _value) { uint256 historyCount = _self.endIndex; // No _checkpoints, return 0 if (historyCount == 0) return 0; // Return last value return _self.checkpoints[historyCount - 1].value; } /** * @notice Writes the value at the current block. * @param _self A CheckPointHistoryState instance to manage. * @param _value Value to write. **/ function writeValue( CheckPointHistoryState storage _self, uint256 _value ) internal { uint256 historyCount = _self.endIndex; if (historyCount == 0) { // checkpoints array empty, push new CheckPoint _self.checkpoints[0] = CheckPoint({ fromBlock: block.number.toUint64(), value: _toUint192(_value) }); _self.endIndex = 1; } else { // historyCount - 1 is safe, since historyCount != 0 CheckPoint storage lastCheckpoint = _self.checkpoints[historyCount - 1]; uint256 lastBlock = lastCheckpoint.fromBlock; // slither-disable-next-line incorrect-equality if (block.number == lastBlock) { // If last check point is the current block, just update lastCheckpoint.value = _toUint192(_value); } else { // we should never have future blocks in history assert (block.number > lastBlock); // push new CheckPoint _self.checkpoints[historyCount] = CheckPoint({ fromBlock: block.number.toUint64(), value: _toUint192(_value) }); _self.endIndex = uint64(historyCount + 1); // 64 bit safe, because historyCount <= block.number } } } /** * Delete at most `_count` of the oldest checkpoints. * At least one checkpoint at or before `_cleanupBlockNumber` will remain * (unless the history was empty to start with). */ function cleanupOldCheckpoints( CheckPointHistoryState storage _self, uint256 _count, uint256 _cleanupBlockNumber ) internal returns (uint256) { if (_cleanupBlockNumber == 0) return 0; // optimization for when cleaning is not enabled uint256 length = _self.endIndex; if (length == 0) return 0; uint256 startIndex = _self.startIndex; // length - 1 is safe, since length != 0 (check above) uint256 endIndex = Math.min(startIndex.add(_count), length - 1); // last element can never be deleted uint256 index = startIndex; // we can delete `checkpoint[index]` while the next checkpoint is at `_cleanupBlockNumber` or before while (index < endIndex && _self.checkpoints[index + 1].fromBlock <= _cleanupBlockNumber) { delete _self.checkpoints[index]; index++; } if (index > startIndex) { // index is the first not deleted index _self.startIndex = index.toUint64(); } return index - startIndex; // safe: index >= startIndex at start and then increases } // SafeCast lib is missing cast to uint192 function _toUint192(uint256 _value) internal pure returns (uint192) { require(_value < 2**192, "value doesn't fit in 192 bits"); return uint192(_value); } }
contracts/userInterfaces/IGovernanceSettings.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; /** * A special contract that holds Flare governance address. * This contract enables updating governance address and timelock only by hard forking the network, * meaning only by updating validator code. */ interface IGovernanceSettings { /** * Get the governance account address. * The governance address can only be changed by a hardfork. */ function getGovernanceAddress() external view returns (address); /** * Get the time in seconds that must pass between a governance call and execution. * The timelock value can only be changed by a hardfork. */ function getTimelock() external view returns (uint256); /** * Get the addresses of the accounts that are allowed to execute the timelocked governance calls * once the timelock period expires. * Executors can be changed without a hardfork, via a normal governance call. */ function getExecutors() external view returns (address[] memory); /** * Check whether an address is one of the executors. */ function isExecutor(address _address) external view returns (bool); }
contracts/ftso/interface/IIFtsoManager.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; pragma abicoder v2; import "../../ftso/interface/IIFtso.sol"; import "../../userInterfaces/IFtsoManager.sol"; import "../../genesis/interface/IFlareDaemonize.sol"; import "../../token/interface/IIVPToken.sol"; interface IIFtsoManager is IFtsoManager, IFlareDaemonize { struct RewardEpochData { uint256 votepowerBlock; uint256 startBlock; uint256 startTimestamp; } event ClosingExpiredRewardEpochFailed(uint256 rewardEpoch); event CleanupBlockNumberManagerFailedForBlock(uint256 blockNumber); event UpdatingActiveValidatorsTriggerFailed(uint256 rewardEpoch); event FtsoDeactivationFailed(IIFtso ftso); function activate() external; function setInitialRewardData( uint256 _nextRewardEpochToExpire, uint256 _rewardEpochsLength, uint256 _currentRewardEpochEnds ) external; function setGovernanceParameters( uint256 _maxVotePowerNatThresholdFraction, uint256 _maxVotePowerAssetThresholdFraction, uint256 _lowAssetUSDThreshold, uint256 _highAssetUSDThreshold, uint256 _highAssetTurnoutThresholdBIPS, uint256 _lowNatTurnoutThresholdBIPS, uint256 _rewardExpiryOffsetSeconds, address[] memory _trustedAddresses ) external; function addFtso(IIFtso _ftso) external; function addFtsosBulk(IIFtso[] memory _ftsos) external; function removeFtso(IIFtso _ftso) external; function replaceFtso( IIFtso _ftsoToAdd, bool copyCurrentPrice, bool copyAssetOrAssetFtsos ) external; function replaceFtsosBulk( IIFtso[] memory _ftsosToAdd, bool copyCurrentPrice, bool copyAssetOrAssetFtsos ) external; function setFtsoAsset(IIFtso _ftso, IIVPToken _asset) external; function setFtsoAssetFtsos(IIFtso _ftso, IIFtso[] memory _assetFtsos) external; function setFallbackMode(bool _fallbackMode) external; function setFtsoFallbackMode(IIFtso _ftso, bool _fallbackMode) external; function notInitializedFtsos(IIFtso) external view returns (bool); function getRewardEpochData(uint256 _rewardEpochId) external view returns (RewardEpochData memory); function currentRewardEpochEnds() external view returns (uint256); function getLastUnprocessedPriceEpochData() external view returns( uint256 _lastUnprocessedPriceEpoch, uint256 _lastUnprocessedPriceEpochRevealEnds, bool _lastUnprocessedPriceEpochInitialized ); function rewardEpochsStartTs() external view returns(uint256); function rewardEpochDurationSeconds() external view returns(uint256); function rewardEpochs(uint256 _rewardEpochId) external view returns ( uint256 _votepowerBlock, uint256 _startBlock, uint256 _startTimestamp ); }
@openzeppelin/contracts/utils/Context.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <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 GSN 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 payable) { return msg.sender; } function _msgData() internal view virtual returns (bytes memory) { this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691 return msg.data; } }
contracts/userInterfaces/IWNat.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IWNat { /** * @notice Deposit native token and mint WNAT ERC20. */ function deposit() external payable; /** * @notice Withdraw native token and burn WNAT ERC20. * @param _amount The amount to withdraw. */ function withdraw(uint256 _amount) external; /** * @notice Deposit native token from msg.sender and mint WNAT ERC20. * @param _recipient An address to receive minted WNAT. */ function depositTo(address _recipient) external payable; /** * @notice Withdraw WNAT from an owner and send NAT to msg.sender given an allowance. * @param _owner An address spending the native tokens. * @param _amount The amount to spend. * * Requirements: * * - `_owner` must have a balance of at least `_amount`. * - the caller must have allowance for `_owners`'s tokens of at least * `_amount`. */ function withdrawFrom(address _owner, uint256 _amount) external; }
contracts/token/lib/VotePowerCache.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "@openzeppelin/contracts/math/SafeMath.sol"; import "../lib/VotePower.sol"; /** * @title Vote power library * @notice A library to record delegate vote power balances by delegator * and delegatee. **/ library VotePowerCache { using SafeMath for uint256; using VotePower for VotePower.VotePowerState; struct RevocationCacheRecord { // revoking delegation only affects cached value therefore we have to track // the revocation in order not to revoke twice // mapping delegatee => revokedValue mapping(address => uint256) revocations; } /** * @dev `CacheState` is state structure used by this library to manage vote * power amounts by delegator and it's delegates. */ struct CacheState { // map keccak256([address, _blockNumber]) -> (value + 1) mapping(bytes32 => uint256) valueCache; // map keccak256([address, _blockNumber]) -> RevocationCacheRecord mapping(bytes32 => RevocationCacheRecord) revocationCache; } /** * @notice Get the cached value at given block. If there is no cached value, original * value is returned and stored to cache. Cache never gets stale, because original * value can never change in a past block. * @param _self A VotePowerCache instance to manage. * @param _votePower A VotePower instance to read from if cache is empty. * @param _who Address to get vote power. * @param _blockNumber Block number of the block to fetch vote power. * precondition: _blockNumber < block.number */ function valueOfAt( CacheState storage _self, VotePower.VotePowerState storage _votePower, address _who, uint256 _blockNumber ) internal returns (uint256 _value, bool _createdCache) { bytes32 key = keccak256(abi.encode(_who, _blockNumber)); // is it in cache? uint256 cachedValue = _self.valueCache[key]; if (cachedValue != 0) { return (cachedValue - 1, false); // safe, cachedValue != 0 } // read from _votePower uint256 votePowerValue = _votePower.votePowerOfAt(_who, _blockNumber); _writeCacheValue(_self, key, votePowerValue); return (votePowerValue, true); } /** * @notice Get the cached value at given block. If there is no cached value, original * value is returned. Cache is never modified. * @param _self A VotePowerCache instance to manage. * @param _votePower A VotePower instance to read from if cache is empty. * @param _who Address to get vote power. * @param _blockNumber Block number of the block to fetch vote power. * precondition: _blockNumber < block.number */ function valueOfAtReadonly( CacheState storage _self, VotePower.VotePowerState storage _votePower, address _who, uint256 _blockNumber ) internal view returns (uint256 _value) { bytes32 key = keccak256(abi.encode(_who, _blockNumber)); // is it in cache? uint256 cachedValue = _self.valueCache[key]; if (cachedValue != 0) { return cachedValue - 1; // safe, cachedValue != 0 } // read from _votePower return _votePower.votePowerOfAt(_who, _blockNumber); } /** * @notice Delete cached value for `_who` at given block. * Only used for history cleanup. * @param _self A VotePowerCache instance to manage. * @param _who Address to get vote power. * @param _blockNumber Block number of the block to fetch vote power. * @return _deleted The number of cache items deleted (always 0 or 1). * precondition: _blockNumber < cleanupBlockNumber */ function deleteValueAt( CacheState storage _self, address _who, uint256 _blockNumber ) internal returns (uint256 _deleted) { bytes32 key = keccak256(abi.encode(_who, _blockNumber)); if (_self.valueCache[key] != 0) { delete _self.valueCache[key]; return 1; } return 0; } /** * @notice Revoke vote power delegation from `from` to `to` at given block. * Updates cached values for the block, so they are the only vote power values respecting revocation. * @dev Only delegatees cached value is changed, delegator doesn't get the vote power back; so * the revoked vote power is forfeit for as long as this vote power block is in use. This is needed to * prevent double voting. * @param _self A VotePowerCache instance to manage. * @param _votePower A VotePower instance to read from if cache is empty. * @param _from The delegator. * @param _to The delegatee. * @param _revokedValue Value of delegation is not stored here, so it must be supplied by caller. * @param _blockNumber Block number of the block to modify. * precondition: _blockNumber < block.number */ function revokeAt( CacheState storage _self, VotePower.VotePowerState storage _votePower, address _from, address _to, uint256 _revokedValue, uint256 _blockNumber ) internal { if (_revokedValue == 0) return; bytes32 keyFrom = keccak256(abi.encode(_from, _blockNumber)); if (_self.revocationCache[keyFrom].revocations[_to] != 0) { revert("Already revoked"); } // read values and prime cacheOf (uint256 valueTo,) = valueOfAt(_self, _votePower, _to, _blockNumber); // write new values bytes32 keyTo = keccak256(abi.encode(_to, _blockNumber)); _writeCacheValue(_self, keyTo, valueTo.sub(_revokedValue, "Revoked value too large")); // mark as revoked _self.revocationCache[keyFrom].revocations[_to] = _revokedValue; } /** * @notice Delete revocation from `_from` to `_to` at block `_blockNumber`. * Only used for history cleanup. * @param _self A VotePowerCache instance to manage. * @param _from The delegator. * @param _to The delegatee. * @param _blockNumber Block number of the block to modify. * precondition: _blockNumber < cleanupBlockNumber */ function deleteRevocationAt( CacheState storage _self, address _from, address _to, uint256 _blockNumber ) internal returns (uint256 _deleted) { bytes32 keyFrom = keccak256(abi.encode(_from, _blockNumber)); RevocationCacheRecord storage revocationRec = _self.revocationCache[keyFrom]; uint256 value = revocationRec.revocations[_to]; if (value != 0) { delete revocationRec.revocations[_to]; return 1; } return 0; } /** * @notice Returns true if `from` has revoked vote pover delgation of `to` in block `_blockNumber`. * @param _self A VotePowerCache instance to manage. * @param _from The delegator. * @param _to The delegatee. * @param _blockNumber Block number of the block to fetch result. * precondition: _blockNumber < block.number */ function revokedFromToAt( CacheState storage _self, address _from, address _to, uint256 _blockNumber ) internal view returns (bool revoked) { bytes32 keyFrom = keccak256(abi.encode(_from, _blockNumber)); return _self.revocationCache[keyFrom].revocations[_to] != 0; } function _writeCacheValue(CacheState storage _self, bytes32 _key, uint256 _value) private { // store to cacheOf (add 1 to differentiate from empty) _self.valueCache[_key] = _value.add(1); } }
contracts/governance/implementation/Governed.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import { GovernedBase } from "./GovernedBase.sol"; /** * @title Governed * @dev For deployed, governed contracts, enforce a non-zero address at create time. **/ contract Governed is GovernedBase { constructor(address _governance) GovernedBase(_governance) { require(_governance != address(0), "_governance zero"); } }
contracts/token/interface/IIGovernanceVotePower.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import "../../userInterfaces/IVPToken.sol"; import "../../userInterfaces/IGovernanceVotePower.sol"; interface IIGovernanceVotePower is IGovernanceVotePower { /** * Event triggered when an delegator's balance changes. * * Note: the event is always emitted from `GovernanceVotePower`. */ event DelegateVotesChanged( address indexed delegate, uint256 previousBalance, uint256 newBalance ); /** * Event triggered when an account delegates to another account. * * Note: the event is always emitted from `GovernanceVotePower`. */ event DelegateChanged( address indexed delegator, address indexed fromDelegate, address indexed toDelegate ); /** * Update vote powers when tokens are transfered. **/ function updateAtTokenTransfer( address _from, address _to, uint256 _fromBalance, uint256 _toBalance, uint256 _amount ) external; /** * Set the cleanup block number. * Historic data for the blocks before `cleanupBlockNumber` can be erased, * history before that block should never be used since it can be inconsistent. * In particular, cleanup block number must be before current vote power block. * @param _blockNumber The new cleanup block number. */ function setCleanupBlockNumber(uint256 _blockNumber) external; /** * Set the contract that is allowed to call history cleaning methods. */ function setCleanerContract(address _cleanerContract) external; /** * @notice Get the token that this governance vote power contract belongs to. */ function ownerToken() external view returns (IVPToken); function getCleanupBlockNumber() external view returns(uint256); }
contracts/inflation/interface/IISupply.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IISupply { /** * @notice Updates circulating supply * @dev Also updates the burn address amount */ function updateCirculatingSupply() external; /** * @notice Updates authorized inflation and circulating supply - emits event if error * @param _inflationAuthorizedWei Authorized inflation * @dev Also updates the burn address amount */ function updateAuthorizedInflationAndCirculatingSupply(uint256 _inflationAuthorizedWei) external; /** * @notice Get approximate circulating supply for given block number from cache - only past block * @param _blockNumber Block number * @return _circulatingSupplyWei Return approximate circulating supply for last known block <= _blockNumber */ function getCirculatingSupplyAtCached(uint256 _blockNumber) external returns(uint256 _circulatingSupplyWei); /** * @notice Get approximate circulating supply for given block number * @param _blockNumber Block number * @return _circulatingSupplyWei Return approximate circulating supply for last known block <= _blockNumber */ function getCirculatingSupplyAt(uint256 _blockNumber) external view returns(uint256 _circulatingSupplyWei); /** * @notice Get total inflatable balance (initial genesis amount + total authorized inflation) * @return _inflatableBalanceWei Return inflatable balance */ function getInflatableBalance() external view returns(uint256 _inflatableBalanceWei); }
contracts/token/lib/CheckPointsByAddress.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "./CheckPointHistory.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; /** * @title Check Points By Address library * @notice A contract to manage checkpoint history for a collection of addresses. * @dev Store value history by address, and then by block number. **/ library CheckPointsByAddress { using SafeMath for uint256; using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; struct CheckPointsByAddressState { // `historyByAddress` is the map that stores the check point history of each address mapping(address => CheckPointHistory.CheckPointHistoryState) historyByAddress; } /** /** * @notice Send `amount` value to `to` address from `from` address. * @param _self A CheckPointsByAddressState instance to manage. * @param _from Address of the history of from values * @param _to Address of the history of to values * @param _amount The amount of value to be transferred **/ function transmit( CheckPointsByAddressState storage _self, address _from, address _to, uint256 _amount ) internal { // Shortcut if (_amount == 0) return; // Both from and to can never be zero assert(!(_from == address(0) && _to == address(0))); // Update transferer value if (_from != address(0)) { // Compute the new from balance uint256 newValueFrom = valueOfAtNow(_self, _from).sub(_amount); writeValue(_self, _from, newValueFrom); } // Update transferee value if (_to != address(0)) { // Compute the new to balance uint256 newValueTo = valueOfAtNow(_self, _to).add(_amount); writeValue(_self, _to, newValueTo); } } /** * @notice Queries the value of `_owner` at a specific `_blockNumber`. * @param _self A CheckPointsByAddressState instance to manage. * @param _owner The address from which the value will be retrieved. * @param _blockNumber The block number to query for the then current value. * @return The value at `_blockNumber` for `_owner`. **/ function valueOfAt( CheckPointsByAddressState storage _self, address _owner, uint256 _blockNumber ) internal view returns (uint256) { // Get history for _owner CheckPointHistory.CheckPointHistoryState storage history = _self.historyByAddress[_owner]; // Return value at given block return history.valueAt(_blockNumber); } /** * @notice Get the value of the `_owner` at the current `block.number`. * @param _self A CheckPointsByAddressState instance to manage. * @param _owner The address of the value is being requested. * @return The value of `_owner` at the current block. **/ function valueOfAtNow(CheckPointsByAddressState storage _self, address _owner) internal view returns (uint256) { // Get history for _owner CheckPointHistory.CheckPointHistoryState storage history = _self.historyByAddress[_owner]; // Return value at now return history.valueAtNow(); } /** * @notice Writes the `value` at the current block number for `_owner`. * @param _self A CheckPointsByAddressState instance to manage. * @param _owner The address of `_owner` to write. * @param _value The value to write. * @dev Sender must be the owner of the contract. **/ function writeValue( CheckPointsByAddressState storage _self, address _owner, uint256 _value ) internal { // Get history for _owner CheckPointHistory.CheckPointHistoryState storage history = _self.historyByAddress[_owner]; // Write the value history.writeValue(_value); } /** * Delete at most `_count` of the oldest checkpoints. * At least one checkpoint at or before `_cleanupBlockNumber` will remain * (unless the history was empty to start with). */ function cleanupOldCheckpoints( CheckPointsByAddressState storage _self, address _owner, uint256 _count, uint256 _cleanupBlockNumber ) internal returns (uint256) { if (_owner != address(0)) { return _self.historyByAddress[_owner].cleanupOldCheckpoints(_count, _cleanupBlockNumber); } return 0; } }
contracts/userInterfaces/IVPContractEvents.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IVPContractEvents { /** * Event triggered when an account delegates or undelegates another account. * Definition: `votePowerFromTo(from, to)` is `changed` from `priorVotePower` to `newVotePower`. * For undelegation, `newVotePower` is 0. * * Note: the event is always emitted from VPToken's `writeVotePowerContract`. */ event Delegate(address indexed from, address indexed to, uint256 priorVotePower, uint256 newVotePower); /** * Event triggered only when account `delegator` revokes delegation to `delegatee` * for a single block in the past (typically the current vote block). * * Note: the event is always emitted from VPToken's `writeVotePowerContract` and/or `readVotePowerContract`. */ event Revoke(address indexed delegator, address indexed delegatee, uint256 votePower, uint256 blockNumber); }
@openzeppelin/contracts/token/ERC20/IERC20.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Returns the amount of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the amount of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves `amount` tokens from the caller's account to `recipient`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address recipient, uint256 amount) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets `amount` as the allowance of `spender` over the caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 amount) external returns (bool); /** * @dev Moves `amount` tokens from `sender` to `recipient` using the * allowance mechanism. `amount` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom(address sender, address recipient, uint256 amount) external returns (bool); /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); }
contracts/userInterfaces/IVPToken.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IGovernanceVotePower} from "./IGovernanceVotePower.sol"; import {IVPContractEvents} from "./IVPContractEvents.sol"; interface IVPToken is IERC20 { /** * @notice Delegate by percentage `_bips` of voting power to `_to` from `msg.sender`. * @param _to The address of the recipient * @param _bips The percentage of voting power to be delegated expressed in basis points (1/100 of one percent). * Not cummulative - every call resets the delegation value (and value of 0 undelegates `to`). **/ function delegate(address _to, uint256 _bips) external; /** * @notice Undelegate all percentage delegations from teh sender and then delegate corresponding * `_bips` percentage of voting power from the sender to each member of `_delegatees`. * @param _delegatees The addresses of the new recipients. * @param _bips The percentages of voting power to be delegated expressed in basis points (1/100 of one percent). * Total of all `_bips` values must be at most 10000. **/ function batchDelegate(address[] memory _delegatees, uint256[] memory _bips) external; /** * @notice Explicitly delegate `_amount` of voting power to `_to` from `msg.sender`. * @param _to The address of the recipient * @param _amount An explicit vote power amount to be delegated. * Not cummulative - every call resets the delegation value (and value of 0 undelegates `to`). **/ function delegateExplicit(address _to, uint _amount) external; /** * @notice Revoke all delegation from sender to `_who` at given block. * Only affects the reads via `votePowerOfAtCached()` in the block `_blockNumber`. * Block `_blockNumber` must be in the past. * This method should be used only to prevent rogue delegate voting in the current voting block. * To stop delegating use delegate/delegateExplicit with value of 0 or undelegateAll/undelegateAllExplicit. * @param _who Address of the delegatee * @param _blockNumber The block number at which to revoke delegation. */ function revokeDelegationAt(address _who, uint _blockNumber) external; /** * @notice Undelegate all voting power for delegates of `msg.sender` * Can only be used with percentage delegation. * Does not reset delegation mode back to NOTSET. **/ function undelegateAll() external; /** * @notice Undelegate all explicit vote power by amount delegates for `msg.sender`. * Can only be used with explicit delegation. * Does not reset delegation mode back to NOTSET. * @param _delegateAddresses Explicit delegation does not store delegatees' addresses, * so the caller must supply them. * @return The amount still delegated (in case the list of delegates was incomplete). */ function undelegateAllExplicit(address[] memory _delegateAddresses) external returns (uint256); /** * @dev Should be compatible with ERC20 method */ function name() external view returns (string memory); /** * @dev Should be compatible with ERC20 method */ function symbol() external view returns (string memory); /** * @dev Should be compatible with ERC20 method */ function decimals() external view returns (uint8); /** * @notice Total amount of tokens at a specific `_blockNumber`. * @param _blockNumber The block number when the totalSupply is queried * @return The total amount of tokens at `_blockNumber` **/ function totalSupplyAt(uint _blockNumber) external view returns(uint256); /** * @dev Queries the token balance of `_owner` at a specific `_blockNumber`. * @param _owner The address from which the balance will be retrieved. * @param _blockNumber The block number when the balance is queried. * @return The balance at `_blockNumber`. **/ function balanceOfAt(address _owner, uint _blockNumber) external view returns (uint256); /** * @notice Get the current total vote power. * @return The current total vote power (sum of all accounts' vote powers). */ function totalVotePower() external view returns(uint256); /** * @notice Get the total vote power at block `_blockNumber` * @param _blockNumber The block number at which to fetch. * @return The total vote power at the block (sum of all accounts' vote powers). */ function totalVotePowerAt(uint _blockNumber) external view returns(uint256); /** * @notice Get the current vote power of `_owner`. * @param _owner The address to get voting power. * @return Current vote power of `_owner`. */ function votePowerOf(address _owner) external view returns(uint256); /** * @notice Get the vote power of `_owner` at block `_blockNumber` * @param _owner The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_owner` at `_blockNumber`. */ function votePowerOfAt(address _owner, uint256 _blockNumber) external view returns(uint256); /** * @notice Get the vote power of `_owner` at block `_blockNumber`, ignoring revocation information (and cache). * @param _owner The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_owner` at `_blockNumber`. Result doesn't change if vote power is revoked. */ function votePowerOfAtIgnoringRevocation(address _owner, uint256 _blockNumber) external view returns(uint256); /** * @notice Get the delegation mode for '_who'. This mode determines whether vote power is * allocated by percentage or by explicit value. Once the delegation mode is set, * it never changes, even if all delegations are removed. * @param _who The address to get delegation mode. * @return delegation mode: 0 = NOTSET, 1 = PERCENTAGE, 2 = AMOUNT (i.e. explicit) */ function delegationModeOf(address _who) external view returns(uint256); /** * @notice Get current delegated vote power `_from` delegator delegated `_to` delegatee. * @param _from Address of delegator * @param _to Address of delegatee * @return The delegated vote power. */ function votePowerFromTo(address _from, address _to) external view returns(uint256); /** * @notice Get delegated the vote power `_from` delegator delegated `_to` delegatee at `_blockNumber`. * @param _from Address of delegator * @param _to Address of delegatee * @param _blockNumber The block number at which to fetch. * @return The delegated vote power. */ function votePowerFromToAt(address _from, address _to, uint _blockNumber) external view returns(uint256); /** * @notice Compute the current undelegated vote power of `_owner` * @param _owner The address to get undelegated voting power. * @return The unallocated vote power of `_owner` */ function undelegatedVotePowerOf(address _owner) external view returns(uint256); /** * @notice Get the undelegated vote power of `_owner` at given block. * @param _owner The address to get undelegated voting power. * @param _blockNumber The block number at which to fetch. * @return The undelegated vote power of `_owner` (= owner's own balance minus all delegations from owner) */ function undelegatedVotePowerOfAt(address _owner, uint256 _blockNumber) external view returns(uint256); /** * @notice Get the vote power delegation `delegationAddresses` * and `_bips` of `_who`. Returned in two separate positional arrays. * @param _who The address to get delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOf(address _who) external view returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ); /** * @notice Get the vote power delegation `delegationAddresses` * and `pcts` of `_who`. Returned in two separate positional arrays. * @param _who The address to get delegations. * @param _blockNumber The block for which we want to know the delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOfAt(address _who, uint256 _blockNumber) external view returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ); /** * Returns VPContract used for readonly operations (view methods). * The only non-view method that might be called on it is `revokeDelegationAt`. * * @notice `readVotePowerContract` is almost always equal to `writeVotePowerContract` * except during upgrade from one VPContract to a new version (which should happen * rarely or never and will be anounced before). * * @notice You shouldn't call any methods on VPContract directly, all are exposed * via VPToken (and state changing methods are forbidden from direct calls). * This is the reason why this method returns `IVPContractEvents` - it should only be used * for listening to events (`Revoke` only). */ function readVotePowerContract() external view returns (IVPContractEvents); /** * Returns VPContract used for state changing operations (non-view methods). * The only non-view method that might be called on it is `revokeDelegationAt`. * * @notice `writeVotePowerContract` is almost always equal to `readVotePowerContract` * except during upgrade from one VPContract to a new version (which should happen * rarely or never and will be anounced before). In the case of upgrade, * `writeVotePowerContract` will be replaced first to establish delegations, and * after some perio (e.g. after a reward epoch ends) `readVotePowerContract` will be set equal to it. * * @notice You shouldn't call any methods on VPContract directly, all are exposed * via VPToken (and state changing methods are forbidden from direct calls). * This is the reason why this method returns `IVPContractEvents` - it should only be used * for listening to events (`Delegate` and `Revoke` only). */ function writeVotePowerContract() external view returns (IVPContractEvents); /** * When set, allows token owners to participate in governance voting * and delegate governance vote power. */ function governanceVotePower() external view returns (IGovernanceVotePower); }
contracts/utils/implementation/SafePct.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import {SafeMath} from "@openzeppelin/contracts/math/SafeMath.sol"; /** * @dev Compute percentages safely without phantom overflows. * * Intermediate operations can overflow even when the result will always * fit into computed type. Developers usually * assume that overflows raise errors. `SafePct` 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 SafePct { using SafeMath for uint256; /** * Requirements: * * - intermediate operations must revert on overflow */ function mulDiv(uint256 x, uint256 y, uint256 z) internal pure returns (uint256) { require(z > 0, "Division by zero"); if (x == 0) return 0; uint256 xy = x * y; if (xy / x == y) { // no overflow happened - same as in SafeMath mul return xy / z; } //slither-disable-next-line divide-before-multiply uint256 a = x / z; uint256 b = x % z; // x = a * z + b //slither-disable-next-line divide-before-multiply uint256 c = y / z; uint256 d = y % z; // y = c * z + d return (a.mul(c).mul(z)).add(a.mul(d)).add(b.mul(c)).add(b.mul(d).div(z)); } }
contracts/inflation/interface/IIInflationReceiver.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IIInflationReceiver { /** * Notify the receiver that it is entitled to receive `_toAuthorizeWei` inflation amount. * @param _toAuthorizeWei the amount of inflation that can be awarded in the coming day */ function setDailyAuthorizedInflation(uint256 _toAuthorizeWei) external; /** * Receive native tokens from inflation. */ function receiveInflation() external payable; /** * Inflation receivers have a reference to the Inflation contract. */ function getInflationAddress() external returns(address); /** * Implement this function for updating inflation receiver contracts through AddressUpdater. */ function getContractName() external view returns (string memory); }
contracts/token/lib/DelegationHistory.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "@openzeppelin/contracts/math/Math.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; import "@openzeppelin/contracts/utils/SafeCast.sol"; import "../../utils/implementation/SafePct.sol"; /** * @title DelegationHistory library * @notice A contract to manage checkpoints as of a given block. * @dev Store value history by block number with detachable state. **/ library DelegationHistory { using SafeMath for uint256; using SafePct for uint256; using SafeCast for uint256; uint256 public constant MAX_DELEGATES_BY_PERCENT = 2; string private constant MAX_DELEGATES_MSG = "Max delegates exceeded"; struct Delegation { address delegate; uint16 value; // delegations[0] will also hold length and blockNumber to save 1 slot of storage per checkpoint // for all other indexes these fields will be 0 // also, when checkpoint is empty, `length` will automatically be 0, which is ok uint64 fromBlock; uint8 length; // length is limited to MAX_DELEGATES_BY_PERCENT which fits in 8 bits } /** * @dev `CheckPoint` is the structure that attaches a block number to a * given value; the block number attached is the one that last changed the * value **/ struct CheckPoint { // the list of delegations at the time mapping(uint256 => Delegation) delegations; } struct CheckPointHistoryState { // `checkpoints` is an array that tracks delegations at non-contiguous block numbers mapping(uint256 => CheckPoint) checkpoints; // `checkpoints` before `startIndex` have been deleted // INVARIANT: checkpoints.length == 0 || startIndex < checkpoints.length (strict!) uint64 startIndex; uint64 length; } /** * @notice Queries the value at a specific `_blockNumber` * @param _self A CheckPointHistoryState instance to manage. * @param _delegate The delegate for which we need value. * @param _blockNumber The block number of the value active at that time * @return _value The value of the `_delegate` at `_blockNumber` **/ function valueOfAt( CheckPointHistoryState storage _self, address _delegate, uint256 _blockNumber ) internal view returns (uint256 _value) { (bool found, uint256 index) = _findGreatestBlockLessThan(_self, _blockNumber); if (!found) return 0; return _getValueForDelegate(_self.checkpoints[index], _delegate); } /** * @notice Queries the value at `block.number` * @param _self A CheckPointHistoryState instance to manage. * @param _delegate The delegate for which we need value. * @return _value The value at `block.number` **/ function valueOfAtNow( CheckPointHistoryState storage _self, address _delegate ) internal view returns (uint256 _value) { uint256 length = _self.length; if (length == 0) return 0; return _getValueForDelegate(_self.checkpoints[length - 1], _delegate); } /** * @notice Writes the value at the current block. * @param _self A CheckPointHistoryState instance to manage. * @param _delegate The delegate tu update. * @param _value The new value to set for this delegate (value `0` deletes `_delegate` from the list). **/ function writeValue( CheckPointHistoryState storage _self, address _delegate, uint256 _value ) internal { uint256 historyCount = _self.length; if (historyCount == 0) { // checkpoints array empty, push new CheckPoint if (_value != 0) { CheckPoint storage cp = _self.checkpoints[historyCount]; _self.length = SafeCast.toUint64(historyCount + 1); cp.delegations[0] = Delegation({ delegate: _delegate, value: _value.toUint16(), fromBlock: block.number.toUint64(), length: 1 }); } } else { // historyCount - 1 is safe, since historyCount != 0 CheckPoint storage lastCheckpoint = _self.checkpoints[historyCount - 1]; uint256 lastBlock = lastCheckpoint.delegations[0].fromBlock; // slither-disable-next-line incorrect-equality if (block.number == lastBlock) { // If last check point is the current block, just update _updateDelegates(lastCheckpoint, _delegate, _value); } else { // we should never have future blocks in history assert(block.number > lastBlock); // last check point block is before CheckPoint storage cp = _self.checkpoints[historyCount]; _self.length = SafeCast.toUint64(historyCount + 1); _copyAndUpdateDelegates(cp, lastCheckpoint, _delegate, _value); cp.delegations[0].fromBlock = block.number.toUint64(); } } } /** * Get all percentage delegations active at a time. * @param _self A CheckPointHistoryState instance to manage. * @param _blockNumber The block number to query. * @return _delegates The active percentage delegates at the time. * @return _values The delegates' values at the time. **/ function delegationsAt( CheckPointHistoryState storage _self, uint256 _blockNumber ) internal view returns ( address[] memory _delegates, uint256[] memory _values ) { (bool found, uint256 index) = _findGreatestBlockLessThan(_self, _blockNumber); if (!found) { return (new address[](0), new uint256[](0)); } // copy delegates and values to memory arrays // (to prevent caller updating the stored value) CheckPoint storage cp = _self.checkpoints[index]; uint256 length = cp.delegations[0].length; _delegates = new address[](length); _values = new uint256[](length); for (uint256 i = 0; i < length; i++) { Delegation storage dlg = cp.delegations[i]; _delegates[i] = dlg.delegate; _values[i] = dlg.value; } } /** * Get all percentage delegations active now. * @param _self A CheckPointHistoryState instance to manage. * @return _delegates The active percentage delegates. * @return _values The delegates' values. **/ function delegationsAtNow( CheckPointHistoryState storage _self ) internal view returns (address[] memory _delegates, uint256[] memory _values) { return delegationsAt(_self, block.number); } /** * Get all percentage delegations active now. * @param _self A CheckPointHistoryState instance to manage. * @return _length The number of delegations. * @return _delegations . **/ function delegationsAtNowRaw( CheckPointHistoryState storage _self ) internal view returns ( uint256 _length, mapping(uint256 => Delegation) storage _delegations ) { uint256 length = _self.length; if (length == 0) { return (0, _self.checkpoints[0].delegations); } CheckPoint storage cp = _self.checkpoints[length - 1]; return (cp.delegations[0].length, cp.delegations); } /** * Get the number of delegations. * @param _self A CheckPointHistoryState instance to query. * @param _blockNumber The block number to query. * @return _count Count of delegations at the time. **/ function countAt( CheckPointHistoryState storage _self, uint256 _blockNumber ) internal view returns (uint256 _count) { (bool found, uint256 index) = _findGreatestBlockLessThan(_self, _blockNumber); if (!found) return 0; return _self.checkpoints[index].delegations[0].length; } /** * Get the sum of all delegation values. * @param _self A CheckPointHistoryState instance to query. * @param _blockNumber The block number to query. * @return _total Total delegation value at the time. **/ function totalValueAt( CheckPointHistoryState storage _self, uint256 _blockNumber ) internal view returns (uint256 _total) { (bool found, uint256 index) = _findGreatestBlockLessThan(_self, _blockNumber); if (!found) return 0; CheckPoint storage cp = _self.checkpoints[index]; uint256 length = cp.delegations[0].length; _total = 0; for (uint256 i = 0; i < length; i++) { _total = _total.add(cp.delegations[i].value); } } /** * Get the sum of all delegation values. * @param _self A CheckPointHistoryState instance to query. * @return _total Total delegation value at the time. **/ function totalValueAtNow( CheckPointHistoryState storage _self ) internal view returns (uint256 _total) { return totalValueAt(_self, block.number); } /** * Get the sum of all delegation values, every one scaled by `_mul/_div`. * @param _self A CheckPointHistoryState instance to query. * @param _mul The multiplier. * @param _div The divisor. * @param _blockNumber The block number to query. * @return _total Total scaled delegation value at the time. **/ function scaledTotalValueAt( CheckPointHistoryState storage _self, uint256 _mul, uint256 _div, uint256 _blockNumber ) internal view returns (uint256 _total) { (bool found, uint256 index) = _findGreatestBlockLessThan(_self, _blockNumber); if (!found) return 0; CheckPoint storage cp = _self.checkpoints[index]; uint256 length = cp.delegations[0].length; _total = 0; for (uint256 i = 0; i < length; i++) { _total = _total.add(uint256(cp.delegations[i].value).mulDiv(_mul, _div)); } } /** * Clear all delegations at this moment. * @param _self A CheckPointHistoryState instance to manage. */ function clear(CheckPointHistoryState storage _self) internal { uint256 historyCount = _self.length; if (historyCount > 0) { // add an empty checkpoint CheckPoint storage cp = _self.checkpoints[historyCount]; _self.length = SafeCast.toUint64(historyCount + 1); // create empty checkpoint = only set fromBlock cp.delegations[0] = Delegation({ delegate: address(0), value: 0, fromBlock: block.number.toUint64(), length: 0 }); } } /** * Delete at most `_count` of the oldest checkpoints. * At least one checkpoint at or before `_cleanupBlockNumber` will remain * (unless the history was empty to start with). */ function cleanupOldCheckpoints( CheckPointHistoryState storage _self, uint256 _count, uint256 _cleanupBlockNumber ) internal returns (uint256) { if (_cleanupBlockNumber == 0) return 0; // optimization for when cleaning is not enabled uint256 length = _self.length; if (length == 0) return 0; uint256 startIndex = _self.startIndex; // length - 1 is safe, since length != 0 (check above) uint256 endIndex = Math.min(startIndex.add(_count), length - 1); // last element can never be deleted uint256 index = startIndex; // we can delete `checkpoint[index]` while the next checkpoint is at `_cleanupBlockNumber` or before while (index < endIndex && _self.checkpoints[index + 1].delegations[0].fromBlock <= _cleanupBlockNumber) { CheckPoint storage cp = _self.checkpoints[index]; uint256 cplength = cp.delegations[0].length; for (uint256 i = 0; i < cplength; i++) { delete cp.delegations[i]; } index++; } if (index > startIndex) { // index is the first not deleted index _self.startIndex = SafeCast.toUint64(index); } return index - startIndex; // safe: index = startIndex at start and increases in loop } ///////////////////////////////////////////////////////////////////////////////// // helper functions for writeValueAt function _copyAndUpdateDelegates( CheckPoint storage _cp, CheckPoint storage _orig, address _delegate, uint256 _value ) private { uint256 length = _orig.delegations[0].length; bool updated = false; uint256 newlength = 0; for (uint256 i = 0; i < length; i++) { Delegation memory origDlg = _orig.delegations[i]; if (origDlg.delegate == _delegate) { // copy delegate, but with new value newlength = _appendDelegate(_cp, origDlg.delegate, _value, newlength); updated = true; } else { // just copy the delegate with original value newlength = _appendDelegate(_cp, origDlg.delegate, origDlg.value, newlength); } } if (!updated) { // delegate is not in the original list, so add it newlength = _appendDelegate(_cp, _delegate, _value, newlength); } // safe - newlength <= length + 1 <= MAX_DELEGATES_BY_PERCENT _cp.delegations[0].length = uint8(newlength); } function _updateDelegates(CheckPoint storage _cp, address _delegate, uint256 _value) private { uint256 length = _cp.delegations[0].length; uint256 i = 0; while (i < length && _cp.delegations[i].delegate != _delegate) ++i; if (i < length) { if (_value != 0) { _cp.delegations[i].value = _value.toUint16(); } else { _deleteDelegate(_cp, i, length - 1); // length - 1 is safe: 0 <= i < length _cp.delegations[0].length = uint8(length - 1); } } else { uint256 newlength = _appendDelegate(_cp, _delegate, _value, length); _cp.delegations[0].length = uint8(newlength); // safe - length <= MAX_DELEGATES_BY_PERCENT } } function _appendDelegate(CheckPoint storage _cp, address _delegate, uint256 _value, uint256 _length) private returns (uint256) { if (_value != 0) { require(_length < MAX_DELEGATES_BY_PERCENT, MAX_DELEGATES_MSG); Delegation storage dlg = _cp.delegations[_length]; dlg.delegate = _delegate; dlg.value = _value.toUint16(); // for delegations[0], fromBlock and length are assigned outside return _length + 1; } return _length; } function _deleteDelegate(CheckPoint storage _cp, uint256 _index, uint256 _last) private { Delegation storage dlg = _cp.delegations[_index]; Delegation storage lastDlg = _cp.delegations[_last]; if (_index < _last) { dlg.delegate = lastDlg.delegate; dlg.value = lastDlg.value; } lastDlg.delegate = address(0); lastDlg.value = 0; } ///////////////////////////////////////////////////////////////////////////////// // helper functions for querying /** * @notice Binary search of _checkpoints array. * @param _checkpoints An array of CheckPoint to search. * @param _startIndex Smallest possible index to be returned. * @param _blockNumber The block number to search for. */ function _binarySearchGreatestBlockLessThan( mapping(uint256 => CheckPoint) storage _checkpoints, uint256 _startIndex, uint256 _endIndex, uint256 _blockNumber ) private view returns (uint256 _index) { // Binary search of the value by given block number in the array uint256 min = _startIndex; uint256 max = _endIndex.sub(1); while (max > min) { uint256 mid = (max.add(min).add(1)).div(2); if (_checkpoints[mid].delegations[0].fromBlock <= _blockNumber) { min = mid; } else { max = mid.sub(1); } } return min; } /** * @notice Binary search of _checkpoints array. Extra optimized for the common case when we are * searching for the last block. * @param _self The state to query. * @param _blockNumber The block number to search for. * @return _found true if value was found (only `false` if `_blockNumber` is before first * checkpoint or the checkpoint array is empty) * @return _index index of the newest block with number less than or equal `_blockNumber` */ function _findGreatestBlockLessThan( CheckPointHistoryState storage _self, uint256 _blockNumber ) private view returns ( bool _found, uint256 _index ) { uint256 startIndex = _self.startIndex; uint256 historyCount = _self.length; if (historyCount == 0) { _found = false; } else if (_blockNumber >= _self.checkpoints[historyCount - 1].delegations[0].fromBlock) { _found = true; _index = historyCount - 1; // safe, historyCount != 0 in this branch } else if (_blockNumber < _self.checkpoints[startIndex].delegations[0].fromBlock) { // reading data before `_startIndex` is only safe before first cleanup require(startIndex == 0, "DelegationHistory: reading from cleaned-up block"); _found = false; } else { _found = true; _index = _binarySearchGreatestBlockLessThan(_self.checkpoints, startIndex, historyCount, _blockNumber); } } /** * Find delegate and return its value or 0 if not found. */ function _getValueForDelegate(CheckPoint storage _cp, address _delegate) internal view returns (uint256) { uint256 length = _cp.delegations[0].length; for (uint256 i = 0; i < length; i++) { Delegation storage dlg = _cp.delegations[i]; if (dlg.delegate == _delegate) { return dlg.value; } } return 0; // _delegate not found } }
@openzeppelin/contracts/utils/SafeCast.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <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 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 < 2**128, "SafeCast: value doesn\'t fit in 128 bits"); return uint128(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 < 2**64, "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 < 2**32, "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 < 2**16, "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 < 2**8, "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 >= -2**127 && value < 2**127, "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 >= -2**63 && value < 2**63, "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 >= -2**31 && value < 2**31, "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 >= -2**15 && value < 2**15, "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 >= -2**7 && value < 2**7, "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) { require(value < 2**255, "SafeCast: value doesn't fit in an int256"); return int256(value); } }
contracts/tokenPools/interface/IITokenPool.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IITokenPool { /** * @notice Return token pool supply data * @return _lockedFundsWei Funds that are intentionally locked in the token pool * and not part of circulating supply * @return _totalInflationAuthorizedWei Total inflation authorized amount (wei) * @return _totalClaimedWei Total claimed amount (wei) */ function getTokenPoolSupplyData() external returns ( uint256 _lockedFundsWei, uint256 _totalInflationAuthorizedWei, uint256 _totalClaimedWei ); }
contracts/tokenPools/interface/IIFtsoRewardManager.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import "../../userInterfaces/IFtsoRewardManager.sol"; import "../interface/IITokenPool.sol"; import "../../inflation/interface/IIInflationReceiver.sol"; interface IIFtsoRewardManager is IFtsoRewardManager, IIInflationReceiver, IITokenPool { event DailyAuthorizedInflationSet(uint256 authorizedAmountWei); event InflationReceived(uint256 amountReceivedWei); event RewardsBurned(uint256 amountBurnedWei); function activate() external; function enableClaims() external; function deactivate() external; function closeExpiredRewardEpoch(uint256 _rewardEpochId) external; function distributeRewards( address[] memory addresses, uint256[] memory weights, uint256 totalWeight, uint256 epochId, address ftso, uint256 priceEpochDurationSeconds, uint256 currentRewardEpoch, uint256 priceEpochEndTime, uint256 votePowerBlock ) external; function accrueUnearnedRewards( uint256 epochId, uint256 priceEpochDurationSeconds, uint256 priceEpochEndTime ) external; function firstClaimableRewardEpoch() external view returns (uint256); /** * @notice Returns the information on unclaimed reward of `_dataProvider` for `_rewardEpoch` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing the data provider * @return _amount number representing the unclaimed amount * @return _weight number representing the share that has not yet been claimed */ function getUnclaimedReward( uint256 _rewardEpoch, address _dataProvider ) external view returns ( uint256 _amount, uint256 _weight ); }
contracts/userInterfaces/IFtso.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IFtso { enum PriceFinalizationType { // initial state NOT_FINALIZED, // median calculation used to find price WEIGHTED_MEDIAN, // low turnout - price calculated from median of trusted addresses TRUSTED_ADDRESSES, // low turnout + no votes from trusted addresses - price copied from previous epoch PREVIOUS_PRICE_COPIED, // price calculated from median of trusted addresses - triggered due to an exception TRUSTED_ADDRESSES_EXCEPTION, // previous price copied - triggered due to an exception PREVIOUS_PRICE_COPIED_EXCEPTION } event PriceRevealed( address indexed voter, uint256 indexed epochId, uint256 price, uint256 timestamp, uint256 votePowerNat, uint256 votePowerAsset ); event PriceFinalized( uint256 indexed epochId, uint256 price, bool rewardedFtso, uint256 lowRewardPrice, uint256 highRewardPrice, PriceFinalizationType finalizationType, uint256 timestamp ); event PriceEpochInitializedOnFtso( uint256 indexed epochId, uint256 endTime, uint256 timestamp ); event LowTurnout( uint256 indexed epochId, uint256 natTurnout, uint256 lowNatTurnoutThresholdBIPS, uint256 timestamp ); /** * @notice Returns if FTSO is active */ function active() external view returns (bool); /** * @notice Returns the FTSO symbol */ function symbol() external view returns (string memory); /** * @notice Returns current epoch id */ function getCurrentEpochId() external view returns (uint256); /** * @notice Returns id of the epoch which was opened for price submission at the specified timestamp * @param _timestamp Timestamp as seconds from unix epoch */ function getEpochId(uint256 _timestamp) external view returns (uint256); /** * @notice Returns random number of the specified epoch * @param _epochId Id of the epoch */ function getRandom(uint256 _epochId) external view returns (uint256); /** * @notice Returns asset price consented in specific epoch * @param _epochId Id of the epoch * @return Price in USD multiplied by ASSET_PRICE_USD_DECIMALS */ function getEpochPrice(uint256 _epochId) external view returns (uint256); /** * @notice Returns current epoch data * @return _epochId Current epoch id * @return _epochSubmitEndTime End time of the current epoch price submission as seconds from unix epoch * @return _epochRevealEndTime End time of the current epoch price reveal as seconds from unix epoch * @return _votePowerBlock Vote power block for the current epoch * @return _fallbackMode Current epoch in fallback mode - only votes from trusted addresses will be used * @dev half-closed intervals - end time not included */ function getPriceEpochData() external view returns ( uint256 _epochId, uint256 _epochSubmitEndTime, uint256 _epochRevealEndTime, uint256 _votePowerBlock, bool _fallbackMode ); /** * @notice Returns current epoch data * @return _firstEpochStartTs First epoch start timestamp * @return _submitPeriodSeconds Submit period in seconds * @return _revealPeriodSeconds Reveal period in seconds */ function getPriceEpochConfiguration() external view returns ( uint256 _firstEpochStartTs, uint256 _submitPeriodSeconds, uint256 _revealPeriodSeconds ); /** * @notice Returns asset price submitted by voter in specific epoch * @param _epochId Id of the epoch * @param _voter Address of the voter * @return Price in USD multiplied by ASSET_PRICE_USD_DECIMALS */ function getEpochPriceForVoter(uint256 _epochId, address _voter) external view returns (uint256); /** * @notice Returns current asset price * @return _price Price in USD multiplied by ASSET_PRICE_USD_DECIMALS * @return _timestamp Time when price was updated for the last time */ function getCurrentPrice() external view returns (uint256 _price, uint256 _timestamp); /** * @notice Returns current asset price details * @return _price Price in USD multiplied by ASSET_PRICE_USD_DECIMALS * @return _priceTimestamp Time when price was updated for the last time * @return _priceFinalizationType Finalization type when price was updated for the last time * @return _lastPriceEpochFinalizationTimestamp Time when last price epoch was finalized * @return _lastPriceEpochFinalizationType Finalization type of last finalized price epoch */ function getCurrentPriceDetails() external view returns ( uint256 _price, uint256 _priceTimestamp, PriceFinalizationType _priceFinalizationType, uint256 _lastPriceEpochFinalizationTimestamp, PriceFinalizationType _lastPriceEpochFinalizationType ); /** * @notice Returns current random number */ function getCurrentRandom() external view returns (uint256); }
contracts/userInterfaces/IFtsoManager.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import "../ftso/interface/IIFtso.sol"; import "../genesis/interface/IFtsoManagerGenesis.sol"; interface IFtsoManager is IFtsoManagerGenesis { event FtsoAdded(IIFtso ftso, bool add); event FallbackMode(bool fallbackMode); event FtsoFallbackMode(IIFtso ftso, bool fallbackMode); event RewardEpochFinalized(uint256 votepowerBlock, uint256 startBlock); event PriceEpochFinalized(address chosenFtso, uint256 rewardEpochId); event InitializingCurrentEpochStateForRevealFailed(IIFtso ftso, uint256 epochId); event FinalizingPriceEpochFailed(IIFtso ftso, uint256 epochId, IFtso.PriceFinalizationType failingType); event DistributingRewardsFailed(address ftso, uint256 epochId); event AccruingUnearnedRewardsFailed(uint256 epochId); function active() external view returns (bool); function getCurrentRewardEpoch() external view returns (uint256); function getRewardEpochVotePowerBlock(uint256 _rewardEpoch) external view returns (uint256); function getRewardEpochToExpireNext() external view returns (uint256); function getCurrentPriceEpochData() external view returns ( uint256 _priceEpochId, uint256 _priceEpochStartTimestamp, uint256 _priceEpochEndTimestamp, uint256 _priceEpochRevealEndTimestamp, uint256 _currentTimestamp ); function getFtsos() external view returns (IIFtso[] memory _ftsos); function getPriceEpochConfiguration() external view returns ( uint256 _firstPriceEpochStartTs, uint256 _priceEpochDurationSeconds, uint256 _revealEpochDurationSeconds ); function getRewardEpochConfiguration() external view returns ( uint256 _firstRewardEpochStartTs, uint256 _rewardEpochDurationSeconds ); function getFallbackMode() external view returns ( bool _fallbackMode, IIFtso[] memory _ftsos, bool[] memory _ftsoInFallbackMode ); }
contracts/addressUpdater/interface/IIAddressUpdatable.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IIAddressUpdatable { /** * @notice Updates contract addresses - should be called only from AddressUpdater contract * @param _contractNameHashes list of keccak256(abi.encode(...)) contract names * @param _contractAddresses list of contract addresses corresponding to the contract names */ function updateContractAddresses( bytes32[] memory _contractNameHashes, address[] memory _contractAddresses ) external; }
contracts/token/implementation/WNat.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "./VPToken.sol"; import "./VPContract.sol"; import "../../userInterfaces/IWNat.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; /** * @title Wrapped Native token * @notice Accept native token deposits and mint ERC20 WNAT (wrapped native) tokens 1-1. * @dev Attribution: https://rinkeby.etherscan.io/address/0xc778417e063141139fce010982780140aa0cd5ab#code */ contract WNat is VPToken, IWNat { using SafeMath for uint256; event Deposit(address indexed dst, uint amount); event Withdrawal(address indexed src, uint amount); /** * Construct an ERC20 token. */ constructor(address _governance, string memory _name, string memory _symbol) VPToken(_governance, _name, _symbol) { } receive() external payable { deposit(); } /** * @notice Withdraw WNAT from an owner and send native tokens to msg.sender given an allowance. * @param owner An address spending the Native tokens. * @param amount The amount to spend. * * Requirements: * * - `owner` must have a balance of at least `amount`. * - the caller must have allowance for `owners`'s tokens of at least * `amount`. */ function withdrawFrom(address owner, uint256 amount) external override { // Reduce senders allowance _approve(owner, msg.sender, allowance(owner, msg.sender).sub(amount, "allowance below zero")); // Burn the owners balance _burn(owner, amount); // Emit withdraw event emit Withdrawal(owner, amount); // Move value to sender (last statement, to prevent reentrancy) msg.sender.transfer(amount); } /** * @notice Deposit Native from msg.sender and mints WNAT ERC20 to recipient address. * @param recipient An address to receive minted WNAT. */ function depositTo(address recipient) external payable override { require(recipient != address(0), "Cannot deposit to zero address"); // Mint WNAT _mint(recipient, msg.value); // Emit deposit event emit Deposit(recipient, msg.value); } /** * @notice Deposit Native and mint wNat ERC20. */ function deposit() public payable override { // Mint WNAT _mint(msg.sender, msg.value); // Emit deposit event emit Deposit(msg.sender, msg.value); } /** * @notice Withdraw Native and burn WNAT ERC20. * @param amount The amount to withdraw. */ function withdraw(uint256 amount) external override { // Burn WNAT tokens _burn(msg.sender, amount); // Emit withdrawal event emit Withdrawal(msg.sender, amount); // Send Native to sender (last statement, to prevent reentrancy) msg.sender.transfer(amount); } }
contracts/token/implementation/VPToken.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "./CheckPointable.sol"; import "@openzeppelin/contracts/token/ERC20/ERC20.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; import "../../utils/implementation/SafePct.sol"; import "../../userInterfaces/IVPToken.sol"; import "../../userInterfaces/IVPContractEvents.sol"; import "../interface/IIVPToken.sol"; import "../interface/IIVPContract.sol"; import "../interface/IIGovernanceVotePower.sol"; import "../../userInterfaces/IGovernanceVotePower.sol"; import "../../governance/implementation/Governed.sol"; /** * @title Vote Power Token * @dev An ERC20 token to enable the holder to delegate voting power * equal 1-1 to their balance, with history tracking by block. **/ contract VPToken is IIVPToken, ERC20, CheckPointable, Governed { using SafeMath for uint256; using SafePct for uint256; // the VPContract to use for reading vote powers and delegations IIVPContract private readVpContract; // the VPContract to use for writing vote powers and delegations // normally same as `readVpContract` except during switch // when reading happens from the old and writing goes to the new VPContract IIVPContract private writeVpContract; // the contract to use for governance vote power and delegation // here only to properly update governance vp during transfers - // all actual operations go directly to governance vp contract IIGovernanceVotePower private governanceVP; // the contract that is allowed to set cleanupBlockNumber // usually this will be an instance of CleanupBlockNumberManager address public cleanupBlockNumberManager; /** * When true, the argument to `setWriteVpContract` must be a vpContract * with `isReplacement` set to `true`. To be used for creating the correct VPContract. */ bool public vpContractInitialized = false; /** * Event used to track history of VPToken -> VPContract / GovernanceVotePower * associations (e.g. by external cleaners). * @param _contractType 0 = read VPContract, 1 = write VPContract, 2 = governance vote power * @param _oldContractAddress vote power contract address before change * @param _newContractAddress vote power contract address after change */ event VotePowerContractChanged(uint256 _contractType, address _oldContractAddress, address _newContractAddress); constructor( address _governance, //slither-disable-next-line shadowing-local string memory _name, //slither-disable-next-line shadowing-local string memory _symbol ) Governed(_governance) ERC20(_name, _symbol) { /* empty block */ } /** * @dev Should be compatible with ERC20 method */ function name() public view override(ERC20, IVPToken) returns (string memory) { return ERC20.name(); } /** * @dev Should be compatible with ERC20 method */ function symbol() public view override(ERC20, IVPToken) returns (string memory) { return ERC20.symbol(); } /** * @dev Should be compatible with ERC20 method */ function decimals() public view override(ERC20, IVPToken) returns (uint8) { return ERC20.decimals(); } /** * @notice Total amount of tokens at a specific `_blockNumber`. * @param _blockNumber The block number when the totalSupply is queried * @return The total amount of tokens at `_blockNumber` **/ function totalSupplyAt(uint256 _blockNumber) public view override(CheckPointable, IVPToken) returns(uint256) { return CheckPointable.totalSupplyAt(_blockNumber); } /** * @dev Queries the token balance of `_owner` at a specific `_blockNumber`. * @param _owner The address from which the balance will be retrieved. * @param _blockNumber The block number when the balance is queried. * @return The balance at `_blockNumber`. **/ function balanceOfAt( address _owner, uint256 _blockNumber ) public view override(CheckPointable, IVPToken) returns (uint256) { return CheckPointable.balanceOfAt(_owner, _blockNumber); } /** * @notice Delegate `_bips` of voting power to `_to` from `msg.sender` * @param _to The address of the recipient * @param _bips The percentage of voting power to be delegated expressed in basis points (1/100 of one percent). * Not cummulative - every call resets the delegation value (and value of 0 revokes delegation). **/ function delegate(address _to, uint256 _bips) external override { // Get the current balance of sender and delegate by percentage _to recipient _checkWriteVpContract().delegate(msg.sender, _to, balanceOf(msg.sender), _bips); } /** * @notice Undelegate all percentage delegations from teh sender and then delegate corresponding * `_bips` percentage of voting power from the sender to each member of `_delegatees`. * @param _delegatees The addresses of the new recipients. * @param _bips The percentages of voting power to be delegated expressed in basis points (1/100 of one percent). * Total of all `_bips` values must be at most 10000. **/ function batchDelegate(address[] memory _delegatees, uint256[] memory _bips) external override { require(_delegatees.length == _bips.length, "Array length mismatch"); IIVPContract vpContract = _checkWriteVpContract(); uint256 balance = balanceOf(msg.sender); vpContract.undelegateAll(msg.sender, balance); for (uint256 i = 0; i < _delegatees.length; i++) { vpContract.delegate(msg.sender, _delegatees[i], balance, _bips[i]); } } /** * @notice Delegate `_amount` of voting power to `_to` from `msg.sender` * @param _to The address of the recipient * @param _amount An explicit vote power amount to be delegated. * Not cummulative - every call resets the delegation value (and value of 0 revokes delegation). **/ function delegateExplicit(address _to, uint256 _amount) external override { _checkWriteVpContract().delegateExplicit(msg.sender, _to, balanceOf(msg.sender), _amount); } /** * @notice Compute the current undelegated vote power of `_owner` * @param _owner The address to get undelegated voting power. * @return The unallocated vote power of `_owner` */ function undelegatedVotePowerOf(address _owner) external view override returns(uint256) { return _checkReadVpContract().undelegatedVotePowerOf(_owner, balanceOf(_owner)); } /** * @notice Get the undelegated vote power of `_owner` at given block. * @param _owner The address to get undelegated voting power. * @param _blockNumber The block number at which to fetch. * @return The unallocated vote power of `_owner` */ function undelegatedVotePowerOfAt(address _owner, uint256 _blockNumber) external view override returns (uint256) { return _checkReadVpContract() .undelegatedVotePowerOfAt(_owner, balanceOfAt(_owner, _blockNumber), _blockNumber); } /** * @notice Undelegate all voting power for delegates of `msg.sender` **/ function undelegateAll() external override { _checkWriteVpContract().undelegateAll(msg.sender, balanceOf(msg.sender)); } /** * @notice Undelegate all explicit vote power by amount delegates for `msg.sender`. * @param _delegateAddresses Explicit delegation does not store delegatees' addresses, * so the caller must supply them. * @return _remainingDelegation The amount still delegated (in case the list of delegates was incomplete). */ function undelegateAllExplicit( address[] memory _delegateAddresses ) external override returns (uint256 _remainingDelegation) { return _checkWriteVpContract().undelegateAllExplicit(msg.sender, _delegateAddresses); } /** * @notice Revoke all delegation from sender to `_who` at given block. * Only affects the reads via `votePowerOfAtCached()` in the block `_blockNumber`. * Block `_blockNumber` must be in the past. * This method should be used only to prevent rogue delegate voting in the current voting block. * To stop delegating use delegate/delegateExplicit with value of 0 or undelegateAll/undelegateAllExplicit. */ function revokeDelegationAt(address _who, uint256 _blockNumber) public override { IIVPContract writeVPC = writeVpContract; IIVPContract readVPC = readVpContract; if (address(writeVPC) != address(0)) { writeVPC.revokeDelegationAt(msg.sender, _who, balanceOfAt(msg.sender, _blockNumber), _blockNumber); } if (address(readVPC) != address(writeVPC) && address(readVPC) != address(0)) { try readVPC.revokeDelegationAt(msg.sender, _who, balanceOfAt(msg.sender, _blockNumber), _blockNumber) { } catch { // do nothing } } } /** * @notice Get current delegated vote power `_from` delegator delegated `_to` delegatee. * @param _from Address of delegator * @param _to Address of delegatee * @return votePower The delegated vote power. */ function votePowerFromTo( address _from, address _to ) external view override returns(uint256) { return _checkReadVpContract().votePowerFromTo(_from, _to, balanceOf(_from)); } /** * @notice Get delegated the vote power `_from` delegator delegated `_to` delegatee at `_blockNumber`. * @param _from Address of delegator * @param _to Address of delegatee * @param _blockNumber The block number at which to fetch. * @return The delegated vote power. */ function votePowerFromToAt( address _from, address _to, uint256 _blockNumber ) external view override returns(uint256) { return _checkReadVpContract().votePowerFromToAt(_from, _to, balanceOfAt(_from, _blockNumber), _blockNumber); } /** * @notice Get the current total vote power. * @return The current total vote power (sum of all accounts' vote powers). */ function totalVotePower() external view override returns(uint256) { return totalSupply(); } /** * @notice Get the total vote power at block `_blockNumber` * @param _blockNumber The block number at which to fetch. * @return The total vote power at the block (sum of all accounts' vote powers). */ function totalVotePowerAt(uint256 _blockNumber) external view override returns(uint256) { return totalSupplyAt(_blockNumber); } /** * @notice Get the total vote power at block `_blockNumber` using cache. * It tries to read the cached value and if not found, reads the actual value and stores it in cache. * Can only be used if `_blockNumber` is in the past, otherwise reverts. * @param _blockNumber The block number at which to fetch. * @return The total vote power at the block (sum of all accounts' vote powers). */ function totalVotePowerAtCached(uint256 _blockNumber) public override returns(uint256) { return _totalSupplyAtCached(_blockNumber); } /** * @notice Get the delegation mode for '_who'. This mode determines whether vote power is * allocated by percentage or by explicit value. Once the delegation mode is set, * it never changes, even if all delegations are removed. * @param _who The address to get delegation mode. * @return delegation mode: 0 = NOTSET, 1 = PERCENTAGE, 2 = AMOUNT (i.e. explicit) */ function delegationModeOf(address _who) external view override returns (uint256) { return _checkReadVpContract().delegationModeOf(_who); } /** * @notice Get the current vote power of `_owner`. * @param _owner The address to get voting power. * @return Current vote power of `_owner`. */ function votePowerOf(address _owner) external view override returns(uint256) { return _checkReadVpContract().votePowerOf(_owner); } /** * @notice Get the vote power of `_owner` at block `_blockNumber` * @param _owner The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_owner` at `_blockNumber`. */ function votePowerOfAt(address _owner, uint256 _blockNumber) external view override returns(uint256) { return _checkReadVpContract().votePowerOfAt(_owner, _blockNumber); } /** * @notice Get the vote power of `_owner` at block `_blockNumber`, ignoring revocation information (and cache). * @param _owner The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_owner` at `_blockNumber`. Result doesn't change if vote power is revoked. */ function votePowerOfAtIgnoringRevocation(address _owner, uint256 _blockNumber) external view override returns(uint256) { return _checkReadVpContract().votePowerOfAtIgnoringRevocation(_owner, _blockNumber); } /** * Return vote powers for several addresses in a batch. * @param _owners The list of addresses to fetch vote power of. * @param _blockNumber The block number at which to fetch. * @return A list of vote powers. */ function batchVotePowerOfAt( address[] memory _owners, uint256 _blockNumber ) external view override returns(uint256[] memory) { return _checkReadVpContract().batchVotePowerOfAt(_owners, _blockNumber); } /** * @notice Get the vote power of `_owner` at block `_blockNumber` using cache. * It tries to read the cached value and if not found, reads the actual value and stores it in cache. * Can only be used if _blockNumber is in the past, otherwise reverts. * @param _owner The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_owner` at `_blockNumber`. */ function votePowerOfAtCached(address _owner, uint256 _blockNumber) public override returns(uint256) { return _checkReadVpContract().votePowerOfAtCached(_owner, _blockNumber); } /** * @notice Get the vote power delegation `delegationAddresses` * and `_bips` of `_who`. Returned in two separate positional arrays. * @param _owner The address to get delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOf( address _owner ) external view override returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ) { return _checkReadVpContract().delegatesOf(_owner); } /** * @notice Get the vote power delegation `delegationAddresses` * and `pcts` of `_who`. Returned in two separate positional arrays. * @param _owner The address to get delegations. * @param _blockNumber The block for which we want to know the delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOfAt( address _owner, uint256 _blockNumber ) external view override returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ) { return _checkReadVpContract().delegatesOfAt(_owner, _blockNumber); } // Update vote power and balance checkpoints before balances are modified. This is implemented // in the _beforeTokenTransfer hook, which is executed for _mint, _burn, and _transfer operations. function _beforeTokenTransfer( address _from, address _to, uint256 _amount ) internal virtual override(ERC20) { require(_from != _to, "Cannot transfer to self"); uint256 fromBalance = _from != address(0) ? balanceOf(_from) : 0; uint256 toBalance = _to != address(0) ? balanceOf(_to) : 0; // update vote powers IIVPContract vpc = writeVpContract; if (address(vpc) != address(0)) { vpc.updateAtTokenTransfer(_from, _to, fromBalance, toBalance, _amount); } else if (!vpContractInitialized) { // transfers without vpcontract are allowed, but after they are made // any added vpcontract must have isReplacement set vpContractInitialized = true; } // update governance vote powers IIGovernanceVotePower gvp = governanceVP; if (address(gvp) != address(0)) { gvp.updateAtTokenTransfer(_from, _to, fromBalance, toBalance, _amount); } // update balance history _updateBalanceHistoryAtTransfer(_from, _to, _amount); } /** * Call from governance to set read VpContract on token, e.g. * `vpToken.setReadVpContract(new VPContract(vpToken))` * Read VPContract must be set before any of the VPToken delegation or vote power reading methods are called, * otherwise they will revert. * NOTE: If readVpContract differs from writeVpContract all reads will be "frozen" and will not reflect * changes (not even revokes; they may or may not reflect balance transfers). * @param _vpContract Read vote power contract to be used by this token. */ function setReadVpContract(IIVPContract _vpContract) external onlyGovernance { if (address(_vpContract) != address(0)) { require(address(_vpContract.ownerToken()) == address(this), "VPContract not owned by this token"); // set contract's cleanup block _vpContract.setCleanupBlockNumber(_cleanupBlockNumber()); } emit VotePowerContractChanged(0, address(readVpContract), address(_vpContract)); readVpContract = _vpContract; } /** * Call from governance to set write VpContract on token, e.g. * `vpToken.setWriteVpContract(new VPContract(vpToken))` * Write VPContract must be set before any of the VPToken delegation modifying methods are called, * otherwise they will revert. * @param _vpContract Write vote power contract to be used by this token. */ function setWriteVpContract(IIVPContract _vpContract) external onlyGovernance { if (address(_vpContract) != address(0)) { require(address(_vpContract.ownerToken()) == address(this), "VPContract not owned by this token"); require(!vpContractInitialized || _vpContract.isReplacement(), "VPContract not configured for replacement"); // set contract's cleanup block _vpContract.setCleanupBlockNumber(_cleanupBlockNumber()); // once a non-null vpcontract is set, every other has to have isReplacement flag set vpContractInitialized = true; } emit VotePowerContractChanged(1, address(writeVpContract), address(_vpContract)); writeVpContract = _vpContract; } /** * Return read vpContract, ensuring that it is not zero. */ function _checkReadVpContract() internal view returns (IIVPContract) { IIVPContract vpc = readVpContract; require(address(vpc) != address(0), "Token missing read VPContract"); return vpc; } /** * Return write vpContract, ensuring that it is not zero. */ function _checkWriteVpContract() internal view returns (IIVPContract) { IIVPContract vpc = writeVpContract; require(address(vpc) != address(0), "Token missing write VPContract"); return vpc; } /** * Return vpContract use for reading, may be zero. */ function _getReadVpContract() internal view returns (IIVPContract) { return readVpContract; } /** * Return vpContract use for writing, may be zero. */ function _getWriteVpContract() internal view returns (IIVPContract) { return writeVpContract; } /** * Returns VPContract event interface used for readonly operations (view methods). */ function readVotePowerContract() external view override returns (IVPContractEvents) { return readVpContract; } /** * Returns VPContract event interface used for state changing operations (non-view methods). */ function writeVotePowerContract() external view override returns (IVPContractEvents) { return writeVpContract; } /** * Set the cleanup block number. * Historic data for the blocks before `cleanupBlockNumber` can be erased, * history before that block should never be used since it can be inconsistent. * In particular, cleanup block number must be before current vote power block. * @param _blockNumber The new cleanup block number. */ function setCleanupBlockNumber(uint256 _blockNumber) external override { require(msg.sender == cleanupBlockNumberManager, "only cleanup block manager"); _setCleanupBlockNumber(_blockNumber); if (address(readVpContract) != address(0)) { readVpContract.setCleanupBlockNumber(_blockNumber); } if (address(writeVpContract) != address(0) && address(writeVpContract) != address(readVpContract)) { writeVpContract.setCleanupBlockNumber(_blockNumber); } if (address(governanceVP) != address(0)) { governanceVP.setCleanupBlockNumber(_blockNumber); } } /** * Get the current cleanup block number. */ function cleanupBlockNumber() external view override returns (uint256) { return _cleanupBlockNumber(); } /** * Set the contract that is allowed to set cleanupBlockNumber. * Usually this will be an instance of CleanupBlockNumberManager. */ function setCleanupBlockNumberManager(address _cleanupBlockNumberManager) external override onlyGovernance { cleanupBlockNumberManager = _cleanupBlockNumberManager; } /** * Set the contract that is allowed to call history cleaning methods. */ function setCleanerContract(address _cleanerContract) external override onlyGovernance { _setCleanerContract(_cleanerContract); if (address(readVpContract) != address(0)) { readVpContract.setCleanerContract(_cleanerContract); } if (address(writeVpContract) != address(0) && address(writeVpContract) != address(readVpContract)) { writeVpContract.setCleanerContract(_cleanerContract); } if (address(governanceVP) != address(0)) { governanceVP.setCleanerContract(_cleanerContract); } } /** * Sets new governance vote power contract that allows token owners to participate in governance voting * and delegate governance vote power. */ function setGovernanceVotePower(IIGovernanceVotePower _governanceVotePower) external override onlyGovernance { require(address(_governanceVotePower.ownerToken()) == address(this), "Governance vote power contract does not belong to this token."); emit VotePowerContractChanged(2, address(governanceVP), address(_governanceVotePower)); governanceVP = _governanceVotePower; } /** * When set, allows token owners to participate in governance voting * and delegate governance vote power. */ function governanceVotePower() external view override returns (IGovernanceVotePower) { return governanceVP; } }
@openzeppelin/contracts/utils/ReentrancyGuard.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.8.0; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuard { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; constructor () internal { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and make it call a * `private` function that does the actual work. */ modifier nonReentrant() { // On the first call to nonReentrant, _notEntered will be true require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; _; // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } }
contracts/utils/implementation/AddressSet.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; library AddressSet { struct State { address[] list; mapping (address => uint256) index; } function add(State storage _state, address _address) internal { if (_state.index[_address] != 0) return; _state.list.push(_address); _state.index[_address] = _state.list.length; } function remove(State storage _state, address _address) internal { uint256 position = _state.index[_address]; if (position == 0) return; if (position < _state.list.length) { _state.list[position - 1] = _state.list[_state.list.length - 1]; } _state.list.pop(); delete _state.index[_address]; } function addAll(State storage _state, address[] memory _addresses) internal { for (uint256 i = 0; i < _addresses.length; i++) { add(_state, _addresses[i]); } } function replaceAll(State storage _state, address[] memory _addresses) internal { clear(_state); addAll(_state, _addresses); } function clear(State storage _state) internal { while (_state.list.length > 0) { delete _state.index[_state.list[_state.list.length - 1]]; _state.list.pop(); } } }
contracts/token/lib/VotePower.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "./CheckPointHistory.sol"; import "./CheckPointsByAddress.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; /** * @title Vote power library * @notice A library to record delegate vote power balances by delegator * and delegatee. **/ library VotePower { using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; using CheckPointsByAddress for CheckPointsByAddress.CheckPointsByAddressState; using SafeMath for uint256; /** * @dev `VotePowerState` is state structure used by this library to manage vote * power amounts by delegator and it's delegates. */ struct VotePowerState { // `votePowerByAddress` is the map that tracks the voting power balance // of each address, by block. CheckPointsByAddress.CheckPointsByAddressState votePowerByAddress; } /** * @notice This modifier checks that both addresses are non-zero. * @param _delegator A delegator address. * @param _delegatee A delegatee address. */ modifier addressesNotZero(address _delegator, address _delegatee) { // Both addresses cannot be zero assert(!(_delegator == address(0) && _delegatee == address(0))); _; } /** * @notice Delegate vote power `_amount` to `_delegatee` address from `_delegator` address. * @param _delegator Delegator address * @param _delegatee Delegatee address * @param _amount The _amount of vote power to send from _delegator to _delegatee * @dev Amount recorded at the current block. **/ function delegate( VotePowerState storage _self, address _delegator, address _delegatee, uint256 _amount ) internal addressesNotZero(_delegator, _delegatee) { // Shortcut if (_amount == 0) { return; } // Transmit vote power _self.votePowerByAddress.transmit(_delegator, _delegatee, _amount); } /** * @notice Change the current vote power value. * @param _owner Address of vote power owner. * @param _add The amount to add to the vote power. * @param _sub The amount to subtract from the vote power. */ function changeValue( VotePowerState storage _self, address _owner, uint256 _add, uint256 _sub ) internal { assert(_owner != address(0)); if (_add == _sub) return; uint256 value = _self.votePowerByAddress.valueOfAtNow(_owner); value = value.add(_add).sub(_sub); _self.votePowerByAddress.writeValue(_owner, value); } /** * @notice Undelegate vote power `_amount` from `_delegatee` address * to `_delegator` address * @param _delegator Delegator address * @param _delegatee Delegatee address * @param _amount The amount of vote power recovered by delegator from delegatee **/ function undelegate( VotePowerState storage _self, address _delegator, address _delegatee, uint256 _amount ) internal addressesNotZero(_delegator, _delegatee) { // Shortcut if (_amount == 0) { return; } // Recover vote power _self.votePowerByAddress.transmit(_delegatee, _delegator, _amount); } /** * Delete at most `_count` of the oldest checkpoints. * At least one checkpoint at or before `_cleanupBlockNumber` will remain * (unless the history was empty to start with). */ function cleanupOldCheckpoints( VotePowerState storage _self, address _owner, uint256 _count, uint256 _cleanupBlockNumber ) internal returns (uint256) { return _self.votePowerByAddress.cleanupOldCheckpoints(_owner, _count, _cleanupBlockNumber); } /** * @notice Get the vote power of `_who` at `_blockNumber`. * @param _self A VotePowerState instance to manage. * @param _who Address to get vote power. * @param _blockNumber Block number of the block to fetch vote power. * @return _votePower The fetched vote power. */ function votePowerOfAt( VotePowerState storage _self, address _who, uint256 _blockNumber ) internal view returns(uint256 _votePower) { return _self.votePowerByAddress.valueOfAt(_who, _blockNumber); } /** * @notice Get the current vote power of `_who`. * @param _self A VotePowerState instance to manage. * @param _who Address to get vote power. * @return _votePower The fetched vote power. */ function votePowerOfAtNow( VotePowerState storage _self, address _who ) internal view returns(uint256 _votePower) { return _self.votePowerByAddress.valueOfAtNow(_who); } }
contracts/governance/implementation/GovernedBase.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "../../userInterfaces/IGovernanceSettings.sol"; /** * @title Governed Base * @notice This abstract base class defines behaviors for a governed contract. * @dev This class is abstract so that specific behaviors can be defined for the constructor. * Contracts should not be left ungoverned, but not all contract will have a constructor * (for example those pre-defined in genesis). **/ abstract contract GovernedBase { struct TimelockedCall { uint256 allowedAfterTimestamp; bytes encodedCall; } // solhint-disable-next-line const-name-snakecase IGovernanceSettings public constant governanceSettings = IGovernanceSettings(0x1000000000000000000000000000000000000007); address private initialGovernance; bool private initialised; bool public productionMode; bool private executing; mapping(bytes4 => TimelockedCall) public timelockedCalls; event GovernanceCallTimelocked(bytes4 selector, uint256 allowedAfterTimestamp, bytes encodedCall); event TimelockedGovernanceCallExecuted(bytes4 selector, uint256 timestamp); event TimelockedGovernanceCallCanceled(bytes4 selector, uint256 timestamp); event GovernanceInitialised(address initialGovernance); event GovernedProductionModeEntered(address governanceSettings); modifier onlyGovernance { if (executing || !productionMode) { _beforeExecute(); _; } else { _recordTimelockedCall(msg.data); } } modifier onlyImmediateGovernance () { _checkOnlyGovernance(); _; } constructor(address _initialGovernance) { if (_initialGovernance != address(0)) { initialise(_initialGovernance); } } /** * @notice Execute the timelocked governance calls once the timelock period expires. * @dev Only executor can call this method. * @param _selector The method selector (only one timelocked call per method is stored). */ function executeGovernanceCall(bytes4 _selector) external { require(governanceSettings.isExecutor(msg.sender), "only executor"); TimelockedCall storage call = timelockedCalls[_selector]; require(call.allowedAfterTimestamp != 0, "timelock: invalid selector"); require(block.timestamp >= call.allowedAfterTimestamp, "timelock: not allowed yet"); bytes memory encodedCall = call.encodedCall; delete timelockedCalls[_selector]; executing = true; //solhint-disable-next-line avoid-low-level-calls (bool success,) = address(this).call(encodedCall); executing = false; emit TimelockedGovernanceCallExecuted(_selector, block.timestamp); _passReturnOrRevert(success); } /** * Cancel a timelocked governance call before it has been executed. * @dev Only governance can call this method. * @param _selector The method selector. */ function cancelGovernanceCall(bytes4 _selector) external onlyImmediateGovernance { require(timelockedCalls[_selector].allowedAfterTimestamp != 0, "timelock: invalid selector"); emit TimelockedGovernanceCallCanceled(_selector, block.timestamp); delete timelockedCalls[_selector]; } /** * Enter the production mode after all the initial governance settings have been set. * This enables timelocks and the governance is afterwards obtained by calling * governanceSettings.getGovernanceAddress(). */ function switchToProductionMode() external { _checkOnlyGovernance(); require(!productionMode, "already in production mode"); initialGovernance = address(0); productionMode = true; emit GovernedProductionModeEntered(address(governanceSettings)); } /** * @notice Initialize the governance address if not first initialized. */ function initialise(address _initialGovernance) public virtual { require(initialised == false, "initialised != false"); initialised = true; initialGovernance = _initialGovernance; emit GovernanceInitialised(_initialGovernance); } /** * Returns the current effective governance address. */ function governance() public view returns (address) { return productionMode ? governanceSettings.getGovernanceAddress() : initialGovernance; } function _beforeExecute() private { if (executing) { // can only be run from executeGovernanceCall(), where we check that only executor can call // make sure nothing else gets executed, even in case of reentrancy assert(msg.sender == address(this)); executing = false; } else { // must be called with: productionMode=false // must check governance in this case _checkOnlyGovernance(); } } function _recordTimelockedCall(bytes calldata _data) private { _checkOnlyGovernance(); bytes4 selector; //solhint-disable-next-line no-inline-assembly assembly { selector := calldataload(_data.offset) } uint256 timelock = governanceSettings.getTimelock(); uint256 allowedAt = block.timestamp + timelock; timelockedCalls[selector] = TimelockedCall({ allowedAfterTimestamp: allowedAt, encodedCall: _data }); emit GovernanceCallTimelocked(selector, allowedAt, _data); } function _checkOnlyGovernance() private view { require(msg.sender == governance(), "only governance"); } function _passReturnOrRevert(bool _success) private pure { // pass exact return or revert data - needs to be done in assembly //solhint-disable-next-line no-inline-assembly assembly { let size := returndatasize() let ptr := mload(0x40) mstore(0x40, add(ptr, size)) returndatacopy(ptr, 0, size) if _success { return(ptr, size) } revert(ptr, size) } } }
contracts/token/lib/ExplicitDelegation.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "./CheckPointsByAddress.sol"; import "./CheckPointHistory.sol"; import "@openzeppelin/contracts/math/SafeMath.sol"; import "../../utils/implementation/SafePct.sol"; /** * @title ExplicitDelegation library * @notice A library to manage a group of delegates for allocating voting power by a delegator. **/ library ExplicitDelegation { using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; using CheckPointsByAddress for CheckPointsByAddress.CheckPointsByAddressState; using SafeMath for uint256; using SafePct for uint256; /** * @dev `DelegationState` is the state structure used by this library to contain/manage * a grouing of delegates (a ExplicitDelegation) for a delegator. */ struct DelegationState { CheckPointHistory.CheckPointHistoryState delegatedTotal; // `delegatedVotePower` is a map of delegators pointing to a map of delegates // containing a checkpoint history of delegated vote power balances. CheckPointsByAddress.CheckPointsByAddressState delegatedVotePower; } /** * @notice Add or replace an existing _delegate with new vote power (explicit). * @param _self A DelegationState instance to manage. * @param _delegate The address of the _delegate to add/replace * @param _amount Allocation of the delegation as explicit amount */ function addReplaceDelegate( DelegationState storage _self, address _delegate, uint256 _amount ) internal { uint256 prevAmount = _self.delegatedVotePower.valueOfAtNow(_delegate); uint256 newTotal = _self.delegatedTotal.valueAtNow().sub(prevAmount, "Total < 0").add(_amount); _self.delegatedVotePower.writeValue(_delegate, _amount); _self.delegatedTotal.writeValue(newTotal); } /** * Delete at most `_count` of the oldest checkpoints. * At least one checkpoint at or before `_cleanupBlockNumber` will remain * (unless the history was empty to start with). */ function cleanupOldCheckpoints( DelegationState storage _self, address _owner, uint256 _count, uint256 _cleanupBlockNumber ) internal returns(uint256 _deleted) { _deleted = _self.delegatedTotal.cleanupOldCheckpoints(_count, _cleanupBlockNumber); // safe: cleanupOldCheckpoints always returns the number of deleted elements which is small, so no owerflow _deleted += _self.delegatedVotePower.cleanupOldCheckpoints(_owner, _count, _cleanupBlockNumber); } /** * @notice Get the _total of the explicit vote power delegation amount. * @param _self A DelegationState instance to manage. * @param _blockNumber The block to query. * @return _total The _total vote power amount delegated. */ function getDelegatedTotalAt( DelegationState storage _self, uint256 _blockNumber ) internal view returns (uint256 _total) { return _self.delegatedTotal.valueAt(_blockNumber); } /** * @notice Get the _total of the explicit vote power delegation amount. * @param _self A DelegationState instance to manage. * @return _total The total vote power amount delegated. */ function getDelegatedTotal( DelegationState storage _self ) internal view returns (uint256 _total) { return _self.delegatedTotal.valueAtNow(); } /** * @notice Given a delegate address, return the explicit amount of the vote power delegation. * @param _self A DelegationState instance to manage. * @param _delegate The _delegate address to find. * @param _blockNumber The block to query. * @return _value The percent of vote power allocated to the _delegate address. */ function getDelegatedValueAt( DelegationState storage _self, address _delegate, uint256 _blockNumber ) internal view returns (uint256 _value) { return _self.delegatedVotePower.valueOfAt(_delegate, _blockNumber); } /** * @notice Given a delegate address, return the explicit amount of the vote power delegation. * @param _self A DelegationState instance to manage. * @param _delegate The _delegate address to find. * @return _value The percent of vote power allocated to the _delegate address. */ function getDelegatedValue( DelegationState storage _self, address _delegate ) internal view returns (uint256 _value) { return _self.delegatedVotePower.valueOfAtNow(_delegate); } }
contracts/token/interface/IIVPContract.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import "../../userInterfaces/IVPToken.sol"; import "../../userInterfaces/IVPContractEvents.sol"; import "./IICleanable.sol"; interface IIVPContract is IICleanable, IVPContractEvents { /** * Update vote powers when tokens are transfered. * Also update delegated vote powers for percentage delegation * and check for enough funds for explicit delegations. **/ function updateAtTokenTransfer( address _from, address _to, uint256 _fromBalance, uint256 _toBalance, uint256 _amount ) external; /** * @notice Delegate `_bips` percentage of voting power to `_to` from `_from` * @param _from The address of the delegator * @param _to The address of the recipient * @param _balance The delegator's current balance * @param _bips The percentage of voting power to be delegated expressed in basis points (1/100 of one percent). * Not cummulative - every call resets the delegation value (and value of 0 revokes delegation). **/ function delegate( address _from, address _to, uint256 _balance, uint256 _bips ) external; /** * @notice Explicitly delegate `_amount` of voting power to `_to` from `msg.sender`. * @param _from The address of the delegator * @param _to The address of the recipient * @param _balance The delegator's current balance * @param _amount An explicit vote power amount to be delegated. * Not cummulative - every call resets the delegation value (and value of 0 undelegates `to`). **/ function delegateExplicit( address _from, address _to, uint256 _balance, uint _amount ) external; /** * @notice Revoke all delegation from sender to `_who` at given block. * Only affects the reads via `votePowerOfAtCached()` in the block `_blockNumber`. * Block `_blockNumber` must be in the past. * This method should be used only to prevent rogue delegate voting in the current voting block. * To stop delegating use delegate/delegateExplicit with value of 0 or undelegateAll/undelegateAllExplicit. * @param _from The address of the delegator * @param _who Address of the delegatee * @param _balance The delegator's current balance * @param _blockNumber The block number at which to revoke delegation. **/ function revokeDelegationAt( address _from, address _who, uint256 _balance, uint _blockNumber ) external; /** * @notice Undelegate all voting power for delegates of `msg.sender` * Can only be used with percentage delegation. * Does not reset delegation mode back to NOTSET. * @param _from The address of the delegator **/ function undelegateAll( address _from, uint256 _balance ) external; /** * @notice Undelegate all explicit vote power by amount delegates for `msg.sender`. * Can only be used with explicit delegation. * Does not reset delegation mode back to NOTSET. * @param _from The address of the delegator * @param _delegateAddresses Explicit delegation does not store delegatees' addresses, * so the caller must supply them. * @return The amount still delegated (in case the list of delegates was incomplete). */ function undelegateAllExplicit( address _from, address[] memory _delegateAddresses ) external returns (uint256); /** * @notice Get the vote power of `_who` at block `_blockNumber` * Reads/updates cache and upholds revocations. * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. */ function votePowerOfAtCached(address _who, uint256 _blockNumber) external returns(uint256); /** * @notice Get the current vote power of `_who`. * @param _who The address to get voting power. * @return Current vote power of `_who`. */ function votePowerOf(address _who) external view returns(uint256); /** * @notice Get the vote power of `_who` at block `_blockNumber` * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. */ function votePowerOfAt(address _who, uint256 _blockNumber) external view returns(uint256); /** * @notice Get the vote power of `_who` at block `_blockNumber`, ignoring revocation information (and cache). * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. Result doesn't change if vote power is revoked. */ function votePowerOfAtIgnoringRevocation(address _who, uint256 _blockNumber) external view returns(uint256); /** * Return vote powers for several addresses in a batch. * @param _owners The list of addresses to fetch vote power of. * @param _blockNumber The block number at which to fetch. * @return A list of vote powers. */ function batchVotePowerOfAt( address[] memory _owners, uint256 _blockNumber ) external view returns(uint256[] memory); /** * @notice Get current delegated vote power `_from` delegator delegated `_to` delegatee. * @param _from Address of delegator * @param _to Address of delegatee * @param _balance The delegator's current balance * @return The delegated vote power. */ function votePowerFromTo( address _from, address _to, uint256 _balance ) external view returns(uint256); /** * @notice Get delegated the vote power `_from` delegator delegated `_to` delegatee at `_blockNumber`. * @param _from Address of delegator * @param _to Address of delegatee * @param _balance The delegator's current balance * @param _blockNumber The block number at which to fetch. * @return The delegated vote power. */ function votePowerFromToAt( address _from, address _to, uint256 _balance, uint _blockNumber ) external view returns(uint256); /** * @notice Compute the current undelegated vote power of `_owner` * @param _owner The address to get undelegated voting power. * @param _balance Owner's current balance * @return The unallocated vote power of `_owner` */ function undelegatedVotePowerOf( address _owner, uint256 _balance ) external view returns(uint256); /** * @notice Get the undelegated vote power of `_owner` at given block. * @param _owner The address to get undelegated voting power. * @param _blockNumber The block number at which to fetch. * @return The undelegated vote power of `_owner` (= owner's own balance minus all delegations from owner) */ function undelegatedVotePowerOfAt( address _owner, uint256 _balance, uint256 _blockNumber ) external view returns(uint256); /** * @notice Get the delegation mode for '_who'. This mode determines whether vote power is * allocated by percentage or by explicit value. * @param _who The address to get delegation mode. * @return Delegation mode (NOTSET=0, PERCENTAGE=1, AMOUNT=2)) */ function delegationModeOf(address _who) external view returns (uint256); /** * @notice Get the vote power delegation `_delegateAddresses` * and `pcts` of an `_owner`. Returned in two separate positional arrays. * @param _owner The address to get delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOf( address _owner ) external view returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ); /** * @notice Get the vote power delegation `delegationAddresses` * and `pcts` of an `_owner`. Returned in two separate positional arrays. * @param _owner The address to get delegations. * @param _blockNumber The block for which we want to know the delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOfAt( address _owner, uint256 _blockNumber ) external view returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ); /** * The VPToken (or some other contract) that owns this VPContract. * All state changing methods may be called only from this address. * This is because original msg.sender is sent in `_from` parameter * and we must be sure that it cannot be faked by directly calling VPContract. * Owner token is also used in case of replacement to recover vote powers from balances. */ function ownerToken() external view returns (IVPToken); /** * Return true if this IIVPContract is configured to be used as a replacement for other contract. * It means that vote powers are not necessarily correct at the initialization, therefore * every method that reads vote power must check whether it is initialized for that address and block. */ function isReplacement() external view returns (bool); }
@openzeppelin/contracts/math/Math.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.8.0; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a >= b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow, so we distribute return (a / 2) + (b / 2) + ((a % 2 + b % 2) / 2); } }
contracts/token/lib/CheckPointHistoryCache.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "@openzeppelin/contracts/math/SafeMath.sol"; import "./CheckPointHistory.sol"; library CheckPointHistoryCache { using SafeMath for uint256; using CheckPointHistory for CheckPointHistory.CheckPointHistoryState; struct CacheState { // mapping blockNumber => (value + 1) mapping(uint256 => uint256) cache; } function valueAt( CacheState storage _self, CheckPointHistory.CheckPointHistoryState storage _checkPointHistory, uint256 _blockNumber ) internal returns (uint256 _value, bool _cacheCreated) { // is it in cache? uint256 cachedValue = _self.cache[_blockNumber]; if (cachedValue != 0) { return (cachedValue - 1, false); // safe, cachedValue != 0 } // read from _checkPointHistory uint256 historyValue = _checkPointHistory.valueAt(_blockNumber); _self.cache[_blockNumber] = historyValue.add(1); // store to cache (add 1 to differentiate from empty) return (historyValue, true); } function deleteAt( CacheState storage _self, uint256 _blockNumber ) internal returns (uint256 _deleted) { if (_self.cache[_blockNumber] != 0) { _self.cache[_blockNumber] = 0; return 1; } return 0; } }
contracts/token/implementation/VPContract.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "@openzeppelin/contracts/math/SafeMath.sol"; import "../../governance/implementation/GovernedBase.sol"; import "./Delegatable.sol"; import "../interface/IIVPContract.sol"; import "../interface/IIVPToken.sol"; import "../../userInterfaces/IVPToken.sol"; contract VPContract is IIVPContract, Delegatable { using SafeMath for uint256; /** * The VPToken (or some other contract) that owns this VPContract. * All state changing methods may be called only from this address. * This is because original msg.sender is sent in `_from` parameter * and we must be sure that it cannot be faked by directly calling VPContract. * Owner token is also used in case of replacement to recover vote powers from balances. */ IVPToken public immutable override ownerToken; /** * Return true if this IIVPContract is configured to be used as a replacement for other contract. * It means that vote powers are not necessarily correct at the initialization, therefore * every method that reads vote power must check whether it is initialized for that address and block. */ bool public immutable override isReplacement; // The block number when vote power for an address was first set. // Reading vote power before this block would return incorrect result and must revert. mapping (address => uint256) private votePowerInitializationBlock; // Vote power cache for past blocks when vote power was not initialized. // Reading vote power at that block would return incorrect result, so cache must be set by some other means. // No need for revocation info, since there can be no delegations at such block. mapping (bytes32 => uint256) private uninitializedVotePowerCache; string constant private ALREADY_EXPLICIT_MSG = "Already delegated explicitly"; string constant private ALREADY_PERCENT_MSG = "Already delegated by percentage"; string constant internal VOTE_POWER_NOT_INITIALIZED = "Vote power not initialized"; /** * All external methods in VPContract can only be executed by the owner token. */ modifier onlyOwnerToken { require(msg.sender == address(ownerToken), "only owner token"); _; } modifier onlyPercent(address sender) { // If a delegate cannot be added by percentage, revert. require(_canDelegateByPct(sender), ALREADY_EXPLICIT_MSG); _; } modifier onlyExplicit(address sender) { // If a delegate cannot be added by explicit amount, revert. require(_canDelegateByAmount(sender), ALREADY_PERCENT_MSG); _; } /** * Construct VPContract for given VPToken. */ constructor(IVPToken _ownerToken, bool _isReplacement) { require(address(_ownerToken) != address(0), "VPContract must belong to a VPToken"); ownerToken = _ownerToken; isReplacement = _isReplacement; } /** * Set the cleanup block number. * Historic data for the blocks before `cleanupBlockNumber` can be erased, * history before that block should never be used since it can be inconsistent. * In particular, cleanup block number must be before current vote power block. * The method can be called only by the owner token. * @param _blockNumber The new cleanup block number. */ function setCleanupBlockNumber(uint256 _blockNumber) external override onlyOwnerToken { _setCleanupBlockNumber(_blockNumber); } /** * Set the contract that is allowed to call history cleaning methods. * The method can be called only by the owner token. */ function setCleanerContract(address _cleanerContract) external override onlyOwnerToken { _setCleanerContract(_cleanerContract); } /** * Update vote powers when tokens are transfered. * Also update delegated vote powers for percentage delegation * and check for enough funds for explicit delegations. **/ function updateAtTokenTransfer( address _from, address _to, uint256 _fromBalance, uint256 _toBalance, uint256 _amount ) external override onlyOwnerToken { if (_from == address(0)) { // mint new vote power _initializeVotePower(_to, _toBalance); _mintVotePower(_to, _toBalance, _amount); } else if (_to == address(0)) { // burn vote power _initializeVotePower(_from, _fromBalance); _burnVotePower(_from, _fromBalance, _amount); } else { // transmit vote power _to receiver _initializeVotePower(_from, _fromBalance); _initializeVotePower(_to, _toBalance); _transmitVotePower(_from, _to, _fromBalance, _toBalance, _amount); } } /** * @notice Delegate `_bips` percentage of voting power to `_to` from `_from` * @param _from The address of the delegator * @param _to The address of the recipient * @param _balance The delegator's current balance * @param _bips The percentage of voting power to be delegated expressed in basis points (1/100 of one percent). * Not cummulative - every call resets the delegation value (and value of 0 revokes delegation). **/ function delegate( address _from, address _to, uint256 _balance, uint256 _bips ) external override onlyOwnerToken onlyPercent(_from) { _initializeVotePower(_from, _balance); if (!_votePowerInitialized(_to)) { _initializeVotePower(_to, ownerToken.balanceOf(_to)); } _delegateByPercentage(_from, _to, _balance, _bips); } /** * @notice Explicitly delegate `_amount` of voting power to `_to` from `_from`. * @param _from The address of the delegator * @param _to The address of the recipient * @param _balance The delegator's current balance * @param _amount An explicit vote power amount to be delegated. * Not cummulative - every call resets the delegation value (and value of 0 undelegates `to`). **/ function delegateExplicit( address _from, address _to, uint256 _balance, uint _amount ) external override onlyOwnerToken onlyExplicit(_from) { _initializeVotePower(_from, _balance); if (!_votePowerInitialized(_to)) { _initializeVotePower(_to, ownerToken.balanceOf(_to)); } _delegateByAmount(_from, _to, _balance, _amount); } /** * @notice Revoke all delegation from `_from` to `_to` at given block. * Only affects the reads via `votePowerOfAtCached()` in the block `_blockNumber`. * Block `_blockNumber` must be in the past. * This method should be used only to prevent rogue delegate voting in the current voting block. * To stop delegating use delegate/delegateExplicit with value of 0 or undelegateAll/undelegateAllExplicit. * @param _from The address of the delegator * @param _to Address of the delegatee * @param _balance The delegator's current balance * @param _blockNumber The block number at which to revoke delegation. **/ function revokeDelegationAt( address _from, address _to, uint256 _balance, uint _blockNumber ) external override onlyOwnerToken { // ASSERT: if there was a delegation, _from and _to must be initialized if (!isReplacement || (_votePowerInitializedAt(_from, _blockNumber) && _votePowerInitializedAt(_to, _blockNumber))) { _revokeDelegationAt(_from, _to, _balance, _blockNumber); } } /** * @notice Undelegate all voting power for delegates of `_from` * Can only be used with percentage delegation. * Does not reset delegation mode back to NOTSET. * @param _from The address of the delegator **/ function undelegateAll( address _from, uint256 _balance ) external override onlyOwnerToken onlyPercent(_from) { if (_hasAnyDelegations(_from)) { // ASSERT: since there were delegations, _from and its targets must be initialized _undelegateAllByPercentage(_from, _balance); } } /** * @notice Undelegate all explicit vote power by amount delegates for `_from`. * Can only be used with explicit delegation. * Does not reset delegation mode back to NOTSET. * @param _from The address of the delegator * @param _delegateAddresses Explicit delegation does not store delegatees' addresses, * so the caller must supply them. * @return The amount still delegated (in case the list of delegates was incomplete). */ function undelegateAllExplicit( address _from, address[] memory _delegateAddresses ) external override onlyOwnerToken onlyExplicit(_from) returns (uint256) { if (_hasAnyDelegations(_from)) { // ASSERT: since there were delegations, _from and its targets must be initialized return _undelegateAllByAmount(_from, _delegateAddresses); } return 0; } /** * @notice Get the vote power of `_who` at block `_blockNumber` * Reads/updates cache and upholds revocations. * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. */ function votePowerOfAtCached(address _who, uint256 _blockNumber) external override returns(uint256) { if (!isReplacement || _votePowerInitializedAt(_who, _blockNumber)) { // use standard method return _votePowerOfAtCached(_who, _blockNumber); } else { // use uninitialized vote power cache bytes32 key = keccak256(abi.encode(_who, _blockNumber)); uint256 cached = uninitializedVotePowerCache[key]; if (cached != 0) { return cached - 1; // safe, cached != 0 } uint256 balance = ownerToken.balanceOfAt(_who, _blockNumber); uninitializedVotePowerCache[key] = balance.add(1); return balance; } } /** * Get the current cleanup block number. */ function cleanupBlockNumber() external view override returns (uint256) { return _cleanupBlockNumber(); } /** * @notice Get the current vote power of `_who`. * @param _who The address to get voting power. * @return Current vote power of `_who`. */ function votePowerOf(address _who) external view override returns(uint256) { if (_votePowerInitialized(_who)) { return _votePowerOf(_who); } else { return ownerToken.balanceOf(_who); } } /** * @notice Get the vote power of `_who` at block `_blockNumber` * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. */ function votePowerOfAt(address _who, uint256 _blockNumber) public view override returns(uint256) { if (!isReplacement || _votePowerInitializedAt(_who, _blockNumber)) { return _votePowerOfAt(_who, _blockNumber); } else { return ownerToken.balanceOfAt(_who, _blockNumber); } } /** * @notice Get the vote power of `_who` at block `_blockNumber`, ignoring revocation information (and cache). * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return Vote power of `_who` at `_blockNumber`. Result doesn't change if vote power is revoked. */ function votePowerOfAtIgnoringRevocation(address _who, uint256 _blockNumber) external view override returns(uint256) { if (!isReplacement || _votePowerInitializedAt(_who, _blockNumber)) { return _votePowerOfAtIgnoringRevocation(_who, _blockNumber); } else { return ownerToken.balanceOfAt(_who, _blockNumber); } } /** * Return vote powers for several addresses in a batch. * @param _owners The list of addresses to fetch vote power of. * @param _blockNumber The block number at which to fetch. * @return _votePowers A list of vote powers corresponding to _owners. */ function batchVotePowerOfAt( address[] memory _owners, uint256 _blockNumber ) external view override returns(uint256[] memory _votePowers) { _votePowers = _batchVotePowerOfAt(_owners, _blockNumber); // zero results might not have been initialized if (isReplacement) { for (uint256 i = 0; i < _votePowers.length; i++) { if (_votePowers[i] == 0 && !_votePowerInitializedAt(_owners[i], _blockNumber)) { _votePowers[i] = ownerToken.balanceOfAt(_owners[i], _blockNumber); } } } } /** * @notice Get current delegated vote power `_from` delegator delegated `_to` delegatee. * @param _from Address of delegator * @param _to Address of delegatee * @param _balance The delegator's current balance * @return The delegated vote power. */ function votePowerFromTo( address _from, address _to, uint256 _balance ) external view override returns (uint256) { // ASSERT: if the result is nonzero, _from and _to are initialized return _votePowerFromTo(_from, _to, _balance); } /** * @notice Get delegated the vote power `_from` delegator delegated `_to` delegatee at `_blockNumber`. * @param _from Address of delegator * @param _to Address of delegatee * @param _balance The delegator's current balance * @param _blockNumber The block number at which to fetch. * @return The delegated vote power. */ function votePowerFromToAt( address _from, address _to, uint256 _balance, uint _blockNumber ) external view override returns (uint256) { // ASSERT: if the result is nonzero, _from and _to were initialized at _blockNumber return _votePowerFromToAt(_from, _to, _balance, _blockNumber); } /** * @notice Get the delegation mode for '_who'. This mode determines whether vote power is * allocated by percentage or by explicit value. * @param _who The address to get delegation mode. * @return Delegation mode (NOTSET=0, PERCENTAGE=1, AMOUNT=2)) */ function delegationModeOf(address _who) external view override returns (uint256) { return uint256(_delegationModeOf(_who)); } /** * @notice Compute the current undelegated vote power of `_owner` * @param _owner The address to get undelegated voting power. * @param _balance Owner's current balance * @return The unallocated vote power of `_owner` */ function undelegatedVotePowerOf( address _owner, uint256 _balance ) external view override returns (uint256) { if (_votePowerInitialized(_owner)) { return _undelegatedVotePowerOf(_owner, _balance); } else { // ASSERT: there are no delegations return _balance; } } /** * @notice Get the undelegated vote power of `_owner` at given block. * @param _owner The address to get undelegated voting power. * @param _blockNumber The block number at which to fetch. * @return The undelegated vote power of `_owner` (= owner's own balance minus all delegations from owner) */ function undelegatedVotePowerOfAt( address _owner, uint256 _balance, uint256 _blockNumber ) external view override returns (uint256) { if (_votePowerInitialized(_owner)) { return _undelegatedVotePowerOfAt(_owner, _balance, _blockNumber); } else { // ASSERT: there were no delegations at _blockNumber return _balance; } } /** * @notice Get the vote power delegation `_delegateAddresses` * and `pcts` of an `_owner`. Returned in two separate positional arrays. * Also returns the count of delegates and delegation mode. * @param _owner The address to get delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOf(address _owner) external view override returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ) { // ASSERT: either _owner is initialized or there are no delegations return delegatesOfAt(_owner, block.number); } /** * @notice Get the vote power delegation `delegationAddresses` * and `_bips` of an `_owner`. Returned in two separate positional arrays. * Also returns the count of delegates and delegation mode. * @param _owner The address to get delegations. * @param _blockNumber The block for which we want to know the delegations. * @return _delegateAddresses Positional array of delegation addresses. * @return _bips Positional array of delegation percents specified in basis points (1/100 or 1 percent) * @return _count The number of delegates. * @return _delegationMode The mode of the delegation (NOTSET=0, PERCENTAGE=1, AMOUNT=2). */ function delegatesOfAt( address _owner, uint256 _blockNumber ) public view override returns ( address[] memory _delegateAddresses, uint256[] memory _bips, uint256 _count, uint256 _delegationMode ) { // ASSERT: either _owner was initialized or there were no delegations DelegationMode mode = _delegationModeOf(_owner); if (mode == DelegationMode.PERCENTAGE) { // Get the vote power delegation for the _owner (_delegateAddresses, _bips) = _percentageDelegatesOfAt(_owner, _blockNumber); } else if (mode == DelegationMode.NOTSET) { _delegateAddresses = new address[](0); _bips = new uint256[](0); } else { revert ("delegatesOf does not work in AMOUNT delegation mode"); } _count = _delegateAddresses.length; _delegationMode = uint256(mode); } /** * Initialize vote power to current balance if not initialized already. * @param _owner The address to initialize voting power. * @param _balance The owner's current balance. */ function _initializeVotePower(address _owner, uint256 _balance) internal { if (!isReplacement) return; if (_owner == address(0)) return; // 0 address is special (usually marks no source/dest - no init needed) if (votePowerInitializationBlock[_owner] == 0) { // consistency check - no delegations should be made from or to owner before vote power is initialized // (that would be dangerous, because vote power would have been delegated incorrectly) assert(_votePowerOf(_owner) == 0 && !_hasAnyDelegations(_owner)); _mintVotePower(_owner, 0, _balance); votePowerInitializationBlock[_owner] = block.number.add(1); } } /** * Has the vote power of `_owner` been initialized? * @param _owner The address to check. * @return true if vote power of _owner is initialized */ function _votePowerInitialized(address _owner) internal view returns (bool) { if (!isReplacement) return true; return votePowerInitializationBlock[_owner] != 0; } /** * Was vote power of `_owner` initialized at some block? * @param _owner The address to check. * @param _blockNumber The block for which we want to check. * @return true if vote power of _owner was initialized at _blockNumber */ function _votePowerInitializedAt(address _owner, uint256 _blockNumber) internal view returns (bool) { if (!isReplacement) return true; uint256 initblock = votePowerInitializationBlock[_owner]; return initblock != 0 && initblock - 1 <= _blockNumber; } }
contracts/userInterfaces/IGovernanceVotePower.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IGovernanceVotePower { /** * @notice Delegate all governance vote power of `msg.sender` to `_to`. * @param _to The address of the recipient **/ function delegate(address _to) external; /** * @notice Undelegate all governance vote power of `msg.sender``. **/ function undelegate() external; /** * @notice Get the governance vote power of `_who` at block `_blockNumber` * @param _who The address to get voting power. * @param _blockNumber The block number at which to fetch. * @return _votePower Governance vote power of `_who` at `_blockNumber`. */ function votePowerOfAt(address _who, uint256 _blockNumber) external view returns(uint256); /** * @notice Get the vote power of `account` at the current block. * @param account The address to get voting power. * @return Vote power of `account` at the current block number. */ function getVotes(address account) external view returns (uint256); /** * @notice Get the delegate's address of `_who` at block `_blockNumber` * @param _who The address to get delegate's address. * @param _blockNumber The block number at which to fetch. * @return Delegate's address of `_who` at `_blockNumber`. */ function getDelegateOfAt(address _who, uint256 _blockNumber) external view returns (address); /** * @notice Get the delegate's address of `_who` at the current block. * @param _who The address to get delegate's address. * @return Delegate's address of `_who` at the current block number. */ function getDelegateOfAtNow(address _who) external view returns (address); }
@openzeppelin/contracts/math/SafeMath.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.8.0; /** * @dev Wrappers over Solidity's arithmetic operations with added overflow * checks. * * Arithmetic operations in Solidity wrap on overflow. This can easily result * in bugs, because programmers usually assume that an overflow raises an * error, which is the standard behavior in high level programming languages. * `SafeMath` restores this intuition by reverting the transaction when 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. */ library SafeMath { /** * @dev Returns the addition of two unsigned integers, with an overflow flag. * * _Available since v3.4._ */ function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) { uint256 c = a + b; if (c < a) return (false, 0); return (true, c); } /** * @dev Returns the substraction of two unsigned integers, with an overflow flag. * * _Available since v3.4._ */ function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) { if (b > a) return (false, 0); return (true, a - b); } /** * @dev Returns the multiplication of two unsigned integers, with an overflow flag. * * _Available since v3.4._ */ function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) { // Gas optimization: this is cheaper than requiring 'a' not being zero, but the // benefit is lost if 'b' is also tested. // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522 if (a == 0) return (true, 0); uint256 c = a * b; if (c / a != b) return (false, 0); return (true, c); } /** * @dev Returns the division of two unsigned integers, with a division by zero flag. * * _Available since v3.4._ */ function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) { if (b == 0) return (false, 0); return (true, a / b); } /** * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag. * * _Available since v3.4._ */ function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) { if (b == 0) return (false, 0); return (true, a % b); } /** * @dev Returns the addition of two unsigned integers, reverting on * overflow. * * Counterpart to Solidity's `+` operator. * * Requirements: * * - Addition cannot overflow. */ function add(uint256 a, uint256 b) internal pure returns (uint256) { uint256 c = a + b; require(c >= a, "SafeMath: addition overflow"); return c; } /** * @dev Returns the subtraction of two unsigned integers, reverting on * overflow (when the result is negative). * * Counterpart to Solidity's `-` operator. * * Requirements: * * - Subtraction cannot overflow. */ function sub(uint256 a, uint256 b) internal pure returns (uint256) { require(b <= a, "SafeMath: subtraction overflow"); return a - b; } /** * @dev Returns the multiplication of two unsigned integers, reverting on * overflow. * * Counterpart to Solidity's `*` operator. * * Requirements: * * - Multiplication cannot overflow. */ function mul(uint256 a, uint256 b) internal pure returns (uint256) { if (a == 0) return 0; uint256 c = a * b; require(c / a == b, "SafeMath: multiplication overflow"); return c; } /** * @dev Returns the integer division of two unsigned integers, reverting on * division by zero. The result is rounded towards zero. * * Counterpart to Solidity's `/` operator. Note: this function uses a * `revert` opcode (which leaves remaining gas untouched) while Solidity * uses an invalid opcode to revert (consuming all remaining gas). * * Requirements: * * - The divisor cannot be zero. */ function div(uint256 a, uint256 b) internal pure returns (uint256) { require(b > 0, "SafeMath: division by zero"); return a / b; } /** * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo), * reverting when dividing by zero. * * Counterpart to Solidity's `%` operator. This function uses a `revert` * opcode (which leaves remaining gas untouched) while Solidity uses an * invalid opcode to revert (consuming all remaining gas). * * Requirements: * * - The divisor cannot be zero. */ function mod(uint256 a, uint256 b) internal pure returns (uint256) { require(b > 0, "SafeMath: modulo by zero"); return a % b; } /** * @dev Returns the subtraction of two unsigned integers, reverting with custom message on * overflow (when the result is negative). * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {trySub}. * * Counterpart to Solidity's `-` operator. * * Requirements: * * - Subtraction cannot overflow. */ function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) { require(b <= a, errorMessage); return a - b; } /** * @dev Returns the integer division of two unsigned integers, reverting with custom message on * division by zero. The result is rounded towards zero. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {tryDiv}. * * Counterpart to Solidity's `/` operator. Note: this function uses a * `revert` opcode (which leaves remaining gas untouched) while Solidity * uses an invalid opcode to revert (consuming all remaining gas). * * Requirements: * * - The divisor cannot be zero. */ function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) { require(b > 0, errorMessage); return a / b; } /** * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo), * reverting with custom message when dividing by zero. * * CAUTION: This function is deprecated because it requires allocating memory for the error * message unnecessarily. For custom revert reasons use {tryMod}. * * Counterpart to Solidity's `%` operator. This function uses a `revert` * opcode (which leaves remaining gas untouched) while Solidity uses an * invalid opcode to revert (consuming all remaining gas). * * Requirements: * * - The divisor cannot be zero. */ function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) { require(b > 0, errorMessage); return a % b; } }
contracts/ftso/interface/IIFtso.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; import "../../genesis/interface/IFtsoGenesis.sol"; import "../../userInterfaces/IFtso.sol"; import "../../token/interface/IIVPToken.sol"; interface IIFtso is IFtso, IFtsoGenesis { /// function finalizePriceReveal /// called by reward manager only on correct timing. /// if price reveal period for epoch x ended. finalize. /// iterate list of price submissions /// find weighted median /// find adjucant 50% of price submissions. /// Allocate reward for any price submission which is same as a "winning" submission function finalizePriceEpoch(uint256 _epochId, bool _returnRewardData) external returns( address[] memory _eligibleAddresses, uint256[] memory _natWeights, uint256 _totalNatWeight ); function fallbackFinalizePriceEpoch(uint256 _epochId) external; function forceFinalizePriceEpoch(uint256 _epochId) external; // activateFtso will be called by ftso manager once ftso is added // before this is done, FTSO can't run function activateFtso( uint256 _firstEpochStartTs, uint256 _submitPeriodSeconds, uint256 _revealPeriodSeconds ) external; function deactivateFtso() external; // update initial price and timestamp - only if not active function updateInitialPrice(uint256 _initialPriceUSD, uint256 _initialPriceTimestamp) external; function configureEpochs( uint256 _maxVotePowerNatThresholdFraction, uint256 _maxVotePowerAssetThresholdFraction, uint256 _lowAssetUSDThreshold, uint256 _highAssetUSDThreshold, uint256 _highAssetTurnoutThresholdBIPS, uint256 _lowNatTurnoutThresholdBIPS, address[] memory _trustedAddresses ) external; function setAsset(IIVPToken _asset) external; function setAssetFtsos(IIFtso[] memory _assetFtsos) external; // current vote power block will update per reward epoch. // the FTSO doesn't have notion of reward epochs. // reward manager only can set this data. function setVotePowerBlock(uint256 _blockNumber) external; function initializeCurrentEpochStateForReveal(uint256 _circulatingSupplyNat, bool _fallbackMode) external; /** * @notice Returns ftso manager address */ function ftsoManager() external view returns (address); /** * @notice Returns the FTSO asset * @dev Asset is null in case of multi-asset FTSO */ function getAsset() external view returns (IIVPToken); /** * @notice Returns the Asset FTSOs * @dev AssetFtsos is not null only in case of multi-asset FTSO */ function getAssetFtsos() external view returns (IIFtso[] memory); /** * @notice Returns current configuration of epoch state * @return _maxVotePowerNatThresholdFraction High threshold for native token vote power per voter * @return _maxVotePowerAssetThresholdFraction High threshold for asset vote power per voter * @return _lowAssetUSDThreshold Threshold for low asset vote power * @return _highAssetUSDThreshold Threshold for high asset vote power * @return _highAssetTurnoutThresholdBIPS Threshold for high asset turnout * @return _lowNatTurnoutThresholdBIPS Threshold for low nat turnout * @return _trustedAddresses Trusted addresses - use their prices if low nat turnout is not achieved */ function epochsConfiguration() external view returns ( uint256 _maxVotePowerNatThresholdFraction, uint256 _maxVotePowerAssetThresholdFraction, uint256 _lowAssetUSDThreshold, uint256 _highAssetUSDThreshold, uint256 _highAssetTurnoutThresholdBIPS, uint256 _lowNatTurnoutThresholdBIPS, address[] memory _trustedAddresses ); /** * @notice Returns parameters necessary for approximately replicating vote weighting. * @return _assets the list of Assets that are accounted in vote * @return _assetMultipliers weight of each asset in (multiasset) ftso, mutiplied by TERA * @return _totalVotePowerNat total native token vote power at block * @return _totalVotePowerAsset total combined asset vote power at block * @return _assetWeightRatio ratio of combined asset vp vs. native token vp (in BIPS) * @return _votePowerBlock vote powewr block for given epoch */ function getVoteWeightingParameters() external view returns ( IIVPToken[] memory _assets, uint256[] memory _assetMultipliers, uint256 _totalVotePowerNat, uint256 _totalVotePowerAsset, uint256 _assetWeightRatio, uint256 _votePowerBlock ); function wNat() external view returns (IIVPToken); /** * @notice Returns current asset price calculated from trusted providers * @return _price Price in USD multiplied by ASSET_PRICE_USD_DECIMALS * @return _timestamp Time when price was updated for the last time */ function getCurrentPriceFromTrustedProviders() external view returns (uint256 _price, uint256 _timestamp); }
@openzeppelin/contracts/token/ERC20/ERC20.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.6.0 <0.8.0; import "../../utils/Context.sol"; import "./IERC20.sol"; import "../../math/SafeMath.sol"; /** * @dev Implementation of the {IERC20} interface. * * This implementation is agnostic to the way tokens are created. This means * that a supply mechanism has to be added in a derived contract using {_mint}. * For a generic mechanism see {ERC20PresetMinterPauser}. * * TIP: For a detailed writeup see our guide * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How * to implement supply mechanisms]. * * We have followed general OpenZeppelin guidelines: functions revert instead * of returning `false` on failure. This behavior is nonetheless conventional * and does not conflict with the expectations of ERC20 applications. * * Additionally, an {Approval} event is emitted on calls to {transferFrom}. * This allows applications to reconstruct the allowance for all accounts just * by listening to said events. Other implementations of the EIP may not emit * these events, as it isn't required by the specification. * * Finally, the non-standard {decreaseAllowance} and {increaseAllowance} * functions have been added to mitigate the well-known issues around setting * allowances. See {IERC20-approve}. */ contract ERC20 is Context, IERC20 { using SafeMath for uint256; mapping (address => uint256) private _balances; mapping (address => mapping (address => uint256)) private _allowances; uint256 private _totalSupply; string private _name; string private _symbol; uint8 private _decimals; /** * @dev Sets the values for {name} and {symbol}, initializes {decimals} with * a default value of 18. * * To select a different value for {decimals}, use {_setupDecimals}. * * All three of these values are immutable: they can only be set once during * construction. */ constructor (string memory name_, string memory symbol_) public { _name = name_; _symbol = symbol_; _decimals = 18; } /** * @dev Returns the name of the token. */ function name() public view virtual returns (string memory) { return _name; } /** * @dev Returns the symbol of the token, usually a shorter version of the * name. */ function symbol() public view virtual returns (string memory) { return _symbol; } /** * @dev Returns the number of decimals used to get its user representation. * For example, if `decimals` equals `2`, a balance of `505` tokens should * be displayed to a user as `5,05` (`505 / 10 ** 2`). * * Tokens usually opt for a value of 18, imitating the relationship between * Ether and Wei. This is the value {ERC20} uses, unless {_setupDecimals} is * called. * * NOTE: This information is only used for _display_ purposes: it in * no way affects any of the arithmetic of the contract, including * {IERC20-balanceOf} and {IERC20-transfer}. */ function decimals() public view virtual returns (uint8) { return _decimals; } /** * @dev See {IERC20-totalSupply}. */ function totalSupply() public view virtual override returns (uint256) { return _totalSupply; } /** * @dev See {IERC20-balanceOf}. */ function balanceOf(address account) public view virtual override returns (uint256) { return _balances[account]; } /** * @dev See {IERC20-transfer}. * * Requirements: * * - `recipient` cannot be the zero address. * - the caller must have a balance of at least `amount`. */ function transfer(address recipient, uint256 amount) public virtual override returns (bool) { _transfer(_msgSender(), recipient, amount); return true; } /** * @dev See {IERC20-allowance}. */ function allowance(address owner, address spender) public view virtual override returns (uint256) { return _allowances[owner][spender]; } /** * @dev See {IERC20-approve}. * * Requirements: * * - `spender` cannot be the zero address. */ function approve(address spender, uint256 amount) public virtual override returns (bool) { _approve(_msgSender(), spender, amount); return true; } /** * @dev See {IERC20-transferFrom}. * * Emits an {Approval} event indicating the updated allowance. This is not * required by the EIP. See the note at the beginning of {ERC20}. * * Requirements: * * - `sender` and `recipient` cannot be the zero address. * - `sender` must have a balance of at least `amount`. * - the caller must have allowance for ``sender``'s tokens of at least * `amount`. */ function transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool) { _transfer(sender, recipient, amount); _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount, "ERC20: transfer amount exceeds allowance")); return true; } /** * @dev Atomically increases the allowance granted to `spender` by the caller. * * This is an alternative to {approve} that can be used as a mitigation for * problems described in {IERC20-approve}. * * Emits an {Approval} event indicating the updated allowance. * * Requirements: * * - `spender` cannot be the zero address. */ function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) { _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue)); return true; } /** * @dev Atomically decreases the allowance granted to `spender` by the caller. * * This is an alternative to {approve} that can be used as a mitigation for * problems described in {IERC20-approve}. * * Emits an {Approval} event indicating the updated allowance. * * Requirements: * * - `spender` cannot be the zero address. * - `spender` must have allowance for the caller of at least * `subtractedValue`. */ function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) { _approve(_msgSender(), spender, _allowances[_msgSender()][spender].sub(subtractedValue, "ERC20: decreased allowance below zero")); return true; } /** * @dev Moves tokens `amount` from `sender` to `recipient`. * * This is internal function is equivalent to {transfer}, and can be used to * e.g. implement automatic token fees, slashing mechanisms, etc. * * Emits a {Transfer} event. * * Requirements: * * - `sender` cannot be the zero address. * - `recipient` cannot be the zero address. * - `sender` must have a balance of at least `amount`. */ function _transfer(address sender, address recipient, uint256 amount) internal virtual { require(sender != address(0), "ERC20: transfer from the zero address"); require(recipient != address(0), "ERC20: transfer to the zero address"); _beforeTokenTransfer(sender, recipient, amount); _balances[sender] = _balances[sender].sub(amount, "ERC20: transfer amount exceeds balance"); _balances[recipient] = _balances[recipient].add(amount); emit Transfer(sender, recipient, amount); } /** @dev Creates `amount` tokens and assigns them to `account`, increasing * the total supply. * * Emits a {Transfer} event with `from` set to the zero address. * * Requirements: * * - `to` cannot be the zero address. */ function _mint(address account, uint256 amount) internal virtual { require(account != address(0), "ERC20: mint to the zero address"); _beforeTokenTransfer(address(0), account, amount); _totalSupply = _totalSupply.add(amount); _balances[account] = _balances[account].add(amount); emit Transfer(address(0), account, amount); } /** * @dev Destroys `amount` tokens from `account`, reducing the * total supply. * * Emits a {Transfer} event with `to` set to the zero address. * * Requirements: * * - `account` cannot be the zero address. * - `account` must have at least `amount` tokens. */ function _burn(address account, uint256 amount) internal virtual { require(account != address(0), "ERC20: burn from the zero address"); _beforeTokenTransfer(account, address(0), amount); _balances[account] = _balances[account].sub(amount, "ERC20: burn amount exceeds balance"); _totalSupply = _totalSupply.sub(amount); emit Transfer(account, address(0), amount); } /** * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens. * * This internal function is equivalent to `approve`, and can be used to * e.g. set automatic allowances for certain subsystems, etc. * * Emits an {Approval} event. * * Requirements: * * - `owner` cannot be the zero address. * - `spender` cannot be the zero address. */ function _approve(address owner, address spender, uint256 amount) internal virtual { require(owner != address(0), "ERC20: approve from the zero address"); require(spender != address(0), "ERC20: approve to the zero address"); _allowances[owner][spender] = amount; emit Approval(owner, spender, amount); } /** * @dev Sets {decimals} to a value other than the default one of 18. * * WARNING: This function should only be called from the constructor. Most * applications that interact with token contracts will not expect * {decimals} to ever change, and may work incorrectly if it does. */ function _setupDecimals(uint8 decimals_) internal virtual { _decimals = decimals_; } /** * @dev Hook that is called before any transfer of tokens. This includes * minting and burning. * * Calling conditions: * * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens * will be to transferred to `to`. * - when `from` is zero, `amount` tokens will be minted for `to`. * - when `to` is zero, `amount` of ``from``'s tokens will be burned. * - `from` and `to` are never both zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual { } }
contracts/genesis/interface/IFlareDaemonize.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; /// Any contracts that want to recieve a trigger from Flare daemon should /// implement IFlareDaemonize interface IFlareDaemonize { /// Implement this function for recieving a trigger from FlareDaemon. function daemonize() 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. /// @return true if switched to fallback mode, false if already in fallback mode or if falback not supported function switchToFallbackMode() external returns (bool); /// Implement this function for updating daemonized contracts through AddressUpdater. function getContractName() external view returns (string memory); }
contracts/tokenPools/lib/DataProviderFee.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; library DataProviderFee { struct FeePercentage { // used for storing data provider fee percentage settings uint16 value; // fee percentage value (value between 0 and 1e4) uint240 validFromEpoch; // id of the reward epoch from which the value is valid } struct State { uint256 feePercentageUpdateOffset; // fee percentage update timelock measured in reward epochs uint256 defaultFeePercentage; // default value for fee percentage mapping(address => FeePercentage[]) dataProviderFeePercentages; } uint256 constant internal MAX_BIPS = 1e4; string internal constant ERR_FEE_PERCENTAGE_INVALID = "invalid fee percentage value"; string internal constant ERR_FEE_PERCENTAGE_UPDATE_FAILED = "fee percentage can not be updated"; /** * @notice Allows data provider to set (or update last) fee percentage. * @param _feePercentageBIPS number representing fee percentage in BIPS * @return Returns the reward epoch number when the setting becomes effective. */ function setDataProviderFeePercentage( State storage _state, uint256 _feePercentageBIPS, uint256 _currentRewardEpoch ) external returns (uint256) { require(_feePercentageBIPS <= MAX_BIPS, ERR_FEE_PERCENTAGE_INVALID); uint256 rewardEpoch = _currentRewardEpoch + _state.feePercentageUpdateOffset; FeePercentage[] storage fps = _state.dataProviderFeePercentages[msg.sender]; // determine whether to update the last setting or add a new one uint256 position = fps.length; if (position > 0) { // do not allow updating the settings in the past // (this can only happen if the sharing percentage epoch offset is updated) require(rewardEpoch >= fps[position - 1].validFromEpoch, ERR_FEE_PERCENTAGE_UPDATE_FAILED); if (rewardEpoch == fps[position - 1].validFromEpoch) { // update position = position - 1; } } if (position == fps.length) { // add fps.push(); } // apply setting fps[position].value = uint16(_feePercentageBIPS); assert(rewardEpoch < 2**240); fps[position].validFromEpoch = uint240(rewardEpoch); return rewardEpoch; } /** * @notice Returns the scheduled fee percentage changes of `_dataProvider` * @param _dataProvider address representing data provider * @return _feePercentageBIPS positional array of fee percentages in BIPS * @return _validFromEpoch positional array of block numbers the fee setings are effective from * @return _fixed positional array of boolean values indicating if settings are subjected to change */ function getDataProviderScheduledFeePercentageChanges( State storage _state, address _dataProvider, uint256 _currentRewardEpoch ) external view returns ( uint256[] memory _feePercentageBIPS, uint256[] memory _validFromEpoch, bool[] memory _fixed ) { FeePercentage[] storage fps = _state.dataProviderFeePercentages[_dataProvider]; if (fps.length > 0) { uint256 currentEpoch = _currentRewardEpoch; uint256 position = fps.length; while (position > 0 && fps[position - 1].validFromEpoch > currentEpoch) { position--; } uint256 count = fps.length - position; if (count > 0) { _feePercentageBIPS = new uint256[](count); _validFromEpoch = new uint256[](count); _fixed = new bool[](count); for (uint256 i = 0; i < count; i++) { _feePercentageBIPS[i] = fps[i + position].value; _validFromEpoch[i] = fps[i + position].validFromEpoch; _fixed[i] = (_validFromEpoch[i] - currentEpoch) != _state.feePercentageUpdateOffset; } } } } /** * @notice Returns fee percentage setting for `_dataProvider` at `_rewardEpoch`. * @param _dataProvider address representing a data provider * @param _rewardEpoch reward epoch number */ function _getDataProviderFeePercentage( State storage _state, address _dataProvider, uint256 _rewardEpoch ) internal view returns (uint256) { FeePercentage[] storage fps = _state.dataProviderFeePercentages[_dataProvider]; uint256 index = fps.length; while (index > 0) { index--; if (_rewardEpoch >= fps[index].validFromEpoch) { return fps[index].value; } } return _state.defaultFeePercentage; } }
contracts/userInterfaces/IFtsoRewardManager.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IFtsoRewardManager { event RewardClaimed( address indexed dataProvider, address indexed whoClaimed, address indexed sentTo, uint256 rewardEpoch, uint256 amount ); event UnearnedRewardsAccrued( uint256 epochId, uint256 reward ); event RewardsDistributed( address indexed ftso, uint256 epochId, address[] addresses, uint256[] rewards ); event RewardClaimsEnabled( uint256 rewardEpochId ); event FeePercentageChanged( address indexed dataProvider, uint256 value, uint256 validFromEpoch ); event RewardClaimsExpired( uint256 rewardEpochId ); event ClaimExecutorsChanged( address rewardOwner, address[] executors ); event AllowedClaimRecipientsChanged( address rewardOwner, address[] recipients ); /** * @notice Allows a percentage delegator to claim rewards. * @notice This function is intended to be used to claim rewards in case of delegation by percentage. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function claimReward(address payable _recipient, uint256[] memory _rewardEpochs) external returns (uint256 _rewardAmount); /** * @notice Allows a percentage delegator to claim and wrap rewards. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by percentage. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function claimAndWrapReward(address payable _recipient, uint256[] memory _rewardEpochs) external returns (uint256 _rewardAmount); /** * @notice Allows a percentage delegator to claim and wrap rewards. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by percentage. * @notice The caller does not have to be the owner, but must be approved by the owner to claim on his behalf. * this approval is done by calling `addClaimExecutor`. * @notice It is actually safe for this to be called by anybody (nothing can be stolen), but by limiting who can * call, we allow the owner to control the timing of the calls. * @param _rewardOwner address of the reward owner * @param _recipient address of the recipient; must be either _rewardOwner or one of the addresses * allowed by the _rewardOwner * @param _rewardEpochs array of reward epoch numbers to claim for * @return _rewardAmount amount of total claimed rewards * @dev Reverts if `msg.sender` is delegating by amount */ function claimAndWrapRewardByExecutor( address _rewardOwner, address payable _recipient, uint256[] memory _rewardEpochs ) external returns (uint256 _rewardAmount); /** * @notice Allows the sender to claim rewards from specified data providers. * @notice This function is intended to be used to claim rewards in case of delegation by amount. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function claimRewardFromDataProviders( address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders ) external returns (uint256 _rewardAmount); /** * @notice Allows the sender to claim and wrap rewards from specified data providers. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by amount. * @param _recipient address to transfer funds to * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function claimAndWrapRewardFromDataProviders( address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders ) external returns (uint256 _rewardAmount); /** * @notice Allows the sender to claim and wrap rewards from specified data providers. * @notice This function is intended to be used to claim and wrap rewards in case of delegation by amount. * @notice The caller does not have to be the owner, but must be approved by the owner to claim on his behalf. * this approval is done by calling `addClaimExecutor`. * @notice It is actually safe for this to be called by anybody (nothing can be stolen), but by limiting who can * call, we allow the owner to control the timing of the calls. * @param _rewardOwner address of the reward owner * @param _recipient address of the recipient; must be either _rewardOwner or one of the addresses * allowed by the _rewardOwner * @param _rewardEpochs array of reward epoch numbers to claim for * @param _dataProviders array of addresses representing data providers to claim the reward from * @return _rewardAmount amount of total claimed rewards * @dev Function can be used by a percentage delegator but is more gas consuming than `claimReward`. */ function claimAndWrapRewardFromDataProvidersByExecutor( address _rewardOwner, address payable _recipient, uint256[] memory _rewardEpochs, address[] memory _dataProviders ) external returns (uint256 _rewardAmount); /** * Set the addresses of executors, who are allowed to call claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. * @param _executors The new executors. All old executors will be deleted and replaced by these. */ function setClaimExecutors(address[] memory _executors) external; /** * Set the addresses of allowed recipients in the methods claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. * Apart from these, the reward owner is always an allowed recipient. * @param _recipients The new allowed recipients. All old recipients will be deleted and replaced by these. */ function setAllowedClaimRecipients(address[] memory _recipients) external; /** * @notice Allows data provider to set (or update last) fee percentage. * @param _feePercentageBIPS number representing fee percentage in BIPS * @return _validFromEpoch reward epoch number when the setting becomes effective. */ function setDataProviderFeePercentage(uint256 _feePercentageBIPS) external returns (uint256 _validFromEpoch); /** * @notice Allows reward claiming */ function active() external view returns (bool); /** * @notice Returns the current fee percentage of `_dataProvider` * @param _dataProvider address representing data provider */ function getDataProviderCurrentFeePercentage(address _dataProvider) external view returns (uint256 _feePercentageBIPS); /** * @notice Returns the fee percentage of `_dataProvider` at `_rewardEpoch` * @param _dataProvider address representing data provider * @param _rewardEpoch reward epoch number */ function getDataProviderFeePercentage( address _dataProvider, uint256 _rewardEpoch ) external view returns (uint256 _feePercentageBIPS); /** * @notice Returns the scheduled fee percentage changes of `_dataProvider` * @param _dataProvider address representing data provider * @return _feePercentageBIPS positional array of fee percentages in BIPS * @return _validFromEpoch positional array of block numbers the fee setings are effective from * @return _fixed positional array of boolean values indicating if settings are subjected to change */ function getDataProviderScheduledFeePercentageChanges(address _dataProvider) external view returns ( uint256[] memory _feePercentageBIPS, uint256[] memory _validFromEpoch, bool[] memory _fixed ); /** * @notice Returns information on epoch reward * @param _rewardEpoch reward epoch number * @return _totalReward number representing the total epoch reward * @return _claimedReward number representing the amount of total epoch reward that has been claimed */ function getEpochReward(uint256 _rewardEpoch) external view returns (uint256 _totalReward, uint256 _claimedReward); /** * @notice Returns the state of rewards for `_beneficiary` at `_rewardEpoch` * @param _beneficiary address of reward beneficiary * @param _rewardEpoch reward epoch number * @return _dataProviders positional array of addresses representing data providers * @return _rewardAmounts positional array of reward amounts * @return _claimed positional array of boolean values indicating if reward is claimed * @return _claimable boolean value indicating if rewards are claimable * @dev Reverts when queried with `_beneficary` delegating by amount */ function getStateOfRewards( address _beneficiary, uint256 _rewardEpoch ) external view returns ( address[] memory _dataProviders, uint256[] memory _rewardAmounts, bool[] memory _claimed, bool _claimable ); /** * @notice Returns the state of rewards for `_beneficiary` at `_rewardEpoch` from `_dataProviders` * @param _beneficiary address of reward beneficiary * @param _rewardEpoch reward epoch number * @param _dataProviders positional array of addresses representing data providers * @return _rewardAmounts positional array of reward amounts * @return _claimed positional array of boolean values indicating if reward is claimed * @return _claimable boolean value indicating if rewards are claimable */ function getStateOfRewardsFromDataProviders( address _beneficiary, uint256 _rewardEpoch, address[] memory _dataProviders ) external view returns ( uint256[] memory _rewardAmounts, bool[] memory _claimed, bool _claimable ); /** * @notice Returns the start and the end of the reward epoch range for which the reward is claimable * @param _startEpochId the oldest epoch id that allows reward claiming * @param _endEpochId the newest epoch id that allows reward claiming */ function getEpochsWithClaimableRewards() external view returns ( uint256 _startEpochId, uint256 _endEpochId ); /** * @notice Returns the array of claimable epoch ids for which the reward has not yet been claimed * @param _beneficiary address of reward beneficiary * @return _epochIds array of epoch ids * @dev Reverts when queried with `_beneficary` delegating by amount */ function getEpochsWithUnclaimedRewards(address _beneficiary) external view returns ( uint256[] memory _epochIds ); /** * @notice Returns the information on claimed reward of `_dataProvider` for `_rewardEpoch` by `_claimer` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing the data provider * @param _claimer address representing the claimer * @return _claimed boolean indicating if reward has been claimed * @return _amount number representing the claimed amount */ function getClaimedReward( uint256 _rewardEpoch, address _dataProvider, address _claimer ) external view returns ( bool _claimed, uint256 _amount ); /** * @notice Return reward epoch that will expire, when new reward epoch will start * @return Reward epoch id that will expire next */ function getRewardEpochToExpireNext() external view returns (uint256); /** * @notice Return reward epoch vote power block * @param _rewardEpoch reward epoch number */ function getRewardEpochVotePowerBlock(uint256 _rewardEpoch) external view returns (uint256); /** * @notice Return current reward epoch number */ function getCurrentRewardEpoch() external view returns (uint256); /** * @notice Return initial reward epoch number */ function getInitialRewardEpoch() external view returns (uint256); /** * @notice Returns the information on rewards and initial vote power of `_dataProvider` for `_rewardEpoch` * @param _rewardEpoch reward epoch number * @param _dataProvider address representing the data provider * @return _rewardAmount number representing the amount of rewards * @return _votePowerIgnoringRevocation number representing the vote power ignoring revocations */ function getDataProviderPerformanceInfo( uint256 _rewardEpoch, address _dataProvider ) external view returns ( uint256 _rewardAmount, uint256 _votePowerIgnoringRevocation ); /** * Get the addresses of executors, who are allowed to call claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. */ function claimExecutors(address _rewardOwner) external view returns (address[] memory); /** * Get the addresses of allowed recipients in the methods claimAndWrapRewardByExecutor * and claimAndWrapRewardFromDataProvidersByExecutor. * Apart from these, the reward owner is always an allowed recipient. */ function allowedClaimRecipients(address _rewardOwner) external view returns (address[] memory); }
contracts/addressUpdater/implementation/AddressUpdatable.sol
// SPDX-License-Identifier: MIT pragma solidity 0.7.6; import "../interface/IIAddressUpdatable.sol"; abstract contract AddressUpdatable is IIAddressUpdatable { // https://docs.soliditylang.org/en/v0.8.7/contracts.html#constant-and-immutable-state-variables // No storage slot is allocated bytes32 internal constant ADDRESS_STORAGE_POSITION = keccak256("flare.diamond.AddressUpdatable.ADDRESS_STORAGE_POSITION"); modifier onlyAddressUpdater() { require (msg.sender == getAddressUpdater(), "only address updater"); _; } constructor(address _addressUpdater) { setAddressUpdaterValue(_addressUpdater); } function getAddressUpdater() public view returns (address _addressUpdater) { // Only direct constants are allowed in inline assembly, so we assign it here bytes32 position = ADDRESS_STORAGE_POSITION; // solhint-disable-next-line no-inline-assembly assembly { _addressUpdater := sload(position) } } /** * @notice external method called from AddressUpdater only */ function updateContractAddresses( bytes32[] memory _contractNameHashes, address[] memory _contractAddresses ) external override onlyAddressUpdater { // update addressUpdater address setAddressUpdaterValue(_getContractAddress(_contractNameHashes, _contractAddresses, "AddressUpdater")); // update all other addresses _updateContractAddresses(_contractNameHashes, _contractAddresses); } /** * @notice virtual method that a contract extending AddressUpdatable must implement */ function _updateContractAddresses( bytes32[] memory _contractNameHashes, address[] memory _contractAddresses ) internal virtual; /** * @notice helper method to get contract address * @dev it reverts if contract name does not exist */ function _getContractAddress( bytes32[] memory _nameHashes, address[] memory _addresses, string memory _nameToFind ) internal pure returns(address) { bytes32 nameHash = keccak256(abi.encode(_nameToFind)); address a = address(0); for (uint256 i = 0; i < _nameHashes.length; i++) { if (nameHash == _nameHashes[i]) { a = _addresses[i]; break; } } require(a != address(0), "address zero"); return a; } function setAddressUpdaterValue(address _addressUpdater) internal { // Only direct constants are allowed in inline assembly, so we assign it here bytes32 position = ADDRESS_STORAGE_POSITION; // solhint-disable-next-line no-inline-assembly assembly { sstore(position, _addressUpdater) } } }
contracts/genesis/interface/IFtsoGenesis.sol
// SPDX-License-Identifier: MIT pragma solidity >=0.7.6 <0.9; interface IFtsoGenesis { /** * @notice Reveals submitted price during epoch reveal period - only price submitter * @param _voter Voter address * @param _epochId Id of the epoch in which the price hash was submitted * @param _price Submitted price in USD * @notice The hash of _price and _random must be equal to the submitted hash * @notice Emits PriceRevealed event */ function revealPriceSubmitter( address _voter, uint256 _epochId, uint256 _price, uint256 _wNatVP ) external; /** * @notice Get (and cache) wNat vote power for specified voter and given epoch id * @param _voter Voter address * @param _epochId Id of the epoch in which the price hash was submitted * @return wNat vote power */ function wNatVotePowerCached(address _voter, uint256 _epochId) external returns (uint256); }
Contract ABI
[{"type":"constructor","stateMutability":"nonpayable","inputs":[{"type":"address","name":"_governance","internalType":"address"},{"type":"address","name":"_addressUpdater","internalType":"address"},{"type":"address","name":"_oldFtsoRewardManager","internalType":"address"},{"type":"uint256","name":"_feePercentageUpdateOffset","internalType":"uint256"},{"type":"uint256","name":"_defaultFeePercentage","internalType":"uint256"}]},{"type":"event","name":"AllowedClaimRecipientsChanged","inputs":[{"type":"address","name":"rewardOwner","internalType":"address","indexed":false},{"type":"address[]","name":"recipients","internalType":"address[]","indexed":false}],"anonymous":false},{"type":"event","name":"ClaimExecutorsChanged","inputs":[{"type":"address","name":"rewardOwner","internalType":"address","indexed":false},{"type":"address[]","name":"executors","internalType":"address[]","indexed":false}],"anonymous":false},{"type":"event","name":"DailyAuthorizedInflationSet","inputs":[{"type":"uint256","name":"authorizedAmountWei","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"FeePercentageChanged","inputs":[{"type":"address","name":"dataProvider","internalType":"address","indexed":true},{"type":"uint256","name":"value","internalType":"uint256","indexed":false},{"type":"uint256","name":"validFromEpoch","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"GovernanceCallTimelocked","inputs":[{"type":"bytes4","name":"selector","internalType":"bytes4","indexed":false},{"type":"uint256","name":"allowedAfterTimestamp","internalType":"uint256","indexed":false},{"type":"bytes","name":"encodedCall","internalType":"bytes","indexed":false}],"anonymous":false},{"type":"event","name":"GovernanceInitialised","inputs":[{"type":"address","name":"initialGovernance","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"GovernedProductionModeEntered","inputs":[{"type":"address","name":"governanceSettings","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"InflationReceived","inputs":[{"type":"uint256","name":"amountReceivedWei","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"RewardClaimed","inputs":[{"type":"address","name":"dataProvider","internalType":"address","indexed":true},{"type":"address","name":"whoClaimed","internalType":"address","indexed":true},{"type":"address","name":"sentTo","internalType":"address","indexed":true},{"type":"uint256","name":"rewardEpoch","internalType":"uint256","indexed":false},{"type":"uint256","name":"amount","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"RewardClaimsEnabled","inputs":[{"type":"uint256","name":"rewardEpochId","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"RewardClaimsExpired","inputs":[{"type":"uint256","name":"rewardEpochId","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"RewardsBurned","inputs":[{"type":"uint256","name":"amountBurnedWei","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"RewardsDistributed","inputs":[{"type":"address","name":"ftso","internalType":"address","indexed":true},{"type":"uint256","name":"epochId","internalType":"uint256","indexed":false},{"type":"address[]","name":"addresses","internalType":"address[]","indexed":false},{"type":"uint256[]","name":"rewards","internalType":"uint256[]","indexed":false}],"anonymous":false},{"type":"event","name":"TimelockedGovernanceCallCanceled","inputs":[{"type":"bytes4","name":"selector","internalType":"bytes4","indexed":false},{"type":"uint256","name":"timestamp","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"TimelockedGovernanceCallExecuted","inputs":[{"type":"bytes4","name":"selector","internalType":"bytes4","indexed":false},{"type":"uint256","name":"timestamp","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"UnearnedRewardsAccrued","inputs":[{"type":"uint256","name":"epochId","internalType":"uint256","indexed":false},{"type":"uint256","name":"reward","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"accrueUnearnedRewards","inputs":[{"type":"uint256","name":"_epochId","internalType":"uint256"},{"type":"uint256","name":"_priceEpochDurationSeconds","internalType":"uint256"},{"type":"uint256","name":"_priceEpochEndTime","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"activate","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"active","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address[]","name":"","internalType":"address[]"}],"name":"allowedClaimRecipients","inputs":[{"type":"address","name":"_rewardOwner","internalType":"address"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"cancelGovernanceCall","inputs":[{"type":"bytes4","name":"_selector","internalType":"bytes4"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"}],"name":"claimAndWrapReward","inputs":[{"type":"address","name":"_recipient","internalType":"address payable"},{"type":"uint256[]","name":"_rewardEpochs","internalType":"uint256[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"}],"name":"claimAndWrapRewardByExecutor","inputs":[{"type":"address","name":"_rewardOwner","internalType":"address"},{"type":"address","name":"_recipient","internalType":"address payable"},{"type":"uint256[]","name":"_rewardEpochs","internalType":"uint256[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"}],"name":"claimAndWrapRewardFromDataProviders","inputs":[{"type":"address","name":"_recipient","internalType":"address payable"},{"type":"uint256[]","name":"_rewardEpochs","internalType":"uint256[]"},{"type":"address[]","name":"_dataProviders","internalType":"address[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"}],"name":"claimAndWrapRewardFromDataProvidersByExecutor","inputs":[{"type":"address","name":"_rewardOwner","internalType":"address"},{"type":"address","name":"_recipient","internalType":"address payable"},{"type":"uint256[]","name":"_rewardEpochs","internalType":"uint256[]"},{"type":"address[]","name":"_dataProviders","internalType":"address[]"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address[]","name":"","internalType":"address[]"}],"name":"claimExecutors","inputs":[{"type":"address","name":"_rewardOwner","internalType":"address"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"}],"name":"claimReward","inputs":[{"type":"address","name":"_recipient","internalType":"address payable"},{"type":"uint256[]","name":"_rewardEpochs","internalType":"uint256[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"}],"name":"claimRewardFromDataProviders","inputs":[{"type":"address","name":"_recipient","internalType":"address payable"},{"type":"uint256[]","name":"_rewardEpochs","internalType":"uint256[]"},{"type":"address[]","name":"_dataProviders","internalType":"address[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"closeExpiredRewardEpoch","inputs":[{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"deactivate","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"defaultFeePercentage","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"distributeRewards","inputs":[{"type":"address[]","name":"_addresses","internalType":"address[]"},{"type":"uint256[]","name":"_weights","internalType":"uint256[]"},{"type":"uint256","name":"_totalWeight","internalType":"uint256"},{"type":"uint256","name":"_epochId","internalType":"uint256"},{"type":"address","name":"_ftso","internalType":"address"},{"type":"uint256","name":"_priceEpochDurationSeconds","internalType":"uint256"},{"type":"uint256","name":"_currentRewardEpoch","internalType":"uint256"},{"type":"uint256","name":"_priceEpochEndTime","internalType":"uint256"},{"type":"uint256","name":"_votePowerBlock","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"enableClaims","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"executeGovernanceCall","inputs":[{"type":"bytes4","name":"_selector","internalType":"bytes4"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"feePercentageUpdateOffset","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"firstClaimableRewardEpoch","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"contract IIFtsoManager"}],"name":"ftsoManager","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"_addressUpdater","internalType":"address"}],"name":"getAddressUpdater","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"_claimed","internalType":"bool"},{"type":"uint256","name":"_amount","internalType":"uint256"}],"name":"getClaimedReward","inputs":[{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"},{"type":"address","name":"_dataProvider","internalType":"address"},{"type":"address","name":"_claimer","internalType":"address"}]},{"type":"function","stateMutability":"pure","outputs":[{"type":"string","name":"","internalType":"string"}],"name":"getContractName","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getCurrentRewardEpoch","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getDataProviderCurrentFeePercentage","inputs":[{"type":"address","name":"_dataProvider","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_feePercentageBIPS","internalType":"uint256"}],"name":"getDataProviderFeePercentage","inputs":[{"type":"address","name":"_dataProvider","internalType":"address"},{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_rewardAmount","internalType":"uint256"},{"type":"uint256","name":"_votePowerIgnoringRevocation","internalType":"uint256"}],"name":"getDataProviderPerformanceInfo","inputs":[{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"},{"type":"address","name":"_dataProvider","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256[]","name":"_feePercentageBIPS","internalType":"uint256[]"},{"type":"uint256[]","name":"_validFromEpoch","internalType":"uint256[]"},{"type":"bool[]","name":"_fixed","internalType":"bool[]"}],"name":"getDataProviderScheduledFeePercentageChanges","inputs":[{"type":"address","name":"_dataProvider","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_totalReward","internalType":"uint256"},{"type":"uint256","name":"_claimedReward","internalType":"uint256"}],"name":"getEpochReward","inputs":[{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_startEpochId","internalType":"uint256"},{"type":"uint256","name":"_endEpochId","internalType":"uint256"}],"name":"getEpochsWithClaimableRewards","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256[]","name":"_epochIds","internalType":"uint256[]"}],"name":"getEpochsWithUnclaimedRewards","inputs":[{"type":"address","name":"_beneficiary","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"getInflationAddress","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_initialRewardEpoch","internalType":"uint256"}],"name":"getInitialRewardEpoch","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getRewardEpochToExpireNext","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getRewardEpochVotePowerBlock","inputs":[{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address[]","name":"_dataProviders","internalType":"address[]"},{"type":"uint256[]","name":"_rewardAmounts","internalType":"uint256[]"},{"type":"bool[]","name":"_claimed","internalType":"bool[]"},{"type":"bool","name":"_claimable","internalType":"bool"}],"name":"getStateOfRewards","inputs":[{"type":"address","name":"_beneficiary","internalType":"address"},{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256[]","name":"_rewardAmounts","internalType":"uint256[]"},{"type":"bool[]","name":"_claimed","internalType":"bool[]"},{"type":"bool","name":"_claimable","internalType":"bool"}],"name":"getStateOfRewardsFromDataProviders","inputs":[{"type":"address","name":"_beneficiary","internalType":"address"},{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"},{"type":"address[]","name":"_dataProviders","internalType":"address[]"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_lockedFundsWei","internalType":"uint256"},{"type":"uint256","name":"_totalInflationAuthorizedWei","internalType":"uint256"},{"type":"uint256","name":"_totalClaimedWei","internalType":"uint256"}],"name":"getTokenPoolSupplyData","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_totalAwardedWei","internalType":"uint256"},{"type":"uint256","name":"_totalClaimedWei","internalType":"uint256"},{"type":"uint256","name":"_totalExpiredWei","internalType":"uint256"},{"type":"uint256","name":"_totalUnearnedWei","internalType":"uint256"},{"type":"uint256","name":"_totalBurnedWei","internalType":"uint256"},{"type":"uint256","name":"_totalInflationAuthorizedWei","internalType":"uint256"},{"type":"uint256","name":"_totalInflationReceivedWei","internalType":"uint256"},{"type":"uint256","name":"_totalSelfDestructReceivedWei","internalType":"uint256"},{"type":"uint256","name":"_lastInflationAuthorizationReceivedTs","internalType":"uint256"},{"type":"uint256","name":"_dailyAuthorizedInflation","internalType":"uint256"}],"name":"getTotals","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"_amount","internalType":"uint256"},{"type":"uint256","name":"_weight","internalType":"uint256"}],"name":"getUnclaimedReward","inputs":[{"type":"uint256","name":"_rewardEpoch","internalType":"uint256"},{"type":"address","name":"_dataProvider","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"governance","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"contract IGovernanceSettings"}],"name":"governanceSettings","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"initialise","inputs":[{"type":"address","name":"_initialGovernance","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"newFtsoRewardManager","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"oldFtsoRewardManager","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"productionMode","inputs":[]},{"type":"function","stateMutability":"payable","outputs":[],"name":"receiveInflation","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setAllowedClaimRecipients","inputs":[{"type":"address[]","name":"_recipients","internalType":"address[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setClaimExecutors","inputs":[{"type":"address[]","name":"_executors","internalType":"address[]"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setDailyAuthorizedInflation","inputs":[{"type":"uint256","name":"_toAuthorizeWei","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"setDataProviderFeePercentage","inputs":[{"type":"uint256","name":"_feePercentageBIPS","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setInitialRewardData","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setNewFtsoRewardManager","inputs":[{"type":"address","name":"_newFtsoRewardManager","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"contract Supply"}],"name":"supply","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"switchToProductionMode","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"allowedAfterTimestamp","internalType":"uint256"},{"type":"bytes","name":"encodedCall","internalType":"bytes"}],"name":"timelockedCalls","inputs":[{"type":"bytes4","name":"","internalType":"bytes4"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"updateContractAddresses","inputs":[{"type":"bytes32[]","name":"_contractNameHashes","internalType":"bytes32[]"},{"type":"address[]","name":"_contractAddresses","internalType":"address[]"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"contract WNat"}],"name":"wNat","inputs":[]}]
Contract Creation Code
0x60a06040523480156200001157600080fd5b506040516200617938038062006179833981810160405260a08110156200003757600080fd5b508051602082015160408301516060840151608090940151929391929091908385806001600160a01b0381161562000074576200007481620000fd565b506001600160a01b038116620000c4576040805162461bcd60e51b815260206004820152601060248201526f5f676f7665726e616e6365207a65726f60801b604482015290519081900360640190fd5b506001600255620000d581620001c0565b5060609290921b6001600160601b031916608052600e55600f555050600019600455620001e4565b600054600160a01b900460ff16156200015d576040805162461bcd60e51b815260206004820152601460248201527f696e697469616c6973656420213d2066616c7365000000000000000000000000604482015290519081900360640190fd5b60008054600160a01b60ff60a01b19909116176001600160a01b0319166001600160a01b03831690811790915560408051918252517f9789733827840833afc031fb2ef9ab6894271f77bad2085687cf4ae5c7bee4db916020908290030190a150565b7f714f205b2abd25bef1d06a1af944e38c113fe6160375c4e1d6d5cf28848e771955565b60805160601c615f636200021660003980611b0c5280611d255280611e5152806136d552806137135250615f636000f3fe60806040526004361061038c5760003560e01c806384e10a90116101dc578063d2a4ac6111610102578063e416b7e1116100a0578063ed39d3f81161006f578063ed39d3f814611854578063f2edab5a14611869578063f5a9838314611893578063f5f5ba72146118a85761038c565b8063e416b7e11461168c578063e7c830d4146117f1578063ea28edad14611806578063eb82dd7f1461181b5761038c565b8063d93bb92a116100dc578063d93bb92a1461155c578063dfd14c341461161a578063e17f212e1461164d578063e2739563146116625761038c565b8063d2a4ac611461145a578063d418634a14611508578063d6c1dbee146115325761038c565b8063a4472c101161017a578063b482403411610149578063b48240341461129f578063b4a2043d146112b4578063cfbcd25f146112e7578063d20bb5421461131a5761038c565b8063a4472c1014610e34578063a9b79e1714610f54578063b00c0b76146110b1578063b2af870a146111e15761038c565b80639119c494116101b65780639119c49414610d05578063961c00ed14610db35780639d6a890f14610dec5780639edbf00714610e1f5761038c565b806384e10a9014610afb57806385b4c53814610b6057806387c233cb14610bbc5761038c565b806333b7971e116102c1578063614815901161025f57806367fc40291161022e57806367fc4029146109cc57806374e6310e14610a005780637b6b2c0a14610ab357806382a2b90514610ac85761038c565b8063614815901461080857806362354e0314610948578063657d96951461095d57806367dcac53146109965761038c565b806351b42b001161029b57806351b42b00146107955780635267a15d146107aa5780635aa6e675146107bf5780635ff27079146107d45761038c565b806333b7971e146105ec5780633e7ff857146106fd5780633f317fe1146107125761038c565b806311a7aaaa1161032e57806316fe49c71161030857806316fe49c71461057a5780631de560981461058f5780632dafdbbf146105a45780633123b7d8146105d75761038c565b806311a7aaaa1461052657806312f97ac01461053b57806316e69328146105505761038c565b8063047fc9aa1161036a578063047fc9aa146104c157806306201f1d146104f25780630cb72344146104fc5780630f15f4c0146105115761038c565b806302fb0c5e146103915780630441218e146103ba578063045198fe146103e8575b600080fd5b34801561039d57600080fd5b506103a6611932565b604080519115158252519081900360200190f35b3480156103c657600080fd5b506103cf61193b565b6040805192835260208301919091528051918290030190f35b3480156103f457600080fd5b506104af6004803603606081101561040b57600080fd5b6001600160a01b038235811692602081013590911691810190606081016040820135600160201b81111561043e57600080fd5b82018360208201111561045057600080fd5b803590602001918460208302840111600160201b8311171561047157600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061194f945050505050565b60408051918252519081900360200190f35b3480156104cd57600080fd5b506104d66119d5565b604080516001600160a01b039092168252519081900360200190f35b6104fa6119e4565b005b34801561050857600080fd5b506104d6611b0a565b34801561051d57600080fd5b506104fa611b2e565b34801561053257600080fd5b506104d6611be6565b34801561054757600080fd5b506104d6611bf5565b34801561055c57600080fd5b506104af6004803603602081101561057357600080fd5b5035611c04565b34801561058657600080fd5b506104af611ce0565b34801561059b57600080fd5b506104fa611ce6565b3480156105b057600080fd5b506105b9611ed6565b60408051938452602084019290925282820152519081900360600190f35b3480156105e357600080fd5b506104af611f01565b3480156105f857600080fd5b5061061f6004803603602081101561060f57600080fd5b50356001600160a01b0316611f18565b60405180806020018060200180602001848103845287818151815260200191508051906020019060200280838360005b8381101561066757818101518382015260200161064f565b50505050905001848103835286818151815260200191508051906020019060200280838360005b838110156106a657818101518382015260200161068e565b50505050905001848103825285818151815260200191508051906020019060200280838360005b838110156106e55781810151838201526020016106cd565b50505050905001965050505050505060405180910390f35b34801561070957600080fd5b506104af61216c565b34801561071e57600080fd5b506107456004803603602081101561073557600080fd5b50356001600160a01b0316612172565b60408051602080825283518183015283519192839290830191858101910280838360005b83811015610781578181015183820152602001610769565b505050509050019250505060405180910390f35b3480156107a157600080fd5b506104fa6121e8565b3480156107b657600080fd5b506104d66121fc565b3480156107cb57600080fd5b506104d6612221565b3480156107e057600080fd5b506104fa600480360360208110156107f757600080fd5b50356001600160e01b0319166122b6565b34801561081457600080fd5b506104af6004803603606081101561082b57600080fd5b6001600160a01b038235169190810190604081016020820135600160201b81111561085557600080fd5b82018360208201111561086757600080fd5b803590602001918460208302840111600160201b8311171561088857600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b8111156108d757600080fd5b8201836020820111156108e957600080fd5b803590602001918460208302840111600160201b8311171561090a57600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061260b945050505050565b34801561095457600080fd5b506104d661267b565b34801561096957600080fd5b506103cf6004803603604081101561098057600080fd5b50803590602001356001600160a01b0316612686565b3480156109a257600080fd5b506104fa600480360360608110156109b957600080fd5b50803590602081013590604001356126c2565b3480156109d857600080fd5b506104fa600480360360208110156109ef57600080fd5b50356001600160e01b03191661272a565b348015610a0c57600080fd5b50610a3460048036036020811015610a2357600080fd5b50356001600160e01b031916612812565b6040518083815260200180602001828103825283818151815260200191508051906020019080838360005b83811015610a77578181015183820152602001610a5f565b50505050905090810190601f168015610aa45780820380516001836020036101000a031916815260200191505b50935050505060405180910390f35b348015610abf57600080fd5b506104af6128b8565b348015610ad457600080fd5b506104fa60048036036020811015610aeb57600080fd5b50356001600160a01b03166128be565b348015610b0757600080fd5b50610b10612963565b604080519a8b5260208b0199909952898901979097526060890195909552608088019390935260a087019190915260c086015260e085015261010084015261012083015251908190036101400190f35b348015610b6c57600080fd5b50610ba160048036036060811015610b8357600080fd5b508035906001600160a01b036020820135811691604001351661298d565b60408051921515835260208301919091528051918290030190f35b348015610bc857600080fd5b506104af60048036036080811015610bdf57600080fd5b6001600160a01b038235811692602081013590911691810190606081016040820135600160201b811115610c1257600080fd5b820183602082011115610c2457600080fd5b803590602001918460208302840111600160201b83111715610c4557600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b811115610c9457600080fd5b820183602082011115610ca657600080fd5b803590602001918460208302840111600160201b83111715610cc757600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506129c9945050505050565b348015610d1157600080fd5b506104fa60048036036020811015610d2857600080fd5b810190602081018135600160201b811115610d4257600080fd5b820183602082011115610d5457600080fd5b803590602001918460208302840111600160201b83111715610d7557600080fd5b919080806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250929550612a51945050505050565b348015610dbf57600080fd5b506104af60048036036040811015610dd657600080fd5b506001600160a01b038135169060200135612af3565b348015610df857600080fd5b506104fa60048036036020811015610e0f57600080fd5b50356001600160a01b0316612b6e565b348015610e2b57600080fd5b506104d6612c27565b348015610e4057600080fd5b50610e6d60048036036040811015610e5757600080fd5b506001600160a01b038135169060200135612c36565b604051808060200180602001806020018515158152602001848103845288818151815260200191508051906020019060200280838360005b83811015610ebd578181015183820152602001610ea5565b50505050905001848103835287818151815260200191508051906020019060200280838360005b83811015610efc578181015183820152602001610ee4565b50505050905001848103825286818151815260200191508051906020019060200280838360005b83811015610f3b578181015183820152602001610f23565b5050505090500197505050505050505060405180910390f35b348015610f6057600080fd5b506104fa6004803603610120811015610f7857600080fd5b810190602081018135600160201b811115610f9257600080fd5b820183602082011115610fa457600080fd5b803590602001918460208302840111600160201b83111715610fc557600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b81111561101457600080fd5b82018360208201111561102657600080fd5b803590602001918460208302840111600160201b8311171561104757600080fd5b919080806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250929550508235935050506020810135906001600160a01b036040820135169060608101359060808101359060a08101359060c00135612ca0565b3480156110bd57600080fd5b506104fa600480360360408110156110d457600080fd5b810190602081018135600160201b8111156110ee57600080fd5b82018360208201111561110057600080fd5b803590602001918460208302840111600160201b8311171561112157600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b81111561117057600080fd5b82018360208201111561118257600080fd5b803590602001918460208302840111600160201b831117156111a357600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061323f945050505050565b3480156111ed57600080fd5b506104af6004803603604081101561120457600080fd5b6001600160a01b038235169190810190604081016020820135600160201b81111561122e57600080fd5b82018360208201111561124057600080fd5b803590602001918460208302840111600160201b8311171561126157600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506132ea945050505050565b3480156112ab57600080fd5b506104af613359565b3480156112c057600080fd5b50610745600480360360208110156112d757600080fd5b50356001600160a01b031661335f565b3480156112f357600080fd5b506104af6004803603602081101561130a57600080fd5b50356001600160a01b0316613506565b34801561132657600080fd5b506104af6004803603606081101561133d57600080fd5b6001600160a01b038235169190810190604081016020820135600160201b81111561136757600080fd5b82018360208201111561137957600080fd5b803590602001918460208302840111600160201b8311171561139a57600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b8111156113e957600080fd5b8201836020820111156113fb57600080fd5b803590602001918460208302840111600160201b8311171561141c57600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061351d945050505050565b34801561146657600080fd5b506104fa6004803603602081101561147d57600080fd5b810190602081018135600160201b81111561149757600080fd5b8201836020820111156114a957600080fd5b803590602001918460208302840111600160201b831117156114ca57600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061357e945050505050565b34801561151457600080fd5b506103cf6004803603602081101561152b57600080fd5b5035613608565b34801561153e57600080fd5b506104fa6004803603602081101561155557600080fd5b5035613627565b34801561156857600080fd5b506104af6004803603604081101561157f57600080fd5b6001600160a01b038235169190810190604081016020820135600160201b8111156115a957600080fd5b8201836020820111156115bb57600080fd5b803590602001918460208302840111600160201b831117156115dc57600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506137fb945050505050565b34801561162657600080fd5b506107456004803603602081101561163d57600080fd5b50356001600160a01b031661385b565b34801561165957600080fd5b506103a66138cf565b34801561166e57600080fd5b506104fa6004803603602081101561168557600080fd5b50356138df565b34801561169857600080fd5b5061174f600480360360608110156116af57600080fd5b6001600160a01b0382351691602081013591810190606081016040820135600160201b8111156116de57600080fd5b8201836020820111156116f057600080fd5b803590602001918460208302840111600160201b8311171561171157600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506139ae945050505050565b6040518080602001806020018415158152602001838103835286818151815260200191508051906020019060200280838360005b8381101561179b578181015183820152602001611783565b50505050905001838103825285818151815260200191508051906020019060200280838360005b838110156117da5781810151838201526020016117c2565b505050509050019550505050505060405180910390f35b3480156117fd57600080fd5b506104af613a12565b34801561181257600080fd5b506104fa613a57565b34801561182757600080fd5b506103cf6004803603604081101561183e57600080fd5b50803590602001356001600160a01b0316613b1c565b34801561186057600080fd5b506104d6613b58565b34801561187557600080fd5b506104af6004803603602081101561188c57600080fd5b5035613b67565b34801561189f57600080fd5b506104fa613be5565b3480156118b457600080fd5b506118bd613c9f565b6040805160208082528351818301528351919283929083019185019080838360005b838110156118f75781810151838201526020016118df565b50505050905090810190601f1680156119245780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b60035460ff1681565b600080611946613cca565b90939092509050565b6000611959613d6c565b60028054141561199e576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805583836119ae8282613df2565b6119bb8686866001613f52565b600160025592506119ce91506140539050565b9392505050565b6021546001600160a01b031681565b601f5460408051808201909152600e81526d696e666c6174696f6e206f6e6c7960901b6020820152906001600160a01b03163314611aa05760405162461bcd60e51b81526004018080602001828103825283818151815260200191508051906020019080838360005b83811015611a65578181015183820152602001611a4d565b50505050905090810190601f168015611a925780820380516001836020036101000a031916815260200191505b509250505060405180910390fd5b506000611aab6140d0565b50601954909150611abc903461412a565b601955601d819055611acc614184565b6040805134815290517f95c4e29cc99bc027cfc3cd719d6fd973d5f0317061885fbb322b9b17d8d35d379181900360200190a150611b08614053565b565b7f000000000000000000000000000000000000000000000000000000000000000081565b611b366142da565b601f546001600160a01b031615801590611b5a5750601e546001600160a01b031615155b8015611b7057506020546001600160a01b031615155b8015611b8657506021546001600160a01b031615155b611bd7576040805162461bcd60e51b815260206004820152601a60248201527f636f6e747261637420616464726573736573206e6f7420736574000000000000604482015290519081900360640190fd5b6003805460ff19166001179055565b601e546001600160a01b031681565b6022546001600160a01b031681565b60008073f478a974891341818ab347cf09bab8a22bad91bc63e937a562600e85611c2c613a12565b6040518463ffffffff1660e01b815260040180848152602001838152602001828152602001935050505060206040518083038186803b158015611c6e57600080fd5b505af4158015611c82573d6000803e3d6000fd5b505050506040513d6020811015611c9857600080fd5b50516040805185815260208101839052815192935033927fd89f05622c2dcb0b4fcaa19e62fc2a2b0923955685fb7b0c641467f764244abc929181900390910190a292915050565b600e5490565b600054600160b01b900460ff1680611d085750600054600160a81b900460ff16155b15611ecb57611d15614339565b60035460ff16158015611d5057507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031615155b8015611d5c5750600654155b8015611d685750600554155b611dad576040805162461bcd60e51b81526020600482015260116024820152706e6f7420696e697469616c20737461746560781b604482015290519081900360640190fd5b611dc06001611dba613a12565b9061412a565b600655601e5460408051633e7ff85760e01b815290516001600160a01b0390921691633e7ff85791600480820192602092909190829003018186803b158015611e0857600080fd5b505afa158015611e1c573d6000803e3d6000fd5b505050506040513d6020811015611e3257600080fd5b505160055560408051633db5960560e11b815290516001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001691637b6b2c0a916004808301926020929190829003018186803b158015611e9757600080fd5b505afa158015611eab573d6000803e3d6000fd5b505050506040513d6020811015611ec157600080fd5b5051600455611b08565b611b0860003661436e565b600080600080601854611ef660175460145461412a90919063ffffffff16565b925092509250909192565b600654600090611f129060016144f1565b92915050565b6060808073f478a974891341818ab347cf09bab8a22bad91bc6325459925600e86611f41613a12565b6040518463ffffffff1660e01b815260040180848152602001836001600160a01b03168152602001828152602001935050505060006040518083038186803b158015611f8c57600080fd5b505af4158015611fa0573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526060811015611fc957600080fd5b8101908080516040519392919084600160201b821115611fe857600080fd5b908301906020820185811115611ffd57600080fd5b82518660208202830111600160201b8211171561201957600080fd5b82525081516020918201928201910280838360005b8381101561204657818101518382015260200161202e565b5050505090500160405260200180516040519392919084600160201b82111561206e57600080fd5b90830190602082018581111561208357600080fd5b82518660208202830111600160201b8211171561209f57600080fd5b82525081516020918201928201910280838360005b838110156120cc5781810151838201526020016120b4565b5050505090500160405260200180516040519392919084600160201b8211156120f457600080fd5b90830190602082018581111561210957600080fd5b82518660208202830111600160201b8211171561212557600080fd5b82525081516020918201928201910280838360005b8381101561215257818101518382015260200161213a565b505050509050016040525050509250925092509193909250565b60055490565b6001600160a01b0381166000908152601160209081526040918290208054835181840281018401909452808452606093928301828280156121dc57602002820191906000526020600020905b81546001600160a01b031681526001909101906020018083116121be575b50505050509050919050565b6121f06142da565b6003805460ff19169055565b7f714f205b2abd25bef1d06a1af944e38c113fe6160375c4e1d6d5cf28848e77195490565b60008054600160a81b900460ff16612244576000546001600160a01b03166122b1565b60076001609c1b016001600160a01b031663732524946040518163ffffffff1660e01b815260040160206040518083038186803b15801561228457600080fd5b505afa158015612298573d6000803e3d6000fd5b505050506040513d60208110156122ae57600080fd5b50515b905090565b60408051630debfda360e41b8152336004820152905160076001609c1b019163debfda30916024808301926020929190829003018186803b1580156122fa57600080fd5b505afa15801561230e573d6000803e3d6000fd5b505050506040513d602081101561232457600080fd5b5051612367576040805162461bcd60e51b815260206004820152600d60248201526c37b7363c9032bc32b1baba37b960991b604482015290519081900360640190fd5b6001600160e01b03198116600090815260016020526040902080546123d3576040805162461bcd60e51b815260206004820152601a60248201527f74696d656c6f636b3a20696e76616c69642073656c6563746f72000000000000604482015290519081900360640190fd5b8054421015612429576040805162461bcd60e51b815260206004820152601960248201527f74696d656c6f636b3a206e6f7420616c6c6f7765642079657400000000000000604482015290519081900360640190fd5b6000816001018054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156124c35780601f10612498576101008083540402835291602001916124c3565b820191906000526020600020905b8154815290600101906020018083116124a657829003601f168201915b5050506001600160e01b03198616600090815260016020819052604082208281559495509092506124f79150830182615d79565b50506000805460ff60b01b1916600160b01b178155604051825130918491819060208401908083835b6020831061253f5780518252601f199092019160209182019101612520565b6001836020036101000a0380198251168184511680821785525050505050509050019150506000604051808303816000865af19150503d80600081146125a1576040519150601f19603f3d011682016040523d82523d6000602084013e6125a6565b606091505b50506000805460ff60b01b19169055604080516001600160e01b03198716815242602082015281519293507fa7326b57fc9cfe267aaea5e7f0b01757154d265620a0585819416ee9ddd2c438929081900390910190a161260581614517565b50505050565b6000612615613d6c565b60028054141561265a576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561266c338585856001614534565b600160025590506119ce614053565b60076001609c1b0181565b60008281526008602090815260408083206001600160a01b03909416808452938252808320549483526007825280832093835292905220549091565b6126ca614621565b60006126d683836146a3565b6016549091506126e6908261412a565b601655604080518581526020810183905281517f754fa5a3ace0438b80ec651f7d61e44f761a808ebd17d7ce70da619399611a08929181900390910190a150505050565b6127326142da565b6001600160e01b0319811660009081526001602052604090205461279d576040805162461bcd60e51b815260206004820152601a60248201527f74696d656c6f636b3a20696e76616c69642073656c6563746f72000000000000604482015290519081900360640190fd5b604080516001600160e01b03198316815242602082015281517f7735b2391c38a81419c513e30ca578db7158eadd7101511b23e221c654d19cf8929181900390910190a16001600160e01b0319811660009081526001602081905260408220828155919061280d90830182615d79565b505050565b600160208181526000928352604092839020805481840180548651600296821615610100026000190190911695909504601f810185900485028601850190965285855290949193929091908301828280156128ae5780601f10612883576101008083540402835291602001916128ae565b820191906000526020600020905b81548152906001019060200180831161289157829003601f168201915b5050505050905082565b60045481565b600054600160b01b900460ff16806128e05750600054600160a81b900460ff16155b15612955576128ed614339565b6022546001600160a01b0316156129355760405162461bcd60e51b8152600401808060200182810382526023815260200180615ebe6023913960400191505060405180910390fd5b602280546001600160a01b0319166001600160a01b038316179055612960565b61296060003661436e565b50565b601354601454601554601654601754601854601954601a54601b54601c5490919293949596979899565b6000928352600b602090815260408085206001600160a01b0394851686528252808520929093168452529020805460019091015460ff90911691565b60006129d3613d6c565b600280541415612a18576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b600280558484612a288282613df2565b612a36878787876001614534565b60016002559250612a4991506140539050565b949350505050565b336000908152601160205260409020612a6a90826146c0565b7fa802dcd9d0db82c5fc0b043e16d9ab77391cff1b84415bce9e95c4a8d6fe7146338260405180836001600160a01b0316815260200180602001828103825283818151815260200191508051906020019060200280838360005b83811015612adc578181015183820152602001612ac4565b50505050905001935050505060405180910390a150565b600081612afe611f01565b11158015612b1a5750600e54612b1690611dba613a12565b8211155b612b62576040805162461bcd60e51b81526020600482015260146024820152730d2dcecc2d8d2c840e4caeec2e4c840cae0dec6d60631b604482015290519081900360640190fd5b6119ce600e84846146d3565b600054600160a01b900460ff1615612bc4576040805162461bcd60e51b8152602060048201526014602482015273696e697469616c6973656420213d2066616c736560601b604482015290519081900360640190fd5b60008054600160a01b60ff60a01b19909116176001600160a01b0319166001600160a01b03831690811790915560408051918252517f9789733827840833afc031fb2ef9ab6894271f77bad2085687cf4ae5c7bee4db916020908290030190a150565b6020546001600160a01b031681565b6060806060600080612c46613a12565b9050612c528682614766565b91508180612c6c57508086148015612c6c57506004548610155b15612c96576000612c7f8888600061479a565b805160408201516060909201519097509095509350505b5092959194509250565b612ca8614621565b8615801590612cb75750885115155b612cbd57fe5b6000612cc985846146a3565b905060008a5167ffffffffffffffff81118015612ce557600080fd5b50604051908082528060200260200182016040528015612d0f578160200160208202803683370190505b5090508181600081518110612d2057fe5b602002602001018181525050888a600081518110612d3a57fe5b60209081029190910101528a51600019015b612d9c8b8281518110612d5b57fe5b60200260200101518c600081518110612d7057fe5b602002602001015184600081518110612d8557fe5b6020026020010151614e029092919063ffffffff16565b828281518110612da857fe5b602002602001018181525050818181518110612dc057fe5b60200260200101516008600088815260200190815260200160002060008e8481518110612de957fe5b60200260200101516001600160a01b03166001600160a01b0316815260200190815260200160002060008282540192505081905550612ed3612710602060009054906101000a90046001600160a01b03166001600160a01b03166392bfe6d88f8581518110612e5457fe5b6020026020010151886040518363ffffffff1660e01b815260040180836001600160a01b031681526020018281526020019250505060206040518083038186803b158015612ea157600080fd5b505afa158015612eb5573d6000803e3d6000fd5b505050506040513d6020811015612ecb57600080fd5b505190614f02565b6007600088815260200190815260200160002060008e8481518110612ef457fe5b60200260200101516001600160a01b03166001600160a01b0316815260200190815260200160002081905550818181518110612f2c57fe5b6020026020010151600a600088815260200190815260200160002060008e8481518110612f5557fe5b60200260200101516001600160a01b03166001600160a01b03168152602001908152602001600020600082825401925050819055506009600087815260200190815260200160002060008d8381518110612fab57fe5b60200260200101516001600160a01b03166001600160a01b0316815260200190815260200160002054600014156130c4576020548c516001600160a01b03909116906304bb4e43908e9084908110612fff57fe5b6020026020010151866040518363ffffffff1660e01b815260040180836001600160a01b031681526020018281526020019250505060206040518083038186803b15801561304c57600080fd5b505afa158015613060573d6000803e3d6000fd5b505050506040513d602081101561307657600080fd5b505160008781526009602052604081208e519091908f908590811061309757fe5b60200260200101516001600160a01b03166001600160a01b03168152602001908152602001600020819055505b806130ce5761313d565b8181815181106130da57fe5b6020026020010151826000815181106130ef57fe5b6020026020010181815103915081815250508a818151811061310d57fe5b60200260200101518b60008151811061312257fe5b60209081029190910101805191909103905260001901612d4c565b6000868152600c6020526040902080548401905560135461315e908461412a565b601381905550876001600160a01b03167f8b2bc56c62594afde5b520e83e1ca19ebd071798db21382e328014f47b31ce578a8e85604051808481526020018060200180602001838103835285818151815260200191508051906020019060200280838360005b838110156131dc5781810151838201526020016131c4565b50505050905001838103825284818151815260200191508051906020019060200280838360005b8381101561321b578181015183820152602001613203565b505050509050019550505050505060405180910390a2505050505050505050505050565b6132476121fc565b6001600160a01b0316336001600160a01b0316146132a3576040805162461bcd60e51b815260206004820152601460248201527337b7363c9030b2323932b9b9903ab83230ba32b960611b604482015290519081900360640190fd5b6132dc6132d783836040518060400160405280600e81526020016d20b2323932b9b9aab83230ba32b960911b815250614f5b565b615088565b6132e682826150ac565b5050565b60006132f4613d6c565b600280541415613339576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561334a3384846000613f52565b60016002559050611f12614053565b600f5490565b606060008061336c613cca565b909250905060018282030160008167ffffffffffffffff8111801561339057600080fd5b506040519080825280602002602001820160405280156133ba578160200160208202803683370190505b5090506000805b838110156134675760006133d989838901600161479a565b905060005b81606001515181101561345d57816060015181815181106133fb57fe5b6020026020010151158015613427575060008260400151828151811061341d57fe5b6020026020010151115b1561345557600185848151811061343a57fe5b9115156020928302919091019091015260019093019261345d565b6001016133de565b50506001016133c1565b508067ffffffffffffffff8111801561347f57600080fd5b506040519080825280602002602001820160405280156134a9578160200160208202803683370190505b5095506000805b848110156134fa578381815181106134c457fe5b6020026020010151156134f2578087018883815181106134e057fe5b60209081029190910101526001909101905b6001016134b0565b50505050505050919050565b6000611f1282613514613a12565b600e91906146d3565b6000613527613d6c565b60028054141561356c576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561266c338585856000614534565b33600090815260126020526040902061359790826146c0565b7ff650948f1320658fded6be6217b1fe9963894116bc6b3dbc9b1c2cc8cf2cb11f338260405180836001600160a01b03168152602001806020018281038252838181518152602001915080519060200190602002808383600083811015612adc578181015183820152602001612ac4565b6000908152600c6020908152604080832054600d909252909120549091565b601e546001600160a01b031633148061364a57506022546001600160a01b031633145b6136855760405162461bcd60e51b815260040180806020018281038252602c815260200180615ee1602c913960400191505060405180910390fd5b80600554146136d3576040805162461bcd60e51b81526020600482015260156024820152741ddc9bdb99c81c995dd85c9908195c1bd8da081a59605a1b604482015290519081900360640190fd5b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03161580159061370c575060065481105b15613790577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d6c1dbee826040518263ffffffff1660e01b815260040180828152602001915050600060405180830381600087803b15801561377757600080fd5b505af115801561378b573d6000803e3d6000fd5b505050505b6000818152600d6020908152604080832054600c90925290912054601554919003906137bc908261412a565b6015556040805183815290517f5d05c64f281304391697cf987812e1a736413a062a9bdf39af4102209eb6fa589181900360200190a150600101600555565b6000613805613d6c565b60028054141561384a576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561334a3384846001613f52565b6001600160a01b0381166000908152601260209081526040918290208054835181840281018401909452808452606093928301828280156121dc576020028201919060005260206000209081546001600160a01b031681526001909101906020018083116121be5750505050509050919050565b600054600160a81b900460ff1681565b601f5460408051808201909152600e81526d696e666c6174696f6e206f6e6c7960901b6020820152906001600160a01b0316331461395e5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50601c819055601854613971908261412a565b60185542601b556040805182815290517f187f32a0f765499f15b3bb52ed0aebf6015059f230f2ace7e701e60a476695959181900360200190a150565b6060806000806139bc613a12565b90506139c88682614766565b915081806139e2575080861480156139e257506004548610155b15613a085760006139f688888860006151ec565b90508060400151945080606001519350505b5093509350939050565b601e54604080516339f20c3560e21b815290516000926001600160a01b03169163e7c830d4916004808301926020929190829003018186803b15801561228457600080fd5b613a5f6142da565b600019600454146040518060400160405280600f81526020016e185b1c9958591e48195b98589b1959608a1b81525090613ada5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50613ae3613a12565b600481905560408051918252517f1cfb844c44f9325fc9ad6cc6191a4a24b0415137fe300b6c9071523a253f7a089181900360200190a1565b6000828152600a602090815260408083206001600160a01b03909416808452938252808320549483526009825280832093835292905220549091565b601f546001600160a01b031690565b601e5460408051637976d5ad60e11b81526004810184905290516000926001600160a01b03169163f2edab5a916024808301926020929190829003018186803b158015613bb357600080fd5b505afa158015613bc7573d6000803e3d6000fd5b505050506040513d6020811015613bdd57600080fd5b505192915050565b613bed6142da565b600054600160a81b900460ff1615613c4c576040805162461bcd60e51b815260206004820152601a60248201527f616c726561647920696e2070726f64756374696f6e206d6f6465000000000000604482015290519081900360640190fd5b60008054600161ff0160a01b031916600160a81b1790556040805160076001609c1b01815290517f83af113638b5422f9e977cebc0aaf0eaf2188eb9a8baae7f9d46c42b33a1560c9181900360200190a1565b604080518082019091526011815270233a39b7a932bbb0b93226b0b730b3b2b960791b602082015290565b600554600080613cd8613a12565b9050600081116040518060400160405280601f81526020017f6e6f2065706f6368207769746820636c61696d61626c6520726577617264730081525090613d605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50600181039150509091565b60035460408051808201909152601a81527f726577617264206d616e6167657220646561637469766174656400000000000060208201529060ff166129605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b6001600160a01b03821660009081526011602090815260408083203384526001018252918290205482518084019093526013835272636c61696d206578656375746f72206f6e6c7960681b91830191909152613e8f5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50816001600160a01b0316816001600160a01b03161480613ed857506001600160a01b038083166000908152601260209081526040808320938516835260019093019052205415155b604051806040016040528060158152602001741c9958da5c1a595b9d081b9bdd08185b1b1bddd959605a1b8152509061280d5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b6000613f5c6140d0565b50506000613f68613a12565b905060005b845181101561402657613f93858281518110613f8557fe5b602002602001015183614766565b613f9c5761401e565b6000613fbd88878481518110613fae57fe5b6020026020010151600161479a565b90506000613fe08989898681518110613fd257fe5b60200260200101518561552b565b905080600d6000898681518110613ff357fe5b6020026020010151815260200190815260200160002060008282540192505081905550808501945050505b600101613f6d565b50821561403c5761403785836156ba565b614046565b614046858361572e565b5047601d55949350505050565b61405b6157fa565b47146040518060400160405280600e81526020016d6f7574206f662062616c616e636560901b815250906129605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b6000806140e834601d5461412a90919063ffffffff16565b90504791508082111561411c576141148161410e84601a5461412a90919063ffffffff16565b9061581f565b601a55614126565b8082101561412657fe5b9091565b6000828201838110156119ce576040805162461bcd60e51b815260206004820152601b60248201527f536166654d6174683a206164646974696f6e206f766572666c6f770000000000604482015290519081900360640190fd5b60006141a360175461410e60155460165461412a90919063ffffffff16565b905080156129605760006141ba4760146064614e02565b90506000818311156141cd5750806141d0565b50815b801561280d57602154604080516370d5ae0560e01b815290516000926001600160a01b0316916370d5ae05916004808301926020929190829003018186803b15801561421b57600080fd5b505afa15801561422f573d6000803e3d6000fd5b505050506040513d602081101561424557600080fd5b5051601754909150614257908361412a565b601755601d54614267908361581f565b601d556040516001600160a01b0382169083156108fc029084906000818181858888f193505050501580156142a0573d6000803e3d6000fd5b506040805183815290517f44d5cd18c37b86a3423952287006d9550ab3cff404d6e899d5499d9ef87100b59181900360200190a150505050565b6142e2612221565b6001600160a01b0316336001600160a01b031614611b08576040805162461bcd60e51b815260206004820152600f60248201526e6f6e6c7920676f7665726e616e636560881b604482015290519081900360640190fd5b600054600160b01b900460ff16156143665733301461435457fe5b6000805460ff60b01b19169055611b08565b611b086142da565b6143766142da565b600082359050600060076001609c1b016001600160a01b0316636221a54b6040518163ffffffff1660e01b815260040160206040518083038186803b1580156143be57600080fd5b505afa1580156143d2573d6000803e3d6000fd5b505050506040513d60208110156143e857600080fd5b505160408051808201825242830180825282516020601f89018190048102820181019094528781529394509290918281019190889088908190840183828082843760009201829052509390945250506001600160e01b0319861681526001602081815260409092208451815584830151805191945061446c93928501920190615dbd565b509050507fed948300a3694aa01d4a6b258bfd664350193d770c0b51f8387277f6d83ea3b68382878760405180856001600160e01b0319168152602001848152602001806020018281038252848482818152602001925080828437600083820152604051601f909101601f191690920182900397509095505050505050a15050505050565b6000808383111561450757506000905080614510565b50600190508183035b9250929050565b3d604051818101604052816000823e8215614530578181f35b8181fd5b600061453e6140d0565b5050600061454a613a12565b905060005b85518110156145f357614567868281518110613f8557fe5b614570576145eb565b614578615e49565b6145988988848151811061458857fe5b60200260200101518860016151ec565b905060006145ad8a8a8a8681518110613fd257fe5b905080600d60008a86815181106145c057fe5b6020026020010151815260200190815260200160002060008282540192505081905550808501945050505b60010161454f565b5082156146095761460486836156ba565b614613565b614613868361572e565b5047601d5595945050505050565b601e546040805180820190915260118152706674736f206d616e61676572206f6e6c7960781b6020820152906001600160a01b031633146129605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b60006119ce6146b2838561587c565b6146ba61592d565b9061594c565b6146c9826159b3565b6132e68282615a2b565b6001600160a01b0382166000908152600284016020526040812080545b80156147575781546000199091019082908290811061470b57fe5b6000918252602090912001546201000090046001600160f01b031684106147525781818154811061473857fe5b60009182526020909120015461ffff1692506119ce915050565b6146f0565b50505060018301549392505050565b60006005548310806147785750818310155b80614784575060045483105b1561479157506000611f12565b50600192915050565b6147a2615e49565b60006147ad84613b67565b905060006147bc858788615a5c565b905060006147c8615e71565b82156147e957856147e4576147de87898a615a8f565b60208201525b614807565b6147f4888886615ac2565b9150614801878984615c37565b60208201525b8280614817575060008160200151115b151581526020546040805163ed475a7960e01b81526001600160a01b038b811660048301526024820188905291516060938493169163ed475a79916044808301926000929190829003018186803b15801561487157600080fd5b505afa158015614885573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405260808110156148ae57600080fd5b8101908080516040519392919084600160201b8211156148cd57600080fd5b9083019060208201858111156148e257600080fd5b82518660208202830111600160201b821117156148fe57600080fd5b82525081516020918201928201910280838360005b8381101561492b578181015183820152602001614913565b5050505090500160405260200180516040519392919084600160201b82111561495357600080fd5b90830190602082018581111561496857600080fd5b82518660208202830111600160201b8211171561498457600080fd5b82525081516020918201928201910280838360005b838110156149b1578181015183820152602001614999565b5050505091909101604052505083518751949650929450919291506149d990505760006149dc565b60015b60ff160167ffffffffffffffff811180156149f657600080fd5b50604051908082528060200260200182016040528015614a20578160200160208202803683370190505b508088525167ffffffffffffffff81118015614a3b57600080fd5b50604051908082528060200260200182016040528015614a65578160200160208202803683370190505b50602088015286515167ffffffffffffffff81118015614a8457600080fd5b50604051908082528060200260200182016040528015614aae578160200160208202803683370190505b50604088015286515167ffffffffffffffff81118015614acd57600080fd5b50604051908082528060200260200182016040528015614af7578160200160208202803683370190505b506060880152825115614b9b57898760000151600081518110614b1657fe5b60200260200101906001600160a01b031690816001600160a01b031681525050848760600151600081518110614b4857fe5b602002602001019015159081151581525050838760200151600081518110614b6c57fe5b60200260200101818152505082602001518760400151600081518110614b8e57fe5b6020026020010181815250505b815115614df557602080546040805163277166bf60e11b81526001600160a01b038e81166004830152602482018b905291516000949290931692634ee2cd7e92604480840193919291829003018186803b158015614bf857600080fd5b505afa158015614c0c573d6000803e3d6000fd5b505050506040513d6020811015614c2257600080fd5b5051905060005b8351811015614df2576000818660000151614c45576000614c48565b60015b60ff16019050848281518110614c5a57fe5b60200260200101518a600001518281518110614c7257fe5b60200260200101906001600160a01b031690816001600160a01b031681525050614cb08c868481518110614ca257fe5b60200260200101518f615a5c565b8a606001518281518110614cc057fe5b60200260200101901515908115158152505089606001518181518110614ce257fe5b602002602001015115614d34578a614d2f57614d128c868481518110614d0457fe5b60200260200101518f615a8f565b8a604001518281518110614d2257fe5b6020026020010181815250505b614de9565b614d7b858381518110614d4357fe5b6020026020010151614d75868581518110614d5a57fe5b602002602001015161271087614e029092919063ffffffff16565b8e615cc9565b8a602001518281518110614d8b57fe5b602002602001018181525050614dcc8c868481518110614da757fe5b60200260200101518c602001518481518110614dbf57fe5b6020026020010151615c37565b8a604001518281518110614ddc57fe5b6020026020010181815250505b50600101614c29565b50505b5050505050509392505050565b6000808211614e4b576040805162461bcd60e51b815260206004820152601060248201526f4469766973696f6e206279207a65726f60801b604482015290519081900360640190fd5b83614e58575060006119ce565b83830283858281614e6557fe5b041415614e7e57828181614e7557fe5b049150506119ce565b6000838681614e8957fe5b0490506000848781614e9757fe5b0690506000858781614ea557fe5b0490506000868881614eb357fe5b069050614ef5614ec7886146ba8685614f02565b611dba614ed48686614f02565b611dba614ee18987614f02565b611dba8d614eef8c8b614f02565b90614f02565b9998505050505050505050565b600082614f1157506000611f12565b82820282848281614f1e57fe5b04146119ce5760405162461bcd60e51b8152600401808060200182810382526021815260200180615f0d6021913960400191505060405180910390fd5b600080826040516020018080602001828103825283818151815260200191508051906020019080838360005b83811015614f9f578181015183820152602001614f87565b50505050905090810190601f168015614fcc5780820380516001836020036101000a031916815260200191505b50925050506040516020818303038152906040528051906020012090506000805b86518110156150345786818151811061500257fe5b602002602001015183141561502c5785818151811061501d57fe5b60200260200101519150615034565b600101614fed565b506001600160a01b03811661507f576040805162461bcd60e51b815260206004820152600c60248201526b61646472657373207a65726f60a01b604482015290519081900360640190fd5b95945050505050565b7f714f205b2abd25bef1d06a1af944e38c113fe6160375c4e1d6d5cf28848e771955565b6150d882826040518060400160405280600981526020016824b7333630ba34b7b760b91b815250614f5b565b601f60006101000a8154816001600160a01b0302191690836001600160a01b0316021790555061512c82826040518060400160405280600b81526020016a233a39b7a6b0b730b3b2b960a91b815250614f5b565b601e60006101000a8154816001600160a01b0302191690836001600160a01b0316021790555061517982826040518060400160405280600481526020016315d3985d60e21b815250614f5b565b602060006101000a8154816001600160a01b0302191690836001600160a01b031602179055506151c8828260405180604001604052806006815260200165537570706c7960d01b815250614f5b565b602180546001600160a01b0319166001600160a01b03929092169190911790555050565b6151f4615e49565b60006151ff85613b67565b84518584529091508067ffffffffffffffff8111801561521e57600080fd5b50604051908082528060200260200182016040528015615248578160200160208202803683370190505b5060208401528067ffffffffffffffff8111801561526557600080fd5b5060405190808252806020026020018201604052801561528f578160200160208202803683370190505b5060408401528067ffffffffffffffff811180156152ac57600080fd5b506040519080825280602002602001820160405280156152d6578160200160208202803683370190505b50606084015260005b8181101561552057615305878783815181106152f757fe5b60200260200101518a615a5c565b8460600151828151811061531557fe5b6020026020010190151590811515815250508360600151818151811061533757fe5b6020026020010151156153895784615384576153678787838151811061535957fe5b60200260200101518a615a8f565b8460400151828151811061537757fe5b6020026020010181815250505b615518565b876001600160a01b031686828151811061539f57fe5b60200260200101516001600160a01b031614156153e2576153c1888885615ac2565b846020015182815181106153d157fe5b6020026020010181815250506154d3565b60205486516000916001600160a01b03169063e64767aa908b908a908690811061540857fe5b6020026020010151876040518463ffffffff1660e01b815260040180846001600160a01b03168152602001836001600160a01b03168152602001828152602001935050505060206040518083038186803b15801561546557600080fd5b505afa158015615479573d6000803e3d6000fd5b505050506040513d602081101561548f57600080fd5b505187519091506154b5908890849081106154a657fe5b6020026020010151828a615cc9565b856020015183815181106154c557fe5b602002602001018181525050505b6154fb878783815181106154e357fe5b602002602001015186602001518481518110614dbf57fe5b8460400151828151811061550b57fe5b6020026020010181815250505b6001016152df565b505050949350505050565b600080805b8351518110156156b0578360600151818151811061554a57fe5b60200260200101511561555c576156a8565b60008460000151828151811061556e57fe5b6020026020010151905060008560200151838151811061558a57fe5b6020026020010151905060008111156155c75760008781526007602090815260408083206001600160a01b03861684529091529020805482900390555b6000866040015184815181106155d957fe5b6020026020010151905060008111156156225760008881526008602090815260408083206001600160a01b03871684529091529020805482900390556014805482019055938401935b6000888152600b602090815260408083206001600160a01b038088168086529184528285208f821680875290855294839020805460ff191660019081178255810187905583518e815294850187905283519095918f169491937f6ec685171a9028d19dc155a48e7824e3c68b03bc8995410e006abe3cbbeb3e2d928290030190a4505050505b600101615530565b5095945050505050565b80156132e6576020546040805163b760faf960e01b81526001600160a01b0385811660048301529151919092169163b760faf991849160248082019260009290919082900301818588803b15801561571157600080fd5b505af1158015615725573d6000803e3d6000fd5b50505050505050565b80156132e6576040516000906001600160a01b0384169083908381818185875af1925050503d806000811461577f576040519150601f19603f3d011682016040523d82523d6000602084013e615784565b606091505b50509050806040518060400160405280600c81526020016b18db185a5b4819985a5b195960a21b815250906126055760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b60006122b160175461410e60145461410e601a5460195461412a90919063ffffffff16565b600082821115615876576040805162461bcd60e51b815260206004820152601e60248201527f536166654d6174683a207375627472616374696f6e206f766572666c6f770000604482015290519081900360640190fd5b50900390565b60008061589762093a7f601b5461412a90919063ffffffff16565b905080841115604051806040016040528060118152602001706166746572206461696c79206379636c6560781b815250906159135760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50615922836146ba838761581f565b600101949350505050565b60006122b160165461410e60135460185461581f90919063ffffffff16565b60008082116159a2576040805162461bcd60e51b815260206004820152601a60248201527f536166654d6174683a206469766973696f6e206279207a65726f000000000000604482015290519081900360640190fd5b8183816159ab57fe5b049392505050565b8054156129605780546001820190600090839060001981019081106159d457fe5b60009182526020808320909101546001600160a01b031683528201929092526040018120558054819080615a0457fe5b600082815260209020810160001990810180546001600160a01b03191690550190556159b3565b60005b815181101561280d57615a5483838381518110615a4757fe5b6020026020010151615d10565b600101615a2e565b6000928352600b602090815260408085206001600160a01b03948516865282528085209290931684525290205460ff1690565b6000928352600b602090815260408085206001600160a01b03948516865282528085209290931684525290206001015490565b6020805460408051634181ad4160e11b81526001600160a01b038781166004830152602482018690529151600094859493909316926383035a829260448082019391829003018186803b158015615b1857600080fd5b505afa158015615b2c573d6000803e3d6000fd5b505050506040513d6020811015615b4257600080fd5b50516020805460408051631257fcdb60e31b81526001600160a01b038a8116600483015260248201899052915194955060009491909216926392bfe6d89260448082019391829003018186803b158015615b9b57600080fd5b505afa158015615baf573d6000803e3d6000fd5b505050506040513d6020811015615bc557600080fd5b5051905081811415615be657615bdd81612710614f02565b925050506119ce565b818111615bef57fe5b60008215615c0557615c0383612710614f02565b015b6000615c13600e89896146d3565b90508015615c2c57615c2784840382614f02565b820191505b509695505050505050565b600081615c46575060006119ce565b60008481526008602090815260408083206001600160a01b038716845290915290205480615c785760009150506119ce565b60008581526007602090815260408083206001600160a01b038816845290915290205483811415615cab575090506119ce565b808410615cb457fe5b615cbf828583614e02565b9695505050505050565b600082615cd8575060006119ce565b600080615ce7600e87866146d3565b9050612710811015615d0757615d0285612710839003614f02565b820191505b50949350505050565b6001600160a01b038116600090815260018301602052604090205415615d35576132e6565b8154600180820184556000848152602080822090930180546001600160a01b0319166001600160a01b03959095169485179055845493815293019052604090912055565b50805460018160011615610100020316600290046000825580601f10615d9f5750612960565b601f0160209004906000526020600020908101906129609190615e88565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282615df35760008555615e39565b82601f10615e0c57805160ff1916838001178555615e39565b82800160010185558215615e39579182015b82811115615e39578251825591602001919060010190615e1e565b50615e45929150615e88565b5090565b6040518060800160405280606081526020016060815260200160608152602001606081525090565b604080518082019091526000808252602082015290565b5b80821115615e455760008155600101615e8956fe5265656e7472616e637947756172643a207265656e7472616e742063616c6c006e6577206674736f20726577617264206d616e6167657220616c7265616479207365746f6e6c79206674736f206d616e61676572206f72206e6577206674736f20726577617264206d616e61676572536166654d6174683a206d756c7469706c69636174696f6e206f766572666c6f77a26469706673582212200f373fa48dad252b853ae0e397b7ecdb86a61ad2b579e92edefd6d57fa8ae01664736f6c634300070600330000000000000000000000004598a6c05910ab914f0cbaaca1911cd337d10d29000000000000000000000000baf89d873d198ff78e72d2745b01cba3c6e5be6b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000007d0
Deployed ByteCode
0x60806040526004361061038c5760003560e01c806384e10a90116101dc578063d2a4ac6111610102578063e416b7e1116100a0578063ed39d3f81161006f578063ed39d3f814611854578063f2edab5a14611869578063f5a9838314611893578063f5f5ba72146118a85761038c565b8063e416b7e11461168c578063e7c830d4146117f1578063ea28edad14611806578063eb82dd7f1461181b5761038c565b8063d93bb92a116100dc578063d93bb92a1461155c578063dfd14c341461161a578063e17f212e1461164d578063e2739563146116625761038c565b8063d2a4ac611461145a578063d418634a14611508578063d6c1dbee146115325761038c565b8063a4472c101161017a578063b482403411610149578063b48240341461129f578063b4a2043d146112b4578063cfbcd25f146112e7578063d20bb5421461131a5761038c565b8063a4472c1014610e34578063a9b79e1714610f54578063b00c0b76146110b1578063b2af870a146111e15761038c565b80639119c494116101b65780639119c49414610d05578063961c00ed14610db35780639d6a890f14610dec5780639edbf00714610e1f5761038c565b806384e10a9014610afb57806385b4c53814610b6057806387c233cb14610bbc5761038c565b806333b7971e116102c1578063614815901161025f57806367fc40291161022e57806367fc4029146109cc57806374e6310e14610a005780637b6b2c0a14610ab357806382a2b90514610ac85761038c565b8063614815901461080857806362354e0314610948578063657d96951461095d57806367dcac53146109965761038c565b806351b42b001161029b57806351b42b00146107955780635267a15d146107aa5780635aa6e675146107bf5780635ff27079146107d45761038c565b806333b7971e146105ec5780633e7ff857146106fd5780633f317fe1146107125761038c565b806311a7aaaa1161032e57806316fe49c71161030857806316fe49c71461057a5780631de560981461058f5780632dafdbbf146105a45780633123b7d8146105d75761038c565b806311a7aaaa1461052657806312f97ac01461053b57806316e69328146105505761038c565b8063047fc9aa1161036a578063047fc9aa146104c157806306201f1d146104f25780630cb72344146104fc5780630f15f4c0146105115761038c565b806302fb0c5e146103915780630441218e146103ba578063045198fe146103e8575b600080fd5b34801561039d57600080fd5b506103a6611932565b604080519115158252519081900360200190f35b3480156103c657600080fd5b506103cf61193b565b6040805192835260208301919091528051918290030190f35b3480156103f457600080fd5b506104af6004803603606081101561040b57600080fd5b6001600160a01b038235811692602081013590911691810190606081016040820135600160201b81111561043e57600080fd5b82018360208201111561045057600080fd5b803590602001918460208302840111600160201b8311171561047157600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061194f945050505050565b60408051918252519081900360200190f35b3480156104cd57600080fd5b506104d66119d5565b604080516001600160a01b039092168252519081900360200190f35b6104fa6119e4565b005b34801561050857600080fd5b506104d6611b0a565b34801561051d57600080fd5b506104fa611b2e565b34801561053257600080fd5b506104d6611be6565b34801561054757600080fd5b506104d6611bf5565b34801561055c57600080fd5b506104af6004803603602081101561057357600080fd5b5035611c04565b34801561058657600080fd5b506104af611ce0565b34801561059b57600080fd5b506104fa611ce6565b3480156105b057600080fd5b506105b9611ed6565b60408051938452602084019290925282820152519081900360600190f35b3480156105e357600080fd5b506104af611f01565b3480156105f857600080fd5b5061061f6004803603602081101561060f57600080fd5b50356001600160a01b0316611f18565b60405180806020018060200180602001848103845287818151815260200191508051906020019060200280838360005b8381101561066757818101518382015260200161064f565b50505050905001848103835286818151815260200191508051906020019060200280838360005b838110156106a657818101518382015260200161068e565b50505050905001848103825285818151815260200191508051906020019060200280838360005b838110156106e55781810151838201526020016106cd565b50505050905001965050505050505060405180910390f35b34801561070957600080fd5b506104af61216c565b34801561071e57600080fd5b506107456004803603602081101561073557600080fd5b50356001600160a01b0316612172565b60408051602080825283518183015283519192839290830191858101910280838360005b83811015610781578181015183820152602001610769565b505050509050019250505060405180910390f35b3480156107a157600080fd5b506104fa6121e8565b3480156107b657600080fd5b506104d66121fc565b3480156107cb57600080fd5b506104d6612221565b3480156107e057600080fd5b506104fa600480360360208110156107f757600080fd5b50356001600160e01b0319166122b6565b34801561081457600080fd5b506104af6004803603606081101561082b57600080fd5b6001600160a01b038235169190810190604081016020820135600160201b81111561085557600080fd5b82018360208201111561086757600080fd5b803590602001918460208302840111600160201b8311171561088857600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b8111156108d757600080fd5b8201836020820111156108e957600080fd5b803590602001918460208302840111600160201b8311171561090a57600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061260b945050505050565b34801561095457600080fd5b506104d661267b565b34801561096957600080fd5b506103cf6004803603604081101561098057600080fd5b50803590602001356001600160a01b0316612686565b3480156109a257600080fd5b506104fa600480360360608110156109b957600080fd5b50803590602081013590604001356126c2565b3480156109d857600080fd5b506104fa600480360360208110156109ef57600080fd5b50356001600160e01b03191661272a565b348015610a0c57600080fd5b50610a3460048036036020811015610a2357600080fd5b50356001600160e01b031916612812565b6040518083815260200180602001828103825283818151815260200191508051906020019080838360005b83811015610a77578181015183820152602001610a5f565b50505050905090810190601f168015610aa45780820380516001836020036101000a031916815260200191505b50935050505060405180910390f35b348015610abf57600080fd5b506104af6128b8565b348015610ad457600080fd5b506104fa60048036036020811015610aeb57600080fd5b50356001600160a01b03166128be565b348015610b0757600080fd5b50610b10612963565b604080519a8b5260208b0199909952898901979097526060890195909552608088019390935260a087019190915260c086015260e085015261010084015261012083015251908190036101400190f35b348015610b6c57600080fd5b50610ba160048036036060811015610b8357600080fd5b508035906001600160a01b036020820135811691604001351661298d565b60408051921515835260208301919091528051918290030190f35b348015610bc857600080fd5b506104af60048036036080811015610bdf57600080fd5b6001600160a01b038235811692602081013590911691810190606081016040820135600160201b811115610c1257600080fd5b820183602082011115610c2457600080fd5b803590602001918460208302840111600160201b83111715610c4557600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b811115610c9457600080fd5b820183602082011115610ca657600080fd5b803590602001918460208302840111600160201b83111715610cc757600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506129c9945050505050565b348015610d1157600080fd5b506104fa60048036036020811015610d2857600080fd5b810190602081018135600160201b811115610d4257600080fd5b820183602082011115610d5457600080fd5b803590602001918460208302840111600160201b83111715610d7557600080fd5b919080806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250929550612a51945050505050565b348015610dbf57600080fd5b506104af60048036036040811015610dd657600080fd5b506001600160a01b038135169060200135612af3565b348015610df857600080fd5b506104fa60048036036020811015610e0f57600080fd5b50356001600160a01b0316612b6e565b348015610e2b57600080fd5b506104d6612c27565b348015610e4057600080fd5b50610e6d60048036036040811015610e5757600080fd5b506001600160a01b038135169060200135612c36565b604051808060200180602001806020018515158152602001848103845288818151815260200191508051906020019060200280838360005b83811015610ebd578181015183820152602001610ea5565b50505050905001848103835287818151815260200191508051906020019060200280838360005b83811015610efc578181015183820152602001610ee4565b50505050905001848103825286818151815260200191508051906020019060200280838360005b83811015610f3b578181015183820152602001610f23565b5050505090500197505050505050505060405180910390f35b348015610f6057600080fd5b506104fa6004803603610120811015610f7857600080fd5b810190602081018135600160201b811115610f9257600080fd5b820183602082011115610fa457600080fd5b803590602001918460208302840111600160201b83111715610fc557600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b81111561101457600080fd5b82018360208201111561102657600080fd5b803590602001918460208302840111600160201b8311171561104757600080fd5b919080806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250929550508235935050506020810135906001600160a01b036040820135169060608101359060808101359060a08101359060c00135612ca0565b3480156110bd57600080fd5b506104fa600480360360408110156110d457600080fd5b810190602081018135600160201b8111156110ee57600080fd5b82018360208201111561110057600080fd5b803590602001918460208302840111600160201b8311171561112157600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b81111561117057600080fd5b82018360208201111561118257600080fd5b803590602001918460208302840111600160201b831117156111a357600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061323f945050505050565b3480156111ed57600080fd5b506104af6004803603604081101561120457600080fd5b6001600160a01b038235169190810190604081016020820135600160201b81111561122e57600080fd5b82018360208201111561124057600080fd5b803590602001918460208302840111600160201b8311171561126157600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506132ea945050505050565b3480156112ab57600080fd5b506104af613359565b3480156112c057600080fd5b50610745600480360360208110156112d757600080fd5b50356001600160a01b031661335f565b3480156112f357600080fd5b506104af6004803603602081101561130a57600080fd5b50356001600160a01b0316613506565b34801561132657600080fd5b506104af6004803603606081101561133d57600080fd5b6001600160a01b038235169190810190604081016020820135600160201b81111561136757600080fd5b82018360208201111561137957600080fd5b803590602001918460208302840111600160201b8311171561139a57600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295949360208101935035915050600160201b8111156113e957600080fd5b8201836020820111156113fb57600080fd5b803590602001918460208302840111600160201b8311171561141c57600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061351d945050505050565b34801561146657600080fd5b506104fa6004803603602081101561147d57600080fd5b810190602081018135600160201b81111561149757600080fd5b8201836020820111156114a957600080fd5b803590602001918460208302840111600160201b831117156114ca57600080fd5b91908080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525092955061357e945050505050565b34801561151457600080fd5b506103cf6004803603602081101561152b57600080fd5b5035613608565b34801561153e57600080fd5b506104fa6004803603602081101561155557600080fd5b5035613627565b34801561156857600080fd5b506104af6004803603604081101561157f57600080fd5b6001600160a01b038235169190810190604081016020820135600160201b8111156115a957600080fd5b8201836020820111156115bb57600080fd5b803590602001918460208302840111600160201b831117156115dc57600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506137fb945050505050565b34801561162657600080fd5b506107456004803603602081101561163d57600080fd5b50356001600160a01b031661385b565b34801561165957600080fd5b506103a66138cf565b34801561166e57600080fd5b506104fa6004803603602081101561168557600080fd5b50356138df565b34801561169857600080fd5b5061174f600480360360608110156116af57600080fd5b6001600160a01b0382351691602081013591810190606081016040820135600160201b8111156116de57600080fd5b8201836020820111156116f057600080fd5b803590602001918460208302840111600160201b8311171561171157600080fd5b9190808060200260200160405190810160405280939291908181526020018383602002808284376000920191909152509295506139ae945050505050565b6040518080602001806020018415158152602001838103835286818151815260200191508051906020019060200280838360005b8381101561179b578181015183820152602001611783565b50505050905001838103825285818151815260200191508051906020019060200280838360005b838110156117da5781810151838201526020016117c2565b505050509050019550505050505060405180910390f35b3480156117fd57600080fd5b506104af613a12565b34801561181257600080fd5b506104fa613a57565b34801561182757600080fd5b506103cf6004803603604081101561183e57600080fd5b50803590602001356001600160a01b0316613b1c565b34801561186057600080fd5b506104d6613b58565b34801561187557600080fd5b506104af6004803603602081101561188c57600080fd5b5035613b67565b34801561189f57600080fd5b506104fa613be5565b3480156118b457600080fd5b506118bd613c9f565b6040805160208082528351818301528351919283929083019185019080838360005b838110156118f75781810151838201526020016118df565b50505050905090810190601f1680156119245780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b60035460ff1681565b600080611946613cca565b90939092509050565b6000611959613d6c565b60028054141561199e576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805583836119ae8282613df2565b6119bb8686866001613f52565b600160025592506119ce91506140539050565b9392505050565b6021546001600160a01b031681565b601f5460408051808201909152600e81526d696e666c6174696f6e206f6e6c7960901b6020820152906001600160a01b03163314611aa05760405162461bcd60e51b81526004018080602001828103825283818151815260200191508051906020019080838360005b83811015611a65578181015183820152602001611a4d565b50505050905090810190601f168015611a925780820380516001836020036101000a031916815260200191505b509250505060405180910390fd5b506000611aab6140d0565b50601954909150611abc903461412a565b601955601d819055611acc614184565b6040805134815290517f95c4e29cc99bc027cfc3cd719d6fd973d5f0317061885fbb322b9b17d8d35d379181900360200190a150611b08614053565b565b7f000000000000000000000000000000000000000000000000000000000000000081565b611b366142da565b601f546001600160a01b031615801590611b5a5750601e546001600160a01b031615155b8015611b7057506020546001600160a01b031615155b8015611b8657506021546001600160a01b031615155b611bd7576040805162461bcd60e51b815260206004820152601a60248201527f636f6e747261637420616464726573736573206e6f7420736574000000000000604482015290519081900360640190fd5b6003805460ff19166001179055565b601e546001600160a01b031681565b6022546001600160a01b031681565b60008073f478a974891341818ab347cf09bab8a22bad91bc63e937a562600e85611c2c613a12565b6040518463ffffffff1660e01b815260040180848152602001838152602001828152602001935050505060206040518083038186803b158015611c6e57600080fd5b505af4158015611c82573d6000803e3d6000fd5b505050506040513d6020811015611c9857600080fd5b50516040805185815260208101839052815192935033927fd89f05622c2dcb0b4fcaa19e62fc2a2b0923955685fb7b0c641467f764244abc929181900390910190a292915050565b600e5490565b600054600160b01b900460ff1680611d085750600054600160a81b900460ff16155b15611ecb57611d15614339565b60035460ff16158015611d5057507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031615155b8015611d5c5750600654155b8015611d685750600554155b611dad576040805162461bcd60e51b81526020600482015260116024820152706e6f7420696e697469616c20737461746560781b604482015290519081900360640190fd5b611dc06001611dba613a12565b9061412a565b600655601e5460408051633e7ff85760e01b815290516001600160a01b0390921691633e7ff85791600480820192602092909190829003018186803b158015611e0857600080fd5b505afa158015611e1c573d6000803e3d6000fd5b505050506040513d6020811015611e3257600080fd5b505160055560408051633db5960560e11b815290516001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001691637b6b2c0a916004808301926020929190829003018186803b158015611e9757600080fd5b505afa158015611eab573d6000803e3d6000fd5b505050506040513d6020811015611ec157600080fd5b5051600455611b08565b611b0860003661436e565b600080600080601854611ef660175460145461412a90919063ffffffff16565b925092509250909192565b600654600090611f129060016144f1565b92915050565b6060808073f478a974891341818ab347cf09bab8a22bad91bc6325459925600e86611f41613a12565b6040518463ffffffff1660e01b815260040180848152602001836001600160a01b03168152602001828152602001935050505060006040518083038186803b158015611f8c57600080fd5b505af4158015611fa0573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526060811015611fc957600080fd5b8101908080516040519392919084600160201b821115611fe857600080fd5b908301906020820185811115611ffd57600080fd5b82518660208202830111600160201b8211171561201957600080fd5b82525081516020918201928201910280838360005b8381101561204657818101518382015260200161202e565b5050505090500160405260200180516040519392919084600160201b82111561206e57600080fd5b90830190602082018581111561208357600080fd5b82518660208202830111600160201b8211171561209f57600080fd5b82525081516020918201928201910280838360005b838110156120cc5781810151838201526020016120b4565b5050505090500160405260200180516040519392919084600160201b8211156120f457600080fd5b90830190602082018581111561210957600080fd5b82518660208202830111600160201b8211171561212557600080fd5b82525081516020918201928201910280838360005b8381101561215257818101518382015260200161213a565b505050509050016040525050509250925092509193909250565b60055490565b6001600160a01b0381166000908152601160209081526040918290208054835181840281018401909452808452606093928301828280156121dc57602002820191906000526020600020905b81546001600160a01b031681526001909101906020018083116121be575b50505050509050919050565b6121f06142da565b6003805460ff19169055565b7f714f205b2abd25bef1d06a1af944e38c113fe6160375c4e1d6d5cf28848e77195490565b60008054600160a81b900460ff16612244576000546001600160a01b03166122b1565b60076001609c1b016001600160a01b031663732524946040518163ffffffff1660e01b815260040160206040518083038186803b15801561228457600080fd5b505afa158015612298573d6000803e3d6000fd5b505050506040513d60208110156122ae57600080fd5b50515b905090565b60408051630debfda360e41b8152336004820152905160076001609c1b019163debfda30916024808301926020929190829003018186803b1580156122fa57600080fd5b505afa15801561230e573d6000803e3d6000fd5b505050506040513d602081101561232457600080fd5b5051612367576040805162461bcd60e51b815260206004820152600d60248201526c37b7363c9032bc32b1baba37b960991b604482015290519081900360640190fd5b6001600160e01b03198116600090815260016020526040902080546123d3576040805162461bcd60e51b815260206004820152601a60248201527f74696d656c6f636b3a20696e76616c69642073656c6563746f72000000000000604482015290519081900360640190fd5b8054421015612429576040805162461bcd60e51b815260206004820152601960248201527f74696d656c6f636b3a206e6f7420616c6c6f7765642079657400000000000000604482015290519081900360640190fd5b6000816001018054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156124c35780601f10612498576101008083540402835291602001916124c3565b820191906000526020600020905b8154815290600101906020018083116124a657829003601f168201915b5050506001600160e01b03198616600090815260016020819052604082208281559495509092506124f79150830182615d79565b50506000805460ff60b01b1916600160b01b178155604051825130918491819060208401908083835b6020831061253f5780518252601f199092019160209182019101612520565b6001836020036101000a0380198251168184511680821785525050505050509050019150506000604051808303816000865af19150503d80600081146125a1576040519150601f19603f3d011682016040523d82523d6000602084013e6125a6565b606091505b50506000805460ff60b01b19169055604080516001600160e01b03198716815242602082015281519293507fa7326b57fc9cfe267aaea5e7f0b01757154d265620a0585819416ee9ddd2c438929081900390910190a161260581614517565b50505050565b6000612615613d6c565b60028054141561265a576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561266c338585856001614534565b600160025590506119ce614053565b60076001609c1b0181565b60008281526008602090815260408083206001600160a01b03909416808452938252808320549483526007825280832093835292905220549091565b6126ca614621565b60006126d683836146a3565b6016549091506126e6908261412a565b601655604080518581526020810183905281517f754fa5a3ace0438b80ec651f7d61e44f761a808ebd17d7ce70da619399611a08929181900390910190a150505050565b6127326142da565b6001600160e01b0319811660009081526001602052604090205461279d576040805162461bcd60e51b815260206004820152601a60248201527f74696d656c6f636b3a20696e76616c69642073656c6563746f72000000000000604482015290519081900360640190fd5b604080516001600160e01b03198316815242602082015281517f7735b2391c38a81419c513e30ca578db7158eadd7101511b23e221c654d19cf8929181900390910190a16001600160e01b0319811660009081526001602081905260408220828155919061280d90830182615d79565b505050565b600160208181526000928352604092839020805481840180548651600296821615610100026000190190911695909504601f810185900485028601850190965285855290949193929091908301828280156128ae5780601f10612883576101008083540402835291602001916128ae565b820191906000526020600020905b81548152906001019060200180831161289157829003601f168201915b5050505050905082565b60045481565b600054600160b01b900460ff16806128e05750600054600160a81b900460ff16155b15612955576128ed614339565b6022546001600160a01b0316156129355760405162461bcd60e51b8152600401808060200182810382526023815260200180615ebe6023913960400191505060405180910390fd5b602280546001600160a01b0319166001600160a01b038316179055612960565b61296060003661436e565b50565b601354601454601554601654601754601854601954601a54601b54601c5490919293949596979899565b6000928352600b602090815260408085206001600160a01b0394851686528252808520929093168452529020805460019091015460ff90911691565b60006129d3613d6c565b600280541415612a18576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b600280558484612a288282613df2565b612a36878787876001614534565b60016002559250612a4991506140539050565b949350505050565b336000908152601160205260409020612a6a90826146c0565b7fa802dcd9d0db82c5fc0b043e16d9ab77391cff1b84415bce9e95c4a8d6fe7146338260405180836001600160a01b0316815260200180602001828103825283818151815260200191508051906020019060200280838360005b83811015612adc578181015183820152602001612ac4565b50505050905001935050505060405180910390a150565b600081612afe611f01565b11158015612b1a5750600e54612b1690611dba613a12565b8211155b612b62576040805162461bcd60e51b81526020600482015260146024820152730d2dcecc2d8d2c840e4caeec2e4c840cae0dec6d60631b604482015290519081900360640190fd5b6119ce600e84846146d3565b600054600160a01b900460ff1615612bc4576040805162461bcd60e51b8152602060048201526014602482015273696e697469616c6973656420213d2066616c736560601b604482015290519081900360640190fd5b60008054600160a01b60ff60a01b19909116176001600160a01b0319166001600160a01b03831690811790915560408051918252517f9789733827840833afc031fb2ef9ab6894271f77bad2085687cf4ae5c7bee4db916020908290030190a150565b6020546001600160a01b031681565b6060806060600080612c46613a12565b9050612c528682614766565b91508180612c6c57508086148015612c6c57506004548610155b15612c96576000612c7f8888600061479a565b805160408201516060909201519097509095509350505b5092959194509250565b612ca8614621565b8615801590612cb75750885115155b612cbd57fe5b6000612cc985846146a3565b905060008a5167ffffffffffffffff81118015612ce557600080fd5b50604051908082528060200260200182016040528015612d0f578160200160208202803683370190505b5090508181600081518110612d2057fe5b602002602001018181525050888a600081518110612d3a57fe5b60209081029190910101528a51600019015b612d9c8b8281518110612d5b57fe5b60200260200101518c600081518110612d7057fe5b602002602001015184600081518110612d8557fe5b6020026020010151614e029092919063ffffffff16565b828281518110612da857fe5b602002602001018181525050818181518110612dc057fe5b60200260200101516008600088815260200190815260200160002060008e8481518110612de957fe5b60200260200101516001600160a01b03166001600160a01b0316815260200190815260200160002060008282540192505081905550612ed3612710602060009054906101000a90046001600160a01b03166001600160a01b03166392bfe6d88f8581518110612e5457fe5b6020026020010151886040518363ffffffff1660e01b815260040180836001600160a01b031681526020018281526020019250505060206040518083038186803b158015612ea157600080fd5b505afa158015612eb5573d6000803e3d6000fd5b505050506040513d6020811015612ecb57600080fd5b505190614f02565b6007600088815260200190815260200160002060008e8481518110612ef457fe5b60200260200101516001600160a01b03166001600160a01b0316815260200190815260200160002081905550818181518110612f2c57fe5b6020026020010151600a600088815260200190815260200160002060008e8481518110612f5557fe5b60200260200101516001600160a01b03166001600160a01b03168152602001908152602001600020600082825401925050819055506009600087815260200190815260200160002060008d8381518110612fab57fe5b60200260200101516001600160a01b03166001600160a01b0316815260200190815260200160002054600014156130c4576020548c516001600160a01b03909116906304bb4e43908e9084908110612fff57fe5b6020026020010151866040518363ffffffff1660e01b815260040180836001600160a01b031681526020018281526020019250505060206040518083038186803b15801561304c57600080fd5b505afa158015613060573d6000803e3d6000fd5b505050506040513d602081101561307657600080fd5b505160008781526009602052604081208e519091908f908590811061309757fe5b60200260200101516001600160a01b03166001600160a01b03168152602001908152602001600020819055505b806130ce5761313d565b8181815181106130da57fe5b6020026020010151826000815181106130ef57fe5b6020026020010181815103915081815250508a818151811061310d57fe5b60200260200101518b60008151811061312257fe5b60209081029190910101805191909103905260001901612d4c565b6000868152600c6020526040902080548401905560135461315e908461412a565b601381905550876001600160a01b03167f8b2bc56c62594afde5b520e83e1ca19ebd071798db21382e328014f47b31ce578a8e85604051808481526020018060200180602001838103835285818151815260200191508051906020019060200280838360005b838110156131dc5781810151838201526020016131c4565b50505050905001838103825284818151815260200191508051906020019060200280838360005b8381101561321b578181015183820152602001613203565b505050509050019550505050505060405180910390a2505050505050505050505050565b6132476121fc565b6001600160a01b0316336001600160a01b0316146132a3576040805162461bcd60e51b815260206004820152601460248201527337b7363c9030b2323932b9b9903ab83230ba32b960611b604482015290519081900360640190fd5b6132dc6132d783836040518060400160405280600e81526020016d20b2323932b9b9aab83230ba32b960911b815250614f5b565b615088565b6132e682826150ac565b5050565b60006132f4613d6c565b600280541415613339576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561334a3384846000613f52565b60016002559050611f12614053565b600f5490565b606060008061336c613cca565b909250905060018282030160008167ffffffffffffffff8111801561339057600080fd5b506040519080825280602002602001820160405280156133ba578160200160208202803683370190505b5090506000805b838110156134675760006133d989838901600161479a565b905060005b81606001515181101561345d57816060015181815181106133fb57fe5b6020026020010151158015613427575060008260400151828151811061341d57fe5b6020026020010151115b1561345557600185848151811061343a57fe5b9115156020928302919091019091015260019093019261345d565b6001016133de565b50506001016133c1565b508067ffffffffffffffff8111801561347f57600080fd5b506040519080825280602002602001820160405280156134a9578160200160208202803683370190505b5095506000805b848110156134fa578381815181106134c457fe5b6020026020010151156134f2578087018883815181106134e057fe5b60209081029190910101526001909101905b6001016134b0565b50505050505050919050565b6000611f1282613514613a12565b600e91906146d3565b6000613527613d6c565b60028054141561356c576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561266c338585856000614534565b33600090815260126020526040902061359790826146c0565b7ff650948f1320658fded6be6217b1fe9963894116bc6b3dbc9b1c2cc8cf2cb11f338260405180836001600160a01b03168152602001806020018281038252838181518152602001915080519060200190602002808383600083811015612adc578181015183820152602001612ac4565b6000908152600c6020908152604080832054600d909252909120549091565b601e546001600160a01b031633148061364a57506022546001600160a01b031633145b6136855760405162461bcd60e51b815260040180806020018281038252602c815260200180615ee1602c913960400191505060405180910390fd5b80600554146136d3576040805162461bcd60e51b81526020600482015260156024820152741ddc9bdb99c81c995dd85c9908195c1bd8da081a59605a1b604482015290519081900360640190fd5b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03161580159061370c575060065481105b15613790577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d6c1dbee826040518263ffffffff1660e01b815260040180828152602001915050600060405180830381600087803b15801561377757600080fd5b505af115801561378b573d6000803e3d6000fd5b505050505b6000818152600d6020908152604080832054600c90925290912054601554919003906137bc908261412a565b6015556040805183815290517f5d05c64f281304391697cf987812e1a736413a062a9bdf39af4102209eb6fa589181900360200190a150600101600555565b6000613805613d6c565b60028054141561384a576040805162461bcd60e51b815260206004820152601f6024820152600080516020615e9e833981519152604482015290519081900360640190fd5b6002805561334a3384846001613f52565b6001600160a01b0381166000908152601260209081526040918290208054835181840281018401909452808452606093928301828280156121dc576020028201919060005260206000209081546001600160a01b031681526001909101906020018083116121be5750505050509050919050565b600054600160a81b900460ff1681565b601f5460408051808201909152600e81526d696e666c6174696f6e206f6e6c7960901b6020820152906001600160a01b0316331461395e5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50601c819055601854613971908261412a565b60185542601b556040805182815290517f187f32a0f765499f15b3bb52ed0aebf6015059f230f2ace7e701e60a476695959181900360200190a150565b6060806000806139bc613a12565b90506139c88682614766565b915081806139e2575080861480156139e257506004548610155b15613a085760006139f688888860006151ec565b90508060400151945080606001519350505b5093509350939050565b601e54604080516339f20c3560e21b815290516000926001600160a01b03169163e7c830d4916004808301926020929190829003018186803b15801561228457600080fd5b613a5f6142da565b600019600454146040518060400160405280600f81526020016e185b1c9958591e48195b98589b1959608a1b81525090613ada5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50613ae3613a12565b600481905560408051918252517f1cfb844c44f9325fc9ad6cc6191a4a24b0415137fe300b6c9071523a253f7a089181900360200190a1565b6000828152600a602090815260408083206001600160a01b03909416808452938252808320549483526009825280832093835292905220549091565b601f546001600160a01b031690565b601e5460408051637976d5ad60e11b81526004810184905290516000926001600160a01b03169163f2edab5a916024808301926020929190829003018186803b158015613bb357600080fd5b505afa158015613bc7573d6000803e3d6000fd5b505050506040513d6020811015613bdd57600080fd5b505192915050565b613bed6142da565b600054600160a81b900460ff1615613c4c576040805162461bcd60e51b815260206004820152601a60248201527f616c726561647920696e2070726f64756374696f6e206d6f6465000000000000604482015290519081900360640190fd5b60008054600161ff0160a01b031916600160a81b1790556040805160076001609c1b01815290517f83af113638b5422f9e977cebc0aaf0eaf2188eb9a8baae7f9d46c42b33a1560c9181900360200190a1565b604080518082019091526011815270233a39b7a932bbb0b93226b0b730b3b2b960791b602082015290565b600554600080613cd8613a12565b9050600081116040518060400160405280601f81526020017f6e6f2065706f6368207769746820636c61696d61626c6520726577617264730081525090613d605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50600181039150509091565b60035460408051808201909152601a81527f726577617264206d616e6167657220646561637469766174656400000000000060208201529060ff166129605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b6001600160a01b03821660009081526011602090815260408083203384526001018252918290205482518084019093526013835272636c61696d206578656375746f72206f6e6c7960681b91830191909152613e8f5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50816001600160a01b0316816001600160a01b03161480613ed857506001600160a01b038083166000908152601260209081526040808320938516835260019093019052205415155b604051806040016040528060158152602001741c9958da5c1a595b9d081b9bdd08185b1b1bddd959605a1b8152509061280d5760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b6000613f5c6140d0565b50506000613f68613a12565b905060005b845181101561402657613f93858281518110613f8557fe5b602002602001015183614766565b613f9c5761401e565b6000613fbd88878481518110613fae57fe5b6020026020010151600161479a565b90506000613fe08989898681518110613fd257fe5b60200260200101518561552b565b905080600d6000898681518110613ff357fe5b6020026020010151815260200190815260200160002060008282540192505081905550808501945050505b600101613f6d565b50821561403c5761403785836156ba565b614046565b614046858361572e565b5047601d55949350505050565b61405b6157fa565b47146040518060400160405280600e81526020016d6f7574206f662062616c616e636560901b815250906129605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b6000806140e834601d5461412a90919063ffffffff16565b90504791508082111561411c576141148161410e84601a5461412a90919063ffffffff16565b9061581f565b601a55614126565b8082101561412657fe5b9091565b6000828201838110156119ce576040805162461bcd60e51b815260206004820152601b60248201527f536166654d6174683a206164646974696f6e206f766572666c6f770000000000604482015290519081900360640190fd5b60006141a360175461410e60155460165461412a90919063ffffffff16565b905080156129605760006141ba4760146064614e02565b90506000818311156141cd5750806141d0565b50815b801561280d57602154604080516370d5ae0560e01b815290516000926001600160a01b0316916370d5ae05916004808301926020929190829003018186803b15801561421b57600080fd5b505afa15801561422f573d6000803e3d6000fd5b505050506040513d602081101561424557600080fd5b5051601754909150614257908361412a565b601755601d54614267908361581f565b601d556040516001600160a01b0382169083156108fc029084906000818181858888f193505050501580156142a0573d6000803e3d6000fd5b506040805183815290517f44d5cd18c37b86a3423952287006d9550ab3cff404d6e899d5499d9ef87100b59181900360200190a150505050565b6142e2612221565b6001600160a01b0316336001600160a01b031614611b08576040805162461bcd60e51b815260206004820152600f60248201526e6f6e6c7920676f7665726e616e636560881b604482015290519081900360640190fd5b600054600160b01b900460ff16156143665733301461435457fe5b6000805460ff60b01b19169055611b08565b611b086142da565b6143766142da565b600082359050600060076001609c1b016001600160a01b0316636221a54b6040518163ffffffff1660e01b815260040160206040518083038186803b1580156143be57600080fd5b505afa1580156143d2573d6000803e3d6000fd5b505050506040513d60208110156143e857600080fd5b505160408051808201825242830180825282516020601f89018190048102820181019094528781529394509290918281019190889088908190840183828082843760009201829052509390945250506001600160e01b0319861681526001602081815260409092208451815584830151805191945061446c93928501920190615dbd565b509050507fed948300a3694aa01d4a6b258bfd664350193d770c0b51f8387277f6d83ea3b68382878760405180856001600160e01b0319168152602001848152602001806020018281038252848482818152602001925080828437600083820152604051601f909101601f191690920182900397509095505050505050a15050505050565b6000808383111561450757506000905080614510565b50600190508183035b9250929050565b3d604051818101604052816000823e8215614530578181f35b8181fd5b600061453e6140d0565b5050600061454a613a12565b905060005b85518110156145f357614567868281518110613f8557fe5b614570576145eb565b614578615e49565b6145988988848151811061458857fe5b60200260200101518860016151ec565b905060006145ad8a8a8a8681518110613fd257fe5b905080600d60008a86815181106145c057fe5b6020026020010151815260200190815260200160002060008282540192505081905550808501945050505b60010161454f565b5082156146095761460486836156ba565b614613565b614613868361572e565b5047601d5595945050505050565b601e546040805180820190915260118152706674736f206d616e61676572206f6e6c7960781b6020820152906001600160a01b031633146129605760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b60006119ce6146b2838561587c565b6146ba61592d565b9061594c565b6146c9826159b3565b6132e68282615a2b565b6001600160a01b0382166000908152600284016020526040812080545b80156147575781546000199091019082908290811061470b57fe5b6000918252602090912001546201000090046001600160f01b031684106147525781818154811061473857fe5b60009182526020909120015461ffff1692506119ce915050565b6146f0565b50505060018301549392505050565b60006005548310806147785750818310155b80614784575060045483105b1561479157506000611f12565b50600192915050565b6147a2615e49565b60006147ad84613b67565b905060006147bc858788615a5c565b905060006147c8615e71565b82156147e957856147e4576147de87898a615a8f565b60208201525b614807565b6147f4888886615ac2565b9150614801878984615c37565b60208201525b8280614817575060008160200151115b151581526020546040805163ed475a7960e01b81526001600160a01b038b811660048301526024820188905291516060938493169163ed475a79916044808301926000929190829003018186803b15801561487157600080fd5b505afa158015614885573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405260808110156148ae57600080fd5b8101908080516040519392919084600160201b8211156148cd57600080fd5b9083019060208201858111156148e257600080fd5b82518660208202830111600160201b821117156148fe57600080fd5b82525081516020918201928201910280838360005b8381101561492b578181015183820152602001614913565b5050505090500160405260200180516040519392919084600160201b82111561495357600080fd5b90830190602082018581111561496857600080fd5b82518660208202830111600160201b8211171561498457600080fd5b82525081516020918201928201910280838360005b838110156149b1578181015183820152602001614999565b5050505091909101604052505083518751949650929450919291506149d990505760006149dc565b60015b60ff160167ffffffffffffffff811180156149f657600080fd5b50604051908082528060200260200182016040528015614a20578160200160208202803683370190505b508088525167ffffffffffffffff81118015614a3b57600080fd5b50604051908082528060200260200182016040528015614a65578160200160208202803683370190505b50602088015286515167ffffffffffffffff81118015614a8457600080fd5b50604051908082528060200260200182016040528015614aae578160200160208202803683370190505b50604088015286515167ffffffffffffffff81118015614acd57600080fd5b50604051908082528060200260200182016040528015614af7578160200160208202803683370190505b506060880152825115614b9b57898760000151600081518110614b1657fe5b60200260200101906001600160a01b031690816001600160a01b031681525050848760600151600081518110614b4857fe5b602002602001019015159081151581525050838760200151600081518110614b6c57fe5b60200260200101818152505082602001518760400151600081518110614b8e57fe5b6020026020010181815250505b815115614df557602080546040805163277166bf60e11b81526001600160a01b038e81166004830152602482018b905291516000949290931692634ee2cd7e92604480840193919291829003018186803b158015614bf857600080fd5b505afa158015614c0c573d6000803e3d6000fd5b505050506040513d6020811015614c2257600080fd5b5051905060005b8351811015614df2576000818660000151614c45576000614c48565b60015b60ff16019050848281518110614c5a57fe5b60200260200101518a600001518281518110614c7257fe5b60200260200101906001600160a01b031690816001600160a01b031681525050614cb08c868481518110614ca257fe5b60200260200101518f615a5c565b8a606001518281518110614cc057fe5b60200260200101901515908115158152505089606001518181518110614ce257fe5b602002602001015115614d34578a614d2f57614d128c868481518110614d0457fe5b60200260200101518f615a8f565b8a604001518281518110614d2257fe5b6020026020010181815250505b614de9565b614d7b858381518110614d4357fe5b6020026020010151614d75868581518110614d5a57fe5b602002602001015161271087614e029092919063ffffffff16565b8e615cc9565b8a602001518281518110614d8b57fe5b602002602001018181525050614dcc8c868481518110614da757fe5b60200260200101518c602001518481518110614dbf57fe5b6020026020010151615c37565b8a604001518281518110614ddc57fe5b6020026020010181815250505b50600101614c29565b50505b5050505050509392505050565b6000808211614e4b576040805162461bcd60e51b815260206004820152601060248201526f4469766973696f6e206279207a65726f60801b604482015290519081900360640190fd5b83614e58575060006119ce565b83830283858281614e6557fe5b041415614e7e57828181614e7557fe5b049150506119ce565b6000838681614e8957fe5b0490506000848781614e9757fe5b0690506000858781614ea557fe5b0490506000868881614eb357fe5b069050614ef5614ec7886146ba8685614f02565b611dba614ed48686614f02565b611dba614ee18987614f02565b611dba8d614eef8c8b614f02565b90614f02565b9998505050505050505050565b600082614f1157506000611f12565b82820282848281614f1e57fe5b04146119ce5760405162461bcd60e51b8152600401808060200182810382526021815260200180615f0d6021913960400191505060405180910390fd5b600080826040516020018080602001828103825283818151815260200191508051906020019080838360005b83811015614f9f578181015183820152602001614f87565b50505050905090810190601f168015614fcc5780820380516001836020036101000a031916815260200191505b50925050506040516020818303038152906040528051906020012090506000805b86518110156150345786818151811061500257fe5b602002602001015183141561502c5785818151811061501d57fe5b60200260200101519150615034565b600101614fed565b506001600160a01b03811661507f576040805162461bcd60e51b815260206004820152600c60248201526b61646472657373207a65726f60a01b604482015290519081900360640190fd5b95945050505050565b7f714f205b2abd25bef1d06a1af944e38c113fe6160375c4e1d6d5cf28848e771955565b6150d882826040518060400160405280600981526020016824b7333630ba34b7b760b91b815250614f5b565b601f60006101000a8154816001600160a01b0302191690836001600160a01b0316021790555061512c82826040518060400160405280600b81526020016a233a39b7a6b0b730b3b2b960a91b815250614f5b565b601e60006101000a8154816001600160a01b0302191690836001600160a01b0316021790555061517982826040518060400160405280600481526020016315d3985d60e21b815250614f5b565b602060006101000a8154816001600160a01b0302191690836001600160a01b031602179055506151c8828260405180604001604052806006815260200165537570706c7960d01b815250614f5b565b602180546001600160a01b0319166001600160a01b03929092169190911790555050565b6151f4615e49565b60006151ff85613b67565b84518584529091508067ffffffffffffffff8111801561521e57600080fd5b50604051908082528060200260200182016040528015615248578160200160208202803683370190505b5060208401528067ffffffffffffffff8111801561526557600080fd5b5060405190808252806020026020018201604052801561528f578160200160208202803683370190505b5060408401528067ffffffffffffffff811180156152ac57600080fd5b506040519080825280602002602001820160405280156152d6578160200160208202803683370190505b50606084015260005b8181101561552057615305878783815181106152f757fe5b60200260200101518a615a5c565b8460600151828151811061531557fe5b6020026020010190151590811515815250508360600151818151811061533757fe5b6020026020010151156153895784615384576153678787838151811061535957fe5b60200260200101518a615a8f565b8460400151828151811061537757fe5b6020026020010181815250505b615518565b876001600160a01b031686828151811061539f57fe5b60200260200101516001600160a01b031614156153e2576153c1888885615ac2565b846020015182815181106153d157fe5b6020026020010181815250506154d3565b60205486516000916001600160a01b03169063e64767aa908b908a908690811061540857fe5b6020026020010151876040518463ffffffff1660e01b815260040180846001600160a01b03168152602001836001600160a01b03168152602001828152602001935050505060206040518083038186803b15801561546557600080fd5b505afa158015615479573d6000803e3d6000fd5b505050506040513d602081101561548f57600080fd5b505187519091506154b5908890849081106154a657fe5b6020026020010151828a615cc9565b856020015183815181106154c557fe5b602002602001018181525050505b6154fb878783815181106154e357fe5b602002602001015186602001518481518110614dbf57fe5b8460400151828151811061550b57fe5b6020026020010181815250505b6001016152df565b505050949350505050565b600080805b8351518110156156b0578360600151818151811061554a57fe5b60200260200101511561555c576156a8565b60008460000151828151811061556e57fe5b6020026020010151905060008560200151838151811061558a57fe5b6020026020010151905060008111156155c75760008781526007602090815260408083206001600160a01b03861684529091529020805482900390555b6000866040015184815181106155d957fe5b6020026020010151905060008111156156225760008881526008602090815260408083206001600160a01b03871684529091529020805482900390556014805482019055938401935b6000888152600b602090815260408083206001600160a01b038088168086529184528285208f821680875290855294839020805460ff191660019081178255810187905583518e815294850187905283519095918f169491937f6ec685171a9028d19dc155a48e7824e3c68b03bc8995410e006abe3cbbeb3e2d928290030190a4505050505b600101615530565b5095945050505050565b80156132e6576020546040805163b760faf960e01b81526001600160a01b0385811660048301529151919092169163b760faf991849160248082019260009290919082900301818588803b15801561571157600080fd5b505af1158015615725573d6000803e3d6000fd5b50505050505050565b80156132e6576040516000906001600160a01b0384169083908381818185875af1925050503d806000811461577f576040519150601f19603f3d011682016040523d82523d6000602084013e615784565b606091505b50509050806040518060400160405280600c81526020016b18db185a5b4819985a5b195960a21b815250906126055760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b60006122b160175461410e60145461410e601a5460195461412a90919063ffffffff16565b600082821115615876576040805162461bcd60e51b815260206004820152601e60248201527f536166654d6174683a207375627472616374696f6e206f766572666c6f770000604482015290519081900360640190fd5b50900390565b60008061589762093a7f601b5461412a90919063ffffffff16565b905080841115604051806040016040528060118152602001706166746572206461696c79206379636c6560781b815250906159135760405162461bcd60e51b8152602060048201818152835160248401528351909283926044909101919085019080838360008315611a65578181015183820152602001611a4d565b50615922836146ba838761581f565b600101949350505050565b60006122b160165461410e60135460185461581f90919063ffffffff16565b60008082116159a2576040805162461bcd60e51b815260206004820152601a60248201527f536166654d6174683a206469766973696f6e206279207a65726f000000000000604482015290519081900360640190fd5b8183816159ab57fe5b049392505050565b8054156129605780546001820190600090839060001981019081106159d457fe5b60009182526020808320909101546001600160a01b031683528201929092526040018120558054819080615a0457fe5b600082815260209020810160001990810180546001600160a01b03191690550190556159b3565b60005b815181101561280d57615a5483838381518110615a4757fe5b6020026020010151615d10565b600101615a2e565b6000928352600b602090815260408085206001600160a01b03948516865282528085209290931684525290205460ff1690565b6000928352600b602090815260408085206001600160a01b03948516865282528085209290931684525290206001015490565b6020805460408051634181ad4160e11b81526001600160a01b038781166004830152602482018690529151600094859493909316926383035a829260448082019391829003018186803b158015615b1857600080fd5b505afa158015615b2c573d6000803e3d6000fd5b505050506040513d6020811015615b4257600080fd5b50516020805460408051631257fcdb60e31b81526001600160a01b038a8116600483015260248201899052915194955060009491909216926392bfe6d89260448082019391829003018186803b158015615b9b57600080fd5b505afa158015615baf573d6000803e3d6000fd5b505050506040513d6020811015615bc557600080fd5b5051905081811415615be657615bdd81612710614f02565b925050506119ce565b818111615bef57fe5b60008215615c0557615c0383612710614f02565b015b6000615c13600e89896146d3565b90508015615c2c57615c2784840382614f02565b820191505b509695505050505050565b600081615c46575060006119ce565b60008481526008602090815260408083206001600160a01b038716845290915290205480615c785760009150506119ce565b60008581526007602090815260408083206001600160a01b038816845290915290205483811415615cab575090506119ce565b808410615cb457fe5b615cbf828583614e02565b9695505050505050565b600082615cd8575060006119ce565b600080615ce7600e87866146d3565b9050612710811015615d0757615d0285612710839003614f02565b820191505b50949350505050565b6001600160a01b038116600090815260018301602052604090205415615d35576132e6565b8154600180820184556000848152602080822090930180546001600160a01b0319166001600160a01b03959095169485179055845493815293019052604090912055565b50805460018160011615610100020316600290046000825580601f10615d9f5750612960565b601f0160209004906000526020600020908101906129609190615e88565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282615df35760008555615e39565b82601f10615e0c57805160ff1916838001178555615e39565b82800160010185558215615e39579182015b82811115615e39578251825591602001919060010190615e1e565b50615e45929150615e88565b5090565b6040518060800160405280606081526020016060815260200160608152602001606081525090565b604080518082019091526000808252602082015290565b5b80821115615e455760008155600101615e8956fe5265656e7472616e637947756172643a207265656e7472616e742063616c6c006e6577206674736f20726577617264206d616e6167657220616c7265616479207365746f6e6c79206674736f206d616e61676572206f72206e6577206674736f20726577617264206d616e61676572536166654d6174683a206d756c7469706c69636174696f6e206f766572666c6f77a26469706673582212200f373fa48dad252b853ae0e397b7ecdb86a61ad2b579e92edefd6d57fa8ae01664736f6c63430007060033