ETH Price: $3,299.22 (+0.19%)

Transaction Decoder

Block:
12482444 at May-22-2021 06:13:06 AM +UTC
Transaction Fee:
0.0129498 ETH $42.72
Gas Used:
129,498 Gas / 100 Gwei

Account State Difference:

  Address   Before After State Difference Code
0x62f7A1F9...7d452565B
0.063703467783231697 Eth
Nonce: 40
0.050753667783231697 Eth
Nonce: 41
0.0129498
(UUPool)
401.454257200012436131 Eth401.467207000012436131 Eth0.0129498

Execution Trace

CollateralErc20.repay( borrower=0xbf3a6e2810EF22109919Ca0edD785EE1E466efaa, id=36, amount=3000000000000000000000 )
  • SystemStatus.STATICCALL( )
  • ExchangeRates.rateIsInvalid( currencyKey=7342544300000000000000000000000000000000000000000000000000000000 ) => ( False )
    • FlexibleStorage.getUIntValue( contractName=53797374656D53657474696E6773000000000000000000000000000000000000, record=726174655374616C65506572696F640000000000000000000000000000000000 ) => ( 90000 )
    • EACAggregatorProxy.STATICCALL( )
      • AccessControlledOffchainAggregator.STATICCALL( )
      • FlexibleStorage.getAddressValue( contractName=53797374656D53657474696E6773000000000000000000000000000000000000, record=61676772656761746F725761726E696E67466C61677300000000000000000000 ) => ( 0x4A5b9B4aD08616D11F3A402FF7cBEAcB732a76C6 )
      • Flags.getFlag( subject=0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c ) => ( False )
      • CollateralState.getLoan( account=0xbf3a6e2810EF22109919Ca0edD785EE1E466efaa, loanID=36 ) => ( [{name:id, type:uint256, order:1, indexed:false, value:0, valueString:0}, {name:account, type:address, order:2, indexed:false, value:0x0000000000000000000000000000000000000000, valueString:0x0000000000000000000000000000000000000000}, {name:collateral, type:uint256, order:3, indexed:false, value:0, valueString:0}, {name:currency, type:bytes32, order:4, indexed:false, value:0000000000000000000000000000000000000000000000000000000000000000, valueString:0000000000000000000000000000000000000000000000000000000000000000}, {name:amount, type:uint256, order:5, indexed:false, value:0, valueString:0}, {name:short, type:bool, order:6, indexed:false, value:false, valueString:False}, {name:accruedInterest, type:uint256, order:7, indexed:false, value:0, valueString:0}, {name:interestIndex, type:uint256, order:8, indexed:false, value:0, valueString:0}, {name:lastInteraction, type:uint256, order:9, indexed:false, value:0, valueString:0}] )
        File 1 of 8: CollateralErc20
        /*
           ____            __   __        __   _
          / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
         _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
        /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
             /___/
        
        * Synthetix: CollateralErc20.sol
        *
        * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/CollateralErc20.sol
        * Docs: https://docs.synthetix.io/contracts/CollateralErc20
        *
        * Contract Dependencies: 
        *	- Collateral
        *	- IAddressResolver
        *	- ICollateralErc20
        *	- ICollateralLoan
        *	- MixinResolver
        *	- MixinSystemSettings
        *	- Owned
        *	- State
        * Libraries: 
        *	- SafeDecimalMath
        *	- SafeMath
        *
        * MIT License
        * ===========
        *
        * Copyright (c) 2021 Synthetix
        *
        * Permission is hereby granted, free of charge, to any person obtaining a copy
        * of this software and associated documentation files (the "Software"), to deal
        * in the Software without restriction, including without limitation the rights
        * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        * copies of the Software, and to permit persons to whom the Software is
        * furnished to do so, subject to the following conditions:
        *
        * The above copyright notice and this permission notice shall be included in all
        * copies or substantial portions of the Software.
        *
        * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        */
        
        
        
        pragma solidity ^0.5.16;
        
        
        // https://docs.synthetix.io/contracts/source/contracts/owned
        contract Owned {
            address public owner;
            address public nominatedOwner;
        
            constructor(address _owner) public {
                require(_owner != address(0), "Owner address cannot be 0");
                owner = _owner;
                emit OwnerChanged(address(0), _owner);
            }
        
            function nominateNewOwner(address _owner) external onlyOwner {
                nominatedOwner = _owner;
                emit OwnerNominated(_owner);
            }
        
            function acceptOwnership() external {
                require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                emit OwnerChanged(owner, nominatedOwner);
                owner = nominatedOwner;
                nominatedOwner = address(0);
            }
        
            modifier onlyOwner {
                _onlyOwner();
                _;
            }
        
            function _onlyOwner() private view {
                require(msg.sender == owner, "Only the contract owner may perform this action");
            }
        
            event OwnerNominated(address newOwner);
            event OwnerChanged(address oldOwner, address newOwner);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iaddressresolver
        interface IAddressResolver {
            function getAddress(bytes32 name) external view returns (address);
        
            function getSynth(bytes32 key) external view returns (address);
        
            function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/isynth
        interface ISynth {
            // Views
            function currencyKey() external view returns (bytes32);
        
            function transferableSynths(address account) external view returns (uint);
        
            // Mutative functions
            function transferAndSettle(address to, uint value) external returns (bool);
        
            function transferFromAndSettle(
                address from,
                address to,
                uint value
            ) external returns (bool);
        
            // Restricted: used internally to Synthetix
            function burn(address account, uint amount) external;
        
            function issue(address account, uint amount) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iissuer
        interface IIssuer {
            // Views
            function anySynthOrSNXRateIsInvalid() external view returns (bool anyRateInvalid);
        
            function availableCurrencyKeys() external view returns (bytes32[] memory);
        
            function availableSynthCount() external view returns (uint);
        
            function availableSynths(uint index) external view returns (ISynth);
        
            function canBurnSynths(address account) external view returns (bool);
        
            function collateral(address account) external view returns (uint);
        
            function collateralisationRatio(address issuer) external view returns (uint);
        
            function collateralisationRatioAndAnyRatesInvalid(address _issuer)
                external
                view
                returns (uint cratio, bool anyRateIsInvalid);
        
            function debtBalanceOf(address issuer, bytes32 currencyKey) external view returns (uint debtBalance);
        
            function issuanceRatio() external view returns (uint);
        
            function lastIssueEvent(address account) external view returns (uint);
        
            function maxIssuableSynths(address issuer) external view returns (uint maxIssuable);
        
            function minimumStakeTime() external view returns (uint);
        
            function remainingIssuableSynths(address issuer)
                external
                view
                returns (
                    uint maxIssuable,
                    uint alreadyIssued,
                    uint totalSystemDebt
                );
        
            function synths(bytes32 currencyKey) external view returns (ISynth);
        
            function getSynths(bytes32[] calldata currencyKeys) external view returns (ISynth[] memory);
        
            function synthsByAddress(address synthAddress) external view returns (bytes32);
        
            function totalIssuedSynths(bytes32 currencyKey, bool excludeEtherCollateral) external view returns (uint);
        
            function transferableSynthetixAndAnyRateIsInvalid(address account, uint balance)
                external
                view
                returns (uint transferable, bool anyRateIsInvalid);
        
            // Restricted: used internally to Synthetix
            function issueSynths(address from, uint amount) external;
        
            function issueSynthsOnBehalf(
                address issueFor,
                address from,
                uint amount
            ) external;
        
            function issueMaxSynths(address from) external;
        
            function issueMaxSynthsOnBehalf(address issueFor, address from) external;
        
            function burnSynths(address from, uint amount) external;
        
            function burnSynthsOnBehalf(
                address burnForAddress,
                address from,
                uint amount
            ) external;
        
            function burnSynthsToTarget(address from) external;
        
            function burnSynthsToTargetOnBehalf(address burnForAddress, address from) external;
        
            function liquidateDelinquentAccount(
                address account,
                uint susdAmount,
                address liquidator
            ) external returns (uint totalRedeemed, uint amountToLiquidate);
        }
        
        
        // Inheritance
        
        
        // Internal references
        
        
        // https://docs.synthetix.io/contracts/source/contracts/addressresolver
        contract AddressResolver is Owned, IAddressResolver {
            mapping(bytes32 => address) public repository;
        
            constructor(address _owner) public Owned(_owner) {}
        
            /* ========== RESTRICTED FUNCTIONS ========== */
        
            function importAddresses(bytes32[] calldata names, address[] calldata destinations) external onlyOwner {
                require(names.length == destinations.length, "Input lengths must match");
        
                for (uint i = 0; i < names.length; i++) {
                    bytes32 name = names[i];
                    address destination = destinations[i];
                    repository[name] = destination;
                    emit AddressImported(name, destination);
                }
            }
        
            /* ========= PUBLIC FUNCTIONS ========== */
        
            function rebuildCaches(MixinResolver[] calldata destinations) external {
                for (uint i = 0; i < destinations.length; i++) {
                    destinations[i].rebuildCache();
                }
            }
        
            /* ========== VIEWS ========== */
        
            function areAddressesImported(bytes32[] calldata names, address[] calldata destinations) external view returns (bool) {
                for (uint i = 0; i < names.length; i++) {
                    if (repository[names[i]] != destinations[i]) {
                        return false;
                    }
                }
                return true;
            }
        
            function getAddress(bytes32 name) external view returns (address) {
                return repository[name];
            }
        
            function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address) {
                address _foundAddress = repository[name];
                require(_foundAddress != address(0), reason);
                return _foundAddress;
            }
        
            function getSynth(bytes32 key) external view returns (address) {
                IIssuer issuer = IIssuer(repository["Issuer"]);
                require(address(issuer) != address(0), "Cannot find Issuer address");
                return address(issuer.synths(key));
            }
        
            /* ========== EVENTS ========== */
        
            event AddressImported(bytes32 name, address destination);
        }
        
        
        // solhint-disable payable-fallback
        
        // https://docs.synthetix.io/contracts/source/contracts/readproxy
        contract ReadProxy is Owned {
            address public target;
        
            constructor(address _owner) public Owned(_owner) {}
        
            function setTarget(address _target) external onlyOwner {
                target = _target;
                emit TargetUpdated(target);
            }
        
            function() external {
                // The basics of a proxy read call
                // Note that msg.sender in the underlying will always be the address of this contract.
                assembly {
                    calldatacopy(0, 0, calldatasize)
        
                    // Use of staticcall - this will revert if the underlying function mutates state
                    let result := staticcall(gas, sload(target_slot), 0, calldatasize, 0, 0)
                    returndatacopy(0, 0, returndatasize)
        
                    if iszero(result) {
                        revert(0, returndatasize)
                    }
                    return(0, returndatasize)
                }
            }
        
            event TargetUpdated(address newTarget);
        }
        
        
        // Inheritance
        
        
        // Internal references
        
        
        // https://docs.synthetix.io/contracts/source/contracts/mixinresolver
        contract MixinResolver {
            AddressResolver public resolver;
        
            mapping(bytes32 => address) private addressCache;
        
            constructor(address _resolver) internal {
                resolver = AddressResolver(_resolver);
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function combineArrays(bytes32[] memory first, bytes32[] memory second)
                internal
                pure
                returns (bytes32[] memory combination)
            {
                combination = new bytes32[](first.length + second.length);
        
                for (uint i = 0; i < first.length; i++) {
                    combination[i] = first[i];
                }
        
                for (uint j = 0; j < second.length; j++) {
                    combination[first.length + j] = second[j];
                }
            }
        
            /* ========== PUBLIC FUNCTIONS ========== */
        
            // Note: this function is public not external in order for it to be overridden and invoked via super in subclasses
            function resolverAddressesRequired() public view returns (bytes32[] memory addresses) {}
        
            function rebuildCache() public {
                bytes32[] memory requiredAddresses = resolverAddressesRequired();
                // The resolver must call this function whenver it updates its state
                for (uint i = 0; i < requiredAddresses.length; i++) {
                    bytes32 name = requiredAddresses[i];
                    // Note: can only be invoked once the resolver has all the targets needed added
                    address destination = resolver.requireAndGetAddress(
                        name,
                        string(abi.encodePacked("Resolver missing target: ", name))
                    );
                    addressCache[name] = destination;
                    emit CacheUpdated(name, destination);
                }
            }
        
            /* ========== VIEWS ========== */
        
            function isResolverCached() external view returns (bool) {
                bytes32[] memory requiredAddresses = resolverAddressesRequired();
                for (uint i = 0; i < requiredAddresses.length; i++) {
                    bytes32 name = requiredAddresses[i];
                    // false if our cache is invalid or if the resolver doesn't have the required address
                    if (resolver.getAddress(name) != addressCache[name] || addressCache[name] == address(0)) {
                        return false;
                    }
                }
        
                return true;
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function requireAndGetAddress(bytes32 name) internal view returns (address) {
                address _foundAddress = addressCache[name];
                require(_foundAddress != address(0), string(abi.encodePacked("Missing address: ", name)));
                return _foundAddress;
            }
        
            /* ========== EVENTS ========== */
        
            event CacheUpdated(bytes32 name, address destination);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iflexiblestorage
        interface IFlexibleStorage {
            // Views
            function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint);
        
            function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory);
        
            function getIntValue(bytes32 contractName, bytes32 record) external view returns (int);
        
            function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory);
        
            function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address);
        
            function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory);
        
            function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool);
        
            function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory);
        
            function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32);
        
            function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory);
        
            // Mutative functions
            function deleteUIntValue(bytes32 contractName, bytes32 record) external;
        
            function deleteIntValue(bytes32 contractName, bytes32 record) external;
        
            function deleteAddressValue(bytes32 contractName, bytes32 record) external;
        
            function deleteBoolValue(bytes32 contractName, bytes32 record) external;
        
            function deleteBytes32Value(bytes32 contractName, bytes32 record) external;
        
            function setUIntValue(
                bytes32 contractName,
                bytes32 record,
                uint value
            ) external;
        
            function setUIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                uint[] calldata values
            ) external;
        
            function setIntValue(
                bytes32 contractName,
                bytes32 record,
                int value
            ) external;
        
            function setIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                int[] calldata values
            ) external;
        
            function setAddressValue(
                bytes32 contractName,
                bytes32 record,
                address value
            ) external;
        
            function setAddressValues(
                bytes32 contractName,
                bytes32[] calldata records,
                address[] calldata values
            ) external;
        
            function setBoolValue(
                bytes32 contractName,
                bytes32 record,
                bool value
            ) external;
        
            function setBoolValues(
                bytes32 contractName,
                bytes32[] calldata records,
                bool[] calldata values
            ) external;
        
            function setBytes32Value(
                bytes32 contractName,
                bytes32 record,
                bytes32 value
            ) external;
        
            function setBytes32Values(
                bytes32 contractName,
                bytes32[] calldata records,
                bytes32[] calldata values
            ) external;
        }
        
        
        // Internal references
        
        
        // https://docs.synthetix.io/contracts/source/contracts/mixinsystemsettings
        contract MixinSystemSettings is MixinResolver {
            bytes32 internal constant SETTING_CONTRACT_NAME = "SystemSettings";
        
            bytes32 internal constant SETTING_WAITING_PERIOD_SECS = "waitingPeriodSecs";
            bytes32 internal constant SETTING_PRICE_DEVIATION_THRESHOLD_FACTOR = "priceDeviationThresholdFactor";
            bytes32 internal constant SETTING_ISSUANCE_RATIO = "issuanceRatio";
            bytes32 internal constant SETTING_FEE_PERIOD_DURATION = "feePeriodDuration";
            bytes32 internal constant SETTING_TARGET_THRESHOLD = "targetThreshold";
            bytes32 internal constant SETTING_LIQUIDATION_DELAY = "liquidationDelay";
            bytes32 internal constant SETTING_LIQUIDATION_RATIO = "liquidationRatio";
            bytes32 internal constant SETTING_LIQUIDATION_PENALTY = "liquidationPenalty";
            bytes32 internal constant SETTING_RATE_STALE_PERIOD = "rateStalePeriod";
            bytes32 internal constant SETTING_EXCHANGE_FEE_RATE = "exchangeFeeRate";
            bytes32 internal constant SETTING_MINIMUM_STAKE_TIME = "minimumStakeTime";
            bytes32 internal constant SETTING_AGGREGATOR_WARNING_FLAGS = "aggregatorWarningFlags";
            bytes32 internal constant SETTING_TRADING_REWARDS_ENABLED = "tradingRewardsEnabled";
            bytes32 internal constant SETTING_DEBT_SNAPSHOT_STALE_TIME = "debtSnapshotStaleTime";
            bytes32 internal constant SETTING_CROSS_DOMAIN_DEPOSIT_GAS_LIMIT = "crossDomainDepositGasLimit";
            bytes32 internal constant SETTING_CROSS_DOMAIN_ESCROW_GAS_LIMIT = "crossDomainEscrowGasLimit";
            bytes32 internal constant SETTING_CROSS_DOMAIN_REWARD_GAS_LIMIT = "crossDomainRewardGasLimit";
            bytes32 internal constant SETTING_CROSS_DOMAIN_WITHDRAWAL_GAS_LIMIT = "crossDomainWithdrawalGasLimit";
        
            bytes32 internal constant CONTRACT_FLEXIBLESTORAGE = "FlexibleStorage";
        
            enum CrossDomainMessageGasLimits {Deposit, Escrow, Reward, Withdrawal}
        
            constructor(address _resolver) internal MixinResolver(_resolver) {}
        
            function resolverAddressesRequired() public view returns (bytes32[] memory addresses) {
                addresses = new bytes32[](1);
                addresses[0] = CONTRACT_FLEXIBLESTORAGE;
            }
        
            function flexibleStorage() internal view returns (IFlexibleStorage) {
                return IFlexibleStorage(requireAndGetAddress(CONTRACT_FLEXIBLESTORAGE));
            }
        
            function _getGasLimitSetting(CrossDomainMessageGasLimits gasLimitType) internal pure returns (bytes32) {
                if (gasLimitType == CrossDomainMessageGasLimits.Deposit) {
                    return SETTING_CROSS_DOMAIN_DEPOSIT_GAS_LIMIT;
                } else if (gasLimitType == CrossDomainMessageGasLimits.Escrow) {
                    return SETTING_CROSS_DOMAIN_ESCROW_GAS_LIMIT;
                } else if (gasLimitType == CrossDomainMessageGasLimits.Reward) {
                    return SETTING_CROSS_DOMAIN_REWARD_GAS_LIMIT;
                } else if (gasLimitType == CrossDomainMessageGasLimits.Withdrawal) {
                    return SETTING_CROSS_DOMAIN_WITHDRAWAL_GAS_LIMIT;
                } else {
                    revert("Unknown gas limit type");
                }
            }
        
            function getCrossDomainMessageGasLimit(CrossDomainMessageGasLimits gasLimitType) internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, _getGasLimitSetting(gasLimitType));
            }
        
            function getTradingRewardsEnabled() internal view returns (bool) {
                return flexibleStorage().getBoolValue(SETTING_CONTRACT_NAME, SETTING_TRADING_REWARDS_ENABLED);
            }
        
            function getWaitingPeriodSecs() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_WAITING_PERIOD_SECS);
            }
        
            function getPriceDeviationThresholdFactor() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_PRICE_DEVIATION_THRESHOLD_FACTOR);
            }
        
            function getIssuanceRatio() internal view returns (uint) {
                // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_ISSUANCE_RATIO);
            }
        
            function getFeePeriodDuration() internal view returns (uint) {
                // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_FEE_PERIOD_DURATION);
            }
        
            function getTargetThreshold() internal view returns (uint) {
                // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_TARGET_THRESHOLD);
            }
        
            function getLiquidationDelay() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_DELAY);
            }
        
            function getLiquidationRatio() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_RATIO);
            }
        
            function getLiquidationPenalty() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_PENALTY);
            }
        
            function getRateStalePeriod() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_RATE_STALE_PERIOD);
            }
        
            function getExchangeFeeRate(bytes32 currencyKey) internal view returns (uint) {
                return
                    flexibleStorage().getUIntValue(
                        SETTING_CONTRACT_NAME,
                        keccak256(abi.encodePacked(SETTING_EXCHANGE_FEE_RATE, currencyKey))
                    );
            }
        
            function getMinimumStakeTime() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_MINIMUM_STAKE_TIME);
            }
        
            function getAggregatorWarningFlags() internal view returns (address) {
                return flexibleStorage().getAddressValue(SETTING_CONTRACT_NAME, SETTING_AGGREGATOR_WARNING_FLAGS);
            }
        
            function getDebtSnapshotStaleTime() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_DEBT_SNAPSHOT_STALE_TIME);
            }
        }
        
        
        pragma experimental ABIEncoderV2;
        
        
        interface ICollateralLoan {
            struct Loan {
                // ID for the loan
                uint id;
                //  Acccount that created the loan
                address payable account;
                //  Amount of collateral deposited
                uint collateral;
                // The synth that was borowed
                bytes32 currency;
                //  Amount of synths borrowed
                uint amount;
                // Indicates if the position was short sold
                bool short;
                // interest amounts accrued
                uint accruedInterest;
                // last interest index
                uint interestIndex;
                // time of last interaction.
                uint lastInteraction;
            }
        }
        
        
        /**
         * @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, 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");
                uint256 c = a - b;
        
                return c;
            }
        
            /**
             * @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) {
                // 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-solidity/pull/522
                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. Reverts 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) {
                // Solidity only automatically asserts when dividing by 0
                require(b > 0, "SafeMath: division by zero");
                uint256 c = a / b;
                // assert(a == b * c + a % b); // There is no case in which this doesn't hold
        
                return c;
            }
        
            /**
             * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
             * Reverts 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;
            }
        }
        
        
        // Libraries
        
        
        // https://docs.synthetix.io/contracts/source/libraries/safedecimalmath
        library SafeDecimalMath {
            using SafeMath for uint;
        
            /* Number of decimal places in the representations. */
            uint8 public constant decimals = 18;
            uint8 public constant highPrecisionDecimals = 27;
        
            /* The number representing 1.0. */
            uint public constant UNIT = 10**uint(decimals);
        
            /* The number representing 1.0 for higher fidelity numbers. */
            uint public constant PRECISE_UNIT = 10**uint(highPrecisionDecimals);
            uint private constant UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR = 10**uint(highPrecisionDecimals - decimals);
        
            /**
             * @return Provides an interface to UNIT.
             */
            function unit() external pure returns (uint) {
                return UNIT;
            }
        
            /**
             * @return Provides an interface to PRECISE_UNIT.
             */
            function preciseUnit() external pure returns (uint) {
                return PRECISE_UNIT;
            }
        
            /**
             * @return The result of multiplying x and y, interpreting the operands as fixed-point
             * decimals.
             *
             * @dev A unit factor is divided out after the product of x and y is evaluated,
             * so that product must be less than 2**256. As this is an integer division,
             * the internal division always rounds down. This helps save on gas. Rounding
             * is more expensive on gas.
             */
            function multiplyDecimal(uint x, uint y) internal pure returns (uint) {
                /* Divide by UNIT to remove the extra factor introduced by the product. */
                return x.mul(y) / UNIT;
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of the specified precision unit.
             *
             * @dev The operands should be in the form of a the specified unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function _multiplyDecimalRound(
                uint x,
                uint y,
                uint precisionUnit
            ) private pure returns (uint) {
                /* Divide by UNIT to remove the extra factor introduced by the product. */
                uint quotientTimesTen = x.mul(y) / (precisionUnit / 10);
        
                if (quotientTimesTen % 10 >= 5) {
                    quotientTimesTen += 10;
                }
        
                return quotientTimesTen / 10;
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of a precise unit.
             *
             * @dev The operands should be in the precise unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function multiplyDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                return _multiplyDecimalRound(x, y, PRECISE_UNIT);
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of a standard unit.
             *
             * @dev The operands should be in the standard unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function multiplyDecimalRound(uint x, uint y) internal pure returns (uint) {
                return _multiplyDecimalRound(x, y, UNIT);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is a high
             * precision decimal.
             *
             * @dev y is divided after the product of x and the standard precision unit
             * is evaluated, so the product of x and UNIT must be less than 2**256. As
             * this is an integer division, the result is always rounded down.
             * This helps save on gas. Rounding is more expensive on gas.
             */
            function divideDecimal(uint x, uint y) internal pure returns (uint) {
                /* Reintroduce the UNIT factor that will be divided out by y. */
                return x.mul(UNIT).div(y);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * decimal in the precision unit specified in the parameter.
             *
             * @dev y is divided after the product of x and the specified precision unit
             * is evaluated, so the product of x and the specified precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function _divideDecimalRound(
                uint x,
                uint y,
                uint precisionUnit
            ) private pure returns (uint) {
                uint resultTimesTen = x.mul(precisionUnit * 10).div(y);
        
                if (resultTimesTen % 10 >= 5) {
                    resultTimesTen += 10;
                }
        
                return resultTimesTen / 10;
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * standard precision decimal.
             *
             * @dev y is divided after the product of x and the standard precision unit
             * is evaluated, so the product of x and the standard precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function divideDecimalRound(uint x, uint y) internal pure returns (uint) {
                return _divideDecimalRound(x, y, UNIT);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * high precision decimal.
             *
             * @dev y is divided after the product of x and the high precision unit
             * is evaluated, so the product of x and the high precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function divideDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                return _divideDecimalRound(x, y, PRECISE_UNIT);
            }
        
            /**
             * @dev Convert a standard decimal representation to a high precision one.
             */
            function decimalToPreciseDecimal(uint i) internal pure returns (uint) {
                return i.mul(UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR);
            }
        
            /**
             * @dev Convert a high precision decimal to a standard decimal representation.
             */
            function preciseDecimalToDecimal(uint i) internal pure returns (uint) {
                uint quotientTimesTen = i / (UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR / 10);
        
                if (quotientTimesTen % 10 >= 5) {
                    quotientTimesTen += 10;
                }
        
                return quotientTimesTen / 10;
            }
        }
        
        
        // Inheritance
        
        
        // https://docs.synthetix.io/contracts/source/contracts/state
        contract State is Owned {
            // the address of the contract that can modify variables
            // this can only be changed by the owner of this contract
            address public associatedContract;
        
            constructor(address _associatedContract) internal {
                // This contract is abstract, and thus cannot be instantiated directly
                require(owner != address(0), "Owner must be set");
        
                associatedContract = _associatedContract;
                emit AssociatedContractUpdated(_associatedContract);
            }
        
            /* ========== SETTERS ========== */
        
            // Change the associated contract to a new address
            function setAssociatedContract(address _associatedContract) external onlyOwner {
                associatedContract = _associatedContract;
                emit AssociatedContractUpdated(_associatedContract);
            }
        
            /* ========== MODIFIERS ========== */
        
            modifier onlyAssociatedContract {
                require(msg.sender == associatedContract, "Only the associated contract can perform this action");
                _;
            }
        
            /* ========== EVENTS ========== */
        
            event AssociatedContractUpdated(address associatedContract);
        }
        
        
        // Inheritance
        
        
        // Libraries
        
        
        contract CollateralState is Owned, State, ICollateralLoan {
            using SafeMath for uint;
            using SafeDecimalMath for uint;
        
            mapping(address => Loan[]) public loans;
        
            constructor(address _owner, address _associatedContract) public Owned(_owner) State(_associatedContract) {}
        
            /* ========== VIEWS ========== */
            // If we do not find the loan, this returns a struct with 0'd values.
            function getLoan(address account, uint256 loanID) external view returns (Loan memory) {
                Loan[] memory accountLoans = loans[account];
                for (uint i = 0; i < accountLoans.length; i++) {
                    if (accountLoans[i].id == loanID) {
                        return (accountLoans[i]);
                    }
                }
            }
        
            function getNumLoans(address account) external view returns (uint numLoans) {
                return loans[account].length;
            }
        
            /* ========== MUTATIVE FUNCTIONS ========== */
        
            function createLoan(Loan memory loan) public onlyAssociatedContract {
                loans[loan.account].push(loan);
            }
        
            function updateLoan(Loan memory loan) public onlyAssociatedContract {
                Loan[] storage accountLoans = loans[loan.account];
                for (uint i = 0; i < accountLoans.length; i++) {
                    if (accountLoans[i].id == loan.id) {
                        loans[loan.account][i] = loan;
                    }
                }
            }
        }
        
        
        interface ICollateralManager {
            // Manager information
            function hasCollateral(address collateral) external view returns (bool);
        
            function isSynthManaged(bytes32 currencyKey) external view returns (bool);
        
            // State information
            function long(bytes32 synth) external view returns (uint amount);
        
            function short(bytes32 synth) external view returns (uint amount);
        
            function totalLong() external view returns (uint susdValue, bool anyRateIsInvalid);
        
            function totalShort() external view returns (uint susdValue, bool anyRateIsInvalid);
        
            function getBorrowRate() external view returns (uint borrowRate, bool anyRateIsInvalid);
        
            function getShortRate(bytes32 synth) external view returns (uint shortRate, bool rateIsInvalid);
        
            function getRatesAndTime(uint index)
                external
                view
                returns (
                    uint entryRate,
                    uint lastRate,
                    uint lastUpdated,
                    uint newIndex
                );
        
            function getShortRatesAndTime(bytes32 currency, uint index)
                external
                view
                returns (
                    uint entryRate,
                    uint lastRate,
                    uint lastUpdated,
                    uint newIndex
                );
        
            function exceedsDebtLimit(uint amount, bytes32 currency) external view returns (bool canIssue, bool anyRateIsInvalid);
        
            function areSynthsAndCurrenciesSet(bytes32[] calldata requiredSynthNamesInResolver, bytes32[] calldata synthKeys)
                external
                view
                returns (bool);
        
            function areShortableSynthsSet(bytes32[] calldata requiredSynthNamesInResolver, bytes32[] calldata synthKeys)
                external
                view
                returns (bool);
        
            // Loans
            function getNewLoanId() external returns (uint id);
        
            // Manager mutative
            function addCollaterals(address[] calldata collaterals) external;
        
            function removeCollaterals(address[] calldata collaterals) external;
        
            function addSynths(bytes32[] calldata synthNamesInResolver, bytes32[] calldata synthKeys) external;
        
            function removeSynths(bytes32[] calldata synths, bytes32[] calldata synthKeys) external;
        
            function addShortableSynths(bytes32[2][] calldata requiredSynthAndInverseNamesInResolver, bytes32[] calldata synthKeys)
                external;
        
            function removeShortableSynths(bytes32[] calldata synths) external;
        
            // State mutative
            function updateBorrowRates(uint rate) external;
        
            function updateShortRates(bytes32 currency, uint rate) external;
        
            function incrementLongs(bytes32 synth, uint amount) external;
        
            function decrementLongs(bytes32 synth, uint amount) external;
        
            function incrementShorts(bytes32 synth, uint amount) external;
        
            function decrementShorts(bytes32 synth, uint amount) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/isystemstatus
        interface ISystemStatus {
            struct Status {
                bool canSuspend;
                bool canResume;
            }
        
            struct Suspension {
                bool suspended;
                // reason is an integer code,
                // 0 => no reason, 1 => upgrading, 2+ => defined by system usage
                uint248 reason;
            }
        
            // Views
            function accessControl(bytes32 section, address account) external view returns (bool canSuspend, bool canResume);
        
            function requireSystemActive() external view;
        
            function requireIssuanceActive() external view;
        
            function requireExchangeActive() external view;
        
            function requireSynthActive(bytes32 currencyKey) external view;
        
            function requireSynthsActive(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view;
        
            function synthSuspension(bytes32 currencyKey) external view returns (bool suspended, uint248 reason);
        
            // Restricted functions
            function suspendSynth(bytes32 currencyKey, uint256 reason) external;
        
            function updateAccessControl(
                bytes32 section,
                address account,
                bool canSuspend,
                bool canResume
            ) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/ifeepool
        interface IFeePool {
            // Views
        
            // solhint-disable-next-line func-name-mixedcase
            function FEE_ADDRESS() external view returns (address);
        
            function feesAvailable(address account) external view returns (uint, uint);
        
            function feePeriodDuration() external view returns (uint);
        
            function isFeesClaimable(address account) external view returns (bool);
        
            function targetThreshold() external view returns (uint);
        
            function totalFeesAvailable() external view returns (uint);
        
            function totalRewardsAvailable() external view returns (uint);
        
            // Mutative Functions
            function claimFees() external returns (bool);
        
            function claimOnBehalf(address claimingForAddress) external returns (bool);
        
            function closeCurrentFeePeriod() external;
        
            // Restricted: used internally to Synthetix
            function appendAccountIssuanceRecord(
                address account,
                uint lockedAmount,
                uint debtEntryIndex
            ) external;
        
            function recordFeePaid(uint sUSDAmount) external;
        
            function setRewardsToDistribute(uint amount) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/ierc20
        interface IERC20 {
            // ERC20 Optional Views
            function name() external view returns (string memory);
        
            function symbol() external view returns (string memory);
        
            function decimals() external view returns (uint8);
        
            // Views
            function totalSupply() external view returns (uint);
        
            function balanceOf(address owner) external view returns (uint);
        
            function allowance(address owner, address spender) external view returns (uint);
        
            // Mutative functions
            function transfer(address to, uint value) external returns (bool);
        
            function approve(address spender, uint value) external returns (bool);
        
            function transferFrom(
                address from,
                address to,
                uint value
            ) external returns (bool);
        
            // Events
            event Transfer(address indexed from, address indexed to, uint value);
        
            event Approval(address indexed owner, address indexed spender, uint value);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iexchangerates
        interface IExchangeRates {
            // Structs
            struct RateAndUpdatedTime {
                uint216 rate;
                uint40 time;
            }
        
            struct InversePricing {
                uint entryPoint;
                uint upperLimit;
                uint lowerLimit;
                bool frozenAtUpperLimit;
                bool frozenAtLowerLimit;
            }
        
            // Views
            function aggregators(bytes32 currencyKey) external view returns (address);
        
            function aggregatorWarningFlags() external view returns (address);
        
            function anyRateIsInvalid(bytes32[] calldata currencyKeys) external view returns (bool);
        
            function canFreezeRate(bytes32 currencyKey) external view returns (bool);
        
            function currentRoundForRate(bytes32 currencyKey) external view returns (uint);
        
            function currenciesUsingAggregator(address aggregator) external view returns (bytes32[] memory);
        
            function effectiveValue(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            ) external view returns (uint value);
        
            function effectiveValueAndRates(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            )
                external
                view
                returns (
                    uint value,
                    uint sourceRate,
                    uint destinationRate
                );
        
            function effectiveValueAtRound(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                uint roundIdForSrc,
                uint roundIdForDest
            ) external view returns (uint value);
        
            function getCurrentRoundId(bytes32 currencyKey) external view returns (uint);
        
            function getLastRoundIdBeforeElapsedSecs(
                bytes32 currencyKey,
                uint startingRoundId,
                uint startingTimestamp,
                uint timediff
            ) external view returns (uint);
        
            function inversePricing(bytes32 currencyKey)
                external
                view
                returns (
                    uint entryPoint,
                    uint upperLimit,
                    uint lowerLimit,
                    bool frozenAtUpperLimit,
                    bool frozenAtLowerLimit
                );
        
            function lastRateUpdateTimes(bytes32 currencyKey) external view returns (uint256);
        
            function oracle() external view returns (address);
        
            function rateAndTimestampAtRound(bytes32 currencyKey, uint roundId) external view returns (uint rate, uint time);
        
            function rateAndUpdatedTime(bytes32 currencyKey) external view returns (uint rate, uint time);
        
            function rateAndInvalid(bytes32 currencyKey) external view returns (uint rate, bool isInvalid);
        
            function rateForCurrency(bytes32 currencyKey) external view returns (uint);
        
            function rateIsFlagged(bytes32 currencyKey) external view returns (bool);
        
            function rateIsFrozen(bytes32 currencyKey) external view returns (bool);
        
            function rateIsInvalid(bytes32 currencyKey) external view returns (bool);
        
            function rateIsStale(bytes32 currencyKey) external view returns (bool);
        
            function rateStalePeriod() external view returns (uint);
        
            function ratesAndUpdatedTimeForCurrencyLastNRounds(bytes32 currencyKey, uint numRounds)
                external
                view
                returns (uint[] memory rates, uint[] memory times);
        
            function ratesAndInvalidForCurrencies(bytes32[] calldata currencyKeys)
                external
                view
                returns (uint[] memory rates, bool anyRateInvalid);
        
            function ratesForCurrencies(bytes32[] calldata currencyKeys) external view returns (uint[] memory);
        
            // Mutative functions
            function freezeRate(bytes32 currencyKey) external;
        }
        
        
        interface IVirtualSynth {
            // Views
            function balanceOfUnderlying(address account) external view returns (uint);
        
            function rate() external view returns (uint);
        
            function readyToSettle() external view returns (bool);
        
            function secsLeftInWaitingPeriod() external view returns (uint);
        
            function settled() external view returns (bool);
        
            function synth() external view returns (ISynth);
        
            // Mutative functions
            function settle(address account) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iexchanger
        interface IExchanger {
            // Views
            function calculateAmountAfterSettlement(
                address from,
                bytes32 currencyKey,
                uint amount,
                uint refunded
            ) external view returns (uint amountAfterSettlement);
        
            function isSynthRateInvalid(bytes32 currencyKey) external view returns (bool);
        
            function maxSecsLeftInWaitingPeriod(address account, bytes32 currencyKey) external view returns (uint);
        
            function settlementOwing(address account, bytes32 currencyKey)
                external
                view
                returns (
                    uint reclaimAmount,
                    uint rebateAmount,
                    uint numEntries
                );
        
            function hasWaitingPeriodOrSettlementOwing(address account, bytes32 currencyKey) external view returns (bool);
        
            function feeRateForExchange(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey)
                external
                view
                returns (uint exchangeFeeRate);
        
            function getAmountsForExchange(
                uint sourceAmount,
                bytes32 sourceCurrencyKey,
                bytes32 destinationCurrencyKey
            )
                external
                view
                returns (
                    uint amountReceived,
                    uint fee,
                    uint exchangeFeeRate
                );
        
            function priceDeviationThresholdFactor() external view returns (uint);
        
            function waitingPeriodSecs() external view returns (uint);
        
            // Mutative functions
            function exchange(
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address destinationAddress
            ) external returns (uint amountReceived);
        
            function exchangeOnBehalf(
                address exchangeForAddress,
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            ) external returns (uint amountReceived);
        
            function exchangeWithTracking(
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address destinationAddress,
                address originator,
                bytes32 trackingCode
            ) external returns (uint amountReceived);
        
            function exchangeOnBehalfWithTracking(
                address exchangeForAddress,
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address originator,
                bytes32 trackingCode
            ) external returns (uint amountReceived);
        
            function exchangeWithVirtual(
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address destinationAddress,
                bytes32 trackingCode
            ) external returns (uint amountReceived, IVirtualSynth vSynth);
        
            function settle(address from, bytes32 currencyKey)
                external
                returns (
                    uint reclaimed,
                    uint refunded,
                    uint numEntries
                );
        
            function setLastExchangeRateForSynth(bytes32 currencyKey, uint rate) external;
        
            function suspendSynthWithInvalidRate(bytes32 currencyKey) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/istakingrewards
        interface IShortingRewards {
            // Views
            function lastTimeRewardApplicable() external view returns (uint256);
        
            function rewardPerToken() external view returns (uint256);
        
            function earned(address account) external view returns (uint256);
        
            function getRewardForDuration() external view returns (uint256);
        
            function totalSupply() external view returns (uint256);
        
            function balanceOf(address account) external view returns (uint256);
        
            // Mutative
        
            function enrol(address account, uint256 amount) external;
        
            function withdraw(address account, uint256 amount) external;
        
            function getReward(address account) external;
        
            function exit(address account) external;
        }
        
        
        // Inheritance
        
        
        // Libraries
        
        
        // Internal references
        
        
        contract Collateral is ICollateralLoan, Owned, MixinSystemSettings {
            /* ========== LIBRARIES ========== */
            using SafeMath for uint;
            using SafeDecimalMath for uint;
        
            /* ========== CONSTANTS ========== */
        
            bytes32 private constant sUSD = "sUSD";
        
            // ========== STATE VARIABLES ==========
        
            // The synth corresponding to the collateral.
            bytes32 public collateralKey;
        
            // Stores loans
            CollateralState public state;
        
            address public manager;
        
            // The synths that this contract can issue.
            bytes32[] public synths;
        
            // Map from currency key to synth contract name.
            mapping(bytes32 => bytes32) public synthsByKey;
        
            // Map from currency key to the shorting rewards contract
            mapping(bytes32 => address) public shortingRewards;
        
            // ========== SETTER STATE VARIABLES ==========
        
            // The minimum collateral ratio required to avoid liquidation.
            uint public minCratio;
        
            // The minimum amount of collateral to create a loan.
            uint public minCollateral;
        
            // The fee charged for issuing a loan.
            uint public issueFeeRate;
        
            // The maximum number of loans that an account can create with this collateral.
            uint public maxLoansPerAccount = 50;
        
            // Time in seconds that a user must wait between interacting with a loan.
            // Provides front running and flash loan protection.
            uint public interactionDelay = 300;
        
            bool public canOpenLoans = true;
        
            /* ========== ADDRESS RESOLVER CONFIGURATION ========== */
        
            bytes32 private constant CONTRACT_SYSTEMSTATUS = "SystemStatus";
            bytes32 private constant CONTRACT_EXRATES = "ExchangeRates";
            bytes32 private constant CONTRACT_EXCHANGER = "Exchanger";
            bytes32 private constant CONTRACT_FEEPOOL = "FeePool";
            bytes32 private constant CONTRACT_SYNTHSUSD = "SynthsUSD";
        
            /* ========== CONSTRUCTOR ========== */
        
            constructor(
                CollateralState _state,
                address _owner,
                address _manager,
                address _resolver,
                bytes32 _collateralKey,
                uint _minCratio,
                uint _minCollateral
            ) public Owned(_owner) MixinSystemSettings(_resolver) {
                manager = _manager;
                state = _state;
                collateralKey = _collateralKey;
                minCratio = _minCratio;
                minCollateral = _minCollateral;
            }
        
            /* ========== VIEWS ========== */
        
            function resolverAddressesRequired() public view returns (bytes32[] memory addresses) {
                bytes32[] memory existingAddresses = MixinSystemSettings.resolverAddressesRequired();
                bytes32[] memory newAddresses = new bytes32[](5);
                newAddresses[0] = CONTRACT_FEEPOOL;
                newAddresses[1] = CONTRACT_EXRATES;
                newAddresses[2] = CONTRACT_EXCHANGER;
                newAddresses[3] = CONTRACT_SYSTEMSTATUS;
                newAddresses[4] = CONTRACT_SYNTHSUSD;
        
                bytes32[] memory combined = combineArrays(existingAddresses, newAddresses);
        
                addresses = combineArrays(combined, synths);
            }
        
            /* ---------- Related Contracts ---------- */
        
            function _systemStatus() internal view returns (ISystemStatus) {
                return ISystemStatus(requireAndGetAddress(CONTRACT_SYSTEMSTATUS));
            }
        
            function _synth(bytes32 synthName) internal view returns (ISynth) {
                return ISynth(requireAndGetAddress(synthName));
            }
        
            function _synthsUSD() internal view returns (ISynth) {
                return ISynth(requireAndGetAddress(CONTRACT_SYNTHSUSD));
            }
        
            function _exchangeRates() internal view returns (IExchangeRates) {
                return IExchangeRates(requireAndGetAddress(CONTRACT_EXRATES));
            }
        
            function _exchanger() internal view returns (IExchanger) {
                return IExchanger(requireAndGetAddress(CONTRACT_EXCHANGER));
            }
        
            function _feePool() internal view returns (IFeePool) {
                return IFeePool(requireAndGetAddress(CONTRACT_FEEPOOL));
            }
        
            function _manager() internal view returns (ICollateralManager) {
                return ICollateralManager(manager);
            }
        
            /* ---------- Public Views ---------- */
        
            function collateralRatio(Loan memory loan) public view returns (uint cratio) {
                uint cvalue = _exchangeRates().effectiveValue(collateralKey, loan.collateral, sUSD);
                uint dvalue = _exchangeRates().effectiveValue(loan.currency, loan.amount.add(loan.accruedInterest), sUSD);
                cratio = cvalue.divideDecimal(dvalue);
            }
        
            // The maximum number of synths issuable for this amount of collateral
            function maxLoan(uint amount, bytes32 currency) public view returns (uint max) {
                max = issuanceRatio().multiplyDecimal(_exchangeRates().effectiveValue(collateralKey, amount, currency));
            }
        
            /**
             * r = target issuance ratio
             * D = debt value in sUSD
             * V = collateral value in sUSD
             * P = liquidation penalty
             * Calculates amount of synths = (D - V * r) / (1 - (1 + P) * r)
             * Note: if you pass a loan in here that is not eligible for liquidation it will revert.
             * We check the ratio first in liquidateInternal and only pass eligible loans in.
             */
            function liquidationAmount(Loan memory loan) public view returns (uint amount) {
                uint liquidationPenalty = getLiquidationPenalty();
                uint debtValue = _exchangeRates().effectiveValue(loan.currency, loan.amount.add(loan.accruedInterest), sUSD);
                uint collateralValue = _exchangeRates().effectiveValue(collateralKey, loan.collateral, sUSD);
                uint unit = SafeDecimalMath.unit();
        
                uint dividend = debtValue.sub(collateralValue.divideDecimal(minCratio));
                uint divisor = unit.sub(unit.add(liquidationPenalty).divideDecimal(minCratio));
        
                uint sUSDamount = dividend.divideDecimal(divisor);
        
                return _exchangeRates().effectiveValue(sUSD, sUSDamount, loan.currency);
            }
        
            // amount is the amount of synths we are liquidating
            function collateralRedeemed(bytes32 currency, uint amount) public view returns (uint collateral) {
                uint liquidationPenalty = getLiquidationPenalty();
                collateral = _exchangeRates().effectiveValue(currency, amount, collateralKey);
        
                collateral = collateral.multiplyDecimal(SafeDecimalMath.unit().add(liquidationPenalty));
            }
        
            function areSynthsAndCurrenciesSet(bytes32[] calldata _synthNamesInResolver, bytes32[] calldata _synthKeys)
                external
                view
                returns (bool)
            {
                if (synths.length != _synthNamesInResolver.length) {
                    return false;
                }
        
                for (uint i = 0; i < _synthNamesInResolver.length; i++) {
                    bytes32 synthName = _synthNamesInResolver[i];
                    if (synths[i] != synthName) {
                        return false;
                    }
                    if (synthsByKey[_synthKeys[i]] != synths[i]) {
                        return false;
                    }
                }
        
                return true;
            }
        
            /* ---------- UTILITIES ---------- */
        
            // Check the account has enough of the synth to make the payment
            function _checkSynthBalance(
                address payer,
                bytes32 key,
                uint amount
            ) internal view {
                require(IERC20(address(_synth(synthsByKey[key]))).balanceOf(payer) >= amount, "Not enough synth balance");
            }
        
            // We set the interest index to 0 to indicate the loan has been closed.
            function _checkLoanAvailable(Loan memory _loan) internal view {
                require(_loan.interestIndex > 0, "Loan does not exist");
                require(_loan.lastInteraction.add(interactionDelay) <= block.timestamp, "Loan recently interacted with");
            }
        
            function issuanceRatio() internal view returns (uint ratio) {
                ratio = SafeDecimalMath.unit().divideDecimalRound(minCratio);
            }
        
            /* ========== MUTATIVE FUNCTIONS ========== */
        
            /* ---------- Synths ---------- */
        
            function addSynths(bytes32[] calldata _synthNamesInResolver, bytes32[] calldata _synthKeys) external onlyOwner {
                require(_synthNamesInResolver.length == _synthKeys.length, "Input array length mismatch");
        
                for (uint i = 0; i < _synthNamesInResolver.length; i++) {
                    bytes32 synthName = _synthNamesInResolver[i];
                    synths.push(synthName);
                    synthsByKey[_synthKeys[i]] = synthName;
                }
        
                // ensure cache has the latest
                rebuildCache();
            }
        
            /* ---------- Rewards Contracts ---------- */
        
            function addRewardsContracts(address rewardsContract, bytes32 synth) external onlyOwner {
                shortingRewards[synth] = rewardsContract;
            }
        
            /* ---------- SETTERS ---------- */
        
            function setMinCratio(uint _minCratio) external onlyOwner {
                require(_minCratio > SafeDecimalMath.unit(), "Must be greater than 1");
                minCratio = _minCratio;
                emit MinCratioRatioUpdated(minCratio);
            }
        
            function setIssueFeeRate(uint _issueFeeRate) external onlyOwner {
                issueFeeRate = _issueFeeRate;
                emit IssueFeeRateUpdated(issueFeeRate);
            }
        
            function setInteractionDelay(uint _interactionDelay) external onlyOwner {
                require(_interactionDelay <= SafeDecimalMath.unit() * 3600, "Max 1 hour");
                interactionDelay = _interactionDelay;
                emit InteractionDelayUpdated(interactionDelay);
            }
        
            function setManager(address _newManager) external onlyOwner {
                manager = _newManager;
                emit ManagerUpdated(manager);
            }
        
            function setCanOpenLoans(bool _canOpenLoans) external onlyOwner {
                canOpenLoans = _canOpenLoans;
                emit CanOpenLoansUpdated(canOpenLoans);
            }
        
            /* ---------- LOAN INTERACTIONS ---------- */
        
            function openInternal(
                uint collateral,
                uint amount,
                bytes32 currency,
                bool short
            ) internal returns (uint id) {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                require(canOpenLoans, "Opening is disabled");
        
                // 1. Make sure the collateral rate is valid.
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. We can only issue certain synths.
                require(synthsByKey[currency] > 0, "Not allowed to issue this synth");
        
                // 3. Make sure the synth rate is not invalid.
                require(!_exchangeRates().rateIsInvalid(currency), "Currency rate is invalid");
        
                // 4. Collateral >= minimum collateral size.
                require(collateral >= minCollateral, "Not enough collateral to open");
        
                // 5. Cap the number of loans so that the array doesn't get too big.
                require(state.getNumLoans(msg.sender) < maxLoansPerAccount, "Max loans exceeded");
        
                // 6. Check we haven't hit the debt cap for non snx collateral.
                (bool canIssue, bool anyRateIsInvalid) = _manager().exceedsDebtLimit(amount, currency);
        
                require(canIssue && !anyRateIsInvalid, "Debt limit or invalid rate");
        
                // 7. Require requested loan < max loan
                require(amount <= maxLoan(collateral, currency), "Exceeds max borrowing power");
        
                // 8. This fee is denominated in the currency of the loan
                uint issueFee = amount.multiplyDecimalRound(issueFeeRate);
        
                // 9. Calculate the minting fee and subtract it from the loan amount
                uint loanAmountMinusFee = amount.sub(issueFee);
        
                // 10. Get a Loan ID
                id = _manager().getNewLoanId();
        
                // 11. Create the loan struct.
                Loan memory loan = Loan({
                    id: id,
                    account: msg.sender,
                    collateral: collateral,
                    currency: currency,
                    amount: amount,
                    short: short,
                    accruedInterest: 0,
                    interestIndex: 0,
                    lastInteraction: block.timestamp
                });
        
                // 12. Accrue interest on the loan.
                loan = accrueInterest(loan);
        
                // 13. Save the loan to storage
                state.createLoan(loan);
        
                // 14. Pay the minting fees to the fee pool
                _payFees(issueFee, currency);
        
                // 15. If its short, convert back to sUSD, otherwise issue the loan.
                if (short) {
                    _synthsUSD().issue(msg.sender, _exchangeRates().effectiveValue(currency, loanAmountMinusFee, sUSD));
                    _manager().incrementShorts(currency, amount);
        
                    if (shortingRewards[currency] != address(0)) {
                        IShortingRewards(shortingRewards[currency]).enrol(msg.sender, amount);
                    }
                } else {
                    _synth(synthsByKey[currency]).issue(msg.sender, loanAmountMinusFee);
                    _manager().incrementLongs(currency, amount);
                }
        
                // 16. Emit event
                emit LoanCreated(msg.sender, id, amount, collateral, currency, issueFee);
            }
        
            function closeInternal(address borrower, uint id) internal returns (uint collateral) {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                // 1. Make sure the collateral rate is valid
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. Get the loan.
                Loan memory loan = state.getLoan(borrower, id);
        
                // 3. Check loan is open and the last interaction time.
                _checkLoanAvailable(loan);
        
                // 4. Accrue interest on the loan.
                loan = accrueInterest(loan);
        
                // 5. Work out the total amount owing on the loan.
                uint total = loan.amount.add(loan.accruedInterest);
        
                // 6. Check they have enough balance to close the loan.
                _checkSynthBalance(loan.account, loan.currency, total);
        
                // 7. Burn the synths
                require(
                    !_exchanger().hasWaitingPeriodOrSettlementOwing(borrower, loan.currency),
                    "Waiting secs or settlement owing"
                );
                _synth(synthsByKey[loan.currency]).burn(borrower, total);
        
                // 8. Tell the manager.
                if (loan.short) {
                    _manager().decrementShorts(loan.currency, loan.amount);
        
                    if (shortingRewards[loan.currency] != address(0)) {
                        IShortingRewards(shortingRewards[loan.currency]).withdraw(borrower, loan.amount);
                    }
                } else {
                    _manager().decrementLongs(loan.currency, loan.amount);
                }
        
                // 9. Assign the collateral to be returned.
                collateral = loan.collateral;
        
                // 10. Pay fees
                _payFees(loan.accruedInterest, loan.currency);
        
                // 11. Record loan as closed
                loan.amount = 0;
                loan.collateral = 0;
                loan.accruedInterest = 0;
                loan.interestIndex = 0;
                loan.lastInteraction = block.timestamp;
                state.updateLoan(loan);
        
                // 12. Emit the event
                emit LoanClosed(borrower, id);
            }
        
            function closeByLiquidationInternal(
                address borrower,
                address liquidator,
                Loan memory loan
            ) internal returns (uint collateral) {
                // 1. Work out the total amount owing on the loan.
                uint total = loan.amount.add(loan.accruedInterest);
        
                // 2. Store this for the event.
                uint amount = loan.amount;
        
                // 3. Return collateral to the child class so it knows how much to transfer.
                collateral = loan.collateral;
        
                // 4. Burn the synths
                require(!_exchanger().hasWaitingPeriodOrSettlementOwing(liquidator, loan.currency), "Waiting or settlement owing");
                _synth(synthsByKey[loan.currency]).burn(liquidator, total);
        
                // 5. Tell the manager.
                if (loan.short) {
                    _manager().decrementShorts(loan.currency, loan.amount);
        
                    if (shortingRewards[loan.currency] != address(0)) {
                        IShortingRewards(shortingRewards[loan.currency]).withdraw(borrower, loan.amount);
                    }
                } else {
                    _manager().decrementLongs(loan.currency, loan.amount);
                }
        
                // 6. Pay fees
                _payFees(loan.accruedInterest, loan.currency);
        
                // 7. Record loan as closed
                loan.amount = 0;
                loan.collateral = 0;
                loan.accruedInterest = 0;
                loan.interestIndex = 0;
                loan.lastInteraction = block.timestamp;
                state.updateLoan(loan);
        
                // 8. Emit the event.
                emit LoanClosedByLiquidation(borrower, loan.id, liquidator, amount, collateral);
            }
        
            function depositInternal(
                address account,
                uint id,
                uint amount
            ) internal {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                // 1. Make sure the collateral rate is valid.
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. They sent some value > 0
                require(amount > 0, "Deposit must be greater than 0");
        
                // 3. Get the loan
                Loan memory loan = state.getLoan(account, id);
        
                // 4. Check loan is open and last interaction time.
                _checkLoanAvailable(loan);
        
                // 5. Accrue interest
                loan = accrueInterest(loan);
        
                // 6. Add the collateral
                loan.collateral = loan.collateral.add(amount);
        
                // 7. Update the last interaction time.
                loan.lastInteraction = block.timestamp;
        
                // 8. Store the loan
                state.updateLoan(loan);
        
                // 9. Emit the event
                emit CollateralDeposited(account, id, amount, loan.collateral);
            }
        
            function withdrawInternal(uint id, uint amount) internal returns (uint withdraw) {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                // 1. Make sure the collateral rate is valid.
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. Get the loan.
                Loan memory loan = state.getLoan(msg.sender, id);
        
                // 3. Check loan is open and last interaction time.
                _checkLoanAvailable(loan);
        
                // 4. Accrue interest.
                loan = accrueInterest(loan);
        
                // 5. Subtract the collateral.
                loan.collateral = loan.collateral.sub(amount);
        
                // 6. Update the last interaction time.
                loan.lastInteraction = block.timestamp;
        
                // 7. Check that the new amount does not put them under the minimum c ratio.
                require(collateralRatio(loan) > minCratio, "Cratio too low");
        
                // 8. Store the loan.
                state.updateLoan(loan);
        
                // 9. Assign the return variable.
                withdraw = amount;
        
                // 10. Emit the event.
                emit CollateralWithdrawn(msg.sender, id, amount, loan.collateral);
            }
        
            function liquidateInternal(
                address borrower,
                uint id,
                uint payment
            ) internal returns (uint collateralLiquidated) {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                // 1. Make sure the collateral rate is valid.
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. Check the payment amount.
                require(payment > 0, "Payment must be greater than 0");
        
                // 3. Get the loan.
                Loan memory loan = state.getLoan(borrower, id);
        
                // 4. Check loan is open and last interaction time.
                _checkLoanAvailable(loan);
        
                // 5. Accrue interest.
                loan = accrueInterest(loan);
        
                // 6. Check they have enough balance to make the payment.
                _checkSynthBalance(msg.sender, loan.currency, payment);
        
                // 7. Check they are eligible for liquidation.
                require(collateralRatio(loan) < minCratio, "Cratio above liquidation ratio");
        
                // 8. Determine how much needs to be liquidated to fix their c ratio.
                uint liqAmount = liquidationAmount(loan);
        
                // 9. Only allow them to liquidate enough to fix the c ratio.
                uint amountToLiquidate = liqAmount < payment ? liqAmount : payment;
        
                // 10. Work out the total amount owing on the loan.
                uint amountOwing = loan.amount.add(loan.accruedInterest);
        
                // 11. If its greater than the amount owing, we need to close the loan.
                if (amountToLiquidate >= amountOwing) {
                    return closeByLiquidationInternal(borrower, msg.sender, loan);
                }
        
                // 12. Process the payment to workout interest/principal split.
                loan = _processPayment(loan, amountToLiquidate);
        
                // 13. Work out how much collateral to redeem.
                collateralLiquidated = collateralRedeemed(loan.currency, amountToLiquidate);
                loan.collateral = loan.collateral.sub(collateralLiquidated);
        
                // 14. Update the last interaction time.
                loan.lastInteraction = block.timestamp;
        
                // 15. Burn the synths from the liquidator.
                require(!_exchanger().hasWaitingPeriodOrSettlementOwing(msg.sender, loan.currency), "Waiting or settlement owing");
                _synth(synthsByKey[loan.currency]).burn(msg.sender, amountToLiquidate);
        
                // 16. Store the loan.
                state.updateLoan(loan);
        
                // 17. Emit the event
                emit LoanPartiallyLiquidated(borrower, id, msg.sender, amountToLiquidate, collateralLiquidated);
            }
        
            function repayInternal(
                address borrower,
                address repayer,
                uint id,
                uint payment
            ) internal {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                // 1. Make sure the collateral rate is valid.
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. Check the payment amount.
                require(payment > 0, "Payment must be greater than 0");
        
                // 3. Get loan
                Loan memory loan = state.getLoan(borrower, id);
        
                // 4. Check loan is open and last interaction time.
                _checkLoanAvailable(loan);
        
                // 5. Accrue interest.
                loan = accrueInterest(loan);
        
                // 6. Check the spender has enough synths to make the repayment
                _checkSynthBalance(repayer, loan.currency, payment);
        
                // 7. Process the payment.
                loan = _processPayment(loan, payment);
        
                // 8. Update the last interaction time.
                loan.lastInteraction = block.timestamp;
        
                // 9. Burn synths from the payer
                require(!_exchanger().hasWaitingPeriodOrSettlementOwing(repayer, loan.currency), "Waiting or settlement owing");
                _synth(synthsByKey[loan.currency]).burn(repayer, payment);
        
                // 10. Store the loan
                state.updateLoan(loan);
        
                // 11. Emit the event.
                emit LoanRepaymentMade(borrower, repayer, id, payment, loan.amount);
            }
        
            function drawInternal(uint id, uint amount) internal {
                // 0. Check the system is active.
                _systemStatus().requireIssuanceActive();
        
                // 1. Make sure the collateral rate is valid.
                require(!_exchangeRates().rateIsInvalid(collateralKey), "Collateral rate is invalid");
        
                // 2. Get loan.
                Loan memory loan = state.getLoan(msg.sender, id);
        
                // 3. Check loan is open and last interaction time.
                _checkLoanAvailable(loan);
        
                // 4. Accrue interest.
                loan = accrueInterest(loan);
        
                // 5. Add the requested amount.
                loan.amount = loan.amount.add(amount);
        
                // 6. If it is below the minimum, don't allow this draw.
                require(collateralRatio(loan) > minCratio, "Cannot draw this much");
        
                // 7. This fee is denominated in the currency of the loan
                uint issueFee = amount.multiplyDecimalRound(issueFeeRate);
        
                // 8. Calculate the minting fee and subtract it from the draw amount
                uint amountMinusFee = amount.sub(issueFee);
        
                // 9. If its short, let the child handle it, otherwise issue the synths.
                if (loan.short) {
                    _manager().incrementShorts(loan.currency, amount);
                    _synthsUSD().issue(msg.sender, _exchangeRates().effectiveValue(loan.currency, amountMinusFee, sUSD));
        
                    if (shortingRewards[loan.currency] != address(0)) {
                        IShortingRewards(shortingRewards[loan.currency]).enrol(msg.sender, amount);
                    }
                } else {
                    _manager().incrementLongs(loan.currency, amount);
                    _synth(synthsByKey[loan.currency]).issue(msg.sender, amountMinusFee);
                }
        
                // 10. Pay the minting fees to the fee pool
                _payFees(issueFee, loan.currency);
        
                // 11. Update the last interaction time.
                loan.lastInteraction = block.timestamp;
        
                // 12. Store the loan
                state.updateLoan(loan);
        
                // 13. Emit the event.
                emit LoanDrawnDown(msg.sender, id, amount);
            }
        
            // Update the cumulative interest rate for the currency that was interacted with.
            function accrueInterest(Loan memory loan) internal returns (Loan memory loanAfter) {
                loanAfter = loan;
        
                // 1. Get the rates we need.
                (uint entryRate, uint lastRate, uint lastUpdated, uint newIndex) = loan.short
                    ? _manager().getShortRatesAndTime(loan.currency, loan.interestIndex)
                    : _manager().getRatesAndTime(loan.interestIndex);
        
                // 2. Get the instantaneous rate.
                (uint rate, bool invalid) = loan.short
                    ? _manager().getShortRate(synthsByKey[loan.currency])
                    : _manager().getBorrowRate();
        
                require(!invalid, "Rates are invalid");
        
                // 3. Get the time since we last updated the rate.
                uint timeDelta = block.timestamp.sub(lastUpdated).mul(SafeDecimalMath.unit());
        
                // 4. Get the latest cumulative rate. F_n+1 = F_n + F_last
                uint latestCumulative = lastRate.add(rate.multiplyDecimal(timeDelta));
        
                // 5. If the loan was just opened, don't record any interest. Otherwise multiple by the amount outstanding.
                uint interest = loan.interestIndex == 0 ? 0 : loan.amount.multiplyDecimal(latestCumulative.sub(entryRate));
        
                // 7. Update rates with the lastest cumulative rate. This also updates the time.
                loan.short
                    ? _manager().updateShortRates(loan.currency, latestCumulative)
                    : _manager().updateBorrowRates(latestCumulative);
        
                // 8. Update loan
                loanAfter.accruedInterest = loan.accruedInterest.add(interest);
                loanAfter.interestIndex = newIndex;
                state.updateLoan(loanAfter);
            }
        
            // Works out the amount of interest and principal after a repayment is made.
            function _processPayment(Loan memory loanBefore, uint payment) internal returns (Loan memory loanAfter) {
                loanAfter = loanBefore;
        
                if (payment > 0 && loanBefore.accruedInterest > 0) {
                    uint interestPaid = payment > loanBefore.accruedInterest ? loanBefore.accruedInterest : payment;
                    loanAfter.accruedInterest = loanBefore.accruedInterest.sub(interestPaid);
                    payment = payment.sub(interestPaid);
        
                    _payFees(interestPaid, loanBefore.currency);
                }
        
                // If there is more payment left after the interest, pay down the principal.
                if (payment > 0) {
                    loanAfter.amount = loanBefore.amount.sub(payment);
        
                    // And get the manager to reduce the total long/short balance.
                    if (loanAfter.short) {
                        _manager().decrementShorts(loanAfter.currency, payment);
        
                        if (shortingRewards[loanAfter.currency] != address(0)) {
                            IShortingRewards(shortingRewards[loanAfter.currency]).withdraw(loanAfter.account, payment);
                        }
                    } else {
                        _manager().decrementLongs(loanAfter.currency, payment);
                    }
                }
            }
        
            // Take an amount of fees in a certain synth and convert it to sUSD before paying the fee pool.
            function _payFees(uint amount, bytes32 synth) internal {
                if (amount > 0) {
                    if (synth != sUSD) {
                        amount = _exchangeRates().effectiveValue(synth, amount, sUSD);
                    }
                    _synthsUSD().issue(_feePool().FEE_ADDRESS(), amount);
                    _feePool().recordFeePaid(amount);
                }
            }
        
            // ========== EVENTS ==========
            // Setters
            event MinCratioRatioUpdated(uint minCratio);
            event MinCollateralUpdated(uint minCollateral);
            event IssueFeeRateUpdated(uint issueFeeRate);
            event MaxLoansPerAccountUpdated(uint maxLoansPerAccount);
            event InteractionDelayUpdated(uint interactionDelay);
            event ManagerUpdated(address manager);
            event CanOpenLoansUpdated(bool canOpenLoans);
        
            // Loans
            event LoanCreated(address indexed account, uint id, uint amount, uint collateral, bytes32 currency, uint issuanceFee);
            event LoanClosed(address indexed account, uint id);
            event CollateralDeposited(address indexed account, uint id, uint amountDeposited, uint collateralAfter);
            event CollateralWithdrawn(address indexed account, uint id, uint amountWithdrawn, uint collateralAfter);
            event LoanRepaymentMade(address indexed account, address indexed repayer, uint id, uint amountRepaid, uint amountAfter);
            event LoanDrawnDown(address indexed account, uint id, uint amount);
            event LoanPartiallyLiquidated(
                address indexed account,
                uint id,
                address liquidator,
                uint amountLiquidated,
                uint collateralLiquidated
            );
            event LoanClosedByLiquidation(
                address indexed account,
                uint id,
                address indexed liquidator,
                uint amountLiquidated,
                uint collateralLiquidated
            );
        }
        
        
        interface ICollateralErc20 {
            function open(
                uint collateral,
                uint amount,
                bytes32 currency
            ) external;
        
            function close(uint id) external;
        
            function deposit(
                address borrower,
                uint id,
                uint collateral
            ) external;
        
            function withdraw(uint id, uint amount) external;
        
            function repay(
                address borrower,
                uint id,
                uint amount
            ) external;
        
            function draw(uint id, uint amount) external;
        
            function liquidate(
                address borrower,
                uint id,
                uint amount
            ) external;
        }
        
        
        // Inheritance
        
        
        // Internal references
        
        
        // This contract handles the specific ERC20 implementation details of managing a loan.
        contract CollateralErc20 is ICollateralErc20, Collateral {
            // The underlying asset for this ERC20 collateral
            address public underlyingContract;
        
            uint public underlyingContractDecimals;
        
            constructor(
                CollateralState _state,
                address _owner,
                address _manager,
                address _resolver,
                bytes32 _collateralKey,
                uint _minCratio,
                uint _minCollateral,
                address _underlyingContract,
                uint _underlyingDecimals
            ) public Collateral(_state, _owner, _manager, _resolver, _collateralKey, _minCratio, _minCollateral) {
                underlyingContract = _underlyingContract;
        
                underlyingContractDecimals = _underlyingDecimals;
            }
        
            function open(
                uint collateral,
                uint amount,
                bytes32 currency
            ) external {
                require(collateral <= IERC20(underlyingContract).allowance(msg.sender, address(this)), "Allowance not high enough");
        
                // only transfer the actual collateral
                IERC20(underlyingContract).transferFrom(msg.sender, address(this), collateral);
        
                // scale up before entering the system.
                uint scaledCollateral = scaleUpCollateral(collateral);
        
                openInternal(scaledCollateral, amount, currency, false);
            }
        
            function close(uint id) external {
                uint collateral = closeInternal(msg.sender, id);
        
                // scale down before transferring back.
                uint scaledCollateral = scaleDownCollateral(collateral);
        
                IERC20(underlyingContract).transfer(msg.sender, scaledCollateral);
            }
        
            function deposit(
                address borrower,
                uint id,
                uint amount
            ) external {
                require(amount <= IERC20(underlyingContract).allowance(msg.sender, address(this)), "Allowance not high enough");
        
                IERC20(underlyingContract).transferFrom(msg.sender, address(this), amount);
        
                // scale up before entering the system.
                uint scaledAmount = scaleUpCollateral(amount);
        
                depositInternal(borrower, id, scaledAmount);
            }
        
            function withdraw(uint id, uint amount) external {
                // scale up before entering the system.
                uint scaledAmount = scaleUpCollateral(amount);
        
                uint withdrawnAmount = withdrawInternal(id, scaledAmount);
        
                // scale down before transferring back.
                uint scaledWithdraw = scaleDownCollateral(withdrawnAmount);
        
                IERC20(underlyingContract).transfer(msg.sender, scaledWithdraw);
            }
        
            function repay(
                address borrower,
                uint id,
                uint amount
            ) external {
                repayInternal(borrower, msg.sender, id, amount);
            }
        
            function draw(uint id, uint amount) external {
                drawInternal(id, amount);
            }
        
            function liquidate(
                address borrower,
                uint id,
                uint amount
            ) external {
                uint collateralLiquidated = liquidateInternal(borrower, id, amount);
        
                // scale down before transferring back.
                uint scaledCollateral = scaleDownCollateral(collateralLiquidated);
        
                IERC20(underlyingContract).transfer(msg.sender, scaledCollateral);
            }
        
            function scaleUpCollateral(uint collateral) public view returns (uint scaledUp) {
                uint conversionFactor = 10**uint(SafeMath.sub(18, underlyingContractDecimals));
        
                scaledUp = uint(uint(collateral).mul(conversionFactor));
            }
        
            function scaleDownCollateral(uint collateral) public view returns (uint scaledDown) {
                uint conversionFactor = 10**uint(SafeMath.sub(18, underlyingContractDecimals));
        
                scaledDown = collateral.div(conversionFactor);
            }
        }
        
            

        File 2 of 8: SystemStatus
        /*
           ____            __   __        __   _
          / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
         _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
        /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
             /___/
        
        * Synthetix: SystemStatus.sol
        *
        * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/SystemStatus.sol
        * Docs: https://docs.synthetix.io/contracts/SystemStatus
        *
        * Contract Dependencies: 
        *	- ISystemStatus
        *	- Owned
        * Libraries: (none)
        *
        * MIT License
        * ===========
        *
        * Copyright (c) 2021 Synthetix
        *
        * Permission is hereby granted, free of charge, to any person obtaining a copy
        * of this software and associated documentation files (the "Software"), to deal
        * in the Software without restriction, including without limitation the rights
        * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        * copies of the Software, and to permit persons to whom the Software is
        * furnished to do so, subject to the following conditions:
        *
        * The above copyright notice and this permission notice shall be included in all
        * copies or substantial portions of the Software.
        *
        * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        */
        
        
        
        pragma solidity ^0.5.16;
        
        
        // https://docs.synthetix.io/contracts/source/contracts/owned
        contract Owned {
            address public owner;
            address public nominatedOwner;
        
            constructor(address _owner) public {
                require(_owner != address(0), "Owner address cannot be 0");
                owner = _owner;
                emit OwnerChanged(address(0), _owner);
            }
        
            function nominateNewOwner(address _owner) external onlyOwner {
                nominatedOwner = _owner;
                emit OwnerNominated(_owner);
            }
        
            function acceptOwnership() external {
                require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                emit OwnerChanged(owner, nominatedOwner);
                owner = nominatedOwner;
                nominatedOwner = address(0);
            }
        
            modifier onlyOwner {
                _onlyOwner();
                _;
            }
        
            function _onlyOwner() private view {
                require(msg.sender == owner, "Only the contract owner may perform this action");
            }
        
            event OwnerNominated(address newOwner);
            event OwnerChanged(address oldOwner, address newOwner);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/isystemstatus
        interface ISystemStatus {
            struct Status {
                bool canSuspend;
                bool canResume;
            }
        
            struct Suspension {
                bool suspended;
                // reason is an integer code,
                // 0 => no reason, 1 => upgrading, 2+ => defined by system usage
                uint248 reason;
            }
        
            // Views
            function accessControl(bytes32 section, address account) external view returns (bool canSuspend, bool canResume);
        
            function requireSystemActive() external view;
        
            function requireIssuanceActive() external view;
        
            function requireExchangeActive() external view;
        
            function requireExchangeBetweenSynthsAllowed(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view;
        
            function requireSynthActive(bytes32 currencyKey) external view;
        
            function requireSynthsActive(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view;
        
            function systemSuspension() external view returns (bool suspended, uint248 reason);
        
            function issuanceSuspension() external view returns (bool suspended, uint248 reason);
        
            function exchangeSuspension() external view returns (bool suspended, uint248 reason);
        
            function synthExchangeSuspension(bytes32 currencyKey) external view returns (bool suspended, uint248 reason);
        
            function synthSuspension(bytes32 currencyKey) external view returns (bool suspended, uint248 reason);
        
            function getSynthExchangeSuspensions(bytes32[] calldata synths)
                external
                view
                returns (bool[] memory exchangeSuspensions, uint256[] memory reasons);
        
            function getSynthSuspensions(bytes32[] calldata synths)
                external
                view
                returns (bool[] memory suspensions, uint256[] memory reasons);
        
            // Restricted functions
            function suspendSynth(bytes32 currencyKey, uint256 reason) external;
        
            function updateAccessControl(
                bytes32 section,
                address account,
                bool canSuspend,
                bool canResume
            ) external;
        }
        
        
        // Inheritance
        
        
        // https://docs.synthetix.io/contracts/source/contracts/systemstatus
        contract SystemStatus is Owned, ISystemStatus {
            mapping(bytes32 => mapping(address => Status)) public accessControl;
        
            uint248 public constant SUSPENSION_REASON_UPGRADE = 1;
        
            bytes32 public constant SECTION_SYSTEM = "System";
            bytes32 public constant SECTION_ISSUANCE = "Issuance";
            bytes32 public constant SECTION_EXCHANGE = "Exchange";
            bytes32 public constant SECTION_SYNTH_EXCHANGE = "SynthExchange";
            bytes32 public constant SECTION_SYNTH = "Synth";
        
            Suspension public systemSuspension;
        
            Suspension public issuanceSuspension;
        
            Suspension public exchangeSuspension;
        
            mapping(bytes32 => Suspension) public synthExchangeSuspension;
        
            mapping(bytes32 => Suspension) public synthSuspension;
        
            constructor(address _owner) public Owned(_owner) {}
        
            /* ========== VIEWS ========== */
            function requireSystemActive() external view {
                _internalRequireSystemActive();
            }
        
            function requireIssuanceActive() external view {
                // Issuance requires the system be active
                _internalRequireSystemActive();
        
                // and issuance itself of course
                _internalRequireIssuanceActive();
            }
        
            function requireExchangeActive() external view {
                // Exchanging requires the system be active
                _internalRequireSystemActive();
        
                // and exchanging itself of course
                _internalRequireExchangeActive();
            }
        
            function requireSynthExchangeActive(bytes32 currencyKey) external view {
                // Synth exchange and transfer requires the system be active
                _internalRequireSystemActive();
                _internalRequireSynthExchangeActive(currencyKey);
            }
        
            function requireSynthActive(bytes32 currencyKey) external view {
                // Synth exchange and transfer requires the system be active
                _internalRequireSystemActive();
                _internalRequireSynthActive(currencyKey);
            }
        
            function requireSynthsActive(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view {
                // Synth exchange and transfer requires the system be active
                _internalRequireSystemActive();
                _internalRequireSynthActive(sourceCurrencyKey);
                _internalRequireSynthActive(destinationCurrencyKey);
            }
        
            function requireExchangeBetweenSynthsAllowed(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey) external view {
                // Synth exchange and transfer requires the system be active
                _internalRequireSystemActive();
        
                // and exchanging must be active
                _internalRequireExchangeActive();
        
                // and the synth exchanging between the synths must be active
                _internalRequireSynthExchangeActive(sourceCurrencyKey);
                _internalRequireSynthExchangeActive(destinationCurrencyKey);
        
                // and finally, the synths cannot be suspended
                _internalRequireSynthActive(sourceCurrencyKey);
                _internalRequireSynthActive(destinationCurrencyKey);
            }
        
            function isSystemUpgrading() external view returns (bool) {
                return systemSuspension.suspended && systemSuspension.reason == SUSPENSION_REASON_UPGRADE;
            }
        
            function getSynthExchangeSuspensions(bytes32[] calldata synths)
                external
                view
                returns (bool[] memory exchangeSuspensions, uint256[] memory reasons)
            {
                exchangeSuspensions = new bool[](synths.length);
                reasons = new uint256[](synths.length);
        
                for (uint i = 0; i < synths.length; i++) {
                    exchangeSuspensions[i] = synthExchangeSuspension[synths[i]].suspended;
                    reasons[i] = synthExchangeSuspension[synths[i]].reason;
                }
            }
        
            function getSynthSuspensions(bytes32[] calldata synths)
                external
                view
                returns (bool[] memory suspensions, uint256[] memory reasons)
            {
                suspensions = new bool[](synths.length);
                reasons = new uint256[](synths.length);
        
                for (uint i = 0; i < synths.length; i++) {
                    suspensions[i] = synthSuspension[synths[i]].suspended;
                    reasons[i] = synthSuspension[synths[i]].reason;
                }
            }
        
            /* ========== MUTATIVE FUNCTIONS ========== */
            function updateAccessControl(
                bytes32 section,
                address account,
                bool canSuspend,
                bool canResume
            ) external onlyOwner {
                _internalUpdateAccessControl(section, account, canSuspend, canResume);
            }
        
            function updateAccessControls(
                bytes32[] calldata sections,
                address[] calldata accounts,
                bool[] calldata canSuspends,
                bool[] calldata canResumes
            ) external onlyOwner {
                require(
                    sections.length == accounts.length &&
                        accounts.length == canSuspends.length &&
                        canSuspends.length == canResumes.length,
                    "Input array lengths must match"
                );
                for (uint i = 0; i < sections.length; i++) {
                    _internalUpdateAccessControl(sections[i], accounts[i], canSuspends[i], canResumes[i]);
                }
            }
        
            function suspendSystem(uint256 reason) external {
                _requireAccessToSuspend(SECTION_SYSTEM);
                systemSuspension.suspended = true;
                systemSuspension.reason = uint248(reason);
                emit SystemSuspended(systemSuspension.reason);
            }
        
            function resumeSystem() external {
                _requireAccessToResume(SECTION_SYSTEM);
                systemSuspension.suspended = false;
                emit SystemResumed(uint256(systemSuspension.reason));
                systemSuspension.reason = 0;
            }
        
            function suspendIssuance(uint256 reason) external {
                _requireAccessToSuspend(SECTION_ISSUANCE);
                issuanceSuspension.suspended = true;
                issuanceSuspension.reason = uint248(reason);
                emit IssuanceSuspended(reason);
            }
        
            function resumeIssuance() external {
                _requireAccessToResume(SECTION_ISSUANCE);
                issuanceSuspension.suspended = false;
                emit IssuanceResumed(uint256(issuanceSuspension.reason));
                issuanceSuspension.reason = 0;
            }
        
            function suspendExchange(uint256 reason) external {
                _requireAccessToSuspend(SECTION_EXCHANGE);
                exchangeSuspension.suspended = true;
                exchangeSuspension.reason = uint248(reason);
                emit ExchangeSuspended(reason);
            }
        
            function resumeExchange() external {
                _requireAccessToResume(SECTION_EXCHANGE);
                exchangeSuspension.suspended = false;
                emit ExchangeResumed(uint256(exchangeSuspension.reason));
                exchangeSuspension.reason = 0;
            }
        
            function suspendSynthExchange(bytes32 currencyKey, uint256 reason) external {
                bytes32[] memory currencyKeys = new bytes32[](1);
                currencyKeys[0] = currencyKey;
                _internalSuspendSynthExchange(currencyKeys, reason);
            }
        
            function suspendSynthsExchange(bytes32[] calldata currencyKeys, uint256 reason) external {
                _internalSuspendSynthExchange(currencyKeys, reason);
            }
        
            function resumeSynthExchange(bytes32 currencyKey) external {
                bytes32[] memory currencyKeys = new bytes32[](1);
                currencyKeys[0] = currencyKey;
                _internalResumeSynthsExchange(currencyKeys);
            }
        
            function resumeSynthsExchange(bytes32[] calldata currencyKeys) external {
                _internalResumeSynthsExchange(currencyKeys);
            }
        
            function suspendSynth(bytes32 currencyKey, uint256 reason) external {
                bytes32[] memory currencyKeys = new bytes32[](1);
                currencyKeys[0] = currencyKey;
                _internalSuspendSynths(currencyKeys, reason);
            }
        
            function suspendSynths(bytes32[] calldata currencyKeys, uint256 reason) external {
                _internalSuspendSynths(currencyKeys, reason);
            }
        
            function resumeSynth(bytes32 currencyKey) external {
                bytes32[] memory currencyKeys = new bytes32[](1);
                currencyKeys[0] = currencyKey;
                _internalResumeSynths(currencyKeys);
            }
        
            function resumeSynths(bytes32[] calldata currencyKeys) external {
                _internalResumeSynths(currencyKeys);
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function _requireAccessToSuspend(bytes32 section) internal view {
                require(accessControl[section][msg.sender].canSuspend, "Restricted to access control list");
            }
        
            function _requireAccessToResume(bytes32 section) internal view {
                require(accessControl[section][msg.sender].canResume, "Restricted to access control list");
            }
        
            function _internalRequireSystemActive() internal view {
                require(
                    !systemSuspension.suspended,
                    systemSuspension.reason == SUSPENSION_REASON_UPGRADE
                        ? "Synthetix is suspended, upgrade in progress... please stand by"
                        : "Synthetix is suspended. Operation prohibited"
                );
            }
        
            function _internalRequireIssuanceActive() internal view {
                require(!issuanceSuspension.suspended, "Issuance is suspended. Operation prohibited");
            }
        
            function _internalRequireExchangeActive() internal view {
                require(!exchangeSuspension.suspended, "Exchange is suspended. Operation prohibited");
            }
        
            function _internalRequireSynthExchangeActive(bytes32 currencyKey) internal view {
                require(!synthExchangeSuspension[currencyKey].suspended, "Synth exchange suspended. Operation prohibited");
            }
        
            function _internalRequireSynthActive(bytes32 currencyKey) internal view {
                require(!synthSuspension[currencyKey].suspended, "Synth is suspended. Operation prohibited");
            }
        
            function _internalSuspendSynths(bytes32[] memory currencyKeys, uint256 reason) internal {
                _requireAccessToSuspend(SECTION_SYNTH);
                for (uint i = 0; i < currencyKeys.length; i++) {
                    bytes32 currencyKey = currencyKeys[i];
                    synthSuspension[currencyKey].suspended = true;
                    synthSuspension[currencyKey].reason = uint248(reason);
                    emit SynthSuspended(currencyKey, reason);
                }
            }
        
            function _internalResumeSynths(bytes32[] memory currencyKeys) internal {
                _requireAccessToResume(SECTION_SYNTH);
                for (uint i = 0; i < currencyKeys.length; i++) {
                    bytes32 currencyKey = currencyKeys[i];
                    emit SynthResumed(currencyKey, uint256(synthSuspension[currencyKey].reason));
                    delete synthSuspension[currencyKey];
                }
            }
        
            function _internalSuspendSynthExchange(bytes32[] memory currencyKeys, uint256 reason) internal {
                _requireAccessToSuspend(SECTION_SYNTH_EXCHANGE);
                for (uint i = 0; i < currencyKeys.length; i++) {
                    bytes32 currencyKey = currencyKeys[i];
                    synthExchangeSuspension[currencyKey].suspended = true;
                    synthExchangeSuspension[currencyKey].reason = uint248(reason);
                    emit SynthExchangeSuspended(currencyKey, reason);
                }
            }
        
            function _internalResumeSynthsExchange(bytes32[] memory currencyKeys) internal {
                _requireAccessToResume(SECTION_SYNTH_EXCHANGE);
                for (uint i = 0; i < currencyKeys.length; i++) {
                    bytes32 currencyKey = currencyKeys[i];
                    emit SynthExchangeResumed(currencyKey, uint256(synthExchangeSuspension[currencyKey].reason));
                    delete synthExchangeSuspension[currencyKey];
                }
            }
        
            function _internalUpdateAccessControl(
                bytes32 section,
                address account,
                bool canSuspend,
                bool canResume
            ) internal {
                require(
                    section == SECTION_SYSTEM ||
                        section == SECTION_ISSUANCE ||
                        section == SECTION_EXCHANGE ||
                        section == SECTION_SYNTH_EXCHANGE ||
                        section == SECTION_SYNTH,
                    "Invalid section supplied"
                );
                accessControl[section][account].canSuspend = canSuspend;
                accessControl[section][account].canResume = canResume;
                emit AccessControlUpdated(section, account, canSuspend, canResume);
            }
        
            /* ========== EVENTS ========== */
        
            event SystemSuspended(uint256 reason);
            event SystemResumed(uint256 reason);
        
            event IssuanceSuspended(uint256 reason);
            event IssuanceResumed(uint256 reason);
        
            event ExchangeSuspended(uint256 reason);
            event ExchangeResumed(uint256 reason);
        
            event SynthExchangeSuspended(bytes32 currencyKey, uint256 reason);
            event SynthExchangeResumed(bytes32 currencyKey, uint256 reason);
        
            event SynthSuspended(bytes32 currencyKey, uint256 reason);
            event SynthResumed(bytes32 currencyKey, uint256 reason);
        
            event AccessControlUpdated(bytes32 indexed section, address indexed account, bool canSuspend, bool canResume);
        }
        
            

        File 3 of 8: ExchangeRates
        /*
           ____            __   __        __   _
          / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
         _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
        /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
             /___/
        
        * Synthetix: ExchangeRates.sol
        *
        * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/ExchangeRates.sol
        * Docs: https://docs.synthetix.io/contracts/ExchangeRates
        *
        * Contract Dependencies: 
        *	- IAddressResolver
        *	- IExchangeRates
        *	- MixinResolver
        *	- MixinSystemSettings
        *	- Owned
        * Libraries: 
        *	- SafeDecimalMath
        *	- SafeMath
        *
        * MIT License
        * ===========
        *
        * Copyright (c) 2020 Synthetix
        *
        * Permission is hereby granted, free of charge, to any person obtaining a copy
        * of this software and associated documentation files (the "Software"), to deal
        * in the Software without restriction, including without limitation the rights
        * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        * copies of the Software, and to permit persons to whom the Software is
        * furnished to do so, subject to the following conditions:
        *
        * The above copyright notice and this permission notice shall be included in all
        * copies or substantial portions of the Software.
        *
        * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        */
        
        
        
        pragma solidity ^0.5.16;
        
        
        // https://docs.synthetix.io/contracts/source/contracts/owned
        contract Owned {
            address public owner;
            address public nominatedOwner;
        
            constructor(address _owner) public {
                require(_owner != address(0), "Owner address cannot be 0");
                owner = _owner;
                emit OwnerChanged(address(0), _owner);
            }
        
            function nominateNewOwner(address _owner) external onlyOwner {
                nominatedOwner = _owner;
                emit OwnerNominated(_owner);
            }
        
            function acceptOwnership() external {
                require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                emit OwnerChanged(owner, nominatedOwner);
                owner = nominatedOwner;
                nominatedOwner = address(0);
            }
        
            modifier onlyOwner {
                _onlyOwner();
                _;
            }
        
            function _onlyOwner() private view {
                require(msg.sender == owner, "Only the contract owner may perform this action");
            }
        
            event OwnerNominated(address newOwner);
            event OwnerChanged(address oldOwner, address newOwner);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iaddressresolver
        interface IAddressResolver {
            function getAddress(bytes32 name) external view returns (address);
        
            function getSynth(bytes32 key) external view returns (address);
        
            function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/isynth
        interface ISynth {
            // Views
            function currencyKey() external view returns (bytes32);
        
            function transferableSynths(address account) external view returns (uint);
        
            // Mutative functions
            function transferAndSettle(address to, uint value) external returns (bool);
        
            function transferFromAndSettle(
                address from,
                address to,
                uint value
            ) external returns (bool);
        
            // Restricted: used internally to Synthetix
            function burn(address account, uint amount) external;
        
            function issue(address account, uint amount) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iissuer
        interface IIssuer {
            // Views
            function anySynthOrSNXRateIsInvalid() external view returns (bool anyRateInvalid);
        
            function availableCurrencyKeys() external view returns (bytes32[] memory);
        
            function availableSynthCount() external view returns (uint);
        
            function availableSynths(uint index) external view returns (ISynth);
        
            function canBurnSynths(address account) external view returns (bool);
        
            function collateral(address account) external view returns (uint);
        
            function collateralisationRatio(address issuer) external view returns (uint);
        
            function collateralisationRatioAndAnyRatesInvalid(address _issuer)
                external
                view
                returns (uint cratio, bool anyRateIsInvalid);
        
            function debtBalanceOf(address issuer, bytes32 currencyKey) external view returns (uint debtBalance);
        
            function issuanceRatio() external view returns (uint);
        
            function lastIssueEvent(address account) external view returns (uint);
        
            function maxIssuableSynths(address issuer) external view returns (uint maxIssuable);
        
            function minimumStakeTime() external view returns (uint);
        
            function remainingIssuableSynths(address issuer)
                external
                view
                returns (
                    uint maxIssuable,
                    uint alreadyIssued,
                    uint totalSystemDebt
                );
        
            function synths(bytes32 currencyKey) external view returns (ISynth);
        
            function getSynths(bytes32[] calldata currencyKeys) external view returns (ISynth[] memory);
        
            function synthsByAddress(address synthAddress) external view returns (bytes32);
        
            function totalIssuedSynths(bytes32 currencyKey, bool excludeEtherCollateral) external view returns (uint);
        
            function transferableSynthetixAndAnyRateIsInvalid(address account, uint balance)
                external
                view
                returns (uint transferable, bool anyRateIsInvalid);
        
            // Restricted: used internally to Synthetix
            function issueSynths(address from, uint amount) external;
        
            function issueSynthsOnBehalf(
                address issueFor,
                address from,
                uint amount
            ) external;
        
            function issueMaxSynths(address from) external;
        
            function issueMaxSynthsOnBehalf(address issueFor, address from) external;
        
            function burnSynths(address from, uint amount) external;
        
            function burnSynthsOnBehalf(
                address burnForAddress,
                address from,
                uint amount
            ) external;
        
            function burnSynthsToTarget(address from) external;
        
            function burnSynthsToTargetOnBehalf(address burnForAddress, address from) external;
        
            function liquidateDelinquentAccount(
                address account,
                uint susdAmount,
                address liquidator
            ) external returns (uint totalRedeemed, uint amountToLiquidate);
        }
        
        
        // Inheritance
        
        
        // Internal references
        
        
        // https://docs.synthetix.io/contracts/source/contracts/addressresolver
        contract AddressResolver is Owned, IAddressResolver {
            mapping(bytes32 => address) public repository;
        
            constructor(address _owner) public Owned(_owner) {}
        
            /* ========== RESTRICTED FUNCTIONS ========== */
        
            function importAddresses(bytes32[] calldata names, address[] calldata destinations) external onlyOwner {
                require(names.length == destinations.length, "Input lengths must match");
        
                for (uint i = 0; i < names.length; i++) {
                    bytes32 name = names[i];
                    address destination = destinations[i];
                    repository[name] = destination;
                    emit AddressImported(name, destination);
                }
            }
        
            /* ========= PUBLIC FUNCTIONS ========== */
        
            function rebuildCaches(MixinResolver[] calldata destinations) external {
                for (uint i = 0; i < destinations.length; i++) {
                    destinations[i].rebuildCache();
                }
            }
        
            /* ========== VIEWS ========== */
        
            function areAddressesImported(bytes32[] calldata names, address[] calldata destinations) external view returns (bool) {
                for (uint i = 0; i < names.length; i++) {
                    if (repository[names[i]] != destinations[i]) {
                        return false;
                    }
                }
                return true;
            }
        
            function getAddress(bytes32 name) external view returns (address) {
                return repository[name];
            }
        
            function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address) {
                address _foundAddress = repository[name];
                require(_foundAddress != address(0), reason);
                return _foundAddress;
            }
        
            function getSynth(bytes32 key) external view returns (address) {
                IIssuer issuer = IIssuer(repository["Issuer"]);
                require(address(issuer) != address(0), "Cannot find Issuer address");
                return address(issuer.synths(key));
            }
        
            /* ========== EVENTS ========== */
        
            event AddressImported(bytes32 name, address destination);
        }
        
        
        // solhint-disable payable-fallback
        
        // https://docs.synthetix.io/contracts/source/contracts/readproxy
        contract ReadProxy is Owned {
            address public target;
        
            constructor(address _owner) public Owned(_owner) {}
        
            function setTarget(address _target) external onlyOwner {
                target = _target;
                emit TargetUpdated(target);
            }
        
            function() external {
                // The basics of a proxy read call
                // Note that msg.sender in the underlying will always be the address of this contract.
                assembly {
                    calldatacopy(0, 0, calldatasize)
        
                    // Use of staticcall - this will revert if the underlying function mutates state
                    let result := staticcall(gas, sload(target_slot), 0, calldatasize, 0, 0)
                    returndatacopy(0, 0, returndatasize)
        
                    if iszero(result) {
                        revert(0, returndatasize)
                    }
                    return(0, returndatasize)
                }
            }
        
            event TargetUpdated(address newTarget);
        }
        
        
        // Inheritance
        
        
        // Internal references
        
        
        // https://docs.synthetix.io/contracts/source/contracts/mixinresolver
        contract MixinResolver {
            AddressResolver public resolver;
        
            mapping(bytes32 => address) private addressCache;
        
            constructor(address _resolver) internal {
                resolver = AddressResolver(_resolver);
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function combineArrays(bytes32[] memory first, bytes32[] memory second)
                internal
                pure
                returns (bytes32[] memory combination)
            {
                combination = new bytes32[](first.length + second.length);
        
                for (uint i = 0; i < first.length; i++) {
                    combination[i] = first[i];
                }
        
                for (uint j = 0; j < second.length; j++) {
                    combination[first.length + j] = second[j];
                }
            }
        
            /* ========== PUBLIC FUNCTIONS ========== */
        
            // Note: this function is public not external in order for it to be overridden and invoked via super in subclasses
            function resolverAddressesRequired() public view returns (bytes32[] memory addresses) {}
        
            function rebuildCache() public {
                bytes32[] memory requiredAddresses = resolverAddressesRequired();
                // The resolver must call this function whenver it updates its state
                for (uint i = 0; i < requiredAddresses.length; i++) {
                    bytes32 name = requiredAddresses[i];
                    // Note: can only be invoked once the resolver has all the targets needed added
                    address destination = resolver.requireAndGetAddress(
                        name,
                        string(abi.encodePacked("Resolver missing target: ", name))
                    );
                    addressCache[name] = destination;
                    emit CacheUpdated(name, destination);
                }
            }
        
            /* ========== VIEWS ========== */
        
            function isResolverCached() external view returns (bool) {
                bytes32[] memory requiredAddresses = resolverAddressesRequired();
                for (uint i = 0; i < requiredAddresses.length; i++) {
                    bytes32 name = requiredAddresses[i];
                    // false if our cache is invalid or if the resolver doesn't have the required address
                    if (resolver.getAddress(name) != addressCache[name] || addressCache[name] == address(0)) {
                        return false;
                    }
                }
        
                return true;
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function requireAndGetAddress(bytes32 name) internal view returns (address) {
                address _foundAddress = addressCache[name];
                require(_foundAddress != address(0), string(abi.encodePacked("Missing address: ", name)));
                return _foundAddress;
            }
        
            /* ========== EVENTS ========== */
        
            event CacheUpdated(bytes32 name, address destination);
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iflexiblestorage
        interface IFlexibleStorage {
            // Views
            function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint);
        
            function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory);
        
            function getIntValue(bytes32 contractName, bytes32 record) external view returns (int);
        
            function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory);
        
            function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address);
        
            function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory);
        
            function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool);
        
            function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory);
        
            function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32);
        
            function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory);
        
            // Mutative functions
            function deleteUIntValue(bytes32 contractName, bytes32 record) external;
        
            function deleteIntValue(bytes32 contractName, bytes32 record) external;
        
            function deleteAddressValue(bytes32 contractName, bytes32 record) external;
        
            function deleteBoolValue(bytes32 contractName, bytes32 record) external;
        
            function deleteBytes32Value(bytes32 contractName, bytes32 record) external;
        
            function setUIntValue(
                bytes32 contractName,
                bytes32 record,
                uint value
            ) external;
        
            function setUIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                uint[] calldata values
            ) external;
        
            function setIntValue(
                bytes32 contractName,
                bytes32 record,
                int value
            ) external;
        
            function setIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                int[] calldata values
            ) external;
        
            function setAddressValue(
                bytes32 contractName,
                bytes32 record,
                address value
            ) external;
        
            function setAddressValues(
                bytes32 contractName,
                bytes32[] calldata records,
                address[] calldata values
            ) external;
        
            function setBoolValue(
                bytes32 contractName,
                bytes32 record,
                bool value
            ) external;
        
            function setBoolValues(
                bytes32 contractName,
                bytes32[] calldata records,
                bool[] calldata values
            ) external;
        
            function setBytes32Value(
                bytes32 contractName,
                bytes32 record,
                bytes32 value
            ) external;
        
            function setBytes32Values(
                bytes32 contractName,
                bytes32[] calldata records,
                bytes32[] calldata values
            ) external;
        }
        
        
        // Internal references
        
        
        // https://docs.synthetix.io/contracts/source/contracts/mixinsystemsettings
        contract MixinSystemSettings is MixinResolver {
            bytes32 internal constant SETTING_CONTRACT_NAME = "SystemSettings";
        
            bytes32 internal constant SETTING_WAITING_PERIOD_SECS = "waitingPeriodSecs";
            bytes32 internal constant SETTING_PRICE_DEVIATION_THRESHOLD_FACTOR = "priceDeviationThresholdFactor";
            bytes32 internal constant SETTING_ISSUANCE_RATIO = "issuanceRatio";
            bytes32 internal constant SETTING_FEE_PERIOD_DURATION = "feePeriodDuration";
            bytes32 internal constant SETTING_TARGET_THRESHOLD = "targetThreshold";
            bytes32 internal constant SETTING_LIQUIDATION_DELAY = "liquidationDelay";
            bytes32 internal constant SETTING_LIQUIDATION_RATIO = "liquidationRatio";
            bytes32 internal constant SETTING_LIQUIDATION_PENALTY = "liquidationPenalty";
            bytes32 internal constant SETTING_RATE_STALE_PERIOD = "rateStalePeriod";
            bytes32 internal constant SETTING_EXCHANGE_FEE_RATE = "exchangeFeeRate";
            bytes32 internal constant SETTING_MINIMUM_STAKE_TIME = "minimumStakeTime";
            bytes32 internal constant SETTING_AGGREGATOR_WARNING_FLAGS = "aggregatorWarningFlags";
            bytes32 internal constant SETTING_TRADING_REWARDS_ENABLED = "tradingRewardsEnabled";
            bytes32 internal constant SETTING_DEBT_SNAPSHOT_STALE_TIME = "debtSnapshotStaleTime";
            bytes32 internal constant SETTING_CROSS_DOMAIN_MESSAGE_GAS_LIMIT = "crossDomainMessageGasLimit";
        
            bytes32 internal constant CONTRACT_FLEXIBLESTORAGE = "FlexibleStorage";
        
            constructor(address _resolver) internal MixinResolver(_resolver) {}
        
            function resolverAddressesRequired() public view returns (bytes32[] memory addresses) {
                addresses = new bytes32[](1);
                addresses[0] = CONTRACT_FLEXIBLESTORAGE;
            }
        
            function flexibleStorage() internal view returns (IFlexibleStorage) {
                return IFlexibleStorage(requireAndGetAddress(CONTRACT_FLEXIBLESTORAGE));
            }
        
            function getCrossDomainMessageGasLimit() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_CROSS_DOMAIN_MESSAGE_GAS_LIMIT);
            }
        
            function getTradingRewardsEnabled() internal view returns (bool) {
                return flexibleStorage().getBoolValue(SETTING_CONTRACT_NAME, SETTING_TRADING_REWARDS_ENABLED);
            }
        
            function getWaitingPeriodSecs() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_WAITING_PERIOD_SECS);
            }
        
            function getPriceDeviationThresholdFactor() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_PRICE_DEVIATION_THRESHOLD_FACTOR);
            }
        
            function getIssuanceRatio() internal view returns (uint) {
                // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_ISSUANCE_RATIO);
            }
        
            function getFeePeriodDuration() internal view returns (uint) {
                // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_FEE_PERIOD_DURATION);
            }
        
            function getTargetThreshold() internal view returns (uint) {
                // lookup on flexible storage directly for gas savings (rather than via SystemSettings)
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_TARGET_THRESHOLD);
            }
        
            function getLiquidationDelay() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_DELAY);
            }
        
            function getLiquidationRatio() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_RATIO);
            }
        
            function getLiquidationPenalty() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_LIQUIDATION_PENALTY);
            }
        
            function getRateStalePeriod() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_RATE_STALE_PERIOD);
            }
        
            function getExchangeFeeRate(bytes32 currencyKey) internal view returns (uint) {
                return
                    flexibleStorage().getUIntValue(
                        SETTING_CONTRACT_NAME,
                        keccak256(abi.encodePacked(SETTING_EXCHANGE_FEE_RATE, currencyKey))
                    );
            }
        
            function getMinimumStakeTime() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_MINIMUM_STAKE_TIME);
            }
        
            function getAggregatorWarningFlags() internal view returns (address) {
                return flexibleStorage().getAddressValue(SETTING_CONTRACT_NAME, SETTING_AGGREGATOR_WARNING_FLAGS);
            }
        
            function getDebtSnapshotStaleTime() internal view returns (uint) {
                return flexibleStorage().getUIntValue(SETTING_CONTRACT_NAME, SETTING_DEBT_SNAPSHOT_STALE_TIME);
            }
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iexchangerates
        interface IExchangeRates {
            // Structs
            struct RateAndUpdatedTime {
                uint216 rate;
                uint40 time;
            }
        
            struct InversePricing {
                uint entryPoint;
                uint upperLimit;
                uint lowerLimit;
                bool frozenAtUpperLimit;
                bool frozenAtLowerLimit;
            }
        
            // Views
            function aggregators(bytes32 currencyKey) external view returns (address);
        
            function aggregatorWarningFlags() external view returns (address);
        
            function anyRateIsInvalid(bytes32[] calldata currencyKeys) external view returns (bool);
        
            function canFreezeRate(bytes32 currencyKey) external view returns (bool);
        
            function currentRoundForRate(bytes32 currencyKey) external view returns (uint);
        
            function currenciesUsingAggregator(address aggregator) external view returns (bytes32[] memory);
        
            function effectiveValue(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            ) external view returns (uint value);
        
            function effectiveValueAndRates(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            )
                external
                view
                returns (
                    uint value,
                    uint sourceRate,
                    uint destinationRate
                );
        
            function effectiveValueAtRound(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                uint roundIdForSrc,
                uint roundIdForDest
            ) external view returns (uint value);
        
            function getCurrentRoundId(bytes32 currencyKey) external view returns (uint);
        
            function getLastRoundIdBeforeElapsedSecs(
                bytes32 currencyKey,
                uint startingRoundId,
                uint startingTimestamp,
                uint timediff
            ) external view returns (uint);
        
            function inversePricing(bytes32 currencyKey)
                external
                view
                returns (
                    uint entryPoint,
                    uint upperLimit,
                    uint lowerLimit,
                    bool frozenAtUpperLimit,
                    bool frozenAtLowerLimit
                );
        
            function lastRateUpdateTimes(bytes32 currencyKey) external view returns (uint256);
        
            function oracle() external view returns (address);
        
            function rateAndTimestampAtRound(bytes32 currencyKey, uint roundId) external view returns (uint rate, uint time);
        
            function rateAndUpdatedTime(bytes32 currencyKey) external view returns (uint rate, uint time);
        
            function rateAndInvalid(bytes32 currencyKey) external view returns (uint rate, bool isInvalid);
        
            function rateForCurrency(bytes32 currencyKey) external view returns (uint);
        
            function rateIsFlagged(bytes32 currencyKey) external view returns (bool);
        
            function rateIsFrozen(bytes32 currencyKey) external view returns (bool);
        
            function rateIsInvalid(bytes32 currencyKey) external view returns (bool);
        
            function rateIsStale(bytes32 currencyKey) external view returns (bool);
        
            function rateStalePeriod() external view returns (uint);
        
            function ratesAndUpdatedTimeForCurrencyLastNRounds(bytes32 currencyKey, uint numRounds)
                external
                view
                returns (uint[] memory rates, uint[] memory times);
        
            function ratesAndInvalidForCurrencies(bytes32[] calldata currencyKeys)
                external
                view
                returns (uint[] memory rates, bool anyRateInvalid);
        
            function ratesForCurrencies(bytes32[] calldata currencyKeys) external view returns (uint[] memory);
        
            // Mutative functions
            function freezeRate(bytes32 currencyKey) external;
        }
        
        
        /**
         * @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, 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");
                uint256 c = a - b;
        
                return c;
            }
        
            /**
             * @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) {
                // 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-solidity/pull/522
                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. Reverts 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) {
                // Solidity only automatically asserts when dividing by 0
                require(b > 0, "SafeMath: division by zero");
                uint256 c = a / b;
                // assert(a == b * c + a % b); // There is no case in which this doesn't hold
        
                return c;
            }
        
            /**
             * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
             * Reverts 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;
            }
        }
        
        
        // Libraries
        
        
        // https://docs.synthetix.io/contracts/source/libraries/safedecimalmath
        library SafeDecimalMath {
            using SafeMath for uint;
        
            /* Number of decimal places in the representations. */
            uint8 public constant decimals = 18;
            uint8 public constant highPrecisionDecimals = 27;
        
            /* The number representing 1.0. */
            uint public constant UNIT = 10**uint(decimals);
        
            /* The number representing 1.0 for higher fidelity numbers. */
            uint public constant PRECISE_UNIT = 10**uint(highPrecisionDecimals);
            uint private constant UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR = 10**uint(highPrecisionDecimals - decimals);
        
            /**
             * @return Provides an interface to UNIT.
             */
            function unit() external pure returns (uint) {
                return UNIT;
            }
        
            /**
             * @return Provides an interface to PRECISE_UNIT.
             */
            function preciseUnit() external pure returns (uint) {
                return PRECISE_UNIT;
            }
        
            /**
             * @return The result of multiplying x and y, interpreting the operands as fixed-point
             * decimals.
             *
             * @dev A unit factor is divided out after the product of x and y is evaluated,
             * so that product must be less than 2**256. As this is an integer division,
             * the internal division always rounds down. This helps save on gas. Rounding
             * is more expensive on gas.
             */
            function multiplyDecimal(uint x, uint y) internal pure returns (uint) {
                /* Divide by UNIT to remove the extra factor introduced by the product. */
                return x.mul(y) / UNIT;
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of the specified precision unit.
             *
             * @dev The operands should be in the form of a the specified unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function _multiplyDecimalRound(
                uint x,
                uint y,
                uint precisionUnit
            ) private pure returns (uint) {
                /* Divide by UNIT to remove the extra factor introduced by the product. */
                uint quotientTimesTen = x.mul(y) / (precisionUnit / 10);
        
                if (quotientTimesTen % 10 >= 5) {
                    quotientTimesTen += 10;
                }
        
                return quotientTimesTen / 10;
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of a precise unit.
             *
             * @dev The operands should be in the precise unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function multiplyDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                return _multiplyDecimalRound(x, y, PRECISE_UNIT);
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of a standard unit.
             *
             * @dev The operands should be in the standard unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function multiplyDecimalRound(uint x, uint y) internal pure returns (uint) {
                return _multiplyDecimalRound(x, y, UNIT);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is a high
             * precision decimal.
             *
             * @dev y is divided after the product of x and the standard precision unit
             * is evaluated, so the product of x and UNIT must be less than 2**256. As
             * this is an integer division, the result is always rounded down.
             * This helps save on gas. Rounding is more expensive on gas.
             */
            function divideDecimal(uint x, uint y) internal pure returns (uint) {
                /* Reintroduce the UNIT factor that will be divided out by y. */
                return x.mul(UNIT).div(y);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * decimal in the precision unit specified in the parameter.
             *
             * @dev y is divided after the product of x and the specified precision unit
             * is evaluated, so the product of x and the specified precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function _divideDecimalRound(
                uint x,
                uint y,
                uint precisionUnit
            ) private pure returns (uint) {
                uint resultTimesTen = x.mul(precisionUnit * 10).div(y);
        
                if (resultTimesTen % 10 >= 5) {
                    resultTimesTen += 10;
                }
        
                return resultTimesTen / 10;
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * standard precision decimal.
             *
             * @dev y is divided after the product of x and the standard precision unit
             * is evaluated, so the product of x and the standard precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function divideDecimalRound(uint x, uint y) internal pure returns (uint) {
                return _divideDecimalRound(x, y, UNIT);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * high precision decimal.
             *
             * @dev y is divided after the product of x and the high precision unit
             * is evaluated, so the product of x and the high precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function divideDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                return _divideDecimalRound(x, y, PRECISE_UNIT);
            }
        
            /**
             * @dev Convert a standard decimal representation to a high precision one.
             */
            function decimalToPreciseDecimal(uint i) internal pure returns (uint) {
                return i.mul(UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR);
            }
        
            /**
             * @dev Convert a high precision decimal to a standard decimal representation.
             */
            function preciseDecimalToDecimal(uint i) internal pure returns (uint) {
                uint quotientTimesTen = i / (UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR / 10);
        
                if (quotientTimesTen % 10 >= 5) {
                    quotientTimesTen += 10;
                }
        
                return quotientTimesTen / 10;
            }
        }
        
        
        interface AggregatorInterface {
          function latestAnswer() external view returns (int256);
          function latestTimestamp() external view returns (uint256);
          function latestRound() external view returns (uint256);
          function getAnswer(uint256 roundId) external view returns (int256);
          function getTimestamp(uint256 roundId) external view returns (uint256);
        
          event AnswerUpdated(int256 indexed current, uint256 indexed roundId, uint256 timestamp);
          event NewRound(uint256 indexed roundId, address indexed startedBy, uint256 startedAt);
        }
        
        
        interface AggregatorV3Interface {
        
          function decimals() external view returns (uint8);
          function description() external view returns (string memory);
          function version() external view returns (uint256);
        
          // getRoundData and latestRoundData should both raise "No data present"
          // if they do not have data to report, instead of returning unset values
          // which could be misinterpreted as actual reported values.
          function getRoundData(uint80 _roundId)
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
          function latestRoundData()
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
        
        }
        
        
        /**
         * @title The V2 & V3 Aggregator Interface
         * @notice Solidity V0.5 does not allow interfaces to inherit from other
         * interfaces so this contract is a combination of v0.5 AggregatorInterface.sol
         * and v0.5 AggregatorV3Interface.sol.
         */
        interface AggregatorV2V3Interface {
          //
          // V2 Interface:
          //
          function latestAnswer() external view returns (int256);
          function latestTimestamp() external view returns (uint256);
          function latestRound() external view returns (uint256);
          function getAnswer(uint256 roundId) external view returns (int256);
          function getTimestamp(uint256 roundId) external view returns (uint256);
        
          event AnswerUpdated(int256 indexed current, uint256 indexed roundId, uint256 timestamp);
          event NewRound(uint256 indexed roundId, address indexed startedBy, uint256 startedAt);
        
          //
          // V3 Interface:
          //
          function decimals() external view returns (uint8);
          function description() external view returns (string memory);
          function version() external view returns (uint256);
        
          // getRoundData and latestRoundData should both raise "No data present"
          // if they do not have data to report, instead of returning unset values
          // which could be misinterpreted as actual reported values.
          function getRoundData(uint80 _roundId)
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
          function latestRoundData()
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
        
        }
        
        
        interface FlagsInterface {
          function getFlag(address) external view returns (bool);
          function getFlags(address[] calldata) external view returns (bool[] memory);
          function raiseFlag(address) external;
          function raiseFlags(address[] calldata) external;
          function lowerFlags(address[] calldata) external;
          function setRaisingAccessController(address) external;
        }
        
        
        interface IVirtualSynth {
            // Views
            function balanceOfUnderlying(address account) external view returns (uint);
        
            function rate() external view returns (uint);
        
            function readyToSettle() external view returns (bool);
        
            function secsLeftInWaitingPeriod() external view returns (uint);
        
            function settled() external view returns (bool);
        
            function synth() external view returns (ISynth);
        
            // Mutative functions
            function settle(address account) external;
        }
        
        
        // https://docs.synthetix.io/contracts/source/interfaces/iexchanger
        interface IExchanger {
            // Views
            function calculateAmountAfterSettlement(
                address from,
                bytes32 currencyKey,
                uint amount,
                uint refunded
            ) external view returns (uint amountAfterSettlement);
        
            function isSynthRateInvalid(bytes32 currencyKey) external view returns (bool);
        
            function maxSecsLeftInWaitingPeriod(address account, bytes32 currencyKey) external view returns (uint);
        
            function settlementOwing(address account, bytes32 currencyKey)
                external
                view
                returns (
                    uint reclaimAmount,
                    uint rebateAmount,
                    uint numEntries
                );
        
            function hasWaitingPeriodOrSettlementOwing(address account, bytes32 currencyKey) external view returns (bool);
        
            function feeRateForExchange(bytes32 sourceCurrencyKey, bytes32 destinationCurrencyKey)
                external
                view
                returns (uint exchangeFeeRate);
        
            function getAmountsForExchange(
                uint sourceAmount,
                bytes32 sourceCurrencyKey,
                bytes32 destinationCurrencyKey
            )
                external
                view
                returns (
                    uint amountReceived,
                    uint fee,
                    uint exchangeFeeRate
                );
        
            function priceDeviationThresholdFactor() external view returns (uint);
        
            function waitingPeriodSecs() external view returns (uint);
        
            // Mutative functions
            function exchange(
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address destinationAddress
            ) external returns (uint amountReceived);
        
            function exchangeOnBehalf(
                address exchangeForAddress,
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            ) external returns (uint amountReceived);
        
            function exchangeWithTracking(
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address destinationAddress,
                address originator,
                bytes32 trackingCode
            ) external returns (uint amountReceived);
        
            function exchangeOnBehalfWithTracking(
                address exchangeForAddress,
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address originator,
                bytes32 trackingCode
            ) external returns (uint amountReceived);
        
            function exchangeWithVirtual(
                address from,
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                address destinationAddress,
                bytes32 trackingCode
            ) external returns (uint amountReceived, IVirtualSynth vSynth);
        
            function settle(address from, bytes32 currencyKey)
                external
                returns (
                    uint reclaimed,
                    uint refunded,
                    uint numEntries
                );
        
            function setLastExchangeRateForSynth(bytes32 currencyKey, uint rate) external;
        
            function suspendSynthWithInvalidRate(bytes32 currencyKey) external;
        }
        
        
        // Inheritance
        
        
        // Libraries
        
        
        // Internal references
        // AggregatorInterface from Chainlink represents a decentralized pricing network for a single currency key
        
        // FlagsInterface from Chainlink addresses SIP-76
        
        
        // https://docs.synthetix.io/contracts/source/contracts/exchangerates
        contract ExchangeRates is Owned, MixinSystemSettings, IExchangeRates {
            using SafeMath for uint;
            using SafeDecimalMath for uint;
        
            // Exchange rates and update times stored by currency code, e.g. 'SNX', or 'sUSD'
            mapping(bytes32 => mapping(uint => RateAndUpdatedTime)) private _rates;
        
            // The address of the oracle which pushes rate updates to this contract
            address public oracle;
        
            // Decentralized oracle networks that feed into pricing aggregators
            mapping(bytes32 => AggregatorV2V3Interface) public aggregators;
        
            mapping(bytes32 => uint8) public currencyKeyDecimals;
        
            // List of aggregator keys for convenient iteration
            bytes32[] public aggregatorKeys;
        
            // Do not allow the oracle to submit times any further forward into the future than this constant.
            uint private constant ORACLE_FUTURE_LIMIT = 10 minutes;
        
            mapping(bytes32 => InversePricing) public inversePricing;
        
            bytes32[] public invertedKeys;
        
            mapping(bytes32 => uint) public currentRoundForRate;
        
            mapping(bytes32 => uint) public roundFrozen;
        
            /* ========== ADDRESS RESOLVER CONFIGURATION ========== */
            bytes32 private constant CONTRACT_EXCHANGER = "Exchanger";
        
            //
            // ========== CONSTRUCTOR ==========
        
            constructor(
                address _owner,
                address _oracle,
                address _resolver,
                bytes32[] memory _currencyKeys,
                uint[] memory _newRates
            ) public Owned(_owner) MixinSystemSettings(_resolver) {
                require(_currencyKeys.length == _newRates.length, "Currency key length and rate length must match.");
        
                oracle = _oracle;
        
                // The sUSD rate is always 1 and is never stale.
                _setRate("sUSD", SafeDecimalMath.unit(), now);
        
                internalUpdateRates(_currencyKeys, _newRates, now);
            }
        
            /* ========== SETTERS ========== */
        
            function setOracle(address _oracle) external onlyOwner {
                oracle = _oracle;
                emit OracleUpdated(oracle);
            }
        
            /* ========== MUTATIVE FUNCTIONS ========== */
        
            function updateRates(
                bytes32[] calldata currencyKeys,
                uint[] calldata newRates,
                uint timeSent
            ) external onlyOracle returns (bool) {
                return internalUpdateRates(currencyKeys, newRates, timeSent);
            }
        
            function deleteRate(bytes32 currencyKey) external onlyOracle {
                require(_getRate(currencyKey) > 0, "Rate is zero");
        
                delete _rates[currencyKey][currentRoundForRate[currencyKey]];
        
                currentRoundForRate[currencyKey]--;
        
                emit RateDeleted(currencyKey);
            }
        
            function setInversePricing(
                bytes32 currencyKey,
                uint entryPoint,
                uint upperLimit,
                uint lowerLimit,
                bool freezeAtUpperLimit,
                bool freezeAtLowerLimit
            ) external onlyOwner {
                // 0 < lowerLimit < entryPoint => 0 < entryPoint
                require(lowerLimit > 0, "lowerLimit must be above 0");
                require(upperLimit > entryPoint, "upperLimit must be above the entryPoint");
                require(upperLimit < entryPoint.mul(2), "upperLimit must be less than double entryPoint");
                require(lowerLimit < entryPoint, "lowerLimit must be below the entryPoint");
        
                require(!(freezeAtUpperLimit && freezeAtLowerLimit), "Cannot freeze at both limits");
        
                InversePricing storage inverse = inversePricing[currencyKey];
                if (inverse.entryPoint == 0) {
                    // then we are adding a new inverse pricing, so add this
                    invertedKeys.push(currencyKey);
                }
                inverse.entryPoint = entryPoint;
                inverse.upperLimit = upperLimit;
                inverse.lowerLimit = lowerLimit;
        
                if (freezeAtUpperLimit || freezeAtLowerLimit) {
                    // When indicating to freeze, we need to know the rate to freeze it at - either upper or lower
                    // this is useful in situations where ExchangeRates is updated and there are existing inverted
                    // rates already frozen in the current contract that need persisting across the upgrade
        
                    inverse.frozenAtUpperLimit = freezeAtUpperLimit;
                    inverse.frozenAtLowerLimit = freezeAtLowerLimit;
                    uint roundId = _getCurrentRoundId(currencyKey);
                    roundFrozen[currencyKey] = roundId;
                    emit InversePriceFrozen(currencyKey, freezeAtUpperLimit ? upperLimit : lowerLimit, roundId, msg.sender);
                } else {
                    // unfreeze if need be
                    inverse.frozenAtUpperLimit = false;
                    inverse.frozenAtLowerLimit = false;
                    // remove any tracking
                    roundFrozen[currencyKey] = 0;
                }
        
                // SIP-78
                uint rate = _getRate(currencyKey);
                if (rate > 0) {
                    exchanger().setLastExchangeRateForSynth(currencyKey, rate);
                }
        
                emit InversePriceConfigured(currencyKey, entryPoint, upperLimit, lowerLimit);
            }
        
            function removeInversePricing(bytes32 currencyKey) external onlyOwner {
                require(inversePricing[currencyKey].entryPoint > 0, "No inverted price exists");
        
                delete inversePricing[currencyKey];
        
                // now remove inverted key from array
                bool wasRemoved = removeFromArray(currencyKey, invertedKeys);
        
                if (wasRemoved) {
                    emit InversePriceConfigured(currencyKey, 0, 0, 0);
                }
            }
        
            function addAggregator(bytes32 currencyKey, address aggregatorAddress) external onlyOwner {
                AggregatorV2V3Interface aggregator = AggregatorV2V3Interface(aggregatorAddress);
                // This check tries to make sure that a valid aggregator is being added.
                // It checks if the aggregator is an existing smart contract that has implemented `latestTimestamp` function.
        
                require(aggregator.latestRound() >= 0, "Given Aggregator is invalid");
                uint8 decimals = aggregator.decimals();
                require(decimals <= 18, "Aggregator decimals should be lower or equal to 18");
                if (address(aggregators[currencyKey]) == address(0)) {
                    aggregatorKeys.push(currencyKey);
                }
                aggregators[currencyKey] = aggregator;
                currencyKeyDecimals[currencyKey] = decimals;
                emit AggregatorAdded(currencyKey, address(aggregator));
            }
        
            function removeAggregator(bytes32 currencyKey) external onlyOwner {
                address aggregator = address(aggregators[currencyKey]);
                require(aggregator != address(0), "No aggregator exists for key");
                delete aggregators[currencyKey];
                delete currencyKeyDecimals[currencyKey];
        
                bool wasRemoved = removeFromArray(currencyKey, aggregatorKeys);
        
                if (wasRemoved) {
                    emit AggregatorRemoved(currencyKey, aggregator);
                }
            }
        
            // SIP-75 Public keeper function to freeze a synth that is out of bounds
            function freezeRate(bytes32 currencyKey) external {
                InversePricing storage inverse = inversePricing[currencyKey];
                require(inverse.entryPoint > 0, "Cannot freeze non-inverse rate");
                require(!inverse.frozenAtUpperLimit && !inverse.frozenAtLowerLimit, "The rate is already frozen");
        
                uint rate = _getRate(currencyKey);
        
                if (rate > 0 && (rate >= inverse.upperLimit || rate <= inverse.lowerLimit)) {
                    inverse.frozenAtUpperLimit = (rate == inverse.upperLimit);
                    inverse.frozenAtLowerLimit = (rate == inverse.lowerLimit);
                    uint currentRoundId = _getCurrentRoundId(currencyKey);
                    roundFrozen[currencyKey] = currentRoundId;
                    emit InversePriceFrozen(currencyKey, rate, currentRoundId, msg.sender);
                } else {
                    revert("Rate within bounds");
                }
            }
        
            /* ========== VIEWS ========== */
        
            function resolverAddressesRequired() public view returns (bytes32[] memory addresses) {
                bytes32[] memory existingAddresses = MixinSystemSettings.resolverAddressesRequired();
                bytes32[] memory newAddresses = new bytes32[](1);
                newAddresses[0] = CONTRACT_EXCHANGER;
                addresses = combineArrays(existingAddresses, newAddresses);
            }
        
            // SIP-75 View to determine if freezeRate can be called safely
            function canFreezeRate(bytes32 currencyKey) external view returns (bool) {
                InversePricing memory inverse = inversePricing[currencyKey];
                if (inverse.entryPoint == 0 || inverse.frozenAtUpperLimit || inverse.frozenAtLowerLimit) {
                    return false;
                } else {
                    uint rate = _getRate(currencyKey);
                    return (rate > 0 && (rate >= inverse.upperLimit || rate <= inverse.lowerLimit));
                }
            }
        
            function currenciesUsingAggregator(address aggregator) external view returns (bytes32[] memory currencies) {
                uint count = 0;
                currencies = new bytes32[](aggregatorKeys.length);
                for (uint i = 0; i < aggregatorKeys.length; i++) {
                    bytes32 currencyKey = aggregatorKeys[i];
                    if (address(aggregators[currencyKey]) == aggregator) {
                        currencies[count++] = currencyKey;
                    }
                }
            }
        
            function rateStalePeriod() external view returns (uint) {
                return getRateStalePeriod();
            }
        
            function aggregatorWarningFlags() external view returns (address) {
                return getAggregatorWarningFlags();
            }
        
            function rateAndUpdatedTime(bytes32 currencyKey) external view returns (uint rate, uint time) {
                RateAndUpdatedTime memory rateAndTime = _getRateAndUpdatedTime(currencyKey);
                return (rateAndTime.rate, rateAndTime.time);
            }
        
            function getLastRoundIdBeforeElapsedSecs(
                bytes32 currencyKey,
                uint startingRoundId,
                uint startingTimestamp,
                uint timediff
            ) external view returns (uint) {
                uint roundId = startingRoundId;
                uint nextTimestamp = 0;
                while (true) {
                    (, nextTimestamp) = _getRateAndTimestampAtRound(currencyKey, roundId + 1);
                    // if there's no new round, then the previous roundId was the latest
                    if (nextTimestamp == 0 || nextTimestamp > startingTimestamp + timediff) {
                        return roundId;
                    }
                    roundId++;
                }
                return roundId;
            }
        
            function getCurrentRoundId(bytes32 currencyKey) external view returns (uint) {
                return _getCurrentRoundId(currencyKey);
            }
        
            function effectiveValueAtRound(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey,
                uint roundIdForSrc,
                uint roundIdForDest
            ) external view returns (uint value) {
                // If there's no change in the currency, then just return the amount they gave us
                if (sourceCurrencyKey == destinationCurrencyKey) return sourceAmount;
        
                (uint srcRate, ) = _getRateAndTimestampAtRound(sourceCurrencyKey, roundIdForSrc);
                (uint destRate, ) = _getRateAndTimestampAtRound(destinationCurrencyKey, roundIdForDest);
                if (destRate == 0) {
                    // prevent divide-by 0 error (this can happen when roundIDs jump epochs due
                    // to aggregator upgrades)
                    return 0;
                }
                // Calculate the effective value by going from source -> USD -> destination
                value = sourceAmount.multiplyDecimalRound(srcRate).divideDecimalRound(destRate);
            }
        
            function rateAndTimestampAtRound(bytes32 currencyKey, uint roundId) external view returns (uint rate, uint time) {
                return _getRateAndTimestampAtRound(currencyKey, roundId);
            }
        
            function lastRateUpdateTimes(bytes32 currencyKey) external view returns (uint256) {
                return _getUpdatedTime(currencyKey);
            }
        
            function lastRateUpdateTimesForCurrencies(bytes32[] calldata currencyKeys) external view returns (uint[] memory) {
                uint[] memory lastUpdateTimes = new uint[](currencyKeys.length);
        
                for (uint i = 0; i < currencyKeys.length; i++) {
                    lastUpdateTimes[i] = _getUpdatedTime(currencyKeys[i]);
                }
        
                return lastUpdateTimes;
            }
        
            function effectiveValue(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            ) external view returns (uint value) {
                (value, , ) = _effectiveValueAndRates(sourceCurrencyKey, sourceAmount, destinationCurrencyKey);
            }
        
            function effectiveValueAndRates(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            )
                external
                view
                returns (
                    uint value,
                    uint sourceRate,
                    uint destinationRate
                )
            {
                return _effectiveValueAndRates(sourceCurrencyKey, sourceAmount, destinationCurrencyKey);
            }
        
            function rateForCurrency(bytes32 currencyKey) external view returns (uint) {
                return _getRateAndUpdatedTime(currencyKey).rate;
            }
        
            function ratesAndUpdatedTimeForCurrencyLastNRounds(bytes32 currencyKey, uint numRounds)
                external
                view
                returns (uint[] memory rates, uint[] memory times)
            {
                rates = new uint[](numRounds);
                times = new uint[](numRounds);
        
                uint roundId = _getCurrentRoundId(currencyKey);
                for (uint i = 0; i < numRounds; i++) {
                    // fetch the rate and treat is as current, so inverse limits if frozen will always be applied
                    // regardless of current rate
                    (rates[i], times[i]) = _getRateAndTimestampAtRound(currencyKey, roundId);
        
                    if (roundId == 0) {
                        // if we hit the last round, then return what we have
                        return (rates, times);
                    } else {
                        roundId--;
                    }
                }
            }
        
            function ratesForCurrencies(bytes32[] calldata currencyKeys) external view returns (uint[] memory) {
                uint[] memory _localRates = new uint[](currencyKeys.length);
        
                for (uint i = 0; i < currencyKeys.length; i++) {
                    _localRates[i] = _getRate(currencyKeys[i]);
                }
        
                return _localRates;
            }
        
            function rateAndInvalid(bytes32 currencyKey) external view returns (uint rate, bool isInvalid) {
                RateAndUpdatedTime memory rateAndTime = _getRateAndUpdatedTime(currencyKey);
        
                if (currencyKey == "sUSD") {
                    return (rateAndTime.rate, false);
                }
                return (
                    rateAndTime.rate,
                    _rateIsStaleWithTime(getRateStalePeriod(), rateAndTime.time) ||
                        _rateIsFlagged(currencyKey, FlagsInterface(getAggregatorWarningFlags()))
                );
            }
        
            function ratesAndInvalidForCurrencies(bytes32[] calldata currencyKeys)
                external
                view
                returns (uint[] memory rates, bool anyRateInvalid)
            {
                rates = new uint[](currencyKeys.length);
        
                uint256 _rateStalePeriod = getRateStalePeriod();
        
                // fetch all flags at once
                bool[] memory flagList = getFlagsForRates(currencyKeys);
        
                for (uint i = 0; i < currencyKeys.length; i++) {
                    // do one lookup of the rate & time to minimize gas
                    RateAndUpdatedTime memory rateEntry = _getRateAndUpdatedTime(currencyKeys[i]);
                    rates[i] = rateEntry.rate;
                    if (!anyRateInvalid && currencyKeys[i] != "sUSD") {
                        anyRateInvalid = flagList[i] || _rateIsStaleWithTime(_rateStalePeriod, rateEntry.time);
                    }
                }
            }
        
            function rateIsStale(bytes32 currencyKey) external view returns (bool) {
                return _rateIsStale(currencyKey, getRateStalePeriod());
            }
        
            function rateIsFrozen(bytes32 currencyKey) external view returns (bool) {
                return _rateIsFrozen(currencyKey);
            }
        
            function rateIsInvalid(bytes32 currencyKey) external view returns (bool) {
                return
                    _rateIsStale(currencyKey, getRateStalePeriod()) ||
                    _rateIsFlagged(currencyKey, FlagsInterface(getAggregatorWarningFlags()));
            }
        
            function rateIsFlagged(bytes32 currencyKey) external view returns (bool) {
                return _rateIsFlagged(currencyKey, FlagsInterface(getAggregatorWarningFlags()));
            }
        
            function anyRateIsInvalid(bytes32[] calldata currencyKeys) external view returns (bool) {
                // Loop through each key and check whether the data point is stale.
        
                uint256 _rateStalePeriod = getRateStalePeriod();
                bool[] memory flagList = getFlagsForRates(currencyKeys);
        
                for (uint i = 0; i < currencyKeys.length; i++) {
                    if (flagList[i] || _rateIsStale(currencyKeys[i], _rateStalePeriod)) {
                        return true;
                    }
                }
        
                return false;
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function exchanger() internal view returns (IExchanger) {
                return IExchanger(requireAndGetAddress(CONTRACT_EXCHANGER));
            }
        
            function getFlagsForRates(bytes32[] memory currencyKeys) internal view returns (bool[] memory flagList) {
                FlagsInterface _flags = FlagsInterface(getAggregatorWarningFlags());
        
                // fetch all flags at once
                if (_flags != FlagsInterface(0)) {
                    address[] memory _aggregators = new address[](currencyKeys.length);
        
                    for (uint i = 0; i < currencyKeys.length; i++) {
                        _aggregators[i] = address(aggregators[currencyKeys[i]]);
                    }
        
                    flagList = _flags.getFlags(_aggregators);
                } else {
                    flagList = new bool[](currencyKeys.length);
                }
            }
        
            function _setRate(
                bytes32 currencyKey,
                uint256 rate,
                uint256 time
            ) internal {
                // Note: this will effectively start the rounds at 1, which matches Chainlink's Agggregators
                currentRoundForRate[currencyKey]++;
        
                _rates[currencyKey][currentRoundForRate[currencyKey]] = RateAndUpdatedTime({
                    rate: uint216(rate),
                    time: uint40(time)
                });
            }
        
            function internalUpdateRates(
                bytes32[] memory currencyKeys,
                uint[] memory newRates,
                uint timeSent
            ) internal returns (bool) {
                require(currencyKeys.length == newRates.length, "Currency key array length must match rates array length.");
                require(timeSent < (now + ORACLE_FUTURE_LIMIT), "Time is too far into the future");
        
                // Loop through each key and perform update.
                for (uint i = 0; i < currencyKeys.length; i++) {
                    bytes32 currencyKey = currencyKeys[i];
        
                    // Should not set any rate to zero ever, as no asset will ever be
                    // truely worthless and still valid. In this scenario, we should
                    // delete the rate and remove it from the system.
                    require(newRates[i] != 0, "Zero is not a valid rate, please call deleteRate instead.");
                    require(currencyKey != "sUSD", "Rate of sUSD cannot be updated, it's always UNIT.");
        
                    // We should only update the rate if it's at least the same age as the last rate we've got.
                    if (timeSent < _getUpdatedTime(currencyKey)) {
                        continue;
                    }
        
                    // Ok, go ahead with the update.
                    _setRate(currencyKey, newRates[i], timeSent);
                }
        
                emit RatesUpdated(currencyKeys, newRates);
        
                return true;
            }
        
            function removeFromArray(bytes32 entry, bytes32[] storage array) internal returns (bool) {
                for (uint i = 0; i < array.length; i++) {
                    if (array[i] == entry) {
                        delete array[i];
        
                        // Copy the last key into the place of the one we just deleted
                        // If there's only one key, this is array[0] = array[0].
                        // If we're deleting the last one, it's also a NOOP in the same way.
                        array[i] = array[array.length - 1];
        
                        // Decrease the size of the array by one.
                        array.length--;
        
                        return true;
                    }
                }
                return false;
            }
        
            function _rateOrInverted(
                bytes32 currencyKey,
                uint rate,
                uint roundId
            ) internal view returns (uint newRate) {
                // if an inverse mapping exists, adjust the price accordingly
                InversePricing memory inverse = inversePricing[currencyKey];
                if (inverse.entryPoint == 0 || rate == 0) {
                    // when no inverse is set or when given a 0 rate, return the rate, regardless of the inverse status
                    // (the latter is so when a new inverse is set but the underlying has no rate, it will return 0 as
                    // the rate, not the lowerLimit)
                    return rate;
                }
        
                newRate = rate;
        
                // Determine when round was frozen (if any)
                uint roundWhenRateFrozen = roundFrozen[currencyKey];
                // And if we're looking at a rate after frozen, and it's currently frozen, then apply the bounds limit even
                // if the current price is back within bounds
                if (roundId >= roundWhenRateFrozen && inverse.frozenAtUpperLimit) {
                    newRate = inverse.upperLimit;
                } else if (roundId >= roundWhenRateFrozen && inverse.frozenAtLowerLimit) {
                    newRate = inverse.lowerLimit;
                } else {
                    // this ensures any rate outside the limit will never be returned
                    uint doubleEntryPoint = inverse.entryPoint.mul(2);
                    if (doubleEntryPoint <= rate) {
                        // avoid negative numbers for unsigned ints, so set this to 0
                        // which by the requirement that lowerLimit be > 0 will
                        // cause this to freeze the price to the lowerLimit
                        newRate = 0;
                    } else {
                        newRate = doubleEntryPoint.sub(rate);
                    }
        
                    // now ensure the rate is between the bounds
                    if (newRate >= inverse.upperLimit) {
                        newRate = inverse.upperLimit;
                    } else if (newRate <= inverse.lowerLimit) {
                        newRate = inverse.lowerLimit;
                    }
                }
            }
        
            function _formatAggregatorAnswer(bytes32 currencyKey, int256 rate) internal view returns (uint) {
                require(rate >= 0, "Negative rate not supported");
                if (currencyKeyDecimals[currencyKey] > 0) {
                    uint multiplier = 10**uint(SafeMath.sub(18, currencyKeyDecimals[currencyKey]));
                    return uint(uint(rate).mul(multiplier));
                }
                return uint(rate);
            }
        
            function _getRateAndUpdatedTime(bytes32 currencyKey) internal view returns (RateAndUpdatedTime memory) {
                AggregatorV2V3Interface aggregator = aggregators[currencyKey];
        
                if (aggregator != AggregatorV2V3Interface(0)) {
                    // this view from the aggregator is the most gas efficient but it can throw when there's no data,
                    // so let's call it low-level to suppress any reverts
                    bytes memory payload = abi.encodeWithSignature("latestRoundData()");
                    // solhint-disable avoid-low-level-calls
                    (bool success, bytes memory returnData) = address(aggregator).staticcall(payload);
        
                    if (success) {
                        (uint80 roundId, int256 answer, , uint256 updatedAt, ) = abi.decode(
                            returnData,
                            (uint80, int256, uint256, uint256, uint80)
                        );
                        return
                            RateAndUpdatedTime({
                                rate: uint216(_rateOrInverted(currencyKey, _formatAggregatorAnswer(currencyKey, answer), roundId)),
                                time: uint40(updatedAt)
                            });
                    }
                } else {
                    uint roundId = currentRoundForRate[currencyKey];
                    RateAndUpdatedTime memory entry = _rates[currencyKey][roundId];
        
                    return RateAndUpdatedTime({rate: uint216(_rateOrInverted(currencyKey, entry.rate, roundId)), time: entry.time});
                }
            }
        
            function _getCurrentRoundId(bytes32 currencyKey) internal view returns (uint) {
                AggregatorV2V3Interface aggregator = aggregators[currencyKey];
        
                if (aggregator != AggregatorV2V3Interface(0)) {
                    return aggregator.latestRound();
                } else {
                    return currentRoundForRate[currencyKey];
                }
            }
        
            function _getRateAndTimestampAtRound(bytes32 currencyKey, uint roundId) internal view returns (uint rate, uint time) {
                AggregatorV2V3Interface aggregator = aggregators[currencyKey];
        
                if (aggregator != AggregatorV2V3Interface(0)) {
                    // this view from the aggregator is the most gas efficient but it can throw when there's no data,
                    // so let's call it low-level to suppress any reverts
                    bytes memory payload = abi.encodeWithSignature("getRoundData(uint80)", roundId);
                    // solhint-disable avoid-low-level-calls
                    (bool success, bytes memory returnData) = address(aggregator).staticcall(payload);
        
                    if (success) {
                        (, int256 answer, , uint256 updatedAt, ) = abi.decode(
                            returnData,
                            (uint80, int256, uint256, uint256, uint80)
                        );
                        return (_rateOrInverted(currencyKey, _formatAggregatorAnswer(currencyKey, answer), roundId), updatedAt);
                    }
                } else {
                    RateAndUpdatedTime memory update = _rates[currencyKey][roundId];
                    return (_rateOrInverted(currencyKey, update.rate, roundId), update.time);
                }
            }
        
            function _getRate(bytes32 currencyKey) internal view returns (uint256) {
                return _getRateAndUpdatedTime(currencyKey).rate;
            }
        
            function _getUpdatedTime(bytes32 currencyKey) internal view returns (uint256) {
                return _getRateAndUpdatedTime(currencyKey).time;
            }
        
            function _effectiveValueAndRates(
                bytes32 sourceCurrencyKey,
                uint sourceAmount,
                bytes32 destinationCurrencyKey
            )
                internal
                view
                returns (
                    uint value,
                    uint sourceRate,
                    uint destinationRate
                )
            {
                sourceRate = _getRate(sourceCurrencyKey);
                // If there's no change in the currency, then just return the amount they gave us
                if (sourceCurrencyKey == destinationCurrencyKey) {
                    destinationRate = sourceRate;
                    value = sourceAmount;
                } else {
                    // Calculate the effective value by going from source -> USD -> destination
                    destinationRate = _getRate(destinationCurrencyKey);
                    // prevent divide-by 0 error (this happens if the dest is not a valid rate)
                    if (destinationRate > 0) {
                        value = sourceAmount.multiplyDecimalRound(sourceRate).divideDecimalRound(destinationRate);
                    }
                }
            }
        
            function _rateIsStale(bytes32 currencyKey, uint _rateStalePeriod) internal view returns (bool) {
                // sUSD is a special case and is never stale (check before an SLOAD of getRateAndUpdatedTime)
                if (currencyKey == "sUSD") return false;
        
                return _rateIsStaleWithTime(_rateStalePeriod, _getUpdatedTime(currencyKey));
            }
        
            function _rateIsStaleWithTime(uint _rateStalePeriod, uint _time) internal view returns (bool) {
                return _time.add(_rateStalePeriod) < now;
            }
        
            function _rateIsFrozen(bytes32 currencyKey) internal view returns (bool) {
                InversePricing memory inverse = inversePricing[currencyKey];
                return inverse.frozenAtUpperLimit || inverse.frozenAtLowerLimit;
            }
        
            function _rateIsFlagged(bytes32 currencyKey, FlagsInterface flags) internal view returns (bool) {
                // sUSD is a special case and is never invalid
                if (currencyKey == "sUSD") return false;
                address aggregator = address(aggregators[currencyKey]);
                // when no aggregator or when the flags haven't been setup
                if (aggregator == address(0) || flags == FlagsInterface(0)) {
                    return false;
                }
                return flags.getFlag(aggregator);
            }
        
            /* ========== MODIFIERS ========== */
        
            modifier onlyOracle {
                _onlyOracle();
                _;
            }
        
            function _onlyOracle() internal view {
                require(msg.sender == oracle, "Only the oracle can perform this action");
            }
        
            /* ========== EVENTS ========== */
        
            event OracleUpdated(address newOracle);
            event RatesUpdated(bytes32[] currencyKeys, uint[] newRates);
            event RateDeleted(bytes32 currencyKey);
            event InversePriceConfigured(bytes32 currencyKey, uint entryPoint, uint upperLimit, uint lowerLimit);
            event InversePriceFrozen(bytes32 currencyKey, uint rate, uint roundId, address initiator);
            event AggregatorAdded(bytes32 currencyKey, address aggregator);
            event AggregatorRemoved(bytes32 currencyKey, address aggregator);
        }
        
            

        File 4 of 8: FlexibleStorage
        /*
           ____            __   __        __   _
          / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
         _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
        /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
             /___/
        
        * Synthetix: FlexibleStorage.sol
        *
        * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/FlexibleStorage.sol
        * Docs: https://docs.synthetix.io/contracts/FlexibleStorage
        *
        * Contract Dependencies: 
        *	- ContractStorage
        *	- IFlexibleStorage
        * Libraries: (none)
        *
        * MIT License
        * ===========
        *
        * Copyright (c) 2020 Synthetix
        *
        * Permission is hereby granted, free of charge, to any person obtaining a copy
        * of this software and associated documentation files (the "Software"), to deal
        * in the Software without restriction, including without limitation the rights
        * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        * copies of the Software, and to permit persons to whom the Software is
        * furnished to do so, subject to the following conditions:
        *
        * The above copyright notice and this permission notice shall be included in all
        * copies or substantial portions of the Software.
        *
        * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        */
        
        
        
        pragma solidity >=0.4.24;
        
        
        interface IAddressResolver {
            function getAddress(bytes32 name) external view returns (address);
        
            function getSynth(bytes32 key) external view returns (address);
        
            function requireAndGetAddress(bytes32 name, string calldata reason) external view returns (address);
        }
        
        
        // Internal References
        
        
        // https://docs.synthetix.io/contracts/source/contracts/ContractStorage
        contract ContractStorage {
            IAddressResolver public resolverProxy;
        
            mapping(bytes32 => bytes32) public hashes;
        
            constructor(address _resolver) internal {
                // ReadProxyAddressResolver
                resolverProxy = IAddressResolver(_resolver);
            }
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function _memoizeHash(bytes32 contractName) internal returns (bytes32) {
                bytes32 hashKey = hashes[contractName];
                if (hashKey == bytes32(0)) {
                    // set to unique hash at the time of creation
                    hashKey = keccak256(abi.encodePacked(msg.sender, contractName, block.number));
                    hashes[contractName] = hashKey;
                }
                return hashKey;
            }
        
            /* ========== VIEWS ========== */
        
            /* ========== RESTRICTED FUNCTIONS ========== */
        
            function migrateContractKey(
                bytes32 fromContractName,
                bytes32 toContractName,
                bool removeAccessFromPreviousContract
            ) external onlyContract(fromContractName) {
                require(hashes[fromContractName] != bytes32(0), "Cannot migrate empty contract");
        
                hashes[toContractName] = hashes[fromContractName];
        
                if (removeAccessFromPreviousContract) {
                    delete hashes[fromContractName];
                }
        
                emit KeyMigrated(fromContractName, toContractName, removeAccessFromPreviousContract);
            }
        
            /* ========== MODIFIERS ========== */
        
            modifier onlyContract(bytes32 contractName) {
                address callingContract = resolverProxy.requireAndGetAddress(
                    contractName,
                    "Cannot find contract in Address Resolver"
                );
                require(callingContract == msg.sender, "Can only be invoked by the configured contract");
                _;
            }
        
            /* ========== EVENTS ========== */
        
            event KeyMigrated(bytes32 fromContractName, bytes32 toContractName, bool removeAccessFromPreviousContract);
        }
        
        
        interface IFlexibleStorage {
            // Views
            function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint);
        
            function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory);
        
            function getIntValue(bytes32 contractName, bytes32 record) external view returns (int);
        
            function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory);
        
            function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address);
        
            function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory);
        
            function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool);
        
            function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory);
        
            function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32);
        
            function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory);
        
            // Mutative functions
            function deleteUIntValue(bytes32 contractName, bytes32 record) external;
        
            function deleteIntValue(bytes32 contractName, bytes32 record) external;
        
            function deleteAddressValue(bytes32 contractName, bytes32 record) external;
        
            function deleteBoolValue(bytes32 contractName, bytes32 record) external;
        
            function deleteBytes32Value(bytes32 contractName, bytes32 record) external;
        
            function setUIntValue(
                bytes32 contractName,
                bytes32 record,
                uint value
            ) external;
        
            function setUIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                uint[] calldata values
            ) external;
        
            function setIntValue(
                bytes32 contractName,
                bytes32 record,
                int value
            ) external;
        
            function setIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                int[] calldata values
            ) external;
        
            function setAddressValue(
                bytes32 contractName,
                bytes32 record,
                address value
            ) external;
        
            function setAddressValues(
                bytes32 contractName,
                bytes32[] calldata records,
                address[] calldata values
            ) external;
        
            function setBoolValue(
                bytes32 contractName,
                bytes32 record,
                bool value
            ) external;
        
            function setBoolValues(
                bytes32 contractName,
                bytes32[] calldata records,
                bool[] calldata values
            ) external;
        
            function setBytes32Value(
                bytes32 contractName,
                bytes32 record,
                bytes32 value
            ) external;
        
            function setBytes32Values(
                bytes32 contractName,
                bytes32[] calldata records,
                bytes32[] calldata values
            ) external;
        }
        
        
        // Inheritance
        
        
        // Internal References
        
        
        // https://docs.synthetix.io/contracts/source/contracts/FlexibleStorage
        contract FlexibleStorage is ContractStorage, IFlexibleStorage {
            mapping(bytes32 => mapping(bytes32 => uint)) internal uintStorage;
            mapping(bytes32 => mapping(bytes32 => int)) internal intStorage;
            mapping(bytes32 => mapping(bytes32 => address)) internal addressStorage;
            mapping(bytes32 => mapping(bytes32 => bool)) internal boolStorage;
            mapping(bytes32 => mapping(bytes32 => bytes32)) internal bytes32Storage;
        
            constructor(address _resolver) public ContractStorage(_resolver) {}
        
            /* ========== INTERNAL FUNCTIONS ========== */
        
            function _setUIntValue(
                bytes32 contractName,
                bytes32 record,
                uint value
            ) internal {
                uintStorage[_memoizeHash(contractName)][record] = value;
                emit ValueSetUInt(contractName, record, value);
            }
        
            function _setIntValue(
                bytes32 contractName,
                bytes32 record,
                int value
            ) internal {
                intStorage[_memoizeHash(contractName)][record] = value;
                emit ValueSetInt(contractName, record, value);
            }
        
            function _setAddressValue(
                bytes32 contractName,
                bytes32 record,
                address value
            ) internal {
                addressStorage[_memoizeHash(contractName)][record] = value;
                emit ValueSetAddress(contractName, record, value);
            }
        
            function _setBoolValue(
                bytes32 contractName,
                bytes32 record,
                bool value
            ) internal {
                boolStorage[_memoizeHash(contractName)][record] = value;
                emit ValueSetBool(contractName, record, value);
            }
        
            function _setBytes32Value(
                bytes32 contractName,
                bytes32 record,
                bytes32 value
            ) internal {
                bytes32Storage[_memoizeHash(contractName)][record] = value;
                emit ValueSetBytes32(contractName, record, value);
            }
        
            /* ========== VIEWS ========== */
        
            function getUIntValue(bytes32 contractName, bytes32 record) external view returns (uint) {
                return uintStorage[hashes[contractName]][record];
            }
        
            function getUIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (uint[] memory) {
                uint[] memory results = new uint[](records.length);
        
                mapping(bytes32 => uint) storage data = uintStorage[hashes[contractName]];
                for (uint i = 0; i < records.length; i++) {
                    results[i] = data[records[i]];
                }
                return results;
            }
        
            function getIntValue(bytes32 contractName, bytes32 record) external view returns (int) {
                return intStorage[hashes[contractName]][record];
            }
        
            function getIntValues(bytes32 contractName, bytes32[] calldata records) external view returns (int[] memory) {
                int[] memory results = new int[](records.length);
        
                mapping(bytes32 => int) storage data = intStorage[hashes[contractName]];
                for (uint i = 0; i < records.length; i++) {
                    results[i] = data[records[i]];
                }
                return results;
            }
        
            function getAddressValue(bytes32 contractName, bytes32 record) external view returns (address) {
                return addressStorage[hashes[contractName]][record];
            }
        
            function getAddressValues(bytes32 contractName, bytes32[] calldata records) external view returns (address[] memory) {
                address[] memory results = new address[](records.length);
        
                mapping(bytes32 => address) storage data = addressStorage[hashes[contractName]];
                for (uint i = 0; i < records.length; i++) {
                    results[i] = data[records[i]];
                }
                return results;
            }
        
            function getBoolValue(bytes32 contractName, bytes32 record) external view returns (bool) {
                return boolStorage[hashes[contractName]][record];
            }
        
            function getBoolValues(bytes32 contractName, bytes32[] calldata records) external view returns (bool[] memory) {
                bool[] memory results = new bool[](records.length);
        
                mapping(bytes32 => bool) storage data = boolStorage[hashes[contractName]];
                for (uint i = 0; i < records.length; i++) {
                    results[i] = data[records[i]];
                }
                return results;
            }
        
            function getBytes32Value(bytes32 contractName, bytes32 record) external view returns (bytes32) {
                return bytes32Storage[hashes[contractName]][record];
            }
        
            function getBytes32Values(bytes32 contractName, bytes32[] calldata records) external view returns (bytes32[] memory) {
                bytes32[] memory results = new bytes32[](records.length);
        
                mapping(bytes32 => bytes32) storage data = bytes32Storage[hashes[contractName]];
                for (uint i = 0; i < records.length; i++) {
                    results[i] = data[records[i]];
                }
                return results;
            }
        
            /* ========== RESTRICTED FUNCTIONS ========== */
            function setUIntValue(
                bytes32 contractName,
                bytes32 record,
                uint value
            ) external onlyContract(contractName) {
                _setUIntValue(contractName, record, value);
            }
        
            function setUIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                uint[] calldata values
            ) external onlyContract(contractName) {
                require(records.length == values.length, "Input lengths must match");
        
                for (uint i = 0; i < records.length; i++) {
                    _setUIntValue(contractName, records[i], values[i]);
                }
            }
        
            function deleteUIntValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                uint value = uintStorage[hashes[contractName]][record];
                emit ValueDeletedUInt(contractName, record, value);
                delete uintStorage[hashes[contractName]][record];
            }
        
            function setIntValue(
                bytes32 contractName,
                bytes32 record,
                int value
            ) external onlyContract(contractName) {
                _setIntValue(contractName, record, value);
            }
        
            function setIntValues(
                bytes32 contractName,
                bytes32[] calldata records,
                int[] calldata values
            ) external onlyContract(contractName) {
                require(records.length == values.length, "Input lengths must match");
        
                for (uint i = 0; i < records.length; i++) {
                    _setIntValue(contractName, records[i], values[i]);
                }
            }
        
            function deleteIntValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                int value = intStorage[hashes[contractName]][record];
                emit ValueDeletedInt(contractName, record, value);
                delete intStorage[hashes[contractName]][record];
            }
        
            function setAddressValue(
                bytes32 contractName,
                bytes32 record,
                address value
            ) external onlyContract(contractName) {
                _setAddressValue(contractName, record, value);
            }
        
            function setAddressValues(
                bytes32 contractName,
                bytes32[] calldata records,
                address[] calldata values
            ) external onlyContract(contractName) {
                require(records.length == values.length, "Input lengths must match");
        
                for (uint i = 0; i < records.length; i++) {
                    _setAddressValue(contractName, records[i], values[i]);
                }
            }
        
            function deleteAddressValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                address value = addressStorage[hashes[contractName]][record];
                emit ValueDeletedAddress(contractName, record, value);
                delete addressStorage[hashes[contractName]][record];
            }
        
            function setBoolValue(
                bytes32 contractName,
                bytes32 record,
                bool value
            ) external onlyContract(contractName) {
                _setBoolValue(contractName, record, value);
            }
        
            function setBoolValues(
                bytes32 contractName,
                bytes32[] calldata records,
                bool[] calldata values
            ) external onlyContract(contractName) {
                require(records.length == values.length, "Input lengths must match");
        
                for (uint i = 0; i < records.length; i++) {
                    _setBoolValue(contractName, records[i], values[i]);
                }
            }
        
            function deleteBoolValue(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                bool value = boolStorage[hashes[contractName]][record];
                emit ValueDeletedBool(contractName, record, value);
                delete boolStorage[hashes[contractName]][record];
            }
        
            function setBytes32Value(
                bytes32 contractName,
                bytes32 record,
                bytes32 value
            ) external onlyContract(contractName) {
                _setBytes32Value(contractName, record, value);
            }
        
            function setBytes32Values(
                bytes32 contractName,
                bytes32[] calldata records,
                bytes32[] calldata values
            ) external onlyContract(contractName) {
                require(records.length == values.length, "Input lengths must match");
        
                for (uint i = 0; i < records.length; i++) {
                    _setBytes32Value(contractName, records[i], values[i]);
                }
            }
        
            function deleteBytes32Value(bytes32 contractName, bytes32 record) external onlyContract(contractName) {
                bytes32 value = bytes32Storage[hashes[contractName]][record];
                emit ValueDeletedBytes32(contractName, record, value);
                delete bytes32Storage[hashes[contractName]][record];
            }
        
            /* ========== EVENTS ========== */
        
            event ValueSetUInt(bytes32 contractName, bytes32 record, uint value);
            event ValueDeletedUInt(bytes32 contractName, bytes32 record, uint value);
        
            event ValueSetInt(bytes32 contractName, bytes32 record, int value);
            event ValueDeletedInt(bytes32 contractName, bytes32 record, int value);
        
            event ValueSetAddress(bytes32 contractName, bytes32 record, address value);
            event ValueDeletedAddress(bytes32 contractName, bytes32 record, address value);
        
            event ValueSetBool(bytes32 contractName, bytes32 record, bool value);
            event ValueDeletedBool(bytes32 contractName, bytes32 record, bool value);
        
            event ValueSetBytes32(bytes32 contractName, bytes32 record, bytes32 value);
            event ValueDeletedBytes32(bytes32 contractName, bytes32 record, bytes32 value);
        }
        
            

        File 5 of 8: EACAggregatorProxy
        pragma solidity 0.6.6;
        
        
        /**
         * @title The Owned contract
         * @notice A contract with helpers for basic contract ownership.
         */
        contract Owned {
        
          address payable public owner;
          address private pendingOwner;
        
          event OwnershipTransferRequested(
            address indexed from,
            address indexed to
          );
          event OwnershipTransferred(
            address indexed from,
            address indexed to
          );
        
          constructor() public {
            owner = msg.sender;
          }
        
          /**
           * @dev Allows an owner to begin transferring ownership to a new address,
           * pending.
           */
          function transferOwnership(address _to)
            external
            onlyOwner()
          {
            pendingOwner = _to;
        
            emit OwnershipTransferRequested(owner, _to);
          }
        
          /**
           * @dev Allows an ownership transfer to be completed by the recipient.
           */
          function acceptOwnership()
            external
          {
            require(msg.sender == pendingOwner, "Must be proposed owner");
        
            address oldOwner = owner;
            owner = msg.sender;
            pendingOwner = address(0);
        
            emit OwnershipTransferred(oldOwner, msg.sender);
          }
        
          /**
           * @dev Reverts if called by anyone other than the contract owner.
           */
          modifier onlyOwner() {
            require(msg.sender == owner, "Only callable by owner");
            _;
          }
        
        }
        
        interface AggregatorInterface {
          function latestAnswer() external view returns (int256);
          function latestTimestamp() external view returns (uint256);
          function latestRound() external view returns (uint256);
          function getAnswer(uint256 roundId) external view returns (int256);
          function getTimestamp(uint256 roundId) external view returns (uint256);
        
          event AnswerUpdated(int256 indexed current, uint256 indexed roundId, uint256 updatedAt);
          event NewRound(uint256 indexed roundId, address indexed startedBy, uint256 startedAt);
        }
        
        interface AggregatorV3Interface {
        
          function decimals() external view returns (uint8);
          function description() external view returns (string memory);
          function version() external view returns (uint256);
        
          // getRoundData and latestRoundData should both raise "No data present"
          // if they do not have data to report, instead of returning unset values
          // which could be misinterpreted as actual reported values.
          function getRoundData(uint80 _roundId)
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
          function latestRoundData()
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
        
        }
        
        interface AggregatorV2V3Interface is AggregatorInterface, AggregatorV3Interface
        {
        }
        
        /**
         * @title A trusted proxy for updating where current answers are read from
         * @notice This contract provides a consistent address for the
         * CurrentAnwerInterface but delegates where it reads from to the owner, who is
         * trusted to update it.
         */
        contract AggregatorProxy is AggregatorV2V3Interface, Owned {
        
          struct Phase {
            uint16 id;
            AggregatorV2V3Interface aggregator;
          }
          Phase private currentPhase;
          AggregatorV2V3Interface public proposedAggregator;
          mapping(uint16 => AggregatorV2V3Interface) public phaseAggregators;
        
          uint256 constant private PHASE_OFFSET = 64;
          uint256 constant private PHASE_SIZE = 16;
          uint256 constant private MAX_ID = 2**(PHASE_OFFSET+PHASE_SIZE) - 1;
        
          constructor(address _aggregator) public Owned() {
            setAggregator(_aggregator);
          }
        
          /**
           * @notice Reads the current answer from aggregator delegated to.
           *
           * @dev #[deprecated] Use latestRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended latestRoundData
           * instead which includes better verification information.
           */
          function latestAnswer()
            public
            view
            virtual
            override
            returns (int256 answer)
          {
            return currentPhase.aggregator.latestAnswer();
          }
        
          /**
           * @notice Reads the last updated height from aggregator delegated to.
           *
           * @dev #[deprecated] Use latestRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended latestRoundData
           * instead which includes better verification information.
           */
          function latestTimestamp()
            public
            view
            virtual
            override
            returns (uint256 updatedAt)
          {
            return currentPhase.aggregator.latestTimestamp();
          }
        
          /**
           * @notice get past rounds answers
           * @param _roundId the answer number to retrieve the answer for
           *
           * @dev #[deprecated] Use getRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended getRoundData
           * instead which includes better verification information.
           */
          function getAnswer(uint256 _roundId)
            public
            view
            virtual
            override
            returns (int256 answer)
          {
            if (_roundId > MAX_ID) return 0;
        
            (uint16 phaseId, uint64 aggregatorRoundId) = parseIds(_roundId);
            AggregatorV2V3Interface aggregator = phaseAggregators[phaseId];
            if (address(aggregator) == address(0)) return 0;
        
            return aggregator.getAnswer(aggregatorRoundId);
          }
        
          /**
           * @notice get block timestamp when an answer was last updated
           * @param _roundId the answer number to retrieve the updated timestamp for
           *
           * @dev #[deprecated] Use getRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended getRoundData
           * instead which includes better verification information.
           */
          function getTimestamp(uint256 _roundId)
            public
            view
            virtual
            override
            returns (uint256 updatedAt)
          {
            if (_roundId > MAX_ID) return 0;
        
            (uint16 phaseId, uint64 aggregatorRoundId) = parseIds(_roundId);
            AggregatorV2V3Interface aggregator = phaseAggregators[phaseId];
            if (address(aggregator) == address(0)) return 0;
        
            return aggregator.getTimestamp(aggregatorRoundId);
          }
        
          /**
           * @notice get the latest completed round where the answer was updated. This
           * ID includes the proxy's phase, to make sure round IDs increase even when
           * switching to a newly deployed aggregator.
           *
           * @dev #[deprecated] Use latestRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended latestRoundData
           * instead which includes better verification information.
           */
          function latestRound()
            public
            view
            virtual
            override
            returns (uint256 roundId)
          {
            Phase memory phase = currentPhase; // cache storage reads
            return addPhase(phase.id, uint64(phase.aggregator.latestRound()));
          }
        
          /**
           * @notice get data about a round. Consumers are encouraged to check
           * that they're receiving fresh data by inspecting the updatedAt and
           * answeredInRound return values.
           * Note that different underlying implementations of AggregatorV3Interface
           * have slightly different semantics for some of the return values. Consumers
           * should determine what implementations they expect to receive
           * data from and validate that they can properly handle return data from all
           * of them.
           * @param _roundId the requested round ID as presented through the proxy, this
           * is made up of the aggregator's round ID with the phase ID encoded in the
           * two highest order bytes
           * @return roundId is the round ID from the aggregator for which the data was
           * retrieved combined with an phase to ensure that round IDs get larger as
           * time moves forward.
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @dev Note that answer and updatedAt may change between queries.
           */
          function getRoundData(uint80 _roundId)
            public
            view
            virtual
            override
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            (uint16 phaseId, uint64 aggregatorRoundId) = parseIds(_roundId);
        
            (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 ansIn
            ) = phaseAggregators[phaseId].getRoundData(aggregatorRoundId);
        
            return addPhaseIds(roundId, answer, startedAt, updatedAt, ansIn, phaseId);
          }
        
          /**
           * @notice get data about the latest round. Consumers are encouraged to check
           * that they're receiving fresh data by inspecting the updatedAt and
           * answeredInRound return values.
           * Note that different underlying implementations of AggregatorV3Interface
           * have slightly different semantics for some of the return values. Consumers
           * should determine what implementations they expect to receive
           * data from and validate that they can properly handle return data from all
           * of them.
           * @return roundId is the round ID from the aggregator for which the data was
           * retrieved combined with an phase to ensure that round IDs get larger as
           * time moves forward.
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @dev Note that answer and updatedAt may change between queries.
           */
          function latestRoundData()
            public
            view
            virtual
            override
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            Phase memory current = currentPhase; // cache storage reads
        
            (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 ansIn
            ) = current.aggregator.latestRoundData();
        
            return addPhaseIds(roundId, answer, startedAt, updatedAt, ansIn, current.id);
          }
        
          /**
           * @notice Used if an aggregator contract has been proposed.
           * @param _roundId the round ID to retrieve the round data for
           * @return roundId is the round ID for which data was retrieved
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
          */
          function proposedGetRoundData(uint80 _roundId)
            public
            view
            virtual
            hasProposal()
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return proposedAggregator.getRoundData(_roundId);
          }
        
          /**
           * @notice Used if an aggregator contract has been proposed.
           * @return roundId is the round ID for which data was retrieved
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
          */
          function proposedLatestRoundData()
            public
            view
            virtual
            hasProposal()
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return proposedAggregator.latestRoundData();
          }
        
          /**
           * @notice returns the current phase's aggregator address.
           */
          function aggregator()
            external
            view
            returns (address)
          {
            return address(currentPhase.aggregator);
          }
        
          /**
           * @notice returns the current phase's ID.
           */
          function phaseId()
            external
            view
            returns (uint16)
          {
            return currentPhase.id;
          }
        
          /**
           * @notice represents the number of decimals the aggregator responses represent.
           */
          function decimals()
            external
            view
            override
            returns (uint8)
          {
            return currentPhase.aggregator.decimals();
          }
        
          /**
           * @notice the version number representing the type of aggregator the proxy
           * points to.
           */
          function version()
            external
            view
            override
            returns (uint256)
          {
            return currentPhase.aggregator.version();
          }
        
          /**
           * @notice returns the description of the aggregator the proxy points to.
           */
          function description()
            external
            view
            override
            returns (string memory)
          {
            return currentPhase.aggregator.description();
          }
        
          /**
           * @notice Allows the owner to propose a new address for the aggregator
           * @param _aggregator The new address for the aggregator contract
           */
          function proposeAggregator(address _aggregator)
            external
            onlyOwner()
          {
            proposedAggregator = AggregatorV2V3Interface(_aggregator);
          }
        
          /**
           * @notice Allows the owner to confirm and change the address
           * to the proposed aggregator
           * @dev Reverts if the given address doesn't match what was previously
           * proposed
           * @param _aggregator The new address for the aggregator contract
           */
          function confirmAggregator(address _aggregator)
            external
            onlyOwner()
          {
            require(_aggregator == address(proposedAggregator), "Invalid proposed aggregator");
            delete proposedAggregator;
            setAggregator(_aggregator);
          }
        
        
          /*
           * Internal
           */
        
          function setAggregator(address _aggregator)
            internal
          {
            uint16 id = currentPhase.id + 1;
            currentPhase = Phase(id, AggregatorV2V3Interface(_aggregator));
            phaseAggregators[id] = AggregatorV2V3Interface(_aggregator);
          }
        
          function addPhase(
            uint16 _phase,
            uint64 _originalId
          )
            internal
            view
            returns (uint80)
          {
            return uint80(uint256(_phase) << PHASE_OFFSET | _originalId);
          }
        
          function parseIds(
            uint256 _roundId
          )
            internal
            view
            returns (uint16, uint64)
          {
            uint16 phaseId = uint16(_roundId >> PHASE_OFFSET);
            uint64 aggregatorRoundId = uint64(_roundId);
        
            return (phaseId, aggregatorRoundId);
          }
        
          function addPhaseIds(
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound,
              uint16 phaseId
          )
            internal
            view
            returns (uint80, int256, uint256, uint256, uint80)
          {
            return (
              addPhase(phaseId, uint64(roundId)),
              answer,
              startedAt,
              updatedAt,
              addPhase(phaseId, uint64(answeredInRound))
            );
          }
        
          /*
           * Modifiers
           */
        
          modifier hasProposal() {
            require(address(proposedAggregator) != address(0), "No proposed aggregator present");
            _;
          }
        
        }
        
        interface AccessControllerInterface {
          function hasAccess(address user, bytes calldata data) external view returns (bool);
        }
        
        /**
         * @title External Access Controlled Aggregator Proxy
         * @notice A trusted proxy for updating where current answers are read from
         * @notice This contract provides a consistent address for the
         * Aggregator and AggregatorV3Interface but delegates where it reads from to the owner, who is
         * trusted to update it.
         * @notice Only access enabled addresses are allowed to access getters for
         * aggregated answers and round information.
         */
        contract EACAggregatorProxy is AggregatorProxy {
        
          AccessControllerInterface public accessController;
        
          constructor(
            address _aggregator,
            address _accessController
          )
            public
            AggregatorProxy(_aggregator)
          {
            setController(_accessController);
          }
        
          /**
           * @notice Allows the owner to update the accessController contract address.
           * @param _accessController The new address for the accessController contract
           */
          function setController(address _accessController)
            public
            onlyOwner()
          {
            accessController = AccessControllerInterface(_accessController);
          }
        
          /**
           * @notice Reads the current answer from aggregator delegated to.
           * @dev overridden function to add the checkAccess() modifier
           *
           * @dev #[deprecated] Use latestRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended latestRoundData
           * instead which includes better verification information.
           */
          function latestAnswer()
            public
            view
            override
            checkAccess()
            returns (int256)
          {
            return super.latestAnswer();
          }
        
          /**
           * @notice get the latest completed round where the answer was updated. This
           * ID includes the proxy's phase, to make sure round IDs increase even when
           * switching to a newly deployed aggregator.
           *
           * @dev #[deprecated] Use latestRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended latestRoundData
           * instead which includes better verification information.
           */
          function latestTimestamp()
            public
            view
            override
            checkAccess()
            returns (uint256)
          {
            return super.latestTimestamp();
          }
        
          /**
           * @notice get past rounds answers
           * @param _roundId the answer number to retrieve the answer for
           * @dev overridden function to add the checkAccess() modifier
           *
           * @dev #[deprecated] Use getRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended getRoundData
           * instead which includes better verification information.
           */
          function getAnswer(uint256 _roundId)
            public
            view
            override
            checkAccess()
            returns (int256)
          {
            return super.getAnswer(_roundId);
          }
        
          /**
           * @notice get block timestamp when an answer was last updated
           * @param _roundId the answer number to retrieve the updated timestamp for
           * @dev overridden function to add the checkAccess() modifier
           *
           * @dev #[deprecated] Use getRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended getRoundData
           * instead which includes better verification information.
           */
          function getTimestamp(uint256 _roundId)
            public
            view
            override
            checkAccess()
            returns (uint256)
          {
            return super.getTimestamp(_roundId);
          }
        
          /**
           * @notice get the latest completed round where the answer was updated
           * @dev overridden function to add the checkAccess() modifier
           *
           * @dev #[deprecated] Use latestRoundData instead. This does not error if no
           * answer has been reached, it will simply return 0. Either wait to point to
           * an already answered Aggregator or use the recommended latestRoundData
           * instead which includes better verification information.
           */
          function latestRound()
            public
            view
            override
            checkAccess()
            returns (uint256)
          {
            return super.latestRound();
          }
        
          /**
           * @notice get data about a round. Consumers are encouraged to check
           * that they're receiving fresh data by inspecting the updatedAt and
           * answeredInRound return values.
           * Note that different underlying implementations of AggregatorV3Interface
           * have slightly different semantics for some of the return values. Consumers
           * should determine what implementations they expect to receive
           * data from and validate that they can properly handle return data from all
           * of them.
           * @param _roundId the round ID to retrieve the round data for
           * @return roundId is the round ID from the aggregator for which the data was
           * retrieved combined with a phase to ensure that round IDs get larger as
           * time moves forward.
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @dev Note that answer and updatedAt may change between queries.
           */
          function getRoundData(uint80 _roundId)
            public
            view
            checkAccess()
            override
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return super.getRoundData(_roundId);
          }
        
          /**
           * @notice get data about the latest round. Consumers are encouraged to check
           * that they're receiving fresh data by inspecting the updatedAt and
           * answeredInRound return values.
           * Note that different underlying implementations of AggregatorV3Interface
           * have slightly different semantics for some of the return values. Consumers
           * should determine what implementations they expect to receive
           * data from and validate that they can properly handle return data from all
           * of them.
           * @return roundId is the round ID from the aggregator for which the data was
           * retrieved combined with a phase to ensure that round IDs get larger as
           * time moves forward.
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @dev Note that answer and updatedAt may change between queries.
           */
          function latestRoundData()
            public
            view
            checkAccess()
            override
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return super.latestRoundData();
          }
        
          /**
           * @notice Used if an aggregator contract has been proposed.
           * @param _roundId the round ID to retrieve the round data for
           * @return roundId is the round ID for which data was retrieved
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
          */
          function proposedGetRoundData(uint80 _roundId)
            public
            view
            checkAccess()
            hasProposal()
            override
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return super.proposedGetRoundData(_roundId);
          }
        
          /**
           * @notice Used if an aggregator contract has been proposed.
           * @return roundId is the round ID for which data was retrieved
           * @return answer is the answer for the given round
           * @return startedAt is the timestamp when the round was started.
           * (Only some AggregatorV3Interface implementations return meaningful values)
           * @return updatedAt is the timestamp when the round last was updated (i.e.
           * answer was last computed)
           * @return answeredInRound is the round ID of the round in which the answer
           * was computed.
          */
          function proposedLatestRoundData()
            public
            view
            checkAccess()
            hasProposal()
            override
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return super.proposedLatestRoundData();
          }
        
          /**
           * @dev reverts if the caller does not have access by the accessController
           * contract or is the contract itself.
           */
          modifier checkAccess() {
            AccessControllerInterface ac = accessController;
            require(address(ac) == address(0) || ac.hasAccess(msg.sender, msg.data), "No access");
            _;
          }
        }

        File 6 of 8: AccessControlledOffchainAggregator
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.1;
        import "./OffchainAggregator.sol";
        import "./SimpleReadAccessController.sol";
        /**
         * @notice Wrapper of OffchainAggregator which checks read access on Aggregator-interface methods
         */
        contract AccessControlledOffchainAggregator is OffchainAggregator, SimpleReadAccessController {
          constructor(
            uint32 _maximumGasPrice,
            uint32 _reasonableGasPrice,
            uint32 _microLinkPerEth,
            uint32 _linkGweiPerObservation,
            uint32 _linkGweiPerTransmission,
            address _link,
            int192 _minAnswer,
            int192 _maxAnswer,
            AccessControllerInterface _billingAccessController,
            AccessControllerInterface _requesterAccessController,
            uint8 _decimals,
            string memory description
          )
            OffchainAggregator(
              _maximumGasPrice,
              _reasonableGasPrice,
              _microLinkPerEth,
              _linkGweiPerObservation,
              _linkGweiPerTransmission,
              _link,
              _minAnswer,
              _maxAnswer,
              _billingAccessController,
              _requesterAccessController,
              _decimals,
              description
            ) {
            }
          /*
           * Versioning
           */
          function typeAndVersion()
            external
            override
            pure
            virtual
            returns (string memory)
          {
            return "AccessControlledOffchainAggregator 2.0.0";
          }
          /*
           * v2 Aggregator interface
           */
          /// @inheritdoc OffchainAggregator
          function latestAnswer()
            public
            override
            view
            checkAccess()
            returns (int256)
          {
            return super.latestAnswer();
          }
          /// @inheritdoc OffchainAggregator
          function latestTimestamp()
            public
            override
            view
            checkAccess()
            returns (uint256)
          {
            return super.latestTimestamp();
          }
          /// @inheritdoc OffchainAggregator
          function latestRound()
            public
            override
            view
            checkAccess()
            returns (uint256)
          {
            return super.latestRound();
          }
          /// @inheritdoc OffchainAggregator
          function getAnswer(uint256 _roundId)
            public
            override
            view
            checkAccess()
            returns (int256)
          {
            return super.getAnswer(_roundId);
          }
          /// @inheritdoc OffchainAggregator
          function getTimestamp(uint256 _roundId)
            public
            override
            view
            checkAccess()
            returns (uint256)
          {
            return super.getTimestamp(_roundId);
          }
          /*
           * v3 Aggregator interface
           */
          /// @inheritdoc OffchainAggregator
          function description()
            public
            override
            view
            checkAccess()
            returns (string memory)
          {
            return super.description();
          }
          /// @inheritdoc OffchainAggregator
          function getRoundData(uint80 _roundId)
            public
            override
            view
            checkAccess()
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return super.getRoundData(_roundId);
          }
          /// @inheritdoc OffchainAggregator
          function latestRoundData()
            public
            override
            view
            checkAccess()
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            return super.latestRoundData();
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./AccessControllerInterface.sol";
        import "./AggregatorV2V3Interface.sol";
        import "./AggregatorValidatorInterface.sol";
        import "./LinkTokenInterface.sol";
        import "./Owned.sol";
        import "./OffchainAggregatorBilling.sol";
        import "./TypeAndVersionInterface.sol";
        /**
          * @notice Onchain verification of reports from the offchain reporting protocol
          * @dev For details on its operation, see the offchain reporting protocol design
          * @dev doc, which refers to this contract as simply the "contract".
        */
        contract OffchainAggregator is Owned, OffchainAggregatorBilling, AggregatorV2V3Interface, TypeAndVersionInterface {
          uint256 constant private maxUint32 = (1 << 32) - 1;
          // Storing these fields used on the hot path in a HotVars variable reduces the
          // retrieval of all of them to a single SLOAD. If any further fields are
          // added, make sure that storage of the struct still takes at most 32 bytes.
          struct HotVars {
            // Provides 128 bits of security against 2nd pre-image attacks, but only
            // 64 bits against collisions. This is acceptable, since a malicious owner has
            // easier way of messing up the protocol than to find hash collisions.
            bytes16 latestConfigDigest;
            uint40 latestEpochAndRound; // 32 most sig bits for epoch, 8 least sig bits for round
            // Current bound assumed on number of faulty/dishonest oracles participating
            // in the protocol, this value is referred to as f in the design
            uint8 threshold;
            // Chainlink Aggregators expose a roundId to consumers. The offchain reporting
            // protocol does not use this id anywhere. We increment it whenever a new
            // transmission is made to provide callers with contiguous ids for successive
            // reports.
            uint32 latestAggregatorRoundId;
          }
          HotVars internal s_hotVars;
          // Transmission records the median answer from the transmit transaction at
          // time timestamp
          struct Transmission {
            int192 answer; // 192 bits ought to be enough for anyone
            uint64 timestamp;
          }
          mapping(uint32 /* aggregator round ID */ => Transmission) internal s_transmissions;
          // incremented each time a new config is posted. This count is incorporated
          // into the config digest, to prevent replay attacks.
          uint32 internal s_configCount;
          uint32 internal s_latestConfigBlockNumber; // makes it easier for offchain systems
                                                     // to extract config from logs.
          // Lowest answer the system is allowed to report in response to transmissions
          int192 immutable public minAnswer;
          // Highest answer the system is allowed to report in response to transmissions
          int192 immutable public maxAnswer;
          /*
           * @param _maximumGasPrice highest gas price for which transmitter will be compensated
           * @param _reasonableGasPrice transmitter will receive reward for gas prices under this value
           * @param _microLinkPerEth reimbursement per ETH of gas cost, in 1e-6LINK units
           * @param _linkGweiPerObservation reward to oracle for contributing an observation to a successfully transmitted report, in 1e-9LINK units
           * @param _linkGweiPerTransmission reward to transmitter of a successful report, in 1e-9LINK units
           * @param _link address of the LINK contract
           * @param _minAnswer lowest answer the median of a report is allowed to be
           * @param _maxAnswer highest answer the median of a report is allowed to be
           * @param _billingAccessController access controller for billing admin functions
           * @param _requesterAccessController access controller for requesting new rounds
           * @param _decimals answers are stored in fixed-point format, with this many digits of precision
           * @param _description short human-readable description of observable this contract's answers pertain to
           */
          constructor(
            uint32 _maximumGasPrice,
            uint32 _reasonableGasPrice,
            uint32 _microLinkPerEth,
            uint32 _linkGweiPerObservation,
            uint32 _linkGweiPerTransmission,
            address _link,
            int192 _minAnswer,
            int192 _maxAnswer,
            AccessControllerInterface _billingAccessController,
            AccessControllerInterface _requesterAccessController,
            uint8 _decimals,
            string memory _description
          )
            OffchainAggregatorBilling(_maximumGasPrice, _reasonableGasPrice, _microLinkPerEth,
              _linkGweiPerObservation, _linkGweiPerTransmission, _link,
              _billingAccessController
            )
          {
            decimals = _decimals;
            s_description = _description;
            setRequesterAccessController(_requesterAccessController);
            setValidatorConfig(AggregatorValidatorInterface(0x0), 0);
            minAnswer = _minAnswer;
            maxAnswer = _maxAnswer;
          }
          /*
           * Versioning
           */
          function typeAndVersion()
            external
            override
            pure
            virtual
            returns (string memory)
          {
            return "OffchainAggregator 2.0.0";
          }
          /*
           * Config logic
           */
          /**
           * @notice triggers a new run of the offchain reporting protocol
           * @param previousConfigBlockNumber block in which the previous config was set, to simplify historic analysis
           * @param configCount ordinal number of this config setting among all config settings over the life of this contract
           * @param signers ith element is address ith oracle uses to sign a report
           * @param transmitters ith element is address ith oracle uses to transmit a report via the transmit method
           * @param threshold maximum number of faulty/dishonest oracles the protocol can tolerate while still working correctly
           * @param encodedConfigVersion version of the serialization format used for "encoded" parameter
           * @param encoded serialized data used by oracles to configure their offchain operation
           */
          event ConfigSet(
            uint32 previousConfigBlockNumber,
            uint64 configCount,
            address[] signers,
            address[] transmitters,
            uint8 threshold,
            uint64 encodedConfigVersion,
            bytes encoded
          );
          // Reverts transaction if config args are invalid
          modifier checkConfigValid (
            uint256 _numSigners, uint256 _numTransmitters, uint256 _threshold
          ) {
            require(_numSigners <= maxNumOracles, "too many signers");
            require(_threshold > 0, "threshold must be positive");
            require(
              _numSigners == _numTransmitters,
              "oracle addresses out of registration"
            );
            require(_numSigners > 3*_threshold, "faulty-oracle threshold too high");
            _;
          }
          /**
           * @notice sets offchain reporting protocol configuration incl. participating oracles
           * @param _signers addresses with which oracles sign the reports
           * @param _transmitters addresses oracles use to transmit the reports
           * @param _threshold number of faulty oracles the system can tolerate
           * @param _encodedConfigVersion version number for offchainEncoding schema
           * @param _encoded encoded off-chain oracle configuration
           */
          function setConfig(
            address[] calldata _signers,
            address[] calldata _transmitters,
            uint8 _threshold,
            uint64 _encodedConfigVersion,
            bytes calldata _encoded
          )
            external
            checkConfigValid(_signers.length, _transmitters.length, _threshold)
            onlyOwner()
          {
            while (s_signers.length != 0) { // remove any old signer/transmitter addresses
              uint lastIdx = s_signers.length - 1;
              address signer = s_signers[lastIdx];
              address transmitter = s_transmitters[lastIdx];
              payOracle(transmitter);
              delete s_oracles[signer];
              delete s_oracles[transmitter];
              s_signers.pop();
              s_transmitters.pop();
            }
            for (uint i = 0; i < _signers.length; i++) { // add new signer/transmitter addresses
              require(
                s_oracles[_signers[i]].role == Role.Unset,
                "repeated signer address"
              );
              s_oracles[_signers[i]] = Oracle(uint8(i), Role.Signer);
              require(s_payees[_transmitters[i]] != address(0), "payee must be set");
              require(
                s_oracles[_transmitters[i]].role == Role.Unset,
                "repeated transmitter address"
              );
              s_oracles[_transmitters[i]] = Oracle(uint8(i), Role.Transmitter);
              s_signers.push(_signers[i]);
              s_transmitters.push(_transmitters[i]);
            }
            s_hotVars.threshold = _threshold;
            uint32 previousConfigBlockNumber = s_latestConfigBlockNumber;
            s_latestConfigBlockNumber = uint32(block.number);
            s_configCount += 1;
            uint64 configCount = s_configCount;
            {
              s_hotVars.latestConfigDigest = configDigestFromConfigData(
                address(this),
                configCount,
                _signers,
                _transmitters,
                _threshold,
                _encodedConfigVersion,
                _encoded
              );
              s_hotVars.latestEpochAndRound = 0;
            }
            emit ConfigSet(
              previousConfigBlockNumber,
              configCount,
              _signers,
              _transmitters,
              _threshold,
              _encodedConfigVersion,
              _encoded
            );
          }
          function configDigestFromConfigData(
            address _contractAddress,
            uint64 _configCount,
            address[] calldata _signers,
            address[] calldata _transmitters,
            uint8 _threshold,
            uint64 _encodedConfigVersion,
            bytes calldata _encodedConfig
          ) internal pure returns (bytes16) {
            return bytes16(keccak256(abi.encode(_contractAddress, _configCount,
              _signers, _transmitters, _threshold, _encodedConfigVersion, _encodedConfig
            )));
          }
          /**
           * @notice information about current offchain reporting protocol configuration
           * @return configCount ordinal number of current config, out of all configs applied to this contract so far
           * @return blockNumber block at which this config was set
           * @return configDigest domain-separation tag for current config (see configDigestFromConfigData)
           */
          function latestConfigDetails()
            external
            view
            returns (
              uint32 configCount,
              uint32 blockNumber,
              bytes16 configDigest
            )
          {
            return (s_configCount, s_latestConfigBlockNumber, s_hotVars.latestConfigDigest);
          }
          /**
           * @return list of addresses permitted to transmit reports to this contract
           * @dev The list will match the order used to specify the transmitter during setConfig
           */
          function transmitters()
            external
            view
            returns(address[] memory)
          {
              return s_transmitters;
          }
          /*
           * On-chain validation logc
           */
          // Configuration for validator
          struct ValidatorConfig {
            AggregatorValidatorInterface validator;
            uint32 gasLimit;
          }
          ValidatorConfig private s_validatorConfig;
          /**
           * @notice indicates that the validator configuration has been set
           * @param previousValidator previous validator contract
           * @param previousGasLimit previous gas limit for validate calls
           * @param currentValidator current validator contract
           * @param currentGasLimit current gas limit for validate calls
           */
          event ValidatorConfigSet(
            AggregatorValidatorInterface indexed previousValidator,
            uint32 previousGasLimit,
            AggregatorValidatorInterface indexed currentValidator,
            uint32 currentGasLimit
          );
          /**
           * @notice validator configuration
           * @return validator validator contract
           * @return gasLimit gas limit for validate calls
           */
          function validatorConfig()
            external
            view
            returns (AggregatorValidatorInterface validator, uint32 gasLimit)
          {
            ValidatorConfig memory vc = s_validatorConfig;
            return (vc.validator, vc.gasLimit);
          }
          /**
           * @notice sets validator configuration
           * @dev set _newValidator to 0x0 to disable validate calls
           * @param _newValidator address of the new validator contract
           * @param _newGasLimit new gas limit for validate calls
           */
          function setValidatorConfig(AggregatorValidatorInterface _newValidator, uint32 _newGasLimit)
            public
            onlyOwner()
          {
            ValidatorConfig memory previous = s_validatorConfig;
            if (previous.validator != _newValidator || previous.gasLimit != _newGasLimit) {
              s_validatorConfig = ValidatorConfig({
                validator: _newValidator,
                gasLimit: _newGasLimit
              });
              emit ValidatorConfigSet(previous.validator, previous.gasLimit, _newValidator, _newGasLimit);
            }
          }
          function validateAnswer(
            uint32 _aggregatorRoundId,
            int256 _answer
          )
            private
          {
            ValidatorConfig memory vc = s_validatorConfig;
            if (address(vc.validator) == address(0)) {
              return;
            }
            uint32 prevAggregatorRoundId = _aggregatorRoundId - 1;
            int256 prevAggregatorRoundAnswer = s_transmissions[prevAggregatorRoundId].answer;
            // We do not want the validator to ever prevent reporting, so we limit its
            // gas usage and catch any errors that may arise.
            try vc.validator.validate{gas: vc.gasLimit}(
              prevAggregatorRoundId,
              prevAggregatorRoundAnswer,
              _aggregatorRoundId,
              _answer
            ) {} catch {}
          }
          /*
           * requestNewRound logic
           */
          AccessControllerInterface internal s_requesterAccessController;
          /**
           * @notice emitted when a new requester access controller contract is set
           * @param old the address prior to the current setting
           * @param current the address of the new access controller contract
           */
          event RequesterAccessControllerSet(AccessControllerInterface old, AccessControllerInterface current);
          /**
           * @notice emitted to immediately request a new round
           * @param requester the address of the requester
           * @param configDigest the latest transmission's configDigest
           * @param epoch the latest transmission's epoch
           * @param round the latest transmission's round
           */
          event RoundRequested(address indexed requester, bytes16 configDigest, uint32 epoch, uint8 round);
          /**
           * @notice address of the requester access controller contract
           * @return requester access controller address
           */
          function requesterAccessController()
            external
            view
            returns (AccessControllerInterface)
          {
            return s_requesterAccessController;
          }
          /**
           * @notice sets the requester access controller
           * @param _requesterAccessController designates the address of the new requester access controller
           */
          function setRequesterAccessController(AccessControllerInterface _requesterAccessController)
            public
            onlyOwner()
          {
            AccessControllerInterface oldController = s_requesterAccessController;
            if (_requesterAccessController != oldController) {
              s_requesterAccessController = AccessControllerInterface(_requesterAccessController);
              emit RequesterAccessControllerSet(oldController, _requesterAccessController);
            }
          }
          /**
           * @notice immediately requests a new round
           * @return the aggregatorRoundId of the next round. Note: The report for this round may have been
           * transmitted (but not yet mined) *before* requestNewRound() was even called. There is *no*
           * guarantee of causality between the request and the report at aggregatorRoundId.
           */
          function requestNewRound() external returns (uint80) {
            require(msg.sender == owner || s_requesterAccessController.hasAccess(msg.sender, msg.data),
              "Only owner&requester can call");
            HotVars memory hotVars = s_hotVars;
            emit RoundRequested(
              msg.sender,
              hotVars.latestConfigDigest,
              uint32(s_hotVars.latestEpochAndRound >> 8),
              uint8(s_hotVars.latestEpochAndRound)
            );
            return hotVars.latestAggregatorRoundId + 1;
          }
          /*
           * Transmission logic
           */
          /**
           * @notice indicates that a new report was transmitted
           * @param aggregatorRoundId the round to which this report was assigned
           * @param answer median of the observations attached this report
           * @param transmitter address from which the report was transmitted
           * @param observations observations transmitted with this report
           * @param rawReportContext signature-replay-prevention domain-separation tag
           */
          event NewTransmission(
            uint32 indexed aggregatorRoundId,
            int192 answer,
            address transmitter,
            int192[] observations,
            bytes observers,
            bytes32 rawReportContext
          );
          // decodeReport is used to check that the solidity and go code are using the
          // same format. See TestOffchainAggregator.testDecodeReport and TestReportParsing
          function decodeReport(bytes memory _report)
            internal
            pure
            returns (
              bytes32 rawReportContext,
              bytes32 rawObservers,
              int192[] memory observations
            )
          {
            (rawReportContext, rawObservers, observations) = abi.decode(_report,
              (bytes32, bytes32, int192[]));
          }
          // Used to relieve stack pressure in transmit
          struct ReportData {
            HotVars hotVars; // Only read from storage once
            bytes observers; // ith element is the index of the ith observer
            int192[] observations; // ith element is the ith observation
            bytes vs; // jth element is the v component of the jth signature
            bytes32 rawReportContext;
          }
          /*
           * @notice details about the most recent report
           * @return configDigest domain separation tag for the latest report
           * @return epoch epoch in which the latest report was generated
           * @return round OCR round in which the latest report was generated
           * @return latestAnswer median value from latest report
           * @return latestTimestamp when the latest report was transmitted
           */
          function latestTransmissionDetails()
            external
            view
            returns (
              bytes16 configDigest,
              uint32 epoch,
              uint8 round,
              int192 latestAnswer,
              uint64 latestTimestamp
            )
          {
            require(msg.sender == tx.origin, "Only callable by EOA");
            return (
              s_hotVars.latestConfigDigest,
              uint32(s_hotVars.latestEpochAndRound >> 8),
              uint8(s_hotVars.latestEpochAndRound),
              s_transmissions[s_hotVars.latestAggregatorRoundId].answer,
              s_transmissions[s_hotVars.latestAggregatorRoundId].timestamp
            );
          }
          // The constant-length components of the msg.data sent to transmit.
          // See the "If we wanted to call sam" example on for example reasoning
          // https://solidity.readthedocs.io/en/v0.7.2/abi-spec.html
          uint16 private constant TRANSMIT_MSGDATA_CONSTANT_LENGTH_COMPONENT =
            4 + // function selector
            32 + // word containing start location of abiencoded _report value
            32 + // word containing location start of abiencoded  _rs value
            32 + // word containing start location of abiencoded _ss value
            32 + // _rawVs value
            32 + // word containing length of _report
            32 + // word containing length _rs
            32 + // word containing length of _ss
            0; // placeholder
          function expectedMsgDataLength(
            bytes calldata _report, bytes32[] calldata _rs, bytes32[] calldata _ss
          ) private pure returns (uint256 length)
          {
            // calldata will never be big enough to make this overflow
            return uint256(TRANSMIT_MSGDATA_CONSTANT_LENGTH_COMPONENT) +
              _report.length + // one byte pure entry in _report
              _rs.length * 32 + // 32 bytes per entry in _rs
              _ss.length * 32 + // 32 bytes per entry in _ss
              0; // placeholder
          }
          /**
           * @notice transmit is called to post a new report to the contract
           * @param _report serialized report, which the signatures are signing. See parsing code below for format. The ith element of the observers component must be the index in s_signers of the address for the ith signature
           * @param _rs ith element is the R components of the ith signature on report. Must have at most maxNumOracles entries
           * @param _ss ith element is the S components of the ith signature on report. Must have at most maxNumOracles entries
           * @param _rawVs ith element is the the V component of the ith signature
           */
          function transmit(
            // NOTE: If these parameters are changed, expectedMsgDataLength and/or
            // TRANSMIT_MSGDATA_CONSTANT_LENGTH_COMPONENT need to be changed accordingly
            bytes calldata _report,
            bytes32[] calldata _rs, bytes32[] calldata _ss, bytes32 _rawVs // signatures
          )
            external
          {
            uint256 initialGas = gasleft(); // This line must come first
            // Make sure the transmit message-length matches the inputs. Otherwise, the
            // transmitter could append an arbitrarily long (up to gas-block limit)
            // string of 0 bytes, which we would reimburse at a rate of 16 gas/byte, but
            // which would only cost the transmitter 4 gas/byte. (Appendix G of the
            // yellow paper, p. 25, for G_txdatazero and EIP 2028 for G_txdatanonzero.)
            // This could amount to reimbursement profit of 36 million gas, given a 3MB
            // zero tail.
            require(msg.data.length == expectedMsgDataLength(_report, _rs, _ss),
              "transmit message too long");
            ReportData memory r; // Relieves stack pressure
            {
              r.hotVars = s_hotVars; // cache read from storage
              bytes32 rawObservers;
              (r.rawReportContext, rawObservers, r.observations) = abi.decode(
                _report, (bytes32, bytes32, int192[])
              );
              // rawReportContext consists of:
              // 11-byte zero padding
              // 16-byte configDigest
              // 4-byte epoch
              // 1-byte round
              bytes16 configDigest = bytes16(r.rawReportContext << 88);
              require(
                r.hotVars.latestConfigDigest == configDigest,
                "configDigest mismatch"
              );
              uint40 epochAndRound = uint40(uint256(r.rawReportContext));
              // direct numerical comparison works here, because
              //
              //   ((e,r) <= (e',r')) implies (epochAndRound <= epochAndRound')
              //
              // because alphabetic ordering implies e <= e', and if e = e', then r<=r',
              // so e*256+r <= e'*256+r', because r, r' < 256
              require(r.hotVars.latestEpochAndRound < epochAndRound, "stale report");
              require(_rs.length > r.hotVars.threshold, "not enough signatures");
              require(_rs.length <= maxNumOracles, "too many signatures");
              require(_ss.length == _rs.length, "signatures out of registration");
              require(r.observations.length <= maxNumOracles,
                      "num observations out of bounds");
              require(r.observations.length > 2 * r.hotVars.threshold,
                      "too few values to trust median");
              // Copy signature parities in bytes32 _rawVs to bytes r.v
              r.vs = new bytes(_rs.length);
              for (uint8 i = 0; i < _rs.length; i++) {
                r.vs[i] = _rawVs[i];
              }
              // Copy observer identities in bytes32 rawObservers to bytes r.observers
              r.observers = new bytes(r.observations.length);
              bool[maxNumOracles] memory seen;
              for (uint8 i = 0; i < r.observations.length; i++) {
                uint8 observerIdx = uint8(rawObservers[i]);
                require(!seen[observerIdx], "observer index repeated");
                seen[observerIdx] = true;
                r.observers[i] = rawObservers[i];
              }
              Oracle memory transmitter = s_oracles[msg.sender];
              require( // Check that sender is authorized to report
                transmitter.role == Role.Transmitter &&
                msg.sender == s_transmitters[transmitter.index],
                "unauthorized transmitter"
              );
              // record epochAndRound here, so that we don't have to carry the local
              // variable in transmit. The change is reverted if something fails later.
              r.hotVars.latestEpochAndRound = epochAndRound;
            }
            { // Verify signatures attached to report
              bytes32 h = keccak256(_report);
              bool[maxNumOracles] memory signed;
              Oracle memory o;
              for (uint i = 0; i < _rs.length; i++) {
                address signer = ecrecover(h, uint8(r.vs[i])+27, _rs[i], _ss[i]);
                o = s_oracles[signer];
                require(o.role == Role.Signer, "address not authorized to sign");
                require(!signed[o.index], "non-unique signature");
                signed[o.index] = true;
              }
            }
            { // Check the report contents, and record the result
              for (uint i = 0; i < r.observations.length - 1; i++) {
                bool inOrder = r.observations[i] <= r.observations[i+1];
                require(inOrder, "observations not sorted");
              }
              int192 median = r.observations[r.observations.length/2];
              require(minAnswer <= median && median <= maxAnswer, "median is out of min-max range");
              r.hotVars.latestAggregatorRoundId++;
              s_transmissions[r.hotVars.latestAggregatorRoundId] =
                Transmission(median, uint64(block.timestamp));
              emit NewTransmission(
                r.hotVars.latestAggregatorRoundId,
                median,
                msg.sender,
                r.observations,
                r.observers,
                r.rawReportContext
              );
              // Emit these for backwards compatability with offchain consumers
              // that only support legacy events
              emit NewRound(
                r.hotVars.latestAggregatorRoundId,
                address(0x0), // use zero address since we don't have anybody "starting" the round here
                block.timestamp
              );
              emit AnswerUpdated(
                median,
                r.hotVars.latestAggregatorRoundId,
                block.timestamp
              );
              validateAnswer(r.hotVars.latestAggregatorRoundId, median);
            }
            s_hotVars = r.hotVars;
            assert(initialGas < maxUint32);
            reimburseAndRewardOracles(uint32(initialGas), r.observers);
          }
          /*
           * v2 Aggregator interface
           */
          /**
           * @notice median from the most recent report
           */
          function latestAnswer()
            public
            override
            view
            virtual
            returns (int256)
          {
            return s_transmissions[s_hotVars.latestAggregatorRoundId].answer;
          }
          /**
           * @notice timestamp of block in which last report was transmitted
           */
          function latestTimestamp()
            public
            override
            view
            virtual
            returns (uint256)
          {
            return s_transmissions[s_hotVars.latestAggregatorRoundId].timestamp;
          }
          /**
           * @notice Aggregator round (NOT OCR round) in which last report was transmitted
           */
          function latestRound()
            public
            override
            view
            virtual
            returns (uint256)
          {
            return s_hotVars.latestAggregatorRoundId;
          }
          /**
           * @notice median of report from given aggregator round (NOT OCR round)
           * @param _roundId the aggregator round of the target report
           */
          function getAnswer(uint256 _roundId)
            public
            override
            view
            virtual
            returns (int256)
          {
            if (_roundId > 0xFFFFFFFF) { return 0; }
            return s_transmissions[uint32(_roundId)].answer;
          }
          /**
           * @notice timestamp of block in which report from given aggregator round was transmitted
           * @param _roundId aggregator round (NOT OCR round) of target report
           */
          function getTimestamp(uint256 _roundId)
            public
            override
            view
            virtual
            returns (uint256)
          {
            if (_roundId > 0xFFFFFFFF) { return 0; }
            return s_transmissions[uint32(_roundId)].timestamp;
          }
          /*
           * v3 Aggregator interface
           */
          string constant private V3_NO_DATA_ERROR = "No data present";
          /**
           * @return answers are stored in fixed-point format, with this many digits of precision
           */
          uint8 immutable public override decimals;
          /**
           * @notice aggregator contract version
           */
          uint256 constant public override version = 4;
          string internal s_description;
          /**
           * @notice human-readable description of observable this contract is reporting on
           */
          function description()
            public
            override
            view
            virtual
            returns (string memory)
          {
            return s_description;
          }
          /**
           * @notice details for the given aggregator round
           * @param _roundId target aggregator round (NOT OCR round). Must fit in uint32
           * @return roundId _roundId
           * @return answer median of report from given _roundId
           * @return startedAt timestamp of block in which report from given _roundId was transmitted
           * @return updatedAt timestamp of block in which report from given _roundId was transmitted
           * @return answeredInRound _roundId
           */
          function getRoundData(uint80 _roundId)
            public
            override
            view
            virtual
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            require(_roundId <= 0xFFFFFFFF, V3_NO_DATA_ERROR);
            Transmission memory transmission = s_transmissions[uint32(_roundId)];
            return (
              _roundId,
              transmission.answer,
              transmission.timestamp,
              transmission.timestamp,
              _roundId
            );
          }
          /**
           * @notice aggregator details for the most recently transmitted report
           * @return roundId aggregator round of latest report (NOT OCR round)
           * @return answer median of latest report
           * @return startedAt timestamp of block containing latest report
           * @return updatedAt timestamp of block containing latest report
           * @return answeredInRound aggregator round of latest report
           */
          function latestRoundData()
            public
            override
            view
            virtual
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            )
          {
            roundId = s_hotVars.latestAggregatorRoundId;
            // Skipped for compatability with existing FluxAggregator in which latestRoundData never reverts.
            // require(roundId != 0, V3_NO_DATA_ERROR);
            Transmission memory transmission = s_transmissions[uint32(roundId)];
            return (
              roundId,
              transmission.answer,
              transmission.timestamp,
              transmission.timestamp,
              roundId
            );
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.1;
        import "./SimpleWriteAccessController.sol";
        /**
         * @title SimpleReadAccessController
         * @notice Gives access to:
         * - any externally owned account (note that offchain actors can always read
         * any contract storage regardless of onchain access control measures, so this
         * does not weaken the access control while improving usability)
         * - accounts explicitly added to an access list
         * @dev SimpleReadAccessController is not suitable for access controlling writes
         * since it grants any externally owned account access! See
         * SimpleWriteAccessController for that.
         */
        contract SimpleReadAccessController is SimpleWriteAccessController {
          /**
           * @notice Returns the access of an address
           * @param _user The address to query
           */
          function hasAccess(
            address _user,
            bytes memory _calldata
          )
            public
            view
            virtual
            override
            returns (bool)
          {
            return super.hasAccess(_user, _calldata) || _user == tx.origin;
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        interface AccessControllerInterface {
          function hasAccess(address user, bytes calldata data) external view returns (bool);
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./AggregatorInterface.sol";
        import "./AggregatorV3Interface.sol";
        interface AggregatorV2V3Interface is AggregatorInterface, AggregatorV3Interface
        {
        }// SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        interface AggregatorValidatorInterface {
          function validate(
            uint256 previousRoundId,
            int256 previousAnswer,
            uint256 currentRoundId,
            int256 currentAnswer
          ) external returns (bool);
        }// SPDX-License-Identifier: MIT
        pragma solidity ^0.7.1;
        interface LinkTokenInterface {
          function allowance(address owner, address spender) external view returns (uint256 remaining);
          function approve(address spender, uint256 value) external returns (bool success);
          function balanceOf(address owner) external view returns (uint256 balance);
          function decimals() external view returns (uint8 decimalPlaces);
          function decreaseApproval(address spender, uint256 addedValue) external returns (bool success);
          function increaseApproval(address spender, uint256 subtractedValue) external;
          function name() external view returns (string memory tokenName);
          function symbol() external view returns (string memory tokenSymbol);
          function totalSupply() external view returns (uint256 totalTokensIssued);
          function transfer(address to, uint256 value) external returns (bool success);
          function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool success);
          function transferFrom(address from, address to, uint256 value) external returns (bool success);
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        /**
         * @title The Owned contract
         * @notice A contract with helpers for basic contract ownership.
         */
        contract Owned {
          address payable public owner;
          address private pendingOwner;
          event OwnershipTransferRequested(
            address indexed from,
            address indexed to
          );
          event OwnershipTransferred(
            address indexed from,
            address indexed to
          );
          constructor() {
            owner = msg.sender;
          }
          /**
           * @dev Allows an owner to begin transferring ownership to a new address,
           * pending.
           */
          function transferOwnership(address _to)
            external
            onlyOwner()
          {
            pendingOwner = _to;
            emit OwnershipTransferRequested(owner, _to);
          }
          /**
           * @dev Allows an ownership transfer to be completed by the recipient.
           */
          function acceptOwnership()
            external
          {
            require(msg.sender == pendingOwner, "Must be proposed owner");
            address oldOwner = owner;
            owner = msg.sender;
            pendingOwner = address(0);
            emit OwnershipTransferred(oldOwner, msg.sender);
          }
          /**
           * @dev Reverts if called by anyone other than the contract owner.
           */
          modifier onlyOwner() {
            require(msg.sender == owner, "Only callable by owner");
            _;
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./AccessControllerInterface.sol";
        import "./LinkTokenInterface.sol";
        import "./Owned.sol";
        /**
         * @notice tracks administration of oracle-reward and gas-reimbursement parameters.
         * @dev
         * If you read or change this, be sure to read or adjust the comments. They
         * track the units of the values under consideration, and are crucial to
         * the readability of the operations it specifies.
         * @notice
         * Trust Model:
         * Nothing in this contract prevents a billing admin from setting insane
         * values for the billing parameters in setBilling. Oracles
         * participating in this contract should regularly check that the
         * parameters make sense. Similarly, the outstanding obligations of this
         * contract to the oracles can exceed the funds held by the contract.
         * Oracles participating in this contract should regularly check that it
         * holds sufficient funds and stop interacting with it if funding runs
         * out.
         * This still leaves oracles with some risk due to TOCTOU issues.
         * However, since the sums involved are pretty small (Ethereum
         * transactions aren't that expensive in the end) and an oracle would
         * likely stop participating in a contract it repeatedly lost money on,
         * this risk is deemed acceptable. Oracles should also regularly
         * withdraw any funds in the contract to prevent issues where the
         * contract becomes underfunded at a later time, and different oracles
         * are competing for the left-over funds.
         * Finally, note that any change to the set of oracles or to the billing
         * parameters will trigger payout of all oracles first (using the old
         * parameters), a billing admin cannot take away funds that are already
         * marked for payment.
        */
        contract OffchainAggregatorBilling is Owned {
          // Maximum number of oracles the offchain reporting protocol is designed for
          uint256 constant internal maxNumOracles = 31;
          // Parameters for oracle payments
          struct Billing {
            // Highest compensated gas price, in ETH-gwei uints
            uint32 maximumGasPrice;
            // If gas price is less (in ETH-gwei units), transmitter gets half the savings
            uint32 reasonableGasPrice;
            // Pay transmitter back this much LINK per unit eth spent on gas
            // (1e-6LINK/ETH units)
            uint32 microLinkPerEth;
            // Fixed LINK reward for each observer, in LINK-gwei units
            uint32 linkGweiPerObservation;
            // Fixed reward for transmitter, in linkGweiPerObservation units
            uint32 linkGweiPerTransmission;
          }
          Billing internal s_billing;
          /**
          * @return LINK token contract used for billing
          */
          LinkTokenInterface immutable public LINK;
          AccessControllerInterface internal s_billingAccessController;
          // ith element is number of observation rewards due to ith process, plus one.
          // This is expected to saturate after an oracle has submitted 65,535
          // observations, or about 65535/(3*24*20) = 45 days, given a transmission
          // every 3 minutes.
          //
          // This is always one greater than the actual value, so that when the value is
          // reset to zero, we don't end up with a zero value in storage (which would
          // result in a higher gas cost, the next time the value is incremented.)
          // Calculations using this variable need to take that offset into account.
          uint16[maxNumOracles] internal s_oracleObservationsCounts;
          // Addresses at which oracles want to receive payments, by transmitter address
          mapping (address /* transmitter */ => address /* payment address */)
            internal
            s_payees;
          // Payee addresses which must be approved by the owner
          mapping (address /* transmitter */ => address /* payment address */)
            internal
            s_proposedPayees;
          // LINK-wei-denominated reimbursements for gas used by transmitters.
          //
          // This is always one greater than the actual value, so that when the value is
          // reset to zero, we don't end up with a zero value in storage (which would
          // result in a higher gas cost, the next time the value is incremented.)
          // Calculations using this variable need to take that offset into account.
          //
          // Argument for overflow safety:
          // We have the following maximum intermediate values:
          // - 2**40 additions to this variable (epochAndRound is a uint40)
          // - 2**32 gas price in ethgwei/gas
          // - 1e9 ethwei/ethgwei
          // - 2**32 gas since the block gas limit is at ~20 million
          // - 2**32 (microlink/eth)
          // And we have 2**40 * 2**32 * 1e9 * 2**32 * 2**32 < 2**166
          // (we also divide in some places, but that only makes the value smaller)
          // We can thus safely use uint256 intermediate values for the computation
          // updating this variable.
          uint256[maxNumOracles] internal s_gasReimbursementsLinkWei;
          // Used for s_oracles[a].role, where a is an address, to track the purpose
          // of the address, or to indicate that the address is unset.
          enum Role {
            // No oracle role has been set for address a
            Unset,
            // Signing address for the s_oracles[a].index'th oracle. I.e., report
            // signatures from this oracle should ecrecover back to address a.
            Signer,
            // Transmission address for the s_oracles[a].index'th oracle. I.e., if a
            // report is received by OffchainAggregator.transmit in which msg.sender is
            // a, it is attributed to the s_oracles[a].index'th oracle.
            Transmitter
          }
          struct Oracle {
            uint8 index; // Index of oracle in s_signers/s_transmitters
            Role role;   // Role of the address which mapped to this struct
          }
          mapping (address /* signer OR transmitter address */ => Oracle)
            internal s_oracles;
          // s_signers contains the signing address of each oracle
          address[] internal s_signers;
          // s_transmitters contains the transmission address of each oracle,
          // i.e. the address the oracle actually sends transactions to the contract from
          address[] internal s_transmitters;
          uint256 constant private  maxUint16 = (1 << 16) - 1;
          uint256 constant internal maxUint128 = (1 << 128) - 1;
          constructor(
            uint32 _maximumGasPrice,
            uint32 _reasonableGasPrice,
            uint32 _microLinkPerEth,
            uint32 _linkGweiPerObservation,
            uint32 _linkGweiPerTransmission,
            address _link,
            AccessControllerInterface _billingAccessController
          )
          {
            setBillingInternal(_maximumGasPrice, _reasonableGasPrice, _microLinkPerEth,
              _linkGweiPerObservation, _linkGweiPerTransmission);
            setBillingAccessControllerInternal(_billingAccessController);
            LINK = LinkTokenInterface(_link);
            uint16[maxNumOracles] memory counts; // See s_oracleObservationsCounts docstring
            uint256[maxNumOracles] memory gas; // see s_gasReimbursementsLinkWei docstring
            for (uint8 i = 0; i < maxNumOracles; i++) {
              counts[i] = 1;
              gas[i] = 1;
            }
            s_oracleObservationsCounts = counts;
            s_gasReimbursementsLinkWei = gas;
          }
          /**
           * @notice emitted when billing parameters are set
           * @param maximumGasPrice highest gas price for which transmitter will be compensated
           * @param reasonableGasPrice transmitter will receive reward for gas prices under this value
           * @param microLinkPerEth reimbursement per ETH of gas cost, in 1e-6LINK units
           * @param linkGweiPerObservation reward to oracle for contributing an observation to a successfully transmitted report, in 1e-9LINK units
           * @param linkGweiPerTransmission reward to transmitter of a successful report, in 1e-9LINK units
           */
          event BillingSet(
            uint32 maximumGasPrice,
            uint32 reasonableGasPrice,
            uint32 microLinkPerEth,
            uint32 linkGweiPerObservation,
            uint32 linkGweiPerTransmission
          );
          function setBillingInternal(
            uint32 _maximumGasPrice,
            uint32 _reasonableGasPrice,
            uint32 _microLinkPerEth,
            uint32 _linkGweiPerObservation,
            uint32 _linkGweiPerTransmission
          )
            internal
          {
            s_billing = Billing(_maximumGasPrice, _reasonableGasPrice, _microLinkPerEth,
              _linkGweiPerObservation, _linkGweiPerTransmission);
            emit BillingSet(_maximumGasPrice, _reasonableGasPrice, _microLinkPerEth,
              _linkGweiPerObservation, _linkGweiPerTransmission);
          }
          /**
           * @notice sets billing parameters
           * @param _maximumGasPrice highest gas price for which transmitter will be compensated
           * @param _reasonableGasPrice transmitter will receive reward for gas prices under this value
           * @param _microLinkPerEth reimbursement per ETH of gas cost, in 1e-6LINK units
           * @param _linkGweiPerObservation reward to oracle for contributing an observation to a successfully transmitted report, in 1e-9LINK units
           * @param _linkGweiPerTransmission reward to transmitter of a successful report, in 1e-9LINK units
           * @dev access control provided by billingAccessController
           */
          function setBilling(
            uint32 _maximumGasPrice,
            uint32 _reasonableGasPrice,
            uint32 _microLinkPerEth,
            uint32 _linkGweiPerObservation,
            uint32 _linkGweiPerTransmission
          )
            external
          {
            AccessControllerInterface access = s_billingAccessController;
            require(msg.sender == owner || access.hasAccess(msg.sender, msg.data),
              "Only owner&billingAdmin can call");
            payOracles();
            setBillingInternal(_maximumGasPrice, _reasonableGasPrice, _microLinkPerEth,
              _linkGweiPerObservation, _linkGweiPerTransmission);
          }
          /**
           * @notice gets billing parameters
           * @param maximumGasPrice highest gas price for which transmitter will be compensated
           * @param reasonableGasPrice transmitter will receive reward for gas prices under this value
           * @param microLinkPerEth reimbursement per ETH of gas cost, in 1e-6LINK units
           * @param linkGweiPerObservation reward to oracle for contributing an observation to a successfully transmitted report, in 1e-9LINK units
           * @param linkGweiPerTransmission reward to transmitter of a successful report, in 1e-9LINK units
           */
          function getBilling()
            external
            view
            returns (
              uint32 maximumGasPrice,
              uint32 reasonableGasPrice,
              uint32 microLinkPerEth,
              uint32 linkGweiPerObservation,
              uint32 linkGweiPerTransmission
            )
          {
            Billing memory billing = s_billing;
            return (
              billing.maximumGasPrice,
              billing.reasonableGasPrice,
              billing.microLinkPerEth,
              billing.linkGweiPerObservation,
              billing.linkGweiPerTransmission
            );
          }
          /**
           * @notice emitted when a new access-control contract is set
           * @param old the address prior to the current setting
           * @param current the address of the new access-control contract
           */
          event BillingAccessControllerSet(AccessControllerInterface old, AccessControllerInterface current);
          function setBillingAccessControllerInternal(AccessControllerInterface _billingAccessController)
            internal
          {
            AccessControllerInterface oldController = s_billingAccessController;
            if (_billingAccessController != oldController) {
              s_billingAccessController = _billingAccessController;
              emit BillingAccessControllerSet(
                oldController,
                _billingAccessController
              );
            }
          }
          /**
           * @notice sets billingAccessController
           * @param _billingAccessController new billingAccessController contract address
           * @dev only owner can call this
           */
          function setBillingAccessController(AccessControllerInterface _billingAccessController)
            external
            onlyOwner
          {
            setBillingAccessControllerInternal(_billingAccessController);
          }
          /**
           * @notice gets billingAccessController
           * @return address of billingAccessController contract
           */
          function billingAccessController()
            external
            view
            returns (AccessControllerInterface)
          {
            return s_billingAccessController;
          }
          /**
           * @notice withdraws an oracle's payment from the contract
           * @param _transmitter the transmitter address of the oracle
           * @dev must be called by oracle's payee address
           */
          function withdrawPayment(address _transmitter)
            external
          {
            require(msg.sender == s_payees[_transmitter], "Only payee can withdraw");
            payOracle(_transmitter);
          }
          /**
           * @notice query an oracle's payment amount
           * @param _transmitter the transmitter address of the oracle
           */
          function owedPayment(address _transmitter)
            public
            view
            returns (uint256)
          {
            Oracle memory oracle = s_oracles[_transmitter];
            if (oracle.role == Role.Unset) { return 0; }
            Billing memory billing = s_billing;
            uint256 linkWeiAmount =
              uint256(s_oracleObservationsCounts[oracle.index] - 1) *
              uint256(billing.linkGweiPerObservation) *
              (1 gwei);
            linkWeiAmount += s_gasReimbursementsLinkWei[oracle.index] - 1;
            return linkWeiAmount;
          }
          /**
           * @notice emitted when an oracle has been paid LINK
           * @param transmitter address from which the oracle sends reports to the transmit method
           * @param payee address to which the payment is sent
           * @param amount amount of LINK sent
           */
          event OraclePaid(address transmitter, address payee, uint256 amount);
          // payOracle pays out _transmitter's balance to the corresponding payee, and zeros it out
          function payOracle(address _transmitter)
            internal
          {
            Oracle memory oracle = s_oracles[_transmitter];
            uint256 linkWeiAmount = owedPayment(_transmitter);
            if (linkWeiAmount > 0) {
              address payee = s_payees[_transmitter];
              // Poses no re-entrancy issues, because LINK.transfer does not yield
              // control flow.
              require(LINK.transfer(payee, linkWeiAmount), "insufficient funds");
              s_oracleObservationsCounts[oracle.index] = 1; // "zero" the counts. see var's docstring
              s_gasReimbursementsLinkWei[oracle.index] = 1; // "zero" the counts. see var's docstring
              emit OraclePaid(_transmitter, payee, linkWeiAmount);
            }
          }
          // payOracles pays out all transmitters, and zeros out their balances.
          //
          // It's much more gas-efficient to do this as a single operation, to avoid
          // hitting storage too much.
          function payOracles()
            internal
          {
            Billing memory billing = s_billing;
            uint16[maxNumOracles] memory observationsCounts = s_oracleObservationsCounts;
            uint256[maxNumOracles] memory gasReimbursementsLinkWei =
              s_gasReimbursementsLinkWei;
            address[] memory transmitters = s_transmitters;
            for (uint transmitteridx = 0; transmitteridx < transmitters.length; transmitteridx++) {
              uint256 reimbursementAmountLinkWei = gasReimbursementsLinkWei[transmitteridx] - 1;
              uint256 obsCount = observationsCounts[transmitteridx] - 1;
              uint256 linkWeiAmount =
                obsCount * uint256(billing.linkGweiPerObservation) * (1 gwei) + reimbursementAmountLinkWei;
              if (linkWeiAmount > 0) {
                  address payee = s_payees[transmitters[transmitteridx]];
                  // Poses no re-entrancy issues, because LINK.transfer does not yield
                  // control flow.
                  require(LINK.transfer(payee, linkWeiAmount), "insufficient funds");
                  observationsCounts[transmitteridx] = 1;       // "zero" the counts.
                  gasReimbursementsLinkWei[transmitteridx] = 1; // "zero" the counts.
                  emit OraclePaid(transmitters[transmitteridx], payee, linkWeiAmount);
                }
            }
            // "Zero" the accounting storage variables
            s_oracleObservationsCounts = observationsCounts;
            s_gasReimbursementsLinkWei = gasReimbursementsLinkWei;
          }
          function oracleRewards(
            bytes memory observers,
            uint16[maxNumOracles] memory observations
          )
            internal
            pure
            returns (uint16[maxNumOracles] memory)
          {
            // reward each observer-participant with the observer reward
            for (uint obsIdx = 0; obsIdx < observers.length; obsIdx++) {
              uint8 observer = uint8(observers[obsIdx]);
              observations[observer] = saturatingAddUint16(observations[observer], 1);
            }
            return observations;
          }
          // This value needs to change if maxNumOracles is increased, or the accounting
          // calculations at the bottom of reimburseAndRewardOracles change.
          //
          // To recalculate it, run the profiler as described in
          // ../../profile/README.md, and add up the gas-usage values reported for the
          // lines in reimburseAndRewardOracles following the "gasLeft = gasleft()"
          // line. E.g., you will see output like this:
          //
          //      7        uint256 gasLeft = gasleft();
          //     29        uint256 gasCostEthWei = transmitterGasCostEthWei(
          //      9          uint256(initialGas),
          //      3          gasPrice,
          //      3          callDataGasCost,
          //      3          gasLeft
          //      .
          //      .
          //      .
          //     59        uint256 gasCostLinkWei = (gasCostEthWei * billing.microLinkPerEth)/ 1e6;
          //      .
          //      .
          //      .
          //   5047        s_gasReimbursementsLinkWei[txOracle.index] =
          //    856          s_gasReimbursementsLinkWei[txOracle.index] + gasCostLinkWei +
          //     26          uint256(billing.linkGweiPerTransmission) * (1 gwei);
          //
          // If those were the only lines to be accounted for, you would add up
          // 29+9+3+3+3+59+5047+856+26=6035.
          uint256 internal constant accountingGasCost = 6035;
          // Uncomment the following declaration to compute the remaining gas cost after
          // above gasleft(). (This must exist in a base class to OffchainAggregator, so
          // it can't go in TestOffchainAggregator.)
          //
          // uint256 public gasUsedInAccounting;
          // Gas price at which the transmitter should be reimbursed, in ETH-gwei/gas
          function impliedGasPrice(
            uint256 txGasPrice,         // ETH-gwei/gas units
            uint256 reasonableGasPrice, // ETH-gwei/gas units
            uint256 maximumGasPrice     // ETH-gwei/gas units
          )
            internal
            pure
            returns (uint256)
          {
            // Reward the transmitter for choosing an efficient gas price: if they manage
            // to come in lower than considered reasonable, give them half the savings.
            //
            // The following calculations are all in units of gwei/gas, i.e. 1e-9ETH/gas
            uint256 gasPrice = txGasPrice;
            if (txGasPrice < reasonableGasPrice) {
              // Give transmitter half the savings for coming in under the reasonable gas price
              gasPrice += (reasonableGasPrice - txGasPrice) / 2;
            }
            // Don't reimburse a gas price higher than maximumGasPrice
            return min(gasPrice, maximumGasPrice);
          }
          // gas reimbursement due the transmitter, in ETH-wei
          //
          // If this function is changed, accountingGasCost needs to change, too. See
          // its docstring
          function transmitterGasCostEthWei(
            uint256 initialGas,
            uint256 gasPrice, // ETH-gwei/gas units
            uint256 callDataCost, // gas units
            uint256 gasLeft
          )
            internal
            pure
            returns (uint128 gasCostEthWei)
          {
            require(initialGas >= gasLeft, "gasLeft cannot exceed initialGas");
            uint256 gasUsed = // gas units
              initialGas - gasLeft + // observed gas usage
              callDataCost + accountingGasCost; // estimated gas usage
            // gasUsed is in gas units, gasPrice is in ETH-gwei/gas units; convert to ETH-wei
            uint256 fullGasCostEthWei = gasUsed * gasPrice * (1 gwei);
            assert(fullGasCostEthWei < maxUint128); // the entire ETH supply fits in a uint128...
            return uint128(fullGasCostEthWei);
          }
          /**
           * @notice withdraw any available funds left in the contract, up to _amount, after accounting for the funds due to participants in past reports
           * @param _recipient address to send funds to
           * @param _amount maximum amount to withdraw, denominated in LINK-wei.
           * @dev access control provided by billingAccessController
           */
          function withdrawFunds(address _recipient, uint256 _amount)
            external
          {
            require(msg.sender == owner || s_billingAccessController.hasAccess(msg.sender, msg.data),
              "Only owner&billingAdmin can call");
            uint256 linkDue = totalLINKDue();
            uint256 linkBalance = LINK.balanceOf(address(this));
            require(linkBalance >= linkDue, "insufficient balance");
            require(LINK.transfer(_recipient, min(linkBalance - linkDue, _amount)), "insufficient funds");
          }
          // Total LINK due to participants in past reports.
          function totalLINKDue()
            internal
            view
            returns (uint256 linkDue)
          {
            // Argument for overflow safety: We do all computations in
            // uint256s. The inputs to linkDue are:
            // - the <= 31 observation rewards each of which has less than
            //   64 bits (32 bits for billing.linkGweiPerObservation, 32 bits
            //   for wei/gwei conversion). Hence 69 bits are sufficient for this part.
            // - the <= 31 gas reimbursements, each of which consists of at most 166
            //   bits (see s_gasReimbursementsLinkWei docstring). Hence 171 bits are
            //   sufficient for this part
            // In total, 172 bits are enough.
            uint16[maxNumOracles] memory observationCounts = s_oracleObservationsCounts;
            for (uint i = 0; i < maxNumOracles; i++) {
              linkDue += observationCounts[i] - 1; // Stored value is one greater than actual value
            }
            Billing memory billing = s_billing;
            // Convert linkGweiPerObservation to uint256, or this overflows!
            linkDue *= uint256(billing.linkGweiPerObservation) * (1 gwei);
            address[] memory transmitters = s_transmitters;
            uint256[maxNumOracles] memory gasReimbursementsLinkWei =
              s_gasReimbursementsLinkWei;
            for (uint i = 0; i < transmitters.length; i++) {
              linkDue += uint256(gasReimbursementsLinkWei[i]-1); // Stored value is one greater than actual value
            }
          }
          /**
           * @notice allows oracles to check that sufficient LINK balance is available
           * @return availableBalance LINK available on this contract, after accounting for outstanding obligations. can become negative
           */
          function linkAvailableForPayment()
            external
            view
            returns (int256 availableBalance)
          {
            // there are at most one billion LINK, so this cast is safe
            int256 balance = int256(LINK.balanceOf(address(this)));
            // according to the argument in the definition of totalLINKDue,
            // totalLINKDue is never greater than 2**172, so this cast is safe
            int256 due = int256(totalLINKDue());
            // safe from overflow according to above sizes
            return int256(balance) - int256(due);
          }
          /**
           * @notice number of observations oracle is due to be reimbursed for
           * @param _signerOrTransmitter address used by oracle for signing or transmitting reports
           */
          function oracleObservationCount(address _signerOrTransmitter)
            external
            view
            returns (uint16)
          {
            Oracle memory oracle = s_oracles[_signerOrTransmitter];
            if (oracle.role == Role.Unset) { return 0; }
            return s_oracleObservationsCounts[oracle.index] - 1;
          }
          function reimburseAndRewardOracles(
            uint32 initialGas,
            bytes memory observers
          )
            internal
          {
            Oracle memory txOracle = s_oracles[msg.sender];
            Billing memory billing = s_billing;
            // Reward oracles for providing observations. Oracles are not rewarded
            // for providing signatures, because signing is essentially free.
            s_oracleObservationsCounts =
              oracleRewards(observers, s_oracleObservationsCounts);
            // Reimburse transmitter of the report for gas usage
            require(txOracle.role == Role.Transmitter,
              "sent by undesignated transmitter"
            );
            uint256 gasPrice = impliedGasPrice(
              tx.gasprice / (1 gwei), // convert to ETH-gwei units
              billing.reasonableGasPrice,
              billing.maximumGasPrice
            );
            // The following is only an upper bound, as it ignores the cheaper cost for
            // 0 bytes. Safe from overflow, because calldata just isn't that long.
            uint256 callDataGasCost = 16 * msg.data.length;
            // If any changes are made to subsequent calculations, accountingGasCost
            // needs to change, too.
            uint256 gasLeft = gasleft();
            uint256 gasCostEthWei = transmitterGasCostEthWei(
              uint256(initialGas),
              gasPrice,
              callDataGasCost,
              gasLeft
            );
            // microLinkPerEth is 1e-6LINK/ETH units, gasCostEthWei is 1e-18ETH units
            // (ETH-wei), product is 1e-24LINK-wei units, dividing by 1e6 gives
            // 1e-18LINK units, i.e. LINK-wei units
            // Safe from over/underflow, since all components are non-negative,
            // gasCostEthWei will always fit into uint128 and microLinkPerEth is a
            // uint32 (128+32 < 256!).
            uint256 gasCostLinkWei = (gasCostEthWei * billing.microLinkPerEth)/ 1e6;
            // Safe from overflow, because gasCostLinkWei < 2**160 and
            // billing.linkGweiPerTransmission * (1 gwei) < 2**64 and we increment
            // s_gasReimbursementsLinkWei[txOracle.index] at most 2**40 times.
            s_gasReimbursementsLinkWei[txOracle.index] =
              s_gasReimbursementsLinkWei[txOracle.index] + gasCostLinkWei +
              uint256(billing.linkGweiPerTransmission) * (1 gwei); // convert from linkGwei to linkWei
            // Uncomment next line to compute the remaining gas cost after above gasleft().
            // See OffchainAggregatorBilling.accountingGasCost docstring for more information.
            //
            // gasUsedInAccounting = gasLeft - gasleft();
          }
          /*
           * Payee management
           */
          /**
           * @notice emitted when a transfer of an oracle's payee address has been initiated
           * @param transmitter address from which the oracle sends reports to the transmit method
           * @param current the payeee address for the oracle, prior to this setting
           * @param proposed the proposed new payee address for the oracle
           */
          event PayeeshipTransferRequested(
            address indexed transmitter,
            address indexed current,
            address indexed proposed
          );
          /**
           * @notice emitted when a transfer of an oracle's payee address has been completed
           * @param transmitter address from which the oracle sends reports to the transmit method
           * @param current the payeee address for the oracle, prior to this setting
           */
          event PayeeshipTransferred(
            address indexed transmitter,
            address indexed previous,
            address indexed current
          );
          /**
           * @notice sets the payees for transmitting addresses
           * @param _transmitters addresses oracles use to transmit the reports
           * @param _payees addresses of payees corresponding to list of transmitters
           * @dev must be called by owner
           * @dev cannot be used to change payee addresses, only to initially populate them
           */
          function setPayees(
            address[] calldata _transmitters,
            address[] calldata _payees
          )
            external
            onlyOwner()
          {
            require(_transmitters.length == _payees.length, "transmitters.size != payees.size");
            for (uint i = 0; i < _transmitters.length; i++) {
              address transmitter = _transmitters[i];
              address payee = _payees[i];
              address currentPayee = s_payees[transmitter];
              bool zeroedOut = currentPayee == address(0);
              require(zeroedOut || currentPayee == payee, "payee already set");
              s_payees[transmitter] = payee;
              if (currentPayee != payee) {
                emit PayeeshipTransferred(transmitter, currentPayee, payee);
              }
            }
          }
          /**
           * @notice first step of payeeship transfer (safe transfer pattern)
           * @param _transmitter transmitter address of oracle whose payee is changing
           * @param _proposed new payee address
           * @dev can only be called by payee address
           */
          function transferPayeeship(
            address _transmitter,
            address _proposed
          )
            external
          {
              require(msg.sender == s_payees[_transmitter], "only current payee can update");
              require(msg.sender != _proposed, "cannot transfer to self");
              address previousProposed = s_proposedPayees[_transmitter];
              s_proposedPayees[_transmitter] = _proposed;
              if (previousProposed != _proposed) {
                emit PayeeshipTransferRequested(_transmitter, msg.sender, _proposed);
              }
          }
          /**
           * @notice second step of payeeship transfer (safe transfer pattern)
           * @param _transmitter transmitter address of oracle whose payee is changing
           * @dev can only be called by proposed new payee address
           */
          function acceptPayeeship(
            address _transmitter
          )
            external
          {
            require(msg.sender == s_proposedPayees[_transmitter], "only proposed payees can accept");
            address currentPayee = s_payees[_transmitter];
            s_payees[_transmitter] = msg.sender;
            s_proposedPayees[_transmitter] = address(0);
            emit PayeeshipTransferred(_transmitter, currentPayee, msg.sender);
          }
          /*
           * Helper functions
           */
          function saturatingAddUint16(uint16 _x, uint16 _y)
            internal
            pure
            returns (uint16)
          {
            return uint16(min(uint256(_x)+uint256(_y), maxUint16));
          }
          function min(uint256 a, uint256 b)
            internal
            pure
            returns (uint256)
          {
            if (a < b) { return a; }
            return b;
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        abstract contract TypeAndVersionInterface{
          function typeAndVersion()
            external
            pure
            virtual
            returns (string memory);
        }// SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        interface AggregatorInterface {
          function latestAnswer() external view returns (int256);
          function latestTimestamp() external view returns (uint256);
          function latestRound() external view returns (uint256);
          function getAnswer(uint256 roundId) external view returns (int256);
          function getTimestamp(uint256 roundId) external view returns (uint256);
          event AnswerUpdated(int256 indexed current, uint256 indexed roundId, uint256 updatedAt);
          event NewRound(uint256 indexed roundId, address indexed startedBy, uint256 startedAt);
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        interface AggregatorV3Interface {
          function decimals() external view returns (uint8);
          function description() external view returns (string memory);
          function version() external view returns (uint256);
          // getRoundData and latestRoundData should both raise "No data present"
          // if they do not have data to report, instead of returning unset values
          // which could be misinterpreted as actual reported values.
          function getRoundData(uint80 _roundId)
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
          function latestRoundData()
            external
            view
            returns (
              uint80 roundId,
              int256 answer,
              uint256 startedAt,
              uint256 updatedAt,
              uint80 answeredInRound
            );
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./Owned.sol";
        import "./AccessControllerInterface.sol";
        /**
         * @title SimpleWriteAccessController
         * @notice Gives access to accounts explicitly added to an access list by the
         * controller's owner.
         * @dev does not make any special permissions for externally, see
         * SimpleReadAccessController for that.
         */
        contract SimpleWriteAccessController is AccessControllerInterface, Owned {
          bool public checkEnabled;
          mapping(address => bool) internal accessList;
          event AddedAccess(address user);
          event RemovedAccess(address user);
          event CheckAccessEnabled();
          event CheckAccessDisabled();
          constructor()
          {
            checkEnabled = true;
          }
          /**
           * @notice Returns the access of an address
           * @param _user The address to query
           */
          function hasAccess(
            address _user,
            bytes memory
          )
            public
            view
            virtual
            override
            returns (bool)
          {
            return accessList[_user] || !checkEnabled;
          }
          /**
           * @notice Adds an address to the access list
           * @param _user The address to add
           */
          function addAccess(address _user) external onlyOwner() {
            addAccessInternal(_user);
          }
          function addAccessInternal(address _user) internal {
            if (!accessList[_user]) {
              accessList[_user] = true;
              emit AddedAccess(_user);
            }
          }
          /**
           * @notice Removes an address from the access list
           * @param _user The address to remove
           */
          function removeAccess(address _user)
            external
            onlyOwner()
          {
            if (accessList[_user]) {
              accessList[_user] = false;
              emit RemovedAccess(_user);
            }
          }
          /**
           * @notice makes the access check enforced
           */
          function enableAccessCheck()
            external
            onlyOwner()
          {
            if (!checkEnabled) {
              checkEnabled = true;
              emit CheckAccessEnabled();
            }
          }
          /**
           * @notice makes the access check unenforced
           */
          function disableAccessCheck()
            external
            onlyOwner()
          {
            if (checkEnabled) {
              checkEnabled = false;
              emit CheckAccessDisabled();
            }
          }
          /**
           * @dev reverts if the caller does not have access
           */
          modifier checkAccess() {
            require(hasAccess(msg.sender, msg.data), "No access");
            _;
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./AccessControlledOffchainAggregator.sol";
        import "./AccessControlTestHelper.sol";
        contract TestOffchainAggregator is AccessControlledOffchainAggregator {
          function testDecodeReport(
            bytes memory report
          ) public pure returns (bytes32, bytes32, int192[] memory)
          {
            return decodeReport(report);
          }
          constructor(
            uint32 _maximumGasPrice,
            uint32 _reasonableGasPrice,
            uint32 _microLinkPerEth,
            uint32 _linkGweiPerObservation,
            uint32 _linkGweiPerTransmission,
            address _link,
            int192 _minAnswer, int192 _maxAnswer,
            AccessControllerInterface _billingAccessController,
            AccessControllerInterface _requesterAdminAccessController
          )
            AccessControlledOffchainAggregator(_maximumGasPrice, _reasonableGasPrice, _microLinkPerEth,
              _linkGweiPerObservation, _linkGweiPerTransmission, _link,
              _minAnswer, _maxAnswer, _billingAccessController, _requesterAdminAccessController, 0, "TEST"
            )
          {}
          function testPayee(
            address _transmitter
          )
            external
            view
            returns (address)
          {
            return s_payees[_transmitter];
          }
          function getConfigDigest() public view returns (bytes16) {
            return s_hotVars.latestConfigDigest;
          }
          function testSaturatingAddUint16(uint16 _x, uint16 _y)
            external pure returns (uint16)
          {
            return saturatingAddUint16(_x, _y);
          }
          function testImpliedGasPrice(uint256 txGasPrice, uint256 reasonableGasPrice,
            uint256 maximumGasPrice
          ) external pure returns (uint256) {
            return impliedGasPrice(txGasPrice, reasonableGasPrice, maximumGasPrice);
          }
          function testTransmitterGasCostEthWei(uint256 initialGas, uint256 gasPrice,
            uint256 callDataCost, uint256 gasLeft
          ) external pure returns (uint128) {
            return transmitterGasCostEthWei(
              initialGas, gasPrice, callDataCost, gasLeft
            );
          }
          function testSetOracleObservationCount(address _oracle, uint16 _amount) external {
            s_oracleObservationsCounts[s_oracles[_oracle].index] = _amount + 1;
          }
          function testTotalLinkDue()
            external view returns (uint256 linkDue)
          {
            return totalLINKDue();
          }
          function billingData() external view returns (
            uint16[maxNumOracles] memory observationsCounts,
            uint256[maxNumOracles] memory gasReimbursements,
            uint32 maximumGasPrice,
            uint32 reasonableGasPrice,
            uint32 microLinkPerEth,
            uint32 linkGweiPerObservation,
            uint32 linkGweiPerTransmission
          ) {
            Billing memory b = s_billing;
            return (s_oracleObservationsCounts, s_gasReimbursementsLinkWei,
              b.maximumGasPrice, b.reasonableGasPrice, b.microLinkPerEth,
              b.linkGweiPerObservation, b.linkGweiPerTransmission);
          }
          function testSetGasReimbursements(address _transmitterOrSigner, uint256 _amountLinkWei)
            external
          {
            require(s_oracles[_transmitterOrSigner].role != Role.Unset, "address unknown");
            s_gasReimbursementsLinkWei[s_oracles[_transmitterOrSigner].index] = _amountLinkWei + 1;
          }
          function testAccountingGasCost() public pure returns (uint256) {
            return accountingGasCost;
          }
          function testBurnLINK(uint256 amount) public {
              LINK.transfer(address(1), amount);
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.1;
        import "./AccessControlledOffchainAggregator.sol";
        contract AccessControlTestHelper {
          event Dummy(); // Used to silence warning that these methods are pure
          function readGetRoundData(address _aggregator, uint80 _roundID)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).getRoundData(_roundID);
            emit Dummy();
          }
          function readLatestRoundData(address _aggregator)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).latestRoundData();
            emit Dummy();
          }
          function readLatestAnswer(address _aggregator)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).latestAnswer();
            emit Dummy();
          }
          function readLatestTimestamp(address _aggregator)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).latestTimestamp();
            emit Dummy();
          }
          function readLatestRound(address _aggregator)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).latestRound();
            emit Dummy();
          }
          function readGetAnswer(address _aggregator, uint256 _roundID)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).getAnswer(_roundID);
            emit Dummy();
          }
          function readGetTimestamp(address _aggregator, uint256 _roundID)
            external
          {
            AccessControlledOffchainAggregator(_aggregator).getTimestamp(_roundID);
            emit Dummy();
          }
          function testLatestTransmissionDetails(address _aggregator) external view {
              OffchainAggregator(_aggregator).latestTransmissionDetails();
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./OffchainAggregator.sol";
        // ExposedOffchainAggregator exposes certain internal OffchainAggregator
        // methods/structures so that golang code can access them, and we get
        // reliable type checking on their usage
        contract ExposedOffchainAggregator is OffchainAggregator {
          constructor()
            OffchainAggregator(
              0, 0, 0, 0, 0, address(0), 0, 0, AccessControllerInterface(address(0)), AccessControllerInterface(address(0)), 0, ""
            )
            {}
          function exposedConfigDigestFromConfigData(
            address _contractAddress,
            uint64 _configCount,
            address[] calldata _signers,
            address[] calldata _transmitters,
            uint8 _threshold,
            uint64 _encodedConfigVersion,
            bytes calldata _encodedConfig
          ) external pure returns (bytes16) {
            return configDigestFromConfigData(_contractAddress, _configCount,
              _signers, _transmitters, _threshold, _encodedConfigVersion,
              _encodedConfig);
          }
        }
        // SPDX-License-Identifier: MIT
        pragma solidity ^0.7.0;
        import "./AggregatorValidatorInterface.sol";
        contract TestValidator is AggregatorValidatorInterface {
          uint32 s_minGasUse;
          uint256 s_latestRoundId;
          event Validated(
            uint256 previousRoundId,
            int256 previousAnswer,
            uint256 currentRoundId,
            int256 currentAnswer,
            uint256 initialGas
          );
          function validate(
            uint256 previousRoundId,
            int256 previousAnswer,
            uint256 currentRoundId,
            int256 currentAnswer
          ) external override returns (bool) {
            uint256 initialGas = gasleft();
            emit Validated(
              previousRoundId,
              previousAnswer,
              currentRoundId,
              currentAnswer,
              initialGas
            );
            s_latestRoundId = currentRoundId;
            uint256 minGasUse = s_minGasUse;
            while (initialGas - gasleft() < minGasUse) {}
            return true;
          }
          function setMinGasUse(uint32 minGasUse) external {
            s_minGasUse = minGasUse;
          }
          function latestRoundId() external view returns (uint256) {
            return s_latestRoundId;
          }
        }
        

        File 7 of 8: Flags
        pragma solidity 0.6.6;
        
        /**
         * @title The Owned contract
         * @notice A contract with helpers for basic contract ownership.
         */
        contract Owned {
        
          address payable public owner;
          address private pendingOwner;
        
          event OwnershipTransferRequested(
            address indexed from,
            address indexed to
          );
          event OwnershipTransferred(
            address indexed from,
            address indexed to
          );
        
          constructor() public {
            owner = msg.sender;
          }
        
          /**
           * @dev Allows an owner to begin transferring ownership to a new address,
           * pending.
           */
          function transferOwnership(address _to)
            external
            onlyOwner()
          {
            pendingOwner = _to;
        
            emit OwnershipTransferRequested(owner, _to);
          }
        
          /**
           * @dev Allows an ownership transfer to be completed by the recipient.
           */
          function acceptOwnership()
            external
          {
            require(msg.sender == pendingOwner, "Must be proposed owner");
        
            address oldOwner = owner;
            owner = msg.sender;
            pendingOwner = address(0);
        
            emit OwnershipTransferred(oldOwner, msg.sender);
          }
        
          /**
           * @dev Reverts if called by anyone other than the contract owner.
           */
          modifier onlyOwner() {
            require(msg.sender == owner, "Only callable by owner");
            _;
          }
        
        }
        
        
        interface FlagsInterface {
          function getFlag(address) external view returns (bool);
          function getFlags(address[] calldata) external view returns (bool[] memory);
          function raiseFlag(address) external;
          function raiseFlags(address[] calldata) external;
          function lowerFlags(address[] calldata) external;
          function setRaisingAccessController(address) external;
        }
        
        
        interface AccessControllerInterface {
          function hasAccess(address user, bytes calldata data) external view returns (bool);
        }
        
        
        
        
        
        
        
        
        
        
        /**
         * @title SimpleWriteAccessController
         * @notice Gives access to accounts explicitly added to an access list by the
         * controller's owner.
         * @dev does not make any special permissions for externally, see
         * SimpleReadAccessController for that.
         */
        contract SimpleWriteAccessController is AccessControllerInterface, Owned {
        
          bool public checkEnabled;
          mapping(address => bool) internal accessList;
        
          event AddedAccess(address user);
          event RemovedAccess(address user);
          event CheckAccessEnabled();
          event CheckAccessDisabled();
        
          constructor()
            public
          {
            checkEnabled = true;
          }
        
          /**
           * @notice Returns the access of an address
           * @param _user The address to query
           */
          function hasAccess(
            address _user,
            bytes memory
          )
            public
            view
            virtual
            override
            returns (bool)
          {
            return accessList[_user] || !checkEnabled;
          }
        
          /**
           * @notice Adds an address to the access list
           * @param _user The address to add
           */
          function addAccess(address _user)
            external
            onlyOwner()
          {
            if (!accessList[_user]) {
              accessList[_user] = true;
        
              emit AddedAccess(_user);
            }
          }
        
          /**
           * @notice Removes an address from the access list
           * @param _user The address to remove
           */
          function removeAccess(address _user)
            external
            onlyOwner()
          {
            if (accessList[_user]) {
              accessList[_user] = false;
        
              emit RemovedAccess(_user);
            }
          }
        
          /**
           * @notice makes the access check enforced
           */
          function enableAccessCheck()
            external
            onlyOwner()
          {
            if (!checkEnabled) {
              checkEnabled = true;
        
              emit CheckAccessEnabled();
            }
          }
        
          /**
           * @notice makes the access check unenforced
           */
          function disableAccessCheck()
            external
            onlyOwner()
          {
            if (checkEnabled) {
              checkEnabled = false;
        
              emit CheckAccessDisabled();
            }
          }
        
          /**
           * @dev reverts if the caller does not have access
           */
          modifier checkAccess() {
            require(hasAccess(msg.sender, msg.data), "No access");
            _;
          }
        }
        
        
        /**
         * @title SimpleReadAccessController
         * @notice Gives access to:
         * - any externally owned account (note that offchain actors can always read
         * any contract storage regardless of onchain access control measures, so this
         * does not weaken the access control while improving usability)
         * - accounts explicitly added to an access list
         * @dev SimpleReadAccessController is not suitable for access controlling writes
         * since it grants any externally owned account access! See
         * SimpleWriteAccessController for that.
         */
        contract SimpleReadAccessController is SimpleWriteAccessController {
        
          /**
           * @notice Returns the access of an address
           * @param _user The address to query
           */
          function hasAccess(
            address _user,
            bytes memory _calldata
          )
            public
            view
            virtual
            override
            returns (bool)
          {
            return super.hasAccess(_user, _calldata) || _user == tx.origin;
          }
        
        }
        
        
        
        
        
        /**
         * @title The Flags contract
         * @notice Allows flags to signal to any reader on the access control list.
         * The owner can set flags, or designate other addresses to set flags. The
         * owner must turn the flags off, other setters cannot. An expected pattern is
         * to allow addresses to raise flags on themselves, so if you are subscribing to
         * FlagOn events you should filter for addresses you care about.
         */
        contract Flags is FlagsInterface, SimpleReadAccessController {
        
          AccessControllerInterface public raisingAccessController;
        
          mapping(address => bool) private flags;
        
          event FlagRaised(
            address indexed subject
          );
          event FlagLowered(
            address indexed subject
          );
          event RaisingAccessControllerUpdated(
            address indexed previous,
            address indexed current
          );
        
          /**
           * @param racAddress address for the raising access controller.
           */
          constructor(
            address racAddress
          )
            public
          {
            setRaisingAccessController(racAddress);
          }
        
          /**
           * @notice read the warning flag status of a contract address.
           * @param subject The contract address being checked for a flag.
           * @return A true value indicates that a flag was raised and a
           * false value indicates that no flag was raised.
           */
          function getFlag(address subject)
            external
            view
            override
            checkAccess()
            returns (bool)
          {
            return flags[subject];
          }
        
          /**
           * @notice read the warning flag status of a contract address.
           * @param subjects An array of addresses being checked for a flag.
           * @return An array of bools where a true value for any flag indicates that
           * a flag was raised and a false value indicates that no flag was raised.
           */
          function getFlags(address[] calldata subjects)
            external
            view
            override
            checkAccess()
            returns (bool[] memory)
          {
            bool[] memory responses = new bool[](subjects.length);
            for (uint256 i = 0; i < subjects.length; i++) {
              responses[i] = flags[subjects[i]];
            }
            return responses;
          }
        
          /**
           * @notice enable the warning flag for an address.
           * Access is controlled by raisingAccessController, except for owner
           * who always has access.
           * @param subject The contract address whose flag is being raised
           */
          function raiseFlag(address subject)
            external
            override
          {
            require(allowedToRaiseFlags(), "Not allowed to raise flags");
        
            tryToRaiseFlag(subject);
          }
        
          /**
           * @notice enable the warning flags for multiple addresses.
           * Access is controlled by raisingAccessController, except for owner
           * who always has access.
           * @param subjects List of the contract addresses whose flag is being raised
           */
          function raiseFlags(address[] calldata subjects)
            external
            override
          {
            require(allowedToRaiseFlags(), "Not allowed to raise flags");
        
            for (uint256 i = 0; i < subjects.length; i++) {
              tryToRaiseFlag(subjects[i]);
            }
          }
        
          /**
           * @notice allows owner to disable the warning flags for multiple addresses.
           * @param subjects List of the contract addresses whose flag is being lowered
           */
          function lowerFlags(address[] calldata subjects)
            external
            override
            onlyOwner()
          {
            for (uint256 i = 0; i < subjects.length; i++) {
              address subject = subjects[i];
        
              if (flags[subject]) {
                flags[subject] = false;
                emit FlagLowered(subject);
              }
            }
          }
        
          /**
           * @notice allows owner to change the access controller for raising flags.
           * @param racAddress new address for the raising access controller.
           */
          function setRaisingAccessController(
            address racAddress
          )
            public
            override
            onlyOwner()
          {
            address previous = address(raisingAccessController);
        
            if (previous != racAddress) {
              raisingAccessController = AccessControllerInterface(racAddress);
        
              emit RaisingAccessControllerUpdated(previous, racAddress);
            }
          }
        
        
          // PRIVATE
        
          function allowedToRaiseFlags()
            private
            view
            returns (bool)
          {
            return msg.sender == owner ||
              raisingAccessController.hasAccess(msg.sender, msg.data);
          }
        
          function tryToRaiseFlag(address subject)
            private
          {
            if (!flags[subject]) {
              flags[subject] = true;
              emit FlagRaised(subject);
            }
          }
        
        }

        File 8 of 8: CollateralState
        /*
           ____            __   __        __   _
          / __/__ __ ___  / /_ / /  ___  / /_ (_)__ __
         _\ \ / // // _ \/ __// _ \/ -_)/ __// / \ \ /
        /___/ \_, //_//_/\__//_//_/\__/ \__//_/ /_\_\
             /___/
        
        * Synthetix: CollateralState.sol
        *
        * Latest source (may be newer): https://github.com/Synthetixio/synthetix/blob/master/contracts/CollateralState.sol
        * Docs: https://docs.synthetix.io/contracts/CollateralState
        *
        * Contract Dependencies: 
        *	- ICollateralLoan
        *	- Owned
        *	- State
        * Libraries: 
        *	- SafeDecimalMath
        *	- SafeMath
        *
        * MIT License
        * ===========
        *
        * Copyright (c) 2021 Synthetix
        *
        * Permission is hereby granted, free of charge, to any person obtaining a copy
        * of this software and associated documentation files (the "Software"), to deal
        * in the Software without restriction, including without limitation the rights
        * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        * copies of the Software, and to permit persons to whom the Software is
        * furnished to do so, subject to the following conditions:
        *
        * The above copyright notice and this permission notice shall be included in all
        * copies or substantial portions of the Software.
        *
        * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        */
        
        
        
        pragma solidity ^0.5.16;
        
        
        // https://docs.synthetix.io/contracts/source/contracts/owned
        contract Owned {
            address public owner;
            address public nominatedOwner;
        
            constructor(address _owner) public {
                require(_owner != address(0), "Owner address cannot be 0");
                owner = _owner;
                emit OwnerChanged(address(0), _owner);
            }
        
            function nominateNewOwner(address _owner) external onlyOwner {
                nominatedOwner = _owner;
                emit OwnerNominated(_owner);
            }
        
            function acceptOwnership() external {
                require(msg.sender == nominatedOwner, "You must be nominated before you can accept ownership");
                emit OwnerChanged(owner, nominatedOwner);
                owner = nominatedOwner;
                nominatedOwner = address(0);
            }
        
            modifier onlyOwner {
                _onlyOwner();
                _;
            }
        
            function _onlyOwner() private view {
                require(msg.sender == owner, "Only the contract owner may perform this action");
            }
        
            event OwnerNominated(address newOwner);
            event OwnerChanged(address oldOwner, address newOwner);
        }
        
        
        // Inheritance
        
        
        // https://docs.synthetix.io/contracts/source/contracts/state
        contract State is Owned {
            // the address of the contract that can modify variables
            // this can only be changed by the owner of this contract
            address public associatedContract;
        
            constructor(address _associatedContract) internal {
                // This contract is abstract, and thus cannot be instantiated directly
                require(owner != address(0), "Owner must be set");
        
                associatedContract = _associatedContract;
                emit AssociatedContractUpdated(_associatedContract);
            }
        
            /* ========== SETTERS ========== */
        
            // Change the associated contract to a new address
            function setAssociatedContract(address _associatedContract) external onlyOwner {
                associatedContract = _associatedContract;
                emit AssociatedContractUpdated(_associatedContract);
            }
        
            /* ========== MODIFIERS ========== */
        
            modifier onlyAssociatedContract {
                require(msg.sender == associatedContract, "Only the associated contract can perform this action");
                _;
            }
        
            /* ========== EVENTS ========== */
        
            event AssociatedContractUpdated(address associatedContract);
        }
        
        
        pragma experimental ABIEncoderV2;
        
        
        interface ICollateralLoan {
            struct Loan {
                // ID for the loan
                uint id;
                //  Acccount that created the loan
                address payable account;
                //  Amount of collateral deposited
                uint collateral;
                // The synth that was borowed
                bytes32 currency;
                //  Amount of synths borrowed
                uint amount;
                // Indicates if the position was short sold
                bool short;
                // interest amounts accrued
                uint accruedInterest;
                // last interest index
                uint interestIndex;
                // time of last interaction.
                uint lastInteraction;
            }
        }
        
        
        /**
         * @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, 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");
                uint256 c = a - b;
        
                return c;
            }
        
            /**
             * @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) {
                // 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-solidity/pull/522
                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. Reverts 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) {
                // Solidity only automatically asserts when dividing by 0
                require(b > 0, "SafeMath: division by zero");
                uint256 c = a / b;
                // assert(a == b * c + a % b); // There is no case in which this doesn't hold
        
                return c;
            }
        
            /**
             * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
             * Reverts 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;
            }
        }
        
        
        // Libraries
        
        
        // https://docs.synthetix.io/contracts/source/libraries/safedecimalmath
        library SafeDecimalMath {
            using SafeMath for uint;
        
            /* Number of decimal places in the representations. */
            uint8 public constant decimals = 18;
            uint8 public constant highPrecisionDecimals = 27;
        
            /* The number representing 1.0. */
            uint public constant UNIT = 10**uint(decimals);
        
            /* The number representing 1.0 for higher fidelity numbers. */
            uint public constant PRECISE_UNIT = 10**uint(highPrecisionDecimals);
            uint private constant UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR = 10**uint(highPrecisionDecimals - decimals);
        
            /**
             * @return Provides an interface to UNIT.
             */
            function unit() external pure returns (uint) {
                return UNIT;
            }
        
            /**
             * @return Provides an interface to PRECISE_UNIT.
             */
            function preciseUnit() external pure returns (uint) {
                return PRECISE_UNIT;
            }
        
            /**
             * @return The result of multiplying x and y, interpreting the operands as fixed-point
             * decimals.
             *
             * @dev A unit factor is divided out after the product of x and y is evaluated,
             * so that product must be less than 2**256. As this is an integer division,
             * the internal division always rounds down. This helps save on gas. Rounding
             * is more expensive on gas.
             */
            function multiplyDecimal(uint x, uint y) internal pure returns (uint) {
                /* Divide by UNIT to remove the extra factor introduced by the product. */
                return x.mul(y) / UNIT;
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of the specified precision unit.
             *
             * @dev The operands should be in the form of a the specified unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function _multiplyDecimalRound(
                uint x,
                uint y,
                uint precisionUnit
            ) private pure returns (uint) {
                /* Divide by UNIT to remove the extra factor introduced by the product. */
                uint quotientTimesTen = x.mul(y) / (precisionUnit / 10);
        
                if (quotientTimesTen % 10 >= 5) {
                    quotientTimesTen += 10;
                }
        
                return quotientTimesTen / 10;
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of a precise unit.
             *
             * @dev The operands should be in the precise unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function multiplyDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                return _multiplyDecimalRound(x, y, PRECISE_UNIT);
            }
        
            /**
             * @return The result of safely multiplying x and y, interpreting the operands
             * as fixed-point decimals of a standard unit.
             *
             * @dev The operands should be in the standard unit factor which will be
             * divided out after the product of x and y is evaluated, so that product must be
             * less than 2**256.
             *
             * Unlike multiplyDecimal, this function rounds the result to the nearest increment.
             * Rounding is useful when you need to retain fidelity for small decimal numbers
             * (eg. small fractions or percentages).
             */
            function multiplyDecimalRound(uint x, uint y) internal pure returns (uint) {
                return _multiplyDecimalRound(x, y, UNIT);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is a high
             * precision decimal.
             *
             * @dev y is divided after the product of x and the standard precision unit
             * is evaluated, so the product of x and UNIT must be less than 2**256. As
             * this is an integer division, the result is always rounded down.
             * This helps save on gas. Rounding is more expensive on gas.
             */
            function divideDecimal(uint x, uint y) internal pure returns (uint) {
                /* Reintroduce the UNIT factor that will be divided out by y. */
                return x.mul(UNIT).div(y);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * decimal in the precision unit specified in the parameter.
             *
             * @dev y is divided after the product of x and the specified precision unit
             * is evaluated, so the product of x and the specified precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function _divideDecimalRound(
                uint x,
                uint y,
                uint precisionUnit
            ) private pure returns (uint) {
                uint resultTimesTen = x.mul(precisionUnit * 10).div(y);
        
                if (resultTimesTen % 10 >= 5) {
                    resultTimesTen += 10;
                }
        
                return resultTimesTen / 10;
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * standard precision decimal.
             *
             * @dev y is divided after the product of x and the standard precision unit
             * is evaluated, so the product of x and the standard precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function divideDecimalRound(uint x, uint y) internal pure returns (uint) {
                return _divideDecimalRound(x, y, UNIT);
            }
        
            /**
             * @return The result of safely dividing x and y. The return value is as a rounded
             * high precision decimal.
             *
             * @dev y is divided after the product of x and the high precision unit
             * is evaluated, so the product of x and the high precision unit must
             * be less than 2**256. The result is rounded to the nearest increment.
             */
            function divideDecimalRoundPrecise(uint x, uint y) internal pure returns (uint) {
                return _divideDecimalRound(x, y, PRECISE_UNIT);
            }
        
            /**
             * @dev Convert a standard decimal representation to a high precision one.
             */
            function decimalToPreciseDecimal(uint i) internal pure returns (uint) {
                return i.mul(UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR);
            }
        
            /**
             * @dev Convert a high precision decimal to a standard decimal representation.
             */
            function preciseDecimalToDecimal(uint i) internal pure returns (uint) {
                uint quotientTimesTen = i / (UNIT_TO_HIGH_PRECISION_CONVERSION_FACTOR / 10);
        
                if (quotientTimesTen % 10 >= 5) {
                    quotientTimesTen += 10;
                }
        
                return quotientTimesTen / 10;
            }
        }
        
        
        // Inheritance
        
        
        // Libraries
        
        
        contract CollateralState is Owned, State, ICollateralLoan {
            using SafeMath for uint;
            using SafeDecimalMath for uint;
        
            mapping(address => Loan[]) public loans;
        
            constructor(address _owner, address _associatedContract) public Owned(_owner) State(_associatedContract) {}
        
            /* ========== VIEWS ========== */
            // If we do not find the loan, this returns a struct with 0'd values.
            function getLoan(address account, uint256 loanID) external view returns (Loan memory) {
                Loan[] memory accountLoans = loans[account];
                for (uint i = 0; i < accountLoans.length; i++) {
                    if (accountLoans[i].id == loanID) {
                        return (accountLoans[i]);
                    }
                }
            }
        
            function getNumLoans(address account) external view returns (uint numLoans) {
                return loans[account].length;
            }
        
            /* ========== MUTATIVE FUNCTIONS ========== */
        
            function createLoan(Loan memory loan) public onlyAssociatedContract {
                loans[loan.account].push(loan);
            }
        
            function updateLoan(Loan memory loan) public onlyAssociatedContract {
                Loan[] storage accountLoans = loans[loan.account];
                for (uint i = 0; i < accountLoans.length; i++) {
                    if (accountLoans[i].id == loan.id) {
                        loans[loan.account][i] = loan;
                    }
                }
            }
        }