From 9a6fcfb056be654e3f362ce4152f43424fd83b65 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Fri, 26 Apr 2024 21:27:17 +1000 Subject: [PATCH 01/30] manuallyFixAccounting now uses delta values and only callable by the strategist manuallyFixAccounting calls doAccounting to check the fuse is still not blown Removed accountingGovernor --- .../NativeStaking/ValidatorAccountant.sol | 121 +++---- .../NativeStaking/ValidatorRegistrator.sol | 2 +- contracts/deploy/091_native_ssv_staking.js | 6 - .../NativeStakingSSVStrategyHierarchy.svg | 16 +- .../docs/NativeStakingSSVStrategySquashed.svg | 243 +++++++------ .../docs/NativeStakingSSVStrategyStorage.svg | 152 ++++---- contracts/test/_fixture.js | 3 - contracts/test/strategies/nativeSSVStaking.js | 325 +++++++++++------- 8 files changed, 455 insertions(+), 413 deletions(-) diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol index 2f1843ee56..9ec0a943a5 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol @@ -22,8 +22,6 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { uint256 public fuseIntervalStart = 0; /// @notice end of fuse interval uint256 public fuseIntervalEnd = 0; - /// @notice Governor that can manually correct the accounting - address public accountingGovernor; uint256[50] private __gap; @@ -37,27 +35,14 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { uint256 remainingValidators, uint256 wethSentToVault ); - event AccountingGovernorChanged(address newAddress); event AccountingConsensusRewards(uint256 amount); event AccountingManuallyFixed( - uint256 oldActiveDepositedValidators, - uint256 activeDepositedValidators, - uint256 oldBeaconChainRewards, - uint256 beaconChainRewards, - uint256 ethToWeth, - uint256 wethToBeSentToVault + int256 validatorsDelta, + int256 consensusRewardsDelta, + uint256 wethToVault ); - /// @dev Throws if called by any account other than the Accounting Governor - modifier onlyAccountingGovernor() { - require( - msg.sender == accountingGovernor, - "Caller is not the Accounting Governor" - ); - _; - } - /// @param _wethAddress Address of the Erc20 WETH Token contract /// @param _vaultAddress Address of the Vault /// @param _beaconChainDepositContract Address of the beacon chain deposit contract @@ -76,11 +61,6 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { ) {} - function setAccountingGovernor(address _address) external onlyGovernor { - emit AccountingGovernorChanged(_address); - accountingGovernor = _address; - } - /// @notice set fuse interval values function setFuseInterval( uint256 _fuseIntervalStart, @@ -111,6 +91,7 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { /// accounting is valid and fuse isn't "blown". Returns false when fuse is blown. /// @dev This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it /// for now. + /// @return accountingValid true if accounting was successful, false if fuse is blown /* solhint-enable max-line-length */ function doAccounting() external @@ -118,9 +99,16 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { whenNotPaused returns (bool accountingValid) { + accountingValid = _doAccounting(); + } + + function _doAccounting() internal returns (bool accountingValid) { if (address(this).balance < consensusRewards) { - // pause and fail the accounting - _pause(); + // pause if not already + if (!paused()) { + _pause(); + } + // fail the accounting return false; } @@ -170,66 +158,65 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { ethRemaining ); } - // Oh no... Fuse is blown. The governor (Multisig not OGV Governor) needs to set the - // record straight by manually set the accounting values. + // Oh no... Fuse is blown. The Strategist needs to adjust the accounting values. else { - // will emit a paused event - _pause(); + // pause if not already + if (!paused()) { + _pause(); + } + // fail the accounting accountingValid = false; } } - /// @dev allow the accounting governor to fix the accounting of this strategy and unpause - /// @param _activeDepositedValidators the override value of activeDepositedValidators - /// @param _ethToWeth the amount of ETH to be converted to WETH - /// @param _wethToBeSentToVault the amount of WETH to be sent to the Vault - /// @param _consensusRewards the override value for consensusRewards - /// @param _ethThresholdCheck maximum allowed ETH balance on the contract for the function to run - /// @param _wethThresholdCheck maximum allowed WETH balance on the contract for the function to run - /// the above 2 checks are done so transaction doesn't get front run and cause - /// unexpected behaviour + /// @notice Allow the Strategist to fix the accounting of this strategy and unpause. + /// @param _validatorsDelta adjust the active validators by plus one, minus one or unchanged with zero + /// @param _wethToVaultAmount the amount of WETH to be sent to the Vault + /// @param _consensusRewardsDelta adjust the accounted for consensus rewards up or down function manuallyFixAccounting( - uint256 _activeDepositedValidators, - uint256 _ethToWeth, - uint256 _wethToBeSentToVault, - uint256 _consensusRewards, - uint256 _ethThresholdCheck, - uint256 _wethThresholdCheck - ) external onlyAccountingGovernor whenPaused { - uint256 ethBalance = address(this).balance; - uint256 wethBalance = IWETH9(WETH_TOKEN_ADDRESS).balanceOf( - address(this) + int256 _validatorsDelta, + int256 _consensusRewardsDelta, + uint256 _wethToVaultAmount + ) external onlyStrategist whenPaused { + require( + _validatorsDelta >= -1 && + _validatorsDelta <= 1 && + // new value must be positive + int256(activeDepositedValidators) + _validatorsDelta >= 0, + "invalid validatorsDelta" ); - require( - ethBalance <= _ethThresholdCheck && - wethBalance <= _wethThresholdCheck, - "over accounting threshold" + _consensusRewardsDelta >= -32 ether && + _consensusRewardsDelta <= 32 ether && + // new value must be positive + int256(consensusRewards) + _consensusRewardsDelta >= 0, + "invalid consensusRewardsDelta" ); + require(_wethToVaultAmount <= 32 ether, "invalid wethToVaultAmount"); emit AccountingManuallyFixed( - activeDepositedValidators, - _activeDepositedValidators, - consensusRewards, - _consensusRewards, - _ethToWeth, - _wethToBeSentToVault + _validatorsDelta, + _consensusRewardsDelta, + _wethToVaultAmount ); - activeDepositedValidators = _activeDepositedValidators; - consensusRewards = _consensusRewards; - if (_ethToWeth > 0) { - require(_ethToWeth <= ethBalance, "insufficient ETH"); - - IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: _ethToWeth }(); - } - if (_wethToBeSentToVault > 0) { + activeDepositedValidators = uint256( + int256(activeDepositedValidators) + _validatorsDelta + ); + consensusRewards = uint256( + int256(consensusRewards) + _consensusRewardsDelta + ); + if (_wethToVaultAmount > 0) { IWETH9(WETH_TOKEN_ADDRESS).transfer( VAULT_ADDRESS, - _wethToBeSentToVault + _wethToVaultAmount ); } + // rerun the accounting to see if it has now been fixed. + require(_doAccounting(), "fuse still blown"); + + // unpause since doAccounting was successful _unpause(); } } diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol b/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol index d609efe6d6..625230091b 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol @@ -34,7 +34,7 @@ abstract contract ValidatorRegistrator is Governable, Pausable { /// @notice The number of validators that have 32 (!) ETH actively deposited. When a new deposit /// to a validator happens this number increases, when a validator exit is detected this number /// decreases. - uint256 activeDepositedValidators; + uint256 public activeDepositedValidators; /// @notice State of the validators keccak256(pubKey) => state mapping(bytes32 => VALIDATOR_STATE) public validatorsStates; diff --git a/contracts/deploy/091_native_ssv_staking.js b/contracts/deploy/091_native_ssv_staking.js index 9b4748ad3b..ae57bacb0c 100644 --- a/contracts/deploy/091_native_ssv_staking.js +++ b/contracts/deploy/091_native_ssv_staking.js @@ -153,12 +153,6 @@ module.exports = deploymentWithGovernanceProposal( ethers.utils.parseEther("25.6"), ], }, - // 5. configure the accounting governor - { - contract: cStrategy, - signature: "setAccountingGovernor(address)", - args: [deployerAddr], // TODO: change this to the defender action - }, ], }; } diff --git a/contracts/docs/NativeStakingSSVStrategyHierarchy.svg b/contracts/docs/NativeStakingSSVStrategyHierarchy.svg index 3007a5a443..0686fa8c78 100644 --- a/contracts/docs/NativeStakingSSVStrategyHierarchy.svg +++ b/contracts/docs/NativeStakingSSVStrategyHierarchy.svg @@ -90,17 +90,17 @@ - + -336 +340 <<Abstract>> Pausable ../node_modules/@openzeppelin/contracts/security/Pausable.sol - + -283->336 +283->340 @@ -124,17 +124,17 @@ - + -341 +345 <<Abstract>> Context ../node_modules/@openzeppelin/contracts/utils/Context.sol - + -336->341 +340->345 diff --git a/contracts/docs/NativeStakingSSVStrategySquashed.svg b/contracts/docs/NativeStakingSSVStrategySquashed.svg index 392788f64f..a5055466dd 100644 --- a/contracts/docs/NativeStakingSSVStrategySquashed.svg +++ b/contracts/docs/NativeStakingSSVStrategySquashed.svg @@ -4,133 +4,130 @@ - - + + UmlClassDiagram - + 280 - -NativeStakingSSVStrategy -../contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol - -Private: -   governorPosition: bytes32 <<Governable>> -   pendingGovernorPosition: bytes32 <<Governable>> -   reentryStatusPosition: bytes32 <<Governable>> -   _paused: bool <<Pausable>> -   __gap: uint256[50] <<ValidatorRegistrator>> -   __gap: uint256[50] <<ValidatorAccountant>> -   initialized: bool <<Initializable>> -   initializing: bool <<Initializable>> -   ______gap: uint256[50] <<Initializable>> -   _deprecated_platformAddress: address <<InitializableAbstractStrategy>> -   _deprecated_vaultAddress: address <<InitializableAbstractStrategy>> -   _deprecated_rewardTokenAddress: address <<InitializableAbstractStrategy>> -   _deprecated_rewardLiquidationThreshold: uint256 <<InitializableAbstractStrategy>> -   _reserved: int256[98] <<InitializableAbstractStrategy>> -   __gap: uint256[50] <<NativeStakingSSVStrategy>> -Internal: -   assetsMapped: address[] <<InitializableAbstractStrategy>> -Public: -   _NOT_ENTERED: uint256 <<Governable>> -   _ENTERED: uint256 <<Governable>> -   WETH_TOKEN_ADDRESS: address <<ValidatorRegistrator>> -   BEACON_CHAIN_DEPOSIT_CONTRACT: address <<ValidatorRegistrator>> -   SSV_NETWORK_ADDRESS: address <<ValidatorRegistrator>> -   VAULT_ADDRESS: address <<ValidatorRegistrator>> -   validatorRegistrator: address <<ValidatorRegistrator>> -   activeDepositedValidators: uint256 <<ValidatorRegistrator>> -   validatorsStates: mapping(bytes32=>VALIDATOR_STATE) <<ValidatorRegistrator>> -   MAX_STAKE: uint256 <<ValidatorAccountant>> -   consensusRewards: uint256 <<ValidatorAccountant>> -   fuseIntervalStart: uint256 <<ValidatorAccountant>> -   fuseIntervalEnd: uint256 <<ValidatorAccountant>> -   accountingGovernor: address <<ValidatorAccountant>> -   platformAddress: address <<InitializableAbstractStrategy>> -   vaultAddress: address <<InitializableAbstractStrategy>> -   assetToPToken: mapping(address=>address) <<InitializableAbstractStrategy>> -   harvesterAddress: address <<InitializableAbstractStrategy>> -   rewardTokenAddresses: address[] <<InitializableAbstractStrategy>> -   SSV_TOKEN_ADDRESS: address <<NativeStakingSSVStrategy>> -   FEE_ACCUMULATOR_ADDRESS: address <<NativeStakingSSVStrategy>> - -Internal: -    _governor(): (governorOut: address) <<Governable>> -    _pendingGovernor(): (pendingGovernor: address) <<Governable>> -    _setGovernor(newGovernor: address) <<Governable>> -    _setPendingGovernor(newGovernor: address) <<Governable>> -    _changeGovernor(_newGovernor: address) <<Governable>> -    _msgSender(): address <<Context>> -    _msgData(): bytes <<Context>> -    _pause() <<whenNotPaused>> <<Pausable>> -    _unpause() <<whenPaused>> <<Pausable>> -    _initialize(_rewardTokenAddresses: address[], _assets: address[], _pTokens: address[]) <<InitializableAbstractStrategy>> -    _collectRewardTokens() <<whenNotPaused>> <<NativeStakingSSVStrategy>> -    _setPTokenAddress(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> -    _abstractSetPToken(_asset: address, address) <<NativeStakingSSVStrategy>> -    _deposit(_asset: address, _amount: uint256) <<NativeStakingSSVStrategy>> -    _withdraw(_recipient: address, _asset: address, _amount: uint256) <<NativeStakingSSVStrategy>> -External: -    <<payable>> null() <<NativeStakingSSVStrategy>> -    transferGovernance(_newGovernor: address) <<onlyGovernor>> <<Governable>> -    claimGovernance() <<Governable>> -    setRegistrator(_address: address) <<onlyGovernor>> <<ValidatorRegistrator>> -    stakeEth(validators: ValidatorStakeData[]) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> -    registerSsvValidator(publicKey: bytes, operatorIds: uint64[], sharesData: bytes, amount: uint256, cluster: Cluster) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> -    exitSsvValidator(publicKey: bytes, operatorIds: uint64[]) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> -    removeSsvValidator(publicKey: bytes, operatorIds: uint64[], cluster: Cluster) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> -    depositSSV(operatorIds: uint64[], amount: uint256, cluster: Cluster) <<onlyStrategist>> <<ValidatorRegistrator>> -    setAccountingGovernor(_address: address) <<onlyGovernor>> <<ValidatorAccountant>> -    setFuseInterval(_fuseIntervalStart: uint256, _fuseIntervalEnd: uint256) <<onlyGovernor>> <<ValidatorAccountant>> -    doAccounting(): (accountingValid: bool) <<onlyRegistrator, whenNotPaused>> <<ValidatorAccountant>> -    manuallyFixAccounting(_activeDepositedValidators: uint256, _ethToWeth: uint256, _wethToBeSentToVault: uint256, _consensusRewards: uint256, _ethThresholdCheck: uint256, _wethThresholdCheck: uint256) <<onlyAccountingGovernor, whenPaused>> <<ValidatorAccountant>> -    collectRewardTokens() <<onlyHarvester, nonReentrant>> <<InitializableAbstractStrategy>> -    setRewardTokenAddresses(_rewardTokenAddresses: address[]) <<onlyGovernor>> <<InitializableAbstractStrategy>> -    getRewardTokenAddresses(): address[] <<InitializableAbstractStrategy>> -    setPTokenAddress(_asset: address, _pToken: address) <<onlyGovernor>> <<InitializableAbstractStrategy>> -    removePToken(_assetIndex: uint256) <<onlyGovernor>> <<InitializableAbstractStrategy>> -    setHarvesterAddress(_harvesterAddress: address) <<onlyGovernor>> <<InitializableAbstractStrategy>> -    safeApproveAllTokens() <<NativeStakingSSVStrategy>> -    deposit(_asset: address, _amount: uint256) <<onlyVault, nonReentrant>> <<NativeStakingSSVStrategy>> -    depositAll() <<onlyVault, nonReentrant>> <<NativeStakingSSVStrategy>> -    withdraw(_recipient: address, _asset: address, _amount: uint256) <<onlyVault, nonReentrant>> <<NativeStakingSSVStrategy>> -    withdrawAll() <<onlyVaultOrGovernor, nonReentrant>> <<NativeStakingSSVStrategy>> -    checkBalance(_asset: address): (balance: uint256) <<NativeStakingSSVStrategy>> -    initialize(_rewardTokenAddresses: address[], _assets: address[], _pTokens: address[]) <<onlyGovernor, initializer>> <<NativeStakingSSVStrategy>> -    pause() <<onlyStrategist>> <<NativeStakingSSVStrategy>> -Public: -    <<event>> PendingGovernorshipTransfer(previousGovernor: address, newGovernor: address) <<Governable>> -    <<event>> GovernorshipTransferred(previousGovernor: address, newGovernor: address) <<Governable>> -    <<event>> Paused(account: address) <<Pausable>> -    <<event>> Unpaused(account: address) <<Pausable>> -    <<event>> RegistratorChanged(newAddress: address) <<ValidatorRegistrator>> -    <<event>> ETHStaked(pubkey: bytes, amount: uint256, withdrawal_credentials: bytes) <<ValidatorRegistrator>> -    <<event>> SSVValidatorRegistered(pubkey: bytes, operatorIds: uint64[]) <<ValidatorRegistrator>> -    <<event>> SSVValidatorExitInitiated(pubkey: bytes, operatorIds: uint64[]) <<ValidatorRegistrator>> -    <<event>> SSVValidatorExitCompleted(pubkey: bytes, operatorIds: uint64[]) <<ValidatorRegistrator>> -    <<event>> FuseIntervalUpdated(start: uint256, end: uint256) <<ValidatorAccountant>> -    <<event>> AccountingFullyWithdrawnValidator(noOfValidators: uint256, remainingValidators: uint256, wethSentToVault: uint256) <<ValidatorAccountant>> -    <<event>> AccountingValidatorSlashed(remainingValidators: uint256, wethSentToVault: uint256) <<ValidatorAccountant>> -    <<event>> AccountingGovernorChanged(newAddress: address) <<ValidatorAccountant>> -    <<event>> AccountingConsensusRewards(amount: uint256) <<ValidatorAccountant>> -    <<event>> AccountingManuallyFixed(oldActiveDepositedValidators: uint256, activeDepositedValidators: uint256, oldBeaconChainRewards: uint256, beaconChainRewards: uint256, ethToWeth: uint256, wethToBeSentToVault: uint256) <<ValidatorAccountant>> -    <<event>> PTokenAdded(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> -    <<event>> PTokenRemoved(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> -    <<event>> Deposit(_asset: address, _pToken: address, _amount: uint256) <<InitializableAbstractStrategy>> -    <<event>> Withdrawal(_asset: address, _pToken: address, _amount: uint256) <<InitializableAbstractStrategy>> -    <<event>> RewardTokenCollected(recipient: address, rewardToken: address, amount: uint256) <<InitializableAbstractStrategy>> -    <<event>> RewardTokenAddressesUpdated(_oldAddresses: address[], _newAddresses: address[]) <<InitializableAbstractStrategy>> -    <<event>> HarvesterAddressesUpdated(_oldHarvesterAddress: address, _newHarvesterAddress: address) <<InitializableAbstractStrategy>> -    <<modifier>> onlyGovernor() <<Governable>> -    <<modifier>> nonReentrant() <<Governable>> -    <<modifier>> whenNotPaused() <<Pausable>> -    <<modifier>> whenPaused() <<Pausable>> -    <<modifier>> onlyRegistrator() <<ValidatorRegistrator>> -    <<modifier>> onlyStrategist() <<ValidatorRegistrator>> -    <<modifier>> onlyAccountingGovernor() <<ValidatorAccountant>> + +NativeStakingSSVStrategy +../contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol + +Private: +   governorPosition: bytes32 <<Governable>> +   pendingGovernorPosition: bytes32 <<Governable>> +   reentryStatusPosition: bytes32 <<Governable>> +   _paused: bool <<Pausable>> +   __gap: uint256[50] <<ValidatorRegistrator>> +   __gap: uint256[50] <<ValidatorAccountant>> +   initialized: bool <<Initializable>> +   initializing: bool <<Initializable>> +   ______gap: uint256[50] <<Initializable>> +   _deprecated_platformAddress: address <<InitializableAbstractStrategy>> +   _deprecated_vaultAddress: address <<InitializableAbstractStrategy>> +   _deprecated_rewardTokenAddress: address <<InitializableAbstractStrategy>> +   _deprecated_rewardLiquidationThreshold: uint256 <<InitializableAbstractStrategy>> +   _reserved: int256[98] <<InitializableAbstractStrategy>> +   __gap: uint256[50] <<NativeStakingSSVStrategy>> +Internal: +   assetsMapped: address[] <<InitializableAbstractStrategy>> +Public: +   _NOT_ENTERED: uint256 <<Governable>> +   _ENTERED: uint256 <<Governable>> +   WETH_TOKEN_ADDRESS: address <<ValidatorRegistrator>> +   BEACON_CHAIN_DEPOSIT_CONTRACT: address <<ValidatorRegistrator>> +   SSV_NETWORK_ADDRESS: address <<ValidatorRegistrator>> +   VAULT_ADDRESS: address <<ValidatorRegistrator>> +   validatorRegistrator: address <<ValidatorRegistrator>> +   activeDepositedValidators: uint256 <<ValidatorRegistrator>> +   validatorsStates: mapping(bytes32=>VALIDATOR_STATE) <<ValidatorRegistrator>> +   MAX_STAKE: uint256 <<ValidatorAccountant>> +   consensusRewards: uint256 <<ValidatorAccountant>> +   fuseIntervalStart: uint256 <<ValidatorAccountant>> +   fuseIntervalEnd: uint256 <<ValidatorAccountant>> +   platformAddress: address <<InitializableAbstractStrategy>> +   vaultAddress: address <<InitializableAbstractStrategy>> +   assetToPToken: mapping(address=>address) <<InitializableAbstractStrategy>> +   harvesterAddress: address <<InitializableAbstractStrategy>> +   rewardTokenAddresses: address[] <<InitializableAbstractStrategy>> +   SSV_TOKEN_ADDRESS: address <<NativeStakingSSVStrategy>> +   FEE_ACCUMULATOR_ADDRESS: address <<NativeStakingSSVStrategy>> + +Internal: +    _governor(): (governorOut: address) <<Governable>> +    _pendingGovernor(): (pendingGovernor: address) <<Governable>> +    _setGovernor(newGovernor: address) <<Governable>> +    _setPendingGovernor(newGovernor: address) <<Governable>> +    _changeGovernor(_newGovernor: address) <<Governable>> +    _msgSender(): address <<Context>> +    _msgData(): bytes <<Context>> +    _pause() <<whenNotPaused>> <<Pausable>> +    _unpause() <<whenPaused>> <<Pausable>> +    _doAccounting(): (accountingValid: bool) <<ValidatorAccountant>> +    _initialize(_rewardTokenAddresses: address[], _assets: address[], _pTokens: address[]) <<InitializableAbstractStrategy>> +    _collectRewardTokens() <<whenNotPaused>> <<NativeStakingSSVStrategy>> +    _setPTokenAddress(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> +    _abstractSetPToken(_asset: address, address) <<NativeStakingSSVStrategy>> +    _deposit(_asset: address, _amount: uint256) <<NativeStakingSSVStrategy>> +    _withdraw(_recipient: address, _asset: address, _amount: uint256) <<NativeStakingSSVStrategy>> +External: +    <<payable>> null() <<NativeStakingSSVStrategy>> +    transferGovernance(_newGovernor: address) <<onlyGovernor>> <<Governable>> +    claimGovernance() <<Governable>> +    setRegistrator(_address: address) <<onlyGovernor>> <<ValidatorRegistrator>> +    stakeEth(validators: ValidatorStakeData[]) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> +    registerSsvValidator(publicKey: bytes, operatorIds: uint64[], sharesData: bytes, amount: uint256, cluster: Cluster) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> +    exitSsvValidator(publicKey: bytes, operatorIds: uint64[]) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> +    removeSsvValidator(publicKey: bytes, operatorIds: uint64[], cluster: Cluster) <<onlyRegistrator, whenNotPaused>> <<ValidatorRegistrator>> +    depositSSV(operatorIds: uint64[], amount: uint256, cluster: Cluster) <<onlyStrategist>> <<ValidatorRegistrator>> +    setFuseInterval(_fuseIntervalStart: uint256, _fuseIntervalEnd: uint256) <<onlyGovernor>> <<ValidatorAccountant>> +    doAccounting(): (accountingValid: bool) <<onlyRegistrator, whenNotPaused>> <<ValidatorAccountant>> +    manuallyFixAccounting(_validatorsDelta: int256, _consensusRewardsDelta: int256, _wethToVaultAmount: uint256) <<onlyStrategist, whenPaused>> <<ValidatorAccountant>> +    collectRewardTokens() <<onlyHarvester, nonReentrant>> <<InitializableAbstractStrategy>> +    setRewardTokenAddresses(_rewardTokenAddresses: address[]) <<onlyGovernor>> <<InitializableAbstractStrategy>> +    getRewardTokenAddresses(): address[] <<InitializableAbstractStrategy>> +    setPTokenAddress(_asset: address, _pToken: address) <<onlyGovernor>> <<InitializableAbstractStrategy>> +    removePToken(_assetIndex: uint256) <<onlyGovernor>> <<InitializableAbstractStrategy>> +    setHarvesterAddress(_harvesterAddress: address) <<onlyGovernor>> <<InitializableAbstractStrategy>> +    safeApproveAllTokens() <<NativeStakingSSVStrategy>> +    deposit(_asset: address, _amount: uint256) <<onlyVault, nonReentrant>> <<NativeStakingSSVStrategy>> +    depositAll() <<onlyVault, nonReentrant>> <<NativeStakingSSVStrategy>> +    withdraw(_recipient: address, _asset: address, _amount: uint256) <<onlyVault, nonReentrant>> <<NativeStakingSSVStrategy>> +    withdrawAll() <<onlyVaultOrGovernor, nonReentrant>> <<NativeStakingSSVStrategy>> +    checkBalance(_asset: address): (balance: uint256) <<NativeStakingSSVStrategy>> +    initialize(_rewardTokenAddresses: address[], _assets: address[], _pTokens: address[]) <<onlyGovernor, initializer>> <<NativeStakingSSVStrategy>> +    pause() <<onlyStrategist>> <<NativeStakingSSVStrategy>> +Public: +    <<event>> PendingGovernorshipTransfer(previousGovernor: address, newGovernor: address) <<Governable>> +    <<event>> GovernorshipTransferred(previousGovernor: address, newGovernor: address) <<Governable>> +    <<event>> Paused(account: address) <<Pausable>> +    <<event>> Unpaused(account: address) <<Pausable>> +    <<event>> RegistratorChanged(newAddress: address) <<ValidatorRegistrator>> +    <<event>> ETHStaked(pubkey: bytes, amount: uint256, withdrawal_credentials: bytes) <<ValidatorRegistrator>> +    <<event>> SSVValidatorRegistered(pubkey: bytes, operatorIds: uint64[]) <<ValidatorRegistrator>> +    <<event>> SSVValidatorExitInitiated(pubkey: bytes, operatorIds: uint64[]) <<ValidatorRegistrator>> +    <<event>> SSVValidatorExitCompleted(pubkey: bytes, operatorIds: uint64[]) <<ValidatorRegistrator>> +    <<event>> FuseIntervalUpdated(start: uint256, end: uint256) <<ValidatorAccountant>> +    <<event>> AccountingFullyWithdrawnValidator(noOfValidators: uint256, remainingValidators: uint256, wethSentToVault: uint256) <<ValidatorAccountant>> +    <<event>> AccountingValidatorSlashed(remainingValidators: uint256, wethSentToVault: uint256) <<ValidatorAccountant>> +    <<event>> AccountingConsensusRewards(amount: uint256) <<ValidatorAccountant>> +    <<event>> AccountingManuallyFixed(validatorsDelta: int256, consensusRewardsDelta: int256, wethToVault: uint256) <<ValidatorAccountant>> +    <<event>> PTokenAdded(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> +    <<event>> PTokenRemoved(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> +    <<event>> Deposit(_asset: address, _pToken: address, _amount: uint256) <<InitializableAbstractStrategy>> +    <<event>> Withdrawal(_asset: address, _pToken: address, _amount: uint256) <<InitializableAbstractStrategy>> +    <<event>> RewardTokenCollected(recipient: address, rewardToken: address, amount: uint256) <<InitializableAbstractStrategy>> +    <<event>> RewardTokenAddressesUpdated(_oldAddresses: address[], _newAddresses: address[]) <<InitializableAbstractStrategy>> +    <<event>> HarvesterAddressesUpdated(_oldHarvesterAddress: address, _newHarvesterAddress: address) <<InitializableAbstractStrategy>> +    <<modifier>> onlyGovernor() <<Governable>> +    <<modifier>> nonReentrant() <<Governable>> +    <<modifier>> whenNotPaused() <<Pausable>> +    <<modifier>> whenPaused() <<Pausable>> +    <<modifier>> onlyRegistrator() <<ValidatorRegistrator>> +    <<modifier>> onlyStrategist() <<ValidatorRegistrator>>    <<modifier>> initializer() <<Initializable>>    <<modifier>> onlyVault() <<InitializableAbstractStrategy>>    <<modifier>> onlyHarvester() <<InitializableAbstractStrategy>> diff --git a/contracts/docs/NativeStakingSSVStrategyStorage.svg b/contracts/docs/NativeStakingSSVStrategyStorage.svg index 058cea8538..e5aad7e6a1 100644 --- a/contracts/docs/NativeStakingSSVStrategyStorage.svg +++ b/contracts/docs/NativeStakingSSVStrategyStorage.svg @@ -4,84 +4,78 @@ - - + + StorageDiagram - + 3 - -NativeStakingSSVStrategy <<Contract>> - -slot - -0 + +NativeStakingSSVStrategy <<Contract>> + +slot -1 +0 -2 +1 -3-52 +2 -53 +3-52 -54 +53 -55 +54 -56 +55 -57-106 +56-105 -107 +106 -108-157 +107-156 -158 +157 -159 +158 -160 +159 -161 +160 -162 +161 -163 +162 -164 +163 -165 +164 -166-263 +165-262 -264-313 - -type: <inherited contract>.variable (bytes) - -unallocated (11) - -address: ValidatorRegistrator.validatorRegistrator (20) - -bool: Pausable._paused (1) +263-312 + +type: <inherited contract>.variable (bytes) -uint256: ValidatorRegistrator.activeDepositedValidators (32) +unallocated (11) + +address: ValidatorRegistrator.validatorRegistrator (20) + +bool: Pausable._paused (1) -mapping(bytes32=>VALIDATOR_STATE): ValidatorRegistrator.validatorsStates (32) +uint256: ValidatorRegistrator.activeDepositedValidators (32) -uint256[50]: ValidatorRegistrator.__gap (1600) +mapping(bytes32=>VALIDATOR_STATE): ValidatorRegistrator.validatorsStates (32) -uint256: ValidatorAccountant.consensusRewards (32) +uint256[50]: ValidatorRegistrator.__gap (1600) -uint256: ValidatorAccountant.fuseIntervalStart (32) +uint256: ValidatorAccountant.consensusRewards (32) -uint256: ValidatorAccountant.fuseIntervalEnd (32) +uint256: ValidatorAccountant.fuseIntervalStart (32) -unallocated (12) - -address: ValidatorAccountant.accountingGovernor (20) +uint256: ValidatorAccountant.fuseIntervalEnd (32) uint256[50]: ValidatorAccountant.__gap (1600) @@ -124,48 +118,48 @@ 1 - -address[]: assetsMapped <<Array>> -0xaadc37b8ba5645e62f4546802db221593a94729ccbfc5a97d01365a88f649878 - -offset - -0 - -type: variable (bytes) - -unallocated (12) - -address (20) + +address[]: assetsMapped <<Array>> +0x78fdc8d422c49ced035a9edf18d00d3c6a8d81df210f3e5e448e045e77b41e88 + +offset + +0 + +type: variable (bytes) + +unallocated (12) + +address (20) -3:18->1 - - +3:17->1 + + 2 - -address[]: rewardTokenAddresses <<Array>> -0xb29a2b3b6f2ff1b765777a231725941da5072cc4fcc30ac4a2ce09706e8ddeff - -offset - -0 - -type: variable (bytes) - -unallocated (12) - -address (20) + +address[]: rewardTokenAddresses <<Array>> +0xe434dc35da084cf8d7e8186688ea2dacb53db7003d427af3abf351bd9d0a4e8d + +offset + +0 + +type: variable (bytes) + +unallocated (12) + +address (20) -3:23->2 - - +3:22->2 + + diff --git a/contracts/test/_fixture.js b/contracts/test/_fixture.js index 91714bc6f2..513ac4bbab 100644 --- a/contracts/test/_fixture.js +++ b/contracts/test/_fixture.js @@ -1448,9 +1448,6 @@ async function nativeStakingSSVStrategyFixture() { .connect(sGovernor) .setRegistrator(governorAddr); - await nativeStakingSSVStrategy - .connect(sGovernor) - .setAccountingGovernor(governorAddr); } return fixture; diff --git a/contracts/test/strategies/nativeSSVStaking.js b/contracts/test/strategies/nativeSSVStaking.js index c176d3fea3..645747f522 100644 --- a/contracts/test/strategies/nativeSSVStaking.js +++ b/contracts/test/strategies/nativeSSVStaking.js @@ -1,7 +1,10 @@ const { expect } = require("chai"); const { BigNumber } = require("ethers"); const { parseEther } = require("ethers").utils; -const { setBalance } = require("@nomicfoundation/hardhat-network-helpers"); +const { + setBalance, + setStorageAt, +} = require("@nomicfoundation/hardhat-network-helpers"); const { isCI } = require("../helpers"); const { shouldBehaveLikeGovernable } = require("../behaviour/governable"); @@ -57,7 +60,7 @@ describe("Unit test: Native SSV Staking Strategy", function () { ); const tx = { to: nativeStakingSSVStrategy.address, - value: parseEther("2", "ether"), + value: parseEther("2"), }; await expect(signer.sendTransaction(tx)).to.be.revertedWith( @@ -154,28 +157,8 @@ describe("Unit test: Native SSV Staking Strategy", function () { .withArgs(fuseStartBn, fuseEndBn); }); - it("Only accounting governor can call accounting", async () => {}); - - it("Only governor can change the accounting governor", async () => { - const { nativeStakingSSVStrategy, strategist } = fixture; - - await expect( - nativeStakingSSVStrategy - .connect(strategist) - .setAccountingGovernor(strategist.address) - ).to.be.revertedWith("Caller is not the Governor"); - }); - - it("Change the accounting governor", async () => { - const { nativeStakingSSVStrategy, governor, strategist } = fixture; - - const tx = await nativeStakingSSVStrategy - .connect(governor) - .setAccountingGovernor(strategist.address); - - await expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingGovernorChanged") - .withArgs(strategist.address); + it("Only strategist can call fix accounting", async () => { + // TODO }); }); @@ -466,24 +449,18 @@ describe("Unit test: Native SSV Staking Strategy", function () { } consensus rewards, ${expectedValidatorsFullWithdrawals} withdraws${ fuseBlown ? ", fuse blown" : "" }${slashDetected ? ", slash detected" : ""}.`, async () => { - const { nativeStakingSSVStrategy, governor, strategist } = fixture; + const { nativeStakingSSVStrategy, governor } = fixture; // setup state if (ethBalance.gt(0)) { await setBalance(nativeStakingSSVStrategy.address, ethBalance); } - // pause, so manuallyFixAccounting can be called - await nativeStakingSSVStrategy.connect(strategist).pause(); - await nativeStakingSSVStrategy - .connect(governor) - .manuallyFixAccounting( - 30, // activeDepositedValidators - 0, //_ethToWeth - 0, //_wethToBeSentToVault - previousConsensusRewards, //_consensusRewards - parseEther("3000"), //_ethThresholdCheck - parseEther("3000") //_wethThresholdCheck - ); + + await setActiveDepositedValidators(30, nativeStakingSSVStrategy); + await setConsensusRewards( + previousConsensusRewards, + nativeStakingSSVStrategy + ); // check accounting values const tx = await nativeStakingSSVStrategy @@ -541,123 +518,202 @@ describe("Unit test: Native SSV Staking Strategy", function () { } }); - it("Only accounting governor is allowed to manually fix accounting", async () => { - const { nativeStakingSSVStrategy, strategist } = fixture; + it("Only strategist is allowed to manually fix accounting", async () => { + const { nativeStakingSSVStrategy, strategist, governor } = fixture; await nativeStakingSSVStrategy.connect(strategist).pause(); // unit test fixture sets OUSD governor as accounting governor await expect( - nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( - 10, //_activeDepositedValidators - parseEther("2", "ether"), //_ethToWeth - parseEther("2", "ether"), //_wethToBeSentToVault - parseEther("2", "ether"), //_consensusRewards - parseEther("0", "ether"), //_ethThresholdCheck - parseEther("0", "ether") //_wethThresholdCheck + nativeStakingSSVStrategy.connect(governor).manuallyFixAccounting( + 1, //_validatorsDelta + parseEther("2"), //_consensusRewardsDelta + parseEther("2") //_wethToVault ) - ).to.be.revertedWith("Caller is not the Accounting Governor"); + ).to.be.revertedWith("Caller is not the Strategist"); }); it("Accounting needs to be paused in order to call fix accounting function", async () => { - const { nativeStakingSSVStrategy, governor } = fixture; + const { nativeStakingSSVStrategy, strategist } = fixture; // unit test fixture sets OUSD governor as accounting governor await expect( - nativeStakingSSVStrategy.connect(governor).manuallyFixAccounting( - 10, //_activeDepositedValidators - parseEther("2", "ether"), //_ethToWeth - parseEther("2", "ether"), //_wethToBeSentToVault - parseEther("2", "ether"), //_beaconChainRewardWETH - parseEther("1", "ether"), //_ethThresholdCheck - parseEther("0", "ether") //_wethThresholdCheck + nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( + 1, //_validatorsDelta + parseEther("2"), //_consensusRewardsDelta + parseEther("2") //_wethToVault ) ).to.be.revertedWith("Pausable: not paused"); }); - it("Should not execute manual recovery if eth threshold reached", async () => { - const { nativeStakingSSVStrategy, strategist, governor, josh, weth } = - fixture; - - await setBalance( - nativeStakingSSVStrategy.address, - parseEther("6", "ether") - ); - await weth - .connect(josh) - .transfer(nativeStakingSSVStrategy.address, parseEther("5", "ether")); + it("Validators delta should not be >=-1 and <=1 for fix accounting function", async () => { + const { nativeStakingSSVStrategy, strategist } = fixture; await nativeStakingSSVStrategy.connect(strategist).pause(); + await expect( - nativeStakingSSVStrategy.connect(governor).manuallyFixAccounting( - 10, //_activeDepositedValidators - parseEther("2", "ether"), //_ethToWeth - parseEther("2", "ether"), //_wethToBeSentToVault - parseEther("2", "ether"), //_beaconChainRewardWETH - parseEther("5", "ether"), //_ethThresholdCheck - parseEther("5", "ether") //_wethThresholdCheck + nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( + -2, //_validatorsDelta + 0, //_consensusRewardsDelta + 0 //_wethToVault ) - ).to.be.revertedWith("over accounting threshold"); + ).to.be.revertedWith("invalid validatorsDelta"); + + await expect( + nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( + 2, //_validatorsDelta + 0, //_consensusRewardsDelta + 0 //_wethToVault + ) + ).to.be.revertedWith("invalid validatorsDelta"); }); - it("Should not execute manual recovery if weth threshold reached", async () => { - const { nativeStakingSSVStrategy, strategist, governor, josh, weth } = - fixture; + it("Consensus rewards delta should not be >=-32 and <=32 for fix accounting function", async () => { + const { nativeStakingSSVStrategy, strategist } = fixture; - await setBalance( - nativeStakingSSVStrategy.address, - parseEther("5", "ether") - ); - await weth - .connect(josh) - .transfer(nativeStakingSSVStrategy.address, parseEther("6", "ether")); + await nativeStakingSSVStrategy.connect(strategist).pause(); + + await expect( + nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( + 0, //_validatorsDelta + parseEther("-33"), //_consensusRewardsDelta + 0 //_wethToVault + ) + ).to.be.revertedWith("invalid consensusRewardsDelta"); + + await expect( + nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( + 0, //_validatorsDelta + parseEther("33"), //_consensusRewardsDelta + 0 //_wethToVault + ) + ).to.be.revertedWith("invalid consensusRewardsDelta"); + }); + + it("WETH to Vault amount should not be >32 for fix accounting function", async () => { + const { nativeStakingSSVStrategy, strategist } = fixture; await nativeStakingSSVStrategy.connect(strategist).pause(); + await expect( - nativeStakingSSVStrategy.connect(governor).manuallyFixAccounting( - 10, //_activeDepositedValidators - parseEther("2", "ether"), //_ethToWeth - parseEther("2", "ether"), //_wethToBeSentToVault - parseEther("2", "ether"), //_beaconChainRewardWETH - parseEther("5", "ether"), //_ethThresholdCheck - parseEther("5", "ether") //_wethThresholdCheck + nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( + 0, //_validatorsDelta + 0, //_consensusRewardsDelta + parseEther("33") //_wethToVault ) - ).to.be.revertedWith("over accounting threshold"); + ).to.be.revertedWith("invalid wethToVaultAmount"); }); - it("Should allow 5/8 governor to recover paused contract and correct the accounting state", async () => { - const { nativeStakingSSVStrategy, strategist, governor, josh, weth } = - fixture; + it("Should allow strategist to recover paused contract by changing validators", async () => { + const { nativeStakingSSVStrategy, strategist } = fixture; + + await setActiveDepositedValidators(10, nativeStakingSSVStrategy); + + for (const validatorsDelta of [-1, 0, 1]) { + await nativeStakingSSVStrategy.connect(strategist).pause(); + const activeDepositedValidatorsBefore = + await nativeStakingSSVStrategy.activeDepositedValidators(); + + const tx = await nativeStakingSSVStrategy + .connect(strategist) + .manuallyFixAccounting(validatorsDelta, 0, 0); + + expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") + .withArgs(validatorsDelta, 0, 0); + + expect( + await nativeStakingSSVStrategy.activeDepositedValidators() + ).to.equal( + activeDepositedValidatorsBefore.add(validatorsDelta), + "active deposited validators not updated" + ); + } + }); + + describe("Should allow strategist to recover paused contract", async () => { + for (const delta of [-32, -20, -1, 0, 1, 20, 32]) { + it(`Should allow strategist to recover paused contract by changing ${delta} consensus rewards`, async () => { + const { nativeStakingSSVStrategy, strategist } = fixture; + + await setBalance(nativeStakingSSVStrategy.address, parseEther("68")); + await setConsensusRewards(parseEther("35"), nativeStakingSSVStrategy); + await setActiveDepositedValidators(10, nativeStakingSSVStrategy); + + await nativeStakingSSVStrategy.connect(strategist).pause(); + const consensusRewardsBefore = + await nativeStakingSSVStrategy.consensusRewards(); + const consensusRewardsDelta = parseEther(delta.toString()); + + const tx = await nativeStakingSSVStrategy + .connect(strategist) + .manuallyFixAccounting(0, consensusRewardsDelta, 0); + + expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") + .withArgs(0, consensusRewardsDelta, 0); + + // TODO fix this test + // expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + // consensusRewardsBefore.add(consensusRewardsDelta), + // "consensus rewards not updated" + // ); + }); + } + }); + + it("Should allow strategist to recover paused contract by changing WETH to vault", async () => { + const { nativeStakingSSVStrategy, strategist, josh, weth } = fixture; - await setBalance( - nativeStakingSSVStrategy.address, - parseEther("5", "ether") - ); await weth .connect(josh) - .transfer(nativeStakingSSVStrategy.address, parseEther("5", "ether")); + .transfer(nativeStakingSSVStrategy.address, parseEther("100")); + + for (const wethInEthers of [0, 1, 26, 32]) { + await nativeStakingSSVStrategy.connect(strategist).pause(); + const wethBefore = await weth.balanceOf( + nativeStakingSSVStrategy.address + ); + const wethToVault = parseEther(wethInEthers.toString()); + + const tx = await nativeStakingSSVStrategy + .connect(strategist) + .manuallyFixAccounting(0, 0, wethToVault); + + expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") + .withArgs(0, 0, wethToVault); + + expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( + wethBefore.sub(wethToVault), + "consensus rewards not updated" + ); + } + }); + + it("Should allow strategist to recover paused contract and correct the accounting state", async () => { + const { nativeStakingSSVStrategy, strategist, josh, weth } = fixture; + + await setBalance(nativeStakingSSVStrategy.address, parseEther("5")); + await weth + .connect(josh) + .transfer(nativeStakingSSVStrategy.address, parseEther("5")); await nativeStakingSSVStrategy.connect(strategist).pause(); // unit test fixture sets OUSD governor as accounting governor const tx = await nativeStakingSSVStrategy - .connect(governor) + .connect(strategist) .manuallyFixAccounting( - 3, //_activeDepositedValidators - parseEther("2.1", "ether"), //_ethToWeth - parseEther("2.2", "ether"), //_wethToBeSentToVault - parseEther("2.3", "ether"), //_beaconChainRewardWETH - parseEther("5", "ether"), //_ethThresholdCheck - parseEther("5", "ether") //_wethThresholdCheck + 1, //_validatorsDelta + parseEther("2.3"), //_consensusRewardsDeltaDelta + parseEther("2.2") //_wethToVault ); expect(tx) .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") .withArgs( - 0, // oldActiveDepositedValidators - 3, // activeDepositedValidators - 0, // oldBeaconChainRewardWETH - parseEther("2.3"), // beaconChainRewardWETH - parseEther("2.1"), // ethToWeth - parseEther("2.2") // wethToBeSentToVault + 1, // validatorsDelta + parseEther("2.3"), // consensusRewards + parseEther("2.2") // wethToVault ); }); }); @@ -747,8 +803,7 @@ describe("Unit test: Native SSV Staking Strategy", function () { describe(`given ${testCase.feeAccumulatorEth} execution rewards, ${testCase.consensusRewards} consensus rewards, ${testCase.deposits} deposits and ${nrOfActiveDepositedValidators} validators`, () => { beforeEach(async () => { - const { nativeStakingSSVStrategy, governor, strategist, weth, josh } = - fixture; + const { nativeStakingSSVStrategy, governor, weth, josh } = fixture; const feeAccumulatorAddress = await nativeStakingSSVStrategy.FEE_ACCUMULATOR_ADDRESS(); @@ -772,17 +827,11 @@ describe("Unit test: Native SSV Staking Strategy", function () { } // set the correct amount of staked validators - await nativeStakingSSVStrategy.connect(strategist).pause(); - await nativeStakingSSVStrategy - .connect(governor) - .manuallyFixAccounting( - nrOfActiveDepositedValidators, // activeDepositedValidators - parseEther("0"), //_ethToWeth - parseEther("0"), //_wethToBeSentToVault - consensusRewards, //_consensusRewards - parseEther("3000"), //_ethThresholdCheck - parseEther("3000") //_wethThresholdCheck - ); + await setActiveDepositedValidators( + nrOfActiveDepositedValidators, + nativeStakingSSVStrategy + ); + await setConsensusRewards(consensusRewards, nativeStakingSSVStrategy); // run the accounting await nativeStakingSSVStrategy.connect(governor).doAccounting(); @@ -827,3 +876,27 @@ describe("Unit test: Native SSV Staking Strategy", function () { } }); }); + +const setActiveDepositedValidators = async ( + validators, + nativeStakingSSVStrategy +) => { + await setStorageAt(nativeStakingSSVStrategy.address, 52, validators); + + expect(await nativeStakingSSVStrategy.activeDepositedValidators()).to.equal( + validators, + "validators no set properly" + ); +}; + +const setConsensusRewards = async ( + consensusRewards, + nativeStakingSSVStrategy +) => { + await setStorageAt(nativeStakingSSVStrategy.address, 104, consensusRewards); + + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + consensusRewards, + "consensusRewards no set properly" + ); +}; From 389a2604587008fee317e08dc943f35345bd9ad7 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Mon, 29 Apr 2024 14:57:41 +1000 Subject: [PATCH 02/30] Added pauseOnFail param to internal _doAccounting Increased the allowed delta values of manuallyFixAccounting --- .../NativeStaking/ValidatorAccountant.sol | 22 ++- .../docs/NativeStakingSSVStrategySquashed.svg | 2 +- contracts/test/strategies/nativeSSVStaking.js | 185 +++++++++--------- 3 files changed, 110 insertions(+), 99 deletions(-) diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol index 9ec0a943a5..9b0191718b 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol @@ -99,13 +99,16 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { whenNotPaused returns (bool accountingValid) { - accountingValid = _doAccounting(); + // pause the accounting on failure + accountingValid = _doAccounting(true); } - function _doAccounting() internal returns (bool accountingValid) { + function _doAccounting( + bool pauseOnFail + ) internal returns (bool accountingValid) { if (address(this).balance < consensusRewards) { // pause if not already - if (!paused()) { + if (pauseOnFail) { _pause(); } // fail the accounting @@ -161,7 +164,7 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { // Oh no... Fuse is blown. The Strategist needs to adjust the accounting values. else { // pause if not already - if (!paused()) { + if (pauseOnFail) { _pause(); } // fail the accounting @@ -179,15 +182,15 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { uint256 _wethToVaultAmount ) external onlyStrategist whenPaused { require( - _validatorsDelta >= -1 && - _validatorsDelta <= 1 && + _validatorsDelta >= -3 && + _validatorsDelta <= 3 && // new value must be positive int256(activeDepositedValidators) + _validatorsDelta >= 0, "invalid validatorsDelta" ); require( - _consensusRewardsDelta >= -32 ether && - _consensusRewardsDelta <= 32 ether && + _consensusRewardsDelta >= -332 ether && + _consensusRewardsDelta <= 332 ether && // new value must be positive int256(consensusRewards) + _consensusRewardsDelta >= 0, "invalid consensusRewardsDelta" @@ -214,7 +217,8 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { } // rerun the accounting to see if it has now been fixed. - require(_doAccounting(), "fuse still blown"); + // Do not pause the accounting on failure as it is already paused + require(_doAccounting(false), "fuse still blown"); // unpause since doAccounting was successful _unpause(); diff --git a/contracts/docs/NativeStakingSSVStrategySquashed.svg b/contracts/docs/NativeStakingSSVStrategySquashed.svg index a5055466dd..e66ffdaf08 100644 --- a/contracts/docs/NativeStakingSSVStrategySquashed.svg +++ b/contracts/docs/NativeStakingSSVStrategySquashed.svg @@ -66,7 +66,7 @@    _msgData(): bytes <<Context>>    _pause() <<whenNotPaused>> <<Pausable>>    _unpause() <<whenPaused>> <<Pausable>> -    _doAccounting(): (accountingValid: bool) <<ValidatorAccountant>> +    _doAccounting(pauseOnFail: bool): (accountingValid: bool) <<ValidatorAccountant>>    _initialize(_rewardTokenAddresses: address[], _assets: address[], _pTokens: address[]) <<InitializableAbstractStrategy>>    _collectRewardTokens() <<whenNotPaused>> <<NativeStakingSSVStrategy>>    _setPTokenAddress(_asset: address, _pToken: address) <<InitializableAbstractStrategy>> diff --git a/contracts/test/strategies/nativeSSVStaking.js b/contracts/test/strategies/nativeSSVStaking.js index 645747f522..1fd21a0ae6 100644 --- a/contracts/test/strategies/nativeSSVStaking.js +++ b/contracts/test/strategies/nativeSSVStaking.js @@ -156,10 +156,6 @@ describe("Unit test: Native SSV Staking Strategy", function () { .to.emit(nativeStakingSSVStrategy, "FuseIntervalUpdated") .withArgs(fuseStartBn, fuseEndBn); }); - - it("Only strategist can call fix accounting", async () => { - // TODO - }); }); describe("Accounting", function () { @@ -545,14 +541,14 @@ describe("Unit test: Native SSV Staking Strategy", function () { ).to.be.revertedWith("Pausable: not paused"); }); - it("Validators delta should not be >=-1 and <=1 for fix accounting function", async () => { + it("Validators delta should not be <-4 or >4 for fix accounting function", async () => { const { nativeStakingSSVStrategy, strategist } = fixture; await nativeStakingSSVStrategy.connect(strategist).pause(); await expect( nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( - -2, //_validatorsDelta + -4, //_validatorsDelta 0, //_consensusRewardsDelta 0 //_wethToVault ) @@ -560,14 +556,14 @@ describe("Unit test: Native SSV Staking Strategy", function () { await expect( nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( - 2, //_validatorsDelta + 4, //_validatorsDelta 0, //_consensusRewardsDelta 0 //_wethToVault ) ).to.be.revertedWith("invalid validatorsDelta"); }); - it("Consensus rewards delta should not be >=-32 and <=32 for fix accounting function", async () => { + it("Consensus rewards delta should not be <-333> and >333 for fix accounting function", async () => { const { nativeStakingSSVStrategy, strategist } = fixture; await nativeStakingSSVStrategy.connect(strategist).pause(); @@ -575,7 +571,7 @@ describe("Unit test: Native SSV Staking Strategy", function () { await expect( nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( 0, //_validatorsDelta - parseEther("-33"), //_consensusRewardsDelta + parseEther("-333"), //_consensusRewardsDelta 0 //_wethToVault ) ).to.be.revertedWith("invalid consensusRewardsDelta"); @@ -583,7 +579,7 @@ describe("Unit test: Native SSV Staking Strategy", function () { await expect( nativeStakingSSVStrategy.connect(strategist).manuallyFixAccounting( 0, //_validatorsDelta - parseEther("33"), //_consensusRewardsDelta + parseEther("333"), //_consensusRewardsDelta 0 //_wethToVault ) ).to.be.revertedWith("invalid consensusRewardsDelta"); @@ -603,45 +599,46 @@ describe("Unit test: Native SSV Staking Strategy", function () { ).to.be.revertedWith("invalid wethToVaultAmount"); }); - it("Should allow strategist to recover paused contract by changing validators", async () => { - const { nativeStakingSSVStrategy, strategist } = fixture; + describe("Should allow strategist to recover paused contract", async () => { + for (const validatorsDelta of [-3, -2, -1, 0, 1, 2, 3]) { + it(`by changing validators by ${validatorsDelta}`, async () => { + const { nativeStakingSSVStrategy, strategist } = fixture; - await setActiveDepositedValidators(10, nativeStakingSSVStrategy); + await setActiveDepositedValidators(10, nativeStakingSSVStrategy); - for (const validatorsDelta of [-1, 0, 1]) { - await nativeStakingSSVStrategy.connect(strategist).pause(); - const activeDepositedValidatorsBefore = - await nativeStakingSSVStrategy.activeDepositedValidators(); + await nativeStakingSSVStrategy.connect(strategist).pause(); + const activeDepositedValidatorsBefore = + await nativeStakingSSVStrategy.activeDepositedValidators(); - const tx = await nativeStakingSSVStrategy - .connect(strategist) - .manuallyFixAccounting(validatorsDelta, 0, 0); + const tx = await nativeStakingSSVStrategy + .connect(strategist) + .manuallyFixAccounting(validatorsDelta, 0, 0); - expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") - .withArgs(validatorsDelta, 0, 0); + expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") + .withArgs(validatorsDelta, 0, 0); - expect( - await nativeStakingSSVStrategy.activeDepositedValidators() - ).to.equal( - activeDepositedValidatorsBefore.add(validatorsDelta), - "active deposited validators not updated" - ); + expect( + await nativeStakingSSVStrategy.activeDepositedValidators() + ).to.equal( + activeDepositedValidatorsBefore.add(validatorsDelta), + "active deposited validators not updated" + ); + }); } - }); - describe("Should allow strategist to recover paused contract", async () => { - for (const delta of [-32, -20, -1, 0, 1, 20, 32]) { - it(`Should allow strategist to recover paused contract by changing ${delta} consensus rewards`, async () => { + for (const delta of [-332, -320, -1, 0, 1, 320, 332]) { + it(`by changing consensus rewards by ${delta}`, async () => { const { nativeStakingSSVStrategy, strategist } = fixture; - await setBalance(nativeStakingSSVStrategy.address, parseEther("68")); - await setConsensusRewards(parseEther("35"), nativeStakingSSVStrategy); - await setActiveDepositedValidators(10, nativeStakingSSVStrategy); + await setBalance(nativeStakingSSVStrategy.address, parseEther("670")); + await setConsensusRewards( + parseEther("336"), + nativeStakingSSVStrategy + ); + await setActiveDepositedValidators(10000, nativeStakingSSVStrategy); await nativeStakingSSVStrategy.connect(strategist).pause(); - const consensusRewardsBefore = - await nativeStakingSSVStrategy.consensusRewards(); const consensusRewardsDelta = parseEther(delta.toString()); const tx = await nativeStakingSSVStrategy @@ -652,69 +649,79 @@ describe("Unit test: Native SSV Staking Strategy", function () { .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") .withArgs(0, consensusRewardsDelta, 0); - // TODO fix this test - // expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( - // consensusRewardsBefore.add(consensusRewardsDelta), - // "consensus rewards not updated" - // ); + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + await nativeStakingSSVStrategy.provider.getBalance( + nativeStakingSSVStrategy.address + ), + "consensus rewards matches eth balance" + ); }); } - }); - it("Should allow strategist to recover paused contract by changing WETH to vault", async () => { - const { nativeStakingSSVStrategy, strategist, josh, weth } = fixture; + it("by sending WETH to vault", async () => { + const { nativeStakingSSVStrategy, strategist, josh, weth } = fixture; - await weth - .connect(josh) - .transfer(nativeStakingSSVStrategy.address, parseEther("100")); + await weth + .connect(josh) + .transfer(nativeStakingSSVStrategy.address, parseEther("100")); - for (const wethInEthers of [0, 1, 26, 32]) { - await nativeStakingSSVStrategy.connect(strategist).pause(); - const wethBefore = await weth.balanceOf( - nativeStakingSSVStrategy.address - ); - const wethToVault = parseEther(wethInEthers.toString()); + for (const wethInEthers of [0, 1, 26, 32]) { + await nativeStakingSSVStrategy.connect(strategist).pause(); + const wethBefore = await weth.balanceOf( + nativeStakingSSVStrategy.address + ); + const wethToVault = parseEther(wethInEthers.toString()); - const tx = await nativeStakingSSVStrategy - .connect(strategist) - .manuallyFixAccounting(0, 0, wethToVault); + const tx = await nativeStakingSSVStrategy + .connect(strategist) + .manuallyFixAccounting(0, 0, wethToVault); - expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") - .withArgs(0, 0, wethToVault); + expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") + .withArgs(0, 0, wethToVault); - expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( - wethBefore.sub(wethToVault), - "consensus rewards not updated" - ); - } - }); + expect( + await weth.balanceOf(nativeStakingSSVStrategy.address) + ).to.equal( + wethBefore.sub(wethToVault), + "consensus rewards not updated" + ); - it("Should allow strategist to recover paused contract and correct the accounting state", async () => { - const { nativeStakingSSVStrategy, strategist, josh, weth } = fixture; + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + await nativeStakingSSVStrategy.provider.getBalance( + nativeStakingSSVStrategy.address + ), + "consensus rewards matches eth balance" + ); + } + }); - await setBalance(nativeStakingSSVStrategy.address, parseEther("5")); - await weth - .connect(josh) - .transfer(nativeStakingSSVStrategy.address, parseEther("5")); + it("by changing all three manuallyFixAccounting delta values", async () => { + const { nativeStakingSSVStrategy, strategist, josh, weth } = fixture; - await nativeStakingSSVStrategy.connect(strategist).pause(); - // unit test fixture sets OUSD governor as accounting governor - const tx = await nativeStakingSSVStrategy - .connect(strategist) - .manuallyFixAccounting( - 1, //_validatorsDelta - parseEther("2.3"), //_consensusRewardsDeltaDelta - parseEther("2.2") //_wethToVault - ); + await setBalance(nativeStakingSSVStrategy.address, parseEther("5")); + await weth + .connect(josh) + .transfer(nativeStakingSSVStrategy.address, parseEther("5")); - expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") - .withArgs( - 1, // validatorsDelta - parseEther("2.3"), // consensusRewards - parseEther("2.2") // wethToVault - ); + await nativeStakingSSVStrategy.connect(strategist).pause(); + // unit test fixture sets OUSD governor as accounting governor + const tx = await nativeStakingSSVStrategy + .connect(strategist) + .manuallyFixAccounting( + 1, //_validatorsDelta + parseEther("2.3"), //_consensusRewardsDeltaDelta + parseEther("2.2") //_wethToVault + ); + + expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingManuallyFixed") + .withArgs( + 1, // validatorsDelta + parseEther("2.3"), // consensusRewards + parseEther("2.2") // wethToVault + ); + }); }); }); From a332c98a8bca6c9e1dc48d6469f483a18001d4b6 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Mon, 29 Apr 2024 18:11:03 +1000 Subject: [PATCH 03/30] ran prettier --- .../strategies/NativeStaking/NativeStakingSSVStrategy.sol | 5 +++-- .../strategies/NativeStaking/ValidatorAccountant.sol | 7 ++++--- .../strategies/NativeStaking/ValidatorRegistrator.sol | 4 +++- 3 files changed, 10 insertions(+), 6 deletions(-) diff --git a/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol b/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol index 970251e776..79629473cd 100644 --- a/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol +++ b/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol @@ -251,14 +251,15 @@ contract NativeStakingSSVStrategy is } /** - * @notice Only accept ETH from the FeeAccumulator and the WETH contract - required when + * @notice Only accept ETH from the FeeAccumulator and the WETH contract - required when * unwrapping WETH just before staking it to the validator * @dev don't want to receive donations from anyone else as this will * mess with the accounting of the consensus rewards and validator full withdrawals */ receive() external payable { require( - msg.sender == FEE_ACCUMULATOR_ADDRESS || msg.sender == WETH_TOKEN_ADDRESS, + msg.sender == FEE_ACCUMULATOR_ADDRESS || + msg.sender == WETH_TOKEN_ADDRESS, "eth not from allowed contracts" ); } diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol index 9b0191718b..6edcf44f69 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol @@ -103,9 +103,10 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { accountingValid = _doAccounting(true); } - function _doAccounting( - bool pauseOnFail - ) internal returns (bool accountingValid) { + function _doAccounting(bool pauseOnFail) + internal + returns (bool accountingValid) + { if (address(this).balance < consensusRewards) { // pause if not already if (pauseOnFail) { diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol b/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol index ee509eb8e0..b6f61eecd2 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorRegistrator.sol @@ -134,7 +134,9 @@ abstract contract ValidatorRegistrator is Governable, Pausable { bytes11(0), address(this) ); - IDepositContract(BEACON_CHAIN_DEPOSIT_CONTRACT).deposit{ value: 32 ether }( + IDepositContract(BEACON_CHAIN_DEPOSIT_CONTRACT).deposit{ + value: 32 ether + }( validators[i].pubkey, withdrawal_credentials, validators[i].signature, From e8201dc2f910b019158c983ff4352bbdd89d845d Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Mon, 29 Apr 2024 21:24:28 +1000 Subject: [PATCH 04/30] Added Defender Relayer for validator registrator Added ssv utils to get cluster data Added native staking fork tests --- contracts/deploy/091_native_ssv_staking.js | 6 + contracts/package.json | 2 + contracts/test/_fixture.js | 7 +- .../strategies/nativeSsvStaking.fork-test.js | 174 ++++++++++++++- contracts/utils/addresses.js | 12 +- contracts/utils/signers.js | 2 +- contracts/utils/ssv.js | 198 ++++++++++++++++++ 7 files changed, 392 insertions(+), 9 deletions(-) create mode 100644 contracts/utils/ssv.js diff --git a/contracts/deploy/091_native_ssv_staking.js b/contracts/deploy/091_native_ssv_staking.js index ae57bacb0c..fa5dfc035f 100644 --- a/contracts/deploy/091_native_ssv_staking.js +++ b/contracts/deploy/091_native_ssv_staking.js @@ -153,6 +153,12 @@ module.exports = deploymentWithGovernanceProposal( ethers.utils.parseEther("25.6"), ], }, + // 5. set validator registrator + { + contract: cStrategy, + signature: "setRegistrator(address)", + args: [addresses.mainnet.validatorRegistrator], + }, ], }; } diff --git a/contracts/package.json b/contracts/package.json index 74100a2bb0..e174799d3a 100644 --- a/contracts/package.json +++ b/contracts/package.json @@ -71,6 +71,8 @@ "solhint": "^3.4.1", "solidifier": "^2.2.3", "solidity-coverage": "^0.8.2", + "ssv-keys": "^1.1.0", + "ssv-scanner": "github:bloxapp/ssv-scanner", "sync-fetch": "^0.5.2", "web3-utils": "^1.5.2" }, diff --git a/contracts/test/_fixture.js b/contracts/test/_fixture.js index 513ac4bbab..d5a55d5ad1 100644 --- a/contracts/test/_fixture.js +++ b/contracts/test/_fixture.js @@ -1420,6 +1420,10 @@ async function nativeStakingSSVStrategyFixture() { await oethVault .connect(timelock) .setAssetDefaultStrategy(weth.address, nativeStakingSSVStrategy.address); + + fixture.validatorRegistrator = await ethers.provider.getSigner( + addresses.mainnet.validatorRegistrator + ); } else { const { governorAddr } = await getNamedAccounts(); const { oethVault, weth, nativeStakingSSVStrategy } = fixture; @@ -1430,8 +1434,6 @@ async function nativeStakingSSVStrategyFixture() { .connect(sGovernor) .approveStrategy(nativeStakingSSVStrategy.address); - log("nativeStakingSSVStrategy.address", nativeStakingSSVStrategy.address); - const fuseStartBn = ethers.utils.parseEther("21.6"); const fuseEndBn = ethers.utils.parseEther("25.6"); @@ -1447,7 +1449,6 @@ async function nativeStakingSSVStrategyFixture() { await nativeStakingSSVStrategy .connect(sGovernor) .setRegistrator(governorAddr); - } return fixture; diff --git a/contracts/test/strategies/nativeSsvStaking.fork-test.js b/contracts/test/strategies/nativeSsvStaking.fork-test.js index 3fbd13a3c5..9aa5101082 100644 --- a/contracts/test/strategies/nativeSsvStaking.fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.fork-test.js @@ -1,6 +1,10 @@ const { expect } = require("chai"); +const { AddressZero } = require("@ethersproject/constants"); +const { oethUnits } = require("../helpers"); const addresses = require("../../utils/addresses"); +const { impersonateAndFund } = require("../../utils/signers"); +const { getClusterInfo } = require("../../utils/ssv"); const { createFixtureLoader, @@ -33,14 +37,178 @@ describe("ForkTest: Native SSV Staking Strategy", function () { await expect( await nativeStakingSSVStrategy.SSV_NETWORK_ADDRESS() ).to.equal(addresses.mainnet.SSVNetwork, "Incorrect SSV Network address"); + await expect( + await nativeStakingSSVStrategy.BEACON_CHAIN_DEPOSIT_CONTRACT() + ).to.equal( + addresses.mainnet.beaconChainDepositContract, + "Incorrect Beacon deposit contract" + ); + await expect(await nativeStakingSSVStrategy.VAULT_ADDRESS()).to.equal( + addresses.mainnet.OETHVaultProxy, + "Incorrect OETH Vault address" + ); + await expect(await nativeStakingSSVStrategy.fuseIntervalStart()).to.equal( + oethUnits("21.6"), + "Incorrect fuse start" + ); + await expect(await nativeStakingSSVStrategy.fuseIntervalEnd()).to.equal( + oethUnits("25.6"), + "Incorrect fuse end" + ); + await expect( + await nativeStakingSSVStrategy.validatorRegistrator() + ).to.equal( + addresses.mainnet.validatorRegistrator, + "Incorrect validator registrator" + ); + }); + }); + + describe("Deposit/Allocation", function () { + it("Should accept and handle WETH allocation", async () => { + const { oethVault, weth, domen, nativeStakingSSVStrategy } = fixture; + const fakeVaultSigner = await impersonateAndFund(oethVault.address); + + const depositAmount = oethUnits("32"); + const wethBalanceBefore = await weth.balanceOf( + nativeStakingSSVStrategy.address + ); + const strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( + weth.address + ); + + // Transfer some WETH to strategy + await weth + .connect(domen) + .transfer(nativeStakingSSVStrategy.address, depositAmount); + + // Call deposit by impersonating the Vault + const tx = await nativeStakingSSVStrategy + .connect(fakeVaultSigner) + .deposit(weth.address, depositAmount); + + expect(tx) + .to.emit(nativeStakingSSVStrategy, "Deposit") + .withArgs(weth.address, AddressZero, depositAmount); + + expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( + wethBalanceBefore.add(depositAmount), + "WETH not transferred" + ); + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal( + strategyBalanceBefore.add(depositAmount), + "strategy checkBalance not increased" + ); }); + }); + + describe("Spin up a new validator", function () { + const testValidator = { + publicKey: + "0xad9ade40c386259fe4161ec12d7746ab49a098a4760a279c56dc7e26b56fc4d985e74eeecdd2bc5a1decceb5174204f4", + operatorIds: [193, 196, 199, 202], + sharesData: + "0x8308e4b6ad536304f978077a0cd3685a98d5847bb1b05e0a4c5994ddf64ce48daa917f666d86f3125aac139a4fc7b07119ea2c7fc0fe5cfb316a5687dbddf621b0229e55230f0857d426697513ee2556d2c730595268358ebe8e16331bd2dd53acfd93e4e96c5fb510f78dc0f11e5097f83b2609a5711b233fa843935125dbbd90e43dc4f7d181221a42fcc02fe58aeb90fefb6a1d46faad099b6fa8e68351ff21f52d90a96bffeb33d1c0517bf39e413a441f1c290f1289021e9bd47146689ba139bccfaf7d6d1a6fba03c177d9ffca11f347b0f16a1cd8b1808a9b46ec0849ff45562a853ea137dfea3a0ed43ceac5805a993edd6b618cf7aa1441b2deeb2a7a573f0a44d9ed6bffb75573a91e9de2c21e198815d9b133ce7060ff339bf23b12af3c15f566b81842f307066205f09b40b4db045af881f5ca571289d1aa52555002544e8941b854b1b565b5e76c845c4b287a46890d6ad3e01185d2fb5485ecb136814a23378d37ff53244c1420af43db268f74bf0532dd235cb2afd49d1dce7158d1f51650bc32b790f29bdfc2bafc9990a55a15d005139c6ede259a6a9426400d67192ec697a8990c326bc63fe8a809515d0cc311059da2e333cb92331c45ac8b8d2e09a8cc4092016ade9f90a4b1a89a89f9da38818a5a77f84ae2aba340719dc6a01810ddfcd9e9cf9ebfab033363d2a58296cd1ab8e33ea4e04738111a3e2d80d34c601b0b49e95412cdd554a844f02a94f7f239e70cb72247c36218de79b5d0d73a7429cccf1999eca2611b1c486e8148451cac60bc60280764948f54100a39d9290c368a2ace60daa3ff1bf9dd7514afd02397c196b9cee8ef94478619a114cbebdf4475053857f2728c7621c5fb6739cbf8a15727c5d15a354e20ac054f31e51288a4f94a4215d00d23d2e5a82f745f2f15d6b147ecf817165913f2f72f492075de8f339efe54f163311f7de056c36a900949f7f026c17a96770edd29ba0301732bb83d218a0fb28d466858118e7240725ee74a45fd3acf8ca7310cb72f6cb3c6f8517b89984ad622ffeb39dad587d2e944d59fe849841fc5f09e9f1935cc59b10c795446eb18a2f87e6ee1a497fe0bb556164cd2d7b5c7cf5fdb758e8fc26711116bf59a08be68d2ddb9a97300d2ac43055877a0cc3be97c8b82ceb5dd59f6222c23d849dc7620ffca0393d685cb609059e0e8a76500c9c92d7878a3939c346897d10c6707d39bd10d0f546f6506b6b087dea16156478e11d9537d169d582ca26a04dceede25a38b5a4bf2e16db9db97bdb320f198632a0b60af8ebdf3e6a0bda19f34c9ddc7e437d3fef3da021cae41dd99d2898d825db9de51561dee2a5587fa75453609fff5aec3e949a34fd438f00ab6dbca03e385059003936db14c66d4fec38d6ba729051866c336c51c802507dc5b16b591a4905636736a05bbd0d39ba965de131abad34797e3521ff01612b1bd17aca6af61abf8bd24182a1e2848fc41819c0ce7065000747023db82de23eef601ed7cdaffd39b005e8bb8156f4986d9825e62cd2f13f8c0e33e5825e8d81730ef1a63dfd19af6afd08f9f102f403783dca89173456d9e60fb72b2c153bf0bb73bed799a15eb94923f7cadd9c9bc529a86051d8202b1af53ccb161179f9c4609084dd977091082fc14c20ff21efd70bb9ca56b0ea80c7fc16e2f1718c7b306944fa6c7572440c7d6035a22cea8858f64bb3b6d147a05743021ca1b79d71bac87888bb5fd343b1817a28dda336f1d640f8adae159020deba8d3e1e97ae0b9a4ba23112e59d93169a7b875fc878f66f13b2568ed326f9da7ba6c2bd08d37f5b0ef6bfe56febe20e366fa9d", + signature: + "0xadf71438600db72305e4a277554c06359d25e59480e2c4d5ea9d12d132088893d2df141c60a0857c63edc10b9800ac0e0e3e3dcd7b5fdfbcab8fbf377816811becc8be9420c17a725dff9dac6653230b9c5c04fd2ea19f9313fe943e1a562a18", + depositDataRoot: + "0x0d12c28849771f3f946d8d705a1f73683d97add9edaec5e6b30650cc03bc57d5", + }; + + beforeEach(async () => { + const { nativeStakingSSVStrategy, ssv } = fixture; + // Add some ETH to the Defender Relayer account + // TODO this can be removed once the account is funded on mainnet + await impersonateAndFund(addresses.mainnet.validatorRegistrator, 1); + + // Fund some SSV to the native staking strategy + const ssvWhale = await impersonateAndFund( + "0xf977814e90da44bfa03b6295a0616a897441acec" // Binance 8 + ); + await ssv + .connect(ssvWhale) + .transfer(nativeStakingSSVStrategy.address, oethUnits("100")); + }); + + it("Should register and staked 32 ETH by validator registrator", async () => { + const { weth, domen, nativeStakingSSVStrategy, validatorRegistrator } = + fixture; + // Add 32 WETH to the strategy so it can be staked + await weth + .connect(domen) + .transfer(nativeStakingSSVStrategy.address, oethUnits("32")); + const strategyWethBalanceBefore = await weth.balanceOf( + nativeStakingSSVStrategy.address + ); + + const { cluster } = await getClusterInfo({ + ownerAddress: nativeStakingSSVStrategy.address, + operatorIds: testValidator.operatorIds, + chainId: 1, + ssvNetwork: addresses.mainnet.SSVNetwork, + }); + const stakeAmount = oethUnits("32"); + + // Register a new validator with the SSV Network + const regTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .registerSsvValidator( + testValidator.publicKey, + testValidator.operatorIds, + testValidator.sharesData, + stakeAmount, + cluster + ); + await expect(regTx) + .to.emit(nativeStakingSSVStrategy, "SSVValidatorRegistered") + .withArgs(testValidator.publicKey, testValidator.operatorIds); - it.skip("Should check that the fuse interval is configured correctly", async () => {}); + // Stake 32 ETH to the new validator + const stakeTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .stakeEth([ + { + pubkey: testValidator.publicKey, + signature: testValidator.signature, + depositDataRoot: testValidator.depositDataRoot, + }, + ]); + + await expect(stakeTx) + .to.emit(nativeStakingSSVStrategy, "ETHStaked") + .withNamedArgs({ + pubkey: testValidator.publicKey, + amount: stakeAmount, + }); + + expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( + strategyWethBalanceBefore.sub( + stakeAmount, + "strategy WETH not decreased" + ) + ); + }); }); - describe("Deposit/Allocation", function () {}); + describe("ETH rewards", function () { + it("Should account for new consensus rewards", async () => { + // check balance should not increase + }); + it("Strategist should account for new execution rewards", async () => { + // check balance should not increase + }); + }); - describe("Withdraw", function () {}); + describe("Withdraw", function () { + it("Should account for full withdrawal from validator", async () => { + // check balance should not increase after sweep but before accounting + // check balance should increase after accounting + // check balance should decrease after withdrawal + // WETH in vault should decrease after withdrawal + }); + }); describe("Balance/Assets", function () {}); }); diff --git a/contracts/utils/addresses.js b/contracts/utils/addresses.js index 36c557e3b1..2213cf7ac5 100644 --- a/contracts/utils/addresses.js +++ b/contracts/utils/addresses.js @@ -179,7 +179,7 @@ addresses.mainnet.OldTimelock = "0x72426BA137DEC62657306b12B1E869d43FeC6eC7"; // OETH addresses.mainnet.OETHProxy = "0x856c4Efb76C1D1AE02e20CEB03A2A6a08b0b8dC3"; addresses.mainnet.WOETHProxy = "0xDcEe70654261AF21C44c093C300eD3Bb97b78192"; -addresses.mainnet.OETHVaultProxy = "0x39254033945aa2e4809cc2977e7087bee48bd7ab"; +addresses.mainnet.OETHVaultProxy = "0x39254033945AA2E4809Cc2977E7087BEE48bd7Ab"; addresses.mainnet.OETHZapper = "0x9858e47BCbBe6fBAC040519B02d7cd4B2C470C66"; addresses.mainnet.FraxETHStrategy = "0x3ff8654d633d4ea0fae24c52aec73b4a20d0d0e5"; @@ -244,7 +244,15 @@ addresses.mainnet.CurveCVXPool = "0xB576491F1E6e5E62f1d8F26062Ee822B40B0E0d4"; addresses.mainnet.SSV = "0x9D65fF81a3c488d585bBfb0Bfe3c7707c7917f54"; addresses.mainnet.SSVNetwork = "0xDD9BC35aE942eF0cFa76930954a156B3fF30a4E1"; addresses.mainnet.beaconChainDepositContract = - "0x00000000219ab540356cbb839cbe05303d7705fa"; + "0x00000000219ab540356cBB839Cbe05303d7705Fa"; + +// Native Staking Strategy +addresses.mainnet.nativeStakingSSVStrategyProxy = + "0xdF58F78cebbb2A60740eD2f86cDf0545a485102F"; +addresses.mainnet.nativeStakingFeeAccumulatorProxy = + "0x85094b52754591A3dE0002AD97F433584389aea0"; +addresses.mainnet.validatorRegistrator = + "0x4b91827516f79d6F6a1F292eD99671663b09169a"; // Arbitrum One addresses.arbitrumOne = {}; diff --git a/contracts/utils/signers.js b/contracts/utils/signers.js index dd16417d4b..d35dfb65a5 100644 --- a/contracts/utils/signers.js +++ b/contracts/utils/signers.js @@ -103,7 +103,7 @@ async function impersonateAndFund(account, amount = "100") { const signer = await impersonateAccount(account); log(`Funding account ${account} with ${amount} ETH`); - await hardhatSetBalance(account, amount); + await hardhatSetBalance(account, amount.toString()); return signer; } diff --git a/contracts/utils/ssv.js b/contracts/utils/ssv.js new file mode 100644 index 0000000000..e5ca31cfba --- /dev/null +++ b/contracts/utils/ssv.js @@ -0,0 +1,198 @@ +const { logTxDetails } = require("../utils/txLogger"); +const { parseUnits, formatUnits } = require("ethers/lib/utils"); +const { ClusterScanner, NonceScanner } = require("ssv-scanner"); +const { SSVKeys, KeyShares, KeySharesItem } = require("ssv-keys"); +const path = require("path"); +const fsp = require("fs").promises; + +const log = require("../utils/logger")("utils:ssv"); + +const depositSSV = async (options) => { + const { signer, chainId, nodeDelegator, ssvNetwork, amount, operatorIds } = + options; + const amountBN = parseUnits(amount.toString(), 18); + + // Cluster details + const clusterInfo = await getClusterInfo({ + chainId, + ssvNetwork, + operatorIds, + ownerAddress: nodeDelegator.address, + }); + + log( + `About to deposit ${formatUnits( + amountBN + )} SSV tokens to the SSV Network for NodeDelegator ${ + nodeDelegator.address + } with operator IDs ${operatorIds}` + ); + log(`Cluster: ${JSON.stringify(clusterInfo.snapshot)}`); + const tx = await nodeDelegator + .connect(signer) + .depositSSV(operatorIds, amountBN, clusterInfo.cluster); + await logTxDetails(tx, "depositSSV"); +}; + +const splitValidatorKey = async ({ + keystorelocation, + keystorepass, + operatorIds, + operatorkeys, + ownerAddress, + chainId, + ssvNetwork, +}) => { + const operatorKeys = operatorkeys.split("."); + const keystoreLocation = path.join(__dirname, "..", "..", keystorelocation); + const nextNonce = await getClusterNonce({ + ownerAddress, + operatorIds, + chainId, + ssvNetwork, + }); + + log(`Reading keystore location: ${keystoreLocation}`); + log(`For operatorIds: ${operatorIds}`); + log( + `Next SSV register validator nonce for owner ${ownerAddress}: ${nextNonce}` + ); + // TODO: 30+ start and end character of operators are the same. how to represent this? + log( + "Operator keys: ", + operatorKeys.map((key) => `${key.slice(0, 10)}...${key.slice(-10)}`) + ); + + const keystoreJson = require(keystoreLocation); + + // 1. Initialize SSVKeys SDK and read the keystore file + const ssvKeys = new SSVKeys(); + const { publicKey, privateKey } = await ssvKeys.extractKeys( + keystoreJson, + keystorepass + ); + + const operators = operatorKeys.map((operatorKey, index) => ({ + id: operatorIds[index], + operatorKey, + })); + + // 2. Build shares from operator IDs and public keys + const encryptedShares = await ssvKeys.buildShares(privateKey, operators); + const keySharesItem = new KeySharesItem(); + await keySharesItem.update({ operators }); + await keySharesItem.update({ + ownerAddress: ownerAddress, + ownerNonce: nextNonce, + publicKey, + }); + + // 3. Build final web3 transaction payload and update keyshares file with payload data + await keySharesItem.buildPayload( + { + publicKey, + operators, + encryptedShares, + }, + { + ownerAddress: ownerAddress, + ownerNonce: nextNonce, + privateKey, + } + ); + + const keyShares = new KeyShares(); + keyShares.add(keySharesItem); + + const keystoreFilePath = path.join( + __dirname, + "..", + "..", + "validator_key_data", + "keyshares_data", + `${publicKey.slice(0, 10)}_keyshares.json` + ); + log(`Saving distributed validator shares_data into: ${keystoreFilePath}`); + await fsp.writeFile(keystoreFilePath, keyShares.toJson(), { + encoding: "utf-8", + }); +}; + +const getClusterInfo = async ({ + ownerAddress, + operatorIds, + chainId, + ssvNetwork, +}) => { + const ssvNetworkName = chainId === 1 ? "MAINNET" : "HOLESKY"; + log(`SSV network: ${ssvNetworkName}`); + const providerUrl = process.env.PROVIDER_URL; + log(`Provider URL: ${providerUrl}`); + + const params = { + nodeUrl: providerUrl, // this can be an Infura, or Alchemy node, necessary to query the blockchain + contractAddress: ssvNetwork, // this is the address of SSV smart contract + ownerAddress, // this is the wallet address of the cluster owner + /* Based on the network they fetch contract ABIs. See code: https://github.com/bloxapp/ssv-scanner/blob/v1.0.3/src/lib/contract.provider.ts#L16-L22 + * and the ABIs are fetched from here: https://github.com/bloxapp/ssv-scanner/tree/v1.0.3/src/shared/abi + * + * Prater seems to work for Goerli at the moment + */ + network: ssvNetworkName, + operatorIds, // this is a list of operator IDs chosen by the owner for their cluster + }; + + // ClusterScanner is initialized with the given parameters + const clusterScanner = new ClusterScanner(params); + // and when run, it returns the Cluster Snapshot + const result = await clusterScanner.run(params.operatorIds); + const cluster = { + block: result.payload.Block, + snapshot: result.cluster, + cluster: Object.values(result.cluster), + }; + log(`Cluster info ${JSON.stringify(cluster)}`); + return cluster; +}; + +const getClusterNonce = async ({ + ownerAddress, + operatorIds, + chainId, + ssvNetwork, +}) => { + const ssvNetworkName = chainId === 1 ? "MAINNET" : "HOLESKY"; + const providerUrl = process.env.PROVIDER_URL; + + const params = { + nodeUrl: providerUrl, // this can be an Infura, or Alchemy node, necessary to query the blockchain + contractAddress: ssvNetwork, // this is the address of SSV smart contract + ownerAddress, // this is the wallet address of the cluster owner + /* Based on the network they fetch contract ABIs. See code: https://github.com/bloxapp/ssv-scanner/blob/v1.0.3/src/lib/contract.provider.ts#L16-L22 + * and the ABIs are fetched from here: https://github.com/bloxapp/ssv-scanner/tree/v1.0.3/src/shared/abi + * + * Prater seems to work for Goerli at the moment + */ + network: ssvNetworkName, + operatorIds, // this is a list of operator IDs chosen by the owner for their cluster + }; + + const nonceScanner = new NonceScanner(params); + const nextNonce = await nonceScanner.run(); + return nextNonce; +}; + +const printClusterInfo = async (options) => { + const cluster = await getClusterInfo(options); + const nextNonce = await getClusterNonce(options); + console.log(`block ${cluster.block}`); + console.log(`Cluster: ${JSON.stringify(cluster.snapshot, null, " ")}`); + console.log("Next Nonce:", nextNonce); +}; + +module.exports = { + depositSSV, + printClusterInfo, + getClusterInfo, + splitValidatorKey, +}; From 76c703f310cec5369725b02001f485ae4635c8f1 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Mon, 29 Apr 2024 21:26:22 +1000 Subject: [PATCH 05/30] Removed now redundant IWETH9 import --- contracts/contracts/strategies/NativeStaking/FeeAccumulator.sol | 1 - 1 file changed, 1 deletion(-) diff --git a/contracts/contracts/strategies/NativeStaking/FeeAccumulator.sol b/contracts/contracts/strategies/NativeStaking/FeeAccumulator.sol index 00ee3e8bee..175c2e5edc 100644 --- a/contracts/contracts/strategies/NativeStaking/FeeAccumulator.sol +++ b/contracts/contracts/strategies/NativeStaking/FeeAccumulator.sol @@ -4,7 +4,6 @@ pragma solidity ^0.8.0; import { Address } from "@openzeppelin/contracts/utils/Address.sol"; import { Governable } from "../../governance/Governable.sol"; -import { IWETH9 } from "../../interfaces/IWETH9.sol"; /** * @title Fee Accumulator for Native Staking SSV Strategy From 8bf8f7dd025eaab1ebcf7a1b5eb109299ee40e0c Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Tue, 30 Apr 2024 09:27:16 +1000 Subject: [PATCH 06/30] moved more logic into native staking fixture --- contracts/test/_fixture.js | 14 ++++++++++++-- .../strategies/nativeSsvStaking.fork-test.js | 16 +--------------- contracts/utils/ssv.js | 8 ++++++-- 3 files changed, 19 insertions(+), 19 deletions(-) diff --git a/contracts/test/_fixture.js b/contracts/test/_fixture.js index 466bdbf0b7..a3867bd7c0 100644 --- a/contracts/test/_fixture.js +++ b/contracts/test/_fixture.js @@ -1551,14 +1551,24 @@ async function nativeStakingSSVStrategyFixture() { }); if (isFork) { - const { oethVault, weth, nativeStakingSSVStrategy, timelock } = fixture; + const { oethVault, weth, nativeStakingSSVStrategy, ssv, timelock } = + fixture; await oethVault .connect(timelock) .setAssetDefaultStrategy(weth.address, nativeStakingSSVStrategy.address); - fixture.validatorRegistrator = await ethers.provider.getSigner( + // The Defender Relayer + fixture.validatorRegistrator = await impersonateAndFund( addresses.mainnet.validatorRegistrator ); + + // Fund some SSV to the native staking strategy + const ssvWhale = await impersonateAndFund( + "0xf977814e90da44bfa03b6295a0616a897441acec" // Binance 8 + ); + await ssv + .connect(ssvWhale) + .transfer(nativeStakingSSVStrategy.address, oethUnits("100")); } else { const { governorAddr } = await getNamedAccounts(); const { oethVault, weth, nativeStakingSSVStrategy } = fixture; diff --git a/contracts/test/strategies/nativeSsvStaking.fork-test.js b/contracts/test/strategies/nativeSsvStaking.fork-test.js index 9aa5101082..2a0cb82100 100644 --- a/contracts/test/strategies/nativeSsvStaking.fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.fork-test.js @@ -117,21 +117,6 @@ describe("ForkTest: Native SSV Staking Strategy", function () { "0x0d12c28849771f3f946d8d705a1f73683d97add9edaec5e6b30650cc03bc57d5", }; - beforeEach(async () => { - const { nativeStakingSSVStrategy, ssv } = fixture; - // Add some ETH to the Defender Relayer account - // TODO this can be removed once the account is funded on mainnet - await impersonateAndFund(addresses.mainnet.validatorRegistrator, 1); - - // Fund some SSV to the native staking strategy - const ssvWhale = await impersonateAndFund( - "0xf977814e90da44bfa03b6295a0616a897441acec" // Binance 8 - ); - await ssv - .connect(ssvWhale) - .transfer(nativeStakingSSVStrategy.address, oethUnits("100")); - }); - it("Should register and staked 32 ETH by validator registrator", async () => { const { weth, domen, nativeStakingSSVStrategy, validatorRegistrator } = fixture; @@ -149,6 +134,7 @@ describe("ForkTest: Native SSV Staking Strategy", function () { chainId: 1, ssvNetwork: addresses.mainnet.SSVNetwork, }); + // const cluster = ["0", "0", "0", true, "0"]; const stakeAmount = oethUnits("32"); // Register a new validator with the SSV Network diff --git a/contracts/utils/ssv.js b/contracts/utils/ssv.js index e5ca31cfba..1177cbc749 100644 --- a/contracts/utils/ssv.js +++ b/contracts/utils/ssv.js @@ -1,10 +1,12 @@ -const { logTxDetails } = require("../utils/txLogger"); const { parseUnits, formatUnits } = require("ethers/lib/utils"); const { ClusterScanner, NonceScanner } = require("ssv-scanner"); const { SSVKeys, KeyShares, KeySharesItem } = require("ssv-keys"); const path = require("path"); const fsp = require("fs").promises; +const { isForkWithLocalNode } = require("../test/helpers"); +const { logTxDetails } = require("../utils/txLogger"); + const log = require("../utils/logger")("utils:ssv"); const depositSSV = async (options) => { @@ -126,7 +128,9 @@ const getClusterInfo = async ({ }) => { const ssvNetworkName = chainId === 1 ? "MAINNET" : "HOLESKY"; log(`SSV network: ${ssvNetworkName}`); - const providerUrl = process.env.PROVIDER_URL; + const providerUrl = isForkWithLocalNode + ? "http://localhost:8545/" + : process.env.PROVIDER_URL; log(`Provider URL: ${providerUrl}`); const params = { From 86e7d29c2ef202e28ec97e2f5e950675c699dcf4 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Wed, 1 May 2024 11:25:18 +1000 Subject: [PATCH 07/30] Removed unused imports --- .../strategies/NativeStaking/NativeStakingSSVStrategy.sol | 2 -- .../contracts/strategies/NativeStaking/ValidatorAccountant.sol | 1 - 2 files changed, 3 deletions(-) diff --git a/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol b/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol index 79629473cd..55ec51a306 100644 --- a/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol +++ b/contracts/contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol @@ -5,11 +5,9 @@ import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import { InitializableAbstractStrategy } from "../../utils/InitializableAbstractStrategy.sol"; -import { ISSVNetwork, Cluster } from "../../interfaces/ISSVNetwork.sol"; import { IWETH9 } from "../../interfaces/IWETH9.sol"; import { FeeAccumulator } from "./FeeAccumulator.sol"; import { ValidatorAccountant } from "./ValidatorAccountant.sol"; -import { Cluster } from "../../interfaces/ISSVNetwork.sol"; struct ValidatorStakeData { bytes pubkey; diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol index 6edcf44f69..d4f48331ea 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol @@ -1,7 +1,6 @@ // SPDX-License-Identifier: MIT pragma solidity ^0.8.0; -import { Pausable } from "@openzeppelin/contracts/security/Pausable.sol"; import { ValidatorRegistrator } from "./ValidatorRegistrator.sol"; import { IWETH9 } from "../../interfaces/IWETH9.sol"; From ba3fe4488433a7444861d9e03523eefd786bc3cb Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Wed, 1 May 2024 19:13:29 +1000 Subject: [PATCH 08/30] fix native staking unit tests --- contracts/test/strategies/nativeSSVStaking.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contracts/test/strategies/nativeSSVStaking.js b/contracts/test/strategies/nativeSSVStaking.js index 1fd21a0ae6..af6e2b4a3a 100644 --- a/contracts/test/strategies/nativeSSVStaking.js +++ b/contracts/test/strategies/nativeSSVStaking.js @@ -52,7 +52,7 @@ describe("Unit test: Native SSV Staking Strategy", function () { })); describe("Initial setup", function () { - it("Should not allow ETH to be sent to the strategy if not Fee Accumulator", async () => { + it("Should not allow ETH to be sent to the strategy if not FeeAccumulator or WETH", async () => { const { nativeStakingSSVStrategy, strategist } = fixture; const signer = nativeStakingSSVStrategy.provider.getSigner( @@ -64,7 +64,7 @@ describe("Unit test: Native SSV Staking Strategy", function () { }; await expect(signer.sendTransaction(tx)).to.be.revertedWith( - "eth not sent from Fee Accumulator" + "eth not from allowed contracts" ); }); From 1ed5a1718243c2dbd28afe49ec69cb106dda1570 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Thu, 2 May 2024 00:20:16 +1000 Subject: [PATCH 09/30] Fail accounting if activeDepositedValidators < fullyWithdrawnValidators Changed Harvester to transfer WETH to dripper Added more mainnet fork tests for native staking --- contracts/contracts/harvest/BaseHarvester.sol | 25 +- .../NativeStaking/ValidatorAccountant.sol | 30 ++- .../deploy/mainnet/091_native_ssv_staking.js | 18 ++ contracts/test/_fixture.js | 15 ++ .../strategies/nativeSsvStaking.fork-test.js | 236 ++++++++++++++++-- 5 files changed, 291 insertions(+), 33 deletions(-) diff --git a/contracts/contracts/harvest/BaseHarvester.sol b/contracts/contracts/harvest/BaseHarvester.sol index c14ab2df0f..ebd804be1c 100644 --- a/contracts/contracts/harvest/BaseHarvester.sol +++ b/contracts/contracts/harvest/BaseHarvester.sol @@ -477,6 +477,23 @@ abstract contract BaseHarvester is Governable { address _rewardTo, IOracle _priceProvider ) internal virtual { + uint256 balance = IERC20(_swapToken).balanceOf(address(this)); + + // No need to swap if the reward token is the base token. eg USDT or WETH. + // There is also no limit on the transfer. Everything in the harvester will be transferred + // to the Dripper regardless of the liquidationLimit config. + if (_swapToken == baseTokenAddress) { + IERC20(_swapToken).safeTransfer(rewardProceedsAddress, balance); + // currently not paying the farmer any rewards as there is no swap + emit RewardProceedsTransferred( + baseTokenAddress, + address(0), + balance, + 0 + ); + return; + } + RewardTokenConfig memory tokenConfig = rewardTokenConfigs[_swapToken]; /* This will trigger a return when reward token configuration has not yet been set @@ -487,8 +504,6 @@ abstract contract BaseHarvester is Governable { return; } - uint256 balance = IERC20(_swapToken).balanceOf(address(this)); - if (balance == 0) { return; } @@ -548,14 +563,14 @@ abstract contract BaseHarvester is Governable { tokenConfig.harvestRewardBps, 1e4 ); - uint256 protcolYield = baseTokenBalance - farmerFee; + uint256 protocolYield = baseTokenBalance - farmerFee; - baseToken.safeTransfer(rewardProceedsAddress, protcolYield); + baseToken.safeTransfer(rewardProceedsAddress, protocolYield); baseToken.safeTransfer(_rewardTo, farmerFee); emit RewardProceedsTransferred( baseTokenAddress, _rewardTo, - protcolYield, + protocolYield, farmerFee ); } diff --git a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol index d4f48331ea..b94d3d8942 100644 --- a/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol +++ b/contracts/contracts/strategies/NativeStaking/ValidatorAccountant.sol @@ -107,12 +107,7 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { returns (bool accountingValid) { if (address(this).balance < consensusRewards) { - // pause if not already - if (pauseOnFail) { - _pause(); - } - // fail the accounting - return false; + return _failAccounting(pauseOnFail); } // Calculate all the new ETH that has been swept to the contract since the last accounting @@ -122,6 +117,9 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { // send the ETH that is from fully withdrawn validators to the Vault if (newSweptETH >= MAX_STAKE) { uint256 fullyWithdrawnValidators = newSweptETH / MAX_STAKE; + if (activeDepositedValidators < fullyWithdrawnValidators) { + return _failAccounting(pauseOnFail); + } activeDepositedValidators -= fullyWithdrawnValidators; uint256 wethToVault = MAX_STAKE * fullyWithdrawnValidators; @@ -163,13 +161,21 @@ abstract contract ValidatorAccountant is ValidatorRegistrator { } // Oh no... Fuse is blown. The Strategist needs to adjust the accounting values. else { - // pause if not already - if (pauseOnFail) { - _pause(); - } - // fail the accounting - accountingValid = false; + return _failAccounting(pauseOnFail); + } + } + + /// @dev pause any further accounting if required and return false + function _failAccounting(bool pauseOnFail) + internal + returns (bool accountingValid) + { + // pause if not already + if (pauseOnFail) { + _pause(); } + // fail the accounting + accountingValid = false; } /// @notice Allow the Strategist to fix the accounting of this strategy and unpause. diff --git a/contracts/deploy/mainnet/091_native_ssv_staking.js b/contracts/deploy/mainnet/091_native_ssv_staking.js index 0808739f99..689853af98 100644 --- a/contracts/deploy/mainnet/091_native_ssv_staking.js +++ b/contracts/deploy/mainnet/091_native_ssv_staking.js @@ -114,11 +114,23 @@ module.exports = deploymentWithGovernanceProposal( // 7. Safe approve SSV token spending await cStrategy.connect(sDeployer).safeApproveAllTokens(); + // 8. Deploy Harvester + const cOETHHarvesterProxy = await ethers.getContract("OETHHarvesterProxy"); + await deployWithConfirmation("OETHHarvester", [ + cVaultProxy.address, + addresses.mainnet.WETH, + ]); + const dOETHHarvesterImpl = await ethers.getContract("OETHHarvester"); + console.log( "Native Staking SSV Strategy address: ", cStrategyProxy.address ); console.log("Fee accumulator address: ", cFeeAccumulator.address); + console.log( + "New OETHHarvester implementation address: ", + dOETHHarvesterImpl.address + ); // Governance Actions // ---------------- @@ -158,6 +170,12 @@ module.exports = deploymentWithGovernanceProposal( signature: "setRegistrator(address)", args: [addresses.mainnet.validatorRegistrator], }, + // 6. Upgrade the OETH Harvester + { + contract: cOETHHarvesterProxy, + signature: "upgradeTo(address)", + args: [dOETHHarvesterImpl.address], + }, ], }; } diff --git a/contracts/test/_fixture.js b/contracts/test/_fixture.js index a3867bd7c0..184fce0ebc 100644 --- a/contracts/test/_fixture.js +++ b/contracts/test/_fixture.js @@ -361,6 +361,7 @@ const defaultFixture = deployments.createFixture(async () => { convexEthMetaStrategy, fluxStrategy, nativeStakingSSVStrategy, + nativeStakingFeeAccumulator, vaultValueChecker, oethVaultValueChecker; @@ -505,6 +506,14 @@ const defaultFixture = deployments.createFixture(async () => { nativeStakingStrategyProxy.address ); + const nativeStakingFeeAccumulatorProxy = await ethers.getContract( + "NativeStakingFeeAccumulatorProxy" + ); + nativeStakingFeeAccumulator = await ethers.getContractAt( + "FeeAccumulator", + nativeStakingFeeAccumulatorProxy.address + ); + vaultValueChecker = await ethers.getContract("VaultValueChecker"); oethVaultValueChecker = await ethers.getContract("OETHVaultValueChecker"); } else { @@ -759,6 +768,7 @@ const defaultFixture = deployments.createFixture(async () => { sDAI, fraxEthStrategy, nativeStakingSSVStrategy, + nativeStakingFeeAccumulator, frxEthRedeemStrategy, balancerREthStrategy, oethMorphoAaveStrategy, @@ -1569,6 +1579,11 @@ async function nativeStakingSSVStrategyFixture() { await ssv .connect(ssvWhale) .transfer(nativeStakingSSVStrategy.address, oethUnits("100")); + + fixture.ssvNetwork = await ethers.getContractAt( + "ISSVNetwork", + addresses.mainnet.SSVNetwork + ); } else { const { governorAddr } = await getNamedAccounts(); const { oethVault, weth, nativeStakingSSVStrategy } = fixture; diff --git a/contracts/test/strategies/nativeSsvStaking.fork-test.js b/contracts/test/strategies/nativeSsvStaking.fork-test.js index 2a0cb82100..c08461018f 100644 --- a/contracts/test/strategies/nativeSsvStaking.fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.fork-test.js @@ -1,5 +1,9 @@ const { expect } = require("chai"); const { AddressZero } = require("@ethersproject/constants"); +const { + setBalance, + setStorageAt, +} = require("@nomicfoundation/hardhat-network-helpers"); const { oethUnits } = require("../helpers"); const addresses = require("../../utils/addresses"); @@ -10,6 +14,7 @@ const { createFixtureLoader, nativeStakingSSVStrategyFixture, } = require("./../_fixture"); +const { parseEther } = require("ethers/lib/utils"); const loadFixture = createFixtureLoader(nativeStakingSSVStrategyFixture); @@ -104,7 +109,7 @@ describe("ForkTest: Native SSV Staking Strategy", function () { }); }); - describe("Spin up a new validator", function () { + describe("Validator operations", function () { const testValidator = { publicKey: "0xad9ade40c386259fe4161ec12d7746ab49a098a4760a279c56dc7e26b56fc4d985e74eeecdd2bc5a1decceb5174204f4", @@ -117,13 +122,18 @@ describe("ForkTest: Native SSV Staking Strategy", function () { "0x0d12c28849771f3f946d8d705a1f73683d97add9edaec5e6b30650cc03bc57d5", }; - it("Should register and staked 32 ETH by validator registrator", async () => { - const { weth, domen, nativeStakingSSVStrategy, validatorRegistrator } = - fixture; + beforeEach(async () => { + const { weth, domen, nativeStakingSSVStrategy } = fixture; + // Add 32 WETH to the strategy so it can be staked await weth .connect(domen) .transfer(nativeStakingSSVStrategy.address, oethUnits("32")); + }); + + it("Should register and staked 32 ETH by validator registrator", async () => { + const { weth, nativeStakingSSVStrategy, validatorRegistrator } = fixture; + const strategyWethBalanceBefore = await weth.balanceOf( nativeStakingSSVStrategy.address ); @@ -176,25 +186,219 @@ describe("ForkTest: Native SSV Staking Strategy", function () { ) ); }); + + it("Should exit and remove validator by validator registrator", async () => { + const { nativeStakingSSVStrategy, ssvNetwork, validatorRegistrator } = + fixture; + + const cluster = ["0", "0", "0", true, "0"]; + const stakeAmount = oethUnits("32"); + + // Register a new validator with the SSV network + const regTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .registerSsvValidator( + testValidator.publicKey, + testValidator.operatorIds, + testValidator.sharesData, + stakeAmount, + cluster + ); + const regReceipt = await regTx.wait(); + const ValidatorAddedEvent = ssvNetwork.interface.parseLog( + regReceipt.events[2] + ); + const { cluster: newCluster } = ValidatorAddedEvent.args; + + // Stake 32 ETH to the new validator + await nativeStakingSSVStrategy.connect(validatorRegistrator).stakeEth([ + { + pubkey: testValidator.publicKey, + signature: testValidator.signature, + depositDataRoot: testValidator.depositDataRoot, + }, + ]); + + // exit validator from SSV network + const exitTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .exitSsvValidator(testValidator.publicKey, testValidator.operatorIds); + + await expect(exitTx) + .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitInitiated") + .withArgs(testValidator.publicKey, testValidator.operatorIds); + + const removeTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .removeSsvValidator( + testValidator.publicKey, + testValidator.operatorIds, + newCluster + ); + + await expect(removeTx) + .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitCompleted") + .withArgs(testValidator.publicKey, testValidator.operatorIds); + }); }); - describe("ETH rewards", function () { + describe("Accounting for ETH", function () { + let strategyBalanceBefore; + let consensusRewardsBefore; + let activeDepositedValidatorsBefore = 30000; + beforeEach(async () => { + const { nativeStakingSSVStrategy, validatorRegistrator, weth } = fixture; + + // clear any ETH sitting in the strategy + await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + // Set the number validators to a high number + await setStorageAt( + nativeStakingSSVStrategy.address, + 52, // the storage slot + activeDepositedValidatorsBefore + ); + + strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( + weth.address + ); + consensusRewardsBefore = + await nativeStakingSSVStrategy.consensusRewards(); + }); + it("Should account for new consensus rewards", async () => { - // check balance should not increase + const { nativeStakingSSVStrategy, validatorRegistrator, weth } = fixture; + + const rewards = oethUnits("2"); + + // simulate consensus rewards + await setBalance( + nativeStakingSSVStrategy.address, + consensusRewardsBefore.add(rewards) + ); + + const tx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + await expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingConsensusRewards") + .withArgs(rewards); + + // check balances after + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal(strategyBalanceBefore, "checkBalance should not increase"); + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + consensusRewardsBefore.add(rewards), + "consensusRewards should increase" + ); }); - it("Strategist should account for new execution rewards", async () => { - // check balance should not increase + it("Should account for withdrawals and consensus rewards", async () => { + const { + oethVault, + nativeStakingSSVStrategy, + validatorRegistrator, + weth, + } = fixture; + + const rewards = oethUnits("3"); + const withdrawals = oethUnits("64"); + const vaultWethBalanceBefore = await weth.balanceOf(oethVault.address); + + // simulate withdraw of 2 validators and consensus rewards + await setBalance( + nativeStakingSSVStrategy.address, + withdrawals.add(rewards) + ); + + const tx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + await expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingFullyWithdrawnValidator") + .withArgs(2, activeDepositedValidatorsBefore - 2, withdrawals); + + await expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingConsensusRewards") + .withArgs(rewards); + + // check balances after + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal( + strategyBalanceBefore.sub(withdrawals), + "checkBalance should decrease" + ); + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + consensusRewardsBefore.add(rewards), + "consensusRewards should increase" + ); + expect( + await nativeStakingSSVStrategy.activeDepositedValidators() + ).to.equal( + activeDepositedValidatorsBefore - 2, + "active validators decreases" + ); + expect(await weth.balanceOf(oethVault.address)).to.equal( + vaultWethBalanceBefore.add(withdrawals, "WETH in vault should increase") + ); }); }); - describe("Withdraw", function () { - it("Should account for full withdrawal from validator", async () => { - // check balance should not increase after sweep but before accounting - // check balance should increase after accounting - // check balance should decrease after withdrawal - // WETH in vault should decrease after withdrawal + describe("Harvest", function () { + it("Should account for new execution rewards", async () => { + const { + oethHarvester, + josh, + nativeStakingSSVStrategy, + nativeStakingFeeAccumulator, + oethDripper, + weth, + validatorRegistrator, + } = fixture; + const dripperWethBefore = await weth.balanceOf(oethDripper.address); + + const strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( + weth.address + ); + + // add some ETH to the FeeAccumulator to simulate execution rewards + const executionRewards = parseEther("7"); + await setBalance(nativeStakingFeeAccumulator.address, executionRewards); + // simulate consensus rewards + const consensusRewards = parseEther("5"); + await setBalance(nativeStakingSSVStrategy.address, consensusRewards); + // account for the consensus rewards + await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + // prettier-ignore + const tx = await oethHarvester + .connect(josh)["harvestAndSwap(address)"](nativeStakingSSVStrategy.address); + + await expect(tx) + .to.emit(oethHarvester, "RewardProceedsTransferred") + .withArgs( + weth.address, + addresses.zero, + executionRewards.add(consensusRewards), + 0 + ); + + // check balances after + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal(strategyBalanceBefore, "checkBalance should not increase"); + + expect(await weth.balanceOf(oethDripper.address)).to.equal( + dripperWethBefore.add(executionRewards).add(consensusRewards), + "Dripper WETH balance should increase" + ); }); }); - - describe("Balance/Assets", function () {}); }); From fe85d6065d7d02858833549be8220c31193f0f68 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Thu, 2 May 2024 15:55:12 +1000 Subject: [PATCH 10/30] Updated the OETH value flows --- .../oethValueFlows-native-staking.png | Bin 0 -> 179573 bytes contracts/docs/plantuml/oethValueFlows.png | Bin 547985 -> 491809 bytes contracts/docs/plantuml/oethValueFlows.puml | 276 +++++++----------- 3 files changed, 107 insertions(+), 169 deletions(-) create mode 100644 contracts/docs/plantuml/oethValueFlows-native-staking.png diff --git a/contracts/docs/plantuml/oethValueFlows-native-staking.png b/contracts/docs/plantuml/oethValueFlows-native-staking.png new file mode 100644 index 0000000000000000000000000000000000000000..9042fa5f33bea1a619db13f9e5183602d5d71ab2 GIT binary patch literal 179573 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Χ-oj=oUMlK;|xX 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
g1R{@I7nFradYh1f_a6ffcH7| zKuP)p6R>5m6y!ud+qKxzS*c4BF0YdaH@GjZm+?A-UEU|BSg0`&m@FTOfK?;$L%O0i z3l@v>RSU`FvahFOR;hGPg8~!1SNp7mX{(-o3QnX#KdC_<%Z0qS98F1NxkUCFEh#D! zoLg8y;1R6+i?sZB_-lo8O%fDvY$rk`07 zL-ft$;^_`7=W$6R5fglj94Q+Oj2M-Hcqqh^2NFt*LEYXYnzS(E{-q)rF+>(d1ki%q zd;=g>5Y@DBcX|Hh<#QFgbSO|Hyj2x)|UtvaIZVl3E3G`$d^kDIL zZ@@qgLP!gI^GJX;BeiAWZ&Fte2srQHtuS}6A)2Wp!v2qD?D z2jC!_#`app9ma;kw;o&xPa>KVZ=Quk+_@kV5xSt0XWd1+hM zVu;K4+DxE7ug&R1?K5od_{IHGWF9v96JI7OmxFc9flCj@?&+vn7 zf)6^(*+|V1e3V&wV{EKDW-owSrjzQr2O=R!e;>6*+;y@YG3?cLA$-u8C+K@D8})QJ z&#}q8_<6c1D!NT8Oo#F4JAy<>()0Q%UqE+|j$yV&j=zsxtCFzd>B*hu?UjMw2w+(hCf>GM+f^l>DyAQu0=s zZ#f@Uh>6*ca>tY;3GFLVu8+h1>19`zFUJi&5Ye}7deQGQva636EGZq^vy<->&O3Cb zT9BK@`TNgs4e(!J5Yyo%$Om>FX~(yW zoV^VSLSzg;j}NcVj$sSzoZ~t(dstaOIl?ExYaCG0${Xd!(?kQMVOR151{x1wJOU#U zw`@Cn;+QdGRFK7?31p!{-ceEh_oZYfI(+zWxD#3^s0~n@X3KinI8q#DhD%>R;m8dR z@Q6Wt%Tx>uP9)xiajmJsF#8u;v~TTjv1eHV8YUx7dd5^=(In<=ato2I0KmN#Sp-cZ zT%HT~MVA6K#xZ0ACGRS6S;BwnxlPtnBT*804Vo7kY$~TsKq`_dTwgcWs^LQu=30%Mi2R=l zM+i6pOn89gxf>v>hVZ%~iyI`NA*nk|8?-?kDt-e;u}Ln+>+ZRBwa_VF3g?WKwV4&z zMEDT7ilIMpsM!%xYYsu4rnmeFi;kxZ%B#@}Y2iWb*CCa>cL#(C%%7Qb8}c$%$)v|8VP* zL>iKYahV{G2tL4vh1%uW!8k%#=qfx4OCsF302pHpeJR3^f>3bpkMXxS3N{P5HWHUjkMR$RByzF+}SEz8fLT- zhh$PBAJqZ2h4tDMOw5zj`_#e=9i$l9-fVMP7qZmG3{1_VLTps4c&JeToeGER=nc-z z80-(U1(A^4&Ho!>e+jo`W7p;r_JHb*P9sp^+BHEqg?6<4GBr1(Ox*cV8f4;J>tnq z?X0exeF5(vRU;P_D~M1O8&jh~BhP-al93Y}QF2hM1nmF(_KxrYc>WPta&8iQ{cgbw z(d^b{M=lWgP8^yqagQ#;w0#x@qLl2j42F#o4(lr#Bus@752@5huLEPrZZN+eQKPAH zxc(&#rm$dRxlqzBOwGq{$Vo;=IL)G<3Jl8tcAtin9~qX@*48Doo{fO}n=wod>+`l{ zu?ZoulDy;jr&WeY;%?>)k}GrEyOWhgP?p*x&CCVn4K?=C%ouT=xvZL1>FOJhs1L)C~Kz_*~F!n5!}8NBxMgIhHX=uZFv9rkafH?7fwn3!XP80!HaW=&!K`%`5KgZJhjz;L(<(z`19gnJkPNOykZuoG1 z$5@qKY`mlnxW%4;nd@tp@zOqVHF75q5yDw$N%qrru0?~kgNh+sv_FcbHsl3n0==lM zemb1gB1OB3bnp-`k;^A63tkZ(YF$N#(!KdOxH*t3ml_G>E}3`%3?@($2>}vMJUK~9 zgLqh??01<4KLNtzx#J3EV^ z6H^soPIXC7XbXZ4&Yqoq#G0c9qoo%q-rKSyVEg4oCtg-JnoCz#=3egy1KMW!SVWCh zabDy(*V3~SfN27b#-iVh98T)Bqc`aP!1|dSxu4b(ScenS^|Vlhy5K$B-+A}Rnh9I= z_2baec(zm^nL);2qa;@d*jQe5^n!%f_6)_xPI(jZbZHLupsvBxcUSS3miX@7Z81}K z#K8E9DO;;eCE>-wY(54P8XSAEdSH_DV2?RuE{QS6TBak1eXdsDP-o;B17j?Z&CSek zSNm3c%O5xF11$?o_p86x5Z}vO`}S01n6FUz{IAW$|I=cFXLf`j&-YqId+M!C4{wnU zf3%)O*Gs`RMxACqa$<93gR;K!KXfyu&Yw4L(bwXEm--(U4^qaUnJ)e>{_tBnVVR@& z035PmH8fx{--#Jer}y`g^wU)WhqUjfvHPdb{<&}7`G07Of5loP-&JVz+X&6ty7@mW zp`X(d{aiH+llE$?4|GOrfiAqXL(r2ERq670{;?J?6T>09&2f7i)_wVhVQm9ogKq=) zUB7Rd!4hWkydEohx=N>n-X6?IGdGX!g5e9hSIuFdRz%Nlpk`G@$*w6@xy-CIf`Q*a zFC=iFsxfTuAK58Css5g7-|pe9IXk?%tlj6uJi3GH-Z zYhjK(*wYb*PgPW>wOqU=V%NT%-us~vE+;MT>njchQO0Gnhmc`Dzcej8o&VX{=<^71 zLAZ{(@dcu;p;wW(L^obKq1Ck5>dN~@h$nfh(*#!kTaIv1CXNBg!#5J^yOQ!y| z?`j8tl!lgxNU(a7#k*{*lg=?Dx-Ob4P&(c@`lkhWafAe!Reron%pG2FSWEb2SC@4h z0y-HZ>)@E1rEI?8V*iy|_r3|Bu00eF-SWotrY>*c4bS(sUAiL7uJ7&_`$KTK5qZfq zJ*%i@`|hgG>7uDN)-z8V1$_~O%R*?VQuGX<*u_v zx%n)vovrn>YgzZpd@URUpWd)oJB?kgp?>(g*~WL6*_wp6Eb5;o1ac9)cDs*{Q|7V4 zkenW?W~^ z!K4@s(SpDuCD)7&%pp&4!I2d2m3bB2>TR264l%v^3MZ%KS9}Yqf5yl5!woDeYi6Zu zmEn3!&V&IcgByi8A&Z%q`tVH7DQ_D4swG@>Kf;CJ#j)HDxpqU%gJM>tFO#wmd6$^! zQZpvbd?_f)d21Epsyux7DXMK|0V>R;V6Pdar)VBH*;Fi5ydwVriwbs<+zF74_|-b@ z9y(C_)-~%EMY_1q$n^!cCx=Uo?F*^=J!#FAG^|%CodrkMwvIXYOoPv1;CT3IR5fz| zAF`8`0mJWG8@;QUmx>HrySP$=(z}^WSZkotD^*dnlxrsOIlPt$Trd_ikBLWY%x$KO{lD1?f!?+J#f)4=8yrQ-4=MKjCSsQ9eQDTuH*| ze&!;Y-0+cD=B95ZjV9>)6 zFvHcMyg{1>G|8QQ$>oN7uW#WvZIa;QEULFT$X(m@ftU988PnF(Mch#jNangzmpspv zlfw17a0ch&n(9*f5X`Kf+cMT1TJ@6+!B`{5x zKN3n?ue&D)XkO=c70K&D79>e=Fu$Sn>6`}`eiN>dBuSmMt*MMv;w8q~`tsJ@GYVtUC`r3vVQW`z6GZ8GZ;umCqirqxEh7#UJ}!*gY~qSo;uLhy z*CucF_1lx@xRjo5!coKgK=G^3t$M@l4Gp-mB-W@(Pa;sR*5_cFdN(@?vD0H3+h;87 z+YDoV7@<4Z3bY6qQWq$n96=@Kg;+Ca{#h~lSBs7C3JXVWjm{ir&sNirXeEcw^F!4I z50tC4U8}42YmQb{z0=q09h_|67;f;=%wBQ>eNpvI^hDMe+S4QIImjPcUwrhGG_(1M z4*Nn=4=03SaT1zWURu4DH!rIyI9Q{2*9o<$k~Ma5aqccLr&HLiOUQ!|(r(loo-{Kn zy3!>RtIaF!V_~i8c*VuN33?L~{3%|QCJa{aa!kbj=0QJ*HD+EM!XBzdouFv2ZQIH8 z+1D|q!XHh{)9n6jCgyUfw1P?w@`W5M>e)HB+f(1y)i)LfIR$yD_PXN!z$ISY-V)dF zAXrU&aV{oDT2u~Un@Y;G6O1HQ#1HL*J#X$HkBO!zo?f?9_dXgeb`Tj#YV#ZZRdw69g$F}b;mPCKr<5Hpxd%sOI!Gmq;* z1^+L%Mo8svzCv`u?DWmAkJfn}t?`pH`qOhS38qroE7l%mOaW8Z>Lp?7y89`g_~0aW zqVe}+|DbMePZvXBfzJaq@iJXX>*ZMNMEkzZ>#5DRNY-%kgKe+$Dn5>|Iom{`FF@R0 z_Ctks^f41#sUx$}#7bV6()}~;hZ}pZFvyIN zW5_tEdmzu4dfvCZ&viMbjcd7HU-|V^`*Zc9-{7MLdf0c?!-%`95Wn&b-O$h7rmL%D zoI2KZ!kZDu-u{m4i#)=iN;uoLL#gd4RbAeyeCxNIz@(|?q9Oal`#K4*U`=WsDQDko zqJmDnN{?i~XfAU~R1^A|j*UsYDVGc(EEK z)6}w$;t!G^Jlghff-l)&jFW9u-7fWMK^I6C_2wRWj|~*POJN@wSYIaAoycOjiw+#Z zG-nKqo|Bw;Zzz*%@N^=KGjwZ3H|`0&UWy`gAZK`(#}DcmxAlBsQdV@k?^2Rm`rJ_w zUu4dSI8>R;Z^~`=<8t}CQNFzoF_^#MiNTW4Qw^U%Lx-tY?&GCeuMtFaG}xDV6qEaJ(=;|idTknnWi^RbQVlmo#`|# zDZ#&`mcA>FsY0(8+bumem{p<|!tbbx#3ucg{UJ63+uS7u;o^AHiz(p4Y;XavKw6X0 z;L#Iobs7IU3^Em)uamtq{_{mAAM6$Tf-g%JnQ2mEESqCG+r4UCeZWWF|MF$n{sxuw z-!-4dDtKmTOi4%tPb^){+wjg7x;!f+Jrng@D2GD-EVvc z33B__{=fnviL$C{?*u`WE%T)R;B)x8=)R^>jsxuxRXSYrf-damOx!?9{pVq50D@HA z-vI0{^-USJ;skVF7Pe(Ti9N{j?AZa(`5QO!5Mw4W)p1?%4&xdJ@}9F~xbjgAG{a^AUDdW|vR}XRsKGG|4 z1_1QHycI%n6*up#q*jd=bL8z?WSXY9=hd0U=+OgrH*Ue;-PQj9spG&D7{t`8|D81O zwI%%>Qy+RM{{t+)-_GQhdzdZpACLg-l;wt?`u{)c;YV7>uW#u8F6%*|5I8dCbKibp zY~5XE1(wVW=jiPfuePMVc$~JdugwqYRDeuvj3zm&W_`a=*uayA^rqJv+IMbOS_U#| zj?2PTzj(cjo@&{9_G-ICNkP>OhaPy0_*#E*gGzZL?J^h*kHCUOgJF%yh}kv6vMmT0 z2|2g@B7DbCNJ(n{c1O(5W(7eOJc)a_SN$|P?l5l9mq;#m7iJHds9bj#170i*ga`09 zp{n1jZwQclVvYGRu9I=?kp4C@I>OV$0CpMRfCDfq zR<>B|h+LzB*;*(w1hKLKJRHCy0iR1sMn>lGK8$y>0T8k# zzfx%pE#OjIO?AF(WfYP0ib3BYzz1@S#e>9uZPoj%>cG@WCU_^M2?14N9&ez&CUZCN z%)#_ss(OT;(05z;L{dIIM05ij0Ro|gC%z64Wc7JA zi|j`A3O%&B>#)~rCTElJ;({{zN@hi2VV4<)lakP9v)Ciy7xqbfzNpv(f>gs`qDdv8 zMm_E{CayaV1Fl2}2FeA1;+8y7f-4R&3oxXqC$G&PtA1X_rYPOf?V2BS==CbE&AAwg zG+JX`m%`XaLiv4=Z0YY{r}RY9*LrW!T3Dnmol6Tjc}!?s(q*ij2GF5pAlWC%cMPM! zwtEUk1~i=vcchOMQ)PxF^Sf(RFo;k2m6!U(^;4)22BsMhDdMf%*%|(UbK>SOKMI(E>s4 z)kbnb^1(TdcsJ8LNxNJVzu|B0C=f9E@v5fsFlU0i5;Tl= zD@U?5oK+U!(t*-vf}mD(qWACa)7XSC+ZDyjCGUS8Hq*r>1?2)1>Vp<2m36bkpXJTi zC=YT@O_2~N(Rqnf`W@|YYGzESs zdD*58cgi}#t7jS>M^L(J2m1FQudclmR9QTX0`$LofbBXohNpR;eg$o#9809N>=Od# zyf39>tSG?Q%KChj1$vPSYW6NPazLMRgn*bT9Il*v8@fadZ>xhuO?a7L(o0RzI?8bU z>RBSLR)hIQ~bC2`WW|Nm;^#$&&D?G|chQNBm>H zwX%3*^cn2;R95Vy-Pk`$P;D*;aTSjPPBDJ`erB~N&|3Vm7fIZn@O z5Vu7D4I>`efz3cb`P+&beHuy+SHyz>OU3*_a|HX~O$ftT+ z@>y#_7fAY@ckH>c_X+uH^99uV*Qj0sXd75{o~OTD4%@4=yY(e2C>$JC1pt$-xIzk?3e1Rmtl|2%R+>zM;xlAe=&i(+b9lb3IstpPeRZ6>FVnO+Yx8oQQc>FeVW%6tkXILGG%2Te8?ie0>`~%%jF%q4WQq_#8F$h(JAruH8M8< z&BA1C+Z3w|LI}rse9&Tx^9pq9!yT`*y#ZV46G%H3uU(kN-hXw&CVhPoj}=%4drwS= zy#2Yu{Z7aT(Ub2$G_v1IG82Ttj3TG?WrLLC=d>4>2JzArZ@l(p08*S(ymCAkkUBVz zJvmFdHwbzxeT@fo-odq^L6)pP#G%HM1HK-IVxpp~!E*DtpcrGqB4lx_iJP<0ytUbr z*mpHys$y(@f!9_{@vRAY5P{=}aqwm$tjSy|{~)6>ThqkJeB$OVsqX9RHD2>)9Q8Ag zy_^M0k};!46B?$1o))#2Pekb$I-4P5)Fm+Gk0Wl|{hQ==1Fol^`y2b=)iS@OjxN9a z#|8I~o^s3c8Cwix-R@7ldB9q8^{AxRWA@FuHfqbVbJOphd-d{<)!Ex=^JZ-GKUaMC zw;5xCr!R0~Qw-nIj1uIZCx^*o@weNlcU4wp`JCv9Gpx;OY>o5Ti3;kgw#{A}%g?~h zavTp^(B;Ongc!dYkbu>JY?~czga!xg3kGRj|Cof#rLGP|$UbKj+_8k`OivmYisuC5 z7>lADVot>|M1=pF@&wUP#_+R?f5BGd8`mTQG0+6-cm1u4h zbm{L<|E-B@JVg5Oq~>e-J;LlEl=B1PY{7q^e%th|A5aJmRN;_fqzl6JGe7JsWivg7&eD!`J;i2ThYJgwa0GbU>Pr*slm_L zo2KG`VLy=NF`#cbgodfZn0_6cC&)Zu?xg9GTaoiYd#ywJwf&$i5}U~12i9BB^}+Qv z-4*nO@I-M=?5UEr<&F;9wru(IvR?+kx-ht1s>kth8WowzIiIC7LC(H%zBj~S@Kdmg z=M8~wYQB-Bw(KOdi12CC--5P%@02(f=Y;k{(Yg6;Rr zzKUC~P3@?$Ws^--__th6(9c7l!3?WdwCX=n*O{YzfNFVFv5uWF~n zeG|sPqF|Y{q)`-Paxu(L&$~AYa567E-z&^s>7p;1q}_9(L^hQB;bp=LaM3b){^_EJ z6$Q2}f&3IrJZg(y4#b?2SZ;~r+`<9M58>baKvDw4wazzVoK^6|c_ITs}i@h(8r*duE)^2Z7p;DAF4Je@^ zB~zuzoJ5976cJI%JgnM6r6NPdQiz0%84@cbQxZy)A(=AI^Rm`=+}L|pZ~J-Q@B4j! zzWbl&_q5xrb>G)@4##<%$Kk$z5yfHH8@%-`%IMdP41$nr+za@pJB}K>U3JFk;`q6b z`#rO1yDN0gIL8{~yXKWkwhvEy^bp-Ul)qKpV|w^`mrG5YPV;SUuTb(AwPMYyMzD-3 zLFS9FsNdQ5VoG^%2Zl0d&7}>JOr)FIlXO_FK6Jmn`6f)IWEc0rqS4NZ8tE4@eP%%4 zaV*aK2-J@*(<$uTeWX_%lj*fyo219;a)4B`UgVMPh!kPq(QfvZ56+&b{!?Z;{kK+X zbmQEmLnxu^4u7^QvmUhMkA*?#u}~}}s2M@Q!JrAPZ9#QC2<(A<`pWtD3AKI4sn6U} zJhhNfJ$k~KA|Tg+T5H)MU0mC|pIziMJiOr?i zHH)V3kWPLk2Y5^f>xy&l9PTtR!}?R}LyxottOjO4<(pEgat7o?<JJAm7_E5AfWL zLH~eZmduv++;R!3uze`|vGc~MUqAWm)3nj0j#f1_5w8TA?u%I0_GTDN-fW~!^O8F7 zerZ!AeWix(*D55IwTmxO2U}kKp{61WC;4!C(n@<@{#*3S(zN=q`%Ks48~dNn!r}e| zev2%9$O1j58T8*KXaoKEEG#QGuMTD&>iQ7N?)U^9?k0*WFJ*OFFQM{xeY^3Sm0R+7 z6fFA5{aIksDje@NhQ1`AC&<-GXNWS6K? zja3OfY4GSU28W_K;$r3klL5aswcCz0vhn0lO5#j{d{sLSKOc$T>^ya?3yq&YT+O1( zKUUowdblA1o5eY4rz>~`ZZ2N5{hUL;GkLn;3@42(4Q(i$!P~O!`s!qt`j)bs!Oms_ zjb@$~Yny~7^VLf4mSKB0kY+!TH0b6hny8<@j)kca-{`s|iwpGmQ|}#RFT34F#uw=C zztb^RAj;~}J24V(v~B!UX(U%WULBTa!zk|($V2xU3{J8izf>J`W|Ub;!n9IwvgAr5 z)xvJ&X^d_2Z(v=b#yEl`l=$tLz%mX>h1>>{MrvYz|L4Zuk&57>$Rem_9!ral$DGU@ z`J;5I@#F6HV)kS0O=EU_DLz6Zv)uHIqo1xqv90Ftr!hXi5k_iK^Zs=tYf@i>%uef_ zPjE{Ejt$m}FJjN`CyQC)?&8~i$psn#EKLf(-cw|!Q05j|_eG6-8-7)e6=l3MkF31> z!~rWvRc!2x^nE_uWvi$?jSwUtH{6Bz0Vm<@49wDU($D&XHYBOFH_8k~fq=YTsol-U z_zmUw@cB2+`GyFvQY=w2TlrsESE&T_sWG`E{44h^`cMBU_nCpZ|HGD&85liGh!KTGVQic zW}-}b*S3vgY1su@NH+D81&rLoiMho2fLtjJ_m9!cxyS6@!bP922DO^>2WYG zJWUEbF*Fd1*u98_U3#0Ow9{}>qell)T0ilCS3)a*S{$v!D#7WZn{Kh{zH^SrB#w8S zUb-s!%i#&R*S9&HaDErr(nxsjR%@~N6)>jFL~khwHC_tg>!VN!zX&cqTtGCqG%SdbNB6O9tUSn(T_ z0WXvVGwj#DANJyWU?!y}I_r|;(-Ku-Jqf*Mlcc;i{YR>z7(5DKQaIonHte-+-19_W zMN}Cd)^ZA4y=2nl?Iaw|4s>0FVMD)(6hiRCq)%oAW!%U`#^E5QbH1_H^rPY~h)jPb zc}RXdK9+A1w7G3_-nXfVbPGLdnWYU&IotC0Q>{H8-Hvlz*qhZ-CM#|PX3w)c!zP&y zcTN%DMKFnQsWI?y=XUc`m3-7*qA6K8XX`z`w)RAk$`YOvbL3#1NP-0L_dA1(MbaZbd7_q>D*g(Aj&u&tzlgyU23h|sH1}0}iT)EZ z@vCOptw*T@=Xv^=LI&VBLXIPgMg+6h_bb2H8Y-EJ&JMY(38w5Xhg@{shf(k!(ZwT; zT^6kot(p|Q)x5tEeZJvUnQ#oqW+sa{m@E>_nN4hD5gbO!P`aBNXAXloB?ye7P43O2?R%U*5= zS|2GW@t*!-vT>7`#%ye?p#f1Mit%DaMMYv&9oyyG8%<%(xAltR8Y5To0WVgU(G=dE zW_nVlZE%0p)8k!XNRsTE9?B#(m4eoHo$zFX80rVCp)8$NwjbY)3Jwr`nROR? zp_aXKaa|%M{NsI0Lh(gU(!k{Sq3xI%ed;LN0o@=rKXD5Q4RBDVAo|b^>}>fRoHu`g zt2d@^P(`8Y^f>G>Is(oRqCSjI#ttCOl{b`=Tyn$qK2Z!%JjSt*n2bbJcXasIy~>mk zhLuMWts38ngU+6^)o-qa8-rfDS9iKe#hS_Y)T23r{=iW>dU42()b2T0`$ew#rX@4E z=Tpt_I|I4w-siknLd`f;xVBw%Ttl4ZO3Lof?z@KtuZZAnEanKOWqNnlixXR+PJMw7 zD~1yeut-j{uts!{*l5py?-A6y!J@p2uo$W#RgBJ{yVh+1`E4b2-rHPQG+$j5X5|7;NI{S&xr460LF%lPwGVdo7 z6;i|z?yTea`w^czSIx@~wB2U)0~+-S<&XawTH^$`rgo8r)u}*^m5Q$m zKT=$_2VriXD5XzeoT#AyN$0wfxK#A*nry@AX+DpJ@@}B47YUYY%P|PrJ}!rhf+B#n z!{D?yj4MQxs=lxc0SaC9`W_rYL}EV7B;{KTkWYu2X&&*Qzx|PqFc)vqeswoQy;0 z`8>wL)7h+ZY4Yt{n!L<4xSo?THQo+qN2vVMY@2V*CkiKg1zaPr0%w8AQLM?V_=icB zIr#V9Q%u|vEA*X>Bx*B)a}RD-*mU;+yrxF|tSNt#yK_hQpyupm+IOojzeogxe8ds0 z1(_edl!t|t)O{J-`LE>Q@2VqW`{*x{%)i$UKOuTpa+x8?%$(m}l8C#SW|Ro?X6k06Hw2l8;@8(a;w@B z>W7ck{XW`wI}qB%jed}es}u;&%OU@$sJbtq4f}|{3~Vr|NX0f zzlbBrg6nP)pSc(!nb=MG(;tEKdx1f>S-Kb=)Mc&*GZiH9&?JHG5&w&Sto~6kY@z!O z*HmP4y9)aM)zvWn{*}Dn)AK~7178MWw<`wfiYt?pX4MtvShhtB-wiDmM*m%4pH?TF z*NDHm{6|=HnfzYW#bp7<;M0a$d}F>z7zDO7fXrZ_Ei-uy1m=fIq`d`<+U$!Rx7~pC z2qk#yaMwq*1%?4ow}G4|;U>oxGpCn6nhjE+{sDQ;eb8A%rE-GN-#L{i1BrE4L_$mQ zM49C!@lsFV0Sm6 zrU#W&q9Ir_ml7IsV3IFxGCv9(9qw>Ny>^md7PpZ(Z!)&dQ+eS`UTMzkiTz&!=shNcaY?$|*?i z6{xSp%?OXDxDn{K2`Cq4K{g_v07YV?IT$>6YmgWmc)%+tv&k=S*CV7)c)wx75(QeF3Cz0&>bbl z2~8%7fENM8nXRCJR6t$2%PA!di5{9$P|%Re z8wOHJ`g&b}FuVXpLBQ9|A7kqSY&^P${I@$ zdt(ncu7Vs}%^)PB?i|`Tm;(Km!41)&mDqevj7jX$7M;Kp_13L^i1#s>)kA!3fb;so z39wZu_xhZo0g4(dD&%oAFL}t{cPXJdFgYAz0v?)qg9P`8g$&I>w|RsHN`SBQ<(AH6 ze%5uT2=}GLf%DE>GRKlnE7;+?v$Va#+vz)Z>=&x01|$_xy`LoSM}+v;IVror0m$Eo z?9E)Ye*JokfqP+gKYS$69$)-6Ce?|Fn>UGpLm;l7o`bh%GU=zGn)&sH&{-%LG{&i9 z#(*UQ`V(7IlNX87j1}~8Nc35vrn0NS6@cKNh&jOkMw98;(|UP6^EaFeyN#{U`KQX+ z*xAv3y}&z5ud`ALlXcG1K$^Ht-6oIal)U^ZH92P}f}rxb#cL4fO~{N94{8#$AYL)! zH?Usw^$4~)=$P<2dE*Tm4j%U))M#J9D^L&=FreEIt8}RPf>$OuX!#VV=Imw3Hz6oU z&~B9ScpG$MD|nuX0l*gt-ujMT#vlKyf4PN2`5L)#&uxkEFo({VL`6W2FiF~pan5FE zh=3J{CSo@oS~#L_cz0eh2{!J5idg^bWQ4@@; zJPo)$98WP;srdroYG1u}Ww({mcIU-6_kDQU^op4G?LTx4jNX5c8BLzQ>@A^6E0Cbi zDEa9N3t{h>Sbb}I!#HeA(lI$FIB4Oj{rlLDFSk~R5ZwoD>}+g0=Dku7xaUV1dtYU~ zF-M1!en}J=Yb*QI>fyZAWB>((Wut-AzO2GD)+5ti5K9q%qb8Pj^_KE|=}d4QDhT_J zF@Pm^KYa1(!IjX~+INRgUURU4ol6$tpyqMq;5}cbza5ZUsCExr5_Mk}G+mk2Z=LLM zh$`xBnFMSI;nhEv{rN*GK7lCM7fCE?g(9ZTPVIW{U?2t|&9{kKIC(g&)_~^ri}gVX z@LN{Z(Kzj;Q;}A9tI(gwf5qp)wM_UT^1!R$XQmP>wwZ;2e7Tw1x!4J0gz)I68DDP@ zurPHLAt|Cfi`U`XLq?J`l}wu==Tm?+pgNY22JD=W%t6T|6kos>`IbLW!5iYmdv+^??+P==S&zNFKza``gR(4M9k@Vt1S`-aFRY5R7(J170ZuN*k1 zw`H6E=no=)*FPbb&_)C;N9^pf10=F^wLuSVd!Px{tO8|W`A3A%f1?itpSgpO(!*@} zOvW2^?Q&atSw9}PJwB--gGX?H+xm!I4X9%M=Ybp%#%k}sor7ba%vc>O6TgdSu@4N2Gut6D zaSVas+oFc7OC8Iw19DFHangeaUqCmzO--HxGiaH_vi%@6eSSR6Ys}2GWAo&q0Y-V1 znvRC2Ta5Nqw0{KYsCTmrp6Iu=BMC1C74xcRzHkuN*zXk$`M<$It|;^3>oa3S=XR2W zig-4gTWudN9fVlYe*HxRYb6JYVp+#s5P}Ix>wSx}#Xjq?0dbS|auSr|9139~;0m=N z7jP1jBmn|?rBT4ZlQ~PL7P=!TZV#alxxQR&WvA@ZEt%nO3RoV*b(T2SjfMR6t5?H) zVaBF1IW7;aRM0o2ju3IvWzJu+FbH4_(`N{)Cn}oDp>u`H+$CFzRb%34U}ZQ9j4Oyr zb-?or;bd*lgDfI#9bWdE&(ayK<-d9j1Crv;X=}E`?BTi2K|vLiYyRL*CmNK-9J0FEot04k!O;EytoG0TSZ* zCM!@(g@4~zL=bAS34aJWt9@zcqcab>@*c||{y)S5Gt`)gw{yPfx0yfCX_l2F3>0$R z7R~(s)3>Ht2veKrKULx@KbWN0HTmfMn&0S(&V2u^yY~?+ z>t3hg!Aau_3EUPAbH9JXyM*x2^dicUhH7piHSgoSV25->Ob zfdAC&r<|i`m3?(nviRNw6GgRO7v{y)$U&P2fTV9XdG`hCs*9>%tx1Is90ZvgAodI2 zDgmc`q(DJoVbJ}l(48U-p`h=jeF2OyL^|D!^9CKNC`<_IDe^T@^dd_3j+e`Ef5Xx^ zp_E3yg!2OmlW?^bGU_9PMffili9tFGOKcfX0RqKP8l|?>S8D5S%I#3A6QzH_Ch2`f zvAKOtkZ+%}Zs8pq&ckKk(ziYX~7B97y0Jm{B`!s7%dw;bBJ zP*$pFeBnjALA|;nKNN85fyPi8#4oODrdc-fMCG#)oKsZr`#F!LnyBYJM%$tZ9lm)| z5D_F{l48(?SdI6nj%p?L>GO@co2ZryuWWv&dzsVz-O=AQ0Tj-xCeZ-&5{OsU-M&{p zh9t+tE9->S0?eB8eem9IXkh~9d$expM_VE@Amc`8;=!P+c!rgL*S6o936oG1yZ3Mm zUfhFwSN@yI%1U^ZetfLn96+WRr3M1>*tNdthhMD{EZzad#EpW2H5nI9*%A8hYj5u` zM3!L{P+d$*(KvkAr|yfWhzK*WMFL%=X@YW1e3HdtdZ{K`aI7{bp{<@@<&hjLKt! zLl;WO7tJ)AZ_UEs(L+!UjH#2_tIaoa)Ol^DM?C!0lWaw~XZSAS90W1;IT#Y}=tX zutU)z3k})+_aHt(sjsSroo;VzVIQu!^BZR?!XJ7r@aw!dUmX9pgU2jHF{(sFjNu7* zcx)%ZIL^rJ1*%Xy|N5sZ`6aL*qk=7mb9m1|ET;gGVymV6{KPo7Wb2E&f4PuY>X&G_ zHcmjOy4}7>QWpqAOUGQWKSKX~-1y(@KqRVv%~Su6*>(}ln5{vt>M z&ZNu7i@(nSC|cq!gmDoj!e5ABgMX4=&mJDvx&NSuWA>n{{Sl)3D7M0QAa8y8PmXOr z2t5Bfis1)uod5leA!LC6ho9s>9OHj9Nk9+&2`cfB&L+|vzGBJCUw@_9yZawL$&thu z&F38F*hG(63H@ZR_xA`J`rao{487gHG-l_V=?$NnC=nDkzMD(j3y+zBnvI=}_;t;7 z45Np$fj{Pc_mNK0#;`MWl{TXN{F13Sw^NYHzSzRFRVtfwk|Vj~7n&7#2^-I*^G`i1 zOVSG!18pW9=FyE>et*mC36VnN0%lf1ju-1_ndz)#htx7rtl#qLDNnlFPAJx#VWL_^ z#skr65&Q0CTs}sKmCWd9W3FV23L`aDTp7%(lZbggrFbdF&vO~xo=E0224b%bIhFVG zTclX1sAmB*+00!{^bx0G>oB`V|ImWHc$5KN?m+|iVnKB~`s%aBuy3_Y1$!oTldd&;V0Kq~`=QX=ACWP(Eg8Cp#Djmz(INBvVo6h7|& z&_;xRXx&DTn3m|kE8T9CaB`^f6;P9fgS-tTn!5p8Jm9p9KyI?LF7smGDzZbKZ8y|1 zA&>iCOBI8Iq&TZRgWiU$1|di^VdAEh*tc)yY+!u$%8L)?W=*JIs*%Sb9}WAT?Gl54 zDzecT8PFxEKZ+BypF%gaz%v^lCknPn*nWSVj{&OE@O27=@&#`4wXhkx%OBF#URiy% zBD?@RoXoYojUumDw%OMgYd(*RW4E-O+YKHR{+Akg>I$LAh;t4tN0YjY0SHwR#0M-Y z3Qkg-6%>jwAcT+Wa;n$bCcR<$G(Ml$-u4pb?LeHjEo8#;l$gGFrW`6b4oC9Jglfe4pZ`EG>SJu!SzjD+BrQay@Hf+5j{>ppCDgP%a4a* zrk`nff@7r#pYOEK7E;*Lg2<&kbTWax_o34#@JJj4cUW1VKm%rtwvv!=h~J982URQv z{7X14XahXL_F(#{Gh^9tdgZcCxWe` zkPziPEG#HUNM=*m2yhm~i@SAu&k?Mc7~j2n7h%uFPevpq{N%e||j9iz~S_h1CgGSUV z%hNzIQTq~d{CbwzAMmR&W3K6hz!adPoe-W{xNsq4hF9`LtvYNT4u+=kChf$N(~~2F zh0FVX)e~D>7URTW1ZuHz0vs5kN5|=sG-w$(tmXG&+Pg&#%18b00T&Qm0ND*LCm!C! z-W`Bs#Ur2oYXMfHZvMEqD=KdL0-DD-wgh*k&$~?dzDo4Y-+yzZIx1U2g;{y*TSYT4 zTt?PkmStxpiLy-h5yomnxM_U5?c=eF5N?&QY@iUf;6NXBjqrSv%7Y8Fyo8sKPrm`C zm1lVL*oA$=o6Eev9_9U^o@*!;;`iH(-MM~q?F?)p0ZuZ{D{7v(fmk&%McGWW1dA5I z@T7Pa{=&Z+*FaS|uOER#m!c=IB;?8{!RW>*_xL ztoyYv5w$Dex})Y=fO{2EC{VaU0ert{wAq7$Y;mb%{YTG_$+MPm9!^UC(zIelde#3B z5twP8GovFTTL9JdLX%cqUEPTD^IYzf(KSMwfmdhBhDVnV{E*B-Pe#*PV*g4^%^GDl zbR-)Y4x9_S$Ky}wF3TKE&$O>$i~a@RLGPIyZ;2GcC1}tf?h*`Swkde+dOZU zx!Ple`C0#``$GyA1=N+mjcRV>=lumx$AW12_RPYw;Cz7 zGKv*Re`vq&_!QUHp=*f z9Zx(-?2B)-@iI-*QI9@m&K^YeH14u~Zh1mWU$$nrz1V`mcW_svT-L_U^gnRet<3z{$P+rR)xyq&wY@wu{q^3VavRx~0&<6hI`MP2>tQRJ`SxB~Rm`607uB zT2qCHIS%r^a^gc&yn;QwZ3|ZEQCwhG%!IQ4Y4+$Rz!qGHGlZpp-42X=5S>0k=!=jX z7x)7%Meh(3(W|<5VBPW_<{(MO5#kB2Ym_0k8o&5$(8xQH=lvQBt$Kr4+FU@BL25T# zB+w^l2kRul>%oJ(b?-wI-WL}~FP1h~N0_W1Ova)*v7i_?@gA^- zcB!!W=2p3zJD^)#a<)HOVNQBC2n%)l0=mBJRjSDCPTUww(kns(R+_QiJ}3s zuPJod@nE)LS#|>V^aIA7L=!)5)r=Y0i^Tay*!94PZk+h;4(g@VTFh zD%--ha;CgmUR0B5!2ggk46JzyZ?B5y zdgs5+r$42Z4c{VzP`*dsnvfE?c}BZFT2jUb7#kfa>*blRJ2!JS9<(3#=_*^-dDX+{ zkNcZ_5)=Bni3(IiUA(O+--8$K6BX)2n!!XWK)MLym@Jh|26U~m&nmfk{i3x>&b)l`&3d-$QJ zpkB1Dsj6iIYboWXV&>^!4Z-%ezSwL<Xw{7e4nm3tMvR9_TzL27~Ki8F!akD z)~?m=9e~r)i7QUQbyo|K5Pm33ATe&ygr*2$$T|Zl99IrG7pGx!OcBG|47CR^#?^*J zOE4P>OV4EzU=73})HBz_plZNm_8Kku>to?9a6j>r3dVkZAR*_y=L+LmQDI@GKiJsV z2&XwlM=vJJ!nc-z1hAqVht>9Sto&nTh@GBQW&~vn$dg-}G@>8A!7{V^ygD4i6)Okv z{+elJyI-_8h+W^=WT10Jz$+5-9Y%fLX;hv^P?92AFi-95d>nC@IXRA=X2Ghoa#yBW zyts!{YmC2D$Utj!v7F$B4M8XZ@U-&wqp*4L`J*buSmUW94jVqSWanjm-Z=3r)vzSn#Y#iUc?V2wOR2Cpfd0Uw(K04Sqp(?a!8qmHtI)n*t$jsX1t z#3|{Vq!ghJCw)GbzGC_Ebxu>$U!h`(y-Jfw!sZR{j95K~CrqYgV-D782%V68%13>Y zOt%Am#)h@iZ*6nnj@Ev9nU&|pXImNVVG)z0xoq7>#C1lNDh3`opB7LWWzkpyEw2GT zAz9=hTy|_jwC(&0=)DK8ov}OXZ=IoWUw1=#=2}g;O_H?4m|56W+As8-{-&;Hte?$w zy4q+TFZEWq|qhQh9zH{6-m@rO7_3oMxL!Bm=5@|6_?^F0+V01 z5E1;IRYv;Fhb*%-u-!uJ2QYez0Ym?II7_zD6>E*z*C-v*^dmcblYwUM<+O;Zb4`*v`}1E zZ66O1)jxr9iGkN?^CqI6g~q~urQ0ALNQZ7YwSRcJc!MobxS$z@RUsLG|1>x-rDqc$ zB+&$p%9%i-*XmA*zLWTjNa0OlwF7x~iEIXi{>hYkUq3%qp8yP^9T#$#j}Juw1+^Vy zRE%(qb2vU*S!D<9z1N=@_tN(OA(ewZYMr?Oj)B1ldai&Kx}XC;yjsuC#`*J2C7~H> z8eX7BxSiBkp<}ktmr5#&(y@hABid*a43LqY&k5L%4BPigJWqa$_*)q!$Cz-tWo^b< z&1Q)s9BGLsbN@Vl7-T*j^@uG-R~V!9gNb*$D(Ca*aSnw{&tcL2&0i8*5oO`fa0=!L zCY6!J7C%JblZfC=+*$DA+qkaGQ&8g0MC}SCt8|7nzGFekF1~lCY92Xlq}=cPoZg23 zg=n~HdRx$V89({qBW3*8~%BkD5#TC)Gk&k2<#hbo)T}W z9WNlPUZ%YDl`(XHrKsHAD$Ijpa5nM&z`G^HOZJNq?vaqyNJP;?*s$ORS4glD)QP`) zrwisQQ7l-X!$F6?%K30g9JdOlyU^hQT4IUU3QM7TRxN137|Y=l^_-|GN?#3#fbNFe z7~o%n=2mn4TbSYUl(DeFmT&P|#%5)cQ%*tNICYn>=!I&&v|=Ns%vm7$eBFNkkR`vm zfI!&R{+4_hj7bwCuFPk6ElQlW!~{6#tvj;~XaK)TFoLv9+=|=B#l@s=Di&={8lUIa z_g?X0M#Or8_HtE2$bKeBlQS|h@ZTDE6O;o`2vlKrSf68K7^0HWi%bR4ZmLk|W>A(G z8HCdAwS2G*IWzgKWGBiq#f#K+2WMlo`{GrHVK?HFIb5j}vHw)bZ>*~1VbPwJbH-E) z-zKwl_NdL+ojYTqC-EbJSOJ1^XP=sR`5VoOlT{xclUB=IJ(_^lTOwNObElgqKA*$tz88C``BnO8YEk zpTFAUyAIHM2*q?7;?>n4Tv1PIh9v+HVoFbKyU;D~0UwT9Oowc;BK*XBq*E}Ga_H6rUm?xm%hD&;L7V6LI%c1b?34jms?wXF?GTygJ^OEU*POc z>QzjwPO=KqHRA3?5qy=#ABNZ&bj)SYJ5RTwkVLe_cgrIm*BFZ(OOJEaynVc{Bj&Ky zu~qlwg2>XYh#CB$JjH)RNl%yTBubbGlrY<(>h^IoF$n|%9Nh&5SB|n_huZr=?t~K3 zeZM|U@8Vj2@6-J9iWhr(Tu-G(du(gX2|sP9UlG>!`@x3e?w<3!g}%EJUuc3|A)#aU z=j1Em7e6C|=rq8BCLy%{z`W$%qvT0V5KHbo>gJ7Z%ps){<|cv<0otH=CSl!#OJk$! zRZPhyivQ!p$6q1{=5pY=Eqt;}m++bkb7a3Wv^iRh?EPBSB^^r%rQq+RgD=`>y1!Ln zTj*WK$!!vu-)A^q_=NFUlDThISb=Ov}_a$4%E_Uk3Fi`Wm2sZ&<1wA?yF zm;NuT53<7lCm01&hri}b|6v;b55*J~+ok_I#G9jdILag862nw7i54CnZe`ix&S?P) zXw3rVO=S{b#ce^@+2o$Ky|e6jsK{Be^cuQdMs43sr@dnk(bpV%Ng#^B%*)s^Am)T^ zR2j6}==sj6rE{GV{!{=twT(_S1|b8@UOKa=j*V2JRkyhBin0CKj;45EANQV>LE-qfpzTw6H869)vy2jPXnDvme}vGmH3t9XOFWT;P}V|x(Ok4 z2ndBkm>B8w_s=mxC|}UTO~dzgZpsyUAb+XV4o5Q7#}TByTpz4wrW3w$U-qXfvD4=A{sv5#==D3?T4$slsX7^+f32X zWwp*8jeq4GJ@FZb(xe<%981)JFXoR-fB`&>3WS*cV7C=*xPb#?!H|d=FyV;P$iZht zp(}hWWAj;o19@-$K`R)CFml-eGd>hMgjXG0(jBQXX6UNX;rP3}1HPzupJ1>3f zN0Hh9zi_C`F)zBxv_FiQ1jHiGhe*ruQji=(&D2vyh5yqYq(Y=`39vB|wQ5v@9S9ETT|gQiQ9KQUUGa*! z@%BAhH6OK~7;G4<-7w}qcqnRv1RigY>q{Y+GXyod$(IuOUXCH%KuX^CKEt^-Yn z)7afG9fBh{1_I`hajjKhM~u!je!i!_=C?bTy?PCAy%SGQ9#Yx+IJ%+9)3 zw_*0z`|cs+7C9jRAr1O7p@l~{qGL3fuYpPmm=Y&YqznrJk)WgpKr2&f!m%Eb)8d5P zCitOh;wJB)T+(B(a}(+1JO)BCO4k`6K=G+-=Y)0JU=(>n!U~A*)$4!=Kg8)=e5pzd z=g?!A7Z4hfsCSykto+IZc~d+k&Y+N==%(G-r*p^0VT7l>#pPt{Q^D37Nd;fm-g0OG zVOd4P5*QbLB}N4K>Pn<>pY1+Y`Wsk`f(==jRou83@a}31Buv^+9Uv5?0j?4!)k{Cz&LxchGW7BBNvMy$kJsBS9h$Cz z#)R_x=Q-DzbmANTJ?8=k=O(XqrjTN$p?T7{u;1Og)%dxO9}7BX1H)%wh<)(jB%J9? zne_+vAMO=ueOPxcDM?;~k73K`ifMz%a8D5kdz~80D?ZQ;wM-O=ZJ14u8oA$lamTL| zQf&S!7SX-5$o!6n*!`_Gr5%0#4n$y7fM~8F0G?p*2&(S;r3bi@P?AEt(7kIEvOwb} zjN!WwPWI=4#(5*u@A0_W%fraHOXv+o053HRko2M%4fT|2MUE48sUKWfWLMs2YOVzn ziSqoPaaj0-sXKRw;4e5xe|>-DRJV$V10K_FF@&6)91|aLpFdnqqKYXm2HK0b_QNyS zAXVEcdky=I_`1~>qFda2z24%o5ssmr`jqh0)M4yz0KmT}`S+vfAy#QhO26kA6vC4a ztkFfb^UvPD6=~4BP6{o_5j{(vr&}om=lgs`TA0ZAU8dX%TBAYg0 zU?xz-mD6%-@6=9!>8ztf2oaT_&P8Yz%zp`Fy(S`I-a+jhtrbCNqH!eiROR`>rnZ@I zzn4fH6uZNZ>SX^pDE~V3e?nR6Ow7+1YKcZ+#A|MTmQscX77y*%{CV9rW(J#y9!B=k z{S%W0h30h`NvWxq(uH2L#MQ0XCls~V9?_?XJlEW8jk5*Pzv?z0tdYxu1^R@H#vPBC zOEQ18(D!F#jFjG4?7FEiQA}rjzHiA)eA_*v&``qn(;~|(FSMVQWGir9^ZgX9aNnU_ zOLlKru(V?SW$>Bp#iRW*-1kzu=%Ci zwGU+h9YjUu&r)qKpE!N`^f9u_JudvqlI18$E<>7S-V7lQe}WMp6EOK*l3)tYa&;e= zp~rvjFmg62mJlKYbP%Nk_!a|r2Ur71>2VXF>$i%lSb#jqF!!IHPmElsep9Pp5&OAT zwIDy`fVkE;fTe^nb7y01aM_& z_6)~|X!#F6QUoQ?o4prauZ@jlkN}Buf9acd{5h}~1#RALD0B=u!g$qbmu!o?gU#a) zU)r74u6a^z-^3vtL@)PXjzX1~Us`I00BysD3CLwbOXkIPtBV(1U0qX>lV54X#KaI(S?j5g0Tcq<+bu%11vYFb?tZ9k&{6paMH({` z6UdaeUr-@(48non-2~ldikl$X_+b3v4Kf+ZJK3!fAtHWhI~|4}i?5{~TWg~Y79oCE zHn5EoCr-c?XTzpVsnVg!4X%M+o}QSa4Gs+GMu>?3b`jv94Vn6kCe$vy$nS~gsfFol}i~}Pro5FTn$SW&T>E5mT z5XB6FtTRAk3=a6Xm87Q-LE-#dc8P9qk7+CzEDB-}*OUfxNJ%vN2&T!!z5-!8txNLr ziH)yB>ChM3?O7n?%`S#k{e@Ml;)xUYO^fe_fW8@p?)>WpbYS7{^%eNNUZ!?%#4f*%F5zWp{;GW$W}HsY&2pn4Ox+%BkKYvn9X~t z*z`3BuUW{#vR&#GlJzM=Lm=83EG%A-GHwJz30ueI!QL)c^$kA}Io7v>r7tTpGe}|_ zCM(mPf-(pJ{i+otbkn!1vj^4y}BsKguX3X}n7PPo&>~Ej|--b+QDCC1N zzY%KWii!$j(jW-Q{lml3cKr_m*}J49C4u9st@)tB4@zyz2wvgD!~{GA@0_>|RI936 zV6vd*xB2rQ*=Od8GV?Lx)b2=PjmZ_Q#MzG*e_6;KvuweHH_OBWuIOkj*RY{m*B+UQ0KCi zqMn3ExOr?Y21{e;P~V#`9^B)`_GG1O$8r|jiiW_byh9C(N z91svN{LW>c&-?dBl5XR8cJx89e%g!qcY1mdsP*4~o&TnwptZj#-{!<`RrKV3v}6ZK z#b3bjK~(bW2wt^nmEmH{B$glOu88n}XF8yEl-;Z8GtW2e88BB>z1>>V9SNr9q1&LM z()nTGc6Nzm7bmeS+|fbo^YQYAVZ-YBdII7HA9;FuTHmo}8-88gV+lvQu2HWEM@Ppg zJmkqq5xulGm)sE4iW{YH=fij49l0tqtQPf4-&*ektP=IbUvJuWy`|l^cYNxqhYlS& zc(4eiaG7FS9YJ|9T#T+#>+qe(#Kc2;-;+tC(u1t5tOXDA^Yh`5v-U}fKLrxUD5yHR zyEiclSNpMHk5sQa4OwN4c*hw!<$}UOM|=D0Bl-><>tk}m?%Y|*#ns)`R-Nr=>zdn- zXP|ex%!LDCu64zaSyDU#Q4K1IQA&8eqSJbPCD%s~|8eoV6Kv4yqu>zK(H_h>BjYu22u zq|5c0`7D>64ywh|%e8YZRe$z&(MOYFWZipn`#kt*huHr5aeu8X;p3hC@yQUsb=S5Z zD<9&|9uT`RM8VT^Qej2-%J>`XBA-gawr&U#Jh<|es^ZmMTYulT_o_0-YVE`8mkjdp z;<3d1OGQEaxRT#~Om@Vd{artu-yBf^i>LqlFWYpIk&*G&)zg|i{7g$W&BmD`kKy-c z`!D7!U8>pj;{2_<%C5Z6T?kP!@rcvmbd0Q08%Xm2?vC8MV4eJ-)xf78j zlJVRgcG<$wR#gnq+k5j|^uBU!L6GU3z7505tu3C(v>fyTT*8ZP^ z{$YhZXz~v1$vdEI=rGl@o$+DI?t)jZa47~vnj_qQ_`tS(zkUM`tQi?EY`463($MO? zI5mH%XwHtyJkSHByX@%o{ZW0OAU+<%C3Rh_bI`x>gwusxHZ~G{qQsjTTlW1O-sNl3 zFDCgSSCp!EzUTMGW@0(;yw?xGP5e5&oQA3Rc)_I!#ho%UIv#)jj9tT{k~}SU=8xgX#QNQa&6+{yHfGQt|>g8vccEq`kz;KcSj!aS%S~yf5KHi zUB*TB?2k|S$)VWX@`?R>kHin@#2Hkx2j*hdi|bXD(9ac=xLF~YYk5^ z+%PS9Ki(`L5m2_@s`<5ny!)_b#$aLCt4EPuoSZG`4P z-afqv4gU44e=xe%D8#Jet2x_``J!CGoBP@No@O^~8@boXX_H8?}F*-7qupwUZLS_GoVhsLE$F^({=5Ze8OKNd2a7Zz3`Vi|#qA1jfl3l_k zN4oPkI}C5!Tx?mhdEI*J(I$8~Rh$9ySuG zTt2lQr#)rDYe;3m9~hWAod@6FW#S}1_jWwA3C0z@mBFOe?%4BslSwLH4d81GlvyWs zqGqAW;s;n3G>kPWjg}iMa>WyRZr5?`gR5?ih~eU)HZ``Y%2(w#&h>kCMk(J4;9t6E zRtl(<^PezuSp@TO$?8{tL@@g^j4v)JStcZ^m!{m1_Ta&;P3;U>bbi~gxbn=bk$3s> z)gqhSnYse>z0;fzBnO7=Fddg@zJcHFIWeE%V@a3(bEnfSMY)=>4%h5W%W7(_L`l^p zU3{dy!))~Tj;1%FuRT4o#v&E#d$H+BoI>Rhbv{wv2QP?M-5G8CVFMTp{?m%{jEu#3`7-0@Gim z#Dhiju6#RoWQ;W~V`YU)l4zM{>;3!p2Q`SIv=vkOqR*(AZ;W+-?RI_Xt{_92z+^f# z^-XQR5xCs16)=^D7uS?UpoOm**2GPRqAf|_ys8q3R%O0T!BdbI6h+`Ti;Crcv&9X^5jr@$V>N}Zx%uOWMmC}=^*D8`?S8s}Yy2Ik*)1J3ReRpy) zM8maToGxKiyR=fqp$6adTSK<%NCF+`ibV<%XBq|ze&xx5~yE_dZ|@$pA}1EPAe_4yGcVAO3CM&bL&?{%(x7n^9% z8k+`0f!(eSrE+2??|OZ3GoHWW(l}?*Tbz{7I|Z4LeRdT^?oK4~{Cw0#l^O?ss?wTH zetJG|bnctg*?nkYFB*S)tT^I9Zh7&3q%!KB#19av3lbqm#p~n6BqXSHRhK2OM{PG_ z<6+Yp%j#oqVUOhAkuiGdwHiX&b+t6V_qBRy`~|O4&)e9%&9c*ut4%eXPof1cVt1w# z)*jbSxPNh?q}bSM9FlaVeUKDs+?t-A}{) zZE4+dW7SVu$2w!n6-otEc=(*x>c8=f-l!EP$YVhJ%s9NB=I-peSeB?3F55 z7ku>R`OQ4yU4yelFiVlWV3i_1-TuY~GP&>j)#)q0s}_s@wIrL~Yp{7Gdi3_jyMcia zsKJEq$dUK&$=HoWS#j;2U&+Y@xY;W#AoyMV@=AFWcl~O%`_j)^F%en5=w4{3lhcz& zE;3UHaZ{rehSviE+C5ksVh$H%@1F0fEjC>f1))$y#{~=er<%J(lKNlfKD))?rnm^f zoJTrUbtgnaMm(6OEwh|U-rFUymJVpwKm5RSj;Z)ktD%=2-`L6e=g;;9J$>p=8}JH@ zle1AQW#OIB>Ylh~d*Uw74ZeC?{ac8nmGY%d=ECN6JG!qhKp|e|_@+3m__Kp0K{m{1 zN38Gc-S6Ir{(bW17V+_k$9(_P^xiBbW)9-xk};2i^ET+9NqILSb%kCode!YWxk6IR>So;*gG_?VN`#iWPtR$T4fYqFEn^zyj5S&&!jo(_TEEtYea z7S-|7rZ4+&9g%1K7_|EI%**@zH$GnCL<`CM+edT>pSg}P6u0xyOfFGAYEiWPmmBz> zitV1g5)0!S|eSIbQ&_eb3Mr=sgKT8^JzOT24+6o!4%;>|-zW*^I4(_xoWpx}N#f%?#a|_nXy7&9p{J7(d_+$| zqC1mp^DW*nzWfR55yWf3wcq`&RAB)D%$6isbC_hV52AZ_{qWg-P#PspA8gF3 zIbYebwCc>wEyo831TKWQ9DCx#VmOVfy?&KbTi@$q-t5mg&X*ccJI*;co_N(iIO; z9+ZeBX<9RSTslx3P{}`cmRD>4-7EV$|J*AxR8`+1CvVm*JdyFO<#jAGdDm;(HsuI! zax(AIrAvWAtX%o6uTRZ(HmZB@X`ky)Kf9tfLBCw;Y+djJn(YQx?%jM%)8gH~Tto*X5W=!jY6sd+QrovI6{?sW&GyeRc{;J`V+g_mS zuT&fGaC4iOfBEh5&tHK2K8Q7IeWEFom)9vW*~!`=(B(M%?OU^kiZWsxwLGY&z@jqa zLd}<4=LY+BBRM%B1MZv>F6-m%JBPu!|D2JTNzcIWR51uQ7UJL+FBpiKYs;0=(=rAu z<;G8nU5JZP;f!lcEb4riWo;&^#VU4BDxG^HYswNdkrpS$v{>N)ZW7chny`s(SrQP%4Xqa!|P^D5ioF+*elw+5c{?Kid zEcj(J{A}euRn@mpfZ<%W%nHDp5;rjuUbWaAP_{3N0B4e~&(l4L=KWziGBXu?C$aZc z^t67%nerZy7k7A8t!hX#IH=g!t+^rPmGV&AEgY|ul4XLeJLzui;TbM(;_G)PvMv~5GdOGbREYTsJl2VKnf4y9 z_yC`3p6_|wx_v61f9)QN_kyV|(+-F|G}F&kOEXqp)^XL3(?~HMLH-YuerAMPPNan= zRWs*tDpV-Us^4Z=jRY97rf^(~AGo<{${27Ss-dM_p>M~FYisRCf-`?{NtXUHnwssr z0STd}KnCZ{n@6QmF>4r}jf%r;dy?cT$fw#BF9dD*p-5$$Vx0y8_`+s-`xZF^!?>)h zkigoUwL0cfXadf?UQv2ijeUrL`RTJyU*rO^qm9cto0|Ck_;_2Fx|fFA1aqQe&z^Wp zleoXM#0aaZsw%O{u?{6A&F9>Rq_rQ+i6Os6;<5g#}-l6>qgDG z5qvn#;71Qa#dACR!k^9<7&yl3A9`4F*&5@1+*gyltj@XY1r6`%`;tH~7G3|4H}$G8 zJ%;q}{q>*V2QsL8j$a05Duk#^O-;e1kEMy|IT@5hTtyAyPkS@@q;yO;bmlYWZPqcU zeU$MG^?5nIsr(DXD zY9C4lvz&Ka9zp1i*->Cr_qgS>&xRf|;oBqhW!ZIs_6*8Q(R!xIXe}ccn4Jh->iri8 z^<1a2vN8gN_Eb|ls6=#PDTN;g1gpx1hQ7H&6!(|$x3i&qttiXJ!5*ii)md#2f5gP( z7>91}X=TanY;W7u9Lcwfa#!+d_tLI1`m&xlu8J;;X;VV}5_Dhp{b-ZkVc3kro+wB~ z6&qiFd^jj8%f6@l!y=^zA3@#PnkxhA$0f?idGh9Nl%*E;^~F2EiMcuj?t`g$dJc}M z?)Wm3Eab~Oe7${L0zxdcVW;3Jso{<|)C_O}OmaL3Yi%H$w^gWTgS}%?sgu7_{Vab! z4|krgh6Q%kZ2>#-Ku%A}Fn3D^Uo;en178jE440#BE`2W+uKWhX%4K%;3EWUfQ%MZ- z^UInanu2DP-{OE)e=b}wWR$7wH-VHfMoG8Q%Rd*AG;`(kTbVgl1uGX^KUujaR5hD* za98F#uC=fd-s9=dPO3%Y8w-`$3p`fMW*Vxi=RWM1y6?encJ&R~>ljQ&>Ccu?)Zjvw7`uL5A0l&A#B$UlwFZxD;@tM*`ht#(zw^^4Zz^&$_N+j8{x3ESt=G2);(D> zMYB~|a6c6mHhnJ#MgF;X`W3z6>HadBKT_Z{I{US7io&8JGYRgISt_2YVdqT3=Wmmf zi=!b>U~W|Mzg9nde-;}5SpD3;eaDwB&WL&o`8qeZ$7*+YY(-IHo^{Y(X1xv*9VL?r z`{{-PAmco>_e3GxdEVv-bMgpsn9*! z?*N48E}1_6D|q*h{~B~$8*uE8&TaO>vLruLTC1D=_&W;y0>xUU)D(;Y9eyBtS?@~p5xMqJq~Wt4nM5uU^8lhwagE&>BnF3ALmy8Flh4e zK7QrCVK$rITQhcaRh-dFMuR=yCoX%T$n=8shyc3hVdCW%|xh`~Y<%+G<^^Ys3G0B6rP|Gw-LZ*~{CsNf&7CbHjk4t8N(Y;m-mDi| z6r2BkxHl=reEZGY@DYA%YT;cy4+I4;hkl99Q((HleEQiFh%Pe)h7C|8MIp^Vo3Kj0 z4(KVclTp{64r5ZaoP1eb*y*m-hJjkU5e`yv9C=UgbWjKN&BO_^OX`h9L9v@aw zQ32BGv2Y%cP66HZ0TY<4RaqDw)kwas<-rNxmDlG7V)(DbiBaK~XRdvOTxBj{R`KI9(p!-{CA83~%G zgfSlwLa$EbmA_9(NqPTXtopcG5Ie=Oz{e30Cx_v4e}*+>TO~DwP#J;!gqX?zt)XTg zj}UQ9YxatkSCG)pAzH1{9}}?ioBoSLs!n4qCrwRFXL`ZFJKM5DS?ft~FfhG(i@;i7 zKw&4a4#LRSfnVzE<|acpUpQ*r7-@AP>}_G83~H_f!YeYQ;K4mP1xEu>3b8LB& z`q9vlGK@--E-Q5}klVDzM}VXOv4P5t5=_A=YMX_`8*va73>V+An;Cz z$(GX6(gGJNU?L3CJteOMVO~d;h_EoCP^h&6I31dcl9H09ETHlVT%Yz^1{M3l(ag$@E=8qm#moHzov3V02sSOTTfv34rQ5kwOl^`8s6eHLeD_tBJq>`$4s%T7GQ zW}wX1Fbd8X-(_%C_cJZ8f({vM4e}S9Ml?EKoU9%K(~m{?flsxtpqpzM0gMt#lrShl zfwBmX%fZa-)u@^e1sxCocYwvujvbm9&*E${mt!VEzrDw(z3|W*nwwQv^q{pNYW`z)#-<+Pf<7z>2~%Zw>S9&}yE|ftT7q``_SCgx%;VI_dF91cf4i z-a1#UaFfsSpj)vw@9bNY&R|2PVYGyjb=QmUH_ z1DJ?;qhbsoI=f@L4Y~ViTpb%g*PcjhK53`DXB$20%2r>!*g*ff;1gR z{yc=-rI+#NSPCk?YC0*&`-Lvww(eIsDaRmxSk&Pw5V^V5(0i?o0f2+Gsq|behS232#in&$#{+gAjGF|<=61Je*Yj_gkMesbf;g7?@wey%zrilP`4jDc6#$^ z9)+H6DdnBMWl(RO)Q!`JZ+m;Y5jfAB$pD>BQ<26b6gQ|)xRBK7Pha&avI44wGpl@z zXjG7`m52WZzv_?1LtOL(+206b4r}s|7wMc=4nZq*Q>fWFC*If9wGKi0iq-pN$7Y~L z>1~v{(V8UyhQ64F21OzE=Dv}E(0^HcIe+hMA2?~tdZSy%cf5S?GO|J@ha3-6mXk?Y ze!5mLcL9`h=s(kOK#`sZs11mSJ_E?+>U_#A=xjD%&-2si&pZYU>Xz4D^WvAN2kqb}CC#Y!AH<{4 z>r&>PfW!?nq!%w1&D+d8K3P&CD)1mMG>H^_()jwftywGDYj95k&v(vR2Kdh&RS>Sk z#%3|r3#{&o-Z3cbk9O@(g51tuX98!RG@2P92T6$XC8x$dt_c%#vf3kH^kifE1SZ%c z0ZE0*=SC}sjw|l{E)g(9a!WEX8{x}r?&Auu z{PM-e*S-eyYVMYx6Nlkd=(9nfJTNjopR)oxr!yO$^~8x+BfSMTC#1dg{TRL=3i5&KW&(8j9>m6n+U7a@mfAwEp0`N_7vb*XL?gKofQ?mHnGa1 zQW+z6{Y1k87uHwPp;W2`f`V^wWcguw_csw|6`K>tTdg&WP>aESmXh`b(Iz02~)AYxH4<-5-n=h1p;4r|r;0?nVzx!tG zFT}rzxMAqeWv64%a^@ZxCQu{;ji=)`>W*Z8fI~*`J#uknWz%%&h~p+t1*|z18N=FA zG$Hb(2QbNwH#5nwK8K=qQ#YyC0A~36I4IXrOhN*68gTP7oO1Y-b`}R!)iQuIn|N)T zY_#RfmcKR?`T5xc-6>eT?m(p92hG4LHOB;y@L=@IW|wPhk;#q!eDN}HxhA?WA1f?3~;5f$B3;40~e522J+4bxB*tSotyIid^VSc`O!hWUx z<&fr}!NbIf^PUJG<5~JJcV*VBk$uMN9%*}bKB$V}>|3=lUd*%@rTGvu3e6gpuCq`c z7{y-h->#-5I_Ebt&_5}XWQh972`X3f>t2Tjvlg&p_5@Ln=o7g+=nfoc$TDR$AM4DC zdQXZ5!=`jyf?SQllfwWinh3IKV|2QW|{c%ESI^ zv_I+6-#HX}W{H;{DpbOhuClkc_v-2PdWpin-G#KW%T89*R^~d$c^U@u8n7KKE6Z*- z(U}>#y_GVEO&NvTME5jkJ96W@<2v+ki zLT5*PYW-II{7$TxE08Q z109=`BwrCBA)ygnVM}&6l&p#`tLZnm1y9iN;c^z3K2)3qjt5fMJ-GiHWy(hbR9OTo zaH|6TMoneqNrk^Xp&!+P+7Y}=n7pHt(|&J(!?(ev_QaC6LUiXW2AagkTp*(|DMM;a*UG@7wFv#9mG!3!1g z=0o4-D{6VRZgx@Ua&&Z_4WapaveWSxOf$V_qTJU}o{t)>*IgZ&mrtsENmjMZJI9uc z)szQ1<^x$E(FBt!W*A-?9a-TFax6Yw40D%JYa;iv{dBgUNy&HL9LUM}Jcg|GVzQ2= zz7g-eKiA5y)Ov*s#DNxmfcyg~cC@s3(6~SKSb|JTg!<2S_uC6l&TJIqn1Sw(niE9_ zb%ZQd=x#Iv6X@amal7X97riIWg+0nooxWVqQMJkb5zV>_gONQ#8O=+a1umb*dRn45 zB#d(k9?QafKCGlS#%bowfk&y%6BRcWk943fTzO_TJ$FWaoN-g0_$y$#eE#SHEjv!9^<6^J?r+gh&Q^#o`Of4nN&)u8cQg?icqtD} zz(h*iJLV<}@}&TZo_x~5wdG8wn|r^qG!+Nu7C zPi$aKD&$(bhz7**oa5L$m|R2bQJ6Q}OCZ!hNDtV``hnSgU2p@ZHHh<|S z!6!b1?LiP)fXP6tBjR$Pd!lTB&tn-!7?`w8{`&)wOxO5Z1K8Z^WL5p%jLxn9W$@Iw zZ`17E?tW1xpr^a=ca_KN1sAzL!Gr&~&>^jN2k;$gPehzJ|Ni@e--gIqei@u4`Td6( z(|@hj_<0rlpC37FXj|anHf4QM|kHg#5XaDyZXm=KF(#gH=wUjBtm^ zerWvmZZh0{NOjAV|3GffYKVz#iFF*mDQh{N8F7NdLXErvWT+mNi6kGBnl*E@M^lL4;F1xgb77W;PH68SevtSw=<%xPFGy4-XFB z_W}Qd7-1K?6kixsg9mfDRxpek)bs!@biaT5_LdACZ3eHQFV~(C+#c^^@uaww7x3nW)FP81v2JvNQ_T1SOFc96Kkz9XiE}t6mE6v}^`e z7%#3iOj2aM7ft9^vd(4_zqfVkR!L~GD5$IpK+r5j3DMbi!AefP=E=f1lIg<5%iH4c zeH2ebRH_6saYXiYE7P;zu8n*>2<0my73Fb==3tK`FyZ=uJJs~TzQYYlx+8h4GL(d> z4p#c%XT2!%+3jbT6@VudF$Wjs6Ku(7 zMf?&YyGs?m`|NV8Q&(OP%nT|0o44BLLZ^Cr*397}ND%n`7$T7eFh5kna-WePb4;dS#v-sumGR{-h99hm%SHw-uGy zb*@4B1FMKKW|pZVqO7jGr)1UhmU){yKnYd5)E|dNNyY8mr<@36yswQPAXQTwC~l!` zhRN^r-!p}}Up+Y`O0kXlb2CXZHdnw(#tO zCl7AW=M}iucDfi672ZsIlA17h0+>e>5z^eJkNbA)9F$MQ;S2_Z^Ueh@pkBhdgIvSo z=q^zRLxQB=7O*VVhAAU#E*PhQ$DKT632<{OYrVUA8WyTUNh%n}CUj|8O_Ocgwt&}$ z*+R9Px4t&R7kqDU$aZ27-5~%V@g`sge1H(|ze)Qj!X7>>MXobLU|S+;omd};h1kVs z;q2q%Gu{(?ZXt^jG!B>>-JO2nvX9!R1=c4BnDr+Dzmqo)QZR@%U~}xSuj!$}KIF0B zJG!n8J-I*I-+J;(0zrNvK)A9!36w9NkiV&hZfw#%Gd>u6SkdIiUD{45+AfP|X-U5c zaAdk35KOL%>IyuvP*602Ks=NRQ9Yd**JuO;+5q$ca%2tZo7%Txv>xxvG*)vo0?Qzq z7Ycgko8xcu4wSeXp0l;Hhwzo|?(QSJr;8Ao)vcOylRL>+79lJ(-Oo@&`1O4cHmMp5 zMzsoNHH3pS7>k*2;;}AjBv4>_WBMNESy@`9q^D1Td>wrIrDhP9N0=1vBT&i2QQ>?& zIX(U7&y1F{pLaW1FT;%tjk70{pK(n$iCI~E0NgJEz zL+T&O|7z;}A3V4p=y~3vg5O+O-!k*MQ&oq3q1;l8y(bzF2jJtKf>QQL1fSdO!-Fg2 zev1?OUj_%~LD-*=i}6W1aI)c15oLNds+r#wNe5vie`V(qV1WKsbZYR*-p(qY6 z$Oi{|*{jddK!Y>%L>{9x^nr#QOgEYnhH}1Pe3yZA3@huwTGApJz1e(=N|49gL^y0F z;6lRWFpzpRp`D+bTjxeH*;bt67hOK;SP6VFZS<(rO?rVp~NIF0L^REva{ zH*W*Ycln2IH)ZIs>y4+9G_zctoh9Gp#D<|7(WA4E9x;=tr;ZsQ&mPEkX9WeN(E3dL zH-Vb)!q8+j(8%_)Z}2^9o-~bI_kt(T!le#jZlZ4ByN+s{@yNlc2+chGXGW^N=xEn+ z)(BpJc9hFNgC7^VTXtN(=>B4bd4VtXyk!9EoKq|yZ0{?W%f&K2K=6*{I#qyMa~}qb zo&Eg$4r3t+@5Wm96j&xaMiZcGpC7}18|;OXn%P>$o8f2Q_Fw5FE;N&S=C2BwDNdQx zu6H@;znQ)UQ)!p==994@ytr$B14r07h$tz<7Pq3D;}G3rEijT7VwK$kA|8id*))QhLRk zD!KmIqW?egShax^8Lq&lMp2>WtzTIxyOfSl#@neCK;;F;&9Cg$sZvr*0~nJa?(kGp z-38r`5o-3l{n|e7cZ%;W0u=-w@}86c?k)dN>uyC9(XkJJ=Ku~5#wI2fw$r>g7a8U6 zYU)jW$hpP$@!2#8&GmzYx?{Hhp=8Z%xW~|A=JcsaKJ~V$Q>W@8^NxkVT!p>~3Khc~ z1SzGjBP>Y_yqIUk!+~J9GJ+~peLXnPuXM>`ngGyEyU}Ekl;OJmj;V;;WVu}ewWa`( z18ndGLT(u zQE;F)VT`Y;y)_qApF=M!F7DGV#tk$#?NiE>Jj;D0@$N8%9kqY^SMh5rGAcFzfy zWdyzkmJDEw5Lp@I=Bj3EXU8pbxw5oo5muZwoQVqk0rP-MmE9I0yiGQUed-@Zq;kQ+niAUZ_Ezo(&T-#a1pI zAeu(i1AK!|Y z_>+4p1>$_fDdn9vSzD^M`U*`I5M12fY(B#CtPoWMQ$EDp`#Nu5;_EErf6^$ZvI<*N2yWPl}|3CuN+>v3rf^YB3b3qoR z;UWElpqr!d7eN=7Mt0N5w_`_{r7(mfTLMBenZ_$bz8)7B2T6^R9&2yjfb-87WR^xN zP;Gv|uNT$S)WARrB1&q)>LYl-?+V4kqr!go2a*D97;;d^c19rsrSMZhVB+)~RDb6L z1vxV4|T3-wkpBQ=Sp;x4s4)w*mFzmW>=T5^$)G^?rX@>(YgSHEt)mkl=0j?>t zBVX%k`u+fH@C#d!{u}8ywVU&LJp^5AXuwGC@R@;7&{!DX6b5$oYM=KD!I34QxDDt! zDGAg~{Xd2bk)r~*A)y|3Z;Z}OUb7WNIOV{TAmo7|A;sQcsV@eW?Nv3T`E3(K`!^&>_PZ8*vN!4UYS&vq_?X0()?tn}-KnU4TFr z_k!)u;r0f3*VM4d&|5!R;79<%*aOuZJ<#0l-{0y$US==|L&UMD+QOHFCx;As04$^dWkb_Hk%hFfajHk;^l8NcRBMt7tCi!DH8lI2Qiw^0)9vq2Vttt^#SuJrY~x`V4y^Ca z0tJLj`E4T}`wO}ygW?G4U@kGsQhc6KDr6&A70zub^Dat-`YWQVSfb*5g^)1yyB%-CSZQ~cs! zVg?A?2C`Q5j@RJ*v{G!(%Zkmt`&|4N65El>-k8s_1MxLnl74Q4fbnrldBk4`esq8F zYG^op1V04sSL<%Yr#%Kg8Nlu$8{yyhH80N}4n02z9h*LYI_&35YV zDtB>Fc;3N(+Rtpj{`KZ+B{CG0lt=fBTU%3h2&0bR6!-b7LJ@oP-0`P-yZA!Q__Ejgw>cO!++v&s@K@>r;L-Nt< zY{pAsN=yz19tLiCc~$QzulIoqAq{bokG4xn?75#g&vx{M%z-Vp6!j0>c{t@_FFMjm zfax`VWNpuqjSWQ8-4!#IpAVoKG%&w z696}Y_)|TIU)@KHeya6(!MpsyGH&JI;>=0hT#t3C{!C@FJ@e)Hz;*LbR~P2>>FNGr z$JLiD)!I8GhK%1&TnkQgXWXyVmF?31N@;Cj#B5?LXDxI3H8zG2qv-BDRb0SVuRokp zU*W!tWhLdQ2tZpeMN=hp%EwFJA|bmeBVNii5yLtndRUMVjC<^9-`v?+!?^R303XtvW6qr5jfby9u27@8t>uk%fEG<40c4Gd_kpKNYD4pHh|SS+-d`Ea=f z`@)r2d9@2}IQTyu9i22N4?>=GK){))0XL}dTJ*b(N`cH;8$sZ9nH}_}#F48$k-ZC| zG4|S<#DtgSF<{aC#e86yH%0q}*yt%;G3@-9wJ9s%hS;G6yJZ2Mod-U#N0M(pF*yZt z&&1Z(sTzXG5A53M{!-D>8p@1SG=LpR&iI$Ntc zAY~YTkqEMqwJ)`PK{>px_GL=K^fFrbShXo$-dXd*zI~^?PaI&PesfDB<>*!vju?Mc z;e#GA>I?ZL)rrBoLS~g)@kH_~<=dX!friTQYXcIj2=@?r{_CT}#1SwXgo@<=Ep5ud z?cijvuwWG}3prm4ZG6Y3;o9*0MkOXv@j~%cOO0L=Y$d}dVeR?{=;3@= zi^Ta*PU&VCMzoAIQQ|n~nS|Zn(8>i{)wC}?>|nv1AToEuGcu73DH+9~GQ2YN?Ex3DTi9Yc7SX0+wkzssdX;j`ct3M!a1T$V!e7bWX2f^a;+kV zY9qC^Ru^jtMFsWFPLOK5Pu*h0e82^sD6(IgS?F4mmmcT#QuBN;*7f%4eM{LY5FJMP z{pmcs+fN84A=02EMiJ@jFtTSES0ALlx;#4+{D_51BH#$%(=fTGr=v?f_{o)+0Na&{;!3q8L)-1$UTN2kE?dZBIeZ69=0G_On9(^p)cBE`je#o>A$Ik^YLz|QdQ z9p3vZH*VBEy#nnF3r~!&i29qWB_$q0x&^ew*G4jhoD@FQuxGe+Jp5;=|yMPo?qy8ci(A2)6$#NT70LgLPu8@^F(NUvN)J~23zDiFzrJp6GY#2 zqPjvC^@`hVwDk5}l{nZe?B!ni=Y+4BytPn{s`TnT?-z2AR_BHLa?`igdhNnV_J~({ z#gAu#C^)q6NtP3NJg86E4$9|fSAFCYjG0O~Y_x%Z57) z^7teNkVh9s3ja&V+w*F}(8WwnP7+qT=VK*;*K1dci;Hs-qsX>y1xfaL69xnySG3zM zka&I>DOG=cpuNb2#M_u2ztkeZuuvUZEu)>_xppLoAjsalpOw5mx?4rWv9~SHW??Lp zf?g{T14`R_SCW+F<)*qAj_+fUqt8&!Gg-*XGG4*?$_?Lq4OD$9AqQux>eh1DpUbO_ z)Cvkg8DH*I$$NXVn?)3ltE+{#=G#XeAXy(M_kbs@1VLPvTZLbu3Ad(lr5g2y=0_eA>7(I77ono zZ){63cG!{GG|Sh9<=n4ReOKN)C$3oGrhB&S9E8wBaO9C2GWI6r3r6$5NT@lp+_L82 zauIXuAa;UTLf}=n4@G)-cyC(7wW2V~&uw|r-EORqOPOKQsJe?{2QELwV8@Op7Y;li zs%$^cp|*Dm4sM1w;r!!N(>y(j7qRksZ@t50ODRYFuNj|?c#$`{T3#-7!_M)&n+s=% z`*hzs=}@+191f1K>K#{}?7~43%ysU*-eS|c&ur%o$%c(8FpJ8b=~G{tNngL28?GJ* zl8Cm?bofVetkm=G#7Z$P)h`EoEo_k^x9G^PlbZz%34)@7|Hr7rF?#2p}9aqa#3%WP@<)D^*9Vh zJ!hKevFk+zT)JC4Jvf`N%JKNJ()7eUnHcb2J_RR44X+;iOvkp4yOvqkD%8U0_{|iv zQi%9H1sm#VgRu9k;sMYTwOn*=Lf&GrQ2g) z59M^jnb-ZsfU_fk1L6WF7kcY?+MicOj)ItLfp?~;Q)YIGg%?{tPMDfvQI)hRMY+|r zAIPCaWhB93w>YGXTo<4$nd#1frVs>oB@8%(6(=0UBA6nUoMxzs@mx5Dv;jkVf>V`|A zF0OThg>BZf%6Zkjg@kI@DV!43um%)tsm(KMu-8|cr>B?wEkA1AC}Svb`DS*6-?*v& z3%agH`s~wA(LK}uTsX4k{aQHwetMXTz|xz!Wwbl6B;PA0tXwOMU^03qoR5QvnCHIO z-p9l=_siMDro9?EA`Z}fkpy;~q?+-ELCeT30gtEmq-GFxr{^aMf4sP-M z>-@HHz!3(Ch+4%vN`Q=t{c3WW#F{~S&AEe@n3&cGMi=vn~H}_Q5$*6t#~Mr zzW?-nohDQg6Qw}y=*4xaul=h-0o2~$s|(6RL4)Og`PC-sD0vC%30!%3242PFT-dXR z58r^U4+?g{$eqZ?ICWiT$0H)-P31CM$FKJh?U~;EkepOXEXQNFeDJ#Yec3WnZ!TLneJB@C-#dy(MdY2f!wUm9 z;OBX&7b8OackU+X%-C#6yx_drXi1>YYX5Nf!N!K|{?TKB*QgTl;mblB?~oW-5@lPy zFA2B9BnQr%-mXu(ZHuSP7|$&)@XDp8@-oNpCBH4H$gx6@7jOk(Tv5tU$jj=i%&!6=<;g5`qd^a{YYvV(EItdca13EK!9mL~p2} zN486%K5NsLG9L>A=q$z$w%aFQ6)lqE=)MV&ZuCpUk25y=B`*g2Rmy88HhN%f_+s)N zEbVD|BtX!IplSHL4m3oiCXn`X;S^t?)70=T@|bAqQW!l!qs;bKjX}Jz0pWcd*w{+2 zsWzKwVlS_lDI0fJtsTTD@omWQx4DiOp;7y59pwsb#rL(Cim~j*flLzo=$$4y`3lK= zfOP2R?_UHYYEo-q4vukvJA@zuV2Jb6SSA#obCzsOqN1Kq=YgnpHw6XA5wqo%LLd4M z2~xYaH1Qv)rMsZ*|Ek8mSzQIJp3`IMO|i%U`~uU(>GAQ1%LlazC=)7gSC6s z=tv`i^d1IYOpD%no@K|&kCmV{SQyzqJ$Gr>fBN(f>%KaibBzp1@Ir%<69(;WOw?ep ze_ST4UEnN-&f7QhgODgoU1ZC?B;<~>(HsZtIWOrBct%$1#mOLWaecH1&v_gub#nx% z*i@kp&8b#$i*7VaqZ}1_$=$U)aDtcs@jXV%5UT4=jTX=&0(yYjBDNPnL zS0@CePH+Hb8tsC|Wq{}VuFF6bSLXcu^3txHoa%6{>T3C@bJXLyoRBpfHY}4oPXMGj zSEK#NW&guWYiQ8#`s}7QY_5+5bg4Qp?3C`)lETx|*6->elMymDPwuLysQ6Z&=Ty3yF4MlZ3#82`Fk%5OWEGxKDTp`x>bV zy$(%wQoveM(aU@DM)1H6P6l{J>wdNVd{rodtq;*h0qRGI{^8jhC}hWmn>u_%MF7DSHF&niWI~X z_Db>o-soTl7QXn%u;tZFq?CW~V`yd78)z<>q zGQ>BV_}xu?A$E5s_(oAr?=XbEwG?BFg3t&@Sgt=hiH+m6lqHV8Pe0r2(M}G~+osgg z3fdV#TCH}Cf&9z=SH{IFbu!h&z?Oi5l9P~aaw*$4R`mV zN-9dab1e|B04u!elo1uDQ9xiIr0|A;#lGeAL|$)LfWou0O2zSujw|!#5k0w9+MqPq zNyTNL)WjFmK=sq>`i*lffW}&)`~z$(pz_`M@sUe@Q%owBmBC)MS5K`;HPXN(N5MsFr(2^1t_Lpaqe z7J^w7s;c4pY8>93L>ItP7{@RT?bdx|+j#o6bkxfhcqqvML78{YM3~oy3-maPC%_+_ zdaw(~8ATxHH74DP2Vq`t^i(gVw@N11vy=cL`&S2+Azj&Gd~F0paDg7ikE`TFV$lVY z^q}pJ@&=ziug&1@!?-Qo0J0#cm0!y(jW$b=`aTn#wFd3{yIEMN$;$B$e0(H8(hVUL z0-&YtNJ&gIjo>zJ8M8Y8LLA^AIxeUmv3p(h-tO$6?%G{r6>gldi(qUd-}Rf|YY@S_ zZxE-JqG1bRNVBcr2mzTfKs4WT=n(5v)%nnf+4R;3AgC1-6g;4fz(7aoO>yja;w%^! z1ZNz8!KzW^zSPU3z8t|oRfc_93BI~v3v+X;U^5p`4hc}=1+d}cA&~VtG3G*j&RVWn z<55VG1{Je9buz_zhff$3{+jG#C8d9|E3x$DKSu`V$;C!T_F!~<;Zt{wj2BeO?dbzU9FxKXx#nPA-?2+<>%U3 zD~PKBYu@l>z*RDzjK@Qa@GL}sg#krvVRp7Ds3zyhB5d)yJEYHd00^)M;FxKjpTgoex7&o zX-0ze5fCuI-x0d)oYSPRX3)%7-D>#g=F2!%L{_Z%pIX4Z>2T!$Nrc3)8q6g+A@XHjGc=Zy2a<{bEv>u=D^7HIaDPY6OzNCn zeCRSz|3it9AT#XoFVWY#LLPCb(?>jfEH~M$@w^1>f%+)JvUkI;b8`tAsR7zzDP}?9 z$pq6^@EKsshm`9Y$P+d~4E=_NAe(TWxe21|kEFQaaWn8=tF*zLM9F?$9Y5g5WrUFPN`tmb*JqfgwUoVV8cUkuQStuEM-#*fsJc_4Sp6AnEn&UMGQe zznzW73G2lzP%?EsX3K^+n@8pgK6~NV3LAwD{B$=C+NQ&FbWxCGsIJ}y++P~h%ih^r zt%qn19ZI}C2fG6<%4$4pRqeyO%?}3*7sRccHm*7V6#>||)epw5*3ubQU*m3$<^mqG z8v0`f988)rJKJ(Cg}^v4qSFC2N+89Hfs+h8e^6w0!t4QN_+T7D3Bhkb?2#gnP6Gzj zUkR7hd1O^#AiZ8CSji)crB7X8Ejh~#0MM0PC{Mh`8nw?emCkxbUv0q`*;t?sCUJ84 zIKn~9HW#*E4sAe9!kqtMa~&3XU5?q z(Y|kutp;Zscnnu+RqGE6P;0z?BWJUG2$D)B4lY6%OCUa!Gl7PcmL&)d64u7s=3U-z))jFif-K1qu2)C- z@PZ;JBwNG$0|G)v^Lkumj2%0Bw`y$185=@fH|9hP*KFJtPj<@e3zS!Edf;18(Lxyf zyZ2WmC(N=Nj!%qkBkeD+Esg1neHKxFXoiCeLUtw~MBLhX3Wh00rNygFgciN0ySI4q zNe*6x&o~BQo}uPoNCX!!E47HDehe=xrn7zO&207j+i`c_zCF9}mO^kR6j9RBb#d6@ zDN@Y^xLgK}VT^I5g|kg>?JoAiu{cx=E3=R?rS8KS<|(iMv8exm2Jac;0+10wJ-J7n zbnOfUE{EckpRZZVx!CoBOCr=_CTzt}7X**O@qL60|5EqcJ$!OPfLj_ypK4kL%d&KX zqv32{8~w4XDd+4-@qr6;B)`Inw*kQL{8{pIG6IOoa`fo!9u^UaQm$8pm2jeGe}=z4 zfQ6(wNhR^ML@Vs#3*}m*x8k*wx*v^?j3ll}7Z}3V;KnGv5Q7ZT$9YgO7%_1N1q4Ka z*D9>UD+Sj+3wRh2yCk2#wdKZ*8!(ZXUs|evFOJQvPS?K>|0DjaAqD(F+w&xkR!f$-Q~`)h7P>Je}Hs*1-)B*9t*G7Qyr zJ)uELk%P!S1$iXQXEc?{AE=Sy!zzqSMD<(JQJ>CN0qw;#&^5u88*}eMY5L^iK`_Wk zAoV|O(^ndYCK(6xdJWG7=c&?lW7$$JH*hlPhLZrRJIcq@ldQUJ{pQ@QzNlLUwLoc+~7e1_y&zh^or)Ck3o>Y2UlaS%Ltw0wuceEzP@aW>k!-JKT)}S_`m@p9X~^u4#Ffl z94g9Zww>JE$cMrOF`%N2So*@Z4N4zX&xZkBa__1J2ykiyzUD7p-)@($*mh>Y=g>zt zfrDlZrnU8TQ9=P%e(P(uZH!NmuAEeAD;}Vah~AF&NoHw%XUDh#&R_W9X=zrwi5>izya!b2oi+=&*M3Ma6@5V zDT!Mdz%Rkw1x*CmdC!DuC_qarN<)xNDs3?b}SF6kqcD@ zdky(L)qu;pbemT8FfgRAzekb?NjQtS$I!Sw7{MZ zr2Y2f$>9i>b-as$LOl|akeUY)j!<1mg(kd<17Y2xS*eJ_vgU4z0EY-L+V9bi5}Y8?gTHoT)@HGf}U zrTTpsAO`|X&%~e{G0F8{z%8`tUpeynZpTL?_Bdq5z1ky-o;{Db zTTv;EPvdlOiB6HTl6m&YRtB@{r|FTJC-=1F(36@wBVc=43!}~;T0z5D;?vMojL0rg ztvx=o{?09Ng<=Wz0OX^+#_XM$n~UT&e()4Y|AWuRb3!l^Hr*G4R;#t*cgyb}f3O4VO-@&BB z)~@-UHSjgFp;nMU-as`M=4<^jz%kaJ-#&^!1wsA762-f`+k1EEBr#@gw>*Lw{|3pH z{(uID0d;({gRPHp*RHOI`4OTXu5dn!i-|#47g9KWc$r zad!#z#x&i?`}cjb9V~&^nO*Hk!}|(6_C!c;n%wh>d2t)T@HauEJsTr|pCA(55B%5Q za%EuJ(W8bfS#f^Z91WroXJ3MWfPCc4{%QN;7yriT`3aDcZ-9zhh*2N>AJge>BSwdr z+nr!oU(gPs*9Gk|b$i7AEuQyw{wu(`0d6;rI?VG|dY-(0Z5aY2Jw2(m;x$k9g`*h= z_GvQVZ=gD>n~}ZWP2!n$=RZA1V$0jzDtm}nZ+W5ow&9!T*FA<)^UfUuU!bC8vtN*7 z5~N+)a&min6!^vk0u2^)HOgG@X<^%zSoex9a5FJo&_iP0fiwDH0Rcgw5Wg2W0Q)#| z8gP>wU18UG$>FXg%Fo+zS$e=1!cZz;7SzZ_+#zzx>aRs{l^6l(&hOk3aSLi%$f&#| zhd3m1v%sB|uICB058U|9<9XDEOd4ak95BL=)Bl zPu+RwR1tjnV`RI5*VKNzFR0M-jm8-Upq_||ZbSF1rY^9<2=PYQ{hmftsxp^#83Vm& zQQi&x5LXxW{#Qk^Z#^t$Lnw{Ju1E57(ek~pGIonxL`8fz6s zM`VdI%nhl>9Il}iSTF8&Q;V|@3T4|yLEFwrPK>q_JY!vqg+akBdtsidOJ2P@xYqxD zIg$TWYIksLLkJ7z-yQ?TGBGv=@W^Kb(k_FAVWctHp78}Pz*DDAK~Jn8T{jNgm8{bd z;1)QReuKL&9iq`|&=DZq{YZu2NaMQChv^yNn@(dd*;l{@~XWZ7QjnQA$JP7&8-nnZC zF@_%%BQm_4bH|5ret!O~$H-g$k+RC#%$e8<{sh6kyaqCRbn?vf6c5-5*3MF6#C2N7 z>8FMI%NhRlh{+`Wxw$#2!*!sKf>D}fcL5)i2w)~VJ3mhgdgVB&U@+LiZh>k81j4n! zqkt-}7XTUr)A793a0pK}uJa-cg?kq|S(_GmL6dz7-pP>~S@)aoo;s3Ij1Pa)){vt- z(!#myw4d!&IG_sTyWDhHc5}O}u{egF{F08USn)#TXr0pe{AFO^C3-&r2!HHq9Kl+; zE5w+)qVSEwV$Cx_!C52~%mSEKKW!ct%&V#X(*N=0A(1(yyBJYp-d!;BwUGpbR}({_Uk2hu zzOWYQC#yZ=P>Gk$XSm66<$5LewT~3k{NqtDY*0{gf*OY%me`eZ+QtQuT-?YO}-+<79W8NH{XAu82I{!X{%mwn& z=A6(VY)GaDFyh_i;Qmt+zLcM)jbuqS* z+iGBQ070nxt@*nT7EeXqIS*)pieN0q@OaPv8Z@ zd6GjuHl_Ma4|t$yX=y+dLNE15Mc^!YF52Qg1jYl$F=XgV8iQ&?vBTAO?@us8_;$PRL@tL83tMKBm?ojXYv zxF*gDtT{k;&1#;!vsn2OM21_YI}PfE~&Zpzyz9)m;Oul~-?u_pZS%0`#-=Y6KZU zWT8=F&2DJ6DJ)4J^AU&@Rr6(1AF@oBR290H7C3=Y77y=YG#$dh4X(TnQE6UXl<>VH z6)Z81P1RhRu#6D(Gz`v<0((=fatb=Vu1rT;sFBw_9X>WUUmJh>0{qSTc50b$t%hRb zfz!%T?uBu-?Y%i6rg|Ow`Vn8y*Ism=kmh)@%YJNizP|iJggYgW8v^;~kC<1h9P(~h z(eSx;-2MQhvXSM5I~;`CCZzShX_x48bYzHQU` zPPlpiEfqs=CMjfrP@%4aonoi(DCH+RPem*m%7TqU7AUmv+;?@ zcBD|-uZ*Cm>3jNEb`cDfkHZ+^{{A%mW)?c8Zsnrx41FapBK)Kv<3L9cMm<#$MLBcd zl?apTiGq8fAm7v;+nYBu+2a|6D1S#vwtc-?iR?UZfT>$w=M(Nl7cp)aATC(PXn1m3 zUoi}&c>X2xJ$|VI zoPGMQUfbok@2P~kJ^(6b&YlG$wPR>aGFH{`AZp3oIG|Vg()Xi)KHTqUGm)D-(4m}# zR0ZPMXro;@%yxg)1a|;%Jw1XDBjV#-*g!E?GG-iXz)~VSLZ)Wdt~-B`Fy$DoHpBgG zhWixNos2W!>%riAykQEA<&J_1AV!*1M5R~3-Us{WiCYu3@vHUcdzzcis4(BDkRid@ z+UCvYSWfgnx35gHKjSc3<&{bqw}7RAR_lGB^$|FvN_P0QEG;50B201UX_&0EC1ID{ zMacM1?ILP7fld~9PXO3Y3&|oF^j&{_hQQfTq@vw{>@18qeBL!TFE2K)icx_Dw6HwP zo>0bk>}x;-@G^;cj1N}qI?lua+|eq9`!?lokPz&ssaxN2Ct5L2Ix4lM2B^)aGl=lxd=G9nn8Jf` zJysc`a-9zpk=)JgGe^4ow73mbAGU@bRgJlceElWjhDxjoF?Qk3@p<5Jcy3BHHa6UK z$fLja%r!AbKM_bnapFxzt-xfkg}LmI+(ORV|8%6VxQ>TnI)1e#`O~Ds?0itURdP3P zgpnTxu9&RP_{}E7T2|mFyx?cEYPhuL zTOcu3_g;e5a$48ved%^ZwN5Ag#zorpqmDVUg`>6%?IIx2sR3G+9+LgF8VPppmj~LmA-oqpF*Ldh!Qlu;a~sqi;Y`_A!GaMb|T&>U;m- zG>064QNPI$*-jv;{bGpZ0n=>6O*%R}>qki#C9&~FpiOFTZx0at;8TXbumldO*75&k z5G5!p@+_-c_tC*S*|Rk=1?~A>tGr@^jLP%*ak0u-=1Z4?>T1NOe#NhUFMc=boNe2F z3n434{`@5Wb#WWP0rSiH`_=R3w`$+8 z)Ia2;boccz#65k@tdyC4t5jwSD54G(I8?(#2={B@b?k-ZF2LT@0d6h&)vH%Cztyt( zgsN|&RDa=!hHrjoxeq(oy$4_L1zMoy7|(8iavnH*zPtezY_h4~WNl?r5&vXU0rm;+ z=~|i^)XtLyX(Q_i$h)!gQBbUg@t zlj)zw(QyCwm6n0`ot{8Bji0)=M#^eA+AsnwA&R-WQY(@T4C)6x?YEGS>HIw;MAtp! zR3tlqjTFR<$pRb-2q=5cfBwx89Q?r^UC^@)G#;**%C$8_4Rt6E(R24MrrgFDnPn@E zw@*k49Z&T)WKp)%Z8~A@MZ5(%R}JKrQcSnjn*TO`ZgeL`+DVu#6~5(xJp`JZ-E+|n+>Gqtri;n?vfi2OjiP*BT$X(RgVqKa#NVuC#4mPa8%u-K($t z9Nn{rW_}slPXwg?V+`K-o=}UCki&OkZstn(-Q+4*X>YA>TwlwJ@vFoH+Z&U%Cjy@zh7PAt%!(x^wKVWG*j{v)$wEA((KalN`W8 zLyYCY$4R2-9HR(-A;q)I)h?$V>=to#Ii;dk^)xd$^xnmx%S0$^topJ&TPv;o?0tY( zLoV59E%P+blvh;Hv!70kj)LVj{Dwe%OI{p$JQ@FR;UH7xzfLvr2&Zb zj-{bMW@56c;ojHG7vB$bd)Aay{V6%pdY?SigrpA?{71P_DM4=Z)e!^PPU#&t^fWS2 zQCRkh55pj`B}J~fBU@K^ZG|gU%Ps}j{%kr{Z#xvxLMOGFZDy?@JHMBXz0K9FxlF6` zHZ88(EsqU^RU>*y%BpAVM^bC67SxD$C9AfxPQfJfkY^z{bcE1ogXuao7~Lx;bP{M*d@&GuPZAOV&g6+cWP$@)en3+>L{5 zGJOJIjLR$igFYgwcH~al`CMiqm9shOrjKDdr5_{t#fdaL>J5vMkRWgNhiWCU{d!s2 z>b&WOHjJ0--_0y*y?4!FRzm5r+eAfMui&SS9_O$wa!dj)MC{Gbd8i3=YF0ew(==~j z2D__nRyKgX%JTGEHje!J9~E_ZEn^EBzVVC+OkYwUNP~X<8GcMijtER|ull3Y#x1;R z^2<=YIz7CnU9)ETMBKmQZ?!W15+C_dxzlQem%a*7S*&DDjA77A10y+bK;q?@yCZIN zeiSRD;fx9Nlo57vINu>O1nv5gjv1?|VDG&a3g1Wte5nO9>q<(_Pp%02v{tf^F$JA5 zEUCB$UHke-P=wtHA4+Z&;c{WK}5)hN$Ac8VYe1^aLxymFc6PN4ykDCeJu(v$T zoBf0dv*vPM0Hv%NDbDA`7J{4%)Tpgq5Z8zPaZMmkma9r_$m*>F4p4P4HEUcn3~eu^ zVtYlaq18D%D3Pp$0RN(7%`n>q@iStEYW!alm6Ry(qC#2X=lSgT7-|@J2}2^EgYO~tQp#Mf*Q}55iN>4=mkw4mZq2>RBAl8` z$rWdhIV~HvxWpReOD`Mo%3t9t4eC-6oPJ6Vl{glz-PJ1xF4g)JL!b0NHiAX?=Yo2L zeMbx_x3BLajxJ*Wt?d`|@^GUA`|ZwUl~`GII6u^QGx;bwX-Z&wMN5u@zKfUy0y>JB z%M4uH>@4)8;2$FpjLAYYyP!hlau{tkO#KSMKsVLiOqyxw z^A#RRp=u=zUaubCzA4HtO$LHAvi5U_u^NKNY#tw`HR*R`fKXL8E^0MI_8wXrl0Ha0{3K^r z#6F5r0xHT838Adi<DR4^C|)lmA4#&)l_1n2y?qwVF^p9q)FMM-CMw zZsp62HhQ%zg`P>NUUcK5qo4lzrvlqpf z9IG$%7a-gfy&rZ(v@2f8F-FO$tKVpqgS!NDGMV`qsE{DA%mSjcWBF_~A6qkxlU#i^ z)$V)m%GWDP)3oev$t%Bqz65X%;vz1?T>YK7Qk&w7#8qVU_ z{f&((V{B*r$ahsY9w;6}fhFZ?jZxj@=qhfU+dQJGHl$&jmUQfNc7WA0#j%cufr+J$&Ouy!O3;A3k}o)W2{`IL>Qlw z)**}_HB(F9wxMDA3B>*^aE9qO1$bq0M0k9dpDqoolw<(^EQS=dHa69LW>{u+x(sG> zlM*iv0>%P5&>G09-b8-wOQOLcMIsX7k!$>L!DmjW;n%)Z%^V3NNW+T@ClS1Zlao=M zw(+w_ z$)-Q-wd&r_k&^+Tmqsx2mhVVYVxj>-drw=*GkmVZzeAZP*L?4>y##GwGs>{vlln8K zan~sY7S;t(b2CAD)eeQG&UmFX?ATwd$tP-QrUS=(kY4wF={&QTqO@9k_1U^I%8dfs zpBHk*7Rb>fY?hk8wqLz6(N+u<{!PR!;7CxyQ#o!b;epDrZ9~~n+jjoQcU_O6tRhq==vrzoMn69#_SQ5z z$XvR-qVWimWaXUkcfxo?HRJ)806fxL=~!0b(v!0}O#w04q?t611_xX>U)v(05`?9UBp9PB@tv3LJD4kfkC=8aY$y`ywG;?J7J=?;1Dho z(*}-X)=TlL)6KBX6=;M^Rcr8&?QFGc09=t#WhbB+0^LVU7X2c`auP)hGFXdZBCF_j zLWz2t=Efm;n|}$Zal6D-t6>{VK*NC$(LIY*s#F!?oSU7|doHspvX{u+$Xh_`YGB#E znB2JCX^)j(c=GzuYwa(&c6>Z!NEM_8Dho~_xPc+AGj7Cnvz0Nca0oqZT;hlxzX^hv zF%zPk%DuaTV}xufx8YlsoW-d-3cL9@Q?+!6{|gz8`jPq*)A2e^pMyGWXtiC)CX~MR z8B^!@JZexM0u5v1$*co)NdSd~&^!WFeZAR)A91>FKV&#BFzf45ZYmHX6Dl>Ab`-DjStiD!y$_x&`_k9F zw4?=GnH&b{yuOD0N(0rwYP+jDd=v8_%<3-BXQc|R4=0$w&Ks|P6njHykAZ{Mqxmg~ z{x(AW^Z|H7oRm_Sf@N(9FVA=HT66DN+ajukskZRb9m4@oQU^)4Zu-1lDdNuMN`LO* zmnP6m{j`G!v+!q;{}T;>*Z-N7o&vSekA}r|B$V#qho%LV{wSJ%({yDLK)!%s64F#j z(Ds_H*UTA<5R>_MozdH}m1{7kskU1CzwtPwG)KYkQ6Ra?|BAmiQqQN$18 z1=GZT*#qR*6e0%T!rhBs{A)Af9zZYO)ADh@jh6R@tnI}0JU}~l(|z~H_!Sj?>b-vS zFhISsrF3*;0_@3A>L&elm_$iJu%CErAG4Lz-2!})ZGrCymBGgM{#*&ilc4*0zZa~b z)8K2VCuWI0M_>B&w*`d0^@h%#AxsiJnKRL*#PWy0?RQ8fXoJslRaPgwsrf_jPAs#;8LT$UCp?AG z8!jT34-r&xMH}K=0_N#>X7}#im*JbLxc~ZvH*sx=tKK)tV~Q@mJGm*~{(=4Awr#bR=kwY8k3Cx%JsV#tB7$zm@89)^aKL{5(h2BD{cmKA9)RNmz65k7pnY*|D>?(L zyznf!bCMwbaIXGq|Nh`!P2T&2Ptf*Dg8nmU>XBOn`2`2>xtGtMpZXvMf?G2X+@@v_ zp{`#qBmV83ajOH@T+{9onxI+?G9p3&#y`;31~ji5zzNw)Ozc%z0-|M|RyV-vYE0RK z-v7^9*qylVFI7W?cO=>|(8jM@AJGmk)d~!CWfp*Qs(1Mj_)V8L<)uI9Mc*}Q^w9kV z_VsrSFL2Jc@v0Uje;o;$;3(ZI0h_Y!zz?s1pGHAgBDxfvWJmN2$X+dHKb%b04BSJQ z^8_+Npk=@96!{F|ldIRRLGyykiHDkuY_Uy0IatuHX_idW;+_HUn7Ms`LI^$)L7=_? zZamcX{12+oz!(EQEVNd^fHtkUPUd>)fTYv%kah^Ki3ZSn$yt;iy04lDZGHUH+~}7wTsI1@Qk`Qn7xk6`n3q>q z3DXvUa4CNk7@Y9Cdk;S7y0v{BUaoxBosvs2&(bh1NiDSxOq|9|N4(i1YeBO*MD`a6 z2@}+3Z+-8x_Vy_2}eT{6nP7SnhNoodPa6R%@j0h{a#dfSlB=! zf!Uq~wh|F!NH7I!@C80H5MP}Hg+KrUhYNO6Sx?)7=Lgt7Qd(7D-^GGaD^kO9+Eg3gM00D1EO z6*rTRP}hJf=<4)<@D1Bti#*kptR3vto8#_OR#r-IW5GhSvXo9bD5gtxmEU0{ogmRn z1VIKtCdMq6q})2d!Wp4=4|@B{><%y~=hH3i$u6&7=sN`lU+@z;RZ( zjd^&gRMQsNFto%|Z5i?T4coE5M2tIj+XK>H?+zQb5(A3g2Gn9z#X#)%QZ(l zn1KU`GdiuSf5T5x8ZS^)v{tDi%JUN^2JLNXS1=e!J8%=Gf(iF$AC%}shQMy12s2P4YJ+xc@SPh;OWdVR`YWBdKaeC zwna(8;TP7jfFX}Khy>sm6=j)d*rDtWRCHNIfYLQ>VSk9fwv7iOw&J|em-eF@nphB! z0}s7oJB+>!f%)G}M24)8>x}N511Z3)Z0F) z(DaWAAtz+W8VW&AARi}3Pd|s9=?5K*x4XoIVi5+WF$eet=xt;4Wmby1BtgSI=kK{8 zR$O9yB6sei5Lh`kjTAPVSzUwBlZYW9SQ4d;tnseLb6 z`eeXz3AtL?#hX0EFfjcxO5Zf$sxgR!w7yj+ia3*`m3=I`$hEV`Iiv62Do5U<`4 z$dJB%Z8HAx?}70cuzL)s`S}oaW}9G=bHj_qRY;Egn#yjtmZ3K(Gc*ZoE=15P5|_u456HT5N`uYPwKaX-+uP zih}R#K&-=%o@X)Uo6{Bbu=H)=NO<3kiLBoJi(&QV0kNu9`4u;`twhqiv{5t zyP#gf1q-Tl&@F8r@f2ElINA^kdwn!J#t{XoOTBr@6Wh7sK>7YE;4==y|BYyk@vZ`; zro*IdzJ|e*l^(Jd6zp)Jb&ihSWdfPqNdXJ5HJFU8wc?|o`dXJ>+{3%L=~E&T!L=Mb z#O!QsD{Sr$a>KoMpB)qm#vziT*RIi?@19QvQHH_ScXW>*KZbn)v-;u<-oq`>)zt-? zOBX`Ey!PeGm#x`XP~qw~)$ziDP%q1x?8!a0V{U(jy6nlzZFXd=blkx0*3LKFtV(p#&r<7ZQM>57HA$Be1Hi zV4uWwTM*r$*%CX;Ts)|T!{O4ET3}ka@vOqc!cqo^TpAgVsmJS-01M<9u+qwvAkY97 zy4K@FDresU7RMl2r7-Te;vOf#(34e|w)==SHmE5rxeuC!KTu<8I;yMccTHAnGf?MDc}r!n_X< zFJDFUAndX4tH@RE#L3x!D!*~+Gf>Am6IiJbpwG#yh8R>PnPNC;gstKjy81TX9?0Er zzvLGb?5E~?MKRf_aC{Gr;gY;=E-rreBCMO{5F`q^0Rb256x>@jpRA-#ytbx=MB zI|A->JCHoW(N{Wvwcrn?M0}SRa#Xt$IrR1Q4PYx29q?CAQZA_5GxzxIT~;U=CfIC} zVu60oBO@bY6T9}NV0vXNxiZL4)s}wF(`JGA0Q+&cS)xMZ(5HQ>gIuW6XWYi1l@1#wX`UdzhqJvgB8 zv)>96-FwV2wwt|KZ3Zp_$Pi^Q0@M@~e1>hD$F#e1Ef|61%}&S)ARoL_8?T_7yIu%V zo_eTL;KhyFGnsjL?`l`jxtMg%^FgjD{vm?QrZrxHb-@&lYH4iZGs=Y>>)F}a5Flfo zr+^WLo|Eqmq?fkrc;EsN9$o{|Ea-ZJs`9h+4f%W8AYY$&jfHEjGtWvb-+Bg8C9SIq z!`tEL-4eMHxe7lV3brhIDSMC5#_$c5ItnoyZN|TJhjb@SEEp6`B8VOZ1m~$ah|XZJ zF_E16@N=@SeXBdmx34}P?j${}(KLru%e9OvA|e?R{v=q?b>Dw}UC*9Q6Ob+$ALd)wM`Qk`Gn>t^ww{0@t z6Pxsdw-*`R(pvh7$^&6^=VpoJ>k3 z!t{WQ(68puNTffcFPR1);SXLfFo(vtT9 zS1p#{EOk$?@!0fB{Su0s^E|+>*9s%WxK{9p-Pk3|=N1wUYD5%<8wRN-45%CU(6J~mVSum#n?AjnbV9qk@=VI7_q*w5r)IyD? ze1@G7nV+Lv5U}raR0QO?6^@vWTRY*5j(!PsnlBcd{~|);F#pNE%}7T_2N%2jis{qVC@HG@O8JD_hwaKpdDq!%Za1ZwJ5QH;k{!Gg9UWa6>^$T+ zTe}_Nj)Kv3Fn#i&&SE(!u|m7*=H>>B{u^1gFbew)GPe-tvb}-kl+D0B?X1B7J=tDG7~wkkvHMN;TprBtVR!bOs6MrnU4=UYPzJo!k3fK7}WKKgKM}xKQOn=CH;Z9O%Xjvazrl!&XPI%fjNCZ&t4P{VoF==^!?uRbac@jN??gm zTT#KD-U~Y6$l+Hy+S+iP)L!EzsCeKP#z>}uc@!9E(2pFNk$uD9(wh5m6;7J@s=KF@ zAj8sG=TIEds{c6K14U54(&=*U4J(4v2OgiS6*UBfzNTgezQ$tsGS_KsIdF!VC)q*# zb`Fxccvxm}aq;SWD>ZEc3fn1m9)a`c&(Eq^XXoTphX@AJjLfG(^*>_fjTik{`fR(r ze`p^dbxg1IppW@vzRZEo9YS89xs}jm!;-QfH2@ms-!DywZ+sWv?cGNzRJa05{$CjvC-V2x}!73lNOE_o#aV8J*4H^6yKa?V`HPNmmRXjC{R@jnFC%v1(iM+PzohN_EK`bCzW@lki0<^ z%tcuZzUJA!z!%+i`Pq-pD(N8F$nK4UPkxcd{Wi8 zj~lRjAa|*t?k9p#m=jg2rA9ABm=o&lSAsDO@S{d6m z>Z*&jqCf`>=C^^MJneL;4~CTYWrg&;F;8bNt#La@<7I zbf(j^Wfapa9~GV$+kl84rXzu+ zIXGXiT(|(9?BImzt#F)8Rrt8YjM%aH2Lo3BjKU`Z9m zK~EpsU`~WmRD63Epq$h$m2x7?J0*(xR5V%*D)mShMx+6@J&=S_$$}7^1U8P6l2Wg5 zvdqR=CHPQoJPKkWgx7|Tej^+e`QJNB#orFaGxp%uUEISCO;=6~-xlcXRN~{~d+M_1 zbBzNJr+M~EiMfoizAEZzJKM|ydnw}DA+cM;%^{`U;+9V>y?@_(2WwwVHBDtJk7}$* z{qW%fn1J9yU8q-J+%{pv1EfPoj~$bOS=kWaVP<)xR!XkBdo{?uOJ>0vZnP;e4}_j> zZX|p5xL~o?bva!Y%DL|4X_zTg|Af8R-i{;7lhfR=l9_1 z9|PPIn{|-B2PzKoXU`kSm=(`000TfapKvPf0+~tyMil{~tXWnHf>{85^YioHczJ;h zU)4eos&mtim%yNo1!>2xxEN0uq43LvQ+@t9WM)g>dO7suzN|%Ha@q2)?g8`sB~$Zs zgvqQ@PIL@*d;*7-vh!xR&T(|wlVa`(XPMG%YlE#pzsOSZOS~SA=!Gp8UW-4^r{Jgz)?%pkgoBjyL;v|5a4LOi6rMP_h zBsxe9(|fM!Kt4x!ETf~8H%kGQ^@$(Zj|B^oljfu*ynH==2fW|B3ClW|(yKPf=CEQu z(oVD!{3g<~vIxrP64OVI9s%53as`Q8pTrLVtXRL2T)3hK?kG7SbIDX2^7)PK9yrPV z$V+$P)HTu-nZtj1jYhVe76!ivm|{%a7bRXfHzc;aY~kk%WL%DgwHf0AuBfXoUGmIF z-s>;<$>N&~(L$@^w=**rAU!r&sWPhLFwuDEv^(>_0r!G}cI3>UOBfx$_LZec&zCh| zp*_{Ha5ZP1hhyxOwUy#LUVLpB)!Lohodyn>kF1O{Ouou?9vbZo4DDSr?aeE6K&PbX zw}d)1e+jLn+6VZvv&&Nw!}?Ek)zw-h6{HMuY+4oBhtBSXvFYEGuZ4w*R8B~?g``GD zVWN1@h1NF&tRG>bq=H4M*w6Kt4hf$8x$Oxz}gqd85pG@vd$fJG@RS!1SN!vLTH% zU4sV32yp(PiUwetjOp&FB{ZMewFFpnvzflDu{vP65T*lNhl=Xkva+Its30!2^n6{= zZav5VTrO;_&T|ud74`J=pzOylW?|^N4-1%ESX5V5re$S80(MomHS6%D$I3)k$YPYL-c)mdmxm|k=m5;Caol!8 zR9KFjFCkGO*$BU0aG0BEvMKRpvav$ly}RB+_z zKGG|F_~^t%sndCgvMq3O+Et?7!Jhh zuD9wM>r6Z@^EFC(c~^7us3QSLsX91>kX{GL!RM=2LO#4BP}hxlU@&>!~GU zU}>{WSn0c&mzF76h1bLqkWV^giqyD3S9n3F7#!fd$ME34@=5F>EHBhYDsU-}GO@70 z@Zw}oPZ>#(d?p&FyENkMR9NGE;>DO~s)p`5(W0>4l{*AFi259zN;EPf9I* z5aVAJ#5Ln+xz=W3qOtrf#n9GCsk30@z|^A(vJ@9BbWPm!p*7Y5&bx~1BcBeW)Hu6K zxW)hV*SE+H<)tqbizBnG8fcA+xpz*iAf2owJi5qPUmRlfA~ohtZ+Dx!!OhLBmb`wK zNlf%9bWdxZbKcTbSD$jBF@gl(^Wz<>a^U5{tavG*j`yX?3sQv@#{DAbi`A&xqfO5GaDB;%8^9R z{a}$`1UUH~Liq^`B`Yf%d!~n+go?YWsc8`cZGGjNH-|@v)}ce4JY5gUBf>fI`TL^G zF2$laS!F#^;1N$R8ZjaR{~{S*Q(C-VK$tXBr-6VEJ>J_JFGdMmqDKh5$<6rSsMfV;bYBtfvM5Q4XxV3nI856MbbNS| zj82;t(2EtmR;8usVp2^~!h9(+TAiPnfTM+ba=ZF1*Rpl7Tz|bZx|Lawas5Nd4)~~R zxLi7eyFs?*@m-1Dzddm1qd}&HMx%{N2~Lo8tX=zwiNULQ{I-nXc?Y|K`1mo%79%W5 zJx;C;({P@nlVF8@-dJP&68O1_vvyneyF=DpcG?yMQ%+7Io$TY|<6+_9FI`@?Fr3EFZBUd z6`0Cr*i$qsIJ0^f<7*s_Kec#L>m0BM%0flZBG`wXw*7Q-z?&n2Pe@eHU--p`;rqgvUV4X z%ZwBpxN1vFX|-3LUUMIh5No1(BQIwU?I9g|2xm0am8|%1St7hY8|(2K)jq#HbZ~j3 zjl>SJBl$X)mX`chuj)uk*Q^DZ!vK1~j|j-$i3x=xP^H7(M40qFTLS0t)wjN9d6x7zD(?7gq zT`y1(Sn4+ObRBdL^mSb`Xgh&UM@iL&$N=Qb0}1i$0piJ^1Al!R?D=xnHfFW+LptPn z4efao9>$1DR^Ic@GnLP#ygzaj@^o5fTj(pKv=L3L_@GPR#x1*9)D2hj>xRTI*PfnY zjrOVp5r#W4d$CsoSJts`36s|FqRj>H!@+rlFlA6mQjuA2e)`dovzH*TGIBzt-NUSG(N@FR`e zi}gVpKRX|Td(OyJ9Cu=ROt8|N16eR4^hoeCh)KVz*9sUOBpr193Dkfo{YAE8T|^%r z{^Dwt%bxqTAIoF>0@^A8?(S0Eg|(0#SH>*S+aDd7X)=v|dy`Z`$GgYC z{cYnIYo3ZcmcHi*TnUFg~r)M~TR^e;3m%^L`sXvBm%;&X;WEG?1O zPt=u{3m5jQx$isc!eYg-CN_7b#D7YVt5fLIJHPo(B5-3EYe@-ifT<(_>n>m&RWkP?MT*kRKycNz1IMLfs7B?~v)XbpEjN3~bJzO<36j}VW3ua9$o%Z?j$ zK;Zd{h37{78WfyGcobpQkj);<-Jt`>?`7F$Ge`&I#lPObMK;Am-#Xbto6b}ZKg&+M z0`Mp;)3N)@J=*A1@a%?WsgG|tHiv-afVcmKcrqmR;vb+BAuMeB=HiIfHYCERdXE%( ze|w34GqVAc`5(M;VcRyy={Nq*5ea0~ow(eQ!krWwG1PJI?-3PVh9g+ejA)D$JNKbCm}I0&s$n_ITe|Wz}&dB_6b1F&z?P_$QA3x=54&6cZa|KVy72% zdKv#)9L?W)fmHJGTIt`%UN~{-d%6cJ%i4Ne%c~{haHy|jb&09M z=2)7%76VS{57!!;7j!BvuY3 z>efS;>}(1$ppi(=~x4jtitJLC`MuRbh;7K@WNW5>K zC}#F$2Q+!vAPXf|wJz@NhM9eJY;0^46ciQVfL0F!9iqO17^*^;$e0uAY64D+lnetv zOo0BSsf9)3L(V-1PV}6q{U6`4hBy9**UuOt9}^5wVAc`y!3|SEcS})G5om>gQvw|c zj7GrI7M$Qif`XU|#zsa)CMSjZsN)rq36m$%nN}tyCI+)ul(SFC6Fj4r?7$sG@w5GQBgrQq|QEV)iW?O1-x4pF)}c;jg=Kx;jhR+9%lyrE8{Q5y36@ zgXyy=5oESEJ71X3H3fj=sJy0zyVra_2?@X=-jfmJ&x2vir3F~G!NllvCR+vVMRBOj z2#h-|&l!R{)_ULN+5Ib#TApA1s3TapPjF~U>b6SZDcwuEyVaP`0#-GprPpkZpr8Z* z%8+}*EYM(~74t#@90}pi-7{NH-fh`uj;Ki&FCIgW=2iJ<>8@l9wSoOytI@KXZ4;^}IB6Op5S$JF^Y|e7Mmg{s6&w!YleRbO|+sZ=|Yr4kkI-e`xc8d~x zXaOe1$2$0QaQD`H&Ik&sR0V-!hn5bs6u(J|i!*Sk6hW_w))#1B304ZGMXcZCozuaF zxEZ8@x*%6-fvK2_@4Go|KL-cl39OpBQFy$&BLcynYnmly;_yqzi38mxw0TBbN zpPeM|WL7M<6@wTQ&K1~b8>XB%aiRmP+EQMj(U?^XAEfl@>+#8j1nMq}@WvvkzxeTC zB;9_G&&~U>4i0%N&jT5l!JhU@ZE{|EzOI=)Wa_TZprRK2EP0Ul2%R(cL-nzqFD;Ou zldB;wXq5vM%ziA94eHJgNCZ{#Fy5JKgCDFMR)rquG`|r5Hy_aH zgTWvc*JZ-Mjq`;k!JxUK#@qX7T@LW9WxooBp@6}n!3QprQ%Rqkq3IzZC1nUSzwY%# zoajY=y#KQE0!xHDfaSI&T8cnGzQFZL9<}KgkMG!7OIqd$Ot-HZ&(2l%+*iC zdFOSR7k)eX|Av;$%NN*M05Q+!{e2Svq9WFg`bDf_FEMnjSPl<^NO`m)r{Ki&OKB>q zK&YRTvK(y37Rv+DXp>~_n)eN43EBxQcbLhs#j z9VdMcD}zuwtUCaud_k#K6W-PFjxh^ck<{}->*TCQwxvoC24$txzQVJPjeUPXs-Y1I zwy5eESk7a_GMDOZoG7_TSgX_Gb{B<@vKw_sR9IEI=YMcgtrcLYnCi?ED-Qlzf1AkM z@c7EklA7RP8rwmiLlnbamJ{pjODid>B-nUM!oA7Q%ZpuEVGuZb<_vVU{6a!h^>Q8Y z@Sm2JmH?sEcK;e2u8LAzGj+(Iw{ci0YKcKH%u4Rfh(^`3N=S$u}3yJh~i;X zkHzpLMG6cmecB?*bV9oI43bl2afGQ;Z2slKj_tNSRF1q&c~c%1j~*syUmQF$tRpRYy4CxnV9kB8ZIrCA4|`> z6n38?6Xlb|_nl|!)0*wAc3z1;IGy!y=KZyPCTYpZYzqJadLJ(fSSyS7O*lx z2~K6FKRHchix8fROhvt>c=1=3yfLkcU<5!8MzDG$bln zH7d-(0|JT;6<~^3)Oz&PC>L>1FbxBfc>Kj4zwVWXsu4#?C6;FZEwJ5z)aogCXp$Zn zDDjev)XqBlMz8HNr@H;vrO8#ranzhI7HVdLj&!*L*b;dS;qjaYpDksT(C@Ej?d)Xp zrWyv20!-b3AS>N=zv8uV#QMO;z!C`)UXisse{IFU8kG4=`}bsIB(ka^bL}(p6E~jf z273I5bRfP8P0%OfS;M1-y8phJm4%H$OTfqJH*)zA30+}$j zOL-vY)Y+|ySEfVTk+d5F`r@H&{zqP1quI&3*s6nGS?$K_=`>Hb%uK`=z8&uQV%<|D zl$_6gg=b>24h$(WI&WUG$9+cOm)(b`$RyTGh`XDqrl%xuiiLG}rxvS$N1a%8a|rvx zO^GTh%5Mb(5av*&n_5kyQVpVvBw75_ACgpnn?5y42r|yB=vBe7}8_I5sV*_qL@u!Cwia&eMP-Xz4n$YSM(Vkagy4dIq>-`)I z)e`Ef9o6h-rY72Q@F8{$)|WbRGxXt#r2diwj;;oP%g^t|5rW%VAopjw3AMBGNzgt6 z=z;Nsn^6%fS(k%V!rkF&9+6L}C#JiZCGBuCV$h|U#4e@*s0xtED%_oe;ukr0v(-SG z!6U-x*p9yrP&18IRPmp)Jag^5yZ~TVDOo?TtNja9q}V^esk6z`?{-;9@7XzT`sg8( zU{?35{RQZr#CAHwJ?=TcX~S?pCCgtKMNDz@@R%MxdCB@cj3%OV*M{DmvSD^v_-_*g z6*&InpAhm0|HJTjJP~VRxQok8N)ICZWCR;Q-K0Hxc811o{PpxSzS1${2STMXl4Laq zBw#TDn#GJ-Sg;q!bJjqIge1~QllbgF4z5@ce_ffMVYWMwyEac@{KBw3YboK;#X*f( zPjbm)#C{y4NjRoOc`_nm^Mgb^GQUiNKG2~Y)^sB zm?$hFw|>(A-2cu7-_~}TeaGCIeqnC#xSD}tr2}d`*pdz2DcaSPHBuW{l_Mqb7K%xc zH^6#~jnHsnRlf9&$3!9Xi9j@~4t2sKmr4i#+mt<9eFuPMCYqSQrvy65(Rj8cXrgFsMaW9VV#ljF<$Wt3&@F`dw0Kpoj z>%urVuOmk`-pe~$ku632#q&!v(@G*7^A8;q;ZZO9uEFAqTTMVAV`FXogXh#>zm@S4 z^%MpNDP=!w%bcj3QIB&3H}V467}n_3ZFijXc?rM7@!qNLAi4kXMES~}7>a(AbdikR zG!cgPg{i42%ti8o!p|J|^}r32z1t4GN2p`XUiY5y{B6dl>i*AvOM~3(X&8Psg%gAY zh!7LSdvFzgedKA-WdV{Qbn6p=->QjI9=Jsq{`-^u6uM=1Vb+{sgW5sWz_ z9^O=T!=nut;+M2Fx%5g=ZN$dRN5Hjy<9HNMRsb6*0CentISB~~{rkcBExg1Ltmg>h zG-1xFk!e_17fjIMw0RjIl)`VRe{cU@Q)p$xHQey_@=Al+BO!q)iCfw9j}P|vHz47U zw)y60)E^#b8*=Ut@qc7fZETZm+qAdVYu~@NO`Ut|PWbWF|M0D}*Ww%5x6qNU{M|+_ z_V0-<=wr7M#5RZj{$}PP_n+|J|Ci7=9%f7!^6YRZ~Nt)Ffe5O*|o&w<$ZBYK+HaS z6vnzaz&w^iD+iTc_&~YMXsmSe=BX7QmqHkQ1Q?Z?b?+_|3SSp4_W9E%V3%I-WQXPy zaOuPuLEfScy2?RkhSC6k|A#TJfPb2<*I3cmcqhCLM0$?#`^hz-p87uf8v9uBLG9lH z$?x0jHshI|tWih2YAK@WW~uSOIdKUIa289v77oS@vYMI^FyIh4@BnT^S_ujYc6N4( zbvz&_zd_FHdlgeqP=IR!=I5sh@S>j$0r46O@~Z30mtLx%cM~`08yGlBO$}VKjxS$s zLU4w{;D*?t&-?%S>yf$n(Lj5kEroF~FvNi_3aEs$2Vf=*OP7?C6qj5jU~(m|;FWUP z9tmIDGT%5x3y7n?QzCz(S`puhpzDzl$RjXXe4=}_Ur(zah+7Snpg=(~87UoBRCF0+ zrX$j}k6U0iVIpAY(C;IlChTbn>>z;vM^bt_w++e>`JOk%Us###f(qwPIi&Q0zDvB) zXr=ifCv*ukmSGYLblocgu~1_1TaG^*5VZy+E#yU?8l8WG+%8X~!R+sU4xXJ?j*jdF zCjBgOZJ|f6`dCq7f2GFtH6pc>;SLhT*1AeEL& zisI=37QV$7!R;_K$x)5}rntCk*Zt@F@ur@@W|!zba4H)l^aTZLF#U_!*U8BV7=FxT zfVo@Yc|be;stL8wr~smzs=seZoj+QMgqRyMa{TX{u88#zLA3Hgo;!*mJctSc40h>} zIvUU`_v38uP5Q45vmY+0jGgiXaoQHttAWZ3NPK6JBtr9RyJJ7M=OqHGiLVENuUtp2 zg&4NHf1GC*Pw0S$yf`94#rYnpe5NK`UnS{P8S|>Albtl=!Qd#>oij#kbMe-#mD#{J2K3q(R%I`CY-DQD>2i5;P?!|2pf zr@%b=cUB4-A0aYDMn%CW#d%}YYTzt$iU=@4^Ybs+*{y;w`gsUUi9#%QgIH0Vu^aWB zAbpc#YlE-B911kRRQD276>f!pZp`OpbE5ed_Ui_hm6;eBvCOVOJSi@A$^u$R(}Y)_ z)^A{yy+hupdpQ8y1K%FfP_OHRIDA{(50fMzFMWG-8uH|c`bZJzm=k~$`7aNHO88-6 z2(<^%4jk%wm-%3pW*vuF)2D^KFQtQUnL4#}XuC<>vreo`;&U@L=>SYh1@`k8DKe0S zSciG>x`wXD?ZN@7-sZG7?3GEss%)W>5rBsCwp}K-kT8yC-(-+)$i8>_B8vB#(^_)U z=0u7N2B0?D%CBc@2xh<(2XU>Fy*99~{BBO{2WFtKton{!US&;XJ zx{j5saAlM+*HxMojG>bm}>ng?&~z)G?o;?_b*+!;tb;j#*OZSiwNs}$_A^> zm1nX=sOg(e?)n3P4j2?bz5O&>_n@6b@Y}j)AfjM(^6nm&(rdd>@RT*~>*7daQ8RCj z&#*5~Yj2<$O6k^j!%fHn5i_E6BU7X#f??fQVG$7*#8Sss*tnPwD`mxEC^SPLKB%ZD zJ!iwc%8%6}omRl_(gku=MoJ2dFs%V>9uDh2lBEIy0%o0oLbPiNgDXz0TVs_YifeTb9$ft>mBRRV}hO$*kemg>6LbG z_99~*|G>I86D;TLNWS($C4cCp1jBizAjSIJ%bpzsVuSlmoZXTGGxBg({`tatX|zzm z`|Mb6)F*qs3;c@+1*9Pqo}GlbFAv$A$(X6h^g+PXSu7zS$v5lXfVQ_zv!*`){DXZ& z7~oJp-T(5or%_|zTShS>-2Y+i&Euim-~aJC9XU~{Y*DCW-zrH9rbU!J3L#3V?AZy! z;go#~*|HR}8;WF|gvgqG3zJ>;eK2Nz*Nuu!=e*D7`}p-oog2vF8+o-_s^WBPAQ#t*au(E59yegq~l{h*4AEW3seQp z_a#|bzU6TQ_$Y;%t)gNWXy1zRGL?}IBIy8JQ&2L1mp){U7N3XwbBSmO5384*goVhx zSdt5SvBnC|XVW{yU-xktVNWTx5PMKWbwXMW@RVpKzz86;0c4I*OH{}apq^z(n`>c- z9<1&V>>I<8fa=r{tWj{rL908`VSn04{dMgHfPvubn!@?dVRlm@q^7T01=`-$38KL_ zQk9K)4EY-I$5P-2D7vFyw?o zpzl65l#`1K0v-tWwN-!kU*YWB7Q(dO z8_Z9sa(+ZdEbI!b3F@ygFMlVedh=R8IK<-8%>38Js^+X=cvjeD@Im-(b3}l(CdP7a zm!x*u35xSpY$pAUwB(Hk(o!)6r0>lGRokIPl=~^N)hKsnoD$O|g~9;?qfG=B+Ob1( zq`0U^HrW#Jc5P#M)M!s%ql7u*S7GJ}Duz7|_*t*$1@W_7rJmqHHv4r{DI+X^iK1OO z_EY{kf`Bs|C^v3>Rg#1uPK!Z8xrm#&Ad#Zpe(ks~{tY4RBc5AAbpNJbK*}>JJhD*& z0m{I@;MueNz|noWxW-W$M0m9mkRgc!*`8#vw2fI`h0Sy{qtL7Ref|!4HxpH1`0@Z? zaG-(hsu-rGb7S$0r4i||dlIQ-HL18i6-G2B_iJGVd;*0rc%<+znK!}36SKFgU~Vx& z*?&;)<{WLem2w6Xk!Z-uU~WfPi$e_KK+ijAX_q@mG`+|rnQAvhVD+&EqE{fRirJ^I zEV-GHg*zbrhO^GF?6GDIaECJuhuM|&KfRm7IE;qO4$uEixOR4hV{|Qe%q;VZljjD+ zAbmq)y?)rAwd>-;--w@wON|Cd8dvQQ5bDuI-SVul&!T301DA9Jd$_ZPZAxQZ$T?ZW zF#8(=yPk~G5wo9J^+=|_veU}#EcBRDpZk*3JmcA=fZe8^?Wgi33NXw}pu|a?Nc{8% zo~_pt3krYQmrDS?AyDlPGcG;ee-v`@iP!d$KW#z<-yN)7%z&ed@e?6rGE&s`=}$dT zVFcTTLUtolCO5&MA=Pj*>HWp}H-=hra>j{{U3&5_U^nF+$I(}O7{?9h6>TI3{2CB! zFxS(1CogCSJ!jca0TxRF^+;?V#aavN$oR)kt*JaKPQc|@N6;SoNv&h6ooSlFw?-4$ zu8}sEaWi&Lhq;!M=PIq7mu4N$=&bAtj|g-4`0=a49YMZ=LRkZv&wi9L9 z&bof4uahExl~tGd3k$7^x!9Ok9#Q-a>#Plk^J2%KT3OZ(rQ*pKBMmW|Sg<^>DiUOGy>?}?)!t3Z!RlrQ2&eR2o-yLHhvjZ?_0%AAo^6W! z$G!m{4A-yg6fmzy2!s9n4(8MJKm8`dPG$Z90P9=4EnQGrfB`gUj5ouY*SAim~W*D&V8i4-tHBB!dQkyc! zwwm;+3m8b|AgD~78WiHd3FP{a?or<*z$-%lU`2&${=>{EzWjxU;9b?LR54u8lku-c65fh^+tqcHwi3#lqFrj@ublfjKi#G; z;Qm}WE8aBv7=NkjH7*=IDbQB?r957m0TKT*a}URy{*4$PFI+s**siV3J_q(PX=xKg z`9q+_gND@cn1uKK1UqTtf==*ciLwP%n{qG)q<0$0{_D{Ns+*fMdKavAZJ^`r{&_=_ zkufmf{ay;{c_X90cYoT09zs~V_#Idlg;!h>`MHrVAC?JU`~dA01nBnGO6EVIGL9fk z+CpDz*q)QJs27n@T_W99=)5Fk`1Np`@4?M5#d5E9bky|o>*>Ai7JW%zmbpaX6OT7D zli)cu;s(mh(c7AcxFfa}7#P_Hj1n`d^A@h4(H&mKXUqquftQ8(p>ZoQ!s4ec9DR@Q z?L}f7mi1fklhJ|B&%}E8I5^0Gd7-^brQKB=F9JTX zs)D;h^GdsqT;lE{KVstYEy?WHFM$wffjZ~_kgs+)$TGRkeAk?@;8_>5|L1IRoml-r zN^`0(ZoJ`RJBS}nT2Fw`k7zO-$A9DW%;-|(mjJ#mUkVw$UgyaHU<5u&_;FJ5%#6YE zrwg(X4-==K8jCR;dDqpEAE^2~jkBtBp!O%#*2R*0adP(2x=L{{c-0OU)U_@C^9gh+ z%MX3DIdMTj(Bza{DXuWKLKoQ9B!Y0T;$Xgqw3!L7?(!;p@ii;3`Bab}zU8)$>kIS> z;?N6(fO+9@25 zh4PJ_*n%(AWcY_#6Yhf%CywfmK{h@Xk$?l}%CL}Sx_luX4{ z-1D$7>JYQ}h9>BuJc5c{gFda~`SnJEM`*gHqkGuC-buqQSl$GZCOZg2f_In^Un=L=yEACZ8!BR{5 z2?mM12AkeA3N3K>&V7LM$LL;q?VGQQI%nUUqQyx@csv(1zk3-dI+stH01!tt6dSZv zx&k<$2j6t0nYbO?@}VkN7{_w#&ZQ5cpo{Ix;ts=LXPeYv3eY543`lqh!%-Mgz+3AZ z7!Xi@lMJR%;G!tJu<32t^!R~w{L@XFQ3$oJU%qEKu-q4&?$B9=~+Ch(P?RIy(lS3PfHtO z_ia!9UN$+dI-0zEpw9^s(w|QfO;Ag96fJ|gNTR8B-z9`qK_^DiPHn)hX{65aVqm`o z0Zrx1HZR83K26l!UQXJrKu;lLwH&!sq@92=`mzM#u&LhW7@{95`OsFlM11rU6;>}i z-t>jZ7wf&~g-1+hdC@-hH#DmpP*-^*V})@lx37T`w=qRMm*RGHH5K4&FFykV#a4mY z9t18^&b!21?In%h2_$Id9saO#QT9*lJLQJPe<5dKVS$J&u$R&k^@D8lTF8OEFiuBL z58B-RnW1{qjGBuP4&;9Ssx^QD#Ia50(ckd}3t%;9@!Q3*`_l0MdueuLq1Vm7%RMCm z-BwzW*HbN`YVOBh_gZ(%vXxwG(?L_L(TQ!T}u*zz(u-urpp;y3ZOHFdTZi zvS5|YIvQUKFe30LUWfcdh z4+N@6;PHdoV!ojVwcTszL0%1_P^xBmBFunte}0842)p>OApFLK^yhK+hFx71PQ}pM z-UlgGi#p)Su7SuWdPB`YBpC({-=|^+Pk~n;e5;fFTDOH%5^6h#julp;i*?i9@e$dD zcg6*Qggm+sB!d1ANxTExr8VF$OF$$g}2zle9I-Ose5 z*V>;0&nZ_h0(t=*BgPwaUu_{zmp5<8_n)$tw`G;KuSRDL?12h7hT zE8oZ4gNr>o9kmK{urP1}qacIE#6XE?o0~&otM&6|s&$<9_^Nm+Jl~5zN_+!XDWo^AFr_~ynQ;ZXp`EgyjR+t%1w6U@Aj=hhi53T%=2AOZw?}icd^Zxr7oy{aD z1;+E~HB(#=gy^I=5X!~zAKF(D4NZt}HQCeG+ncvM*RH9l2@^oY;8AeF7#aeVfgJy_ zzmZ42{H;3l^c%nMUC2`8+^ksv$OJIWF?PTU^aj)6?3^6vSwPR|KWX+ekEH)!1Vmrd zFo=`_1XU|k6k!sm`u{Ifl+~_qcspJPG|-b}tUmXThk^*+H1lu#nySD4!Ga=nwhjFK zm6<1`dwYAqxKf0N$0KP+kj6$+c)bJbYl97xpU0umqTG6l1_m;G_x-Ny&Wzr5I5-9f zj3%Sqt0bR)na!^*kk#M+pLi$hf53N&%FlKZ|A`mF&VJ&=dYRmRQc|ra1Fu@CZ+7?f z-0=f!?SJ$SmtErj|8L*W@jI@1`=8(a?{u2=*Kech3(g%d5jHoU0a5$b?R$^tlm`GM zX(0trJxNaBmo9;@h;`=Rn>{?BF;?z;6BTuK#w=@9TLy+%>j-F@;xl7nV>7{pF}fD4 z^SO>4t1Bvs21ilY`0H|^?;IN&V;xHeFc=sh(iJbdIy*Jd!;rkL-RJAO%ccfq$Mo1k zFylD5+K}VK)(smSuTj$+KXSs7(M!2rZM+i=n9Mw?Xv>x@OiWCI$BxAWX-C4xfEf}W z7Z(>FB|b1D|H+kT2|zpKTEE#lDaih4VRb}fGUh}T8>N`{=s&7?-#3XxsP{=eEiE6} zVh8SLgf@Y56&|e6z%CmDg00xNIFBxECnu+X@bAt#Fwj}WX8sjI+_2v0VqhOo77Pmx z$(nXRPnO(*!A;`S8Ka|Mz}j zhrZ6cnx7G~P`6(oX32~o@M&w!54rAA7RS8Bb?Oiw?6!zpBKKXWD*9I#%zI5dR#oMSmBz}G!XkzqnW^r9pt=(L!6lkp#mZ^PcC1#nmITq*T`)M00}BY5PphgjZs4N?A!EN+ zl17N=Ff^00*KnFr&W*UGZ8ngp<}($Caoc{(JfG0{rypu|p^nf8#h}vuAT;x!GW23i zEDWF5o&*f;#w-)(uYIqI$yp{mEaQ&w@$w!P5Wu{e&U^b74}>uA-h3Kuzq&WYpZfN2 z!vDWZJgV}}f!$EP{f!Z$*L2L~TY#lN;{<}kxeHV5LpPx38yicJ@Z8IpiBWM7f%E|| zGiq-ae$urF_zJS2JfDgHW-m4BE$E!oS`UhXKu!Bd-PAnFfF|WJIe|wRec&pvSyGy! z33hsM4?w-Oi30I6NhlFQAou6eHUB^%x^;sIRUvRR+_J^? z%;~lYVJC#)UsV;W-|Ve;R+Im=${Uc4wPl*A%ms7fRNgR)+7AIHwwI z#?`A=UUZ=uB|o7x*zCl_QH)bpuDoc9%P@I7b2j{7^=Xfr39eF1JDy*?w5wZ>iMEt< zV_F!yd`DRSNmY98w4GT0m!s32A+0u|R+eWXYbrdI>+HZi>Vppp^PajCsP3^5?W}Yh z=wo`7!47ZVUY(ww??^YhoVpx&Dpy@Y9fCiGc0PXe$h}b1t->Q7;R1z-aPGV&hX2cg zQkB9W26&Uz#P8Qk|wt3hR#jH+%8oKe^!oPY_c5)7w&UH z1?@_2S566aw?CmNOTm{%c#2sEA(qaC=J&Sh_$?Yb^v{mArrsK|!G%F9i8$GjIj3r!E_}yj9Rpuhu$p z(MrL9XX`+97_Y^gcG5+Y`r-_O1$qHqd`WKQGg>ZLrRY*dUObSh_?bS=jP>7!^^1J9*%okej^l1x4&`7opyeQ<;5@j?fTOh{(Sx87sJjL z%F7%=l9A@}D1f!~P-?nV-hj6GPyME9LCrxBD=J$}zk5gLASS}sA1AZJ%9Pt*pXAZ~ z(#?LX^RA%G)v`}ZG~y^&jBl!hZ2werHA zJ=`i;K$KwhPLuFTd_5quxa`x@JrM(f#K2x2Hn$GX2vs=DG(gUhH#|1> zaH;y}!i8+e^CWVxJ?YQF1^M)TUJ&26Z{LuyE=0xawWJjUpL%dabHq|_re(RUkw>M( zbs?H7Ooj`8Lz)q7h(EU#5iEW;hTu||FjMpk#fdBLBt!jl&CuCj(ZT+A_4Uu72@iT6 zrH-MlU~=&bmD?8kW>PyUiZlB-{D}!?IA{B$pQ1IzeFm`+_QloJMnhJDUFh8COSKrS znz4>E{92PbU=d`>9GjnpYnDGOR4<8cyAS_Kd+eT3z=OVS#T26(R0+76=EA+^@bw_! z-MM?n{q62JXCNP6RU`AEWojcRL3P_2jQ?F@@#q-vI@?uCt$W>e}D!ym>!J+~AhiC}TuEwyR^b5RD zNR>!rSD2voFGDOJmmiUlYDx=&BA;o!zPn=~^7eTB!02!E1Ysj)3rqf>;q>V*Uz|rq zN2{N8+z=z?4We!c%5meTEsl_J;;H9TcNs5^b~Dsze^!ZfyEytModDX^fNB$AtrRtt~AwM04}jS90C;e&aZw8z+UZ^8InRfuFY`T_2}NfA@ypIbNA^ z;-CA1s$oB$o9ksHWQzBattJ^3W1P>5GOWybx}UMF{$qlSME|*?oo@^)z^9iatuG_LgqU1QogJ=Y=B0l6I_cM##m+v<18*pw(RE(w2el*`jLM^24>bAGH%X?$AB(XoRrO23mE<|x6 zXe6l22^PXn>JmYDsl>m!!H+lL8uRD#tV%1UC-I@MV>D~pWRB*6e2;g3q3n%eXHF&6qz- zcr6fn;jE(;nvw_$U=Z7r-lJYDeftC9f|^0?3pZC*Y{J+reX3$0EmU-N%H>RpVZ^)m z!q~huMwIp!wWK@uI%!!gyPVQxI-Nl$0152Gdam2WZ+0+R4-DU&GCgUa%HrUl<=j?c zeq2YX=xg?GcQud3Io@W?NwJ(C6%w87gW{5tf(>wC&7N zQofSa;qnH}seyZG!oWZM%1C*D6ZTGel+!9lUB|0~9HaiAPl@y7B@|A%W3{ zIWpU~Kr8iG>`;wM9OfPi*MxuLY(Q^_B`TLAle?GMC|6z; zUe`?lT!A@VR^HRuMtF!qf-CJ_ta+cLv2%jGZvZ^U@D`)=IPoFL7#tRO@X+f*Fp#FB z3gxE1{U8bk&^gsUaSaxS1hhh@45bOd>*oq1hoxamegGzt@Xv>`@NiG4d%7DT;e)>E zzpb7N2X8C;NN2u^zIN}BQ0Y~hm1wsT{1^>EhE8i@KrIiwoYT-f@D<-@i3MKY*F5J) zmKD~(50+4+{}b-#C&4pWFOWRzQyC2*>Z|c@WT>NVD+bYAD<986FTO|Mg(ZoL423Fl zM7U2$e{2Rm7^+2(fdVbZtw{Z>to%8S{F(zbC*BR7eNZXM71rDdBqP<6M)CD^b?)&U z4pN0RRL9mJg-s~vq2^>BuiHD$HFo_@f!5x`K*g|GXhpMr=I zs4Jcb_FcN;D_l7#3K5`0-& z+P}?ysOFH9lB+Sp#<%kPr;2K&N>=57SF6u=)~cj0VOon^x_Kx7?9GsmyYekO;zsje zpy|+G$)FqIy|#?EuUp1o%&{+Lw4hG~@6gcE7c>Jq4$`;9?g8-(1E-f^4eYWC)4l2T%~QjqTcb6X0<)a8nsQ z_v1pgf~S0G`Cy&Uj(Vxr(#@`hA0^z@(BQ8_mEz_e&{LI6B4< zCzh+rvQan=coUoV{u+2f9vlwZgl%$n;1f9~VzaVjnSgp5q2$4ha>yCGV#| zE6fW2=@f}P7B}~>=+hk-e9*1bvQnY zoz?H(`ROvV?>|9?Qu3oGXg?Y25$^oO4~S5lFhiEn?<$hN{>LUX1gX<#R;?E>rGGS> z26!C!UO%{S=k8tiK-ku~jF)hQTaFsZ`o#6D)(hX6Kcdrr{nIla_Mip!t&*z~*t8zu zDYmJ(xl|B-mYF>j&=R}(Zj-L2C-`A#qK8({JupiuZwLB@G{Gk-IC$^(Qu8}!*YA8` z&E<=FPSn>=(GV2MRGXOOn#@s8Guai*WCA6TAWEZcL0AD!{A*)^IUEM=dPyPf3tJjd zg)!bJ9v&Votrr^M`TXFejAV@Y1*TxW)jsP!OUy4e4Vu5`=?K&GGP~)0eIlRn)iGLs zaA4ij#Ap3QueM%{f{Nv^JgB=birdAXIV8^zLS9l1xIscYkH;hw&}3+& zY-2YL@@ZC`=IvCoJ)o(U7hx~Xd$$XpAWlKd6Z>??RDa@kTd0@8jAwCeBiR&;+OR-x zvXhaLFegZZ(S>ycAD1Tgk2t-~&IpUIZ(aT}_kXEVf!%u~D(JYt2asj(U}xGN*=zUx zxuwf5E8m9a;_nN`?!K6`s?k4YdUY!Ybg^)L`1Y%$y6-k#{^DXETN2wTcs|Vf>ejg3tmivEYs4(1r727{ z$%ZXn_5io)k&awjzthL3Ao&gN@!s%G?c-rf))vHTu55n@P*Ul)GnGeH;Q_0+w*o*wN7jt~42j z($f~7o7pRal)-uU!ku1MxLgTW6P#Qmt1tx-{9bWd4d8H;VA|)d4dx-!v7TG%@E>G7 zplUyPG9dL@MPI{E_>|lWb{{&y+od~A&CMTJ@(=X%WLkf8@QC~CY1fU=Nc=~b+Y!HX zD^_)NS(R3^ZS~>Cm``Qg9Tl0hOo+2|U3e+GEF#(g2Bt<`r`ToOMICajAJ1s^lu}V` z8-jMWRjX!ncPS)=DNRa1H{DWjJKZGT#%mwJb87LdG(kZA{&B`f9Na#GtH;+7hi~P~ zhP^dv>nOB6tIav1&{XT2<@RtCuVG!xpAF=whjw5{l?8Pv6$gfjlG4H=g+E20DI+tJ zNd%uCn55m7W!#5TSgal|HDiu-3kN_&S~csY;d{HI^?5d|>EuU2+!A>3!g(kKKc}00 ztWxKil9TZKgH{mmo%*+vUEnt6z{&Ncyz%hz9w2DlMVe&Y)+qr^)$>^fLnt%lnB%fu z%wa0q_^`RhVbn)Y({KV^rIDU(eP%hjoF{xt44&!38I>XXEQaT5v?X$k(SY6{Z6LT> zFO(k~$}hINf4{~njIJZ!N^$>}ulQ3Oaz^^~{jpGlx4L%beb|APu(6LS={ccAhV>KJ z4Q0>DCcW;cMg47)zJeB}m6Se&6fk?YdNieKO|Zym3Z(9(=XbB36`$Wi-cwT9FqjTK zNvy+F;{9^=1l_S_OkBp)B(-`8J~VTBC-JRBrK@4=WcD<>M@dZ4a54JxXAOWS%{jRa zV%$4`0#(uvY8hGxtu)4_{WUjZPPudElb5MCv{Y0l$hW@1Pk+%piqg@0>#xLsT!t}PQtNc#`l;QG$ql6vPEt3mZBDxvg`ld8E%ewj*>M#O0SXIfiRiIEZVut18mK=Q|R#!X;>G>*=GwX*zwpg!VQeG`mi_azx&IrDtxubcWyXj8$hZ(sX*x z2vm7+jV09-znD9lN5E`K)}V#nv=xF@0XFNit*=T1fTi5}v`rgfSw%ZfDo{!rrG4~J z_XSBwa$DP6Ks9H(^yedVrtIhHg?eCTef52*KD{=v<;8{^7v*=b%RvSR?8W*7-8!hE zpdJt^Y~1xzNte6Lh3UCgE--B~b*JmlqhB%D+5jFE<*&{x{V~8kM7Af3cHw!J7-rd4 zB;wsLaaB@*kfKS|n1? zmQ(sKj%S{@RbVZ&*1kuKuIzqKgW&T|FM4iA!=w7tDN<|S214}U6JKB4;&xDn!`u;m zsr!pkpbMUSgJB+dPGV7I-NUhc#nhOq*^`yU+8{QB*D*VLr^PyKG7Y-tYFf zUoMTYxIeISRTQGYv2`3rf{dALXBIH1U#*kQo;#9{yQlrFp;z$!JZ5WS;}!w~Q*Py3Z7{#J08egz_%?^v6#X+=R_8&AR>cOdP>DBC=s^pYv0dgQ6oA*%y= zkAz;M6SSQfrS|T~Sh#8`4Vvr9SlmFC$7)aRh;*{h7yDSe)^FxlQBeW5a!=NXdTRc^ zb?CAu4Jgp;fHWB@{Jw6Ks?-a`I7Dy>gA0NC=#`1-z{9_4xyaa$ndV7MUr(1kc+f$h zI!mx-+qNkh28NG+?@JhM*LPy;K}^U4eYgF^Cd2{tdu^Qm`RUg6y6 zHgf(K$k@tSL6*yg7VXYJ4f2`*j9m4#SpBQ0;$OC8Th*k|_KEY(amF3r&-R}}G}q#6eE;nx{VHdR=lXZJBJL9f5r-RNth&RV^sMcT zp&8gmCJ}z1#Q*C8Q>5UU?;nZ~Sq}Wj9R~v{h%3DLhzUi8S_5K#eZk=peTPdThf4hM z5Wlh%Yup8Ct{^C&k{AUMdz!d} zg$Whd*>V@Zo&cT)@TMRs5|hDc2_d^^+`G-XN6(y5=Y>p++u*nO<+MR(-l;=}4t?GQ zs$lIt2nHxOo<#c5>LSb4cd_z&OQB(Mu?3HWsAa3JvDd<0^(vw6$bOViqU@LyBX^!ysTcp&9hp_2qs zT)Rp?;l6@zJ!mZv-&zXFox&hxfsIW*=kVS`^qj_gA*q0%!4y#+@rQ#~u4 zo32cd8YfYgprUpLkCtV@=QpiBg0bfNsw&w~sJW>*)FE#rwgd^SAL~%B?EN}oG1P^1 zfd93Sq@g1;S;=FiA{3+EyBwV$Yy&KQ)N%Eh1Hfn#GLJ#TX=%y;HLP~}D}WJSE)Hwg z=bM|G6c*-@q(5uFq!RKfX@T;kt0Q!>w9|sbeST?1=e{uOMN5dWO8liJTPX07oJxLv zyi0|2eVNhg}bcYmMJ{K8@l7lU&uRH?dgpJSdQ@IM=>f{3BGj@6A_5`IkkjmC$ zw?QlhjGnFD7_=&8>NS#6F+)h)-MW~|a5=#Q##b3KyDULsMDT z97MA?^ri-p$+t!5aosfgQf*zH^y*@H2``3eD*7NjBC+6%CBNSX5GB*>ZFyh#+&o2% zKTd9(hBZ=-K`H&k>%F^|B2yVSB&vTJXKQsn9}D}+`~^lN79;pXXj8Ph9**ZtztouU zkS$JU`1~2Cu90Vs>#*ud)XaA;JG8SOhO^5friB70SWahT*==XBn;46~vc=O@8XG^_ z`dX>4oVKJPNo7Eqfqdo+9)`t>fLa`f7V%E5Wy;i)@}?^SIan}uto7pl7 z6V-$GN2%D@G_pev2Y!aJ&GYA?a6!zW=1r)*tx{TZ%EVMX?1Vu6TwBFd_!!)|bLR|u znkx-k>wy1sSNq7o6*ZVs!l3b#m6!=M`ohMsu7yxvfe8d)2Yho5lXZVe`qcb9knUsp zT97cdJiK``y1UV^9ow-`RL3sMSVo2&>zK<4BN0nYmb0vb{hKlpv;w&U?-GQ&dj;B? zQnU_uH{G<3b9hOCa>H|ARz;cg23kk%!qX#z2L-C+GX7J zm}UEpw(W!~`%{Aa=D-%71gFUF#gay{&!BNbS)AFxo9w0qm}#>(h*ZLSD^Kp`O%D`H z1l_dK%g1L<1^Sg+gL!X%)jlREsZSl2gP%GP+5pll(o3EcdN=}244@FjgxUaEoBV{} zog5hYVO|ZI6p||uYRSCp!YtpdMMdOXcH$0;7gNH+!|#45)zX_WoLY8LN zWsf3%I)v&#=f4x9q&Tr}=Bd_|1wK4wB{)nN85;|D4}krveB}HxE%#O5NYeP|Xb1EJ zW;Gwn%6zl<9;}RqzMVE~(wAvr=YM+1gr1N?+PVBJ`wBC&&<%~m#+2db>Jt^ic4B5u zS0|)1Gkko4PCkZ)KFG+S=GugS)?}>pwGl9UTCB@BjrJynmHRgsvMlKKP*S38I&tck zoWW~CG2({!{ZH?fh|UeLaA0biVPafI^!G9FMczBLN0M@l^4bS@q&WeNP-$tY2WnOe zyl_>xm6P%K$)30xZW{>c8!}nm1Aa!a=3o)wtEH$q0cOQv<09Wa223(o;7C(I5EHoiCwA%sE|t~bp+Cxr*oW9mR}k)N_|y~ zm#5RQM!S5p1Xa{LLzX|n=WsTDE;`YS!%r3k-qXS!R5kz}+@+zqxsV`-<70d#;}q#r zSswQ;d6;O~v(uG?eWfP=bw+C1eld@ap0Lc%~4k+|}9_tbsZk|p^Na(By2GI!EHUj-{cwk^)Yz*x64bE{P^>Khw1{rql ztQ~mL1IHld%K1sv6>I4yJ^7p@-;bLWz`!Pz!E;22W$ z;lqd8+Am(hZDm&ZRQsArySh}+xn={@?V0*)b6iaz#^}zOr8FHq(md1g>bjhqPVpjO z&wzS9p+tAcni?8S@YPk1=)p{S<}>m*SE%e{sNomAsFh48N*&+MteR@*^U?rem}EHk z3HJ?DErz+WCR~Y5JedgSEUocjT7r#D1t#8(mY|lR9Dy<){1ksBy7&>;S@DSgXWo&us>&PJfe7&h2?veR;XGeSc86lx-Z@~R|Y+!(% zhUU&WE~!M^!1rN2y@Q6u`pG&RnXiRcjUS`ycyh5A=MH&sy{BlweRkgrdS^ zd1l63dK*%6e=pFp%P7(8%Ur{1ul$ulYVOIUd7sRdTmDkyBJEY+;^MN}YOg*(G;ENH z__6UStPg2V^-tjmG=zpo1V7=zS3Q(ku$gusQa`ot;Yfl9{tO;M7WN&#uaKn7H#GGg zSlUJ%IWRmMu>FRKe(RgoN2E}YjjdkcZK>~J_AK*AYocNr7-Vp^$6cNFKvkvn#Qn?g zvD9>^Ge0*gYaZ-@?%0B15*m$$C_}mcC#Oiv;kA*ZAgyU3hE&P2@EAR0L;}%#yCc8$d3Y3Xbz8~z zD^jgh*adXzkWCWl$^ONQa=L+bm#^W~i)#e9k9bJ6CNo~Y~d9D zX`a5a4Iq*WZJ=}`d1yRqAHs5?42DYF)Aub5xJghRrFeRg>0-p zu5Iv^e(1MI#HCoNz^|X47hP2l1_2Y@z4xxWSqtFXI5i*63?k3N_h0?a3v>iXNffx2 z*Z`3+#*R6yX}6qDQd^F9RyEUZ+TTf@wgp&mQfY}!s3nGMiORTmZ!a(V=_+A*UR8z4ah}8A%wW)w zGYkHvTfK&~A1IKn^|bND1B7#2c~1JykE6;gs)Yjmeb@Xx;D=zTwFRK;bd8pn0R0!0uLa6wVngGFkDN#$~F58cyyyJ=@&E$OG;uJNT%Sc zECmh1F>xFAhC^p$?8J;YgUz&Md1d5R>?{!+oAQ5`vKQ|o3Ar}0LG9Lb!#$w zOsx4(T@D%Pl}^P~%?Tf-Gs=0<;Df56@tF!mn2011O2MfSh?-z0m_z1p=T2{P&Bw}0 zjU4lY<6X}$kWV5Bzp)p;D0PaD@Tn9!4Arp#nz@QxwUom<=@tL}ynMISS$kfpC}?R3 z(6!q`fUtf;{1u2k2g3zvXUHiv&YOI^7lM^+NXzq}M2VeL(X@$$!DD)QI`}1xg5EAw zxXwWcvpmv;#lmc?uRM@i{|!icvT!x})IBbT&qG1!s^h84;Z)nfIm5P~H6VfT`nPR?Q#KtYakl|SAD_7#R z-f^D?_=Rwj>NYZxaWhbkk3}eCYH%ltyP@aT*4BQ!o#D_{P+{P{eg*eGVKe~`V6OE1 ztKp^=NCyFN^j=5@N);}j)ze&ps~ON_*W)Gpc*nl}-rmFX1RKMt_ZPUe3hcnEZa))K ziCrM~H8902S=1&%l0=1tFBD08dSKQ?rDUZn06=!B55E-VR(j9A+K$`ID&*E4`_czSqH zPecApb4vQXs!*K?FVpwocd7+4lV(rl1B+7h?kK$XolrY_{I$M!X0q48NzS@ zDC4mJ6p;SYW%2QxM>Vl%`;J0b?^5;z9~6;uyuP(HyIc@1BS2x@HElHytgHm;oKVM( zDUR5^|7#mTk_MjjNbL=WWWdd9WLR?#0swz8B}h;!uQ#KRlp3s4T>xWZPUJw~JtSk1 zi1XOki(v!S*4BefEmK{zM^q;&F#Va4fN*&ff?uv~COm!Fu!#KWnH6EI7EFRP1pa=w z(!BixRblsla%|K@Z+jB*Geu5<;`Qi#eSKR1e5W16A=&BoQ88c_9$4i@tnOPkl~u15 zc7Zo?`p1Dt2Yx;&+h8&KoV@c8O618P$gPsfyBs-NH#!AiD7f)_;IZpL-VV^@Jtl#m zeAxr`#A*w2ERkJ6%TE2oUWmH?Kc!kMJZX;%dsv z86n9Y-q_6jhcNg9obQrAILe_wF8nmKbKPuE5g)wpSOfBqJs}=uJ~l{m508flSPVcw z`=wzI3r`xtB69UW6a{l%k3!f@0NvE8gbV!v&;EgGsJp~No0vb}Nj)w7ly~>^^gs>$ zG~zi~cp+Tyo*cMwNQ-hDIB;`*tRvfL@I~$YUX@2|M~|8IURoZ>wHz(KHgWIH9aZgI zOru`P2#?|ab+11Lcx64ng)^n#R$~YGWy_NQsWP9j90Ays{Y3rNdDhMuxN-|^F}tWP zcSD9cWaRpd5rxg%7dq{|ByQ_q#hZdIRUN&?3@n8cLj{)#J>V&D^vJ%S_Rb3e?3Ny z%sXMh?_l3qGSG`g1&?=RHAQk$pbQ8z?kiN$LMSodiazDOrdRB`JNF#fei3V5 zlFVL4HnRA%7@NQy`qm@4t(>zjafij11xGOimqA!Q%(Z<2QZ_(r5) zEIjPwoO}N`wRs#6*asMo4tzZ1Jy#`s=I*_FJOuF!wG>7b(a7mAB^J4G*Sg#f0ZXS9}2Tt^&*RNg$*dJoFcxKHwYu|jFfQ$OANZC%v>0e6~ zsBNihY$=F`BLC_IY9efOiM?VVV?eIHf!lw08>E%?)kMMh*CI9v%Zhgl|1h?dwL_q{NcBJ#QK^O7b{1{2QmJIuOQY+8ePjJ`9 z8?8V^L%6wTDeA_%J7CL(pe#uY6zwv_A_`-T9Fr8^J3tR=y2!WJu~LtHa!qp*KX>; zGM9OObKY)XzGtdqK}hc^)3L+iY7ptx+-V){b)57u#sRoDOF&FAHkJpaNwWS&o$`|a zeHD+1Rsg%{*fFa9EHVe6?)#~r2x-PJSnB`Wz3&vUtjzEI>q0JWJsFr*n3m#B3`09fjt z1{I-OTwFU)Bs=p06<>PxguKq}=(v$Ju4?c=1$>oUJ@+4dfI9<4)Wk&m0!*J`Cs!GP z3I>{S-b;WRPL=;4;2r%!ieFU-`uH@PSDl>HTfAsk6A=z4HRnss{L@}`Fe3l_e+0M1g?#zYCNP(k+L&Mh|J7>5i|^2`swJmjonB&dZzt=Yt0NiPVM;gg6?Om5?fE-^g(#-&SH<5_k< z>Ae13(g*2rOF+qt6%J(-wFEX9HAfcEn4bJ`2%GzpkTGPh-O5lTvgM;EN#c)v!%YIa zB%d@-23;z20FS5m_;_f3asfgGC#D)GsI@{*7^=P9876G(4YLj5zgnb{^C0-qrX31b z*U9(GXB7TVyOUUr6RGrqJ}`!e_?}yJ-RM!h$v?*kw-N~Br5+cnJbg;?=FSql!=>3T zE+@ey48xKVfhh%`_uN2H{UVtI7A+dP(8KY@y{b7m+zNLyFF1rzRC&aqFLCcthvPc_ z8K&?Y_ZhnE9PNm?yhWFY^U*KX0~)g5_bEnwmlUt%=wi;y1c6G-y1Aocb}sz3Hu}ov z2a4uQo0q(3#4cKw* z$%eulU&w~E(I)@nXeV1;mHdc~P5Di7eN4Q=N7jLA4tJ{K!1&ai1Snm5GFRty@2q}P z@?_8ROz7m=V5(jrK+da9e1tAUX^Y1nCmrFa0x>KB|D{63j%#iM{g7vX8y_qCWc{?H zsY}Yrq|DbB(EXSNeFDojwgRhwe^VZGU6>8eh7ef<+l#J*r~* zC|p-0y^zJAY=}A6=EC+Wc+x_xx<9l_iEgW{@A&*iD^3!5S$_D zMZOAy6ZlL{RR5jZ6X+rT>8!n#25xW@NvgG{Ovc@T@veOut(|mS3{99&%hcf4*^lV{ zKqd=GPkWq!_%_tQrNE60v*Oj8dqCO+Mq8(bJxGIAa|H#n-h_;!!)m7Y@5{qF1uA{4 zLrW)&w1?jqkD)G!hQ1ogqFnL>orBOMzhPS*gi@YJC&J2rfwB5_x+ok7thFi+C#xTL z@6H4?h08S)!m1M<7iddyU)7e|O9c6~PGz7kjIdbA_gbu6gb&aTT=a#eVsNKXTgK(> z)nUTpL$9j~z|X>@Mzz2$drS{beVDaWKa_*e-{Nsx=Wz?4m+;>(%ZX$kEEbbzy{goUEu!w> zLK#2(U}hMbdlF`BXU~o~k#5PUx$I0Sv3o?(hYCOT(%^dB)*X3fh9`k!y*H@8er-Zi z0LGL-nEmC$c#mwHkH^yRpA^to)G}3;mF;qdNM-p*i#f1L36HFWn1YT*pr(Q~OJU7W zTP6>b(5jppE&|dYu){JC7P|r4{%9q?&7^|jdk~CEod_`UaG1eYKAKsc()z73!r81s&~qcn4P;ov`neQU?YEX|<6fK=$4}h#OQN-U;rh?d|Q6 z;6?>{w@vZ1>x=z&$xti%b5=V!%ssmdGLG88eF6Xu8WxI`GYH;oX=$;8{6pwt@*PM- z(5ZlWRnm)*Egy6UKc>UNyngV?NBQV!B|wJqpNbcF!N|*(3ysTnEJHqbb#=96%>z?Y zcXxLHIQ?dx03nHs>9^m0>rDZ?10GZU25R}}L;*EmFT;?!zP^5;>dKcmpId<%|D}-b zd{9UNs%MAo)6sV9*Un`v3XL1|<#IBSFs~~w6S*%$hJ*vb+!J4qOM(m{AfwDc2i2<= z$@2LLn~;#u$&)RRd^F1d{XLknXedmzd)yk%Wjyz&#KGROD1z;~bqU#A=tg!#0q+I_zc9@HikO)VRdZJ^!H0_aN-Pv(wXNR#x(I za{W$wju`0tr}jlyVFHo`XW+CF19d|H@{;EZ1>Rauc0*_coOdzm?^Kdi3#n3LKS7$c zvGI6A!_`x!fbK*_YAGn}q7QJq#q*y(VG-5R3B6u_{R!aAF6uMxKmN+UJH(Xf+AUgw z#CtmJLI4N)7GO>VzO+*L1wKCVP=Z27WyHi0VI-r^CMZ}B#VKJ=zx)1u`*_4Y!I-0w zI1>M*zBG*jBk_&v_k-vK_MB^I?RAjm-P{AC>o}zkSCa=va0+d(UFO_O)}^Ssz%c-FAqWT>fs!@m?*f;{+L^y9V_^jQaJ7y_pNY`V z+Uk>dg*6gN#C<0x!U1=7yaU~BX_V-S=pzx_tAvma(lR!;-sd9ZG0p5M$7hxE{YtwMK* zp|v_k#~tEw4K(?-44WZ10O*h&Fi`~qq=&NXX*b|i!F>JV z<(Bt+_}DoW-1zu71)cX86XDqBLaKL-tByP?2TD90(*8U93<5FA%Ab8l%mSh?8Tg6+ zvi8xye3z$+g<#^WcL4>V~wG zS@7o;{S0go1B2wq$jIDWTT|0xroT8UJ-17#+^PiCiAeBG7lw%Ohr+~%(G3%%rVdNm~opow!QyrQyu3$?-}0je|=xq`(D>c8+-qr z=ULBM_qy+UtfsPV3alt^WdP83N0Rzo4!RyjysxV=NEq93ZaY{Sb^d7HSCL^c-_z0pynMwQ5Cs zcHhe=UIVRLq$D%nM-*9@76*3FW*Gg!kz*ELR^U<(#%bT^=W0t-su90_KCS!IIkaE@ zZw!YILq{VI`0X`f^B3dSqxB68{AmR)h=@e=(^9&?N2vN2A3=DIer(wU49%?X1D4%*nTNmV)7GYg$>q`wZYD;q=tmAq2V8XySaWLLTBy8|sJvAopiKsV*(F5a1 zZcSML1}Ag>&7~}|2Wh`WvLRuOl+xR3eSSPuM{R3ZL{6TmolAD8MHcRr$_{KYVSX<>JBM; z2kk%qq8&C1Uj+U+FWcGYx61j)W&1-%{)_b;<9~kt_*>-5;kPOE+ps}Mla8C?lFi8)6&zE#{Re8ewG1TfLw6H!O+S+Zm$er z_oao@z5;ug3pzQI-9Ov(u?F~@(C{7&2LAoAs0JY*i=9bEvo`d)7JP?B4W~@Ri~*o4vVa^vNBY^I*>K$clJtL zhswGRU^95~0U%aac6M1*t_GyTv=`ec5BK&k8R=|jzdsTbZNR?ex19~o2zmW_ba1dS zQ7xTSHd5GG88v0IlD9P1j|7E89uq#==#uV?HU#BfnUom66KlTIe|PG8R%f>IU#K_0|ByMosBD8lt}>z$8&}WkRgiK4h-n_mcXzf?vRiW zbP&Ev#E#l|!rt+}A81%rOpUg(L!Y#t2Nad315lQZzkyZ!bJ2TrfpRU4i>RmIug<^7G$FI@S3x$d!? z1LHQJtAB?lbZ#2WXWDaS1*u!ItG5LB5nd&byNNirbpl=|IC~t_7VTPfx+VR<@lb2< z^7oGgHk9iSa%aoy3~X-b-~g6ytj+Z?vWqb=QYh-vNN>K4bK%wJ3wW6)-p*ipP%d39 z-MtBGWxbN807?lEgErF1X`>`1{Eudl$jHgvgLY=ft5-}2PLLoCj8jrkv992!O!k)e z`X1t@rlee6Qp0wqlOe&M#(lRaGZ+ z%I$|1qS?@XvM2n;5Moq*B@ITavq(}GP=VyRf$6QDIgB)xy){9;X-}6ls`q;X`CmlQ zyCu-}5VAu#f=wGZr&gD|UjhR?pLsBjmJa8aS2z6nY!G#WP7@R&~w&8CWUh+#3%J%a$)2fQ$vR=`3X9v~0ex4o(fwy4u^X za^hkRaqq*@Z_mG0VfH9ICN8Hh8-V)bW4$)*Vsy?!J@qV%59Il$hT%~+UA*LA{PGxv z&#dpUjScV#GG}$|>~dgaE1aDudDP}X53mHK$Q zi$zEvzavvH)QC-y2^qW>fe17Kw+#E9AZL98)`MF*eMCG(d_K!YW$UP-93ArZ5EI{2 zXirX|dRT(PrP{KX%PDQ*$Qa2fZz=dC^(1$)ZGrjnejz)KR&bi-c=Y6^o15IUXL{kSBx&_DG%a(W&~-{P4Mr z$lO}gJn2&apMX3n9VNO6of#k>XcX9`=I3vq21`fNpFDX2fjJ)?^5Mg2eQ-4AEW-E> z`msP(6E-LDTm24tm5V%K6G7oo{JO=sdZEJ61-GSVSDzn%sfuNfi&GL) zR?Wu}=Ou`+O&_C9fKl=Ss^()<&>1;RuSGXEHm|#2B)6_!eYY{)p>BNW?r1gklF{C( zEK!5xL5o%#<7G3l$tl~q@1N!{;^?hVy0hN`N zaN^e#b#(_Q&RxBFH7Kd}5PG~ewDhC5YyY=g@K^*y-K;0)?)UV9#_N0BO%{9ib%pL= zChWZYSm<4bV@xNsV$umb)wrJBm`o!TXk_Fqm@fpO1_q=i^HJc| z%Bh?WmJ^U)&a zqF3WdZsyfH#xj7IE9BGC)O_PYxje2Dw^EiwdLSO%rhz-MX^X?^Hx8XuIkM_?ZDY-z z>_m%}i_hgkhf7c0*i5>yphb);C*aiSOrS*3^t!pc6}{)nzn<}Z4rjeOj-1;(*9J5y zVJABs=JdI?q~7N~j`ue>9wM;B7y{j=FchNls1Db#O4FutlKR8melh}HwCRr2@uZkV zu`6zEJZgF2+|1CBeA)-YTE4~mxNo-)0yB_Fush?SAUFgt4}cCQ-tJS8kd8gSk#8-@1MAA{AsQ{lS5f!XM>V!R+Jn{OR0&y29xXS@29tEhv0ZPm?k(&*M@E*@BWj#qdcBXT8;tuRYP-*NQ3*4`GGmIUWNJ_<0YLmpCvhNr(||9v=5P$ zSFmWe>Wd14pD{$psEe99kE`d7RAxP#xzc<6iDCV$u(N@Ow%?wneP}{<@rZfW)2Cm| z5_Qbw@1TdcV#*rvLkq=Rwcg#w5E2r8*dSQh_~R2~9EejB7+57FIJke`K78Ku{Z_P0 z+%W4gILvPUc$g2PniFYJ-R&fs{;SJGG7HZSklq=Cz1V7t^3iX$MJ*~F|5W_Nq=@E< z&|f66a+jVfSh`#-hWU%*QrAP*`~qjQAGJ=xNE^$}$KM)gZY%0`@b*IzT;;Vj%D&|yY3$k&@}%* zfG0IM<)tUe101JLU3J!eEEqvoNHA@bQLpyW?KLXGjJzwG|w*ECJwFv?8f}J2v=n%~bsX#a>rMndQrA6kWk~duiMyAfcs(=-dW%AP*H%pblF5U= ztc*!_LzcfH*`CZLF7EfS@qv2MwTdh}6RCFxY|2l){VK(l4i7ad7gWAHo2fwnLSBhn0LQRJ*feGbzPcliMZvSB+Y4_q6a>LCvN}`4r=Fo}WkgXhb z#uV%fAz@E+Ii+33?a@b0M1_ zj1gmUtI+$=xoD>UN~y!&H(6(QeixN)anwtD)73~N$JL~bjlPsU)cq{s-LHe3P7>3^ z_6gfej+^YcU@$J60kd2w(J!;o%8 z-vtK!jr1Q_RUH__2*s!n|DEBEfBN{1pn5z)rsBb8&kKur_hSY}u|(YT^x}ID+1=9{ zah#ofK3?y0QFDCZb>UFc|g3!fwm`Xx`2k6SYcXI!}mBZIS@&W8@WiV^p>{>u$QP>el) zLc0jFun3o-G$-QXyq4Kq9M0Zc*^I976=tI(hoSuw5w^JaK;9OhZtI|Vz;L$l28HJbD7_;WUpmD`N>4?b+k!V zdNl!NZu@t{dBx}yrDfj^i-pC5mdnCq0@rbg-WZ8xs^R%1b`~j(q9KLGS9VJ6A8&Qb zf0XiuZg75o;0n#LQ~pAxJuhG%mU~kcnp*^jd+_Q+@K=L_y8EH;O0l&HKz#EOE3jBG zWH>>@k+yApGOrej-PGblqybPrx9@&D_vw{yi_LGjZn>6 z6l0re`D{RKt&@`zXEPIzXLo$uwBQgGVY*^04{mTBeh2x=I1e8rIniI_KZ;&C)Ah$o=HI_E9x1*|C@ii3${?@85inPeZNYmFl=Wc`8_Tv*5Nd z8iHQz1__Z%jHH;;{a5Qa!H`ADO=40PrZ#e;YLCS+*&}4bWM&r+p+Sp#_p5sw{^9vI zy}xE8Fp%B1uClfunmva({RXLe0pIAG)3H>@9LzmDgbo}{roI&%P}#LX{Cz)! znG<}bo}ru7X^k;8(`yr{b#UETib?vrurYjN=sQE7tRYr$en91$ZX-OEIMM3jCwHO0 z^`b_HBaD#<+oNc*q&Y2in1WXGW+I4_ri{*dWD4S+#OF*tsGR@yrsct>Y9Uc?KW%Bs zdZE2ZUIRZn;m-S~2?BP0Y*`f>%sp!G5$AuX@EITzx8OcZ+c+Mczw?#=)eE zQw*k^dDm;#qGX)S42p3TnP>=!S-3C8^Hd6>THjxZ(!ckAn7Lh$I_!ywaKQOp&P~U> z`b6ft7sHBJmr3L?!=C2ZSe_kd7s~6AT1z2ov=VJPfPS5F;DyT@jwnV3&Na(CyHDK= z_f8FDPyBZ5GbAnz7Om>zSNrUdHd>EU^~A-{x-XRD+FV;%ZcqEUM%A47DVcWN)=J`S zlJHtdB?W%waY$vqc&U5^w&p>~b1-qa07Sn&&jIH3PDg^p3j8lOCkJdd7}NqTY=FFj z-M$PSN^2Mm37Y28ql+8d;BLYUd7l!|`|Ty!o2_YsAb? zp7y-$g4NIOs7h~eSNweBq~PuAbI0hqPFZ*E#Rw$hqmz(khF$gRGUux~Au>b0K9~G# z9?_|oG)=fWSOvO9k-hqv$K50PQyyn53K5GfH0YPfc~tl7q|19W$egaK*mA+Fk+TnJ2DM7wA6Uk0HcuBI+UjuaCSk z75C18*{?I%A2!nfD1Qs+#LJrClxgQ7#M;zs!^>9^8OELb5TlcM9w{Q`cL5oQvXo1a zK{!XUH?Or7L3P>qjLi_#^6`pQfSy0Hjz>Nmcuw`!)9_Z%8SMPXOK~3u#e`#L?iq8- zaHTZqB?K~yyw+&QTnFGDU+b6Z$4KHFT8+s9PDLxUFvs(p0Q1+1-Mi7bxw+LsT>()Y z^63UI6i-WuT39B$H($2k5Xo4ZY>_<9f1dsHbus+5m1q#}N}_-}*Jm>)p9-d58B`$| zjvAeqX%S5B`q1V+DR8s6!Q&=7<5sTwpF&N1uFJ~+8~C-#Rk&%JWyM4cYC}M2=i>nq zyL}`ilsIqt++8}24dua6-0>dwG6QQ8kTbIU*)`E$7VkJs`?bUf)JvK5ik_W|Z^%;E zq#~sMfLp~;^b{?=QdP*66=7QJfd#KdTsq%q_Wi{y&Prm9flQraanQanM)Q^cJ96YC zAFnj6An|0PHa-f^7<5_at38wu@}pO2fcL)}<7DtlFa2f9>|6}A%6RGERv~taae$aD zrun;N)}U?w<|>y24F6IOcbGQ^F$l~?15zGnAT6I4>_b}#Z^fGxr8F1GZoP`G8YmF^jT%e0&y70rVnom-*+oIdVnVONG? z8H)l}M17B!MiwVGGD^bgiz{9V^W#r3?LIUk^5*T^eqLVWxD%qwJys2`+0|f7F3*(Q zX`N4Z7}u;f13^Z&%s@)Ef4^Mh1)hN@9z#-W3AcFxR9Q@axWRG=%oh-`ZXdR`Y2UIC*I`T+EU7eZWlbt*YZ~VbNIc zWY<@V6@H{%K9;DTaAV3`U1_{2*E*qQ+(5yNb?2KEdcIu-D!d`16TIkzMuD&ybaODe z4w##!U@gWg1Pe5Gy19104#@a+fj3G1^XJw_lOVZ)#N%~Mv{q4?3Y)6QcCBE1Za~cL zf!l*)bSh>PQ?Zqu=h7|?WVhHyDjPnmDd}V!82?#Q{=sJNXHD6Le>YH523gj)xa}no zd^~aZ=+Tkk;d^f1i)fRE*K7kHjy+3B#5sRjqug{}e@t>9J_J`1ue1w09(j;_IC~<; zAuNQGcU9-~yKLfHL@u{9u!_Nwh85B(_7~Oj527RfMM+!xg7Mmj$~l@*{JwUox(0B0p_=VfN*rnX5w=ODS5b)QW~hhqmxlQW#k!m6&{QkbibDAV9nyMpEKz7N+Ut(VEFuZ-0d$=zq&tb$#EI}G^o3@BKC*k z;Y|V|QQt)STx(q9xxqP|SwPN1LewSVq_XsnpcYMO_JBv1b)3(2~S0+^Ok#lWN6r!^)v6BaCgT#WDf~P;YcT}w~yqUo? zR0~?iSKZJ^5bKW7{FS*29%b05$h1o>>X3!UtjEXMb2$GpJ2-!^F)fCB-Oli))PSMK zg-~aC1Q?$H+b%FQ>U%Ht7HtZPrwuXB$^m4UP@E{UHFdeAJymXHDT>veDo`yHyv28v z_Zgvue;I+Wh!2ML|*4^r7km>;TGBU_EIF*6~{`Nyqi#s_vJ#}+4 zIX}z_8Hf-EJUgWQqB~BQpY08+?EY2M89i#5jbC~3ch#i^q>SHjo{r}95LHn~zH_9w zuzK-*!A(ZXVOB?%gNqsX(S99wVr!!7!o+S0`-&BCcXOrkvD@IDP^Zp70k!hIEk%op z;|<(x(S0|Elp+!mj9PrT_0*11A0A-Eu|A2uVMJDaKwT+}6zvyDm7rqy-CeH(hOxM; zf0qZW7Dl!1u_}tznMP{mAG7RymHvlnwggoHHtbaEd2 z{x^JSQ<=Gor#3fh>>b6lU>KY9UHwXjr4EBa*dYDkF`t-5T8%`hjOYc{lbom#b}@E9 z#iCurNfpW`_PnOHuX}qXEh!*0A)A5w!=u(+bG>3Sqe>1<6--Mjv6;mBdnlB`_Q6LE zF8Ea6L;}U~*+@$Zi`>ARhFVvhPDEDnb;lQxcRt;D4|d7a5pZ6-1@ybDi|3vNU;25u z6ViA>;{=rT+b#@SjT6G%m=_4A&E<9|M_|G@Xf(d=y=?l$p_t1oOgo=5Pc=1~!Rh=B zv#9*lM0rzL-04Z8(65o0??R2o7wd#`WtPGN?te&Xjhd0W|17a*gl={CMCxGLD9=bK zvyKcEnf1m!Y2#?6#DXA&62d1UGkE%gdySCEOcbceOk2T@9^M1;BapKDdi zxGOQ1%WLu$qQl|1?{$1S%_n@@u<6zxC*JZQ0)MPttQK@se*c5VbJuP^dNdixd<*<( zdZ*ByO`^0J9>err${X<=;*q)ygG z9mrkna%8hzzN^Rqh@o`KBxbXdUOXdGM98P4Us{Os4Xg)#Q9BwMkjD6K(yt^IKHfBR z{~VSd?Iu>~%GzX0B~HzTNIN;h3Ynp=)S>0f_AZ+E<}SB&b9G)z3Y12Ipbu|2s?i)$ zK71Yz3Er~K&EII?gWk>oUq5^kt9 zbUnlg5i?y%9;BN{ly%#*XSBG;(t5LL#3#k7ei-fATZr=E;#HW{QR#yBNu~YZRB{!w z)KQ$>!i`i9*lFUp_5=e*yQAcrPo7Xp_)VrR^7x8`oKp42_nVKdqyqN`MRZHUW zr81_;wj`IKkv3z##&auxBD~?CsY!_dzmO5=Q<2zSa={!<{fe-0Hc^a#t3c(qwD;DW z8SZbXT0@b8vmyy)gIOjxspRu8Cdr~`gh6WSQ)hltNKi&CHi%7)Dycty!~Xp&a;A8q zrRnWC30n=MOC69ZwtEEIAKVp&paRhi5dt||k7+C&(t6{A7bQ057*vT@*zuWV+8Ctp zm^T^y=K4uk?f)0>GrlN3uYNANmNrT~0ssHHM8+a`cEck37q&j< zRjuEfMJM|_Mr4aqn!nqrc>nA${4{|5p$ouc+?{$;Tj%a_Ngx>^0y+&0RNI!tJMPgP z3!-7nHvrBLm_ySqIJNTdON;O7xYO;Qk9@ZJvY=bymtl*K(&>|UPwOqQ{#IvUPh{mT z^C6X|!&>p-BSSR})SMS!-V-<%{hQ^%_m2MioFKd#QQ1kSRI2~zm;HrZ)z(f44@@H6 z8E){$&-F(a?pF)~;u!3|9i~M1f9Zg0WydS<|7k<8qfKxYKLg^Y+;&Ubhab&T3{!)F z3Aoj8YsJ@X6qJQOCjEn1Pm*-Md_>KWvTS z+HMy9(Y2QT8-cj=p|4bq&}f4u%z!Z=4vbH(Uc1)sv{=VzBa?1W=gxmzM)kru;~o^= zhW5$wL{Bcyk)P+3QxzQL*QBdcSO|V*SzsQO1`Wi{u^%NVbyA)3(Gw@ue{cY(QJscS z^PxdHw+VjCDRQJHIx4VOX8!f-OvZhv$5@Bz`1+lOyjZpE2A`iLAQ1QnLV+Qvg?gbm zr@ioq2M#};?a6)jt8&BFzUHUEDQBUKLRLET!YB*DWtp{=ZnN^&_W_C2RD?c$F?Yx% zqhmi;8UJVqWOl<}x0iI{%2vx2zkKjTSBjU=a^d7O1zHJEt@cE+C#$CFHAahrxYfql zllG+hQqwIi4$Yk3Cd0-p8v+$gq>WnvrM8#=%~h9yuSv#ktI2bR7ZeOgcVXoMJiWY9 zBc=ucs^M_Y06#*E@B^@HS()hu!z+DTG0~R1qK#Q0`>UW9t07Y+ATU1!>;U{$A}IEU z_A0)r$3Ma#H&-0+EAgHv6anTI7HV0>Y9+BDAfV7Y%_%+@$CEQjs5&od z&Z;f6D9DQ3^@VGtE8|g;e*xTJ|Z=cFxpc&n589m-RZrd}w@aV-CrsV%lF+*s}tPx}m$Osv&E{mkJ!% zh(dS_{ig-2CxfQJ|Hc2!q_AZI{aThux36Qn9NRZb`o^9ap$SF)s+=^SEWE<1;j7|$bXIf$y!1%q8eaS^|uGd z?5^$M4g{@lD4O$$6aTYJ(vcg4IPlsG79Dy{rG40u!gA!=-6n|(-)Y0S1ccWTv^&$G zOVatuq&TXfxs-DkR#t3NQS`B`tyy=L$rBw80H6Vk%-A3wnq)lyTFVqwf50bXFPU^H zidxSPiRUid;wn6y{hAO*V^;7!y8*g1Zp37fVu-%*gzO_IKBG4274V3WSb6XfZ9lFo z+pePHtaOqPIlS4j9Sl!*@7qHSR^xvL_Rju1t<6qrqrn#j#GKGyn%2Nv7wp7Umtf>o zky(FH^my)gWP<$1>S%EvKu_CK?@2Z;j)j@IKYMnRL%pS@#%QGSC5Y`L_?O6temnmGi?DI`*TK7S&QgXBwgD0t362(}8Aj z*pWu?@h5?>GogTVW6Eljrlw|@@=#8iq;WJAiiR$J za8NpG6C4?@3Qxft3)mshv1!f7FxDTtR@|SU!ex;N?BWo6EqP*)h>%d!h-9a1d#Su4FMza>HX4k(Qh#3%Q%j}1b%@*9-!ipoGt;&Oz5M+ z92<|WB#aIVR4aOmFpy}bjj619$h!-kY+R%Rp5*;zz92Nt)io-c6E7VvPKCBUPuf8fZH6p_#GYC0v6Yok$Cvl2 zx0f;=Hjizt_Jgm91>g#03UD9z4Z6d_BNu}H8%(*=glC0!s(Pk+n-+{4FsQap`(uH6@yY29*yR%A$eWt$6_>_wnwwh= zTjh>_>{c9E))p2o)jlg1o9R)AFB3C3ojmr2Q|p{yCX4%il}=KPIVXLM=axADoa1+Z zFc|pHAEe?u3Wv)$dN)S>+NE%h*ajDf^5w>0r+&1?5~a>`QPMy=ZUb5ul*A{*Tng6O znXQWvvpoX#8W>>DL#vhRTYrwlFa#qQ4Ss#8qP+b0jN;tw+!SZ%DGu%S+GF7_3O*0O zn5+tGFAoh|C{GI^)3XPj8|b!%1eKu`2==UlIIwD}b}9QnnX)H|$V;JflN@>{Dv{8w zsR=sUyh09zIY8nG_bhpce*vDw-`p4KOmZ@83&>2txNWwFmt3l3ZbaW~kI-I(m9jyOT*J)PXwcI_t&S;&=_0^$Rk{4>(E<`5|v_{ zaEBO!cj&USsSV+7j+4b}=2q^*ZuulJ{=Tg<*vb-`bb7h4ds!qxl4=V`(H}{Cnl{

P=q$iXs15x=VNkOVi$<%0y^DH9!*T|=XV7i)RoA^}67 zu<$kDDjf^fO#SWsHIKWc?v!WcM<8QT%BS>P15tTY6}yh+=tv*Hno9F63w?t3X8ALw_Y#i3Ld=yEl71Yx$}e9rw+%8+|M_p2n*{=|9*8u&8Ryo z$%)@;OnUzO>C;rEMq>s{t2ox%6V;gB+`D(L ze8F+9&=C53e4!U>FxXeJqU1H;BScXHDT5L*2A=pEv-P(B`QFgM+CS!xGE`!TpYmr1NV`BU#=WpOYahEF@Od6j|~gNBJ1m ziS6M%f)eVJHQAyNT}|`5<4P!|K)O9-V@Hkk=4vt7!1WRS0V;Ow0#z5Gyd&DCeFdEl zip2n4Ut69VZ-`Pka>aV`EMJhV*v7^N8zMk+0V1&v77{s_ZE{Vx734K=pSZkQgE#;h zYGwq3A%7NZ*jC~Tw7yUGv#NWjB3%kqR~8pvC0K)_^@HM+Ojra%Sc&JA8}Et0A)plE zSB<0R?cEp_-j|sTZ!gu9my1g$0g4p#P*rdyW&DtpbKYX(zUFFsui(aVV8bvV3*+9QYYu;uC(hkUOczJYy!ad(t@!{jgs<;J#fdGJu`*GklNd)&| z3RUWFkO#u-NiXlRTE%?lxx&@5bl@8MdV0RlF=bo@uJNV2mnG0}?k+s)eh>!?G)SQB zuM_V5S)gq{chwUpE{&{2*d<^_3R2{k2>Co%NU779YPJ;W&EftF^~Oyfyj1bd_xn5H za$e>wFdux1$^Q=N&jMs!&=+KMXKl-c4FQeU>j=0UqLl#p`=oxt1S676nE^ zkWgvdxZzprMN;v`mJqpqS>3JCXV6cuQLqf6kTx`!j;C7#nzgr9oe((~dE3}@=(F)b z7$9{C|$K>M*q!=nJqp&;L-%_(^>I)ecF1|LQgy)W7BGuN` zhNSPu0@bWcXFq7XdZ@^t?ya6$!I1O~9?96Gj~i-x32~6d>CbY;Mw?F!4l?2lOTi*z zzFIoHl%$^PvWpqC0jLau))E3U}8Z zox|yU`10^;ldDdjI>##xF0K^B=9CUxMwFYlwFU$TwiyLsZbtbv1_lP}G&_*Uz@X$x zD?gB004k|e3}oMvbXU#PxCT@hZWx_E zz!Dz9Uj}+pC5065jSEG#2VJ51I)~TaH(!ev5m9-5?$onMcxegwqLG-3A1ZjTWbz6_ z+29)#7#Ilmg$e}?=oXjbqFnM|GPxibJfaL$G-v|!jnA58UlJ?;F39nfF#0e`Is7vn zf?wB8;#D8Z`(uc`$%! zn<@=McbNaW$kWx2j*i9`^rwliAksk?b=N|sHBkHnQX$~O!O2%OHlEHV@V^06j6SBRG%#`-g05}Pd)~H#-U5|AZUd#^JaBr>6E``# z{Q8!gr~j@-;MXV?)2|L?MCJA0Bff_9>u&aF8<@k z>?Lw(G{xCN&zduq$E6}Hp}?5?&@X;|r^K0J*Qm1|+v5ZOgB!918qyfc6zdQWA|HS@ z#Tlx#+fFKCW*7f348tDqufM4ZkR@ZgF?%RbHNJRG7Zfo9{OJ!LK79G|B{*U~>Mz=a zY6yB$uj3#IKbEWqH8Q-6gwGxCng_s(e)q=eoR5pf#?uphR`<3LT>JpQt7+DZf3uZN z4)Aq^yCREsxiAkSp>7p76iCQ~L^V_ef0p_|@yD`!{zngNqo{Fyr zZX5%C5jwi+iu^Bj^{6Pi5+c6lYTc|N-nV?47!$p@y!!mhmoHGTg&_=t9#7nfzU~FT zui67HWJsT(Rf~XN*cRie6VaLQ9qNudcV6UGaPD%caO||ayZa|N{6h1~(Z4**u#W}y zp~W_wzGC(;Oj*nLI++0p|Jd`+%tw2Wi!x>jBSSo*bTs)E?^}mg!X8$LYefiVKI|`Q zg>10}M|XEJqj7L>^L3W~RAB18e&y9Ow~d*VwbNIu^t&BbWqt63RfE0oQS4W*0Qlb&SyxV~EL24s%r8bZU+zkqDsIb)dUNX2Cls20X0|w4Ij-q#GZAtp|xM zt#`od24LELQcZPIRh8^iPQoUF)sdyz5@eK$_LD%W*Bf=&)K*#vx0!nO+p_)A?ov02 z>xU@5`elLD_d5U-KrYxB*$i-k&n6hA-|5ZOuQ}EzfWTrBB}1KGvD|(mtcTBHTcJ9E zSpIf11k9?AY$N&%LEGn+z!=J30@hQ+gt)bXj(|9|@XdR8tfr{(R5mGU)1kyxHE%?T zYAr5x&vA%c2g5Yrx48@s(XXLE<%qyp!fMw#*=g^^Ox9}mmdQPRdM@6vmJFS~u?vxo zovne!Z5bB8vY1)8YL7&~sR1seqmE9$O~6EBjEBRe7(xV4SMx+;VUE#uXQ7yw`Nv!9 z286!Ys}d?V^_n*zz)WTh=DE+2iA35r#S(f0Hp>$3Ma+&TjZo^;vQ zC)=K+;apKqDM6NMUqb~?nOzfoQ%r0QWXqFuOFe770Y#&tioF7lAI#zQj$0&{2!og4 z2GT8x-y%A15$wmJt>BQVIf-xebuTB2o%x}z>wr)C`;~hPg~(l^NNr7tLmaLVn^x6^ zPJdZ~V5+eGKXHr zuT_)vz(F}20R-#7(87*Is#~#MS&xYmo4Uu)JwJNIStp1rll35Xz^&G!D_8FuaIO57taY#v9Oi;dih)01)}H)6 z&CAk~0maJ7N=C!W&duF8p%w0AxWM!x8=u?-QU=G6qpiQ5tIM4oGHw0&Yr4 z$@6A3yY|mR;HCZ*cu!NY|8=^w-NACJt2jXtwz2Hk+TOm=HuDO8y4J$z<4yrv?GH$V z01(C4R93R}K$6UBuB!@4){zC38iNOWFx3mSYQugI+-A1f+|vN6w6)8VPSHJXpH&+A z9KcePFe?lUo(auVOM?;@aU8^GNZQqlob00{pSin7@>_gGm5IYlJD@p=!aO6U3l}ah zF^5iu~z^b|iKg1G}K0AB%w%^+Y| zhUx*=B{0=rsSV|k%4iVZ3kerHV+mmgSgC>A+~v!~@Q>$9k3#o*5el!^0d>_l^TB)&o7V=OU$D4HfALfP%Ztw6 zsHv!eA2#>nfQ*dj-%v`No7J{Mql%;q`azm=kZQGZMWYFe*^h?q!t3JVVz_15454;P z1w&fMsx|Kul;YPV+ylVYwcES^{`mR&O5eU+en?@T_>C;izrObIic6z(%27aTI4qm? zrOv!bx;0V?3Inc!->xr#(j7Bg#pH8r`I9oooh5L6_yW#mAXx#?3{a(@Aq1lfl!Sw7 zerK2*Bxt!^*ah@EMn;KUF3Wu-3v8)CzD^}z}BS>M5PBC!|E8f zC0y(P2t^)Gt=#NfYj8{FlMi^?cOC?EuuMU_MY!JfF#+0w z=XtsTuz|Nzgu^-(TAfCI4q1(WwA{GTx4*w%r>|~qeB5xz9aJS#E_Z(DEx*v=i^zQm z#F&f%BL`a)Tcr@b6I$HfuEGh!d_%MC30}ng$6fu@wclS|QL%+BrQirPwH<)-qq~_| zSlT|xF)2*A07i((TTF4`ce0bvyY5dyX-qRXOA|MAOrxojLjL+($9 z-e)lcbV?6^z+0hL1!@f#d~x>z5rL}$W3w|{+Aw8BIazZJKiI;@=a#H&#UX-`hCf`_ ziN4O856vq!u8qaAK_Z#rsuTVa_9k+nnys3|2X^L%4gb}&@-1${`8x2L8)>*gkv+{L z5_0v-RZG*qN$1&^6mCiwg;By8)GFq>DI-GojyY|NPFgk)FQ+CAX+A?M$ciR25rP-*RMt-F2TVij=7I0WrHkE1P`*Lan`h@S&=5J;e$%tA>k2zs6+j zJrh02{*`KDo9Y1#gYDOwNIJGB(?v(K{Fc#$_OyLDpm;>vDRmiQMXrs-OGya+g#RV@ z7j^s!{;|imwBJHqG11>dYx6G0G~Nd>b&DstTU{;s$Iq~WO5sm+rOq^@+rK|C3V_eI z;er{p-I$AAINo`0uz_BJ9|VwC&W|?}^v|oye;U61t#&aN*7-%`dA+jkF@y@Foj)T- zaq1Rf1YJl;;L33gcwxsOKM=_ai1KA1K>vgVP&!+&$i-|AfiBSUnje76Nsl4se=l~6 z>dAkB5(I1e@v*gJE{TA^_&B&c+-4gDfM^2`hjQ83vYGTI`@Zb66R z2PinyMgJs0jKoV2`_v#!v0B?T@Dql(Tm-xpdaYE-Pp z;X{ZULSgr2anC=#%`GE@Py;x^#b0I~WWRJpK5X6_BT4q9!d1s;q%B^(u)gFP&2=6G z?oF~;&Q1R-qyePSKd^<;hdT>%-Ada$s>59`cg> zMC4K^GNN0oOonDUGYeg)}@Nga)?V~XhbZo-nd>S zw7Fim-lD*a*{pGfQn&e)a)Ov4?$)(Ay^qijDs;^L^cV&06HpT!xq*P%MNc1@$qi6=!aCJ%grs3L|wLysr>Ve=B| zzn6CFK(n?==NtFi5E#- z&wD|ddYh4<&p+z*WHBI516VROTM6ED;PIQ;8?(>G{!huVnM;LWSh^VkA~|?H-p>uzDy0W&mtwRiO1NC49U3H9}1G zp^~A)g>lh=_B@-9A3xeVINfH+h_J1WUcw7vknSk^--x+?m;6obhL+ryK!y!+SsI2 zaxDeD{J?cE+#?{+_;!9EV8g;M$COJ$^qQz9pcwOavc)9WW?$Rh<5Cwc#{?-#e22E< z=78H3htD%rQAHGvK5GV%(*aN?-!iBH{d z#Qfg3vMW#Hu~2_(PdC>Kwl*rvkxlhngT#(ZmBb%H>fo^qxi zgkgXUP4<>RyjpJbi{vk4ylDn7SJT#0fP4NV4|M;*g0DVYF4~#+-gbcjF=}jznebQU z%WB8iW0r*lH7S|>z=TDp7mfIG3=tr)b@B=>Ow(dkbf-+C<|HJphFS$BHkEH zrWF6BNo$xJOnX#u9#pn#=Rv;0f7GaGMcpwbt99pN!LAW-f3@wOVSV!&ZhW%I7^4V& z?hnAbq!r0hlYS2)r#%^&nHhfDdOXnN=Q&J6GqvamJ?GjmKCVlbC|L=9m6sK6col_n zFVBdbEq`cow{^~#1r&thDE?ff6?nkb6TjhVt{c|* zpHXkQ#;H?qv^`D#UTPXtoRBTT_WkraAhuUf?sFhgweF_^Mo49D4crs}-}5Zovsan= zQatj<9Vi9jDb&}4x343-j+Bc<3d{TEs%Ku_dRB#vkNkv%F*q|ecd$-7&OHt7e(%?> zUHil1Tc;*|$+0)OMyaqqmvHG*Mlo5-ZS8_dEWB0o$ElQ@R@Qc>q5y{hS-jTG9@aPQ z;1Lp5iRqi5Z;@;lw18d(P>h;u5;8iz+`lP1YDAV1&trIDoPS`vi`mP^XK{5EY}h}m zr5gb7gv4!{iST$1jh_rOnQ=Sv7c?4tY8z`=;E2ShwjjLd%cyYn25&5$2Ye?`H8vch zsAU?-x&~3uWrqei6^CEKo1n0TsSaYr3|($@nT^RwCnjcyC6|Lkz~O^{aeSavH@aqJ z6Eagt#U7rBZ6E{%pd-`rr_k=V*r~nXmj{M%l^#TU3*<5%=`XhPjc1%N4cy={#coHA zk%-mfq2s=!@(F^sSkprZ#o9UdFb`Ah-o0BfNnOeLnpiYi!1M1C<3DDceB`KR%jTtB z*n$UV+XL+Ej)n>t6)1Ssb*fBhBz)IObSgf?Yt~mQ9vS6!BP)|k>MyVy{$)1M{6Cba z0)y~wf16#PQU*chI;!-&y@MwV%JRPUp-*^BQE$99B1eDf2n|?5*_)R(0X8cu=a#}XXlW{#A7`&OO5(waSO^>Q4xNZosa zzkE{!GS8sOARr)x%FFK!=+a@r@#ygI@Z4OAZH*|wuVSC}(63^@;{ueACkPSsH)LcY z`OLHdS2_24VMt2$dw2`=^yHS4Q+RmstpIq*J@wi9`_KD3P~rEI_x}JSxTk|4Yn{hB zBz*UVe8l#vSbmMp2|NNq`V(XrC;uCeVXG1RKVU8Yw_pGN9?Nk(1}ryk@3+!1oiav^ z(Q5#7*qiM7g$@w3{K{VlGCaLcY@DCk~i9gY62m~O}F zABgX$Q=zH%p&w?om4z38$#($#-Ld-^&HNmEj+y&6+w~VaWGA*|N^}n#^Ex%5YAdwG z)dE3&9asleGef5WPMsd7`?sqtMh_rN-7&anuz4G|+LI&X6%=x9^l!m1w4p#w%{$Bt`jaa)wa8kg)MgJRaeJbTGIvLwj;MvsFbc%^d$a-=K*C9mly^#8eZNEfmStCM}j!$lgMdB1>dD zl#xnO*%DGok~OkrIaFjPYj(2lJI8U3b3c!kso%_8*Id`*z8{a8gp14r1fHUOCZW%lbM^F2dgAQfFe9fKe;A=eHQ&nwRiuDWxC6)Ttr$k2O4av z8yd&S8_~^7+1iGwO?ayDMAyt8hn1AjG~HDR2L-7C1UyG4r%3q3tX>`7gvg>uEKZ^{ z{L9akJ=t?Xzpk;N;Y~8=@j@(YJTfQiF}m^Zu&TMv#8O%K=bsC-aw;msw{NHGp&)Vq zuec8U_9}ftA_A3Bsm2#T!|+^GMkXDyC^&+YOJHnr+D=kVu1Qyj&g2y~GBUE5J3}wI zxrCf%hJP|>IrLOiSPn}4DKd!_vuYdJcFU*wXBuj+7n3}iugwv91{7Kn1R05XD!2G; z!^4II{G@mAcsuLMOPtDL;e(;!)FA`{O0u!BUE$C8oeN#&0l*#!2?Y z&3Qw!PcB@9*xh&}%(#bpBj+nkIu5*@<}18!Qcx*sV6I~)-Dj9RIF3=9SYx{HPQ$z` zJh4@IajJ(8Kkz!Re*Jo~Cm{TC&Xp^@k6)gnLKmq%+?L(`;*E>Jd0&r57?kRP08{0t zq2ZUDjIn=0ah2HF+@-3js)!hafE&3N(cwmh&N#UiTI49J1bT>CcI5&vTs$0Q8diITCmBWs^b>SSq?jjY%M&h;m<8n*ZZ-EcA zy(0~c_#53R^`}IVZ1kBZqp{U1M5z-CEkCi5hAc&<#9I(+8(_s&!CT=8G#+tQ=d$$bp(pm6|683tS;V-P06)y%aB zpwZbHc`3{Go7x0KL&Fun;{tQm>TkS^%}w;{;x~G`%TRP$tfe`8vlWOb2Ua(~ z9y{wD`J6)5>nic`-O_d}EvfW|=aI@x!$y^0o-0>`juSJR%bq$Jwnp{;p>^@Y&91~* zN}oXnz&OLQL*4?98aymi@33rF`GCiKlwdzN)5=n{p$~>Ax-6vVT94N&JA`B?RoSi~ zLIzD324CQfp?F8ZX3_?3`?M z=RI7AW|No95BAP67R+si6}}PixG|F0eCo{EvptvYN5A|`X?jIk_jL}W-|e)Gl_YM? zZ*Qm0EthU!dAO)VFGTmP*uF_zy<65!a-W4v4vXbW02n$d&E?GNc zSNUwCVsbKq>{qJFTud(*i1NnA>aOhhL|vGnJ*r9^=YwvRK9VhY|6W;QgUA$h zSON584&g_y<`GOMHwfjb_$05`bT}RR_DbJs*z#)^q?6(5b>!GySLRvd7xZ6%ry0PSzaB%`k9s|3x>*C?*}@s(^O^Jmh_ZESpAjZ z(Xuu*13@?oX$49Y7kkE}EhdfGuF!jHo!{69cNPh<=jqd@;eiA8Z^4!n7aEimF)=ag zq;0mRZkf1A2$+Tsq7nOa){6}Gl`A(2VJG=l!GrulDz_+SJ`ZRH)_H-iIui3%RM^0}AZ46mBX^_+j*l~?lQlyeQit}puj z;9$oc&Du1P!vxOapdB`<{apy_y*KUZo|H#vc3$FCyEL)rL74anl@NQrBs}l?R?QC% z)Simgu2Rp6Qts5)p1Rug@k4>K-rS?cj(nx$c2)J)EeDZCxGqJ!+OoJMArkBXVm_^bw|7tv)qQ5AOiy~k3>w1u6l zF&)9IT-8&z_<3L=Gut8HF2t>sIDFPCkHDC8RN@6~)2QHTn4_ zB|#vhO?QF53+{GE^9?wOd*jwh12wM7f?M^(L;3}SMTuP-TX1Jy zsa);R#%3lF@Q90diRuJ~7u^ z=ww_L7PBF;B4eO>OGCzx{SmjmwTL{Z)7D_7K>LlkSasXiF)SgRZKYD~ORd^NShkyyn;2+*w@mERK(&=CX|leX=sMiN zTl8R>wm&n1ci1%YEOdnSBVAi;v~ayQSLmG{lsBz zWw(_C3YP6`@i)3qJszVGecN9%hlr{-#kF}93;NTP4XKM(Am-8Rb#vM*x+sc#HRgiB zNGrG9nl#A*U58noPv+}))C{F|1S68323eWq6`_qx+B@SpfDd%6J^>eIFL}%zd#&Fh zUoKFGPe7pW!>yGcy?AS$Q62Up_!FlEo{*u})Yt;mg9jHaUOX}~@~LCRs#U1o*2iSb z9Sfv?I~H8`g}~EgsrXkT2V3$f&S9DzwHt;ys^NqADVLw%?%a4lCbrJtYHI-GPBe?2 zCl-!rSVYr%5-cjp9}ZO~U79(X|6o(BF17ZQuTH=%Ho4E+et%MuG{D=K5^#CA%+Em8 zS!4hdxs!<(It@68Oz;8 z&oY~OElVLOrtfeN?b@Hd<9rM4IOSaJ4DJd&y~5{VL*AYwa`nBOyWEY!Iu4}P-Oe=a z^7Ao`mUP|ma76q09bm!KJaRE0cG(S%cN%&53Lipo)^O76+F3oGFZK2zQuomiA zgvuPhKMBS9y2&Np_wKd$dpNG*mUAS1$?<@6rn{{T$^b@TBK>JTbyho*_jiuC#v;;F zms_5mVaWlAffK_G;~mFL zWPG`?AZpxsE{L5gY8f8ZEc6wKoG>hZu4&k6ZsU9bPc->i{?{kUEIREl#$Q-e`z8a+ zStj_cVyC>9_8)=jTdqFFqeV2IOJ^~cot?T5yR2+uXy(bN$*XvA@aB0Ho&qg>OId5Q zU;PA?Yh0IBJ37%jt-W%Xi#tNb)_$OLDlda?T+NmK_X-_U}27@U;28 zZPT*V^EnP^X3i&2y}Lj1I&;g~zabLoOPUA4g98K9oYe+9N7-MXW+D&>ix)3`^s=(D z5`-RRCMJvN4nRsQ)PFriTXwGsq^k{tao z*=(+tN=`_M8QD6jfuhM<=j!+;4nWb>`kCX$4186)q}D{8w-jNP71eqYeH@R&=GmYr zG589`z+-D>L?Biixm%RDy2a4(`NhTvw~eO7-310&A)&T~1eCBaZI0woRDB!r__6TT z_I*$Gq@}Eo2OVFR`d8IG3Bz)i`Ey)@Ebh*EvojL1G)J!(y%0`$!qq}QW$c7%=ggyt z#=1KZblo{%%UApM%<_;TS?!Q5&Wto@Q>sEq&$@btuewI|)b3J?HvPJlGpW^t?%`@@n)LV=-jSr3lOMv}JYK-n_Igm}lXCI~h)fOOCI!VH;Ao}Q*R9QRc(4Yn-&t22V1?vKt0e@@7)9^v@}PYkH93^vr( z*Xx8=R7Gid-yz~Hp{3m4E0yI#MZGS2v;Wb9|9myG>=QXx4*5zqYuwn~5u zk@Ycubb%fODg#q%=MnhQV78{ZVc-VgiX;u|{--_ZQ+f>o1G+Ze%c~U4YYJr)t*6_p z!magx7hLG9Z*iZO`>yfCcv2bu97g96>C1COpo~RyKp_9_d_tk*INdEdykej!qyDsr z7}g-1T8BqQ)M$V{HPpiv08ZJZTL zmxtYE7eJcoy6IyZJG|EJ*t%nfZ=|sN!uz_`ng7-$x0D&rW0ZeCH|LHf1FSDy?5{N{rgsfw8~h6kiE6$_aAW| z-U}fr8mf1R9v(8c?>X|)fBCPPE!M9@l3$9$`lkBDwNl{^9}Z5e5_M|0x861S2bF6G zSr<2cXCaWn9*aU;dSt1pQ@+E-d;Urmt5W1c>QcKFe$Ezx9m9Fb4){nWAz4x%pap| z^c75ZW@VMelU}NyxJWQpr?7sV*CdBFb)wFpY@GGqSf3Xj9kfDqP~}LoySogSba!YU zu&Bhv#4hf-1>$RGYwOd&=c^4T*1`%LNE6a@`6caZO8Y0)?7Vym5blJI;6e(#8{;<) zFjIpXKK4W|>?ynrnM`qhMvp;wMIr>qoiJ4DXm5Y+yb?O(lPK8*gPeXKg;skGSYA8+ z??=k!Qvj{Mq6rHqIYU`r^@nM_mv|UyXfoSBDr?x3%PKo}l?2A20F_xCxWhsByUB;Vu&6^?_vF}hT{+@d&u zO%SQrmp#$1*q|@(%dNLyJ|Vzt_DVs!6Qxt-83NkYc>Z4jjKTKe=Zc1r1aD)*x@b|} zl!7aL*XvgP$D@BBLudsfT&9vZB?mX{puP9vG89XF7-FE@Q$(b#dzA=ODi~tk?fR6B zO%1t17l*Mc%f|pE?Jygkh#sjtK2YFKn>jQjl2JJ|=s*xWtvFC8_xSPP)2H({bY&ub zxfu&CN{9I5JTs;9ah3VtA9VmFZ)*R41WHOzV8XF)?_LU(3ISWmW7$H5$1GwGSa1OR z^8xnjML3X=DAhu&IZfN>wSbkI^UV4df9FKMn?14e_dEz$=4Ja>xCF;toV&~9#H@f7 zBc%{kY_#TSvn5OH8{WSk$on*)?Qt~m*{Uia)+4%^S7KKld$!WE757UBKqX( zy?3uzTfZTk)z*HrT_sRL2&*2RSF9yr&a_#wN5E1NJPOuWy2CHXgppYH36+PE%{~ps z7FO^rHJ#V(PO%wy6c`A~Oq&q_IdbcES>Fr5T%n)L54O5mp%?kiRx;9J!-+$cJ!+aYV$0S-df0zlJ1b7xv7cj9Z z)2?u#muz);ZK^f+XmGs^yJV>Sp-)WQrhnV&)yB3{mW+&7#{-TUtKyE88pRBpVP1d&6G0?sHGBjvbP;ZK5rEuBt&? z$N72q-H?3kRcGhtJNQ2(HxmSyRDyS@6Gxz+DMv6sZ_ssz{WQsD$|bS?8x#{K(Wvb8 zf1kFze*JnpDNp0X#d)(|Y+L5Yv1xivy}_p(t!z%6dJmK=Y3O8PUtkr$VogTcKVXz5 z_iez`)whordON{Vmux=JuS@Qw5%SZ6H*=YkWjVLK2*caEAHX5Bwvgj_V`1c%;Z`bI zJ)1#tJK9C&R8mBHHK5f(aUPP*BjBOdV6RrN~5i0f5hPcUUPvK|jIZ z(=+oa8>6Le!D6I+aIooxG8Z)$7#TFdn>KCgSfvXo;5#O`OW$25{iwmmem}9uk=zp= zf7|hoil*DQZr%4om`-6Y5a~q6$wsHF(z(+1!vD73JbIIJA!UZmaf`fxpYyiDmgQ83 zDTVx^BCWGi9|)Od)Oi8$V)wZ14gpWNHVN0>bE?O(p&=mf0iUin9CtO6eNV*bKD8S=fX2S)qc|;^HdF=7 z(f4j~fOr?&AJS2FVD5-4NoaVZ=|jpscoK}R!=U#KJK#;XEyrKv6(aWzsc3n3Z3Y|G zaBy&7Di*qWm?gtu3Rux>Pk2aWA<~a080hwromz#Bur~gym9+h<#k2LY$cnvQAM!<# zYXQZyy2O8tLGxPAwN>gBU1}anHw*yj*>u?F;m#5E#9^S2#|A8BB=ZX=LPSoix7fXV zon39TjyoFYvE^UkN2j0RN6DIfuFHhAWuh_lfC$WQ)5Ls2Uu4|T;AlqYG@EDu5Zum} z6Y}jR9L!FK*S*0OD}VV);$c+(SpAUFF-D@&I_aby3 zAEj^BeY%R_ce;v!p+Pp6k=7bQo0&4;rJZ?gpL(iw6;+x9JkcaBogfoctw$m3FS0c? zI#>14N`2-wTUTD;=M1$v1ICldggr>xX?C>wGvCD^EuaZ*NRc&BJ$ljF>>{zZof~(Z zzPu3U?}Q}j(ztQm*y7oh(=YN}T#D_YJ)?&rJD6YRaFD{guv!Yjqyi6=ivUMpSwJT{U}xy)zg?Xu+QO) zyuq}ZAwG?Ima~BPNcKW5<^`3tNz_ohFIJwq(Y~G`b(w}I*J!FEf#Sm4oZFs+N16rz zZjE<|HD6YncR#e=DBqozb$lvzlP6}`Z!b<4;iVe3g7J5kb0pm&bM_reDdyTUUPl%d zGf~9Gs&zJoX=0@7XD8Hx#YJ6a_BmxgM^lQ42_ANs!=@vC>6R15I+5FI%%q^(6d;|j zeDkOzsL@n8D|T+fhVZGb3C3;pIDd;M>c{%mV~Dvs{Ylg`sy~5%H{mZro1*q#xK)4J0juFc~w;J1@nSQ9cV84Tj{=+KFg%UjOxk=pFArcd+$p=E}?z`j5bgFukR% zOVg_V^XaWEn$G?idTG_Yhx*yKUNs|IM%;D}lr(SeP*+=vnkG?)hB&73muh+wSI5p3 zujSsAuD(`8Pwqsx$}+9;oSf-={`wcRNmuQZL*DjJpVItAKMs0=d0>z8y~=5lSv1vN zgYp#wJfZ4Jleuuee{Wa|pTkRHHnuZ1Rld`gxAo&|%zcFVw27G^(dsA9*NA+0(na>V z8>?9gD7AUFTWavy1|{00wD_W=FSbMe9k*{QXAQYX4p@Y2fHleFv&#C#eDiBCYm*O5s%h8pkL5;pV?2CwwqA>$ zj$)?=pN|`!zC&G2pyfXq!IClB$nm8KLtAg11WU2*rz6amLZg$yavXWB8o|e6sDe)=H3{x6x(S^*FPmcfGZTFhxps~S?`)oMx)9sIUbrP z`tkI7!oQ)z*-uO10eoXlq;mn?>vOGHn_u zXEDzEnOUH`u#zLfj8dE{d6@9`d$-o6DZSTsjkiUKduK}^{aWI)uK6x$xl<^ zpZhp+<&mt?6YbyD!2Ylq_~yc%bbMlhT0@-0VADGw;MRtPyzXwKe}nXJ*kT2+F)+9- zg0b6jaNeU%Q^^y(xlUA_NyZ;!ho4~AmO)h98<3Gjw;|pYj4_Qib8`P*Q|x}0pOA=^ zJaT+umMc~sZ&hh+Z4J6}N)~e`tWOnXWd)`m;6?wsAHRhTa{cvvXcd3@=syj_e-cJ| z{5#mPkCDzROe9e!Gz!_-q5Xwdn6R@6CzM&z-#vI7z5c&KuD>{_c?!CQ7$BADRx}+@ngsM_h8I(_Wr1THuKQOB+LUa0aYm;2q3Gm9jiPqIh?SpIXIRw#4G6iUa4Dnn>yY-}no|OX$$cAv!R#zd z@nKK=&!FVa6i62p7m+%eaeBuRXDuI3ef|5~`M0L#m$@iimrnl)3m21&3NpOpz3zl0 z6xsiR);SP;;MH%%_=`K~w+;Ra^1bfJ!ONG$p&~@wg!f2uUqV0Zh%o_nK((J{-6Ll4 zX9r4XGKhM(Bb!%Y|0dAR=1vAD%>(m%=#6$}LFRwge;Ox%tCDZNkSU5u*hZiY~)1 zYTIup?GjF^!PdVq=;(+r{bdmMF;Q&AX76{3%{tio(Y5Ol#}&gXz!5Nm^(N94LBs|> z{`e5)BUMnZH?OOX(h@&k_WKTz0l4wi=|Fku=LT=ls7uo*(?_M8v#&Gt8tvVCJ?cwO z&ziMscY&t`BT-bmmvCNP5Q%SYX*mUIo|X~Prph^ac=TT=1>h<%;gW&pbUIv=%wznp zMi2YrrQH5Fx6CX~EB?)94D^og7%c{VXAouPe z$A5ub)5_AET+?F>mahLaY~kQr*VFugmxF_@@MlR(r;HZjNp*hb(PdHpsty?#m{(oQ zf+I5;?G-^f+M#_zcIoHP8l;-A5Vv3emzo|3ZX zg@eyY-XovY(vrNw!yV3dyX2*sFXO6C)=u0?ryz{GG?&J9qRm_@NhVic?TxVMD5Oyz zPWkKi2C`|oAxkFJtGVuuJVZX(3wdFp^#u-t=%6P%{0*8iog84~45eoZZgds1sKNI3 zarjy1Q^3xIGjA&BTi7tRwo@=PJluwa+8p0UHJ{^+JhsCCVg@`shd_x-8tw5YAE`M? z%oG%@_EW4FWtPt)B!+@*^iXg=69o?Y$8HKHo&U6<3IgcEb^-V9{XPbQpP<^a4*}xF zMYRW&m6w5PFg4}n;UVoXDfs?Y`o?g{(_c13&B%kj`(= z*|W#X;c5yn3O&=*;47nK&$CQiS9H2vq8Y)DbUMKgs^&mX&to=C+t9)nTVx!4xQ)Ck z-rS7)hSo``fFRA!`~3a8cjH{>QGiXH;Ebgy&Gh&81D#WcQzz^Z&_Qc@3TQ;#6WXt+ z*k`_8NJx2YxN@MMH&=#(gTunEa-_@8eSGjOm!`V*tNdUg{-!l@O6yqk5{ zzjFZSkFl&q+mS#%Fmog)zE&S68wrt27LP50)jIsrm35==9$wDI~5cZ0vddx zKBw6Zkw_#&idn;xl_pgC1dLrAf#8D5QHI|KH4qOEm&t#c{Uf_^0Yzc>m<9$3DRCSB zX4p4J#&{hopM6qh_SEwUdL>2t&P=2iVo&3W(6I(2ugpl_%F5d$BDLvUSB$E#p4=av z;SWLsw?`mzdIn9*V`*M~A#r0*s?3E?XiMvpoVvj?t5%H?F_5C;n5^q~Qm1Pyt^}r~ z_y5dJT+=@Se63?&-Q>E+J8i~2N&pO*mrT%0+rj1 zTjw^(E5j>IBbpM^C#nwu zi`HHwi&+JHFjGt_$Y|^|Jn1-}aU9an25(Uv8_7&!&ckIKR8PmaGfCSA<%h#8DCtA) zBJDy#_68KfpXqnNX&dN!{ZV`NO5dMFr4QG1_G%wE2Z$BNhMdmW<05yrWu}!cW87E| zhGDw(Qa5$)Sf?ifH_lgVB!A->zS!?W=4I>D)e_FO*W>HkVH-EPdN@2h97FxXXf~`$}_snlIr~{7hC;o2mP|WDIzrUuocAasE6Q8+|-rEz2 z$j;Eb3nHSGp`MlnDhBu!LHVFTFE6k)1g2Tz-zMz|oJXi)w39lO<>KSBs`e8OK^%N% z&YZCvpGSC#t&RIzo;vPr9}pZI&C}8hhglg_ZqPydDIY#;{Wa=GSP%w^zx1GUZ{VTh zep-{08eso+*W<}%>q?CKCD#l?0s9S|o1BP#$~!DA?eE7vNB^@duA463-~smS90{?! zxiQ9Eqi`OxC%KP@)FUuKr)k=y&W^b;J7>*;%o35M^WyHhdh6ctZY*jrKb_5I4GY)p z#L;K}fYMVbE5Ss;A#xYsGbOv2ucqAAD0M;Km4L{a_U!l_Eq~{GU+B?p~!jS^vcTrAN)fM2|cuX4R z5tsEgZrgUWJ`pJ*;M!IdMnwruw+~?gDzQl%x()E?q-aY?NJ%&eW(-twFxrUpyLppH zo5_J@Vob*3c`p=sJ;~3*!$BJ*qa~iax@BWaSJ%8>47$Dz<$sxJN&DSvX*q}Mx3_v2 zG-DsguZtxW&p(~;5SctN)_j2GWIQ>_b}pX+c|;`}N%3w!tv^9E^{wB1qjB>?21$-D zQtwE$y<^nMJo`~1*F48@YAS?aFfpP#VVUD@)o#?^w3+4FRIh3?kmlPDXOaI9(|doS zbJu0e$HG;-n3*Mf#N3zKmAsf6n{gboa{79Bq~h=p3`Ab*p9_e(?G>Z&6`?zc$DM|g za|rCCIoTe9!>OBob;Rt3sfI>1l8*24%Eu_oOx?u&>*M1Cw}d>Nq0)d9hbgmQm9D-% z(`i-C6~k8F%GRGEmqr^Q*dPp%GD+Gl9&SoXnuFBD@8o~s zC7Q=oLM*Vf>f(YzxUVH4hH3TuYA9 z&rDYw+}B1ENsz2ztc?KOGr`0`p4zWR4e#bMoX)UkLMf|J5s=^zy_hti*P(UYmwsUm zo~m6nJk|Z_eQBu(BpX~uKoW!H_0lCvzO={tqH=x}{yUs;FSfpOQ@qcvS2e&XE?AEuw0mz{UY;X@rQw|w9 zfYpGzK3@zxe3oTY=|3|kyY44l;>E6^&_Q$~%fm{5;j7*cewDkhqWqT(g&~W< zic#L%RmpD%JTzknuYO?XDO`U|S{P2j3fNT@ZU%Jb+1Qx0-RN_Pt(cgDc*?nI)rZ9o z_`)X9Rk@xH|`oC&00gS9!b7&42;cF53 znTWMn5PkmwirCT>D^|dqvbC)(bZ{rzk|i4&OL@^cpI{Ygh&NauVnhe@Sfu|JHwC>L z?=S2rU{Kr*OBv-Ei4vUP&nbGY^?mfHK+0F%W~eE;q6cr^b5)BhjNBy6}?%;mG$Y z5fcW`@c#=+-BDt)eP@7i(^uOx7u|M&6^!2&%3Q!2>z_-$2bnPdwVeBkWBHl+2h#1- zZKl|a$vOwt8}t3)24=3x%6ndN^IvzvAKQh8L(9`Yy zav1-|lxrp!yw71!ssVI2r)_m#Qw`~{k-u~N3^HBYLpmb@_w+d~qt79_WIhxa6Cx%V z=n;r#7=H@6U(lOOyI=ld^Nf0oy<*S*t`n9in(6dZBY&+@jmuT9y|sY~{@$DY5({JN1DfTfPF%cZMrH6Vc_g z!qKB;bUd~tD}AcT!EyYHxX@3fjvC(Xrqy=etIV%yhwS@qEVXO7ws4nC|IU>RS+jPK z-E=&f?2U}goKl65dz$Cu0)@Lu`?#?>IZ>Fyv#)=^ty`MO$dC z1lVMTvw#WG7#QN5Gs(RIsV|&n29kB#r(x`1dbKOqc8NfX@jtWl>DvUSZ`OM3g>8q{ z{|F|bD|7Il?$KQ2`S{MkIv2RV+v6^$(R_YTj*lEUva#+BkLV=A{7}AElA;mJpx?C1 z;>&)uzA=TdlPCKKe%|-*zebh?tPRjuVVXKJ`#CQGX2tSed*$ZMzD|XOJbSRf80@LT zjv%v5>+unI(;{hiBXG}*a4HxK4H(OVD|g0LzHMB2c8W+-|47E@zdfAD{9{k!?4qxy z>BXdQrGPJOZDYHIAyh%PvbCX~&Lk}N1|M&Ey^bnUKn^+}0c0T082ttBHU)&F+|C;Y z%op5$WRlciRl1Bvh9tMt0k*D4ZBtLwO}V^h2e|j_iDzx)y{=;%Z)1}r*bJ{;)G9Ci z5!kh5Tp(f9h75bWMIk|NKR*=0lBtU#k60ki2WZTjD-+X@#RFx$QyPqzxkxvlzt57k z=-l%M4XXhTfZ3n){xJDbUjMD86E zn4*S(bKyoXDiJ?gT2OG|(=#{76VcWkKYkpgux`8|cnQ6Ds0J4rF-LL=^w514mP?P4 z=?s1LtUX$h*XcxtZ%|Ma2cb72yz-oS7Md~x*TzP?Sa)8+!NZ5+Gsoy;V092lGQzZr z!bnppY1i_-k7p0_o`z5(3X+ccAWWs;$+kb8>V9 z;q(t7FPYJs&{n|1oyT!F8x!dxh4T+x7H?li$3!ldxuK!qLtRnmg7f)9qF^=D zzgOeanHk`qc#Hl5nko_`ki#T>!mq9d28c!k{7s>8v&PCXWWnrDG?m5a&WuUS z{0sS|ax+S=?%5(qz!^qqcnbxNI3DoQtIhxf?}w3k6w+-zVgCH`j=><;`LL!1xN^jtl9C11*1FR(8}>9yrN! zMC_=i;`P+MqcTgTKsT&Vo&>Q~PC#Uo%t(U?tzjmVfoMT|{pn*`17c?Pl0}Q4Z}Qb{ zG7QayH2^XkH`Xs^Wwo)gLf43_%ruOO>6Xvf+s8Nnp87J)Qiq%iDG5nE9m5^+t>nN)A_C)3|p|R3o}9Lg5p{ zdDv&SFCoh)pk~+6x7H?hTZ{@Q;CZXFAs@BOTP9LG{L|hn^V95?uBK0S28zKZ|FB8X z7=0b8si|4sG`dD-zFjT*(^O@&|9QtJBgco2B+Uo=`UJS7t`4_gc^V$g_e*qX*7eLa z{TksZ5_3JS$O~0sF6PNgCg_V_zu*>mI}Tj2?)~~ zfdT51ONs~5f)aA2A6z=zhPgtbA8vb9?RW3qRlc?K2`M##9YmcNq)cGHADWssZysb& zrckVU<&X6TYM(-e&M4Bat%z`(_N|U|p#d4OJeDVHc=2Wt&Xhh=qT_TtcLZ==j02Cf z;lzACpmHE$ZR@Dt#D7?KKNp1pSafb!ML^!#wpw5xo9XHXZKscfiTxcpkjsYYAR zp&}&N$ENSF8#SzYM*ISMZo^D)>F_CZUY~I*qNj8@T-=Ss2bik9oM&mpNPL8lohP$! z9w49NK4(hZUc-3lknaR;Mw8QB@B}f`r)FPaZ!dgs!54FZmvLhtryf@u!7+*{uHiLg zDrtQVPTi~2)MM6iJQ^xfbJIO3ODMQ6HjN>Q01qbZ^}e(GugWog$a4hx6}^-+;gyp5 zxLqq)%9CRrfhF>#Q}JWj`uzN!#2WpCQTn>sixq9esCKFR(Bt4YGH(GM(FYSuP4<1! zaJ@&Y?90$7{LUSZWHuIgZfd)KD(0RHOL`3>G5)kzW9e(*meqzqH+Ki9(KL5AGQ||| zO4~%`AD~7@?3_kK?>)QJm;y&opo?avr%}9gK3q&vfAaGJXx%#S3Ltv3Od$)aC z#I@+e&9t+*chvd{c-~u0W8u9qDq^DGuJvAD32)bqGSGzfHdoFY^-~FV=zi*c;4b$T zO_?ha$YfI}SrpJy9bJzjw7_ReD9_#}CaVoMXJU12E%ZOW`_cdeu)fIvIr+y%=jV|_ z_hp4(oaFd|>7S;#b6sONJ?Z?^$@^X|2Cs28K)@L(?`9_4QZt$kpemj8#p9KlEKh@B zR&4yH>>gIwmfV|!p|*)*|Lc!Rv(&3pr)XHcP8{Ck(R+H-4ta_4#aDLg95bqiHO(g; zx9Gh)*t1_%Ve%EFVTS^5n?VsPI8a%0 zdF7(WmwPL>K$cHkP@}6l8dY-r02Y;-`kTPEiG)cRHfy=JmxNm+IrTVpnb=u_T~5Ez z2bUw_)&#*Xm1parhkts2D*mqE^>cY_{0GL@rna|ew#HaDRePj^m}!>CD`^(=CRQ&^ zqZ95mo5#?*J^K1KwK}Hg8El4tQS>`O5Dn)Y_TrX0cI6NgZ%r!rgjzI9%kSwG zl`2F>nrLcZR1?Gcl3a_;3r$eWgrd8Pyy_y-^e=715BHj%y0f?q&5Xo2$7#!nZB{~J z2)|9pKW_yfytj2269;Y9@Q@v^*sEke;$@Z1E=l=p*!NGFtoo>ZF z7L6k2u;87Ub8wZZVHDVS@`}6}V4^qj1u*&P@b$n{7)XJ8RYykvWf%foD2z7EU9t993wnv+yoL+|Dc(bct=2dFn2fwcr+VXs9*P+X>7IKG3C@ z(Nbm8-8PRIogW7mDQ1a?_eu@F!^Ji}9~-YXWVy!OP1J824?cu${9|2q_azsRV5ZTr z9q#Z=@Xmc;2aF3oPp{@88FM|!I)zZbGtu)S-CN$X$)BJN?XSOxfo%KUkwV;?Fm$rJ z(H#&F0E-A;WvAing_bt~`B#V;6_CheeT0Zd*F(88G;|p%npM!UUPrN-Jn zH~X(jevu0PT#%yc=xrv_;DZE1|HxTwD=@4Qvr?b|<)gJHEm;m%n~mZqLXNdoU~arr zLk8L8WbrOA%JeXa!X**r5MM;Eo zFVE<;Woj)V6<^6JSVWJNz|}r#iG<&02QOW~`E!8cQ=YI-CbqiElenORO#Tksw?V-%|OL47F7~|zkXy$uWsKaJ5fnDUFwxuhS9vw>*$F+A@s?H`t!{bl*O*BwmszvTaGb0 zBTh@H+UR%|4FvB33Oz>p^n2!jHFAzA+i@AGcfw5zgN^kf9cN}gtW@nbZN@>3CkD+p zKYt3DsM{;bzTxPyz0;|ov&8HFrTC+x0H3*sBc-3JpKtHzfLGBF_Rql?$!5n2po}I< zk=yCND_BLo^vIz@70nVzDDuK0GKyNYbncko$bE3Q z1D#c5(v!L4y-RI#ly&pGtt~_4VTBNRM{A>o<6Ed%+??qoEh{T4AaKN)-P==Qy{tcV z?e+p@*eU_By;SEjJ_%fZG}ejQeSb8k6+L{I!Oe1E9y)LkaR4hs=xNQ}BeQo^tgXkb zN@X=u7@e0thZhySxyBdt(exy-ywZ(iXIyS*jX&n*>Zf1*)Dr#Poed+-K%EgNnzlwC zI&uU-nGfCAOM|4w#!BTe5#A%eMj0~30CZI^Y(ok=we;k+bNEcB_1j#t9TgVU44qwb+EUOY zxe-qHoL&o9+!~VSL7VRE-;;U9P&hX^Z=YIL3kN0bG?-<*CrxSB7%YE41u=6Gr3`th zSq7V5x<7NUvx^9H)qy>zBW*jws^6!^Q^`zMhGwBlPrb9+9Q<}#0oKs%jU+*E3 zdGhzE!TAh7BQ#$%xH?;((F>Ft1FY;IGJam2^kRm>sj&Qk^0AwY^8exv^9!E(dGH~M zyZL~-P;3x%IB{fr(Vd25UO~a_yLX!sj7u@zBXQ3CdIpB0Em zUzIM);&2{ z-D6EpQYY7p?ZwhimHb;G5#3tnS3Ei`^zwWHvxML6C{Wv9oZ%Sm3K&`aC5#W3GuS1& zg29%uK&Lu7F%gYR4ZRt(#HF#oN2!Bxn4Rx&Wsa~jv9+?QXxfG7SwR_GjF&)9G4Knq zVBruvDzb9L3PW~P)zY%EG9VWS=7lW!0uU8Vhx=6Kg$o_7Ud`Kz668Vd@bEASBHg#v zhw58e-@A7-l1Nvr5~FlekG=Kr^)(XtUw)>aYtyf*SKL9c$VGmneGoIkDJ!qlw41b! zyrgGkD;EX~dYx=L?Kn`n5_fhb%AYAZ=DJR~N2LT6g z5XS{O#Dijrc2Tj$3JDZv=KYfL`mr%r#qDS`K;hnXu4jiTXUKItWxU zzJ1&i@EGgTr4-;R-VYua_PhQ0XSX?gGEb~M3ku5;;TBaTC7)?=&GXLo{rbC&@ zCU17{mWx5)-A(;3_3A%XRLE|(-re4id}CRkPPDc!_!q0}vxXqS8E!H58I%qP!LS;|tnEM@0O9_@!A$F(Vg^}|JBZlwRv;)BdfRDOBZ>>ek{441MiyWb#x$pZf_8*ndB*1E z`}d0Z2PLF%@HS(^f*O@3Q%EOlZsZpfR3eHZbQhMHZX@Kmu)y4CyK}bT z4jRNwSeY7QAeIKn7>#q8FGZhenQ(3yw7UBf&6`HEVK`@PBMg|N3RXym3Sppw zkZD2XG|Ahpe3b6OoAR=NN;6oXwtu(ys%o^c{rQU%SFvBCtt^cllNV)K%388?j6i&> z84I*^)UkOiNIZP{Dyzlure0{qMa6%A(vdU};(y3FL1ch^NagNKc#!jCxH(RFZ4f-p z74y{HOFxaBmtH+!kj1-3>O5(faiTZX-ob$o-%qtv zS9-Y3ez>J8D7Y^u|L~_|)37jO$K&M6@fz#SiY}4!WsTyQPbHc&*I|D zL`6e=uPE@gAGu_rc-PFNw%mMjA#G~8^J_{oxWMiDQs+-(i9G7oDSpIiyF}c_Hc{Td zX%pwfa!p5=%UcPoMTsot_+WV^p(7l)Z;Ke8HJewYr zU|J(AYK#uMw~CE>=kMo)4KmX|SkIYVHZRmUcI-ik@-23x$X|t}C@A7|Ag4F^12dw< zv34|2{;SGOKYu*eZ4ibq{s{K)g@3bOqNShW)*5If@? zdbYTa$Ri&0uB1d*CVl8dF>iB<-QKR4s)0!5BOeF~yl+gG&r@L2NgP#edYH1_?)Ag- z&6%E*z^Pr50%Ulc>SRZIk2Wv6Y4)6urXBL;kazQ&dmm#Cur@>klXJ zN1Ri3$IRzdv(VV|TH&W(cr9`kex|aK=+J{)HqLmT03tT{$Z{owBBMA!qwg#3ar^e( zef!`L6%-t7K$td?5|@{6&dJ%db0@+>aT2(??mKtx+^wE@vkeWp(Dw4k+IKhjIPNF* zr=C=Bl-ghuJ`43hqN#hmZF$c4o1RZ9 zDv3td2Ro`>I?YJTls_nR`g10hxXxj!QB7F5q=0$j24?yzU}O}E)tBCCJXjm}$KC24 z@!Y}cD4hg}JxaWC@mj{0BQtgk3=V*C`uW`hFJqsXo3l^%%@p*U{Yc~}jB1X{i@S}b z-&>Vv8*Rob61*j8%dSwpoTi}~k7S>2r`Bg%z8KZbdXgmquSistl$dqAV#~3%w%*@Y zUA*kzO5e#rYNab%HCz}ctV$=g^)9D+u9fX>Z55W-B&RzayM5d#^Tv^vB*lxB3~8l| z&hQQ0z1zjz{Uh2I0w%o(Tk6HJw<(P6HSm}`N%CJq<>;l4C@y~%z1K7Pk$3PuwmhWTx&|ARlxrAi2@IxUAEL5Ji*IjDPl-;#! z*Nz>D``L$CAR6iJ?#94k&vblB%1OB_XSii|Ecww=z1;P!hBo5eEt$(qDQG@Un+oFG zl-rab8KJ35*wSm>w&Fx)D{iO)gC3IeD%n#TT*9U zS4RgHCJCGD3E=6ie`GUdNN^l3dto`BVALq>wgyRnnbbMAg}zzWEVz26N_c<7 zR91Fud*K@@S56_lviW?`izoZ((_j{};EQEXn%u|u*816Ob#iyqprnqa;e!Ij@OeXM zefmDoIwow^ahd#a|d*A~+=&^JA0TGuE| ze(y}6Ikfk!E|^|C#_!8DT&ND;++%y#*%y{g228 zY|_6l`Nx{i{iEzwV2Hj@a*9-0$3LBC?^Hg>5zM-5fP2;WP11RN!ZhyzCJL-3&41sa z>HK4LM_OmaI{7H<-+%S$RqLT9J?Xa6;$rr(oHUSP3WCzp(;cL`Z{NNRo)|ob!uHRo z@3*iRL4k_kKH4rQ0jE-r4_i8)|j>?CJ?aTeY6Kh&$?%2&WGJ+b{OI(OL$#=7} z2UvM)Db+f$H|Kx646lyPTV8%j^0ow9mBDM+T%O$1*L7QRR@0hL&l!xedGsvH_sFq% zAj$WFkOt?fkNpD!v3j&UwJp*0;qTtP1vj(M{cZD>BKQv~YQGttw(kpPN>;gTMzJ20 zzB0AcTv?jOto*|f!6cmov)b^Hl9DUqOi<@cgJyZ?#B!b{&8R>p6LTi@6MwXIFElcFU_lB~uhWh4}-P+e&drR-U@C}n1ACzY0!Rf?>VQ8G^z zvW4udkn9ysoSe_=L-XqD`@Qeq^ZW04`s2Q?tGiC;XT0C<<9Hpf;jU<=|G2l8NxQHi zLBCCV_{f(6!!exKL3whwdR}Ks;bB&USSIr-_pcE@?yj=6sY*H@qMFr5D5C77+r5`j z!l#mWV%nTf<`mFm{7Vfbi1)C3F9=yPsKb(3uJn9MzH}??%_I#JWWn6Ax~AshCA%9} z=c^s=0qt~|aNC!_L+RA_DV>wwcVgzjoA3COH`tq>ZEw> z^AOKLg; zIJ4h*PyYEY6>u=k>t~Yb*1F}cH#w&I=)zU!tUZhyS?DReDWa}rlgI6(`F<1F&TIA@ z2AUx5^4H@2nQl%HvgK2&cb0I!?JC@D*|?u{+y2={_D%RTgS}8PZ&uzVnRI7(8+mp?LxBrRN#P#q2bM5wS*zG z6aNr<%g@z|A+kd|*1!dEh9ic2m-8(197ncHO0Ywt9J;9`DmjgbW=H<#3tzkE zVd=YXfZ3BpL-drHy=#{1y(e=hm%QSyU0dki`zHP9*>-C&UHbl>OX|~OL0ZaDCWCdM z$LBvbG?+PfHd<#g9gRa+s0HjGb|6z;awI`e_kB_BR-E^#}03wG;Ke6NKReEmZ-312ZF;R%|QRZWkX`^_IuED?3x z@D(GXDa2avTYi1d-o4Zf(kgAKcM2itk<$nN$;{O5^@?H?GM34U8{|Jv#(@ozmE&9!mO9N}PE^Xn_egYv#f)cxCoeKza+TY|q;K=bW^X3j?= z!1A!v^s^AF5&^rsQN8ToRs;NUS`L5prbU1+?Y}rv6SvsU55Sb8yex6gGM`l(Yj7vs zGwTDO_J8O)xo&W-BawbWV$}(V_i%U?69) zPT&ayS9kt*pRo!4_5dA18=Ike%hy8pd`&eDF~4B1?d{qX!@Ep3!T5T7?-Q-0Eazb= zFQ%;E19X6h>AY`WF7nhN)V}TQ9oA3)G6;B{tJsiF)qp`|fsM)+F_^{ctpbSY3i1O= z6p$f7T`x+W`~Ag=@PSAGU#`C(V?8zu|Lsk&Dc5Ayta$?=`QWes;`Cvk;i?)4@tWELpEHs!@C43~|h9)%}>r2m^~+uX@_r8okv$ z#PDDvdHlE?s9KwDmMg?#+B!Pf{2-tD`>}IyXn|Hmp*S0z$H11gk9(`lK0P56mn=H` z{QMsUXJ;DWTN1yNiC7f;lWf#@*H65uWJ|i(M49fJg4Ri^&(#C5C&cE&Uf~g_j~v-? zo83)O@y5K%<{;4O=;*WseVG+^8UeDvd|5#=y}PHcvrxB49?pbm4%Wk*Z)mCI2W5op z9(}m4cX)h@%h*bnxQ|zu*T~6Pj*s^D!_J(!9C&sd{D`17=i-7$&z$ag+DNTA-tXq6 zKYc^XAKy@UbyLXXD{|{~kFAZz%fqv~VlQ*(x}5&FX<&er)#ToGgJ2PBZFF0eHOj+< zqb-fhVwTG&rt@e?(lVj#(N%@z8aGVutR;;##`@L^Z9P#Nq-vWfTpRRyAxp#C5P$#m zdlWHmeJ=*SXI3Go^GnL-P++C1??@pJY?TO`O*wZXEVlzizJ2HW{fca?tPTziMS+q> z^n@_Cvc@kP8zR8P*?BwP>hGJ%{S?rT*Y26L-_!AJSE)RQT?I=(fVm&e0j?ij?vtFH z%wP=F*ax(-YPZE$`e^7~oZRD;#l?z+g%fQzGoI()J?i7G_XR^M+FCIem-G;aaHn)f zlFWQ*QL963jwf^6^%@h#1?(5&_U%8j@4x}&l4(FP*|aqDcG+jCEnCi*tp}ohSU6m) zsjoV&<%5i$h{2^L{RLbgkSmx-7-r%QjDb{fB^$iEmF>b%>7;FkWW|q=rUU)np#AcG ztPkYBn46X$hDJ!J2MZ&xRdUsu8qE!VUi+1{Zw?KorswTBSsnjsqU&6$ycWMg6BGRgt;zb?f0beTceTa5)O-?n-WdkaO9lqbn76z7A?iehBW_x0MBD% z-V4YI!#lHbGFIi>E?&kqYF830wP3-5zJZm5%_Vsq*vjw4kc5<72 zzb{3wm9zItn3X+hkSzaEE;kJ|1sl7So*$@{H)j4+|6PNRxe zTOADa0SkF}vEWs@B;% zud15t_+XD-Hz@FU((yK#qnToInZn|mkG(dHV>4;rY7&1q%Xpiuqq43&CDlF8)w$4!rFX!UL*H6|679*m9-4xpGk!Q3UpdCp=elj5H{x62%MEw{by<{$VJ=7Mo%dt%dBnHOQQWpqQgtoj4@_TvP z{!l}B;AzLlXKF}pe$H}fOO}V^$(hxSH0!4C8VTdoo03$>Xlpu3{Zd|kyHdEjTIA5l z#}Qk^)_rCksH{8@(nB_O*s(*Nw~0-xr@Q<0n~9UPl!5C3eBmX_Q#Y8sLN0NtjYD@H zA5ZK)ll;FviW%Rqwtd3EI_xw$;!4T@!Zx;GZ2`Q9OFQtG@pMOd$cF`+00$<_?vc)Q zg%`))-KUFcFWkJTc;m+ASgK=8|H(@c(JBH|Y=(Gxo*n?>ucUtt&`Wj)Q=ohQl8e{4 zrIaU6`Um@_mPc3JxH^b8c^YwiJj=B1-RQil*HcqvFnm6rP#k`;aX@yeVvR9^YlenE zu041De1#Ztp13$UK}V23z}DaX>C;w8$>GnXf47IXt{KnHf(d#S|3{lgX%KPoe_F^c zx;qB5A=@`?i~Fs2?TO#4`ybaeN5q>z@q3z{KIxryzCijqW+t+5m;WT}N9nSB8yI-J zU?RC<{qvDE<2ch!O(>@L1&d2*#;jgDf_vnwD=!`VVDgG#%)E52qE5}g5h9z=RP112Zgofx&#A`+CB5vb)?&F)m!Q+38KNA*8wqoj+*qRFOFaVR_lQ-R~}BSf%uCBH)8_wAwb z5zD2**}Y$iVs~dYraL`;G`xU`tKpH@X0_1|{fb;%=2v}zxkkoBms~17cxdXp`!XTt zEdF#SnPKbVDW`?x0;wy5gM+tk-_CM--YEBHY|dO|V^fHXTZXfSvhrWWV&HOF9noJc zDAa%Z9Y|?Fak^CuE+$X+=KyasvoLP+myp5%0LI&Y#|KqOvkx zM2=>!r6rkSzamdGQaf9fCvr=LaDOqybL~y$hKaTMwjS4y9xK}_?OX=>OL?Y-CiFJx zkq#9f^pnBOB?%aXSv{mq4D_vQPH8SSWuWL6DBL^a;3#fm@76RD^hMOZ-!0KF#qPk< zyZ2+6I$iUv0NdRj?>R0qP}82!MhOckTq3;L={D}?2fU$=K6M6jG<0Aqp~njv4nQ4}T~peSI7eK>TIKlJ5G zGVoifRfJL3(*yIy$5)QmM0rzR{T;BI0bB9a zlz2?ZIGEFycyh_asaW(3ygg5u47ln){)uA|d191l+a2%Kbr(II_?PrYJL&c+BF>m~ zS!GdnwuW?)UI=4QNE3E)X-(0|4`cPAl&=_J9^Djr0H}K+0O)du#ptHrGhjjYNj!VB zC&#~%hDhB3OM)<}emfsxA!F`4%GmMv!t$fR9}I zRL9(Ylp*Wt$&(xM%jW_U{g7g7J+^cd2N1@2BHQ(JEd7I{LxiaPZ!&-#7UT-sKPJ_0 zX}|+xT=9OJcgEkutvQNw18JA~ahlILspC}}e5Xd!=h02!1(MyfNBl(X`;wB9H*X$- zMF3h{OXln!b+O}jbR~SZNv5T;0Dtjzd)K7mES>t3_0qN?P6v~SSv^K8K7wN*4^}Q~w0uyvj1&wBq|M`U;fr zH9bZY1L?#0b;81ya3w;N>c_uIB)9;%DE;vuBbFI~0_?HqzCb2xY|`{5AhsKu0rgC; zK^hv1uVcgi3IM|2C161sys6(-GmU_|JI{e@dmcVW`pS{k;`%gc6ms_Z*D#g%6MwFE z^r7VZ-ueMhnjS~Yh<)>3IQ)k<`x{m7|0)9aUxR$VmkwgjW|ZEt`(6|k{2PPsI&1)N zFEa~iW$wz8T-`jqLUtuYE?ZJY@PQV({&-e97-?mQ$42Vb+Bz`M;wfMJ<=7NZjsy z#9Yxo{JGf_@#?J0t_e-85lYN3uH&3V^Zht-M_LU&4xpeAEIsQMlC#|`8}pi^fBq=o zhX3|dbvEFGIr=^AfU8@HxzWbZ!PW0;OyOfRq|h%4 z1yql)W+o;t?55dSSr96STU2j^3)^(31&A2@esQ$cTt535D&Ha2Dcbqo5!YC!b!ha90j^|(0{t& zXL}vsqIE-bg|3@anw;1tcCojzd-oa!DX5e<%S>^J3}H}+hPLa@O2-VxqU}L#SH#T* z1E`aZHT9w8;q_)J43yCNj5`m8q+MMYl#GqTwKPEMBGx)lb3p=ErG#p3IB#fSZ| z3_hy=-tFSu?<+wFz%N!p)8V@9w4@L{7Lkn&PQr5j)*vpSXU-~2(_7S`)ivS5v0KbC zQ`iw9eKbA(85s>F+so5+(;In~g0>W4B_&~ysprT;^{QnjWt=w!@)lZ_m9=}g5ZZ4~ zf6rw?{Ohkbz%|m>Cms^nVg0RiQxF#yPo8HNGhRna`cV4fM4gS@-}DqHZ+M*h&#GI% z&C`mI$z&DW;X8P>13g_;gi;Hfqj1H)!Clh}$nlR0h}gkU`9IJGzV!>775eeOu;#(- z%#boq3L7>s#U{ittlP`GaRWOIRUe2B{EsJiBkJeQ+;Ro0e7+eBvrq$kJ zfZ5rXy>H(R4Tc|>ka13Swl@G*U0vN{VMObl?uXenO03DL`*?2Xw(M6M?ZV^sa-#|WDA(c z5*OrJlVpRL^{rdyFEQ~PiVcoVN^0jTXz(2ZreUG`dbgw$O4iZdpjK!RhQZeO0t-yZ zZB>#et92CvH+||!+6(%}(W6JBd$wh~W4|Lau>0n64kwbHaC@R@GYjVj#ec!0JS7d@ z?s*^8_W9#SK_3dmlPN3k<$6nm-beVcFMelLH&WtV3=r^X{n!xOCX|~odW{N+Q6Ct0EK(l_61zV*ZU!b1%ey$;FSiZT+_?utwHhUB*}=2zeJ?);KwHuM(V*(sZt znwO^^9_iS24T9xeB?s%CoBNWVtvwhV6YPNdC}NFmlsDXoh$L}d6Ar?w%}KeKEwCy= z1RK7JcA5f&A=rvTi`O4<7H zrmYdRdUx;nyj81$IJwMqsl$GLeH}HY(15p!f?=1QF6G_!3#61K&%glNzh0k2*JE#Q zoCTl3Ca3iWpcI@wIx&n3FVx$pK~J&wRAiukF`uy~jhgAJPs_w)A6Mufa~IS3-US@@9CCpq@Wy@ z&Gx@1wLkRc3@xmD$jaVvxK>GN>c~N<(_JI$$CPPKa9ABXQKH`hK0?}fXH!fO-i*s?U1*wNeA3 zVOgy&Eo5J<3Vc4LnGlD3FU`I;o$`D2GG%N`^(0*|{Qk(IO*(d~*1`h} z?raEutl(v574<}HZOBBk6UHm1)z4mGh=t1->0n8*t9NGa?*l7rErHsBtx;4vTf~K& zYwW_5LLE*r=*!ra4?oWx?V|)JB&Zm;wq00zlWf|7I+9W&MQ%3bE0;^vlHl2mGK?bw z_RM2u=JUbMg99M&p@H#U@Hyc@xwX>ia9_1GrI%gI^1Pkg-R97_zCuThrwq=PEpSq- zN<@JhZky}A&goNfxmJfe?E(iw<_1VqQ9C?!<}$fl$JHZsA> z+O}4$x46+8u+t*-!GVP$ldhC)Tj^ZGh9VoEE@KICk=82K8_yFQIGn(@AL~&nv~kDr zr@hI|K{sY7UKchg-3K$`1PA^01##w;YqxBxa%c~_HM+dt*J&{;=B$q&gTXH6F%o^{ z#IA*|)an%6Yvn#pX zw&ymIBK;yQGn(Cjr#=(YSRb$R^5x^zw4{{ww%#w5Jx7ims|U@s&3a;MEDVcfh{eOJ!zfKmkD7o*s`end0#pVY}6e^~_ zp6IP>x1@;1LABoonB59nt}%PT)G*zv4O-Qn9&;ZmFl!Ky6#GDZ(DKNokI) zQtf(D=v#%BMXMAH#JcrZb+|RM^sCLXB`n94{*Uenb3Z=wD^;l^s8Q#P#NU&ZJ=;3e z1{bXeU{_1gNw-s$-o9h9-@!I^12xd@asOxsz`w-{1V*2Cb*Guiw0D=Jhd!i^e+qc! z-QmD%_Z8%MmZ;>hCzD{*0Ne2i=(T>)eBqkmf{sdP0&>XnZ(q zhVhnEX3OX`D&z+g~ENu8Go`&;RzqmHmN9vi(~IZWUCU}dCs{&vZFBka{}yD|@oarW2M?p(^u z{2-`T{_ZsyQPJDe4VBi^pS#C``@7@4-YS|$3Kv)wyF5W*v7_|787M9pbGmc zPNdat60Et0Sy`&~G*xLDp*Y~ zP*i*g-X=_TFrK-_A+cfY+8pH70&y`jGn=jzQA9FMorl(ppcyH8j)Bgg(twPLK=m`o zPssOyB^`e;KLW7>kJ3f~#+v!%PCNko>rn+-w+7+MH@K)N{L93h3T7BV3zSS=f-;jX zVAN)xTGb#(j&sb7%Pi5ExPNDc7vwcL1DzNf8Rhxvx4`-Ut&jlf{Pm3F3jg$bzDP?1 zJk=?QYpEcA186g?X3F3*4e$^E_fp!fFnY+?s@(jCXzAPbs^t7eCU3v3!in?+&lHt{GLm@ zf93c5+?EM45q!(aVf#JNje4@rZ;^(MpLZ+vAvM8xRc-UK<=?0}0gU8fZ%cmLPNR&* zq@9UZEva{m`Ve-~j@do`bER-K??q%xY_3E#{uA6#Io0RG((enZ(bLJ8sr;Z+j7R?3 z{@2>IQ6?a_XcTHEnkwx#Gv?vsOiR3r#}`TPRqVT~Pxtbm4R|w)&Xs`HTk{FLW%*AL z;WI)>ACNHrNkWwM`dn4q&Dc5$3jSz&Bkl5P`7p6=x#&AR9(?EUK=iVchHA})uRc|M z9wC}8D)`o21rxeoSU6f6EBC9+ro_crUTIM@2@o|34e!5=t&3*=?w!gO->5eqoW2F2wH&*s;T1=bAX+y}D#j;w0#_2+*wk*mRCeFf4}V-o zzYrJs+4_Gcp#)MtSWB%{Tro6Kw`Rp=$Bi4GRg7@yEnl=n;>6TT^QuLlNkCs~gK{SR z7J!4ij*wy(wiUHCs7Fzs($Q~!_~<<-RxeCSp28{ScxCqk^e~LVF(>s~Sk_*HeWK(H zo5tp3`zZg~3=zjK@8}sjr3SCKLEmF7<6Kf#SN`^`)7Vu>`h^!R+Io7hKk1h5md$vd z%;vH)He(Qu))^4OXefc=L(qPF{lz3+fcC?x_E=EtJJCl!A;fLq?C0j(Tf*yf9NWCl z!lLhpy%nms`VZP!mwA2M0P&shzqCizLE2k2T7US?An0+SSGx z2dS=|TxM+goSyUrYC&72_>JjjCw_P_X&n|?U0nr>4Fb1W*NS(QLwW--5SHm)XB{8) zfyfondHn|V2^C`Bg>{d%N{5ETDuJJB^`C9lk-IbX&Pc3T_xTnyhFHZX_vs3*h4Og~ zPaU#D7yJ{jSlD`3f7@@+fdBi1h%HCD_oaPE=}CaphiR_q`Xk5VV!tzDkOqs`-}=ng zwMr>LK{{v7G%5thOrbNct-DoFU027%P5Iz9m0AcL03Fl&u6L`N3Sy;U75PXb;qt=e zh_t+p;(7kbprr+mOq|!)-NmFlD1GzdeqXJOGX>=d52}5&rPmrm1!t07rQ!qls_aG2 zo6rb!>0sdpY#LM8`}Q8HP+#hn9m~nb%a_>lp^mMOZ7iRfQpg@;+t9my&CqzP%<|=| zmt3N>{B=7xlv(5WM>ZRL+M-sKqE9vD4>m@HX>pvhT@X=yASG4cl7JTEhMdfE!uBpT~!#uq0# zQO^oz`#`bru+aL`Xt%-=7F;0T^3QG!sM&)Tm=%u40edbGhYb5=vbja;!syh7anf; zT%z|5kM?betJ(q5L~jI|o`S`i_2|%6t-K$m=znSN#bY6D(xG}zhg7nnLiFw=^JGXk zlZg>Kpugo(j;0~f4-h@%OH0ZS`iw{fC<0j&(fWCBVC1S*Q}lc#Sg8Z3NSf|ak)J>l zTVb%2*1{@{1mk)@g7@zqh0Gf+M=QjPuQ?MA2X53U4Y!-fWQf_9Su(m(nJ@1*ujmc% zRO0@v=2r5Ufk(UvqKoh}(FOVCdTXCiAe-~g)_wW1J??F7RKOtTgp|`A=!lr3M|&sl zrrB$!Gqb01Z%>RoASbk~sjCY_S?iigUZHnM&(5yXX}8OV&1Cd>9+xl7l9L@K2}UbV zWbW|#ry8zWKADzu_G&&OnK33>xQR`{dA^X=xJNN4U>l7(wQ5V_?K1WD7$-m6^|%BN zpl7EFbF^qvW3qXex>bv>$48bLAb_yFKk=Zj0fZkGM~=;ohXf-Rk-az6uP+2@l5=6+ z!(sM_`~Gqalu@hRe?w=0Vv!=|&Yyp{GHON{r#Ofgw@qH$AhYCO>`K61C#clQYnu*E z+C5iq`$c!wQJ~M56#B7nvpEYC%V|T!xuP8%AkeIN5t!)uATVU3+wJj1Q_yv(S?+Co zO&@9#R2R7qcP8^!wc1{WFFj%K0N5cL9L)F)m+`X8v^-ibN=vfhOEJ}R9loW0;I4K; z_?s}Qi=}d=-YX@gSMGZC0zv1aR;wCi3P%y*uI1L>89C;bJJUxA-5tZKG#=`WVt2hL zUEn^_bgY|>bhwkWzY&ydGqjYI?*<3E!cdO4mf?HbM$%&!#{}Ha_lX-!Vww z8tCLHdw-7$k&?A#`G0$-=wG|9L={$NW`P*?8V z@n4uStP`v*WH3m_mx(V9>#9>sKAT8OC$YdaMy*6eaAdH6x-o5L38HEg0X4GvJ=|

2$ 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

n?2E*aVkHb! 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

;P@86$Hl+z>}GI(c9 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 literal 547985 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 jgTz_e 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%0AyJ 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

>z`M*e}KbcXCunV8!Rxr_=tEnTlnt%gbI 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�?T?phi{}pIvRlN1aJD%$Y>6t>dXYFyaWLf~&-zbpOa(#?* zBhLY1vC5pQ&@?=cl!ct3KIx|1Es07H_`w%v2)2iS_G%J(V^mbWn3V@FNsA|%2TUJy z?b}p$z|F}{ZL+jAeS~2@mAeG;{4XLs8*VZ39&x1{?}O>~WufRUYa20=BW$Uy z5c{$0E|2K!ZFmIVa2KIH06dvG?6eaSV5t72H`TXAIAz|x-6T7@uS{YBb}Bsa?va6y zGXOjsW$`*b9v<}k^Zk=)GKWY%VeF>`9u?D>?G~Of-^fQg^mbC`&ZM3RTqfiTmMs*k zknD(26KG%llx`fN!sTJz=q2l^!)={=lMw6mtO<2Gv?}^7FKCT zw2?2F>2W#xfPl(&swcM1Jp5)5{|7D->;bsuKs1>2YvM-_6wL~7Jcjbs!(4rdAj^Ve?GAh6KBX%)9_z8Ck-AQbMN&KOA zAFD-;bg1rEWGjX3UsS<6$$0(C-!-u6BDR={HUIi494b`zCGHtS0;Qjyq)pp#%9fvy zl&MpZYbqJ}&xQk4!bbZZk-2mCKC&j2v#7{-v z!AmjTQ~r7JSN0sU$!q-oeN&koB?xX)<*_AmfC@J@NCc=d$w ziB~k|px6SQO(&mx=P&WDCws<`h+Fy~;t$9FUZE8u45zNU>`?O>-K|qT_7LAVgS|E< z3Vl)>;b+2<2>pc%FsN?r$%Tb@$5TAZZ&1uS_XamO(IU`T32FHpC(#OSi?wcU@l(rK z|KI6Vk8Fl{bJEZSy#n++PmB-}G2=GF-n2^~5xGBzQ}sWOfKC6inTVlKJ$iIG#e^}? znZEe0v_l^da#ycC14qj20L7yRs!9+wRdyYf^wC^0Z=5;(QBr*LN7{e$mB}r0f)ZDp zYmC0D?StZ|1GrQNdwm}vtrDbH8)pT)9rxoj6K2WbnopetMAE}>2^rxSyIoLSs6n@}W97D*kKOkbka znBd_WqXe~NY#@Sqc7DGx33wWiy*PP|7#xU6M4cjnCfEm$i3ryL-9$pUo)_k;ebQR^ zCL)Vsjf?ruLb>s)@BHnD4s>9r8g=qZ)shVQ{UpPZTiQ6?O_RvEql9xo`q`a{p3O^9 zvejGH)4#K!!Ac~VFjKw7lhGzhV-Q1IBbSPsGp-PHrw_FC*H+r?uk#*QEW<`3pDyQe z%Znf5HT9o@{BAMJ2}|m_Mf6>r@4}8ou0CFbfQfbHE4QCJQznjsel0%!APIjk6=j@| zgij~DY#;`{13Qqs^l%x&LdE)2JFx`XpR8Cx@+p$|+vnkVjC|2VA06^)!J2qhn~83) z%c-wtX}j>SiTkpH*4F*=vULuz7D=J``)Do7M@&kc+Hg;-@>9g*?m+up*Y)$V+ww)#!4&C6a zy$5zA;`Vcqjy{)e%><|DAsOa0%9Ix9=|9@vvy>>TQRombynQ?>Yihq84=ripRdxr&AclqAo1NeiS&+bM52J7 zc3wP6m?E3P5aqx(RUj~ke6prkL?BDUyEkRAdGOcRu0LVl)%0E*7*48lBZ7Dm&o}{9 zM@K_2<0V;@mU3k}P#CZAlxhH*Cog%f&GB5)VG^M6bVK)#gaCP|%m-MUK<`wJz6y8u ze=hH-3Q8$TQKS{-16kvu&kvv#wHvlz#=qDf2s!oBRGkWP1B~3!HlmKUX3|p|_YP zGi|8sY&wr0xv8R^0YooYS!Qs3Vg7Z_c1r6@AGwwZiV;G|e|DjDtjRgq*-)})1qLv+ z$z-Zi-(Vq*w;KG&(>`Yy%hJPvOPy)%@=GS&aFq6Nf7|DR>iI1Mg}axT;nR-Fop@I8rfy_Tn2<3wlEWPwNZKWS@V zVwH&lgZvA{^Q0sDu=01M5C`SU=1X7@L=zj_Qmn^4aF-@LaLt`o1$o07qOJexfa6av z&}dkSzUl6FYEw=r0X`!=Mj>l{CLyOTesYuQm|=}BNGs~}ex`7m3nzlupmfFlSA_pU z_r#V;g3!noQ3X(JuMjD_cl4XD=+@2&SupnR>`|@?>HnZ&Z=1x_CKN_;TrXi8siijE zFO@FudUGu?JqPeuz$jx4Jf!z;-(FJOo^b9<89V`SNhZ`?4RqnclOsgJ5RBBIbB6MQ zH(<5nSIC;f;G{}WUdCm)BiLPdd#bZig^-5Eb9FODUMi!B-GUO|*seDUR2Si#7k*+* zakC8r>9R26S?I7ao`*qI<5O4CNwgX41M_`G=Q zm5k6ID{CUo(Cp-1YO<9ttBTYrxc07*}2F&2J#L^xSNGFw}?B&V)bb z3DkeySGBH6G^NmS~NC&)8~y!D_08oMYB~E63(SvgiO=&S^oLeS$h9j`tjd{hQ z1OXr8Yv4h>eB)UCB4G@+&Qp)@~wy6CXy8d5!jGWOkX{B z-n>(hWpM2{@!(5iHruqJT(88_w{!fa>g1bhW*Bc@Hb)!yoc%E?!hu-$u$H{*lI6E7 zh`ad%)P{RHp_HI|eS@NpY?e#dskw1na2;JC2>(8jaxo-Aq+IO1);)~>$20%`!pc6j z_NYJgz5iVS`$Me5MI!HDQWz%7c%VT0|Ab0+{5PUp-}eh$LYbo0B*OFyG4kZ*4rIdOl+Acr?qq{|t9YB(8Z*(*z#O?ky6_fTlu{!gg1M?Tr7HwQL~Nu>Vc7xSXkN7<#-~xY zT?`p=$nC*F2`xm558}?!{yr=WpPqeF?>KMX*-nzOzD;Eq!*rzG*yyah=fZ9E-Qo@7a7U0!htW+s~E7 zTN@gG3!vE{H*Sh0=FASZro>`;8|wN2>S-7O^(zqJaXFB znN-s>P(#^&AVEF{F(Hs;M#GWl#yJ+&G0^Cp8nQbtEcy&@^)6kfWK(6xjthliiF`dL z@V58j&O%YGSI-#iPQ~6eap9-2y8nmy=wEeHRhK#;2kuA|O;#8-t+QLwZ#S08(pTU9 zg_$ASb>D6`K7MhpT1& zjl+$t@UFM+jQ*bZ5#duh2sh0d|vM5CSF>CV#)vL_tv_nyF3u*4|eI9sjJo+JLc ztRe8Al!ap;6lyNB!5YtVO&-0dOT@h3s5-LaKG|U!g(z;{>|92ZHPsx^qx)Mc4R?C> zvnYb88im1bb^KMz+O;@$P)0*%u$yo@!f)np$a6*3S9tydv?LR{;t70XUuT`7r@U6$ zCL((!oW>@*tCQ+uTl?1ySjgtDv~BYwM{6LF(A&2*P3o&ANm__pKP?G8U90IN*r2O3xOy~km_ z6#YU~c+qq6s={Gg#+>gfe@-r2mE;KLEoC5m#gg_U8N@@_I@cMBkZXfhAwpo}yC!8eo_}0Q-)3G}1`!*OP+oH)XBHU;>MxFVUiZDvvHXW5s!1zHM2LZp3Sy}K z;p1p{$fqz;SXMAPSTeyhM=*&#w`Ns;wOH6&&uH(MWI@rywSiS;dBWL-OA5RO{GL6R zz1G;!u(Z$v4!HOxtBM-H>8?uGds+fMGT#%C>JhdO7rEqd|JE&- zfzS<(Q9sgZ-}~~OoUz#>GZ97Np4n(o6}xDV5$JuX9=Su1o>AusZK`$pb&aL00db>* zBs%MO&sUycpLx1=o0A-I$pqJ4K;RNVupU48vpXXFm|V`OqIN;>=>74o=>bH0SmQ+L zL5p0ER2Pp!4fG6=<2P41C7WrYTMdu@j1!1?_iKaHUR&e)9fHupriL7fP4*lz70CKs zT(DU$%^Ap213d`C2|3lY6eovx)(2Zr=>uqc4HvqvO5UrVgTEH<`fV)XPGXEJnFu{3 zG~>_2p{_;Nm^kx690GXQUcRih?N-*S@5x#(H+>^ zHR*x)NLY3dkbnb^h{R49A~NTZo}R`L3HU?j$kf%I*j+Dlt^QG)`lJr%7(vK)tj~gT z2syepA&1T%Hy7(UPz~&A8|Ou4k^6`L0>z(cg7Hu@Hir^_#4oPne(jg>iz}GP?q3B+ zcmb!brw(GR=s-tZq(|#z^EX5;@rI`)RPk7h=?bOJK1s@)HG|p8RQrKXLHzxrl(RckrVFv}v7DYU^TYcOn-8ikdB>|7?z`-%k@4jrfsco?XO_Bq z8Tpp_~haJgi!4h zCr%tXv{39@6blk!f_CPzJow%6h2MswAGET31#>kTwl2}-OVW_%OO>8uW60OYuh2T} zL|E`?`PWBs^ZVR&a>K;EF+i#+AvI}RD#=INrdY_`XB;XgV$d}6ac5tjx&V$jsBc=L zyM15gALMBj8+Oh1?zlW_S>;XCGhs zV)gH`7kC&a3am_*P^n_FZ|E2J(%&WX8f0w@KK)L9rkbiauWA&Hf1TH}T#k90Bpr6> z(?9M$1?|$3#fzhm#pUn6a!==@OQ%gg&5F3b+WEvB3)@$#EL9?|E_}sG?zoh^dPgn` zK636qKk^DKav_z<2Z~hPCZZ_WiE9i0FK^d$oH-&}Cb0PpecIj4FWzgNB+cKV@YwOl zAyF6A&Afi0f8FK6537iTZ%#x+golSGxuSGaaMyqOO}mK){{GBXr4p^ItB>!6zco5Z z@(|74aIZ^cXYo>{?0oIbn=eYZt@OJGu`fWh|mJvv0A-m{T_Mw$cUvyi#a&5L*{>9CLSD(JeZqb{ingK6Gcy* zkA44#@&EPe>?(*#Gi1g;=!bt57sj1?K()ce!@Vc~E%9|3$2asODW< z*gBc46$W<>3_f{aJU8UDLgqB3j!PSsuHxX__lh+}#d)FN^y-cayM^bTU|ThQ8L?&S z3=A#ES7C_QGoJRqbiKEzOW3B`|<=!@D08>v+!Zx7Pdre|Xn==gT=u2b{T|``-87 z*S@Z6KcT!D{`X7QgKPK5g#X^b(0`DSdl%C_*~3qe;WWXm6fAsrF$d`9eEm=U;p1Lp z<^1y0@aXAXY0tR$KOV}Xkr)0OwkhQUSv0JwD4v_h!2gMFj29$9)q>F3+=XG*YeeKo zT3Sa#Q?U&Onn*L)ZEq_0dm7rUUE_$|(P2gxj!?TEFhoRB5A_JVd#ff?Q>#FhFYi4@;?-^(On%|D(2Z?QHu9H89{&`3Kgu7< zR8N2BAF^gSpd|`2am2*_%js=x4ZJ^%<>zIndTT8#!8Xm)_9GZ{-Ki?W$>Z3xsB7%( zBqy<%*H9=hWZC;btW0vhe-9S21(}{wG~}DsVGiD53e$=E~Y;^{FB0hs!fVBy3tR1&2)% zO!J|Io|%!6Wn2fgE|*_GIWHc_PW$#mhMz&9Q4jA#G2lL)sGd!B#JCI;@1Wi;QLl7= zicje7>?|rK)+|s1Lug=rKscvL-h+Oa@jYKax9;lV!gl99s48u&tqY5aiV6#1xrV3jn6K)C>-4V9T4E+4%Xb!Iufla8kit5BiC% z3WJ5=;o%e%6d5%@0El8?WzB#VEU2g2D87Ih_KcB~lxO^1*%T#O9yUBQ)Kf=TI(mM@%yPQ?ILObVy3_=9;|0Z@-Mb4{ z^!yt`Q5Z#+`BiYlvd`9}6xVjj3f(j7>sqy_2X0^ibNQ$%z4 zwHA98gEVMmR1*Hi9Br2B2whrj_X)dUTtu8=cw=*!?D+BHy0sgORTN_!K99UY2}zpT z(;6EZ7UN@iWs+A$-rZ2OwY=D9rSb$o6G_bJD|^PNCY%@Ip+gh&NIu6Pz-R#cxuU0$ z7H|-yy*`jXoUNhX9f=8O^jC%)@c3Fe44}w@pN@c8K4cRP&fta}gG`Rfz(OdyvkK&- zAx%@$jHD@SW~_JsE0nb^@poBSS*^hC5vT&so;?FX@INkbJaW??i3PfHJBpOXYzM;o zmbH_O*Pg0cr(1;2NQqcf)rnE?4b^R=5kAIIqXt^&7&|y|; zszbV)-AG#(=ggQp%Q+}BGuwRJT*=SAYx;bIm?Iog93Yu5a^vKZa<8jyL%EVJJN zGYpQg56thYwvv~Zhj|woLl7>}oAuKJm8}af9|BqgJeedAh`+t$_am3+K?wJpAzv#B z^8Jx47{e|hgT9UXa_uvq_~fhoi@oGK~G0Jo5AJ7&Mi^ zWY&!g6C;%b15VSyi-vY8R`Gou=}+f*bzo|1zJv-dJrHzu>CM4wIm=!6!jsWp1y4pJk~vx={_4 z@xHOzkJ*9`%I%c<4g2|ZA(GGKvJ0U z*B(M_bZQe!L~Ejh1#Jq9)Ya4?*i%%BR#N6ENLK+Hs)D;OBN;U#P^zdf4;g2ne&+ApbA<=YEdeh;amMch_JTpuwp z3fMOEN;0eRB(NGn(Y7=i%V!&ww!HRymrtIliOJsmXjIn%VQL>Y3%Y*kV7iM(SVwD0 z&lLbc9s8LqOeJ$c1Pmn|0hQ4~Lc-aZgz$Re6CH6T>Ln9=veplv=v-6gn@P?9XU#=ULqFkR>z7$PcVMC;K!*wxr@+)&h(I_mnj zZrY4EGjoukN$vAhOM2;;S}2?3b8T;f8DUhd{^t7af^$^thMf;)eKmtPnSFd@lb;MS z#B{nG%OnyC+?g)*{&OSq=iSHV*ZhS>eG)69)+9nGismbCn7`n^LZ&xhI#liOjGqEy zasyNuojHcOdS+NbEsNzDO$&=fz^cbMMXp};rk7*l;Fw2ZAy6)$BR}4qpV@dN{zXM~ zHMkg@$GrD=IH5Q_J>A5r^WhYB9X!~FYmmhE`>PEy+V7>~NBI*KIMZ3Fq9XllJ>of= zw_0os#0U57`}?4cl5yYW#>N253^cV!HOQ-Z{4{;$o%%xX^eP8gTe9l8aj1#?%oP-l zv56UGnqe7yd~243rNJog^RlsMBzYQC(saYo%Hk6`a|~7jEO%b3Fd4o<8y_TT0#(DR z@ko>_#rj*e1~V{#wAotLm|(|T7=$XDy!psF7Kbru#)l(7LofAQPj%*!ccD0UR=EuN zuo?>X?BYzqX^dDu-EN(+Pk}V(}3yZ@oNxq$UjnpJ?GUn~VJACOW1(*MUg|7YcZ zp~HT@qE1Nedhlt2n0piZmaofXn?6w_`dm;&pL;B%==C zj>(deu^5QlEPVSL)LNWUaseoS*)jqAmRY>7bAq2;Q5=j8uHRZ+xK5pV^3ILE=ZwU1 zyrb6~i%Llu8X9^*KdiUNp?M|u#Z)1ma5;|Qm1>-SPm#4A467ZSoK)eY1P4G!B0-XH zttk48(cLFcpJt;KPGq8izS3IL-L16TI?>-BPC!Ku>C=rHH!L1Aj_v_=T;XCu?l)GRM6gHrKJmlN|zq_(j~YK@<38>lsK3Qx9E zMehr31zpe9f0X_q>Ic6Uw;9Sl2C%@Byg5ee5pZR~JgDo2N5s%%oJEIP+fD2$8h!1! zueEIwuR9pkN?=?HMigpium##xwY;A{eae^_(3v+~Tk7xh?`dOJ)37OX9Dyk7Hy<`N zSD>x86~PM||AL{L88>?hdI2;AjHg)0D69z+6tbM@ZyGT^(LtzM%_%16=)9?woRqYp zQLLvr-N^k1aC zLPAcGkC>lS za^2AJqklvLzJe!g9@{JUr(_#@LCa#j!pVOqvq1}2@`yHFBIGVu&C5(Q2=yi2j$A2G z7F0VC(V1l#zZTa~sHw2VrQel}jsuGixzzR7xiu5P-uRRT#}0kCHx=%i4(nES%}vu_TP zwRwq1PYkQ0Y*wCy-f)qwVIConKa$xzVfmOEB5>7*50yPV^oi6}ff@JNwX~hA^~-S! zIBavCi8^==1Aot_p4lBrf=%l|?M;}3>dTIJm>=LT= z%fD9Z^)eZN6VCWV9wc2V$jg(7`w0HB6Im9X&E$^Ba;Xx~X>L8)N%82l$)lxByCvO` zdc#>tM+ME{q;~o{rut1~eGmMy=9UOfcD~m#{i4^(58~hRZrV+sphQ`K79y{6ml7>S!=KxgA;1v9i-!o{MrPW1lR>gxR3o%BNPf!g4{k2)9AZEb#2GxWWCXXlj~K_EsUkn_$OlVVpCIxaYo zWuh)5riQYTODOf)uw8$IK@s-Y*|mDbE(B(TcfGSXe${ygTV#zh3kHY7!6+oQQ>QNW zlo&z*8NFa}xgk_weSO`_%PTtq5?1KG9y@a6tp`o983IY*Z9ytOK@tFhrD^Yh^i7;Z z_A?_3-%pu(fGFquhmJlb%6!v#|9&qG*sBfsUTS83v&WAZjjTa;OJ7K5k)vCB zXYOwg0mNtg)I^P+D#dFlwcSisNbppVbUh~D5nY;jg7@~~Ba9ciGp=g?aYE&l`Luo~ z@oYsCmO`oL0`UR#`cH>*;oEu)p~YB&&=lgTc?e`KDu8>G$t9Ncex5v8~%!+-c=FmTKa+f0> z*z~k+v091u_4V#fPL?on?Jl^yq$ucm| zL`2Qsk9UmV_tXjR!cNF#X%@bsi>2wOv?@OV#PWP$7&VrIqL)pgsiXWdI5-G9Vr6NG zh797a#!uAj*B5^-HNBn#1gQ1tVbYJvKPM3?|8#D%+WOj9k=}g-1Pe1Wpnp@P-F)-X z$A_4R$m`XsH^$WebujkkIAO6tlxnD3Z;w98-TUHSksuz{ne5M><53ynPUPA`A#a>) zm|nel^?ap8Lt8r)1S0hGE`0~q9$Y^BD?U?-pa5TXB4{MTchCty1{lu!GOea zO!@Bx@{g?n|7Sm-7UUmN1ig>#`uVrNz6`^zoo&8?lE3`b1Errg=`Vlf4oLj>&#j+v zLG@L$xb@G-`u37tX61ZoPr22J_zOYOl#Z6dlX{ADB8;|x@wG#lPmi4E5AC{r2Eq4uWyhp(D%2uSE={?q242z>i)M`ha#UO&<1;oX;&4Y zg-)Inh?e(@3m9-&JxY-4eVJNPpmhkMqWIC;I2!nfUv?tcGy)al5#-a@f5oQXsN8@> z`)5zXuii8A8*(evU6Z6R(Dz8)_4y5G$y|tx`1@x#^ee1(XbZ4L%K~EfPgsp91mG$4 z^tv-=Cx(*;xq44Loc<(yexH^M0^R>;;UFD|?+dp8mp9E0c2YO5`R}cyU-HSPzT$us zYq9Vx&!QxpsTQ*ano=-dONcNk3ELisICWo3OAl0gS9 z@;MD+9b(UY;>v=j8;op=?O6maQB%t5W(VZohLGy4!#~%NKJf9))5wSjAPtx`u!4Cg z5w%2|+i@nPJhM@$q7+e~flr^riA^`wETJc4Y-|j<5&Rt6$sf`7V*1Z}{DCZVq&lF6 zWxj#&_VxyX!6Qq{oBkK>S9{X}>k4#B;@7X=np#<1g+}mZeu+E)ckl^X3$o7Sr-&&KCR;rt7OyuCFNd;#PY^@GAW!12d9E8X*RhdJ2iFLe~Q zglhefH8m~Een0Q#Rn|;`PvNEhA)LAv)1S&OyLJ4)U^6hOsm4Gkf${W{!}uS~ydD-5 zf{X>&I8BBuFv5QC-d9Ar(2(QW+>tugn391AcP5AX@EU4r65+9A*bdi{0DRa()+v1T z>aIO|0^?!Cu*%+j`_ztYtM}o9c0tn*8f-S+o)4k4IlmuZ%DS?j+ef(9RL4(bDi#>{ zu4TQi6Ju;U(6*LKZP=TUR9ZJ&8*=C{3qPZPO7663qw)0tw;&=jTSXRFjQQBeuEQQr*In7ai$fDgQs*}dUcUcf-?xOpf9 zjg6;ZQwFYl1|Ytsxw*NumE+W@Q@p%^BtE}Yct3|8Vy^Ab12@}p-(y@(t~>EfHVB7h zICA|TVd!L*2A>mFU_m}{FOiDuc%Mzljbo8P%K+Eb7tYJ(tqhyV}{b5i|ZzI-s*&7&prTL$oRw^6Qp zyW6-!+QA3?OJ@N>;PKO1a^0^m05RH5m-lL^p=M%psPu;QH{W05(u!@r!iLW#i$s~InG|156uK!bu z;(M#q0Lj$;(X>?J72_m@8P~X6@>Iro_+085V+`U>r4euZ`&1lajs2gd=7 z9GwpF9eVkE?+J!vXdf7Dhp;Xos=|XqQjqI9u@6;Je^A+dD*Fo_;(F^g- z6~!AXX@C;}^l1jzX*3J_+%&DUi2fqbEGfpK!~21(!mj&CXmeuoV3ed>2@!cWt||4! ze#=yhj+h{as@;0_QErXn=TPo=IeRsxU3^d-2@81-ft z0PLOt!rGVQmpb)Z@{9qdX=)l+#I4Uk!EH5~1ySr*borf9XK+3dKYzk?{K26&Q=Goc zst5t(PHnvoA@st32b-@qCS2%LfyyecmE6(ivWSQ6rA6hU&>)_8)UsNa>Fv|U>(h1) zuPUV|VPC$igwk2Jr$89yO+}lGwXnbp$lgMqq$V^}ZPR^892|RMZc@tS7%1ewZqkNc zgP30(-P&1AMrW*Yu{E}*rwEk51#X8AABK*D*v*?o`bGW-Lk;vcycUxNbGOFA(=%pZ za8?!5%&g+7EOb}14v?~6N0p!^0+%HzS@^W>{eqhP98sWx^RqO5O3>)-$e&R~TVSr0ro-p1@XfA(5#;>))E%>0R*8`Db? zx_x=0PoMS~dJ`LV>s8_3o?-3(aE!-2*8(JLPl_cw48{}^hbc)hAB%Dw4vZ>h4zI)Z zh864&&@M>o`%>(T4Hye=+_|y1NZDuo&>Mr+G{k2}eftaW>q7KSKHR9GE?5R*ou`(< zUQNu7vtJhc4fEBcVif2tFCUuan5we6TK1*1R3t;KI!&n!q)|YtO$Ky>LV)*pKW&zk z-4N$&e1MQ$u^BXrED=%~M4OqR8hV+y3n-lYdpAE>r%&wIwOj(A(M;KYr}il5rZ9u9AjBNr(opYMz&*NamE_Uwf`6 z$(<#vl7cLw9&qzs`T-76@L>8Dfaa^k8%ikPoMP7(<$3_7YFHsl=M@Hn##$o+F=+6O)SsO9bOF+;zsR!^n!uZ%pCY?*$vUk(BOfi*ZW94s?k4Wp~4iV&S#+i0q@=? zG$&j#?;hzy&#%+39E67AU&vY>rXbZnZynS1a8|U{bXqDRNU^*=q>GfI`mNx21y0s( zA;rZ-tfjV{?vAOn2jJ^VaOpBBQ|u=&I^Pb{pX{J9K51mTXY$W5ZvYd{8Nf;4407mv zu-_a-$Sz-BrI&v$DC?c?Lw~)%ya+H^of55g)gF=baw$=2C^&l*)@ceCFFp;y2o_t? zFTZb`5DHtDeVzq|!4B;oVotsox^<8^oko1 zON}8qn+tm4q6H-r4D zD}r(vTmS_(OZ|!x-|B!{FUSKsKT2eEo>79aB$)5sjarG^5iN-XjCcqq=jQF$hL~vZ zwO?+Y6bQR|^?-+qs`~vfbL4rnCfN1X+zbk4)0CIE8(Cp9!b)hpu>4ogwdP~0wFDPC z3N16`1Rpgy}^Zm$#GukcX4bEAKcb{O-6hlw;LG;8bQ?vz4GkRJ*#3KT;E zJBED?;oB&%hSw9SeY_i2FUepF#Ghww)5@hJ6^sO{$lnwwn)}KfO&swua#UuB zy`{h&DbOPD5kPddZ?IqhjF`AdZnp zuu#vp=nXm3x;`J*Ocx&Rk$4SHv1tTBVu>aip}lgB%q}cVp-W9?X*{nX`URhbO%mq` zwqfD?yw2F>BbiUts00Oz!C4zFduWJ5Y+D8eN>$y&_m#sF|3>n(D@cp_&W$UUT4L6S zUZdQ-%+)BB6463{H_R)_WCBT_Mm_-T4+HRBi_M3|(rc5RS`oSxd7)Rna!{?vRP!Ev zhRkH1)DB~Pl|b#hnNN_P-ki=cCM!sgJ}&RyoBMD>sl;jmzt!uE%>9@iXP5AOViI)d z=;%tMVJIU*Zo|oL?EzF$ch%jsalVnBDEQ#FEpmWDkTO{}ajT5GY>#c)!QY6Zws=Av z&0Dz5GPLigT-AFF-+KPI4e6hAanKGen)GvWMk@)&pTw&*_cp-q2{QB8K`ZTX!#t^+ zC*eW2@Ra(e-S-YcleU6cym&b6F{QyygujR2Fkca~rfWq&`(g!FKpYR+vVYRT1PPP z*I%^rf+SoLAmNAR!mS@r#XTP6C&+-Dw@ohPrhoOyD>8BRcNZk%+5?s1Hn|k<;~|jFpXIgUbs=H~`;I)TdAcj#HSKt> z;o$sGBH)#tc61N*wpcs>Z)VeWBP67})bwK#*+1TVN^4}!Md=e+uIIaV*OUq$z1l(e z{o~x@`5#!K$V#gb0*Tni0U?|6QI~t7JEs-YFTeYrgPORRS=PTGn5mTs z$}pI@9VCE8fkiU7jc`Bu@-Z$hE-Q<@C$lz)YpTqNNN?cz{^Kx;SSB^GsUa_qTl#sh zkX>(OWo1`aS51vR{G7Os_|z7s`mdj9`p}8sju!Y+D{%`8r~Y!KHbtf!w@*;9UQ=WOBnM8JT|DAJx=nqfk{PfpRFPX zu;F;QxtBn{dh_N@pAyvkWRK#ae}8{}(+NsSyLKyBTkoR^VeGn|jaPKlQJ2T9Tdcq> z4tzQy+n~$=>NDUa`l97Y3Yq)@0?NwD^+;PWJFROoxiJ8#Pnpl%_6(alg@Y%9=R5BsUwvS^+? zdo~jOEvN#aS-@>EN#6YTcGR@b{Aa_BdzWt|j>3k0sr)#)Pt1sci@CK$@$_jA^dlJ_ zTQ$EN1lB|t$wnV*#qsx%!BEkpk}-`)k$GS_xO^N_F(cM<0P~{i60Ur#o8@eO0tKO}^xq(gqq-9003IbMhx7+|he0jF4ynK}6^#4F= zec25AW9+Jvlat8)S0^{8kF#ml%QPes+X7>X?oNVuF!$}YcW>W<;OHDZxQlhKT0k|D zl0(U3ssVcRfQ#F!fEP>#A#7W_fQQGu3rf_k9J`L<^>+Y{fw0JYrbR`UM9B6L)E|?R zK0E&+wVoO6YGMUMANV)k72nvaDn<-!qEESagx4LY>5)BJz57pVTSF)|w=i8fD5m2*-h=?fK1ga~GRlo;o{;$t!l(R$nT?+HSw1 zcl@@{phN`RkwdSWORemo?&vgn!PaWI`nE2=*RjRYoo->a1p|wFgBnz?zx2gEtT1*| zwq7esK}}FteR8^H_D~&Udivna6f5D;yD|_}FcegXYZ^+w;-m;}3i$X@3slD4g_>9Zs5PU3y2A6CR}Q#BS1wa{^yEds6k9+Gy({9SD`gUg zEoWsjM5pre^2+Qo+hp*+!Hn^@6CPTm7Mfv`F89! z)aVq6Fw2^h;RwjNPqpjJ3|3i9z|^OJ>!Dz=2xRLNrThp|h-IK*Jwi^dly5o&-JOIA zxZE)qOfHxzSS&g^Is%;)DC)h?4w?iFh>?*|2%iO~70vty`PPS6;SJU}8+t)OmAlXs zJcm)mpy~<_{l3!M$Yh(wePF@_EdAW(p(WYLosKUA51_kH#(3&(^4;AwVQKlL_~Ac8 zher*TzU%;c@O4OHQj`Q@NP%tX)7OiN=RkIap3XE zHKWMF=!2z<%cn$D&XadW)VIPpvg;P48qd_ahKNgjvgRHEjkKY?kb3;^;deWCk_C*~ z%XAi@V*!ZDHX!MMgK$}ZJx4ZqOhtub@YWg8A%dIvtg26j3S8Ut$JB@!wfwf&9Fawv z!AwAf2YZFZnHeB}N!Eu6ZI&NbMXn>G4RtUzO{NQJsTh3*9t8lXoMmI1oox{E%LT

Fu17XsI{o)#@icOTj!yJI;N?j5^5ENgDH{w);ph+FD+&hKPw z2auC7Ljh=J*#?fvN$7$i)nwm;bEM{rHv!KR}<$>79&0Te-v z&UDl%RxS3a&V%^2&f+69pFzuLO0tiFvvkuod{FeBI(Q$QB2rv#JVM z3yTYYZ&XvCJ2&{bG1BVF5ZrL!n*Bv+26U%_b{mCylrRfA?9H2JyXHZz0NdXba7ig< zaDI~xzr5Sf+psZ0cye-5bJpbH!yvHFg`M7_NcSm*ikn*=t+!ttg^ZoD3J40Kx2u`` z^5xbGPoEDTK0x@v*m+J-L_~_hXynWlw;gkig49I1|>=I ztF!nC3qP>TSMvyLDfzih(HB-AM;Y^?+LsXxYU@s#j$|PT2M0mmK`RK5&Z8u%pAvHJ z|63>RVS6Q)F%>0G!8+*U$3o12EVnGVY|Y6iuu)MLhMHPF2TCcWHBxMELxY@z$yyl` zcKX$|Cyz2%|q z9YDV!c(B6N^7dG(VCNm^bFZFju5eptaKerjWJK)} zGb2fEZz<2PhJ-f(2-9mJ*Nqu~bq-_|Shp|BbPV7CO&kqKD0mg5sFrL%1A5-bsPaFT z&HhN~+F5n-^gpu{zFl82psMK_ItzIKo3$qn>$=WkA=Ogzm93g@3tP*9jEpJcCWv>~ z$lgykHx1bF7taDcqbQe2iQf##o9bQ?=j@bKno}YU-&KRwpHoxFb0uM`sHqv>Vt2|* zH3$tw%CXBdN%XWaUAS<8hUWU>FiKwYTMhQRR(XWxJ4Csyp2fp^Q7TjG9_`IwWs%t& zF{y>$_O`1_G1;Ii$4&RUuB7yK+CRkC&4Tbv@dvg1Up#x)KIJkJiWZo3%GdC`PU2 zNx)FBY1aSW74T_T1owu(JMXKj?`CK?QJogvR(+@KLR8;Bn029%_Yh7Zf^9?SoBV|@ z{Vntnk?^qaTFKHXh`64RvU1LT;N<&1(2)28MKV-CJ$cY|>p@a&<9T4Q zFcij0yX~!Ot+%_p{VRTG~u+Kk;Sv2sOySr;f1=RJfsY zWu*4)kJYH)`MT=cG;1{n*g+eK+?#>+_@$@8+{FG6a(X&41*Y!O{%Rw^A*2AZ-nDJ( zKlqr=B$y(TC+h2RCOSE%F;J{H0p?-OY%1X>WeDPD$OhDJ23d>c_FjS;8yB zEr~{dH`@3bCw4mHl>TPn6FE-t3t@Nf2J(X+jlTwqR-ke6b_gDu1wt(Fn>4hvj-e_I zcDizs7VAGclz5zqSYWBhs6L%{d2)(8+!|XP&oarab7r^!QnBg^LaGHDpRIQD7CjfVA znMA}L=DXr=7b!k_8D@Fr%$dP7FtQ9(LBojaC;^aO7tJj!`1%0`m9YWt`n?u?HlTP! z$p;$Q!L6Ee@68jnf|zpl0u34c%2}Wt$*5ny?s!Ln#jukdD8N*e<>i`S-7ZVA_T2mt za}P}&3#PD;A6qOPD*=w31%A2;5{#83u(^6yicZ;JtmgF|2Z8nRU5Uji>ae370?Hdp z1Atl*zFXD+vY*}n3{1T{5fmEA#2kj6%tvp|uy(fE+vCCL_Uzt7IcAa~xfG>WU|bQK z3!DLNE2HH7G6345F9BEygCDsp$3Y9f7WFkMKWN*${_W(iMJN3Y@g!|jpge9&T1NvKl!At?I^;VC{@^RCb2rx7cCSf%g z(~I*`65%~ViK)d+H4$)r>N#0p&V|*DPN=z=#$h4HaKKFQ^n--rmHDWiiJvS@RY3w^ zzN;(asWqYimOx+_yvV{gZ+V*$QgCU;-4!^7!`T3w@^}XeJ4^%14k*|%4o#P<+MKbV zymFSsu$AKwXcisp>vC304p3?+7?0%z46$I~-F6`!2MB4`V9uV;d`E}8<#>7}g|u;W zbacF1nAI3@6vDMVWV`-EX2%5u-a^o zMIV4R#}@svd#`^edQEA!_FcU_vf+{SH4>JpRy!k6GDzZ>usc?l=q^}jm|Ix*`R*k; z|Gox75;c?p(4@}5eh9yk-4JO#*LV%stFSXE_u%8#EGQS4EyIayQM~3(J_@O!!Bl^L zBcQ|Z;aj1?tcUJU4D_W zz+5ljawwQf)-npoC@73#q}UYL<7LJYWa6cuj#aT+pLaRVJcd#Sun=axzXyM}ML4Uf zc@HiXW!r6Tz(bcwQBtt#2)}|4zyv@pH&%%x`A?7UKgMuNn-aEeq4x|#h(ymb<#K`H z8q&vWzI=p2)HCwNq-;o&wg)B}&fh*Fa{z6*0!lb=4F z33*i~<8n0dcqW^b#+BP5`>?a(MM`yI@&{h0fot92?5 zSg^M~hOYmFzujoG-{42!#d|K;fwfFV%1q>2fW>K<+mjU3M_4dGat8#h5Uj&9HsDOX zFCZTQ(OJ#~fM@tQxf3d91vS%WRNQhw5|1pqgrF%5GB;oX?l5 zY1~5-ZQaSZBrrxD+Kj9m%d4w3`5NnRMfkj012Py{n~~X<&+fa5_KSYYp-M+L&muNw z@cQDHfw*5mC@cpy-7`r46IY`{1ki0j5rBvQMzg+tW5@Ih(9nI0hc*tKF95TD>o&Z9 ze~T~`2iiP{ag)QtNGoH=PgSMBEFSh*lOR~rf)i=HoB6<1Fd0Lna!Dm%9qHgio~-}} zmICH}@+9R9f&W2>pNB|f`UMwGoe!@at-a}C%Rt`|pn4PV(18|(_d#&wj9WY;g}o?H zey2yAiJo4pXdaL~(DRBW0QXo-Obna@#9?_i!6;}Bd`bb^o5_F~WHZRfJqoMOr+YGw zUemSmys69(IRhpw^da72uh)+2+z>9?r!Q3?lWU}Gi3N|E05)v`N<0SpatcbgUtE|I@hcaORL|X6)NHmT~!~$KAgd#yt z!H-9@E!Vg&#YQLIdUCLtksh!#ButZfd3p}lhtM-Z5J`{s?|HlvUjvt|+pGm#c0j4` zV6?ThYkc&&^QNKwP;LnurGJNHm|*hcrv->Y%5XqaIsuOy%%r{MB^eSmW=0Fj!ST8mhI(#~0Iw!R-qO!|H{@WxB@1wmEHMl8!lcc}q(VI4w3hg?Tg z=;@Ou8n>#7p@aO=V+^{rE|DV+$Hh_`3dmBG@})>MnLOt$dM&TTjDtksU1!|^3iC5P z`>p&S+ecm(X_tNre>C^Mrt*7OFmMycli4$>6w1p!dGdsSfkti>(6MGG!ix^nZ;CaUZj7v|zPbOU40^)?uyaB3Xx43^fa-TRMy&d$SN z`usc=+7xzcH4ZjdEyq0z2zXIJ0llA6`yCl?fDdTy@ui+`N=GuBLO;$(dSrBT88&yd z*!+V#;6`zc+;}M{7o|N75u@UuAZUS?B2Vf4CRdX7HaVoev(aFTUX7UA&E>A{dqmKOh zDlckyx+a>K+mRxB_wMzb(jU7LHU2@I&^$egEJle0C2ny|`sA(L53sfGqEI=#{*scC z#~a2{Of&pkTwE63mscwq7g14%Ks$X%I^{X|+dO6GFqKVJvEdRrPvw>7Y)~J-RtX?> zUG&&_)YuUZN+FfHeijy%0)bbFuhAEE4;!Zf=R{D9eSgw>g_KFs;h zvV@fn2x;998uYK0c zIOHu%Akn%LR5V-9H^T~mavO9Tm0=QSwkC8PS=re3lVvvFG$QWvy2GqoaBh!Trl!bF z4FLH&AIQtdcqhTpR56U{Wd+$o$>yq%B^XLmj1Awv@`B*bX~N})(1tBn4h+>`L+&-m zQwLyt8pO^s@9sff=POV5qzbvzt>DI+3pLlT;$|n#t_N>YHT61a+xpDR0GD&~Fd>!B0+DFby=w>-CYX>vEpw*pK zDovFqZ4eEJTY}F&ba7m1FWI0P2O*g3;~X`s?&L<7=!wkU1;`H^v%~_Rlj}p$sxz^h zfC2(Q`=mO`eg56vom-XlF2sBi(S~{-MNwp`cOZD_PgZ$dq1hW!T8P!(miR`on*{?X zKX~HA^IeE1Q&?VEQ7L@XC_afO-!tGMIzK)pA_(nC=^*4w_q@1KRQvwDzmT0RwB2R) zZnbd@>9PJju+l99s?yTZcbp?iA9R3Gyhag#;d+@6R0Ex{@zxGjs1eA4jt~(=s=!g3 zhmISk3zoKOnAx}Y4OBB!<6v%boA!nn1M!=vG0%<*g+V=AX0iI*i<`{*52tt2-Mo6F z=I|58C})S)ZF!8z6SC@iH~gA7JJGKasQlWpvrOm>&*Y-+U|wcL=;@|>d?3bfhcx@D z`VFxldFL2~C874U;C7RoU0x5h&QC4stEfC2u3fNcct~MW5z9uEb48zpkLB!!_cP!< zRB&r)t2b0c7#vl*2c459{Rd(t$=Q^zmYZ=5q2aySNvN`$-iMD8*WEJkheeCY02jVI^gX36bOEyZS|ApS_~bj04c zuW(x(l=pMbB=oD2;nKO`HUYgI#Lr=YmJt$$XqD8>Nz7DPYOD1NHAPS~Hb#Tth*Mv- zJp9As&=_)_7v3rO;G@0#3}iFT3*AsGNLAnvV#A0aoI{^tt3m$|!@Yats6xkjRvVUy z9K8-pL|Km3m9U293-d%fVV(9cgh(M*UW*ZC`h@DO#xY0ibeKD`oA3~&En;QbWDmX1 zET&&1v7vkRXaYhZ)2+#UL5mBh^AMtx2Q z>FSkbWo2-kx-0`MDXCdlSd6}rh)$pT`~1P!7APS> zkLjZNj3%KBC9hU%1Ybif8^mM4{V4yoEs}_5pgPz`eYpqz90(9mrzB`|v!~CprqooB zkkZuY%DZ3{_*n)HCWn-!mTVw>Q|BQ#KYC43PH?I8pVg($P!f#SP55=PzivtxoWa`jpzp{29+B$r$?CR{G@5L;EQMt1l?1iRg^}#$+ z9{poubWC9#_n~-jvsi+$w?OQ;QI!6fT@WHAq|q*x{m7i5(L`{41Scz*&ilY{gHGs`^e@1)X0c-5~-eVFftm>64C#EsNcj#CoZP+O^4!gGpX_;vF~n`Q7<+V4UC!)(&b=oT_QTsL^B3_sdoAX2GeQ^`lsO; zLgxVBvsKt4qUxiK;?B~ZtlCo7^}#lpvoqZC-36Y9wDtZzJ{&Na3O4oST97egzudh; zhUPq`nS5wk-J8>!)f%Z6=W0uu4Cq5bU%a>mH))i>iA_h>@eGv19?^%S!zl*A{#6cb z68GTI^M**6k;3hd24QYlE+iignVu@MfVl%>))s4%w?we+1U=aHQGU|MOC^OQ$A3@^2>mJ!J z&;VNg1<$HTMO~X7U7NzL1Q7zLl@7Uqq(UU%7WNRTb&kHP3?R>BxAW}+#7BEozRz~m z5cHd&kvz~~o%5{~^JB6BZcQ}ystk2`khh1EhRbm=CNYnDQu`jC6te9;w3yXKP?PdJ z$R$JGG4C@zA;r-WQ22De=xGB*j&C{T?NNQ^Azl8KRu=4swOuG&$7v2Sljx`eeE{+3 zE#*KG0*?|PbmzK`8-*ysS#5vaQDa}zRk;LKF^L;DUfm5j9ankhtGDjg&2DgZhp^t! zh%f#p>wX2vUK^rK4_134KB4x?d@iicSOs)zQg*E44*TI(y&Fm(a38&71tV)%%FY07 zh_2{ECeB?D?5`>tI<^6Pe$ss&$b>I=U7(RZ3xOBcsnEfw1ycg1ioj(Ns;sjHyKV`> zhDP#uXku+b5&K%eVhZ8lf&l% zEj1@&z>PK{4;(piWJ8*OhFa5i){|ECG#z5J+Q$GM%-c>8-z|d4UEV^Ds`YD*`XNUk ze~+dpVkS#24sL%H^=&Ba@T^t7v7Z|j1sp5CH7rE0_OtK>9z?8ZzuSCV>{=Kk^`=GG zBCl&+E*m&u8~?+xm>dAzyT1auk~^QW0t8Gq$?Ev;Kf32AErJFA>yN@pjkixVq^ElY z_}9j&6rq7%6SC|{Zhx7*me-822O+WZ=zl`wp)_Qx8WV*P8SdUC9oIgLSJ6!wO zUw1$>AWOQPIWgFR;a6Yi?`^G_|8eW?S3`+=@H^#9qiwZng({TuO`lVee%l>*_8dnk zzD@bLcPmB&GR%(bOfaCC<7VNT*1psq-z3!hz323r{I`vgrmqc_#-l9iD7BS7wu$SV z+Z!KG9`T^vdOc;uLYMGfdp$@rng=RzKfS5L{?|7Vh@`gbmnOHAyI!B$@W6 zzuqzeL3-Or7wUVi{QiHp&1BPAFw(KjOhY)i%SuUcOLKOpty&CLP_4X5=_Vq>|?((ui+Q1j(qdkii^T3HpOMAI>Ub?BYu5E=8 zyl+P3NLR=QeYy;%qx@^5@!)}K*rNRQDyi)q*lLPQB4`Of0)EhU*u_~AjYijp&gS^r z8CP(pch@CL-MUq}aFRZX`0d-!Wp3L*b|Gda5d-}rnJ(@WRGjg$b&)0md*}sM{iYw+ zmW=ga#=U8cuU?&7_!4Kzsqa^Q*4aGfCNiV^RcL577%>#6k7zf|)Wy5-ndvCUOO+Rx z3rKFHNi!^u)J}tNlt`>>L&(wQ8UxSbz$8e3Wm0gmh~|G#@&F&ZVBE5;KZC$HlWb85 zgZj+O3~+8$Qh1N8$RpOw|LBpPVTOC7(cq^+1h!vxcIHsGzZTa;sz5lSkFxxGnlvdL zlZzX=nTBDgKtB#=z41h)wjuCj(P`a{X`(Lp+N0ge3c5qQ=AnU{6E}5%&dOzNGwxr8 ztJj*)YmBG@+TUW`a^92_rvCnuUYzH1 zbel7jF|p-u-$qCSeVJT<_sqD`ihD?yauG^~p;oXYSGD8|7&|zvtLEjU#x0q_#2Spb zzTJg^*>v@@MTL4~C>`$4Zhh_nQ!nDn{FO%mgQ(wi7K}Yvp+?{9`@X8`Fny|GZhe{| zh>_))rc@08D?gOH4$TAyDq&&a#>Pfq`uPf~fZ~DN4CoI{l>n(tvoJGD>OTJ-&LVF; z`f-<$ehoaIz`3@hXDtQXTfo}v*zBuUHW;(L9LuPtsCF2NLZewb8LmP~pEHKdj9gwm zL3ul=IsD4F&_3HkvuxToA6TR^6ydjZb!Fa3EHx%LM`p~YRr~t&Ydl@szKwJD)!T5N zi&j9iUg@%Y_L}rf0zE?^ano{~8Lu+rc4sF6V-JK2S!`C#5}=QRs=&*0@ww)D;(o^h z)FGb|${`#q?PvAC?uE`6r^fq3x&YeFt33zgT6rZ8h{VwGAU=MaKKao0cYJX4pEtS( zn87wX9^P44B#^4SnFHTc%(s}CF*s}~G}ZW|WW(KqWGlYPwe@K}*=I>pXZs7|rD`Qa z8##=+FSc|g%K6pE5d>C(6ntIYnjY0!m|wzfcsLZ5_gKpv#Xs$&@v%n|>hMu?8)iKi0=s-2;a0S3% z8z=@sLqm~~(D@Hzv-m*}4yZm*ErAAo^1?lP%UUDIx77Lphb*^-f(Z&K7nd40GOjW` zH9277=ZXE`VN60ov-MMEWQW!9~NI8atO=)HRs)9&zG07Ot{ z%BOfy2F)ow&DY#x+{qT@(w~(3_ka&G=z~X;1=MU$d8NAMW}vRRu)wF2WKd$KUtQ~^ zFVSd89_P`jJvHmE4A(Pox8ZXw>2=NY&9asAZ2A{fYP@J$c&EXqr5%~PXU`s99v-Og zV}LSUY@-<43`f_fN&xgk>V+}oW_O{T`e~94W=-plvQOWUl4=6SYbeMa^)fW!98+_Q`!>MK8GrZgfJz*Mvfz*q;KKv)ok=T-x_1KXo}g15 z;R`Kf1zxTzr$PUbqV)VjrPS6GkguKk*IO=IIXi?Ch$6n&HHKq<1-!BhB~va1G$FK8 z{Mq-$1u{6S?`^myr|M2n=iKbcD0_K(yfZsQUaH8d)vlggHQE_{(O!Z9D3EWYB?U$Y z2V0UAS0U;gWWj)?q@zbup{**s*BoRqQP-MDB+sjo7;8>AR*cuWxE!u2uWi-8M#lby zIJSRSHXgm0796%gpZuj$|0zuM*5g)c%b$}7>2$Vn<_LQf;lOR__5V=!Cg516Z~wTa znY4&RO13s4TM|OjE+w>Cvpuqvy&~Ca%9^F@Ldx1g*~yZ!h6kZ!7ZQc6g>1jijcS@H z^ZmZ>@gD!<-!aD=GnHq#@9Vy<^ZaZli%LC>cTYfwd&=rnt7;PU zV-WKO?I-JI&8O)4LTv_$Fj))GaQ4{84AMsQr|%q`ecO4j?(idW(Y}^LSAU<@Xf2?> zcfdJE+hQxzcZmi<+AgK^6bW%2yNTq!o&IYFYl%Ieb!f1CJ}Qnp@+YRkhiX#_DkD2Ohpb>Zy70q2bJ(9RC z1kM8S16Z+0f%4+q zf2Y59Yugjke{&z!GcUzV#FDHF}UVM72j#;nF6*6b*i zF>>xfW-h`Y1JQFQPX;UTl>)4&Yiv}D;s4CW!eS(#yK&*trLiDj%*^7?>4Q{z|3`w3 z;zC=V=|Mv?p@#E_D`pLuVpG+E281k! z(;#8!?qlFRXrdZF7u%2bJM|BC%p7^QZM^*aka-eW^*&9ChQjj-*7?kzP!+$#Wg*(% zguHIuax3ect4AEU&X;%*GB?^ER_tf4rXOgrrR*ab2wc}Utb>tp|LTa zEX5lwlo!*Vzq{sy7uLjp~o|O;%kQsu<=KXp6_bQUrf}@U((E9WvV3K;@q@DZNJ0#aL{4W z#qo4jElG2hn_qh-AHA@!FzC~Pu5CTnDIX#WICm8*#(B{Ys;TK;3v?22JUx9F;&4(x zyzOaV|5igKN&BfUUr+JM`g-gQ;=)H`mN7TT;1t(y-gQNtCu8^SJ$v%rd1|~~-(A?s z!J&&UH}ir%&OS+W+lL#@Lg)iGAPY_E{7aSpH~}9{t$e&yPnAI+0|ORh0|yW=Z-P@> zFVVvHh*(b+V_RLyQj4<>uo1@D7B0@c6aCLJn=Nq|qr;mTv&=C^a{<*zBF^NtDEn&; zfg3HIM{(-e*)_o~_u7P+?tzP%Z92)AF~2)3T*_rRDmwj!v}dm6lk9%M*|&S^Qw!B;h&HB1`n4_q-98XQu}ge;0`8ojnchWBB@HN?Yv}+ z01}c;%ib7a9K5-sSR*zYAuQptK3zP!o+I8*S-mFo|~ zETnp^*5#4#hEhp8lB!aTV2HTn8RD!ybm2l_gu4q#vNf%;t#YqA%XrsWL95(RY1uvA{UJI0-Izf3 z;&L5a@1RqCzhSod!>|V7OXf=3*sIFsO-H_Br&;QK>z4W>b%{OXGB~iC zo9!X)f`4P=j!@Xbwd`}_ATM;D+oYf_fNbL zq4YA!oLBvJlhR9_%%Ud~(yd6Ulk;_awX*v%3k}QtucfV*UP0=R0{re}n zT%^6#yQ-oyMgRf__4RqQ%Ed>>EDJlKzo?40pgYCp@o}C<%7b#GJ^f|_ zZ(n0%;N$f4?t>b~ss%Fc>=`>ah*QG#)ebcQ#V={6-jB70+i7@>DzuKjj`bYwyE{-O zu1y}+4$Ha8*LFA}x|a9k){+rUfAi1cqN2R2tlYM49;`a@!=o#gh1Oy@Y|GI$yMA@%D-3Pd_jO`>p{F8R=+EP~G5Qfmrjc=Es3{JN&+L-@lQuM5i z@1~FQ=81XlDJQyu$k7uI+8P?UuYJm&bZ0Bloz#51TIl|Y6`_9AJ>A_rSvym@7t?xw z?<=B9ab4=Lmd`o+@dmL1f-Cw$QbZ0v8Zb=h`OqXm?%N>hJ+bORTvW*^@0hdiL&TC- zJa7q-?BDC|Q@+yK0moz3_`s6#?NzNN_Dr;NbnPui@=ZC8ML$`qFezsA3fSq)A&h?) z^ZtZb*sek@Gp;K4r#awx6RxwGl@dcR;tzefZ{9n2n_(EXgUpE++L}1;m%;5OSoz(HBx_6ve)iXv1|9ILi`|GS{4MW2WLBOQzt}6XU1cd-?Vz~CMnJJxL6T!cR z+nBBS70`J%tpwL)FWJN6j~|CQ&P+$#c_U}8P9>LGAOnUWCGkqAb!yCaT5%prVxBza zIB?`h852dIAmMMJAgmc*O#-0E+&>>tCHGrvRpyO`cMcP7txGp9ET zmW4$RPugGJKt9TpiDCM$|A^0gfV`zdQs?N`nDO`3o%LqZ11pPaD5gVcxM&@wu2KJ* z6xxrFOEphQ`ICam{d)kH6D7D5nj2fZV zO4vE~I+^2|Bs4nDQd}8_r-B(V>*xi9!h_y#Q(e$G?)cZvQGR6NYi`o@HM)8o(hG3_ zjXi(9b|v4*+oSWIYR|P^j>DKY20c&c=pWJR)-CWG=!vJGsD2|n>%IBTRE>RQPw!s} z2-!ojAf;P%?aj91pBSo=t2=WX;)g;{wvNI-G%4p;zLz$w(d|HUyVhWMq&z8TPPqHw z>n+a)f8jrI7$khDzE^;X{+EHM1$t zaKNUUKcp8b-b_59h&`)8o7XATt7NqC>}3D#;0K(kOD{d~_+C3%t<~*7>bOr5(>Bwm zAih|mlRM9)W5$bAgC2Aj7)$B@E`I=2(ds9~Wn~OR%bF9{1LzP!&1GzC{MzCFidT!r zEfd>GfA6^Se?$c^a!1BJ-PG0Tq)lxw*NypxEMCEw}>YLLVB0czy-<@065>*r2!+Lr8QX z!){9Fb-s&_Tp)Y=nw{?4a%u;rPHg=)-RYaXXy<${6p8@JN7_aVQnXK zGVVQkt-)3qE=5@{knp)j6=H=4k)9#%&)K1(addP%9@F`uwbko9Ur0bm|GBQu!#8g1 zar3qiRym}pdE49j7$$3-KK%hQ^z&j+d-eD=Xk%R!oKca9hE$v5v(u#pm%cIlaZe8=;Q?J(~)i|W<{RNvmLT9292B^``iP4(Rq3K>sDkwe*W^> zT2TRkBQH7s2{@-Fa9*Xpp1po6&s^*!F3I2oK7E#DQ#??o){WuM}g@Sj~L_31*a3tKyI! z1Ha1_Ny%(rYXpW)^pwsli|@>T+q>}aVpw&%a_0Xvb=g2up75y68@iZPP&U^CWvt{@ zdpLO8#Wzn^MvM-w9D;7~LaWPa(ud~kj{HMo5$%96Y(b&sjwii0ac7gPtV&b>nTIx? zyr2BBuv-EW8*ar?x99$0rsqUR?7;+resQY3t%@YRi_^C$N&-K~OYl0#NMu ztxzt8TVrOHo~$gJ6fGWLe&w-&jgAsBf5C-VFIoe_-RyrEx@M7M8ioKKv!53 zXIH+1X`L>B5r?Z=&-?=!3Ceq(m-!8g0diva`lA7%XUuULj7l+Ppb#F(a-}{$(5aWs`MEq8iha zB?J0LYvOOHt0ynDP8+U#^_8l9%SGrA;j}DH|I}YD@jB&bq$|mm9o1}X2T9%m7LAttaaC zl;2{B&FVhi`Ql0CII!a{8W#<#vSY0{BiYc2d>QTyJs%2%86(uQ=MX!ZpmfX2ixBX~ z#cf9O3v9U|d3hoo(uQ4L4PBf-5H~{UcnZ4VfCDL@*#8QCj*m@pjY#os?7P*F!1?>m z`o9&AXeOV1t3OU?itDE8_7svXg_?CPF&G83)7tiB=^`|*x#PIqD%WbI`Q00{^gpsP@}$zsXRutX#R# z@6aH^T`epvS9V>Skdl&8b*o(jX!i^<=}w;HVNvPyRbQjJA3)06n3InOa7D%|cRl#G z@9h7?Iu1duzIdvc*4Ng-3+D!iXl^!p9t--6F2A3MkXP}63c znF6Vu>sZrf`#fW3}3qmt$a<2p+r{G-DHk@af}n7n{2v&{MY?b?6mLH92ro<3TkY z4zN0(acPIeE4+>|MD(h2Q@6CXnokr6v}O6G{n_8Lc(EL|@(Wh4CeP(JK-=?fke{I` z^ZZF3Dr)2EG_xy@Qg~NJ^Bx=#u$FTX$iNr@7O~9HVtz&_5c13T+q+ZW-SM$w<<%{e zJIWV@%Xi)r0Y1=LL)aj;bJF95+p>S@K~_ahWIy+`Pnn~gvDnVOL?8pI4lw>QpqhnE zKJsVfC1O93%5Gf8i#feT*iqgM4z`l+A2&RwFJ!ezXEy;;-ccp;yd|Ah$QwaTU6%h9Wqc)d| zSg{MpNj7Fq9|pir*o|b8dhTqU{m%P;LST50y{>uJyYPQorKMZaFl~wO?DvAQVRE4B zj?+?iU)?XG1D649k=}iA*M9xberzFkfQ+JD(TLFNq2u|Es4xBB*+fLY0LW7YJxg4t zPf=?1_UG+jJ!{vp_xxTiG28$bCS)6W*+9VUOAs^tWyfPUb0U*y?mCmbkjg`IiT%<&0Y%OXWFofb0?K<`xkh{rZ7o z`LaX|!23Kr9EyreF0rk5;fW>xt1`pJfX5r7AjUW7oj z11EpO3YO<}(=#Q`e|!Kzj=xzHcs`o{VnKuBOq{}ZD9Y4+HaceKie-uGb)$_ia|#rh zjg5^As|MxmrT@~dNs(o9u^DdQ;J77e&${CFi8=qivrFJIrZGP6-BAGntLipT_^|$X zPQKCnw_1#mX=bz<$culYiWKd9W_P$pC%K$V{J1*!t6J1{x1Zei*ob22JOOk4RXw+M z@9sH~nEwxTvp)qLX2ipDN^WO??m4!)@5oJIx4tluSabQ>pEI-I<{8y{pOKH+Dme>T zj{gN@x>VOP2Lu4{NN4eny*9Bl8=AjCq7H#{1m5(R@>X$x2ZT zHz|Y`-+`FsF+D0TVlVw9zu2!u9d9&A+S-t6|F18~CB8lH0HFS?9Ry7I#}`7achwp` zl@NreR;2jWBVNEnt(6^Gp0B=I9%C< zsn;5rzkN>I-w)X*yPtvi!D`nqp@A!}+~$&az=sg{Z4lsB!3*@ijt3`zSHPf-p&kk` zN);H#0wEVoveAE_xLdL5xU;8cYW!4dYb)jz{PFwmGC{&U@C`z0=c}aOwyaVCSsnD& ztXobUaM8IL?3Em*?>??6wEn;DCn3?kb5v3+1my7zqRR{4?XVb=?`-ZGm1>_}j^Ut# z!^5fZ=7{6Jckdo41n+u)4Pgn|W6S;|WGj^t4ULTuWt`5CIU^u`W?#kX(P#J7eyswL zZynom+;Yy9a7pU3_VZ9E5XHsCAE_i47Zm>;j8HD@-g|@;0(Fw_z_LGKLP~%97&18- zVn&!|23g9ZcKTxg)|pFcM1ZjLc3-z*ik%N|xBB|}F#RSO3uWupq}#Wj78GM{2D~8% z=EBzpK+RB}GObOMQGa+^K=(C_JZWR(TM`+00U@{HEg>bNl@8fqTlbb5f;hw}!-}?Y z#fs695kNfkd{y8+RE|)bcB+q?Mtf(O0XR37eC(b19U{UOI<2m*u8s~O?1C5=EGaoP z+-%=Gx(0ZjzXCNCRX2ho`cq)&lIRsc;&xl3id(Hq_)vx%?gW*9IFl3)AKxtjZO1VQ zg@-2%#+D(qmlWD6Cm@OF5`oYgH?(5O8P(br)vmwEi_dX9A!~V6Q&hTMIV(C7xGmw| z><^?2L{MCk`HZ}(KP4e^YjpuFI~-%{89*Z8w$*RTyS{c$-j4MEFPE-{>usfgBs3pq zbee44{0n}&J0}+YW*OC};4X+Cv8;?@PVPs5dK_Y0;wNGHk6~GdCCQqMDvjKCUyjz6d+#nuN-~gh6f`VLJ_t1!=m`;sPup&RS zpPE!2ethn|R|~f?$pW=Ka8D#KHz2TdYH~O`pOW$43Y84ohfgr2hMt*BQkPK)T~uTr?DK zu*E*8dJom92fK=P?G115wzf7wlcw!-`;g90?=EjpzMd!5$nh6`#Y>bgx<0KIS3RHK z{qnD=X6McfeM>dF^tP~XM2t&w<3bu5fR6%<;ws@R!Oovk&UY!$?ZdSsi5Ae4cA}uF zTl6a<(%;I}+cpu~=`MwDw!0ZJ@0M;f=UfHC(>Cv*pbQvp@sJ?5WDE%{R#q@|3mev4 zkFLGUa-lze<$1A2TAt(F-pHuLDkfvk*1XjC7YVBNIKSiy;_6FID(H&@g%zo23sH^)9&R$Ll=_AWn zS!D}kkNoY2XZ>Sy7A5s|d8t6HXVz+3n2;Z^bWz;U?e>$~H~CcS5_Qjb!mk_bJ>&HBNB>m2j9FOE1> zEHzD_SH)JOwoPXWdbO_;wipP>&mrtU_Z8FMu}tW{)A;la>mn4>r%^gX1U_q;c>EAn|g+M`(jCH@LFr%3jB{r zq*16TxHju?bao-G36`32nvW$J46c@eS@XzH1kmIj_?$8qn?hTQRpuRysk z7q?ed)!CKcUSFO^qF*t(UX zinx@yT?t~Q*yWcMKkMzhG0*#RZq<+1=tjQ{Xq<>>Ji|cHP1j_j&%pKyRW72B)J~p+ zSxE5<$J!JK(CzYUiLog*Bc=xGJg9c>w>;?XHjE!Y8Z=eCdWJERAa$Q(z00vClQ%QE+${z(W@v7d^g3E?- z^C_R0_WluN+s%-eF(s2x$D<-c>JOgh~gRO4)Ej1EZ_66)8@hWHzWJ7lt4fq1q-?{TCD8Os3t^l3> zymH0J-vAz_SWXI~+#gYEsItE+S$v)XdoC6;U%7hq7D%*Vnm|gpYv2{e&}M7tPW?8A zefiN76J4+G9x07`Qsb#Ku#hrAKy8#g96S%n-11Q{bX?u-g|Juhx#qvmVx+q`)OiGR zL|b)Uy+4QY6IDP?Wsu2}z|hbs#98&)TyHD%Jj6{oLtb7$MoI6j;Z=y?>Nf_(opE0D7zyRRo?+!m3|GpXV8v|5BwJ^AC*tM$qXR;Pjcx`Y0WD79omv;spU(R`P4w^Z zmogtgzmS`%VpXjn5(AyRdh?rd$AHGiY?i~F6?e>aQonq%C3K9j4H=fN0|M^Su3s?z zUhb8xZ5NN)=gUdsT$i<>5MTl$E`xt+i^uZ&k1)e}jioeApRSs+MEEC}o00PLy0wkhruVXYshk zEgr3OEh~tv*$U;n-*x2YpZoB#TE6ZFzbI#-QN3oo)9u@rdc+mBk0*X49ja2HGC9_m zsOJek$kWU7(YB0`ugD+-R7Dh-*)Y*vP*ql6eWuNMxn5Z??UIn-;Dp3PBW4mNJCQ>1 zB%vGoP#JkGfK5=>EqP0?U+p37_Y_AWj;>uiwUXu6o_N#E1tQYPW^+LS11uF=brqoq zgiiVC(*lfjNgwR;-L-4pQS!r|csCDqT@!+MT*LO0FDwe7)(?#$53Vp7|EvblX1q6e z4fbfB8lQ2O0E1VXvh+%aVDzJ0EN{}7mi9)P`6GFT+}eAjI_hhe(hoY$Sl z_+gm+L`>(G0;WBO2DgfP&sP@L8e9rt@Ds7`Qiwh z;~s-y^`bhV zGfeEg0s@7^FFvx%1z}5?d|q*!YrpV0eGP;5UJrYAKa+-`-ifJ3PTjne%7Hxl@?~r^ z%rdlN7#v~vYExg({GtL%p}g*cu#Dk*OG@@y^DkogY;6~n^r9-!4}$x6`R>|n!HQq} z3sl6lyboJMK7!9Jlw?H_>ERm#5=;+3r%Qxp%A{mI)_MLt*9YA)q@O4Yx04tn6r7B4bUndWhuDcV}2# zQ|vAvs5@H)O66?iY}(%|9}3{93Q%*fe)&Mr1Vk#>@}!Cd@J$e=t3e}n1jJKm_-@hl z2V&M{3O@S$*|T&HPQ)k)z$m+ztSr7)Uj7BFaqfzoe0-ljed>96&pUa`;j(Oa1XHes zLEho)L3X6|k->*!y1FCg)t+j3oV(ZQH8A zB%{`BJ%Y{DCDiOHPrjsKOl!+X%Th!Rx}UdzfK|A>06K>NoNn zhL?m}(Sm7fXa2C{1*w~uLZ%$PKRGDXpDHo9>14P|_YIKt<)IzrVk1Gzx`cqB{y@`XP3CHl>3`b1cejb@?2)jWQqh z5z@fmAoUV!T|80=?eVOvCnEl7ko9CfJRxB1NxvS-jS2)LJR0|+WvqSOm^Ba?JVA1B zTxy#y>k(SRQEl_N_Bvr^cYqm3DNSDi!f8@F4F5|#{}e0>!x|}U&bDiMwH{XqnLjzh zf%PIAN*}=$0j(4g9m+;_R?F60m`L-STzkKyRNPQ0LG*n5_4Pb1qZlWbbY?iI#-brD z+tmR-ALJ!TtAYI!GJOT+5GAKTOid`SP!YLn}eT`{|y(JR6N!87UCuzyYp~Af$0s(+?s-eZblFlWnz z6jC)V?wgh2gk>1!7&~RR=Gw-S#qT};WV0*fwW>!{0w?EqGcCO9y7lwnvtwV+-V;$+ zM*!QLoX-n#dzk;2^TVKGj|_Fwa4kMw?JZ3%TSDP;754J2iI@%HaBg7EI)1wynNMpn zr;^`@e_^K;cuE1G-;pVJFR^OVCg#A0&RFV&GK>+iL z*+oZ5dR`-BP#J+B0%+9^%gOQc@EpH6Ek(%Y`IWu+jpoZwQ|tU^Im#*i3!>v1O(mmK z?d5x@iyyn1*Hd(MaehlRv3tILdE&7%c;q**tZ`+|2g(}hR8xDwCS>PWa3 zej2m(pTL$g!x()2D=r3PWY1h}7c!u>ILyVNP*C`A&9O>BwcM8Z8=d;^Fi!lu>Cq5J z*Zo^z8y_G4FIet>bWx_g@XLR}F3u!zZu=!nf$YSegE7+~o=Z88ru|?1DC^GYY@|7` zFybPno{8I^L)RarZnY?~Jcs%LKBdsCB?2!uHRd)p zPGD0@DM?~TOjJ0otjV0XWa-is`zkn|QOt2ZP?#^Q(}XH zR8ccRvl-!llxN3Gm6In=B7`$yv?21w5B+YE93ekCJsWqZ^+zu z%ITjtjO%ayxU@*Td=K}^5t=IJcJf1;;7Q;C-ReF~+cQ-$UC_U|+2604lJdw_HQf!sBV*P3@7 zKWIl4wJJOyCtHBCZDdj4ctZhiSm-@x(iZpC8`~HJ16KPVJ$KH`%e?5^n7w_h)L48- zP`E`%)@QpXtQ{@!pX<5?CNiHiPZ)(HHdPC!p3R{-LVtt2Af=`p7~ZXmAMPPr?-8o* zLguqFN#>YJv08w%H_4_a`86{6x2hN;ILO%eBP!fsM6cQnmWs503_?OPxXy}jDYlE9 zcchrj@`z0QgJtR;E@?I6rb@=S9MyQJVoZLBw5e1Rj;-$~wJn%L_SNR-LI#fPOPYgO zCydF)&9=imRng_hm%O>vpb~1*t3Bo=F`T-JM~*};EVHaPO2zPutL=DjB+>kxsb&~D zLZ28UX+JrSlG(IUdSlk-x-waUeS7HlZAiQvJ2Z$WRz$}ec7#}Z zs4FaQ`GCdJKK8Do!>K1o=!~DY_t{z<|5)Y3cbM>C+dr0xl#zDU&E55BW^EsXI+1oT zpj_-;>yQ{6AIK_kaRbT1HyEnSPa+Mbdm0bBF^N1JI7SW@6=W71w`_}|I;mvW<}R|X zUZ9ed3SW&!G(wd zy+Tg$zpqhTS?U?UBE!gK9E(4XI@Nyc&S?j3n3YPE=v?lzd+$6_D9U}9L#f!^PiXP1B0Z%tu1-oRD$f>p^Hy&pDa44dx_4@Ic(vE zL|Q3H{;Z*+va)5EL%_zeRy0S*W~5L5F<^-H{b`%(L~ckf8N!|mcZcs*O{V}mKyt_mEuYJz=J|#Z(J*bhu#8r4e_*MqPqSkbysLx`1aLkd$zxO*L0!HUHoI3 z_FaAMu}#sl1tNf88O8ri)tiNhD`0;@3U4{FMvyV^!Qzs zmV*jg=1;GjHG%Hiz65SHAU-XqW4M7{A>stdR1Z~>H^oSPxEqdWAR_af$f=}e@?mPZ zuiuO+3&VY^5quyg@##2(EyP5OgRA9*b)hPJG#aFwdBLnT)&~h4D0!6P-eAy4 zdaElpG9)H27x%LZl zF56=I=4otiIItT>*C!*bOW2eIm9GB$n~t!;5X4wrcOk#KwOu3dpu&z7_Z8B-4xf2v zAv?0xb)8r3&J*K4K0ezqv!^B7MF?k_#K*KY7+62Neq>*DSfnSd%>xgIi4yTCdLMV( z!lH($g=PB%({(xLpU$Ja>hIf&JtQ>I1sTa27g`(;`12q_x`g|0`=gnWR!6Xi4_w81U@}N#B;Y~a~ zhS3qKR!7>+i`f0Ima1F#B;$J{+}!CM+$7u=SKXp9OqM@+lG#w^=2kA2)!u~q+);#e z+f`Yu=^IWNXvBXa+b1%JO+Z{TLzcl{a(JdYxTG`)upAMpNKi8=aAVYI#sC$}W=1wL z&JN7-F41o%_QAJ1)%W>in1~VU6Oa$DN)o5KL|VRW5)yyp4e!=PYmNy*ydhY&EgT4j zRZwSjY(2IVwXDMfdehd;zC+5z&=aI|ooeZw_0@4jM?}0u2CBrs^Y!6A<(Q1}Y*CzT zfVidcBnKuvNkD)Cw+8e;5Al*Fnf?2PQi?;T?QT!`b-1L+)HM&i9kOS2JrUO-Z9R|q zEf6Yg@4S5lh))CXe95WN@+69ScO*gyNlMydb-D-v=EI6p1E_aD{=_8JwDS~uswm0g zsYM9Sxb2L1RI^KZ`x9g2^qj%9A6iBz@1NJqtM`UtjN|Z4H&%)CmtXq&so086kC&0` zr!}aTPVdEs;sC&*qjaWiMdCGod!0?Q&z5j(V7+LI6Q}C|-TBYTF-9@$q#Am)L5kxd zU=p~6uIyv0JRMwGIquCuD3O!pU8Vx}Gmag8` zqe&86V_P#0I7inq3TO5|U3+fvgR3}EB%kYA-}@5D(>U&2`^@J?E9L?*>VADbe906W z$CvG+J)oK6oJ@$0wq6_IFt`1#DKzkcl{V)=DL6IWAqiqB1CJYw=vFvkaNkH4JB+tq+7t4d!Xk|Rv8yS$ zq*07cZIv7&$hAN(Upa^SD;}O=7ks)%a_^Dfy=o8WNg|DS7+VLxCK1FFJpB45#F#FO ztXbZEG6PDFEXEA?f4sKy^lSGXLEx2Eth*waPkqw&-t4(lo1|;pag{BMb6w!l5k}sN%m-$_2 zo5%cte&)!|RTuNV|5he_ls0jX&@rT5&3S?Pa)tL@jmu-Ac_SZv>BMfFL~Nfc1CO)o z{q@NIR?2V(&YRwxuag%@8XnubP^s0OlKRduCHAX0$ah)P(Iw88`Ni#i<76bicj2MG ztn(4AN4p{WJq9}KXEnu$785;f&hqcI)_l8~2g`6(gXI71uFw6Yu1Ebi?r$0Y79mmG z@gK(nUZO`B!kPy^juX6Xjt_k5)2Z(oW8B^2NJ5D_%n9BouDak%g7Yu-nDMy7v}<|# z3;ufOpW`@D6i6&Lr_)ieL*=S4Jql3E9FMjS1bk_Z{cr&_^GL~uD3qVsWKu%r_^NxW zM9trJ8to*Oo*uihQks|h+36|_#kQno(7N5kEioOr!lRP(+?H8HYZp<)<*GAlTfBdV z4LS;9$y^>CWH|B8D)K2P))*a_3Q`zgoUNO{CF@cWQw!8|FcE(9(4<)*i^%ewk%)!5 zN>hT72p?+}1lxUiZ+YsMZ?Cjy`dK(j$1uI0b;E^(oeYIdv24Z``_U2&$0jy>jl~qc z17yK+ysF037e&FKA2y$v%XJwWZ^Qn)_9)-WrL(&h-)>S1zR4>YjAe057FHL?xG*X= zwI#p%(mCf^og#9SDLYfgo7v~z?&;U%9cSKZURC^5cc$EuSh+U75BL1kdlQ}-2E$$C zhZ|ga*v?OS@4NEUa=YPFRb7Afj(rSClwry6!i-B z)5;iriBaiX6iV%DHmUTCo_} zpk>=9r5dNX>q0G(X%A8v9y=Jqsr4Si{v=1=dgrQQzT4oOmxEZLVg3-kHJ~5Oz4_o_ z`ld{xQ}w{aoJNa!UPED&xp|gutY&$%V`x{=KQyB*inB!xGxh0_{XUZ{OlZTrj?*r&Z_K6rAU=SUW(s9e$F`UKp>Aa#sE3CGM2y|hws977FieqX10;&VXTD7U0 z#P;1w$7G9K^%nYyn{kKk1*q*SbWu5vzi)x^)aRJ&z09TqZ^AuyT*RJ@1@;ksVN{9+ z?S=gL+MW^&9xt-(r#RmPjK7M1X0@%&1BE;;_eraEUwr>1++&}*R<8DTrkQMGn{uvG zkhW(Z!GEm++lU!@2dVsp?)n?$g@&3tP`*8Clr+)>sN%y zYoZm&H6OX__(^iCw%n15ae4A)x2A04R;c|K2Tk;t*e@y3+U}IC_>VL5SX(UE?gK-`DtET|_o)K~sK{r?p*j zqNL$VfZA;gB+xpH3I+lx^R~ z|ArobF}{lG%Gi|gOk#R9ABF*-Yoh8hNq-+Dpk1(+X`|#~V`y#A3n(f*fne!SWDF39 z3a;Yn^L@`KQ=!Mn9II9}vBf4M-W|86hMhL?!P{*|9>C&ozVnWgW9p`RBBS*NkZYx* zD{*WuWV6p4X!CDHCuvj>mX9ev;d*uK(fv6B#Ozk0_rWu^$YkQZoc&^MVhO}GfRWM< zGVPPEqhzy@$4v#7NnL+6^~1}1bQa?nol?A-@Ab~dyj;oJ`<5=$tHnaeDbegz%>MF9 zR=kJa&wipy!zmRgMy~lf3&wN~H*X9$F@%eE0oAHyvJ=JJkB;}}`T{cxsfW>IYItf= zL&@XK;~?BK7VpK^4##+Tk1e70wgqThaX5#8rz`>8nVRjd^wT<4#b@MZ9Pc!7%5sR!W1bVSbQrz( zjk}wdFE6=~1Z|^KrI*M@NQWT2*`}y8iAcTNKI>1f6iW_rrb>Bz@=Nf^2~hJJ=k{x# zEmZezVM68Nx=?EoDwh@pI{zSr1;R6BdiUdnE)HnlerN))!epe$#v^?#6?@)H_Blyj zb@<#CQ)`2bpp10&eE_Jn!x-4hr?VtvoT zFIJ?#+9?Xvy!a*jUrpOd4j8iIub+WG-(z~1z+-RQS zLHz$&Vt$AS2TQI<{Mq}ISj2$Xa;+u;x~A?BWe5`G%CEX)jIKKEi5 z<}r!_NWcPO;8$l>K#kLfmUpRbDz-;v1e|K=_u##VT#J`E_}mXP>G(7Ic9RNSNftny zwrSB}m*o=CRjl5*fj3y>zL-@Tp0&*}nf(P!*wuU-${VrHN)FzQkP4$?SFH=E{I3^O zz?P#8DgqgXe1hx(88|>3gs``}Z#jLrp%i0!k_@+h1Y9ANR10MXeUEw0qK$ila4Z?M z=paZtcK|?P*rN!yN?lAsZAu7GV~^%!O0>r4p4<#v60yFg^8p9F?6lq;jz24uHa^k* z$?xJBV1X_HYAfm)&(~rjsmJBTR^r$WhzVH36qO0D#*^(s`_7GbW+>CqCUKTqV!qJ+ zXV2snTix0}D=M?v^gX*Po^IKzegtIbZ7)Bco|_3v({SqN6o*c9>s9dGh~(5=x$wkQ zf8q?mFJP9~ebZtEEsg~DOX+kAD~Rf@lqlg{yxviO&9525zBaFwk~_+b2>*Qo8Fx=q z?CB2U>_9kg_~pJT3MR{Wp* z?n}WuaMxUDK$uIoUAwX2& zrF@UydT|cXWf3)4Y-&?_y>Z6AJxL7#jXqq*Ho4aBGdW@BdQ>1IZrLQ0PIdv#U1s7O z@h$B3>WbZTh<>(Q9I#0miSx)kuUJaaQ?TA zT23r{P`&mHGH1M)WE*SQ#FV(icC~GKiDUZ3;g2lr1;Au5R9v*(=eg=oEsuz<<*O5l z4(*%MbIg-ouTVTm8*B6CGUf78PV1-cLBE~a7;L&*X{6M|j*h+lW5Ztkojzu6Vdq=2 z+p*8T)Wz+T|u5HH5*HsH4+!`X(AXeQILa7$j!wnZ`g=s;&73gvb~GxA3O&a48YJQRKqT4wbP z;LN0+KCv;OT5o887!ZWoF1O!%SPZBuTt}#Q#+=%B*nYYCi8!t>UyfB>9cVCiI2Q{x zoOhU|misKX0L7mT@q89P~*sD?0e7g56_*40BblOq2j4H~^Wp>MyJA1yYRt z6ug6O&e7Wu5gWvGfg5#{2KgH|uLxR$N0S;s>9O;vx4rSSAJ-nbagS5iGJl2QRR^fg zrJ_GJXWQ>vn}}I;YgY%eVJ{#8(^&*ntX}M*#850^nk6wgw06FuE%H7x!3AN!@D#uO z=piM>f&zq`FsIPWpTyy^7 zjs3`;q2&8GqNHsOpC)$aS2Wc@nPylEn|i2rpivCTjKbY1-Yo%sYnKY=TAtp75Wn``w#aVSn@#I#I5+xJ+wPe1jR+X2-v z+kzTKyVzqkXy57?H_!&(l|A@8aG^kt z^I5fonwXXqVo_%Rh_^y}JdA$}AJdj4Zb*{=B3+TVoUYm9B6vJ0nt+%S52~^6ocw(0 z4y6h3TTWH%Poa%?#-5!W>d7T2LH*A<{%Q;!%f5Wf94uSXg$rA8G}0j}Y}u*lnE1|S z)2oD6N+p1dnXT6|6#;+H6}kxTcpu>%=6{6z5P@uwvcuZi7MGDJw)gVOPMycgH}&3d z4|;M$M2pKoAcJRAk*DO)4Ef`HO86;FJpnEe+cqx;pGYi~;Vf!-mUj6PPzlfCym=rf{~rdb*d`x3+hcvK*4?xcv`~A=x@_c_?Dw>HV|7jG zDcb?=ES6le?_`3DIa{jZDgjK7xywzrOJWuwsb44(3+DXVb$XnO0X)~YU|tDug0aRE zifYN4&;I0*cF|GI;?e`-k=kHhg0*4!?2nZ|<#n;w6*X%!HK65rP>+#o>-W2DmYjXn zrxpc=xe;8tZi535RgNVQZeXV5<@=~E>D^-7thw{xE$y!`SIut?Nl2vR+kMnIfaQK5 zB2K8z7-e!?n+A`X>Y}STW&mN75zsrVDT4(w$2VbI%W&MPE-| z&CB`5wyFvH2kyuUZTH{u@NL3L6c}Cv0q|y;wYb9e4N+|1)YZFtWrj!$(71|gF++PM zrVTv_2&okcI^kT)Mew!1f&0YrADK73{7trB$_2LWD7J7KvA;ID57%av54d)y_gZbB zTB7oQ@utn;ckgok1;l(`HKtsdSRB3km9qNJfl8%CW{(YYG!v)E=GYJS$nY-PcvY!IQdPY{xWC-r}ukE1!u3s zrJ=m6e0;=BjIg{M5<~aF82!G?U2K~$U#-$(2lKeD^xnLlj6Cri__YJ z=>V)&Z*RCW(k2eZCM!Q&cZPB&1H;2pZOpU!gl9D0=mdq`CyiAYYi2>=j&&Ot?4}6` z1_s?(Ds5_rU(ohqc9@r9j1mS?xB~)%Qr%yx1=oGiQnamKAYDS!>CdB_V0O&>A<7jR zLlS2E6lM4`C3d~MSJe~5h>AxnuRGzC=Cq`sb{pk1yM>Bv{&Zp81V-O?*-x78?>*84 zHvKDr0)Zq4V`qdp1Iq&2QwU&BJ7hc{xY14cIqn+btA-C_kKJh1Y_4qq0fD%-AcP`_ z*I`urk@%X%o;C5fc;Ni9X+Z(Py08G(6igEq4E{}zBHlv1wAHZ26f>9rO;YiD zq9(-Q=P>0cRIz}uFEajr`q0|3vtx|2&{lImn>4XY`H`ImYg`ZX|E17&)a@jfz4^;W zmjCNcwT(>i_mBL>`Y#0N>|OKnLVc@-b@8H%=(XG4y(H#hVdXO!U5D=Gn?Qinoc2Gt zJ!=lxYwr>so}`sxjt8I<1K(d;l;%ld9xVTLcifF~=^rR~s#$pY)C&0W@l>dy$6i5E zN%_N}aeH`{cQNFJ8tZvU2_ouzJFF-U&^4ss5t-TAH4`p1&F=Zve?t%Alj?GXTC5ZD zgiTyrEx+#+YE3~pktwYg!998ZF|=dm;kxv4GdeT~1v=W>lTmx35XLB(VN-F6R}S?^ zDxQJ%_XyEF%H}^l`_T1@*T<5F-cRsMm4ry1)P3w4!$R>BMyAqxZzbP4NlD4k77HFm zHPoVwKilx{2V%k#aVC*0`UgTMb)w{YJ7&M{0m&$tKreQC-%qa%S+|iR#2du&-6J=(uDeGvra@>GRdO$r0$m?J3o!$G_Ml#70Tii332}*L?Sk}?RIK;8%mIq2UGycy1_ey z{m=KJ4a=eZD`}V&R{raGb1y6{?Lv1=JVXg$zwP|;=BLYrg5vqspD#KJia^Kj3kF=! zi?P}5n_^9sX+6%J8SdrpxU@`YQ@Piz6HvjF4dnP5245j$N_01IqTJ|H707%+CG?4caer3={AEL=`}jMP5&P1?EF2|7mz!76fNB?}&&)0=~X%ciZCe2SO27q`&#>9u> zyR#h#e07{wF8HgCj*e8cjKjJ>bR;#OUeXthd4xT>H5Rc=j_w3^l-IBL@Fb%Lrp&Fn zf4Tda5p*)&D&KGA(kn73T4-&Ud1+X;Z-ZSH&0$3eTG|!hZyk;nJw63TW;4W)Z-wCX z{nclc3En0EvlAK@t;cu)9F`9tNrV6i;TJEU@snb;Iz<%CY%br|I@AU;#Qf`1wER== zHKzBWp%}6xE_08lLf^ehK`8&2pBav%}CajMA6J;>`U za<}a?=>V9^HDv)3z{zghOvYy*u@H*CH>OMe*N;Wf=0m`6`vUcDi2`3mh7WFLlx&C? z0Kf@&!HLOe)2HHh4dxTzQm7;?3UuM3iDZx%+?i+6ps8L~wBM+*O1I z=3G%S`|bPtyF8Klk;Siy9!`wVBeX(^ng2MpPTh)J@3D>KuV$f~Z8uSH_*oj3&t8o+ zOgEtN^WF<|jn3qRfUYIz>_}gC)cj^`1-xqMFFOag+Duh{Rz(tJ%H^-+!llzh_lXdB z1g06k_>HUZ=MUIjVTjKIQ(cIUf@1*KRACqB;-r?N@wiENl1{*z=iU1doIQ1eg7mx*+1o>;7ce?{vUN;9*$+&{@+Y9 z(==^ULM2R#WDlhznKCMbWY0E;Xe<@kmzqenlwCrR6tYKoEJZ1MlzmHODUW^U!S8cv zQ&Y3N-@ks2_c-1;Dv#TJU-xyL=Vv<~`%E(*qxjD>h|`hL(`8$Vln!^zd7S%~^JCfG z{sa01#x~ReLAfVTZsnI3D+EWM*Y|(7tp-0p-b@V!S z$MeepZ`lj_Sjz{V1d_ucd0;$97ruU$@H#J%jl5 z_8=Jtbg`6Z_IV;rvHkos{Er9I@#qi5#*32CmVdEI=ge8@`Q@eaX?+3o#+LPc<#BkG zsXG3faSaD5yG?4p_Pp;)Pwmf}y|y?$ikRN^34izWzj~;CqJwuDpFuF#L}Q_b4{def z`X72ch2qkC*LPQb1wYv&^A~9Mt>{oq!&bYvlzORz^8wY5=o-KI9Mx&rGpp>S{mZiV zt=!HOb<%qpp?HQy_#96roxy80XyxB<^Jx_13vYWXHhl-%=%=LrA5o0))Hecn%~&PA zaO#}mp7i?u!}HgbLGw61+{MHr7qn>&J9~SDG@qB&&fyw8I1w<}(E)Tg%3WJC19az5 zpqvZH8waY$)^zC3F`XJh63DG~g7LW}2o?3!Rs0V>t{H%CA4-pNtZ2TEqRmd-Vcq*2 zX9B@u`JglbB=<9e6kEH`Yw!fv27Rl~)vn2#RSeHwtS=rtaHE4)3cVO(fC#kMIE>#a z-H$>zf)3Iaf&(G<+BKBpAFJt4KLB}e$cBUQy9P2k0qzFi)-X%KI}r}C6l^9wY|=ue zQl%%m8^%t{0LR&BGXg{aI-Lv$K>!)cQpDqCefEE?)c-G~#6?palwWzK|8aB91S)n7 zm=$gsj6_GQZJx>R#fsyhZH;pidYs7TwZ(B8P5ysu1&r)$L$;qhigFE%$4=Bhy(b`f zz$lV1vR@wd;c=9*BLLrM8;0Jt=GCm%{w!6p8-^8PU#fN(lAg8A? zwwhMLt(CbgDIq8{$*=E!={6Jnl$y?OdvQ(^R2_g1rmf$<#FAO+aN77cybQ9-fEw-3 zRDw+#(l~wE=)(Nvvv!J^2Kf^M1Cf3FLjxDQ>-h0LRFDC@nn!6Xq;Il);dCUl!-sYR zxCWdV7Xt&U@dg|TvpKuy+E3{`vq1C@c*vZ}VjRN#La2kBfHVjA`5pUncF{2VCH-|s z5M>_(;!yg%YHfwAO^ZnKMH?2YpZW5+aw_!~sk$x@gf=04$k*ndb(DM%VfsqUs8;_T z@GWHNPYxnNz6Bt-_#N$ka9aL_Zv0cxGI+Va-$(lbY>*Ut3#FcXd^Zd>+lcWC9HIz@ zk=tGh?bG9)-1sHsr@|h0buNRz5`C!aYd$mEESgbOCqAfWpwp)wN;4jV1i~I#tFeUX z@dU^}!QfSm@&}{=)A-Mz2~H1>bs*xc;b3_6sCuPXenr(U|4TWt%q$7JF{xJ((8)J6 zy8Y!N)w)&x$9g1F{|5kYFvn=78eYV`iwd~YkSdUd=PcDamjUBHb?i6R0y7AhJLmB#&J6ygK;(Ia-^%`V`11Bu zO6((kgSizJAJNw|PXy?;y?V78mc4Z^_dxPvI7Zat5X_$r6SXt=mGByeR|MM1NiuIN>Ap1Y^nhqW$N65+l_GxV}_+-byD;z zP3G+`BVts)p1Bh8i=qPePc}1cb-ny86mf1%%tFShsn;V? z6_oa28q}?`GIjY>h~FKcPg|e9$)zbxz8KudNpkmzCE*~OUy=9{(NukY5y2FvMyZQm zzQzwc&)0f@*Y`lu!zMxI2r*-+K|ON^QW0p_l{pQpz<~Ea9HVpht+cuZ@yb(^6RrwG zO`;T+YFr#|*;NPQASixG>sYX6w~tmzJ)pu~olZpioKQdwKuzYl1u1J_1zNvn)OZ3R zJP~a4^@EGA!($>W`eX5JyP-)SHdmku?klh7UkCrCrW6|AxrsU=Go=&KqK*sddk`zH5R1M6o( zL_9tk{oW`1w@KG(#^+3p<1kOu@9;>J0eYER2w4W7;-P~F4@$ONef1;;3Zqnnpy>2p zIkT8kUx1H~PeN*j6=g_(Mop!%)<8u{_O9NQh;Ck`-KjkZjzh6{ zNcBa!me;!#F;o4WLc*hwP0D`qgEj5zyP?#)v|kLWQ4_*cI!;7|N5UO)vz;K=lzK=7 zp^;pzW#`fg5rPG}j{3EFR;WeJzI2^d&ZFc{_U%~q(!rO}gXA8*o9pXM(wd)l;ko>@ZVWJyhpwf5tD@$<+GRehi-I(E-+ky_ z8=Rrw62$y|qqPj&*f#{%%0JaE8<}ff@Oe4B6Zj_fK;T>GXhemd{pSEQLD@V4mN{e4 z+8O7Y>e=v9pkdm^$JY}L(Gy#sMg@v*+`WzNwToDH?y%izEbK@d-AG~RIzdG7dp)$m zY}$f#Y>?lpGj=2Lyt^_Cf^ItcHKN?!aGzt*Z-uTg_rxaqI-_Wbv0Gq>AC82h~ts!~~ykayozVtzYyX zU=YQnVnPP#c#h~#B-}DOLUhv2i+OF&Yi@h(eGA(QnVAH+sg3Fl_4IBiC+YYp#7@GE zV~9?t2%C~iD_8uT2t{7bG5zI9+gtq?ad5cc6MoYoGOelDl zX)kA*V&Vz(S2(#wUm9X!4~XS!c+S@b2Tyh?yBDMVdM^_Q)VcO%?RsKd{l;kfN0>=H z-y04P2-cU>lVg_ff_~~Ta0BQU`W>B)ulWvWIV+fUojH_p3e!s3Ik%X#dccs-Mj&=ouW1ok%vp@EzpNfE1#6Tr7c!k1b zdPheuI8Jpi8Ak|W9h_7#<|nex{rHr`CSu!{LKl~Rm$qWor^7t@PIpzXR%`0- zJ7#$aW3^&ayJez}Op(=N)M|pqPo%j@VS4Sp{x@0Ey99smWL>PV&j6j|dr@T3rh_M! z`j~!M0Q6OeSaB(YnOCkn4^F-2G(E*(bABdThlWiLm$`f*?SFWS&Ona4QO~_(Fq( z%zk&Bxe(%QVmnuR`dyVg(?ZNvReb%j-i(X*^XCz5d5|(49q7NViN0r8Exxinqk!O{C>_TY%~rA zr%g7uP>3F{V!)~*=r1kUnA=0S6|T+p6A26WRzDB6yeD+2w~?rGUXO_w?Vquv|7()? z#@Yu|+57V-&jHnJrxXBcs(MVU$_^>F&$IM%1 z>`@oGO_pT0nJS>{(w5G7Rz}U)lQ{P{YkxPlAm-2d9 z=03pKsL1U1*Kg}6+v}QzVx}NKVNKfxZ>!UAN;ov}F5bm1j9Pba0!Udx`9JbzLqsbYr=hO;t%t%k z>FnM{g?DpR7CBT_2^rr(G1T!aYpWm%M`Wk`R;1&A4riGekH(!%#`aTV?d+u|;ZSha zJHJvee<4*nJ!b#tM-{4cS+k_x8{$>}2Stkf_MZcT8YftbRW)c*m-gP5QZBY>Z)|@W zBiUKy)LR|MGF@LpmpwMD9lSh6ddJiFhHH&*rLw*F18}DkNdDzJx8V4cYBInUSir~S zUds$WFGOG70eL^beSAJ(-V&D8=W7ud)uE3A5a@waXvXrEZ6N03Z-hdULhBq}$8P@- z1B`0#xyFzB-1X=NttCPUQlx?`@|jm;mM%beZ5r2Hd%fKOv5)J%x#03S4;FI{I=i}b zGeN^AHbyMpPlVf<{v=RsHo7Uvpetjz3XKN%(1jTlkT1yWdB9rG2Z{J2EilEE95kQ6NGWJ!)CfkT}&EG0jsSRu+(1cTG|Y z`nvx9;ZfY3G@~x_rc28%^;OlEnWhJ6j*fMUO|xveQU-TtO#kuDrmP9z!yz+9>WjGFx*xSh@}DEC>Sd&2o7=&b8+}G$pBcayvjH= zb08sPwD7YVh8wFE8$v<=IDXUij`1V}G_pFZ;8$U3z-^aHqbibuTIG$fyz zD@U=M80@MSJmh#HH%LZ%Vck|+;qIjJMNHjkrjzr=#!7It6_gQ<^0JpNdsb|^qLRA0 zsya4Z@5L=|#wi}Mh>vVIKmD*UJ&(UGaxVRg8?czE{lvr>sLnxxIsJIzjdLl{6+PfD~T-vF9==_X_}x_<88;M*X<_z z?yE-(mr*(*%!^n|%Go8N z!yR)?DP7AP!QxK6eo@<+miVmb#K@b5vFE?3@)+9;mb*$6`EF=_8dW5hxBITXV`i_J zCWQs&_E5Co?Ztv}+)ODGPajb73hxeFcZHI?4)!{-|7*vOAE}9xk373X>_jIZ!A9$+ z{wTx;@Z_$^gao87pSm9BEA`B4#qnA`r`m*FXEf_?*SFuUW^ZVORM5F z)v?>d=5L@E9MlM59}cQ*#x;q6qR$5IWj?7$z%!@3OYX9v&*$ZAwglacM89$8o*B5A zoJsCM%pb+YzwSxW=cnL3H6E8Lc^bXLZu(6^lW@nC$qY-;{-Ld5WaVdOiY~+7R}`Cv zU*6Q#E+%H|%IuhYbVx*J^0B=5^vF%I%!#H2ni;ggAic#){&2LLOvt5Rhi8eZI$9Ms zR_r%X7?wmWuZp+J(R*ZxzP;>P!N~s0gJL=@7sTuKHebBdkeiTW!#CC%Q#s9TmGI}E z3L;iJw^1i-3POZKtf$YcY|+Qa;5?hWAM}efa$53^-8k0EI7RFAa9U~g{PaYCSFL|s z5Z$3E*Q6Zvu~xC%-GdJ(SX-}3gcWxC?o{tT>UViTboTV=kUX*tj@~EYyLn#OlNlZC zqi}SlA1g09a=F|j+~HErc-=L*ouQhAk`l`zN_I02b~_Y4Gg@-iyeoSm9-g`9PsIZEc#?uL zpLD<5;DKtwN)U;Mw<694ZPuSzq|1GJfG-Yn(g(`K;GLKPM8F&n8C?s+$04fJ-`<%d zrRjv=9k+XVJxKEfht+Ac)o0T!(bV-yF8owipVFYfj>G$z>?gY%3d(;iicwsuzB;9| zY4V1l%`lgo%R0~1TLy9RI^c{+q~VC&Q$N^gWt&UquaW;sW)hgcxz#J zieRt68JE&qrK2MpXWV4pv$03%jidNrI%(3Uu;<#i^&44l=Uxq!(8=TaQn#RUYw++X1?%A7%UwAAaTM#STnmX>)f-x`tTu^FSvA(BBX?kJNh*+=#1J*XBJL8XSQy9k) zxdrOCpZJj9zXRqKoLJ7^BqAZhtMwrjyV(|;XvjI3Kq!q_W5y8NXnpXSnl=nx%YfPh zdqNuuRn-&&nVR1bhFiXrh~99zacgJO;4F*MCdQ*u_TjVt!qb zC51`gRqokER!l-vpDheL^9z61?vKPfUUl}WmIgM*XA_Kuj zuLK3d^Cpi|OdI1nC-260nrE@}jAS0!DOeW&$AI~+B|q}a51$+2=bFF4v(`j@cM_7Y zsLVMcjm%c(C0C?~Ob&)!&9drYfyc=DnfyH0q0x1x=!Q>L$GZZYns&|xOq{=Us;f}o z>=Wfj)WXpdB2X7k(`~%Gm9LHno?vu|JY0{wAWe9;(8;(A!`x14slLem{{9H2)m6|s zXV@Ll^SRD1On3w@$qr35o zTakq|?Ot1_&AsFMwtCx}4rle%=V%5xN$#*6>Rm@CK5_4KR(kDqgO*2pfs^O^Qc7&5 zvJ+3VYwAS|OFHEU8Rxgj@`xCynl*xx1=ny-O92TzByrc5|a`ecoCKS?v`WDn1H zS%1<)TYK9;o<84i6RBo7oqsG~(M&qwnB&M^joW0?BK`Dw^Rgz>anJeYVL6CEo+LUW z(F+!nXW1a!Sj0E^M&%KEu{_%jb!&={$%#ChCfkXdz1gVnZBYNt_tMAu-F9?v3*+8& zr3IZWUNI^OEJERvk6sBB5}(qxN{=MCs@FNyn{={y*4~;tArH0w3oCDrgI0@}s+P2S zvbQ6J;f_<5n8=~2EPGQ4eBR96XELRkcX;3#oJ-%aeIPASJyHIUw$nhD7%cjC#tLrb zaN7N-g!#RxzKi_!*O~C^rDHI{Jt57XznuxJT|T=1(se+B5V-eOy4U^<5BPl=uL06k zC`(vq)4Pp(oHmhw4qD&UU@wCmJJv}3(Ul_iXoE~zGwn(759K_~+1feR{-_p@xKOL4 zqOFPo#X$TQERl`&>Zvc8c=OlnW-M!6FkyjCk~Khx1N?(kq7T~cAa7zPOJ^W8pCJ3 zq$7WCXq$J2MPak>Nb`~(x_TA#EcG5uM!gCNvomcz&?x7Bz#{$hT)Rhn8+3|I%S7u# zZQ3{_)OUN`y(=| z%0DbzSd`Jz#9=#qckob}?C!BZX9rEkbahDb*7Y4&)pxCtu+k4bHQR)XJ)zQmAH28n z!`AbwyX*&B)4i&T4}vsTE(vISk*wQF17kxQ8t1Cm9A|K|E=skScizT%1gJ-NmCR`C zv?Y+h18m`vPa&tfcleuk&YM%75ifKtUz)DkIgljT+F*mdWpb?SjEY0{ue!zk1A3Of z8pUbcP3~x<=GxX;r4+@?Zw@EeY+Zmj z=lr_;uipT>l1C78^67|`l#MEkQzdEFLWvuG-y=LGRQxePs@wrODj{0F694>^kZ@R# z85FwG%~jVAUU*}Eqd=X-f)Ja(H#lpZy%@*3`yffvjtLqZ?=ft>TQ`Vzr@(1mTy+ntNmO11fj$+vns-l4K9(^R5j`WrEW^U*s##YLosy9uw*`QMAuag=IP0 zUt=KJ5v2!4g2p;GFBhSwF5YL*CNPSSJCLpi>U?#Itd(YO0-V$TdJ~9wGoqNkkOYA0 zNXg8``#Q_6!6CS6CMQ-cB`%!|<2(jU=Gl_o1gLLssh2$-f(!=1ij3$r-+HXjw+tSbjXQvYE;UJ#vD~cEaIIu2rqc<<{5wkBT-Puw{w(bTrXkp#-b1r zK`dVN2r{oDFnc16&QVyqlH=_5w|iHt5378|3`HIU&B;OvS-Vkz)6e(>PuhN+23p1D zBsYY^*f{_>Vn>1akxYugeYL2HBocU$TYXdw3M=ItBa1qC#uanrm5RWW=WS_*wx)nt z=%J!BuR02P8`%}jf@*k46v6;~)5&gIqfrc@Hx{VD;v(Uez-gsW-5Ydo&nC{XrECsw zH7c)S0m8N+9(1AcOd9{E5w?Cm`7xwS(U>Z{hf;WXPebfr=-25_SKj*zJ`MrC`je zk8pY(3)$vaPCQ<7^*9pf`k0=B-mn4;-B&`=fQZ4Lt6IZcCi6H_9|#d{@q2CxebzJQ zy|=Wow%^gjo3+iv@Gc+Z>*LOV-TyNWsI5hmiEw%1i zM{^@{AsNVFi5Dxh_F@qo2Yj3&uA$C=dZm{)uK28lZBTE~aNW{xp)t6Qy1*p9J37x4bbg%>vz7P1`%R!~s7`r}ji zs04mboN^VTT~+-yuESt?-Wv=&DbL?{j$um1IxQmbQtu7JvSXziqtO}N=zW7sQ2Xw? z?Pp`jngv=U74~W-F$t}Lrm8m9pehmfAllEyJ>!*+bZ#5u9>eJ+%caA-RtpPEU8(6c zOVuJbLdy3*T!arlr9;_Xzgo+p>_p-IJL*QE2QBIK7kXBtx(;Epj={?fabV6+l{ySL zB#-q#E*?x+Vuf{aY4w%^rSo%W32?M47I<%b{n^1MUmDa1kwb3bVi9UD5^^8uS&}gn zs;@DJ0L37*F0T@I!inH)6odZzp>EPfDSD^h4U>A6-@R3nElZq!2s*^2F_@$>{ zt`ssc#qDyn7*ggsz9Ekt{P)cB{)}$lC|BG~(oZ@`kScQi8I+++U9pP9YE&U}mP|P4 z*kc84c7x*Do%AN%cpqUjS;z$eEg5wpwZP1Ohr0YSmfIMI0{@d4w%arFmh42*-0qh+ zK{K(rob`vI)1s$IG^13PT^MN8*2xtq9;RLl-nH0F?ln&hr{lmnOSFrtk@X_cy!OY{ z0*Chj6vv-D14!B-AI-Kz(r`ly#dVd367Gj7Vj78PH2`E&nrEFy_ZXNbzrAgcZ5|2> zY6R4g{gAWpe64@g1cHr~{nQqA?$XQbk=kCn-e4YW@bA{Zq2g|cFr8kwu@{=-s)XP! z1%1Nb5-agk5nXw0*$(yHxuuX|>8G-ItKtBB1G203C{OEM&tEvH1AuYa>@n@-cFTJG z)d$Z8JNIZ=N?;pPqOEUjPPr^lBxw_~&$Nf}mIc(I$goX7m|ys2QVO7anyCS1?Pq@^ z@8g@kscrBE=@?&erQg`RY%1(cL&m=W!mF;Qp1~ExiHG;V=FJ)WwW1XM zgMX@KJ}quP+OGnu!X=TAzIkRCPKw3X0~eO12pVIWfZB@##f#r#oA>|E-#fjQ!9%~M z@;U}J{Bsd|Bc@qlrQnQ{f@4cdbP?;vbhe^RK11UBVu;n?;B2eG;+*Jj=g?)F5fRLh zidUbhQVy5(+yrzS94=PpbG_)Qt0j0>FFw^PFE-da5oyX!-wjJYZAaJIIm-EmJJl`; znbMbh+8PtfJ6>W|8jw1d(=>PF2+3U#G+Opq8-Ui#D9O2dVm!pkaUdiGX%Q_&3^&fb zZBv8X3)w%B<5!=T&E`HeC^V| zDrvvr7m>DoNEKr5YT^(v3iK<#4I?6vWFtt_TL`y?AHGh2pnF1yiZO(wW+DDwF!e{2 zl{H8L6xzHLgH?3e!SIMpF_2)pE_$o#MWk#o%0>VC-gtY+X#+i6CvRg`E5068v#+?+ z$C97Iv!TmpOU8DKj$`AmqxW`_MCMT`VVEo;N=UpX@ecq%gu@$GWjp;CajT^}28sZmxLMwIBvxxdNbFASP2-n5@}%s8$7-$> z@rooEO53YxjUKES%bu8KaPly#=2_gum(Q|aS95`u)8@+qLoR|`JO+#bJ=sn@={YjT zg+>#BckH~d4wrcQBXO6$(_Jih$Q4eA|Uar zdt1&L<;n$$eGDuM)LGx@dO?v)a{06#s~xb5S?*RlSvE~Yp7h*^p+N0mh5(-li;l$3 z*U=-MRXt9>Q`?UChq0K*0^i1xFwM)4va#V&N5M$3@;1C{Rp^DvP%4$B4smddPOpLd zI)|2R?|e2omZO@r>GFV?UIO=6Rg`80Lm=`VosX4{>Z`~Wn+}L}HSxTBoh0Ul3J>vK zLl9zjL!*ls2P+Tl#7X|9G8WMjH?T1bK8A&w5Os*@aREgN@dP%`u_)ZR27{EJm zaL{?ao+SxfSR}TrDQUN!Y_C3@z&BBResA#mcX-D!9r z2R+B0&NK5y>S=Kmi_6;(1KJQ>=B5*+dLq7KS?S$+(_8LoeqshHb!`4wajL>O%C}5% z(fWm!y1iN!(0!4xcaE2@$N(|)&m>gVq#OMX*!MT!;*;_g zi-41ihZ6#Ue58Db$|RB*Tnnl(%LW6O)71wR@hf5U1a)W~;-nZ;#NX^6oiawHWxqjY z?WfvliGWAcof^Zr<$I^)falhwH$y?=w9>oQp|@oK8b?Erns{FPCgVKir64HaO?m0hDEtB6gNko{7wdcHJ==rrq7CTz23Mw{&1g2nez}K1d{brP-DfZO&Hus zyDnpuIS|iJkNjR6$tZtinzFeb@1l7>teKwgizso?% zlMrv?9|^;IStrF3N}XWfcN7+uiI~g_gEfeC)AQ5`))jUSmd>k+xm{An$9StbasB0M z4ilQuWkH*8n|1V?9YkCNoreMBvu;Zqfh^Cat(HPw2uGh?XU1LpK|t8S--cL|by~q& zCw=AG>9Z2SKKy8A@pN=)Y<1>R<%oK!=wz{G0*`en7Coy|zm(r)kyjTSOhYVWRJ%h@ zyu`@pd8-qvhqf;C2#}BDlUk9&Wl8R?Kr40yt>$cYmr3>1$8OEmeB3QwESGJcs+);b zMin_CuIPZ_-TuNg^(NIFAZ+r+DbiC*3(1ZaH9w&^s1cL>&iEo{+hpKCf%hXS3tS3M z2=ajaH_?Wqio^1Y7Y6-`o8`|b;`yJf%p1D8NvdZxO>AWtUbl)373~lGdX$&{9;L~! zn0^;O&)Tf*(=7)kZl!zi4nL{6%O|slD{_zapf2@3?le;sI3+=;$I$K;l$Uxm*$SkJ zZSHCd)Nt4?$beSp($c4KYELoXauCdeL^FC*u8H}#Ca6#Q@IH)<(xvw# zioe7Lj1if`+GnSy-pGrCp!`{`)MbFxszFERb^XXS?ECOISH-HN8@`5ip?}BbwA2cB zW&yiWzb7nHUI#67M9=YLZ2lXdD0UHeJu9Du0KN7OiUO#%K3EAb#vKu8uMIw0r znx-$ptMRBzt@R(ab63s{999l;H~%GZBCnJa9b>5vWiJaLNBJmjX8VMIHJZ74*jk^ix$uBFcFx}gh^-c#XtPVaf^Q6~T8*_Hg1TPrki z$n@X_F271a0B$F;53m$FqL6rb2g*TEbq%S)D;UQ`ZBH5hrlr-y=T7RXQR!BY%dlgu z{lQ)bYN0jaP_ORK$)@<5&m5Cu7teffgTAjD{{@eiENn26A2NMcu=bg2{@xJ6j)9Ze z(6l|KW=ewYM0wInGZx|Yv5DNmP%AIDI`+xQy2OaeEK%nl*i-U_>XU;RsZ z^%;sdT^Wwn{;)`_Okl5Z1= za@GSVwJ#eY+EANHR@@;bQR(!}E%b~jI07m$KsPVvVI5|VKJ5@X`Ia}9xl}5I=?L9; z;)p#tA@mfIUZkvDa(1w)M^F1+LfY{!i3xpJzPNeRg*q$ra~SoOG&$~_N~^EJmfD=4 zojlUST$g4t`AWgco?_b9x!{Q79jeR5HPzXZ@!01q9u|&aLXZZ|)m9fi7v{Ruf<^2$ zon6tnVIK%!aI(V>)c5jmS@TmdLGkJ6q9*rzs;pR6yD8=NIL)J4TB`;-G9lL;1@CS= zS)HgedCa8mRRc%#>XC$zBYTT-0?TBiisL)j{FM)tPnzB7E4!Z;Q^xo}oh8&peVa|M z@XQAOmZ9dmd=0X?KdQ1L-p(784s1dp|HZt( z2yXA%M)RIUfXn9p(BFSZ3uiCJN~Drq2bJF@W93+76P(*6*4DfIF2GiLUgnZ9>nfz@ z|D3a^3AfmidPjY*_(|6A(VSkdM-dy#cp>vPsXoao&=tX+6uN zy9!pdQ8wVrBh<6~Gm|u|0~av`?m0rrB0cvF?NbwKQOu4IV8HrbZOu z$P^hUR&Y;qUQk-nC|pA{0r8qk+$v71XgWZFc(VR>k;ky`NJIA3Nq?KCFZZ%74+Blg z%^-rra$@*ud=6z?chR$(Z4c<=ii?WWGp&y|h{NHHsSN=54OoU7Wj^n~U$CC}_wWK( zE>7)zm}a9|!u700hQ#rv#4|;@$EUPFwFDvxF=ZkMnyjD~Cjvc1|gNC(~Ct3K| z)r8iP<$NSIH|iA|8~3ftMeO0F9^LoS4Z1?~V>fcx$KnMpr*F)Thd@R?gV+6vC|<7M z?PWlB@Z8th%QFs;q1*=?ckMcTb6ZgkMSo9msrN^z)ZbL*6@c`#-Ld!j94ulm(`Hq*;hNw|oro0@Ky5!$94`1vx!ce8j!YIXxyhR1aZvv>)Yg}| zBe7e(xD&!$DA+QQf)s(?;LUEI>6mpb13WWB8lnDy)z13y8dsFIEHFaIE#Fm-##CU! z)be!4{W~xOd!=I{9@^Ne(3D*lAuc}@TwKUeoy}__R?p`mKV@5zDisJYG|xlC&KMFB z(kDs5khyk~4faN^QW)w`1CcutSug~k*Lt=|13jM*uufCUwC;0b532#&ccTXNVnNMVw{qBgG0iE%*1aE9^Y8H$ae9S( zr@hio|JyMO?F=0%kTy$XHkK9?V4AkFL76aGdGWIgIW}(GG&$a_T>90Yd4^+Mfy&=y zvTUS(3_uc8b#YmaKvn?P*~y(<@pq*H04_{kE5~LZ14k`A1H&cD3rffy`p^3gZX21z zdWzfXbBg)@V|qHGSz(A;J77EK*FALCZOPKQaESnVa}K}$z*C&ESTin4Kj#5zp1>{b27W|a|(+B49q`+qnPwV z0?CP<=j6}Jldm)bW}YMY+b+eo1IOFMNb({~q2M#>v+lKEuff)HsYVZGI=KncPBfvE-jC=MU zo=OI)d7<*t0jURspwDpm`7JFt1EUuzzMB?od`K|eoD6}-_)!=v-;E#rIAZwb{$wA) zn`H8+(th~-(IjnF!%+2saf@Fx;}t$k{Vp+kJ4*iJr!3krYf!O~yvjjc%bNil%Tmq+ zX}S<8&&RJ*Q~;|#r__J@{rBH*y}pD@>+n+hHNY>pmCSsfdru?!OUZv%Wxsi6L5=zm z-w1dihDjg#9yv>--gp~)2jmR zVU>TF3Cwb^YUYY*G<%iUwI60+zn?F^-uK?yfxgnuG0^wqPwxUJmT+|9$z`ukw*8Y1 z(af_3M9=$lJjT0w1LXs?PXVi?m+fLD-DNVZV%F5>U&v7RcZr-I#sJTS{?a=ftL_Y+ zTU^+464Z#C$Xmx|BBV#ZnORsLBBbAq8YXl#&99{D5mn2+?;*~zP*6$jb1~l&6lrI= zJ0?SpR7Wp)ee!m#nmh(*{Fj9wCRoLQg}&YZ;>~pJS$7@(dBB;;ER#R4J3f7gp8{-4 zWW{UvQZ^pm3JQ1rIvs=;Yz6-I@$0cJ0!cUwMzk*j-@gACk;OarS`L7pbiUXNGpEgl z%^&|QcI6V-oQ8BQrxEz^=?b6oU}*|hsqzD=vdMK-={FA^qBI$W$^8UUP5o)vyK*sN ziXenUp>j1TV!bi<*wNZL1x^D-kB1c<3pQlM3yE+Qwh5$UVnVjgoS;rJzw9qFM4oZH z55nMNSL3HB4k+B@rvQd=5oh4lSYaX?EWl=bcHr8+VpG&SEw)pmkHnM>?scDKGOfW3 zZ>PR>BtrmG;a-RkXqIsr^ksG}q|Msvb)ju=XBB|_ykjBJ+YY|zZ!J;~Gzi3&zlUy@ zt)_{kvR{e5flWbSbncu@)f`_+5C6EQD9I*cGiZxGsApMkoFY>m)ChKS zMkKhH@r%%DR5|AP<{dy9yYiixkt?)QWKjI9kt@$IGyJXCNb1+(_-&HjwW828u!mYy zkRfw`=etli%D)8BOe}p*Dqu~(lA&PA^HDLV$*mAm;YP>ajZ4Q2ijBj2*tB`NcJN_l z41_3mATd8HN>c1_%@vC|CVY0wqoP`z0KXB`B+a5N&UCr9Ad_Ku3)N*5h9?4Dv9lG? zDZKPLa{2fkLnBnp?FE(93sd{YBn@Mmn-hCGrk~XD9JR zP}=0`nkiB%D@rkrd_|WHVn;56Z$W$K^@u7Za@ZqK5uQd!iqfD2&>?0JF$8qvP3cTR z{=#E<5fdiW4HJ;R11ZdMGxAGDDr#6qjtb9Pw92B(0N@*#dyGhA&IrB{!pZw~FqyBb zQ_A80{2LAiY5FaJMray1_NuO9Pi3~c1OT%pk}%>*>BP@AE8kQLC+vk@FZZlNbv9&R zRbms~Z8AX9SPRpa`ye22HSY6?U{6QpGf&)Jo%;a%U58Rix5w5 zVs1XQF~t>g+P0H1rJrOSlN7lR8+byYBr^RgX^KaSc{4N{NT!NO6W&&x0dynhgy69u zl7cvFD)b0q6R!3_%;aUs1f%W_umWq; zGp~_ZHB+71)7#^SR!?UVc1u|zM$lj^?L{m|KGP#FCdO6Z%BEn~i5?Z#i=3#@!~|jk z(b*f{oDd(z6zMITTMP)ab?h;jk!2{jJr5tr*nIWMmEWP(f^Amw)%J{&8hE=Q`YT*q z;XirQsNDv3O>w)Kp^1s&1&Q`fJqK>wXHHI&eD59321#50E)tR)Kh)(Gi0LsS){ zD~G{e z8HKDV3l<_=DU+;wjQTYN(Is!pyDb=srgHNs%*A3FTSo>4Vy5HaPl}y6e!pR}QD2$@ zq2EI+8Dds(jp~L;n{LDYb6VrbzQmTT1gB%~L8Pa`P9=us^$8ht+XI1?PWuzWZ9V+Cym)1kmtf!7Io=VO=!h5IWe9yFn7|W7JUWxm z$>GLsZM0CpOW}x}9|`>sCArfd^n)&RH1_^MLri4aS5SvR3QF80AL+zO^c}Ol=v{*} zkEg9QU_1ghFG;y87$%vR7_7urFNU8<(&XX56cbz<(7U5WhG?3?E%q(r<9LC9@k_W( z7VMddZ9dYxlD7H03?5PCjQjuBW8^5r;(H_BF3bYvKaqW4w0Y^Z>Pmwn5}2hD5QutY z;T&@^O!BXDDYk$AP9vexx*m<|QAbA@rlGm@{$;_rup8=2%iQTx6fO$*&#r0KxUaoX z{H1D(Pw?jyF4^TN;=>1)uB6E5T5=xz^6va@8u7=XXk} zuo?wwW`Fa6f^)U{9!nKBj*SIQCcf4V_(>B3(j&~vCcE(Bdv2ZmZxu0dxK{T&dUs5+ z<=)l5wUZ&-yfnD=ZZv?lqO+$1+5SsSv0HzpPw~fxwLZWW-0U#j{rvu1622S7Qc!mO zbYQrH_8()lqLr^g%u>`OsuusNRiPL#Bg!bCbH+tt%4~m0`t%MEG~mJXntNYu^80Fq zO!o2EcN(K*Kc~cQT=zJ6{_f)Ve$D-j(KW}#d%nzAt zVj%YeDre!3$;N-;gPsLxTF6lZ%c$ygPxUa(cJ}K0dc|FUA06TOOVNgNscy9Oolh?8f|!^7hhN?z~*g zByeqdfUiM&FeZ7+7H%^cJty`oUbFLh-@4r|pWmOvfQEC;v^FQy zJBfzr7gZ+v&aGRlk)tEI%=f5M&SVB8b+}8L=R$Zo7)Hu2q(%83|8ds(J>~vuF|WGk zmEDp-bJQnVBSu5tAVtF!9;3Y>2+erK|H#6vYFdCcA`{X*+BnkF)_U8sBs2pq8$@qA z4GpQ6m1L)5Qc2MQ?eUvxsUUV$@?)XKwT+fFQ4p3^$sbz6B(&aI_KxRj;X%Z6Y2`R( zUH#+&uB|f&3CEE_zzc zrCEl+U$~ZVC9FPy#0@IA%*D)>p(AfRiFeH!x*&7*W^)IN$LB6OK|GQLcIS3`Sl0`c zsqneeC+@p2P9aQ_d897ZVWZ&D>5gXe=@BP6!-~TbiB5Ndz_#&rjnA;`UgEQ!${fY- z-tH<=wfvOmux!DFF(Tco>8hHi+7)yrFYYz-(jufwUK^O(Y!IT}JNmEebdaT1#@3_a z-)>xUMPQlT7ddk*2aANPI;0j(XM+2^e`ccf)n>OI4d@;nCuJQi+Dv+Q$M$X;gRG?= zbS~?pUHAARX=KEKijIGJWPgy*WI$qaPj+ZTdjW&!8;G?QhoI=j@U2HLw;Q2lP&*MJO2KDhW)ba5j8Bt!3+$OtM{mQX6xjVHs^21lPqt06rQfNc=2jPC(zB{lc9KrEbboSrL+1Zo7q#4{e=t zmeXNOr6Fqjx0)(eCnI!}I_+qfxE$N?D!Hyg;76y3?`OR##vXnNXNzKl*h&98HKASW z&(-o+PnKiDQQ54=`29=EnyY>EDwkPJO6`pgt}rv>wOt$M)c-mY9B`QJcqtAP=EnV| zuaumq%{eM7`6*kQ?02l*In{Qtyzx08TCi1PHzpm z?V$Mq>QnDNZWV)4*#-&52J-yiGy zeolc80uw$L;rg0k3C>IIxWyic$y#DLP%=$x?Hma)n?~;K1ncn!XxX7@BRZ+&IU&<^ z>rCoi#ZPpH3YKmgJIge!At3xkcG@Awu>cFeus&_bSFW+IE8}4T-{rBEWJYMiT^e&K z7O#_=p|_zQ7VEfDiZ};p!v^=D#?;s8&i=0jH#qC&&Bs2lR8&a_u3L?xcg|kEyuqqz zOWR91Et}DcZrTo$%2+Z5{1gIXEhj0o5nd3#FZP1y21@hxkfd4oBL?8kRI(^ZXXbP| z%j)=(@wfBTjO5;zDc|u^zz9u7{7BS4&$7EIR#^0DB|=-s35H#Qn4t|<^Y?qhmirtV zZG-~^s+Th}0}v`O`r2JZI-fdR8?EQNq26_1>(OVwOwnpb#DeHbe{R~CYL>1UN%lxD zJ8IIz^ZV0$h!MW)Ku#KaB5xG2Y~abre3DJr=V9HqFOOAw=|ept38=W;xke{TCvW^C zRm^4i9Ga#DUFG9GQ7OaCPGubqAzS_!?_*E!vz%0CPVsoCt6uI6cbMUwQ%HDPZi30G z28NkqZ6RAtWJ{UhS@IPUgxMj20t-0vv3uWar9JK_kMw0psm~C2dWoC+U!w)HDlsm* zF&vqJ+@bW%_WDhOWy)E~VRIwZACO~A?Y>8!s+PT4R+|@e3zOHl#vqO160Um5gKtFi6K>he6v>)n^u1QYYob7?+%0mdC!;Z~>M0B6Fz0!a> z=zRTtjNbL=4%lQ+4Y{qBSOwCyAv&0SJ|CF>u4*d;B${T+G5ni~^fEn5IN3Bt`w@_5 zU7n91GS_^BWtvH4x#rKtWUru*E@D`B;{d0i!Pf5UErP5e>s3^i@>77kMeI8BgX`)O z`^xjd#X{FG0BnxPL1z8z3;yq#6aSSdDT*4!yqjPRz#`K`cr8J5&|=#mb(u(13BaQD zskmv$@|4)`5HPEkq`GU@H}tbU_lm&Mx0fa5@p)-|Yw-oP*7ageYRMK={kee^h(q*v zSlFG6eNzS_VrlCAQAj=)Lf@Bf@TTgP2+kxJEq>!eY9E$9I`i|aO0ePpi1pdlo2F`z zpJ?6p0$HcG!PFlSL}{yz89xlNTWX)a{NfnRx5E=ZAWD3d`;=#`k%>`X6;y&oRdGhL zvc8O3_P=*l=t&Ao9t3Juw|LbvK23yLH#C@bH{6AhsO&8zY&2oqaHkJACJB>&@eM_h z*?O$Dcjz`QEVIOU%;v3#qz8i-q0VV53lDctkjWks3i--#vs^@Pp8B{aN^kL@=aeQ1 z88=?dU%RWgyC+>+1(h#U9aEPFRS(LpHApua=<3|#&C-ZF*I{W0NHx4?|La`P<3WLe z>9`E*0&qgmS$0(23JI5>sb2rk3x76~Q#>@6^PM;LyIET?Ie$e?9#xM!{&Go=e}kZo z-b(hHm!oQw*tiT-_9Q_S8X{t4is%tYL9(H5CW9aGK#3I)7qS~e#XD|q5@h7Ef&CE3 zDlW#6p-(S3hCY5~xS80eRLbl|F=FYvMlr&=xH~46&-mGmUAGR^r<&A{XV9c~7tLec z=|oL(C88>&SOyYJ(G`%GZW>cHX~^dcs?v2fsZo%$v^^kmgd z2+6z;KX7LSL!n?;eH{ZJ|l>H@>EXY(>9B+q|++UZA>Bx=?Bx?s6? zE!0#=DhZ}Iri!=*t~(9(-2I~dHFxKHrlM_{Mc(Wr6HFxN_4iYimi@O=r%n;4Ahd*KLX4O|_dw-w>wPG&D9Z)0ev3QhE@71K7 z3C(b1NHN|bZSM+%4SlLdCCk_?*%azy)zqnqq9rck#4wO5j0#D|yeU>NqA|ltjMH{U zre;bLCLx{7#Cs(JoO_PrC_sOXog4N6Ly zO^Sd>Y`Qn`&IeGzPd zV|{Yq%72pWL!T%7zHF*|1BNbdgP}|8I<|4@^7Ss=_S2JTbqnF5f0o2kCie(MXhm z7s1ajIXFW|#qAR?vHvBz@qsrK;2#PjOAL(2>~2?ja;MLiBcbIL{CQ#HJ+{RIbzD<* z;=5=F~T6hwR{g?u^J4BEU6*4RYK3zSgyjyR#BMHZbJi-efa=Z)M$N0 zlR>%-(Gg$++ug>epb!1*0?%LW=bHs~#;2>B6&CP}0y3Txwpp-fadodXfzWcvg*@0) zSzWe>3(d=nGB!!nx<^eXOVQ%e`%ntLvAL%;54uQ-CY34?_o=SjX%Z;2N`_CsObufv zu%NkUgmN*20Q(MM!}jI^|8Kt&XjRuB>?R|z#nwSHS)(n_#=I>BMq`(gH^xo$1y^yK z?JgaKo)tzt>nCC9^=wIpc4(+5Nzi{>ZQiUaCY$xh z0!@!|c+G#GqcV#*npdCEAH?OYCu}t~H}&0#w#*IR7@+to2+^O?SCkfcrUxa`$dJf! z@tX=;`mRvYMEb5-bU?nDfZz7t(5`A@d#JP z9uWGOrfb61JL&T7e`z&s9DYXPqv(TckhyCj<`LiwP!Q)@DHZeN)c-*E*r+fWB)kE_ zaM6)kWW#p2HY9}A{y+c ziaaJ|R4lwE+&WPIgIbbWJ=j&l;v2!Fi~1y(#fNCvSI)wGLmp5t#>{?(n)}Lv7}y6K zNF#VLKiO%13=%?Ta7c)$fqmEi?Hi)YL#$I?gBt8rW$vq)@g6te zSTMBvCvPX8xi?(TzopDmIfod(n(aL_toSk%efz^60YJeE-=IX83wjy1+Wk}!jZW4-0% ztKUk;>=E{eBI-dzchIND@z6$qxa-|AR6!Z)YLU7+XaGRa#$04y0wutn*AipE)0u!W zJM!56B<}oRQ>M9Oi8;7lhs^vgG5cO`*=#iMiT^|4d)Nn6kNu7#R;rt8+4f)IuTin2sJ?poZ4k;BA*er z4Dx0H8O~z`eQAFD-LT5k%$zVPb~)QH6iTd1{(j36yJ*aGk( z=^*Y|on0MGa~RNM&Y5`M!)cb+r{R?81|mQ=nd-6n&}<4Qsb?CSHG+i2uG@vvczLr! z1ZXPTxLLb>M)hXVc=%IFp}~kouTtqK=y#^+LP3pQ2#Tm`9P3O zD+Z$tq2of%3lp!rrw8i@y@Au!J+qc>NBLP=ex#@9#;MZ}2>cH3`)jA)=d)+7AGsB_ zkG}M1$>-P`vOBJwI{w#=i*K$U9=diRp^+a#4O|OQ=EK%rJkdG<#XQyl6Y@zo_ptxX8&Q=muEM2B%k?9XyF~<+#Pa*ho5G?0r?>(JKL@(-0XzC_8VP8ZCR6zZPwgz=gsTg8uF=8bpe5uqN`t!6iHInU(UJ4jkK8e3LJQ}%|_ zeED$v$I;}j&M|0ZLPZUkoMSck<=uT?X4pWo;CAP{zQJJ1g4(|Mq>6y5nF)V7D&hz{ zwUP6rySR5OpE_{udf6UVypHo%_61Em+FNouV5icxeXbMtsYVC5YYzkt)eu6Ryj8;_ zCWw$qnT6N|Ju240noq(M#nxSL`M!!<7vJeBo$^C-^L09I)yym70q@?G0*Mf1-FgSx zh2=Y{i{Dp9c!Pscz2KZ=&^(orj;k8>9qJo=MC8LbwG~iz=S;UA>{uITwu-r@X8swHI<% z`m-2&WBtQuK6}H+IgaL|)Rd&0qlcP%()$h)5}}h+X6uKW&t?R}gC-zkF>w~nD;4{? zbLSLT&a38!cg>LYnR+!YN7OE~7o5G*xSS;GuSyP>gB3LN~G z7p$1H%6I#C^2b*bs;_<1>+Acb2ZuvX^(@072n-kBq|DhwWOFFF;{W+S{(XDfa3~I)C8u= z$x{Uem)RvYYPfQ;(pYG?O$)2x%zDsuoW~TqySt})XrsO4jIu_!2%a;Mo$;8Mo(5aF z)lxB`gjuO*OncgGGiBLsdbOMvULTipR6f^yr4(W}Fet4$92`;*c zg(ni_J{BAatfD7b`P{`{P-EfF7T#9+K!C^0e(?O}(q`2ctpb+kVLa~Zp=^5o0Rf91 zq+4+b@{@azpS)5n84Ze?G!KBmCwpongL1=vWB22IKcsETYyl~(;Kn0e)lxIbh*I`b z4NA}(1y=9#h=}AMGg>Uau0DiUIc)DkS++r*FMkO=zH-Dr{coxgPS3;ls0(^`SXRX1 zDIB>+wftqTlj8^Fmu!WLr{R6}hD4flb=Iz!mkyrhI(~PE&70kpUXgaK=7P~+Z?<>; z+fd54?{%c`2pJ>%dFpo1E?hq5`ONFkGG3PSgTsuyhX~z;X?CZ19)_0{YHK9hjN5#$ zOuj`WN6?Kt-$?ncJ-WfCZR>n$T9^3a==o58R(GP3KOHfpYdbdr155nI8S@Sa;nL9& z{d}jO^y9~zG3xsv6ngsXK#0Cj*G88Ss}3Vo7taeXzIie1RuLi1w#Rbk|NZuMd>lo6 z+Gkm*l_7UEwB@>l1Qvsi&!qj(ZXX;%p{OXOaJkyYpYC5>Pxs`{o!Y#ofl#Nc_ZL6; z{dXmX36I(6LZ_rJHy@L%M6URakaslgZz|K6eW#Un!rFU?AJ8H`4L7`N+Tb2;2D#T< zLfet*#_lNDpJVdIYdgl?_zw3DZQCgAt;K-N{lo@VI#R4#TUeXl2!;7l@hAQ^Ez`Pi zL52R6_|4bOajaB*!BHa4zi)UfK_4du(@#860+}767A!Q<#rlFP4`uJ2@xruY(wOF8-|`rW0=y#86mPPJBN|&dRs_cklS^@^cr~g3IslG9Fz0 z0tV}MA6_uNh}gB~HxT5M_}cR3YhC=!9qs3SXnEt-{Bnp8ZcV(TeXy$V54j-gS0LTN zOzPD_%wXJ+C2u-QcK6+v^)e`@=RFxija(Mp{fXDMKBt`s6hp2iJOqjn{C(ry z#?|C5iUI1AyhzCh))V;1D|&iU%*_kM8*+qYa@vkQgSZ~hcY|*}-&h)1Q!0wZWiO&l zNVB=9zd@QI(jTjWr@KenmLm*H<95~#y!mlhK{`4*HP+4Nw)sCL!j`SKV1fW%1+?%D zGw^k6r+S=>ZdeqrJfe)E1c#}uU(XI5Mo%9*i>E~hKg;2yZQDTE+2|AdTPU%I4itas zKD@SFtb8YHYC|Y)Z0FqKO^`pvICvhZ(8u4iE5@eO^D(C0aISoGRib^iay2#*r=GdK z1AKj)UCZ`w;@HhC@EeYu@j_qGbDS2gCb$#Q)}|yf;z>N9RXyhFIQ5Nbvg2rQXVJ7Z z!J{|+{%$#zR-!bV1#=xmA4FRQD?$XOKl47p7~RN!{`}Zm737{0M_>f<+b#i&__g5< zhaB5P%{fT|KbCfV!$mae*b14eb^?G%Q59l$dlyfl$Zctf{qjyABTIXLV@NzdIzxA; zpOn44C(lK$s=;Qgb1qy@GtAU=XsT8w?%uuoPxtQLZ7!zffB$qMz5ILJ>{Ep*B0YeUuNTItMnQ{KM5QihyBi%c~qkqUq-qCMHIuy}*q|4F0prV*uq5a@{?%+u-GZjrH zU&pnYucc2{Y{nlrRFCs6vE2Y~SXI%VD4Eqf`w-ohwL)*e|V$GiKH6 z?18xyj7&`4NhI>J+|;rVubGJ+OB*S!P!(N@e#Ec<5tz32h z!hCf+Zq|irx|+5m|7}WqQpFfEm0*1FX=It%Oh`81{@%es)fAO$*h{e4h=>|fOTu@Fr)-P0WQQ-N70)QyqLvqT#b%^_ zb2}q2SW5=oxG?+PcKS+x&IgZqZ%<>2!_VfMhL`~My4u`%?ssK$S z|LP&VJbkgryyuhXHAOi9R;Vu{b(F7-O{~))C){($xbkW+qw+Gq7f#+9Ula3&ua9_h zTGbg9nYM-1Q>0`I@794r2^pp3KJf!TfWnx^kAsZIb|0Se_d2rvur%XY{Mo7O5!}Fl zS7;xTAV-!}A1}-|rlnqc!Q11M>N|7y`-F2xRt<1e4ih!jX|oND=3Z5P>Ac9sXU8P8 zHZq4Bs%%aYRg<9 z5eh+#rbmxRyDoYfRRu`}J`B5<6e2{gI5#vfKupo4KN}Y6w(QWhD$Exv$vHnc`NY$> zaIAyp_U*W*$LQpe6fy&oURN0k3yTSeHczuK4W|@u6+vg+Leuko8C@2XXte!Imy^OtS^}(t;iyk^k)MsO z#O$3~{oniR5y1t*jTGyFf_!sAMz-mf?ZL z>o>u{%;V34HOr+kNZ3IeDE3xO5S+z5ThI<-&QFf|E@xOP!v@cyW=@c$WrNZKr?&0E z;}ZVD&l!%(fx-1Ee& zKWuHB&jZM)QLaF}(7b^$OWF8<9b||~e(RTe@;chuf#-AqtVzVg=v6X4KR)8pTy@dJ zppyFQ=Uxl5bKWGWyWy_U6#9l_4s+HcD zW7d5%wM!4%*Y*;zv?5FiuzBswQ&#I5kdFx^S2v5>eHfw{iUi$g9-cj0ehpPykV^9= z7_IMij^$7Xk?F@#a^4K#VKy&}ULM4Pmt$A5?Qf`Ey3`HZOm!rKQ%fg+a}E^WTR#I> zV-Bsuh-Wn?@b@4$Q)u~U>>;Y|Y)DIsH9*8!TX*PW6G&*YhN(Ed&oZmG8(HP`tZ_TD zFx_~VLBbq%E^@vx0M7i2GmcJkZ|N18`^PlPHJwswKGv<7oYkl01FxrFX|3tn-xrG` zy7bc6v%FkXU}xsdz=_9?r<~?fB;iWo&GRmHi#mARu5FCV z7o*JQIMnd&PV&_c4LsI5yLL{gcwuaYXS5$4cnL*-RLWe2qq+fSMY$>@hnt?ja3`<3 z?fXi2?izYD>777V-9-+vEw@Wq4tntDwVVh^wm#JBQc08Yi=0MQ!U5I|g*vulcFnJh z55(&V@=h(1{>XYt2>+P%u>Zo#Y9m3CV|Kd|#T9i~_3h?U`^-8x>mvCSqxfARIxRy; zZ(eKD38Zp}eWOA-yBZFe@$Lit2M;o=jO7=~jTyt8LdKaKX)AOig*ezobPJNFnRV#&MAZ|}W*N4~$rDjGOH*C>2-=B$K{ZRp$fuWD+=RxeC3hcUj<(H4!b zXIV6sZnR{y8DVqEXj04!oh9?^s%zOT!Uxm24$hQ7(lAZFacTcv^ZJS23wx7qg?2B4 zy#zBUrOV&e=GBs!)5YdeH&@@a=Vy;EFHfhB`%v^4f|YmcRFjDld!$mH)%1(J4{DDh zRr0~1x-er+Y_@B8M&_d0bsTod)lAuhgpY}`^Rm*PxXYEi|}B4_o> zGq)yP?nqIp!+oPDRdV_Q-Dbh`oK_u(5`Jc+>gi|Zp8|L{Cq-KqZ{VisdcV55AB8PE z*FP4vqO3OSJv%PxTf#8y=gS`+KIKF4X5YnTyLk8}XBP`SRhc^$-rI|MGi>^{)_ZT= zTHJ3nm(HVhhXTPP!o6Ax28D5sdcV8x6p{_cRxaUaH`Fp68Vujleh5kp`Ig+-&}5`D z@ap;M{0%-F`i(LJr!|u>$fgWZhCS|%bq=F)hm0qFPm@cSPU{cSiQtt`!d<1Fm+{oo zn2CuaLk=1l&8Q5`T5~js1@NZ6@r}DR%s}>*;5kBzgmR}4jpJ=3kk&RCl zsCxbp#7CjZ5`O}Mc-rLWw%W)Jg*S)8Rwikn$Q|X(CQ~;4*-C;lU48UJk6fKDp--1g+qM#z6Og%fzs^o5i+hC#T6t$ajfnz zb^sIt!F6i3MjfR)*+CPw?%Fnd+M+f)x(L%Mum_3h4<{w^^gw zu?anYuThn4)~NRKc$suHRIZp`3LNqz_r?r-8fYw7l-=JW?(p@=Fcez#j~)@rk3M!n zDONG{O`}1Uc_+u(lJ~A}`4n8P6;Su~A@90XyxQkY)+)_K{M0M?93N()s{nu)f};)u zDUZ}moR62ZNPtpv5EB`;Gjn+=P#sk?N_*zj@)U6+EEWAh;1cFWN15snnUsD~_#L~3 zkvlfwES8qO75Sr7;|83aofT4|ZYNi?Q)Un+%bWGROKAC4I@HXQ_p)aP2je^&yiI~U6`U^{fM1DA?x@55>%_QLe%f?$z08|yAo9H zLpC}dUCw`ogj}sazlI)gc{YXQQeWMN@xoSGw^cml?m~k&wTJrEOKlG<&nYrht77xId7J-?j|EtYichg43z%4fvwqVeMlq;c4-EEV_U)Foky2BrnQ^j z>h{ApzFTJCJ57W0J1w7l!gg>hy`?+hXA$Cr;bF?}Rqd2(=H1>apmivSmM1W6_$NRs}b&BSNk zA@K!$PZe78sq@5)=$7bSX}M=&`MsDHs^gW9ri;Q}Xw-(S_!V%NN~NVg$<%K4{`|V` zguz+6%sb6@mE+-j!40flFcVPOos7M#`p&i)dNkHIZ3xWlg#>aTz4h}8)D6qCajIfF3m_0 zVouatv!bGk4lkziUu}rHKcENuF(Nm8#}0=~t)75GfZqlMZDdAA3BGy7`SX9e=^-(jjX-LR20jlOrcc+?kNa1 z%XG>$g8EbgdtFnYiR9lq7Xc++pSzW=9Wt{C1ZO-R22!%cdXO-p+h9M$l4j9@vpJh0 zGnI`K8dgT`ty-@T;TsKsuK)>2&9zh7AjSfZQB`0c%%MO~D0@#cWIK8f$K4j%U-7~v zqVX>5kcstevp34pkt<}d1z9{)i*LVGxn1I3%ceP8Ur2L5J<^}yWEOr(0vlf)ZuYPhCVZRfO7_BXWHiXiS6?R^>_lqpNysCRT5Z4VNtY>!RU zP~jO8>5&bsz~z-`=OxTOIr}T?4uo5iEOTfOA?5nHOVzbQSXfW6lUXw<#tQHL9gW}} zf4HT9ub2!@&EDURvi@%+=l%9&2Jx2oeKgHrCu@E(+fFsM6DbS|$B3pi zOh@e%jlec|y{b?9oQjC(gZ$G(x*xU7SGWE`NCg}47Ao-MI|J_h=-cAfTMO~Tde-#NK4N4ni{CNfa zx4p2RsgKMNJsCEHII!hWKF~d$h3!kgEF>cE{SP`HGOokMovE*{N2!6o?U0b=7xzU<(*nI}U=itMf?AGGtWgo1n1f;}o@qD^ z#eptJe<)q9w`{aCw=o9|Q;=XrAsCiNOe(pg#Kb$Tf7fbWwhq0=nj zIwTtjEJJ%xtQ{m_JYNMCL+M#iYF88sVoW#(gq`+l+( z$`$q?;A{aSpU26K`F7)f@7k+xe>GEBXBCFC?c9A}xg4LzsreHOY>?}S;;|Od5V>}Z zhxfXHx`PBkYz>STABlDv<8ff1rhe$=g-{oM+z70ElEAe40eIaJ?!xA60-fFx9qf_K zy$3(-hlpY_s=k+LfcwW|tdahv%rJv1{r8)$PgkiI!i z>^PGdCm5o^l&oWPGO?f(g1WmjpOm;bq}#TaE?ojQIE2$gj+W(%5Om2aXwI`S8G@-~ zs=B(m@Zopu+6A^^&;9++M9Mr)=F};}SMJWXh-R#EZKBk00oOAPhtixNaGP4d;i{y8 zAf;Oazax}N57gUW*;L?_d+G0;Qv8!wuUxq|Y5%paPY)lg#bK}Z!KVPqB9F2;#GA>! z@|4oiqP110Y024rUEu3hH3cy(p%6FQswpM~4|<>&2$~mN8I$GW_pE_M82lA7lJTO@ zR}jw1SDVA8Qi)&mY8z^C{s15BqFKA#%^=|lns#9$INFIdI>@dY1c&CpRZv#l2$DZ9 zs{~dC1!_5#FU@sq!7uPhjGH-la)R@9m7iFa0Bb(1-@`|b+8y8_^I*Azw1BnzN)LSG zP>gQ-rWAlt+@w03s^QqrFV~S661iL-Iy$|&f!mC{Si?eTL^1&b91!;v~_V}!4UANjvP77A}lOCkOJ&` zL7;roWGAbF_ra5+)Vhn_T-~?+rk{m=swU#iMofRMYI1V2!EN&EwOIx5G|0q@AVJGo zfQ=L)-n+l&kUu468C0jp2tFA6Hjn~$hzKtXBRX9L+TjRBUs86FI6Oj1{)H-*;)SK9 zvX386wE91LHUZWtpALZ6-7@?kV~3$A4+JE~ufyPHaGpi)I>Z{dpc=~pSTu`(Vta!L zr51bLZ_lBVf9>8~i5jhe8EEi&a+T+ZQ)DB-Ati!M@8+dT?&K=n4V(@zho}?_`DK#; zHse{eHb~nNOF*uEj*hN!`LT@ON#E*VuQiDG5VA$s?wX)_f!3=xC@3fh;m`t_CwbD* z$uy$-@$u!*6X3pfQ@Wl16ICFiVv36Vp;S0PYYYcPX2hX6aaQiZ8xVRduHEwo2LDS1{=NIDdn{x zk-TprPPBYHsp-H6$C-qLrrdu3n0-8Cc4M6hV~OVnqn5i6Z$1=}gkSP&IyN6nX!Su> zKEbCiegX}vrFnx|(sfD--j;^)7G_ECedMx+!qa{~KR;9@xJ<#RhUW)23AIBm)b}kc zEM`Zq2he_iZ6r@!>D416#f=b)7-6p{_FTohF_n{>g&~jci3;khpxVyWcBXbGPWpLxr&4mN6Z39Yo z6iDwSuq2KUs1)YA*`vzY4Qk(9{|eYkk0C*_!#e0F5z*Pb6s+10R@^R@vGQRt33u{1 zA>xo^0a?}sXG`h^{cJAyi)?fC=1^d)nXk=(sF8GBLJ~O3cb-&(W};GI*It4Qx9E7u zNSS((`|l1PKTcZ(bY8zk)z!|c3vgdF^DM)nDR;(CUg+07FB5wmPU*E(VDo3r^4X4Z zgUjm7%-z{@UttVqRjpo~@x!CkH}Be)0LaNuR|ah+lS&3=*Klj91*^V6ge#g`i%wS6 z0nGav7QuAA0<}!+@#xW~Qx=^$rxgdmF46_2?@fU)-TLA+RM_i^g-bNkud+iTttu%W z|L@m*Oh}iiMIm)Kn4YL~4JHH3qTfNY2F;)GQ7=qF_8vmY8JbQ5=Hfo_AE1+d9CEOrGZF;<{vz>V)994+?LQtfI=jc(4D?%YAO@W3=^#4_=oV@~1~3GW#p z5Kj-kb%GcI7b=_UauP{>IGdiQH(fZpfh4#J>SlrueOuI#4s&m=CZDlcmeZ$Clh(#K zUO=uKzPsOVy}0x@+MrI~rc9Fh7{#Zy6&*VL__4;gbcA?5c7}%Dv^p#gY;vQcv83tP7JFeEu6zKr zK%VN`g&3s{^JFC?BuuryPB7#59Zo1>qmW6+OHk$PESD@B|E}o`9q`>*a<3&;la59J zzVw%zJwDl@YOykXs+O8Iu(JCR0YxI4K>+2c@Qz}sz|#TNWeYD%+cGb=@y8Vn|=p3uc=~bzo@t#&IUT@<<%>&~rZ)m5l2GAJGudvJ5_EsrDTj z_yt8GD0>R2TA#I8CzH>eVc_T-TL6 z6`l@lTbLIn?N)qeIFZtZ3(whbOHpfr%Z6J3gSrM0Ng&IRAOdR;Gz^_2blC& z+&vSpp$1*I0&ujvS_?pT4OUXk0@cs67Z&Vi6#$f z*o$I4o7EL&3SM492+$lpTvSxVrl08n8M4R2hs5V^y?}jpQ&L>qi<92Qge%ae!Jur6 z3TV$L#`vV-;^KnmYsPi#k=$0VZaPBHsp3mgX#JX=$2WmK^%D74Gu=a)r-{me6ke^Ib#O1mB@OILPfu^3>Tz3389KCo{~{RE zcYQlxuBNY$rd@jAB3k8E9ad~^g7jCF&R?J>n#W*+khz8IxbZAH7kIM3Ft-+V26{%&7LNYi;)4+m*9?FwfA{<0H8$z3Wwy%6 z@wy21_2TW1HY~yb+#(fVhG{e9ULgAgG@!5}ha0(YqlibKj=ie)YHNY(tHk&PWHqM4H|4(FIkpuyO6%z$r-5w4)sR(`>g`^7jjk}M8jZdFK|E#v! zC~*TBT;k%QYL4}M+vk_NWMpJ=zUxiT8>~uiyy7P1X$R7E{3Z0T=K1l88-$%-_2Ln} zb5P-5VbP~uD+~^bt#fLJYCqNP-#Gt>;O!^*M;+LKtY=|EGqI2YFF63w3Cdx49ulEr z>b-Pq8zA|e3CaL2jL?DK+YDQGYTi90PkW5{TUCP%ly)1Eg?8%$wD5iaN6&=*7cUWs zP~d)6;9G9@BE*f1WoEMFRO^r~w`JZt&&4Xg${s(TA3MQ9V= z*Qbd4TbHF+4`vb5KWJA94e9!j9TKu*YEUcPn^NEn%#4K6tQzZr;8y2a(C7G&_8JhU z5p7fG@G^F4SC1{Hc0ewj3q5*Q*P`BDJ%o)L8B<;WWwJv<2?{A+?Z}E{OtQ>ZswJtlQUyompj1LhlP;5tyFgq70~+uCvq*5U|)sP z@JtYU@$z}qfy%z)n+)yNA(T`)%J|kaeR}N?@109MMX8XkzLANW z%C}7oSy*%vzH)Pu-7WrT=3U$6-3PzT&(<&v3;IwPvsGk{=mYV9vo~PPDEcQk=P0^y zrEp9;_xsS|f4*H$c~nkP(RA4(5;NN1p4{hH*!Z*g5IhpCb=*S_8vm@?{KP5_!OlsaegY^c~V;ihDy%5>W~ zHPTYDnOP|$XfmKe78T`!Y*j&;2U_^@Nd_T3OSM&147_{al=J-+3=LjKG;ojx)j3{WKVj1TAd4;80~moPjUhJ#MwNH!3PfmNqE5LKsDFc zu`0;>im+HHK9JErW|@TtvuNrMz8x5J>oRAn0QK}ubyPNRuA_MisohrH6B^5mD|!4b zShsjIz~+v+T`d{w!pSOfF_c2vc8mhuICxD;sAun@-0zLCZB3*a?h%8Xh|X@W8XN!8 zPEkZ%wqEIOu`@i0?f}}1;Fm*`ogcK@zWWLh7SC%$12ZUNS@}1bj_wMDkjq)8Mt|KO zyqnuPs!aNJV+HTZ%V}-jJE0i&GReM<{WJ)1P9?+slYReoKYf4p>?j~>AZUE#25%6n2Ei3m(3wbL&FZ@4hY_lJ z|A2p7fSIXDXAh9ni5VVsX+usd!r)kSi>gBoI1u5r1PssABJx`AAhF-NXMc~Y!ea_u;fhnCOY`=vYj zon4d+Kj1?O57*qG@|3=4=yP#UA{y7xbwU7ZTXnO$O9l*dt3i-FwF~qj2i2|G90<<3 z9~?9#Zm|HJ|GLJf(@^$FQM;(#GTzKUZ#SlPoMlCq59%e?xLnG(`-llBRcIrD=_btr zd~dd*@W{$fBz%#eXN``6G_DX>ctCE+w{dzBLcz+{TKFBgYmfZ9=E*)*zJJC=aO`Da zN`O-YCkuE$mLP=!;lrB4NCm>Mk?jE@T-IvN8#v%D&dyD;vQRyNB~Mn%J&ftEs6T`w zOa_)d3M3v4Mh0M3;VM(Z^qRy+d z=b51ruYtMgrArzB&~s3k0^D5sTz8sEAUXr-eAQ<8Y9H+|D2vQn-%frvr&K< z+dBW;&)YgaBvO#YacNPoB7Wx|Fh<&e4S8UpX_>MR(RXkZSkGe9++i=N$V?GJXu#F& z0>PJNUcvMxOC}fy**LAy7eJ?BP{0qkn55v6;kLH6yFxJh#MzZ^PMaj@rtU;VU(l7M z3}Avs}7!8aHt#=5;gv;SgOo05)v8}Mc z8;UQKDxaDKK-mPR^eX+T|hu-t=d7DQF1wwyW zBb?7yed5vSR=UfAy|34*{CerS7J{KJDRRo`8hgJ z>&=5u5x;||sS0@R0|NjSz1Jovls~tJWuhM)a{7=XY64H_S>SP|s91`xwOu+5(S}N4 zad883)?+-#vE8a*)E-n&=HLUjhN+cMw`2czUis%>rbhciOemGP+*qsEkdZB}q0daD zkRY=t8L1&x^)&cn(Z|u)nyBgYietS5W`Wnx!qt+r|MOkK4pzCt6z{c_E#on`` z1m8R6Ghbah2&FjJ)-hrtp|#Wy7FAB&cdgNwXFabDuY6!dnN^1Um@@S6`@A>n$QdmqJot)-J7l(nR z?0vF%ZnkCx2-b~bw3U(|%47in5{Nrdx6t~;nENw(_mB)VGYrp!rT|sH*tO3+D*#e1 zycGG{c)wNN@QtP(ygu?wD*?*y^wJce!7<@&;f}=d%i_xaByo} z6`wq35;*ec*Dl>sS$bU>Mld4bo2u$`g4mqW2iR$b`<-r`?_O=T`1^)AIJbQ8=eU zmO0gXb|h{MgwH>|$` z4Be`LatnBqJ``NsY$*Sr8vpc6!^!6x@UudG6MmXB4-et%*tQsRDJ%P!$0%j`kV_J` z72>Ku(Thle80#WtUnX0R%t@O}fz`=}110Wd9F?Bl7l~wQV_3KaIv{!zk*Ef*z1`>P+Ix6Z@Q{ z9J#_6t8vEnhNCay&N>*iMZM@shf#Mq?(PM`9&=eIK(Od*FxBuCLQ%e2$Mh5wK?wv(bOx^|PMv$0f`&Cxm$^nhqp~Ztmt1t!Kq zxbWF+x86!x++Zstf8PP0UsMtcmOGI4#=|GVTj;5hYnx}AEL<#^4zR6rF=m0 zj|PxuzSUft{HZ8ReB4}^5qt6?{X>sn_2S!Ok@@9wR7%re#Y0a+407V}qGme9`KzMY zlk;`fy7`vd9Z90Vl&ef1K}KONaV#u zR4usKz!h;xq4B6`s6w9UqTG;Lk#;*m;}3(L0+*YRu9SC{4%B}UTKbu(VxMTkx0S3@9#$zhx164?oBaK&43zfaq=dz20xps%OJYi=o!o_%Pg(O* z`)HSNgMPjan<)2MvgC%h&+Mf-m_qtiiASO|mJ*a6T3Sbj7!h&e!HnN2=JXSCKwwWE z8XN>$@0F*)t}+aYDNBZHt7}y%Te#`*909>3?1+Rm|V|L?73>xB>HP?3e#aH?;t`}e@Cb}94{;$($nAnv;nV-xTN`#&=$q~HslMcb;C zqCW!2dLDzk3K+X>EA{)V_d|cwGe3UB_w`exKbo! zUAuu_|Ap@l`Ojqv#$R`DirLoS>G-!@l=WWGZx8;5=MZM@KkDwl!`@aM+I0Up*YWS) z{U6cy#;-4ljDSYpsXvmH|Bx^u*b)!#`y`Hi<4^1V%^@FKVh6jWjlcS`?R$tn(|W;q z9ntmv#^$ED+n(jZ%4y4A6A6^VS>P;G<{sL<%jUsLKu2UjdG~K=MC8XZ0vs+{ zmc!1N%F88Q*y9b*JR~jfa{`EvWH{na#$5lt1B89+6B3z!F|-j%pv6Gdn>&ZiDY{)E z|6i@wwt$wIBrjTBdkAqX>ag<%mL^;`)T?h;zfej(##o*CW!T{4^-U81%h#_)jS)Ve)m6H zZ{0y?@=*P`fG^5=>ZvVfUb?`e6^)s2Tl-fS-fa#u?f<;eFT0fX8I zAdSSu$Ma>#D=8@%8X7hgGpgmJi3KwoD=+DJw5vjwHxN26*hDj@zOqA$BtW7or^@lr zoSB(+dG;R>(!sL{_Hc=w<;@>8k!aZj6d)^rTNYw!cfbXL7r$_`nMLk}xq+K*NeAX= zdro}hO2K3q8Dxo8cNqfuBUoX$%-dTp?|BEJdG+^3&26jktP`x<*Tr4#RbQTmbRk-B zYZWkbK?{Af{bv=UPsrH-5V49X+O{R_w#A8gLo8_NP*bl;12W8z{AcCKqc~g2q>a9q zH79hm#x!a3?>;GlnE)$;Wxx*xO5K-{5ml6KB~0SIUI&B)gd;Bitd!v(7?+t%38R6a znRV$>2@Lq9S4du{q>X-4bDUA>FezzhSlANO4!0kAerN`7w8z$b3)y!(O&ndbdwlOe z4z=fb^Hb)JUnN`%dmXDA_E4WW)#NQ*ds5pge;kQ((85TkG&`tuY*La4Sz8CTe^og6G2I5IJlha@ykZQ9<=dKeYAa zULym>_Nqqo9pC`L8-DS+*<`gbUW)c23--<>vu2CquKwP*Iczf4sqfnnI@{HIlZ&8e zi85+M*y=P`N`Ctg`TXbyoW$prBG=NO#33+#i#adN)c}GJbzQ6U7?0ENOC{$cT zTaA^EGR~5m1BSt6O2^R*4CcsfC=XRA7|eIkM-XE zuR5hPv?VL4l#GzQl8}gm>`}O7XK(7LWRtzi-sCp3lYQgZ-M3jr_TKYmKp{(e8>y584&jE#;a(XA{k{k3o3$Yd+XSAanTdo>-1c?$V)adD({*TTqo ztcNK6(ZHkvkBfiv96kg%*;4#ute39&3M-F#&X;uKbmOq;-1jaaOi&C&7p9MSfNB6~ z6zm+Q_=qU1HgYJSNL9&Hw?S00Z_Up#DGG~O|grDFveU5CA?N-UKPY2x>1N~wv^%oA^2AfCEOy(NAF z=xHgc#S1Vbky(wdrV3%z?;RTI9aYr*n#z!2(A_UjYt^PKcbZ`mNUl~kHlpt!dI|Io z((d3J_OR^b@T3{YC$Q!9_4JgK{JNQg0Tsqh4GiMRaDle}LG5$-`vpqxBjs=@ofWt# z=R6sg`WOqplNUl#4BV>m(_@Mc%+1p&2CPqiWdPppk^Pn%H^$maOA9+Ym0D+8*Vaa= zP+aErMXReaMMYWCmIj_k7SOpg1^T=^)nbQfz#*gS9dy?8$K=1sPWip)Z#-g`^!H2wy|9uCHbU$~43 zup3IY(XOt|U#1cijO%-fKW7XuYbX>B@l1z%6#vrvf-j=f8v&xF#-a7q+?aj+vt zfA!`^S&CYt{(?kh4>aYY#_1DW!7Mg|-;3K++s*N>k-a=?Ydi@BBRLdSVpD7A*f(p&k06LaXg>i8zpqj4gWoA2zdn zLzG9>9)t}CDy#J#)PX*9|1y~#ZmzNM{o&Cz2CwBZ;cW6(>k24;`VfPuCOIFH5It!v z?Vch(>wVpdhGq%U)#GiGl^XWg8RCq(aW3jZDxo72Dn*i15$lX0$Ud5w7*(v*XlPY2 zcFE8bWz&-b6PmV_Y7UNIy(?0lC{erC zqD={~MXM_K+!otTAuR4V+TeyES`HXmf%pzmcupKY4$L(;VA(CF)LIRAQEU%C{3R>f z4jnU?-z#vEl9Q+6czAdaO8+Kd# zuz*_Dv?3ZnDv-^7$rjum5Xb z-|K26Py72dMB9&}`-Ca~JpsA=O??+G^B^bA49r+~7!A5s_KJ&_Lr}t#2VfxBRR7ms+>>8rh0TZCC*7&Z(9Bo?c>6rw zNm-S<>`yKf!O<_&Efzj-pz!(vu>C-0^kq-D1o1Vsry(JVKrVJen~I2tG|}tgA0Z7? z4LyqPEBndSaeKOY=9{bICuF+nk4#tPZ^bn?Dt@ytHS>4y!(2dF@Uf)wJ92h+w`NZ+ zjZGB#IC<)=!_nKMl9yqFMm5|TWldh9#Z)Kcx?qDk*`uiBPNIFvFN($~-+m=7=8_`! zZmqYp3w<0-!uRlbl5UV_z@mMgbvUVs(ULSB2Z%6w^OkP2RPXboK-b1QT~aqEVWabR zgeXq(`96il$A*S!DuE#h+nb(jF=w~lISvka&EZ3@%@ryT>-uru`&v$$-v9agM zS3%5oqkN1B_empaLw?`kk-@K8^eBtIL2sQ_?xvoHBU4SHb*W10@>zt$O;PsixJx!g z)W&9?KP+@u*v7&lo1|Nw?28b~~`Mh@t`dteE#NT7YJ zW+l*Qaq2dxt0fNqVH5uGQmj@@yLr`;!2s#cO&TE%%{fl?F z@4Fo|8XWJTmI@?0S*7?>!$tS@EmhfvijdHX7ezjeiGOoqZ&m}<**0GPV+n{r+?dS? z=(O3M^p>oBfj>(@|1Unnn;kRd5)_C*(MU)4+xtQ=6l}%e3)Iwvr0mzC*vf+Cb^q_X z5ejY=`=0@zr?$fU>;DM?=*I(s3G;_PQ$SgP0=l)ZwioiR_`uz*V|q<~Z^kR}xTqYk zrrsGFBmOTp_>CX&^x)^A{!KUJ|BeJ12ZgRMKg&XhMpj~Sa%X-NUfb$_g4h55wZ=D@ zX7a)+^G^Bq%|8q=SYY~o-KZ3SP)-vFnEcNQG{571-{7A-fPel!?(ZGf}F(L9g@l8 z#%-WS1d_Q{ep#EyuB(+5wVBfhmrV(;b1TmSoB;mV8+@xpRKmaa27%#v81akaAbkYC zr<6mf&(p`0pIv>B{KVW`TvQbOm_b6K0TdeMt4=JsZO}yu*NNtn-cy9TYcDp}u%`%D z1U}xrN!B2%+&kRnufO@LPk6tGgTr9(HW>CZdHKh&RBN$aReRQzkC8`*VNc|(#0||` zOl+*MSBfl8zE$-wbTD3bz5^?y-~NL{MJ<}Ep9GJ85)UJvY=ZD6xr?0V*Db;A)y2NtT@ zh8(~_4cFG1+WJ9{A3qMlSx}=wyH2nC{sJ9<2d$S11$~_ zQNYyHldLFc+lz}gXG}qc8s#7c_2#9!!I)L2;pRA?hySV{_-~IGtSc7u+^T>uNYHQ0 zFLZ3qOi!~umX^$`bjE6OYHBin`|JL-!mJQJ+{yIcaeczLydb#$;gzHLJJC$?A{q?XM)X# zH8c-kL-NF!#-5(nxT)X!ZV0QFzO9|^c<1~JoM<*N-@}jblIzfADHhw0!}vLI0XlIO z!|qR|Z*P~o3`m4^(*cRpgGRndP@#W`;zc0?-B*XzcOWzsbmatTvvyx>Id0dyL}E`_ z5B=K7qf@pJQx8m@k2-^`ZF}sD8Q+7>?aETIZYRg>Zc=#WU^^f zuD^BHUELh?%gsH#a3C-V!Lm7U;D7=ZgZp0OK&@i<<(xd%BYAIAOihq6-(=c*exy~e zJ#}Cs@NRo*WqiE+itY{7o(wZAG``T@7yi=4w}!7g$W6EF$Y!`@J8uNxNbBn)chvu9 zWTAfvKCqpac`Ve}fcsFqTIXcX4G0NIGQY9zGs0I}*O2Cs-1TmDwyP&?W~s^B3s=uaJ2l68dbH`w<=8*NQ1E83METU1o?FnxqJ}eu zD;V5aUSYNKL%3h)96CVkRUS}rNvQ?f(cx6La$_)N3QWw;Y7NdUb}i1z8ru$sE37T~ zRA-zqQ8R(Y^HQNaP0gK0=3s2{#LTP^5OC;_Vj2LqP3&rJMuX6Adh;B~ z{G{cosw$X`Pl8B{Y zwx6;Y6xLEh3maYRfNmzYZ_KlaY6S2*zCU&4{!&eAM4gT6icyN*+ApgZxp{f(Ab5K)^Ng{%!}d;TQkDPz zZ_Utl3ccE1tOBV>BMye7tVfLXJ2T~uu-H_<{(#<*$pzb0Wb&xGNt@_+ zaGmlAv^N!e?V^Zzv8ln+KX=vHZ-}@xDP_3A>}zGF8LfmQi8V9>bGYsS{PY1Xirp zJ|5xdLpQ8gS;=?{IV!7IzI85k5WuSSSLO6q0n?^Qk@c4RNi?&4uJWBbHSnTIU=HD5 z4+_bYuX}u?3=6)4q&u~G`iW6ztWn*+nTC$vnT7*Q96-s^omE$65H|yvrK(J>(;w&-x}rxezftNb-*>Wi|Qw;!ZxMGuJ9wfrXHZi%VG8DL_Rh zmS>j%fugdyI5`P!8BR{Z;9=0!*$Ea+875!F4W9hm2u&ECsZvGehm`-C zAMV?Ue%Ql`%nvn%GKj#{g|^V^XxPfR`hJ{lyZS`jM&Sr75WpgIcL58@VlbYIW7rj)jg_la6N1OYzuE+~*CRdGXGIN1SRY9?0;@J0j;*Q_iYuEp>pc)S(^O^PyJgJy0*9fQ4DL3Oo zynA3`VYbDfeyRrz_-4_cK;mzSLRvC_mOvAnPZ|nNw+o-0O0R74NS{+T=L~~GN3;6% z#k&A#gH8&r!q%RHJlxzxs}o$h`NwV>9{iM&(kr7;tBKnRDWu1n*a|5;S@7Q$Bb2C0 z-%3UPj7U*%4?&7xkkQ)=ffh#-B^QEgU*ejV%9SN1V6qUkYl5J-BFE@C} z3baE=rz3{-z-kYfz6ZONo%5vAajS*;m3Hv}%$#e1aiVU$78rIOJ~VKRp>_Gpx^-ff z{DM)XqqZ(QDb=@c)yqDhn6SMk&z?0Kms4chc0Scp{YQrxxx&ON9b*5@Re)XmO|5#@ z7>-SS`*3Lt44^*qZM|qJSkebT--AE=ha0TW zLtp(ZLmT;S=SW}|oucxp9Wv##{;vG|pR%WZ00g^lh`*@Wn$lFML*Vexf8{Ruqq8Ew z<2XfwM#g4;eC?%#zh4EUyWuK;ETOHaOb}y)`yT7{=QsRs%ol$ECbD?vP>a!ScsYmu z&mR|$F`ruVFFn#QapC{-Us{!LFK7#>LLU0B|8U&k-|~+C_20tpo{|D3MpGyP3O!NF!=lAKC2GV6YzU-VNr-LwHn^owi8-oh9R{qr`% z9NZQ+_dcaAW9zY{ia`9dxa;Z8(b8g0tE}o%{dVa7DH-<18Zq8A`|e$+3syda0+`r9 zJFC9+t3l_h-M^YyKG_drM2P!C3_1fYzQPVfGl;62Um4bTp9_=ki=zIJ{fk}N4*-V4 z@<4z@1h4+at&DuV)8ynEw`L`rot+O7(dz+wI3l74m=Y$`reLlENdTPZq7~HMVAVGdQBn+Xi^XmVYGx!sNWB2U?vFNmTjZ;xk zwMORW=hIeHRMglS8yiFFA{5sbArUJeU;!);&QO$MXzXs@ys3fqrV{3DTx$lzp`W%X zh7GDYfRrTWl)ea8M1tp;#JXcxSeI^Eq5o<^8l-U7V9ChH4&OA^c^thCz93R`0RJbx z1AI)O1bq6enEp{X1uzCMZkVhh!6;HXQCj5c!fXQ{H7ei~5K1n0Ky_Yo~XmXR)yfl)WLy_fYHyuzhL46`ya5YO6;0n9!)F0<9m79_t<3N zVmK}rw8I-ixGBgfDI4B9kg9z8l=TyqZ+`fwEo<1|uDwgc0C ziy8iDF~J(*7_M#F_M+;5Y*fiXb#--_DNVrCGIDj>>4Sj$`T_%1SVmAZjO;=^d-jZ; zo*rBtvp)nX!|17>7A&6XUnI*sd6FKQBo@R3=3B@3VE+VO*KUGnTw{(IKVM&I00>x~ zH0=Tdr}qkT>aSK9^C8>1Hqyzd66jUMn;WaZsrm=(KcRjH(<)~6Mqru9JePD?2hS5~ ziSXp6pndHEZPg1N%iv!U5Mv)D9#?BBOza9ll^XGphh`+d-W7tDK z4!)fMg!#Ba5uZ!2f=@~sCsd)pg3t#eeCt+KBKVcqOK<|KMF&}Z@?`SmWADK=?MVf& zM<8UR0r*pO1GstN&k%uLdmRDOeVUg@yu)=^xPItb_L*Vh5xl16WgZjA}7BHQK|_&ce)$40tn- z9z|ZiLz#hval0mBzrw^&DJeXJ%Nj*YBvos@Cynm{iHQ%$V7atx{lPF0=zmE~ zU%@mD-r)u4Rg3vxb^7!A0$2xGz=)+Rve=4X@q_UZ)70q`C)BmHsK0`RPu#m!uz;y* zY~eC555zdEO;=tzh}877I*hqd!k#r>5G$W6;NW_3`03n(evP@;Z4AY0_un_>TNp0q zfT7unp`#y}4D~>CqM%N@C$=2+@zJEu%?q#TMO<@oa!Q?f!Kd^T=mvYAwmr7x(J<0* zx4^`A$H!kDr?DPQ$?5M!{C*Z-I|~fTT##N`=rGhY0_V!Sqi7$(S97*KMRxLQn32jc z*tA#5u0QF$k!L+{-q)eIsVUkH^d4C{t;eY!sqp$WF@eJ?HtBI=B%CbQ*xx8o8XwKW z0msJ#+@g{xn1KarHm{sFR1Z3 ztY)I$$M>hh6A|`4FPLrEW8f9qEG+ckf!Ww6N!@C&Yx7$M54XU^cuKbO02p!vV5q67 zYqQ>gRoSTt-&Mz`s3;{q#z2a3H}QHTJU{C932I~6U&|s+?fEv_dN^8I&T)nVKNAfwXu$k%_^MP`}XatVcl1*ld02sr(zVKuaO{gg(vsIl7QR< zR(b(UgcQ8C6P+9!xh<*XV?ZLkG}~keuAus9@ORNPG~utGaF);%NIg9qhr1XxO4;nq z@`*9ZdVn@HHFe~y<<~F^K-4mmF4NMA4FWYT?mhJ>_=Do~ebiy^d=&Z%z#ge#Me6|{ zDz5OZS#Qa+nMSXm`1p8mc&a%AKCGr-k+iX~ktj*OXZ}WRgu{mX=3}O|NF+m5Qz4`%mASik*Ll3QzZ+@3|e#Q!xalXD+|t_AQ8$HYNj)Lw}oFn6;fWZ;My&s3aRLS@$vCtHDM7L z7#P43NtBB7pxuDK47|0h;o5TRIi#4T!V}b!r5mu32=AzBt>oDrO_f5X`#jWX8r83> ztE*{lph(d`kqPJ5La;9|13jhwx*YgZfKPC7aKN<(HaQV8o+>^jbl`=@BaTtCICcEB zR0y|gO{Pec!Wg(;x^!wQCO%bz+ECN}pEvwWh)-Y8WJgX~sWXfeE{{jj+kn<-i+O|n z2&dP@OP6YJ;$fU3tC51P(T(7?sRPAO9)?Y)rE2LGST+H?3}B7;Fa2~FZWUJcF2J!7U(&1x3og#i)kD@*rW%LM zG4U$%`wQV1PKuiwRuzOBT=rQN6oOSMU--E)WHiUfgIur))Hw<7V59n-<(eDnH%btoPNI|K(SsOM-~Qx}V;Iv(D7=~|{8E#Y z^B0gUoUi0$JS+WBYS~olESmX0zkG z^g#P9;?+BvsJ2K*PEKAyeZNc@JbhtO6i>YjC^H3@xfmbHqPJw1Hjy&;wxt!VB$BGa zkBHx1T?(ad3YiJ8ubM7rGg~utB3_vObXPloL>gR7j`2+1@E`_iEzNQ5j3sbJG=n+l zE$8F=JbP-5Dm=(S+}*mUpbb6s`F;@VvaIqa*u{PoFnXyju%)4h!7u1HW?{#Hw`1D< z$Ft4eU1)nTKN=G7%)XvjxeH1;nYya+@Cz@?^+5qRUua^E?hnC8Zp|(sD0)koQL-ujlrlG zOe&RM6l$njSXeCoRbE+Hdn_{w!KyR(p;Ct(4jmDZU+wk!&>-$uy(<(ZjGM!85u99H zNkVytTFUyP-$RWQ--UjyE=5><0=z*Z>DA}mL{c!ZcSCBZhvG~PI&XcSb60nA?0TuqM_NN{Y?-CPv!{2q@eg0=psxdQ|Q_babc zpl25s1A=H|662rNL%FEg3iW485mZV(g7fJ-^Zqi>B*Nea;+nkufyl}rm;MF}dKDt8 zngYWXUbo$RK`=kjWdm?9occawGLIYD+ht$aNLSR`V#FVJ=Dx$}fro42KxdvwqD@-C zObwK%VCtwzdR4mdI$h5tz0O=o1tn!==;2c-&{AndehVKz-hyIwVL?$#>nr$S-ZqzQ zpa!Y?6Ag{%(&3Lf&}@9{0I*z>R{Ggs8vZO*Qn9+wJlJ9)zT!<20|PSPO+4SGX7=m= z#AuHM8t(!(!Wx2zt=E3=;KAkwr|L66niD%cpgMjy&R8;GEWkE+j*uN3CHTzpwlJLx- zMISpwN}7Bc7!;RXfy>{{`ozSfIYSCu2kpS?Qlqh>qeIQl9wQ!;-(u1QqqBA>y4Uej zh9@tE@;MYqMhP|D2TcStW=WrVfVSDHKtVx4mk`?xCi=}1x)QkNIJh%mSmub{k0?u& z^RsK#!B!PjAIh=B7R{O$!S=&Utb}P08f9UlZ0|f!7Cm(d5E{V3=EzF z$P+E@nvb^Kb-3l0AI*c3NaVFyNN(Hm)SSgI8y}s2-wHngiRldmh#7tO55)K;CJ;SM zG)WlJu(e%-+qy-)AzKd{SvV=0AiMV!Ui!a2|4Mm%^!? z4@7++lfZ5Tul0nt2M!-@wT|h2lSnR#deQJs3QP^*10i5Ib51lgfUwXn($U>5o(7+O zF>!HLD>3X6oIy+uIzE-Yk#iKDisyywrMDh-XdUGD$ahI|GnKpewYZ5Z?Qp3Dt3UX@MN7?8B0aq~L`WlBsp zu{Ge?s$hXxZMFeB3;udcLX^lec*E1)@p$?75ks z(rReHJSJy+*vFk6R zqc%UXjOJbBv0b`XD{pOSi3wzMj1aqoEwDnL6{d@?Ok?u(BuLE0LbT`TpQAm0fTNvG zfy&}5a2k@`nCOLZW_U!Lu^LPyM8w4(Bq43x{EB3forf~-`-{rpC<?!MZ6h|5_nUT(W2q>Jxf`V%;v?y_U0xOe;b1rE~@Jn{(Y zfOkI`-E3dI>8}t7fJA}@1^wW4c`gv3@Ze3I8SBXL%>P+Wxb@X?2R@EXZIKwh-`iXN z2aI)(sQ&t|kl!Ju$Wwc*p8lIBxSbP6Nqpebe;_>(^^5CaaEJ#a_a$0dw;$xzZNces zt;oH9bRRx!PH`A%juS2#qK=%=09HR1+K=4LCjw>r?D0AP;`iT5RYLG*JbMIxmcKLc zvEsWzfe*|pf0zk+nRbfUs08iigmLeO|h33!x?RUzT}DIx8HkybXx?tGsFXG ze=`8|?nO@(_x(a*G;t_* zb2b0@&K^hDh>L88jJ;&IyR2mNKRo%J0 zd&&Qect2Yk0FtWIGiPkI>1zG3SPyyaI(6J_QBhYnH#ZNDBAZ3}*LnR@j`~RS>r*72 z@H@qQVMe>bgqjugjr|QkH}EFaX>K#-&qa47i20aXRe@95&blc9>L3_I}+^hw+GN4{7T0u}#BUgR} z+!U%HUgVdJi2#Rq;#03B&hQSrzvQrRVkyd60u=5xe^|8a)`T ztfZs_C0A!>XSdyA7vKakAmD&g6vWOtDRFUHP%h@Lmx1(dWo|fXFs2KOmH&yx=MCc5 z4bm81q_sy@!XJ|ZmGL_^iKx8Zrr8g=DUX`d+5Yw*^G4>CD-) zP!%>pQpRI^ZtJ=DWU#fpCzO>e_wMFXIaLrd?rb724l5G0>o%p&c-9Rj zq;s{?<8A+(APF)SPM+3Ger*nz_k(#OUFfkPKBPrz;IH9um`MZc2+)G1%RG2-5uwd- z0NesF^p7D_&bl4hDWSJ*)6=X9K~az zOA$PzAx< zcmQ{hfS`#F1xW98i16X5$qR({9*TiDl#2ehnSo*dTp(lVfx8*1-^At2%3?L-H`#Of1kiI<=KJdtWv=?s4j(7& zysFoRzh|Fm%DuN>MR;(A8})TqKF_eHzQVmV$);e<*!6zQhJDsh$ung%V-dVrW^)Eu;}}*^s*l}o^LGz*hQWjFhR^DE-MKZI1z&irb-Cr68G+T1q8^7iD7^c zms>qcMfg(?&NJY7--M%f?Z!q{0M|Q4-C0=HGl6UK#py%^o1eRd$SKtvCGMn8I|)qb z9U_r^i2g=xHeM`%TWGP<#JG<9?Rj-q=&4FUC9ra!1iCpyIL? z)+R0=TUm6FGRpuc=c4F)4Ru=+{Z|44PPKk|#=+cHrrQiiidi(^n7nz$@MF)BG(_+j zYH5K(>2%5?=Afm=szyPN9*m)|ddCw=Hi_#7SWI1XMFBD{(YMeaQ zbN}>UzAG`~nje{uAn41bgWhBjD^5U)i(hOd01xmuGoG1QwQ?~7N)eJM06Nr6lcu=ugL2v{Y zLnf?bogx9JwmxdNGc1V?@N)wkRj9jor?p6PG-I%igp2)T0_cYln)72c=Z1E9cpRap z7YFR6NRC5M;nH1lY^L@e?Ya4sER%MkeZuIxOg{-EE zyRPmwk7phen@s{2Y42a$s=xrjWfgK-*mFQk2&`jxm`dPl1)M&h+Fq7ArCxbtye-8M zcuGKQBo0#u5wEn1*dTAnxf}cOIQ@u%q_^fPf9FAd}=MM$h7jWFlBRp|gHUsVm5P$e}n z>8}hOKIZBX@u@Kx%M86@vi-i%!IUVtm<(D+@<7vc-&4Y;{OQxLgdgq6NIPrm>RNN1 zh{@`5ZQ$TuS#I@~`Jrb8ej32@k9$i}L8ti`n~?zg&YsPs@&W=bu6&h3l^t5DSh#}2 z3aa)#N7`Iz?&)Kfd6JbobejjK+(S;+ibVXTco{GhNV&|D z`Bz~Sc17SC^!(rs)l*<4#S$A6v-hvRmX?<}fY$;DGfQ`_QCWF;c~6h3!y@F10N4)G z-UZ3}@~!xcQ&-y{B+bX^K7+dqPk=H+d?ls0xVXIb2eEb41ib!yE2vwSyq&ge8Fmug zzKM9=sC|MUzW-G5y@S~F0;|5_i3tDYgyx&jMkgBUO-u}su*_g7&{vuRTsA;UOksQN zV|lpD80TqjH3=&dcb(nZHZLjxDkby?l zBi$4`C#HI~1O0VWXCt7mLo+0e)&7x+ASi2B@<}2T92Bx`Uy@33swo+24+Mhr+!JKhTDx~iO2EV7kn zW0U3ZJ(OB=2X(z@P_%00sG{k!0b>k33rlNzdwX5oI82jrp~8a;-UN2N@Nk+8olK&y z@0;@B=P*{zeg9qs67FFZn?VDb`>cjw7SRd=ByuZlEEfW3goP`QQ3=Iog@=bj%kQ#@ zk5%S+Bgn|rx=S7a@^;v%1Gk{nB{*=v*~P^=nh1U3z3K3m-d@Oc;Ln2e5P|tSSR`AK z21;4JneAfrH$CRbL%`)pZX`NsY063VOKC2}v~MQh1mH#^d*3kC1#yWV^cn9W`aG_D zw}=C7iV^ECyI@ZWQb@e+^JP%Ywl*VNR||C%IEFO>1v1VboXG=DW0MWK&g$TfzN>n( zy?bcNA*|XT=$N=7P&+`x*mW3Y&?a6}7YZ?VD85s#tMuxD;aI6*3-T&5a_!4*GCS#a z;rPz=E(5=lcil8$6GLIBf`dc4wL_HQ!Y##~p=Pd$R5bc3wy1ySzK{-K;==e^y8)L(oHkYB4pnUPv}0 zUpGX!!7^;@11kS9kpSf0)OJu_B?&kMIw+sLmhN`6{hDa{4nQPYXF4AMK3Z4Sg^5UiPJL;ot8x;e$)^i_-FaF>K z8yG$hDob54PKABZe}xJlp;(p3VDC&QGj{I|Uz|;%5@=5AAvwKOX*7$O-*vF93-Fq! z%pTfZ3z_hN@CJbAm-V>u1G{#BukVHN409NuDTo4dw$FA5813RPB8U5pPHpiy5_PGdOp z;DJVGk$0!A`crV{=Hq%*H?32k_}MHpk{e_*P@t{EW^!L)NH#-EsM!8UxPLC&(!M^L43hRx08%DEwHo-ISFbgzvx77ovSYp7fC`eL6U{T%@K>q7CD360iM~1))Y!T3z1@bG&}tSJ=-7w{Zui zN)3zw=n;UltFNU+1bUArPZ;PFVM=pXUV0YD#HSfl#83vE-1k$0o%F_rhQ3LT_1|=m zNXFbL|L|fwfIh??l-g#xn{xrOoQRCrJXxkzYV)Z>H*YuGs1kh2V29V0ab}x%JR%c^ zC_*-dEEt-jhAkvw;S&L_8Lu}vEN=y+7F4JzaJ+-I#JJ-1Mdi%69!5prqVCd67gU@oPU%i+SSTE94~dNj1` zD|1@(XKYd#PozLMJIHF+1-F7IyqTgW+1JZ&Ygv{C!hlDFi^+WZslcyl2alr5h_-*L z;ZY5OEQc<>uu$V`qav}J-R!orZIX@^nNC`8>csKBl5z#%NvFiR4MI_OV`B~1Aeq0- z;o~DHoWIx(E!ko)wzr~=3Xz{d*Jkg8j{C57LHtXD@Vc>WerT;)>-@((BGsNY=VzOY z&6&>h==plhcLx`g7+*sz4moUTq&0RjN#I8+IeiZ0#89>8kB77mOnt<}_M*TZA!s>S zTO=Rm0ABCFSsa041fTv2#Z2wVR%5Vuq~11&I4Cp9+up?c<=96MnR#|VWHdnDGaHeW zo6GL^&av`Y2=})eWDD-_`awIIIhc2Xf99}VQ2crkRe1|Dv3dK>ohFCi zFwE?AE`ymJJgek5l0c$%ZwH9GmySq(g;Y!E9DhNw@`@jp;J{iy{X8n}A0~6iK;kwT zbPJ}|uDnZ5^5<$Y`+uq?;emY|gEP89d|;$s^|g6t|GQ^fRm|<*f1uv&ALw51FSaq; zp|)Gpbw(@*C6>^r(05W^ncp7ze*WD*5Vc->zNKfo4ZlD2?Ik8B^mwQ$J$)M9oFxRv zv20#B1C|O#72 z|H=f{f6>qXV*CFiK~SF$&fxtU{Mr@Ti;wvIA5Y(YC~~`zu->006%1A1uBSihlAmm2 zyT7H9|KL;>0k>s)0Y0fsAEqFLbQoY|^SACWntSno7e((hegN4KE@S{H96-BHreFEE zt0en&{@U-5a<|vhpM}ifevnFX)^68t%-F$=m)|}w>y8DDvU$4OHq8>A=(024Up0VSbHvyoZzsATj*is}A z0KHop5*;3s;wk?{`Z$xnXb^l71A7{uB4m;habOR9Qqk$Id+6gRE->^vPE9TO81 zC+7-4{I9+^9YLa@OITfw{=F3qeS7On0GjKRV`1fm|GZv8UDv5WtpMdf@`Z8ouTmy3 z>jjb^5V79D7zp?hg}{Bv)`8enN^3pflEBP^GS;h5qYvtO?bYsl3klr(CSd_GRs&iu z@C{G^bga$|GeeF#=vCLzm{5+{kIpA_`k*LbP$~HICaI|bq+MtXB4QF?#{BD=@-Gq0F?wL=8!de_L|xa;O_vVBdz}YSHwJ4GV=M@3Yzu_`ZU|Sqo|Vp>xC}OS|-<_ERD~J02Vb5034I%?KQ1 zs;#Z@`+0p(sG8$DFpDwtnduQIChai@k7xOtSIa_*-^fM-~f=x(&}J zil<)(2iw5aC=_3fYoskjH`X8cy&aX6PFys6rvF~O`*#8I!1t*ZwuyWc z!{w==Vp`{4Zk~frs(}>)l_IKn@QF_nM7BE}9@Vs8EdMMupeTYXLvw`B1@rcGL8l1D zE^{P&1U9N?Cp*_$&w>RI!+mon7v1RAeOifD#6Xx#EMBZp7*{_aOiD@oSG@NPZRswrH!ZfZaCV9gGX3JZeO%;3@RoPA&^LuZ@svch_8? ze5^j4hs$O`4+|W1!9+VCBxE298R44A!r*{jr65p}4m862{QS^X!RiU1SNL!r?pViGj+S8-_I)(7FS= zmQKE@ykKpte9Tzq+)cnovowr@*|jyk;iC%5z$QDS2?PfFJ^(;tjGCfFJe&4B0dB#w zVHocUI55L01cMy>bpdGhk&h(_Op$7XDi4YEG8nD5tm?er+gxkLVwZt(>9Y(2ON7~i zn&>XfUv=QHU(3bWLn0$EnL7Xec0PlGB@QY5wtjDU|4ilB+B!+S>NS-*@J)M*V4C)T zApy?m9dv|DK_Zy@K1#@wycdk&zI^EidpTD>v`nNf2mzyn<{^w)Z+#`pVq7I*0Wnqj z-OtWA{++s0jeKaRON6VZZyB($Z+Hyv_{%jBJ1XH!8kVa|7uVPPbi6&Pk7WjS!Sc{+ zjUuT(0)J>f>&!Z&rxUawY?U4~OH_RQ%Mii>I{B2f?ncF^@)VNQQbLk2cZ)B6p6chIYiFe6%6 zY99e)QsXkUcxZgj84{AK?r=I<`Ae-J7g-g_7uOxT!;~fj)L-q0l$1gAHCH85dvA`Z^6DS+J?k0>WxNZ*5oGrkOJt8pvul_wtos zrNr3dwy_{0Ra@4pVT@HVFbFbmK3-p1>R@5m)1V64UCYmr&Vc`)8yADOxo3Ac-_g}9 zz23n=os7Twc;oF)(@5X0&ox;8+n+9kll|oKx~J-WijN}7S-Lj*IMO1c=0`!=Emgwx zuO*Q;aQ;pX+f4#u&dj(C1;=nL>!y$#k2}jL3Op8*X;LExtSVTU&hm5Q{tl|bL0|z^ zq(nqS4h|0M75^i6=of^r!p*%6vA9H_c54qeMmdeaD=H3QfF9(>O7Exr^ZZEhGL{{+ z2y#_OQmwv%FKc^xu&+-!wX+$*rPlfyR1x$rTt7DA6tlgy-t3_J=6eT)!8q}Q-pU$- z;6pgWqOq-2_Z#1{NA=p!)6h{z!k5t3XvQ$_%geOdTuz6@nt=s1@mm2K^RYAO06U#R zcjPnNM1hw8SxQH`!TRnXK3ff4p){4&Nyia5u+x&3!A~T>t{AsejX;RRSA?@1)~Yq+ z-8j-Yq87kVyC#5Pba0R+pG~Jf>i$#W!s~5oBKU`fR=&74tgN)Xw;GMdoueYTBz$jQ zZC7Ez+(QRU>{#LbHX!$nOVq)v6h@4|#j%2u1jbkZueUTd8hw0qY-<7wMEx(DpFwPa z^8m~RffB18!HgEdtQn|*R3&@+_HAkD7OFy+;z8OmKE9J9K4D@xT&an&H2_DlG%I9) z%UnD4Zx{P7;v%yj^_<M97F_)n=cvj`+XhZog@{7cDz$BS(+}hS+HGi zmEF^p95y+kaA}@j33#LWt)Y2+(zi!9-&s)iO8Pl%RMwt%)ibzpLw?WYNIe>w$a`6L z3N2H5^;(Lv32%l_djjUeWfO~U!rWdo6o0$KA1*u@L@xW0*hw_v(#iA8Ra6W zF~(%oV+T%{?cBSaTJ*MXFU7oYmmj4YpfQ)b_cII320hgUa zrLbRmIC(?zde%GB*(el#fE&|#AAg;=#&m+0!V_;n`VY&5)ygiMAhNNa@u84OQP3Rj zK!;n-q@HC-gbZK#0M%}0i?3rXQXS=nv;K+E^9x)K1P(97?96R5?ZoT!kDkv zH|KL@7`&40oCz132v+`NQucBl==Dqq2*p!3Ts?(ChP(3@1VrptRgklvmwG3bVh?#6s9FlRfv@5`g*VZB~}okY(SEr zW8TO!9?Q*>t&rttnETn~LlPFD7gv&5CII7*)C5_`4w|}=R2EKU*tm^HUdJrYx1L8(;u#jhlz(0*$jFM zqZ4Jg*tP2>^0XJ7=9^DZ`n!|!2xGI&>kdJDQ5^g7yt#hu3i>PamsG~O;T;(3hHsl+^&AY)n73{gN zwP2U#*(Q0Wdi9g|f{4CQSZQ=!O0$a?PuRkZ)|9NXLA5=pa2Y>Z*6(c~^-SEq}Wzah|76!4}R=M3hk+ zX;)sX9r`Rnos}x}b!sUfliXpgaS#4RzVoRNzAVWoDgX$NcI~2{PRO4ix1TDNi5j4$ z?otK{LwW-S^Ad7iT-(Qv=kyd&ttO*6C)WS2AIb4}PhYSQsLr&=5k#t))zf1lCAXwk zw#KqQ@nA4w_Hc8e7T%$yb0dg=KyD0LS_0;4-7itj93s8OJ%j zAZkmLp|aO1%JHw)YfZG8D~tq#Vx^UZ5T&7U zU8iLT{>4nk->MOp&j%g0FJTpYp8gS*;0KY1en)}83{R6`>uJV>%h95;k2_z>Dr=e3&{+US&u9~w>UiBWLC6E;|0wfU!$^}ag;TcJ!Z^Xoo| ziKztVo+5gkcERfgopP1+5)v-AQH~VpcaKrhPFL)4dU9Xx;$Mh(%4ToWV;%M3LE$>Y zYy5`f)Vi*@=ELZf4B03(mVDrxXyM`SZhx|K;lGk%)m7Kof?r*Bv*fS287+1*nY7&^ zKO$X6pAM`ed~(Y-V3;6GVTWksqH3gpZ@RJem2Xx08!B=SuVrir`OQ7Kcr0=GeYEQd z*Yeb&l@T~jk;=Lm`8kk(p6-r9RU**t(+@Z6>MwT(E8kihG;h=&hnY@4`kVN?#QrUO zmCLi=pK(TTnB*KwJ~uDR=LFy%!Yc#1Nyp?Nd%MV28mvpZI!+$@aNLml$$sh=GB=lY z@vWr?IJm^J`Wx7{jNQYG%^IBebq^$Ai3L^BwGDOSpksmYph7Y8Qn~Z_*VtZsJ*iv! zMGK}&C__&^IPe)Co~jD(m0+CQ`(;VAqo`2O#`GH$_0G#bPecq|a>I(flI7^H=6&ziWm(iPV<$=+>*;`lbIM z3)gRm<`qeF-_C?%=j*(V!x!B<^zjiR+V8fQcX`}Rol?QmLA%74C|%CK7EyED{^6%! z35yfRU3`w*hiSL&?c9e>k1k!kTKm(9FNk`2!u}P!@#CMiAJqYPPj7v8!+Ua~u>W-R z*vY&4v|VfQ*wTwpVw;xt&?n?=X`)XnX?TlfKAY%jXsCG~L+e@Um`0=P-N22W1uB`X zj*`kRJN~C9f9enC=h%vW&5Z|bUR^f4*K1mG&02b&?O|xpYOar~7PQtjXP8~c_oR0KhAOiOMpkcsUeHf}yi?h^KfhC@YkPFe zHPI-djjkdpF22RgKYf!IGDo)-hDFJ@rHs7dd-o;LSJ5o_*CK6j1G63KqC7Cl4hEWU zfz@obL08Sbo!9v0-j$FnMwYF7j*F*Q@-vjss~dOoL5t&lhVjea2kF@-3ua#)Ap^lL zZb?cVfIi<6D4$;*B4)Zw{8{Et2hgseGk0Yz`WkM75FALQ4$p=%Yl$bG13lleq%fHbxC;OQ)M|Dxk7?)U z!y`Dgvlx9Zw2akQ)=jKlAJ0HHIzI|Z z{ld5idrr=2-;3>N*wDl?zdJzx02iI8?brUpoRU$|^Rgjt3b^`{l_8}Jq;KOhCI zL4fYJ!}HDld)qtahRAvCI(nP(F&14_hCb!YN8b0YO&;sL=Ozsj71V<3#SK79-cI;qsJ5&_P83S>ESX9+`Kyzs)kxgf_A@2rJ&_y5>?^KdHH=zZL& z)2OI~%9IqPB1B}^O$Z^GXTnzI$d-$Hf z%8dYU&R!li&PC6*SsN#+FZA%WIF5vIBnaADQsr& zx@$=^_6zA+68)g-uT4pG&WDZMfaS2xLg5qtp!F-rNhNeI@?1+)>KqgG`t}JvdH$_1 zzfmne2ZSC~nW<4ZPAIM{NKt4_p%NRq=b~_JQ0FVt^w2Hy;Ie;vHKA1Yrj`joj zGXqUYgP`Cd;rrF*o{Xjf4?S!&dhgO?$ZCvQ<^oXNR-g62CJC|Z_0!aZXc@nx4iTKf z&_17BKFO%HsVAS@cT+O3Id-03i=C<3zOmPCzdR#Aev6nTaY&hYE0iqo-da*d1s$nx zVWC7NMVSgGWl4vVjUKj^PO@oe&E>Ta;87A-UBW&i$&AvioQ#&`oy(Oq%gGHe%IZxY zvQtbM*$;`S&Ab=t_}Sg^)h+NXpt)_z#6F}AhC43lj1xVG8emI+W6dqahgx7 z_bP;`Tkl18&_EqQ>YbgqI-6cvQW@S`C$GMjX~|tYW(}U0YGhHBh?5z36TdQUq@W(J78GE# zAe&U4pefIJ=O$~GZJKEh)LAA4WsX@Zy_sVP&?A9}R{(-Bi~g@4v(SQLI%ex-7hTee5uK^l#xL|RycV%{YCiOU@;TY0YEtuwvvZSX090f=D|2C$yz!+0 z#2=8PJ)t+b>Pd*7)hN_(gxY~Tx|Olle2m#zx)>a$5U_Qa3b6}8EY1X)!Gj^hL7rs{V5Zu70DFZvs*>XgXoTMmA?HA5FiiW<*t0kjC#A)DUOe*yA&+ zGF{c;qduSepw($?200*(GWpeYq>Uattj(Dtr@ z!h?xord+X{_Nwu4UttC`fQHt_^R4CgB zeQQvI?;{yb9E6{9N_G}_;tosK07MobK_gCD5xaU=}A5_y&_N!)+m=B!^p^ z%^ql;4ZUbif)s#J(JYzY9%Do7&?++6fYpWC1e50eFO#<`Z&+FxDA+;0ETf*e;AWp? z-Q}_sBxv4+-RkyT_ym*Hr&3i5QhFGfb)IYV z$;^<&IH~;u(V_Z6gSH7w(q(2U5&qGp%tSEp&?GTt@s&%6e_cM#WI-F^&pVod1+fHl zoe)NPCbSuM(AgxwQZ}fViLYJ$pna6HErc7jleHz@U-esWfH4UvU=hnz!gLN>Ga<-A zrQ^?QF%tX~z8a2Nz6(e?uyUyR5r*`XS0Z4;;{vE7&LAB~0SAP40X^d}rB0{M zZ323}?L&Z`v8|BUvaW8VrwA+PWaPUjd_EN#umuR`cKu(YC*trYxT+7(t&GHJTGkTK z*%wbO)p0;!43~A0SwTzS|y)Y4`R1i;pgmAy4;WytY=eCC%-)70Y_5JkG4oGhBezu2`AF1JiIoH+c5)Y1xY>`E2fV`p)S~ zl|AvuSa$pFJupwm{#XxT&?0o1WT+IEE5uFs_(AOQ8@4=!kfFQTO1CX#B zx*|~5J7dTxAPG!|o+tlm3OWT!NJyyQ3j}aSc~S37Js-cj3+}3!!`k3S4^eX$G5B?s z78Uh__-=#+SMV6}A#+AB-ip=zN+B8dM9KjDOkogw%zk)Iz)URT7#q zWT~YgcsH>dznyN9U1x5JqvOYUY3W$jMxTP-Dpj#S%eEaf=iW33QZ92}C;p3U6z$V2 zL>v61@sy-ntlaQ7Dx=iUoB9~*8JMaE_wknliM)H-9w-B}pDdW0*r z+am-n>$y^KV~3u;53O`u!CbaE@X$aE%Uj30WIRcE@4|*^G{9T4KFbU;6$Qrr5eKix z`aV_cP*vEFV|4GeuA0i;zHqb;_oOZD{pJ+9`@>dH-q(d1dx+~WME1pJTaG^3VXO=Q z&%V_nh9R|k`IW>twERL*Yf{Y*6(6<222$X0T^768K`I%kx`-S~*jrkI*sieYnvjs2 z;T0X4NOa~h(HMn19t5l;q+P6%HV@z?CKX84t4?eh9ZfrR#wHoP!r+FE1;|Cg4n3IJ z;r1rNDS0p~4bWg}+Gn{mR(E1e`V-i>?DfKggymusI=(mx8MnLJ)+^G?+Bw{rRu)#J zbTutw^Q-CxvnMa>3FEUtco-PfuPh9PDQQ!~ik9(}`ygGqMXc;VkZ zhyDTEI7V59q|d@ZI|A>8 zmlV&q3&t8@OZN#XYQNsmYXH(yIs~Ga58p@<^KTTVH(wjTT@X5))+~HDBU0pWwwqIP zqq%8z>sh$qiWM zn}^f~d%g(#i}iG@=tR?{foQx7Zr0lm%cxgM6XCDww_F>eo-HtLgwf;~#o^O3Qnz@P zZAWPY9J`{>>9T{Q;~kRLe{-apnQ;4aYH@Qx5A)2wb(X2^<52Z`L@XZKlM#UVElYlM zmHQL|ogh&2QW)CDHS3#)<|dFY&Ny-pz*~A4p6i50!OZlrQGx&PJ#G%Z$iKY_cRFMG z1^F(P4TO@Wa7K$lmfIoXyuXzyn_;Jw-)nUaxFWnbAxQe*v?%u*H%*VWx4+-OYQ}6& z{w&hHI&xPpoYsG>nFqOfZs`QmZBW~Rh)#04Ji!vR0n%I&_%mX&5qiJ>dkxmfzjTIz zV{;XF_}f#uP(V)p=9<$)UdI+d-}>J@1oRC~#*FCSg3?rC7f^bbljy|6#4@>KY=RUa zyCb(zDr#@%?r=Q$@;c+AKO+4HE?3nSRF}K?)2OhQfT)O*cQb7Cm()S`|CbH${~>6t z{)*mm+m3BDE#K8Tv5r9MC(e&XHuO7v0>Y1M^}l( z*9WH(5xraoe=WuM&| z928>RG#~q!-0NR4txa)4PR@H1%1CLe&B+^f4NCmyBX@l)YATGk#YOz`+F+w3?Ebz{ zNVqpPib?Uw8We3U;oA3ol2#@phvg8pDrZ57@kj$kD$f2_b|KmP4@aYRVuDv zb{)~BPrxW69-5q7ZG?Q{F0^MURZPBE_61!4=l+D~W5EwYf`9qp--E{5F5Ug`pFx9C z2>J8}YY8*>q|;;Jj2s+T$YS`jwLs?!-YYM>a~Htrp)f=#)5^RN8JaQP0M2JTOFUo| z(wIT&4)pwYBAx(Hfz6;D)V2VU#Y%@)Jl;n9(qN07)dD!i{obvC_yyqQp?|`>Du>*~ zZvMc9GM0^(Op9@)YTQS0O@O0Bn=vk%x7D;8EGrMZ@_g3EKdXE}4;i;PLS(0Bda&U@ z8X>XN9}J)h3+4^dAPJ5IzYySOyrg|L{}V!D@!vH!Fz`!r@_Wv@)|`yjSO*7 zo#Oe=%RO?p^)Q7r4V{D0*21M0E106B0kYl6Au{oq_Bjz_g{1%>WcRJCuFMAr(|Ac` z+qFWiWgj$qzp4};&t_FN4MTdBq5jG9f_!YB9EGBAf<~1`mN~Ndrh+lsR%#DoN(})A z(F}l`iYbno+eAZw2V@-lf@;{wAu_?^KT(cf;`au?gRn7Q3yR(;A4#f_NL^W2+14x> z)xcN}Ei22e^1hs+)fGCsZr8y&(zY~x!M9CCY|&d92<#kG&uX*h%RkTgL)9J&WrSu= z0jp2&*&yR)|6PW5#?8(F=;FZ)<4{8%!wiXbO77fynIWGnrnmJGN zyZ}kvb9xl~7mxXF96h3K9}MaXY7tub!^G<=`WUIzm;_;3;Zr7_XF?c0LXIWD|EX2S z$GmdYE-quj<6K=1g_o9`WodD)o(z_FwV=T{W4eisa032UEz-rIcjxplxsI#M8P=Yz z?hHFZ%qn=mjAw3z?p0Y?*-xY;M6}8D2h!3kplk$#TK6==lrE-wJx~SZlt9z_;Fk^L zkLVU6cxEUznRZZ(m?dv`l16>bMkA2xpaxUsxW5 zDv*C^?5Zn&GXAkc&FIRqF`$bL??j$31!tUY>h+Y=qEvfO@z$|^H+UDuL63}14l`_3 z0JVL-8@cNN{u@@WWz3^ZruH+$yLhA2mK(q@bpyc1bVfv)WmebJ`wY z0@BA2NL{6XBA~elXl2n^jz~|N1!p&E?91*whrSN|3hCq-i~FS1LANtJxQXR&d%zOH zI5k6nE&$b-=_vhd)syI7FdND9Hgk2hi)#0a=sB;xa->URaI+Ak9U_*CFDogzc$Dr{ z&PqkSyt*x?fm!LNVqC-F>-p+-sW4zWcqm{ z8<|Fp!U_Ur*wqla)o@aSLG7i$-SM;wGoo~_Mm+oC)K?|tluWv0#o%QhlQ(Jc{N(ja z{Gw6*sy3DlBVHXRJ35?L`DaShgYUF1_&$)0Q_H;Ap-?rG`%Ja&&E?FcY_6N8 zg-l<&j-mt@&zl4AWc$%bQ>Kb|`wDm0mpl=qOFBE!$E9C?(qMH!chanAX^?L8xVZ;i z$P0$Tm{1?E%<5<{tMpwU%#qME0U9C@Q|4A@5(AxnpjcQn9_6$71=10jeYM!1;zEn` zmVGj3Z-+}Tt&BN_=kY^bon^o36b^(0F(1z-DF~tzWg!?f{XXkov6k=MP~>!;7lQKa z;MQMp5+?yuSP{TPu9Z%zha9ncpKUnx&GMrzkRG_sWPiGkP7+Ts(iM82q`uS{4q@+O zPqanO1Taya8X{;_L;C}+Gc71hnWT^n$Ri7C76@_y=jUfN0rXi0XQbdlsToDAa%%s4 z!Z;MH70dbYi!u0~@uobj6Lyye0S;uAiFjq+=b|}ZK(*t%-hFMEZDQ2&D&v#&v2G&F z9A2JFb1i*71t29B0e%Oqw{R<01e~JzB!55r*hu^82Y{~!Yk6#dR}&qVKJ}Qm!fwIu zo)jS0v>tYM38TULZ9Ydvt&-?+?j9HVSU;lu-IZ7xu@H(cd-G66Gj%7l@Y4K z3Zq69z$I!aa@jCV)uPoLZpdQW=YYR(*c>wg!%8suv4V?-RA5d69x^_y*MFfDkHd``#ek;T;<3@;-o$llLIUj=}F;TOB^=wm#UJTK^(r)tbs<*0u|QLFT-& z?$&Jo!4&#f4se=5^GxHN`KrPZXFbg-V#>2CT1j?aat1m&YAT(HOLc?l#tB%-=JerZ z=;wFO&bGW>TWF_rbtj*)lb6a_+!{Va;T?eB;a5oQd6-ch_%RH|nOrHEEu1)NcF&9W z@JicyLMQ8Lt7>kjzp7n~5cJgJC3Y)I*xOyAEWq0EnY~#I@F|uqZvj2H6UwX7yE*kriex9GNiI*kvI!#3W#2{oqglit`L=yjvAs7nSAEryX=E=1|^RQtQAU zOlhB&e$W9(tME{vD~{*mPxz%s6_r0Bp1p zyKh4MEL*+4YOm5Ya~HlS0L=rcTuWCRzNhVKXO%j_Rg(S;QTe(O)=9=K+gO`<>->4? zL!3B}?*g|IbNKLKut#R8l^h{v&G-t7CsR2BEj2K4qO%#hoT1UT#iXBpF-^E{){zjcNNZ`e%R47UrVn$7*88i6YmppsMpamFfz#USVX>;n3 z4G*k_UWSmSPGfICtUYh{D}PNa(wHb&JPAkCp$d3LCa)nL&|034hP$#$HjSgA|LaGs z#e``6_+>!_KOEYpP@gO%?I$!NNNPbS6PPGU*DPIKh@bSJ$e4)0_jG96>tlG(UP)*l zx@b6=3nVQjZ`4=QjTKxQ2)Bmm$NQ1pX255-@DvHvp|TM-=@-(Q&%OTzM>_N&2|YXn zr?#f-uNZ_qH2!D@Z9n*O6sXZ!cDv`SbR+0KVyCPsrTXYHWTptEMB^uq2oM2L7k*CM z{i$s}dp7m(S)7YR^f6%RG4=V;YIbANI`CrmkySpf1@3qMm8GZD%_?@5m6&0V+MG6} zi&&6URQaeT->oqP4qN9U^|?3l3iG{>?^@EGsEaw^6B2me0+65_Vh#=}k|VXOYF@=zl>U8vg$sa>8=yZP+c6Vf<;$!PiqQ<<5NeXJIRDIydrZ$SEu zABfb3ilsZ|fou61N|d{uQ(rFIyw<$qD-sRrx|&jqWg#MTH~_EZc{}GhuSZM1JV)2I z=A^%V9I(yi)B1uDAAP_)0S}7YDUb#|T8yCiw(Woj=K`hZAyEI;5n%{HC&g#}2*$%D z1Lvd~!F=@Vv$C=c!_Q?Yq?jx}%XhGPZP;!%hWDS>>{!_q)+w8I4uDRZ+=Bdh8$((K zg2^<~B!*DtN;@-ZKVBt#;q1egk9mswVs>}6^n8S{w7TT9t=VEp-?CJG^r=gi#oK1c ze5*x1u$x>e145>Qr1;W|Ia8p?6$o8O-kTRqV60K{x><%~IRdD>Yjfz_J-CWCOf(F_4!<&z7G#I-f@p2$YV*&Xr&_)@;a6%5Fr zy2*qw&~Y1p2+={J@2r4_iC0bm;YSE=?m#9`LO?kHY)zyW4i2v8hvB2I{dE#5uIlb7TUtgU!-GvZH~trmY@}iT8y3K236eeD2IF2ox&^qR`cWpBRKW^7% z%%}SAf5r)nt=2kahwJlq#*y*yu}$qLF|t3Nfd5SN`Khl)UeSagKE@>y|J#3b@Td9J z@9p91_3V1%wGt6se*yo~$?gA3y3|!RPcJW>O?crkj&(}cuJ7kQ;cqziKPg>aJO32~ z-D8qNiZGo1h10gSS}N?DDslX@%Q~G3PlWo;U334uiB82T4j1ol*PeF6g>?`Py>%_( zpBWe0@(bPeGV=Q0)&iGr(~m-+yHi#u5aS$yR{l1?S=uc7_R?Iu4|&UY_-_DBPIOLz z^oJWSvM~@5H8ZpC+tmL{5Q*L#M2JNC+m=z-M4=->=`IyPlIjqNX6+qyb#*U*bv^?_ z7h*33T^^t#4%J3tHNHIV$3vwH-j=gVu27H94%9Fykqp84rnT1tR}amuEZfC`Ss*m^ zj`fX!1)}PY2{rFMe#D$tPh(=}akDme4h?V_(QwXrh*_;HkJ_&WkB)(pa9xa|8C*?O zxsZ=>Zsy*gf8pL7`A(36O?Aod%6e;ORj9n;dgcB$zjg!L)o|4C3fSFJ%ngGevSf@> zADqI-)z|6o6H~09cEr1!>1q#A2Kk#10D2G6G za6lf+LOEhGMza=Y2!<7)xxCk@#wZyan5qbO2pHs!thgcuq(2UYC>un%w}+npf=mZK zbFU*f--jDue7Zhc)n;7K(%#x2O0paxPp*0l5c`260P!`!6!10c8Lqy;hWK`KR&b3H zZ8>wdJPw+lt=VB9mpu`O?rUKBh5q<2y@g*f!*ESN-5ARCF{^q_wv#C#t4q32HZ-?O zmP1GT$ja@^9&hCX@+?Y8Cu3|nUog$Q&SZ6&{x2BN@05B8TWE8|?J57|VcP z)LoxJY3#qW-t{nV{_QLt`De6a@kX*D{AqN&;$r%T2D@GOxgHM-pUj(iWN^{`0@%gj z1;ud)Fbg%n@D zdxVRY$%GtGu9#spMQy>PZ2Og7DPf)3c=ZbmVKeG|{HhOjG)>g;h8a;!VMCUMeOQpw zsg+lx4-is#Kk^Eo!)3oZs{?-7_;|^3IGy^n5mK70z%ZbJ2m^w|uyA$`4*OS^fS1@A zU!q$M?dE$(?`G}kK_>8%qYW~F9q+5xp8iTC6NQuCPo|IQ5h0d1|JDgYHkhOxh0iwK zFiXcpi25K-RU2tG2VjL@B^u3T&@vYh%wOqN@UA#}6pT8PsO#n9?M#*;5vIQZ!Vwzh zH*U%}zvOOO*%&ZmAsQZpx#D{xX{jKf(!sr#6NjKZ5se6zNZVsPntd>^0Xm!CKDQ}a zv^B=J=R-8|1A5Et$nU3Y@1d`#LjGaoivOhF0QwdbyzvKLDoFR=`~#tX?T!!F$QY0~ zA#yU#UlqUx*b@A9(n&xeH~9KSZE+?x)L+T9SEVzRkT?P(TO?G>-soXobb&_1Ve5O# z@{y9$th>lg6T$+mM-F$~IBPwcpJyD!f3saGz%i~P*PgsBP^2(6g+!n)&#X* zq7JDaY;g}@>@;Mr=C1=?ROcgR#~3WG4e^>^WK&be4UKdlZP>HO1cs}QYIWGY`MM~Y zrH&|`jt=n)>SnFx*)htq&$$ehvX)BdObPb+CGxrL`&)4#0jZ|2V46LFX`VocX@J6M zuH;9jK~f4W^V+HOg^^?pr!T>4-&0vI%E1)NpjUIzSxF|dbG{0JXZ$!W$H4_(=N z*i@(5%spf__izyJ9x9CN(g{tSsj+{6r1q<$=6ypORCl72D(emLG2>fxh*qr~R#ZBe zw)uT&u@^JVR2`~q?-0mz%mAHxnS2;FEKJ(WPk{j9R6+^6IA6KS z;a?2xW+49&$g#P(umsQEy-0~!G^q>haziZuikOk6(bT7Y=6P^Q&>esThnr}qg005i z7pl#dlELDV#p8SS9r!TyD-73-EVl|!1Au>RSRW(h+l@$H?tKL?PQq8Y)VutHc*s~w z(qeATE+%S9+f0MT7%*(&w+@Eu5_O=K2GdB-6jZw~j}q87!38j8H3#_?#^LmyzU6b; z{a*04^r2o4t5#D$&3+2cxdAPpUy;$DH{UCx^|bF>J5X;_tp*&bCZLA;&wcGjetY%$`J9hN8TT#$yJCXJFN5aUy?k<%F#xW4A_b%i3sjYi6o-+Q z$)^GexFp4!2g@fZv*!jN>>}c&Ig$B=fLYU!$XE9PJs9_k0ZJ|a$DwiE-+@J1ir#Di zPQnau+xqf@kzkatRA24a4%7~*mQ;_8>_e39&nbd*9ih_!JItF1hU2LF{j#uRoy~m@ z=5V-YJ#o*=LCrVE+X+P9pj39f*yWBF?c~)y1xAgjsqjK2`79f@Q3lf7Qh{|}oe$BK zv>Oa=`b66Nk;57`W6O(ByGGDZ0or}Qp@rA(nu#pXDxr7wTo1Fz>GzHVlx&@>yKuWb z6_e)Ns&cmx!&FmA6bDNo8Z>ZNpudFm2-D#>EXqef|FvIEfMdFC8Kj2=sG%5FhzU*g zhNB=ZpwG_k`!F~4*hMbZUznkeenJs@x{X+HR}_AJ`d`%_KicqD*`yP*Y9ps?x5*x! zzZJ_q*Q%+rG*oS)ta4ah3f)c=XMT(_r(;G6YrPnR%FizS1Q7YvXDWwdN9%?jLu)Ck zWl9cStf|fZL3kg)?n}7c6YT(9oi2o4S1f6Fuonxw6Id#F-(0YTFrV+?H?B(7KhhEjhcLJOF5z8I&&%$o#kV z+CNjP)b9VvW7>Dpqa2_Cp>~9@1(a)5Gx3lIW^vFYqKoq< zbE&K^LjlsVru7S@ATNSoNk^MC;lpGqx#%HgcffT5Qkn^g+W#c;yQW_4zly9^ih1** zW@U#-X`3}$V7#=%-G&&&umn>$I+`u_Cpk53A5bADh+CR9b7>CVSZ`TS;Ogwv2X*w0 zwR@;fTce(LjCPuycO2lLV5r~bR!%A7a9w*5r!;8@F)F4??-a4bBA~!#$csZ$i)@$ zcfL=VF7qN7AUI#kMqS_BZ(o)>IdOTzKrI%41Jn@-1AE&q4yKPaX}K1+#23Fa<<__q z5BE1?9c_WKm~OIO9p8aNT*@HMYY9*V)GxIe9tp@yOTcB+oT!S+xq|de)V%^KXRn^G z8*92idBZ7Q5xT!n;*p%rEhXhol56zx4_ZSc{`!*wH0jDe5ecUgi1zLm>Xcf>9Jz~e z3Tu19y?c+chd3-8hMx4qXRLlH<#F{O(SmC$t*eg~VdIXYts@KII%~}8QpX{ADsXjG zwNI@hZ9DP`K%$t1BRH6pkbGODk9cnMx?fC7Rq7PT1HZ!`zt;5css1PrynBe}Zh6JI zYMbskPuv66gC`>XTY&_z_|kz|g7dAL*wQaQDW+Tal!-)du8I4QX#H^Mr-IMp4S-Nt z{;D94K|FoHgas#t(1sHP_?olrSGP{n-})ipdJQb#HPzmjG5m~bd1O}2RT$M=mE>eW zKnyI6et5EVyR5?}D=t7O0XCJj2j}qaNUfCb5<}!u+!RG@fhDlH#{( zSip$&)kTc8s7!f9yyPDU8Q)o4k{jfomwvWwhB=!U%1$RH#yT2wbzE*lk4LLdOQxK< z=V7FU7!}Uf<^^B?24sHc+8TU7_J0?=&<{Nm2bf?o)?lOHD#d}e>jL`!Qe#y9p~6Bm ze8rEZv9R2EIJ`qoPHI5Vg#&{B@*TccDgRUf7XLLxHri-DP^|-|D^;e4jhieP{uS>7 zY87aEe^;Xd@FY?-C-R-77XJbH5dVcHL3EO=d!$kD&iC=s@Je6Vm!J)AeBWm`8T%XJ z)kj=auK|BB+ulADdFRMqMO)WZS48i<_fm09jkcremIo*7D87H0i0In?kF))6aJIDb zg5XD^ELSh?z$VnTknNDv=fPX@#*=QjzYJ{mQg5b)-r8IuZo*Sfvuq%X$UC6Eo|yQI z&^Gy2^I$b-q{coqkQCYfP~;L(EBtuLpC4TVQEu)2HVxna*bjf&3VNKrt_}U)rK$}) zYSamWKqDt^Y!rHC4Qkf!t$%Epo1jlz<1Bnz3`Of61O(AJb2h0aX#MWT)1jA@v+^R)n>xyW0U8Vps!iQQRxFYxMOIP?yZC zuwFM?^t&#o!&Oa-B}03Fh`-k{YobIf)DbB!_6t*|n>D;lio%n7G|Lz#!0s!>CzXQf z0(8({So`r=ns!P9J_mqx>LM>FsbWDUv**w2jsCvgzYC~+J``;OW;dp11d?)9jN&Y0 zIe8fQ&Yi5#{kum?)hD%WF&Ha)F)l0JVtK(ltOxQo$E%2U#1vS#vMxcDjlD_Jd(RbG zyyVZC*WeZ{k;3QhPbxq+2c)v@K50)sKSj91j*5Ty+v){uS zJcQb40U>9fgNb z=4glT$n$#piMxax;z}Oi25ADjZ5qot88*#<7P!AKz$6=W|Es%j{j$dV>G2@vLzadL zhxk&}0mKA#4?@%`Tpeo;jeMN%Mtim$vS}puOgDE!#8;*9OY{RVx86IsAsQpP!Fw)MJ~zAeBI`$waYX?jxlX0Wff&t5i0Qnii>) zf(=R_FIZX)G0Zx@arr!a{1dJsIi98u!mW4%NQnUk9q$x#%Y@K&?PQ_KoLm=g#>p; zYJy`z7HCdbvNQUSq!BPJF4(p0#dY$tB*gHs&0t7vh=rODWW9^fflZ6n00NmkXm8Fj zimxmSz;7=mr2%MGl?rSk8QFxns<0ktZX*btbO;Td8ZC*BwOnNNi4n6dAF;>Y)`f13 z89l=Z`&zG#z$&O`XbVA=zXC+ds*gFQo3J7D+;3RS+Y5CI@A^*G?K*oTH6U=$mt`nva*HKGvDC*WrcFdccjtc|pxb%}O(A96?Wp zLTpE})_6@%8-#{_U=xj!u>U1tZQz;3Wbc_KLGEeaxrSH zC<9T?ZvwMo{%Dy2Q$n)sq8wr|gIb<<2MA6ZpdR2H+Dx9!CRs#Y=G@0Cuc+e}3Q_Hu z;{|^KBIso7`EyU4HzL(2hZ>SLI!g;ISjNNGXqU+0_?f!csGBwrLapindoWE({HMO^ ze(g`{jvy7Q(o*4_WuP|Z=7xtHru6R17WgFS#Mq$;s1F3sj+J`C?k*>BvsyxDX*Nz@ z0a`G$0|yGBc68o?tpuu59gU z_ImKCcPbdE{h$T;w?Zq}rfs9U$)frUrCKsGA=$NJ*%nadR+IqEx* zjl@sQJJJgYDq<~TdA~Na!8O~s`wt?hu68kA*!FTngn!T%9gdd z_@`~j58jt#6^Hc<0XWmp$;()Ntzx|q$WEds>{E7azR2k(sXcH@|19+NbPU_wTa$-B zt{3AeM%Jsb?>P_-X~bwTl+yIL2MSZkVknjNOkT+^g z`DsM2K8E&2uRuNM_DCxw0t7Ti^d%kmdQuYQY|p2F z1~4}l8jpxHYM@f``GOjlenx=?Ds;KsEZqFr5}W~s@zWHAx#lg?l1xJxzVt9SnITXHqR754v*I$hm04(k}6pc z)PO<8IS}LVp_Ct(&8jAea7EwQ0v1qiS(mtGKf>uk5C$pI(R!%{hb~&P8)#Z9=~ziC z*IPkfkC{ZH`(BD}ayeNu&iZZ?a%w-{Oe0ue*6DwJ^99Ai;iI@U-N`p!*ua4 zdO$t3o3}X3_7f<3-&vn-bGMcgsj&?ipQj`awQe;8#PzxqbEc(!C0ytNZ}Yip2`X#& zzz_SNpFRJ9tF=i^M*0@j;I;%>jPYKK9_GYQ>wEML%9h_uzn)r>%m<4{<{1lclFVIy zpK||BBaConuCldJ>B*)vc(Yl9r zM4>kfk1yTZKiWuRJ5>ek=`7&j^i>4mzy#pdzSs@2JJcez1o*`3k8$a+E?9R~i4zVO ztIO-HyI_2t6)dl~`4gnjL01L`xw`|YF87w%VmkHa`Xb^-L%ZY*Sc=i0>_8@ObL%BX z6n@;{_R(Mae|KN<+03~pDuxkjsn{>C9;^-)8~Jv;@Q{E_D&6jXCbJtNrrll}{kDS~ zCx(p3-jB8&(&;v$(;54~sIw%%Vx%QqAp07B;h}y|(H@g6YtA%3c^jMU2mbySLZ-Gm zBBNUK@%dp5_lsiqPqqbATLZ_g9)!An9VdIh@My;-gA4yRf6}iZyplET)OWR3r_0~J zz>)ydTwM6QZ<+{Cwf3iOZ23+MJo77{A$7Zc&mheDA z5yPLjS}yUs)6t(Q$A=+_29o7**KH&5Uf{_$XEBsaYBz&*nz59GL%qpv<-5>s%Q}Pb zcP0@Cm0s5R_^U?7Lsz*nz8z7hMBzn#xJzwVJ|TSTHKV9sy_Vj+LCe3(0?!;kSDoXt z=aH%MFl5(fFle7s{>*G9TpAT$p6tkmF}zi|36qzfY%dQ%p{yVgDHt0oWzD9Bnf7n~ z24)DScG0WL#gLL1Ha;kMeQNwF7=53OspL=DQpQz&%JxNxX&E~$ILKuDr80C4Y@ELD z;6K`w9D8#Iib$|9t2o)>-wKLS<@V9mMGrtes6SsA`B+G6U3|jlS}DT+dw^B7?D49~ zMQ+FE46cpfyZJvm`z*pBCbPyqgbP%&kxZ?+Wlj>gg{rJ3)3Z4oNY8uqb<1B@_Fmt= zm0Ir=`p)jRyI(#&$aCO*5uJO~<;#~|g-#vYvg`4|j-!SHPZ_sI9ytE=(yL?Q2PXKL zM)Pf~F&6^%8hD(YwH?l%t{}XgP3tQ!V_ei)M^nxx!jx%!Zq+gto}Mz+W}o4v%!#(; z_Fx@ekqfsameNlREm$s;C6|s{)4&wXcIh1ggmkCGNhhUQd_p>;$s1@@;Hh zj=;}WB3eAFXcav=*QO&>-B&W&-N)3U*Dh%TE3;$r5Y`cd=Ludtpexz z9ZVOWhEY2(JE;xWRpVWSfLDV2T#9*PHq53|t$($QMcLNx#_i$eY#}v8%GCvbcM%LBY=>ev<{@#JW_G(MHdqzD=#oiqJpMelAX`2Jor58Ugi60;6(53Z{ zleuJSQW-pqWm&1qwofVX+PW7V714stBe2^jCi-3;_Iruf`IJ)j68sNdQLB5#f7D_C zM(j#|6@%gN{`=|SRF62pG_dg_*ho=<`}-1%C4zy-Fg5gs?>Tz#5I?(b-@b1{L(Rur zz#U;QUY{L=($`+hNZx5p|5WVTDm`0|zL)VbFzp5tD-2%vLi9~VxcJcLUEilZaE)zk z6xx3U85BiC!t--#1J^5lHeTgPt*dOf=g(94`C2A>O34l>SXFhhYD)xgi3_>f#EbcG zfp5Nmh23Jf)~af_gt_7ey}I2fW5sv%9y&ty>~l{@+o1P&{gWPfih*iOZ@e-p-fmfG zWTX;iCK75#m31mo$LYE&LnM2PW>9X_jAkrLAF-B`3&Fv(@4=S%#ez`tn-z&^>$$>w zRq=qV&Ym8{kGJuzH0pJ?F^Mmy%DV>{E$$6e^2cYlMct{oa?9y{@5&Q}t|oBfj#(MO zbtus-Oj+8FeN*er%vY@j?hBaZFHH=7eVZTRGkb`sslNk{u65DPOF0azOq#vuQ7T zP=2vV`!aBYAsjb7!j^J8!E7=~FsQ8pFxVkhZ4V>OV z8cV~S;OHhPW%y))w=Ua9*~H{k25!F3L3tJX4qhO5Rj*coz3J_#5MIYX|-8c*sthyUiO+aGdEwp*Q&zNrmbIH`I5X;NU&0k zY}(~KR3`>Yfh}NS0u;(PIe~QE$9AleYEq%=XjlHRx#Qm%4wz= zP856hc&AOyzUatZggQW2`2%b}($#s@rY@#E(-RXi?%e9_w}E`$W`9)F9$d5b#w&e# ztT&3siCS@M-p(^>C2fxnWEo}R2mmCXCFrE=;N1%#wI|BS5Q`N-^5CkUCRqzlwh=&?qf<&TiZR-zyAP|Jb=yDVbU>6$WT4e@!k~UvkRGeoIbLckORjHFJy#kr zr&;TQrFR3%37Lp}Caaghuiv4-buq=#SZ~phWHo}3l-k+5*b7yba2%~$t&A2_zM*fmXvD7$jSm6z+v(DGF`P83|U`k4|osm=hEU5A>$&? z*mym0Ux(*M%iI~-u^BU;P!;a7ZI?8O_5I^hLu zxcv+Z(U^v~_`7VpTE>3lUU=W2K+bBa0R zr^Mo{N4o>l$XE)7B{DD(55{kgW>FbYV;B3X1_tY%z)k?F;kT71jj+pC@7?p6pHg^n zAS-dGHJz@P^?8{mlf~M?yz;BwK^GDVF6>zz3HHNoW-D2X(eq7oCqlfLwJm}!emak5 zTQ=7b)+w12L)r7EDb6UQ7@6P`Pw0I3!o2rLZJd1kvom9(_OtG1qkV%!j3w!rrD4fD zJUqb5y9S!V=2!es_5w_bKQ7SqUnJoT7L^$Tv^EW@KPf~BJaOzoaycBF#8lU%f%RCDV*G4Bzs7>4H8Cx|J^=rS?MU$*a6 z6Y~*=kny@_>lV>#*D_-B2~+ZH3a#BN5+Qi_Q?k>?r6HEcAD9V!#&+>kt8XE~tF}Y+!(A{9?4St-5%0f7FUESOyVd6AR-4!G&dQXY%(peJCz!a61PL`gc z;}zoB&W5;lMmpwh-@bj}$G6$|1@}p+3r6RQZbo)HON29^h09!hTd`R%-*5m%dT3O; z9CCzlLwApzIyDgHCcvzmOn_OO5f!Ik9O|x}JLiDmWH`K|AWK58LeZVWXQ2Cpv;gxV zqQIe(hqrS7wRCj1;4d>&KGW~mwmzba%W1ro@S1-Ft;-tb2Tz|H^AQ?ECUId%xE_1*hj9J*`z+{2c6j2wJ9l!! zbTc$7jDR_L^5psRwOPB1gMEWyU07~oG7L__2s9(3@DYO)aGzr#mAU5k8ovD-z1`v3 z6~>Uo*?pg$wLY8v!B)O+ubymC5Znoql<07bTwGj7UEmcgElpN}|LLyXyC)_mdGGhX zvL#=85BsqUXrB(ZJa7;NqSI(s7x3G-{^y^PyY+xc(Z)T* zTxsL`1K3iudL97=?aVQ_zkWS6oYG!USZHSX=2*!)Bw3P`=00Jj)Yaljw!Zw|b~K;7 zvJ;u3wrTliBwz%OL^u_v-s_;55TvevB>9eZ_aQZjId*R0BE?)+39^|w<-V9AztZ~? z$mOwzsKWfU^Iw5P>nnqLXn2tRZ)BkKrj;S+Y(;`7C#n*k`hDuh#ztHFcf$U_pQE~d z`N|o{Lw@rjM!tSj6&|!*UO}Pp$Kd*(f6QcOPEHPdo#zLL_48{)Btmk9g!>nRr1J<6 zin6vOJOpRkDrM%-8=@aR7SkZ?k4ZrF6#cjZAT5(LVC21tk6U0?Y|5OMAEK5&3OB9O+De?@z7UQ?(km{ zho`(>p7i|n4o5cVZv)ddwhrkGHPLO1qR!ue)cXQM2*>x+(tp ztpTPE-M^GRUbI{KIIiQ~tgwxPF@G2ZaK{W2jT;grNf z&)5HBG7HHu&0iWrKDXjs3MC!{}uh!EYmH4@BZhqbb1#tG1kd92#NfU zWS_20Sfgd*ZJza%Wy67Mtz;XR-{$NkDw48;_UF9jQjd>%s=x-|f_yk`()xvGRPc+3 zr1X)1S**{D`u@3z9(G+`8_PGh@3x@93CLW9o_WI5+h70!plWbQ*+)ye0!Gp+FvX_V z;&^oFZ4ic6RBK4zzTF9V>k%%4L)6rKrrkwnTIH+B*aPRC74C3j3ol0FfejGMZw-0s z3;aFW4Fntcp(eE7KLOp9nCG!DJq9L%m4d;Ks`$dfLPF>t{f9yUHu}L>!EIGYNv}wSbj?Zk{sRmwlsMQ&M1ja?+XwM*8?T5K|t&VqZN!52n*PtW1gEO)26C zX$YEE6}*D0ddmYO1G(L$KN&YBT&5`mnX&1vO^;%7<(DT}m>OUxbvw)<)C7XCTU8O@ zxLw)}Md&+z`xTqJ$lMZ`zcE;$eO4){2xJJr{V_a;ZU8V1UkW9n`(Aox+0=^^3-l-| zXFQ1TV;_unMj40LE!_3i1FAx%=*1FWMQBC>q9*&iMx#-oLOT9V7aMPogzmXMK!*}- z03;Dq{ZO$hu@jU{rrp;Vbwop;sH{=`+}@sj!;d|RhJpf$Y*Uz>cej)$9Lxpv%xyuo z+CMzJ9Jrs(cFJ8T6&w}y^eI_XUKN9nqIR;Fq6`jmFbkYIVTFp7U%YrB@t~ZGwo$^# zEXt(muWwHwMt4zf%%l7{5s--c{F6+Z-15%_->-WOH&S{`MYCVt2dOvgrmBSF;^O)$Lwsfc?oF-jCy7QC;E=7Zq!91db|AaK;W;Uo7}_;Cog>D7F2DH~|TS(uoZfSol+kQcx^ z@;D=7$&FLjC<1sb;*zv(-+p(tSxUJd+^(sNGv2C;0U;zKBSV{2KtLd|JI$=mc@}oI zJE*8dLozcnVNYd3RkyryMmhP$!p#JYFMv5A2Lnv8Jur9f^uq()_|UGRqM~h)80XKR z%mrg=+k@;1YXc!;64?PsWkb^48n8W1#wdq63_hl5Ch8TyK9rMr0U1 zvromH@h{NXiOdpN1P~H%U$V1_(uxgpehKZivq3NMG<*+k2HfQ{I73ZTaQZ{TBjB{$ zc@irbB9J%^JE3$*BIu%s@(E!FSdyY{__=0$$o+WtoNzuNYp&C&ESQXsj}MWaGcYCY z;V?A4sr?AXL`BA3cRyC$mUP#%EM7f(1%@Nm4YJ?27tw;zOo@%~u;viWjHPR2n7YBXY~mPDX`>smWu-}7*F<=zo)oM z2_`bYSA`u_?H%jqjIV>59gbq6JA<$*$WbNIk1N;1{KOH7Y#UA{u-&?402a;fmMeHi z5Ag-ne@^flruv$CPmAXRoB>%N`bl>A)e7j>pSkOFmqx;EE1FlC2hS?W?DayN_9cV)nlwB^Z0^cO z-V!vIBq;~4kE3DyRJSqA4XGBRYQ&Nv3v4)e5O0VC5TK1S#-F96q$~w^cpRJbIiq;% z?Uijj)KIJ;Cz=P0d~YR}dY#ry_yU`~SV&u=C_>`;^#q#$_9X4%)y3>p&lzxye;1qc zxcUN*i5Igh4C;JX=KS*IEh&z}kG410?j$Ak*{03#@#DwAK6x%{Xm0j}*xP{u83En3 zj}|M(XU_O@73TN`F-t#tblBwxP_>A6?tEn{vIq@T_L-T{_V|&vCmF=;`XMG9r(!#G z4PYPpgU|8fkIMXH_hG}dMGJ@|h}P1M%@bHnd_~J#-;%6f+`Oy%pgd50{N#y_7wiT) zx)89{ISMl?87+pJKq|^I{YL0XpSK(=S`#QLtL%p$V!g(|FoXB8Mz`LNc>191S72y& zbcFZ4G9#FLwLORjt{-@uo>-6wmv+NGgRK$3BpLkl=~I|Hke;3%Wm_J^E5FTmkDPH^ zMp~JVYCwyVs9W(3PJEa!sn@=0Z<+B=P+Oes;kws(?QS*IYrKG_8wI&83=bM*LOg6=o0Wk}dkf=O=4HUY41(p5tEim8E` z_nCIfR`Z8nn?2sy4l!!sGHiDDV#7g;tCsz(xLL5k@BT~<+nd7kUeCyg-Ry|!rv)g5 z4+R&%a(^PPal(_csH9pRp{J*3)WR$br0l_6fScKm2js4`NsgH%q^hE#B_QVP>Cel{ zyWxLcq)jzJ$=E$&X#fS)c7Nwq_>u*u6w&e`H#L4m;q9%Iq*p zwFxGxH#Bwu!<#Hs{H`2fNM;SpGhX4z}^y6&-R1|fM#j@8|Xaxu^FHj7b57T zVD2b1b)s?0Y3b>-D7%&nj91@Ky*Q<{k0+U3y1g z$!(!)*RCt`6}{qU^talcw3M*t$oZn08Z0n&y^U+Mqi)!3f6oSZS8Wp2H`qdZlJDL` zYiPV#dRR2>wYNkvj`}g+MHdVjZ=U8jdQ?N^$b!h1DHyW(3?+7T?{=}<7<9S?y#E0= z(FWNV1*z>G{`TEP`*{kZ0;DAZx!C~OU6DG9F5JPcD|Z>eUH=S)XhNs$*~O!O!%$<= z8N$+40GaN;fPhtX;=+X#F&~z4NHoMLPTu?ms|E)WE+Sn4^eiywuHztg(_@<^6v2lI zv7Pa=%7C$Ky0Rm}Vu~W~*%jYi-wy~SEIoulW{V@Y?xM9Y%yiO;+9I6zcy*N5RV#1b zp!418AUB-ofgrrc!bh#l2vXtdnTZK@ki=isroU(L(ACicubec+8j-ckZvJJ~XM&Cq9n5_MJ}+M57*&@vjD%nMJ% z`K=TRoN+i@dZaQ}OQFPq@yZUxJyd0EuK38EJ|#)T+01C>+^gs)x@P*T&)$95mZ9BE zWncD_m(}KgxR&TsiCR@@ zg07j=qvV(ecVh09Ros~Ud;aaKdG^8XJ(Cda^=Of!@+>q^LVP#!lf#al;593&c%Z?1 zwjwg;?v96K6cWYGWEJIX&smk^Aa5Cl5mdrtIlwZ7gJZa(>vE;pS*Ve>XhDXUQY5Q(t2sO2O54+&GBO z@>VR>fdj`p2hrApmLL3F@IeB$>0kxOuKV@PWtdQH-{C+hL+CvW$NEbmkb1;#+<;V6 zCzZF$R~2qX7;mW*MO(vY zp%OxpgqBo_BH3iUWy{`L(xf7L6xk~ydsGNn*?Wa#%iey^7j-_T&N-d)`FtP0{^>LF z_I};3`@Zh$dXDP~+1zs+Nu*OJilz{5BIH@9mxq)iqM^rx7PayE@e+d$FiT8j%DiYw zsBB&3N=G(9B!0MPkgQ97CZJO&X*-+WeR%rV$?0X>o|Y*@Z|=!3Ne-1wF|{dXFGT<2EYup6?jM# zOaa9zD`$&y%jVulsu5*^+CT)RZzFIB*HM_$w+!%-Mj%?ozNj z3Qw!?HkS#Z5LpSl34dmurz0pYcM^khw)P2KzW6qCu)W9z(~kDO$2gS3J#4|7dkYVd zsMf9p5Vd0!_YMqA<&>{_gZ#ddnE31o)I+qNJ)DnsI&uA3OlD( z{!r!>fffo(iWE3AHe9J7en&(|CZv}7^M_}c0CeJ@N0gA&+8E91=r)AFf_=`Op8NKS zii!@Y%}kFr!hOY+cwTA@6WKqTXzP23I?eQa6)o)*GMN}s|0;`I1v7xTp5S#4h?nbCTJqzV>e`~h(jCZF5lO(*Vdh?;bzk)&$L&N&{ijDq6wXptC~K&V{u z$Z%I>xeQUxC9z6Z^jLvtFLI3%8xqQBrK!~S%yyvDG@qWHW<2knIh?zzxVX6Ukj63I zZ>Y^2j)Gi-z0un{5kUW=7;}%Z5FsiZVP?iaE30Q_ zdNO8+&lq%CVHst#a9~U}MFzbYTOu;f25be+nqjd~ofqVCVL&MhbI%8ljL zxXPKDjyaG$9v=Rf@ZCf@k*nkb2LPE^|0M)?2Or4!hwF@2MfbpXgFzZLDJdae24@gq}BD?SI6KSC5c+|7QqT@4(o5!ks}JvLB$ns&$C(6suMN zU>LO+$wgPA0APZ{cON|9FiUOPDubWNSpx+@;WD}!{O9j~qHltGZO4D}e!~@qzpjXZ zX7^mf7kk6@i{as4qq@$e_?3|0N1SnFSl9iizhAFooB%-el`yn!U;}~p#;%3DgaVI4 z$Ni0VsxsIgHoQHP0Jm>ZGqAHiZ4h0fD*EFdAZX)VR~GVDoqE!i0u;1}ceD-E9IwwO%{$8n>o2FVG9xMq2uf zR_d;<7hFF%j5u~k_0aHgdqSDPw>QZB-5xiB(4HduPH1bJ+z;CnLrzI)Gh8l#iDD)m zkE#V;Mge=+_tXq(vg#S26VZy{-E;?wNTIp~4CyFCSKYBN*5&!{` z7;W?d115seKLVYOj~!QoW^JH>h}hjxz9x5VG(XA3E8{&fW?EWW6l+D7D49o{1u&w! zwH4#~ym&1to-cCTC;4jI10`cmw`*6gD_bh({T^P5-oC1^TRlfheBa?@WN*Ap@4Lz& zKHR!>3t72b?A2nT=x1Xq-bNb5tfIu^WTD!598zjMF|Wn0TM7Sq<7Ex%m_h97Yu6GD zJD#S9BZ24Q;$kMnV=@mcR;M?7M@P7H8}{MO^5L_>gzSrG<*SXi?+lRYOJjQaz&4p> zHWQGXec)%ROrN{&H6qR z&^^PpZAYD*l(*;IzH{dTlnx?i{m+~^Lt5eT)L+8e+ZztEn2#?zMSyFpqHyFxkGUsb zQG~Wp&>X(X# z?r?NrK>>GQ@IrKSFX|VliO_`10tOrZ`gEIF;A?6E?{$E?Mo+^8Q8jS(k+Lzb#fXy) z5R(+mN|tADMcI<^KO`h1Aj2gZn8BUk=m!7jN1f|{(<`|RK3{e8-LY@qxh;+i=SxV) zn&JTfY6xIi`&@HhV~_wEM{ZuXZl}jHZt{)$2nzau3OQ1ZPgA)38MxN2S%ZXWmAca& zF%mjq;i*OA&&0e8f+Qg+G0~{E&J1HdqWhcP-a6lVJiYZ?qNpQ-#65d^=l38p0D>~E zlG?U?yW-T?SIlHOppal54_-6c*OuWtOF()7VB~v%7(;ST>y*5_cfWdbUX<+JYs)9N z8cJE;szhaWZ>yb;#;=kcc8|>G5#P6}#iwApEf!cCH0{bu!WDkd`l=R+$d{?uPGLD! z08aMBASZ;t6V%4U*jNf|0$@{!><4dBJYNT$D&tv=yE|YRzu0wa z*S@TOerzGp)pP-kX0X?|}+Q`?li`h4!1K zgATtOO8vte$*z( zl9{lm1<2=LZjcJ|z3ePzMh^r>B2%X$>`Gh~3dnQbB z7392_xq8}9ule2V)S$!0xq|TkXwD)}?oz<{>fi$!R1ArpQTk1nqR(0!4moC>*IF^e zL(&fiAaHu;;lt)=D%Uw4_x0;ntRvQ6EM8pfEsu5;%1@jftWvHDYFsF(tv+SmqeBDx z1fM1JGQDR#&WW5>QF&>;MDzIZ* z#dk(yBvb&gzaO0?!m(@7_ghO=t0JrW5J$^Lvh1<<&cD+M-nSIPDYws2$*ubbgbw|h z;LkHlawU}4FE1jRt5*h#wWEhapO#yI+MkE4V*H^j&!83xCu1AD_MKi%SG z((uGBUboSC1d`~~l$5eZz3=U5JT#m(h&dvrMP3SidH@fI>Mn9YORrRO8cZesngNbD~Zx`BNlSEBDQ5iLj!y1d|CH? zTC3{S3+r6xt6O#7dYyLzpB z2Ax$Kf(WFEyyim}L|$<^E9=(LQkL7nmoZ4 z45)*@rQ+NU^2S61!Pl?vii?VtAS?1VuaYcTwT3`UnR1&rL}vYzWL1U0A2 zA^5iHC4GZVV;Zy9ft}g;oAyh2wb6fJO+=~yl59;(OPLohQfP=s=TW}io%g3Fki&Sg zdrmBZ)apk)$M2fVI359@Kzr~J&s<%1Kf;cj9jVprU?vdmv9U3=A|e!bZ{{$*Z>_$m zE~&d?f7*$y{8EJ@EzZ2k+YTR=ek8-ZCugj=%**J1`|ToBF?qseR^7m3w8gT!!1~!t zeYK+>jcQ@cyJ%CVrLuCrwcb^t0=T^9CLN)PFdki#Wj#$K)u#eWf332KrrtoLuCv7q z9msXWdzG_aEkGh{xB1iGCDY$8C^E8FjF<8YowqA5C40;}U!_zLDYNYlKmacrCbyt4 z&_QeI^r~H;aoaX6AXA~VR3;REbKmrbn&*m0Kb0vyyY>E?VPdTFn1A_?h0iO-G4dm1 zWRm&aSK9G~dBa79AG36#ggo`zK|(ktWnVC}*qiMZJ@I@8jRan~ z=xS}Q`kujZZ>pGBt)yv9eAK$lo6qP5-(}zPWBEs@bl1MRL8s-Hqpvl>+F!A@B+aTe zCnw5&0#jKc7fQGUSEkRDH{m>cK0$EW-xaZJWZ)6=!mZz>B15gj^P_pqfIW?Ct z9#S&?UFJ4dBrYU$G6Z22SHDMp%vDaM^=@`>yD9gSX5H9b>*x4bi4pMd=o4o$>zIunA%Dx^T#)YSmH@j|- zSoA|3%L+o4tb5D}fcc--;J01MsK)M4OPtKNcge`?Zf&%i^^9xvHuikde?22GVaMti z<)DT08k(XA8+Cfp(tiGbt{;_SY;MFmqkt9$%Uqc{nXc*@8#B#Of>F;GR@!j*wd4G&6*e5 zd)e47#-)R-;&gLz+U1B#`=fFA7(laA4>z%ut;a1F-47NuvgZ@9GIk#%hC2=wecPLy zJU?yT)iEt?rfkWvFXh5|cJ)C0efHVjVO#`&oEo#U1+70dSWosWrKEM0qEB_LpE+=e zXZP+P#NZHgFg{yN4C*Xz#Vv%Z0XUbhaedoz1RNrL(#V@a&t(l=xfIij8?6TmxL#Y; zr|!=G7B!;+xjAa=L_nP(%;dkDr96P0OE^NnKuJl-RrPv7v=@j& z|H`6E@H4FO?EA%c!8oC&>kD|bwo{Mn9ydIhS<7P_alsMtTf$@SwTA{2#x9gVX=8Gt40jLKN6MzWqkQ89} zBT%Ps-Hr5r`SMb*Xcpeu`57n!P+g4<4eb*Txpe80lRG^6Z782VNTagr9~}h%otFRb z?%l^UNB~&(@7Kev49NcpT>~)MTp27DD-^UK?opu7fu2B%IB*A$k1heV$j;SAV zgZdknemgPI=%B zUY~#!EDwJM-zx}uoAc~(C<++G0GeB^k{*_iXtoyPTm!4&&HIw1*L?HAg9m3r&;vde z6UHYn@N2X&!;Z4Zh1JJB3`IG_O|d2@ZBXq#y+xFESm2PQIh}?{AoR~p0s__`$Dx!U zpGC}Jw?Xz5JUjVO@&$N$2!~MNDmTBgr8{EU)X~9B%6DD9j$zT#rJ6vfhqa%aLMA^v zxvh4O=*zn^)KUp2@2&0e`Iuy+sbpMeY-I3IS8F`yyDsq$iS|EeHfwv=b8F{E=r$JW zrd3BBU7%|-OGRuncRG_Z_=STv7Z2uz!hmKY-{AKd1G`mPb4HU4)qzs<8nnl6J?AbP z3j3FI^m%7wzxEn}0!0+d&CaBAgjVK1J+azC<3Vhw1m)g~?<&j7hoSz*;%;QRtkUe8 z3;1R$*UT;Kq{L)?x=oT3gE@-tRo$c5%!i(jHgw4+=-qh!JbEd`DUs>U*^|m0B{M?K z!faNdiMbi@0cH)_D9dp06@RulJkkiN(NxGD-<@{bGmeRh#x7 zl_@?%8bvnQ4%%%C=Deu76h&g(X`BF2sSTN!EQmx5x!P z+?rwMXb)`)ch)WTy)n~SqhhYfEO)RRhs3<3d7ONQ>NxBIa-n50y~zUJFJI5W2V1mM!xR?kRXw(8)NBx5V)3|BeWr(nGdk?5*; zRBCaxJGt+UM7Z>JF{9ut6_3vGaI1-w-u8Bbu90i%MUx}xl*dyo`d+@3kL#0U8EjK{ z=Ic1}_Jrmz)oSJpyHVVk4zWcFRn4D1`TE{IVV5QsEXu9k4TE9@wt`Z8uO03;ml1f3 zV)#iWNRobAydtLowM6*mlL7*{Du#wbxQtF5Ki+y5*cVUvrThpS7+mB0(Dnj<#X*t) z(#to&}jfMDqi9R(eq=fp0fb}-|-+a+pWe*yp`9eKCptLwDdj)zZ89Zp-Z(#RBx=`T2Zlp2p2W#A~Rvk z2Iu&eR_vvG#JM>p?-k3fEZF`Y7@H(5CTH|`SZ&m`kzp{|P<Z|S zGn}rC0F!3lucD;B;D~Uh0TA?T+#@=EKA?gd_Fj5CjyoQJ$n&_%M~_}l@_Uh-Y~g?Q zS%cMRJrDrRK7{BO7=$qp@!)~b+nbAVTX?u{j3Fi(fRj)q0W89`AHJ~xdVt)ggovSx zc?c}7E+hF%{0UgxqOw19Y0j2z={3~UVX5W#XEruA)1BwucjM}NJ6^pDsXhB+UteG9 z;N1j_Aszh+BYX;$o z3-!0o*F^gvwaIO*nBB+LThznDSXU?eIypPI%q!lc!G_kW;;8}hp+hFt$>xNI4^E=F zWzy-Cm}N9~)XBVRP!aCK_@F>xbs|IOR`rttMGbf{-8tpu;=Gn4Xa#{3UD)EFCS#BN zt!S4wZ%RB4vOeZJZ8MXQke9@kjJ*OLA!XnL)80d`VLub5xbn2Bs_OcI*49KQrci(` zS-g0Be4OU6VNP@8FP8v&QwL`d*QuLsd8eDk%r{pgZKPDVbe3PXwdi2zr9J$5O|uTw zo6iNrSA1Q!Rkd&_U5Y=0W_ifOJ967cKAS@2(FSB6?-^lkznj<89cHuwd^{%`1#On7 z9wc#Dy=Q#S(*w<^;h`9#4%U%E9=X^;*N4^O;nFW8A}J;eUY^2v-Fh%=u*k3UynC70 zjd#~t_;b8!Lyy~%g)6h$%--0o9S#S5&R!AkFn50Q9xctRZU}1erQV?Mlt90#%1VOO zB7&vblG6^@JxdlXfu60Xu?pldWI>q>uiGg(fZiFZ+^}6SNrtf(-f!O5?Y@Y0qHlY zC<(48Ch?H_Sdd*bHbfsB-g%Es(wP{~8&IXOA0Ssl#PV7hbv{*S@Eq-;0tm`#lZ!rZMo#w)di zsg@C5CjP3JX$5KRe+Lf{SPr+cv9txom7s)&+u-t|@|qZIfvyRVDg5%Xyxq^^Ihyf6;D>q^7Q=uo|9rH&3^&J^bP z{d9~&k!8|RLce==PEk=GcqfVrH2)K24J3(*jmHW?fAJ_K0qC$nAzZ6j;7HiQwQDPi zibQPLPhi*WRCYO=Pw`zm5R(DYtP8HO*8PXQ?0e;`Yus?*^P7y`J3_mD9ru=*+hT!c>%{&EYhEn zFftxK9C*J!drirR{v~nSvp2X+kz1bJf<}fPe7zcyO+@0-!C9YM9;L!8vy*}0)C7o7 z#V(x@sQPhXLOGc!M!8ipH`eP`G;(`R9Vi6yHs9mmpa?e=c-1dQvEl^H_Um&{JomtV z0mZkZzd_qI$P%6(1Btv)wAvGK%6t@noJJwQBOmiXjhN=bn>j`vBQM z=c!SWk>LmVigQ>HbB8G#k0SCkwB;as^N#6eTOWbnx90qr5>PyoUkJBaR#qEsoPo>p z$y=;zJ)Q<0nx@`f+D)4hKqk2vK-z$Rf>y?;x;KJ+D`S8WL+bg_8%S;#85p2lv9(2~ z(yge%26WG!y`LN2p{&pBwufin>(?j3#+_wnj2VT5y^kbvMMmatRApE;TD_Bw^jywQG|MGbRE-BmqPD^Q`Wbm)X=A zc$Y8P5Ny+TBw`A)kchMGc zjPqN!di6G;4{sb*afPaW#&A9VSkRp4K-_w=0w^6}-gt)+s-iIqVhk0eFyiiUHDMjham=;3`os41lOU|WVNtl4Kn zgw1V&P(ZQ%(1@#hxzL=+aOmq-vkre36yue^6@kizxYplYv$HHYnlQwP8=ns^2@z*{ z&B+O;s-QYv>FH$b0FBR>gtwPN)kvLHDmoJccd~{)vpOBO{>h0*cKQE^A41LtmToQ! zJy;Sh!=*0by8l>BZM?3F@zJA4_4HmH*tbUm#vk@-xO?!KX6EMDPZBm%A-XZ7g0tlo zSHr&UWhij1OTH$s#6iR8+O>-&<{S#iGfy{uIH$|D(8u|bqW+bu(3D^`?NR;!#%z`2 zKFV$Y{1~_T77o(G+`rx)+z)fpw|x8?2mLBSX6Qug3;<)F6uW8v6?IcHGXX(CO}1p{ zMlTRh(_?x+U*DI!DmklfEpnZCd0!D;x>Gg*D|~a)8R7#P#T_++=~X@U268ICTVyth z0vg&9$A+YY1oWXRFx@#lIqEV39Y0HttLr9pwDFP8>c(2YCBR;dXHf?pS_D!&ly~># z8FB3v@pJBHL~b4vs7cbO$~kAm^q-C3Z*n1DLXmXkWuROQvM?5$wI2l&%|O5ym|h}bIiak|T4%fa9E`BO-G3(6wWRYXOf z(z7!^tdC;~zb2)I@TbFu5>gY?KtvINZW;{*L?4-UOp1NQ3OW{d@>K6Fz%kRjrH1`??9gmR^u zXc0mYuK#~XQ#`|F$fuwxogHhT6zWxO*HZo*T+r{BMG({ZPyQW8`(@zpE3AT;HxGvQdwu9aVW;aVxdHi$XcYMxrLw|9xKm&(ak9 z20nKE%$72P6w~T4&ANoUd{*W%uCXl-Z!e|h%laW1jvE&W_4;>;m&|Tc?)O4VI_oV0 z(d)p=)iq}>y^Z;FAI-~tH_+Bj`IierXY$Wy2mx_dTdQFRL+kx{#h^p;M`?rR(Gq>XhYv-K3->zwX}L;>m?RhjQ_PD z?AzADU)OmdY;d`i)m`$`IFS8Zjnr{{ef^UsiSelAD(H5BN_Mon+K<8U=~I;fRMp65 zwuEG(J?a6a%)2iF?gAOMO`n~y(56E0c|30EwbJ;Sz&9ahfr50;`X9xxi`aPN?Wtm7 zluFR~=y$GvT(JX!V0T&E2v2qhz?w3z6)67&;opNktKSHJfh&{W5s7=+g>t8TS=^6|!=+%JTsBRg~Q*d>b*44Lzsp;j`!lK#uDA&{># zK(*7?SIxsRRKM-bf`#U;3ez6dE&f8_>7?0i4gcR2068_*Fm6u>6U@{jZ`7Vb=v zpW@GZD!ZX=ZP$*<#V322?%lZV{E{}~cvNAt@25R|Pun9uu5l_m*B|SBYw@+?^m)fu zFF$b1L5cd<(uD#&N_#ghS+X~2nd#2NX}+(#`8G9M$@8NJz0CON2K(7~@(ZmSBR7-m zM(Vq-Wp7x&F>deftK&l)gBnAR59~D2p4cbd#&2``h1Oy(R?M}lzNb^=iYr*yW zDM8J1QZatc^lO(3YVJ_pQavW>TGMpuVDxY9Uv@g3-0|S~9X<`AOIDmwB$E$&tkS1@ zg!~56r4qM!YFHJpcp^JJU_SKf%hbZbfS&0dA3r}z8#ZvK8?(FXhRrWttR3lb*vj_F z^NZoECmj^yM-J1m=$5>^IN&f7-P@tp_JEZSR9~O2*`B)3l!5h5%QcO~>lOzG`qWKM z@4vKZYJW;?9slg0OGZ;}a#Md;b&r)ua^;8Fk*W_fN#~(r2UO1r`6L=#r1#sh-WEEj z+aQb19 zQdxYUSaA2flN*n%vMO^9n$VbVc|X#pU|B5CuKEtWqLXZG!+i&pv*i;;<86!|@TD}} zG!V3(I(tZrWWX}KKHy7TqE#n-hjdJ6$FpR1lVhD7AD9H~EL!(>S81D%j_4-~pjWT@!%{)sKQkBG5K;XaPOlWJI}|k1|F{PI zPESfj^eVa^YFX|%r>(bhtJH$?L&vZLmru}@*~|Ifk_6e*l-bH&eRoZ}r+H^?@whEz z0rjDNgXVlp&Y7u~iCm@j-XZ;^_4H2rBhlAfSZI1D$8An&8cWEsbtZMCRfmW_Xh;>2 z9B3`_E1J$r3bb3v?GG@7(eq=+)Zpx%#Jd}HI`3?aSfSv5t>u)B{N$yCYDbaYbviK! zEh768BM&ciJTk5S*2d1ms;!*9+0uuvz9x=2zo@7&smG+5-1gRZwUtR(ox7ZBY3f&( zHZ@PSpkuctdTQz7uQWUOG1)y~JfC#9ZU7d8@_>RU{>0JA;!i|q14(4&6=T{{(H?1X$tyQ<2BE$ zvh-ei=uA|IOUQjp881fGE#*4}rCVWRtV`zUdWH}2CCU|`| z@=-&j>!#+td1foiy@=I~3R}9|q%syx*k36qJVA2|y>jS=*$3&u*?N=50afuBC< zG&|7Rd{PscnV?EFH#*PaYfC;jFu;=1UnjV+ey}*3Rm7Wp=IuEDL`I$iCG}V$t7Y?G zIk#(Tu;Cy%8W~I%KkU<~o~YGhFqcSVbgqk^uoZmgV%pX7toXBR!fOjsJ+1I)(fC{I z%IHYATOKXJ!%pl*=TfyP4d*s;9UtuwY6HapsU`M{T@df~}qzh9I*fYh~7OIWwCLv?FW< z=O-_5PA7jFXw>Dy-Iv0_W28Yf^Q9m?Vz-zDJ}I=H>6AoXQ4t+NAco#@oxEDn{l!tZ zbGSdU7yH+0vSn|bepk)wt7Sovcl>yJ6K=M8EW0B%&NCF?k!F<7cAmd_=Io)_8g~V| z7O6N(9o6uXWYTDvn22riXK#z%dl8RiV=VA8GunXak=sbUvqOCq23G;D1GsEA%Dr{> z3hWJ2ET9lyj8|?|_Ml$KX>25lWEc3*)B0u%Nlm3iNKxa~*6N%USA8jupV<|?W#YMU z_gb1v_xkS1J{%gGNW9r!M$jgD`Wc31H(KVU+h*)$>2NqYI~DliM7m@% zad^W`jja!Hn0**iTT98eUsw9j>?ffIzE4;an(DrMNT1D^y`5*1*p%)wUBH^*)}L71 z#xXNl(cc`>PP-z09Yum}BQ28z^SNo?xeF(cm99EeqOz>$Y(+#jUK)AEDU**}XFxG}{WqeEFa{-wnw&+=KIbHQ>KyV+ARhRv2&MXPC&Mjok}nVA*aw|18{~thxV-5;WBU;wZ@A2i-I)IrkG;| z1Oy<;Qb;bs8Gag%ain4r!uIHoF?h|{9Zv)< zoS=J6ACiV3Y!PW_WNkgeN`eYW!miG+G@bu#H4!3T8vZAv4X(eSKUBQ@+$H8n&i}h8`K3IIY!kUs{80axQvotja-eSfbt38&7 zO!d-J)2Ct-5?;P*TO>~Q%bMwqVVqdq+Jpij%ZcQt;wk9d~Exzrj}mq(}5cKJAGD+{Dv;Vxx?W8+#||D;eXXL-<_FNlS)~nF&@!BwH#dAN7``?k7^&AKT*R&*LbGfdVsxH!(JG0; zq9O-t3H5TsmYR{beO={wB57x2VvS77E}rMBk77vV=CT}+?Jie z$v->(N!Y8#mYjcLtS!0MJ4I)jqxl2$4`2thf^E2lQUQy7gGFEJRhNkT06G2a-q=#% z(C*aU=M#-cGMzIXaInCGtJEt#0f`aU{xAESDs#)o`II$p~AOlu9cva0t~ z4~|7C&+4vXic+#h6F@A5LqqJoVTXVQ?%<1lcZ$cWM;ohODc;ia5D?JLc1YiqNOCcs z#zEzt9$HYWR5z-V%wnli86hyq>&hNDGyTBhAg_LVM5SL=LTdW-pir=f!R%Nqe=^M% z_xjilE|*!~XXoP)0`czk$M&_b)aFJf#b;zO1Scm0yla z_hhsvUO93G8V-_aC;fJ7gr_@inUYWVEhKk|lzqK_TxvsHG|A{L3|vsocxmj+pa`Y$z0oNMX0 z-usa~JgnOPY<;Xu4CxUKPsz-GSz*~J78G_|7YU9ML#g%cHqT@4FkkajeeO#5G;AZ7mo_^n%QDrtz(6gZnhvF$DVb>m z2THl;4j0zm3%kP?8rdvQIC&Vc4BHcx zO={EwiKZsS;~`u<-5^-fE{{^{Sy`W-3`M1Q}aKH1z@`uuR? z8q0K8ocuT+{hNH^;j}^%FX>Xr`K7BkI(d%ES}S$k2oKqYrFSrwVvu7!&K~Z-$)h24 z=FGic<|SWjZqOansw!LQc*D-=#@y$X@(6F7%B&Fjo}vC{Pyf@)EXGQZts`4fg;gdr4xu_vFI4Z$O#cZ}s9`A5}$n z%GqP9F&a%URa&v2_sxCDn4L^M?AY+7KU799b{$7$baCswMHkO-(HwZV_&+4=2?F{$n65B_kBObWZOc!(OU@qd_rQ(SBHcW zqqe{?uCbDomfpfgXn@h}ijO7hQ`Q4UG>nVbfe!pDC9IonEPbk=1W=|~pI?H(ar~#( zysg%-t3n%wnBsA$16(#VR{Be`Ld@V;asTxn!vD8jlOc9WnE$O*496d#!=*2F zt;I&YAcKwip+e`E7)~-U9OBucNbN7|=R*B!Ov&p?pLupoIHPmgzqAc(AbIKk>y{z zl+N-3Dp>SN4MRCwlop4A7phD}$G-DrVId<_^x_f1dZp3KWAHVv{u^mtJ ze)&o=Ul=kmGkfvdSdZztAUj&uR_y&=k24ipk2eTS5dE^ z2c!5x(LWtS(pe!P-L&z~py4-mbDH$Zo`1fQxQtVlo!P1RtuKD&dpH0H&{R@V^1_9W z=nZa9!^8JAb6xaNvp=0W!`%2tO~8Ib6vmi=r;o-BJypk4|EmKMvLDSce_OHQi1ifB zk!?R<)MjheKKK^^_372mf|6v^)jI&iLyc38KytM`3}rHa2kv1VV_N<#w2u>T9WRvm zhB>4xyC?8ZnVJwb+1E~7Hozp&Yu6*rqOB~zE8F4D(#-#MPpKY{Z}q4Z=+olDk~`2H z*q8BNf5N5slRMTh*D}i`m9;EgB_6d6jcJw<@d<+gg`% z>hjTbRs`C)rtG7jHZJvhCps=mOCN^I60#BVsppEKe|16r`M&+1uWk*ge>w%Xbq-&3 zmH!{#_(x=IrA#dRQNwR8i_fhDFY9roVz5Bo?D`YS3*Ehb2#7?2tMTPl&D!O@Pl;dq z><@W%n8Izzm|L6pRV8CMeh#Cz@l$>Wzx~uE@;@Zh6|Bd@s*gSV|CCBSBV<7sxC|8x ztyKd0c0*DYE*Z6B;#F+y0m}s3qPR7zWbdOt9hy^JlNC6qQ@1H%>divRUFn(V>yy#u zW=Uyo*zvsi*bm6gw`68MVmvMe({&J@pD%=28p13CbTB_fSLn@~4E-RGq`iChYBZ)z z-?f63lmjl1FO~@@u!T=_Jd!|ey>fDAUR@=So@%jIp{P|l|B^Ii&By>nT z%#Q{Th^XjR%sA11lbmG}x4z08UsNtYC0B-rEfd0WvJimEn+K17PwXET|I2H6LEF!{ zWzJQol_CJrAuOP$@|MDUPwp7#|Ip{g3|&bF1_l~nF6Xu2YG1N)(|*lJxEfwso1+}Z z9g=L|g8@0%72W?;<|z(jK;#G-#n4%FM?o?OWn(IIZt->cd1%ECuc{x@`VAX4Y~1Mm zx)QP|QU3UMoXNOoz2jj)I>BLCQ0OPLbQR@~rO3a|UHwCFv?K85Fv?@oK`qHKJ#=DH z^EM-m=_c$-I&M5$BI&?FbKuC2MBuj|`%4DQ`SfGSOXjE{-~ulVlZwHudxsMFAK_U> z#KjKSmxLVle+g}`MLTX$@&&Q3{>A~DGIY{HH17pEP}Go>fCF$U{pdkaxYQX1 zkO>Vq072wJlK=-6o4f=03_lN>|CG?pk(r)WQ;Ej|<3HkC%Kerr#(=8+Mdjjf}vDExzO- zNI^YUn9t_|Wzi>hH2>;C$@MymFOKeK9au@UvvOoIfo0nA(>=zauU|@zWgPgcMCG5e z)z&Ni(DnIP^d=TZ%Z){z=OK3Nxyb+F_CDQn`D|LE+)$x0a(?k#;$W4&`!DZZ&P(br zjWc@c9Y1#LEtJ)^1H_}90IT?&Zu~Dc;QZCA(N^q#>yBN{&)?+#Ub~U~*R}Lt-0lCQ znfO(eZ!djWRP@uYHqFK5^@bn!r~Ux<4er>r(Mm(Rpf_dk&NHWT*FJnG-4nRd6n%H2 z2Yz*|S3e_4b;+NzZS$!F<5kHN~IPE(t_Ei+_P=9Joc6_y_#vZ3;7OK3v*0PVWVKAliasF&)h$ zzhvmOpfr<#g=k1oU0r=l4|QrhW*j7}hr`$V(6vtq_qFO0*ks3VETuhdeGf&WU0#pu z{B)<)b9~2KF!2&Ah^V$L6{Jf)tWlPOs1)$^MlJq=`9rWB)^93WEeUxu)uCqiA2637 z3eYct7*Z66DwMk1%I_cEE40h=IH3M?$`56-Efd;XX64p4qGLru0TLgx-uYj-&3^vT zUS2E=ukNWEo|xq`nk_BLpB!`Kr~T05q+{JYYBT2J&Qr)4$y)#FYjw9I9^ZlAZ1~fI zY$s>ufUX-B5D-yq+<2-TwcJ)(Ez}+N2<-~_DSPV8g-+F;LPo^`ROn*JJ-qgNHKei* z|A|1JoMbeObyHIZ5?WTQAeY&&KGt%=&CE_;jNjW#W|LlJFTd@e$y9qLR3Yd3UW|Mx zZtDzX&37l1O)8V_Yj)1~Pw6`FCMe`5!94JB7L5c~wND}$!sS0TH3f_TU9^+Y8DtbF zgSWd>OkSG8PLG}Go4A(R%<9_Deo#*T%AGCN+P(0Nfftkvi{^5BC>e;<9(diy{o=CL z?|OdNBO)Ylaiq4JdLfC!k%aUJx;$dtUNm0nbg$nNI5a&H&&r#*bsxv%g7E5c!}!>+ zYJqg#5n{Qd!#%(}K;DJbf;2k+@Yg=3D^hmA6h)yAz zGhC^V$H0{{(?j4|A@en9Cpu#W>lO4i*&lRNZ9JKHgko$k;=_b*L)-dMufV? z8CRxZ>4H^aS*itvKU8Qw`O-06jp<{)4+=x^2uzXG^?rgb>{O>h_3ffb@r`0e5tm6L z3kjK#&eAP&BBIIocctO+){_r83aijE{>ALGL#SNQUVjQ>+rx;gIbK)y~SC zBL2nnK%O9jL-W?gu?fz~hrvm;6I|=in(RGW_JLJ_(8&;lV;fiV5{juhsNB|j`IxuA z6cgc1jMiDYM#HAhNaCq;`r2QiKNr@eAE@~I#O-e*yl=OAy-y`yc})9PH6N>*58~vF z)@tIh8qO{*Ce60(d{8hs@L8J;z)D>>TTCZ!ZQ1mu$f}v#MrDxXsLwWIn`jXB`4oU(~HbZO*6CFl2?Y?d`=lGM4MT;glVqXBqflA7NdNM zIgiD>EoPddlv(%fzUr3pwv5$%LS82;tNxu2-%Mta_tY>el45t+7$K|n#4?dtC`(*s z*ZTBI0#uAA71*b>@H3`OWoOfwo01OItWa~%8T>3W({pzx-(X=tyDx7#B7y?1zR8CA zcj2}zN1AU7lhe5;LdKQhmS$z)G|QWqO*>f)-PL8o8K|fR9P#7wqnCU7HC3?z!Sy9n#nUUAl*9A^sTVC6GLhc5s-!ZyB;B_EF4%8|C zA-|bHf-T3Mnb|q@sVt^&i|psabe3b2%hyF50{5TWwepW58R$DsGF^i>aAKq@pmXCctyOcCzyFYSPv7is7)F9t=m=Q2CEz{|{O=mdxzfokjpQP$K>m}sBv{ipw`;1hY^xt< z@>T9IM1kf_cPOTnhA!*j89(PwD~^@wiNX6|FN{5Uah%oth`?4-sDi0VI(~9+gY~^H z@4&2!O;=|u16XGTA(1n)NBu;qW@zum`kBE{n+;Y8or!ku>;`E)<-ItQS0rNxER>7k zSr4y~E_y~0-JH7R9)`kVHbkzn6P1*a=z1zD#@QfuO=IlDQP27G?=h;e{3nXE`E$X5d3ZL2pDdqYL+)4{_Pnlga7n zQZ-Wwg?ITp4^DrEs7ZW`el63Cbu*%!_;fYhOu1aM7$GoI;}g>b7mh#@-DZ&S%*MEp zrr0jVdVsDuqhBB|viiKIsj8thL}Lt<-5*SNK3-5)i1`kaMh0%5PjP}6zF){va|)WS zy2R0X(ODKCG*1gxfqEdeHkzQW0yPR!3#g0o!*cXLfwSYq4Ku7Cpa|*%`3K4l{3|LNr zB6E99a*qiZV1SF zW`_o6oLvqZUUhVFk-(*-Fj4ZRmFJDzwX7frQcqhazSiBxGhF7Fp?yb_*5F*J9j&+2 z=OuZbq(&PxbRv5<{NR3#J)O-N{Q{O@u@9E!whBrGT|y#dK4$kDl{Ceu6mJ>NqfBaj|tSU;g=+$}5C>_aFqMNFoq9pZE*>z%{X z!_B=kAtmk|J>0xLB1W+#rd)PS?M%GHY?5Nu4Hjo?$AhVpQ_y&Za!>lZ%;bH|HVOMA zfSpL%f9^|SKXyaMMgp@*(BMkv}GoH6(J*g&z6itkv*eqN|!A}whPI; zvNA67viJTTr%}3B_viWR_v?@6xo^3zah~t<{XUM@@fwsLjQ&f}K0##ogVeCr<-qe* z9k--gms0~w!|(ag?E#eCuM|=HsQqjfvm?MV5Fn6>RLY$GdnjBS%i`$@EW4RK417Dc zeb1@}F5{!Mxejm{k*)>CjrRf=Sz*etIg;O)$vi6;G17 z!bCtK?W4B*bcf%%bqDeg8m?cn2ZPTlfrJ3FYv%fIL2YlYH~GD4?RoV$2H;T2FDH{y zQ_aCy0*0Ye=l)nk1TS4D)hU?%O!=xriRp7@AKbEBthr54#jlvMdnd6~` zQbq_05l5>9XI1`1lCc3VaNdEkg=_zoS3s+x9_xwz4thg|0&NVN)CrPnO*a*Pk{IE( zoIiSZ=w{$1tpI-T^;3{)GVu=~-1pm#3p&^+^6jWN{p3=D&seJ>{@Mn zv6TVXID`mSC|d!Q5O>15;@{_v2-49nabaT$_Td3%P7vdxnEk)MAtS`MHkhIN*50Tm za}6FO4zX$%2GGXbG`_g*i&-^23(K@s>kqd5>lbTm`;8v;Tv2EwT%ZULpHQZnv-oN$ z!2@^x3Oz$$rd>^VXo%jpdCUE7i0E4db5WmsuZ_E4Z2Z9@4jn}K;!q-nw_$-nU^l{O zoF*#K?y&o|apyjD0>mQkj+X`ipUmk*jPt5vwr16v;ACiB6Y_mGUnwFHgB3j#A*X;c zt9Y^Anlr6BE;ktEPW$BtZ2lIUJMdcssI_mHT8g}45=N^oT6IQHKM+(zGhb_mbi}6+ zW^%)MAST0*zs>yoMXSA=%&79OX}A2=`D>!0qQF&|LEi8^6oPdlEvt^Qtxk3Z|L51* zr;ct_qu6?ezf);n?P@P)1P zp7mSN|5#{H*5$_{h!kwZb=la0?4XoVUP_@kJ|Y4O083?aHx79609jZgEa0gDPtK<2 zIVbY+1)+D_R15v_ryjyQCf0p@obTeZm0`QY+)-*)! z7y>1;Z0l=Z!QD}_sZjR)vXFiyCvExkRY9uaM`%jdgkF(?@bbw{t6k4n`9{A8YXK;u zh5gq0u-XFa8)Y}u?>%q!7OK;6vVd~~%AF<(odbTOYW#Q0UI1`C$8WeP7}#W0ZL)K^ zB&3l6;|1#J_!r4 z(m4jjl<`rarNn$g1?d&DziZ20;tP{F50XBY#2v_%t6c1NH-H~EdQik zVNiNH1WaL6jnI8;yt7e0iZOc`5-s+z3CzB{JZnESUg;C#;bgqxwK6u*jeNj;>T~w< zl6%zOT8$Dt-Or27>Z7LOpDBFw$gj2uYS>Ar7FANM8{t9NS4t8_VFf(fs*I%;P}TGT zan^ZgNvo|6?9TFSdq$S2?pj1InwJJa1|p}vJUiXywaij?X%><8F7*V+~h5 zc=~EfM_3s3D1^q}_}B_ACFB&UfKH1vSqh_qC1jgU1=e+6sFik%#IQ&Rzz&gOHTS8P zMk2iErp@cbJNSA7qHC!-_4OSo4V^F(S)KOt{7fO9f-|Vjh1z+D>y8%>)~rm#_&V+1 z;ATP#0rOOUrpphMq%lE|WJ0$*T-Q`M-*VbZAL842CUHiN)0CTbmvl#UQY_r$#grxU! zrQ;!lC!xU2a_85FeieWA+2f=QVi(?dPJmN=Pn=JRHK=0EqMTNjG4fb%!L2839H-w! zRwC%ZoN@c(x=Q;Icbz^k>7rSx{qkDfqy1(w3}}0XUFy8F?K9xIDyQkyrf3EO#u>>* zxsr;oz6U_pwO5^Q+S(g7NBg<2zjo`DgbFLi6F5}OLy>NNrEsq>y9K(Em7*4)p#CL9 z2$I?;*Qw&mnP^+ZI`2$?wXU%Dt&^la15Y!JCP;`@zq@eDn&|u>Og{Lgg&cLp0UKK$ zJ|Lk6^Q~h&lc>cJSJv=ppVi&er{&OWs{=Wfs{;VF9OX7NU!L}-lTSpnGJB0yk>0+w zx@}f$PhURh_y&ViCuAb691yuhoVpfJ!$BG`vaEZ3s&j7K|5Ou>3hCgN03Dk{>kQtv zAL2g3YUImXHYi3aw4b!y__J&rsoc2RqN;v^adO2`IkTz}DbEv6Jyy~STDH*>ZZ|b zy9r>&8-V&0IC!d#^JV=L5a0kbM)Uz_5YZ zv8wVd)pQFVP-nNF26%u^#c`tCK`Bko1U74jVSOEL-LLeJGnrk5paAcv47pU)9JBWl ze&DNf{@f2v2B69dZ?h^@HhO12CvW92S4$l~SG1g*Cd(tQbs!;2+lszarZ>U<7Xd}W zLiJIB%#H`!=$^7!4X1VNmX8H&8m)PJs0n8}DL!X9lZ0<(Y<$u#Bx;@Tx1}-sS>&A+ z&-SZWBQgtU^-K||Jbj0m#@Q@2r>tgBa!yxYNAxe%$Q6TDtO=6lnp@5fF!GlzOOQ(F ztEt<5y`CF61d?&2Ad$7#7!2@N<%-PAe3X_xVJ2&79T&rtOm-ws%6YblhDvgtjdC!kQ;S{nF@E{84Sy6fFB04!sMqzm^ z7ypu+fe6VX?TSu|Q)v_81pVwFXXOaqtgPsNk|`0Ux=9Su-XIip{I%MrK;~%_XKmPH zCCDDELxf}#{`q60tB#oKbkh};mBF*$r+SX60FbkyKlpr{vZ_2N^e0P{1|dcLpf|bl zUq(6ue24l3A$?0u*(b;R*QnMrMfO!ADXUqt(ZTPs#tO|4xjbz40Uwus;tU0zL7ezxY7Bwp;B-mH$dk<&Cn$Ni&cd?1L)xuuQNR-n1qq~+qB zZ{66vVbF_o)a!q`s@M89J?Aws#l{a0S~cQK-|lusU~6?ZXFWP`adiyhPKAhj&Q#P(VG}6bF{VRUlG{Bg4t=)?se~(}Aca8Qj?f*hp|GW11 zccuk!PyYc7xXLB0)e6L~?wicOpMk`!ZpIHlt~18sQ&}IM&w>FVp})VPN1C?IpUITF zUp4@j^3+hfk%#3ENpjtfX})%}!py%X%`LSeq`9kez_0(X_&cuR z`eS(kbj~+Of4&nq`l*}OUM?rBG^l>NR~}$+vq4(mFra_2FgUb#>yUM0jU#|T`|J0} zMptH{<;bKz%>v0l^zm{ldm@_tR2Ac*X7 zF#gV+tmgl9pq%Txb)d|U|1*=`EAPPZ=Tm$!vi$#0$2$Q z3GfUWhX7@2)vrJ#+sB%D+y;o|o4;$^yoMhk%ew2h&``IRaNgob4usjPLeeg95EsBY z%!?H=OwEBQ4StBr{hxsg0nv)@+7PV0T$v}6Gv_h?H{6iXe_ecPn~x%*Q@Y+D4-m{c zuYAxMXz&9-D}<;^K-2Q4-m-zQigGO$-0bdw{0_wQBOn(-_>b!v;dYS?jqv%a!4AvM z|D-g!hKT56|E4Eq*u=U57hk17stx$F5EBzasAp;+(?@`dVcNoC)(NJ*a2fK=`XnTc z^E$B;vld`WqH4wq8~B>p#$V_FZ4B}5>-eGC{gm}HS-RKz>({S2BiRW~t1CP0+Ti+y zeHZ)5c@FC!{uPVRk24Us^nv^JT4aw~G1jc5mz%S5t zKEsBR;^?}N;!W`Gt?-!!Y-#J*gIiBa6D6dK!HlgoxEY)QPuE%EB9RA$cj8QCLB1mI zN>LYv)Bj)i8-I6b)PDc~`ih+euoHHk53)AggeeK~4OAIX+E<5>;TZT=!Q%s3m0*>_ z2v-;Qr!|2#(l2#e1X0ggVfM-i&> zv%lL$*2xu{`lgL-B*M$K;ngPY@^7Xde}x&}KKlVZ{i6xc2IBm)$yf(C{}&`x#Pi1g zF9GUPEE#5t!x>&TkkCapB0A56G7!{%_NBJ|{;;PH5&{KP)I#$^2KfHw?t8Bvif#uH z5OniU^b(5o-?(F*%r+JD|Mft`pM(R^bnJgQ5VJzh2AjpPX7@(|!%f~q3&vvFzbagv z*9EwLDYizxD6T{2JeiULK+-YH?0kCYvoUOx-I zPj_x_!V+%r@1!>Q)@S{}8qN&HhvkIN{^CW^|G%9x$V}zU2VtcwQ!OBDuM=}QR_~$S z<^PERzFzyJU4HRvfqw$3pKaGSMnhLi1hs%1*ly9J3SK!%1!^Eden-c%W!BTjz2Sx> zw*$@yz4C-aM`E&{Xc^tL=4_F z9~i$@N;2~bNlbNE5c z0dfb|b$TYOEt8i?H-Owyb{sTgLfBU_$kzud1B}m`Q#XI<0a*%yM8;ZZwYM5VN>I?| znmi8|68@s>82rcZbNIpt;kse-ujia_p?g$_r&m`mieK91b@=5)-j6l)Ukf=n*iVY% z#^}8!&{8t>0%b+~VwH%wi9w!TSrLTVJs%)Y&*Mn^kvrh)lEHH~&3{gsFScC!6`@?~XZ3P4{{Qc`lem$W<| z^A}6>h}~Wz*uDgIj}$~lj$GFNw}8yuGz#01m`(G& zw~uUiJK__|#flj@j&N$vLW#-aoQFmB%VDb3TH z{Q=RZH3NTx@A&VZpLlY6kC8Rrv9An20t~1IPiX6${#iV4URON4i1X-?)oa(U+faWG z13x7Eq_-z3-uxPWb?No)@@t+WhCA z|9=lYlYvLU?TEBnm;RdZNkhH|v9gzba*%l&;#|tNb2BDkM;l`K$#t5M(Y^8Jp})pS zJ-NG{k#I=l{U3-o>;Um6#`W}0LUSZt!B~`MYNuxa<*&J_c#%?1?rym^pJ=`?An7@X zDKnKL^F=fP5ACsq?f)FBdj;MP$r3o&PmGwWf?NJ=LSaAnq#=h193Gz3zFPjuYj1qC zv1s(&{omp5>4|B`Ddx5rM8VQ3gp0o0d@pj*KM^{>YgucE%|3;6myjs?1-Xd81xhdk|?R+a4F4QGD0p=a+zbO@okVU}uee;DMAR#LE z&Vs)vv{#VZt>}b@NBoK{Z%#zzIxx#iFCRgEQKo>kmNT$fgPp%(m(ZK~?7XFk8<^Kl z%hROcm9IRug?z`Crhnv38yG+twR3aN_;pUS~>i^8grw$}P z_k(F6;xFi4IRq@7I*p6gjX@S&9ACx_DUvH@zCpQ@95=07kn zV9&Z9;Rkz|sNY=;OAnGyYdaCL-JXv@wp%1i#%@j;7RuVQ#MBzl2CV#|1u!85_WLC0 z=HbIkWoGiEd<0pwp`oGO46fXWFXj^kqpKg-(zO?wO}lp%- z=HM46)%W`FU4MEcBLD7WkH4{LIh55{ZvjoqVgUisOXv~c`unnlhJqLNh{2?OnlF0} z*xQX%URGJYL<2&MqyR5Bw?js0hHXlD7As3OSrfpnrp*xE%XSGWGf26f%6rMvK;g5_&8#Et1tmHFt{}O5O6>!IQ502M&P6$k_H7{ zeN5_k_UqP-!C_&BmY*RF161K3pf2h?eIE3iCOry&IU2`DF`U0zHA z-^w0P`-EF@6JW`unrDx}JrtwRe4X`4 zgd3}wm6Z|TQ4or{&_;9dscSCO&59^D@BNi!W!B@xq?a{&jKcH|?BAEn%-xcj&n*A? zTupiTbpu*YCVy9P4-HH0U_D!&%G}igd}>!KNK-?^t>DY1=;s%M)^Np4k9MdZ8~R@G zSWeBqo*k?vue#5}g=k1tRsINOt_b|{BpI<7P|cA`Hp-TA(1Ik1`276*W=V+LRZ&$1 zA%8AV0zse%nM;n4HLT(M>J@QHp|VjfZLjdkoF+RP(ZgV_`w$}V8ihh-WXwYDFoT&U zAZdwYb|TSp+;ntT+YF+5LXOtfcCoPcq{=lyB3%je3QB>bF&@}muDhO@SOfO;It8MH zz-K~Q!&0NiRWLI%(;OZkkOIl%_$o@mpA;mz$cd9QAzZ`}y?_3^15cfX*}5e85{F6U0AY`u)rqURufAJk@&? z6u9Vj%sS?3pzjLCOrCBS-nnV=?K0LL-$84QWuZ!yk=22%iS& zhc73zkWJ^3-z*u##$H=tjkgyFu6>B+D%p*aU_K^N=5Hi8-{S+0hE^sfweFa}Hk5M} z%ST@w8p!LNxcVgAVMejGNkf^AjxJE)t2;)q`I7WCY+5fD{P95R7zfY12*gL_U8UjqqRM8w3W{7OqpgH>bOgC{&P0N!>Z zILs001rl!Q_*)F~$GK}|ZsrA$c3(gnwWPD0Jb6*2bg(grf`Wo+336f>7Y{v_3)!cH ze^?bm=MR>G3`V-eI4XbxsdLTV8K(|Li!wFkB^n!KK61z~39zXWI zRtJ}{cnMD8G!4tiz8d-McOf$<8vm=F2j*%4Id3gr5gabX_K>szn4^^pq0I=Uu$QF0 z0`)?x(ytuN~Hdf zuo|D9K2jMY8O}-qr?8yiVJeuWYt!{MB`MP>)B0SAi;HV4!hr#N5%5g%=+|~a+OKzM zwCVb^ZlFtWsYj!37q~UjFx!=x)sS#yeAKCQE>nZ?2+E$|l!(rUk^2)x9L<^Q)K#=6D+Bfl-Lx~3 zftQb>d}>mNp4W`}mY&n5qvq#!T(VBF2NYjJh>J@Ooewcf+NANbrzh3UUY@PyA9bAv z2-bZb_Vaj6OL!a7Noi^6v)Xi4usAeN~;Y@@^k}C zWD%~1<9IO*N$-ga*;Y}D8i7dhBP?+~MWC@Sb4Lb6|UOiTh{s%9xcO6%v(-LoA| zq(&CFW@#pEIwxhb_K!A@3hUSLDj+>6R?~8DM(znk2a~Mv@xE z&X1h60yTol^p}Jv65(W-z(O5?olIqhyiS7?`s(j*KlJhOAya|_F73=2W-Ax0HpR4j zm@K@i#+8+`amV@ilqiv_KHZs!TSh{Y=zX0@dKpmt8kRffk`#7E1%&$h`;$3BU@e57 z$Gk#910is;OrRCYT`{=kemZE0M5$;o^4gu$j&rZ~n=s~pt8`q!Z6474K^k35}zZFD&UHph#T=`@bUZZw_T7i^m2tru_ ziw{>UgdN4h0);r5230wp1{IzrN4c%=_N)%scKNri@!i@wJ z;lS8WFwl|cqI4!?I=!4P1Td=d2;8Z624_cUZ*^o*p!mTagi;nQaRy?`p}YXw;asRG zHJm|p{LC4IrC`+!C}~%hwpN9B6#_viM`9YBQm21OmZYT5?33_jcWVbw_Jn<;tDw zp65)i`^Q~i%86*!u$-CA5-ZC=m50; ztt6#s0DpPRdOZ|YU}gxOTj!Y*Wnw(7p)ZN6o>hUsUU2KsxDMw^>2r!c9FDmcmY_j) zCwGVaB$VKl7oqZ=d3lxUrCl>*(ciuu0hw3#?%e}(s-m1jhYn4!U=_OP;lMci1PWdl zX2CPdE%@YUR+0yIc^goa=rkO`zd&OJ`fGN+C$%4?(Gm{FlS=3nj5RtB0??KR^SNSg z=t{tWN*(P%$=?`Dzt1lHeO4os$|st0?X2Kj!^Xzmd|Ls*@C~CC`@cZER1)S=97J8K zPUQuRf>Xcq!`Ik~AZ-fRNoDC>hzyI-^OJr4pb-Xp7}t4dh#2$33|_}w`Ft_K>n<1K zHepH#w^b7Q7G@U7K-fkgy&Ga{jGa{Q;S7!4~U)z6=^!AbIQSR8O2NI4jr7-jdVMhz#I`q^13Y3Q6Gms(NMk(-^8%qF`6g}JgL3Qx8tA#U(<;P6T8A#+kzm4nYy)RgX| z2}qs>?wl7nfBBe-M_6MCbyTrpW^H%>h%>S^5y)!TZ|!y6|5L9!6%Z=^B7YGgQDx`L zlA-$y5(?S>iGcpAx-Cm$Uo%uzzWQmD#Goi12KzWnKdeh2BW4tfZXzI0i@6wesyA^X0HUkNA@66@zuWU3$P~V2 zGcLl3emP~Jp8t|ZqbNe%Y1x-hv*PMbSs5N$j_Pgen3ziaL6l}H-WuTA37_x}zMaS? zL_&N&dqIWx{grY5zGLh;-bYYGtLfMz?u&0ar~(IGJ!9fk^@R!gEAWX;P?<$XFiSCkCJs zL2@5T6abRD14+pni#orF9%m=H280ShG_me1I65fKO)FFi1_uU`laph>VP_p*<7HtH zx6y|lr;{-qQX8RoG&XZhDyjf@;#PXDN%vEQWS6?46^Z}h3gew8(y+{aj$yc-moiAU!INot!|Ng1T$sq^-{{H@LJ9d@Xq_je$x6Ke( zb!uQA?!afX%L9ag>eWn!O(H%XUMW0Dc=t3u2dI9<K~OCLsYE#!L1vLZJQL#VYyYtJ zF9hqQC{zOKJQkP<@+>V3L71r;vy}zQyN}b8#YV*yJMe{KaJ-X)Ca?87Bje;s zaCgrd^_0=bogRkjoN*=}QlqB}0f%sNuJmKc@d*yuw|B2n=na5GY&lVD5MiE`KL({k zwBey!n)Rof_+u;CreRs$*A)^HQcsw=kC3|c{hi?@?QZCDN~!c4^PTR!T%po;Bs_HZ zYi(QGbn86N{DkSk9rcbu$PGkig)*<*Slh!_<5XKDbBh)NR4)}>qiMy#u9OJ~iH?p= z9|i>*H_4*cvu84Fa4sL&ck<-P(Vo+Nz{$_<0nAQ)T2EWk67%96F^ z&Gp=OmQKv__v(7@(B4e{p1V6GNg8d~npvPh#GSF%VsOrBsXXUOscml{U989nlubJR7-QFKWZ z?Uc6I4Mp=?m9wt%il|bDqo|&GubgkGHgn^p)X=rP8)3H?yv8f6Rk0iH?iKbNv%c=5 z+{xgk;4*qx!zm}^_QIDOXdY%qmeKzFjeqQFgo^L$Nw0JBOV4~Y9E63b>+rkX=Fe)0 z;^SvLn>Wy{^b>#lC@7ff#G>3y0OXz$3_GldER6_;-&GSdH2=buo_u&Gt2(<(uJKSh zVNv1R%IM0TkmgDJgg#eYhp9!I65OR5Bp*p>=3Rz6d)Eu@}T}7RShDQ=1DRkwse2UVwYggxGl7I*H$jeKoF^#%t3Hf|}tJAYy(d^*L zM?K%yOU^EACYSl_25;R(*IXMLSqLMlwc3-SO~`1K$7TpwCv0)}E3>aM%ee2FO5k4K z@VC?$Y{{?-W6wFt`BCKJW9+Gltl0onC8cjr@5tP|iJtieBL#ROLFvB;!JDf2jt+1E z0ey_R^4uG?j$P2pPA;k5l#%g0;D#}I{#I{q%-v0J_2I?qr+UiN!e_nQW-6&e zWTVH%3SjvO1%Ir0%8ms6eNrLmK}_;?9XL8SH+PKJv?z5H!Vlr3H-jdC_I9bW^Up!&A@$|*Gfo2BL58) zeOLe>gl*e*>>wf{@+Av1c%A1?p4>r)CxzxN z{&Bv4=UGE-_Z~wL$@EOIYqZ>Nk+1aUM)`zUpSZ?sVr3P|Ze}n)!8$#-(;cfUq~6&% z{=mlvT$__V7cMZc=af7ja`!iFH$EP%Ej|j{Or=X_9No0uMVA@FMzk1OBG=Q_vB2(7 zBzd$;*+<*fjt=>A<(Mp-k7WAw#pxHA?WC+hgS~Q{umk%AlgwY4NjgQ#3oWhc{TCep zZIQ)BecamI7K68_si|wVt~jIuEGj8k1Jjfe4)_Yq)Z^ph5G&mEE)<{(7$%#+S6>Qu z!jlU5>sK71)z-0G7&a}e!mVo6en?(6<{WyWGFMZ@k*{NKWb-+srJPh|hKV;lGQfji z9IBYN&PsJjA*h%d+;xH6oNE-?*mI^m*Wm3zbV@e;a!HUg&j_i(>@Hvbwnq=%9cDvR zhWL2JmNNT)Twl)}Yar?uO-r%M+=`BCX$TK?e1H~tb(DPo#=wfA?>o-{7hYm9{q|cDnngG(N z4ot1byAIgf+j}14E!_IZX!w_TAXpx}<-2#IpxFc}cRLPeuyp2y)RP{Of~V~KPmldA z?S!hoittC60H>&GmVz|bnU@tE(`=A>THoij}H>do^ks=&@Ai|HqrvX@Yr7FtN zp3;%*8oh`qjmW>wLpOUH9J4mv^&2-Rz^_(RbT26hG!dPz5ManH_X99vVLYa;t{zp| z)aml@2{aWa{=KQ#pm|iYYFgTpO=h@0{?U{)3jz%QYVEXMC&t_8wF_Ve75Tr+<{v&s zC^vE$N3iqHMJ^Q;#l~V5!b`lIqAsOQsztlH?p~xyAaML&>MgvW<}r$O;|n}IL-!xN zi}Q4A&-vVyjh|#PT-p3BJiPz;uQqq{55Y#nxOd(3ffMUxk%!r*J?otsC)Y;??SExd ztaGdY0%$A3{jaaFRy`a-b)zHg*IVH=&}bXdW83EZn>u#s zzd$7a(|bDI0Rj)4fggecLYFO$ZSajK<9oh*8IhLeC_ZP>rNG<$o@kfxiD($wYHMkk zy#DU)4oh^$Z?7hvIBtzACKc)C9%Q~)%?k%TZ&d)VVc84$BuQ{xFy68`%@QD+(-R|N z*si8v&U5ps{A4-;@(Dd?;+ydCzDJY&*vs7Ufj1Mer-L4T(hnVqnAjC|{_#;^ zZXfGt%3of%c-Nm_xGo?xpoe4l8hnB+TeH-DSbBfIh(@GniBOsvXDLvq)4DqIA}{~X zoqKgC0X5%keDC|#GU)$C3(9fBVAM;c&tjvX(P@1x3ME_7n^-b)JZQdkYxDkjSCKhr32b9D#i@f74)O zXb54%fJCaJ{5dAh$4n1W=hQ*KGY!lt`~C;H$ann@;7o|(2CT!n#}{~s+@o#RQo2FO;hRL>vs zzVGnQ_YxK-?VL9xUf;R0NvTV}{5IPa12i0sr8yc}c9_mj6viv%R=*zQdRD%$+-K!b zCl000zWs?bqTpM5MyuR8Jm19B^zc586&@wm1FT^Ip^fiK^;GGR2A@$iMZ?*)6QLLt z!t}VUT)Y|r8+i^^go(5pX8iSz8Jd45X#F?@FyiRy6+X`m_9cO= zDU|qoUl=i+$Ez-sHaLu8a=$*53Hcw1PODNwvpyZu;@l}JaXTAe1i2#XCl=1$o2OFG z&L1U698us*g?i>n#vrj5RW~)z&1W?d0<-EqXAKBfi2MpnsOiG``dcYy&Yqo+Ff^^M ztW3DU3ga!=ciLRq^3ce9fqB}KSD68nPD1~_cdoPHe(pBx6sQ|ncR`Y4hOIbKT#wT6 zSHDSEhJ|ToQGLc$$RCSUO2Y^1>wLQ!x{AjYd{&0a$swrl@S5IctY5dda)!f~^x>0Q zmF=U$s>4%(f)!yWW4vBY3ac-r%fvLYvSJ6D-c7ffNisa-KwYg>QWSI(%+Q;DfilCK z79Vs-Thy$iP(od_5V?_neY`7IA;vSmHC;T|1t+^ehz@k>3AONevYh5 zI1c*Qtivddw#NgtRhA(K4<8y|`1G(wHoj+MNO>8WdIhRfrOJJNzNr(d2Jonb$C|^y zaM1ax=dnXzNvUjAI_`Lm1aB*HhwwS^#Me&c^MnBWcYY8Rna;(Kpl3JxL$>s*ogDKQa)TB7cYA%lE#`kRJ`*m?`E67^!2Z7 zDgYGnWK|nk&>IeW*TkuNQ*u`|n(DH?R@CF_AiQojhHze4Jh4S4@-asH4jS>>gM(kC(ODureF{UblGx8^b?lRi|v&a@h?RO{_zzC-l z3*YRQSB8}P<&wll-j?pzp^pyZXm4wiO+2nfB`}3qp7mG!csIxc7&ve##rY+;;%>#= zy!dqLTc)nG3qjJ8C;F>`ak8P<0u^)i95h;tn>!;S;`nso*x1-vt%_50bZdBEEAb{b z9q&^<0uTm`JqP2x2UKUCV<-it0_Qx`U|X`!GRK&YpY0qY2^7<7nR)4C7SEl7$ zS)T@Bf>6NysmVBPugJ6ym4y|;jo9}LHN z`T4z$a*F0rkdZaRq;S&ey12M3*C}m$7z z|ALK(z~~Sgw?lR_ec(B#0%G!P?;-p@<{*|pSt7iIIcuu&p$oNPVi-*6X}AT9&j1+b zlyV)xWX^C+hiUZ>E=DOo->$QEd89Aj@Vm0GAoosg_(DpSn7;1)d%s*EC3b%HJrAL| zRLg&Ga)<$GRn5pZjT^y z4t`|i_|SQMiLb6GP$6dLFNnPSthKdOv=63;hsnuph8kJssPMx@{(~gM@wV{!e$XE4^l#zx%;AL0d6g*85@l-Xj(H^Sx)HaP@A~dBk=A!o{iN z-5YNijKPpo!V@^nx7gLlMCfiuHz*$1`1RYDAWEPWFdHc6W|txm2-acIlKVN3(HiNs zV+6{?#loFZZYFY>-y2;VW%HRCq5vBOyTBqeNku#QKV zwoW$wG_qew`@G2jJWpR%2YZ_p;Fp?xmn9^sA=64CTqx-e9L@u#BDS`+fMhAj6@*LL z_a9d@;x7Kpcxqxgb&rxV`pBQpun)TEk%i|)5AZs;?o$a(cPDF>W(Y3aLxJ;#yR*{k zgka2dLc#h73Ch*b9HGMrZsLx4b4hZd1Ml*kRI>CMi(f4d$a`Ab$y0D8dg)rmUpc^L zGPV3vvdNxU_O*x&IZqv*JI1%+YU{Ba6=sjN4<}ZF4`@`u-lLesp#{i|5oP``gFA#O+63)K|+oKv4 zDhTWY@u&9PyJIwkE(G35MNfZo5jO{4TWc$cvsH&F`SX(QeEv4k#|-DD(^8RT)<=`> z>^pZ>g#%N+=ekZ{ReP48j)H;wVJ3cFUfE<7lgd7()SIG#@?MLJi|!2}p_M}OcPX&s z27`jDI?Hx&iWaqR-=Xh8!L6_-Bv8=3v7!Q=paD0!M@6PqR!!s_rS4o!38eS#d={{} zSFe=h=i;*3kscXGMMdbU4IZdUiHSwH#5ko~&(8C}d1(j4&9BDVNB9C$^8-XCO%D4EgGfA8CE|2+k?~kUW3m371V;gftPu9N!z7%VI*_%-NL{$*!Q``2_On)9e zSPZLU+VcNe&-#oA+7;d9BQM6eYls3|Sp2qiX{XFFQG)_UT-y87QB05N?hze4cw7f6 z){5Ug#c;*O*gPB)TpI`DPyDt0k-t>ec``hIT2A35Ro9%`aMwX{r(+iMDbM`HTGAcT zU@EjE8*vc8IWjVZ1UVM+qy)9xY-@5763h7stxMytAK#^HC+6rGd%QNP{j(;;XkC+H zxi$`?uZ20Y2Ef7ur_O5jjgGSIK={hf+}z5mt4sE8Z5nUWZaun+Z~+0Xn6`Z>DJc_s zEC)-QerYgYu&v2n?4#hAi@*mi0{bBp(;48eO;1ftjgNPZTi|W2B64APjCZbc4L}h* zkM?wP3s5b%cH@R}wz)1qNQ_%+x2@;IU(W{K6DI^1^@0N09qm4bm^AO%!BcML?&|ve z;zK4z_ZKP(&12C4zrp0nZNEKP7Nq!WdKs>e*(aAEo;foWYmeuDk&g8g7XP33n4e;! zf7|5$?t%I-(s+FB|JXDB=l2|A+mQOe7f0oL{s3pTkP?1-{qWAE1aAzq@wToWsoOtS z1X2yP5=X6@H6#D>zy8(FR<4SB?@W`)=I+y@aq?X1)m!x{p<o9*`K)@77RRH^I$YBC<+Q!RX ze*U|c-2_Q_Q1sMCZh?|YtlWn3RRE<=-f8yJt4l*@;OO2K|LU2)ckOe|0@dTUgrQ&1 zus#bZfQYi6VceWnm-rdZotuKG8CIkK6qVOl`Tm_2v?;~=0e&#>zI%KarTJA8Eg`13 zDsJB!_`<_uKP$0~w~r4IDQO1SN`Q3gq&p$yDP=&H|Lv3hgqyaaZwy&vMzAv22Y?am zWBK~^YZ6Dn8MW#lG#U+3QedtFThU^oryP*p3T0q5?vYP{z8Nfpor5nL(8{%EnnZmV zhIEJ`Q;W|q@Bt=wBB{E43b3Yj?AjjyG9+NuHCzpZLLE9RdU>@><4%~FJr831Movl^ zBU=Vk{NC>FZY&l%Fp%Z6>X;l0XC21Y;CI*+;JxCoXW`-P-4FPkU@7kIR|rlsv{|t= zaJ()mIx#ytJ2iDo*m3C<7n$Uk4*<-> z%B2YAfC^-X4oL&w96B~F7YG?UI11$6TM2%MeBv~=r^oohj;(ki@{u>;#|HtbdqTad zN5sYX@A>0%Qu?eePnv@en^~YP84oat%$%Icn2J3`)ea605DtgX+W51!@mQEjh=VEs zXrf7K8ob)1$Br=*yb(wokr*NTSP^b{go5DcxqgX}9b*E5g8b(F$9ro+`TKf$-Z)06 z0(b|MZcPkg8LLI=cb0`BfqS&c_8Ry=rxE|!>6^ju>oDe)dWAN z)gjS01*9erlk4X0-W9ZKYfneK|0h2CV46MWV#j?FnY@XcJDcCQMlYqGf-&VB$3Rj> z;VW8F$CVP$L@}f1x?`yZ8$>_4`4JwQ3mGVcf;}coPd)DIs$+%fNxbrj>7e(>vIo+1mlndh>;SfE+|9S3Hh&{~1MEhCC!3^{ z2J6&u9!r|6yY+-VUjRoESIO-&Ux2QAm%D?$`3GJb;{EKvkf!B2PWHtf`xb5JZN{HP zcJtnqtK~-BT4;%-1m-{?O|(N6@YQFnUv+t44ji3|49M~|Lx!>LN80u_X8CDaIyayW z9XeV3{v5w}IQwf*4PY>sS?fkflvOgkoEu@$wuL zs08V#EB&efY>9v~7tph?Ux9Q;qZd*> z>{hBEm#=35)}#K{H+v9>_=O7IZ=Zdx=)22?FPE1qys_?p`u9B$_QHP8-(5l&$(y;? zg%VF?h(4=~K<~76hD8hh{T88{>A2ZBU6xskDK=zz$)2l})xY#`i{)Vb zx8k=dxwa1hc%zrA2Bb+2>Ds=Afj`Ba`q*t(o}bHkjfo0KFG@XMr}9nHi<8KS0l{Zf zPNW~$tCtKd1+RM?(E!VduIYz6!V_+lw>4!fxahaPtdwCT2O$_DJ!PN9VX*%7JN*1f zVXAjJB?FpYGY(~AiP7Iz>Y=EJS`o98yTvy>EDdUic)8(%Xz`)Z_DQ$K z{)#@-NaVu)PBtci>qqIQU12)zBkA-ezT8lkH+u%c-9q;aHuo zaVk39+5W)Rw9HGCx06kMy{X1V9IZ zB;jxZpbMNgynXvNV)@oV%gHH=Iin768-&@isLc#DjUwXi^MG6u5E8;5KR?PHvq#Ok z(;1B896{SYfrax7D_Jo!*uYey(O2%R6JxL#mJxIr#bZ| z%Kl9VCLolrH|?(On|DUjdJRSXYqM#Gu)P;mWaYm9szQpF3@>^HG-8!^GVy~ z1cu&%)n4v%wTzMxd+J#G2{rf6x-4wx(a8>ra_r$Og0=<;7+jF9q%LJDz~RM}gmN{~ z=?x!V8+Jm6eivPRbiSAfMZ~O>T2@t+WDcvA_2tW#z}@jSDt8SQ*}}0>$U~QxA9AwD zfucv%Ef5YyK%%Cq^EEAjybOs*?_?7i!Gn&)Uo3nj|3NpD3X{xt!Q2Nri?sJ5KPYQ+ zEpAW`5B2?XrwNVpiZkN0k)2d#2o%q)oy*6Efp@vkugv&ux}z^2VSME@S#?MB@C}>& z!P2gJ>aD9?_W%cH>Fsc{m7zq*aJ{S%P|nixTc8L2acD?LqdhULx+eflZWxD^Vo`SC zpLk_dFQC9P^wH0`l_NmNnJ5$WRDODp3Xp4rwigwHQ516bBTCC461Hb(RLnN8UE-!F zLVxq>E5{}XhcKxfB`AXJq}i)PsVq58*>FDMv&*c*NLGxBN`>2YmZ?N%(BMr>!q|2) zvAnFz6@>V!K@K3P?gRG)P$$Z5x4c{gi;)dPJcIQNCPiHW1wfs;c=4ixy}f|h9s&X( z$0Z)83kZ54*!myQiwD~^kD?ZbMychKgDlv!oECgf!b$t|z|cwm{Hd>~H2uZpmp15g zm(qAGv*w~s{K61JB`@DjEw948aiP+ait${nR;5b;20^F8IsYRTjm{9HM(O=^gK(C^-nd!TF-R%H5i#&+sF_K+=LHEF%{ zN)k^p7N+$boXit=Z1Wuj;WE9ArX=RyvwQ4FLg<2te{)Ne7gquZ!W3fDT20Z(IyJ0) z)urVFU)k^z-7s;=VSN{jmdvt&AqgDJ9=38l%o!NUUvbO>EhZ223NUp5O%Zr34h85~ zX=rHNX6>q30ge=6BnV_BAt50cfOUTTW&A*P;U~}n(;6)`L4f&&pgzQ@%#_o$&`WxA z9CM9RtjiG#{5rAc{&R|^1N#>9sf8W7+#*`3i_Cwr(t-?4S48Y#yjP^B(Fcs#)`|JO zDPvH*kg8cPbh=Q0X#NZo7J$MtvB0tML}7j?ca@zY1Aum%bUjNg;}`nGnU%sgjb5lO z^o88B13svuonXVj$!XV42)O(CTzNit&ZzypUIU{B)V*yQLduL@$lZZrt+L|?$P-t_ ziCS3Lo;HZ6nT3e@H#)fLDCSM{=cXDh8;VnJ~Z7;tA7W+tnJG)4?Eey1+hZ!b*z3e`Dj6te&Fc2-2?=^|9t7bEYvmwi4eG=cNT7Z0Q#Cv zhv?aya+t{(YOjtaCF%>)w*(oUXcvX9%90R>n&4*ka>5kq`m?lteRor#EF()RGI%&2 z3g0x2Xx<}3nHR!%K885XRg887Q(e=yp^=Cd^zC@8)UT+2r75=*M{tbi;L)Rl!^7Z% zU;)UVuy8(%Pb=<74nw>-&4r}`qf~pSn!>`u;0yde_TD=#$36ZZcaB4c&@n1$AxTRb znyO=lQfSfCx@l3NG?a79(x5b{P}+O%Qj|9ByEJG>-3{%uzRxQwXMaAQe|~@b`orTK zy6e8L>wUf7uh;YS92zqV5wk@*zX5lPqJ1>uk07nt_T&2^4!QLoU$7kkxmNgc#)<6& z3-S}JIh6URf+L#M)&RJmytSP_*k*RW`^Uzf15uOhH07tIS9gaYE%N58A z*e~oBu52I_G>7ZPMaITWJy0ZfF)pE+_Ivp>m!b2v4wdSgxW!kDnc3-A3%il~8q!HU zO+l!}Ar!cSQG;h^k%EasZ*-iqv}>2uUVoU95TNHy!}NS7f(U!!K<_hI5)Y3isj7_!vNOpRD>E)pg++ zhLu9Zs*pub0aAzHWheSJr&KCu8loSuV@4mwuy!`+J?b%F{#y_&$SP3`|jxV2@H zyCaz&Ga~uNyI#vn)j`01(RDg>4|WTzc+d-jUE11C34n>R@g&FJk4ydvj+EgB%fiF| zIc437rF(IPqR}U|qBe&e81T6;i3zZ?U(fZQc)2^l{_NiZZGe5-v_G4upp!cNZOV6e zyYS}C2W0jic~vZATd{9OXer0X2b(u<9=cekudk1uP@I?7C6{5MVA=kIb+!L;`=QYR zhDQL6_*y{DdziNXY`{PL|KvPY%Kx{>d7QrHt3;m?K5ZS33;zvlU-ZxsTt?i-hwFb{ zxe`3Ql4nXapOt`bofm(1=S9Eq78adQP^t-TvZ~ zK3k*ossd!F=sko11`aUdFFdrU&$;nwpxPsoS-( zwyCg)nmtT-hce$O_c1-M+7@kaIGv7gsYF2y2klL(Tjj+`!mKMZWt#4}lMF&+6)2ov2Q* z6stGCv$VKNitEaj;6xq1OBFISyGs*o!}M=!sflieXBuJ)o1Z;)8Y#USt)KEWorF}e z+>0$FHPodg{(Lz!0oSW;ptdS|Ks)>Pwt`jnOCv}H?^YK*kYEih0MYd;7(Z);pvkL(iWH<1uGe>3tQfAI~QGl*Q1kKe1P+ z>raSqT?H>C4n7KxJE3?yov~wM-gtOuqiV!RZYvA3KyZC_>U8L{*y(9IE|m+^)V=gO z&%JGXnjN7!-T=r0id(Bd!_yCvs>O{7*5tnE6Y+bp&6-k7b>9FC=*NP9XNJlZDlD)0cHG95Ci4X85#qGUcL|MAh z=2+S55;6766z%6uXX_$g`u%>jDLpeY0R2 zDWZx@%KG2kZvBka&U{P`uR&p3wRF`P`Ac?Ir8g#Ie=0OSR$cPj?VVn-qzy55)r<`Nc01Dbr$4-P zXIt>Yz*5z-KTiiK%(&oWfjCtj#WyBGV zcKa9hHSc@3UOj6QDcjdxm^)e_aTT_X4N)fx`XqAh6z1in=oMx?if#&35E-p%7<^Qq zzCma(fPZ+7CYUe(^yEk3!Xfkm89~y&Igy)-MQic)U6}(LG6#Bf z3O>Rs>deyw-RDj#8LDjiGSaa{TUv0L_c_Q^4LmD8ut9i)9B2OO<4S6SuDddRFX)1s z3xcMNV@D4ibZ*RPzg?=js`Fr|zx*w`i8mkpB~s^hk_slN`El{Xt6MIf=VoKR<85m{ z8L@9!k@YY~n2&!k%Z77iB{g@o50pvUn5f?uc9R;d(VL9S*SDR8VUMtl)wOj)h(h0x zb3f=E3AdruL~S#dew(wzshmnz*XN6WY&>9>{7^ZPWN*(KZ2mg!O=n4ZYZ^mjmF=ok ztBy%Wzmiy5sIdN6)+KX>qwfEjr_j*>= zKxH%jOmwRB^z;r64j%W9)3|v00yZe&8v3Aa%gx1gSPc>A+>zkMm)nV&mCp4=l(GIPH7Qx1$qPoVHw*h))@~A13~_x;JJZ>C@w~xo+oN)>;8A!F zgk5)IYUb+Gj-J!6$;d9&4O6d*<`_f= zpTpAbwY-~cyNha|ZA^Ox-@9-he=V9LX9pb|SSH)9o>Hx^QlsLD-4iRx%AW}o9MruR zJ#U|hs+?)SV5Bxg!CT(r0K@L~RXzj5klSTloC+>e2w3y>?eXKJHEV*Hn3z_$xHcN$>9?< zvy1OrJfo<@`mzZ^9C+?^T8v+gvriz~2}=pdm=p23K{C0I=vq?e7;9M)t%9;N#yfY> z)<&qtreskXlMAlbWKZ5A_f4C7M&*3yC9qA+T%AXBiPgP2t}83Fcf{L_a$!l_W5?vv zOI0T%BdZWEGiLr!`}<-l5#Ol#xcQZehs^tc@46e{$K)`E#V9Eu7Y{g%PGxp;^Rjn z_DQiOXx9-?62#33qbIxQGd*N6Zz|@e*q00N{k%P>7gt55y zk}>*z4g08=u*r?=?CiUCO{3J^_O|jt^kvSj@6<0#zZoX04@3MH<=km?|6wXk&g0E% z6S-{`f8n-Q=2{tYpw3H*1h6cAe^o|uX zStSbgKYFv&!CB);bL2ol-1w0~ibZt3+{MXDXQF%ueRV3!xs?@-8l~vH-DhX*3-2ey z5!&8C&qQV>rac_lni2PI+hoNCypdoC6}Pm@uTQ<}{Qlu?zGmC9?e&RU+1T1UVBsVG z;N_2&qhE9_Xv2WIfTxPkcGJU-4J3`iqua4eSDW3#6 z4WooT^fyjQdRvA_iRiEr@N4XA{Z6wMn!oIIJ08ppV%u*FD&@X4Y0BD>3WMu*$A>)m*@1Ulua zwx3Khsx8@jGsonCg>9$jJIvolTT7`%bu9&kpHe-oid@aMv?PmIy||k7=T2;+KG%@8 zttWJ6RW|%Xw6n+5wIW{{i?Am4zG54^uqW8BBB06iP+0}Bh>b*D80S>Rg5buMv2eRe0%cpWEox>#C*uFqYg>=-+W7AF|z}s{~d_ZQ|}y&-1Mlqnl}~j9xvCzbRvFc)`l5_Uu(FTvZ5=BdE@T zZ!`Gv4R6(@$&yE~8ZLE5ZJ;3CytUI!yC$DTTEn3sZcf2w|A1@Q$;5~tJ@bo|=}bC1 zM@OnqV|ZU?2?fIFg*UL&*(G0R^qo)68+eXqzf^ktWzMTBdB?bHEH#Id4c3EyqsBFLE!z{DFTI$qM z!l3<=wbU7G_S_!rt9}@%3*q7t;Lm(4V)lhAr+Kr@o^isL%bS_ufiS=%8TV# z*#5ZgCwS$)#X~yloA}mSchy3_B>kgb{gUE#5{~r0dSe%ZEaVDR9>D6Z^1wLj(yDxx zVXh6z>i`s9>Ga9E-;5-inr6xszHc)4Q}2jsS#x4PA&=#G*8;gV)?}XA8HP;Uky1G@ zk%HMJC7A{7IJ*`cR@(@|;P&aq1lr<-X{MtO^Sa}J@*nn}D(dT9_zNCVEv(mob*xUj zn*Rb_0!Ame<4?c;?o&$vTpK(N3VI)1uA-!Ge{9>reR(%tPCixUs<1@kShS@n5b_Udg(c%p>cvZS{O&!(KpeI~cOn(w>$6te)OGF3Q-VHZ_@ImD7|4 zn*98bmU_dyD>>t~^w-bkA96K>{qpp&PcqbX|BKC%VKMMC!YCyrneRE%Lc-&VhhI|# zfWtogMOy&agU@Fb<^y-m`By$Z`jh2m+`xZYS@O#=bMn69AQIMb^D5w!u_r#?$t@Ya zng8P+PG5zGnT>HGEv>JQ<}1dp97};BvCocL10w(WnHO~*hjSaT6!5jMR=2|`yXe9j z`p<%ER6F0hj&ZoSdg9M-D+d3A#T54KpZ;Nabcs^U8^rG!nkjVp`>i;y zj<8+fUQ0)J;GAj7AJ2Z`hrB)~-JB`SNJnSHQ9bx(FD3MZDPpSnFn<=SPkTu2`j@4K z@qG;8Ft&hTN?0;psAKl@z33PIvx3J~w-u{aCG0RPN+$)<3+Y-iEwuF7y};57!$MJZ z%6!PeH&zDWgD-PhQ`d68o%^O7dp2QF(QP|-dY*To_WP%r2Y2ZDyh^mdd12gzqyNMv z(rF;7lLOIB=3cL>UC)p=-!GdE`zicD4t@#Wm{!pM<0||-3jqNE_^J?0 zQqTA2*v=-`W+jEgoHM2dTPd39jYL0N%2v; z1bY-}`t4<}l;5A$*ALd(1fSMeL{n(?vG((H7H18>^h|#qqAIdyo z%-#oJ*r-0H@BRBpr02OZ2!_bRj*v^)$fl59mu&JO`N(?L}=m<1G#e)Wb(67{lWhOo%@Rnr2!20^ET zPZkL5S%?#i-kuQUEn1ZMmRVK>!^ZhroezUpOn zRTT1%_>cAbC7*X@L@%emL0adTmAW??|IxOK&9Y_kA?m5^LpBOX=c#uqd6wo=gP>@H{$vPH9xFnF#sT}jE%t;#?Y*xCrK&vbKBkdrG*KmX1tZ%H}!@ARzp1#u)- zzr~S66Nx4&A!ai){rlS;ic+)wW)H_@WN~;6hJ63HJ7eh!=XzW2jSr*mtNR8Or5N&B z3CL^anrEF_e3~SFr{1R-IIa>0p0CdSem@%3@yFZ>)eZ3l2KSE0KYGN5+^BoN`g`M( zPFJ!_R;^pJMz_Jo$EUlk?crwg8ww}O%gTsG8K$_fl6n=bE>fFz;r(&)9_%G==s?(e zVvf*O;)?O{#pam+XE9FmDfZC>uAkAm-!c@Y$FA6!PAB|w^24J{IX|I8lCdfT_*r_7 za~MX%#df(UyTRfX#N4OhgMuq&8(ys97tUZ3a=Yw5T&)LdEQ!RO1#f^TPD0EjGdy%#TY*$LuUz zkrcdm-fKjvB#$!Ebu}~>r?Dmk4ozkh-#bx7?xxr3R*HF$DJN<3Q-EwsbYtelVOEjZ zXsZ?m5L};=$~T;C{cv4q>CzNt!LF62&G66<_by}>y>LnP>e3cL(yYUz_O;5PQPX>t z<_-bq{tmSszGs%@&k~w#OgS8TZP$B&ld;85OWL#h^LfO);77!!mxPc4roP$PSMK^>HsNGqZz-4YvEc7o_T61s#@vwh{DjI`FcW=gfoGGINe&cQkY@HCjGE@Abpy)T8zDsYkHpJQW*8 z3RR7zDwFlPmX=xbU>(S7Z<lreibdZ7hL{{9-$j%?xA!od-%mVCGc zwhDKR0x@BCuE5c3pn1}~*qt3_e&@1By=>~?E{=S~Wmb1jAyYwqu~sq_71bOwle6P7 zK6r{UGc!Xb5~8(=Rq8dFeDZbz;%e&=+;T}6^jA!%v(CSBwUOQbTFCD5&JG5R#O+4`_l~`awCa~>GrXEX!A0C25 z4`uIuPA2Q11x$JIeo}I87aqZ$nem%Oui_zJ*j+xiesWy1#LG@xxl4M5ZR-w5j9!mF zrw=4nZt41#0MifdoHmDIYmzP}z=19BgE~eMcQ1Ma57pW}W0H~O+`_E0)sim9BIWAU zz1_j7vYr;lXpYtP=J`7-GD}Fk>1{e#!X(uFWY=@bQks5)t(m0m61!zyy;YI*9j7{X zlIR&3o4{>DXn-{dvRT$?@--sP6Vb&eQ}VGvgvbPTxJ&T}m&l^Y>aux}?( zp6hwe!g+xL)kTV&uy!Ip zFD$e<&DQEnM0hWurV}!%34`wd>hSiTin-xHd;Hk*A{JXYxfZ=GcNc&_gKY#ECu8vT zydboJw~#**^Dg8*HN$X^On(19v?+M{!)+sCn@=Pu%M`tpmGZZdkgRBJ<(o2pV6gRw zeW((r_tKSF2EI30W1w1ZJr*ZDC*Fwbg&~6^hL>4#2c6LwCEM&WPPgc1%+=Dj(@Tf( z>x;U6sm?^XQ>U6{sAlcA^y0cPio`@V-rs3_se6zv*(rt3m*gO%^6{Z5uV`8<&$Myb z(&*=Di=_|5xU0d{R)cqk-6e-`RokRUowAC-Lm|YNcnj%tcZvHNo>vA5TG>zWME4_n zX>@GN)y1XO)d|57;1(|V=_j+_JFX(ak1zv5?TY9+C7_TuS1}t+iKMpw{j$lvSqSj( zDYq&Oqx7LMxvH2E3G<##3=$d@nhnl4nCO!sq&4@DpLRJDKd{Bv%%*U^Mml zxBP;@VFaCsC7GzLV(aV4Sxviswic3!w&R(=}#^7A++qcigCWBY|B_tQ`XugF7?%4J% z#8LCS%in@Uh&ybAP*LFi?kPbEfOgM|0_`ME1rV(U)$-}SNFz6z@kg`$;ecz-;X{x z^LTK2xUzD4hx2-V-4uVFn}mU&=%Tc`V**Rfew+`o)QEdguVW00h?ZRGw)ysvh?ULT z^y#i6eIZXvXPlV*eOb&(^BQ9O*1WUvhq10_rWVhioQu5XQyV@_9i%6IpwLIeQB34Mcn9{zLuU5U5+BjcLpiP?Z}ugnJ}Ao2A}R>dOG1(^TzYmRSg z_Ya6Mfi)K{wO^1uv0!#mwCn2?<$C<5Y+$E5&OagY^;-()g0{PyXkrL>=KHUQ2oU@J zZ|46`6L0U&f8C9Q+du#9uk>Fqk^dC#`faL~N1FKx<^Gqf;sujU;ZMQ0pN2^P7JR#K z&nUy{`GUzV#8H>oFFLkukAU#t;%{-4pIX3A!M9!CTEMS^X5mVdnh>YMt9j(c%9nsx zL@10zl*N*KsMbky9+1u23;QhDKgJ`*$?523X*cp*_~Dm$+!gcjxEL@Y9``RUplM3S zl`B_n;&SJ?67fNkXNqLBO%@Z8#tRE`B1rV}jeS`9aQ9Ufn6x-J%yBMSbUhI1j3;9Z zi4^UkMW=p1ZcSG5SDYUaBgRBIg|C;Lh>g3{{pcn@)*sMk6!Pk}Tldfb$!=rnYU}t~c6YhtoTwUy5 zNC5lEnMcN1a=1*8fFAfvga6=CwsrI7e9M?JFbTZ3LvYPi&pwBZ1w(Qz5J7UrI3y)6;{<_thx39%`-&sr z%BC7c0W;&9{rKfG&%fW5e|_2Qo>2;MZAw)KVYDr^U`L+PM&Ogz3t{f;-XVvA)QEO>YzfmBF_XZXJ4?&m)Y1X>mZ zzzaPYfz1KRj8wz`b+9ILU;tH;xm~(a{-Mkf|-KZlR@T32KMR?#HOj z2x%ouCZPYTVp+ewyQe1uFk==;cPRVujS+pEf296MtAWgoq|?;bZrqdUTu4Xhn`7Y2vYV+njEjDi* zIcn5FRyKMAPT&Dfuo{TowxJm#2MF`Mfee>Q@L}d~AlYv4DOJRNK3S`|q<1?e@e|ZV zNT;u|lA_ipw#%;khZgJ$4)JvcJluiQbX2L~KF#=L$%RB%Bzy`QAx{&=tiaHE`a=<9 zdMFKF1J42&cZhgc(L2g|a&^L+9BF;QAt8Pm{9CtnA>(PgYRm)59+g-5=TV43{sfv` zlF6X<+(&N{JD7R&@Fo)){NiaWh(O!^bc_~?=~(P1bUZS5JWC6-VLmDw1F#_CjumDMM z7~RM#S*0|(z_ulP%&i$%SXvj_A3_&LhG`fGMBg%_jKg<>kSK5xB|eB3EXt zW_-^_n7i;&gYaJbBO$=nw+9j<5Sx*KTZE7@2?+_Ph)1CnR(=zQ-CS#x+Fj1M@)s|5 zyuQn&=z2VQ|JXL(gd+tV8ml_i-%0J*QK!b^Ob*XD;Jp4(d8uJoy-4zr@cpY^!Oqa> z4cI2);^IKp#lrNdEpjgO)VxQ;*^Nf!6-x4(PtH8?*2-{q;oYXvP4S3F7-wN?h6dM{dIB3G&yv@jgc^e3(&*_i0>}aBed`p7iL?4+c>NEi z#klDBw8g+tx-j#a>+n$EV#Msu+W>^}n)VCG`LZVa-M)SM>eT}5s#C=rfd}>Qh}VX6 z@N#g30-k=~SE0X2Y{&cR!IO^@uGo}BWRUN#cwp0uN2TsZ9g?o)lf#~Cnt(hC#9n;3 z&vDJr@sfL!*n%Ti{DcfcIMP)@Ltn|2Rg`fxzWFdaHBefHVPi0V{cjaAscf4!>)$f? z4Ne#(A095Nf6&o*XjsPk!;WM~4l(^pxQmHcfYfERRb1o*kd-1|O*rpx;9+20W^?_7 zz;c?6BoRE{2iB{8N$ z-gSKGL6W{R=4gaJ&Bat<22OVEuFhZGCqci`&bV+WCd^_QJ=gB(qQXL>rn^C!6(`%7 zi-n(<=U-c^mekpp zaACC_dR{Z4YiX1N!=xJ`O{K3y+7J5HDP*rYBOCEd8LCP;F+cH(5oH7|xl8$hyq8ks zNN>Hue%INFb{g7-#smXdn4j>xMEaOuW;OS-4$W4J2_@YDS7)Iu0!Vc1D(YH2|#mVB5E?8(Jm19$WxJp>6xpOn;sENIc4q4G#sBam0 z$XoOUPX?7Dm>7?e#}cWDwyVgU#3mAXOod-UaHrocwh>qMcDCKIcQmN&7V&3d&n$7p z$)-0+yR&GoUZ?2l-vk6KtXi)(R%LKtj)s~nx2y{UL5ot9~&DR z9WAed#`!@t-tc)7nPz?YmByDYrM+?0_o?|UI(ge1+X3gJy(KI~q+u9-oGAr}01rsM zn@16ZTeI2#G&(t~j3F;T3PEmC8(=@Ay6d7aq_N5sKl{E%SRT}q*iysKz6dp>?>IV* z0#y02y!;Qz$#91{)*|jOn^jiIy0P@XY);&3nVFBA`&QteO=N$^MhZQVVsa9jtpOn^ z%J%X1ia_Ln?P#s4a*)lbC&fPghcErS$|@Ybd`UNN+&J9sp&%8mf>WKJA<<)UaL}xl z+jHQUn@IUiQs}5+?BYguE}gnaRldGA&RmU;e?Mw8iibB`83B9je6U_h&Z~njSlDq+ z#9X>eHv97ID{xjQaJsk6bB*A@(aK`Xkd;}9V+U7ehs=|D;>-#<#z#6$qU}3ie#0?U zgSgRkx5=HN8D$r$re7HdkW!Jwa4|OtWk1pT_w0VmMLHdFpg=G`U$1!Z;7jf;^*;_+ zmB~Mek|R;dG>*9-+$!Zf0IQg!*prC|xSXfJXY>ILzMH_<*IcIuE))0cS?7AVuAs@PJv*F?_%LZ5okJ7?V^~x- zu(HPHuNA{{y8q%_G@{i*Lqaz6cV`adc#NS&AzZpzdLWcS{VVy(0_z@vYsK^*+H-sz z$?q@brCKiHlZPA;;M4ZF7m3mL)Wk$bhJ?rUGd>@}z1Ju{dH^Cu#B(kC zNdsA3OIVg2<76nvBtvjV2<6-)$4=lac745rwJyjmlMofXHHQ*VP2lBZw`B}}riO&C zn~#547>CDl9EQR$bq;?u=o~kALSWaLk>$n7c~ct_702T}D&CE5@L?mtFo`|%(4IZ{ zsJT4La3*B~Kj5OlkU+Q{4{0YX43;o4GaLL&C?Gs%YlNG?YED0jYP-C67lsvB!0K_Qp5kNS z=~GTCNjrzl(}p>2$IrC%^r|^_*4AQn6K2PPg=tw>Vp3jWf2O^;eC5iWxe_Sro>AmJ z*2p@}AWIAf`*DVQ@Ue>w@Npz3BcEIRC4y;vy;rNkMZ8hTC9R~PlaJ(We6edMVa$DU ze{bQf)oe->9)fF59PsB|$eoSFnEljTHIUr33prPKvPeckyVxuwy_|_Ml850s)m&7A zM)B&zsqP>*rH@DC8O(d%zI{A&-J&sKiJY)e*irAWiVS21Um83`jL+6%cptC(9HDdQ z{euJ8d0jBdS3DgS6ci+WtxSge6GI4kkHV)>HwvU6D_t~f57z%Z=c4z+{!q;C&q6I#BZT;>awmR^%6lNnlh*!lk2Y!dMbc5}tuLf${OVif z(>#MNf2$UL7G3flY>H@-BO=ZKDX4pc$&yOg(cO|Q@d|-bH)LGn4`l~*sQFvF{9e+# z0%JUP<)pJ{vLb@@FeI>G?w-CVfsP#KJLQ=j$9c&NixnPBiv>LH+}VLjWOV&oxY8I_ znhPriyrlOC)~B{eF{ZHCdg!mn3x!*zzX->TUey+HD=Y*W=9TAz8%E#apU^7zPE4iKnEHr zjqBD}STv?}oVx(N9bg1@T}v^T2h2aW#2*_zLoFAIQ7z2jP{xSufQ$?ZM$RJjn>4KQ zhYr0`|M1LlEtlZk2M_F!jwZ;Ba%v0@wXCeHU>OG{OeJNnf@GBSWvB%itOlUjE9~o< z@><-!s>2Z_d1OmVY5&Ob_-CQM@rv;W5uteS&K?V)0L(`l2P8Lm8eg1zdE#i-Kz!4Z zmSWp|vBYuL5g*+AJ8TzTO&r{z_~I(hAd8@-Q=5tNIeMy;UtODCHB%F*qTJ4b(Rz?(qvS4J5XyeCxg_{gj!jy**8^hT6)C~|(DOs~vqcXVrMD{B zWLshKV_;qA>ZWjA=@^OB1(s4kyOia@?Y|N&d(^Xkoqv4yt29pNT0&7VjRyf!^6^-Q z8Dn57h(F%AWQm!!uc-N3oLu*Pe9qi&#zBA&!Q`-SLgIFZ?Nc0-|48Tl1T+&lP@lcH zx{e_{P1}BwanY4M`B#2eJoGW@gcK1~u@#hug|1l8co;uVPSmYG@#jU_#DfTGD-~eWgp2WSix&Ok6`Eht7vjU`7sTK<8P%dF7`D#;qvphA zK#5n}e)x_)JpWG_gHz&H4rN#kFwqI$a11}HP`Ru61ImpD6?sMT-!T72+)rOly!mg> z&p%*5@+awX)l_#Bv$Z-nh#rz?)BE=AC-93u(Hp*lzY>nj#J{>!9 z%mv3VX-92iG4p2gIb+tvqJJYBS;$rXuKsOODsx4gvPsc0SRp)Ko#-*wBJY;i5n!p| zKpEbA?z!6!f5$ZcG|>4x_4+zFCIq=Ze2cpruw#_Y z6aF6J|6!Vd_+Q}^P$?XoyC0gm;IT_~H{~J~%`eVp8DGf2yIx3YeH{3WO(wN*j{-&C zW{0i|jh<(c?2#kM;k^n#?g(+7X6H}uwUDhtL}wxl)sy*(pj-t*74$oJ>l;#h+{hTP zzi>^uUu$3>-KH$rsI0=Y>ynwu*h<2Y7OH=~VOWw`BCav(ktPla@WRV$hCp2sK@{~b znjO&-{8yx{|7j*kJb2x@ig?(Yp5nbD4JUh&luMOf1RZSYlZ|YGEnJf6HhrnZihEF? zROMXm{b8|<+=|Onkb>2Em??&4XOjAu+6$3G?F%98hvqs1a6-vLzue#D3_6FegN=z6 zbjTXeDx>N{nh^BXR+uUP1LW5$JVOl>P)3UdQ*~6%z`2xMVA+63M%1wIw)NJFMNM;~ ziAmVRN9X`_pag{tTKFy*oIe(dYGv|gJYD?G;bMYvT5EUUzzuKjdO*q}N^$|a$j!~o zzFmszS8%UacKHhq>q$KF_ zU3e}7#m;wuGL{RB4`&WCntGDupckP5Cj>jd?Zs?GT<)Vtp%5#RoM0=!Bre78ViUVu20g5qPfWGdjfn1T3 zx4>E{Dw5rl&;Tq`c?!5%hk=PnR2h)|YzSJB{#cuc1hN`1vC$-ebPGE7hXvdHa{4bN z&71Lyi#%TE`ZTw@O`)fm(GoaOsFSvbIg$G3Gre6ZUET4fYNcQw)t_VHYsl`{>!($A zcCbw=!UODWq(GDxO-RLUVv(>+V=CSn>bSP`J;aGNHXkJeIBmx$ciA{#^AU%H$X6)J z_rF~cn1J~U86`Fxfl~nW!FxKw9Q98lu z?nw^yUvr#O>2u7Ts|m06V3!q#uEBKX#&x(3r0>k`pRwdtABUQl-!2+}`Q^6Fl0j2Mp=Q-*Ljm zd?Xq&d?-;HGYi`zRrdtkXc$_|1A7AQE1`ZdfKCpW;W-v-oSB)Cu%ukVe=n!yLdz** z4EQ;iXP~X^&b@oVYW6VBG4$P`^ZT0~OhG&fk--%8yX_eYx`@kh7<%};z86L03;}Ps z2R19FWH-(gFU`)%ih*G=MxkhidAO&<(%oj)_H9aEFynkUh%xwIRIVn9xv}Rj7hLHR z1x6K##}^db+G!vDb4syV`)|vMiPO>ie1;KXY$#J;^KhpS#3L4#PHo$01*j9pn6))> zEDmk}J4|ZY3^RbHxebYLrmwFz^cA?+;k|m;jisp$gei|X_fzG= znnH_9zw=61KYsL_abYvKz2l>%Th5tI*-wI4i2=Yv`b2J(sD?Y6vg>2+qxmw1K}G$n z)w8VSkb2wCXf-5FR_DgB3Z@$uya(}EKevjiU2WgPkvN^bfh!s5qg&&Sl31*R9S^>Y zJor&D=E0Q9{dlfyj^>=g-(&cKh{S5zY>CIXqZl&R4mLBj z8|VB~dK0&lqNQs&DN#@0CE_C2>nicW4r?VYz z{+cN9S)cH0|1ZCO0WF{YkeA#qrGvvN=G^)?W)5o?vgD+Gsd}nH$#e(jrtRC=m0inA zBZr9m@|~o;F*LL@t${L96B`?9lao@OK781MyLO^FWMzzoWYh+$0mnOu7ym#$*0(FU zgd5hBIbclAcUK7Q`uMV8p2*26mZ9u5X*9#prTo*yhqr3tly${$M zXYYei&>NeZkiZ%V)4h|NyKh%7!{l##aPXkKycX=BvoJf^Tq~tlxPl=Q_;+bW!dpOH zID%VkdU;1zoJcn<$pA##TZSr$g#qHm@ZL~W|6019fe=b z$7DR<7R*aZIqQ&4PaSRxJ%1OU&$gy;jdWcob5>q8mzQVPe-2-YYA=m!l55fnU68$% ztMN>pADMs56ggvNsDuFlR@Y_wv#7%A9(!Zl(d!I?jY;h{&B(Flo7A$W#vFo(TeOX@ z{<2tQ8424LP7lH2m09@$ziz@$CQ zenRS*wRqlgPv;d39HS}G9*m%OzogR4y*E~fp*%qC&011eTH1@l*vJ>Gw_LsJ z{QNxz5V8aXwIcwsrW8mw1`@`{QZT23r#oF`;q&JPkhj3Hvcp1SiG%|3j1B7*p>ez9qg7`)$8{Q}ZahtE zYs&$%#M$Jq7k^eQ`7OKR$Z%kNz3h+T_vcG8KVr?aXuq_niVc{NFx@sFfu4@-`AC8#ncJ_@@(V)%~qESdwc zgx#&-3s-1QmGz^h;*#}dGYmDLG^U=5O_pt+XFCV~E!$aU`_MDW#4y!gbB_M9{|8=R z?z+~0#t-?RrcEW4vCqM|#n4pS;w`FnWa%~FB2;YYJA9-`HQA{1(Ozv8>a3xXVN^*U z2Rg3`Em{>I^9{!G@f0mQ2HS`B3KKz(a-! zicrVE>Ik%CYSoa9Gy8n?x0fnaRp=M4T0TJZ zi2tOw{)>Us*M{7&*r&NLmL7f|7(qOO%m7}REK>>8BXdj%f6n3 zxWvTjYK7E8lkN1$zmD|Z^4l3HE>5RC^u7k=3(P;rG_gE_hC>nwx{yNMV4NO~4Ki)q zrS@nKc`b+4i_&Y)@Ke+xW&FLk-)*1ar)b5f3sM5)z!vX-+l|-wCr1gG#Y4L?Jh+X| zmavcLw?FN;Trji3e4c=PFmOPsh#+9Aj|w$iy(ugLB}Fnc1%#_a`dQ&`oa+;fZg(S} z&B4|qa>)&v0Y1H8$;MiMpA%74c!p09S5sT|aGXAIH9I9pp;j>rTM0eviw4^G+gY^I zO9we<{((3|G&YMgO}I!@rzB9r7GHo>%5Cp4^#FZh)v3m?RJ`)J%iyrpP!(dS(V^+< zK27f(D&g{R|3iME2T#yh&eIkp)pciE#Lc%`r}{2|gzCaf;Rkr6tdMvhP20s`?tW+e z#g1+jvZ`z9_Tc^_nU`WE1o)y)g)+6@cU!|V5M8{O2i6{fXAWfoMR$*HUjXf_Q~ttP z%OB`nwDr|(gCa?sLHZBk6>+sU?Y&{<%T+_{`2R%+{|97=zqlbj zs31S2X|^U*A$HFzg?;2UAxp}M;dhN-Y~NhL@YpI>e0X4wPWp?riR}xMp8u7EFn^*T z&V9+Y1oh(oB8ZpWfA7%e1m^p^pD!QC zzHlO^a{vGUqWs<~;mcC{2e1?0!n*kAHz?sRNWe`d#loXg;`Jf~0reJ;Vb(1w)9ds8 z(HiK4FH)+ZV*0;)>_3w~{s-6niw(>|v~KyG{^r1y)YRGDh7*IE#?!7p79l_K0Br=? zZ%<=3Z~Aqc($6@oX!|>JD1g47j1mMmKcVku&mobW`{k@#Ntt;0vkPw3!NqJ>uU_Sm zYy1#?MSAnLJrvSynOi*;_`xQ z7|hJT$lT}+P$wRZv>h_4PXa*>wYmO4+93zpC158IUZa+MtM=1EZ2kq+H`HVFM*>;@ zt%#D~VHrQpW(bWwp#y=jEe2~=FcE~#g-FYllXIR|I1)nj{se%6KP+AvW^Kr)7~(uu z2U4m28!*0%)N_E5Xef78_(y6LV%o)pStbUI_xbe>96fpzW)2v+g^q2WTDfAyh4be< zl)d=0x4VG-#(OfM1Mpe$N??K~S|rWdu4wTRg7@txp3P`~TsSG{fSukcgB1gBzcz@w zYuBAMW^bw)=)HdV9FXCl3#r@>H$Djop=&!?oouWs zA|i58RcyB~mi8zeubMuIL^7aiTj6p3#>hZxE;xucc+s)Kem8-wk96@QndXwRo24f$ z7@QA0FE8GOON8g5bQ(<-yv0_WJA*_{u!M(oNP#kQ8-HJrY-y46&ZD59VCkJuyX zE#sm@MTcbHkX7BYqN38f)r3t$A*i8;^dL`FdHS4!xB)%8m=z2O2n(xp!F5*) zT_(`0o?7=mqN_63auW}3=lT1w)K@pNpf3uNCgOlxo-{W;^0EPLr0_b-JOXM^u9_^Q zpXexeki7Nk#SX`T-VCD!{Vq6iWn46dt%aX=V6Knm?v>AAw$OP(K&HHa3LpPK?b~AKi^3;iT>wN_tsF*lVMp%E7=);c%>9LF>s*7x z+QAJKvkoF_95==*KU6hCv`KO6gQwaBO_&s$wt>J`~&NCEfd1;vQfRz!j#Fj z=fXXc6#JRR1a#q%cDe6MM=lg@_O5%l`-+L(yBOt&{o-5I;V*mIo?Mq;(7wxhSBV#I zvbcq7`I@MyhaVZ%3;~Vvr=}Yj8|I#!%%@SFN*@kc#jHlhrSvPjaDLzZY#^>RARV1u zLh|eM=Kd{3My+b&yUP6wwO?~SaalPNI~FEQ%@|SjN^j{&)~6SHrH$cnnQ7ba&VHL& zI$o^3GK1Q7Fp-3*iN!W>u#H>NK%z6$$h!1l=H_@+10u?HcY%>>a`v!_-TNor1h*;d z=p#g;Je}qypK@Ho4sg~_+F=%A77exS8fk+yxePmv?y33sFsq*0^6pvFq8kfqG>dOG zYghn-d~#dYE+~@IbYz8<%C?8H8ua=!gJOv=U>VYOj($Zqij!peekseIb-^v_5zkZP z{aquD1zGggm0K3=n;o-t{#a68o~#_Xb#){OdylLsN2iv?uX$^SY6}PGO=oq?%l(v- zeEfwn($X*+)oK1%iSAe2yy}kUYC$-vHiW%WtlTwx!A4x~uIzmw>#$U-+20n=^|w@L zMq0eHyw86=3J$nO#7;)4)WXxWpPZ>eH#o{`l=xGxRG58NiKpyXn%(|OiKNly=JVQ9 z!)8OxC&D9*YM0+N?uv1Jz$U05by9QeaXoRPZVB|=y0d5Lite+s(fcc_U%!X{LGbkH zKvT2cG4s)DyNnraWR41JC7pR=Ka&w4wKm&uSoM(VDydUt+s~gqa{Rcvx3}u4QxC26 zV15p=kA}wUnVa;92+wqfLl7V$)3b-Og;YqOlpCMizg?zL75)HKRj^PwIfDV~Sm_~! zGS?=K*^15NGpRp(m&xAo%|7jv5MhBwd|lutZipUp;*?GC1$ft#I!@8qug1)Qoi%W? zAjx%RIJO`lz`7=}yev_-j?cyPby|O)1c$zT{#WX zyZvcptfFaJ1GSM|myga+TC%VDN!xWuoV2R#Axl_AyEAagBv<-L%1aeeP6pKnAZ$5a z*KO(}oo8*JT|&m;A9}Kd>SpDqM&1vV2`az>ytAZsuh9>ZjKXdYnWEOPI~`)hIwJLZ zCeZZGk%fWV(bIc#Du!slCI+)|cvz0q_oue_rjwZ;Xo_|!Z9CdY+J&}ucY9jxMJe5FO>OPc`aQ2W69ulM`)dcK|`Z<}isT8nunj~za*S@{Uq$UMD`KMKWpBY&#LsIsDk zjzy>#yHk&*q^7b@o5`gavmJM`3NasD!I4>|+z}@M!IqE3ex70v-;s*k^5bF7Pek>5 zYO+eyi%Jd}^B7(T^;haw&Zg&3s+SP1E$g;7D$*&e+!;5u?^-*}?sIxZEt_DvbS>Xr zD@88B_Np8mXL%}?w9L?;xPcb%{^O3Dp7JD{H0*yNpkBIRd{x`T= z*oD2wruDMLYQ1s=ciyBznz<=>^{Q1*Bi%|o>g?&bKjcCvky3KQ+&uhrzSx;F?_i42 zH^Z;aBtQ@y;XH%+-7~oyhY9}1WYj2ouXQ(MS%ZR?{Kx#c*Ky?>-pbTg<;^75Fr?o1 z)CjeAc(yk_TW*)-*VgJ5tzFZGv0y@p&%P_Go(i;`<_I+U9HQHLLpZ`KsQQhDeJmZR zW<$a;^UrlQm*2!c@SZA>LBUiA9C4RoZOE1Puao+GVs3cVrH@lbzPT#5#LRL}UkI~C zWw-wOnkV^1&pAR~j4bq*aB&LWyxOeC(_Aycx7*9Kw5KoLdPc{WUx;Hx(4j#@mDRk% z08^uyO=-0sZr9~E^+l;3b)Z>NELZ?l63i){Cy9xQ7U0ZA21L}t?zjgSi2I_-2V*Qw zBx>Ef+C@Ls(9QY3tRbzOZpPE}FX)XJ2bZ{y5ZjfY&h+J2qcvR>(lr3bN1OsFMvlti zD_!~UIjkqxjVfy~+LGvEkGjr0-ZJ_Wb)BI^wYZq@@UDt$LP2D@F3@zBG1MzPF&(X| z=Zenm#<^1&HFYdVv^BG4EW7w(?ut$FGlgUZHqm!ocZNvV2`5IPT~}c5J=|%Vl`P4# zE#pzP~>~45{ZOFaLQ(_Tq}H z$Wi5bfAObGcVnXJ(Wy+oa;G?aQwf_Hru&pDt&UnoTucgfl33ldGZMiK^asAoJd(k^ zgS8ym6Df(C+%s3Jhn&+*1u7;#o(eWMYje^5I^j;w73f4m;#Qi*lQYt^=ytE|2-(Ng}N%W$hz?rV(8+9P{8j9FdGK&+fSui`XGa!R zM)+Pkds~qKj=$$a#1oziQx)1STzW%OqK#iq&obfax(ah)FcZwayjwKU(>5$OR6D61 z;>O}GAyHIv#LA0*s_U!EaR)!9A&-T>h0;U4x4*= z-xzV%3iVJB7b@U^i@evl-fUliq&oH9VvAIxiLrZQn>BTMk{VQccg$pjg@3e4H5h(J zF;d*N!`mS%xm zxCHUWh^UmAlUXF&l#LOzeI|uZNJvQOCgn|jvGz%BkzeyA5B$yZK$7r0_`&|_Ia<{F zY{cI~p}O4OQw3JaH*IXzkt8KZ-Wa8#;}wOFL%6p9%B!i-2E*`|N)l_gl4Jh)I0i9u z3nk%ZdY17!Fyk8uhtQP?Gr&7Gts<4Tf%RVb>?q~BL|5yR)%_o-g-`Gd{PX<-6fs82 z==yMOgBi0E-Hm&>6Bl@8-A-g#|9#bOdOo=J0E5U`PLU)565)JZiuJ$vtZO`BHkmKdTpl!-9mY zzd&`bJj591qHJ%TXoWU>Ov$_qm)FB8H)BJz?T~z~e7S9q}F> zn}4ExBx=g~MSFhXAhw7hufMNk6`y7xjSJTD5{tv0W)5-fZ=^z>Sr617&@UbhdqaXMdUIQd8yJam39Nrv z?6>Z4dWy{zB;RKv11-ZG9-geL?rqzl!L%ZM`K4db4a%QR@d1R{AaSRj+C7_PgU-Fh z2mY8t5XEbfeor+`ebrGFYbjH;gE7Qw!+xFX!<|x#gnp@^$N>I{9|ChC%euz9_Z*T< zX4bk&o^H-vX$rygiR$@y@7Wg+|8Vxj&7f4_^87rDHRU|{Sxs&D-;K~`vevFwQo@7{?~8bROAwJZ{~$d*RDr$DF7Dq7LsV15wjGUk!N-1 z_U-hH3^g~x=~D%4OuvJsP}asTr{}wVBC{^bI!loa<~@(ug8~EfzJ0H@|M-55hhvJ*(zIo%}ARQjCv*pZR$4_}{#2NK!w_e&s*tS0K{kb)&~ zss8>-h<`#!X(F_5o`#OU_`rL0V;M-ODcrhGn9I~neV|Q$Ar0eM-SqyPsSlKm z<6pnR6kn_j{y?owP0G`U(m-Q?41mnLuimVS5S4wuH68!_6=t_g;!(TFj@IthJ`@OO z)6FJ&=w-czy!M)2(bMxU*LYsMQE1slMu+`6(^_{ueEt6D7>{f9uVxhq=2U5zYA~Vd z3-+-{<}dC9+>zAxHlzQ3MpCZaDmci77z4W~-UtHkE(i3xqYR2g>;x<)V!!^fA;As} zb%(n=tYirhvjyB{09?RRHbS}(-mFX4?rQAqRSY|~bK1#iZW(=uX3j8i{{cr^^7w@N zlUx0-C@B)2aA#>5LLZ;=R%oOvGU3|jRnJX$0{tMqA*aS#m}a&6>&nG6Hbk>y?Vf5g z>wW2=(8=8+US(dX~i%h-U3i?rzh5u0{H5Ejv)gvL0X_HRQ0G>c26fDF2DHnKkU<*918?%Kb6&?VVFQ+I z_-MsaSXxK}T}3XnrDxy!fLv0kAPYALv$d1Dj+=O&KS6#pv5n*}oPV?C+czTqnaB5M z0fLe8A`ws^l62i+c0$Ygxu;!va_}C*ixCvYU-w$Xd-?MS1fq$(nu+FbyU2>q)d|`V zz)AQzK5`1kUAE!im;;(-WMg**7b}sMg`+dv0$Y2abwTHX3~t>riub7VR7yJGEjAOKB>w!^>ZD2m3B!2-e(>7S&;Bc7wWW%5e2aeZm!K&Hrie{RSYT?J4eY!_m zl=W!&lU-+<@bHcgwi9M8L9GyKN=$iUOANaQGsC%^v@9Z`^!EI{UhEt-iqfrI1Q|F| zW;<(=3J2DGD)y={F)6j|DScC>n4Vnv`F&rg8fI9H?b7lW>$9_iM4VQ1RazTQ<(wV= z+}2k8Ldx}l6bT<=-Flf^bs6olmS^?#vg?<~crOFd0xoArdiaXCiu4RKt`Z7u;DH|{g*^wjW6EFW)4i=97T z0usHg2F0}%E{3XY`Ap%3ibK`hw4_rhv>Mf`x87T}{$1VVMLWNclybPxog6O}tZA(5 zY3^KNTFLX_b)}zLGdA+xkI`Kn-0uPUx?OK=q{!(WLd0a?4#I)><)OhG#LmLL12Tq* zl^p6O9c4Q)3j%gjQ~TIVGor`>RY#nyyk2}XvKWGbKmm^Xic_)Mf5S?8IDFpTwqs+@ zzigieJgy6B-=15tZzW3h+~MNto3I)HD0FrDi%Vb2;wU+R8ml69G|l6k;KgNFw%;w1 z@L1p7;YnQKuS^U>*rReo@_bvW=2N7?Zd*CKfR0%`Nk!vsk(ke3)iljk+(<6##zwOY z>FDY4kDorhnJ_nPC6$l+rd`M{@=2jSKM_H0Zc!=n+XqPF0eKzENOH99S=lLE+VHhc z>rbfw-jMKTCoom4evm8!Y2J}8mm3yjB+o_LXzsi%ktKqc{=bCVH2wbjYpf@FU^bfP z$M{y zdsjNi?7KE|%ZP_`txX^)OVVVtcA%fM&^5tmSnIQCeJuBL>_2g$-aMt#elbj4%Em`v zF#u2fYs{GG!Uf2ruU<+Cl)>ZhUr4;br(z5N%ozp@lv_lbdU_&xc5)v+e0X9MBE3Ej z1xRaP|HN`WR1dMI63*0DT2T+fPMU{jnEE6j=yPU{cxw82} zx!?JueVu&|>L*JX^CyA50mX_h5z)QK$ZePD^P-y8LQq)H%lO#m1dZOHSmU_aD+d4E zG^5_h^b@WNiv86!wBI;ttWEbl)5H{RBdQ@7SwmZ! zM^Dn>fN@hl5=X(UHG0yE+^I752F!EaXY1#UGynX6{$uH>z@ZM(-#yETk2~e7YXU?l zp^PJTc5_$8;RO_3n+_yTXN)SkzxmpTdgD?hcPR`k3rC^QN9n92qK~ z56@7S;~B;ioM{*tVRmw^e4L8EjGDyVXX?eDVKi~$%o%EqXp7F%ab`SPW|>yapMhqU z0;FnnXO-`0fZ|pITYQ2B{>E$hfc*4`&tu-Jqbv#$I{OCa2a6H}b zk+dskW#dsndhnxL08No&o?JWYYUSIlc{;uWbJ44c31E&4pQq^;gV=jW zy_2`@bio%Yw4P5610Hbps&tcf6{NSf^&J5#+rmuQxJ^K!RD34YD)4MTi0#_lHzwbz z1Bw)2Qs9+|^6_VF`}AqL*3f}{I<;%Qim~{ON*Sh}vZ5+|qO@0~_%|4Us9xS>qlb>k zQ7>ZeD0sDTzjda!!9aIPPrivtaaO8j``gyHmUO3e)XV^yIh#5Ajdz_XHXp9(<1~3R zYmv$%D`TGHU0hN)Wd7Rkl)LtjQuNeTaT`YWE%$ACH~mt0pm14x`4$cC<^S8u ze-GN0;M7B`4dVnSfBV5}@%9P`Y=>oCSX&QMPjb56!sBu8b^bG0b?Z*Ptc3TCAwP#t zJ0vFbUfXyb7&nx^VejA?u2&6t0lVEELKEtpFdrPBk=eWIq0xOlN__e>w`OkZJ(fL> z9E>-<{Dt(i;%Cy^aUv1#z|OzpEVDf|2#lU8zOj;lp7G5Cuh*^5Kc4o_eLpY}-r1m; zKlxL=S^$T*#}2PtV#>j)70)dZaHQVIfPzNy#EA#o{`;_r#e!EDAE*p%6e(f`lL z9lsk?S*ymKlWAGwv0!wx`heP^941!-{c_O5;#Y~EW5@ap zp(Ok>+YbT_{tZybTioyw?^~N@jR2qBHNi`$?=RapBF^V(T)Xaz$RENdO3H}E5wNi4 z=C-@vjAp-m*G9@OcLdt|iTEr0BK%Fo#EyHn1g4pGLFU`H1DKq{f_b_1b4Fl;s78Li zco7)TStgHE%4fu&)@M!qIT@PQ{sUJA0_|ZBH=~mR<&J@y=K%vI-r(CWAId+W$yFp3 zWiG8E_Hb8Y_#dL`!pQm>T*WYl<4{ZwwcH2GwM*Q{Zrh{$_Q9o#d2(@I@DwE&!FgU^mKJ&00s7oPp021V?} zfeOJKYvH1dW`A&a80?$R$Y{bOp|81_nwmNwb9i)=13BLxtz}ZLYl0s5Aw3>yA*G2< zm+q(~9*9S6CA=8<*4aVD?iaW?8F33i+>LoD^Dt%|zf3&T25)NcfruL!^fNe0LD!yoNjNmD(-O6i7JbuTi66Xsqezm6l%gv*W-y;wp z!!BtCWd8SO2Y37Q)Rki`UMZD5hHc``QNgu#r%I1=#mBq}>8xPMm@-~D(JI7hv@&i= z$+`ylpSlm%WTU5?PPP;tDa?PjS99Q9W20b5=`rv9R_hT~L}J_Sky57RcO6SeTd0X$AG(axiAgi~5*gfY4kj-%m{w9e3Ymb4CyH9JZ<=rz& zUmo=k>FGD;G%|~#>cZ7TXGVmS#x74!ngaPMI=7J~qu_c`Nkdlr`KiBRP$7nWIq+=C z5a7XQgS6zK4dg^#`=gYy6gL3ovlQCLOS^u3@)kEtdA(*)7%YyCnLV0iJ0J{tf6Ir+ z#QUE%874}QD)@Lcn1tP*AsZ>Mzq@;9`N=r3a7oEKi{=ZM8;i{t10a;@xO%}Z?z5XE zuW`f+K;GdA_8VvFRl+=SyIB*R&oarbCQ$)MD&hB*yz;pb(uGNo40eBSAlITb*u%XMfMraT4iRsUW#9jX9$px<=C*rJ5 zgR{nZKJ=!TFW*9i2My1vVOA?>R`m4Mod$Gl{m6^bsh)J3@_3&*?2llKk97hj`50gO zS4C*=xL#|1b=sXI1j+Kda&C!=7wh;;tP~4veaF=<7CvzpZ0X;1G4TV&=p(c|{;JKt zpiOZpzFFbxr%G(aX_;Mn6;l5M$td4Id&zXD86GW+DC~jK5fsfN57&gM8EEev@hULZ(trQ z+*JmF;NB}|I0nTX{r4mT$m5lXBf6>xwd#%QG{-+M+9~elotiKq(Vy3p8y@AT14C_X zrr}5CifuK^mPMecjYztbVWKaUWu>i&*vo=Z@5~R(fB@4>`brj3nVs6|&oTLK+VmMn zPB((GtqnAKkHi{vUFhFKXa{nj6BKPG6z)Q{91g7`OR&|~Vm|5k{j9u8~kCRdXFa~e(T57>nsMv{REOSRB|s6ty^oUQq|?H zgVp{*WV&@DmR=Gx8D$&Kcf>MJ06GU(%}Vx=U~g>#Gw?$??p!=%#cVQtmQ8_MK{24` zO^rpVW-Qp40hIVMDd-ZMpiu>G`m7MK4DhH-J>S9pd; zT3jnka*tIP`SgHFmw0f7bdp9_ur8MSh&ln`)x{f(+v<4=>FH(EzplKM`1C2`)%rH$ z4_uIHg;!cm4ZDlF4P==0FnP{sy;7BJ`|1#2wn*InA^d7(xzRNH9zEn-8zmbtGyqG@0KR6+GSzXY4GvK>(eH^#$QjMx4`q5c_vnKX7vTcwvV+ zW#jod6UoMdf3{aUsX5bv3I*MykPv^|(wZyC|p8rUXl7`DV$<4cz>XBA7OYxG_z07}$$Gaw0CRiyeD&d;Y zv$iamy;9k)yVqZ-KNtgu6<`Ak_#;gIj)^39;_5Mr;zDXDz!XxMdAqPnKQzVn{}cGmY({d)}jKl_hT5;{Z{>rM2dEcD+W)(sdcx zwgT*@ymGta+3QX^79#~L&xK-WSzx(XWp?)(YHCnTTa>z@F=2!5UtY3*XlU8;<=8x; zz7{kz%y4qU+&w;_j1JwV$|72sn-~ZFS)k3E_p?M(-KI{Pq3szF_qi~vv-x&uNS;W! z&hijxA8VtfyI7xx4*(WvLX zY>Ey^NlwPGrC6Wt*SRm*?EAuM%C(mC|;(6~KC|5*Ten5^c4K;fYbQe`nlq>sQW>!eO+kFLa zFepnXVZ-B;QT|-}Xhp2D2JOisBP^C)EOn zt=;-P;p}@v#Z888UMKJ(8ZU8uJ;yYME%K$Cm6sZ59Vl+FLJ}V4$wz@ee=z=V!pG3F zrj0LW?3SPQrhl|QI>a~rOqtuA)`D@Y9vsOaUv2N{*KFH34k|5hz&Kj#nKDd`-p47U z(%i2trzBX=3FJx!7?|(9Vx~cdF6~?kPtbrD{ZaMcUI(3X7$}2f$^49E(~3i8LDE)w zUuL3DBsMln9!sozE__s0#*Q2$;ycduldiT>OEUVY+fM7MfrR3tj6o-3&A7_BnTIUC zpCOuZZm%oM%{kuo$&3kC;r^>xsl64G6%P8WrGtx%+wHx7<>Q6v8G}y#dt{6if^4&F zb1T9mBf)!&Q@*u8v09R1cv)bsSTO8882~@mK{pyk`{*LBB-+U5yoO93l$5#+y!yQQN_-y^X3FYG?TJhc z4pI!T9yym{Fiy$)bfwyPnIUEtM_*qyneM4?%rpUO0H{|ZUWB{@-CL97YPN{pmJW|& zPrnhfLI_GZRyzJ^v*(NRS6cl``->o)zmUQPw-D4SA68{!Sx%tAU7(>hYX-zZ`5abLl2WAcc-UVQN=Y_b)5+cVxE0-Q|86*M!C{U3${n1d?l<9p=+2HPd@l z+NuyGxqgRwh@U!Usp(K_VJ?#b+finzw)XZ>cqcnuT=?y)-T0TU_M6Tg%>%V$i5Kg% zYt7`5t%JH*Q^v690`u#5nIoa-8#tN*fQwTuX8Eooi@!y|Q2t17F{J;&Hi!1^?c)Fy z5lO&xIF2<=Yq2-&GH#CO_c3|b7h%8#exy1SBtDl?MV5^NISN|g?_$>y@lC`%c{9gN@xOr@|65Ae-)>esq3xNL_(u=PoN{yg-M-zoMoOgaIDu^Q_lFjjxkUdq!?F3cK2Y@VAE)|hlmD%C z|LLIiyQ}vG5uW|2F@48|p4U;uz z=P!*Kr!gtOXdnD@7_{;stP52DoS)yq2w4|)9Z+M|3^RbRQVpMPq;G>t@G+Cmd?bRk zHqAu$Tl#j_@f$Y|NS`O#bHeKIKM)K5z6zU*IMZTcR*&}jD=TwV1B-kIe`F$RdF2fv zqCBUj2CS>{P8C=d&gC{?I6H^igiV5B^NsWW7dj<==#K4!rCE+(*Alh6r{Fc{AX`54 zLLqP3{PGq>5GRBlf}H$^RzKQo`Ogn1_N(c8`Kr(7I0f$4$_EijZSX9kdah~}V3CQB z4psPeAfl=FMj$xD*QXlBZ2NQ}LCM&Qu!sq(s|M_Q_UIjkp9%Xur6TnrRD@>bGndN( zPx7*>=k`$l7Ykr^?GwNP6A;!OwcTSi519``L z6D`=gbGJjx%4dJTbz)y8zLc2s%)v@H>LZ=UenlTrQwqWaenkWL8&0YG!s3ZR88G`M zvzs*?FODnCk3h2Q8GAsWBb1616vZ2%`-EpA?nN&(K0`>>oc5IJ&qo_E^2!j65yZGh zigarpjpa_i5y>oUbHu@(vhQlXQ;l?O^7vo?bRiwlT}(I+Jv}@;o~;)AujvRb7@5u8 zaPIyii?p;YKnuL546~r5hF+Hn-WNiTR@g6}(uJN!E=h;Spk?0RrkcR~qj&C1Tq(y8 z4P8ZHy0Et@o9qqpfCQl9dOpUUn$s-Y)&5}&4iDtHKekDCtme|_{ew<;_h?fb+k=rV z-Lz9~18irXdqnHLXGn_9OWmxHF;af_;VZ-!9f2~L0dYd=?q+(;il(h@ zFcMV%9I<5O%F%%VgVWjN<=lJsf*q39$%4qL+@i&c7r(0%)hN=*v8R(iJ03v6s}M)= z&!eQ51PT1soh4LM0l!=7#^;NAk9Ds^Jv{!E29R4{=vfMoBnJC;$MG|s1N~AdRf~L1 zAuUm={85nqP-n$S7<~f!Oo+DPod_WI6b_QWC>x~9p~SkrGG zY*K%)0h*l_KV6)EJo%p|akJ#*-!O2~K$wR~U<9C;o@ZB}Ug#fWQ4A5^w@#9DqQp}I zSSYl?5vGN2Y{{My%QwKs6Q9?-D^fa0MK;47?sIuAdr!17 zfacD*zt{#ml#5&S1jEXeCSVj0?1h1Fr^n9VWyneoK@kMF?Q@4`2oyokK0!IedN)rU zxj$?$=byzC#WXa!`8Nq&)H!#*qA`_8nkGS#Um&u7|3}>VV-a46MvBCBq^X$!^0!(LkM-bjS?LWL z#q=SM4C5*_s2B_5RXdnKqEY3*Jqy(Yv%lvJ5OS~cRh`Jz)2~<9`6^BfGId-8xV`OTk-}zP5p_SvD$Oz? zSlf^@m2j;_cP8n~hjr}oF*iSa`>O#6YtThq) z0>EKgI1HHP!jX18)(|Rc8D9IaW-tfr%Rqgt&(=}~QO6!C$DQ_sh~6DX>-7$db`sA? z0!gd3CtGHyrb7FMD-B_sEB)88wVoh5_*-v&(i^6c?U_Ya`4y1iIs(fy-U}=fGT4Mw z&l$-dzkHg?NFN9yagS^+fWLS2hX~p1bk}NelU_MBdR3o&<~|k#qQ}N)dtOM%dJ61P zi)h7(ll;2?$Rr4!JEsY3Mo!`zvUyfEA0sIQx;^&X%)ecg^s6*>`mnNbrsI7UX6x%) zME+g7_3em-+@??+>`l4Gx!kr3L2SDH{pd_1wkw0$w)&GwPUf}x&~w+6*rpHIDQ+<5 z)%VBM04N3moeZiaU{y5c9(<7gBJTVutEiw0-NtTRQbFj*=J2JWMXp*-A7^4 zvdkza_$WGR?RDhG*VX$nbwA{K2wZDvwsqrXrNK^ct*2Tdbex0cbb=!p%I(;_QT865 z?>&4?5yV7^Da)6(NEKn*wUdz3$&J1}PAK96lkBeNbZLV|viRE@rpWth3bt`QW4t@2?vbI)UB1gOUIcgU$C$$@< zc{@s99owgX@~F3>oK)5Teq7VGT5+@FLWv(%p?-%of%B<_TZ|X z(coH5vcozzPMr%uKCsW}Uc=twrm$a^J{0uR(i_g5^78UI4%QsHiW0nh)wAR`kM}0o zYksY*ww(G?HG_1}E)NAfi9mMU^)z*z=r!0f6r;J4^+z{3>zE2BJ57VUX4$E z)I{uRryj_a`I7ZB5C(!+$0fA)N6L>0BZJXYJE!}CNQuix-af;CBsSN33JMApr{u~T zJjLF2!#0fZ;*&apf#&$JT!QjE_L2?Uh-A^k$x_Dtrg6yg3h%iF-LG5+k|oX$l?^#j z%7$M$tSj4?@NqgoVB6V|i(%(d`gp9iW;|k>1n&)Z@)xDhra8CPk&N)lau5hH0N8!z zc8i?#T>{hB$E*h`8ei##I$`AV*dX55%cLfL`*ShRM>;xDox87_ zts^#vA^F7Jmg|32fDX99M4+E~QDLgoi!qH*ZnG62US0^lAmv@H#`jIi>2^rA8yHQc z9U?uX3=#4I_2U2@yuiV$l3dhlKODnh&23rQ9jlcuHln zxpvWEPJRMkRSh6etS@(F{q1k=KiKH}R}mbgN@&RGgUT63CAK~(VoV&chC}R{0OM@0Y2@@?#7!ncXibuNT`dIc=JGoOejA3 z-tav{P__uALF)fOizg=Lbgrlu%{KEX4VUG5aB5;Hva5Yz(CXvFbeb*|x zTk>76*5|t#FWUhP?!Q@L{DukhO@{@l*UH}9gDN2gMgtrt`Tvh_44QJE=9aSq1U1k( zUS$j7Nd9+X;J3FxbPPk6y)Vd{!#y>$&~@(MpZt$Y=Qq+hV1TY7`9!t^K=bg?biRoO zF6Z^9PUs!^7mCYoinNNpE<6_g>htO?N9#08mM_u+LWu82epoy208|Xtzr>vVUNA}= z@AGb!D?8g%|A6vts{DB}76K*^BtSr><2s9yxBqy>yzeIkv21?+O8q`y{rP{0-@UsB zW$#}qO!0gohI}?gg=u>n$b)Nk%;6$@B zv|s<|KjfbuVk9G+3Ze?+SS8G#cj+KRr3dCP*42Pw(OOTL!9_eL!-Lc%IFa? zz?qRlJ>O8LA+x8aM_a(2&?YA65m6(lgzb+Ll5mPYBNXxyfU*~@_~tKK(H5J%Amv4N ziUB59n?`VzIfQpD0IL_6tR^1sd9!NyxsNxBquWx47F&I}!_X~oJq`o#SsSJ;uBv<0 zlOPmb_fig`P`q)j!$#V5>vr})%>zG2WPz7ld9tgVV>n{Gm+XL=32V30z zz~*C+6#;GGjx9O=tRw?CE9d13V*>$Uf;1QzmN$HC={TYQXXCvyuU5r8``QU0{^}

m- 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%0AvwA3eN(wHZ=19ER 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 diff --git a/contracts/docs/plantuml/oethValueFlows.puml b/contracts/docs/plantuml/oethValueFlows.puml index c2bf22c805..bf3cfab347 100644 --- a/contracts/docs/plantuml/oethValueFlows.puml +++ b/contracts/docs/plantuml/oethValueFlows.puml @@ -7,15 +7,12 @@ actor "Anyone" as anyone actor "Trustee" as trust <> #DeepSkyBlue participant "Zapper" as zap <> #DeepSkyBlue participant "OETH\nVault" as vault <> #DeepSkyBlue -participant "Harvester" as harv <> #DeepSkyBlue -participant "Dripper" as drip <> #DeepSkyBlue -participant "Swapper" as swapper <> #DeepSkyBlue -participant "OGV\nRewards" as ogvRewards <> #DeepSkyBlue -participant "Buyback" as buyBack <> #DeepSkyBlue -participant "FRAX\nStrategy" as frxStrat <> #DeepSkyBlue -participant "FRAX ETH" as frxETH <><> -participant "Staked\nFRAX ETH" as sfrxETH <><> +participant "Native ETH\nStrategy" as nativeStrat <> #DeepSkyBlue +participant "Native ETH\nFee Accumulator" as feeAcc <> #DeepSkyBlue +participant "SSV Network" as ssvNetwork <> +participant "Deposit" as dep <> +participant "Validator" as val <> participant "Curve AMO\nStrategy" as crvStrat <> #DeepSkyBlue participant "OETH-ETH\nMetapool" as oethCrv <> @@ -23,16 +20,6 @@ participant "OETH-ETH\nPool" as oethCvx <> participant "Rewards\nPool" as cvxRewards <> participant "Locked\nCVX" as icvx <> -participant "rETH/WETH\nBalancer\nMetaStable\nStrategy" as balMetaStrat <> #DeepSkyBlue -participant "Balancer\nVault" as balVault <> -participant "rETH\nMetaStable\nPool" as balMetaPool <> -participant "rETH\nRewards\nPool" as auraRewards <> - -participant "Morpho Aave\nStrategy" as morphAaveStrat <> #DeepSkyBlue -participant "Morpho\nAave V2" as morpho <> -participant "interst\nbearing\nWETH" as aweth <><> -participant "variable\ndebt WETH" as vdweth <><> - participant "TriCrv\ncrvUSD/ETH/CRV" as triCrv <> participant "cvxeth\nCVX/ETH" as cvxeth <> participant "Universal\nRouter" as uniRouter <> @@ -41,8 +28,11 @@ participant "OGV/ETH\nV3 Pool" as uniOgv <> participant "CVX/ETH\nV3 Pool" as uniCvx <> participant "Wrapped ETH" as weth <><> - -participant "1Inch\nRouter" as 1r <<1Inch>> +participant "Harvester" as harv <> #DeepSkyBlue +participant "Dripper" as drip <> #DeepSkyBlue +participant "Swapper" as swapper <> #DeepSkyBlue +participant "OGV\nRewards" as ogvRewards <> #DeepSkyBlue +participant "Buyback" as buyBack <> #DeepSkyBlue ' Deposit ETH via Zapper group User deposit ETH [> 10 OETH] @@ -64,70 +54,20 @@ vault o-> user : OETH note left : mint OETH\nto match ETH end -' Deposit sfrxETH via Zapper -group User deposit sfrxETH [> 10 OETH] -note over zap : User approves Zapper to transfer their sfrxETH - -user -x sfrxETH : sfrxETH -note left : redeem sfrxETH for frxETH -sfrxETH -> zap : frxETH - -vault o-> trust : OETH -note left : 20% performance\nfee from rebase - -zap -> vault : frxETH - -group FRAX Strategy -vault -> frxStrat : frxETH -note left: > 10 ETH worth so allocate\nto default frxETH strategy -frxStrat -> sfrxETH : frxETH -note left : deposit frxETH -sfrxETH o-> frxStrat : sfrxETH -note left : get sfrxETH shares -end - -vault o-> user : OETH -note left : mint OETH to match\nETH value of frxETH -end - ' Mint group User mint [< 10 OETH] vault o-> trust : OETH note left : 20% performance\nfee from rebase -user -> vault : frxETH, stETH, rETH or WETH +user -> vault : WETH note left: Only to vault,\nnot strategy as <10 ETH vault o-> user : OETH note left : mint OETH to\nETH value of deposit end -' Allocate -group Vault allocate [anyone can call] - -' FRAX Strategy for frxETH -group Deposit frxETH to FRAX Strategy [unallocated frxETH in vault] -vault -> frxStrat : frxETH -frxStrat -> sfrxETH : frxETH -note left : deposit frxETH -sfrxETH o-> frxStrat : sfrxETH -note left : get sfrxETH shares -end - -' FRAX Strategy for WETH -group Deposit WETH to FRAX Strategy [unallocated WETH in vault] -vault -> frxStrat : WETH -frxStrat -x weth : WETH -note left : withdraw ETH from WETH -weth -> frxStrat : ETH -frxStrat -> frxETH : ETH -note left : Deposit and stake ETH for sfrxETH -frxETH -> sfrxETH : frxETH -sfrxETH o-> frxStrat : sfrxETH -end - ' Curve AMO Strategy -group Deposit to Curve AMO Strategy [unallocated WETH in vault] +group Strategist deposits to Curve AMO Strategy [unallocated WETH in vault] vault -> crvStrat : WETH note left : Vault transfers\nWETH to strategy crvStrat -x weth : WETH @@ -148,63 +88,91 @@ oethCvx o-> cvxRewards : cvxOETHCRV-f note left : stake Convex LP tokens end -' Balancer MetaPool Strategy -group Deposit rETH and WETH to Balancer MetaStable Strategy [unallocated rETH and WETH in vault] -vault -> balMetaStrat : rETH and WETH -note left : Vault transfers\nrETH and WETH to strategy -balMetaStrat -> balVault : rETH and WETH -note left : join Balancer pool -balMetaPool o-> balMetaStrat : B-rETH-STABLE -balMetaStrat -> auraRewards : B-rETH-STABLE -note left : deposit BPT to Aura -auraRewards o-> balMetaStrat : auraB-rETH-STABLE-vault +' Native staking strategy +group Strategist deposits to Native Staking Strategy [unallocated WETH in vault] -end +... deposit to strategy ... + +vault -> nativeStrat : WETH +note left : Vault transfers\nWETH to strategy + +... register SSV validator ... + +nativeStrat -> ssvNetwork : SSV +note left : deposit SSV to SSV Cluster to pay SSV Operators + +... stake to validator ... + +nativeStrat -x weth : WETH +note left : WETH is burned +weth -> nativeStrat : ETH +note left : ETH is withdrawn + +nativeStrat -> dep : 32 ETH +note left : deposit 32 ETH to\nSSV Beacon Chain + +... 1024 execution blocks (~4 hours) ... +... 32 consensus epochs (~3.5 hours) ... + +dep -> val : 32 ETH + +note over val : Pending Activation + +... four validators are activated each epoch from the Validator Queue (0.5-10 days) ... + +note over val : Active -' Morpho Aave Strategy -group Deposit to Morpho Aave Strategy [unallocated WETH in vault] -vault -> morphAaveStrat : WETH -morphAaveStrat -> morpho : WETH -morpho -> aweth : WETH - -alt Morpho has more borrows than deposits -morpho -x vdweth : varDebtWETH -note left : repay borrowed WETH from Aave -else Morpho has more deposits than borrows -aweth o-> morpho : aWETH -note left : deposit WETH to Aave end + + +group Native staking rewards + +... partial withdraw from Beacon chain very 8-10 days ... + +val -> nativeStrat : ETH +note right : Beacon chain\nconsensus rewards + +... when a validator produces a block (~4 times a year) ... + +val -> feeAcc : ETH +note right : execution rewards\nincluding MEV + end +group Validator registrator exits a validator + +... validator exit ... + +... wait until validator has exited.\nmin four epochs (~25 min), currently 1.5 hours but can take a number of days depending on the number of validators in the exit queue ... + +... wait for the validator to be swept on the Beacon chain\ncurrent time is every 8-10 days ... + +val -> nativeStrat : ETH +note right : Beacon chain sweeps ETH\nto the Native Staking strategy + +... validator registrator does accounting ... + +nativeStrat -> weth : ETH +note left : deposit ETH into Wrapped ETH +weth o-> nativeStrat : WETH +note left : mint WETH to Native Staking Strategy + +nativeStrat -> vault : WETH +note right : transfer WETH to Vault + end +group Strategist withdraw from Native Staking Strategy [WETH in strategy from deposits] -' Redeem -group User redeem OETH -vault o-> trust : OETH -note left : 20% performance\nfee from rebase +nativeStrat -> vault : WETH +note right : transfer WETH to Vault -user -x vault : OETH -note left : burn User's OETH +note over nativeStrat : Once WETH has been staked in a validator, the exist validator process must be used. -note over vault : 0.5% fee applied to redeemed assets.\nThis adds to the yield in the next rebase. - -' FRAX Strategy -group Withdraw from FRAX Strategy [not enough frxETH in vault] -note over frxStrat -can only redeem frxETH. -depositted WETH is removed as frxETH. -end note -frxStrat -x sfrxETH : sfrxETH -note left : redeem sfrxETH shares -sfrxETH -> user : frxETH -note left : transfer directly to user -' sfrxETH -> vault : frxETH -' note left : transfer to vault end ' Curve AMO Strategy -group Withdraw from Curve AMO Strategy [not enough WETH in vault] +group Strategist withdraw from Curve AMO Strategy [not enough WETH in vault] cvxRewards -x oethCvx : cvxOETHCRV-f note left : unstake and burn Convex LP tokens oethCvx -> crvStrat : OETHCRV-f @@ -226,27 +194,20 @@ note left : transfer directly to user ' note left : transfer to vault end -' Morpho Aave Strategy -group Withdraw from Morpho Aave Strategy [not enough WETH in vault] -alt Morpho has more borrows than deposits -vdweth o-> morpho : varDebtWETH -note left : borrow WETH from Aave -else Morpho has more deposits than borrows -morpho -x aweth : aWETH -note left : withdraw WETH deposit from Aave -end -aweth -> morpho : WETH -morpho -> morphAaveStrat : WETH -' morphAaveStrat -> vault : WETH -morphAaveStrat -> user : WETH -note left : transfer directly to user -end +' Redeem +group User redeem OETH +vault o-> trust : OETH +note left : 20% performance\nfee from rebase + +user -x vault : OETH +note left : burn User's OETH + +vault -> user : WETH +note right : 0.1% fee applied to redeemed assets.\nThis adds to the yield in the next rebase. -note over vault : no strategy so comes from vault -vault -> user : stETH -vault -> user : rETH end + ' Curve AMO Strategy - mint and add oTokens group Strategist mints and adds oTokens to Metapool [too much ETH in Metapool] vault o-> crvStrat : OETH @@ -299,6 +260,17 @@ end ' Harvest and swap Convex AMO group Harvest and swap Convex AMO rewards [can be called by anyone] +feeAcc -> nativeStrat : ETH +note left : transfer execution rewards to Native Staking Strategy +nativeStrat -> weth : ETH +note left : deposit ETH from execution and consensus rewards into Wrapped ETH +weth o-> nativeStrat : WETH +note left : mint WETH to Native Staking Strategy +nativeStrat -> harv : WETH +note left : transfer WETH to Harvester +harv -> drip : 100% WETH +note left : 100% of WETH to Dripper + cvxRewards -> crvStrat : CVX & CRV note left : collect Convex rewards crvStrat -> harv : CVX & CRV @@ -327,32 +299,6 @@ harv -> anyone : 2% WETH note left : 2% of WETH\nto Harvest caller end -' Harvest and swap Balancer -group Harvest and swap Balancer rewards [can be called by anyone] - -balMetaPool -> balMetaStrat : BAL -note left : collect Balancer rewards -auraRewards -> balMetaStrat : AURA -note left : collect Aura rewards -balMetaStrat -> harv : BAL & AURA -note left : transfer rewards to Harvester -harv -> balVault : BAL -note left : swap BAL for WETH\nmax 1,000 BAL -balVault -> harv : WETH -harv -> drip : WETH -note left : 98% of WETH to Dripper -harv -> anyone : WETH -note left : 2% of WETH\nto Harvest caller -harv -> balVault : AURA -note left : swap AURA for WETH\nmax 4,000 BAL -balVault -> harv : WETH -harv -> drip : WETH -note left : 98% of WETH to Dripper -harv -> anyone : WETH -note left : 2% of WETH\nto Harvest caller - -end - ' Collect and Rebase group Collect and Rebase [can be called by anyone] @@ -368,7 +314,7 @@ note left : 20% of rebase\nto trustee as\nperformance fee end end -group Trustee OETH rewards +group OETH rewards group OGV buyback for OGV stakers trust -> uniRouter : OETH @@ -395,12 +341,4 @@ end end -' Swap vault collateral assets -group Trustee swaps collateral assets [WETH for rETH] -vault -> swapper : WETH -note left : swap WETH for rETH -swapper -> 1r : WETH -1r -> vault : rETH -end - @enduml From 5333508d454754f34ba5c63285e0e30e79de7dd7 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Thu, 2 May 2024 22:12:50 +1000 Subject: [PATCH 11/30] Added governable Hardhat tasks Created a resolveContract util --- contracts/tasks/curve.js | 2 +- contracts/tasks/governable.js | 48 +++++++++++++++++++++++ contracts/tasks/tasks.js | 42 +++++++++++++++++++++ contracts/tasks/tokens.js | 2 +- contracts/tasks/vault.js | 2 +- contracts/utils/assets.js | 37 ------------------ contracts/utils/resolvers.js | 71 +++++++++++++++++++++++++++++++++++ 7 files changed, 164 insertions(+), 40 deletions(-) create mode 100644 contracts/tasks/governable.js delete mode 100644 contracts/utils/assets.js create mode 100644 contracts/utils/resolvers.js diff --git a/contracts/tasks/curve.js b/contracts/tasks/curve.js index 23bf6493cb..ffeae9621a 100644 --- a/contracts/tasks/curve.js +++ b/contracts/tasks/curve.js @@ -4,7 +4,7 @@ const { formatUnits, parseUnits } = require("ethers/lib/utils"); const ousdPoolAbi = require("../test/abi/ousdMetapool.json"); const oethPoolAbi = require("../test/abi/oethMetapool.json"); const addresses = require("../utils/addresses"); -const { resolveAsset } = require("../utils/assets"); +const { resolveAsset } = require("../utils/resolvers"); const { getDiffBlocks } = require("./block"); const { getSigner } = require("../utils/signers"); diff --git a/contracts/tasks/governable.js b/contracts/tasks/governable.js new file mode 100644 index 0000000000..9d2234c404 --- /dev/null +++ b/contracts/tasks/governable.js @@ -0,0 +1,48 @@ +const { resolveContract } = require("../utils/resolvers"); +const { ethereumAddress } = require("../utils/regex"); +const { getSigner } = require("../utils/signers"); +const { logTxDetails } = require("../utils/txLogger"); + +const log = require("../utils/logger")("task:governable"); + +async function governor(taskArguments) { + const { name } = taskArguments; + const signer = await getSigner(); + + const contract = await resolveContract(name, "Governable"); + + const governor = await contract.connect(signer).governor(); + console.log(`Governor for ${name} is ${governor}`); +} + +async function transferGovernance(taskArguments) { + const { proxy, governor } = taskArguments; + const signer = await getSigner(); + + const contract = await resolveContract(proxy, "Governable"); + + if (!governor.match(ethereumAddress)) { + throw new Error(`Invalid governor address: ${governor}`); + } + + log(`About to transfer governance for ${proxy} to ${governor}`); + const tx = await contract.connect(signer).transferGovernance(governor); + await logTxDetails(tx, "transferGovernance"); +} + +async function claimGovernance(taskArguments) { + const { proxy } = taskArguments; + const signer = await getSigner(); + + const governable = await resolveContract(proxy, "Governable"); + + log(`About to claim governance for ${proxy}`); + const tx = await governable.connect(signer).claimGovernance(); + await logTxDetails(tx, "claimGovernance"); +} + +module.exports = { + transferGovernance, + claimGovernance, + governor, +}; diff --git a/contracts/tasks/tasks.js b/contracts/tasks/tasks.js index 6a6e08518d..38f867ffae 100644 --- a/contracts/tasks/tasks.js +++ b/contracts/tasks/tasks.js @@ -56,6 +56,11 @@ const { removeOnlyAssetsTask, } = require("./amoStrategy"); const { proxyUpgrades } = require("./proxy"); +const { + governor, + transferGovernance, + claimGovernance, +} = require("./governable"); const log = require("../utils/logger")("tasks"); // Environment tasks. @@ -744,6 +749,43 @@ task("proxyUpgrades", "Lists all proxy implementation changes") ) .setAction(proxyUpgrades); +// Governable + +task("governor", "Gets the governor of a Governable contract") + .addParam( + "proxy", + "Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper", + undefined, + types.string + ) + .setAction(governor); + +task( + "transferGovernance", + "Start transfer of governance for a Governable contract" +) + .addParam( + "proxy", + "Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper", + undefined, + types.string + ) + .setAction(transferGovernance); + +task( + "claimGovernance", + "Complete the transfer of governance for a Governable contract" +) + .addParam( + "proxy", + "Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper", + undefined, + types.string + ) + .setAction(claimGovernance); + +// SSV + subtask("getClusterInfo", "Print out information regarding SSV cluster") .addParam( "operatorids", diff --git a/contracts/tasks/tokens.js b/contracts/tasks/tokens.js index aa6d2f70b1..fff9a610e1 100644 --- a/contracts/tasks/tokens.js +++ b/contracts/tasks/tokens.js @@ -1,6 +1,6 @@ const { parseUnits, formatUnits } = require("ethers/lib/utils"); -const { resolveAsset } = require("../utils/assets"); +const { resolveAsset } = require("../utils/resolvers"); const { getSigner } = require("../utils/signers"); const { logTxDetails } = require("../utils/txLogger"); const { ethereumAddress } = require("../utils/regex"); diff --git a/contracts/tasks/vault.js b/contracts/tasks/vault.js index 0c8788727c..cdc007bab8 100644 --- a/contracts/tasks/vault.js +++ b/contracts/tasks/vault.js @@ -1,7 +1,7 @@ const { parseUnits } = require("ethers/lib/utils"); const addresses = require("../utils/addresses"); -const { resolveAsset } = require("../utils/assets"); +const { resolveAsset } = require("../utils/resolvers"); const { getSigner } = require("../utils/signers"); const { logTxDetails } = require("../utils/txLogger"); const { ethereumAddress } = require("../utils/regex"); diff --git a/contracts/utils/assets.js b/contracts/utils/assets.js deleted file mode 100644 index fae2b42c42..0000000000 --- a/contracts/utils/assets.js +++ /dev/null @@ -1,37 +0,0 @@ -const addresses = require("../utils/addresses"); - -const log = require("../utils/logger")("task:assets"); - -/** - * Resolves a token symbol to a ERC20 token contract. - * @param {string} symbol token symbol of the asset. eg OUSD, USDT, stETH, CRV... - */ -const resolveAsset = async (symbol) => { - // dynamically load in function so this function can be used by tasks - // if put outside this function, the following error occurs: - // "Hardhat can't be initialized while its config is being defined" - const hre = require("hardhat"); - const isFork = process.env.FORK === "true"; - const isMainnet = hre.network.name === "mainnet"; - const isMainnetOrFork = isMainnet || isFork; - - if (isMainnetOrFork) { - const assetAddr = - addresses.mainnet[symbol] || addresses.mainnet[symbol + "Proxy"]; - if (!assetAddr) { - throw Error(`Failed to resolve symbol "${symbol}" to an address`); - } - log(`Resolved ${symbol} to ${assetAddr}`); - const asset = await ethers.getContractAt("IERC20Metadata", assetAddr); - return asset; - } - const asset = await ethers.getContract("Mock" + symbol); - if (!asset) { - throw Error(`Failed to resolve symbol "${symbol}" to a mock contract`); - } - return asset; -}; - -module.exports = { - resolveAsset, -}; diff --git a/contracts/utils/resolvers.js b/contracts/utils/resolvers.js new file mode 100644 index 0000000000..1c89d97e1a --- /dev/null +++ b/contracts/utils/resolvers.js @@ -0,0 +1,71 @@ +const addresses = require("./addresses"); + +const log = require("./logger")("task:assets"); + +/** + * Resolves a token symbol to a ERC20 token contract. + * @param {string} symbol token symbol of the asset. eg OUSD, USDT, stETH, CRV... + */ +const resolveAsset = async (symbol) => { + // dynamically load in function so this function can be used by tasks + // if put outside this function, the following error occurs: + // "Hardhat can't be initialized while its config is being defined" + const hre = require("hardhat"); + const isFork = process.env.FORK === "true"; + const isMainnet = hre.network.name === "mainnet"; + const isMainnetOrFork = isMainnet || isFork; + + if (isMainnetOrFork) { + const assetAddr = + addresses.mainnet[symbol] || addresses.mainnet[symbol + "Proxy"]; + if (!assetAddr) { + throw Error(`Failed to resolve symbol "${symbol}" to an address`); + } + log(`Resolved ${symbol} to ${assetAddr}`); + const asset = await ethers.getContractAt("IERC20Metadata", assetAddr); + return asset; + } + const asset = await ethers.getContract("Mock" + symbol); + if (!asset) { + throw Error(`Failed to resolve symbol "${symbol}" to a mock contract`); + } + return asset; +}; + +/** + * Returns a contract instance. + * @param {string} proxyName Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper + * @param {string} abiName ABI name. eg VaultAdmin, VaultCore, Governable or IERC20Metadata + * @returns + */ +const resolveContract = async (proxyName, abiName) => { + // dynamically load in function so this function can be used by tasks + // if put outside this function, the following error occurs: + // "Hardhat can't be initialized while its config is being defined" + const hre = require("hardhat"); + + const proxy = await ethers.getContract(proxyName); + if (!proxy) { + throw Error( + `Failed find proxy "${proxyName}" on the ${hre.network.name} network` + ); + } + log( + `Resolved proxy ${proxyName} on the ${hre.network.name} network to ${proxy.address}` + ); + + if (abiName) { + const contract = await ethers.getContractAt(abiName, proxy.address); + if (!contract) { + throw Error(`Failed find ABI for "${abiName}"`); + } + return contract; + } + + return proxy; +}; + +module.exports = { + resolveAsset, + resolveContract, +}; From 97c0cc7aace25d3c9b00d667170ad373d9e92a35 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Thu, 2 May 2024 22:43:08 +1000 Subject: [PATCH 12/30] deconstruct params for Hardhat tasks --- contracts/tasks/governable.js | 13 +++++-------- contracts/tasks/proxy.js | 3 +-- contracts/tasks/tokens.js | 15 +++++---------- contracts/tasks/vault.js | 36 ++++++++++++++--------------------- 4 files changed, 25 insertions(+), 42 deletions(-) diff --git a/contracts/tasks/governable.js b/contracts/tasks/governable.js index 9d2234c404..b8eef6465a 100644 --- a/contracts/tasks/governable.js +++ b/contracts/tasks/governable.js @@ -5,18 +5,16 @@ const { logTxDetails } = require("../utils/txLogger"); const log = require("../utils/logger")("task:governable"); -async function governor(taskArguments) { - const { name } = taskArguments; +async function governor({ proxy }) { const signer = await getSigner(); - const contract = await resolveContract(name, "Governable"); + const contract = await resolveContract(proxy, "Governable"); const governor = await contract.connect(signer).governor(); - console.log(`Governor for ${name} is ${governor}`); + console.log(`Governor for ${proxy} is ${governor}`); } -async function transferGovernance(taskArguments) { - const { proxy, governor } = taskArguments; +async function transferGovernance({ proxy, governor }) { const signer = await getSigner(); const contract = await resolveContract(proxy, "Governable"); @@ -30,8 +28,7 @@ async function transferGovernance(taskArguments) { await logTxDetails(tx, "transferGovernance"); } -async function claimGovernance(taskArguments) { - const { proxy } = taskArguments; +async function claimGovernance({ proxy }) { const signer = await getSigner(); const governable = await resolveContract(proxy, "Governable"); diff --git a/contracts/tasks/proxy.js b/contracts/tasks/proxy.js index 1977bcb3f7..c625283dda 100644 --- a/contracts/tasks/proxy.js +++ b/contracts/tasks/proxy.js @@ -3,8 +3,7 @@ const { getSigner } = require("../utils/signers"); const log = require("../utils/logger")("task:proxy"); -async function proxyUpgrades(taskArguments, hre) { - const { contract, from, to } = taskArguments; +async function proxyUpgrades({ contract, from, to }, hre) { const toBlockNumber = to || (await hre.ethers.provider.getBlockNumber()); diff --git a/contracts/tasks/tokens.js b/contracts/tasks/tokens.js index fff9a610e1..d12bae8eb0 100644 --- a/contracts/tasks/tokens.js +++ b/contracts/tasks/tokens.js @@ -8,8 +8,7 @@ const { getBlock } = require("./block"); const log = require("../utils/logger")("task:tokens"); -async function tokenBalance(taskArguments) { - const { account, block, symbol } = taskArguments; +async function tokenBalance({ account, block, symbol }) { const signer = await getSigner(); const asset = await resolveAsset(symbol); @@ -24,8 +23,7 @@ async function tokenBalance(taskArguments) { const decimals = await asset.decimals(); console.log(`${accountAddr} has ${formatUnits(balance, decimals)} ${symbol}`); } -async function tokenAllowance(taskArguments) { - const { block, owner, spender, symbol } = taskArguments; +async function tokenAllowance({ block, owner, spender, symbol }) { const signer = await getSigner(); const asset = await resolveAsset(symbol); @@ -46,8 +44,7 @@ async function tokenAllowance(taskArguments) { ); } -async function tokenApprove(taskArguments) { - const { amount, symbol, spender } = taskArguments; +async function tokenApprove({ amount, symbol, spender }) { const signer = await getSigner(); if (!spender.match(ethereumAddress)) { @@ -62,8 +59,7 @@ async function tokenApprove(taskArguments) { await logTxDetails(tx, "approve"); } -async function tokenTransfer(taskArguments) { - const { amount, symbol, to } = taskArguments; +async function tokenTransfer({ amount, symbol, to }) { const signer = await getSigner(); if (!to.match(ethereumAddress)) { @@ -90,8 +86,7 @@ async function tokenTransfer(taskArguments) { await logTxDetails(tx, "transfer"); } -async function tokenTransferFrom(taskArguments) { - const { amount, symbol, from, to } = taskArguments; +async function tokenTransferFrom({ amount, symbol, from, to }) { const signer = await getSigner(); if (!from.match(ethereumAddress)) { diff --git a/contracts/tasks/vault.js b/contracts/tasks/vault.js index cdc007bab8..f31db84369 100644 --- a/contracts/tasks/vault.js +++ b/contracts/tasks/vault.js @@ -26,8 +26,7 @@ async function getContract(hre, symbol) { }; } -async function allocate(taskArguments, hre) { - const symbol = taskArguments.symbol; +async function allocate({ symbol }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -39,8 +38,7 @@ async function allocate(taskArguments, hre) { await logTxDetails(tx, "allocate"); } -async function rebase(taskArguments, hre) { - const symbol = taskArguments.symbol; +async function rebase({ symbol }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -55,7 +53,7 @@ async function rebase(taskArguments, hre) { /** * Artificially generate yield on the vault by sending it USDT. */ -async function yieldTask(taskArguments, hre) { +async function yieldTask(_, hre) { const usdtAbi = require("../test/abi/usdt.json").abi; const { ousdUnitsFormat, @@ -106,12 +104,10 @@ async function yieldTask(taskArguments, hre) { /** * Call the Vault's admin pauseCapital method. */ -async function capital(taskArguments, hre) { - const symbol = taskArguments.symbol; +async function capital({ symbol, pause }, hre) { const { isMainnet } = require("../test/helpers"); const { proposeArgs } = require("../utils/governor"); - const pause = taskArguments.pause; log("Setting Vault capitalPause to", pause); const sGovernor = await getSigner(); @@ -137,8 +133,7 @@ async function capital(taskArguments, hre) { } } -async function mint(taskArguments, hre) { - const { amount, asset, symbol, min } = taskArguments; +async function mint({ amount, asset, symbol, min }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -156,8 +151,7 @@ async function mint(taskArguments, hre) { await logTxDetails(tx, "mint"); } -async function redeem(taskArguments, hre) { - const { amount, min, symbol } = taskArguments; +async function redeem({ amount, min, symbol }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -170,8 +164,7 @@ async function redeem(taskArguments, hre) { await logTxDetails(tx, "redeem"); } -async function redeemAll(taskArguments, hre) { - const { min, symbol } = taskArguments; +async function redeemAll({ min, symbol }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -231,8 +224,7 @@ async function resolveAmounts(amounts, assetContracts) { return amountUnits; } -async function depositToStrategy(taskArguments, hre) { - const { amounts, assets, symbol, strategy } = taskArguments; +async function depositToStrategy({ amounts, assets, symbol, strategy }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -252,8 +244,10 @@ async function depositToStrategy(taskArguments, hre) { await logTxDetails(tx, "depositToStrategy"); } -async function withdrawFromStrategy(taskArguments, hre) { - const { amounts, assets, symbol, strategy } = taskArguments; +async function withdrawFromStrategy( + { amounts, assets, symbol, strategy }, + hre +) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -273,8 +267,7 @@ async function withdrawFromStrategy(taskArguments, hre) { await logTxDetails(tx, "withdrawFromStrategy"); } -async function withdrawAllFromStrategy(taskArguments, hre) { - const { symbol, strategy } = taskArguments; +async function withdrawAllFromStrategy({ symbol, strategy }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); @@ -286,8 +279,7 @@ async function withdrawAllFromStrategy(taskArguments, hre) { await logTxDetails(tx, "withdrawAllFromStrategy"); } -async function withdrawAllFromStrategies(taskArguments, hre) { - const { symbol } = taskArguments; +async function withdrawAllFromStrategies({ symbol }, hre) { const signer = await getSigner(); const { vault } = await getContract(hre, symbol); From 1498267c43e4ccfed77d490f691a17212984b4ba Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Thu, 2 May 2024 22:51:58 +1000 Subject: [PATCH 13/30] WIP Hardhat tasks for validator registration --- contracts/.eslintrc.js | 4 +- contracts/package.json | 1 + contracts/tasks/validator.js | 542 +++++++++++++++++++++++++++++++++++ 3 files changed, 546 insertions(+), 1 deletion(-) create mode 100644 contracts/tasks/validator.js diff --git a/contracts/.eslintrc.js b/contracts/.eslintrc.js index 854b6ac0f7..d4d47d89a3 100644 --- a/contracts/.eslintrc.js +++ b/contracts/.eslintrc.js @@ -18,5 +18,7 @@ module.exports = { getNamedAccounts: "readable", hre: "readable", }, - rules: {}, + rules: { + "no-constant-condition": ["error", { checkLoops: false }], + }, }; diff --git a/contracts/package.json b/contracts/package.json index fa8c5c8ac7..a45dee4888 100644 --- a/contracts/package.json +++ b/contracts/package.json @@ -78,6 +78,7 @@ "ssv-keys": "^1.1.0", "ssv-scanner": "github:bloxapp/ssv-scanner", "sync-fetch": "^0.5.2", + "uuid": "^9.0.1", "web3-utils": "^1.5.2" }, "husky": { diff --git a/contracts/tasks/validator.js b/contracts/tasks/validator.js new file mode 100644 index 0000000000..566dbef27c --- /dev/null +++ b/contracts/tasks/validator.js @@ -0,0 +1,542 @@ +const fetch = require("node-fetch"); +const { defaultAbiCoder, formatUnits, hexDataSlice, parseEther } = + require("ethers").utils; +const { v4: uuidv4 } = require("uuid"); + +const { resolveContract } = require("../utils/resolvers"); +const { getSigner } = require("../utils/signers"); +const { getClusterInfo } = require("../utils/ssv"); +const { sleep } = require("../utils/time"); +const { logTxDetails } = require("../utils/txLogger"); + +const log = require("../utils/logger")("task:p2p"); + +/* When same UUID experiences and error threshold amount of times it is + * discarded. + */ +const ERROR_THRESHOLD = 5; +/* + * Spawns and maintains the required amount of validators throughout + * their setup cycle which consists of: + * - check balance of (W)ETH and crate P2P SSV cluster creation request + * - wait for the cluster to become operational + * - batch register the cluster on the SSV network + * - verify the complete cluster has been registered + * - batch stake the ETH to each of the validators + * + * Needs to also handle: + * - if anytime in the spawn cycle the number of (W)ETH falls below the + * required stake amount (withdrawal from Node Operator), mark the spawn + * process as failed + * - if spawn process gets stuck at any of the above steps and is not able to + * recover in X amount of times (e.g. 5 times). Mark the process as failed + * and start over. + */ +const operateValidators = async ({ store, signer, contracts, config }) => { + const { + clear, + eigenPodAddress, + p2p_api_key, + validatorSpawnOperationalPeriodInDays, + p2p_base_url, + stake, + } = config; + + let currentState = await getState(store); + log("currentState", currentState); + + if (clear && currentState?.uuid) { + await clearState(currentState.uuid, store); + currentState = undefined; + } + + if (!(await nodeDelegatorHas32Eth(contracts))) { + log(`Node delegator doesn't have enough ETH, exiting`); + return; + } + + const executeOperateLoop = async () => { + while (true) { + if (!currentState) { + await createValidatorRequest( + p2p_api_key, // api key + p2p_base_url, + contracts.nodeDelegator.address, // node delegator address + eigenPodAddress, // eigenPod address + validatorSpawnOperationalPeriodInDays, + store + ); + currentState = await getState(store); + } + + if (currentState.state === "validator_creation_issued") { + await confirmValidatorCreatedRequest( + p2p_api_key, + p2p_base_url, + currentState.uuid, + store + ); + currentState = await getState(store); + } + + if (currentState.state === "validator_creation_confirmed") { + await broadcastRegisterValidator( + signer, + store, + currentState.uuid, + currentState.metadata, + contracts.nodeDelegator + ); + currentState = await getState(store); + } + + if (currentState.state === "register_transaction_broadcast") { + await waitForTransactionAndUpdateStateOnSuccess( + store, + currentState.uuid, + contracts.nodeDelegator.provider, + currentState.metadata.validatorRegistrationTx, + "registerSsvValidator", // name of transaction we are waiting for + "validator_registered" // new state when transaction confirmed + ); + currentState = await getState(store); + } + + if (!stake) break; + + if (currentState.state === "validator_registered") { + await depositEth( + signer, + store, + currentState.uuid, + contracts.nodeDelegator, + currentState.metadata.depositData + ); + currentState = await getState(store); + } + + if (currentState.state === "deposit_transaction_broadcast") { + await waitForTransactionAndUpdateStateOnSuccess( + store, + currentState.uuid, + contracts.nodeDelegator.provider, + currentState.metadata.depositTx, + "stakeEth", // name of transaction we are waiting for + "deposit_confirmed" // new state when transaction confirmed + ); + + currentState = await getState(store); + } + + if (currentState.state === "deposit_confirmed") { + await clearState(currentState.uuid, store); + break; + } + await sleep(1000); + } + }; + + try { + if ((await getErrorCount(store)) >= ERROR_THRESHOLD) { + await clearState( + currentState.uuid, + store, + `Errors have reached the threshold(${ERROR_THRESHOLD}) discarding attempt` + ); + return; + } + await executeOperateLoop(); + } catch (e) { + await increaseErrorCount(currentState ? currentState.uuid : "", store, e); + throw e; + } +}; + +const getErrorCount = async (store) => { + const existingRequest = await getState(store); + return existingRequest && existingRequest.errorCount + ? existingRequest.errorCount + : 0; +}; + +const increaseErrorCount = async (requestUUID, store, error) => { + if (!requestUUID) { + return; + } + + const existingRequest = await getState(store); + const existingErrorCount = existingRequest.errorCount + ? existingRequest.errorCount + : 0; + const newErrorCount = existingErrorCount + 1; + + await store.put( + "currentRequest", + JSON.stringify({ + ...existingRequest, + errorCount: newErrorCount, + }) + ); + log( + `Operate validators loop uuid: ${requestUUID} encountered an error ${newErrorCount} times. Error: `, + error + ); +}; + +/* Each P2P request has a life cycle that results in the following states stored + * in the shared Defender key-value storage memory. + * - "validator_creation_issued" the create request that creates a validator issued + * - "validator_creation_confirmed" confirmation that the validator has been created + * - "register_transaction_broadcast" the transaction to register the validator on + * the SSV network has been broadcast to the Ethereum network + * - "validator_registered" the register transaction has been confirmed + * - "deposit_transaction_broadcast" the stake transaction staking 32 ETH has been + * broadcast to the Ethereum network + * - "deposit_confirmed" transaction to stake 32 ETH has been confirmed + */ +const updateState = async (requestUUID, state, store, metadata = {}) => { + if ( + ![ + "validator_creation_issued", + "validator_creation_confirmed", + "register_transaction_broadcast", + "validator_registered", + "deposit_transaction_broadcast", + "deposit_confirmed", + ].includes(state) + ) { + throw new Error(`Unexpected state: ${state}`); + } + + const existingRequest = await getState(store); + const existingMetadata = + existingRequest && existingRequest.metadata ? existingRequest.metadata : {}; + + await store.put( + "currentRequest", + JSON.stringify({ + uuid: requestUUID, + state: state, + metadata: { ...existingMetadata, ...metadata }, + }) + ); +}; + +const clearState = async (uuid, store, error = false) => { + if (error) { + log( + `Clearing state tracking of ${uuid} request because of an error: ${error}` + ); + } else { + log( + `Clearing state tracking of ${uuid} request as it has completed its spawn cycle` + ); + } + await store.del("currentRequest"); +}; + +/* Fetches the state of the current/ongoing cluster creation if there is any + * returns either: + * - false if there is no cluster + * - + */ +const getState = async (store) => { + const currentState = await store.get("currentRequest"); + if (!currentState) { + return currentState; + } + + return JSON.parse(await store.get("currentRequest")); +}; + +const nodeDelegatorHas32Eth = async (contracts) => { + const address = contracts.nodeDelegator.address; + const wethBalance = await contracts.WETH.balanceOf(address); + const ethBalance = await contracts.nodeDelegator.provider.getBalance(address); + const totalBalance = wethBalance.add(ethBalance); + + log(`Node delegator has ${formatUnits(totalBalance, 18)} ETH in total`); + return totalBalance.gte(parseEther("32")); +}; + +/* Make a GET or POST request to P2P service + * @param api_key: p2p service api key + * @param method: http method that can either be POST or GET + * @param body: body object in case of a POST request + */ +const p2pRequest = async (url, api_key, method, body) => { + const headers = { + Accept: "application/json", + Authorization: `Bearer ${api_key}`, + }; + + if (method === "POST") { + headers["Content-Type"] = "application/json"; + } + + const bodyString = JSON.stringify(body); + log( + `Creating a P2P ${method} request with ${url} `, + body != undefined ? ` and body: ${bodyString}` : "" + ); + + const rawResponse = await fetch(url, { + method, + headers, + body: bodyString, + }); + + const response = await rawResponse.json(); + if (response.error != null) { + log("Request to P2P service failed with an error:", response); + throw new Error( + `Call to P2P has failed: ${JSON.stringify(response.error)}` + ); + } else { + log("Request to P2P service succeeded: ", response); + } + + return response; +}; + +const createValidatorRequest = async ( + p2p_api_key, + p2p_base_url, + nodeDelegatorAddress, + eigenPodAddress, + validatorSpawnOperationalPeriodInDays, + store +) => { + const uuid = uuidv4(); + await p2pRequest( + `https://${p2p_base_url}/api/v1/eth/staking/ssv/request/create`, + p2p_api_key, + "POST", + { + validatorsCount: 1, + id: uuid, + withdrawalAddress: eigenPodAddress, + feeRecipientAddress: nodeDelegatorAddress, + ssvOwnerAddress: nodeDelegatorAddress, + type: "without-encrypt-key", + operationPeriodInDays: validatorSpawnOperationalPeriodInDays, + } + ); + + await updateState(uuid, "validator_creation_issued", store); +}; + +const waitForTransactionAndUpdateStateOnSuccess = async ( + store, + uuid, + provider, + txHash, + methodName, + newState +) => { + log( + `Waiting for transaction with hash "${txHash}" method "${methodName}" and uuid "${uuid}" to be mined...` + ); + const tx = await provider.waitForTransaction(txHash); + if (!tx) { + throw Error( + `Transaction with hash "${txHash}" not found for method "${methodName}" and uuid "${uuid}"` + ); + } + await updateState(uuid, newState, store); +}; + +const depositEth = async (signer, store, uuid, nodeDelegator, depositData) => { + const { pubkey, signature, depositDataRoot } = depositData; + try { + log(`About to stake ETH with:`); + log(`pubkey: ${pubkey}`); + log(`signature: ${signature}`); + log(`depositDataRoot: ${depositDataRoot}`); + const tx = await nodeDelegator.connect(signer).stakeEth([ + { + pubkey, + signature, + depositDataRoot, + }, + ]); + + log(`Transaction to stake ETH has been broadcast with hash: ${tx.hash}`); + + await updateState(uuid, "deposit_transaction_broadcast", store, { + depositTx: tx.hash, + }); + } catch (e) { + log(`Submitting transaction failed with: `, e); + //await clearState(uuid, store, `Transaction to deposit to validator fails`) + throw e; + } +}; + +const broadcastRegisterValidator = async ( + signer, + store, + uuid, + metadata, + nodeDelegator +) => { + const registerTransactionParams = defaultAbiCoder.decode( + [ + "bytes", + "uint64[]", + "bytes", + "uint256", + "tuple(uint32, uint64, uint64, bool, uint256)", + ], + hexDataSlice(metadata.registerValidatorData, 4) + ); + // the publicKey and sharesData params are not encoded correctly by P2P so we will ignore them + const [, operatorIds, , amount, cluster] = registerTransactionParams; + // get publicKey and sharesData state storage + const publicKey = metadata.depositData.pubkey; + if (!publicKey) { + throw Error( + `pubkey not found in metadata.depositData: ${metadata?.depositData}` + ); + } + const { sharesData } = metadata; + if (!sharesData) { + throw Error(`sharesData not found in metadata: ${metadata}`); + } + + log(`About to register validator with:`); + log(`publicKey: ${publicKey}`); + log(`operatorIds: ${operatorIds}`); + log(`sharesData: ${sharesData}`); + log(`amount: ${amount}`); + log(`cluster: ${cluster}`); + + try { + const tx = await nodeDelegator + .connect(signer) + .registerSsvValidator( + publicKey, + operatorIds, + sharesData, + amount, + cluster + ); + + log( + `Transaction to register SSV Validator has been broadcast with hash: ${tx.hash}` + ); + + await updateState(uuid, "register_transaction_broadcast", store, { + validatorRegistrationTx: tx.hash, + }); + } catch (e) { + log(`Submitting transaction failed with: `, e); + //await clearState(uuid, store, `Transaction to register SSV Validator fails`) + throw e; + } +}; + +const confirmValidatorCreatedRequest = async ( + p2p_api_key, + p2p_base_url, + uuid, + store +) => { + const doConfirmation = async () => { + const response = await p2pRequest( + `https://${p2p_base_url}/api/v1/eth/staking/ssv/request/status/${uuid}`, + p2p_api_key, + "GET" + ); + if (response.error != null) { + log(`Error processing request uuid: ${uuid} error: ${response}`); + } else if (response.result.status === "ready") { + const registerValidatorData = + response.result.validatorRegistrationTxs[0].data; + const depositData = response.result.depositData[0]; + const sharesData = response.result.encryptedShares[0].sharesData; + await updateState(uuid, "validator_creation_confirmed", store, { + registerValidatorData, + depositData, + sharesData, + }); + log(`Validator created using uuid: ${uuid} is ready`); + log(`Primary key: ${depositData.pubkey}`); + log(`signature: ${depositData.signature}`); + log(`depositDataRoot: ${depositData.depositDataRoot}`); + log(`sharesData: ${sharesData}`); + return true; + } else { + log( + `Validator created using uuid: ${uuid} not yet ready. State: ${response.result.status}` + ); + return false; + } + }; + + let counter = 0; + const attempts = 20; + while (true) { + if (await doConfirmation()) { + break; + } + counter++; + + if (counter > attempts) { + log( + `Tried validating the validator formation with ${attempts} but failed` + ); + await clearState( + uuid, + store, + `Too may attempts(${attempts}) to waiting for validator to be ready.` + ); + break; + } + await sleep(3000); + } +}; + +async function exitValidator({ publicKey, operatorIds }) { + const signer = await getSigner(); + + const strategy = await resolveContract( + "NativeStakingSSVStrategyProxy", + "NativeStakingSSVStrategy" + ); + + log(`About to exit validator`); + const tx = await strategy + .connect(signer) + .exitSsvValidator(publicKey, operatorIds); + await logTxDetails(tx, "exitSsvValidator"); +} + +async function removeValidator({ publicKey, operatorIds }) { + const signer = await getSigner(); + + const strategy = await resolveContract( + "NativeStakingSSVStrategyProxy", + "NativeStakingSSVStrategy" + ); + + // Cluster details + const { cluster } = await getClusterInfo({ + chainId: hre.network.config.chainId, + ssvNetwork: hre.network.name.toUpperCase(), + operatorIds, + ownerAddress: strategy.address, + }); + + log(`About to exit validator`); + const tx = await strategy + .connect(signer) + .removeSsvValidator(publicKey, operatorIds, cluster); + await logTxDetails(tx, "removeSsvValidator"); +} + +module.exports = { + operateValidators, + removeValidator, + exitValidator, +}; From 0ece8b93418863d57d2c52eaa095a583e10cc1d8 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Fri, 3 May 2024 10:32:28 +1000 Subject: [PATCH 14/30] Added depositSSV HH task --- contracts/tasks/ssv.js | 56 ++++++++++++++++++++++++++++++++---- contracts/tasks/tasks.js | 19 +++++++++++- contracts/utils/resolvers.js | 29 +++++++++++++------ contracts/utils/ssv.js | 30 ------------------- 4 files changed, 89 insertions(+), 45 deletions(-) diff --git a/contracts/tasks/ssv.js b/contracts/tasks/ssv.js index 539ef986cc..c156f76ad1 100644 --- a/contracts/tasks/ssv.js +++ b/contracts/tasks/ssv.js @@ -1,6 +1,21 @@ +const { parseUnits, formatUnits } = require("ethers/lib/utils"); const { ClusterScanner, NonceScanner } = require("ssv-scanner"); + +const addresses = require("../utils/addresses"); +const { resolveContract } = require("../utils/resolvers"); +const { getSigner } = require("../utils/signers"); +const { logTxDetails } = require("../utils/txLogger"); + const log = require("../utils/logger")("task:ssv"); +const printClusterInfo = async (options) => { + const cluster = await getClusterInfo(options); + const nextNonce = await getClusterNonce(options); + console.log(`block ${cluster.block}`); + console.log(`Cluster: ${JSON.stringify(cluster.snapshot, null, " ")}`); + console.log("Next Nonce:", nextNonce); +}; + const getClusterInfo = async ({ ownerAddress, operatorids, @@ -69,15 +84,44 @@ const getClusterNonce = async ({ return nextNonce; }; -const printClusterInfo = async (options) => { - const cluster = await getClusterInfo(options); - const nextNonce = await getClusterNonce(options); - console.log(`block ${cluster.block}`); - console.log(`Cluster: ${JSON.stringify(cluster.snapshot, null, " ")}`); - console.log("Next Nonce:", nextNonce); +const depositSSV = async ({ amount, operatorids }, hre) => { + const amountBN = parseUnits(amount.toString(), 18); + log(`Splitting operator IDs ${operatorids}`); + const operatorIds = operatorids.split(".").map((id) => parseInt(id)); + + const signer = await getSigner(); + + const strategy = await resolveContract( + "NativeStakingSSVStrategyProxy", + "NativeStakingSSVStrategy" + ); + const ssvNetworkAddress = addresses[hre.network.name].SSVNetwork; + const ssvNetwork = await resolveContract(ssvNetworkAddress, "ISSVNetwork"); + + // Cluster details + const clusterInfo = await getClusterInfo({ + chainId: hre.network.config.chainId, + ssvNetwork: ssvNetwork.address, + operatorIds, + ownerAddress: strategy.address, + }); + + log( + `About to deposit ${formatUnits( + amountBN + )} SSV tokens to the SSV Network for native staking strategy ${ + strategy.address + } with operator IDs ${operatorIds}` + ); + log(`Cluster: ${JSON.stringify(clusterInfo.snapshot)}`); + const tx = await strategy + .connect(signer) + .depositSSV(operatorIds, amountBN, clusterInfo.cluster); + await logTxDetails(tx, "depositSSV"); }; module.exports = { printClusterInfo, getClusterInfo, + depositSSV, }; diff --git a/contracts/tasks/tasks.js b/contracts/tasks/tasks.js index 38f867ffae..587284cdb6 100644 --- a/contracts/tasks/tasks.js +++ b/contracts/tasks/tasks.js @@ -48,7 +48,7 @@ const { curveSwapTask, curvePoolTask, } = require("./curve"); -const { printClusterInfo } = require("./ssv"); +const { depositSSV, printClusterInfo } = require("./ssv"); const { amoStrategyTask, mintAndAddOTokensTask, @@ -61,6 +61,7 @@ const { transferGovernance, claimGovernance, } = require("./governable"); + const log = require("../utils/logger")("tasks"); // Environment tasks. @@ -816,3 +817,19 @@ subtask("getClusterInfo", "Print out information regarding SSV cluster") task("getClusterInfo").setAction(async (_, __, runSuper) => { return runSuper(); }); + +subtask( + "depositSSV", + "Deposit SSV tokens from the native staking strategy into an SSV Cluster" +) + .addParam("amount", "Amount of SSV tokens to deposit", undefined, types.float) + .addParam( + "operatorids", + "4 operator ids separated with a dot: same as IP format. E.g. 60.79.220.349", + undefined, + types.string + ) + .setAction(depositSSV); +task("depositSSV").setAction(async (_, __, runSuper) => { + return runSuper(); +}); diff --git a/contracts/utils/resolvers.js b/contracts/utils/resolvers.js index 1c89d97e1a..741c863211 100644 --- a/contracts/utils/resolvers.js +++ b/contracts/utils/resolvers.js @@ -1,4 +1,5 @@ const addresses = require("./addresses"); +const { ethereumAddress } = require("./regex"); const log = require("./logger")("task:assets"); @@ -34,28 +35,40 @@ const resolveAsset = async (symbol) => { /** * Returns a contract instance. - * @param {string} proxyName Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper - * @param {string} abiName ABI name. eg VaultAdmin, VaultCore, Governable or IERC20Metadata + * @param {string} proxy Address or name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper + * @param {string} [abiName=proxy] ABI name. Will default to proxy is not used. eg VaultAdmin, VaultCore, Governable or IERC20Metadata * @returns */ -const resolveContract = async (proxyName, abiName) => { +const resolveContract = async (proxy, abiName) => { // dynamically load in function so this function can be used by tasks // if put outside this function, the following error occurs: // "Hardhat can't be initialized while its config is being defined" const hre = require("hardhat"); - const proxy = await ethers.getContract(proxyName); - if (!proxy) { + // If proxy is an address + if (proxy.match(ethereumAddress)) { + if (!abiName) { + throw Error(`Must pass an ABI name if the proxy is an address`); + } + const contract = await ethers.getContractAt(abiName, proxy); + if (!contract) { + throw Error(`Failed find ABI for "${abiName}"`); + } + return contract; + } + + const proxyContract = await ethers.getContract(proxy); + if (!proxyContract) { throw Error( - `Failed find proxy "${proxyName}" on the ${hre.network.name} network` + `Failed find proxy "${proxy}" on the ${hre.network.name} network` ); } log( - `Resolved proxy ${proxyName} on the ${hre.network.name} network to ${proxy.address}` + `Resolved proxy ${proxy} on the ${hre.network.name} network to ${proxyContract.address}` ); if (abiName) { - const contract = await ethers.getContractAt(abiName, proxy.address); + const contract = await ethers.getContractAt(abiName, proxyContract.address); if (!contract) { throw Error(`Failed find ABI for "${abiName}"`); } diff --git a/contracts/utils/ssv.js b/contracts/utils/ssv.js index 1177cbc749..c756c82d13 100644 --- a/contracts/utils/ssv.js +++ b/contracts/utils/ssv.js @@ -1,41 +1,12 @@ -const { parseUnits, formatUnits } = require("ethers/lib/utils"); const { ClusterScanner, NonceScanner } = require("ssv-scanner"); const { SSVKeys, KeyShares, KeySharesItem } = require("ssv-keys"); const path = require("path"); const fsp = require("fs").promises; const { isForkWithLocalNode } = require("../test/helpers"); -const { logTxDetails } = require("../utils/txLogger"); const log = require("../utils/logger")("utils:ssv"); -const depositSSV = async (options) => { - const { signer, chainId, nodeDelegator, ssvNetwork, amount, operatorIds } = - options; - const amountBN = parseUnits(amount.toString(), 18); - - // Cluster details - const clusterInfo = await getClusterInfo({ - chainId, - ssvNetwork, - operatorIds, - ownerAddress: nodeDelegator.address, - }); - - log( - `About to deposit ${formatUnits( - amountBN - )} SSV tokens to the SSV Network for NodeDelegator ${ - nodeDelegator.address - } with operator IDs ${operatorIds}` - ); - log(`Cluster: ${JSON.stringify(clusterInfo.snapshot)}`); - const tx = await nodeDelegator - .connect(signer) - .depositSSV(operatorIds, amountBN, clusterInfo.cluster); - await logTxDetails(tx, "depositSSV"); -}; - const splitValidatorKey = async ({ keystorelocation, keystorepass, @@ -195,7 +166,6 @@ const printClusterInfo = async (options) => { }; module.exports = { - depositSSV, printClusterInfo, getClusterInfo, splitValidatorKey, From ce11531112f160607b8127da94dd31242a109453 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Fri, 3 May 2024 12:00:47 +1000 Subject: [PATCH 15/30] Updated OETH contract dependency diagram --- contracts/docs/plantuml/oethContracts.png | Bin 59071 -> 82293 bytes contracts/docs/plantuml/oethContracts.puml | 196 ++++++++------------- 2 files changed, 72 insertions(+), 124 deletions(-) diff --git a/contracts/docs/plantuml/oethContracts.png b/contracts/docs/plantuml/oethContracts.png index db3e35d8bf87727e53a1614e42df9ab24234a86b..a3745866b276befa81180de752064da9ee27c7aa 100644 GIT binary patch literal 82293 zcmb@tby$>J-!_b*ARwTm4z*EI1O(|ux)#rJ;?UouR>B`p$nD+u2#$axpSmo9kKH*;|-1e6+G~ z=v;VM_Ci@$9|^38#YYG-!mN1a7+Tm(zl_-^=ZuH2kN+B;X_Z;tSETyL{!OclNVeUkIxZpu6 z>l;u!4qfBtII6#{>m9w{n{Y4HO_BC!t?X0G3`KhhRL;lPsKD<`Ejcd`74@X~;icb+ za^CYl_a*i<2qipgBNQ_j7d7BVbOrC9nyqd8XL z{`aP6Ts`B=#ixBk1hF;8F?BOXp-T<;{GtWa#{7X#9bddvP33htb%^}l#6YgLFVFHCTG(R-ZfE;wk19MOu1A z3zOra(kn-jsiy~dHp|H9uSZog0@NHIX0G7-#pjxMw1o>PW>~~)3*AecY&AVA(Dh*y zQbT$BT`4zfxL5L>|E5X-BoZ1|I?LBUKmH#FR^D*a2>I=j3sGM!5?w~hSYDKrW z5AoB(P~0@4@LxQ$_1XSksr^vZ4;w~P_GNh)y+5}5dLIq; z1{eRNn9))m*EIf+u`S}3-MJ8J!Ar^N?906EH)()5D?B=#5G^gyh#NIh{yt)4qKDyC z{wkr}t1_-v3J*I*4HSZPt99gioDXvX>x;|k=edmzQk#_c)pf)J+LLS3pJJB2#=GZu zdC1`&{F19qX||7yK9>~Z_DnN*Pvb&G?hAg1l^a@wp6=xnHIregxqEUF>?enhofcw8d2Eh1aG9~OAM?j$Z{2=5+w@tTCk#$GY`~~9MAH7IZ{@PhQ}#t+ zJ*LU`nou+fhK+e>l8k#GK3A?8f{u^M{MB*9>)I=AW8vi6?|A}VC&$N^?PY1#lQ(kK zqvq3|>T`Ni(FrP_k&2|1bQ_VVQSpy(U{AQWkmWe-!o^XklmkoMhGy>-#?Yob&-fBH zpe7vawl{V1vNCKkPF#kJjBGmr6~gnyIkVBK#HTWgDeL+1GLo4grll3biTfvdQcPSv z;TObvn>c90c_>B|Ta1~rf6&=E(ASZWJdq@X1(lp8w-PYal$9@T33Uz&mN6sc6_lj$ z!tp3Y6b2LqI^+*UOLW6pZCkMEomkzw=Gk1BaM|8ecd}d8*YvZ zsirNwtllCafn8CrOqQ8VRajX~mFM?=9R8`WTX&lHE#KA6&4iUXj_cIwI+luk*y!f! z{J^{6>fldd{YB2c@2^J2hO1)d!xbXS%BFeZlkKUoAE|5{hi$stf4Er~n%OKS^K=_- zE_WLohp$CXsQS`tYirRQ%>rD&!C}Y(n>;sX@S`iUx%%sy>&u4glPNjA^CicIOOoZI zwE;N)?Rjuj{>@26gLbu@-)N!j?P#INK~wFgo><2l)NTI*qwXJq=bfFMY;N9G6UE<7 zBp}gYVF#^*x=Jc4^~a-{CMG6!5X{-E{TTKzF2|oy3uHHYzRkYah1xZvJv}n``l^GK zD082X5ZdZR_lwQ5)~I)_iakFb)2%Qb_{ywWphauDQ+wE}X<4w{o4gZ5e| zt!)qqHF7=1#!N2(3X7O4F_N3ao`|eosdu{!JUzcYohwu;`r4agyV@%#C>YJC%XaGbSSihZ zbF{RtCyqUir-IDmYJb6(jFj0xyvAYM)z!7*d^kFCg)h1DEju49Jv}{JG0S0hw(etl zke;4ilKVyW^tK%Tb*afv=0daY&{JL>9$-l_JHL9Fr|aEnN`F?&x!3d_aN4cO3kyHc z9&PeMCF61GkA1=FY`7kjiYjDevFo{ zJ3Zc>QoZH0_>~!-LCxhHR{F%l!vh0S;jle@{OY zopKs>;l*a)f9gw=!9_-SdA|H8)ZWc53NdT!2*QM#VJ0COyqUxa{YV}>zZv^+jqFyHzfQgir%p9LxcOZaTGH+wA;zn zgpibGsWEhWk`<0i_v%%cZ}P{1Eg~!arpF(=nS#KBgZD8FkV{fa?tKr)p4s zDxldIuAFnfgiU{EUdI_z=YzKg-|p1x-rSrvIBt%@KIsAw;bLdHnWvx zp)+gc3o@#4H85X(;Nc!H2!G6QWp}r9?9D3wE$tY~go#2ymG#1Jud&Xap0Ye>+okJD zjFEAwa;{2v;ZU|B^|5pye<&XUU8XyMy}_b0v$Fn-BA^GOM@2=Y%dx*WH}4y^@lN-# zTv}?mcs2wMI}GDJ#MtOD>y>Q#|ZQ7T5~KUFO*j@DUfoc0&*j>uSd z6c&+_lk>{!POqwX7u4o@6}c+;VKoN_2QSpw*_`g|I%}csbT(YBj5^8neZ%ieqrSul ziKq`(fh@h`?WybK7E_Y>MWXPfyz0z{u($G0FqjQ$`?8YUHR>?~N7H`&+H0^s_ICpI zxGWn)%4=H7!pa&+V81=7Ji2yub=YSyS(-vTs17uC5F@1@v z3_&rD*I;+p7^dC)BUUerg^gWdgL{o#Z#BnfQa2cLWEG6E)uW}bR%oSHVTYvz;r)CR z!mU+q{=EJH5(q@|d0I6N7A@bO9vsI&=z>U{4#-b`V=$_vLGkhNi*H{_U~kLk@BIpG z1JVmP7%SA(&1y^Fby1NeI!*nR2VF`N@_C$s?}JHnvg>iH*+Y$X2Fyj=^Jp$LXE);Z ztes!u#xtrfe!S?TZ!H1KbtiR_IA^BG@ppiSKFg`Uw0v~kjw8)m*S5E1l8Sl{LL>Dy zT*lANoah3SZoND%*0XG?D=U8xY|l05*6~7qvD=EIG}M2ak<7`>mDozx8h!ra>0Owp zsRdY`uThpNHkmFF4(z`K3KyMNbYE=oGrc7L0}-44yqSN{Gy&iOK@PZQ{(6{{{^+&d;$joc{Nko`;0RE{(-Vd zp-vs?=e3ljr6um2N-y(IQ{@)vIccJ>Fy^B(c(ByMOWv?n!v$mwKHJ5;g=Utid`))d zx7gU&RofsM55Ej^$kVC{>;1wP)JdX2(;O1=WTGV>VE$@vLb!@)l`GAyA9Z5LiWqz6 z+|3C)UBK|Xmy5G=CtNm$S!CAyJ^WueRLu;QzZ477s{3s3;BfNwA%+3jBUg}d0Gz2h zKTNuPeJLWjcCSjW*=J+J)c)b;vrdAY6&t>*y=G5Oq{)yaxqQn|rcaoo!%4uuY-HRt z%FWN`Heb?7$Fa$b-fGu64IJ>@p7(k9`1PDefEyK5^e**jypZ;K%iKyEr=v8 zI$A6Mfe+#M5`AeU=olD^Y02sw&;J-PnB6n#jhCp&a4XQRakx6$FCA`g7b8_*2rI-e zq}GRnqYJ(A2AiYTC|xV*<5N_9qslkvPX&N8Nn`SyuCP|$85e`>3ZP!JjhqhUToF!b zlFxRJfx@$h^v;>ESp~f=_W7eK5b6#4De(S=*K?5l7=E8YDZRW|OA9tAY&07yXl-lj zdi5eMaXVVq-Q?O>HeC#azIDerw=qxT(7^i3of<0cQh-6hN?OMxvpKzQ3xEC$sk`^+ zJ%jy4!bOB-2tmEe`2Kh1`2RAIyj%XCyz>8-r^@6)Q-~B-ET{dJe)~1fV1r95liTdI z$`r3|8pIjm|Na(Buf+R>LV5PT^H-Q{;?aewelPO^pFpWOC6BLPrSwqlb{!203@6Lo zxa0lbmnB1G;%)c{XFmHCy=}E^U5sQdVi9~I(Jq}Ab6&5upFVM|ri1?Xp;-zf=2CB{ zd@cg`bQY&swO4wCTGP*YiuOas-IXX-{QHgF=Uy2ttL&pz-M2cIEjs=+eimkFXs$2%T} zccq&&C-u#oL(#uR)(a1n$ZJ%u1ow}e6FDx(D0LGstEHy7lsmhtyJHx&2I)uUUct2! z-Ot}9>RkQYd-i+r=c~W|5ebLcP&v=QITdvN~1_-Ak1OnL%0)DaD%Zo7gc?(+n- zeY~;p?DGxtMsp^&?64{>nd$y7aXr~m#}yhC!PsKBm;89Vyp?D(YacRVNd6V{MaJ{c zX;!^Ug{b@?e(32#{pNc*b}L5EIkth+jB#flqbvrT3g2}$B_pFbM$0XFmF>mr{;ssI zreLrBD$m}+@5?_59t4vCOe@ekxb6yDg4Lp zJNw1F4i>Y`Ug0xEe8hVF92EbWf%xB!#DW2HxuD-klQdbg&_B3OnspBg_0Fb~p|T;V zVH|($^}c<<^$pc&FX7P_ue&m^pTkJJ!q*R2W2SH5La3aHKAb!VC;mq+k)xhw;v-G^ zl|p6xKP0!J(Emv1{y zKP25+;6ACUA$`xrx%V_Tj(D(sk6ov9QNr-oFadp)dx05tK?R(vHrhKb&I#^&!ww(U79a*gT@b(`s+Ou_d6(bf{yc`;69$5;r!P*C|oFKT_igT&cGT(ILW;d)h)LqhD6CH)GzA4C1G)lS- zuk1{SYgdS^kI?MR(4ObRteIWPSo&(<9lk^%H*IkB!--dm1E7^+)RNcEl*~V%Ey& zkWy>1NjW&W2d>by2w9;9>nS_7a_l(dG5O2?iT`g-Jycays2%EPcLJYop7_0OK*ZpF z4j#S~s4>PvnAt|t$3X_`8O<%*GL>iiV(Y9{Z@eG(bdjpQ-No0g4)_MWB8YsXsc1$k zbF|hz5SmG^lB!BoYhFWc03x0MJY?_8{L^XJ+lp^r+gO+9nHGv(8$28-8+~q#;mgJR z?49V};GP;l=Dq_F%XFoXs!)>c{=U>7X=l}OT2fB@4h6`BMK*W6rDA%Tq5&O(3KP<# zF^-o(3681v&X@H_$U;AN|ITmB;T_0DWJl5TnPZp?`L> z6}DzX=VsrlUGV2Qi@&ZK-c4qA+tvz{WQpZ^mSl~N;wYc}h5Y%ei1jG6`0OOv>kc7~ zX9is?<8l+;SVnu_WTk@LVC_bSgB+_?2;p=!eFPz{asFa6FsAp|mb&3B@jKB3%pX01 zbcQP%EKniTdgWoTje(xO8ivd{y&nU}H;%6hn=@EgPYc)_O{LVFY?6zJZ*-2Y41*&N zlqVeUN}ZgD6L=^%Y*1m{DyoOO^PaA?&-t0A7Pj^jz8X5pql~hA|0#S1hilLV_(qbPqGHQjS#-Fus&#qs)HkNo^ zkm{nB^7lu3h|#>kg|j&qwoJbG?_ z(i%L`>(=IXNd~uy{GUOl==cdU0RLp@iKJZOvhQ>`PhzH3wPoGeIbpfRbHjk-r2Hl2 z2os*lS8m$nyN_XBZ7GQRtPiaxok7$mTHaZp79T$vYa8hCQ~>S4o_Fwr+%wg}yzNIn zdhnkiTP~30v0Mr;V@FBiu6rz@E)=(8RwPt}9oqiEr`}}$G1u00)OM<3qD98&o|!|t zL~0zrX%#lZ*H6r^0=l%$)jzt~XNes6Kvv zdI6O%fUpP9y)&ReEd@ekg_q0!9e?{dP$_qs=G$&q+=C80x5gulE-?#^7t7qTG`>b^ zcLmEGkKnUlLB;~7-U-4(?);fJT0HAJYFMQD?UO`I*l2!;!*m6wQ)B-KA{@4(swY5pY;DDvOk4=(FXA2v_cfn(Uxw@W#j28NKbZbj}~;qR?}z zwIg}z6ZjPMCUw;Sj_LAh&FTik=-ww6agUGkN&FW>HzB?X#K}gT|1q%(5MZq0>@LpcqO!YwZ=dLg!(?Cc`=(n4i9L#o} zhSA77^lNkz}R!dUf*63RlPi3*+=u2w~`i{(te zptO2NQ^uy2-37Jfi|KXIonuyy{GF(fxIAYcWXU+lI3_|OV8=$Sbq0MX67bc%w0%VW zY&OKHX4kA!9E`?M`yL((xlnPD8%suc`-;?e^Zaix#>7W!ecDbb?PM5Mc2}Ell>cEc9@agK=`RsF>9C9g4LME&&u_SPtS!j$QMsGC2y!4DW6bf zG^KGmlrD=Lc?fS%p}tz`649+kJMOWXb1^1D^`tY?s-fpRBJ8A8tZ7jtE`);n1K%`< z4Mh)c?7r*cJeE*5qI-cMYkNtOdTVW1t%sTuP5#`9PmjSv+V&&Q+HP%qPu9^PeUgEf zh8?F4Vkdtl?V2ma4_Il?mZ$Nr!lIql)Q2eLG|P-T^Pj$c{W&M(RKQ22SvchNdFqf>T>4bA@VKdAY+_3y--`vqW}}5c znXABb?Sc24fmX;^N>b=OWWxq#S!uU=^wo(+D5dN&~Gj%&;(>)pZaZ=zoi!f5m)MXT~f+z zMyJ<1InQ;K8#zB6yH~SrS$m;${SJ}pkPE_J&q`sLgn(+M9Me_`%-|wjg{Bo-Ikm0;p%HR{*pY4!Ih~*xoJubB+Kasrdigs4AL<1;NLTMc1wh_@ICRFYwM@RGa zne?Bq(}W!#%^+`NWQ9=#r6qL8eat<^z|>NJ!6q3IZxj$)?ehHU_Ai!s}_TeBL|^<>DeXp5Nwa`B2;-}NgPB~nzzNUJ5j4jyz*-ebRE57ibL4(q;tzdrH76$&HFwr^&1>+)do zM+R1tPZ9WG`~E$#t+~G>_#iGva7jLP_M(0H8H=!5(G8uaVNx+8m2b51m71~A8`y18 zS;r>*y3HHuwbsMztK1<*mcDkD5pr32HvC70V<{M7+~FCMh&>E(^iW|?nt0K?xeMxS zQYVj}VZchV+a{_6!(vN5kgWE98Ro+!n55`&_uNgQFNBULZI*vxWiUl$lypy1;Sc;w zBJN>DfMr@xh8sy*rL-EyvD%LxL`M|Y#5nodEdCpbtaeMTjLu()e0|pj6=eBkNm=Ms z&cxTd@i*B_7Qd3AqnR0KWfz2+RgVy&?Uj|_|D5y9VAZpzpCisRK7oiLoAYuO9`ENk zs?h^Hdey%wgI~};#%}Agd$k{mC}+}P;r(~~8)9{clVc!GE|H_$&~$tG4c?|FIsC)m zf;$@GXr)iW&7)5H_4oPd<2YlNeUB;3Qz1(+vCyP~6vQqjrGWsnG~nG2&+}9>1?!ZUMnCmXEb58_v6E0E|P?^W$s(96mw?QjN>&J1OOV9S3hK-Bo zHTl$1* z7y`3ZYEqmI?7=iDuv+zAIswo zI{YpWF;_;7O8X`Tv8LdW5|?-98=D~XX90hw07iXF{o*SKu_++LM)~oOIMW-AWGz?N zh5ete41e2H?=8iBLl6v-I~cV5QN5-2Mk{0f zoa1o6ZE+tBCS(J2si|aZJCF!t?S*a&f$dcmw2?2|eMWirS@=}!V|y%+;@w45@k;E? zQH~lBR`#m=PWjcKAOpll5MS?h>K#goEK?$*&7Uh&j>ZcaIq(-TLU(0iv`W@K_rptb zL-K^Ps5!@u`cfy?ckqzd$hHakoGQ@$?&oM1L2MQYR>A zYdDbCBxv6vNU(aJnZ&qYrGs{zPWqHa=SKRa+f51-bX|aXB&5a0O_NuHiF-1%3{)kS zUa3ADCIj!;H3%~hHA(9}D)DH#nOxEFqbVY{w>Fz_%d041nQaa*b12Apa)Yw0p$Z z<6sM{kMHi}bP`}{X{l+O(n|vABnET)0MmG=uk!`pi|2!6hD}4h@cmx@Mcw!~8>ezb z_MJwNIdw&XgH72vzZdWsjd$giWT%~}GlS^V4MVL_nw2^LlSwbV!~!Dj4?&EIYwBHl zis*MQ*iFLLMgw%seDYT&jBZ;3K=Pz(5n(bd7Fdru<>=D}Qr%doDUM5FR`!bgD*06` z7(!c(BCNfY%~!uUZepF*6%8N0XUAbS(J(M)#v1yuUK=zfPEdJC_E92rM2XyNDsk#+ za11twry~QKV!3p`(MV6K+DuvU+r&J}r1=!>R5vkrLnnW&F1 zq#G7$^5Qz!wbC${$P#p#R#&6AYy0@`GDK`xi4m~5Dbv@2a3pI5*xQ{q9`i2~Tn4P_ z+1P(kOANix4&S94V%X#Qa#+b)WPURBN0HiqLb))4w!}*eBMHg_UDCZOv0qG(f)_({a3^7wewuYk9*JUIQAz2=Qi23Z#~-fAZCOq|L!US#@Z%w|8|EdnIs6A-&V z6)5TF2q#(bou!&aJ=h%^G0{S$x-akdRJ5F-5X6mU*}}WCbmGJb_%=1YvjNEOfpi3bl!)9^D?IhcNpP zU1=0TCEA^^?ecori}brRnk5bk#Y`9#WAmTbTfjC(_BzeQZjstnw~!Y*RLnb zXrL?tew4c!@Wu=4u)TieG_sg-_aikV13Ft_gG3$cbpCeMK-3_=+|smJ&x}R3-j}ki zPa(F}ZmX-Lcs=prKQ&X*=E)n-gknntBX5~vG8+yuGB6;+!K1wcM3!E3knZRuzI601 z$qtF{WJ=l0faYu1R$K|Gw$%A;nFf$46Tq$$aGoz!=^N$=O&kt?SY4^!{KJ>!ZJtZb zJ%W=mP6%d@-wZEo_p6|Nn;#G=CZ#Z77F-)ON@=iBay4WAf^-B4P_r40Wp+oVz9 zG5n0U^C8_NzN8BWr%T_bX4y-dvkg9->Yzt#S`BHWCIiKhZ<}{=#;8Wq$G7FAlZZx_YAhy&4ZjhgAQ6smgr~iB!Wv@L68hS9 zkK2?uG%gMUW_Iv`lCxZdIt&bz&Mq(0yze2!4peTv$11vPq5b}p1&c!%E-(}p6}7Ut zY4-9h0}ajh@81Q;k&#%^5IFdORYXLD<^eq};7;M;0dC8uwCk*_ENTjhun>larIOa^yDFQ$oV%m>9oQ6h!ln;#>Yx&0sZ+g_a89a1q$-eSj2#5s{G-!wZiF zg z+3M4!zBSn38FKO(J@?qih>Mt5V&5QgeFjYgq7o7kGBTK5_mJj| zVTxuAkC|mwh^z)Zdq#wJ7FXKRdWVh_S0g6#&b+z=^lY|J|M-?4P!Ju4j!4@=2<-?x zz$9YRrkrdU8;8^^DWx$PS|DR-X(=FpBn=2$$?tNtUMO9cySrI_Ck01)9rY9$3JcGblP7!wTuvP?X4$V73_$t z^j0OuR-|G}QHzS1j7)mB?S~Z7J2f)F@3l;VXz(R7C;V`KziCR@HlE+(X0bJZ1{F!5 zWT0}OX__q{&u~_f$%OAx@PaH-q=f8=V;+tsHXS^v{=jjD%E0`6T$}W&h|Wv(`5liy zw{MRn3fK<$PEwR>#t%EJNT+j&$bOI8i$BmT$8qFs8M;@}3i{yl1WZS4iEe+XPcId4 z+f6wvw$0`-*UaX@DW=K^XD$yK)!h}HLSH!(5X5k=PMnrh_h>V)HN0?b+ox)Sh%Jl0 zcA0*YgdWvFuNogXy+2Pa8P=>loDFrW9XA}ov%zMORcvW#89%h1n3%Y^xiJnjl-AII zv@rp1;D^2R_{^jGoG;+JB(v6PYcMCjWkce*y^0P=ruMwZm&29`NMhYJ7O8(C=uL*R zikm(k6F>J44c~AoH?P9I`JVtS|e6hQa=SNFvYuRJ-ITtE6c0P%)2Gy>J ziKaC5hS!YDj=i7>jzvhEvNS|(G1BJUX3;fJ_h?j3DRF}%f63s2C)OgeE#?6v>-iSh z4g1@-xDX=&K!>un-UDGC^!Xmo0n<9-`g!*E~DGuFq zO3#%I9WLHm{_fkJLg!2}_cQqZz9#6mn*a$!Oken&gg=#TN}J)q0~7rzhpUz0v;NT} zij02a9X9fIC)SFNY0hxfr*w*&Ym2`Q9~TmoOug~Yi!Z1_AsPGlh$vk;%e_<*&f{Ao znX}&e%vkH~7)P?4vhqk6rIa}dF)-tIP~b{N}t4L&xva&T74UCoJ;J4INz_E{+ydSFNvx;2&gP`Tt_5&gl$ zJbp-56G5_r2xfrlqA9Pfoe&+p`ZG;cMFmhA;IEL7O0%FYa|`R7e}oSt7RY`NIp*c~ zwke=j`C|ISf4udbW|q$HNhM+MXWwR8qH96!?8@V@G%i(#mAHoGYXtlxS?tG$TD=Gu zTNK;WG1!T}rYccnaQUixe6nLz9pGh7EADa#p*^|!(tMa1zY_J;V#?3UV}$d$#mz9M zcGo34BA&)agoTC8&wq$OMrwpY95NzZSfk}ELZlYc3E*{gqj2&T}V#GrqnZNf7)zYBO! z9;6n$^}eA(b~6iJ-0QH1HPc}Ab7&{X8ynMToK7VH?&8m%G=J~eh?C?x7zZzHkKOXp zQ06aPFVHF3AI!QMbNKk`2aiPAEW@c(hLIOEGI9R}#;SDC<$;l;?=+X9W!1Qgf{DK` zld^U~d_1vll8~wCs|%CKq=?OA(CyS1;aHVvbJNIIUs^(gjCDt*a{kaVG|X_2rQ+hc zxH>KZ>$rrYRz2_n9s!B@pZU0m-$!Ox@ z;?|v9Re;si(b2KDXT9xO3aBys{QT242!}&d^4+D&x;!xJOJkS-$&}tW9@aEk);@u?dO>PEG#T+U}ThrXyt3eJr%=4 zLqT{C0D+E)iHYXH)E9+v#47VgN=ix{D}qirCYXVXh+#4Wbt4&Y&G`8EI5^G*Go)xR zjpHLDqN5qri@hyLwP+FJ>wBo-adDg5+iq89P`rmMy^_Fk0F~q$6Y1Ro#BzYlDladu zpzzfHKE#N!sHmu^sR>dTo;DN^6qGrodAY2vr4=}!gh&Yb1^VA%K~!~daB$uU39+*N zh~zUgH2m`Ai=UsLEYxasWu>jPbzudB2}B_`(YFM|!GbTW`d&k0V|O&WLWlUJu zqOcJncHcvi4i6893me5HB;>Qg=xAy8kB{vOoVW%C20&g_d46|G7Lb>uqS9G&bu84@ z)g>@c>3{f;tXR5$P>-jryq4D1=4JqCUgNqo7gBzr@44 zva+(HLtL|cCL@WUzP>&tCZ^KpPT-zY)~S091mA;#%CkH12?##BxEL83!F>RW$C%jo z(X-ze5Tk|J??9sd{>7~_@8#v^H#eoId}|&e5{6`QkYYW2@Bj}VKZPb4x+2Z+_H9Wg zD+4$8)ZAP{disM3@TidhT%eiL z;d<#HPJx7!FH~P_(229z?o@f_77Z8;d5rY*n2#Pc!tUMKMtt+qivmR>5>0pa`lO_} zeR#WeB@1ARb(%p{5o-tpw6wNrSJ^yVMmi$@@)8!{=U4Q>MqOPU#CE`?eg_2t1^Yz# z{Ot1LVo(?FVZT_tHf8wRDi+`_G&CKNUz`8F06@cItm7loYw?H|7eiMtFayR)# z91%>w(;*VmqY-#QR6FxYwnchR#m9;*DPVL(6ZZHkeD+XP>k&zJqF$)U|RCM~C zOU9vp8npBC@{SG;e$QYbgrDV0x(dkNKz#_Wz>KD5V;emX*IIH;Nl5{Q$)NQJ$jq(} z4jAsh2?Ii6V>eb;eVNp>6T7;)xHKEUF7OEnYplt^aaqG1+wV-9AtEa3MLDrC7Rayv zK|A0tcRxTj;0N5e-^tX}6acL}RbX19P3+){?V2`&?!Bs#vpHKkf z69A*kfe#q?aKC!>s-p@Hhg%H9%EZQ(_-@cJGKvMrA?$*MoB8cqMx9z?XA&bTjNL7W zD###`lB^U{938?jFfiy|ziw#&4@ZC|4>>5m`Z>mYq<0RM|Ma@t0GwdZ&3=3*h$p~f zFry939!cm$O&l&qF!?iBhxH z*3vT1X7&c?2ymDG_E#iJc{!C7vXN9ETu`9PDt!bfCQBV36JrvR6do>guHkY?)u+PW zUe^B0$_7~ed=o-xNdBdO2zhaFvEloOs_zj7hHa`G6CfyZ8C`Q#0f1DL1^n?+ha5CC zw4An);bGvCBErHPS9$R?I5PVB`XDyn*dkyY2@g;hceb|^5)&DW>S}AnS>x9R-1iq- zXU9UR#IVKyPc(K!<0bz@fs`pR{%)RnNorbJ92lVDGdnz)Dn{7;vqRK&_&_=1cOhXK7k!B<<2%X3Ty{v z3#{Tkc{0DXzjUYjSVj<}LBIpvv%bEb4r%tmv`xM71jciHdAfVekMj6gNL*ZQSvWD1 zzBdoAuI^l3-fNizqL}!kBr^P$HwfDR7NoY~@9%HWTny3?YAy@qu+sHpfRn|qdXt|g zIfSqlPx7$e8TW@+;2jmSpXpdxj{)I1kpsGzEa;VP5lG5A>BlGX`Ezw%2+^Aljez-D z>hKwyX5GRE)azSYTe+%*Tvrr-y1K5euVF+ zsLKy1!*0zS_8Sqnoj->;!1E*d$9*)kwCht9g&H|_iAuxaR5G7;s#Z%gX${QVvPx~1 zCB+it6cj?2RqGx-L|EUKPcruQ$E^W`LqkJpsj1*$9iXv}H&n9m;w#Y2{0goCRKMV0 zY6-w*_APbL#~^r}j7!8~{3OysUcMiYa&yUYJx(T!usBN}8yFXJg>=2)<^~h- zyVbk=EokW~wpqka+bF#mV6hywvbSG|otF~rgCT`!J;Fu>O}IMcCa4LKzFDhB+=PSA z**;)^qh4zl1u-F~0r-4Gc2m>nUEJLgZdc}R-MuvghVRrOv=i|14Kv#x=8akD$4 zhYWJiXa3er*o`NOCeDQ#SQXEtL;jlVU0PY0bv^8PDH`}aFi@+?X1PB_2uOy_eBAR^ z7oiBy7HRpUb1T`c4w{7Dqw>A~Lvw0PR#+Uy##9Gguw`rD=Lcn(!NI{okkrV?$j*@7 z17aQ?o=oYO)NccfcgIPFs-(yFiB#z5Z%OZK6**-{zm|C-JjjG=_Nksxg~!B!KPvhi zTv|a(E6?GVy^`w(D=VwAq}>p5p?(UGh=5*<1WUmlJJYc4(LT;<- z%SqY`CRK0I!%G!Tx(a{(4t%FSj{f<+t!>eEbh)@Svv`he-|a73Vsw+C#XI!W)JC0Q zlvMDka7Vx|*E|33R_g=uC%z($OLNiO=uocc4&wEpIB50LcE&n}Cg`h0{72DhcHwRWdd zV8UEv7w)u;u|W2s_iDP^3|^p97n_j4>v3}h9zIidOQEG(@(&2u_DIXj$iO7yiCOihdQ7JJflqwe|cuj zQgkacFys~255rQ4onYmM#nlzPFvR=ljf35%B&NTxaH=N8bKi z!g;DxRw2Y8N3pt+3Y8_&1aJiMG)UGqAgQqBf7I0^N)whf=lxvypt3M9UwYf~Bt z5#q3*Fp3`GQ1#2lgdu~72m_tmiFtQxKk;6$M8UIv_XGGkW*e7H$}c!;g4(K#%`Ff@ zxMv(+J~U*tFXtf%Xv*P)dnKSn1ogE}0bfpq7W|LH;6=9F`{J1Rbb$8i$w9&+*if}l zr96cZ;Q+@N?B6>NIaKpXn-mI}bUbtC{y6{p%I!Y-4sv7~V5fr_f=sQ&^n;oh)A(Fr z8wV1Y?SEIMr}Xj}7rSk?M*$Qg$83wK!xBLY+kCdBOtR}EmarbnwHUzw1H9a8GMj{^ ztFlx;5_XyY4@tNH_E(bTVIWEDhnMr;6~$~E_V*fk$^I2_R*b>)lS@CvJZQT9RB*BT z^U|uQ62XP8I2F!J`8c9V{DgQC_JA?hztm$gP=f=#e%axw@^^e!XS4i@3A5c0?|r7I z4F8W!#7eYb7Nv!8^w&0-qR9M0y|Ce+<4ic>Qk`6mqO-TscKLpiV0Y|bWTtlT`{Q|` z>o7Qj*^zj)&9)EU zR#_{TZ81a6K7ry9m%l5K+20F+9>PD4Ki2Ov{twMp5O>Symcr6zbp;xc$+#S4YeIPT zFvMIw66i1;_!OU|0gHcpR!_pDVSp_hA}pL?S=-_PN~<&7(9;{b)(-u!DGm7l`H zg8YO$KpzOp_R;_0Oke~tHI3a%);Tf4(!2a0=K(}4wn{Rs7hxq*Ch>G_qdvg;feV0X zcqVCSchatsqNUxkCosydSudY|Zo=kLlN> zx2xTZJ+&5Epep|U^yTN%9Yhs%jSofWF!f7yx{s_(=-Su^4F{LM8vlb*Le*lmB)fI*(ChE)u+<=D{ zJ1nx~k`m+MG!+#Uv3;$To;B>-a_n?Z#7@F%vH;z+b>9l|J}1rVT-Nv}Wj`e-g~D4a z!86fRSJ8QJobjrwV@D?;R2|zHKB+ABPh3f$D|puggG$ykE{NVuE$3GyyG(+ZC(9E! z&Que^k9Qaoxw533Zyl6jxj8wYHaIvvC42KhAc@aS{4a4Th{Md`;o;2840z&x1v~;6 zM9j$yrnaCqv-Gw8@T@^hXQ{jW(9AF>p5jUfqLy<3saWu2el4gS^%rB4HyW&o@N-_=bq&gK`#Et{zvmaOM zIftE7rv?Zn9Ek@}PG=9HQ;!EyFvgT-O4KVlxAnAqDYA5LC7mw5dq-okTCP(K6ujK^ zkCN3iKgT)R9FwE}DG^S^x`OjV>n#=4r=#89EJ`=Q&h)znqSTh zsh9?7Dasa3wXZk|p)whgV=pMLrVjD@^&6AslzmiX^2lch{Iy?n2e_U?z+V49+TJp( z$}VX9#R3%s6{JgADd{dzQb0gJLQuM4(+G%)NH<8Qgn)qbra>B{yJJ(55|SckHa_qF zz0P&6^Wl6renhzMb+0uuYu3zfW+`fyS-Kw1`M_cuYu=Ie#KI*XZ5v0z8QaapMJ8iq zrcP|b9qMUSHCiqB0+R`R!L$_9UaTk%NJu(;i!_KDeI26~;}TrSAx5AD{2{oPW(i1fe+!YKwVa)?=`|@7->XMq3>1c~8GmnQnme>K%9|*VHoTx6D-pa$aV49&cSmhgarB^Funs1+2+Xvza9UPRMchb(QmJyw?IynRYGIqVd4?Gz-rg!xRm|y z_dG2-Y5wkfYjxgn<`8L6@n%NOn+dc(tyR+fTxp%T|n#~(#Y$}i+bpbHj9R|QGnOTAy95Rn}t1cvZ zlcgbW?|DX$j^xwUedisU7!gP9MSqmCr?RhfA|w=1Yx7}f{ERK_hr0kgZBp~OYt;1& zHEz|OS|<~yuyI?DgNU!YwKc2O(GEgBDx#)ol(?y358j};$FWcC+6pnbhDmvIg7Iuq z6@<$THT!-1zi+qodIY&QSPjwJ${dlgPo3RmzoD&a6ZDyj(NJ5;J|IcB6TjgW4X>oE zxi`(ZI*3~(SPZuOR4urB86t;VoScv?SF!Qwl_9SCKEwalyY=Rq&z0Lx^LXvaaCNq> z@6s#f-pB#)ak?X{{v3SF3;86C_~v;;#vDI3^L)0ozXeD4OAPIwKvFD0pcCo!-t(%`OrhMt?N8Mvofi7-Qg5zV zD5BDwex)t&;hbDHwR)lknqAq*sJMMHsm<^!%?-aRC+b~Gsd<-?+sbvDhbFa$eU(Js zla2av%iqo$e%24$69<&+i7qC2KgRUyY7$>Fb^P zsJW#KDW0Y{2HB@Q@Haoz+>Dm%!L%UEt_jyWjy%(cB0+T67wQ1?gBsh`ke7oEWajHZhpZ5q^7{{PZ0>R7!9#uE`MG7 zf$V^Z)kVwJ_AFX#fVIZxqRDEOs+e7|v)7YY%#(ZZIHYP-rB8*~9Vb(A(HzXbEyz|N zsPoTTw^hfDdu5cbfP@I}FVY<`*h26@fQ13VAldMTRhZilyIy&x9T4c!> ze+iN_!ehH&e*T>|%ygDc$a~-AmRb{>l_%Q&k$fJrhthC8woUiaRMuamq1*^F7IH)} zupg3gUE~IQ&tu5a+yn#YgnU$A(Z{Kow(NCC9BqHKcz0vUbvD`beAnn?SXwn2m z*C=glO3!xcWV){&P+$x5=YxG2W*2h$s8@s@{QPew-vpOs1Wz3HXLVdpx27}fFKHXC z+$T7&Bs9p}75ooTc^JQzlf z;^0?)`YSy>1Qj*A%XtfbChZoBd$TG3Jd(xSe$j=lsM%gmcJNaK!dbqazW&NZFa`RX)7e8gu;IA@mgc#Jlp4V+W+xByOdDKwUvTNWRSbeYG+}At1Uuc zZ{a^K4WdV`^NT$$5hP(?r0qMe;wn-R-Xrh?EisGO9f#QQQkR$#7$8i;mlEI1eh6 zeH0lLH1y(BuP09bz7!KHC>UN*Gc!3R=wzE&MKU ziF>3&Q&kp9-u!^q)>POaf zfn^5gGAy|b!RrSXe%t$ASwr%g&bW1)R3V=vL9~^Xf$EI}<7M7}TPrR>7W>iXu_}m% zrXYSh`xf))*big~jVuZy%RfoR;Bc5G+|yR?bFlmvKKPoHnS$mg@z$$j6tE^pT^&%DK1wvfiOxIX}FK zxx0U`E_ZXFjAKWSAk=4m7h4v0P%1F_bIBmO!ftW2maPDR{P(T(_jopsZok2zLs;CE zx;)&c=JdlsH>-O}t0L|VC&~Dr3y(z_p-^!xBRX6-qIX5>;mcy;ceum+|0&e0 zJ8AUMh4Sju<=$ahOPf97S>o$ck+)tbU?JsZIn>rBi=%Q$glz&P4@4uAi!2Uea5+rbHmUD@|8e4i_b7L`lC4J|nOV~7X@w^4O&On0L4^zJBJnpq zV~m3$qbB}WU{(td>QXm(%4IL{jwneuZ@VR+$-tG^M;}_X+;V;^5IX5^dWT62(0Bw{ z82&WN$y)6@V=Cow_(;C6#V3CkQ^8n8aJLu$?7tSFXRBg3CtCVX)c*UZ-kU-3cbXN< zWnvcE{PxzWyNT27A`}G3^Kw-A^4B^F=KDy;9T)1cNVc@Di<`5}GnF@+y`uSWr{dX3 zcWH3d5(y>8{N{~H@5R%^nxeKD5TqIPR4#`zA_r!qn{-9#f^ii(<|HR*u$}3xQc(d-r(-$FUdyi zJ;Qe6I@k^py8`4By5tj-h4c%8Rokz1*Kuk-Eqv8iqGPjP)Ac0Q=^fFPZWPnCokRon z9>I&DaZlpy98kQgjDjSk-Z!wHx&<2<{ZWjlS}L8r>u314!a~QySP`}Qr<(9#JZarC zo(eu}s+mJowBDebGXz~qc}JRMG4-1{KxW~SpnmA8P56;0`}m*Lvz(?+c0CxK7i1JN z6HQ!BW2QbHVWarZW*IY2@V^MyVQdYVRX)y}h#TU!Pln^dlaIWmgS?71HiV*YUewT_ zfnjI^fu2HsC;{<;GLqt(ZwC!KjuJ+a|Ajx^sJ&i_7UZ_xdfdpA9W;V`?TqN1i1!Y` z3-Y3${m<4-m?wA>r$a%RH%2<)M}*}}w)*AlbrmP%MB|U^p>dKX)1_GDa|51_E%1YK zDMW@Qr&-+pEaf2bxcu|r>n!mG18Z4 zf`Nc^GS;PSP7<>v&yF0J{E=@Zg!on9Xh9C$JKPy0TWoz<#zUW;yyJa>{!Sj>B=c8j zQ8DJWR^90?m35Nqq#Wz7a^6zYc6wgC)6pelx_CmRXgY46@_E48Ln>ISdR3y+LZux! zP5))9x$+>@hsVX*sa70}*xMzZ&EahF2vxmDn+hcaUV|?qe&CsVpVB%1{HZLBp@Mx& z+L_1?O=e$NFvR++fBY=SekYed-=~LP6pQm=Iiav2a@(9xv_K+3B_dVfMp~8@)EtG_ z{JBS-j&S;%nQ7b-NMeWyEr$w?PXTAq5&-O@y~l8MFuTMA4=)73fXPW6K@N9T;)uw| zM;Q*wiOy+E=zXTkB4N>x4Kw?9yABNFUU|YqCB<3hT)_+8T8En8Uw5=?h6_bso1co+ zu9;0Pb;Y*^l1LhVGwLL?7*6I#(BwVwgy2s6{u4-xi#n|IPLBY%Gy{9L<#U|RHZ_zz3*?~S%HdPyCnT{-u%lAEw_fivpZ2$^tmic{KM+YgNbplHQ5GS9{ zA8nfOqW|;QWOIWBopaRHAaxo{Nff!9tE<3RjJYDD#&hi>*4Hhaot-QGZj{d?g@*Q) zWR#LMcX9CT{23*F{%#RUrjYl9sTn9Sj{?dPg_3k*V`16b-)Fmj|2v--`UuWKt`Diky#sF| zUGYLRlF-YaZk&Z!8_rvssjCAr2pXx85fbw1H(gay>Vcr3)@XWVWu?tbt)Uw>5t~l2 z@r`@l(a|G=*{bp16n%xm_hsMH{TrO$qr4w3rr6>gWw zxD>7S2_#VD57pHPvsJ{!#eo0;Cv5sK&sYCYr>hb`*3s_r;<`6B(NnNvSZ`6W(ccCt z`nM?O57q2>*G)&4Qny0}mbiw6S9OxduW;vAS0~7c^75(=r-gmU$jAtbP+kHSo7IvZ zf_qw7m6d|`@2^5rJxk)dQ<>?*5CBSt5}5vMc%7o1^@dkr6$s zh}-_UXMs=fz}BQVZgf~!-!l{Fl4@j2>VRaxvz`xJQYd3J8QN*@?#}#KRKz(s3g3nC z1q(=_qSndbJZ-Wv9{?vno!TQ9TU%Q{3vXm2FuNB}C|a%z=9slbG-NScANI`K+k0%2 z&gz!-Xg0@9O^+@}`BvvRqtm(=j;c?eQVZSRkslJUCoPMJi6O4Q^7K42)*YD_Z~L+5 z9XL6z)1x{x=L-SmlcS@t&95>f2(!J^izCTAU-G!0Uq>s?%TEAAz5dW?tkMLDa?-M7 zfI@h5&)ULh`|kGLZE9&*t;5U9&PJni?L5D8x1nF$&zvEW#Po)j3m*l~E-2%ke;8kp zY(iaK9ckpy)Ktxd5c?gBQ>Frd$^Z{CrCYv<<3H80f<}9gy14Ji%dctETtx3ABw;Zz zG95#8o@cHjBtlLsW;&N%3q(dn;*fH;4Gh?KCkQ}uF}@Akw$Qs|yq4nEE?HD_0f2Og z7@f_>81za=NSLm1!=n(~`w`0pWGPUW5sXTkkcNh?b8A)1V|5KZJvPut75ldxVRWt_49=@O^{H80343}OM%fCS(s9@i2i;RfsKugsc-80DY25y)ThKu zOibc{bHj%|mj_yxlxx3^&?_j`?ReF>6wOSru}Ni*&%D#2&ToZgd@Dp(KCWIwuf?}d z-@kwN^}Xsi{O}uxef*k6T|0+}a*h)NH+M9pX^opS=n%S$c+hUNO%zpjy z#q`(b!IwrVg4K^pxg3rFWF#dyWCaL_hv$yBnF$2q;S2t)HAYt?P=1i{m)fKg5(4b& zx;He!LBAPe|Ff*FpQto7^dUJueEevh8to+tOehqxuvywIbnRV0kX?db#Nd_&mMG4gE*IJv_A}&p)Psb8 zloDOd(htVGJc)^Z^-I#Rnm+QV5s7U0!B`vFQHfHF?O!bC6R+xHDOzbME=e5l6|KV!r)1FZ*46m4AJ$|@-Vm{Q)H z6#s2X1S1?kXD|Mtb1J4Q8epWfG#auE;Rg@C$)>#o`UyR!INLirMNurLP!C zF}|O{Q665*Zpr7Xs;{3`Jcx&8q$Vb+kVs;fG0=UCgpaT`Xe4)CfSuh2n3ir8+=_|{ z&|Bc-{#(CUaymLXz!OLHdjKK5j)UWnmX=~i9Z}_e#0k$pzk~mRp%z%!vQc{lg`o2C za{J$uZ9jhO?e13DEnffccT5w(3QlYYGcdFeCNf&0cd-bkv3KW5u9P?E=QDn}JSOGj z#Cx3_!=Cz|Xs%wkrUR(jI@he3t7`>7w;k{{^jtCk>qgDO^26E(8wS)bB@aIaVKWVY zMF%OVqOe}a18;&c0b^>OnW3VedG_)ukHwd-UvaKoD>TXb2Plf9cl`Ch1rims`sra%R!)w8 z!YD3-bY(IiT8U#n`r zf{8hP_OXBn#@cVInM8-89?dYY^vulTlN0#i zXQuN9kn2>taKI|QV+>77q9h{n!M?z)ZwK7*O8o`2d@k3|5kd!T0s?{$@IMz%g+NFP64jK7Izra9;b*5P0c0pcEyKa<7K6^F@D)h<@{e``Pz&zt_Im#$0m{8eH-398g zvL5-IG#zRK=;$sRVWVH5V87ULM^8`BXG9R_TSf+kdAq@AFfCXuHu5quOl)jULq(6( z(C!sR!mMV7HzUH)ktZqc##39U4#fJT4Mj*&QkZNXg2exQG)6Q%BV%ilfh|b{(2$gr z!Pu{8+xiN0Yy9od&j5QjKR>Ucs!HK#sRr3P;Db;YHA7v zcJ@pgV624rB%x6STE~zKpnZ@Gbv`r$edI5b>a~W-2cXMgcK)pghWO_%IXV3gd7guA z8TeonGJxXm#=c=_rqrb>|?w>-gxn!_aCU` zglUYs0%Aq#?vdS~QKLo6%nZA*qJ@c?x;kbMSJ?38t3_izh${c`Xf#es-YiX8jH6fMiS`e9=Q`Hg zx`gt4ej~Lv|K5elIe06ei&wJq^Y^#6`)2*%W#+xg+>fCQVK_(m=fT^?s!mg76ivDB z+y#i&_I0WXpD^B{?1XOMFDw!-l=}i@*1q*Y8yhhqDVLexF(2tt`+*VouOId!kK)Oi zXf-P{?4a(PU%PQ*Vc|scHWK$Nxn}oWXHMnW;kHs-W~Sy6RVaZ3edE*ir`*@0$o;)# zRrH6MWS_D4htoAal1(7KNBCGS{FO44G?6xwPMBKu%@bL0n_C)u)(;3GY|fcE=&YDp zo;$Kn_VMhQ={a%Kt=_cXtXWQS+nh`45%H{@321(I{g$m4a^qDSKL!cbTZ@YY6N+-; z;%_gBR>3BIqG;~GPvY!W6yqK>>LG_i!hl=T$sw=*eCQ`taY10I#*Xr~p@2=op^l%1 z=f|(Ni;3=qxt5ZRvFgWM(hrmmrXwSrXb#0BJ0V|pV zypH|Sqh(vp&21VE{SyA2RAK?Cb(bIm!h&1)nGS-+-M2TBg-&e>Ur`;5W^b?dq!{V9 zYth@OenS4DN#f1g91>f5XL4j$vi%23Kaf!=HU3V{lVY!bubI6Hg((7=-V1SYanLSU zh^@}HNn(g>WV`=EBI9$*#M8KF_M3QAb1#-_Z#j#w9pl|}>)8g(HQ-8ECH_!y=O$rv z;2p99dqIa^Lw6JRSCb!O{m}f86Beo8qPf|q9siyl7lRWvb8=rKl3&Fx82axc=$5Ea z4s#9xZAYv&hP4@A1!^{4@e=X5M-ubl}pC^nbP^qDd9&a z1BvM8^K6hJPSknjqEFmvd;gXfs@xF=m*%ZOq4kuY4^Id<-3duaxFjZb6HeozhS$zY zhNb)_N4H52S}5}0LCaAR@B~v1KwirXlv1&epLxvTP1^8zddIj@986EGP4ZnO!JiMfS}uSLy?qF-hyf`j7qy6p2vm&r zU?bxK-FB9%rJ}xdVh&GgOXQskP#s8Ctmb2p`LTmhhpVU6lk#6Z zBKh`{43e{y{w9<&D&jY?-{M*-R{xyL*K8j$wTd;CI{fyXrR$^Dn`w>R)y-N*Dk_X?z zo6vf*{@Bf}DmhtCQqrr~5LsC{zQ0RKq1+;(OD7e$G+i2IFdF|!XXe4GU1KBfI;vLi z_p+g9;hv(A&<36J_#NK+9yYY>_>w+r#~a<{#ccs{3w3ttle<*D97*mAU!P8K3!R%Z zI2?hT(Eu%8u|rNwEHmchOd>tk;;4W0deeFSXnEJVR(q)=SJchd2h%U9I#d4@!LS*f8NvF_B;Cz3202QO2nM3pjpe zW~QJ)tUC}iO0J?XMFomF0aYG=`CEB zbcThhGhdxeR7aOUAb-tT8CUl;QGq3s`TRzN-nSj*6J3GZoVe$9U<&FwvvYIp^MzGE zLIDvqs**&;|IXj89hCvTzqBn+3_EGRk)ahFBUsiAiwSF1inF`pW`&>hi^UGK&Y{h_ zsWj*ohffT87Z@ttQ67@QauM$A37 zv_2TBW5&`Up<~;9iKk)CbfReKsX3-wo76lrE*+Kp(}pSQNo~%6nzdUDo?Fe>j;{7c zpAaTpnt$JlI~~W%%bP}?;0v*e+1ZySbpe@~3^q1fOH0PBQHZ;_kLup|7hEB6N_we$ zC+bTC0y9TmEOg!AZ0}AYjT;-Pqjovv71e0kg;x=+#E;mJnmUM#(q%1Iv;PD+z1nKM zCnp5TG4C-k**+za?#R~j#DAj*(@ybJ}sca>sRnbrNMWDv6I!MtR`Y5 z(Knkah5BCBTS;8sJC&;c5bY1&xz&pM+$V^j+_H}ZtJ_15MQ5z9&&BWXr(&??$robI zK#`Juzkm^@q}nG*7PkL0g7L4~<=rG3e@IlHKPM(5TT9_&I~n^Mt}TgF;gUpM zv%>T|)s0IEUnLVe++}x|(rC#Fq-?EX0>`UGK?S#V4KeNb^K#)&S>3c(EGX`7o?7m6 z6~e&aONIDBMn>~3Bb|nm>kSk*12`9tD_NeZ1d#cgqXuE<@4HHJAmAgC?Ddgfd9sJh^mWyuj zpI+$tBRFh}O|$W>>Fx%djj;O%TI{oyiDUdhoRUFi&&5|y!}Xh{?J2Uji@wp`Fn3D) z>0JH%-KOHwhfU=Ty8(Wpb8GgJ{T~&kGb;tHa;zSxQX&%rJ6}uV5HnSq_g;N8^jg>cCUMIIpUq&u3W023>=!b|8&zIv zr1Xb>u!PG)iWu`gd>y5Bx&yXt-cUMNIYF&ybADi8=IO9ijPQSBkd|r8$jq#)4;ma9 zf#S{CckgvSA?&)ATx_OPyt3_^!p;T;40mxxXoUCulLFl&%84JIMYjJe++o$Q~EVL}y6EbslTL?N&-E#Pu z$mn3uA$oya_F>m##nOM``|Sc$nM34<&6XBIkzhcnat=D2)OG5OvYJlC`= zcR<|EuA(*d4e7Q?whc*s4Y8dc8p2O4+<$d?{w#Svv{3Qud^`FUu!kV2x+CVmuhG@j z)ogIZg9deTHV}NY3$srLhlU{bQTbzIVR?C?MIwvB4C*4;*`0@~zyaF)9CE#l|KDDb ztNi@=ida`*7hTQ4ZyNrb+sS+aj z&wUI~)zBa!Ctn{wfI?$pO3G4N5 z7$hT%bMG7Ghp{SMH|>YMJD07DD9K>r5Kz{3o3-221bt1CZ)FQn$?ZRk6UHVN`I8jFSpBMf5A>?ncoi(A}m5`8d{@x{xPY8iJ z{7YDVsg2E&KF!-=#k~HVHwW^S_jO6=TAmQdR?w{Dihf)e+@-SpGfedSgNSnfz3kW# zzxr?1y7IIQ8fR=Daqv+L0roSt3+?PpzvP>W+iV{PEyV0)$5qUrkci21qLhUdhdZa6|UU%hN=vO!w(7mH2ZHWlol&u@Pg zD*6`oShs(7s```D`@*WjNB!<4HSQvv{I~7T9lp1exAE~+H8p?cIBUQflal&pt*?XT z9jF)Nn2``sG80a*@ru#6xcE;{F2xk<1^Du-lQl~DYnL%`)#qO)T%%M~9CLc&a^zRD z9GT3F?_x)0CF~H>%En$9BTc+Dn(ye>&l^lGDi>Ip5CWxOiY<$^?1cFQM7m8Ru&vSW zOxJuj`Shw=$-NsDU;MD^Iy*Q3?vbT~1_exF1$9v;L*0Kgjwn`Ezi4jE}*Y3K(7s=B$46iX{aFH;8e^VA0Gz?W3pk;w=nSYvP}7m24`@3 z`|REM@Isbvh8hF?RnH$enK$T-PGttH7KYVD<3!QM@J>osTAB8S@kb=VcocVFDd2w-nE-XGyh4JoRyW; z^XD-ZGX^?3I*%WFTTIHs@k{S8%kI)TDbaV5xnjsRP)1C zlE<-8We5!*zPt~f1o!ZFPCaw@^d^q|&pSNzR;C+l5^4V2I;JH%yY52HI@z4TgGpx( zb#Is>9{ujSSlcm7RAM;UdrNt27ZkT|_e10q=6NCb*j|q$H>eNwyk2?s z=TQWI?X0Si^;i6E3v;t+i5Ws? z*|UuCoF3)kXCyX&-%P`|oA!YN-}PR6Md_o-PcKD`0MXUz0Z?|~5 z5JYhY{W*ejX>i<}+|ZVb+M}}z^S_OE19a<9!o3x)rG$n$V+Y?oFN7>C{V5yJAMF%= z9^ZdzEo5wV1P!yz=!mNV*b`4gXZR@|I9w*;{BKy-ptKlL)|)yPL1`c@54G+dY$&D= zQw_&I%Y4Q<#^33!R(AC(F&o>+X7u%Fm;K`PBXgV#eO{Y{hmC{Ui06x|c~t+q8pr9B zaWKH?{o2O}yq=IkJ=XGS*DDmzzQxDzD6uaZi*%dwl>KP zeWohB^^#qT@<>f7E8w;lTBvBM%({;95W7i~vRYrx@KGWGwqqN>oT zckx6Id$I)LJ|T*Uw(l!mVm6iEnonZXpS_~rt)GaWgN?bn&UR#fa8LB5mH%c_v&A9H zb-L!I$G@gou@v;?v-N(_T+?5 zU&?#*?JT#=Zz04wkgk(@Unnd7UK9Nou40hn5n@1?zaBX|nE@U{p8N=B^vn7i`t#hn zL}@K;;i>8W?OzJElB%>diX+wh2`5t3hlTTQ^~bjJ_8GMPmo*!*;+)>r;j??_uhh#8 z1r#;*9NX?-Bfh9uTpm6acUB1RGi-T%s`c+so}vI@ozAZsSIQy~)?_q%eqSC{>5%?& z+3rBXLWFN-mgSMO^nrUA?b|^6=%<5*1@iyq>nja4b-jn7j+2uU#O5gl;lF>unG;6% z?TLqn2c%t3CT$8vb71Se`tM~YsyaI4L`2J?2NT1?&=qiEaPWil7Ad;-pOKM7OS^4D z80kM>ge(l44{Pg0*rXvhm%yj zny2}2x7S)7$50>VaLxaW1FFS4`2)+tq2mbvHjH;to+rP00?7n;ZnAD#Uf#x(^UPF@ z+W}lEx(@t@d3J5>bYDkmNl7H3$#$!_m^xDxg!-)lG_t;op~T2|;&6Bmk#qagpADkmdPo409C} zh$)W63)nANl}~-Ve*tD0qy8OO$Pd{B_T0R@`a>1lc8f^fB`H) zS4t=G@7)~s@;!10KF*u=saY(?=$EXK`M(-fiIUSSzKD`NVY4R z%q^&0jj6D*v`k-zgrTdO8@hu7v-(#^N5qJF2wr- z{|bhD{D>*tEr9kY9g;^!MGh~j*x#<(! z%<%;e9Rwq4>gg#cEbL2^rxq5jhJ+_i!*5@I|NAT~B|9&VV-V&%$Y|*?lDE(J1p=M z^7vxT4<*oo2{u7u!u4y=rv(mEn<$NviV6X0YK$HVbRZ4GRv$i=hK2@IW76tgNOUw& zlIXd7V8h=HP75K&ZuQc``ScXnk)onKDhud2BIIE8UG)L{R(%xYcA@)^gun_uIk}FS znzxxkc(G{OzQ9!fNk|V8eU;vHwp5g|J1L2{i6?X%t8rn;FfBaY(C@~8H z4<(6%ROt1~y#>QV{T@f>sp;uc$=4O3e-j*FU0je>>nJ)#Mrcx7_2eh?a!I+4PJrm- zz1TZAkQOk7!={%?kq|r;#sq4>d$MY3Wt9;^9=%;E=SUpjidIav$B=S{OnXNI4M-}4 zl9;fnsIgRJy`fpv*kM03h)Q43F)%i?wSBO9E`1r`Wu{=>UVIq_sS~#`iNuS98vQ@bCGH;|H>Vy4_0(C~vwLSESBJ$81!3T6R;F~62zhz~$lz(i#{_;pZ9R2>d_1d{~e zq#jnrHgNMSsfca2MJ>;H2EAh;zokWLd37=kN9c1zJ|yXHryR1MTfmDDL3!|VTJ6gs zE-vn-1&K2%h>x_jyrcwz4E)()VjaR$8WtA0or51hufZ?qw^xibITpT(gVW^6fu7wv zZ^`mE=KwIv+Bv9P%cpHNnDwxL>y8P`^7%TqHOs9j7H68xf$LNUWY*r#3@q&*>~lST z2X|}3fg(~;!_U_j-889cZzTW4+T2{B?c76w?&q+lfR94T#KkorEC02yFl?t_|5Afc z6$L_s;|8prtt!AWvmbNGfH=v>$~t&)3~L4#I$y=b&CH#2ny`W-&)}Z1p&`GGA3Xy@ z_yc-Zx$lu>Uhm((oEp*X^?Ex(h*p3B^v=Gq5oEW539<|^7LWV*1=Txp=GLuFvnW(C zR5UMJy|yqnhenQ%`5xv(cCZ4P#>KfI12?!ccfoz~oVdt)Aj#0>jmgKl7hJuqtr_Q2 zS>Pi;Gjcvw{mhI{sN7opq-`B5V9zks36v)2X73%i-#745N*1J67|@zmDV7L@xi^&)!YK|u1Q3==HQzJ;Jy`)2OX zfh?g?Y^-n|I!Q)_IBxY21ga%_0$4jpQLu5fM90L$L`8XD$3aVey+;_sFx=$2&Z2wc z2QV|26IP`U=JPGR z_g= z@fPd!pJX<>d2YlMYjxp9%&6^x>55Bmy*org^d|x;y@rBLZ33dM z&A&5guCP(=&SykHuz17eH;|!l>-Nvq`es(Nip83mnF06r&_>7k`zJ3rTyL+t>HobR z_8a%0hF)~w=Udm#=E-EH*Vc#h`YrB=R;NW1OHvz_8dV+l?B|J1pT9g>SWcQAw|+8y3B2YQ%W=~2+>M^M_zVtnI-WdNa*?QCb>C>B5fRd`F`}kn#`l0t(6B-VVu-fl;QI&+0?6+y90%)oH z!wi~&NBE7mNjYB0Wf?57%>Au^2_V}?gd~y{{Ke5?`1DnchR?_kn|RUN&4LGoikJ-#@j1#XsmofI{$aHB=EMB<<1?i}8?*90!W!U@lLg;WpN?_hlUjM;jYw zMk3%s`SNX~xrc|y&oa0InN0`z01(cO$a|4Kz%0*uTt)j{oWSu`ZglqpR`EYsV0lgZ z*AtDFY}SWN9JV*vHTi#iUb|B8vm^Y9S2D!VH0~e1VBVbWk}MIM8Z#^St2vN=tK7!u zvqMGQGWLci8M9iVdZM@(%-VWAhPisu1X+bK~BOlh3Pu>wuAn!idGR*`K%6a@&I$vIMj6zqc*5as69 zR{7Q7^{{e4ZgoK;(kzKh(BB`Sv7ES!Ad++%gVz?pwC=PhPi zH}&U^{*vRQn=`vyKP#r1tnd_ES8fpWYiGyY(z3+EXA(ehBTPy-J689iH3xzK!`@ta z+oLNUKBH}IePU_iljhbskYLu;rIckV<@zx&z{STm!bV|-5(52hz`lXrz)5`GVvv}y zW+^7diFwu%*n`tl)+7G#;l&rPq3@bYJlX@JM%}y#$?+%9HqieLvy9@{8=cbHT1qFW z|K8hQven}nbl=--#COfcNbCj^{&FNj^uXkBx^CoC1LJ1ly@Sm0!!&|wgU#a8#}tgn z1)mG&b}(Q2E^p9{i(4X$^PHm%US|&@{USQ}2dxH~(7TN!RLk^B$}5|$;xxXO;W%LI z*dG*FKZ@inqcC7@$o3Yj!wwr=s|0%r(qb+)|9KtTsj7 zbyrnT(!taL)QM=aX9Mdze8z@$gz<=4C0hLcf5lLGS01)#k}1Av2o`Tqm_J_Pc|o@r zC%XQWz6XncSIv1pO$t4|mQR3xgi4&a%1s}~5I<%wh{37bD4l(r8pR)(Y%|FA@+q3R z;1{LA6C=4}nScDVFWoWLqb4Civu+F2U)sAK%|b25;FO zt2h2v!1CEA>(t*^=eWp;%h?_G^#8W+d?Vwd*>J>{UaBn^l!}mWV>c&2+y9o!SFQ{V z52t0X86!nvMNBtDo9$=Opqg8^?Il?i%jIjI^g7af?1JgM89hHfx<{L5_rc=-3$7B1 z7*BebdBuNwTJALL)%o7V@bP3($yI$vd9%LCxnOkrzNhjRtX#5_8A4|Krb|8k_A~#@ zmV&%|KzX?{-qaSdG|;VDCXl$R#)7u>8y{;$?W@7Xk3LqTtsai6J?($>ezJ#)+yn zzd%49ib!mjHJp0oz8$yIcY-j4`VZYElzvPo&}m)bVjh^G)XY|E4nNXKbXae|O!bJE zjLHR%kDM%>9Wv`%Bv}_srU=R=lbF=1w3sBiBB@}paWUY+NFgBs0TRx9>HmY!HG8(| zrhc{Q#nT;#62&3;VniVloYkuQyyz2I^H*mVg~q?-uIy$K<{pc0iJbi>o0-Y{<03Uz z2a7&=6p&wo4~6lZg%hhg9=EPD8*D_m585L2PDzUV#qJmy>at2x=J#z3i7_ubSD*GX zDvC_n6qA;kTC}7s)LiAo#q5FXBNA6ZK><#dp@{w1{AY)Jod!xaf20Fr+dfG@)el8X zQLgA!e-uLe4v8)PaI(B|((n@ff|5Y72ZjroEI^eAyBGWqr>H188A7_KZi54Q^h>`; z&3CftbN(^cz^&dDC&v`A(omrvl%n6ORyybMTU{mgrtLw@{@+N%_4UTnFUt8=PjAB1 zwebsimy9$QilvhGuI!tp)UCTEedT>gjW>x$-Xu@>jJ6-M@pQF^=x;sqoj>_^oVS+l zjwf%fmjI<{Hu6o4f{|*|d5v@t6Z6VlbT(B|{PWtv-1^AZ65X?`Qm?;u2CWv8WX?!T zo(>+1NH<~vAUR=Qxe$~;@d2KB>a?rj8#{v7g4n6@XPsiHiXaII_{849yD5E+@sLWj z{G=~BC@zw|xIDqn}qKeJaHK;$o3F)^_A`kCo=v zIq}}$XG_!uQi`S_`-_-ROi9Fi*{X&vEYgYz#&fHf8XP3x_#z!H5{;zF@$w=%3AYE? zD{Wtw7X(O+Xg;(gEuYz26hBj!{CMrm`>Bn!#^=eQ6lyrcNkGVhmX?-ct(n{NN}Vdp zc%q8JT?d1LhOl9(Cp4BjY7Fy4latx(3VJPoEg6w-KZ&|+zp0%hVab9Dv`Bp#Qn zFo$ZMEIMuXgt@dsjQwOL& z)n`Se-aH|u?a0y)y8_HbpYRveQjDlTdm2@w9VIiXW4O&RnR_QeK?i>X30G|gKT-h%`H?&lV>j-x=_n- z1gV@0C(QoK7~kizd+NwX_M2fzNo6=#kDF) z;X`ulE4Rgc?mK$Cl=QLJei+p2SZ*sAN!nbXc$)}kY4dWaO}n#G>-(cBxc~SVW-}{9i z9b48JGP z?u0*&cwP&x&qOFE<* z1?g^S1nH8N{?FU}d(Lyti!;s`=gl5_kFD2zT`T6AbFT0FOtj`fOFJua%(4g7f@$;v zVB14`6!9~LDtkV^IFo%MS*Q|A$RATLHM$(QVfBN8biX-1>8*Sb$9B{m-PG$hsmym> zqt*{U)MD<6U7=)M-%`GjwYnDl?WQ_KhWPh?tC#{3i;%t}T5Ef;_;HXlZwRyG(w{K) zJ$-Cy36~@N^D^03`_T)2rIzU|15FGUr!5u#7yO_u!1JcQqxbC+tK_OtWrSlgRbOg@ zcJ;6pai=CJNGiJD<|e8793`Gml_LR5tvynn%E6~2_#$tz{@OA*WTZ2`R!PaD;E|P} zf_E2j1R^l{s!<{ClSl4*EYNdzBh`Y*^L=PCNnhgi(n)=cJ>`AW$v)BfGk+%RldR04 z%7M>61kC@wjKH3De}0NOr0+xPtE?77QDo;_Gm*856PJF0kh`jq&i^84qx?A~ahfQ7 z+%x6L@x%%n?cVeDn_LhQ*A^A^z15S&&z^Z^<1u`w=i&N*@MP0SQZF}Hldn(mJS<%2 zBwpUOGj9gsqw*I<&x>b5@)KFw-JNMdho29o4L6z+>m>p0jCJS+&oEt)#TuyHmWUG<23 z**Hxo(>eGf?Xl80d#lr@%}?nfue&EzF-i#@a@@NKr_Xs~eAwm3u{U)wvx>iy$Bqi} z94k8X3}5mW&A0k}Sy0(Yf)ef(3#^Ld_)O$V>(E=?M$(DITy|S~k5E)t%ESpn@AoyGaTuNtBtErauFNoCK>j? zfm{Id*71_a6RZN-CR0rRrgC?Zl()VX<*ZC)D&{F1tV~Rz_zAI1sA~8*kt~-5S;?c5 zs1Zw58$=wJ3p}xmS(?3BF8|)0WOk*q$4xo;YN3X1N$;AbfOi=A$Bv4H({>egWRv^v zvpbgtr38EH^RMmbFU^(GF!M*QSJa-iN<77)mAW7GBxa6t`9+r@g_shS9bdcEi~k*j z--_YH{7jSn%!pl~fm?kb_3uZXi=h$*zRSB@go&w(VK;fOuJ@kwEK2QAwabp8AHvnU zN|l{wyo4XdMHF*RFYQ#fuDyiN;zw(Ty!E|1$*7qDujdo%6c1l^XsUJSR3CE1oQjWk z*7zx$a;`t86hDH=Xg@4*Sks*YeQX>ta=c(102?@1O|M-_;hwLpLTa=Ub`b)TYn=naeT>kHb%lHqt>( zdgFXLA+7?&GG1{1FK9+cpgVClGO@;pJGq2^l-8Al7RoK&*y_vDG%w(5lyD^y(4BEv z2kRvWd+!jYtc}of7VBNzFZs1mG|d$UO9qN)*2(G5n=*x)G^)bK$`#b2SKKSvELlaO zX{_R)>)6YRp=q5^sb0f9MqT=hA?MJDV_pTb_jo8YMM^v7{~Q%;P**foisQ%;KMzb_ zz}7nx)}K54>a&;4f9AELJxi86;iTJ43_e#U_doY3jfS0_9qtX%^F-Gw|40gAqI(XQ z6nH+g4~o5qzrX1wvXjDQ;q;JfX-ohA_#;o@?g#Fvh7hiu*sS>L5`yJogxB~+CNepB zR(no$3~wZ&@h|#48`-Vcw6K|Kq@lY3g6?M`&r46ZevL%CmZfh{qxr4wh zqvO_1Z<^VXX||PvI)h7RLI;l;tMvBI!bO>N*mW|7oA>L~y8M|;4!CrAXMcuDU>=NU z~`OEE5>P<~^7yZKbe zejRy-m`Am1dyi4u?R{F;VLjbaU0kYOZ+zRM|2=SFrJ}mp)7^bYzabv-2p)7xhq@|{ zd$_Gm(HNQ^yNQ)I-5yhr(4$?ZQn~X@Hrp-<-4U!7lKSV}9p&~Atm?8KA(;Q?QPglz zg=o~(_72`n1%H(-xFfz@ZbgI&38B`mT6jIw#viHkd3Ld>Si;?X;hTufsK*{b*xm4D zDai^J*QbPf>R9uR0paea%t;O}hz5iSIHUNgO*Z2X_?jZDaJ47m%wn3lY#w*k@Ts_q zrL*74S&^8XbAN7cUUnujyKa8f;~5yfxV|03Kul&n^)i(u;qOY0+kQR!b3@aQ2@DTH z8EyxBj8LmfGHGm;B0d%BEba@w!{1wYbcvL-c<@BC=uv@W}mKdU~eqjr=5 zKgW)h@N8oCbI0CC9_ru3wwT2IR_kBfQjTAkTx(5MQU(;gSDI74-v*^tI%`@9EYe$OOG(shM*0ba~IyJ`X7uvr#b|H>^NWv9ksk?H8gtpRKiJdD`-73C0ovoCKOf)*(I-f?Z zNgrXSM#9f|CA0gjY{Y&(v7zy)jO+Mqe`hEO3BgzBFaPqR7w3b^r!Ts#Nb@oDyl>t; zwSXeywtf@$`?4v~`$3E18(eMltUF$OCyyc}wVZ{*&t5)V8s9aXRr&LD zf=T*M5r+N}vMtRD?XO6$R-4~r4g*-(#z{@$oNIqsQusC9yMD@ZsuV`r2h#CTnKCRf znDuJ5zkF%5a_9D7M8y7rU69NH>wacX~K2e@dq4*(ygnv-*v(I7&`EnXqd{=!p+a zb(F9aisK?eWca!W55J~kNaU;3;J$F#P#V!-1E1jBDeo1Q=fEYm`p@uWV#~OIRn;qO z7I}RN!u`71-GeBWr#b!Wkw z$)9kvH8S*~}&mUV-V-FZd5OKIurYpQ8fVjo2PMv-K6!Egv($&g0!07Gj*59Ucnu+yB` zTIJ(fDHc;HqEm>oS&Lmwh~A^5j&wm?*M9r{5kI}qvyf`Lxm+UL`e5HL&FS1F>=wOi zG%RKr{nsKtiDw?G-1fXeI#!XwQ4UI(t`1twpIpw~va0i}{&>hymagZjkAF=c`6eRR zwkXnm82tu|b69+N{C3kLhswNIh}P^kWqM8CT9`-$M9_wj%URAn2oMRKDmNbh6i$ar z1RNdNya=p{0yKV_Dl_eg)AzBo4P_<4Upu}=ZKR=c**BcJ&swY@cL)4xJVdbr+;WS{ zCD*Ds9L~$!3z_>XHE^)u6#Bo9r&@`BO|3HAePHn0W-ZP1;!`TSzj@c-fakEgN2rG` zCMk(ctjG~s5#v(3XF0Aa5(i_1{VSTK75mH4UAANWpGpIK4cvn$0qpM0Mo5XM)Kx^k z|N1G!z9Q$D;`V%)lX<;NfwFfLnm4RQOAKnjLM2*<^B!J>yNBVzsk~Ozp(3yu(|u=S z;%b6riZKVnC+0t~?)0n93gLOHpX&B-2yGHy%{OfB6`S@hv==e6MBmPcq{4SeU0gD* zdReHH>U}&3D51^ub*U%40|Vh#&;ZsYa|&)=0KnXvB9N&3SjguB)MY|fe~o*fS|eK7 zShJNo#R#fIQrCLLumO=+-{BT`wYfIEQhLRBe*=B0;QQD0{k zl27wTSlS~AdJYRK(s{j$<8eC)Va;;9>DgKN8tXX!r$FCjX`RqM_HnNOE6tMZEqs&- zsWYfX=+?MdNuMQls2vw~ZKQc!iKI4#C$wWCoT|*HKH&Y6nvn4l7RC_0;dHRhX*KDt zL%WBvQ9I%@PqQVI)qHW&l-&M64KSlN=dlDRk3dFOpYuzVO5$muUZa+r<6MKg`9R8c zSqPgs-GC1N`%635pONkXCs8TmyJMNpwGU8BPS=Fq#MMe_vr$vvy`XEwvvdACnlWHA zR$9(}eqwP`0)wew=q&tS;qW4!{(nlX~$+` zzT$(aSjdN#Q8?JxKXdcgst-e&qV9UUwDC|r@nH!Y)%;?f9a4XE^U4ZBM^jXer*T|s zGTwh4_}J%`$PeVr_&@RgZi4NIsPkx!9W7;ru!yxk^cKf-`p}G(GKKeE_EyZnOm$cy zRh0iBX2J1v!ae_!IH_#sHXM!Id~0YvWgMEuY#5!|(JnEZ2;IKqE_n=FkZV~S)VwB4 zl6X|yR~DC%X>qH5^z zq`qHM?;4y=;e?x2siJ6_6ibb?&X+W|YUuh0IpC>AIg^lTo_X_^^8dbkkj4z!c`<(G z4b3)p`1Ae>b2)>}@!ztDu|JevbRE&EVtiiWU@0O^z^Zl`XZ#9^C`@!TkS=MIgJl>` z4r^z~Re!DxzU(epvc&Q1x5)YP(>OeGV}EZCpg#R-8oFX0J*}-vhwCE(>!H#9<gTc}N5rIFBd6SVfGo|Y&M?==YVIViZ7oYBgNtW0{aRL6pZCx5AZR(s+Omi2U_?Z@NMvPO>NkcN9cnGg{h452~E@N256>1oiJfGpE?Xw;HH zK*fA|P(u6qX7XsbPgXmtfWMmEirYlVIY*y^R{nOw{VMCk7~;4_j}3}`{fC$ z4{!6Xv;^0f%L~ZNFO=6xZi;E{oD+-wWWHXLH!gbRUKaaQ)0kBe1Iuovq=#f%IXegE zJ~i3W8+u_PLZg%h>z;zdUi6bz%`mJCt#GFm)o6w7s) zHkCj07VOqoZQ^oHUt>cY-IsL&zrWr(3tnh3l-#iQCr|?*{=e~z-sK^2 z>fYgUmA6Z=*6j|N-^<3s9b^0xnO3Txm@aueqAHh8ZZ~^jJ0d@sv0PBwfIy3>NTUd( z9Ry*Vb?TY2-Q2JgRu=WI?l((n(CneH;e!%dC}6p#{Ewa2r<2}(sf3^`VU`VH#>TpO z@})wl@35try<6&E=}dGzcsun3?h3im3kwSi?nHP@jV5S&xU3Y&r<8L%;ZV!r+2!z5G3=>G%3m2ip=`KUiEp;e`4OJRZC3{_c4I+_jX<{RW&Dmi zk*t4_p@z1$?%>Ic$y@!-67S?Fsi4NHRrK`9bS@@zzA~g%V3F_6nqc0h|2#dGjqrWR3u>CB&srl5 zSMM_Y$^FsfpqPFsyslG8zuZsEtDQ{wRPt5+&KvA#jZ0@HSJ{Bno!{7KIy1alnbyVB zPEUus>CC@+L{nyf=06yt{=&}1VeQ44l$MoSPrxggq&}g0Xwvnu?&h$`y&w;ez$P(C zBRBhTpjIjJew$pt?Z~YkTCY^5mzFz@gMJVE(KKbZ4WVi7SY=w~QQr9I+5hJ|^Ywe( z8elwiKIBlUwqX%akfA=ZxS7i8g?%2uWQoI7xbl$p`u$8}mWMx!e9)8_ugwCPAQVo9 zxvxFL#M5*7x`;KkK$oS(?^PocGAwjyH_KZ#hPfZA$SYXRdzw4`Gn;v7XST<4p7oe* zJQe*ZzGu;6-VB8)rC>}|{q{(Y!D^A$mqjx|IaXzIFTHvQDDnx9KSsvc-^0pDsLx0? zO{)DIaV}Wz{rlCB40Zwf%9El(2kHTimsDAdK9*ASoN`buX8qv;&-09{VY4$Z!hS7O z)DDcpYjuRM|MO>?6Qk}cj%HtD*M!UF;o}ijw+}TY49!1In)`6Oj#iZzYZ7wIhuVkh zYiy@$Qrqw=HSY*&k7ecR#@KErQF-C)CNM03uEQa)B96b;M0vFRFEW(>*Ur;kRv7i| zuY}sXlOjk}wY8D%=#7&%aK*UE^@pj_Qs0G3f$aXj8-xNP<>!HPjJv~e_K3*&GsE1G z!sGUN?18;uX6|g^vVFK3h}b-3tjb(!tR2%pGF7O`#3jw8Tat{?=Lrwi9kU%)thXXN z%r_V*b{P93iz8&Z{>l8@Uc$zyZw#3ZS=qp;S=D@4Zz8CotUG~!!X!4rWjnj%FwN9v z*Jl{bwDUa0$)zyQ>K%gzW1Q7fb**7KUtvd2;NBMZC(kV*+_fQ$-s~%cPXCd z8i)9Vby*bpmwa44WkXSUd3yS2CPZBvJp1uS7&%y8(X6v6?^>4i8qy*m!0**PiRuR+WS(kng=fRB3-XXfl5lmB5q3LLh}- zk(Wg$$y4<6n>YCxQxZBW(Zdd`Ubu+R{rIE(vQ9VVv(8lB*B%1=>Jy^Wl-J*$`8Y?t zGUCgIba7iY+MR>m-pWk9ky<`Ebb729m(fKqLJ}b>o;kNDSqz`GH*S%9!d9i;OK7mK z6Z=XmG&lVW>VB{~xg9y+?)Y>y8>=Qw^?vsM>tm}0zY#keUQz@qMmyjHw)hABp)Ea& z_xP%A(ZfBhg9>-K5FYS@uom>loZc+N=UC0YQglZ_A==G>^{?*T@*%ADBd#D=g+zF+NR zmCvMBOuHw(OlBQZD@k7f>3?efL)RAr9}b-+PYQp3*nGAA_}I4eD2Agq6mo8$7Oj?) zm+$ZIuUZez+u}?4%w~|*S-^4WyDXr>6+u}fW6{Y?@^Q1IH*U&vr(-Pal0o)snR2@& zWhI&NgxnJvHz}2h_r6QE&YUSC0p8}0gbIYKAPc*h;Q|l z-=HPTi|EjM$TIB~Bd6WoC27?AVs=m&!t>Ih;Hy(iH_pep*`AP%%=@Y9C4EN7FLFLu z-vC9p0|J=;is&|qpXa~F_%hwV7F*f>St3Rkyq2FHZeOGmFqkJES?vxFaO(DFk$)|8 z{rfyC0P`wHA|bDW`DF1|d8Y3uN04!e!8Dc?RN+f(=N==C>F0SIQjnY$Sbfo zSA-*D=Wh?k`y=BHmsTViZ#3)o233#~+%% zkGmTPC{}Iq3V190bqao!IxfkMBP;8|Ms9nO``9%_u_D<%D^{(4rj|g>Z=YhdwJX)t zhRbWGQICFwY5UozjveLFS=yOM`{d7n+VaWQfSE|M(}Oz%0~G@5>rnkG8HH=10q@r6 z#dW)Z>#;s6u>{q)dns^tAe%w`NlV8vPHmf?{(^8|kxTycu$d3zs@S@|5bb@aP6L72 zPY(eLe#Mi$H=mwS^p$=>cOd>;NbN#K?5vTM7pcqcpgwFwcV zn0k-bWbkrP*ZAxkAJj^%awBu(PjhtNM3;uLzZ>|gOoq17IYXjgDo^f;$>l0FDrOQ5 zrd41~AzuCe`ljb&w1KR&+y70juu9+?aXf@?yu#7Vf-cRMh>q|;K0}SgNivsO!DrsH z{hmt!1thNZ#W|;8oTOlmHQVI-!^pZKXO5loSobwYtegW32f_ucxE z_SYN3sg3>3hf?#Oy@%bt{BuVSDy#owP(JzDhH%-mg&R^>VV7m-kSFt9 z=N`dR!rhIikWHx+QT08Vnx=t*WSW{@HKYfPS1d)BvPZ-`Gqs|t?4PDEqY`C|cqi*9 z)-(H;#$W$7ct+e|Z<5r-x9x5_DyZZeS7*zxMAS_e??jrkA62a$kqRUr`!)A z?x&>u`K!%o(NX>J@abC~?fS!=$4gy}e1hdK#PeQhxG}i?9ib1<>i!kCX5-$g+r7(u zR4QQZwtUg!%VPU%z4Q7j=AhciC3oCr^My#sS?4h3zQZV*=ik?MNDlg##mFesPMc1BHX8|X9(J!N?erdfQ-hCyQ+dzZgf zuGJyFFcq#`yTu3mjHIFO7$|->90a4LY}DF$($q?m=J9!vN5Xc+ZQqJmYOvA*sN#)a zS63GtzAkPorq`e6hrZVLUg|lJd?k^h4i~oYz-s-kp5Z=UW%etb~ zMOXZ&rBAP4qI=XQ9)GEQx5c4bb9&A~G#2~IVsW6@sKoZ>xHI!DCpR=#oVxM=gfotJ z5_0jWKm90Or?yIG>;K%y=jci<<93M^@Kh!J;rq}=yW_4!Hnq0CF6O_PUY*Z$Wf;t_ zb1`hC#^aMZG6T%>Ymk5I>~41uYqaCf=XFihkVR=+te+^$So-W}kJ~y3*7Nij>Iemv zCZj%*EhCNDAd#xZIdSOv4`a~JQsk#3N4>(xb%DZ;H$OJzS2+N2HH)+XG%(Vk@_$7oX>KJjt;^48fN}y`vNOpeDi(zzOnWn=Gdm{ zQ|-E@nM`=;TFnoU!I^@d+vu zM`XA}YCYvy0}nIBF5U3i#}=8?*N!qej+vG8kDe^Lr9~4w4wcnP^^F!;c}Yw+78*z} zo7}FuCD6fg7X=L~ve8vSXv4c)VQN4%h0ll`k4)gb<=cQN$xpMbv!SY`|NO@H6zjWg zcCCLFJLJihWasi~r!@cMWelAp{VL{|BC~W@bd(ncA&N=Mo+t)iC$XXPz9{lBP`a7|~<1TN}w#O?Rh zKA}@9ai2-FWxUlnH4R1hilq7%%tinE2p+RU!-l}#jP++7 zopRydyKZ;?)M|D1{qIi2t{;kapsSV0!KP*_Fd(OM`?k7$>HA(uOY&F{6+1Eg8*!zOSAUjnx%HfhsfYr9g@Xpve5c?KC&SVv^ z9lk)*$mcCpdzODg6`i5oweo)-G1$XQ&9iI%!{QZY*ccRGIIR8{4_CN6K8ru=HEc@3W|LZ)ei?tm$e8n(?7b(W#8AyUVmomD;MiEw38&-Z&PoJm3o8Z zJ575&?!4RWY0{!`8Y!1^zW3XSD?nOgvArR0b>ocp0BuOanF6E->Xc6eoix8n=g$in z+B{p&(|0=D5NtkGPB<8qINJF{X>xy&Qhoq|z6Dx-0uljN79 z8@_hM-SyL&+?%UQSaHIWxGJ&h6SU-4fqu$o8tora7mQUsS+Eh9hS6;DDUsqaz_OWN z$@eAf@*d!X`*e?WV7sJlxD7tV{kMxM)gjw}`Iy%aPdfU8s%esUkzd!*y{uhy9ihBp z0?FS>wvpHREC2i2n-Ua9c#2x$*H@Z!fE@KsewpZcynBmD8i78~J)8UG^5{(5H}R~?3O@ zyj020;Z<=Z=J*mu@KDVRxPE|&&QBV>U0s$oHZQsmwV(_Sh=^>;C$dd}SX2>hKLk3z zN(E)0BbD)Z@*r*H8zff;0Q0o<0M1dYAQlegKq>tXI&FB?4ifS!2#xYRdsddA4ENt z78DInZ)xG0%)kKtJ&!Qty<2w3^huHMr2H#p6!Eb4Z$C+w^xS#o$_>G`Jleb1>rcHV z1-7y*ItqfW>BqJ)^HRTy{-82`+1fQ%_#YC9nUCzGUVXJx(kz7C2x=v|m33pNS4w>u z{k1!Z;q<2oG^3vuxWLHO>u( zHur|ZB`NcDnyVJlzXr}BQ3z4UT;|zhGITtGq6_}{eqxRM5Q@sx<_Hact(f~U=0=wrF5++)VWL$*hVPx?D6EJdA#I4 z=Lpv={`pP7{M}Xt+wqUrX?`c|=AZQzUr#JGoDAPJ8i~f`EoPNImE@HbZBJ;Bzz45j zLg0vM^&O{t_2HV<)LjyfIDs;(rt%>|ltLgEv@sDI17-r6ie#<+K}FP2VZdSX#<=C? zCp^j&lZ%1=g8}F!+z|sp4pZPAJ}e6gl>6^27Ul1MRX(w+#5-oDN5j+<i-M%Nb72L{c$%^a-xQ{NIU*aX5HgsR!lI1 z&C_8owS24*#;1K}QD(JifJ+_)jrjX}pyDw+1SEvEwslDXfbNza{;LJnYX`6AAz|my z{*sc?8NLh3X3jK;8ND@%Pu?b{j8IX0BUP-pklkdQSOxt5E#5HFD=qdpH#riod4YMd1+8x-Je z+R`d96h~PunJf0=Ws?NrcJKcu=Lmrg;l``1tOP9mahyGFYpvanU{d-fltN4zK@Hvv z$p{>;d`pzSd;o|Iz$jF0q~*JS|JD2;kgihPpa|1xf)ZcOtZ)JVtiZ{JGvXsH=!AlT z9B$#SR>7(FLHY#`*a1Wl_Ot&}h}3T{s)U7*IIpQ_Ya{SP4hZ@|DX8xo`2R}}Gaz;c zoOb_E6fUK=ZzE)gC?3y2iUf55N=grdZoxxcJN{u_9{x+ST09^n-BlbH2dfFaT?}Or z9I@(vxgIFS;%uTtoQ+A2Lr`?9pQL=esuic@DCUM>Nte^%(Z3Kb{Qu+*~R}%nl2olo+#MWqpZW@P2M~w9Jj@#2A z5NSJ0XZ7UtPpCq+wX59toFBl(1b#N1Gw|8yGUO7{rg)w_ZrWC!Vy{& zM5%dca{$!mgAUXoFtMnlCz50B;;;ef`Sv?Ac(^8IGU7ziq=K z{2CGXG~O-pAYt+D9~24wY3540>|nN8$_e8ty$m^!8HsA{0`K6 zD`FJO!Jn|VXX(CKg9P#);FkY;)XZ{h+^0_g4$!IL4lItQrY0ahK#L)K6rEHkmW7Fm zLAvqHG|g2DctG1lpAk0IM$XB}2^yQ+pErP8eIFk|680Of#K4TK_}>B#<_wy90H3M0 zG$8on$8VwT*l9H$waj;Pq7VUVUffNvD@vfeP2M7BHAf*NV=;+{^4bA|J z^~6MVZ7qH{CQR$Z3tl!rMFK`CBq+!)oBoCe>QnMz(f)WxJQ6F!QhHXL?~wK@#L~`= zW-P4#?w}e>9*AKS{|$t}ecwqZMm6b@>2qQt zfE)g>|C{%Zh-VMnTYCh<$n<8yAN&Ly!5Y~TSwqA0``XQ$xZF)hk7co9sn`Q$ zq9W8#lhEGy_T;c}b$eU)<;#y5h;3Q>F*MZK1(nXSJks>qgxRGc)QhhKOJJfe`RQRsK=go54Xv3+VrWc&#K;e+aUfRZWc)f-d<-eoxN<-D(FJ|U1o91`t-e(44vr?;U|e=lQ4@#^)B1*+5s*Df~*60ZdP4ux>=t6 zJ1=D5R83XcYA0yRN=bb!EAwj~`h}V&{)bI?!`{IG%!{$0;u30}DwBSbPFJcMv5-$g zUfxsoFbs`Q`9~yA7dJMvx)k(PnFmFd56DNkpVK7*QgI0K|u^4pOZF-R@D6v z8k)@K%5;z(Fj8hJ<8xn20Gh*z24Z+$o^h1>!K>zURoPAtK90{d+W+0v@LPog$m(k| zwQPhrpV5#psNzo3NMasB(DG0Q6^RAof+Q2RFdRd@N%~LktCD0)d@pIr4>tG#7@+s;0i4%W^pDWw{xATv%x6vRvK9SP(Sci#b&^ zzKe;eUutmkAU&znA+vo9TfIo@h$0WaQ1ffcj~`jy=g07V9KV^b4@VSIWtD(+=L_Jv zQ(V2!<@4R<`6^q&gSQW?X0C6^oy#b*K@ZM4pG%L>v!2wb_RH$uDSx3+mZtUIJuJkW zhMto(xb68R2!~RQkdqY@Lfy}Z1N zv?>AJ9+QbrNEjFp5VQ^)BS!5iG%Was&0v~H^{ZKEnYs$hqHGzwhlVFRv!R4skXs;x zj-|j!`($+7LF)S>1J>D{+qX?kOkjJ^_B=^%k5mYUsRZ$3Ox5Ah<^=O;ZAbNYfLc6z zruZ2#7jm+)Yu$)9k~4uuiLXoG`?NGQlZ1SIKz9h%2XJfmhIVFZks6^d=KM47>nm?r z=+?S8lqmrWK$zMm{ht`M(a_O@gM(A~-Hpu5s(_3F0B2A>J|?_1J39;d*-(pkSb0nv zhs@0v4&#L{`H?wvmh|GtFv0IPR6AbR4fQv-`B^H`yRy0})BkoIx;O|<9jSxObKaTZ zVPR3~%}^FQ2AlTGJlB4-=JV|{N1!?eVi2=Fd-fpc&g8~my1zp&%+6Szio^`g<>_iF z2Rl2E`{a{(Z>Nf8(l6@NyuMiun&Ux^T=G%dzkhyJn#d-wiv4(j49$ z4vd_ni?1Z?lF;YO4Bm^pT~K`c?K+EbJ2c(8sQ%5ujO?)1;7Z2G*f%uvP%vf$i2Cp1?-ij6_$Hb`W=p=pq927 zbwHZ#H7u}~vECjH9!K|L(ZWh%W5;UjmlTl<#)pO?t5tgLveLn!4`xzNn1tW$&HP&= zlq#Fa;mOH_+8409$GAxZz1)7a+?Gw^cYoAuAu;rIWO&#wbbVuE>gUh2>cBtHhII`B zl(jY46n^~J61V1bwF32ET*j!JI|VQoXPYI>Kej5ZC$y?xp>MN6ky#`89&|4@bT)E) zM}PtY_X7nRcHLlaImx-I2ny!W8!!%GWxx~k@YX2NGp%Zfy%!i5m>Ba$k9~@7Z||XM z`4gGbPe@=@B(9hNW&<`=k;xs=CO1akn-&uo*5RZ=X2r@&zb9~@*;^Jhinl*35`*Uz z3WXhlYOe=@?bxOi;3%6anC!lf0rY!JB5uXs>5YxviJZ1CKKbmm;d%AEh54d*N1%ZZ z?oIkHdncy`=(eZ@eTH2tgi+TA(~&m6D*QEy0uT9h7@QnUza_-y5ZzF3BHdxPof`d( zUR+%Kf1e`tLR>s(CC72KA8h;EE)L6K6EG<7I)+WBD~N)X&KW=m#S`uhKqFBiBBCGO z8?bs07*PiE_t^4<3ShWr}ClqLBe|JT{4EJsUnffnUOj5z5mr8GKX6q_p z-_uG1Mz$CI|NKQ3z?Gebl833Lr$ks`QJe8cQ{T^nc zA=vXsNJv7t?Rk^D>Fu$B!2QMe_2;ey)Er~x$R(P+diBb};wLx-K-8ssH&gFAFgJGv zMJW!AguG4`CMJ{|#m~7NS3g298Nq2g zMT?9Zr}()b?`4*QGlw=aP4{_bX$*nJZTcEg-wS)wHWtH{cd?}Y($+=Re(k`FJX{+> zQVt^_rZb5p4<+C@`xQuOEX(r2-UBT zCiI0o4kceMf&Wz+dk39hv_QiS8jKI53Tc!(1I!X^X0WB|_|HJ&jW z1dhDfS>5F;SR`TX-na0BeMLeG9_-9D278e4@@mPUu8kE;K=b0ZLl~dl-d@-o?TPs~ zZKZ~-I=Z?n_6I9+QcHS`9ys{;AL%@R9GqJr){CfK*`BI|V_W7EL!`Bnjm=gFK3hX$ zBbUujvga5?+;0e`2L^U0^nG#2CAXm=ISj(c7rE&QODs@zbHhmNcw5dl3EbQM_7+LW zS^DkbEk53QTFbRma^&|eK&$dR*&${zLSCG2^450XfR1D;DkI?R!(sR+m@+TQIw>cI zh6sakex}wDh~#jUF=pcpJ&&P_kI__LANoVZ6_(IC!nvwfvvsc1q*gl46E$>4kI>*} zh0)&xaq;lDLpyNpLO89_2{~hS66gYN{Ji1eWON1&mc-c2Eu8Deo{axj64OuyNO zR_V^2JJ9W3-B$$%eD)`-hw{VJSXj}pWIwz_K?#KOhTcL4QsATLm8GcFm6gseF6!k+ z;I7O_Ji(>CCuFiL9t7vDzem$~}5#_X-LnCwpUk6-SMO}zgDIW9*)wx7q zVqXA()M}=l*bfDhBn`JnB?rStX;RSR5Y-;q6#IFJV~EBf7B)%E^Cy~h#vK^4IRdFmAdJBEV5Ltyl)!m+j=0YS5)m7hZ{FNse>7TS zm2dC3(knvs`tKh@>{IYgC4VUff|1W;NEPr@H~rvthXOo~krAxQ=!z$YE$!`hWYSSv z2y^Z2JW<1l`2rgHIy;4*vT<^fJTtg)t1T4cBLoNJ56*A^2fnithW+E0@B-|QS%{@h z`PxuL)EK^8pRSVX>dwZ}YalG3=I!ne-@q%B&1}{smxusUy|n6k&Fp)z7YGTg?v%22 z2*Y{!_+ZNo4h%4}v#W-3hLQ^DVXK~Ir21arzon1}L-TAs-ku(_BhK~!2Mz`Y>JklL z)u@LD1z8Pebq#0B%)9&M+Jik$`wQm~bV9S>kBNhR;C91VQYty}0$@N7DNUW64x#IM zj%7tKtQn z)*_mkt`G~=1cFJig)ef6rIhhsw81r2QiLpaFCiujhslL z;=ZBAy0HgJQ%@bxqw!52@I=##d2UY;Gri)mo?@l+xH)pZW+N#$S-oG8NM%(`_T zgu*2y4fiK}^eBVKw&mSji+7M6w*OICQ30(MAO3{+HR(C{-VjYa(y)IZ!b_UwWKjT~ zHqie9&F;(vytFhQ6f|@`d{Bzp->C0%YP#B=EFvNTiCZQnrfw3cP)~D&*Kt^aLBjt* z{BmQgz@mjzz~d0SUwk&Rg$J~O3uzy4l*ATFTYhKpxkB#fHJEqLC5wHWKvzEG&N;)@ zfbSU)^$k7rqi5D@(ELmE`3=2B@wYi>NBp{f_4jYG>mhGxd3o^^nQ*#{p4l`JB&Sq3 zXQ1uNL%$~@c`7uNAI8Yt5!-=Gnu?QB{rkAmBHae6G92L?8cPeJKru(OIX=~?cVP^o ztur-xD9vgHv}H(V`krrd$wIESEFpqjtoEk2Ln%3NT?Awy~SYGkE_qW8R^OLcW6i_!UfWIIa$)rUFyG zZp(rYJ0sopTcn({^dpU}!9Qu(nZG)I0Dg0bLBM?<*}M(>Nx}mgM+w!_$}e13bwfx%+Qb9{6F%vt9KwqXu8;!Nva#I3A)vBE1Lvs@DLJ5*qXoj zNAYcW4t056Xeq7vxjEeb*7@G#!|Lx``&}2*KlgP--9`39n(>^=YT8|v+R;A{v?%$J zX>+eW{8^;U^^VUo3|cHib!@$mDZ5@3x_;>T4Z_L_Y2oGYCn4X!H<3yW zdHXwkO>OjH7Pv}Q#qDt1$Pm0pmx`uF7`r(mB@d6fnj6%woH8h=y0f4RDow=yL6cb@ zLAuETpWIBnMLCj0raj{WQlBPbqSx{G32L~9R z^9D8sZyhr8yjRZ(!fRpD`GzcSR)PQEMTLUm%~LEP@IoS^0FEuz2?cCf4+>3adqVhXuHhrK^m2y-oCTEV&(q(BepDM|3i=B^HTGMuN{k0`evpO-w*Bel(<5z- z@b1ez0^z^;oNV`j$`vcho9)2$u;;e*9!ZX{%*4yBzP9Lga0X|Y#M4^RJ7i)BTW zcb7neF%2f{ugy%3sQVp<>~^)u#C&kcj*gGR!omU~ph^`Se>ML5w+UOfpllpq@;@AH zAl~Wi?-xh;HaDjiLa@5CBM32MB*vqM8eVVzDtCc@-nIn}8N#9skaKWU0u=l$9Jz=r zhmp}DjBQ0_<UGBk)Z(*3Ym#AOG*@(6!@K9aA(pw9Sz z{&enj@Q2I4oGVVkDesR1qYSQM>k*hyNp=*Ypiw~LO`A>2xH$E8np2BwTv>+o+y!;a zRk^4s#8b$ilz^Z5`nO`CwjY`lucl!jop5!Xe=xAxb|cXC>$bKRuU_4t*{z^(+)Ii* z=5tLL3%D83e0+M;H8j_pL+b>VWP2{IKJMmLfxO+=d=lqt?kJxI^|*3VSdOBUIiN+N zc<~yEjgR-9nXuctw*oa|_PUS{&quEEDv2AUYe({eWHHm(R23ADip4mT^TE&2Pfwly zIN-1g8^wQ|Kc08yUd&ENcn3&V_y`-u>0_ysv_EoOTqeNx%bT(;2Q_&PE*B5l%Qu=N zsFpWyDJf?IT3uUTzvjZ5V)gjht#shPOE6zq9rA!Iz3noiX6q(OE;I7HM+!VUEkrk* zWqJ6uObbTjCjy!{wxv=}5M+aS%+lbC_D2lvCxQ%{_kerNygJS0EN2 zF0yC1j@Kye_^~Q@J;W4XIhWA71%ns={IM~uZlADjEXLn>K0{AWzxeCUl8(^HtQRAY z&alFTlsB@bmFVshSb88fmd-FQ*Ap+Bj;R`INzSaF7jWTaqy`M zW&pa;ZdQA^mYy@&SV&Px$>C*Ua6?ty0BH(TUh0btjEuMC+<5gb185740ls;;yE_6$ zAzxkPR*-h>k_0yvP10u@zI}{LCS#C3&U=-_r8Agt?>XZN!J&9RiWT~g+tUw#ze0oy zsSaDEBux2GeqoRChf=cb%f}>|Mc}|v(^t2Z^qTymHD_mM0n3mjwe}CR2U4%E5tOx{ zoK$UdxA|OITT>(YvFf1wJp$Zp$tR1N_v=NK+Z}#^A>b)Oi?{hcipOB@jLWrA(n2~# zDc{;N*6;r9c&BD86I`fYh|&9wB7h*Nk=3&Kiplq@V0XE~dz@;mB*M^s z2M32V1;jnk1O4bh#(K=m&Aoa1_I4*reSO9bVs5cu=B-;tBYBl#f0myFCt2gaIR6-l zLqG1!kN4|%YP6ztPMzA`zDe1)G<0dKS3O9G`f)T4V31JcI{W9lMOX8jqVT~3vW$lg zAFg`TF|hYRLrsmwIfe{u9MStrCen>LiT5r`0O0i>y76bTpj(b{zjIVw%Icu2E%P(K zY8_K>S7B&LPd?abN_~(uH~B%#-7paby`Mc51%9syWKzfxS;SwCGf2Rx#_mWpZMe;? z?0d-bH89HXaoGd?=|xnpQSAc-yb2MnZ z1M<+F!i8dmv`(k8=~@6cQ0&X*W@Hu~Zf+u&<)zv)w;U;Ek~har9|IFEv}Q{R2n=r~ zhmI_x9eP?lfoDSNFJ|iBnw_6HT{sHf^5dsZZDag)NeQwR{c8ZGwaZf`x9zl)8Oa)I z)yI=4m7y?^Xrf+)?nQ;1LdH9+SwkgPejEr`{KNUss!(PjjPh4>Y)wYlcCQ4ifXIQw zWZfI1?Tr;_ZGbL#usLn=r%#{0hfQ;*sUpZ&U1l_L?;_Mm+AQMP5%jDLIP%yjq)lahIxd6TScB2%9}~ zs4erRO%|DTDGg}`qWQno(L(z)gw0IZ2xXq+a3j;j)5kQ|uV2r7jv#8-c_TFlL}Zc0 znOT7nVc51--T;{+O{<>?Z`v3N2qIG|U5)~23ZcF_BWf?8fmzHFUBZ{4p)Mc_>7v8u z{xI@v@od(pYm6~o4kVVfj+Wlu-k@HLZUYf~eR=b4roZ*! zli#ZL>rI8ff3SP{uXhf22tto7mt4~Qxvx*~^8S}NgnCn`jo_^)NBdSD;|f}pDu_wj z^S@?)*M`sFxEGFN9FD~^z3%c6B&zd75gF=4BIxO#NFSh#kT`miw;p|BdZ09@qGB&q zbU^#fE6y^E$>nh}j75M{n&OgF)7Kpna8_*(L1lR(EbG zhJ=`906O^;(3rbET1eYQ%+;!_?sy+0udLKt;Ik!)@8s0Uo_znCm}qmA=Lm|J#jVl~ zsAp}QoMs}o=783?TJ__@Bj!!{ms=ud?_GY41ja1ugM+~mO^feFDF)A*|L4gi;ZP#| zazgXtl%jIrY;V!<1vd-{LDGGdSKvz8#j`b&Rn!dTeQ+A#$1W!~)T{ij61fq`hMzL*{f|%4C zk?znPH~c1#D@S^UT9Mnu=uYU*SI5P+t`ZnqJNyJ1`sLDYk3`0nrZR({@uJUu1{9WY9-{p(>O zpz~0tL%g-AU7G*8x1GFWTQ2#;krL-%cBWn|003FjmXpED@WX7Zh>Rn5`tmCh7t1`7 z6Rpat4w%KQyS|j^ylvCa&N%Jc&e>{|I+#@jtFQrBt7(2`ZS8a?+Ukq@#BBO9nRes{m#&ytw)JTJnm_O>F=z{ zJ%;8Y%5-{T5EtnVPlu4{v-AT4e@Ue8NHY>W!)p zr&ym4%NHG&LYC(d*gj+zeq#iObz!#@aA#%SC`cxYvuv$ELtxiOpG$%3uZtKAaSb-c zOWTE?qp%cQOGy$9dWF~8i#@q~18H?(a$npNQ?@-PDpyVU_ZtAPet(h5vyWaA9{2Pq zKzB)Pb}*GFTU~SWevCH8ajbE66bPmd>f&ZxEjtMj#H6DX2bnoIe1)<*J2QiWks4+7 z?Ut+*3=izEo?)YjTX*o5Id?l~vE%d8<8-}_^Q|(<=l@)Jg{no|upgitNG9-fCbnOn zP%5pqTMnu;B%FA*R|?-hJTkav{5}VWRhOc4};_ z(&@_S9SRCFKvP}Y34Ov;8ik2x?sCRTCeKa%l*j-ofb zbF9`8~wEdH-M$O~$r!69enc z*))!$Y#n&ChyV^%t|p>zF#Vjy$@;LCT>^!Hib*pIriYX)_ba# z)~bquEJ%BRD15h~*s6TqM#bqHAM!-;8aHKL5z zr!3Y-jk{$wH{(>f_fc@9`KI5a>p`K48oxT19Aw__P0-F>vWx=*1EF^v_>Z{n7+zl{ zJ~x%&HLLe+uxZEI*oXPL6euc?3Cv--RMuz;IvT8;vriELN?w{oO|WIs9ekCO5u)GSHuJkUvJ`z_qpZ)1jfqeO4;Ae}7V$hk`TA&K<0x z(Or7Acj+FT|1bQxKDXWS(6d*CNeb2rfR!{`_b7a4P0f$hXA3rLruiw7y@g6%izK(OHHWm+pdW6dK zW7&E02(6b&-7vxf%;Hv4<$L+?sl;u^XE3LsM) z=PT8Ux7Yus1`awTZY9Ka#I>iqZ2AyKYkT{(wGU!<-ObGfnc9OB)tHq553yB(r?$Mw zKbnh|@#WS!N5O}Eqocf_4i))1iG`^wMNyy3Fcd@7zE?ck`24x*y})q2+YLzyr|;Uddps2^Gu?4- z?`dSd6i@v2x30ppVujPEf1z|Z=j|ODn3$9_Kk?E5JqgNN4c@>|Q(LR~vf>EJwl`16 z{cD4-U>)RcCx!5GkUpI~@(3gpJm1mM1X9E8g$`pjQ<_>ljsuCOL`1OUCYN8^5_oD$ zs*>;Y{o=fN0L(15mC`ztgjs4oq4hXd8OaGgM?KldLQufxa%2abEzOiO2}qYsntB-7 z)zmL>PlDq?`!zGh9g%eme9D%f!B9RL>v(#~=${?F^_q^)<~byy*8rQQ3CX^Pntzth z>60FFUpP4QWvDGJBOWY3)H4*8*)wN*{FjuB4LQ@}42cMoK`ziW++?+=5 z36|}t;6^=5c^8~d05ttij7n%k#QLCp;V27wo_Kvj6$=N=-AQQHV0*CEAQoBOKNi4x)tSMI$62z&4?@>LmP4kd1K++yM4g))flFcm zuaFkL80Bz<@Lf3?o*#6NaIm*S;f%~6XZ13#+GE|~F6l9#GhcudzHj8>QkJ{+WSWcR zOGV;^ex!@r9{9^^X>kEE|8Dos|ESrwB!!*E7@h+f7oVs$1UdDZY9%Ddxmke%W~y&# zVWgU>-mq6Co$0_vY0oeF4;)xcMMaRf8tT4$6!dIdE!VEP<9}g_NHPjgxtNhe>efayIttskR z+~{BFSmOtOkYjBdpZdwmivxJc%%S2`JT0hj_`d+B>K-`@{X=w7{N_At1nFh)Atoyx z@B<~ZqmgsZnS19btHCIS?nH64cWJ&zvA4@V2+F&5Ghv8Wy_P=9xj??7c{vnhx0WKR za*K;p+&DYf$o8TPDXSniS7KmYCiPL4DVhHMer5*z0zAqQvhzrlib!nA%YM7CB%Yk%i6Vdo;5hbY(X^Bp(A>@Txf>>l-r!n;z16Sq? z%Ce*odR4Q~rC@!5KD`Jq2S%#={#Mto*arCLi15rDFk?MWw+YdED&RIny(!#SdAW<`)1DcWaEZbha5iIdZF zs8zN1$Y#)6Am69^vo1*nNY6YtvBpe7xF*^mmITjhJ&Ap8HVZ67tJ_pdnh2(6r-g z!%l(X+b&jCR2O#kG(a8`2gjDOHT>?Lo-mVdy<3MP32nX7GnuYR(;r~%S2F!xL`Gd) zxn}Wjf}ELAF%yg0R%`KMFD%|rka{9ig?E^BX{%QpAAD;4V;tw8i=*}g#eC1Y!m4}V z60$+phYv!npFWips~BCEDjR2LH)9{H?==&dX0|3ronDyrI(hO3fN0#N?W2!eyPs`3 zqQPR=SdQle<^v zw;f(1XwbS-U5=xyPMS+^<#h?j=qnDFocyqBKh)bh@$3ew`{qIGfxc8bAm}DP7=T!< zE_QInm#DVWbLB@^?$MEG426(n;x;XgbV@Xbk4Q*MKfpVoC=p>VDYZ^j7LI?gBmafh zPL4s4L3J(nT_0t;Zr#r>gJ@e0nH6+kvMQ)S_K4Z3pVkFdWl>R4Ft;-cY4Hc+w#Bya z0^I&O^jJZahB+Gv8k?Ch6_)FN!K&AK_KxOKTGKM%69-# zCT`|njiZN*i2Wa{TTL{KyVQekY+FWfmf*g2oA;?LB3{k@`4KUUowD8}L7r^m>gtN} zxXNfw>B6k39lv1OQkV$$CBOD*hW_YBFdysOKgjaXI zpOcx%3b`rcB&hU#$EFR=pOJ(Y05gGa)d#>7eS9z6#epKRxl%+^4pQ z2_Rc$I{~uOjkxubxL78^vd$FV@il9gVQTJ} zL%&ueZ=M-d;)!vo1~`a|TaAB&v-k&=HK5*=fmqlE;4F+ft8Dror|ptM4*#va_#siQeF4rr#RE#BnFe z9w(Q3tVy~x^iHS1f+pOw2td48=fnG%#rA>N>`^>FZgaCj7qB zAGMqU`q=bM!=}w>fiJIhpV)fxlkPurBD*Uaf67(BO z$X7923_z2i7G|r{%;NsHJox;PaF0l|EV0R4jN2+*(fEro{Hp90mBe{(*sXZcxue;Sd~9p}f1DcVyX+ zx%J4y?-z_EUezbm_7;_tu+=l()Oz!x$Max<6AIwO942dz=i==*X4Wj17Z(^WleUcg z{;hcW3w`c?OP>oe+pV5u<>gV%C@Ct=L*sO(YS0FeC2^V$RpV;v$K?LY@!0vJ&^+SO zo;v{<4X$=BtDZ7}TzGFnqMnWFPwU5zz6jWkpD9JF68``(G1v}ObY}@u4%)W4DSy@?O46F(^@Lm0}v*2^ctlKv|H^(RMe$nisLApop z@deXgNhI^5L>xV2m)z(+Xx4q)OQDbDD$utt-vzPLM@FW!=`#$!WXMjY`DMQgQuKw5 z>*V`lpAQv=EzPl!k^&!pKmA!Q;jp_gqA`sO8tQFpYt#m9cAPc+15|sNV!|IrTUW#W z&DXbD1h#C*l~<#c&98%qw!%L5rFOctCI|R3QOVFFBH|_FL;QW_^NaOh7~1oo&|rlD zP|ShXDX3U{Us;(9sE)FTwGHJEHguFdDp+vZ;z~mgeP=vqXlQ~z;S}+JH7XpsE?)$c zP}FXG4N|P@H`dSK9LvUyFmzwGF9%G9c-9^cE>d*>vT6GtZJQNL9VlGv`p)=!n9k#Q zlKJ7QZ0zhUx0RlvQvj~pU9z$aUeQik0qNZls(!+BTM;jLEBN{j7zU(UdSP~(YsDp+7qr1hRp zNvVv0ohKDz?I7?0^0aeq7^}bnh0`Dm5|4&fBZ4|e1>@6fIWj_G+v-0bkLQ821!j$7 zw$RVU*v_Ay10HsLUo0jfqE*w@-aaulhD^Gep5FLoRFvU+J`HD_6>lRZ{SkdYFFWPu z$u;#ACKYUxd-w-0C05hK7}D173myYqR;btYD%Z`B)8U~E1(ALCj@3^=maQ%0_f}k4 zGa}C1q@P${6j&kxf^kz zV<5h(c;YDu33ggLRESbecOXDhAh2<-Hz4}v?fHK`Rrp(j;d^)Ieu#Sw%#Zk;@YU&l z5_Y2(XK&{8jfs7|#3_34ifwL`6Ut9iyMW%{MbwDQT+2QSKF(1HV*ZX#Y?{^RNtMvD zw0d;v)`WOf0#uCGb#|V8a6-c;=w^I;*Y#t^jXa0C zg5LuRqxORFAx6u)NpmKCl%nF|`5A^TK3N5kT}mh4%gBloL#QJ3z{q)2NjNZV1 zJ(E1W{;_oC{sc9mZ3RdxpPnFyJkFds)pbAR&K+w<$Dt3-+yiTSmrZV$syaESaS(67 z^r12}nN!2<890a>tqX_N&lxT*h*i{y^_XtkR$r5eo&snigv(qaluBD$JKo0WDPh&F z*?VDD=8U?flgVilGqsn?m#1>jb`sTvM9|YGPe9nr!T0973y&A!WkTi@%F=lDJC$s5 zM>0ZQATS|UGKm%U4fY0(CkUHh4S$Vu2a@a7%*h5~G`LtgfX z&j%jE%oUE*<2ibNc5~}L*{QeE;FG(VvfOn7%^AcdZZ&WiPIX|$i$Fhz$;D66KZ0so zbI-P_=;X$q8R(ExJ&W+fL|6^X^DWV%dD_!6www2&@OLa+zz#{yNzxW7=6W;%%%&c3 zn%fEZjy)OrmbqKIAB*_u(>?auS2)QqBO}RR+O!Znq_wnHC=|90V0wEhR`_GI1NJe5 zAp~c?qY#!pa?}U$`X`2Q=i_~*K41n6r(YWHiVnd?N~rmnJuoL zaPtp+^+H!5tzgfAyyne3fBnjbN`U7;at&u9*NVX z`ygmQIjf~*hjRfYJ5!%4o8g^GpRmd+4zb~1L*3z;k+diI%b02vsP=RY=H$;4uafzx zgXP%LU#}&sLFYE99Z;rOvxc9fP3B)&{H|y)ttlaBcSmi73MGlV=xPHEqG)5S4_hBn zj;R$H9cef!q>>TxjPOyz%^jtcm6do4h1Z4f?6b(}IjF_{ zgUBpYDJ(&;m4~q@Ko1f4%N}H+grsCt2|CFDzKDj5m+}{8iy?}+C}8J+tL>(eIw+P> zcfk_70WY$4`M2jz%tV_KMa?cLDT{}$n~M68yhX3U{MoJM`WQ%Y+1)6*%G#PMj6B(A}91BxX# zV`66(746(f{GVw0a#qpM2tpoz!6gZcrG))@;-@J>W{GfUp|MOBenps}(Cc-%4j7!` zrhs3=(=zTPh{%qUL#-)zOto8M8I|iFapMXQwX)mMk6zt-u)vCki))Y1#EBrnJFT&w zWrBI%fdg><5`BF54h?D`(~E^5UKSpm(4iluvqXSkZkZS0y8!?i$te{$qe66Wrcz}c zfif4*yVHKZjZJEN%d1x*b>rJ;CdkiUfSj)J<;OdsH5x#%w8OeQ)*cR{Bc`UCUykCX zY}-b8tf4Hpv^ZCQR-M1!%fnO(Sl6g-RpGboXp+!?ZNO{e?x)L(P9Pi&G{!R)9`W3# zFZ){VK07-9`T6QEtBLnYE6_lo4Pe?{IV$G`8fFsKEw{AhNXf|&Mx}%e z>CWxQfq{WkE0+-}h!Bq~WuqJ=9#K?u8Y2__-d8kQ4>39N%j)b0-abCJlrJRyeSkX1 z8#r1zenWcWMo!LB0NelksTpBOKAkw>^fmw9;uUmb2 z(enNNy+NXVa%C+UknrtSGj(bAsLj;=^Ut2-eHyB!MDWs?tbXxAY|oyXxSr+DUVVVn zU`g;^b`%AglB=q#;c`mYuzcrBk>9@)on<@ubUGd07dvrBMi5VNV2NdAIpO|h(K8y@ zPi7{b^}K)U_QmP`$YvVj$#;m4$Byx@Jdc5;-k(4HKUc0IegQ&)eRI52GYzp7nACDM zL2d=6{O@P9FQQiZ_cPzTzU=>gqswbx`HiN#PW<{syr|`kwG#`8FtiiTkhs#$E8oAn z0>b?Fb5~c_a*wQzte~(k(aq|hOstdi%u8P+F)(9BC5IU+0K|>x%B9Ql$b=9(p2nEc zfEL{|XYBv}JlcYrpmXAmv_4;{^=VpO`#O{_APYdL+bKsmYop-=Af|R@R|uphwn3|d z*8JZWO7uhj_l0KLW5&U+O!5DHv+24{AK|(7-yGyikC7M_&zW(rqn}idOk87{kWv}8 zrN)LJ`06c92w?H+mRG}aMJpgDcNVNN4B0^T04~RGY(I*U<)th3G7)nikIBfnb-Thn z1Be9@7CFn-#s*GHaLaW`K7>?3k%6Gti+#sbMGAE5r|l5NPDn#qw`1YyP%R*Rx$Lc)n8uS*)X-+ zdn`FPxE69BE)3+8si9#q(+{lr)~7vwa}2M6AnJbu!tg4cONR#c_3M^C*LM$UTU+mg zngiVgN$IAXo4&4Y``fo6g#zFZFZ}ubF7)y{s3^A;PJe0IQIRC;!oFdZY<>=&KwM&C zw-q@Uz=r1cI*2qyo2sR!aESLvVm+QKuE9ulvz4McR#OX<;bLch zc;dxIr(MFrcF1GR!bE5wnGbp+KL@YpkR(qG?3=GDMi5HDBnqzAot-79$fu^Xr=fs@ zVu0fWo-g`dmY;IP&YjNaIGgA=<^{RIe_`@Qd>PO>ipG=+;79JuZN3e^@jZQ4q6Lx` z`+X1ERpPa1w9eHE?Ai07re@9E?M0z0&tU@;2v|J;fhxhvi&e}T@;-R*06?kP5+-ds ze&<%%;M`MS3#G*ZX4IE=C;nk}6s13%?Hst>j3~GA8Lf9emh;;(v>9Z2+l{sMtLGXA z55OFH46on0^D2o5>W_@{*@M%FA<$prs^X+cKIX`a@+adwO~X7{GI&%bn{N z5iC~#)Y@l$3-3|NIwoag*r}?n`um^EylyM{T#JqMocnXqFY*S-yjsC`+8xwGG8szG zu~W-MU#a-Z!KNE9>%psA6J>##)2TCuttgme9y8pT%h6*bynJD1w-Bb_;^pGx3=r~T;MYmyY#8z=p(XsJyC-`z#xEI1t$QziLOy2tC*=Jq6 zmgw-WP=iaHI}bneCOa`B?uh6oA)R*<%=Z@v)|#bxc|ZO`N3iFCj%Ws{^#or476VfV zVCJh!g#Zz%NgGt%n+$o?+{6Uk&aojENmE8y0zb!rqy#!j4H6m}bR6G6*K4|xfcEWp zXpzPRM71|o1PwS`6aANO-@IWbVWdqkG4{roE=rM?%GuHmGYa4g^52~mpl)3$6E5Po|?ChVPJ$zDxkI0G`(Q$S7^XFq? zve>`yN9re43Stn$hmEj2C+<4gsIEfEm4O5BU6xTA^u_x6`m_q>e(_b)hHa5`!kafYq`io=ue zx6bJ5F1!nvFK}QHq6|2r3@|(Q?V7H;D|?z_?FF;Je-lAVB(q$VVG<@p;P8m5zz6@h zRp0w92QvOrXWRO!!vJebgEy?tjDFn2${HIT-P_lf+Af5-C_wu@957B%J(ZS{Qf-R8 zb&GP{9_v@FA0n@u%rQJYwCy|kNh*>1Gzza{5Kc;pz(LqZ0ky8eq=!xr8+7;=VhJPs z6UpHEp@H6BBXnvui)`7F7X0CX-Fk%CsQ~yTl<$3mKT>`j)*g5ZPa&Z+VB%m$r22p- zn5`EkaYp`^`MpEqLv2F)KkvUBPIN$h9V0rRp7bSYa|glUkaGS~31Y3$38o=5o1FjS z8ZDylmh=^*g60h^%S!d6|7OqFaP;mIXpXHCY4~ulqtQ18v{GV|aYW$BWtasP6zo8I zY6%#FvUSc$@c-YFt7Qu}nNd#_rd=-$0O=$Xt8D-`_f)9mZ~ zF@zt(#@@X718xHa^ALr9O=4$?I?Z6b^@T~c4&5j6dAYey5uR{my{s=^yzsG@xZt{< zut;EC#p@UtgygF-rJO=7ULb6X^=JG5MFg$IgA-w_fh7>3_+v$xt4J$vC|eS}D+Ms> z0yl~JMy#T2`mJY~tHLF+K&)Z6zByQeYU*mPF&n1=zNl2=(^?7jc_2M zX4UN%6cRFLQWL+i(oRGyYTE^U+7I6Br-|APg)M;jzyCJA9IEg2tUJ#2%4TttXs7oL zEv;I&>@rhW*%IJ4vTL6a!j3Q}i3CR^(O1GYO_NcBrZ+@SE@tL&=F>;CwH?qU(YOaa zkwsX`Q~Mr+fHt{%8ZdE8S2w5mry8+S3A>s(uY4Aj!r9RzY%Nj?{l5%p^CC+i2LBy<`iMH-;mgs3DQ)ocRVXc`cR&$cc?N?z^Cc%9W ziH6bGL5ztZ8Yp(0ECgo< z6l{}*v-9xE4E>KD|6CbRS664l${&WpCiSKF*k@HIe}=@+JWM^p7$nyZ4=HNulo%a7 zy=n_*8ygQuV7j7T#x`Ud9wXgd085yjQ7bH3V0JiJtyFOw{wu~XoYa$TospDfZB(w4 zcn~I&dQ>Erc&bO^W@z+|5c#2lpYq|EPZ8%XBPAvtOaze1-}Qf*+OCP)pfIA{1S3FK ziOY?6YyquKZdTUKL@R2o_?X(vK@d5?jyA4$RuGW-n(FFmm`E8i&-o-(w{B5yn!bSQR<=m z4s<};xuYtY2vqPKGGwhoo#eZ;FeP{&)Aj1>X#@b8ZtnKV@!WLew)_(b`L77}dG>6c zov4F$2x6Q}8rD6of`vF^5yqhhi9Gn`q#+JOmlR8(0kpo+YGkybNvP%?{0O=fP)g~X z-zV)}@Ux&0(^+K}fJp@N8*e3QVteSYb(TK*5piQnuz>nyuwR+Y>_lS&@h10cslt=w z`~iPZkF78;=0(6Cfd^HWlt*NN%otv0P@Wum?-h*EegC&1&T%O!&~XPQ>y)CBOPNDS z?I0nM3p8N*-K%uMk(jG=jy3esuQL#Q1V5rH91Xui8Wecpzl!hPW$fG42|k;A8497w z8YB_5hNvn4xoGe*S!&tn{KVSJMcndi$+e`8yM*q8Q2xe#T)pJN_jfzJKVY$TeCM>J z6CQ`hLOX>$gOicQi)*i+uc;~P1CD4jXYN01B4Ea<6~|&7%0V;IDrQ4!ARC>;L+=H# zwbL7&J|3B@ZR%0o0FBM;>gd+PfktUs0w-oB28Z5@yYg5CCzdUXXHob6>y#U@Gp!$d z?3m(ybk)l+_&z(7scC5XH{?7{!|0+$Btd~-@Mt;j1ZM^;kmkTJC8DlR)m%?zZmFtD zt>VewPsyEJ3#;^CzyT8zlR}-5>y zW8;%QurS)BArBbQ-a+R~71C6#7KV=%lnbD*Pm$zcXXjCWm zzWOH^CAP6hUtb^D*O}z@d#>%DV{ur{NTzM}&LRM=l18b(xs3r>sg1&N1hpVS6=!QR ziDtcAg+fdQxpYnX^q2jj9G<$Y!k*QwN5>~8HOE=M=A_?_hva?~l>l~a4WBCQ!&677 z!nIKCWz;~eZoQ>`42>h{H}f*`uAwU}|1_V1#~S_1>$)~R!GMX0^!79RpJ$9k-uFZq zV;ovlM2>ofKSc_%_P&g z?Fn=7qr(BS&(QObW4(McniL6t>-m#=h6dY80Su0NnJ&=v0$H1nr@KVfg5`Ym;Wt~l14OdjX3 z_BDbKGhUpVXod>k5?#YE69ZD)g4KP9mDm*kdx4&Lx!EZ0ZSd*M86rya4 zt{-7omXreFAbn&{@HaXt@+-Ul%bdnMxQmxv_E_aVWDCYE?yxoe9>>U#E*o$S$ISta zDi;25wHUa${fv*t^e&G5=m0Y6;(S6huW0zFmV)e=PELcwMkk_c;^8rYFV1i|=5a*r zr=Gbv$4#cY7o2jBMf8yrwlWj}$}Z0{*mkns^oc3FjbIlac@7)1?#GCkb}Mq!B`b-8 zut}+kgnr!zwcPy6a^!Mej$AztFELVL@|&|$Rs_I_-)%hFeeJfjXuaz4kzpG;zO-yy z)9-x}_)h>DM`6vFev76U(O*4A{S8eI%DF;{9&MB%Mgpkagco?{Z+6f51cDmp53H!DNHhaAk(!qF z8vVdh=P~9;BYw}>{MgV&9(8Z9Dfbm-tmjZNp`_Zn_#Qne{L$Cy#J+gL9y|H;{sZlwsyUAfdp-<8o${0l&U874*7|Lq%B#+ zM%*1yF)>2=_OZ|jagVB!+sN7b1Hi4yXH7iKclHi3>-ZioJ#-s35xw4TAMGYkQf-z{ zk}+;sPO)ZfrH@94Xu%Vg?A@j5>$3Xj>8!}c3m1dX)U|JiU}YA(W3dH-Iy%<>_{@CC zeb#43J0ng<;$ULB=-4jGh_HD7;Y0Rp)nR^TOm(nBB(Z$rxlW*c%eoGs?oMKmfcV{w zy{#|q%nOL1K486I5zNt1&4wv9qo0g zWNQL*4of1|`c~yt>RokcQz4*rscv3Rr?0@Tg||<9XC5F+cvqVOfxUQv#mNmJZsA z^1H(K7eg#c%%&KOSvo@|8~yr8pwkjq4xY0||9ds(BW91jJS*FDrQm+PWrMEXL4{|E zBsmauXw{mDr$aZX;T-~VS(yd&D;*=|RQ+v2m{)(^b7AV1OzIhowDvp=d#o{rlsE>rHj9ca!omzZyG^aFD^S8ot_woZrV^h{ zi+NkfPWt=yZ32SCgG1N7J%a0A)R&mK04DVGMBySg|d(#st{1=75UO|ouEDd}J-vdCZwaFTK<;W9M*b7Po?~Gc0m8g$WUT;8 zCbca~c9X#*pe~iTb{Ld`+H}x57N*+?31W-u&rFVRv94_rKR~q1wKP?ZuA{IV zu>>8NK%$Wwf#UlA-XBs1XL%rt2V^t5{Iz|;g>yMmA3F3e4#{0vrnUYzXG zciSFTu|9fU#Y2h>8>kEK-;WAvuBjOS`D*j#`STP!U^V_@tJ^sbj%{}2KDhPkfleS# zSEHGC{!;JbIIpZ1YpDPJ9(&bCCjYwl{qr^vsCLcL$PG*&BIXMK$OX%bv+mz#Vho!1 zv5>w>y_mfWfI2sP5I)tS>oX1N76TmjJ==_7NYSyL8y?9}OkxgW1{FIxMD~fPOmvwp zPYYo(E|EEfo?FMan5co`VjE@kComqU*dRKor3vJlmZ-mSo{Xg1nV$xvbof z&cf}qpZ`dQV^VZ9^I|gEYXB!%PwhG9<1;)o^f|HsG!6^+4Gn(3yjUg<NUA$6!|KEoD(UB3l1DL{L5xkcRy&(+yKNrOLn6P<- z#WUH=7^mc+TGWt%FwY#iaK%uK^R{KbZp8JdDE_IPkG=obtgvE5(p`}f0(2&AIPPXx zTD)&%F=cNg(O5n6?j0RvTyfGb`M=-uI!pX&ja$gV0}azk>HuaM=4fUac~QabpBasq zZ&+$lGl-{3JBEsg)G(w;I=XXFd-a_$H0|Rw`0aSiT|KR|P-x^uR)6#O{wrJf7ABT> zz8!L_xbX92zU#GtDc`YS>N=B%5U%#fYsVVvd z=##!_)Imrx&?io1)&+nS-?C-Pp#C2;xvM1%-hB6^Q@$e%79TnvqFaDMNH(C5KtRP7 zIg**Y+M$e)`gF_@A<%XEp1H>TqIqQKRVoeT;N@jY*au$lG&~kM+e${g?dGWEqcJQtf(OXsexG`(qw43{zu~=uDir zaTvzyVNXa8x*INS6p)BDlzo@lMxy!rJoK`30X(I@f0gHj;#B6@O>AuOFXExG7(qX#&#OSmGqkUr- zyRtYQ>CgH&Wq_$9C}>T>L04*lLuKb=`;x~d2#3A9MvFkJR&%GLVgF}>_=Fy&a;w^< z?aYMTD2Ri5)~jUskOMnpb&4V*H~6V_z_7sF(9&{BQZCB@vjsiWeZ3$1p3+@e|4!;V z%u*~+Z{}RW1HR8bc+lK_VtU+md~BT$<{CCgR>3naE-pUc8LnlBV=YWg(+la36#c?f z6HB8R<1 zrU~uezh6Z~#ogT@57Vdu(#^rx=IY7+I zv3%^2k(%0<=UNYXb_NO^iuEwru41BXIb7V_Y38M={-rqna3c$gcd^;xE53%(o~w0e zid7I5)w!obbuTY(@YK<~)g5ch@9g$+wzvO+R}M3vlw&KuiRO>jcOymb0^p^JIZR>* zVC%#ZO*g#oC!FXDo!4D!FdJHfw$f^g$G^k01{<1&J)gki0kb{X7i1W2&!*=H>~s&| z)2dUnHWTLT_Qq7Qt(Pg30{{Zu2SbeB6kWQsTHNsQ0Ue3tHg&u~+~pjP(??iek#l-? zqwK-yDM8y2X#bQ=b-TQj4n4p~OnLFcT>OmmbWS!NxG6Z>VVFAZ=0EqL=Q9%_YutQQ z?p-2%|LN1G9uj$YAp~3!VbQHpDT;1#XICE zxY0y8l_!Oh= z!lz|yd~N=^3qTNvz8o7x@3DVuWWbkFq&%<;1?P#abPgto#tF~|7>&y?veRRr0n776 z5b7nB0UWqsG8laV^V*+0QKLdxqPb6_CC710JiZkwsA)Zn1Lbq4^c*cO#iezWA`VMD zDhLe=!|4Rq^wF~`f?Z3I%efqP%#SN!M3QteBrxS#TZFsO=I2L~&pS@>{m^AO-xSVx zOq{0ep5#&aJ6K{*MzQN_vO(JS7W}h&qw~75-w;!clmjn--eu<7ROK0GAuxuzJ8emb zZS)kZTEu2asVli$cigm2GLk%s#?&P6X_qT8+{7v=ai@bm=C)zk)h^z}sW;N=w6;o_ z!sthJ7v>*+cWd8qYDKMc1_)1U6)ib#)BKFyQ(`+UKyIs=!|P2)9J-hjej>4nfL zCbw482gE%ZJm`NaV2$YNhEIIhA+Le)!dgB!8UDx3lr`=0{%|k{lf!g~2Q| zEJAlU=sG4yr+q=b4i^u82)goxiz+H2h)S<8i_Id8H}DMxOt_((CqGP1zPPgb4z|l* zInwtlJ28<&?*zQ^SiA*nj=N=fnEJ+{MDGl5B+n$A9I>&dt@|)N!&8@CXNJ`pD z<3Zm}`g0%J-9Qn@4z1-eGXo|pGY7}P9smo5I@$Y}&b{X9ls7W1c3Y~=%(8iPFx~jn z58`m0t950z^u!vvRO}dyDM`J&M4ROFL?UNwQ)l`i zOzxS-t9N(&X4kD1k!flEBR$)}qQq355xqLG1imU9q15Mq05<(>gPqBB8rjGZwHxev z$CuX3TWe0{Tf9@BHjX2F9B!)p1MFOnn(Y-VcB6IC z@gp)b^A-sSJugLJVe0y(#>OD4-J|imausV6++sR5qO<9>1N2&7Jkz5dDKNxLuejvOBkD-7) zaZ2=dtNhLnO<8pU9w$zuYcb~7YnFi^N%12_Wo>S(5NnlI;PD1MD<3gRAw@OaBjmcE zVol0i&(b0XJNuWuJ{-6LMe>VWXQ}^uKc74=7uU^Sq)rwwHh?fy-_3696pS691P3F9 zQ5&bwf4Nc5O;LXsy7TO)W#>4qw|Z^O?ev#(C-FjstaH@1GqY5sC`x=k0gG(tE~uhp zrorZ&Dx9~)C@i({3a2wiK440--tv85amBX9k{s;MZ#sC`$w_SEcDT-kXv~UI#h8Ct zFU^``@Q3eJiJ`XzcOdJ}hxuJS$Nml@4RHrYDJ(svVV%~sO$P_>YBD%mqES#ocW&p_ z&MgPPgCiVc!igM7fS+HboRvialc6lVyktMB`SyFEocYycd-Xp!S1QER{o9*u@=3m{ z-aaF}JvONGzX2|V0Jt5Ma5s=#*PD<+Y*b8eU`d=yv<~I6I|@KMn0~XdRk33~MvzS!CnT zcxYY=y&-%sw1cJD(nDXBgt}>|O`8w0wUbMde5gDs@QH;R*%O%eUxt0#ciwlWEYZ5g z`T6)3Bx8c!H1aSoFhFY%jDNaiV-pj*Gd^R19Sc79DOjZ#lu%DnCr3EKWh>0 zs`^Ghe*9SThNqD?ke+!7vwSYc?O#dk5sn|xbVZz6LfWGJ9E62M1=VU!Efg^D03PylWr!Y}1`= zC)i$?`P81Ewc8k1M|fcpKh~nB1)Sk?gsY~5=WbW@O} zP&+s+%@#Hb-_&=Q^US)TzHL8Bxn17{P?|bYYe-tg1h0gA_BQ#G@Fei_Zac%;Zgjc+M{fPMe*kK;1npZ@!i z;A`=5IV3K-tpDf7WynixM_duU=*aS39nL%PCW?4hP!K5jO z6&$I}Eq{NO0;2)rCg~HPN|F1D^REl-*zu~V=^MtZefLm+5T&0-x^z;K~|Nc_8@9gm1b7i;BbS46KV4&{(pUeLD zC=n@~%@) z;IrLE`?MS#9pOg2G8Aic+_4QwK3(7a{#Zh^`&%t}~1Hgj=Lw3#0-^#z0N_+({j)Q^#rZtjq z79bk_(YX|M2XZJz9R|{(Y4aTH{iW0cQLrlt{XeZ;Ydn$5vxeO`ePHm%Hva5+=u&7SX z_c1!XIB(B;AM?yJ|Nrmyz5GyoiyYxenn5g8D4wHK2lW|aUD)P%Ob}T6!c}rH(0=u( zd>FMG>B^aBu=HMhO8axiaX8k#wqQ$n@CTnO)QzgIG=q7^%!YB7pqWSJ;v zOvC(7M^_iPBWUYCv-w913P1((GS<~yF$my*PD~{ayVI9n4r;%J+6~_1nsy*C`T7c} zTKFLKB-BzGlAt7hLP++v1@pYLDR+ zchZCyX}%>Tl84d&+$V-3t@BOb`k`FP=Zi%m2*($X`>$6;`nykcy_`9pgXhTM5e|iP zHOlDhDhwo%f_ik&Ob)ZG+3a$Yv}h}o+U+zO?87s6nFI1*gMDOEU{l7yn>W&ok*K^O z00Mxs6Da$Y8IFz@dC1RlVj8|xkR(Ojlw>#7%SscihX@UqaCAm+Uo3X@h7nVA#V6sG zEUj@)?ZW$$$?GZ2ucuN}$y@gpOOcOtzWsop)|S6-7YD z#3myyPW@cS()}#d@DB;8;mph8F-d?xgS62?$ytBLemxYThy{Zf43tKk-3#YSCy4Y0 zpx{RKcSpN0?A7FKg>4E^;o-FS_nhO$?_6>*xcmGkotpwd0i-E#*m*_Sxl_{EScFQX ziOtj_HtRGxMw+c578dPZnC9+AH34dY;-L)KfysZTT+z&nt`#k(4+0UyXdNxpP&X)& zkRNWTLkgM(6G-b=EAqawJIX{!a3Gk1TeoT@DAWJ0Q4^4P$O@Ej`1NB(MPhG^+`pr8 z-S>uHn2AB!*_PgmScjg30=^-+A;?v7U7D70=nA{c-Q&l(xfpxxhce6pn_X}E67iOZ z5Fz%%#Ec=|8H9h^hr#Uw7y({q^uTt8Odf9gverA~FILET5k_lW%3Vy|Tm4bqM-cAe zi*Y<)uZCU9t4S5CM##^%!tN`S7GVB&_x3K`P3TWcf6B|-758oqZ)Syp!i$+Vot;jh zBHP7xaf5vq9%=IQu_(b?3|h1)P$k2LL=z4L)8T)pM64>!dWcdH7o5lrI5jfM9$LLl zv<^7h=|S zTspSZtke>Lz+A=Q&PiU1ApN<6at<4*Lp|Tg$2JiS#--yI{FL1j>-6CVz-?hkhr7PHp){)KL6*hc_7(sUhDI>ls!;uKoz#4$x~@z+^|+ zZsT8LYqTdnM%k!TOn^r_i_S^m2v0~*RdQG^*j0KNl(3SLmk57#_H_Ov?xL3g3!YRUfT)Z=AHBi9Q-p}4$=&!3A z!X$xy7=d9 zmso7PNJLpY?|4FEFX5?85ZIKN(^VUx2<R4-uFVZm-K^bnNTb9o8?aQL?fTd#h5@b^zz_cfn z$`v{IHX|llsqI1nr1Zo}l{bAy{ryY$7)Vt;UM9>F9jOG7b>yZ~ruQIC?8jnd6|!YT z#nPF!y5_i}@~xW^AHmZuJ*%SF1vT=bb=x-fGJ;%vz{}ah-@cww`-wJxrv4Jv^S2SAM3% z1}L;M)B;+2=*{9W>%}bZY6MkKvnL&g`w18a=#3Y! zyJ##-UaVQ10Ivi{7I?PDcl29co3|!(TX2Dp;x&)?$+Oh|bTy02?vFjsQdjf;X>y2; ih&aI?|9#w(cN_j)8W8x28}}Bm3VEL`!-h}yJ^dfZCO)wM literal 59071 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 #DeepSkyBlue { - assets: ETH, sfrxETH +object "OETHZapper" as zap <> #$originColor { + assets: ETH } -object "OETHDripper" as drip <><> #DeepSkyBlue { +object "OETHDripper" as drip <><> #$originColor { asset: WETH } -object "OETHVaultValueChecker" as checker <> #DeepSkyBlue { +object "OETHVaultValueChecker" as checker <> #$originColor { } -object "WOETH" as woeth <><> #DeepSkyBlue { +object "WOETH" as woeth <><> #$originColor { asset: OETH symbol: WOETH name: Wrapped OETH } -object "OETH" as oeth <><> #DeepSkyBlue { +object "OETH" as oeth <><> #$originColor { symbol: OETH name: Origin Ether } -object "OETH Vault" as oethv <><> #DeepSkyBlue { -assets: - WETH - frxETH - stETH - rETH -} - -object "Swapper1InchV5" as swap <> #DeepSkyBlue { - asset: any +object "OETH Vault" as oethv <><> #$originColor { +asset: WETH } -object "OETHHarvester" as harv <><> #DeepSkyBlue { - rewards: CRV, CVX, BAL, AURA +object "OETHHarvester" as harv <><> #$originColor { + rewards: CRV, CVX } ' Strategies -object "FraxETHStrategy" as frxethstrat <><> #DeepSkyBlue { - asset: frxETH, WETH - vault: sfrxETH -} -object "ConvexEthMetaStrategy" as cvxStrat <><> #DeepSkyBlue { +object "ConvexEthMetaStrategy" as cvxStrat <><> #$originColor { asset: WETH Curve metapool: OETHCRV-f Convex pool: cvxOETHCRV-f Rewards: CRV, CVX } -object "MorphoAaveStrategy" as morphAaveStrat <><> #DeepSkyBlue { - asset: WETH - Aave token: aWETH -} -object "BalancerMetaPoolStrategy" as balancerStrat <><> #DeepSkyBlue { - asset: rETH, WETH - Balancer Pool Token: B-rETH-STABLE - Rewards: BAL, AURA +object "NativeStakingStrategy" as nativeStrat <><> #$originColor { + assets: WETH, ETH + Rewards: ETH, SSV } -' Oracle -object "OETHOracleRouter" as oracle <> #DeepSkyBlue { -pairs: - frxETH/ETH - stETH/ETH - rETH/ETH - CRV/ETH - CVX/ETH +object "FeeAccumulator" as feeAcc <><> #$originColor { + assets: ETH } -' object "EACAggregatorProxy" as chain <> { -' prices: CVX/ETH, CRV/ETH,\nrETH/ETH, stETH/ETH, frxETH/ETH,\nWETH/ETH +' ' Oracle +' object "OETHOracleRouter" as oracle <> #$originColor { +' pairs: +' CRV/ETH +' CVX/ETH ' } ' ' SushiSwap @@ -81,70 +74,43 @@ pairs: ' pairs: CRV/ETH, CVX/ETH ' } -' ' Curve -' object "Gauge" as gauge <> { -' asset: OETHCRV-f -' symbol: OETHCRV-f-gauge -' name: Curve.fi OETHCRV-f Gauge Deposit -' } -' object "StableSwap" as crvPool <> { -' assets: [ETH, OETH] -' symbol: OETHCRV-f -' name: Curve.fi Factory Pool: OETH -' } -' ' Convex -' ' object "Booster" as cvxBoost <> { -' ' } -' object "BaseRewardPool" as cvxPool <> { -' } +' Curve +object "Gauge" as gauge <> { + asset: OETHCRV-f + symbol: OETHCRV-f-gauge + name: Curve.fi OETHCRV-f Gauge Deposit +} +object "StableSwap" as crvPool <> { + assets: [ETH, OETH] + symbol: OETHCRV-f + name: Curve.fi Factory Pool: OETH +} +' Convex +object "Booster" as cvxBoost <> { +} +object "BaseRewardPool" as cvxPool <> { +} ' object "DepositToken" as cvxPoolLp <> { ' symbol: cvxOUSD3CRV-f ' name: Origin Dollar Convex Deposit ' } -' ' Aave Morpho -' object "Morpho\nAave V2" as morphoV2 <> { -' } -' object "Morpho\nLens" as morphoLens <> { -' } - -' object "aWETH" as aweth <> { -' symbol: aWETH -' name: Aave interest bearing WETH -' } -' object "variableDebtWETH" as vdweth <> { -' symbol: variableDebtWETH -' name: Aave variable debt bearing WETH -' } - -' ' Assets +' SSV +object "SSV Network" as ssvNet <> #$thirdPartyColor { +assets: ETH, SSV +} -' object "sfrxETH" as sfrxeth <> { -' asset: frxETH -' symbol: sfrxETH -' name: Staked Frax Ether -' } +object "Deposit" as bDep <> #$thirdPartyColor { +assets: ETH +} -' object "frxETH" as frxeth <> { -' symbol: frxETH -' name: Frax Ether -' } +' ' Assets ' object "WETH9" as weth <> { ' symbol: WETH ' name: Wrapped Ether ' } -' object "RocketTokenRETH" as reth <> { -' symbol: rETH -' name: Rocket Pool ETH -' } - -' object "Lido" as steth <><> { -' symbol: stETH -' name: Liquid staked Ether 2.0 -' } - ' ' Rewards ' object "ConvexToken" as cvx <> { ' symbol: CVX @@ -158,8 +124,6 @@ pairs: zap ..> oeth zap ..> oethv -' zap ....> sfrxeth -' zap .....> frxeth ' zap .....> weth ' drip .....> weth @@ -176,51 +140,35 @@ drip <.. harv woeth ..> oeth oeth <.> oethv -oethv ..> oracle -oethv .> swap +' oethv ..> oracle ' oracle ...> chain -' Staked FRAX ETH Strategy -oethv ...> frxethstrat -' frxethstrat ..> sfrxeth - ' Convex ETH Metapool Strategy harv <..> cvxStrat oethv <...> cvxStrat oeth <... cvxStrat -' cvxStrat ..> crvPool +harv <..> nativeStrat +oethv <...> nativeStrat +nativeStrat <.> feeAcc +nativeStrat ..> ssvNet +nativeStrat ..> bDep + +cvxStrat ..> crvPool ' cvxStrat ..> cvxPool ' cvxStrat ...> weth ' cvxStrat ...> cvx ' cvxStrat ...> crv ' cvxPool ..> cvxPoolLp ' cvxPool ..> crv -' cvxPool .> gauge -' gauge .> crvPool -' oeth <... crvPool - -' Morpho Aave Strategy -oethv <...> morphAaveStrat -oeth <... morphAaveStrat -' morphAaveStrat ..> morphoV2 -' morphAaveStrat ..> morphoLens -' morphoLens .> morphoV2 -' morphoV2 ..> aweth -' morphoV2 ..> vdweth - -' Balancer Strategy -oethv <...> balancerStrat -oeth <... balancerStrat -harv <..> balancerStrat +gauge <. cvxPool +crvPool <.. gauge +oeth <... crvPool +cvxStrat ..> cvxBoost +cvxBoost ..> cvxPool ' ' Vault to Assets -' oethv .....> frxeth -' oethv .....> weth -' oethv .....> reth -' oethv .....> steth - -' sfrxeth ..> frxeth +' oethv ....> weth @enduml \ No newline at end of file From 146465b0583cccd065a8ae2c55c6057dd1bc3ab6 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Fri, 3 May 2024 12:28:45 +1000 Subject: [PATCH 16/30] Update to diagrams --- .../strategies/NativeStaking/README.md | 4 +++ contracts/docs/FeeAccumulatorHierarchy.svg | 33 ++++++++++++++++++ contracts/docs/generate.sh | 3 +- contracts/docs/plantuml/oethContracts.png | Bin 82293 -> 79801 bytes contracts/docs/plantuml/oethContracts.puml | 12 +++---- 5 files changed, 45 insertions(+), 7 deletions(-) create mode 100644 contracts/docs/FeeAccumulatorHierarchy.svg diff --git a/contracts/contracts/strategies/NativeStaking/README.md b/contracts/contracts/strategies/NativeStaking/README.md index 13e280eb9b..00c9a7bd9b 100644 --- a/contracts/contracts/strategies/NativeStaking/README.md +++ b/contracts/contracts/strategies/NativeStaking/README.md @@ -16,6 +16,10 @@ ## Fee Accumulator +### Hierarchy + +![Fee Accumulator Hierarchy](../../../docs/FeeAccumulatorHierarchy.svg) + ### Squashed ![Fee Accumulator Squashed](../../../docs/FeeAccumulatorSquashed.svg) diff --git a/contracts/docs/FeeAccumulatorHierarchy.svg b/contracts/docs/FeeAccumulatorHierarchy.svg new file mode 100644 index 0000000000..3ddcdb22a3 --- /dev/null +++ b/contracts/docs/FeeAccumulatorHierarchy.svg @@ -0,0 +1,33 @@ + + + + + + +UmlClassDiagram + + + +20 + +Governable +../contracts/governance/Governable.sol + + + +279 + +FeeAccumulator +../contracts/strategies/NativeStaking/FeeAccumulator.sol + + + +279->20 + + + + + diff --git a/contracts/docs/generate.sh b/contracts/docs/generate.sh index 69ab22c21c..ed02d52347 100644 --- a/contracts/docs/generate.sh +++ b/contracts/docs/generate.sh @@ -84,8 +84,9 @@ sol2uml storage .. -c Generalized4626Strategy -o Generalized4626StrategyStorage. sol2uml .. -v -hv -hf -he -hs -hl -hi -b NativeStakingSSVStrategy -o NativeStakingSSVStrategyHierarchy.svg sol2uml .. -s -d 0 -b NativeStakingSSVStrategy -o NativeStakingSSVStrategySquashed.svg -sol2uml .. -s -d 0 -b FeeAccumulator -o FeeAccumulatorSquashed.svg sol2uml storage .. -c NativeStakingSSVStrategy -o NativeStakingSSVStrategyStorage.svg --hideExpand __gap,______gap,_reserved +sol2uml .. -v -hv -hf -he -hs -hl -hi -b FeeAccumulator -o FeeAccumulatorHierarchy.svg +sol2uml .. -s -d 0 -b FeeAccumulator -o FeeAccumulatorSquashed.svg sol2uml .. -v -hv -hf -he -hs -hl -hi -b MorphoAaveStrategy -o MorphoAaveStrategyHierarchy.svg sol2uml .. -s -d 0 -b MorphoAaveStrategy -o MorphoAaveStrategySquashed.svg diff --git a/contracts/docs/plantuml/oethContracts.png b/contracts/docs/plantuml/oethContracts.png index a3745866b276befa81180de752064da9ee27c7aa..e7df706f4537dd9d58c1e15ca283a72d1ebd4f75 100644 GIT binary patch literal 79801 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 literal 82293 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 diff --git a/contracts/docs/plantuml/oethContracts.puml b/contracts/docs/plantuml/oethContracts.puml index 29428c3f3e..e71ad1a73b 100644 --- a/contracts/docs/plantuml/oethContracts.puml +++ b/contracts/docs/plantuml/oethContracts.puml @@ -7,7 +7,7 @@ !$thirdPartyColor = WhiteSmoke legend -blue - existing +blue - Origin ' green - new ' orange - changed white - 3rd Party @@ -23,8 +23,8 @@ object "OETHDripper" as drip <><> #$originColor { asset: WETH } -object "OETHVaultValueChecker" as checker <> #$originColor { -} +' object "OETHVaultValueChecker" as checker <> #$originColor { +' } object "WOETH" as woeth <><> #$originColor { asset: OETH @@ -129,8 +129,8 @@ zap ..> oethv ' drip .....> weth oethv <. drip -checker ..> oeth -checker ..> oethv +' checker ..> oeth +' checker ..> oethv oethv <.. harv drip <.. harv @@ -156,7 +156,7 @@ nativeStrat ..> ssvNet nativeStrat ..> bDep cvxStrat ..> crvPool -' cvxStrat ..> cvxPool +cvxStrat ...> cvxPool ' cvxStrat ...> weth ' cvxStrat ...> cvx ' cvxStrat ...> crv From aee43825e72beaa88d0649dd745349019a0b8160 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 15:48:02 +0200 Subject: [PATCH 17/30] mini fixes --- contracts/tasks/proxy.js | 1 - contracts/utils/addresses.js | 8 ++++---- contracts/utils/resolvers.js | 2 +- 3 files changed, 5 insertions(+), 6 deletions(-) diff --git a/contracts/tasks/proxy.js b/contracts/tasks/proxy.js index c625283dda..f42f502d9b 100644 --- a/contracts/tasks/proxy.js +++ b/contracts/tasks/proxy.js @@ -4,7 +4,6 @@ const { getSigner } = require("../utils/signers"); const log = require("../utils/logger")("task:proxy"); async function proxyUpgrades({ contract, from, to }, hre) { - const toBlockNumber = to || (await hre.ethers.provider.getBlockNumber()); log(`Searching for Upgraded events from ${from} to ${toBlockNumber}`); diff --git a/contracts/utils/addresses.js b/contracts/utils/addresses.js index 92e32299a1..17394057a5 100644 --- a/contracts/utils/addresses.js +++ b/contracts/utils/addresses.js @@ -248,10 +248,10 @@ addresses.mainnet.beaconChainDepositContract = "0x00000000219ab540356cBB839Cbe05303d7705Fa"; // Native Staking Strategy -addresses.mainnet.nativeStakingSSVStrategyProxy = - "0xdF58F78cebbb2A60740eD2f86cDf0545a485102F"; -addresses.mainnet.nativeStakingFeeAccumulatorProxy = - "0x85094b52754591A3dE0002AD97F433584389aea0"; +// addresses.mainnet.nativeStakingSSVStrategyProxy = +// "0xdF58F78cebbb2A60740eD2f86cDf0545a485102F"; +// addresses.mainnet.nativeStakingFeeAccumulatorProxy = +// "0x85094b52754591A3dE0002AD97F433584389aea0"; addresses.mainnet.validatorRegistrator = "0x4b91827516f79d6F6a1F292eD99671663b09169a"; diff --git a/contracts/utils/resolvers.js b/contracts/utils/resolvers.js index 741c863211..bd22587b5f 100644 --- a/contracts/utils/resolvers.js +++ b/contracts/utils/resolvers.js @@ -18,7 +18,7 @@ const resolveAsset = async (symbol) => { if (isMainnetOrFork) { const assetAddr = - addresses.mainnet[symbol] || addresses.mainnet[symbol + "Proxy"]; + addresses.mainnet[symbol + "Proxy"] || addresses.mainnet[symbol]; if (!assetAddr) { throw Error(`Failed to resolve symbol "${symbol}" to an address`); } From 274fbeded687b7a918b6ed6c209e08f70be70faf Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 16:10:08 +0200 Subject: [PATCH 18/30] fix bug and minor test improvement --- .../test/strategies/nativeSsvStaking.fork-test.js | 10 ++++++++-- contracts/test/vault/collateral-swaps.fork-test.js | 2 +- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/contracts/test/strategies/nativeSsvStaking.fork-test.js b/contracts/test/strategies/nativeSsvStaking.fork-test.js index c08461018f..0383290379 100644 --- a/contracts/test/strategies/nativeSsvStaking.fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.fork-test.js @@ -144,7 +144,7 @@ describe("ForkTest: Native SSV Staking Strategy", function () { chainId: 1, ssvNetwork: addresses.mainnet.SSVNetwork, }); - // const cluster = ["0", "0", "0", true, "0"]; + const stakeAmount = oethUnits("32"); // Register a new validator with the SSV Network @@ -191,7 +191,13 @@ describe("ForkTest: Native SSV Staking Strategy", function () { const { nativeStakingSSVStrategy, ssvNetwork, validatorRegistrator } = fixture; - const cluster = ["0", "0", "0", true, "0"]; + const { cluster } = await getClusterInfo({ + ownerAddress: nativeStakingSSVStrategy.address, + operatorIds: testValidator.operatorIds, + chainId: 1, + ssvNetwork: addresses.mainnet.SSVNetwork, + }); + const stakeAmount = oethUnits("32"); // Register a new validator with the SSV network diff --git a/contracts/test/vault/collateral-swaps.fork-test.js b/contracts/test/vault/collateral-swaps.fork-test.js index 847cd97899..bbf7c9c57e 100644 --- a/contracts/test/vault/collateral-swaps.fork-test.js +++ b/contracts/test/vault/collateral-swaps.fork-test.js @@ -10,7 +10,7 @@ const { } = require("../_fixture"); const { getIInchSwapData, recodeSwapData } = require("../../utils/1Inch"); const { decimalsFor, isCI } = require("../helpers"); -const { resolveAsset } = require("../../utils/assets"); +const { resolveAsset } = require("../../utils/resolvers"); const log = require("../../utils/logger")("test:fork:swaps"); From 91894c224b9957293c3e20f48dee5f19f2bdd006 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 16:10:24 +0200 Subject: [PATCH 19/30] update yarn fulie --- contracts/yarn.lock | 922 ++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 888 insertions(+), 34 deletions(-) diff --git a/contracts/yarn.lock b/contracts/yarn.lock index df633b97f9..2ffb02816b 100644 --- a/contracts/yarn.lock +++ b/contracts/yarn.lock @@ -233,7 +233,7 @@ crc-32 "^1.2.0" ethereumjs-util "^7.1.3" -"@ethereumjs/common@2.6.5", "@ethereumjs/common@^2.6.0", "@ethereumjs/common@^2.6.4", "@ethereumjs/common@^2.6.5": +"@ethereumjs/common@2.6.5", "@ethereumjs/common@^2.5.0", "@ethereumjs/common@^2.6.0", "@ethereumjs/common@^2.6.4", "@ethereumjs/common@^2.6.5": version "2.6.5" resolved "https://registry.yarnpkg.com/@ethereumjs/common/-/common-2.6.5.tgz#0a75a22a046272579d91919cb12d84f2756e8d30" integrity sha512-lRyVQOeCDaIVtgfbowla32pzeDv2Obr8oR8Put5RdUBNRGr1VGPGQNGP6elWIpgK3YdpzqTOh4GyUGOureVeeA== @@ -265,7 +265,7 @@ "@ethereumjs/common" "^2.6.0" ethereumjs-util "^7.1.3" -"@ethereumjs/tx@3.5.2", "@ethereumjs/tx@^3.4.0", "@ethereumjs/tx@^3.5.2": +"@ethereumjs/tx@3.5.2", "@ethereumjs/tx@^3.3.2", "@ethereumjs/tx@^3.4.0", "@ethereumjs/tx@^3.5.2": version "3.5.2" resolved "https://registry.yarnpkg.com/@ethereumjs/tx/-/tx-3.5.2.tgz#197b9b6299582ad84f9527ca961466fce2296c1c" integrity sha512-gQDNJWKrSDGu2w7w0PzVXVBNMzb7wwdDOmOqczmhNjqFxFuIbhVJDwiGEnxFNC2/b8ifcZzY7MLcluizohRzNw== @@ -300,6 +300,21 @@ merkle-patricia-tree "^4.2.2" rustbn.js "~0.2.0" +"@ethersproject/abi@5.0.7": + version "5.0.7" + resolved "https://registry.yarnpkg.com/@ethersproject/abi/-/abi-5.0.7.tgz#79e52452bd3ca2956d0e1c964207a58ad1a0ee7b" + integrity sha512-Cqktk+hSIckwP/W8O47Eef60VwmoSC/L3lY0+dIBhQPCNn9E4V7rwmm2aFrNRRDJfFlGuZ1khkQUOc3oBX+niw== + dependencies: + "@ethersproject/address" "^5.0.4" + "@ethersproject/bignumber" "^5.0.7" + "@ethersproject/bytes" "^5.0.4" + "@ethersproject/constants" "^5.0.4" + "@ethersproject/hash" "^5.0.4" + "@ethersproject/keccak256" "^5.0.3" + "@ethersproject/logger" "^5.0.5" + "@ethersproject/properties" "^5.0.3" + "@ethersproject/strings" "^5.0.4" + "@ethersproject/abi@5.7.0", "@ethersproject/abi@^5.0.0-beta.146", "@ethersproject/abi@^5.0.9", "@ethersproject/abi@^5.1.2", "@ethersproject/abi@^5.6.3", "@ethersproject/abi@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/abi/-/abi-5.7.0.tgz#b3f3e045bbbeed1af3947335c247ad625a44e449" @@ -339,7 +354,7 @@ "@ethersproject/logger" "^5.7.0" "@ethersproject/properties" "^5.7.0" -"@ethersproject/address@5.7.0", "@ethersproject/address@^5.0.2", "@ethersproject/address@^5.7.0": +"@ethersproject/address@5.7.0", "@ethersproject/address@^5.0.2", "@ethersproject/address@^5.0.4", "@ethersproject/address@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/address/-/address-5.7.0.tgz#19b56c4d74a3b0a46bfdbb6cfcc0a153fc697f37" integrity sha512-9wYhYt7aghVGo758POM5nqcOMaE168Q6aRLJZwUmiqSrAungkG74gSSeKEIR7ukixesdRZGPgVqme6vmxs1fkA== @@ -365,7 +380,7 @@ "@ethersproject/bytes" "^5.7.0" "@ethersproject/properties" "^5.7.0" -"@ethersproject/bignumber@5.7.0", "@ethersproject/bignumber@^5.7.0": +"@ethersproject/bignumber@5.7.0", "@ethersproject/bignumber@^5.0.7", "@ethersproject/bignumber@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/bignumber/-/bignumber-5.7.0.tgz#e2f03837f268ba655ffba03a57853e18a18dc9c2" integrity sha512-n1CAdIHRWjSucQO3MC1zPSVgV/6dy/fjL9pMrPP9peL+QxEg9wOsVqwD4+818B6LUEtaXzVHQiuivzRoxPxUGw== @@ -374,14 +389,14 @@ "@ethersproject/logger" "^5.7.0" bn.js "^5.2.1" -"@ethersproject/bytes@5.7.0", "@ethersproject/bytes@^5.7.0": +"@ethersproject/bytes@5.7.0", "@ethersproject/bytes@^5.0.4", "@ethersproject/bytes@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/bytes/-/bytes-5.7.0.tgz#a00f6ea8d7e7534d6d87f47188af1148d71f155d" integrity sha512-nsbxwgFXWh9NyYWo+U8atvmMsSdKJprTcICAkvbBffT75qDocbuggBU0SJiVK2MuTrp0q+xvLkTnGMPK1+uA9A== dependencies: "@ethersproject/logger" "^5.7.0" -"@ethersproject/constants@5.7.0", "@ethersproject/constants@^5.7.0": +"@ethersproject/constants@5.7.0", "@ethersproject/constants@^5.0.4", "@ethersproject/constants@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/constants/-/constants-5.7.0.tgz#df80a9705a7e08984161f09014ea012d1c75295e" integrity sha512-DHI+y5dBNvkpYUMiRQyxRBYBefZkJfo70VUkUAsRjcPs47muV9evftfZ0PJVCXYbAiCgght0DtcF9srFQmIgWA== @@ -404,7 +419,7 @@ "@ethersproject/properties" "^5.7.0" "@ethersproject/transactions" "^5.7.0" -"@ethersproject/hash@5.7.0", "@ethersproject/hash@^5.7.0": +"@ethersproject/hash@5.7.0", "@ethersproject/hash@^5.0.4", "@ethersproject/hash@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/hash/-/hash-5.7.0.tgz#eb7aca84a588508369562e16e514b539ba5240a7" integrity sha512-qX5WrQfnah1EFnO5zJv1v46a8HW0+E5xuBBDTwMFZLuVTx0tbU2kkx15NqdjxecrLGatQN9FGQKpb1FKdHCt+g== @@ -456,7 +471,7 @@ aes-js "3.0.0" scrypt-js "3.0.1" -"@ethersproject/keccak256@5.7.0", "@ethersproject/keccak256@^5.7.0": +"@ethersproject/keccak256@5.7.0", "@ethersproject/keccak256@^5.0.3", "@ethersproject/keccak256@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/keccak256/-/keccak256-5.7.0.tgz#3186350c6e1cd6aba7940384ec7d6d9db01f335a" integrity sha512-2UcPboeL/iW+pSg6vZ6ydF8tCnv3Iu/8tUmLLzWWGzxWKFFqOBQFLo6uLUv6BDrLgCDfN28RJ/wtByx+jZ4KBg== @@ -464,7 +479,7 @@ "@ethersproject/bytes" "^5.7.0" js-sha3 "0.8.0" -"@ethersproject/logger@5.7.0", "@ethersproject/logger@^5.7.0": +"@ethersproject/logger@5.7.0", "@ethersproject/logger@^5.0.5", "@ethersproject/logger@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/logger/-/logger-5.7.0.tgz#6ce9ae168e74fecf287be17062b590852c311892" integrity sha512-0odtFdXu/XHtjQXJYA3u9G0G8btm0ND5Cu8M7i5vhEcE8/HmF4Lbdqanwyv4uQTr2tx6b7fQRmgLrsnpQlmnig== @@ -484,7 +499,7 @@ "@ethersproject/bytes" "^5.7.0" "@ethersproject/sha2" "^5.7.0" -"@ethersproject/properties@5.7.0", "@ethersproject/properties@^5.7.0": +"@ethersproject/properties@5.7.0", "@ethersproject/properties@^5.0.3", "@ethersproject/properties@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/properties/-/properties-5.7.0.tgz#a6e12cb0439b878aaf470f1902a176033067ed30" integrity sha512-J87jy8suntrAkIZtecpxEPxY//szqr1mlBaYlQ0r4RCaiD2hjheqF9s1LVE8vVuJCXisjIP+JgtK/Do54ej4Sw== @@ -566,7 +581,7 @@ "@ethersproject/sha2" "^5.7.0" "@ethersproject/strings" "^5.7.0" -"@ethersproject/strings@5.7.0", "@ethersproject/strings@^5.7.0": +"@ethersproject/strings@5.7.0", "@ethersproject/strings@^5.0.4", "@ethersproject/strings@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/strings/-/strings-5.7.0.tgz#54c9d2a7c57ae8f1205c88a9d3a56471e14d5ed2" integrity sha512-/9nu+lj0YswRNSH0NXYqrh8775XNyEdUQAuf3f+SmOrnVewcJ5SBNAjF7lpgehKi4abvNNXyf+HX86czCdJ8Mg== @@ -575,7 +590,7 @@ "@ethersproject/constants" "^5.7.0" "@ethersproject/logger" "^5.7.0" -"@ethersproject/transactions@5.7.0", "@ethersproject/transactions@^5.6.2", "@ethersproject/transactions@^5.7.0": +"@ethersproject/transactions@5.7.0", "@ethersproject/transactions@^5.0.0-beta.135", "@ethersproject/transactions@^5.6.2", "@ethersproject/transactions@^5.7.0": version "5.7.0" resolved "https://registry.yarnpkg.com/@ethersproject/transactions/-/transactions-5.7.0.tgz#91318fc24063e057885a6af13fdb703e1f993d3b" integrity sha512-kmcNicCp1lp8qanMTC3RIikGgoJ80ztTyvtsFvCYpSCfkjhD0jZ2LOrnbcuxuToLIUYYf+4XwD1rP+B/erDIhQ== @@ -1322,6 +1337,11 @@ "@sentry/types" "5.30.0" tslib "^1.9.3" +"@sindresorhus/is@^0.14.0": + version "0.14.0" + resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-0.14.0.tgz#9fb3a3cf3132328151f353de4632e01e52102bea" + integrity sha512-9NET910DNaIPngYnLLPeg+Ogzqsi9uM4mSboU5y6p8S5DzMTVEsJZrawi+BoDNUVBa2DhJqQYUFvMDfgU062LQ== + "@sindresorhus/is@^4.0.0", "@sindresorhus/is@^4.6.0": version "4.6.0" resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-4.6.0.tgz#3c7c9c46e678feefe7a2e5bb609d3dbd665ffb3f" @@ -1353,6 +1373,13 @@ dependencies: antlr4ts "^0.5.0-alpha.4" +"@szmarczak/http-timer@^1.1.2": + version "1.1.2" + resolved "https://registry.yarnpkg.com/@szmarczak/http-timer/-/http-timer-1.1.2.tgz#b1665e2c461a2cd92f4c1bbf50d5454de0d4b421" + integrity sha512-XIB2XbzHTN6ieIjfIMV9hlVcfPU26s2vafYWQcZHWXHOxiaRZYEDKEwdl129Zyg50+foYV2jCgtrqSA6qNuNSA== + dependencies: + defer-to-connect "^1.0.1" + "@szmarczak/http-timer@^4.0.5": version "4.0.6" resolved "https://registry.yarnpkg.com/@szmarczak/http-timer/-/http-timer-4.0.6.tgz#b4a914bb62e7c272d4e5989fe4440f812ab1d807" @@ -1394,7 +1421,7 @@ resolved "https://registry.yarnpkg.com/@types/abstract-leveldown/-/abstract-leveldown-7.2.1.tgz#bb16403c17754b0c4d5772d71d03b924a03d4c80" integrity sha512-YK8irIC+eMrrmtGx0H4ISn9GgzLd9dojZWJaMbjp1YHLl2VqqNFBNrL5Q3KjGf4VE3sf/4hmq6EhQZ7kZp1NoQ== -"@types/bn.js@^4.11.3": +"@types/bn.js@^4.11.3", "@types/bn.js@^4.11.5": version "4.11.6" resolved "https://registry.yarnpkg.com/@types/bn.js/-/bn.js-4.11.6.tgz#c306c70d9358aaea33cd4eda092a742b9505967c" integrity sha512-pqr857jrp2kPuO9uRjZ3PwnJTjoQy+fcdxvBTvHm6dkmEL9q+hDD/2j/0ELOBPtPnS8LjCX0gI9nbl8lVkadpg== @@ -1523,6 +1550,11 @@ resolved "https://registry.yarnpkg.com/@types/node/-/node-12.20.55.tgz#c329cbd434c42164f846b909bd6f85b5537f6240" integrity sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ== +"@types/node@^15.12.2": + version "15.14.9" + resolved "https://registry.yarnpkg.com/@types/node/-/node-15.14.9.tgz#bc43c990c3c9be7281868bbc7b8fdd6e2b57adfa" + integrity sha512-qjd88DrCxupx/kJD5yQgZdcYKZKSIGBVDIBE1/LTGcNm3d2Np/jxojkdePDdfnBHJc5W7vSMpbJ1aB7p/Py69A== + "@types/node@^8.0.0": version "8.10.66" resolved "https://registry.yarnpkg.com/@types/node/-/node-8.10.66.tgz#dd035d409df322acc83dff62a602f12a5783bbb3" @@ -1572,6 +1604,23 @@ resolved "https://registry.yarnpkg.com/@types/seedrandom/-/seedrandom-3.0.1.tgz#1254750a4fec4aff2ebec088ccd0bb02e91fedb4" integrity sha512-giB9gzDeiCeloIXDgzFBCgjj1k4WxcDrZtGl6h1IqmUPlxF+Nx8Ve+96QCyDZ/HseB/uvDsKbpib9hU5cU53pw== +"@types/underscore@^1.11.4": + version "1.11.15" + resolved "https://registry.yarnpkg.com/@types/underscore/-/underscore-1.11.15.tgz#29c776daecf6f1935da9adda17509686bf979947" + integrity sha512-HP38xE+GuWGlbSRq9WrZkousaQ7dragtZCruBVMi0oX1migFZavZ3OROKHSkNp/9ouq82zrWtZpg18jFnVN96g== + +"@types/yargs-parser@*": + version "21.0.3" + resolved "https://registry.yarnpkg.com/@types/yargs-parser/-/yargs-parser-21.0.3.tgz#815e30b786d2e8f0dcd85fd5bcf5e1a04d008f15" + integrity sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ== + +"@types/yargs@^17.0.12": + version "17.0.32" + resolved "https://registry.yarnpkg.com/@types/yargs/-/yargs-17.0.32.tgz#030774723a2f7faafebf645f4e5a48371dca6229" + integrity sha512-xQ67Yc/laOG5uMfX/093MRlGGCIBzZMarVa+gfNKJxWAIgykYpVGkBdbqEzGDDfCrVUj6Hiff4mTZ5BA6TmAog== + dependencies: + "@types/yargs-parser" "*" + "@uniswap/lib@^4.0.1-alpha": version "4.0.1-alpha" resolved "https://registry.yarnpkg.com/@uniswap/lib/-/lib-4.0.1-alpha.tgz#2881008e55f075344675b3bca93f020b028fbd02" @@ -1710,6 +1759,11 @@ aes-js@3.0.0: resolved "https://registry.yarnpkg.com/aes-js/-/aes-js-3.0.0.tgz#e21df10ad6c2053295bcbb8dab40b09dbea87e4d" integrity sha512-H7wUZRn8WpTq9jocdxQ2c8x2sKo9ZVmzfRE13GiNJXfp7NcKYEdvl3vspKjXox6RIG2VtaRe4JFvxG4rqp2Zuw== +aes-js@^3.1.2: + version "3.1.2" + resolved "https://registry.yarnpkg.com/aes-js/-/aes-js-3.1.2.tgz#db9aabde85d5caabbfc0d4f2a4446960f627146a" + integrity sha512-e5pEa2kBnBOgR4Y/p20pskXI74UEz7de8ZGVo58asOtvSVG5YAbJeELPZxOmt+Bnz3rX753YKhfIn4X4l1PPRQ== + agent-base@6: version "6.0.2" resolved "https://registry.yarnpkg.com/agent-base/-/agent-base-6.0.2.tgz#49fff58577cfee3f37176feab4c22e00f86d7f77" @@ -1901,6 +1955,15 @@ asap@~2.0.6: resolved "https://registry.yarnpkg.com/asap/-/asap-2.0.6.tgz#e50347611d7e690943208bbdafebcbc2fb866d46" integrity sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA== +asn1.js@^4.10.1: + version "4.10.1" + resolved "https://registry.yarnpkg.com/asn1.js/-/asn1.js-4.10.1.tgz#b9c2bf5805f1e64aadeed6df3a2bfafb5a73f5a0" + integrity sha512-p32cOF5q0Zqs9uBiONKYLm6BClCoBCM5O9JfeUSlnQLBTxYdTK+pW+nXflm8UkKd2UYlEbYz5qEi0JuZR9ckSw== + dependencies: + bn.js "^4.0.0" + inherits "^2.0.1" + minimalistic-assert "^1.0.0" + asn1@~0.2.3: version "0.2.6" resolved "https://registry.yarnpkg.com/asn1/-/asn1-0.2.6.tgz#0d3a7bb6e64e02a90c0303b31f292868ea09a08d" @@ -1913,6 +1976,17 @@ assert-plus@1.0.0, assert-plus@^1.0.0: resolved "https://registry.yarnpkg.com/assert-plus/-/assert-plus-1.0.0.tgz#f12e0f3c5d77b0b1cdd9146942e4e96c1e4dd525" integrity sha512-NfJ4UzBCcQGLDlQq7nHxH+tv3kyZ0hHQqF5BO6J7tNJeP5do1llPr8dZ8zHonfhAu0PHAdMkSo+8o0wxg9lZWw== +assert@^2.0.0: + version "2.1.0" + resolved "https://registry.yarnpkg.com/assert/-/assert-2.1.0.tgz#6d92a238d05dc02e7427c881fb8be81c8448b2dd" + integrity sha512-eLHpSK/Y4nhMJ07gDaAzoX/XAKS8PSaojml3M0DM4JpV1LAi5JOJ/p6H/XWrl8L+DzVEvVCW1z3vWAaB9oTsQw== + dependencies: + call-bind "^1.0.2" + is-nan "^1.3.2" + object-is "^1.1.5" + object.assign "^4.1.4" + util "^0.12.5" + assertion-error@^1.1.0: version "1.1.0" resolved "https://registry.yarnpkg.com/assertion-error/-/assertion-error-1.1.0.tgz#e60b6b0e8f301bd97e5375215bda406c85118c0b" @@ -1969,6 +2043,11 @@ asynckit@^0.4.0: resolved "https://registry.yarnpkg.com/asynckit/-/asynckit-0.4.0.tgz#c79ed97f7f34cb8f2ba1bc9790bcc366474b4b79" integrity sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q== +atob@^2.1.2: + version "2.1.2" + resolved "https://registry.yarnpkg.com/atob/-/atob-2.1.2.tgz#6d9517eb9e030d2436666651e86bd9f6f13533c9" + integrity sha512-Wm6ukoaOGJi/73p/cl2GvLjTI5JM1k/O14isD73YML8StrH/7/lRFgmg8nICZgD3bZZvjwCGxtMOD3wWNAu8cg== + available-typed-arrays@^1.0.5: version "1.0.5" resolved "https://registry.yarnpkg.com/available-typed-arrays/-/available-typed-arrays-1.0.5.tgz#92f95616501069d07d10edb2fc37d3e1c65123b7" @@ -2071,6 +2150,16 @@ blakejs@^1.1.0: resolved "https://registry.yarnpkg.com/blakejs/-/blakejs-1.2.1.tgz#5057e4206eadb4a97f7c0b6e197a505042fc3814" integrity sha512-QXUSXI3QVc/gJME0dBpXrag1kbzOqCjCX8/b54ntNyW6sjtoqxqRk3LTmXzaJoh71zMsDCjM+47jS7XiwN/+fQ== +bls-eth-wasm@^1.0.4: + version "1.2.1" + resolved "https://registry.yarnpkg.com/bls-eth-wasm/-/bls-eth-wasm-1.2.1.tgz#85f165c17d8f16000f46695b56f72bf6af386825" + integrity sha512-hl4oBzZQmPGNb9Wt5GI+oEuHM6twGc5HzXCzNZMVLMMg+dltsOuvuioRyLolpDFbncC0BJbGPzP1ZTysUGkksw== + +bls-signatures@^0.2.5: + version "0.2.5" + resolved "https://registry.yarnpkg.com/bls-signatures/-/bls-signatures-0.2.5.tgz#7c285e3cb535f279d842e53d1f6e0c8ceda793d1" + integrity sha512-5TzQNCtR4zWE4lM08EOMIT8l3b4h8g5LNKu50fUYP1PnupaLGSLklAcTto4lnH7VXpyhsar+74L9wNJII4E/4Q== + bluebird@^3.5.0: version "3.7.2" resolved "https://registry.yarnpkg.com/bluebird/-/bluebird-3.7.2.tgz#9f229c15be272454ffa973ace0dbee79a1b0c36f" @@ -2081,12 +2170,12 @@ bn.js@4.11.6: resolved "https://registry.yarnpkg.com/bn.js/-/bn.js-4.11.6.tgz#53344adb14617a13f6e8dd2ce28905d1c0ba3215" integrity sha512-XWwnNNFCuuSQ0m3r3C4LE3EiORltHd9M05pq6FOlVeiophzRbMo50Sbz1ehl8K3Z+jw9+vmgnXefY1hz8X+2wA== -bn.js@^4.0.0, bn.js@^4.11.0, bn.js@^4.11.1, bn.js@^4.11.6, bn.js@^4.11.8, bn.js@^4.11.9: +bn.js@^4.0.0, bn.js@^4.1.0, bn.js@^4.11.0, bn.js@^4.11.1, bn.js@^4.11.6, bn.js@^4.11.8, bn.js@^4.11.9: version "4.12.0" resolved "https://registry.yarnpkg.com/bn.js/-/bn.js-4.12.0.tgz#775b3f278efbb9718eec7361f483fb36fbbfea88" integrity sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA== -bn.js@^5.1.2, bn.js@^5.2.0, bn.js@^5.2.1: +bn.js@^5.0.0, bn.js@^5.1.2, bn.js@^5.2.0, bn.js@^5.2.1: version "5.2.1" resolved "https://registry.yarnpkg.com/bn.js/-/bn.js-5.2.1.tgz#0bc527a6a0d18d0aa8d5b0538ce4a77dccfa7b70" integrity sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ== @@ -2151,7 +2240,7 @@ browser-stdout@1.3.1: resolved "https://registry.yarnpkg.com/browser-stdout/-/browser-stdout-1.3.1.tgz#baa559ee14ced73452229bad7326467c61fabd60" integrity sha512-qhAVI1+Av2X7qelOfAIYwXONood6XlZE/fXaBSmW/T5SzLAmCgzi+eiWE7fUvbHaeNBQH13UftjpXxsfLkMpgw== -browserify-aes@^1.2.0: +browserify-aes@^1.0.4, browserify-aes@^1.2.0: version "1.2.0" resolved "https://registry.yarnpkg.com/browserify-aes/-/browserify-aes-1.2.0.tgz#326734642f403dabc3003209853bb70ad428ef48" integrity sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA== @@ -2163,6 +2252,49 @@ browserify-aes@^1.2.0: inherits "^2.0.1" safe-buffer "^5.0.1" +browserify-cipher@^1.0.0: + version "1.0.1" + resolved "https://registry.yarnpkg.com/browserify-cipher/-/browserify-cipher-1.0.1.tgz#8d6474c1b870bfdabcd3bcfcc1934a10e94f15f0" + integrity sha512-sPhkz0ARKbf4rRQt2hTpAHqn47X3llLkUGn+xEJzLjwY8LRs2p0v7ljvI5EyoRO/mexrNunNECisZs+gw2zz1w== + dependencies: + browserify-aes "^1.0.4" + browserify-des "^1.0.0" + evp_bytestokey "^1.0.0" + +browserify-des@^1.0.0: + version "1.0.2" + resolved "https://registry.yarnpkg.com/browserify-des/-/browserify-des-1.0.2.tgz#3af4f1f59839403572f1c66204375f7a7f703e9c" + integrity sha512-BioO1xf3hFwz4kc6iBhI3ieDFompMhrMlnDFC4/0/vd5MokpuAc3R+LYbwTA9A5Yc9pq9UYPqffKpW2ObuwX5A== + dependencies: + cipher-base "^1.0.1" + des.js "^1.0.0" + inherits "^2.0.1" + safe-buffer "^5.1.2" + +browserify-rsa@^4.0.0, browserify-rsa@^4.1.0: + version "4.1.0" + resolved "https://registry.yarnpkg.com/browserify-rsa/-/browserify-rsa-4.1.0.tgz#b2fd06b5b75ae297f7ce2dc651f918f5be158c8d" + integrity sha512-AdEER0Hkspgno2aR97SAf6vi0y0k8NuOpGnVH3O99rcA5Q6sh8QxcngtHuJ6uXwnfAXNM4Gn1Gb7/MV1+Ymbog== + dependencies: + bn.js "^5.0.0" + randombytes "^2.0.1" + +browserify-sign@^4.0.0: + version "4.2.3" + resolved "https://registry.yarnpkg.com/browserify-sign/-/browserify-sign-4.2.3.tgz#7afe4c01ec7ee59a89a558a4b75bd85ae62d4208" + integrity sha512-JWCZW6SKhfhjJxO8Tyiiy+XYB7cqd2S5/+WeYHsKdNKFlCBhKbblba1A/HN/90YwtxKc8tCErjffZl++UNmGiw== + dependencies: + bn.js "^5.2.1" + browserify-rsa "^4.1.0" + create-hash "^1.2.0" + create-hmac "^1.1.7" + elliptic "^6.5.5" + hash-base "~3.0" + inherits "^2.0.4" + parse-asn1 "^5.1.7" + readable-stream "^2.3.8" + safe-buffer "^5.2.1" + bs58@^4.0.0: version "4.0.1" resolved "https://registry.yarnpkg.com/bs58/-/bs58-4.0.1.tgz#be161e76c354f6f788ae4071f63f34e8c4f0a42a" @@ -2179,6 +2311,11 @@ bs58check@^2.1.2: create-hash "^1.1.0" safe-buffer "^5.1.2" +btoa@^1.2.1: + version "1.2.1" + resolved "https://registry.yarnpkg.com/btoa/-/btoa-1.2.1.tgz#01a9909f8b2c93f6bf680ba26131eb30f7fa3d73" + integrity sha512-SB4/MIGlsiVkMcHmT+pSmIPoNDoHg+7cMzmt3Uxt628MTz2487DKSqK/fuhFBrkuqrYv5UCEnACpF4dTFNKc/g== + buffer-from@^1.0.0: version "1.1.2" resolved "https://registry.yarnpkg.com/buffer-from/-/buffer-from-1.1.2.tgz#2b146a6fd72e80b4f55d255f35ed59a3a9a41bd5" @@ -2245,6 +2382,11 @@ bufio@^1.0.7: resolved "https://registry.yarnpkg.com/bufio/-/bufio-1.2.1.tgz#8d4ab3ddfcd5faa90f996f922f9397d41cbaf2de" integrity sha512-9oR3zNdupcg/Ge2sSHQF3GX+kmvL/fTPvD0nd5AGLq8SjUYnTz+SlFjK/GXidndbZtIj+pVKXiWeR9w6e9wKCA== +builtin-modules@^1.1.1: + version "1.1.1" + resolved "https://registry.yarnpkg.com/builtin-modules/-/builtin-modules-1.1.1.tgz#270f076c5a72c02f5b65a47df94c5fe3a278892f" + integrity sha512-wxXCdllwGhI2kCC0MnvTGYTMvnVZTvqgypkiTI8Pa5tcz2i6VqsqwYGgqwXji+4RgCzms6EajE4IxiUH6HH8nQ== + busboy@^1.6.0: version "1.6.0" resolved "https://registry.yarnpkg.com/busboy/-/busboy-1.6.0.tgz#966ea36a9502e43cdb9146962523b92f531f6893" @@ -2267,6 +2409,19 @@ cacheable-lookup@^6.0.4: resolved "https://registry.yarnpkg.com/cacheable-lookup/-/cacheable-lookup-6.1.0.tgz#0330a543471c61faa4e9035db583aad753b36385" integrity sha512-KJ/Dmo1lDDhmW2XDPMo+9oiy/CeqosPguPCrgcVzKyZrL6pM1gU2GmPY/xo6OQPTUaA/c0kwHuywB4E6nmT9ww== +cacheable-request@^6.0.0: + version "6.1.0" + resolved "https://registry.yarnpkg.com/cacheable-request/-/cacheable-request-6.1.0.tgz#20ffb8bd162ba4be11e9567d823db651052ca912" + integrity sha512-Oj3cAGPCqOZX7Rz64Uny2GYAZNliQSqfbePrgAQ1wKAihYmCUnraBtJtKcGR4xz7wF+LoJC+ssFZvv5BgF9Igg== + dependencies: + clone-response "^1.0.2" + get-stream "^5.1.0" + http-cache-semantics "^4.0.0" + keyv "^3.0.0" + lowercase-keys "^2.0.0" + normalize-url "^4.1.0" + responselike "^1.0.2" + cacheable-request@^7.0.2: version "7.0.4" resolved "https://registry.yarnpkg.com/cacheable-request/-/cacheable-request-7.0.4.tgz#7a33ebf08613178b403635be7b899d3e69bbe817" @@ -2368,7 +2523,7 @@ chai@^4.3.4: pathval "^1.1.1" type-detect "^4.0.5" -chalk@^2.0.0, chalk@^2.1.0, chalk@^2.4.2: +chalk@^2.0.0, chalk@^2.1.0, chalk@^2.3.0, chalk@^2.4.2: version "2.4.2" resolved "https://registry.yarnpkg.com/chalk/-/chalk-2.4.2.tgz#cd42541677a54333cf541a49108c1432b44c9424" integrity sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ== @@ -2464,6 +2619,14 @@ class-is@^1.1.0: resolved "https://registry.yarnpkg.com/class-is/-/class-is-1.1.0.tgz#9d3c0fba0440d211d843cec3dedfa48055005825" integrity sha512-rhjH9AG1fvabIDoGRVH587413LPjTZgmDF9fOFCbFJQV4yuocX1mHxxvXI4g3cGwbVY9wAYIoKlg1N79frJKQw== +class-validator@^0.13.2: + version "0.13.2" + resolved "https://registry.yarnpkg.com/class-validator/-/class-validator-0.13.2.tgz#64b031e9f3f81a1e1dcd04a5d604734608b24143" + integrity sha512-yBUcQy07FPlGzUjoLuUfIOXzgynnQPPruyK1Ge2B74k9ROwnle1E+NxLWnUv5OLU8hA/qL5leAE9XnXq3byaBw== + dependencies: + libphonenumber-js "^1.9.43" + validator "^13.7.0" + classic-level@^1.2.0: version "1.3.0" resolved "https://registry.yarnpkg.com/classic-level/-/classic-level-1.3.0.tgz#5e36680e01dc6b271775c093f2150844c5edd5c8" @@ -2536,6 +2699,15 @@ cliui@^7.0.2: strip-ansi "^6.0.0" wrap-ansi "^7.0.0" +cliui@^8.0.1: + version "8.0.1" + resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa" + integrity sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ== + dependencies: + string-width "^4.2.0" + strip-ansi "^6.0.1" + wrap-ansi "^7.0.0" + clone-response@^1.0.2: version "1.0.3" resolved "https://registry.yarnpkg.com/clone-response/-/clone-response-1.0.3.tgz#af2032aa47816399cf5f0a1d0db902f517abb8c3" @@ -2567,7 +2739,7 @@ color-name@~1.1.4: resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.4.tgz#c2a09a87acbde69543de6f63fa3995c826c536a2" integrity sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA== -colors@1.4.0, colors@^1.1.2: +colors@1.4.0, colors@^1.1.2, colors@^1.4.0: version "1.4.0" resolved "https://registry.yarnpkg.com/colors/-/colors-1.4.0.tgz#c50491479d4c1bdaed2c9ced32cf7c7dc2360f78" integrity sha512-a+UqTh4kgZg/SlGvfbzDHpgRu7AAQOmmqRHJnxhRZICKFUT91brVhNNt58CMWU9PsBbv3PDCZUHbVxuDiH2mtA== @@ -2619,6 +2791,11 @@ commander@^10.0.0: resolved "https://registry.yarnpkg.com/commander/-/commander-10.0.1.tgz#881ee46b4f77d1c1dccc5823433aa39b022cbe06" integrity sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug== +commander@^2.12.1: + version "2.20.3" + resolved "https://registry.yarnpkg.com/commander/-/commander-2.20.3.tgz#fd485e84c03eb4881c20722ba48035e8531aeb33" + integrity sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ== + commander@^8.1.0: version "8.3.0" resolved "https://registry.yarnpkg.com/commander/-/commander-8.3.0.tgz#4837ea1b2da67b9c616a67afbb0fafee567bca66" @@ -2680,6 +2857,11 @@ cookie@^0.4.1: resolved "https://registry.yarnpkg.com/cookie/-/cookie-0.4.2.tgz#0e41f24de5ecf317947c82fc789e06a884824432" integrity sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA== +cookiejar@^2.1.1: + version "2.1.4" + resolved "https://registry.yarnpkg.com/cookiejar/-/cookiejar-2.1.4.tgz#ee669c1fea2cf42dc31585469d193fef0d65771b" + integrity sha512-LDx6oHrK+PhzLKJU9j5S7/Y3jM/mUHvD/DeI1WQmJn652iPC5Y4TBzC9l+5OMOXlyTTA+SmVUPm0HQUwpD5Jqw== + core-js-pure@^3.0.1: version "3.31.0" resolved "https://registry.yarnpkg.com/core-js-pure/-/core-js-pure-3.31.0.tgz#052fd9e82fbaaf86457f5db1fadcd06f15966ff2" @@ -2728,6 +2910,14 @@ crc-32@^1.2.0: resolved "https://registry.yarnpkg.com/crc-32/-/crc-32-1.2.2.tgz#3cad35a934b8bf71f25ca524b6da51fb7eace2ff" integrity sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ== +create-ecdh@^4.0.0: + version "4.0.4" + resolved "https://registry.yarnpkg.com/create-ecdh/-/create-ecdh-4.0.4.tgz#d6e7f4bffa66736085a0762fd3a632684dabcc4e" + integrity sha512-mf+TCx8wWc9VpuxfP2ht0iSISLZnt0JgWlrOKZiNqyUZWnjIaCIVNQArMHnCZKfEYRg6IM7A+NeJoN8gf/Ws0A== + dependencies: + bn.js "^4.1.0" + elliptic "^6.5.3" + create-hash@^1.1.0, create-hash@^1.1.2, create-hash@^1.2.0: version "1.2.0" resolved "https://registry.yarnpkg.com/create-hash/-/create-hash-1.2.0.tgz#889078af11a63756bcfb59bd221996be3a9ef196" @@ -2739,7 +2929,7 @@ create-hash@^1.1.0, create-hash@^1.1.2, create-hash@^1.2.0: ripemd160 "^2.0.1" sha.js "^2.4.0" -create-hmac@^1.1.4, create-hmac@^1.1.7: +create-hmac@^1.1.0, create-hmac@^1.1.4, create-hmac@^1.1.7: version "1.1.7" resolved "https://registry.yarnpkg.com/create-hmac/-/create-hmac-1.1.7.tgz#69170c78b3ab957147b2b8b04572e47ead2243ff" integrity sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg== @@ -2783,6 +2973,28 @@ cross-spawn@^7.0.2: resolved "https://registry.yarnpkg.com/crypt/-/crypt-0.0.2.tgz#88d7ff7ec0dfb86f713dc87bbb42d044d3e6c41b" integrity sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow== +crypto-browserify@3.12.0: + version "3.12.0" + resolved "https://registry.yarnpkg.com/crypto-browserify/-/crypto-browserify-3.12.0.tgz#396cf9f3137f03e4b8e532c58f698254e00f80ec" + integrity sha512-fz4spIh+znjO2VjL+IdhEpRJ3YN6sMzITSBijk6FK2UvTqruSQW+/cCZTSNsMiZNvUeq0CqurF+dAbyiGOY6Wg== + dependencies: + browserify-cipher "^1.0.0" + browserify-sign "^4.0.0" + create-ecdh "^4.0.0" + create-hash "^1.1.0" + create-hmac "^1.1.0" + diffie-hellman "^5.0.0" + inherits "^2.0.1" + pbkdf2 "^3.0.3" + public-encrypt "^4.0.0" + randombytes "^2.0.0" + randomfill "^1.0.3" + +crypto@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/crypto/-/crypto-1.0.1.tgz#2af1b7cad8175d24c8a1b0778255794a21803037" + integrity sha512-VxBKmeNcqQdiUQUW2Tzq0t377b54N2bMtXO/qiLa+6eRRmmC4qT3D4OnTGoT/U6O9aklQ/jTwbOtRMTTY8G0Ig== + d@1, d@^1.0.1, d@^1.0.2: version "1.0.2" resolved "https://registry.yarnpkg.com/d/-/d-1.0.2.tgz#2aefd554b81981e7dccf72d6842ae725cb17e5de" @@ -2888,6 +3100,11 @@ defender-base-client@^1.44.0: lodash "^4.17.19" node-fetch "^2.6.0" +defer-to-connect@^1.0.1: + version "1.1.3" + resolved "https://registry.yarnpkg.com/defer-to-connect/-/defer-to-connect-1.1.3.tgz#331ae050c08dcf789f8c83a7b81f0ed94f4ac591" + integrity sha512-0ISdNousHvZT2EiFlZeZAHBUvSxmKswVCEf8hW7KWgG4a8MVEu/3Vb6uWYozkjylyCxe0JBIiRB1jV45S70WVQ== + defer-to-connect@^2.0.0, defer-to-connect@^2.0.1: version "2.0.1" resolved "https://registry.yarnpkg.com/defer-to-connect/-/defer-to-connect-2.0.1.tgz#8016bdb4143e4632b77a3449c6236277de520587" @@ -2901,7 +3118,7 @@ deferred-leveldown@~5.3.0: abstract-leveldown "~6.2.1" inherits "^2.0.3" -define-data-property@^1.1.4: +define-data-property@^1.0.1, define-data-property@^1.1.4: version "1.1.4" resolved "https://registry.yarnpkg.com/define-data-property/-/define-data-property-1.1.4.tgz#894dc141bb7d3060ae4366f6a0107e68fbe48c5e" integrity sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A== @@ -2918,6 +3135,15 @@ define-properties@^1.1.2, define-properties@^1.1.3, define-properties@^1.1.4, de has-property-descriptors "^1.0.0" object-keys "^1.1.1" +define-properties@^1.2.1: + version "1.2.1" + resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.2.1.tgz#10781cc616eb951a80a034bafcaa7377f6af2b6c" + integrity sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg== + dependencies: + define-data-property "^1.0.1" + has-property-descriptors "^1.0.0" + object-keys "^1.1.1" + delayed-stream@~1.0.0: version "1.0.0" resolved "https://registry.yarnpkg.com/delayed-stream/-/delayed-stream-1.0.0.tgz#df3ae199acadfb7d440aaae0b29e2272b24ec619" @@ -2928,6 +3154,14 @@ depd@2.0.0: resolved "https://registry.yarnpkg.com/depd/-/depd-2.0.0.tgz#b696163cc757560d09cf22cc8fad1571b79e76df" integrity sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw== +des.js@^1.0.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/des.js/-/des.js-1.1.0.tgz#1d37f5766f3bbff4ee9638e871a8768c173b81da" + integrity sha512-r17GxjhUCjSRy8aiJpr8/UadFIzMzJGexI3Nmz4ADi9LYSFx4gTBp80+NaX/YsXWWLhpZ7v/v/ubEc/bCNfKwg== + dependencies: + inherits "^2.0.1" + minimalistic-assert "^1.0.0" + destroy@1.2.0: version "1.2.0" resolved "https://registry.yarnpkg.com/destroy/-/destroy-1.2.0.tgz#4803735509ad8be552934c67df614f94e66fa015" @@ -2951,6 +3185,20 @@ diff@5.0.0: resolved "https://registry.yarnpkg.com/diff/-/diff-5.0.0.tgz#7ed6ad76d859d030787ec35855f5b1daf31d852b" integrity sha512-/VTCrvm5Z0JGty/BWHljh+BAiw3IK+2j87NGMu8Nwc/f48WoDAC395uomO9ZD117ZOBaHmkX1oyLvkVM/aIT3w== +diff@^4.0.1: + version "4.0.2" + resolved "https://registry.yarnpkg.com/diff/-/diff-4.0.2.tgz#60f3aecb89d5fae520c11aa19efc2bb982aade7d" + integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A== + +diffie-hellman@^5.0.0: + version "5.0.3" + resolved "https://registry.yarnpkg.com/diffie-hellman/-/diffie-hellman-5.0.3.tgz#40e8ee98f55a2149607146921c63e1ae5f3d2875" + integrity sha512-kqag/Nl+f3GwyK25fhUMYj81BUOrZ9IuJsjIcDE5icNM9FJHAVm3VcUDxdLPoQtTuUylWm6ZIknYJwwaPxsUzg== + dependencies: + bn.js "^4.1.0" + miller-rabin "^4.0.0" + randombytes "^2.0.0" + difflib@^0.2.4: version "0.2.4" resolved "https://registry.yarnpkg.com/difflib/-/difflib-0.2.4.tgz#b5e30361a6db023176d562892db85940a718f47e" @@ -2982,6 +3230,11 @@ dotenv@^10.0.0: resolved "https://registry.yarnpkg.com/dotenv/-/dotenv-10.0.0.tgz#3d4227b8fb95f81096cdd2b66653fb2c7085ba81" integrity sha512-rlBi9d8jpv9Sf1klPjNfFAuWDjKLwTIJJ/VxtoTwIR6hnZxcEOQCZg2oIL3MWBYw5GpUDKOEnND7LXTbIpQ03Q== +duplexer3@^0.1.4: + version "0.1.5" + resolved "https://registry.yarnpkg.com/duplexer3/-/duplexer3-0.1.5.tgz#0b5e4d7bad5de8901ea4440624c8e1d20099217e" + integrity sha512-1A8za6ws41LQgv9HrE/66jyC5yuSjQ3L/KOpFtoBilsAK2iA2wuS5rTt1OCzIvtS2V7nVmedsUU+DGRcjBmOYA== + ecc-jsbn@~0.1.1: version "0.1.2" resolved "https://registry.yarnpkg.com/ecc-jsbn/-/ecc-jsbn-0.1.2.tgz#3a83a904e54353287874c564b7549386849a98c9" @@ -3008,7 +3261,7 @@ elliptic@6.5.4, elliptic@^6.5.2, elliptic@^6.5.4: minimalistic-assert "^1.0.1" minimalistic-crypto-utils "^1.0.1" -elliptic@^6.4.0: +elliptic@^6.4.0, elliptic@^6.5.3, elliptic@^6.5.5: version "6.5.5" resolved "https://registry.yarnpkg.com/elliptic/-/elliptic-6.5.5.tgz#c715e09f78b6923977610d4c2346d6ce22e6dded" integrity sha512-7EjbcmUm17NQFu4Pmgmq2olYMj8nwMnpcddByChSUjArp8F5DQWcIcpriwO4ZToLNAJig0yiyjswfyGNje/ixw== @@ -3021,6 +3274,11 @@ elliptic@^6.4.0: minimalistic-assert "^1.0.1" minimalistic-crypto-utils "^1.0.1" +emitter-component@^1.1.1: + version "1.1.2" + resolved "https://registry.yarnpkg.com/emitter-component/-/emitter-component-1.1.2.tgz#d65af5833dc7c682fd0ade35f902d16bc4bad772" + integrity sha512-QdXO3nXOzZB4pAjM0n6ZE+R9/+kPpECA/XSELIcc54NeYVnBqIk+4DFiBgK+8QbV3mdvTG6nedl7dTYgO+5wDw== + emittery@0.10.0: version "0.10.0" resolved "https://registry.yarnpkg.com/emittery/-/emittery-0.10.0.tgz#bb373c660a9d421bb44706ec4967ed50c02a8026" @@ -3488,6 +3746,21 @@ eth-lib@^0.1.26: ws "^3.0.0" xhr-request-promise "^0.1.2" +eth2-keystore-js@^1.0.8: + version "1.0.8" + resolved "https://registry.yarnpkg.com/eth2-keystore-js/-/eth2-keystore-js-1.0.8.tgz#f3ac4d6e6ec670d8d491dce25bfaf5b36475ed86" + integrity sha512-H5JLUeo7aiZs7zVAb+9gSJZZxfcx5na8zPxcgFbggNfac+atyO5H6KpvDUPJFRm/umHWM7++MdvS/q5Sbw+f9g== + dependencies: + "@types/node" "^15.12.2" + crypto "^1.0.1" + ethereumjs-util "^7.0.10" + ethereumjs-wallet "^1.0.1" + husky "^6.0.0" + scrypt-js "^3.0.1" + tslint "^6.1.3" + tslint-config-prettier "^1.18.0" + typescript "^4.3.2" + ethereum-bloom-filters@^1.0.6: version "1.0.10" resolved "https://registry.yarnpkg.com/ethereum-bloom-filters/-/ethereum-bloom-filters-1.0.10.tgz#3ca07f4aed698e75bd134584850260246a5fed8a" @@ -3580,7 +3853,7 @@ ethereumjs-util@^6.0.0, ethereumjs-util@^6.2.1: ethjs-util "0.1.6" rlp "^2.2.3" -ethereumjs-util@^7.0.3, ethereumjs-util@^7.1.0, ethereumjs-util@^7.1.1, ethereumjs-util@^7.1.3, ethereumjs-util@^7.1.4, ethereumjs-util@^7.1.5: +ethereumjs-util@^7.0.10, ethereumjs-util@^7.0.3, ethereumjs-util@^7.1.0, ethereumjs-util@^7.1.1, ethereumjs-util@^7.1.2, ethereumjs-util@^7.1.3, ethereumjs-util@^7.1.4, ethereumjs-util@^7.1.5: version "7.1.5" resolved "https://registry.yarnpkg.com/ethereumjs-util/-/ethereumjs-util-7.1.5.tgz#9ecf04861e4fbbeed7465ece5f23317ad1129181" integrity sha512-SDl5kKrQAudFBUe5OJM9Ac6WmMyYmXX/6sTmLZ3ffG2eY6ZIGBes3pEDxNN6V72WyOw4CPD5RomKdsa8DAAwLg== @@ -3591,6 +3864,20 @@ ethereumjs-util@^7.0.3, ethereumjs-util@^7.1.0, ethereumjs-util@^7.1.1, ethereum ethereum-cryptography "^0.1.3" rlp "^2.2.4" +ethereumjs-wallet@^1.0.1: + version "1.0.2" + resolved "https://registry.yarnpkg.com/ethereumjs-wallet/-/ethereumjs-wallet-1.0.2.tgz#2c000504b4c71e8f3782dabe1113d192522e99b6" + integrity sha512-CCWV4RESJgRdHIvFciVQFnCHfqyhXWchTPlkfp28Qc53ufs+doi5I/cV2+xeK9+qEo25XCWfP9MiL+WEPAZfdA== + dependencies: + aes-js "^3.1.2" + bs58check "^2.1.2" + ethereum-cryptography "^0.1.3" + ethereumjs-util "^7.1.2" + randombytes "^2.1.0" + scrypt-js "^3.0.1" + utf8 "^3.0.0" + uuid "^8.3.2" + ethers@^4.0.40: version "4.0.49" resolved "https://registry.yarnpkg.com/ethers/-/ethers-4.0.49.tgz#0eb0e9161a0c8b4761be547396bbe2fb121a8894" @@ -3676,7 +3963,12 @@ eventemitter3@4.0.4: resolved "https://registry.yarnpkg.com/eventemitter3/-/eventemitter3-4.0.4.tgz#b5463ace635a083d018bdc7c917b4c5f10a85384" integrity sha512-rlaVLnVxtxvoyLsQQFBx53YmXHDxRIzzTLbdfxqi4yocpSjAxXwkU0cScM5JgSKMqEhrZpnvQ2D9gjylR0AimQ== -evp_bytestokey@^1.0.3: +events@^3.3.0: + version "3.3.0" + resolved "https://registry.yarnpkg.com/events/-/events-3.3.0.tgz#31a95ad0a924e2d2c419a813aeb2c4e878ea7400" + integrity sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q== + +evp_bytestokey@^1.0.0, evp_bytestokey@^1.0.3: version "1.0.3" resolved "https://registry.yarnpkg.com/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz#7fcbdb198dc71959432efe13842684e0525acb02" integrity sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA== @@ -4151,6 +4443,20 @@ get-port@^3.1.0: resolved "https://registry.yarnpkg.com/get-port/-/get-port-3.2.0.tgz#dd7ce7de187c06c8bf353796ac71e099f0980ebc" integrity sha512-x5UJKlgeUiNT8nyo/AcnwLnZuZNcSjSw0kogRB+Whd1fjjFq4B1hySFxSFWWSn4mIBzg3sRNUDFYc4g5gjPoLg== +get-random-values@^1.2.0: + version "1.2.2" + resolved "https://registry.yarnpkg.com/get-random-values/-/get-random-values-1.2.2.tgz#f1d944d0025433d53a2bd9941b9e975d98a2f7ff" + integrity sha512-lMyPjQyl0cNNdDf2oR+IQ/fM3itDvpoHy45Ymo2r0L1EjazeSl13SfbKZs7KtZ/3MDCeueiaJiuOEfKqRTsSgA== + dependencies: + global "^4.4.0" + +get-stream@^4.1.0: + version "4.1.0" + resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-4.1.0.tgz#c1b255575f3dc21d59bfc79cd3d2b46b1c3a54b5" + integrity sha512-GMat4EJ5161kIy2HevLlr4luNjBgvmj413KaQA7jt4V8B4RDsfpHk7WQ9GVqfYyyx8OS/L66Kox+rJRNklLK7w== + dependencies: + pump "^3.0.0" + get-stream@^5.1.0: version "5.2.0" resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-5.2.0.tgz#4966a1795ee5ace65e706c4b7beb71257d6e22d3" @@ -4240,7 +4546,7 @@ glob@^5.0.15: once "^1.3.0" path-is-absolute "^1.0.0" -glob@^7.0.0, glob@^7.1.2, glob@^7.1.3, glob@^7.1.6: +glob@^7.0.0, glob@^7.1.1, glob@^7.1.2, glob@^7.1.3, glob@^7.1.6: version "7.2.3" resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.3.tgz#b8df0fb802bbfa8e89bd1d938b4e16578ed44f2b" integrity sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q== @@ -4279,7 +4585,7 @@ global-prefix@^3.0.0: kind-of "^6.0.2" which "^1.3.1" -global@~4.4.0: +global@^4.4.0, global@~4.4.0: version "4.4.0" resolved "https://registry.yarnpkg.com/global/-/global-4.4.0.tgz#3e7b105179006a323ed71aafca3e9c57a5cc6406" integrity sha512-wv/LAoHdRE3BeTGz53FAamhGlPLhlssK45usmGFThIi4XqnBmjKQ16u+RNbP7WvigRZDxUsM0J3gcQ5yicaL0w== @@ -4346,6 +4652,23 @@ got@12.1.0: p-cancelable "^3.0.0" responselike "^2.0.0" +got@9.6.0: + version "9.6.0" + resolved "https://registry.yarnpkg.com/got/-/got-9.6.0.tgz#edf45e7d67f99545705de1f7bbeeeb121765ed85" + integrity sha512-R7eWptXuGYxwijs0eV+v3o6+XH1IqVK8dJOEecQfTmkncw9AV4dcw/Dhxi8MdlqPthxxpZyizMzyg8RTmEsG+Q== + dependencies: + "@sindresorhus/is" "^0.14.0" + "@szmarczak/http-timer" "^1.1.2" + cacheable-request "^6.0.0" + decompress-response "^3.3.0" + duplexer3 "^0.1.4" + get-stream "^4.1.0" + lowercase-keys "^1.0.1" + mimic-response "^1.0.1" + p-cancelable "^1.0.0" + to-readable-stream "^1.0.0" + url-parse-lax "^3.0.0" + got@^11.8.5: version "11.8.6" resolved "https://registry.yarnpkg.com/got/-/got-11.8.6.tgz#276e827ead8772eddbcfc97170590b841823233a" @@ -4589,6 +4912,14 @@ hash-base@^3.0.0: readable-stream "^3.6.0" safe-buffer "^5.2.0" +hash-base@~3.0: + version "3.0.4" + resolved "https://registry.yarnpkg.com/hash-base/-/hash-base-3.0.4.tgz#5fc8686847ecd73499403319a6b0a3f3f6ae4918" + integrity sha512-EeeoJKjTyt868liAlVmcv2ZsUfGHlE3Q+BICOXcZiwN3osr5Q/zFGYmTJpoIzuaSTAwndFy+GqhEwlU4L3j4Ow== + dependencies: + inherits "^2.0.1" + safe-buffer "^5.0.1" + hash.js@1.1.3: version "1.1.3" resolved "https://registry.yarnpkg.com/hash.js/-/hash.js-1.1.3.tgz#340dedbe6290187151c1ea1d777a3448935df846" @@ -4707,6 +5038,11 @@ https-proxy-agent@^5.0.0: agent-base "6" debug "4" +husky@^6.0.0: + version "6.0.0" + resolved "https://registry.yarnpkg.com/husky/-/husky-6.0.0.tgz#810f11869adf51604c32ea577edbc377d7f9319e" + integrity sha512-SQS2gDTB7tBN486QSoKPKQItZw97BMOd+Kdb6ghfpBc0yXyzrddI0oDV5MkDAbuB4X2mO3/nj60TRMcYxwzZeQ== + husky@^7.0.2: version "7.0.4" resolved "https://registry.yarnpkg.com/husky/-/husky-7.0.4.tgz#242048245dc49c8fb1bf0cc7cfb98dd722531535" @@ -4916,6 +5252,13 @@ is-core-module@^2.11.0: dependencies: has "^1.0.3" +is-core-module@^2.13.0: + version "2.13.1" + resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.13.1.tgz#ad0d7532c6fea9da1ebdc82742d74525c6273384" + integrity sha512-hHrIjvZsftOsvKSn2TRYl63zvxsgE0K+0mYMoH6gD4omR5IWB2KynivBQczo3+wF1cCkjzvptnI9Q0sPU66ilw== + dependencies: + hasown "^2.0.0" + is-date-object@^1.0.1: version "1.0.5" resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.5.tgz#0841d5536e724c25597bf6ea62e1bd38298df31f" @@ -4967,6 +5310,14 @@ is-hex-prefixed@1.0.0: resolved "https://registry.yarnpkg.com/is-hex-prefixed/-/is-hex-prefixed-1.0.0.tgz#7d8d37e6ad77e5d127148913c573e082d777f554" integrity sha512-WvtOiug1VFrE9v1Cydwm+FnXd3+w9GaeVUss5W4v/SLy3UW00vP+6iNF2SdnfiBoLy4bTqVdkftNGTUeOFVsbA== +is-nan@^1.3.2: + version "1.3.2" + resolved "https://registry.yarnpkg.com/is-nan/-/is-nan-1.3.2.tgz#043a54adea31748b55b6cd4e09aadafa69bd9e1d" + integrity sha512-E+zBKpQ2t6MEo1VsonYmluk9NxGrbzpeeLC2xIViuO2EjU2xsXsBPwTr3Ykv9l08UYEVEdWeRZNouaZqF6RN0w== + dependencies: + call-bind "^1.0.0" + define-properties "^1.1.3" + is-negative-zero@^2.0.2: version "2.0.2" resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.2.tgz#7bf6f03a28003b8b3965de3ac26f664d765f3150" @@ -5086,6 +5437,11 @@ isstream@~0.1.2: resolved "https://registry.yarnpkg.com/isstream/-/isstream-0.1.2.tgz#47e63f7af55afa6f92e1500e690eb8b8529c099a" integrity sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g== +js-base64@^3.7.2: + version "3.7.7" + resolved "https://registry.yarnpkg.com/js-base64/-/js-base64-3.7.7.tgz#e51b84bf78fbf5702b9541e2cb7bfcb893b43e79" + integrity sha512-7rCnleh0z2CkXhH67J8K1Ytz0b2Y+yxTPL+/KOJoa20hfnVQ/3/T6W/KflYI4bRHRagNeXeU2bkNGI3v1oS/lw== + js-cookie@^2.2.1: version "2.2.1" resolved "https://registry.yarnpkg.com/js-cookie/-/js-cookie-2.2.1.tgz#69e106dc5d5806894562902aa5baec3744e9b2b8" @@ -5139,6 +5495,11 @@ jsbn@~0.1.0: resolved "https://registry.yarnpkg.com/jsbn/-/jsbn-0.1.1.tgz#a5e654c2e5a2deb5f201d96cefbca80c0ef2f513" integrity sha512-UVU9dibq2JcFWxQPA6KCqj5O42VOmAY3zQUfEKxU0KpTGXwNoCjkX1e13eHNvw/xPynt6pU0rZ1htjWTNTSXsg== +jsencrypt@3.2.1: + version "3.2.1" + resolved "https://registry.yarnpkg.com/jsencrypt/-/jsencrypt-3.2.1.tgz#09766983cc760088ff26b12fe7e574252af97727" + integrity sha512-k1sD5QV0KPn+D8uG9AdGzTQuamt82QZ3A3l6f7TRwMU6Oi2Vg0BsL+wZIQBONcraO1pc78ExMdvmBBJ8WhNYUA== + json-bigint@^1.0.0: version "1.0.0" resolved "https://registry.yarnpkg.com/json-bigint/-/json-bigint-1.0.0.tgz#ae547823ac0cad8398667f8cd9ef4730f5b01ff1" @@ -5146,6 +5507,11 @@ json-bigint@^1.0.0: dependencies: bignumber.js "^9.0.0" +json-buffer@3.0.0: + version "3.0.0" + resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.0.tgz#5b1f397afc75d677bde8bcfc0e47e1f9a3d9a898" + integrity sha512-CuUqjv0FUZIdXkHPI8MezCnFCdaTAacej1TZYulLoAg1h/PhwkdXFN4V/gzY4g+fMBCOV2xF+rp7t2XD2ns/NQ== + json-buffer@3.0.1: version "3.0.1" resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.1.tgz#9338802a30d3b6605fbe0613e094008ca8c05a13" @@ -5260,6 +5626,13 @@ keccak@^3.0.0, keccak@^3.0.2: node-gyp-build "^4.2.0" readable-stream "^3.6.0" +keyv@^3.0.0: + version "3.1.0" + resolved "https://registry.yarnpkg.com/keyv/-/keyv-3.1.0.tgz#ecc228486f69991e49e9476485a5be1e8fc5c4d9" + integrity sha512-9ykJ/46SN/9KPM/sichzQ7OvXyGDYKGTaDlKMGCAlg2UK8KRy4jb0d8sFc+0Tt0YYnThq8X2RZgCg74RPxgcVA== + dependencies: + json-buffer "3.0.0" + keyv@^4.0.0: version "4.5.4" resolved "https://registry.yarnpkg.com/keyv/-/keyv-4.5.4.tgz#a879a99e29452f942439f2a405e3af8b31d4de93" @@ -5279,6 +5652,11 @@ klaw@^1.0.0: optionalDependencies: graceful-fs "^4.1.9" +kleur@^4.0.1: + version "4.1.5" + resolved "https://registry.yarnpkg.com/kleur/-/kleur-4.1.5.tgz#95106101795f7050c6c650f350c683febddb1780" + integrity sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ== + level-codec@^9.0.0: version "9.0.2" resolved "https://registry.yarnpkg.com/level-codec/-/level-codec-9.0.2.tgz#fd60df8c64786a80d44e63423096ffead63d8cbc" @@ -5408,6 +5786,11 @@ levn@^0.4.1: prelude-ls "^1.2.1" type-check "~0.4.0" +libphonenumber-js@^1.9.43: + version "1.10.61" + resolved "https://registry.yarnpkg.com/libphonenumber-js/-/libphonenumber-js-1.10.61.tgz#efd350a6283e5d6a804f0cd17dae1f563410241d" + integrity sha512-TsQsyzDttDvvzWNkbp/i0fVbzTGJIG0mUu/uNalIaRQEYeJxVQ/FPg+EJgSqfSXezREjM0V3RZ8cLVsKYhhw0Q== + lie@~3.3.0: version "3.3.0" resolved "https://registry.yarnpkg.com/lie/-/lie-3.3.0.tgz#dcf82dee545f46074daf200c7c1c5a08e0f40f6a" @@ -5485,6 +5868,11 @@ loupe@^2.3.1: dependencies: get-func-name "^2.0.0" +lowercase-keys@^1.0.0, lowercase-keys@^1.0.1: + version "1.0.1" + resolved "https://registry.yarnpkg.com/lowercase-keys/-/lowercase-keys-1.0.1.tgz#6f9e30b47084d971a7c820ff15a6c5167b74c26f" + integrity sha512-G2Lj61tXDnVFFOi8VZds+SoQjtQC3dgokKdDG2mTm1tx4m50NUHBOZSBwQQHyy0V12A0JTG4icfZQH+xPyh8VA== + lowercase-keys@^2.0.0: version "2.0.0" resolved "https://registry.yarnpkg.com/lowercase-keys/-/lowercase-keys-2.0.0.tgz#2603e78b7b4b0006cbca2fbcc8a3202558ac9479" @@ -5644,7 +6032,7 @@ mimic-fn@^1.0.0: resolved "https://registry.yarnpkg.com/mimic-fn/-/mimic-fn-1.2.0.tgz#820c86a39334640e99516928bd03fca88057d022" integrity sha512-jf84uxzwiuiIVKiOLpfYk7N46TSy8ubTonmneY9vrpHNAnp0QBt2BxWV9dO3/j+BoVAb+a5G6YDPW3M5HOdMWQ== -mimic-response@^1.0.0: +mimic-response@^1.0.0, mimic-response@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/mimic-response/-/mimic-response-1.0.1.tgz#4923538878eef42063cb8a3e3b0798781487ab1b" integrity sha512-j5EctnkH7amfV/q5Hgmoal1g2QHFJRraOtmx0JpIqkxhBhI/lJSl1nMpQ45hVarwNETOoWEimndZ4QK0RHxuxQ== @@ -5738,7 +6126,7 @@ mkdirp@0.5.5: dependencies: minimist "^1.2.5" -mkdirp@0.5.x, mkdirp@^0.5.1, mkdirp@^0.5.5: +mkdirp@0.5.x, mkdirp@^0.5.1, mkdirp@^0.5.3, mkdirp@^0.5.5: version "0.5.6" resolved "https://registry.yarnpkg.com/mkdirp/-/mkdirp-0.5.6.tgz#7def03d2432dcae4ba1d611445c48396062255f6" integrity sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw== @@ -5854,6 +6242,11 @@ module-error@^1.0.1, module-error@^1.0.2: resolved "https://registry.yarnpkg.com/module-error/-/module-error-1.0.2.tgz#8d1a48897ca883f47a45816d4fb3e3c6ba404d86" integrity sha512-0yuvsqSCv8LbaOKhnsQ/T5JhyFlCYLPXK3U2sgV10zoKQwzs/MyfuQUOZQ1V/6OCOJsK/TRgNVrPuPDqtdMFtA== +moment@^2.29.3: + version "2.30.1" + resolved "https://registry.yarnpkg.com/moment/-/moment-2.30.1.tgz#f8c91c07b7a786e30c59926df530b4eac96974ae" + integrity sha512-uEmtNhbDOrWPFS+hdjFCBfy9f2YoyzRpwcl+DqpC6taX21FzsTLQVbMV/W7PzNSX6x/bhC1zA3c2UQ5NzH6how== + ms@2.0.0: version "2.0.0" resolved "https://registry.yarnpkg.com/ms/-/ms-2.0.0.tgz#5608aeadfc00be6c2901df5f9861788de0d597c8" @@ -6022,6 +6415,13 @@ node-gyp-build@^4.2.0, node-gyp-build@^4.3.0: resolved "https://registry.yarnpkg.com/node-gyp-build/-/node-gyp-build-4.6.0.tgz#0c52e4cbf54bbd28b709820ef7b6a3c2d6209055" integrity sha512-NTZVKn9IylLwUzaKjkas1e4u2DLNcV4rdYagA4PWdPwW87Bi7z+BznyKSRwS/761tV/lzCGXplWsiaMjLqP2zQ== +node-jsencrypt@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/node-jsencrypt/-/node-jsencrypt-1.0.0.tgz#83ffced414ecbe12fea017c6c585c9bfc49ad19b" + integrity sha512-ANQ/XkOVS02R89MtfoelFxarMsLA12nlOT802VS4LVhl+JRSRZIvkLIjvKYZmIar+mENUkR9mBKUdcdiPy/7lA== + dependencies: + get-random-values "^1.2.0" + nofilter@^3.1.0: version "3.1.0" resolved "https://registry.yarnpkg.com/nofilter/-/nofilter-3.1.0.tgz#c757ba68801d41ff930ba2ec55bab52ca184aa66" @@ -6039,6 +6439,11 @@ normalize-path@^3.0.0, normalize-path@~3.0.0: resolved "https://registry.yarnpkg.com/normalize-path/-/normalize-path-3.0.0.tgz#0dcd69ff23a1c9b11fd0978316644a0388216a65" integrity sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA== +normalize-url@^4.1.0: + version "4.5.1" + resolved "https://registry.yarnpkg.com/normalize-url/-/normalize-url-4.5.1.tgz#0dd90cf1288ee1d1313b87081c9a5932ee48518a" + integrity sha512-9UZCFRHQdNrfTpGg8+1INIg93B6zE0aXMVFkw1WFwvO4SlZywU6aLg5Of0Ap/PgcbSw4LNxvMWXMeugwMCX0AA== + normalize-url@^6.0.1: version "6.1.0" resolved "https://registry.yarnpkg.com/normalize-url/-/normalize-url-6.1.0.tgz#40d0885b535deffe3f3147bec877d05fe4c5668a" @@ -6067,6 +6472,14 @@ object-inspect@^1.12.3, object-inspect@^1.9.0: resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.12.3.tgz#ba62dffd67ee256c8c086dfae69e016cd1f198b9" integrity sha512-geUvdk7c+eizMNUDkRpW1wJwgfOiOeHbxBR/hLXK1aT6zmVSO0jsQcs7fj6MGw89jC/cjGfLcNOrtMYtGqm81g== +object-is@^1.1.5: + version "1.1.6" + resolved "https://registry.yarnpkg.com/object-is/-/object-is-1.1.6.tgz#1a6a53aed2dd8f7e6775ff870bea58545956ab07" + integrity sha512-F8cZ+KfGlSGi09lJT7/Nd6KJZ9ygtvYC0/UYYLI9nmQKLMnydpB9yvbv9K1uSkEu7FU9vYPmVwLg328tX+ot3Q== + dependencies: + call-bind "^1.0.7" + define-properties "^1.2.1" + object-keys@^1.0.11, object-keys@^1.1.1: version "1.1.1" resolved "https://registry.yarnpkg.com/object-keys/-/object-keys-1.1.1.tgz#1c47f272df277f3b1daf061677d9c82e2322c60e" @@ -6165,6 +6578,11 @@ os-tmpdir@~1.0.2: resolved "https://registry.yarnpkg.com/os-tmpdir/-/os-tmpdir-1.0.2.tgz#bbe67406c79aa85c5cfec766fe5734555dfa1274" integrity sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g== +p-cancelable@^1.0.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/p-cancelable/-/p-cancelable-1.1.0.tgz#d078d15a3af409220c886f1d9a0ca2e441ab26cc" + integrity sha512-s73XxOZ4zpt1edZYZzvhqFa6uvQc1vwUa0K0BdtIZgQMAJj9IbebH+JkgKZc9h+B05PKHLOTl4ajG1BmNrVZlw== + p-cancelable@^2.0.0: version "2.1.1" resolved "https://registry.yarnpkg.com/p-cancelable/-/p-cancelable-2.1.1.tgz#aab7fbd416582fa32a3db49859c122487c5ed2cf" @@ -6251,6 +6669,18 @@ parent-module@^1.0.0: dependencies: callsites "^3.0.0" +parse-asn1@^5.0.0, parse-asn1@^5.1.7: + version "5.1.7" + resolved "https://registry.yarnpkg.com/parse-asn1/-/parse-asn1-5.1.7.tgz#73cdaaa822125f9647165625eb45f8a051d2df06" + integrity sha512-CTM5kuWR3sx9IFamcl5ErfPl6ea/N8IYwiJ+vpeB2g+1iknv7zBl5uPwbMbRVznRVbrNY6lGuDoE5b30grmbqg== + dependencies: + asn1.js "^4.10.1" + browserify-aes "^1.2.0" + evp_bytestokey "^1.0.3" + hash-base "~3.0" + pbkdf2 "^3.1.2" + safe-buffer "^5.2.1" + parse-cache-control@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/parse-cache-control/-/parse-cache-control-1.0.1.tgz#8eeab3e54fa56920fe16ba38f77fa21aacc2d74e" @@ -6339,7 +6769,7 @@ pathval@^1.1.1: resolved "https://registry.yarnpkg.com/pathval/-/pathval-1.1.1.tgz#8534e77a77ce7ac5a2512ea21e0fdb8fcf6c3d8d" integrity sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ== -pbkdf2@^3.0.17, pbkdf2@^3.0.9: +pbkdf2@^3.0.17, pbkdf2@^3.0.3, pbkdf2@^3.0.9, pbkdf2@^3.1.2: version "3.1.2" resolved "https://registry.yarnpkg.com/pbkdf2/-/pbkdf2-3.1.2.tgz#dd822aa0887580e52f1a039dc3eda108efae3075" integrity sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA== @@ -6396,6 +6826,11 @@ prelude-ls@~1.1.2: resolved "https://registry.yarnpkg.com/prelude-ls/-/prelude-ls-1.1.2.tgz#21932a549f5e52ffd9a827f570e04be62a97da54" integrity sha512-ESF23V4SKG6lVSGZgYNpbsiaAkdab6ZgOxe52p7+Kid3W3u3bxR4Vfd/o21dmN7jSt0IwgZ4v5MUd26FEtXE9w== +prepend-http@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/prepend-http/-/prepend-http-2.0.0.tgz#e92434bfa5ea8c19f41cdfd401d741a3c819d897" + integrity sha512-ravE6m9Atw9Z/jjttRUZ+clIXogdghyZAuWJ3qEzjT+jI/dL1ifAqhZeC5VHzQp1MSt1+jxKkFNemj/iO7tVUA== + prettier-plugin-solidity@1.0.0-beta.17: version "1.0.0-beta.17" resolved "https://registry.yarnpkg.com/prettier-plugin-solidity/-/prettier-plugin-solidity-1.0.0-beta.17.tgz#fc0fe977202b6503763a338383efeceaa6c7661e" @@ -6440,6 +6875,13 @@ promise@^8.0.0: dependencies: asap "~2.0.6" +"prompts@git+https://github.com/meshin-blox/prompts.git": + version "2.4.2" + resolved "git+https://github.com/meshin-blox/prompts.git#a22bdac044f6b32ba67adb4eacc2e58322512a2d" + dependencies: + kleur "^4.0.1" + sisteransi "^1.0.5" + proper-lockfile@^4.1.1: version "4.1.2" resolved "https://registry.yarnpkg.com/proper-lockfile/-/proper-lockfile-4.1.2.tgz#c8b9de2af6b2f1601067f98e01ac66baa223141f" @@ -6472,6 +6914,18 @@ psl@^1.1.28: resolved "https://registry.yarnpkg.com/psl/-/psl-1.9.0.tgz#d0df2a137f00794565fcaf3b2c00cd09f8d5a5a7" integrity sha512-E/ZsdU4HLs/68gYzgGTkMicWTLPdAftJLfJFlLUAAKZGkStNU72sZjT66SnMDVOfOWY/YAoiD7Jxa9iHvngcag== +public-encrypt@^4.0.0: + version "4.0.3" + resolved "https://registry.yarnpkg.com/public-encrypt/-/public-encrypt-4.0.3.tgz#4fcc9d77a07e48ba7527e7cbe0de33d0701331e0" + integrity sha512-zVpa8oKZSz5bTMTFClc1fQOnyyEzpl5ozpi1B5YcvBrdohMjH2rfsBtyXcuNuwjsDIXmBYlF2N5FlJYhR29t8Q== + dependencies: + bn.js "^4.1.0" + browserify-rsa "^4.0.0" + create-hash "^1.1.0" + parse-asn1 "^5.0.0" + randombytes "^2.0.1" + safe-buffer "^5.1.2" + pump@^3.0.0: version "3.0.0" resolved "https://registry.yarnpkg.com/pump/-/pump-3.0.0.tgz#b4a2116815bde2f4e1ea602354e8c75565107a64" @@ -6533,13 +6987,21 @@ quick-lru@^5.1.1: resolved "https://registry.yarnpkg.com/quick-lru/-/quick-lru-5.1.1.tgz#366493e6b3e42a3a6885e2e99d18f80fb7a8c932" integrity sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA== -randombytes@^2.0.1, randombytes@^2.1.0: +randombytes@^2.0.0, randombytes@^2.0.1, randombytes@^2.0.5, randombytes@^2.1.0: version "2.1.0" resolved "https://registry.yarnpkg.com/randombytes/-/randombytes-2.1.0.tgz#df6f84372f0270dc65cdf6291349ab7a473d4f2a" integrity sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ== dependencies: safe-buffer "^5.1.0" +randomfill@^1.0.3: + version "1.0.4" + resolved "https://registry.yarnpkg.com/randomfill/-/randomfill-1.0.4.tgz#c92196fc86ab42be983f1bf31778224931d61458" + integrity sha512-87lcbR8+MhcWcUiQ+9e+Rwx8MyR2P7qnt15ynUlbm3TU/fjbgz4GsvfSUDTemtCCtVCqb4ZcEFlyPNTh9bBTLw== + dependencies: + randombytes "^2.0.5" + safe-buffer "^5.1.0" + range-parser@~1.2.1: version "1.2.1" resolved "https://registry.yarnpkg.com/range-parser/-/range-parser-1.2.1.tgz#3cf37023d199e1c24d1a55b84800c2f3e6468031" @@ -6555,7 +7017,7 @@ raw-body@2.5.2, raw-body@^2.4.1: iconv-lite "0.4.24" unpipe "1.0.0" -readable-stream@^2.2.2, readable-stream@~2.3.6: +readable-stream@^2.2.2, readable-stream@^2.3.8, readable-stream@~2.3.6: version "2.3.8" resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-2.3.8.tgz#91125e8042bba1b9887f49345f6277027ce8be9b" integrity sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA== @@ -6736,6 +7198,22 @@ resolve@^1.1.6: path-parse "^1.0.7" supports-preserve-symlinks-flag "^1.0.0" +resolve@^1.3.2: + version "1.22.8" + resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.22.8.tgz#b6c87a9f2aa06dfab52e3d70ac8cde321fa5a48d" + integrity sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw== + dependencies: + is-core-module "^2.13.0" + path-parse "^1.0.7" + supports-preserve-symlinks-flag "^1.0.0" + +responselike@^1.0.2: + version "1.0.2" + resolved "https://registry.yarnpkg.com/responselike/-/responselike-1.0.2.tgz#918720ef3b631c5642be068f15ade5a46f4ba1e7" + integrity sha512-/Fpe5guzJk1gPqdJLJR5u7eG/gNY4nImjbRDaVWVMRhne55TCmj2i9Q+54PBRfatRC8v/rIiv9BN0pMd9OV5EQ== + dependencies: + lowercase-keys "^1.0.0" + responselike@^2.0.0: version "2.0.1" resolved "https://registry.yarnpkg.com/responselike/-/responselike-2.0.1.tgz#9a0bc8fdc252f3fb1cca68b016591059ba1422bc" @@ -6923,6 +7401,11 @@ semaphore-async-await@^1.5.1: resolved "https://registry.yarnpkg.com/semaphore-async-await/-/semaphore-async-await-1.5.1.tgz#857bef5e3644601ca4b9570b87e9df5ca12974fa" integrity sha512-b/ptP11hETwYWpeilHXXQiV5UJNJl7ZWWooKRE5eBIYWoom6dZ0SluCIdCtKycsMtZgKWE01/qAw6jblw1YVhg== +semver@^5.3.0: + version "5.7.2" + resolved "https://registry.yarnpkg.com/semver/-/semver-5.7.2.tgz#48d55db737c3287cd4835e17fa13feace1c41ef8" + integrity sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g== + semver@^5.5.0, semver@^5.5.1, semver@^5.7.0: version "5.7.1" resolved "https://registry.yarnpkg.com/semver/-/semver-5.7.1.tgz#a954f931aeba508d307bbf069eff0c01c96116f7" @@ -6940,6 +7423,13 @@ semver@^7.2.1, semver@^7.3.4, semver@^7.3.5: dependencies: lru-cache "^6.0.0" +semver@^7.5.1: + version "7.6.0" + resolved "https://registry.yarnpkg.com/semver/-/semver-7.6.0.tgz#1a46a4db4bffcccd97b743b5005c8325f23d4e2d" + integrity sha512-EnwXhrlwXMk9gKu5/flx5sv/an57AkRplG3hTK68W7FRDN+k+OWBj65M7719OkA82XLBxrcX0KSHj+X5COhOVg== + dependencies: + lru-cache "^6.0.0" + send@0.18.0: version "0.18.0" resolved "https://registry.yarnpkg.com/send/-/send-0.18.0.tgz#670167cc654b05f5aa4a767f9113bb371bc706be" @@ -7096,6 +7586,11 @@ simple-get@^2.7.0: once "^1.3.1" simple-concat "^1.0.0" +sisteransi@^1.0.5: + version "1.0.5" + resolved "https://registry.yarnpkg.com/sisteransi/-/sisteransi-1.0.5.tgz#134d681297756437cc05ca01370d3a7a571075ed" + integrity sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg== + slash@^3.0.0: version "3.0.0" resolved "https://registry.yarnpkg.com/slash/-/slash-3.0.0.tgz#6539be870c165adbd5240220dbe361f1bc4d4634" @@ -7290,6 +7785,42 @@ sshpk@^1.7.0: safer-buffer "^2.0.2" tweetnacl "~0.14.0" +ssv-keys@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/ssv-keys/-/ssv-keys-1.1.0.tgz#bbd5f7c0c51cb16899938c8ea6aab543f1ef6963" + integrity sha512-nKxKbGkqhw3pPHfDvwOgOSD5IYLRx7WPxBJQRMorzv0q6FIFUl7T+sBbBzL0AHvv4H/BBNUFQyHBRSo6TIrRyA== + dependencies: + "@types/figlet" "^1.5.4" + "@types/underscore" "^1.11.4" + "@types/yargs" "^17.0.12" + argparse "^2.0.1" + assert "^2.0.0" + atob "^2.1.2" + bls-eth-wasm "^1.0.4" + bls-signatures "^0.2.5" + btoa "^1.2.1" + class-validator "^0.13.2" + colors "^1.4.0" + crypto "^1.0.1" + eth2-keystore-js "^1.0.8" + ethereumjs-util "^7.1.5" + ethereumjs-wallet "^1.0.1" + ethers "^5.7.2" + events "^3.3.0" + figlet "^1.5.2" + js-base64 "^3.7.2" + jsencrypt "3.2.1" + minimist "^1.2.6" + moment "^2.29.3" + node-jsencrypt "^1.0.0" + prompts "https://github.com/meshin-blox/prompts.git" + scrypt-js "^3.0.1" + semver "^7.5.1" + stream "^0.0.2" + underscore "^1.13.4" + web3 "1.7.3" + yargs "^17.5.1" + "ssv-scanner@github:bloxapp/ssv-scanner": version "1.0.3" resolved "https://codeload.github.com/bloxapp/ssv-scanner/tar.gz/b508efe18acb5ae1b94d13eae993d5dcaccf000b" @@ -7317,6 +7848,13 @@ stealthy-require@^1.1.1: resolved "https://registry.yarnpkg.com/stealthy-require/-/stealthy-require-1.1.1.tgz#35b09875b4ff49f26a777e509b3090a3226bf24b" integrity sha512-ZnWpYnYugiOVEY5GkcuJK1io5V8QmNYChG62gSit9pQVGErXtrKuPC55ITaVSukmMta5qpMU7vqLt2Lnni4f/g== +stream@^0.0.2: + version "0.0.2" + resolved "https://registry.yarnpkg.com/stream/-/stream-0.0.2.tgz#7f5363f057f6592c5595f00bc80a27f5cec1f0ef" + integrity sha512-gCq3NDI2P35B2n6t76YJuOp7d6cN/C7Rt0577l91wllh0sY9ZBuw9KaSGqH/b0hzn3CWWJbpbW0W0WvQ1H/Q7g== + dependencies: + emitter-component "^1.1.1" + streamsearch@^1.1.0: version "1.1.0" resolved "https://registry.yarnpkg.com/streamsearch/-/streamsearch-1.1.0.tgz#404dd1e2247ca94af554e841a8ef0eaa238da764" @@ -7600,6 +8138,11 @@ tmp@0.0.33, tmp@^0.0.33: dependencies: os-tmpdir "~1.0.2" +to-readable-stream@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/to-readable-stream/-/to-readable-stream-1.0.0.tgz#ce0aa0c2f3df6adf852efb404a783e77c0475771" + integrity sha512-Iq25XBt6zD5npPhlLVXGFN3/gyR2/qODcKNNyTMd4vbm39HUaOiAM4PMq0eMVC/Tkxz+Zjdsc55g9yyz+Yq00Q== + to-regex-range@^5.0.1: version "5.0.1" resolved "https://registry.yarnpkg.com/to-regex-range/-/to-regex-range-5.0.1.tgz#1648c44aae7c8d988a326018ed72f5b4dd0392e4" @@ -7640,7 +8183,7 @@ ts-essentials@^7.0.1: resolved "https://registry.yarnpkg.com/ts-essentials/-/ts-essentials-7.0.3.tgz#686fd155a02133eedcc5362dc8b5056cde3e5a38" integrity sha512-8+gr5+lqO3G84KdiTSMRLtuyJ+nTBVRKuCrK4lidMPdVeEp0uqC875uE5NMcaA7YYMN7XsNiFQuMvasF8HT/xQ== -tslib@^1.11.1, tslib@^1.9.0, tslib@^1.9.3: +tslib@^1.11.1, tslib@^1.13.0, tslib@^1.8.1, tslib@^1.9.0, tslib@^1.9.3: version "1.14.1" resolved "https://registry.yarnpkg.com/tslib/-/tslib-1.14.1.tgz#cf2d38bdc34a134bcaf1091c41f6619e2f672d00" integrity sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg== @@ -7650,11 +8193,42 @@ tslib@^2.3.1, tslib@^2.5.0: resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.5.3.tgz#24944ba2d990940e6e982c4bea147aba80209913" integrity sha512-mSxlJJwl3BMEQCUNnxXBU9jP4JBktcEGhURcPR6VQVlnP0FdDEsIaz0C35dXNGLyRfrATNofF0F5p2KPxQgB+w== +tslint-config-prettier@^1.18.0: + version "1.18.0" + resolved "https://registry.yarnpkg.com/tslint-config-prettier/-/tslint-config-prettier-1.18.0.tgz#75f140bde947d35d8f0d238e0ebf809d64592c37" + integrity sha512-xPw9PgNPLG3iKRxmK7DWr+Ea/SzrvfHtjFt5LBl61gk2UBG/DB9kCXRjv+xyIU1rUtnayLeMUVJBcMX8Z17nDg== + +tslint@^6.1.3: + version "6.1.3" + resolved "https://registry.yarnpkg.com/tslint/-/tslint-6.1.3.tgz#5c23b2eccc32487d5523bd3a470e9aa31789d904" + integrity sha512-IbR4nkT96EQOvKE2PW/djGz8iGNeJ4rF2mBfiYaR/nvUWYKJhLwimoJKgjIFEIDibBtOevj7BqCRL4oHeWWUCg== + dependencies: + "@babel/code-frame" "^7.0.0" + builtin-modules "^1.1.1" + chalk "^2.3.0" + commander "^2.12.1" + diff "^4.0.1" + glob "^7.1.1" + js-yaml "^3.13.1" + minimatch "^3.0.4" + mkdirp "^0.5.3" + resolve "^1.3.2" + semver "^5.3.0" + tslib "^1.13.0" + tsutils "^2.29.0" + tsort@0.0.1: version "0.0.1" resolved "https://registry.yarnpkg.com/tsort/-/tsort-0.0.1.tgz#e2280f5e817f8bf4275657fd0f9aebd44f5a2786" integrity sha512-Tyrf5mxF8Ofs1tNoxA13lFeZ2Zrbd6cKbuH3V+MQ5sb6DtBj5FjrXVsRWT8YvNAQTqNoz66dz1WsbigI22aEnw== +tsutils@^2.29.0: + version "2.29.0" + resolved "https://registry.yarnpkg.com/tsutils/-/tsutils-2.29.0.tgz#32b488501467acbedd4b85498673a0812aca0b99" + integrity sha512-g5JVHCIJwzfISaXpXE1qvNalca5Jwob6FjI4AoPlqMusJ6ftFE7IkkFoMhVLRgK+4Kx3gkzb8UZK5t5yTTvEmA== + dependencies: + tslib "^1.8.1" + tunnel-agent@^0.6.0: version "0.6.0" resolved "https://registry.yarnpkg.com/tunnel-agent/-/tunnel-agent-0.6.0.tgz#27a5dea06b36b04a0a9966774b290868f0fc40fd" @@ -7761,6 +8335,11 @@ typedarray@^0.0.6: resolved "https://registry.yarnpkg.com/typedarray/-/typedarray-0.0.6.tgz#867ac74e3864187b1d3d47d996a78ec5c8830777" integrity sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA== +typescript@^4.3.2: + version "4.9.5" + resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.9.5.tgz#095979f9bcc0d09da324d58d03ce8f8374cbe65a" + integrity sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g== + typical@^4.0.0: version "4.0.0" resolved "https://registry.yarnpkg.com/typical/-/typical-4.0.0.tgz#cbeaff3b9d7ae1e2bbfaf5a4e6f11eccfde94fc4" @@ -7791,6 +8370,11 @@ unbox-primitive@^1.0.2: has-symbols "^1.0.3" which-boxed-primitive "^1.0.2" +underscore@^1.13.4: + version "1.13.6" + resolved "https://registry.yarnpkg.com/underscore/-/underscore-1.13.6.tgz#04786a1f589dc6c09f761fc5f45b89e935136441" + integrity sha512-+A5Sja4HP1M08MaXya7p5LvjuM7K6q/2EaC0+iovj/wOcMsTzMvDFbasi/oSapiwOlt252IqsKqPjCl7huKS0A== + undici@^5.14.0: version "5.22.1" resolved "https://registry.yarnpkg.com/undici/-/undici-5.22.1.tgz#877d512effef2ac8be65e695f3586922e1a57d7b" @@ -7825,6 +8409,13 @@ uri-js@^4.2.2: dependencies: punycode "^2.1.0" +url-parse-lax@^3.0.0: + version "3.0.0" + resolved "https://registry.yarnpkg.com/url-parse-lax/-/url-parse-lax-3.0.0.tgz#16b5cafc07dbe3676c1b1999177823d6503acb0c" + integrity sha512-NjFKA0DidqPa5ciFcSrXnAltTtzz84ogy+NebPvfEgAck0+TNg4UJ4IN+fB7zRZfbgUf0syOo9MDxFkDSMuFaQ== + dependencies: + prepend-http "^2.0.0" + url-set-query@^1.0.0: version "1.0.0" resolved "https://registry.yarnpkg.com/url-set-query/-/url-set-query-1.0.0.tgz#016e8cfd7c20ee05cafe7795e892bd0702faa339" @@ -7852,7 +8443,7 @@ utf-8-validate@^5.0.2: dependencies: node-gyp-build "^4.3.0" -utf8@3.0.0: +utf8@3.0.0, utf8@^3.0.0: version "3.0.0" resolved "https://registry.yarnpkg.com/utf8/-/utf8-3.0.0.tgz#f052eed1364d696e769ef058b183df88c87f69d1" integrity sha512-E8VjFIQ/TyQgp+TZfS6l8yp/xWppSAHzidGiRrqe4bK4XP9pTRyKFgGJpO3SN7zdX4DeomTrwaseCHovfpFcqQ== @@ -7862,7 +8453,7 @@ util-deprecate@^1.0.1, util-deprecate@~1.0.1: resolved "https://registry.yarnpkg.com/util-deprecate/-/util-deprecate-1.0.2.tgz#450d4dc9fa70de732762fbd2d4a28981419a0ccf" integrity sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw== -util@^0.12.5: +util@^0.12.0, util@^0.12.5: version "0.12.5" resolved "https://registry.yarnpkg.com/util/-/util-0.12.5.tgz#5f17a6059b73db61a875668781a1c2b136bd6fbc" integrity sha512-kZf/K6hEIrWHI6XqOFUiiMa+79wE/D8Q+NCNAWclkyg3b4d2k7s0QGepNjiABc+aR3N1PAyHL7p6UcLY6LmrnA== @@ -7883,6 +8474,11 @@ uuid@2.0.1: resolved "https://registry.yarnpkg.com/uuid/-/uuid-2.0.1.tgz#c2a30dedb3e535d72ccf82e343941a50ba8533ac" integrity sha512-nWg9+Oa3qD2CQzHIP4qKUqwNfzKn8P0LtFhotaCTFchsV7ZfDhAybeip/HZVeMIpZi9JgY1E3nUlwaCmZT1sEg== +uuid@3.3.2: + version "3.3.2" + resolved "https://registry.yarnpkg.com/uuid/-/uuid-3.3.2.tgz#1b4af4955eb3077c501c23872fc6513811587131" + integrity sha512-yXJmeNaw3DnnKAOKJE51sL/ZaYfWJRl1pK9dr19YFCu0ObS231AB1/LbqTKRAQ5kw8A90rA6fr4riOUpTZvQZA== + uuid@^3.3.2: version "3.4.0" resolved "https://registry.yarnpkg.com/uuid/-/uuid-3.4.0.tgz#b23e4358afa8a202fe7a100af1f5f883f02007ee" @@ -7893,7 +8489,7 @@ uuid@^8.3.2: resolved "https://registry.yarnpkg.com/uuid/-/uuid-8.3.2.tgz#80d5b5ced271bb9af6c445f21a1a04c606cefbe2" integrity sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg== -uuid@^9.0.0: +uuid@^9.0.0, uuid@^9.0.1: version "9.0.1" resolved "https://registry.yarnpkg.com/uuid/-/uuid-9.0.1.tgz#e188d4c8853cc722220392c424cd637f32293f30" integrity sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA== @@ -7903,6 +8499,11 @@ v8-compile-cache@^2.0.3: resolved "https://registry.yarnpkg.com/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz#2de19618c66dc247dcfb6f99338035d8245a2cee" integrity sha512-l8lCEmLcLYZh4nbunNZvQCJc5pv7+RCwa8q/LdUx8u7lsWvPDKmpodJAJNwkAhJC//dFY48KuIEmjtd4RViDrA== +validator@^13.7.0: + version "13.11.0" + resolved "https://registry.yarnpkg.com/validator/-/validator-13.11.0.tgz#23ab3fd59290c61248364eabf4067f04955fbb1b" + integrity sha512-Ii+sehpSfZy+At5nPdnyMhx78fEoPDkR2XW/zimHEL3MyGJQOCQ7WeP20jPYRz7ZCpcKLB21NxuXHF3bxjStBQ== + varint@^5.0.0: version "5.0.2" resolved "https://registry.yarnpkg.com/varint/-/varint-5.0.2.tgz#5b47f8a947eb668b848e034dcfa87d0ff8a7f7a4" @@ -7931,6 +8532,15 @@ web3-bzz@1.10.4: got "12.1.0" swarm-js "^0.1.40" +web3-bzz@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-bzz/-/web3-bzz-1.7.3.tgz#6860a584f748838af5e3932b6798e024ab8ae951" + integrity sha512-y2i2IW0MfSqFc1JBhBSQ59Ts9xE30hhxSmLS13jLKWzie24/An5dnoGarp2rFAy20tevJu1zJVPYrEl14jiL5w== + dependencies: + "@types/node" "^12.12.6" + got "9.6.0" + swarm-js "^0.1.40" + web3-core-helpers@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-core-helpers/-/web3-core-helpers-1.10.4.tgz#bd2b4140df2016d5dd3bb2b925fc29ad8678677c" @@ -7939,6 +8549,14 @@ web3-core-helpers@1.10.4: web3-eth-iban "1.10.4" web3-utils "1.10.4" +web3-core-helpers@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-core-helpers/-/web3-core-helpers-1.7.3.tgz#9a8d7830737d0e9c48694b244f4ce0f769ba67b9" + integrity sha512-qS2t6UKLhRV/6C7OFHtMeoHphkcA+CKUr2vfpxy4hubs3+Nj28K9pgiqFuvZiXmtEEwIAE2A28GBOC3RdcSuFg== + dependencies: + web3-eth-iban "1.7.3" + web3-utils "1.7.3" + web3-core-method@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-core-method/-/web3-core-method-1.10.4.tgz#566b52f006d3cbb13b21b72b8d2108999bf5d6bf" @@ -7950,6 +8568,17 @@ web3-core-method@1.10.4: web3-core-subscriptions "1.10.4" web3-utils "1.10.4" +web3-core-method@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-core-method/-/web3-core-method-1.7.3.tgz#eb2a4f140448445c939518c0fa6216b3d265c5e9" + integrity sha512-SeF8YL/NVFbj/ddwLhJeS0io8y7wXaPYA2AVT0h2C2ESYkpvOtQmyw2Bc3aXxBmBErKcbOJjE2ABOKdUmLSmMA== + dependencies: + "@ethersproject/transactions" "^5.0.0-beta.135" + web3-core-helpers "1.7.3" + web3-core-promievent "1.7.3" + web3-core-subscriptions "1.7.3" + web3-utils "1.7.3" + web3-core-promievent@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-core-promievent/-/web3-core-promievent-1.10.4.tgz#629b970b7934430b03c5033c79f3bb3893027e22" @@ -7957,6 +8586,13 @@ web3-core-promievent@1.10.4: dependencies: eventemitter3 "4.0.4" +web3-core-promievent@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-core-promievent/-/web3-core-promievent-1.7.3.tgz#2d0eeef694569b61355054c721578f67df925b80" + integrity sha512-+mcfNJLP8h2JqcL/UdMGdRVfTdm+bsoLzAFtLpazE4u9kU7yJUgMMAqnK59fKD3Zpke3DjaUJKwz1TyiGM5wig== + dependencies: + eventemitter3 "4.0.4" + web3-core-requestmanager@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-core-requestmanager/-/web3-core-requestmanager-1.10.4.tgz#eb1f147e6b9df84e3a37e602162f8925bdb4bb9a" @@ -7968,6 +8604,17 @@ web3-core-requestmanager@1.10.4: web3-providers-ipc "1.10.4" web3-providers-ws "1.10.4" +web3-core-requestmanager@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-core-requestmanager/-/web3-core-requestmanager-1.7.3.tgz#226f79d16e546c9157d00908de215e984cae84e9" + integrity sha512-bC+jeOjPbagZi2IuL1J5d44f3zfPcgX+GWYUpE9vicNkPUxFBWRG+olhMo7L+BIcD57cTmukDlnz+1xBULAjFg== + dependencies: + util "^0.12.0" + web3-core-helpers "1.7.3" + web3-providers-http "1.7.3" + web3-providers-ipc "1.7.3" + web3-providers-ws "1.7.3" + web3-core-subscriptions@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-core-subscriptions/-/web3-core-subscriptions-1.10.4.tgz#2f4dcb404237e92802a563265d11a33934dc38e6" @@ -7976,6 +8623,14 @@ web3-core-subscriptions@1.10.4: eventemitter3 "4.0.4" web3-core-helpers "1.10.4" +web3-core-subscriptions@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-core-subscriptions/-/web3-core-subscriptions-1.7.3.tgz#ca456dfe2c219a0696c5cf34c13b03c3599ec5d5" + integrity sha512-/i1ZCLW3SDxEs5mu7HW8KL4Vq7x4/fDXY+yf/vPoDljlpvcLEOnI8y9r7om+0kYwvuTlM6DUHHafvW0221TyRQ== + dependencies: + eventemitter3 "4.0.4" + web3-core-helpers "1.7.3" + web3-core@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-core/-/web3-core-1.10.4.tgz#639de68b8b9871d2dc8892e0dd4e380cb1361a98" @@ -7989,6 +8644,19 @@ web3-core@1.10.4: web3-core-requestmanager "1.10.4" web3-utils "1.10.4" +web3-core@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-core/-/web3-core-1.7.3.tgz#2ef25c4cc023997f43af9f31a03b571729ff3cda" + integrity sha512-4RNxueGyevD1XSjdHE57vz/YWRHybpcd3wfQS33fgMyHZBVLFDNwhn+4dX4BeofVlK/9/cmPAokLfBUStZMLdw== + dependencies: + "@types/bn.js" "^4.11.5" + "@types/node" "^12.12.6" + bignumber.js "^9.0.0" + web3-core-helpers "1.7.3" + web3-core-method "1.7.3" + web3-core-requestmanager "1.7.3" + web3-utils "1.7.3" + web3-eth-abi@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth-abi/-/web3-eth-abi-1.10.4.tgz#16c19d0bde0aaf8c1a56cb7743a83156d148d798" @@ -7997,6 +8665,14 @@ web3-eth-abi@1.10.4: "@ethersproject/abi" "^5.6.3" web3-utils "1.10.4" +web3-eth-abi@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth-abi/-/web3-eth-abi-1.7.3.tgz#2a1123c7252c37100eecd0b1fb2fb2c51366071f" + integrity sha512-ZlD8DrJro0ocnbZViZpAoMX44x5aYAb73u2tMq557rMmpiluZNnhcCYF/NnVMy6UIkn7SF/qEA45GXA1ne6Tnw== + dependencies: + "@ethersproject/abi" "5.0.7" + web3-utils "1.7.3" + web3-eth-accounts@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth-accounts/-/web3-eth-accounts-1.10.4.tgz#df30e85a7cd70e475f8cf52361befba408829e34" @@ -8013,6 +8689,23 @@ web3-eth-accounts@1.10.4: web3-core-method "1.10.4" web3-utils "1.10.4" +web3-eth-accounts@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth-accounts/-/web3-eth-accounts-1.7.3.tgz#cd1789000f13ed3c438e96b3e80ee7be8d3f1a9b" + integrity sha512-aDaWjW1oJeh0LeSGRVyEBiTe/UD2/cMY4dD6pQYa8dOhwgMtNQjxIQ7kacBBXe7ZKhjbIFZDhvXN4mjXZ82R2Q== + dependencies: + "@ethereumjs/common" "^2.5.0" + "@ethereumjs/tx" "^3.3.2" + crypto-browserify "3.12.0" + eth-lib "0.2.8" + ethereumjs-util "^7.0.10" + scrypt-js "^3.0.1" + uuid "3.3.2" + web3-core "1.7.3" + web3-core-helpers "1.7.3" + web3-core-method "1.7.3" + web3-utils "1.7.3" + web3-eth-contract@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth-contract/-/web3-eth-contract-1.10.4.tgz#22d39f04e11d9ff4e726e8025a56d78e843a2c3d" @@ -8027,6 +8720,20 @@ web3-eth-contract@1.10.4: web3-eth-abi "1.10.4" web3-utils "1.10.4" +web3-eth-contract@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth-contract/-/web3-eth-contract-1.7.3.tgz#c4efc118ed7adafbc1270b633f33e696a39c7fc7" + integrity sha512-7mjkLxCNMWlQrlfM/MmNnlKRHwFk5XrZcbndoMt3KejcqDP6dPHi2PZLutEcw07n/Sk8OMpSamyF3QiGfmyRxw== + dependencies: + "@types/bn.js" "^4.11.5" + web3-core "1.7.3" + web3-core-helpers "1.7.3" + web3-core-method "1.7.3" + web3-core-promievent "1.7.3" + web3-core-subscriptions "1.7.3" + web3-eth-abi "1.7.3" + web3-utils "1.7.3" + web3-eth-ens@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth-ens/-/web3-eth-ens-1.10.4.tgz#3d991adac52bc8e598f1f1b8528337fa6291004c" @@ -8041,6 +8748,20 @@ web3-eth-ens@1.10.4: web3-eth-contract "1.10.4" web3-utils "1.10.4" +web3-eth-ens@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth-ens/-/web3-eth-ens-1.7.3.tgz#ebc56a4dc7007f4f899259bbae1237d3095e2f3f" + integrity sha512-q7+hFGHIc0mBI3LwgRVcLCQmp6GItsWgUtEZ5bjwdjOnJdbjYddm7PO9RDcTDQ6LIr7hqYaY4WTRnDHZ6BEt5Q== + dependencies: + content-hash "^2.5.2" + eth-ens-namehash "2.0.8" + web3-core "1.7.3" + web3-core-helpers "1.7.3" + web3-core-promievent "1.7.3" + web3-eth-abi "1.7.3" + web3-eth-contract "1.7.3" + web3-utils "1.7.3" + web3-eth-iban@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth-iban/-/web3-eth-iban-1.10.4.tgz#bc61b4a1930d19b1df8762c606d669902558e54d" @@ -8049,6 +8770,14 @@ web3-eth-iban@1.10.4: bn.js "^5.2.1" web3-utils "1.10.4" +web3-eth-iban@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth-iban/-/web3-eth-iban-1.7.3.tgz#47433a73380322bba04e17b91fccd4a0e63a390a" + integrity sha512-1GPVWgajwhh7g53mmYDD1YxcftQniIixMiRfOqlnA1w0mFGrTbCoPeVaSQ3XtSf+rYehNJIZAUeDBnONVjXXmg== + dependencies: + bn.js "^4.11.9" + web3-utils "1.7.3" + web3-eth-personal@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth-personal/-/web3-eth-personal-1.10.4.tgz#e2ee920f47e84848288e03442659cdbb2c4deea2" @@ -8061,6 +8790,18 @@ web3-eth-personal@1.10.4: web3-net "1.10.4" web3-utils "1.10.4" +web3-eth-personal@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth-personal/-/web3-eth-personal-1.7.3.tgz#ca2464dca356d4335aa8141cf75a6947f10f45a6" + integrity sha512-iTLz2OYzEsJj2qGE4iXC1Gw+KZN924fTAl0ESBFs2VmRhvVaM7GFqZz/wx7/XESl3GVxGxlRje3gNK0oGIoYYQ== + dependencies: + "@types/node" "^12.12.6" + web3-core "1.7.3" + web3-core-helpers "1.7.3" + web3-core-method "1.7.3" + web3-net "1.7.3" + web3-utils "1.7.3" + web3-eth@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-eth/-/web3-eth-1.10.4.tgz#3a908c635cb5d935bd30473e452f3bd7f2ee66a5" @@ -8079,6 +8820,24 @@ web3-eth@1.10.4: web3-net "1.10.4" web3-utils "1.10.4" +web3-eth@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-eth/-/web3-eth-1.7.3.tgz#9e92785ea18d682548b6044551abe7f2918fc0b5" + integrity sha512-BCIRMPwaMlTCbswXyGT6jj9chCh9RirbDFkPtvqozfQ73HGW7kP78TXXf9+Xdo1GjutQfxi/fQ9yPdxtDJEpDA== + dependencies: + web3-core "1.7.3" + web3-core-helpers "1.7.3" + web3-core-method "1.7.3" + web3-core-subscriptions "1.7.3" + web3-eth-abi "1.7.3" + web3-eth-accounts "1.7.3" + web3-eth-contract "1.7.3" + web3-eth-ens "1.7.3" + web3-eth-iban "1.7.3" + web3-eth-personal "1.7.3" + web3-net "1.7.3" + web3-utils "1.7.3" + web3-net@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-net/-/web3-net-1.10.4.tgz#20e12c60e4477d4298979d8d5d66b9abf8e66a09" @@ -8088,6 +8847,15 @@ web3-net@1.10.4: web3-core-method "1.10.4" web3-utils "1.10.4" +web3-net@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-net/-/web3-net-1.7.3.tgz#54e35bcc829fdc40cf5001a3870b885d95069810" + integrity sha512-zAByK0Qrr71k9XW0Adtn+EOuhS9bt77vhBO6epAeQ2/VKl8rCGLAwrl3GbeEl7kWa8s/su72cjI5OetG7cYR0g== + dependencies: + web3-core "1.7.3" + web3-core-method "1.7.3" + web3-utils "1.7.3" + web3-providers-http@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-providers-http/-/web3-providers-http-1.10.4.tgz#ca7aa58aeaf8123500c24ffe0595896319f830e8" @@ -8098,6 +8866,14 @@ web3-providers-http@1.10.4: es6-promise "^4.2.8" web3-core-helpers "1.10.4" +web3-providers-http@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-providers-http/-/web3-providers-http-1.7.3.tgz#8ea5e39f6ceee0b5bc4e45403fae75cad8ff4cf7" + integrity sha512-TQJfMsDQ5Uq9zGMYlu7azx1L7EvxW+Llks3MaWn3cazzr5tnrDbGh6V17x6LN4t8tFDHWx0rYKr3mDPqyTjOZw== + dependencies: + web3-core-helpers "1.7.3" + xhr2-cookies "1.1.0" + web3-providers-ipc@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-providers-ipc/-/web3-providers-ipc-1.10.4.tgz#2e03437909e4e7771d646ff05518efae44b783c3" @@ -8106,6 +8882,14 @@ web3-providers-ipc@1.10.4: oboe "2.1.5" web3-core-helpers "1.10.4" +web3-providers-ipc@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-providers-ipc/-/web3-providers-ipc-1.7.3.tgz#a34872103a8d37a03795fa2f9b259e869287dcaa" + integrity sha512-Z4EGdLKzz6I1Bw+VcSyqVN4EJiT2uAro48Am1eRvxUi4vktGoZtge1ixiyfrRIVb6nPe7KnTFl30eQBtMqS0zA== + dependencies: + oboe "2.1.5" + web3-core-helpers "1.7.3" + web3-providers-ws@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-providers-ws/-/web3-providers-ws-1.10.4.tgz#55d0c3ba36c6a79d105f02e20a707eb3978e7f82" @@ -8115,6 +8899,15 @@ web3-providers-ws@1.10.4: web3-core-helpers "1.10.4" websocket "^1.0.32" +web3-providers-ws@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-providers-ws/-/web3-providers-ws-1.7.3.tgz#87564facc47387c9004a043a6686e4881ed6acfe" + integrity sha512-PpykGbkkkKtxPgv7U4ny4UhnkqSZDfLgBEvFTXuXLAngbX/qdgfYkhIuz3MiGplfL7Yh93SQw3xDjImXmn2Rgw== + dependencies: + eventemitter3 "4.0.4" + web3-core-helpers "1.7.3" + websocket "^1.0.32" + web3-shh@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-shh/-/web3-shh-1.10.4.tgz#9852d6f3d05678e31e49235a60fea10ca7a9e21d" @@ -8125,6 +8918,16 @@ web3-shh@1.10.4: web3-core-subscriptions "1.10.4" web3-net "1.10.4" +web3-shh@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-shh/-/web3-shh-1.7.3.tgz#84e10adf628556798244b58f73cda1447bb7075e" + integrity sha512-bQTSKkyG7GkuULdZInJ0osHjnmkHij9tAySibpev1XjYdjLiQnd0J9YGF4HjvxoG3glNROpuCyTaRLrsLwaZuw== + dependencies: + web3-core "1.7.3" + web3-core-method "1.7.3" + web3-core-subscriptions "1.7.3" + web3-net "1.7.3" + web3-utils@1.10.4: version "1.10.4" resolved "https://registry.yarnpkg.com/web3-utils/-/web3-utils-1.10.4.tgz#0daee7d6841641655d8b3726baf33b08eda1cbec" @@ -8139,6 +8942,19 @@ web3-utils@1.10.4: randombytes "^2.1.0" utf8 "3.0.0" +web3-utils@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3-utils/-/web3-utils-1.7.3.tgz#b214d05f124530d8694ad364509ac454d05f207c" + integrity sha512-g6nQgvb/bUpVUIxJE+ezVN+rYwYmlFyMvMIRSuqpi1dk6ApDD00YNArrk7sPcZnjvxOJ76813Xs2vIN2rgh4lg== + dependencies: + bn.js "^4.11.9" + ethereum-bloom-filters "^1.0.6" + ethereumjs-util "^7.1.0" + ethjs-unit "0.1.6" + number-to-bn "1.7.0" + randombytes "^2.1.0" + utf8 "3.0.0" + web3-utils@^1.3.6, web3-utils@^1.5.2: version "1.10.0" resolved "https://registry.yarnpkg.com/web3-utils/-/web3-utils-1.10.0.tgz#ca4c1b431a765c14ac7f773e92e0fd9377ccf578" @@ -8152,6 +8968,19 @@ web3-utils@^1.3.6, web3-utils@^1.5.2: randombytes "^2.1.0" utf8 "3.0.0" +web3@1.7.3: + version "1.7.3" + resolved "https://registry.yarnpkg.com/web3/-/web3-1.7.3.tgz#30fe786338b2cc775881cb28c056ee5da4be65b8" + integrity sha512-UgBvQnKIXncGYzsiGacaiHtm0xzQ/JtGqcSO/ddzQHYxnNuwI72j1Pb4gskztLYihizV9qPNQYHMSCiBlStI9A== + dependencies: + web3-bzz "1.7.3" + web3-core "1.7.3" + web3-eth "1.7.3" + web3-eth-personal "1.7.3" + web3-net "1.7.3" + web3-shh "1.7.3" + web3-utils "1.7.3" + web3@^1.10.0: version "1.10.4" resolved "https://registry.yarnpkg.com/web3/-/web3-1.10.4.tgz#5d5e59b976eaf758b060fe1a296da5fe87bdc79c" @@ -8342,6 +9171,13 @@ xhr-request@^1.0.1, xhr-request@^1.1.0: url-set-query "^1.0.0" xhr "^2.0.4" +xhr2-cookies@1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/xhr2-cookies/-/xhr2-cookies-1.1.0.tgz#7d77449d0999197f155cb73b23df72505ed89d48" + integrity sha512-hjXUA6q+jl/bd8ADHcVfFsSPIf+tyLIjuO9TwJC9WI6JP2zKcS7C+p56I9kCLLsaCiNT035iYvEUUzdEFj/8+g== + dependencies: + cookiejar "^2.1.1" + xhr@^2.0.4, xhr@^2.3.3: version "2.6.0" resolved "https://registry.yarnpkg.com/xhr/-/xhr-2.6.0.tgz#b69d4395e792b4173d6b7df077f0fc5e4e2b249d" @@ -8405,6 +9241,11 @@ yargs-parser@^20.2.2: resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-20.2.9.tgz#2eb7dc3b0289718fc295f362753845c41a0c94ee" integrity sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w== +yargs-parser@^21.1.1: + version "21.1.1" + resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35" + integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw== + yargs-unparser@1.6.0: version "1.6.0" resolved "https://registry.yarnpkg.com/yargs-unparser/-/yargs-unparser-1.6.0.tgz#ef25c2c769ff6bd09e4b0f9d7c605fb27846ea9f" @@ -8453,6 +9294,19 @@ yargs@16.2.0: y18n "^5.0.5" yargs-parser "^20.2.2" +yargs@^17.5.1: + version "17.7.2" + resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.7.2.tgz#991df39aca675a192b816e1e0363f9d75d2aa269" + integrity sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w== + dependencies: + cliui "^8.0.1" + escalade "^3.1.1" + get-caller-file "^2.0.5" + require-directory "^2.1.1" + string-width "^4.2.3" + y18n "^5.0.5" + yargs-parser "^21.1.1" + yocto-queue@^0.1.0: version "0.1.0" resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b" From b5b2f5657e33f5182094f265f251bf8a7c7052c8 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 20:34:48 +0200 Subject: [PATCH 20/30] unify the holesky and the mainnet fork tests --- contracts/fork-test.sh | 2 +- contracts/test/behaviour/ssvStrategy.js | 400 +++++++++++++++++ .../strategies/nativeSsvStaking.fork-test.js | 411 +----------------- .../nativeSsvStaking.holesky-fork-test.js | 41 ++ .../nativeSsvStaking.holesky.fork-test.js | 147 ------- contracts/utils/addresses.js | 2 + 6 files changed, 462 insertions(+), 541 deletions(-) create mode 100644 contracts/test/behaviour/ssvStrategy.js create mode 100644 contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js delete mode 100644 contracts/test/strategies/nativeSsvStaking.holesky.fork-test.js diff --git a/contracts/fork-test.sh b/contracts/fork-test.sh index 5640a26eee..f12ace1d79 100755 --- a/contracts/fork-test.sh +++ b/contracts/fork-test.sh @@ -74,7 +74,7 @@ main() if [[ $FORK_NETWORK_NAME == "holesky" ]]; then # Run all files with `.holesky.fork-test.js` suffix when no file name param is given # pass all other params along - params+="test/**/*.holesky.fork-test.js" + params+="test/**/*.holesky-fork-test.js" else # Run all files with `.fork-test.js` suffix when no file name param is given # pass all other params along diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js new file mode 100644 index 0000000000..f2454de922 --- /dev/null +++ b/contracts/test/behaviour/ssvStrategy.js @@ -0,0 +1,400 @@ +const { expect } = require("chai"); +const { AddressZero } = require("@ethersproject/constants"); +const { + setBalance, + setStorageAt, +} = require("@nomicfoundation/hardhat-network-helpers"); + +const { oethUnits } = require("../helpers"); +const addresses = require("../../utils/addresses"); +const { impersonateAndFund } = require("../../utils/signers"); +const { getClusterInfo } = require("../../utils/ssv"); + +const { + createFixtureLoader, + nativeStakingSSVStrategyFixture, +} = require("./../_fixture"); +const { parseEther } = require("ethers/lib/utils"); + +const loadFixture = createFixtureLoader(nativeStakingSSVStrategyFixture); + +/** + * + * @param {*} context a function that returns a fixture with the additional properties: + * @example + shouldBehaveLikeAnSsvStrategy(() => ({ + ...fixture, + })); + */ + +const shouldBehaveLikeAnSsvStrategy = (context) => { + describe("Initial setup", function () { + it("Should verify the initial state", async () => { + const { nativeStakingSSVStrategy, addresses } = await context(); + await expect( + await nativeStakingSSVStrategy.WETH_TOKEN_ADDRESS() + ).to.equal(addresses.WETH, "Incorrect WETH address set"); + await expect(await nativeStakingSSVStrategy.SSV_TOKEN_ADDRESS()).to.equal( + addresses.SSV, + "Incorrect SSV Token address" + ); + await expect( + await nativeStakingSSVStrategy.SSV_NETWORK_ADDRESS() + ).to.equal(addresses.SSVNetwork, "Incorrect SSV Network address"); + await expect( + await nativeStakingSSVStrategy.BEACON_CHAIN_DEPOSIT_CONTRACT() + ).to.equal( + addresses.beaconChainDepositContract, + "Incorrect Beacon deposit contract" + ); + await expect(await nativeStakingSSVStrategy.VAULT_ADDRESS()).to.equal( + addresses.OETHVaultProxy, + "Incorrect OETH Vault address" + ); + await expect(await nativeStakingSSVStrategy.fuseIntervalStart()).to.equal( + oethUnits("21.6"), + "Incorrect fuse start" + ); + await expect(await nativeStakingSSVStrategy.fuseIntervalEnd()).to.equal( + oethUnits("25.6"), + "Incorrect fuse end" + ); + await expect( + await nativeStakingSSVStrategy.validatorRegistrator() + ).to.equal( + addresses.validatorRegistrator, + "Incorrect validator registrator" + ); + }); + }); + + describe("Deposit/Allocation", function () { + it("Should accept and handle WETH allocation", async () => { + const { oethVault, weth, domen, nativeStakingSSVStrategy, } = await context(); + const fakeVaultSigner = await impersonateAndFund(oethVault.address); + + const depositAmount = oethUnits("32"); + const wethBalanceBefore = await weth.balanceOf( + nativeStakingSSVStrategy.address + ); + const strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( + weth.address + ); + + // Transfer some WETH to strategy + await weth + .connect(domen) + .transfer(nativeStakingSSVStrategy.address, depositAmount); + + // Call deposit by impersonating the Vault + const tx = await nativeStakingSSVStrategy + .connect(fakeVaultSigner) + .deposit(weth.address, depositAmount); + + expect(tx) + .to.emit(nativeStakingSSVStrategy, "Deposit") + .withArgs(weth.address, AddressZero, depositAmount); + + expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( + wethBalanceBefore.add(depositAmount), + "WETH not transferred" + ); + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal( + strategyBalanceBefore.add(depositAmount), + "strategy checkBalance not increased" + ); + }); + }); + + describe("Validator operations", function () { + beforeEach(async () => { + const { weth, domen, nativeStakingSSVStrategy, addresses } = await context(); + + // Add 32 WETH to the strategy so it can be staked + await weth + .connect(domen) + .transfer(nativeStakingSSVStrategy.address, oethUnits("32")); + }); + + it("Should register and staked 32 ETH by validator registrator", async () => { + const { weth, nativeStakingSSVStrategy, validatorRegistrator, testValidator } = await context(); + + const strategyWethBalanceBefore = await weth.balanceOf( + nativeStakingSSVStrategy.address + ); + + const { cluster } = await getClusterInfo({ + ownerAddress: nativeStakingSSVStrategy.address, + operatorIds: testValidator.operatorIds, + chainId: 1, + ssvNetwork: addresses.SSVNetwork, + }); + + const stakeAmount = oethUnits("32"); + + // Register a new validator with the SSV Network + const regTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .registerSsvValidator( + testValidator.publicKey, + testValidator.operatorIds, + testValidator.sharesData, + stakeAmount, + cluster + ); + await expect(regTx) + .to.emit(nativeStakingSSVStrategy, "SSVValidatorRegistered") + .withArgs(testValidator.publicKey, testValidator.operatorIds); + + // Stake 32 ETH to the new validator + const stakeTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .stakeEth([ + { + pubkey: testValidator.publicKey, + signature: testValidator.signature, + depositDataRoot: testValidator.depositDataRoot, + }, + ]); + + await expect(stakeTx) + .to.emit(nativeStakingSSVStrategy, "ETHStaked") + .withNamedArgs({ + pubkey: testValidator.publicKey, + amount: stakeAmount, + }); + + expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( + strategyWethBalanceBefore.sub( + stakeAmount, + "strategy WETH not decreased" + ) + ); + }); + + it("Should exit and remove validator by validator registrator", async () => { + const { nativeStakingSSVStrategy, ssvNetwork, validatorRegistrator, addresses, testValidator } = + await context(); + + const { cluster } = await getClusterInfo({ + ownerAddress: nativeStakingSSVStrategy.address, + operatorIds: testValidator.operatorIds, + chainId: 1, + ssvNetwork: addresses.SSVNetwork, + }); + + const stakeAmount = oethUnits("32"); + + // Register a new validator with the SSV network + const regTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .registerSsvValidator( + testValidator.publicKey, + testValidator.operatorIds, + testValidator.sharesData, + stakeAmount, + cluster + ); + const regReceipt = await regTx.wait(); + const ValidatorAddedEvent = ssvNetwork.interface.parseLog( + regReceipt.events[2] + ); + const { cluster: newCluster } = ValidatorAddedEvent.args; + + // Stake 32 ETH to the new validator + await nativeStakingSSVStrategy.connect(validatorRegistrator).stakeEth([ + { + pubkey: testValidator.publicKey, + signature: testValidator.signature, + depositDataRoot: testValidator.depositDataRoot, + }, + ]); + + // exit validator from SSV network + const exitTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .exitSsvValidator(testValidator.publicKey, testValidator.operatorIds); + + await expect(exitTx) + .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitInitiated") + .withArgs(testValidator.publicKey, testValidator.operatorIds); + + const removeTx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .removeSsvValidator( + testValidator.publicKey, + testValidator.operatorIds, + newCluster + ); + + await expect(removeTx) + .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitCompleted") + .withArgs(testValidator.publicKey, testValidator.operatorIds); + }); + }); + + describe("Accounting for ETH", function () { + let strategyBalanceBefore; + let consensusRewardsBefore; + let activeDepositedValidatorsBefore = 30000; + beforeEach(async () => { + const { nativeStakingSSVStrategy, validatorRegistrator, weth } = await context(); + + // clear any ETH sitting in the strategy + await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + // Set the number validators to a high number + await setStorageAt( + nativeStakingSSVStrategy.address, + 52, // the storage slot + activeDepositedValidatorsBefore + ); + + strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( + weth.address + ); + consensusRewardsBefore = + await nativeStakingSSVStrategy.consensusRewards(); + }); + + it("Should account for new consensus rewards", async () => { + const { nativeStakingSSVStrategy, validatorRegistrator, weth } = await context(); + + const rewards = oethUnits("2"); + + // simulate consensus rewards + await setBalance( + nativeStakingSSVStrategy.address, + consensusRewardsBefore.add(rewards) + ); + + const tx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + await expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingConsensusRewards") + .withArgs(rewards); + + // check balances after + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal(strategyBalanceBefore, "checkBalance should not increase"); + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + consensusRewardsBefore.add(rewards), + "consensusRewards should increase" + ); + }); + it("Should account for withdrawals and consensus rewards", async () => { + const { + oethVault, + nativeStakingSSVStrategy, + validatorRegistrator, + weth, + } = await context(); + + const rewards = oethUnits("3"); + const withdrawals = oethUnits("64"); + const vaultWethBalanceBefore = await weth.balanceOf(oethVault.address); + + // simulate withdraw of 2 validators and consensus rewards + await setBalance( + nativeStakingSSVStrategy.address, + withdrawals.add(rewards) + ); + + const tx = await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + await expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingFullyWithdrawnValidator") + .withArgs(2, activeDepositedValidatorsBefore - 2, withdrawals); + + await expect(tx) + .to.emit(nativeStakingSSVStrategy, "AccountingConsensusRewards") + .withArgs(rewards); + + // check balances after + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal( + strategyBalanceBefore.sub(withdrawals), + "checkBalance should decrease" + ); + expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( + consensusRewardsBefore.add(rewards), + "consensusRewards should increase" + ); + expect( + await nativeStakingSSVStrategy.activeDepositedValidators() + ).to.equal( + activeDepositedValidatorsBefore - 2, + "active validators decreases" + ); + expect(await weth.balanceOf(oethVault.address)).to.equal( + vaultWethBalanceBefore.add(withdrawals, "WETH in vault should increase") + ); + }); + }); + + describe("Harvest", async function () { + it("Should account for new execution rewards", async () => { + const { + oethHarvester, + josh, + nativeStakingSSVStrategy, + nativeStakingFeeAccumulator, + oethDripper, + weth, + validatorRegistrator, + addresses + } = await context(); + const dripperWethBefore = await weth.balanceOf(oethDripper.address); + + const strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( + weth.address + ); + + // add some ETH to the FeeAccumulator to simulate execution rewards + const executionRewards = parseEther("7"); + await setBalance(nativeStakingFeeAccumulator.address, executionRewards); + // simulate consensus rewards + const consensusRewards = parseEther("5"); + await setBalance(nativeStakingSSVStrategy.address, consensusRewards); + // account for the consensus rewards + await nativeStakingSSVStrategy + .connect(validatorRegistrator) + .doAccounting(); + + // prettier-ignore + const tx = await oethHarvester + .connect(josh)["harvestAndSwap(address)"](nativeStakingSSVStrategy.address); + + await expect(tx) + .to.emit(oethHarvester, "RewardProceedsTransferred") + .withArgs( + weth.address, + AddressZero, + executionRewards.add(consensusRewards), + 0 + ); + + // check balances after + expect( + await nativeStakingSSVStrategy.checkBalance(weth.address) + ).to.equal(strategyBalanceBefore, "checkBalance should not increase"); + + expect(await weth.balanceOf(oethDripper.address)).to.equal( + dripperWethBefore.add(executionRewards).add(consensusRewards), + "Dripper WETH balance should increase" + ); + }); + }); +}; + +module.exports = { shouldBehaveLikeAnSsvStrategy } \ No newline at end of file diff --git a/contracts/test/strategies/nativeSsvStaking.fork-test.js b/contracts/test/strategies/nativeSsvStaking.fork-test.js index 0383290379..230c42cb20 100644 --- a/contracts/test/strategies/nativeSsvStaking.fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.fork-test.js @@ -1,410 +1,35 @@ -const { expect } = require("chai"); -const { AddressZero } = require("@ethersproject/constants"); -const { - setBalance, - setStorageAt, -} = require("@nomicfoundation/hardhat-network-helpers"); - -const { oethUnits } = require("../helpers"); -const addresses = require("../../utils/addresses"); -const { impersonateAndFund } = require("../../utils/signers"); -const { getClusterInfo } = require("../../utils/ssv"); - const { createFixtureLoader, nativeStakingSSVStrategyFixture, } = require("./../_fixture"); -const { parseEther } = require("ethers/lib/utils"); +const addresses = require("../../utils/addresses"); const loadFixture = createFixtureLoader(nativeStakingSSVStrategyFixture); +const { shouldBehaveLikeAnSsvStrategy } = require("../behaviour/ssvStrategy"); describe("ForkTest: Native SSV Staking Strategy", function () { this.timeout(0); - // Retry up to 3 times on CI - // this.retries(isCI ? 3 : 0); - let fixture; beforeEach(async () => { fixture = await loadFixture(); }); - describe("Initial setup", function () { - it("Should verify the initial state", async () => { - const { nativeStakingSSVStrategy } = fixture; - await expect( - await nativeStakingSSVStrategy.WETH_TOKEN_ADDRESS() - ).to.equal(addresses.mainnet.WETH, "Incorrect WETH address set"); - await expect(await nativeStakingSSVStrategy.SSV_TOKEN_ADDRESS()).to.equal( - addresses.mainnet.SSV, - "Incorrect SSV Token address" - ); - await expect( - await nativeStakingSSVStrategy.SSV_NETWORK_ADDRESS() - ).to.equal(addresses.mainnet.SSVNetwork, "Incorrect SSV Network address"); - await expect( - await nativeStakingSSVStrategy.BEACON_CHAIN_DEPOSIT_CONTRACT() - ).to.equal( - addresses.mainnet.beaconChainDepositContract, - "Incorrect Beacon deposit contract" - ); - await expect(await nativeStakingSSVStrategy.VAULT_ADDRESS()).to.equal( - addresses.mainnet.OETHVaultProxy, - "Incorrect OETH Vault address" - ); - await expect(await nativeStakingSSVStrategy.fuseIntervalStart()).to.equal( - oethUnits("21.6"), - "Incorrect fuse start" - ); - await expect(await nativeStakingSSVStrategy.fuseIntervalEnd()).to.equal( - oethUnits("25.6"), - "Incorrect fuse end" - ); - await expect( - await nativeStakingSSVStrategy.validatorRegistrator() - ).to.equal( - addresses.mainnet.validatorRegistrator, - "Incorrect validator registrator" - ); - }); - }); - - describe("Deposit/Allocation", function () { - it("Should accept and handle WETH allocation", async () => { - const { oethVault, weth, domen, nativeStakingSSVStrategy } = fixture; - const fakeVaultSigner = await impersonateAndFund(oethVault.address); - - const depositAmount = oethUnits("32"); - const wethBalanceBefore = await weth.balanceOf( - nativeStakingSSVStrategy.address - ); - const strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( - weth.address - ); - - // Transfer some WETH to strategy - await weth - .connect(domen) - .transfer(nativeStakingSSVStrategy.address, depositAmount); - - // Call deposit by impersonating the Vault - const tx = await nativeStakingSSVStrategy - .connect(fakeVaultSigner) - .deposit(weth.address, depositAmount); - - expect(tx) - .to.emit(nativeStakingSSVStrategy, "Deposit") - .withArgs(weth.address, AddressZero, depositAmount); - - expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( - wethBalanceBefore.add(depositAmount), - "WETH not transferred" - ); - expect( - await nativeStakingSSVStrategy.checkBalance(weth.address) - ).to.equal( - strategyBalanceBefore.add(depositAmount), - "strategy checkBalance not increased" - ); - }); - }); - - describe("Validator operations", function () { - const testValidator = { - publicKey: - "0xad9ade40c386259fe4161ec12d7746ab49a098a4760a279c56dc7e26b56fc4d985e74eeecdd2bc5a1decceb5174204f4", - operatorIds: [193, 196, 199, 202], - sharesData: - "0x8308e4b6ad536304f978077a0cd3685a98d5847bb1b05e0a4c5994ddf64ce48daa917f666d86f3125aac139a4fc7b07119ea2c7fc0fe5cfb316a5687dbddf621b0229e55230f0857d426697513ee2556d2c730595268358ebe8e16331bd2dd53acfd93e4e96c5fb510f78dc0f11e5097f83b2609a5711b233fa843935125dbbd90e43dc4f7d181221a42fcc02fe58aeb90fefb6a1d46faad099b6fa8e68351ff21f52d90a96bffeb33d1c0517bf39e413a441f1c290f1289021e9bd47146689ba139bccfaf7d6d1a6fba03c177d9ffca11f347b0f16a1cd8b1808a9b46ec0849ff45562a853ea137dfea3a0ed43ceac5805a993edd6b618cf7aa1441b2deeb2a7a573f0a44d9ed6bffb75573a91e9de2c21e198815d9b133ce7060ff339bf23b12af3c15f566b81842f307066205f09b40b4db045af881f5ca571289d1aa52555002544e8941b854b1b565b5e76c845c4b287a46890d6ad3e01185d2fb5485ecb136814a23378d37ff53244c1420af43db268f74bf0532dd235cb2afd49d1dce7158d1f51650bc32b790f29bdfc2bafc9990a55a15d005139c6ede259a6a9426400d67192ec697a8990c326bc63fe8a809515d0cc311059da2e333cb92331c45ac8b8d2e09a8cc4092016ade9f90a4b1a89a89f9da38818a5a77f84ae2aba340719dc6a01810ddfcd9e9cf9ebfab033363d2a58296cd1ab8e33ea4e04738111a3e2d80d34c601b0b49e95412cdd554a844f02a94f7f239e70cb72247c36218de79b5d0d73a7429cccf1999eca2611b1c486e8148451cac60bc60280764948f54100a39d9290c368a2ace60daa3ff1bf9dd7514afd02397c196b9cee8ef94478619a114cbebdf4475053857f2728c7621c5fb6739cbf8a15727c5d15a354e20ac054f31e51288a4f94a4215d00d23d2e5a82f745f2f15d6b147ecf817165913f2f72f492075de8f339efe54f163311f7de056c36a900949f7f026c17a96770edd29ba0301732bb83d218a0fb28d466858118e7240725ee74a45fd3acf8ca7310cb72f6cb3c6f8517b89984ad622ffeb39dad587d2e944d59fe849841fc5f09e9f1935cc59b10c795446eb18a2f87e6ee1a497fe0bb556164cd2d7b5c7cf5fdb758e8fc26711116bf59a08be68d2ddb9a97300d2ac43055877a0cc3be97c8b82ceb5dd59f6222c23d849dc7620ffca0393d685cb609059e0e8a76500c9c92d7878a3939c346897d10c6707d39bd10d0f546f6506b6b087dea16156478e11d9537d169d582ca26a04dceede25a38b5a4bf2e16db9db97bdb320f198632a0b60af8ebdf3e6a0bda19f34c9ddc7e437d3fef3da021cae41dd99d2898d825db9de51561dee2a5587fa75453609fff5aec3e949a34fd438f00ab6dbca03e385059003936db14c66d4fec38d6ba729051866c336c51c802507dc5b16b591a4905636736a05bbd0d39ba965de131abad34797e3521ff01612b1bd17aca6af61abf8bd24182a1e2848fc41819c0ce7065000747023db82de23eef601ed7cdaffd39b005e8bb8156f4986d9825e62cd2f13f8c0e33e5825e8d81730ef1a63dfd19af6afd08f9f102f403783dca89173456d9e60fb72b2c153bf0bb73bed799a15eb94923f7cadd9c9bc529a86051d8202b1af53ccb161179f9c4609084dd977091082fc14c20ff21efd70bb9ca56b0ea80c7fc16e2f1718c7b306944fa6c7572440c7d6035a22cea8858f64bb3b6d147a05743021ca1b79d71bac87888bb5fd343b1817a28dda336f1d640f8adae159020deba8d3e1e97ae0b9a4ba23112e59d93169a7b875fc878f66f13b2568ed326f9da7ba6c2bd08d37f5b0ef6bfe56febe20e366fa9d", - signature: - "0xadf71438600db72305e4a277554c06359d25e59480e2c4d5ea9d12d132088893d2df141c60a0857c63edc10b9800ac0e0e3e3dcd7b5fdfbcab8fbf377816811becc8be9420c17a725dff9dac6653230b9c5c04fd2ea19f9313fe943e1a562a18", - depositDataRoot: - "0x0d12c28849771f3f946d8d705a1f73683d97add9edaec5e6b30650cc03bc57d5", - }; - - beforeEach(async () => { - const { weth, domen, nativeStakingSSVStrategy } = fixture; - - // Add 32 WETH to the strategy so it can be staked - await weth - .connect(domen) - .transfer(nativeStakingSSVStrategy.address, oethUnits("32")); - }); - - it("Should register and staked 32 ETH by validator registrator", async () => { - const { weth, nativeStakingSSVStrategy, validatorRegistrator } = fixture; - - const strategyWethBalanceBefore = await weth.balanceOf( - nativeStakingSSVStrategy.address - ); - - const { cluster } = await getClusterInfo({ - ownerAddress: nativeStakingSSVStrategy.address, - operatorIds: testValidator.operatorIds, - chainId: 1, - ssvNetwork: addresses.mainnet.SSVNetwork, - }); - - const stakeAmount = oethUnits("32"); - - // Register a new validator with the SSV Network - const regTx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .registerSsvValidator( - testValidator.publicKey, - testValidator.operatorIds, - testValidator.sharesData, - stakeAmount, - cluster - ); - await expect(regTx) - .to.emit(nativeStakingSSVStrategy, "SSVValidatorRegistered") - .withArgs(testValidator.publicKey, testValidator.operatorIds); - - // Stake 32 ETH to the new validator - const stakeTx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .stakeEth([ - { - pubkey: testValidator.publicKey, - signature: testValidator.signature, - depositDataRoot: testValidator.depositDataRoot, - }, - ]); - - await expect(stakeTx) - .to.emit(nativeStakingSSVStrategy, "ETHStaked") - .withNamedArgs({ - pubkey: testValidator.publicKey, - amount: stakeAmount, - }); - - expect(await weth.balanceOf(nativeStakingSSVStrategy.address)).to.equal( - strategyWethBalanceBefore.sub( - stakeAmount, - "strategy WETH not decreased" - ) - ); - }); - - it("Should exit and remove validator by validator registrator", async () => { - const { nativeStakingSSVStrategy, ssvNetwork, validatorRegistrator } = - fixture; - - const { cluster } = await getClusterInfo({ - ownerAddress: nativeStakingSSVStrategy.address, - operatorIds: testValidator.operatorIds, - chainId: 1, - ssvNetwork: addresses.mainnet.SSVNetwork, - }); - - const stakeAmount = oethUnits("32"); - - // Register a new validator with the SSV network - const regTx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .registerSsvValidator( - testValidator.publicKey, - testValidator.operatorIds, - testValidator.sharesData, - stakeAmount, - cluster - ); - const regReceipt = await regTx.wait(); - const ValidatorAddedEvent = ssvNetwork.interface.parseLog( - regReceipt.events[2] - ); - const { cluster: newCluster } = ValidatorAddedEvent.args; - - // Stake 32 ETH to the new validator - await nativeStakingSSVStrategy.connect(validatorRegistrator).stakeEth([ - { - pubkey: testValidator.publicKey, - signature: testValidator.signature, - depositDataRoot: testValidator.depositDataRoot, - }, - ]); - - // exit validator from SSV network - const exitTx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .exitSsvValidator(testValidator.publicKey, testValidator.operatorIds); - - await expect(exitTx) - .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitInitiated") - .withArgs(testValidator.publicKey, testValidator.operatorIds); - - const removeTx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .removeSsvValidator( - testValidator.publicKey, - testValidator.operatorIds, - newCluster - ); - - await expect(removeTx) - .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitCompleted") - .withArgs(testValidator.publicKey, testValidator.operatorIds); - }); - }); - - describe("Accounting for ETH", function () { - let strategyBalanceBefore; - let consensusRewardsBefore; - let activeDepositedValidatorsBefore = 30000; - beforeEach(async () => { - const { nativeStakingSSVStrategy, validatorRegistrator, weth } = fixture; - - // clear any ETH sitting in the strategy - await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .doAccounting(); - - // Set the number validators to a high number - await setStorageAt( - nativeStakingSSVStrategy.address, - 52, // the storage slot - activeDepositedValidatorsBefore - ); - - strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( - weth.address - ); - consensusRewardsBefore = - await nativeStakingSSVStrategy.consensusRewards(); - }); - - it("Should account for new consensus rewards", async () => { - const { nativeStakingSSVStrategy, validatorRegistrator, weth } = fixture; - - const rewards = oethUnits("2"); - - // simulate consensus rewards - await setBalance( - nativeStakingSSVStrategy.address, - consensusRewardsBefore.add(rewards) - ); - - const tx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .doAccounting(); - - await expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingConsensusRewards") - .withArgs(rewards); - - // check balances after - expect( - await nativeStakingSSVStrategy.checkBalance(weth.address) - ).to.equal(strategyBalanceBefore, "checkBalance should not increase"); - expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( - consensusRewardsBefore.add(rewards), - "consensusRewards should increase" - ); - }); - it("Should account for withdrawals and consensus rewards", async () => { - const { - oethVault, - nativeStakingSSVStrategy, - validatorRegistrator, - weth, - } = fixture; - - const rewards = oethUnits("3"); - const withdrawals = oethUnits("64"); - const vaultWethBalanceBefore = await weth.balanceOf(oethVault.address); - - // simulate withdraw of 2 validators and consensus rewards - await setBalance( - nativeStakingSSVStrategy.address, - withdrawals.add(rewards) - ); - - const tx = await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .doAccounting(); - - await expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingFullyWithdrawnValidator") - .withArgs(2, activeDepositedValidatorsBefore - 2, withdrawals); - - await expect(tx) - .to.emit(nativeStakingSSVStrategy, "AccountingConsensusRewards") - .withArgs(rewards); - - // check balances after - expect( - await nativeStakingSSVStrategy.checkBalance(weth.address) - ).to.equal( - strategyBalanceBefore.sub(withdrawals), - "checkBalance should decrease" - ); - expect(await nativeStakingSSVStrategy.consensusRewards()).to.equal( - consensusRewardsBefore.add(rewards), - "consensusRewards should increase" - ); - expect( - await nativeStakingSSVStrategy.activeDepositedValidators() - ).to.equal( - activeDepositedValidatorsBefore - 2, - "active validators decreases" - ); - expect(await weth.balanceOf(oethVault.address)).to.equal( - vaultWethBalanceBefore.add(withdrawals, "WETH in vault should increase") - ); - }); - }); - - describe("Harvest", function () { - it("Should account for new execution rewards", async () => { - const { - oethHarvester, - josh, - nativeStakingSSVStrategy, - nativeStakingFeeAccumulator, - oethDripper, - weth, - validatorRegistrator, - } = fixture; - const dripperWethBefore = await weth.balanceOf(oethDripper.address); - - const strategyBalanceBefore = await nativeStakingSSVStrategy.checkBalance( - weth.address - ); - - // add some ETH to the FeeAccumulator to simulate execution rewards - const executionRewards = parseEther("7"); - await setBalance(nativeStakingFeeAccumulator.address, executionRewards); - // simulate consensus rewards - const consensusRewards = parseEther("5"); - await setBalance(nativeStakingSSVStrategy.address, consensusRewards); - // account for the consensus rewards - await nativeStakingSSVStrategy - .connect(validatorRegistrator) - .doAccounting(); - - // prettier-ignore - const tx = await oethHarvester - .connect(josh)["harvestAndSwap(address)"](nativeStakingSSVStrategy.address); - - await expect(tx) - .to.emit(oethHarvester, "RewardProceedsTransferred") - .withArgs( - weth.address, - addresses.zero, - executionRewards.add(consensusRewards), - 0 - ); - - // check balances after - expect( - await nativeStakingSSVStrategy.checkBalance(weth.address) - ).to.equal(strategyBalanceBefore, "checkBalance should not increase"); - - expect(await weth.balanceOf(oethDripper.address)).to.equal( - dripperWethBefore.add(executionRewards).add(consensusRewards), - "Dripper WETH balance should increase" - ); - }); + shouldBehaveLikeAnSsvStrategy(async () => { + return { + ...fixture, + addresses: addresses.mainnet, + testValidator: { + publicKey: + "0xad9ade40c386259fe4161ec12d7746ab49a098a4760a279c56dc7e26b56fc4d985e74eeecdd2bc5a1decceb5174204f4", + operatorIds: [193, 196, 199, 202], + sharesData: + "0x8308e4b6ad536304f978077a0cd3685a98d5847bb1b05e0a4c5994ddf64ce48daa917f666d86f3125aac139a4fc7b07119ea2c7fc0fe5cfb316a5687dbddf621b0229e55230f0857d426697513ee2556d2c730595268358ebe8e16331bd2dd53acfd93e4e96c5fb510f78dc0f11e5097f83b2609a5711b233fa843935125dbbd90e43dc4f7d181221a42fcc02fe58aeb90fefb6a1d46faad099b6fa8e68351ff21f52d90a96bffeb33d1c0517bf39e413a441f1c290f1289021e9bd47146689ba139bccfaf7d6d1a6fba03c177d9ffca11f347b0f16a1cd8b1808a9b46ec0849ff45562a853ea137dfea3a0ed43ceac5805a993edd6b618cf7aa1441b2deeb2a7a573f0a44d9ed6bffb75573a91e9de2c21e198815d9b133ce7060ff339bf23b12af3c15f566b81842f307066205f09b40b4db045af881f5ca571289d1aa52555002544e8941b854b1b565b5e76c845c4b287a46890d6ad3e01185d2fb5485ecb136814a23378d37ff53244c1420af43db268f74bf0532dd235cb2afd49d1dce7158d1f51650bc32b790f29bdfc2bafc9990a55a15d005139c6ede259a6a9426400d67192ec697a8990c326bc63fe8a809515d0cc311059da2e333cb92331c45ac8b8d2e09a8cc4092016ade9f90a4b1a89a89f9da38818a5a77f84ae2aba340719dc6a01810ddfcd9e9cf9ebfab033363d2a58296cd1ab8e33ea4e04738111a3e2d80d34c601b0b49e95412cdd554a844f02a94f7f239e70cb72247c36218de79b5d0d73a7429cccf1999eca2611b1c486e8148451cac60bc60280764948f54100a39d9290c368a2ace60daa3ff1bf9dd7514afd02397c196b9cee8ef94478619a114cbebdf4475053857f2728c7621c5fb6739cbf8a15727c5d15a354e20ac054f31e51288a4f94a4215d00d23d2e5a82f745f2f15d6b147ecf817165913f2f72f492075de8f339efe54f163311f7de056c36a900949f7f026c17a96770edd29ba0301732bb83d218a0fb28d466858118e7240725ee74a45fd3acf8ca7310cb72f6cb3c6f8517b89984ad622ffeb39dad587d2e944d59fe849841fc5f09e9f1935cc59b10c795446eb18a2f87e6ee1a497fe0bb556164cd2d7b5c7cf5fdb758e8fc26711116bf59a08be68d2ddb9a97300d2ac43055877a0cc3be97c8b82ceb5dd59f6222c23d849dc7620ffca0393d685cb609059e0e8a76500c9c92d7878a3939c346897d10c6707d39bd10d0f546f6506b6b087dea16156478e11d9537d169d582ca26a04dceede25a38b5a4bf2e16db9db97bdb320f198632a0b60af8ebdf3e6a0bda19f34c9ddc7e437d3fef3da021cae41dd99d2898d825db9de51561dee2a5587fa75453609fff5aec3e949a34fd438f00ab6dbca03e385059003936db14c66d4fec38d6ba729051866c336c51c802507dc5b16b591a4905636736a05bbd0d39ba965de131abad34797e3521ff01612b1bd17aca6af61abf8bd24182a1e2848fc41819c0ce7065000747023db82de23eef601ed7cdaffd39b005e8bb8156f4986d9825e62cd2f13f8c0e33e5825e8d81730ef1a63dfd19af6afd08f9f102f403783dca89173456d9e60fb72b2c153bf0bb73bed799a15eb94923f7cadd9c9bc529a86051d8202b1af53ccb161179f9c4609084dd977091082fc14c20ff21efd70bb9ca56b0ea80c7fc16e2f1718c7b306944fa6c7572440c7d6035a22cea8858f64bb3b6d147a05743021ca1b79d71bac87888bb5fd343b1817a28dda336f1d640f8adae159020deba8d3e1e97ae0b9a4ba23112e59d93169a7b875fc878f66f13b2568ed326f9da7ba6c2bd08d37f5b0ef6bfe56febe20e366fa9d", + signature: + "0xadf71438600db72305e4a277554c06359d25e59480e2c4d5ea9d12d132088893d2df141c60a0857c63edc10b9800ac0e0e3e3dcd7b5fdfbcab8fbf377816811becc8be9420c17a725dff9dac6653230b9c5c04fd2ea19f9313fe943e1a562a18", + depositDataRoot: + "0x0d12c28849771f3f946d8d705a1f73683d97add9edaec5e6b30650cc03bc57d5", + } + } }); }); diff --git a/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js b/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js new file mode 100644 index 0000000000..e2d269d984 --- /dev/null +++ b/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js @@ -0,0 +1,41 @@ +const { loadSimpleOETHFixture } = require("./../_fixture"); +const { shouldBehaveLikeAnSsvStrategy } = require("../behaviour/ssvStrategy"); +const addresses = require("../../utils/addresses"); +const { impersonateAndFund } = require("../../utils/signers"); + +describe("Holesky ForkTest: Native SSV Staking Strategy", function () { + this.timeout(0); + + let fixture; + beforeEach(async () => { + fixture = await loadSimpleOETHFixture(); + }); + + shouldBehaveLikeAnSsvStrategy(async () => { + + return { + ...fixture, + addresses: addresses.holesky, + validatorRegistrator: await impersonateAndFund(addresses.holesky.validatorRegistrator), + ssvNetwork: await ethers.getContractAt( + "ISSVNetwork", + addresses.holesky.SSVNetwork + ), + nativeStakingFeeAccumulator: await ethers.getContractAt( + "FeeAccumulator", + await fixture.nativeStakingSSVStrategy.FEE_ACCUMULATOR_ADDRESS() + ), + testValidator: { + publicKey: + "0xb279166b18ca9ced3e0a83385799ae33b27c6cd2ad2083b9b7c33c555d091933a09b1af9fb65c6c4d51c40ca931447a9", + operatorIds: [111, 119, 230, 252], + sharesData: + "0xb1edfddfdf70c8c56cfba3f00ae09815db2383c4faa328733df73dd4616492a58648d543642078c72e2bad60a22322d70ea44cc953c05aa0404681fb57498daa9cbd5c8cc98f736c75a8bf908f0eb98d6448b6778f35b1ce724fee8a1bb53f9ab60f29c5fc7c53e1577a27581b8aff689ac2fdeda72e9620f6991edb7779acef68ed2e6ea4ccfaecd00ccac09b7ed8b7abc72ea5c5469e1b5603c73fe3d054e074c88446c4e31abbc34ee309022524da5aacecb4aa83bf0ac658931813a402e4a4b1d9f83d54404b730e04e61dc82e872fa397e3a9ea249715c861ef0d4b309fdba762cd07f0506925a7a4e3e52d2c0e8f07ae01b8bb393df14c17648340c55e3a82564efb943de4033308d197d562c8bf377a589c87e4c7757afe5964ec92a616622138797c4a647dda550e3b94e3a6152cdda20d4a7b491218ab7df46a2eb9c3963811bf0555b272bf4ef5a8c0c2496e133d1cc34b01c7a5cb40d379e607d0bd7f0d8fcb965ab8d5c7634d80dbd3fac67227b53ec6fbd1a5207bfea8cb202ac88fef732328a2b717b6284af9f34a251e5ecf5eb744a4cf4df35abb423ca02556df957cd8bc645b83d497235b92f310996748c54a89106937cfcf182744ad423b104ca0a61a351d15aa9ae98093f64de31e14a7203304021ebbe2ee0e3f91e1641ff7da84396a83643101cfe67640c05467ffa8de458ebb4db0fcffe9210b72c50f8835cb636e1f5e7356092f15b29fb11761ce36a6601d599eb02d82aa02ce300a7e6c538ca72133036e5f3634c29b27c66964f65086e3f725d535f5e7d92f6a0b589a71caa7d0ca572c5192fe6ef5a4b44ad05cbb8c214a444a399b035263a1d2853bfe43b457873e700be599d3ff03532df1f52be09f6607acfc466f8bb4c4d98d74908c7394d516b738a6143a5456dc43a45f1f00a6515e11b5efc6f4dabfb3d967941ac159a8b6f7c464760c4770082b1d97600cabb1dc286d20c321e6bcb36138507915c399d8639d8a66143bff1f5a6d6cb63d0a8b560134dab42e9d23100c05e51104e068c0c76ecb5382d04e34375efea6467dfb096f6dc12b67609ea1d8310044ab8e80f75341b4aa3eb8dd5f465a3dc6b3f1dea8f25c77cdc34f0eb04247c1ac73bde467c8048cc4d57afefcb33de7520048baeaa9401fc175061881d5c60c89a4fe71cf6af8ed7ba3f6b5da42ef2ee5454f422ecf0b02d09f1ba77d35b56240232237810ffe4ff8e49c4a40a9aab7880ea91472440f30b22797f97d90a68e7904513a4267af47d988d96a17c5a2e90c4ad7c6fb56de8ba7e5488cfc16d1015963e2778e2b3def5ffdda1439cf8750b5823e31f4ba59f1eaf17c7ee98a69495a3c38c177175554b343c21f91a708c6313f146bbdde18b1fcead4e0d0274c8c1010c96f79b81060b850ab5c1da001fc908e45b84d57837fbbd272a4349261e500ce56560939cba45a58f2d0bdba3c6631e52d4e0b7a29ea50f14ed36c1ccb5fca6fdc45f881764b3ee39949ef5df255d9afdedfdf390409dadd31df7540d25174cf21a33dce1a2fd6097967be67267aa7e9353db71821bd89db0b3887eebc01cb64a4116edefac323fdde618a34d91545bab38f920e8e6f38b22a3a243b261fd56f0ec1ff6187b3ed42ddeeadf2c7a78c154d44ab332e293ca2b03e77ae1fe628378e336bc73149df4d7cbc86df73d04b9d35a9fe6a87a865f92337a8df10d5a5cf4dcc6cfba73bdd9b13d3b671acfc829b87f869ed42a48ced74099f92ac79721a79ac93d7c4d5e9be780fe1a78f807fd6a222fac05c3c8b9cd4182cb84617abaa72815b5dceec1d58b1278bf90498e4be3a456428866170046c", + signature: + "0xa450d596551c7fb7aca201e9a075b034d8da1ec7bf8806740ca53c0e8653465ed9cd26d6ce10290581586676eb0dd896022a243dc42179337c9c4c2a60969a11bb9e4a2dcf57a783daf880999f6db34d1e42163cb96287b3bb91b03361942b80", + depositDataRoot: + "0x3f327f69bb527386ff4c2f820e6e375fcc632b1b7ee826bd53d4d2807cfd6769", + } + } + }); +}); diff --git a/contracts/test/strategies/nativeSsvStaking.holesky.fork-test.js b/contracts/test/strategies/nativeSsvStaking.holesky.fork-test.js deleted file mode 100644 index ec838941c6..0000000000 --- a/contracts/test/strategies/nativeSsvStaking.holesky.fork-test.js +++ /dev/null @@ -1,147 +0,0 @@ -const { expect } = require("chai"); -const { utils, BigNumber } = require("ethers"); -const addresses = require("../../utils/addresses"); -const { units, oethUnits } = require("../helpers"); - -const { loadSimpleOETHFixture } = require("./../_fixture"); - -describe("Holesky ForkTest: Native SSV Staking Strategy", function () { - this.timeout(0); - - // Retry up to 3 times on CI - // this.retries(isCI ? 3 : 0); - - let fixture; - beforeEach(async () => { - fixture = await loadSimpleOETHFixture(); - }); - - describe("Initial setup", function () { - it("Should verify the initial state", async () => { - const { nativeStakingSSVStrategy } = fixture; - await expect( - await nativeStakingSSVStrategy.WETH_TOKEN_ADDRESS() - ).to.equal(addresses.holesky.WETH, "Incorrect WETH address set"); - await expect(await nativeStakingSSVStrategy.SSV_TOKEN_ADDRESS()).to.equal( - addresses.holesky.SSV, - "Incorrect SSV Token address" - ); - await expect( - await nativeStakingSSVStrategy.SSV_NETWORK_ADDRESS() - ).to.equal(addresses.holesky.SSVNetwork, "Incorrect SSV Network address"); - }); - - it("Should check that the fuse interval is configured correctly", async () => { - const { nativeStakingSSVStrategy } = fixture; - - await expect(utils.parseEther("21.6")).to.equal( - await nativeStakingSSVStrategy.fuseIntervalStart() - ); - await expect(utils.parseEther("25.6")).to.equal( - await nativeStakingSSVStrategy.fuseIntervalEnd() - ); - }); - }); - - describe("Deposit/Allocation register validators", function () { - it("Should mint using WETH and see balance on the strategy contract", async () => { - const { josh, weth } = fixture; - await mintTest(fixture, josh, weth, "32"); - }); - - it("Should mint using WETH and deposit to a validator", async () => { - const { josh, weth } = fixture; - await mintTest(fixture, josh, weth, "32"); - - await registerAndDepositTest(fixture); - }); - }); - - describe("Withdraw", function () {}); - - describe("Balance/Assets", function () {}); - - const registerAndDepositTest = async (fixture) => { - const { nativeStakingSSVStrategy, strategist } = fixture; - - await nativeStakingSSVStrategy - .connect(strategist) // TODO this will be a Defender relayer - .registerSsvValidator( - // pubkey - "0xb279166b18ca9ced3e0a83385799ae33b27c6cd2ad2083b9b7c33c555d091933a09b1af9fb65c6c4d51c40ca931447a9", - // operator ids - [111, 119, 230, 252], - // shares data - "0xb1edfddfdf70c8c56cfba3f00ae09815db2383c4faa328733df73dd4616492a58648d543642078c72e2bad60a22322d70ea44cc953c05aa0404681fb57498daa9cbd5c8cc98f736c75a8bf908f0eb98d6448b6778f35b1ce724fee8a1bb53f9ab60f29c5fc7c53e1577a27581b8aff689ac2fdeda72e9620f6991edb7779acef68ed2e6ea4ccfaecd00ccac09b7ed8b7abc72ea5c5469e1b5603c73fe3d054e074c88446c4e31abbc34ee309022524da5aacecb4aa83bf0ac658931813a402e4a4b1d9f83d54404b730e04e61dc82e872fa397e3a9ea249715c861ef0d4b309fdba762cd07f0506925a7a4e3e52d2c0e8f07ae01b8bb393df14c17648340c55e3a82564efb943de4033308d197d562c8bf377a589c87e4c7757afe5964ec92a616622138797c4a647dda550e3b94e3a6152cdda20d4a7b491218ab7df46a2eb9c3963811bf0555b272bf4ef5a8c0c2496e133d1cc34b01c7a5cb40d379e607d0bd7f0d8fcb965ab8d5c7634d80dbd3fac67227b53ec6fbd1a5207bfea8cb202ac88fef732328a2b717b6284af9f34a251e5ecf5eb744a4cf4df35abb423ca02556df957cd8bc645b83d497235b92f310996748c54a89106937cfcf182744ad423b104ca0a61a351d15aa9ae98093f64de31e14a7203304021ebbe2ee0e3f91e1641ff7da84396a83643101cfe67640c05467ffa8de458ebb4db0fcffe9210b72c50f8835cb636e1f5e7356092f15b29fb11761ce36a6601d599eb02d82aa02ce300a7e6c538ca72133036e5f3634c29b27c66964f65086e3f725d535f5e7d92f6a0b589a71caa7d0ca572c5192fe6ef5a4b44ad05cbb8c214a444a399b035263a1d2853bfe43b457873e700be599d3ff03532df1f52be09f6607acfc466f8bb4c4d98d74908c7394d516b738a6143a5456dc43a45f1f00a6515e11b5efc6f4dabfb3d967941ac159a8b6f7c464760c4770082b1d97600cabb1dc286d20c321e6bcb36138507915c399d8639d8a66143bff1f5a6d6cb63d0a8b560134dab42e9d23100c05e51104e068c0c76ecb5382d04e34375efea6467dfb096f6dc12b67609ea1d8310044ab8e80f75341b4aa3eb8dd5f465a3dc6b3f1dea8f25c77cdc34f0eb04247c1ac73bde467c8048cc4d57afefcb33de7520048baeaa9401fc175061881d5c60c89a4fe71cf6af8ed7ba3f6b5da42ef2ee5454f422ecf0b02d09f1ba77d35b56240232237810ffe4ff8e49c4a40a9aab7880ea91472440f30b22797f97d90a68e7904513a4267af47d988d96a17c5a2e90c4ad7c6fb56de8ba7e5488cfc16d1015963e2778e2b3def5ffdda1439cf8750b5823e31f4ba59f1eaf17c7ee98a69495a3c38c177175554b343c21f91a708c6313f146bbdde18b1fcead4e0d0274c8c1010c96f79b81060b850ab5c1da001fc908e45b84d57837fbbd272a4349261e500ce56560939cba45a58f2d0bdba3c6631e52d4e0b7a29ea50f14ed36c1ccb5fca6fdc45f881764b3ee39949ef5df255d9afdedfdf390409dadd31df7540d25174cf21a33dce1a2fd6097967be67267aa7e9353db71821bd89db0b3887eebc01cb64a4116edefac323fdde618a34d91545bab38f920e8e6f38b22a3a243b261fd56f0ec1ff6187b3ed42ddeeadf2c7a78c154d44ab332e293ca2b03e77ae1fe628378e336bc73149df4d7cbc86df73d04b9d35a9fe6a87a865f92337a8df10d5a5cf4dcc6cfba73bdd9b13d3b671acfc829b87f869ed42a48ced74099f92ac79721a79ac93d7c4d5e9be780fe1a78f807fd6a222fac05c3c8b9cd4182cb84617abaa72815b5dceec1d58b1278bf90498e4be3a456428866170046c", - // amount - BigNumber.from("1534241968000000000"), - // cluster tuple - [0, 0, 0, true, 0] - ); - - await nativeStakingSSVStrategy - .connect(strategist) // TODO this will be a Defender relayer - .stakeEth([ - [ - //pubkey - "0xb279166b18ca9ced3e0a83385799ae33b27c6cd2ad2083b9b7c33c555d091933a09b1af9fb65c6c4d51c40ca931447a9", - //signature - "0xa450d596551c7fb7aca201e9a075b034d8da1ec7bf8806740ca53c0e8653465ed9cd26d6ce10290581586676eb0dd896022a243dc42179337c9c4c2a60969a11bb9e4a2dcf57a783daf880999f6db34d1e42163cb96287b3bb91b03361942b80", - //depositDataRoot - "0x3f327f69bb527386ff4c2f820e6e375fcc632b1b7ee826bd53d4d2807cfd6769", - ], - ]); - }; - - const mintTest = async (fixture, user, asset, amount = "32") => { - const { oethVault, oeth, weth, nativeStakingSSVStrategy, strategist } = - fixture; - - const unitAmount = await units(amount, asset); - - if (asset.address != weth.address) { - const tx = oethVault.connect(user).mint(asset.address, unitAmount, "0"); - await expect(tx).to.be.revertedWith("Unsupported asset for minting"); - return; - } - - await oethVault.connect(user).allocate(); - await oethVault.connect(user).rebase(); - - const currentSupply = await oeth.totalSupply(); - const currentBalance = await oeth.connect(user).balanceOf(user.address); - const currentStrategyBalance = await nativeStakingSSVStrategy.checkBalance( - weth.address - ); - - // Mint OETH w/ asset - await oethVault.connect(user).mint(asset.address, unitAmount, 0); - - await oethVault - .connect(strategist) - .depositToStrategy( - nativeStakingSSVStrategy.address, - [asset.address], - [unitAmount] - ); - - await oethVault.connect(user).allocate(); - - const newBalance = await oeth.connect(user).balanceOf(user.address); - const newSupply = await oeth.totalSupply(); - const newStrategyBalance = await nativeStakingSSVStrategy.checkBalance( - weth.address - ); - - const balanceDiff = newBalance.sub(currentBalance); - // Ensure user has correct balance (w/ 1% slippage tolerance) - expect(balanceDiff).to.approxEqualTolerance(oethUnits(amount), 2); - - // Supply checks - const supplyDiff = newSupply.sub(currentSupply); - const oethUnitAmount = oethUnits(amount); - expect(supplyDiff).to.approxEqualTolerance(oethUnitAmount, 1); - - expect(unitAmount).to.equal(newStrategyBalance.sub(currentStrategyBalance)); - }; -}); diff --git a/contracts/utils/addresses.js b/contracts/utils/addresses.js index 17394057a5..f50983dea3 100644 --- a/contracts/utils/addresses.js +++ b/contracts/utils/addresses.js @@ -268,4 +268,6 @@ addresses.holesky.SSVNetwork = "0x38A4794cCEd47d3baf7370CcC43B560D3a1beEFA"; addresses.holesky.beaconChainDepositContract = "0x4242424242424242424242424242424242424242"; +addresses.holesky.OETHVaultProxy = "0x19d2bAaBA949eFfa163bFB9efB53ed8701aA5dD9"; +addresses.holesky.validatorRegistrator = "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C"; module.exports = addresses; From 0249e5384690e16f230956aaea5a907f2307129a Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 20:35:07 +0200 Subject: [PATCH 21/30] prettier --- contracts/test/behaviour/ssvStrategy.js | 32 +++++++++++++------ .../strategies/nativeSsvStaking.fork-test.js | 4 +-- .../nativeSsvStaking.holesky-fork-test.js | 9 +++--- contracts/utils/addresses.js | 3 +- 4 files changed, 32 insertions(+), 16 deletions(-) diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js index f2454de922..1648d685b3 100644 --- a/contracts/test/behaviour/ssvStrategy.js +++ b/contracts/test/behaviour/ssvStrategy.js @@ -70,7 +70,8 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { describe("Deposit/Allocation", function () { it("Should accept and handle WETH allocation", async () => { - const { oethVault, weth, domen, nativeStakingSSVStrategy, } = await context(); + const { oethVault, weth, domen, nativeStakingSSVStrategy } = + await context(); const fakeVaultSigner = await impersonateAndFund(oethVault.address); const depositAmount = oethUnits("32"); @@ -110,7 +111,8 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { describe("Validator operations", function () { beforeEach(async () => { - const { weth, domen, nativeStakingSSVStrategy, addresses } = await context(); + const { weth, domen, nativeStakingSSVStrategy, addresses } = + await context(); // Add 32 WETH to the strategy so it can be staked await weth @@ -119,7 +121,12 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { }); it("Should register and staked 32 ETH by validator registrator", async () => { - const { weth, nativeStakingSSVStrategy, validatorRegistrator, testValidator } = await context(); + const { + weth, + nativeStakingSSVStrategy, + validatorRegistrator, + testValidator, + } = await context(); const strategyWethBalanceBefore = await weth.balanceOf( nativeStakingSSVStrategy.address @@ -175,8 +182,13 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { }); it("Should exit and remove validator by validator registrator", async () => { - const { nativeStakingSSVStrategy, ssvNetwork, validatorRegistrator, addresses, testValidator } = - await context(); + const { + nativeStakingSSVStrategy, + ssvNetwork, + validatorRegistrator, + addresses, + testValidator, + } = await context(); const { cluster } = await getClusterInfo({ ownerAddress: nativeStakingSSVStrategy.address, @@ -240,7 +252,8 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { let consensusRewardsBefore; let activeDepositedValidatorsBefore = 30000; beforeEach(async () => { - const { nativeStakingSSVStrategy, validatorRegistrator, weth } = await context(); + const { nativeStakingSSVStrategy, validatorRegistrator, weth } = + await context(); // clear any ETH sitting in the strategy await nativeStakingSSVStrategy @@ -262,7 +275,8 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { }); it("Should account for new consensus rewards", async () => { - const { nativeStakingSSVStrategy, validatorRegistrator, weth } = await context(); + const { nativeStakingSSVStrategy, validatorRegistrator, weth } = + await context(); const rewards = oethUnits("2"); @@ -352,7 +366,7 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { oethDripper, weth, validatorRegistrator, - addresses + addresses, } = await context(); const dripperWethBefore = await weth.balanceOf(oethDripper.address); @@ -397,4 +411,4 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { }); }; -module.exports = { shouldBehaveLikeAnSsvStrategy } \ No newline at end of file +module.exports = { shouldBehaveLikeAnSsvStrategy }; diff --git a/contracts/test/strategies/nativeSsvStaking.fork-test.js b/contracts/test/strategies/nativeSsvStaking.fork-test.js index 230c42cb20..3652fa8955 100644 --- a/contracts/test/strategies/nativeSsvStaking.fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.fork-test.js @@ -29,7 +29,7 @@ describe("ForkTest: Native SSV Staking Strategy", function () { "0xadf71438600db72305e4a277554c06359d25e59480e2c4d5ea9d12d132088893d2df141c60a0857c63edc10b9800ac0e0e3e3dcd7b5fdfbcab8fbf377816811becc8be9420c17a725dff9dac6653230b9c5c04fd2ea19f9313fe943e1a562a18", depositDataRoot: "0x0d12c28849771f3f946d8d705a1f73683d97add9edaec5e6b30650cc03bc57d5", - } - } + }, + }; }); }); diff --git a/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js b/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js index e2d269d984..f5447b1dcd 100644 --- a/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js +++ b/contracts/test/strategies/nativeSsvStaking.holesky-fork-test.js @@ -12,11 +12,12 @@ describe("Holesky ForkTest: Native SSV Staking Strategy", function () { }); shouldBehaveLikeAnSsvStrategy(async () => { - return { ...fixture, addresses: addresses.holesky, - validatorRegistrator: await impersonateAndFund(addresses.holesky.validatorRegistrator), + validatorRegistrator: await impersonateAndFund( + addresses.holesky.validatorRegistrator + ), ssvNetwork: await ethers.getContractAt( "ISSVNetwork", addresses.holesky.SSVNetwork @@ -35,7 +36,7 @@ describe("Holesky ForkTest: Native SSV Staking Strategy", function () { "0xa450d596551c7fb7aca201e9a075b034d8da1ec7bf8806740ca53c0e8653465ed9cd26d6ce10290581586676eb0dd896022a243dc42179337c9c4c2a60969a11bb9e4a2dcf57a783daf880999f6db34d1e42163cb96287b3bb91b03361942b80", depositDataRoot: "0x3f327f69bb527386ff4c2f820e6e375fcc632b1b7ee826bd53d4d2807cfd6769", - } - } + }, + }; }); }); diff --git a/contracts/utils/addresses.js b/contracts/utils/addresses.js index f50983dea3..9c4e5a7b7e 100644 --- a/contracts/utils/addresses.js +++ b/contracts/utils/addresses.js @@ -269,5 +269,6 @@ addresses.holesky.beaconChainDepositContract = "0x4242424242424242424242424242424242424242"; addresses.holesky.OETHVaultProxy = "0x19d2bAaBA949eFfa163bFB9efB53ed8701aA5dD9"; -addresses.holesky.validatorRegistrator = "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C"; +addresses.holesky.validatorRegistrator = + "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C"; module.exports = addresses; From 9f6bbf24d747a4b051e62f332bc1ec919e9d6e2b Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 20:44:36 +0200 Subject: [PATCH 22/30] re-deploy holesky native staking strategy (#2046) --- .../deploy/holesky/004_upgrade_strategy.js | 18 + .../deployments/holesky/.migrations.json | 3 +- .../holesky/NativeStakingSSVStrategy.json | 241 +++---- .../66dbdc9fbde8f1c7cc59f29d272eb661.json | 674 ++++++++++++++++++ 4 files changed, 782 insertions(+), 154 deletions(-) create mode 100644 contracts/deploy/holesky/004_upgrade_strategy.js create mode 100644 contracts/deployments/holesky/solcInputs/66dbdc9fbde8f1c7cc59f29d272eb661.json diff --git a/contracts/deploy/holesky/004_upgrade_strategy.js b/contracts/deploy/holesky/004_upgrade_strategy.js new file mode 100644 index 0000000000..fac1a8ebff --- /dev/null +++ b/contracts/deploy/holesky/004_upgrade_strategy.js @@ -0,0 +1,18 @@ +const { upgradeNativeStakingSSVStrategy } = require("../deployActions"); + +const mainExport = async () => { + console.log("Running 004 deployment on Holesky..."); + + console.log("Upgrading native staking strategy"); + await upgradeNativeStakingSSVStrategy(); + + console.log("Running 004 deployment done"); + return true; +}; + +mainExport.id = "004_upgrade_strategy"; +mainExport.tags = []; +mainExport.dependencies = []; +mainExport.skip = () => false; + +module.exports = mainExport; diff --git a/contracts/deployments/holesky/.migrations.json b/contracts/deployments/holesky/.migrations.json index d45ad24364..142d25dba9 100644 --- a/contracts/deployments/holesky/.migrations.json +++ b/contracts/deployments/holesky/.migrations.json @@ -1,5 +1,6 @@ { "001_core": 1714168010, "002_upgrade_strategy": 1714233842, - "003_deposit_to_native_strategy": 1714307581 + "003_deposit_to_native_strategy": 1714307581, + "004_upgrade_strategy": 1714761605 } \ No newline at end of file diff --git a/contracts/deployments/holesky/NativeStakingSSVStrategy.json b/contracts/deployments/holesky/NativeStakingSSVStrategy.json index 260cfb1a33..5d5b2a21a9 100644 --- a/contracts/deployments/holesky/NativeStakingSSVStrategy.json +++ b/contracts/deployments/holesky/NativeStakingSSVStrategy.json @@ -1,5 +1,5 @@ { - "address": "0x4aEAcdb5D84eDf02Dd85f3DFC1645b89D7579d62", + "address": "0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793", "abi": [ { "inputs": [ @@ -92,51 +92,20 @@ "inputs": [ { "indexed": false, - "internalType": "address", - "name": "newAddress", - "type": "address" - } - ], - "name": "AccountingGovernorChanged", - "type": "event" - }, - { - "anonymous": false, - "inputs": [ - { - "indexed": false, - "internalType": "uint256", - "name": "oldActiveDepositedValidators", - "type": "uint256" + "internalType": "int256", + "name": "validatorsDelta", + "type": "int256" }, { "indexed": false, - "internalType": "uint256", - "name": "activeDepositedValidators", - "type": "uint256" + "internalType": "int256", + "name": "consensusRewardsDelta", + "type": "int256" }, { "indexed": false, "internalType": "uint256", - "name": "oldBeaconChainRewards", - "type": "uint256" - }, - { - "indexed": false, - "internalType": "uint256", - "name": "beaconChainRewards", - "type": "uint256" - }, - { - "indexed": false, - "internalType": "uint256", - "name": "ethToWeth", - "type": "uint256" - }, - { - "indexed": false, - "internalType": "uint256", - "name": "wethToBeSentToVault", + "name": "wethToVault", "type": "uint256" } ], @@ -584,12 +553,12 @@ }, { "inputs": [], - "name": "accountingGovernor", + "name": "activeDepositedValidators", "outputs": [ { - "internalType": "address", + "internalType": "uint256", "name": "", - "type": "address" + "type": "uint256" } ], "stateMutability": "view", @@ -870,33 +839,18 @@ { "inputs": [ { - "internalType": "uint256", - "name": "_activeDepositedValidators", - "type": "uint256" + "internalType": "int256", + "name": "_validatorsDelta", + "type": "int256" }, { - "internalType": "uint256", - "name": "_ethToWeth", - "type": "uint256" + "internalType": "int256", + "name": "_consensusRewardsDelta", + "type": "int256" }, { "internalType": "uint256", - "name": "_wethToBeSentToVault", - "type": "uint256" - }, - { - "internalType": "uint256", - "name": "_consensusRewards", - "type": "uint256" - }, - { - "internalType": "uint256", - "name": "_ethThresholdCheck", - "type": "uint256" - }, - { - "internalType": "uint256", - "name": "_wethThresholdCheck", + "name": "_wethToVaultAmount", "type": "uint256" } ], @@ -1087,19 +1041,6 @@ "stateMutability": "nonpayable", "type": "function" }, - { - "inputs": [ - { - "internalType": "address", - "name": "_address", - "type": "address" - } - ], - "name": "setAccountingGovernor", - "outputs": [], - "stateMutability": "nonpayable", - "type": "function" - }, { "inputs": [ { @@ -1335,34 +1276,34 @@ "type": "receive" } ], - "transactionHash": "0x32a95bad479c439018f11c6c93e19fc7fd7edc0fdbcdc15009a32231d7967c5c", + "transactionHash": "0x0ba7a44fb241a4af2dfdb828df227fd90a75d6b2523a59944c2a37aeeaced32b", "receipt": { "to": null, "from": "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C", - "contractAddress": "0x4aEAcdb5D84eDf02Dd85f3DFC1645b89D7579d62", - "transactionIndex": 26, - "gasUsed": "4123386", - "logsBloom": "0x00000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000000000000200000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", - "blockHash": "0x7accf851e0f53d2da70bb20741170ae10a24b9724ad337e6e7ec6f032a75da32", - "transactionHash": "0x32a95bad479c439018f11c6c93e19fc7fd7edc0fdbcdc15009a32231d7967c5c", + "contractAddress": "0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793", + "transactionIndex": 29, + "gasUsed": "4109268", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000400000000000000000000000000200000000000000000000030000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x10e4dbee882616c76e9bb546647da836d38c3a12883d278855e68d42b0a5876b", + "transactionHash": "0x0ba7a44fb241a4af2dfdb828df227fd90a75d6b2523a59944c2a37aeeaced32b", "logs": [ { - "transactionIndex": 26, - "blockNumber": 1429889, - "transactionHash": "0x32a95bad479c439018f11c6c93e19fc7fd7edc0fdbcdc15009a32231d7967c5c", - "address": "0x4aEAcdb5D84eDf02Dd85f3DFC1645b89D7579d62", + "transactionIndex": 29, + "blockNumber": 1471277, + "transactionHash": "0x0ba7a44fb241a4af2dfdb828df227fd90a75d6b2523a59944c2a37aeeaced32b", + "address": "0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793", "topics": [ "0xc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000001b94ca50d3ad9f8368851f8526132272d1a5028c" ], "data": "0x", - "logIndex": 38, - "blockHash": "0x7accf851e0f53d2da70bb20741170ae10a24b9724ad337e6e7ec6f032a75da32" + "logIndex": 436, + "blockHash": "0x10e4dbee882616c76e9bb546647da836d38c3a12883d278855e68d42b0a5876b" } ], - "blockNumber": 1429889, - "cumulativeGasUsed": "6291081", + "blockNumber": 1471277, + "cumulativeGasUsed": "22895699", "status": 1, "byzantium": true }, @@ -1377,11 +1318,11 @@ "0x590B781b511e953dbFC49e7E7864A6E787aFBDCc", "0x4242424242424242424242424242424242424242" ], - "numDeployments": 2, - "solcInputHash": "46be8b80ad6bb26f70e58a31071e073e", - "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"platformAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"vaultAddress\",\"type\":\"address\"}],\"internalType\":\"struct InitializableAbstractStrategy.BaseStrategyConfig\",\"name\":\"_baseConfig\",\"type\":\"tuple\"},{\"internalType\":\"address\",\"name\":\"_wethAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_ssvToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_ssvNetwork\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_feeAccumulator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_beaconChainDepositContract\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"AccountingConsensusRewards\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"noOfValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"remainingValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingFullyWithdrawnValidator\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAddress\",\"type\":\"address\"}],\"name\":\"AccountingGovernorChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldActiveDepositedValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"activeDepositedValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"oldBeaconChainRewards\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"beaconChainRewards\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"ethToWeth\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethToBeSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingManuallyFixed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"remainingValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingValidatorSlashed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"withdrawal_credentials\",\"type\":\"bytes\"}],\"name\":\"ETHStaked\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"start\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"end\",\"type\":\"uint256\"}],\"name\":\"FuseIntervalUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_oldHarvesterAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_newHarvesterAddress\",\"type\":\"address\"}],\"name\":\"HarvesterAddressesUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"PTokenAdded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"PTokenRemoved\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAddress\",\"type\":\"address\"}],\"name\":\"RegistratorChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"_oldAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"_newAddresses\",\"type\":\"address[]\"}],\"name\":\"RewardTokenAddressesUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"rewardToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"RewardTokenCollected\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorExitCompleted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorExitInitiated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorRegistered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Withdrawal\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"BEACON_CHAIN_DEPOSIT_CONTRACT\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"FEE_ACCUMULATOR_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_STAKE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SSV_NETWORK_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SSV_TOKEN_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"VAULT_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"WETH_TOKEN_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"accountingGovernor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"assetToPToken\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"}],\"name\":\"checkBalance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"collectRewardTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"consensusRewards\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositAll\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"depositSSV\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"doAccounting\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"accountingValid\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"exitSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fuseIntervalEnd\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fuseIntervalStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getRewardTokenAddresses\",\"outputs\":[{\"internalType\":\"address[]\",\"name\":\"\",\"type\":\"address[]\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"harvesterAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address[]\",\"name\":\"_rewardTokenAddresses\",\"type\":\"address[]\"},{\"internalType\":\"address[]\",\"name\":\"_assets\",\"type\":\"address[]\"},{\"internalType\":\"address[]\",\"name\":\"_pTokens\",\"type\":\"address[]\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_activeDepositedValidators\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_ethToWeth\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_wethToBeSentToVault\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_consensusRewards\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_ethThresholdCheck\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_wethThresholdCheck\",\"type\":\"uint256\"}],\"name\":\"manuallyFixAccounting\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"platformAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"internalType\":\"bytes\",\"name\":\"sharesData\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"registerSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_assetIndex\",\"type\":\"uint256\"}],\"name\":\"removePToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"removeSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rewardTokenAddresses\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"safeApproveAllTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"setAccountingGovernor\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_fuseIntervalStart\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_fuseIntervalEnd\",\"type\":\"uint256\"}],\"name\":\"setFuseInterval\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_harvesterAddress\",\"type\":\"address\"}],\"name\":\"setHarvesterAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"setPTokenAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"setRegistrator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address[]\",\"name\":\"_rewardTokenAddresses\",\"type\":\"address[]\"}],\"name\":\"setRewardTokenAddresses\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"signature\",\"type\":\"bytes\"},{\"internalType\":\"bytes32\",\"name\":\"depositDataRoot\",\"type\":\"bytes32\"}],\"internalType\":\"struct ValidatorStakeData[]\",\"name\":\"validators\",\"type\":\"tuple[]\"}],\"name\":\"stakeEth\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"}],\"name\":\"supportsAsset\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"transferToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"validatorRegistrator\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"validatorsStates\",\"outputs\":[{\"internalType\":\"enum ValidatorRegistrator.VALIDATOR_STATE\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"vaultAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"withdraw\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawAll\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"author\":\"Origin Protocol Inc\",\"kind\":\"dev\",\"methods\":{\"checkBalance(address)\":{\"params\":{\"_asset\":\"Address of weth asset\"},\"returns\":{\"balance\":\" Total value of (W)ETH\"}},\"constructor\":{\"params\":{\"_baseConfig\":\"Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI, and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\",\"_beaconChainDepositContract\":\"Address of the beacon chain deposit contract\",\"_feeAccumulator\":\"Address of the fee accumulator receiving execution layer validator rewards\",\"_ssvNetwork\":\"Address of the SSV Network contract\",\"_ssvToken\":\"Address of the Erc20 SSV Token contract\",\"_wethAddress\":\"Address of the Erc20 WETH Token contract\"}},\"deposit(address,uint256)\":{\"params\":{\"_amount\":\"Amount of assets that were transferred to the strategy by the vault.\",\"_asset\":\"Address of asset to deposit. Has to be WETH.\"}},\"depositSSV(uint64[],uint256,(uint32,uint64,uint64,bool,uint256))\":{\"details\":\"A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds. uses \\\"onlyStrategist\\\" modifier so continuous front-running can't DOS our maintenance service that tries to top up SSV tokens.\",\"params\":{\"cluster\":\"The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\"}},\"doAccounting()\":{\"details\":\"This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it for now.\"},\"getRewardTokenAddresses()\":{\"returns\":{\"_0\":\"address[] the reward token addresses.\"}},\"initialize(address[],address[],address[])\":{\"params\":{\"_assets\":\"Addresses of initial supported assets\",\"_pTokens\":\"Platform Token corresponding addresses\",\"_rewardTokenAddresses\":\"Address of reward token for platform\"}},\"manuallyFixAccounting(uint256,uint256,uint256,uint256,uint256,uint256)\":{\"details\":\"allow the accounting governor to fix the accounting of this strategy and unpause\",\"params\":{\"_activeDepositedValidators\":\"the override value of activeDepositedValidators\",\"_consensusRewards\":\"the override value for consensusRewards\",\"_ethThresholdCheck\":\"maximum allowed ETH balance on the contract for the function to run\",\"_ethToWeth\":\"the amount of ETH to be converted to WETH\",\"_wethThresholdCheck\":\"maximum allowed WETH balance on the contract for the function to run the above 2 checks are done so transaction doesn't get front run and cause unexpected behaviour\",\"_wethToBeSentToVault\":\"the amount of WETH to be sent to the Vault\"}},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"removePToken(uint256)\":{\"params\":{\"_assetIndex\":\"Index of the asset to be removed\"}},\"setHarvesterAddress(address)\":{\"params\":{\"_harvesterAddress\":\"Address of the harvester contract.\"}},\"setPTokenAddress(address,address)\":{\"params\":{\"_asset\":\"Address for the asset\",\"_pToken\":\"Address for the corresponding platform token\"}},\"setRewardTokenAddresses(address[])\":{\"params\":{\"_rewardTokenAddresses\":\"Array of reward token addresses\"}},\"stakeEth((bytes,bytes,bytes32)[])\":{\"params\":{\"validators\":\"A list of validator data needed to stake. The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot. Only the registrator can call this function.\"}},\"supportsAsset(address)\":{\"params\":{\"_asset\":\"The address of the asset token.\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"transferToken(address,uint256)\":{\"params\":{\"_amount\":\"Amount of the asset to transfer\",\"_asset\":\"Address for the asset\"}},\"withdraw(address,address,uint256)\":{\"params\":{\"_amount\":\"Amount of WETH to withdraw\",\"_asset\":\"WETH to withdraw\",\"_recipient\":\"Address to receive withdrawn assets\"}}},\"stateVariables\":{\"FEE_ACCUMULATOR_ADDRESS\":{\"details\":\"this address will receive Execution layer rewards - These are rewards earned for executing transactions on the Ethereum network as part of block proposals. They include priority fees (fees paid by users for their transactions to be included) and MEV rewards (rewards for arranging transactions in a way that benefits the validator).\"}},\"title\":\"Native Staking SSV Strategy\",\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"BEACON_CHAIN_DEPOSIT_CONTRACT()\":{\"notice\":\"The address of the beacon chain deposit contract\"},\"FEE_ACCUMULATOR_ADDRESS()\":{\"notice\":\"Fee collector address\"},\"MAX_STAKE()\":{\"notice\":\"The maximum amount of ETH that can be staked by a validator\"},\"SSV_NETWORK_ADDRESS()\":{\"notice\":\"The address of the SSV Network contract used to interface with\"},\"SSV_TOKEN_ADDRESS()\":{\"notice\":\"SSV ERC20 token that serves as a payment for operating SSV validators\"},\"VAULT_ADDRESS()\":{\"notice\":\"Address of the OETH Vault proxy contract\"},\"WETH_TOKEN_ADDRESS()\":{\"notice\":\"The address of the Wrapped ETH (WETH) token contract\"},\"accountingGovernor()\":{\"notice\":\"Governor that can manually correct the accounting\"},\"assetToPToken(address)\":{\"notice\":\"asset => pToken (Platform Specific Token Address)\"},\"checkBalance(address)\":{\"notice\":\"Returns the total value of (W)ETH that is staked to the validators and WETH deposits that are still to be staked. This does not include ETH from consensus rewards sitting in this strategy or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested and sent to the Dripper so will eventually be sent to the Vault as WETH.\"},\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"collectRewardTokens()\":{\"notice\":\"Collect accumulated reward token and send to Vault.\"},\"consensusRewards()\":{\"notice\":\"Keeps track of the total consensus rewards swept from the beacon chain\"},\"deposit(address,uint256)\":{\"notice\":\"Unlike other strategies, this does not deposit assets into the underlying platform. It just checks the asset is WETH and emits the Deposit event. To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used. Will NOT revert if the strategy is paused from an accounting failure.\"},\"depositAll()\":{\"notice\":\"Unlike other strategies, this does not deposit assets into the underlying platform. It just emits the Deposit event. To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used. Will NOT revert if the strategy is paused from an accounting failure.\"},\"depositSSV(uint64[],uint256,(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\"},\"doAccounting()\":{\"notice\":\"This notion page offers a good explanation of how the accounting functions https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart, the accounting function will treat that ETH as Beacon chain consensus rewards. On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32, the accounting function will treat that as a validator slashing.Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when accounting is valid and fuse isn't \\\"blown\\\". Returns false when fuse is blown.\"},\"exitSsvValidator(bytes,uint64[])\":{\"notice\":\"Exit a validator from the Beacon chain. The staked ETH will eventually swept to this native staking strategy. Only the registrator can call this function.\"},\"fuseIntervalEnd()\":{\"notice\":\"end of fuse interval\"},\"fuseIntervalStart()\":{\"notice\":\"start of fuse interval\"},\"getRewardTokenAddresses()\":{\"notice\":\"Get the reward token addresses.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"harvesterAddress()\":{\"notice\":\"Address of the Harvester contract allowed to collect reward tokens\"},\"initialize(address[],address[],address[])\":{\"notice\":\"initialize function, to set up initial internal state\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"platformAddress()\":{\"notice\":\"Address of the underlying platform\"},\"registerSsvValidator(bytes,uint64[],bytes,uint256,(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Registers a new validator in the SSV Cluster. Only the registrator can call this function.\"},\"removePToken(uint256)\":{\"notice\":\"Remove a supported asset by passing its index. This method can only be called by the system Governor\"},\"removeSsvValidator(bytes,uint64[],(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Remove a validator from the SSV Cluster. Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain. If removed before the validator has exited the beacon chain will result in the validator being slashed. Only the registrator can call this function.\"},\"rewardTokenAddresses(uint256)\":{\"notice\":\"Address of the reward tokens. eg CRV, BAL, CVX, AURA\"},\"safeApproveAllTokens()\":{\"notice\":\"Approves the SSV Network contract to transfer SSV tokens for deposits\"},\"setFuseInterval(uint256,uint256)\":{\"notice\":\"set fuse interval values\"},\"setHarvesterAddress(address)\":{\"notice\":\"Set the Harvester contract that can collect rewards.\"},\"setPTokenAddress(address,address)\":{\"notice\":\"Provide support for asset by passing its pToken address. This method can only be called by the system Governor\"},\"setRegistrator(address)\":{\"notice\":\"Set the address of the registrator which can register, exit and remove validators\"},\"setRewardTokenAddresses(address[])\":{\"notice\":\"Set the reward token addresses. Any old addresses will be overwritten.\"},\"stakeEth((bytes,bytes,bytes32)[])\":{\"notice\":\"Stakes WETH to the node validators\"},\"supportsAsset(address)\":{\"notice\":\"Returns bool indicating whether asset is supported by strategy.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"},\"transferToken(address,uint256)\":{\"notice\":\"Transfer token to governor. Intended for recovering tokens stuck in strategy contracts, i.e. mistaken sends.\"},\"validatorRegistrator()\":{\"notice\":\"Address of the registrator - allowed to register, exit and remove validators\"},\"validatorsStates(bytes32)\":{\"notice\":\"State of the validators keccak256(pubKey) => state\"},\"vaultAddress()\":{\"notice\":\"Address of the OToken vault\"},\"withdraw(address,address,uint256)\":{\"notice\":\"Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That can happen when: - the deposit was not a multiple of 32 WETH - someone sent WETH directly to this contract Will NOT revert if the strategy is paused from an accounting failure.\"},\"withdrawAll()\":{\"notice\":\"transfer all WETH deposits back to the vault. This does not withdraw from the validators. That has to be done separately with the `exitSsvValidator` and `removeSsvValidator` operations. This does not withdraw any execution rewards from the FeeAccumulator or consensus rewards in this strategy. Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn. ETH from full validator withdrawals is sent to the Vault using `doAccounting`. Will NOT revert if the strategy is paused from an accounting failure.\"}},\"notice\":\"Strategy to deploy funds into DVT validators powered by the SSV Network\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol\":\"NativeStakingSSVStrategy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n require(!paused(), \\\"Pausable: paused\\\");\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n require(paused(), \\\"Pausable: not paused\\\");\\n _;\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0xe68ed7fb8766ed1e888291f881e36b616037f852b37d96877045319ad298ba87\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `recipient`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address recipient, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `sender` to `recipient` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(\\n address sender,\\n address recipient,\\n uint256 amount\\n ) external returns (bool);\\n\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n}\\n\",\"keccak256\":\"0x61437cb513a887a1bbad006e7b1c8b414478427d33de47c5600af3c748f108da\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n function safeTransfer(\\n IERC20 token,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n function safeTransferFrom(\\n IERC20 token,\\n address from,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n function safeIncreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n uint256 newAllowance = token.allowance(address(this), spender) + value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n\\n function safeDecreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n uint256 newAllowance = oldAllowance - value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n if (returndata.length > 0) {\\n // Return data is optional\\n require(abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc3d946432c0ddbb1f846a0d3985be71299df331b91d06732152117f62f0be2b5\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)\\n\\npragma solidity ^0.8.0;\\n\\n// CAUTION\\n// This version of SafeMath should only be used with Solidity 0.8 or later,\\n// because it relies on the compiler's built in overflow checks.\\n\\n/**\\n * @dev Wrappers over Solidity's arithmetic operations.\\n *\\n * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler\\n * now has built in overflow checking.\\n */\\nlibrary SafeMath {\\n /**\\n * @dev Returns the addition of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n uint256 c = a + b;\\n if (c < a) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the substraction of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b > a) return (false, 0);\\n return (true, a - b);\\n }\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n // benefit is lost if 'b' is also tested.\\n // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n if (a == 0) return (true, 0);\\n uint256 c = a * b;\\n if (c / a != b) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the division of two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a / b);\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a % b);\\n }\\n }\\n\\n /**\\n * @dev Returns the addition of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `+` operator.\\n *\\n * Requirements:\\n *\\n * - Addition cannot overflow.\\n */\\n function add(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting on\\n * overflow (when the result is negative).\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `*` operator.\\n *\\n * Requirements:\\n *\\n * - Multiplication cannot overflow.\\n */\\n function mul(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator.\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting when dividing by zero.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a % b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\\n * overflow (when the result is negative).\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {trySub}.\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b <= a, errorMessage);\\n return a - b;\\n }\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting with custom message on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator. Note: this function uses a\\n * `revert` opcode (which leaves remaining gas untouched) while Solidity\\n * uses an invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a / b;\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting with custom message when dividing by zero.\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {tryMod}.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a % b;\\n }\\n }\\n}\\n\",\"keccak256\":\"0xa2f576be637946f767aa56601c26d717f48a0aff44f82e46f13807eea1009a21\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/interfaces/IBasicToken.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IBasicToken {\\n function symbol() external view returns (string memory);\\n\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0xa562062698aa12572123b36dfd2072f1a39e44fed2031cc19c2c9fd522f96ec2\",\"license\":\"MIT\"},\"contracts/interfaces/IDepositContract.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IDepositContract {\\n /// @notice A processed deposit event.\\n event DepositEvent(\\n bytes pubkey,\\n bytes withdrawal_credentials,\\n bytes amount,\\n bytes signature,\\n bytes index\\n );\\n\\n /// @notice Submit a Phase 0 DepositData object.\\n /// @param pubkey A BLS12-381 public key.\\n /// @param withdrawal_credentials Commitment to a public key for withdrawals.\\n /// @param signature A BLS12-381 signature.\\n /// @param deposit_data_root The SHA-256 hash of the SSZ-encoded DepositData object.\\n /// Used as a protection against malformed input.\\n function deposit(\\n bytes calldata pubkey,\\n bytes calldata withdrawal_credentials,\\n bytes calldata signature,\\n bytes32 deposit_data_root\\n ) external payable;\\n\\n /// @notice Query the current deposit root hash.\\n /// @return The deposit root hash.\\n function get_deposit_root() external view returns (bytes32);\\n\\n /// @notice Query the current deposit count.\\n /// @return The deposit count encoded as a little endian 64-bit number.\\n function get_deposit_count() external view returns (bytes memory);\\n}\\n\",\"keccak256\":\"0x598f90bdbc854250bbd5991426bfb43367207e64e33109c41aa8b54323fd8d8e\",\"license\":\"MIT\"},\"contracts/interfaces/ISSVNetwork.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nstruct Cluster {\\n uint32 validatorCount;\\n uint64 networkFeeIndex;\\n uint64 index;\\n bool active;\\n uint256 balance;\\n}\\n\\ninterface ISSVNetwork {\\n error ApprovalNotWithinTimeframe();\\n error CallerNotOwner();\\n error CallerNotWhitelisted();\\n error ClusterAlreadyEnabled();\\n error ClusterDoesNotExists();\\n error ClusterIsLiquidated();\\n error ClusterNotLiquidatable();\\n error ExceedValidatorLimit();\\n error FeeExceedsIncreaseLimit();\\n error FeeIncreaseNotAllowed();\\n error FeeTooHigh();\\n error FeeTooLow();\\n error IncorrectClusterState();\\n error IncorrectValidatorState();\\n error InsufficientBalance();\\n error InvalidOperatorIdsLength();\\n error InvalidPublicKeyLength();\\n error MaxValueExceeded();\\n error NewBlockPeriodIsBelowMinimum();\\n error NoFeeDeclared();\\n error NotAuthorized();\\n error OperatorAlreadyExists();\\n error OperatorDoesNotExist();\\n error OperatorsListNotUnique();\\n error SameFeeChangeNotAllowed();\\n error TargetModuleDoesNotExist();\\n error TokenTransferFailed();\\n error UnsortedOperatorsList();\\n error ValidatorAlreadyExists();\\n error ValidatorDoesNotExist();\\n\\n event AdminChanged(address previousAdmin, address newAdmin);\\n event BeaconUpgraded(address indexed beacon);\\n event ClusterDeposited(\\n address indexed owner,\\n uint64[] operatorIds,\\n uint256 value,\\n Cluster cluster\\n );\\n event ClusterLiquidated(\\n address indexed owner,\\n uint64[] operatorIds,\\n Cluster cluster\\n );\\n event ClusterReactivated(\\n address indexed owner,\\n uint64[] operatorIds,\\n Cluster cluster\\n );\\n event ClusterWithdrawn(\\n address indexed owner,\\n uint64[] operatorIds,\\n uint256 value,\\n Cluster cluster\\n );\\n event DeclareOperatorFeePeriodUpdated(uint64 value);\\n event ExecuteOperatorFeePeriodUpdated(uint64 value);\\n event FeeRecipientAddressUpdated(\\n address indexed owner,\\n address recipientAddress\\n );\\n event Initialized(uint8 version);\\n event LiquidationThresholdPeriodUpdated(uint64 value);\\n event MinimumLiquidationCollateralUpdated(uint256 value);\\n event NetworkEarningsWithdrawn(uint256 value, address recipient);\\n event NetworkFeeUpdated(uint256 oldFee, uint256 newFee);\\n event OperatorAdded(\\n uint64 indexed operatorId,\\n address indexed owner,\\n bytes publicKey,\\n uint256 fee\\n );\\n event OperatorFeeDeclarationCancelled(\\n address indexed owner,\\n uint64 indexed operatorId\\n );\\n event OperatorFeeDeclared(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 blockNumber,\\n uint256 fee\\n );\\n event OperatorFeeExecuted(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 blockNumber,\\n uint256 fee\\n );\\n event OperatorFeeIncreaseLimitUpdated(uint64 value);\\n event OperatorMaximumFeeUpdated(uint64 maxFee);\\n event OperatorRemoved(uint64 indexed operatorId);\\n event OperatorWhitelistUpdated(\\n uint64 indexed operatorId,\\n address whitelisted\\n );\\n event OperatorWithdrawn(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 value\\n );\\n event OwnershipTransferStarted(\\n address indexed previousOwner,\\n address indexed newOwner\\n );\\n event OwnershipTransferred(\\n address indexed previousOwner,\\n address indexed newOwner\\n );\\n event Upgraded(address indexed implementation);\\n event ValidatorAdded(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey,\\n bytes shares,\\n Cluster cluster\\n );\\n event ValidatorExited(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey\\n );\\n event ValidatorRemoved(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey,\\n Cluster cluster\\n );\\n\\n fallback() external;\\n\\n function acceptOwnership() external;\\n\\n function cancelDeclaredOperatorFee(uint64 operatorId) external;\\n\\n function declareOperatorFee(uint64 operatorId, uint256 fee) external;\\n\\n function deposit(\\n address clusterOwner,\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function executeOperatorFee(uint64 operatorId) external;\\n\\n function exitValidator(bytes memory publicKey, uint64[] memory operatorIds)\\n external;\\n\\n function getVersion() external pure returns (string memory version);\\n\\n function initialize(\\n address token_,\\n address ssvOperators_,\\n address ssvClusters_,\\n address ssvDAO_,\\n address ssvViews_,\\n uint64 minimumBlocksBeforeLiquidation_,\\n uint256 minimumLiquidationCollateral_,\\n uint32 validatorsPerOperatorLimit_,\\n uint64 declareOperatorFeePeriod_,\\n uint64 executeOperatorFeePeriod_,\\n uint64 operatorMaxFeeIncrease_\\n ) external;\\n\\n function liquidate(\\n address clusterOwner,\\n uint64[] memory operatorIds,\\n Cluster memory cluster\\n ) external;\\n\\n function owner() external view returns (address);\\n\\n function pendingOwner() external view returns (address);\\n\\n function proxiableUUID() external view returns (bytes32);\\n\\n function reactivate(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function reduceOperatorFee(uint64 operatorId, uint256 fee) external;\\n\\n function registerOperator(bytes memory publicKey, uint256 fee)\\n external\\n returns (uint64 id);\\n\\n function registerValidator(\\n bytes memory publicKey,\\n uint64[] memory operatorIds,\\n bytes memory sharesData,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function removeOperator(uint64 operatorId) external;\\n\\n function removeValidator(\\n bytes memory publicKey,\\n uint64[] memory operatorIds,\\n Cluster memory cluster\\n ) external;\\n\\n function renounceOwnership() external;\\n\\n function setFeeRecipientAddress(address recipientAddress) external;\\n\\n function setOperatorWhitelist(uint64 operatorId, address whitelisted)\\n external;\\n\\n function transferOwnership(address newOwner) external;\\n\\n function updateDeclareOperatorFeePeriod(uint64 timeInSeconds) external;\\n\\n function updateExecuteOperatorFeePeriod(uint64 timeInSeconds) external;\\n\\n function updateLiquidationThresholdPeriod(uint64 blocks) external;\\n\\n function updateMaximumOperatorFee(uint64 maxFee) external;\\n\\n function updateMinimumLiquidationCollateral(uint256 amount) external;\\n\\n function updateModule(uint8 moduleId, address moduleAddress) external;\\n\\n function updateNetworkFee(uint256 fee) external;\\n\\n function updateOperatorFeeIncreaseLimit(uint64 percentage) external;\\n\\n function upgradeTo(address newImplementation) external;\\n\\n function upgradeToAndCall(address newImplementation, bytes memory data)\\n external\\n payable;\\n\\n function withdraw(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function withdrawAllOperatorEarnings(uint64 operatorId) external;\\n\\n function withdrawNetworkEarnings(uint256 amount) external;\\n\\n function withdrawOperatorEarnings(uint64 operatorId, uint256 amount)\\n external;\\n}\\n\",\"keccak256\":\"0x76e2c5148727b72752939b06fee7abc1f732c18970b8c7db7fe7cdfe74629d36\",\"license\":\"MIT\"},\"contracts/interfaces/IStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Platform interface to integrate with lending platform like Compound, AAVE etc.\\n */\\ninterface IStrategy {\\n /**\\n * @dev Deposit the given asset to platform\\n * @param _asset asset address\\n * @param _amount Amount to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external;\\n\\n /**\\n * @dev Deposit the entire balance of all supported assets in the Strategy\\n * to the platform\\n */\\n function depositAll() external;\\n\\n /**\\n * @dev Withdraw given asset from Lending platform\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external;\\n\\n /**\\n * @dev Liquidate all assets in strategy and return them to Vault.\\n */\\n function withdrawAll() external;\\n\\n /**\\n * @dev Returns the current balance of the given asset.\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n returns (uint256 balance);\\n\\n /**\\n * @dev Returns bool indicating whether strategy supports asset.\\n */\\n function supportsAsset(address _asset) external view returns (bool);\\n\\n /**\\n * @dev Collect reward tokens from the Strategy.\\n */\\n function collectRewardTokens() external;\\n\\n /**\\n * @dev The address array of the reward tokens for the Strategy.\\n */\\n function getRewardTokenAddresses() external view returns (address[] memory);\\n}\\n\",\"keccak256\":\"0xb291e409a9b95527f9ed19cd6bff8eeb9921a21c1f5194a48c0bb9ce6613959a\",\"license\":\"MIT\"},\"contracts/interfaces/IVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { VaultStorage } from \\\"../vault/VaultStorage.sol\\\";\\n\\ninterface IVault {\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Governable.sol\\n function transferGovernance(address _newGovernor) external;\\n\\n function claimGovernance() external;\\n\\n function governor() external view returns (address);\\n\\n // VaultAdmin.sol\\n function setPriceProvider(address _priceProvider) external;\\n\\n function priceProvider() external view returns (address);\\n\\n function setRedeemFeeBps(uint256 _redeemFeeBps) external;\\n\\n function redeemFeeBps() external view returns (uint256);\\n\\n function setVaultBuffer(uint256 _vaultBuffer) external;\\n\\n function vaultBuffer() external view returns (uint256);\\n\\n function setAutoAllocateThreshold(uint256 _threshold) external;\\n\\n function autoAllocateThreshold() external view returns (uint256);\\n\\n function setRebaseThreshold(uint256 _threshold) external;\\n\\n function rebaseThreshold() external view returns (uint256);\\n\\n function setStrategistAddr(address _address) external;\\n\\n function strategistAddr() external view returns (address);\\n\\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external;\\n\\n function maxSupplyDiff() external view returns (uint256);\\n\\n function setTrusteeAddress(address _address) external;\\n\\n function trusteeAddress() external view returns (address);\\n\\n function setTrusteeFeeBps(uint256 _basis) external;\\n\\n function trusteeFeeBps() external view returns (uint256);\\n\\n function ousdMetaStrategy() external view returns (address);\\n\\n function setSwapper(address _swapperAddr) external;\\n\\n function setSwapAllowedUndervalue(uint16 _percentageBps) external;\\n\\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\\n external;\\n\\n function supportAsset(address _asset, uint8 _supportsAsset) external;\\n\\n function approveStrategy(address _addr) external;\\n\\n function removeStrategy(address _addr) external;\\n\\n function setAssetDefaultStrategy(address _asset, address _strategy)\\n external;\\n\\n function assetDefaultStrategies(address _asset)\\n external\\n view\\n returns (address);\\n\\n function pauseRebase() external;\\n\\n function unpauseRebase() external;\\n\\n function rebasePaused() external view returns (bool);\\n\\n function pauseCapital() external;\\n\\n function unpauseCapital() external;\\n\\n function capitalPaused() external view returns (bool);\\n\\n function transferToken(address _asset, uint256 _amount) external;\\n\\n function priceUnitMint(address asset) external view returns (uint256);\\n\\n function priceUnitRedeem(address asset) external view returns (uint256);\\n\\n function withdrawAllFromStrategy(address _strategyAddr) external;\\n\\n function withdrawAllFromStrategies() external;\\n\\n function withdrawFromStrategy(\\n address _strategyFromAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n function depositToStrategy(\\n address _strategyToAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n // VaultCore.sol\\n function mint(\\n address _asset,\\n uint256 _amount,\\n uint256 _minimumOusdAmount\\n ) external;\\n\\n function mintForStrategy(uint256 _amount) external;\\n\\n function redeem(uint256 _amount, uint256 _minimumUnitAmount) external;\\n\\n function burnForStrategy(uint256 _amount) external;\\n\\n function redeemAll(uint256 _minimumUnitAmount) external;\\n\\n function allocate() external;\\n\\n function rebase() external;\\n\\n function swapCollateral(\\n address fromAsset,\\n address toAsset,\\n uint256 fromAssetAmount,\\n uint256 minToAssetAmount,\\n bytes calldata data\\n ) external returns (uint256 toAssetAmount);\\n\\n function totalValue() external view returns (uint256 value);\\n\\n function checkBalance(address _asset) external view returns (uint256);\\n\\n function calculateRedeemOutputs(uint256 _amount)\\n external\\n view\\n returns (uint256[] memory);\\n\\n function getAssetCount() external view returns (uint256);\\n\\n function getAssetConfig(address _asset)\\n external\\n view\\n returns (VaultStorage.Asset memory config);\\n\\n function getAllAssets() external view returns (address[] memory);\\n\\n function getStrategyCount() external view returns (uint256);\\n\\n function swapper() external view returns (address);\\n\\n function allowedSwapUndervalue() external view returns (uint256);\\n\\n function getAllStrategies() external view returns (address[] memory);\\n\\n function isSupportedAsset(address _asset) external view returns (bool);\\n\\n function netOusdMintForStrategyThreshold() external view returns (uint256);\\n\\n function setOusdMetaStrategy(address _ousdMetaStrategy) external;\\n\\n function setNetOusdMintForStrategyThreshold(uint256 _threshold) external;\\n\\n function netOusdMintedForStrategy() external view returns (int256);\\n\\n function weth() external view returns (address);\\n\\n function cacheWETHAssetIndex() external;\\n\\n function wethAssetIndex() external view returns (uint256);\\n\\n function initialize(address, address) external;\\n\\n function setAdminImpl(address) external;\\n}\\n\",\"keccak256\":\"0xe8ab2f09127dc86bda14d2ad7f58d4f5ef214959101742f0dd977be3599f9d5f\",\"license\":\"MIT\"},\"contracts/interfaces/IWETH9.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IWETH9 {\\n event Approval(address indexed src, address indexed guy, uint256 wad);\\n event Deposit(address indexed dst, uint256 wad);\\n event Transfer(address indexed src, address indexed dst, uint256 wad);\\n event Withdrawal(address indexed src, uint256 wad);\\n\\n function allowance(address, address) external view returns (uint256);\\n\\n function approve(address guy, uint256 wad) external returns (bool);\\n\\n function balanceOf(address) external view returns (uint256);\\n\\n function decimals() external view returns (uint8);\\n\\n function deposit() external payable;\\n\\n function name() external view returns (string memory);\\n\\n function symbol() external view returns (string memory);\\n\\n function totalSupply() external view returns (uint256);\\n\\n function transfer(address dst, uint256 wad) external returns (bool);\\n\\n function transferFrom(\\n address src,\\n address dst,\\n uint256 wad\\n ) external returns (bool);\\n\\n function withdraw(uint256 wad) external;\\n}\\n\",\"keccak256\":\"0x05b7dce6c24d3cd4e48b5c6346d86e5e40ecc3291bcdf3f3ef091c98fc826519\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/FeeAccumulator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\n\\n/**\\n * @title Fee Accumulator for Native Staking SSV Strategy\\n * @notice Receives execution rewards which includes tx fees and\\n * MEV rewards like tx priority and tx ordering.\\n * It does NOT include swept ETH from beacon chain consensus rewards or full validator withdrawals.\\n * @author Origin Protocol Inc\\n */\\ncontract FeeAccumulator is Governable {\\n /// @notice The address of the Native Staking Strategy\\n address public immutable STRATEGY;\\n\\n /**\\n * @param _strategy Address of the Native Staking Strategy\\n */\\n constructor(address _strategy) {\\n STRATEGY = _strategy;\\n }\\n\\n /**\\n * @notice sends all ETH in this FeeAccumulator contract to the Native Staking Strategy.\\n * @return eth The amount of execution rewards that were sent to the Native Staking Strategy\\n */\\n function collect() external returns (uint256 eth) {\\n require(msg.sender == STRATEGY, \\\"Caller is not the Strategy\\\");\\n\\n eth = address(this).balance;\\n if (eth > 0) {\\n // Send the ETH to the Native Staking Strategy\\n Address.sendValue(payable(STRATEGY), eth);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xf47bcc46ce70f649f061bec3d2303f376a15700ba18fe471fba823f60bdfed8b\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { InitializableAbstractStrategy } from \\\"../../utils/InitializableAbstractStrategy.sol\\\";\\nimport { ISSVNetwork, Cluster } from \\\"../../interfaces/ISSVNetwork.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\nimport { FeeAccumulator } from \\\"./FeeAccumulator.sol\\\";\\nimport { ValidatorAccountant } from \\\"./ValidatorAccountant.sol\\\";\\nimport { Cluster } from \\\"../../interfaces/ISSVNetwork.sol\\\";\\n\\nstruct ValidatorStakeData {\\n bytes pubkey;\\n bytes signature;\\n bytes32 depositDataRoot;\\n}\\n\\n/// @title Native Staking SSV Strategy\\n/// @notice Strategy to deploy funds into DVT validators powered by the SSV Network\\n/// @author Origin Protocol Inc\\ncontract NativeStakingSSVStrategy is\\n ValidatorAccountant,\\n InitializableAbstractStrategy\\n{\\n using SafeERC20 for IERC20;\\n\\n /// @notice SSV ERC20 token that serves as a payment for operating SSV validators\\n address public immutable SSV_TOKEN_ADDRESS;\\n /// @notice Fee collector address\\n /// @dev this address will receive Execution layer rewards - These are rewards earned for\\n /// executing transactions on the Ethereum network as part of block proposals. They include\\n /// priority fees (fees paid by users for their transactions to be included) and MEV rewards\\n /// (rewards for arranging transactions in a way that benefits the validator).\\n address public immutable FEE_ACCUMULATOR_ADDRESS;\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /// @param _baseConfig Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI,\\n /// and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _ssvToken Address of the Erc20 SSV Token contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n /// @param _feeAccumulator Address of the fee accumulator receiving execution layer validator rewards\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n constructor(\\n BaseStrategyConfig memory _baseConfig,\\n address _wethAddress,\\n address _ssvToken,\\n address _ssvNetwork,\\n address _feeAccumulator,\\n address _beaconChainDepositContract\\n )\\n InitializableAbstractStrategy(_baseConfig)\\n ValidatorAccountant(\\n _wethAddress,\\n _baseConfig.vaultAddress,\\n _beaconChainDepositContract,\\n _ssvNetwork\\n )\\n {\\n SSV_TOKEN_ADDRESS = _ssvToken;\\n FEE_ACCUMULATOR_ADDRESS = _feeAccumulator;\\n }\\n\\n /// @notice initialize function, to set up initial internal state\\n /// @param _rewardTokenAddresses Address of reward token for platform\\n /// @param _assets Addresses of initial supported assets\\n /// @param _pTokens Platform Token corresponding addresses\\n function initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) external onlyGovernor initializer {\\n InitializableAbstractStrategy._initialize(\\n _rewardTokenAddresses,\\n _assets,\\n _pTokens\\n );\\n }\\n\\n /// @dev Convert accumulated ETH to WETH and send to the Harvester.\\n /// Will revert if the strategy is paused for accounting.\\n function _collectRewardTokens() internal override whenNotPaused {\\n // collect ETH from execution rewards from the fee accumulator\\n uint256 executionRewards = FeeAccumulator(FEE_ACCUMULATOR_ADDRESS)\\n .collect();\\n\\n // total ETH rewards to be harvested = execution rewards + consensus rewards\\n uint256 ethRewards = executionRewards + consensusRewards;\\n\\n require(\\n address(this).balance >= ethRewards,\\n \\\"insufficient eth balance\\\"\\n );\\n\\n if (ethRewards > 0) {\\n // reset the counter keeping track of beacon chain consensus rewards\\n consensusRewards = 0;\\n\\n // Convert ETH rewards to WETH\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRewards }();\\n\\n emit RewardTokenCollected(\\n harvesterAddress,\\n WETH_TOKEN_ADDRESS,\\n ethRewards\\n );\\n IERC20(WETH_TOKEN_ADDRESS).safeTransfer(\\n harvesterAddress,\\n ethRewards\\n );\\n }\\n }\\n\\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\\n /// It just checks the asset is WETH and emits the Deposit event.\\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n /// @param _asset Address of asset to deposit. Has to be WETH.\\n /// @param _amount Amount of assets that were transferred to the strategy by the vault.\\n function deposit(address _asset, uint256 _amount)\\n external\\n override\\n onlyVault\\n nonReentrant\\n {\\n require(_asset == WETH_TOKEN_ADDRESS, \\\"Unsupported asset\\\");\\n _deposit(_asset, _amount);\\n }\\n\\n /// @dev Deposit WETH to this strategy so it can later be staked into a validator.\\n /// @param _asset Address of WETH\\n /// @param _amount Amount of WETH to deposit\\n function _deposit(address _asset, uint256 _amount) internal {\\n require(_amount > 0, \\\"Must deposit something\\\");\\n /*\\n * We could do a check here that would revert when \\\"_amount % 32 ether != 0\\\". With the idea of\\n * not allowing deposits that will result in WETH sitting on the strategy after all the possible batches\\n * of 32ETH have been staked.\\n * But someone could mess with our strategy by sending some WETH to it. And we might want to deposit just\\n * enough WETH to add it up to 32 so it can be staked. For that reason the check is left out.\\n *\\n * WETH sitting on the strategy won't interfere with the accounting since accounting only operates on ETH.\\n */\\n emit Deposit(_asset, address(0), _amount);\\n }\\n\\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\\n /// It just emits the Deposit event.\\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n function depositAll() external override onlyVault nonReentrant {\\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n if (wethBalance > 0) {\\n _deposit(WETH_TOKEN_ADDRESS, wethBalance);\\n }\\n }\\n\\n /// @notice Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That\\n /// can happen when:\\n /// - the deposit was not a multiple of 32 WETH\\n /// - someone sent WETH directly to this contract\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n /// @param _recipient Address to receive withdrawn assets\\n /// @param _asset WETH to withdraw\\n /// @param _amount Amount of WETH to withdraw\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external override onlyVault nonReentrant {\\n _withdraw(_recipient, _asset, _amount);\\n }\\n\\n function _withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) internal {\\n require(_amount > 0, \\\"Must withdraw something\\\");\\n require(_recipient != address(0), \\\"Must specify recipient\\\");\\n\\n emit Withdrawal(_asset, address(0), _amount);\\n IERC20(_asset).safeTransfer(_recipient, _amount);\\n }\\n\\n /// @notice transfer all WETH deposits back to the vault.\\n /// This does not withdraw from the validators. That has to be done separately with the\\n /// `exitSsvValidator` and `removeSsvValidator` operations.\\n /// This does not withdraw any execution rewards from the FeeAccumulator or\\n /// consensus rewards in this strategy.\\n /// Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn.\\n /// ETH from full validator withdrawals is sent to the Vault using `doAccounting`.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n if (wethBalance > 0) {\\n _withdraw(vaultAddress, WETH_TOKEN_ADDRESS, wethBalance);\\n }\\n }\\n\\n function _abstractSetPToken(address _asset, address) internal override {}\\n\\n /// @notice Returns the total value of (W)ETH that is staked to the validators\\n /// and WETH deposits that are still to be staked.\\n /// This does not include ETH from consensus rewards sitting in this strategy\\n /// or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested\\n /// and sent to the Dripper so will eventually be sent to the Vault as WETH.\\n /// @param _asset Address of weth asset\\n /// @return balance Total value of (W)ETH\\n function checkBalance(address _asset)\\n external\\n view\\n override\\n returns (uint256 balance)\\n {\\n require(_asset == WETH_TOKEN_ADDRESS, \\\"Unsupported asset\\\");\\n\\n balance =\\n // add the ETH that has been staked in validators\\n activeDepositedValidators *\\n 32 ether +\\n // add the WETH in the strategy from deposits that are still to be staked\\n IERC20(WETH_TOKEN_ADDRESS).balanceOf(address(this));\\n }\\n\\n function pause() external onlyStrategist {\\n _pause();\\n }\\n\\n /// @notice Returns bool indicating whether asset is supported by strategy.\\n /// @param _asset The address of the asset token.\\n function supportsAsset(address _asset) public view override returns (bool) {\\n return _asset == WETH_TOKEN_ADDRESS;\\n }\\n\\n /// @notice Approves the SSV Network contract to transfer SSV tokens for deposits\\n function safeApproveAllTokens() external override {\\n /// @dev Approves the SSV Network contract to transfer SSV tokens for deposits\\n IERC20(SSV_TOKEN_ADDRESS).approve(\\n SSV_NETWORK_ADDRESS,\\n type(uint256).max\\n );\\n }\\n\\n /**\\n * @notice Only accept ETH from the FeeAccumulator and the WETH contract - required when \\n * unwrapping WETH just before staking it to the validator\\n * @dev don't want to receive donations from anyone else as this will\\n * mess with the accounting of the consensus rewards and validator full withdrawals\\n */\\n receive() external payable {\\n require(\\n msg.sender == FEE_ACCUMULATOR_ADDRESS || msg.sender == WETH_TOKEN_ADDRESS,\\n \\\"eth not from allowed contracts\\\"\\n );\\n }\\n}\\n\",\"keccak256\":\"0xf591c47516bc68b9b0a220b7d7c6b96f87315b03ea8636b47ca5c6540e59fb85\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/ValidatorAccountant.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { ValidatorRegistrator } from \\\"./ValidatorRegistrator.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\n\\n/// @title Validator Accountant\\n/// @notice Attributes the ETH swept from beacon chain validators to this strategy contract\\n/// as either full or partial withdrawals. Partial withdrawals being consensus rewards.\\n/// Full withdrawals are from exited validators.\\n/// @author Origin Protocol Inc\\nabstract contract ValidatorAccountant is ValidatorRegistrator {\\n /// @notice The maximum amount of ETH that can be staked by a validator\\n /// @dev this can change in the future with EIP-7251, Increase the MAX_EFFECTIVE_BALANCE\\n uint256 public constant MAX_STAKE = 32 ether;\\n\\n /// @notice Keeps track of the total consensus rewards swept from the beacon chain\\n uint256 public consensusRewards = 0;\\n\\n /// @notice start of fuse interval\\n uint256 public fuseIntervalStart = 0;\\n /// @notice end of fuse interval\\n uint256 public fuseIntervalEnd = 0;\\n /// @notice Governor that can manually correct the accounting\\n address public accountingGovernor;\\n\\n uint256[50] private __gap;\\n\\n event FuseIntervalUpdated(uint256 start, uint256 end);\\n event AccountingFullyWithdrawnValidator(\\n uint256 noOfValidators,\\n uint256 remainingValidators,\\n uint256 wethSentToVault\\n );\\n event AccountingValidatorSlashed(\\n uint256 remainingValidators,\\n uint256 wethSentToVault\\n );\\n event AccountingGovernorChanged(address newAddress);\\n event AccountingConsensusRewards(uint256 amount);\\n\\n event AccountingManuallyFixed(\\n uint256 oldActiveDepositedValidators,\\n uint256 activeDepositedValidators,\\n uint256 oldBeaconChainRewards,\\n uint256 beaconChainRewards,\\n uint256 ethToWeth,\\n uint256 wethToBeSentToVault\\n );\\n\\n /// @dev Throws if called by any account other than the Accounting Governor\\n modifier onlyAccountingGovernor() {\\n require(\\n msg.sender == accountingGovernor,\\n \\\"Caller is not the Accounting Governor\\\"\\n );\\n _;\\n }\\n\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _vaultAddress Address of the Vault\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n constructor(\\n address _wethAddress,\\n address _vaultAddress,\\n address _beaconChainDepositContract,\\n address _ssvNetwork\\n )\\n ValidatorRegistrator(\\n _wethAddress,\\n _vaultAddress,\\n _beaconChainDepositContract,\\n _ssvNetwork\\n )\\n {}\\n\\n function setAccountingGovernor(address _address) external onlyGovernor {\\n emit AccountingGovernorChanged(_address);\\n accountingGovernor = _address;\\n }\\n\\n /// @notice set fuse interval values\\n function setFuseInterval(\\n uint256 _fuseIntervalStart,\\n uint256 _fuseIntervalEnd\\n ) external onlyGovernor {\\n require(\\n _fuseIntervalStart < _fuseIntervalEnd &&\\n _fuseIntervalStart < 32 ether &&\\n _fuseIntervalEnd < 32 ether &&\\n _fuseIntervalEnd - _fuseIntervalStart >= 4 ether,\\n \\\"incorrect fuse interval\\\"\\n );\\n\\n emit FuseIntervalUpdated(_fuseIntervalStart, _fuseIntervalEnd);\\n\\n fuseIntervalStart = _fuseIntervalStart;\\n fuseIntervalEnd = _fuseIntervalEnd;\\n }\\n\\n /* solhint-disable max-line-length */\\n /// This notion page offers a good explanation of how the accounting functions\\n /// https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d\\n /// In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart,\\n /// the accounting function will treat that ETH as Beacon chain consensus rewards.\\n /// On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32,\\n /// the accounting function will treat that as a validator slashing.\\n /// @notice Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when\\n /// accounting is valid and fuse isn't \\\"blown\\\". Returns false when fuse is blown.\\n /// @dev This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it\\n /// for now.\\n /* solhint-enable max-line-length */\\n function doAccounting()\\n external\\n onlyRegistrator\\n whenNotPaused\\n returns (bool accountingValid)\\n {\\n if (address(this).balance < consensusRewards) {\\n // pause and fail the accounting\\n _pause();\\n return false;\\n }\\n\\n // Calculate all the new ETH that has been swept to the contract since the last accounting\\n uint256 newSweptETH = address(this).balance - consensusRewards;\\n accountingValid = true;\\n\\n // send the ETH that is from fully withdrawn validators to the Vault\\n if (newSweptETH >= MAX_STAKE) {\\n uint256 fullyWithdrawnValidators = newSweptETH / MAX_STAKE;\\n activeDepositedValidators -= fullyWithdrawnValidators;\\n\\n uint256 wethToVault = MAX_STAKE * fullyWithdrawnValidators;\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: wethToVault }();\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, wethToVault);\\n\\n emit AccountingFullyWithdrawnValidator(\\n fullyWithdrawnValidators,\\n activeDepositedValidators,\\n wethToVault\\n );\\n }\\n\\n uint256 ethRemaining = address(this).balance - consensusRewards;\\n // should be less than a whole validator stake\\n require(ethRemaining < 32 ether, \\\"unexpected accounting\\\");\\n\\n // If no Beacon chain consensus rewards swept\\n if (ethRemaining == 0) {\\n // do nothing\\n return accountingValid;\\n }\\n // Beacon chain consensus rewards swept (partial validator withdrawals)\\n else if (ethRemaining < fuseIntervalStart) {\\n // solhint-disable-next-line reentrancy\\n consensusRewards += ethRemaining;\\n emit AccountingConsensusRewards(ethRemaining);\\n }\\n // Beacon chain consensus rewards swept but also a slashed validator fully exited\\n else if (ethRemaining > fuseIntervalEnd) {\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRemaining }();\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, ethRemaining);\\n activeDepositedValidators -= 1;\\n\\n emit AccountingValidatorSlashed(\\n activeDepositedValidators,\\n ethRemaining\\n );\\n }\\n // Oh no... Fuse is blown. The governor (Multisig not OGV Governor) needs to set the\\n // record straight by manually set the accounting values.\\n else {\\n // will emit a paused event\\n _pause();\\n accountingValid = false;\\n }\\n }\\n\\n /// @dev allow the accounting governor to fix the accounting of this strategy and unpause\\n /// @param _activeDepositedValidators the override value of activeDepositedValidators\\n /// @param _ethToWeth the amount of ETH to be converted to WETH\\n /// @param _wethToBeSentToVault the amount of WETH to be sent to the Vault\\n /// @param _consensusRewards the override value for consensusRewards\\n /// @param _ethThresholdCheck maximum allowed ETH balance on the contract for the function to run\\n /// @param _wethThresholdCheck maximum allowed WETH balance on the contract for the function to run\\n /// the above 2 checks are done so transaction doesn't get front run and cause\\n /// unexpected behaviour\\n function manuallyFixAccounting(\\n uint256 _activeDepositedValidators,\\n uint256 _ethToWeth,\\n uint256 _wethToBeSentToVault,\\n uint256 _consensusRewards,\\n uint256 _ethThresholdCheck,\\n uint256 _wethThresholdCheck\\n ) external onlyAccountingGovernor whenPaused {\\n uint256 ethBalance = address(this).balance;\\n uint256 wethBalance = IWETH9(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n\\n require(\\n ethBalance <= _ethThresholdCheck &&\\n wethBalance <= _wethThresholdCheck,\\n \\\"over accounting threshold\\\"\\n );\\n\\n emit AccountingManuallyFixed(\\n activeDepositedValidators,\\n _activeDepositedValidators,\\n consensusRewards,\\n _consensusRewards,\\n _ethToWeth,\\n _wethToBeSentToVault\\n );\\n\\n activeDepositedValidators = _activeDepositedValidators;\\n consensusRewards = _consensusRewards;\\n if (_ethToWeth > 0) {\\n require(_ethToWeth <= ethBalance, \\\"insufficient ETH\\\");\\n\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: _ethToWeth }();\\n }\\n if (_wethToBeSentToVault > 0) {\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(\\n VAULT_ADDRESS,\\n _wethToBeSentToVault\\n );\\n }\\n\\n _unpause();\\n }\\n}\\n\",\"keccak256\":\"0x44a1fc3a3e324b3ae63b39d2c5ae0a3e8a1b71b8dbf7e604b70d81ef5b170754\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/ValidatorRegistrator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\nimport { IDepositContract } from \\\"../../interfaces/IDepositContract.sol\\\";\\nimport { IVault } from \\\"../../interfaces/IVault.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\nimport { ISSVNetwork, Cluster } from \\\"../../interfaces/ISSVNetwork.sol\\\";\\n\\nstruct ValidatorStakeData {\\n bytes pubkey;\\n bytes signature;\\n bytes32 depositDataRoot;\\n}\\n\\n/**\\n * @title Registrator of the validators\\n * @notice This contract implements all the required functionality to register, exit and remove validators.\\n * @author Origin Protocol Inc\\n */\\nabstract contract ValidatorRegistrator is Governable, Pausable {\\n /// @notice The address of the Wrapped ETH (WETH) token contract\\n address public immutable WETH_TOKEN_ADDRESS;\\n /// @notice The address of the beacon chain deposit contract\\n address public immutable BEACON_CHAIN_DEPOSIT_CONTRACT;\\n /// @notice The address of the SSV Network contract used to interface with\\n address public immutable SSV_NETWORK_ADDRESS;\\n /// @notice Address of the OETH Vault proxy contract\\n address public immutable VAULT_ADDRESS;\\n\\n /// @notice Address of the registrator - allowed to register, exit and remove validators\\n address public validatorRegistrator;\\n /// @notice The number of validators that have 32 (!) ETH actively deposited. When a new deposit\\n /// to a validator happens this number increases, when a validator exit is detected this number\\n /// decreases.\\n uint256 activeDepositedValidators;\\n /// @notice State of the validators keccak256(pubKey) => state\\n mapping(bytes32 => VALIDATOR_STATE) public validatorsStates;\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n enum VALIDATOR_STATE {\\n REGISTERED, // validator is registered on the SSV network\\n STAKED, // validator has funds staked\\n EXITING, // exit message has been posted and validator is in the process of exiting\\n EXIT_COMPLETE // validator has funds withdrawn to the EigenPod and is removed from the SSV\\n }\\n\\n event RegistratorChanged(address newAddress);\\n event ETHStaked(bytes pubkey, uint256 amount, bytes withdrawal_credentials);\\n event SSVValidatorRegistered(bytes pubkey, uint64[] operatorIds);\\n event SSVValidatorExitInitiated(bytes pubkey, uint64[] operatorIds);\\n event SSVValidatorExitCompleted(bytes pubkey, uint64[] operatorIds);\\n\\n /// @dev Throws if called by any account other than the Registrator\\n modifier onlyRegistrator() {\\n require(\\n msg.sender == validatorRegistrator,\\n \\\"Caller is not the Registrator\\\"\\n );\\n _;\\n }\\n\\n /// @dev Throws if called by any account other than the Strategist\\n modifier onlyStrategist() {\\n require(\\n msg.sender == IVault(VAULT_ADDRESS).strategistAddr(),\\n \\\"Caller is not the Strategist\\\"\\n );\\n _;\\n }\\n\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _vaultAddress Address of the Vault\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n constructor(\\n address _wethAddress,\\n address _vaultAddress,\\n address _beaconChainDepositContract,\\n address _ssvNetwork\\n ) {\\n WETH_TOKEN_ADDRESS = _wethAddress;\\n BEACON_CHAIN_DEPOSIT_CONTRACT = _beaconChainDepositContract;\\n SSV_NETWORK_ADDRESS = _ssvNetwork;\\n VAULT_ADDRESS = _vaultAddress;\\n }\\n\\n /// @notice Set the address of the registrator which can register, exit and remove validators\\n function setRegistrator(address _address) external onlyGovernor {\\n emit RegistratorChanged(_address);\\n validatorRegistrator = _address;\\n }\\n\\n /// @notice Stakes WETH to the node validators\\n /// @param validators A list of validator data needed to stake.\\n /// The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot.\\n /// Only the registrator can call this function.\\n function stakeEth(ValidatorStakeData[] calldata validators)\\n external\\n onlyRegistrator\\n whenNotPaused\\n {\\n uint256 requiredETH = validators.length * 32 ether;\\n\\n // Check there is enough WETH from the deposits sitting in this strategy contract\\n require(\\n requiredETH <= IWETH9(WETH_TOKEN_ADDRESS).balanceOf(address(this)),\\n \\\"insufficient WETH\\\"\\n );\\n\\n // Convert required ETH from WETH\\n IWETH9(WETH_TOKEN_ADDRESS).withdraw(requiredETH);\\n\\n // For each validator\\n for (uint256 i = 0; i < validators.length; ) {\\n bytes32 pubkeyHash = keccak256(validators[i].pubkey);\\n VALIDATOR_STATE currentState = validatorsStates[pubkeyHash];\\n\\n require(\\n currentState == VALIDATOR_STATE.REGISTERED,\\n \\\"Validator not registered\\\"\\n );\\n\\n /* 0x01 to indicate that withdrawal credentials will contain an EOA address that the sweeping function\\n * can sweep funds to.\\n * bytes11(0) to fill up the required zeros\\n * remaining bytes20 are for the address\\n */\\n bytes memory withdrawal_credentials = abi.encodePacked(\\n bytes1(0x01),\\n bytes11(0),\\n address(this)\\n );\\n IDepositContract(BEACON_CHAIN_DEPOSIT_CONTRACT).deposit(\\n validators[i].pubkey,\\n withdrawal_credentials,\\n validators[i].signature,\\n validators[i].depositDataRoot\\n );\\n\\n activeDepositedValidators += 1;\\n emit ETHStaked(\\n validators[i].pubkey,\\n 32 ether,\\n withdrawal_credentials\\n );\\n\\n validatorsStates[pubkeyHash] = VALIDATOR_STATE.STAKED;\\n\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /// @notice Registers a new validator in the SSV Cluster.\\n /// Only the registrator can call this function.\\n function registerSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds,\\n bytes calldata sharesData,\\n uint256 amount,\\n Cluster calldata cluster\\n ) external onlyRegistrator whenNotPaused {\\n ISSVNetwork(SSV_NETWORK_ADDRESS).registerValidator(\\n publicKey,\\n operatorIds,\\n sharesData,\\n amount,\\n cluster\\n );\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.REGISTERED;\\n emit SSVValidatorRegistered(publicKey, operatorIds);\\n }\\n\\n /// @notice Exit a validator from the Beacon chain.\\n /// The staked ETH will eventually swept to this native staking strategy.\\n /// Only the registrator can call this function.\\n function exitSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds\\n ) external onlyRegistrator whenNotPaused {\\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\\n require(currentState == VALIDATOR_STATE.STAKED, \\\"Validator not staked\\\");\\n\\n ISSVNetwork(SSV_NETWORK_ADDRESS).exitValidator(publicKey, operatorIds);\\n emit SSVValidatorExitInitiated(publicKey, operatorIds);\\n\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXITING;\\n }\\n\\n /// @notice Remove a validator from the SSV Cluster.\\n /// Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain.\\n /// If removed before the validator has exited the beacon chain will result in the validator being slashed.\\n /// Only the registrator can call this function.\\n function removeSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds,\\n Cluster calldata cluster\\n ) external onlyRegistrator whenNotPaused {\\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\\n require(\\n currentState == VALIDATOR_STATE.EXITING,\\n \\\"Validator not exiting\\\"\\n );\\n\\n ISSVNetwork(SSV_NETWORK_ADDRESS).removeValidator(\\n publicKey,\\n operatorIds,\\n cluster\\n );\\n emit SSVValidatorExitCompleted(publicKey, operatorIds);\\n\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXIT_COMPLETE;\\n }\\n\\n /// @notice Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\\n /// @dev A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds.\\n /// uses \\\"onlyStrategist\\\" modifier so continuous front-running can't DOS our maintenance service\\n /// that tries to top up SSV tokens.\\n /// @param cluster The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\\n function depositSSV(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external onlyStrategist {\\n ISSVNetwork(SSV_NETWORK_ADDRESS).deposit(\\n address(this),\\n operatorIds,\\n amount,\\n cluster\\n );\\n }\\n}\\n\",\"keccak256\":\"0x3caea29d952f616674ae0c9c80a161cc5d07b956b2dd219f8674119e41141c53\",\"license\":\"MIT\"},\"contracts/token/OUSD.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OUSD Token Contract\\n * @dev ERC20 compatible contract for OUSD\\n * @dev Implements an elastic supply\\n * @author Origin Protocol Inc\\n */\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { InitializableERC20Detailed } from \\\"../utils/InitializableERC20Detailed.sol\\\";\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * NOTE that this is an ERC20 token but the invariant that the sum of\\n * balanceOf(x) for all x is not >= totalSupply(). This is a consequence of the\\n * rebasing design. Any integrations with OUSD should be aware.\\n */\\n\\ncontract OUSD is Initializable, InitializableERC20Detailed, Governable {\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n event TotalSupplyUpdatedHighres(\\n uint256 totalSupply,\\n uint256 rebasingCredits,\\n uint256 rebasingCreditsPerToken\\n );\\n event AccountRebasingEnabled(address account);\\n event AccountRebasingDisabled(address account);\\n\\n enum RebaseOptions {\\n NotSet,\\n OptOut,\\n OptIn\\n }\\n\\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\\n uint256 public _totalSupply;\\n mapping(address => mapping(address => uint256)) private _allowances;\\n address public vaultAddress = address(0);\\n mapping(address => uint256) private _creditBalances;\\n uint256 private _rebasingCredits;\\n uint256 private _rebasingCreditsPerToken;\\n // Frozen address/credits are non rebasing (value is held in contracts which\\n // do not receive yield unless they explicitly opt in)\\n uint256 public nonRebasingSupply;\\n mapping(address => uint256) public nonRebasingCreditsPerToken;\\n mapping(address => RebaseOptions) public rebaseState;\\n mapping(address => uint256) public isUpgraded;\\n\\n uint256 private constant RESOLUTION_INCREASE = 1e9;\\n\\n function initialize(\\n string calldata _nameArg,\\n string calldata _symbolArg,\\n address _vaultAddress,\\n uint256 _initialCreditsPerToken\\n ) external onlyGovernor initializer {\\n InitializableERC20Detailed._initialize(_nameArg, _symbolArg, 18);\\n _rebasingCreditsPerToken = _initialCreditsPerToken;\\n vaultAddress = _vaultAddress;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault contract\\n */\\n modifier onlyVault() {\\n require(vaultAddress == msg.sender, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @return The total supply of OUSD.\\n */\\n function totalSupply() public view override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @return Low resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerToken() public view returns (uint256) {\\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return Low resolution total number of rebasing credits\\n */\\n function rebasingCredits() public view returns (uint256) {\\n return _rebasingCredits / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return High resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\\n return _rebasingCreditsPerToken;\\n }\\n\\n /**\\n * @return High resolution total number of rebasing credits\\n */\\n function rebasingCreditsHighres() public view returns (uint256) {\\n return _rebasingCredits;\\n }\\n\\n /**\\n * @dev Gets the balance of the specified address.\\n * @param _account Address to query the balance of.\\n * @return A uint256 representing the amount of base units owned by the\\n * specified address.\\n */\\n function balanceOf(address _account)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n if (_creditBalances[_account] == 0) return 0;\\n return\\n _creditBalances[_account].divPrecisely(_creditsPerToken(_account));\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @dev Backwards compatible with old low res credits per token.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256) Credit balance and credits per token of the\\n * address\\n */\\n function creditsBalanceOf(address _account)\\n public\\n view\\n returns (uint256, uint256)\\n {\\n uint256 cpt = _creditsPerToken(_account);\\n if (cpt == 1e27) {\\n // For a period before the resolution upgrade, we created all new\\n // contract accounts at high resolution. Since they are not changing\\n // as a result of this upgrade, we will return their true values\\n return (_creditBalances[_account], cpt);\\n } else {\\n return (\\n _creditBalances[_account] / RESOLUTION_INCREASE,\\n cpt / RESOLUTION_INCREASE\\n );\\n }\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256, bool) Credit balance, credits per token of the\\n * address, and isUpgraded\\n */\\n function creditsBalanceOfHighres(address _account)\\n public\\n view\\n returns (\\n uint256,\\n uint256,\\n bool\\n )\\n {\\n return (\\n _creditBalances[_account],\\n _creditsPerToken(_account),\\n isUpgraded[_account] == 1\\n );\\n }\\n\\n /**\\n * @dev Transfer tokens to a specified address.\\n * @param _to the address to transfer to.\\n * @param _value the amount to be transferred.\\n * @return true on success.\\n */\\n function transfer(address _to, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(\\n _value <= balanceOf(msg.sender),\\n \\\"Transfer greater than balance\\\"\\n );\\n\\n _executeTransfer(msg.sender, _to, _value);\\n\\n emit Transfer(msg.sender, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Transfer tokens from one address to another.\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value The amount of tokens to be transferred.\\n */\\n function transferFrom(\\n address _from,\\n address _to,\\n uint256 _value\\n ) public override returns (bool) {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(_value <= balanceOf(_from), \\\"Transfer greater than balance\\\");\\n\\n _allowances[_from][msg.sender] = _allowances[_from][msg.sender].sub(\\n _value\\n );\\n\\n _executeTransfer(_from, _to, _value);\\n\\n emit Transfer(_from, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Update the count of non rebasing credits in response to a transfer\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value Amount of OUSD to transfer\\n */\\n function _executeTransfer(\\n address _from,\\n address _to,\\n uint256 _value\\n ) internal {\\n bool isNonRebasingTo = _isNonRebasingAccount(_to);\\n bool isNonRebasingFrom = _isNonRebasingAccount(_from);\\n\\n // Credits deducted and credited might be different due to the\\n // differing creditsPerToken used by each account\\n uint256 creditsCredited = _value.mulTruncate(_creditsPerToken(_to));\\n uint256 creditsDeducted = _value.mulTruncate(_creditsPerToken(_from));\\n\\n _creditBalances[_from] = _creditBalances[_from].sub(\\n creditsDeducted,\\n \\\"Transfer amount exceeds balance\\\"\\n );\\n _creditBalances[_to] = _creditBalances[_to].add(creditsCredited);\\n\\n if (isNonRebasingTo && !isNonRebasingFrom) {\\n // Transfer to non-rebasing account from rebasing account, credits\\n // are removed from the non rebasing tally\\n nonRebasingSupply = nonRebasingSupply.add(_value);\\n // Update rebasingCredits by subtracting the deducted amount\\n _rebasingCredits = _rebasingCredits.sub(creditsDeducted);\\n } else if (!isNonRebasingTo && isNonRebasingFrom) {\\n // Transfer to rebasing account from non-rebasing account\\n // Decreasing non-rebasing credits by the amount that was sent\\n nonRebasingSupply = nonRebasingSupply.sub(_value);\\n // Update rebasingCredits by adding the credited amount\\n _rebasingCredits = _rebasingCredits.add(creditsCredited);\\n }\\n }\\n\\n /**\\n * @dev Function to check the amount of tokens that _owner has allowed to\\n * `_spender`.\\n * @param _owner The address which owns the funds.\\n * @param _spender The address which will spend the funds.\\n * @return The number of tokens still available for the _spender.\\n */\\n function allowance(address _owner, address _spender)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n return _allowances[_owner][_spender];\\n }\\n\\n /**\\n * @dev Approve the passed address to spend the specified amount of tokens\\n * on behalf of msg.sender. This method is included for ERC20\\n * compatibility. `increaseAllowance` and `decreaseAllowance` should be\\n * used instead.\\n *\\n * Changing an allowance with this method brings the risk that someone\\n * may transfer both the old and the new allowance - if they are both\\n * greater than zero - if a transfer transaction is mined before the\\n * later approve() call is mined.\\n * @param _spender The address which will spend the funds.\\n * @param _value The amount of tokens to be spent.\\n */\\n function approve(address _spender, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _value;\\n emit Approval(msg.sender, _spender, _value);\\n return true;\\n }\\n\\n /**\\n * @dev Increase the amount of tokens that an owner has allowed to\\n * `_spender`.\\n * This method should be used instead of approve() to avoid the double\\n * approval vulnerability described above.\\n * @param _spender The address which will spend the funds.\\n * @param _addedValue The amount of tokens to increase the allowance by.\\n */\\n function increaseAllowance(address _spender, uint256 _addedValue)\\n public\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _allowances[msg.sender][_spender]\\n .add(_addedValue);\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Decrease the amount of tokens that an owner has allowed to\\n `_spender`.\\n * @param _spender The address which will spend the funds.\\n * @param _subtractedValue The amount of tokens to decrease the allowance\\n * by.\\n */\\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\\n public\\n returns (bool)\\n {\\n uint256 oldValue = _allowances[msg.sender][_spender];\\n if (_subtractedValue >= oldValue) {\\n _allowances[msg.sender][_spender] = 0;\\n } else {\\n _allowances[msg.sender][_spender] = oldValue.sub(_subtractedValue);\\n }\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Mints new tokens, increasing totalSupply.\\n */\\n function mint(address _account, uint256 _amount) external onlyVault {\\n _mint(_account, _amount);\\n }\\n\\n /**\\n * @dev Creates `_amount` tokens and assigns them to `_account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `to` cannot be the zero address.\\n */\\n function _mint(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Mint to the zero address\\\");\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n _creditBalances[_account] = _creditBalances[_account].add(creditAmount);\\n\\n // If the account is non rebasing and doesn't have a set creditsPerToken\\n // then set it i.e. this is a mint from a fresh contract\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.add(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.add(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.add(_amount);\\n\\n require(_totalSupply < MAX_SUPPLY, \\\"Max supply\\\");\\n\\n emit Transfer(address(0), _account, _amount);\\n }\\n\\n /**\\n * @dev Burns tokens, decreasing totalSupply.\\n */\\n function burn(address account, uint256 amount) external onlyVault {\\n _burn(account, amount);\\n }\\n\\n /**\\n * @dev Destroys `_amount` tokens from `_account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `_account` cannot be the zero address.\\n * - `_account` must have at least `_amount` tokens.\\n */\\n function _burn(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Burn from the zero address\\\");\\n if (_amount == 0) {\\n return;\\n }\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n uint256 currentCredits = _creditBalances[_account];\\n\\n // Remove the credits, burning rounding errors\\n if (\\n currentCredits == creditAmount || currentCredits - 1 == creditAmount\\n ) {\\n // Handle dust from rounding\\n _creditBalances[_account] = 0;\\n } else if (currentCredits > creditAmount) {\\n _creditBalances[_account] = _creditBalances[_account].sub(\\n creditAmount\\n );\\n } else {\\n revert(\\\"Remove exceeds balance\\\");\\n }\\n\\n // Remove from the credit tallies and non-rebasing supply\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.sub(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.sub(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.sub(_amount);\\n\\n emit Transfer(_account, address(0), _amount);\\n }\\n\\n /**\\n * @dev Get the credits per token for an account. Returns a fixed amount\\n * if the account is non-rebasing.\\n * @param _account Address of the account.\\n */\\n function _creditsPerToken(address _account)\\n internal\\n view\\n returns (uint256)\\n {\\n if (nonRebasingCreditsPerToken[_account] != 0) {\\n return nonRebasingCreditsPerToken[_account];\\n } else {\\n return _rebasingCreditsPerToken;\\n }\\n }\\n\\n /**\\n * @dev Is an account using rebasing accounting or non-rebasing accounting?\\n * Also, ensure contracts are non-rebasing if they have not opted in.\\n * @param _account Address of the account.\\n */\\n function _isNonRebasingAccount(address _account) internal returns (bool) {\\n bool isContract = Address.isContract(_account);\\n if (isContract && rebaseState[_account] == RebaseOptions.NotSet) {\\n _ensureRebasingMigration(_account);\\n }\\n return nonRebasingCreditsPerToken[_account] > 0;\\n }\\n\\n /**\\n * @dev Ensures internal account for rebasing and non-rebasing credits and\\n * supply is updated following deployment of frozen yield change.\\n */\\n function _ensureRebasingMigration(address _account) internal {\\n if (nonRebasingCreditsPerToken[_account] == 0) {\\n emit AccountRebasingDisabled(_account);\\n if (_creditBalances[_account] == 0) {\\n // Since there is no existing balance, we can directly set to\\n // high resolution, and do not have to do any other bookkeeping\\n nonRebasingCreditsPerToken[_account] = 1e27;\\n } else {\\n // Migrate an existing account:\\n\\n // Set fixed credits per token for this account\\n nonRebasingCreditsPerToken[_account] = _rebasingCreditsPerToken;\\n // Update non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(_account));\\n // Update credit tallies\\n _rebasingCredits = _rebasingCredits.sub(\\n _creditBalances[_account]\\n );\\n }\\n }\\n }\\n\\n /**\\n * @notice Enable rebasing for an account.\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n * @param _account Address of the account.\\n */\\n function governanceRebaseOptIn(address _account)\\n public\\n nonReentrant\\n onlyGovernor\\n {\\n _rebaseOptIn(_account);\\n }\\n\\n /**\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n */\\n function rebaseOptIn() public nonReentrant {\\n _rebaseOptIn(msg.sender);\\n }\\n\\n function _rebaseOptIn(address _account) internal {\\n require(_isNonRebasingAccount(_account), \\\"Account has not opted out\\\");\\n\\n // Convert balance into the same amount at the current exchange rate\\n uint256 newCreditBalance = _creditBalances[_account]\\n .mul(_rebasingCreditsPerToken)\\n .div(_creditsPerToken(_account));\\n\\n // Decreasing non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.sub(balanceOf(_account));\\n\\n _creditBalances[_account] = newCreditBalance;\\n\\n // Increase rebasing credits, totalSupply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.add(_creditBalances[_account]);\\n\\n rebaseState[_account] = RebaseOptions.OptIn;\\n\\n // Delete any fixed credits per token\\n delete nonRebasingCreditsPerToken[_account];\\n emit AccountRebasingEnabled(_account);\\n }\\n\\n /**\\n * @dev Explicitly mark that an address is non-rebasing.\\n */\\n function rebaseOptOut() public nonReentrant {\\n require(!_isNonRebasingAccount(msg.sender), \\\"Account has not opted in\\\");\\n\\n // Increase non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(msg.sender));\\n // Set fixed credits per token\\n nonRebasingCreditsPerToken[msg.sender] = _rebasingCreditsPerToken;\\n\\n // Decrease rebasing credits, total supply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.sub(_creditBalances[msg.sender]);\\n\\n // Mark explicitly opted out of rebasing\\n rebaseState[msg.sender] = RebaseOptions.OptOut;\\n emit AccountRebasingDisabled(msg.sender);\\n }\\n\\n /**\\n * @dev Modify the supply without minting new tokens. This uses a change in\\n * the exchange rate between \\\"credits\\\" and OUSD tokens to change balances.\\n * @param _newTotalSupply New total supply of OUSD.\\n */\\n function changeSupply(uint256 _newTotalSupply)\\n external\\n onlyVault\\n nonReentrant\\n {\\n require(_totalSupply > 0, \\\"Cannot increase 0 supply\\\");\\n\\n if (_totalSupply == _newTotalSupply) {\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n return;\\n }\\n\\n _totalSupply = _newTotalSupply > MAX_SUPPLY\\n ? MAX_SUPPLY\\n : _newTotalSupply;\\n\\n _rebasingCreditsPerToken = _rebasingCredits.divPrecisely(\\n _totalSupply.sub(nonRebasingSupply)\\n );\\n\\n require(_rebasingCreditsPerToken > 0, \\\"Invalid change in supply\\\");\\n\\n _totalSupply = _rebasingCredits\\n .divPrecisely(_rebasingCreditsPerToken)\\n .add(nonRebasingSupply);\\n\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n }\\n}\\n\",\"keccak256\":\"0x2dc66b1ba02716d64eb47dd9117fda62650d8b57669e6c351437e0ad29ad5f19\",\"license\":\"MIT\"},\"contracts/utils/Helpers.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IBasicToken } from \\\"../interfaces/IBasicToken.sol\\\";\\n\\nlibrary Helpers {\\n /**\\n * @notice Fetch the `symbol()` from an ERC20 token\\n * @dev Grabs the `symbol()` from a contract\\n * @param _token Address of the ERC20 token\\n * @return string Symbol of the ERC20 token\\n */\\n function getSymbol(address _token) internal view returns (string memory) {\\n string memory symbol = IBasicToken(_token).symbol();\\n return symbol;\\n }\\n\\n /**\\n * @notice Fetch the `decimals()` from an ERC20 token\\n * @dev Grabs the `decimals()` from a contract and fails if\\n * the decimal value does not live within a certain range\\n * @param _token Address of the ERC20 token\\n * @return uint256 Decimals of the ERC20 token\\n */\\n function getDecimals(address _token) internal view returns (uint256) {\\n uint256 decimals = IBasicToken(_token).decimals();\\n require(\\n decimals >= 4 && decimals <= 18,\\n \\\"Token must have sufficient decimal places\\\"\\n );\\n\\n return decimals;\\n }\\n}\\n\",\"keccak256\":\"0x108b7a69e0140da0072ca18f90a03a3340574400f81aa6076cd2cccdf13699c2\",\"license\":\"MIT\"},\"contracts/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract any contracts that need to initialize state after deployment.\\n * @author Origin Protocol Inc\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n */\\n bool private initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private initializing;\\n\\n /**\\n * @dev Modifier to protect an initializer function from being invoked twice.\\n */\\n modifier initializer() {\\n require(\\n initializing || !initialized,\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n\\n bool isTopLevelCall = !initializing;\\n if (isTopLevelCall) {\\n initializing = true;\\n initialized = true;\\n }\\n\\n _;\\n\\n if (isTopLevelCall) {\\n initializing = false;\\n }\\n }\\n\\n uint256[50] private ______gap;\\n}\\n\",\"keccak256\":\"0xaadbcc138114afed4af4f353c2ced2916e6ee14be91434789187f192caf0d786\",\"license\":\"MIT\"},\"contracts/utils/InitializableAbstractStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract for vault strategies.\\n * @author Origin Protocol Inc\\n */\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\n\\nabstract contract InitializableAbstractStrategy is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event PTokenAdded(address indexed _asset, address _pToken);\\n event PTokenRemoved(address indexed _asset, address _pToken);\\n event Deposit(address indexed _asset, address _pToken, uint256 _amount);\\n event Withdrawal(address indexed _asset, address _pToken, uint256 _amount);\\n event RewardTokenCollected(\\n address recipient,\\n address rewardToken,\\n uint256 amount\\n );\\n event RewardTokenAddressesUpdated(\\n address[] _oldAddresses,\\n address[] _newAddresses\\n );\\n event HarvesterAddressesUpdated(\\n address _oldHarvesterAddress,\\n address _newHarvesterAddress\\n );\\n\\n /// @notice Address of the underlying platform\\n address public immutable platformAddress;\\n /// @notice Address of the OToken vault\\n address public immutable vaultAddress;\\n\\n /// @dev Replaced with an immutable variable\\n // slither-disable-next-line constable-states\\n address private _deprecated_platformAddress;\\n\\n /// @dev Replaced with an immutable\\n // slither-disable-next-line constable-states\\n address private _deprecated_vaultAddress;\\n\\n /// @notice asset => pToken (Platform Specific Token Address)\\n mapping(address => address) public assetToPToken;\\n\\n /// @notice Full list of all assets supported by the strategy\\n address[] internal assetsMapped;\\n\\n // Deprecated: Reward token address\\n // slither-disable-next-line constable-states\\n address private _deprecated_rewardTokenAddress;\\n\\n // Deprecated: now resides in Harvester's rewardTokenConfigs\\n // slither-disable-next-line constable-states\\n uint256 private _deprecated_rewardLiquidationThreshold;\\n\\n /// @notice Address of the Harvester contract allowed to collect reward tokens\\n address public harvesterAddress;\\n\\n /// @notice Address of the reward tokens. eg CRV, BAL, CVX, AURA\\n address[] public rewardTokenAddresses;\\n\\n /* Reserved for future expansion. Used to be 100 storage slots\\n * and has decreased to accommodate:\\n * - harvesterAddress\\n * - rewardTokenAddresses\\n */\\n int256[98] private _reserved;\\n\\n struct BaseStrategyConfig {\\n address platformAddress; // Address of the underlying platform\\n address vaultAddress; // Address of the OToken's Vault\\n }\\n\\n /**\\n * @param _config The platform and OToken vault addresses\\n */\\n constructor(BaseStrategyConfig memory _config) {\\n platformAddress = _config.platformAddress;\\n vaultAddress = _config.vaultAddress;\\n }\\n\\n /**\\n * @dev Internal initialize function, to set up initial internal state\\n * @param _rewardTokenAddresses Address of reward token for platform\\n * @param _assets Addresses of initial supported assets\\n * @param _pTokens Platform Token corresponding addresses\\n */\\n function _initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) internal {\\n rewardTokenAddresses = _rewardTokenAddresses;\\n\\n uint256 assetCount = _assets.length;\\n require(assetCount == _pTokens.length, \\\"Invalid input arrays\\\");\\n for (uint256 i = 0; i < assetCount; ++i) {\\n _setPTokenAddress(_assets[i], _pTokens[i]);\\n }\\n }\\n\\n /**\\n * @notice Collect accumulated reward token and send to Vault.\\n */\\n function collectRewardTokens() external virtual onlyHarvester nonReentrant {\\n _collectRewardTokens();\\n }\\n\\n /**\\n * @dev Default implementation that transfers reward tokens to the Harvester\\n * Implementing strategies need to add custom logic to collect the rewards.\\n */\\n function _collectRewardTokens() internal virtual {\\n uint256 rewardTokenCount = rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n IERC20 rewardToken = IERC20(rewardTokenAddresses[i]);\\n uint256 balance = rewardToken.balanceOf(address(this));\\n if (balance > 0) {\\n emit RewardTokenCollected(\\n harvesterAddress,\\n address(rewardToken),\\n balance\\n );\\n rewardToken.safeTransfer(harvesterAddress, balance);\\n }\\n }\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault.\\n */\\n modifier onlyVault() {\\n require(msg.sender == vaultAddress, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Harvester.\\n */\\n modifier onlyHarvester() {\\n require(msg.sender == harvesterAddress, \\\"Caller is not the Harvester\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault or Governor.\\n */\\n modifier onlyVaultOrGovernor() {\\n require(\\n msg.sender == vaultAddress || msg.sender == governor(),\\n \\\"Caller is not the Vault or Governor\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault, Governor, or Strategist.\\n */\\n modifier onlyVaultOrGovernorOrStrategist() {\\n require(\\n msg.sender == vaultAddress ||\\n msg.sender == governor() ||\\n msg.sender == IVault(vaultAddress).strategistAddr(),\\n \\\"Caller is not the Vault, Governor, or Strategist\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @notice Set the reward token addresses. Any old addresses will be overwritten.\\n * @param _rewardTokenAddresses Array of reward token addresses\\n */\\n function setRewardTokenAddresses(address[] calldata _rewardTokenAddresses)\\n external\\n onlyGovernor\\n {\\n uint256 rewardTokenCount = _rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n require(\\n _rewardTokenAddresses[i] != address(0),\\n \\\"Can not set an empty address as a reward token\\\"\\n );\\n }\\n\\n emit RewardTokenAddressesUpdated(\\n rewardTokenAddresses,\\n _rewardTokenAddresses\\n );\\n rewardTokenAddresses = _rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Get the reward token addresses.\\n * @return address[] the reward token addresses.\\n */\\n function getRewardTokenAddresses()\\n external\\n view\\n returns (address[] memory)\\n {\\n return rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * This method can only be called by the system Governor\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function setPTokenAddress(address _asset, address _pToken)\\n external\\n virtual\\n onlyGovernor\\n {\\n _setPTokenAddress(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Remove a supported asset by passing its index.\\n * This method can only be called by the system Governor\\n * @param _assetIndex Index of the asset to be removed\\n */\\n function removePToken(uint256 _assetIndex) external virtual onlyGovernor {\\n require(_assetIndex < assetsMapped.length, \\\"Invalid index\\\");\\n address asset = assetsMapped[_assetIndex];\\n address pToken = assetToPToken[asset];\\n\\n if (_assetIndex < assetsMapped.length - 1) {\\n assetsMapped[_assetIndex] = assetsMapped[assetsMapped.length - 1];\\n }\\n assetsMapped.pop();\\n assetToPToken[asset] = address(0);\\n\\n emit PTokenRemoved(asset, pToken);\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * Add to internal mappings and execute the platform specific,\\n * abstract method `_abstractSetPToken`\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function _setPTokenAddress(address _asset, address _pToken) internal {\\n require(assetToPToken[_asset] == address(0), \\\"pToken already set\\\");\\n require(\\n _asset != address(0) && _pToken != address(0),\\n \\\"Invalid addresses\\\"\\n );\\n\\n assetToPToken[_asset] = _pToken;\\n assetsMapped.push(_asset);\\n\\n emit PTokenAdded(_asset, _pToken);\\n\\n _abstractSetPToken(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\\n * strategy contracts, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n public\\n onlyGovernor\\n {\\n require(!supportsAsset(_asset), \\\"Cannot transfer supported asset\\\");\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @notice Set the Harvester contract that can collect rewards.\\n * @param _harvesterAddress Address of the harvester contract.\\n */\\n function setHarvesterAddress(address _harvesterAddress)\\n external\\n onlyGovernor\\n {\\n emit HarvesterAddressesUpdated(harvesterAddress, _harvesterAddress);\\n harvesterAddress = _harvesterAddress;\\n }\\n\\n /***************************************\\n Abstract\\n ****************************************/\\n\\n function _abstractSetPToken(address _asset, address _pToken)\\n internal\\n virtual;\\n\\n function safeApproveAllTokens() external virtual;\\n\\n /**\\n * @notice Deposit an amount of assets into the platform\\n * @param _asset Address for the asset\\n * @param _amount Units of asset to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external virtual;\\n\\n /**\\n * @notice Deposit all supported assets in this strategy contract to the platform\\n */\\n function depositAll() external virtual;\\n\\n /**\\n * @notice Withdraw an `amount` of assets from the platform and\\n * send to the `_recipient`.\\n * @param _recipient Address to which the asset should be sent\\n * @param _asset Address of the asset\\n * @param _amount Units of asset to withdraw\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external virtual;\\n\\n /**\\n * @notice Withdraw all supported assets from platform and\\n * sends to the OToken's Vault.\\n */\\n function withdrawAll() external virtual;\\n\\n /**\\n * @notice Get the total asset value held in the platform.\\n * This includes any interest that was generated since depositing.\\n * @param _asset Address of the asset\\n * @return balance Total value of the asset in the platform\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n virtual\\n returns (uint256 balance);\\n\\n /**\\n * @notice Check if an asset is supported.\\n * @param _asset Address of the asset\\n * @return bool Whether asset is supported\\n */\\n function supportsAsset(address _asset) public view virtual returns (bool);\\n}\\n\",\"keccak256\":\"0x5e17bb3db9f9e1014b7c5c836547f8fa81e02af7568c0bb8f2a2e0e7c2192db4\",\"license\":\"MIT\"},\"contracts/utils/InitializableERC20Detailed.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/**\\n * @dev Optional functions from the ERC20 standard.\\n * Converted from openzeppelin/contracts/token/ERC20/ERC20Detailed.sol\\n * @author Origin Protocol Inc\\n */\\nabstract contract InitializableERC20Detailed is IERC20 {\\n // Storage gap to skip storage from prior to OUSD reset\\n uint256[100] private _____gap;\\n\\n string private _name;\\n string private _symbol;\\n uint8 private _decimals;\\n\\n /**\\n * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of\\n * these values are immutable: they can only be set once during\\n * construction.\\n * @notice To avoid variable shadowing appended `Arg` after arguments name.\\n */\\n function _initialize(\\n string memory nameArg,\\n string memory symbolArg,\\n uint8 decimalsArg\\n ) internal {\\n _name = nameArg;\\n _symbol = symbolArg;\\n _decimals = decimalsArg;\\n }\\n\\n /**\\n * @notice Returns the name of the token.\\n */\\n function name() public view returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @notice Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @notice Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5,05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view returns (uint8) {\\n return _decimals;\\n }\\n}\\n\",\"keccak256\":\"0xe35ac2d813a30d845a3b52bba72588d7e936c2b3f3373d15568c14db46aeed60\",\"license\":\"MIT\"},\"contracts/utils/StableMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\n\\n// Based on StableMath from Stability Labs Pty. Ltd.\\n// https://github.com/mstable/mStable-contracts/blob/master/contracts/shared/StableMath.sol\\n\\nlibrary StableMath {\\n using SafeMath for uint256;\\n\\n /**\\n * @dev Scaling unit for use in specific calculations,\\n * where 1 * 10**18, or 1e18 represents a unit '1'\\n */\\n uint256 private constant FULL_SCALE = 1e18;\\n\\n /***************************************\\n Helpers\\n ****************************************/\\n\\n /**\\n * @dev Adjust the scale of an integer\\n * @param to Decimals to scale to\\n * @param from Decimals to scale from\\n */\\n function scaleBy(\\n uint256 x,\\n uint256 to,\\n uint256 from\\n ) internal pure returns (uint256) {\\n if (to > from) {\\n x = x.mul(10**(to - from));\\n } else if (to < from) {\\n // slither-disable-next-line divide-before-multiply\\n x = x.div(10**(from - to));\\n }\\n return x;\\n }\\n\\n /***************************************\\n Precise Arithmetic\\n ****************************************/\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncate(uint256 x, uint256 y) internal pure returns (uint256) {\\n return mulTruncateScale(x, y, FULL_SCALE);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the given scale. For example,\\n * when calculating 90% of 10e18, (10e18 * 9e17) / 1e18 = (9e36) / 1e18 = 9e18\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @param scale Scale unit\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncateScale(\\n uint256 x,\\n uint256 y,\\n uint256 scale\\n ) internal pure returns (uint256) {\\n // e.g. assume scale = fullScale\\n // z = 10e18 * 9e17 = 9e36\\n uint256 z = x.mul(y);\\n // return 9e36 / 1e18 = 9e18\\n return z.div(scale);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale, rounding up the result\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit, rounded up to the closest base unit.\\n */\\n function mulTruncateCeil(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e17 * 17268172638 = 138145381104e17\\n uint256 scaled = x.mul(y);\\n // e.g. 138145381104e17 + 9.99...e17 = 138145381113.99...e17\\n uint256 ceil = scaled.add(FULL_SCALE.sub(1));\\n // e.g. 13814538111.399...e18 / 1e18 = 13814538111\\n return ceil.div(FULL_SCALE);\\n }\\n\\n /**\\n * @dev Precisely divides two units, by first scaling the left hand operand. Useful\\n * for finding percentage weightings, i.e. 8e18/10e18 = 80% (or 8e17)\\n * @param x Left hand input to division\\n * @param y Right hand input to division\\n * @return Result after multiplying the left operand by the scale, and\\n * executing the division on the right hand input.\\n */\\n function divPrecisely(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e18 * 1e18 = 8e36\\n uint256 z = x.mul(FULL_SCALE);\\n // e.g. 8e36 / 10e18 = 8e17\\n return z.div(y);\\n }\\n}\\n\",\"keccak256\":\"0x1eb49f6f79045d9e0a8e1dced8e01d9e559e5fac554dcbb53e43140b601b04e7\",\"license\":\"MIT\"},\"contracts/vault/VaultStorage.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OToken VaultStorage contract\\n * @notice The VaultStorage contract defines the storage for the Vault contracts\\n * @author Origin Protocol Inc\\n */\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { OUSD } from \\\"../token/OUSD.sol\\\";\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\ncontract VaultStorage is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event OusdMetaStrategyUpdated(address _ousdMetaStrategy);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event NetOusdMintForStrategyThresholdChanged(uint256 _threshold);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Assets supported by the Vault, i.e. Stablecoins\\n enum UnitConversion {\\n DECIMALS,\\n GETEXCHANGERATE\\n }\\n // Changed to fit into a single storage slot so the decimals needs to be recached\\n struct Asset {\\n // Note: OETHVaultCore doesn't use `isSupported` when minting,\\n // redeeming or checking balance of assets.\\n bool isSupported;\\n UnitConversion unitConversion;\\n uint8 decimals;\\n // Max allowed slippage from the Oracle price when swapping collateral assets in basis points.\\n // For example 40 == 0.4% slippage\\n uint16 allowedOracleSlippageBps;\\n }\\n\\n /// @dev mapping of supported vault assets to their configuration\\n // slither-disable-next-line uninitialized-state\\n mapping(address => Asset) internal assets;\\n /// @dev list of all assets supported by the vault.\\n // slither-disable-next-line uninitialized-state\\n address[] internal allAssets;\\n\\n // Strategies approved for use by the Vault\\n struct Strategy {\\n bool isSupported;\\n uint256 _deprecated; // Deprecated storage slot\\n }\\n /// @dev mapping of strategy contracts to their configiration\\n mapping(address => Strategy) internal strategies;\\n /// @dev list of all vault strategies\\n address[] internal allStrategies;\\n\\n /// @notice Address of the Oracle price provider contract\\n // slither-disable-next-line uninitialized-state\\n address public priceProvider;\\n /// @notice pause rebasing if true\\n bool public rebasePaused = false;\\n /// @notice pause operations that change the OToken supply.\\n /// eg mint, redeem, allocate, mint/burn for strategy\\n bool public capitalPaused = true;\\n /// @notice Redemption fee in basis points. eg 50 = 0.5%\\n uint256 public redeemFeeBps;\\n /// @notice Percentage of assets to keep in Vault to handle (most) withdrawals. 100% = 1e18.\\n uint256 public vaultBuffer;\\n /// @notice OToken mints over this amount automatically allocate funds. 18 decimals.\\n uint256 public autoAllocateThreshold;\\n /// @notice OToken mints over this amount automatically rebase. 18 decimals.\\n uint256 public rebaseThreshold;\\n\\n /// @dev Address of the OToken token. eg OUSD or OETH.\\n // slither-disable-next-line uninitialized-state\\n OUSD internal oUSD;\\n\\n //keccak256(\\\"OUSD.vault.governor.admin.impl\\\");\\n bytes32 constant adminImplPosition =\\n 0xa2bd3d3cf188a41358c8b401076eb59066b09dec5775650c0de4c55187d17bd9;\\n\\n // Address of the contract responsible for post rebase syncs with AMMs\\n address private _deprecated_rebaseHooksAddr = address(0);\\n\\n // Deprecated: Address of Uniswap\\n // slither-disable-next-line constable-states\\n address private _deprecated_uniswapAddr = address(0);\\n\\n /// @notice Address of the Strategist\\n address public strategistAddr = address(0);\\n\\n /// @notice Mapping of asset address to the Strategy that they should automatically\\n // be allocated to\\n // slither-disable-next-line uninitialized-state\\n mapping(address => address) public assetDefaultStrategies;\\n\\n /// @notice Max difference between total supply and total value of assets. 18 decimals.\\n // slither-disable-next-line uninitialized-state\\n uint256 public maxSupplyDiff;\\n\\n /// @notice Trustee contract that can collect a percentage of yield\\n address public trusteeAddress;\\n\\n /// @notice Amount of yield collected in basis points. eg 2000 = 20%\\n uint256 public trusteeFeeBps;\\n\\n /// @dev Deprecated: Tokens that should be swapped for stablecoins\\n address[] private _deprecated_swapTokens;\\n\\n uint256 constant MINT_MINIMUM_UNIT_PRICE = 0.998e18;\\n\\n /// @notice Metapool strategy that is allowed to mint/burn OTokens without changing collateral\\n address public ousdMetaStrategy = address(0);\\n\\n /// @notice How much OTokens are currently minted by the strategy\\n int256 public netOusdMintedForStrategy = 0;\\n\\n /// @notice How much net total OTokens are allowed to be minted by all strategies\\n uint256 public netOusdMintForStrategyThreshold = 0;\\n\\n uint256 constant MIN_UNIT_PRICE_DRIFT = 0.7e18;\\n uint256 constant MAX_UNIT_PRICE_DRIFT = 1.3e18;\\n\\n /// @notice Collateral swap configuration.\\n /// @dev is packed into a single storage slot to save gas.\\n struct SwapConfig {\\n // Contract that swaps the vault's collateral assets\\n address swapper;\\n // Max allowed percentage the total value can drop below the total supply in basis points.\\n // For example 100 == 1%\\n uint16 allowedUndervalueBps;\\n }\\n SwapConfig internal swapConfig = SwapConfig(address(0), 0);\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /**\\n * @notice set the implementation for the admin, this needs to be in a base class else we cannot set it\\n * @param newImpl address of the implementation\\n */\\n function setAdminImpl(address newImpl) external onlyGovernor {\\n require(\\n Address.isContract(newImpl),\\n \\\"new implementation is not a contract\\\"\\n );\\n bytes32 position = adminImplPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newImpl)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xbcefeb5e2b88d99a54dbe6542dc25d0a68eeaf3adfe6e12fb70049cc024b1a79\",\"license\":\"MIT\"}},\"version\":1}", - "bytecode": "0x610180604052600060685560006069556000606a553480156200002157600080fd5b5060405162004ce338038062004ce3833981016040819052620000449162000147565b8585876020015183868383838362000062336200011760201b60201c565b60008051602062004cc3833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36033805460ff191690556001600160601b0319606094851b811660805291841b821660a052831b811660c05290821b811660e0528651821b811661010052602090960151811b86166101205298891b851661014052505050509190931b1661016052506200022292505050565b60008051602062004cc383398151915255565b80516001600160a01b03811681146200014257600080fd5b919050565b60008060008060008086880360e08112156200016257600080fd5b60408112156200017157600080fd5b50604080519081016001600160401b0381118282101715620001a357634e487b7160e01b600052604160045260246000fd5b604052620001b1886200012a565b8152620001c1602089016200012a565b60208201529550620001d6604088016200012a565b9450620001e6606088016200012a565b9350620001f6608088016200012a565b92506200020660a088016200012a565b91506200021660c088016200012a565b90509295509295509295565b60805160601c60a05160601c60c05160601c60e05160601c6101005160601c6101205160601c6101405160601c6101605160601c614904620003bf600039600081816102c2015281816109b301526132ee01526000818161059801526127ba01526000818161046c01528181610db601528181611d0301528181611e7c01528181612b9b0152612e230152600061097f0152600081816106f101528181610b4e01528181611b4001528181611c010152818161231601526125650152600081816109fc01528181610c540152818161172b0152818161278a015281816128a20152612d190152600081816108cb015261147c0152600081816102f4015281816104f6015281816107c201528181610ab501528181610e2b01528181610ffa01528181611082015281816112310152818161130c0152818161192201528181611ab001528181611b6f01528181611ded01528181611e9d0152818161229001528181612345015281816124df0152818161259401528181612eae01528181612f3d015281816133f30152818161347801526134ec01526149046000f3fe6080604052600436106102b25760003560e01c8063853828b611610175578063c2e1e3f4116100dc578063d9caed1211610095578063dd505df61161006f578063dd505df6146109a1578063de5f6268146109d5578063f1188e40146109ea578063f6ca71b014610a1e57600080fd5b8063d9caed121461092d578063d9f00ec71461094d578063dbe55e561461096d57600080fd5b8063c2e1e3f414610867578063c7af335214610887578063c98517c51461089c578063cceab750146108b9578063d38bfff4146108ed578063d5c360f61461090d57600080fd5b8063a4f98af41161012e578063a4f98af414610790578063aa388af6146107a5578063ab12edf5146107f2578063ad1728cb14610812578063af37dcbe14610827578063bb1b918d1461084757600080fd5b8063853828b6146106a557806387bae867146106ba5780639092c31c146106df5780639136616a1461071357806396d538bb146107335780639da0e4621461075357600080fd5b80635c975abb116102195780636ef38795116101d25780636ef38795146105fa57806371a735f31461061a5780637b2d9b2c1461063a5780637e20fffa1461065a578063842f5c461461067a5780638456cb591461069057600080fd5b80635c975abb1461052d5780635d36b190146105515780635f515226146105665780636093d3801461058657806367c7066c146105ba5780636e811d38146105da57600080fd5b8063430bf08a1161026b578063430bf08a1461045a578063435356d11461048e57806347e7ef24146104ae578063484be812146104ce578063579a7e1a146104e45780635a063f631461051857600080fd5b80630c340a241461036e5780630ed57b3a146103a05780630fc3b4c4146103c05780631072cbea146103f657806322495dc8146104165780633c8649591461043657600080fd5b3661036957336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614806103165750336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016145b6103675760405162461bcd60e51b815260206004820152601e60248201527f657468206e6f742066726f6d20616c6c6f77656420636f6e747261637473000060448201526064015b60405180910390fd5b005b600080fd5b34801561037a57600080fd5b50610383610a40565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156103ac57600080fd5b506103676103bb366004613ce6565b610a5d565b3480156103cc57600080fd5b506103836103db366004613cac565b60a0602052600090815260409020546001600160a01b031681565b34801561040257600080fd5b50610367610411366004613d60565b610a8f565b34801561042257600080fd5b50610367610431366004613e54565b610b4c565b34801561044257600080fd5b5061044c60695481565b604051908152602001610397565b34801561046657600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b34801561049a57600080fd5b506103676104a9366004613dcd565b610cc6565b3480156104ba57600080fd5b506103676104c9366004613d60565b610dab565b3480156104da57600080fd5b5061044c606a5481565b3480156104f057600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b34801561052457600080fd5b50610367610eb1565b34801561053957600080fd5b5060335460ff165b6040519015158152602001610397565b34801561055d57600080fd5b50610367610f50565b34801561057257600080fd5b5061044c610581366004613cac565b610ff6565b34801561059257600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156105c657600080fd5b5060a454610383906001600160a01b031681565b3480156105e657600080fd5b506103676105f5366004613cac565b61112a565b34801561060657600080fd5b50610367610615366004613d8c565b6111b2565b34801561062657600080fd5b50610367610635366004614062565b611634565b34801561064657600080fd5b50610383610655366004613f2a565b61182d565b34801561066657600080fd5b5061036761067536600461411e565b611857565b34801561068657600080fd5b5061044c60685481565b34801561069c57600080fd5b50610367611bff565b3480156106b157600080fd5b50610367611cf8565b3480156106c657600080fd5b506033546103839061010090046001600160a01b031681565b3480156106eb57600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b34801561071f57600080fd5b5061036761072e366004613f2a565b611eca565b34801561073f57600080fd5b5061036761074e366004613d8c565b612095565b34801561075f57600080fd5b5061078361076e366004613f2a565b60356020526000908152604090205460ff1681565b6040516103979190614565565b34801561079c57600080fd5b506105416121b5565b3480156107b157600080fd5b506105416107c0366004613cac565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811691161490565b3480156107fe57600080fd5b5061036761080d3660046140fc565b612677565b34801561081e57600080fd5b50610367612773565b34801561083357600080fd5b50606b54610383906001600160a01b031681565b34801561085357600080fd5b50610367610862366004613fae565b612839565b34801561087357600080fd5b50610367610882366004613cac565b6129ac565b34801561089357600080fd5b50610541612a39565b3480156108a857600080fd5b5061044c6801bc16d674ec80000081565b3480156108c557600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156108f957600080fd5b50610367610908366004613cac565b612a6a565b34801561091957600080fd5b50610367610928366004613cac565b612b0e565b34801561093957600080fd5b50610367610948366004613d1f565b612b90565b34801561095957600080fd5b50610367610968366004613f43565b612c23565b34801561097957600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156109ad57600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156109e157600080fd5b50610367612e18565b3480156109f657600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b348015610a2a57600080fd5b50610a33612f62565b604051610397919061433b565b6000610a586000805160206148af8339815191525490565b905090565b610a65612a39565b610a815760405162461bcd60e51b815260040161035e906145d7565b610a8b8282612fc4565b5050565b610a97612a39565b610ab35760405162461bcd60e51b815260040161035e906145d7565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b039081169083161415610b305760405162461bcd60e51b815260206004820152601f60248201527f43616e6e6f74207472616e7366657220737570706f7274656420617373657400604482015260640161035e565b610a8b610b3b610a40565b6001600160a01b0384169083613123565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015610ba557600080fd5b505afa158015610bb9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bdd9190613cc9565b6001600160a01b0316336001600160a01b031614610c3d5760405162461bcd60e51b815260206004820152601c60248201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604482015260640161035e565b60405163bc26e7e560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063bc26e7e590610c8f90309087908790879060040161428b565b600060405180830381600087803b158015610ca957600080fd5b505af1158015610cbd573d6000803e3d6000fd5b50505050505050565b610cce612a39565b610cea5760405162461bcd60e51b815260040161035e906145d7565b600054610100900460ff1680610d03575060005460ff16155b610d665760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161035e565b600054610100900460ff16158015610d88576000805461ffff19166101011790555b610d9384848461317a565b8015610da5576000805461ff00191690555b50505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610df35760405162461bcd60e51b815260040161035e906145a0565b60008051602061488f83398151915280546002811415610e255760405162461bcd60e51b815260040161035e9061466f565b600282557f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614610e9e5760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b604482015260640161035e565b610ea88484613235565b50600190555050565b60a4546001600160a01b03163314610f0b5760405162461bcd60e51b815260206004820152601b60248201527f43616c6c6572206973206e6f7420746865204861727665737465720000000000604482015260640161035e565b60008051602061488f83398151915280546002811415610f3d5760405162461bcd60e51b815260040161035e9061466f565b60028255610f496132c7565b5060019055565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610feb5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b606482015260840161035e565b610ff433613515565b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b03161461106d5760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b604482015260640161035e565b6040516370a0823160e01b81523060048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156110cc57600080fd5b505afa1580156110e0573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061110491906140e3565b60345461111a906801bc16d674ec800000614780565b6111249190614746565b92915050565b611132612a39565b61114e5760405162461bcd60e51b815260040161035e906145d7565b6040516001600160a01b03821681527f83f29c79feb71f8fba9d0fbc4ba5f0982a28b6b1e868b3fc50e6400d100bca0f9060200160405180910390a1603380546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60335461010090046001600160a01b031633146111e15760405162461bcd60e51b815260040161035e90614638565b60335460ff16156112045760405162461bcd60e51b815260040161035e9061460e565b6000611219826801bc16d674ec800000614780565b6040516370a0823160e01b81523060048201529091507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561127b57600080fd5b505afa15801561128f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112b391906140e3565b8111156112f65760405162461bcd60e51b81526020600482015260116024820152700d2dce6eaccccd2c6d2cadce840ae8aa89607b1b604482015260640161035e565b604051632e1a7d4d60e01b8152600481018290527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690632e1a7d4d90602401600060405180830381600087803b15801561135857600080fd5b505af115801561136c573d6000803e3d6000fd5b5050505060005b82811015610da557600084848381811061138f5761138f61483f565b90506020028101906113a191906146dd565b6113ab9080614697565b6040516113b992919061425f565b6040805191829003909120600081815260356020529182205490925060ff16908160038111156113eb576113eb614813565b146114385760405162461bcd60e51b815260206004820152601860248201527f56616c696461746f72206e6f7420726567697374657265640000000000000000604482015260640161035e565b60408051600160f81b60208201526000602182018190526bffffffffffffffffffffffff193060601b16602c830152910160405160208183030381529060405290507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663228951188888878181106114bb576114bb61483f565b90506020028101906114cd91906146dd565b6114d79080614697565b848b8b8a8181106114ea576114ea61483f565b90506020028101906114fc91906146dd565b61150a906020810190614697565b8d8d8c81811061151c5761151c61483f565b905060200281019061152e91906146dd565b604001356040518763ffffffff1660e01b8152600401611553969594939291906144ea565b600060405180830381600087803b15801561156d57600080fd5b505af1158015611581573d6000803e3d6000fd5b505050506001603460008282546115989190614746565b909155507ffeb31a79d38edb1b090d516e4df3e273651179c6f2c2ec53a9a22ae015b70ba990508787868181106115d1576115d161483f565b90506020028101906115e391906146dd565b6115ed9080614697565b6801bc16d674ec800000846040516116089493929190614539565b60405180910390a150506000908152603560205260409020805460ff1916600190811790915501611373565b60335461010090046001600160a01b031633146116635760405162461bcd60e51b815260040161035e90614638565b60335460ff16156116865760405162461bcd60e51b815260040161035e9061460e565b600060356000878760405161169c92919061425f565b604080519182900390912082526020820192909252016000205460ff16905060028160038111156116cf576116cf614813565b146117145760405162461bcd60e51b815260206004820152601560248201527456616c696461746f72206e6f742065786974696e6760581b604482015260640161035e565b6040516312b3fc1960e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906312b3fc199061176890899089908990899089906004016144a9565b600060405180830381600087803b15801561178257600080fd5b505af1158015611796573d6000803e3d6000fd5b505050507ff72821b8777f002ccdf6326f1242d9e0f762eb077668b67bebe640535378066d868686866040516117cf9493929190614420565b60405180910390a160036035600088886040516117ed92919061425f565b60408051918290039091208252602082019290925201600020805460ff1916600183600381111561182057611820614813565b0217905550505050505050565b60a5818154811061183d57600080fd5b6000918252602090912001546001600160a01b0316905081565b606b546001600160a01b031633146118bf5760405162461bcd60e51b815260206004820152602560248201527f43616c6c6572206973206e6f7420746865204163636f756e74696e6720476f7660448201526432b93737b960d91b606482015260840161035e565b60335460ff166119085760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b604482015260640161035e565b6040516370a0823160e01b815230600482015247906000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561196c57600080fd5b505afa158015611980573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119a491906140e3565b90508382111580156119b65750828111155b611a025760405162461bcd60e51b815260206004820152601960248201527f6f766572206163636f756e74696e67207468726573686f6c6400000000000000604482015260640161035e565b60345460685460408051928352602083018b9052820152606081018690526080810188905260a081018790527fb2c41d2aedabd456081f30f3b116ce88de1c795a7d4ca787fef373a393f3c5db9060c00160405180910390a1603488905560688590558615611b235781871115611aae5760405162461bcd60e51b815260206004820152601060248201526f0d2dce6eaccccd2c6d2cadce8408aa8960831b604482015260640161035e565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0886040518263ffffffff1660e01b81526004016000604051808303818588803b158015611b0957600080fd5b505af1158015611b1d573d6000803e3d6000fd5b50505050505b8515611bed5760405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018890527f0000000000000000000000000000000000000000000000000000000000000000169063a9059cbb90604401602060405180830381600087803b158015611bb357600080fd5b505af1158015611bc7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611beb9190613f0d565b505b611bf56135d6565b5050505050505050565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015611c5857600080fd5b505afa158015611c6c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c909190613cc9565b6001600160a01b0316336001600160a01b031614611cf05760405162461bcd60e51b815260206004820152601c60248201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604482015260640161035e565b610ff4613669565b336001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161480611d475750611d32610a40565b6001600160a01b0316336001600160a01b0316145b611d9f5760405162461bcd60e51b815260206004820152602360248201527f43616c6c6572206973206e6f7420746865205661756c74206f7220476f7665726044820152623737b960e91b606482015260840161035e565b60008051602061488f83398151915280546002811415611dd15760405162461bcd60e51b815260040161035e9061466f565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b158015611e3757600080fd5b505afa158015611e4b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e6f91906140e3565b90508015611ec257611ec27f00000000000000000000000000000000000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000836136c1565b505060019055565b611ed2612a39565b611eee5760405162461bcd60e51b815260040161035e906145d7565b60a1548110611f2f5760405162461bcd60e51b815260206004820152600d60248201526c092dcecc2d8d2c840d2dcc8caf609b1b604482015260640161035e565b600060a18281548110611f4457611f4461483f565b60009182526020808320909101546001600160a01b0390811680845260a090925260409092205460a15491935090911690611f819060019061479f565b8310156120035760a18054611f989060019061479f565b81548110611fa857611fa861483f565b60009182526020909120015460a180546001600160a01b039092169185908110611fd457611fd461483f565b9060005260206000200160006101000a8154816001600160a01b0302191690836001600160a01b031602179055505b60a180548061201457612014614829565b60008281526020808220600019908401810180546001600160a01b031990811690915593019093556001600160a01b0385811680835260a0855260409283902080549094169093559051908416815290917f16b7600acff27e39a8a96056b3d533045298de927507f5c1d97e4accde60488c910160405180910390a2505050565b61209d612a39565b6120b95760405162461bcd60e51b815260040161035e906145d7565b8060005b8181101561216c5760008484838181106120d9576120d961483f565b90506020020160208101906120ee9190613cac565b6001600160a01b0316141561215c5760405162461bcd60e51b815260206004820152602e60248201527f43616e206e6f742073657420616e20656d70747920616464726573732061732060448201526d30903932bbb0b932103a37b5b2b760911b606482015260840161035e565b612165816147e2565b90506120bd565b507f04c0b9649497d316554306e53678d5f5f5dbc3a06f97dec13ff4cfe98b986bbc60a584846040516121a193929190614388565b60405180910390a1610da560a58484613a05565b60335460009061010090046001600160a01b031633146121e75760405162461bcd60e51b815260040161035e90614638565b60335460ff161561220a5760405162461bcd60e51b815260040161035e9061460e565b6068544710156122225761221c613669565b50600090565b600060685447612232919061479f565b9050600191506801bc16d674ec800000811061240d57600061225d6801bc16d674ec8000008361475e565b90508060346000828254612271919061479f565b909155506000905061228c826801bc16d674ec800000614780565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b1580156122e957600080fd5b505af11580156122fd573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b15801561238d57600080fd5b505af11580156123a1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123c59190613f0d565b5060345460408051848152602081019290925281018290527fbe7040030ff7b347853214bf49820c6d455fedf58f3815f85c7bc5216993682b9060600160405180910390a150505b60006068544761241d919061479f565b90506801bc16d674ec800000811061246f5760405162461bcd60e51b8152602060048201526015602482015274756e6578706563746564206163636f756e74696e6760581b604482015260640161035e565b8061247957505090565b6069548110156124d35780606860008282546124959190614746565b90915550506040518181527f7a745a2c63a535068f52ceca27debd5297bbad5f7f37ec53d044a59d0362445d906020015b60405180910390a1505090565b606a54811115612666577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561253857600080fd5b505af115801561254c573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b1580156125dc57600080fd5b505af11580156125f0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906126149190613f0d565b50600160346000828254612628919061479f565b909155505060345460408051918252602082018390527f6aa7e30787b26429ced603a7aba8b19c4b5d5bcf29a3257da953c8d53bcaa3a691016124c6565b61266e613669565b60009250505090565b61267f612a39565b61269b5760405162461bcd60e51b815260040161035e906145d7565b80821080156126b257506801bc16d674ec80000082105b80156126c657506801bc16d674ec80000081105b80156126e35750673782dace9d9000006126e0838361479f565b10155b61272f5760405162461bcd60e51b815260206004820152601760248201527f696e636f7272656374206675736520696e74657276616c000000000000000000604482015260640161035e565b60408051838152602081018390527fcb8d24e46eb3c402bf344ee60a6576cba9ef2f59ea1af3b311520704924e901a910160405180910390a1606991909155606a55565b60405163095ea7b360e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116600483015260001960248301527f0000000000000000000000000000000000000000000000000000000000000000169063095ea7b390604401602060405180830381600087803b1580156127fe57600080fd5b505af1158015612812573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906128369190613f0d565b50565b60335461010090046001600160a01b031633146128685760405162461bcd60e51b815260040161035e90614638565b60335460ff161561288b5760405162461bcd60e51b815260040161035e9061460e565b6040516301ba3ee760e21b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906306e8fb9c906128e5908b908b908b908b908b908b908b908b90600401614447565b600060405180830381600087803b1580156128ff57600080fd5b505af1158015612913573d6000803e3d6000fd5b505050506000603560008a8a60405161292d92919061425f565b60408051918290039091208252602082019290925201600020805460ff1916600183600381111561296057612960614813565b02179055507f75c4a66b2c6c28cf46db7131182a812e4fbbb2f0591377aa83a737909a9b68c38888888860405161299a9493929190614420565b60405180910390a15050505050505050565b6129b4612a39565b6129d05760405162461bcd60e51b815260040161035e906145d7565b60a454604080516001600160a01b03928316815291831660208301527fe48386b84419f4d36e0f96c10cc3510b6fb1a33795620c5098b22472bbe90796910160405180910390a160a480546001600160a01b0319166001600160a01b0392909216919091179055565b6000612a516000805160206148af8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b612a72612a39565b612a8e5760405162461bcd60e51b815260040161035e906145d7565b612ab6817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b0316612ad66000805160206148af8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b612b16612a39565b612b325760405162461bcd60e51b815260040161035e906145d7565b6040516001600160a01b03821681527ff3dd2b598e2a94dd3f46b414f7c960f8e10a0b0efd00df97d27cdd0fee5c87539060200160405180910390a1606b80546001600160a01b0319166001600160a01b0392909216919091179055565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614612bd85760405162461bcd60e51b815260040161035e906145a0565b60008051602061488f83398151915280546002811415612c0a5760405162461bcd60e51b815260040161035e9061466f565b60028255612c198585856136c1565b5060019055505050565b60335461010090046001600160a01b03163314612c525760405162461bcd60e51b815260040161035e90614638565b60335460ff1615612c755760405162461bcd60e51b815260040161035e9061460e565b6000603560008686604051612c8b92919061425f565b604080519182900390912082526020820192909252016000205460ff1690506001816003811115612cbe57612cbe614813565b14612d025760405162461bcd60e51b815260206004820152601460248201527315985b1a59185d1bdc881b9bdd081cdd185ad95960621b604482015260640161035e565b604051633877322b60e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633877322b90612d54908890889088908890600401614420565b600060405180830381600087803b158015612d6e57600080fd5b505af1158015612d82573d6000803e3d6000fd5b505050507ff8821da16f5ed966b41e0343c3eff9903af782d74f99f1689dd9d4562b6545b385858585604051612dbb9493929190614420565b60405180910390a16002603560008787604051612dd992919061425f565b60408051918290039091208252602082019290925201600020805460ff19166001836003811115612e0c57612e0c614813565b02179055505050505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614612e605760405162461bcd60e51b815260040161035e906145a0565b60008051602061488f83398151915280546002811415612e925760405162461bcd60e51b815260040161035e9061466f565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b158015612ef857600080fd5b505afa158015612f0c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f3091906140e3565b90508015611ec257611ec27f000000000000000000000000000000000000000000000000000000000000000082613235565b606060a5805480602002602001604051908101604052809291908181526020018280548015612fba57602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612f9c575b5050505050905090565b6001600160a01b03828116600090815260a0602052604090205416156130215760405162461bcd60e51b81526020600482015260126024820152711c151bdad95b88185b1c9958591e481cd95d60721b604482015260640161035e565b6001600160a01b0382161580159061304157506001600160a01b03811615155b6130815760405162461bcd60e51b8152602060048201526011602482015270496e76616c69642061646472657373657360781b604482015260640161035e565b6001600160a01b03828116600081815260a06020908152604080832080549587166001600160a01b0319968716811790915560a1805460018101825594527faadc37b8ba5645e62f4546802db221593a94729ccbfc5a97d01365a88f64987890930180549095168417909455925190815290917fef6485b84315f9b1483beffa32aae9a0596890395e3d7521f1c5fbb51790e765910160405180910390a25050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b1790526131759084906137b9565b505050565b825161318d9060a5906020860190613a68565b508151815181146131d75760405162461bcd60e51b8152602060048201526014602482015273496e76616c696420696e7075742061727261797360601b604482015260640161035e565b60005b8181101561322e5761321e8482815181106131f7576131f761483f565b60200260200101518483815181106132115761321161483f565b6020026020010151612fc4565b613227816147e2565b90506131da565b5050505050565b6000811161327e5760405162461bcd60e51b81526020600482015260166024820152754d757374206465706f73697420736f6d657468696e6760501b604482015260640161035e565b6040805160008152602081018390526001600160a01b038416917f5548c837ab068cf56a2c2479df0882a4922fd203edb7517321831d95078c5f62910160405180910390a25050565b60335460ff16156132ea5760405162461bcd60e51b815260040161035e9061460e565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663e52253816040518163ffffffff1660e01b8152600401602060405180830381600087803b15801561334757600080fd5b505af115801561335b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061337f91906140e3565b90506000606854826133919190614746565b9050804710156133e35760405162461bcd60e51b815260206004820152601860248201527f696e73756666696369656e74206574682062616c616e63650000000000000000604482015260640161035e565b8015610a8b5760006068819055507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561344c57600080fd5b505af1158015613460573d6000803e3d6000fd5b505060a454604080516001600160a01b0392831681527f0000000000000000000000000000000000000000000000000000000000000000909216602083015281018590527ff6c07a063ed4e63808eb8da7112d46dbcd38de2b40a73dbcc9353c5a94c72353935060600191506134d39050565b60405180910390a160a454610a8b906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116911683613123565b6001600160a01b03811661356b5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f722069732061646472657373283029000000000000604482015260640161035e565b806001600160a01b031661358b6000805160206148af8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a3612836816000805160206148af83398151915255565b60335460ff1661361f5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b604482015260640161035e565b6033805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b60335460ff161561368c5760405162461bcd60e51b815260040161035e9061460e565b6033805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25861364c3390565b600081116137115760405162461bcd60e51b815260206004820152601760248201527f4d75737420776974686472617720736f6d657468696e67000000000000000000604482015260640161035e565b6001600160a01b0383166137605760405162461bcd60e51b8152602060048201526016602482015275135d5cdd081cdc1958da599e481c9958da5c1a595b9d60521b604482015260640161035e565b6040805160008152602081018390526001600160a01b038416917f2717ead6b9200dd235aad468c9809ea400fe33ac69b5bfaa6d3e90fc922b6398910160405180910390a26131756001600160a01b0383168483613123565b600061380e826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661388b9092919063ffffffff16565b805190915015613175578080602001905181019061382c9190613f0d565b6131755760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161035e565b606061389a84846000856138a4565b90505b9392505050565b6060824710156139055760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161035e565b843b6139535760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161035e565b600080866001600160a01b0316858760405161396f919061426f565b60006040518083038185875af1925050503d80600081146139ac576040519150601f19603f3d011682016040523d82523d6000602084013e6139b1565b606091505b50915091506139c18282866139cc565b979650505050505050565b606083156139db57508161389d565b8251156139eb5782518084602001fd5b8160405162461bcd60e51b815260040161035e919061458d565b828054828255906000526020600020908101928215613a58579160200282015b82811115613a585781546001600160a01b0319166001600160a01b03843516178255602090920191600190910190613a25565b50613a64929150613abd565b5090565b828054828255906000526020600020908101928215613a58579160200282015b82811115613a5857825182546001600160a01b0319166001600160a01b03909116178255602090920191600190910190613a88565b5b80821115613a645760008155600101613abe565b60008083601f840112613ae457600080fd5b5081356001600160401b03811115613afb57600080fd5b6020830191508360208260051b8501011115613b1657600080fd5b9250929050565b600082601f830112613b2e57600080fd5b81356020613b43613b3e83614723565b6146f3565b80838252828201915082860187848660051b8901011115613b6357600080fd5b60005b85811015613b8b578135613b798161486b565b84529284019290840190600101613b66565b5090979650505050505050565b60008083601f840112613baa57600080fd5b5081356001600160401b03811115613bc157600080fd5b602083019150836020828501011115613b1657600080fd5b600060a08284031215613beb57600080fd5b50919050565b600060a08284031215613c0357600080fd5b60405160a081018181106001600160401b0382111715613c2557613c25614855565b604052905080613c3483613c7c565b8152613c4260208401613c95565b6020820152613c5360408401613c95565b60408201526060830135613c6681614880565b6060820152608092830135920191909152919050565b803563ffffffff81168114613c9057600080fd5b919050565b80356001600160401b0381168114613c9057600080fd5b600060208284031215613cbe57600080fd5b813561389d8161486b565b600060208284031215613cdb57600080fd5b815161389d8161486b565b60008060408385031215613cf957600080fd5b8235613d048161486b565b91506020830135613d148161486b565b809150509250929050565b600080600060608486031215613d3457600080fd5b8335613d3f8161486b565b92506020840135613d4f8161486b565b929592945050506040919091013590565b60008060408385031215613d7357600080fd5b8235613d7e8161486b565b946020939093013593505050565b60008060208385031215613d9f57600080fd5b82356001600160401b03811115613db557600080fd5b613dc185828601613ad2565b90969095509350505050565b600080600060608486031215613de257600080fd5b83356001600160401b0380821115613df957600080fd5b613e0587838801613b1d565b94506020860135915080821115613e1b57600080fd5b613e2787838801613b1d565b93506040860135915080821115613e3d57600080fd5b50613e4a86828701613b1d565b9150509250925092565b600080600060e08486031215613e6957600080fd5b83356001600160401b03811115613e7f57600080fd5b8401601f81018613613e9057600080fd5b80356020613ea0613b3e83614723565b8083825282820191508285018a848660051b8801011115613ec057600080fd5b600095505b84861015613eea57613ed681613c95565b835260019590950194918301918301613ec5565b509650508601359350613f04915086905060408601613bf1565b90509250925092565b600060208284031215613f1f57600080fd5b815161389d81614880565b600060208284031215613f3c57600080fd5b5035919050565b60008060008060408587031215613f5957600080fd5b84356001600160401b0380821115613f7057600080fd5b613f7c88838901613b98565b90965094506020870135915080821115613f9557600080fd5b50613fa287828801613ad2565b95989497509550505050565b600080600080600080600080610120898b031215613fcb57600080fd5b88356001600160401b0380821115613fe257600080fd5b613fee8c838d01613b98565b909a50985060208b013591508082111561400757600080fd5b6140138c838d01613ad2565b909850965060408b013591508082111561402c57600080fd5b506140398b828c01613b98565b909550935050606089013591506140538a60808b01613bd9565b90509295985092959890939650565b600080600080600060e0868803121561407a57600080fd5b85356001600160401b038082111561409157600080fd5b61409d89838a01613b98565b909750955060208801359150808211156140b657600080fd5b506140c388828901613ad2565b90945092506140d790508760408801613bd9565b90509295509295909350565b6000602082840312156140f557600080fd5b5051919050565b6000806040838503121561410f57600080fd5b50508035926020909101359150565b60008060008060008060c0878903121561413757600080fd5b505084359660208601359650604086013595606081013595506080810135945060a0013592509050565b8183526000602080850194508260005b8581101561419d576001600160401b0361418a83613c95565b1687529582019590820190600101614171565b509495945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b600081518084526141e98160208601602086016147b6565b601f01601f19169290920160200192915050565b63ffffffff61420b82613c7c565b16825261421a60208201613c95565b6001600160401b0380821660208501528061423760408501613c95565b1660408501525050606081013561424d81614880565b15156060830152608090810135910152565b8183823760009101908152919050565b600082516142818184602087016147b6565b9190910192915050565b6001600160a01b03851681526101006020808301829052855191830182905260009161012084019187810191845b818110156142de5783516001600160401b0316855293820193928201926001016142b9565b505082935086604086015263ffffffff865116606086015280860151925050506001600160401b0380821660808501528060408601511660a085015250506060830151151560c0830152608083015160e083015295945050505050565b6020808252825182820181905260009190848201906040850190845b8181101561437c5783516001600160a01b031683529284019291840191600101614357565b50909695505050505050565b6000604082016040835280865480835260608501915087600052602092508260002060005b828110156143d25781546001600160a01b0316845292840192600191820191016143ad565b505050838103828501528481528590820160005b868110156144145782356143f98161486b565b6001600160a01b0316825291830191908301906001016143e6565b50979650505050505050565b6040815260006144346040830186886141a8565b82810360208401526139c1818587614161565b600061012080835261445c8184018b8d6141a8565b9050828103602084015261447181898b614161565b905082810360408401526144868187896141a8565b91505083606083015261449c60808301846141fd565b9998505050505050505050565b60e0815260006144bd60e0830187896141a8565b82810360208401526144d0818688614161565b9150506144e060408301846141fd565b9695505050505050565b6080815260006144fe60808301888a6141a8565b828103602084015261451081886141d1565b905082810360408401526145258186886141a8565b915050826060830152979650505050505050565b60608152600061454d6060830186886141a8565b84602084015282810360408401526139c181856141d1565b602081016004831061458757634e487b7160e01b600052602160045260246000fd5b91905290565b60208152600061389d60208301846141d1565b60208082526017908201527f43616c6c6572206973206e6f7420746865205661756c74000000000000000000604082015260600190565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60208082526010908201526f14185d5cd8589b194e881c185d5cd95960821b604082015260600190565b6020808252601d908201527f43616c6c6572206973206e6f7420746865205265676973747261746f72000000604082015260600190565b6020808252600e908201526d1499595b9d1c985b9d0818d85b1b60921b604082015260600190565b6000808335601e198436030181126146ae57600080fd5b8301803591506001600160401b038211156146c857600080fd5b602001915036819003821315613b1657600080fd5b60008235605e1983360301811261428157600080fd5b604051601f8201601f191681016001600160401b038111828210171561471b5761471b614855565b604052919050565b60006001600160401b0382111561473c5761473c614855565b5060051b60200190565b60008219821115614759576147596147fd565b500190565b60008261477b57634e487b7160e01b600052601260045260246000fd5b500490565b600081600019048311821515161561479a5761479a6147fd565b500290565b6000828210156147b1576147b16147fd565b500390565b60005b838110156147d15781810151838201526020016147b9565b83811115610da55750506000910152565b60006000198214156147f6576147f66147fd565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b6001600160a01b038116811461283657600080fd5b801515811461283657600080fdfe53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac45357bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212204292636866460b0a0ebdd872cc7401407e5a3bdd212181fd3cea747a97b6379e64736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", - "deployedBytecode": "0x6080604052600436106102b25760003560e01c8063853828b611610175578063c2e1e3f4116100dc578063d9caed1211610095578063dd505df61161006f578063dd505df6146109a1578063de5f6268146109d5578063f1188e40146109ea578063f6ca71b014610a1e57600080fd5b8063d9caed121461092d578063d9f00ec71461094d578063dbe55e561461096d57600080fd5b8063c2e1e3f414610867578063c7af335214610887578063c98517c51461089c578063cceab750146108b9578063d38bfff4146108ed578063d5c360f61461090d57600080fd5b8063a4f98af41161012e578063a4f98af414610790578063aa388af6146107a5578063ab12edf5146107f2578063ad1728cb14610812578063af37dcbe14610827578063bb1b918d1461084757600080fd5b8063853828b6146106a557806387bae867146106ba5780639092c31c146106df5780639136616a1461071357806396d538bb146107335780639da0e4621461075357600080fd5b80635c975abb116102195780636ef38795116101d25780636ef38795146105fa57806371a735f31461061a5780637b2d9b2c1461063a5780637e20fffa1461065a578063842f5c461461067a5780638456cb591461069057600080fd5b80635c975abb1461052d5780635d36b190146105515780635f515226146105665780636093d3801461058657806367c7066c146105ba5780636e811d38146105da57600080fd5b8063430bf08a1161026b578063430bf08a1461045a578063435356d11461048e57806347e7ef24146104ae578063484be812146104ce578063579a7e1a146104e45780635a063f631461051857600080fd5b80630c340a241461036e5780630ed57b3a146103a05780630fc3b4c4146103c05780631072cbea146103f657806322495dc8146104165780633c8649591461043657600080fd5b3661036957336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614806103165750336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016145b6103675760405162461bcd60e51b815260206004820152601e60248201527f657468206e6f742066726f6d20616c6c6f77656420636f6e747261637473000060448201526064015b60405180910390fd5b005b600080fd5b34801561037a57600080fd5b50610383610a40565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156103ac57600080fd5b506103676103bb366004613ce6565b610a5d565b3480156103cc57600080fd5b506103836103db366004613cac565b60a0602052600090815260409020546001600160a01b031681565b34801561040257600080fd5b50610367610411366004613d60565b610a8f565b34801561042257600080fd5b50610367610431366004613e54565b610b4c565b34801561044257600080fd5b5061044c60695481565b604051908152602001610397565b34801561046657600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b34801561049a57600080fd5b506103676104a9366004613dcd565b610cc6565b3480156104ba57600080fd5b506103676104c9366004613d60565b610dab565b3480156104da57600080fd5b5061044c606a5481565b3480156104f057600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b34801561052457600080fd5b50610367610eb1565b34801561053957600080fd5b5060335460ff165b6040519015158152602001610397565b34801561055d57600080fd5b50610367610f50565b34801561057257600080fd5b5061044c610581366004613cac565b610ff6565b34801561059257600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156105c657600080fd5b5060a454610383906001600160a01b031681565b3480156105e657600080fd5b506103676105f5366004613cac565b61112a565b34801561060657600080fd5b50610367610615366004613d8c565b6111b2565b34801561062657600080fd5b50610367610635366004614062565b611634565b34801561064657600080fd5b50610383610655366004613f2a565b61182d565b34801561066657600080fd5b5061036761067536600461411e565b611857565b34801561068657600080fd5b5061044c60685481565b34801561069c57600080fd5b50610367611bff565b3480156106b157600080fd5b50610367611cf8565b3480156106c657600080fd5b506033546103839061010090046001600160a01b031681565b3480156106eb57600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b34801561071f57600080fd5b5061036761072e366004613f2a565b611eca565b34801561073f57600080fd5b5061036761074e366004613d8c565b612095565b34801561075f57600080fd5b5061078361076e366004613f2a565b60356020526000908152604090205460ff1681565b6040516103979190614565565b34801561079c57600080fd5b506105416121b5565b3480156107b157600080fd5b506105416107c0366004613cac565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811691161490565b3480156107fe57600080fd5b5061036761080d3660046140fc565b612677565b34801561081e57600080fd5b50610367612773565b34801561083357600080fd5b50606b54610383906001600160a01b031681565b34801561085357600080fd5b50610367610862366004613fae565b612839565b34801561087357600080fd5b50610367610882366004613cac565b6129ac565b34801561089357600080fd5b50610541612a39565b3480156108a857600080fd5b5061044c6801bc16d674ec80000081565b3480156108c557600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156108f957600080fd5b50610367610908366004613cac565b612a6a565b34801561091957600080fd5b50610367610928366004613cac565b612b0e565b34801561093957600080fd5b50610367610948366004613d1f565b612b90565b34801561095957600080fd5b50610367610968366004613f43565b612c23565b34801561097957600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156109ad57600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b3480156109e157600080fd5b50610367612e18565b3480156109f657600080fd5b506103837f000000000000000000000000000000000000000000000000000000000000000081565b348015610a2a57600080fd5b50610a33612f62565b604051610397919061433b565b6000610a586000805160206148af8339815191525490565b905090565b610a65612a39565b610a815760405162461bcd60e51b815260040161035e906145d7565b610a8b8282612fc4565b5050565b610a97612a39565b610ab35760405162461bcd60e51b815260040161035e906145d7565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b039081169083161415610b305760405162461bcd60e51b815260206004820152601f60248201527f43616e6e6f74207472616e7366657220737570706f7274656420617373657400604482015260640161035e565b610a8b610b3b610a40565b6001600160a01b0384169083613123565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015610ba557600080fd5b505afa158015610bb9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bdd9190613cc9565b6001600160a01b0316336001600160a01b031614610c3d5760405162461bcd60e51b815260206004820152601c60248201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604482015260640161035e565b60405163bc26e7e560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063bc26e7e590610c8f90309087908790879060040161428b565b600060405180830381600087803b158015610ca957600080fd5b505af1158015610cbd573d6000803e3d6000fd5b50505050505050565b610cce612a39565b610cea5760405162461bcd60e51b815260040161035e906145d7565b600054610100900460ff1680610d03575060005460ff16155b610d665760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161035e565b600054610100900460ff16158015610d88576000805461ffff19166101011790555b610d9384848461317a565b8015610da5576000805461ff00191690555b50505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610df35760405162461bcd60e51b815260040161035e906145a0565b60008051602061488f83398151915280546002811415610e255760405162461bcd60e51b815260040161035e9061466f565b600282557f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614610e9e5760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b604482015260640161035e565b610ea88484613235565b50600190555050565b60a4546001600160a01b03163314610f0b5760405162461bcd60e51b815260206004820152601b60248201527f43616c6c6572206973206e6f7420746865204861727665737465720000000000604482015260640161035e565b60008051602061488f83398151915280546002811415610f3d5760405162461bcd60e51b815260040161035e9061466f565b60028255610f496132c7565b5060019055565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610feb5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b606482015260840161035e565b610ff433613515565b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b03161461106d5760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b604482015260640161035e565b6040516370a0823160e01b81523060048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156110cc57600080fd5b505afa1580156110e0573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061110491906140e3565b60345461111a906801bc16d674ec800000614780565b6111249190614746565b92915050565b611132612a39565b61114e5760405162461bcd60e51b815260040161035e906145d7565b6040516001600160a01b03821681527f83f29c79feb71f8fba9d0fbc4ba5f0982a28b6b1e868b3fc50e6400d100bca0f9060200160405180910390a1603380546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60335461010090046001600160a01b031633146111e15760405162461bcd60e51b815260040161035e90614638565b60335460ff16156112045760405162461bcd60e51b815260040161035e9061460e565b6000611219826801bc16d674ec800000614780565b6040516370a0823160e01b81523060048201529091507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561127b57600080fd5b505afa15801561128f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112b391906140e3565b8111156112f65760405162461bcd60e51b81526020600482015260116024820152700d2dce6eaccccd2c6d2cadce840ae8aa89607b1b604482015260640161035e565b604051632e1a7d4d60e01b8152600481018290527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690632e1a7d4d90602401600060405180830381600087803b15801561135857600080fd5b505af115801561136c573d6000803e3d6000fd5b5050505060005b82811015610da557600084848381811061138f5761138f61483f565b90506020028101906113a191906146dd565b6113ab9080614697565b6040516113b992919061425f565b6040805191829003909120600081815260356020529182205490925060ff16908160038111156113eb576113eb614813565b146114385760405162461bcd60e51b815260206004820152601860248201527f56616c696461746f72206e6f7420726567697374657265640000000000000000604482015260640161035e565b60408051600160f81b60208201526000602182018190526bffffffffffffffffffffffff193060601b16602c830152910160405160208183030381529060405290507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663228951188888878181106114bb576114bb61483f565b90506020028101906114cd91906146dd565b6114d79080614697565b848b8b8a8181106114ea576114ea61483f565b90506020028101906114fc91906146dd565b61150a906020810190614697565b8d8d8c81811061151c5761151c61483f565b905060200281019061152e91906146dd565b604001356040518763ffffffff1660e01b8152600401611553969594939291906144ea565b600060405180830381600087803b15801561156d57600080fd5b505af1158015611581573d6000803e3d6000fd5b505050506001603460008282546115989190614746565b909155507ffeb31a79d38edb1b090d516e4df3e273651179c6f2c2ec53a9a22ae015b70ba990508787868181106115d1576115d161483f565b90506020028101906115e391906146dd565b6115ed9080614697565b6801bc16d674ec800000846040516116089493929190614539565b60405180910390a150506000908152603560205260409020805460ff1916600190811790915501611373565b60335461010090046001600160a01b031633146116635760405162461bcd60e51b815260040161035e90614638565b60335460ff16156116865760405162461bcd60e51b815260040161035e9061460e565b600060356000878760405161169c92919061425f565b604080519182900390912082526020820192909252016000205460ff16905060028160038111156116cf576116cf614813565b146117145760405162461bcd60e51b815260206004820152601560248201527456616c696461746f72206e6f742065786974696e6760581b604482015260640161035e565b6040516312b3fc1960e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906312b3fc199061176890899089908990899089906004016144a9565b600060405180830381600087803b15801561178257600080fd5b505af1158015611796573d6000803e3d6000fd5b505050507ff72821b8777f002ccdf6326f1242d9e0f762eb077668b67bebe640535378066d868686866040516117cf9493929190614420565b60405180910390a160036035600088886040516117ed92919061425f565b60408051918290039091208252602082019290925201600020805460ff1916600183600381111561182057611820614813565b0217905550505050505050565b60a5818154811061183d57600080fd5b6000918252602090912001546001600160a01b0316905081565b606b546001600160a01b031633146118bf5760405162461bcd60e51b815260206004820152602560248201527f43616c6c6572206973206e6f7420746865204163636f756e74696e6720476f7660448201526432b93737b960d91b606482015260840161035e565b60335460ff166119085760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b604482015260640161035e565b6040516370a0823160e01b815230600482015247906000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561196c57600080fd5b505afa158015611980573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119a491906140e3565b90508382111580156119b65750828111155b611a025760405162461bcd60e51b815260206004820152601960248201527f6f766572206163636f756e74696e67207468726573686f6c6400000000000000604482015260640161035e565b60345460685460408051928352602083018b9052820152606081018690526080810188905260a081018790527fb2c41d2aedabd456081f30f3b116ce88de1c795a7d4ca787fef373a393f3c5db9060c00160405180910390a1603488905560688590558615611b235781871115611aae5760405162461bcd60e51b815260206004820152601060248201526f0d2dce6eaccccd2c6d2cadce8408aa8960831b604482015260640161035e565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0886040518263ffffffff1660e01b81526004016000604051808303818588803b158015611b0957600080fd5b505af1158015611b1d573d6000803e3d6000fd5b50505050505b8515611bed5760405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018890527f0000000000000000000000000000000000000000000000000000000000000000169063a9059cbb90604401602060405180830381600087803b158015611bb357600080fd5b505af1158015611bc7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611beb9190613f0d565b505b611bf56135d6565b5050505050505050565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015611c5857600080fd5b505afa158015611c6c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c909190613cc9565b6001600160a01b0316336001600160a01b031614611cf05760405162461bcd60e51b815260206004820152601c60248201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604482015260640161035e565b610ff4613669565b336001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161480611d475750611d32610a40565b6001600160a01b0316336001600160a01b0316145b611d9f5760405162461bcd60e51b815260206004820152602360248201527f43616c6c6572206973206e6f7420746865205661756c74206f7220476f7665726044820152623737b960e91b606482015260840161035e565b60008051602061488f83398151915280546002811415611dd15760405162461bcd60e51b815260040161035e9061466f565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b158015611e3757600080fd5b505afa158015611e4b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e6f91906140e3565b90508015611ec257611ec27f00000000000000000000000000000000000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000836136c1565b505060019055565b611ed2612a39565b611eee5760405162461bcd60e51b815260040161035e906145d7565b60a1548110611f2f5760405162461bcd60e51b815260206004820152600d60248201526c092dcecc2d8d2c840d2dcc8caf609b1b604482015260640161035e565b600060a18281548110611f4457611f4461483f565b60009182526020808320909101546001600160a01b0390811680845260a090925260409092205460a15491935090911690611f819060019061479f565b8310156120035760a18054611f989060019061479f565b81548110611fa857611fa861483f565b60009182526020909120015460a180546001600160a01b039092169185908110611fd457611fd461483f565b9060005260206000200160006101000a8154816001600160a01b0302191690836001600160a01b031602179055505b60a180548061201457612014614829565b60008281526020808220600019908401810180546001600160a01b031990811690915593019093556001600160a01b0385811680835260a0855260409283902080549094169093559051908416815290917f16b7600acff27e39a8a96056b3d533045298de927507f5c1d97e4accde60488c910160405180910390a2505050565b61209d612a39565b6120b95760405162461bcd60e51b815260040161035e906145d7565b8060005b8181101561216c5760008484838181106120d9576120d961483f565b90506020020160208101906120ee9190613cac565b6001600160a01b0316141561215c5760405162461bcd60e51b815260206004820152602e60248201527f43616e206e6f742073657420616e20656d70747920616464726573732061732060448201526d30903932bbb0b932103a37b5b2b760911b606482015260840161035e565b612165816147e2565b90506120bd565b507f04c0b9649497d316554306e53678d5f5f5dbc3a06f97dec13ff4cfe98b986bbc60a584846040516121a193929190614388565b60405180910390a1610da560a58484613a05565b60335460009061010090046001600160a01b031633146121e75760405162461bcd60e51b815260040161035e90614638565b60335460ff161561220a5760405162461bcd60e51b815260040161035e9061460e565b6068544710156122225761221c613669565b50600090565b600060685447612232919061479f565b9050600191506801bc16d674ec800000811061240d57600061225d6801bc16d674ec8000008361475e565b90508060346000828254612271919061479f565b909155506000905061228c826801bc16d674ec800000614780565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b1580156122e957600080fd5b505af11580156122fd573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b15801561238d57600080fd5b505af11580156123a1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123c59190613f0d565b5060345460408051848152602081019290925281018290527fbe7040030ff7b347853214bf49820c6d455fedf58f3815f85c7bc5216993682b9060600160405180910390a150505b60006068544761241d919061479f565b90506801bc16d674ec800000811061246f5760405162461bcd60e51b8152602060048201526015602482015274756e6578706563746564206163636f756e74696e6760581b604482015260640161035e565b8061247957505090565b6069548110156124d35780606860008282546124959190614746565b90915550506040518181527f7a745a2c63a535068f52ceca27debd5297bbad5f7f37ec53d044a59d0362445d906020015b60405180910390a1505090565b606a54811115612666577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561253857600080fd5b505af115801561254c573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b1580156125dc57600080fd5b505af11580156125f0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906126149190613f0d565b50600160346000828254612628919061479f565b909155505060345460408051918252602082018390527f6aa7e30787b26429ced603a7aba8b19c4b5d5bcf29a3257da953c8d53bcaa3a691016124c6565b61266e613669565b60009250505090565b61267f612a39565b61269b5760405162461bcd60e51b815260040161035e906145d7565b80821080156126b257506801bc16d674ec80000082105b80156126c657506801bc16d674ec80000081105b80156126e35750673782dace9d9000006126e0838361479f565b10155b61272f5760405162461bcd60e51b815260206004820152601760248201527f696e636f7272656374206675736520696e74657276616c000000000000000000604482015260640161035e565b60408051838152602081018390527fcb8d24e46eb3c402bf344ee60a6576cba9ef2f59ea1af3b311520704924e901a910160405180910390a1606991909155606a55565b60405163095ea7b360e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116600483015260001960248301527f0000000000000000000000000000000000000000000000000000000000000000169063095ea7b390604401602060405180830381600087803b1580156127fe57600080fd5b505af1158015612812573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906128369190613f0d565b50565b60335461010090046001600160a01b031633146128685760405162461bcd60e51b815260040161035e90614638565b60335460ff161561288b5760405162461bcd60e51b815260040161035e9061460e565b6040516301ba3ee760e21b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906306e8fb9c906128e5908b908b908b908b908b908b908b908b90600401614447565b600060405180830381600087803b1580156128ff57600080fd5b505af1158015612913573d6000803e3d6000fd5b505050506000603560008a8a60405161292d92919061425f565b60408051918290039091208252602082019290925201600020805460ff1916600183600381111561296057612960614813565b02179055507f75c4a66b2c6c28cf46db7131182a812e4fbbb2f0591377aa83a737909a9b68c38888888860405161299a9493929190614420565b60405180910390a15050505050505050565b6129b4612a39565b6129d05760405162461bcd60e51b815260040161035e906145d7565b60a454604080516001600160a01b03928316815291831660208301527fe48386b84419f4d36e0f96c10cc3510b6fb1a33795620c5098b22472bbe90796910160405180910390a160a480546001600160a01b0319166001600160a01b0392909216919091179055565b6000612a516000805160206148af8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b612a72612a39565b612a8e5760405162461bcd60e51b815260040161035e906145d7565b612ab6817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b0316612ad66000805160206148af8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b612b16612a39565b612b325760405162461bcd60e51b815260040161035e906145d7565b6040516001600160a01b03821681527ff3dd2b598e2a94dd3f46b414f7c960f8e10a0b0efd00df97d27cdd0fee5c87539060200160405180910390a1606b80546001600160a01b0319166001600160a01b0392909216919091179055565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614612bd85760405162461bcd60e51b815260040161035e906145a0565b60008051602061488f83398151915280546002811415612c0a5760405162461bcd60e51b815260040161035e9061466f565b60028255612c198585856136c1565b5060019055505050565b60335461010090046001600160a01b03163314612c525760405162461bcd60e51b815260040161035e90614638565b60335460ff1615612c755760405162461bcd60e51b815260040161035e9061460e565b6000603560008686604051612c8b92919061425f565b604080519182900390912082526020820192909252016000205460ff1690506001816003811115612cbe57612cbe614813565b14612d025760405162461bcd60e51b815260206004820152601460248201527315985b1a59185d1bdc881b9bdd081cdd185ad95960621b604482015260640161035e565b604051633877322b60e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633877322b90612d54908890889088908890600401614420565b600060405180830381600087803b158015612d6e57600080fd5b505af1158015612d82573d6000803e3d6000fd5b505050507ff8821da16f5ed966b41e0343c3eff9903af782d74f99f1689dd9d4562b6545b385858585604051612dbb9493929190614420565b60405180910390a16002603560008787604051612dd992919061425f565b60408051918290039091208252602082019290925201600020805460ff19166001836003811115612e0c57612e0c614813565b02179055505050505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614612e605760405162461bcd60e51b815260040161035e906145a0565b60008051602061488f83398151915280546002811415612e925760405162461bcd60e51b815260040161035e9061466f565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b158015612ef857600080fd5b505afa158015612f0c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f3091906140e3565b90508015611ec257611ec27f000000000000000000000000000000000000000000000000000000000000000082613235565b606060a5805480602002602001604051908101604052809291908181526020018280548015612fba57602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612f9c575b5050505050905090565b6001600160a01b03828116600090815260a0602052604090205416156130215760405162461bcd60e51b81526020600482015260126024820152711c151bdad95b88185b1c9958591e481cd95d60721b604482015260640161035e565b6001600160a01b0382161580159061304157506001600160a01b03811615155b6130815760405162461bcd60e51b8152602060048201526011602482015270496e76616c69642061646472657373657360781b604482015260640161035e565b6001600160a01b03828116600081815260a06020908152604080832080549587166001600160a01b0319968716811790915560a1805460018101825594527faadc37b8ba5645e62f4546802db221593a94729ccbfc5a97d01365a88f64987890930180549095168417909455925190815290917fef6485b84315f9b1483beffa32aae9a0596890395e3d7521f1c5fbb51790e765910160405180910390a25050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b1790526131759084906137b9565b505050565b825161318d9060a5906020860190613a68565b508151815181146131d75760405162461bcd60e51b8152602060048201526014602482015273496e76616c696420696e7075742061727261797360601b604482015260640161035e565b60005b8181101561322e5761321e8482815181106131f7576131f761483f565b60200260200101518483815181106132115761321161483f565b6020026020010151612fc4565b613227816147e2565b90506131da565b5050505050565b6000811161327e5760405162461bcd60e51b81526020600482015260166024820152754d757374206465706f73697420736f6d657468696e6760501b604482015260640161035e565b6040805160008152602081018390526001600160a01b038416917f5548c837ab068cf56a2c2479df0882a4922fd203edb7517321831d95078c5f62910160405180910390a25050565b60335460ff16156132ea5760405162461bcd60e51b815260040161035e9061460e565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663e52253816040518163ffffffff1660e01b8152600401602060405180830381600087803b15801561334757600080fd5b505af115801561335b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061337f91906140e3565b90506000606854826133919190614746565b9050804710156133e35760405162461bcd60e51b815260206004820152601860248201527f696e73756666696369656e74206574682062616c616e63650000000000000000604482015260640161035e565b8015610a8b5760006068819055507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561344c57600080fd5b505af1158015613460573d6000803e3d6000fd5b505060a454604080516001600160a01b0392831681527f0000000000000000000000000000000000000000000000000000000000000000909216602083015281018590527ff6c07a063ed4e63808eb8da7112d46dbcd38de2b40a73dbcc9353c5a94c72353935060600191506134d39050565b60405180910390a160a454610a8b906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116911683613123565b6001600160a01b03811661356b5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f722069732061646472657373283029000000000000604482015260640161035e565b806001600160a01b031661358b6000805160206148af8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a3612836816000805160206148af83398151915255565b60335460ff1661361f5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b604482015260640161035e565b6033805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b60335460ff161561368c5760405162461bcd60e51b815260040161035e9061460e565b6033805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25861364c3390565b600081116137115760405162461bcd60e51b815260206004820152601760248201527f4d75737420776974686472617720736f6d657468696e67000000000000000000604482015260640161035e565b6001600160a01b0383166137605760405162461bcd60e51b8152602060048201526016602482015275135d5cdd081cdc1958da599e481c9958da5c1a595b9d60521b604482015260640161035e565b6040805160008152602081018390526001600160a01b038416917f2717ead6b9200dd235aad468c9809ea400fe33ac69b5bfaa6d3e90fc922b6398910160405180910390a26131756001600160a01b0383168483613123565b600061380e826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661388b9092919063ffffffff16565b805190915015613175578080602001905181019061382c9190613f0d565b6131755760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161035e565b606061389a84846000856138a4565b90505b9392505050565b6060824710156139055760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161035e565b843b6139535760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161035e565b600080866001600160a01b0316858760405161396f919061426f565b60006040518083038185875af1925050503d80600081146139ac576040519150601f19603f3d011682016040523d82523d6000602084013e6139b1565b606091505b50915091506139c18282866139cc565b979650505050505050565b606083156139db57508161389d565b8251156139eb5782518084602001fd5b8160405162461bcd60e51b815260040161035e919061458d565b828054828255906000526020600020908101928215613a58579160200282015b82811115613a585781546001600160a01b0319166001600160a01b03843516178255602090920191600190910190613a25565b50613a64929150613abd565b5090565b828054828255906000526020600020908101928215613a58579160200282015b82811115613a5857825182546001600160a01b0319166001600160a01b03909116178255602090920191600190910190613a88565b5b80821115613a645760008155600101613abe565b60008083601f840112613ae457600080fd5b5081356001600160401b03811115613afb57600080fd5b6020830191508360208260051b8501011115613b1657600080fd5b9250929050565b600082601f830112613b2e57600080fd5b81356020613b43613b3e83614723565b6146f3565b80838252828201915082860187848660051b8901011115613b6357600080fd5b60005b85811015613b8b578135613b798161486b565b84529284019290840190600101613b66565b5090979650505050505050565b60008083601f840112613baa57600080fd5b5081356001600160401b03811115613bc157600080fd5b602083019150836020828501011115613b1657600080fd5b600060a08284031215613beb57600080fd5b50919050565b600060a08284031215613c0357600080fd5b60405160a081018181106001600160401b0382111715613c2557613c25614855565b604052905080613c3483613c7c565b8152613c4260208401613c95565b6020820152613c5360408401613c95565b60408201526060830135613c6681614880565b6060820152608092830135920191909152919050565b803563ffffffff81168114613c9057600080fd5b919050565b80356001600160401b0381168114613c9057600080fd5b600060208284031215613cbe57600080fd5b813561389d8161486b565b600060208284031215613cdb57600080fd5b815161389d8161486b565b60008060408385031215613cf957600080fd5b8235613d048161486b565b91506020830135613d148161486b565b809150509250929050565b600080600060608486031215613d3457600080fd5b8335613d3f8161486b565b92506020840135613d4f8161486b565b929592945050506040919091013590565b60008060408385031215613d7357600080fd5b8235613d7e8161486b565b946020939093013593505050565b60008060208385031215613d9f57600080fd5b82356001600160401b03811115613db557600080fd5b613dc185828601613ad2565b90969095509350505050565b600080600060608486031215613de257600080fd5b83356001600160401b0380821115613df957600080fd5b613e0587838801613b1d565b94506020860135915080821115613e1b57600080fd5b613e2787838801613b1d565b93506040860135915080821115613e3d57600080fd5b50613e4a86828701613b1d565b9150509250925092565b600080600060e08486031215613e6957600080fd5b83356001600160401b03811115613e7f57600080fd5b8401601f81018613613e9057600080fd5b80356020613ea0613b3e83614723565b8083825282820191508285018a848660051b8801011115613ec057600080fd5b600095505b84861015613eea57613ed681613c95565b835260019590950194918301918301613ec5565b509650508601359350613f04915086905060408601613bf1565b90509250925092565b600060208284031215613f1f57600080fd5b815161389d81614880565b600060208284031215613f3c57600080fd5b5035919050565b60008060008060408587031215613f5957600080fd5b84356001600160401b0380821115613f7057600080fd5b613f7c88838901613b98565b90965094506020870135915080821115613f9557600080fd5b50613fa287828801613ad2565b95989497509550505050565b600080600080600080600080610120898b031215613fcb57600080fd5b88356001600160401b0380821115613fe257600080fd5b613fee8c838d01613b98565b909a50985060208b013591508082111561400757600080fd5b6140138c838d01613ad2565b909850965060408b013591508082111561402c57600080fd5b506140398b828c01613b98565b909550935050606089013591506140538a60808b01613bd9565b90509295985092959890939650565b600080600080600060e0868803121561407a57600080fd5b85356001600160401b038082111561409157600080fd5b61409d89838a01613b98565b909750955060208801359150808211156140b657600080fd5b506140c388828901613ad2565b90945092506140d790508760408801613bd9565b90509295509295909350565b6000602082840312156140f557600080fd5b5051919050565b6000806040838503121561410f57600080fd5b50508035926020909101359150565b60008060008060008060c0878903121561413757600080fd5b505084359660208601359650604086013595606081013595506080810135945060a0013592509050565b8183526000602080850194508260005b8581101561419d576001600160401b0361418a83613c95565b1687529582019590820190600101614171565b509495945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b600081518084526141e98160208601602086016147b6565b601f01601f19169290920160200192915050565b63ffffffff61420b82613c7c565b16825261421a60208201613c95565b6001600160401b0380821660208501528061423760408501613c95565b1660408501525050606081013561424d81614880565b15156060830152608090810135910152565b8183823760009101908152919050565b600082516142818184602087016147b6565b9190910192915050565b6001600160a01b03851681526101006020808301829052855191830182905260009161012084019187810191845b818110156142de5783516001600160401b0316855293820193928201926001016142b9565b505082935086604086015263ffffffff865116606086015280860151925050506001600160401b0380821660808501528060408601511660a085015250506060830151151560c0830152608083015160e083015295945050505050565b6020808252825182820181905260009190848201906040850190845b8181101561437c5783516001600160a01b031683529284019291840191600101614357565b50909695505050505050565b6000604082016040835280865480835260608501915087600052602092508260002060005b828110156143d25781546001600160a01b0316845292840192600191820191016143ad565b505050838103828501528481528590820160005b868110156144145782356143f98161486b565b6001600160a01b0316825291830191908301906001016143e6565b50979650505050505050565b6040815260006144346040830186886141a8565b82810360208401526139c1818587614161565b600061012080835261445c8184018b8d6141a8565b9050828103602084015261447181898b614161565b905082810360408401526144868187896141a8565b91505083606083015261449c60808301846141fd565b9998505050505050505050565b60e0815260006144bd60e0830187896141a8565b82810360208401526144d0818688614161565b9150506144e060408301846141fd565b9695505050505050565b6080815260006144fe60808301888a6141a8565b828103602084015261451081886141d1565b905082810360408401526145258186886141a8565b915050826060830152979650505050505050565b60608152600061454d6060830186886141a8565b84602084015282810360408401526139c181856141d1565b602081016004831061458757634e487b7160e01b600052602160045260246000fd5b91905290565b60208152600061389d60208301846141d1565b60208082526017908201527f43616c6c6572206973206e6f7420746865205661756c74000000000000000000604082015260600190565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60208082526010908201526f14185d5cd8589b194e881c185d5cd95960821b604082015260600190565b6020808252601d908201527f43616c6c6572206973206e6f7420746865205265676973747261746f72000000604082015260600190565b6020808252600e908201526d1499595b9d1c985b9d0818d85b1b60921b604082015260600190565b6000808335601e198436030181126146ae57600080fd5b8301803591506001600160401b038211156146c857600080fd5b602001915036819003821315613b1657600080fd5b60008235605e1983360301811261428157600080fd5b604051601f8201601f191681016001600160401b038111828210171561471b5761471b614855565b604052919050565b60006001600160401b0382111561473c5761473c614855565b5060051b60200190565b60008219821115614759576147596147fd565b500190565b60008261477b57634e487b7160e01b600052601260045260246000fd5b500490565b600081600019048311821515161561479a5761479a6147fd565b500290565b6000828210156147b1576147b16147fd565b500390565b60005b838110156147d15781810151838201526020016147b9565b83811115610da55750506000910152565b60006000198214156147f6576147f66147fd565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b6001600160a01b038116811461283657600080fd5b801515811461283657600080fdfe53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac45357bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212204292636866460b0a0ebdd872cc7401407e5a3bdd212181fd3cea747a97b6379e64736f6c63430008070033", + "numDeployments": 3, + "solcInputHash": "66dbdc9fbde8f1c7cc59f29d272eb661", + "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"platformAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"vaultAddress\",\"type\":\"address\"}],\"internalType\":\"struct InitializableAbstractStrategy.BaseStrategyConfig\",\"name\":\"_baseConfig\",\"type\":\"tuple\"},{\"internalType\":\"address\",\"name\":\"_wethAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_ssvToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_ssvNetwork\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_feeAccumulator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_beaconChainDepositContract\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"AccountingConsensusRewards\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"noOfValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"remainingValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingFullyWithdrawnValidator\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"int256\",\"name\":\"validatorsDelta\",\"type\":\"int256\"},{\"indexed\":false,\"internalType\":\"int256\",\"name\":\"consensusRewardsDelta\",\"type\":\"int256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingManuallyFixed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"remainingValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingValidatorSlashed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"withdrawal_credentials\",\"type\":\"bytes\"}],\"name\":\"ETHStaked\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"start\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"end\",\"type\":\"uint256\"}],\"name\":\"FuseIntervalUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_oldHarvesterAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_newHarvesterAddress\",\"type\":\"address\"}],\"name\":\"HarvesterAddressesUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"PTokenAdded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"PTokenRemoved\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAddress\",\"type\":\"address\"}],\"name\":\"RegistratorChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"_oldAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"_newAddresses\",\"type\":\"address[]\"}],\"name\":\"RewardTokenAddressesUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"rewardToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"RewardTokenCollected\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorExitCompleted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorExitInitiated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorRegistered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Withdrawal\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"BEACON_CHAIN_DEPOSIT_CONTRACT\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"FEE_ACCUMULATOR_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_STAKE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SSV_NETWORK_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SSV_TOKEN_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"VAULT_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"WETH_TOKEN_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"activeDepositedValidators\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"assetToPToken\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"}],\"name\":\"checkBalance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"collectRewardTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"consensusRewards\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositAll\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"depositSSV\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"doAccounting\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"accountingValid\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"exitSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fuseIntervalEnd\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fuseIntervalStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getRewardTokenAddresses\",\"outputs\":[{\"internalType\":\"address[]\",\"name\":\"\",\"type\":\"address[]\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"harvesterAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address[]\",\"name\":\"_rewardTokenAddresses\",\"type\":\"address[]\"},{\"internalType\":\"address[]\",\"name\":\"_assets\",\"type\":\"address[]\"},{\"internalType\":\"address[]\",\"name\":\"_pTokens\",\"type\":\"address[]\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"int256\",\"name\":\"_validatorsDelta\",\"type\":\"int256\"},{\"internalType\":\"int256\",\"name\":\"_consensusRewardsDelta\",\"type\":\"int256\"},{\"internalType\":\"uint256\",\"name\":\"_wethToVaultAmount\",\"type\":\"uint256\"}],\"name\":\"manuallyFixAccounting\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"platformAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"internalType\":\"bytes\",\"name\":\"sharesData\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"registerSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_assetIndex\",\"type\":\"uint256\"}],\"name\":\"removePToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"removeSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rewardTokenAddresses\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"safeApproveAllTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_fuseIntervalStart\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_fuseIntervalEnd\",\"type\":\"uint256\"}],\"name\":\"setFuseInterval\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_harvesterAddress\",\"type\":\"address\"}],\"name\":\"setHarvesterAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"setPTokenAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"setRegistrator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address[]\",\"name\":\"_rewardTokenAddresses\",\"type\":\"address[]\"}],\"name\":\"setRewardTokenAddresses\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"signature\",\"type\":\"bytes\"},{\"internalType\":\"bytes32\",\"name\":\"depositDataRoot\",\"type\":\"bytes32\"}],\"internalType\":\"struct ValidatorStakeData[]\",\"name\":\"validators\",\"type\":\"tuple[]\"}],\"name\":\"stakeEth\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"}],\"name\":\"supportsAsset\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"transferToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"validatorRegistrator\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"validatorsStates\",\"outputs\":[{\"internalType\":\"enum ValidatorRegistrator.VALIDATOR_STATE\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"vaultAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"withdraw\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawAll\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"author\":\"Origin Protocol Inc\",\"kind\":\"dev\",\"methods\":{\"checkBalance(address)\":{\"params\":{\"_asset\":\"Address of weth asset\"},\"returns\":{\"balance\":\" Total value of (W)ETH\"}},\"constructor\":{\"params\":{\"_baseConfig\":\"Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI, and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\",\"_beaconChainDepositContract\":\"Address of the beacon chain deposit contract\",\"_feeAccumulator\":\"Address of the fee accumulator receiving execution layer validator rewards\",\"_ssvNetwork\":\"Address of the SSV Network contract\",\"_ssvToken\":\"Address of the Erc20 SSV Token contract\",\"_wethAddress\":\"Address of the Erc20 WETH Token contract\"}},\"deposit(address,uint256)\":{\"params\":{\"_amount\":\"Amount of assets that were transferred to the strategy by the vault.\",\"_asset\":\"Address of asset to deposit. Has to be WETH.\"}},\"depositSSV(uint64[],uint256,(uint32,uint64,uint64,bool,uint256))\":{\"details\":\"A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds. uses \\\"onlyStrategist\\\" modifier so continuous front-running can't DOS our maintenance service that tries to top up SSV tokens.\",\"params\":{\"cluster\":\"The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\"}},\"doAccounting()\":{\"details\":\"This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it for now.\",\"returns\":{\"accountingValid\":\"true if accounting was successful, false if fuse is blown\"}},\"getRewardTokenAddresses()\":{\"returns\":{\"_0\":\"address[] the reward token addresses.\"}},\"initialize(address[],address[],address[])\":{\"params\":{\"_assets\":\"Addresses of initial supported assets\",\"_pTokens\":\"Platform Token corresponding addresses\",\"_rewardTokenAddresses\":\"Address of reward token for platform\"}},\"manuallyFixAccounting(int256,int256,uint256)\":{\"params\":{\"_consensusRewardsDelta\":\"adjust the accounted for consensus rewards up or down\",\"_validatorsDelta\":\"adjust the active validators by plus one, minus one or unchanged with zero\",\"_wethToVaultAmount\":\"the amount of WETH to be sent to the Vault\"}},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"removePToken(uint256)\":{\"params\":{\"_assetIndex\":\"Index of the asset to be removed\"}},\"setHarvesterAddress(address)\":{\"params\":{\"_harvesterAddress\":\"Address of the harvester contract.\"}},\"setPTokenAddress(address,address)\":{\"params\":{\"_asset\":\"Address for the asset\",\"_pToken\":\"Address for the corresponding platform token\"}},\"setRewardTokenAddresses(address[])\":{\"params\":{\"_rewardTokenAddresses\":\"Array of reward token addresses\"}},\"stakeEth((bytes,bytes,bytes32)[])\":{\"params\":{\"validators\":\"A list of validator data needed to stake. The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot. Only the registrator can call this function.\"}},\"supportsAsset(address)\":{\"params\":{\"_asset\":\"The address of the asset token.\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"transferToken(address,uint256)\":{\"params\":{\"_amount\":\"Amount of the asset to transfer\",\"_asset\":\"Address for the asset\"}},\"withdraw(address,address,uint256)\":{\"params\":{\"_amount\":\"Amount of WETH to withdraw\",\"_asset\":\"WETH to withdraw\",\"_recipient\":\"Address to receive withdrawn assets\"}}},\"stateVariables\":{\"FEE_ACCUMULATOR_ADDRESS\":{\"details\":\"this address will receive Execution layer rewards - These are rewards earned for executing transactions on the Ethereum network as part of block proposals. They include priority fees (fees paid by users for their transactions to be included) and MEV rewards (rewards for arranging transactions in a way that benefits the validator).\"}},\"title\":\"Native Staking SSV Strategy\",\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"BEACON_CHAIN_DEPOSIT_CONTRACT()\":{\"notice\":\"The address of the beacon chain deposit contract\"},\"FEE_ACCUMULATOR_ADDRESS()\":{\"notice\":\"Fee collector address\"},\"MAX_STAKE()\":{\"notice\":\"The maximum amount of ETH that can be staked by a validator\"},\"SSV_NETWORK_ADDRESS()\":{\"notice\":\"The address of the SSV Network contract used to interface with\"},\"SSV_TOKEN_ADDRESS()\":{\"notice\":\"SSV ERC20 token that serves as a payment for operating SSV validators\"},\"VAULT_ADDRESS()\":{\"notice\":\"Address of the OETH Vault proxy contract\"},\"WETH_TOKEN_ADDRESS()\":{\"notice\":\"The address of the Wrapped ETH (WETH) token contract\"},\"activeDepositedValidators()\":{\"notice\":\"The number of validators that have 32 (!) ETH actively deposited. When a new deposit to a validator happens this number increases, when a validator exit is detected this number decreases.\"},\"assetToPToken(address)\":{\"notice\":\"asset => pToken (Platform Specific Token Address)\"},\"checkBalance(address)\":{\"notice\":\"Returns the total value of (W)ETH that is staked to the validators and WETH deposits that are still to be staked. This does not include ETH from consensus rewards sitting in this strategy or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested and sent to the Dripper so will eventually be sent to the Vault as WETH.\"},\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"collectRewardTokens()\":{\"notice\":\"Collect accumulated reward token and send to Vault.\"},\"consensusRewards()\":{\"notice\":\"Keeps track of the total consensus rewards swept from the beacon chain\"},\"deposit(address,uint256)\":{\"notice\":\"Unlike other strategies, this does not deposit assets into the underlying platform. It just checks the asset is WETH and emits the Deposit event. To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used. Will NOT revert if the strategy is paused from an accounting failure.\"},\"depositAll()\":{\"notice\":\"Unlike other strategies, this does not deposit assets into the underlying platform. It just emits the Deposit event. To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used. Will NOT revert if the strategy is paused from an accounting failure.\"},\"depositSSV(uint64[],uint256,(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\"},\"doAccounting()\":{\"notice\":\"This notion page offers a good explanation of how the accounting functions https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart, the accounting function will treat that ETH as Beacon chain consensus rewards. On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32, the accounting function will treat that as a validator slashing.Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when accounting is valid and fuse isn't \\\"blown\\\". Returns false when fuse is blown.\"},\"exitSsvValidator(bytes,uint64[])\":{\"notice\":\"Exit a validator from the Beacon chain. The staked ETH will eventually swept to this native staking strategy. Only the registrator can call this function.\"},\"fuseIntervalEnd()\":{\"notice\":\"end of fuse interval\"},\"fuseIntervalStart()\":{\"notice\":\"start of fuse interval\"},\"getRewardTokenAddresses()\":{\"notice\":\"Get the reward token addresses.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"harvesterAddress()\":{\"notice\":\"Address of the Harvester contract allowed to collect reward tokens\"},\"initialize(address[],address[],address[])\":{\"notice\":\"initialize function, to set up initial internal state\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"manuallyFixAccounting(int256,int256,uint256)\":{\"notice\":\"Allow the Strategist to fix the accounting of this strategy and unpause.\"},\"platformAddress()\":{\"notice\":\"Address of the underlying platform\"},\"registerSsvValidator(bytes,uint64[],bytes,uint256,(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Registers a new validator in the SSV Cluster. Only the registrator can call this function.\"},\"removePToken(uint256)\":{\"notice\":\"Remove a supported asset by passing its index. This method can only be called by the system Governor\"},\"removeSsvValidator(bytes,uint64[],(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Remove a validator from the SSV Cluster. Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain. If removed before the validator has exited the beacon chain will result in the validator being slashed. Only the registrator can call this function.\"},\"rewardTokenAddresses(uint256)\":{\"notice\":\"Address of the reward tokens. eg CRV, BAL, CVX, AURA\"},\"safeApproveAllTokens()\":{\"notice\":\"Approves the SSV Network contract to transfer SSV tokens for deposits\"},\"setFuseInterval(uint256,uint256)\":{\"notice\":\"set fuse interval values\"},\"setHarvesterAddress(address)\":{\"notice\":\"Set the Harvester contract that can collect rewards.\"},\"setPTokenAddress(address,address)\":{\"notice\":\"Provide support for asset by passing its pToken address. This method can only be called by the system Governor\"},\"setRegistrator(address)\":{\"notice\":\"Set the address of the registrator which can register, exit and remove validators\"},\"setRewardTokenAddresses(address[])\":{\"notice\":\"Set the reward token addresses. Any old addresses will be overwritten.\"},\"stakeEth((bytes,bytes,bytes32)[])\":{\"notice\":\"Stakes WETH to the node validators\"},\"supportsAsset(address)\":{\"notice\":\"Returns bool indicating whether asset is supported by strategy.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"},\"transferToken(address,uint256)\":{\"notice\":\"Transfer token to governor. Intended for recovering tokens stuck in strategy contracts, i.e. mistaken sends.\"},\"validatorRegistrator()\":{\"notice\":\"Address of the registrator - allowed to register, exit and remove validators\"},\"validatorsStates(bytes32)\":{\"notice\":\"State of the validators keccak256(pubKey) => state\"},\"vaultAddress()\":{\"notice\":\"Address of the OToken vault\"},\"withdraw(address,address,uint256)\":{\"notice\":\"Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That can happen when: - the deposit was not a multiple of 32 WETH - someone sent WETH directly to this contract Will NOT revert if the strategy is paused from an accounting failure.\"},\"withdrawAll()\":{\"notice\":\"transfer all WETH deposits back to the vault. This does not withdraw from the validators. That has to be done separately with the `exitSsvValidator` and `removeSsvValidator` operations. This does not withdraw any execution rewards from the FeeAccumulator or consensus rewards in this strategy. Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn. ETH from full validator withdrawals is sent to the Vault using `doAccounting`. Will NOT revert if the strategy is paused from an accounting failure.\"}},\"notice\":\"Strategy to deploy funds into DVT validators powered by the SSV Network\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol\":\"NativeStakingSSVStrategy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n require(!paused(), \\\"Pausable: paused\\\");\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n require(paused(), \\\"Pausable: not paused\\\");\\n _;\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0xe68ed7fb8766ed1e888291f881e36b616037f852b37d96877045319ad298ba87\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `recipient`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address recipient, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `sender` to `recipient` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(\\n address sender,\\n address recipient,\\n uint256 amount\\n ) external returns (bool);\\n\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n}\\n\",\"keccak256\":\"0x61437cb513a887a1bbad006e7b1c8b414478427d33de47c5600af3c748f108da\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n function safeTransfer(\\n IERC20 token,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n function safeTransferFrom(\\n IERC20 token,\\n address from,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n function safeIncreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n uint256 newAllowance = token.allowance(address(this), spender) + value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n\\n function safeDecreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n uint256 newAllowance = oldAllowance - value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n if (returndata.length > 0) {\\n // Return data is optional\\n require(abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc3d946432c0ddbb1f846a0d3985be71299df331b91d06732152117f62f0be2b5\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)\\n\\npragma solidity ^0.8.0;\\n\\n// CAUTION\\n// This version of SafeMath should only be used with Solidity 0.8 or later,\\n// because it relies on the compiler's built in overflow checks.\\n\\n/**\\n * @dev Wrappers over Solidity's arithmetic operations.\\n *\\n * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler\\n * now has built in overflow checking.\\n */\\nlibrary SafeMath {\\n /**\\n * @dev Returns the addition of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n uint256 c = a + b;\\n if (c < a) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the substraction of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b > a) return (false, 0);\\n return (true, a - b);\\n }\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n // benefit is lost if 'b' is also tested.\\n // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n if (a == 0) return (true, 0);\\n uint256 c = a * b;\\n if (c / a != b) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the division of two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a / b);\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a % b);\\n }\\n }\\n\\n /**\\n * @dev Returns the addition of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `+` operator.\\n *\\n * Requirements:\\n *\\n * - Addition cannot overflow.\\n */\\n function add(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting on\\n * overflow (when the result is negative).\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `*` operator.\\n *\\n * Requirements:\\n *\\n * - Multiplication cannot overflow.\\n */\\n function mul(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator.\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting when dividing by zero.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a % b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\\n * overflow (when the result is negative).\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {trySub}.\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b <= a, errorMessage);\\n return a - b;\\n }\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting with custom message on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator. Note: this function uses a\\n * `revert` opcode (which leaves remaining gas untouched) while Solidity\\n * uses an invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a / b;\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting with custom message when dividing by zero.\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {tryMod}.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a % b;\\n }\\n }\\n}\\n\",\"keccak256\":\"0xa2f576be637946f767aa56601c26d717f48a0aff44f82e46f13807eea1009a21\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/interfaces/IBasicToken.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IBasicToken {\\n function symbol() external view returns (string memory);\\n\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0xa562062698aa12572123b36dfd2072f1a39e44fed2031cc19c2c9fd522f96ec2\",\"license\":\"MIT\"},\"contracts/interfaces/IDepositContract.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IDepositContract {\\n /// @notice A processed deposit event.\\n event DepositEvent(\\n bytes pubkey,\\n bytes withdrawal_credentials,\\n bytes amount,\\n bytes signature,\\n bytes index\\n );\\n\\n /// @notice Submit a Phase 0 DepositData object.\\n /// @param pubkey A BLS12-381 public key.\\n /// @param withdrawal_credentials Commitment to a public key for withdrawals.\\n /// @param signature A BLS12-381 signature.\\n /// @param deposit_data_root The SHA-256 hash of the SSZ-encoded DepositData object.\\n /// Used as a protection against malformed input.\\n function deposit(\\n bytes calldata pubkey,\\n bytes calldata withdrawal_credentials,\\n bytes calldata signature,\\n bytes32 deposit_data_root\\n ) external payable;\\n\\n /// @notice Query the current deposit root hash.\\n /// @return The deposit root hash.\\n function get_deposit_root() external view returns (bytes32);\\n\\n /// @notice Query the current deposit count.\\n /// @return The deposit count encoded as a little endian 64-bit number.\\n function get_deposit_count() external view returns (bytes memory);\\n}\\n\",\"keccak256\":\"0x598f90bdbc854250bbd5991426bfb43367207e64e33109c41aa8b54323fd8d8e\",\"license\":\"MIT\"},\"contracts/interfaces/ISSVNetwork.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nstruct Cluster {\\n uint32 validatorCount;\\n uint64 networkFeeIndex;\\n uint64 index;\\n bool active;\\n uint256 balance;\\n}\\n\\ninterface ISSVNetwork {\\n error ApprovalNotWithinTimeframe();\\n error CallerNotOwner();\\n error CallerNotWhitelisted();\\n error ClusterAlreadyEnabled();\\n error ClusterDoesNotExists();\\n error ClusterIsLiquidated();\\n error ClusterNotLiquidatable();\\n error ExceedValidatorLimit();\\n error FeeExceedsIncreaseLimit();\\n error FeeIncreaseNotAllowed();\\n error FeeTooHigh();\\n error FeeTooLow();\\n error IncorrectClusterState();\\n error IncorrectValidatorState();\\n error InsufficientBalance();\\n error InvalidOperatorIdsLength();\\n error InvalidPublicKeyLength();\\n error MaxValueExceeded();\\n error NewBlockPeriodIsBelowMinimum();\\n error NoFeeDeclared();\\n error NotAuthorized();\\n error OperatorAlreadyExists();\\n error OperatorDoesNotExist();\\n error OperatorsListNotUnique();\\n error SameFeeChangeNotAllowed();\\n error TargetModuleDoesNotExist();\\n error TokenTransferFailed();\\n error UnsortedOperatorsList();\\n error ValidatorAlreadyExists();\\n error ValidatorDoesNotExist();\\n\\n event AdminChanged(address previousAdmin, address newAdmin);\\n event BeaconUpgraded(address indexed beacon);\\n event ClusterDeposited(\\n address indexed owner,\\n uint64[] operatorIds,\\n uint256 value,\\n Cluster cluster\\n );\\n event ClusterLiquidated(\\n address indexed owner,\\n uint64[] operatorIds,\\n Cluster cluster\\n );\\n event ClusterReactivated(\\n address indexed owner,\\n uint64[] operatorIds,\\n Cluster cluster\\n );\\n event ClusterWithdrawn(\\n address indexed owner,\\n uint64[] operatorIds,\\n uint256 value,\\n Cluster cluster\\n );\\n event DeclareOperatorFeePeriodUpdated(uint64 value);\\n event ExecuteOperatorFeePeriodUpdated(uint64 value);\\n event FeeRecipientAddressUpdated(\\n address indexed owner,\\n address recipientAddress\\n );\\n event Initialized(uint8 version);\\n event LiquidationThresholdPeriodUpdated(uint64 value);\\n event MinimumLiquidationCollateralUpdated(uint256 value);\\n event NetworkEarningsWithdrawn(uint256 value, address recipient);\\n event NetworkFeeUpdated(uint256 oldFee, uint256 newFee);\\n event OperatorAdded(\\n uint64 indexed operatorId,\\n address indexed owner,\\n bytes publicKey,\\n uint256 fee\\n );\\n event OperatorFeeDeclarationCancelled(\\n address indexed owner,\\n uint64 indexed operatorId\\n );\\n event OperatorFeeDeclared(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 blockNumber,\\n uint256 fee\\n );\\n event OperatorFeeExecuted(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 blockNumber,\\n uint256 fee\\n );\\n event OperatorFeeIncreaseLimitUpdated(uint64 value);\\n event OperatorMaximumFeeUpdated(uint64 maxFee);\\n event OperatorRemoved(uint64 indexed operatorId);\\n event OperatorWhitelistUpdated(\\n uint64 indexed operatorId,\\n address whitelisted\\n );\\n event OperatorWithdrawn(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 value\\n );\\n event OwnershipTransferStarted(\\n address indexed previousOwner,\\n address indexed newOwner\\n );\\n event OwnershipTransferred(\\n address indexed previousOwner,\\n address indexed newOwner\\n );\\n event Upgraded(address indexed implementation);\\n event ValidatorAdded(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey,\\n bytes shares,\\n Cluster cluster\\n );\\n event ValidatorExited(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey\\n );\\n event ValidatorRemoved(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey,\\n Cluster cluster\\n );\\n\\n fallback() external;\\n\\n function acceptOwnership() external;\\n\\n function cancelDeclaredOperatorFee(uint64 operatorId) external;\\n\\n function declareOperatorFee(uint64 operatorId, uint256 fee) external;\\n\\n function deposit(\\n address clusterOwner,\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function executeOperatorFee(uint64 operatorId) external;\\n\\n function exitValidator(bytes memory publicKey, uint64[] memory operatorIds)\\n external;\\n\\n function getVersion() external pure returns (string memory version);\\n\\n function initialize(\\n address token_,\\n address ssvOperators_,\\n address ssvClusters_,\\n address ssvDAO_,\\n address ssvViews_,\\n uint64 minimumBlocksBeforeLiquidation_,\\n uint256 minimumLiquidationCollateral_,\\n uint32 validatorsPerOperatorLimit_,\\n uint64 declareOperatorFeePeriod_,\\n uint64 executeOperatorFeePeriod_,\\n uint64 operatorMaxFeeIncrease_\\n ) external;\\n\\n function liquidate(\\n address clusterOwner,\\n uint64[] memory operatorIds,\\n Cluster memory cluster\\n ) external;\\n\\n function owner() external view returns (address);\\n\\n function pendingOwner() external view returns (address);\\n\\n function proxiableUUID() external view returns (bytes32);\\n\\n function reactivate(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function reduceOperatorFee(uint64 operatorId, uint256 fee) external;\\n\\n function registerOperator(bytes memory publicKey, uint256 fee)\\n external\\n returns (uint64 id);\\n\\n function registerValidator(\\n bytes memory publicKey,\\n uint64[] memory operatorIds,\\n bytes memory sharesData,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function removeOperator(uint64 operatorId) external;\\n\\n function removeValidator(\\n bytes memory publicKey,\\n uint64[] memory operatorIds,\\n Cluster memory cluster\\n ) external;\\n\\n function renounceOwnership() external;\\n\\n function setFeeRecipientAddress(address recipientAddress) external;\\n\\n function setOperatorWhitelist(uint64 operatorId, address whitelisted)\\n external;\\n\\n function transferOwnership(address newOwner) external;\\n\\n function updateDeclareOperatorFeePeriod(uint64 timeInSeconds) external;\\n\\n function updateExecuteOperatorFeePeriod(uint64 timeInSeconds) external;\\n\\n function updateLiquidationThresholdPeriod(uint64 blocks) external;\\n\\n function updateMaximumOperatorFee(uint64 maxFee) external;\\n\\n function updateMinimumLiquidationCollateral(uint256 amount) external;\\n\\n function updateModule(uint8 moduleId, address moduleAddress) external;\\n\\n function updateNetworkFee(uint256 fee) external;\\n\\n function updateOperatorFeeIncreaseLimit(uint64 percentage) external;\\n\\n function upgradeTo(address newImplementation) external;\\n\\n function upgradeToAndCall(address newImplementation, bytes memory data)\\n external\\n payable;\\n\\n function withdraw(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function withdrawAllOperatorEarnings(uint64 operatorId) external;\\n\\n function withdrawNetworkEarnings(uint256 amount) external;\\n\\n function withdrawOperatorEarnings(uint64 operatorId, uint256 amount)\\n external;\\n}\\n\",\"keccak256\":\"0x76e2c5148727b72752939b06fee7abc1f732c18970b8c7db7fe7cdfe74629d36\",\"license\":\"MIT\"},\"contracts/interfaces/IStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Platform interface to integrate with lending platform like Compound, AAVE etc.\\n */\\ninterface IStrategy {\\n /**\\n * @dev Deposit the given asset to platform\\n * @param _asset asset address\\n * @param _amount Amount to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external;\\n\\n /**\\n * @dev Deposit the entire balance of all supported assets in the Strategy\\n * to the platform\\n */\\n function depositAll() external;\\n\\n /**\\n * @dev Withdraw given asset from Lending platform\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external;\\n\\n /**\\n * @dev Liquidate all assets in strategy and return them to Vault.\\n */\\n function withdrawAll() external;\\n\\n /**\\n * @dev Returns the current balance of the given asset.\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n returns (uint256 balance);\\n\\n /**\\n * @dev Returns bool indicating whether strategy supports asset.\\n */\\n function supportsAsset(address _asset) external view returns (bool);\\n\\n /**\\n * @dev Collect reward tokens from the Strategy.\\n */\\n function collectRewardTokens() external;\\n\\n /**\\n * @dev The address array of the reward tokens for the Strategy.\\n */\\n function getRewardTokenAddresses() external view returns (address[] memory);\\n}\\n\",\"keccak256\":\"0xb291e409a9b95527f9ed19cd6bff8eeb9921a21c1f5194a48c0bb9ce6613959a\",\"license\":\"MIT\"},\"contracts/interfaces/IVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { VaultStorage } from \\\"../vault/VaultStorage.sol\\\";\\n\\ninterface IVault {\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Governable.sol\\n function transferGovernance(address _newGovernor) external;\\n\\n function claimGovernance() external;\\n\\n function governor() external view returns (address);\\n\\n // VaultAdmin.sol\\n function setPriceProvider(address _priceProvider) external;\\n\\n function priceProvider() external view returns (address);\\n\\n function setRedeemFeeBps(uint256 _redeemFeeBps) external;\\n\\n function redeemFeeBps() external view returns (uint256);\\n\\n function setVaultBuffer(uint256 _vaultBuffer) external;\\n\\n function vaultBuffer() external view returns (uint256);\\n\\n function setAutoAllocateThreshold(uint256 _threshold) external;\\n\\n function autoAllocateThreshold() external view returns (uint256);\\n\\n function setRebaseThreshold(uint256 _threshold) external;\\n\\n function rebaseThreshold() external view returns (uint256);\\n\\n function setStrategistAddr(address _address) external;\\n\\n function strategistAddr() external view returns (address);\\n\\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external;\\n\\n function maxSupplyDiff() external view returns (uint256);\\n\\n function setTrusteeAddress(address _address) external;\\n\\n function trusteeAddress() external view returns (address);\\n\\n function setTrusteeFeeBps(uint256 _basis) external;\\n\\n function trusteeFeeBps() external view returns (uint256);\\n\\n function ousdMetaStrategy() external view returns (address);\\n\\n function setSwapper(address _swapperAddr) external;\\n\\n function setSwapAllowedUndervalue(uint16 _percentageBps) external;\\n\\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\\n external;\\n\\n function supportAsset(address _asset, uint8 _supportsAsset) external;\\n\\n function approveStrategy(address _addr) external;\\n\\n function removeStrategy(address _addr) external;\\n\\n function setAssetDefaultStrategy(address _asset, address _strategy)\\n external;\\n\\n function assetDefaultStrategies(address _asset)\\n external\\n view\\n returns (address);\\n\\n function pauseRebase() external;\\n\\n function unpauseRebase() external;\\n\\n function rebasePaused() external view returns (bool);\\n\\n function pauseCapital() external;\\n\\n function unpauseCapital() external;\\n\\n function capitalPaused() external view returns (bool);\\n\\n function transferToken(address _asset, uint256 _amount) external;\\n\\n function priceUnitMint(address asset) external view returns (uint256);\\n\\n function priceUnitRedeem(address asset) external view returns (uint256);\\n\\n function withdrawAllFromStrategy(address _strategyAddr) external;\\n\\n function withdrawAllFromStrategies() external;\\n\\n function withdrawFromStrategy(\\n address _strategyFromAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n function depositToStrategy(\\n address _strategyToAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n // VaultCore.sol\\n function mint(\\n address _asset,\\n uint256 _amount,\\n uint256 _minimumOusdAmount\\n ) external;\\n\\n function mintForStrategy(uint256 _amount) external;\\n\\n function redeem(uint256 _amount, uint256 _minimumUnitAmount) external;\\n\\n function burnForStrategy(uint256 _amount) external;\\n\\n function redeemAll(uint256 _minimumUnitAmount) external;\\n\\n function allocate() external;\\n\\n function rebase() external;\\n\\n function swapCollateral(\\n address fromAsset,\\n address toAsset,\\n uint256 fromAssetAmount,\\n uint256 minToAssetAmount,\\n bytes calldata data\\n ) external returns (uint256 toAssetAmount);\\n\\n function totalValue() external view returns (uint256 value);\\n\\n function checkBalance(address _asset) external view returns (uint256);\\n\\n function calculateRedeemOutputs(uint256 _amount)\\n external\\n view\\n returns (uint256[] memory);\\n\\n function getAssetCount() external view returns (uint256);\\n\\n function getAssetConfig(address _asset)\\n external\\n view\\n returns (VaultStorage.Asset memory config);\\n\\n function getAllAssets() external view returns (address[] memory);\\n\\n function getStrategyCount() external view returns (uint256);\\n\\n function swapper() external view returns (address);\\n\\n function allowedSwapUndervalue() external view returns (uint256);\\n\\n function getAllStrategies() external view returns (address[] memory);\\n\\n function isSupportedAsset(address _asset) external view returns (bool);\\n\\n function netOusdMintForStrategyThreshold() external view returns (uint256);\\n\\n function setOusdMetaStrategy(address _ousdMetaStrategy) external;\\n\\n function setNetOusdMintForStrategyThreshold(uint256 _threshold) external;\\n\\n function netOusdMintedForStrategy() external view returns (int256);\\n\\n function weth() external view returns (address);\\n\\n function cacheWETHAssetIndex() external;\\n\\n function wethAssetIndex() external view returns (uint256);\\n\\n function initialize(address, address) external;\\n\\n function setAdminImpl(address) external;\\n}\\n\",\"keccak256\":\"0xe8ab2f09127dc86bda14d2ad7f58d4f5ef214959101742f0dd977be3599f9d5f\",\"license\":\"MIT\"},\"contracts/interfaces/IWETH9.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IWETH9 {\\n event Approval(address indexed src, address indexed guy, uint256 wad);\\n event Deposit(address indexed dst, uint256 wad);\\n event Transfer(address indexed src, address indexed dst, uint256 wad);\\n event Withdrawal(address indexed src, uint256 wad);\\n\\n function allowance(address, address) external view returns (uint256);\\n\\n function approve(address guy, uint256 wad) external returns (bool);\\n\\n function balanceOf(address) external view returns (uint256);\\n\\n function decimals() external view returns (uint8);\\n\\n function deposit() external payable;\\n\\n function name() external view returns (string memory);\\n\\n function symbol() external view returns (string memory);\\n\\n function totalSupply() external view returns (uint256);\\n\\n function transfer(address dst, uint256 wad) external returns (bool);\\n\\n function transferFrom(\\n address src,\\n address dst,\\n uint256 wad\\n ) external returns (bool);\\n\\n function withdraw(uint256 wad) external;\\n}\\n\",\"keccak256\":\"0x05b7dce6c24d3cd4e48b5c6346d86e5e40ecc3291bcdf3f3ef091c98fc826519\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/FeeAccumulator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\n\\n/**\\n * @title Fee Accumulator for Native Staking SSV Strategy\\n * @notice Receives execution rewards which includes tx fees and\\n * MEV rewards like tx priority and tx ordering.\\n * It does NOT include swept ETH from beacon chain consensus rewards or full validator withdrawals.\\n * @author Origin Protocol Inc\\n */\\ncontract FeeAccumulator is Governable {\\n /// @notice The address of the Native Staking Strategy\\n address public immutable STRATEGY;\\n\\n /**\\n * @param _strategy Address of the Native Staking Strategy\\n */\\n constructor(address _strategy) {\\n STRATEGY = _strategy;\\n }\\n\\n /**\\n * @notice sends all ETH in this FeeAccumulator contract to the Native Staking Strategy.\\n * @return eth The amount of execution rewards that were sent to the Native Staking Strategy\\n */\\n function collect() external returns (uint256 eth) {\\n require(msg.sender == STRATEGY, \\\"Caller is not the Strategy\\\");\\n\\n eth = address(this).balance;\\n if (eth > 0) {\\n // Send the ETH to the Native Staking Strategy\\n Address.sendValue(payable(STRATEGY), eth);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xf47bcc46ce70f649f061bec3d2303f376a15700ba18fe471fba823f60bdfed8b\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { InitializableAbstractStrategy } from \\\"../../utils/InitializableAbstractStrategy.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\nimport { FeeAccumulator } from \\\"./FeeAccumulator.sol\\\";\\nimport { ValidatorAccountant } from \\\"./ValidatorAccountant.sol\\\";\\n\\nstruct ValidatorStakeData {\\n bytes pubkey;\\n bytes signature;\\n bytes32 depositDataRoot;\\n}\\n\\n/// @title Native Staking SSV Strategy\\n/// @notice Strategy to deploy funds into DVT validators powered by the SSV Network\\n/// @author Origin Protocol Inc\\ncontract NativeStakingSSVStrategy is\\n ValidatorAccountant,\\n InitializableAbstractStrategy\\n{\\n using SafeERC20 for IERC20;\\n\\n /// @notice SSV ERC20 token that serves as a payment for operating SSV validators\\n address public immutable SSV_TOKEN_ADDRESS;\\n /// @notice Fee collector address\\n /// @dev this address will receive Execution layer rewards - These are rewards earned for\\n /// executing transactions on the Ethereum network as part of block proposals. They include\\n /// priority fees (fees paid by users for their transactions to be included) and MEV rewards\\n /// (rewards for arranging transactions in a way that benefits the validator).\\n address public immutable FEE_ACCUMULATOR_ADDRESS;\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /// @param _baseConfig Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI,\\n /// and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _ssvToken Address of the Erc20 SSV Token contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n /// @param _feeAccumulator Address of the fee accumulator receiving execution layer validator rewards\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n constructor(\\n BaseStrategyConfig memory _baseConfig,\\n address _wethAddress,\\n address _ssvToken,\\n address _ssvNetwork,\\n address _feeAccumulator,\\n address _beaconChainDepositContract\\n )\\n InitializableAbstractStrategy(_baseConfig)\\n ValidatorAccountant(\\n _wethAddress,\\n _baseConfig.vaultAddress,\\n _beaconChainDepositContract,\\n _ssvNetwork\\n )\\n {\\n SSV_TOKEN_ADDRESS = _ssvToken;\\n FEE_ACCUMULATOR_ADDRESS = _feeAccumulator;\\n }\\n\\n /// @notice initialize function, to set up initial internal state\\n /// @param _rewardTokenAddresses Address of reward token for platform\\n /// @param _assets Addresses of initial supported assets\\n /// @param _pTokens Platform Token corresponding addresses\\n function initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) external onlyGovernor initializer {\\n InitializableAbstractStrategy._initialize(\\n _rewardTokenAddresses,\\n _assets,\\n _pTokens\\n );\\n }\\n\\n /// @dev Convert accumulated ETH to WETH and send to the Harvester.\\n /// Will revert if the strategy is paused for accounting.\\n function _collectRewardTokens() internal override whenNotPaused {\\n // collect ETH from execution rewards from the fee accumulator\\n uint256 executionRewards = FeeAccumulator(FEE_ACCUMULATOR_ADDRESS)\\n .collect();\\n\\n // total ETH rewards to be harvested = execution rewards + consensus rewards\\n uint256 ethRewards = executionRewards + consensusRewards;\\n\\n require(\\n address(this).balance >= ethRewards,\\n \\\"insufficient eth balance\\\"\\n );\\n\\n if (ethRewards > 0) {\\n // reset the counter keeping track of beacon chain consensus rewards\\n consensusRewards = 0;\\n\\n // Convert ETH rewards to WETH\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRewards }();\\n\\n emit RewardTokenCollected(\\n harvesterAddress,\\n WETH_TOKEN_ADDRESS,\\n ethRewards\\n );\\n IERC20(WETH_TOKEN_ADDRESS).safeTransfer(\\n harvesterAddress,\\n ethRewards\\n );\\n }\\n }\\n\\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\\n /// It just checks the asset is WETH and emits the Deposit event.\\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n /// @param _asset Address of asset to deposit. Has to be WETH.\\n /// @param _amount Amount of assets that were transferred to the strategy by the vault.\\n function deposit(address _asset, uint256 _amount)\\n external\\n override\\n onlyVault\\n nonReentrant\\n {\\n require(_asset == WETH_TOKEN_ADDRESS, \\\"Unsupported asset\\\");\\n _deposit(_asset, _amount);\\n }\\n\\n /// @dev Deposit WETH to this strategy so it can later be staked into a validator.\\n /// @param _asset Address of WETH\\n /// @param _amount Amount of WETH to deposit\\n function _deposit(address _asset, uint256 _amount) internal {\\n require(_amount > 0, \\\"Must deposit something\\\");\\n /*\\n * We could do a check here that would revert when \\\"_amount % 32 ether != 0\\\". With the idea of\\n * not allowing deposits that will result in WETH sitting on the strategy after all the possible batches\\n * of 32ETH have been staked.\\n * But someone could mess with our strategy by sending some WETH to it. And we might want to deposit just\\n * enough WETH to add it up to 32 so it can be staked. For that reason the check is left out.\\n *\\n * WETH sitting on the strategy won't interfere with the accounting since accounting only operates on ETH.\\n */\\n emit Deposit(_asset, address(0), _amount);\\n }\\n\\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\\n /// It just emits the Deposit event.\\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n function depositAll() external override onlyVault nonReentrant {\\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n if (wethBalance > 0) {\\n _deposit(WETH_TOKEN_ADDRESS, wethBalance);\\n }\\n }\\n\\n /// @notice Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That\\n /// can happen when:\\n /// - the deposit was not a multiple of 32 WETH\\n /// - someone sent WETH directly to this contract\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n /// @param _recipient Address to receive withdrawn assets\\n /// @param _asset WETH to withdraw\\n /// @param _amount Amount of WETH to withdraw\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external override onlyVault nonReentrant {\\n _withdraw(_recipient, _asset, _amount);\\n }\\n\\n function _withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) internal {\\n require(_amount > 0, \\\"Must withdraw something\\\");\\n require(_recipient != address(0), \\\"Must specify recipient\\\");\\n\\n emit Withdrawal(_asset, address(0), _amount);\\n IERC20(_asset).safeTransfer(_recipient, _amount);\\n }\\n\\n /// @notice transfer all WETH deposits back to the vault.\\n /// This does not withdraw from the validators. That has to be done separately with the\\n /// `exitSsvValidator` and `removeSsvValidator` operations.\\n /// This does not withdraw any execution rewards from the FeeAccumulator or\\n /// consensus rewards in this strategy.\\n /// Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn.\\n /// ETH from full validator withdrawals is sent to the Vault using `doAccounting`.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n if (wethBalance > 0) {\\n _withdraw(vaultAddress, WETH_TOKEN_ADDRESS, wethBalance);\\n }\\n }\\n\\n function _abstractSetPToken(address _asset, address) internal override {}\\n\\n /// @notice Returns the total value of (W)ETH that is staked to the validators\\n /// and WETH deposits that are still to be staked.\\n /// This does not include ETH from consensus rewards sitting in this strategy\\n /// or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested\\n /// and sent to the Dripper so will eventually be sent to the Vault as WETH.\\n /// @param _asset Address of weth asset\\n /// @return balance Total value of (W)ETH\\n function checkBalance(address _asset)\\n external\\n view\\n override\\n returns (uint256 balance)\\n {\\n require(_asset == WETH_TOKEN_ADDRESS, \\\"Unsupported asset\\\");\\n\\n balance =\\n // add the ETH that has been staked in validators\\n activeDepositedValidators *\\n 32 ether +\\n // add the WETH in the strategy from deposits that are still to be staked\\n IERC20(WETH_TOKEN_ADDRESS).balanceOf(address(this));\\n }\\n\\n function pause() external onlyStrategist {\\n _pause();\\n }\\n\\n /// @notice Returns bool indicating whether asset is supported by strategy.\\n /// @param _asset The address of the asset token.\\n function supportsAsset(address _asset) public view override returns (bool) {\\n return _asset == WETH_TOKEN_ADDRESS;\\n }\\n\\n /// @notice Approves the SSV Network contract to transfer SSV tokens for deposits\\n function safeApproveAllTokens() external override {\\n /// @dev Approves the SSV Network contract to transfer SSV tokens for deposits\\n IERC20(SSV_TOKEN_ADDRESS).approve(\\n SSV_NETWORK_ADDRESS,\\n type(uint256).max\\n );\\n }\\n\\n /**\\n * @notice Only accept ETH from the FeeAccumulator and the WETH contract - required when\\n * unwrapping WETH just before staking it to the validator\\n * @dev don't want to receive donations from anyone else as this will\\n * mess with the accounting of the consensus rewards and validator full withdrawals\\n */\\n receive() external payable {\\n require(\\n msg.sender == FEE_ACCUMULATOR_ADDRESS ||\\n msg.sender == WETH_TOKEN_ADDRESS,\\n \\\"eth not from allowed contracts\\\"\\n );\\n }\\n}\\n\",\"keccak256\":\"0x16d14755655e07e98a4758a1328a8117192b3cb8a4c74725b67c2584560fcb2d\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/ValidatorAccountant.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { ValidatorRegistrator } from \\\"./ValidatorRegistrator.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\n\\n/// @title Validator Accountant\\n/// @notice Attributes the ETH swept from beacon chain validators to this strategy contract\\n/// as either full or partial withdrawals. Partial withdrawals being consensus rewards.\\n/// Full withdrawals are from exited validators.\\n/// @author Origin Protocol Inc\\nabstract contract ValidatorAccountant is ValidatorRegistrator {\\n /// @notice The maximum amount of ETH that can be staked by a validator\\n /// @dev this can change in the future with EIP-7251, Increase the MAX_EFFECTIVE_BALANCE\\n uint256 public constant MAX_STAKE = 32 ether;\\n\\n /// @notice Keeps track of the total consensus rewards swept from the beacon chain\\n uint256 public consensusRewards = 0;\\n\\n /// @notice start of fuse interval\\n uint256 public fuseIntervalStart = 0;\\n /// @notice end of fuse interval\\n uint256 public fuseIntervalEnd = 0;\\n\\n uint256[50] private __gap;\\n\\n event FuseIntervalUpdated(uint256 start, uint256 end);\\n event AccountingFullyWithdrawnValidator(\\n uint256 noOfValidators,\\n uint256 remainingValidators,\\n uint256 wethSentToVault\\n );\\n event AccountingValidatorSlashed(\\n uint256 remainingValidators,\\n uint256 wethSentToVault\\n );\\n event AccountingConsensusRewards(uint256 amount);\\n\\n event AccountingManuallyFixed(\\n int256 validatorsDelta,\\n int256 consensusRewardsDelta,\\n uint256 wethToVault\\n );\\n\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _vaultAddress Address of the Vault\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n constructor(\\n address _wethAddress,\\n address _vaultAddress,\\n address _beaconChainDepositContract,\\n address _ssvNetwork\\n )\\n ValidatorRegistrator(\\n _wethAddress,\\n _vaultAddress,\\n _beaconChainDepositContract,\\n _ssvNetwork\\n )\\n {}\\n\\n /// @notice set fuse interval values\\n function setFuseInterval(\\n uint256 _fuseIntervalStart,\\n uint256 _fuseIntervalEnd\\n ) external onlyGovernor {\\n require(\\n _fuseIntervalStart < _fuseIntervalEnd &&\\n _fuseIntervalStart < 32 ether &&\\n _fuseIntervalEnd < 32 ether &&\\n _fuseIntervalEnd - _fuseIntervalStart >= 4 ether,\\n \\\"incorrect fuse interval\\\"\\n );\\n\\n emit FuseIntervalUpdated(_fuseIntervalStart, _fuseIntervalEnd);\\n\\n fuseIntervalStart = _fuseIntervalStart;\\n fuseIntervalEnd = _fuseIntervalEnd;\\n }\\n\\n /* solhint-disable max-line-length */\\n /// This notion page offers a good explanation of how the accounting functions\\n /// https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d\\n /// In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart,\\n /// the accounting function will treat that ETH as Beacon chain consensus rewards.\\n /// On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32,\\n /// the accounting function will treat that as a validator slashing.\\n /// @notice Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when\\n /// accounting is valid and fuse isn't \\\"blown\\\". Returns false when fuse is blown.\\n /// @dev This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it\\n /// for now.\\n /// @return accountingValid true if accounting was successful, false if fuse is blown\\n /* solhint-enable max-line-length */\\n function doAccounting()\\n external\\n onlyRegistrator\\n whenNotPaused\\n returns (bool accountingValid)\\n {\\n // pause the accounting on failure\\n accountingValid = _doAccounting(true);\\n }\\n\\n function _doAccounting(bool pauseOnFail)\\n internal\\n returns (bool accountingValid)\\n {\\n if (address(this).balance < consensusRewards) {\\n return _failAccounting(pauseOnFail);\\n }\\n\\n // Calculate all the new ETH that has been swept to the contract since the last accounting\\n uint256 newSweptETH = address(this).balance - consensusRewards;\\n accountingValid = true;\\n\\n // send the ETH that is from fully withdrawn validators to the Vault\\n if (newSweptETH >= MAX_STAKE) {\\n uint256 fullyWithdrawnValidators = newSweptETH / MAX_STAKE;\\n if (activeDepositedValidators < fullyWithdrawnValidators) {\\n return _failAccounting(pauseOnFail);\\n }\\n activeDepositedValidators -= fullyWithdrawnValidators;\\n\\n uint256 wethToVault = MAX_STAKE * fullyWithdrawnValidators;\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: wethToVault }();\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, wethToVault);\\n\\n emit AccountingFullyWithdrawnValidator(\\n fullyWithdrawnValidators,\\n activeDepositedValidators,\\n wethToVault\\n );\\n }\\n\\n uint256 ethRemaining = address(this).balance - consensusRewards;\\n // should be less than a whole validator stake\\n require(ethRemaining < 32 ether, \\\"unexpected accounting\\\");\\n\\n // If no Beacon chain consensus rewards swept\\n if (ethRemaining == 0) {\\n // do nothing\\n return accountingValid;\\n }\\n // Beacon chain consensus rewards swept (partial validator withdrawals)\\n else if (ethRemaining < fuseIntervalStart) {\\n // solhint-disable-next-line reentrancy\\n consensusRewards += ethRemaining;\\n emit AccountingConsensusRewards(ethRemaining);\\n }\\n // Beacon chain consensus rewards swept but also a slashed validator fully exited\\n else if (ethRemaining > fuseIntervalEnd) {\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRemaining }();\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, ethRemaining);\\n activeDepositedValidators -= 1;\\n\\n emit AccountingValidatorSlashed(\\n activeDepositedValidators,\\n ethRemaining\\n );\\n }\\n // Oh no... Fuse is blown. The Strategist needs to adjust the accounting values.\\n else {\\n return _failAccounting(pauseOnFail);\\n }\\n }\\n\\n /// @dev pause any further accounting if required and return false\\n function _failAccounting(bool pauseOnFail)\\n internal\\n returns (bool accountingValid)\\n {\\n // pause if not already\\n if (pauseOnFail) {\\n _pause();\\n }\\n // fail the accounting\\n accountingValid = false;\\n }\\n\\n /// @notice Allow the Strategist to fix the accounting of this strategy and unpause.\\n /// @param _validatorsDelta adjust the active validators by plus one, minus one or unchanged with zero\\n /// @param _wethToVaultAmount the amount of WETH to be sent to the Vault\\n /// @param _consensusRewardsDelta adjust the accounted for consensus rewards up or down\\n function manuallyFixAccounting(\\n int256 _validatorsDelta,\\n int256 _consensusRewardsDelta,\\n uint256 _wethToVaultAmount\\n ) external onlyStrategist whenPaused {\\n require(\\n _validatorsDelta >= -3 &&\\n _validatorsDelta <= 3 &&\\n // new value must be positive\\n int256(activeDepositedValidators) + _validatorsDelta >= 0,\\n \\\"invalid validatorsDelta\\\"\\n );\\n require(\\n _consensusRewardsDelta >= -332 ether &&\\n _consensusRewardsDelta <= 332 ether &&\\n // new value must be positive\\n int256(consensusRewards) + _consensusRewardsDelta >= 0,\\n \\\"invalid consensusRewardsDelta\\\"\\n );\\n require(_wethToVaultAmount <= 32 ether, \\\"invalid wethToVaultAmount\\\");\\n\\n emit AccountingManuallyFixed(\\n _validatorsDelta,\\n _consensusRewardsDelta,\\n _wethToVaultAmount\\n );\\n\\n activeDepositedValidators = uint256(\\n int256(activeDepositedValidators) + _validatorsDelta\\n );\\n consensusRewards = uint256(\\n int256(consensusRewards) + _consensusRewardsDelta\\n );\\n if (_wethToVaultAmount > 0) {\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(\\n VAULT_ADDRESS,\\n _wethToVaultAmount\\n );\\n }\\n\\n // rerun the accounting to see if it has now been fixed.\\n // Do not pause the accounting on failure as it is already paused\\n require(_doAccounting(false), \\\"fuse still blown\\\");\\n\\n // unpause since doAccounting was successful\\n _unpause();\\n }\\n}\\n\",\"keccak256\":\"0xc6c306bde6b18189944f3d03fc82996b2e0c54b3a2882ee8d0fece0d71949e11\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/ValidatorRegistrator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\nimport { IDepositContract } from \\\"../../interfaces/IDepositContract.sol\\\";\\nimport { IVault } from \\\"../../interfaces/IVault.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\nimport { ISSVNetwork, Cluster } from \\\"../../interfaces/ISSVNetwork.sol\\\";\\n\\nstruct ValidatorStakeData {\\n bytes pubkey;\\n bytes signature;\\n bytes32 depositDataRoot;\\n}\\n\\n/**\\n * @title Registrator of the validators\\n * @notice This contract implements all the required functionality to register, exit and remove validators.\\n * @author Origin Protocol Inc\\n */\\nabstract contract ValidatorRegistrator is Governable, Pausable {\\n /// @notice The address of the Wrapped ETH (WETH) token contract\\n address public immutable WETH_TOKEN_ADDRESS;\\n /// @notice The address of the beacon chain deposit contract\\n address public immutable BEACON_CHAIN_DEPOSIT_CONTRACT;\\n /// @notice The address of the SSV Network contract used to interface with\\n address public immutable SSV_NETWORK_ADDRESS;\\n /// @notice Address of the OETH Vault proxy contract\\n address public immutable VAULT_ADDRESS;\\n\\n /// @notice Address of the registrator - allowed to register, exit and remove validators\\n address public validatorRegistrator;\\n /// @notice The number of validators that have 32 (!) ETH actively deposited. When a new deposit\\n /// to a validator happens this number increases, when a validator exit is detected this number\\n /// decreases.\\n uint256 public activeDepositedValidators;\\n /// @notice State of the validators keccak256(pubKey) => state\\n mapping(bytes32 => VALIDATOR_STATE) public validatorsStates;\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n enum VALIDATOR_STATE {\\n REGISTERED, // validator is registered on the SSV network\\n STAKED, // validator has funds staked\\n EXITING, // exit message has been posted and validator is in the process of exiting\\n EXIT_COMPLETE // validator has funds withdrawn to the EigenPod and is removed from the SSV\\n }\\n\\n event RegistratorChanged(address newAddress);\\n event ETHStaked(bytes pubkey, uint256 amount, bytes withdrawal_credentials);\\n event SSVValidatorRegistered(bytes pubkey, uint64[] operatorIds);\\n event SSVValidatorExitInitiated(bytes pubkey, uint64[] operatorIds);\\n event SSVValidatorExitCompleted(bytes pubkey, uint64[] operatorIds);\\n\\n /// @dev Throws if called by any account other than the Registrator\\n modifier onlyRegistrator() {\\n require(\\n msg.sender == validatorRegistrator,\\n \\\"Caller is not the Registrator\\\"\\n );\\n _;\\n }\\n\\n /// @dev Throws if called by any account other than the Strategist\\n modifier onlyStrategist() {\\n require(\\n msg.sender == IVault(VAULT_ADDRESS).strategistAddr(),\\n \\\"Caller is not the Strategist\\\"\\n );\\n _;\\n }\\n\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _vaultAddress Address of the Vault\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n constructor(\\n address _wethAddress,\\n address _vaultAddress,\\n address _beaconChainDepositContract,\\n address _ssvNetwork\\n ) {\\n WETH_TOKEN_ADDRESS = _wethAddress;\\n BEACON_CHAIN_DEPOSIT_CONTRACT = _beaconChainDepositContract;\\n SSV_NETWORK_ADDRESS = _ssvNetwork;\\n VAULT_ADDRESS = _vaultAddress;\\n }\\n\\n /// @notice Set the address of the registrator which can register, exit and remove validators\\n function setRegistrator(address _address) external onlyGovernor {\\n emit RegistratorChanged(_address);\\n validatorRegistrator = _address;\\n }\\n\\n /// @notice Stakes WETH to the node validators\\n /// @param validators A list of validator data needed to stake.\\n /// The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot.\\n /// Only the registrator can call this function.\\n function stakeEth(ValidatorStakeData[] calldata validators)\\n external\\n onlyRegistrator\\n whenNotPaused\\n {\\n uint256 requiredETH = validators.length * 32 ether;\\n\\n // Check there is enough WETH from the deposits sitting in this strategy contract\\n require(\\n requiredETH <= IWETH9(WETH_TOKEN_ADDRESS).balanceOf(address(this)),\\n \\\"insufficient WETH\\\"\\n );\\n\\n // Convert required ETH from WETH\\n IWETH9(WETH_TOKEN_ADDRESS).withdraw(requiredETH);\\n\\n // For each validator\\n for (uint256 i = 0; i < validators.length; ) {\\n bytes32 pubkeyHash = keccak256(validators[i].pubkey);\\n VALIDATOR_STATE currentState = validatorsStates[pubkeyHash];\\n\\n require(\\n currentState == VALIDATOR_STATE.REGISTERED,\\n \\\"Validator not registered\\\"\\n );\\n\\n /* 0x01 to indicate that withdrawal credentials will contain an EOA address that the sweeping function\\n * can sweep funds to.\\n * bytes11(0) to fill up the required zeros\\n * remaining bytes20 are for the address\\n */\\n bytes memory withdrawal_credentials = abi.encodePacked(\\n bytes1(0x01),\\n bytes11(0),\\n address(this)\\n );\\n IDepositContract(BEACON_CHAIN_DEPOSIT_CONTRACT).deposit{\\n value: 32 ether\\n }(\\n validators[i].pubkey,\\n withdrawal_credentials,\\n validators[i].signature,\\n validators[i].depositDataRoot\\n );\\n\\n activeDepositedValidators += 1;\\n emit ETHStaked(\\n validators[i].pubkey,\\n 32 ether,\\n withdrawal_credentials\\n );\\n\\n validatorsStates[pubkeyHash] = VALIDATOR_STATE.STAKED;\\n\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /// @notice Registers a new validator in the SSV Cluster.\\n /// Only the registrator can call this function.\\n function registerSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds,\\n bytes calldata sharesData,\\n uint256 amount,\\n Cluster calldata cluster\\n ) external onlyRegistrator whenNotPaused {\\n ISSVNetwork(SSV_NETWORK_ADDRESS).registerValidator(\\n publicKey,\\n operatorIds,\\n sharesData,\\n amount,\\n cluster\\n );\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.REGISTERED;\\n emit SSVValidatorRegistered(publicKey, operatorIds);\\n }\\n\\n /// @notice Exit a validator from the Beacon chain.\\n /// The staked ETH will eventually swept to this native staking strategy.\\n /// Only the registrator can call this function.\\n function exitSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds\\n ) external onlyRegistrator whenNotPaused {\\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\\n require(currentState == VALIDATOR_STATE.STAKED, \\\"Validator not staked\\\");\\n\\n ISSVNetwork(SSV_NETWORK_ADDRESS).exitValidator(publicKey, operatorIds);\\n emit SSVValidatorExitInitiated(publicKey, operatorIds);\\n\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXITING;\\n }\\n\\n /// @notice Remove a validator from the SSV Cluster.\\n /// Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain.\\n /// If removed before the validator has exited the beacon chain will result in the validator being slashed.\\n /// Only the registrator can call this function.\\n function removeSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds,\\n Cluster calldata cluster\\n ) external onlyRegistrator whenNotPaused {\\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\\n require(\\n currentState == VALIDATOR_STATE.EXITING,\\n \\\"Validator not exiting\\\"\\n );\\n\\n ISSVNetwork(SSV_NETWORK_ADDRESS).removeValidator(\\n publicKey,\\n operatorIds,\\n cluster\\n );\\n emit SSVValidatorExitCompleted(publicKey, operatorIds);\\n\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXIT_COMPLETE;\\n }\\n\\n /// @notice Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\\n /// @dev A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds.\\n /// uses \\\"onlyStrategist\\\" modifier so continuous front-running can't DOS our maintenance service\\n /// that tries to top up SSV tokens.\\n /// @param cluster The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\\n function depositSSV(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external onlyStrategist {\\n ISSVNetwork(SSV_NETWORK_ADDRESS).deposit(\\n address(this),\\n operatorIds,\\n amount,\\n cluster\\n );\\n }\\n}\\n\",\"keccak256\":\"0x4bc23d19500e2d306fd546c4ab9c4c53292d4ef54392ec4f1ae62dd7601a3d24\",\"license\":\"MIT\"},\"contracts/token/OUSD.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OUSD Token Contract\\n * @dev ERC20 compatible contract for OUSD\\n * @dev Implements an elastic supply\\n * @author Origin Protocol Inc\\n */\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { InitializableERC20Detailed } from \\\"../utils/InitializableERC20Detailed.sol\\\";\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * NOTE that this is an ERC20 token but the invariant that the sum of\\n * balanceOf(x) for all x is not >= totalSupply(). This is a consequence of the\\n * rebasing design. Any integrations with OUSD should be aware.\\n */\\n\\ncontract OUSD is Initializable, InitializableERC20Detailed, Governable {\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n event TotalSupplyUpdatedHighres(\\n uint256 totalSupply,\\n uint256 rebasingCredits,\\n uint256 rebasingCreditsPerToken\\n );\\n event AccountRebasingEnabled(address account);\\n event AccountRebasingDisabled(address account);\\n\\n enum RebaseOptions {\\n NotSet,\\n OptOut,\\n OptIn\\n }\\n\\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\\n uint256 public _totalSupply;\\n mapping(address => mapping(address => uint256)) private _allowances;\\n address public vaultAddress = address(0);\\n mapping(address => uint256) private _creditBalances;\\n uint256 private _rebasingCredits;\\n uint256 private _rebasingCreditsPerToken;\\n // Frozen address/credits are non rebasing (value is held in contracts which\\n // do not receive yield unless they explicitly opt in)\\n uint256 public nonRebasingSupply;\\n mapping(address => uint256) public nonRebasingCreditsPerToken;\\n mapping(address => RebaseOptions) public rebaseState;\\n mapping(address => uint256) public isUpgraded;\\n\\n uint256 private constant RESOLUTION_INCREASE = 1e9;\\n\\n function initialize(\\n string calldata _nameArg,\\n string calldata _symbolArg,\\n address _vaultAddress,\\n uint256 _initialCreditsPerToken\\n ) external onlyGovernor initializer {\\n InitializableERC20Detailed._initialize(_nameArg, _symbolArg, 18);\\n _rebasingCreditsPerToken = _initialCreditsPerToken;\\n vaultAddress = _vaultAddress;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault contract\\n */\\n modifier onlyVault() {\\n require(vaultAddress == msg.sender, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @return The total supply of OUSD.\\n */\\n function totalSupply() public view override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @return Low resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerToken() public view returns (uint256) {\\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return Low resolution total number of rebasing credits\\n */\\n function rebasingCredits() public view returns (uint256) {\\n return _rebasingCredits / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return High resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\\n return _rebasingCreditsPerToken;\\n }\\n\\n /**\\n * @return High resolution total number of rebasing credits\\n */\\n function rebasingCreditsHighres() public view returns (uint256) {\\n return _rebasingCredits;\\n }\\n\\n /**\\n * @dev Gets the balance of the specified address.\\n * @param _account Address to query the balance of.\\n * @return A uint256 representing the amount of base units owned by the\\n * specified address.\\n */\\n function balanceOf(address _account)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n if (_creditBalances[_account] == 0) return 0;\\n return\\n _creditBalances[_account].divPrecisely(_creditsPerToken(_account));\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @dev Backwards compatible with old low res credits per token.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256) Credit balance and credits per token of the\\n * address\\n */\\n function creditsBalanceOf(address _account)\\n public\\n view\\n returns (uint256, uint256)\\n {\\n uint256 cpt = _creditsPerToken(_account);\\n if (cpt == 1e27) {\\n // For a period before the resolution upgrade, we created all new\\n // contract accounts at high resolution. Since they are not changing\\n // as a result of this upgrade, we will return their true values\\n return (_creditBalances[_account], cpt);\\n } else {\\n return (\\n _creditBalances[_account] / RESOLUTION_INCREASE,\\n cpt / RESOLUTION_INCREASE\\n );\\n }\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256, bool) Credit balance, credits per token of the\\n * address, and isUpgraded\\n */\\n function creditsBalanceOfHighres(address _account)\\n public\\n view\\n returns (\\n uint256,\\n uint256,\\n bool\\n )\\n {\\n return (\\n _creditBalances[_account],\\n _creditsPerToken(_account),\\n isUpgraded[_account] == 1\\n );\\n }\\n\\n /**\\n * @dev Transfer tokens to a specified address.\\n * @param _to the address to transfer to.\\n * @param _value the amount to be transferred.\\n * @return true on success.\\n */\\n function transfer(address _to, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(\\n _value <= balanceOf(msg.sender),\\n \\\"Transfer greater than balance\\\"\\n );\\n\\n _executeTransfer(msg.sender, _to, _value);\\n\\n emit Transfer(msg.sender, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Transfer tokens from one address to another.\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value The amount of tokens to be transferred.\\n */\\n function transferFrom(\\n address _from,\\n address _to,\\n uint256 _value\\n ) public override returns (bool) {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(_value <= balanceOf(_from), \\\"Transfer greater than balance\\\");\\n\\n _allowances[_from][msg.sender] = _allowances[_from][msg.sender].sub(\\n _value\\n );\\n\\n _executeTransfer(_from, _to, _value);\\n\\n emit Transfer(_from, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Update the count of non rebasing credits in response to a transfer\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value Amount of OUSD to transfer\\n */\\n function _executeTransfer(\\n address _from,\\n address _to,\\n uint256 _value\\n ) internal {\\n bool isNonRebasingTo = _isNonRebasingAccount(_to);\\n bool isNonRebasingFrom = _isNonRebasingAccount(_from);\\n\\n // Credits deducted and credited might be different due to the\\n // differing creditsPerToken used by each account\\n uint256 creditsCredited = _value.mulTruncate(_creditsPerToken(_to));\\n uint256 creditsDeducted = _value.mulTruncate(_creditsPerToken(_from));\\n\\n _creditBalances[_from] = _creditBalances[_from].sub(\\n creditsDeducted,\\n \\\"Transfer amount exceeds balance\\\"\\n );\\n _creditBalances[_to] = _creditBalances[_to].add(creditsCredited);\\n\\n if (isNonRebasingTo && !isNonRebasingFrom) {\\n // Transfer to non-rebasing account from rebasing account, credits\\n // are removed from the non rebasing tally\\n nonRebasingSupply = nonRebasingSupply.add(_value);\\n // Update rebasingCredits by subtracting the deducted amount\\n _rebasingCredits = _rebasingCredits.sub(creditsDeducted);\\n } else if (!isNonRebasingTo && isNonRebasingFrom) {\\n // Transfer to rebasing account from non-rebasing account\\n // Decreasing non-rebasing credits by the amount that was sent\\n nonRebasingSupply = nonRebasingSupply.sub(_value);\\n // Update rebasingCredits by adding the credited amount\\n _rebasingCredits = _rebasingCredits.add(creditsCredited);\\n }\\n }\\n\\n /**\\n * @dev Function to check the amount of tokens that _owner has allowed to\\n * `_spender`.\\n * @param _owner The address which owns the funds.\\n * @param _spender The address which will spend the funds.\\n * @return The number of tokens still available for the _spender.\\n */\\n function allowance(address _owner, address _spender)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n return _allowances[_owner][_spender];\\n }\\n\\n /**\\n * @dev Approve the passed address to spend the specified amount of tokens\\n * on behalf of msg.sender. This method is included for ERC20\\n * compatibility. `increaseAllowance` and `decreaseAllowance` should be\\n * used instead.\\n *\\n * Changing an allowance with this method brings the risk that someone\\n * may transfer both the old and the new allowance - if they are both\\n * greater than zero - if a transfer transaction is mined before the\\n * later approve() call is mined.\\n * @param _spender The address which will spend the funds.\\n * @param _value The amount of tokens to be spent.\\n */\\n function approve(address _spender, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _value;\\n emit Approval(msg.sender, _spender, _value);\\n return true;\\n }\\n\\n /**\\n * @dev Increase the amount of tokens that an owner has allowed to\\n * `_spender`.\\n * This method should be used instead of approve() to avoid the double\\n * approval vulnerability described above.\\n * @param _spender The address which will spend the funds.\\n * @param _addedValue The amount of tokens to increase the allowance by.\\n */\\n function increaseAllowance(address _spender, uint256 _addedValue)\\n public\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _allowances[msg.sender][_spender]\\n .add(_addedValue);\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Decrease the amount of tokens that an owner has allowed to\\n `_spender`.\\n * @param _spender The address which will spend the funds.\\n * @param _subtractedValue The amount of tokens to decrease the allowance\\n * by.\\n */\\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\\n public\\n returns (bool)\\n {\\n uint256 oldValue = _allowances[msg.sender][_spender];\\n if (_subtractedValue >= oldValue) {\\n _allowances[msg.sender][_spender] = 0;\\n } else {\\n _allowances[msg.sender][_spender] = oldValue.sub(_subtractedValue);\\n }\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Mints new tokens, increasing totalSupply.\\n */\\n function mint(address _account, uint256 _amount) external onlyVault {\\n _mint(_account, _amount);\\n }\\n\\n /**\\n * @dev Creates `_amount` tokens and assigns them to `_account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `to` cannot be the zero address.\\n */\\n function _mint(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Mint to the zero address\\\");\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n _creditBalances[_account] = _creditBalances[_account].add(creditAmount);\\n\\n // If the account is non rebasing and doesn't have a set creditsPerToken\\n // then set it i.e. this is a mint from a fresh contract\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.add(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.add(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.add(_amount);\\n\\n require(_totalSupply < MAX_SUPPLY, \\\"Max supply\\\");\\n\\n emit Transfer(address(0), _account, _amount);\\n }\\n\\n /**\\n * @dev Burns tokens, decreasing totalSupply.\\n */\\n function burn(address account, uint256 amount) external onlyVault {\\n _burn(account, amount);\\n }\\n\\n /**\\n * @dev Destroys `_amount` tokens from `_account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `_account` cannot be the zero address.\\n * - `_account` must have at least `_amount` tokens.\\n */\\n function _burn(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Burn from the zero address\\\");\\n if (_amount == 0) {\\n return;\\n }\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n uint256 currentCredits = _creditBalances[_account];\\n\\n // Remove the credits, burning rounding errors\\n if (\\n currentCredits == creditAmount || currentCredits - 1 == creditAmount\\n ) {\\n // Handle dust from rounding\\n _creditBalances[_account] = 0;\\n } else if (currentCredits > creditAmount) {\\n _creditBalances[_account] = _creditBalances[_account].sub(\\n creditAmount\\n );\\n } else {\\n revert(\\\"Remove exceeds balance\\\");\\n }\\n\\n // Remove from the credit tallies and non-rebasing supply\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.sub(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.sub(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.sub(_amount);\\n\\n emit Transfer(_account, address(0), _amount);\\n }\\n\\n /**\\n * @dev Get the credits per token for an account. Returns a fixed amount\\n * if the account is non-rebasing.\\n * @param _account Address of the account.\\n */\\n function _creditsPerToken(address _account)\\n internal\\n view\\n returns (uint256)\\n {\\n if (nonRebasingCreditsPerToken[_account] != 0) {\\n return nonRebasingCreditsPerToken[_account];\\n } else {\\n return _rebasingCreditsPerToken;\\n }\\n }\\n\\n /**\\n * @dev Is an account using rebasing accounting or non-rebasing accounting?\\n * Also, ensure contracts are non-rebasing if they have not opted in.\\n * @param _account Address of the account.\\n */\\n function _isNonRebasingAccount(address _account) internal returns (bool) {\\n bool isContract = Address.isContract(_account);\\n if (isContract && rebaseState[_account] == RebaseOptions.NotSet) {\\n _ensureRebasingMigration(_account);\\n }\\n return nonRebasingCreditsPerToken[_account] > 0;\\n }\\n\\n /**\\n * @dev Ensures internal account for rebasing and non-rebasing credits and\\n * supply is updated following deployment of frozen yield change.\\n */\\n function _ensureRebasingMigration(address _account) internal {\\n if (nonRebasingCreditsPerToken[_account] == 0) {\\n emit AccountRebasingDisabled(_account);\\n if (_creditBalances[_account] == 0) {\\n // Since there is no existing balance, we can directly set to\\n // high resolution, and do not have to do any other bookkeeping\\n nonRebasingCreditsPerToken[_account] = 1e27;\\n } else {\\n // Migrate an existing account:\\n\\n // Set fixed credits per token for this account\\n nonRebasingCreditsPerToken[_account] = _rebasingCreditsPerToken;\\n // Update non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(_account));\\n // Update credit tallies\\n _rebasingCredits = _rebasingCredits.sub(\\n _creditBalances[_account]\\n );\\n }\\n }\\n }\\n\\n /**\\n * @notice Enable rebasing for an account.\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n * @param _account Address of the account.\\n */\\n function governanceRebaseOptIn(address _account)\\n public\\n nonReentrant\\n onlyGovernor\\n {\\n _rebaseOptIn(_account);\\n }\\n\\n /**\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n */\\n function rebaseOptIn() public nonReentrant {\\n _rebaseOptIn(msg.sender);\\n }\\n\\n function _rebaseOptIn(address _account) internal {\\n require(_isNonRebasingAccount(_account), \\\"Account has not opted out\\\");\\n\\n // Convert balance into the same amount at the current exchange rate\\n uint256 newCreditBalance = _creditBalances[_account]\\n .mul(_rebasingCreditsPerToken)\\n .div(_creditsPerToken(_account));\\n\\n // Decreasing non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.sub(balanceOf(_account));\\n\\n _creditBalances[_account] = newCreditBalance;\\n\\n // Increase rebasing credits, totalSupply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.add(_creditBalances[_account]);\\n\\n rebaseState[_account] = RebaseOptions.OptIn;\\n\\n // Delete any fixed credits per token\\n delete nonRebasingCreditsPerToken[_account];\\n emit AccountRebasingEnabled(_account);\\n }\\n\\n /**\\n * @dev Explicitly mark that an address is non-rebasing.\\n */\\n function rebaseOptOut() public nonReentrant {\\n require(!_isNonRebasingAccount(msg.sender), \\\"Account has not opted in\\\");\\n\\n // Increase non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(msg.sender));\\n // Set fixed credits per token\\n nonRebasingCreditsPerToken[msg.sender] = _rebasingCreditsPerToken;\\n\\n // Decrease rebasing credits, total supply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.sub(_creditBalances[msg.sender]);\\n\\n // Mark explicitly opted out of rebasing\\n rebaseState[msg.sender] = RebaseOptions.OptOut;\\n emit AccountRebasingDisabled(msg.sender);\\n }\\n\\n /**\\n * @dev Modify the supply without minting new tokens. This uses a change in\\n * the exchange rate between \\\"credits\\\" and OUSD tokens to change balances.\\n * @param _newTotalSupply New total supply of OUSD.\\n */\\n function changeSupply(uint256 _newTotalSupply)\\n external\\n onlyVault\\n nonReentrant\\n {\\n require(_totalSupply > 0, \\\"Cannot increase 0 supply\\\");\\n\\n if (_totalSupply == _newTotalSupply) {\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n return;\\n }\\n\\n _totalSupply = _newTotalSupply > MAX_SUPPLY\\n ? MAX_SUPPLY\\n : _newTotalSupply;\\n\\n _rebasingCreditsPerToken = _rebasingCredits.divPrecisely(\\n _totalSupply.sub(nonRebasingSupply)\\n );\\n\\n require(_rebasingCreditsPerToken > 0, \\\"Invalid change in supply\\\");\\n\\n _totalSupply = _rebasingCredits\\n .divPrecisely(_rebasingCreditsPerToken)\\n .add(nonRebasingSupply);\\n\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n }\\n}\\n\",\"keccak256\":\"0x2dc66b1ba02716d64eb47dd9117fda62650d8b57669e6c351437e0ad29ad5f19\",\"license\":\"MIT\"},\"contracts/utils/Helpers.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IBasicToken } from \\\"../interfaces/IBasicToken.sol\\\";\\n\\nlibrary Helpers {\\n /**\\n * @notice Fetch the `symbol()` from an ERC20 token\\n * @dev Grabs the `symbol()` from a contract\\n * @param _token Address of the ERC20 token\\n * @return string Symbol of the ERC20 token\\n */\\n function getSymbol(address _token) internal view returns (string memory) {\\n string memory symbol = IBasicToken(_token).symbol();\\n return symbol;\\n }\\n\\n /**\\n * @notice Fetch the `decimals()` from an ERC20 token\\n * @dev Grabs the `decimals()` from a contract and fails if\\n * the decimal value does not live within a certain range\\n * @param _token Address of the ERC20 token\\n * @return uint256 Decimals of the ERC20 token\\n */\\n function getDecimals(address _token) internal view returns (uint256) {\\n uint256 decimals = IBasicToken(_token).decimals();\\n require(\\n decimals >= 4 && decimals <= 18,\\n \\\"Token must have sufficient decimal places\\\"\\n );\\n\\n return decimals;\\n }\\n}\\n\",\"keccak256\":\"0x108b7a69e0140da0072ca18f90a03a3340574400f81aa6076cd2cccdf13699c2\",\"license\":\"MIT\"},\"contracts/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract any contracts that need to initialize state after deployment.\\n * @author Origin Protocol Inc\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n */\\n bool private initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private initializing;\\n\\n /**\\n * @dev Modifier to protect an initializer function from being invoked twice.\\n */\\n modifier initializer() {\\n require(\\n initializing || !initialized,\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n\\n bool isTopLevelCall = !initializing;\\n if (isTopLevelCall) {\\n initializing = true;\\n initialized = true;\\n }\\n\\n _;\\n\\n if (isTopLevelCall) {\\n initializing = false;\\n }\\n }\\n\\n uint256[50] private ______gap;\\n}\\n\",\"keccak256\":\"0xaadbcc138114afed4af4f353c2ced2916e6ee14be91434789187f192caf0d786\",\"license\":\"MIT\"},\"contracts/utils/InitializableAbstractStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract for vault strategies.\\n * @author Origin Protocol Inc\\n */\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\n\\nabstract contract InitializableAbstractStrategy is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event PTokenAdded(address indexed _asset, address _pToken);\\n event PTokenRemoved(address indexed _asset, address _pToken);\\n event Deposit(address indexed _asset, address _pToken, uint256 _amount);\\n event Withdrawal(address indexed _asset, address _pToken, uint256 _amount);\\n event RewardTokenCollected(\\n address recipient,\\n address rewardToken,\\n uint256 amount\\n );\\n event RewardTokenAddressesUpdated(\\n address[] _oldAddresses,\\n address[] _newAddresses\\n );\\n event HarvesterAddressesUpdated(\\n address _oldHarvesterAddress,\\n address _newHarvesterAddress\\n );\\n\\n /// @notice Address of the underlying platform\\n address public immutable platformAddress;\\n /// @notice Address of the OToken vault\\n address public immutable vaultAddress;\\n\\n /// @dev Replaced with an immutable variable\\n // slither-disable-next-line constable-states\\n address private _deprecated_platformAddress;\\n\\n /// @dev Replaced with an immutable\\n // slither-disable-next-line constable-states\\n address private _deprecated_vaultAddress;\\n\\n /// @notice asset => pToken (Platform Specific Token Address)\\n mapping(address => address) public assetToPToken;\\n\\n /// @notice Full list of all assets supported by the strategy\\n address[] internal assetsMapped;\\n\\n // Deprecated: Reward token address\\n // slither-disable-next-line constable-states\\n address private _deprecated_rewardTokenAddress;\\n\\n // Deprecated: now resides in Harvester's rewardTokenConfigs\\n // slither-disable-next-line constable-states\\n uint256 private _deprecated_rewardLiquidationThreshold;\\n\\n /// @notice Address of the Harvester contract allowed to collect reward tokens\\n address public harvesterAddress;\\n\\n /// @notice Address of the reward tokens. eg CRV, BAL, CVX, AURA\\n address[] public rewardTokenAddresses;\\n\\n /* Reserved for future expansion. Used to be 100 storage slots\\n * and has decreased to accommodate:\\n * - harvesterAddress\\n * - rewardTokenAddresses\\n */\\n int256[98] private _reserved;\\n\\n struct BaseStrategyConfig {\\n address platformAddress; // Address of the underlying platform\\n address vaultAddress; // Address of the OToken's Vault\\n }\\n\\n /**\\n * @param _config The platform and OToken vault addresses\\n */\\n constructor(BaseStrategyConfig memory _config) {\\n platformAddress = _config.platformAddress;\\n vaultAddress = _config.vaultAddress;\\n }\\n\\n /**\\n * @dev Internal initialize function, to set up initial internal state\\n * @param _rewardTokenAddresses Address of reward token for platform\\n * @param _assets Addresses of initial supported assets\\n * @param _pTokens Platform Token corresponding addresses\\n */\\n function _initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) internal {\\n rewardTokenAddresses = _rewardTokenAddresses;\\n\\n uint256 assetCount = _assets.length;\\n require(assetCount == _pTokens.length, \\\"Invalid input arrays\\\");\\n for (uint256 i = 0; i < assetCount; ++i) {\\n _setPTokenAddress(_assets[i], _pTokens[i]);\\n }\\n }\\n\\n /**\\n * @notice Collect accumulated reward token and send to Vault.\\n */\\n function collectRewardTokens() external virtual onlyHarvester nonReentrant {\\n _collectRewardTokens();\\n }\\n\\n /**\\n * @dev Default implementation that transfers reward tokens to the Harvester\\n * Implementing strategies need to add custom logic to collect the rewards.\\n */\\n function _collectRewardTokens() internal virtual {\\n uint256 rewardTokenCount = rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n IERC20 rewardToken = IERC20(rewardTokenAddresses[i]);\\n uint256 balance = rewardToken.balanceOf(address(this));\\n if (balance > 0) {\\n emit RewardTokenCollected(\\n harvesterAddress,\\n address(rewardToken),\\n balance\\n );\\n rewardToken.safeTransfer(harvesterAddress, balance);\\n }\\n }\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault.\\n */\\n modifier onlyVault() {\\n require(msg.sender == vaultAddress, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Harvester.\\n */\\n modifier onlyHarvester() {\\n require(msg.sender == harvesterAddress, \\\"Caller is not the Harvester\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault or Governor.\\n */\\n modifier onlyVaultOrGovernor() {\\n require(\\n msg.sender == vaultAddress || msg.sender == governor(),\\n \\\"Caller is not the Vault or Governor\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault, Governor, or Strategist.\\n */\\n modifier onlyVaultOrGovernorOrStrategist() {\\n require(\\n msg.sender == vaultAddress ||\\n msg.sender == governor() ||\\n msg.sender == IVault(vaultAddress).strategistAddr(),\\n \\\"Caller is not the Vault, Governor, or Strategist\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @notice Set the reward token addresses. Any old addresses will be overwritten.\\n * @param _rewardTokenAddresses Array of reward token addresses\\n */\\n function setRewardTokenAddresses(address[] calldata _rewardTokenAddresses)\\n external\\n onlyGovernor\\n {\\n uint256 rewardTokenCount = _rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n require(\\n _rewardTokenAddresses[i] != address(0),\\n \\\"Can not set an empty address as a reward token\\\"\\n );\\n }\\n\\n emit RewardTokenAddressesUpdated(\\n rewardTokenAddresses,\\n _rewardTokenAddresses\\n );\\n rewardTokenAddresses = _rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Get the reward token addresses.\\n * @return address[] the reward token addresses.\\n */\\n function getRewardTokenAddresses()\\n external\\n view\\n returns (address[] memory)\\n {\\n return rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * This method can only be called by the system Governor\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function setPTokenAddress(address _asset, address _pToken)\\n external\\n virtual\\n onlyGovernor\\n {\\n _setPTokenAddress(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Remove a supported asset by passing its index.\\n * This method can only be called by the system Governor\\n * @param _assetIndex Index of the asset to be removed\\n */\\n function removePToken(uint256 _assetIndex) external virtual onlyGovernor {\\n require(_assetIndex < assetsMapped.length, \\\"Invalid index\\\");\\n address asset = assetsMapped[_assetIndex];\\n address pToken = assetToPToken[asset];\\n\\n if (_assetIndex < assetsMapped.length - 1) {\\n assetsMapped[_assetIndex] = assetsMapped[assetsMapped.length - 1];\\n }\\n assetsMapped.pop();\\n assetToPToken[asset] = address(0);\\n\\n emit PTokenRemoved(asset, pToken);\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * Add to internal mappings and execute the platform specific,\\n * abstract method `_abstractSetPToken`\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function _setPTokenAddress(address _asset, address _pToken) internal {\\n require(assetToPToken[_asset] == address(0), \\\"pToken already set\\\");\\n require(\\n _asset != address(0) && _pToken != address(0),\\n \\\"Invalid addresses\\\"\\n );\\n\\n assetToPToken[_asset] = _pToken;\\n assetsMapped.push(_asset);\\n\\n emit PTokenAdded(_asset, _pToken);\\n\\n _abstractSetPToken(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\\n * strategy contracts, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n public\\n onlyGovernor\\n {\\n require(!supportsAsset(_asset), \\\"Cannot transfer supported asset\\\");\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @notice Set the Harvester contract that can collect rewards.\\n * @param _harvesterAddress Address of the harvester contract.\\n */\\n function setHarvesterAddress(address _harvesterAddress)\\n external\\n onlyGovernor\\n {\\n emit HarvesterAddressesUpdated(harvesterAddress, _harvesterAddress);\\n harvesterAddress = _harvesterAddress;\\n }\\n\\n /***************************************\\n Abstract\\n ****************************************/\\n\\n function _abstractSetPToken(address _asset, address _pToken)\\n internal\\n virtual;\\n\\n function safeApproveAllTokens() external virtual;\\n\\n /**\\n * @notice Deposit an amount of assets into the platform\\n * @param _asset Address for the asset\\n * @param _amount Units of asset to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external virtual;\\n\\n /**\\n * @notice Deposit all supported assets in this strategy contract to the platform\\n */\\n function depositAll() external virtual;\\n\\n /**\\n * @notice Withdraw an `amount` of assets from the platform and\\n * send to the `_recipient`.\\n * @param _recipient Address to which the asset should be sent\\n * @param _asset Address of the asset\\n * @param _amount Units of asset to withdraw\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external virtual;\\n\\n /**\\n * @notice Withdraw all supported assets from platform and\\n * sends to the OToken's Vault.\\n */\\n function withdrawAll() external virtual;\\n\\n /**\\n * @notice Get the total asset value held in the platform.\\n * This includes any interest that was generated since depositing.\\n * @param _asset Address of the asset\\n * @return balance Total value of the asset in the platform\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n virtual\\n returns (uint256 balance);\\n\\n /**\\n * @notice Check if an asset is supported.\\n * @param _asset Address of the asset\\n * @return bool Whether asset is supported\\n */\\n function supportsAsset(address _asset) public view virtual returns (bool);\\n}\\n\",\"keccak256\":\"0x5e17bb3db9f9e1014b7c5c836547f8fa81e02af7568c0bb8f2a2e0e7c2192db4\",\"license\":\"MIT\"},\"contracts/utils/InitializableERC20Detailed.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/**\\n * @dev Optional functions from the ERC20 standard.\\n * Converted from openzeppelin/contracts/token/ERC20/ERC20Detailed.sol\\n * @author Origin Protocol Inc\\n */\\nabstract contract InitializableERC20Detailed is IERC20 {\\n // Storage gap to skip storage from prior to OUSD reset\\n uint256[100] private _____gap;\\n\\n string private _name;\\n string private _symbol;\\n uint8 private _decimals;\\n\\n /**\\n * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of\\n * these values are immutable: they can only be set once during\\n * construction.\\n * @notice To avoid variable shadowing appended `Arg` after arguments name.\\n */\\n function _initialize(\\n string memory nameArg,\\n string memory symbolArg,\\n uint8 decimalsArg\\n ) internal {\\n _name = nameArg;\\n _symbol = symbolArg;\\n _decimals = decimalsArg;\\n }\\n\\n /**\\n * @notice Returns the name of the token.\\n */\\n function name() public view returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @notice Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @notice Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5,05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view returns (uint8) {\\n return _decimals;\\n }\\n}\\n\",\"keccak256\":\"0xe35ac2d813a30d845a3b52bba72588d7e936c2b3f3373d15568c14db46aeed60\",\"license\":\"MIT\"},\"contracts/utils/StableMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\n\\n// Based on StableMath from Stability Labs Pty. Ltd.\\n// https://github.com/mstable/mStable-contracts/blob/master/contracts/shared/StableMath.sol\\n\\nlibrary StableMath {\\n using SafeMath for uint256;\\n\\n /**\\n * @dev Scaling unit for use in specific calculations,\\n * where 1 * 10**18, or 1e18 represents a unit '1'\\n */\\n uint256 private constant FULL_SCALE = 1e18;\\n\\n /***************************************\\n Helpers\\n ****************************************/\\n\\n /**\\n * @dev Adjust the scale of an integer\\n * @param to Decimals to scale to\\n * @param from Decimals to scale from\\n */\\n function scaleBy(\\n uint256 x,\\n uint256 to,\\n uint256 from\\n ) internal pure returns (uint256) {\\n if (to > from) {\\n x = x.mul(10**(to - from));\\n } else if (to < from) {\\n // slither-disable-next-line divide-before-multiply\\n x = x.div(10**(from - to));\\n }\\n return x;\\n }\\n\\n /***************************************\\n Precise Arithmetic\\n ****************************************/\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncate(uint256 x, uint256 y) internal pure returns (uint256) {\\n return mulTruncateScale(x, y, FULL_SCALE);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the given scale. For example,\\n * when calculating 90% of 10e18, (10e18 * 9e17) / 1e18 = (9e36) / 1e18 = 9e18\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @param scale Scale unit\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncateScale(\\n uint256 x,\\n uint256 y,\\n uint256 scale\\n ) internal pure returns (uint256) {\\n // e.g. assume scale = fullScale\\n // z = 10e18 * 9e17 = 9e36\\n uint256 z = x.mul(y);\\n // return 9e36 / 1e18 = 9e18\\n return z.div(scale);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale, rounding up the result\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit, rounded up to the closest base unit.\\n */\\n function mulTruncateCeil(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e17 * 17268172638 = 138145381104e17\\n uint256 scaled = x.mul(y);\\n // e.g. 138145381104e17 + 9.99...e17 = 138145381113.99...e17\\n uint256 ceil = scaled.add(FULL_SCALE.sub(1));\\n // e.g. 13814538111.399...e18 / 1e18 = 13814538111\\n return ceil.div(FULL_SCALE);\\n }\\n\\n /**\\n * @dev Precisely divides two units, by first scaling the left hand operand. Useful\\n * for finding percentage weightings, i.e. 8e18/10e18 = 80% (or 8e17)\\n * @param x Left hand input to division\\n * @param y Right hand input to division\\n * @return Result after multiplying the left operand by the scale, and\\n * executing the division on the right hand input.\\n */\\n function divPrecisely(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e18 * 1e18 = 8e36\\n uint256 z = x.mul(FULL_SCALE);\\n // e.g. 8e36 / 10e18 = 8e17\\n return z.div(y);\\n }\\n}\\n\",\"keccak256\":\"0x1eb49f6f79045d9e0a8e1dced8e01d9e559e5fac554dcbb53e43140b601b04e7\",\"license\":\"MIT\"},\"contracts/vault/VaultStorage.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OToken VaultStorage contract\\n * @notice The VaultStorage contract defines the storage for the Vault contracts\\n * @author Origin Protocol Inc\\n */\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { OUSD } from \\\"../token/OUSD.sol\\\";\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\ncontract VaultStorage is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event OusdMetaStrategyUpdated(address _ousdMetaStrategy);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event NetOusdMintForStrategyThresholdChanged(uint256 _threshold);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Assets supported by the Vault, i.e. Stablecoins\\n enum UnitConversion {\\n DECIMALS,\\n GETEXCHANGERATE\\n }\\n // Changed to fit into a single storage slot so the decimals needs to be recached\\n struct Asset {\\n // Note: OETHVaultCore doesn't use `isSupported` when minting,\\n // redeeming or checking balance of assets.\\n bool isSupported;\\n UnitConversion unitConversion;\\n uint8 decimals;\\n // Max allowed slippage from the Oracle price when swapping collateral assets in basis points.\\n // For example 40 == 0.4% slippage\\n uint16 allowedOracleSlippageBps;\\n }\\n\\n /// @dev mapping of supported vault assets to their configuration\\n // slither-disable-next-line uninitialized-state\\n mapping(address => Asset) internal assets;\\n /// @dev list of all assets supported by the vault.\\n // slither-disable-next-line uninitialized-state\\n address[] internal allAssets;\\n\\n // Strategies approved for use by the Vault\\n struct Strategy {\\n bool isSupported;\\n uint256 _deprecated; // Deprecated storage slot\\n }\\n /// @dev mapping of strategy contracts to their configiration\\n mapping(address => Strategy) internal strategies;\\n /// @dev list of all vault strategies\\n address[] internal allStrategies;\\n\\n /// @notice Address of the Oracle price provider contract\\n // slither-disable-next-line uninitialized-state\\n address public priceProvider;\\n /// @notice pause rebasing if true\\n bool public rebasePaused = false;\\n /// @notice pause operations that change the OToken supply.\\n /// eg mint, redeem, allocate, mint/burn for strategy\\n bool public capitalPaused = true;\\n /// @notice Redemption fee in basis points. eg 50 = 0.5%\\n uint256 public redeemFeeBps;\\n /// @notice Percentage of assets to keep in Vault to handle (most) withdrawals. 100% = 1e18.\\n uint256 public vaultBuffer;\\n /// @notice OToken mints over this amount automatically allocate funds. 18 decimals.\\n uint256 public autoAllocateThreshold;\\n /// @notice OToken mints over this amount automatically rebase. 18 decimals.\\n uint256 public rebaseThreshold;\\n\\n /// @dev Address of the OToken token. eg OUSD or OETH.\\n // slither-disable-next-line uninitialized-state\\n OUSD internal oUSD;\\n\\n //keccak256(\\\"OUSD.vault.governor.admin.impl\\\");\\n bytes32 constant adminImplPosition =\\n 0xa2bd3d3cf188a41358c8b401076eb59066b09dec5775650c0de4c55187d17bd9;\\n\\n // Address of the contract responsible for post rebase syncs with AMMs\\n address private _deprecated_rebaseHooksAddr = address(0);\\n\\n // Deprecated: Address of Uniswap\\n // slither-disable-next-line constable-states\\n address private _deprecated_uniswapAddr = address(0);\\n\\n /// @notice Address of the Strategist\\n address public strategistAddr = address(0);\\n\\n /// @notice Mapping of asset address to the Strategy that they should automatically\\n // be allocated to\\n // slither-disable-next-line uninitialized-state\\n mapping(address => address) public assetDefaultStrategies;\\n\\n /// @notice Max difference between total supply and total value of assets. 18 decimals.\\n // slither-disable-next-line uninitialized-state\\n uint256 public maxSupplyDiff;\\n\\n /// @notice Trustee contract that can collect a percentage of yield\\n address public trusteeAddress;\\n\\n /// @notice Amount of yield collected in basis points. eg 2000 = 20%\\n uint256 public trusteeFeeBps;\\n\\n /// @dev Deprecated: Tokens that should be swapped for stablecoins\\n address[] private _deprecated_swapTokens;\\n\\n uint256 constant MINT_MINIMUM_UNIT_PRICE = 0.998e18;\\n\\n /// @notice Metapool strategy that is allowed to mint/burn OTokens without changing collateral\\n address public ousdMetaStrategy = address(0);\\n\\n /// @notice How much OTokens are currently minted by the strategy\\n int256 public netOusdMintedForStrategy = 0;\\n\\n /// @notice How much net total OTokens are allowed to be minted by all strategies\\n uint256 public netOusdMintForStrategyThreshold = 0;\\n\\n uint256 constant MIN_UNIT_PRICE_DRIFT = 0.7e18;\\n uint256 constant MAX_UNIT_PRICE_DRIFT = 1.3e18;\\n\\n /// @notice Collateral swap configuration.\\n /// @dev is packed into a single storage slot to save gas.\\n struct SwapConfig {\\n // Contract that swaps the vault's collateral assets\\n address swapper;\\n // Max allowed percentage the total value can drop below the total supply in basis points.\\n // For example 100 == 1%\\n uint16 allowedUndervalueBps;\\n }\\n SwapConfig internal swapConfig = SwapConfig(address(0), 0);\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /**\\n * @notice set the implementation for the admin, this needs to be in a base class else we cannot set it\\n * @param newImpl address of the implementation\\n */\\n function setAdminImpl(address newImpl) external onlyGovernor {\\n require(\\n Address.isContract(newImpl),\\n \\\"new implementation is not a contract\\\"\\n );\\n bytes32 position = adminImplPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newImpl)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xbcefeb5e2b88d99a54dbe6542dc25d0a68eeaf3adfe6e12fb70049cc024b1a79\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x610180604052600060685560006069556000606a553480156200002157600080fd5b5060405162004c9a38038062004c9a833981016040819052620000449162000147565b8585876020015183868383838362000062336200011760201b60201c565b60008051602062004c7a833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36033805460ff191690556001600160601b0319606094851b811660805291841b821660a052831b811660c05290821b811660e0528651821b811661010052602090960151811b86166101205298891b851661014052505050509190931b1661016052506200022292505050565b60008051602062004c7a83398151915255565b80516001600160a01b03811681146200014257600080fd5b919050565b60008060008060008086880360e08112156200016257600080fd5b60408112156200017157600080fd5b50604080519081016001600160401b0381118282101715620001a357634e487b7160e01b600052604160045260246000fd5b604052620001b1886200012a565b8152620001c1602089016200012a565b60208201529550620001d6604088016200012a565b9450620001e6606088016200012a565b9350620001f6608088016200012a565b92506200020660a088016200012a565b91506200021660c088016200012a565b90509295509295509295565b60805160601c60a05160601c60c05160601c60e05160601c6101005160601c6101205160601c6101405160601c6101605160601c6148c2620003b8600039600081816102a70152818161096e0152612da901526000818161057d01526122fc01526000818161045101528181610d41015281816118c001528181611a390152818161265b01526128e30152600061093a0152600081816106ec01528181610b09015281816117ee01528181611a8901528181611d6c0152818161332201526135730152600081816109b701528181610bdf015281816116c0015281816122cc015281816123e401526127d90152600081816108a601526114070152600081816102d9015281816104db015281816107bd01528181610a7001528181610db601528181610f850152818161100d015281816111bc01528181611297015281816119aa01528181611a5a01528181611d9b0152818161296e015281816129fd01528181612eae01528181612f3301528181612fa70152818161329c01528181613351015281816134ed01526135a201526148c26000f3fe6080604052600436106102975760003560e01c8063853828b61161015a578063c2e1e3f4116100c1578063d9f00ec71161007a578063d9f00ec714610908578063dbe55e5614610928578063dd505df61461095c578063de5f626814610990578063f1188e40146109a5578063f6ca71b0146109d957600080fd5b8063c2e1e3f414610842578063c7af335214610862578063c98517c514610877578063cceab75014610894578063d38bfff4146108c8578063d9caed12146108e857600080fd5b80639da0e462116101135780639da0e4621461074e578063a4f98af41461078b578063aa388af6146107a0578063ab12edf5146107ed578063ad1728cb1461080d578063bb1b918d1461082257600080fd5b8063853828b61461068057806387bae867146106955780638d7c0e46146106ba5780639092c31c146106da5780639136616a1461070e57806396d538bb1461072e57600080fd5b80635c975abb116101fe5780636e811d38116101b75780636e811d38146105d55780636ef38795146105f557806371a735f3146106155780637b2d9b2c14610635578063842f5c46146106555780638456cb591461066b57600080fd5b80635c975abb146105125780635d36b190146105365780635f5152261461054b5780636093d3801461056b57806366e3667e1461059f57806367c7066c146105b557600080fd5b8063430bf08a11610250578063430bf08a1461043f578063435356d11461047357806347e7ef2414610493578063484be812146104b3578063579a7e1a146104c95780635a063f63146104fd57600080fd5b80630c340a24146103535780630ed57b3a146103855780630fc3b4c4146103a55780631072cbea146103db57806322495dc8146103fb5780633c8649591461041b57600080fd5b3661034e57336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614806102fb5750336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016145b61034c5760405162461bcd60e51b815260206004820152601e60248201527f657468206e6f742066726f6d20616c6c6f77656420636f6e747261637473000060448201526064015b60405180910390fd5b005b600080fd5b34801561035f57600080fd5b506103686109fb565b6040516001600160a01b0390911681526020015b60405180910390f35b34801561039157600080fd5b5061034c6103a0366004613c43565b610a18565b3480156103b157600080fd5b506103686103c0366004613c09565b609f602052600090815260409020546001600160a01b031681565b3480156103e757600080fd5b5061034c6103f6366004613cbd565b610a4a565b34801561040757600080fd5b5061034c610416366004613db1565b610b07565b34801561042757600080fd5b5061043160695481565b60405190815260200161037c565b34801561044b57600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561047f57600080fd5b5061034c61048e366004613d2a565b610c51565b34801561049f57600080fd5b5061034c6104ae366004613cbd565b610d36565b3480156104bf57600080fd5b50610431606a5481565b3480156104d557600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561050957600080fd5b5061034c610e3c565b34801561051e57600080fd5b5060335460ff165b604051901515815260200161037c565b34801561054257600080fd5b5061034c610edb565b34801561055757600080fd5b50610431610566366004613c09565b610f81565b34801561057757600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156105ab57600080fd5b5061043160345481565b3480156105c157600080fd5b5060a354610368906001600160a01b031681565b3480156105e157600080fd5b5061034c6105f0366004613c09565b6110b5565b34801561060157600080fd5b5061034c610610366004613ce9565b61113d565b34801561062157600080fd5b5061034c610630366004613fbf565b6115c9565b34801561064157600080fd5b50610368610650366004613e87565b6117c2565b34801561066157600080fd5b5061043160685481565b34801561067757600080fd5b5061034c6117ec565b34801561068c57600080fd5b5061034c6118b5565b3480156106a157600080fd5b506033546103689061010090046001600160a01b031681565b3480156106c657600080fd5b5061034c6106d5366004614040565b611a87565b3480156106e657600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561071a57600080fd5b5061034c610729366004613e87565b611e6f565b34801561073a57600080fd5b5061034c610749366004613ce9565b61203a565b34801561075a57600080fd5b5061077e610769366004613e87565b60356020526000908152604090205460ff1681565b60405161037c91906144ab565b34801561079757600080fd5b5061052661215a565b3480156107ac57600080fd5b506105266107bb366004613c09565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811691161490565b3480156107f957600080fd5b5061034c610808366004614085565b6121b9565b34801561081957600080fd5b5061034c6122b5565b34801561082e57600080fd5b5061034c61083d366004613f0b565b61237b565b34801561084e57600080fd5b5061034c61085d366004613c09565b6124ee565b34801561086e57600080fd5b5061052661257b565b34801561088357600080fd5b506104316801bc16d674ec80000081565b3480156108a057600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156108d457600080fd5b5061034c6108e3366004613c09565b6125ac565b3480156108f457600080fd5b5061034c610903366004613c7c565b612650565b34801561091457600080fd5b5061034c610923366004613ea0565b6126e3565b34801561093457600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561096857600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561099c57600080fd5b5061034c6128d8565b3480156109b157600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156109e557600080fd5b506109ee612a22565b60405161037c9190614281565b6000610a1360008051602061486d8339815191525490565b905090565b610a2061257b565b610a3c5760405162461bcd60e51b81526004016103439061451d565b610a468282612a84565b5050565b610a5261257b565b610a6e5760405162461bcd60e51b81526004016103439061451d565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b039081169083161415610aeb5760405162461bcd60e51b815260206004820152601f60248201527f43616e6e6f74207472616e7366657220737570706f72746564206173736574006044820152606401610343565b610a46610af66109fb565b6001600160a01b0384169083612be3565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015610b6057600080fd5b505afa158015610b74573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b989190613c26565b6001600160a01b0316336001600160a01b031614610bc85760405162461bcd60e51b8152600401610343906145dd565b60405163bc26e7e560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063bc26e7e590610c1a9030908790879087906004016141d1565b600060405180830381600087803b158015610c3457600080fd5b505af1158015610c48573d6000803e3d6000fd5b50505050505050565b610c5961257b565b610c755760405162461bcd60e51b81526004016103439061451d565b600054610100900460ff1680610c8e575060005460ff16155b610cf15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610343565b600054610100900460ff16158015610d13576000805461ffff19166101011790555b610d1e848484612c35565b8015610d30576000805461ff00191690555b50505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610d7e5760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d83398151915280546002811415610db05760405162461bcd60e51b8152600401610343906145b5565b600282557f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614610e295760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b6044820152606401610343565b610e338484612cf0565b50600190555050565b60a3546001600160a01b03163314610e965760405162461bcd60e51b815260206004820152601b60248201527f43616c6c6572206973206e6f74207468652048617276657374657200000000006044820152606401610343565b60008051602061484d83398151915280546002811415610ec85760405162461bcd60e51b8152600401610343906145b5565b60028255610ed4612d82565b5060019055565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610f765760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610343565b610f7f33612fd0565b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b031614610ff85760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b6044820152606401610343565b6040516370a0823160e01b81523060048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561105757600080fd5b505afa15801561106b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061108f919061406c565b6034546110a5906801bc16d674ec80000061473e565b6110af9190614704565b92915050565b6110bd61257b565b6110d95760405162461bcd60e51b81526004016103439061451d565b6040516001600160a01b03821681527f83f29c79feb71f8fba9d0fbc4ba5f0982a28b6b1e868b3fc50e6400d100bca0f9060200160405180910390a1603380546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60335461010090046001600160a01b0316331461116c5760405162461bcd60e51b81526004016103439061457e565b60335460ff161561118f5760405162461bcd60e51b815260040161034390614554565b60006111a4826801bc16d674ec80000061473e565b6040516370a0823160e01b81523060048201529091507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561120657600080fd5b505afa15801561121a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061123e919061406c565b8111156112815760405162461bcd60e51b81526020600482015260116024820152700d2dce6eaccccd2c6d2cadce840ae8aa89607b1b6044820152606401610343565b604051632e1a7d4d60e01b8152600481018290527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690632e1a7d4d90602401600060405180830381600087803b1580156112e357600080fd5b505af11580156112f7573d6000803e3d6000fd5b5050505060005b82811015610d3057600084848381811061131a5761131a6147fd565b905060200281019061132c919061465a565b6113369080614614565b6040516113449291906141a5565b6040805191829003909120600081815260356020529182205490925060ff1690816003811115611376576113766147d1565b146113c35760405162461bcd60e51b815260206004820152601860248201527f56616c696461746f72206e6f74207265676973746572656400000000000000006044820152606401610343565b60408051600160f81b60208201526000602182018190526bffffffffffffffffffffffff193060601b16602c830152910160405160208183030381529060405290507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663228951186801bc16d674ec800000898988818110611450576114506147fd565b9050602002810190611462919061465a565b61146c9080614614565b858c8c8b81811061147f5761147f6147fd565b9050602002810190611491919061465a565b61149f906020810190614614565b8e8e8d8181106114b1576114b16147fd565b90506020028101906114c3919061465a565b604001356040518863ffffffff1660e01b81526004016114e896959493929190614430565b6000604051808303818588803b15801561150157600080fd5b505af1158015611515573d6000803e3d6000fd5b505050505060016034600082825461152d9190614704565b909155507ffeb31a79d38edb1b090d516e4df3e273651179c6f2c2ec53a9a22ae015b70ba99050878786818110611566576115666147fd565b9050602002810190611578919061465a565b6115829080614614565b6801bc16d674ec8000008460405161159d949392919061447f565b60405180910390a150506000908152603560205260409020805460ff19166001908117909155016112fe565b60335461010090046001600160a01b031633146115f85760405162461bcd60e51b81526004016103439061457e565b60335460ff161561161b5760405162461bcd60e51b815260040161034390614554565b60006035600087876040516116319291906141a5565b604080519182900390912082526020820192909252016000205460ff1690506002816003811115611664576116646147d1565b146116a95760405162461bcd60e51b815260206004820152601560248201527456616c696461746f72206e6f742065786974696e6760581b6044820152606401610343565b6040516312b3fc1960e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906312b3fc19906116fd90899089908990899089906004016143ef565b600060405180830381600087803b15801561171757600080fd5b505af115801561172b573d6000803e3d6000fd5b505050507ff72821b8777f002ccdf6326f1242d9e0f762eb077668b67bebe640535378066d868686866040516117649493929190614366565b60405180910390a160036035600088886040516117829291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156117b5576117b56147d1565b0217905550505050505050565b60a481815481106117d257600080fd5b6000918252602090912001546001600160a01b0316905081565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b15801561184557600080fd5b505afa158015611859573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061187d9190613c26565b6001600160a01b0316336001600160a01b0316146118ad5760405162461bcd60e51b8152600401610343906145dd565b610f7f613091565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016148061190457506118ef6109fb565b6001600160a01b0316336001600160a01b0316145b61195c5760405162461bcd60e51b815260206004820152602360248201527f43616c6c6572206973206e6f7420746865205661756c74206f7220476f7665726044820152623737b960e91b6064820152608401610343565b60008051602061484d8339815191528054600281141561198e5760405162461bcd60e51b8152600401610343906145b5565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156119f457600080fd5b505afa158015611a08573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611a2c919061406c565b90508015611a7f57611a7f7f00000000000000000000000000000000000000000000000000000000000000007f000000000000000000000000000000000000000000000000000000000000000083613106565b505060019055565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015611ae057600080fd5b505afa158015611af4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b189190613c26565b6001600160a01b0316336001600160a01b031614611b485760405162461bcd60e51b8152600401610343906145dd565b60335460ff16611b915760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610343565b6002198312158015611ba4575060038313155b8015611bbe5750600083603454611bbb91906146c3565b12155b611c0a5760405162461bcd60e51b815260206004820152601760248201527f696e76616c69642076616c696461746f727344656c74610000000000000000006044820152606401610343565b6811ff6cf0fd15afffff198212158015611c2d57506811ff6cf0fd15b000008213155b8015611c475750600082606854611c4491906146c3565b12155b611c935760405162461bcd60e51b815260206004820152601d60248201527f696e76616c696420636f6e73656e7375735265776172647344656c74610000006044820152606401610343565b6801bc16d674ec800000811115611cec5760405162461bcd60e51b815260206004820152601960248201527f696e76616c69642077657468546f5661756c74416d6f756e74000000000000006044820152606401610343565b60408051848152602081018490529081018290527f80d022717ea022455c5886b8dd8a29c037570aae58aeb4d7b136d7a10ec2e4319060600160405180910390a182603454611d3b91906146c3565b603455606854611d4c9083906146c3565b6068558015611e195760405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018390527f0000000000000000000000000000000000000000000000000000000000000000169063a9059cbb90604401602060405180830381600087803b158015611ddf57600080fd5b505af1158015611df3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e179190613e6a565b505b611e2360006131fe565b611e625760405162461bcd60e51b815260206004820152601060248201526f333ab9b29039ba34b63610313637bbb760811b6044820152606401610343565b611e6a613684565b505050565b611e7761257b565b611e935760405162461bcd60e51b81526004016103439061451d565b60a0548110611ed45760405162461bcd60e51b815260206004820152600d60248201526c092dcecc2d8d2c840d2dcc8caf609b1b6044820152606401610343565b600060a08281548110611ee957611ee96147fd565b60009182526020808320909101546001600160a01b03908116808452609f90925260409092205460a05491935090911690611f269060019061475d565b831015611fa85760a08054611f3d9060019061475d565b81548110611f4d57611f4d6147fd565b60009182526020909120015460a080546001600160a01b039092169185908110611f7957611f796147fd565b9060005260206000200160006101000a8154816001600160a01b0302191690836001600160a01b031602179055505b60a0805480611fb957611fb96147e7565b60008281526020808220600019908401810180546001600160a01b031990811690915593019093556001600160a01b03858116808352609f855260409283902080549094169093559051908416815290917f16b7600acff27e39a8a96056b3d533045298de927507f5c1d97e4accde60488c910160405180910390a2505050565b61204261257b565b61205e5760405162461bcd60e51b81526004016103439061451d565b8060005b8181101561211157600084848381811061207e5761207e6147fd565b90506020020160208101906120939190613c09565b6001600160a01b031614156121015760405162461bcd60e51b815260206004820152602e60248201527f43616e206e6f742073657420616e20656d70747920616464726573732061732060448201526d30903932bbb0b932103a37b5b2b760911b6064820152608401610343565b61210a816147a0565b9050612062565b507f04c0b9649497d316554306e53678d5f5f5dbc3a06f97dec13ff4cfe98b986bbc60a48484604051612146939291906142ce565b60405180910390a1610d3060a48484613962565b60335460009061010090046001600160a01b0316331461218c5760405162461bcd60e51b81526004016103439061457e565b60335460ff16156121af5760405162461bcd60e51b815260040161034390614554565b610a1360016131fe565b6121c161257b565b6121dd5760405162461bcd60e51b81526004016103439061451d565b80821080156121f457506801bc16d674ec80000082105b801561220857506801bc16d674ec80000081105b80156122255750673782dace9d900000612222838361475d565b10155b6122715760405162461bcd60e51b815260206004820152601760248201527f696e636f7272656374206675736520696e74657276616c0000000000000000006044820152606401610343565b60408051838152602081018390527fcb8d24e46eb3c402bf344ee60a6576cba9ef2f59ea1af3b311520704924e901a910160405180910390a1606991909155606a55565b60405163095ea7b360e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116600483015260001960248301527f0000000000000000000000000000000000000000000000000000000000000000169063095ea7b390604401602060405180830381600087803b15801561234057600080fd5b505af1158015612354573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123789190613e6a565b50565b60335461010090046001600160a01b031633146123aa5760405162461bcd60e51b81526004016103439061457e565b60335460ff16156123cd5760405162461bcd60e51b815260040161034390614554565b6040516301ba3ee760e21b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906306e8fb9c90612427908b908b908b908b908b908b908b908b9060040161438d565b600060405180830381600087803b15801561244157600080fd5b505af1158015612455573d6000803e3d6000fd5b505050506000603560008a8a60405161246f9291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156124a2576124a26147d1565b02179055507f75c4a66b2c6c28cf46db7131182a812e4fbbb2f0591377aa83a737909a9b68c3888888886040516124dc9493929190614366565b60405180910390a15050505050505050565b6124f661257b565b6125125760405162461bcd60e51b81526004016103439061451d565b60a354604080516001600160a01b03928316815291831660208301527fe48386b84419f4d36e0f96c10cc3510b6fb1a33795620c5098b22472bbe90796910160405180910390a160a380546001600160a01b0319166001600160a01b0392909216919091179055565b600061259360008051602061486d8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b6125b461257b565b6125d05760405162461bcd60e51b81526004016103439061451d565b6125f8817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b031661261860008051602061486d8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146126985760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d833981519152805460028114156126ca5760405162461bcd60e51b8152600401610343906145b5565b600282556126d9858585613106565b5060019055505050565b60335461010090046001600160a01b031633146127125760405162461bcd60e51b81526004016103439061457e565b60335460ff16156127355760405162461bcd60e51b815260040161034390614554565b600060356000868660405161274b9291906141a5565b604080519182900390912082526020820192909252016000205460ff169050600181600381111561277e5761277e6147d1565b146127c25760405162461bcd60e51b815260206004820152601460248201527315985b1a59185d1bdc881b9bdd081cdd185ad95960621b6044820152606401610343565b604051633877322b60e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633877322b90612814908890889088908890600401614366565b600060405180830381600087803b15801561282e57600080fd5b505af1158015612842573d6000803e3d6000fd5b505050507ff8821da16f5ed966b41e0343c3eff9903af782d74f99f1689dd9d4562b6545b38585858560405161287b9493929190614366565b60405180910390a160026035600087876040516128999291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156128cc576128cc6147d1565b02179055505050505050565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146129205760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d833981519152805460028114156129525760405162461bcd60e51b8152600401610343906145b5565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156129b857600080fd5b505afa1580156129cc573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129f0919061406c565b90508015611a7f57611a7f7f000000000000000000000000000000000000000000000000000000000000000082612cf0565b606060a4805480602002602001604051908101604052809291908181526020018280548015612a7a57602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612a5c575b5050505050905090565b6001600160a01b038281166000908152609f60205260409020541615612ae15760405162461bcd60e51b81526020600482015260126024820152711c151bdad95b88185b1c9958591e481cd95d60721b6044820152606401610343565b6001600160a01b03821615801590612b0157506001600160a01b03811615155b612b415760405162461bcd60e51b8152602060048201526011602482015270496e76616c69642061646472657373657360781b6044820152606401610343565b6001600160a01b038281166000818152609f6020908152604080832080549587166001600160a01b0319968716811790915560a0805460018101825594527f78fdc8d422c49ced035a9edf18d00d3c6a8d81df210f3e5e448e045e77b41e8890930180549095168417909455925190815290917fef6485b84315f9b1483beffa32aae9a0596890395e3d7521f1c5fbb51790e765910160405180910390a25050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b179052611e6a9084906136fe565b8251612c489060a49060208601906139c5565b50815181518114612c925760405162461bcd60e51b8152602060048201526014602482015273496e76616c696420696e7075742061727261797360601b6044820152606401610343565b60005b81811015612ce957612cd9848281518110612cb257612cb26147fd565b6020026020010151848381518110612ccc57612ccc6147fd565b6020026020010151612a84565b612ce2816147a0565b9050612c95565b5050505050565b60008111612d395760405162461bcd60e51b81526020600482015260166024820152754d757374206465706f73697420736f6d657468696e6760501b6044820152606401610343565b6040805160008152602081018390526001600160a01b038416917f5548c837ab068cf56a2c2479df0882a4922fd203edb7517321831d95078c5f62910160405180910390a25050565b60335460ff1615612da55760405162461bcd60e51b815260040161034390614554565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663e52253816040518163ffffffff1660e01b8152600401602060405180830381600087803b158015612e0257600080fd5b505af1158015612e16573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e3a919061406c565b9050600060685482612e4c9190614704565b905080471015612e9e5760405162461bcd60e51b815260206004820152601860248201527f696e73756666696369656e74206574682062616c616e636500000000000000006044820152606401610343565b8015610a465760006068819055507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b158015612f0757600080fd5b505af1158015612f1b573d6000803e3d6000fd5b505060a354604080516001600160a01b0392831681527f0000000000000000000000000000000000000000000000000000000000000000909216602083015281018590527ff6c07a063ed4e63808eb8da7112d46dbcd38de2b40a73dbcc9353c5a94c7235393506060019150612f8e9050565b60405180910390a160a354610a46906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116911683612be3565b6001600160a01b0381166130265760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610343565b806001600160a01b031661304660008051602061486d8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36123788160008051602061486d83398151915255565b60335460ff16156130b45760405162461bcd60e51b815260040161034390614554565b6033805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586130e93390565b6040516001600160a01b03909116815260200160405180910390a1565b600081116131565760405162461bcd60e51b815260206004820152601760248201527f4d75737420776974686472617720736f6d657468696e670000000000000000006044820152606401610343565b6001600160a01b0383166131a55760405162461bcd60e51b8152602060048201526016602482015275135d5cdd081cdc1958da599e481c9958da5c1a595b9d60521b6044820152606401610343565b6040805160008152602081018390526001600160a01b038416917f2717ead6b9200dd235aad468c9809ea400fe33ac69b5bfaa6d3e90fc922b6398910160405180910390a2611e6a6001600160a01b0383168483612be3565b6000606854471015613213576110af826137d0565b600060685447613223919061475d565b9050600191506801bc16d674ec800000811061341957600061324e6801bc16d674ec8000008361471c565b905080603454101561326b57613263846137d0565b949350505050565b806034600082825461327d919061475d565b9091555060009050613298826801bc16d674ec80000061473e565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b1580156132f557600080fd5b505af1158015613309573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b15801561339957600080fd5b505af11580156133ad573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133d19190613e6a565b5060345460408051848152602081019290925281018290527fbe7040030ff7b347853214bf49820c6d455fedf58f3815f85c7bc5216993682b9060600160405180910390a150505b600060685447613429919061475d565b90506801bc16d674ec800000811061347b5760405162461bcd60e51b8152602060048201526015602482015274756e6578706563746564206163636f756e74696e6760581b6044820152606401610343565b80613487575050919050565b6069548110156134e15780606860008282546134a39190614704565b90915550506040518181527f7a745a2c63a535068f52ceca27debd5297bbad5f7f37ec53d044a59d0362445d906020015b60405180910390a161367d565b606a54811115613674577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561354657600080fd5b505af115801561355a573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b1580156135ea57600080fd5b505af11580156135fe573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906136229190613e6a565b50600160346000828254613636919061475d565b909155505060345460408051918252602082018390527f6aa7e30787b26429ced603a7aba8b19c4b5d5bcf29a3257da953c8d53bcaa3a691016134d4565b613263846137d0565b5050919050565b60335460ff166136cd5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610343565b6033805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa336130e9565b6000613753826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166137e89092919063ffffffff16565b805190915015611e6a57808060200190518101906137719190613e6a565b611e6a5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610343565b600081156137e0576137e0613091565b506000919050565b60606137f78484600085613801565b90505b9392505050565b6060824710156138625760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610343565b843b6138b05760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610343565b600080866001600160a01b031685876040516138cc91906141b5565b60006040518083038185875af1925050503d8060008114613909576040519150601f19603f3d011682016040523d82523d6000602084013e61390e565b606091505b509150915061391e828286613929565b979650505050505050565b606083156139385750816137fa565b8251156139485782518084602001fd5b8160405162461bcd60e51b815260040161034391906144d3565b8280548282559060005260206000209081019282156139b5579160200282015b828111156139b55781546001600160a01b0319166001600160a01b03843516178255602090920191600190910190613982565b506139c1929150613a1a565b5090565b8280548282559060005260206000209081019282156139b5579160200282015b828111156139b557825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906139e5565b5b808211156139c15760008155600101613a1b565b60008083601f840112613a4157600080fd5b5081356001600160401b03811115613a5857600080fd5b6020830191508360208260051b8501011115613a7357600080fd5b9250929050565b600082601f830112613a8b57600080fd5b81356020613aa0613a9b836146a0565b614670565b80838252828201915082860187848660051b8901011115613ac057600080fd5b60005b85811015613ae8578135613ad681614829565b84529284019290840190600101613ac3565b5090979650505050505050565b60008083601f840112613b0757600080fd5b5081356001600160401b03811115613b1e57600080fd5b602083019150836020828501011115613a7357600080fd5b600060a08284031215613b4857600080fd5b50919050565b600060a08284031215613b6057600080fd5b60405160a081018181106001600160401b0382111715613b8257613b82614813565b604052905080613b9183613bd9565b8152613b9f60208401613bf2565b6020820152613bb060408401613bf2565b60408201526060830135613bc38161483e565b6060820152608092830135920191909152919050565b803563ffffffff81168114613bed57600080fd5b919050565b80356001600160401b0381168114613bed57600080fd5b600060208284031215613c1b57600080fd5b81356137fa81614829565b600060208284031215613c3857600080fd5b81516137fa81614829565b60008060408385031215613c5657600080fd5b8235613c6181614829565b91506020830135613c7181614829565b809150509250929050565b600080600060608486031215613c9157600080fd5b8335613c9c81614829565b92506020840135613cac81614829565b929592945050506040919091013590565b60008060408385031215613cd057600080fd5b8235613cdb81614829565b946020939093013593505050565b60008060208385031215613cfc57600080fd5b82356001600160401b03811115613d1257600080fd5b613d1e85828601613a2f565b90969095509350505050565b600080600060608486031215613d3f57600080fd5b83356001600160401b0380821115613d5657600080fd5b613d6287838801613a7a565b94506020860135915080821115613d7857600080fd5b613d8487838801613a7a565b93506040860135915080821115613d9a57600080fd5b50613da786828701613a7a565b9150509250925092565b600080600060e08486031215613dc657600080fd5b83356001600160401b03811115613ddc57600080fd5b8401601f81018613613ded57600080fd5b80356020613dfd613a9b836146a0565b8083825282820191508285018a848660051b8801011115613e1d57600080fd5b600095505b84861015613e4757613e3381613bf2565b835260019590950194918301918301613e22565b509650508601359350613e61915086905060408601613b4e565b90509250925092565b600060208284031215613e7c57600080fd5b81516137fa8161483e565b600060208284031215613e9957600080fd5b5035919050565b60008060008060408587031215613eb657600080fd5b84356001600160401b0380821115613ecd57600080fd5b613ed988838901613af5565b90965094506020870135915080821115613ef257600080fd5b50613eff87828801613a2f565b95989497509550505050565b600080600080600080600080610120898b031215613f2857600080fd5b88356001600160401b0380821115613f3f57600080fd5b613f4b8c838d01613af5565b909a50985060208b0135915080821115613f6457600080fd5b613f708c838d01613a2f565b909850965060408b0135915080821115613f8957600080fd5b50613f968b828c01613af5565b90955093505060608901359150613fb08a60808b01613b36565b90509295985092959890939650565b600080600080600060e08688031215613fd757600080fd5b85356001600160401b0380821115613fee57600080fd5b613ffa89838a01613af5565b9097509550602088013591508082111561401357600080fd5b5061402088828901613a2f565b909450925061403490508760408801613b36565b90509295509295909350565b60008060006060848603121561405557600080fd5b505081359360208301359350604090920135919050565b60006020828403121561407e57600080fd5b5051919050565b6000806040838503121561409857600080fd5b50508035926020909101359150565b8183526000602080850194508260005b858110156140e3576001600160401b036140d083613bf2565b16875295820195908201906001016140b7565b509495945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000815180845261412f816020860160208601614774565b601f01601f19169290920160200192915050565b63ffffffff61415182613bd9565b16825261416060208201613bf2565b6001600160401b0380821660208501528061417d60408501613bf2565b166040850152505060608101356141938161483e565b15156060830152608090810135910152565b8183823760009101908152919050565b600082516141c7818460208701614774565b9190910192915050565b6001600160a01b03851681526101006020808301829052855191830182905260009161012084019187810191845b818110156142245783516001600160401b0316855293820193928201926001016141ff565b505082935086604086015263ffffffff865116606086015280860151925050506001600160401b0380821660808501528060408601511660a085015250506060830151151560c0830152608083015160e083015295945050505050565b6020808252825182820181905260009190848201906040850190845b818110156142c25783516001600160a01b03168352928401929184019160010161429d565b50909695505050505050565b6000604082016040835280865480835260608501915087600052602092508260002060005b828110156143185781546001600160a01b0316845292840192600191820191016142f3565b505050838103828501528481528590820160005b8681101561435a57823561433f81614829565b6001600160a01b03168252918301919083019060010161432c565b50979650505050505050565b60408152600061437a6040830186886140ee565b828103602084015261391e8185876140a7565b60006101208083526143a28184018b8d6140ee565b905082810360208401526143b781898b6140a7565b905082810360408401526143cc8187896140ee565b9150508360608301526143e26080830184614143565b9998505050505050505050565b60e08152600061440360e0830187896140ee565b82810360208401526144168186886140a7565b9150506144266040830184614143565b9695505050505050565b60808152600061444460808301888a6140ee565b82810360208401526144568188614117565b9050828103604084015261446b8186886140ee565b915050826060830152979650505050505050565b6060815260006144936060830186886140ee565b846020840152828103604084015261391e8185614117565b60208101600483106144cd57634e487b7160e01b600052602160045260246000fd5b91905290565b6020815260006137fa6020830184614117565b60208082526017908201527f43616c6c6572206973206e6f7420746865205661756c74000000000000000000604082015260600190565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60208082526010908201526f14185d5cd8589b194e881c185d5cd95960821b604082015260600190565b6020808252601d908201527f43616c6c6572206973206e6f7420746865205265676973747261746f72000000604082015260600190565b6020808252600e908201526d1499595b9d1c985b9d0818d85b1b60921b604082015260600190565b6020808252601c908201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604082015260600190565b6000808335601e1984360301811261462b57600080fd5b8301803591506001600160401b0382111561464557600080fd5b602001915036819003821315613a7357600080fd5b60008235605e198336030181126141c757600080fd5b604051601f8201601f191681016001600160401b038111828210171561469857614698614813565b604052919050565b60006001600160401b038211156146b9576146b9614813565b5060051b60200190565b600080821280156001600160ff1b03849003851316156146e5576146e56147bb565b600160ff1b83900384128116156146fe576146fe6147bb565b50500190565b60008219821115614717576147176147bb565b500190565b60008261473957634e487b7160e01b600052601260045260246000fd5b500490565b6000816000190483118215151615614758576147586147bb565b500290565b60008282101561476f5761476f6147bb565b500390565b60005b8381101561478f578181015183820152602001614777565b83811115610d305750506000910152565b60006000198214156147b4576147b46147bb565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b6001600160a01b038116811461237857600080fd5b801515811461237857600080fdfe53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac45357bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa264697066735822122002c6785cb55b316b2eea75081179f6e1764ee917e56d0fc72bd1ea4c6b39fa5064736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", + "deployedBytecode": "0x6080604052600436106102975760003560e01c8063853828b61161015a578063c2e1e3f4116100c1578063d9f00ec71161007a578063d9f00ec714610908578063dbe55e5614610928578063dd505df61461095c578063de5f626814610990578063f1188e40146109a5578063f6ca71b0146109d957600080fd5b8063c2e1e3f414610842578063c7af335214610862578063c98517c514610877578063cceab75014610894578063d38bfff4146108c8578063d9caed12146108e857600080fd5b80639da0e462116101135780639da0e4621461074e578063a4f98af41461078b578063aa388af6146107a0578063ab12edf5146107ed578063ad1728cb1461080d578063bb1b918d1461082257600080fd5b8063853828b61461068057806387bae867146106955780638d7c0e46146106ba5780639092c31c146106da5780639136616a1461070e57806396d538bb1461072e57600080fd5b80635c975abb116101fe5780636e811d38116101b75780636e811d38146105d55780636ef38795146105f557806371a735f3146106155780637b2d9b2c14610635578063842f5c46146106555780638456cb591461066b57600080fd5b80635c975abb146105125780635d36b190146105365780635f5152261461054b5780636093d3801461056b57806366e3667e1461059f57806367c7066c146105b557600080fd5b8063430bf08a11610250578063430bf08a1461043f578063435356d11461047357806347e7ef2414610493578063484be812146104b3578063579a7e1a146104c95780635a063f63146104fd57600080fd5b80630c340a24146103535780630ed57b3a146103855780630fc3b4c4146103a55780631072cbea146103db57806322495dc8146103fb5780633c8649591461041b57600080fd5b3661034e57336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614806102fb5750336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016145b61034c5760405162461bcd60e51b815260206004820152601e60248201527f657468206e6f742066726f6d20616c6c6f77656420636f6e747261637473000060448201526064015b60405180910390fd5b005b600080fd5b34801561035f57600080fd5b506103686109fb565b6040516001600160a01b0390911681526020015b60405180910390f35b34801561039157600080fd5b5061034c6103a0366004613c43565b610a18565b3480156103b157600080fd5b506103686103c0366004613c09565b609f602052600090815260409020546001600160a01b031681565b3480156103e757600080fd5b5061034c6103f6366004613cbd565b610a4a565b34801561040757600080fd5b5061034c610416366004613db1565b610b07565b34801561042757600080fd5b5061043160695481565b60405190815260200161037c565b34801561044b57600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561047f57600080fd5b5061034c61048e366004613d2a565b610c51565b34801561049f57600080fd5b5061034c6104ae366004613cbd565b610d36565b3480156104bf57600080fd5b50610431606a5481565b3480156104d557600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561050957600080fd5b5061034c610e3c565b34801561051e57600080fd5b5060335460ff165b604051901515815260200161037c565b34801561054257600080fd5b5061034c610edb565b34801561055757600080fd5b50610431610566366004613c09565b610f81565b34801561057757600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156105ab57600080fd5b5061043160345481565b3480156105c157600080fd5b5060a354610368906001600160a01b031681565b3480156105e157600080fd5b5061034c6105f0366004613c09565b6110b5565b34801561060157600080fd5b5061034c610610366004613ce9565b61113d565b34801561062157600080fd5b5061034c610630366004613fbf565b6115c9565b34801561064157600080fd5b50610368610650366004613e87565b6117c2565b34801561066157600080fd5b5061043160685481565b34801561067757600080fd5b5061034c6117ec565b34801561068c57600080fd5b5061034c6118b5565b3480156106a157600080fd5b506033546103689061010090046001600160a01b031681565b3480156106c657600080fd5b5061034c6106d5366004614040565b611a87565b3480156106e657600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561071a57600080fd5b5061034c610729366004613e87565b611e6f565b34801561073a57600080fd5b5061034c610749366004613ce9565b61203a565b34801561075a57600080fd5b5061077e610769366004613e87565b60356020526000908152604090205460ff1681565b60405161037c91906144ab565b34801561079757600080fd5b5061052661215a565b3480156107ac57600080fd5b506105266107bb366004613c09565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811691161490565b3480156107f957600080fd5b5061034c610808366004614085565b6121b9565b34801561081957600080fd5b5061034c6122b5565b34801561082e57600080fd5b5061034c61083d366004613f0b565b61237b565b34801561084e57600080fd5b5061034c61085d366004613c09565b6124ee565b34801561086e57600080fd5b5061052661257b565b34801561088357600080fd5b506104316801bc16d674ec80000081565b3480156108a057600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156108d457600080fd5b5061034c6108e3366004613c09565b6125ac565b3480156108f457600080fd5b5061034c610903366004613c7c565b612650565b34801561091457600080fd5b5061034c610923366004613ea0565b6126e3565b34801561093457600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561096857600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561099c57600080fd5b5061034c6128d8565b3480156109b157600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156109e557600080fd5b506109ee612a22565b60405161037c9190614281565b6000610a1360008051602061486d8339815191525490565b905090565b610a2061257b565b610a3c5760405162461bcd60e51b81526004016103439061451d565b610a468282612a84565b5050565b610a5261257b565b610a6e5760405162461bcd60e51b81526004016103439061451d565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b039081169083161415610aeb5760405162461bcd60e51b815260206004820152601f60248201527f43616e6e6f74207472616e7366657220737570706f72746564206173736574006044820152606401610343565b610a46610af66109fb565b6001600160a01b0384169083612be3565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015610b6057600080fd5b505afa158015610b74573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b989190613c26565b6001600160a01b0316336001600160a01b031614610bc85760405162461bcd60e51b8152600401610343906145dd565b60405163bc26e7e560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063bc26e7e590610c1a9030908790879087906004016141d1565b600060405180830381600087803b158015610c3457600080fd5b505af1158015610c48573d6000803e3d6000fd5b50505050505050565b610c5961257b565b610c755760405162461bcd60e51b81526004016103439061451d565b600054610100900460ff1680610c8e575060005460ff16155b610cf15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610343565b600054610100900460ff16158015610d13576000805461ffff19166101011790555b610d1e848484612c35565b8015610d30576000805461ff00191690555b50505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610d7e5760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d83398151915280546002811415610db05760405162461bcd60e51b8152600401610343906145b5565b600282557f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614610e295760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b6044820152606401610343565b610e338484612cf0565b50600190555050565b60a3546001600160a01b03163314610e965760405162461bcd60e51b815260206004820152601b60248201527f43616c6c6572206973206e6f74207468652048617276657374657200000000006044820152606401610343565b60008051602061484d83398151915280546002811415610ec85760405162461bcd60e51b8152600401610343906145b5565b60028255610ed4612d82565b5060019055565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610f765760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610343565b610f7f33612fd0565b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b031614610ff85760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b6044820152606401610343565b6040516370a0823160e01b81523060048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561105757600080fd5b505afa15801561106b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061108f919061406c565b6034546110a5906801bc16d674ec80000061473e565b6110af9190614704565b92915050565b6110bd61257b565b6110d95760405162461bcd60e51b81526004016103439061451d565b6040516001600160a01b03821681527f83f29c79feb71f8fba9d0fbc4ba5f0982a28b6b1e868b3fc50e6400d100bca0f9060200160405180910390a1603380546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60335461010090046001600160a01b0316331461116c5760405162461bcd60e51b81526004016103439061457e565b60335460ff161561118f5760405162461bcd60e51b815260040161034390614554565b60006111a4826801bc16d674ec80000061473e565b6040516370a0823160e01b81523060048201529091507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561120657600080fd5b505afa15801561121a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061123e919061406c565b8111156112815760405162461bcd60e51b81526020600482015260116024820152700d2dce6eaccccd2c6d2cadce840ae8aa89607b1b6044820152606401610343565b604051632e1a7d4d60e01b8152600481018290527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690632e1a7d4d90602401600060405180830381600087803b1580156112e357600080fd5b505af11580156112f7573d6000803e3d6000fd5b5050505060005b82811015610d3057600084848381811061131a5761131a6147fd565b905060200281019061132c919061465a565b6113369080614614565b6040516113449291906141a5565b6040805191829003909120600081815260356020529182205490925060ff1690816003811115611376576113766147d1565b146113c35760405162461bcd60e51b815260206004820152601860248201527f56616c696461746f72206e6f74207265676973746572656400000000000000006044820152606401610343565b60408051600160f81b60208201526000602182018190526bffffffffffffffffffffffff193060601b16602c830152910160405160208183030381529060405290507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663228951186801bc16d674ec800000898988818110611450576114506147fd565b9050602002810190611462919061465a565b61146c9080614614565b858c8c8b81811061147f5761147f6147fd565b9050602002810190611491919061465a565b61149f906020810190614614565b8e8e8d8181106114b1576114b16147fd565b90506020028101906114c3919061465a565b604001356040518863ffffffff1660e01b81526004016114e896959493929190614430565b6000604051808303818588803b15801561150157600080fd5b505af1158015611515573d6000803e3d6000fd5b505050505060016034600082825461152d9190614704565b909155507ffeb31a79d38edb1b090d516e4df3e273651179c6f2c2ec53a9a22ae015b70ba99050878786818110611566576115666147fd565b9050602002810190611578919061465a565b6115829080614614565b6801bc16d674ec8000008460405161159d949392919061447f565b60405180910390a150506000908152603560205260409020805460ff19166001908117909155016112fe565b60335461010090046001600160a01b031633146115f85760405162461bcd60e51b81526004016103439061457e565b60335460ff161561161b5760405162461bcd60e51b815260040161034390614554565b60006035600087876040516116319291906141a5565b604080519182900390912082526020820192909252016000205460ff1690506002816003811115611664576116646147d1565b146116a95760405162461bcd60e51b815260206004820152601560248201527456616c696461746f72206e6f742065786974696e6760581b6044820152606401610343565b6040516312b3fc1960e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906312b3fc19906116fd90899089908990899089906004016143ef565b600060405180830381600087803b15801561171757600080fd5b505af115801561172b573d6000803e3d6000fd5b505050507ff72821b8777f002ccdf6326f1242d9e0f762eb077668b67bebe640535378066d868686866040516117649493929190614366565b60405180910390a160036035600088886040516117829291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156117b5576117b56147d1565b0217905550505050505050565b60a481815481106117d257600080fd5b6000918252602090912001546001600160a01b0316905081565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b15801561184557600080fd5b505afa158015611859573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061187d9190613c26565b6001600160a01b0316336001600160a01b0316146118ad5760405162461bcd60e51b8152600401610343906145dd565b610f7f613091565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016148061190457506118ef6109fb565b6001600160a01b0316336001600160a01b0316145b61195c5760405162461bcd60e51b815260206004820152602360248201527f43616c6c6572206973206e6f7420746865205661756c74206f7220476f7665726044820152623737b960e91b6064820152608401610343565b60008051602061484d8339815191528054600281141561198e5760405162461bcd60e51b8152600401610343906145b5565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156119f457600080fd5b505afa158015611a08573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611a2c919061406c565b90508015611a7f57611a7f7f00000000000000000000000000000000000000000000000000000000000000007f000000000000000000000000000000000000000000000000000000000000000083613106565b505060019055565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015611ae057600080fd5b505afa158015611af4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b189190613c26565b6001600160a01b0316336001600160a01b031614611b485760405162461bcd60e51b8152600401610343906145dd565b60335460ff16611b915760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610343565b6002198312158015611ba4575060038313155b8015611bbe5750600083603454611bbb91906146c3565b12155b611c0a5760405162461bcd60e51b815260206004820152601760248201527f696e76616c69642076616c696461746f727344656c74610000000000000000006044820152606401610343565b6811ff6cf0fd15afffff198212158015611c2d57506811ff6cf0fd15b000008213155b8015611c475750600082606854611c4491906146c3565b12155b611c935760405162461bcd60e51b815260206004820152601d60248201527f696e76616c696420636f6e73656e7375735265776172647344656c74610000006044820152606401610343565b6801bc16d674ec800000811115611cec5760405162461bcd60e51b815260206004820152601960248201527f696e76616c69642077657468546f5661756c74416d6f756e74000000000000006044820152606401610343565b60408051848152602081018490529081018290527f80d022717ea022455c5886b8dd8a29c037570aae58aeb4d7b136d7a10ec2e4319060600160405180910390a182603454611d3b91906146c3565b603455606854611d4c9083906146c3565b6068558015611e195760405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018390527f0000000000000000000000000000000000000000000000000000000000000000169063a9059cbb90604401602060405180830381600087803b158015611ddf57600080fd5b505af1158015611df3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e179190613e6a565b505b611e2360006131fe565b611e625760405162461bcd60e51b815260206004820152601060248201526f333ab9b29039ba34b63610313637bbb760811b6044820152606401610343565b611e6a613684565b505050565b611e7761257b565b611e935760405162461bcd60e51b81526004016103439061451d565b60a0548110611ed45760405162461bcd60e51b815260206004820152600d60248201526c092dcecc2d8d2c840d2dcc8caf609b1b6044820152606401610343565b600060a08281548110611ee957611ee96147fd565b60009182526020808320909101546001600160a01b03908116808452609f90925260409092205460a05491935090911690611f269060019061475d565b831015611fa85760a08054611f3d9060019061475d565b81548110611f4d57611f4d6147fd565b60009182526020909120015460a080546001600160a01b039092169185908110611f7957611f796147fd565b9060005260206000200160006101000a8154816001600160a01b0302191690836001600160a01b031602179055505b60a0805480611fb957611fb96147e7565b60008281526020808220600019908401810180546001600160a01b031990811690915593019093556001600160a01b03858116808352609f855260409283902080549094169093559051908416815290917f16b7600acff27e39a8a96056b3d533045298de927507f5c1d97e4accde60488c910160405180910390a2505050565b61204261257b565b61205e5760405162461bcd60e51b81526004016103439061451d565b8060005b8181101561211157600084848381811061207e5761207e6147fd565b90506020020160208101906120939190613c09565b6001600160a01b031614156121015760405162461bcd60e51b815260206004820152602e60248201527f43616e206e6f742073657420616e20656d70747920616464726573732061732060448201526d30903932bbb0b932103a37b5b2b760911b6064820152608401610343565b61210a816147a0565b9050612062565b507f04c0b9649497d316554306e53678d5f5f5dbc3a06f97dec13ff4cfe98b986bbc60a48484604051612146939291906142ce565b60405180910390a1610d3060a48484613962565b60335460009061010090046001600160a01b0316331461218c5760405162461bcd60e51b81526004016103439061457e565b60335460ff16156121af5760405162461bcd60e51b815260040161034390614554565b610a1360016131fe565b6121c161257b565b6121dd5760405162461bcd60e51b81526004016103439061451d565b80821080156121f457506801bc16d674ec80000082105b801561220857506801bc16d674ec80000081105b80156122255750673782dace9d900000612222838361475d565b10155b6122715760405162461bcd60e51b815260206004820152601760248201527f696e636f7272656374206675736520696e74657276616c0000000000000000006044820152606401610343565b60408051838152602081018390527fcb8d24e46eb3c402bf344ee60a6576cba9ef2f59ea1af3b311520704924e901a910160405180910390a1606991909155606a55565b60405163095ea7b360e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116600483015260001960248301527f0000000000000000000000000000000000000000000000000000000000000000169063095ea7b390604401602060405180830381600087803b15801561234057600080fd5b505af1158015612354573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123789190613e6a565b50565b60335461010090046001600160a01b031633146123aa5760405162461bcd60e51b81526004016103439061457e565b60335460ff16156123cd5760405162461bcd60e51b815260040161034390614554565b6040516301ba3ee760e21b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906306e8fb9c90612427908b908b908b908b908b908b908b908b9060040161438d565b600060405180830381600087803b15801561244157600080fd5b505af1158015612455573d6000803e3d6000fd5b505050506000603560008a8a60405161246f9291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156124a2576124a26147d1565b02179055507f75c4a66b2c6c28cf46db7131182a812e4fbbb2f0591377aa83a737909a9b68c3888888886040516124dc9493929190614366565b60405180910390a15050505050505050565b6124f661257b565b6125125760405162461bcd60e51b81526004016103439061451d565b60a354604080516001600160a01b03928316815291831660208301527fe48386b84419f4d36e0f96c10cc3510b6fb1a33795620c5098b22472bbe90796910160405180910390a160a380546001600160a01b0319166001600160a01b0392909216919091179055565b600061259360008051602061486d8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b6125b461257b565b6125d05760405162461bcd60e51b81526004016103439061451d565b6125f8817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b031661261860008051602061486d8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146126985760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d833981519152805460028114156126ca5760405162461bcd60e51b8152600401610343906145b5565b600282556126d9858585613106565b5060019055505050565b60335461010090046001600160a01b031633146127125760405162461bcd60e51b81526004016103439061457e565b60335460ff16156127355760405162461bcd60e51b815260040161034390614554565b600060356000868660405161274b9291906141a5565b604080519182900390912082526020820192909252016000205460ff169050600181600381111561277e5761277e6147d1565b146127c25760405162461bcd60e51b815260206004820152601460248201527315985b1a59185d1bdc881b9bdd081cdd185ad95960621b6044820152606401610343565b604051633877322b60e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633877322b90612814908890889088908890600401614366565b600060405180830381600087803b15801561282e57600080fd5b505af1158015612842573d6000803e3d6000fd5b505050507ff8821da16f5ed966b41e0343c3eff9903af782d74f99f1689dd9d4562b6545b38585858560405161287b9493929190614366565b60405180910390a160026035600087876040516128999291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156128cc576128cc6147d1565b02179055505050505050565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146129205760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d833981519152805460028114156129525760405162461bcd60e51b8152600401610343906145b5565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156129b857600080fd5b505afa1580156129cc573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129f0919061406c565b90508015611a7f57611a7f7f000000000000000000000000000000000000000000000000000000000000000082612cf0565b606060a4805480602002602001604051908101604052809291908181526020018280548015612a7a57602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612a5c575b5050505050905090565b6001600160a01b038281166000908152609f60205260409020541615612ae15760405162461bcd60e51b81526020600482015260126024820152711c151bdad95b88185b1c9958591e481cd95d60721b6044820152606401610343565b6001600160a01b03821615801590612b0157506001600160a01b03811615155b612b415760405162461bcd60e51b8152602060048201526011602482015270496e76616c69642061646472657373657360781b6044820152606401610343565b6001600160a01b038281166000818152609f6020908152604080832080549587166001600160a01b0319968716811790915560a0805460018101825594527f78fdc8d422c49ced035a9edf18d00d3c6a8d81df210f3e5e448e045e77b41e8890930180549095168417909455925190815290917fef6485b84315f9b1483beffa32aae9a0596890395e3d7521f1c5fbb51790e765910160405180910390a25050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b179052611e6a9084906136fe565b8251612c489060a49060208601906139c5565b50815181518114612c925760405162461bcd60e51b8152602060048201526014602482015273496e76616c696420696e7075742061727261797360601b6044820152606401610343565b60005b81811015612ce957612cd9848281518110612cb257612cb26147fd565b6020026020010151848381518110612ccc57612ccc6147fd565b6020026020010151612a84565b612ce2816147a0565b9050612c95565b5050505050565b60008111612d395760405162461bcd60e51b81526020600482015260166024820152754d757374206465706f73697420736f6d657468696e6760501b6044820152606401610343565b6040805160008152602081018390526001600160a01b038416917f5548c837ab068cf56a2c2479df0882a4922fd203edb7517321831d95078c5f62910160405180910390a25050565b60335460ff1615612da55760405162461bcd60e51b815260040161034390614554565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663e52253816040518163ffffffff1660e01b8152600401602060405180830381600087803b158015612e0257600080fd5b505af1158015612e16573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e3a919061406c565b9050600060685482612e4c9190614704565b905080471015612e9e5760405162461bcd60e51b815260206004820152601860248201527f696e73756666696369656e74206574682062616c616e636500000000000000006044820152606401610343565b8015610a465760006068819055507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b158015612f0757600080fd5b505af1158015612f1b573d6000803e3d6000fd5b505060a354604080516001600160a01b0392831681527f0000000000000000000000000000000000000000000000000000000000000000909216602083015281018590527ff6c07a063ed4e63808eb8da7112d46dbcd38de2b40a73dbcc9353c5a94c7235393506060019150612f8e9050565b60405180910390a160a354610a46906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116911683612be3565b6001600160a01b0381166130265760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610343565b806001600160a01b031661304660008051602061486d8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36123788160008051602061486d83398151915255565b60335460ff16156130b45760405162461bcd60e51b815260040161034390614554565b6033805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586130e93390565b6040516001600160a01b03909116815260200160405180910390a1565b600081116131565760405162461bcd60e51b815260206004820152601760248201527f4d75737420776974686472617720736f6d657468696e670000000000000000006044820152606401610343565b6001600160a01b0383166131a55760405162461bcd60e51b8152602060048201526016602482015275135d5cdd081cdc1958da599e481c9958da5c1a595b9d60521b6044820152606401610343565b6040805160008152602081018390526001600160a01b038416917f2717ead6b9200dd235aad468c9809ea400fe33ac69b5bfaa6d3e90fc922b6398910160405180910390a2611e6a6001600160a01b0383168483612be3565b6000606854471015613213576110af826137d0565b600060685447613223919061475d565b9050600191506801bc16d674ec800000811061341957600061324e6801bc16d674ec8000008361471c565b905080603454101561326b57613263846137d0565b949350505050565b806034600082825461327d919061475d565b9091555060009050613298826801bc16d674ec80000061473e565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b1580156132f557600080fd5b505af1158015613309573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b15801561339957600080fd5b505af11580156133ad573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133d19190613e6a565b5060345460408051848152602081019290925281018290527fbe7040030ff7b347853214bf49820c6d455fedf58f3815f85c7bc5216993682b9060600160405180910390a150505b600060685447613429919061475d565b90506801bc16d674ec800000811061347b5760405162461bcd60e51b8152602060048201526015602482015274756e6578706563746564206163636f756e74696e6760581b6044820152606401610343565b80613487575050919050565b6069548110156134e15780606860008282546134a39190614704565b90915550506040518181527f7a745a2c63a535068f52ceca27debd5297bbad5f7f37ec53d044a59d0362445d906020015b60405180910390a161367d565b606a54811115613674577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561354657600080fd5b505af115801561355a573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b1580156135ea57600080fd5b505af11580156135fe573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906136229190613e6a565b50600160346000828254613636919061475d565b909155505060345460408051918252602082018390527f6aa7e30787b26429ced603a7aba8b19c4b5d5bcf29a3257da953c8d53bcaa3a691016134d4565b613263846137d0565b5050919050565b60335460ff166136cd5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610343565b6033805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa336130e9565b6000613753826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166137e89092919063ffffffff16565b805190915015611e6a57808060200190518101906137719190613e6a565b611e6a5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610343565b600081156137e0576137e0613091565b506000919050565b60606137f78484600085613801565b90505b9392505050565b6060824710156138625760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610343565b843b6138b05760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610343565b600080866001600160a01b031685876040516138cc91906141b5565b60006040518083038185875af1925050503d8060008114613909576040519150601f19603f3d011682016040523d82523d6000602084013e61390e565b606091505b509150915061391e828286613929565b979650505050505050565b606083156139385750816137fa565b8251156139485782518084602001fd5b8160405162461bcd60e51b815260040161034391906144d3565b8280548282559060005260206000209081019282156139b5579160200282015b828111156139b55781546001600160a01b0319166001600160a01b03843516178255602090920191600190910190613982565b506139c1929150613a1a565b5090565b8280548282559060005260206000209081019282156139b5579160200282015b828111156139b557825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906139e5565b5b808211156139c15760008155600101613a1b565b60008083601f840112613a4157600080fd5b5081356001600160401b03811115613a5857600080fd5b6020830191508360208260051b8501011115613a7357600080fd5b9250929050565b600082601f830112613a8b57600080fd5b81356020613aa0613a9b836146a0565b614670565b80838252828201915082860187848660051b8901011115613ac057600080fd5b60005b85811015613ae8578135613ad681614829565b84529284019290840190600101613ac3565b5090979650505050505050565b60008083601f840112613b0757600080fd5b5081356001600160401b03811115613b1e57600080fd5b602083019150836020828501011115613a7357600080fd5b600060a08284031215613b4857600080fd5b50919050565b600060a08284031215613b6057600080fd5b60405160a081018181106001600160401b0382111715613b8257613b82614813565b604052905080613b9183613bd9565b8152613b9f60208401613bf2565b6020820152613bb060408401613bf2565b60408201526060830135613bc38161483e565b6060820152608092830135920191909152919050565b803563ffffffff81168114613bed57600080fd5b919050565b80356001600160401b0381168114613bed57600080fd5b600060208284031215613c1b57600080fd5b81356137fa81614829565b600060208284031215613c3857600080fd5b81516137fa81614829565b60008060408385031215613c5657600080fd5b8235613c6181614829565b91506020830135613c7181614829565b809150509250929050565b600080600060608486031215613c9157600080fd5b8335613c9c81614829565b92506020840135613cac81614829565b929592945050506040919091013590565b60008060408385031215613cd057600080fd5b8235613cdb81614829565b946020939093013593505050565b60008060208385031215613cfc57600080fd5b82356001600160401b03811115613d1257600080fd5b613d1e85828601613a2f565b90969095509350505050565b600080600060608486031215613d3f57600080fd5b83356001600160401b0380821115613d5657600080fd5b613d6287838801613a7a565b94506020860135915080821115613d7857600080fd5b613d8487838801613a7a565b93506040860135915080821115613d9a57600080fd5b50613da786828701613a7a565b9150509250925092565b600080600060e08486031215613dc657600080fd5b83356001600160401b03811115613ddc57600080fd5b8401601f81018613613ded57600080fd5b80356020613dfd613a9b836146a0565b8083825282820191508285018a848660051b8801011115613e1d57600080fd5b600095505b84861015613e4757613e3381613bf2565b835260019590950194918301918301613e22565b509650508601359350613e61915086905060408601613b4e565b90509250925092565b600060208284031215613e7c57600080fd5b81516137fa8161483e565b600060208284031215613e9957600080fd5b5035919050565b60008060008060408587031215613eb657600080fd5b84356001600160401b0380821115613ecd57600080fd5b613ed988838901613af5565b90965094506020870135915080821115613ef257600080fd5b50613eff87828801613a2f565b95989497509550505050565b600080600080600080600080610120898b031215613f2857600080fd5b88356001600160401b0380821115613f3f57600080fd5b613f4b8c838d01613af5565b909a50985060208b0135915080821115613f6457600080fd5b613f708c838d01613a2f565b909850965060408b0135915080821115613f8957600080fd5b50613f968b828c01613af5565b90955093505060608901359150613fb08a60808b01613b36565b90509295985092959890939650565b600080600080600060e08688031215613fd757600080fd5b85356001600160401b0380821115613fee57600080fd5b613ffa89838a01613af5565b9097509550602088013591508082111561401357600080fd5b5061402088828901613a2f565b909450925061403490508760408801613b36565b90509295509295909350565b60008060006060848603121561405557600080fd5b505081359360208301359350604090920135919050565b60006020828403121561407e57600080fd5b5051919050565b6000806040838503121561409857600080fd5b50508035926020909101359150565b8183526000602080850194508260005b858110156140e3576001600160401b036140d083613bf2565b16875295820195908201906001016140b7565b509495945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000815180845261412f816020860160208601614774565b601f01601f19169290920160200192915050565b63ffffffff61415182613bd9565b16825261416060208201613bf2565b6001600160401b0380821660208501528061417d60408501613bf2565b166040850152505060608101356141938161483e565b15156060830152608090810135910152565b8183823760009101908152919050565b600082516141c7818460208701614774565b9190910192915050565b6001600160a01b03851681526101006020808301829052855191830182905260009161012084019187810191845b818110156142245783516001600160401b0316855293820193928201926001016141ff565b505082935086604086015263ffffffff865116606086015280860151925050506001600160401b0380821660808501528060408601511660a085015250506060830151151560c0830152608083015160e083015295945050505050565b6020808252825182820181905260009190848201906040850190845b818110156142c25783516001600160a01b03168352928401929184019160010161429d565b50909695505050505050565b6000604082016040835280865480835260608501915087600052602092508260002060005b828110156143185781546001600160a01b0316845292840192600191820191016142f3565b505050838103828501528481528590820160005b8681101561435a57823561433f81614829565b6001600160a01b03168252918301919083019060010161432c565b50979650505050505050565b60408152600061437a6040830186886140ee565b828103602084015261391e8185876140a7565b60006101208083526143a28184018b8d6140ee565b905082810360208401526143b781898b6140a7565b905082810360408401526143cc8187896140ee565b9150508360608301526143e26080830184614143565b9998505050505050505050565b60e08152600061440360e0830187896140ee565b82810360208401526144168186886140a7565b9150506144266040830184614143565b9695505050505050565b60808152600061444460808301888a6140ee565b82810360208401526144568188614117565b9050828103604084015261446b8186886140ee565b915050826060830152979650505050505050565b6060815260006144936060830186886140ee565b846020840152828103604084015261391e8185614117565b60208101600483106144cd57634e487b7160e01b600052602160045260246000fd5b91905290565b6020815260006137fa6020830184614117565b60208082526017908201527f43616c6c6572206973206e6f7420746865205661756c74000000000000000000604082015260600190565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60208082526010908201526f14185d5cd8589b194e881c185d5cd95960821b604082015260600190565b6020808252601d908201527f43616c6c6572206973206e6f7420746865205265676973747261746f72000000604082015260600190565b6020808252600e908201526d1499595b9d1c985b9d0818d85b1b60921b604082015260600190565b6020808252601c908201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604082015260600190565b6000808335601e1984360301811261462b57600080fd5b8301803591506001600160401b0382111561464557600080fd5b602001915036819003821315613a7357600080fd5b60008235605e198336030181126141c757600080fd5b604051601f8201601f191681016001600160401b038111828210171561469857614698614813565b604052919050565b60006001600160401b038211156146b9576146b9614813565b5060051b60200190565b600080821280156001600160ff1b03849003851316156146e5576146e56147bb565b600160ff1b83900384128116156146fe576146fe6147bb565b50500190565b60008219821115614717576147176147bb565b500190565b60008261473957634e487b7160e01b600052601260045260246000fd5b500490565b6000816000190483118215151615614758576147586147bb565b500290565b60008282101561476f5761476f6147bb565b500390565b60005b8381101561478f578181015183820152602001614777565b83811115610d305750506000910152565b60006000198214156147b4576147b46147bb565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b6001600160a01b038116811461237857600080fd5b801515811461237857600080fdfe53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac45357bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa264697066735822122002c6785cb55b316b2eea75081179f6e1764ee917e56d0fc72bd1ea4c6b39fa5064736f6c63430008070033", "libraries": {}, "devdoc": { "author": "Origin Protocol Inc", @@ -1418,7 +1359,10 @@ } }, "doAccounting()": { - "details": "This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it for now." + "details": "This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it for now.", + "returns": { + "accountingValid": "true if accounting was successful, false if fuse is blown" + } }, "getRewardTokenAddresses()": { "returns": { @@ -1432,15 +1376,11 @@ "_rewardTokenAddresses": "Address of reward token for platform" } }, - "manuallyFixAccounting(uint256,uint256,uint256,uint256,uint256,uint256)": { - "details": "allow the accounting governor to fix the accounting of this strategy and unpause", + "manuallyFixAccounting(int256,int256,uint256)": { "params": { - "_activeDepositedValidators": "the override value of activeDepositedValidators", - "_consensusRewards": "the override value for consensusRewards", - "_ethThresholdCheck": "maximum allowed ETH balance on the contract for the function to run", - "_ethToWeth": "the amount of ETH to be converted to WETH", - "_wethThresholdCheck": "maximum allowed WETH balance on the contract for the function to run the above 2 checks are done so transaction doesn't get front run and cause unexpected behaviour", - "_wethToBeSentToVault": "the amount of WETH to be sent to the Vault" + "_consensusRewardsDelta": "adjust the accounted for consensus rewards up or down", + "_validatorsDelta": "adjust the active validators by plus one, minus one or unchanged with zero", + "_wethToVaultAmount": "the amount of WETH to be sent to the Vault" } }, "paused()": { @@ -1528,8 +1468,8 @@ "WETH_TOKEN_ADDRESS()": { "notice": "The address of the Wrapped ETH (WETH) token contract" }, - "accountingGovernor()": { - "notice": "Governor that can manually correct the accounting" + "activeDepositedValidators()": { + "notice": "The number of validators that have 32 (!) ETH actively deposited. When a new deposit to a validator happens this number increases, when a validator exit is detected this number decreases." }, "assetToPToken(address)": { "notice": "asset => pToken (Platform Specific Token Address)" @@ -1582,6 +1522,9 @@ "isGovernor()": { "notice": "Returns true if the caller is the current Governor." }, + "manuallyFixAccounting(int256,int256,uint256)": { + "notice": "Allow the Strategist to fix the accounting of this strategy and unpause." + }, "platformAddress()": { "notice": "Address of the underlying platform" }, @@ -1649,7 +1592,7 @@ "storageLayout": { "storage": [ { - "astId": 5232, + "astId": 41335, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "initialized", "offset": 0, @@ -1657,7 +1600,7 @@ "type": "t_bool" }, { - "astId": 5235, + "astId": 41338, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "initializing", "offset": 1, @@ -1665,7 +1608,7 @@ "type": "t_bool" }, { - "astId": 5275, + "astId": 41378, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "______gap", "offset": 0, @@ -1673,7 +1616,7 @@ "type": "t_array(t_uint256)50_storage" }, { - "astId": 17, + "astId": 549, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "_paused", "offset": 0, @@ -1681,7 +1624,7 @@ "type": "t_bool" }, { - "astId": 3497, + "astId": 34647, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "validatorRegistrator", "offset": 1, @@ -1689,7 +1632,7 @@ "type": "t_address" }, { - "astId": 3500, + "astId": 34650, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "activeDepositedValidators", "offset": 0, @@ -1697,15 +1640,15 @@ "type": "t_uint256" }, { - "astId": 3506, + "astId": 34656, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "validatorsStates", "offset": 0, "slot": "53", - "type": "t_mapping(t_bytes32,t_enum(VALIDATOR_STATE)3515)" + "type": "t_mapping(t_bytes32,t_enum(VALIDATOR_STATE)34665)" }, { - "astId": 3510, + "astId": 34660, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "__gap", "offset": 0, @@ -1713,7 +1656,7 @@ "type": "t_array(t_uint256)50_storage" }, { - "astId": 3042, + "astId": 34184, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "consensusRewards", "offset": 0, @@ -1721,7 +1664,7 @@ "type": "t_uint256" }, { - "astId": 3046, + "astId": 34188, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "fuseIntervalStart", "offset": 0, @@ -1729,7 +1672,7 @@ "type": "t_uint256" }, { - "astId": 3050, + "astId": 34192, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "fuseIntervalEnd", "offset": 0, @@ -1737,99 +1680,91 @@ "type": "t_uint256" }, { - "astId": 3053, - "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", - "label": "accountingGovernor", - "offset": 0, - "slot": "107", - "type": "t_address" - }, - { - "astId": 3057, + "astId": 34196, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "__gap", "offset": 0, - "slot": "108", + "slot": "107", "type": "t_array(t_uint256)50_storage" }, { - "astId": 5355, + "astId": 41458, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "_deprecated_platformAddress", "offset": 0, - "slot": "158", + "slot": "157", "type": "t_address" }, { - "astId": 5358, + "astId": 41461, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "_deprecated_vaultAddress", "offset": 0, - "slot": "159", + "slot": "158", "type": "t_address" }, { - "astId": 5363, + "astId": 41466, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "assetToPToken", "offset": 0, - "slot": "160", + "slot": "159", "type": "t_mapping(t_address,t_address)" }, { - "astId": 5367, + "astId": 41470, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "assetsMapped", "offset": 0, - "slot": "161", + "slot": "160", "type": "t_array(t_address)dyn_storage" }, { - "astId": 5369, + "astId": 41472, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "_deprecated_rewardTokenAddress", "offset": 0, - "slot": "162", + "slot": "161", "type": "t_address" }, { - "astId": 5371, + "astId": 41474, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "_deprecated_rewardLiquidationThreshold", "offset": 0, - "slot": "163", + "slot": "162", "type": "t_uint256" }, { - "astId": 5374, + "astId": 41477, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "harvesterAddress", "offset": 0, - "slot": "164", + "slot": "163", "type": "t_address" }, { - "astId": 5378, + "astId": 41481, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "rewardTokenAddresses", "offset": 0, - "slot": "165", + "slot": "164", "type": "t_array(t_address)dyn_storage" }, { - "astId": 5382, + "astId": 41485, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "_reserved", "offset": 0, - "slot": "166", + "slot": "165", "type": "t_array(t_int256)98_storage" }, { - "astId": 2613, + "astId": 33757, "contract": "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol:NativeStakingSSVStrategy", "label": "__gap", "offset": 0, - "slot": "264", + "slot": "263", "type": "t_array(t_uint256)50_storage" } ], @@ -1867,7 +1802,7 @@ "label": "bytes32", "numberOfBytes": "32" }, - "t_enum(VALIDATOR_STATE)3515": { + "t_enum(VALIDATOR_STATE)34665": { "encoding": "inplace", "label": "enum ValidatorRegistrator.VALIDATOR_STATE", "numberOfBytes": "1" @@ -1884,12 +1819,12 @@ "numberOfBytes": "32", "value": "t_address" }, - "t_mapping(t_bytes32,t_enum(VALIDATOR_STATE)3515)": { + "t_mapping(t_bytes32,t_enum(VALIDATOR_STATE)34665)": { "encoding": "mapping", "key": "t_bytes32", "label": "mapping(bytes32 => enum ValidatorRegistrator.VALIDATOR_STATE)", "numberOfBytes": "32", - "value": "t_enum(VALIDATOR_STATE)3515" + "value": "t_enum(VALIDATOR_STATE)34665" }, "t_uint256": { "encoding": "inplace", diff --git a/contracts/deployments/holesky/solcInputs/66dbdc9fbde8f1c7cc59f29d272eb661.json b/contracts/deployments/holesky/solcInputs/66dbdc9fbde8f1c7cc59f29d272eb661.json new file mode 100644 index 0000000000..7c4a288f05 --- /dev/null +++ b/contracts/deployments/holesky/solcInputs/66dbdc9fbde8f1c7cc59f29d272eb661.json @@ -0,0 +1,674 @@ +{ + "language": "Solidity", + "sources": { + "@openzeppelin/contracts/access/AccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/AccessControl.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControl.sol\";\nimport \"../utils/Context.sol\";\nimport \"../utils/Strings.sol\";\nimport \"../utils/introspection/ERC165.sol\";\n\n/**\n * @dev Contract module that allows children to implement role-based access\n * control mechanisms. This is a lightweight version that doesn't allow enumerating role\n * members except through off-chain means by accessing the contract event logs. Some\n * applications may benefit from on-chain enumerability, for those cases see\n * {AccessControlEnumerable}.\n *\n * Roles are referred to by their `bytes32` identifier. These should be exposed\n * in the external API and be unique. The best way to achieve this is by\n * using `public constant` hash digests:\n *\n * ```\n * bytes32 public constant MY_ROLE = keccak256(\"MY_ROLE\");\n * ```\n *\n * Roles can be used to represent a set of permissions. To restrict access to a\n * function call, use {hasRole}:\n *\n * ```\n * function foo() public {\n * require(hasRole(MY_ROLE, msg.sender));\n * ...\n * }\n * ```\n *\n * Roles can be granted and revoked dynamically via the {grantRole} and\n * {revokeRole} functions. Each role has an associated admin role, and only\n * accounts that have a role's admin role can call {grantRole} and {revokeRole}.\n *\n * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means\n * that only accounts with this role will be able to grant or revoke other\n * roles. More complex role relationships can be created by using\n * {_setRoleAdmin}.\n *\n * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to\n * grant and revoke this role. Extra precautions should be taken to secure\n * accounts that have been granted it.\n */\nabstract contract AccessControl is Context, IAccessControl, ERC165 {\n struct RoleData {\n mapping(address => bool) members;\n bytes32 adminRole;\n }\n\n mapping(bytes32 => RoleData) private _roles;\n\n bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;\n\n /**\n * @dev Modifier that checks that an account has a specific role. Reverts\n * with a standardized message including the required role.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n *\n * _Available since v4.1._\n */\n modifier onlyRole(bytes32 role) {\n _checkRole(role, _msgSender());\n _;\n }\n\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);\n }\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) public view override returns (bool) {\n return _roles[role].members[account];\n }\n\n /**\n * @dev Revert with a standard message if `account` is missing `role`.\n *\n * The format of the revert reason is given by the following regular expression:\n *\n * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/\n */\n function _checkRole(bytes32 role, address account) internal view {\n if (!hasRole(role, account)) {\n revert(\n string(\n abi.encodePacked(\n \"AccessControl: account \",\n Strings.toHexString(uint160(account), 20),\n \" is missing role \",\n Strings.toHexString(uint256(role), 32)\n )\n )\n );\n }\n }\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) public view override returns (bytes32) {\n return _roles[role].adminRole;\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _grantRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {\n _revokeRole(role, account);\n }\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been revoked `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n */\n function renounceRole(bytes32 role, address account) public virtual override {\n require(account == _msgSender(), \"AccessControl: can only renounce roles for self\");\n\n _revokeRole(role, account);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event. Note that unlike {grantRole}, this function doesn't perform any\n * checks on the calling account.\n *\n * [WARNING]\n * ====\n * This function should only be called from the constructor when setting\n * up the initial roles for the system.\n *\n * Using this function in any other way is effectively circumventing the admin\n * system imposed by {AccessControl}.\n * ====\n *\n * NOTE: This function is deprecated in favor of {_grantRole}.\n */\n function _setupRole(bytes32 role, address account) internal virtual {\n _grantRole(role, account);\n }\n\n /**\n * @dev Sets `adminRole` as ``role``'s admin role.\n *\n * Emits a {RoleAdminChanged} event.\n */\n function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {\n bytes32 previousAdminRole = getRoleAdmin(role);\n _roles[role].adminRole = adminRole;\n emit RoleAdminChanged(role, previousAdminRole, adminRole);\n }\n\n /**\n * @dev Grants `role` to `account`.\n *\n * Internal function without access restriction.\n */\n function _grantRole(bytes32 role, address account) internal virtual {\n if (!hasRole(role, account)) {\n _roles[role].members[account] = true;\n emit RoleGranted(role, account, _msgSender());\n }\n }\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * Internal function without access restriction.\n */\n function _revokeRole(bytes32 role, address account) internal virtual {\n if (hasRole(role, account)) {\n _roles[role].members[account] = false;\n emit RoleRevoked(role, account, _msgSender());\n }\n }\n}\n" + }, + "@openzeppelin/contracts/access/AccessControlEnumerable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/AccessControlEnumerable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControlEnumerable.sol\";\nimport \"./AccessControl.sol\";\nimport \"../utils/structs/EnumerableSet.sol\";\n\n/**\n * @dev Extension of {AccessControl} that allows enumerating the members of each role.\n */\nabstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {\n using EnumerableSet for EnumerableSet.AddressSet;\n\n mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers;\n\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId);\n }\n\n /**\n * @dev Returns one of the accounts that have `role`. `index` must be a\n * value between 0 and {getRoleMemberCount}, non-inclusive.\n *\n * Role bearers are not sorted in any particular way, and their ordering may\n * change at any point.\n *\n * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure\n * you perform all queries on the same block. See the following\n * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]\n * for more information.\n */\n function getRoleMember(bytes32 role, uint256 index) public view override returns (address) {\n return _roleMembers[role].at(index);\n }\n\n /**\n * @dev Returns the number of accounts that have `role`. Can be used\n * together with {getRoleMember} to enumerate all bearers of a role.\n */\n function getRoleMemberCount(bytes32 role) public view override returns (uint256) {\n return _roleMembers[role].length();\n }\n\n /**\n * @dev Overload {_grantRole} to track enumerable memberships\n */\n function _grantRole(bytes32 role, address account) internal virtual override {\n super._grantRole(role, account);\n _roleMembers[role].add(account);\n }\n\n /**\n * @dev Overload {_revokeRole} to track enumerable memberships\n */\n function _revokeRole(bytes32 role, address account) internal virtual override {\n super._revokeRole(role, account);\n _roleMembers[role].remove(account);\n }\n}\n" + }, + "@openzeppelin/contracts/access/IAccessControl.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev External interface of AccessControl declared to support ERC165 detection.\n */\ninterface IAccessControl {\n /**\n * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`\n *\n * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite\n * {RoleAdminChanged} not being emitted signaling this.\n *\n * _Available since v3.1._\n */\n event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);\n\n /**\n * @dev Emitted when `account` is granted `role`.\n *\n * `sender` is the account that originated the contract call, an admin role\n * bearer except when using {AccessControl-_setupRole}.\n */\n event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Emitted when `account` is revoked `role`.\n *\n * `sender` is the account that originated the contract call:\n * - if using `revokeRole`, it is the admin role bearer\n * - if using `renounceRole`, it is the role bearer (i.e. `account`)\n */\n event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);\n\n /**\n * @dev Returns `true` if `account` has been granted `role`.\n */\n function hasRole(bytes32 role, address account) external view returns (bool);\n\n /**\n * @dev Returns the admin role that controls `role`. See {grantRole} and\n * {revokeRole}.\n *\n * To change a role's admin, use {AccessControl-_setRoleAdmin}.\n */\n function getRoleAdmin(bytes32 role) external view returns (bytes32);\n\n /**\n * @dev Grants `role` to `account`.\n *\n * If `account` had not been already granted `role`, emits a {RoleGranted}\n * event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function grantRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from `account`.\n *\n * If `account` had been granted `role`, emits a {RoleRevoked} event.\n *\n * Requirements:\n *\n * - the caller must have ``role``'s admin role.\n */\n function revokeRole(bytes32 role, address account) external;\n\n /**\n * @dev Revokes `role` from the calling account.\n *\n * Roles are often managed via {grantRole} and {revokeRole}: this function's\n * purpose is to provide a mechanism for accounts to lose their privileges\n * if they are compromised (such as when a trusted device is misplaced).\n *\n * If the calling account had been granted `role`, emits a {RoleRevoked}\n * event.\n *\n * Requirements:\n *\n * - the caller must be `account`.\n */\n function renounceRole(bytes32 role, address account) external;\n}\n" + }, + "@openzeppelin/contracts/access/IAccessControlEnumerable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControl.sol\";\n\n/**\n * @dev External interface of AccessControlEnumerable declared to support ERC165 detection.\n */\ninterface IAccessControlEnumerable is IAccessControl {\n /**\n * @dev Returns one of the accounts that have `role`. `index` must be a\n * value between 0 and {getRoleMemberCount}, non-inclusive.\n *\n * Role bearers are not sorted in any particular way, and their ordering may\n * change at any point.\n *\n * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure\n * you perform all queries on the same block. See the following\n * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]\n * for more information.\n */\n function getRoleMember(bytes32 role, uint256 index) external view returns (address);\n\n /**\n * @dev Returns the number of accounts that have `role`. Can be used\n * together with {getRoleMember} to enumerate all bearers of a role.\n */\n function getRoleMemberCount(bytes32 role) external view returns (uint256);\n}\n" + }, + "@openzeppelin/contracts/security/Pausable.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (security/Pausable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which allows children to implement an emergency stop\n * mechanism that can be triggered by an authorized account.\n *\n * This module is used through inheritance. It will make available the\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\n * the functions of your contract. Note that they will not be pausable by\n * simply including this module, only once the modifiers are put in place.\n */\nabstract contract Pausable is Context {\n /**\n * @dev Emitted when the pause is triggered by `account`.\n */\n event Paused(address account);\n\n /**\n * @dev Emitted when the pause is lifted by `account`.\n */\n event Unpaused(address account);\n\n bool private _paused;\n\n /**\n * @dev Initializes the contract in unpaused state.\n */\n constructor() {\n _paused = false;\n }\n\n /**\n * @dev Returns true if the contract is paused, and false otherwise.\n */\n function paused() public view virtual returns (bool) {\n return _paused;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is not paused.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n modifier whenNotPaused() {\n require(!paused(), \"Pausable: paused\");\n _;\n }\n\n /**\n * @dev Modifier to make a function callable only when the contract is paused.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n modifier whenPaused() {\n require(paused(), \"Pausable: not paused\");\n _;\n }\n\n /**\n * @dev Triggers stopped state.\n *\n * Requirements:\n *\n * - The contract must not be paused.\n */\n function _pause() internal virtual whenNotPaused {\n _paused = true;\n emit Paused(_msgSender());\n }\n\n /**\n * @dev Returns to normal state.\n *\n * Requirements:\n *\n * - The contract must be paused.\n */\n function _unpause() internal virtual whenPaused {\n _paused = false;\n emit Unpaused(_msgSender());\n }\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/ERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/ERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC20.sol\";\nimport \"./extensions/IERC20Metadata.sol\";\nimport \"../../utils/Context.sol\";\n\n/**\n * @dev Implementation of the {IERC20} interface.\n *\n * This implementation is agnostic to the way tokens are created. This means\n * that a supply mechanism has to be added in a derived contract using {_mint}.\n * For a generic mechanism see {ERC20PresetMinterPauser}.\n *\n * TIP: For a detailed writeup see our guide\n * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How\n * to implement supply mechanisms].\n *\n * We have followed general OpenZeppelin Contracts guidelines: functions revert\n * instead returning `false` on failure. This behavior is nonetheless\n * conventional and does not conflict with the expectations of ERC20\n * applications.\n *\n * Additionally, an {Approval} event is emitted on calls to {transferFrom}.\n * This allows applications to reconstruct the allowance for all accounts just\n * by listening to said events. Other implementations of the EIP may not emit\n * these events, as it isn't required by the specification.\n *\n * Finally, the non-standard {decreaseAllowance} and {increaseAllowance}\n * functions have been added to mitigate the well-known issues around setting\n * allowances. See {IERC20-approve}.\n */\ncontract ERC20 is Context, IERC20, IERC20Metadata {\n mapping(address => uint256) private _balances;\n\n mapping(address => mapping(address => uint256)) private _allowances;\n\n uint256 private _totalSupply;\n\n string private _name;\n string private _symbol;\n\n /**\n * @dev Sets the values for {name} and {symbol}.\n *\n * The default value of {decimals} is 18. To select a different value for\n * {decimals} you should overload it.\n *\n * All two of these values are immutable: they can only be set once during\n * construction.\n */\n constructor(string memory name_, string memory symbol_) {\n _name = name_;\n _symbol = symbol_;\n }\n\n /**\n * @dev Returns the name of the token.\n */\n function name() public view virtual override returns (string memory) {\n return _name;\n }\n\n /**\n * @dev Returns the symbol of the token, usually a shorter version of the\n * name.\n */\n function symbol() public view virtual override returns (string memory) {\n return _symbol;\n }\n\n /**\n * @dev Returns the number of decimals used to get its user representation.\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\n * be displayed to a user as `5.05` (`505 / 10 ** 2`).\n *\n * Tokens usually opt for a value of 18, imitating the relationship between\n * Ether and Wei. This is the value {ERC20} uses, unless this function is\n * overridden;\n *\n * NOTE: This information is only used for _display_ purposes: it in\n * no way affects any of the arithmetic of the contract, including\n * {IERC20-balanceOf} and {IERC20-transfer}.\n */\n function decimals() public view virtual override returns (uint8) {\n return 18;\n }\n\n /**\n * @dev See {IERC20-totalSupply}.\n */\n function totalSupply() public view virtual override returns (uint256) {\n return _totalSupply;\n }\n\n /**\n * @dev See {IERC20-balanceOf}.\n */\n function balanceOf(address account) public view virtual override returns (uint256) {\n return _balances[account];\n }\n\n /**\n * @dev See {IERC20-transfer}.\n *\n * Requirements:\n *\n * - `recipient` cannot be the zero address.\n * - the caller must have a balance of at least `amount`.\n */\n function transfer(address recipient, uint256 amount) public virtual override returns (bool) {\n _transfer(_msgSender(), recipient, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-allowance}.\n */\n function allowance(address owner, address spender) public view virtual override returns (uint256) {\n return _allowances[owner][spender];\n }\n\n /**\n * @dev See {IERC20-approve}.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function approve(address spender, uint256 amount) public virtual override returns (bool) {\n _approve(_msgSender(), spender, amount);\n return true;\n }\n\n /**\n * @dev See {IERC20-transferFrom}.\n *\n * Emits an {Approval} event indicating the updated allowance. This is not\n * required by the EIP. See the note at the beginning of {ERC20}.\n *\n * Requirements:\n *\n * - `sender` and `recipient` cannot be the zero address.\n * - `sender` must have a balance of at least `amount`.\n * - the caller must have allowance for ``sender``'s tokens of at least\n * `amount`.\n */\n function transferFrom(\n address sender,\n address recipient,\n uint256 amount\n ) public virtual override returns (bool) {\n _transfer(sender, recipient, amount);\n\n uint256 currentAllowance = _allowances[sender][_msgSender()];\n require(currentAllowance >= amount, \"ERC20: transfer amount exceeds allowance\");\n unchecked {\n _approve(sender, _msgSender(), currentAllowance - amount);\n }\n\n return true;\n }\n\n /**\n * @dev Atomically increases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n */\n function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {\n _approve(_msgSender(), spender, _allowances[_msgSender()][spender] + addedValue);\n return true;\n }\n\n /**\n * @dev Atomically decreases the allowance granted to `spender` by the caller.\n *\n * This is an alternative to {approve} that can be used as a mitigation for\n * problems described in {IERC20-approve}.\n *\n * Emits an {Approval} event indicating the updated allowance.\n *\n * Requirements:\n *\n * - `spender` cannot be the zero address.\n * - `spender` must have allowance for the caller of at least\n * `subtractedValue`.\n */\n function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {\n uint256 currentAllowance = _allowances[_msgSender()][spender];\n require(currentAllowance >= subtractedValue, \"ERC20: decreased allowance below zero\");\n unchecked {\n _approve(_msgSender(), spender, currentAllowance - subtractedValue);\n }\n\n return true;\n }\n\n /**\n * @dev Moves `amount` of tokens from `sender` to `recipient`.\n *\n * This internal function is equivalent to {transfer}, and can be used to\n * e.g. implement automatic token fees, slashing mechanisms, etc.\n *\n * Emits a {Transfer} event.\n *\n * Requirements:\n *\n * - `sender` cannot be the zero address.\n * - `recipient` cannot be the zero address.\n * - `sender` must have a balance of at least `amount`.\n */\n function _transfer(\n address sender,\n address recipient,\n uint256 amount\n ) internal virtual {\n require(sender != address(0), \"ERC20: transfer from the zero address\");\n require(recipient != address(0), \"ERC20: transfer to the zero address\");\n\n _beforeTokenTransfer(sender, recipient, amount);\n\n uint256 senderBalance = _balances[sender];\n require(senderBalance >= amount, \"ERC20: transfer amount exceeds balance\");\n unchecked {\n _balances[sender] = senderBalance - amount;\n }\n _balances[recipient] += amount;\n\n emit Transfer(sender, recipient, amount);\n\n _afterTokenTransfer(sender, recipient, amount);\n }\n\n /** @dev Creates `amount` tokens and assigns them to `account`, increasing\n * the total supply.\n *\n * Emits a {Transfer} event with `from` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n */\n function _mint(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: mint to the zero address\");\n\n _beforeTokenTransfer(address(0), account, amount);\n\n _totalSupply += amount;\n _balances[account] += amount;\n emit Transfer(address(0), account, amount);\n\n _afterTokenTransfer(address(0), account, amount);\n }\n\n /**\n * @dev Destroys `amount` tokens from `account`, reducing the\n * total supply.\n *\n * Emits a {Transfer} event with `to` set to the zero address.\n *\n * Requirements:\n *\n * - `account` cannot be the zero address.\n * - `account` must have at least `amount` tokens.\n */\n function _burn(address account, uint256 amount) internal virtual {\n require(account != address(0), \"ERC20: burn from the zero address\");\n\n _beforeTokenTransfer(account, address(0), amount);\n\n uint256 accountBalance = _balances[account];\n require(accountBalance >= amount, \"ERC20: burn amount exceeds balance\");\n unchecked {\n _balances[account] = accountBalance - amount;\n }\n _totalSupply -= amount;\n\n emit Transfer(account, address(0), amount);\n\n _afterTokenTransfer(account, address(0), amount);\n }\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.\n *\n * This internal function is equivalent to `approve`, and can be used to\n * e.g. set automatic allowances for certain subsystems, etc.\n *\n * Emits an {Approval} event.\n *\n * Requirements:\n *\n * - `owner` cannot be the zero address.\n * - `spender` cannot be the zero address.\n */\n function _approve(\n address owner,\n address spender,\n uint256 amount\n ) internal virtual {\n require(owner != address(0), \"ERC20: approve from the zero address\");\n require(spender != address(0), \"ERC20: approve to the zero address\");\n\n _allowances[owner][spender] = amount;\n emit Approval(owner, spender, amount);\n }\n\n /**\n * @dev Hook that is called before any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * will be transferred to `to`.\n * - when `from` is zero, `amount` tokens will be minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens will be burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _beforeTokenTransfer(\n address from,\n address to,\n uint256 amount\n ) internal virtual {}\n\n /**\n * @dev Hook that is called after any transfer of tokens. This includes\n * minting and burning.\n *\n * Calling conditions:\n *\n * - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens\n * has been transferred to `to`.\n * - when `from` is zero, `amount` tokens have been minted for `to`.\n * - when `to` is zero, `amount` of ``from``'s tokens have been burned.\n * - `from` and `to` are never both zero.\n *\n * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].\n */\n function _afterTokenTransfer(\n address from,\n address to,\n uint256 amount\n ) internal virtual {}\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\n\n/**\n * @dev Interface for the optional metadata functions from the ERC20 standard.\n *\n * _Available since v4.1._\n */\ninterface IERC20Metadata is IERC20 {\n /**\n * @dev Returns the name of the token.\n */\n function name() external view returns (string memory);\n\n /**\n * @dev Returns the symbol of the token.\n */\n function symbol() external view returns (string memory);\n\n /**\n * @dev Returns the decimals places of the token.\n */\n function decimals() external view returns (uint8);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/IERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 standard as defined in the EIP.\n */\ninterface IERC20 {\n /**\n * @dev Returns the amount of tokens in existence.\n */\n function totalSupply() external view returns (uint256);\n\n /**\n * @dev Returns the amount of tokens owned by `account`.\n */\n function balanceOf(address account) external view returns (uint256);\n\n /**\n * @dev Moves `amount` tokens from the caller's account to `recipient`.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transfer(address recipient, uint256 amount) external returns (bool);\n\n /**\n * @dev Returns the remaining number of tokens that `spender` will be\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\n * zero by default.\n *\n * This value changes when {approve} or {transferFrom} are called.\n */\n function allowance(address owner, address spender) external view returns (uint256);\n\n /**\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\n * that someone may use both the old and the new allowance by unfortunate\n * transaction ordering. One possible solution to mitigate this race\n * condition is to first reduce the spender's allowance to 0 and set the\n * desired value afterwards:\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n *\n * Emits an {Approval} event.\n */\n function approve(address spender, uint256 amount) external returns (bool);\n\n /**\n * @dev Moves `amount` tokens from `sender` to `recipient` using the\n * allowance mechanism. `amount` is then deducted from the caller's\n * allowance.\n *\n * Returns a boolean value indicating whether the operation succeeded.\n *\n * Emits a {Transfer} event.\n */\n function transferFrom(\n address sender,\n address recipient,\n uint256 amount\n ) external returns (bool);\n\n /**\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\n * another (`to`).\n *\n * Note that `value` may be zero.\n */\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n /**\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\n * a call to {approve}. `value` is the new allowance.\n */\n event Approval(address indexed owner, address indexed spender, uint256 value);\n}\n" + }, + "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n using Address for address;\n\n function safeTransfer(\n IERC20 token,\n address to,\n uint256 value\n ) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n }\n\n function safeTransferFrom(\n IERC20 token,\n address from,\n address to,\n uint256 value\n ) internal {\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n }\n\n /**\n * @dev Deprecated. This function has issues similar to the ones found in\n * {IERC20-approve}, and its usage is discouraged.\n *\n * Whenever possible, use {safeIncreaseAllowance} and\n * {safeDecreaseAllowance} instead.\n */\n function safeApprove(\n IERC20 token,\n address spender,\n uint256 value\n ) internal {\n // safeApprove should only be called when setting an initial allowance,\n // or when resetting it to zero. To increase and decrease it, use\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n require(\n (value == 0) || (token.allowance(address(this), spender) == 0),\n \"SafeERC20: approve from non-zero to non-zero allowance\"\n );\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n }\n\n function safeIncreaseAllowance(\n IERC20 token,\n address spender,\n uint256 value\n ) internal {\n uint256 newAllowance = token.allowance(address(this), spender) + value;\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\n }\n\n function safeDecreaseAllowance(\n IERC20 token,\n address spender,\n uint256 value\n ) internal {\n unchecked {\n uint256 oldAllowance = token.allowance(address(this), spender);\n require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n uint256 newAllowance = oldAllowance - value;\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\n }\n }\n\n /**\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n * on the return value: the return value is optional (but if data is returned, it must not be false).\n * @param token The token targeted by the call.\n * @param data The call data (encoded using abi.encode or one of its variants).\n */\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\n // the target address contains contract code and also asserts for success in the low-level call.\n\n bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n if (returndata.length > 0) {\n // Return data is optional\n require(abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n }\n }\n}\n" + }, + "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @title ERC721 token receiver interface\n * @dev Interface for any contract that wants to support safeTransfers\n * from ERC721 asset contracts.\n */\ninterface IERC721Receiver {\n /**\n * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}\n * by `operator` from `from`, this function is called.\n *\n * It must return its Solidity selector to confirm the token transfer.\n * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.\n *\n * The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.\n */\n function onERC721Received(\n address operator,\n address from,\n uint256 tokenId,\n bytes calldata data\n ) external returns (bytes4);\n}\n" + }, + "@openzeppelin/contracts/utils/Address.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize, which returns 0 for contracts in\n // construction, since the code is only stored at the end of the\n // constructor execution.\n\n uint256 size;\n assembly {\n size := extcodesize(account)\n }\n return size > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCall(target, data, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n require(isContract(target), \"Address: call to non-contract\");\n\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n require(isContract(target), \"Address: static call to non-contract\");\n\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(isContract(target), \"Address: delegate call to non-contract\");\n\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Context.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Provides information about the current execution context, including the\n * sender of the transaction and its data. While these are generally available\n * via msg.sender and msg.data, they should not be accessed in such a direct\n * manner, since when dealing with meta-transactions the account sending and\n * paying for execution may not be the actual sender (as far as an application\n * is concerned).\n *\n * This contract is only required for intermediate, library-like contracts.\n */\nabstract contract Context {\n function _msgSender() internal view virtual returns (address) {\n return msg.sender;\n }\n\n function _msgData() internal view virtual returns (bytes calldata) {\n return msg.data;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/ERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC165.sol\";\n\n/**\n * @dev Implementation of the {IERC165} interface.\n *\n * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check\n * for the additional interface id that will be supported. For example:\n *\n * ```solidity\n * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);\n * }\n * ```\n *\n * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.\n */\nabstract contract ERC165 is IERC165 {\n /**\n * @dev See {IERC165-supportsInterface}.\n */\n function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n return interfaceId == type(IERC165).interfaceId;\n }\n}\n" + }, + "@openzeppelin/contracts/utils/introspection/IERC165.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC165 standard, as defined in the\n * https://eips.ethereum.org/EIPS/eip-165[EIP].\n *\n * Implementers can declare support of contract interfaces, which can then be\n * queried by others ({ERC165Checker}).\n *\n * For an implementation, see {ERC165}.\n */\ninterface IERC165 {\n /**\n * @dev Returns true if this contract implements the interface defined by\n * `interfaceId`. See the corresponding\n * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]\n * to learn more about how these ids are created.\n *\n * This function call must use less than 30 000 gas.\n */\n function supportsInterface(bytes4 interfaceId) external view returns (bool);\n}\n" + }, + "@openzeppelin/contracts/utils/math/Math.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary Math {\n /**\n * @dev Returns the largest of two numbers.\n */\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\n return a >= b ? a : b;\n }\n\n /**\n * @dev Returns the smallest of two numbers.\n */\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\n return a < b ? a : b;\n }\n\n /**\n * @dev Returns the average of two numbers. The result is rounded towards\n * zero.\n */\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b) / 2 can overflow.\n return (a & b) + (a ^ b) / 2;\n }\n\n /**\n * @dev Returns the ceiling of the division of two numbers.\n *\n * This differs from standard division with `/` in that it rounds up instead\n * of rounding down.\n */\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\n // (a + b - 1) / b can overflow on addition, so we distribute.\n return a / b + (a % b == 0 ? 0 : 1);\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SafeCast.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeCast.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow\n * checks.\n *\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\n * easily result in undesired exploitation or bugs, since developers usually\n * assume that overflows raise errors. `SafeCast` restores this intuition by\n * reverting the transaction when such an operation overflows.\n *\n * Using this library instead of the unchecked operations eliminates an entire\n * class of bugs, so it's recommended to use it always.\n *\n * Can be combined with {SafeMath} and {SignedSafeMath} to extend it to smaller types, by performing\n * all math on `uint256` and `int256` and then downcasting.\n */\nlibrary SafeCast {\n /**\n * @dev Returns the downcasted uint224 from uint256, reverting on\n * overflow (when the input is greater than largest uint224).\n *\n * Counterpart to Solidity's `uint224` operator.\n *\n * Requirements:\n *\n * - input must fit into 224 bits\n */\n function toUint224(uint256 value) internal pure returns (uint224) {\n require(value <= type(uint224).max, \"SafeCast: value doesn't fit in 224 bits\");\n return uint224(value);\n }\n\n /**\n * @dev Returns the downcasted uint128 from uint256, reverting on\n * overflow (when the input is greater than largest uint128).\n *\n * Counterpart to Solidity's `uint128` operator.\n *\n * Requirements:\n *\n * - input must fit into 128 bits\n */\n function toUint128(uint256 value) internal pure returns (uint128) {\n require(value <= type(uint128).max, \"SafeCast: value doesn't fit in 128 bits\");\n return uint128(value);\n }\n\n /**\n * @dev Returns the downcasted uint96 from uint256, reverting on\n * overflow (when the input is greater than largest uint96).\n *\n * Counterpart to Solidity's `uint96` operator.\n *\n * Requirements:\n *\n * - input must fit into 96 bits\n */\n function toUint96(uint256 value) internal pure returns (uint96) {\n require(value <= type(uint96).max, \"SafeCast: value doesn't fit in 96 bits\");\n return uint96(value);\n }\n\n /**\n * @dev Returns the downcasted uint64 from uint256, reverting on\n * overflow (when the input is greater than largest uint64).\n *\n * Counterpart to Solidity's `uint64` operator.\n *\n * Requirements:\n *\n * - input must fit into 64 bits\n */\n function toUint64(uint256 value) internal pure returns (uint64) {\n require(value <= type(uint64).max, \"SafeCast: value doesn't fit in 64 bits\");\n return uint64(value);\n }\n\n /**\n * @dev Returns the downcasted uint32 from uint256, reverting on\n * overflow (when the input is greater than largest uint32).\n *\n * Counterpart to Solidity's `uint32` operator.\n *\n * Requirements:\n *\n * - input must fit into 32 bits\n */\n function toUint32(uint256 value) internal pure returns (uint32) {\n require(value <= type(uint32).max, \"SafeCast: value doesn't fit in 32 bits\");\n return uint32(value);\n }\n\n /**\n * @dev Returns the downcasted uint16 from uint256, reverting on\n * overflow (when the input is greater than largest uint16).\n *\n * Counterpart to Solidity's `uint16` operator.\n *\n * Requirements:\n *\n * - input must fit into 16 bits\n */\n function toUint16(uint256 value) internal pure returns (uint16) {\n require(value <= type(uint16).max, \"SafeCast: value doesn't fit in 16 bits\");\n return uint16(value);\n }\n\n /**\n * @dev Returns the downcasted uint8 from uint256, reverting on\n * overflow (when the input is greater than largest uint8).\n *\n * Counterpart to Solidity's `uint8` operator.\n *\n * Requirements:\n *\n * - input must fit into 8 bits.\n */\n function toUint8(uint256 value) internal pure returns (uint8) {\n require(value <= type(uint8).max, \"SafeCast: value doesn't fit in 8 bits\");\n return uint8(value);\n }\n\n /**\n * @dev Converts a signed int256 into an unsigned uint256.\n *\n * Requirements:\n *\n * - input must be greater than or equal to 0.\n */\n function toUint256(int256 value) internal pure returns (uint256) {\n require(value >= 0, \"SafeCast: value must be positive\");\n return uint256(value);\n }\n\n /**\n * @dev Returns the downcasted int128 from int256, reverting on\n * overflow (when the input is less than smallest int128 or\n * greater than largest int128).\n *\n * Counterpart to Solidity's `int128` operator.\n *\n * Requirements:\n *\n * - input must fit into 128 bits\n *\n * _Available since v3.1._\n */\n function toInt128(int256 value) internal pure returns (int128) {\n require(value >= type(int128).min && value <= type(int128).max, \"SafeCast: value doesn't fit in 128 bits\");\n return int128(value);\n }\n\n /**\n * @dev Returns the downcasted int64 from int256, reverting on\n * overflow (when the input is less than smallest int64 or\n * greater than largest int64).\n *\n * Counterpart to Solidity's `int64` operator.\n *\n * Requirements:\n *\n * - input must fit into 64 bits\n *\n * _Available since v3.1._\n */\n function toInt64(int256 value) internal pure returns (int64) {\n require(value >= type(int64).min && value <= type(int64).max, \"SafeCast: value doesn't fit in 64 bits\");\n return int64(value);\n }\n\n /**\n * @dev Returns the downcasted int32 from int256, reverting on\n * overflow (when the input is less than smallest int32 or\n * greater than largest int32).\n *\n * Counterpart to Solidity's `int32` operator.\n *\n * Requirements:\n *\n * - input must fit into 32 bits\n *\n * _Available since v3.1._\n */\n function toInt32(int256 value) internal pure returns (int32) {\n require(value >= type(int32).min && value <= type(int32).max, \"SafeCast: value doesn't fit in 32 bits\");\n return int32(value);\n }\n\n /**\n * @dev Returns the downcasted int16 from int256, reverting on\n * overflow (when the input is less than smallest int16 or\n * greater than largest int16).\n *\n * Counterpart to Solidity's `int16` operator.\n *\n * Requirements:\n *\n * - input must fit into 16 bits\n *\n * _Available since v3.1._\n */\n function toInt16(int256 value) internal pure returns (int16) {\n require(value >= type(int16).min && value <= type(int16).max, \"SafeCast: value doesn't fit in 16 bits\");\n return int16(value);\n }\n\n /**\n * @dev Returns the downcasted int8 from int256, reverting on\n * overflow (when the input is less than smallest int8 or\n * greater than largest int8).\n *\n * Counterpart to Solidity's `int8` operator.\n *\n * Requirements:\n *\n * - input must fit into 8 bits.\n *\n * _Available since v3.1._\n */\n function toInt8(int256 value) internal pure returns (int8) {\n require(value >= type(int8).min && value <= type(int8).max, \"SafeCast: value doesn't fit in 8 bits\");\n return int8(value);\n }\n\n /**\n * @dev Converts an unsigned uint256 into a signed int256.\n *\n * Requirements:\n *\n * - input must be less than or equal to maxInt256.\n */\n function toInt256(uint256 value) internal pure returns (int256) {\n // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\n require(value <= uint256(type(int256).max), \"SafeCast: value doesn't fit in an int256\");\n return int256(value);\n }\n}\n" + }, + "@openzeppelin/contracts/utils/math/SafeMath.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)\n\npragma solidity ^0.8.0;\n\n// CAUTION\n// This version of SafeMath should only be used with Solidity 0.8 or later,\n// because it relies on the compiler's built in overflow checks.\n\n/**\n * @dev Wrappers over Solidity's arithmetic operations.\n *\n * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler\n * now has built in overflow checking.\n */\nlibrary SafeMath {\n /**\n * @dev Returns the addition of two unsigned integers, with an overflow flag.\n *\n * _Available since v3.4._\n */\n function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n unchecked {\n uint256 c = a + b;\n if (c < a) return (false, 0);\n return (true, c);\n }\n }\n\n /**\n * @dev Returns the substraction of two unsigned integers, with an overflow flag.\n *\n * _Available since v3.4._\n */\n function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n unchecked {\n if (b > a) return (false, 0);\n return (true, a - b);\n }\n }\n\n /**\n * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\n *\n * _Available since v3.4._\n */\n function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n unchecked {\n // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\n // benefit is lost if 'b' is also tested.\n // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\n if (a == 0) return (true, 0);\n uint256 c = a * b;\n if (c / a != b) return (false, 0);\n return (true, c);\n }\n }\n\n /**\n * @dev Returns the division of two unsigned integers, with a division by zero flag.\n *\n * _Available since v3.4._\n */\n function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n unchecked {\n if (b == 0) return (false, 0);\n return (true, a / b);\n }\n }\n\n /**\n * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\n *\n * _Available since v3.4._\n */\n function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\n unchecked {\n if (b == 0) return (false, 0);\n return (true, a % b);\n }\n }\n\n /**\n * @dev Returns the addition of two unsigned integers, reverting on\n * overflow.\n *\n * Counterpart to Solidity's `+` operator.\n *\n * Requirements:\n *\n * - Addition cannot overflow.\n */\n function add(uint256 a, uint256 b) internal pure returns (uint256) {\n return a + b;\n }\n\n /**\n * @dev Returns the subtraction of two unsigned integers, reverting on\n * overflow (when the result is negative).\n *\n * Counterpart to Solidity's `-` operator.\n *\n * Requirements:\n *\n * - Subtraction cannot overflow.\n */\n function sub(uint256 a, uint256 b) internal pure returns (uint256) {\n return a - b;\n }\n\n /**\n * @dev Returns the multiplication of two unsigned integers, reverting on\n * overflow.\n *\n * Counterpart to Solidity's `*` operator.\n *\n * Requirements:\n *\n * - Multiplication cannot overflow.\n */\n function mul(uint256 a, uint256 b) internal pure returns (uint256) {\n return a * b;\n }\n\n /**\n * @dev Returns the integer division of two unsigned integers, reverting on\n * division by zero. The result is rounded towards zero.\n *\n * Counterpart to Solidity's `/` operator.\n *\n * Requirements:\n *\n * - The divisor cannot be zero.\n */\n function div(uint256 a, uint256 b) internal pure returns (uint256) {\n return a / b;\n }\n\n /**\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\n * reverting when dividing by zero.\n *\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\n * opcode (which leaves remaining gas untouched) while Solidity uses an\n * invalid opcode to revert (consuming all remaining gas).\n *\n * Requirements:\n *\n * - The divisor cannot be zero.\n */\n function mod(uint256 a, uint256 b) internal pure returns (uint256) {\n return a % b;\n }\n\n /**\n * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\n * overflow (when the result is negative).\n *\n * CAUTION: This function is deprecated because it requires allocating memory for the error\n * message unnecessarily. For custom revert reasons use {trySub}.\n *\n * Counterpart to Solidity's `-` operator.\n *\n * Requirements:\n *\n * - Subtraction cannot overflow.\n */\n function sub(\n uint256 a,\n uint256 b,\n string memory errorMessage\n ) internal pure returns (uint256) {\n unchecked {\n require(b <= a, errorMessage);\n return a - b;\n }\n }\n\n /**\n * @dev Returns the integer division of two unsigned integers, reverting with custom message on\n * division by zero. The result is rounded towards zero.\n *\n * Counterpart to Solidity's `/` operator. Note: this function uses a\n * `revert` opcode (which leaves remaining gas untouched) while Solidity\n * uses an invalid opcode to revert (consuming all remaining gas).\n *\n * Requirements:\n *\n * - The divisor cannot be zero.\n */\n function div(\n uint256 a,\n uint256 b,\n string memory errorMessage\n ) internal pure returns (uint256) {\n unchecked {\n require(b > 0, errorMessage);\n return a / b;\n }\n }\n\n /**\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\n * reverting with custom message when dividing by zero.\n *\n * CAUTION: This function is deprecated because it requires allocating memory for the error\n * message unnecessarily. For custom revert reasons use {tryMod}.\n *\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\n * opcode (which leaves remaining gas untouched) while Solidity uses an\n * invalid opcode to revert (consuming all remaining gas).\n *\n * Requirements:\n *\n * - The divisor cannot be zero.\n */\n function mod(\n uint256 a,\n uint256 b,\n string memory errorMessage\n ) internal pure returns (uint256) {\n unchecked {\n require(b > 0, errorMessage);\n return a % b;\n }\n }\n}\n" + }, + "@openzeppelin/contracts/utils/Strings.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n bytes16 private constant _HEX_SYMBOLS = \"0123456789abcdef\";\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` decimal representation.\n */\n function toString(uint256 value) internal pure returns (string memory) {\n // Inspired by OraclizeAPI's implementation - MIT licence\n // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol\n\n if (value == 0) {\n return \"0\";\n }\n uint256 temp = value;\n uint256 digits;\n while (temp != 0) {\n digits++;\n temp /= 10;\n }\n bytes memory buffer = new bytes(digits);\n while (value != 0) {\n digits -= 1;\n buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));\n value /= 10;\n }\n return string(buffer);\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.\n */\n function toHexString(uint256 value) internal pure returns (string memory) {\n if (value == 0) {\n return \"0x00\";\n }\n uint256 temp = value;\n uint256 length = 0;\n while (temp != 0) {\n length++;\n temp >>= 8;\n }\n return toHexString(value, length);\n }\n\n /**\n * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.\n */\n function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {\n bytes memory buffer = new bytes(2 * length + 2);\n buffer[0] = \"0\";\n buffer[1] = \"x\";\n for (uint256 i = 2 * length + 1; i > 1; --i) {\n buffer[i] = _HEX_SYMBOLS[value & 0xf];\n value >>= 4;\n }\n require(value == 0, \"Strings: hex length insufficient\");\n return string(buffer);\n }\n}\n" + }, + "@openzeppelin/contracts/utils/structs/EnumerableSet.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/structs/EnumerableSet.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for managing\n * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive\n * types.\n *\n * Sets have the following properties:\n *\n * - Elements are added, removed, and checked for existence in constant time\n * (O(1)).\n * - Elements are enumerated in O(n). No guarantees are made on the ordering.\n *\n * ```\n * contract Example {\n * // Add the library methods\n * using EnumerableSet for EnumerableSet.AddressSet;\n *\n * // Declare a set state variable\n * EnumerableSet.AddressSet private mySet;\n * }\n * ```\n *\n * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)\n * and `uint256` (`UintSet`) are supported.\n */\nlibrary EnumerableSet {\n // To implement this library for multiple types with as little code\n // repetition as possible, we write it in terms of a generic Set type with\n // bytes32 values.\n // The Set implementation uses private functions, and user-facing\n // implementations (such as AddressSet) are just wrappers around the\n // underlying Set.\n // This means that we can only create new EnumerableSets for types that fit\n // in bytes32.\n\n struct Set {\n // Storage of set values\n bytes32[] _values;\n // Position of the value in the `values` array, plus 1 because index 0\n // means a value is not in the set.\n mapping(bytes32 => uint256) _indexes;\n }\n\n /**\n * @dev Add a value to a set. O(1).\n *\n * Returns true if the value was added to the set, that is if it was not\n * already present.\n */\n function _add(Set storage set, bytes32 value) private returns (bool) {\n if (!_contains(set, value)) {\n set._values.push(value);\n // The value is stored at length-1, but we add 1 to all indexes\n // and use 0 as a sentinel value\n set._indexes[value] = set._values.length;\n return true;\n } else {\n return false;\n }\n }\n\n /**\n * @dev Removes a value from a set. O(1).\n *\n * Returns true if the value was removed from the set, that is if it was\n * present.\n */\n function _remove(Set storage set, bytes32 value) private returns (bool) {\n // We read and store the value's index to prevent multiple reads from the same storage slot\n uint256 valueIndex = set._indexes[value];\n\n if (valueIndex != 0) {\n // Equivalent to contains(set, value)\n // To delete an element from the _values array in O(1), we swap the element to delete with the last one in\n // the array, and then remove the last element (sometimes called as 'swap and pop').\n // This modifies the order of the array, as noted in {at}.\n\n uint256 toDeleteIndex = valueIndex - 1;\n uint256 lastIndex = set._values.length - 1;\n\n if (lastIndex != toDeleteIndex) {\n bytes32 lastvalue = set._values[lastIndex];\n\n // Move the last value to the index where the value to delete is\n set._values[toDeleteIndex] = lastvalue;\n // Update the index for the moved value\n set._indexes[lastvalue] = valueIndex; // Replace lastvalue's index to valueIndex\n }\n\n // Delete the slot where the moved value was stored\n set._values.pop();\n\n // Delete the index for the deleted slot\n delete set._indexes[value];\n\n return true;\n } else {\n return false;\n }\n }\n\n /**\n * @dev Returns true if the value is in the set. O(1).\n */\n function _contains(Set storage set, bytes32 value) private view returns (bool) {\n return set._indexes[value] != 0;\n }\n\n /**\n * @dev Returns the number of values on the set. O(1).\n */\n function _length(Set storage set) private view returns (uint256) {\n return set._values.length;\n }\n\n /**\n * @dev Returns the value stored at position `index` in the set. O(1).\n *\n * Note that there are no guarantees on the ordering of values inside the\n * array, and it may change when more values are added or removed.\n *\n * Requirements:\n *\n * - `index` must be strictly less than {length}.\n */\n function _at(Set storage set, uint256 index) private view returns (bytes32) {\n return set._values[index];\n }\n\n /**\n * @dev Return the entire set in an array\n *\n * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed\n * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that\n * this function has an unbounded cost, and using it as part of a state-changing function may render the function\n * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.\n */\n function _values(Set storage set) private view returns (bytes32[] memory) {\n return set._values;\n }\n\n // Bytes32Set\n\n struct Bytes32Set {\n Set _inner;\n }\n\n /**\n * @dev Add a value to a set. O(1).\n *\n * Returns true if the value was added to the set, that is if it was not\n * already present.\n */\n function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {\n return _add(set._inner, value);\n }\n\n /**\n * @dev Removes a value from a set. O(1).\n *\n * Returns true if the value was removed from the set, that is if it was\n * present.\n */\n function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {\n return _remove(set._inner, value);\n }\n\n /**\n * @dev Returns true if the value is in the set. O(1).\n */\n function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {\n return _contains(set._inner, value);\n }\n\n /**\n * @dev Returns the number of values in the set. O(1).\n */\n function length(Bytes32Set storage set) internal view returns (uint256) {\n return _length(set._inner);\n }\n\n /**\n * @dev Returns the value stored at position `index` in the set. O(1).\n *\n * Note that there are no guarantees on the ordering of values inside the\n * array, and it may change when more values are added or removed.\n *\n * Requirements:\n *\n * - `index` must be strictly less than {length}.\n */\n function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {\n return _at(set._inner, index);\n }\n\n /**\n * @dev Return the entire set in an array\n *\n * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed\n * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that\n * this function has an unbounded cost, and using it as part of a state-changing function may render the function\n * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.\n */\n function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {\n return _values(set._inner);\n }\n\n // AddressSet\n\n struct AddressSet {\n Set _inner;\n }\n\n /**\n * @dev Add a value to a set. O(1).\n *\n * Returns true if the value was added to the set, that is if it was not\n * already present.\n */\n function add(AddressSet storage set, address value) internal returns (bool) {\n return _add(set._inner, bytes32(uint256(uint160(value))));\n }\n\n /**\n * @dev Removes a value from a set. O(1).\n *\n * Returns true if the value was removed from the set, that is if it was\n * present.\n */\n function remove(AddressSet storage set, address value) internal returns (bool) {\n return _remove(set._inner, bytes32(uint256(uint160(value))));\n }\n\n /**\n * @dev Returns true if the value is in the set. O(1).\n */\n function contains(AddressSet storage set, address value) internal view returns (bool) {\n return _contains(set._inner, bytes32(uint256(uint160(value))));\n }\n\n /**\n * @dev Returns the number of values in the set. O(1).\n */\n function length(AddressSet storage set) internal view returns (uint256) {\n return _length(set._inner);\n }\n\n /**\n * @dev Returns the value stored at position `index` in the set. O(1).\n *\n * Note that there are no guarantees on the ordering of values inside the\n * array, and it may change when more values are added or removed.\n *\n * Requirements:\n *\n * - `index` must be strictly less than {length}.\n */\n function at(AddressSet storage set, uint256 index) internal view returns (address) {\n return address(uint160(uint256(_at(set._inner, index))));\n }\n\n /**\n * @dev Return the entire set in an array\n *\n * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed\n * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that\n * this function has an unbounded cost, and using it as part of a state-changing function may render the function\n * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.\n */\n function values(AddressSet storage set) internal view returns (address[] memory) {\n bytes32[] memory store = _values(set._inner);\n address[] memory result;\n\n assembly {\n result := store\n }\n\n return result;\n }\n\n // UintSet\n\n struct UintSet {\n Set _inner;\n }\n\n /**\n * @dev Add a value to a set. O(1).\n *\n * Returns true if the value was added to the set, that is if it was not\n * already present.\n */\n function add(UintSet storage set, uint256 value) internal returns (bool) {\n return _add(set._inner, bytes32(value));\n }\n\n /**\n * @dev Removes a value from a set. O(1).\n *\n * Returns true if the value was removed from the set, that is if it was\n * present.\n */\n function remove(UintSet storage set, uint256 value) internal returns (bool) {\n return _remove(set._inner, bytes32(value));\n }\n\n /**\n * @dev Returns true if the value is in the set. O(1).\n */\n function contains(UintSet storage set, uint256 value) internal view returns (bool) {\n return _contains(set._inner, bytes32(value));\n }\n\n /**\n * @dev Returns the number of values on the set. O(1).\n */\n function length(UintSet storage set) internal view returns (uint256) {\n return _length(set._inner);\n }\n\n /**\n * @dev Returns the value stored at position `index` in the set. O(1).\n *\n * Note that there are no guarantees on the ordering of values inside the\n * array, and it may change when more values are added or removed.\n *\n * Requirements:\n *\n * - `index` must be strictly less than {length}.\n */\n function at(UintSet storage set, uint256 index) internal view returns (uint256) {\n return uint256(_at(set._inner, index));\n }\n\n /**\n * @dev Return the entire set in an array\n *\n * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed\n * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that\n * this function has an unbounded cost, and using it as part of a state-changing function may render the function\n * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.\n */\n function values(UintSet storage set) internal view returns (uint256[] memory) {\n bytes32[] memory store = _values(set._inner);\n uint256[] memory result;\n\n assembly {\n result := store\n }\n\n return result;\n }\n}\n" + }, + "contracts/buyback/BaseBuyback.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Strategizable } from \"../governance/Strategizable.sol\";\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ICVXLocker } from \"../interfaces/ICVXLocker.sol\";\nimport { ISwapper } from \"../interfaces/ISwapper.sol\";\n\nimport { Initializable } from \"../utils/Initializable.sol\";\n\nabstract contract BaseBuyback is Initializable, Strategizable {\n using SafeERC20 for IERC20;\n\n event SwapRouterUpdated(address indexed _address);\n\n event RewardsSourceUpdated(address indexed _address);\n event TreasuryManagerUpdated(address indexed _address);\n event CVXShareBpsUpdated(uint256 bps);\n\n // Emitted whenever OUSD/OETH is swapped for OGV/CVX or any other token\n event OTokenBuyback(\n address indexed oToken,\n address indexed swappedFor,\n uint256 swapAmountIn,\n uint256 minExpected\n );\n\n // Address of 1-inch Swap Router\n address public swapRouter;\n\n // slither-disable-next-line constable-states\n address private __deprecated_ousd;\n // slither-disable-next-line constable-states\n address private __deprecated_ogv;\n // slither-disable-next-line constable-states\n address private __deprecated_usdt;\n // slither-disable-next-line constable-states\n address private __deprecated_weth9;\n\n // Address that receives OGV after swaps\n address public rewardsSource;\n\n // Address that receives all other tokens after swaps\n address public treasuryManager;\n\n // slither-disable-next-line constable-states\n uint256 private __deprecated_treasuryBps;\n\n address public immutable oToken;\n address public immutable ogv;\n address public immutable cvx;\n address public immutable cvxLocker;\n\n // Amount of `oToken` balance to use for OGV buyback\n uint256 public balanceForOGV;\n\n // Amount of `oToken` balance to use for CVX buyback\n uint256 public balanceForCVX;\n\n // Percentage of `oToken` balance to be used for CVX\n uint256 public cvxShareBps; // 10000 = 100%\n\n constructor(\n address _oToken,\n address _ogv,\n address _cvx,\n address _cvxLocker\n ) {\n // Make sure nobody owns the implementation contract\n _setGovernor(address(0));\n\n oToken = _oToken;\n ogv = _ogv;\n cvx = _cvx;\n cvxLocker = _cvxLocker;\n }\n\n /**\n * @param _swapRouter Address of Uniswap V3 Router\n * @param _strategistAddr Address of Strategist multi-sig wallet\n * @param _treasuryManagerAddr Address that receives the treasury's share of OUSD\n * @param _rewardsSource Address of RewardsSource contract\n * @param _cvxShareBps Percentage of balance to use for CVX\n */\n function initialize(\n address _swapRouter,\n address _strategistAddr,\n address _treasuryManagerAddr,\n address _rewardsSource,\n uint256 _cvxShareBps\n ) external onlyGovernor initializer {\n _setStrategistAddr(_strategistAddr);\n\n _setSwapRouter(_swapRouter);\n _setRewardsSource(_rewardsSource);\n\n _setTreasuryManager(_treasuryManagerAddr);\n\n _setCVXShareBps(_cvxShareBps);\n }\n\n /**\n * @dev Set address of Uniswap Universal Router for performing liquidation\n * of platform fee tokens. Setting to 0x0 will pause swaps.\n *\n * @param _router Address of the Uniswap Universal router\n */\n function setSwapRouter(address _router) external onlyGovernor {\n _setSwapRouter(_router);\n }\n\n function _setSwapRouter(address _router) internal {\n address oldRouter = swapRouter;\n swapRouter = _router;\n\n if (oldRouter != address(0)) {\n // Remove allowance of old router, if any\n\n if (IERC20(ogv).allowance(address(this), oldRouter) != 0) {\n // slither-disable-next-line unused-return\n IERC20(ogv).safeApprove(oldRouter, 0);\n }\n\n if (IERC20(cvx).allowance(address(this), oldRouter) != 0) {\n // slither-disable-next-line unused-return\n IERC20(cvx).safeApprove(oldRouter, 0);\n }\n }\n\n emit SwapRouterUpdated(_router);\n }\n\n /**\n * @dev Sets the address that receives the OGV buyback rewards\n * @param _address Address\n */\n function setRewardsSource(address _address) external onlyGovernor {\n _setRewardsSource(_address);\n }\n\n function _setRewardsSource(address _address) internal {\n require(_address != address(0), \"Address not set\");\n rewardsSource = _address;\n emit RewardsSourceUpdated(_address);\n }\n\n /**\n * @dev Sets the address that can receive and manage the funds for Treasury\n * @param _address Address\n */\n function setTreasuryManager(address _address) external onlyGovernor {\n _setTreasuryManager(_address);\n }\n\n function _setTreasuryManager(address _address) internal {\n require(_address != address(0), \"Address not set\");\n treasuryManager = _address;\n emit TreasuryManagerUpdated(_address);\n }\n\n /**\n * @dev Sets the percentage of oToken to use for Flywheel tokens\n * @param _bps BPS, 10000 to 100%\n */\n function setCVXShareBps(uint256 _bps) external onlyGovernor {\n _setCVXShareBps(_bps);\n }\n\n function _setCVXShareBps(uint256 _bps) internal {\n require(_bps <= 10000, \"Invalid bps value\");\n cvxShareBps = _bps;\n emit CVXShareBpsUpdated(_bps);\n }\n\n /**\n * @dev Computes the split of oToken balance that can be\n * used for OGV and CVX buybacks.\n */\n function _updateBuybackSplits()\n internal\n returns (uint256 _balanceForOGV, uint256 _balanceForCVX)\n {\n _balanceForOGV = balanceForOGV;\n _balanceForCVX = balanceForCVX;\n\n uint256 totalBalance = IERC20(oToken).balanceOf(address(this));\n uint256 unsplitBalance = totalBalance - _balanceForOGV - _balanceForCVX;\n\n // Check if all balance is accounted for\n if (unsplitBalance != 0) {\n // If not, split unaccounted balance based on `cvxShareBps`\n uint256 addToCVX = (unsplitBalance * cvxShareBps) / 10000;\n _balanceForCVX = _balanceForCVX + addToCVX;\n _balanceForOGV = _balanceForOGV + unsplitBalance - addToCVX;\n\n // Update storage\n balanceForOGV = _balanceForOGV;\n balanceForCVX = _balanceForCVX;\n }\n }\n\n function updateBuybackSplits() external onlyGovernor {\n // slither-disable-next-line unused-return\n _updateBuybackSplits();\n }\n\n function _swapToken(\n address tokenOut,\n uint256 oTokenAmount,\n uint256 minAmountOut,\n bytes calldata swapData\n ) internal returns (uint256 amountOut) {\n require(oTokenAmount > 0, \"Invalid Swap Amount\");\n require(swapRouter != address(0), \"Swap Router not set\");\n require(minAmountOut > 0, \"Invalid minAmount\");\n\n // Transfer OToken to Swapper for swapping\n // slither-disable-next-line unchecked-transfer unused-return\n IERC20(oToken).transfer(swapRouter, oTokenAmount);\n\n // Swap\n amountOut = ISwapper(swapRouter).swap(\n oToken,\n tokenOut,\n oTokenAmount,\n minAmountOut,\n swapData\n );\n\n require(amountOut >= minAmountOut, \"Higher Slippage\");\n\n emit OTokenBuyback(oToken, tokenOut, minAmountOut, amountOut);\n }\n\n /**\n * @dev Swaps `oTokenAmount` to OGV\n * @param oTokenAmount Amount of OUSD/OETH to swap\n * @param minOGV Minimum OGV to receive for oTokenAmount\n * @param swapData 1inch Swap Data\n */\n function swapForOGV(\n uint256 oTokenAmount,\n uint256 minOGV,\n bytes calldata swapData\n ) external onlyGovernorOrStrategist nonReentrant {\n (uint256 _amountForOGV, ) = _updateBuybackSplits();\n require(_amountForOGV >= oTokenAmount, \"Balance underflow\");\n require(rewardsSource != address(0), \"RewardsSource contract not set\");\n\n unchecked {\n // Subtract the amount to swap from net balance\n balanceForOGV = _amountForOGV - oTokenAmount;\n }\n\n uint256 ogvReceived = _swapToken(ogv, oTokenAmount, minOGV, swapData);\n\n // Transfer OGV received to RewardsSource contract\n // slither-disable-next-line unchecked-transfer unused-return\n IERC20(ogv).transfer(rewardsSource, ogvReceived);\n }\n\n /**\n * @dev Swaps `oTokenAmount` to CVX\n * @param oTokenAmount Amount of OUSD/OETH to swap\n * @param minCVX Minimum CVX to receive for oTokenAmount\n * @param swapData 1inch Swap Data\n */\n function swapForCVX(\n uint256 oTokenAmount,\n uint256 minCVX,\n bytes calldata swapData\n ) external onlyGovernorOrStrategist nonReentrant {\n (, uint256 _amountForCVX) = _updateBuybackSplits();\n require(_amountForCVX >= oTokenAmount, \"Balance underflow\");\n\n unchecked {\n // Subtract the amount to swap from net balance\n balanceForCVX = _amountForCVX - oTokenAmount;\n }\n\n uint256 cvxReceived = _swapToken(cvx, oTokenAmount, minCVX, swapData);\n\n // Lock all CVX\n _lockAllCVX(cvxReceived);\n }\n\n /**\n * @dev Locks all CVX held by the contract on behalf of the Treasury Manager\n */\n function lockAllCVX() external onlyGovernorOrStrategist {\n _lockAllCVX(IERC20(cvx).balanceOf(address(this)));\n }\n\n function _lockAllCVX(uint256 cvxAmount) internal {\n require(\n treasuryManager != address(0),\n \"Treasury manager address not set\"\n );\n\n // Lock all available CVX on behalf of `treasuryManager`\n ICVXLocker(cvxLocker).lock(treasuryManager, cvxAmount, 0);\n }\n\n /**\n * @dev Approve CVX Locker to move CVX held by this contract\n */\n function safeApproveAllTokens() external onlyGovernorOrStrategist {\n IERC20(cvx).safeApprove(cvxLocker, type(uint256).max);\n }\n\n /**\n * @notice Owner function to withdraw a specific amount of a token\n * @param token token to be transferered\n * @param amount amount of the token to be transferred\n */\n function transferToken(address token, uint256 amount)\n external\n onlyGovernor\n nonReentrant\n {\n IERC20(token).safeTransfer(_governor(), amount);\n }\n}\n" + }, + "contracts/buyback/OETHBuyback.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { BaseBuyback } from \"./BaseBuyback.sol\";\n\ncontract OETHBuyback is BaseBuyback {\n constructor(\n address _oToken,\n address _ogv,\n address _cvx,\n address _cvxLocker\n ) BaseBuyback(_oToken, _ogv, _cvx, _cvxLocker) {}\n}\n" + }, + "contracts/buyback/OUSDBuyback.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { BaseBuyback } from \"./BaseBuyback.sol\";\n\ncontract OUSDBuyback is BaseBuyback {\n constructor(\n address _oToken,\n address _ogv,\n address _cvx,\n address _cvxLocker\n ) BaseBuyback(_oToken, _ogv, _cvx, _cvxLocker) {}\n}\n" + }, + "contracts/compensation/CompensationClaims.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\n\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\n\n/**\n * @title Compensation Claims\n * @author Origin Protocol Inc\n * @dev Airdrop for ERC20 tokens.\n *\n * Provides a coin airdrop with a verification period in which everyone\n * can check that all claims are correct before any actual funds are moved\n * to the contract.\n *\n * - Users can claim funds during the claim period.\n *\n * - The adjuster can set the amount of each user's claim,\n * but only when unlocked, and not during the claim period.\n *\n * - The governor can unlock and lock the adjuster, outside the claim period.\n * - The governor can start the claim period, if it's not started.\n * - The governor can collect any remaining funds after the claim period is over.\n *\n * Intended use sequence:\n *\n * 1. Governor unlocks the adjuster\n * 2. Adjuster uploads claims\n * 3. Governor locks the adjuster\n * 4. Everyone verifies that the claim amounts and totals are correct\n * 5. Payout funds are moved to the contract\n * 6. The claim period starts\n * 7. Users claim funds\n * 8. The claim period ends\n * 9. Governor can collect any remaing funds\n *\n */\ncontract CompensationClaims is Governable {\n address public adjuster;\n address public token;\n uint256 public end;\n uint256 public totalClaims;\n mapping(address => uint256) claims;\n bool public isAdjusterLocked;\n\n using SafeMath for uint256;\n\n event Claim(address indexed recipient, uint256 amount);\n event ClaimSet(address indexed recipient, uint256 amount);\n event Start(uint256 end);\n event Lock();\n event Unlock();\n event Collect(address indexed coin, uint256 amount);\n\n constructor(address _token, address _adjuster) onlyGovernor {\n token = _token;\n adjuster = _adjuster;\n isAdjusterLocked = true;\n }\n\n function balanceOf(address _account) external view returns (uint256) {\n return claims[_account];\n }\n\n function decimals() external view returns (uint8) {\n return IERC20Decimals(token).decimals();\n }\n\n /* -- User -- */\n\n function claim(address _recipient) external onlyInClaimPeriod nonReentrant {\n uint256 amount = claims[_recipient];\n require(amount > 0, \"Amount must be greater than 0\");\n claims[_recipient] = 0;\n totalClaims = totalClaims.sub(amount);\n SafeERC20.safeTransfer(IERC20(token), _recipient, amount);\n emit Claim(_recipient, amount);\n }\n\n /* -- Adjustor -- */\n\n function setClaims(\n address[] calldata _addresses,\n uint256[] calldata _amounts\n ) external notInClaimPeriod onlyUnlockedAdjuster {\n require(\n _addresses.length == _amounts.length,\n \"Addresses and amounts must match\"\n );\n uint256 len = _addresses.length;\n for (uint256 i = 0; i < len; i++) {\n address recipient = _addresses[i];\n uint256 newAmount = _amounts[i];\n uint256 oldAmount = claims[recipient];\n claims[recipient] = newAmount;\n totalClaims = totalClaims.add(newAmount).sub(oldAmount);\n emit ClaimSet(recipient, newAmount);\n }\n }\n\n /* -- Governor -- */\n\n function lockAdjuster() external onlyGovernor notInClaimPeriod {\n _lockAdjuster();\n }\n\n function _lockAdjuster() internal {\n isAdjusterLocked = true;\n emit Lock();\n }\n\n function unlockAdjuster() external onlyGovernor notInClaimPeriod {\n isAdjusterLocked = false;\n emit Unlock();\n }\n\n function start(uint256 _seconds)\n external\n onlyGovernor\n notInClaimPeriod\n nonReentrant\n {\n require(totalClaims > 0, \"No claims\");\n uint256 funding = IERC20(token).balanceOf(address(this));\n require(funding >= totalClaims, \"Insufficient funds for all claims\");\n _lockAdjuster();\n end = block.timestamp.add(_seconds);\n require(end.sub(block.timestamp) < 31622400, \"Duration too long\"); // 31622400 = 366*24*60*60\n emit Start(end);\n }\n\n function collect(address _coin)\n external\n onlyGovernor\n notInClaimPeriod\n nonReentrant\n {\n uint256 amount = IERC20(_coin).balanceOf(address(this));\n SafeERC20.safeTransfer(IERC20(_coin), address(governor()), amount);\n emit Collect(_coin, amount);\n }\n\n /* -- modifiers -- */\n\n modifier onlyInClaimPeriod() {\n require(block.timestamp <= end, \"Should be in claim period\");\n _;\n }\n\n modifier notInClaimPeriod() {\n require(block.timestamp > end, \"Should not be in claim period\");\n _;\n }\n\n modifier onlyUnlockedAdjuster() {\n require(isAdjusterLocked == false, \"Adjuster must be unlocked\");\n require(msg.sender == adjuster, \"Must be adjuster\");\n _;\n }\n}\n\ninterface IERC20Decimals {\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/echidna/Debugger.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nlibrary Debugger {\n event Debug(string debugString);\n event Debug(string description, string data);\n event Debug(string prefix, string description, string data);\n event Debug(string description, bytes32 data);\n event Debug(string prefix, string description, bytes32 data);\n event Debug(string description, uint256 data);\n event Debug(string prefix, string description, uint256 data);\n event Debug(string description, int256 data);\n event Debug(string prefix, string description, int256 data);\n event Debug(string description, address data);\n event Debug(string prefix, string description, address data);\n event Debug(string description, bool data);\n event Debug(string prefix, string description, bool data);\n\n function log(string memory debugString) internal {\n emit Debug(debugString);\n }\n\n function log(string memory description, string memory data) internal {\n emit Debug(description, data);\n }\n\n function log(\n string memory prefix,\n string memory description,\n string memory data\n ) internal {\n emit Debug(prefix, description, data);\n }\n\n function log(string memory description, bytes32 data) internal {\n emit Debug(description, data);\n }\n\n function log(\n string memory prefix,\n string memory description,\n bytes32 data\n ) internal {\n emit Debug(prefix, description, data);\n }\n\n function log(string memory description, uint256 data) internal {\n emit Debug(description, data);\n }\n\n function log(\n string memory prefix,\n string memory description,\n uint256 data\n ) internal {\n emit Debug(prefix, description, data);\n }\n\n function log(string memory description, int256 data) internal {\n emit Debug(description, data);\n }\n\n function log(\n string memory prefix,\n string memory description,\n int256 data\n ) internal {\n emit Debug(prefix, description, data);\n }\n\n function log(string memory description, address data) internal {\n emit Debug(description, data);\n }\n\n function log(\n string memory prefix,\n string memory description,\n address data\n ) internal {\n emit Debug(prefix, description, data);\n }\n\n function log(string memory description, bool data) internal {\n emit Debug(description, data);\n }\n\n function log(\n string memory prefix,\n string memory description,\n bool data\n ) internal {\n emit Debug(prefix, description, data);\n }\n}\n" + }, + "contracts/echidna/Echidna.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaTestApproval.sol\";\n\n/**\n * @title Echidna test contract for OUSD\n * @notice Target contract to be tested, containing all mixins\n * @author Rappie\n */\ncontract Echidna is EchidnaTestApproval {\n\n}\n" + }, + "contracts/echidna/EchidnaConfig.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Top-level mixin for configuring the desired fuzzing setup\n * @author Rappie\n */\ncontract EchidnaConfig {\n address internal constant ADDRESS_VAULT = address(0x10000);\n address internal constant ADDRESS_OUTSIDER_USER = address(0x20000);\n\n address internal constant ADDRESS_USER0 = address(0x30000);\n address internal constant ADDRESS_USER1 = address(0x40000);\n\n // Will be set in EchidnaSetup constructor\n address internal ADDRESS_OUTSIDER_CONTRACT;\n address internal ADDRESS_CONTRACT0;\n address internal ADDRESS_CONTRACT1;\n\n // Toggle known issues\n //\n // This can be used to skip tests that are known to fail. This is useful\n // when debugging a specific issue, but should be disabled when running\n // the full test suite.\n //\n // True => skip tests that are known to fail\n // False => run all tests\n //\n bool internal constant TOGGLE_KNOWN_ISSUES = false;\n\n // Toggle known issues within limits\n //\n // Same as TOGGLE_KNOWN_ISSUES, but also skip tests that are known to fail\n // within limits set by the variables below.\n //\n bool internal constant TOGGLE_KNOWN_ISSUES_WITHIN_LIMITS = true;\n\n // Starting balance\n //\n // Gives OUSD a non-zero starting supply, which can be useful to ignore\n // certain edge cases.\n //\n // The starting balance is given to outsider accounts that are not used as\n // accounts while fuzzing.\n //\n bool internal constant TOGGLE_STARTING_BALANCE = true;\n uint256 internal constant STARTING_BALANCE = 1_000_000e18;\n\n // Change supply\n //\n // Set a limit to the amount of change per rebase, which can be useful to\n // ignore certain edge cases.\n //\n // True => limit the amount of change to a percentage of total supply\n // False => no limit\n //\n bool internal constant TOGGLE_CHANGESUPPLY_LIMIT = true;\n uint256 internal constant CHANGESUPPLY_DIVISOR = 10; // 10% of total supply\n\n // Mint limit\n //\n // Set a limit the the amount minted per mint, which can be useful to\n // ignore certain edge cases.\n //\n // True => limit the amount of minted tokens\n // False => no limit\n //\n bool internal constant TOGGLE_MINT_LIMIT = true;\n uint256 internal constant MINT_MODULO = 1_000_000_000_000e18;\n\n // Known rounding errors\n uint256 internal constant TRANSFER_ROUNDING_ERROR = 1e18 - 1;\n uint256 internal constant OPT_IN_ROUNDING_ERROR = 1e18 - 1;\n uint256 internal constant MINT_ROUNDING_ERROR = 1e18 - 1;\n\n /**\n * @notice Modifier to skip tests that are known to fail\n * @dev see TOGGLE_KNOWN_ISSUES for more information\n */\n modifier hasKnownIssue() {\n if (TOGGLE_KNOWN_ISSUES) return;\n _;\n }\n\n /**\n * @notice Modifier to skip tests that are known to fail within limits\n * @dev see TOGGLE_KNOWN_ISSUES_WITHIN_LIMITS for more information\n */\n modifier hasKnownIssueWithinLimits() {\n if (TOGGLE_KNOWN_ISSUES_WITHIN_LIMITS) return;\n _;\n }\n\n /**\n * @notice Translate an account ID to an address\n * @param accountId The ID of the account\n * @return account The address of the account\n */\n function getAccount(uint8 accountId)\n internal\n view\n returns (address account)\n {\n accountId = accountId / 64;\n if (accountId == 0) return account = ADDRESS_USER0;\n if (accountId == 1) return account = ADDRESS_USER1;\n if (accountId == 2) return account = ADDRESS_CONTRACT0;\n if (accountId == 3) return account = ADDRESS_CONTRACT1;\n require(false, \"Unknown account ID\");\n }\n}\n" + }, + "contracts/echidna/EchidnaDebug.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Address } from \"@openzeppelin/contracts/utils/Address.sol\";\n\nimport \"./EchidnaHelper.sol\";\nimport \"./Debugger.sol\";\n\nimport \"../token/OUSD.sol\";\n\n/**\n * @title Room for random debugging functions\n * @author Rappie\n */\ncontract EchidnaDebug is EchidnaHelper {\n function debugOUSD() public pure {\n // assert(ousd.balanceOf(ADDRESS_USER0) == 1000);\n // assert(ousd.rebaseState(ADDRESS_USER0) != OUSD.RebaseOptions.OptIn);\n // assert(Address.isContract(ADDRESS_CONTRACT0));\n // Debugger.log(\"nonRebasingSupply\", ousd.nonRebasingSupply());\n // assert(false);\n }\n}\n" + }, + "contracts/echidna/EchidnaHelper.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaSetup.sol\";\nimport \"./Debugger.sol\";\n\n/**\n * @title Mixin containing helper functions\n * @author Rappie\n */\ncontract EchidnaHelper is EchidnaSetup {\n /**\n * @notice Mint tokens to an account\n * @param toAcc Account to mint to\n * @param amount Amount to mint\n * @return Amount minted (in case of capped mint with modulo)\n */\n function mint(uint8 toAcc, uint256 amount) public returns (uint256) {\n address to = getAccount(toAcc);\n\n if (TOGGLE_MINT_LIMIT) {\n amount = amount % MINT_MODULO;\n }\n\n hevm.prank(ADDRESS_VAULT);\n ousd.mint(to, amount);\n\n return amount;\n }\n\n /**\n * @notice Burn tokens from an account\n * @param fromAcc Account to burn from\n * @param amount Amount to burn\n */\n function burn(uint8 fromAcc, uint256 amount) public {\n address from = getAccount(fromAcc);\n hevm.prank(ADDRESS_VAULT);\n ousd.burn(from, amount);\n }\n\n /**\n * @notice Change the total supply of OUSD (rebase)\n * @param amount New total supply\n */\n function changeSupply(uint256 amount) public {\n if (TOGGLE_CHANGESUPPLY_LIMIT) {\n amount =\n ousd.totalSupply() +\n (amount % (ousd.totalSupply() / CHANGESUPPLY_DIVISOR));\n }\n\n hevm.prank(ADDRESS_VAULT);\n ousd.changeSupply(amount);\n }\n\n /**\n * @notice Transfer tokens between accounts\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function transfer(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n hevm.prank(from);\n // slither-disable-next-line unchecked-transfer\n ousd.transfer(to, amount);\n }\n\n /**\n * @notice Transfer approved tokens between accounts\n * @param authorizedAcc Account that is authorized to transfer\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function transferFrom(\n uint8 authorizedAcc,\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address authorized = getAccount(authorizedAcc);\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n hevm.prank(authorized);\n // slither-disable-next-line unchecked-transfer\n ousd.transferFrom(from, to, amount);\n }\n\n /**\n * @notice Opt in to rebasing\n * @param targetAcc Account to opt in\n */\n function optIn(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n hevm.prank(target);\n ousd.rebaseOptIn();\n }\n\n /**\n * @notice Opt out of rebasing\n * @param targetAcc Account to opt out\n */\n function optOut(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n hevm.prank(target);\n ousd.rebaseOptOut();\n }\n\n /**\n * @notice Approve an account to spend OUSD\n * @param ownerAcc Account that owns the OUSD\n * @param spenderAcc Account that is approved to spend the OUSD\n * @param amount Amount to approve\n */\n function approve(\n uint8 ownerAcc,\n uint8 spenderAcc,\n uint256 amount\n ) public {\n address owner = getAccount(ownerAcc);\n address spender = getAccount(spenderAcc);\n hevm.prank(owner);\n // slither-disable-next-line unused-return\n ousd.approve(spender, amount);\n }\n\n /**\n * @notice Increase the allowance of an account to spend OUSD\n * @param ownerAcc Account that owns the OUSD\n * @param spenderAcc Account that is approved to spend the OUSD\n * @param amount Amount to increase the allowance by\n */\n function increaseAllowance(\n uint8 ownerAcc,\n uint8 spenderAcc,\n uint256 amount\n ) public {\n address owner = getAccount(ownerAcc);\n address spender = getAccount(spenderAcc);\n hevm.prank(owner);\n // slither-disable-next-line unused-return\n ousd.increaseAllowance(spender, amount);\n }\n\n /**\n * @notice Decrease the allowance of an account to spend OUSD\n * @param ownerAcc Account that owns the OUSD\n * @param spenderAcc Account that is approved to spend the OUSD\n * @param amount Amount to decrease the allowance by\n */\n function decreaseAllowance(\n uint8 ownerAcc,\n uint8 spenderAcc,\n uint256 amount\n ) public {\n address owner = getAccount(ownerAcc);\n address spender = getAccount(spenderAcc);\n hevm.prank(owner);\n // slither-disable-next-line unused-return\n ousd.decreaseAllowance(spender, amount);\n }\n\n /**\n * @notice Get the sum of all OUSD balances\n * @return total Total balance\n */\n function getTotalBalance() public view returns (uint256 total) {\n total += ousd.balanceOf(ADDRESS_VAULT);\n total += ousd.balanceOf(ADDRESS_OUTSIDER_USER);\n total += ousd.balanceOf(ADDRESS_OUTSIDER_CONTRACT);\n total += ousd.balanceOf(ADDRESS_USER0);\n total += ousd.balanceOf(ADDRESS_USER1);\n total += ousd.balanceOf(ADDRESS_CONTRACT0);\n total += ousd.balanceOf(ADDRESS_CONTRACT1);\n }\n\n /**\n * @notice Get the sum of all non-rebasing OUSD balances\n * @return total Total balance\n */\n function getTotalNonRebasingBalance() public returns (uint256 total) {\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_VAULT)\n ? ousd.balanceOf(ADDRESS_VAULT)\n : 0;\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_OUTSIDER_USER)\n ? ousd.balanceOf(ADDRESS_OUTSIDER_USER)\n : 0;\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_OUTSIDER_CONTRACT)\n ? ousd.balanceOf(ADDRESS_OUTSIDER_CONTRACT)\n : 0;\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_USER0)\n ? ousd.balanceOf(ADDRESS_USER0)\n : 0;\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_USER1)\n ? ousd.balanceOf(ADDRESS_USER1)\n : 0;\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_CONTRACT0)\n ? ousd.balanceOf(ADDRESS_CONTRACT0)\n : 0;\n total += ousd._isNonRebasingAccountEchidna(ADDRESS_CONTRACT1)\n ? ousd.balanceOf(ADDRESS_CONTRACT1)\n : 0;\n }\n}\n" + }, + "contracts/echidna/EchidnaSetup.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./IHevm.sol\";\nimport \"./EchidnaConfig.sol\";\nimport \"./OUSDEchidna.sol\";\n\ncontract Dummy {}\n\n/**\n * @title Mixin for setup and deployment\n * @author Rappie\n */\ncontract EchidnaSetup is EchidnaConfig {\n IHevm hevm = IHevm(0x7109709ECfa91a80626fF3989D68f67F5b1DD12D);\n OUSDEchidna ousd = new OUSDEchidna();\n\n /**\n * @notice Deploy the OUSD contract and set up initial state\n */\n constructor() {\n ousd.initialize(\"Origin Dollar\", \"OUSD\", ADDRESS_VAULT, 1e18);\n\n // Deploy dummny contracts as users\n Dummy outsider = new Dummy();\n ADDRESS_OUTSIDER_CONTRACT = address(outsider);\n Dummy dummy0 = new Dummy();\n ADDRESS_CONTRACT0 = address(dummy0);\n Dummy dummy1 = new Dummy();\n ADDRESS_CONTRACT1 = address(dummy1);\n\n // Start out with a reasonable amount of OUSD\n if (TOGGLE_STARTING_BALANCE) {\n // Rebasing tokens\n hevm.prank(ADDRESS_VAULT);\n ousd.mint(ADDRESS_OUTSIDER_USER, STARTING_BALANCE / 2);\n\n // Non-rebasing tokens\n hevm.prank(ADDRESS_VAULT);\n ousd.mint(ADDRESS_OUTSIDER_CONTRACT, STARTING_BALANCE / 2);\n }\n }\n}\n" + }, + "contracts/echidna/EchidnaTestAccounting.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaDebug.sol\";\nimport \"./EchidnaTestSupply.sol\";\n\n/**\n * @title Mixin for testing accounting functions\n * @author Rappie\n */\ncontract EchidnaTestAccounting is EchidnaTestSupply {\n /**\n * @notice After opting in, balance should not increase. (Ok to lose rounding funds doing this)\n * @param targetAcc Account to opt in\n */\n function testOptInBalance(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n optIn(targetAcc);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n assert(balanceAfter <= balanceBefore);\n }\n\n /**\n * @notice After opting out, balance should remain the same\n * @param targetAcc Account to opt out\n */\n function testOptOutBalance(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n optOut(targetAcc);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n assert(balanceAfter == balanceBefore);\n }\n\n /**\n * @notice Account balance should remain the same after opting in minus rounding error\n * @param targetAcc Account to opt in\n */\n function testOptInBalanceRounding(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n optIn(targetAcc);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n int256 delta = int256(balanceAfter) - int256(balanceBefore);\n Debugger.log(\"delta\", delta);\n\n // slither-disable-next-line tautology\n assert(-1 * delta >= 0);\n assert(-1 * delta <= int256(OPT_IN_ROUNDING_ERROR));\n }\n\n /**\n * @notice After opting in, total supply should remain the same\n * @param targetAcc Account to opt in\n */\n function testOptInTotalSupply(uint8 targetAcc) public {\n uint256 totalSupplyBefore = ousd.totalSupply();\n optIn(targetAcc);\n uint256 totalSupplyAfter = ousd.totalSupply();\n\n assert(totalSupplyAfter == totalSupplyBefore);\n }\n\n /**\n * @notice After opting out, total supply should remain the same\n * @param targetAcc Account to opt out\n */\n function testOptOutTotalSupply(uint8 targetAcc) public {\n uint256 totalSupplyBefore = ousd.totalSupply();\n optOut(targetAcc);\n uint256 totalSupplyAfter = ousd.totalSupply();\n\n assert(totalSupplyAfter == totalSupplyBefore);\n }\n\n /**\n * @notice Account balance should remain the same when a smart contract auto converts\n * @param targetAcc Account to auto convert\n */\n function testAutoConvertBalance(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n // slither-disable-next-line unused-return\n ousd._isNonRebasingAccountEchidna(target);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n assert(balanceAfter == balanceBefore);\n }\n\n /**\n * @notice The `balanceOf` function should never revert\n * @param targetAcc Account to check balance of\n */\n function testBalanceOfShouldNotRevert(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n // slither-disable-next-line unused-return\n try ousd.balanceOf(target) {\n assert(true);\n } catch {\n assert(false);\n }\n }\n}\n" + }, + "contracts/echidna/EchidnaTestApproval.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaTestMintBurn.sol\";\nimport \"./Debugger.sol\";\n\n/**\n * @title Mixin for testing approval related functions\n * @author Rappie\n */\ncontract EchidnaTestApproval is EchidnaTestMintBurn {\n /**\n * @notice Performing `transferFrom` with an amount inside the allowance should not revert\n * @param authorizedAcc The account that is authorized to transfer\n * @param fromAcc The account that is transferring\n * @param toAcc The account that is receiving\n * @param amount The amount to transfer\n */\n function testTransferFromShouldNotRevert(\n uint8 authorizedAcc,\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address authorized = getAccount(authorizedAcc);\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(amount <= ousd.balanceOf(from));\n require(amount <= ousd.allowance(from, authorized));\n\n hevm.prank(authorized);\n // slither-disable-next-line unchecked-transfer\n try ousd.transferFrom(from, to, amount) {\n // pass\n } catch {\n assert(false);\n }\n }\n\n /**\n * @notice Performing `transferFrom` with an amount outside the allowance should revert\n * @param authorizedAcc The account that is authorized to transfer\n * @param fromAcc The account that is transferring\n * @param toAcc The account that is receiving\n * @param amount The amount to transfer\n */\n function testTransferFromShouldRevert(\n uint8 authorizedAcc,\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address authorized = getAccount(authorizedAcc);\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(amount > 0);\n require(\n !(amount <= ousd.balanceOf(from) &&\n amount <= ousd.allowance(from, authorized))\n );\n\n hevm.prank(authorized);\n // slither-disable-next-line unchecked-transfer\n try ousd.transferFrom(from, to, amount) {\n assert(false);\n } catch {\n // pass\n }\n }\n\n /**\n * @notice Approving an amount should update the allowance and overwrite any previous allowance\n * @param ownerAcc The account that is approving\n * @param spenderAcc The account that is being approved\n * @param amount The amount to approve\n */\n function testApprove(\n uint8 ownerAcc,\n uint8 spenderAcc,\n uint256 amount\n ) public {\n address owner = getAccount(ownerAcc);\n address spender = getAccount(spenderAcc);\n\n approve(ownerAcc, spenderAcc, amount);\n uint256 allowanceAfter1 = ousd.allowance(owner, spender);\n\n assert(allowanceAfter1 == amount);\n\n approve(ownerAcc, spenderAcc, amount / 2);\n uint256 allowanceAfter2 = ousd.allowance(owner, spender);\n\n assert(allowanceAfter2 == amount / 2);\n }\n\n /**\n * @notice Increasing the allowance should raise it by the amount provided\n * @param ownerAcc The account that is approving\n * @param spenderAcc The account that is being approved\n * @param amount The amount to approve\n */\n function testIncreaseAllowance(\n uint8 ownerAcc,\n uint8 spenderAcc,\n uint256 amount\n ) public {\n address owner = getAccount(ownerAcc);\n address spender = getAccount(spenderAcc);\n\n uint256 allowanceBefore = ousd.allowance(owner, spender);\n increaseAllowance(ownerAcc, spenderAcc, amount);\n uint256 allowanceAfter = ousd.allowance(owner, spender);\n\n assert(allowanceAfter == allowanceBefore + amount);\n }\n\n /**\n * @notice Decreasing the allowance should lower it by the amount provided\n * @param ownerAcc The account that is approving\n * @param spenderAcc The account that is being approved\n * @param amount The amount to approve\n */\n function testDecreaseAllowance(\n uint8 ownerAcc,\n uint8 spenderAcc,\n uint256 amount\n ) public {\n address owner = getAccount(ownerAcc);\n address spender = getAccount(spenderAcc);\n\n uint256 allowanceBefore = ousd.allowance(owner, spender);\n decreaseAllowance(ownerAcc, spenderAcc, amount);\n uint256 allowanceAfter = ousd.allowance(owner, spender);\n\n assert(allowanceAfter == allowanceBefore - amount);\n }\n}\n" + }, + "contracts/echidna/EchidnaTestMintBurn.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaDebug.sol\";\nimport \"./EchidnaTestAccounting.sol\";\n\n/**\n * @title Mixin for testing Mint and Burn functions\n * @author Rappie\n */\ncontract EchidnaTestMintBurn is EchidnaTestAccounting {\n /**\n * @notice Minting 0 tokens should not affect account balance\n * @param targetAcc Account to mint to\n */\n function testMintZeroBalance(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n mint(targetAcc, 0);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n assert(balanceAfter == balanceBefore);\n }\n\n /**\n * @notice Burning 0 tokens should not affect account balance\n * @param targetAcc Account to burn from\n */\n function testBurnZeroBalance(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n burn(targetAcc, 0);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n assert(balanceAfter == balanceBefore);\n }\n\n /**\n * @notice Minting tokens must increase the account balance by at least amount\n * @param targetAcc Account to mint to\n * @param amount Amount to mint\n * @custom:error testMintBalance(uint8,uint256): failed!💥\n * Call sequence:\n * changeSupply(1)\n * testMintBalance(0,1)\n * Event sequence:\n * Debug(«balanceBefore», 0)\n * Debug(«balanceAfter», 0)\n */\n function testMintBalance(uint8 targetAcc, uint256 amount)\n public\n hasKnownIssue\n hasKnownIssueWithinLimits\n {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n uint256 amountMinted = mint(targetAcc, amount);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n Debugger.log(\"amountMinted\", amountMinted);\n Debugger.log(\"balanceBefore\", balanceBefore);\n Debugger.log(\"balanceAfter\", balanceAfter);\n\n assert(balanceAfter >= balanceBefore + amountMinted);\n }\n\n /**\n * @notice Burning tokens must decrease the account balance by at least amount\n * @param targetAcc Account to burn from\n * @param amount Amount to burn\n * @custom:error testBurnBalance(uint8,uint256): failed!💥\n * Call sequence:\n * changeSupply(1)\n * mint(0,3)\n * testBurnBalance(0,1)\n * Event sequence:\n * Debug(«balanceBefore», 2)\n * Debug(«balanceAfter», 2)\n */\n function testBurnBalance(uint8 targetAcc, uint256 amount)\n public\n hasKnownIssue\n hasKnownIssueWithinLimits\n {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n burn(targetAcc, amount);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n Debugger.log(\"balanceBefore\", balanceBefore);\n Debugger.log(\"balanceAfter\", balanceAfter);\n\n assert(balanceAfter <= balanceBefore - amount);\n }\n\n /**\n * @notice Minting tokens should not increase the account balance by less than rounding error above amount\n * @param targetAcc Account to mint to\n * @param amount Amount to mint\n */\n function testMintBalanceRounding(uint8 targetAcc, uint256 amount) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n uint256 amountMinted = mint(targetAcc, amount);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n int256 delta = int256(balanceAfter) - int256(balanceBefore);\n\n // delta == amount, if no error\n // delta < amount, if too little is minted\n // delta > amount, if too much is minted\n int256 error = int256(amountMinted) - delta;\n\n assert(error >= 0);\n assert(error <= int256(MINT_ROUNDING_ERROR));\n }\n\n /**\n * @notice A burn of an account balance must result in a zero balance\n * @param targetAcc Account to burn from\n */\n function testBurnAllBalanceToZero(uint8 targetAcc) public hasKnownIssue {\n address target = getAccount(targetAcc);\n\n burn(targetAcc, ousd.balanceOf(target));\n assert(ousd.balanceOf(target) == 0);\n }\n\n /**\n * @notice You should always be able to burn an account's balance\n * @param targetAcc Account to burn from\n */\n function testBurnAllBalanceShouldNotRevert(uint8 targetAcc)\n public\n hasKnownIssue\n {\n address target = getAccount(targetAcc);\n uint256 balance = ousd.balanceOf(target);\n\n hevm.prank(ADDRESS_VAULT);\n try ousd.burn(target, balance) {\n assert(true);\n } catch {\n assert(false);\n }\n }\n}\n" + }, + "contracts/echidna/EchidnaTestSupply.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaDebug.sol\";\nimport \"./EchidnaTestTransfer.sol\";\n\nimport { StableMath } from \"../utils/StableMath.sol\";\n\n/**\n * @title Mixin for testing supply related functions\n * @author Rappie\n */\ncontract EchidnaTestSupply is EchidnaTestTransfer {\n using StableMath for uint256;\n\n uint256 prevRebasingCreditsPerToken = type(uint256).max;\n\n /**\n * @notice After a `changeSupply`, the total supply should exactly\n * match the target total supply. (This is needed to ensure successive\n * rebases are correct).\n * @param supply New total supply\n * @custom:error testChangeSupply(uint256): failed!💥\n * Call sequence:\n * testChangeSupply(1044505275072865171609)\n * Event sequence:\n * TotalSupplyUpdatedHighres(1044505275072865171610, 1000000000000000000000000, 957391048054055578595)\n */\n function testChangeSupply(uint256 supply)\n public\n hasKnownIssue\n hasKnownIssueWithinLimits\n {\n hevm.prank(ADDRESS_VAULT);\n ousd.changeSupply(supply);\n\n assert(ousd.totalSupply() == supply);\n }\n\n /**\n * @notice The total supply must not be less than the sum of account balances.\n * (The difference will go into future rebases)\n * @custom:error testTotalSupplyLessThanTotalBalance(): failed!💥\n * Call sequence:\n * mint(0,1)\n * changeSupply(1)\n * optOut(64)\n * transfer(0,64,1)\n * testTotalSupplyLessThanTotalBalance()\n * Event sequence:\n * Debug(«totalSupply», 1000000000000000001000001)\n * Debug(«totalBalance», 1000000000000000001000002)\n */\n function testTotalSupplyLessThanTotalBalance()\n public\n hasKnownIssue\n hasKnownIssueWithinLimits\n {\n uint256 totalSupply = ousd.totalSupply();\n uint256 totalBalance = getTotalBalance();\n\n Debugger.log(\"totalSupply\", totalSupply);\n Debugger.log(\"totalBalance\", totalBalance);\n\n assert(totalSupply >= totalBalance);\n }\n\n /**\n * @notice Non-rebasing supply should not be larger than total supply\n * @custom:error testNonRebasingSupplyVsTotalSupply(): failed!💥\n * Call sequence:\n * mint(0,2)\n * changeSupply(3)\n * burn(0,1)\n * optOut(0)\n * testNonRebasingSupplyVsTotalSupply()\n */\n function testNonRebasingSupplyVsTotalSupply() public hasKnownIssue {\n uint256 nonRebasingSupply = ousd.nonRebasingSupply();\n uint256 totalSupply = ousd.totalSupply();\n\n assert(nonRebasingSupply <= totalSupply);\n }\n\n /**\n * @notice Global `rebasingCreditsPerToken` should never increase\n * @custom:error testRebasingCreditsPerTokenNotIncreased(): failed!💥\n * Call sequence:\n * testRebasingCreditsPerTokenNotIncreased()\n * changeSupply(1)\n * testRebasingCreditsPerTokenNotIncreased()\n */\n function testRebasingCreditsPerTokenNotIncreased() public hasKnownIssue {\n uint256 curRebasingCreditsPerToken = ousd\n .rebasingCreditsPerTokenHighres();\n\n Debugger.log(\n \"prevRebasingCreditsPerToken\",\n prevRebasingCreditsPerToken\n );\n Debugger.log(\"curRebasingCreditsPerToken\", curRebasingCreditsPerToken);\n\n assert(curRebasingCreditsPerToken <= prevRebasingCreditsPerToken);\n\n prevRebasingCreditsPerToken = curRebasingCreditsPerToken;\n }\n\n /**\n * @notice The rebasing credits per token ratio must greater than zero\n */\n function testRebasingCreditsPerTokenAboveZero() public {\n assert(ousd.rebasingCreditsPerTokenHighres() > 0);\n }\n\n /**\n * @notice The sum of all non-rebasing balances should not be larger than\n * non-rebasing supply\n * @custom:error testTotalNonRebasingSupplyLessThanTotalBalance(): failed!💥\n * Call sequence\n * mint(0,2)\n * changeSupply(1)\n * optOut(0)\n * burn(0,1)\n * testTotalNonRebasingSupplyLessThanTotalBalance()\n * Event sequence:\n * Debug(«totalNonRebasingSupply», 500000000000000000000001)\n * Debug(«totalNonRebasingBalance», 500000000000000000000002)\n */\n function testTotalNonRebasingSupplyLessThanTotalBalance()\n public\n hasKnownIssue\n hasKnownIssueWithinLimits\n {\n uint256 totalNonRebasingSupply = ousd.nonRebasingSupply();\n uint256 totalNonRebasingBalance = getTotalNonRebasingBalance();\n\n Debugger.log(\"totalNonRebasingSupply\", totalNonRebasingSupply);\n Debugger.log(\"totalNonRebasingBalance\", totalNonRebasingBalance);\n\n assert(totalNonRebasingSupply >= totalNonRebasingBalance);\n }\n\n /**\n * @notice An accounts credits / credits per token should not be larger it's balance\n * @param targetAcc The account to check\n */\n function testCreditsPerTokenVsBalance(uint8 targetAcc) public {\n address target = getAccount(targetAcc);\n\n (uint256 credits, uint256 creditsPerToken, ) = ousd\n .creditsBalanceOfHighres(target);\n uint256 expectedBalance = credits.divPrecisely(creditsPerToken);\n\n uint256 balance = ousd.balanceOf(target);\n\n Debugger.log(\"credits\", credits);\n Debugger.log(\"creditsPerToken\", creditsPerToken);\n Debugger.log(\"expectedBalance\", expectedBalance);\n Debugger.log(\"balance\", balance);\n\n assert(expectedBalance == balance);\n }\n}\n" + }, + "contracts/echidna/EchidnaTestTransfer.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./EchidnaDebug.sol\";\nimport \"./Debugger.sol\";\n\n/**\n * @title Mixin for testing transfer related functions\n * @author Rappie\n */\ncontract EchidnaTestTransfer is EchidnaDebug {\n /**\n * @notice The receiving account's balance after a transfer must not increase by\n * less than the amount transferred\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n * @custom:error testTransferBalanceReceivedLess(uint8,uint8,uint256): failed!💥\n * Call sequence:\n * changeSupply(1)\n * mint(64,2)\n * testTransferBalanceReceivedLess(64,0,1)\n * Event sequence:\n * Debug(«totalSupply», 1000000000000000000500002)\n * Debug(«toBalBefore», 0)\n * Debug(«toBalAfter», 0)\n */\n function testTransferBalanceReceivedLess(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public hasKnownIssue hasKnownIssueWithinLimits {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(from != to);\n\n uint256 toBalBefore = ousd.balanceOf(to);\n transfer(fromAcc, toAcc, amount);\n uint256 toBalAfter = ousd.balanceOf(to);\n\n Debugger.log(\"totalSupply\", ousd.totalSupply());\n Debugger.log(\"toBalBefore\", toBalBefore);\n Debugger.log(\"toBalAfter\", toBalAfter);\n\n assert(toBalAfter >= toBalBefore + amount);\n }\n\n /**\n * @notice The receiving account's balance after a transfer must not\n * increase by more than the amount transferred\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function testTransferBalanceReceivedMore(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(from != to);\n\n uint256 toBalBefore = ousd.balanceOf(to);\n transfer(fromAcc, toAcc, amount);\n uint256 toBalAfter = ousd.balanceOf(to);\n\n Debugger.log(\"totalSupply\", ousd.totalSupply());\n Debugger.log(\"toBalBefore\", toBalBefore);\n Debugger.log(\"toBalAfter\", toBalAfter);\n\n assert(toBalAfter <= toBalBefore + amount);\n }\n\n /**\n * @notice The sending account's balance after a transfer must not\n * decrease by less than the amount transferred\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n * @custom:error testTransferBalanceSentLess(uint8,uint8,uint256): failed!💥\n * Call sequence:\n * mint(0,1)\n * changeSupply(1)\n * testTransferBalanceSentLess(0,64,1)\n * Event sequence:\n * Debug(«totalSupply», 1000000000000000000500001)\n * Debug(«fromBalBefore», 1)\n * Debug(«fromBalAfter», 1)\n */\n function testTransferBalanceSentLess(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public hasKnownIssue hasKnownIssueWithinLimits {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(from != to);\n\n uint256 fromBalBefore = ousd.balanceOf(from);\n transfer(fromAcc, toAcc, amount);\n uint256 fromBalAfter = ousd.balanceOf(from);\n\n Debugger.log(\"totalSupply\", ousd.totalSupply());\n Debugger.log(\"fromBalBefore\", fromBalBefore);\n Debugger.log(\"fromBalAfter\", fromBalAfter);\n\n assert(fromBalAfter <= fromBalBefore - amount);\n }\n\n /**\n * @notice The sending account's balance after a transfer must not\n * decrease by more than the amount transferred\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function testTransferBalanceSentMore(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(from != to);\n\n uint256 fromBalBefore = ousd.balanceOf(from);\n transfer(fromAcc, toAcc, amount);\n uint256 fromBalAfter = ousd.balanceOf(from);\n\n Debugger.log(\"totalSupply\", ousd.totalSupply());\n Debugger.log(\"fromBalBefore\", fromBalBefore);\n Debugger.log(\"fromBalAfter\", fromBalAfter);\n\n assert(fromBalAfter >= fromBalBefore - amount);\n }\n\n /**\n * @notice The receiving account's balance after a transfer must not\n * increase by less than the amount transferred (minus rounding error)\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function testTransferBalanceReceivedLessRounding(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(from != to);\n\n uint256 toBalBefore = ousd.balanceOf(to);\n transfer(fromAcc, toAcc, amount);\n uint256 toBalAfter = ousd.balanceOf(to);\n\n int256 toDelta = int256(toBalAfter) - int256(toBalBefore);\n\n // delta == amount, if no error\n // delta < amount, if too little is sent\n // delta > amount, if too much is sent\n int256 error = int256(amount) - toDelta;\n\n Debugger.log(\"totalSupply\", ousd.totalSupply());\n Debugger.log(\"toBalBefore\", toBalBefore);\n Debugger.log(\"toBalAfter\", toBalAfter);\n Debugger.log(\"toDelta\", toDelta);\n Debugger.log(\"error\", error);\n\n assert(error >= 0);\n assert(error <= int256(TRANSFER_ROUNDING_ERROR));\n }\n\n /**\n * @notice The sending account's balance after a transfer must\n * not decrease by less than the amount transferred (minus rounding error)\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function testTransferBalanceSentLessRounding(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(from != to);\n\n uint256 fromBalBefore = ousd.balanceOf(from);\n transfer(fromAcc, toAcc, amount);\n uint256 fromBalAfter = ousd.balanceOf(from);\n\n int256 fromDelta = int256(fromBalAfter) - int256(fromBalBefore);\n\n // delta == -amount, if no error\n // delta < -amount, if too much is sent\n // delta > -amount, if too little is sent\n int256 error = int256(amount) + fromDelta;\n\n Debugger.log(\"totalSupply\", ousd.totalSupply());\n Debugger.log(\"fromBalBefore\", fromBalBefore);\n Debugger.log(\"fromBalAfter\", fromBalAfter);\n Debugger.log(\"fromDelta\", fromDelta);\n Debugger.log(\"error\", error);\n\n assert(error >= 0);\n assert(error <= int256(TRANSFER_ROUNDING_ERROR));\n }\n\n /**\n * @notice An account should always be able to successfully transfer\n * an amount within its balance.\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n * @custom:error testTransferWithinBalanceDoesNotRevert(uint8,uint8,uint8): failed!💥\n * Call sequence:\n * mint(0,1)\n * changeSupply(3)\n * optOut(0)\n * testTransferWithinBalanceDoesNotRevert(0,128,2)\n * optIn(0)\n * testTransferWithinBalanceDoesNotRevert(128,0,1)\n * Event sequence:\n * error Revert Panic(17): SafeMath over-/under-flows\n */\n function testTransferWithinBalanceDoesNotRevert(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public hasKnownIssue {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n require(amount > 0);\n amount = amount % ousd.balanceOf(from);\n\n Debugger.log(\"Total supply\", ousd.totalSupply());\n\n hevm.prank(from);\n // slither-disable-next-line unchecked-transfer\n try ousd.transfer(to, amount) {\n assert(true);\n } catch {\n assert(false);\n }\n }\n\n /**\n * @notice An account should never be able to successfully transfer\n * an amount greater than their balance.\n * @param fromAcc Account to transfer from\n * @param toAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function testTransferExceedingBalanceReverts(\n uint8 fromAcc,\n uint8 toAcc,\n uint256 amount\n ) public {\n address from = getAccount(fromAcc);\n address to = getAccount(toAcc);\n\n amount = ousd.balanceOf(from) + 1 + amount;\n\n hevm.prank(from);\n // slither-disable-next-line unchecked-transfer\n try ousd.transfer(to, amount) {\n assert(false);\n } catch {\n assert(true);\n }\n }\n\n /**\n * @notice A transfer to the same account should not change that account's balance\n * @param targetAcc Account to transfer to\n * @param amount Amount to transfer\n */\n function testTransferSelf(uint8 targetAcc, uint256 amount) public {\n address target = getAccount(targetAcc);\n\n uint256 balanceBefore = ousd.balanceOf(target);\n transfer(targetAcc, targetAcc, amount);\n uint256 balanceAfter = ousd.balanceOf(target);\n\n assert(balanceBefore == balanceAfter);\n }\n\n /**\n * @notice Transfers to the zero account revert\n * @param fromAcc Account to transfer from\n * @param amount Amount to transfer\n */\n function testTransferToZeroAddress(uint8 fromAcc, uint256 amount) public {\n address from = getAccount(fromAcc);\n\n hevm.prank(from);\n // slither-disable-next-line unchecked-transfer\n try ousd.transfer(address(0), amount) {\n assert(false);\n } catch {\n assert(true);\n }\n }\n}\n" + }, + "contracts/echidna/IHevm.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// https://github.com/ethereum/hevm/blob/main/doc/src/controlling-the-unit-testing-environment.md#cheat-codes\n\ninterface IHevm {\n function warp(uint256 x) external;\n\n function roll(uint256 x) external;\n\n function store(\n address c,\n bytes32 loc,\n bytes32 val\n ) external;\n\n function load(address c, bytes32 loc) external returns (bytes32 val);\n\n function sign(uint256 sk, bytes32 digest)\n external\n returns (\n uint8 v,\n bytes32 r,\n bytes32 s\n );\n\n function addr(uint256 sk) external returns (address addr);\n\n function ffi(string[] calldata) external returns (bytes memory);\n\n function prank(address sender) external;\n}\n" + }, + "contracts/echidna/OUSDEchidna.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../token/OUSD.sol\";\n\ncontract OUSDEchidna is OUSD {\n constructor() OUSD() {}\n\n function _isNonRebasingAccountEchidna(address _account)\n public\n returns (bool)\n {\n return _isNonRebasingAccount(_account);\n }\n}\n" + }, + "contracts/flipper/Flipper.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../governance/Governable.sol\";\nimport \"../token/OUSD.sol\";\nimport \"../interfaces/Tether.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\n// Contract to exchange usdt, usdc, dai from and to ousd.\n// - 1 to 1. No slippage\n// - Optimized for low gas usage\n// - No guarantee of availability\n\ncontract Flipper is Governable {\n using SafeERC20 for IERC20;\n\n uint256 constant MAXIMUM_PER_TRADE = (25000 * 1e18);\n\n // Settable coin addresses allow easy testing and use of mock currencies.\n IERC20 immutable dai;\n OUSD immutable ousd;\n IERC20 immutable usdc;\n Tether immutable usdt;\n\n // ---------------------\n // Dev constructor\n // ---------------------\n constructor(\n address _dai,\n address _ousd,\n address _usdc,\n address _usdt\n ) {\n require(address(_dai) != address(0));\n require(address(_ousd) != address(0));\n require(address(_usdc) != address(0));\n require(address(_usdt) != address(0));\n dai = IERC20(_dai);\n ousd = OUSD(_ousd);\n usdc = IERC20(_usdc);\n usdt = Tether(_usdt);\n }\n\n // -----------------\n // Trading functions\n // -----------------\n\n /// @notice Purchase OUSD with Dai\n /// @param amount Amount of OUSD to purchase, in 18 fixed decimals.\n function buyOusdWithDai(uint256 amount) external {\n require(amount <= MAXIMUM_PER_TRADE, \"Amount too large\");\n require(\n dai.transferFrom(msg.sender, address(this), amount),\n \"DAI transfer failed\"\n );\n require(ousd.transfer(msg.sender, amount), \"OUSD transfer failed\");\n }\n\n /// @notice Sell OUSD for Dai\n /// @param amount Amount of OUSD to sell, in 18 fixed decimals.\n function sellOusdForDai(uint256 amount) external {\n require(amount <= MAXIMUM_PER_TRADE, \"Amount too large\");\n require(dai.transfer(msg.sender, amount), \"DAI transfer failed\");\n require(\n ousd.transferFrom(msg.sender, address(this), amount),\n \"OUSD transfer failed\"\n );\n }\n\n /// @notice Purchase OUSD with USDC\n /// @param amount Amount of OUSD to purchase, in 18 fixed decimals.\n function buyOusdWithUsdc(uint256 amount) external {\n require(amount <= MAXIMUM_PER_TRADE, \"Amount too large\");\n // Potential rounding error is an intentional trade off\n require(\n usdc.transferFrom(msg.sender, address(this), amount / 1e12),\n \"USDC transfer failed\"\n );\n require(ousd.transfer(msg.sender, amount), \"OUSD transfer failed\");\n }\n\n /// @notice Sell OUSD for USDC\n /// @param amount Amount of OUSD to sell, in 18 fixed decimals.\n function sellOusdForUsdc(uint256 amount) external {\n require(amount <= MAXIMUM_PER_TRADE, \"Amount too large\");\n require(\n usdc.transfer(msg.sender, amount / 1e12),\n \"USDC transfer failed\"\n );\n require(\n ousd.transferFrom(msg.sender, address(this), amount),\n \"OUSD transfer failed\"\n );\n }\n\n /// @notice Purchase OUSD with USDT\n /// @param amount Amount of OUSD to purchase, in 18 fixed decimals.\n function buyOusdWithUsdt(uint256 amount) external {\n require(amount <= MAXIMUM_PER_TRADE, \"Amount too large\");\n // Potential rounding error is an intentional trade off\n // USDT does not return a boolean and reverts,\n // so no need for a require.\n usdt.transferFrom(msg.sender, address(this), amount / 1e12);\n require(ousd.transfer(msg.sender, amount), \"OUSD transfer failed\");\n }\n\n /// @notice Sell OUSD for USDT\n /// @param amount Amount of OUSD to sell, in 18 fixed decimals.\n function sellOusdForUsdt(uint256 amount) external {\n require(amount <= MAXIMUM_PER_TRADE, \"Amount too large\");\n // USDT does not return a boolean and reverts,\n // so no need for a require.\n usdt.transfer(msg.sender, amount / 1e12);\n require(\n ousd.transferFrom(msg.sender, address(this), amount),\n \"OUSD transfer failed\"\n );\n }\n\n // --------------------\n // Governance functions\n // --------------------\n\n /// @dev Opting into yield reduces the gas cost per transfer by about 4K, since\n /// ousd needs to do less accounting and one less storage write.\n function rebaseOptIn() external onlyGovernor nonReentrant {\n ousd.rebaseOptIn();\n }\n\n /// @notice Owner function to withdraw a specific amount of a token\n function withdraw(address token, uint256 amount)\n external\n onlyGovernor\n nonReentrant\n {\n IERC20(token).safeTransfer(_governor(), amount);\n }\n\n /// @notice Owner function to withdraw all tradable tokens\n /// @dev Contract will not perform any swaps until liquidity is provided\n /// again by transferring assets to the contract.\n function withdrawAll() external onlyGovernor nonReentrant {\n IERC20(dai).safeTransfer(_governor(), dai.balanceOf(address(this)));\n IERC20(ousd).safeTransfer(_governor(), ousd.balanceOf(address(this)));\n IERC20(address(usdt)).safeTransfer(\n _governor(),\n usdt.balanceOf(address(this))\n );\n IERC20(usdc).safeTransfer(_governor(), usdc.balanceOf(address(this)));\n }\n}\n" + }, + "contracts/governance/Governable.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\n * from owner to governor and renounce methods removed. Does not use\n * Context.sol like Ownable.sol does for simplification.\n * @author Origin Protocol Inc\n */\ncontract Governable {\n // Storage position of the owner and pendingOwner of the contract\n // keccak256(\"OUSD.governor\");\n bytes32 private constant governorPosition =\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\n\n // keccak256(\"OUSD.pending.governor\");\n bytes32 private constant pendingGovernorPosition =\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\n\n // keccak256(\"OUSD.reentry.status\");\n bytes32 private constant reentryStatusPosition =\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\n\n // See OpenZeppelin ReentrancyGuard implementation\n uint256 constant _NOT_ENTERED = 1;\n uint256 constant _ENTERED = 2;\n\n event PendingGovernorshipTransfer(\n address indexed previousGovernor,\n address indexed newGovernor\n );\n\n event GovernorshipTransferred(\n address indexed previousGovernor,\n address indexed newGovernor\n );\n\n /**\n * @dev Initializes the contract setting the deployer as the initial Governor.\n */\n constructor() {\n _setGovernor(msg.sender);\n emit GovernorshipTransferred(address(0), _governor());\n }\n\n /**\n * @notice Returns the address of the current Governor.\n */\n function governor() public view returns (address) {\n return _governor();\n }\n\n /**\n * @dev Returns the address of the current Governor.\n */\n function _governor() internal view returns (address governorOut) {\n bytes32 position = governorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n governorOut := sload(position)\n }\n }\n\n /**\n * @dev Returns the address of the pending Governor.\n */\n function _pendingGovernor()\n internal\n view\n returns (address pendingGovernor)\n {\n bytes32 position = pendingGovernorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n pendingGovernor := sload(position)\n }\n }\n\n /**\n * @dev Throws if called by any account other than the Governor.\n */\n modifier onlyGovernor() {\n require(isGovernor(), \"Caller is not the Governor\");\n _;\n }\n\n /**\n * @notice Returns true if the caller is the current Governor.\n */\n function isGovernor() public view returns (bool) {\n return msg.sender == _governor();\n }\n\n function _setGovernor(address newGovernor) internal {\n bytes32 position = governorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, newGovernor)\n }\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a `nonReentrant` function from another `nonReentrant`\n * function is not supported. It is possible to prevent this from happening\n * by making the `nonReentrant` function external, and make it call a\n * `private` function that does the actual work.\n */\n modifier nonReentrant() {\n bytes32 position = reentryStatusPosition;\n uint256 _reentry_status;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n _reentry_status := sload(position)\n }\n\n // On the first call to nonReentrant, _notEntered will be true\n require(_reentry_status != _ENTERED, \"Reentrant call\");\n\n // Any calls to nonReentrant after this point will fail\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, _ENTERED)\n }\n\n _;\n\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, _NOT_ENTERED)\n }\n }\n\n function _setPendingGovernor(address newGovernor) internal {\n bytes32 position = pendingGovernorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, newGovernor)\n }\n }\n\n /**\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\n * Can only be called by the current Governor. Must be claimed for this to complete\n * @param _newGovernor Address of the new Governor\n */\n function transferGovernance(address _newGovernor) external onlyGovernor {\n _setPendingGovernor(_newGovernor);\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\n }\n\n /**\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\n * Can only be called by the new Governor.\n */\n function claimGovernance() external {\n require(\n msg.sender == _pendingGovernor(),\n \"Only the pending Governor can complete the claim\"\n );\n _changeGovernor(msg.sender);\n }\n\n /**\n * @dev Change Governance of the contract to a new account (`newGovernor`).\n * @param _newGovernor Address of the new Governor\n */\n function _changeGovernor(address _newGovernor) internal {\n require(_newGovernor != address(0), \"New Governor is address(0)\");\n emit GovernorshipTransferred(_governor(), _newGovernor);\n _setGovernor(_newGovernor);\n }\n}\n" + }, + "contracts/governance/Governor.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./../timelock/Timelock.sol\";\n\n// Modeled off of Compound's Governor Alpha\n// https://github.com/compound-finance/compound-protocol/blob/master/contracts/Governance/GovernorAlpha.sol\ncontract Governor is Timelock {\n // @notice The total number of proposals\n uint256 public proposalCount;\n\n struct Proposal {\n // @notice Unique id for looking up a proposal\n uint256 id;\n // @notice Creator of the proposal\n address proposer;\n // @notice The timestamp that the proposal will be available for\n // execution, set once the vote succeeds\n uint256 eta;\n // @notice the ordered list of target addresses for calls to be made\n address[] targets;\n // @notice The ordered list of function signatures to be called\n string[] signatures;\n // @notice The ordered list of calldata to be passed to each call\n bytes[] calldatas;\n // @notice Flag marking whether the proposal has been executed\n bool executed;\n }\n\n // @notice The official record of all proposals ever proposed\n mapping(uint256 => Proposal) public proposals;\n\n // @notice An event emitted when a new proposal is created\n event ProposalCreated(\n uint256 id,\n address proposer,\n address[] targets,\n string[] signatures,\n bytes[] calldatas,\n string description\n );\n\n // @notice An event emitted when a proposal has been queued in the Timelock\n event ProposalQueued(uint256 id, uint256 eta);\n\n // @notice An event emitted when a proposal has been executed in the Timelock\n event ProposalExecuted(uint256 id);\n\n // @notice An event emitted when a proposal has been cancelled\n event ProposalCancelled(uint256 id);\n\n uint256 public constant MAX_OPERATIONS = 32;\n\n // @notice Possible states that a proposal may be in\n enum ProposalState {\n Pending,\n Queued,\n Expired,\n Executed\n }\n\n constructor(address admin_, uint256 delay_) Timelock(admin_, delay_) {}\n\n /**\n * @notice Propose Governance call(s)\n * @param targets Ordered list of targeted addresses\n * @param signatures Orderd list of function signatures to be called\n * @param calldatas Orderded list of calldata to be passed with each call\n * @param description Description of the governance\n * @return uint256 id of the proposal\n */\n function propose(\n address[] memory targets,\n string[] memory signatures,\n bytes[] memory calldatas,\n string memory description\n ) public returns (uint256) {\n // Allow anyone to propose for now, since only admin can queue the\n // transaction it should be harmless, you just need to pay the gas\n require(\n targets.length == signatures.length &&\n targets.length == calldatas.length,\n \"Governor::propose: proposal function information arity mismatch\"\n );\n require(targets.length != 0, \"Governor::propose: must provide actions\");\n require(\n targets.length <= MAX_OPERATIONS,\n \"Governor::propose: too many actions\"\n );\n\n proposalCount++;\n Proposal memory newProposal = Proposal({\n id: proposalCount,\n proposer: msg.sender,\n eta: 0,\n targets: targets,\n signatures: signatures,\n calldatas: calldatas,\n executed: false\n });\n\n proposals[newProposal.id] = newProposal;\n\n emit ProposalCreated(\n newProposal.id,\n msg.sender,\n targets,\n signatures,\n calldatas,\n description\n );\n return newProposal.id;\n }\n\n /**\n * @notice Queue a proposal for execution\n * @param proposalId id of the proposal to queue\n */\n function queue(uint256 proposalId) public onlyAdmin {\n require(\n state(proposalId) == ProposalState.Pending,\n \"Governor::queue: proposal can only be queued if it is pending\"\n );\n Proposal storage proposal = proposals[proposalId];\n proposal.eta = block.timestamp + delay;\n\n for (uint256 i = 0; i < proposal.targets.length; i++) {\n _queueOrRevert(\n proposal.targets[i],\n proposal.signatures[i],\n proposal.calldatas[i],\n proposal.eta\n );\n }\n\n emit ProposalQueued(proposal.id, proposal.eta);\n }\n\n /**\n * @notice Get the state of a proposal\n * @param proposalId id of the proposal\n * @return ProposalState\n */\n function state(uint256 proposalId) public view returns (ProposalState) {\n require(\n proposalCount >= proposalId && proposalId > 0,\n \"Governor::state: invalid proposal id\"\n );\n Proposal storage proposal = proposals[proposalId];\n if (proposal.executed) {\n return ProposalState.Executed;\n } else if (proposal.eta == 0) {\n return ProposalState.Pending;\n } else if (block.timestamp >= proposal.eta + GRACE_PERIOD) {\n return ProposalState.Expired;\n } else {\n return ProposalState.Queued;\n }\n }\n\n function _queueOrRevert(\n address target,\n string memory signature,\n bytes memory data,\n uint256 eta\n ) internal {\n require(\n !queuedTransactions[\n keccak256(abi.encode(target, signature, keccak256(data), eta))\n ],\n \"Governor::_queueOrRevert: proposal action already queued at eta\"\n );\n require(\n queuedTransactions[queueTransaction(target, signature, data, eta)],\n \"Governor::_queueOrRevert: failed to queue transaction\"\n );\n }\n\n /**\n * @notice Execute a proposal.\n * @param proposalId id of the proposal\n */\n function execute(uint256 proposalId) public {\n require(\n state(proposalId) == ProposalState.Queued,\n \"Governor::execute: proposal can only be executed if it is queued\"\n );\n Proposal storage proposal = proposals[proposalId];\n proposal.executed = true;\n for (uint256 i = 0; i < proposal.targets.length; i++) {\n executeTransaction(\n proposal.targets[i],\n proposal.signatures[i],\n proposal.calldatas[i],\n proposal.eta\n );\n }\n emit ProposalExecuted(proposalId);\n }\n\n /**\n * @notice Cancel a proposal.\n * @param proposalId id of the proposal\n */\n function cancel(uint256 proposalId) public onlyAdmin {\n ProposalState proposalState = state(proposalId);\n\n require(\n proposalState == ProposalState.Queued ||\n proposalState == ProposalState.Pending,\n \"Governor::execute: proposal can only be cancelled if it is queued or pending\"\n );\n Proposal storage proposal = proposals[proposalId];\n proposal.eta = 1; // To mark the proposal as `Expired`\n for (uint256 i = 0; i < proposal.targets.length; i++) {\n cancelTransaction(\n proposal.targets[i],\n proposal.signatures[i],\n proposal.calldatas[i],\n proposal.eta\n );\n }\n emit ProposalCancelled(proposalId);\n }\n\n /**\n * @notice Get the actions that a proposal will take.\n * @param proposalId id of the proposal\n */\n function getActions(uint256 proposalId)\n public\n view\n returns (\n address[] memory targets,\n string[] memory signatures,\n bytes[] memory calldatas\n )\n {\n Proposal storage p = proposals[proposalId];\n return (p.targets, p.signatures, p.calldatas);\n }\n}\n" + }, + "contracts/governance/InitializableGovernable.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD InitializableGovernable Contract\n * @author Origin Protocol Inc\n */\nimport { Initializable } from \"../utils/Initializable.sol\";\n\nimport { Governable } from \"./Governable.sol\";\n\ncontract InitializableGovernable is Governable, Initializable {\n function _initialize(address _newGovernor) internal {\n _changeGovernor(_newGovernor);\n }\n}\n" + }, + "contracts/governance/Strategizable.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Governable } from \"./Governable.sol\";\n\ncontract Strategizable is Governable {\n event StrategistUpdated(address _address);\n\n // Address of strategist\n address public strategistAddr;\n\n // For future use\n uint256[50] private __gap;\n\n /**\n * @dev Verifies that the caller is either Governor or Strategist.\n */\n modifier onlyGovernorOrStrategist() {\n require(\n msg.sender == strategistAddr || isGovernor(),\n \"Caller is not the Strategist or Governor\"\n );\n _;\n }\n\n /**\n * @dev Set address of Strategist\n * @param _address Address of Strategist\n */\n function setStrategistAddr(address _address) external onlyGovernor {\n _setStrategistAddr(_address);\n }\n\n /**\n * @dev Set address of Strategist\n * @param _address Address of Strategist\n */\n function _setStrategistAddr(address _address) internal {\n strategistAddr = _address;\n emit StrategistUpdated(_address);\n }\n}\n" + }, + "contracts/harvest/BaseHarvester.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\nimport \"@openzeppelin/contracts/utils/math/Math.sol\";\n\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { IStrategy } from \"../interfaces/IStrategy.sol\";\nimport { IUniswapV2Router } from \"../interfaces/uniswap/IUniswapV2Router02.sol\";\nimport { IUniswapV3Router } from \"../interfaces/uniswap/IUniswapV3Router.sol\";\nimport { IBalancerVault } from \"../interfaces/balancer/IBalancerVault.sol\";\nimport { ICurvePool } from \"../strategies/ICurvePool.sol\";\nimport \"../utils/Helpers.sol\";\n\nabstract contract BaseHarvester is Governable {\n using SafeERC20 for IERC20;\n using SafeMath for uint256;\n using StableMath for uint256;\n\n enum SwapPlatform {\n UniswapV2Compatible,\n UniswapV3,\n Balancer,\n Curve\n }\n\n event SupportedStrategyUpdate(address strategyAddress, bool isSupported);\n event RewardTokenConfigUpdated(\n address tokenAddress,\n uint16 allowedSlippageBps,\n uint16 harvestRewardBps,\n SwapPlatform swapPlatform,\n address swapPlatformAddr,\n bytes swapData,\n uint256 liquidationLimit,\n bool doSwapRewardToken\n );\n event RewardTokenSwapped(\n address indexed rewardToken,\n address indexed swappedInto,\n SwapPlatform swapPlatform,\n uint256 amountIn,\n uint256 amountOut\n );\n event RewardProceedsTransferred(\n address indexed token,\n address farmer,\n uint256 protcolYield,\n uint256 farmerFee\n );\n event RewardProceedsAddressChanged(address newProceedsAddress);\n\n error EmptyAddress();\n error InvalidSlippageBps();\n error InvalidHarvestRewardBps();\n\n error InvalidSwapPlatform(SwapPlatform swapPlatform);\n\n error InvalidUniswapV2PathLength();\n error InvalidTokenInSwapPath(address token);\n error EmptyBalancerPoolId();\n error InvalidCurvePoolAssetIndex(address token);\n\n error UnsupportedStrategy(address strategyAddress);\n\n error SlippageError(uint256 actualBalance, uint256 minExpected);\n error BalanceMismatchAfterSwap(uint256 actualBalance, uint256 minExpected);\n\n // Configuration properties for harvesting logic of reward tokens\n struct RewardTokenConfig {\n // Max allowed slippage when swapping reward token for a stablecoin denominated in basis points.\n uint16 allowedSlippageBps;\n // Reward when calling a harvest function denominated in basis points.\n uint16 harvestRewardBps;\n // Address of compatible exchange protocol (Uniswap V2/V3, SushiSwap, Balancer and Curve).\n address swapPlatformAddr;\n /* When true the reward token is being swapped. In a need of (temporarily) disabling the swapping of\n * a reward token this needs to be set to false.\n */\n bool doSwapRewardToken;\n // Platform to use for Swapping\n SwapPlatform swapPlatform;\n /* How much token can be sold per one harvest call. If the balance of rewards tokens\n * exceeds that limit multiple harvest calls are required to harvest all of the tokens.\n * Set it to MAX_INT to effectively disable the limit.\n */\n uint256 liquidationLimit;\n }\n\n mapping(address => RewardTokenConfig) public rewardTokenConfigs;\n mapping(address => bool) public supportedStrategies;\n\n address public immutable vaultAddress;\n\n /**\n * Address receiving rewards proceeds. Initially the Vault contract later will possibly\n * be replaced by another contract that eases out rewards distribution.\n **/\n address public rewardProceedsAddress;\n\n /**\n * All tokens are swapped to this token before it gets transferred\n * to the `rewardProceedsAddress`. USDT for OUSD and WETH for OETH.\n **/\n address public immutable baseTokenAddress;\n // Cached decimals for `baseTokenAddress`\n uint256 public immutable baseTokenDecimals;\n\n // Uniswap V2 path for reward tokens using Uniswap V2 Router\n mapping(address => address[]) public uniswapV2Path;\n // Uniswap V3 path for reward tokens using Uniswap V3 Router\n mapping(address => bytes) public uniswapV3Path;\n // Pool ID to use for reward tokens on Balancer\n mapping(address => bytes32) public balancerPoolId;\n\n struct CurvePoolIndices {\n // Casted into uint128 and stored in a struct to save gas\n uint128 rewardTokenIndex;\n uint128 baseTokenIndex;\n }\n // Packed indices of assets on the Curve pool\n mapping(address => CurvePoolIndices) public curvePoolIndices;\n\n constructor(address _vaultAddress, address _baseTokenAddress) {\n require(_vaultAddress != address(0));\n require(_baseTokenAddress != address(0));\n\n vaultAddress = _vaultAddress;\n baseTokenAddress = _baseTokenAddress;\n\n // Cache decimals as well\n baseTokenDecimals = Helpers.getDecimals(_baseTokenAddress);\n }\n\n /***************************************\n Configuration\n ****************************************/\n\n /**\n * Set the Address receiving rewards proceeds.\n * @param _rewardProceedsAddress Address of the reward token\n */\n function setRewardProceedsAddress(address _rewardProceedsAddress)\n external\n onlyGovernor\n {\n if (_rewardProceedsAddress == address(0)) {\n revert EmptyAddress();\n }\n\n rewardProceedsAddress = _rewardProceedsAddress;\n emit RewardProceedsAddressChanged(_rewardProceedsAddress);\n }\n\n /**\n * @dev Add/update a reward token configuration that holds harvesting config variables\n * @param _tokenAddress Address of the reward token\n * @param tokenConfig.allowedSlippageBps uint16 maximum allowed slippage denominated in basis points.\n * Example: 300 == 3% slippage\n * @param tokenConfig.harvestRewardBps uint16 amount of reward tokens the caller of the function is rewarded.\n * Example: 100 == 1%\n * @param tokenConfig.swapPlatformAddr Address Address of a UniswapV2 compatible contract to perform\n * the exchange from reward tokens to stablecoin (currently hard-coded to USDT)\n * @param tokenConfig.liquidationLimit uint256 Maximum amount of token to be sold per one swap function call.\n * When value is 0 there is no limit.\n * @param tokenConfig.doSwapRewardToken bool Disables swapping of the token when set to true,\n * does not cause it to revert though.\n * @param tokenConfig.swapPlatform SwapPlatform to use for Swapping\n * @param swapData Additional data required for swapping\n */\n function setRewardTokenConfig(\n address _tokenAddress,\n RewardTokenConfig calldata tokenConfig,\n bytes calldata swapData\n ) external onlyGovernor {\n if (tokenConfig.allowedSlippageBps > 1000) {\n revert InvalidSlippageBps();\n }\n\n if (tokenConfig.harvestRewardBps > 1000) {\n revert InvalidHarvestRewardBps();\n }\n\n address newRouterAddress = tokenConfig.swapPlatformAddr;\n if (newRouterAddress == address(0)) {\n // Swap router address should be non zero address\n revert EmptyAddress();\n }\n\n address oldRouterAddress = rewardTokenConfigs[_tokenAddress]\n .swapPlatformAddr;\n rewardTokenConfigs[_tokenAddress] = tokenConfig;\n\n // Revert if feed does not exist\n // slither-disable-next-line unused-return\n IOracle(IVault(vaultAddress).priceProvider()).price(_tokenAddress);\n\n IERC20 token = IERC20(_tokenAddress);\n // if changing token swap provider cancel existing allowance\n if (\n /* oldRouterAddress == address(0) when there is no pre-existing\n * configuration for said rewards token\n */\n oldRouterAddress != address(0) &&\n oldRouterAddress != newRouterAddress\n ) {\n token.safeApprove(oldRouterAddress, 0);\n }\n\n // Give SwapRouter infinite approval when needed\n if (oldRouterAddress != newRouterAddress) {\n token.safeApprove(newRouterAddress, 0);\n token.safeApprove(newRouterAddress, type(uint256).max);\n }\n\n SwapPlatform _platform = tokenConfig.swapPlatform;\n if (_platform == SwapPlatform.UniswapV2Compatible) {\n uniswapV2Path[_tokenAddress] = _decodeUniswapV2Path(\n swapData,\n _tokenAddress\n );\n } else if (_platform == SwapPlatform.UniswapV3) {\n uniswapV3Path[_tokenAddress] = _decodeUniswapV3Path(\n swapData,\n _tokenAddress\n );\n } else if (_platform == SwapPlatform.Balancer) {\n balancerPoolId[_tokenAddress] = _decodeBalancerPoolId(\n swapData,\n newRouterAddress,\n _tokenAddress\n );\n } else if (_platform == SwapPlatform.Curve) {\n curvePoolIndices[_tokenAddress] = _decodeCurvePoolIndices(\n swapData,\n newRouterAddress,\n _tokenAddress\n );\n } else {\n // Note: This code is unreachable since Solidity reverts when\n // the value is outside the range of defined values of the enum\n // (even if it's under the max length of the base type)\n revert InvalidSwapPlatform(_platform);\n }\n\n emit RewardTokenConfigUpdated(\n _tokenAddress,\n tokenConfig.allowedSlippageBps,\n tokenConfig.harvestRewardBps,\n _platform,\n newRouterAddress,\n swapData,\n tokenConfig.liquidationLimit,\n tokenConfig.doSwapRewardToken\n );\n }\n\n /**\n * @dev Decodes the data passed into Uniswap V2 path and validates\n * it to make sure the path is for `token` to `baseToken`\n *\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\n * @param token The address of the reward token\n * @return path The validated Uniswap V2 path\n */\n function _decodeUniswapV2Path(bytes calldata data, address token)\n internal\n view\n returns (address[] memory path)\n {\n (path) = abi.decode(data, (address[]));\n uint256 len = path.length;\n\n if (len < 2) {\n // Path should have at least two tokens\n revert InvalidUniswapV2PathLength();\n }\n\n // Do some validation\n if (path[0] != token) {\n revert InvalidTokenInSwapPath(path[0]);\n }\n\n if (path[len - 1] != baseTokenAddress) {\n revert InvalidTokenInSwapPath(path[len - 1]);\n }\n }\n\n /**\n * @dev Decodes the data passed into Uniswap V3 path and validates\n * it to make sure the path is for `token` to `baseToken`\n *\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\n * @param token The address of the reward token\n * @return path The validated Uniswap V3 path\n */\n function _decodeUniswapV3Path(bytes calldata data, address token)\n internal\n view\n returns (bytes calldata path)\n {\n path = data;\n\n address decodedAddress = address(uint160(bytes20(data[0:20])));\n\n if (decodedAddress != token) {\n // Invalid Reward Token in swap path\n revert InvalidTokenInSwapPath(decodedAddress);\n }\n\n decodedAddress = address(uint160(bytes20(data[path.length - 20:])));\n if (decodedAddress != baseTokenAddress) {\n // Invalid Base Token in swap path\n revert InvalidTokenInSwapPath(decodedAddress);\n }\n }\n\n /**\n * @dev Decodes the data passed to Balancer Pool ID\n *\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\n * @return poolId The pool ID\n */\n function _decodeBalancerPoolId(\n bytes calldata data,\n address balancerVault,\n address token\n ) internal view returns (bytes32 poolId) {\n (poolId) = abi.decode(data, (bytes32));\n\n if (poolId == bytes32(0)) {\n revert EmptyBalancerPoolId();\n }\n\n IBalancerVault bVault = IBalancerVault(balancerVault);\n\n // Note: this reverts if token is not a pool asset\n // slither-disable-next-line unused-return\n bVault.getPoolTokenInfo(poolId, token);\n\n // slither-disable-next-line unused-return\n bVault.getPoolTokenInfo(poolId, baseTokenAddress);\n }\n\n /**\n * @dev Decodes the data passed to get the pool indices and\n * checks it against the Curve Pool to make sure it's\n * not misconfigured. The indices are packed into a single\n * uint256 for gas savings\n *\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\n * @param poolAddress Curve pool address\n * @param token The address of the reward token\n * @return indices Packed pool asset indices\n */\n function _decodeCurvePoolIndices(\n bytes calldata data,\n address poolAddress,\n address token\n ) internal view returns (CurvePoolIndices memory indices) {\n indices = abi.decode(data, (CurvePoolIndices));\n\n ICurvePool pool = ICurvePool(poolAddress);\n if (token != pool.coins(indices.rewardTokenIndex)) {\n revert InvalidCurvePoolAssetIndex(token);\n }\n if (baseTokenAddress != pool.coins(indices.baseTokenIndex)) {\n revert InvalidCurvePoolAssetIndex(baseTokenAddress);\n }\n }\n\n /**\n * @dev Flags a strategy as supported or not supported one\n * @param _strategyAddress Address of the strategy\n * @param _isSupported Bool marking strategy as supported or not supported\n */\n function setSupportedStrategy(address _strategyAddress, bool _isSupported)\n external\n onlyGovernor\n {\n supportedStrategies[_strategyAddress] = _isSupported;\n emit SupportedStrategyUpdate(_strategyAddress, _isSupported);\n }\n\n /***************************************\n Rewards\n ****************************************/\n\n /**\n * @dev Transfer token to governor. Intended for recovering tokens stuck in\n * contract, i.e. mistaken sends.\n * @param _asset Address for the asset\n * @param _amount Amount of the asset to transfer\n */\n function transferToken(address _asset, uint256 _amount)\n external\n onlyGovernor\n {\n IERC20(_asset).safeTransfer(governor(), _amount);\n }\n\n /**\n * @dev Collect reward tokens from a specific strategy and swap them for\n * base token on the configured swap platform. Can be called by anyone.\n * Rewards incentivizing the caller are sent to the caller of this function.\n * @param _strategyAddr Address of the strategy to collect rewards from\n */\n function harvestAndSwap(address _strategyAddr) external nonReentrant {\n // Remember _harvest function checks for the validity of _strategyAddr\n _harvestAndSwap(_strategyAddr, msg.sender);\n }\n\n /**\n * @dev Collect reward tokens from a specific strategy and swap them for\n * base token on the configured swap platform. Can be called by anyone\n * @param _strategyAddr Address of the strategy to collect rewards from\n * @param _rewardTo Address where to send a share of harvest rewards to as an incentive\n * for executing this function\n */\n function harvestAndSwap(address _strategyAddr, address _rewardTo)\n external\n nonReentrant\n {\n // Remember _harvest function checks for the validity of _strategyAddr\n _harvestAndSwap(_strategyAddr, _rewardTo);\n }\n\n /**\n * @dev Collect reward tokens from a specific strategy and swap them for\n * base token on the configured swap platform\n * @param _strategyAddr Address of the strategy to collect rewards from\n * @param _rewardTo Address where to send a share of harvest rewards to as an incentive\n * for executing this function\n */\n function _harvestAndSwap(address _strategyAddr, address _rewardTo)\n internal\n {\n _harvest(_strategyAddr);\n IStrategy strategy = IStrategy(_strategyAddr);\n address[] memory rewardTokens = strategy.getRewardTokenAddresses();\n IOracle priceProvider = IOracle(IVault(vaultAddress).priceProvider());\n uint256 len = rewardTokens.length;\n for (uint256 i = 0; i < len; ++i) {\n _swap(rewardTokens[i], _rewardTo, priceProvider);\n }\n }\n\n /**\n * @dev Collect reward tokens from a specific strategy and swap them for\n * base token on the configured swap platform\n * @param _strategyAddr Address of the strategy to collect rewards from.\n */\n function _harvest(address _strategyAddr) internal {\n if (!supportedStrategies[_strategyAddr]) {\n revert UnsupportedStrategy(_strategyAddr);\n }\n\n IStrategy strategy = IStrategy(_strategyAddr);\n strategy.collectRewardTokens();\n }\n\n /**\n * @dev Swap a reward token for the base token on the configured\n * swap platform. The token must have a registered price feed\n * with the price provider\n * @param _swapToken Address of the token to swap\n * @param _rewardTo Address where to send the share of harvest rewards to\n * @param _priceProvider Oracle to get prices of the swap token\n */\n function _swap(\n address _swapToken,\n address _rewardTo,\n IOracle _priceProvider\n ) internal virtual {\n uint256 balance = IERC20(_swapToken).balanceOf(address(this));\n\n // No need to swap if the reward token is the base token. eg USDT or WETH.\n // There is also no limit on the transfer. Everything in the harvester will be transferred\n // to the Dripper regardless of the liquidationLimit config.\n if (_swapToken == baseTokenAddress) {\n IERC20(_swapToken).safeTransfer(rewardProceedsAddress, balance);\n // currently not paying the farmer any rewards as there is no swap\n emit RewardProceedsTransferred(\n baseTokenAddress,\n address(0),\n balance,\n 0\n );\n return;\n }\n\n RewardTokenConfig memory tokenConfig = rewardTokenConfigs[_swapToken];\n\n /* This will trigger a return when reward token configuration has not yet been set\n * or we have temporarily disabled swapping of specific reward token via setting\n * doSwapRewardToken to false.\n */\n if (!tokenConfig.doSwapRewardToken) {\n return;\n }\n\n if (balance == 0) {\n return;\n }\n\n if (tokenConfig.liquidationLimit > 0) {\n balance = Math.min(balance, tokenConfig.liquidationLimit);\n }\n\n // This'll revert if there is no price feed\n uint256 oraclePrice = _priceProvider.price(_swapToken);\n\n // Oracle price is 1e18\n uint256 minExpected = (balance *\n (1e4 - tokenConfig.allowedSlippageBps) * // max allowed slippage\n oraclePrice).scaleBy(\n baseTokenDecimals,\n Helpers.getDecimals(_swapToken)\n ) /\n 1e4 / // fix the max slippage decimal position\n 1e18; // and oracle price decimals position\n\n // Do the swap\n uint256 amountReceived = _doSwap(\n tokenConfig.swapPlatform,\n tokenConfig.swapPlatformAddr,\n _swapToken,\n balance,\n minExpected\n );\n\n if (amountReceived < minExpected) {\n revert SlippageError(amountReceived, minExpected);\n }\n\n emit RewardTokenSwapped(\n _swapToken,\n baseTokenAddress,\n tokenConfig.swapPlatform,\n balance,\n amountReceived\n );\n\n IERC20 baseToken = IERC20(baseTokenAddress);\n uint256 baseTokenBalance = baseToken.balanceOf(address(this));\n if (baseTokenBalance < amountReceived) {\n // Note: It's possible to bypass this check by transfering `baseToken`\n // directly to Harvester before calling the `harvestAndSwap`. However,\n // there's no incentive for an attacker to do that. Doing a balance diff\n // will increase the gas cost significantly\n revert BalanceMismatchAfterSwap(baseTokenBalance, amountReceived);\n }\n\n // Farmer only gets fee from the base amount they helped farm,\n // They do not get anything from anything that already was there\n // on the Harvester\n uint256 farmerFee = amountReceived.mulTruncateScale(\n tokenConfig.harvestRewardBps,\n 1e4\n );\n uint256 protocolYield = baseTokenBalance - farmerFee;\n\n baseToken.safeTransfer(rewardProceedsAddress, protocolYield);\n baseToken.safeTransfer(_rewardTo, farmerFee);\n emit RewardProceedsTransferred(\n baseTokenAddress,\n _rewardTo,\n protocolYield,\n farmerFee\n );\n }\n\n function _doSwap(\n SwapPlatform swapPlatform,\n address routerAddress,\n address rewardTokenAddress,\n uint256 amountIn,\n uint256 minAmountOut\n ) internal returns (uint256 amountOut) {\n if (swapPlatform == SwapPlatform.UniswapV2Compatible) {\n return\n _swapWithUniswapV2(\n routerAddress,\n rewardTokenAddress,\n amountIn,\n minAmountOut\n );\n } else if (swapPlatform == SwapPlatform.UniswapV3) {\n return\n _swapWithUniswapV3(\n routerAddress,\n rewardTokenAddress,\n amountIn,\n minAmountOut\n );\n } else if (swapPlatform == SwapPlatform.Balancer) {\n return\n _swapWithBalancer(\n routerAddress,\n rewardTokenAddress,\n amountIn,\n minAmountOut\n );\n } else if (swapPlatform == SwapPlatform.Curve) {\n return\n _swapWithCurve(\n routerAddress,\n rewardTokenAddress,\n amountIn,\n minAmountOut\n );\n } else {\n // Should never be invoked since we catch invalid values\n // in the `setRewardTokenConfig` function before it's set\n revert InvalidSwapPlatform(swapPlatform);\n }\n }\n\n /**\n * @dev Swaps the token to `baseToken` with Uniswap V2\n *\n * @param routerAddress Uniswap V2 Router address\n * @param swapToken Address of the tokenIn\n * @param amountIn Amount of `swapToken` to swap\n * @param minAmountOut Minimum expected amount of `baseToken`\n *\n * @return amountOut Amount of `baseToken` received after the swap\n */\n function _swapWithUniswapV2(\n address routerAddress,\n address swapToken,\n uint256 amountIn,\n uint256 minAmountOut\n ) internal returns (uint256 amountOut) {\n address[] memory path = uniswapV2Path[swapToken];\n\n uint256[] memory amounts = IUniswapV2Router(routerAddress)\n .swapExactTokensForTokens(\n amountIn,\n minAmountOut,\n path,\n address(this),\n block.timestamp\n );\n\n amountOut = amounts[amounts.length - 1];\n }\n\n /**\n * @dev Swaps the token to `baseToken` with Uniswap V3\n *\n * @param routerAddress Uniswap V3 Router address\n * @param swapToken Address of the tokenIn\n * @param amountIn Amount of `swapToken` to swap\n * @param minAmountOut Minimum expected amount of `baseToken`\n *\n * @return amountOut Amount of `baseToken` received after the swap\n */\n function _swapWithUniswapV3(\n address routerAddress,\n address swapToken,\n uint256 amountIn,\n uint256 minAmountOut\n ) internal returns (uint256 amountOut) {\n bytes memory path = uniswapV3Path[swapToken];\n\n IUniswapV3Router.ExactInputParams memory params = IUniswapV3Router\n .ExactInputParams({\n path: path,\n recipient: address(this),\n deadline: block.timestamp,\n amountIn: amountIn,\n amountOutMinimum: minAmountOut\n });\n amountOut = IUniswapV3Router(routerAddress).exactInput(params);\n }\n\n /**\n * @dev Swaps the token to `baseToken` on Balancer\n *\n * @param balancerVaultAddress BalancerVaultAddress\n * @param swapToken Address of the tokenIn\n * @param amountIn Amount of `swapToken` to swap\n * @param minAmountOut Minimum expected amount of `baseToken`\n *\n * @return amountOut Amount of `baseToken` received after the swap\n */\n function _swapWithBalancer(\n address balancerVaultAddress,\n address swapToken,\n uint256 amountIn,\n uint256 minAmountOut\n ) internal returns (uint256 amountOut) {\n bytes32 poolId = balancerPoolId[swapToken];\n\n IBalancerVault.SingleSwap memory singleSwap = IBalancerVault\n .SingleSwap({\n poolId: poolId,\n kind: IBalancerVault.SwapKind.GIVEN_IN,\n assetIn: swapToken,\n assetOut: baseTokenAddress,\n amount: amountIn,\n userData: hex\"\"\n });\n\n IBalancerVault.FundManagement memory fundMgmt = IBalancerVault\n .FundManagement({\n sender: address(this),\n fromInternalBalance: false,\n recipient: payable(address(this)),\n toInternalBalance: false\n });\n\n amountOut = IBalancerVault(balancerVaultAddress).swap(\n singleSwap,\n fundMgmt,\n minAmountOut,\n block.timestamp\n );\n }\n\n /**\n * @dev Swaps the token to `baseToken` on Curve\n *\n * @param poolAddress Curve Pool Address\n * @param swapToken Address of the tokenIn\n * @param amountIn Amount of `swapToken` to swap\n * @param minAmountOut Minimum expected amount of `baseToken`\n *\n * @return amountOut Amount of `baseToken` received after the swap\n */\n function _swapWithCurve(\n address poolAddress,\n address swapToken,\n uint256 amountIn,\n uint256 minAmountOut\n ) internal returns (uint256 amountOut) {\n CurvePoolIndices memory indices = curvePoolIndices[swapToken];\n\n // Note: Not all CurvePools return the `amountOut`, make sure\n // to use only pool that do. Otherwise the swap would revert\n // always\n amountOut = ICurvePool(poolAddress).exchange(\n uint256(indices.rewardTokenIndex),\n uint256(indices.baseTokenIndex),\n amountIn,\n minAmountOut\n );\n }\n}\n" + }, + "contracts/harvest/Dripper.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\n\n/**\n * @title OUSD Dripper\n *\n * The dripper contract smooths out the yield from point-in-time yield events\n * and spreads the yield out over a configurable time period. This ensures a\n * continuous per block yield to makes users happy as their next rebase\n * amount is always moving up. Also, this makes historical day to day yields\n * smooth, rather than going from a near zero day, to a large APY day, then\n * back to a near zero day again.\n *\n *\n * Design notes\n * - USDT has a smaller resolution than the number of seconds\n * in a week, which can make per block payouts have a rounding error. However\n * the total effect is not large - cents per day, and this money is\n * not lost, just distributed in the future. While we could use a higher\n * decimal precision for the drip perBlock, we chose simpler code.\n * - By calculating the changing drip rates on collects only, harvests and yield\n * events don't have to call anything on this contract or pay any extra gas.\n * Collect() is already be paying for a single write, since it has to reset\n * the lastCollect time.\n * - By having a collectAndRebase method, and having our external systems call\n * that, the OUSD vault does not need any changes, not even to know the address\n * of the dripper.\n * - A rejected design was to retro-calculate the drip rate on each collect,\n * based on the balance at the time of the collect. While this would have\n * required less state, and would also have made the contract respond more quickly\n * to new income, it would break the predictability that is this contract's entire\n * purpose. If we did this, the amount of fundsAvailable() would make sharp increases\n * when funds were deposited.\n * - When the dripper recalculates the rate, it targets spending the balance over\n * the duration. This means that every time that collect is called, if no\n * new funds have been deposited the duration is being pushed back and the\n * rate decreases. This is expected, and ends up following a smoother but\n * longer curve the more collect() is called without incoming yield.\n *\n */\n\ncontract Dripper is Governable {\n using SafeERC20 for IERC20;\n\n struct Drip {\n uint64 lastCollect; // overflows 262 billion years after the sun dies\n uint192 perBlock; // drip rate per block\n }\n\n address immutable vault; // OUSD vault\n address immutable token; // token to drip out\n uint256 public dripDuration; // in seconds\n Drip public drip; // active drip parameters\n\n constructor(address _vault, address _token) {\n vault = _vault;\n token = _token;\n }\n\n /// @notice How much funds have dripped out already and are currently\n // available to be sent to the vault.\n /// @return The amount that would be sent if a collect was called\n function availableFunds() external view returns (uint256) {\n uint256 balance = IERC20(token).balanceOf(address(this));\n return _availableFunds(balance, drip);\n }\n\n /// @notice Collect all dripped funds and send to vault.\n /// Recalculate new drip rate.\n function collect() external {\n _collect();\n }\n\n /// @notice Collect all dripped funds, send to vault, recalculate new drip\n /// rate, and rebase OUSD.\n function collectAndRebase() external {\n _collect();\n IVault(vault).rebase();\n }\n\n /// @dev Change the drip duration. Governor only.\n /// @param _durationSeconds the number of seconds to drip out the entire\n /// balance over if no collects were called during that time.\n function setDripDuration(uint256 _durationSeconds) external onlyGovernor {\n require(_durationSeconds > 0, \"duration must be non-zero\");\n dripDuration = _durationSeconds;\n _collect(); // duration change take immediate effect\n }\n\n /// @dev Transfer out ERC20 tokens held by the contract. Governor only.\n /// @param _asset ERC20 token address\n /// @param _amount amount to transfer\n function transferToken(address _asset, uint256 _amount)\n external\n onlyGovernor\n {\n IERC20(_asset).safeTransfer(governor(), _amount);\n }\n\n /// @dev Calculate available funds by taking the lower of either the\n /// currently dripped out funds or the balance available.\n /// Uses passed in parameters to calculate with for gas savings.\n /// @param _balance current balance in contract\n /// @param _drip current drip parameters\n function _availableFunds(uint256 _balance, Drip memory _drip)\n internal\n view\n returns (uint256)\n {\n uint256 elapsed = block.timestamp - _drip.lastCollect;\n uint256 allowed = (elapsed * _drip.perBlock);\n return (allowed > _balance) ? _balance : allowed;\n }\n\n /// @dev Sends the currently dripped funds to be vault, and sets\n /// the new drip rate based on the new balance.\n function _collect() internal {\n // Calculate send\n uint256 balance = IERC20(token).balanceOf(address(this));\n uint256 amountToSend = _availableFunds(balance, drip);\n uint256 remaining = balance - amountToSend;\n // Calculate new drip perBlock\n // Gas savings by setting entire struct at one time\n drip = Drip({\n perBlock: uint192(remaining / dripDuration),\n lastCollect: uint64(block.timestamp)\n });\n // Send funds\n IERC20(token).safeTransfer(vault, amountToSend);\n }\n}\n" + }, + "contracts/harvest/Harvester.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { BaseHarvester } from \"./BaseHarvester.sol\";\n\ncontract Harvester is BaseHarvester {\n constructor(address _vault, address _usdtAddress)\n BaseHarvester(_vault, _usdtAddress)\n {}\n}\n" + }, + "contracts/harvest/OETHDripper.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Dripper } from \"./Dripper.sol\";\n\n/**\n * @title OETH Dripper Contract\n * @author Origin Protocol Inc\n */\ncontract OETHDripper is Dripper {\n constructor(address _vault, address _token) Dripper(_vault, _token) {}\n}\n" + }, + "contracts/harvest/OETHHarvester.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { BaseHarvester } from \"./BaseHarvester.sol\";\n\ncontract OETHHarvester is BaseHarvester {\n constructor(address _vault, address _wethAddress)\n BaseHarvester(_vault, _wethAddress)\n {}\n}\n" + }, + "contracts/interfaces/balancer/IBalancerVault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"../../utils/InitializableAbstractStrategy.sol\";\n\ninterface IBalancerVault {\n enum WeightedPoolJoinKind {\n INIT,\n EXACT_TOKENS_IN_FOR_BPT_OUT,\n TOKEN_IN_FOR_EXACT_BPT_OUT,\n ALL_TOKENS_IN_FOR_EXACT_BPT_OUT,\n ADD_TOKEN\n }\n\n enum WeightedPoolExitKind {\n EXACT_BPT_IN_FOR_ONE_TOKEN_OUT,\n EXACT_BPT_IN_FOR_TOKENS_OUT,\n BPT_IN_FOR_EXACT_TOKENS_OUT,\n REMOVE_TOKEN\n }\n\n /**\n * @dev Called by users to join a Pool, which transfers tokens from `sender` into the Pool's balance. This will\n * trigger custom Pool behavior, which will typically grant something in return to `recipient` - often tokenized\n * Pool shares.\n *\n * If the caller is not `sender`, it must be an authorized relayer for them.\n *\n * The `assets` and `maxAmountsIn` arrays must have the same length, and each entry indicates the maximum amount\n * to send for each asset. The amounts to send are decided by the Pool and not the Vault: it just enforces\n * these maximums.\n *\n * If joining a Pool that holds WETH, it is possible to send ETH directly: the Vault will do the wrapping. To enable\n * this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead of the\n * WETH address. Note that it is not possible to combine ETH and WETH in the same join. Any excess ETH will be sent\n * back to the caller (not the sender, which is important for relayers).\n *\n * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when\n * interacting with Pools that register and deregister tokens frequently. If sending ETH however, the array must be\n * sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the final\n * `assets` array might not be sorted. Pools with no registered tokens cannot be joined.\n *\n * If `fromInternalBalance` is true, the caller's Internal Balance will be preferred: ERC20 transfers will only\n * be made for the difference between the requested amount and Internal Balance (if any). Note that ETH cannot be\n * withdrawn from Internal Balance: attempting to do so will trigger a revert.\n *\n * This causes the Vault to call the `IBasePool.onJoinPool` hook on the Pool's contract, where Pools implement\n * their own custom logic. This typically requires additional information from the user (such as the expected number\n * of Pool shares). This can be encoded in the `userData` argument, which is ignored by the Vault and passed\n * directly to the Pool's contract, as is `recipient`.\n *\n * Emits a `PoolBalanceChanged` event.\n */\n function joinPool(\n bytes32 poolId,\n address sender,\n address recipient,\n JoinPoolRequest memory request\n ) external payable;\n\n struct JoinPoolRequest {\n address[] assets;\n uint256[] maxAmountsIn;\n bytes userData;\n bool fromInternalBalance;\n }\n\n /**\n * @dev Called by users to exit a Pool, which transfers tokens from the Pool's balance to `recipient`. This will\n * trigger custom Pool behavior, which will typically ask for something in return from `sender` - often tokenized\n * Pool shares. The amount of tokens that can be withdrawn is limited by the Pool's `cash` balance (see\n * `getPoolTokenInfo`).\n *\n * If the caller is not `sender`, it must be an authorized relayer for them.\n *\n * The `tokens` and `minAmountsOut` arrays must have the same length, and each entry in these indicates the minimum\n * token amount to receive for each token contract. The amounts to send are decided by the Pool and not the Vault:\n * it just enforces these minimums.\n *\n * If exiting a Pool that holds WETH, it is possible to receive ETH directly: the Vault will do the unwrapping. To\n * enable this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead\n * of the WETH address. Note that it is not possible to combine ETH and WETH in the same exit.\n *\n * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when\n * interacting with Pools that register and deregister tokens frequently. If receiving ETH however, the array must\n * be sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the\n * final `assets` array might not be sorted. Pools with no registered tokens cannot be exited.\n *\n * If `toInternalBalance` is true, the tokens will be deposited to `recipient`'s Internal Balance. Otherwise,\n * an ERC20 transfer will be performed. Note that ETH cannot be deposited to Internal Balance: attempting to\n * do so will trigger a revert.\n *\n * `minAmountsOut` is the minimum amount of tokens the user expects to get out of the Pool, for each token in the\n * `tokens` array. This array must match the Pool's registered tokens.\n *\n * This causes the Vault to call the `IBasePool.onExitPool` hook on the Pool's contract, where Pools implement\n * their own custom logic. This typically requires additional information from the user (such as the expected number\n * of Pool shares to return). This can be encoded in the `userData` argument, which is ignored by the Vault and\n * passed directly to the Pool's contract.\n *\n * Emits a `PoolBalanceChanged` event.\n */\n function exitPool(\n bytes32 poolId,\n address sender,\n address payable recipient,\n ExitPoolRequest memory request\n ) external;\n\n struct ExitPoolRequest {\n address[] assets;\n uint256[] minAmountsOut;\n bytes userData;\n bool toInternalBalance;\n }\n\n /**\n * @dev Returns a Pool's registered tokens, the total balance for each, and the latest block when *any* of\n * the tokens' `balances` changed.\n *\n * The order of the `tokens` array is the same order that will be used in `joinPool`, `exitPool`, as well as in all\n * Pool hooks (where applicable). Calls to `registerTokens` and `deregisterTokens` may change this order.\n *\n * If a Pool only registers tokens once, and these are sorted in ascending order, they will be stored in the same\n * order as passed to `registerTokens`.\n *\n * Total balances include both tokens held by the Vault and those withdrawn by the Pool's Asset Managers. These are\n * the amounts used by joins, exits and swaps. For a detailed breakdown of token balances, use `getPoolTokenInfo`\n * instead.\n */\n function getPoolTokens(bytes32 poolId)\n external\n view\n returns (\n IERC20[] memory tokens,\n uint256[] memory balances,\n uint256 lastChangeBlock\n );\n\n /**\n * @dev Performs a set of user balance operations, which involve Internal Balance (deposit, withdraw or transfer)\n * and plain ERC20 transfers using the Vault's allowance. This last feature is particularly useful for relayers, as\n * it lets integrators reuse a user's Vault allowance.\n *\n * For each operation, if the caller is not `sender`, it must be an authorized relayer for them.\n */\n function manageUserBalance(UserBalanceOp[] memory ops) external payable;\n\n struct UserBalanceOp {\n UserBalanceOpKind kind;\n address asset;\n uint256 amount;\n address sender;\n address payable recipient;\n }\n\n enum UserBalanceOpKind {\n DEPOSIT_INTERNAL,\n WITHDRAW_INTERNAL,\n TRANSFER_INTERNAL,\n TRANSFER_EXTERNAL\n }\n\n enum SwapKind {\n GIVEN_IN,\n GIVEN_OUT\n }\n\n struct SingleSwap {\n bytes32 poolId;\n SwapKind kind;\n address assetIn;\n address assetOut;\n uint256 amount;\n bytes userData;\n }\n\n struct FundManagement {\n address sender;\n bool fromInternalBalance;\n address payable recipient;\n bool toInternalBalance;\n }\n\n function swap(\n SingleSwap calldata singleSwap,\n FundManagement calldata funds,\n uint256 limit,\n uint256 deadline\n ) external returns (uint256 amountCalculated);\n\n function getPoolTokenInfo(bytes32 poolId, address token)\n external\n view\n returns (\n uint256 cash,\n uint256 managed,\n uint256 lastChangeBlock,\n address assetManager\n );\n}\n" + }, + "contracts/interfaces/balancer/IMetaStablePool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IRateProvider } from \"./IRateProvider.sol\";\n\ninterface IMetaStablePool {\n function getRateProviders()\n external\n view\n returns (IRateProvider[] memory providers);\n}\n" + }, + "contracts/interfaces/balancer/IOracleWeightedPool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// The three values that can be queried:\n//\n// - PAIR_PRICE: the price of the tokens in the Pool, expressed as the price of the second token in units of the\n// first token. For example, if token A is worth $2, and token B is worth $4, the pair price will be 2.0.\n// Note that the price is computed *including* the tokens decimals. This means that the pair price of a Pool with\n// DAI and USDC will be close to 1.0, despite DAI having 18 decimals and USDC 6.\n//\n// - BPT_PRICE: the price of the Pool share token (BPT), in units of the first token.\n// Note that the price is computed *including* the tokens decimals. This means that the BPT price of a Pool with\n// USDC in which BPT is worth $5 will be 5.0, despite the BPT having 18 decimals and USDC 6.\n//\n// - INVARIANT: the value of the Pool's invariant, which serves as a measure of its liquidity.\nenum Variable {\n PAIR_PRICE,\n BPT_PRICE,\n INVARIANT\n}\n\n/**\n * @dev Information for a Time Weighted Average query.\n *\n * Each query computes the average over a window of duration `secs` seconds that ended `ago` seconds ago. For\n * example, the average over the past 30 minutes is computed by settings secs to 1800 and ago to 0. If secs is 1800\n * and ago is 1800 as well, the average between 60 and 30 minutes ago is computed instead.\n */\nstruct OracleAverageQuery {\n Variable variable;\n uint256 secs;\n uint256 ago;\n}\n\ninterface IOracleWeightedPool {\n /**\n * @dev Returns the time average weighted price corresponding to each of `queries`. Prices are represented as 18\n * decimal fixed point values.\n */\n function getTimeWeightedAverage(OracleAverageQuery[] memory queries)\n external\n view\n returns (uint256[] memory results);\n}\n" + }, + "contracts/interfaces/balancer/IRateProvider.sol": { + "content": "// SPDX-License-Identifier: GPL-3.0-or-later\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU General Public License as published by\n// the Free Software Foundation, either version 3 of the License, or\n// (at your option) any later version.\n\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n// GNU General Public License for more details.\n\n// You should have received a copy of the GNU General Public License\n// along with this program. If not, see .\n\npragma solidity ^0.8.0;\n\ninterface IRateProvider {\n function getRate() external view returns (uint256);\n}\n" + }, + "contracts/interfaces/chainlink/AggregatorV3Interface.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface AggregatorV3Interface {\n function decimals() external view returns (uint8);\n\n function description() external view returns (string memory);\n\n function version() external view returns (uint256);\n\n // getRoundData and latestRoundData should both raise \"No data present\"\n // if they do not have data to report, instead of returning unset values\n // which could be misinterpreted as actual reported values.\n function getRoundData(uint80 _roundId)\n external\n view\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n );\n\n function latestRoundData()\n external\n view\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n );\n}\n" + }, + "contracts/interfaces/IBasicToken.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IBasicToken {\n function symbol() external view returns (string memory);\n\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/IBuyback.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IBuyback {\n function swap() external;\n}\n" + }, + "contracts/interfaces/IComptroller.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IComptroller {\n // Claim all the COMP accrued by specific holders in specific markets for their supplies and/or borrows\n function claimComp(\n address[] memory holders,\n address[] memory cTokens,\n bool borrowers,\n bool suppliers\n ) external;\n\n function oracle() external view returns (address);\n}\n" + }, + "contracts/interfaces/ICVXLocker.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface ICVXLocker {\n function lock(\n address _account,\n uint256 _amount,\n uint256 _spendRatio\n ) external;\n\n function lockedBalanceOf(address _account) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IDepositContract.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IDepositContract {\n /// @notice A processed deposit event.\n event DepositEvent(\n bytes pubkey,\n bytes withdrawal_credentials,\n bytes amount,\n bytes signature,\n bytes index\n );\n\n /// @notice Submit a Phase 0 DepositData object.\n /// @param pubkey A BLS12-381 public key.\n /// @param withdrawal_credentials Commitment to a public key for withdrawals.\n /// @param signature A BLS12-381 signature.\n /// @param deposit_data_root The SHA-256 hash of the SSZ-encoded DepositData object.\n /// Used as a protection against malformed input.\n function deposit(\n bytes calldata pubkey,\n bytes calldata withdrawal_credentials,\n bytes calldata signature,\n bytes32 deposit_data_root\n ) external payable;\n\n /// @notice Query the current deposit root hash.\n /// @return The deposit root hash.\n function get_deposit_root() external view returns (bytes32);\n\n /// @notice Query the current deposit count.\n /// @return The deposit count encoded as a little endian 64-bit number.\n function get_deposit_count() external view returns (bytes memory);\n}\n" + }, + "contracts/interfaces/IEthUsdOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IEthUsdOracle {\n /**\n * @notice Returns ETH price in USD.\n * @return Price in USD with 6 decimal digits.\n */\n function ethUsdPrice() external view returns (uint256);\n\n /**\n * @notice Returns token price in USD.\n * @param symbol. Asset symbol. For ex. \"DAI\".\n * @return Price in USD with 6 decimal digits.\n */\n function tokUsdPrice(string calldata symbol)\n external\n view\n returns (uint256);\n\n /**\n * @notice Returns the asset price in ETH.\n * @param symbol. Asset symbol. For ex. \"DAI\".\n * @return Price in ETH with 8 decimal digits.\n */\n function tokEthPrice(string calldata symbol)\n external\n view\n returns (uint256);\n}\n\ninterface IViewEthUsdOracle {\n /**\n * @notice Returns ETH price in USD.\n * @return Price in USD with 6 decimal digits.\n */\n function ethUsdPrice() external view returns (uint256);\n\n /**\n * @notice Returns token price in USD.\n * @param symbol. Asset symbol. For ex. \"DAI\".\n * @return Price in USD with 6 decimal digits.\n */\n function tokUsdPrice(string calldata symbol)\n external\n view\n returns (uint256);\n\n /**\n * @notice Returns the asset price in ETH.\n * @param symbol. Asset symbol. For ex. \"DAI\".\n * @return Price in ETH with 8 decimal digits.\n */\n function tokEthPrice(string calldata symbol)\n external\n view\n returns (uint256);\n}\n" + }, + "contracts/interfaces/IFraxETHMinter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IFraxETHMinter {\n function submitAndDeposit(address recipient)\n external\n payable\n returns (uint256 shares);\n}\n" + }, + "contracts/interfaces/IGetExchangeRateToken.sol": { + "content": "pragma solidity ^0.8.0;\n\ninterface IGetExchangeRateToken {\n function getExchangeRate() external view returns (uint256 _exchangeRate);\n}\n" + }, + "contracts/interfaces/IMinMaxOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IMinMaxOracle {\n //Assuming 8 decimals\n function priceMin(string calldata symbol) external view returns (uint256);\n\n function priceMax(string calldata symbol) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IOneInch.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/// 1Inch swap data\nstruct SwapDescription {\n IERC20 srcToken; // contract address of a token to sell\n IERC20 dstToken; // contract address of a token to buy\n address payable srcReceiver;\n address payable dstReceiver; // Receiver of destination currency. default: fromAddress\n uint256 amount;\n uint256 minReturnAmount;\n uint256 flags;\n}\n\n/// @title Interface for making arbitrary calls during swap\ninterface IAggregationExecutor {\n /// @notice propagates information about original msg.sender and executes arbitrary data\n function execute(address msgSender) external payable; // 0x4b64e492\n}\n\ninterface IOneInchRouter {\n /// @notice Performs a swap, delegating all calls encoded in `data` to `executor`.\n function swap(\n IAggregationExecutor executor,\n SwapDescription calldata desc,\n bytes calldata permit,\n bytes calldata data\n ) external returns (uint256 returnAmount, uint256 spentAmount);\n\n /// @notice Performs swap using Uniswap exchange. Wraps and unwraps ETH if required.\n function unoswapTo(\n address payable recipient,\n IERC20 srcToken,\n uint256 amount,\n uint256 minReturn,\n uint256[] calldata pools\n ) external payable returns (uint256 returnAmount);\n\n /// @notice Performs swap using Uniswap V3 exchange. Wraps and unwraps ETH if required.\n function uniswapV3SwapTo(\n address payable recipient,\n uint256 amount,\n uint256 minReturn,\n uint256[] calldata pools\n ) external payable returns (uint256 returnAmount);\n}\n" + }, + "contracts/interfaces/IOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IOracle {\n /**\n * @dev returns the asset price in USD, in 8 decimal digits.\n *\n * The version of priceProvider deployed for OETH has 18 decimal digits\n */\n function price(address asset) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IOUSD.sol": { + "content": "pragma solidity ^0.8.0;\n\ninterface IOUSD {\n event Approval(\n address indexed owner,\n address indexed spender,\n uint256 value\n );\n event GovernorshipTransferred(\n address indexed previousGovernor,\n address indexed newGovernor\n );\n event PendingGovernorshipTransfer(\n address indexed previousGovernor,\n address indexed newGovernor\n );\n event TotalSupplyUpdatedHighres(\n uint256 totalSupply,\n uint256 rebasingCredits,\n uint256 rebasingCreditsPerToken\n );\n event Transfer(address indexed from, address indexed to, uint256 value);\n\n function _totalSupply() external view returns (uint256);\n\n function allowance(address _owner, address _spender)\n external\n view\n returns (uint256);\n\n function approve(address _spender, uint256 _value) external returns (bool);\n\n function balanceOf(address _account) external view returns (uint256);\n\n function burn(address account, uint256 amount) external;\n\n function changeSupply(uint256 _newTotalSupply) external;\n\n function claimGovernance() external;\n\n function creditsBalanceOf(address _account)\n external\n view\n returns (uint256, uint256);\n\n function creditsBalanceOfHighres(address _account)\n external\n view\n returns (\n uint256,\n uint256,\n bool\n );\n\n function decimals() external view returns (uint8);\n\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\n external\n returns (bool);\n\n function governor() external view returns (address);\n\n function increaseAllowance(address _spender, uint256 _addedValue)\n external\n returns (bool);\n\n function initialize(\n string memory _nameArg,\n string memory _symbolArg,\n address _vaultAddress\n ) external;\n\n function isGovernor() external view returns (bool);\n\n function isUpgraded(address) external view returns (uint256);\n\n function mint(address _account, uint256 _amount) external;\n\n function name() external view returns (string memory);\n\n function nonRebasingCreditsPerToken(address)\n external\n view\n returns (uint256);\n\n function nonRebasingSupply() external view returns (uint256);\n\n function rebaseOptIn() external;\n\n function rebaseOptOut() external;\n\n function rebaseState(address) external view returns (uint8);\n\n function rebasingCredits() external view returns (uint256);\n\n function rebasingCreditsHighres() external view returns (uint256);\n\n function rebasingCreditsPerToken() external view returns (uint256);\n\n function rebasingCreditsPerTokenHighres() external view returns (uint256);\n\n function symbol() external view returns (string memory);\n\n function totalSupply() external view returns (uint256);\n\n function transfer(address _to, uint256 _value) external returns (bool);\n\n function transferFrom(\n address _from,\n address _to,\n uint256 _value\n ) external returns (bool);\n\n function transferGovernance(address _newGovernor) external;\n\n function vaultAddress() external view returns (address);\n}\n" + }, + "contracts/interfaces/IPriceOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IPriceOracle {\n /**\n * @dev returns the asset price in USD, 6 decimal digits.\n * Compatible with the Open Price Feed.\n */\n function price(string calldata symbol) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/IRETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IRETH {\n function getEthValue(uint256 _rethAmount) external view returns (uint256);\n\n function getRethValue(uint256 _ethAmount) external view returns (uint256);\n\n function getExchangeRate() external view returns (uint256);\n\n function totalSupply() external view returns (uint256);\n\n function balanceOf(address account) external view returns (uint256);\n\n function transfer(address recipient, uint256 amount)\n external\n returns (bool);\n\n function allowance(address owner, address spender)\n external\n view\n returns (uint256);\n\n function approve(address spender, uint256 amount) external returns (bool);\n\n function transferFrom(\n address sender,\n address recipient,\n uint256 amount\n ) external returns (bool);\n\n function name() external view returns (string memory);\n\n function symbol() external view returns (string memory);\n\n function decimals() external view returns (uint8);\n}\n" + }, + "contracts/interfaces/ISfrxETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface ISfrxETH {\n event Approval(\n address indexed owner,\n address indexed spender,\n uint256 amount\n );\n event Deposit(\n address indexed caller,\n address indexed owner,\n uint256 assets,\n uint256 shares\n );\n event NewRewardsCycle(uint32 indexed cycleEnd, uint256 rewardAmount);\n event Transfer(address indexed from, address indexed to, uint256 amount);\n event Withdraw(\n address indexed caller,\n address indexed receiver,\n address indexed owner,\n uint256 assets,\n uint256 shares\n );\n\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n\n function allowance(address, address) external view returns (uint256);\n\n function approve(address spender, uint256 amount) external returns (bool);\n\n function asset() external view returns (address);\n\n function balanceOf(address) external view returns (uint256);\n\n function convertToAssets(uint256 shares) external view returns (uint256);\n\n function convertToShares(uint256 assets) external view returns (uint256);\n\n function decimals() external view returns (uint8);\n\n function deposit(uint256 assets, address receiver)\n external\n returns (uint256 shares);\n\n function depositWithSignature(\n uint256 assets,\n address receiver,\n uint256 deadline,\n bool approveMax,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external returns (uint256 shares);\n\n function lastRewardAmount() external view returns (uint192);\n\n function lastSync() external view returns (uint32);\n\n function maxDeposit(address) external view returns (uint256);\n\n function maxMint(address) external view returns (uint256);\n\n function maxRedeem(address owner) external view returns (uint256);\n\n function maxWithdraw(address owner) external view returns (uint256);\n\n function mint(uint256 shares, address receiver)\n external\n returns (uint256 assets);\n\n function name() external view returns (string memory);\n\n function nonces(address) external view returns (uint256);\n\n function permit(\n address owner,\n address spender,\n uint256 value,\n uint256 deadline,\n uint8 v,\n bytes32 r,\n bytes32 s\n ) external;\n\n function previewDeposit(uint256 assets) external view returns (uint256);\n\n function previewMint(uint256 shares) external view returns (uint256);\n\n function previewRedeem(uint256 shares) external view returns (uint256);\n\n function previewWithdraw(uint256 assets) external view returns (uint256);\n\n function pricePerShare() external view returns (uint256);\n\n function redeem(\n uint256 shares,\n address receiver,\n address owner\n ) external returns (uint256 assets);\n\n function rewardsCycleEnd() external view returns (uint32);\n\n function rewardsCycleLength() external view returns (uint32);\n\n function symbol() external view returns (string memory);\n\n function syncRewards() external;\n\n function totalAssets() external view returns (uint256);\n\n function totalSupply() external view returns (uint256);\n\n function transfer(address to, uint256 amount) external returns (bool);\n\n function transferFrom(\n address from,\n address to,\n uint256 amount\n ) external returns (bool);\n\n function withdraw(\n uint256 assets,\n address receiver,\n address owner\n ) external returns (uint256 shares);\n}\n" + }, + "contracts/interfaces/ISSVNetwork.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nstruct Cluster {\n uint32 validatorCount;\n uint64 networkFeeIndex;\n uint64 index;\n bool active;\n uint256 balance;\n}\n\ninterface ISSVNetwork {\n error ApprovalNotWithinTimeframe();\n error CallerNotOwner();\n error CallerNotWhitelisted();\n error ClusterAlreadyEnabled();\n error ClusterDoesNotExists();\n error ClusterIsLiquidated();\n error ClusterNotLiquidatable();\n error ExceedValidatorLimit();\n error FeeExceedsIncreaseLimit();\n error FeeIncreaseNotAllowed();\n error FeeTooHigh();\n error FeeTooLow();\n error IncorrectClusterState();\n error IncorrectValidatorState();\n error InsufficientBalance();\n error InvalidOperatorIdsLength();\n error InvalidPublicKeyLength();\n error MaxValueExceeded();\n error NewBlockPeriodIsBelowMinimum();\n error NoFeeDeclared();\n error NotAuthorized();\n error OperatorAlreadyExists();\n error OperatorDoesNotExist();\n error OperatorsListNotUnique();\n error SameFeeChangeNotAllowed();\n error TargetModuleDoesNotExist();\n error TokenTransferFailed();\n error UnsortedOperatorsList();\n error ValidatorAlreadyExists();\n error ValidatorDoesNotExist();\n\n event AdminChanged(address previousAdmin, address newAdmin);\n event BeaconUpgraded(address indexed beacon);\n event ClusterDeposited(\n address indexed owner,\n uint64[] operatorIds,\n uint256 value,\n Cluster cluster\n );\n event ClusterLiquidated(\n address indexed owner,\n uint64[] operatorIds,\n Cluster cluster\n );\n event ClusterReactivated(\n address indexed owner,\n uint64[] operatorIds,\n Cluster cluster\n );\n event ClusterWithdrawn(\n address indexed owner,\n uint64[] operatorIds,\n uint256 value,\n Cluster cluster\n );\n event DeclareOperatorFeePeriodUpdated(uint64 value);\n event ExecuteOperatorFeePeriodUpdated(uint64 value);\n event FeeRecipientAddressUpdated(\n address indexed owner,\n address recipientAddress\n );\n event Initialized(uint8 version);\n event LiquidationThresholdPeriodUpdated(uint64 value);\n event MinimumLiquidationCollateralUpdated(uint256 value);\n event NetworkEarningsWithdrawn(uint256 value, address recipient);\n event NetworkFeeUpdated(uint256 oldFee, uint256 newFee);\n event OperatorAdded(\n uint64 indexed operatorId,\n address indexed owner,\n bytes publicKey,\n uint256 fee\n );\n event OperatorFeeDeclarationCancelled(\n address indexed owner,\n uint64 indexed operatorId\n );\n event OperatorFeeDeclared(\n address indexed owner,\n uint64 indexed operatorId,\n uint256 blockNumber,\n uint256 fee\n );\n event OperatorFeeExecuted(\n address indexed owner,\n uint64 indexed operatorId,\n uint256 blockNumber,\n uint256 fee\n );\n event OperatorFeeIncreaseLimitUpdated(uint64 value);\n event OperatorMaximumFeeUpdated(uint64 maxFee);\n event OperatorRemoved(uint64 indexed operatorId);\n event OperatorWhitelistUpdated(\n uint64 indexed operatorId,\n address whitelisted\n );\n event OperatorWithdrawn(\n address indexed owner,\n uint64 indexed operatorId,\n uint256 value\n );\n event OwnershipTransferStarted(\n address indexed previousOwner,\n address indexed newOwner\n );\n event OwnershipTransferred(\n address indexed previousOwner,\n address indexed newOwner\n );\n event Upgraded(address indexed implementation);\n event ValidatorAdded(\n address indexed owner,\n uint64[] operatorIds,\n bytes publicKey,\n bytes shares,\n Cluster cluster\n );\n event ValidatorExited(\n address indexed owner,\n uint64[] operatorIds,\n bytes publicKey\n );\n event ValidatorRemoved(\n address indexed owner,\n uint64[] operatorIds,\n bytes publicKey,\n Cluster cluster\n );\n\n fallback() external;\n\n function acceptOwnership() external;\n\n function cancelDeclaredOperatorFee(uint64 operatorId) external;\n\n function declareOperatorFee(uint64 operatorId, uint256 fee) external;\n\n function deposit(\n address clusterOwner,\n uint64[] memory operatorIds,\n uint256 amount,\n Cluster memory cluster\n ) external;\n\n function executeOperatorFee(uint64 operatorId) external;\n\n function exitValidator(bytes memory publicKey, uint64[] memory operatorIds)\n external;\n\n function getVersion() external pure returns (string memory version);\n\n function initialize(\n address token_,\n address ssvOperators_,\n address ssvClusters_,\n address ssvDAO_,\n address ssvViews_,\n uint64 minimumBlocksBeforeLiquidation_,\n uint256 minimumLiquidationCollateral_,\n uint32 validatorsPerOperatorLimit_,\n uint64 declareOperatorFeePeriod_,\n uint64 executeOperatorFeePeriod_,\n uint64 operatorMaxFeeIncrease_\n ) external;\n\n function liquidate(\n address clusterOwner,\n uint64[] memory operatorIds,\n Cluster memory cluster\n ) external;\n\n function owner() external view returns (address);\n\n function pendingOwner() external view returns (address);\n\n function proxiableUUID() external view returns (bytes32);\n\n function reactivate(\n uint64[] memory operatorIds,\n uint256 amount,\n Cluster memory cluster\n ) external;\n\n function reduceOperatorFee(uint64 operatorId, uint256 fee) external;\n\n function registerOperator(bytes memory publicKey, uint256 fee)\n external\n returns (uint64 id);\n\n function registerValidator(\n bytes memory publicKey,\n uint64[] memory operatorIds,\n bytes memory sharesData,\n uint256 amount,\n Cluster memory cluster\n ) external;\n\n function removeOperator(uint64 operatorId) external;\n\n function removeValidator(\n bytes memory publicKey,\n uint64[] memory operatorIds,\n Cluster memory cluster\n ) external;\n\n function renounceOwnership() external;\n\n function setFeeRecipientAddress(address recipientAddress) external;\n\n function setOperatorWhitelist(uint64 operatorId, address whitelisted)\n external;\n\n function transferOwnership(address newOwner) external;\n\n function updateDeclareOperatorFeePeriod(uint64 timeInSeconds) external;\n\n function updateExecuteOperatorFeePeriod(uint64 timeInSeconds) external;\n\n function updateLiquidationThresholdPeriod(uint64 blocks) external;\n\n function updateMaximumOperatorFee(uint64 maxFee) external;\n\n function updateMinimumLiquidationCollateral(uint256 amount) external;\n\n function updateModule(uint8 moduleId, address moduleAddress) external;\n\n function updateNetworkFee(uint256 fee) external;\n\n function updateOperatorFeeIncreaseLimit(uint64 percentage) external;\n\n function upgradeTo(address newImplementation) external;\n\n function upgradeToAndCall(address newImplementation, bytes memory data)\n external\n payable;\n\n function withdraw(\n uint64[] memory operatorIds,\n uint256 amount,\n Cluster memory cluster\n ) external;\n\n function withdrawAllOperatorEarnings(uint64 operatorId) external;\n\n function withdrawNetworkEarnings(uint256 amount) external;\n\n function withdrawOperatorEarnings(uint64 operatorId, uint256 amount)\n external;\n}\n" + }, + "contracts/interfaces/IStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Platform interface to integrate with lending platform like Compound, AAVE etc.\n */\ninterface IStrategy {\n /**\n * @dev Deposit the given asset to platform\n * @param _asset asset address\n * @param _amount Amount to deposit\n */\n function deposit(address _asset, uint256 _amount) external;\n\n /**\n * @dev Deposit the entire balance of all supported assets in the Strategy\n * to the platform\n */\n function depositAll() external;\n\n /**\n * @dev Withdraw given asset from Lending platform\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external;\n\n /**\n * @dev Liquidate all assets in strategy and return them to Vault.\n */\n function withdrawAll() external;\n\n /**\n * @dev Returns the current balance of the given asset.\n */\n function checkBalance(address _asset)\n external\n view\n returns (uint256 balance);\n\n /**\n * @dev Returns bool indicating whether strategy supports asset.\n */\n function supportsAsset(address _asset) external view returns (bool);\n\n /**\n * @dev Collect reward tokens from the Strategy.\n */\n function collectRewardTokens() external;\n\n /**\n * @dev The address array of the reward tokens for the Strategy.\n */\n function getRewardTokenAddresses() external view returns (address[] memory);\n}\n" + }, + "contracts/interfaces/ISwapper.sol": { + "content": "pragma solidity ^0.8.0;\n\ninterface ISwapper {\n /**\n * @param fromAsset The token address of the asset being sold.\n * @param toAsset The token address of the asset being purchased.\n * @param fromAssetAmount The amount of assets being sold.\n * @param minToAssetAmmount The minimum amount of assets to be purchased.\n * @param data tx.data returned from 1Inch's /v5.0/1/swap API\n */\n function swap(\n address fromAsset,\n address toAsset,\n uint256 fromAssetAmount,\n uint256 minToAssetAmmount,\n bytes calldata data\n ) external returns (uint256 toAssetAmount);\n}\n" + }, + "contracts/interfaces/ITimelock.sol": { + "content": "pragma solidity ^0.8.0;\n\ninterface ITimelock {\n function delay() external view returns (uint256);\n\n function GRACE_PERIOD() external view returns (uint256);\n\n function acceptAdmin() external;\n\n function queuedTransactions(bytes32 hash) external view returns (bool);\n\n function queueTransaction(\n address target,\n uint256 value,\n string calldata signature,\n bytes calldata data,\n uint256 eta\n ) external returns (bytes32);\n\n function cancelTransaction(\n address target,\n uint256 value,\n string calldata signature,\n bytes calldata data,\n uint256 eta\n ) external;\n\n function executeTransaction(\n address target,\n uint256 value,\n string calldata signature,\n bytes calldata data,\n uint256 eta\n ) external payable returns (bytes memory);\n}\n" + }, + "contracts/interfaces/IVault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { VaultStorage } from \"../vault/VaultStorage.sol\";\n\ninterface IVault {\n event AssetSupported(address _asset);\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\n event StrategyApproved(address _addr);\n event StrategyRemoved(address _addr);\n event Mint(address _addr, uint256 _value);\n event Redeem(address _addr, uint256 _value);\n event CapitalPaused();\n event CapitalUnpaused();\n event RebasePaused();\n event RebaseUnpaused();\n event VaultBufferUpdated(uint256 _vaultBuffer);\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\n event PriceProviderUpdated(address _priceProvider);\n event AllocateThresholdUpdated(uint256 _threshold);\n event RebaseThresholdUpdated(uint256 _threshold);\n event StrategistUpdated(address _address);\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\n event TrusteeFeeBpsChanged(uint256 _basis);\n event TrusteeAddressChanged(address _address);\n event SwapperChanged(address _address);\n event SwapAllowedUndervalueChanged(uint256 _basis);\n event SwapSlippageChanged(address _asset, uint256 _basis);\n event Swapped(\n address indexed _fromAsset,\n address indexed _toAsset,\n uint256 _fromAssetAmount,\n uint256 _toAssetAmount\n );\n\n // Governable.sol\n function transferGovernance(address _newGovernor) external;\n\n function claimGovernance() external;\n\n function governor() external view returns (address);\n\n // VaultAdmin.sol\n function setPriceProvider(address _priceProvider) external;\n\n function priceProvider() external view returns (address);\n\n function setRedeemFeeBps(uint256 _redeemFeeBps) external;\n\n function redeemFeeBps() external view returns (uint256);\n\n function setVaultBuffer(uint256 _vaultBuffer) external;\n\n function vaultBuffer() external view returns (uint256);\n\n function setAutoAllocateThreshold(uint256 _threshold) external;\n\n function autoAllocateThreshold() external view returns (uint256);\n\n function setRebaseThreshold(uint256 _threshold) external;\n\n function rebaseThreshold() external view returns (uint256);\n\n function setStrategistAddr(address _address) external;\n\n function strategistAddr() external view returns (address);\n\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external;\n\n function maxSupplyDiff() external view returns (uint256);\n\n function setTrusteeAddress(address _address) external;\n\n function trusteeAddress() external view returns (address);\n\n function setTrusteeFeeBps(uint256 _basis) external;\n\n function trusteeFeeBps() external view returns (uint256);\n\n function ousdMetaStrategy() external view returns (address);\n\n function setSwapper(address _swapperAddr) external;\n\n function setSwapAllowedUndervalue(uint16 _percentageBps) external;\n\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\n external;\n\n function supportAsset(address _asset, uint8 _supportsAsset) external;\n\n function approveStrategy(address _addr) external;\n\n function removeStrategy(address _addr) external;\n\n function setAssetDefaultStrategy(address _asset, address _strategy)\n external;\n\n function assetDefaultStrategies(address _asset)\n external\n view\n returns (address);\n\n function pauseRebase() external;\n\n function unpauseRebase() external;\n\n function rebasePaused() external view returns (bool);\n\n function pauseCapital() external;\n\n function unpauseCapital() external;\n\n function capitalPaused() external view returns (bool);\n\n function transferToken(address _asset, uint256 _amount) external;\n\n function priceUnitMint(address asset) external view returns (uint256);\n\n function priceUnitRedeem(address asset) external view returns (uint256);\n\n function withdrawAllFromStrategy(address _strategyAddr) external;\n\n function withdrawAllFromStrategies() external;\n\n function withdrawFromStrategy(\n address _strategyFromAddress,\n address[] calldata _assets,\n uint256[] calldata _amounts\n ) external;\n\n function depositToStrategy(\n address _strategyToAddress,\n address[] calldata _assets,\n uint256[] calldata _amounts\n ) external;\n\n // VaultCore.sol\n function mint(\n address _asset,\n uint256 _amount,\n uint256 _minimumOusdAmount\n ) external;\n\n function mintForStrategy(uint256 _amount) external;\n\n function redeem(uint256 _amount, uint256 _minimumUnitAmount) external;\n\n function burnForStrategy(uint256 _amount) external;\n\n function redeemAll(uint256 _minimumUnitAmount) external;\n\n function allocate() external;\n\n function rebase() external;\n\n function swapCollateral(\n address fromAsset,\n address toAsset,\n uint256 fromAssetAmount,\n uint256 minToAssetAmount,\n bytes calldata data\n ) external returns (uint256 toAssetAmount);\n\n function totalValue() external view returns (uint256 value);\n\n function checkBalance(address _asset) external view returns (uint256);\n\n function calculateRedeemOutputs(uint256 _amount)\n external\n view\n returns (uint256[] memory);\n\n function getAssetCount() external view returns (uint256);\n\n function getAssetConfig(address _asset)\n external\n view\n returns (VaultStorage.Asset memory config);\n\n function getAllAssets() external view returns (address[] memory);\n\n function getStrategyCount() external view returns (uint256);\n\n function swapper() external view returns (address);\n\n function allowedSwapUndervalue() external view returns (uint256);\n\n function getAllStrategies() external view returns (address[] memory);\n\n function isSupportedAsset(address _asset) external view returns (bool);\n\n function netOusdMintForStrategyThreshold() external view returns (uint256);\n\n function setOusdMetaStrategy(address _ousdMetaStrategy) external;\n\n function setNetOusdMintForStrategyThreshold(uint256 _threshold) external;\n\n function netOusdMintedForStrategy() external view returns (int256);\n\n function weth() external view returns (address);\n\n function cacheWETHAssetIndex() external;\n\n function wethAssetIndex() external view returns (uint256);\n\n function initialize(address, address) external;\n\n function setAdminImpl(address) external;\n}\n" + }, + "contracts/interfaces/IWETH9.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IWETH9 {\n event Approval(address indexed src, address indexed guy, uint256 wad);\n event Deposit(address indexed dst, uint256 wad);\n event Transfer(address indexed src, address indexed dst, uint256 wad);\n event Withdrawal(address indexed src, uint256 wad);\n\n function allowance(address, address) external view returns (uint256);\n\n function approve(address guy, uint256 wad) external returns (bool);\n\n function balanceOf(address) external view returns (uint256);\n\n function decimals() external view returns (uint8);\n\n function deposit() external payable;\n\n function name() external view returns (string memory);\n\n function symbol() external view returns (string memory);\n\n function totalSupply() external view returns (uint256);\n\n function transfer(address dst, uint256 wad) external returns (bool);\n\n function transferFrom(\n address src,\n address dst,\n uint256 wad\n ) external returns (bool);\n\n function withdraw(uint256 wad) external;\n}\n" + }, + "contracts/interfaces/IWstETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IWstETH {\n /**\n * @notice Get amount of wstETH for a given amount of stETH\n * @param _stETHAmount amount of stETH\n * @return Amount of wstETH for a given stETH amount\n */\n function getWstETHByStETH(uint256 _stETHAmount)\n external\n view\n returns (uint256);\n\n /**\n * @notice Get amount of stETH for a given amount of wstETH\n * @param _wstETHAmount amount of wstETH\n * @return Amount of stETH for a given wstETH amount\n */\n function getStETHByWstETH(uint256 _wstETHAmount)\n external\n view\n returns (uint256);\n\n /**\n * @notice Get amount of stETH for a one wstETH\n * @return Amount of stETH for 1 wstETH\n */\n function stEthPerToken() external view returns (uint256);\n\n /**\n * @notice Get amount of wstETH for a one stETH\n * @return Amount of wstETH for a 1 stETH\n */\n function tokensPerStEth() external view returns (uint256);\n\n /**\n * @notice Exchanges stETH to wstETH\n * @param _stETHAmount amount of stETH to wrap in exchange for wstETH\n * @dev Requirements:\n * - `_stETHAmount` must be non-zero\n * - msg.sender must approve at least `_stETHAmount` stETH to this\n * contract.\n * - msg.sender must have at least `_stETHAmount` of stETH.\n * User should first approve _stETHAmount to the WstETH contract\n * @return Amount of wstETH user receives after wrap\n */\n function wrap(uint256 _stETHAmount) external returns (uint256);\n\n /**\n * @notice Exchanges wstETH to stETH\n * @param _wstETHAmount amount of wstETH to uwrap in exchange for stETH\n * @dev Requirements:\n * - `_wstETHAmount` must be non-zero\n * - msg.sender must have at least `_wstETHAmount` wstETH.\n * @return Amount of stETH user receives after unwrap\n */\n function unwrap(uint256 _wstETHAmount) external returns (uint256);\n}\n" + }, + "contracts/interfaces/morpho/compound/ICompoundOracle.sol": { + "content": "// SPDX-License-Identifier: GNU AGPLv3\npragma solidity ^0.8.0;\n\ninterface ICompoundOracle {\n function getUnderlyingPrice(address) external view returns (uint256);\n}\n" + }, + "contracts/interfaces/morpho/ILens.sol": { + "content": "// SPDX-License-Identifier: GNU AGPLv3\npragma solidity ^0.8.0;\n\nimport \"./compound/ICompoundOracle.sol\";\nimport \"./IMorpho.sol\";\n\ninterface ILens {\n /// STORAGE ///\n\n function MAX_BASIS_POINTS() external view returns (uint256);\n\n function WAD() external view returns (uint256);\n\n function morpho() external view returns (IMorpho);\n\n function comptroller() external view returns (IComptroller);\n\n /// GENERAL ///\n\n function getTotalSupply()\n external\n view\n returns (\n uint256 p2pSupplyAmount,\n uint256 poolSupplyAmount,\n uint256 totalSupplyAmount\n );\n\n function getTotalBorrow()\n external\n view\n returns (\n uint256 p2pBorrowAmount,\n uint256 poolBorrowAmount,\n uint256 totalBorrowAmount\n );\n\n /// MARKETS ///\n\n function isMarketCreated(address _poolToken) external view returns (bool);\n\n function isMarketCreatedAndNotPaused(address _poolToken)\n external\n view\n returns (bool);\n\n function isMarketCreatedAndNotPausedNorPartiallyPaused(address _poolToken)\n external\n view\n returns (bool);\n\n function getAllMarkets()\n external\n view\n returns (address[] memory marketsCreated_);\n\n function getMainMarketData(address _poolToken)\n external\n view\n returns (\n uint256 avgSupplyRatePerBlock,\n uint256 avgBorrowRatePerBlock,\n uint256 p2pSupplyAmount,\n uint256 p2pBorrowAmount,\n uint256 poolSupplyAmount,\n uint256 poolBorrowAmount\n );\n\n function getAdvancedMarketData(address _poolToken)\n external\n view\n returns (\n uint256 p2pSupplyIndex,\n uint256 p2pBorrowIndex,\n uint256 poolSupplyIndex,\n uint256 poolBorrowIndex,\n uint32 lastUpdateBlockNumber,\n uint256 p2pSupplyDelta,\n uint256 p2pBorrowDelta\n );\n\n function getMarketConfiguration(address _poolToken)\n external\n view\n returns (\n address underlying,\n bool isCreated,\n bool p2pDisabled,\n bool isPaused,\n bool isPartiallyPaused,\n uint16 reserveFactor,\n uint16 p2pIndexCursor,\n uint256 collateralFactor\n );\n\n function getTotalMarketSupply(address _poolToken)\n external\n view\n returns (uint256 p2pSupplyAmount, uint256 poolSupplyAmount);\n\n function getTotalMarketBorrow(address _poolToken)\n external\n view\n returns (uint256 p2pBorrowAmount, uint256 poolBorrowAmount);\n\n /// INDEXES ///\n\n function getCurrentP2PSupplyIndex(address _poolToken)\n external\n view\n returns (uint256);\n\n function getCurrentP2PBorrowIndex(address _poolToken)\n external\n view\n returns (uint256);\n\n function getCurrentPoolIndexes(address _poolToken)\n external\n view\n returns (\n uint256 currentPoolSupplyIndex,\n uint256 currentPoolBorrowIndex\n );\n\n function getIndexes(address _poolToken, bool _computeUpdatedIndexes)\n external\n view\n returns (\n uint256 p2pSupplyIndex,\n uint256 p2pBorrowIndex,\n uint256 poolSupplyIndex,\n uint256 poolBorrowIndex\n );\n\n /// USERS ///\n\n function getEnteredMarkets(address _user)\n external\n view\n returns (address[] memory enteredMarkets);\n\n function getUserHealthFactor(\n address _user,\n address[] calldata _updatedMarkets\n ) external view returns (uint256);\n\n function getUserBalanceStates(\n address _user,\n address[] calldata _updatedMarkets\n )\n external\n view\n returns (\n uint256 collateralValue,\n uint256 debtValue,\n uint256 maxDebtValue\n );\n\n function getCurrentSupplyBalanceInOf(address _poolToken, address _user)\n external\n view\n returns (\n uint256 balanceOnPool,\n uint256 balanceInP2P,\n uint256 totalBalance\n );\n\n function getCurrentBorrowBalanceInOf(address _poolToken, address _user)\n external\n view\n returns (\n uint256 balanceOnPool,\n uint256 balanceInP2P,\n uint256 totalBalance\n );\n\n function getUserMaxCapacitiesForAsset(address _user, address _poolToken)\n external\n view\n returns (uint256 withdrawable, uint256 borrowable);\n\n function getUserHypotheticalBalanceStates(\n address _user,\n address _poolToken,\n uint256 _withdrawnAmount,\n uint256 _borrowedAmount\n ) external view returns (uint256 debtValue, uint256 maxDebtValue);\n\n function getUserLiquidityDataForAsset(\n address _user,\n address _poolToken,\n bool _computeUpdatedIndexes,\n ICompoundOracle _oracle\n ) external view returns (Types.AssetLiquidityData memory assetData);\n\n function isLiquidatable(address _user, address[] memory _updatedMarkets)\n external\n view\n returns (bool);\n\n function computeLiquidationRepayAmount(\n address _user,\n address _poolTokenBorrowed,\n address _poolTokenCollateral,\n address[] calldata _updatedMarkets\n ) external view returns (uint256 toRepay);\n\n /// RATES ///\n\n function getAverageSupplyRatePerBlock(address _poolToken)\n external\n view\n returns (\n uint256 avgSupplyRatePerBlock,\n uint256 p2pSupplyAmount,\n uint256 poolSupplyAmount\n );\n\n function getAverageBorrowRatePerBlock(address _poolToken)\n external\n view\n returns (\n uint256 avgBorrowRatePerBlock,\n uint256 p2pBorrowAmount,\n uint256 poolBorrowAmount\n );\n\n function getNextUserSupplyRatePerBlock(\n address _poolToken,\n address _user,\n uint256 _amount\n )\n external\n view\n returns (\n uint256 nextSupplyRatePerBlock,\n uint256 balanceOnPool,\n uint256 balanceInP2P,\n uint256 totalBalance\n );\n\n function getNextUserBorrowRatePerBlock(\n address _poolToken,\n address _user,\n uint256 _amount\n )\n external\n view\n returns (\n uint256 nextBorrowRatePerBlock,\n uint256 balanceOnPool,\n uint256 balanceInP2P,\n uint256 totalBalance\n );\n\n function getCurrentUserSupplyRatePerBlock(address _poolToken, address _user)\n external\n view\n returns (uint256);\n\n function getCurrentUserBorrowRatePerBlock(address _poolToken, address _user)\n external\n view\n returns (uint256);\n\n function getRatesPerBlock(address _poolToken)\n external\n view\n returns (\n uint256 p2pSupplyRate,\n uint256 p2pBorrowRate,\n uint256 poolSupplyRate,\n uint256 poolBorrowRate\n );\n\n /// REWARDS ///\n\n function getUserUnclaimedRewards(\n address[] calldata _poolTokens,\n address _user\n ) external view returns (uint256 unclaimedRewards);\n\n function getAccruedSupplierComp(\n address _supplier,\n address _poolToken,\n uint256 _balance\n ) external view returns (uint256);\n\n function getAccruedBorrowerComp(\n address _borrower,\n address _poolToken,\n uint256 _balance\n ) external view returns (uint256);\n\n function getCurrentCompSupplyIndex(address _poolToken)\n external\n view\n returns (uint256);\n\n function getCurrentCompBorrowIndex(address _poolToken)\n external\n view\n returns (uint256);\n}\n" + }, + "contracts/interfaces/morpho/IMorpho.sol": { + "content": "// SPDX-License-Identifier: GNU AGPLv3\npragma solidity ^0.8.0;\n\nimport \"./Types.sol\";\nimport \"../IComptroller.sol\";\nimport \"./compound/ICompoundOracle.sol\";\n\n// prettier-ignore\ninterface IMorpho {\n function comptroller() external view returns (IComptroller);\n function supply(address _poolTokenAddress, address _onBehalf, uint256 _amount) external;\n function supply(address _poolTokenAddress, address _onBehalf, uint256 _amount, uint256 _maxGasForMatching) external;\n function withdraw(address _poolTokenAddress, uint256 _amount) external;\n function claimRewards(\n address[] calldata _cTokenAddresses,\n bool _tradeForMorphoToken\n ) external returns (uint256 claimedAmount);\n}\n" + }, + "contracts/interfaces/morpho/Types.sol": { + "content": "// SPDX-License-Identifier: GNU AGPLv3\npragma solidity ^0.8.0;\n\n/// @title Types.\n/// @author Morpho Labs.\n/// @custom:contact security@morpho.xyz\n/// @dev Common types and structs used in Moprho contracts.\nlibrary Types {\n /// ENUMS ///\n\n enum PositionType {\n SUPPLIERS_IN_P2P,\n SUPPLIERS_ON_POOL,\n BORROWERS_IN_P2P,\n BORROWERS_ON_POOL\n }\n\n /// STRUCTS ///\n\n struct SupplyBalance {\n uint256 inP2P; // In supplier's peer-to-peer unit, a unit that grows in underlying value, to keep track of the interests earned by suppliers in peer-to-peer. Multiply by the peer-to-peer supply index to get the underlying amount.\n uint256 onPool; // In cToken. Multiply by the pool supply index to get the underlying amount.\n }\n\n struct BorrowBalance {\n uint256 inP2P; // In borrower's peer-to-peer unit, a unit that grows in underlying value, to keep track of the interests paid by borrowers in peer-to-peer. Multiply by the peer-to-peer borrow index to get the underlying amount.\n uint256 onPool; // In cdUnit, a unit that grows in value, to keep track of the debt increase when borrowers are on Compound. Multiply by the pool borrow index to get the underlying amount.\n }\n\n // Max gas to consume during the matching process for supply, borrow, withdraw and repay functions.\n struct MaxGasForMatching {\n uint64 supply;\n uint64 borrow;\n uint64 withdraw;\n uint64 repay;\n }\n\n struct Delta {\n uint256 p2pSupplyDelta; // Difference between the stored peer-to-peer supply amount and the real peer-to-peer supply amount (in pool supply unit).\n uint256 p2pBorrowDelta; // Difference between the stored peer-to-peer borrow amount and the real peer-to-peer borrow amount (in pool borrow unit).\n uint256 p2pSupplyAmount; // Sum of all stored peer-to-peer supply (in peer-to-peer supply unit).\n uint256 p2pBorrowAmount; // Sum of all stored peer-to-peer borrow (in peer-to-peer borrow unit).\n }\n\n struct AssetLiquidityData {\n uint256 collateralValue; // The collateral value of the asset.\n uint256 maxDebtValue; // The maximum possible debt value of the asset.\n uint256 debtValue; // The debt value of the asset.\n uint256 underlyingPrice; // The price of the token.\n uint256 collateralFactor; // The liquidation threshold applied on this token.\n }\n\n struct LiquidityData {\n uint256 collateralValue; // The collateral value.\n uint256 maxDebtValue; // The maximum debt value possible.\n uint256 debtValue; // The debt value.\n }\n\n // Variables are packed together to save gas (will not exceed their limit during Morpho's lifetime).\n struct LastPoolIndexes {\n uint32 lastUpdateBlockNumber; // The last time the peer-to-peer indexes were updated.\n uint112 lastSupplyPoolIndex; // Last pool supply index.\n uint112 lastBorrowPoolIndex; // Last pool borrow index.\n }\n\n struct MarketParameters {\n uint16 reserveFactor; // Proportion of the interest earned by users sent to the DAO for each market, in basis point (100% = 10 000). The value is set at market creation.\n uint16 p2pIndexCursor; // Position of the peer-to-peer rate in the pool's spread. Determine the weights of the weighted arithmetic average in the indexes computations ((1 - p2pIndexCursor) * r^S + p2pIndexCursor * r^B) (in basis point).\n }\n\n struct MarketStatus {\n bool isCreated; // Whether or not this market is created.\n bool isPaused; // Whether the market is paused or not (all entry points on Morpho are frozen; supply, borrow, withdraw, repay and liquidate).\n bool isPartiallyPaused; // Whether the market is partially paused or not (only supply and borrow are frozen).\n }\n}\n" + }, + "contracts/interfaces/Tether.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface Tether {\n function transfer(address to, uint256 value) external;\n\n function transferFrom(\n address from,\n address to,\n uint256 value\n ) external;\n\n function balanceOf(address) external returns (uint256);\n}\n" + }, + "contracts/interfaces/uniswap/IUniswapUniversalRouter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IUniswapUniversalRouter {\n /// @notice Executes encoded commands along with provided inputs. Reverts if deadline has expired.\n /// @param commands A set of concatenated commands, each 1 byte in length\n /// @param inputs An array of byte strings containing abi encoded inputs for each command\n /// @param deadline The deadline by which the transaction must be executed\n function execute(\n bytes calldata commands,\n bytes[] calldata inputs,\n uint256 deadline\n ) external payable;\n\n function execute(bytes calldata commands, bytes[] calldata inputs)\n external\n payable;\n}\n" + }, + "contracts/interfaces/uniswap/IUniswapV2Pair.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IUniswapV2Pair {\n function token0() external view returns (address);\n\n function token1() external view returns (address);\n\n function getReserves()\n external\n view\n returns (\n uint112 reserve0,\n uint112 reserve1,\n uint32 blockTimestampLast\n );\n\n function price0CumulativeLast() external view returns (uint256);\n\n function price1CumulativeLast() external view returns (uint256);\n\n function sync() external;\n}\n" + }, + "contracts/interfaces/uniswap/IUniswapV2Router02.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IUniswapV2Router {\n function WETH() external pure returns (address);\n\n function swapExactTokensForTokens(\n uint256 amountIn,\n uint256 amountOutMin,\n address[] calldata path,\n address to,\n uint256 deadline\n ) external returns (uint256[] memory amounts);\n\n function addLiquidity(\n address tokenA,\n address tokenB,\n uint256 amountADesired,\n uint256 amountBDesired,\n uint256 amountAMin,\n uint256 amountBMin,\n address to,\n uint256 deadline\n )\n external\n returns (\n uint256 amountA,\n uint256 amountB,\n uint256 liquidity\n );\n}\n" + }, + "contracts/interfaces/uniswap/IUniswapV3Router.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// -- Solididy v0.5.x compatible interface\ninterface IUniswapV3Router {\n struct ExactInputParams {\n bytes path;\n address recipient;\n uint256 deadline;\n uint256 amountIn;\n uint256 amountOutMinimum;\n }\n\n /// @notice Swaps `amountIn` of one token for as much as possible of another along the specified path\n /// @param params The parameters necessary for the multi-hop swap, encoded as `ExactInputParams` in calldata\n /// @return amountOut The amount of the received token\n function exactInput(ExactInputParams calldata params)\n external\n payable\n returns (uint256 amountOut);\n}\n" + }, + "contracts/liquidity/LiquidityReward.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\n\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\n\n//\n// LiquidityReward contract doles out reward for liquidity\n// base off of Sushiswap's MasterChef: https://github.com/sushiswap/sushiswap/blob/master/contracts/MasterChef.sol\n//\ncontract LiquidityReward is Initializable, Governable {\n using SafeMath for uint256;\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n // Info of each user.\n struct UserInfo {\n uint256 amount; // How many LP tokens the user has provided.\n int256 rewardDebt; // Reward debt. See explanation below.\n //\n // We do some fancy math here. Basically, any point in time, the amount of Reward Tokens\n // entitled to a user but is pending to be distributed is:\n //\n // pending reward = (user.amount * pool.accRewardPerShare) - user.rewardDebt\n //\n // Whenever a user deposits or withdraws LP tokens to a pool. Here's what happens:\n // 1. The pool's `accRewardPerShare` (and `lastRewardBlock`) gets updated.\n // 2. User receives the pending reward sent to his/her address.\n // 3. User's `amount` gets updated.\n // 4. User's `rewardDebt` gets updated.\n //\n // NOTE: rewardDebt can go negative because we allow withdraws without claiming the reward\n // in that case we owe the account holder some reward.\n }\n\n // Info of each pool.\n struct PoolInfo {\n IERC20 lpToken; // Address of LP token contract.\n uint256 lastRewardBlock; // Last block number that Reward calculation occurs.\n uint256 accRewardPerShare; // Accumulated Reward per share in reward precision. See below.\n }\n\n // The Reward token\n IERC20 public reward;\n\n // Reward tokens created per block in 1e18 precision.\n uint256 public rewardPerBlock;\n\n // Info on the LP.\n PoolInfo public pool;\n // total Reward debt, useful to calculate if we have enough to pay out all rewards\n int256 public totalRewardDebt;\n // total Supply that is accounted for via deposit/withdraw so that our rewards calc are stable\n uint256 public totalSupply;\n // Info of each user that stakes LP tokens.\n mapping(address => UserInfo) public userInfo;\n // The block number when Liquidity rewards ends.\n uint256 public endBlock;\n\n event CampaignStarted(\n uint256 rewardRate,\n uint256 startBlock,\n uint256 endBlock\n );\n event CampaignStopped(uint256 endBlock);\n event Deposit(address indexed user, uint256 amount);\n event Withdraw(address indexed user, uint256 amount);\n event Claim(address indexed user, uint256 amount);\n event DrainExtraReward(address indexed user, uint256 amount);\n event DrainExtraLP(address indexed user, uint256 amount);\n\n /**\n * Initializer for setting up Liquidity Reward internal state.\n * @param _reward Address of the reward token(OGN)\n * @param _lpToken Address of the LP token(Uniswap Pair)\n */\n function initialize(IERC20 _reward, IERC20 _lpToken)\n external\n onlyGovernor\n initializer\n {\n reward = _reward;\n pool.lpToken = _lpToken;\n pool.lastRewardBlock = block.number;\n }\n\n /**\n * @dev start a new reward campaign.\n * This will calculate all rewards up to the current block at the old rate.\n * This ensures that we pay everyone at the promised rate before update to the new rate.\n * @param _rewardPerBlock Amount rewarded per block\n * @param _startBlock Block number that we want to start the rewards at (0 for current block)\n * @param _numBlocks number of blocks that the campaign should last\n */\n function startCampaign(\n uint256 _rewardPerBlock,\n uint256 _startBlock,\n uint256 _numBlocks\n ) external onlyGovernor {\n // Calculate up to the current block at the current rate for everyone.\n updatePool();\n\n // total Pending calculated at the current pool rate\n uint256 totalPending = subDebt(\n pool.accRewardPerShare.mulTruncate(totalSupply),\n totalRewardDebt\n );\n\n require(_numBlocks > 0, \"startCampaign: zero blocks\");\n\n require(\n reward.balanceOf(address(this)) >=\n _rewardPerBlock.mul(_numBlocks).add(totalPending),\n \"startCampaign: insufficient rewards\"\n );\n\n uint256 startBlock = _startBlock;\n if (startBlock == 0) {\n // start block number isn't given so we start at the current\n startBlock = block.number;\n }\n require(\n startBlock >= block.number,\n \"startCampaign: _startBlock can't be in the past\"\n );\n endBlock = startBlock.add(_numBlocks);\n // we don't start accrue until the startBlock\n pool.lastRewardBlock = startBlock;\n // new blocks start at the new reward rate\n rewardPerBlock = _rewardPerBlock;\n emit CampaignStarted(rewardPerBlock, startBlock, endBlock);\n }\n\n function stopCampaign() external onlyGovernor {\n //calculate until current pool\n updatePool();\n //end the block here (the CampaignMultiplier will be zero)\n endBlock = block.number;\n emit CampaignStopped(endBlock);\n }\n\n function drainExtraRewards() external onlyGovernor {\n require(endBlock < block.number, \"drainExtraRewards:Campaign active\");\n updatePool();\n uint256 extraRewards = reward.balanceOf(address(this)).sub(\n subDebt(\n pool.accRewardPerShare.mulTruncate(totalSupply),\n totalRewardDebt\n )\n );\n if (extraRewards > 0) {\n emit DrainExtraReward(msg.sender, extraRewards);\n reward.safeTransfer(msg.sender, extraRewards);\n }\n }\n\n function drainExtraLP() external onlyGovernor {\n uint256 extraLP = pool.lpToken.balanceOf(address(this)).sub(\n totalSupply\n );\n require(extraLP > 0, \"drainExtraLP:no extra\");\n emit DrainExtraLP(msg.sender, extraLP);\n pool.lpToken.safeTransfer(msg.sender, extraLP);\n }\n\n function campaignActive() external view returns (bool) {\n return endBlock > block.number && block.number >= pool.lastRewardBlock;\n }\n\n function balanceOf(address _account) external view returns (uint256) {\n return userInfo[_account].amount;\n }\n\n /**\n * @dev calculate the number of blocks since we last updated\n * within start and end as constraints\n * @param _to Block number of the ending point.\n * @return multiplier Multiplier over the given _from to _to block.\n */\n function getCampaignMultiplier(uint256 _to)\n internal\n view\n returns (uint256)\n {\n uint256 from = pool.lastRewardBlock;\n if (from > endBlock) {\n return 0;\n } else {\n return (_to < endBlock ? _to : endBlock).sub(from);\n }\n }\n\n /**\n * @dev View function to see pending rewards for each account on frontend.\n * @param _user Address of the account we're looking up.\n * @return reward Total rewards owed to this account.\n */\n function pendingRewards(address _user) external view returns (uint256) {\n UserInfo storage user = userInfo[_user];\n return _pendingRewards(user);\n }\n\n function _pendingRewards(UserInfo storage user)\n internal\n view\n returns (uint256)\n {\n uint256 accRewardPerShare = pool.accRewardPerShare;\n if (block.number > pool.lastRewardBlock) {\n if (totalSupply != 0) {\n uint256 multiplier = getCampaignMultiplier(block.number);\n uint256 incReward = multiplier.mul(rewardPerBlock);\n accRewardPerShare = accRewardPerShare.add(\n incReward.divPrecisely(totalSupply)\n );\n }\n }\n return\n subDebt(\n user.amount.mulTruncate(accRewardPerShare),\n user.rewardDebt\n );\n }\n\n /**\n * @dev View function to see total outstanding rewards for the entire contract.\n * This is how much is owed when everyone pulls out.\n * @return reward Total rewards owed to everyone.\n */\n function totalOutstandingRewards() external view returns (uint256) {\n if (block.number > pool.lastRewardBlock && totalSupply != 0) {\n uint256 multiplier = getCampaignMultiplier(block.number);\n uint256 incReward = multiplier.mul(rewardPerBlock);\n uint256 accRewardPerShare = pool.accRewardPerShare;\n accRewardPerShare = accRewardPerShare.add(\n incReward.divPrecisely(totalSupply)\n );\n return\n subDebt(\n accRewardPerShare.mulTruncate(totalSupply),\n totalRewardDebt\n );\n }\n // no supply or not even started\n return 0;\n }\n\n /**\n * @dev External call for updating the pool.\n */\n function doUpdatePool() external {\n // There should be no harm allowing anyone to call this function.\n // It just updates the latest accRewardPerShare for the pool.\n updatePool();\n }\n\n /**\n * @dev Update the Liquidity Pool reward multiplier.\n * This locks in the accRewardPerShare from the last update block number to now.\n * Will fail if we do not have enough to pay everyone.\n * Always call updatePool whenever the balance changes!\n */\n function updatePool() internal {\n if (\n block.number <= pool.lastRewardBlock ||\n endBlock <= pool.lastRewardBlock\n ) {\n return;\n }\n\n if (totalSupply == 0) {\n pool.lastRewardBlock = block.number;\n return;\n }\n\n uint256 incReward = getCampaignMultiplier(block.number).mul(\n rewardPerBlock\n );\n // we are of course assuming lpTokens are in 1e18 precision\n uint256 accRewardPerShare = pool.accRewardPerShare.add(\n incReward.divPrecisely(totalSupply)\n );\n\n pool.accRewardPerShare = accRewardPerShare;\n pool.lastRewardBlock = block.number;\n }\n\n /**\n * @dev Deposit LP tokens into contract, must be preapproved.\n * @param _amount Amount of LPToken to deposit.\n */\n function deposit(uint256 _amount) external {\n UserInfo storage user = userInfo[msg.sender];\n updatePool();\n if (_amount > 0) {\n user.amount = user.amount.add(_amount);\n // newDebt is equal to the change in amount * accRewardPerShare (note accRewardPerShare is historic)\n int256 newDebt = int256(\n _amount.mulTruncate(pool.accRewardPerShare)\n );\n user.rewardDebt += newDebt;\n totalRewardDebt += newDebt;\n totalSupply = totalSupply.add(_amount);\n emit Deposit(msg.sender, _amount);\n pool.lpToken.safeTransferFrom(\n address(msg.sender),\n address(this),\n _amount\n );\n }\n }\n\n /**\n * @dev Exit out of the contract completely, withdraw LP tokens and claim rewards\n */\n function exit() external {\n UserInfo storage user = userInfo[msg.sender];\n // withdraw everything\n _withdraw(user, user.amount, true);\n }\n\n /**\n * @dev Withdraw LP tokens from contract.\n * @param _amount Amount of LPToken to withdraw.\n * @param _claim Boolean do we want to claim our rewards or not\n */\n function withdraw(uint256 _amount, bool _claim) external {\n UserInfo storage user = userInfo[msg.sender];\n _withdraw(user, _amount, _claim);\n }\n\n function _withdraw(\n UserInfo storage user,\n uint256 _amount,\n bool _claim\n ) internal {\n require(user.amount >= _amount, \"withdraw: overflow\");\n updatePool();\n\n // newDebt is equal to the change in amount * accRewardPerShare (note accRewardPerShare is historic)\n int256 newDebt = -int256(_amount.mulTruncate(pool.accRewardPerShare));\n uint256 pending = 0;\n if (_claim) {\n //This is an optimization so we don't modify the storage variable twice\n pending = subDebt(\n user.amount.mulTruncate(pool.accRewardPerShare),\n user.rewardDebt\n );\n\n newDebt += int256(pending);\n }\n\n user.rewardDebt += newDebt;\n totalRewardDebt += newDebt;\n emit Withdraw(msg.sender, _amount);\n // actually make the changes to the amount and debt\n if (_amount > 0) {\n user.amount = user.amount.sub(_amount);\n totalSupply = totalSupply.sub(_amount, \"withdraw: total overflow\");\n }\n //putting this all at the end to avoid reentrancy error\n if (pending > 0) {\n emit Claim(msg.sender, pending);\n reward.safeTransfer(msg.sender, pending);\n }\n if (_amount > 0) {\n pool.lpToken.safeTransfer(address(msg.sender), _amount);\n }\n }\n\n /**\n * @dev Claim all pending rewards up to current block\n */\n function claim() external {\n UserInfo storage user = userInfo[msg.sender];\n uint256 pending = _pendingRewards(user);\n if (pending > 0) {\n emit Claim(msg.sender, pending);\n int256 debtDelta = int256(pending);\n user.rewardDebt += debtDelta;\n totalRewardDebt += debtDelta;\n reward.safeTransfer(msg.sender, pending);\n }\n }\n\n function subDebt(uint256 amount, int256 debt)\n internal\n pure\n returns (uint256 result)\n {\n if (debt < 0) {\n result = amount.add(uint256(-debt));\n } else {\n result = amount.sub(uint256(debt));\n }\n }\n}\n" + }, + "contracts/mocks/BeaconChainDepositContractMock.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract BeaconChainDepositContractMock {\n /// @notice A processed deposit event.\n event DepositEvent(\n bytes pubkey,\n bytes withdrawal_credentials,\n bytes amount,\n bytes signature,\n bytes index\n );\n\n /// @notice Submit a Phase 0 DepositData object.\n /// @param pubkey A BLS12-381 public key.\n /// @param withdrawal_credentials Commitment to a public key for withdrawals.\n /// @param signature A BLS12-381 signature.\n /// @param deposit_data_root The SHA-256 hash of the SSZ-encoded DepositData object.\n /// Used as a protection against malformed input.\n function deposit(\n bytes calldata pubkey,\n bytes calldata withdrawal_credentials,\n bytes calldata signature,\n bytes32 deposit_data_root\n ) external payable {\n // Extended ABI length checks since dynamic types are used.\n require(pubkey.length == 48, \"DepositContract: invalid pubkey length\");\n require(\n withdrawal_credentials.length == 32,\n \"DepositContract: invalid withdrawal_credentials length\"\n );\n require(\n signature.length == 96,\n \"DepositContract: invalid signature length\"\n );\n\n // Check deposit amount\n require(msg.value >= 1 ether, \"DepositContract: deposit value too low\");\n require(\n msg.value % 1 gwei == 0,\n \"DepositContract: deposit value not multiple of gwei\"\n );\n uint256 deposit_amount = msg.value / 1 gwei;\n require(\n deposit_amount <= type(uint64).max,\n \"DepositContract: deposit value too high\"\n );\n require(\n deposit_data_root != 0,\n \"DepositContract: invalid deposit_data_root\"\n );\n }\n}\n" + }, + "contracts/mocks/BurnableERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\ninterface IBurnableERC20 {\n function burn(uint256 value) external returns (bool);\n\n function burnFrom(address account, uint256 value) external returns (bool);\n}\n\n/**\n * @title BurnableERC20\n * @dev Exposes the burn function of ERC20 for tests\n */\nabstract contract BurnableERC20 is IBurnableERC20, ERC20 {\n /**\n * @dev Function to burn tokens\n * @param value The amount of tokens to burn.\n * @return A boolean that indicates if the operation was successful.\n */\n function burn(uint256 value) public virtual override returns (bool) {\n _burn(msg.sender, value);\n return true;\n }\n\n /**\n * @dev Function to burn tokens from a specific account\n * @param account The address with the tokens to burn.\n * @param value The amount of tokens to burn.\n * @return A boolean that indicates if the operation was successful.\n */\n function burnFrom(address account, uint256 value)\n public\n override\n returns (bool)\n {\n _burn(account, value);\n return true;\n }\n}\n" + }, + "contracts/mocks/curve/Mock3CRV.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC20, MintableERC20 } from \"../MintableERC20.sol\";\nimport { BurnableERC20 } from \"../BurnableERC20.sol\";\n\ncontract Mock3CRV is MintableERC20, BurnableERC20 {\n constructor() ERC20(\"Curve.fi DAI/USDC/USDT\", \"3Crv\") {}\n\n function decimals() public pure override returns (uint8) {\n return 18;\n }\n}\n" + }, + "contracts/mocks/curve/MockBooster.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { MockRewardPool } from \"./MockRewardPool.sol\";\n\nimport { IRewardStaking } from \"../../strategies/IRewardStaking.sol\";\nimport { IMintableERC20, MintableERC20, ERC20 } from \"../MintableERC20.sol\";\nimport { IBurnableERC20, BurnableERC20 } from \"../BurnableERC20.sol\";\n\ncontract MockDepositToken is MintableERC20, BurnableERC20 {\n constructor() ERC20(\"DCVX\", \"CVX Deposit Token\") {}\n}\n\ncontract MockBooster {\n using SafeERC20 for IERC20;\n\n struct PoolInfo {\n address lptoken;\n address token;\n address crvRewards;\n }\n\n address public minter; // this is CVx for the booster on live\n address public crv; // Curve rewards token\n address public cvx; // Convex rewards token\n mapping(uint256 => PoolInfo) public poolInfo;\n\n constructor(\n address _rewardsMinter,\n address _crv,\n address _cvx\n ) public {\n minter = _rewardsMinter;\n crv = _crv;\n cvx = _cvx;\n }\n\n function setPool(uint256 pid, address _lpToken)\n external\n returns (address rewards)\n {\n address token = address(new MockDepositToken());\n // Deploy a new Convex Rewards Pool\n rewards = address(\n new MockRewardPool(pid, token, crv, cvx, address(this))\n );\n\n poolInfo[pid] = PoolInfo({\n lptoken: _lpToken,\n token: token,\n crvRewards: rewards\n });\n }\n\n function deposit(\n uint256 _pid,\n uint256 _amount,\n bool _stake\n ) public returns (bool) {\n PoolInfo storage pool = poolInfo[_pid];\n\n address lptoken = pool.lptoken;\n\n // hold on to the Curve LP tokens\n IERC20(lptoken).safeTransferFrom(msg.sender, address(this), _amount);\n\n address token = pool.token;\n if (_stake) {\n // mint Convex pool LP tokens and stake in rewards contract on user behalf\n IMintableERC20(token).mint(_amount);\n address rewardContract = pool.crvRewards;\n IERC20(token).safeApprove(rewardContract, 0);\n IERC20(token).safeApprove(rewardContract, _amount);\n IRewardStaking(rewardContract).stakeFor(msg.sender, _amount);\n } else {\n // mint Convex pool LP tokens and send to user\n IMintableERC20(token).mint(_amount);\n IERC20(token).transfer(msg.sender, _amount);\n }\n return true;\n }\n\n // Deposit all Curve LP tokens and stake\n function depositAll(uint256 _pid, bool _stake) external returns (bool) {\n address lptoken = poolInfo[_pid].lptoken;\n uint256 balance = IERC20(lptoken).balanceOf(msg.sender);\n deposit(_pid, balance, _stake);\n return true;\n }\n\n // withdraw Curve LP tokens\n function _withdraw(\n uint256 _pid,\n uint256 _amount,\n address _from,\n address _to\n ) internal {\n PoolInfo storage pool = poolInfo[_pid];\n\n // burn the Convex pool LP tokens\n IBurnableERC20(pool.token).burnFrom(_from, _amount);\n\n // return the Curve LP tokens\n IERC20(pool.lptoken).safeTransfer(_to, _amount);\n }\n\n // withdraw Curve LP tokens\n function withdraw(uint256 _pid, uint256 _amount) public returns (bool) {\n _withdraw(_pid, _amount, msg.sender, msg.sender);\n return true;\n }\n\n // withdraw all Curve LP tokens\n function withdrawAll(uint256 _pid) public returns (bool) {\n address token = poolInfo[_pid].token;\n uint256 userBal = IERC20(token).balanceOf(msg.sender);\n withdraw(_pid, userBal);\n return true;\n }\n\n // allow reward contracts to send here and withdraw to user\n function withdrawTo(\n uint256 _pid,\n uint256 _amount,\n address _to\n ) external returns (bool) {\n address rewardContract = poolInfo[_pid].crvRewards;\n require(msg.sender == rewardContract, \"!auth\");\n\n _withdraw(_pid, _amount, msg.sender, _to);\n return true;\n }\n\n // callback from reward contract when crv is received.\n function rewardClaimed(\n uint256 _pid,\n // solhint-disable-next-line no-unused-vars\n address _address,\n uint256 _amount\n ) external returns (bool) {\n address rewardContract = poolInfo[_pid].crvRewards;\n require(msg.sender == rewardContract, \"!auth\");\n\n //mint reward tokens\n // and transfer it\n IMintableERC20(minter).mint(_amount);\n IERC20(minter).transfer(msg.sender, _amount);\n return true;\n }\n}\n" + }, + "contracts/mocks/curve/MockCRV.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../MintableERC20.sol\";\n\ncontract MockCRV is MintableERC20 {\n constructor() ERC20(\"Curve DAO Token\", \"CRV\") {}\n\n function decimals() public pure override returns (uint8) {\n return 18;\n }\n}\n" + }, + "contracts/mocks/curve/MockCRVMinter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\nimport { IMintableERC20 } from \"../MintableERC20.sol\";\n\ncontract MockCRVMinter {\n address crv;\n\n constructor(address _crv) {\n crv = _crv;\n }\n\n function mint(address _address) external {\n uint256 amount = 2e18;\n IMintableERC20(crv).mint(amount);\n IERC20(crv).transfer(_address, amount);\n }\n}\n" + }, + "contracts/mocks/curve/MockCurveAbstractMetapool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\nimport { MintableERC20, IMintableERC20 } from \"../MintableERC20.sol\";\nimport { StableMath } from \"../../utils/StableMath.sol\";\nimport \"../../utils/Helpers.sol\";\n\nabstract contract MockCurveAbstractMetapool is MintableERC20 {\n using StableMath for uint256;\n\n address[] public coins;\n uint256[2] public balances;\n\n // Returns the same amount of LP tokens in 1e18 decimals\n function add_liquidity(uint256[2] calldata _amounts, uint256 _minAmount)\n external\n returns (uint256 lpAmount)\n {\n for (uint256 i = 0; i < _amounts.length; i++) {\n if (_amounts[i] > 0) {\n IERC20(coins[i]).transferFrom(\n msg.sender,\n address(this),\n _amounts[i]\n );\n uint256 assetDecimals = Helpers.getDecimals(coins[i]);\n // Convert to 1e18 and add to sum\n lpAmount += _amounts[i].scaleBy(18, assetDecimals);\n balances[i] = balances[i] + _amounts[i];\n }\n }\n // Hacky way of simulating slippage to check _minAmount\n if (lpAmount == 29000e18) lpAmount = 14500e18;\n require(lpAmount >= _minAmount, \"Slippage ruined your day\");\n // Send LP token to sender, e.g. 3CRV\n _mint(msg.sender, lpAmount);\n }\n\n // Dumb implementation that returns the same amount\n function calc_withdraw_one_coin(uint256 _amount, int128 _index)\n public\n view\n returns (uint256 lpAmount)\n {\n uint256 assetDecimals = Helpers.getDecimals(coins[uint128(_index)]);\n lpAmount = _amount.scaleBy(assetDecimals, 18);\n }\n\n function remove_liquidity_one_coin(\n uint256 _lpAmount,\n int128 _index,\n // solhint-disable-next-line no-unused-vars\n uint256 _minAmount\n ) external returns (uint256 amount) {\n _burn(msg.sender, _lpAmount);\n uint256[] memory amounts = new uint256[](coins.length);\n amounts[uint128(_index)] = _lpAmount;\n amount = calc_withdraw_one_coin(_lpAmount, _index);\n balances[uint128(_index)] -= amount;\n IERC20(coins[uint128(_index)]).transfer(msg.sender, amount);\n }\n\n function get_virtual_price() external pure returns (uint256) {\n return 1e18;\n }\n\n // solhint-disable-next-line no-unused-vars\n function remove_liquidity(uint256 _amount, uint256[2] memory _min_amounts)\n public\n returns (uint256[2] memory amounts)\n {\n _burn(msg.sender, _amount);\n uint256 totalSupply = totalSupply();\n for (uint256 i = 0; i < 2; i++) {\n amounts[i] = totalSupply > 0\n ? (_amount * IERC20(coins[i]).balanceOf(address(this))) /\n totalSupply\n : IERC20(coins[i]).balanceOf(address(this));\n balances[i] -= amounts[i];\n IERC20(coins[i]).transfer(msg.sender, amounts[i]);\n }\n }\n\n function remove_liquidity_imbalance(\n uint256[2] memory _amounts,\n uint256 _max_burned_tokens\n ) public returns (uint256) {\n return\n _remove_liquidity_imbalance(\n _amounts,\n _max_burned_tokens,\n msg.sender\n );\n }\n\n function remove_liquidity_imbalance(\n uint256[2] memory _amounts,\n uint256 _max_burned_tokens,\n address _reveiver\n ) public returns (uint256) {\n return\n _remove_liquidity_imbalance(\n _amounts,\n _max_burned_tokens,\n _reveiver\n );\n }\n\n function _remove_liquidity_imbalance(\n uint256[2] memory _amounts,\n uint256 _max_burned_tokens,\n address _reveiver\n ) internal returns (uint256 lpTokens) {\n lpTokens = _max_burned_tokens;\n _burn(msg.sender, lpTokens);\n for (uint256 i = 0; i < _amounts.length; i++) {\n balances[i] -= _amounts[i];\n if (_amounts[i] > 0) {\n IERC20(coins[i]).transfer(_reveiver, _amounts[i]);\n }\n }\n }\n\n // Dumb implementation that sums the scaled amounts\n function calc_token_amount(uint256[2] memory _amounts, bool)\n public\n view\n returns (uint256 lpTokens)\n {\n for (uint256 i = 0; i < _amounts.length; i++) {\n uint256 assetDecimals = Helpers.getDecimals(coins[i]);\n // Convert to 1e18 and add to lpTokens\n lpTokens += _amounts[i].scaleBy(18, assetDecimals);\n }\n }\n\n /// @notice 0.02% fee\n function fee() external pure returns (uint256) {\n return 2000000;\n }\n\n function decimals() public pure override returns (uint8) {\n return 18;\n }\n\n function burnFrom(address from, uint256 value) public {\n _burn(from, value);\n }\n}\n" + }, + "contracts/mocks/curve/MockCurveGauge.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\nimport { ICurveGauge } from \"../../strategies/ICurveGauge.sol\";\n\ncontract MockCurveGauge is ICurveGauge {\n mapping(address => uint256) private _balances;\n address lpToken;\n\n constructor(address _lpToken) {\n lpToken = _lpToken;\n }\n\n function balanceOf(address account) public view override returns (uint256) {\n return _balances[account];\n }\n\n function deposit(uint256 _value, address _account) external override {\n IERC20(lpToken).transferFrom(msg.sender, address(this), _value);\n _balances[_account] += _value;\n }\n\n function withdraw(uint256 _value) external override {\n IERC20(lpToken).transfer(msg.sender, _value);\n // solhint-disable-next-line reentrancy\n _balances[msg.sender] -= _value;\n }\n}\n" + }, + "contracts/mocks/curve/MockCurveLUSDMetapool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { MockCurveAbstractMetapool } from \"./MockCurveAbstractMetapool.sol\";\nimport \"../MintableERC20.sol\";\n\ncontract MockCurveLUSDMetapool is MockCurveAbstractMetapool {\n constructor(address[2] memory _coins)\n ERC20(\"Curve.fi Factory USD Metapool: LUSD\", \"LUSD3CRV-f\")\n {\n coins = _coins;\n }\n}\n" + }, + "contracts/mocks/curve/MockCurveMetapool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { MockCurveAbstractMetapool } from \"./MockCurveAbstractMetapool.sol\";\nimport \"../MintableERC20.sol\";\n\ncontract MockCurveMetapool is MockCurveAbstractMetapool {\n constructor(address[2] memory _coins)\n ERC20(\"Curve.fi 3pool/OUSD metapool\", \"3crv_OUSD\")\n {\n coins = _coins;\n }\n}\n" + }, + "contracts/mocks/curve/MockCurvePool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { IBurnableERC20 } from \"../BurnableERC20.sol\";\n\nimport { IMintableERC20 } from \"../MintableERC20.sol\";\nimport { ICurvePool } from \"../../strategies/ICurvePool.sol\";\nimport { StableMath } from \"../../utils/StableMath.sol\";\nimport \"../../utils/Helpers.sol\";\n\ncontract MockCurvePool {\n using StableMath for uint256;\n\n address[] public coins;\n uint256[3] public balances;\n address lpToken;\n uint256 public slippage = 1 ether;\n\n constructor(address[3] memory _coins, address _lpToken) {\n coins = _coins;\n lpToken = _lpToken;\n }\n\n function setCoins(address[] memory _coins) external {\n coins = _coins;\n }\n\n // Returns the same amount of LP tokens in 1e18 decimals\n function add_liquidity(uint256[3] calldata _amounts, uint256 _minAmount)\n external\n {\n uint256 sum = 0;\n for (uint256 i = 0; i < _amounts.length; i++) {\n if (_amounts[i] > 0) {\n IERC20(coins[i]).transferFrom(\n msg.sender,\n address(this),\n _amounts[i]\n );\n uint256 assetDecimals = Helpers.getDecimals(coins[i]);\n // Convert to 1e18 and add to sum\n sum += _amounts[i].scaleBy(18, assetDecimals);\n balances[i] = balances[i] + _amounts[i];\n }\n }\n // Hacky way of simulating slippage to check _minAmount\n if (sum == 29000e18) sum = 14500e18;\n require(sum >= _minAmount, \"Slippage ruined your day\");\n // Send LP token to sender, e.g. 3CRV\n IMintableERC20(lpToken).mint(sum);\n IERC20(lpToken).transfer(msg.sender, sum);\n }\n\n // Dumb implementation that returns the same amount\n function calc_withdraw_one_coin(uint256 _amount, int128 _index)\n public\n view\n returns (uint256)\n {\n uint256 assetDecimals = Helpers.getDecimals(coins[uint128(_index)]);\n return _amount.scaleBy(assetDecimals, 18);\n }\n\n function remove_liquidity_one_coin(\n uint256 _amount,\n int128 _index,\n // solhint-disable-next-line no-unused-vars\n uint256 _minAmount\n ) external {\n // Burn the Curve LP tokens\n IBurnableERC20(lpToken).burnFrom(msg.sender, _amount);\n uint256[] memory amounts = new uint256[](coins.length);\n amounts[uint128(_index)] = _amount;\n uint256 coinAmount = calc_withdraw_one_coin(_amount, _index);\n balances[uint128(_index)] -= coinAmount;\n IERC20(coins[uint128(_index)]).transfer(msg.sender, coinAmount);\n }\n\n function get_virtual_price() external pure returns (uint256) {\n return 1e18;\n }\n\n // solhint-disable-next-line no-unused-vars\n function remove_liquidity(uint256 _lpAmount, uint256[3] memory _min_amounts)\n public\n {\n // Burn the Curve LP tokens\n IBurnableERC20(lpToken).burnFrom(msg.sender, _lpAmount);\n uint256 totalSupply = IERC20(lpToken).totalSupply();\n for (uint256 i = 0; i < 3; i++) {\n uint256 coinAmount = totalSupply > 0\n ? (_lpAmount * IERC20(coins[i]).balanceOf(address(this))) /\n totalSupply\n : IERC20(coins[i]).balanceOf(address(this));\n balances[i] -= coinAmount;\n IERC20(coins[i]).transfer(msg.sender, coinAmount);\n }\n }\n\n function remove_liquidity_imbalance(\n uint256[3] memory _amounts,\n uint256 _max_burned_tokens\n ) public {\n // Burn the Curve LP tokens\n IBurnableERC20(lpToken).burnFrom(msg.sender, _max_burned_tokens);\n // For each coin, transfer to the caller\n for (uint256 i = 0; i < _amounts.length; i++) {\n balances[i] -= _amounts[i];\n if (_amounts[i] > 0) {\n IERC20(coins[i]).transfer(msg.sender, _amounts[i]);\n }\n }\n }\n\n // Dumb implementation that sums the scaled amounts\n function calc_token_amount(uint256[3] memory _amounts, bool)\n public\n view\n returns (uint256 lpTokens)\n {\n for (uint256 i = 0; i < _amounts.length; i++) {\n uint256 assetDecimals = Helpers.getDecimals(coins[i]);\n // Convert to 1e18 and add to lpTokens\n lpTokens += _amounts[i].scaleBy(18, assetDecimals);\n }\n }\n\n function fee() external pure returns (uint256) {\n return 1000000;\n }\n\n function exchange(\n uint256 coin0,\n uint256 coin1,\n uint256 amountIn,\n uint256 minAmountOut\n ) external returns (uint256 amountOut) {\n IERC20(coins[coin0]).transferFrom(msg.sender, address(this), amountIn);\n amountOut = (minAmountOut * slippage) / 1 ether;\n require(amountOut >= minAmountOut, \"Slippage error\");\n IMintableERC20(coins[coin1]).mintTo(msg.sender, amountOut);\n }\n\n function setSlippage(uint256 _slippage) external {\n slippage = _slippage;\n }\n}\n" + }, + "contracts/mocks/curve/MockCVX.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../MintableERC20.sol\";\n\ncontract MockCVX is MintableERC20 {\n constructor() ERC20(\"CVX\", \"CVX DAO Token\") {}\n}\n" + }, + "contracts/mocks/curve/MockLUSD.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../MintableERC20.sol\";\n\ncontract MockLUSD is MintableERC20 {\n constructor() ERC20(\"LUSD\", \"Liquity Token\") {}\n}\n" + }, + "contracts/mocks/curve/MockRewardPool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IMintableERC20 } from \"../MintableERC20.sol\";\nimport \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\n\ninterface IDeposit {\n function poolInfo(uint256)\n external\n view\n returns (\n address,\n address,\n address,\n address,\n address,\n bool\n );\n\n function rewardClaimed(\n uint256,\n address,\n uint256\n ) external;\n\n function withdrawTo(\n uint256,\n uint256,\n address\n ) external;\n}\n\ncontract MockRewardPool {\n using SafeMath for uint256;\n using SafeERC20 for IERC20;\n\n uint256 public pid;\n address public stakingToken;\n address public rewardTokenA;\n address public rewardTokenB;\n address public operator;\n\n uint256 private _totalSupply;\n\n mapping(address => uint256) private _balances;\n mapping(address => uint256) public rewards;\n\n constructor(\n uint256 _pid,\n address _stakingToken,\n address _rewardTokenA,\n address _rewardTokenB,\n address _operator\n ) public {\n pid = _pid;\n stakingToken = _stakingToken;\n rewardTokenA = _rewardTokenA;\n rewardTokenB = _rewardTokenB;\n operator = _operator;\n }\n\n function totalSupply() public view returns (uint256) {\n return _totalSupply;\n }\n\n function balanceOf(address account) public view returns (uint256) {\n return _balances[account];\n }\n\n function stakeFor(address _for, uint256 _amount) public returns (bool) {\n require(_amount > 0, \"RewardPool : Cannot stake 0\");\n\n //give to _for\n _totalSupply = _totalSupply.add(_amount);\n _balances[_for] = _balances[_for].add(_amount);\n\n //take away from sender\n IERC20(stakingToken).safeTransferFrom(\n msg.sender,\n address(this),\n _amount\n );\n\n return true;\n }\n\n function withdrawAndUnwrap(uint256 amount, bool claim)\n public\n returns (bool)\n {\n _totalSupply = _totalSupply.sub(amount);\n _balances[msg.sender] = _balances[msg.sender].sub(amount);\n\n //tell operator to withdraw from here directly to user\n IDeposit(operator).withdrawTo(pid, amount, msg.sender);\n\n //get rewards too\n if (claim) {\n getReward(msg.sender, true);\n }\n return true;\n }\n\n function withdrawAllAndUnwrap(bool claim) external {\n withdrawAndUnwrap(_balances[msg.sender], claim);\n }\n\n // solhint-disable-next-line no-unused-vars\n function getReward(address _account, bool _claimExtras)\n public\n returns (bool)\n {\n IMintableERC20(rewardTokenA).mint(2 * 1e18);\n IERC20(rewardTokenA).transfer(_account, 2 * 1e18);\n\n IMintableERC20(rewardTokenB).mint(3 * 1e18);\n IERC20(rewardTokenB).transfer(_account, 3 * 1e18);\n\n return true;\n }\n\n function getReward() public returns (bool) {\n getReward(msg.sender, true);\n }\n}\n" + }, + "contracts/mocks/MintableERC20.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\ninterface IMintableERC20 {\n function mint(uint256 value) external;\n\n function mintTo(address to, uint256 value) external;\n}\n\n/**\n * @title MintableERC20\n * @dev Exposes the mint function of ERC20 for tests\n */\nabstract contract MintableERC20 is IMintableERC20, ERC20 {\n /**\n * @dev Function to mint tokens\n * @param _value The amount of tokens to mint.\n */\n function mint(uint256 _value) public virtual override {\n _mint(msg.sender, _value);\n }\n\n /**\n * @dev Function to mint tokens\n * @param _to Address to mint to.\n * @param _value The amount of tokens to mint.\n */\n function mintTo(address _to, uint256 _value) public virtual override {\n _mint(_to, _value);\n }\n}\n" + }, + "contracts/mocks/Mock1InchSwapRouter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { SwapDescription } from \"../interfaces/IOneInch.sol\";\n\ncontract Mock1InchSwapRouter {\n using SafeERC20 for IERC20;\n\n event MockSwap(address executor, bytes permitData, bytes executorData);\n\n event MockSwapDesc(\n address srcToken,\n address dstToken,\n address srcReceiver,\n address dstReceiver,\n uint256 amount,\n uint256 minReturnAmount,\n uint256 flags\n );\n\n event MockUnoswapTo(\n address recipient,\n address srcToken,\n uint256 amount,\n uint256 minReturn,\n uint256[] pools\n );\n\n event MockUniswapV3SwapTo(\n address recipient,\n uint256 amount,\n uint256 minReturn,\n uint256[] pools\n );\n\n /**\n * @dev transfers the shource asset and returns the minReturnAmount of the destination asset.\n */\n function swap(\n address executor,\n SwapDescription calldata desc,\n bytes calldata permitData,\n bytes calldata executorData\n ) public returns (uint256 returnAmount, uint256 spentAmount) {\n // Transfer the source tokens to the receiver contract\n IERC20(desc.srcToken).safeTransferFrom(\n msg.sender,\n desc.srcReceiver,\n desc.amount\n );\n\n // Transfer the destination tokens to the recipient\n IERC20(desc.dstToken).safeTransfer(\n desc.dstReceiver,\n desc.minReturnAmount\n );\n\n emit MockSwap(executor, permitData, executorData);\n _swapDesc(desc);\n returnAmount = 0;\n spentAmount = 0;\n }\n\n function _swapDesc(SwapDescription calldata desc) public {\n emit MockSwapDesc(\n address(desc.srcToken),\n address(desc.dstToken),\n desc.srcReceiver,\n desc.dstReceiver,\n desc.amount,\n desc.minReturnAmount,\n desc.flags\n );\n }\n\n /**\n * @dev only transfers the source asset to this contract.\n * Ideally it would return the destination asset but that's encoded in the pools array.\n */\n function unoswapTo(\n address payable recipient,\n address srcToken,\n uint256 amount,\n uint256 minReturn,\n uint256[] calldata pools\n ) public returns (uint256 returnAmount) {\n // transfer the from asset from the caller\n IERC20(srcToken).safeTransferFrom(msg.sender, address(this), amount);\n\n emit MockUnoswapTo(recipient, srcToken, amount, minReturn, pools);\n returnAmount = 0;\n }\n\n /**\n * @dev does not do any transfers. Just emits MockUniswapV3SwapTo.\n */\n function uniswapV3SwapTo(\n address payable recipient,\n uint256 amount,\n uint256 minReturn,\n uint256[] calldata pools\n ) public returns (uint256 returnAmount) {\n emit MockUniswapV3SwapTo(recipient, amount, minReturn, pools);\n returnAmount = 0;\n }\n}\n" + }, + "contracts/mocks/MockAave.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20, ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\nimport { MintableERC20 } from \"./MintableERC20.sol\";\nimport { IAaveLendingPool, ILendingPoolAddressesProvider } from \"../strategies/IAave.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\n// 1. User calls 'getLendingPool'\n// 2. User calls 'deposit' (Aave)\n// - Deposit their underlying\n// - Mint aToken to them\n// 3. User calls redeem (aToken)\n// - Retrieve their aToken\n// - Return equal amount of underlying\n\ncontract MockAToken is MintableERC20 {\n address public lendingPool;\n IERC20 public underlyingToken;\n using SafeERC20 for IERC20;\n\n constructor(\n address _lendingPool,\n string memory _name,\n string memory _symbol,\n IERC20 _underlyingToken\n ) ERC20(_name, _symbol) {\n lendingPool = _lendingPool;\n underlyingToken = _underlyingToken;\n // addMinter(_lendingPool);\n }\n\n function decimals() public view override returns (uint8) {\n return ERC20(address(underlyingToken)).decimals();\n }\n\n function poolRedeem(uint256 _amount, address _to) external {\n require(msg.sender == lendingPool, \"pool only\");\n // Redeem these a Tokens\n _burn(_to, _amount);\n // For the underlying\n underlyingToken.safeTransferFrom(lendingPool, _to, _amount);\n }\n}\n\ncontract MockAave is IAaveLendingPool, ILendingPoolAddressesProvider {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n mapping(address => address) reserveToAToken;\n address pool = address(this);\n address payable core = payable(address(this));\n uint256 factor;\n\n function addAToken(address _aToken, address _underlying) public {\n IERC20(_underlying).safeApprove(_aToken, 0);\n IERC20(_underlying).safeApprove(_aToken, type(uint256).max);\n reserveToAToken[_underlying] = _aToken;\n }\n\n // set the reserve factor / basically the interest on deposit\n // in 18 precision\n // so 0.5% would be 5 * 10 ^ 15\n function setFactor(uint256 factor_) public {\n factor = factor_;\n }\n\n function deposit(\n address _reserve,\n uint256 _amount,\n address _to,\n uint16 /*_referralCode*/\n ) external override {\n uint256 previousBal = IERC20(reserveToAToken[_reserve]).balanceOf(\n msg.sender\n );\n uint256 interest = previousBal.mulTruncate(factor);\n MintableERC20(reserveToAToken[_reserve]).mintTo(msg.sender, interest);\n // Take their reserve\n IERC20(_reserve).safeTransferFrom(msg.sender, address(this), _amount);\n // Credit them with aToken\n MintableERC20(reserveToAToken[_reserve]).mintTo(_to, _amount);\n }\n\n function withdraw(\n address asset,\n uint256 amount,\n address to\n ) external override returns (uint256) {\n MockAToken atoken = MockAToken(reserveToAToken[asset]);\n atoken.poolRedeem(amount, to);\n return amount;\n }\n\n function getLendingPool() external view override returns (address) {\n return pool;\n }\n}\n" + }, + "contracts/mocks/MockAaveIncentivesController.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { MockStkAave } from \"./MockStkAave.sol\";\n\ncontract MockAaveIncentivesController {\n mapping(address => uint256) private rewards;\n MockStkAave public REWARD_TOKEN;\n\n constructor(address _reward_token) {\n REWARD_TOKEN = MockStkAave(_reward_token);\n }\n\n function setRewardsBalance(address user, uint256 amount) external {\n rewards[user] = amount;\n }\n\n /**\n * @dev Returns the total of rewards of an user, already accrued + not yet accrued\n * @param user The address of the user\n * @return The rewards\n **/\n // solhint-disable-next-line no-unused-vars\n function getRewardsBalance(address[] calldata assets, address user)\n external\n view\n returns (uint256)\n {\n return rewards[user];\n }\n\n /**\n * @dev Claims reward for an user, on all the assets of the lending pool, accumulating the pending rewards\n * @param amount Amount of rewards to claim\n * @param to Address that will be receiving the rewards\n * @return Rewards claimed\n **/\n function claimRewards(\n // solhint-disable-next-line no-unused-vars\n address[] calldata assets,\n uint256 amount,\n address to\n ) external returns (uint256) {\n require(amount > 0);\n require(rewards[to] == amount);\n REWARD_TOKEN.mint(amount);\n require(REWARD_TOKEN.transfer(to, amount));\n // solhint-disable-next-line reentrancy\n rewards[to] = 0;\n return amount;\n }\n}\n" + }, + "contracts/mocks/MockAAVEToken.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockAAVEToken is MintableERC20 {\n constructor() ERC20(\"AAVE\", \"AAVE\") {}\n}\n" + }, + "contracts/mocks/MockAura.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockAura is MintableERC20 {\n constructor() ERC20(\"Aura\", \"AURA\") {}\n}\n" + }, + "contracts/mocks/MockBAL.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockBAL is MintableERC20 {\n constructor() ERC20(\"Balancer\", \"BAL\") {}\n}\n" + }, + "contracts/mocks/MockBalancerVault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { IBalancerVault } from \"../interfaces/balancer/IBalancerVault.sol\";\nimport { MintableERC20 } from \"./MintableERC20.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\n// import \"hardhat/console.sol\";\n\ncontract MockBalancerVault {\n using StableMath for uint256;\n uint256 public slippage = 1 ether;\n bool public transferDisabled = false;\n bool public slippageErrorDisabled = false;\n\n function swap(\n IBalancerVault.SingleSwap calldata singleSwap,\n IBalancerVault.FundManagement calldata funds,\n uint256 minAmountOut,\n uint256\n ) external returns (uint256 amountCalculated) {\n amountCalculated = (minAmountOut * slippage) / 1 ether;\n if (!slippageErrorDisabled) {\n require(amountCalculated >= minAmountOut, \"Slippage error\");\n }\n IERC20(singleSwap.assetIn).transferFrom(\n funds.sender,\n address(this),\n singleSwap.amount\n );\n if (!transferDisabled) {\n MintableERC20(singleSwap.assetOut).mintTo(\n funds.recipient,\n amountCalculated\n );\n }\n }\n\n function setSlippage(uint256 _slippage) external {\n slippage = _slippage;\n }\n\n function getPoolTokenInfo(bytes32 poolId, address token)\n external\n view\n returns (\n uint256,\n uint256,\n uint256,\n address\n )\n {}\n\n function disableTransfer() external {\n transferDisabled = true;\n }\n\n function disableSlippageError() external {\n slippageErrorDisabled = true;\n }\n}\n" + }, + "contracts/mocks/MockBuyback.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { BaseBuyback } from \"../buyback/BaseBuyback.sol\";\n\ncontract MockBuyback is BaseBuyback {\n constructor(\n address _oToken,\n address _ogv,\n address _cvx,\n address _cvxLocker\n ) BaseBuyback(_oToken, _ogv, _cvx, _cvxLocker) {}\n}\n" + }, + "contracts/mocks/MockChainlinkOracleFeed.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\n\ncontract MockChainlinkOracleFeed is AggregatorV3Interface {\n int256 price;\n uint8 numDecimals;\n\n constructor(int256 _price, uint8 _decimals) {\n price = _price;\n numDecimals = _decimals;\n }\n\n function decimals() external view override returns (uint8) {\n return numDecimals;\n }\n\n function description() external pure override returns (string memory) {\n return \"MockOracleEthFeed\";\n }\n\n function version() external pure override returns (uint256) {\n return 1;\n }\n\n function setPrice(int256 _price) public {\n price = _price;\n }\n\n function setDecimals(uint8 _decimals) public {\n numDecimals = _decimals;\n }\n\n // getRoundData and latestRoundData should both raise \"No data present\"\n // if they do not have data to report, instead of returning unset values\n // which could be misinterpreted as actual reported values.\n function getRoundData(uint80 _roundId)\n external\n view\n override\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n )\n {\n roundId = _roundId;\n answer = price;\n startedAt = 0;\n updatedAt = 0;\n answeredInRound = 0;\n }\n\n function latestRoundData()\n external\n view\n override\n returns (\n uint80 roundId,\n int256 answer,\n uint256 startedAt,\n uint256 updatedAt,\n uint80 answeredInRound\n )\n {\n roundId = 0;\n answer = price;\n startedAt = 0;\n updatedAt = block.timestamp;\n answeredInRound = 0;\n }\n}\n" + }, + "contracts/mocks/MockCOMP.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockCOMP is MintableERC20 {\n constructor() ERC20(\"COMP\", \"COMP\") {}\n}\n" + }, + "contracts/mocks/MockComptroller.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract MockComptroller {\n // Claim all the COMP accrued by specific holders in specific markets for their supplies and/or borrows\n function claimComp(\n address[] memory holders,\n address[] memory cTokens,\n bool borrowers,\n bool suppliers\n ) external {}\n}\n" + }, + "contracts/mocks/MockCToken.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20, ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\nimport { ICERC20 } from \"../strategies/ICompound.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\ncontract MockCToken is ICERC20, ERC20 {\n using StableMath for uint256;\n\n IERC20 public underlyingToken;\n // underlying = cToken * exchangeRate\n // cToken = underlying / exchangeRate\n uint256 exchangeRate;\n address public override comptroller;\n\n constructor(ERC20 _underlyingToken, address _comptroller)\n ERC20(\"cMock\", \"cMK\")\n {\n uint8 underlyingDecimals = _underlyingToken.decimals();\n // if has 18 dp, exchange rate should be 1e26\n // if has 8 dp, exchange rate should be 1e18\n if (underlyingDecimals > 8) {\n exchangeRate = 10**uint256(18 + underlyingDecimals - 10);\n } else if (underlyingDecimals < 8) {\n // e.g. 18-8+6 = 16\n exchangeRate = 10**uint256(18 - 8 + underlyingDecimals);\n } else {\n exchangeRate = 1e18;\n }\n underlyingToken = _underlyingToken;\n comptroller = _comptroller;\n }\n\n function decimals() public pure override returns (uint8) {\n return 8;\n }\n\n function mint(uint256 mintAmount) public override returns (uint256) {\n // Credit them with cToken\n _mint(msg.sender, mintAmount.divPrecisely(exchangeRate));\n // Take their reserve\n underlyingToken.transferFrom(msg.sender, address(this), mintAmount);\n return 0;\n }\n\n function redeem(uint256 redeemAmount) external override returns (uint256) {\n uint256 tokenAmount = redeemAmount.mulTruncate(exchangeRate);\n // Burn the cToken\n _burn(msg.sender, redeemAmount);\n // Transfer underlying to caller\n underlyingToken.transfer(msg.sender, tokenAmount);\n return 0;\n }\n\n function redeemUnderlying(uint256 redeemAmount)\n external\n override\n returns (uint256)\n {\n uint256 cTokens = redeemAmount.divPrecisely(exchangeRate);\n // Burn the cToken\n _burn(msg.sender, cTokens);\n // Transfer underlying to caller\n underlyingToken.transfer(msg.sender, redeemAmount);\n return 0;\n }\n\n function balanceOfUnderlying(address owner)\n external\n view\n override\n returns (uint256)\n {\n uint256 cTokenBal = this.balanceOf(owner);\n return cTokenBal.mulTruncate(exchangeRate);\n }\n\n function balanceOf(address owner)\n public\n view\n override(ICERC20, ERC20)\n returns (uint256)\n {\n return ERC20.balanceOf(owner);\n }\n\n function updateExchangeRate()\n internal\n view\n returns (uint256 newExchangeRate)\n {\n uint256 factor = 100002 * (10**13); // 0.002%\n newExchangeRate = exchangeRate.mulTruncate(factor);\n }\n\n function exchangeRateStored() external view override returns (uint256) {\n return exchangeRate;\n }\n\n function supplyRatePerBlock() external pure override returns (uint256) {\n return 141 * (10**8);\n }\n}\n" + }, + "contracts/mocks/MockCVXLocker.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\ncontract MockCVXLocker {\n address public immutable cvx;\n mapping(address => uint256) public lockedBalanceOf;\n\n constructor(address _cvx) {\n cvx = _cvx;\n }\n\n function lock(\n address _account,\n uint256 _amount,\n uint256\n ) external {\n lockedBalanceOf[_account] += _amount;\n ERC20(cvx).transferFrom(msg.sender, address(this), _amount);\n }\n\n function unlockAllTokens(address _account) external {\n lockedBalanceOf[_account] = 0;\n ERC20(cvx).transfer(_account, lockedBalanceOf[_account]);\n }\n}\n" + }, + "contracts/mocks/MockDAI.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockDAI is MintableERC20 {\n constructor() ERC20(\"DAI\", \"DAI\") {}\n}\n" + }, + "contracts/mocks/MockEvilDAI.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\n\ncontract MockEvilDAI is MintableERC20 {\n address host;\n address realCoin;\n\n constructor(address _host, address _realCoin) ERC20(\"DAI\", \"DAI\") {\n host = _host;\n realCoin = _realCoin;\n }\n\n function transferFrom(\n // solhint-disable-next-line no-unused-vars\n address _from,\n // solhint-disable-next-line no-unused-vars\n address _to,\n uint256 _amount\n ) public override returns (bool) {\n // call mint again!\n if (_amount != 69) {\n IVault(host).mint(address(this), 69, 0);\n }\n return true;\n }\n}\n" + }, + "contracts/mocks/MockEvilReentrantContract.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IVault } from \"../interfaces/IVault.sol\";\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { IRateProvider } from \"../interfaces/balancer/IRateProvider.sol\";\n\nimport { IBalancerVault } from \"../interfaces/balancer/IBalancerVault.sol\";\nimport { IERC20 } from \"../utils/InitializableAbstractStrategy.sol\";\n\nimport { StableMath } from \"../utils/StableMath.sol\";\n\ncontract MockEvilReentrantContract {\n using StableMath for uint256;\n\n IBalancerVault public immutable balancerVault;\n IERC20 public immutable reth;\n IERC20 public immutable weth;\n IVault public immutable oethVault;\n address public immutable poolAddress;\n bytes32 public immutable balancerPoolId;\n\n constructor(\n address _balancerVault,\n address _oethVault,\n address _reth,\n address _weth,\n address _poolAddress,\n bytes32 _poolId\n ) {\n balancerVault = IBalancerVault(_balancerVault);\n oethVault = IVault(_oethVault);\n reth = IERC20(_reth);\n weth = IERC20(_weth);\n poolAddress = _poolAddress;\n balancerPoolId = _poolId;\n }\n\n function doEvilStuff() public {\n address priceProvider = oethVault.priceProvider();\n uint256 rethPrice = IOracle(priceProvider).price(address(reth));\n\n // 1. Join pool\n uint256[] memory amounts = new uint256[](2);\n amounts[0] = uint256(10 ether);\n amounts[1] = rethPrice * 10;\n\n address[] memory assets = new address[](2);\n assets[0] = address(reth);\n assets[1] = address(weth);\n\n uint256 minBPT = getBPTExpected(assets, amounts).mulTruncate(\n 0.99 ether\n );\n\n bytes memory joinUserData = abi.encode(\n IBalancerVault.WeightedPoolJoinKind.EXACT_TOKENS_IN_FOR_BPT_OUT,\n amounts,\n minBPT\n );\n\n IBalancerVault.JoinPoolRequest memory joinRequest = IBalancerVault\n .JoinPoolRequest(assets, amounts, joinUserData, false);\n\n balancerVault.joinPool(\n balancerPoolId,\n address(this),\n address(this),\n joinRequest\n );\n\n uint256 bptTokenBalance = IERC20(poolAddress).balanceOf(address(this));\n\n // 2. Redeem as ETH\n bytes memory exitUserData = abi.encode(\n IBalancerVault.WeightedPoolExitKind.EXACT_BPT_IN_FOR_ONE_TOKEN_OUT,\n bptTokenBalance,\n 1\n );\n\n assets[1] = address(0); // Receive ETH instead of WETH\n uint256[] memory exitAmounts = new uint256[](2);\n exitAmounts[1] = 15 ether;\n IBalancerVault.ExitPoolRequest memory exitRequest = IBalancerVault\n .ExitPoolRequest(assets, exitAmounts, exitUserData, false);\n\n balancerVault.exitPool(\n balancerPoolId,\n address(this),\n payable(address(this)),\n exitRequest\n );\n bptTokenBalance = IERC20(poolAddress).balanceOf(address(this));\n }\n\n function getBPTExpected(address[] memory _assets, uint256[] memory _amounts)\n internal\n view\n virtual\n returns (uint256 bptExpected)\n {\n // Get the oracle from the OETH Vault\n address priceProvider = oethVault.priceProvider();\n\n for (uint256 i = 0; i < _assets.length; ++i) {\n uint256 strategyAssetMarketPrice = IOracle(priceProvider).price(\n _assets[i]\n );\n // convert asset amount to ETH amount\n bptExpected =\n bptExpected +\n _amounts[i].mulTruncate(strategyAssetMarketPrice);\n }\n\n uint256 bptRate = IRateProvider(poolAddress).getRate();\n // Convert ETH amount to BPT amount\n bptExpected = bptExpected.divPrecisely(bptRate);\n }\n\n function approveAllTokens() public {\n // Approve all tokens\n weth.approve(address(oethVault), type(uint256).max);\n reth.approve(poolAddress, type(uint256).max);\n weth.approve(poolAddress, type(uint256).max);\n reth.approve(address(balancerVault), type(uint256).max);\n weth.approve(address(balancerVault), type(uint256).max);\n }\n\n receive() external payable {\n // 3. Try to mint OETH\n oethVault.mint(address(weth), 1 ether, 0.9 ether);\n }\n}\n" + }, + "contracts/mocks/MockfrxETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockfrxETH is MintableERC20 {\n constructor() ERC20(\"frxETH\", \"frxETH\") {}\n}\n" + }, + "contracts/mocks/MockFrxETHMinter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockFrxETHMinter {\n address public immutable frxETH;\n address public immutable sfrxETH;\n\n constructor(address _frxETH, address _sfrxETH) {\n frxETH = _frxETH;\n sfrxETH = _sfrxETH;\n }\n\n function submitAndDeposit(address recipient)\n external\n payable\n returns (uint256 shares)\n {\n IMintableERC20(frxETH).mintTo(sfrxETH, msg.value);\n IMintableERC20(sfrxETH).mintTo(recipient, msg.value);\n shares = msg.value;\n }\n}\n" + }, + "contracts/mocks/MockLimitedWrappedOusd.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { WrappedOusd } from \"../token/WrappedOusd.sol\";\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\n\ncontract MockLimitedWrappedOusd is WrappedOusd {\n constructor(\n ERC20 underlying_,\n string memory name_,\n string memory symbol_\n ) WrappedOusd(underlying_, name_, symbol_) {}\n\n function maxDeposit(address)\n public\n view\n virtual\n override\n returns (uint256)\n {\n return 1e18;\n }\n}\n" + }, + "contracts/mocks/MockMetadataToken.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n// IERC20Metadata is used in the resolveAsset function in contracts/utils/assets.js\n// We just need to import it here to make its ABI available to Hardhat\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n" + }, + "contracts/mocks/MockMintableUniswapPair.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\nimport \"./MockUniswapPair.sol\";\n\ncontract MockMintableUniswapPair is MockUniswapPair, MintableERC20 {\n constructor(\n address _token0,\n address _token1,\n uint112 _reserve0,\n uint112 _reserve1\n )\n MockUniswapPair(_token0, _token1, _reserve0, _reserve1)\n ERC20(\"Uniswap V2\", \"UNI-v2\")\n {}\n\n function decimals() public pure override returns (uint8) {\n return 18;\n }\n}\n" + }, + "contracts/mocks/MockNonRebasing.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\nimport { IVault } from \"../interfaces/IVault.sol\";\n\nimport { OUSD } from \"../token/OUSD.sol\";\n\ncontract MockNonRebasing {\n OUSD oUSD;\n\n function setOUSD(address _oUSDAddress) public {\n oUSD = OUSD(_oUSDAddress);\n }\n\n function rebaseOptIn() public {\n oUSD.rebaseOptIn();\n }\n\n function rebaseOptOut() public {\n oUSD.rebaseOptOut();\n }\n\n function transfer(address _to, uint256 _value) public {\n oUSD.transfer(_to, _value);\n }\n\n function transferFrom(\n address _from,\n address _to,\n uint256 _value\n ) public {\n oUSD.transferFrom(_from, _to, _value);\n }\n\n function increaseAllowance(address _spender, uint256 _addedValue) public {\n oUSD.increaseAllowance(_spender, _addedValue);\n }\n\n function mintOusd(\n address _vaultContract,\n address _asset,\n uint256 _amount\n ) public {\n IVault(_vaultContract).mint(_asset, _amount, 0);\n }\n\n function redeemOusd(address _vaultContract, uint256 _amount) public {\n IVault(_vaultContract).redeem(_amount, 0);\n }\n\n function approveFor(\n address _contract,\n address _spender,\n uint256 _addedValue\n ) public {\n IERC20(_contract).approve(_spender, _addedValue);\n }\n}\n" + }, + "contracts/mocks/MockNonStandardToken.sol": { + "content": "pragma solidity ^0.8.0;\n\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\n\nimport \"./MintableERC20.sol\";\n\n/**\n * Mock token contract to simulate tokens that don't\n * throw/revert when a transfer/transferFrom call fails\n */\ncontract MockNonStandardToken is MintableERC20 {\n using SafeMath for uint256;\n\n constructor() ERC20(\"NonStandardToken\", \"NonStandardToken\") {}\n\n function decimals() public pure override returns (uint8) {\n return 6;\n }\n\n function transfer(address recipient, uint256 amount)\n public\n override\n returns (bool)\n {\n if (balanceOf(msg.sender) < amount) {\n // Fail silently\n return false;\n }\n\n _transfer(_msgSender(), recipient, amount);\n return true;\n }\n\n function transferFrom(\n address sender,\n address recipient,\n uint256 amount\n ) public override returns (bool) {\n if (balanceOf(sender) < amount) {\n // Fail silently\n return false;\n }\n\n _transfer(sender, recipient, amount);\n _approve(\n sender,\n _msgSender(),\n allowance(sender, _msgSender()).sub(\n amount,\n \"ERC20: transfer amount exceeds allowance\"\n )\n );\n return true;\n }\n}\n" + }, + "contracts/mocks/MockOETHVault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { OETHVaultCore } from \"../vault/OETHVaultCore.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport \"../utils/Helpers.sol\";\n\ncontract MockOETHVault is OETHVaultCore {\n using StableMath for uint256;\n\n constructor(address _weth) OETHVaultCore(_weth) {}\n\n function supportAsset(address asset) external {\n assets[asset] = Asset({\n isSupported: true,\n unitConversion: UnitConversion(0),\n decimals: 18,\n allowedOracleSlippageBps: 0\n });\n\n allAssets.push(asset);\n }\n}\n" + }, + "contracts/mocks/MockOGN.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./BurnableERC20.sol\";\nimport \"./MintableERC20.sol\";\n\n/**\n * @title Origin token (OGN).\n *\n * @dev Token that allows minting and burning.\n * @dev Important note:\n * @dev There is a known race condition in the ERC20 standard on the approve() method.\n * @dev See details: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\n * @dev The Origin token contract implements the increaseApproval() and decreaseApproval() methods.\n * @dev It is strongly recommended to use those methods rather than approve()\n * @dev when updating the token allowance.\n */\ncontract MockOGN is MintableERC20, BurnableERC20 {\n event SetWhitelistExpiration(uint256 expiration);\n event AllowedTransactorAdded(address sender);\n event AllowedTransactorRemoved(address sender);\n event AddCallSpenderWhitelist(address enabler, address spender);\n event RemoveCallSpenderWhitelist(address disabler, address spender);\n\n mapping(address => bool) public callSpenderWhitelist;\n address public owner = msg.sender;\n // UNIX timestamp (in seconds) after which this whitelist no longer applies\n uint256 public whitelistExpiration;\n // While the whitelist is active, either the sender or recipient must be\n // in allowedTransactors.\n mapping(address => bool) public allowedTransactors;\n\n // @dev Constructor that gives msg.sender all initial tokens.\n constructor(uint256 _initialSupply) ERC20(\"OriginToken\", \"OGN\") {\n owner = msg.sender;\n _mint(owner, _initialSupply);\n }\n\n //\n // approveAndCall methods\n //\n\n // @dev Add spender to whitelist of spenders for approveAndCall\n // @param _spender Address to add\n function addCallSpenderWhitelist(address _spender) public onlyOwner {\n callSpenderWhitelist[_spender] = true;\n emit AddCallSpenderWhitelist(msg.sender, _spender);\n }\n\n // @dev Remove spender from whitelist of spenders for approveAndCall\n // @param _spender Address to remove\n function removeCallSpenderWhitelist(address _spender) public onlyOwner {\n delete callSpenderWhitelist[_spender];\n emit RemoveCallSpenderWhitelist(msg.sender, _spender);\n }\n\n // @dev Approve transfer of tokens and make a contract call in a single\n // @dev transaction. This allows a DApp to avoid requiring two MetaMask\n // @dev approvals for a single logical action, such as creating a listing,\n // @dev which requires the seller to approve a token transfer and the\n // @dev marketplace contract to transfer tokens from the seller.\n //\n // @dev This is based on the ERC827 function approveAndCall and avoids\n // @dev security issues by only working with a whitelisted set of _spender\n // @dev addresses. The other difference is that the combination of this\n // @dev function ensures that the proxied function call receives the\n // @dev msg.sender for this function as its first parameter.\n //\n // @param _spender The address that will spend the funds.\n // @param _value The amount of tokens to be spent.\n // @param _selector Function selector for function to be called.\n // @param _callParams Packed, encoded parameters, omitting the first parameter which is always msg.sender\n function approveAndCallWithSender(\n address _spender,\n uint256 _value,\n bytes4 _selector,\n bytes memory _callParams\n ) public payable returns (bool) {\n require(_spender != address(this), \"token contract can't be approved\");\n require(callSpenderWhitelist[_spender], \"spender not in whitelist\");\n\n require(super.approve(_spender, _value), \"approve failed\");\n\n bytes memory callData = abi.encodePacked(\n _selector,\n uint256(uint160(msg.sender)),\n _callParams\n );\n // solium-disable-next-line security/no-call-value\n (bool success, ) = _spender.call{ value: msg.value }(callData);\n require(success, \"proxied call failed\");\n return true;\n }\n\n //\n // Functions for maintaining whitelist\n //\n\n modifier onlyOwner() {\n require(msg.sender == owner);\n _;\n }\n modifier allowedTransfer(address _from, address _to) {\n require(\n // solium-disable-next-line operator-whitespace\n !whitelistActive() ||\n allowedTransactors[_from] ||\n allowedTransactors[_to],\n \"neither sender nor recipient are allowed\"\n );\n _;\n }\n\n function whitelistActive() public view returns (bool) {\n return block.timestamp < whitelistExpiration;\n }\n\n function addAllowedTransactor(address _transactor) public onlyOwner {\n emit AllowedTransactorAdded(_transactor);\n allowedTransactors[_transactor] = true;\n }\n\n function removeAllowedTransactor(address _transactor) public onlyOwner {\n emit AllowedTransactorRemoved(_transactor);\n delete allowedTransactors[_transactor];\n }\n\n /**\n * @dev Set the whitelist expiration, after which the whitelist no longer\n * applies.\n */\n function setWhitelistExpiration(uint256 _expiration) public onlyOwner {\n // allow only if whitelist expiration hasn't yet been set, or if the\n // whitelist expiration hasn't passed yet\n require(\n whitelistExpiration == 0 || whitelistActive(),\n \"an expired whitelist cannot be extended\"\n );\n // prevent possible mistakes in calling this function\n require(\n _expiration >= block.timestamp + 1 days,\n \"whitelist expiration not far enough into the future\"\n );\n emit SetWhitelistExpiration(_expiration);\n whitelistExpiration = _expiration;\n }\n\n //\n // ERC20 transfer functions that have been overridden to enforce the\n // whitelist.\n //\n\n function transfer(address _to, uint256 _value)\n public\n override\n allowedTransfer(msg.sender, _to)\n returns (bool)\n {\n return super.transfer(_to, _value);\n }\n\n function transferFrom(\n address _from,\n address _to,\n uint256 _value\n ) public override allowedTransfer(_from, _to) returns (bool) {\n return super.transferFrom(_from, _to, _value);\n }\n}\n" + }, + "contracts/mocks/MockOGV.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockOGV is MintableERC20 {\n constructor() ERC20(\"OGV\", \"OGV\") {}\n}\n" + }, + "contracts/mocks/MockOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/IPriceOracle.sol\";\nimport \"../interfaces/IMinMaxOracle.sol\";\n\n/**\n * Mock of both price Oracle and min max oracles\n */\ncontract MockOracle is IPriceOracle, IMinMaxOracle {\n mapping(bytes32 => uint256) prices;\n mapping(bytes32 => uint256[]) pricesMinMax;\n uint256 ethMin;\n uint256 ethMax;\n\n /**\n * @dev returns the asset price in USD, 6 decimal digits.\n * Compatible with the Open Price Feed.\n */\n function price(string calldata symbol)\n external\n view\n override\n returns (uint256)\n {\n return prices[keccak256(abi.encodePacked(symbol))];\n }\n\n /**\n * @dev sets the price of the asset in USD, 6 decimal digits\n *\n */\n function setPrice(string calldata symbol, uint256 _price) external {\n prices[keccak256(abi.encodePacked(symbol))] = _price;\n }\n\n /**\n * @dev sets the min and max price of ETH in USD, 6 decimal digits\n *\n */\n function setEthPriceMinMax(uint256 _min, uint256 _max) external {\n ethMin = _min;\n ethMax = _max;\n }\n\n /**\n * @dev sets the prices Min Max for a specific symbol in ETH, 8 decimal digits\n *\n */\n function setTokPriceMinMax(\n string calldata symbol,\n uint256 _min,\n uint256 _max\n ) external {\n pricesMinMax[keccak256(abi.encodePacked(symbol))] = [_min, _max];\n }\n\n /**\n * @dev get the price of asset in ETH, 8 decimal digits.\n */\n function priceMin(string calldata symbol)\n external\n view\n override\n returns (uint256)\n {\n uint256[] storage pMinMax = pricesMinMax[\n keccak256(abi.encodePacked(symbol))\n ];\n return (pMinMax[0] * ethMin) / 1e6;\n }\n\n /**\n * @dev get the price of asset in USD, 8 decimal digits.\n * Not needed for now\n */\n function priceMax(string calldata symbol)\n external\n view\n override\n returns (uint256)\n {\n uint256[] storage pMinMax = pricesMinMax[\n keccak256(abi.encodePacked(symbol))\n ];\n return (pMinMax[1] * ethMax) / 1e6;\n }\n}\n" + }, + "contracts/mocks/MockOracleRouter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { SafeCast } from \"@openzeppelin/contracts/utils/math/SafeCast.sol\";\nimport { OracleRouterBase } from \"../oracle/OracleRouterBase.sol\";\n\n// @notice Oracle Router required for testing environment\ncontract MockOracleRouter is OracleRouterBase {\n struct FeedMetadata {\n address feedAddress;\n uint256 maxStaleness;\n }\n\n mapping(address => FeedMetadata) public assetToFeedMetadata;\n\n /* @dev Override feed and maxStaleness information for a particular asset\n * @param _asset the asset to override feed for\n * @param _feed new feed\n * @param _maxStaleness new maximum time allowed for feed data to be stale\n */\n function setFeed(\n address _asset,\n address _feed,\n uint256 _maxStaleness\n ) external {\n assetToFeedMetadata[_asset] = FeedMetadata(_feed, _maxStaleness);\n }\n\n /*\n * The dev version of the Oracle doesn't need to gas optimize and cache the decimals\n */\n function getDecimals(address _feed) internal view override returns (uint8) {\n require(_feed != address(0), \"Asset not available\");\n require(_feed != FIXED_PRICE, \"Fixed price feeds not supported\");\n\n return AggregatorV3Interface(_feed).decimals();\n }\n\n /**\n * @dev The price feed contract to use for a particular asset along with\n * maximum data staleness\n * @param asset address of the asset\n * @return feedAddress address of the price feed for the asset\n * @return maxStaleness maximum acceptable data staleness duration\n */\n function feedMetadata(address asset)\n internal\n view\n override\n returns (address feedAddress, uint256 maxStaleness)\n {\n FeedMetadata storage fm = assetToFeedMetadata[asset];\n feedAddress = fm.feedAddress;\n maxStaleness = fm.maxStaleness;\n }\n}\n" + }, + "contracts/mocks/MockOracleRouterNoStale.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { SafeCast } from \"@openzeppelin/contracts/utils/math/SafeCast.sol\";\nimport { OracleRouter } from \"../oracle/OracleRouter.sol\";\nimport { OETHOracleRouter } from \"../oracle/OETHOracleRouter.sol\";\n\n// @notice Oracle Router used to bypass staleness\ncontract MockOracleRouterNoStale is OracleRouter {\n function feedMetadata(address asset)\n internal\n pure\n virtual\n override\n returns (address feedAddress, uint256 maxStaleness)\n {\n (feedAddress, ) = super.feedMetadata(asset);\n maxStaleness = 365 days;\n }\n}\n\n// @notice Oracle Router used to bypass staleness\ncontract MockOETHOracleRouterNoStale is OETHOracleRouter {\n constructor(address auraPriceFeed) OETHOracleRouter(auraPriceFeed) {}\n\n function feedMetadata(address asset)\n internal\n view\n virtual\n override\n returns (address feedAddress, uint256 maxStaleness)\n {\n (feedAddress, ) = super.feedMetadata(asset);\n maxStaleness = 365 days;\n }\n}\n" + }, + "contracts/mocks/MockOracleWeightedPool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Variable, OracleAverageQuery, IOracleWeightedPool } from \"../interfaces/balancer/IOracleWeightedPool.sol\";\n\ncontract MockOracleWeightedPool is IOracleWeightedPool {\n uint256[] public nextResults;\n\n constructor() {\n nextResults = [1 ether, 1 ether];\n }\n\n function getTimeWeightedAverage(OracleAverageQuery[] memory)\n external\n view\n override\n returns (uint256[] memory results)\n {\n return nextResults;\n }\n\n function setNextResults(uint256[] calldata results) external {\n nextResults = results;\n }\n}\n" + }, + "contracts/mocks/MockRebornMinter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IVault } from \"../interfaces/IVault.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n// solhint-disable-next-line no-console\nimport \"hardhat/console.sol\";\n\ncontract Sanctum {\n address public asset;\n address public vault;\n address public reborner;\n bool public shouldAttack = false;\n uint256 public targetMethod;\n address public ousdContract;\n\n constructor(address _asset, address _vault) {\n asset = _asset;\n vault = _vault;\n }\n\n function deploy(uint256 salt, bytes memory bytecode)\n public\n returns (address addr)\n {\n // solhint-disable-next-line no-inline-assembly\n assembly {\n addr := create2(0, add(bytecode, 0x20), mload(bytecode), salt)\n }\n require(addr != address(0), \"Create2: Failed on deploy\");\n }\n\n function computeAddress(uint256 salt, bytes memory bytecode)\n public\n view\n returns (address)\n {\n bytes32 bytecodeHashHash = keccak256(bytecode);\n bytes32 _data = keccak256(\n abi.encodePacked(\n bytes1(0xff),\n address(this),\n salt,\n bytecodeHashHash\n )\n );\n return address(bytes20(_data << 96));\n }\n\n function setShouldAttack(bool _shouldAttack) public {\n shouldAttack = _shouldAttack;\n }\n\n function setTargetMethod(uint256 target) public {\n targetMethod = target;\n }\n\n function setOUSDAddress(address _ousdContract) public {\n ousdContract = _ousdContract;\n }\n}\n\ncontract Reborner {\n Sanctum sanctum;\n bool logging = false;\n\n constructor(address _sanctum) {\n log(\"We are created...\");\n sanctum = Sanctum(_sanctum);\n if (sanctum.shouldAttack()) {\n log(\"We are attacking now...\");\n\n uint256 target = sanctum.targetMethod();\n\n if (target == 1) {\n redeem();\n } else if (target == 2) {\n transfer();\n } else {\n mint();\n }\n }\n }\n\n function mint() public {\n log(\"We are attempting to mint..\");\n address asset = sanctum.asset();\n address vault = sanctum.vault();\n IERC20(asset).approve(vault, 1e18);\n IVault(vault).mint(asset, 1e18, 0);\n log(\"We are now minting..\");\n }\n\n function redeem() public {\n log(\"We are attempting to redeem..\");\n address vault = sanctum.vault();\n IVault(vault).redeem(1e18, 1e18);\n log(\"We are now redeeming..\");\n }\n\n function transfer() public {\n log(\"We are attempting to transfer..\");\n address ousd = sanctum.ousdContract();\n require(IERC20(ousd).transfer(address(1), 1e18), \"transfer failed\");\n log(\"We are now transfering..\");\n }\n\n function bye() public {\n log(\"We are now destructing..\");\n selfdestruct(payable(msg.sender));\n }\n\n function log(string memory message) internal view {\n if (logging) {\n // solhint-disable-next-line no-console\n console.log(message);\n }\n }\n}\n" + }, + "contracts/mocks/MockRETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\nimport \"../interfaces/IGetExchangeRateToken.sol\";\n\ncontract MockRETH is MintableERC20, IGetExchangeRateToken {\n uint256 private exchangeRate = 12e17;\n\n constructor() ERC20(\"Rocket Pool ETH\", \"rETH\") {}\n\n function getExchangeRate() external view override returns (uint256) {\n return exchangeRate;\n }\n\n function setExchangeRate(uint256 _rate) external {\n exchangeRate = _rate;\n }\n}\n" + }, + "contracts/mocks/MocksfrxETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MocksfrxETH is MintableERC20 {\n address public frxETH;\n\n constructor(address _frxETH) ERC20(\"sfrxETH\", \"sfrxETH\") {\n frxETH = _frxETH;\n }\n\n function setMockfrxETHAddress(address _frxETH) external {\n frxETH = _frxETH;\n }\n\n function deposit(uint256 assets, address receiver)\n external\n returns (uint256 shares)\n {\n ERC20(frxETH).transferFrom(msg.sender, address(this), assets);\n\n _mint(receiver, assets);\n\n return assets;\n }\n\n function maxWithdraw(address owner) external view returns (uint256) {\n return balanceOf(owner);\n }\n\n function setMaxWithdrawableBalance(address owner, uint256 balance)\n external\n {\n uint256 currentBalance = balanceOf(owner);\n if (currentBalance > balance) {\n _burn(owner, currentBalance - balance);\n } else if (balance > currentBalance) {\n _mint(owner, balance - currentBalance);\n }\n }\n\n function redeem(\n uint256 shares,\n address receiver,\n address owner\n ) external returns (uint256 assets) {\n _burn(owner, shares);\n\n ERC20(frxETH).transfer(receiver, shares);\n\n assets = shares;\n }\n\n function withdraw(\n uint256 assets,\n address receiver,\n address owner\n ) external returns (uint256 shares) {\n _burn(owner, assets);\n\n ERC20(frxETH).transfer(receiver, assets);\n\n shares = assets;\n }\n\n function submitAndDeposit(address recipient)\n external\n payable\n returns (uint256 shares)\n {\n _mint(recipient, msg.value);\n shares = msg.value;\n }\n}\n" + }, + "contracts/mocks/MockSSV.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockSSV is MintableERC20 {\n constructor() ERC20(\"SSV Token\", \"SSV\") {}\n}\n" + }, + "contracts/mocks/MockSSVNetwork.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract MockSSVNetwork {\n constructor() {}\n}\n" + }, + "contracts/mocks/MockstETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockstETH is MintableERC20 {\n constructor() ERC20(\"stETH\", \"stETH\") {}\n}\n" + }, + "contracts/mocks/MockStkAave.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"./MintableERC20.sol\";\n\ncontract MockStkAave is MintableERC20 {\n uint256 public COOLDOWN_SECONDS = 864000;\n uint256 public UNSTAKE_WINDOW = 172800;\n address public STAKED_TOKEN;\n\n mapping(address => uint256) public stakerRewardsToClaim;\n mapping(address => uint256) public stakersCooldowns;\n\n using SafeERC20 for IERC20;\n\n constructor(address _stakedToken) ERC20(\"Staked Aave\", \"stkAAVE\") {\n STAKED_TOKEN = _stakedToken;\n }\n\n function decimals() public pure override returns (uint8) {\n return 18;\n }\n\n function setStakedToken(address _stakedToken) external {\n STAKED_TOKEN = _stakedToken;\n }\n\n /**\n * @dev Redeems staked tokens, and stop earning rewards\n * @param to Address to redeem to\n * @param amount Amount to redeem\n **/\n function redeem(address to, uint256 amount) external {\n uint256 cooldownStartTimestamp = stakersCooldowns[msg.sender];\n uint256 windowStart = cooldownStartTimestamp + COOLDOWN_SECONDS;\n require(amount != 0, \"INVALID_ZERO_AMOUNT\");\n require(block.timestamp > windowStart, \"INSUFFICIENT_COOLDOWN\");\n require(\n block.timestamp - windowStart <= UNSTAKE_WINDOW,\n \"UNSTAKE_WINDOW_FINISHED\"\n );\n uint256 balanceOfMessageSender = balanceOf(msg.sender);\n uint256 amountToRedeem = (amount > balanceOfMessageSender)\n ? balanceOfMessageSender\n : amount;\n\n stakersCooldowns[msg.sender] = 0;\n _burn(msg.sender, amountToRedeem);\n IERC20(STAKED_TOKEN).safeTransfer(to, amountToRedeem);\n }\n\n /**\n * @dev Activates the cooldown period to unstake\n * - It can't be called if the user is not staking\n **/\n function cooldown() external {\n require(balanceOf(msg.sender) != 0, \"INVALID_BALANCE_ON_COOLDOWN\");\n stakersCooldowns[msg.sender] = block.timestamp;\n }\n\n /**\n * @dev Test helper function to allow changing the cooldown\n **/\n function setCooldown(address account, uint256 _cooldown) external {\n stakersCooldowns[account] = _cooldown;\n }\n}\n" + }, + "contracts/mocks/MockStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\ncontract MockStrategy {\n address[] public assets;\n\n constructor() {}\n\n function deposit(address asset, uint256 amount) external {}\n\n function depositAll() external {}\n\n function withdraw(\n address recipient,\n address asset,\n uint256 amount\n ) external {\n IERC20(asset).transfer(recipient, amount);\n }\n\n function withdrawAll() external {\n require(false, \"Not implemented\");\n }\n\n function checkBalance(address asset)\n external\n view\n returns (uint256 balance)\n {\n balance = IERC20(asset).balanceOf(address(this));\n }\n\n function supportsAsset(address) external view returns (bool) {\n return true;\n }\n\n function collectRewardTokens() external {}\n\n function getRewardTokenAddresses()\n external\n view\n returns (address[] memory)\n {\n return new address[](0);\n }\n}\n" + }, + "contracts/mocks/MockSwapper.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IMintableERC20 } from \"./MintableERC20.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\ncontract MockSwapper {\n uint256 public nextOutAmount;\n\n function swap(\n // solhint-disable-next-line no-unused-vars\n address _fromAsset,\n address _toAsset,\n // solhint-disable-next-line no-unused-vars\n uint256 _fromAssetAmount,\n uint256 _minToAssetAmount,\n // solhint-disable-next-line no-unused-vars\n bytes calldata _data\n ) external returns (uint256 toAssetAmount) {\n toAssetAmount = (nextOutAmount > 0) ? nextOutAmount : _minToAssetAmount;\n nextOutAmount = 0;\n IMintableERC20(_toAsset).mint(toAssetAmount);\n IERC20(_toAsset).transfer(msg.sender, toAssetAmount);\n }\n\n function setNextOutAmount(uint256 _nextOutAmount) public {\n nextOutAmount = _nextOutAmount;\n }\n}\n" + }, + "contracts/mocks/MockTUSD.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockTUSD is MintableERC20 {\n constructor() ERC20(\"TrueUSD\", \"TUSD\") {}\n\n function decimals() public pure override returns (uint8) {\n return 18;\n }\n}\n" + }, + "contracts/mocks/MockUniswapPair.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IUniswapV2Pair } from \"../interfaces/uniswap/IUniswapV2Pair.sol\";\n\ncontract MockUniswapPair is IUniswapV2Pair {\n address tok0;\n address tok1;\n uint112 reserve0;\n uint112 reserve1;\n uint256 blockTimestampLast;\n\n bool public hasSynced = false;\n\n constructor(\n address _token0,\n address _token1,\n uint112 _reserve0,\n uint112 _reserve1\n ) {\n tok0 = _token0;\n tok1 = _token1;\n reserve0 = _reserve0;\n reserve1 = _reserve1;\n blockTimestampLast = block.timestamp;\n }\n\n function token0() external view override returns (address) {\n return tok0;\n }\n\n function token1() external view override returns (address) {\n return tok1;\n }\n\n function getReserves()\n external\n view\n override\n returns (\n uint112,\n uint112,\n uint32\n )\n {\n return (reserve0, reserve1, uint32(blockTimestampLast));\n }\n\n function setReserves(uint112 _reserve0, uint112 _reserve1) public {\n reserve0 = _reserve0;\n reserve1 = _reserve1;\n blockTimestampLast = block.timestamp;\n }\n\n // CAUTION This will not work if you setReserves multiple times over\n // multiple different blocks because then it wouldn't be a continuous\n // reserve factor over that blockTimestamp, this assumes an even reserve\n // ratio all the way through\n function price0CumulativeLast() external view override returns (uint256) {\n return\n uint256(FixedPoint.fraction(reserve1, reserve0)._x) *\n blockTimestampLast;\n }\n\n function price1CumulativeLast() external view override returns (uint256) {\n return\n uint256(FixedPoint.fraction(reserve0, reserve1)._x) *\n blockTimestampLast;\n }\n\n function sync() external override {\n hasSynced = true;\n }\n\n function checkHasSynced() external view {\n require(hasSynced, \"Not synced\");\n }\n}\n\n// a library for handling binary fixed point numbers (https://en.wikipedia.org/wiki/Q_(number_format))\nlibrary FixedPoint {\n // range: [0, 2**112 - 1]\n // resolution: 1 / 2**112\n struct uq112x112 {\n uint224 _x;\n }\n\n // returns a uq112x112 which represents the ratio of the numerator to the denominator\n // equivalent to encode(numerator).div(denominator)\n function fraction(uint112 numerator, uint112 denominator)\n internal\n pure\n returns (uq112x112 memory)\n {\n require(denominator > 0, \"FixedPoint: DIV_BY_ZERO\");\n return uq112x112((uint224(numerator) << 112) / denominator);\n }\n}\n" + }, + "contracts/mocks/MockUniswapRouter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { MintableERC20 } from \"./MintableERC20.sol\";\nimport { IUniswapV2Router } from \"../interfaces/uniswap/IUniswapV2Router02.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\ncontract MockUniswapRouter is IUniswapV2Router {\n using StableMath for uint256;\n\n mapping(address => address) public pairMaps;\n uint256 public slippage = 1 ether;\n\n function initialize(\n address[] calldata _0tokens,\n address[] calldata _1tokens\n ) public {\n require(\n _0tokens.length == _1tokens.length,\n \"Mock token pairs should be of the same length\"\n );\n for (uint256 i = 0; i < _0tokens.length; i++) {\n pairMaps[_0tokens[i]] = _1tokens[i];\n }\n }\n\n function setSlippage(uint256 _slippage) external {\n slippage = _slippage;\n }\n\n function swapExactTokensForTokens(\n uint256 amountIn,\n uint256 amountOutMin,\n address[] calldata path,\n address to,\n // solhint-disable-next-line no-unused-vars\n uint256\n ) external override returns (uint256[] memory amountsOut) {\n address tok0 = path[0];\n address tok1 = path[path.length - 1];\n\n uint256 amountOut = (amountOutMin * slippage) / 1 ether;\n require(amountOut >= amountOutMin, \"Slippage error\");\n\n IERC20(tok0).transferFrom(msg.sender, address(this), amountIn);\n MintableERC20(tok1).mintTo(to, amountOut);\n\n amountsOut = new uint256[](path.length);\n amountsOut[path.length - 1] = amountOut;\n }\n\n struct ExactInputParams {\n bytes path;\n address recipient;\n uint256 deadline;\n uint256 amountIn;\n uint256 amountOutMinimum;\n }\n\n function exactInput(ExactInputParams calldata params)\n external\n payable\n returns (uint256 amountOut)\n {\n (address tok0, address tok1) = _getFirstAndLastToken(params.path);\n\n amountOut = (params.amountOutMinimum * slippage) / 1 ether;\n\n IERC20(tok0).transferFrom(msg.sender, address(this), params.amountIn);\n MintableERC20(tok1).mintTo(params.recipient, amountOut);\n\n require(\n amountOut >= params.amountOutMinimum,\n \"UniswapMock: amountOut less than amountOutMinimum\"\n );\n return amountOut;\n }\n\n function addLiquidity(\n address tokenA,\n address tokenB,\n uint256 amountADesired,\n uint256 amountBDesired,\n uint256 amountAMin,\n uint256 amountBMin,\n address to,\n uint256 deadline\n )\n external\n override\n returns (\n uint256 amountA,\n uint256 amountB,\n uint256 liquidity\n )\n {\n // this is needed to make this contract whole else it'd be just virtual\n }\n\n function WETH() external pure override returns (address) {\n return address(0);\n }\n\n // Universal router mock\n function execute(\n bytes calldata,\n bytes[] calldata inputs,\n uint256\n ) external payable {\n uint256 inLen = inputs.length;\n for (uint256 i = 0; i < inLen; ++i) {\n (\n address recipient,\n ,\n uint256 amountOutMinimum,\n bytes memory path,\n\n ) = abi.decode(inputs[i], (address, uint256, uint256, bytes, bool));\n\n (address token0, address token1) = _getFirstAndLastToken(path);\n\n amountOutMinimum = amountOutMinimum.scaleBy(\n Helpers.getDecimals(token0),\n Helpers.getDecimals(token1)\n );\n\n MintableERC20(token1).mintTo(recipient, amountOutMinimum);\n }\n }\n\n function _getFirstAndLastToken(bytes memory path)\n internal\n view\n returns (address token0, address token1)\n {\n bytes memory tok0Bytes = new bytes(20);\n for (uint256 j = 0; j < 20; ++j) {\n tok0Bytes[j] = path[j];\n }\n token0 = address(bytes20(tok0Bytes));\n\n if (pairMaps[token0] != address(0)) {\n token0 = pairMaps[token0];\n }\n\n bytes memory tok1Bytes = new bytes(20);\n uint256 tok1Offset = path.length - 20;\n for (uint256 j = 0; j < 20; ++j) {\n tok1Bytes[j] = path[j + tok1Offset];\n }\n token1 = address(bytes20(tok1Bytes));\n\n if (pairMaps[token1] != address(0)) {\n token1 = pairMaps[token1];\n }\n }\n}\n" + }, + "contracts/mocks/MockUSDC.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockUSDC is MintableERC20 {\n constructor() ERC20(\"USDC Coin\", \"USDC\") {}\n\n function decimals() public pure override returns (uint8) {\n return 6;\n }\n}\n" + }, + "contracts/mocks/MockUSDT.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockUSDT is MintableERC20 {\n constructor() ERC20(\"USDT Coin\", \"USDT\") {}\n\n function decimals() public pure override returns (uint8) {\n return 6;\n }\n}\n" + }, + "contracts/mocks/MockVault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { VaultCore } from \"../vault/VaultCore.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { VaultInitializer } from \"../vault/VaultInitializer.sol\";\nimport \"../utils/Helpers.sol\";\n\ncontract MockVault is VaultCore {\n using StableMath for uint256;\n\n uint256 storedTotalValue;\n\n function setTotalValue(uint256 _value) public {\n storedTotalValue = _value;\n }\n\n function totalValue() external view override returns (uint256) {\n return storedTotalValue;\n }\n\n function _totalValue() internal view override returns (uint256) {\n return storedTotalValue;\n }\n\n function _checkBalance(address _asset)\n internal\n view\n override\n returns (uint256 balance)\n {\n // Avoids rounding errors by returning the total value\n // in a single currency\n if (allAssets[0] == _asset) {\n uint256 decimals = Helpers.getDecimals(_asset);\n return storedTotalValue.scaleBy(decimals, 18);\n } else {\n return 0;\n }\n }\n\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external onlyGovernor {\n maxSupplyDiff = _maxSupplyDiff;\n }\n}\n" + }, + "contracts/mocks/MockWETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"./MintableERC20.sol\";\n\ncontract MockWETH is MintableERC20 {\n constructor() ERC20(\"WETH\", \"WETH\") {}\n\n function deposit() external payable {\n _mint(msg.sender, msg.value);\n }\n\n function withdraw(uint256 wad) external {\n _burn(msg.sender, wad);\n payable(msg.sender).transfer(wad);\n }\n}\n" + }, + "contracts/oracle/AuraWETHPriceFeed.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Variable, OracleAverageQuery, IOracleWeightedPool } from \"../interfaces/balancer/IOracleWeightedPool.sol\";\nimport { Strategizable } from \"../governance/Strategizable.sol\";\nimport { AggregatorV3Interface } from \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { SafeCast } from \"@openzeppelin/contracts/utils/math/SafeCast.sol\";\n\ncontract AuraWETHPriceFeed is AggregatorV3Interface, Strategizable {\n using SafeCast for uint256;\n using SafeCast for int256;\n\n event PriceFeedPaused();\n event PriceFeedUnpaused();\n event ToleranceChanged(uint256 oldTolerance, uint256 newTolerance);\n\n error PriceFeedPausedError();\n error PriceFeedUnpausedError();\n error InvalidToleranceBps();\n error HighPriceVolatility(uint256 deviation);\n\n bool public paused;\n uint256 public tolerance = 0.02 ether; // 2% by default\n\n // Fields to make it compatible with `AggregatorV3Interface`\n uint8 public constant override decimals = 18;\n string public constant override description = \"\";\n uint256 public constant override version = 1;\n\n IOracleWeightedPool public immutable auraOracleWeightedPool;\n\n constructor(address _auraOracleWeightedPool, address _governor) {\n _setGovernor(_governor);\n auraOracleWeightedPool = IOracleWeightedPool(_auraOracleWeightedPool);\n }\n\n /**\n * @dev Queries the OracleWeightedPool for TWAP of two intervals\n * (1h data from 5m ago and the recent 5m data) and ensures that\n * the price hasn't deviated too much and returns the most recent\n * TWAP price.\n *\n * @return price The price scaled to 18 decimals\n **/\n function price() external view returns (int256) {\n return _price();\n }\n\n function _price() internal view returns (int256) {\n if (paused) {\n revert PriceFeedPausedError();\n }\n OracleAverageQuery[] memory queries = new OracleAverageQuery[](2);\n\n queries[0] = OracleAverageQuery({\n variable: Variable.PAIR_PRICE,\n secs: 3600, // Get 1h data\n ago: 300 // From 5min ago\n });\n queries[1] = OracleAverageQuery({\n variable: Variable.PAIR_PRICE,\n secs: 300, // Get 5min data\n ago: 0 // From now\n });\n\n uint256[] memory prices = auraOracleWeightedPool.getTimeWeightedAverage(\n queries\n );\n int256 price_1h = prices[0].toInt256();\n int256 price_5m = prices[1].toInt256();\n\n int256 diff = (1e18 * (price_1h - price_5m)) /\n ((price_1h + price_5m) / 2);\n uint256 absDiff = diff >= 0 ? diff.toUint256() : (-diff).toUint256();\n\n // Ensure the price hasn't moved too much (2% tolerance)\n // between now and the past hour\n if (absDiff > tolerance) {\n revert HighPriceVolatility(absDiff);\n }\n\n // Return the recent price\n return price_5m;\n }\n\n /**\n * Pauses the price feed. Callable by Strategist as well.\n **/\n function pause() external onlyGovernorOrStrategist {\n if (paused) {\n revert PriceFeedPausedError();\n }\n paused = true;\n emit PriceFeedPaused();\n }\n\n /**\n * Unpauses the price feed. Only Governor can call it\n **/\n function unpause() external onlyGovernor {\n if (!paused) {\n revert PriceFeedUnpausedError();\n }\n paused = false;\n emit PriceFeedUnpaused();\n }\n\n /**\n * Set the max amount of tolerance acceptable between\n * two different price points.\n *\n * @param _tolerance New tolerance value\n **/\n function setTolerance(uint256 _tolerance) external onlyGovernor {\n if (_tolerance > 0.1 ether) {\n revert InvalidToleranceBps();\n }\n emit ToleranceChanged(tolerance, _tolerance);\n tolerance = _tolerance;\n }\n\n /**\n * @dev This function exists to make the contract compatible\n * with AggregatorV3Interface (which OETHOracleRouter uses to\n * get the price).\n *\n * The `answer` returned by this is same as what `price()` would return.\n *\n * It doesn't return any data about rounds (since those doesn't exist).\n **/\n function latestRoundData()\n external\n view\n override\n returns (\n uint80,\n int256 answer,\n uint256,\n uint256 updatedAt,\n uint80\n )\n {\n answer = _price();\n updatedAt = block.timestamp;\n }\n\n /**\n * @dev This function exists to make the contract compatible\n * with AggregatorV3Interface.\n *\n * Always reverts since there're no round data in this contract.\n **/\n function getRoundData(uint80)\n external\n pure\n override\n returns (\n uint80,\n int256,\n uint256,\n uint256,\n uint80\n )\n {\n revert(\"No data present\");\n }\n}\n" + }, + "contracts/oracle/OETHFixedOracle.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { OETHOracleRouter } from \"./OETHOracleRouter.sol\";\n\n// @notice Oracle Router that returns 1e18 for all prices\n// used solely for deployment to testnets\ncontract OETHFixedOracle is OETHOracleRouter {\n constructor(address _auraPriceFeed) OETHOracleRouter(_auraPriceFeed) {}\n\n /**\n * @dev The price feed contract to use for a particular asset along with\n * maximum data staleness\n * @param asset address of the asset\n * @return feedAddress address of the price feed for the asset\n * @return maxStaleness maximum acceptable data staleness duration\n */\n // solhint-disable-next-line no-unused-vars\n function feedMetadata(address asset)\n internal\n view\n virtual\n override\n returns (address feedAddress, uint256 maxStaleness)\n {\n // fixes price for all of the assets\n feedAddress = FIXED_PRICE;\n maxStaleness = 0;\n }\n}\n" + }, + "contracts/oracle/OETHOracleRouter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { OracleRouterBase } from \"./OracleRouterBase.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\n// @notice Oracle Router that denominates all prices in ETH\ncontract OETHOracleRouter is OracleRouterBase {\n using StableMath for uint256;\n\n address public immutable auraPriceFeed;\n\n constructor(address _auraPriceFeed) {\n auraPriceFeed = _auraPriceFeed;\n }\n\n /**\n * @notice Returns the total price in 18 digit units for a given asset.\n * This implementation does not (!) do range checks as the\n * parent OracleRouter does.\n * @param asset address of the asset\n * @return uint256 unit price for 1 asset unit, in 18 decimal fixed\n */\n function price(address asset)\n external\n view\n virtual\n override\n returns (uint256)\n {\n (address _feed, uint256 maxStaleness) = feedMetadata(asset);\n if (_feed == FIXED_PRICE) {\n return 1e18;\n }\n require(_feed != address(0), \"Asset not available\");\n\n // slither-disable-next-line unused-return\n (, int256 _iprice, , uint256 updatedAt, ) = AggregatorV3Interface(_feed)\n .latestRoundData();\n\n require(\n updatedAt + maxStaleness >= block.timestamp,\n \"Oracle price too old\"\n );\n\n uint8 decimals = getDecimals(_feed);\n uint256 _price = uint256(_iprice).scaleBy(18, decimals);\n return _price;\n }\n\n /**\n * @dev The price feed contract to use for a particular asset along with\n * maximum data staleness\n * @param asset address of the asset\n * @return feedAddress address of the price feed for the asset\n * @return maxStaleness maximum acceptable data staleness duration\n */\n function feedMetadata(address asset)\n internal\n view\n virtual\n override\n returns (address feedAddress, uint256 maxStaleness)\n {\n if (asset == 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) {\n // FIXED_PRICE: WETH/ETH\n feedAddress = FIXED_PRICE;\n maxStaleness = 0;\n } else if (asset == 0x5E8422345238F34275888049021821E8E08CAa1f) {\n // frxETH/ETH\n feedAddress = 0xC58F3385FBc1C8AD2c0C9a061D7c13b141D7A5Df;\n maxStaleness = 18 hours + STALENESS_BUFFER;\n } else if (asset == 0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84) {\n // https://data.chain.link/ethereum/mainnet/crypto-eth/steth-eth\n // Chainlink: stETH/ETH\n feedAddress = 0x86392dC19c0b719886221c78AB11eb8Cf5c52812;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xae78736Cd615f374D3085123A210448E74Fc6393) {\n // https://data.chain.link/ethereum/mainnet/crypto-eth/reth-eth\n // Chainlink: rETH/ETH\n feedAddress = 0x536218f9E9Eb48863970252233c8F271f554C2d0;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xD533a949740bb3306d119CC777fa900bA034cd52) {\n // https://data.chain.link/ethereum/mainnet/crypto-eth/crv-eth\n // Chainlink: CRV/ETH\n feedAddress = 0x8a12Be339B0cD1829b91Adc01977caa5E9ac121e;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0x4e3FBD56CD56c3e72c1403e103b45Db9da5B9D2B) {\n // https://data.chain.link/ethereum/mainnet/crypto-eth/cvx-eth\n // Chainlink: CVX/ETH\n feedAddress = 0xC9CbF687f43176B302F03f5e58470b77D07c61c6;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xBe9895146f7AF43049ca1c1AE358B0541Ea49704) {\n // https://data.chain.link/ethereum/mainnet/crypto-eth/cbeth-eth\n // Chainlink: cbETH/ETH\n feedAddress = 0xF017fcB346A1885194689bA23Eff2fE6fA5C483b;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xba100000625a3754423978a60c9317c58a424e3D) {\n // https://data.chain.link/ethereum/mainnet/crypto-eth/bal-eth\n // Chainlink: BAL/ETH\n feedAddress = 0xC1438AA3823A6Ba0C159CfA8D98dF5A994bA120b;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xC0c293ce456fF0ED870ADd98a0828Dd4d2903DBF) {\n // AURA/ETH\n feedAddress = auraPriceFeed;\n maxStaleness = 0;\n } else {\n revert(\"Asset not available\");\n }\n }\n}\n" + }, + "contracts/oracle/OracleRouter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { OracleRouterBase } from \"./OracleRouterBase.sol\";\n\n// @notice Oracle Router that denominates all prices in USD\ncontract OracleRouter is OracleRouterBase {\n /**\n * @dev The price feed contract to use for a particular asset along with\n * maximum data staleness\n * @param asset address of the asset\n * @return feedAddress address of the price feed for the asset\n * @return maxStaleness maximum acceptable data staleness duration\n */\n function feedMetadata(address asset)\n internal\n pure\n virtual\n override\n returns (address feedAddress, uint256 maxStaleness)\n {\n /* + STALENESS_BUFFER is added in case Oracle for some reason doesn't\n * update on heartbeat and we add a generous buffer amount.\n */\n if (asset == 0x6B175474E89094C44Da98b954EedeAC495271d0F) {\n // https://data.chain.link/ethereum/mainnet/stablecoins/dai-usd\n // Chainlink: DAI/USD\n feedAddress = 0xAed0c38402a5d19df6E4c03F4E2DceD6e29c1ee9;\n maxStaleness = 1 hours + STALENESS_BUFFER;\n } else if (asset == 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) {\n // https://data.chain.link/ethereum/mainnet/stablecoins/usdc-usd\n // Chainlink: USDC/USD\n feedAddress = 0x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f6;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xdAC17F958D2ee523a2206206994597C13D831ec7) {\n // https://data.chain.link/ethereum/mainnet/stablecoins/usdt-usd\n // Chainlink: USDT/USD\n feedAddress = 0x3E7d1eAB13ad0104d2750B8863b489D65364e32D;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0xc00e94Cb662C3520282E6f5717214004A7f26888) {\n // https://data.chain.link/ethereum/mainnet/crypto-usd/comp-usd\n // Chainlink: COMP/USD\n feedAddress = 0xdbd020CAeF83eFd542f4De03e3cF0C28A4428bd5;\n maxStaleness = 1 hours + STALENESS_BUFFER;\n } else if (asset == 0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9) {\n // https://data.chain.link/ethereum/mainnet/crypto-usd/aave-usd\n // Chainlink: AAVE/USD\n feedAddress = 0x547a514d5e3769680Ce22B2361c10Ea13619e8a9;\n maxStaleness = 1 hours + STALENESS_BUFFER;\n } else if (asset == 0xD533a949740bb3306d119CC777fa900bA034cd52) {\n // https://data.chain.link/ethereum/mainnet/crypto-usd/crv-usd\n // Chainlink: CRV/USD\n feedAddress = 0xCd627aA160A6fA45Eb793D19Ef54f5062F20f33f;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else if (asset == 0x4e3FBD56CD56c3e72c1403e103b45Db9da5B9D2B) {\n // Chainlink: CVX/USD\n feedAddress = 0xd962fC30A72A84cE50161031391756Bf2876Af5D;\n maxStaleness = 1 days + STALENESS_BUFFER;\n } else {\n revert(\"Asset not available\");\n }\n }\n}\n" + }, + "contracts/oracle/OracleRouterBase.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport \"../interfaces/chainlink/AggregatorV3Interface.sol\";\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { SafeCast } from \"@openzeppelin/contracts/utils/math/SafeCast.sol\";\n\n// @notice Abstract functionality that is shared between various Oracle Routers\nabstract contract OracleRouterBase is IOracle {\n using StableMath for uint256;\n using SafeCast for int256;\n\n uint256 internal constant MIN_DRIFT = 0.7e18;\n uint256 internal constant MAX_DRIFT = 1.3e18;\n address internal constant FIXED_PRICE =\n 0x0000000000000000000000000000000000000001;\n // Maximum allowed staleness buffer above normal Oracle maximum staleness\n uint256 internal constant STALENESS_BUFFER = 1 days;\n mapping(address => uint8) internal decimalsCache;\n\n /**\n * @dev The price feed contract to use for a particular asset along with\n * maximum data staleness\n * @param asset address of the asset\n * @return feedAddress address of the price feed for the asset\n * @return maxStaleness maximum acceptable data staleness duration\n */\n function feedMetadata(address asset)\n internal\n view\n virtual\n returns (address feedAddress, uint256 maxStaleness);\n\n /**\n * @notice Returns the total price in 18 digit unit for a given asset.\n * @param asset address of the asset\n * @return uint256 unit price for 1 asset unit, in 18 decimal fixed\n */\n function price(address asset)\n external\n view\n virtual\n override\n returns (uint256)\n {\n (address _feed, uint256 maxStaleness) = feedMetadata(asset);\n require(_feed != address(0), \"Asset not available\");\n require(_feed != FIXED_PRICE, \"Fixed price feeds not supported\");\n\n // slither-disable-next-line unused-return\n (, int256 _iprice, , uint256 updatedAt, ) = AggregatorV3Interface(_feed)\n .latestRoundData();\n\n require(\n updatedAt + maxStaleness >= block.timestamp,\n \"Oracle price too old\"\n );\n\n uint8 decimals = getDecimals(_feed);\n\n uint256 _price = _iprice.toUint256().scaleBy(18, decimals);\n if (shouldBePegged(asset)) {\n require(_price <= MAX_DRIFT, \"Oracle: Price exceeds max\");\n require(_price >= MIN_DRIFT, \"Oracle: Price under min\");\n }\n return _price;\n }\n\n function getDecimals(address _feed) internal view virtual returns (uint8) {\n uint8 decimals = decimalsCache[_feed];\n require(decimals > 0, \"Oracle: Decimals not cached\");\n return decimals;\n }\n\n /**\n * @notice Before an asset/feed price is fetches for the first time the\n * decimals need to be cached. This is a gas optimization\n * @param asset address of the asset\n * @return uint8 corresponding asset decimals\n */\n function cacheDecimals(address asset) external returns (uint8) {\n (address _feed, ) = feedMetadata(asset);\n require(_feed != address(0), \"Asset not available\");\n require(_feed != FIXED_PRICE, \"Fixed price feeds not supported\");\n\n uint8 decimals = AggregatorV3Interface(_feed).decimals();\n decimalsCache[_feed] = decimals;\n return decimals;\n }\n\n function shouldBePegged(address _asset) internal view returns (bool) {\n string memory symbol = Helpers.getSymbol(_asset);\n bytes32 symbolHash = keccak256(abi.encodePacked(symbol));\n return\n symbolHash == keccak256(abi.encodePacked(\"DAI\")) ||\n symbolHash == keccak256(abi.encodePacked(\"USDC\")) ||\n symbolHash == keccak256(abi.encodePacked(\"USDT\"));\n }\n}\n" + }, + "contracts/proxies/InitializeGovernedUpgradeabilityProxy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Address } from \"@openzeppelin/contracts/utils/Address.sol\";\n\nimport { Governable } from \"../governance/Governable.sol\";\n\n/**\n * @title BaseGovernedUpgradeabilityProxy\n * @dev This contract combines an upgradeability proxy with our governor system.\n * It is based on an older version of OpenZeppelins BaseUpgradeabilityProxy\n * with Solidity ^0.8.0.\n * @author Origin Protocol Inc\n */\ncontract InitializeGovernedUpgradeabilityProxy is Governable {\n /**\n * @dev Emitted when the implementation is upgraded.\n * @param implementation Address of the new implementation.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Contract initializer with Governor enforcement\n * @param _logic Address of the initial implementation.\n * @param _initGovernor Address of the initial Governor.\n * @param _data Data to send as msg.data to the implementation to initialize\n * the proxied contract.\n * It should include the signature and the parameters of the function to be\n * called, as described in\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\n * This parameter is optional, if no data is given the initialization call\n * to proxied contract will be skipped.\n */\n function initialize(\n address _logic,\n address _initGovernor,\n bytes calldata _data\n ) public payable onlyGovernor {\n require(_implementation() == address(0));\n assert(\n IMPLEMENTATION_SLOT ==\n bytes32(uint256(keccak256(\"eip1967.proxy.implementation\")) - 1)\n );\n _setImplementation(_logic);\n if (_data.length > 0) {\n (bool success, ) = _logic.delegatecall(_data);\n require(success);\n }\n _changeGovernor(_initGovernor);\n }\n\n /**\n * @return The address of the proxy admin/it's also the governor.\n */\n function admin() external view returns (address) {\n return _governor();\n }\n\n /**\n * @return The address of the implementation.\n */\n function implementation() external view returns (address) {\n return _implementation();\n }\n\n /**\n * @dev Upgrade the backing implementation of the proxy.\n * Only the admin can call this function.\n * @param newImplementation Address of the new implementation.\n */\n function upgradeTo(address newImplementation) external onlyGovernor {\n _upgradeTo(newImplementation);\n }\n\n /**\n * @dev Upgrade the backing implementation of the proxy and call a function\n * on the new implementation.\n * This is useful to initialize the proxied contract.\n * @param newImplementation Address of the new implementation.\n * @param data Data to send as msg.data in the low level call.\n * It should include the signature and the parameters of the function to be called, as described in\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\n */\n function upgradeToAndCall(address newImplementation, bytes calldata data)\n external\n payable\n onlyGovernor\n {\n _upgradeTo(newImplementation);\n (bool success, ) = newImplementation.delegatecall(data);\n require(success);\n }\n\n /**\n * @dev Fallback function.\n * Implemented entirely in `_fallback`.\n */\n fallback() external payable {\n _fallback();\n }\n\n /**\n * @dev Delegates execution to an implementation contract.\n * This is a low level function that doesn't return to its internal call site.\n * It will return to the external caller whatever the implementation returns.\n * @param _impl Address to delegate.\n */\n function _delegate(address _impl) internal {\n // solhint-disable-next-line no-inline-assembly\n assembly {\n // Copy msg.data. We take full control of memory in this inline assembly\n // block because it will not return to Solidity code. We overwrite the\n // Solidity scratch pad at memory position 0.\n calldatacopy(0, 0, calldatasize())\n\n // Call the implementation.\n // out and outsize are 0 because we don't know the size yet.\n let result := delegatecall(gas(), _impl, 0, calldatasize(), 0, 0)\n\n // Copy the returned data.\n returndatacopy(0, 0, returndatasize())\n\n switch result\n // delegatecall returns 0 on error.\n case 0 {\n revert(0, returndatasize())\n }\n default {\n return(0, returndatasize())\n }\n }\n }\n\n /**\n * @dev Function that is run as the first thing in the fallback function.\n * Can be redefined in derived contracts to add functionality.\n * Redefinitions must call super._willFallback().\n */\n function _willFallback() internal {}\n\n /**\n * @dev fallback implementation.\n * Extracted to enable manual triggering.\n */\n function _fallback() internal {\n _willFallback();\n _delegate(_implementation());\n }\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant IMPLEMENTATION_SLOT =\n 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n /**\n * @dev Returns the current implementation.\n * @return impl Address of the current implementation\n */\n function _implementation() internal view returns (address impl) {\n bytes32 slot = IMPLEMENTATION_SLOT;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n impl := sload(slot)\n }\n }\n\n /**\n * @dev Upgrades the proxy to a new implementation.\n * @param newImplementation Address of the new implementation.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Sets the implementation address of the proxy.\n * @param newImplementation Address of the new implementation.\n */\n function _setImplementation(address newImplementation) internal {\n require(\n Address.isContract(newImplementation),\n \"Cannot set a proxy implementation to a non-contract address\"\n );\n\n bytes32 slot = IMPLEMENTATION_SLOT;\n\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(slot, newImplementation)\n }\n }\n}\n" + }, + "contracts/proxies/Proxies.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { InitializeGovernedUpgradeabilityProxy } from \"./InitializeGovernedUpgradeabilityProxy.sol\";\n\n/**\n * @notice OUSDProxy delegates calls to an OUSD implementation\n */\ncontract OUSDProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice WrappedOUSDProxy delegates calls to a WrappedOUSD implementation\n */\ncontract WrappedOUSDProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice VaultProxy delegates calls to a Vault implementation\n */\ncontract VaultProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice CompoundStrategyProxy delegates calls to a CompoundStrategy implementation\n */\ncontract CompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice AaveStrategyProxy delegates calls to a AaveStrategy implementation\n */\ncontract AaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ThreePoolStrategyProxy delegates calls to a ThreePoolStrategy implementation\n */\ncontract ThreePoolStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ConvexStrategyProxy delegates calls to a ConvexStrategy implementation\n */\ncontract ConvexStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice HarvesterProxy delegates calls to a Harvester implementation\n */\ncontract HarvesterProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice DripperProxy delegates calls to a Dripper implementation\n */\ncontract DripperProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice MorphoCompoundStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\n */\ncontract MorphoCompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ConvexOUSDMetaStrategyProxy delegates calls to a ConvexOUSDMetaStrategy implementation\n */\ncontract ConvexOUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ConvexLUSDMetaStrategyProxy delegates calls to a ConvexalGeneralizedMetaStrategy implementation\n */\ncontract ConvexLUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice MorphoAaveStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\n */\ncontract MorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHProxy delegates calls to nowhere for now\n */\ncontract OETHProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice WOETHProxy delegates calls to nowhere for now\n */\ncontract WOETHProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHVaultProxy delegates calls to a Vault implementation\n */\ncontract OETHVaultProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHDripperProxy delegates calls to a OETHDripper implementation\n */\ncontract OETHDripperProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHHarvesterProxy delegates calls to a Harvester implementation\n */\ncontract OETHHarvesterProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice FraxETHStrategyProxy delegates calls to a FraxETHStrategy implementation\n */\ncontract FraxETHStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice CurveEthStrategyProxy delegates calls to a CurveEthStrategy implementation\n */\ncontract ConvexEthMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice BuybackProxy delegates calls to Buyback implementation\n */\ncontract BuybackProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHMorphoAaveStrategyProxy delegates calls to a MorphoAaveStrategy implementation\n */\ncontract OETHMorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHBalancerMetaPoolrEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\n */\ncontract OETHBalancerMetaPoolrEthStrategyProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n\n/**\n * @notice OETHBalancerMetaPoolwstEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\n */\ncontract OETHBalancerMetaPoolwstEthStrategyProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n\n/**\n * @notice FluxStrategyProxy delegates calls to a CompoundStrategy implementation\n */\ncontract FluxStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice MakerDsrStrategyProxy delegates calls to a Generalized4626Strategy implementation\n */\ncontract MakerDsrStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice FrxEthRedeemStrategyProxy delegates calls to a FrxEthRedeemStrategy implementation\n */\ncontract FrxEthRedeemStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHBuybackProxy delegates calls to Buyback implementation\n */\ncontract OETHBuybackProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice BridgedWOETHProxy delegates calls to BridgedWOETH implementation\n */\ncontract BridgedWOETHProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice NativeStakingSSVStrategyProxy delegates calls to NativeStakingSSVStrategy implementation\n */\ncontract NativeStakingSSVStrategyProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n\n/**\n * @notice NativeStakingFeeAccumulatorProxy delegates calls to NativeStakingFeeCollector implementation\n */\ncontract NativeStakingFeeAccumulatorProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n" + }, + "contracts/staking/SingleAssetStaking.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\ncontract SingleAssetStaking is Initializable, Governable {\n using SafeMath for uint256;\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n /* ========== STATE VARIABLES ========== */\n\n IERC20 public stakingToken; // this is both the staking and rewards\n\n struct Stake {\n uint256 amount; // amount to stake\n uint256 end; // when does the staking period end\n uint256 duration; // the duration of the stake\n uint240 rate; // rate to charge use 248 to reserve 8 bits for the bool\n bool paid;\n uint8 stakeType;\n }\n\n struct DropRoot {\n bytes32 hash;\n uint256 depth;\n }\n\n uint256[] public durations; // allowed durations\n uint256[] public rates; // rates that correspond with the allowed durations\n\n uint256 public totalOutstanding;\n bool public paused;\n\n mapping(address => Stake[]) public userStakes;\n\n mapping(uint8 => DropRoot) public dropRoots;\n\n // type 0 is reserved for stakes done by the user, all other types will be drop/preApproved stakes\n uint8 constant USER_STAKE_TYPE = 0;\n uint256 constant MAX_STAKES = 256;\n\n address public transferAgent;\n\n /* ========== Initialize ========== */\n\n /**\n * @dev Initialize the contracts, sets up durations, rates, and preApprover\n * for preApproved contracts can only be called once\n * @param _stakingToken Address of the token that we are staking\n * @param _durations Array of allowed durations in seconds\n * @param _rates Array of rates(0.3 is 30%) that correspond to the allowed\n * durations in 1e18 precision\n */\n function initialize(\n address _stakingToken,\n uint256[] calldata _durations,\n uint256[] calldata _rates\n ) external onlyGovernor initializer {\n stakingToken = IERC20(_stakingToken);\n _setDurationRates(_durations, _rates);\n }\n\n /* ========= Internal helper functions ======== */\n\n /**\n * @dev Validate and set the duration and corresponding rates, will emit\n * events NewRate and NewDurations\n */\n function _setDurationRates(\n uint256[] memory _durations,\n uint256[] memory _rates\n ) internal {\n require(\n _rates.length == _durations.length,\n \"Mismatch durations and rates\"\n );\n\n for (uint256 i = 0; i < _rates.length; i++) {\n require(_rates[i] < type(uint240).max, \"Max rate exceeded\");\n }\n\n rates = _rates;\n durations = _durations;\n\n emit NewRates(msg.sender, rates);\n emit NewDurations(msg.sender, durations);\n }\n\n function _totalExpectedRewards(Stake[] storage stakes)\n internal\n view\n returns (uint256 total)\n {\n for (uint256 i = 0; i < stakes.length; i++) {\n Stake storage stake = stakes[i];\n if (!stake.paid) {\n total = total.add(stake.amount.mulTruncate(stake.rate));\n }\n }\n }\n\n function _totalExpected(Stake storage _stake)\n internal\n view\n returns (uint256)\n {\n return _stake.amount.add(_stake.amount.mulTruncate(_stake.rate));\n }\n\n function _airDroppedStakeClaimed(address account, uint8 stakeType)\n internal\n view\n returns (bool)\n {\n Stake[] storage stakes = userStakes[account];\n for (uint256 i = 0; i < stakes.length; i++) {\n if (stakes[i].stakeType == stakeType) {\n return true;\n }\n }\n return false;\n }\n\n function _findDurationRate(uint256 duration)\n internal\n view\n returns (uint240)\n {\n for (uint256 i = 0; i < durations.length; i++) {\n if (duration == durations[i]) {\n return uint240(rates[i]);\n }\n }\n return 0;\n }\n\n /**\n * @dev Internal staking function\n * will insert the stake into the stakes array and verify we have\n * enough to pay off stake + reward\n * @param staker Address of the staker\n * @param stakeType Number that represent the type of the stake, 0 is user\n * initiated all else is currently preApproved\n * @param duration Number of seconds this stake will be held for\n * @param rate Rate(0.3 is 30%) of reward for this stake in 1e18, uint240 =\n * to fit the bool and type in struct Stake\n * @param amount Number of tokens to stake in 1e18\n */\n function _stake(\n address staker,\n uint8 stakeType,\n uint256 duration,\n uint240 rate,\n uint256 amount\n ) internal {\n require(!paused, \"Staking paused\");\n\n Stake[] storage stakes = userStakes[staker];\n\n uint256 end = block.timestamp.add(duration);\n\n uint256 i = stakes.length; // start at the end of the current array\n\n require(i < MAX_STAKES, \"Max stakes\");\n\n stakes.push(); // grow the array\n // find the spot where we can insert the current stake\n // this should make an increasing list sorted by end\n while (i != 0 && stakes[i - 1].end > end) {\n // shift it back one\n stakes[i] = stakes[i - 1];\n i -= 1;\n }\n\n // insert the stake\n Stake storage newStake = stakes[i];\n newStake.rate = rate;\n newStake.stakeType = stakeType;\n newStake.end = end;\n newStake.duration = duration;\n newStake.amount = amount;\n\n totalOutstanding = totalOutstanding.add(_totalExpected(newStake));\n\n emit Staked(staker, amount, duration, rate);\n }\n\n function _stakeWithChecks(\n address staker,\n uint256 amount,\n uint256 duration\n ) internal {\n require(amount > 0, \"Cannot stake 0\");\n\n uint240 rewardRate = _findDurationRate(duration);\n require(rewardRate > 0, \"Invalid duration\"); // we couldn't find the rate that correspond to the passed duration\n\n _stake(staker, USER_STAKE_TYPE, duration, rewardRate, amount);\n // transfer in the token so that we can stake the correct amount\n stakingToken.safeTransferFrom(staker, address(this), amount);\n }\n\n modifier requireLiquidity() {\n // we need to have enough balance to cover the rewards after the operation is complete\n _;\n require(\n stakingToken.balanceOf(address(this)) >= totalOutstanding,\n \"Insufficient rewards\"\n );\n }\n\n /* ========== VIEWS ========== */\n\n function getAllDurations() external view returns (uint256[] memory) {\n return durations;\n }\n\n function getAllRates() external view returns (uint256[] memory) {\n return rates;\n }\n\n /**\n * @dev Return all the stakes paid and unpaid for a given user\n * @param account Address of the account that we want to look up\n */\n function getAllStakes(address account)\n external\n view\n returns (Stake[] memory)\n {\n return userStakes[account];\n }\n\n /**\n * @dev Find the rate that corresponds to a given duration\n * @param _duration Number of seconds\n */\n function durationRewardRate(uint256 _duration)\n external\n view\n returns (uint256)\n {\n return _findDurationRate(_duration);\n }\n\n /**\n * @dev Has the airdropped stake already been claimed\n */\n function airDroppedStakeClaimed(address account, uint8 stakeType)\n external\n view\n returns (bool)\n {\n return _airDroppedStakeClaimed(account, stakeType);\n }\n\n /**\n * @dev Calculate all the staked value a user has put into the contract,\n * rewards not included\n * @param account Address of the account that we want to look up\n */\n function totalStaked(address account)\n external\n view\n returns (uint256 total)\n {\n Stake[] storage stakes = userStakes[account];\n\n for (uint256 i = 0; i < stakes.length; i++) {\n if (!stakes[i].paid) {\n total = total.add(stakes[i].amount);\n }\n }\n }\n\n /**\n * @dev Calculate all the rewards a user can expect to receive.\n * @param account Address of the account that we want to look up\n */\n function totalExpectedRewards(address account)\n external\n view\n returns (uint256)\n {\n return _totalExpectedRewards(userStakes[account]);\n }\n\n /**\n * @dev Calculate all current holdings of a user: staked value + prorated rewards\n * @param account Address of the account that we want to look up\n */\n function totalCurrentHoldings(address account)\n external\n view\n returns (uint256 total)\n {\n Stake[] storage stakes = userStakes[account];\n\n for (uint256 i = 0; i < stakes.length; i++) {\n Stake storage stake = stakes[i];\n if (stake.paid) {\n continue;\n } else if (stake.end < block.timestamp) {\n total = total.add(_totalExpected(stake));\n } else {\n //calcualte the precentage accrued in term of rewards\n total = total.add(\n stake.amount.add(\n stake.amount.mulTruncate(stake.rate).mulTruncate(\n stake\n .duration\n .sub(stake.end.sub(block.timestamp))\n .divPrecisely(stake.duration)\n )\n )\n );\n }\n }\n }\n\n /* ========== MUTATIVE FUNCTIONS ========== */\n\n /**\n * @dev Make a preapproved stake for the user, this is a presigned voucher that the user can redeem either from\n * an airdrop or a compensation program.\n * Only 1 of each type is allowed per user. The proof must match the root hash\n * @param index Number that is zero base index of the stake in the payout entry\n * @param stakeType Number that represent the type of the stake, must not be 0 which is user stake\n * @param duration Number of seconds this stake will be held for\n * @param rate Rate(0.3 is 30%) of reward for this stake in 1e18, uint240 to fit the bool and type in struct Stake\n * @param amount Number of tokens to stake in 1e18\n * @param merkleProof Array of proofs for that amount\n */\n function airDroppedStake(\n uint256 index,\n uint8 stakeType,\n uint256 duration,\n uint256 rate,\n uint256 amount,\n bytes32[] calldata merkleProof\n ) external requireLiquidity {\n require(stakeType != USER_STAKE_TYPE, \"Cannot be normal staking\");\n require(rate < type(uint240).max, \"Max rate exceeded\");\n require(index < 2**merkleProof.length, \"Invalid index\");\n DropRoot storage dropRoot = dropRoots[stakeType];\n require(merkleProof.length == dropRoot.depth, \"Invalid proof\");\n\n // Compute the merkle root\n bytes32 node = keccak256(\n abi.encodePacked(\n index,\n stakeType,\n address(this),\n msg.sender,\n duration,\n rate,\n amount\n )\n );\n uint256 path = index;\n for (uint16 i = 0; i < merkleProof.length; i++) {\n if ((path & 0x01) == 1) {\n node = keccak256(abi.encodePacked(merkleProof[i], node));\n } else {\n node = keccak256(abi.encodePacked(node, merkleProof[i]));\n }\n path /= 2;\n }\n\n // Check the merkle proof\n require(node == dropRoot.hash, \"Stake not approved\");\n\n // verify that we haven't already staked\n require(\n !_airDroppedStakeClaimed(msg.sender, stakeType),\n \"Already staked\"\n );\n\n _stake(msg.sender, stakeType, duration, uint240(rate), amount);\n }\n\n /**\n * @dev Stake an approved amount of staking token into the contract.\n * User must have already approved the contract for specified amount.\n * @param amount Number of tokens to stake in 1e18\n * @param duration Number of seconds this stake will be held for\n */\n function stake(uint256 amount, uint256 duration) external requireLiquidity {\n // no checks are performed in this function since those are already present in _stakeWithChecks\n _stakeWithChecks(msg.sender, amount, duration);\n }\n\n /**\n * @dev Stake an approved amount of staking token into the contract. This function\n * can only be called by OGN token contract.\n * @param staker Address of the account that is creating the stake\n * @param amount Number of tokens to stake in 1e18\n * @param duration Number of seconds this stake will be held for\n */\n function stakeWithSender(\n address staker,\n uint256 amount,\n uint256 duration\n ) external requireLiquidity returns (bool) {\n require(\n msg.sender == address(stakingToken),\n \"Only token contract can make this call\"\n );\n\n _stakeWithChecks(staker, amount, duration);\n return true;\n }\n\n /**\n * @dev Exit out of all possible stakes\n */\n function exit() external requireLiquidity {\n Stake[] storage stakes = userStakes[msg.sender];\n require(stakes.length > 0, \"Nothing staked\");\n\n uint256 totalWithdraw = 0;\n uint256 stakedAmount = 0;\n uint256 l = stakes.length;\n do {\n Stake storage exitStake = stakes[l - 1];\n // stop on the first ended stake that's already been paid\n if (exitStake.end < block.timestamp && exitStake.paid) {\n break;\n }\n //might not be ended\n if (exitStake.end < block.timestamp) {\n //we are paying out the stake\n exitStake.paid = true;\n totalWithdraw = totalWithdraw.add(_totalExpected(exitStake));\n stakedAmount = stakedAmount.add(exitStake.amount);\n }\n l--;\n } while (l > 0);\n require(totalWithdraw > 0, \"All stakes in lock-up\");\n\n totalOutstanding = totalOutstanding.sub(totalWithdraw);\n emit Withdrawn(msg.sender, totalWithdraw, stakedAmount);\n stakingToken.safeTransfer(msg.sender, totalWithdraw);\n }\n\n /**\n * @dev Use to transfer all the stakes of an account in the case that the account is compromised\n * Requires access to both the account itself and the transfer agent\n * @param _frmAccount the address to transfer from\n * @param _dstAccount the address to transfer to(must be a clean address with no stakes)\n * @param r r portion of the signature by the transfer agent\n * @param s s portion of the signature\n * @param v v portion of the signature\n */\n function transferStakes(\n address _frmAccount,\n address _dstAccount,\n bytes32 r,\n bytes32 s,\n uint8 v\n ) external {\n require(transferAgent == msg.sender, \"must be transfer agent\");\n Stake[] storage dstStakes = userStakes[_dstAccount];\n require(dstStakes.length == 0, \"Dest stakes must be empty\");\n require(_frmAccount != address(0), \"from account not set\");\n Stake[] storage stakes = userStakes[_frmAccount];\n require(stakes.length > 0, \"Nothing to transfer\");\n\n // matches ethers.signMsg(ethers.utils.solidityPack([string(4), address, adddress, address]))\n bytes32 hash = keccak256(\n abi.encodePacked(\n \"\\x19Ethereum Signed Message:\\n64\",\n abi.encodePacked(\n \"tran\",\n address(this),\n _frmAccount,\n _dstAccount\n )\n )\n );\n require(ecrecover(hash, v, r, s) == _frmAccount, \"Transfer not authed\");\n\n // copy the stakes into the dstAccount array and delete the old one\n userStakes[_dstAccount] = stakes;\n delete userStakes[_frmAccount];\n emit StakesTransfered(_frmAccount, _dstAccount, stakes.length);\n }\n\n /* ========== MODIFIERS ========== */\n\n function setPaused(bool _paused) external onlyGovernor {\n paused = _paused;\n emit Paused(msg.sender, paused);\n }\n\n /**\n * @dev Set new durations and rates will not effect existing stakes\n * @param _durations Array of durations in seconds\n * @param _rates Array of rates that corresponds to the durations (0.01 is 1%) in 1e18\n */\n function setDurationRates(\n uint256[] calldata _durations,\n uint256[] calldata _rates\n ) external onlyGovernor {\n _setDurationRates(_durations, _rates);\n }\n\n /**\n * @dev Set the agent that will authorize transfers\n * @param _agent Address of agent\n */\n function setTransferAgent(address _agent) external onlyGovernor {\n transferAgent = _agent;\n }\n\n /**\n * @dev Set air drop root for a specific stake type\n * @param _stakeType Type of staking must be greater than 0\n * @param _rootHash Root hash of the Merkle Tree\n * @param _proofDepth Depth of the Merklke Tree\n */\n function setAirDropRoot(\n uint8 _stakeType,\n bytes32 _rootHash,\n uint256 _proofDepth\n ) external onlyGovernor {\n require(_stakeType != USER_STAKE_TYPE, \"Cannot be normal staking\");\n dropRoots[_stakeType].hash = _rootHash;\n dropRoots[_stakeType].depth = _proofDepth;\n emit NewAirDropRootHash(_stakeType, _rootHash, _proofDepth);\n }\n\n /* ========== EVENTS ========== */\n\n event Staked(\n address indexed user,\n uint256 amount,\n uint256 duration,\n uint256 rate\n );\n event Withdrawn(address indexed user, uint256 amount, uint256 stakedAmount);\n event Paused(address indexed user, bool yes);\n event NewDurations(address indexed user, uint256[] durations);\n event NewRates(address indexed user, uint256[] rates);\n event NewAirDropRootHash(\n uint8 stakeType,\n bytes32 rootHash,\n uint256 proofDepth\n );\n event StakesTransfered(\n address indexed fromUser,\n address toUser,\n uint256 numStakes\n );\n}\n" + }, + "contracts/strategies/AaveStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD Aave Strategy\n * @notice Investment strategy for investing stablecoins via Aave\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport \"./IAave.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\n\nimport { IAaveStakedToken } from \"./IAaveStakeToken.sol\";\nimport { IAaveIncentivesController } from \"./IAaveIncentivesController.sol\";\n\ncontract AaveStrategy is InitializableAbstractStrategy {\n using SafeERC20 for IERC20;\n\n uint16 constant referralCode = 92;\n\n IAaveIncentivesController public incentivesController;\n IAaveStakedToken public stkAave;\n\n /**\n * @param _stratConfig The platform and OToken vault addresses\n */\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /**\n * Initializer for setting up strategy internal state. This overrides the\n * InitializableAbstractStrategy initializer as AAVE needs several extra\n * addresses for the rewards program.\n * @param _rewardTokenAddresses Address of the AAVE token\n * @param _assets Addresses of supported assets\n * @param _pTokens Platform Token corresponding addresses\n * @param _incentivesAddress Address of the AAVE incentives controller\n * @param _stkAaveAddress Address of the stkAave contract\n */\n function initialize(\n address[] calldata _rewardTokenAddresses, // AAVE\n address[] calldata _assets,\n address[] calldata _pTokens,\n address _incentivesAddress,\n address _stkAaveAddress\n ) external onlyGovernor initializer {\n incentivesController = IAaveIncentivesController(_incentivesAddress);\n stkAave = IAaveStakedToken(_stkAaveAddress);\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n }\n\n /**\n * @dev Deposit asset into Aave\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n _deposit(_asset, _amount);\n }\n\n /**\n * @dev Deposit asset into Aave\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function _deposit(address _asset, uint256 _amount) internal {\n require(_amount > 0, \"Must deposit something\");\n // Following line also doubles as a check that we are depositing\n // an asset that we support.\n emit Deposit(_asset, _getATokenFor(_asset), _amount);\n _getLendingPool().deposit(_asset, _amount, address(this), referralCode);\n }\n\n /**\n * @dev Deposit the entire balance of any supported asset into Aave\n */\n function depositAll() external override onlyVault nonReentrant {\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n uint256 balance = IERC20(assetsMapped[i]).balanceOf(address(this));\n if (balance > 0) {\n _deposit(assetsMapped[i], balance);\n }\n }\n }\n\n /**\n * @dev Withdraw asset from Aave\n * @param _recipient Address to receive withdrawn asset\n * @param _asset Address of asset to withdraw\n * @param _amount Amount of asset to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n require(_amount > 0, \"Must withdraw something\");\n require(_recipient != address(0), \"Must specify recipient\");\n\n emit Withdrawal(_asset, _getATokenFor(_asset), _amount);\n uint256 actual = _getLendingPool().withdraw(\n _asset,\n _amount,\n address(this)\n );\n require(actual == _amount, \"Did not withdraw enough\");\n IERC20(_asset).safeTransfer(_recipient, _amount);\n }\n\n /**\n * @dev Remove all assets from platform and send them to Vault contract.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n // Redeem entire balance of aToken\n IERC20 asset = IERC20(assetsMapped[i]);\n address aToken = _getATokenFor(assetsMapped[i]);\n uint256 balance = IERC20(aToken).balanceOf(address(this));\n if (balance > 0) {\n uint256 actual = _getLendingPool().withdraw(\n address(asset),\n balance,\n address(this)\n );\n require(actual == balance, \"Did not withdraw enough\");\n\n uint256 assetBalance = asset.balanceOf(address(this));\n // Transfer entire balance to Vault\n asset.safeTransfer(vaultAddress, assetBalance);\n\n emit Withdrawal(address(asset), aToken, assetBalance);\n }\n }\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n override\n returns (uint256 balance)\n {\n // Balance is always with token aToken decimals\n address aToken = _getATokenFor(_asset);\n balance = IERC20(aToken).balanceOf(address(this));\n }\n\n /**\n * @dev Returns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return assetToPToken[_asset] != address(0);\n }\n\n /**\n * @dev Approve the spending of all assets by their corresponding aToken,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens()\n external\n override\n onlyGovernor\n nonReentrant\n {\n address lendingPool = address(_getLendingPool());\n // approve the pool to spend the Asset\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n address asset = assetsMapped[i];\n // Safe approval\n IERC20(asset).safeApprove(lendingPool, 0);\n IERC20(asset).safeApprove(lendingPool, type(uint256).max);\n }\n }\n\n /**\n * @dev Internal method to respond to the addition of new asset / aTokens\n We need to give the AAVE lending pool approval to transfer the\n asset.\n * @param _asset Address of the asset to approve\n * @param _aToken Address of the aToken\n */\n // solhint-disable-next-line no-unused-vars\n function _abstractSetPToken(address _asset, address _aToken)\n internal\n override\n {\n address lendingPool = address(_getLendingPool());\n IERC20(_asset).safeApprove(lendingPool, 0);\n IERC20(_asset).safeApprove(lendingPool, type(uint256).max);\n }\n\n /**\n * @dev Get the aToken wrapped in the IERC20 interface for this asset.\n * Fails if the pToken doesn't exist in our mappings.\n * @param _asset Address of the asset\n * @return Corresponding aToken to this asset\n */\n function _getATokenFor(address _asset) internal view returns (address) {\n address aToken = assetToPToken[_asset];\n require(aToken != address(0), \"aToken does not exist\");\n return aToken;\n }\n\n /**\n * @dev Get the current address of the Aave lending pool, which is the gateway to\n * depositing.\n * @return Current lending pool implementation\n */\n function _getLendingPool() internal view returns (IAaveLendingPool) {\n address lendingPool = ILendingPoolAddressesProvider(platformAddress)\n .getLendingPool();\n require(lendingPool != address(0), \"Lending pool does not exist\");\n return IAaveLendingPool(lendingPool);\n }\n\n /**\n * @dev Collect stkAave, convert it to AAVE send to Vault.\n */\n function collectRewardTokens()\n external\n override\n onlyHarvester\n nonReentrant\n {\n if (address(stkAave) == address(0)) {\n return;\n }\n\n // Check staked AAVE cooldown timer\n uint256 cooldown = stkAave.stakersCooldowns(address(this));\n uint256 windowStart = cooldown + stkAave.COOLDOWN_SECONDS();\n uint256 windowEnd = windowStart + stkAave.UNSTAKE_WINDOW();\n\n // If inside the unlock window, then we can redeem stkAave\n // for AAVE and send it to the vault.\n if (block.timestamp > windowStart && block.timestamp <= windowEnd) {\n // Redeem to AAVE\n uint256 stkAaveBalance = stkAave.balanceOf(address(this));\n stkAave.redeem(address(this), stkAaveBalance);\n\n // Transfer AAVE to harvesterAddress\n uint256 aaveBalance = IERC20(rewardTokenAddresses[0]).balanceOf(\n address(this)\n );\n if (aaveBalance > 0) {\n IERC20(rewardTokenAddresses[0]).safeTransfer(\n harvesterAddress,\n aaveBalance\n );\n }\n }\n\n // Collect available rewards and restart the cooldown timer, if either of\n // those should be run.\n if (block.timestamp > windowStart || cooldown == 0) {\n uint256 assetsLen = assetsMapped.length;\n // aToken addresses for incentives controller\n address[] memory aTokens = new address[](assetsLen);\n for (uint256 i = 0; i < assetsLen; ++i) {\n aTokens[i] = _getATokenFor(assetsMapped[i]);\n }\n\n // 1. If we have rewards availabile, collect them\n uint256 pendingRewards = incentivesController.getRewardsBalance(\n aTokens,\n address(this)\n );\n if (pendingRewards > 0) {\n // Because getting more stkAAVE from the incentives controller\n // with claimRewards() may push the stkAAVE cooldown time\n // forward, it is called after stakedAAVE has been turned into\n // AAVE.\n uint256 collected = incentivesController.claimRewards(\n aTokens,\n pendingRewards,\n address(this)\n );\n require(collected == pendingRewards, \"AAVE reward difference\");\n }\n\n // 2. Start cooldown counting down.\n if (stkAave.balanceOf(address(this)) > 0) {\n // Protected with if since cooldown call would revert\n // if no stkAave balance.\n stkAave.cooldown();\n }\n }\n }\n}\n" + }, + "contracts/strategies/balancer/BalancerMetaPoolStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OETH Balancer MetaStablePool Strategy\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { BaseAuraStrategy, BaseBalancerStrategy } from \"./BaseAuraStrategy.sol\";\nimport { IBalancerVault } from \"../../interfaces/balancer/IBalancerVault.sol\";\nimport { IRateProvider } from \"../../interfaces/balancer/IRateProvider.sol\";\nimport { IMetaStablePool } from \"../../interfaces/balancer/IMetaStablePool.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../../utils/InitializableAbstractStrategy.sol\";\nimport { StableMath } from \"../../utils/StableMath.sol\";\n\ncontract BalancerMetaPoolStrategy is BaseAuraStrategy {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n constructor(\n BaseStrategyConfig memory _stratConfig,\n BaseBalancerConfig memory _balancerConfig,\n address _auraRewardPoolAddress\n )\n InitializableAbstractStrategy(_stratConfig)\n BaseBalancerStrategy(_balancerConfig)\n BaseAuraStrategy(_auraRewardPoolAddress)\n {}\n\n /**\n * @notice There are no plans to configure BalancerMetaPool as a default\n * asset strategy. For that reason there is no need to support this\n * functionality.\n */\n function deposit(address, uint256)\n external\n override\n onlyVault\n nonReentrant\n {\n revert(\"Not supported\");\n }\n\n /**\n * @notice There are no plans to configure BalancerMetaPool as a default\n * asset strategy. For that reason there is no need to support this\n * functionality.\n */\n function deposit(address[] calldata, uint256[] calldata)\n external\n onlyVault\n nonReentrant\n {\n revert(\"Not supported\");\n }\n\n /**\n * @notice Deposits all supported assets in this strategy contract to the Balancer pool.\n */\n function depositAll() external override onlyVault nonReentrant {\n uint256 assetsLength = assetsMapped.length;\n address[] memory strategyAssets = new address[](assetsLength);\n uint256[] memory strategyAmounts = new uint256[](assetsLength);\n\n // For each vault collateral asset\n for (uint256 i = 0; i < assetsLength; ++i) {\n strategyAssets[i] = assetsMapped[i];\n // Get the asset balance in this strategy contract\n strategyAmounts[i] = IERC20(strategyAssets[i]).balanceOf(\n address(this)\n );\n }\n _deposit(strategyAssets, strategyAmounts);\n }\n\n /*\n * _deposit doesn't require a read-only re-entrancy protection since during the deposit\n * the function enters the Balancer Vault Context. If this function were called as part of\n * the attacking contract (while intercepting execution flow upon receiving ETH) the read-only\n * protection of the Balancer Vault would be triggered. Since the attacking contract would\n * already be in the Balancer Vault context and wouldn't be able to enter it again.\n */\n function _deposit(\n address[] memory _strategyAssets,\n uint256[] memory _strategyAmounts\n ) internal {\n require(\n _strategyAssets.length == _strategyAmounts.length,\n \"Array length missmatch\"\n );\n\n (IERC20[] memory tokens, , ) = balancerVault.getPoolTokens(\n balancerPoolId\n );\n\n uint256[] memory strategyAssetAmountsToPoolAssetAmounts = new uint256[](\n _strategyAssets.length\n );\n address[] memory strategyAssetsToPoolAssets = new address[](\n _strategyAssets.length\n );\n\n for (uint256 i = 0; i < _strategyAssets.length; ++i) {\n address strategyAsset = _strategyAssets[i];\n uint256 strategyAmount = _strategyAmounts[i];\n\n require(\n assetToPToken[strategyAsset] != address(0),\n \"Unsupported asset\"\n );\n strategyAssetsToPoolAssets[i] = _toPoolAsset(strategyAsset);\n\n if (strategyAmount > 0) {\n emit Deposit(strategyAsset, platformAddress, strategyAmount);\n\n // wrap rebasing assets like stETH and frxETH to wstETH and sfrxETH\n (, strategyAssetAmountsToPoolAssetAmounts[i]) = _wrapPoolAsset(\n strategyAsset,\n strategyAmount\n );\n }\n }\n\n uint256[] memory amountsIn = new uint256[](tokens.length);\n address[] memory poolAssets = new address[](tokens.length);\n for (uint256 i = 0; i < tokens.length; ++i) {\n // Convert IERC20 type to address\n poolAssets[i] = address(tokens[i]);\n\n // For each of the mapped assets\n for (uint256 j = 0; j < strategyAssetsToPoolAssets.length; ++j) {\n // If the pool asset is the same as the mapped asset\n if (poolAssets[i] == strategyAssetsToPoolAssets[j]) {\n amountsIn[i] = strategyAssetAmountsToPoolAssetAmounts[j];\n }\n }\n }\n\n uint256 minBPT = _getBPTExpected(\n strategyAssetsToPoolAssets,\n strategyAssetAmountsToPoolAssetAmounts\n );\n uint256 minBPTwDeviation = minBPT.mulTruncate(\n 1e18 - maxDepositDeviation\n );\n\n /* EXACT_TOKENS_IN_FOR_BPT_OUT:\n * User sends precise quantities of tokens, and receives an\n * estimated but unknown (computed at run time) quantity of BPT.\n *\n * ['uint256', 'uint256[]', 'uint256']\n * [EXACT_TOKENS_IN_FOR_BPT_OUT, amountsIn, minimumBPT]\n */\n bytes memory userData = abi.encode(\n IBalancerVault.WeightedPoolJoinKind.EXACT_TOKENS_IN_FOR_BPT_OUT,\n amountsIn,\n minBPTwDeviation\n );\n\n IBalancerVault.JoinPoolRequest memory request = IBalancerVault\n .JoinPoolRequest(poolAssets, amountsIn, userData, false);\n\n // Add the pool assets in this strategy to the balancer pool\n balancerVault.joinPool(\n balancerPoolId,\n address(this),\n address(this),\n request\n );\n\n // Deposit the Balancer Pool Tokens (BPT) into Aura\n _lpDepositAll();\n }\n\n /**\n * @notice Withdraw a Vault collateral asset from the Balancer pool.\n * @param _recipient Address to receive the Vault collateral assets. Typically is the Vault.\n * @param _strategyAsset Address of the Vault collateral asset\n * @param _strategyAmount The amount of Vault collateral assets to withdraw\n */\n function withdraw(\n address _recipient,\n address _strategyAsset,\n uint256 _strategyAmount\n ) external override onlyVault nonReentrant {\n address[] memory strategyAssets = new address[](1);\n uint256[] memory strategyAmounts = new uint256[](1);\n strategyAssets[0] = _strategyAsset;\n strategyAmounts[0] = _strategyAmount;\n\n _withdraw(_recipient, strategyAssets, strategyAmounts);\n }\n\n /**\n * @notice Withdraw multiple Vault collateral asset from the Balancer pool.\n * @param _recipient Address to receive the Vault collateral assets. Typically is the Vault.\n * @param _strategyAssets Addresses of the Vault collateral assets\n * @param _strategyAmounts The amounts of Vault collateral assets to withdraw\n */\n function withdraw(\n address _recipient,\n address[] calldata _strategyAssets,\n uint256[] calldata _strategyAmounts\n ) external onlyVault nonReentrant {\n _withdraw(_recipient, _strategyAssets, _strategyAmounts);\n }\n\n /**\n * @dev Withdraw multiple Vault collateral asset from the Balancer pool.\n * @param _recipient Address to receive the Vault collateral assets. Typically is the Vault.\n * @param _strategyAssets Addresses of the Vault collateral assets\n * @param _strategyAmounts The amounts of Vault collateral assets to withdraw\n *\n * _withdrawal doesn't require a read-only re-entrancy protection since during the withdrawal\n * the function enters the Balancer Vault Context. If this function were called as part of\n * the attacking contract (while intercepting execution flow upon receiving ETH) the read-only\n * protection of the Balancer Vault would be triggered. Since the attacking contract would\n * already be in the Balancer Vault context and wouldn't be able to enter it again.\n */\n function _withdraw(\n address _recipient,\n address[] memory _strategyAssets,\n uint256[] memory _strategyAmounts\n ) internal {\n require(\n _strategyAssets.length == _strategyAmounts.length,\n \"Invalid input arrays\"\n );\n\n for (uint256 i = 0; i < _strategyAssets.length; ++i) {\n require(\n assetToPToken[_strategyAssets[i]] != address(0),\n \"Unsupported asset\"\n );\n }\n\n // STEP 1 - Calculate the Balancer pool assets and amounts from the vault collateral assets\n\n // Get all the supported balancer pool assets\n (IERC20[] memory tokens, , ) = balancerVault.getPoolTokens(\n balancerPoolId\n );\n // Calculate the balancer pool assets and amounts to withdraw\n uint256[] memory poolAssetsAmountsOut = new uint256[](tokens.length);\n address[] memory poolAssets = new address[](tokens.length);\n // Is the wrapped asset amount indexed by the assets array, not the order of the Balancer pool tokens\n // eg wstETH and sfrxETH amounts, not the stETH and frxETH amounts\n uint256[] memory strategyAssetsToPoolAssetsAmounts = new uint256[](\n _strategyAssets.length\n );\n\n // For each of the Balancer pool assets\n for (uint256 i = 0; i < tokens.length; ++i) {\n poolAssets[i] = address(tokens[i]);\n\n // Convert the Balancer pool asset back to a vault collateral asset\n address strategyAsset = _fromPoolAsset(poolAssets[i]);\n\n // for each of the vault assets\n for (uint256 j = 0; j < _strategyAssets.length; ++j) {\n // If the vault asset equals the vault asset mapped from the Balancer pool asset\n if (_strategyAssets[j] == strategyAsset) {\n (, poolAssetsAmountsOut[i]) = _toPoolAsset(\n strategyAsset,\n _strategyAmounts[j]\n );\n strategyAssetsToPoolAssetsAmounts[j] = poolAssetsAmountsOut[\n i\n ];\n\n /* Because of the potential Balancer rounding error mentioned below\n * the contract might receive 1-2 WEI smaller amount than required\n * in the withdraw user data encoding. If slightly lesser token amount\n * is received the strategy can not unwrap the pool asset as it is\n * smaller than expected.\n *\n * For that reason we `overshoot` the required tokens expected to\n * circumvent the error\n */\n if (poolAssetsAmountsOut[i] > 0) {\n poolAssetsAmountsOut[i] += 2;\n }\n }\n }\n }\n\n // STEP 2 - Calculate the max about of Balancer Pool Tokens (BPT) to withdraw\n\n // Estimate the required amount of Balancer Pool Tokens (BPT) for the assets\n uint256 maxBPTtoWithdraw = _getBPTExpected(\n poolAssets,\n /* all non 0 values are overshot by 2 WEI and with the expected mainnet\n * ~1% withdrawal deviation, the 2 WEI aren't important\n */\n poolAssetsAmountsOut\n );\n // Increase BPTs by the max allowed deviation\n // Any excess BPTs will be left in this strategy contract\n maxBPTtoWithdraw = maxBPTtoWithdraw.mulTruncate(\n 1e18 + maxWithdrawalDeviation\n );\n\n // STEP 3 - Withdraw the Balancer Pool Tokens (BPT) from Aura to this strategy contract\n\n // Withdraw BPT from Aura allowing for BPTs left in this strategy contract from previous withdrawals\n _lpWithdraw(\n maxBPTtoWithdraw - IERC20(platformAddress).balanceOf(address(this))\n );\n\n // STEP 4 - Withdraw the balancer pool assets from the pool\n\n /* Custom asset exit: BPT_IN_FOR_EXACT_TOKENS_OUT:\n * User sends an estimated but unknown (computed at run time) quantity of BPT,\n * and receives precise quantities of specified tokens.\n *\n * ['uint256', 'uint256[]', 'uint256']\n * [BPT_IN_FOR_EXACT_TOKENS_OUT, amountsOut, maxBPTAmountIn]\n */\n bytes memory userData = abi.encode(\n IBalancerVault.WeightedPoolExitKind.BPT_IN_FOR_EXACT_TOKENS_OUT,\n poolAssetsAmountsOut,\n maxBPTtoWithdraw\n );\n\n IBalancerVault.ExitPoolRequest memory request = IBalancerVault\n .ExitPoolRequest(\n poolAssets,\n /* We specify the exact amount of a tokens we are expecting in the encoded\n * userData, for that reason we don't need to specify the amountsOut here.\n *\n * Also Balancer has a rounding issue that can make a transaction fail:\n * https://github.com/balancer/balancer-v2-monorepo/issues/2541\n * which is an extra reason why this field is empty.\n */\n new uint256[](tokens.length),\n userData,\n false\n );\n\n balancerVault.exitPool(\n balancerPoolId,\n address(this),\n /* Payable keyword is required because of the IBalancerVault interface even though\n * this strategy shall never be receiving native ETH\n */\n payable(address(this)),\n request\n );\n\n // STEP 5 - Re-deposit any left over BPT tokens back into Aura\n /* When concluding how much of BPT we need to withdraw from Aura we overshoot by\n * roughly around 1% (initial mainnet setting of maxWithdrawalDeviation). After exiting\n * the pool strategy could have left over BPT tokens that are not earning boosted yield.\n * We re-deploy those back in.\n */\n _lpDepositAll();\n\n // STEP 6 - Unswap balancer pool assets to vault collateral assets and send to the vault.\n\n // For each of the specified assets\n for (uint256 i = 0; i < _strategyAssets.length; ++i) {\n // Unwrap assets like wstETH and sfrxETH to rebasing assets stETH and frxETH\n if (strategyAssetsToPoolAssetsAmounts[i] > 0) {\n _unwrapPoolAsset(\n _strategyAssets[i],\n strategyAssetsToPoolAssetsAmounts[i]\n );\n }\n\n // Transfer the vault collateral assets to the recipient, which is typically the vault\n if (_strategyAmounts[i] > 0) {\n IERC20(_strategyAssets[i]).safeTransfer(\n _recipient,\n _strategyAmounts[i]\n );\n\n emit Withdrawal(\n _strategyAssets[i],\n platformAddress,\n _strategyAmounts[i]\n );\n }\n }\n }\n\n /**\n * @notice Withdraws all supported Vault collateral assets from the Balancer pool\n * and send to the OToken's Vault.\n *\n * Is only executable by the OToken's Vault or the Governor.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n // STEP 1 - Withdraw all Balancer Pool Tokens (BPT) from Aura to this strategy contract\n\n _lpWithdrawAll();\n // Get the BPTs withdrawn from Aura plus any that were already in this strategy contract\n uint256 BPTtoWithdraw = IERC20(platformAddress).balanceOf(\n address(this)\n );\n // Get the balancer pool assets and their total balances\n (IERC20[] memory tokens, , ) = balancerVault.getPoolTokens(\n balancerPoolId\n );\n uint256[] memory minAmountsOut = new uint256[](tokens.length);\n address[] memory poolAssets = new address[](tokens.length);\n for (uint256 i = 0; i < tokens.length; ++i) {\n poolAssets[i] = address(tokens[i]);\n }\n\n // STEP 2 - Withdraw the Balancer pool assets from the pool\n /* Proportional exit: EXACT_BPT_IN_FOR_TOKENS_OUT:\n * User sends a precise quantity of BPT, and receives an estimated but unknown\n * (computed at run time) quantity of a single token\n *\n * ['uint256', 'uint256']\n * [EXACT_BPT_IN_FOR_TOKENS_OUT, bptAmountIn]\n *\n * It is ok to pass an empty minAmountsOut since tilting the pool in any direction\n * when doing a proportional exit can only be beneficial to the strategy. Since\n * it will receive more of the underlying tokens for the BPT traded in.\n */\n bytes memory userData = abi.encode(\n IBalancerVault.WeightedPoolExitKind.EXACT_BPT_IN_FOR_TOKENS_OUT,\n BPTtoWithdraw\n );\n\n IBalancerVault.ExitPoolRequest memory request = IBalancerVault\n .ExitPoolRequest(poolAssets, minAmountsOut, userData, false);\n\n balancerVault.exitPool(\n balancerPoolId,\n address(this),\n /* Payable keyword is required because of the IBalancerVault interface even though\n * this strategy shall never be receiving native ETH\n */\n payable(address(this)),\n request\n );\n\n // STEP 3 - Convert the balancer pool assets to the vault collateral assets and send to the vault\n // For each of the Balancer pool assets\n for (uint256 i = 0; i < tokens.length; ++i) {\n address poolAsset = address(tokens[i]);\n // Convert the balancer pool asset to the strategy asset\n address strategyAsset = _fromPoolAsset(poolAsset);\n // Get the balancer pool assets withdraw from the pool plus any that were already in this strategy contract\n uint256 poolAssetAmount = IERC20(poolAsset).balanceOf(\n address(this)\n );\n\n // Unwrap assets like wstETH and sfrxETH to rebasing assets stETH and frxETH\n uint256 unwrappedAmount = 0;\n if (poolAssetAmount > 0) {\n unwrappedAmount = _unwrapPoolAsset(\n strategyAsset,\n poolAssetAmount\n );\n }\n\n // Transfer the vault collateral assets to the vault\n if (unwrappedAmount > 0) {\n IERC20(strategyAsset).safeTransfer(\n vaultAddress,\n unwrappedAmount\n );\n emit Withdrawal(\n strategyAsset,\n platformAddress,\n unwrappedAmount\n );\n }\n }\n }\n\n /**\n * @notice Approves the Balancer Vault to transfer poolAsset counterparts\n * of all of the supported assets from this strategy. E.g. stETH is a supported\n * strategy and Balancer Vault gets unlimited approval to transfer wstETH.\n *\n * If Balancer pool uses a wrapped version of a supported asset then also approve\n * unlimited usage of an asset to the contract responsible for wrapping.\n *\n * Approve unlimited spending by Balancer Vault and Aura reward pool of the\n * pool BPT tokens.\n *\n * Is only executable by the Governor.\n */\n function safeApproveAllTokens()\n external\n override\n onlyGovernor\n nonReentrant\n {\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n _abstractSetPToken(assetsMapped[i], platformAddress);\n }\n _approveBase();\n }\n\n // solhint-disable-next-line no-unused-vars\n function _abstractSetPToken(address _asset, address) internal override {\n address poolAsset = _toPoolAsset(_asset);\n if (_asset == stETH) {\n // slither-disable-next-line unused-return\n IERC20(stETH).approve(wstETH, type(uint256).max);\n } else if (_asset == frxETH) {\n // slither-disable-next-line unused-return\n IERC20(frxETH).approve(sfrxETH, type(uint256).max);\n }\n _approveAsset(poolAsset);\n }\n\n /**\n * @dev Approves the Balancer Vault to transfer an asset from\n * this strategy. The assets could be a Vault collateral asset\n * like WETH or rETH; or a Balancer pool asset that wraps the vault asset\n * like wstETH or sfrxETH.\n */\n function _approveAsset(address _asset) internal {\n IERC20 asset = IERC20(_asset);\n // slither-disable-next-line unused-return\n asset.approve(address(balancerVault), type(uint256).max);\n }\n\n /**\n * @notice Returns the rate supplied by the Balancer configured rate\n * provider. Rate is used to normalize the token to common underlying\n * pool denominator. (ETH for ETH Liquid staking derivatives)\n *\n * @param _asset Address of the Balancer pool asset\n * @return rate of the corresponding asset\n */\n function _getRateProviderRate(address _asset)\n internal\n view\n override\n returns (uint256)\n {\n IMetaStablePool pool = IMetaStablePool(platformAddress);\n IRateProvider[] memory providers = pool.getRateProviders();\n (IERC20[] memory tokens, , ) = balancerVault.getPoolTokens(\n balancerPoolId\n );\n\n uint256 providersLength = providers.length;\n for (uint256 i = 0; i < providersLength; ++i) {\n // _assets and corresponding rate providers are all in the same order\n if (address(tokens[i]) == _asset) {\n // rate provider doesn't exist, defaults to 1e18\n if (address(providers[i]) == address(0)) {\n return 1e18;\n }\n return providers[i].getRate();\n }\n }\n\n // should never happen\n assert(false);\n }\n}\n" + }, + "contracts/strategies/balancer/BaseAuraStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OETH Base Balancer Abstract Strategy\n * @author Origin Protocol Inc\n */\n\nimport { BaseBalancerStrategy } from \"./BaseBalancerStrategy.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20 } from \"../../utils/InitializableAbstractStrategy.sol\";\nimport { IERC4626 } from \"../../../lib/openzeppelin/interfaces/IERC4626.sol\";\nimport { StableMath } from \"../../utils/StableMath.sol\";\nimport { IRewardStaking } from \"../IRewardStaking.sol\";\n\nabstract contract BaseAuraStrategy is BaseBalancerStrategy {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n /// @notice Address of the Aura rewards pool\n address public immutable auraRewardPoolAddress;\n\n // renamed from __reserved to not shadow BaseBalancerStrategy.__reserved,\n int256[50] private __reserved_baseAuraStrategy;\n\n constructor(address _auraRewardPoolAddress) {\n auraRewardPoolAddress = _auraRewardPoolAddress;\n }\n\n /**\n * @dev Deposit all Balancer Pool Tokens (BPT) in this strategy contract\n * to the Aura rewards pool.\n */\n function _lpDepositAll() internal virtual override {\n uint256 bptBalance = IERC20(platformAddress).balanceOf(address(this));\n uint256 auraLp = IERC4626(auraRewardPoolAddress).deposit(\n bptBalance,\n address(this)\n );\n require(bptBalance == auraLp, \"Aura LP != BPT\");\n }\n\n /**\n * @dev Withdraw `numBPTTokens` Balancer Pool Tokens (BPT) from\n * the Aura rewards pool to this strategy contract.\n * @param numBPTTokens Number of Balancer Pool Tokens (BPT) to withdraw\n */\n function _lpWithdraw(uint256 numBPTTokens) internal virtual override {\n IRewardStaking(auraRewardPoolAddress).withdrawAndUnwrap(\n numBPTTokens,\n true // also claim reward tokens\n );\n }\n\n /**\n * @dev Withdraw all Balancer Pool Tokens (BPT) from\n * the Aura rewards pool to this strategy contract.\n */\n function _lpWithdrawAll() internal virtual override {\n // Get all the strategy's BPTs in Aura\n // maxRedeem is implemented as balanceOf(address) in Aura\n uint256 bptBalance = IERC4626(auraRewardPoolAddress).maxRedeem(\n address(this)\n );\n\n IRewardStaking(auraRewardPoolAddress).withdrawAndUnwrap(\n bptBalance,\n true // also claim reward tokens\n );\n }\n\n /**\n * @notice Collects BAL and AURA tokens from the rewards pool.\n */\n function collectRewardTokens()\n external\n virtual\n override\n onlyHarvester\n nonReentrant\n {\n /* Similar to Convex, calling this function collects both of the\n * accrued BAL and AURA tokens.\n */\n IRewardStaking(auraRewardPoolAddress).getReward();\n _collectRewardTokens();\n }\n\n /// @notice Balancer Pool Tokens (BPT) in the Balancer pool and the Aura rewards pool.\n function _getBalancerPoolTokens()\n internal\n view\n override\n returns (uint256 balancerPoolTokens)\n {\n balancerPoolTokens =\n IERC20(platformAddress).balanceOf(address(this)) +\n // maxRedeem is implemented as balanceOf(address) in Aura\n IERC4626(auraRewardPoolAddress).maxRedeem(address(this));\n }\n\n function _approveBase() internal virtual override {\n super._approveBase();\n\n IERC20 pToken = IERC20(platformAddress);\n pToken.safeApprove(auraRewardPoolAddress, type(uint256).max);\n }\n}\n" + }, + "contracts/strategies/balancer/BaseBalancerStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OETH Base Balancer Abstract Strategy\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../../utils/InitializableAbstractStrategy.sol\";\nimport { IBalancerVault } from \"../../interfaces/balancer/IBalancerVault.sol\";\nimport { IRateProvider } from \"../../interfaces/balancer/IRateProvider.sol\";\nimport { VaultReentrancyLib } from \"./VaultReentrancyLib.sol\";\nimport { IOracle } from \"../../interfaces/IOracle.sol\";\nimport { IWstETH } from \"../../interfaces/IWstETH.sol\";\nimport { IERC4626 } from \"../../../lib/openzeppelin/interfaces/IERC4626.sol\";\nimport { StableMath } from \"../../utils/StableMath.sol\";\n\nabstract contract BaseBalancerStrategy is InitializableAbstractStrategy {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n address public immutable rETH;\n address public immutable stETH;\n address public immutable wstETH;\n address public immutable frxETH;\n address public immutable sfrxETH;\n\n /// @notice Address of the Balancer vault\n IBalancerVault public immutable balancerVault;\n /// @notice Balancer pool identifier\n bytes32 public immutable balancerPoolId;\n\n // Max withdrawal deviation denominated in 1e18 (1e18 == 100%)\n uint256 public maxWithdrawalDeviation;\n // Max deposit deviation denominated in 1e18 (1e18 == 100%)\n uint256 public maxDepositDeviation;\n\n int256[48] private __reserved;\n\n struct BaseBalancerConfig {\n address rEthAddress; // Address of the rETH token\n address stEthAddress; // Address of the stETH token\n address wstEthAddress; // Address of the wstETH token\n address frxEthAddress; // Address of the frxEth token\n address sfrxEthAddress; // Address of the sfrxEth token\n address balancerVaultAddress; // Address of the Balancer vault\n bytes32 balancerPoolId; // Balancer pool identifier\n }\n\n event MaxWithdrawalDeviationUpdated(\n uint256 _prevMaxDeviationPercentage,\n uint256 _newMaxDeviationPercentage\n );\n event MaxDepositDeviationUpdated(\n uint256 _prevMaxDeviationPercentage,\n uint256 _newMaxDeviationPercentage\n );\n\n /**\n * @dev Ensure we are not in a Vault context when this function is called, by attempting a no-op internal\n * balance operation. If we are already in a Vault transaction (e.g., a swap, join, or exit), the Vault's\n * reentrancy protection will cause this function to revert.\n *\n * Use this modifier with any function that can cause a state change in a pool and is either public itself,\n * or called by a public function *outside* a Vault operation (e.g., join, exit, or swap).\n *\n * This is to protect against Balancer's read-only re-entrancy vulnerability:\n * https://www.notion.so/originprotocol/Balancer-read-only-reentrancy-c686e72c82414ef18fa34312bb02e11b\n */\n modifier whenNotInBalancerVaultContext() {\n VaultReentrancyLib.ensureNotInVaultContext(balancerVault);\n _;\n }\n\n constructor(BaseBalancerConfig memory _balancerConfig) {\n rETH = _balancerConfig.rEthAddress;\n stETH = _balancerConfig.stEthAddress;\n wstETH = _balancerConfig.wstEthAddress;\n frxETH = _balancerConfig.frxEthAddress;\n sfrxETH = _balancerConfig.sfrxEthAddress;\n\n balancerVault = IBalancerVault(_balancerConfig.balancerVaultAddress);\n balancerPoolId = _balancerConfig.balancerPoolId;\n }\n\n /**\n * Initializer for setting up strategy internal state. This overrides the\n * InitializableAbstractStrategy initializer as Balancer's strategies don't fit\n * well within that abstraction.\n * @param _rewardTokenAddresses Address of BAL & AURA\n * @param _assets Addresses of supported assets. MUST be passed in the same\n * order as returned by coins on the pool contract, i.e.\n * WETH, stETH\n * @param _pTokens Platform Token corresponding addresses\n */\n function initialize(\n address[] calldata _rewardTokenAddresses, // BAL & AURA\n address[] calldata _assets,\n address[] calldata _pTokens\n ) external onlyGovernor initializer {\n maxWithdrawalDeviation = 1e16;\n maxDepositDeviation = 1e16;\n\n emit MaxWithdrawalDeviationUpdated(0, maxWithdrawalDeviation);\n emit MaxDepositDeviationUpdated(0, maxDepositDeviation);\n\n IERC20[] memory poolAssets = _getPoolAssets();\n require(\n poolAssets.length == _assets.length,\n \"Pool assets length mismatch\"\n );\n for (uint256 i = 0; i < _assets.length; ++i) {\n address asset = _fromPoolAsset(address(poolAssets[i]));\n require(_assets[i] == asset, \"Pool assets mismatch\");\n }\n\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n _approveBase();\n }\n\n /**\n * @notice Returns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return assetToPToken[_asset] != address(0);\n }\n\n /**\n * @notice Get strategy's share of an assets in the Balancer pool.\n * This is not denominated in OUSD/ETH value of the assets in the Balancer pool.\n * @param _asset Address of the Vault collateral asset\n * @return amount the amount of vault collateral assets\n *\n * IMPORTANT if this function is overridden it needs to have a whenNotInBalancerVaultContext\n * modifier on it or it is susceptible to read-only re-entrancy attack\n *\n * @dev it is important that this function is not affected by reporting inflated\n * values of assets in case of any pool manipulation. Such a manipulation could easily\n * exploit the protocol by:\n * - minting OETH\n * - tilting Balancer pool to report higher balances of assets\n * - rebasing() -> all that extra token balances get distributed to OETH holders\n * - tilting pool back\n * - redeeming OETH\n */\n function checkBalance(address _asset)\n external\n view\n virtual\n override\n whenNotInBalancerVaultContext\n returns (uint256 amount)\n {\n require(assetToPToken[_asset] != address(0), \"Unsupported asset\");\n\n uint256 bptBalance = _getBalancerPoolTokens();\n\n /* To calculate the worth of queried asset:\n * - assume that all tokens normalized to their ETH value have an equal split balance\n * in the pool when it is balanced\n * - multiply the BPT amount with the bpt rate to get the ETH denominated amount\n * of strategy's holdings\n * - divide that by the number of tokens we support in the pool to get ETH denominated\n * amount that is applicable to each supported token in the pool.\n *\n * It would be possible to support only 1 asset in the pool (and be exposed to all\n * the assets while holding BPT tokens) and deposit/withdraw/checkBalance using only\n * that asset. TBD: changes to other functions still required if we ever decide to\n * go with such configuration.\n */\n amount = (bptBalance.mulTruncate(\n IRateProvider(platformAddress).getRate()\n ) / assetsMapped.length);\n\n /* If the pool asset is equal to (strategy )_asset it means that a rate\n * provider for that asset exists and that asset is not necessarily\n * pegged to a unit (ETH).\n *\n * Because this function returns the balance of the asset and is not denominated in\n * ETH units we need to convert the ETH denominated amount to asset amount.\n */\n if (_toPoolAsset(_asset) == _asset) {\n amount = amount.divPrecisely(_getRateProviderRate(_asset));\n }\n }\n\n /**\n * @notice Returns the value of all assets managed by this strategy.\n * Uses the Balancer pool's rate (virtual price) to convert the strategy's\n * Balancer Pool Tokens (BPT) to ETH value.\n * @return value The ETH value\n *\n * IMPORTANT if this function is overridden it needs to have a whenNotInBalancerVaultContext\n * modifier on it or it is susceptible to read-only re-entrancy attack\n */\n function checkBalance()\n external\n view\n virtual\n whenNotInBalancerVaultContext\n returns (uint256 value)\n {\n uint256 bptBalance = _getBalancerPoolTokens();\n\n // Convert BPT to ETH value\n value = bptBalance.mulTruncate(\n IRateProvider(platformAddress).getRate()\n );\n }\n\n /// @notice Balancer Pool Tokens (BPT) in the Balancer pool.\n function _getBalancerPoolTokens()\n internal\n view\n virtual\n returns (uint256 balancerPoolTokens)\n {\n balancerPoolTokens = IERC20(platformAddress).balanceOf(address(this));\n }\n\n /* solhint-disable max-line-length */\n /**\n * @notice BPT price is calculated by taking the rate from the rateProvider of the asset in\n * question. If one does not exist it defaults to 1e18. To get the final BPT expected that\n * is multiplied by the underlying asset amount divided by BPT token rate. BPT token rate is\n * similar to Curve's virtual_price and expresses how much has the price of BPT appreciated\n * (e.g. due to swap fees) in relation to the underlying assets\n *\n * Using the above approach makes the strategy vulnerable to a possible MEV attack using\n * flash loan to manipulate the pool before a deposit/withdrawal since the function ignores\n * market values of the assets being priced in BPT.\n *\n * At the time of writing there is no safe on-chain approach to pricing BPT in a way that it\n * would make it invulnerable to MEV pool manipulation. See recent Balancer exploit:\n * https://www.notion.so/originprotocol/Balancer-OETH-strategy-9becdea132704e588782a919d7d471eb?pvs=4#1cf07de12fc64f1888072321e0644348\n *\n * To mitigate MEV possibilities during deposits and withdraws, the VaultValueChecker will use checkBalance before and after the move\n * to ensure the expected changes took place.\n *\n * @param _asset Address of the Balancer pool asset\n * @param _amount Amount of the Balancer pool asset\n * @return bptExpected of BPT expected in exchange for the asset\n *\n * @dev\n * bptAssetPrice = 1e18 (asset peg) * pool_asset_rate\n *\n * bptExpected = bptAssetPrice * asset_amount / BPT_token_rate\n *\n * bptExpected = 1e18 (asset peg) * pool_asset_rate * asset_amount / BPT_token_rate\n * bptExpected = asset_amount * pool_asset_rate / BPT_token_rate\n *\n * further information available here:\n * https://www.notion.so/originprotocol/Balancer-OETH-strategy-9becdea132704e588782a919d7d471eb?pvs=4#ce01495ae70346d8971f5dced809fb83\n */\n /* solhint-enable max-line-length */\n function _getBPTExpected(address _asset, uint256 _amount)\n internal\n view\n virtual\n returns (uint256 bptExpected)\n {\n uint256 bptRate = IRateProvider(platformAddress).getRate();\n uint256 poolAssetRate = _getRateProviderRate(_asset);\n bptExpected = _amount.mulTruncate(poolAssetRate).divPrecisely(bptRate);\n }\n\n function _getBPTExpected(\n address[] memory _assets,\n uint256[] memory _amounts\n ) internal view virtual returns (uint256 bptExpected) {\n require(_assets.length == _amounts.length, \"Assets & amounts mismatch\");\n\n for (uint256 i = 0; i < _assets.length; ++i) {\n uint256 poolAssetRate = _getRateProviderRate(_assets[i]);\n // convert asset amount to ETH amount\n bptExpected += _amounts[i].mulTruncate(poolAssetRate);\n }\n\n uint256 bptRate = IRateProvider(platformAddress).getRate();\n // Convert ETH amount to BPT amount\n bptExpected = bptExpected.divPrecisely(bptRate);\n }\n\n function _lpDepositAll() internal virtual;\n\n function _lpWithdraw(uint256 numBPTTokens) internal virtual;\n\n function _lpWithdrawAll() internal virtual;\n\n /**\n * @notice Balancer returns assets and rateProviders for corresponding assets ordered\n * by numerical order.\n */\n function _getPoolAssets() internal view returns (IERC20[] memory assets) {\n // slither-disable-next-line unused-return\n (assets, , ) = balancerVault.getPoolTokens(balancerPoolId);\n }\n\n /**\n * @dev If an asset is rebasing the Balancer pools have a wrapped versions of assets\n * that the strategy supports. This function converts the pool(wrapped) asset\n * and corresponding amount to strategy asset.\n */\n function _toPoolAsset(address asset, uint256 amount)\n internal\n view\n returns (address poolAsset, uint256 poolAmount)\n {\n if (asset == stETH) {\n poolAsset = wstETH;\n if (amount > 0) {\n poolAmount = IWstETH(wstETH).getWstETHByStETH(amount);\n }\n } else if (asset == frxETH) {\n poolAsset = sfrxETH;\n if (amount > 0) {\n poolAmount = IERC4626(sfrxETH).convertToShares(amount);\n }\n } else {\n poolAsset = asset;\n poolAmount = amount;\n }\n }\n\n /**\n * @dev Converts a Vault collateral asset to a Balancer pool asset.\n * stETH becomes wstETH, frxETH becomes sfrxETH and everything else stays the same.\n * @param asset Address of the Vault collateral asset.\n * @return Address of the Balancer pool asset.\n */\n function _toPoolAsset(address asset) internal view returns (address) {\n if (asset == stETH) {\n return wstETH;\n } else if (asset == frxETH) {\n return sfrxETH;\n }\n return asset;\n }\n\n /**\n * @dev Converts rebasing asset to its wrapped counterpart.\n */\n function _wrapPoolAsset(address asset, uint256 amount)\n internal\n returns (address wrappedAsset, uint256 wrappedAmount)\n {\n if (asset == stETH) {\n wrappedAsset = wstETH;\n if (amount > 0) {\n wrappedAmount = IWstETH(wstETH).wrap(amount);\n }\n } else if (asset == frxETH) {\n wrappedAsset = sfrxETH;\n if (amount > 0) {\n wrappedAmount = IERC4626(sfrxETH).deposit(\n amount,\n address(this)\n );\n }\n } else {\n wrappedAsset = asset;\n wrappedAmount = amount;\n }\n }\n\n /**\n * @dev Converts wrapped asset to its rebasing counterpart.\n */\n function _unwrapPoolAsset(address asset, uint256 amount)\n internal\n returns (uint256 unwrappedAmount)\n {\n if (asset == stETH) {\n unwrappedAmount = IWstETH(wstETH).unwrap(amount);\n } else if (asset == frxETH) {\n unwrappedAmount = IERC4626(sfrxETH).withdraw(\n amount,\n address(this),\n address(this)\n );\n } else {\n unwrappedAmount = amount;\n }\n }\n\n /**\n * @dev If an asset is rebasing the Balancer pools have a wrapped versions of assets\n * that the strategy supports. This function converts the rebasing strategy asset\n * and corresponding amount to wrapped(pool) asset.\n */\n function _fromPoolAsset(address poolAsset, uint256 poolAmount)\n internal\n view\n returns (address asset, uint256 amount)\n {\n if (poolAsset == wstETH) {\n asset = stETH;\n if (poolAmount > 0) {\n amount = IWstETH(wstETH).getStETHByWstETH(poolAmount);\n }\n } else if (poolAsset == sfrxETH) {\n asset = frxETH;\n if (poolAmount > 0) {\n amount = IERC4626(sfrxETH).convertToAssets(poolAmount);\n }\n } else {\n asset = poolAsset;\n amount = poolAmount;\n }\n }\n\n function _fromPoolAsset(address poolAsset)\n internal\n view\n returns (address asset)\n {\n if (poolAsset == wstETH) {\n asset = stETH;\n } else if (poolAsset == sfrxETH) {\n asset = frxETH;\n } else {\n asset = poolAsset;\n }\n }\n\n /**\n * @notice Sets max withdrawal deviation that is considered when removing\n * liquidity from Balancer pools.\n * @param _maxWithdrawalDeviation Max withdrawal deviation denominated in\n * wad (number with 18 decimals): 1e18 == 100%, 1e16 == 1%\n *\n * IMPORTANT Minimum maxWithdrawalDeviation will be 1% (1e16) for production\n * usage. Vault value checker in combination with checkBalance will\n * catch any unexpected manipulation.\n */\n function setMaxWithdrawalDeviation(uint256 _maxWithdrawalDeviation)\n external\n onlyVaultOrGovernorOrStrategist\n {\n require(\n _maxWithdrawalDeviation <= 1e18,\n \"Withdrawal dev. out of bounds\"\n );\n emit MaxWithdrawalDeviationUpdated(\n maxWithdrawalDeviation,\n _maxWithdrawalDeviation\n );\n maxWithdrawalDeviation = _maxWithdrawalDeviation;\n }\n\n /**\n * @notice Sets max deposit deviation that is considered when adding\n * liquidity to Balancer pools.\n * @param _maxDepositDeviation Max deposit deviation denominated in\n * wad (number with 18 decimals): 1e18 == 100%, 1e16 == 1%\n *\n * IMPORTANT Minimum maxDepositDeviation will default to 1% (1e16)\n * for production usage. Vault value checker in combination with\n * checkBalance will catch any unexpected manipulation.\n */\n function setMaxDepositDeviation(uint256 _maxDepositDeviation)\n external\n onlyVaultOrGovernorOrStrategist\n {\n require(_maxDepositDeviation <= 1e18, \"Deposit dev. out of bounds\");\n emit MaxDepositDeviationUpdated(\n maxDepositDeviation,\n _maxDepositDeviation\n );\n maxDepositDeviation = _maxDepositDeviation;\n }\n\n function _approveBase() internal virtual {\n IERC20 pToken = IERC20(platformAddress);\n // Balancer vault for BPT token (required for removing liquidity)\n pToken.safeApprove(address(balancerVault), type(uint256).max);\n }\n\n function _getRateProviderRate(address _asset)\n internal\n view\n virtual\n returns (uint256);\n}\n" + }, + "contracts/strategies/balancer/VaultReentrancyLib.sol": { + "content": "// SPDX-License-Identifier: GPL-3.0-or-later\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU General Public License as published by\n// the Free Software Foundation, either version 3 of the License, or\n// (at your option) any later version.\n\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n// GNU General Public License for more details.\n\n// You should have received a copy of the GNU General Public License\n// along with this program. If not, see .\n\npragma solidity >=0.7.0 <0.9.0;\n\nimport \"../../utils/BalancerErrors.sol\";\nimport { IBalancerVault } from \"../../interfaces/balancer/IBalancerVault.sol\";\n\nlibrary VaultReentrancyLib {\n /**\n * @dev Ensure we are not in a Vault context when this function is called, by attempting a no-op internal\n * balance operation. If we are already in a Vault transaction (e.g., a swap, join, or exit), the Vault's\n * reentrancy protection will cause this function to revert.\n *\n * The exact function call doesn't really matter: we're just trying to trigger the Vault reentrancy check\n * (and not hurt anything in case it works). An empty operation array with no specific operation at all works\n * for that purpose, and is also the least expensive in terms of gas and bytecode size.\n *\n * Call this at the top of any function that can cause a state change in a pool and is either public itself,\n * or called by a public function *outside* a Vault operation (e.g., join, exit, or swap).\n *\n * If this is *not* called in functions that are vulnerable to the read-only reentrancy issue described\n * here (https://forum.balancer.fi/t/reentrancy-vulnerability-scope-expanded/4345), those functions are unsafe,\n * and subject to manipulation that may result in loss of funds.\n */\n function ensureNotInVaultContext(IBalancerVault vault) internal view {\n // Perform the following operation to trigger the Vault's reentrancy guard:\n //\n // IBalancerVault.UserBalanceOp[] memory noop = new IBalancerVault.UserBalanceOp[](0);\n // _vault.manageUserBalance(noop);\n //\n // However, use a static call so that it can be a view function (even though the function is non-view).\n // This allows the library to be used more widely, as some functions that need to be protected might be\n // view.\n //\n // This staticcall always reverts, but we need to make sure it doesn't fail due to a re-entrancy attack.\n // Staticcalls consume all gas forwarded to them on a revert caused by storage modification.\n // By default, almost the entire available gas is forwarded to the staticcall,\n // causing the entire call to revert with an 'out of gas' error.\n //\n // We set the gas limit to 10k for the staticcall to\n // avoid wasting gas when it reverts due to storage modification.\n // `manageUserBalance` is a non-reentrant function in the Vault, so calling it invokes `_enterNonReentrant`\n // in the `ReentrancyGuard` contract, reproduced here:\n //\n // function _enterNonReentrant() private {\n // // If the Vault is actually being reentered, it will revert in the first line, at the `_require` that\n // // checks the reentrancy flag, with \"BAL#400\" (corresponding to Errors.REENTRANCY) in the revertData.\n // // The full revertData will be: `abi.encodeWithSignature(\"Error(string)\", \"BAL#400\")`.\n // _require(_status != _ENTERED, Errors.REENTRANCY);\n //\n // // If the Vault is not being reentered, the check above will pass: but it will *still* revert,\n // // because the next line attempts to modify storage during a staticcall. However, this type of\n // // failure results in empty revertData.\n // _status = _ENTERED;\n // }\n //\n // So based on this analysis, there are only two possible revertData values: empty, or abi.encoded BAL#400.\n //\n // It is of course much more bytecode and gas efficient to check for zero-length revertData than to compare it\n // to the encoded REENTRANCY revertData.\n //\n // While it should be impossible for the call to fail in any other way (especially since it reverts before\n // `manageUserBalance` even gets called), any other error would generate non-zero revertData, so checking for\n // empty data guards against this case too.\n\n (, bytes memory revertData) = address(vault).staticcall{ gas: 10_000 }(\n abi.encodeWithSelector(vault.manageUserBalance.selector, 0)\n );\n\n _require(revertData.length == 0, Errors.REENTRANCY);\n }\n}\n" + }, + "contracts/strategies/BaseCompoundStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Base Compound Abstract Strategy\n * @author Origin Protocol Inc\n */\n\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { ICERC20 } from \"./ICompound.sol\";\nimport { IComptroller } from \"../interfaces/IComptroller.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\n\nabstract contract BaseCompoundStrategy is InitializableAbstractStrategy {\n using SafeERC20 for IERC20;\n\n int256[50] private __reserved;\n\n /**\n * @dev Retuns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return assetToPToken[_asset] != address(0);\n }\n\n /**\n * @dev Get the cToken wrapped in the ICERC20 interface for this asset.\n * Fails if the pToken doesn't exist in our mappings.\n * @param _asset Address of the asset\n * @return Corresponding cToken to this asset\n */\n function _getCTokenFor(address _asset) internal view returns (ICERC20) {\n address cToken = assetToPToken[_asset];\n require(cToken != address(0), \"cToken does not exist\");\n return ICERC20(cToken);\n }\n\n /**\n * @dev Converts an underlying amount into cToken amount\n * cTokenAmt = (underlying * 1e18) / exchangeRate\n * @param _cToken cToken for which to change\n * @param _underlying Amount of underlying to convert\n * @return amount Equivalent amount of cTokens\n */\n function _convertUnderlyingToCToken(ICERC20 _cToken, uint256 _underlying)\n internal\n view\n returns (uint256 amount)\n {\n // e.g. 1e18*1e18 / 205316390724364402565641705 = 50e8\n // e.g. 1e8*1e18 / 205316390724364402565641705 = 0.45 or 0\n amount = (_underlying * 1e18) / _cToken.exchangeRateStored();\n }\n}\n" + }, + "contracts/strategies/BaseConvexMetaStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Curve Convex Strategy\n * @notice Investment strategy for investing stablecoins via Curve 3Pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { IRewardStaking } from \"./IRewardStaking.sol\";\nimport { ICurvePool } from \"./ICurvePool.sol\";\nimport { ICurveMetaPool } from \"./ICurveMetaPool.sol\";\nimport { IERC20, BaseCurveStrategy, InitializableAbstractStrategy } from \"./BaseCurveStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\n\nabstract contract BaseConvexMetaStrategy is BaseCurveStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n event MaxWithdrawalSlippageUpdated(\n uint256 _prevMaxSlippagePercentage,\n uint256 _newMaxSlippagePercentage\n );\n\n // used to circumvent the stack too deep issue\n struct InitConfig {\n address cvxDepositorAddress; //Address of the Convex depositor(AKA booster) for this pool\n address metapoolAddress; //Address of the Curve MetaPool\n address metapoolMainToken; //Address of Main metapool token\n address cvxRewardStakerAddress; //Address of the CVX rewards staker\n address metapoolLPToken; //Address of metapool LP token\n uint256 cvxDepositorPTokenId; //Pid of the pool referred to by Depositor and staker\n }\n\n address internal cvxDepositorAddress;\n address internal cvxRewardStakerAddress;\n uint256 internal cvxDepositorPTokenId;\n ICurveMetaPool internal metapool;\n IERC20 internal metapoolMainToken;\n IERC20 internal metapoolLPToken;\n // Ordered list of metapool assets\n address[] internal metapoolAssets;\n // Max withdrawal slippage denominated in 1e18 (1e18 == 100%)\n uint256 public maxWithdrawalSlippage;\n uint128 internal crvCoinIndex;\n uint128 internal mainCoinIndex;\n\n int256[41] private ___reserved;\n\n /**\n * Initializer for setting up strategy internal state. This overrides the\n * InitializableAbstractStrategy initializer as Curve strategies don't fit\n * well within that abstraction.\n * @param _rewardTokenAddresses Address of CRV & CVX\n * @param _assets Addresses of supported assets. MUST be passed in the same\n * order as returned by coins on the pool contract, i.e.\n * DAI, USDC, USDT\n * @param _pTokens Platform Token corresponding addresses\n * @param initConfig Various addresses and info for initialization state\n */\n function initialize(\n address[] calldata _rewardTokenAddresses, // CRV + CVX\n address[] calldata _assets,\n address[] calldata _pTokens,\n InitConfig calldata initConfig\n ) external onlyGovernor initializer {\n require(_assets.length == 3, \"Must have exactly three assets\");\n // Should be set prior to abstract initialize call otherwise\n // abstractSetPToken calls will fail\n cvxDepositorAddress = initConfig.cvxDepositorAddress;\n pTokenAddress = _pTokens[0];\n metapool = ICurveMetaPool(initConfig.metapoolAddress);\n metapoolMainToken = IERC20(initConfig.metapoolMainToken);\n cvxRewardStakerAddress = initConfig.cvxRewardStakerAddress;\n metapoolLPToken = IERC20(initConfig.metapoolLPToken);\n cvxDepositorPTokenId = initConfig.cvxDepositorPTokenId;\n maxWithdrawalSlippage = 1e16;\n\n metapoolAssets = [metapool.coins(0), metapool.coins(1)];\n crvCoinIndex = _getMetapoolCoinIndex(pTokenAddress);\n mainCoinIndex = _getMetapoolCoinIndex(initConfig.metapoolMainToken);\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n _approveBase();\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n public\n view\n virtual\n override\n returns (uint256 balance)\n {\n require(assetToPToken[_asset] != address(0), \"Unsupported asset\");\n balance = 0;\n\n // LP tokens in this contract. This should generally be nothing as we\n // should always stake the full balance in the Gauge, but include for\n // safety\n uint256 contractPTokens = IERC20(pTokenAddress).balanceOf(\n address(this)\n );\n ICurvePool curvePool = ICurvePool(platformAddress);\n if (contractPTokens > 0) {\n uint256 virtual_price = curvePool.get_virtual_price();\n uint256 value = contractPTokens.mulTruncate(virtual_price);\n balance += value;\n }\n\n /* We intentionally omit the metapoolLp tokens held by the metastrategyContract\n * since the contract should never (except in the middle of deposit/withdrawal\n * transaction) hold any amount of those tokens in normal operation. There\n * could be tokens sent to it by a 3rd party and we decide to actively ignore\n * those.\n */\n uint256 metapoolGaugePTokens = IRewardStaking(cvxRewardStakerAddress)\n .balanceOf(address(this));\n\n if (metapoolGaugePTokens > 0) {\n uint256 value = metapoolGaugePTokens.mulTruncate(\n metapool.get_virtual_price()\n );\n balance += value;\n }\n\n uint256 assetDecimals = Helpers.getDecimals(_asset);\n balance = balance.scaleBy(assetDecimals, 18) / THREEPOOL_ASSET_COUNT;\n }\n\n /**\n * @dev This function is completely analogous to _calcCurveTokenAmount[BaseCurveStrategy]\n * and just utilizes different Curve (meta)pool API\n */\n function _calcCurveMetaTokenAmount(uint128 _coinIndex, uint256 _amount)\n internal\n returns (uint256 requiredMetapoolLP)\n {\n uint256[2] memory _amounts = [uint256(0), uint256(0)];\n _amounts[uint256(_coinIndex)] = _amount;\n\n // LP required when removing required asset ignoring fees\n uint256 lpRequiredNoFees = metapool.calc_token_amount(_amounts, false);\n /* LP required if fees would apply to entirety of removed amount\n *\n * fee is 1e10 denominated number: https://curve.readthedocs.io/exchange-pools.html#StableSwap.fee\n */\n uint256 lpRequiredFullFees = lpRequiredNoFees.mulTruncateScale(\n 1e10 + metapool.fee(),\n 1e10\n );\n\n /* asset received when withdrawing full fee applicable LP accounting for\n * slippage and fees\n */\n uint256 assetReceivedForFullLPFees = metapool.calc_withdraw_one_coin(\n lpRequiredFullFees,\n int128(_coinIndex)\n );\n\n // exact amount of LP required\n requiredMetapoolLP =\n (lpRequiredFullFees * _amount) /\n assetReceivedForFullLPFees;\n }\n\n function _approveBase() internal override {\n IERC20 pToken = IERC20(pTokenAddress);\n // 3Pool for LP token (required for removing liquidity)\n pToken.safeApprove(platformAddress, 0);\n pToken.safeApprove(platformAddress, type(uint256).max);\n // Gauge for LP token\n metapoolLPToken.safeApprove(cvxDepositorAddress, 0);\n metapoolLPToken.safeApprove(cvxDepositorAddress, type(uint256).max);\n // Metapool for LP token\n pToken.safeApprove(address(metapool), 0);\n pToken.safeApprove(address(metapool), type(uint256).max);\n // Metapool for Metapool main token\n metapoolMainToken.safeApprove(address(metapool), 0);\n metapoolMainToken.safeApprove(address(metapool), type(uint256).max);\n }\n\n /**\n * @dev Get the index of the coin\n */\n function _getMetapoolCoinIndex(address _asset)\n internal\n view\n returns (uint128)\n {\n for (uint128 i = 0; i < 2; i++) {\n if (metapoolAssets[i] == _asset) return i;\n }\n revert(\"Invalid Metapool asset\");\n }\n\n /**\n * @dev Sets max withdrawal slippage that is considered when removing\n * liquidity from Metapools.\n * @param _maxWithdrawalSlippage Max withdrawal slippage denominated in\n * wad (number with 18 decimals): 1e18 == 100%, 1e16 == 1%\n *\n * IMPORTANT Minimum maxWithdrawalSlippage should actually be 0.1% (1e15)\n * for production usage. Contract allows as low value as 0% for confirming\n * correct behavior in test suite.\n */\n function setMaxWithdrawalSlippage(uint256 _maxWithdrawalSlippage)\n external\n onlyVaultOrGovernorOrStrategist\n {\n require(\n _maxWithdrawalSlippage <= 1e18,\n \"Max withdrawal slippage needs to be between 0% - 100%\"\n );\n emit MaxWithdrawalSlippageUpdated(\n maxWithdrawalSlippage,\n _maxWithdrawalSlippage\n );\n maxWithdrawalSlippage = _maxWithdrawalSlippage;\n }\n\n /**\n * @dev Collect accumulated CRV and CVX and send to Harvester.\n */\n function collectRewardTokens()\n external\n override\n onlyHarvester\n nonReentrant\n {\n // Collect CRV and CVX\n IRewardStaking(cvxRewardStakerAddress).getReward();\n _collectRewardTokens();\n }\n\n /**\n * @dev Returns the largest of two numbers int256 version\n */\n function _max(int256 a, int256 b) internal pure returns (int256) {\n return a >= b ? a : b;\n }\n}\n" + }, + "contracts/strategies/BaseCurveStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Curve 3Pool Strategy\n * @notice Investment strategy for investing stablecoins via Curve 3Pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { ICurvePool } from \"./ICurvePool.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\n\nabstract contract BaseCurveStrategy is InitializableAbstractStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n uint256 internal constant MAX_SLIPPAGE = 1e16; // 1%, same as the Curve UI\n // number of assets in Curve 3Pool (USDC, DAI, USDT)\n uint256 internal constant THREEPOOL_ASSET_COUNT = 3;\n address internal pTokenAddress;\n\n int256[49] private __reserved;\n\n /**\n * @dev Deposit asset into the Curve 3Pool\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n require(_amount > 0, \"Must deposit something\");\n emit Deposit(_asset, pTokenAddress, _amount);\n\n // 3Pool requires passing deposit amounts for all 3 assets, set to 0 for\n // all\n uint256[3] memory _amounts;\n uint256 poolCoinIndex = _getCoinIndex(_asset);\n // Set the amount on the asset we want to deposit\n _amounts[poolCoinIndex] = _amount;\n ICurvePool curvePool = ICurvePool(platformAddress);\n uint256 assetDecimals = Helpers.getDecimals(_asset);\n uint256 depositValue = _amount.scaleBy(18, assetDecimals).divPrecisely(\n curvePool.get_virtual_price()\n );\n uint256 minMintAmount = depositValue.mulTruncate(\n uint256(1e18) - MAX_SLIPPAGE\n );\n // Do the deposit to 3pool\n curvePool.add_liquidity(_amounts, minMintAmount);\n _lpDepositAll();\n }\n\n function _lpDepositAll() internal virtual;\n\n /**\n * @dev Deposit the entire balance of any supported asset into the Curve 3pool\n */\n function depositAll() external override onlyVault nonReentrant {\n uint256[3] memory _amounts = [uint256(0), uint256(0), uint256(0)];\n uint256 depositValue = 0;\n ICurvePool curvePool = ICurvePool(platformAddress);\n uint256 curveVirtualPrice = curvePool.get_virtual_price();\n\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n address assetAddress = assetsMapped[i];\n uint256 balance = IERC20(assetAddress).balanceOf(address(this));\n if (balance > 0) {\n uint256 poolCoinIndex = _getCoinIndex(assetAddress);\n // Set the amount on the asset we want to deposit\n _amounts[poolCoinIndex] = balance;\n uint256 assetDecimals = Helpers.getDecimals(assetAddress);\n // Get value of deposit in Curve LP token to later determine\n // the minMintAmount argument for add_liquidity\n depositValue =\n depositValue +\n balance.scaleBy(18, assetDecimals).divPrecisely(\n curveVirtualPrice\n );\n emit Deposit(assetAddress, pTokenAddress, balance);\n }\n }\n\n uint256 minMintAmount = depositValue.mulTruncate(\n uint256(1e18) - MAX_SLIPPAGE\n );\n // Do the deposit to 3pool\n curvePool.add_liquidity(_amounts, minMintAmount);\n\n /* In case of Curve Strategy all assets are mapped to the same pToken (3CrvLP). Let\n * descendants further handle the pToken. By either deploying it to the metapool and\n * resulting tokens in Gauge. Or deploying pTokens directly to the Gauge.\n */\n _lpDepositAll();\n }\n\n function _lpWithdraw(uint256 numCrvTokens) internal virtual;\n\n function _lpWithdrawAll() internal virtual;\n\n /**\n * @dev Withdraw asset from Curve 3Pool\n * @param _recipient Address to receive withdrawn asset\n * @param _asset Address of asset to withdraw\n * @param _amount Amount of asset to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n require(_amount > 0, \"Invalid amount\");\n\n emit Withdrawal(_asset, pTokenAddress, _amount);\n\n uint256 contractCrv3Tokens = IERC20(pTokenAddress).balanceOf(\n address(this)\n );\n\n uint256 coinIndex = _getCoinIndex(_asset);\n ICurvePool curvePool = ICurvePool(platformAddress);\n\n uint256 requiredCrv3Tokens = _calcCurveTokenAmount(coinIndex, _amount);\n\n // We have enough LP tokens, make sure they are all on this contract\n if (contractCrv3Tokens < requiredCrv3Tokens) {\n _lpWithdraw(requiredCrv3Tokens - contractCrv3Tokens);\n }\n\n uint256[3] memory _amounts = [uint256(0), uint256(0), uint256(0)];\n _amounts[coinIndex] = _amount;\n\n curvePool.remove_liquidity_imbalance(_amounts, requiredCrv3Tokens);\n IERC20(_asset).safeTransfer(_recipient, _amount);\n }\n\n /**\n * @dev Calculate amount of LP required when withdrawing specific amount of one\n * of the underlying assets accounting for fees and slippage.\n *\n * Curve pools unfortunately do not contain a calculation function for\n * amount of LP required when withdrawing a specific amount of one of the\n * underlying tokens and also accounting for fees (Curve's calc_token_amount\n * does account for slippage but not fees).\n *\n * Steps taken to calculate the metric:\n * - get amount of LP required if fees wouldn't apply\n * - increase the LP amount as if fees would apply to the entirety of the underlying\n * asset withdrawal. (when withdrawing only one coin fees apply only to amounts\n * of other assets pool would return in case of balanced removal - since those need\n * to be swapped for the single underlying asset being withdrawn)\n * - get amount of underlying asset withdrawn (this Curve function does consider slippage\n * and fees) when using the increased LP amount. As LP amount is slightly over-increased\n * so is amount of underlying assets returned.\n * - since we know exactly how much asset we require take the rate of LP required for asset\n * withdrawn to get the exact amount of LP.\n */\n function _calcCurveTokenAmount(uint256 _coinIndex, uint256 _amount)\n internal\n returns (uint256 required3Crv)\n {\n ICurvePool curvePool = ICurvePool(platformAddress);\n\n uint256[3] memory _amounts = [uint256(0), uint256(0), uint256(0)];\n _amounts[_coinIndex] = _amount;\n\n // LP required when removing required asset ignoring fees\n uint256 lpRequiredNoFees = curvePool.calc_token_amount(_amounts, false);\n /* LP required if fees would apply to entirety of removed amount\n *\n * fee is 1e10 denominated number: https://curve.readthedocs.io/exchange-pools.html#StableSwap.fee\n */\n uint256 lpRequiredFullFees = lpRequiredNoFees.mulTruncateScale(\n 1e10 + curvePool.fee(),\n 1e10\n );\n\n /* asset received when withdrawing full fee applicable LP accounting for\n * slippage and fees\n */\n uint256 assetReceivedForFullLPFees = curvePool.calc_withdraw_one_coin(\n lpRequiredFullFees,\n int128(uint128(_coinIndex))\n );\n\n // exact amount of LP required\n required3Crv =\n (lpRequiredFullFees * _amount) /\n assetReceivedForFullLPFees;\n }\n\n /**\n * @dev Remove all assets from platform and send them to Vault contract.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n _lpWithdrawAll();\n // Withdraws are proportional to assets held by 3Pool\n uint256[3] memory minWithdrawAmounts = [\n uint256(0),\n uint256(0),\n uint256(0)\n ];\n\n // Remove liquidity\n ICurvePool threePool = ICurvePool(platformAddress);\n threePool.remove_liquidity(\n IERC20(pTokenAddress).balanceOf(address(this)),\n minWithdrawAmounts\n );\n // Transfer assets out of Vault\n // Note that Curve will provide all 3 of the assets in 3pool even if\n // we have not set PToken addresses for all of them in this strategy\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n IERC20 asset = IERC20(threePool.coins(i));\n asset.safeTransfer(vaultAddress, asset.balanceOf(address(this)));\n }\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n public\n view\n virtual\n override\n returns (uint256 balance)\n {\n require(assetToPToken[_asset] != address(0), \"Unsupported asset\");\n // LP tokens in this contract. This should generally be nothing as we\n // should always stake the full balance in the Gauge, but include for\n // safety\n uint256 totalPTokens = IERC20(pTokenAddress).balanceOf(address(this));\n ICurvePool curvePool = ICurvePool(platformAddress);\n if (totalPTokens > 0) {\n uint256 virtual_price = curvePool.get_virtual_price();\n uint256 value = (totalPTokens * virtual_price) / 1e18;\n uint256 assetDecimals = Helpers.getDecimals(_asset);\n balance = value.scaleBy(assetDecimals, 18) / THREEPOOL_ASSET_COUNT;\n }\n }\n\n /**\n * @dev Retuns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return assetToPToken[_asset] != address(0);\n }\n\n /**\n * @dev Approve the spending of all assets by their corresponding pool tokens,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens()\n external\n override\n onlyGovernor\n nonReentrant\n {\n _approveBase();\n // This strategy is a special case since it only supports one asset\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n _approveAsset(assetsMapped[i]);\n }\n }\n\n /**\n * @dev Call the necessary approvals for the Curve pool and gauge\n * @param _asset Address of the asset\n */\n function _abstractSetPToken(address _asset, address) internal override {\n _approveAsset(_asset);\n }\n\n function _approveAsset(address _asset) internal {\n IERC20 asset = IERC20(_asset);\n // 3Pool for asset (required for adding liquidity)\n asset.safeApprove(platformAddress, 0);\n asset.safeApprove(platformAddress, type(uint256).max);\n }\n\n function _approveBase() internal virtual;\n\n /**\n * @dev Get the index of the coin\n */\n function _getCoinIndex(address _asset) internal view returns (uint256) {\n for (uint256 i = 0; i < 3; i++) {\n if (assetsMapped[i] == _asset) return i;\n }\n revert(\"Invalid 3pool asset\");\n }\n}\n" + }, + "contracts/strategies/CompoundStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Compound Strategy\n * @notice Investment strategy for Compound like lending platforms. eg Compound and Flux\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { ICERC20 } from \"./ICompound.sol\";\nimport { BaseCompoundStrategy, InitializableAbstractStrategy } from \"./BaseCompoundStrategy.sol\";\nimport { IComptroller } from \"../interfaces/IComptroller.sol\";\nimport { IERC20 } from \"../utils/InitializableAbstractStrategy.sol\";\n\ncontract CompoundStrategy is BaseCompoundStrategy {\n using SafeERC20 for IERC20;\n event SkippedWithdrawal(address asset, uint256 amount);\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /**\n * @notice initialize function, to set up initial internal state\n * @param _rewardTokenAddresses Address of reward token for platform\n * @param _assets Addresses of initial supported assets\n * @param _pTokens Platform Token corresponding addresses\n */\n function initialize(\n address[] memory _rewardTokenAddresses,\n address[] memory _assets,\n address[] memory _pTokens\n ) external onlyGovernor initializer {\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n }\n\n /**\n * @notice Collect accumulated COMP and send to Harvester.\n */\n function collectRewardTokens()\n external\n virtual\n override\n onlyHarvester\n nonReentrant\n {\n // Claim COMP from Comptroller\n ICERC20 cToken = _getCTokenFor(assetsMapped[0]);\n IComptroller comptroller = IComptroller(cToken.comptroller());\n // Only collect from active cTokens, saves gas\n address[] memory ctokensToCollect = new address[](assetsMapped.length);\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n ctokensToCollect[i] = address(_getCTokenFor(assetsMapped[i]));\n }\n // Claim only for this strategy\n address[] memory claimers = new address[](1);\n claimers[0] = address(this);\n // Claim COMP from Comptroller. Only collect for supply, saves gas\n comptroller.claimComp(claimers, ctokensToCollect, false, true);\n // Transfer COMP to Harvester\n IERC20 rewardToken = IERC20(rewardTokenAddresses[0]);\n uint256 balance = rewardToken.balanceOf(address(this));\n emit RewardTokenCollected(\n harvesterAddress,\n rewardTokenAddresses[0],\n balance\n );\n rewardToken.safeTransfer(harvesterAddress, balance);\n }\n\n /**\n * @notice Deposit asset into the underlying platform\n * @param _asset Address of asset to deposit\n * @param _amount Amount of assets to deposit\n */\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n _deposit(_asset, _amount);\n }\n\n /**\n * @dev Deposit an asset into the underlying platform\n * @param _asset Address of the asset to deposit\n * @param _amount Amount of assets to deposit\n */\n function _deposit(address _asset, uint256 _amount) internal {\n require(_amount > 0, \"Must deposit something\");\n ICERC20 cToken = _getCTokenFor(_asset);\n emit Deposit(_asset, address(cToken), _amount);\n require(cToken.mint(_amount) == 0, \"cToken mint failed\");\n }\n\n /**\n * @notice Deposit the entire balance of any supported asset in the strategy into the underlying platform\n */\n function depositAll() external override onlyVault nonReentrant {\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n IERC20 asset = IERC20(assetsMapped[i]);\n uint256 assetBalance = asset.balanceOf(address(this));\n if (assetBalance > 0) {\n _deposit(address(asset), assetBalance);\n }\n }\n }\n\n /**\n * @notice Withdraw an asset from the underlying platform\n * @param _recipient Address to receive withdrawn assets\n * @param _asset Address of the asset to withdraw\n * @param _amount Amount of assets to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n require(_amount > 0, \"Must withdraw something\");\n require(_recipient != address(0), \"Must specify recipient\");\n\n ICERC20 cToken = _getCTokenFor(_asset);\n // If redeeming 0 cTokens, just skip, else COMP will revert\n uint256 cTokensToRedeem = _convertUnderlyingToCToken(cToken, _amount);\n if (cTokensToRedeem == 0) {\n emit SkippedWithdrawal(_asset, _amount);\n return;\n }\n\n emit Withdrawal(_asset, address(cToken), _amount);\n require(cToken.redeemUnderlying(_amount) == 0, \"Redeem failed\");\n IERC20(_asset).safeTransfer(_recipient, _amount);\n }\n\n /**\n * @dev Internal method to respond to the addition of new asset / cTokens\n * We need to approve the cToken and give it permission to spend the asset\n * @param _asset Address of the asset to approve. eg DAI\n * @param _pToken The pToken for the approval. eg cDAI or fDAI\n */\n function _abstractSetPToken(address _asset, address _pToken)\n internal\n override\n {\n // Safe approval\n IERC20(_asset).safeApprove(_pToken, 0);\n IERC20(_asset).safeApprove(_pToken, type(uint256).max);\n }\n\n /**\n * @notice Remove all supported assets from the underlying platform and send them to Vault contract.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n IERC20 asset = IERC20(assetsMapped[i]);\n // Redeem entire balance of cToken\n ICERC20 cToken = _getCTokenFor(address(asset));\n uint256 cTokenBalance = cToken.balanceOf(address(this));\n if (cTokenBalance > 0) {\n require(cToken.redeem(cTokenBalance) == 0, \"Redeem failed\");\n uint256 assetBalance = asset.balanceOf(address(this));\n // Transfer entire balance to Vault\n asset.safeTransfer(vaultAddress, assetBalance);\n\n emit Withdrawal(address(asset), address(cToken), assetBalance);\n }\n }\n }\n\n /**\n * @notice Get the total asset value held in the underlying platform\n * This includes any interest that was generated since depositing.\n * The exchange rate between the cToken and asset gradually increases,\n * causing the cToken to be worth more corresponding asset.\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n override\n returns (uint256 balance)\n {\n // Balance is always with token cToken decimals\n ICERC20 cToken = _getCTokenFor(_asset);\n balance = _checkBalance(cToken);\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * underlying = (cTokenAmt * exchangeRate) / 1e18\n * @param _cToken cToken for which to check balance\n * @return balance Total value of the asset in the platform\n */\n function _checkBalance(ICERC20 _cToken)\n internal\n view\n returns (uint256 balance)\n {\n // e.g. 50e8*205316390724364402565641705 / 1e18 = 1.0265..e18\n balance =\n (_cToken.balanceOf(address(this)) * _cToken.exchangeRateStored()) /\n 1e18;\n }\n\n /**\n * @notice Approve the spending of all assets by their corresponding cToken,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens() external override {\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n IERC20 asset = IERC20(assetsMapped[i]);\n address cToken = assetToPToken[address(asset)];\n // Safe approval\n asset.safeApprove(cToken, 0);\n asset.safeApprove(cToken, type(uint256).max);\n }\n }\n}\n" + }, + "contracts/strategies/ConvexEthMetaStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Convex Automated Market Maker (AMO) Strategy\n * @notice AMO strategy for the Curve OETH/ETH pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"@openzeppelin/contracts/utils/math/Math.sol\";\n\nimport { ICurveETHPoolV1 } from \"./ICurveETHPoolV1.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\nimport { IWETH9 } from \"../interfaces/IWETH9.sol\";\nimport { IConvexDeposits } from \"./IConvexDeposits.sol\";\nimport { IRewardStaking } from \"./IRewardStaking.sol\";\n\ncontract ConvexEthMetaStrategy is InitializableAbstractStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n uint256 public constant MAX_SLIPPAGE = 1e16; // 1%, same as the Curve UI\n address public constant ETH_ADDRESS =\n 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE;\n\n // The following slots have been deprecated with immutable variables\n // slither-disable-next-line constable-states\n address private _deprecated_cvxDepositorAddress;\n // slither-disable-next-line constable-states\n address private _deprecated_cvxRewardStaker;\n // slither-disable-next-line constable-states\n uint256 private _deprecated_cvxDepositorPTokenId;\n // slither-disable-next-line constable-states\n address private _deprecated_curvePool;\n // slither-disable-next-line constable-states\n address private _deprecated_lpToken;\n // slither-disable-next-line constable-states\n address private _deprecated_oeth;\n // slither-disable-next-line constable-states\n address private _deprecated_weth;\n\n // Ordered list of pool assets\n // slither-disable-next-line constable-states\n uint128 private _deprecated_oethCoinIndex;\n // slither-disable-next-line constable-states\n uint128 private _deprecated_ethCoinIndex;\n\n // New immutable variables that must be set in the constructor\n address public immutable cvxDepositorAddress;\n IRewardStaking public immutable cvxRewardStaker;\n uint256 public immutable cvxDepositorPTokenId;\n ICurveETHPoolV1 public immutable curvePool;\n IERC20 public immutable lpToken;\n IERC20 public immutable oeth;\n IWETH9 public immutable weth;\n\n // Ordered list of pool assets\n uint128 public constant oethCoinIndex = 1;\n uint128 public constant ethCoinIndex = 0;\n\n /**\n * @dev Verifies that the caller is the Strategist.\n */\n modifier onlyStrategist() {\n require(\n msg.sender == IVault(vaultAddress).strategistAddr(),\n \"Caller is not the Strategist\"\n );\n _;\n }\n\n /**\n * @dev Checks the Curve pool's balances have improved and the balances\n * have not tipped to the other side.\n * This modifier only works on functions that do a single sided add or remove.\n * The standard deposit function adds to both sides of the pool in a way that\n * the pool's balance is not worsened.\n * Withdrawals are proportional so doesn't change the pools asset balance.\n */\n modifier improvePoolBalance() {\n // Get the asset and OToken balances in the Curve pool\n uint256[2] memory balancesBefore = curvePool.get_balances();\n // diff = ETH balance - OETH balance\n int256 diffBefore = int256(balancesBefore[ethCoinIndex]) -\n int256(balancesBefore[oethCoinIndex]);\n\n _;\n\n // Get the asset and OToken balances in the Curve pool\n uint256[2] memory balancesAfter = curvePool.get_balances();\n // diff = ETH balance - OETH balance\n int256 diffAfter = int256(balancesAfter[ethCoinIndex]) -\n int256(balancesAfter[oethCoinIndex]);\n\n if (diffBefore <= 0) {\n // If the pool was originally imbalanced in favor of OETH, then\n // we want to check that the pool is now more balanced\n require(diffAfter <= 0, \"OTokens overshot peg\");\n require(diffBefore < diffAfter, \"OTokens balance worse\");\n }\n if (diffBefore >= 0) {\n // If the pool was originally imbalanced in favor of ETH, then\n // we want to check that the pool is now more balanced\n require(diffAfter >= 0, \"Assets overshot peg\");\n require(diffAfter < diffBefore, \"Assets balance worse\");\n }\n }\n\n // Used to circumvent the stack too deep issue\n struct ConvexEthMetaConfig {\n address cvxDepositorAddress; //Address of the Convex depositor(AKA booster) for this pool\n address cvxRewardStakerAddress; //Address of the CVX rewards staker\n uint256 cvxDepositorPTokenId; //Pid of the pool referred to by Depositor and staker\n address oethAddress; //Address of OETH token\n address wethAddress; //Address of WETH\n }\n\n constructor(\n BaseStrategyConfig memory _baseConfig,\n ConvexEthMetaConfig memory _convexConfig\n ) InitializableAbstractStrategy(_baseConfig) {\n lpToken = IERC20(_baseConfig.platformAddress);\n curvePool = ICurveETHPoolV1(_baseConfig.platformAddress);\n\n cvxDepositorAddress = _convexConfig.cvxDepositorAddress;\n cvxRewardStaker = IRewardStaking(_convexConfig.cvxRewardStakerAddress);\n cvxDepositorPTokenId = _convexConfig.cvxDepositorPTokenId;\n oeth = IERC20(_convexConfig.oethAddress);\n weth = IWETH9(_convexConfig.wethAddress);\n }\n\n /**\n * Initializer for setting up strategy internal state. This overrides the\n * InitializableAbstractStrategy initializer as Curve strategies don't fit\n * well within that abstraction.\n * @param _rewardTokenAddresses Address of CRV & CVX\n * @param _assets Addresses of supported assets. eg WETH\n */\n function initialize(\n address[] calldata _rewardTokenAddresses, // CRV + CVX\n address[] calldata _assets // WETH\n ) external onlyGovernor initializer {\n require(_assets.length == 1, \"Must have exactly one asset\");\n require(_assets[0] == address(weth), \"Asset not WETH\");\n\n address[] memory pTokens = new address[](1);\n pTokens[0] = address(curvePool);\n\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n pTokens\n );\n\n _approveBase();\n }\n\n /***************************************\n Deposit\n ****************************************/\n\n /**\n * @notice Deposit WETH into the Curve pool\n * @param _weth Address of Wrapped ETH (WETH) contract.\n * @param _amount Amount of WETH to deposit.\n */\n function deposit(address _weth, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n _deposit(_weth, _amount);\n }\n\n function _deposit(address _weth, uint256 _wethAmount) internal {\n require(_wethAmount > 0, \"Must deposit something\");\n require(_weth == address(weth), \"Can only deposit WETH\");\n weth.withdraw(_wethAmount);\n\n emit Deposit(_weth, address(lpToken), _wethAmount);\n\n // Get the asset and OToken balances in the Curve pool\n uint256[2] memory balances = curvePool.get_balances();\n // safe to cast since min value is at least 0\n uint256 oethToAdd = uint256(\n _max(\n 0,\n int256(balances[ethCoinIndex]) +\n int256(_wethAmount) -\n int256(balances[oethCoinIndex])\n )\n );\n\n /* Add so much OETH so that the pool ends up being balanced. And at minimum\n * add as much OETH as WETH and at maximum twice as much OETH.\n */\n oethToAdd = Math.max(oethToAdd, _wethAmount);\n oethToAdd = Math.min(oethToAdd, _wethAmount * 2);\n\n /* Mint OETH with a strategy that attempts to contribute to stability of OETH/WETH pool. Try\n * to mint so much OETH that after deployment of liquidity pool ends up being balanced.\n *\n * To manage unpredictability minimal OETH minted will always be at least equal or greater\n * to WETH amount deployed. And never larger than twice the WETH amount deployed even if\n * it would have a further beneficial effect on pool stability.\n */\n IVault(vaultAddress).mintForStrategy(oethToAdd);\n\n emit Deposit(address(oeth), address(lpToken), oethToAdd);\n\n uint256[2] memory _amounts;\n _amounts[ethCoinIndex] = _wethAmount;\n _amounts[oethCoinIndex] = oethToAdd;\n\n uint256 valueInLpTokens = (_wethAmount + oethToAdd).divPrecisely(\n curvePool.get_virtual_price()\n );\n uint256 minMintAmount = valueInLpTokens.mulTruncate(\n uint256(1e18) - MAX_SLIPPAGE\n );\n\n // Do the deposit to the Curve pool\n // slither-disable-next-line arbitrary-send\n uint256 lpDeposited = curvePool.add_liquidity{ value: _wethAmount }(\n _amounts,\n minMintAmount\n );\n\n // Deposit the Curve pool's LP tokens into the Convex rewards pool\n require(\n IConvexDeposits(cvxDepositorAddress).deposit(\n cvxDepositorPTokenId,\n lpDeposited,\n true // Deposit with staking\n ),\n \"Depositing LP to Convex not successful\"\n );\n }\n\n /**\n * @notice Deposit the strategy's entire balance of WETH into the Curve pool\n */\n function depositAll() external override onlyVault nonReentrant {\n uint256 balance = weth.balanceOf(address(this));\n if (balance > 0) {\n _deposit(address(weth), balance);\n }\n }\n\n /***************************************\n Withdraw\n ****************************************/\n\n /**\n * @notice Withdraw ETH and OETH from the Curve pool, burn the OETH,\n * convert the ETH to WETH and transfer to the recipient.\n * @param _recipient Address to receive withdrawn asset which is normally the Vault.\n * @param _weth Address of the Wrapped ETH (WETH) contract.\n * @param _amount Amount of WETH to withdraw.\n */\n function withdraw(\n address _recipient,\n address _weth,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n require(_amount > 0, \"Invalid amount\");\n require(_weth == address(weth), \"Can only withdraw WETH\");\n\n emit Withdrawal(_weth, address(lpToken), _amount);\n\n uint256 requiredLpTokens = calcTokenToBurn(_amount);\n\n _lpWithdraw(requiredLpTokens);\n\n /* math in requiredLpTokens should correctly calculate the amount of LP to remove\n * in that the strategy receives enough WETH on balanced removal\n */\n uint256[2] memory _minWithdrawalAmounts = [uint256(0), uint256(0)];\n _minWithdrawalAmounts[ethCoinIndex] = _amount;\n // slither-disable-next-line unused-return\n curvePool.remove_liquidity(requiredLpTokens, _minWithdrawalAmounts);\n\n // Burn all the removed OETH and any that was left in the strategy\n uint256 oethToBurn = oeth.balanceOf(address(this));\n IVault(vaultAddress).burnForStrategy(oethToBurn);\n\n emit Withdrawal(address(oeth), address(lpToken), oethToBurn);\n\n // Transfer WETH to the recipient\n weth.deposit{ value: _amount }();\n require(\n weth.transfer(_recipient, _amount),\n \"Transfer of WETH not successful\"\n );\n }\n\n function calcTokenToBurn(uint256 _wethAmount)\n internal\n view\n returns (uint256 lpToBurn)\n {\n /* The rate between coins in the pool determines the rate at which pool returns\n * tokens when doing balanced removal (remove_liquidity call). And by knowing how much WETH\n * we want we can determine how much of OETH we receive by removing liquidity.\n *\n * Because we are doing balanced removal we should be making profit when removing liquidity in a\n * pool tilted to either side.\n *\n * Important: A downside is that the Strategist / Governor needs to be\n * cognisant of not removing too much liquidity. And while the proposal to remove liquidity\n * is being voted on the pool tilt might change so much that the proposal that has been valid while\n * created is no longer valid.\n */\n\n uint256 poolWETHBalance = curvePool.balances(ethCoinIndex);\n /* K is multiplied by 1e36 which is used for higher precision calculation of required\n * pool LP tokens. Without it the end value can have rounding errors up to precision of\n * 10 digits. This way we move the decimal point by 36 places when doing the calculation\n * and again by 36 places when we are done with it.\n */\n uint256 k = (1e36 * lpToken.totalSupply()) / poolWETHBalance;\n // prettier-ignore\n // slither-disable-next-line divide-before-multiply\n uint256 diff = (_wethAmount + 1) * k;\n lpToBurn = diff / 1e36;\n }\n\n /**\n * @notice Remove all ETH and OETH from the Curve pool, burn the OETH,\n * convert the ETH to WETH and transfer to the Vault contract.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n uint256 gaugeTokens = cvxRewardStaker.balanceOf(address(this));\n _lpWithdraw(gaugeTokens);\n\n // Withdraws are proportional to assets held by 3Pool\n uint256[2] memory minWithdrawAmounts = [uint256(0), uint256(0)];\n\n // Remove liquidity\n // slither-disable-next-line unused-return\n curvePool.remove_liquidity(\n lpToken.balanceOf(address(this)),\n minWithdrawAmounts\n );\n\n // Burn all OETH\n uint256 oethToBurn = oeth.balanceOf(address(this));\n IVault(vaultAddress).burnForStrategy(oethToBurn);\n\n // Get the strategy contract's ether balance.\n // This includes all that was removed from the Curve pool and\n // any ether that was sitting in the strategy contract before the removal.\n uint256 ethBalance = address(this).balance;\n // Convert all the strategy contract's ether to WETH and transfer to the vault.\n weth.deposit{ value: ethBalance }();\n require(\n weth.transfer(vaultAddress, ethBalance),\n \"Transfer of WETH not successful\"\n );\n\n emit Withdrawal(address(weth), address(lpToken), ethBalance);\n emit Withdrawal(address(oeth), address(lpToken), oethToBurn);\n }\n\n /***************************************\n Curve pool Rebalancing\n ****************************************/\n\n /**\n * @notice Mint OTokens and one-sided add to the Curve pool.\n * This is used when the Curve pool does not have enough OTokens and too many ETH.\n * The OToken/Asset, eg OETH/ETH, price with increase.\n * The amount of assets in the vault is unchanged.\n * The total supply of OTokens is increased.\n * The asset value of the strategy and vault is increased.\n * @param _oTokens The amount of OTokens to be minted and added to the pool.\n */\n function mintAndAddOTokens(uint256 _oTokens)\n external\n onlyStrategist\n nonReentrant\n improvePoolBalance\n {\n IVault(vaultAddress).mintForStrategy(_oTokens);\n\n uint256[2] memory amounts = [uint256(0), uint256(0)];\n amounts[oethCoinIndex] = _oTokens;\n\n // Convert OETH to Curve pool LP tokens\n uint256 valueInLpTokens = (_oTokens).divPrecisely(\n curvePool.get_virtual_price()\n );\n // Apply slippage to LP tokens\n uint256 minMintAmount = valueInLpTokens.mulTruncate(\n uint256(1e18) - MAX_SLIPPAGE\n );\n\n // Add the minted OTokens to the Curve pool\n uint256 lpDeposited = curvePool.add_liquidity(amounts, minMintAmount);\n\n // Deposit the Curve pool LP tokens to the Convex rewards pool\n require(\n IConvexDeposits(cvxDepositorAddress).deposit(\n cvxDepositorPTokenId,\n lpDeposited,\n true // Deposit with staking\n ),\n \"Failed to Deposit LP to Convex\"\n );\n\n emit Deposit(address(oeth), address(lpToken), _oTokens);\n }\n\n /**\n * @notice One-sided remove of OTokens from the Curve pool which are then burned.\n * This is used when the Curve pool has too many OTokens and not enough ETH.\n * The amount of assets in the vault is unchanged.\n * The total supply of OTokens is reduced.\n * The asset value of the strategy and vault is reduced.\n * @param _lpTokens The amount of Curve pool LP tokens to be burned for OTokens.\n */\n function removeAndBurnOTokens(uint256 _lpTokens)\n external\n onlyStrategist\n nonReentrant\n improvePoolBalance\n {\n // Withdraw Curve pool LP tokens from Convex and remove OTokens from the Curve pool\n uint256 oethToBurn = _withdrawAndRemoveFromPool(\n _lpTokens,\n oethCoinIndex\n );\n\n // The vault burns the OTokens from this strategy\n IVault(vaultAddress).burnForStrategy(oethToBurn);\n\n emit Withdrawal(address(oeth), address(lpToken), oethToBurn);\n }\n\n /**\n * @notice One-sided remove of ETH from the Curve pool, convert to WETH\n * and transfer to the vault.\n * This is used when the Curve pool does not have enough OTokens and too many ETH.\n * The OToken/Asset, eg OETH/ETH, price with decrease.\n * The amount of assets in the vault increases.\n * The total supply of OTokens does not change.\n * The asset value of the strategy reduces.\n * The asset value of the vault should be close to the same.\n * @param _lpTokens The amount of Curve pool LP tokens to be burned for ETH.\n * @dev Curve pool LP tokens is used rather than WETH assets as Curve does not\n * have a way to accurately calculate the amount of LP tokens for a required\n * amount of ETH. Curve's `calc_token_amount` functioun does not include fees.\n * A 3rd party libary can be used that takes into account the fees, but this\n * is a gas intensive process. It's easier for the trusted strategist to\n * caclulate the amount of Curve pool LP tokens required off-chain.\n */\n function removeOnlyAssets(uint256 _lpTokens)\n external\n onlyStrategist\n nonReentrant\n improvePoolBalance\n {\n // Withdraw Curve pool LP tokens from Convex and remove ETH from the Curve pool\n uint256 ethAmount = _withdrawAndRemoveFromPool(_lpTokens, ethCoinIndex);\n\n // Convert ETH to WETH and transfer to the vault\n weth.deposit{ value: ethAmount }();\n require(\n weth.transfer(vaultAddress, ethAmount),\n \"Transfer of WETH not successful\"\n );\n\n emit Withdrawal(address(weth), address(lpToken), ethAmount);\n }\n\n /**\n * @dev Remove Curve pool LP tokens from the Convex pool and\n * do a one-sided remove of ETH or OETH from the Curve pool.\n * @param _lpTokens The amount of Curve pool LP tokens to be removed from the Convex pool.\n * @param coinIndex The index of the coin to be removed from the Curve pool. 0 = ETH, 1 = OETH.\n * @return coinsRemoved The amount of ETH or OETH removed from the Curve pool.\n */\n function _withdrawAndRemoveFromPool(uint256 _lpTokens, uint128 coinIndex)\n internal\n returns (uint256 coinsRemoved)\n {\n // Withdraw Curve pool LP tokens from Convex pool\n _lpWithdraw(_lpTokens);\n\n // Convert Curve pool LP tokens to ETH value\n uint256 valueInEth = _lpTokens.mulTruncate(\n curvePool.get_virtual_price()\n );\n // Apply slippage to ETH value\n uint256 minAmount = valueInEth.mulTruncate(\n uint256(1e18) - MAX_SLIPPAGE\n );\n\n // Remove just the ETH from the Curve pool\n coinsRemoved = curvePool.remove_liquidity_one_coin(\n _lpTokens,\n int128(coinIndex),\n minAmount,\n address(this)\n );\n }\n\n /***************************************\n Assets and Rewards\n ****************************************/\n\n /**\n * @notice Collect accumulated CRV and CVX rewards and send to the Harvester.\n */\n function collectRewardTokens()\n external\n override\n onlyHarvester\n nonReentrant\n {\n // Collect CRV and CVX\n cvxRewardStaker.getReward();\n _collectRewardTokens();\n }\n\n function _lpWithdraw(uint256 _wethAmount) internal {\n // withdraw and unwrap with claim takes back the lpTokens\n // and also collects the rewards for deposit\n cvxRewardStaker.withdrawAndUnwrap(_wethAmount, true);\n }\n\n /**\n * @notice Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n public\n view\n override\n returns (uint256 balance)\n {\n require(_asset == address(weth), \"Unsupported asset\");\n\n // Eth balance needed here for the balance check that happens from vault during depositing.\n balance = address(this).balance;\n uint256 lpTokens = cvxRewardStaker.balanceOf(address(this));\n if (lpTokens > 0) {\n balance += (lpTokens * curvePool.get_virtual_price()) / 1e18;\n }\n }\n\n /**\n * @notice Returns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return _asset == address(weth);\n }\n\n /***************************************\n Approvals\n ****************************************/\n\n /**\n * @notice Approve the spending of all assets by their corresponding pool tokens,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens()\n external\n override\n onlyGovernor\n nonReentrant\n {\n _approveBase();\n }\n\n /**\n * @notice Accept unwrapped WETH\n */\n receive() external payable {}\n\n /**\n * @dev Since we are unwrapping WETH before depositing it to Curve\n * there is no need to to set an approval for WETH on the Curve\n * pool\n * @param _asset Address of the asset\n * @param _pToken Address of the Curve LP token\n */\n // solhint-disable-next-line no-unused-vars\n function _abstractSetPToken(address _asset, address _pToken)\n internal\n override\n {}\n\n function _approveBase() internal {\n // Approve Curve pool for OETH (required for adding liquidity)\n // No approval is needed for ETH\n // slither-disable-next-line unused-return\n oeth.approve(platformAddress, type(uint256).max);\n\n // Approve Convex deposit contract to transfer Curve pool LP tokens\n // This is needed for deposits if Curve pool LP tokens into the Convex rewards pool\n // slither-disable-next-line unused-return\n lpToken.approve(cvxDepositorAddress, type(uint256).max);\n }\n\n /**\n * @dev Returns the largest of two numbers int256 version\n */\n function _max(int256 a, int256 b) internal pure returns (int256) {\n return a >= b ? a : b;\n }\n}\n" + }, + "contracts/strategies/ConvexGeneralizedMetaStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Curve Convex Strategy\n * @notice Investment strategy for investing stablecoins via Curve 3Pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"@openzeppelin/contracts/utils/Strings.sol\";\n\nimport { IRewardStaking } from \"./IRewardStaking.sol\";\nimport { IConvexDeposits } from \"./IConvexDeposits.sol\";\nimport { ICurvePool } from \"./ICurvePool.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"./BaseCurveStrategy.sol\";\nimport { BaseConvexMetaStrategy } from \"./BaseConvexMetaStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\ncontract ConvexGeneralizedMetaStrategy is BaseConvexMetaStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /* Take 3pool LP and deposit it to metapool. Take the LP from metapool\n * and deposit them to Convex.\n */\n function _lpDepositAll() internal override {\n IERC20 threePoolLp = IERC20(pTokenAddress);\n ICurvePool curvePool = ICurvePool(platformAddress);\n\n uint256 threePoolLpBalance = threePoolLp.balanceOf(address(this));\n uint256 curve3PoolVirtualPrice = curvePool.get_virtual_price();\n uint256 threePoolLpDollarValue = threePoolLpBalance.mulTruncate(\n curve3PoolVirtualPrice\n );\n\n uint256[2] memory _amounts = [0, threePoolLpBalance];\n\n uint256 metapoolVirtualPrice = metapool.get_virtual_price();\n /**\n * First convert all the deposited tokens to dollar values,\n * then divide by virtual price to convert to metapool LP tokens\n * and apply the max slippage\n */\n uint256 minReceived = threePoolLpDollarValue\n .divPrecisely(metapoolVirtualPrice)\n .mulTruncate(uint256(1e18) - MAX_SLIPPAGE);\n\n uint256 metapoolLp = metapool.add_liquidity(_amounts, minReceived);\n\n bool success = IConvexDeposits(cvxDepositorAddress).deposit(\n cvxDepositorPTokenId,\n metapoolLp,\n true // Deposit with staking\n );\n\n require(success, \"Failed to deposit to Convex\");\n }\n\n /**\n * Withdraw the specified amount of tokens from the gauge. And use all the resulting tokens\n * to remove liquidity from metapool\n * @param num3CrvTokens Number of Convex 3pool LP tokens to withdraw from metapool\n */\n function _lpWithdraw(uint256 num3CrvTokens) internal override {\n uint256 gaugeTokens = IRewardStaking(cvxRewardStakerAddress).balanceOf(\n address(this)\n );\n\n uint256 requiredMetapoolLpTokens = _calcCurveMetaTokenAmount(\n crvCoinIndex,\n num3CrvTokens\n );\n\n require(\n requiredMetapoolLpTokens <= gaugeTokens,\n string(\n bytes.concat(\n bytes(\"Attempting to withdraw \"),\n bytes(Strings.toString(requiredMetapoolLpTokens)),\n bytes(\", metapoolLP but only \"),\n bytes(Strings.toString(gaugeTokens)),\n bytes(\" available.\")\n )\n )\n );\n\n // withdraw and unwrap with claim takes back the lpTokens and also collects the rewards for deposit\n IRewardStaking(cvxRewardStakerAddress).withdrawAndUnwrap(\n requiredMetapoolLpTokens,\n true\n );\n\n if (requiredMetapoolLpTokens > 0) {\n // slither-disable-next-line unused-return\n metapool.remove_liquidity_one_coin(\n requiredMetapoolLpTokens,\n int128(crvCoinIndex),\n num3CrvTokens\n );\n }\n }\n\n function _lpWithdrawAll() internal override {\n uint256 gaugeTokens = IRewardStaking(cvxRewardStakerAddress).balanceOf(\n address(this)\n );\n IRewardStaking(cvxRewardStakerAddress).withdrawAndUnwrap(\n gaugeTokens,\n true\n );\n\n if (gaugeTokens > 0) {\n uint256 burnDollarAmount = gaugeTokens.mulTruncate(\n metapool.get_virtual_price()\n );\n uint256 curve3PoolExpected = burnDollarAmount.divPrecisely(\n ICurvePool(platformAddress).get_virtual_price()\n );\n\n // Always withdraw all of the available metapool LP tokens (similar to how we always deposit all)\n // slither-disable-next-line unused-return\n metapool.remove_liquidity_one_coin(\n gaugeTokens,\n int128(crvCoinIndex),\n curve3PoolExpected -\n curve3PoolExpected.mulTruncate(maxWithdrawalSlippage)\n );\n }\n }\n}\n" + }, + "contracts/strategies/ConvexOUSDMetaStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Curve Convex Strategy\n * @notice Investment strategy for investing stablecoins via Curve 3Pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"@openzeppelin/contracts/utils/Strings.sol\";\nimport \"@openzeppelin/contracts/utils/math/Math.sol\";\n\nimport { IRewardStaking } from \"./IRewardStaking.sol\";\nimport { IConvexDeposits } from \"./IConvexDeposits.sol\";\nimport { ICurvePool } from \"./ICurvePool.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"./BaseCurveStrategy.sol\";\nimport { BaseConvexMetaStrategy } from \"./BaseConvexMetaStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\n\ncontract ConvexOUSDMetaStrategy is BaseConvexMetaStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /* Take 3pool LP and mint the corresponding amount of ousd. Deposit and stake that to\n * ousd Curve Metapool. Take the LP from metapool and deposit them to Convex.\n */\n function _lpDepositAll() internal override {\n ICurvePool curvePool = ICurvePool(platformAddress);\n\n uint256 threePoolLpBalance = IERC20(pTokenAddress).balanceOf(\n address(this)\n );\n uint256 curve3PoolVirtualPrice = curvePool.get_virtual_price();\n uint256 threePoolLpDollarValue = threePoolLpBalance.mulTruncate(\n curve3PoolVirtualPrice\n );\n\n // safe to cast since min value is at least 0\n uint256 ousdToAdd = uint256(\n _max(\n 0,\n int256(\n metapool.balances(crvCoinIndex).mulTruncate(\n curve3PoolVirtualPrice\n )\n ) -\n int256(metapool.balances(mainCoinIndex)) +\n int256(threePoolLpDollarValue)\n )\n );\n\n /* Add so much OUSD so that the pool ends up being balanced. And at minimum\n * add twice as much OUSD as 3poolLP and at maximum at twice as\n * much OUSD.\n */\n ousdToAdd = Math.max(ousdToAdd, threePoolLpDollarValue);\n ousdToAdd = Math.min(ousdToAdd, threePoolLpDollarValue * 2);\n\n /* Mint OUSD with a strategy that attempts to contribute to stability of OUSD metapool. Try\n * to mint so much OUSD that after deployment of liquidity pool ends up being balanced.\n *\n * To manage unpredictability minimal OUSD minted will always be at least equal or greater\n * to stablecoin(DAI, USDC, USDT) amount of 3CRVLP deployed. And never larger than twice the\n * stablecoin amount of 3CRVLP deployed even if it would have a further beneficial effect\n * on pool stability.\n */\n if (ousdToAdd > 0) {\n IVault(vaultAddress).mintForStrategy(ousdToAdd);\n }\n\n uint256[2] memory _amounts = [ousdToAdd, threePoolLpBalance];\n\n uint256 metapoolVirtualPrice = metapool.get_virtual_price();\n /**\n * First convert all the deposited tokens to dollar values,\n * then divide by virtual price to convert to metapool LP tokens\n * and apply the max slippage\n */\n uint256 minReceived = (ousdToAdd + threePoolLpDollarValue)\n .divPrecisely(metapoolVirtualPrice)\n .mulTruncate(uint256(1e18) - MAX_SLIPPAGE);\n\n uint256 metapoolLp = metapool.add_liquidity(_amounts, minReceived);\n\n bool success = IConvexDeposits(cvxDepositorAddress).deposit(\n cvxDepositorPTokenId,\n metapoolLp,\n true // Deposit with staking\n );\n\n require(success, \"Failed to deposit to Convex\");\n }\n\n /**\n * Withdraw the specified amount of tokens from the gauge. And use all the resulting tokens\n * to remove liquidity from metapool\n * @param num3CrvTokens Number of 3CRV tokens to withdraw from metapool\n */\n function _lpWithdraw(uint256 num3CrvTokens) internal override {\n ICurvePool curvePool = ICurvePool(platformAddress);\n /* The rate between coins in the metapool determines the rate at which metapool returns\n * tokens when doing balanced removal (remove_liquidity call). And by knowing how much 3crvLp\n * we want we can determine how much of OUSD we receive by removing liquidity.\n *\n * Because we are doing balanced removal we should be making profit when removing liquidity in a\n * pool tilted to either side.\n *\n * Important: A downside is that the Strategist / Governor needs to be\n * cognisant of not removing too much liquidity. And while the proposal to remove liquidity\n * is being voted on the pool tilt might change so much that the proposal that has been valid while\n * created is no longer valid.\n */\n\n uint256 crvPoolBalance = metapool.balances(crvCoinIndex);\n /* K is multiplied by 1e36 which is used for higher precision calculation of required\n * metapool LP tokens. Without it the end value can have rounding errors up to precision of\n * 10 digits. This way we move the decimal point by 36 places when doing the calculation\n * and again by 36 places when we are done with it.\n */\n uint256 k = (1e36 * metapoolLPToken.totalSupply()) / crvPoolBalance;\n // simplifying below to: `uint256 diff = (num3CrvTokens - 1) * k` causes loss of precision\n // prettier-ignore\n // slither-disable-next-line divide-before-multiply\n uint256 diff = crvPoolBalance * k -\n (crvPoolBalance - num3CrvTokens - 1) * k;\n uint256 lpToBurn = diff / 1e36;\n\n uint256 gaugeTokens = IRewardStaking(cvxRewardStakerAddress).balanceOf(\n address(this)\n );\n\n require(\n lpToBurn <= gaugeTokens,\n string(\n bytes.concat(\n bytes(\"Attempting to withdraw \"),\n bytes(Strings.toString(lpToBurn)),\n bytes(\", metapoolLP but only \"),\n bytes(Strings.toString(gaugeTokens)),\n bytes(\" available.\")\n )\n )\n );\n\n // withdraw and unwrap with claim takes back the lpTokens and also collects the rewards for deposit\n IRewardStaking(cvxRewardStakerAddress).withdrawAndUnwrap(\n lpToBurn,\n true\n );\n\n // calculate the min amount of OUSD expected for the specified amount of LP tokens\n uint256 minOUSDAmount = lpToBurn.mulTruncate(\n metapool.get_virtual_price()\n ) -\n num3CrvTokens.mulTruncate(curvePool.get_virtual_price()) -\n 1;\n\n // withdraw the liquidity from metapool\n uint256[2] memory _removedAmounts = metapool.remove_liquidity(\n lpToBurn,\n [minOUSDAmount, num3CrvTokens]\n );\n\n IVault(vaultAddress).burnForStrategy(_removedAmounts[mainCoinIndex]);\n }\n\n function _lpWithdrawAll() internal override {\n IERC20 metapoolErc20 = IERC20(address(metapool));\n uint256 gaugeTokens = IRewardStaking(cvxRewardStakerAddress).balanceOf(\n address(this)\n );\n IRewardStaking(cvxRewardStakerAddress).withdrawAndUnwrap(\n gaugeTokens,\n true\n );\n\n uint256[2] memory _minAmounts = [uint256(0), uint256(0)];\n uint256[2] memory _removedAmounts = metapool.remove_liquidity(\n metapoolErc20.balanceOf(address(this)),\n _minAmounts\n );\n\n IVault(vaultAddress).burnForStrategy(_removedAmounts[mainCoinIndex]);\n }\n}\n" + }, + "contracts/strategies/ConvexStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Curve Convex Strategy\n * @notice Investment strategy for investing stablecoins via Curve 3Pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { ICurvePool } from \"./ICurvePool.sol\";\nimport { IRewardStaking } from \"./IRewardStaking.sol\";\nimport { IConvexDeposits } from \"./IConvexDeposits.sol\";\nimport { IERC20, BaseCurveStrategy, InitializableAbstractStrategy } from \"./BaseCurveStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\n\n/*\n * IMPORTANT(!) If ConvexStrategy needs to be re-deployed, it requires new\n * proxy contract with fresh storage slots. Changes in `BaseCurveStrategy`\n * storage slots would break existing implementation.\n *\n * Remove this notice if ConvexStrategy is re-deployed\n */\ncontract ConvexStrategy is BaseCurveStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n address internal cvxDepositorAddress;\n address internal cvxRewardStakerAddress;\n // slither-disable-next-line constable-states\n address private _deprecated_cvxRewardTokenAddress;\n uint256 internal cvxDepositorPTokenId;\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /**\n * Initializer for setting up strategy internal state. This overrides the\n * InitializableAbstractStrategy initializer as Curve strategies don't fit\n * well within that abstraction.\n * @param _rewardTokenAddresses Address of CRV & CVX\n * @param _assets Addresses of supported assets. MUST be passed in the same\n * order as returned by coins on the pool contract, i.e.\n * DAI, USDC, USDT\n * @param _pTokens Platform Token corresponding addresses\n * @param _cvxDepositorAddress Address of the Convex depositor(AKA booster) for this pool\n * @param _cvxRewardStakerAddress Address of the CVX rewards staker\n * @param _cvxDepositorPTokenId Pid of the pool referred to by Depositor and staker\n */\n function initialize(\n address[] calldata _rewardTokenAddresses, // CRV + CVX\n address[] calldata _assets,\n address[] calldata _pTokens,\n address _cvxDepositorAddress,\n address _cvxRewardStakerAddress,\n uint256 _cvxDepositorPTokenId\n ) external onlyGovernor initializer {\n require(_assets.length == 3, \"Must have exactly three assets\");\n // Should be set prior to abstract initialize call otherwise\n // abstractSetPToken calls will fail\n cvxDepositorAddress = _cvxDepositorAddress;\n cvxRewardStakerAddress = _cvxRewardStakerAddress;\n cvxDepositorPTokenId = _cvxDepositorPTokenId;\n pTokenAddress = _pTokens[0];\n\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n _approveBase();\n }\n\n function _lpDepositAll() internal override {\n IERC20 pToken = IERC20(pTokenAddress);\n // Deposit with staking\n bool success = IConvexDeposits(cvxDepositorAddress).deposit(\n cvxDepositorPTokenId,\n pToken.balanceOf(address(this)),\n true\n );\n require(success, \"Failed to deposit to Convex\");\n }\n\n function _lpWithdraw(uint256 numCrvTokens) internal override {\n uint256 gaugePTokens = IRewardStaking(cvxRewardStakerAddress).balanceOf(\n address(this)\n );\n\n // Not enough in this contract or in the Gauge, can't proceed\n require(numCrvTokens > gaugePTokens, \"Insufficient 3CRV balance\");\n\n // withdraw and unwrap with claim takes back the lpTokens and also collects the rewards to this\n IRewardStaking(cvxRewardStakerAddress).withdrawAndUnwrap(\n numCrvTokens,\n true\n );\n }\n\n function _lpWithdrawAll() internal override {\n // withdraw and unwrap with claim takes back the lpTokens and also collects the rewards to this\n IRewardStaking(cvxRewardStakerAddress).withdrawAndUnwrap(\n IRewardStaking(cvxRewardStakerAddress).balanceOf(address(this)),\n true\n );\n }\n\n function _approveBase() internal override {\n IERC20 pToken = IERC20(pTokenAddress);\n // 3Pool for LP token (required for removing liquidity)\n pToken.safeApprove(platformAddress, 0);\n pToken.safeApprove(platformAddress, type(uint256).max);\n // Gauge for LP token\n pToken.safeApprove(cvxDepositorAddress, 0);\n pToken.safeApprove(cvxDepositorAddress, type(uint256).max);\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n public\n view\n override\n returns (uint256 balance)\n {\n require(assetToPToken[_asset] != address(0), \"Unsupported asset\");\n // LP tokens in this contract. This should generally be nothing as we\n // should always stake the full balance in the Gauge, but include for\n // safety\n uint256 contractPTokens = IERC20(pTokenAddress).balanceOf(\n address(this)\n );\n uint256 gaugePTokens = IRewardStaking(cvxRewardStakerAddress).balanceOf(\n address(this)\n );\n uint256 totalPTokens = contractPTokens + gaugePTokens;\n\n ICurvePool curvePool = ICurvePool(platformAddress);\n if (totalPTokens > 0) {\n uint256 virtual_price = curvePool.get_virtual_price();\n uint256 value = (totalPTokens * virtual_price) / 1e18;\n uint256 assetDecimals = Helpers.getDecimals(_asset);\n balance = value.scaleBy(assetDecimals, 18) / 3;\n }\n }\n\n /**\n * @dev Collect accumulated CRV and CVX and send to Vault.\n */\n function collectRewardTokens()\n external\n override\n onlyHarvester\n nonReentrant\n {\n // Collect CRV and CVX\n IRewardStaking(cvxRewardStakerAddress).getReward();\n _collectRewardTokens();\n }\n}\n" + }, + "contracts/strategies/FluxStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Flux Strategy\n * @notice Investment strategy for investing stablecoins via Flux\n * @author Origin Protocol Inc\n */\n\nimport { CompoundStrategy } from \"./CompoundStrategy.sol\";\n\ncontract FluxStrategy is CompoundStrategy {\n constructor(BaseStrategyConfig memory _stratConfig)\n CompoundStrategy(_stratConfig)\n {}\n\n /**\n * @inheritdoc CompoundStrategy\n */\n function collectRewardTokens() external override {\n // Intentionally not adding any modifiers to not increase contract size\n // Flux strategy has no reward tokens\n }\n}\n" + }, + "contracts/strategies/FraxETHStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OETH FraxETH Strategy\n * @notice Investment WETH and FraxETH into the sFraxETH staking contract\n * @author Origin Protocol Inc\n */\nimport { IERC4626 } from \"../../lib/openzeppelin/interfaces/IERC4626.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IWETH9 } from \"../interfaces/IWETH9.sol\";\nimport { IFraxETHMinter } from \"../interfaces/IFraxETHMinter.sol\";\nimport { Generalized4626Strategy, IERC20, InitializableAbstractStrategy } from \"./Generalized4626Strategy.sol\";\n\ncontract FraxETHStrategy is Generalized4626Strategy {\n using SafeERC20 for IERC20;\n\n address public constant weth = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;\n\n IFraxETHMinter public constant fraxETHMinter =\n IFraxETHMinter(0xbAFA44EFE7901E04E39Dad13167D089C559c1138);\n\n /**\n * @param _baseConfig Base strategy config with platformAddress (sfrxETH) and vaultAddress (OETHVaultProxy)\n * @param _assetToken Address of the ERC-4626 asset token (frxETH)\n */\n constructor(BaseStrategyConfig memory _baseConfig, address _assetToken)\n Generalized4626Strategy(_baseConfig, _assetToken)\n {}\n\n function initialize() external override onlyGovernor initializer {\n address[] memory rewardTokens = new address[](0);\n address[] memory assets = new address[](2);\n address[] memory pTokens = new address[](2);\n\n assets[0] = address(assetToken);\n assets[1] = address(weth);\n pTokens[0] = address(platformAddress);\n pTokens[1] = address(platformAddress);\n\n InitializableAbstractStrategy._initialize(\n rewardTokens,\n assets,\n pTokens\n );\n }\n\n function _deposit(address _asset, uint256 _amount) internal override {\n require(_amount > 0, \"Must deposit something\");\n\n if (_asset == weth) {\n // Unwrap WETH\n IWETH9(weth).withdraw(_amount);\n\n // Deposit ETH for frxETH and stake it\n // slither-disable-next-line unused-return\n fraxETHMinter.submitAndDeposit{ value: _amount }(address(this));\n } else if (_asset == address(assetToken)) {\n // Stake frxETH\n // slither-disable-next-line unused-return\n IERC4626(platformAddress).deposit(_amount, address(this));\n } else {\n revert(\"Unexpected asset address\");\n }\n\n emit Deposit(_asset, address(shareToken), _amount);\n }\n\n /**\n * @dev Retuns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return _asset == address(assetToken) || _asset == weth;\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n virtual\n override\n returns (uint256 balance)\n {\n if (_asset == weth) {\n // For WETH, it's always 0\n return 0;\n }\n\n // If it's not WETH, it has to be frxETH\n require(_asset == address(assetToken), \"Unexpected asset address\");\n\n /* We are intentionally not counting the amount of assetToken parked on the\n * contract toward the checkBalance. The deposit and withdraw functions\n * should not result in assetToken being unused and owned by this strategy\n * contract.\n */\n return IERC4626(platformAddress).maxWithdraw(address(this));\n }\n\n /**\n * @dev Deposit the entire balance of assetToken to gain shareToken\n */\n function depositAll() external virtual override onlyVault nonReentrant {\n uint256 balance = assetToken.balanceOf(address(this));\n if (balance > 0) {\n _deposit(address(assetToken), balance);\n }\n\n uint256 wethBalance = IWETH9(weth).balanceOf(address(this));\n if (wethBalance > 0) {\n _deposit(weth, wethBalance);\n }\n }\n\n /**\n * @dev Accept ETH\n */\n receive() external payable {}\n}\n" + }, + "contracts/strategies/FrxEthRedeemStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC721Receiver } from \"@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol\";\n\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\nimport { IWETH9 } from \"../interfaces/IWETH9.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\n\ninterface IFraxEtherRedemptionQueue {\n function burnRedemptionTicketNft(uint256 _nftId, address payable _recipient)\n external;\n\n function enterRedemptionQueue(address _recipient, uint120 _amountToRedeem)\n external\n returns (uint256 _nftId);\n}\n\n/**\n * @title Frax ETH Redeem Strategy\n * @notice This strategy redeems Frax ETH for ETH via the Frax Eth Redemption Queue contract\n * @author Origin Protocol Inc\n */\ncontract FrxEthRedeemStrategy is InitializableAbstractStrategy {\n IWETH9 private constant weth =\n IWETH9(0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2);\n IERC20 private constant frxETH =\n IERC20(0x5E8422345238F34275888049021821E8E08CAa1f);\n IFraxEtherRedemptionQueue private constant redemptionQueue =\n IFraxEtherRedemptionQueue(0x82bA8da44Cd5261762e629dd5c605b17715727bd);\n uint256 public constant maxRedeemTicket = 250e18;\n uint256 public outstandingRedeems;\n\n event RedeemNFTMinted(uint256 _nftId, uint256 _amount);\n event RedeemNFTBurned(uint256 _nftId);\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {\n require(maxRedeemTicket < type(uint120).max);\n }\n\n /**\n * @notice initialize function, to set up initial internal state\n * @param _rewardTokenAddresses Address of reward token for platform\n * @param _assets Addresses of initial supported assets\n * @param _pTokens Platform Token corresponding addresses\n */\n function initialize(\n address[] memory _rewardTokenAddresses,\n address[] memory _assets,\n address[] memory _pTokens\n ) external onlyGovernor initializer {\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n safeApproveAllTokens();\n }\n\n /**\n * @notice deposit() function not used for this strategy. Use depositAll() instead.\n */\n function deposit(address, uint256) public override onlyVault nonReentrant {\n // This method no longer used by the VaultAdmin, and we don't want it\n // to be used by VaultCore.\n require(false, \"use depositAll() instead\");\n }\n\n /**\n * @notice Takes all given frxETH and creates new redeem tickets\n */\n function depositAll() external override onlyVault nonReentrant {\n uint256 frxETHStart = frxETH.balanceOf(address(this));\n require(frxETHStart > 0, \"No frxETH to redeem\");\n uint256 frxETHRemaining = frxETHStart;\n\n while (frxETHRemaining > 0) {\n uint256 amount = frxETHRemaining > maxRedeemTicket\n ? maxRedeemTicket\n : frxETHRemaining;\n uint256 nftId = redemptionQueue.enterRedemptionQueue(\n address(this),\n uint120(amount)\n );\n frxETHRemaining -= amount;\n emit RedeemNFTMinted(nftId, amount);\n }\n\n require(\n frxETH.balanceOf(address(this)) == 0,\n \"Not all FraxEth sent to redemption queue\"\n );\n outstandingRedeems += frxETHStart; // Single set for gas reasons\n\n // This strategy claims to support WETH, so it is posible for\n // the vault to transfer WETH to it. This returns any deposited WETH\n // to the vault so that it is not lost for balance tracking purposes.\n uint256 wethBalance = weth.balanceOf(address(this));\n if (wethBalance > 0) {\n // slither-disable-next-line unchecked-transfer\n weth.transfer(vaultAddress, wethBalance);\n }\n\n emit Deposit(address(frxETH), address(redemptionQueue), frxETHStart);\n }\n\n /**\n * @notice Withdraw an asset from the underlying platform\n * @param _recipient Address to receive withdrawn assets\n * @param _asset Address of the asset to withdraw\n * @param _amount Amount of assets to withdraw\n */\n function withdraw(\n // solhint-disable-next-line no-unused-vars\n address _recipient,\n // solhint-disable-next-line no-unused-vars\n address _asset,\n // solhint-disable-next-line no-unused-vars\n uint256 _amount\n ) external override onlyVault nonReentrant {\n // Does nothing - all redeems need to be called manually by the\n // strategist via redeemTickets\n require(false, \"use redeemTickets() instead\");\n }\n\n /**\n * @notice Redeem specific tickets from the Queue.\n * Called by the strategist.\n * @param _nftIds Array of NFT IDs to redeem\n */\n function redeemTickets(uint256[] memory _nftIds, uint256 expectedAmount)\n external\n nonReentrant\n {\n require(\n msg.sender == IVault(vaultAddress).strategistAddr(),\n \"Caller is not the Strategist\"\n );\n uint256 startingBalance = payable(address(this)).balance;\n for (uint256 i = 0; i < _nftIds.length; i++) {\n uint256 nftId = _nftIds[i];\n redemptionQueue.burnRedemptionTicketNft(\n nftId,\n payable(address(this))\n );\n emit RedeemNFTBurned(nftId);\n }\n\n uint256 currentBalance = payable(address(this)).balance;\n uint256 redeemedAmount = currentBalance - startingBalance;\n require(\n expectedAmount == redeemedAmount,\n \"Redeemed amount does not match expected amount\"\n );\n outstandingRedeems -= redeemedAmount;\n weth.deposit{ value: currentBalance }();\n // slither-disable-next-line unchecked-transfer\n weth.transfer(vaultAddress, currentBalance);\n emit Withdrawal(\n address(weth),\n address(redemptionQueue),\n currentBalance\n );\n }\n\n function _abstractSetPToken(address, address) internal override {\n revert(\"No pTokens are used\");\n }\n\n /**\n * @notice Withdraw all assets from this strategy, and transfer to the Vault.\n * In correct operation, this strategy should never hold any assets.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n if (payable(address(this)).balance > 0) {\n weth.deposit{ value: payable(address(this)).balance }();\n }\n uint256 wethBalance = weth.balanceOf(address(this));\n if (wethBalance > 0) {\n // slither-disable-next-line unchecked-transfer\n weth.transfer(vaultAddress, wethBalance);\n emit Withdrawal(address(weth), address(0), wethBalance);\n }\n uint256 fraxEthBalance = frxETH.balanceOf(address(this));\n if (fraxEthBalance > 0) {\n // slither-disable-next-line unchecked-transfer\n frxETH.transfer(vaultAddress, fraxEthBalance);\n emit Withdrawal(address(frxETH), address(0), fraxEthBalance);\n }\n }\n\n /**\n * @notice Returns the amount of queued FraxEth that will be returned as WETH.\n * We return this as a WETH asset, since that is what it will eventually be returned as.\n * We only return the outstandingRedeems, because the contract itself should never hold any funds.\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n override\n returns (uint256 balance)\n {\n if (_asset == address(weth)) {\n return outstandingRedeems;\n } else if (_asset == address(frxETH)) {\n return 0;\n } else {\n revert(\"Unexpected asset address\");\n }\n }\n\n /**\n * @notice Approve the spending of all assets by their corresponding cToken,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens() public override {\n // slither-disable-next-line unused-return\n frxETH.approve(address(redemptionQueue), type(uint256).max);\n }\n\n /**\n * @notice Check if an asset is supported.\n * @param _asset Address of the asset\n * @return bool Whether asset is supported\n */\n function supportsAsset(address _asset) public pure override returns (bool) {\n // frxETH can be deposited by the vault and balances are reported in weth\n return _asset == address(frxETH) || _asset == address(weth);\n }\n\n function onERC721Received(\n // solhint-disable-next-line no-unused-vars\n address operator,\n // solhint-disable-next-line no-unused-vars\n address from,\n // solhint-disable-next-line no-unused-vars\n uint256 tokenId,\n // solhint-disable-next-line no-unused-vars\n bytes calldata data\n ) external returns (bytes4) {\n return IERC721Receiver.onERC721Received.selector;\n }\n\n receive() external payable {}\n}\n" + }, + "contracts/strategies/Generalized4626Strategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Generalized 4626 Strategy\n * @notice Investment strategy for ERC-4626 Tokenized Vaults\n * @author Origin Protocol Inc\n */\nimport { IERC4626 } from \"../../lib/openzeppelin/interfaces/IERC4626.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\n\ncontract Generalized4626Strategy is InitializableAbstractStrategy {\n using SafeERC20 for IERC20;\n\n /// @dev Replaced with an immutable variable\n // slither-disable-next-line constable-states\n address private _deprecate_shareToken;\n /// @dev Replaced with an immutable variable\n // slither-disable-next-line constable-states\n address private _deprecate_assetToken;\n\n IERC20 public immutable shareToken;\n IERC20 public immutable assetToken;\n\n // For future use\n uint256[50] private __gap;\n\n /**\n * @param _baseConfig Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI,\n * and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\n * @param _assetToken Address of the ERC-4626 asset token. eg frxETH or DAI\n */\n constructor(BaseStrategyConfig memory _baseConfig, address _assetToken)\n InitializableAbstractStrategy(_baseConfig)\n {\n shareToken = IERC20(_baseConfig.platformAddress);\n assetToken = IERC20(_assetToken);\n }\n\n function initialize() external virtual onlyGovernor initializer {\n address[] memory rewardTokens = new address[](0);\n address[] memory assets = new address[](1);\n address[] memory pTokens = new address[](1);\n\n assets[0] = address(assetToken);\n pTokens[0] = address(platformAddress);\n\n InitializableAbstractStrategy._initialize(\n rewardTokens,\n assets,\n pTokens\n );\n }\n\n /**\n * @dev Deposit assets by converting them to shares\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n _deposit(_asset, _amount);\n }\n\n /**\n * @dev Deposit assets by converting them to shares\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function _deposit(address _asset, uint256 _amount) internal virtual {\n require(_amount > 0, \"Must deposit something\");\n require(_asset == address(assetToken), \"Unexpected asset address\");\n\n // slither-disable-next-line unused-return\n IERC4626(platformAddress).deposit(_amount, address(this));\n emit Deposit(_asset, address(shareToken), _amount);\n }\n\n /**\n * @dev Deposit the entire balance of assetToken to gain shareToken\n */\n function depositAll() external virtual override onlyVault nonReentrant {\n uint256 balance = assetToken.balanceOf(address(this));\n if (balance > 0) {\n _deposit(address(assetToken), balance);\n }\n }\n\n /**\n * @dev Withdraw asset by burning shares\n * @param _recipient Address to receive withdrawn asset\n * @param _asset Address of asset to withdraw\n * @param _amount Amount of asset to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external virtual override onlyVault nonReentrant {\n require(_amount > 0, \"Must withdraw something\");\n require(_recipient != address(0), \"Must specify recipient\");\n require(_asset == address(assetToken), \"Unexpected asset address\");\n\n // slither-disable-next-line unused-return\n IERC4626(platformAddress).withdraw(_amount, _recipient, address(this));\n emit Withdrawal(_asset, address(shareToken), _amount);\n }\n\n /**\n * @dev Internal method to respond to the addition of new asset / share tokens\n */\n function _abstractSetPToken(address, address) internal virtual override {\n _approveBase();\n }\n\n /**\n * @dev Remove all assets from platform and send them to Vault contract.\n */\n function withdrawAll()\n external\n virtual\n override\n onlyVaultOrGovernor\n nonReentrant\n {\n uint256 shareBalance = shareToken.balanceOf(address(this));\n uint256 assetAmount = 0;\n if (shareBalance > 0) {\n assetAmount = IERC4626(platformAddress).redeem(\n shareBalance,\n vaultAddress,\n address(this)\n );\n emit Withdrawal(\n address(assetToken),\n address(shareToken),\n assetAmount\n );\n }\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n virtual\n override\n returns (uint256 balance)\n {\n require(_asset == address(assetToken), \"Unexpected asset address\");\n /* We are intentionally not counting the amount of assetToken parked on the\n * contract toward the checkBalance. The deposit and withdraw functions\n * should not result in assetToken being unused and owned by this strategy\n * contract.\n */\n return IERC4626(platformAddress).maxWithdraw(address(this));\n }\n\n /**\n * @notice Governor approves the the ERC-4626 Tokenized Vault to spend the asset.\n */\n function safeApproveAllTokens() external override onlyGovernor {\n _approveBase();\n }\n\n function _approveBase() internal virtual {\n // Approval the asset to be trasferred to the ERC-4626 Tokenized Vualt.\n // Used by the ERC-4626 deposit() and mint() functions\n // slither-disable-next-line unused-return\n assetToken.approve(platformAddress, type(uint256).max);\n }\n\n /**\n * @dev Retuns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset)\n public\n view\n virtual\n override\n returns (bool)\n {\n return _asset == address(assetToken);\n }\n\n /**\n * @notice is not supported for this strategy as the asset and\n * ERC-4626 Tokenized Vault are set at deploy time.\n * @dev If the ERC-4626 Tokenized Vault needed to be changed, a new\n * contract would need to be deployed and the proxy updated.\n */\n function setPTokenAddress(address, address) external override onlyGovernor {\n revert(\"unsupported function\");\n }\n\n /**\n * @notice is not supported for this strategy as the asset and\n * ERC-4626 Tokenized Vault are set at deploy time.\n * @dev If the ERC-4626 Tokenized Vault needed to be changed, a new\n * contract would need to be deployed and the proxy updated.\n */\n function removePToken(uint256) external override onlyGovernor {\n revert(\"unsupported function\");\n }\n}\n" + }, + "contracts/strategies/IAave.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface for Aaves Lending Pool\n * Documentation: https://developers.aave.com/#lendingpool\n */\ninterface IAaveLendingPool {\n /**\n * @dev Deposits an `amount` of underlying asset into the reserve, receiving in return overlying aTokens.\n * - E.g. User deposits 100 USDC and gets in return 100 aUSDC\n * @param asset The address of the underlying asset to deposit\n * @param amount The amount to be deposited\n * @param onBehalfOf The address that will receive the aTokens, same as msg.sender if the user\n * wants to receive them on his own wallet, or a different address if the beneficiary of aTokens\n * is a different wallet\n * @param referralCode Code used to register the integrator originating the operation, for potential rewards.\n * 0 if the action is executed directly by the user, without any middle-man\n **/\n function deposit(\n address asset,\n uint256 amount,\n address onBehalfOf,\n uint16 referralCode\n ) external;\n\n /**\n * @dev Withdraws an `amount` of underlying asset from the reserve, burning the equivalent aTokens owned\n * E.g. User has 100 aUSDC, calls withdraw() and receives 100 USDC, burning the 100 aUSDC\n * @param asset The address of the underlying asset to withdraw\n * @param amount The underlying amount to be withdrawn\n * - Send the value type(uint256).max in order to withdraw the whole aToken balance\n * @param to Address that will receive the underlying, same as msg.sender if the user\n * wants to receive it on his own wallet, or a different address if the beneficiary is a\n * different wallet\n * @return The final amount withdrawn\n **/\n function withdraw(\n address asset,\n uint256 amount,\n address to\n ) external returns (uint256);\n}\n\n/**\n * @dev Interface for Aaves Lending Pool\n * Documentation: https://developers.aave.com/#lendingpooladdressesprovider\n */\ninterface ILendingPoolAddressesProvider {\n /**\n * @notice Get the current address for Aave LendingPool\n * @dev Lending pool is the core contract on which to call deposit\n */\n function getLendingPool() external view returns (address);\n}\n" + }, + "contracts/strategies/IAaveIncentivesController.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IAaveIncentivesController {\n event RewardsAccrued(address indexed user, uint256 amount);\n\n event RewardsClaimed(\n address indexed user,\n address indexed to,\n uint256 amount\n );\n\n event RewardsClaimed(\n address indexed user,\n address indexed to,\n address indexed claimer,\n uint256 amount\n );\n\n event ClaimerSet(address indexed user, address indexed claimer);\n\n /*\n * @dev Returns the configuration of the distribution for a certain asset\n * @param asset The address of the reference asset of the distribution\n * @return The asset index, the emission per second and the last updated timestamp\n **/\n function getAssetData(address asset)\n external\n view\n returns (\n uint256,\n uint256,\n uint256\n );\n\n /**\n * @dev Whitelists an address to claim the rewards on behalf of another address\n * @param user The address of the user\n * @param claimer The address of the claimer\n */\n function setClaimer(address user, address claimer) external;\n\n /**\n * @dev Returns the whitelisted claimer for a certain address (0x0 if not set)\n * @param user The address of the user\n * @return The claimer address\n */\n function getClaimer(address user) external view returns (address);\n\n /**\n * @dev Configure assets for a certain rewards emission\n * @param assets The assets to incentivize\n * @param emissionsPerSecond The emission for each asset\n */\n function configureAssets(\n address[] calldata assets,\n uint256[] calldata emissionsPerSecond\n ) external;\n\n /**\n * @dev Called by the corresponding asset on any update that affects the rewards distribution\n * @param asset The address of the user\n * @param userBalance The balance of the user of the asset in the lending pool\n * @param totalSupply The total supply of the asset in the lending pool\n **/\n function handleAction(\n address asset,\n uint256 userBalance,\n uint256 totalSupply\n ) external;\n\n /**\n * @dev Returns the total of rewards of an user, already accrued + not yet accrued\n * @param user The address of the user\n * @return The rewards\n **/\n function getRewardsBalance(address[] calldata assets, address user)\n external\n view\n returns (uint256);\n\n /**\n * @dev Claims reward for an user, on all the assets of the lending pool,\n * accumulating the pending rewards\n * @param amount Amount of rewards to claim\n * @param to Address that will be receiving the rewards\n * @return Rewards claimed\n **/\n function claimRewards(\n address[] calldata assets,\n uint256 amount,\n address to\n ) external returns (uint256);\n\n /**\n * @dev Claims reward for an user on behalf, on all the assets of the\n * lending pool, accumulating the pending rewards. The caller must\n * be whitelisted via \"allowClaimOnBehalf\" function by the RewardsAdmin role manager\n * @param amount Amount of rewards to claim\n * @param user Address to check and claim rewards\n * @param to Address that will be receiving the rewards\n * @return Rewards claimed\n **/\n function claimRewardsOnBehalf(\n address[] calldata assets,\n uint256 amount,\n address user,\n address to\n ) external returns (uint256);\n\n /**\n * @dev returns the unclaimed rewards of the user\n * @param user the address of the user\n * @return the unclaimed user rewards\n */\n function getUserUnclaimedRewards(address user)\n external\n view\n returns (uint256);\n\n /**\n * @dev returns the unclaimed rewards of the user\n * @param user the address of the user\n * @param asset The asset to incentivize\n * @return the user index for the asset\n */\n function getUserAssetData(address user, address asset)\n external\n view\n returns (uint256);\n\n /**\n * @dev for backward compatibility with previous implementation of the Incentives controller\n */\n function REWARD_TOKEN() external view returns (address);\n\n /**\n * @dev for backward compatibility with previous implementation of the Incentives controller\n */\n function PRECISION() external view returns (uint8);\n\n /**\n * @dev Gets the distribution end timestamp of the emissions\n */\n function DISTRIBUTION_END() external view returns (uint256);\n}\n" + }, + "contracts/strategies/IAaveStakeToken.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IAaveStakedToken {\n function COOLDOWN_SECONDS() external returns (uint256);\n\n function UNSTAKE_WINDOW() external returns (uint256);\n\n function balanceOf(address addr) external returns (uint256);\n\n function redeem(address to, uint256 amount) external;\n\n function stakersCooldowns(address addr) external returns (uint256);\n\n function cooldown() external;\n}\n" + }, + "contracts/strategies/ICompound.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @dev Compound C Token interface\n * Documentation: https://compound.finance/developers/ctokens\n */\ninterface ICERC20 {\n /**\n * @notice The mint function transfers an asset into the protocol, which begins accumulating\n * interest based on the current Supply Rate for the asset. The user receives a quantity of\n * cTokens equal to the underlying tokens supplied, divided by the current Exchange Rate.\n * @param mintAmount The amount of the asset to be supplied, in units of the underlying asset.\n * @return 0 on success, otherwise an Error codes\n */\n function mint(uint256 mintAmount) external returns (uint256);\n\n /**\n * @notice Sender redeems cTokens in exchange for the underlying asset\n * @dev Accrues interest whether or not the operation succeeds, unless reverted\n * @param redeemTokens The number of cTokens to redeem into underlying\n * @return uint 0=success, otherwise an error code.\n */\n function redeem(uint256 redeemTokens) external returns (uint256);\n\n /**\n * @notice The redeem underlying function converts cTokens into a specified quantity of the underlying\n * asset, and returns them to the user. The amount of cTokens redeemed is equal to the quantity of\n * underlying tokens received, divided by the current Exchange Rate. The amount redeemed must be less\n * than the user's Account Liquidity and the market's available liquidity.\n * @param redeemAmount The amount of underlying to be redeemed.\n * @return 0 on success, otherwise an error code.\n */\n function redeemUnderlying(uint256 redeemAmount) external returns (uint256);\n\n /**\n * @notice The user's underlying balance, representing their assets in the protocol, is equal to\n * the user's cToken balance multiplied by the Exchange Rate.\n * @param owner The account to get the underlying balance of.\n * @return The amount of underlying currently owned by the account.\n */\n function balanceOfUnderlying(address owner) external returns (uint256);\n\n /**\n * @notice Calculates the exchange rate from the underlying to the CToken\n * @dev This function does not accrue interest before calculating the exchange rate\n * @return Calculated exchange rate scaled by 1e18\n */\n function exchangeRateStored() external view returns (uint256);\n\n /**\n * @notice Get the token balance of the `owner`\n * @param owner The address of the account to query\n * @return The number of tokens owned by `owner`\n */\n function balanceOf(address owner) external view returns (uint256);\n\n /**\n * @notice Get the supply rate per block for supplying the token to Compound.\n */\n function supplyRatePerBlock() external view returns (uint256);\n\n /**\n * @notice Address of the Compound Comptroller.\n */\n function comptroller() external view returns (address);\n}\n" + }, + "contracts/strategies/IConvexDeposits.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IConvexDeposits {\n function deposit(\n uint256 _pid,\n uint256 _amount,\n bool _stake\n ) external returns (bool);\n\n function deposit(\n uint256 _amount,\n bool _lock,\n address _stakeAddress\n ) external;\n}\n" + }, + "contracts/strategies/ICRVMinter.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface ICRVMinter {\n function mint(address gaugeAddress) external;\n}\n" + }, + "contracts/strategies/ICurveETHPoolV1.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface ICurveETHPoolV1 {\n event AddLiquidity(\n address indexed provider,\n uint256[2] token_amounts,\n uint256[2] fees,\n uint256 invariant,\n uint256 token_supply\n );\n event ApplyNewFee(uint256 fee);\n event Approval(\n address indexed owner,\n address indexed spender,\n uint256 value\n );\n event CommitNewFee(uint256 new_fee);\n event RampA(\n uint256 old_A,\n uint256 new_A,\n uint256 initial_time,\n uint256 future_time\n );\n event RemoveLiquidity(\n address indexed provider,\n uint256[2] token_amounts,\n uint256[2] fees,\n uint256 token_supply\n );\n event RemoveLiquidityImbalance(\n address indexed provider,\n uint256[2] token_amounts,\n uint256[2] fees,\n uint256 invariant,\n uint256 token_supply\n );\n event RemoveLiquidityOne(\n address indexed provider,\n uint256 token_amount,\n uint256 coin_amount,\n uint256 token_supply\n );\n event StopRampA(uint256 A, uint256 t);\n event TokenExchange(\n address indexed buyer,\n int128 sold_id,\n uint256 tokens_sold,\n int128 bought_id,\n uint256 tokens_bought\n );\n event Transfer(\n address indexed sender,\n address indexed receiver,\n uint256 value\n );\n\n function A() external view returns (uint256);\n\n function A_precise() external view returns (uint256);\n\n function DOMAIN_SEPARATOR() external view returns (bytes32);\n\n function add_liquidity(uint256[2] memory _amounts, uint256 _min_mint_amount)\n external\n payable\n returns (uint256);\n\n function add_liquidity(\n uint256[2] memory _amounts,\n uint256 _min_mint_amount,\n address _receiver\n ) external payable returns (uint256);\n\n function admin_action_deadline() external view returns (uint256);\n\n function admin_balances(uint256 i) external view returns (uint256);\n\n function admin_fee() external view returns (uint256);\n\n function allowance(address arg0, address arg1)\n external\n view\n returns (uint256);\n\n function apply_new_fee() external;\n\n function approve(address _spender, uint256 _value) external returns (bool);\n\n function balanceOf(address arg0) external view returns (uint256);\n\n function balances(uint256 arg0) external view returns (uint256);\n\n function calc_token_amount(uint256[2] memory _amounts, bool _is_deposit)\n external\n view\n returns (uint256);\n\n function calc_withdraw_one_coin(uint256 _burn_amount, int128 i)\n external\n view\n returns (uint256);\n\n function coins(uint256 arg0) external view returns (address);\n\n function commit_new_fee(uint256 _new_fee) external;\n\n function decimals() external view returns (uint256);\n\n function ema_price() external view returns (uint256);\n\n function exchange(\n int128 i,\n int128 j,\n uint256 _dx,\n uint256 _min_dy\n ) external payable returns (uint256);\n\n function exchange(\n int128 i,\n int128 j,\n uint256 _dx,\n uint256 _min_dy,\n address _receiver\n ) external payable returns (uint256);\n\n function fee() external view returns (uint256);\n\n function future_A() external view returns (uint256);\n\n function future_A_time() external view returns (uint256);\n\n function future_fee() external view returns (uint256);\n\n function get_balances() external view returns (uint256[2] memory);\n\n function get_dy(\n int128 i,\n int128 j,\n uint256 dx\n ) external view returns (uint256);\n\n function get_p() external view returns (uint256);\n\n function get_virtual_price() external view returns (uint256);\n\n function initial_A() external view returns (uint256);\n\n function initial_A_time() external view returns (uint256);\n\n function initialize(\n string memory _name,\n string memory _symbol,\n address[4] memory _coins,\n uint256[4] memory _rate_multipliers,\n uint256 _A,\n uint256 _fee\n ) external;\n\n function last_price() external view returns (uint256);\n\n function ma_exp_time() external view returns (uint256);\n\n function ma_last_time() external view returns (uint256);\n\n function name() external view returns (string memory);\n\n function nonces(address arg0) external view returns (uint256);\n\n function permit(\n address _owner,\n address _spender,\n uint256 _value,\n uint256 _deadline,\n uint8 _v,\n bytes32 _r,\n bytes32 _s\n ) external returns (bool);\n\n function price_oracle() external view returns (uint256);\n\n function ramp_A(uint256 _future_A, uint256 _future_time) external;\n\n function remove_liquidity(\n uint256 _burn_amount,\n uint256[2] memory _min_amounts\n ) external returns (uint256[2] memory);\n\n function remove_liquidity(\n uint256 _burn_amount,\n uint256[2] memory _min_amounts,\n address _receiver\n ) external returns (uint256[2] memory);\n\n function remove_liquidity_imbalance(\n uint256[2] memory _amounts,\n uint256 _max_burn_amount\n ) external returns (uint256);\n\n function remove_liquidity_imbalance(\n uint256[2] memory _amounts,\n uint256 _max_burn_amount,\n address _receiver\n ) external returns (uint256);\n\n function remove_liquidity_one_coin(\n uint256 _burn_amount,\n int128 i,\n uint256 _min_received\n ) external returns (uint256);\n\n function remove_liquidity_one_coin(\n uint256 _burn_amount,\n int128 i,\n uint256 _min_received,\n address _receiver\n ) external returns (uint256);\n\n function set_ma_exp_time(uint256 _ma_exp_time) external;\n\n function stop_ramp_A() external;\n\n function symbol() external view returns (string memory);\n\n function totalSupply() external view returns (uint256);\n\n function transfer(address _to, uint256 _value) external returns (bool);\n\n function transferFrom(\n address _from,\n address _to,\n uint256 _value\n ) external returns (bool);\n\n function version() external view returns (string memory);\n\n function withdraw_admin_fees() external;\n}\n" + }, + "contracts/strategies/ICurveGauge.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface ICurveGauge {\n function balanceOf(address account) external view returns (uint256);\n\n function deposit(uint256 value, address account) external;\n\n function withdraw(uint256 value) external;\n}\n" + }, + "contracts/strategies/ICurveMetaPool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.4;\n\ninterface ICurveMetaPool {\n function add_liquidity(uint256[2] calldata amounts, uint256 min_mint_amount)\n external\n returns (uint256);\n\n function get_virtual_price() external view returns (uint256);\n\n function remove_liquidity(uint256 _amount, uint256[2] calldata min_amounts)\n external\n returns (uint256[2] calldata);\n\n function remove_liquidity_one_coin(\n uint256 _token_amount,\n int128 i,\n uint256 min_amount\n ) external returns (uint256);\n\n function remove_liquidity_imbalance(\n uint256[2] calldata amounts,\n uint256 max_burn_amount\n ) external returns (uint256);\n\n function calc_withdraw_one_coin(uint256 _token_amount, int128 i)\n external\n view\n returns (uint256);\n\n function balances(uint256 i) external view returns (uint256);\n\n function calc_token_amount(uint256[2] calldata amounts, bool deposit)\n external\n view\n returns (uint256);\n\n function base_pool() external view returns (address);\n\n function fee() external view returns (uint256);\n\n function coins(uint256 i) external view returns (address);\n\n function exchange(\n int128 i,\n int128 j,\n uint256 dx,\n uint256 min_dy\n ) external returns (uint256);\n\n function get_dy(\n int128 i,\n int128 j,\n uint256 dx\n ) external view returns (uint256);\n}\n" + }, + "contracts/strategies/ICurvePool.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface ICurvePool {\n function get_virtual_price() external view returns (uint256);\n\n function add_liquidity(uint256[3] calldata _amounts, uint256 _min) external;\n\n function balances(uint256) external view returns (uint256);\n\n function calc_token_amount(uint256[3] calldata _amounts, bool _deposit)\n external\n returns (uint256);\n\n function fee() external view returns (uint256);\n\n function remove_liquidity_one_coin(\n uint256 _amount,\n int128 _index,\n uint256 _minAmount\n ) external;\n\n function remove_liquidity(\n uint256 _amount,\n uint256[3] calldata _minWithdrawAmounts\n ) external;\n\n function calc_withdraw_one_coin(uint256 _amount, int128 _index)\n external\n view\n returns (uint256);\n\n function exchange(\n uint256 i,\n uint256 j,\n uint256 dx,\n uint256 min_dy\n ) external returns (uint256);\n\n function coins(uint256 _index) external view returns (address);\n\n function remove_liquidity_imbalance(\n uint256[3] calldata _amounts,\n uint256 maxBurnAmount\n ) external;\n}\n" + }, + "contracts/strategies/IRewardStaking.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ninterface IRewardStaking {\n function stakeFor(address, uint256) external;\n\n function stake(uint256) external;\n\n function withdraw(uint256 amount, bool claim) external;\n\n function withdrawAndUnwrap(uint256 amount, bool claim) external;\n\n function earned(address account) external view returns (uint256);\n\n function getReward() external;\n\n function getReward(address _account, bool _claimExtras) external;\n\n function extraRewardsLength() external returns (uint256);\n\n function extraRewards(uint256 _pid) external returns (address);\n\n function rewardToken() external returns (address);\n\n function balanceOf(address account) external view returns (uint256);\n}\n" + }, + "contracts/strategies/MorphoAaveStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD Morpho Aave Strategy\n * @notice Investment strategy for investing stablecoins via Morpho (Aave)\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20, InitializableAbstractStrategy } from \"../utils/InitializableAbstractStrategy.sol\";\nimport { IMorpho } from \"../interfaces/morpho/IMorpho.sol\";\nimport { ILens } from \"../interfaces/morpho/ILens.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\ncontract MorphoAaveStrategy is InitializableAbstractStrategy {\n address public constant MORPHO = 0x777777c9898D384F785Ee44Acfe945efDFf5f3E0;\n address public constant LENS = 0x507fA343d0A90786d86C7cd885f5C49263A91FF4;\n\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /**\n * @dev Initialize function, to set up initial internal state\n * @param _rewardTokenAddresses Address of reward token for platform\n * @param _assets Addresses of initial supported assets\n * @param _pTokens Platform Token corresponding addresses\n */\n function initialize(\n address[] calldata _rewardTokenAddresses,\n address[] calldata _assets,\n address[] calldata _pTokens\n ) external onlyGovernor initializer {\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n }\n\n /**\n * @dev Approve the spending of all assets by main Morpho contract,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens()\n external\n override\n onlyGovernor\n nonReentrant\n {\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; i++) {\n address asset = assetsMapped[i];\n\n // Safe approval\n IERC20(asset).safeApprove(MORPHO, 0);\n IERC20(asset).safeApprove(MORPHO, type(uint256).max);\n }\n }\n\n /**\n * @dev Internal method to respond to the addition of new asset\n * We need to approve and allow Morpho to move them\n * @param _asset Address of the asset to approve\n * @param _pToken The pToken for the approval\n */\n // solhint-disable-next-line no-unused-vars\n function _abstractSetPToken(address _asset, address _pToken)\n internal\n override\n {\n IERC20(_asset).safeApprove(MORPHO, 0);\n IERC20(_asset).safeApprove(MORPHO, type(uint256).max);\n }\n\n /**\n * @dev Collect accumulated rewards and send them to Harvester.\n */\n function collectRewardTokens()\n external\n override\n onlyHarvester\n nonReentrant\n {\n // Morpho Aave-v2 doesn't distribute reward tokens\n // solhint-disable-next-line max-line-length\n // Ref: https://developers.morpho.xyz/interact-with-morpho/get-started/interact-with-morpho/claim-rewards#morpho-aave-v2\n }\n\n /**\n * @dev Get the amount of rewards pending to be collected from the protocol\n */\n function getPendingRewards() external view returns (uint256 balance) {\n // Morpho Aave-v2 doesn't distribute reward tokens\n // solhint-disable-next-line max-line-length\n // Ref: https://developers.morpho.xyz/interact-with-morpho/get-started/interact-with-morpho/claim-rewards#morpho-aave-v2\n return 0;\n }\n\n /**\n * @dev Deposit asset into Morpho\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n _deposit(_asset, _amount);\n }\n\n /**\n * @dev Deposit asset into Morpho\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function _deposit(address _asset, uint256 _amount) internal {\n require(_amount > 0, \"Must deposit something\");\n\n address pToken = address(_getPTokenFor(_asset));\n\n IMorpho(MORPHO).supply(\n pToken,\n address(this), // the address of the user you want to supply on behalf of\n _amount\n );\n emit Deposit(_asset, pToken, _amount);\n }\n\n /**\n * @dev Deposit the entire balance of any supported asset into Morpho\n */\n function depositAll() external override onlyVault nonReentrant {\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n uint256 balance = IERC20(assetsMapped[i]).balanceOf(address(this));\n if (balance > 0) {\n _deposit(assetsMapped[i], balance);\n }\n }\n }\n\n /**\n * @dev Withdraw asset from Morpho\n * @param _recipient Address to receive withdrawn asset\n * @param _asset Address of asset to withdraw\n * @param _amount Amount of asset to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n _withdraw(_recipient, _asset, _amount);\n }\n\n function _withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) internal {\n require(_amount > 0, \"Must withdraw something\");\n require(_recipient != address(0), \"Must specify recipient\");\n\n address pToken = address(_getPTokenFor(_asset));\n\n IMorpho(MORPHO).withdraw(pToken, _amount);\n emit Withdrawal(_asset, pToken, _amount);\n IERC20(_asset).safeTransfer(_recipient, _amount);\n }\n\n /**\n * @dev Remove all assets from platform and send them to Vault contract.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n uint256 balance = _checkBalance(assetsMapped[i]);\n if (balance > 0) {\n _withdraw(vaultAddress, assetsMapped[i], balance);\n }\n }\n }\n\n /**\n * @dev Return total value of an asset held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n override\n returns (uint256 balance)\n {\n return _checkBalance(_asset);\n }\n\n function _checkBalance(address _asset)\n internal\n view\n returns (uint256 balance)\n {\n address pToken = address(_getPTokenFor(_asset));\n\n // Total value represented by decimal position of underlying token\n (, , balance) = ILens(LENS).getCurrentSupplyBalanceInOf(\n pToken,\n address(this)\n );\n }\n\n /**\n * @dev Retuns bool indicating whether asset is supported by strategy\n * @param _asset Address of the asset\n */\n function supportsAsset(address _asset) public view override returns (bool) {\n return assetToPToken[_asset] != address(0);\n }\n\n /**\n * @dev Get the pToken wrapped in the IERC20 interface for this asset.\n * Fails if the pToken doesn't exist in our mappings.\n * @param _asset Address of the asset\n * @return pToken Corresponding pToken to this asset\n */\n function _getPTokenFor(address _asset) internal view returns (IERC20) {\n address pToken = assetToPToken[_asset];\n require(pToken != address(0), \"pToken does not exist\");\n return IERC20(pToken);\n }\n}\n" + }, + "contracts/strategies/MorphoCompoundStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD Morpho Compound Strategy\n * @notice Investment strategy for investing stablecoins via Morpho (Compound)\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20, BaseCompoundStrategy, InitializableAbstractStrategy } from \"./BaseCompoundStrategy.sol\";\nimport { IMorpho } from \"../interfaces/morpho/IMorpho.sol\";\nimport { ILens } from \"../interfaces/morpho/ILens.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport \"../utils/Helpers.sol\";\n\ncontract MorphoCompoundStrategy is BaseCompoundStrategy {\n address public constant MORPHO = 0x8888882f8f843896699869179fB6E4f7e3B58888;\n address public constant LENS = 0x930f1b46e1D081Ec1524efD95752bE3eCe51EF67;\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /**\n * @dev Initialize function, to set up initial internal state\n * @param _rewardTokenAddresses Address of reward token for platform\n * @param _assets Addresses of initial supported assets\n * @param _pTokens Platform Token corresponding addresses\n */\n function initialize(\n address[] calldata _rewardTokenAddresses,\n address[] calldata _assets,\n address[] calldata _pTokens\n ) external onlyGovernor initializer {\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n }\n\n /**\n * @dev Approve the spending of all assets by main Morpho contract,\n * if for some reason is it necessary.\n */\n function safeApproveAllTokens()\n external\n override\n onlyGovernor\n nonReentrant\n {\n uint256 assetCount = assetsMapped.length;\n for (uint256 i = 0; i < assetCount; i++) {\n address asset = assetsMapped[i];\n\n // Safe approval\n IERC20(asset).safeApprove(MORPHO, 0);\n IERC20(asset).safeApprove(MORPHO, type(uint256).max);\n }\n }\n\n /**\n * @dev Internal method to respond to the addition of new asset\n * We need to approve and allow Morpho to move them\n * @param _asset Address of the asset to approve\n * @param _pToken The pToken for the approval\n */\n // solhint-disable-next-line no-unused-vars\n function _abstractSetPToken(address _asset, address _pToken)\n internal\n override\n {\n IERC20(_asset).safeApprove(MORPHO, 0);\n IERC20(_asset).safeApprove(MORPHO, type(uint256).max);\n }\n\n /**\n * @dev Collect accumulated rewards and send them to Harvester.\n */\n function collectRewardTokens()\n external\n override\n onlyHarvester\n nonReentrant\n {\n /**\n * Gas considerations. We could query Morpho LENS's `getUserUnclaimedRewards` for each\n * cToken separately and only claimRewards where it is economically feasible. Each call\n * (out of 3) costs ~60k gas extra.\n *\n * Each extra cToken in the `poolTokens` of `claimRewards` function makes that call\n * 89-120k more expensive gas wise.\n *\n * With Lens query in case where:\n * - there is only 1 reward token to collect. Net gas usage in best case would be\n * 3*60 - 2*120 = -60k -> saving 60k gas\n * - there are 2 reward tokens to collect. Net gas usage in best case would be\n * 3*60 - 120 = 60k -> more expensive for 60k gas\n * - there are 3 reward tokens to collect. Net gas usage in best case would be\n * 3*60 = 180k -> more expensive for 180k gas\n *\n * For the above reasoning such \"optimization\" is not implemented\n */\n\n address[] memory poolTokens = new address[](assetsMapped.length);\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n poolTokens[i] = assetToPToken[assetsMapped[i]];\n }\n\n // slither-disable-next-line unused-return\n IMorpho(MORPHO).claimRewards(\n poolTokens, // The addresses of the underlying protocol's pools to claim rewards from\n false // Whether to trade the accrued rewards for MORPHO token, with a premium\n );\n\n // Transfer COMP to Harvester\n IERC20 rewardToken = IERC20(rewardTokenAddresses[0]);\n uint256 balance = rewardToken.balanceOf(address(this));\n emit RewardTokenCollected(\n harvesterAddress,\n rewardTokenAddresses[0],\n balance\n );\n rewardToken.safeTransfer(harvesterAddress, balance);\n }\n\n /**\n * @dev Get the amount of rewards pending to be collected from the protocol\n */\n function getPendingRewards() external view returns (uint256 balance) {\n address[] memory poolTokens = new address[](assetsMapped.length);\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n poolTokens[i] = assetToPToken[assetsMapped[i]];\n }\n\n return ILens(LENS).getUserUnclaimedRewards(poolTokens, address(this));\n }\n\n /**\n * @dev Deposit asset into Morpho\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n _deposit(_asset, _amount);\n }\n\n /**\n * @dev Deposit asset into Morpho\n * @param _asset Address of asset to deposit\n * @param _amount Amount of asset to deposit\n */\n function _deposit(address _asset, uint256 _amount) internal {\n require(_amount > 0, \"Must deposit something\");\n\n IMorpho(MORPHO).supply(\n address(_getCTokenFor(_asset)),\n address(this), // the address of the user you want to supply on behalf of\n _amount\n );\n emit Deposit(_asset, address(_getCTokenFor(_asset)), _amount);\n }\n\n /**\n * @dev Deposit the entire balance of any supported asset into Morpho\n */\n function depositAll() external override onlyVault nonReentrant {\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n uint256 balance = IERC20(assetsMapped[i]).balanceOf(address(this));\n if (balance > 0) {\n _deposit(assetsMapped[i], balance);\n }\n }\n }\n\n /**\n * @dev Withdraw asset from Morpho\n * @param _recipient Address to receive withdrawn asset\n * @param _asset Address of asset to withdraw\n * @param _amount Amount of asset to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n _withdraw(_recipient, _asset, _amount);\n }\n\n function _withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) internal {\n require(_amount > 0, \"Must withdraw something\");\n require(_recipient != address(0), \"Must specify recipient\");\n\n address pToken = assetToPToken[_asset];\n\n IMorpho(MORPHO).withdraw(pToken, _amount);\n emit Withdrawal(_asset, address(_getCTokenFor(_asset)), _amount);\n IERC20(_asset).safeTransfer(_recipient, _amount);\n }\n\n /**\n * @dev Remove all assets from platform and send them to Vault contract.\n */\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n for (uint256 i = 0; i < assetsMapped.length; i++) {\n uint256 balance = _checkBalance(assetsMapped[i]);\n if (balance > 0) {\n _withdraw(vaultAddress, assetsMapped[i], balance);\n }\n }\n }\n\n /**\n * @dev Return total value of an asset held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n override\n returns (uint256 balance)\n {\n return _checkBalance(_asset);\n }\n\n function _checkBalance(address _asset)\n internal\n view\n returns (uint256 balance)\n {\n address pToken = assetToPToken[_asset];\n\n // Total value represented by decimal position of underlying token\n (, , balance) = ILens(LENS).getCurrentSupplyBalanceInOf(\n pToken,\n address(this)\n );\n }\n}\n" + }, + "contracts/strategies/NativeStaking/FeeAccumulator.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Address } from \"@openzeppelin/contracts/utils/Address.sol\";\n\nimport { Governable } from \"../../governance/Governable.sol\";\n\n/**\n * @title Fee Accumulator for Native Staking SSV Strategy\n * @notice Receives execution rewards which includes tx fees and\n * MEV rewards like tx priority and tx ordering.\n * It does NOT include swept ETH from beacon chain consensus rewards or full validator withdrawals.\n * @author Origin Protocol Inc\n */\ncontract FeeAccumulator is Governable {\n /// @notice The address of the Native Staking Strategy\n address public immutable STRATEGY;\n\n /**\n * @param _strategy Address of the Native Staking Strategy\n */\n constructor(address _strategy) {\n STRATEGY = _strategy;\n }\n\n /**\n * @notice sends all ETH in this FeeAccumulator contract to the Native Staking Strategy.\n * @return eth The amount of execution rewards that were sent to the Native Staking Strategy\n */\n function collect() external returns (uint256 eth) {\n require(msg.sender == STRATEGY, \"Caller is not the Strategy\");\n\n eth = address(this).balance;\n if (eth > 0) {\n // Send the ETH to the Native Staking Strategy\n Address.sendValue(payable(STRATEGY), eth);\n }\n }\n}\n" + }, + "contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { InitializableAbstractStrategy } from \"../../utils/InitializableAbstractStrategy.sol\";\nimport { IWETH9 } from \"../../interfaces/IWETH9.sol\";\nimport { FeeAccumulator } from \"./FeeAccumulator.sol\";\nimport { ValidatorAccountant } from \"./ValidatorAccountant.sol\";\n\nstruct ValidatorStakeData {\n bytes pubkey;\n bytes signature;\n bytes32 depositDataRoot;\n}\n\n/// @title Native Staking SSV Strategy\n/// @notice Strategy to deploy funds into DVT validators powered by the SSV Network\n/// @author Origin Protocol Inc\ncontract NativeStakingSSVStrategy is\n ValidatorAccountant,\n InitializableAbstractStrategy\n{\n using SafeERC20 for IERC20;\n\n /// @notice SSV ERC20 token that serves as a payment for operating SSV validators\n address public immutable SSV_TOKEN_ADDRESS;\n /// @notice Fee collector address\n /// @dev this address will receive Execution layer rewards - These are rewards earned for\n /// executing transactions on the Ethereum network as part of block proposals. They include\n /// priority fees (fees paid by users for their transactions to be included) and MEV rewards\n /// (rewards for arranging transactions in a way that benefits the validator).\n address public immutable FEE_ACCUMULATOR_ADDRESS;\n\n // For future use\n uint256[50] private __gap;\n\n /// @param _baseConfig Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI,\n /// and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\n /// @param _wethAddress Address of the Erc20 WETH Token contract\n /// @param _ssvToken Address of the Erc20 SSV Token contract\n /// @param _ssvNetwork Address of the SSV Network contract\n /// @param _feeAccumulator Address of the fee accumulator receiving execution layer validator rewards\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\n constructor(\n BaseStrategyConfig memory _baseConfig,\n address _wethAddress,\n address _ssvToken,\n address _ssvNetwork,\n address _feeAccumulator,\n address _beaconChainDepositContract\n )\n InitializableAbstractStrategy(_baseConfig)\n ValidatorAccountant(\n _wethAddress,\n _baseConfig.vaultAddress,\n _beaconChainDepositContract,\n _ssvNetwork\n )\n {\n SSV_TOKEN_ADDRESS = _ssvToken;\n FEE_ACCUMULATOR_ADDRESS = _feeAccumulator;\n }\n\n /// @notice initialize function, to set up initial internal state\n /// @param _rewardTokenAddresses Address of reward token for platform\n /// @param _assets Addresses of initial supported assets\n /// @param _pTokens Platform Token corresponding addresses\n function initialize(\n address[] memory _rewardTokenAddresses,\n address[] memory _assets,\n address[] memory _pTokens\n ) external onlyGovernor initializer {\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddresses,\n _assets,\n _pTokens\n );\n }\n\n /// @dev Convert accumulated ETH to WETH and send to the Harvester.\n /// Will revert if the strategy is paused for accounting.\n function _collectRewardTokens() internal override whenNotPaused {\n // collect ETH from execution rewards from the fee accumulator\n uint256 executionRewards = FeeAccumulator(FEE_ACCUMULATOR_ADDRESS)\n .collect();\n\n // total ETH rewards to be harvested = execution rewards + consensus rewards\n uint256 ethRewards = executionRewards + consensusRewards;\n\n require(\n address(this).balance >= ethRewards,\n \"insufficient eth balance\"\n );\n\n if (ethRewards > 0) {\n // reset the counter keeping track of beacon chain consensus rewards\n consensusRewards = 0;\n\n // Convert ETH rewards to WETH\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRewards }();\n\n emit RewardTokenCollected(\n harvesterAddress,\n WETH_TOKEN_ADDRESS,\n ethRewards\n );\n IERC20(WETH_TOKEN_ADDRESS).safeTransfer(\n harvesterAddress,\n ethRewards\n );\n }\n }\n\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\n /// It just checks the asset is WETH and emits the Deposit event.\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\n /// Will NOT revert if the strategy is paused from an accounting failure.\n /// @param _asset Address of asset to deposit. Has to be WETH.\n /// @param _amount Amount of assets that were transferred to the strategy by the vault.\n function deposit(address _asset, uint256 _amount)\n external\n override\n onlyVault\n nonReentrant\n {\n require(_asset == WETH_TOKEN_ADDRESS, \"Unsupported asset\");\n _deposit(_asset, _amount);\n }\n\n /// @dev Deposit WETH to this strategy so it can later be staked into a validator.\n /// @param _asset Address of WETH\n /// @param _amount Amount of WETH to deposit\n function _deposit(address _asset, uint256 _amount) internal {\n require(_amount > 0, \"Must deposit something\");\n /*\n * We could do a check here that would revert when \"_amount % 32 ether != 0\". With the idea of\n * not allowing deposits that will result in WETH sitting on the strategy after all the possible batches\n * of 32ETH have been staked.\n * But someone could mess with our strategy by sending some WETH to it. And we might want to deposit just\n * enough WETH to add it up to 32 so it can be staked. For that reason the check is left out.\n *\n * WETH sitting on the strategy won't interfere with the accounting since accounting only operates on ETH.\n */\n emit Deposit(_asset, address(0), _amount);\n }\n\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\n /// It just emits the Deposit event.\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\n /// Will NOT revert if the strategy is paused from an accounting failure.\n function depositAll() external override onlyVault nonReentrant {\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\n address(this)\n );\n if (wethBalance > 0) {\n _deposit(WETH_TOKEN_ADDRESS, wethBalance);\n }\n }\n\n /// @notice Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That\n /// can happen when:\n /// - the deposit was not a multiple of 32 WETH\n /// - someone sent WETH directly to this contract\n /// Will NOT revert if the strategy is paused from an accounting failure.\n /// @param _recipient Address to receive withdrawn assets\n /// @param _asset WETH to withdraw\n /// @param _amount Amount of WETH to withdraw\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external override onlyVault nonReentrant {\n _withdraw(_recipient, _asset, _amount);\n }\n\n function _withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) internal {\n require(_amount > 0, \"Must withdraw something\");\n require(_recipient != address(0), \"Must specify recipient\");\n\n emit Withdrawal(_asset, address(0), _amount);\n IERC20(_asset).safeTransfer(_recipient, _amount);\n }\n\n /// @notice transfer all WETH deposits back to the vault.\n /// This does not withdraw from the validators. That has to be done separately with the\n /// `exitSsvValidator` and `removeSsvValidator` operations.\n /// This does not withdraw any execution rewards from the FeeAccumulator or\n /// consensus rewards in this strategy.\n /// Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn.\n /// ETH from full validator withdrawals is sent to the Vault using `doAccounting`.\n /// Will NOT revert if the strategy is paused from an accounting failure.\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\n address(this)\n );\n if (wethBalance > 0) {\n _withdraw(vaultAddress, WETH_TOKEN_ADDRESS, wethBalance);\n }\n }\n\n function _abstractSetPToken(address _asset, address) internal override {}\n\n /// @notice Returns the total value of (W)ETH that is staked to the validators\n /// and WETH deposits that are still to be staked.\n /// This does not include ETH from consensus rewards sitting in this strategy\n /// or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested\n /// and sent to the Dripper so will eventually be sent to the Vault as WETH.\n /// @param _asset Address of weth asset\n /// @return balance Total value of (W)ETH\n function checkBalance(address _asset)\n external\n view\n override\n returns (uint256 balance)\n {\n require(_asset == WETH_TOKEN_ADDRESS, \"Unsupported asset\");\n\n balance =\n // add the ETH that has been staked in validators\n activeDepositedValidators *\n 32 ether +\n // add the WETH in the strategy from deposits that are still to be staked\n IERC20(WETH_TOKEN_ADDRESS).balanceOf(address(this));\n }\n\n function pause() external onlyStrategist {\n _pause();\n }\n\n /// @notice Returns bool indicating whether asset is supported by strategy.\n /// @param _asset The address of the asset token.\n function supportsAsset(address _asset) public view override returns (bool) {\n return _asset == WETH_TOKEN_ADDRESS;\n }\n\n /// @notice Approves the SSV Network contract to transfer SSV tokens for deposits\n function safeApproveAllTokens() external override {\n /// @dev Approves the SSV Network contract to transfer SSV tokens for deposits\n IERC20(SSV_TOKEN_ADDRESS).approve(\n SSV_NETWORK_ADDRESS,\n type(uint256).max\n );\n }\n\n /**\n * @notice Only accept ETH from the FeeAccumulator and the WETH contract - required when\n * unwrapping WETH just before staking it to the validator\n * @dev don't want to receive donations from anyone else as this will\n * mess with the accounting of the consensus rewards and validator full withdrawals\n */\n receive() external payable {\n require(\n msg.sender == FEE_ACCUMULATOR_ADDRESS ||\n msg.sender == WETH_TOKEN_ADDRESS,\n \"eth not from allowed contracts\"\n );\n }\n}\n" + }, + "contracts/strategies/NativeStaking/ValidatorAccountant.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ValidatorRegistrator } from \"./ValidatorRegistrator.sol\";\nimport { IWETH9 } from \"../../interfaces/IWETH9.sol\";\n\n/// @title Validator Accountant\n/// @notice Attributes the ETH swept from beacon chain validators to this strategy contract\n/// as either full or partial withdrawals. Partial withdrawals being consensus rewards.\n/// Full withdrawals are from exited validators.\n/// @author Origin Protocol Inc\nabstract contract ValidatorAccountant is ValidatorRegistrator {\n /// @notice The maximum amount of ETH that can be staked by a validator\n /// @dev this can change in the future with EIP-7251, Increase the MAX_EFFECTIVE_BALANCE\n uint256 public constant MAX_STAKE = 32 ether;\n\n /// @notice Keeps track of the total consensus rewards swept from the beacon chain\n uint256 public consensusRewards = 0;\n\n /// @notice start of fuse interval\n uint256 public fuseIntervalStart = 0;\n /// @notice end of fuse interval\n uint256 public fuseIntervalEnd = 0;\n\n uint256[50] private __gap;\n\n event FuseIntervalUpdated(uint256 start, uint256 end);\n event AccountingFullyWithdrawnValidator(\n uint256 noOfValidators,\n uint256 remainingValidators,\n uint256 wethSentToVault\n );\n event AccountingValidatorSlashed(\n uint256 remainingValidators,\n uint256 wethSentToVault\n );\n event AccountingConsensusRewards(uint256 amount);\n\n event AccountingManuallyFixed(\n int256 validatorsDelta,\n int256 consensusRewardsDelta,\n uint256 wethToVault\n );\n\n /// @param _wethAddress Address of the Erc20 WETH Token contract\n /// @param _vaultAddress Address of the Vault\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\n /// @param _ssvNetwork Address of the SSV Network contract\n constructor(\n address _wethAddress,\n address _vaultAddress,\n address _beaconChainDepositContract,\n address _ssvNetwork\n )\n ValidatorRegistrator(\n _wethAddress,\n _vaultAddress,\n _beaconChainDepositContract,\n _ssvNetwork\n )\n {}\n\n /// @notice set fuse interval values\n function setFuseInterval(\n uint256 _fuseIntervalStart,\n uint256 _fuseIntervalEnd\n ) external onlyGovernor {\n require(\n _fuseIntervalStart < _fuseIntervalEnd &&\n _fuseIntervalStart < 32 ether &&\n _fuseIntervalEnd < 32 ether &&\n _fuseIntervalEnd - _fuseIntervalStart >= 4 ether,\n \"incorrect fuse interval\"\n );\n\n emit FuseIntervalUpdated(_fuseIntervalStart, _fuseIntervalEnd);\n\n fuseIntervalStart = _fuseIntervalStart;\n fuseIntervalEnd = _fuseIntervalEnd;\n }\n\n /* solhint-disable max-line-length */\n /// This notion page offers a good explanation of how the accounting functions\n /// https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d\n /// In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart,\n /// the accounting function will treat that ETH as Beacon chain consensus rewards.\n /// On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32,\n /// the accounting function will treat that as a validator slashing.\n /// @notice Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when\n /// accounting is valid and fuse isn't \"blown\". Returns false when fuse is blown.\n /// @dev This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it\n /// for now.\n /// @return accountingValid true if accounting was successful, false if fuse is blown\n /* solhint-enable max-line-length */\n function doAccounting()\n external\n onlyRegistrator\n whenNotPaused\n returns (bool accountingValid)\n {\n // pause the accounting on failure\n accountingValid = _doAccounting(true);\n }\n\n function _doAccounting(bool pauseOnFail)\n internal\n returns (bool accountingValid)\n {\n if (address(this).balance < consensusRewards) {\n return _failAccounting(pauseOnFail);\n }\n\n // Calculate all the new ETH that has been swept to the contract since the last accounting\n uint256 newSweptETH = address(this).balance - consensusRewards;\n accountingValid = true;\n\n // send the ETH that is from fully withdrawn validators to the Vault\n if (newSweptETH >= MAX_STAKE) {\n uint256 fullyWithdrawnValidators = newSweptETH / MAX_STAKE;\n if (activeDepositedValidators < fullyWithdrawnValidators) {\n return _failAccounting(pauseOnFail);\n }\n activeDepositedValidators -= fullyWithdrawnValidators;\n\n uint256 wethToVault = MAX_STAKE * fullyWithdrawnValidators;\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: wethToVault }();\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, wethToVault);\n\n emit AccountingFullyWithdrawnValidator(\n fullyWithdrawnValidators,\n activeDepositedValidators,\n wethToVault\n );\n }\n\n uint256 ethRemaining = address(this).balance - consensusRewards;\n // should be less than a whole validator stake\n require(ethRemaining < 32 ether, \"unexpected accounting\");\n\n // If no Beacon chain consensus rewards swept\n if (ethRemaining == 0) {\n // do nothing\n return accountingValid;\n }\n // Beacon chain consensus rewards swept (partial validator withdrawals)\n else if (ethRemaining < fuseIntervalStart) {\n // solhint-disable-next-line reentrancy\n consensusRewards += ethRemaining;\n emit AccountingConsensusRewards(ethRemaining);\n }\n // Beacon chain consensus rewards swept but also a slashed validator fully exited\n else if (ethRemaining > fuseIntervalEnd) {\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRemaining }();\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, ethRemaining);\n activeDepositedValidators -= 1;\n\n emit AccountingValidatorSlashed(\n activeDepositedValidators,\n ethRemaining\n );\n }\n // Oh no... Fuse is blown. The Strategist needs to adjust the accounting values.\n else {\n return _failAccounting(pauseOnFail);\n }\n }\n\n /// @dev pause any further accounting if required and return false\n function _failAccounting(bool pauseOnFail)\n internal\n returns (bool accountingValid)\n {\n // pause if not already\n if (pauseOnFail) {\n _pause();\n }\n // fail the accounting\n accountingValid = false;\n }\n\n /// @notice Allow the Strategist to fix the accounting of this strategy and unpause.\n /// @param _validatorsDelta adjust the active validators by plus one, minus one or unchanged with zero\n /// @param _wethToVaultAmount the amount of WETH to be sent to the Vault\n /// @param _consensusRewardsDelta adjust the accounted for consensus rewards up or down\n function manuallyFixAccounting(\n int256 _validatorsDelta,\n int256 _consensusRewardsDelta,\n uint256 _wethToVaultAmount\n ) external onlyStrategist whenPaused {\n require(\n _validatorsDelta >= -3 &&\n _validatorsDelta <= 3 &&\n // new value must be positive\n int256(activeDepositedValidators) + _validatorsDelta >= 0,\n \"invalid validatorsDelta\"\n );\n require(\n _consensusRewardsDelta >= -332 ether &&\n _consensusRewardsDelta <= 332 ether &&\n // new value must be positive\n int256(consensusRewards) + _consensusRewardsDelta >= 0,\n \"invalid consensusRewardsDelta\"\n );\n require(_wethToVaultAmount <= 32 ether, \"invalid wethToVaultAmount\");\n\n emit AccountingManuallyFixed(\n _validatorsDelta,\n _consensusRewardsDelta,\n _wethToVaultAmount\n );\n\n activeDepositedValidators = uint256(\n int256(activeDepositedValidators) + _validatorsDelta\n );\n consensusRewards = uint256(\n int256(consensusRewards) + _consensusRewardsDelta\n );\n if (_wethToVaultAmount > 0) {\n IWETH9(WETH_TOKEN_ADDRESS).transfer(\n VAULT_ADDRESS,\n _wethToVaultAmount\n );\n }\n\n // rerun the accounting to see if it has now been fixed.\n // Do not pause the accounting on failure as it is already paused\n require(_doAccounting(false), \"fuse still blown\");\n\n // unpause since doAccounting was successful\n _unpause();\n }\n}\n" + }, + "contracts/strategies/NativeStaking/ValidatorRegistrator.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Pausable } from \"@openzeppelin/contracts/security/Pausable.sol\";\nimport { Governable } from \"../../governance/Governable.sol\";\nimport { IDepositContract } from \"../../interfaces/IDepositContract.sol\";\nimport { IVault } from \"../../interfaces/IVault.sol\";\nimport { IWETH9 } from \"../../interfaces/IWETH9.sol\";\nimport { ISSVNetwork, Cluster } from \"../../interfaces/ISSVNetwork.sol\";\n\nstruct ValidatorStakeData {\n bytes pubkey;\n bytes signature;\n bytes32 depositDataRoot;\n}\n\n/**\n * @title Registrator of the validators\n * @notice This contract implements all the required functionality to register, exit and remove validators.\n * @author Origin Protocol Inc\n */\nabstract contract ValidatorRegistrator is Governable, Pausable {\n /// @notice The address of the Wrapped ETH (WETH) token contract\n address public immutable WETH_TOKEN_ADDRESS;\n /// @notice The address of the beacon chain deposit contract\n address public immutable BEACON_CHAIN_DEPOSIT_CONTRACT;\n /// @notice The address of the SSV Network contract used to interface with\n address public immutable SSV_NETWORK_ADDRESS;\n /// @notice Address of the OETH Vault proxy contract\n address public immutable VAULT_ADDRESS;\n\n /// @notice Address of the registrator - allowed to register, exit and remove validators\n address public validatorRegistrator;\n /// @notice The number of validators that have 32 (!) ETH actively deposited. When a new deposit\n /// to a validator happens this number increases, when a validator exit is detected this number\n /// decreases.\n uint256 public activeDepositedValidators;\n /// @notice State of the validators keccak256(pubKey) => state\n mapping(bytes32 => VALIDATOR_STATE) public validatorsStates;\n\n // For future use\n uint256[50] private __gap;\n\n enum VALIDATOR_STATE {\n REGISTERED, // validator is registered on the SSV network\n STAKED, // validator has funds staked\n EXITING, // exit message has been posted and validator is in the process of exiting\n EXIT_COMPLETE // validator has funds withdrawn to the EigenPod and is removed from the SSV\n }\n\n event RegistratorChanged(address newAddress);\n event ETHStaked(bytes pubkey, uint256 amount, bytes withdrawal_credentials);\n event SSVValidatorRegistered(bytes pubkey, uint64[] operatorIds);\n event SSVValidatorExitInitiated(bytes pubkey, uint64[] operatorIds);\n event SSVValidatorExitCompleted(bytes pubkey, uint64[] operatorIds);\n\n /// @dev Throws if called by any account other than the Registrator\n modifier onlyRegistrator() {\n require(\n msg.sender == validatorRegistrator,\n \"Caller is not the Registrator\"\n );\n _;\n }\n\n /// @dev Throws if called by any account other than the Strategist\n modifier onlyStrategist() {\n require(\n msg.sender == IVault(VAULT_ADDRESS).strategistAddr(),\n \"Caller is not the Strategist\"\n );\n _;\n }\n\n /// @param _wethAddress Address of the Erc20 WETH Token contract\n /// @param _vaultAddress Address of the Vault\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\n /// @param _ssvNetwork Address of the SSV Network contract\n constructor(\n address _wethAddress,\n address _vaultAddress,\n address _beaconChainDepositContract,\n address _ssvNetwork\n ) {\n WETH_TOKEN_ADDRESS = _wethAddress;\n BEACON_CHAIN_DEPOSIT_CONTRACT = _beaconChainDepositContract;\n SSV_NETWORK_ADDRESS = _ssvNetwork;\n VAULT_ADDRESS = _vaultAddress;\n }\n\n /// @notice Set the address of the registrator which can register, exit and remove validators\n function setRegistrator(address _address) external onlyGovernor {\n emit RegistratorChanged(_address);\n validatorRegistrator = _address;\n }\n\n /// @notice Stakes WETH to the node validators\n /// @param validators A list of validator data needed to stake.\n /// The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot.\n /// Only the registrator can call this function.\n function stakeEth(ValidatorStakeData[] calldata validators)\n external\n onlyRegistrator\n whenNotPaused\n {\n uint256 requiredETH = validators.length * 32 ether;\n\n // Check there is enough WETH from the deposits sitting in this strategy contract\n require(\n requiredETH <= IWETH9(WETH_TOKEN_ADDRESS).balanceOf(address(this)),\n \"insufficient WETH\"\n );\n\n // Convert required ETH from WETH\n IWETH9(WETH_TOKEN_ADDRESS).withdraw(requiredETH);\n\n // For each validator\n for (uint256 i = 0; i < validators.length; ) {\n bytes32 pubkeyHash = keccak256(validators[i].pubkey);\n VALIDATOR_STATE currentState = validatorsStates[pubkeyHash];\n\n require(\n currentState == VALIDATOR_STATE.REGISTERED,\n \"Validator not registered\"\n );\n\n /* 0x01 to indicate that withdrawal credentials will contain an EOA address that the sweeping function\n * can sweep funds to.\n * bytes11(0) to fill up the required zeros\n * remaining bytes20 are for the address\n */\n bytes memory withdrawal_credentials = abi.encodePacked(\n bytes1(0x01),\n bytes11(0),\n address(this)\n );\n IDepositContract(BEACON_CHAIN_DEPOSIT_CONTRACT).deposit{\n value: 32 ether\n }(\n validators[i].pubkey,\n withdrawal_credentials,\n validators[i].signature,\n validators[i].depositDataRoot\n );\n\n activeDepositedValidators += 1;\n emit ETHStaked(\n validators[i].pubkey,\n 32 ether,\n withdrawal_credentials\n );\n\n validatorsStates[pubkeyHash] = VALIDATOR_STATE.STAKED;\n\n unchecked {\n ++i;\n }\n }\n }\n\n /// @notice Registers a new validator in the SSV Cluster.\n /// Only the registrator can call this function.\n function registerSsvValidator(\n bytes calldata publicKey,\n uint64[] calldata operatorIds,\n bytes calldata sharesData,\n uint256 amount,\n Cluster calldata cluster\n ) external onlyRegistrator whenNotPaused {\n ISSVNetwork(SSV_NETWORK_ADDRESS).registerValidator(\n publicKey,\n operatorIds,\n sharesData,\n amount,\n cluster\n );\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.REGISTERED;\n emit SSVValidatorRegistered(publicKey, operatorIds);\n }\n\n /// @notice Exit a validator from the Beacon chain.\n /// The staked ETH will eventually swept to this native staking strategy.\n /// Only the registrator can call this function.\n function exitSsvValidator(\n bytes calldata publicKey,\n uint64[] calldata operatorIds\n ) external onlyRegistrator whenNotPaused {\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\n require(currentState == VALIDATOR_STATE.STAKED, \"Validator not staked\");\n\n ISSVNetwork(SSV_NETWORK_ADDRESS).exitValidator(publicKey, operatorIds);\n emit SSVValidatorExitInitiated(publicKey, operatorIds);\n\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXITING;\n }\n\n /// @notice Remove a validator from the SSV Cluster.\n /// Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain.\n /// If removed before the validator has exited the beacon chain will result in the validator being slashed.\n /// Only the registrator can call this function.\n function removeSsvValidator(\n bytes calldata publicKey,\n uint64[] calldata operatorIds,\n Cluster calldata cluster\n ) external onlyRegistrator whenNotPaused {\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\n require(\n currentState == VALIDATOR_STATE.EXITING,\n \"Validator not exiting\"\n );\n\n ISSVNetwork(SSV_NETWORK_ADDRESS).removeValidator(\n publicKey,\n operatorIds,\n cluster\n );\n emit SSVValidatorExitCompleted(publicKey, operatorIds);\n\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXIT_COMPLETE;\n }\n\n /// @notice Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\n /// @dev A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds.\n /// uses \"onlyStrategist\" modifier so continuous front-running can't DOS our maintenance service\n /// that tries to top up SSV tokens.\n /// @param cluster The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\n function depositSSV(\n uint64[] memory operatorIds,\n uint256 amount,\n Cluster memory cluster\n ) external onlyStrategist {\n ISSVNetwork(SSV_NETWORK_ADDRESS).deposit(\n address(this),\n operatorIds,\n amount,\n cluster\n );\n }\n}\n" + }, + "contracts/strategies/ThreePoolStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Curve 3Pool Strategy\n * @notice Investment strategy for investing stablecoins via Curve 3Pool\n * @author Origin Protocol Inc\n */\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { ICurveGauge } from \"./ICurveGauge.sol\";\nimport { ICurvePool } from \"./ICurvePool.sol\";\nimport { ICRVMinter } from \"./ICRVMinter.sol\";\nimport { IERC20, BaseCurveStrategy, InitializableAbstractStrategy } from \"./BaseCurveStrategy.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Helpers } from \"../utils/Helpers.sol\";\n\n/*\n * IMPORTANT(!) If ThreePoolStrategy needs to be re-deployed, it requires new\n * proxy contract with fresh storage slots. Changes in `BaseCurveStrategy`\n * storage slots would break existing implementation.\n *\n * Remove this notice if ThreePoolStrategy is re-deployed\n */\ncontract ThreePoolStrategy is BaseCurveStrategy {\n using StableMath for uint256;\n using SafeERC20 for IERC20;\n\n address internal crvGaugeAddress;\n address internal crvMinterAddress;\n\n constructor(BaseStrategyConfig memory _stratConfig)\n InitializableAbstractStrategy(_stratConfig)\n {}\n\n /**\n * Initializer for setting up strategy internal state. This overrides the\n * InitializableAbstractStrategy initializer as Curve strategies don't fit\n * well within that abstraction.\n * @param _rewardTokenAddress Address of CRV\n * @param _assets Addresses of supported assets. MUST be passed in the same\n * order as returned by coins on the pool contract, i.e.\n * DAI, USDC, USDT\n * @param _pTokens Platform Token corresponding addresses\n * @param _crvGaugeAddress Address of the Curve DAO gauge for this pool\n * @param _crvMinterAddress Address of the CRV minter for rewards\n */\n function initialize(\n address[] calldata _rewardTokenAddress, // CRV\n address[] calldata _assets,\n address[] calldata _pTokens,\n address _crvGaugeAddress,\n address _crvMinterAddress\n ) external onlyGovernor initializer {\n require(_assets.length == 3, \"Must have exactly three assets\");\n // Should be set prior to abstract initialize call otherwise\n // abstractSetPToken calls will fail\n crvGaugeAddress = _crvGaugeAddress;\n crvMinterAddress = _crvMinterAddress;\n pTokenAddress = _pTokens[0];\n InitializableAbstractStrategy._initialize(\n _rewardTokenAddress,\n _assets,\n _pTokens\n );\n _approveBase();\n }\n\n function _lpDepositAll() internal override {\n IERC20 pToken = IERC20(pTokenAddress);\n // Deposit into Gauge\n ICurveGauge(crvGaugeAddress).deposit(\n pToken.balanceOf(address(this)),\n address(this)\n );\n }\n\n function _lpWithdraw(uint256 numPTokens) internal override {\n // Not enough of pool token exists on this contract, some must be\n // staked in Gauge, unstake difference\n ICurveGauge(crvGaugeAddress).withdraw(numPTokens);\n }\n\n function _lpWithdrawAll() internal override {\n ICurveGauge gauge = ICurveGauge(crvGaugeAddress);\n gauge.withdraw(gauge.balanceOf(address(this)));\n }\n\n /**\n * @dev Get the total asset value held in the platform\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n public\n view\n override\n returns (uint256 balance)\n {\n require(assetToPToken[_asset] != address(0), \"Unsupported asset\");\n // LP tokens in this contract. This should generally be nothing as we\n // should always stake the full balance in the Gauge, but include for\n // safety\n\n uint256 contractPTokens = IERC20(pTokenAddress).balanceOf(\n address(this)\n );\n ICurveGauge gauge = ICurveGauge(crvGaugeAddress);\n uint256 gaugePTokens = gauge.balanceOf(address(this));\n uint256 totalPTokens = contractPTokens + gaugePTokens;\n\n ICurvePool curvePool = ICurvePool(platformAddress);\n if (totalPTokens > 0) {\n uint256 virtual_price = curvePool.get_virtual_price();\n uint256 value = (totalPTokens * virtual_price) / 1e18;\n uint256 assetDecimals = Helpers.getDecimals(_asset);\n balance = value.scaleBy(assetDecimals, 18) / 3;\n }\n }\n\n function _approveBase() internal override {\n IERC20 pToken = IERC20(pTokenAddress);\n // 3Pool for LP token (required for removing liquidity)\n pToken.safeApprove(platformAddress, 0);\n pToken.safeApprove(platformAddress, type(uint256).max);\n // Gauge for LP token\n pToken.safeApprove(crvGaugeAddress, 0);\n pToken.safeApprove(crvGaugeAddress, type(uint256).max);\n }\n\n /**\n * @dev Collect accumulated CRV and send to Vault.\n */\n function collectRewardTokens() public override onlyHarvester nonReentrant {\n // Collect\n ICRVMinter(crvMinterAddress).mint(crvGaugeAddress);\n // Send\n IERC20 crvToken = IERC20(rewardTokenAddresses[0]);\n uint256 balance = crvToken.balanceOf(address(this));\n emit RewardTokenCollected(\n harvesterAddress,\n rewardTokenAddresses[0],\n balance\n );\n crvToken.safeTransfer(harvesterAddress, balance);\n }\n}\n" + }, + "contracts/strategies/VaultValueChecker.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IOUSD } from \"../interfaces/IOUSD.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\n\ncontract VaultValueChecker {\n IVault public immutable vault;\n IOUSD public immutable ousd;\n // Snapshot expiration time in seconds.\n // Used to prevent accidental use of an old snapshot, but\n // is not zero to allow easy testing of strategist actions in fork testing\n uint256 constant SNAPSHOT_EXPIRES = 5 * 60;\n\n struct Snapshot {\n uint256 vaultValue;\n uint256 totalSupply;\n uint256 time;\n }\n // By doing per user snapshots, we prevent a reentrancy attack\n // from a third party that updates the snapshot in the middle\n // of an allocation process\n\n mapping(address => Snapshot) public snapshots;\n\n constructor(address _vault, address _ousd) {\n vault = IVault(_vault);\n ousd = IOUSD(_ousd);\n }\n\n function takeSnapshot() external {\n snapshots[msg.sender] = Snapshot({\n vaultValue: vault.totalValue(),\n totalSupply: ousd.totalSupply(),\n time: block.timestamp\n });\n }\n\n function checkDelta(\n int256 expectedProfit,\n int256 profitVariance,\n int256 expectedVaultChange,\n int256 vaultChangeVariance\n ) external {\n // Intentionaly not view so that this method shows up in TX builders\n Snapshot memory snapshot = snapshots[msg.sender];\n int256 vaultChange = toInt256(vault.totalValue()) -\n toInt256(snapshot.vaultValue);\n int256 supplyChange = toInt256(ousd.totalSupply()) -\n toInt256(snapshot.totalSupply);\n int256 profit = vaultChange - supplyChange;\n\n require(\n snapshot.time >= block.timestamp - SNAPSHOT_EXPIRES,\n \"Snapshot too old\"\n );\n require(snapshot.time <= block.timestamp, \"Snapshot too new\");\n require(profit >= expectedProfit - profitVariance, \"Profit too low\");\n require(profit <= expectedProfit + profitVariance, \"Profit too high\");\n require(\n vaultChange >= expectedVaultChange - vaultChangeVariance,\n \"Vault value change too low\"\n );\n require(\n vaultChange <= expectedVaultChange + vaultChangeVariance,\n \"Vault value change too high\"\n );\n }\n\n function toInt256(uint256 value) internal pure returns (int256) {\n // From openzeppelin math/SafeCast.sol\n // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\n require(\n value <= uint256(type(int256).max),\n \"SafeCast: value doesn't fit in an int256\"\n );\n return int256(value);\n }\n}\n\ncontract OETHVaultValueChecker is VaultValueChecker {\n constructor(address _vault, address _ousd)\n VaultValueChecker(_vault, _ousd)\n {}\n}\n" + }, + "contracts/swapper/Swapper1InchV5.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @notice 1Inch Pathfinder V5 implementation of the general ISwapper interface.\n * @author Origin Protocol Inc\n * @dev It is possible that dust token amounts are left in this contract after a swap.\n * This can happen with some tokens that don't send the full transfer amount.\n * These dust amounts can build up over time and be used by anyone who calls the `swap` function.\n */\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { IAggregationExecutor, IOneInchRouter, SwapDescription } from \"../interfaces/IOneInch.sol\";\nimport { ISwapper } from \"../interfaces/ISwapper.sol\";\n\ncontract Swapper1InchV5 is ISwapper {\n using SafeERC20 for IERC20;\n\n /// @notice 1Inch router contract to give allowance to perform swaps\n address public constant SWAP_ROUTER =\n 0x1111111254EEB25477B68fb85Ed929f73A960582;\n\n // swap(address,(address,address,address,address,uint256,uint256,uint256),bytes,bytes)\n bytes4 internal constant SWAP_SELECTOR = 0x12aa3caf;\n // unoswapTo(address,address,uint256,uint256,uint256[])\n bytes4 internal constant UNISWAP_SELECTOR = 0xf78dc253;\n // uniswapV3SwapTo(address,uint256,uint256,uint256[])\n bytes4 internal constant UNISWAPV3_SELECTOR = 0xbc80f1a8;\n\n /**\n * @notice Strategist swaps assets sitting in the contract of the `assetHolder`.\n * @param _fromAsset The token address of the asset being sold by the vault.\n * @param _toAsset The token address of the asset being purchased by the vault.\n * @param _fromAssetAmount The amount of assets being sold by the vault.\n * @param _minToAssetAmount The minimum amount of assets to be purchased.\n * @param _data RLP encoded executer address and bytes data. This is re-encoded tx.data from 1Inch swap API\n */\n function swap(\n address _fromAsset,\n address _toAsset,\n uint256 _fromAssetAmount,\n uint256 _minToAssetAmount,\n bytes calldata _data\n ) external override returns (uint256 toAssetAmount) {\n // Decode the function selector from the RLP encoded _data param\n bytes4 swapSelector = bytes4(_data[:4]);\n\n if (swapSelector == SWAP_SELECTOR) {\n // Decode the executer address and data from the RLP encoded _data param\n (, address executer, bytes memory executerData) = abi.decode(\n _data,\n (bytes4, address, bytes)\n );\n SwapDescription memory swapDesc = SwapDescription({\n srcToken: IERC20(_fromAsset),\n dstToken: IERC20(_toAsset),\n srcReceiver: payable(executer),\n dstReceiver: payable(msg.sender),\n amount: _fromAssetAmount,\n minReturnAmount: _minToAssetAmount,\n flags: 4 // 1st bit _PARTIAL_FILL, 2nd bit _REQUIRES_EXTRA_ETH, 3rd bit _SHOULD_CLAIM\n });\n (toAssetAmount, ) = IOneInchRouter(SWAP_ROUTER).swap(\n IAggregationExecutor(executer),\n swapDesc,\n hex\"\",\n executerData\n );\n } else if (swapSelector == UNISWAP_SELECTOR) {\n // Need to get the Uniswap pools data from the _data param\n (, uint256[] memory pools) = abi.decode(_data, (bytes4, uint256[]));\n toAssetAmount = IOneInchRouter(SWAP_ROUTER).unoswapTo(\n payable(msg.sender),\n IERC20(_fromAsset),\n _fromAssetAmount,\n _minToAssetAmount,\n pools\n );\n } else if (swapSelector == UNISWAPV3_SELECTOR) {\n // Need to get the Uniswap pools data from the _data param\n // slither-disable-next-line uninitialized-storage\n (, uint256[] memory pools) = abi.decode(_data, (bytes4, uint256[]));\n toAssetAmount = IOneInchRouter(SWAP_ROUTER).uniswapV3SwapTo(\n payable(msg.sender),\n _fromAssetAmount,\n _minToAssetAmount,\n pools\n );\n } else {\n revert(\"Unsupported swap function\");\n }\n }\n\n /**\n * @notice Approve assets for swapping.\n * @param _assets Array of token addresses to approve.\n * @dev unlimited approval is used as no tokens sit in this contract outside a transaction.\n */\n function approveAssets(address[] memory _assets) external {\n for (uint256 i = 0; i < _assets.length; ++i) {\n // Give the 1Inch router approval to transfer unlimited assets\n IERC20(_assets[i]).safeApprove(SWAP_ROUTER, type(uint256).max);\n }\n }\n}\n" + }, + "contracts/timelock/Timelock.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD Timelock Contract\n * @author Origin Protocol Inc\n */\nimport \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\n\ninterface CapitalPausable {\n function pauseCapital() external;\n\n function unpauseCapital() external;\n}\n\ncontract Timelock {\n using SafeMath for uint256;\n\n event NewAdmin(address indexed newAdmin);\n event NewPendingAdmin(address indexed newPendingAdmin);\n event NewDelay(uint256 indexed newDelay);\n event CancelTransaction(\n bytes32 indexed txHash,\n address indexed target,\n string signature,\n bytes data,\n uint256 eta\n );\n event ExecuteTransaction(\n bytes32 indexed txHash,\n address indexed target,\n string signature,\n bytes data,\n uint256 eta\n );\n event QueueTransaction(\n bytes32 indexed txHash,\n address indexed target,\n string signature,\n bytes data,\n uint256 eta\n );\n\n uint256 public constant GRACE_PERIOD = 3 days;\n uint256 public constant MINIMUM_DELAY = 1 minutes;\n uint256 public constant MAXIMUM_DELAY = 2 days;\n\n address public admin;\n address public pendingAdmin;\n uint256 public delay;\n\n mapping(bytes32 => bool) public queuedTransactions;\n\n /**\n * @dev Throws if called by any account other than the Admin.\n */\n modifier onlyAdmin() {\n require(msg.sender == admin, \"Caller is not the admin\");\n _;\n }\n\n constructor(address admin_, uint256 delay_) {\n require(\n delay_ >= MINIMUM_DELAY,\n \"Timelock::constructor: Delay must exceed minimum delay.\"\n );\n require(\n delay_ <= MAXIMUM_DELAY,\n \"Timelock::setDelay: Delay must not exceed maximum delay.\"\n );\n\n admin = admin_;\n delay = delay_;\n }\n\n function setDelay(uint256 delay_) public {\n require(\n msg.sender == address(this),\n \"Timelock::setDelay: Call must come from Timelock.\"\n );\n require(\n delay_ >= MINIMUM_DELAY,\n \"Timelock::setDelay: Delay must exceed minimum delay.\"\n );\n require(\n delay_ <= MAXIMUM_DELAY,\n \"Timelock::setDelay: Delay must not exceed maximum delay.\"\n );\n delay = delay_;\n\n emit NewDelay(delay);\n }\n\n function acceptAdmin() public {\n require(\n msg.sender == pendingAdmin,\n \"Timelock::acceptAdmin: Call must come from pendingAdmin.\"\n );\n admin = msg.sender;\n pendingAdmin = address(0);\n\n emit NewAdmin(admin);\n }\n\n function setPendingAdmin(address pendingAdmin_) public onlyAdmin {\n pendingAdmin = pendingAdmin_;\n\n emit NewPendingAdmin(pendingAdmin);\n }\n\n function queueTransaction(\n address target,\n string memory signature,\n bytes memory data,\n uint256 eta\n ) internal returns (bytes32) {\n require(\n msg.sender == admin,\n \"Timelock::queueTransaction: Call must come from admin.\"\n );\n require(\n eta >= getBlockTimestamp().add(delay),\n \"Timelock::queueTransaction: Estimated execution block must satisfy delay.\"\n );\n\n bytes32 txHash = keccak256(\n abi.encode(target, signature, keccak256(data), eta)\n );\n queuedTransactions[txHash] = true;\n\n emit QueueTransaction(txHash, target, signature, data, eta);\n return txHash;\n }\n\n function cancelTransaction(\n address target,\n string memory signature,\n bytes memory data,\n uint256 eta\n ) internal {\n require(\n msg.sender == admin,\n \"Timelock::cancelTransaction: Call must come from admin.\"\n );\n\n bytes32 txHash = keccak256(\n abi.encode(target, signature, keccak256(data), eta)\n );\n queuedTransactions[txHash] = false;\n\n emit CancelTransaction(txHash, target, signature, data, eta);\n }\n\n function _getRevertMsg(bytes memory _returnData)\n internal\n pure\n returns (string memory)\n {\n // If the _res length is less than 68, then the transaction failed\n // silently (without a revert message)\n if (_returnData.length < 68) return \"Transaction reverted silently\";\n\n // solhint-disable-next-line no-inline-assembly\n assembly {\n // Slice the sighash.\n _returnData := add(_returnData, 0x04)\n }\n return abi.decode(_returnData, (string));\n }\n\n function executeTransaction(\n address target,\n string memory signature,\n bytes memory data,\n uint256 eta\n ) internal returns (bytes memory) {\n require(\n msg.sender == admin,\n \"Timelock::executeTransaction: Call must come from admin.\"\n );\n\n bytes32 txHash = keccak256(\n abi.encode(target, signature, keccak256(data), eta)\n );\n require(\n queuedTransactions[txHash],\n \"Timelock::executeTransaction: Transaction hasn't been queued.\"\n );\n require(\n getBlockTimestamp() >= eta,\n \"Timelock::executeTransaction: Transaction hasn't surpassed time lock.\"\n );\n require(\n getBlockTimestamp() <= eta.add(GRACE_PERIOD),\n \"Timelock::executeTransaction: Transaction is stale.\"\n );\n\n queuedTransactions[txHash] = false;\n\n bytes memory callData;\n\n if (bytes(signature).length == 0) {\n callData = data;\n } else {\n callData = abi.encodePacked(\n bytes4(keccak256(bytes(signature))),\n data\n );\n }\n\n (bool success, bytes memory returnData) = target.call(callData);\n\n if (!success) {\n revert(_getRevertMsg(returnData));\n }\n\n emit ExecuteTransaction(txHash, target, signature, data, eta);\n\n return returnData;\n }\n\n function getBlockTimestamp() internal view returns (uint256) {\n // solium-disable-next-line security/no-block-members\n return block.timestamp;\n }\n\n function pauseCapital(address target) external {\n require(\n msg.sender == admin,\n \"Timelock::pauseCapital: Call must come from admin.\"\n );\n CapitalPausable(target).pauseCapital();\n }\n\n function unpauseCapital(address target) external {\n require(\n msg.sender == admin,\n \"Timelock::unpauseCapital: Call must come from admin.\"\n );\n CapitalPausable(target).unpauseCapital();\n }\n}\n" + }, + "contracts/token/BridgedWOETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { AccessControlEnumerable } from \"@openzeppelin/contracts/access/AccessControlEnumerable.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\nimport { Initializable } from \"../utils/Initializable.sol\";\n\ncontract BridgedWOETH is\n Governable,\n AccessControlEnumerable,\n Initializable,\n ERC20\n{\n bytes32 public constant MINTER_ROLE = keccak256(\"MINTER_ROLE\");\n bytes32 public constant BURNER_ROLE = keccak256(\"BURNER_ROLE\");\n\n constructor() ERC20(\"Wrapped OETH\", \"WOETH\") {\n // Nobody owns the implementation\n _setGovernor(address(0));\n }\n\n /**\n * @dev Initialize the proxy and set the Governor\n */\n function initialize() external initializer {\n // Governor can grant Minter/Burner roles\n _setupRole(DEFAULT_ADMIN_ROLE, _governor());\n }\n\n /**\n * @dev Mint tokens for `account`\n * @param account Address to mint tokens for\n * @param amount Amount of tokens to mint\n */\n function mint(address account, uint256 amount)\n external\n onlyRole(MINTER_ROLE)\n nonReentrant\n {\n _mint(account, amount);\n }\n\n /**\n * @dev Burns tokens from `account`\n * @param account Address to burn tokens from\n * @param amount Amount of tokens to burn\n */\n function burn(address account, uint256 amount)\n external\n onlyRole(BURNER_ROLE)\n nonReentrant\n {\n _burn(account, amount);\n }\n\n /**\n * @dev Burns tokens from `msg.sender`\n * @param amount Amount of tokens to burn\n */\n function burn(uint256 amount) external onlyRole(BURNER_ROLE) nonReentrant {\n _burn(msg.sender, amount);\n }\n\n /**\n * @dev Returns the name of the token.\n */\n function name() public view virtual override returns (string memory) {\n return \"Wrapped OETH\";\n }\n\n /**\n * @dev Returns the symbol of the token, usually a shorter version of the\n * name.\n */\n function symbol() public view virtual override returns (string memory) {\n return \"WOETH\";\n }\n\n /**\n * @dev Returns the decimals of the token\n */\n function decimals() public view virtual override returns (uint8) {\n return 18;\n }\n}\n" + }, + "contracts/token/OETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { OUSD } from \"./OUSD.sol\";\n\n/**\n * @title OETH Token Contract\n * @author Origin Protocol Inc\n */\ncontract OETH is OUSD {\n\n}\n" + }, + "contracts/token/OUSD.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD Token Contract\n * @dev ERC20 compatible contract for OUSD\n * @dev Implements an elastic supply\n * @author Origin Protocol Inc\n */\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\nimport { Address } from \"@openzeppelin/contracts/utils/Address.sol\";\n\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { InitializableERC20Detailed } from \"../utils/InitializableERC20Detailed.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\n\n/**\n * NOTE that this is an ERC20 token but the invariant that the sum of\n * balanceOf(x) for all x is not >= totalSupply(). This is a consequence of the\n * rebasing design. Any integrations with OUSD should be aware.\n */\n\ncontract OUSD is Initializable, InitializableERC20Detailed, Governable {\n using SafeMath for uint256;\n using StableMath for uint256;\n\n event TotalSupplyUpdatedHighres(\n uint256 totalSupply,\n uint256 rebasingCredits,\n uint256 rebasingCreditsPerToken\n );\n event AccountRebasingEnabled(address account);\n event AccountRebasingDisabled(address account);\n\n enum RebaseOptions {\n NotSet,\n OptOut,\n OptIn\n }\n\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\n uint256 public _totalSupply;\n mapping(address => mapping(address => uint256)) private _allowances;\n address public vaultAddress = address(0);\n mapping(address => uint256) private _creditBalances;\n uint256 private _rebasingCredits;\n uint256 private _rebasingCreditsPerToken;\n // Frozen address/credits are non rebasing (value is held in contracts which\n // do not receive yield unless they explicitly opt in)\n uint256 public nonRebasingSupply;\n mapping(address => uint256) public nonRebasingCreditsPerToken;\n mapping(address => RebaseOptions) public rebaseState;\n mapping(address => uint256) public isUpgraded;\n\n uint256 private constant RESOLUTION_INCREASE = 1e9;\n\n function initialize(\n string calldata _nameArg,\n string calldata _symbolArg,\n address _vaultAddress,\n uint256 _initialCreditsPerToken\n ) external onlyGovernor initializer {\n InitializableERC20Detailed._initialize(_nameArg, _symbolArg, 18);\n _rebasingCreditsPerToken = _initialCreditsPerToken;\n vaultAddress = _vaultAddress;\n }\n\n /**\n * @dev Verifies that the caller is the Vault contract\n */\n modifier onlyVault() {\n require(vaultAddress == msg.sender, \"Caller is not the Vault\");\n _;\n }\n\n /**\n * @return The total supply of OUSD.\n */\n function totalSupply() public view override returns (uint256) {\n return _totalSupply;\n }\n\n /**\n * @return Low resolution rebasingCreditsPerToken\n */\n function rebasingCreditsPerToken() public view returns (uint256) {\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\n }\n\n /**\n * @return Low resolution total number of rebasing credits\n */\n function rebasingCredits() public view returns (uint256) {\n return _rebasingCredits / RESOLUTION_INCREASE;\n }\n\n /**\n * @return High resolution rebasingCreditsPerToken\n */\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\n return _rebasingCreditsPerToken;\n }\n\n /**\n * @return High resolution total number of rebasing credits\n */\n function rebasingCreditsHighres() public view returns (uint256) {\n return _rebasingCredits;\n }\n\n /**\n * @dev Gets the balance of the specified address.\n * @param _account Address to query the balance of.\n * @return A uint256 representing the amount of base units owned by the\n * specified address.\n */\n function balanceOf(address _account)\n public\n view\n override\n returns (uint256)\n {\n if (_creditBalances[_account] == 0) return 0;\n return\n _creditBalances[_account].divPrecisely(_creditsPerToken(_account));\n }\n\n /**\n * @dev Gets the credits balance of the specified address.\n * @dev Backwards compatible with old low res credits per token.\n * @param _account The address to query the balance of.\n * @return (uint256, uint256) Credit balance and credits per token of the\n * address\n */\n function creditsBalanceOf(address _account)\n public\n view\n returns (uint256, uint256)\n {\n uint256 cpt = _creditsPerToken(_account);\n if (cpt == 1e27) {\n // For a period before the resolution upgrade, we created all new\n // contract accounts at high resolution. Since they are not changing\n // as a result of this upgrade, we will return their true values\n return (_creditBalances[_account], cpt);\n } else {\n return (\n _creditBalances[_account] / RESOLUTION_INCREASE,\n cpt / RESOLUTION_INCREASE\n );\n }\n }\n\n /**\n * @dev Gets the credits balance of the specified address.\n * @param _account The address to query the balance of.\n * @return (uint256, uint256, bool) Credit balance, credits per token of the\n * address, and isUpgraded\n */\n function creditsBalanceOfHighres(address _account)\n public\n view\n returns (\n uint256,\n uint256,\n bool\n )\n {\n return (\n _creditBalances[_account],\n _creditsPerToken(_account),\n isUpgraded[_account] == 1\n );\n }\n\n /**\n * @dev Transfer tokens to a specified address.\n * @param _to the address to transfer to.\n * @param _value the amount to be transferred.\n * @return true on success.\n */\n function transfer(address _to, uint256 _value)\n public\n override\n returns (bool)\n {\n require(_to != address(0), \"Transfer to zero address\");\n require(\n _value <= balanceOf(msg.sender),\n \"Transfer greater than balance\"\n );\n\n _executeTransfer(msg.sender, _to, _value);\n\n emit Transfer(msg.sender, _to, _value);\n\n return true;\n }\n\n /**\n * @dev Transfer tokens from one address to another.\n * @param _from The address you want to send tokens from.\n * @param _to The address you want to transfer to.\n * @param _value The amount of tokens to be transferred.\n */\n function transferFrom(\n address _from,\n address _to,\n uint256 _value\n ) public override returns (bool) {\n require(_to != address(0), \"Transfer to zero address\");\n require(_value <= balanceOf(_from), \"Transfer greater than balance\");\n\n _allowances[_from][msg.sender] = _allowances[_from][msg.sender].sub(\n _value\n );\n\n _executeTransfer(_from, _to, _value);\n\n emit Transfer(_from, _to, _value);\n\n return true;\n }\n\n /**\n * @dev Update the count of non rebasing credits in response to a transfer\n * @param _from The address you want to send tokens from.\n * @param _to The address you want to transfer to.\n * @param _value Amount of OUSD to transfer\n */\n function _executeTransfer(\n address _from,\n address _to,\n uint256 _value\n ) internal {\n bool isNonRebasingTo = _isNonRebasingAccount(_to);\n bool isNonRebasingFrom = _isNonRebasingAccount(_from);\n\n // Credits deducted and credited might be different due to the\n // differing creditsPerToken used by each account\n uint256 creditsCredited = _value.mulTruncate(_creditsPerToken(_to));\n uint256 creditsDeducted = _value.mulTruncate(_creditsPerToken(_from));\n\n _creditBalances[_from] = _creditBalances[_from].sub(\n creditsDeducted,\n \"Transfer amount exceeds balance\"\n );\n _creditBalances[_to] = _creditBalances[_to].add(creditsCredited);\n\n if (isNonRebasingTo && !isNonRebasingFrom) {\n // Transfer to non-rebasing account from rebasing account, credits\n // are removed from the non rebasing tally\n nonRebasingSupply = nonRebasingSupply.add(_value);\n // Update rebasingCredits by subtracting the deducted amount\n _rebasingCredits = _rebasingCredits.sub(creditsDeducted);\n } else if (!isNonRebasingTo && isNonRebasingFrom) {\n // Transfer to rebasing account from non-rebasing account\n // Decreasing non-rebasing credits by the amount that was sent\n nonRebasingSupply = nonRebasingSupply.sub(_value);\n // Update rebasingCredits by adding the credited amount\n _rebasingCredits = _rebasingCredits.add(creditsCredited);\n }\n }\n\n /**\n * @dev Function to check the amount of tokens that _owner has allowed to\n * `_spender`.\n * @param _owner The address which owns the funds.\n * @param _spender The address which will spend the funds.\n * @return The number of tokens still available for the _spender.\n */\n function allowance(address _owner, address _spender)\n public\n view\n override\n returns (uint256)\n {\n return _allowances[_owner][_spender];\n }\n\n /**\n * @dev Approve the passed address to spend the specified amount of tokens\n * on behalf of msg.sender. This method is included for ERC20\n * compatibility. `increaseAllowance` and `decreaseAllowance` should be\n * used instead.\n *\n * Changing an allowance with this method brings the risk that someone\n * may transfer both the old and the new allowance - if they are both\n * greater than zero - if a transfer transaction is mined before the\n * later approve() call is mined.\n * @param _spender The address which will spend the funds.\n * @param _value The amount of tokens to be spent.\n */\n function approve(address _spender, uint256 _value)\n public\n override\n returns (bool)\n {\n _allowances[msg.sender][_spender] = _value;\n emit Approval(msg.sender, _spender, _value);\n return true;\n }\n\n /**\n * @dev Increase the amount of tokens that an owner has allowed to\n * `_spender`.\n * This method should be used instead of approve() to avoid the double\n * approval vulnerability described above.\n * @param _spender The address which will spend the funds.\n * @param _addedValue The amount of tokens to increase the allowance by.\n */\n function increaseAllowance(address _spender, uint256 _addedValue)\n public\n returns (bool)\n {\n _allowances[msg.sender][_spender] = _allowances[msg.sender][_spender]\n .add(_addedValue);\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\n return true;\n }\n\n /**\n * @dev Decrease the amount of tokens that an owner has allowed to\n `_spender`.\n * @param _spender The address which will spend the funds.\n * @param _subtractedValue The amount of tokens to decrease the allowance\n * by.\n */\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\n public\n returns (bool)\n {\n uint256 oldValue = _allowances[msg.sender][_spender];\n if (_subtractedValue >= oldValue) {\n _allowances[msg.sender][_spender] = 0;\n } else {\n _allowances[msg.sender][_spender] = oldValue.sub(_subtractedValue);\n }\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\n return true;\n }\n\n /**\n * @dev Mints new tokens, increasing totalSupply.\n */\n function mint(address _account, uint256 _amount) external onlyVault {\n _mint(_account, _amount);\n }\n\n /**\n * @dev Creates `_amount` tokens and assigns them to `_account`, increasing\n * the total supply.\n *\n * Emits a {Transfer} event with `from` set to the zero address.\n *\n * Requirements\n *\n * - `to` cannot be the zero address.\n */\n function _mint(address _account, uint256 _amount) internal nonReentrant {\n require(_account != address(0), \"Mint to the zero address\");\n\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\n\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\n _creditBalances[_account] = _creditBalances[_account].add(creditAmount);\n\n // If the account is non rebasing and doesn't have a set creditsPerToken\n // then set it i.e. this is a mint from a fresh contract\n if (isNonRebasingAccount) {\n nonRebasingSupply = nonRebasingSupply.add(_amount);\n } else {\n _rebasingCredits = _rebasingCredits.add(creditAmount);\n }\n\n _totalSupply = _totalSupply.add(_amount);\n\n require(_totalSupply < MAX_SUPPLY, \"Max supply\");\n\n emit Transfer(address(0), _account, _amount);\n }\n\n /**\n * @dev Burns tokens, decreasing totalSupply.\n */\n function burn(address account, uint256 amount) external onlyVault {\n _burn(account, amount);\n }\n\n /**\n * @dev Destroys `_amount` tokens from `_account`, reducing the\n * total supply.\n *\n * Emits a {Transfer} event with `to` set to the zero address.\n *\n * Requirements\n *\n * - `_account` cannot be the zero address.\n * - `_account` must have at least `_amount` tokens.\n */\n function _burn(address _account, uint256 _amount) internal nonReentrant {\n require(_account != address(0), \"Burn from the zero address\");\n if (_amount == 0) {\n return;\n }\n\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\n uint256 currentCredits = _creditBalances[_account];\n\n // Remove the credits, burning rounding errors\n if (\n currentCredits == creditAmount || currentCredits - 1 == creditAmount\n ) {\n // Handle dust from rounding\n _creditBalances[_account] = 0;\n } else if (currentCredits > creditAmount) {\n _creditBalances[_account] = _creditBalances[_account].sub(\n creditAmount\n );\n } else {\n revert(\"Remove exceeds balance\");\n }\n\n // Remove from the credit tallies and non-rebasing supply\n if (isNonRebasingAccount) {\n nonRebasingSupply = nonRebasingSupply.sub(_amount);\n } else {\n _rebasingCredits = _rebasingCredits.sub(creditAmount);\n }\n\n _totalSupply = _totalSupply.sub(_amount);\n\n emit Transfer(_account, address(0), _amount);\n }\n\n /**\n * @dev Get the credits per token for an account. Returns a fixed amount\n * if the account is non-rebasing.\n * @param _account Address of the account.\n */\n function _creditsPerToken(address _account)\n internal\n view\n returns (uint256)\n {\n if (nonRebasingCreditsPerToken[_account] != 0) {\n return nonRebasingCreditsPerToken[_account];\n } else {\n return _rebasingCreditsPerToken;\n }\n }\n\n /**\n * @dev Is an account using rebasing accounting or non-rebasing accounting?\n * Also, ensure contracts are non-rebasing if they have not opted in.\n * @param _account Address of the account.\n */\n function _isNonRebasingAccount(address _account) internal returns (bool) {\n bool isContract = Address.isContract(_account);\n if (isContract && rebaseState[_account] == RebaseOptions.NotSet) {\n _ensureRebasingMigration(_account);\n }\n return nonRebasingCreditsPerToken[_account] > 0;\n }\n\n /**\n * @dev Ensures internal account for rebasing and non-rebasing credits and\n * supply is updated following deployment of frozen yield change.\n */\n function _ensureRebasingMigration(address _account) internal {\n if (nonRebasingCreditsPerToken[_account] == 0) {\n emit AccountRebasingDisabled(_account);\n if (_creditBalances[_account] == 0) {\n // Since there is no existing balance, we can directly set to\n // high resolution, and do not have to do any other bookkeeping\n nonRebasingCreditsPerToken[_account] = 1e27;\n } else {\n // Migrate an existing account:\n\n // Set fixed credits per token for this account\n nonRebasingCreditsPerToken[_account] = _rebasingCreditsPerToken;\n // Update non rebasing supply\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(_account));\n // Update credit tallies\n _rebasingCredits = _rebasingCredits.sub(\n _creditBalances[_account]\n );\n }\n }\n }\n\n /**\n * @notice Enable rebasing for an account.\n * @dev Add a contract address to the non-rebasing exception list. The\n * address's balance will be part of rebases and the account will be exposed\n * to upside and downside.\n * @param _account Address of the account.\n */\n function governanceRebaseOptIn(address _account)\n public\n nonReentrant\n onlyGovernor\n {\n _rebaseOptIn(_account);\n }\n\n /**\n * @dev Add a contract address to the non-rebasing exception list. The\n * address's balance will be part of rebases and the account will be exposed\n * to upside and downside.\n */\n function rebaseOptIn() public nonReentrant {\n _rebaseOptIn(msg.sender);\n }\n\n function _rebaseOptIn(address _account) internal {\n require(_isNonRebasingAccount(_account), \"Account has not opted out\");\n\n // Convert balance into the same amount at the current exchange rate\n uint256 newCreditBalance = _creditBalances[_account]\n .mul(_rebasingCreditsPerToken)\n .div(_creditsPerToken(_account));\n\n // Decreasing non rebasing supply\n nonRebasingSupply = nonRebasingSupply.sub(balanceOf(_account));\n\n _creditBalances[_account] = newCreditBalance;\n\n // Increase rebasing credits, totalSupply remains unchanged so no\n // adjustment necessary\n _rebasingCredits = _rebasingCredits.add(_creditBalances[_account]);\n\n rebaseState[_account] = RebaseOptions.OptIn;\n\n // Delete any fixed credits per token\n delete nonRebasingCreditsPerToken[_account];\n emit AccountRebasingEnabled(_account);\n }\n\n /**\n * @dev Explicitly mark that an address is non-rebasing.\n */\n function rebaseOptOut() public nonReentrant {\n require(!_isNonRebasingAccount(msg.sender), \"Account has not opted in\");\n\n // Increase non rebasing supply\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(msg.sender));\n // Set fixed credits per token\n nonRebasingCreditsPerToken[msg.sender] = _rebasingCreditsPerToken;\n\n // Decrease rebasing credits, total supply remains unchanged so no\n // adjustment necessary\n _rebasingCredits = _rebasingCredits.sub(_creditBalances[msg.sender]);\n\n // Mark explicitly opted out of rebasing\n rebaseState[msg.sender] = RebaseOptions.OptOut;\n emit AccountRebasingDisabled(msg.sender);\n }\n\n /**\n * @dev Modify the supply without minting new tokens. This uses a change in\n * the exchange rate between \"credits\" and OUSD tokens to change balances.\n * @param _newTotalSupply New total supply of OUSD.\n */\n function changeSupply(uint256 _newTotalSupply)\n external\n onlyVault\n nonReentrant\n {\n require(_totalSupply > 0, \"Cannot increase 0 supply\");\n\n if (_totalSupply == _newTotalSupply) {\n emit TotalSupplyUpdatedHighres(\n _totalSupply,\n _rebasingCredits,\n _rebasingCreditsPerToken\n );\n return;\n }\n\n _totalSupply = _newTotalSupply > MAX_SUPPLY\n ? MAX_SUPPLY\n : _newTotalSupply;\n\n _rebasingCreditsPerToken = _rebasingCredits.divPrecisely(\n _totalSupply.sub(nonRebasingSupply)\n );\n\n require(_rebasingCreditsPerToken > 0, \"Invalid change in supply\");\n\n _totalSupply = _rebasingCredits\n .divPrecisely(_rebasingCreditsPerToken)\n .add(nonRebasingSupply);\n\n emit TotalSupplyUpdatedHighres(\n _totalSupply,\n _rebasingCredits,\n _rebasingCreditsPerToken\n );\n }\n}\n" + }, + "contracts/token/OUSDResolutionUpgrade.sol": { + "content": "pragma solidity ^0.8.0;\n\ncontract OUSDResolutionUpgrade {\n enum RebaseOptions {\n NotSet,\n OptOut,\n OptIn\n }\n\n // From Initializable\n bool private initialized;\n bool private initializing;\n uint256[50] private ______igap;\n\n // From InitializableERC20Detailed\n uint256[100] private _____ugap;\n string private _name;\n string private _symbol;\n uint8 private _decimals;\n\n // From OUSD\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\n uint256 public _totalSupply;\n mapping(address => mapping(address => uint256)) private _allowances;\n address public vaultAddress = address(0);\n mapping(address => uint256) private _creditBalances;\n uint256 private _rebasingCredits;\n uint256 private _rebasingCreditsPerToken;\n uint256 public nonRebasingSupply;\n mapping(address => uint256) public nonRebasingCreditsPerToken;\n mapping(address => RebaseOptions) public rebaseState;\n mapping(address => uint256) public isUpgraded;\n\n uint256 private constant RESOLUTION_INCREASE = 1e9;\n\n /**\n * @return High resolution rebasingCreditsPerToken\n */\n function rebasingCreditsPerToken() public view returns (uint256) {\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\n }\n\n /**\n * @return High resolution total number of rebasing credits\n */\n function rebasingCredits() public view returns (uint256) {\n return _rebasingCredits / RESOLUTION_INCREASE;\n }\n\n /**\n * @return High resolution rebasingCreditsPerToken\n */\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\n return _rebasingCreditsPerToken;\n }\n\n /**\n * @return High resolution total number of rebasing credits\n */\n function rebasingCreditsHighres() public view returns (uint256) {\n return _rebasingCredits;\n }\n\n function upgradeGlobals() external {\n require(isUpgraded[address(0)] == 0, \"Globals already upgraded\");\n require(_rebasingCredits > 0, \"Sanity _rebasingCredits\");\n require(\n _rebasingCreditsPerToken > 0,\n \"Sanity _rebasingCreditsPerToken\"\n );\n isUpgraded[address(0)] = 1;\n _rebasingCredits = _rebasingCredits * RESOLUTION_INCREASE;\n _rebasingCreditsPerToken =\n _rebasingCreditsPerToken *\n RESOLUTION_INCREASE;\n }\n\n function upgradeAccounts(address[] calldata accounts) external {\n for (uint256 i = 0; i < accounts.length; i++) {\n address account = accounts[i];\n require(account != address(0), \"Reserved\");\n require(isUpgraded[account] == 0, \"Account already upgraded\");\n isUpgraded[account] = 1;\n\n // Handle special for non-rebasing accounts\n uint256 nrc = nonRebasingCreditsPerToken[account];\n if (nrc > 0) {\n require(nrc < 1e18, \"Account already highres\");\n nonRebasingCreditsPerToken[account] = nrc * RESOLUTION_INCREASE;\n }\n // Upgrade balance\n uint256 balance = _creditBalances[account];\n require(balance > 0, \"Will not upgrade zero balance\");\n _creditBalances[account] = balance * RESOLUTION_INCREASE;\n }\n }\n\n function creditsBalanceOfHighres(address _account)\n public\n view\n returns (\n uint256,\n uint256,\n bool\n )\n {\n return (\n _creditBalances[_account],\n _creditsPerToken(_account),\n isUpgraded[_account] == 1\n );\n }\n\n /**\n * @dev Get the credits per token for an account. Returns a fixed amount\n * if the account is non-rebasing.\n * @param _account Address of the account.\n */\n function _creditsPerToken(address _account)\n internal\n view\n returns (uint256)\n {\n if (nonRebasingCreditsPerToken[_account] != 0) {\n return nonRebasingCreditsPerToken[_account];\n } else {\n return _rebasingCreditsPerToken;\n }\n }\n}\n" + }, + "contracts/token/WOETH.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC4626 } from \"../../lib/openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol\";\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { Governable } from \"../governance/Governable.sol\";\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { OETH } from \"./OETH.sol\";\n\n/**\n * @title OETH Token Contract\n * @author Origin Protocol Inc\n */\n\ncontract WOETH is ERC4626, Governable, Initializable {\n using SafeERC20 for IERC20;\n\n constructor(\n ERC20 underlying_,\n string memory name_,\n string memory symbol_\n ) ERC20(name_, symbol_) ERC4626(underlying_) Governable() {}\n\n /**\n * @notice Enable OETH rebasing for this contract\n */\n function initialize() external onlyGovernor initializer {\n OETH(address(asset())).rebaseOptIn();\n }\n\n function name() public view override returns (string memory) {\n return \"Wrapped OETH\";\n }\n\n function symbol() public view override returns (string memory) {\n return \"WOETH\";\n }\n\n /**\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\n * contract, i.e. mistaken sends. Cannot transfer OETH\n * @param asset_ Address for the asset\n * @param amount_ Amount of the asset to transfer\n */\n function transferToken(address asset_, uint256 amount_)\n external\n onlyGovernor\n {\n require(asset_ != address(asset()), \"Cannot collect OETH\");\n IERC20(asset_).safeTransfer(governor(), amount_);\n }\n}\n" + }, + "contracts/token/WrappedOusd.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { ERC4626 } from \"../../lib/openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol\";\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { Governable } from \"../governance/Governable.sol\";\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { OUSD } from \"./OUSD.sol\";\n\ncontract WrappedOusd is ERC4626, Governable, Initializable {\n using SafeERC20 for IERC20;\n\n constructor(\n ERC20 underlying_,\n string memory name_,\n string memory symbol_\n ) ERC20(name_, symbol_) ERC4626(underlying_) Governable() {}\n\n /**\n * @notice Enable OUSD rebasing for this contract\n */\n function initialize() external onlyGovernor initializer {\n OUSD(address(asset())).rebaseOptIn();\n }\n\n function name() public view override returns (string memory) {\n return \"Wrapped OUSD\";\n }\n\n function symbol() public view override returns (string memory) {\n return \"WOUSD\";\n }\n\n /**\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\n * contract, i.e. mistaken sends. Cannot transfer OUSD\n * @param asset_ Address for the asset\n * @param amount_ Amount of the asset to transfer\n */\n function transferToken(address asset_, uint256 amount_)\n external\n onlyGovernor\n {\n require(asset_ != address(asset()), \"Cannot collect OUSD\");\n IERC20(asset_).safeTransfer(governor(), amount_);\n }\n}\n" + }, + "contracts/utils/BalancerErrors.sol": { + "content": "// SPDX-License-Identifier: GPL-3.0-or-later\n// This program is free software: you can redistribute it and/or modify\n// it under the terms of the GNU General Public License as published by\n// the Free Software Foundation, either version 3 of the License, or\n// (at your option) any later version.\n\n// This program is distributed in the hope that it will be useful,\n// but WITHOUT ANY WARRANTY; without even the implied warranty of\n// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n// GNU General Public License for more details.\n\n// You should have received a copy of the GNU General Public License\n// along with this program. If not, see .\n\npragma solidity >=0.7.4 <0.9.0;\n\n// solhint-disable\n\n/**\n * @dev Reverts if `condition` is false, with a revert reason containing `errorCode`. Only codes up to 999 are\n * supported.\n * Uses the default 'BAL' prefix for the error code\n */\nfunction _require(bool condition, uint256 errorCode) pure {\n if (!condition) _revert(errorCode);\n}\n\n/**\n * @dev Reverts if `condition` is false, with a revert reason containing `errorCode`. Only codes up to 999 are\n * supported.\n */\nfunction _require(\n bool condition,\n uint256 errorCode,\n bytes3 prefix\n) pure {\n if (!condition) _revert(errorCode, prefix);\n}\n\n/**\n * @dev Reverts with a revert reason containing `errorCode`. Only codes up to 999 are supported.\n * Uses the default 'BAL' prefix for the error code\n */\nfunction _revert(uint256 errorCode) pure {\n _revert(errorCode, 0x42414c); // This is the raw byte representation of \"BAL\"\n}\n\n/**\n * @dev Reverts with a revert reason containing `errorCode`. Only codes up to 999 are supported.\n */\nfunction _revert(uint256 errorCode, bytes3 prefix) pure {\n uint256 prefixUint = uint256(uint24(prefix));\n // We're going to dynamically create a revert string based on the error code, with the following format:\n // 'BAL#{errorCode}'\n // where the code is left-padded with zeroes to three digits (so they range from 000 to 999).\n //\n // We don't have revert strings embedded in the contract to save bytecode size: it takes much less space to store a\n // number (8 to 16 bits) than the individual string characters.\n //\n // The dynamic string creation algorithm that follows could be implemented in Solidity, but assembly allows for a\n // much denser implementation, again saving bytecode size. Given this function unconditionally reverts, this is a\n // safe place to rely on it without worrying about how its usage might affect e.g. memory contents.\n assembly {\n // First, we need to compute the ASCII representation of the error code. We assume that it is in the 0-999\n // range, so we only need to convert three digits. To convert the digits to ASCII, we add 0x30, the value for\n // the '0' character.\n\n let units := add(mod(errorCode, 10), 0x30)\n\n errorCode := div(errorCode, 10)\n let tenths := add(mod(errorCode, 10), 0x30)\n\n errorCode := div(errorCode, 10)\n let hundreds := add(mod(errorCode, 10), 0x30)\n\n // With the individual characters, we can now construct the full string.\n // We first append the '#' character (0x23) to the prefix. In the case of 'BAL', it results in 0x42414c23 ('BAL#')\n // Then, we shift this by 24 (to provide space for the 3 bytes of the error code), and add the\n // characters to it, each shifted by a multiple of 8.\n // The revert reason is then shifted left by 200 bits (256 minus the length of the string, 7 characters * 8 bits\n // per character = 56) to locate it in the most significant part of the 256 slot (the beginning of a byte\n // array).\n let formattedPrefix := shl(24, add(0x23, shl(8, prefixUint)))\n\n let revertReason := shl(\n 200,\n add(\n formattedPrefix,\n add(add(units, shl(8, tenths)), shl(16, hundreds))\n )\n )\n\n // We can now encode the reason in memory, which can be safely overwritten as we're about to revert. The encoded\n // message will have the following layout:\n // [ revert reason identifier ] [ string location offset ] [ string length ] [ string contents ]\n\n // The Solidity revert reason identifier is 0x08c739a0, the function selector of the Error(string) function. We\n // also write zeroes to the next 28 bytes of memory, but those are about to be overwritten.\n mstore(\n 0x0,\n 0x08c379a000000000000000000000000000000000000000000000000000000000\n )\n // Next is the offset to the location of the string, which will be placed immediately after (20 bytes away).\n mstore(\n 0x04,\n 0x0000000000000000000000000000000000000000000000000000000000000020\n )\n // The string length is fixed: 7 characters.\n mstore(0x24, 7)\n // Finally, the string itself is stored.\n mstore(0x44, revertReason)\n\n // Even if the string is only 7 bytes long, we need to return a full 32 byte slot containing it. The length of\n // the encoded message is therefore 4 + 32 + 32 + 32 = 100.\n revert(0, 100)\n }\n}\n\nlibrary Errors {\n // Math\n uint256 internal constant ADD_OVERFLOW = 0;\n uint256 internal constant SUB_OVERFLOW = 1;\n uint256 internal constant SUB_UNDERFLOW = 2;\n uint256 internal constant MUL_OVERFLOW = 3;\n uint256 internal constant ZERO_DIVISION = 4;\n uint256 internal constant DIV_INTERNAL = 5;\n uint256 internal constant X_OUT_OF_BOUNDS = 6;\n uint256 internal constant Y_OUT_OF_BOUNDS = 7;\n uint256 internal constant PRODUCT_OUT_OF_BOUNDS = 8;\n uint256 internal constant INVALID_EXPONENT = 9;\n\n // Input\n uint256 internal constant OUT_OF_BOUNDS = 100;\n uint256 internal constant UNSORTED_ARRAY = 101;\n uint256 internal constant UNSORTED_TOKENS = 102;\n uint256 internal constant INPUT_LENGTH_MISMATCH = 103;\n uint256 internal constant ZERO_TOKEN = 104;\n uint256 internal constant INSUFFICIENT_DATA = 105;\n\n // Shared pools\n uint256 internal constant MIN_TOKENS = 200;\n uint256 internal constant MAX_TOKENS = 201;\n uint256 internal constant MAX_SWAP_FEE_PERCENTAGE = 202;\n uint256 internal constant MIN_SWAP_FEE_PERCENTAGE = 203;\n uint256 internal constant MINIMUM_BPT = 204;\n uint256 internal constant CALLER_NOT_VAULT = 205;\n uint256 internal constant UNINITIALIZED = 206;\n uint256 internal constant BPT_IN_MAX_AMOUNT = 207;\n uint256 internal constant BPT_OUT_MIN_AMOUNT = 208;\n uint256 internal constant EXPIRED_PERMIT = 209;\n uint256 internal constant NOT_TWO_TOKENS = 210;\n uint256 internal constant DISABLED = 211;\n\n // Pools\n uint256 internal constant MIN_AMP = 300;\n uint256 internal constant MAX_AMP = 301;\n uint256 internal constant MIN_WEIGHT = 302;\n uint256 internal constant MAX_STABLE_TOKENS = 303;\n uint256 internal constant MAX_IN_RATIO = 304;\n uint256 internal constant MAX_OUT_RATIO = 305;\n uint256 internal constant MIN_BPT_IN_FOR_TOKEN_OUT = 306;\n uint256 internal constant MAX_OUT_BPT_FOR_TOKEN_IN = 307;\n uint256 internal constant NORMALIZED_WEIGHT_INVARIANT = 308;\n uint256 internal constant INVALID_TOKEN = 309;\n uint256 internal constant UNHANDLED_JOIN_KIND = 310;\n uint256 internal constant ZERO_INVARIANT = 311;\n uint256 internal constant ORACLE_INVALID_SECONDS_QUERY = 312;\n uint256 internal constant ORACLE_NOT_INITIALIZED = 313;\n uint256 internal constant ORACLE_QUERY_TOO_OLD = 314;\n uint256 internal constant ORACLE_INVALID_INDEX = 315;\n uint256 internal constant ORACLE_BAD_SECS = 316;\n uint256 internal constant AMP_END_TIME_TOO_CLOSE = 317;\n uint256 internal constant AMP_ONGOING_UPDATE = 318;\n uint256 internal constant AMP_RATE_TOO_HIGH = 319;\n uint256 internal constant AMP_NO_ONGOING_UPDATE = 320;\n uint256 internal constant STABLE_INVARIANT_DIDNT_CONVERGE = 321;\n uint256 internal constant STABLE_GET_BALANCE_DIDNT_CONVERGE = 322;\n uint256 internal constant RELAYER_NOT_CONTRACT = 323;\n uint256 internal constant BASE_POOL_RELAYER_NOT_CALLED = 324;\n uint256 internal constant REBALANCING_RELAYER_REENTERED = 325;\n uint256 internal constant GRADUAL_UPDATE_TIME_TRAVEL = 326;\n uint256 internal constant SWAPS_DISABLED = 327;\n uint256 internal constant CALLER_IS_NOT_LBP_OWNER = 328;\n uint256 internal constant PRICE_RATE_OVERFLOW = 329;\n uint256 internal constant INVALID_JOIN_EXIT_KIND_WHILE_SWAPS_DISABLED = 330;\n uint256 internal constant WEIGHT_CHANGE_TOO_FAST = 331;\n uint256 internal constant LOWER_GREATER_THAN_UPPER_TARGET = 332;\n uint256 internal constant UPPER_TARGET_TOO_HIGH = 333;\n uint256 internal constant UNHANDLED_BY_LINEAR_POOL = 334;\n uint256 internal constant OUT_OF_TARGET_RANGE = 335;\n uint256 internal constant UNHANDLED_EXIT_KIND = 336;\n uint256 internal constant UNAUTHORIZED_EXIT = 337;\n uint256 internal constant MAX_MANAGEMENT_SWAP_FEE_PERCENTAGE = 338;\n uint256 internal constant UNHANDLED_BY_MANAGED_POOL = 339;\n uint256 internal constant UNHANDLED_BY_PHANTOM_POOL = 340;\n uint256 internal constant TOKEN_DOES_NOT_HAVE_RATE_PROVIDER = 341;\n uint256 internal constant INVALID_INITIALIZATION = 342;\n uint256 internal constant OUT_OF_NEW_TARGET_RANGE = 343;\n uint256 internal constant FEATURE_DISABLED = 344;\n uint256 internal constant UNINITIALIZED_POOL_CONTROLLER = 345;\n uint256 internal constant SET_SWAP_FEE_DURING_FEE_CHANGE = 346;\n uint256 internal constant SET_SWAP_FEE_PENDING_FEE_CHANGE = 347;\n uint256 internal constant CHANGE_TOKENS_DURING_WEIGHT_CHANGE = 348;\n uint256 internal constant CHANGE_TOKENS_PENDING_WEIGHT_CHANGE = 349;\n uint256 internal constant MAX_WEIGHT = 350;\n uint256 internal constant UNAUTHORIZED_JOIN = 351;\n uint256 internal constant MAX_MANAGEMENT_AUM_FEE_PERCENTAGE = 352;\n uint256 internal constant FRACTIONAL_TARGET = 353;\n uint256 internal constant ADD_OR_REMOVE_BPT = 354;\n uint256 internal constant INVALID_CIRCUIT_BREAKER_BOUNDS = 355;\n uint256 internal constant CIRCUIT_BREAKER_TRIPPED = 356;\n uint256 internal constant MALICIOUS_QUERY_REVERT = 357;\n uint256 internal constant JOINS_EXITS_DISABLED = 358;\n\n // Lib\n uint256 internal constant REENTRANCY = 400;\n uint256 internal constant SENDER_NOT_ALLOWED = 401;\n uint256 internal constant PAUSED = 402;\n uint256 internal constant PAUSE_WINDOW_EXPIRED = 403;\n uint256 internal constant MAX_PAUSE_WINDOW_DURATION = 404;\n uint256 internal constant MAX_BUFFER_PERIOD_DURATION = 405;\n uint256 internal constant INSUFFICIENT_BALANCE = 406;\n uint256 internal constant INSUFFICIENT_ALLOWANCE = 407;\n uint256 internal constant ERC20_TRANSFER_FROM_ZERO_ADDRESS = 408;\n uint256 internal constant ERC20_TRANSFER_TO_ZERO_ADDRESS = 409;\n uint256 internal constant ERC20_MINT_TO_ZERO_ADDRESS = 410;\n uint256 internal constant ERC20_BURN_FROM_ZERO_ADDRESS = 411;\n uint256 internal constant ERC20_APPROVE_FROM_ZERO_ADDRESS = 412;\n uint256 internal constant ERC20_APPROVE_TO_ZERO_ADDRESS = 413;\n uint256 internal constant ERC20_TRANSFER_EXCEEDS_ALLOWANCE = 414;\n uint256 internal constant ERC20_DECREASED_ALLOWANCE_BELOW_ZERO = 415;\n uint256 internal constant ERC20_TRANSFER_EXCEEDS_BALANCE = 416;\n uint256 internal constant ERC20_BURN_EXCEEDS_ALLOWANCE = 417;\n uint256 internal constant SAFE_ERC20_CALL_FAILED = 418;\n uint256 internal constant ADDRESS_INSUFFICIENT_BALANCE = 419;\n uint256 internal constant ADDRESS_CANNOT_SEND_VALUE = 420;\n uint256 internal constant SAFE_CAST_VALUE_CANT_FIT_INT256 = 421;\n uint256 internal constant GRANT_SENDER_NOT_ADMIN = 422;\n uint256 internal constant REVOKE_SENDER_NOT_ADMIN = 423;\n uint256 internal constant RENOUNCE_SENDER_NOT_ALLOWED = 424;\n uint256 internal constant BUFFER_PERIOD_EXPIRED = 425;\n uint256 internal constant CALLER_IS_NOT_OWNER = 426;\n uint256 internal constant NEW_OWNER_IS_ZERO = 427;\n uint256 internal constant CODE_DEPLOYMENT_FAILED = 428;\n uint256 internal constant CALL_TO_NON_CONTRACT = 429;\n uint256 internal constant LOW_LEVEL_CALL_FAILED = 430;\n uint256 internal constant NOT_PAUSED = 431;\n uint256 internal constant ADDRESS_ALREADY_ALLOWLISTED = 432;\n uint256 internal constant ADDRESS_NOT_ALLOWLISTED = 433;\n uint256 internal constant ERC20_BURN_EXCEEDS_BALANCE = 434;\n uint256 internal constant INVALID_OPERATION = 435;\n uint256 internal constant CODEC_OVERFLOW = 436;\n uint256 internal constant IN_RECOVERY_MODE = 437;\n uint256 internal constant NOT_IN_RECOVERY_MODE = 438;\n uint256 internal constant INDUCED_FAILURE = 439;\n uint256 internal constant EXPIRED_SIGNATURE = 440;\n uint256 internal constant MALFORMED_SIGNATURE = 441;\n uint256 internal constant SAFE_CAST_VALUE_CANT_FIT_UINT64 = 442;\n uint256 internal constant UNHANDLED_FEE_TYPE = 443;\n uint256 internal constant BURN_FROM_ZERO = 444;\n\n // Vault\n uint256 internal constant INVALID_POOL_ID = 500;\n uint256 internal constant CALLER_NOT_POOL = 501;\n uint256 internal constant SENDER_NOT_ASSET_MANAGER = 502;\n uint256 internal constant USER_DOESNT_ALLOW_RELAYER = 503;\n uint256 internal constant INVALID_SIGNATURE = 504;\n uint256 internal constant EXIT_BELOW_MIN = 505;\n uint256 internal constant JOIN_ABOVE_MAX = 506;\n uint256 internal constant SWAP_LIMIT = 507;\n uint256 internal constant SWAP_DEADLINE = 508;\n uint256 internal constant CANNOT_SWAP_SAME_TOKEN = 509;\n uint256 internal constant UNKNOWN_AMOUNT_IN_FIRST_SWAP = 510;\n uint256 internal constant MALCONSTRUCTED_MULTIHOP_SWAP = 511;\n uint256 internal constant INTERNAL_BALANCE_OVERFLOW = 512;\n uint256 internal constant INSUFFICIENT_INTERNAL_BALANCE = 513;\n uint256 internal constant INVALID_ETH_INTERNAL_BALANCE = 514;\n uint256 internal constant INVALID_POST_LOAN_BALANCE = 515;\n uint256 internal constant INSUFFICIENT_ETH = 516;\n uint256 internal constant UNALLOCATED_ETH = 517;\n uint256 internal constant ETH_TRANSFER = 518;\n uint256 internal constant CANNOT_USE_ETH_SENTINEL = 519;\n uint256 internal constant TOKENS_MISMATCH = 520;\n uint256 internal constant TOKEN_NOT_REGISTERED = 521;\n uint256 internal constant TOKEN_ALREADY_REGISTERED = 522;\n uint256 internal constant TOKENS_ALREADY_SET = 523;\n uint256 internal constant TOKENS_LENGTH_MUST_BE_2 = 524;\n uint256 internal constant NONZERO_TOKEN_BALANCE = 525;\n uint256 internal constant BALANCE_TOTAL_OVERFLOW = 526;\n uint256 internal constant POOL_NO_TOKENS = 527;\n uint256 internal constant INSUFFICIENT_FLASH_LOAN_BALANCE = 528;\n\n // Fees\n uint256 internal constant SWAP_FEE_PERCENTAGE_TOO_HIGH = 600;\n uint256 internal constant FLASH_LOAN_FEE_PERCENTAGE_TOO_HIGH = 601;\n uint256 internal constant INSUFFICIENT_FLASH_LOAN_FEE_AMOUNT = 602;\n uint256 internal constant AUM_FEE_PERCENTAGE_TOO_HIGH = 603;\n\n // FeeSplitter\n uint256 internal constant SPLITTER_FEE_PERCENTAGE_TOO_HIGH = 700;\n\n // Misc\n uint256 internal constant UNIMPLEMENTED = 998;\n uint256 internal constant SHOULD_NOT_HAPPEN = 999;\n}\n" + }, + "contracts/utils/Helpers.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IBasicToken } from \"../interfaces/IBasicToken.sol\";\n\nlibrary Helpers {\n /**\n * @notice Fetch the `symbol()` from an ERC20 token\n * @dev Grabs the `symbol()` from a contract\n * @param _token Address of the ERC20 token\n * @return string Symbol of the ERC20 token\n */\n function getSymbol(address _token) internal view returns (string memory) {\n string memory symbol = IBasicToken(_token).symbol();\n return symbol;\n }\n\n /**\n * @notice Fetch the `decimals()` from an ERC20 token\n * @dev Grabs the `decimals()` from a contract and fails if\n * the decimal value does not live within a certain range\n * @param _token Address of the ERC20 token\n * @return uint256 Decimals of the ERC20 token\n */\n function getDecimals(address _token) internal view returns (uint256) {\n uint256 decimals = IBasicToken(_token).decimals();\n require(\n decimals >= 4 && decimals <= 18,\n \"Token must have sufficient decimal places\"\n );\n\n return decimals;\n }\n}\n" + }, + "contracts/utils/Initializable.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Base contract any contracts that need to initialize state after deployment.\n * @author Origin Protocol Inc\n */\nabstract contract Initializable {\n /**\n * @dev Indicates that the contract has been initialized.\n */\n bool private initialized;\n\n /**\n * @dev Indicates that the contract is in the process of being initialized.\n */\n bool private initializing;\n\n /**\n * @dev Modifier to protect an initializer function from being invoked twice.\n */\n modifier initializer() {\n require(\n initializing || !initialized,\n \"Initializable: contract is already initialized\"\n );\n\n bool isTopLevelCall = !initializing;\n if (isTopLevelCall) {\n initializing = true;\n initialized = true;\n }\n\n _;\n\n if (isTopLevelCall) {\n initializing = false;\n }\n }\n\n uint256[50] private ______gap;\n}\n" + }, + "contracts/utils/InitializableAbstractStrategy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Base contract for vault strategies.\n * @author Origin Protocol Inc\n */\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\n\nabstract contract InitializableAbstractStrategy is Initializable, Governable {\n using SafeERC20 for IERC20;\n\n event PTokenAdded(address indexed _asset, address _pToken);\n event PTokenRemoved(address indexed _asset, address _pToken);\n event Deposit(address indexed _asset, address _pToken, uint256 _amount);\n event Withdrawal(address indexed _asset, address _pToken, uint256 _amount);\n event RewardTokenCollected(\n address recipient,\n address rewardToken,\n uint256 amount\n );\n event RewardTokenAddressesUpdated(\n address[] _oldAddresses,\n address[] _newAddresses\n );\n event HarvesterAddressesUpdated(\n address _oldHarvesterAddress,\n address _newHarvesterAddress\n );\n\n /// @notice Address of the underlying platform\n address public immutable platformAddress;\n /// @notice Address of the OToken vault\n address public immutable vaultAddress;\n\n /// @dev Replaced with an immutable variable\n // slither-disable-next-line constable-states\n address private _deprecated_platformAddress;\n\n /// @dev Replaced with an immutable\n // slither-disable-next-line constable-states\n address private _deprecated_vaultAddress;\n\n /// @notice asset => pToken (Platform Specific Token Address)\n mapping(address => address) public assetToPToken;\n\n /// @notice Full list of all assets supported by the strategy\n address[] internal assetsMapped;\n\n // Deprecated: Reward token address\n // slither-disable-next-line constable-states\n address private _deprecated_rewardTokenAddress;\n\n // Deprecated: now resides in Harvester's rewardTokenConfigs\n // slither-disable-next-line constable-states\n uint256 private _deprecated_rewardLiquidationThreshold;\n\n /// @notice Address of the Harvester contract allowed to collect reward tokens\n address public harvesterAddress;\n\n /// @notice Address of the reward tokens. eg CRV, BAL, CVX, AURA\n address[] public rewardTokenAddresses;\n\n /* Reserved for future expansion. Used to be 100 storage slots\n * and has decreased to accommodate:\n * - harvesterAddress\n * - rewardTokenAddresses\n */\n int256[98] private _reserved;\n\n struct BaseStrategyConfig {\n address platformAddress; // Address of the underlying platform\n address vaultAddress; // Address of the OToken's Vault\n }\n\n /**\n * @param _config The platform and OToken vault addresses\n */\n constructor(BaseStrategyConfig memory _config) {\n platformAddress = _config.platformAddress;\n vaultAddress = _config.vaultAddress;\n }\n\n /**\n * @dev Internal initialize function, to set up initial internal state\n * @param _rewardTokenAddresses Address of reward token for platform\n * @param _assets Addresses of initial supported assets\n * @param _pTokens Platform Token corresponding addresses\n */\n function _initialize(\n address[] memory _rewardTokenAddresses,\n address[] memory _assets,\n address[] memory _pTokens\n ) internal {\n rewardTokenAddresses = _rewardTokenAddresses;\n\n uint256 assetCount = _assets.length;\n require(assetCount == _pTokens.length, \"Invalid input arrays\");\n for (uint256 i = 0; i < assetCount; ++i) {\n _setPTokenAddress(_assets[i], _pTokens[i]);\n }\n }\n\n /**\n * @notice Collect accumulated reward token and send to Vault.\n */\n function collectRewardTokens() external virtual onlyHarvester nonReentrant {\n _collectRewardTokens();\n }\n\n /**\n * @dev Default implementation that transfers reward tokens to the Harvester\n * Implementing strategies need to add custom logic to collect the rewards.\n */\n function _collectRewardTokens() internal virtual {\n uint256 rewardTokenCount = rewardTokenAddresses.length;\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\n IERC20 rewardToken = IERC20(rewardTokenAddresses[i]);\n uint256 balance = rewardToken.balanceOf(address(this));\n if (balance > 0) {\n emit RewardTokenCollected(\n harvesterAddress,\n address(rewardToken),\n balance\n );\n rewardToken.safeTransfer(harvesterAddress, balance);\n }\n }\n }\n\n /**\n * @dev Verifies that the caller is the Vault.\n */\n modifier onlyVault() {\n require(msg.sender == vaultAddress, \"Caller is not the Vault\");\n _;\n }\n\n /**\n * @dev Verifies that the caller is the Harvester.\n */\n modifier onlyHarvester() {\n require(msg.sender == harvesterAddress, \"Caller is not the Harvester\");\n _;\n }\n\n /**\n * @dev Verifies that the caller is the Vault or Governor.\n */\n modifier onlyVaultOrGovernor() {\n require(\n msg.sender == vaultAddress || msg.sender == governor(),\n \"Caller is not the Vault or Governor\"\n );\n _;\n }\n\n /**\n * @dev Verifies that the caller is the Vault, Governor, or Strategist.\n */\n modifier onlyVaultOrGovernorOrStrategist() {\n require(\n msg.sender == vaultAddress ||\n msg.sender == governor() ||\n msg.sender == IVault(vaultAddress).strategistAddr(),\n \"Caller is not the Vault, Governor, or Strategist\"\n );\n _;\n }\n\n /**\n * @notice Set the reward token addresses. Any old addresses will be overwritten.\n * @param _rewardTokenAddresses Array of reward token addresses\n */\n function setRewardTokenAddresses(address[] calldata _rewardTokenAddresses)\n external\n onlyGovernor\n {\n uint256 rewardTokenCount = _rewardTokenAddresses.length;\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\n require(\n _rewardTokenAddresses[i] != address(0),\n \"Can not set an empty address as a reward token\"\n );\n }\n\n emit RewardTokenAddressesUpdated(\n rewardTokenAddresses,\n _rewardTokenAddresses\n );\n rewardTokenAddresses = _rewardTokenAddresses;\n }\n\n /**\n * @notice Get the reward token addresses.\n * @return address[] the reward token addresses.\n */\n function getRewardTokenAddresses()\n external\n view\n returns (address[] memory)\n {\n return rewardTokenAddresses;\n }\n\n /**\n * @notice Provide support for asset by passing its pToken address.\n * This method can only be called by the system Governor\n * @param _asset Address for the asset\n * @param _pToken Address for the corresponding platform token\n */\n function setPTokenAddress(address _asset, address _pToken)\n external\n virtual\n onlyGovernor\n {\n _setPTokenAddress(_asset, _pToken);\n }\n\n /**\n * @notice Remove a supported asset by passing its index.\n * This method can only be called by the system Governor\n * @param _assetIndex Index of the asset to be removed\n */\n function removePToken(uint256 _assetIndex) external virtual onlyGovernor {\n require(_assetIndex < assetsMapped.length, \"Invalid index\");\n address asset = assetsMapped[_assetIndex];\n address pToken = assetToPToken[asset];\n\n if (_assetIndex < assetsMapped.length - 1) {\n assetsMapped[_assetIndex] = assetsMapped[assetsMapped.length - 1];\n }\n assetsMapped.pop();\n assetToPToken[asset] = address(0);\n\n emit PTokenRemoved(asset, pToken);\n }\n\n /**\n * @notice Provide support for asset by passing its pToken address.\n * Add to internal mappings and execute the platform specific,\n * abstract method `_abstractSetPToken`\n * @param _asset Address for the asset\n * @param _pToken Address for the corresponding platform token\n */\n function _setPTokenAddress(address _asset, address _pToken) internal {\n require(assetToPToken[_asset] == address(0), \"pToken already set\");\n require(\n _asset != address(0) && _pToken != address(0),\n \"Invalid addresses\"\n );\n\n assetToPToken[_asset] = _pToken;\n assetsMapped.push(_asset);\n\n emit PTokenAdded(_asset, _pToken);\n\n _abstractSetPToken(_asset, _pToken);\n }\n\n /**\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\n * strategy contracts, i.e. mistaken sends.\n * @param _asset Address for the asset\n * @param _amount Amount of the asset to transfer\n */\n function transferToken(address _asset, uint256 _amount)\n public\n onlyGovernor\n {\n require(!supportsAsset(_asset), \"Cannot transfer supported asset\");\n IERC20(_asset).safeTransfer(governor(), _amount);\n }\n\n /**\n * @notice Set the Harvester contract that can collect rewards.\n * @param _harvesterAddress Address of the harvester contract.\n */\n function setHarvesterAddress(address _harvesterAddress)\n external\n onlyGovernor\n {\n emit HarvesterAddressesUpdated(harvesterAddress, _harvesterAddress);\n harvesterAddress = _harvesterAddress;\n }\n\n /***************************************\n Abstract\n ****************************************/\n\n function _abstractSetPToken(address _asset, address _pToken)\n internal\n virtual;\n\n function safeApproveAllTokens() external virtual;\n\n /**\n * @notice Deposit an amount of assets into the platform\n * @param _asset Address for the asset\n * @param _amount Units of asset to deposit\n */\n function deposit(address _asset, uint256 _amount) external virtual;\n\n /**\n * @notice Deposit all supported assets in this strategy contract to the platform\n */\n function depositAll() external virtual;\n\n /**\n * @notice Withdraw an `amount` of assets from the platform and\n * send to the `_recipient`.\n * @param _recipient Address to which the asset should be sent\n * @param _asset Address of the asset\n * @param _amount Units of asset to withdraw\n */\n function withdraw(\n address _recipient,\n address _asset,\n uint256 _amount\n ) external virtual;\n\n /**\n * @notice Withdraw all supported assets from platform and\n * sends to the OToken's Vault.\n */\n function withdrawAll() external virtual;\n\n /**\n * @notice Get the total asset value held in the platform.\n * This includes any interest that was generated since depositing.\n * @param _asset Address of the asset\n * @return balance Total value of the asset in the platform\n */\n function checkBalance(address _asset)\n external\n view\n virtual\n returns (uint256 balance);\n\n /**\n * @notice Check if an asset is supported.\n * @param _asset Address of the asset\n * @return bool Whether asset is supported\n */\n function supportsAsset(address _asset) public view virtual returns (bool);\n}\n" + }, + "contracts/utils/InitializableERC20Detailed.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @dev Optional functions from the ERC20 standard.\n * Converted from openzeppelin/contracts/token/ERC20/ERC20Detailed.sol\n * @author Origin Protocol Inc\n */\nabstract contract InitializableERC20Detailed is IERC20 {\n // Storage gap to skip storage from prior to OUSD reset\n uint256[100] private _____gap;\n\n string private _name;\n string private _symbol;\n uint8 private _decimals;\n\n /**\n * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of\n * these values are immutable: they can only be set once during\n * construction.\n * @notice To avoid variable shadowing appended `Arg` after arguments name.\n */\n function _initialize(\n string memory nameArg,\n string memory symbolArg,\n uint8 decimalsArg\n ) internal {\n _name = nameArg;\n _symbol = symbolArg;\n _decimals = decimalsArg;\n }\n\n /**\n * @notice Returns the name of the token.\n */\n function name() public view returns (string memory) {\n return _name;\n }\n\n /**\n * @notice Returns the symbol of the token, usually a shorter version of the\n * name.\n */\n function symbol() public view returns (string memory) {\n return _symbol;\n }\n\n /**\n * @notice Returns the number of decimals used to get its user representation.\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\n * be displayed to a user as `5,05` (`505 / 10 ** 2`).\n *\n * Tokens usually opt for a value of 18, imitating the relationship between\n * Ether and Wei.\n *\n * NOTE: This information is only used for _display_ purposes: it in\n * no way affects any of the arithmetic of the contract, including\n * {IERC20-balanceOf} and {IERC20-transfer}.\n */\n function decimals() public view returns (uint8) {\n return _decimals;\n }\n}\n" + }, + "contracts/utils/StableMath.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { SafeMath } from \"@openzeppelin/contracts/utils/math/SafeMath.sol\";\n\n// Based on StableMath from Stability Labs Pty. Ltd.\n// https://github.com/mstable/mStable-contracts/blob/master/contracts/shared/StableMath.sol\n\nlibrary StableMath {\n using SafeMath for uint256;\n\n /**\n * @dev Scaling unit for use in specific calculations,\n * where 1 * 10**18, or 1e18 represents a unit '1'\n */\n uint256 private constant FULL_SCALE = 1e18;\n\n /***************************************\n Helpers\n ****************************************/\n\n /**\n * @dev Adjust the scale of an integer\n * @param to Decimals to scale to\n * @param from Decimals to scale from\n */\n function scaleBy(\n uint256 x,\n uint256 to,\n uint256 from\n ) internal pure returns (uint256) {\n if (to > from) {\n x = x.mul(10**(to - from));\n } else if (to < from) {\n // slither-disable-next-line divide-before-multiply\n x = x.div(10**(from - to));\n }\n return x;\n }\n\n /***************************************\n Precise Arithmetic\n ****************************************/\n\n /**\n * @dev Multiplies two precise units, and then truncates by the full scale\n * @param x Left hand input to multiplication\n * @param y Right hand input to multiplication\n * @return Result after multiplying the two inputs and then dividing by the shared\n * scale unit\n */\n function mulTruncate(uint256 x, uint256 y) internal pure returns (uint256) {\n return mulTruncateScale(x, y, FULL_SCALE);\n }\n\n /**\n * @dev Multiplies two precise units, and then truncates by the given scale. For example,\n * when calculating 90% of 10e18, (10e18 * 9e17) / 1e18 = (9e36) / 1e18 = 9e18\n * @param x Left hand input to multiplication\n * @param y Right hand input to multiplication\n * @param scale Scale unit\n * @return Result after multiplying the two inputs and then dividing by the shared\n * scale unit\n */\n function mulTruncateScale(\n uint256 x,\n uint256 y,\n uint256 scale\n ) internal pure returns (uint256) {\n // e.g. assume scale = fullScale\n // z = 10e18 * 9e17 = 9e36\n uint256 z = x.mul(y);\n // return 9e36 / 1e18 = 9e18\n return z.div(scale);\n }\n\n /**\n * @dev Multiplies two precise units, and then truncates by the full scale, rounding up the result\n * @param x Left hand input to multiplication\n * @param y Right hand input to multiplication\n * @return Result after multiplying the two inputs and then dividing by the shared\n * scale unit, rounded up to the closest base unit.\n */\n function mulTruncateCeil(uint256 x, uint256 y)\n internal\n pure\n returns (uint256)\n {\n // e.g. 8e17 * 17268172638 = 138145381104e17\n uint256 scaled = x.mul(y);\n // e.g. 138145381104e17 + 9.99...e17 = 138145381113.99...e17\n uint256 ceil = scaled.add(FULL_SCALE.sub(1));\n // e.g. 13814538111.399...e18 / 1e18 = 13814538111\n return ceil.div(FULL_SCALE);\n }\n\n /**\n * @dev Precisely divides two units, by first scaling the left hand operand. Useful\n * for finding percentage weightings, i.e. 8e18/10e18 = 80% (or 8e17)\n * @param x Left hand input to division\n * @param y Right hand input to division\n * @return Result after multiplying the left operand by the scale, and\n * executing the division on the right hand input.\n */\n function divPrecisely(uint256 x, uint256 y)\n internal\n pure\n returns (uint256)\n {\n // e.g. 8e18 * 1e18 = 8e36\n uint256 z = x.mul(FULL_SCALE);\n // e.g. 8e36 / 10e18 = 8e17\n return z.div(y);\n }\n}\n" + }, + "contracts/vault/OETHVault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Vault } from \"./Vault.sol\";\n\n/**\n * @title OETH Vault Contract\n * @author Origin Protocol Inc\n */\ncontract OETHVault is Vault {\n\n}\n" + }, + "contracts/vault/OETHVaultAdmin.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { VaultAdmin } from \"./VaultAdmin.sol\";\n\n/**\n * @title OETH VaultAdmin Contract\n * @author Origin Protocol Inc\n */\ncontract OETHVaultAdmin is VaultAdmin {\n\n}\n" + }, + "contracts/vault/OETHVaultCore.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { VaultCore } from \"./VaultCore.sol\";\n\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { IStrategy } from \"../interfaces/IStrategy.sol\";\n\n/**\n * @title OETH VaultCore Contract\n * @author Origin Protocol Inc\n */\ncontract OETHVaultCore is VaultCore {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n address public immutable weth;\n uint256 public wethAssetIndex;\n\n constructor(address _weth) {\n weth = _weth;\n }\n\n /**\n * @dev Caches WETH's index in `allAssets` variable.\n * Reduces gas usage by redeem by caching that.\n */\n function cacheWETHAssetIndex() external onlyGovernor {\n uint256 assetCount = allAssets.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n if (allAssets[i] == weth) {\n wethAssetIndex = i;\n break;\n }\n }\n\n require(allAssets[wethAssetIndex] == weth, \"Invalid WETH Asset Index\");\n }\n\n // @inheritdoc VaultCore\n function _mint(\n address _asset,\n uint256 _amount,\n uint256 _minimumOusdAmount\n ) internal virtual override {\n require(_asset == weth, \"Unsupported asset for minting\");\n require(_amount > 0, \"Amount must be greater than 0\");\n require(\n _amount >= _minimumOusdAmount,\n \"Mint amount lower than minimum\"\n );\n\n emit Mint(msg.sender, _amount);\n\n // Rebase must happen before any transfers occur.\n if (!rebasePaused && _amount >= rebaseThreshold) {\n _rebase();\n }\n\n // Mint oTokens\n oUSD.mint(msg.sender, _amount);\n\n // Transfer the deposited coins to the vault\n IERC20(_asset).safeTransferFrom(msg.sender, address(this), _amount);\n\n // Auto-allocate if necessary\n if (_amount >= autoAllocateThreshold) {\n _allocate();\n }\n }\n\n // @inheritdoc VaultCore\n function _calculateRedeemOutputs(uint256 _amount)\n internal\n view\n virtual\n override\n returns (uint256[] memory outputs)\n {\n // Overrides `VaultCore._calculateRedeemOutputs` to redeem with only\n // WETH instead of LST-mix. Doesn't change the function signature\n // for backward compatibility\n\n // Calculate redeem fee\n if (redeemFeeBps > 0) {\n uint256 redeemFee = _amount.mulTruncateScale(redeemFeeBps, 1e4);\n _amount = _amount - redeemFee;\n }\n\n // Ensure that the WETH index is cached\n uint256 _wethAssetIndex = wethAssetIndex;\n require(\n allAssets[_wethAssetIndex] == weth,\n \"WETH Asset index not cached\"\n );\n\n outputs = new uint256[](allAssets.length);\n outputs[_wethAssetIndex] = _amount;\n }\n\n // @inheritdoc VaultCore\n function _redeem(uint256 _amount, uint256 _minimumUnitAmount)\n internal\n virtual\n override\n {\n // Override `VaultCore._redeem` to simplify it. Gets rid of oracle\n // usage and looping through all assets for LST-mix redeem. Instead\n // does a simple WETH-only redeem.\n emit Redeem(msg.sender, _amount);\n\n if (_amount == 0) {\n return;\n }\n\n // Amount excluding fees\n uint256 amountMinusFee = _calculateRedeemOutputs(_amount)[\n wethAssetIndex\n ];\n\n require(\n amountMinusFee >= _minimumUnitAmount,\n \"Redeem amount lower than minimum\"\n );\n\n if (IERC20(weth).balanceOf(address(this)) >= amountMinusFee) {\n // Use Vault funds first if sufficient\n IERC20(weth).safeTransfer(msg.sender, amountMinusFee);\n } else {\n address strategyAddr = assetDefaultStrategies[weth];\n if (strategyAddr != address(0)) {\n // Nothing in Vault, but something in Strategy, send from there\n IStrategy strategy = IStrategy(strategyAddr);\n strategy.withdraw(msg.sender, weth, amountMinusFee);\n } else {\n // Cant find funds anywhere\n revert(\"Liquidity error\");\n }\n }\n\n // Burn OETH from user (including fees)\n oUSD.burn(msg.sender, _amount);\n\n _postRedeem(_amount);\n }\n}\n" + }, + "contracts/vault/OETHZapper.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\nimport { IWETH9 } from \"../interfaces/IWETH9.sol\";\nimport { ISfrxETH } from \"../interfaces/ISfrxETH.sol\";\n\ncontract OETHZapper {\n IERC20 public immutable oeth;\n IVault public immutable vault;\n\n IWETH9 public constant weth =\n IWETH9(0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2);\n IERC20 public constant frxeth =\n IERC20(0x5E8422345238F34275888049021821E8E08CAa1f);\n ISfrxETH public constant sfrxeth =\n ISfrxETH(0xac3E018457B222d93114458476f3E3416Abbe38F);\n address private constant ETH_MARKER =\n 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE;\n\n event Zap(address indexed minter, address indexed asset, uint256 amount);\n\n constructor(address _oeth, address _vault) {\n oeth = IERC20(_oeth);\n vault = IVault(_vault);\n\n weth.approve(address(_vault), type(uint256).max);\n frxeth.approve(address(_vault), type(uint256).max);\n }\n\n /**\n * @dev Deposit ETH and receive OETH in return.\n * Will verify that the user is sent 1:1 for ETH.\n */\n receive() external payable {\n deposit();\n }\n\n /**\n * @dev Deposit ETH and receive OETH in return\n * Will verify that the user is sent 1:1 for ETH.\n * @return Amount of OETH sent to user\n */\n function deposit() public payable returns (uint256) {\n uint256 balance = address(this).balance;\n weth.deposit{ value: balance }();\n emit Zap(msg.sender, ETH_MARKER, balance);\n return _mint(address(weth), balance);\n }\n\n /**\n * @dev Deposit SFRXETH to the vault and receive OETH in return\n * @param amount Amount of SFRXETH to deposit\n * @param minOETH Minimum amount of OETH to receive\n * @return Amount of OETH sent to user\n */\n function depositSFRXETH(uint256 amount, uint256 minOETH)\n external\n returns (uint256)\n {\n sfrxeth.redeem(amount, address(this), msg.sender);\n emit Zap(msg.sender, address(sfrxeth), amount);\n return _mint(address(frxeth), minOETH);\n }\n\n /**\n * @dev Internal function to mint OETH from an asset\n * @param asset Address of asset for the vault to mint from\n * @param minOETH Minimum amount of OETH to for user to receive\n * @return Amount of OETH sent to user\n */\n function _mint(address asset, uint256 minOETH) internal returns (uint256) {\n uint256 toMint = IERC20(asset).balanceOf(address(this));\n vault.mint(asset, toMint, minOETH);\n uint256 mintedAmount = oeth.balanceOf(address(this));\n require(mintedAmount >= minOETH, \"Zapper: not enough minted\");\n require(oeth.transfer(msg.sender, mintedAmount));\n return mintedAmount;\n }\n}\n" + }, + "contracts/vault/Vault.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OUSD VaultInitializer Contract\n * @notice The VaultInitializer sets up the initial contract.\n * @author Origin Protocol Inc\n */\nimport { VaultInitializer } from \"./VaultInitializer.sol\";\nimport { VaultAdmin } from \"./VaultAdmin.sol\";\n\ncontract Vault is VaultInitializer, VaultAdmin {}\n" + }, + "contracts/vault/VaultAdmin.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OToken VaultAdmin contract\n * @notice The VaultAdmin contract makes configuration and admin calls on the vault.\n * @author Origin Protocol Inc\n */\n\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { ISwapper } from \"../interfaces/ISwapper.sol\";\nimport { IVault } from \"../interfaces/IVault.sol\";\nimport { StableMath } from \"../utils/StableMath.sol\";\n\nimport \"./VaultStorage.sol\";\n\ncontract VaultAdmin is VaultStorage {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n\n /**\n * @dev Verifies that the caller is the Governor or Strategist.\n */\n modifier onlyGovernorOrStrategist() {\n require(\n msg.sender == strategistAddr || isGovernor(),\n \"Caller is not the Strategist or Governor\"\n );\n _;\n }\n\n /***************************************\n Configuration\n ****************************************/\n\n /**\n * @notice Set address of price provider.\n * @param _priceProvider Address of price provider\n */\n function setPriceProvider(address _priceProvider) external onlyGovernor {\n priceProvider = _priceProvider;\n emit PriceProviderUpdated(_priceProvider);\n }\n\n /**\n * @notice Set a fee in basis points to be charged for a redeem.\n * @param _redeemFeeBps Basis point fee to be charged\n */\n function setRedeemFeeBps(uint256 _redeemFeeBps) external onlyGovernor {\n require(_redeemFeeBps <= 1000, \"Redeem fee should not be over 10%\");\n redeemFeeBps = _redeemFeeBps;\n emit RedeemFeeUpdated(_redeemFeeBps);\n }\n\n /**\n * @notice Set a buffer of assets to keep in the Vault to handle most\n * redemptions without needing to spend gas unwinding assets from a Strategy.\n * @param _vaultBuffer Percentage using 18 decimals. 100% = 1e18.\n */\n function setVaultBuffer(uint256 _vaultBuffer)\n external\n onlyGovernorOrStrategist\n {\n require(_vaultBuffer <= 1e18, \"Invalid value\");\n vaultBuffer = _vaultBuffer;\n emit VaultBufferUpdated(_vaultBuffer);\n }\n\n /**\n * @notice Sets the minimum amount of OTokens in a mint to trigger an\n * automatic allocation of funds afterwords.\n * @param _threshold OToken amount with 18 fixed decimals.\n */\n function setAutoAllocateThreshold(uint256 _threshold)\n external\n onlyGovernor\n {\n autoAllocateThreshold = _threshold;\n emit AllocateThresholdUpdated(_threshold);\n }\n\n /**\n * @notice Set a minimum amount of OTokens in a mint or redeem that triggers a\n * rebase\n * @param _threshold OToken amount with 18 fixed decimals.\n */\n function setRebaseThreshold(uint256 _threshold) external onlyGovernor {\n rebaseThreshold = _threshold;\n emit RebaseThresholdUpdated(_threshold);\n }\n\n /**\n * @notice Set address of Strategist\n * @param _address Address of Strategist\n */\n function setStrategistAddr(address _address) external onlyGovernor {\n strategistAddr = _address;\n emit StrategistUpdated(_address);\n }\n\n /**\n * @notice Set the default Strategy for an asset, i.e. the one which the asset\n will be automatically allocated to and withdrawn from\n * @param _asset Address of the asset\n * @param _strategy Address of the Strategy\n */\n function setAssetDefaultStrategy(address _asset, address _strategy)\n external\n onlyGovernorOrStrategist\n {\n emit AssetDefaultStrategyUpdated(_asset, _strategy);\n // If its a zero address being passed for the strategy we are removing\n // the default strategy\n if (_strategy != address(0)) {\n // Make sure the strategy meets some criteria\n require(strategies[_strategy].isSupported, \"Strategy not approved\");\n IStrategy strategy = IStrategy(_strategy);\n require(assets[_asset].isSupported, \"Asset is not supported\");\n require(\n strategy.supportsAsset(_asset),\n \"Asset not supported by Strategy\"\n );\n }\n assetDefaultStrategies[_asset] = _strategy;\n }\n\n /**\n * @notice Set maximum amount of OTokens that can at any point be minted and deployed\n * to strategy (used only by ConvexOUSDMetaStrategy for now).\n * @param _threshold OToken amount with 18 fixed decimals.\n */\n function setNetOusdMintForStrategyThreshold(uint256 _threshold)\n external\n onlyGovernor\n {\n /**\n * Because `netOusdMintedForStrategy` check in vault core works both ways\n * (positive and negative) the actual impact of the amount of OToken minted\n * could be double the threshold. E.g.:\n * - contract has threshold set to 100\n * - state of netOusdMinted is -90\n * - in effect it can mint 190 OToken and still be within limits\n *\n * We are somewhat mitigating this behaviour by resetting the netOusdMinted\n * counter whenever new threshold is set. So it can only move one threshold\n * amount in each direction. This also enables us to reduce the threshold\n * amount and not have problems with current netOusdMinted being near\n * limits on either side.\n */\n netOusdMintedForStrategy = 0;\n netOusdMintForStrategyThreshold = _threshold;\n emit NetOusdMintForStrategyThresholdChanged(_threshold);\n }\n\n /***************************************\n Swaps\n ****************************************/\n\n /**\n * @notice Strategist swaps collateral assets sitting in the vault.\n * @param _fromAsset The token address of the asset being sold by the vault.\n * @param _toAsset The token address of the asset being purchased by the vault.\n * @param _fromAssetAmount The amount of assets being sold by the vault.\n * @param _minToAssetAmount The minimum amount of assets to be purchased.\n * @param _data implementation specific data. eg 1Inch swap data\n * @return toAssetAmount The amount of toAssets that was received from the swap\n */\n function swapCollateral(\n address _fromAsset,\n address _toAsset,\n uint256 _fromAssetAmount,\n uint256 _minToAssetAmount,\n bytes calldata _data\n )\n external\n nonReentrant\n onlyGovernorOrStrategist\n returns (uint256 toAssetAmount)\n {\n // Check fromAsset and toAsset are valid\n Asset memory fromAssetConfig = assets[address(_fromAsset)];\n Asset memory toAssetConfig = assets[_toAsset];\n require(fromAssetConfig.isSupported, \"From asset is not supported\");\n require(toAssetConfig.isSupported, \"To asset is not supported\");\n\n // Load swap config into memory to avoid separate SLOADs\n SwapConfig memory config = swapConfig;\n\n // Scope a new block to remove toAssetBalBefore from the scope of swapCollateral.\n // This avoids a stack too deep error.\n {\n uint256 toAssetBalBefore = IERC20(_toAsset).balanceOf(\n address(this)\n );\n\n // Transfer from assets to the swapper contract\n IERC20(_fromAsset).safeTransfer(config.swapper, _fromAssetAmount);\n\n // Call to the Swapper contract to do the actual swap\n // The -1 is required for stETH which sometimes transfers 1 wei less than what was specified.\n // slither-disable-next-line unused-return\n ISwapper(config.swapper).swap(\n _fromAsset,\n _toAsset,\n _fromAssetAmount - 1,\n _minToAssetAmount,\n _data\n );\n\n // Compute the change in asset balance held by the Vault\n toAssetAmount =\n IERC20(_toAsset).balanceOf(address(this)) -\n toAssetBalBefore;\n }\n\n // Check the to assets returned is above slippage amount specified by the strategist\n require(\n toAssetAmount >= _minToAssetAmount,\n \"Strategist slippage limit\"\n );\n\n // Scope a new block to remove minOracleToAssetAmount from the scope of swapCollateral.\n // This avoids a stack too deep error.\n {\n // Check the slippage against the Oracle in case the strategist made a mistake or has become malicious.\n // to asset amount = from asset amount * from asset price / to asset price\n uint256 minOracleToAssetAmount = (_fromAssetAmount *\n (1e4 - fromAssetConfig.allowedOracleSlippageBps) *\n IOracle(priceProvider).price(_fromAsset)) /\n (IOracle(priceProvider).price(_toAsset) *\n (1e4 + toAssetConfig.allowedOracleSlippageBps));\n\n // Scale both sides up to 18 decimals to compare\n require(\n toAssetAmount.scaleBy(18, toAssetConfig.decimals) >=\n minOracleToAssetAmount.scaleBy(\n 18,\n fromAssetConfig.decimals\n ),\n \"Oracle slippage limit exceeded\"\n );\n }\n\n // Check the vault's total value hasn't gone below the OToken total supply\n // by more than the allowed percentage.\n require(\n IVault(address(this)).totalValue() >=\n (oUSD.totalSupply() * ((1e4 - config.allowedUndervalueBps))) /\n 1e4,\n \"Allowed value < supply\"\n );\n\n emit Swapped(_fromAsset, _toAsset, _fromAssetAmount, toAssetAmount);\n }\n\n /***************************************\n Swap Config\n ****************************************/\n\n /**\n * @notice Set the contract the performs swaps of collateral assets.\n * @param _swapperAddr Address of the Swapper contract that implements the ISwapper interface.\n */\n function setSwapper(address _swapperAddr) external onlyGovernor {\n swapConfig.swapper = _swapperAddr;\n emit SwapperChanged(_swapperAddr);\n }\n\n /// @notice Contract that swaps the vault's collateral assets\n function swapper() external view returns (address swapper_) {\n swapper_ = swapConfig.swapper;\n }\n\n /**\n * @notice Set max allowed percentage the vault total value can drop below the OToken total supply in basis points\n * when executing collateral swaps.\n * @param _basis Percentage in basis points. eg 100 == 1%\n */\n function setSwapAllowedUndervalue(uint16 _basis) external onlyGovernor {\n require(_basis < 10001, \"Invalid basis points\");\n swapConfig.allowedUndervalueBps = _basis;\n emit SwapAllowedUndervalueChanged(_basis);\n }\n\n /**\n * @notice Max allowed percentage the vault total value can drop below the OToken total supply in basis points\n * when executing a collateral swap.\n * For example 100 == 1%\n * @return value Percentage in basis points.\n */\n function allowedSwapUndervalue() external view returns (uint256 value) {\n value = swapConfig.allowedUndervalueBps;\n }\n\n /**\n * @notice Set the allowed slippage from the Oracle price for collateral asset swaps.\n * @param _asset Address of the asset token.\n * @param _allowedOracleSlippageBps allowed slippage from Oracle in basis points. eg 20 = 0.2%. Max 10%.\n */\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\n external\n onlyGovernor\n {\n require(assets[_asset].isSupported, \"Asset not supported\");\n require(_allowedOracleSlippageBps < 1000, \"Slippage too high\");\n\n assets[_asset].allowedOracleSlippageBps = _allowedOracleSlippageBps;\n\n emit SwapSlippageChanged(_asset, _allowedOracleSlippageBps);\n }\n\n /***************************************\n Asset Config\n ****************************************/\n\n /**\n * @notice Add a supported asset to the contract, i.e. one that can be\n * to mint OTokens.\n * @param _asset Address of asset\n */\n function supportAsset(address _asset, uint8 _unitConversion)\n external\n onlyGovernor\n {\n require(!assets[_asset].isSupported, \"Asset already supported\");\n\n assets[_asset] = Asset({\n isSupported: true,\n unitConversion: UnitConversion(_unitConversion),\n decimals: 0, // will be overridden in _cacheDecimals\n allowedOracleSlippageBps: 0 // 0% by default\n });\n\n _cacheDecimals(_asset);\n allAssets.push(_asset);\n\n // Verify that our oracle supports the asset\n // slither-disable-next-line unused-return\n IOracle(priceProvider).price(_asset);\n\n emit AssetSupported(_asset);\n }\n\n /**\n * @notice Cache decimals on OracleRouter for a particular asset. This action\n * is required before that asset's price can be accessed.\n * @param _asset Address of asset token\n */\n function cacheDecimals(address _asset) external onlyGovernor {\n _cacheDecimals(_asset);\n }\n\n /***************************************\n Strategy Config\n ****************************************/\n\n /**\n * @notice Add a strategy to the Vault.\n * @param _addr Address of the strategy to add\n */\n function approveStrategy(address _addr) external onlyGovernor {\n require(!strategies[_addr].isSupported, \"Strategy already approved\");\n strategies[_addr] = Strategy({ isSupported: true, _deprecated: 0 });\n allStrategies.push(_addr);\n emit StrategyApproved(_addr);\n }\n\n /**\n * @notice Remove a strategy from the Vault.\n * @param _addr Address of the strategy to remove\n */\n\n function removeStrategy(address _addr) external onlyGovernor {\n require(strategies[_addr].isSupported, \"Strategy not approved\");\n\n uint256 assetCount = allAssets.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n require(\n assetDefaultStrategies[allAssets[i]] != _addr,\n \"Strategy is default for an asset\"\n );\n }\n\n // Initialize strategyIndex with out of bounds result so function will\n // revert if no valid index found\n uint256 stratCount = allStrategies.length;\n uint256 strategyIndex = stratCount;\n for (uint256 i = 0; i < stratCount; ++i) {\n if (allStrategies[i] == _addr) {\n strategyIndex = i;\n break;\n }\n }\n\n if (strategyIndex < stratCount) {\n allStrategies[strategyIndex] = allStrategies[stratCount - 1];\n allStrategies.pop();\n\n // Mark the strategy as not supported\n strategies[_addr].isSupported = false;\n\n // Withdraw all assets\n IStrategy strategy = IStrategy(_addr);\n strategy.withdrawAll();\n\n emit StrategyRemoved(_addr);\n }\n }\n\n /***************************************\n Strategies\n ****************************************/\n\n /**\n * @notice Deposit multiple assets from the vault into the strategy.\n * @param _strategyToAddress Address of the Strategy to deposit assets into.\n * @param _assets Array of asset address that will be deposited into the strategy.\n * @param _amounts Array of amounts of each corresponding asset to deposit.\n */\n function depositToStrategy(\n address _strategyToAddress,\n address[] calldata _assets,\n uint256[] calldata _amounts\n ) external onlyGovernorOrStrategist nonReentrant {\n _depositToStrategy(_strategyToAddress, _assets, _amounts);\n }\n\n function _depositToStrategy(\n address _strategyToAddress,\n address[] calldata _assets,\n uint256[] calldata _amounts\n ) internal {\n require(\n strategies[_strategyToAddress].isSupported,\n \"Invalid to Strategy\"\n );\n require(_assets.length == _amounts.length, \"Parameter length mismatch\");\n\n uint256 assetCount = _assets.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n address assetAddr = _assets[i];\n require(\n IStrategy(_strategyToAddress).supportsAsset(assetAddr),\n \"Asset unsupported\"\n );\n // Send required amount of funds to the strategy\n IERC20(assetAddr).safeTransfer(_strategyToAddress, _amounts[i]);\n }\n\n // Deposit all the funds that have been sent to the strategy\n IStrategy(_strategyToAddress).depositAll();\n }\n\n /**\n * @notice Withdraw multiple assets from the strategy to the vault.\n * @param _strategyFromAddress Address of the Strategy to withdraw assets from.\n * @param _assets Array of asset address that will be withdrawn from the strategy.\n * @param _amounts Array of amounts of each corresponding asset to withdraw.\n */\n function withdrawFromStrategy(\n address _strategyFromAddress,\n address[] calldata _assets,\n uint256[] calldata _amounts\n ) external onlyGovernorOrStrategist nonReentrant {\n _withdrawFromStrategy(\n address(this),\n _strategyFromAddress,\n _assets,\n _amounts\n );\n }\n\n /**\n * @param _recipient can either be a strategy or the Vault\n */\n function _withdrawFromStrategy(\n address _recipient,\n address _strategyFromAddress,\n address[] calldata _assets,\n uint256[] calldata _amounts\n ) internal {\n require(\n strategies[_strategyFromAddress].isSupported,\n \"Invalid from Strategy\"\n );\n require(_assets.length == _amounts.length, \"Parameter length mismatch\");\n\n uint256 assetCount = _assets.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n // Withdraw from Strategy to the recipient\n IStrategy(_strategyFromAddress).withdraw(\n _recipient,\n _assets[i],\n _amounts[i]\n );\n }\n }\n\n /**\n * @notice Sets the maximum allowable difference between\n * total supply and backing assets' value.\n */\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external onlyGovernor {\n maxSupplyDiff = _maxSupplyDiff;\n emit MaxSupplyDiffChanged(_maxSupplyDiff);\n }\n\n /**\n * @notice Sets the trusteeAddress that can receive a portion of yield.\n * Setting to the zero address disables this feature.\n */\n function setTrusteeAddress(address _address) external onlyGovernor {\n trusteeAddress = _address;\n emit TrusteeAddressChanged(_address);\n }\n\n /**\n * @notice Sets the TrusteeFeeBps to the percentage of yield that should be\n * received in basis points.\n */\n function setTrusteeFeeBps(uint256 _basis) external onlyGovernor {\n require(_basis <= 5000, \"basis cannot exceed 50%\");\n trusteeFeeBps = _basis;\n emit TrusteeFeeBpsChanged(_basis);\n }\n\n /**\n * @notice Set OToken Metapool strategy\n * @param _ousdMetaStrategy Address of OToken metapool strategy\n */\n function setOusdMetaStrategy(address _ousdMetaStrategy)\n external\n onlyGovernor\n {\n ousdMetaStrategy = _ousdMetaStrategy;\n emit OusdMetaStrategyUpdated(_ousdMetaStrategy);\n }\n\n /***************************************\n Pause\n ****************************************/\n\n /**\n * @notice Set the deposit paused flag to true to prevent rebasing.\n */\n function pauseRebase() external onlyGovernorOrStrategist {\n rebasePaused = true;\n emit RebasePaused();\n }\n\n /**\n * @notice Set the deposit paused flag to true to allow rebasing.\n */\n function unpauseRebase() external onlyGovernorOrStrategist {\n rebasePaused = false;\n emit RebaseUnpaused();\n }\n\n /**\n * @notice Set the deposit paused flag to true to prevent capital movement.\n */\n function pauseCapital() external onlyGovernorOrStrategist {\n capitalPaused = true;\n emit CapitalPaused();\n }\n\n /**\n * @notice Set the deposit paused flag to false to enable capital movement.\n */\n function unpauseCapital() external onlyGovernorOrStrategist {\n capitalPaused = false;\n emit CapitalUnpaused();\n }\n\n /***************************************\n Utils\n ****************************************/\n\n /**\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\n * contract, i.e. mistaken sends.\n * @param _asset Address for the asset\n * @param _amount Amount of the asset to transfer\n */\n function transferToken(address _asset, uint256 _amount)\n external\n onlyGovernor\n {\n require(!assets[_asset].isSupported, \"Only unsupported assets\");\n IERC20(_asset).safeTransfer(governor(), _amount);\n }\n\n /***************************************\n Strategies Admin\n ****************************************/\n\n /**\n * @notice Withdraws all assets from the strategy and sends assets to the Vault.\n * @param _strategyAddr Strategy address.\n */\n function withdrawAllFromStrategy(address _strategyAddr)\n external\n onlyGovernorOrStrategist\n {\n require(\n strategies[_strategyAddr].isSupported,\n \"Strategy is not supported\"\n );\n IStrategy strategy = IStrategy(_strategyAddr);\n strategy.withdrawAll();\n }\n\n /**\n * @notice Withdraws all assets from all the strategies and sends assets to the Vault.\n */\n function withdrawAllFromStrategies() external onlyGovernorOrStrategist {\n uint256 stratCount = allStrategies.length;\n for (uint256 i = 0; i < stratCount; ++i) {\n IStrategy(allStrategies[i]).withdrawAll();\n }\n }\n\n /***************************************\n Utils\n ****************************************/\n\n function _cacheDecimals(address token) internal {\n Asset storage tokenAsset = assets[token];\n if (tokenAsset.decimals != 0) {\n return;\n }\n uint8 decimals = IBasicToken(token).decimals();\n require(decimals >= 6 && decimals <= 18, \"Unexpected precision\");\n tokenAsset.decimals = decimals;\n }\n}\n" + }, + "contracts/vault/VaultCore.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OToken VaultCore contract\n * @notice The Vault contract stores assets. On a deposit, OTokens will be minted\n and sent to the depositor. On a withdrawal, OTokens will be burned and\n assets will be sent to the withdrawer. The Vault accepts deposits of\n interest from yield bearing strategies which will modify the supply\n of OTokens.\n * @author Origin Protocol Inc\n */\n\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\nimport { StableMath } from \"../utils/StableMath.sol\";\nimport { IOracle } from \"../interfaces/IOracle.sol\";\nimport { IGetExchangeRateToken } from \"../interfaces/IGetExchangeRateToken.sol\";\n\nimport \"./VaultInitializer.sol\";\n\ncontract VaultCore is VaultInitializer {\n using SafeERC20 for IERC20;\n using StableMath for uint256;\n // max signed int\n uint256 internal constant MAX_INT = 2**255 - 1;\n // max un-signed int\n uint256 internal constant MAX_UINT =\n 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;\n\n /**\n * @dev Verifies that the rebasing is not paused.\n */\n modifier whenNotRebasePaused() {\n require(!rebasePaused, \"Rebasing paused\");\n _;\n }\n\n /**\n * @dev Verifies that the deposits are not paused.\n */\n modifier whenNotCapitalPaused() {\n require(!capitalPaused, \"Capital paused\");\n _;\n }\n\n modifier onlyOusdMetaStrategy() {\n require(\n msg.sender == ousdMetaStrategy,\n \"Caller is not the OUSD meta strategy\"\n );\n _;\n }\n\n /**\n * @notice Deposit a supported asset and mint OTokens.\n * @param _asset Address of the asset being deposited\n * @param _amount Amount of the asset being deposited\n * @param _minimumOusdAmount Minimum OTokens to mint\n */\n function mint(\n address _asset,\n uint256 _amount,\n uint256 _minimumOusdAmount\n ) external whenNotCapitalPaused nonReentrant {\n _mint(_asset, _amount, _minimumOusdAmount);\n }\n\n function _mint(\n address _asset,\n uint256 _amount,\n uint256 _minimumOusdAmount\n ) internal virtual {\n require(assets[_asset].isSupported, \"Asset is not supported\");\n require(_amount > 0, \"Amount must be greater than 0\");\n\n uint256 units = _toUnits(_amount, _asset);\n uint256 unitPrice = _toUnitPrice(_asset, true);\n uint256 priceAdjustedDeposit = (units * unitPrice) / 1e18;\n\n if (_minimumOusdAmount > 0) {\n require(\n priceAdjustedDeposit >= _minimumOusdAmount,\n \"Mint amount lower than minimum\"\n );\n }\n\n emit Mint(msg.sender, priceAdjustedDeposit);\n\n // Rebase must happen before any transfers occur.\n if (priceAdjustedDeposit >= rebaseThreshold && !rebasePaused) {\n _rebase();\n }\n\n // Mint matching amount of OTokens\n oUSD.mint(msg.sender, priceAdjustedDeposit);\n\n // Transfer the deposited coins to the vault\n IERC20 asset = IERC20(_asset);\n asset.safeTransferFrom(msg.sender, address(this), _amount);\n\n if (priceAdjustedDeposit >= autoAllocateThreshold) {\n _allocate();\n }\n }\n\n /**\n * @notice Mint OTokens for a Metapool Strategy\n * @param _amount Amount of the asset being deposited\n *\n * Notice: can't use `nonReentrant` modifier since the `mint` function can\n * call `allocate`, and that can trigger `ConvexOUSDMetaStrategy` to call this function\n * while the execution of the `mint` has not yet completed -> causing a `nonReentrant` collision.\n *\n * Also important to understand is that this is a limitation imposed by the test suite.\n * Production / mainnet contracts should never be configured in a way where mint/redeem functions\n * that are moving funds between the Vault and end user wallets can influence strategies\n * utilizing this function.\n */\n function mintForStrategy(uint256 _amount)\n external\n whenNotCapitalPaused\n onlyOusdMetaStrategy\n {\n require(_amount < MAX_INT, \"Amount too high\");\n\n emit Mint(msg.sender, _amount);\n\n // safe to cast because of the require check at the beginning of the function\n netOusdMintedForStrategy += int256(_amount);\n\n require(\n abs(netOusdMintedForStrategy) < netOusdMintForStrategyThreshold,\n \"Minted ousd surpassed netOusdMintForStrategyThreshold.\"\n );\n\n // Mint matching amount of OTokens\n oUSD.mint(msg.sender, _amount);\n }\n\n // In memoriam\n\n /**\n * @notice Withdraw a supported asset and burn OTokens.\n * @param _amount Amount of OTokens to burn\n * @param _minimumUnitAmount Minimum stablecoin units to receive in return\n */\n function redeem(uint256 _amount, uint256 _minimumUnitAmount)\n external\n whenNotCapitalPaused\n nonReentrant\n {\n _redeem(_amount, _minimumUnitAmount);\n }\n\n /**\n * @notice Withdraw a supported asset and burn OTokens.\n * @param _amount Amount of OTokens to burn\n * @param _minimumUnitAmount Minimum stablecoin units to receive in return\n */\n function _redeem(uint256 _amount, uint256 _minimumUnitAmount)\n internal\n virtual\n {\n // Calculate redemption outputs\n uint256[] memory outputs = _calculateRedeemOutputs(_amount);\n\n emit Redeem(msg.sender, _amount);\n\n // Send outputs\n uint256 assetCount = allAssets.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n if (outputs[i] == 0) continue;\n\n address assetAddr = allAssets[i];\n\n if (IERC20(assetAddr).balanceOf(address(this)) >= outputs[i]) {\n // Use Vault funds first if sufficient\n IERC20(assetAddr).safeTransfer(msg.sender, outputs[i]);\n } else {\n address strategyAddr = assetDefaultStrategies[assetAddr];\n if (strategyAddr != address(0)) {\n // Nothing in Vault, but something in Strategy, send from there\n IStrategy strategy = IStrategy(strategyAddr);\n strategy.withdraw(msg.sender, assetAddr, outputs[i]);\n } else {\n // Cant find funds anywhere\n revert(\"Liquidity error\");\n }\n }\n }\n\n if (_minimumUnitAmount > 0) {\n uint256 unitTotal = 0;\n for (uint256 i = 0; i < outputs.length; ++i) {\n unitTotal += _toUnits(outputs[i], allAssets[i]);\n }\n require(\n unitTotal >= _minimumUnitAmount,\n \"Redeem amount lower than minimum\"\n );\n }\n\n oUSD.burn(msg.sender, _amount);\n\n _postRedeem(_amount);\n }\n\n function _postRedeem(uint256 _amount) internal {\n // Until we can prove that we won't affect the prices of our assets\n // by withdrawing them, this should be here.\n // It's possible that a strategy was off on its asset total, perhaps\n // a reward token sold for more or for less than anticipated.\n uint256 totalUnits = 0;\n if (_amount >= rebaseThreshold && !rebasePaused) {\n totalUnits = _rebase();\n } else {\n totalUnits = _totalValue();\n }\n\n // Check that the OTokens are backed by enough assets\n if (maxSupplyDiff > 0) {\n // Allow a max difference of maxSupplyDiff% between\n // backing assets value and OUSD total supply\n uint256 diff = oUSD.totalSupply().divPrecisely(totalUnits);\n require(\n (diff > 1e18 ? diff - 1e18 : 1e18 - diff) <= maxSupplyDiff,\n \"Backing supply liquidity error\"\n );\n }\n }\n\n /**\n * @notice Burn OTokens for Metapool Strategy\n * @param _amount Amount of OUSD to burn\n *\n * @dev Notice: can't use `nonReentrant` modifier since the `redeem` function could\n * require withdrawal on `ConvexOUSDMetaStrategy` and that one can call `burnForStrategy`\n * while the execution of the `redeem` has not yet completed -> causing a `nonReentrant` collision.\n *\n * Also important to understand is that this is a limitation imposed by the test suite.\n * Production / mainnet contracts should never be configured in a way where mint/redeem functions\n * that are moving funds between the Vault and end user wallets can influence strategies\n * utilizing this function.\n */\n function burnForStrategy(uint256 _amount)\n external\n whenNotCapitalPaused\n onlyOusdMetaStrategy\n {\n require(_amount < MAX_INT, \"Amount too high\");\n\n emit Redeem(msg.sender, _amount);\n\n // safe to cast because of the require check at the beginning of the function\n netOusdMintedForStrategy -= int256(_amount);\n\n require(\n abs(netOusdMintedForStrategy) < netOusdMintForStrategyThreshold,\n \"Attempting to burn too much OUSD.\"\n );\n\n // Burn OTokens\n oUSD.burn(msg.sender, _amount);\n }\n\n /**\n * @notice Withdraw a supported asset and burn all OTokens.\n * @param _minimumUnitAmount Minimum stablecoin units to receive in return\n */\n function redeemAll(uint256 _minimumUnitAmount)\n external\n whenNotCapitalPaused\n nonReentrant\n {\n _redeem(oUSD.balanceOf(msg.sender), _minimumUnitAmount);\n }\n\n /**\n * @notice Allocate unallocated funds on Vault to strategies.\n **/\n function allocate() external whenNotCapitalPaused nonReentrant {\n _allocate();\n }\n\n /**\n * @dev Allocate unallocated funds on Vault to strategies.\n **/\n function _allocate() internal {\n uint256 vaultValue = _totalValueInVault();\n // Nothing in vault to allocate\n if (vaultValue == 0) return;\n uint256 strategiesValue = _totalValueInStrategies();\n // We have a method that does the same as this, gas optimisation\n uint256 calculatedTotalValue = vaultValue + strategiesValue;\n\n // We want to maintain a buffer on the Vault so calculate a percentage\n // modifier to multiply each amount being allocated by to enforce the\n // vault buffer\n uint256 vaultBufferModifier;\n if (strategiesValue == 0) {\n // Nothing in Strategies, allocate 100% minus the vault buffer to\n // strategies\n vaultBufferModifier = uint256(1e18) - vaultBuffer;\n } else {\n vaultBufferModifier =\n (vaultBuffer * calculatedTotalValue) /\n vaultValue;\n if (1e18 > vaultBufferModifier) {\n // E.g. 1e18 - (1e17 * 10e18)/5e18 = 8e17\n // (5e18 * 8e17) / 1e18 = 4e18 allocated from Vault\n vaultBufferModifier = uint256(1e18) - vaultBufferModifier;\n } else {\n // We need to let the buffer fill\n return;\n }\n }\n if (vaultBufferModifier == 0) return;\n\n // Iterate over all assets in the Vault and allocate to the appropriate\n // strategy\n uint256 assetCount = allAssets.length;\n for (uint256 i = 0; i < assetCount; ++i) {\n IERC20 asset = IERC20(allAssets[i]);\n uint256 assetBalance = asset.balanceOf(address(this));\n // No balance, nothing to do here\n if (assetBalance == 0) continue;\n\n // Multiply the balance by the vault buffer modifier and truncate\n // to the scale of the asset decimals\n uint256 allocateAmount = assetBalance.mulTruncate(\n vaultBufferModifier\n );\n\n address depositStrategyAddr = assetDefaultStrategies[\n address(asset)\n ];\n\n if (depositStrategyAddr != address(0) && allocateAmount > 0) {\n IStrategy strategy = IStrategy(depositStrategyAddr);\n // Transfer asset to Strategy and call deposit method to\n // mint or take required action\n asset.safeTransfer(address(strategy), allocateAmount);\n strategy.deposit(address(asset), allocateAmount);\n emit AssetAllocated(\n address(asset),\n depositStrategyAddr,\n allocateAmount\n );\n }\n }\n }\n\n /**\n * @notice Calculate the total value of assets held by the Vault and all\n * strategies and update the supply of OTokens.\n */\n function rebase() external virtual nonReentrant {\n _rebase();\n }\n\n /**\n * @dev Calculate the total value of assets held by the Vault and all\n * strategies and update the supply of OTokens, optionally sending a\n * portion of the yield to the trustee.\n * @return totalUnits Total balance of Vault in units\n */\n function _rebase() internal whenNotRebasePaused returns (uint256) {\n uint256 ousdSupply = oUSD.totalSupply();\n uint256 vaultValue = _totalValue();\n if (ousdSupply == 0) {\n return vaultValue;\n }\n\n // Yield fee collection\n address _trusteeAddress = trusteeAddress; // gas savings\n if (_trusteeAddress != address(0) && (vaultValue > ousdSupply)) {\n uint256 yield = vaultValue - ousdSupply;\n uint256 fee = yield.mulTruncateScale(trusteeFeeBps, 1e4);\n require(yield > fee, \"Fee must not be greater than yield\");\n if (fee > 0) {\n oUSD.mint(_trusteeAddress, fee);\n }\n emit YieldDistribution(_trusteeAddress, yield, fee);\n }\n\n // Only rachet OToken supply upwards\n ousdSupply = oUSD.totalSupply(); // Final check should use latest value\n if (vaultValue > ousdSupply) {\n oUSD.changeSupply(vaultValue);\n }\n return vaultValue;\n }\n\n /**\n * @notice Determine the total value of assets held by the vault and its\n * strategies.\n * @return value Total value in USD/ETH (1e18)\n */\n function totalValue() external view virtual returns (uint256 value) {\n value = _totalValue();\n }\n\n /**\n * @dev Internal Calculate the total value of the assets held by the\n * vault and its strategies.\n * @return value Total value in USD/ETH (1e18)\n */\n function _totalValue() internal view virtual returns (uint256 value) {\n return _totalValueInVault() + _totalValueInStrategies();\n }\n\n /**\n * @dev Internal to calculate total value of all assets held in Vault.\n * @return value Total value in USD/ETH (1e18)\n */\n function _totalValueInVault() internal view returns (uint256 value) {\n uint256 assetCount = allAssets.length;\n for (uint256 y = 0; y < assetCount; ++y) {\n address assetAddr = allAssets[y];\n uint256 balance = IERC20(assetAddr).balanceOf(address(this));\n if (balance > 0) {\n value += _toUnits(balance, assetAddr);\n }\n }\n }\n\n /**\n * @dev Internal to calculate total value of all assets held in Strategies.\n * @return value Total value in USD/ETH (1e18)\n */\n function _totalValueInStrategies() internal view returns (uint256 value) {\n uint256 stratCount = allStrategies.length;\n for (uint256 i = 0; i < stratCount; ++i) {\n value = value + _totalValueInStrategy(allStrategies[i]);\n }\n }\n\n /**\n * @dev Internal to calculate total value of all assets held by strategy.\n * @param _strategyAddr Address of the strategy\n * @return value Total value in USD/ETH (1e18)\n */\n function _totalValueInStrategy(address _strategyAddr)\n internal\n view\n returns (uint256 value)\n {\n IStrategy strategy = IStrategy(_strategyAddr);\n uint256 assetCount = allAssets.length;\n for (uint256 y = 0; y < assetCount; ++y) {\n address assetAddr = allAssets[y];\n if (strategy.supportsAsset(assetAddr)) {\n uint256 balance = strategy.checkBalance(assetAddr);\n if (balance > 0) {\n value += _toUnits(balance, assetAddr);\n }\n }\n }\n }\n\n /**\n * @notice Get the balance of an asset held in Vault and all strategies.\n * @param _asset Address of asset\n * @return uint256 Balance of asset in decimals of asset\n */\n function checkBalance(address _asset) external view returns (uint256) {\n return _checkBalance(_asset);\n }\n\n /**\n * @notice Get the balance of an asset held in Vault and all strategies.\n * @param _asset Address of asset\n * @return balance Balance of asset in decimals of asset\n */\n function _checkBalance(address _asset)\n internal\n view\n virtual\n returns (uint256 balance)\n {\n IERC20 asset = IERC20(_asset);\n balance = asset.balanceOf(address(this));\n uint256 stratCount = allStrategies.length;\n for (uint256 i = 0; i < stratCount; ++i) {\n IStrategy strategy = IStrategy(allStrategies[i]);\n if (strategy.supportsAsset(_asset)) {\n balance = balance + strategy.checkBalance(_asset);\n }\n }\n }\n\n /**\n * @notice Calculate the outputs for a redeem function, i.e. the mix of\n * coins that will be returned\n */\n function calculateRedeemOutputs(uint256 _amount)\n external\n view\n returns (uint256[] memory)\n {\n return _calculateRedeemOutputs(_amount);\n }\n\n /**\n * @dev Calculate the outputs for a redeem function, i.e. the mix of\n * coins that will be returned.\n * @return outputs Array of amounts respective to the supported assets\n */\n function _calculateRedeemOutputs(uint256 _amount)\n internal\n view\n virtual\n returns (uint256[] memory outputs)\n {\n // We always give out coins in proportion to how many we have,\n // Now if all coins were the same value, this math would easy,\n // just take the percentage of each coin, and multiply by the\n // value to be given out. But if coins are worth more than $1,\n // then we would end up handing out too many coins. We need to\n // adjust by the total value of coins.\n //\n // To do this, we total up the value of our coins, by their\n // percentages. Then divide what we would otherwise give out by\n // this number.\n //\n // Let say we have 100 DAI at $1.06 and 200 USDT at $1.00.\n // So for every 1 DAI we give out, we'll be handing out 2 USDT\n // Our total output ratio is: 33% * 1.06 + 66% * 1.00 = 1.02\n //\n // So when calculating the output, we take the percentage of\n // each coin, times the desired output value, divided by the\n // totalOutputRatio.\n //\n // For example, withdrawing: 30 OUSD:\n // DAI 33% * 30 / 1.02 = 9.80 DAI\n // USDT = 66 % * 30 / 1.02 = 19.60 USDT\n //\n // Checking these numbers:\n // 9.80 DAI * 1.06 = $10.40\n // 19.60 USDT * 1.00 = $19.60\n //\n // And so the user gets $10.40 + $19.60 = $30 worth of value.\n\n uint256 assetCount = allAssets.length;\n uint256[] memory assetUnits = new uint256[](assetCount);\n uint256[] memory assetBalances = new uint256[](assetCount);\n outputs = new uint256[](assetCount);\n\n // Calculate redeem fee\n if (redeemFeeBps > 0) {\n uint256 redeemFee = _amount.mulTruncateScale(redeemFeeBps, 1e4);\n _amount = _amount - redeemFee;\n }\n\n // Calculate assets balances and decimals once,\n // for a large gas savings.\n uint256 totalUnits = 0;\n for (uint256 i = 0; i < assetCount; ++i) {\n address assetAddr = allAssets[i];\n uint256 balance = _checkBalance(assetAddr);\n assetBalances[i] = balance;\n assetUnits[i] = _toUnits(balance, assetAddr);\n totalUnits = totalUnits + assetUnits[i];\n }\n // Calculate totalOutputRatio\n uint256 totalOutputRatio = 0;\n for (uint256 i = 0; i < assetCount; ++i) {\n uint256 unitPrice = _toUnitPrice(allAssets[i], false);\n uint256 ratio = (assetUnits[i] * unitPrice) / totalUnits;\n totalOutputRatio = totalOutputRatio + ratio;\n }\n // Calculate final outputs\n uint256 factor = _amount.divPrecisely(totalOutputRatio);\n for (uint256 i = 0; i < assetCount; ++i) {\n outputs[i] = (assetBalances[i] * factor) / totalUnits;\n }\n }\n\n /***************************************\n Pricing\n ****************************************/\n\n /**\n * @notice Returns the total price in 18 digit units for a given asset.\n * Never goes above 1, since that is how we price mints.\n * @param asset address of the asset\n * @return price uint256: unit (USD / ETH) price for 1 unit of the asset, in 18 decimal fixed\n */\n function priceUnitMint(address asset)\n external\n view\n returns (uint256 price)\n {\n /* need to supply 1 asset unit in asset's decimals and can not just hard-code\n * to 1e18 and ignore calling `_toUnits` since we need to consider assets\n * with the exchange rate\n */\n uint256 units = _toUnits(\n uint256(1e18).scaleBy(_getDecimals(asset), 18),\n asset\n );\n price = (_toUnitPrice(asset, true) * units) / 1e18;\n }\n\n /**\n * @notice Returns the total price in 18 digit unit for a given asset.\n * Never goes below 1, since that is how we price redeems\n * @param asset Address of the asset\n * @return price uint256: unit (USD / ETH) price for 1 unit of the asset, in 18 decimal fixed\n */\n function priceUnitRedeem(address asset)\n external\n view\n returns (uint256 price)\n {\n /* need to supply 1 asset unit in asset's decimals and can not just hard-code\n * to 1e18 and ignore calling `_toUnits` since we need to consider assets\n * with the exchange rate\n */\n uint256 units = _toUnits(\n uint256(1e18).scaleBy(_getDecimals(asset), 18),\n asset\n );\n price = (_toUnitPrice(asset, false) * units) / 1e18;\n }\n\n /***************************************\n Utils\n ****************************************/\n\n /**\n * @dev Convert a quantity of a token into 1e18 fixed decimal \"units\"\n * in the underlying base (USD/ETH) used by the vault.\n * Price is not taken into account, only quantity.\n *\n * Examples of this conversion:\n *\n * - 1e18 DAI becomes 1e18 units (same decimals)\n * - 1e6 USDC becomes 1e18 units (decimal conversion)\n * - 1e18 rETH becomes 1.2e18 units (exchange rate conversion)\n *\n * @param _raw Quantity of asset\n * @param _asset Core Asset address\n * @return value 1e18 normalized quantity of units\n */\n function _toUnits(uint256 _raw, address _asset)\n internal\n view\n returns (uint256)\n {\n UnitConversion conversion = assets[_asset].unitConversion;\n if (conversion == UnitConversion.DECIMALS) {\n return _raw.scaleBy(18, _getDecimals(_asset));\n } else if (conversion == UnitConversion.GETEXCHANGERATE) {\n uint256 exchangeRate = IGetExchangeRateToken(_asset)\n .getExchangeRate();\n return (_raw * exchangeRate) / 1e18;\n } else {\n revert(\"Unsupported conversion type\");\n }\n }\n\n /**\n * @dev Returns asset's unit price accounting for different asset types\n * and takes into account the context in which that price exists -\n * - mint or redeem.\n *\n * Note: since we are returning the price of the unit and not the one of the\n * asset (see comment above how 1 rETH exchanges for 1.2 units) we need\n * to make the Oracle price adjustment as well since we are pricing the\n * units and not the assets.\n *\n * The price also snaps to a \"full unit price\" in case a mint or redeem\n * action would be unfavourable to the protocol.\n *\n */\n function _toUnitPrice(address _asset, bool isMint)\n internal\n view\n returns (uint256 price)\n {\n UnitConversion conversion = assets[_asset].unitConversion;\n price = IOracle(priceProvider).price(_asset);\n\n if (conversion == UnitConversion.GETEXCHANGERATE) {\n uint256 exchangeRate = IGetExchangeRateToken(_asset)\n .getExchangeRate();\n price = (price * 1e18) / exchangeRate;\n } else if (conversion != UnitConversion.DECIMALS) {\n revert(\"Unsupported conversion type\");\n }\n\n /* At this stage the price is already adjusted to the unit\n * so the price checks are agnostic to underlying asset being\n * pegged to a USD or to an ETH or having a custom exchange rate.\n */\n require(price <= MAX_UNIT_PRICE_DRIFT, \"Vault: Price exceeds max\");\n require(price >= MIN_UNIT_PRICE_DRIFT, \"Vault: Price under min\");\n\n if (isMint) {\n /* Never price a normalized unit price for more than one\n * unit of OETH/OUSD when minting.\n */\n if (price > 1e18) {\n price = 1e18;\n }\n require(price >= MINT_MINIMUM_UNIT_PRICE, \"Asset price below peg\");\n } else {\n /* Never give out more than 1 normalized unit amount of assets\n * for one unit of OETH/OUSD when redeeming.\n */\n if (price < 1e18) {\n price = 1e18;\n }\n }\n }\n\n function _getDecimals(address _asset)\n internal\n view\n returns (uint256 decimals)\n {\n decimals = assets[_asset].decimals;\n require(decimals > 0, \"Decimals not cached\");\n }\n\n /**\n * @notice Return the number of assets supported by the Vault.\n */\n function getAssetCount() public view returns (uint256) {\n return allAssets.length;\n }\n\n /**\n * @notice Gets the vault configuration of a supported asset.\n */\n function getAssetConfig(address _asset)\n public\n view\n returns (Asset memory config)\n {\n config = assets[_asset];\n }\n\n /**\n * @notice Return all vault asset addresses in order\n */\n function getAllAssets() external view returns (address[] memory) {\n return allAssets;\n }\n\n /**\n * @notice Return the number of strategies active on the Vault.\n */\n function getStrategyCount() external view returns (uint256) {\n return allStrategies.length;\n }\n\n /**\n * @notice Return the array of all strategies\n */\n function getAllStrategies() external view returns (address[] memory) {\n return allStrategies;\n }\n\n /**\n * @notice Returns whether the vault supports the asset\n * @param _asset address of the asset\n * @return true if supported\n */\n function isSupportedAsset(address _asset) external view returns (bool) {\n return assets[_asset].isSupported;\n }\n\n /**\n * @dev Falldown to the admin implementation\n * @notice This is a catch all for all functions not declared in core\n */\n // solhint-disable-next-line no-complex-fallback\n fallback() external {\n bytes32 slot = adminImplPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n // Copy msg.data. We take full control of memory in this inline assembly\n // block because it will not return to Solidity code. We overwrite the\n // Solidity scratch pad at memory position 0.\n calldatacopy(0, 0, calldatasize())\n\n // Call the implementation.\n // out and outsize are 0 because we don't know the size yet.\n let result := delegatecall(\n gas(),\n sload(slot),\n 0,\n calldatasize(),\n 0,\n 0\n )\n\n // Copy the returned data.\n returndatacopy(0, 0, returndatasize())\n\n switch result\n // delegatecall returns 0 on error.\n case 0 {\n revert(0, returndatasize())\n }\n default {\n return(0, returndatasize())\n }\n }\n }\n\n function abs(int256 x) private pure returns (uint256) {\n require(x < int256(MAX_INT), \"Amount too high\");\n return x >= 0 ? uint256(x) : uint256(-x);\n }\n}\n" + }, + "contracts/vault/VaultInitializer.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OToken VaultInitializer contract\n * @notice The Vault contract initializes the vault.\n * @author Origin Protocol Inc\n */\n\nimport \"./VaultStorage.sol\";\n\ncontract VaultInitializer is VaultStorage {\n function initialize(address _priceProvider, address _oToken)\n external\n onlyGovernor\n initializer\n {\n require(_priceProvider != address(0), \"PriceProvider address is zero\");\n require(_oToken != address(0), \"oToken address is zero\");\n\n oUSD = OUSD(_oToken);\n\n priceProvider = _priceProvider;\n\n rebasePaused = false;\n capitalPaused = true;\n\n // Initial redeem fee of 0 basis points\n redeemFeeBps = 0;\n // Initial Vault buffer of 0%\n vaultBuffer = 0;\n // Initial allocate threshold of 25,000 OUSD\n autoAllocateThreshold = 25000e18;\n // Threshold for rebasing\n rebaseThreshold = 1000e18;\n // Initialize all strategies\n allStrategies = new address[](0);\n }\n}\n" + }, + "contracts/vault/VaultStorage.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title OToken VaultStorage contract\n * @notice The VaultStorage contract defines the storage for the Vault contracts\n * @author Origin Protocol Inc\n */\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { Address } from \"@openzeppelin/contracts/utils/Address.sol\";\n\nimport { IStrategy } from \"../interfaces/IStrategy.sol\";\nimport { Governable } from \"../governance/Governable.sol\";\nimport { OUSD } from \"../token/OUSD.sol\";\nimport { Initializable } from \"../utils/Initializable.sol\";\nimport \"../utils/Helpers.sol\";\n\ncontract VaultStorage is Initializable, Governable {\n using SafeERC20 for IERC20;\n\n event AssetSupported(address _asset);\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\n event StrategyApproved(address _addr);\n event StrategyRemoved(address _addr);\n event Mint(address _addr, uint256 _value);\n event Redeem(address _addr, uint256 _value);\n event CapitalPaused();\n event CapitalUnpaused();\n event RebasePaused();\n event RebaseUnpaused();\n event VaultBufferUpdated(uint256 _vaultBuffer);\n event OusdMetaStrategyUpdated(address _ousdMetaStrategy);\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\n event PriceProviderUpdated(address _priceProvider);\n event AllocateThresholdUpdated(uint256 _threshold);\n event RebaseThresholdUpdated(uint256 _threshold);\n event StrategistUpdated(address _address);\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\n event TrusteeFeeBpsChanged(uint256 _basis);\n event TrusteeAddressChanged(address _address);\n event NetOusdMintForStrategyThresholdChanged(uint256 _threshold);\n event SwapperChanged(address _address);\n event SwapAllowedUndervalueChanged(uint256 _basis);\n event SwapSlippageChanged(address _asset, uint256 _basis);\n event Swapped(\n address indexed _fromAsset,\n address indexed _toAsset,\n uint256 _fromAssetAmount,\n uint256 _toAssetAmount\n );\n\n // Assets supported by the Vault, i.e. Stablecoins\n enum UnitConversion {\n DECIMALS,\n GETEXCHANGERATE\n }\n // Changed to fit into a single storage slot so the decimals needs to be recached\n struct Asset {\n // Note: OETHVaultCore doesn't use `isSupported` when minting,\n // redeeming or checking balance of assets.\n bool isSupported;\n UnitConversion unitConversion;\n uint8 decimals;\n // Max allowed slippage from the Oracle price when swapping collateral assets in basis points.\n // For example 40 == 0.4% slippage\n uint16 allowedOracleSlippageBps;\n }\n\n /// @dev mapping of supported vault assets to their configuration\n // slither-disable-next-line uninitialized-state\n mapping(address => Asset) internal assets;\n /// @dev list of all assets supported by the vault.\n // slither-disable-next-line uninitialized-state\n address[] internal allAssets;\n\n // Strategies approved for use by the Vault\n struct Strategy {\n bool isSupported;\n uint256 _deprecated; // Deprecated storage slot\n }\n /// @dev mapping of strategy contracts to their configiration\n mapping(address => Strategy) internal strategies;\n /// @dev list of all vault strategies\n address[] internal allStrategies;\n\n /// @notice Address of the Oracle price provider contract\n // slither-disable-next-line uninitialized-state\n address public priceProvider;\n /// @notice pause rebasing if true\n bool public rebasePaused = false;\n /// @notice pause operations that change the OToken supply.\n /// eg mint, redeem, allocate, mint/burn for strategy\n bool public capitalPaused = true;\n /// @notice Redemption fee in basis points. eg 50 = 0.5%\n uint256 public redeemFeeBps;\n /// @notice Percentage of assets to keep in Vault to handle (most) withdrawals. 100% = 1e18.\n uint256 public vaultBuffer;\n /// @notice OToken mints over this amount automatically allocate funds. 18 decimals.\n uint256 public autoAllocateThreshold;\n /// @notice OToken mints over this amount automatically rebase. 18 decimals.\n uint256 public rebaseThreshold;\n\n /// @dev Address of the OToken token. eg OUSD or OETH.\n // slither-disable-next-line uninitialized-state\n OUSD internal oUSD;\n\n //keccak256(\"OUSD.vault.governor.admin.impl\");\n bytes32 constant adminImplPosition =\n 0xa2bd3d3cf188a41358c8b401076eb59066b09dec5775650c0de4c55187d17bd9;\n\n // Address of the contract responsible for post rebase syncs with AMMs\n address private _deprecated_rebaseHooksAddr = address(0);\n\n // Deprecated: Address of Uniswap\n // slither-disable-next-line constable-states\n address private _deprecated_uniswapAddr = address(0);\n\n /// @notice Address of the Strategist\n address public strategistAddr = address(0);\n\n /// @notice Mapping of asset address to the Strategy that they should automatically\n // be allocated to\n // slither-disable-next-line uninitialized-state\n mapping(address => address) public assetDefaultStrategies;\n\n /// @notice Max difference between total supply and total value of assets. 18 decimals.\n // slither-disable-next-line uninitialized-state\n uint256 public maxSupplyDiff;\n\n /// @notice Trustee contract that can collect a percentage of yield\n address public trusteeAddress;\n\n /// @notice Amount of yield collected in basis points. eg 2000 = 20%\n uint256 public trusteeFeeBps;\n\n /// @dev Deprecated: Tokens that should be swapped for stablecoins\n address[] private _deprecated_swapTokens;\n\n uint256 constant MINT_MINIMUM_UNIT_PRICE = 0.998e18;\n\n /// @notice Metapool strategy that is allowed to mint/burn OTokens without changing collateral\n address public ousdMetaStrategy = address(0);\n\n /// @notice How much OTokens are currently minted by the strategy\n int256 public netOusdMintedForStrategy = 0;\n\n /// @notice How much net total OTokens are allowed to be minted by all strategies\n uint256 public netOusdMintForStrategyThreshold = 0;\n\n uint256 constant MIN_UNIT_PRICE_DRIFT = 0.7e18;\n uint256 constant MAX_UNIT_PRICE_DRIFT = 1.3e18;\n\n /// @notice Collateral swap configuration.\n /// @dev is packed into a single storage slot to save gas.\n struct SwapConfig {\n // Contract that swaps the vault's collateral assets\n address swapper;\n // Max allowed percentage the total value can drop below the total supply in basis points.\n // For example 100 == 1%\n uint16 allowedUndervalueBps;\n }\n SwapConfig internal swapConfig = SwapConfig(address(0), 0);\n\n // For future use\n uint256[50] private __gap;\n\n /**\n * @notice set the implementation for the admin, this needs to be in a base class else we cannot set it\n * @param newImpl address of the implementation\n */\n function setAdminImpl(address newImpl) external onlyGovernor {\n require(\n Address.isContract(newImpl),\n \"new implementation is not a contract\"\n );\n bytes32 position = adminImplPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, newImpl)\n }\n }\n}\n" + }, + "hardhat/console.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity >= 0.4.22 <0.9.0;\n\nlibrary console {\n\taddress constant CONSOLE_ADDRESS = address(0x000000000000000000636F6e736F6c652e6c6f67);\n\n\tfunction _sendLogPayload(bytes memory payload) private view {\n\t\tuint256 payloadLength = payload.length;\n\t\taddress consoleAddress = CONSOLE_ADDRESS;\n\t\tassembly {\n\t\t\tlet payloadStart := add(payload, 32)\n\t\t\tlet r := staticcall(gas(), consoleAddress, payloadStart, payloadLength, 0, 0)\n\t\t}\n\t}\n\n\tfunction log() internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log()\"));\n\t}\n\n\tfunction logInt(int256 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(int256)\", p0));\n\t}\n\n\tfunction logUint(uint256 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256)\", p0));\n\t}\n\n\tfunction logString(string memory p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string)\", p0));\n\t}\n\n\tfunction logBool(bool p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool)\", p0));\n\t}\n\n\tfunction logAddress(address p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address)\", p0));\n\t}\n\n\tfunction logBytes(bytes memory p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes)\", p0));\n\t}\n\n\tfunction logBytes1(bytes1 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes1)\", p0));\n\t}\n\n\tfunction logBytes2(bytes2 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes2)\", p0));\n\t}\n\n\tfunction logBytes3(bytes3 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes3)\", p0));\n\t}\n\n\tfunction logBytes4(bytes4 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes4)\", p0));\n\t}\n\n\tfunction logBytes5(bytes5 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes5)\", p0));\n\t}\n\n\tfunction logBytes6(bytes6 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes6)\", p0));\n\t}\n\n\tfunction logBytes7(bytes7 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes7)\", p0));\n\t}\n\n\tfunction logBytes8(bytes8 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes8)\", p0));\n\t}\n\n\tfunction logBytes9(bytes9 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes9)\", p0));\n\t}\n\n\tfunction logBytes10(bytes10 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes10)\", p0));\n\t}\n\n\tfunction logBytes11(bytes11 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes11)\", p0));\n\t}\n\n\tfunction logBytes12(bytes12 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes12)\", p0));\n\t}\n\n\tfunction logBytes13(bytes13 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes13)\", p0));\n\t}\n\n\tfunction logBytes14(bytes14 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes14)\", p0));\n\t}\n\n\tfunction logBytes15(bytes15 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes15)\", p0));\n\t}\n\n\tfunction logBytes16(bytes16 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes16)\", p0));\n\t}\n\n\tfunction logBytes17(bytes17 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes17)\", p0));\n\t}\n\n\tfunction logBytes18(bytes18 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes18)\", p0));\n\t}\n\n\tfunction logBytes19(bytes19 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes19)\", p0));\n\t}\n\n\tfunction logBytes20(bytes20 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes20)\", p0));\n\t}\n\n\tfunction logBytes21(bytes21 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes21)\", p0));\n\t}\n\n\tfunction logBytes22(bytes22 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes22)\", p0));\n\t}\n\n\tfunction logBytes23(bytes23 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes23)\", p0));\n\t}\n\n\tfunction logBytes24(bytes24 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes24)\", p0));\n\t}\n\n\tfunction logBytes25(bytes25 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes25)\", p0));\n\t}\n\n\tfunction logBytes26(bytes26 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes26)\", p0));\n\t}\n\n\tfunction logBytes27(bytes27 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes27)\", p0));\n\t}\n\n\tfunction logBytes28(bytes28 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes28)\", p0));\n\t}\n\n\tfunction logBytes29(bytes29 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes29)\", p0));\n\t}\n\n\tfunction logBytes30(bytes30 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes30)\", p0));\n\t}\n\n\tfunction logBytes31(bytes31 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes31)\", p0));\n\t}\n\n\tfunction logBytes32(bytes32 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bytes32)\", p0));\n\t}\n\n\tfunction log(uint256 p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256)\", p0));\n\t}\n\n\tfunction log(string memory p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string)\", p0));\n\t}\n\n\tfunction log(bool p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool)\", p0));\n\t}\n\n\tfunction log(address p0) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address)\", p0));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256)\", p0, p1));\n\t}\n\n\tfunction log(uint256 p0, string memory p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string)\", p0, p1));\n\t}\n\n\tfunction log(uint256 p0, bool p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool)\", p0, p1));\n\t}\n\n\tfunction log(uint256 p0, address p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address)\", p0, p1));\n\t}\n\n\tfunction log(string memory p0, uint256 p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256)\", p0, p1));\n\t}\n\n\tfunction log(string memory p0, string memory p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string)\", p0, p1));\n\t}\n\n\tfunction log(string memory p0, bool p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool)\", p0, p1));\n\t}\n\n\tfunction log(string memory p0, address p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address)\", p0, p1));\n\t}\n\n\tfunction log(bool p0, uint256 p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256)\", p0, p1));\n\t}\n\n\tfunction log(bool p0, string memory p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string)\", p0, p1));\n\t}\n\n\tfunction log(bool p0, bool p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool)\", p0, p1));\n\t}\n\n\tfunction log(bool p0, address p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address)\", p0, p1));\n\t}\n\n\tfunction log(address p0, uint256 p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256)\", p0, p1));\n\t}\n\n\tfunction log(address p0, string memory p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string)\", p0, p1));\n\t}\n\n\tfunction log(address p0, bool p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool)\", p0, p1));\n\t}\n\n\tfunction log(address p0, address p1) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address)\", p0, p1));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, bool p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, bool p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, bool p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, bool p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, address p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, address p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, address p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, address p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, string memory p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, string memory p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, string memory p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, string memory p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, bool p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, bool p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, bool p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, bool p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, address p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, address p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, address p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(string memory p0, address p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, uint256 p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, uint256 p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, uint256 p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, uint256 p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, string memory p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, string memory p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, string memory p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, string memory p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, bool p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, bool p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, bool p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, bool p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, address p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, address p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, address p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(bool p0, address p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, uint256 p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, uint256 p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, uint256 p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, uint256 p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, string memory p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, string memory p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, string memory p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, string memory p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, bool p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, bool p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, bool p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, bool p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, address p1, uint256 p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,uint256)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, address p1, string memory p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,string)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, address p1, bool p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,bool)\", p0, p1, p2));\n\t}\n\n\tfunction log(address p0, address p1, address p2) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,address)\", p0, p1, p2));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, uint256 p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,uint256,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, string memory p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,string,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, bool p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,bool,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(uint256 p0, address p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(uint256,address,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, uint256 p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,uint256,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, string memory p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,string,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, bool p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,bool,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(string memory p0, address p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(string,address,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, uint256 p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,uint256,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, string memory p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,string,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, bool p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,bool,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(bool p0, address p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(bool,address,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, uint256 p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,uint256,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, string memory p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,string,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, bool p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,bool,address,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, uint256 p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,uint256,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, uint256 p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,uint256,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, uint256 p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,uint256,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, uint256 p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,uint256,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, string memory p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,string,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, string memory p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,string,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, string memory p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,string,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, string memory p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,string,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, bool p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,bool,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, bool p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,bool,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, bool p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,bool,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, bool p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,bool,address)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, address p2, uint256 p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,address,uint256)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, address p2, string memory p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,address,string)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, address p2, bool p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,address,bool)\", p0, p1, p2, p3));\n\t}\n\n\tfunction log(address p0, address p1, address p2, address p3) internal view {\n\t\t_sendLogPayload(abi.encodeWithSignature(\"log(address,address,address,address)\", p0, p1, p2, p3));\n\t}\n\n}\n" + }, + "lib/openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport { IERC4626 } from \"../../../../interfaces/IERC4626.sol\";\nimport { ERC20 } from \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport { SafeERC20 } from \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\n\n// From Open Zeppelin draft PR commit:\n// fac43034dca85ff539db3fc8aa2a7084b843d454\n// https://github.com/OpenZeppelin/openzeppelin-contracts/pull/3171\n\nabstract contract ERC4626 is ERC20, IERC4626 {\n IERC20Metadata private immutable _asset;\n\n constructor(IERC20Metadata __asset) {\n _asset = __asset;\n }\n\n /** @dev See {IERC4262-asset} */\n function asset() public view virtual override returns (address) {\n return address(_asset);\n }\n\n /** @dev See {IERC4262-totalAssets} */\n function totalAssets() public view virtual override returns (uint256) {\n return _asset.balanceOf(address(this));\n }\n\n /**\n * @dev See {IERC4262-convertToShares}\n *\n * Will revert if asserts > 0, totalSupply > 0 and totalAssets = 0. That corresponds to a case where any asset\n * would represent an infinite amout of shares.\n */\n function convertToShares(uint256 assets) public view virtual override returns (uint256 shares) {\n uint256 supply = totalSupply();\n\n return\n (assets == 0 || supply == 0)\n ? (assets * 10**decimals()) / 10**_asset.decimals()\n : (assets * supply) / totalAssets();\n }\n\n /** @dev See {IERC4262-convertToAssets} */\n function convertToAssets(uint256 shares) public view virtual override returns (uint256 assets) {\n uint256 supply = totalSupply();\n\n return (supply == 0) ? (shares * 10**_asset.decimals()) / 10**decimals() : (shares * totalAssets()) / supply;\n }\n\n /** @dev See {IERC4262-maxDeposit} */\n function maxDeposit(address) public view virtual override returns (uint256) {\n return type(uint256).max;\n }\n\n /** @dev See {IERC4262-maxMint} */\n function maxMint(address) public view virtual override returns (uint256) {\n return type(uint256).max;\n }\n\n /** @dev See {IERC4262-maxWithdraw} */\n function maxWithdraw(address owner) public view virtual override returns (uint256) {\n return convertToAssets(balanceOf(owner));\n }\n\n /** @dev See {IERC4262-maxRedeem} */\n function maxRedeem(address owner) public view virtual override returns (uint256) {\n return balanceOf(owner);\n }\n\n /** @dev See {IERC4262-previewDeposit} */\n function previewDeposit(uint256 assets) public view virtual override returns (uint256) {\n return convertToShares(assets);\n }\n\n /** @dev See {IERC4262-previewMint} */\n function previewMint(uint256 shares) public view virtual override returns (uint256) {\n uint256 assets = convertToAssets(shares);\n return assets + (convertToShares(assets) < shares ? 1 : 0);\n }\n\n /** @dev See {IERC4262-previewWithdraw} */\n function previewWithdraw(uint256 assets) public view virtual override returns (uint256) {\n uint256 shares = convertToShares(assets);\n return shares + (convertToAssets(shares) < assets ? 1 : 0);\n }\n\n /** @dev See {IERC4262-previewRedeem} */\n function previewRedeem(uint256 shares) public view virtual override returns (uint256) {\n return convertToAssets(shares);\n }\n\n /** @dev See {IERC4262-deposit} */\n function deposit(uint256 assets, address receiver) public virtual override returns (uint256) {\n require(assets <= maxDeposit(receiver), \"ERC4626: deposit more then max\");\n\n address caller = _msgSender();\n uint256 shares = previewDeposit(assets);\n\n // if _asset is ERC777, transferFrom can call reenter BEFORE the transfer happens through\n // the tokensToSend hook, so we need to transfer before we mint to keep the invariants.\n SafeERC20.safeTransferFrom(_asset, caller, address(this), assets);\n _mint(receiver, shares);\n\n emit Deposit(caller, receiver, assets, shares);\n\n return shares;\n }\n\n /** @dev See {IERC4262-mint} */\n function mint(uint256 shares, address receiver) public virtual override returns (uint256) {\n require(shares <= maxMint(receiver), \"ERC4626: mint more then max\");\n\n address caller = _msgSender();\n uint256 assets = previewMint(shares);\n\n // if _asset is ERC777, transferFrom can call reenter BEFORE the transfer happens through\n // the tokensToSend hook, so we need to transfer before we mint to keep the invariants.\n SafeERC20.safeTransferFrom(_asset, caller, address(this), assets);\n _mint(receiver, shares);\n\n emit Deposit(caller, receiver, assets, shares);\n\n return assets;\n }\n\n /** @dev See {IERC4262-withdraw} */\n function withdraw(\n uint256 assets,\n address receiver,\n address owner\n ) public virtual override returns (uint256) {\n require(assets <= maxWithdraw(owner), \"ERC4626: withdraw more then max\");\n\n address caller = _msgSender();\n uint256 shares = previewWithdraw(assets);\n\n if (caller != owner) {\n _spendAllowance(owner, caller, shares);\n }\n\n // if _asset is ERC777, transfer can call reenter AFTER the transfer happens through\n // the tokensReceived hook, so we need to transfer after we burn to keep the invariants.\n _burn(owner, shares);\n SafeERC20.safeTransfer(_asset, receiver, assets);\n\n emit Withdraw(caller, receiver, owner, assets, shares);\n\n return shares;\n }\n\n /** @dev See {IERC4262-redeem} */\n function redeem(\n uint256 shares,\n address receiver,\n address owner\n ) public virtual override returns (uint256) {\n require(shares <= maxRedeem(owner), \"ERC4626: redeem more then max\");\n\n address caller = _msgSender();\n uint256 assets = previewRedeem(shares);\n\n if (caller != owner) {\n _spendAllowance(owner, caller, shares);\n }\n\n // if _asset is ERC777, transfer can call reenter AFTER the transfer happens through\n // the tokensReceived hook, so we need to transfer after we burn to keep the invariants.\n _burn(owner, shares);\n SafeERC20.safeTransfer(_asset, receiver, assets);\n\n emit Withdraw(caller, receiver, owner, assets, shares);\n\n return assets;\n }\n\n // Included here, since this method was not yet present in\n // the version of Open Zeppelin ERC20 code we use.\n function _spendAllowance(\n address owner,\n address spender,\n uint256 amount\n ) internal virtual {\n uint256 currentAllowance = allowance(owner, spender);\n if (currentAllowance != type(uint256).max) {\n require(currentAllowance >= amount, \"ERC20: insufficient allowance\");\n unchecked {\n _approve(owner, spender, currentAllowance - amount);\n }\n }\n }\n}" + }, + "lib/openzeppelin/interfaces/IERC4626.sol": { + "content": "// SPDX-License-Identifier: MIT\n\npragma solidity ^0.8.0;\n\nimport { IERC20Metadata } from \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\ninterface IERC4626 is IERC20, IERC20Metadata {\n event Deposit(address indexed caller, address indexed owner, uint256 assets, uint256 shares);\n\n event Withdraw(\n address indexed caller,\n address indexed receiver,\n address indexed owner,\n uint256 assets,\n uint256 shares\n );\n\n /**\n * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.\n *\n * - MUST be an ERC-20 token contract.\n * - MUST NOT revert.\n */\n function asset() external view returns (address assetTokenAddress);\n\n /**\n * @dev Returns the total amount of the underlying asset that is “managed” by Vault.\n *\n * - SHOULD include any compounding that occurs from yield.\n * - MUST be inclusive of any fees that are charged against assets in the Vault.\n * - MUST NOT revert.\n */\n function totalAssets() external view returns (uint256 totalManagedAssets);\n\n /**\n * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal\n * scenario where all the conditions are met.\n *\n * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\n * - MUST NOT show any variations depending on the caller.\n * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\n * - MUST NOT revert.\n *\n * NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the\n * “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and\n * from.\n */\n function convertToShares(uint256 assets) external view returns (uint256 shares);\n\n /**\n * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal\n * scenario where all the conditions are met.\n *\n * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\n * - MUST NOT show any variations depending on the caller.\n * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\n * - MUST NOT revert.\n *\n * NOTE: This calculation MAY NOT reflect the “per-user” price-per-share, and instead should reflect the\n * “average-user’s” price-per-share, meaning what the average user should expect to see when exchanging to and\n * from.\n */\n function convertToAssets(uint256 shares) external view returns (uint256 assets);\n\n /**\n * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,\n * through a deposit call.\n *\n * - MUST return a limited value if receiver is subject to some deposit limit.\n * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.\n * - MUST NOT revert.\n */\n function maxDeposit(address receiver) external view returns (uint256 maxAssets);\n\n /**\n * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given\n * current on-chain conditions.\n *\n * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit\n * call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called\n * in the same transaction.\n * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the\n * deposit would be accepted, regardless if the user has enough tokens approved, etc.\n * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\n * - MUST NOT revert.\n *\n * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in\n * share price or some other type of condition, meaning the depositor will lose assets by depositing.\n */\n function previewDeposit(uint256 assets) external view returns (uint256 shares);\n\n /**\n * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.\n *\n * - MUST emit the Deposit event.\n * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\n * deposit execution, and are accounted for during deposit.\n * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not\n * approving enough underlying tokens to the Vault contract, etc).\n *\n * NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token.\n */\n function deposit(uint256 assets, address receiver) external returns (uint256 shares);\n\n /**\n * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.\n * - MUST return a limited value if receiver is subject to some mint limit.\n * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.\n * - MUST NOT revert.\n */\n function maxMint(address receiver) external view returns (uint256 maxShares);\n\n /**\n * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given\n * current on-chain conditions.\n *\n * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call\n * in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the\n * same transaction.\n * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint\n * would be accepted, regardless if the user has enough tokens approved, etc.\n * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\n * - MUST NOT revert.\n *\n * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in\n * share price or some other type of condition, meaning the depositor will lose assets by minting.\n */\n function previewMint(uint256 shares) external view returns (uint256 assets);\n\n /**\n * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.\n *\n * - MUST emit the Deposit event.\n * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint\n * execution, and are accounted for during mint.\n * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not\n * approving enough underlying tokens to the Vault contract, etc).\n *\n * NOTE: most implementations will require pre-approval of the Vault with the Vault’s underlying asset token.\n */\n function mint(uint256 shares, address receiver) external returns (uint256 assets);\n\n /**\n * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the\n * Vault, through a withdraw call.\n *\n * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\n * - MUST NOT revert.\n */\n function maxWithdraw(address owner) external view returns (uint256 maxAssets);\n\n /**\n * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,\n * given current on-chain conditions.\n *\n * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw\n * call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if\n * called\n * in the same transaction.\n * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though\n * the withdrawal would be accepted, regardless if the user has enough shares, etc.\n * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\n * - MUST NOT revert.\n *\n * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in\n * share price or some other type of condition, meaning the depositor will lose assets by depositing.\n */\n function previewWithdraw(uint256 assets) external view returns (uint256 shares);\n\n /**\n * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.\n *\n * - MUST emit the Withdraw event.\n * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\n * withdraw execution, and are accounted for during withdraw.\n * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner\n * not having enough shares, etc).\n *\n * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\n * Those methods should be performed separately.\n */\n function withdraw(\n uint256 assets,\n address receiver,\n address owner\n ) external returns (uint256 shares);\n\n /**\n * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,\n * through a redeem call.\n *\n * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\n * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.\n * - MUST NOT revert.\n */\n function maxRedeem(address owner) external view returns (uint256 maxShares);\n\n /**\n * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,\n * given current on-chain conditions.\n *\n * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call\n * in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the\n * same transaction.\n * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the\n * redemption would be accepted, regardless if the user has enough shares, etc.\n * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\n * - MUST NOT revert.\n *\n * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in\n * share price or some other type of condition, meaning the depositor will lose assets by redeeming.\n */\n function previewRedeem(uint256 shares) external view returns (uint256 assets);\n\n /**\n * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.\n *\n * - MUST emit the Withdraw event.\n * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\n * redeem execution, and are accounted for during redeem.\n * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner\n * not having enough shares, etc).\n *\n * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\n * Those methods should be performed separately.\n */\n function redeem(\n uint256 shares,\n address receiver,\n address owner\n ) external returns (uint256 assets);\n}" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 200 + }, + "outputSelection": { + "*": { + "*": [ + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "storageLayout", + "evm.gasEstimates" + ], + "": [ + "ast" + ] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} \ No newline at end of file From f89f245e712884f047e2ffbb9c1cad4e0670f395 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 21:29:20 +0200 Subject: [PATCH 23/30] test updates --- contracts/test/_global-hooks.js | 5 +++-- contracts/test/behaviour/ssvStrategy.js | 5 ++++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/contracts/test/_global-hooks.js b/contracts/test/_global-hooks.js index 2c49a1b821..0ad9877e84 100644 --- a/contracts/test/_global-hooks.js +++ b/contracts/test/_global-hooks.js @@ -1,6 +1,6 @@ const mocha = require("mocha"); -const { isForkTest, isArbFork } = require("./helpers"); +const { isForkTest, isArbFork, isHoleskyFork } = require("./helpers"); const _chunkId = Number(process.env.CHUNK_ID); const _maxChunks = Number(process.env.MAX_CHUNKS); @@ -36,7 +36,8 @@ mocha.before(function () { // For fork tests, scrape out all unit tests. root.suites = root.suites.filter( (s) => - s.file.endsWith(".fork-test.js") == isForkTest && + s.file.endsWith(".fork-test.js") == isForkTest || + s.file.endsWith(".holesky-fork-test.js") == isHoleskyFork || s.file.endsWith(".arb.fork-test.js") == isArbFork ); diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js index 1648d685b3..9424fc03b7 100644 --- a/contracts/test/behaviour/ssvStrategy.js +++ b/contracts/test/behaviour/ssvStrategy.js @@ -181,7 +181,7 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { ); }); - it("Should exit and remove validator by validator registrator", async () => { + it.only("Should exit and remove validator by validator registrator", async () => { const { nativeStakingSSVStrategy, ssvNetwork, @@ -224,15 +224,18 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { }, ]); + console.log("HEre!") // exit validator from SSV network const exitTx = await nativeStakingSSVStrategy .connect(validatorRegistrator) .exitSsvValidator(testValidator.publicKey, testValidator.operatorIds); + console.log("HEre! 1") await expect(exitTx) .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitInitiated") .withArgs(testValidator.publicKey, testValidator.operatorIds); + console.log("HEre! 2") const removeTx = await nativeStakingSSVStrategy .connect(validatorRegistrator) .removeSsvValidator( From 22a31d754fd4d94e24ed22500a7bd9422ffb5399 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 21:30:16 +0200 Subject: [PATCH 24/30] also re-deploy the harvester --- contracts/deploy/deployActions.js | 3 +- .../deploy/holesky/004_upgrade_strategy.js | 5 ++- .../deployments/holesky/.migrations.json | 3 +- .../deployments/holesky/OETHHarvester.json | 44 +++++++++---------- .../deploy/verifySimpleOETHDeployment.sh | 4 +- 5 files changed, 30 insertions(+), 29 deletions(-) mode change 100644 => 100755 contracts/scripts/deploy/verifySimpleOETHDeployment.sh diff --git a/contracts/deploy/deployActions.js b/contracts/deploy/deployActions.js index 88dab9238c..3338964c53 100644 --- a/contracts/deploy/deployActions.js +++ b/contracts/deploy/deployActions.js @@ -547,7 +547,6 @@ const deployOETHHarvester = async (oethDripper) => { const assetAddresses = await getAssetAddresses(deployments); const { governorAddr } = await getNamedAccounts(); const sGovernor = await ethers.provider.getSigner(governorAddr); - const cVaultProxy = await ethers.getContract("VaultProxy"); const cOETHVaultProxy = await ethers.getContract("OETHVaultProxy"); const dOETHHarvesterProxy = await deployWithConfirmation( @@ -581,7 +580,7 @@ const deployOETHHarvester = async (oethDripper) => { cOETHHarvester .connect(sGovernor) .setRewardProceedsAddress( - isMainnet || isHolesky ? oethDripper.address : cVaultProxy.address + isMainnet || isHolesky ? oethDripper.address : cOETHVaultProxy.address ) ); diff --git a/contracts/deploy/holesky/004_upgrade_strategy.js b/contracts/deploy/holesky/004_upgrade_strategy.js index fac1a8ebff..5e32f4c7ea 100644 --- a/contracts/deploy/holesky/004_upgrade_strategy.js +++ b/contracts/deploy/holesky/004_upgrade_strategy.js @@ -1,4 +1,4 @@ -const { upgradeNativeStakingSSVStrategy } = require("../deployActions"); +const { upgradeNativeStakingSSVStrategy, deployOETHHarvester } = require("../deployActions"); const mainExport = async () => { console.log("Running 004 deployment on Holesky..."); @@ -6,6 +6,9 @@ const mainExport = async () => { console.log("Upgrading native staking strategy"); await upgradeNativeStakingSSVStrategy(); + console.log("deploying harvester") + const cOETHDripperProxy = await ethers.getContract("OETHDripperProxy"); + const cOETHHarvester = await deployOETHHarvester(cOETHDripperProxy.address); console.log("Running 004 deployment done"); return true; }; diff --git a/contracts/deployments/holesky/.migrations.json b/contracts/deployments/holesky/.migrations.json index 142d25dba9..d45ad24364 100644 --- a/contracts/deployments/holesky/.migrations.json +++ b/contracts/deployments/holesky/.migrations.json @@ -1,6 +1,5 @@ { "001_core": 1714168010, "002_upgrade_strategy": 1714233842, - "003_deposit_to_native_strategy": 1714307581, - "004_upgrade_strategy": 1714761605 + "003_deposit_to_native_strategy": 1714307581 } \ No newline at end of file diff --git a/contracts/deployments/holesky/OETHHarvester.json b/contracts/deployments/holesky/OETHHarvester.json index bfc4c84482..694edc13d3 100644 --- a/contracts/deployments/holesky/OETHHarvester.json +++ b/contracts/deployments/holesky/OETHHarvester.json @@ -1,5 +1,5 @@ { - "address": "0x22b00a89531E199bd90eC162F9810298b9FBC8b3", + "address": "0xBd09F938259AE61e089959d52580235b76C69A83", "abi": [ { "inputs": [ @@ -694,46 +694,46 @@ "type": "function" } ], - "transactionHash": "0x4b3113aba3207e3c1ef50452c3ee4f5c18a1606f38f31864acd0bb872f1c8baf", + "transactionHash": "0xb261b4230c6856c159cd50e1f4005943c06e59ce82bd06eca13608c61940e110", "receipt": { "to": null, "from": "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C", - "contractAddress": "0x22b00a89531E199bd90eC162F9810298b9FBC8b3", - "transactionIndex": 61, - "gasUsed": "2857566", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000020000000000000000001800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000100000000", - "blockHash": "0x14116552a1bab414922c64f6ccf8f1135e30b3e731c71bce315c90c9c8cb2fc5", - "transactionHash": "0x4b3113aba3207e3c1ef50452c3ee4f5c18a1606f38f31864acd0bb872f1c8baf", + "contractAddress": "0xBd09F938259AE61e089959d52580235b76C69A83", + "transactionIndex": 38, + "gasUsed": "2900119", + "logsBloom": "0x00000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0x8a3dd6f9d1e547a31be3fba7f0ef840ba40a7a921e4e6dc37b5f7f41ae8a9ff4", + "transactionHash": "0xb261b4230c6856c159cd50e1f4005943c06e59ce82bd06eca13608c61940e110", "logs": [ { - "transactionIndex": 61, - "blockNumber": 1405153, - "transactionHash": "0x4b3113aba3207e3c1ef50452c3ee4f5c18a1606f38f31864acd0bb872f1c8baf", - "address": "0x22b00a89531E199bd90eC162F9810298b9FBC8b3", + "transactionIndex": 38, + "blockNumber": 1471485, + "transactionHash": "0xb261b4230c6856c159cd50e1f4005943c06e59ce82bd06eca13608c61940e110", + "address": "0xBd09F938259AE61e089959d52580235b76C69A83", "topics": [ "0xc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000001b94ca50d3ad9f8368851f8526132272d1a5028c" ], "data": "0x", - "logIndex": 495, - "blockHash": "0x14116552a1bab414922c64f6ccf8f1135e30b3e731c71bce315c90c9c8cb2fc5" + "logIndex": 503, + "blockHash": "0x8a3dd6f9d1e547a31be3fba7f0ef840ba40a7a921e4e6dc37b5f7f41ae8a9ff4" } ], - "blockNumber": 1405153, - "cumulativeGasUsed": "24006246", + "blockNumber": 1471485, + "cumulativeGasUsed": "23563856", "status": 1, "byzantium": true }, "args": [ "0x19d2bAaBA949eFfa163bFB9efB53ed8701aA5dD9", - "0x94373a4919b3240d86ea41593d5eba789fef3848" + "0x94373a4919B3240D86eA41593D5eBa789FEF3848" ], - "numDeployments": 1, - "solcInputHash": "da4c2bc4af0be4b969e54f8b43895033", - "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_vault\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_wethAddress\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"actualBalance\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"minExpected\",\"type\":\"uint256\"}],\"name\":\"BalanceMismatchAfterSwap\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"EmptyAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"EmptyBalancerPoolId\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"InvalidCurvePoolAssetIndex\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidHarvestRewardBps\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlippageBps\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"}],\"name\":\"InvalidSwapPlatform\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"InvalidTokenInSwapPath\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidUniswapV2PathLength\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"actualBalance\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"minExpected\",\"type\":\"uint256\"}],\"name\":\"SlippageError\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"strategyAddress\",\"type\":\"address\"}],\"name\":\"UnsupportedStrategy\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newProceedsAddress\",\"type\":\"address\"}],\"name\":\"RewardProceedsAddressChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"farmer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"protcolYield\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"farmerFee\",\"type\":\"uint256\"}],\"name\":\"RewardProceedsTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"allowedSlippageBps\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"harvestRewardBps\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"swapPlatformAddr\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"swapData\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"liquidationLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"doSwapRewardToken\",\"type\":\"bool\"}],\"name\":\"RewardTokenConfigUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"rewardToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"swappedInto\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountIn\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountOut\",\"type\":\"uint256\"}],\"name\":\"RewardTokenSwapped\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"strategyAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isSupported\",\"type\":\"bool\"}],\"name\":\"SupportedStrategyUpdate\",\"type\":\"event\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"balancerPoolId\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"baseTokenAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"baseTokenDecimals\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"curvePoolIndices\",\"outputs\":[{\"internalType\":\"uint128\",\"name\":\"rewardTokenIndex\",\"type\":\"uint128\"},{\"internalType\":\"uint128\",\"name\":\"baseTokenIndex\",\"type\":\"uint128\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategyAddr\",\"type\":\"address\"}],\"name\":\"harvestAndSwap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategyAddr\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_rewardTo\",\"type\":\"address\"}],\"name\":\"harvestAndSwap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"rewardProceedsAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"rewardTokenConfigs\",\"outputs\":[{\"internalType\":\"uint16\",\"name\":\"allowedSlippageBps\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"harvestRewardBps\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"swapPlatformAddr\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"doSwapRewardToken\",\"type\":\"bool\"},{\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"liquidationLimit\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_rewardProceedsAddress\",\"type\":\"address\"}],\"name\":\"setRewardProceedsAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_tokenAddress\",\"type\":\"address\"},{\"components\":[{\"internalType\":\"uint16\",\"name\":\"allowedSlippageBps\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"harvestRewardBps\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"swapPlatformAddr\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"doSwapRewardToken\",\"type\":\"bool\"},{\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"liquidationLimit\",\"type\":\"uint256\"}],\"internalType\":\"struct BaseHarvester.RewardTokenConfig\",\"name\":\"tokenConfig\",\"type\":\"tuple\"},{\"internalType\":\"bytes\",\"name\":\"swapData\",\"type\":\"bytes\"}],\"name\":\"setRewardTokenConfig\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategyAddress\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"_isSupported\",\"type\":\"bool\"}],\"name\":\"setSupportedStrategy\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"supportedStrategies\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"transferToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"uniswapV2Path\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"uniswapV3Path\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"vaultAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"harvestAndSwap(address)\":{\"details\":\"Collect reward tokens from a specific strategy and swap them for base token on the configured swap platform. Can be called by anyone. Rewards incentivizing the caller are sent to the caller of this function.\",\"params\":{\"_strategyAddr\":\"Address of the strategy to collect rewards from\"}},\"harvestAndSwap(address,address)\":{\"details\":\"Collect reward tokens from a specific strategy and swap them for base token on the configured swap platform. Can be called by anyone\",\"params\":{\"_rewardTo\":\"Address where to send a share of harvest rewards to as an incentive for executing this function\",\"_strategyAddr\":\"Address of the strategy to collect rewards from\"}},\"setRewardProceedsAddress(address)\":{\"params\":{\"_rewardProceedsAddress\":\"Address of the reward token\"}},\"setRewardTokenConfig(address,(uint16,uint16,address,bool,uint8,uint256),bytes)\":{\"details\":\"Add/update a reward token configuration that holds harvesting config variables\",\"params\":{\"_tokenAddress\":\"Address of the reward token\",\"swapData\":\"Additional data required for swapping\",\"tokenConfig\":\".swapPlatform SwapPlatform to use for Swapping\"}},\"setSupportedStrategy(address,bool)\":{\"details\":\"Flags a strategy as supported or not supported one\",\"params\":{\"_isSupported\":\"Bool marking strategy as supported or not supported\",\"_strategyAddress\":\"Address of the strategy\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"transferToken(address,uint256)\":{\"details\":\"Transfer token to governor. Intended for recovering tokens stuck in contract, i.e. mistaken sends.\",\"params\":{\"_amount\":\"Amount of the asset to transfer\",\"_asset\":\"Address for the asset\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"baseTokenAddress()\":{\"notice\":\"All tokens are swapped to this token before it gets transferred to the `rewardProceedsAddress`. USDT for OUSD and WETH for OETH.*\"},\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"rewardProceedsAddress()\":{\"notice\":\"Address receiving rewards proceeds. Initially the Vault contract later will possibly be replaced by another contract that eases out rewards distribution.*\"},\"setRewardProceedsAddress(address)\":{\"notice\":\"Set the Address receiving rewards proceeds.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/harvest/OETHHarvester.sol\":\"OETHHarvester\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `recipient`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address recipient, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `sender` to `recipient` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(\\n address sender,\\n address recipient,\\n uint256 amount\\n ) external returns (bool);\\n\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n}\\n\",\"keccak256\":\"0x61437cb513a887a1bbad006e7b1c8b414478427d33de47c5600af3c748f108da\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n function safeTransfer(\\n IERC20 token,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n function safeTransferFrom(\\n IERC20 token,\\n address from,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n function safeIncreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n uint256 newAllowance = token.allowance(address(this), spender) + value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n\\n function safeDecreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n uint256 newAllowance = oldAllowance - value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n if (returndata.length > 0) {\\n // Return data is optional\\n require(abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc3d946432c0ddbb1f846a0d3985be71299df331b91d06732152117f62f0be2b5\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/Math.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Standard math utilities missing in the Solidity language.\\n */\\nlibrary Math {\\n /**\\n * @dev Returns the largest of two numbers.\\n */\\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a >= b ? a : b;\\n }\\n\\n /**\\n * @dev Returns the smallest of two numbers.\\n */\\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a < b ? a : b;\\n }\\n\\n /**\\n * @dev Returns the average of two numbers. The result is rounded towards\\n * zero.\\n */\\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\\n // (a + b) / 2 can overflow.\\n return (a & b) + (a ^ b) / 2;\\n }\\n\\n /**\\n * @dev Returns the ceiling of the division of two numbers.\\n *\\n * This differs from standard division with `/` in that it rounds up instead\\n * of rounding down.\\n */\\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\\n // (a + b - 1) / b can overflow on addition, so we distribute.\\n return a / b + (a % b == 0 ? 0 : 1);\\n }\\n}\\n\",\"keccak256\":\"0xfaad496c1c944b6259b7dc70b4865eb1775d6402bc0c81b38a0b24d9f525ae37\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)\\n\\npragma solidity ^0.8.0;\\n\\n// CAUTION\\n// This version of SafeMath should only be used with Solidity 0.8 or later,\\n// because it relies on the compiler's built in overflow checks.\\n\\n/**\\n * @dev Wrappers over Solidity's arithmetic operations.\\n *\\n * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler\\n * now has built in overflow checking.\\n */\\nlibrary SafeMath {\\n /**\\n * @dev Returns the addition of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n uint256 c = a + b;\\n if (c < a) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the substraction of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b > a) return (false, 0);\\n return (true, a - b);\\n }\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n // benefit is lost if 'b' is also tested.\\n // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n if (a == 0) return (true, 0);\\n uint256 c = a * b;\\n if (c / a != b) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the division of two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a / b);\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a % b);\\n }\\n }\\n\\n /**\\n * @dev Returns the addition of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `+` operator.\\n *\\n * Requirements:\\n *\\n * - Addition cannot overflow.\\n */\\n function add(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting on\\n * overflow (when the result is negative).\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `*` operator.\\n *\\n * Requirements:\\n *\\n * - Multiplication cannot overflow.\\n */\\n function mul(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator.\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting when dividing by zero.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a % b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\\n * overflow (when the result is negative).\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {trySub}.\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b <= a, errorMessage);\\n return a - b;\\n }\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting with custom message on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator. Note: this function uses a\\n * `revert` opcode (which leaves remaining gas untouched) while Solidity\\n * uses an invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a / b;\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting with custom message when dividing by zero.\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {tryMod}.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a % b;\\n }\\n }\\n}\\n\",\"keccak256\":\"0xa2f576be637946f767aa56601c26d717f48a0aff44f82e46f13807eea1009a21\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/harvest/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport \\\"@openzeppelin/contracts/utils/math/Math.sol\\\";\\n\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\nimport { IOracle } from \\\"../interfaces/IOracle.sol\\\";\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { IUniswapV2Router } from \\\"../interfaces/uniswap/IUniswapV2Router02.sol\\\";\\nimport { IUniswapV3Router } from \\\"../interfaces/uniswap/IUniswapV3Router.sol\\\";\\nimport { IBalancerVault } from \\\"../interfaces/balancer/IBalancerVault.sol\\\";\\nimport { ICurvePool } from \\\"../strategies/ICurvePool.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\nabstract contract BaseHarvester is Governable {\\n using SafeERC20 for IERC20;\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n enum SwapPlatform {\\n UniswapV2Compatible,\\n UniswapV3,\\n Balancer,\\n Curve\\n }\\n\\n event SupportedStrategyUpdate(address strategyAddress, bool isSupported);\\n event RewardTokenConfigUpdated(\\n address tokenAddress,\\n uint16 allowedSlippageBps,\\n uint16 harvestRewardBps,\\n SwapPlatform swapPlatform,\\n address swapPlatformAddr,\\n bytes swapData,\\n uint256 liquidationLimit,\\n bool doSwapRewardToken\\n );\\n event RewardTokenSwapped(\\n address indexed rewardToken,\\n address indexed swappedInto,\\n SwapPlatform swapPlatform,\\n uint256 amountIn,\\n uint256 amountOut\\n );\\n event RewardProceedsTransferred(\\n address indexed token,\\n address farmer,\\n uint256 protcolYield,\\n uint256 farmerFee\\n );\\n event RewardProceedsAddressChanged(address newProceedsAddress);\\n\\n error EmptyAddress();\\n error InvalidSlippageBps();\\n error InvalidHarvestRewardBps();\\n\\n error InvalidSwapPlatform(SwapPlatform swapPlatform);\\n\\n error InvalidUniswapV2PathLength();\\n error InvalidTokenInSwapPath(address token);\\n error EmptyBalancerPoolId();\\n error InvalidCurvePoolAssetIndex(address token);\\n\\n error UnsupportedStrategy(address strategyAddress);\\n\\n error SlippageError(uint256 actualBalance, uint256 minExpected);\\n error BalanceMismatchAfterSwap(uint256 actualBalance, uint256 minExpected);\\n\\n // Configuration properties for harvesting logic of reward tokens\\n struct RewardTokenConfig {\\n // Max allowed slippage when swapping reward token for a stablecoin denominated in basis points.\\n uint16 allowedSlippageBps;\\n // Reward when calling a harvest function denominated in basis points.\\n uint16 harvestRewardBps;\\n // Address of compatible exchange protocol (Uniswap V2/V3, SushiSwap, Balancer and Curve).\\n address swapPlatformAddr;\\n /* When true the reward token is being swapped. In a need of (temporarily) disabling the swapping of\\n * a reward token this needs to be set to false.\\n */\\n bool doSwapRewardToken;\\n // Platform to use for Swapping\\n SwapPlatform swapPlatform;\\n /* How much token can be sold per one harvest call. If the balance of rewards tokens\\n * exceeds that limit multiple harvest calls are required to harvest all of the tokens.\\n * Set it to MAX_INT to effectively disable the limit.\\n */\\n uint256 liquidationLimit;\\n }\\n\\n mapping(address => RewardTokenConfig) public rewardTokenConfigs;\\n mapping(address => bool) public supportedStrategies;\\n\\n address public immutable vaultAddress;\\n\\n /**\\n * Address receiving rewards proceeds. Initially the Vault contract later will possibly\\n * be replaced by another contract that eases out rewards distribution.\\n **/\\n address public rewardProceedsAddress;\\n\\n /**\\n * All tokens are swapped to this token before it gets transferred\\n * to the `rewardProceedsAddress`. USDT for OUSD and WETH for OETH.\\n **/\\n address public immutable baseTokenAddress;\\n // Cached decimals for `baseTokenAddress`\\n uint256 public immutable baseTokenDecimals;\\n\\n // Uniswap V2 path for reward tokens using Uniswap V2 Router\\n mapping(address => address[]) public uniswapV2Path;\\n // Uniswap V3 path for reward tokens using Uniswap V3 Router\\n mapping(address => bytes) public uniswapV3Path;\\n // Pool ID to use for reward tokens on Balancer\\n mapping(address => bytes32) public balancerPoolId;\\n\\n struct CurvePoolIndices {\\n // Casted into uint128 and stored in a struct to save gas\\n uint128 rewardTokenIndex;\\n uint128 baseTokenIndex;\\n }\\n // Packed indices of assets on the Curve pool\\n mapping(address => CurvePoolIndices) public curvePoolIndices;\\n\\n constructor(address _vaultAddress, address _baseTokenAddress) {\\n require(_vaultAddress != address(0));\\n require(_baseTokenAddress != address(0));\\n\\n vaultAddress = _vaultAddress;\\n baseTokenAddress = _baseTokenAddress;\\n\\n // Cache decimals as well\\n baseTokenDecimals = Helpers.getDecimals(_baseTokenAddress);\\n }\\n\\n /***************************************\\n Configuration\\n ****************************************/\\n\\n /**\\n * Set the Address receiving rewards proceeds.\\n * @param _rewardProceedsAddress Address of the reward token\\n */\\n function setRewardProceedsAddress(address _rewardProceedsAddress)\\n external\\n onlyGovernor\\n {\\n if (_rewardProceedsAddress == address(0)) {\\n revert EmptyAddress();\\n }\\n\\n rewardProceedsAddress = _rewardProceedsAddress;\\n emit RewardProceedsAddressChanged(_rewardProceedsAddress);\\n }\\n\\n /**\\n * @dev Add/update a reward token configuration that holds harvesting config variables\\n * @param _tokenAddress Address of the reward token\\n * @param tokenConfig.allowedSlippageBps uint16 maximum allowed slippage denominated in basis points.\\n * Example: 300 == 3% slippage\\n * @param tokenConfig.harvestRewardBps uint16 amount of reward tokens the caller of the function is rewarded.\\n * Example: 100 == 1%\\n * @param tokenConfig.swapPlatformAddr Address Address of a UniswapV2 compatible contract to perform\\n * the exchange from reward tokens to stablecoin (currently hard-coded to USDT)\\n * @param tokenConfig.liquidationLimit uint256 Maximum amount of token to be sold per one swap function call.\\n * When value is 0 there is no limit.\\n * @param tokenConfig.doSwapRewardToken bool Disables swapping of the token when set to true,\\n * does not cause it to revert though.\\n * @param tokenConfig.swapPlatform SwapPlatform to use for Swapping\\n * @param swapData Additional data required for swapping\\n */\\n function setRewardTokenConfig(\\n address _tokenAddress,\\n RewardTokenConfig calldata tokenConfig,\\n bytes calldata swapData\\n ) external onlyGovernor {\\n if (tokenConfig.allowedSlippageBps > 1000) {\\n revert InvalidSlippageBps();\\n }\\n\\n if (tokenConfig.harvestRewardBps > 1000) {\\n revert InvalidHarvestRewardBps();\\n }\\n\\n address newRouterAddress = tokenConfig.swapPlatformAddr;\\n if (newRouterAddress == address(0)) {\\n // Swap router address should be non zero address\\n revert EmptyAddress();\\n }\\n\\n address oldRouterAddress = rewardTokenConfigs[_tokenAddress]\\n .swapPlatformAddr;\\n rewardTokenConfigs[_tokenAddress] = tokenConfig;\\n\\n // Revert if feed does not exist\\n // slither-disable-next-line unused-return\\n IOracle(IVault(vaultAddress).priceProvider()).price(_tokenAddress);\\n\\n IERC20 token = IERC20(_tokenAddress);\\n // if changing token swap provider cancel existing allowance\\n if (\\n /* oldRouterAddress == address(0) when there is no pre-existing\\n * configuration for said rewards token\\n */\\n oldRouterAddress != address(0) &&\\n oldRouterAddress != newRouterAddress\\n ) {\\n token.safeApprove(oldRouterAddress, 0);\\n }\\n\\n // Give SwapRouter infinite approval when needed\\n if (oldRouterAddress != newRouterAddress) {\\n token.safeApprove(newRouterAddress, 0);\\n token.safeApprove(newRouterAddress, type(uint256).max);\\n }\\n\\n SwapPlatform _platform = tokenConfig.swapPlatform;\\n if (_platform == SwapPlatform.UniswapV2Compatible) {\\n uniswapV2Path[_tokenAddress] = _decodeUniswapV2Path(\\n swapData,\\n _tokenAddress\\n );\\n } else if (_platform == SwapPlatform.UniswapV3) {\\n uniswapV3Path[_tokenAddress] = _decodeUniswapV3Path(\\n swapData,\\n _tokenAddress\\n );\\n } else if (_platform == SwapPlatform.Balancer) {\\n balancerPoolId[_tokenAddress] = _decodeBalancerPoolId(\\n swapData,\\n newRouterAddress,\\n _tokenAddress\\n );\\n } else if (_platform == SwapPlatform.Curve) {\\n curvePoolIndices[_tokenAddress] = _decodeCurvePoolIndices(\\n swapData,\\n newRouterAddress,\\n _tokenAddress\\n );\\n } else {\\n // Note: This code is unreachable since Solidity reverts when\\n // the value is outside the range of defined values of the enum\\n // (even if it's under the max length of the base type)\\n revert InvalidSwapPlatform(_platform);\\n }\\n\\n emit RewardTokenConfigUpdated(\\n _tokenAddress,\\n tokenConfig.allowedSlippageBps,\\n tokenConfig.harvestRewardBps,\\n _platform,\\n newRouterAddress,\\n swapData,\\n tokenConfig.liquidationLimit,\\n tokenConfig.doSwapRewardToken\\n );\\n }\\n\\n /**\\n * @dev Decodes the data passed into Uniswap V2 path and validates\\n * it to make sure the path is for `token` to `baseToken`\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @param token The address of the reward token\\n * @return path The validated Uniswap V2 path\\n */\\n function _decodeUniswapV2Path(bytes calldata data, address token)\\n internal\\n view\\n returns (address[] memory path)\\n {\\n (path) = abi.decode(data, (address[]));\\n uint256 len = path.length;\\n\\n if (len < 2) {\\n // Path should have at least two tokens\\n revert InvalidUniswapV2PathLength();\\n }\\n\\n // Do some validation\\n if (path[0] != token) {\\n revert InvalidTokenInSwapPath(path[0]);\\n }\\n\\n if (path[len - 1] != baseTokenAddress) {\\n revert InvalidTokenInSwapPath(path[len - 1]);\\n }\\n }\\n\\n /**\\n * @dev Decodes the data passed into Uniswap V3 path and validates\\n * it to make sure the path is for `token` to `baseToken`\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @param token The address of the reward token\\n * @return path The validated Uniswap V3 path\\n */\\n function _decodeUniswapV3Path(bytes calldata data, address token)\\n internal\\n view\\n returns (bytes calldata path)\\n {\\n path = data;\\n\\n address decodedAddress = address(uint160(bytes20(data[0:20])));\\n\\n if (decodedAddress != token) {\\n // Invalid Reward Token in swap path\\n revert InvalidTokenInSwapPath(decodedAddress);\\n }\\n\\n decodedAddress = address(uint160(bytes20(data[path.length - 20:])));\\n if (decodedAddress != baseTokenAddress) {\\n // Invalid Base Token in swap path\\n revert InvalidTokenInSwapPath(decodedAddress);\\n }\\n }\\n\\n /**\\n * @dev Decodes the data passed to Balancer Pool ID\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @return poolId The pool ID\\n */\\n function _decodeBalancerPoolId(\\n bytes calldata data,\\n address balancerVault,\\n address token\\n ) internal view returns (bytes32 poolId) {\\n (poolId) = abi.decode(data, (bytes32));\\n\\n if (poolId == bytes32(0)) {\\n revert EmptyBalancerPoolId();\\n }\\n\\n IBalancerVault bVault = IBalancerVault(balancerVault);\\n\\n // Note: this reverts if token is not a pool asset\\n // slither-disable-next-line unused-return\\n bVault.getPoolTokenInfo(poolId, token);\\n\\n // slither-disable-next-line unused-return\\n bVault.getPoolTokenInfo(poolId, baseTokenAddress);\\n }\\n\\n /**\\n * @dev Decodes the data passed to get the pool indices and\\n * checks it against the Curve Pool to make sure it's\\n * not misconfigured. The indices are packed into a single\\n * uint256 for gas savings\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @param poolAddress Curve pool address\\n * @param token The address of the reward token\\n * @return indices Packed pool asset indices\\n */\\n function _decodeCurvePoolIndices(\\n bytes calldata data,\\n address poolAddress,\\n address token\\n ) internal view returns (CurvePoolIndices memory indices) {\\n indices = abi.decode(data, (CurvePoolIndices));\\n\\n ICurvePool pool = ICurvePool(poolAddress);\\n if (token != pool.coins(indices.rewardTokenIndex)) {\\n revert InvalidCurvePoolAssetIndex(token);\\n }\\n if (baseTokenAddress != pool.coins(indices.baseTokenIndex)) {\\n revert InvalidCurvePoolAssetIndex(baseTokenAddress);\\n }\\n }\\n\\n /**\\n * @dev Flags a strategy as supported or not supported one\\n * @param _strategyAddress Address of the strategy\\n * @param _isSupported Bool marking strategy as supported or not supported\\n */\\n function setSupportedStrategy(address _strategyAddress, bool _isSupported)\\n external\\n onlyGovernor\\n {\\n supportedStrategies[_strategyAddress] = _isSupported;\\n emit SupportedStrategyUpdate(_strategyAddress, _isSupported);\\n }\\n\\n /***************************************\\n Rewards\\n ****************************************/\\n\\n /**\\n * @dev Transfer token to governor. Intended for recovering tokens stuck in\\n * contract, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n external\\n onlyGovernor\\n {\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform. Can be called by anyone.\\n * Rewards incentivizing the caller are sent to the caller of this function.\\n * @param _strategyAddr Address of the strategy to collect rewards from\\n */\\n function harvestAndSwap(address _strategyAddr) external nonReentrant {\\n // Remember _harvest function checks for the validity of _strategyAddr\\n _harvestAndSwap(_strategyAddr, msg.sender);\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform. Can be called by anyone\\n * @param _strategyAddr Address of the strategy to collect rewards from\\n * @param _rewardTo Address where to send a share of harvest rewards to as an incentive\\n * for executing this function\\n */\\n function harvestAndSwap(address _strategyAddr, address _rewardTo)\\n external\\n nonReentrant\\n {\\n // Remember _harvest function checks for the validity of _strategyAddr\\n _harvestAndSwap(_strategyAddr, _rewardTo);\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform\\n * @param _strategyAddr Address of the strategy to collect rewards from\\n * @param _rewardTo Address where to send a share of harvest rewards to as an incentive\\n * for executing this function\\n */\\n function _harvestAndSwap(address _strategyAddr, address _rewardTo)\\n internal\\n {\\n _harvest(_strategyAddr);\\n IStrategy strategy = IStrategy(_strategyAddr);\\n address[] memory rewardTokens = strategy.getRewardTokenAddresses();\\n IOracle priceProvider = IOracle(IVault(vaultAddress).priceProvider());\\n uint256 len = rewardTokens.length;\\n for (uint256 i = 0; i < len; ++i) {\\n _swap(rewardTokens[i], _rewardTo, priceProvider);\\n }\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform\\n * @param _strategyAddr Address of the strategy to collect rewards from.\\n */\\n function _harvest(address _strategyAddr) internal {\\n if (!supportedStrategies[_strategyAddr]) {\\n revert UnsupportedStrategy(_strategyAddr);\\n }\\n\\n IStrategy strategy = IStrategy(_strategyAddr);\\n strategy.collectRewardTokens();\\n }\\n\\n /**\\n * @dev Swap a reward token for the base token on the configured\\n * swap platform. The token must have a registered price feed\\n * with the price provider\\n * @param _swapToken Address of the token to swap\\n * @param _rewardTo Address where to send the share of harvest rewards to\\n * @param _priceProvider Oracle to get prices of the swap token\\n */\\n function _swap(\\n address _swapToken,\\n address _rewardTo,\\n IOracle _priceProvider\\n ) internal virtual {\\n RewardTokenConfig memory tokenConfig = rewardTokenConfigs[_swapToken];\\n\\n /* This will trigger a return when reward token configuration has not yet been set\\n * or we have temporarily disabled swapping of specific reward token via setting\\n * doSwapRewardToken to false.\\n */\\n if (!tokenConfig.doSwapRewardToken) {\\n return;\\n }\\n\\n uint256 balance = IERC20(_swapToken).balanceOf(address(this));\\n\\n if (balance == 0) {\\n return;\\n }\\n\\n if (tokenConfig.liquidationLimit > 0) {\\n balance = Math.min(balance, tokenConfig.liquidationLimit);\\n }\\n\\n // This'll revert if there is no price feed\\n uint256 oraclePrice = _priceProvider.price(_swapToken);\\n\\n // Oracle price is 1e18\\n uint256 minExpected = (balance *\\n (1e4 - tokenConfig.allowedSlippageBps) * // max allowed slippage\\n oraclePrice).scaleBy(\\n baseTokenDecimals,\\n Helpers.getDecimals(_swapToken)\\n ) /\\n 1e4 / // fix the max slippage decimal position\\n 1e18; // and oracle price decimals position\\n\\n // Do the swap\\n uint256 amountReceived = _doSwap(\\n tokenConfig.swapPlatform,\\n tokenConfig.swapPlatformAddr,\\n _swapToken,\\n balance,\\n minExpected\\n );\\n\\n if (amountReceived < minExpected) {\\n revert SlippageError(amountReceived, minExpected);\\n }\\n\\n emit RewardTokenSwapped(\\n _swapToken,\\n baseTokenAddress,\\n tokenConfig.swapPlatform,\\n balance,\\n amountReceived\\n );\\n\\n IERC20 baseToken = IERC20(baseTokenAddress);\\n uint256 baseTokenBalance = baseToken.balanceOf(address(this));\\n if (baseTokenBalance < amountReceived) {\\n // Note: It's possible to bypass this check by transfering `baseToken`\\n // directly to Harvester before calling the `harvestAndSwap`. However,\\n // there's no incentive for an attacker to do that. Doing a balance diff\\n // will increase the gas cost significantly\\n revert BalanceMismatchAfterSwap(baseTokenBalance, amountReceived);\\n }\\n\\n // Farmer only gets fee from the base amount they helped farm,\\n // They do not get anything from anything that already was there\\n // on the Harvester\\n uint256 farmerFee = amountReceived.mulTruncateScale(\\n tokenConfig.harvestRewardBps,\\n 1e4\\n );\\n uint256 protcolYield = baseTokenBalance - farmerFee;\\n\\n baseToken.safeTransfer(rewardProceedsAddress, protcolYield);\\n baseToken.safeTransfer(_rewardTo, farmerFee);\\n emit RewardProceedsTransferred(\\n baseTokenAddress,\\n _rewardTo,\\n protcolYield,\\n farmerFee\\n );\\n }\\n\\n function _doSwap(\\n SwapPlatform swapPlatform,\\n address routerAddress,\\n address rewardTokenAddress,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n if (swapPlatform == SwapPlatform.UniswapV2Compatible) {\\n return\\n _swapWithUniswapV2(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else if (swapPlatform == SwapPlatform.UniswapV3) {\\n return\\n _swapWithUniswapV3(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else if (swapPlatform == SwapPlatform.Balancer) {\\n return\\n _swapWithBalancer(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else if (swapPlatform == SwapPlatform.Curve) {\\n return\\n _swapWithCurve(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else {\\n // Should never be invoked since we catch invalid values\\n // in the `setRewardTokenConfig` function before it's set\\n revert InvalidSwapPlatform(swapPlatform);\\n }\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` with Uniswap V2\\n *\\n * @param routerAddress Uniswap V2 Router address\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithUniswapV2(\\n address routerAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n address[] memory path = uniswapV2Path[swapToken];\\n\\n uint256[] memory amounts = IUniswapV2Router(routerAddress)\\n .swapExactTokensForTokens(\\n amountIn,\\n minAmountOut,\\n path,\\n address(this),\\n block.timestamp\\n );\\n\\n amountOut = amounts[amounts.length - 1];\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` with Uniswap V3\\n *\\n * @param routerAddress Uniswap V3 Router address\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithUniswapV3(\\n address routerAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n bytes memory path = uniswapV3Path[swapToken];\\n\\n IUniswapV3Router.ExactInputParams memory params = IUniswapV3Router\\n .ExactInputParams({\\n path: path,\\n recipient: address(this),\\n deadline: block.timestamp,\\n amountIn: amountIn,\\n amountOutMinimum: minAmountOut\\n });\\n amountOut = IUniswapV3Router(routerAddress).exactInput(params);\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` on Balancer\\n *\\n * @param balancerVaultAddress BalancerVaultAddress\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithBalancer(\\n address balancerVaultAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n bytes32 poolId = balancerPoolId[swapToken];\\n\\n IBalancerVault.SingleSwap memory singleSwap = IBalancerVault\\n .SingleSwap({\\n poolId: poolId,\\n kind: IBalancerVault.SwapKind.GIVEN_IN,\\n assetIn: swapToken,\\n assetOut: baseTokenAddress,\\n amount: amountIn,\\n userData: hex\\\"\\\"\\n });\\n\\n IBalancerVault.FundManagement memory fundMgmt = IBalancerVault\\n .FundManagement({\\n sender: address(this),\\n fromInternalBalance: false,\\n recipient: payable(address(this)),\\n toInternalBalance: false\\n });\\n\\n amountOut = IBalancerVault(balancerVaultAddress).swap(\\n singleSwap,\\n fundMgmt,\\n minAmountOut,\\n block.timestamp\\n );\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` on Curve\\n *\\n * @param poolAddress Curve Pool Address\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithCurve(\\n address poolAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n CurvePoolIndices memory indices = curvePoolIndices[swapToken];\\n\\n // Note: Not all CurvePools return the `amountOut`, make sure\\n // to use only pool that do. Otherwise the swap would revert\\n // always\\n amountOut = ICurvePool(poolAddress).exchange(\\n uint256(indices.rewardTokenIndex),\\n uint256(indices.baseTokenIndex),\\n amountIn,\\n minAmountOut\\n );\\n }\\n}\\n\",\"keccak256\":\"0x909d6fcd5e294f04e1106bc0bedd344f5efc305db053cc678764ac64670df00d\",\"license\":\"MIT\"},\"contracts/harvest/OETHHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { BaseHarvester } from \\\"./BaseHarvester.sol\\\";\\n\\ncontract OETHHarvester is BaseHarvester {\\n constructor(address _vault, address _wethAddress)\\n BaseHarvester(_vault, _wethAddress)\\n {}\\n}\\n\",\"keccak256\":\"0x67255aabc4a8ec5d6650b3ab1daedffa093d8f6c324ee92281581c05990098bc\",\"license\":\"MIT\"},\"contracts/interfaces/IBasicToken.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IBasicToken {\\n function symbol() external view returns (string memory);\\n\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0xa562062698aa12572123b36dfd2072f1a39e44fed2031cc19c2c9fd522f96ec2\",\"license\":\"MIT\"},\"contracts/interfaces/IOracle.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IOracle {\\n /**\\n * @dev returns the asset price in USD, in 8 decimal digits.\\n *\\n * The version of priceProvider deployed for OETH has 18 decimal digits\\n */\\n function price(address asset) external view returns (uint256);\\n}\\n\",\"keccak256\":\"0x9eabf152389f145c9c23ed71972af73fb1708cbc4b26e524a9ba29a557b7cfe5\",\"license\":\"MIT\"},\"contracts/interfaces/IStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Platform interface to integrate with lending platform like Compound, AAVE etc.\\n */\\ninterface IStrategy {\\n /**\\n * @dev Deposit the given asset to platform\\n * @param _asset asset address\\n * @param _amount Amount to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external;\\n\\n /**\\n * @dev Deposit the entire balance of all supported assets in the Strategy\\n * to the platform\\n */\\n function depositAll() external;\\n\\n /**\\n * @dev Withdraw given asset from Lending platform\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external;\\n\\n /**\\n * @dev Liquidate all assets in strategy and return them to Vault.\\n */\\n function withdrawAll() external;\\n\\n /**\\n * @dev Returns the current balance of the given asset.\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n returns (uint256 balance);\\n\\n /**\\n * @dev Returns bool indicating whether strategy supports asset.\\n */\\n function supportsAsset(address _asset) external view returns (bool);\\n\\n /**\\n * @dev Collect reward tokens from the Strategy.\\n */\\n function collectRewardTokens() external;\\n\\n /**\\n * @dev The address array of the reward tokens for the Strategy.\\n */\\n function getRewardTokenAddresses() external view returns (address[] memory);\\n}\\n\",\"keccak256\":\"0xb291e409a9b95527f9ed19cd6bff8eeb9921a21c1f5194a48c0bb9ce6613959a\",\"license\":\"MIT\"},\"contracts/interfaces/IVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { VaultStorage } from \\\"../vault/VaultStorage.sol\\\";\\n\\ninterface IVault {\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Governable.sol\\n function transferGovernance(address _newGovernor) external;\\n\\n function claimGovernance() external;\\n\\n function governor() external view returns (address);\\n\\n // VaultAdmin.sol\\n function setPriceProvider(address _priceProvider) external;\\n\\n function priceProvider() external view returns (address);\\n\\n function setRedeemFeeBps(uint256 _redeemFeeBps) external;\\n\\n function redeemFeeBps() external view returns (uint256);\\n\\n function setVaultBuffer(uint256 _vaultBuffer) external;\\n\\n function vaultBuffer() external view returns (uint256);\\n\\n function setAutoAllocateThreshold(uint256 _threshold) external;\\n\\n function autoAllocateThreshold() external view returns (uint256);\\n\\n function setRebaseThreshold(uint256 _threshold) external;\\n\\n function rebaseThreshold() external view returns (uint256);\\n\\n function setStrategistAddr(address _address) external;\\n\\n function strategistAddr() external view returns (address);\\n\\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external;\\n\\n function maxSupplyDiff() external view returns (uint256);\\n\\n function setTrusteeAddress(address _address) external;\\n\\n function trusteeAddress() external view returns (address);\\n\\n function setTrusteeFeeBps(uint256 _basis) external;\\n\\n function trusteeFeeBps() external view returns (uint256);\\n\\n function ousdMetaStrategy() external view returns (address);\\n\\n function setSwapper(address _swapperAddr) external;\\n\\n function setSwapAllowedUndervalue(uint16 _percentageBps) external;\\n\\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\\n external;\\n\\n function supportAsset(address _asset, uint8 _supportsAsset) external;\\n\\n function approveStrategy(address _addr) external;\\n\\n function removeStrategy(address _addr) external;\\n\\n function setAssetDefaultStrategy(address _asset, address _strategy)\\n external;\\n\\n function assetDefaultStrategies(address _asset)\\n external\\n view\\n returns (address);\\n\\n function pauseRebase() external;\\n\\n function unpauseRebase() external;\\n\\n function rebasePaused() external view returns (bool);\\n\\n function pauseCapital() external;\\n\\n function unpauseCapital() external;\\n\\n function capitalPaused() external view returns (bool);\\n\\n function transferToken(address _asset, uint256 _amount) external;\\n\\n function priceUnitMint(address asset) external view returns (uint256);\\n\\n function priceUnitRedeem(address asset) external view returns (uint256);\\n\\n function withdrawAllFromStrategy(address _strategyAddr) external;\\n\\n function withdrawAllFromStrategies() external;\\n\\n function withdrawFromStrategy(\\n address _strategyFromAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n function depositToStrategy(\\n address _strategyToAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n // VaultCore.sol\\n function mint(\\n address _asset,\\n uint256 _amount,\\n uint256 _minimumOusdAmount\\n ) external;\\n\\n function mintForStrategy(uint256 _amount) external;\\n\\n function redeem(uint256 _amount, uint256 _minimumUnitAmount) external;\\n\\n function burnForStrategy(uint256 _amount) external;\\n\\n function redeemAll(uint256 _minimumUnitAmount) external;\\n\\n function allocate() external;\\n\\n function rebase() external;\\n\\n function swapCollateral(\\n address fromAsset,\\n address toAsset,\\n uint256 fromAssetAmount,\\n uint256 minToAssetAmount,\\n bytes calldata data\\n ) external returns (uint256 toAssetAmount);\\n\\n function totalValue() external view returns (uint256 value);\\n\\n function checkBalance(address _asset) external view returns (uint256);\\n\\n function calculateRedeemOutputs(uint256 _amount)\\n external\\n view\\n returns (uint256[] memory);\\n\\n function getAssetCount() external view returns (uint256);\\n\\n function getAssetConfig(address _asset)\\n external\\n view\\n returns (VaultStorage.Asset memory config);\\n\\n function getAllAssets() external view returns (address[] memory);\\n\\n function getStrategyCount() external view returns (uint256);\\n\\n function swapper() external view returns (address);\\n\\n function allowedSwapUndervalue() external view returns (uint256);\\n\\n function getAllStrategies() external view returns (address[] memory);\\n\\n function isSupportedAsset(address _asset) external view returns (bool);\\n\\n function netOusdMintForStrategyThreshold() external view returns (uint256);\\n\\n function setOusdMetaStrategy(address _ousdMetaStrategy) external;\\n\\n function setNetOusdMintForStrategyThreshold(uint256 _threshold) external;\\n\\n function netOusdMintedForStrategy() external view returns (int256);\\n\\n function weth() external view returns (address);\\n\\n function cacheWETHAssetIndex() external;\\n\\n function wethAssetIndex() external view returns (uint256);\\n\\n function initialize(address, address) external;\\n\\n function setAdminImpl(address) external;\\n}\\n\",\"keccak256\":\"0xe8ab2f09127dc86bda14d2ad7f58d4f5ef214959101742f0dd977be3599f9d5f\",\"license\":\"MIT\"},\"contracts/interfaces/balancer/IBalancerVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"../../utils/InitializableAbstractStrategy.sol\\\";\\n\\ninterface IBalancerVault {\\n enum WeightedPoolJoinKind {\\n INIT,\\n EXACT_TOKENS_IN_FOR_BPT_OUT,\\n TOKEN_IN_FOR_EXACT_BPT_OUT,\\n ALL_TOKENS_IN_FOR_EXACT_BPT_OUT,\\n ADD_TOKEN\\n }\\n\\n enum WeightedPoolExitKind {\\n EXACT_BPT_IN_FOR_ONE_TOKEN_OUT,\\n EXACT_BPT_IN_FOR_TOKENS_OUT,\\n BPT_IN_FOR_EXACT_TOKENS_OUT,\\n REMOVE_TOKEN\\n }\\n\\n /**\\n * @dev Called by users to join a Pool, which transfers tokens from `sender` into the Pool's balance. This will\\n * trigger custom Pool behavior, which will typically grant something in return to `recipient` - often tokenized\\n * Pool shares.\\n *\\n * If the caller is not `sender`, it must be an authorized relayer for them.\\n *\\n * The `assets` and `maxAmountsIn` arrays must have the same length, and each entry indicates the maximum amount\\n * to send for each asset. The amounts to send are decided by the Pool and not the Vault: it just enforces\\n * these maximums.\\n *\\n * If joining a Pool that holds WETH, it is possible to send ETH directly: the Vault will do the wrapping. To enable\\n * this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead of the\\n * WETH address. Note that it is not possible to combine ETH and WETH in the same join. Any excess ETH will be sent\\n * back to the caller (not the sender, which is important for relayers).\\n *\\n * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when\\n * interacting with Pools that register and deregister tokens frequently. If sending ETH however, the array must be\\n * sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the final\\n * `assets` array might not be sorted. Pools with no registered tokens cannot be joined.\\n *\\n * If `fromInternalBalance` is true, the caller's Internal Balance will be preferred: ERC20 transfers will only\\n * be made for the difference between the requested amount and Internal Balance (if any). Note that ETH cannot be\\n * withdrawn from Internal Balance: attempting to do so will trigger a revert.\\n *\\n * This causes the Vault to call the `IBasePool.onJoinPool` hook on the Pool's contract, where Pools implement\\n * their own custom logic. This typically requires additional information from the user (such as the expected number\\n * of Pool shares). This can be encoded in the `userData` argument, which is ignored by the Vault and passed\\n * directly to the Pool's contract, as is `recipient`.\\n *\\n * Emits a `PoolBalanceChanged` event.\\n */\\n function joinPool(\\n bytes32 poolId,\\n address sender,\\n address recipient,\\n JoinPoolRequest memory request\\n ) external payable;\\n\\n struct JoinPoolRequest {\\n address[] assets;\\n uint256[] maxAmountsIn;\\n bytes userData;\\n bool fromInternalBalance;\\n }\\n\\n /**\\n * @dev Called by users to exit a Pool, which transfers tokens from the Pool's balance to `recipient`. This will\\n * trigger custom Pool behavior, which will typically ask for something in return from `sender` - often tokenized\\n * Pool shares. The amount of tokens that can be withdrawn is limited by the Pool's `cash` balance (see\\n * `getPoolTokenInfo`).\\n *\\n * If the caller is not `sender`, it must be an authorized relayer for them.\\n *\\n * The `tokens` and `minAmountsOut` arrays must have the same length, and each entry in these indicates the minimum\\n * token amount to receive for each token contract. The amounts to send are decided by the Pool and not the Vault:\\n * it just enforces these minimums.\\n *\\n * If exiting a Pool that holds WETH, it is possible to receive ETH directly: the Vault will do the unwrapping. To\\n * enable this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead\\n * of the WETH address. Note that it is not possible to combine ETH and WETH in the same exit.\\n *\\n * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when\\n * interacting with Pools that register and deregister tokens frequently. If receiving ETH however, the array must\\n * be sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the\\n * final `assets` array might not be sorted. Pools with no registered tokens cannot be exited.\\n *\\n * If `toInternalBalance` is true, the tokens will be deposited to `recipient`'s Internal Balance. Otherwise,\\n * an ERC20 transfer will be performed. Note that ETH cannot be deposited to Internal Balance: attempting to\\n * do so will trigger a revert.\\n *\\n * `minAmountsOut` is the minimum amount of tokens the user expects to get out of the Pool, for each token in the\\n * `tokens` array. This array must match the Pool's registered tokens.\\n *\\n * This causes the Vault to call the `IBasePool.onExitPool` hook on the Pool's contract, where Pools implement\\n * their own custom logic. This typically requires additional information from the user (such as the expected number\\n * of Pool shares to return). This can be encoded in the `userData` argument, which is ignored by the Vault and\\n * passed directly to the Pool's contract.\\n *\\n * Emits a `PoolBalanceChanged` event.\\n */\\n function exitPool(\\n bytes32 poolId,\\n address sender,\\n address payable recipient,\\n ExitPoolRequest memory request\\n ) external;\\n\\n struct ExitPoolRequest {\\n address[] assets;\\n uint256[] minAmountsOut;\\n bytes userData;\\n bool toInternalBalance;\\n }\\n\\n /**\\n * @dev Returns a Pool's registered tokens, the total balance for each, and the latest block when *any* of\\n * the tokens' `balances` changed.\\n *\\n * The order of the `tokens` array is the same order that will be used in `joinPool`, `exitPool`, as well as in all\\n * Pool hooks (where applicable). Calls to `registerTokens` and `deregisterTokens` may change this order.\\n *\\n * If a Pool only registers tokens once, and these are sorted in ascending order, they will be stored in the same\\n * order as passed to `registerTokens`.\\n *\\n * Total balances include both tokens held by the Vault and those withdrawn by the Pool's Asset Managers. These are\\n * the amounts used by joins, exits and swaps. For a detailed breakdown of token balances, use `getPoolTokenInfo`\\n * instead.\\n */\\n function getPoolTokens(bytes32 poolId)\\n external\\n view\\n returns (\\n IERC20[] memory tokens,\\n uint256[] memory balances,\\n uint256 lastChangeBlock\\n );\\n\\n /**\\n * @dev Performs a set of user balance operations, which involve Internal Balance (deposit, withdraw or transfer)\\n * and plain ERC20 transfers using the Vault's allowance. This last feature is particularly useful for relayers, as\\n * it lets integrators reuse a user's Vault allowance.\\n *\\n * For each operation, if the caller is not `sender`, it must be an authorized relayer for them.\\n */\\n function manageUserBalance(UserBalanceOp[] memory ops) external payable;\\n\\n struct UserBalanceOp {\\n UserBalanceOpKind kind;\\n address asset;\\n uint256 amount;\\n address sender;\\n address payable recipient;\\n }\\n\\n enum UserBalanceOpKind {\\n DEPOSIT_INTERNAL,\\n WITHDRAW_INTERNAL,\\n TRANSFER_INTERNAL,\\n TRANSFER_EXTERNAL\\n }\\n\\n enum SwapKind {\\n GIVEN_IN,\\n GIVEN_OUT\\n }\\n\\n struct SingleSwap {\\n bytes32 poolId;\\n SwapKind kind;\\n address assetIn;\\n address assetOut;\\n uint256 amount;\\n bytes userData;\\n }\\n\\n struct FundManagement {\\n address sender;\\n bool fromInternalBalance;\\n address payable recipient;\\n bool toInternalBalance;\\n }\\n\\n function swap(\\n SingleSwap calldata singleSwap,\\n FundManagement calldata funds,\\n uint256 limit,\\n uint256 deadline\\n ) external returns (uint256 amountCalculated);\\n\\n function getPoolTokenInfo(bytes32 poolId, address token)\\n external\\n view\\n returns (\\n uint256 cash,\\n uint256 managed,\\n uint256 lastChangeBlock,\\n address assetManager\\n );\\n}\\n\",\"keccak256\":\"0x597796f9c5b3d174acbec8b520c633695c10d87762f7a0a7fec49b291694d7de\",\"license\":\"MIT\"},\"contracts/interfaces/uniswap/IUniswapV2Router02.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IUniswapV2Router {\\n function WETH() external pure returns (address);\\n\\n function swapExactTokensForTokens(\\n uint256 amountIn,\\n uint256 amountOutMin,\\n address[] calldata path,\\n address to,\\n uint256 deadline\\n ) external returns (uint256[] memory amounts);\\n\\n function addLiquidity(\\n address tokenA,\\n address tokenB,\\n uint256 amountADesired,\\n uint256 amountBDesired,\\n uint256 amountAMin,\\n uint256 amountBMin,\\n address to,\\n uint256 deadline\\n )\\n external\\n returns (\\n uint256 amountA,\\n uint256 amountB,\\n uint256 liquidity\\n );\\n}\\n\",\"keccak256\":\"0x3fdf2b91880f2b669202cc43bdceaf9d01537a9b955fc7a51159fb04fdbc68d4\",\"license\":\"MIT\"},\"contracts/interfaces/uniswap/IUniswapV3Router.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n// -- Solididy v0.5.x compatible interface\\ninterface IUniswapV3Router {\\n struct ExactInputParams {\\n bytes path;\\n address recipient;\\n uint256 deadline;\\n uint256 amountIn;\\n uint256 amountOutMinimum;\\n }\\n\\n /// @notice Swaps `amountIn` of one token for as much as possible of another along the specified path\\n /// @param params The parameters necessary for the multi-hop swap, encoded as `ExactInputParams` in calldata\\n /// @return amountOut The amount of the received token\\n function exactInput(ExactInputParams calldata params)\\n external\\n payable\\n returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xe32b76d23705979a297b164718aefa6b08e0ec3830883c020a5ac68d332a1dd2\",\"license\":\"MIT\"},\"contracts/strategies/ICurvePool.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface ICurvePool {\\n function get_virtual_price() external view returns (uint256);\\n\\n function add_liquidity(uint256[3] calldata _amounts, uint256 _min) external;\\n\\n function balances(uint256) external view returns (uint256);\\n\\n function calc_token_amount(uint256[3] calldata _amounts, bool _deposit)\\n external\\n returns (uint256);\\n\\n function fee() external view returns (uint256);\\n\\n function remove_liquidity_one_coin(\\n uint256 _amount,\\n int128 _index,\\n uint256 _minAmount\\n ) external;\\n\\n function remove_liquidity(\\n uint256 _amount,\\n uint256[3] calldata _minWithdrawAmounts\\n ) external;\\n\\n function calc_withdraw_one_coin(uint256 _amount, int128 _index)\\n external\\n view\\n returns (uint256);\\n\\n function exchange(\\n uint256 i,\\n uint256 j,\\n uint256 dx,\\n uint256 min_dy\\n ) external returns (uint256);\\n\\n function coins(uint256 _index) external view returns (address);\\n\\n function remove_liquidity_imbalance(\\n uint256[3] calldata _amounts,\\n uint256 maxBurnAmount\\n ) external;\\n}\\n\",\"keccak256\":\"0x65e40829ff1f51c6c64fe991ed6a536b413ced85b9d9aa852d37fa14966d474c\",\"license\":\"MIT\"},\"contracts/token/OUSD.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OUSD Token Contract\\n * @dev ERC20 compatible contract for OUSD\\n * @dev Implements an elastic supply\\n * @author Origin Protocol Inc\\n */\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { InitializableERC20Detailed } from \\\"../utils/InitializableERC20Detailed.sol\\\";\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * NOTE that this is an ERC20 token but the invariant that the sum of\\n * balanceOf(x) for all x is not >= totalSupply(). This is a consequence of the\\n * rebasing design. Any integrations with OUSD should be aware.\\n */\\n\\ncontract OUSD is Initializable, InitializableERC20Detailed, Governable {\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n event TotalSupplyUpdatedHighres(\\n uint256 totalSupply,\\n uint256 rebasingCredits,\\n uint256 rebasingCreditsPerToken\\n );\\n event AccountRebasingEnabled(address account);\\n event AccountRebasingDisabled(address account);\\n\\n enum RebaseOptions {\\n NotSet,\\n OptOut,\\n OptIn\\n }\\n\\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\\n uint256 public _totalSupply;\\n mapping(address => mapping(address => uint256)) private _allowances;\\n address public vaultAddress = address(0);\\n mapping(address => uint256) private _creditBalances;\\n uint256 private _rebasingCredits;\\n uint256 private _rebasingCreditsPerToken;\\n // Frozen address/credits are non rebasing (value is held in contracts which\\n // do not receive yield unless they explicitly opt in)\\n uint256 public nonRebasingSupply;\\n mapping(address => uint256) public nonRebasingCreditsPerToken;\\n mapping(address => RebaseOptions) public rebaseState;\\n mapping(address => uint256) public isUpgraded;\\n\\n uint256 private constant RESOLUTION_INCREASE = 1e9;\\n\\n function initialize(\\n string calldata _nameArg,\\n string calldata _symbolArg,\\n address _vaultAddress,\\n uint256 _initialCreditsPerToken\\n ) external onlyGovernor initializer {\\n InitializableERC20Detailed._initialize(_nameArg, _symbolArg, 18);\\n _rebasingCreditsPerToken = _initialCreditsPerToken;\\n vaultAddress = _vaultAddress;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault contract\\n */\\n modifier onlyVault() {\\n require(vaultAddress == msg.sender, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @return The total supply of OUSD.\\n */\\n function totalSupply() public view override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @return Low resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerToken() public view returns (uint256) {\\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return Low resolution total number of rebasing credits\\n */\\n function rebasingCredits() public view returns (uint256) {\\n return _rebasingCredits / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return High resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\\n return _rebasingCreditsPerToken;\\n }\\n\\n /**\\n * @return High resolution total number of rebasing credits\\n */\\n function rebasingCreditsHighres() public view returns (uint256) {\\n return _rebasingCredits;\\n }\\n\\n /**\\n * @dev Gets the balance of the specified address.\\n * @param _account Address to query the balance of.\\n * @return A uint256 representing the amount of base units owned by the\\n * specified address.\\n */\\n function balanceOf(address _account)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n if (_creditBalances[_account] == 0) return 0;\\n return\\n _creditBalances[_account].divPrecisely(_creditsPerToken(_account));\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @dev Backwards compatible with old low res credits per token.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256) Credit balance and credits per token of the\\n * address\\n */\\n function creditsBalanceOf(address _account)\\n public\\n view\\n returns (uint256, uint256)\\n {\\n uint256 cpt = _creditsPerToken(_account);\\n if (cpt == 1e27) {\\n // For a period before the resolution upgrade, we created all new\\n // contract accounts at high resolution. Since they are not changing\\n // as a result of this upgrade, we will return their true values\\n return (_creditBalances[_account], cpt);\\n } else {\\n return (\\n _creditBalances[_account] / RESOLUTION_INCREASE,\\n cpt / RESOLUTION_INCREASE\\n );\\n }\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256, bool) Credit balance, credits per token of the\\n * address, and isUpgraded\\n */\\n function creditsBalanceOfHighres(address _account)\\n public\\n view\\n returns (\\n uint256,\\n uint256,\\n bool\\n )\\n {\\n return (\\n _creditBalances[_account],\\n _creditsPerToken(_account),\\n isUpgraded[_account] == 1\\n );\\n }\\n\\n /**\\n * @dev Transfer tokens to a specified address.\\n * @param _to the address to transfer to.\\n * @param _value the amount to be transferred.\\n * @return true on success.\\n */\\n function transfer(address _to, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(\\n _value <= balanceOf(msg.sender),\\n \\\"Transfer greater than balance\\\"\\n );\\n\\n _executeTransfer(msg.sender, _to, _value);\\n\\n emit Transfer(msg.sender, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Transfer tokens from one address to another.\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value The amount of tokens to be transferred.\\n */\\n function transferFrom(\\n address _from,\\n address _to,\\n uint256 _value\\n ) public override returns (bool) {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(_value <= balanceOf(_from), \\\"Transfer greater than balance\\\");\\n\\n _allowances[_from][msg.sender] = _allowances[_from][msg.sender].sub(\\n _value\\n );\\n\\n _executeTransfer(_from, _to, _value);\\n\\n emit Transfer(_from, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Update the count of non rebasing credits in response to a transfer\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value Amount of OUSD to transfer\\n */\\n function _executeTransfer(\\n address _from,\\n address _to,\\n uint256 _value\\n ) internal {\\n bool isNonRebasingTo = _isNonRebasingAccount(_to);\\n bool isNonRebasingFrom = _isNonRebasingAccount(_from);\\n\\n // Credits deducted and credited might be different due to the\\n // differing creditsPerToken used by each account\\n uint256 creditsCredited = _value.mulTruncate(_creditsPerToken(_to));\\n uint256 creditsDeducted = _value.mulTruncate(_creditsPerToken(_from));\\n\\n _creditBalances[_from] = _creditBalances[_from].sub(\\n creditsDeducted,\\n \\\"Transfer amount exceeds balance\\\"\\n );\\n _creditBalances[_to] = _creditBalances[_to].add(creditsCredited);\\n\\n if (isNonRebasingTo && !isNonRebasingFrom) {\\n // Transfer to non-rebasing account from rebasing account, credits\\n // are removed from the non rebasing tally\\n nonRebasingSupply = nonRebasingSupply.add(_value);\\n // Update rebasingCredits by subtracting the deducted amount\\n _rebasingCredits = _rebasingCredits.sub(creditsDeducted);\\n } else if (!isNonRebasingTo && isNonRebasingFrom) {\\n // Transfer to rebasing account from non-rebasing account\\n // Decreasing non-rebasing credits by the amount that was sent\\n nonRebasingSupply = nonRebasingSupply.sub(_value);\\n // Update rebasingCredits by adding the credited amount\\n _rebasingCredits = _rebasingCredits.add(creditsCredited);\\n }\\n }\\n\\n /**\\n * @dev Function to check the amount of tokens that _owner has allowed to\\n * `_spender`.\\n * @param _owner The address which owns the funds.\\n * @param _spender The address which will spend the funds.\\n * @return The number of tokens still available for the _spender.\\n */\\n function allowance(address _owner, address _spender)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n return _allowances[_owner][_spender];\\n }\\n\\n /**\\n * @dev Approve the passed address to spend the specified amount of tokens\\n * on behalf of msg.sender. This method is included for ERC20\\n * compatibility. `increaseAllowance` and `decreaseAllowance` should be\\n * used instead.\\n *\\n * Changing an allowance with this method brings the risk that someone\\n * may transfer both the old and the new allowance - if they are both\\n * greater than zero - if a transfer transaction is mined before the\\n * later approve() call is mined.\\n * @param _spender The address which will spend the funds.\\n * @param _value The amount of tokens to be spent.\\n */\\n function approve(address _spender, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _value;\\n emit Approval(msg.sender, _spender, _value);\\n return true;\\n }\\n\\n /**\\n * @dev Increase the amount of tokens that an owner has allowed to\\n * `_spender`.\\n * This method should be used instead of approve() to avoid the double\\n * approval vulnerability described above.\\n * @param _spender The address which will spend the funds.\\n * @param _addedValue The amount of tokens to increase the allowance by.\\n */\\n function increaseAllowance(address _spender, uint256 _addedValue)\\n public\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _allowances[msg.sender][_spender]\\n .add(_addedValue);\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Decrease the amount of tokens that an owner has allowed to\\n `_spender`.\\n * @param _spender The address which will spend the funds.\\n * @param _subtractedValue The amount of tokens to decrease the allowance\\n * by.\\n */\\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\\n public\\n returns (bool)\\n {\\n uint256 oldValue = _allowances[msg.sender][_spender];\\n if (_subtractedValue >= oldValue) {\\n _allowances[msg.sender][_spender] = 0;\\n } else {\\n _allowances[msg.sender][_spender] = oldValue.sub(_subtractedValue);\\n }\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Mints new tokens, increasing totalSupply.\\n */\\n function mint(address _account, uint256 _amount) external onlyVault {\\n _mint(_account, _amount);\\n }\\n\\n /**\\n * @dev Creates `_amount` tokens and assigns them to `_account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `to` cannot be the zero address.\\n */\\n function _mint(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Mint to the zero address\\\");\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n _creditBalances[_account] = _creditBalances[_account].add(creditAmount);\\n\\n // If the account is non rebasing and doesn't have a set creditsPerToken\\n // then set it i.e. this is a mint from a fresh contract\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.add(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.add(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.add(_amount);\\n\\n require(_totalSupply < MAX_SUPPLY, \\\"Max supply\\\");\\n\\n emit Transfer(address(0), _account, _amount);\\n }\\n\\n /**\\n * @dev Burns tokens, decreasing totalSupply.\\n */\\n function burn(address account, uint256 amount) external onlyVault {\\n _burn(account, amount);\\n }\\n\\n /**\\n * @dev Destroys `_amount` tokens from `_account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `_account` cannot be the zero address.\\n * - `_account` must have at least `_amount` tokens.\\n */\\n function _burn(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Burn from the zero address\\\");\\n if (_amount == 0) {\\n return;\\n }\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n uint256 currentCredits = _creditBalances[_account];\\n\\n // Remove the credits, burning rounding errors\\n if (\\n currentCredits == creditAmount || currentCredits - 1 == creditAmount\\n ) {\\n // Handle dust from rounding\\n _creditBalances[_account] = 0;\\n } else if (currentCredits > creditAmount) {\\n _creditBalances[_account] = _creditBalances[_account].sub(\\n creditAmount\\n );\\n } else {\\n revert(\\\"Remove exceeds balance\\\");\\n }\\n\\n // Remove from the credit tallies and non-rebasing supply\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.sub(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.sub(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.sub(_amount);\\n\\n emit Transfer(_account, address(0), _amount);\\n }\\n\\n /**\\n * @dev Get the credits per token for an account. Returns a fixed amount\\n * if the account is non-rebasing.\\n * @param _account Address of the account.\\n */\\n function _creditsPerToken(address _account)\\n internal\\n view\\n returns (uint256)\\n {\\n if (nonRebasingCreditsPerToken[_account] != 0) {\\n return nonRebasingCreditsPerToken[_account];\\n } else {\\n return _rebasingCreditsPerToken;\\n }\\n }\\n\\n /**\\n * @dev Is an account using rebasing accounting or non-rebasing accounting?\\n * Also, ensure contracts are non-rebasing if they have not opted in.\\n * @param _account Address of the account.\\n */\\n function _isNonRebasingAccount(address _account) internal returns (bool) {\\n bool isContract = Address.isContract(_account);\\n if (isContract && rebaseState[_account] == RebaseOptions.NotSet) {\\n _ensureRebasingMigration(_account);\\n }\\n return nonRebasingCreditsPerToken[_account] > 0;\\n }\\n\\n /**\\n * @dev Ensures internal account for rebasing and non-rebasing credits and\\n * supply is updated following deployment of frozen yield change.\\n */\\n function _ensureRebasingMigration(address _account) internal {\\n if (nonRebasingCreditsPerToken[_account] == 0) {\\n emit AccountRebasingDisabled(_account);\\n if (_creditBalances[_account] == 0) {\\n // Since there is no existing balance, we can directly set to\\n // high resolution, and do not have to do any other bookkeeping\\n nonRebasingCreditsPerToken[_account] = 1e27;\\n } else {\\n // Migrate an existing account:\\n\\n // Set fixed credits per token for this account\\n nonRebasingCreditsPerToken[_account] = _rebasingCreditsPerToken;\\n // Update non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(_account));\\n // Update credit tallies\\n _rebasingCredits = _rebasingCredits.sub(\\n _creditBalances[_account]\\n );\\n }\\n }\\n }\\n\\n /**\\n * @notice Enable rebasing for an account.\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n * @param _account Address of the account.\\n */\\n function governanceRebaseOptIn(address _account)\\n public\\n nonReentrant\\n onlyGovernor\\n {\\n _rebaseOptIn(_account);\\n }\\n\\n /**\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n */\\n function rebaseOptIn() public nonReentrant {\\n _rebaseOptIn(msg.sender);\\n }\\n\\n function _rebaseOptIn(address _account) internal {\\n require(_isNonRebasingAccount(_account), \\\"Account has not opted out\\\");\\n\\n // Convert balance into the same amount at the current exchange rate\\n uint256 newCreditBalance = _creditBalances[_account]\\n .mul(_rebasingCreditsPerToken)\\n .div(_creditsPerToken(_account));\\n\\n // Decreasing non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.sub(balanceOf(_account));\\n\\n _creditBalances[_account] = newCreditBalance;\\n\\n // Increase rebasing credits, totalSupply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.add(_creditBalances[_account]);\\n\\n rebaseState[_account] = RebaseOptions.OptIn;\\n\\n // Delete any fixed credits per token\\n delete nonRebasingCreditsPerToken[_account];\\n emit AccountRebasingEnabled(_account);\\n }\\n\\n /**\\n * @dev Explicitly mark that an address is non-rebasing.\\n */\\n function rebaseOptOut() public nonReentrant {\\n require(!_isNonRebasingAccount(msg.sender), \\\"Account has not opted in\\\");\\n\\n // Increase non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(msg.sender));\\n // Set fixed credits per token\\n nonRebasingCreditsPerToken[msg.sender] = _rebasingCreditsPerToken;\\n\\n // Decrease rebasing credits, total supply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.sub(_creditBalances[msg.sender]);\\n\\n // Mark explicitly opted out of rebasing\\n rebaseState[msg.sender] = RebaseOptions.OptOut;\\n emit AccountRebasingDisabled(msg.sender);\\n }\\n\\n /**\\n * @dev Modify the supply without minting new tokens. This uses a change in\\n * the exchange rate between \\\"credits\\\" and OUSD tokens to change balances.\\n * @param _newTotalSupply New total supply of OUSD.\\n */\\n function changeSupply(uint256 _newTotalSupply)\\n external\\n onlyVault\\n nonReentrant\\n {\\n require(_totalSupply > 0, \\\"Cannot increase 0 supply\\\");\\n\\n if (_totalSupply == _newTotalSupply) {\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n return;\\n }\\n\\n _totalSupply = _newTotalSupply > MAX_SUPPLY\\n ? MAX_SUPPLY\\n : _newTotalSupply;\\n\\n _rebasingCreditsPerToken = _rebasingCredits.divPrecisely(\\n _totalSupply.sub(nonRebasingSupply)\\n );\\n\\n require(_rebasingCreditsPerToken > 0, \\\"Invalid change in supply\\\");\\n\\n _totalSupply = _rebasingCredits\\n .divPrecisely(_rebasingCreditsPerToken)\\n .add(nonRebasingSupply);\\n\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n }\\n}\\n\",\"keccak256\":\"0x2dc66b1ba02716d64eb47dd9117fda62650d8b57669e6c351437e0ad29ad5f19\",\"license\":\"MIT\"},\"contracts/utils/Helpers.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IBasicToken } from \\\"../interfaces/IBasicToken.sol\\\";\\n\\nlibrary Helpers {\\n /**\\n * @notice Fetch the `symbol()` from an ERC20 token\\n * @dev Grabs the `symbol()` from a contract\\n * @param _token Address of the ERC20 token\\n * @return string Symbol of the ERC20 token\\n */\\n function getSymbol(address _token) internal view returns (string memory) {\\n string memory symbol = IBasicToken(_token).symbol();\\n return symbol;\\n }\\n\\n /**\\n * @notice Fetch the `decimals()` from an ERC20 token\\n * @dev Grabs the `decimals()` from a contract and fails if\\n * the decimal value does not live within a certain range\\n * @param _token Address of the ERC20 token\\n * @return uint256 Decimals of the ERC20 token\\n */\\n function getDecimals(address _token) internal view returns (uint256) {\\n uint256 decimals = IBasicToken(_token).decimals();\\n require(\\n decimals >= 4 && decimals <= 18,\\n \\\"Token must have sufficient decimal places\\\"\\n );\\n\\n return decimals;\\n }\\n}\\n\",\"keccak256\":\"0x108b7a69e0140da0072ca18f90a03a3340574400f81aa6076cd2cccdf13699c2\",\"license\":\"MIT\"},\"contracts/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract any contracts that need to initialize state after deployment.\\n * @author Origin Protocol Inc\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n */\\n bool private initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private initializing;\\n\\n /**\\n * @dev Modifier to protect an initializer function from being invoked twice.\\n */\\n modifier initializer() {\\n require(\\n initializing || !initialized,\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n\\n bool isTopLevelCall = !initializing;\\n if (isTopLevelCall) {\\n initializing = true;\\n initialized = true;\\n }\\n\\n _;\\n\\n if (isTopLevelCall) {\\n initializing = false;\\n }\\n }\\n\\n uint256[50] private ______gap;\\n}\\n\",\"keccak256\":\"0xaadbcc138114afed4af4f353c2ced2916e6ee14be91434789187f192caf0d786\",\"license\":\"MIT\"},\"contracts/utils/InitializableAbstractStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract for vault strategies.\\n * @author Origin Protocol Inc\\n */\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\n\\nabstract contract InitializableAbstractStrategy is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event PTokenAdded(address indexed _asset, address _pToken);\\n event PTokenRemoved(address indexed _asset, address _pToken);\\n event Deposit(address indexed _asset, address _pToken, uint256 _amount);\\n event Withdrawal(address indexed _asset, address _pToken, uint256 _amount);\\n event RewardTokenCollected(\\n address recipient,\\n address rewardToken,\\n uint256 amount\\n );\\n event RewardTokenAddressesUpdated(\\n address[] _oldAddresses,\\n address[] _newAddresses\\n );\\n event HarvesterAddressesUpdated(\\n address _oldHarvesterAddress,\\n address _newHarvesterAddress\\n );\\n\\n /// @notice Address of the underlying platform\\n address public immutable platformAddress;\\n /// @notice Address of the OToken vault\\n address public immutable vaultAddress;\\n\\n /// @dev Replaced with an immutable variable\\n // slither-disable-next-line constable-states\\n address private _deprecated_platformAddress;\\n\\n /// @dev Replaced with an immutable\\n // slither-disable-next-line constable-states\\n address private _deprecated_vaultAddress;\\n\\n /// @notice asset => pToken (Platform Specific Token Address)\\n mapping(address => address) public assetToPToken;\\n\\n /// @notice Full list of all assets supported by the strategy\\n address[] internal assetsMapped;\\n\\n // Deprecated: Reward token address\\n // slither-disable-next-line constable-states\\n address private _deprecated_rewardTokenAddress;\\n\\n // Deprecated: now resides in Harvester's rewardTokenConfigs\\n // slither-disable-next-line constable-states\\n uint256 private _deprecated_rewardLiquidationThreshold;\\n\\n /// @notice Address of the Harvester contract allowed to collect reward tokens\\n address public harvesterAddress;\\n\\n /// @notice Address of the reward tokens. eg CRV, BAL, CVX, AURA\\n address[] public rewardTokenAddresses;\\n\\n /* Reserved for future expansion. Used to be 100 storage slots\\n * and has decreased to accommodate:\\n * - harvesterAddress\\n * - rewardTokenAddresses\\n */\\n int256[98] private _reserved;\\n\\n struct BaseStrategyConfig {\\n address platformAddress; // Address of the underlying platform\\n address vaultAddress; // Address of the OToken's Vault\\n }\\n\\n /**\\n * @param _config The platform and OToken vault addresses\\n */\\n constructor(BaseStrategyConfig memory _config) {\\n platformAddress = _config.platformAddress;\\n vaultAddress = _config.vaultAddress;\\n }\\n\\n /**\\n * @dev Internal initialize function, to set up initial internal state\\n * @param _rewardTokenAddresses Address of reward token for platform\\n * @param _assets Addresses of initial supported assets\\n * @param _pTokens Platform Token corresponding addresses\\n */\\n function _initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) internal {\\n rewardTokenAddresses = _rewardTokenAddresses;\\n\\n uint256 assetCount = _assets.length;\\n require(assetCount == _pTokens.length, \\\"Invalid input arrays\\\");\\n for (uint256 i = 0; i < assetCount; ++i) {\\n _setPTokenAddress(_assets[i], _pTokens[i]);\\n }\\n }\\n\\n /**\\n * @notice Collect accumulated reward token and send to Vault.\\n */\\n function collectRewardTokens() external virtual onlyHarvester nonReentrant {\\n _collectRewardTokens();\\n }\\n\\n /**\\n * @dev Default implementation that transfers reward tokens to the Harvester\\n * Implementing strategies need to add custom logic to collect the rewards.\\n */\\n function _collectRewardTokens() internal virtual {\\n uint256 rewardTokenCount = rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n IERC20 rewardToken = IERC20(rewardTokenAddresses[i]);\\n uint256 balance = rewardToken.balanceOf(address(this));\\n if (balance > 0) {\\n emit RewardTokenCollected(\\n harvesterAddress,\\n address(rewardToken),\\n balance\\n );\\n rewardToken.safeTransfer(harvesterAddress, balance);\\n }\\n }\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault.\\n */\\n modifier onlyVault() {\\n require(msg.sender == vaultAddress, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Harvester.\\n */\\n modifier onlyHarvester() {\\n require(msg.sender == harvesterAddress, \\\"Caller is not the Harvester\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault or Governor.\\n */\\n modifier onlyVaultOrGovernor() {\\n require(\\n msg.sender == vaultAddress || msg.sender == governor(),\\n \\\"Caller is not the Vault or Governor\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault, Governor, or Strategist.\\n */\\n modifier onlyVaultOrGovernorOrStrategist() {\\n require(\\n msg.sender == vaultAddress ||\\n msg.sender == governor() ||\\n msg.sender == IVault(vaultAddress).strategistAddr(),\\n \\\"Caller is not the Vault, Governor, or Strategist\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @notice Set the reward token addresses. Any old addresses will be overwritten.\\n * @param _rewardTokenAddresses Array of reward token addresses\\n */\\n function setRewardTokenAddresses(address[] calldata _rewardTokenAddresses)\\n external\\n onlyGovernor\\n {\\n uint256 rewardTokenCount = _rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n require(\\n _rewardTokenAddresses[i] != address(0),\\n \\\"Can not set an empty address as a reward token\\\"\\n );\\n }\\n\\n emit RewardTokenAddressesUpdated(\\n rewardTokenAddresses,\\n _rewardTokenAddresses\\n );\\n rewardTokenAddresses = _rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Get the reward token addresses.\\n * @return address[] the reward token addresses.\\n */\\n function getRewardTokenAddresses()\\n external\\n view\\n returns (address[] memory)\\n {\\n return rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * This method can only be called by the system Governor\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function setPTokenAddress(address _asset, address _pToken)\\n external\\n virtual\\n onlyGovernor\\n {\\n _setPTokenAddress(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Remove a supported asset by passing its index.\\n * This method can only be called by the system Governor\\n * @param _assetIndex Index of the asset to be removed\\n */\\n function removePToken(uint256 _assetIndex) external virtual onlyGovernor {\\n require(_assetIndex < assetsMapped.length, \\\"Invalid index\\\");\\n address asset = assetsMapped[_assetIndex];\\n address pToken = assetToPToken[asset];\\n\\n if (_assetIndex < assetsMapped.length - 1) {\\n assetsMapped[_assetIndex] = assetsMapped[assetsMapped.length - 1];\\n }\\n assetsMapped.pop();\\n assetToPToken[asset] = address(0);\\n\\n emit PTokenRemoved(asset, pToken);\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * Add to internal mappings and execute the platform specific,\\n * abstract method `_abstractSetPToken`\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function _setPTokenAddress(address _asset, address _pToken) internal {\\n require(assetToPToken[_asset] == address(0), \\\"pToken already set\\\");\\n require(\\n _asset != address(0) && _pToken != address(0),\\n \\\"Invalid addresses\\\"\\n );\\n\\n assetToPToken[_asset] = _pToken;\\n assetsMapped.push(_asset);\\n\\n emit PTokenAdded(_asset, _pToken);\\n\\n _abstractSetPToken(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\\n * strategy contracts, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n public\\n onlyGovernor\\n {\\n require(!supportsAsset(_asset), \\\"Cannot transfer supported asset\\\");\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @notice Set the Harvester contract that can collect rewards.\\n * @param _harvesterAddress Address of the harvester contract.\\n */\\n function setHarvesterAddress(address _harvesterAddress)\\n external\\n onlyGovernor\\n {\\n emit HarvesterAddressesUpdated(harvesterAddress, _harvesterAddress);\\n harvesterAddress = _harvesterAddress;\\n }\\n\\n /***************************************\\n Abstract\\n ****************************************/\\n\\n function _abstractSetPToken(address _asset, address _pToken)\\n internal\\n virtual;\\n\\n function safeApproveAllTokens() external virtual;\\n\\n /**\\n * @notice Deposit an amount of assets into the platform\\n * @param _asset Address for the asset\\n * @param _amount Units of asset to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external virtual;\\n\\n /**\\n * @notice Deposit all supported assets in this strategy contract to the platform\\n */\\n function depositAll() external virtual;\\n\\n /**\\n * @notice Withdraw an `amount` of assets from the platform and\\n * send to the `_recipient`.\\n * @param _recipient Address to which the asset should be sent\\n * @param _asset Address of the asset\\n * @param _amount Units of asset to withdraw\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external virtual;\\n\\n /**\\n * @notice Withdraw all supported assets from platform and\\n * sends to the OToken's Vault.\\n */\\n function withdrawAll() external virtual;\\n\\n /**\\n * @notice Get the total asset value held in the platform.\\n * This includes any interest that was generated since depositing.\\n * @param _asset Address of the asset\\n * @return balance Total value of the asset in the platform\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n virtual\\n returns (uint256 balance);\\n\\n /**\\n * @notice Check if an asset is supported.\\n * @param _asset Address of the asset\\n * @return bool Whether asset is supported\\n */\\n function supportsAsset(address _asset) public view virtual returns (bool);\\n}\\n\",\"keccak256\":\"0x5e17bb3db9f9e1014b7c5c836547f8fa81e02af7568c0bb8f2a2e0e7c2192db4\",\"license\":\"MIT\"},\"contracts/utils/InitializableERC20Detailed.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/**\\n * @dev Optional functions from the ERC20 standard.\\n * Converted from openzeppelin/contracts/token/ERC20/ERC20Detailed.sol\\n * @author Origin Protocol Inc\\n */\\nabstract contract InitializableERC20Detailed is IERC20 {\\n // Storage gap to skip storage from prior to OUSD reset\\n uint256[100] private _____gap;\\n\\n string private _name;\\n string private _symbol;\\n uint8 private _decimals;\\n\\n /**\\n * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of\\n * these values are immutable: they can only be set once during\\n * construction.\\n * @notice To avoid variable shadowing appended `Arg` after arguments name.\\n */\\n function _initialize(\\n string memory nameArg,\\n string memory symbolArg,\\n uint8 decimalsArg\\n ) internal {\\n _name = nameArg;\\n _symbol = symbolArg;\\n _decimals = decimalsArg;\\n }\\n\\n /**\\n * @notice Returns the name of the token.\\n */\\n function name() public view returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @notice Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @notice Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5,05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view returns (uint8) {\\n return _decimals;\\n }\\n}\\n\",\"keccak256\":\"0xe35ac2d813a30d845a3b52bba72588d7e936c2b3f3373d15568c14db46aeed60\",\"license\":\"MIT\"},\"contracts/utils/StableMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\n\\n// Based on StableMath from Stability Labs Pty. Ltd.\\n// https://github.com/mstable/mStable-contracts/blob/master/contracts/shared/StableMath.sol\\n\\nlibrary StableMath {\\n using SafeMath for uint256;\\n\\n /**\\n * @dev Scaling unit for use in specific calculations,\\n * where 1 * 10**18, or 1e18 represents a unit '1'\\n */\\n uint256 private constant FULL_SCALE = 1e18;\\n\\n /***************************************\\n Helpers\\n ****************************************/\\n\\n /**\\n * @dev Adjust the scale of an integer\\n * @param to Decimals to scale to\\n * @param from Decimals to scale from\\n */\\n function scaleBy(\\n uint256 x,\\n uint256 to,\\n uint256 from\\n ) internal pure returns (uint256) {\\n if (to > from) {\\n x = x.mul(10**(to - from));\\n } else if (to < from) {\\n // slither-disable-next-line divide-before-multiply\\n x = x.div(10**(from - to));\\n }\\n return x;\\n }\\n\\n /***************************************\\n Precise Arithmetic\\n ****************************************/\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncate(uint256 x, uint256 y) internal pure returns (uint256) {\\n return mulTruncateScale(x, y, FULL_SCALE);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the given scale. For example,\\n * when calculating 90% of 10e18, (10e18 * 9e17) / 1e18 = (9e36) / 1e18 = 9e18\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @param scale Scale unit\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncateScale(\\n uint256 x,\\n uint256 y,\\n uint256 scale\\n ) internal pure returns (uint256) {\\n // e.g. assume scale = fullScale\\n // z = 10e18 * 9e17 = 9e36\\n uint256 z = x.mul(y);\\n // return 9e36 / 1e18 = 9e18\\n return z.div(scale);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale, rounding up the result\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit, rounded up to the closest base unit.\\n */\\n function mulTruncateCeil(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e17 * 17268172638 = 138145381104e17\\n uint256 scaled = x.mul(y);\\n // e.g. 138145381104e17 + 9.99...e17 = 138145381113.99...e17\\n uint256 ceil = scaled.add(FULL_SCALE.sub(1));\\n // e.g. 13814538111.399...e18 / 1e18 = 13814538111\\n return ceil.div(FULL_SCALE);\\n }\\n\\n /**\\n * @dev Precisely divides two units, by first scaling the left hand operand. Useful\\n * for finding percentage weightings, i.e. 8e18/10e18 = 80% (or 8e17)\\n * @param x Left hand input to division\\n * @param y Right hand input to division\\n * @return Result after multiplying the left operand by the scale, and\\n * executing the division on the right hand input.\\n */\\n function divPrecisely(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e18 * 1e18 = 8e36\\n uint256 z = x.mul(FULL_SCALE);\\n // e.g. 8e36 / 10e18 = 8e17\\n return z.div(y);\\n }\\n}\\n\",\"keccak256\":\"0x1eb49f6f79045d9e0a8e1dced8e01d9e559e5fac554dcbb53e43140b601b04e7\",\"license\":\"MIT\"},\"contracts/vault/VaultStorage.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OToken VaultStorage contract\\n * @notice The VaultStorage contract defines the storage for the Vault contracts\\n * @author Origin Protocol Inc\\n */\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { OUSD } from \\\"../token/OUSD.sol\\\";\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\ncontract VaultStorage is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event OusdMetaStrategyUpdated(address _ousdMetaStrategy);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event NetOusdMintForStrategyThresholdChanged(uint256 _threshold);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Assets supported by the Vault, i.e. Stablecoins\\n enum UnitConversion {\\n DECIMALS,\\n GETEXCHANGERATE\\n }\\n // Changed to fit into a single storage slot so the decimals needs to be recached\\n struct Asset {\\n // Note: OETHVaultCore doesn't use `isSupported` when minting,\\n // redeeming or checking balance of assets.\\n bool isSupported;\\n UnitConversion unitConversion;\\n uint8 decimals;\\n // Max allowed slippage from the Oracle price when swapping collateral assets in basis points.\\n // For example 40 == 0.4% slippage\\n uint16 allowedOracleSlippageBps;\\n }\\n\\n /// @dev mapping of supported vault assets to their configuration\\n // slither-disable-next-line uninitialized-state\\n mapping(address => Asset) internal assets;\\n /// @dev list of all assets supported by the vault.\\n // slither-disable-next-line uninitialized-state\\n address[] internal allAssets;\\n\\n // Strategies approved for use by the Vault\\n struct Strategy {\\n bool isSupported;\\n uint256 _deprecated; // Deprecated storage slot\\n }\\n /// @dev mapping of strategy contracts to their configiration\\n mapping(address => Strategy) internal strategies;\\n /// @dev list of all vault strategies\\n address[] internal allStrategies;\\n\\n /// @notice Address of the Oracle price provider contract\\n // slither-disable-next-line uninitialized-state\\n address public priceProvider;\\n /// @notice pause rebasing if true\\n bool public rebasePaused = false;\\n /// @notice pause operations that change the OToken supply.\\n /// eg mint, redeem, allocate, mint/burn for strategy\\n bool public capitalPaused = true;\\n /// @notice Redemption fee in basis points. eg 50 = 0.5%\\n uint256 public redeemFeeBps;\\n /// @notice Percentage of assets to keep in Vault to handle (most) withdrawals. 100% = 1e18.\\n uint256 public vaultBuffer;\\n /// @notice OToken mints over this amount automatically allocate funds. 18 decimals.\\n uint256 public autoAllocateThreshold;\\n /// @notice OToken mints over this amount automatically rebase. 18 decimals.\\n uint256 public rebaseThreshold;\\n\\n /// @dev Address of the OToken token. eg OUSD or OETH.\\n // slither-disable-next-line uninitialized-state\\n OUSD internal oUSD;\\n\\n //keccak256(\\\"OUSD.vault.governor.admin.impl\\\");\\n bytes32 constant adminImplPosition =\\n 0xa2bd3d3cf188a41358c8b401076eb59066b09dec5775650c0de4c55187d17bd9;\\n\\n // Address of the contract responsible for post rebase syncs with AMMs\\n address private _deprecated_rebaseHooksAddr = address(0);\\n\\n // Deprecated: Address of Uniswap\\n // slither-disable-next-line constable-states\\n address private _deprecated_uniswapAddr = address(0);\\n\\n /// @notice Address of the Strategist\\n address public strategistAddr = address(0);\\n\\n /// @notice Mapping of asset address to the Strategy that they should automatically\\n // be allocated to\\n // slither-disable-next-line uninitialized-state\\n mapping(address => address) public assetDefaultStrategies;\\n\\n /// @notice Max difference between total supply and total value of assets. 18 decimals.\\n // slither-disable-next-line uninitialized-state\\n uint256 public maxSupplyDiff;\\n\\n /// @notice Trustee contract that can collect a percentage of yield\\n address public trusteeAddress;\\n\\n /// @notice Amount of yield collected in basis points. eg 2000 = 20%\\n uint256 public trusteeFeeBps;\\n\\n /// @dev Deprecated: Tokens that should be swapped for stablecoins\\n address[] private _deprecated_swapTokens;\\n\\n uint256 constant MINT_MINIMUM_UNIT_PRICE = 0.998e18;\\n\\n /// @notice Metapool strategy that is allowed to mint/burn OTokens without changing collateral\\n address public ousdMetaStrategy = address(0);\\n\\n /// @notice How much OTokens are currently minted by the strategy\\n int256 public netOusdMintedForStrategy = 0;\\n\\n /// @notice How much net total OTokens are allowed to be minted by all strategies\\n uint256 public netOusdMintForStrategyThreshold = 0;\\n\\n uint256 constant MIN_UNIT_PRICE_DRIFT = 0.7e18;\\n uint256 constant MAX_UNIT_PRICE_DRIFT = 1.3e18;\\n\\n /// @notice Collateral swap configuration.\\n /// @dev is packed into a single storage slot to save gas.\\n struct SwapConfig {\\n // Contract that swaps the vault's collateral assets\\n address swapper;\\n // Max allowed percentage the total value can drop below the total supply in basis points.\\n // For example 100 == 1%\\n uint16 allowedUndervalueBps;\\n }\\n SwapConfig internal swapConfig = SwapConfig(address(0), 0);\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /**\\n * @notice set the implementation for the admin, this needs to be in a base class else we cannot set it\\n * @param newImpl address of the implementation\\n */\\n function setAdminImpl(address newImpl) external onlyGovernor {\\n require(\\n Address.isContract(newImpl),\\n \\\"new implementation is not a contract\\\"\\n );\\n bytes32 position = adminImplPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newImpl)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xbcefeb5e2b88d99a54dbe6542dc25d0a68eeaf3adfe6e12fb70049cc024b1a79\",\"license\":\"MIT\"}},\"version\":1}", - "bytecode": "0x60e06040523480156200001157600080fd5b506040516200352f3803806200352f833981016040819052620000349162000215565b81816200004e336000805160206200350f83398151915255565b6000805160206200350f833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36001600160a01b038216620000aa57600080fd5b6001600160a01b038116620000be57600080fd5b606082811b6001600160601b03199081166080529082901b1660a052620000f181620000ff602090811b62000d3217901c565b60c052506200027992505050565b600080826001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b1580156200013c57600080fd5b505afa15801562000151573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200017791906200024d565b60ff169050600481101580156200018f575060128111155b620001f25760405162461bcd60e51b815260206004820152602960248201527f546f6b656e206d75737420686176652073756666696369656e7420646563696d604482015268616c20706c6163657360b81b606482015260840160405180910390fd5b92915050565b80516001600160a01b03811681146200021057600080fd5b919050565b600080604083850312156200022957600080fd5b6200023483620001f8565b91506200024460208401620001f8565b90509250929050565b6000602082840312156200026057600080fd5b815160ff811681146200027257600080fd5b9392505050565b60805160601c60a05160601c60c05161320c62000303600039600081816102910152611a8401526000818161026a015281816110630152818161115c0152818161128001528181611486015281816114ca01528181611b3701528181611bbd01528181611cea01526122a70152600081816101a301528181610539015261158b015261320c6000f3fe608060405234801561001057600080fd5b506004361061012c5760003560e01c806382aa1c88116100ad578063d38bfff411610071578063d38bfff414610312578063da70696c14610325578063dac4db4e14610345578063e48d7fc514610358578063ee3be5f5146103ac57600080fd5b806382aa1c881461028c578063a994317f146102c1578063b13dc20a146102d4578063b76e83af146102e7578063c7af3352146102fa57600080fd5b8063548f5ae5116100f4578063548f5ae5146101c5578063587c8440146101d85780635d36b1901461024a57806365f6fa94146102525780637cb374bd1461026557600080fd5b80630c340a24146101315780631072cbea146101565780632579153d1461016b5780632dfbe8311461017e578063430bf08a1461019e575b600080fd5b6101396103cf565b6040516001600160a01b0390911681526020015b60405180910390f35b6101696101643660046126ec565b6103ec565b005b61016961017936600461264f565b610439565b61019161018c3660046125ae565b6108c8565b60405161014d9190612b1f565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6101696101d33660046125ae565b610962565b6102386101e63660046125ae565b6000602081905290815260409020805460019091015461ffff80831692620100008104909116916001600160a01b036401000000008304169160ff600160c01b8204811692600160c81b909204169086565b60405161014d96959493929190612cb0565b6101696109dd565b610169610260366004612621565b610a83565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6102b37f000000000000000000000000000000000000000000000000000000000000000081565b60405190815260200161014d565b6101696102cf3660046125e8565b610b0a565b6101696102e23660046125ae565b610b86565b600254610139906001600160a01b031681565b610302610c25565b604051901515815260200161014d565b6101696103203660046125ae565b610c56565b6102b36103333660046125ae565b60056020526000908152604090205481565b6101396103533660046126ec565b610cfa565b61038c6103663660046125ae565b6006602052600090815260409020546001600160801b0380821691600160801b90041682565b604080516001600160801b0393841681529290911660208301520161014d565b6103026103ba3660046125ae565b60016020526000908152604090205460ff1681565b60006103e76000805160206131b78339815191525490565b905090565b6103f4610c25565b6104195760405162461bcd60e51b815260040161041090612b5f565b60405180910390fd5b6104356104246103cf565b6001600160a01b0384169083610e21565b5050565b610441610c25565b61045d5760405162461bcd60e51b815260040161041090612b5f565b6103e861046d60208501856129aa565b61ffff1611156104905760405163faa3445560e01b815260040160405180910390fd5b6103e86104a360408501602086016129aa565b61ffff1611156104c657604051631633c8cd60e31b815260040160405180910390fd5b60006104d860608501604086016125ae565b90506001600160a01b03811661050157604051637138356f60e01b815260040160405180910390fd5b6001600160a01b03808616600090815260208190526040902080546401000000009004909116908590610534828261307b565b9050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b15801561059057600080fd5b505afa1580156105a4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105c891906125cb565b6040516315d5220f60e31b81526001600160a01b038881166004830152919091169063aea910789060240160206040518083038186803b15801561060b57600080fd5b505afa15801561061f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061064391906129c7565b50856001600160a01b0382161580159061066f5750826001600160a01b0316826001600160a01b031614155b15610689576106896001600160a01b038216836000610e89565b826001600160a01b0316826001600160a01b0316146106cd576106b76001600160a01b038216846000610e89565b6106cd6001600160a01b03821684600019610e89565b60006106df60a0880160808901612932565b905060008160038111156106f5576106f561301f565b14156107395761070686868a610fad565b6001600160a01b0389166000908152600360209081526040909120825161073393919291909101906124a4565b50610846565b600181600381111561074d5761074d61301f565b14156107815761075e86868a6110d9565b6001600160a01b038a166000908152600460205260409020610733929091612509565b60028160038111156107955761079561301f565b14156107c5576107a78686868b6111af565b6001600160a01b038916600090815260056020526040902055610846565b60038160038111156107d9576107d961301f565b141561082b576107eb8686868b611311565b6001600160a01b0389166000908152600660209081526040909120825192909101516001600160801b03908116600160801b029216919091179055610846565b806040516336cb1d2160e01b81526004016104109190612b32565b7f5eb6073ba3980477f03b1ce0dccba754d48454bbd65a115dcd42db65ca1fefd28861087560208a018a6129aa565b61088560408b0160208c016129aa565b84888b8b8e60a001358f60600160208101906108a191906128df565b6040516108b699989796959493929190612aa0565b60405180910390a15050505050505050565b600460205260009081526040902080546108e190612fb3565b80601f016020809104026020016040519081016040528092919081815260200182805461090d90612fb3565b801561095a5780601f1061092f5761010080835404028352916020019161095a565b820191906000526020600020905b81548152906001019060200180831161093d57829003601f168201915b505050505081565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535805460028114156109c75760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b600282556109d58333611500565b506001905550565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610a785760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610410565b610a8133611667565b565b610a8b610c25565b610aa75760405162461bcd60e51b815260040161041090612b5f565b6001600160a01b038216600081815260016020908152604091829020805460ff19168515159081179091558251938452908301527f013ed61add17cbfcbbd95bf8543da67c89658c5477d3f3199a1a2d58ecf1913f910160405180910390a15050565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac453580546002811415610b6f5760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b60028255610b7d8484611500565b50600190555050565b610b8e610c25565b610baa5760405162461bcd60e51b815260040161041090612b5f565b6001600160a01b038116610bd157604051637138356f60e01b815260040160405180910390fd5b600280546001600160a01b0319166001600160a01b0383169081179091556040519081527f50f4ca9002119593802480c412cb5e106ae726647a31dcf8a7e7ed4e6794bf5e9060200160405180910390a150565b6000610c3d6000805160206131b78339815191525490565b6001600160a01b0316336001600160a01b031614905090565b610c5e610c25565b610c7a5760405162461bcd60e51b815260040161041090612b5f565b610ca2817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b0316610cc26000805160206131b78339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b60036020528160005260406000208181548110610d1657600080fd5b6000918252602090912001546001600160a01b03169150829050565b600080826001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b158015610d6e57600080fd5b505afa158015610d82573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610da69190612a21565b60ff16905060048110158015610dbd575060128111155b610e1b5760405162461bcd60e51b815260206004820152602960248201527f546f6b656e206d75737420686176652073756666696369656e7420646563696d604482015268616c20706c6163657360b81b6064820152608401610410565b92915050565b6040516001600160a01b038316602482015260448101829052610e8490849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261172b565b505050565b801580610f125750604051636eb1769f60e11b81523060048201526001600160a01b03838116602483015284169063dd62ed3e9060440160206040518083038186803b158015610ed857600080fd5b505afa158015610eec573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f1091906129c7565b155b610f7d5760405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b6064820152608401610410565b6040516001600160a01b038316602482015260448101829052610e8490849063095ea7b360e01b90606401610e4d565b6060610fbb83850185612718565b80519091506002811015610fe2576040516360fa33db60e11b815260040160405180910390fd5b826001600160a01b031682600081518110610fff57610fff613035565b60200260200101516001600160a01b031614611059578160008151811061102857611028613035565b602002602001015160405163280d94a560e21b815260040161041091906001600160a01b0391909116815260200190565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168261108f600184612f37565b8151811061109f5761109f613035565b60200260200101516001600160a01b0316146110d157816110c1600183612f37565b8151811061102857611028613035565b509392505050565b828260006110ea6014828486612dbe565b6110f391612f4e565b60601c90506001600160a01b038416811461112c5760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b8585611139601485612f37565b611144928290612dbe565b61114d91612f4e565b60601c90506001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001681146111a65760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b50935093915050565b60006111bd84860186612919565b9050806111dd57604051634bdc2c9560e01b815260040160405180910390fd5b60405163160bf1c960e31b8152600481018290526001600160a01b03838116602483015284919082169063b05f8e489060440160806040518083038186803b15801561122857600080fd5b505afa15801561123c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061126091906129e0565b505060405163160bf1c960e31b8152600481018590526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811660248301528416925063b05f8e48915060440160806040518083038186803b1580156112cc57600080fd5b505afa1580156112e0573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061130491906129e0565b5050505050949350505050565b60408051808201909152600080825260208201526113318486018661294f565b805160405163c661065760e01b81526001600160801b03909116600482015290915083906001600160a01b0382169063c66106579060240160206040518083038186803b15801561138157600080fd5b505afa158015611395573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b991906125cb565b6001600160a01b0316836001600160a01b0316146113f55760405163d658230160e01b81526001600160a01b0384166004820152602401610410565b602082015160405163c661065760e01b81526001600160801b0390911660048201526001600160a01b0382169063c66106579060240160206040518083038186803b15801561144357600080fd5b505afa158015611457573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061147b91906125cb565b6001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316146114f75760405163d658230160e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166004820152602401610410565b50949350505050565b611509826117fd565b60008290506000816001600160a01b031663f6ca71b06040518163ffffffff1660e01b815260040160006040518083038186803b15801561154957600080fd5b505afa15801561155d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261158591908101906127be565b905060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b1580156115e257600080fd5b505afa1580156115f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061161a91906125cb565b825190915060005b8181101561165e5761164e84828151811061163f5761163f613035565b6020026020010151878561189d565b61165781612fee565b9050611622565b50505050505050565b6001600160a01b0381166116bd5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610410565b806001600160a01b03166116dd6000805160206131b78339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a3611728816000805160206131b783398151915255565b50565b6000611780826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316611d489092919063ffffffff16565b805190915015610e84578080602001905181019061179e91906128fc565b610e845760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610410565b6001600160a01b03811660009081526001602052604090205460ff1661184157604051630211444960e11b81526001600160a01b0382166004820152602401610410565b6000819050806001600160a01b0316635a063f636040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561188157600080fd5b505af1158015611895573d6000803e3d6000fd5b505050505050565b6001600160a01b03808416600090815260208181526040808320815160c081018352815461ffff8082168352620100008204169482019490945264010000000084049095169185019190915260ff600160c01b830481161515606086015292939290916080840191600160c81b90910416600381111561191f5761191f61301f565b60038111156119305761193061301f565b81526020016001820154815250509050806060015161194f5750505050565b6040516370a0823160e01b81523060048201526000906001600160a01b038616906370a082319060240160206040518083038186803b15801561199157600080fd5b505afa1580156119a5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119c991906129c7565b9050806119d7575050505050565b60a0820151156119f2576119ef818360a00151611d61565b90505b6040516315d5220f60e31b81526001600160a01b0386811660048301526000919085169063aea910789060240160206040518083038186803b158015611a3757600080fd5b505afa158015611a4b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611a6f91906129c7565b90506000670de0b6b3a7640000612710611adb7f0000000000000000000000000000000000000000000000000000000000000000611aac8b610d32565b88518790611abc90612710612f14565b611aca9061ffff168a612ef5565b611ad49190612ef5565b9190611d77565b611ae59190612de8565b611aef9190612de8565b90506000611b08856080015186604001518a8786611dd9565b905081811015611b35576040516302d96fff60e41b81526004810182905260248101839052604401610410565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316886001600160a01b03167fa861903141bc68b536d5048a576afcc645630e1b18a4296ef34cbd4d1407f70987608001518785604051611ba093929190612b40565b60405180910390a36040516370a0823160e01b81523060048201527f0000000000000000000000000000000000000000000000000000000000000000906000906001600160a01b038316906370a082319060240160206040518083038186803b158015611c0c57600080fd5b505afa158015611c20573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c4491906129c7565b905082811015611c715760405163315d50df60e11b81526004810182905260248101849052604401610410565b6020870151600090611c8b90859061ffff16612710611e9d565b90506000611c998284612f37565b600254909150611cb6906001600160a01b03868116911683610e21565b611cca6001600160a01b0385168c84610e21565b604080516001600160a01b038d81168252602082018490529181018490527f0000000000000000000000000000000000000000000000000000000000000000909116907f42e60aae8f000883c46e2f449fa76268e374ce1b962f46ca9360ab98b18f57999060600160405180910390a2505050505050505050505050565b6060611d578484600085611eb6565b90505b9392505050565b6000818310611d705781611d5a565b5090919050565b600081831115611da757611da0611d8e8385612f37565b611d9990600a612e4d565b8590611fde565b9350611dd1565b81831015611dd157611dce611dbc8484612f37565b611dc790600a612e4d565b8590611fea565b93505b509192915050565b600080866003811115611dee57611dee61301f565b1415611e0757611e0085858585611ff6565b9050611e94565b6001866003811115611e1b57611e1b61301f565b1415611e2d57611e0085858585612125565b6002866003811115611e4157611e4161301f565b1415611e5357611e0085858585612270565b6003866003811115611e6757611e6761301f565b1415611e7957611e0085858585612392565b856040516336cb1d2160e01b81526004016104109190612b32565b95945050505050565b600080611eaa8585611fde565b9050611e948184611fea565b606082471015611f175760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610410565b843b611f655760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610410565b600080866001600160a01b03168587604051611f819190612a84565b60006040518083038185875af1925050503d8060008114611fbe576040519150601f19603f3d011682016040523d82523d6000602084013e611fc3565b606091505b5091509150611fd382828661246b565b979650505050505050565b6000611d5a8284612ef5565b6000611d5a8284612de8565b6001600160a01b03831660009081526003602090815260408083208054825181850281018501909352808352849383018282801561205d57602002820191906000526020600020905b81546001600160a01b0316815260019091019060200180831161203f575b505050505090506000866001600160a01b03166338ed173986868530426040518663ffffffff1660e01b815260040161209a959493929190612cf8565b600060405180830381600087803b1580156120b457600080fd5b505af11580156120c8573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526120f09190810190612853565b905080600182516121019190612f37565b8151811061211157612111613035565b602002602001015192505050949350505050565b6001600160a01b0383166000908152600460205260408120805482919061214b90612fb3565b80601f016020809104026020016040519081016040528092919081815260200182805461217790612fb3565b80156121c45780601f10612199576101008083540402835291602001916121c4565b820191906000526020600020905b8154815290600101906020018083116121a757829003601f168201915b50506040805160a0810182528581523060208201524281830152606081018a905260808101899052905163c04b8d5960e01b8152949550936001600160a01b038b16935063c04b8d59925061221e91508490600401612b96565b602060405180830381600087803b15801561223857600080fd5b505af115801561224c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611fd391906129c7565b6001600160a01b03838116600081815260056020908152604080832054815160c081018352818152808401859052808301959095527f0000000000000000000000000000000000000000000000000000000000000000861660608087019190915260808087018a90528351808601855286815260a0880152835190810184523080825294810186905280840194909452830184905290516352bbbe2960e01b81529294909392908916906352bbbe299061233490859085908a904290600401612bee565b602060405180830381600087803b15801561234e57600080fd5b505af1158015612362573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061238691906129c7565b98975050505050505050565b6001600160a01b0383811660009081526006602090815260408083208151808301835290546001600160801b03808216808452600160801b909204169382018490529151630b68372160e31b81526004810192909252602482019290925260448101869052606481018590529192909190871690635b41b90890608401602060405180830381600087803b15801561242957600080fd5b505af115801561243d573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061246191906129c7565b9695505050505050565b6060831561247a575081611d5a565b82511561248a5782518084602001fd5b8160405162461bcd60e51b81526004016104109190612b1f565b8280548282559060005260206000209081019282156124f9579160200282015b828111156124f957825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906124c4565b5061250592915061257d565b5090565b82805461251590612fb3565b90600052602060002090601f01602090048101928261253757600085556124f9565b82601f106125505782800160ff198235161785556124f9565b828001600101855582156124f9579182015b828111156124f9578235825591602001919060010190612562565b5b80821115612505576000815560010161257e565b80356001600160801b03811681146125a957600080fd5b919050565b6000602082840312156125c057600080fd5b8135611d5a81613176565b6000602082840312156125dd57600080fd5b8151611d5a81613176565b600080604083850312156125fb57600080fd5b823561260681613176565b9150602083013561261681613176565b809150509250929050565b6000806040838503121561263457600080fd5b823561263f81613176565b915060208301356126168161318b565b60008060008084860361010081121561266757600080fd5b853561267281613176565b945060c0601f198201121561268657600080fd5b5060208501925060e085013567ffffffffffffffff808211156126a857600080fd5b818701915087601f8301126126bc57600080fd5b8135818111156126cb57600080fd5b8860208285010111156126dd57600080fd5b95989497505060200194505050565b600080604083850312156126ff57600080fd5b823561270a81613176565b946020939093013593505050565b6000602080838503121561272b57600080fd5b823567ffffffffffffffff81111561274257600080fd5b8301601f8101851361275357600080fd5b803561276661276182612d9a565b612d69565b80828252848201915084840188868560051b870101111561278657600080fd5b600094505b838510156127b257803561279e81613176565b83526001949094019391850191850161278b565b50979650505050505050565b600060208083850312156127d157600080fd5b825167ffffffffffffffff8111156127e857600080fd5b8301601f810185136127f957600080fd5b805161280761276182612d9a565b80828252848201915084840188868560051b870101111561282757600080fd5b600094505b838510156127b257805161283f81613176565b83526001949094019391850191850161282c565b6000602080838503121561286657600080fd5b825167ffffffffffffffff81111561287d57600080fd5b8301601f8101851361288e57600080fd5b805161289c61276182612d9a565b80828252848201915084840188868560051b87010111156128bc57600080fd5b600094505b838510156127b25780518352600194909401939185019185016128c1565b6000602082840312156128f157600080fd5b8135611d5a8161318b565b60006020828403121561290e57600080fd5b8151611d5a8161318b565b60006020828403121561292b57600080fd5b5035919050565b60006020828403121561294457600080fd5b8135611d5a81613199565b60006040828403121561296157600080fd5b6040516040810181811067ffffffffffffffff821117156129845761298461304b565b60405261299083612592565b815261299e60208401612592565b60208201529392505050565b6000602082840312156129bc57600080fd5b8135611d5a816131a6565b6000602082840312156129d957600080fd5b5051919050565b600080600080608085870312156129f657600080fd5b8451935060208501519250604085015191506060850151612a1681613176565b939692955090935050565b600060208284031215612a3357600080fd5b815160ff81168114611d5a57600080fd5b60008151808452612a5c816020860160208601612f83565b601f01601f19169290920160200192915050565b60048110612a8057612a8061301f565b9052565b60008251612a96818460208701612f83565b9190910192915050565b6001600160a01b038a8116825261ffff8a811660208401528916604083015260009061010090612ad3606085018b612a70565b8816608084015260a083018190528201859052610120858782850137600083870182015260c08301949094525090151560e0820152601f909201601f1916909101019695505050505050565b602081526000611d5a6020830184612a44565b60208101610e1b8284612a70565b60608101612b4e8286612a70565b602082019390935260400152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b602081526000825160a06020840152612bb260c0840182612a44565b905060018060a01b0360208501511660408401526040840151606084015260608401516080840152608084015160a08401528091505092915050565b60e08152845160e08201526000602086015160028110612c1057612c1061301f565b61010083015260408601516001600160a01b03908116610120840152606087015116610140830152608086015161016083015260a086015160c0610180840152612c5e6101a0840182612a44565b915050612c9e602083018680516001600160a01b039081168352602080830151151590840152604080830151909116908301526060908101511515910152565b60a082019390935260c0015292915050565b61ffff8781168252861660208201526001600160a01b0385166040820152831515606082015260c08101612ce76080830185612a70565b8260a0830152979650505050505050565b600060a082018783526020878185015260a0604085015281875180845260c086019150828901935060005b81811015612d485784516001600160a01b031683529383019391830191600101612d23565b50506001600160a01b03969096166060850152505050608001529392505050565b604051601f8201601f1916810167ffffffffffffffff81118282101715612d9257612d9261304b565b604052919050565b600067ffffffffffffffff821115612db457612db461304b565b5060051b60200190565b60008085851115612dce57600080fd5b83861115612ddb57600080fd5b5050820193919092039150565b600082612e0557634e487b7160e01b600052601260045260246000fd5b500490565b600181815b80851115612e45578160001904821115612e2b57612e2b613009565b80851615612e3857918102915b93841c9390800290612e0f565b509250929050565b6000611d5a8383600082612e6357506001610e1b565b81612e7057506000610e1b565b8160018114612e865760028114612e9057612eac565b6001915050610e1b565b60ff841115612ea157612ea1613009565b50506001821b610e1b565b5060208310610133831016604e8410600b8410161715612ecf575081810a610e1b565b612ed98383612e0a565b8060001904821115612eed57612eed613009565b029392505050565b6000816000190483118215151615612f0f57612f0f613009565b500290565b600061ffff83811690831681811015612f2f57612f2f613009565b039392505050565b600082821015612f4957612f49613009565b500390565b6bffffffffffffffffffffffff198135818116916014851015612f7b5780818660140360031b1b83161692505b505092915050565b60005b83811015612f9e578181015183820152602001612f86565b83811115612fad576000848401525b50505050565b600181811c90821680612fc757607f821691505b60208210811415612fe857634e487b7160e01b600052602260045260246000fd5b50919050565b600060001982141561300257613002613009565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b60008135610e1b8161318b565b60008135610e1b81613199565b8135613086816131a6565b61ffff8116905081548161ffff19821617835560208401356130a7816131a6565b63ffff00008160101b169050808363ffffffff1984161717845560408501356130cf81613176565b6001600160c01b0319929092169092179190911760209190911b640100000000600160c01b031617815561312661310860608401613061565b82805460ff60c01b191691151560c01b60ff60c01b16919091179055565b61313b6131356080840161306e565b82613149565b60a082013560018201555050565b600482106131595761315961301f565b805460ff60c81b191660c89290921b60ff60c81b16919091179055565b6001600160a01b038116811461172857600080fd5b801515811461172857600080fd5b6004811061172857600080fd5b61ffff8116811461172857600080fdfe7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa2646970667358221220a027d837b490da1a267b5f9d265801eb2ba7a5c697f983dfeceefae0e7d2981e64736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", - "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061012c5760003560e01c806382aa1c88116100ad578063d38bfff411610071578063d38bfff414610312578063da70696c14610325578063dac4db4e14610345578063e48d7fc514610358578063ee3be5f5146103ac57600080fd5b806382aa1c881461028c578063a994317f146102c1578063b13dc20a146102d4578063b76e83af146102e7578063c7af3352146102fa57600080fd5b8063548f5ae5116100f4578063548f5ae5146101c5578063587c8440146101d85780635d36b1901461024a57806365f6fa94146102525780637cb374bd1461026557600080fd5b80630c340a24146101315780631072cbea146101565780632579153d1461016b5780632dfbe8311461017e578063430bf08a1461019e575b600080fd5b6101396103cf565b6040516001600160a01b0390911681526020015b60405180910390f35b6101696101643660046126ec565b6103ec565b005b61016961017936600461264f565b610439565b61019161018c3660046125ae565b6108c8565b60405161014d9190612b1f565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6101696101d33660046125ae565b610962565b6102386101e63660046125ae565b6000602081905290815260409020805460019091015461ffff80831692620100008104909116916001600160a01b036401000000008304169160ff600160c01b8204811692600160c81b909204169086565b60405161014d96959493929190612cb0565b6101696109dd565b610169610260366004612621565b610a83565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6102b37f000000000000000000000000000000000000000000000000000000000000000081565b60405190815260200161014d565b6101696102cf3660046125e8565b610b0a565b6101696102e23660046125ae565b610b86565b600254610139906001600160a01b031681565b610302610c25565b604051901515815260200161014d565b6101696103203660046125ae565b610c56565b6102b36103333660046125ae565b60056020526000908152604090205481565b6101396103533660046126ec565b610cfa565b61038c6103663660046125ae565b6006602052600090815260409020546001600160801b0380821691600160801b90041682565b604080516001600160801b0393841681529290911660208301520161014d565b6103026103ba3660046125ae565b60016020526000908152604090205460ff1681565b60006103e76000805160206131b78339815191525490565b905090565b6103f4610c25565b6104195760405162461bcd60e51b815260040161041090612b5f565b60405180910390fd5b6104356104246103cf565b6001600160a01b0384169083610e21565b5050565b610441610c25565b61045d5760405162461bcd60e51b815260040161041090612b5f565b6103e861046d60208501856129aa565b61ffff1611156104905760405163faa3445560e01b815260040160405180910390fd5b6103e86104a360408501602086016129aa565b61ffff1611156104c657604051631633c8cd60e31b815260040160405180910390fd5b60006104d860608501604086016125ae565b90506001600160a01b03811661050157604051637138356f60e01b815260040160405180910390fd5b6001600160a01b03808616600090815260208190526040902080546401000000009004909116908590610534828261307b565b9050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b15801561059057600080fd5b505afa1580156105a4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105c891906125cb565b6040516315d5220f60e31b81526001600160a01b038881166004830152919091169063aea910789060240160206040518083038186803b15801561060b57600080fd5b505afa15801561061f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061064391906129c7565b50856001600160a01b0382161580159061066f5750826001600160a01b0316826001600160a01b031614155b15610689576106896001600160a01b038216836000610e89565b826001600160a01b0316826001600160a01b0316146106cd576106b76001600160a01b038216846000610e89565b6106cd6001600160a01b03821684600019610e89565b60006106df60a0880160808901612932565b905060008160038111156106f5576106f561301f565b14156107395761070686868a610fad565b6001600160a01b0389166000908152600360209081526040909120825161073393919291909101906124a4565b50610846565b600181600381111561074d5761074d61301f565b14156107815761075e86868a6110d9565b6001600160a01b038a166000908152600460205260409020610733929091612509565b60028160038111156107955761079561301f565b14156107c5576107a78686868b6111af565b6001600160a01b038916600090815260056020526040902055610846565b60038160038111156107d9576107d961301f565b141561082b576107eb8686868b611311565b6001600160a01b0389166000908152600660209081526040909120825192909101516001600160801b03908116600160801b029216919091179055610846565b806040516336cb1d2160e01b81526004016104109190612b32565b7f5eb6073ba3980477f03b1ce0dccba754d48454bbd65a115dcd42db65ca1fefd28861087560208a018a6129aa565b61088560408b0160208c016129aa565b84888b8b8e60a001358f60600160208101906108a191906128df565b6040516108b699989796959493929190612aa0565b60405180910390a15050505050505050565b600460205260009081526040902080546108e190612fb3565b80601f016020809104026020016040519081016040528092919081815260200182805461090d90612fb3565b801561095a5780601f1061092f5761010080835404028352916020019161095a565b820191906000526020600020905b81548152906001019060200180831161093d57829003601f168201915b505050505081565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535805460028114156109c75760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b600282556109d58333611500565b506001905550565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610a785760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610410565b610a8133611667565b565b610a8b610c25565b610aa75760405162461bcd60e51b815260040161041090612b5f565b6001600160a01b038216600081815260016020908152604091829020805460ff19168515159081179091558251938452908301527f013ed61add17cbfcbbd95bf8543da67c89658c5477d3f3199a1a2d58ecf1913f910160405180910390a15050565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac453580546002811415610b6f5760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b60028255610b7d8484611500565b50600190555050565b610b8e610c25565b610baa5760405162461bcd60e51b815260040161041090612b5f565b6001600160a01b038116610bd157604051637138356f60e01b815260040160405180910390fd5b600280546001600160a01b0319166001600160a01b0383169081179091556040519081527f50f4ca9002119593802480c412cb5e106ae726647a31dcf8a7e7ed4e6794bf5e9060200160405180910390a150565b6000610c3d6000805160206131b78339815191525490565b6001600160a01b0316336001600160a01b031614905090565b610c5e610c25565b610c7a5760405162461bcd60e51b815260040161041090612b5f565b610ca2817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b0316610cc26000805160206131b78339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b60036020528160005260406000208181548110610d1657600080fd5b6000918252602090912001546001600160a01b03169150829050565b600080826001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b158015610d6e57600080fd5b505afa158015610d82573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610da69190612a21565b60ff16905060048110158015610dbd575060128111155b610e1b5760405162461bcd60e51b815260206004820152602960248201527f546f6b656e206d75737420686176652073756666696369656e7420646563696d604482015268616c20706c6163657360b81b6064820152608401610410565b92915050565b6040516001600160a01b038316602482015260448101829052610e8490849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261172b565b505050565b801580610f125750604051636eb1769f60e11b81523060048201526001600160a01b03838116602483015284169063dd62ed3e9060440160206040518083038186803b158015610ed857600080fd5b505afa158015610eec573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f1091906129c7565b155b610f7d5760405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b6064820152608401610410565b6040516001600160a01b038316602482015260448101829052610e8490849063095ea7b360e01b90606401610e4d565b6060610fbb83850185612718565b80519091506002811015610fe2576040516360fa33db60e11b815260040160405180910390fd5b826001600160a01b031682600081518110610fff57610fff613035565b60200260200101516001600160a01b031614611059578160008151811061102857611028613035565b602002602001015160405163280d94a560e21b815260040161041091906001600160a01b0391909116815260200190565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168261108f600184612f37565b8151811061109f5761109f613035565b60200260200101516001600160a01b0316146110d157816110c1600183612f37565b8151811061102857611028613035565b509392505050565b828260006110ea6014828486612dbe565b6110f391612f4e565b60601c90506001600160a01b038416811461112c5760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b8585611139601485612f37565b611144928290612dbe565b61114d91612f4e565b60601c90506001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001681146111a65760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b50935093915050565b60006111bd84860186612919565b9050806111dd57604051634bdc2c9560e01b815260040160405180910390fd5b60405163160bf1c960e31b8152600481018290526001600160a01b03838116602483015284919082169063b05f8e489060440160806040518083038186803b15801561122857600080fd5b505afa15801561123c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061126091906129e0565b505060405163160bf1c960e31b8152600481018590526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811660248301528416925063b05f8e48915060440160806040518083038186803b1580156112cc57600080fd5b505afa1580156112e0573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061130491906129e0565b5050505050949350505050565b60408051808201909152600080825260208201526113318486018661294f565b805160405163c661065760e01b81526001600160801b03909116600482015290915083906001600160a01b0382169063c66106579060240160206040518083038186803b15801561138157600080fd5b505afa158015611395573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b991906125cb565b6001600160a01b0316836001600160a01b0316146113f55760405163d658230160e01b81526001600160a01b0384166004820152602401610410565b602082015160405163c661065760e01b81526001600160801b0390911660048201526001600160a01b0382169063c66106579060240160206040518083038186803b15801561144357600080fd5b505afa158015611457573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061147b91906125cb565b6001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316146114f75760405163d658230160e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166004820152602401610410565b50949350505050565b611509826117fd565b60008290506000816001600160a01b031663f6ca71b06040518163ffffffff1660e01b815260040160006040518083038186803b15801561154957600080fd5b505afa15801561155d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261158591908101906127be565b905060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b1580156115e257600080fd5b505afa1580156115f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061161a91906125cb565b825190915060005b8181101561165e5761164e84828151811061163f5761163f613035565b6020026020010151878561189d565b61165781612fee565b9050611622565b50505050505050565b6001600160a01b0381166116bd5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610410565b806001600160a01b03166116dd6000805160206131b78339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a3611728816000805160206131b783398151915255565b50565b6000611780826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316611d489092919063ffffffff16565b805190915015610e84578080602001905181019061179e91906128fc565b610e845760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610410565b6001600160a01b03811660009081526001602052604090205460ff1661184157604051630211444960e11b81526001600160a01b0382166004820152602401610410565b6000819050806001600160a01b0316635a063f636040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561188157600080fd5b505af1158015611895573d6000803e3d6000fd5b505050505050565b6001600160a01b03808416600090815260208181526040808320815160c081018352815461ffff8082168352620100008204169482019490945264010000000084049095169185019190915260ff600160c01b830481161515606086015292939290916080840191600160c81b90910416600381111561191f5761191f61301f565b60038111156119305761193061301f565b81526020016001820154815250509050806060015161194f5750505050565b6040516370a0823160e01b81523060048201526000906001600160a01b038616906370a082319060240160206040518083038186803b15801561199157600080fd5b505afa1580156119a5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119c991906129c7565b9050806119d7575050505050565b60a0820151156119f2576119ef818360a00151611d61565b90505b6040516315d5220f60e31b81526001600160a01b0386811660048301526000919085169063aea910789060240160206040518083038186803b158015611a3757600080fd5b505afa158015611a4b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611a6f91906129c7565b90506000670de0b6b3a7640000612710611adb7f0000000000000000000000000000000000000000000000000000000000000000611aac8b610d32565b88518790611abc90612710612f14565b611aca9061ffff168a612ef5565b611ad49190612ef5565b9190611d77565b611ae59190612de8565b611aef9190612de8565b90506000611b08856080015186604001518a8786611dd9565b905081811015611b35576040516302d96fff60e41b81526004810182905260248101839052604401610410565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316886001600160a01b03167fa861903141bc68b536d5048a576afcc645630e1b18a4296ef34cbd4d1407f70987608001518785604051611ba093929190612b40565b60405180910390a36040516370a0823160e01b81523060048201527f0000000000000000000000000000000000000000000000000000000000000000906000906001600160a01b038316906370a082319060240160206040518083038186803b158015611c0c57600080fd5b505afa158015611c20573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c4491906129c7565b905082811015611c715760405163315d50df60e11b81526004810182905260248101849052604401610410565b6020870151600090611c8b90859061ffff16612710611e9d565b90506000611c998284612f37565b600254909150611cb6906001600160a01b03868116911683610e21565b611cca6001600160a01b0385168c84610e21565b604080516001600160a01b038d81168252602082018490529181018490527f0000000000000000000000000000000000000000000000000000000000000000909116907f42e60aae8f000883c46e2f449fa76268e374ce1b962f46ca9360ab98b18f57999060600160405180910390a2505050505050505050505050565b6060611d578484600085611eb6565b90505b9392505050565b6000818310611d705781611d5a565b5090919050565b600081831115611da757611da0611d8e8385612f37565b611d9990600a612e4d565b8590611fde565b9350611dd1565b81831015611dd157611dce611dbc8484612f37565b611dc790600a612e4d565b8590611fea565b93505b509192915050565b600080866003811115611dee57611dee61301f565b1415611e0757611e0085858585611ff6565b9050611e94565b6001866003811115611e1b57611e1b61301f565b1415611e2d57611e0085858585612125565b6002866003811115611e4157611e4161301f565b1415611e5357611e0085858585612270565b6003866003811115611e6757611e6761301f565b1415611e7957611e0085858585612392565b856040516336cb1d2160e01b81526004016104109190612b32565b95945050505050565b600080611eaa8585611fde565b9050611e948184611fea565b606082471015611f175760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610410565b843b611f655760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610410565b600080866001600160a01b03168587604051611f819190612a84565b60006040518083038185875af1925050503d8060008114611fbe576040519150601f19603f3d011682016040523d82523d6000602084013e611fc3565b606091505b5091509150611fd382828661246b565b979650505050505050565b6000611d5a8284612ef5565b6000611d5a8284612de8565b6001600160a01b03831660009081526003602090815260408083208054825181850281018501909352808352849383018282801561205d57602002820191906000526020600020905b81546001600160a01b0316815260019091019060200180831161203f575b505050505090506000866001600160a01b03166338ed173986868530426040518663ffffffff1660e01b815260040161209a959493929190612cf8565b600060405180830381600087803b1580156120b457600080fd5b505af11580156120c8573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526120f09190810190612853565b905080600182516121019190612f37565b8151811061211157612111613035565b602002602001015192505050949350505050565b6001600160a01b0383166000908152600460205260408120805482919061214b90612fb3565b80601f016020809104026020016040519081016040528092919081815260200182805461217790612fb3565b80156121c45780601f10612199576101008083540402835291602001916121c4565b820191906000526020600020905b8154815290600101906020018083116121a757829003601f168201915b50506040805160a0810182528581523060208201524281830152606081018a905260808101899052905163c04b8d5960e01b8152949550936001600160a01b038b16935063c04b8d59925061221e91508490600401612b96565b602060405180830381600087803b15801561223857600080fd5b505af115801561224c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611fd391906129c7565b6001600160a01b03838116600081815260056020908152604080832054815160c081018352818152808401859052808301959095527f0000000000000000000000000000000000000000000000000000000000000000861660608087019190915260808087018a90528351808601855286815260a0880152835190810184523080825294810186905280840194909452830184905290516352bbbe2960e01b81529294909392908916906352bbbe299061233490859085908a904290600401612bee565b602060405180830381600087803b15801561234e57600080fd5b505af1158015612362573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061238691906129c7565b98975050505050505050565b6001600160a01b0383811660009081526006602090815260408083208151808301835290546001600160801b03808216808452600160801b909204169382018490529151630b68372160e31b81526004810192909252602482019290925260448101869052606481018590529192909190871690635b41b90890608401602060405180830381600087803b15801561242957600080fd5b505af115801561243d573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061246191906129c7565b9695505050505050565b6060831561247a575081611d5a565b82511561248a5782518084602001fd5b8160405162461bcd60e51b81526004016104109190612b1f565b8280548282559060005260206000209081019282156124f9579160200282015b828111156124f957825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906124c4565b5061250592915061257d565b5090565b82805461251590612fb3565b90600052602060002090601f01602090048101928261253757600085556124f9565b82601f106125505782800160ff198235161785556124f9565b828001600101855582156124f9579182015b828111156124f9578235825591602001919060010190612562565b5b80821115612505576000815560010161257e565b80356001600160801b03811681146125a957600080fd5b919050565b6000602082840312156125c057600080fd5b8135611d5a81613176565b6000602082840312156125dd57600080fd5b8151611d5a81613176565b600080604083850312156125fb57600080fd5b823561260681613176565b9150602083013561261681613176565b809150509250929050565b6000806040838503121561263457600080fd5b823561263f81613176565b915060208301356126168161318b565b60008060008084860361010081121561266757600080fd5b853561267281613176565b945060c0601f198201121561268657600080fd5b5060208501925060e085013567ffffffffffffffff808211156126a857600080fd5b818701915087601f8301126126bc57600080fd5b8135818111156126cb57600080fd5b8860208285010111156126dd57600080fd5b95989497505060200194505050565b600080604083850312156126ff57600080fd5b823561270a81613176565b946020939093013593505050565b6000602080838503121561272b57600080fd5b823567ffffffffffffffff81111561274257600080fd5b8301601f8101851361275357600080fd5b803561276661276182612d9a565b612d69565b80828252848201915084840188868560051b870101111561278657600080fd5b600094505b838510156127b257803561279e81613176565b83526001949094019391850191850161278b565b50979650505050505050565b600060208083850312156127d157600080fd5b825167ffffffffffffffff8111156127e857600080fd5b8301601f810185136127f957600080fd5b805161280761276182612d9a565b80828252848201915084840188868560051b870101111561282757600080fd5b600094505b838510156127b257805161283f81613176565b83526001949094019391850191850161282c565b6000602080838503121561286657600080fd5b825167ffffffffffffffff81111561287d57600080fd5b8301601f8101851361288e57600080fd5b805161289c61276182612d9a565b80828252848201915084840188868560051b87010111156128bc57600080fd5b600094505b838510156127b25780518352600194909401939185019185016128c1565b6000602082840312156128f157600080fd5b8135611d5a8161318b565b60006020828403121561290e57600080fd5b8151611d5a8161318b565b60006020828403121561292b57600080fd5b5035919050565b60006020828403121561294457600080fd5b8135611d5a81613199565b60006040828403121561296157600080fd5b6040516040810181811067ffffffffffffffff821117156129845761298461304b565b60405261299083612592565b815261299e60208401612592565b60208201529392505050565b6000602082840312156129bc57600080fd5b8135611d5a816131a6565b6000602082840312156129d957600080fd5b5051919050565b600080600080608085870312156129f657600080fd5b8451935060208501519250604085015191506060850151612a1681613176565b939692955090935050565b600060208284031215612a3357600080fd5b815160ff81168114611d5a57600080fd5b60008151808452612a5c816020860160208601612f83565b601f01601f19169290920160200192915050565b60048110612a8057612a8061301f565b9052565b60008251612a96818460208701612f83565b9190910192915050565b6001600160a01b038a8116825261ffff8a811660208401528916604083015260009061010090612ad3606085018b612a70565b8816608084015260a083018190528201859052610120858782850137600083870182015260c08301949094525090151560e0820152601f909201601f1916909101019695505050505050565b602081526000611d5a6020830184612a44565b60208101610e1b8284612a70565b60608101612b4e8286612a70565b602082019390935260400152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b602081526000825160a06020840152612bb260c0840182612a44565b905060018060a01b0360208501511660408401526040840151606084015260608401516080840152608084015160a08401528091505092915050565b60e08152845160e08201526000602086015160028110612c1057612c1061301f565b61010083015260408601516001600160a01b03908116610120840152606087015116610140830152608086015161016083015260a086015160c0610180840152612c5e6101a0840182612a44565b915050612c9e602083018680516001600160a01b039081168352602080830151151590840152604080830151909116908301526060908101511515910152565b60a082019390935260c0015292915050565b61ffff8781168252861660208201526001600160a01b0385166040820152831515606082015260c08101612ce76080830185612a70565b8260a0830152979650505050505050565b600060a082018783526020878185015260a0604085015281875180845260c086019150828901935060005b81811015612d485784516001600160a01b031683529383019391830191600101612d23565b50506001600160a01b03969096166060850152505050608001529392505050565b604051601f8201601f1916810167ffffffffffffffff81118282101715612d9257612d9261304b565b604052919050565b600067ffffffffffffffff821115612db457612db461304b565b5060051b60200190565b60008085851115612dce57600080fd5b83861115612ddb57600080fd5b5050820193919092039150565b600082612e0557634e487b7160e01b600052601260045260246000fd5b500490565b600181815b80851115612e45578160001904821115612e2b57612e2b613009565b80851615612e3857918102915b93841c9390800290612e0f565b509250929050565b6000611d5a8383600082612e6357506001610e1b565b81612e7057506000610e1b565b8160018114612e865760028114612e9057612eac565b6001915050610e1b565b60ff841115612ea157612ea1613009565b50506001821b610e1b565b5060208310610133831016604e8410600b8410161715612ecf575081810a610e1b565b612ed98383612e0a565b8060001904821115612eed57612eed613009565b029392505050565b6000816000190483118215151615612f0f57612f0f613009565b500290565b600061ffff83811690831681811015612f2f57612f2f613009565b039392505050565b600082821015612f4957612f49613009565b500390565b6bffffffffffffffffffffffff198135818116916014851015612f7b5780818660140360031b1b83161692505b505092915050565b60005b83811015612f9e578181015183820152602001612f86565b83811115612fad576000848401525b50505050565b600181811c90821680612fc757607f821691505b60208210811415612fe857634e487b7160e01b600052602260045260246000fd5b50919050565b600060001982141561300257613002613009565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b60008135610e1b8161318b565b60008135610e1b81613199565b8135613086816131a6565b61ffff8116905081548161ffff19821617835560208401356130a7816131a6565b63ffff00008160101b169050808363ffffffff1984161717845560408501356130cf81613176565b6001600160c01b0319929092169092179190911760209190911b640100000000600160c01b031617815561312661310860608401613061565b82805460ff60c01b191691151560c01b60ff60c01b16919091179055565b61313b6131356080840161306e565b82613149565b60a082013560018201555050565b600482106131595761315961301f565b805460ff60c81b191660c89290921b60ff60c81b16919091179055565b6001600160a01b038116811461172857600080fd5b801515811461172857600080fd5b6004811061172857600080fd5b61ffff8116811461172857600080fdfe7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa2646970667358221220a027d837b490da1a267b5f9d265801eb2ba7a5c697f983dfeceefae0e7d2981e64736f6c63430008070033", + "numDeployments": 2, + "solcInputHash": "66dbdc9fbde8f1c7cc59f29d272eb661", + "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_vault\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_wethAddress\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"actualBalance\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"minExpected\",\"type\":\"uint256\"}],\"name\":\"BalanceMismatchAfterSwap\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"EmptyAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"EmptyBalancerPoolId\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"InvalidCurvePoolAssetIndex\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidHarvestRewardBps\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidSlippageBps\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"}],\"name\":\"InvalidSwapPlatform\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"InvalidTokenInSwapPath\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidUniswapV2PathLength\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"actualBalance\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"minExpected\",\"type\":\"uint256\"}],\"name\":\"SlippageError\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"strategyAddress\",\"type\":\"address\"}],\"name\":\"UnsupportedStrategy\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newProceedsAddress\",\"type\":\"address\"}],\"name\":\"RewardProceedsAddressChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"farmer\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"protcolYield\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"farmerFee\",\"type\":\"uint256\"}],\"name\":\"RewardProceedsTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"allowedSlippageBps\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"uint16\",\"name\":\"harvestRewardBps\",\"type\":\"uint16\"},{\"indexed\":false,\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"swapPlatformAddr\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"swapData\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"liquidationLimit\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"doSwapRewardToken\",\"type\":\"bool\"}],\"name\":\"RewardTokenConfigUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"rewardToken\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"swappedInto\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountIn\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amountOut\",\"type\":\"uint256\"}],\"name\":\"RewardTokenSwapped\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"strategyAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"isSupported\",\"type\":\"bool\"}],\"name\":\"SupportedStrategyUpdate\",\"type\":\"event\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"balancerPoolId\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"baseTokenAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"baseTokenDecimals\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"curvePoolIndices\",\"outputs\":[{\"internalType\":\"uint128\",\"name\":\"rewardTokenIndex\",\"type\":\"uint128\"},{\"internalType\":\"uint128\",\"name\":\"baseTokenIndex\",\"type\":\"uint128\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategyAddr\",\"type\":\"address\"}],\"name\":\"harvestAndSwap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategyAddr\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_rewardTo\",\"type\":\"address\"}],\"name\":\"harvestAndSwap\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"rewardProceedsAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"rewardTokenConfigs\",\"outputs\":[{\"internalType\":\"uint16\",\"name\":\"allowedSlippageBps\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"harvestRewardBps\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"swapPlatformAddr\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"doSwapRewardToken\",\"type\":\"bool\"},{\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"liquidationLimit\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_rewardProceedsAddress\",\"type\":\"address\"}],\"name\":\"setRewardProceedsAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_tokenAddress\",\"type\":\"address\"},{\"components\":[{\"internalType\":\"uint16\",\"name\":\"allowedSlippageBps\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"harvestRewardBps\",\"type\":\"uint16\"},{\"internalType\":\"address\",\"name\":\"swapPlatformAddr\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"doSwapRewardToken\",\"type\":\"bool\"},{\"internalType\":\"enum BaseHarvester.SwapPlatform\",\"name\":\"swapPlatform\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"liquidationLimit\",\"type\":\"uint256\"}],\"internalType\":\"struct BaseHarvester.RewardTokenConfig\",\"name\":\"tokenConfig\",\"type\":\"tuple\"},{\"internalType\":\"bytes\",\"name\":\"swapData\",\"type\":\"bytes\"}],\"name\":\"setRewardTokenConfig\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategyAddress\",\"type\":\"address\"},{\"internalType\":\"bool\",\"name\":\"_isSupported\",\"type\":\"bool\"}],\"name\":\"setSupportedStrategy\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"supportedStrategies\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"transferToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"uniswapV2Path\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"uniswapV3Path\",\"outputs\":[{\"internalType\":\"bytes\",\"name\":\"\",\"type\":\"bytes\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"vaultAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"harvestAndSwap(address)\":{\"details\":\"Collect reward tokens from a specific strategy and swap them for base token on the configured swap platform. Can be called by anyone. Rewards incentivizing the caller are sent to the caller of this function.\",\"params\":{\"_strategyAddr\":\"Address of the strategy to collect rewards from\"}},\"harvestAndSwap(address,address)\":{\"details\":\"Collect reward tokens from a specific strategy and swap them for base token on the configured swap platform. Can be called by anyone\",\"params\":{\"_rewardTo\":\"Address where to send a share of harvest rewards to as an incentive for executing this function\",\"_strategyAddr\":\"Address of the strategy to collect rewards from\"}},\"setRewardProceedsAddress(address)\":{\"params\":{\"_rewardProceedsAddress\":\"Address of the reward token\"}},\"setRewardTokenConfig(address,(uint16,uint16,address,bool,uint8,uint256),bytes)\":{\"details\":\"Add/update a reward token configuration that holds harvesting config variables\",\"params\":{\"_tokenAddress\":\"Address of the reward token\",\"swapData\":\"Additional data required for swapping\",\"tokenConfig\":\".swapPlatform SwapPlatform to use for Swapping\"}},\"setSupportedStrategy(address,bool)\":{\"details\":\"Flags a strategy as supported or not supported one\",\"params\":{\"_isSupported\":\"Bool marking strategy as supported or not supported\",\"_strategyAddress\":\"Address of the strategy\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"transferToken(address,uint256)\":{\"details\":\"Transfer token to governor. Intended for recovering tokens stuck in contract, i.e. mistaken sends.\",\"params\":{\"_amount\":\"Amount of the asset to transfer\",\"_asset\":\"Address for the asset\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"baseTokenAddress()\":{\"notice\":\"All tokens are swapped to this token before it gets transferred to the `rewardProceedsAddress`. USDT for OUSD and WETH for OETH.*\"},\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"rewardProceedsAddress()\":{\"notice\":\"Address receiving rewards proceeds. Initially the Vault contract later will possibly be replaced by another contract that eases out rewards distribution.*\"},\"setRewardProceedsAddress(address)\":{\"notice\":\"Set the Address receiving rewards proceeds.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/harvest/OETHHarvester.sol\":\"OETHHarvester\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `recipient`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address recipient, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `sender` to `recipient` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(\\n address sender,\\n address recipient,\\n uint256 amount\\n ) external returns (bool);\\n\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n}\\n\",\"keccak256\":\"0x61437cb513a887a1bbad006e7b1c8b414478427d33de47c5600af3c748f108da\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n function safeTransfer(\\n IERC20 token,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n function safeTransferFrom(\\n IERC20 token,\\n address from,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n function safeIncreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n uint256 newAllowance = token.allowance(address(this), spender) + value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n\\n function safeDecreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n uint256 newAllowance = oldAllowance - value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n if (returndata.length > 0) {\\n // Return data is optional\\n require(abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc3d946432c0ddbb1f846a0d3985be71299df331b91d06732152117f62f0be2b5\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/Math.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Standard math utilities missing in the Solidity language.\\n */\\nlibrary Math {\\n /**\\n * @dev Returns the largest of two numbers.\\n */\\n function max(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a >= b ? a : b;\\n }\\n\\n /**\\n * @dev Returns the smallest of two numbers.\\n */\\n function min(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a < b ? a : b;\\n }\\n\\n /**\\n * @dev Returns the average of two numbers. The result is rounded towards\\n * zero.\\n */\\n function average(uint256 a, uint256 b) internal pure returns (uint256) {\\n // (a + b) / 2 can overflow.\\n return (a & b) + (a ^ b) / 2;\\n }\\n\\n /**\\n * @dev Returns the ceiling of the division of two numbers.\\n *\\n * This differs from standard division with `/` in that it rounds up instead\\n * of rounding down.\\n */\\n function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\\n // (a + b - 1) / b can overflow on addition, so we distribute.\\n return a / b + (a % b == 0 ? 0 : 1);\\n }\\n}\\n\",\"keccak256\":\"0xfaad496c1c944b6259b7dc70b4865eb1775d6402bc0c81b38a0b24d9f525ae37\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)\\n\\npragma solidity ^0.8.0;\\n\\n// CAUTION\\n// This version of SafeMath should only be used with Solidity 0.8 or later,\\n// because it relies on the compiler's built in overflow checks.\\n\\n/**\\n * @dev Wrappers over Solidity's arithmetic operations.\\n *\\n * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler\\n * now has built in overflow checking.\\n */\\nlibrary SafeMath {\\n /**\\n * @dev Returns the addition of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n uint256 c = a + b;\\n if (c < a) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the substraction of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b > a) return (false, 0);\\n return (true, a - b);\\n }\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n // benefit is lost if 'b' is also tested.\\n // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n if (a == 0) return (true, 0);\\n uint256 c = a * b;\\n if (c / a != b) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the division of two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a / b);\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a % b);\\n }\\n }\\n\\n /**\\n * @dev Returns the addition of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `+` operator.\\n *\\n * Requirements:\\n *\\n * - Addition cannot overflow.\\n */\\n function add(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting on\\n * overflow (when the result is negative).\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `*` operator.\\n *\\n * Requirements:\\n *\\n * - Multiplication cannot overflow.\\n */\\n function mul(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator.\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting when dividing by zero.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a % b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\\n * overflow (when the result is negative).\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {trySub}.\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b <= a, errorMessage);\\n return a - b;\\n }\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting with custom message on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator. Note: this function uses a\\n * `revert` opcode (which leaves remaining gas untouched) while Solidity\\n * uses an invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a / b;\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting with custom message when dividing by zero.\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {tryMod}.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a % b;\\n }\\n }\\n}\\n\",\"keccak256\":\"0xa2f576be637946f767aa56601c26d717f48a0aff44f82e46f13807eea1009a21\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/harvest/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport \\\"@openzeppelin/contracts/utils/math/Math.sol\\\";\\n\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\nimport { IOracle } from \\\"../interfaces/IOracle.sol\\\";\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { IUniswapV2Router } from \\\"../interfaces/uniswap/IUniswapV2Router02.sol\\\";\\nimport { IUniswapV3Router } from \\\"../interfaces/uniswap/IUniswapV3Router.sol\\\";\\nimport { IBalancerVault } from \\\"../interfaces/balancer/IBalancerVault.sol\\\";\\nimport { ICurvePool } from \\\"../strategies/ICurvePool.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\nabstract contract BaseHarvester is Governable {\\n using SafeERC20 for IERC20;\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n enum SwapPlatform {\\n UniswapV2Compatible,\\n UniswapV3,\\n Balancer,\\n Curve\\n }\\n\\n event SupportedStrategyUpdate(address strategyAddress, bool isSupported);\\n event RewardTokenConfigUpdated(\\n address tokenAddress,\\n uint16 allowedSlippageBps,\\n uint16 harvestRewardBps,\\n SwapPlatform swapPlatform,\\n address swapPlatformAddr,\\n bytes swapData,\\n uint256 liquidationLimit,\\n bool doSwapRewardToken\\n );\\n event RewardTokenSwapped(\\n address indexed rewardToken,\\n address indexed swappedInto,\\n SwapPlatform swapPlatform,\\n uint256 amountIn,\\n uint256 amountOut\\n );\\n event RewardProceedsTransferred(\\n address indexed token,\\n address farmer,\\n uint256 protcolYield,\\n uint256 farmerFee\\n );\\n event RewardProceedsAddressChanged(address newProceedsAddress);\\n\\n error EmptyAddress();\\n error InvalidSlippageBps();\\n error InvalidHarvestRewardBps();\\n\\n error InvalidSwapPlatform(SwapPlatform swapPlatform);\\n\\n error InvalidUniswapV2PathLength();\\n error InvalidTokenInSwapPath(address token);\\n error EmptyBalancerPoolId();\\n error InvalidCurvePoolAssetIndex(address token);\\n\\n error UnsupportedStrategy(address strategyAddress);\\n\\n error SlippageError(uint256 actualBalance, uint256 minExpected);\\n error BalanceMismatchAfterSwap(uint256 actualBalance, uint256 minExpected);\\n\\n // Configuration properties for harvesting logic of reward tokens\\n struct RewardTokenConfig {\\n // Max allowed slippage when swapping reward token for a stablecoin denominated in basis points.\\n uint16 allowedSlippageBps;\\n // Reward when calling a harvest function denominated in basis points.\\n uint16 harvestRewardBps;\\n // Address of compatible exchange protocol (Uniswap V2/V3, SushiSwap, Balancer and Curve).\\n address swapPlatformAddr;\\n /* When true the reward token is being swapped. In a need of (temporarily) disabling the swapping of\\n * a reward token this needs to be set to false.\\n */\\n bool doSwapRewardToken;\\n // Platform to use for Swapping\\n SwapPlatform swapPlatform;\\n /* How much token can be sold per one harvest call. If the balance of rewards tokens\\n * exceeds that limit multiple harvest calls are required to harvest all of the tokens.\\n * Set it to MAX_INT to effectively disable the limit.\\n */\\n uint256 liquidationLimit;\\n }\\n\\n mapping(address => RewardTokenConfig) public rewardTokenConfigs;\\n mapping(address => bool) public supportedStrategies;\\n\\n address public immutable vaultAddress;\\n\\n /**\\n * Address receiving rewards proceeds. Initially the Vault contract later will possibly\\n * be replaced by another contract that eases out rewards distribution.\\n **/\\n address public rewardProceedsAddress;\\n\\n /**\\n * All tokens are swapped to this token before it gets transferred\\n * to the `rewardProceedsAddress`. USDT for OUSD and WETH for OETH.\\n **/\\n address public immutable baseTokenAddress;\\n // Cached decimals for `baseTokenAddress`\\n uint256 public immutable baseTokenDecimals;\\n\\n // Uniswap V2 path for reward tokens using Uniswap V2 Router\\n mapping(address => address[]) public uniswapV2Path;\\n // Uniswap V3 path for reward tokens using Uniswap V3 Router\\n mapping(address => bytes) public uniswapV3Path;\\n // Pool ID to use for reward tokens on Balancer\\n mapping(address => bytes32) public balancerPoolId;\\n\\n struct CurvePoolIndices {\\n // Casted into uint128 and stored in a struct to save gas\\n uint128 rewardTokenIndex;\\n uint128 baseTokenIndex;\\n }\\n // Packed indices of assets on the Curve pool\\n mapping(address => CurvePoolIndices) public curvePoolIndices;\\n\\n constructor(address _vaultAddress, address _baseTokenAddress) {\\n require(_vaultAddress != address(0));\\n require(_baseTokenAddress != address(0));\\n\\n vaultAddress = _vaultAddress;\\n baseTokenAddress = _baseTokenAddress;\\n\\n // Cache decimals as well\\n baseTokenDecimals = Helpers.getDecimals(_baseTokenAddress);\\n }\\n\\n /***************************************\\n Configuration\\n ****************************************/\\n\\n /**\\n * Set the Address receiving rewards proceeds.\\n * @param _rewardProceedsAddress Address of the reward token\\n */\\n function setRewardProceedsAddress(address _rewardProceedsAddress)\\n external\\n onlyGovernor\\n {\\n if (_rewardProceedsAddress == address(0)) {\\n revert EmptyAddress();\\n }\\n\\n rewardProceedsAddress = _rewardProceedsAddress;\\n emit RewardProceedsAddressChanged(_rewardProceedsAddress);\\n }\\n\\n /**\\n * @dev Add/update a reward token configuration that holds harvesting config variables\\n * @param _tokenAddress Address of the reward token\\n * @param tokenConfig.allowedSlippageBps uint16 maximum allowed slippage denominated in basis points.\\n * Example: 300 == 3% slippage\\n * @param tokenConfig.harvestRewardBps uint16 amount of reward tokens the caller of the function is rewarded.\\n * Example: 100 == 1%\\n * @param tokenConfig.swapPlatformAddr Address Address of a UniswapV2 compatible contract to perform\\n * the exchange from reward tokens to stablecoin (currently hard-coded to USDT)\\n * @param tokenConfig.liquidationLimit uint256 Maximum amount of token to be sold per one swap function call.\\n * When value is 0 there is no limit.\\n * @param tokenConfig.doSwapRewardToken bool Disables swapping of the token when set to true,\\n * does not cause it to revert though.\\n * @param tokenConfig.swapPlatform SwapPlatform to use for Swapping\\n * @param swapData Additional data required for swapping\\n */\\n function setRewardTokenConfig(\\n address _tokenAddress,\\n RewardTokenConfig calldata tokenConfig,\\n bytes calldata swapData\\n ) external onlyGovernor {\\n if (tokenConfig.allowedSlippageBps > 1000) {\\n revert InvalidSlippageBps();\\n }\\n\\n if (tokenConfig.harvestRewardBps > 1000) {\\n revert InvalidHarvestRewardBps();\\n }\\n\\n address newRouterAddress = tokenConfig.swapPlatformAddr;\\n if (newRouterAddress == address(0)) {\\n // Swap router address should be non zero address\\n revert EmptyAddress();\\n }\\n\\n address oldRouterAddress = rewardTokenConfigs[_tokenAddress]\\n .swapPlatformAddr;\\n rewardTokenConfigs[_tokenAddress] = tokenConfig;\\n\\n // Revert if feed does not exist\\n // slither-disable-next-line unused-return\\n IOracle(IVault(vaultAddress).priceProvider()).price(_tokenAddress);\\n\\n IERC20 token = IERC20(_tokenAddress);\\n // if changing token swap provider cancel existing allowance\\n if (\\n /* oldRouterAddress == address(0) when there is no pre-existing\\n * configuration for said rewards token\\n */\\n oldRouterAddress != address(0) &&\\n oldRouterAddress != newRouterAddress\\n ) {\\n token.safeApprove(oldRouterAddress, 0);\\n }\\n\\n // Give SwapRouter infinite approval when needed\\n if (oldRouterAddress != newRouterAddress) {\\n token.safeApprove(newRouterAddress, 0);\\n token.safeApprove(newRouterAddress, type(uint256).max);\\n }\\n\\n SwapPlatform _platform = tokenConfig.swapPlatform;\\n if (_platform == SwapPlatform.UniswapV2Compatible) {\\n uniswapV2Path[_tokenAddress] = _decodeUniswapV2Path(\\n swapData,\\n _tokenAddress\\n );\\n } else if (_platform == SwapPlatform.UniswapV3) {\\n uniswapV3Path[_tokenAddress] = _decodeUniswapV3Path(\\n swapData,\\n _tokenAddress\\n );\\n } else if (_platform == SwapPlatform.Balancer) {\\n balancerPoolId[_tokenAddress] = _decodeBalancerPoolId(\\n swapData,\\n newRouterAddress,\\n _tokenAddress\\n );\\n } else if (_platform == SwapPlatform.Curve) {\\n curvePoolIndices[_tokenAddress] = _decodeCurvePoolIndices(\\n swapData,\\n newRouterAddress,\\n _tokenAddress\\n );\\n } else {\\n // Note: This code is unreachable since Solidity reverts when\\n // the value is outside the range of defined values of the enum\\n // (even if it's under the max length of the base type)\\n revert InvalidSwapPlatform(_platform);\\n }\\n\\n emit RewardTokenConfigUpdated(\\n _tokenAddress,\\n tokenConfig.allowedSlippageBps,\\n tokenConfig.harvestRewardBps,\\n _platform,\\n newRouterAddress,\\n swapData,\\n tokenConfig.liquidationLimit,\\n tokenConfig.doSwapRewardToken\\n );\\n }\\n\\n /**\\n * @dev Decodes the data passed into Uniswap V2 path and validates\\n * it to make sure the path is for `token` to `baseToken`\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @param token The address of the reward token\\n * @return path The validated Uniswap V2 path\\n */\\n function _decodeUniswapV2Path(bytes calldata data, address token)\\n internal\\n view\\n returns (address[] memory path)\\n {\\n (path) = abi.decode(data, (address[]));\\n uint256 len = path.length;\\n\\n if (len < 2) {\\n // Path should have at least two tokens\\n revert InvalidUniswapV2PathLength();\\n }\\n\\n // Do some validation\\n if (path[0] != token) {\\n revert InvalidTokenInSwapPath(path[0]);\\n }\\n\\n if (path[len - 1] != baseTokenAddress) {\\n revert InvalidTokenInSwapPath(path[len - 1]);\\n }\\n }\\n\\n /**\\n * @dev Decodes the data passed into Uniswap V3 path and validates\\n * it to make sure the path is for `token` to `baseToken`\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @param token The address of the reward token\\n * @return path The validated Uniswap V3 path\\n */\\n function _decodeUniswapV3Path(bytes calldata data, address token)\\n internal\\n view\\n returns (bytes calldata path)\\n {\\n path = data;\\n\\n address decodedAddress = address(uint160(bytes20(data[0:20])));\\n\\n if (decodedAddress != token) {\\n // Invalid Reward Token in swap path\\n revert InvalidTokenInSwapPath(decodedAddress);\\n }\\n\\n decodedAddress = address(uint160(bytes20(data[path.length - 20:])));\\n if (decodedAddress != baseTokenAddress) {\\n // Invalid Base Token in swap path\\n revert InvalidTokenInSwapPath(decodedAddress);\\n }\\n }\\n\\n /**\\n * @dev Decodes the data passed to Balancer Pool ID\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @return poolId The pool ID\\n */\\n function _decodeBalancerPoolId(\\n bytes calldata data,\\n address balancerVault,\\n address token\\n ) internal view returns (bytes32 poolId) {\\n (poolId) = abi.decode(data, (bytes32));\\n\\n if (poolId == bytes32(0)) {\\n revert EmptyBalancerPoolId();\\n }\\n\\n IBalancerVault bVault = IBalancerVault(balancerVault);\\n\\n // Note: this reverts if token is not a pool asset\\n // slither-disable-next-line unused-return\\n bVault.getPoolTokenInfo(poolId, token);\\n\\n // slither-disable-next-line unused-return\\n bVault.getPoolTokenInfo(poolId, baseTokenAddress);\\n }\\n\\n /**\\n * @dev Decodes the data passed to get the pool indices and\\n * checks it against the Curve Pool to make sure it's\\n * not misconfigured. The indices are packed into a single\\n * uint256 for gas savings\\n *\\n * @param data Ecnoded data passed to the `setRewardTokenConfig`\\n * @param poolAddress Curve pool address\\n * @param token The address of the reward token\\n * @return indices Packed pool asset indices\\n */\\n function _decodeCurvePoolIndices(\\n bytes calldata data,\\n address poolAddress,\\n address token\\n ) internal view returns (CurvePoolIndices memory indices) {\\n indices = abi.decode(data, (CurvePoolIndices));\\n\\n ICurvePool pool = ICurvePool(poolAddress);\\n if (token != pool.coins(indices.rewardTokenIndex)) {\\n revert InvalidCurvePoolAssetIndex(token);\\n }\\n if (baseTokenAddress != pool.coins(indices.baseTokenIndex)) {\\n revert InvalidCurvePoolAssetIndex(baseTokenAddress);\\n }\\n }\\n\\n /**\\n * @dev Flags a strategy as supported or not supported one\\n * @param _strategyAddress Address of the strategy\\n * @param _isSupported Bool marking strategy as supported or not supported\\n */\\n function setSupportedStrategy(address _strategyAddress, bool _isSupported)\\n external\\n onlyGovernor\\n {\\n supportedStrategies[_strategyAddress] = _isSupported;\\n emit SupportedStrategyUpdate(_strategyAddress, _isSupported);\\n }\\n\\n /***************************************\\n Rewards\\n ****************************************/\\n\\n /**\\n * @dev Transfer token to governor. Intended for recovering tokens stuck in\\n * contract, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n external\\n onlyGovernor\\n {\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform. Can be called by anyone.\\n * Rewards incentivizing the caller are sent to the caller of this function.\\n * @param _strategyAddr Address of the strategy to collect rewards from\\n */\\n function harvestAndSwap(address _strategyAddr) external nonReentrant {\\n // Remember _harvest function checks for the validity of _strategyAddr\\n _harvestAndSwap(_strategyAddr, msg.sender);\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform. Can be called by anyone\\n * @param _strategyAddr Address of the strategy to collect rewards from\\n * @param _rewardTo Address where to send a share of harvest rewards to as an incentive\\n * for executing this function\\n */\\n function harvestAndSwap(address _strategyAddr, address _rewardTo)\\n external\\n nonReentrant\\n {\\n // Remember _harvest function checks for the validity of _strategyAddr\\n _harvestAndSwap(_strategyAddr, _rewardTo);\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform\\n * @param _strategyAddr Address of the strategy to collect rewards from\\n * @param _rewardTo Address where to send a share of harvest rewards to as an incentive\\n * for executing this function\\n */\\n function _harvestAndSwap(address _strategyAddr, address _rewardTo)\\n internal\\n {\\n _harvest(_strategyAddr);\\n IStrategy strategy = IStrategy(_strategyAddr);\\n address[] memory rewardTokens = strategy.getRewardTokenAddresses();\\n IOracle priceProvider = IOracle(IVault(vaultAddress).priceProvider());\\n uint256 len = rewardTokens.length;\\n for (uint256 i = 0; i < len; ++i) {\\n _swap(rewardTokens[i], _rewardTo, priceProvider);\\n }\\n }\\n\\n /**\\n * @dev Collect reward tokens from a specific strategy and swap them for\\n * base token on the configured swap platform\\n * @param _strategyAddr Address of the strategy to collect rewards from.\\n */\\n function _harvest(address _strategyAddr) internal {\\n if (!supportedStrategies[_strategyAddr]) {\\n revert UnsupportedStrategy(_strategyAddr);\\n }\\n\\n IStrategy strategy = IStrategy(_strategyAddr);\\n strategy.collectRewardTokens();\\n }\\n\\n /**\\n * @dev Swap a reward token for the base token on the configured\\n * swap platform. The token must have a registered price feed\\n * with the price provider\\n * @param _swapToken Address of the token to swap\\n * @param _rewardTo Address where to send the share of harvest rewards to\\n * @param _priceProvider Oracle to get prices of the swap token\\n */\\n function _swap(\\n address _swapToken,\\n address _rewardTo,\\n IOracle _priceProvider\\n ) internal virtual {\\n uint256 balance = IERC20(_swapToken).balanceOf(address(this));\\n\\n // No need to swap if the reward token is the base token. eg USDT or WETH.\\n // There is also no limit on the transfer. Everything in the harvester will be transferred\\n // to the Dripper regardless of the liquidationLimit config.\\n if (_swapToken == baseTokenAddress) {\\n IERC20(_swapToken).safeTransfer(rewardProceedsAddress, balance);\\n // currently not paying the farmer any rewards as there is no swap\\n emit RewardProceedsTransferred(\\n baseTokenAddress,\\n address(0),\\n balance,\\n 0\\n );\\n return;\\n }\\n\\n RewardTokenConfig memory tokenConfig = rewardTokenConfigs[_swapToken];\\n\\n /* This will trigger a return when reward token configuration has not yet been set\\n * or we have temporarily disabled swapping of specific reward token via setting\\n * doSwapRewardToken to false.\\n */\\n if (!tokenConfig.doSwapRewardToken) {\\n return;\\n }\\n\\n if (balance == 0) {\\n return;\\n }\\n\\n if (tokenConfig.liquidationLimit > 0) {\\n balance = Math.min(balance, tokenConfig.liquidationLimit);\\n }\\n\\n // This'll revert if there is no price feed\\n uint256 oraclePrice = _priceProvider.price(_swapToken);\\n\\n // Oracle price is 1e18\\n uint256 minExpected = (balance *\\n (1e4 - tokenConfig.allowedSlippageBps) * // max allowed slippage\\n oraclePrice).scaleBy(\\n baseTokenDecimals,\\n Helpers.getDecimals(_swapToken)\\n ) /\\n 1e4 / // fix the max slippage decimal position\\n 1e18; // and oracle price decimals position\\n\\n // Do the swap\\n uint256 amountReceived = _doSwap(\\n tokenConfig.swapPlatform,\\n tokenConfig.swapPlatformAddr,\\n _swapToken,\\n balance,\\n minExpected\\n );\\n\\n if (amountReceived < minExpected) {\\n revert SlippageError(amountReceived, minExpected);\\n }\\n\\n emit RewardTokenSwapped(\\n _swapToken,\\n baseTokenAddress,\\n tokenConfig.swapPlatform,\\n balance,\\n amountReceived\\n );\\n\\n IERC20 baseToken = IERC20(baseTokenAddress);\\n uint256 baseTokenBalance = baseToken.balanceOf(address(this));\\n if (baseTokenBalance < amountReceived) {\\n // Note: It's possible to bypass this check by transfering `baseToken`\\n // directly to Harvester before calling the `harvestAndSwap`. However,\\n // there's no incentive for an attacker to do that. Doing a balance diff\\n // will increase the gas cost significantly\\n revert BalanceMismatchAfterSwap(baseTokenBalance, amountReceived);\\n }\\n\\n // Farmer only gets fee from the base amount they helped farm,\\n // They do not get anything from anything that already was there\\n // on the Harvester\\n uint256 farmerFee = amountReceived.mulTruncateScale(\\n tokenConfig.harvestRewardBps,\\n 1e4\\n );\\n uint256 protocolYield = baseTokenBalance - farmerFee;\\n\\n baseToken.safeTransfer(rewardProceedsAddress, protocolYield);\\n baseToken.safeTransfer(_rewardTo, farmerFee);\\n emit RewardProceedsTransferred(\\n baseTokenAddress,\\n _rewardTo,\\n protocolYield,\\n farmerFee\\n );\\n }\\n\\n function _doSwap(\\n SwapPlatform swapPlatform,\\n address routerAddress,\\n address rewardTokenAddress,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n if (swapPlatform == SwapPlatform.UniswapV2Compatible) {\\n return\\n _swapWithUniswapV2(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else if (swapPlatform == SwapPlatform.UniswapV3) {\\n return\\n _swapWithUniswapV3(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else if (swapPlatform == SwapPlatform.Balancer) {\\n return\\n _swapWithBalancer(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else if (swapPlatform == SwapPlatform.Curve) {\\n return\\n _swapWithCurve(\\n routerAddress,\\n rewardTokenAddress,\\n amountIn,\\n minAmountOut\\n );\\n } else {\\n // Should never be invoked since we catch invalid values\\n // in the `setRewardTokenConfig` function before it's set\\n revert InvalidSwapPlatform(swapPlatform);\\n }\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` with Uniswap V2\\n *\\n * @param routerAddress Uniswap V2 Router address\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithUniswapV2(\\n address routerAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n address[] memory path = uniswapV2Path[swapToken];\\n\\n uint256[] memory amounts = IUniswapV2Router(routerAddress)\\n .swapExactTokensForTokens(\\n amountIn,\\n minAmountOut,\\n path,\\n address(this),\\n block.timestamp\\n );\\n\\n amountOut = amounts[amounts.length - 1];\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` with Uniswap V3\\n *\\n * @param routerAddress Uniswap V3 Router address\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithUniswapV3(\\n address routerAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n bytes memory path = uniswapV3Path[swapToken];\\n\\n IUniswapV3Router.ExactInputParams memory params = IUniswapV3Router\\n .ExactInputParams({\\n path: path,\\n recipient: address(this),\\n deadline: block.timestamp,\\n amountIn: amountIn,\\n amountOutMinimum: minAmountOut\\n });\\n amountOut = IUniswapV3Router(routerAddress).exactInput(params);\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` on Balancer\\n *\\n * @param balancerVaultAddress BalancerVaultAddress\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithBalancer(\\n address balancerVaultAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n bytes32 poolId = balancerPoolId[swapToken];\\n\\n IBalancerVault.SingleSwap memory singleSwap = IBalancerVault\\n .SingleSwap({\\n poolId: poolId,\\n kind: IBalancerVault.SwapKind.GIVEN_IN,\\n assetIn: swapToken,\\n assetOut: baseTokenAddress,\\n amount: amountIn,\\n userData: hex\\\"\\\"\\n });\\n\\n IBalancerVault.FundManagement memory fundMgmt = IBalancerVault\\n .FundManagement({\\n sender: address(this),\\n fromInternalBalance: false,\\n recipient: payable(address(this)),\\n toInternalBalance: false\\n });\\n\\n amountOut = IBalancerVault(balancerVaultAddress).swap(\\n singleSwap,\\n fundMgmt,\\n minAmountOut,\\n block.timestamp\\n );\\n }\\n\\n /**\\n * @dev Swaps the token to `baseToken` on Curve\\n *\\n * @param poolAddress Curve Pool Address\\n * @param swapToken Address of the tokenIn\\n * @param amountIn Amount of `swapToken` to swap\\n * @param minAmountOut Minimum expected amount of `baseToken`\\n *\\n * @return amountOut Amount of `baseToken` received after the swap\\n */\\n function _swapWithCurve(\\n address poolAddress,\\n address swapToken,\\n uint256 amountIn,\\n uint256 minAmountOut\\n ) internal returns (uint256 amountOut) {\\n CurvePoolIndices memory indices = curvePoolIndices[swapToken];\\n\\n // Note: Not all CurvePools return the `amountOut`, make sure\\n // to use only pool that do. Otherwise the swap would revert\\n // always\\n amountOut = ICurvePool(poolAddress).exchange(\\n uint256(indices.rewardTokenIndex),\\n uint256(indices.baseTokenIndex),\\n amountIn,\\n minAmountOut\\n );\\n }\\n}\\n\",\"keccak256\":\"0x9d6a3756c5f35f48cb9e16dbeff2cd6f3024ef0c4e0be385cc230b47b5745c9a\",\"license\":\"MIT\"},\"contracts/harvest/OETHHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { BaseHarvester } from \\\"./BaseHarvester.sol\\\";\\n\\ncontract OETHHarvester is BaseHarvester {\\n constructor(address _vault, address _wethAddress)\\n BaseHarvester(_vault, _wethAddress)\\n {}\\n}\\n\",\"keccak256\":\"0x67255aabc4a8ec5d6650b3ab1daedffa093d8f6c324ee92281581c05990098bc\",\"license\":\"MIT\"},\"contracts/interfaces/IBasicToken.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IBasicToken {\\n function symbol() external view returns (string memory);\\n\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0xa562062698aa12572123b36dfd2072f1a39e44fed2031cc19c2c9fd522f96ec2\",\"license\":\"MIT\"},\"contracts/interfaces/IOracle.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IOracle {\\n /**\\n * @dev returns the asset price in USD, in 8 decimal digits.\\n *\\n * The version of priceProvider deployed for OETH has 18 decimal digits\\n */\\n function price(address asset) external view returns (uint256);\\n}\\n\",\"keccak256\":\"0x9eabf152389f145c9c23ed71972af73fb1708cbc4b26e524a9ba29a557b7cfe5\",\"license\":\"MIT\"},\"contracts/interfaces/IStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Platform interface to integrate with lending platform like Compound, AAVE etc.\\n */\\ninterface IStrategy {\\n /**\\n * @dev Deposit the given asset to platform\\n * @param _asset asset address\\n * @param _amount Amount to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external;\\n\\n /**\\n * @dev Deposit the entire balance of all supported assets in the Strategy\\n * to the platform\\n */\\n function depositAll() external;\\n\\n /**\\n * @dev Withdraw given asset from Lending platform\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external;\\n\\n /**\\n * @dev Liquidate all assets in strategy and return them to Vault.\\n */\\n function withdrawAll() external;\\n\\n /**\\n * @dev Returns the current balance of the given asset.\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n returns (uint256 balance);\\n\\n /**\\n * @dev Returns bool indicating whether strategy supports asset.\\n */\\n function supportsAsset(address _asset) external view returns (bool);\\n\\n /**\\n * @dev Collect reward tokens from the Strategy.\\n */\\n function collectRewardTokens() external;\\n\\n /**\\n * @dev The address array of the reward tokens for the Strategy.\\n */\\n function getRewardTokenAddresses() external view returns (address[] memory);\\n}\\n\",\"keccak256\":\"0xb291e409a9b95527f9ed19cd6bff8eeb9921a21c1f5194a48c0bb9ce6613959a\",\"license\":\"MIT\"},\"contracts/interfaces/IVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { VaultStorage } from \\\"../vault/VaultStorage.sol\\\";\\n\\ninterface IVault {\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Governable.sol\\n function transferGovernance(address _newGovernor) external;\\n\\n function claimGovernance() external;\\n\\n function governor() external view returns (address);\\n\\n // VaultAdmin.sol\\n function setPriceProvider(address _priceProvider) external;\\n\\n function priceProvider() external view returns (address);\\n\\n function setRedeemFeeBps(uint256 _redeemFeeBps) external;\\n\\n function redeemFeeBps() external view returns (uint256);\\n\\n function setVaultBuffer(uint256 _vaultBuffer) external;\\n\\n function vaultBuffer() external view returns (uint256);\\n\\n function setAutoAllocateThreshold(uint256 _threshold) external;\\n\\n function autoAllocateThreshold() external view returns (uint256);\\n\\n function setRebaseThreshold(uint256 _threshold) external;\\n\\n function rebaseThreshold() external view returns (uint256);\\n\\n function setStrategistAddr(address _address) external;\\n\\n function strategistAddr() external view returns (address);\\n\\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external;\\n\\n function maxSupplyDiff() external view returns (uint256);\\n\\n function setTrusteeAddress(address _address) external;\\n\\n function trusteeAddress() external view returns (address);\\n\\n function setTrusteeFeeBps(uint256 _basis) external;\\n\\n function trusteeFeeBps() external view returns (uint256);\\n\\n function ousdMetaStrategy() external view returns (address);\\n\\n function setSwapper(address _swapperAddr) external;\\n\\n function setSwapAllowedUndervalue(uint16 _percentageBps) external;\\n\\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\\n external;\\n\\n function supportAsset(address _asset, uint8 _supportsAsset) external;\\n\\n function approveStrategy(address _addr) external;\\n\\n function removeStrategy(address _addr) external;\\n\\n function setAssetDefaultStrategy(address _asset, address _strategy)\\n external;\\n\\n function assetDefaultStrategies(address _asset)\\n external\\n view\\n returns (address);\\n\\n function pauseRebase() external;\\n\\n function unpauseRebase() external;\\n\\n function rebasePaused() external view returns (bool);\\n\\n function pauseCapital() external;\\n\\n function unpauseCapital() external;\\n\\n function capitalPaused() external view returns (bool);\\n\\n function transferToken(address _asset, uint256 _amount) external;\\n\\n function priceUnitMint(address asset) external view returns (uint256);\\n\\n function priceUnitRedeem(address asset) external view returns (uint256);\\n\\n function withdrawAllFromStrategy(address _strategyAddr) external;\\n\\n function withdrawAllFromStrategies() external;\\n\\n function withdrawFromStrategy(\\n address _strategyFromAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n function depositToStrategy(\\n address _strategyToAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n // VaultCore.sol\\n function mint(\\n address _asset,\\n uint256 _amount,\\n uint256 _minimumOusdAmount\\n ) external;\\n\\n function mintForStrategy(uint256 _amount) external;\\n\\n function redeem(uint256 _amount, uint256 _minimumUnitAmount) external;\\n\\n function burnForStrategy(uint256 _amount) external;\\n\\n function redeemAll(uint256 _minimumUnitAmount) external;\\n\\n function allocate() external;\\n\\n function rebase() external;\\n\\n function swapCollateral(\\n address fromAsset,\\n address toAsset,\\n uint256 fromAssetAmount,\\n uint256 minToAssetAmount,\\n bytes calldata data\\n ) external returns (uint256 toAssetAmount);\\n\\n function totalValue() external view returns (uint256 value);\\n\\n function checkBalance(address _asset) external view returns (uint256);\\n\\n function calculateRedeemOutputs(uint256 _amount)\\n external\\n view\\n returns (uint256[] memory);\\n\\n function getAssetCount() external view returns (uint256);\\n\\n function getAssetConfig(address _asset)\\n external\\n view\\n returns (VaultStorage.Asset memory config);\\n\\n function getAllAssets() external view returns (address[] memory);\\n\\n function getStrategyCount() external view returns (uint256);\\n\\n function swapper() external view returns (address);\\n\\n function allowedSwapUndervalue() external view returns (uint256);\\n\\n function getAllStrategies() external view returns (address[] memory);\\n\\n function isSupportedAsset(address _asset) external view returns (bool);\\n\\n function netOusdMintForStrategyThreshold() external view returns (uint256);\\n\\n function setOusdMetaStrategy(address _ousdMetaStrategy) external;\\n\\n function setNetOusdMintForStrategyThreshold(uint256 _threshold) external;\\n\\n function netOusdMintedForStrategy() external view returns (int256);\\n\\n function weth() external view returns (address);\\n\\n function cacheWETHAssetIndex() external;\\n\\n function wethAssetIndex() external view returns (uint256);\\n\\n function initialize(address, address) external;\\n\\n function setAdminImpl(address) external;\\n}\\n\",\"keccak256\":\"0xe8ab2f09127dc86bda14d2ad7f58d4f5ef214959101742f0dd977be3599f9d5f\",\"license\":\"MIT\"},\"contracts/interfaces/balancer/IBalancerVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"../../utils/InitializableAbstractStrategy.sol\\\";\\n\\ninterface IBalancerVault {\\n enum WeightedPoolJoinKind {\\n INIT,\\n EXACT_TOKENS_IN_FOR_BPT_OUT,\\n TOKEN_IN_FOR_EXACT_BPT_OUT,\\n ALL_TOKENS_IN_FOR_EXACT_BPT_OUT,\\n ADD_TOKEN\\n }\\n\\n enum WeightedPoolExitKind {\\n EXACT_BPT_IN_FOR_ONE_TOKEN_OUT,\\n EXACT_BPT_IN_FOR_TOKENS_OUT,\\n BPT_IN_FOR_EXACT_TOKENS_OUT,\\n REMOVE_TOKEN\\n }\\n\\n /**\\n * @dev Called by users to join a Pool, which transfers tokens from `sender` into the Pool's balance. This will\\n * trigger custom Pool behavior, which will typically grant something in return to `recipient` - often tokenized\\n * Pool shares.\\n *\\n * If the caller is not `sender`, it must be an authorized relayer for them.\\n *\\n * The `assets` and `maxAmountsIn` arrays must have the same length, and each entry indicates the maximum amount\\n * to send for each asset. The amounts to send are decided by the Pool and not the Vault: it just enforces\\n * these maximums.\\n *\\n * If joining a Pool that holds WETH, it is possible to send ETH directly: the Vault will do the wrapping. To enable\\n * this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead of the\\n * WETH address. Note that it is not possible to combine ETH and WETH in the same join. Any excess ETH will be sent\\n * back to the caller (not the sender, which is important for relayers).\\n *\\n * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when\\n * interacting with Pools that register and deregister tokens frequently. If sending ETH however, the array must be\\n * sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the final\\n * `assets` array might not be sorted. Pools with no registered tokens cannot be joined.\\n *\\n * If `fromInternalBalance` is true, the caller's Internal Balance will be preferred: ERC20 transfers will only\\n * be made for the difference between the requested amount and Internal Balance (if any). Note that ETH cannot be\\n * withdrawn from Internal Balance: attempting to do so will trigger a revert.\\n *\\n * This causes the Vault to call the `IBasePool.onJoinPool` hook on the Pool's contract, where Pools implement\\n * their own custom logic. This typically requires additional information from the user (such as the expected number\\n * of Pool shares). This can be encoded in the `userData` argument, which is ignored by the Vault and passed\\n * directly to the Pool's contract, as is `recipient`.\\n *\\n * Emits a `PoolBalanceChanged` event.\\n */\\n function joinPool(\\n bytes32 poolId,\\n address sender,\\n address recipient,\\n JoinPoolRequest memory request\\n ) external payable;\\n\\n struct JoinPoolRequest {\\n address[] assets;\\n uint256[] maxAmountsIn;\\n bytes userData;\\n bool fromInternalBalance;\\n }\\n\\n /**\\n * @dev Called by users to exit a Pool, which transfers tokens from the Pool's balance to `recipient`. This will\\n * trigger custom Pool behavior, which will typically ask for something in return from `sender` - often tokenized\\n * Pool shares. The amount of tokens that can be withdrawn is limited by the Pool's `cash` balance (see\\n * `getPoolTokenInfo`).\\n *\\n * If the caller is not `sender`, it must be an authorized relayer for them.\\n *\\n * The `tokens` and `minAmountsOut` arrays must have the same length, and each entry in these indicates the minimum\\n * token amount to receive for each token contract. The amounts to send are decided by the Pool and not the Vault:\\n * it just enforces these minimums.\\n *\\n * If exiting a Pool that holds WETH, it is possible to receive ETH directly: the Vault will do the unwrapping. To\\n * enable this mechanism, the IAsset sentinel value (the zero address) must be passed in the `assets` array instead\\n * of the WETH address. Note that it is not possible to combine ETH and WETH in the same exit.\\n *\\n * `assets` must have the same length and order as the array returned by `getPoolTokens`. This prevents issues when\\n * interacting with Pools that register and deregister tokens frequently. If receiving ETH however, the array must\\n * be sorted *before* replacing the WETH address with the ETH sentinel value (the zero address), which means the\\n * final `assets` array might not be sorted. Pools with no registered tokens cannot be exited.\\n *\\n * If `toInternalBalance` is true, the tokens will be deposited to `recipient`'s Internal Balance. Otherwise,\\n * an ERC20 transfer will be performed. Note that ETH cannot be deposited to Internal Balance: attempting to\\n * do so will trigger a revert.\\n *\\n * `minAmountsOut` is the minimum amount of tokens the user expects to get out of the Pool, for each token in the\\n * `tokens` array. This array must match the Pool's registered tokens.\\n *\\n * This causes the Vault to call the `IBasePool.onExitPool` hook on the Pool's contract, where Pools implement\\n * their own custom logic. This typically requires additional information from the user (such as the expected number\\n * of Pool shares to return). This can be encoded in the `userData` argument, which is ignored by the Vault and\\n * passed directly to the Pool's contract.\\n *\\n * Emits a `PoolBalanceChanged` event.\\n */\\n function exitPool(\\n bytes32 poolId,\\n address sender,\\n address payable recipient,\\n ExitPoolRequest memory request\\n ) external;\\n\\n struct ExitPoolRequest {\\n address[] assets;\\n uint256[] minAmountsOut;\\n bytes userData;\\n bool toInternalBalance;\\n }\\n\\n /**\\n * @dev Returns a Pool's registered tokens, the total balance for each, and the latest block when *any* of\\n * the tokens' `balances` changed.\\n *\\n * The order of the `tokens` array is the same order that will be used in `joinPool`, `exitPool`, as well as in all\\n * Pool hooks (where applicable). Calls to `registerTokens` and `deregisterTokens` may change this order.\\n *\\n * If a Pool only registers tokens once, and these are sorted in ascending order, they will be stored in the same\\n * order as passed to `registerTokens`.\\n *\\n * Total balances include both tokens held by the Vault and those withdrawn by the Pool's Asset Managers. These are\\n * the amounts used by joins, exits and swaps. For a detailed breakdown of token balances, use `getPoolTokenInfo`\\n * instead.\\n */\\n function getPoolTokens(bytes32 poolId)\\n external\\n view\\n returns (\\n IERC20[] memory tokens,\\n uint256[] memory balances,\\n uint256 lastChangeBlock\\n );\\n\\n /**\\n * @dev Performs a set of user balance operations, which involve Internal Balance (deposit, withdraw or transfer)\\n * and plain ERC20 transfers using the Vault's allowance. This last feature is particularly useful for relayers, as\\n * it lets integrators reuse a user's Vault allowance.\\n *\\n * For each operation, if the caller is not `sender`, it must be an authorized relayer for them.\\n */\\n function manageUserBalance(UserBalanceOp[] memory ops) external payable;\\n\\n struct UserBalanceOp {\\n UserBalanceOpKind kind;\\n address asset;\\n uint256 amount;\\n address sender;\\n address payable recipient;\\n }\\n\\n enum UserBalanceOpKind {\\n DEPOSIT_INTERNAL,\\n WITHDRAW_INTERNAL,\\n TRANSFER_INTERNAL,\\n TRANSFER_EXTERNAL\\n }\\n\\n enum SwapKind {\\n GIVEN_IN,\\n GIVEN_OUT\\n }\\n\\n struct SingleSwap {\\n bytes32 poolId;\\n SwapKind kind;\\n address assetIn;\\n address assetOut;\\n uint256 amount;\\n bytes userData;\\n }\\n\\n struct FundManagement {\\n address sender;\\n bool fromInternalBalance;\\n address payable recipient;\\n bool toInternalBalance;\\n }\\n\\n function swap(\\n SingleSwap calldata singleSwap,\\n FundManagement calldata funds,\\n uint256 limit,\\n uint256 deadline\\n ) external returns (uint256 amountCalculated);\\n\\n function getPoolTokenInfo(bytes32 poolId, address token)\\n external\\n view\\n returns (\\n uint256 cash,\\n uint256 managed,\\n uint256 lastChangeBlock,\\n address assetManager\\n );\\n}\\n\",\"keccak256\":\"0x597796f9c5b3d174acbec8b520c633695c10d87762f7a0a7fec49b291694d7de\",\"license\":\"MIT\"},\"contracts/interfaces/uniswap/IUniswapV2Router02.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IUniswapV2Router {\\n function WETH() external pure returns (address);\\n\\n function swapExactTokensForTokens(\\n uint256 amountIn,\\n uint256 amountOutMin,\\n address[] calldata path,\\n address to,\\n uint256 deadline\\n ) external returns (uint256[] memory amounts);\\n\\n function addLiquidity(\\n address tokenA,\\n address tokenB,\\n uint256 amountADesired,\\n uint256 amountBDesired,\\n uint256 amountAMin,\\n uint256 amountBMin,\\n address to,\\n uint256 deadline\\n )\\n external\\n returns (\\n uint256 amountA,\\n uint256 amountB,\\n uint256 liquidity\\n );\\n}\\n\",\"keccak256\":\"0x3fdf2b91880f2b669202cc43bdceaf9d01537a9b955fc7a51159fb04fdbc68d4\",\"license\":\"MIT\"},\"contracts/interfaces/uniswap/IUniswapV3Router.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n// -- Solididy v0.5.x compatible interface\\ninterface IUniswapV3Router {\\n struct ExactInputParams {\\n bytes path;\\n address recipient;\\n uint256 deadline;\\n uint256 amountIn;\\n uint256 amountOutMinimum;\\n }\\n\\n /// @notice Swaps `amountIn` of one token for as much as possible of another along the specified path\\n /// @param params The parameters necessary for the multi-hop swap, encoded as `ExactInputParams` in calldata\\n /// @return amountOut The amount of the received token\\n function exactInput(ExactInputParams calldata params)\\n external\\n payable\\n returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xe32b76d23705979a297b164718aefa6b08e0ec3830883c020a5ac68d332a1dd2\",\"license\":\"MIT\"},\"contracts/strategies/ICurvePool.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface ICurvePool {\\n function get_virtual_price() external view returns (uint256);\\n\\n function add_liquidity(uint256[3] calldata _amounts, uint256 _min) external;\\n\\n function balances(uint256) external view returns (uint256);\\n\\n function calc_token_amount(uint256[3] calldata _amounts, bool _deposit)\\n external\\n returns (uint256);\\n\\n function fee() external view returns (uint256);\\n\\n function remove_liquidity_one_coin(\\n uint256 _amount,\\n int128 _index,\\n uint256 _minAmount\\n ) external;\\n\\n function remove_liquidity(\\n uint256 _amount,\\n uint256[3] calldata _minWithdrawAmounts\\n ) external;\\n\\n function calc_withdraw_one_coin(uint256 _amount, int128 _index)\\n external\\n view\\n returns (uint256);\\n\\n function exchange(\\n uint256 i,\\n uint256 j,\\n uint256 dx,\\n uint256 min_dy\\n ) external returns (uint256);\\n\\n function coins(uint256 _index) external view returns (address);\\n\\n function remove_liquidity_imbalance(\\n uint256[3] calldata _amounts,\\n uint256 maxBurnAmount\\n ) external;\\n}\\n\",\"keccak256\":\"0x65e40829ff1f51c6c64fe991ed6a536b413ced85b9d9aa852d37fa14966d474c\",\"license\":\"MIT\"},\"contracts/token/OUSD.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OUSD Token Contract\\n * @dev ERC20 compatible contract for OUSD\\n * @dev Implements an elastic supply\\n * @author Origin Protocol Inc\\n */\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { InitializableERC20Detailed } from \\\"../utils/InitializableERC20Detailed.sol\\\";\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * NOTE that this is an ERC20 token but the invariant that the sum of\\n * balanceOf(x) for all x is not >= totalSupply(). This is a consequence of the\\n * rebasing design. Any integrations with OUSD should be aware.\\n */\\n\\ncontract OUSD is Initializable, InitializableERC20Detailed, Governable {\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n event TotalSupplyUpdatedHighres(\\n uint256 totalSupply,\\n uint256 rebasingCredits,\\n uint256 rebasingCreditsPerToken\\n );\\n event AccountRebasingEnabled(address account);\\n event AccountRebasingDisabled(address account);\\n\\n enum RebaseOptions {\\n NotSet,\\n OptOut,\\n OptIn\\n }\\n\\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\\n uint256 public _totalSupply;\\n mapping(address => mapping(address => uint256)) private _allowances;\\n address public vaultAddress = address(0);\\n mapping(address => uint256) private _creditBalances;\\n uint256 private _rebasingCredits;\\n uint256 private _rebasingCreditsPerToken;\\n // Frozen address/credits are non rebasing (value is held in contracts which\\n // do not receive yield unless they explicitly opt in)\\n uint256 public nonRebasingSupply;\\n mapping(address => uint256) public nonRebasingCreditsPerToken;\\n mapping(address => RebaseOptions) public rebaseState;\\n mapping(address => uint256) public isUpgraded;\\n\\n uint256 private constant RESOLUTION_INCREASE = 1e9;\\n\\n function initialize(\\n string calldata _nameArg,\\n string calldata _symbolArg,\\n address _vaultAddress,\\n uint256 _initialCreditsPerToken\\n ) external onlyGovernor initializer {\\n InitializableERC20Detailed._initialize(_nameArg, _symbolArg, 18);\\n _rebasingCreditsPerToken = _initialCreditsPerToken;\\n vaultAddress = _vaultAddress;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault contract\\n */\\n modifier onlyVault() {\\n require(vaultAddress == msg.sender, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @return The total supply of OUSD.\\n */\\n function totalSupply() public view override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @return Low resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerToken() public view returns (uint256) {\\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return Low resolution total number of rebasing credits\\n */\\n function rebasingCredits() public view returns (uint256) {\\n return _rebasingCredits / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return High resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\\n return _rebasingCreditsPerToken;\\n }\\n\\n /**\\n * @return High resolution total number of rebasing credits\\n */\\n function rebasingCreditsHighres() public view returns (uint256) {\\n return _rebasingCredits;\\n }\\n\\n /**\\n * @dev Gets the balance of the specified address.\\n * @param _account Address to query the balance of.\\n * @return A uint256 representing the amount of base units owned by the\\n * specified address.\\n */\\n function balanceOf(address _account)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n if (_creditBalances[_account] == 0) return 0;\\n return\\n _creditBalances[_account].divPrecisely(_creditsPerToken(_account));\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @dev Backwards compatible with old low res credits per token.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256) Credit balance and credits per token of the\\n * address\\n */\\n function creditsBalanceOf(address _account)\\n public\\n view\\n returns (uint256, uint256)\\n {\\n uint256 cpt = _creditsPerToken(_account);\\n if (cpt == 1e27) {\\n // For a period before the resolution upgrade, we created all new\\n // contract accounts at high resolution. Since they are not changing\\n // as a result of this upgrade, we will return their true values\\n return (_creditBalances[_account], cpt);\\n } else {\\n return (\\n _creditBalances[_account] / RESOLUTION_INCREASE,\\n cpt / RESOLUTION_INCREASE\\n );\\n }\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256, bool) Credit balance, credits per token of the\\n * address, and isUpgraded\\n */\\n function creditsBalanceOfHighres(address _account)\\n public\\n view\\n returns (\\n uint256,\\n uint256,\\n bool\\n )\\n {\\n return (\\n _creditBalances[_account],\\n _creditsPerToken(_account),\\n isUpgraded[_account] == 1\\n );\\n }\\n\\n /**\\n * @dev Transfer tokens to a specified address.\\n * @param _to the address to transfer to.\\n * @param _value the amount to be transferred.\\n * @return true on success.\\n */\\n function transfer(address _to, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(\\n _value <= balanceOf(msg.sender),\\n \\\"Transfer greater than balance\\\"\\n );\\n\\n _executeTransfer(msg.sender, _to, _value);\\n\\n emit Transfer(msg.sender, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Transfer tokens from one address to another.\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value The amount of tokens to be transferred.\\n */\\n function transferFrom(\\n address _from,\\n address _to,\\n uint256 _value\\n ) public override returns (bool) {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(_value <= balanceOf(_from), \\\"Transfer greater than balance\\\");\\n\\n _allowances[_from][msg.sender] = _allowances[_from][msg.sender].sub(\\n _value\\n );\\n\\n _executeTransfer(_from, _to, _value);\\n\\n emit Transfer(_from, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Update the count of non rebasing credits in response to a transfer\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value Amount of OUSD to transfer\\n */\\n function _executeTransfer(\\n address _from,\\n address _to,\\n uint256 _value\\n ) internal {\\n bool isNonRebasingTo = _isNonRebasingAccount(_to);\\n bool isNonRebasingFrom = _isNonRebasingAccount(_from);\\n\\n // Credits deducted and credited might be different due to the\\n // differing creditsPerToken used by each account\\n uint256 creditsCredited = _value.mulTruncate(_creditsPerToken(_to));\\n uint256 creditsDeducted = _value.mulTruncate(_creditsPerToken(_from));\\n\\n _creditBalances[_from] = _creditBalances[_from].sub(\\n creditsDeducted,\\n \\\"Transfer amount exceeds balance\\\"\\n );\\n _creditBalances[_to] = _creditBalances[_to].add(creditsCredited);\\n\\n if (isNonRebasingTo && !isNonRebasingFrom) {\\n // Transfer to non-rebasing account from rebasing account, credits\\n // are removed from the non rebasing tally\\n nonRebasingSupply = nonRebasingSupply.add(_value);\\n // Update rebasingCredits by subtracting the deducted amount\\n _rebasingCredits = _rebasingCredits.sub(creditsDeducted);\\n } else if (!isNonRebasingTo && isNonRebasingFrom) {\\n // Transfer to rebasing account from non-rebasing account\\n // Decreasing non-rebasing credits by the amount that was sent\\n nonRebasingSupply = nonRebasingSupply.sub(_value);\\n // Update rebasingCredits by adding the credited amount\\n _rebasingCredits = _rebasingCredits.add(creditsCredited);\\n }\\n }\\n\\n /**\\n * @dev Function to check the amount of tokens that _owner has allowed to\\n * `_spender`.\\n * @param _owner The address which owns the funds.\\n * @param _spender The address which will spend the funds.\\n * @return The number of tokens still available for the _spender.\\n */\\n function allowance(address _owner, address _spender)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n return _allowances[_owner][_spender];\\n }\\n\\n /**\\n * @dev Approve the passed address to spend the specified amount of tokens\\n * on behalf of msg.sender. This method is included for ERC20\\n * compatibility. `increaseAllowance` and `decreaseAllowance` should be\\n * used instead.\\n *\\n * Changing an allowance with this method brings the risk that someone\\n * may transfer both the old and the new allowance - if they are both\\n * greater than zero - if a transfer transaction is mined before the\\n * later approve() call is mined.\\n * @param _spender The address which will spend the funds.\\n * @param _value The amount of tokens to be spent.\\n */\\n function approve(address _spender, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _value;\\n emit Approval(msg.sender, _spender, _value);\\n return true;\\n }\\n\\n /**\\n * @dev Increase the amount of tokens that an owner has allowed to\\n * `_spender`.\\n * This method should be used instead of approve() to avoid the double\\n * approval vulnerability described above.\\n * @param _spender The address which will spend the funds.\\n * @param _addedValue The amount of tokens to increase the allowance by.\\n */\\n function increaseAllowance(address _spender, uint256 _addedValue)\\n public\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _allowances[msg.sender][_spender]\\n .add(_addedValue);\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Decrease the amount of tokens that an owner has allowed to\\n `_spender`.\\n * @param _spender The address which will spend the funds.\\n * @param _subtractedValue The amount of tokens to decrease the allowance\\n * by.\\n */\\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\\n public\\n returns (bool)\\n {\\n uint256 oldValue = _allowances[msg.sender][_spender];\\n if (_subtractedValue >= oldValue) {\\n _allowances[msg.sender][_spender] = 0;\\n } else {\\n _allowances[msg.sender][_spender] = oldValue.sub(_subtractedValue);\\n }\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Mints new tokens, increasing totalSupply.\\n */\\n function mint(address _account, uint256 _amount) external onlyVault {\\n _mint(_account, _amount);\\n }\\n\\n /**\\n * @dev Creates `_amount` tokens and assigns them to `_account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `to` cannot be the zero address.\\n */\\n function _mint(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Mint to the zero address\\\");\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n _creditBalances[_account] = _creditBalances[_account].add(creditAmount);\\n\\n // If the account is non rebasing and doesn't have a set creditsPerToken\\n // then set it i.e. this is a mint from a fresh contract\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.add(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.add(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.add(_amount);\\n\\n require(_totalSupply < MAX_SUPPLY, \\\"Max supply\\\");\\n\\n emit Transfer(address(0), _account, _amount);\\n }\\n\\n /**\\n * @dev Burns tokens, decreasing totalSupply.\\n */\\n function burn(address account, uint256 amount) external onlyVault {\\n _burn(account, amount);\\n }\\n\\n /**\\n * @dev Destroys `_amount` tokens from `_account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `_account` cannot be the zero address.\\n * - `_account` must have at least `_amount` tokens.\\n */\\n function _burn(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Burn from the zero address\\\");\\n if (_amount == 0) {\\n return;\\n }\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n uint256 currentCredits = _creditBalances[_account];\\n\\n // Remove the credits, burning rounding errors\\n if (\\n currentCredits == creditAmount || currentCredits - 1 == creditAmount\\n ) {\\n // Handle dust from rounding\\n _creditBalances[_account] = 0;\\n } else if (currentCredits > creditAmount) {\\n _creditBalances[_account] = _creditBalances[_account].sub(\\n creditAmount\\n );\\n } else {\\n revert(\\\"Remove exceeds balance\\\");\\n }\\n\\n // Remove from the credit tallies and non-rebasing supply\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.sub(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.sub(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.sub(_amount);\\n\\n emit Transfer(_account, address(0), _amount);\\n }\\n\\n /**\\n * @dev Get the credits per token for an account. Returns a fixed amount\\n * if the account is non-rebasing.\\n * @param _account Address of the account.\\n */\\n function _creditsPerToken(address _account)\\n internal\\n view\\n returns (uint256)\\n {\\n if (nonRebasingCreditsPerToken[_account] != 0) {\\n return nonRebasingCreditsPerToken[_account];\\n } else {\\n return _rebasingCreditsPerToken;\\n }\\n }\\n\\n /**\\n * @dev Is an account using rebasing accounting or non-rebasing accounting?\\n * Also, ensure contracts are non-rebasing if they have not opted in.\\n * @param _account Address of the account.\\n */\\n function _isNonRebasingAccount(address _account) internal returns (bool) {\\n bool isContract = Address.isContract(_account);\\n if (isContract && rebaseState[_account] == RebaseOptions.NotSet) {\\n _ensureRebasingMigration(_account);\\n }\\n return nonRebasingCreditsPerToken[_account] > 0;\\n }\\n\\n /**\\n * @dev Ensures internal account for rebasing and non-rebasing credits and\\n * supply is updated following deployment of frozen yield change.\\n */\\n function _ensureRebasingMigration(address _account) internal {\\n if (nonRebasingCreditsPerToken[_account] == 0) {\\n emit AccountRebasingDisabled(_account);\\n if (_creditBalances[_account] == 0) {\\n // Since there is no existing balance, we can directly set to\\n // high resolution, and do not have to do any other bookkeeping\\n nonRebasingCreditsPerToken[_account] = 1e27;\\n } else {\\n // Migrate an existing account:\\n\\n // Set fixed credits per token for this account\\n nonRebasingCreditsPerToken[_account] = _rebasingCreditsPerToken;\\n // Update non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(_account));\\n // Update credit tallies\\n _rebasingCredits = _rebasingCredits.sub(\\n _creditBalances[_account]\\n );\\n }\\n }\\n }\\n\\n /**\\n * @notice Enable rebasing for an account.\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n * @param _account Address of the account.\\n */\\n function governanceRebaseOptIn(address _account)\\n public\\n nonReentrant\\n onlyGovernor\\n {\\n _rebaseOptIn(_account);\\n }\\n\\n /**\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n */\\n function rebaseOptIn() public nonReentrant {\\n _rebaseOptIn(msg.sender);\\n }\\n\\n function _rebaseOptIn(address _account) internal {\\n require(_isNonRebasingAccount(_account), \\\"Account has not opted out\\\");\\n\\n // Convert balance into the same amount at the current exchange rate\\n uint256 newCreditBalance = _creditBalances[_account]\\n .mul(_rebasingCreditsPerToken)\\n .div(_creditsPerToken(_account));\\n\\n // Decreasing non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.sub(balanceOf(_account));\\n\\n _creditBalances[_account] = newCreditBalance;\\n\\n // Increase rebasing credits, totalSupply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.add(_creditBalances[_account]);\\n\\n rebaseState[_account] = RebaseOptions.OptIn;\\n\\n // Delete any fixed credits per token\\n delete nonRebasingCreditsPerToken[_account];\\n emit AccountRebasingEnabled(_account);\\n }\\n\\n /**\\n * @dev Explicitly mark that an address is non-rebasing.\\n */\\n function rebaseOptOut() public nonReentrant {\\n require(!_isNonRebasingAccount(msg.sender), \\\"Account has not opted in\\\");\\n\\n // Increase non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(msg.sender));\\n // Set fixed credits per token\\n nonRebasingCreditsPerToken[msg.sender] = _rebasingCreditsPerToken;\\n\\n // Decrease rebasing credits, total supply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.sub(_creditBalances[msg.sender]);\\n\\n // Mark explicitly opted out of rebasing\\n rebaseState[msg.sender] = RebaseOptions.OptOut;\\n emit AccountRebasingDisabled(msg.sender);\\n }\\n\\n /**\\n * @dev Modify the supply without minting new tokens. This uses a change in\\n * the exchange rate between \\\"credits\\\" and OUSD tokens to change balances.\\n * @param _newTotalSupply New total supply of OUSD.\\n */\\n function changeSupply(uint256 _newTotalSupply)\\n external\\n onlyVault\\n nonReentrant\\n {\\n require(_totalSupply > 0, \\\"Cannot increase 0 supply\\\");\\n\\n if (_totalSupply == _newTotalSupply) {\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n return;\\n }\\n\\n _totalSupply = _newTotalSupply > MAX_SUPPLY\\n ? MAX_SUPPLY\\n : _newTotalSupply;\\n\\n _rebasingCreditsPerToken = _rebasingCredits.divPrecisely(\\n _totalSupply.sub(nonRebasingSupply)\\n );\\n\\n require(_rebasingCreditsPerToken > 0, \\\"Invalid change in supply\\\");\\n\\n _totalSupply = _rebasingCredits\\n .divPrecisely(_rebasingCreditsPerToken)\\n .add(nonRebasingSupply);\\n\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n }\\n}\\n\",\"keccak256\":\"0x2dc66b1ba02716d64eb47dd9117fda62650d8b57669e6c351437e0ad29ad5f19\",\"license\":\"MIT\"},\"contracts/utils/Helpers.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IBasicToken } from \\\"../interfaces/IBasicToken.sol\\\";\\n\\nlibrary Helpers {\\n /**\\n * @notice Fetch the `symbol()` from an ERC20 token\\n * @dev Grabs the `symbol()` from a contract\\n * @param _token Address of the ERC20 token\\n * @return string Symbol of the ERC20 token\\n */\\n function getSymbol(address _token) internal view returns (string memory) {\\n string memory symbol = IBasicToken(_token).symbol();\\n return symbol;\\n }\\n\\n /**\\n * @notice Fetch the `decimals()` from an ERC20 token\\n * @dev Grabs the `decimals()` from a contract and fails if\\n * the decimal value does not live within a certain range\\n * @param _token Address of the ERC20 token\\n * @return uint256 Decimals of the ERC20 token\\n */\\n function getDecimals(address _token) internal view returns (uint256) {\\n uint256 decimals = IBasicToken(_token).decimals();\\n require(\\n decimals >= 4 && decimals <= 18,\\n \\\"Token must have sufficient decimal places\\\"\\n );\\n\\n return decimals;\\n }\\n}\\n\",\"keccak256\":\"0x108b7a69e0140da0072ca18f90a03a3340574400f81aa6076cd2cccdf13699c2\",\"license\":\"MIT\"},\"contracts/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract any contracts that need to initialize state after deployment.\\n * @author Origin Protocol Inc\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n */\\n bool private initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private initializing;\\n\\n /**\\n * @dev Modifier to protect an initializer function from being invoked twice.\\n */\\n modifier initializer() {\\n require(\\n initializing || !initialized,\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n\\n bool isTopLevelCall = !initializing;\\n if (isTopLevelCall) {\\n initializing = true;\\n initialized = true;\\n }\\n\\n _;\\n\\n if (isTopLevelCall) {\\n initializing = false;\\n }\\n }\\n\\n uint256[50] private ______gap;\\n}\\n\",\"keccak256\":\"0xaadbcc138114afed4af4f353c2ced2916e6ee14be91434789187f192caf0d786\",\"license\":\"MIT\"},\"contracts/utils/InitializableAbstractStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract for vault strategies.\\n * @author Origin Protocol Inc\\n */\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\n\\nabstract contract InitializableAbstractStrategy is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event PTokenAdded(address indexed _asset, address _pToken);\\n event PTokenRemoved(address indexed _asset, address _pToken);\\n event Deposit(address indexed _asset, address _pToken, uint256 _amount);\\n event Withdrawal(address indexed _asset, address _pToken, uint256 _amount);\\n event RewardTokenCollected(\\n address recipient,\\n address rewardToken,\\n uint256 amount\\n );\\n event RewardTokenAddressesUpdated(\\n address[] _oldAddresses,\\n address[] _newAddresses\\n );\\n event HarvesterAddressesUpdated(\\n address _oldHarvesterAddress,\\n address _newHarvesterAddress\\n );\\n\\n /// @notice Address of the underlying platform\\n address public immutable platformAddress;\\n /// @notice Address of the OToken vault\\n address public immutable vaultAddress;\\n\\n /// @dev Replaced with an immutable variable\\n // slither-disable-next-line constable-states\\n address private _deprecated_platformAddress;\\n\\n /// @dev Replaced with an immutable\\n // slither-disable-next-line constable-states\\n address private _deprecated_vaultAddress;\\n\\n /// @notice asset => pToken (Platform Specific Token Address)\\n mapping(address => address) public assetToPToken;\\n\\n /// @notice Full list of all assets supported by the strategy\\n address[] internal assetsMapped;\\n\\n // Deprecated: Reward token address\\n // slither-disable-next-line constable-states\\n address private _deprecated_rewardTokenAddress;\\n\\n // Deprecated: now resides in Harvester's rewardTokenConfigs\\n // slither-disable-next-line constable-states\\n uint256 private _deprecated_rewardLiquidationThreshold;\\n\\n /// @notice Address of the Harvester contract allowed to collect reward tokens\\n address public harvesterAddress;\\n\\n /// @notice Address of the reward tokens. eg CRV, BAL, CVX, AURA\\n address[] public rewardTokenAddresses;\\n\\n /* Reserved for future expansion. Used to be 100 storage slots\\n * and has decreased to accommodate:\\n * - harvesterAddress\\n * - rewardTokenAddresses\\n */\\n int256[98] private _reserved;\\n\\n struct BaseStrategyConfig {\\n address platformAddress; // Address of the underlying platform\\n address vaultAddress; // Address of the OToken's Vault\\n }\\n\\n /**\\n * @param _config The platform and OToken vault addresses\\n */\\n constructor(BaseStrategyConfig memory _config) {\\n platformAddress = _config.platformAddress;\\n vaultAddress = _config.vaultAddress;\\n }\\n\\n /**\\n * @dev Internal initialize function, to set up initial internal state\\n * @param _rewardTokenAddresses Address of reward token for platform\\n * @param _assets Addresses of initial supported assets\\n * @param _pTokens Platform Token corresponding addresses\\n */\\n function _initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) internal {\\n rewardTokenAddresses = _rewardTokenAddresses;\\n\\n uint256 assetCount = _assets.length;\\n require(assetCount == _pTokens.length, \\\"Invalid input arrays\\\");\\n for (uint256 i = 0; i < assetCount; ++i) {\\n _setPTokenAddress(_assets[i], _pTokens[i]);\\n }\\n }\\n\\n /**\\n * @notice Collect accumulated reward token and send to Vault.\\n */\\n function collectRewardTokens() external virtual onlyHarvester nonReentrant {\\n _collectRewardTokens();\\n }\\n\\n /**\\n * @dev Default implementation that transfers reward tokens to the Harvester\\n * Implementing strategies need to add custom logic to collect the rewards.\\n */\\n function _collectRewardTokens() internal virtual {\\n uint256 rewardTokenCount = rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n IERC20 rewardToken = IERC20(rewardTokenAddresses[i]);\\n uint256 balance = rewardToken.balanceOf(address(this));\\n if (balance > 0) {\\n emit RewardTokenCollected(\\n harvesterAddress,\\n address(rewardToken),\\n balance\\n );\\n rewardToken.safeTransfer(harvesterAddress, balance);\\n }\\n }\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault.\\n */\\n modifier onlyVault() {\\n require(msg.sender == vaultAddress, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Harvester.\\n */\\n modifier onlyHarvester() {\\n require(msg.sender == harvesterAddress, \\\"Caller is not the Harvester\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault or Governor.\\n */\\n modifier onlyVaultOrGovernor() {\\n require(\\n msg.sender == vaultAddress || msg.sender == governor(),\\n \\\"Caller is not the Vault or Governor\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault, Governor, or Strategist.\\n */\\n modifier onlyVaultOrGovernorOrStrategist() {\\n require(\\n msg.sender == vaultAddress ||\\n msg.sender == governor() ||\\n msg.sender == IVault(vaultAddress).strategistAddr(),\\n \\\"Caller is not the Vault, Governor, or Strategist\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @notice Set the reward token addresses. Any old addresses will be overwritten.\\n * @param _rewardTokenAddresses Array of reward token addresses\\n */\\n function setRewardTokenAddresses(address[] calldata _rewardTokenAddresses)\\n external\\n onlyGovernor\\n {\\n uint256 rewardTokenCount = _rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n require(\\n _rewardTokenAddresses[i] != address(0),\\n \\\"Can not set an empty address as a reward token\\\"\\n );\\n }\\n\\n emit RewardTokenAddressesUpdated(\\n rewardTokenAddresses,\\n _rewardTokenAddresses\\n );\\n rewardTokenAddresses = _rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Get the reward token addresses.\\n * @return address[] the reward token addresses.\\n */\\n function getRewardTokenAddresses()\\n external\\n view\\n returns (address[] memory)\\n {\\n return rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * This method can only be called by the system Governor\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function setPTokenAddress(address _asset, address _pToken)\\n external\\n virtual\\n onlyGovernor\\n {\\n _setPTokenAddress(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Remove a supported asset by passing its index.\\n * This method can only be called by the system Governor\\n * @param _assetIndex Index of the asset to be removed\\n */\\n function removePToken(uint256 _assetIndex) external virtual onlyGovernor {\\n require(_assetIndex < assetsMapped.length, \\\"Invalid index\\\");\\n address asset = assetsMapped[_assetIndex];\\n address pToken = assetToPToken[asset];\\n\\n if (_assetIndex < assetsMapped.length - 1) {\\n assetsMapped[_assetIndex] = assetsMapped[assetsMapped.length - 1];\\n }\\n assetsMapped.pop();\\n assetToPToken[asset] = address(0);\\n\\n emit PTokenRemoved(asset, pToken);\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * Add to internal mappings and execute the platform specific,\\n * abstract method `_abstractSetPToken`\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function _setPTokenAddress(address _asset, address _pToken) internal {\\n require(assetToPToken[_asset] == address(0), \\\"pToken already set\\\");\\n require(\\n _asset != address(0) && _pToken != address(0),\\n \\\"Invalid addresses\\\"\\n );\\n\\n assetToPToken[_asset] = _pToken;\\n assetsMapped.push(_asset);\\n\\n emit PTokenAdded(_asset, _pToken);\\n\\n _abstractSetPToken(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\\n * strategy contracts, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n public\\n onlyGovernor\\n {\\n require(!supportsAsset(_asset), \\\"Cannot transfer supported asset\\\");\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @notice Set the Harvester contract that can collect rewards.\\n * @param _harvesterAddress Address of the harvester contract.\\n */\\n function setHarvesterAddress(address _harvesterAddress)\\n external\\n onlyGovernor\\n {\\n emit HarvesterAddressesUpdated(harvesterAddress, _harvesterAddress);\\n harvesterAddress = _harvesterAddress;\\n }\\n\\n /***************************************\\n Abstract\\n ****************************************/\\n\\n function _abstractSetPToken(address _asset, address _pToken)\\n internal\\n virtual;\\n\\n function safeApproveAllTokens() external virtual;\\n\\n /**\\n * @notice Deposit an amount of assets into the platform\\n * @param _asset Address for the asset\\n * @param _amount Units of asset to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external virtual;\\n\\n /**\\n * @notice Deposit all supported assets in this strategy contract to the platform\\n */\\n function depositAll() external virtual;\\n\\n /**\\n * @notice Withdraw an `amount` of assets from the platform and\\n * send to the `_recipient`.\\n * @param _recipient Address to which the asset should be sent\\n * @param _asset Address of the asset\\n * @param _amount Units of asset to withdraw\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external virtual;\\n\\n /**\\n * @notice Withdraw all supported assets from platform and\\n * sends to the OToken's Vault.\\n */\\n function withdrawAll() external virtual;\\n\\n /**\\n * @notice Get the total asset value held in the platform.\\n * This includes any interest that was generated since depositing.\\n * @param _asset Address of the asset\\n * @return balance Total value of the asset in the platform\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n virtual\\n returns (uint256 balance);\\n\\n /**\\n * @notice Check if an asset is supported.\\n * @param _asset Address of the asset\\n * @return bool Whether asset is supported\\n */\\n function supportsAsset(address _asset) public view virtual returns (bool);\\n}\\n\",\"keccak256\":\"0x5e17bb3db9f9e1014b7c5c836547f8fa81e02af7568c0bb8f2a2e0e7c2192db4\",\"license\":\"MIT\"},\"contracts/utils/InitializableERC20Detailed.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/**\\n * @dev Optional functions from the ERC20 standard.\\n * Converted from openzeppelin/contracts/token/ERC20/ERC20Detailed.sol\\n * @author Origin Protocol Inc\\n */\\nabstract contract InitializableERC20Detailed is IERC20 {\\n // Storage gap to skip storage from prior to OUSD reset\\n uint256[100] private _____gap;\\n\\n string private _name;\\n string private _symbol;\\n uint8 private _decimals;\\n\\n /**\\n * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of\\n * these values are immutable: they can only be set once during\\n * construction.\\n * @notice To avoid variable shadowing appended `Arg` after arguments name.\\n */\\n function _initialize(\\n string memory nameArg,\\n string memory symbolArg,\\n uint8 decimalsArg\\n ) internal {\\n _name = nameArg;\\n _symbol = symbolArg;\\n _decimals = decimalsArg;\\n }\\n\\n /**\\n * @notice Returns the name of the token.\\n */\\n function name() public view returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @notice Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @notice Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5,05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view returns (uint8) {\\n return _decimals;\\n }\\n}\\n\",\"keccak256\":\"0xe35ac2d813a30d845a3b52bba72588d7e936c2b3f3373d15568c14db46aeed60\",\"license\":\"MIT\"},\"contracts/utils/StableMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\n\\n// Based on StableMath from Stability Labs Pty. Ltd.\\n// https://github.com/mstable/mStable-contracts/blob/master/contracts/shared/StableMath.sol\\n\\nlibrary StableMath {\\n using SafeMath for uint256;\\n\\n /**\\n * @dev Scaling unit for use in specific calculations,\\n * where 1 * 10**18, or 1e18 represents a unit '1'\\n */\\n uint256 private constant FULL_SCALE = 1e18;\\n\\n /***************************************\\n Helpers\\n ****************************************/\\n\\n /**\\n * @dev Adjust the scale of an integer\\n * @param to Decimals to scale to\\n * @param from Decimals to scale from\\n */\\n function scaleBy(\\n uint256 x,\\n uint256 to,\\n uint256 from\\n ) internal pure returns (uint256) {\\n if (to > from) {\\n x = x.mul(10**(to - from));\\n } else if (to < from) {\\n // slither-disable-next-line divide-before-multiply\\n x = x.div(10**(from - to));\\n }\\n return x;\\n }\\n\\n /***************************************\\n Precise Arithmetic\\n ****************************************/\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncate(uint256 x, uint256 y) internal pure returns (uint256) {\\n return mulTruncateScale(x, y, FULL_SCALE);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the given scale. For example,\\n * when calculating 90% of 10e18, (10e18 * 9e17) / 1e18 = (9e36) / 1e18 = 9e18\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @param scale Scale unit\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncateScale(\\n uint256 x,\\n uint256 y,\\n uint256 scale\\n ) internal pure returns (uint256) {\\n // e.g. assume scale = fullScale\\n // z = 10e18 * 9e17 = 9e36\\n uint256 z = x.mul(y);\\n // return 9e36 / 1e18 = 9e18\\n return z.div(scale);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale, rounding up the result\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit, rounded up to the closest base unit.\\n */\\n function mulTruncateCeil(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e17 * 17268172638 = 138145381104e17\\n uint256 scaled = x.mul(y);\\n // e.g. 138145381104e17 + 9.99...e17 = 138145381113.99...e17\\n uint256 ceil = scaled.add(FULL_SCALE.sub(1));\\n // e.g. 13814538111.399...e18 / 1e18 = 13814538111\\n return ceil.div(FULL_SCALE);\\n }\\n\\n /**\\n * @dev Precisely divides two units, by first scaling the left hand operand. Useful\\n * for finding percentage weightings, i.e. 8e18/10e18 = 80% (or 8e17)\\n * @param x Left hand input to division\\n * @param y Right hand input to division\\n * @return Result after multiplying the left operand by the scale, and\\n * executing the division on the right hand input.\\n */\\n function divPrecisely(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e18 * 1e18 = 8e36\\n uint256 z = x.mul(FULL_SCALE);\\n // e.g. 8e36 / 10e18 = 8e17\\n return z.div(y);\\n }\\n}\\n\",\"keccak256\":\"0x1eb49f6f79045d9e0a8e1dced8e01d9e559e5fac554dcbb53e43140b601b04e7\",\"license\":\"MIT\"},\"contracts/vault/VaultStorage.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OToken VaultStorage contract\\n * @notice The VaultStorage contract defines the storage for the Vault contracts\\n * @author Origin Protocol Inc\\n */\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { OUSD } from \\\"../token/OUSD.sol\\\";\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\ncontract VaultStorage is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event OusdMetaStrategyUpdated(address _ousdMetaStrategy);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event NetOusdMintForStrategyThresholdChanged(uint256 _threshold);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Assets supported by the Vault, i.e. Stablecoins\\n enum UnitConversion {\\n DECIMALS,\\n GETEXCHANGERATE\\n }\\n // Changed to fit into a single storage slot so the decimals needs to be recached\\n struct Asset {\\n // Note: OETHVaultCore doesn't use `isSupported` when minting,\\n // redeeming or checking balance of assets.\\n bool isSupported;\\n UnitConversion unitConversion;\\n uint8 decimals;\\n // Max allowed slippage from the Oracle price when swapping collateral assets in basis points.\\n // For example 40 == 0.4% slippage\\n uint16 allowedOracleSlippageBps;\\n }\\n\\n /// @dev mapping of supported vault assets to their configuration\\n // slither-disable-next-line uninitialized-state\\n mapping(address => Asset) internal assets;\\n /// @dev list of all assets supported by the vault.\\n // slither-disable-next-line uninitialized-state\\n address[] internal allAssets;\\n\\n // Strategies approved for use by the Vault\\n struct Strategy {\\n bool isSupported;\\n uint256 _deprecated; // Deprecated storage slot\\n }\\n /// @dev mapping of strategy contracts to their configiration\\n mapping(address => Strategy) internal strategies;\\n /// @dev list of all vault strategies\\n address[] internal allStrategies;\\n\\n /// @notice Address of the Oracle price provider contract\\n // slither-disable-next-line uninitialized-state\\n address public priceProvider;\\n /// @notice pause rebasing if true\\n bool public rebasePaused = false;\\n /// @notice pause operations that change the OToken supply.\\n /// eg mint, redeem, allocate, mint/burn for strategy\\n bool public capitalPaused = true;\\n /// @notice Redemption fee in basis points. eg 50 = 0.5%\\n uint256 public redeemFeeBps;\\n /// @notice Percentage of assets to keep in Vault to handle (most) withdrawals. 100% = 1e18.\\n uint256 public vaultBuffer;\\n /// @notice OToken mints over this amount automatically allocate funds. 18 decimals.\\n uint256 public autoAllocateThreshold;\\n /// @notice OToken mints over this amount automatically rebase. 18 decimals.\\n uint256 public rebaseThreshold;\\n\\n /// @dev Address of the OToken token. eg OUSD or OETH.\\n // slither-disable-next-line uninitialized-state\\n OUSD internal oUSD;\\n\\n //keccak256(\\\"OUSD.vault.governor.admin.impl\\\");\\n bytes32 constant adminImplPosition =\\n 0xa2bd3d3cf188a41358c8b401076eb59066b09dec5775650c0de4c55187d17bd9;\\n\\n // Address of the contract responsible for post rebase syncs with AMMs\\n address private _deprecated_rebaseHooksAddr = address(0);\\n\\n // Deprecated: Address of Uniswap\\n // slither-disable-next-line constable-states\\n address private _deprecated_uniswapAddr = address(0);\\n\\n /// @notice Address of the Strategist\\n address public strategistAddr = address(0);\\n\\n /// @notice Mapping of asset address to the Strategy that they should automatically\\n // be allocated to\\n // slither-disable-next-line uninitialized-state\\n mapping(address => address) public assetDefaultStrategies;\\n\\n /// @notice Max difference between total supply and total value of assets. 18 decimals.\\n // slither-disable-next-line uninitialized-state\\n uint256 public maxSupplyDiff;\\n\\n /// @notice Trustee contract that can collect a percentage of yield\\n address public trusteeAddress;\\n\\n /// @notice Amount of yield collected in basis points. eg 2000 = 20%\\n uint256 public trusteeFeeBps;\\n\\n /// @dev Deprecated: Tokens that should be swapped for stablecoins\\n address[] private _deprecated_swapTokens;\\n\\n uint256 constant MINT_MINIMUM_UNIT_PRICE = 0.998e18;\\n\\n /// @notice Metapool strategy that is allowed to mint/burn OTokens without changing collateral\\n address public ousdMetaStrategy = address(0);\\n\\n /// @notice How much OTokens are currently minted by the strategy\\n int256 public netOusdMintedForStrategy = 0;\\n\\n /// @notice How much net total OTokens are allowed to be minted by all strategies\\n uint256 public netOusdMintForStrategyThreshold = 0;\\n\\n uint256 constant MIN_UNIT_PRICE_DRIFT = 0.7e18;\\n uint256 constant MAX_UNIT_PRICE_DRIFT = 1.3e18;\\n\\n /// @notice Collateral swap configuration.\\n /// @dev is packed into a single storage slot to save gas.\\n struct SwapConfig {\\n // Contract that swaps the vault's collateral assets\\n address swapper;\\n // Max allowed percentage the total value can drop below the total supply in basis points.\\n // For example 100 == 1%\\n uint16 allowedUndervalueBps;\\n }\\n SwapConfig internal swapConfig = SwapConfig(address(0), 0);\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /**\\n * @notice set the implementation for the admin, this needs to be in a base class else we cannot set it\\n * @param newImpl address of the implementation\\n */\\n function setAdminImpl(address newImpl) external onlyGovernor {\\n require(\\n Address.isContract(newImpl),\\n \\\"new implementation is not a contract\\\"\\n );\\n bytes32 position = adminImplPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newImpl)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xbcefeb5e2b88d99a54dbe6542dc25d0a68eeaf3adfe6e12fb70049cc024b1a79\",\"license\":\"MIT\"}},\"version\":1}", + "bytecode": "0x60e06040523480156200001157600080fd5b506040516200360438038062003604833981016040819052620000349162000215565b81816200004e33600080516020620035e483398151915255565b600080516020620035e4833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36001600160a01b038216620000aa57600080fd5b6001600160a01b038116620000be57600080fd5b606082811b6001600160601b03199081166080529082901b1660a052620000f181620000ff602090811b62000d3217901c565b60c052506200027992505050565b600080826001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b1580156200013c57600080fd5b505afa15801562000151573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906200017791906200024d565b60ff169050600481101580156200018f575060128111155b620001f25760405162461bcd60e51b815260206004820152602960248201527f546f6b656e206d75737420686176652073756666696369656e7420646563696d604482015268616c20706c6163657360b81b606482015260840160405180910390fd5b92915050565b80516001600160a01b03811681146200021057600080fd5b919050565b600080604083850312156200022957600080fd5b6200023483620001f8565b91506200024460208401620001f8565b90509250929050565b6000602082840312156200026057600080fd5b815160ff811681146200027257600080fd5b9392505050565b60805160601c60a05160601c60c0516132d362000311600039600081816102910152611b4b01526000818161026a015281816110630152818161115c0152818161128001528181611486015281816114ca0152818161191b0152818161198501528181611bfe01528181611c8401528181611db1015261236e0152600081816101a301528181610539015261158b01526132d36000f3fe608060405234801561001057600080fd5b506004361061012c5760003560e01c806382aa1c88116100ad578063d38bfff411610071578063d38bfff414610312578063da70696c14610325578063dac4db4e14610345578063e48d7fc514610358578063ee3be5f5146103ac57600080fd5b806382aa1c881461028c578063a994317f146102c1578063b13dc20a146102d4578063b76e83af146102e7578063c7af3352146102fa57600080fd5b8063548f5ae5116100f4578063548f5ae5146101c5578063587c8440146101d85780635d36b1901461024a57806365f6fa94146102525780637cb374bd1461026557600080fd5b80630c340a24146101315780631072cbea146101565780632579153d1461016b5780632dfbe8311461017e578063430bf08a1461019e575b600080fd5b6101396103cf565b6040516001600160a01b0390911681526020015b60405180910390f35b6101696101643660046127b3565b6103ec565b005b610169610179366004612716565b610439565b61019161018c366004612675565b6108c8565b60405161014d9190612be6565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6101696101d3366004612675565b610962565b6102386101e6366004612675565b6000602081905290815260409020805460019091015461ffff80831692620100008104909116916001600160a01b036401000000008304169160ff600160c01b8204811692600160c81b909204169086565b60405161014d96959493929190612d77565b6101696109dd565b6101696102603660046126e8565b610a83565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6102b37f000000000000000000000000000000000000000000000000000000000000000081565b60405190815260200161014d565b6101696102cf3660046126af565b610b0a565b6101696102e2366004612675565b610b86565b600254610139906001600160a01b031681565b610302610c25565b604051901515815260200161014d565b610169610320366004612675565b610c56565b6102b3610333366004612675565b60056020526000908152604090205481565b6101396103533660046127b3565b610cfa565b61038c610366366004612675565b6006602052600090815260409020546001600160801b0380821691600160801b90041682565b604080516001600160801b0393841681529290911660208301520161014d565b6103026103ba366004612675565b60016020526000908152604090205460ff1681565b60006103e760008051602061327e8339815191525490565b905090565b6103f4610c25565b6104195760405162461bcd60e51b815260040161041090612c26565b60405180910390fd5b6104356104246103cf565b6001600160a01b0384169083610e21565b5050565b610441610c25565b61045d5760405162461bcd60e51b815260040161041090612c26565b6103e861046d6020850185612a71565b61ffff1611156104905760405163faa3445560e01b815260040160405180910390fd5b6103e86104a36040850160208601612a71565b61ffff1611156104c657604051631633c8cd60e31b815260040160405180910390fd5b60006104d86060850160408601612675565b90506001600160a01b03811661050157604051637138356f60e01b815260040160405180910390fd5b6001600160a01b038086166000908152602081905260409020805464010000000090049091169085906105348282613142565b9050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b15801561059057600080fd5b505afa1580156105a4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105c89190612692565b6040516315d5220f60e31b81526001600160a01b038881166004830152919091169063aea910789060240160206040518083038186803b15801561060b57600080fd5b505afa15801561061f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106439190612a8e565b50856001600160a01b0382161580159061066f5750826001600160a01b0316826001600160a01b031614155b15610689576106896001600160a01b038216836000610e89565b826001600160a01b0316826001600160a01b0316146106cd576106b76001600160a01b038216846000610e89565b6106cd6001600160a01b03821684600019610e89565b60006106df60a08801608089016129f9565b905060008160038111156106f5576106f56130e6565b14156107395761070686868a610fad565b6001600160a01b03891660009081526003602090815260409091208251610733939192919091019061256b565b50610846565b600181600381111561074d5761074d6130e6565b14156107815761075e86868a6110d9565b6001600160a01b038a1660009081526004602052604090206107339290916125d0565b6002816003811115610795576107956130e6565b14156107c5576107a78686868b6111af565b6001600160a01b038916600090815260056020526040902055610846565b60038160038111156107d9576107d96130e6565b141561082b576107eb8686868b611311565b6001600160a01b0389166000908152600660209081526040909120825192909101516001600160801b03908116600160801b029216919091179055610846565b806040516336cb1d2160e01b81526004016104109190612bf9565b7f5eb6073ba3980477f03b1ce0dccba754d48454bbd65a115dcd42db65ca1fefd28861087560208a018a612a71565b61088560408b0160208c01612a71565b84888b8b8e60a001358f60600160208101906108a191906129a6565b6040516108b699989796959493929190612b67565b60405180910390a15050505050505050565b600460205260009081526040902080546108e19061307a565b80601f016020809104026020016040519081016040528092919081815260200182805461090d9061307a565b801561095a5780601f1061092f5761010080835404028352916020019161095a565b820191906000526020600020905b81548152906001019060200180831161093d57829003601f168201915b505050505081565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535805460028114156109c75760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b600282556109d58333611500565b506001905550565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610a785760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610410565b610a8133611667565b565b610a8b610c25565b610aa75760405162461bcd60e51b815260040161041090612c26565b6001600160a01b038216600081815260016020908152604091829020805460ff19168515159081179091558251938452908301527f013ed61add17cbfcbbd95bf8543da67c89658c5477d3f3199a1a2d58ecf1913f910160405180910390a15050565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac453580546002811415610b6f5760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b60028255610b7d8484611500565b50600190555050565b610b8e610c25565b610baa5760405162461bcd60e51b815260040161041090612c26565b6001600160a01b038116610bd157604051637138356f60e01b815260040160405180910390fd5b600280546001600160a01b0319166001600160a01b0383169081179091556040519081527f50f4ca9002119593802480c412cb5e106ae726647a31dcf8a7e7ed4e6794bf5e9060200160405180910390a150565b6000610c3d60008051602061327e8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b610c5e610c25565b610c7a5760405162461bcd60e51b815260040161041090612c26565b610ca2817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b0316610cc260008051602061327e8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b60036020528160005260406000208181548110610d1657600080fd5b6000918252602090912001546001600160a01b03169150829050565b600080826001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b158015610d6e57600080fd5b505afa158015610d82573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610da69190612ae8565b60ff16905060048110158015610dbd575060128111155b610e1b5760405162461bcd60e51b815260206004820152602960248201527f546f6b656e206d75737420686176652073756666696369656e7420646563696d604482015268616c20706c6163657360b81b6064820152608401610410565b92915050565b6040516001600160a01b038316602482015260448101829052610e8490849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261172b565b505050565b801580610f125750604051636eb1769f60e11b81523060048201526001600160a01b03838116602483015284169063dd62ed3e9060440160206040518083038186803b158015610ed857600080fd5b505afa158015610eec573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f109190612a8e565b155b610f7d5760405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b6064820152608401610410565b6040516001600160a01b038316602482015260448101829052610e8490849063095ea7b360e01b90606401610e4d565b6060610fbb838501856127df565b80519091506002811015610fe2576040516360fa33db60e11b815260040160405180910390fd5b826001600160a01b031682600081518110610fff57610fff6130fc565b60200260200101516001600160a01b0316146110595781600081518110611028576110286130fc565b602002602001015160405163280d94a560e21b815260040161041091906001600160a01b0391909116815260200190565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168261108f600184612ffe565b8151811061109f5761109f6130fc565b60200260200101516001600160a01b0316146110d157816110c1600183612ffe565b81518110611028576110286130fc565b509392505050565b828260006110ea6014828486612e85565b6110f391613015565b60601c90506001600160a01b038416811461112c5760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b8585611139601485612ffe565b611144928290612e85565b61114d91613015565b60601c90506001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001681146111a65760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b50935093915050565b60006111bd848601866129e0565b9050806111dd57604051634bdc2c9560e01b815260040160405180910390fd5b60405163160bf1c960e31b8152600481018290526001600160a01b03838116602483015284919082169063b05f8e489060440160806040518083038186803b15801561122857600080fd5b505afa15801561123c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112609190612aa7565b505060405163160bf1c960e31b8152600481018590526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811660248301528416925063b05f8e48915060440160806040518083038186803b1580156112cc57600080fd5b505afa1580156112e0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113049190612aa7565b5050505050949350505050565b604080518082019091526000808252602082015261133184860186612a16565b805160405163c661065760e01b81526001600160801b03909116600482015290915083906001600160a01b0382169063c66106579060240160206040518083038186803b15801561138157600080fd5b505afa158015611395573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b99190612692565b6001600160a01b0316836001600160a01b0316146113f55760405163d658230160e01b81526001600160a01b0384166004820152602401610410565b602082015160405163c661065760e01b81526001600160801b0390911660048201526001600160a01b0382169063c66106579060240160206040518083038186803b15801561144357600080fd5b505afa158015611457573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061147b9190612692565b6001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316146114f75760405163d658230160e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166004820152602401610410565b50949350505050565b611509826117fd565b60008290506000816001600160a01b031663f6ca71b06040518163ffffffff1660e01b815260040160006040518083038186803b15801561154957600080fd5b505afa15801561155d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526115859190810190612885565b905060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b1580156115e257600080fd5b505afa1580156115f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061161a9190612692565b825190915060005b8181101561165e5761164e84828151811061163f5761163f6130fc565b6020026020010151878561189d565b611657816130b5565b9050611622565b50505050505050565b6001600160a01b0381166116bd5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610410565b806001600160a01b03166116dd60008051602061327e8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36117288160008051602061327e83398151915255565b50565b6000611780826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316611e0f9092919063ffffffff16565b805190915015610e84578080602001905181019061179e91906129c3565b610e845760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610410565b6001600160a01b03811660009081526001602052604090205460ff1661184157604051630211444960e11b81526001600160a01b0382166004820152602401610410565b6000819050806001600160a01b0316635a063f636040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561188157600080fd5b505af1158015611895573d6000803e3d6000fd5b505050505050565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a082319060240160206040518083038186803b1580156118df57600080fd5b505afa1580156118f3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119179190612a8e565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614156119df5760025461196d906001600160a01b03868116911683610e21565b604080516000808252602082018490528183015290517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316917f42e60aae8f000883c46e2f449fa76268e374ce1b962f46ca9360ab98b18f5799919081900360600190a250505050565b6001600160a01b03808516600090815260208181526040808320815160c081018352815461ffff8082168352620100008204169482019490945264010000000084049095169185019190915260ff600160c01b830481161515606086015292939290916080840191600160c81b909104166003811115611a6157611a616130e6565b6003811115611a7257611a726130e6565b815260200160018201548152505090508060600151611a92575050505050565b81611a9e575050505050565b60a081015115611ab957611ab6828260a00151611e28565b91505b6040516315d5220f60e31b81526001600160a01b0386811660048301526000919085169063aea910789060240160206040518083038186803b158015611afe57600080fd5b505afa158015611b12573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b369190612a8e565b90506000670de0b6b3a7640000612710611ba27f0000000000000000000000000000000000000000000000000000000000000000611b738b610d32565b87518790611b8390612710612fdb565b611b919061ffff168b612fbc565b611b9b9190612fbc565b9190611e3e565b611bac9190612eaf565b611bb69190612eaf565b90506000611bcf846080015185604001518a8886611ea0565b905081811015611bfc576040516302d96fff60e41b81526004810182905260248101839052604401610410565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316886001600160a01b03167fa861903141bc68b536d5048a576afcc645630e1b18a4296ef34cbd4d1407f70986608001518885604051611c6793929190612c07565b60405180910390a36040516370a0823160e01b81523060048201527f0000000000000000000000000000000000000000000000000000000000000000906000906001600160a01b038316906370a082319060240160206040518083038186803b158015611cd357600080fd5b505afa158015611ce7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d0b9190612a8e565b905082811015611d385760405163315d50df60e11b81526004810182905260248101849052604401610410565b6020860151600090611d5290859061ffff16612710611f64565b90506000611d608284612ffe565b600254909150611d7d906001600160a01b03868116911683610e21565b611d916001600160a01b0385168c84610e21565b604080516001600160a01b038d81168252602082018490529181018490527f0000000000000000000000000000000000000000000000000000000000000000909116907f42e60aae8f000883c46e2f449fa76268e374ce1b962f46ca9360ab98b18f57999060600160405180910390a2505050505050505050505050565b6060611e1e8484600085611f7d565b90505b9392505050565b6000818310611e375781611e21565b5090919050565b600081831115611e6e57611e67611e558385612ffe565b611e6090600a612f14565b85906120a5565b9350611e98565b81831015611e9857611e95611e838484612ffe565b611e8e90600a612f14565b85906120b1565b93505b509192915050565b600080866003811115611eb557611eb56130e6565b1415611ece57611ec7858585856120bd565b9050611f5b565b6001866003811115611ee257611ee26130e6565b1415611ef457611ec7858585856121ec565b6002866003811115611f0857611f086130e6565b1415611f1a57611ec785858585612337565b6003866003811115611f2e57611f2e6130e6565b1415611f4057611ec785858585612459565b856040516336cb1d2160e01b81526004016104109190612bf9565b95945050505050565b600080611f7185856120a5565b9050611f5b81846120b1565b606082471015611fde5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610410565b843b61202c5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610410565b600080866001600160a01b031685876040516120489190612b4b565b60006040518083038185875af1925050503d8060008114612085576040519150601f19603f3d011682016040523d82523d6000602084013e61208a565b606091505b509150915061209a828286612532565b979650505050505050565b6000611e218284612fbc565b6000611e218284612eaf565b6001600160a01b03831660009081526003602090815260408083208054825181850281018501909352808352849383018282801561212457602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612106575b505050505090506000866001600160a01b03166338ed173986868530426040518663ffffffff1660e01b8152600401612161959493929190612dbf565b600060405180830381600087803b15801561217b57600080fd5b505af115801561218f573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526121b7919081019061291a565b905080600182516121c89190612ffe565b815181106121d8576121d86130fc565b602002602001015192505050949350505050565b6001600160a01b038316600090815260046020526040812080548291906122129061307a565b80601f016020809104026020016040519081016040528092919081815260200182805461223e9061307a565b801561228b5780601f106122605761010080835404028352916020019161228b565b820191906000526020600020905b81548152906001019060200180831161226e57829003601f168201915b50506040805160a0810182528581523060208201524281830152606081018a905260808101899052905163c04b8d5960e01b8152949550936001600160a01b038b16935063c04b8d5992506122e591508490600401612c5d565b602060405180830381600087803b1580156122ff57600080fd5b505af1158015612313573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061209a9190612a8e565b6001600160a01b03838116600081815260056020908152604080832054815160c081018352818152808401859052808301959095527f0000000000000000000000000000000000000000000000000000000000000000861660608087019190915260808087018a90528351808601855286815260a0880152835190810184523080825294810186905280840194909452830184905290516352bbbe2960e01b81529294909392908916906352bbbe29906123fb90859085908a904290600401612cb5565b602060405180830381600087803b15801561241557600080fd5b505af1158015612429573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061244d9190612a8e565b98975050505050505050565b6001600160a01b0383811660009081526006602090815260408083208151808301835290546001600160801b03808216808452600160801b909204169382018490529151630b68372160e31b81526004810192909252602482019290925260448101869052606481018590529192909190871690635b41b90890608401602060405180830381600087803b1580156124f057600080fd5b505af1158015612504573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906125289190612a8e565b9695505050505050565b60608315612541575081611e21565b8251156125515782518084602001fd5b8160405162461bcd60e51b81526004016104109190612be6565b8280548282559060005260206000209081019282156125c0579160200282015b828111156125c057825182546001600160a01b0319166001600160a01b0390911617825560209092019160019091019061258b565b506125cc929150612644565b5090565b8280546125dc9061307a565b90600052602060002090601f0160209004810192826125fe57600085556125c0565b82601f106126175782800160ff198235161785556125c0565b828001600101855582156125c0579182015b828111156125c0578235825591602001919060010190612629565b5b808211156125cc5760008155600101612645565b80356001600160801b038116811461267057600080fd5b919050565b60006020828403121561268757600080fd5b8135611e218161323d565b6000602082840312156126a457600080fd5b8151611e218161323d565b600080604083850312156126c257600080fd5b82356126cd8161323d565b915060208301356126dd8161323d565b809150509250929050565b600080604083850312156126fb57600080fd5b82356127068161323d565b915060208301356126dd81613252565b60008060008084860361010081121561272e57600080fd5b85356127398161323d565b945060c0601f198201121561274d57600080fd5b5060208501925060e085013567ffffffffffffffff8082111561276f57600080fd5b818701915087601f83011261278357600080fd5b81358181111561279257600080fd5b8860208285010111156127a457600080fd5b95989497505060200194505050565b600080604083850312156127c657600080fd5b82356127d18161323d565b946020939093013593505050565b600060208083850312156127f257600080fd5b823567ffffffffffffffff81111561280957600080fd5b8301601f8101851361281a57600080fd5b803561282d61282882612e61565b612e30565b80828252848201915084840188868560051b870101111561284d57600080fd5b600094505b838510156128795780356128658161323d565b835260019490940193918501918501612852565b50979650505050505050565b6000602080838503121561289857600080fd5b825167ffffffffffffffff8111156128af57600080fd5b8301601f810185136128c057600080fd5b80516128ce61282882612e61565b80828252848201915084840188868560051b87010111156128ee57600080fd5b600094505b838510156128795780516129068161323d565b8352600194909401939185019185016128f3565b6000602080838503121561292d57600080fd5b825167ffffffffffffffff81111561294457600080fd5b8301601f8101851361295557600080fd5b805161296361282882612e61565b80828252848201915084840188868560051b870101111561298357600080fd5b600094505b83851015612879578051835260019490940193918501918501612988565b6000602082840312156129b857600080fd5b8135611e2181613252565b6000602082840312156129d557600080fd5b8151611e2181613252565b6000602082840312156129f257600080fd5b5035919050565b600060208284031215612a0b57600080fd5b8135611e2181613260565b600060408284031215612a2857600080fd5b6040516040810181811067ffffffffffffffff82111715612a4b57612a4b613112565b604052612a5783612659565b8152612a6560208401612659565b60208201529392505050565b600060208284031215612a8357600080fd5b8135611e218161326d565b600060208284031215612aa057600080fd5b5051919050565b60008060008060808587031215612abd57600080fd5b8451935060208501519250604085015191506060850151612add8161323d565b939692955090935050565b600060208284031215612afa57600080fd5b815160ff81168114611e2157600080fd5b60008151808452612b2381602086016020860161304a565b601f01601f19169290920160200192915050565b60048110612b4757612b476130e6565b9052565b60008251612b5d81846020870161304a565b9190910192915050565b6001600160a01b038a8116825261ffff8a811660208401528916604083015260009061010090612b9a606085018b612b37565b8816608084015260a083018190528201859052610120858782850137600083870182015260c08301949094525090151560e0820152601f909201601f1916909101019695505050505050565b602081526000611e216020830184612b0b565b60208101610e1b8284612b37565b60608101612c158286612b37565b602082019390935260400152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b602081526000825160a06020840152612c7960c0840182612b0b565b905060018060a01b0360208501511660408401526040840151606084015260608401516080840152608084015160a08401528091505092915050565b60e08152845160e08201526000602086015160028110612cd757612cd76130e6565b61010083015260408601516001600160a01b03908116610120840152606087015116610140830152608086015161016083015260a086015160c0610180840152612d256101a0840182612b0b565b915050612d65602083018680516001600160a01b039081168352602080830151151590840152604080830151909116908301526060908101511515910152565b60a082019390935260c0015292915050565b61ffff8781168252861660208201526001600160a01b0385166040820152831515606082015260c08101612dae6080830185612b37565b8260a0830152979650505050505050565b600060a082018783526020878185015260a0604085015281875180845260c086019150828901935060005b81811015612e0f5784516001600160a01b031683529383019391830191600101612dea565b50506001600160a01b03969096166060850152505050608001529392505050565b604051601f8201601f1916810167ffffffffffffffff81118282101715612e5957612e59613112565b604052919050565b600067ffffffffffffffff821115612e7b57612e7b613112565b5060051b60200190565b60008085851115612e9557600080fd5b83861115612ea257600080fd5b5050820193919092039150565b600082612ecc57634e487b7160e01b600052601260045260246000fd5b500490565b600181815b80851115612f0c578160001904821115612ef257612ef26130d0565b80851615612eff57918102915b93841c9390800290612ed6565b509250929050565b6000611e218383600082612f2a57506001610e1b565b81612f3757506000610e1b565b8160018114612f4d5760028114612f5757612f73565b6001915050610e1b565b60ff841115612f6857612f686130d0565b50506001821b610e1b565b5060208310610133831016604e8410600b8410161715612f96575081810a610e1b565b612fa08383612ed1565b8060001904821115612fb457612fb46130d0565b029392505050565b6000816000190483118215151615612fd657612fd66130d0565b500290565b600061ffff83811690831681811015612ff657612ff66130d0565b039392505050565b600082821015613010576130106130d0565b500390565b6bffffffffffffffffffffffff1981358181169160148510156130425780818660140360031b1b83161692505b505092915050565b60005b8381101561306557818101518382015260200161304d565b83811115613074576000848401525b50505050565b600181811c9082168061308e57607f821691505b602082108114156130af57634e487b7160e01b600052602260045260246000fd5b50919050565b60006000198214156130c9576130c96130d0565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b60008135610e1b81613252565b60008135610e1b81613260565b813561314d8161326d565b61ffff8116905081548161ffff198216178355602084013561316e8161326d565b63ffff00008160101b169050808363ffffffff1984161717845560408501356131968161323d565b6001600160c01b0319929092169092179190911760209190911b640100000000600160c01b03161781556131ed6131cf60608401613128565b82805460ff60c01b191691151560c01b60ff60c01b16919091179055565b6132026131fc60808401613135565b82613210565b60a082013560018201555050565b60048210613220576132206130e6565b805460ff60c81b191660c89290921b60ff60c81b16919091179055565b6001600160a01b038116811461172857600080fd5b801515811461172857600080fd5b6004811061172857600080fd5b61ffff8116811461172857600080fdfe7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa264697066735822122083162c271976c91ebc3c0a0e8199fc7a19f20127f4ebdb1a7c35bf3e390a9c0f64736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", + "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061012c5760003560e01c806382aa1c88116100ad578063d38bfff411610071578063d38bfff414610312578063da70696c14610325578063dac4db4e14610345578063e48d7fc514610358578063ee3be5f5146103ac57600080fd5b806382aa1c881461028c578063a994317f146102c1578063b13dc20a146102d4578063b76e83af146102e7578063c7af3352146102fa57600080fd5b8063548f5ae5116100f4578063548f5ae5146101c5578063587c8440146101d85780635d36b1901461024a57806365f6fa94146102525780637cb374bd1461026557600080fd5b80630c340a24146101315780631072cbea146101565780632579153d1461016b5780632dfbe8311461017e578063430bf08a1461019e575b600080fd5b6101396103cf565b6040516001600160a01b0390911681526020015b60405180910390f35b6101696101643660046127b3565b6103ec565b005b610169610179366004612716565b610439565b61019161018c366004612675565b6108c8565b60405161014d9190612be6565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6101696101d3366004612675565b610962565b6102386101e6366004612675565b6000602081905290815260409020805460019091015461ffff80831692620100008104909116916001600160a01b036401000000008304169160ff600160c01b8204811692600160c81b909204169086565b60405161014d96959493929190612d77565b6101696109dd565b6101696102603660046126e8565b610a83565b6101397f000000000000000000000000000000000000000000000000000000000000000081565b6102b37f000000000000000000000000000000000000000000000000000000000000000081565b60405190815260200161014d565b6101696102cf3660046126af565b610b0a565b6101696102e2366004612675565b610b86565b600254610139906001600160a01b031681565b610302610c25565b604051901515815260200161014d565b610169610320366004612675565b610c56565b6102b3610333366004612675565b60056020526000908152604090205481565b6101396103533660046127b3565b610cfa565b61038c610366366004612675565b6006602052600090815260409020546001600160801b0380821691600160801b90041682565b604080516001600160801b0393841681529290911660208301520161014d565b6103026103ba366004612675565b60016020526000908152604090205460ff1681565b60006103e760008051602061327e8339815191525490565b905090565b6103f4610c25565b6104195760405162461bcd60e51b815260040161041090612c26565b60405180910390fd5b6104356104246103cf565b6001600160a01b0384169083610e21565b5050565b610441610c25565b61045d5760405162461bcd60e51b815260040161041090612c26565b6103e861046d6020850185612a71565b61ffff1611156104905760405163faa3445560e01b815260040160405180910390fd5b6103e86104a36040850160208601612a71565b61ffff1611156104c657604051631633c8cd60e31b815260040160405180910390fd5b60006104d86060850160408601612675565b90506001600160a01b03811661050157604051637138356f60e01b815260040160405180910390fd5b6001600160a01b038086166000908152602081905260409020805464010000000090049091169085906105348282613142565b9050507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b15801561059057600080fd5b505afa1580156105a4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105c89190612692565b6040516315d5220f60e31b81526001600160a01b038881166004830152919091169063aea910789060240160206040518083038186803b15801561060b57600080fd5b505afa15801561061f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106439190612a8e565b50856001600160a01b0382161580159061066f5750826001600160a01b0316826001600160a01b031614155b15610689576106896001600160a01b038216836000610e89565b826001600160a01b0316826001600160a01b0316146106cd576106b76001600160a01b038216846000610e89565b6106cd6001600160a01b03821684600019610e89565b60006106df60a08801608089016129f9565b905060008160038111156106f5576106f56130e6565b14156107395761070686868a610fad565b6001600160a01b03891660009081526003602090815260409091208251610733939192919091019061256b565b50610846565b600181600381111561074d5761074d6130e6565b14156107815761075e86868a6110d9565b6001600160a01b038a1660009081526004602052604090206107339290916125d0565b6002816003811115610795576107956130e6565b14156107c5576107a78686868b6111af565b6001600160a01b038916600090815260056020526040902055610846565b60038160038111156107d9576107d96130e6565b141561082b576107eb8686868b611311565b6001600160a01b0389166000908152600660209081526040909120825192909101516001600160801b03908116600160801b029216919091179055610846565b806040516336cb1d2160e01b81526004016104109190612bf9565b7f5eb6073ba3980477f03b1ce0dccba754d48454bbd65a115dcd42db65ca1fefd28861087560208a018a612a71565b61088560408b0160208c01612a71565b84888b8b8e60a001358f60600160208101906108a191906129a6565b6040516108b699989796959493929190612b67565b60405180910390a15050505050505050565b600460205260009081526040902080546108e19061307a565b80601f016020809104026020016040519081016040528092919081815260200182805461090d9061307a565b801561095a5780601f1061092f5761010080835404028352916020019161095a565b820191906000526020600020905b81548152906001019060200180831161093d57829003601f168201915b505050505081565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535805460028114156109c75760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b600282556109d58333611500565b506001905550565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610a785760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610410565b610a8133611667565b565b610a8b610c25565b610aa75760405162461bcd60e51b815260040161041090612c26565b6001600160a01b038216600081815260016020908152604091829020805460ff19168515159081179091558251938452908301527f013ed61add17cbfcbbd95bf8543da67c89658c5477d3f3199a1a2d58ecf1913f910160405180910390a15050565b7f53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac453580546002811415610b6f5760405162461bcd60e51b815260206004820152600e60248201526d1499595b9d1c985b9d0818d85b1b60921b6044820152606401610410565b60028255610b7d8484611500565b50600190555050565b610b8e610c25565b610baa5760405162461bcd60e51b815260040161041090612c26565b6001600160a01b038116610bd157604051637138356f60e01b815260040160405180910390fd5b600280546001600160a01b0319166001600160a01b0383169081179091556040519081527f50f4ca9002119593802480c412cb5e106ae726647a31dcf8a7e7ed4e6794bf5e9060200160405180910390a150565b6000610c3d60008051602061327e8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b610c5e610c25565b610c7a5760405162461bcd60e51b815260040161041090612c26565b610ca2817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b0316610cc260008051602061327e8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b60036020528160005260406000208181548110610d1657600080fd5b6000918252602090912001546001600160a01b03169150829050565b600080826001600160a01b031663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b158015610d6e57600080fd5b505afa158015610d82573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610da69190612ae8565b60ff16905060048110158015610dbd575060128111155b610e1b5760405162461bcd60e51b815260206004820152602960248201527f546f6b656e206d75737420686176652073756666696369656e7420646563696d604482015268616c20706c6163657360b81b6064820152608401610410565b92915050565b6040516001600160a01b038316602482015260448101829052610e8490849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261172b565b505050565b801580610f125750604051636eb1769f60e11b81523060048201526001600160a01b03838116602483015284169063dd62ed3e9060440160206040518083038186803b158015610ed857600080fd5b505afa158015610eec573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f109190612a8e565b155b610f7d5760405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b6064820152608401610410565b6040516001600160a01b038316602482015260448101829052610e8490849063095ea7b360e01b90606401610e4d565b6060610fbb838501856127df565b80519091506002811015610fe2576040516360fa33db60e11b815260040160405180910390fd5b826001600160a01b031682600081518110610fff57610fff6130fc565b60200260200101516001600160a01b0316146110595781600081518110611028576110286130fc565b602002602001015160405163280d94a560e21b815260040161041091906001600160a01b0391909116815260200190565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168261108f600184612ffe565b8151811061109f5761109f6130fc565b60200260200101516001600160a01b0316146110d157816110c1600183612ffe565b81518110611028576110286130fc565b509392505050565b828260006110ea6014828486612e85565b6110f391613015565b60601c90506001600160a01b038416811461112c5760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b8585611139601485612ffe565b611144928290612e85565b61114d91613015565b60601c90506001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001681146111a65760405163280d94a560e21b81526001600160a01b0382166004820152602401610410565b50935093915050565b60006111bd848601866129e0565b9050806111dd57604051634bdc2c9560e01b815260040160405180910390fd5b60405163160bf1c960e31b8152600481018290526001600160a01b03838116602483015284919082169063b05f8e489060440160806040518083038186803b15801561122857600080fd5b505afa15801561123c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112609190612aa7565b505060405163160bf1c960e31b8152600481018590526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000811660248301528416925063b05f8e48915060440160806040518083038186803b1580156112cc57600080fd5b505afa1580156112e0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113049190612aa7565b5050505050949350505050565b604080518082019091526000808252602082015261133184860186612a16565b805160405163c661065760e01b81526001600160801b03909116600482015290915083906001600160a01b0382169063c66106579060240160206040518083038186803b15801561138157600080fd5b505afa158015611395573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b99190612692565b6001600160a01b0316836001600160a01b0316146113f55760405163d658230160e01b81526001600160a01b0384166004820152602401610410565b602082015160405163c661065760e01b81526001600160801b0390911660048201526001600160a01b0382169063c66106579060240160206040518083038186803b15801561144357600080fd5b505afa158015611457573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061147b9190612692565b6001600160a01b03167f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316146114f75760405163d658230160e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166004820152602401610410565b50949350505050565b611509826117fd565b60008290506000816001600160a01b031663f6ca71b06040518163ffffffff1660e01b815260040160006040518083038186803b15801561154957600080fd5b505afa15801561155d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526115859190810190612885565b905060007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663b888879e6040518163ffffffff1660e01b815260040160206040518083038186803b1580156115e257600080fd5b505afa1580156115f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061161a9190612692565b825190915060005b8181101561165e5761164e84828151811061163f5761163f6130fc565b6020026020010151878561189d565b611657816130b5565b9050611622565b50505050505050565b6001600160a01b0381166116bd5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610410565b806001600160a01b03166116dd60008051602061327e8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36117288160008051602061327e83398151915255565b50565b6000611780826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316611e0f9092919063ffffffff16565b805190915015610e84578080602001905181019061179e91906129c3565b610e845760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610410565b6001600160a01b03811660009081526001602052604090205460ff1661184157604051630211444960e11b81526001600160a01b0382166004820152602401610410565b6000819050806001600160a01b0316635a063f636040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561188157600080fd5b505af1158015611895573d6000803e3d6000fd5b505050505050565b6040516370a0823160e01b81523060048201526000906001600160a01b038516906370a082319060240160206040518083038186803b1580156118df57600080fd5b505afa1580156118f3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119179190612a8e565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614156119df5760025461196d906001600160a01b03868116911683610e21565b604080516000808252602082018490528183015290517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316917f42e60aae8f000883c46e2f449fa76268e374ce1b962f46ca9360ab98b18f5799919081900360600190a250505050565b6001600160a01b03808516600090815260208181526040808320815160c081018352815461ffff8082168352620100008204169482019490945264010000000084049095169185019190915260ff600160c01b830481161515606086015292939290916080840191600160c81b909104166003811115611a6157611a616130e6565b6003811115611a7257611a726130e6565b815260200160018201548152505090508060600151611a92575050505050565b81611a9e575050505050565b60a081015115611ab957611ab6828260a00151611e28565b91505b6040516315d5220f60e31b81526001600160a01b0386811660048301526000919085169063aea910789060240160206040518083038186803b158015611afe57600080fd5b505afa158015611b12573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b369190612a8e565b90506000670de0b6b3a7640000612710611ba27f0000000000000000000000000000000000000000000000000000000000000000611b738b610d32565b87518790611b8390612710612fdb565b611b919061ffff168b612fbc565b611b9b9190612fbc565b9190611e3e565b611bac9190612eaf565b611bb69190612eaf565b90506000611bcf846080015185604001518a8886611ea0565b905081811015611bfc576040516302d96fff60e41b81526004810182905260248101839052604401610410565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316886001600160a01b03167fa861903141bc68b536d5048a576afcc645630e1b18a4296ef34cbd4d1407f70986608001518885604051611c6793929190612c07565b60405180910390a36040516370a0823160e01b81523060048201527f0000000000000000000000000000000000000000000000000000000000000000906000906001600160a01b038316906370a082319060240160206040518083038186803b158015611cd357600080fd5b505afa158015611ce7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d0b9190612a8e565b905082811015611d385760405163315d50df60e11b81526004810182905260248101849052604401610410565b6020860151600090611d5290859061ffff16612710611f64565b90506000611d608284612ffe565b600254909150611d7d906001600160a01b03868116911683610e21565b611d916001600160a01b0385168c84610e21565b604080516001600160a01b038d81168252602082018490529181018490527f0000000000000000000000000000000000000000000000000000000000000000909116907f42e60aae8f000883c46e2f449fa76268e374ce1b962f46ca9360ab98b18f57999060600160405180910390a2505050505050505050505050565b6060611e1e8484600085611f7d565b90505b9392505050565b6000818310611e375781611e21565b5090919050565b600081831115611e6e57611e67611e558385612ffe565b611e6090600a612f14565b85906120a5565b9350611e98565b81831015611e9857611e95611e838484612ffe565b611e8e90600a612f14565b85906120b1565b93505b509192915050565b600080866003811115611eb557611eb56130e6565b1415611ece57611ec7858585856120bd565b9050611f5b565b6001866003811115611ee257611ee26130e6565b1415611ef457611ec7858585856121ec565b6002866003811115611f0857611f086130e6565b1415611f1a57611ec785858585612337565b6003866003811115611f2e57611f2e6130e6565b1415611f4057611ec785858585612459565b856040516336cb1d2160e01b81526004016104109190612bf9565b95945050505050565b600080611f7185856120a5565b9050611f5b81846120b1565b606082471015611fde5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610410565b843b61202c5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610410565b600080866001600160a01b031685876040516120489190612b4b565b60006040518083038185875af1925050503d8060008114612085576040519150601f19603f3d011682016040523d82523d6000602084013e61208a565b606091505b509150915061209a828286612532565b979650505050505050565b6000611e218284612fbc565b6000611e218284612eaf565b6001600160a01b03831660009081526003602090815260408083208054825181850281018501909352808352849383018282801561212457602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612106575b505050505090506000866001600160a01b03166338ed173986868530426040518663ffffffff1660e01b8152600401612161959493929190612dbf565b600060405180830381600087803b15801561217b57600080fd5b505af115801561218f573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526121b7919081019061291a565b905080600182516121c89190612ffe565b815181106121d8576121d86130fc565b602002602001015192505050949350505050565b6001600160a01b038316600090815260046020526040812080548291906122129061307a565b80601f016020809104026020016040519081016040528092919081815260200182805461223e9061307a565b801561228b5780601f106122605761010080835404028352916020019161228b565b820191906000526020600020905b81548152906001019060200180831161226e57829003601f168201915b50506040805160a0810182528581523060208201524281830152606081018a905260808101899052905163c04b8d5960e01b8152949550936001600160a01b038b16935063c04b8d5992506122e591508490600401612c5d565b602060405180830381600087803b1580156122ff57600080fd5b505af1158015612313573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061209a9190612a8e565b6001600160a01b03838116600081815260056020908152604080832054815160c081018352818152808401859052808301959095527f0000000000000000000000000000000000000000000000000000000000000000861660608087019190915260808087018a90528351808601855286815260a0880152835190810184523080825294810186905280840194909452830184905290516352bbbe2960e01b81529294909392908916906352bbbe29906123fb90859085908a904290600401612cb5565b602060405180830381600087803b15801561241557600080fd5b505af1158015612429573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061244d9190612a8e565b98975050505050505050565b6001600160a01b0383811660009081526006602090815260408083208151808301835290546001600160801b03808216808452600160801b909204169382018490529151630b68372160e31b81526004810192909252602482019290925260448101869052606481018590529192909190871690635b41b90890608401602060405180830381600087803b1580156124f057600080fd5b505af1158015612504573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906125289190612a8e565b9695505050505050565b60608315612541575081611e21565b8251156125515782518084602001fd5b8160405162461bcd60e51b81526004016104109190612be6565b8280548282559060005260206000209081019282156125c0579160200282015b828111156125c057825182546001600160a01b0319166001600160a01b0390911617825560209092019160019091019061258b565b506125cc929150612644565b5090565b8280546125dc9061307a565b90600052602060002090601f0160209004810192826125fe57600085556125c0565b82601f106126175782800160ff198235161785556125c0565b828001600101855582156125c0579182015b828111156125c0578235825591602001919060010190612629565b5b808211156125cc5760008155600101612645565b80356001600160801b038116811461267057600080fd5b919050565b60006020828403121561268757600080fd5b8135611e218161323d565b6000602082840312156126a457600080fd5b8151611e218161323d565b600080604083850312156126c257600080fd5b82356126cd8161323d565b915060208301356126dd8161323d565b809150509250929050565b600080604083850312156126fb57600080fd5b82356127068161323d565b915060208301356126dd81613252565b60008060008084860361010081121561272e57600080fd5b85356127398161323d565b945060c0601f198201121561274d57600080fd5b5060208501925060e085013567ffffffffffffffff8082111561276f57600080fd5b818701915087601f83011261278357600080fd5b81358181111561279257600080fd5b8860208285010111156127a457600080fd5b95989497505060200194505050565b600080604083850312156127c657600080fd5b82356127d18161323d565b946020939093013593505050565b600060208083850312156127f257600080fd5b823567ffffffffffffffff81111561280957600080fd5b8301601f8101851361281a57600080fd5b803561282d61282882612e61565b612e30565b80828252848201915084840188868560051b870101111561284d57600080fd5b600094505b838510156128795780356128658161323d565b835260019490940193918501918501612852565b50979650505050505050565b6000602080838503121561289857600080fd5b825167ffffffffffffffff8111156128af57600080fd5b8301601f810185136128c057600080fd5b80516128ce61282882612e61565b80828252848201915084840188868560051b87010111156128ee57600080fd5b600094505b838510156128795780516129068161323d565b8352600194909401939185019185016128f3565b6000602080838503121561292d57600080fd5b825167ffffffffffffffff81111561294457600080fd5b8301601f8101851361295557600080fd5b805161296361282882612e61565b80828252848201915084840188868560051b870101111561298357600080fd5b600094505b83851015612879578051835260019490940193918501918501612988565b6000602082840312156129b857600080fd5b8135611e2181613252565b6000602082840312156129d557600080fd5b8151611e2181613252565b6000602082840312156129f257600080fd5b5035919050565b600060208284031215612a0b57600080fd5b8135611e2181613260565b600060408284031215612a2857600080fd5b6040516040810181811067ffffffffffffffff82111715612a4b57612a4b613112565b604052612a5783612659565b8152612a6560208401612659565b60208201529392505050565b600060208284031215612a8357600080fd5b8135611e218161326d565b600060208284031215612aa057600080fd5b5051919050565b60008060008060808587031215612abd57600080fd5b8451935060208501519250604085015191506060850151612add8161323d565b939692955090935050565b600060208284031215612afa57600080fd5b815160ff81168114611e2157600080fd5b60008151808452612b2381602086016020860161304a565b601f01601f19169290920160200192915050565b60048110612b4757612b476130e6565b9052565b60008251612b5d81846020870161304a565b9190910192915050565b6001600160a01b038a8116825261ffff8a811660208401528916604083015260009061010090612b9a606085018b612b37565b8816608084015260a083018190528201859052610120858782850137600083870182015260c08301949094525090151560e0820152601f909201601f1916909101019695505050505050565b602081526000611e216020830184612b0b565b60208101610e1b8284612b37565b60608101612c158286612b37565b602082019390935260400152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b602081526000825160a06020840152612c7960c0840182612b0b565b905060018060a01b0360208501511660408401526040840151606084015260608401516080840152608084015160a08401528091505092915050565b60e08152845160e08201526000602086015160028110612cd757612cd76130e6565b61010083015260408601516001600160a01b03908116610120840152606087015116610140830152608086015161016083015260a086015160c0610180840152612d256101a0840182612b0b565b915050612d65602083018680516001600160a01b039081168352602080830151151590840152604080830151909116908301526060908101511515910152565b60a082019390935260c0015292915050565b61ffff8781168252861660208201526001600160a01b0385166040820152831515606082015260c08101612dae6080830185612b37565b8260a0830152979650505050505050565b600060a082018783526020878185015260a0604085015281875180845260c086019150828901935060005b81811015612e0f5784516001600160a01b031683529383019391830191600101612dea565b50506001600160a01b03969096166060850152505050608001529392505050565b604051601f8201601f1916810167ffffffffffffffff81118282101715612e5957612e59613112565b604052919050565b600067ffffffffffffffff821115612e7b57612e7b613112565b5060051b60200190565b60008085851115612e9557600080fd5b83861115612ea257600080fd5b5050820193919092039150565b600082612ecc57634e487b7160e01b600052601260045260246000fd5b500490565b600181815b80851115612f0c578160001904821115612ef257612ef26130d0565b80851615612eff57918102915b93841c9390800290612ed6565b509250929050565b6000611e218383600082612f2a57506001610e1b565b81612f3757506000610e1b565b8160018114612f4d5760028114612f5757612f73565b6001915050610e1b565b60ff841115612f6857612f686130d0565b50506001821b610e1b565b5060208310610133831016604e8410600b8410161715612f96575081810a610e1b565b612fa08383612ed1565b8060001904821115612fb457612fb46130d0565b029392505050565b6000816000190483118215151615612fd657612fd66130d0565b500290565b600061ffff83811690831681811015612ff657612ff66130d0565b039392505050565b600082821015613010576130106130d0565b500390565b6bffffffffffffffffffffffff1981358181169160148510156130425780818660140360031b1b83161692505b505092915050565b60005b8381101561306557818101518382015260200161304d565b83811115613074576000848401525b50505050565b600181811c9082168061308e57607f821691505b602082108114156130af57634e487b7160e01b600052602260045260246000fd5b50919050565b60006000198214156130c9576130c96130d0565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b60008135610e1b81613252565b60008135610e1b81613260565b813561314d8161326d565b61ffff8116905081548161ffff198216178355602084013561316e8161326d565b63ffff00008160101b169050808363ffffffff1984161717845560408501356131968161323d565b6001600160c01b0319929092169092179190911760209190911b640100000000600160c01b03161781556131ed6131cf60608401613128565b82805460ff60c01b191691151560c01b60ff60c01b16919091179055565b6132026131fc60808401613135565b82613210565b60a082013560018201555050565b60048210613220576132206130e6565b805460ff60c81b191660c89290921b60ff60c81b16919091179055565b6001600160a01b038116811461172857600080fd5b801515811461172857600080fd5b6004811061172857600080fd5b61ffff8116811461172857600080fdfe7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa264697066735822122083162c271976c91ebc3c0a0e8199fc7a19f20127f4ebdb1a7c35bf3e390a9c0f64736f6c63430008070033", "libraries": {}, "devdoc": { "kind": "dev", diff --git a/contracts/scripts/deploy/verifySimpleOETHDeployment.sh b/contracts/scripts/deploy/verifySimpleOETHDeployment.sh old mode 100644 new mode 100755 index 1dbdc7bc0c..7fc14add36 --- a/contracts/scripts/deploy/verifySimpleOETHDeployment.sh +++ b/contracts/scripts/deploy/verifySimpleOETHDeployment.sh @@ -10,10 +10,10 @@ export FEE_ACC=0x79681d3f14a0068479420eE5fDdF59B62301f810 export FEE_ACC_PROXY=0x590B781b511e953dbFC49e7E7864A6E787aFBDCc export OETH_DRIPPER=0x3833C32826A7f2a93C48D50ae44D45F45Ab17B7F export OETH_DRIPPER_PROXY=0xaFF1E6263F4004C95Ae611DEb2ADaC049B5aD121 -export OETH_HARVESTER=0x22b00a89531E199bd90eC162F9810298b9FBC8b3 +export OETH_HARVESTER=0xBd09F938259AE61e089959d52580235b76C69A83 export OETH_HARVESTER_PROXY=0xB7491cdf36367C89001cc41312F22f63A3a17931 export OETH_ORACLE_ROUTER=0x7e2bf9A89180f20591EcFA42C0dd7e52b2C546E3 -export NATIVE_STAKING=0x33Eeb0996f6981ff7d11F643630734856BEc09f5 +export NATIVE_STAKING=0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793 export NATIVE_STAKING_PROXY=0x4Eac8847c7AE50e3A3551B1Aa4FF7Cc162151410 export WETH=0x94373a4919b3240d86ea41593d5eba789fef3848 export ZERO=0x0000000000000000000000000000000000000000 From 476947f6e8b2ec3b454ed576c21e4d341eaaab5c Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Fri, 3 May 2024 21:48:01 +0200 Subject: [PATCH 25/30] upgrade harvester as well --- contracts/deploy/deployActions.js | 27 +++++++++++++++++++ .../deploy/holesky/004_upgrade_strategy.js | 4 +-- .../deployments/holesky/.migrations.json | 3 ++- contracts/test/behaviour/ssvStrategy.js | 2 +- 4 files changed, 32 insertions(+), 4 deletions(-) diff --git a/contracts/deploy/deployActions.js b/contracts/deploy/deployActions.js index 3338964c53..0bb98d5a93 100644 --- a/contracts/deploy/deployActions.js +++ b/contracts/deploy/deployActions.js @@ -543,6 +543,32 @@ const deployOUSDHarvester = async (ousdDripper) => { return dHarvesterProxy; }; +const upgradeOETHHarvester = async () => { + const assetAddresses = await getAssetAddresses(deployments); + const { governorAddr } = await getNamedAccounts(); + const sGovernor = await ethers.provider.getSigner(governorAddr); + const cOETHVaultProxy = await ethers.getContract("OETHVaultProxy"); + const cOETHHarvesterProxy = await ethers.getContract("OETHHarvesterProxy"); + + const dOETHHarvester = await deployWithConfirmation("OETHHarvester", [ + cOETHVaultProxy.address, + assetAddresses.WETH, + ]); + + const cOETHHarvester = await ethers.getContractAt( + "OETHHarvester", + cOETHHarvesterProxy.address + ); + + await withConfirmation( + cOETHHarvesterProxy + .upgradeTo(cOETHHarvester.address) + ); + + log("Upgraded OETHHarvesterProxy"); + return cOETHHarvesterProxy; +}; + const deployOETHHarvester = async (oethDripper) => { const assetAddresses = await getAssetAddresses(deployments); const { governorAddr } = await getNamedAccounts(); @@ -1508,6 +1534,7 @@ module.exports = { deployHarvesters, deployOETHHarvester, deployOUSDHarvester, + upgradeOETHHarvester, configureVault, configureOETHVault, configureStrategies, diff --git a/contracts/deploy/holesky/004_upgrade_strategy.js b/contracts/deploy/holesky/004_upgrade_strategy.js index 5e32f4c7ea..17b8310002 100644 --- a/contracts/deploy/holesky/004_upgrade_strategy.js +++ b/contracts/deploy/holesky/004_upgrade_strategy.js @@ -1,4 +1,4 @@ -const { upgradeNativeStakingSSVStrategy, deployOETHHarvester } = require("../deployActions"); +const { upgradeNativeStakingSSVStrategy, upgradeOETHHarvester } = require("../deployActions"); const mainExport = async () => { console.log("Running 004 deployment on Holesky..."); @@ -8,7 +8,7 @@ const mainExport = async () => { console.log("deploying harvester") const cOETHDripperProxy = await ethers.getContract("OETHDripperProxy"); - const cOETHHarvester = await deployOETHHarvester(cOETHDripperProxy.address); + const cOETHHarvester = await upgradeOETHHarvester(cOETHDripperProxy.address); console.log("Running 004 deployment done"); return true; }; diff --git a/contracts/deployments/holesky/.migrations.json b/contracts/deployments/holesky/.migrations.json index d45ad24364..2f28d11520 100644 --- a/contracts/deployments/holesky/.migrations.json +++ b/contracts/deployments/holesky/.migrations.json @@ -1,5 +1,6 @@ { "001_core": 1714168010, "002_upgrade_strategy": 1714233842, - "003_deposit_to_native_strategy": 1714307581 + "003_deposit_to_native_strategy": 1714307581, + "004_upgrade_strategy": 1714765217 } \ No newline at end of file diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js index 9424fc03b7..2ec9d794f9 100644 --- a/contracts/test/behaviour/ssvStrategy.js +++ b/contracts/test/behaviour/ssvStrategy.js @@ -181,7 +181,7 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { ); }); - it.only("Should exit and remove validator by validator registrator", async () => { + it("Should exit and remove validator by validator registrator", async () => { const { nativeStakingSSVStrategy, ssvNetwork, From 75b267ac99a8ea80867d82a75580a976b0d97eb5 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Sun, 5 May 2024 22:39:48 +0200 Subject: [PATCH 26/30] fix test --- contracts/deploy/deployActions.js | 5 +---- contracts/deploy/holesky/004_upgrade_strategy.js | 7 +++++-- contracts/test/behaviour/ssvStrategy.js | 8 ++++---- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/contracts/deploy/deployActions.js b/contracts/deploy/deployActions.js index 0bb98d5a93..827f6fcedf 100644 --- a/contracts/deploy/deployActions.js +++ b/contracts/deploy/deployActions.js @@ -560,10 +560,7 @@ const upgradeOETHHarvester = async () => { cOETHHarvesterProxy.address ); - await withConfirmation( - cOETHHarvesterProxy - .upgradeTo(cOETHHarvester.address) - ); + await withConfirmation(cOETHHarvesterProxy.upgradeTo(cOETHHarvester.address)); log("Upgraded OETHHarvesterProxy"); return cOETHHarvesterProxy; diff --git a/contracts/deploy/holesky/004_upgrade_strategy.js b/contracts/deploy/holesky/004_upgrade_strategy.js index 17b8310002..85fa2a0a2d 100644 --- a/contracts/deploy/holesky/004_upgrade_strategy.js +++ b/contracts/deploy/holesky/004_upgrade_strategy.js @@ -1,4 +1,7 @@ -const { upgradeNativeStakingSSVStrategy, upgradeOETHHarvester } = require("../deployActions"); +const { + upgradeNativeStakingSSVStrategy, + upgradeOETHHarvester, +} = require("../deployActions"); const mainExport = async () => { console.log("Running 004 deployment on Holesky..."); @@ -6,7 +9,7 @@ const mainExport = async () => { console.log("Upgrading native staking strategy"); await upgradeNativeStakingSSVStrategy(); - console.log("deploying harvester") + console.log("deploying harvester"); const cOETHDripperProxy = await ethers.getContract("OETHDripperProxy"); const cOETHHarvester = await upgradeOETHHarvester(cOETHDripperProxy.address); console.log("Running 004 deployment done"); diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js index 2ec9d794f9..21670bb0fd 100644 --- a/contracts/test/behaviour/ssvStrategy.js +++ b/contracts/test/behaviour/ssvStrategy.js @@ -210,8 +210,11 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { cluster ); const regReceipt = await regTx.wait(); + const ValidatorAddedRawEvent = regReceipt.events.find( + (e) => e.address.toLowerCase() == ssvNetwork.address.toLowerCase() + ); const ValidatorAddedEvent = ssvNetwork.interface.parseLog( - regReceipt.events[2] + ValidatorAddedRawEvent ); const { cluster: newCluster } = ValidatorAddedEvent.args; @@ -224,18 +227,15 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { }, ]); - console.log("HEre!") // exit validator from SSV network const exitTx = await nativeStakingSSVStrategy .connect(validatorRegistrator) .exitSsvValidator(testValidator.publicKey, testValidator.operatorIds); - console.log("HEre! 1") await expect(exitTx) .to.emit(nativeStakingSSVStrategy, "SSVValidatorExitInitiated") .withArgs(testValidator.publicKey, testValidator.operatorIds); - console.log("HEre! 2") const removeTx = await nativeStakingSSVStrategy .connect(validatorRegistrator) .removeSsvValidator( From d12957a1cf719cf9c56a8170babbae521f8f43b2 Mon Sep 17 00:00:00 2001 From: Domen Grabec Date: Mon, 6 May 2024 00:06:57 +0200 Subject: [PATCH 27/30] fix upgrade script and correct the bug in deploy actions --- contracts/deploy/deployActions.js | 7 +---- .../deploy/holesky/004_upgrade_strategy.js | 17 ++++++++++ .../deployments/holesky/.migrations.json | 2 +- contracts/test/_fixture.js | 2 -- contracts/test/behaviour/ssvStrategy.js | 31 ++++++++++++++----- 5 files changed, 43 insertions(+), 16 deletions(-) diff --git a/contracts/deploy/deployActions.js b/contracts/deploy/deployActions.js index 827f6fcedf..58e25e0458 100644 --- a/contracts/deploy/deployActions.js +++ b/contracts/deploy/deployActions.js @@ -555,12 +555,7 @@ const upgradeOETHHarvester = async () => { assetAddresses.WETH, ]); - const cOETHHarvester = await ethers.getContractAt( - "OETHHarvester", - cOETHHarvesterProxy.address - ); - - await withConfirmation(cOETHHarvesterProxy.upgradeTo(cOETHHarvester.address)); + await withConfirmation(cOETHHarvesterProxy.upgradeTo(dOETHHarvester.address)); log("Upgraded OETHHarvesterProxy"); return cOETHHarvesterProxy; diff --git a/contracts/deploy/holesky/004_upgrade_strategy.js b/contracts/deploy/holesky/004_upgrade_strategy.js index 85fa2a0a2d..2636023947 100644 --- a/contracts/deploy/holesky/004_upgrade_strategy.js +++ b/contracts/deploy/holesky/004_upgrade_strategy.js @@ -2,6 +2,7 @@ const { upgradeNativeStakingSSVStrategy, upgradeOETHHarvester, } = require("../deployActions"); +const { withConfirmation } = require("../../utils/deploy"); const mainExport = async () => { console.log("Running 004 deployment on Holesky..."); @@ -12,6 +13,22 @@ const mainExport = async () => { console.log("deploying harvester"); const cOETHDripperProxy = await ethers.getContract("OETHDripperProxy"); const cOETHHarvester = await upgradeOETHHarvester(cOETHDripperProxy.address); + + const strategyProxy = await ethers.getContract( + "NativeStakingSSVStrategyProxy" + ); + const cStrategy = await ethers.getContractAt( + "NativeStakingSSVStrategy", + strategyProxy.address + ); + + console.log("configuring harvester and the strategy"); + await withConfirmation( + cOETHHarvester.setSupportedStrategy(strategyProxy.address, true) + ); + + await withConfirmation(cStrategy.setHarvesterAddress(cOETHHarvester.address)); + console.log("Running 004 deployment done"); return true; }; diff --git a/contracts/deployments/holesky/.migrations.json b/contracts/deployments/holesky/.migrations.json index 2f28d11520..82623a51d5 100644 --- a/contracts/deployments/holesky/.migrations.json +++ b/contracts/deployments/holesky/.migrations.json @@ -2,5 +2,5 @@ "001_core": 1714168010, "002_upgrade_strategy": 1714233842, "003_deposit_to_native_strategy": 1714307581, - "004_upgrade_strategy": 1714765217 + "004_upgrade_strategy": 1714944723 } \ No newline at end of file diff --git a/contracts/test/_fixture.js b/contracts/test/_fixture.js index 184fce0ebc..0d485012cd 100644 --- a/contracts/test/_fixture.js +++ b/contracts/test/_fixture.js @@ -98,8 +98,6 @@ const simpleOETHFixture = deployments.createFixture(async () => { addressContext = addresses.holesky; } - console.log("addressContext.WETH", addressContext.WETH); - weth = await ethers.getContractAt("IWETH9", addressContext.WETH); ssv = await ethers.getContractAt(erc20Abi, addressContext.SSV); diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js index 21670bb0fd..4ec1dd8070 100644 --- a/contracts/test/behaviour/ssvStrategy.js +++ b/contracts/test/behaviour/ssvStrategy.js @@ -9,21 +9,37 @@ const { oethUnits } = require("../helpers"); const addresses = require("../../utils/addresses"); const { impersonateAndFund } = require("../../utils/signers"); const { getClusterInfo } = require("../../utils/ssv"); - -const { - createFixtureLoader, - nativeStakingSSVStrategyFixture, -} = require("./../_fixture"); const { parseEther } = require("ethers/lib/utils"); -const loadFixture = createFixtureLoader(nativeStakingSSVStrategyFixture); - /** * * @param {*} context a function that returns a fixture with the additional properties: * @example shouldBehaveLikeAnSsvStrategy(() => ({ ...fixture, + addresses: [addresses.holesky|addresses.mainnet], + validatorRegistrator: await impersonateAndFund( + addresses.holesky.validatorRegistrator + ), + ssvNetwork: await ethers.getContractAt( + "ISSVNetwork", + addresses.holesky.SSVNetwork + ), + nativeStakingFeeAccumulator: await ethers.getContractAt( + "FeeAccumulator", + await fixture.nativeStakingSSVStrategy.FEE_ACCUMULATOR_ADDRESS() + ), + testValidator: { + publicKey: + "0xb279166b18ca9ced3e0a83385799ae33b27c6cd2ad2083b9b7c33c555d091933a09b1af9fb65c6c4d51c40ca931447a9", + operatorIds: [111, 119, 230, 252], + sharesData: + "0xb1edfddfdf70c8c56cfba3f00ae09815db2383c4faa328733df73dd4616492a58648d543642078c72e2bad60a22322d70ea44cc953c05aa0404681fb57498daa9cbd5c8cc98f736c75a8bf908f0eb98d6448b6778f35b1ce724fee8a1bb53f9ab60f29c5fc7c53e1577a27581b8aff689ac2fdeda72e9620f6991edb7779acef68ed2e6ea4ccfaecd00ccac09b7ed8b7abc72ea5c5469e1b5603c73fe3d054e074c88446c4e31abbc34ee309022524da5aacecb4aa83bf0ac658931813a402e4a4b1d9f83d54404b730e04e61dc82e872fa397e3a9ea249715c861ef0d4b309fdba762cd07f0506925a7a4e3e52d2c0e8f07ae01b8bb393df14c17648340c55e3a82564efb943de4033308d197d562c8bf377a589c87e4c7757afe5964ec92a616622138797c4a647dda550e3b94e3a6152cdda20d4a7b491218ab7df46a2eb9c3963811bf0555b272bf4ef5a8c0c2496e133d1cc34b01c7a5cb40d379e607d0bd7f0d8fcb965ab8d5c7634d80dbd3fac67227b53ec6fbd1a5207bfea8cb202ac88fef732328a2b717b6284af9f34a251e5ecf5eb744a4cf4df35abb423ca02556df957cd8bc645b83d497235b92f310996748c54a89106937cfcf182744ad423b104ca0a61a351d15aa9ae98093f64de31e14a7203304021ebbe2ee0e3f91e1641ff7da84396a83643101cfe67640c05467ffa8de458ebb4db0fcffe9210b72c50f8835cb636e1f5e7356092f15b29fb11761ce36a6601d599eb02d82aa02ce300a7e6c538ca72133036e5f3634c29b27c66964f65086e3f725d535f5e7d92f6a0b589a71caa7d0ca572c5192fe6ef5a4b44ad05cbb8c214a444a399b035263a1d2853bfe43b457873e700be599d3ff03532df1f52be09f6607acfc466f8bb4c4d98d74908c7394d516b738a6143a5456dc43a45f1f00a6515e11b5efc6f4dabfb3d967941ac159a8b6f7c464760c4770082b1d97600cabb1dc286d20c321e6bcb36138507915c399d8639d8a66143bff1f5a6d6cb63d0a8b560134dab42e9d23100c05e51104e068c0c76ecb5382d04e34375efea6467dfb096f6dc12b67609ea1d8310044ab8e80f75341b4aa3eb8dd5f465a3dc6b3f1dea8f25c77cdc34f0eb04247c1ac73bde467c8048cc4d57afefcb33de7520048baeaa9401fc175061881d5c60c89a4fe71cf6af8ed7ba3f6b5da42ef2ee5454f422ecf0b02d09f1ba77d35b56240232237810ffe4ff8e49c4a40a9aab7880ea91472440f30b22797f97d90a68e7904513a4267af47d988d96a17c5a2e90c4ad7c6fb56de8ba7e5488cfc16d1015963e2778e2b3def5ffdda1439cf8750b5823e31f4ba59f1eaf17c7ee98a69495a3c38c177175554b343c21f91a708c6313f146bbdde18b1fcead4e0d0274c8c1010c96f79b81060b850ab5c1da001fc908e45b84d57837fbbd272a4349261e500ce56560939cba45a58f2d0bdba3c6631e52d4e0b7a29ea50f14ed36c1ccb5fca6fdc45f881764b3ee39949ef5df255d9afdedfdf390409dadd31df7540d25174cf21a33dce1a2fd6097967be67267aa7e9353db71821bd89db0b3887eebc01cb64a4116edefac323fdde618a34d91545bab38f920e8e6f38b22a3a243b261fd56f0ec1ff6187b3ed42ddeeadf2c7a78c154d44ab332e293ca2b03e77ae1fe628378e336bc73149df4d7cbc86df73d04b9d35a9fe6a87a865f92337a8df10d5a5cf4dcc6cfba73bdd9b13d3b671acfc829b87f869ed42a48ced74099f92ac79721a79ac93d7c4d5e9be780fe1a78f807fd6a222fac05c3c8b9cd4182cb84617abaa72815b5dceec1d58b1278bf90498e4be3a456428866170046c", + signature: + "0xa450d596551c7fb7aca201e9a075b034d8da1ec7bf8806740ca53c0e8653465ed9cd26d6ce10290581586676eb0dd896022a243dc42179337c9c4c2a60969a11bb9e4a2dcf57a783daf880999f6db34d1e42163cb96287b3bb91b03361942b80", + depositDataRoot: + "0x3f327f69bb527386ff4c2f820e6e375fcc632b1b7ee826bd53d4d2807cfd6769", + }, })); */ @@ -384,6 +400,7 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { const consensusRewards = parseEther("5"); await setBalance(nativeStakingSSVStrategy.address, consensusRewards); // account for the consensus rewards + await nativeStakingSSVStrategy .connect(validatorRegistrator) .doAccounting(); From 2969a4f30c3d1d92d5decb7712e4de721971a59c Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Mon, 6 May 2024 22:44:14 +1000 Subject: [PATCH 28/30] Deployed new Native Staking strategy including the proxy --- contracts/deploy/deployActions.js | 16 ++--- contracts/deploy/holesky/005_new_harvester.js | 61 +++++++++++++++++++ .../deployments/holesky/.migrations.json | 3 +- .../deployments/holesky/FeeAccumulator.json | 34 +++++------ .../NativeStakingFeeAccumulatorProxy.json | 32 +++++----- .../holesky/NativeStakingSSVStrategy.json | 34 +++++------ .../NativeStakingSSVStrategyProxy.json | 32 +++++----- .../5e7101910c63b5cb160cf1f36fa86058.json | 44 +++++++++++++ contracts/test/behaviour/ssvStrategy.js | 4 +- contracts/test/helpers.js | 7 ++- contracts/utils/resolvers.js | 12 ++-- contracts/utils/signers.js | 2 +- 12 files changed, 194 insertions(+), 87 deletions(-) create mode 100644 contracts/deploy/holesky/005_new_harvester.js create mode 100644 contracts/deployments/holesky/solcInputs/5e7101910c63b5cb160cf1f36fa86058.json diff --git a/contracts/deploy/deployActions.js b/contracts/deploy/deployActions.js index 58e25e0458..625f4c1840 100644 --- a/contracts/deploy/deployActions.js +++ b/contracts/deploy/deployActions.js @@ -545,8 +545,6 @@ const deployOUSDHarvester = async (ousdDripper) => { const upgradeOETHHarvester = async () => { const assetAddresses = await getAssetAddresses(deployments); - const { governorAddr } = await getNamedAccounts(); - const sGovernor = await ethers.provider.getSigner(governorAddr); const cOETHVaultProxy = await ethers.getContract("OETHVaultProxy"); const cOETHHarvesterProxy = await ethers.getContract("OETHHarvesterProxy"); @@ -585,11 +583,13 @@ const deployOETHHarvester = async (oethDripper) => { ); await withConfirmation( - cOETHHarvesterProxy["initialize(address,address,bytes)"]( - dOETHHarvester.address, - governorAddr, - [] - ) + // prettier-ignore + cOETHHarvesterProxy + .connect(sGovernor)["initialize(address,address,bytes)"]( + dOETHHarvester.address, + governorAddr, + [] + ) ); log("Initialized OETHHarvesterProxy"); @@ -602,7 +602,7 @@ const deployOETHHarvester = async (oethDripper) => { ) ); - return dOETHHarvesterProxy; + return cOETHHarvester; }; /** diff --git a/contracts/deploy/holesky/005_new_harvester.js b/contracts/deploy/holesky/005_new_harvester.js new file mode 100644 index 0000000000..0793c46ec2 --- /dev/null +++ b/contracts/deploy/holesky/005_new_harvester.js @@ -0,0 +1,61 @@ +const { parseEther } = require("ethers/lib/utils"); + +const { deployNativeStakingSSVStrategy } = require("../deployActions"); +const { withConfirmation } = require("../../utils/deploy"); +const { resolveContract } = require("../../utils/resolvers"); + +const mainExport = async () => { + console.log("Running 005 deployment on Holesky..."); + + console.log("Deploying a new Native Staking strategy and proxy"); + + console.log("Deploying Native Staking"); + const nativeStakingSSVStrategy = await deployNativeStakingSSVStrategy(); + + const { governorAddr } = await getNamedAccounts(); + const sGovernor = await ethers.provider.getSigner(governorAddr); + + const cOETHHarvester = await resolveContract( + "OETHHarvesterProxy", + "OETHHarvester" + ); + const cVault = await resolveContract("OETHVaultProxy", "VaultAdmin"); + + await withConfirmation( + nativeStakingSSVStrategy + .connect(sGovernor) + .setHarvesterAddress(cOETHHarvester.address) + ); + + console.log("configuring harvester and the strategy"); + await withConfirmation( + cOETHHarvester + .connect(sGovernor) + .setSupportedStrategy(nativeStakingSSVStrategy.address, true) + ); + + await withConfirmation( + cVault.connect(sGovernor).approveStrategy(nativeStakingSSVStrategy.address) + ); + + await withConfirmation( + nativeStakingSSVStrategy.connect(sGovernor).setRegistrator(governorAddr) + ); + + const fuseStartBn = parseEther("21.6"); + const fuseEndBn = parseEther("25.6"); + + await nativeStakingSSVStrategy + .connect(sGovernor) + .setFuseInterval(fuseStartBn, fuseEndBn); + + console.log("Running 005 deployment done"); + return true; +}; + +mainExport.id = "005_deploy_new_harvester"; +mainExport.tags = []; +mainExport.dependencies = []; +mainExport.skip = () => false; + +module.exports = mainExport; diff --git a/contracts/deployments/holesky/.migrations.json b/contracts/deployments/holesky/.migrations.json index 82623a51d5..7e8f3cdbad 100644 --- a/contracts/deployments/holesky/.migrations.json +++ b/contracts/deployments/holesky/.migrations.json @@ -2,5 +2,6 @@ "001_core": 1714168010, "002_upgrade_strategy": 1714233842, "003_deposit_to_native_strategy": 1714307581, - "004_upgrade_strategy": 1714944723 + "004_upgrade_strategy": 1714944723, + "005_deploy_new_harvester": 1714998707 } \ No newline at end of file diff --git a/contracts/deployments/holesky/FeeAccumulator.json b/contracts/deployments/holesky/FeeAccumulator.json index 863cc1ba96..dbee10dcb3 100644 --- a/contracts/deployments/holesky/FeeAccumulator.json +++ b/contracts/deployments/holesky/FeeAccumulator.json @@ -1,5 +1,5 @@ { - "address": "0x79681d3f14a0068479420eE5fDdF59B62301f810", + "address": "0xa3f54f30cDefaBd9527FF11ad51Ba20c3b77ffDD", "abi": [ { "inputs": [ @@ -123,42 +123,42 @@ "type": "function" } ], - "transactionHash": "0x19762cf6f04f946ee9af7a2b33ef576781afc364bf031afe6319b03d0c531a6d", + "transactionHash": "0xa7a9c1f0210822c01adc6baec616c8b15880fa006bfb44e2fd11e8eed5c4d79e", "receipt": { "to": null, "from": "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C", - "contractAddress": "0x79681d3f14a0068479420eE5fDdF59B62301f810", - "transactionIndex": 63, + "contractAddress": "0xa3f54f30cDefaBd9527FF11ad51Ba20c3b77ffDD", + "transactionIndex": 41, "gasUsed": "405585", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000008000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000080000000000000000", - "blockHash": "0xc40d7f3894c751ce39361b41360973e012fccc0bcc8770bcbb6a926d9474a899", - "transactionHash": "0x19762cf6f04f946ee9af7a2b33ef576781afc364bf031afe6319b03d0c531a6d", + "logsBloom": "0x00000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000100002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", + "blockHash": "0xeb75a4f4e090ead69abb76fa8002957b1d721ef4121f27dd6b32b784c7ac347c", + "transactionHash": "0xa7a9c1f0210822c01adc6baec616c8b15880fa006bfb44e2fd11e8eed5c4d79e", "logs": [ { - "transactionIndex": 63, - "blockNumber": 1405126, - "transactionHash": "0x19762cf6f04f946ee9af7a2b33ef576781afc364bf031afe6319b03d0c531a6d", - "address": "0x79681d3f14a0068479420eE5fDdF59B62301f810", + "transactionIndex": 41, + "blockNumber": 1489385, + "transactionHash": "0xa7a9c1f0210822c01adc6baec616c8b15880fa006bfb44e2fd11e8eed5c4d79e", + "address": "0xa3f54f30cDefaBd9527FF11ad51Ba20c3b77ffDD", "topics": [ "0xc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000001b94ca50d3ad9f8368851f8526132272d1a5028c" ], "data": "0x", - "logIndex": 69, - "blockHash": "0xc40d7f3894c751ce39361b41360973e012fccc0bcc8770bcbb6a926d9474a899" + "logIndex": 567, + "blockHash": "0xeb75a4f4e090ead69abb76fa8002957b1d721ef4121f27dd6b32b784c7ac347c" } ], - "blockNumber": 1405126, - "cumulativeGasUsed": "7055269", + "blockNumber": 1489385, + "cumulativeGasUsed": "21569388", "status": 1, "byzantium": true }, "args": [ - "0x4Eac8847c7AE50e3A3551B1Aa4FF7Cc162151410" + "0xcf4a9e80Ddb173cc17128A361B98B9A140e3932E" ], "numDeployments": 1, - "solcInputHash": "0213c8dc30149ba5fb281c6d46803d0b", + "solcInputHash": "66dbdc9fbde8f1c7cc59f29d272eb661", "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_strategy\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"STRATEGY\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"collect\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"eth\",\"type\":\"uint256\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Origin Protocol Inc\",\"kind\":\"dev\",\"methods\":{\"collect()\":{\"returns\":{\"eth\":\"The amount of execution rewards that were sent to the Native Staking Strategy\"}},\"constructor\":{\"params\":{\"_strategy\":\"Address of the Native Staking Strategy\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}}},\"title\":\"Fee Accumulator for Native Staking SSV Strategy\",\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"STRATEGY()\":{\"notice\":\"The address of the Native Staking Strategy\"},\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"collect()\":{\"notice\":\"sends all ETH in this FeeAccumulator contract to the Native Staking Strategy.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"}},\"notice\":\"Receives execution rewards which includes tx fees and MEV rewards like tx priority and tx ordering. It does NOT include swept ETH from beacon chain consensus rewards or full validator withdrawals.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/strategies/NativeStaking/FeeAccumulator.sol\":\"FeeAccumulator\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/FeeAccumulator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\n\\n/**\\n * @title Fee Accumulator for Native Staking SSV Strategy\\n * @notice Receives execution rewards which includes tx fees and\\n * MEV rewards like tx priority and tx ordering.\\n * It does NOT include swept ETH from beacon chain consensus rewards or full validator withdrawals.\\n * @author Origin Protocol Inc\\n */\\ncontract FeeAccumulator is Governable {\\n /// @notice The address of the Native Staking Strategy\\n address public immutable STRATEGY;\\n\\n /**\\n * @param _strategy Address of the Native Staking Strategy\\n */\\n constructor(address _strategy) {\\n STRATEGY = _strategy;\\n }\\n\\n /**\\n * @notice sends all ETH in this FeeAccumulator contract to the Native Staking Strategy.\\n * @return eth The amount of execution rewards that were sent to the Native Staking Strategy\\n */\\n function collect() external returns (uint256 eth) {\\n require(msg.sender == STRATEGY, \\\"Caller is not the Strategy\\\");\\n\\n eth = address(this).balance;\\n if (eth > 0) {\\n // Send the ETH to the Native Staking Strategy\\n Address.sendValue(payable(STRATEGY), eth);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xf47bcc46ce70f649f061bec3d2303f376a15700ba18fe471fba823f60bdfed8b\",\"license\":\"MIT\"}},\"version\":1}", "bytecode": "0x60a060405234801561001057600080fd5b506040516106fe3803806106fe83398101604081905261002f916100a1565b610045336000805160206106de83398151915255565b6000805160206106de833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a360601b6001600160601b0319166080526100d1565b6000602082840312156100b357600080fd5b81516001600160a01b03811681146100ca57600080fd5b9392505050565b60805160601c6105e26100fc600039600081816091015281816102d8015261035201526105e26000f3fe608060405234801561001057600080fd5b50600436106100625760003560e01c80630c340a2414610067578063185025ef1461008c5780635d36b190146100b3578063c7af3352146100bd578063d38bfff4146100d5578063e5225381146100e8575b600080fd5b61006f6100fe565b6040516001600160a01b0390911681526020015b60405180910390f35b61006f7f000000000000000000000000000000000000000000000000000000000000000081565b6100bb61011b565b005b6100c56101c6565b6040519015158152602001610083565b6100bb6100e336600461055c565b6101f7565b6100f06102cb565b604051908152602001610083565b600061011660008051602061058d8339815191525490565b905090565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b0316146101bb5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b60648201526084015b60405180910390fd5b6101c43361037a565b565b60006101de60008051602061058d8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b6101ff6101c6565b61024b5760405162461bcd60e51b815260206004820152601a60248201527f43616c6c6572206973206e6f742074686520476f7665726e6f7200000000000060448201526064016101b2565b610273817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b031661029360008051602061058d8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b6000336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146103455760405162461bcd60e51b815260206004820152601a60248201527f43616c6c6572206973206e6f742074686520537472617465677900000000000060448201526064016101b2565b50478015610377576103777f00000000000000000000000000000000000000000000000000000000000000008261043e565b90565b6001600160a01b0381166103d05760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f72206973206164647265737328302900000000000060448201526064016101b2565b806001600160a01b03166103f060008051602061058d8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a361043b8160008051602061058d83398151915255565b50565b8047101561048e5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e636500000060448201526064016101b2565b6000826001600160a01b03168260405160006040518083038185875af1925050503d80600081146104db576040519150601f19603f3d011682016040523d82523d6000602084013e6104e0565b606091505b50509050806105575760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d6179206861766520726576657274656400000000000060648201526084016101b2565b505050565b60006020828403121561056e57600080fd5b81356001600160a01b038116811461058557600080fd5b939250505056fe7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212200be77de36795d09032129c2625dac1fb5df5aa816a58c269aa5090717764a41664736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100625760003560e01c80630c340a2414610067578063185025ef1461008c5780635d36b190146100b3578063c7af3352146100bd578063d38bfff4146100d5578063e5225381146100e8575b600080fd5b61006f6100fe565b6040516001600160a01b0390911681526020015b60405180910390f35b61006f7f000000000000000000000000000000000000000000000000000000000000000081565b6100bb61011b565b005b6100c56101c6565b6040519015158152602001610083565b6100bb6100e336600461055c565b6101f7565b6100f06102cb565b604051908152602001610083565b600061011660008051602061058d8339815191525490565b905090565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b0316146101bb5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b60648201526084015b60405180910390fd5b6101c43361037a565b565b60006101de60008051602061058d8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b6101ff6101c6565b61024b5760405162461bcd60e51b815260206004820152601a60248201527f43616c6c6572206973206e6f742074686520476f7665726e6f7200000000000060448201526064016101b2565b610273817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b031661029360008051602061058d8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b6000336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146103455760405162461bcd60e51b815260206004820152601a60248201527f43616c6c6572206973206e6f742074686520537472617465677900000000000060448201526064016101b2565b50478015610377576103777f00000000000000000000000000000000000000000000000000000000000000008261043e565b90565b6001600160a01b0381166103d05760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f72206973206164647265737328302900000000000060448201526064016101b2565b806001600160a01b03166103f060008051602061058d8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a361043b8160008051602061058d83398151915255565b50565b8047101561048e5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a20696e73756666696369656e742062616c616e636500000060448201526064016101b2565b6000826001600160a01b03168260405160006040518083038185875af1925050503d80600081146104db576040519150601f19603f3d011682016040523d82523d6000602084013e6104e0565b606091505b50509050806105575760405162461bcd60e51b815260206004820152603a60248201527f416464726573733a20756e61626c6520746f2073656e642076616c75652c207260448201527f6563697069656e74206d6179206861766520726576657274656400000000000060648201526084016101b2565b505050565b60006020828403121561056e57600080fd5b81356001600160a01b038116811461058557600080fd5b939250505056fe7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212200be77de36795d09032129c2625dac1fb5df5aa816a58c269aa5090717764a41664736f6c63430008070033", diff --git a/contracts/deployments/holesky/NativeStakingFeeAccumulatorProxy.json b/contracts/deployments/holesky/NativeStakingFeeAccumulatorProxy.json index 613ebfdf20..b28a9bcbce 100644 --- a/contracts/deployments/holesky/NativeStakingFeeAccumulatorProxy.json +++ b/contracts/deployments/holesky/NativeStakingFeeAccumulatorProxy.json @@ -1,5 +1,5 @@ { - "address": "0x590B781b511e953dbFC49e7E7864A6E787aFBDCc", + "address": "0x65a289f4BF934c964C942eFF6E6F83b6481BE550", "abi": [ { "anonymous": false, @@ -183,40 +183,40 @@ "type": "function" } ], - "transactionHash": "0xe18ea4add8d4b624520b0d846ca2cd46ce529dbfe4b1cd3d0021af17f101976c", + "transactionHash": "0xdf546fcd8f123530eeb172e7b0300f7ec025708e8dc7bf7f81c10ed1bfc27390", "receipt": { "to": null, "from": "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C", - "contractAddress": "0x590B781b511e953dbFC49e7E7864A6E787aFBDCc", - "transactionIndex": 27, + "contractAddress": "0x65a289f4BF934c964C942eFF6E6F83b6481BE550", + "transactionIndex": 5, "gasUsed": "580428", - "logsBloom": "0x00000000000000000000000000000000000000004000000000000000000000000000000000000100000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000400000000", - "blockHash": "0x5b923d8e846ac85cdb6738b81eb0c4497e0bae72d3df76486bafd0c5370abe94", - "transactionHash": "0xe18ea4add8d4b624520b0d846ca2cd46ce529dbfe4b1cd3d0021af17f101976c", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000001000000020000000000000000000000000000000000000000008000000000000000000000000", + "blockHash": "0x815557d68a9f6f68b373786e2f16e3e037531c823e74be7e8a66e62d600c9ef0", + "transactionHash": "0xdf546fcd8f123530eeb172e7b0300f7ec025708e8dc7bf7f81c10ed1bfc27390", "logs": [ { - "transactionIndex": 27, - "blockNumber": 1405107, - "transactionHash": "0xe18ea4add8d4b624520b0d846ca2cd46ce529dbfe4b1cd3d0021af17f101976c", - "address": "0x590B781b511e953dbFC49e7E7864A6E787aFBDCc", + "transactionIndex": 5, + "blockNumber": 1489367, + "transactionHash": "0xdf546fcd8f123530eeb172e7b0300f7ec025708e8dc7bf7f81c10ed1bfc27390", + "address": "0x65a289f4BF934c964C942eFF6E6F83b6481BE550", "topics": [ "0xc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000001b94ca50d3ad9f8368851f8526132272d1a5028c" ], "data": "0x", - "logIndex": 35, - "blockHash": "0x5b923d8e846ac85cdb6738b81eb0c4497e0bae72d3df76486bafd0c5370abe94" + "logIndex": 8, + "blockHash": "0x815557d68a9f6f68b373786e2f16e3e037531c823e74be7e8a66e62d600c9ef0" } ], - "blockNumber": 1405107, - "cumulativeGasUsed": "3056739", + "blockNumber": 1489367, + "cumulativeGasUsed": "1072707", "status": 1, "byzantium": true }, "args": [], "numDeployments": 1, - "solcInputHash": "da4c2bc4af0be4b969e54f8b43895033", + "solcInputHash": "5e7101910c63b5cb160cf1f36fa86058", "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_initGovernor\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"admin()\":{\"returns\":{\"_0\":\"The address of the proxy admin/it's also the governor.\"}},\"implementation()\":{\"returns\":{\"_0\":\"The address of the implementation.\"}},\"initialize(address,address,bytes)\":{\"details\":\"Contract initializer with Governor enforcement\",\"params\":{\"_data\":\"Data to send as msg.data to the implementation to initialize the proxied contract. It should include the signature and the parameters of the function to be called, as described in https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding. This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.\",\"_initGovernor\":\"Address of the initial Governor.\",\"_logic\":\"Address of the initial implementation.\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"upgradeTo(address)\":{\"details\":\"Upgrade the backing implementation of the proxy. Only the admin can call this function.\",\"params\":{\"newImplementation\":\"Address of the new implementation.\"}},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the backing implementation of the proxy and call a function on the new implementation. This is useful to initialize the proxied contract.\",\"params\":{\"data\":\"Data to send as msg.data in the low level call. It should include the signature and the parameters of the function to be called, as described in https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\",\"newImplementation\":\"Address of the new implementation.\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"}},\"notice\":\"NativeStakingFeeAccumulatorProxy delegates calls to NativeStakingFeeCollector implementation\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/proxies/Proxies.sol\":\"NativeStakingFeeAccumulatorProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/proxies/InitializeGovernedUpgradeabilityProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * @title BaseGovernedUpgradeabilityProxy\\n * @dev This contract combines an upgradeability proxy with our governor system.\\n * It is based on an older version of OpenZeppelins BaseUpgradeabilityProxy\\n * with Solidity ^0.8.0.\\n * @author Origin Protocol Inc\\n */\\ncontract InitializeGovernedUpgradeabilityProxy is Governable {\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n * @param implementation Address of the new implementation.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Contract initializer with Governor enforcement\\n * @param _logic Address of the initial implementation.\\n * @param _initGovernor Address of the initial Governor.\\n * @param _data Data to send as msg.data to the implementation to initialize\\n * the proxied contract.\\n * It should include the signature and the parameters of the function to be\\n * called, as described in\\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\\n * This parameter is optional, if no data is given the initialization call\\n * to proxied contract will be skipped.\\n */\\n function initialize(\\n address _logic,\\n address _initGovernor,\\n bytes calldata _data\\n ) public payable onlyGovernor {\\n require(_implementation() == address(0));\\n assert(\\n IMPLEMENTATION_SLOT ==\\n bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1)\\n );\\n _setImplementation(_logic);\\n if (_data.length > 0) {\\n (bool success, ) = _logic.delegatecall(_data);\\n require(success);\\n }\\n _changeGovernor(_initGovernor);\\n }\\n\\n /**\\n * @return The address of the proxy admin/it's also the governor.\\n */\\n function admin() external view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @return The address of the implementation.\\n */\\n function implementation() external view returns (address) {\\n return _implementation();\\n }\\n\\n /**\\n * @dev Upgrade the backing implementation of the proxy.\\n * Only the admin can call this function.\\n * @param newImplementation Address of the new implementation.\\n */\\n function upgradeTo(address newImplementation) external onlyGovernor {\\n _upgradeTo(newImplementation);\\n }\\n\\n /**\\n * @dev Upgrade the backing implementation of the proxy and call a function\\n * on the new implementation.\\n * This is useful to initialize the proxied contract.\\n * @param newImplementation Address of the new implementation.\\n * @param data Data to send as msg.data in the low level call.\\n * It should include the signature and the parameters of the function to be called, as described in\\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data)\\n external\\n payable\\n onlyGovernor\\n {\\n _upgradeTo(newImplementation);\\n (bool success, ) = newImplementation.delegatecall(data);\\n require(success);\\n }\\n\\n /**\\n * @dev Fallback function.\\n * Implemented entirely in `_fallback`.\\n */\\n fallback() external payable {\\n _fallback();\\n }\\n\\n /**\\n * @dev Delegates execution to an implementation contract.\\n * This is a low level function that doesn't return to its internal call site.\\n * It will return to the external caller whatever the implementation returns.\\n * @param _impl Address to delegate.\\n */\\n function _delegate(address _impl) internal {\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), _impl, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev Function that is run as the first thing in the fallback function.\\n * Can be redefined in derived contracts to add functionality.\\n * Redefinitions must call super._willFallback().\\n */\\n function _willFallback() internal {}\\n\\n /**\\n * @dev fallback implementation.\\n * Extracted to enable manual triggering.\\n */\\n function _fallback() internal {\\n _willFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant IMPLEMENTATION_SLOT =\\n 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Returns the current implementation.\\n * @return impl Address of the current implementation\\n */\\n function _implementation() internal view returns (address impl) {\\n bytes32 slot = IMPLEMENTATION_SLOT;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n impl := sload(slot)\\n }\\n }\\n\\n /**\\n * @dev Upgrades the proxy to a new implementation.\\n * @param newImplementation Address of the new implementation.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Sets the implementation address of the proxy.\\n * @param newImplementation Address of the new implementation.\\n */\\n function _setImplementation(address newImplementation) internal {\\n require(\\n Address.isContract(newImplementation),\\n \\\"Cannot set a proxy implementation to a non-contract address\\\"\\n );\\n\\n bytes32 slot = IMPLEMENTATION_SLOT;\\n\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(slot, newImplementation)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xcf9bc33957fa41a745726edb6461a4bddca875a038c848286a059f0f22b7f184\",\"license\":\"MIT\"},\"contracts/proxies/Proxies.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { InitializeGovernedUpgradeabilityProxy } from \\\"./InitializeGovernedUpgradeabilityProxy.sol\\\";\\n\\n/**\\n * @notice OUSDProxy delegates calls to an OUSD implementation\\n */\\ncontract OUSDProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice WrappedOUSDProxy delegates calls to a WrappedOUSD implementation\\n */\\ncontract WrappedOUSDProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice VaultProxy delegates calls to a Vault implementation\\n */\\ncontract VaultProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice CompoundStrategyProxy delegates calls to a CompoundStrategy implementation\\n */\\ncontract CompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice AaveStrategyProxy delegates calls to a AaveStrategy implementation\\n */\\ncontract AaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ThreePoolStrategyProxy delegates calls to a ThreePoolStrategy implementation\\n */\\ncontract ThreePoolStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ConvexStrategyProxy delegates calls to a ConvexStrategy implementation\\n */\\ncontract ConvexStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice HarvesterProxy delegates calls to a Harvester implementation\\n */\\ncontract HarvesterProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice DripperProxy delegates calls to a Dripper implementation\\n */\\ncontract DripperProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice MorphoCompoundStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\\n */\\ncontract MorphoCompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ConvexOUSDMetaStrategyProxy delegates calls to a ConvexOUSDMetaStrategy implementation\\n */\\ncontract ConvexOUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ConvexLUSDMetaStrategyProxy delegates calls to a ConvexalGeneralizedMetaStrategy implementation\\n */\\ncontract ConvexLUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice MorphoAaveStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\\n */\\ncontract MorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHProxy delegates calls to nowhere for now\\n */\\ncontract OETHProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice WOETHProxy delegates calls to nowhere for now\\n */\\ncontract WOETHProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHVaultProxy delegates calls to a Vault implementation\\n */\\ncontract OETHVaultProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHDripperProxy delegates calls to a OETHDripper implementation\\n */\\ncontract OETHDripperProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHHarvesterProxy delegates calls to a Harvester implementation\\n */\\ncontract OETHHarvesterProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice FraxETHStrategyProxy delegates calls to a FraxETHStrategy implementation\\n */\\ncontract FraxETHStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice CurveEthStrategyProxy delegates calls to a CurveEthStrategy implementation\\n */\\ncontract ConvexEthMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice BuybackProxy delegates calls to Buyback implementation\\n */\\ncontract BuybackProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHMorphoAaveStrategyProxy delegates calls to a MorphoAaveStrategy implementation\\n */\\ncontract OETHMorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHBalancerMetaPoolrEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\\n */\\ncontract OETHBalancerMetaPoolrEthStrategyProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\\n/**\\n * @notice OETHBalancerMetaPoolwstEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\\n */\\ncontract OETHBalancerMetaPoolwstEthStrategyProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\\n/**\\n * @notice FluxStrategyProxy delegates calls to a CompoundStrategy implementation\\n */\\ncontract FluxStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice MakerDsrStrategyProxy delegates calls to a Generalized4626Strategy implementation\\n */\\ncontract MakerDsrStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice FrxEthRedeemStrategyProxy delegates calls to a FrxEthRedeemStrategy implementation\\n */\\ncontract FrxEthRedeemStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHBuybackProxy delegates calls to Buyback implementation\\n */\\ncontract OETHBuybackProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice BridgedWOETHProxy delegates calls to BridgedWOETH implementation\\n */\\ncontract BridgedWOETHProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice NativeStakingSSVStrategyProxy delegates calls to NativeStakingSSVStrategy implementation\\n */\\ncontract NativeStakingSSVStrategyProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\\n/**\\n * @notice NativeStakingFeeAccumulatorProxy delegates calls to NativeStakingFeeCollector implementation\\n */\\ncontract NativeStakingFeeAccumulatorProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\",\"keccak256\":\"0x2e294507edd91494e1020a2a1c43502d2f5cba01266c228406562ecde7a2d872\",\"license\":\"MIT\"}},\"version\":1}", "bytecode": "0x608060405234801561001057600080fd5b506100273360008051602061099083398151915255565b600080516020610990833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36109138061007d6000396000f3fe6080604052600436106100865760003560e01c80635d36b190116100595780635d36b1901461010a578063c7af33521461011f578063cf7a1d7714610144578063d38bfff414610157578063f851a4401461009057610086565b80630c340a24146100905780633659cfe6146100c25780634f1ef286146100e25780635c60da1b146100f5575b61008e610177565b005b34801561009c57600080fd5b506100a5610197565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156100ce57600080fd5b5061008e6100dd366004610745565b6101b4565b61008e6100f03660046107c8565b6101ed565b34801561010157600080fd5b506100a561028a565b34801561011657600080fd5b5061008e6102a2565b34801561012b57600080fd5b50610134610346565b60405190151581526020016100b9565b61008e610152366004610767565b610377565b34801561016357600080fd5b5061008e610172366004610745565b610491565b61019561019060008051602061089e8339815191525490565b610535565b565b60006101af6000805160206108be8339815191525490565b905090565b6101bc610346565b6101e15760405162461bcd60e51b81526004016101d89061082b565b60405180910390fd5b6101ea81610559565b50565b6101f5610346565b6102115760405162461bcd60e51b81526004016101d89061082b565b61021a83610559565b6000836001600160a01b0316838360405161023692919061081b565b600060405180830381855af49150503d8060008114610271576040519150601f19603f3d011682016040523d82523d6000602084013e610276565b606091505b505090508061028457600080fd5b50505050565b60006101af60008051602061089e8339815191525490565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b03161461033d5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b60648201526084016101d8565b61019533610599565b600061035e6000805160206108be8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b61037f610346565b61039b5760405162461bcd60e51b81526004016101d89061082b565b60006103b360008051602061089e8339815191525490565b6001600160a01b0316146103c657600080fd5b6103f160017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd610862565b60008051602061089e8339815191521461040d5761040d610887565b6104168461065a565b8015610488576000846001600160a01b0316838360405161043892919061081b565b600060405180830381855af49150503d8060008114610473576040519150601f19603f3d011682016040523d82523d6000602084013e610478565b606091505b505090508061048657600080fd5b505b61028483610599565b610499610346565b6104b55760405162461bcd60e51b81526004016101d89061082b565b6104dd817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b03166104fd6000805160206108be8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b3660008037600080366000845af43d6000803e808015610554573d6000f35b3d6000fd5b6105628161065a565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6001600160a01b0381166105ef5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f72206973206164647265737328302900000000000060448201526064016101d8565b806001600160a01b031661060f6000805160206108be8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36101ea816000805160206108be83398151915255565b803b6106ce5760405162461bcd60e51b815260206004820152603b60248201527f43616e6e6f742073657420612070726f787920696d706c656d656e746174696f60448201527f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000060648201526084016101d8565b60008051602061089e83398151915255565b80356001600160a01b03811681146106f757600080fd5b919050565b60008083601f84011261070e57600080fd5b50813567ffffffffffffffff81111561072657600080fd5b60208301915083602082850101111561073e57600080fd5b9250929050565b60006020828403121561075757600080fd5b610760826106e0565b9392505050565b6000806000806060858703121561077d57600080fd5b610786856106e0565b9350610794602086016106e0565b9250604085013567ffffffffffffffff8111156107b057600080fd5b6107bc878288016106fc565b95989497509550505050565b6000806000604084860312156107dd57600080fd5b6107e6846106e0565b9250602084013567ffffffffffffffff81111561080257600080fd5b61080e868287016106fc565b9497909650939450505050565b8183823760009101908152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60008282101561088257634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fdfe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212205970f4615c7f37182e1f488c42ecbeb496eeeae3e15b9d0b344a6c7530953ff364736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", "deployedBytecode": "0x6080604052600436106100865760003560e01c80635d36b190116100595780635d36b1901461010a578063c7af33521461011f578063cf7a1d7714610144578063d38bfff414610157578063f851a4401461009057610086565b80630c340a24146100905780633659cfe6146100c25780634f1ef286146100e25780635c60da1b146100f5575b61008e610177565b005b34801561009c57600080fd5b506100a5610197565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156100ce57600080fd5b5061008e6100dd366004610745565b6101b4565b61008e6100f03660046107c8565b6101ed565b34801561010157600080fd5b506100a561028a565b34801561011657600080fd5b5061008e6102a2565b34801561012b57600080fd5b50610134610346565b60405190151581526020016100b9565b61008e610152366004610767565b610377565b34801561016357600080fd5b5061008e610172366004610745565b610491565b61019561019060008051602061089e8339815191525490565b610535565b565b60006101af6000805160206108be8339815191525490565b905090565b6101bc610346565b6101e15760405162461bcd60e51b81526004016101d89061082b565b60405180910390fd5b6101ea81610559565b50565b6101f5610346565b6102115760405162461bcd60e51b81526004016101d89061082b565b61021a83610559565b6000836001600160a01b0316838360405161023692919061081b565b600060405180830381855af49150503d8060008114610271576040519150601f19603f3d011682016040523d82523d6000602084013e610276565b606091505b505090508061028457600080fd5b50505050565b60006101af60008051602061089e8339815191525490565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b03161461033d5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b60648201526084016101d8565b61019533610599565b600061035e6000805160206108be8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b61037f610346565b61039b5760405162461bcd60e51b81526004016101d89061082b565b60006103b360008051602061089e8339815191525490565b6001600160a01b0316146103c657600080fd5b6103f160017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd610862565b60008051602061089e8339815191521461040d5761040d610887565b6104168461065a565b8015610488576000846001600160a01b0316838360405161043892919061081b565b600060405180830381855af49150503d8060008114610473576040519150601f19603f3d011682016040523d82523d6000602084013e610478565b606091505b505090508061048657600080fd5b505b61028483610599565b610499610346565b6104b55760405162461bcd60e51b81526004016101d89061082b565b6104dd817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b03166104fd6000805160206108be8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b3660008037600080366000845af43d6000803e808015610554573d6000f35b3d6000fd5b6105628161065a565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6001600160a01b0381166105ef5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f72206973206164647265737328302900000000000060448201526064016101d8565b806001600160a01b031661060f6000805160206108be8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36101ea816000805160206108be83398151915255565b803b6106ce5760405162461bcd60e51b815260206004820152603b60248201527f43616e6e6f742073657420612070726f787920696d706c656d656e746174696f60448201527f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000060648201526084016101d8565b60008051602061089e83398151915255565b80356001600160a01b03811681146106f757600080fd5b919050565b60008083601f84011261070e57600080fd5b50813567ffffffffffffffff81111561072657600080fd5b60208301915083602082850101111561073e57600080fd5b9250929050565b60006020828403121561075757600080fd5b610760826106e0565b9392505050565b6000806000806060858703121561077d57600080fd5b610786856106e0565b9350610794602086016106e0565b9250604085013567ffffffffffffffff8111156107b057600080fd5b6107bc878288016106fc565b95989497509550505050565b6000806000604084860312156107dd57600080fd5b6107e6846106e0565b9250602084013567ffffffffffffffff81111561080257600080fd5b61080e868287016106fc565b9497909650939450505050565b8183823760009101908152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60008282101561088257634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fdfe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212205970f4615c7f37182e1f488c42ecbeb496eeeae3e15b9d0b344a6c7530953ff364736f6c63430008070033", diff --git a/contracts/deployments/holesky/NativeStakingSSVStrategy.json b/contracts/deployments/holesky/NativeStakingSSVStrategy.json index 5d5b2a21a9..fc66b58e4c 100644 --- a/contracts/deployments/holesky/NativeStakingSSVStrategy.json +++ b/contracts/deployments/holesky/NativeStakingSSVStrategy.json @@ -1,5 +1,5 @@ { - "address": "0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793", + "address": "0xaf3fCA5376354c8a51dc3cB02D586530Cc61d164", "abi": [ { "inputs": [ @@ -1276,34 +1276,34 @@ "type": "receive" } ], - "transactionHash": "0x0ba7a44fb241a4af2dfdb828df227fd90a75d6b2523a59944c2a37aeeaced32b", + "transactionHash": "0xddb5a6d8ad3f95e324b44bfe1d2cb508bcf734deb36c3f6dfb2f29e44f36e797", "receipt": { "to": null, "from": "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C", - "contractAddress": "0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793", - "transactionIndex": 29, + "contractAddress": "0xaf3fCA5376354c8a51dc3cB02D586530Cc61d164", + "transactionIndex": 9, "gasUsed": "4109268", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000400000000000000000000000000200000000000000000000030000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", - "blockHash": "0x10e4dbee882616c76e9bb546647da836d38c3a12883d278855e68d42b0a5876b", - "transactionHash": "0x0ba7a44fb241a4af2dfdb828df227fd90a75d6b2523a59944c2a37aeeaced32b", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000400000000000000000000000000000000000000000000000000000000000001", + "blockHash": "0x95040d373bc67c18914c67055beff42c69ea4eab3fae944856d9e458a49bfac7", + "transactionHash": "0xddb5a6d8ad3f95e324b44bfe1d2cb508bcf734deb36c3f6dfb2f29e44f36e797", "logs": [ { - "transactionIndex": 29, - "blockNumber": 1471277, - "transactionHash": "0x0ba7a44fb241a4af2dfdb828df227fd90a75d6b2523a59944c2a37aeeaced32b", - "address": "0x51766Fd366D6C9121F6Aeec20267ecA87c2c9793", + "transactionIndex": 9, + "blockNumber": 1489371, + "transactionHash": "0xddb5a6d8ad3f95e324b44bfe1d2cb508bcf734deb36c3f6dfb2f29e44f36e797", + "address": "0xaf3fCA5376354c8a51dc3cB02D586530Cc61d164", "topics": [ "0xc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000001b94ca50d3ad9f8368851f8526132272d1a5028c" ], "data": "0x", - "logIndex": 436, - "blockHash": "0x10e4dbee882616c76e9bb546647da836d38c3a12883d278855e68d42b0a5876b" + "logIndex": 400, + "blockHash": "0x95040d373bc67c18914c67055beff42c69ea4eab3fae944856d9e458a49bfac7" } ], - "blockNumber": 1471277, - "cumulativeGasUsed": "22895699", + "blockNumber": 1489371, + "cumulativeGasUsed": "20992246", "status": 1, "byzantium": true }, @@ -1315,10 +1315,10 @@ "0x94373a4919B3240D86eA41593D5eBa789FEF3848", "0xad45A78180961079BFaeEe349704F411dfF947C6", "0x38A4794cCEd47d3baf7370CcC43B560D3a1beEFA", - "0x590B781b511e953dbFC49e7E7864A6E787aFBDCc", + "0x65a289f4BF934c964C942eFF6E6F83b6481BE550", "0x4242424242424242424242424242424242424242" ], - "numDeployments": 3, + "numDeployments": 1, "solcInputHash": "66dbdc9fbde8f1c7cc59f29d272eb661", "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"platformAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"vaultAddress\",\"type\":\"address\"}],\"internalType\":\"struct InitializableAbstractStrategy.BaseStrategyConfig\",\"name\":\"_baseConfig\",\"type\":\"tuple\"},{\"internalType\":\"address\",\"name\":\"_wethAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_ssvToken\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_ssvNetwork\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_feeAccumulator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_beaconChainDepositContract\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"AccountingConsensusRewards\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"noOfValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"remainingValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingFullyWithdrawnValidator\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"int256\",\"name\":\"validatorsDelta\",\"type\":\"int256\"},{\"indexed\":false,\"internalType\":\"int256\",\"name\":\"consensusRewardsDelta\",\"type\":\"int256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingManuallyFixed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"remainingValidators\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"wethSentToVault\",\"type\":\"uint256\"}],\"name\":\"AccountingValidatorSlashed\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Deposit\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"withdrawal_credentials\",\"type\":\"bytes\"}],\"name\":\"ETHStaked\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"start\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"end\",\"type\":\"uint256\"}],\"name\":\"FuseIntervalUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_oldHarvesterAddress\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_newHarvesterAddress\",\"type\":\"address\"}],\"name\":\"HarvesterAddressesUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"PTokenAdded\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"PTokenRemoved\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Paused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newAddress\",\"type\":\"address\"}],\"name\":\"RegistratorChanged\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"_oldAddresses\",\"type\":\"address[]\"},{\"indexed\":false,\"internalType\":\"address[]\",\"name\":\"_newAddresses\",\"type\":\"address[]\"}],\"name\":\"RewardTokenAddressesUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"recipient\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"rewardToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"name\":\"RewardTokenCollected\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorExitCompleted\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorExitInitiated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"indexed\":false,\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"SSVValidatorRegistered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"account\",\"type\":\"address\"}],\"name\":\"Unpaused\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"Withdrawal\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"BEACON_CHAIN_DEPOSIT_CONTRACT\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"FEE_ACCUMULATOR_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"MAX_STAKE\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SSV_NETWORK_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"SSV_TOKEN_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"VAULT_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"WETH_TOKEN_ADDRESS\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"activeDepositedValidators\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"assetToPToken\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"}],\"name\":\"checkBalance\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"collectRewardTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"consensusRewards\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"deposit\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"depositAll\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"depositSSV\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"doAccounting\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"accountingValid\",\"type\":\"bool\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"}],\"name\":\"exitSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fuseIntervalEnd\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"fuseIntervalStart\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getRewardTokenAddresses\",\"outputs\":[{\"internalType\":\"address[]\",\"name\":\"\",\"type\":\"address[]\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"harvesterAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address[]\",\"name\":\"_rewardTokenAddresses\",\"type\":\"address[]\"},{\"internalType\":\"address[]\",\"name\":\"_assets\",\"type\":\"address[]\"},{\"internalType\":\"address[]\",\"name\":\"_pTokens\",\"type\":\"address[]\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"int256\",\"name\":\"_validatorsDelta\",\"type\":\"int256\"},{\"internalType\":\"int256\",\"name\":\"_consensusRewardsDelta\",\"type\":\"int256\"},{\"internalType\":\"uint256\",\"name\":\"_wethToVaultAmount\",\"type\":\"uint256\"}],\"name\":\"manuallyFixAccounting\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"pause\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"paused\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"platformAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"internalType\":\"bytes\",\"name\":\"sharesData\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"registerSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_assetIndex\",\"type\":\"uint256\"}],\"name\":\"removePToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes\",\"name\":\"publicKey\",\"type\":\"bytes\"},{\"internalType\":\"uint64[]\",\"name\":\"operatorIds\",\"type\":\"uint64[]\"},{\"components\":[{\"internalType\":\"uint32\",\"name\":\"validatorCount\",\"type\":\"uint32\"},{\"internalType\":\"uint64\",\"name\":\"networkFeeIndex\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"index\",\"type\":\"uint64\"},{\"internalType\":\"bool\",\"name\":\"active\",\"type\":\"bool\"},{\"internalType\":\"uint256\",\"name\":\"balance\",\"type\":\"uint256\"}],\"internalType\":\"struct Cluster\",\"name\":\"cluster\",\"type\":\"tuple\"}],\"name\":\"removeSsvValidator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"rewardTokenAddresses\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"safeApproveAllTokens\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"_fuseIntervalStart\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"_fuseIntervalEnd\",\"type\":\"uint256\"}],\"name\":\"setFuseInterval\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_harvesterAddress\",\"type\":\"address\"}],\"name\":\"setHarvesterAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_pToken\",\"type\":\"address\"}],\"name\":\"setPTokenAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_address\",\"type\":\"address\"}],\"name\":\"setRegistrator\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address[]\",\"name\":\"_rewardTokenAddresses\",\"type\":\"address[]\"}],\"name\":\"setRewardTokenAddresses\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"components\":[{\"internalType\":\"bytes\",\"name\":\"pubkey\",\"type\":\"bytes\"},{\"internalType\":\"bytes\",\"name\":\"signature\",\"type\":\"bytes\"},{\"internalType\":\"bytes32\",\"name\":\"depositDataRoot\",\"type\":\"bytes32\"}],\"internalType\":\"struct ValidatorStakeData[]\",\"name\":\"validators\",\"type\":\"tuple[]\"}],\"name\":\"stakeEth\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"}],\"name\":\"supportsAsset\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"transferToken\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"validatorRegistrator\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"name\":\"validatorsStates\",\"outputs\":[{\"internalType\":\"enum ValidatorRegistrator.VALIDATOR_STATE\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"vaultAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_recipient\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_asset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"_amount\",\"type\":\"uint256\"}],\"name\":\"withdraw\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"withdrawAll\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"stateMutability\":\"payable\",\"type\":\"receive\"}],\"devdoc\":{\"author\":\"Origin Protocol Inc\",\"kind\":\"dev\",\"methods\":{\"checkBalance(address)\":{\"params\":{\"_asset\":\"Address of weth asset\"},\"returns\":{\"balance\":\" Total value of (W)ETH\"}},\"constructor\":{\"params\":{\"_baseConfig\":\"Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI, and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\",\"_beaconChainDepositContract\":\"Address of the beacon chain deposit contract\",\"_feeAccumulator\":\"Address of the fee accumulator receiving execution layer validator rewards\",\"_ssvNetwork\":\"Address of the SSV Network contract\",\"_ssvToken\":\"Address of the Erc20 SSV Token contract\",\"_wethAddress\":\"Address of the Erc20 WETH Token contract\"}},\"deposit(address,uint256)\":{\"params\":{\"_amount\":\"Amount of assets that were transferred to the strategy by the vault.\",\"_asset\":\"Address of asset to deposit. Has to be WETH.\"}},\"depositSSV(uint64[],uint256,(uint32,uint64,uint64,bool,uint256))\":{\"details\":\"A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds. uses \\\"onlyStrategist\\\" modifier so continuous front-running can't DOS our maintenance service that tries to top up SSV tokens.\",\"params\":{\"cluster\":\"The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\"}},\"doAccounting()\":{\"details\":\"This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it for now.\",\"returns\":{\"accountingValid\":\"true if accounting was successful, false if fuse is blown\"}},\"getRewardTokenAddresses()\":{\"returns\":{\"_0\":\"address[] the reward token addresses.\"}},\"initialize(address[],address[],address[])\":{\"params\":{\"_assets\":\"Addresses of initial supported assets\",\"_pTokens\":\"Platform Token corresponding addresses\",\"_rewardTokenAddresses\":\"Address of reward token for platform\"}},\"manuallyFixAccounting(int256,int256,uint256)\":{\"params\":{\"_consensusRewardsDelta\":\"adjust the accounted for consensus rewards up or down\",\"_validatorsDelta\":\"adjust the active validators by plus one, minus one or unchanged with zero\",\"_wethToVaultAmount\":\"the amount of WETH to be sent to the Vault\"}},\"paused()\":{\"details\":\"Returns true if the contract is paused, and false otherwise.\"},\"removePToken(uint256)\":{\"params\":{\"_assetIndex\":\"Index of the asset to be removed\"}},\"setHarvesterAddress(address)\":{\"params\":{\"_harvesterAddress\":\"Address of the harvester contract.\"}},\"setPTokenAddress(address,address)\":{\"params\":{\"_asset\":\"Address for the asset\",\"_pToken\":\"Address for the corresponding platform token\"}},\"setRewardTokenAddresses(address[])\":{\"params\":{\"_rewardTokenAddresses\":\"Array of reward token addresses\"}},\"stakeEth((bytes,bytes,bytes32)[])\":{\"params\":{\"validators\":\"A list of validator data needed to stake. The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot. Only the registrator can call this function.\"}},\"supportsAsset(address)\":{\"params\":{\"_asset\":\"The address of the asset token.\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"transferToken(address,uint256)\":{\"params\":{\"_amount\":\"Amount of the asset to transfer\",\"_asset\":\"Address for the asset\"}},\"withdraw(address,address,uint256)\":{\"params\":{\"_amount\":\"Amount of WETH to withdraw\",\"_asset\":\"WETH to withdraw\",\"_recipient\":\"Address to receive withdrawn assets\"}}},\"stateVariables\":{\"FEE_ACCUMULATOR_ADDRESS\":{\"details\":\"this address will receive Execution layer rewards - These are rewards earned for executing transactions on the Ethereum network as part of block proposals. They include priority fees (fees paid by users for their transactions to be included) and MEV rewards (rewards for arranging transactions in a way that benefits the validator).\"}},\"title\":\"Native Staking SSV Strategy\",\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"BEACON_CHAIN_DEPOSIT_CONTRACT()\":{\"notice\":\"The address of the beacon chain deposit contract\"},\"FEE_ACCUMULATOR_ADDRESS()\":{\"notice\":\"Fee collector address\"},\"MAX_STAKE()\":{\"notice\":\"The maximum amount of ETH that can be staked by a validator\"},\"SSV_NETWORK_ADDRESS()\":{\"notice\":\"The address of the SSV Network contract used to interface with\"},\"SSV_TOKEN_ADDRESS()\":{\"notice\":\"SSV ERC20 token that serves as a payment for operating SSV validators\"},\"VAULT_ADDRESS()\":{\"notice\":\"Address of the OETH Vault proxy contract\"},\"WETH_TOKEN_ADDRESS()\":{\"notice\":\"The address of the Wrapped ETH (WETH) token contract\"},\"activeDepositedValidators()\":{\"notice\":\"The number of validators that have 32 (!) ETH actively deposited. When a new deposit to a validator happens this number increases, when a validator exit is detected this number decreases.\"},\"assetToPToken(address)\":{\"notice\":\"asset => pToken (Platform Specific Token Address)\"},\"checkBalance(address)\":{\"notice\":\"Returns the total value of (W)ETH that is staked to the validators and WETH deposits that are still to be staked. This does not include ETH from consensus rewards sitting in this strategy or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested and sent to the Dripper so will eventually be sent to the Vault as WETH.\"},\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"collectRewardTokens()\":{\"notice\":\"Collect accumulated reward token and send to Vault.\"},\"consensusRewards()\":{\"notice\":\"Keeps track of the total consensus rewards swept from the beacon chain\"},\"deposit(address,uint256)\":{\"notice\":\"Unlike other strategies, this does not deposit assets into the underlying platform. It just checks the asset is WETH and emits the Deposit event. To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used. Will NOT revert if the strategy is paused from an accounting failure.\"},\"depositAll()\":{\"notice\":\"Unlike other strategies, this does not deposit assets into the underlying platform. It just emits the Deposit event. To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used. Will NOT revert if the strategy is paused from an accounting failure.\"},\"depositSSV(uint64[],uint256,(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\"},\"doAccounting()\":{\"notice\":\"This notion page offers a good explanation of how the accounting functions https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart, the accounting function will treat that ETH as Beacon chain consensus rewards. On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32, the accounting function will treat that as a validator slashing.Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when accounting is valid and fuse isn't \\\"blown\\\". Returns false when fuse is blown.\"},\"exitSsvValidator(bytes,uint64[])\":{\"notice\":\"Exit a validator from the Beacon chain. The staked ETH will eventually swept to this native staking strategy. Only the registrator can call this function.\"},\"fuseIntervalEnd()\":{\"notice\":\"end of fuse interval\"},\"fuseIntervalStart()\":{\"notice\":\"start of fuse interval\"},\"getRewardTokenAddresses()\":{\"notice\":\"Get the reward token addresses.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"harvesterAddress()\":{\"notice\":\"Address of the Harvester contract allowed to collect reward tokens\"},\"initialize(address[],address[],address[])\":{\"notice\":\"initialize function, to set up initial internal state\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"manuallyFixAccounting(int256,int256,uint256)\":{\"notice\":\"Allow the Strategist to fix the accounting of this strategy and unpause.\"},\"platformAddress()\":{\"notice\":\"Address of the underlying platform\"},\"registerSsvValidator(bytes,uint64[],bytes,uint256,(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Registers a new validator in the SSV Cluster. Only the registrator can call this function.\"},\"removePToken(uint256)\":{\"notice\":\"Remove a supported asset by passing its index. This method can only be called by the system Governor\"},\"removeSsvValidator(bytes,uint64[],(uint32,uint64,uint64,bool,uint256))\":{\"notice\":\"Remove a validator from the SSV Cluster. Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain. If removed before the validator has exited the beacon chain will result in the validator being slashed. Only the registrator can call this function.\"},\"rewardTokenAddresses(uint256)\":{\"notice\":\"Address of the reward tokens. eg CRV, BAL, CVX, AURA\"},\"safeApproveAllTokens()\":{\"notice\":\"Approves the SSV Network contract to transfer SSV tokens for deposits\"},\"setFuseInterval(uint256,uint256)\":{\"notice\":\"set fuse interval values\"},\"setHarvesterAddress(address)\":{\"notice\":\"Set the Harvester contract that can collect rewards.\"},\"setPTokenAddress(address,address)\":{\"notice\":\"Provide support for asset by passing its pToken address. This method can only be called by the system Governor\"},\"setRegistrator(address)\":{\"notice\":\"Set the address of the registrator which can register, exit and remove validators\"},\"setRewardTokenAddresses(address[])\":{\"notice\":\"Set the reward token addresses. Any old addresses will be overwritten.\"},\"stakeEth((bytes,bytes,bytes32)[])\":{\"notice\":\"Stakes WETH to the node validators\"},\"supportsAsset(address)\":{\"notice\":\"Returns bool indicating whether asset is supported by strategy.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"},\"transferToken(address,uint256)\":{\"notice\":\"Transfer token to governor. Intended for recovering tokens stuck in strategy contracts, i.e. mistaken sends.\"},\"validatorRegistrator()\":{\"notice\":\"Address of the registrator - allowed to register, exit and remove validators\"},\"validatorsStates(bytes32)\":{\"notice\":\"State of the validators keccak256(pubKey) => state\"},\"vaultAddress()\":{\"notice\":\"Address of the OToken vault\"},\"withdraw(address,address,uint256)\":{\"notice\":\"Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That can happen when: - the deposit was not a multiple of 32 WETH - someone sent WETH directly to this contract Will NOT revert if the strategy is paused from an accounting failure.\"},\"withdrawAll()\":{\"notice\":\"transfer all WETH deposits back to the vault. This does not withdraw from the validators. That has to be done separately with the `exitSsvValidator` and `removeSsvValidator` operations. This does not withdraw any execution rewards from the FeeAccumulator or consensus rewards in this strategy. Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn. ETH from full validator withdrawals is sent to the Vault using `doAccounting`. Will NOT revert if the strategy is paused from an accounting failure.\"}},\"notice\":\"Strategy to deploy funds into DVT validators powered by the SSV Network\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol\":\"NativeStakingSSVStrategy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/security/Pausable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (security/Pausable.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../utils/Context.sol\\\";\\n\\n/**\\n * @dev Contract module which allows children to implement an emergency stop\\n * mechanism that can be triggered by an authorized account.\\n *\\n * This module is used through inheritance. It will make available the\\n * modifiers `whenNotPaused` and `whenPaused`, which can be applied to\\n * the functions of your contract. Note that they will not be pausable by\\n * simply including this module, only once the modifiers are put in place.\\n */\\nabstract contract Pausable is Context {\\n /**\\n * @dev Emitted when the pause is triggered by `account`.\\n */\\n event Paused(address account);\\n\\n /**\\n * @dev Emitted when the pause is lifted by `account`.\\n */\\n event Unpaused(address account);\\n\\n bool private _paused;\\n\\n /**\\n * @dev Initializes the contract in unpaused state.\\n */\\n constructor() {\\n _paused = false;\\n }\\n\\n /**\\n * @dev Returns true if the contract is paused, and false otherwise.\\n */\\n function paused() public view virtual returns (bool) {\\n return _paused;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is not paused.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n modifier whenNotPaused() {\\n require(!paused(), \\\"Pausable: paused\\\");\\n _;\\n }\\n\\n /**\\n * @dev Modifier to make a function callable only when the contract is paused.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n modifier whenPaused() {\\n require(paused(), \\\"Pausable: not paused\\\");\\n _;\\n }\\n\\n /**\\n * @dev Triggers stopped state.\\n *\\n * Requirements:\\n *\\n * - The contract must not be paused.\\n */\\n function _pause() internal virtual whenNotPaused {\\n _paused = true;\\n emit Paused(_msgSender());\\n }\\n\\n /**\\n * @dev Returns to normal state.\\n *\\n * Requirements:\\n *\\n * - The contract must be paused.\\n */\\n function _unpause() internal virtual whenPaused {\\n _paused = false;\\n emit Unpaused(_msgSender());\\n }\\n}\\n\",\"keccak256\":\"0xe68ed7fb8766ed1e888291f881e36b616037f852b37d96877045319ad298ba87\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Interface of the ERC20 standard as defined in the EIP.\\n */\\ninterface IERC20 {\\n /**\\n * @dev Returns the amount of tokens in existence.\\n */\\n function totalSupply() external view returns (uint256);\\n\\n /**\\n * @dev Returns the amount of tokens owned by `account`.\\n */\\n function balanceOf(address account) external view returns (uint256);\\n\\n /**\\n * @dev Moves `amount` tokens from the caller's account to `recipient`.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transfer(address recipient, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Returns the remaining number of tokens that `spender` will be\\n * allowed to spend on behalf of `owner` through {transferFrom}. This is\\n * zero by default.\\n *\\n * This value changes when {approve} or {transferFrom} are called.\\n */\\n function allowance(address owner, address spender) external view returns (uint256);\\n\\n /**\\n * @dev Sets `amount` as the allowance of `spender` over the caller's tokens.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * IMPORTANT: Beware that changing an allowance with this method brings the risk\\n * that someone may use both the old and the new allowance by unfortunate\\n * transaction ordering. One possible solution to mitigate this race\\n * condition is to first reduce the spender's allowance to 0 and set the\\n * desired value afterwards:\\n * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729\\n *\\n * Emits an {Approval} event.\\n */\\n function approve(address spender, uint256 amount) external returns (bool);\\n\\n /**\\n * @dev Moves `amount` tokens from `sender` to `recipient` using the\\n * allowance mechanism. `amount` is then deducted from the caller's\\n * allowance.\\n *\\n * Returns a boolean value indicating whether the operation succeeded.\\n *\\n * Emits a {Transfer} event.\\n */\\n function transferFrom(\\n address sender,\\n address recipient,\\n uint256 amount\\n ) external returns (bool);\\n\\n /**\\n * @dev Emitted when `value` tokens are moved from one account (`from`) to\\n * another (`to`).\\n *\\n * Note that `value` may be zero.\\n */\\n event Transfer(address indexed from, address indexed to, uint256 value);\\n\\n /**\\n * @dev Emitted when the allowance of a `spender` for an `owner` is set by\\n * a call to {approve}. `value` is the new allowance.\\n */\\n event Approval(address indexed owner, address indexed spender, uint256 value);\\n}\\n\",\"keccak256\":\"0x61437cb513a887a1bbad006e7b1c8b414478427d33de47c5600af3c748f108da\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.0;\\n\\nimport \\\"../IERC20.sol\\\";\\nimport \\\"../../../utils/Address.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\\n * contract returns false). Tokens that return no value (and instead revert or\\n * throw on failure) are also supported, non-reverting calls are assumed to be\\n * successful.\\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\\n */\\nlibrary SafeERC20 {\\n using Address for address;\\n\\n function safeTransfer(\\n IERC20 token,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\\n }\\n\\n function safeTransferFrom(\\n IERC20 token,\\n address from,\\n address to,\\n uint256 value\\n ) internal {\\n _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\\n }\\n\\n /**\\n * @dev Deprecated. This function has issues similar to the ones found in\\n * {IERC20-approve}, and its usage is discouraged.\\n *\\n * Whenever possible, use {safeIncreaseAllowance} and\\n * {safeDecreaseAllowance} instead.\\n */\\n function safeApprove(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n // safeApprove should only be called when setting an initial allowance,\\n // or when resetting it to zero. To increase and decrease it, use\\n // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\\n require(\\n (value == 0) || (token.allowance(address(this), spender) == 0),\\n \\\"SafeERC20: approve from non-zero to non-zero allowance\\\"\\n );\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\\n }\\n\\n function safeIncreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n uint256 newAllowance = token.allowance(address(this), spender) + value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n\\n function safeDecreaseAllowance(\\n IERC20 token,\\n address spender,\\n uint256 value\\n ) internal {\\n unchecked {\\n uint256 oldAllowance = token.allowance(address(this), spender);\\n require(oldAllowance >= value, \\\"SafeERC20: decreased allowance below zero\\\");\\n uint256 newAllowance = oldAllowance - value;\\n _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));\\n }\\n }\\n\\n /**\\n * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n * on the return value: the return value is optional (but if data is returned, it must not be false).\\n * @param token The token targeted by the call.\\n * @param data The call data (encoded using abi.encode or one of its variants).\\n */\\n function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\\n // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that\\n // the target address contains contract code and also asserts for success in the low-level call.\\n\\n bytes memory returndata = address(token).functionCall(data, \\\"SafeERC20: low-level call failed\\\");\\n if (returndata.length > 0) {\\n // Return data is optional\\n require(abi.decode(returndata, (bool)), \\\"SafeERC20: ERC20 operation did not succeed\\\");\\n }\\n }\\n}\\n\",\"keccak256\":\"0xc3d946432c0ddbb1f846a0d3985be71299df331b91d06732152117f62f0be2b5\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Provides information about the current execution context, including the\\n * sender of the transaction and its data. While these are generally available\\n * via msg.sender and msg.data, they should not be accessed in such a direct\\n * manner, since when dealing with meta-transactions the account sending and\\n * paying for execution may not be the actual sender (as far as an application\\n * is concerned).\\n *\\n * This contract is only required for intermediate, library-like contracts.\\n */\\nabstract contract Context {\\n function _msgSender() internal view virtual returns (address) {\\n return msg.sender;\\n }\\n\\n function _msgData() internal view virtual returns (bytes calldata) {\\n return msg.data;\\n }\\n}\\n\",\"keccak256\":\"0xe2e337e6dde9ef6b680e07338c493ebea1b5fd09b43424112868e9cc1706bca7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/math/SafeMath.sol)\\n\\npragma solidity ^0.8.0;\\n\\n// CAUTION\\n// This version of SafeMath should only be used with Solidity 0.8 or later,\\n// because it relies on the compiler's built in overflow checks.\\n\\n/**\\n * @dev Wrappers over Solidity's arithmetic operations.\\n *\\n * NOTE: `SafeMath` is generally not needed starting with Solidity 0.8, since the compiler\\n * now has built in overflow checking.\\n */\\nlibrary SafeMath {\\n /**\\n * @dev Returns the addition of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n uint256 c = a + b;\\n if (c < a) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the substraction of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b > a) return (false, 0);\\n return (true, a - b);\\n }\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, with an overflow flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n // benefit is lost if 'b' is also tested.\\n // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n if (a == 0) return (true, 0);\\n uint256 c = a * b;\\n if (c / a != b) return (false, 0);\\n return (true, c);\\n }\\n }\\n\\n /**\\n * @dev Returns the division of two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a / b);\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.\\n *\\n * _Available since v3.4._\\n */\\n function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {\\n unchecked {\\n if (b == 0) return (false, 0);\\n return (true, a % b);\\n }\\n }\\n\\n /**\\n * @dev Returns the addition of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `+` operator.\\n *\\n * Requirements:\\n *\\n * - Addition cannot overflow.\\n */\\n function add(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a + b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting on\\n * overflow (when the result is negative).\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a - b;\\n }\\n\\n /**\\n * @dev Returns the multiplication of two unsigned integers, reverting on\\n * overflow.\\n *\\n * Counterpart to Solidity's `*` operator.\\n *\\n * Requirements:\\n *\\n * - Multiplication cannot overflow.\\n */\\n function mul(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a * b;\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator.\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a / b;\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting when dividing by zero.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(uint256 a, uint256 b) internal pure returns (uint256) {\\n return a % b;\\n }\\n\\n /**\\n * @dev Returns the subtraction of two unsigned integers, reverting with custom message on\\n * overflow (when the result is negative).\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {trySub}.\\n *\\n * Counterpart to Solidity's `-` operator.\\n *\\n * Requirements:\\n *\\n * - Subtraction cannot overflow.\\n */\\n function sub(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b <= a, errorMessage);\\n return a - b;\\n }\\n }\\n\\n /**\\n * @dev Returns the integer division of two unsigned integers, reverting with custom message on\\n * division by zero. The result is rounded towards zero.\\n *\\n * Counterpart to Solidity's `/` operator. Note: this function uses a\\n * `revert` opcode (which leaves remaining gas untouched) while Solidity\\n * uses an invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function div(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a / b;\\n }\\n }\\n\\n /**\\n * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),\\n * reverting with custom message when dividing by zero.\\n *\\n * CAUTION: This function is deprecated because it requires allocating memory for the error\\n * message unnecessarily. For custom revert reasons use {tryMod}.\\n *\\n * Counterpart to Solidity's `%` operator. This function uses a `revert`\\n * opcode (which leaves remaining gas untouched) while Solidity uses an\\n * invalid opcode to revert (consuming all remaining gas).\\n *\\n * Requirements:\\n *\\n * - The divisor cannot be zero.\\n */\\n function mod(\\n uint256 a,\\n uint256 b,\\n string memory errorMessage\\n ) internal pure returns (uint256) {\\n unchecked {\\n require(b > 0, errorMessage);\\n return a % b;\\n }\\n }\\n}\\n\",\"keccak256\":\"0xa2f576be637946f767aa56601c26d717f48a0aff44f82e46f13807eea1009a21\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/interfaces/IBasicToken.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IBasicToken {\\n function symbol() external view returns (string memory);\\n\\n function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0xa562062698aa12572123b36dfd2072f1a39e44fed2031cc19c2c9fd522f96ec2\",\"license\":\"MIT\"},\"contracts/interfaces/IDepositContract.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IDepositContract {\\n /// @notice A processed deposit event.\\n event DepositEvent(\\n bytes pubkey,\\n bytes withdrawal_credentials,\\n bytes amount,\\n bytes signature,\\n bytes index\\n );\\n\\n /// @notice Submit a Phase 0 DepositData object.\\n /// @param pubkey A BLS12-381 public key.\\n /// @param withdrawal_credentials Commitment to a public key for withdrawals.\\n /// @param signature A BLS12-381 signature.\\n /// @param deposit_data_root The SHA-256 hash of the SSZ-encoded DepositData object.\\n /// Used as a protection against malformed input.\\n function deposit(\\n bytes calldata pubkey,\\n bytes calldata withdrawal_credentials,\\n bytes calldata signature,\\n bytes32 deposit_data_root\\n ) external payable;\\n\\n /// @notice Query the current deposit root hash.\\n /// @return The deposit root hash.\\n function get_deposit_root() external view returns (bytes32);\\n\\n /// @notice Query the current deposit count.\\n /// @return The deposit count encoded as a little endian 64-bit number.\\n function get_deposit_count() external view returns (bytes memory);\\n}\\n\",\"keccak256\":\"0x598f90bdbc854250bbd5991426bfb43367207e64e33109c41aa8b54323fd8d8e\",\"license\":\"MIT\"},\"contracts/interfaces/ISSVNetwork.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nstruct Cluster {\\n uint32 validatorCount;\\n uint64 networkFeeIndex;\\n uint64 index;\\n bool active;\\n uint256 balance;\\n}\\n\\ninterface ISSVNetwork {\\n error ApprovalNotWithinTimeframe();\\n error CallerNotOwner();\\n error CallerNotWhitelisted();\\n error ClusterAlreadyEnabled();\\n error ClusterDoesNotExists();\\n error ClusterIsLiquidated();\\n error ClusterNotLiquidatable();\\n error ExceedValidatorLimit();\\n error FeeExceedsIncreaseLimit();\\n error FeeIncreaseNotAllowed();\\n error FeeTooHigh();\\n error FeeTooLow();\\n error IncorrectClusterState();\\n error IncorrectValidatorState();\\n error InsufficientBalance();\\n error InvalidOperatorIdsLength();\\n error InvalidPublicKeyLength();\\n error MaxValueExceeded();\\n error NewBlockPeriodIsBelowMinimum();\\n error NoFeeDeclared();\\n error NotAuthorized();\\n error OperatorAlreadyExists();\\n error OperatorDoesNotExist();\\n error OperatorsListNotUnique();\\n error SameFeeChangeNotAllowed();\\n error TargetModuleDoesNotExist();\\n error TokenTransferFailed();\\n error UnsortedOperatorsList();\\n error ValidatorAlreadyExists();\\n error ValidatorDoesNotExist();\\n\\n event AdminChanged(address previousAdmin, address newAdmin);\\n event BeaconUpgraded(address indexed beacon);\\n event ClusterDeposited(\\n address indexed owner,\\n uint64[] operatorIds,\\n uint256 value,\\n Cluster cluster\\n );\\n event ClusterLiquidated(\\n address indexed owner,\\n uint64[] operatorIds,\\n Cluster cluster\\n );\\n event ClusterReactivated(\\n address indexed owner,\\n uint64[] operatorIds,\\n Cluster cluster\\n );\\n event ClusterWithdrawn(\\n address indexed owner,\\n uint64[] operatorIds,\\n uint256 value,\\n Cluster cluster\\n );\\n event DeclareOperatorFeePeriodUpdated(uint64 value);\\n event ExecuteOperatorFeePeriodUpdated(uint64 value);\\n event FeeRecipientAddressUpdated(\\n address indexed owner,\\n address recipientAddress\\n );\\n event Initialized(uint8 version);\\n event LiquidationThresholdPeriodUpdated(uint64 value);\\n event MinimumLiquidationCollateralUpdated(uint256 value);\\n event NetworkEarningsWithdrawn(uint256 value, address recipient);\\n event NetworkFeeUpdated(uint256 oldFee, uint256 newFee);\\n event OperatorAdded(\\n uint64 indexed operatorId,\\n address indexed owner,\\n bytes publicKey,\\n uint256 fee\\n );\\n event OperatorFeeDeclarationCancelled(\\n address indexed owner,\\n uint64 indexed operatorId\\n );\\n event OperatorFeeDeclared(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 blockNumber,\\n uint256 fee\\n );\\n event OperatorFeeExecuted(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 blockNumber,\\n uint256 fee\\n );\\n event OperatorFeeIncreaseLimitUpdated(uint64 value);\\n event OperatorMaximumFeeUpdated(uint64 maxFee);\\n event OperatorRemoved(uint64 indexed operatorId);\\n event OperatorWhitelistUpdated(\\n uint64 indexed operatorId,\\n address whitelisted\\n );\\n event OperatorWithdrawn(\\n address indexed owner,\\n uint64 indexed operatorId,\\n uint256 value\\n );\\n event OwnershipTransferStarted(\\n address indexed previousOwner,\\n address indexed newOwner\\n );\\n event OwnershipTransferred(\\n address indexed previousOwner,\\n address indexed newOwner\\n );\\n event Upgraded(address indexed implementation);\\n event ValidatorAdded(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey,\\n bytes shares,\\n Cluster cluster\\n );\\n event ValidatorExited(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey\\n );\\n event ValidatorRemoved(\\n address indexed owner,\\n uint64[] operatorIds,\\n bytes publicKey,\\n Cluster cluster\\n );\\n\\n fallback() external;\\n\\n function acceptOwnership() external;\\n\\n function cancelDeclaredOperatorFee(uint64 operatorId) external;\\n\\n function declareOperatorFee(uint64 operatorId, uint256 fee) external;\\n\\n function deposit(\\n address clusterOwner,\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function executeOperatorFee(uint64 operatorId) external;\\n\\n function exitValidator(bytes memory publicKey, uint64[] memory operatorIds)\\n external;\\n\\n function getVersion() external pure returns (string memory version);\\n\\n function initialize(\\n address token_,\\n address ssvOperators_,\\n address ssvClusters_,\\n address ssvDAO_,\\n address ssvViews_,\\n uint64 minimumBlocksBeforeLiquidation_,\\n uint256 minimumLiquidationCollateral_,\\n uint32 validatorsPerOperatorLimit_,\\n uint64 declareOperatorFeePeriod_,\\n uint64 executeOperatorFeePeriod_,\\n uint64 operatorMaxFeeIncrease_\\n ) external;\\n\\n function liquidate(\\n address clusterOwner,\\n uint64[] memory operatorIds,\\n Cluster memory cluster\\n ) external;\\n\\n function owner() external view returns (address);\\n\\n function pendingOwner() external view returns (address);\\n\\n function proxiableUUID() external view returns (bytes32);\\n\\n function reactivate(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function reduceOperatorFee(uint64 operatorId, uint256 fee) external;\\n\\n function registerOperator(bytes memory publicKey, uint256 fee)\\n external\\n returns (uint64 id);\\n\\n function registerValidator(\\n bytes memory publicKey,\\n uint64[] memory operatorIds,\\n bytes memory sharesData,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function removeOperator(uint64 operatorId) external;\\n\\n function removeValidator(\\n bytes memory publicKey,\\n uint64[] memory operatorIds,\\n Cluster memory cluster\\n ) external;\\n\\n function renounceOwnership() external;\\n\\n function setFeeRecipientAddress(address recipientAddress) external;\\n\\n function setOperatorWhitelist(uint64 operatorId, address whitelisted)\\n external;\\n\\n function transferOwnership(address newOwner) external;\\n\\n function updateDeclareOperatorFeePeriod(uint64 timeInSeconds) external;\\n\\n function updateExecuteOperatorFeePeriod(uint64 timeInSeconds) external;\\n\\n function updateLiquidationThresholdPeriod(uint64 blocks) external;\\n\\n function updateMaximumOperatorFee(uint64 maxFee) external;\\n\\n function updateMinimumLiquidationCollateral(uint256 amount) external;\\n\\n function updateModule(uint8 moduleId, address moduleAddress) external;\\n\\n function updateNetworkFee(uint256 fee) external;\\n\\n function updateOperatorFeeIncreaseLimit(uint64 percentage) external;\\n\\n function upgradeTo(address newImplementation) external;\\n\\n function upgradeToAndCall(address newImplementation, bytes memory data)\\n external\\n payable;\\n\\n function withdraw(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external;\\n\\n function withdrawAllOperatorEarnings(uint64 operatorId) external;\\n\\n function withdrawNetworkEarnings(uint256 amount) external;\\n\\n function withdrawOperatorEarnings(uint64 operatorId, uint256 amount)\\n external;\\n}\\n\",\"keccak256\":\"0x76e2c5148727b72752939b06fee7abc1f732c18970b8c7db7fe7cdfe74629d36\",\"license\":\"MIT\"},\"contracts/interfaces/IStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Platform interface to integrate with lending platform like Compound, AAVE etc.\\n */\\ninterface IStrategy {\\n /**\\n * @dev Deposit the given asset to platform\\n * @param _asset asset address\\n * @param _amount Amount to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external;\\n\\n /**\\n * @dev Deposit the entire balance of all supported assets in the Strategy\\n * to the platform\\n */\\n function depositAll() external;\\n\\n /**\\n * @dev Withdraw given asset from Lending platform\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external;\\n\\n /**\\n * @dev Liquidate all assets in strategy and return them to Vault.\\n */\\n function withdrawAll() external;\\n\\n /**\\n * @dev Returns the current balance of the given asset.\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n returns (uint256 balance);\\n\\n /**\\n * @dev Returns bool indicating whether strategy supports asset.\\n */\\n function supportsAsset(address _asset) external view returns (bool);\\n\\n /**\\n * @dev Collect reward tokens from the Strategy.\\n */\\n function collectRewardTokens() external;\\n\\n /**\\n * @dev The address array of the reward tokens for the Strategy.\\n */\\n function getRewardTokenAddresses() external view returns (address[] memory);\\n}\\n\",\"keccak256\":\"0xb291e409a9b95527f9ed19cd6bff8eeb9921a21c1f5194a48c0bb9ce6613959a\",\"license\":\"MIT\"},\"contracts/interfaces/IVault.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { VaultStorage } from \\\"../vault/VaultStorage.sol\\\";\\n\\ninterface IVault {\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Governable.sol\\n function transferGovernance(address _newGovernor) external;\\n\\n function claimGovernance() external;\\n\\n function governor() external view returns (address);\\n\\n // VaultAdmin.sol\\n function setPriceProvider(address _priceProvider) external;\\n\\n function priceProvider() external view returns (address);\\n\\n function setRedeemFeeBps(uint256 _redeemFeeBps) external;\\n\\n function redeemFeeBps() external view returns (uint256);\\n\\n function setVaultBuffer(uint256 _vaultBuffer) external;\\n\\n function vaultBuffer() external view returns (uint256);\\n\\n function setAutoAllocateThreshold(uint256 _threshold) external;\\n\\n function autoAllocateThreshold() external view returns (uint256);\\n\\n function setRebaseThreshold(uint256 _threshold) external;\\n\\n function rebaseThreshold() external view returns (uint256);\\n\\n function setStrategistAddr(address _address) external;\\n\\n function strategistAddr() external view returns (address);\\n\\n function setMaxSupplyDiff(uint256 _maxSupplyDiff) external;\\n\\n function maxSupplyDiff() external view returns (uint256);\\n\\n function setTrusteeAddress(address _address) external;\\n\\n function trusteeAddress() external view returns (address);\\n\\n function setTrusteeFeeBps(uint256 _basis) external;\\n\\n function trusteeFeeBps() external view returns (uint256);\\n\\n function ousdMetaStrategy() external view returns (address);\\n\\n function setSwapper(address _swapperAddr) external;\\n\\n function setSwapAllowedUndervalue(uint16 _percentageBps) external;\\n\\n function setOracleSlippage(address _asset, uint16 _allowedOracleSlippageBps)\\n external;\\n\\n function supportAsset(address _asset, uint8 _supportsAsset) external;\\n\\n function approveStrategy(address _addr) external;\\n\\n function removeStrategy(address _addr) external;\\n\\n function setAssetDefaultStrategy(address _asset, address _strategy)\\n external;\\n\\n function assetDefaultStrategies(address _asset)\\n external\\n view\\n returns (address);\\n\\n function pauseRebase() external;\\n\\n function unpauseRebase() external;\\n\\n function rebasePaused() external view returns (bool);\\n\\n function pauseCapital() external;\\n\\n function unpauseCapital() external;\\n\\n function capitalPaused() external view returns (bool);\\n\\n function transferToken(address _asset, uint256 _amount) external;\\n\\n function priceUnitMint(address asset) external view returns (uint256);\\n\\n function priceUnitRedeem(address asset) external view returns (uint256);\\n\\n function withdrawAllFromStrategy(address _strategyAddr) external;\\n\\n function withdrawAllFromStrategies() external;\\n\\n function withdrawFromStrategy(\\n address _strategyFromAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n function depositToStrategy(\\n address _strategyToAddress,\\n address[] calldata _assets,\\n uint256[] calldata _amounts\\n ) external;\\n\\n // VaultCore.sol\\n function mint(\\n address _asset,\\n uint256 _amount,\\n uint256 _minimumOusdAmount\\n ) external;\\n\\n function mintForStrategy(uint256 _amount) external;\\n\\n function redeem(uint256 _amount, uint256 _minimumUnitAmount) external;\\n\\n function burnForStrategy(uint256 _amount) external;\\n\\n function redeemAll(uint256 _minimumUnitAmount) external;\\n\\n function allocate() external;\\n\\n function rebase() external;\\n\\n function swapCollateral(\\n address fromAsset,\\n address toAsset,\\n uint256 fromAssetAmount,\\n uint256 minToAssetAmount,\\n bytes calldata data\\n ) external returns (uint256 toAssetAmount);\\n\\n function totalValue() external view returns (uint256 value);\\n\\n function checkBalance(address _asset) external view returns (uint256);\\n\\n function calculateRedeemOutputs(uint256 _amount)\\n external\\n view\\n returns (uint256[] memory);\\n\\n function getAssetCount() external view returns (uint256);\\n\\n function getAssetConfig(address _asset)\\n external\\n view\\n returns (VaultStorage.Asset memory config);\\n\\n function getAllAssets() external view returns (address[] memory);\\n\\n function getStrategyCount() external view returns (uint256);\\n\\n function swapper() external view returns (address);\\n\\n function allowedSwapUndervalue() external view returns (uint256);\\n\\n function getAllStrategies() external view returns (address[] memory);\\n\\n function isSupportedAsset(address _asset) external view returns (bool);\\n\\n function netOusdMintForStrategyThreshold() external view returns (uint256);\\n\\n function setOusdMetaStrategy(address _ousdMetaStrategy) external;\\n\\n function setNetOusdMintForStrategyThreshold(uint256 _threshold) external;\\n\\n function netOusdMintedForStrategy() external view returns (int256);\\n\\n function weth() external view returns (address);\\n\\n function cacheWETHAssetIndex() external;\\n\\n function wethAssetIndex() external view returns (uint256);\\n\\n function initialize(address, address) external;\\n\\n function setAdminImpl(address) external;\\n}\\n\",\"keccak256\":\"0xe8ab2f09127dc86bda14d2ad7f58d4f5ef214959101742f0dd977be3599f9d5f\",\"license\":\"MIT\"},\"contracts/interfaces/IWETH9.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\ninterface IWETH9 {\\n event Approval(address indexed src, address indexed guy, uint256 wad);\\n event Deposit(address indexed dst, uint256 wad);\\n event Transfer(address indexed src, address indexed dst, uint256 wad);\\n event Withdrawal(address indexed src, uint256 wad);\\n\\n function allowance(address, address) external view returns (uint256);\\n\\n function approve(address guy, uint256 wad) external returns (bool);\\n\\n function balanceOf(address) external view returns (uint256);\\n\\n function decimals() external view returns (uint8);\\n\\n function deposit() external payable;\\n\\n function name() external view returns (string memory);\\n\\n function symbol() external view returns (string memory);\\n\\n function totalSupply() external view returns (uint256);\\n\\n function transfer(address dst, uint256 wad) external returns (bool);\\n\\n function transferFrom(\\n address src,\\n address dst,\\n uint256 wad\\n ) external returns (bool);\\n\\n function withdraw(uint256 wad) external;\\n}\\n\",\"keccak256\":\"0x05b7dce6c24d3cd4e48b5c6346d86e5e40ecc3291bcdf3f3ef091c98fc826519\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/FeeAccumulator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\n\\n/**\\n * @title Fee Accumulator for Native Staking SSV Strategy\\n * @notice Receives execution rewards which includes tx fees and\\n * MEV rewards like tx priority and tx ordering.\\n * It does NOT include swept ETH from beacon chain consensus rewards or full validator withdrawals.\\n * @author Origin Protocol Inc\\n */\\ncontract FeeAccumulator is Governable {\\n /// @notice The address of the Native Staking Strategy\\n address public immutable STRATEGY;\\n\\n /**\\n * @param _strategy Address of the Native Staking Strategy\\n */\\n constructor(address _strategy) {\\n STRATEGY = _strategy;\\n }\\n\\n /**\\n * @notice sends all ETH in this FeeAccumulator contract to the Native Staking Strategy.\\n * @return eth The amount of execution rewards that were sent to the Native Staking Strategy\\n */\\n function collect() external returns (uint256 eth) {\\n require(msg.sender == STRATEGY, \\\"Caller is not the Strategy\\\");\\n\\n eth = address(this).balance;\\n if (eth > 0) {\\n // Send the ETH to the Native Staking Strategy\\n Address.sendValue(payable(STRATEGY), eth);\\n }\\n }\\n}\\n\",\"keccak256\":\"0xf47bcc46ce70f649f061bec3d2303f376a15700ba18fe471fba823f60bdfed8b\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/NativeStakingSSVStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { InitializableAbstractStrategy } from \\\"../../utils/InitializableAbstractStrategy.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\nimport { FeeAccumulator } from \\\"./FeeAccumulator.sol\\\";\\nimport { ValidatorAccountant } from \\\"./ValidatorAccountant.sol\\\";\\n\\nstruct ValidatorStakeData {\\n bytes pubkey;\\n bytes signature;\\n bytes32 depositDataRoot;\\n}\\n\\n/// @title Native Staking SSV Strategy\\n/// @notice Strategy to deploy funds into DVT validators powered by the SSV Network\\n/// @author Origin Protocol Inc\\ncontract NativeStakingSSVStrategy is\\n ValidatorAccountant,\\n InitializableAbstractStrategy\\n{\\n using SafeERC20 for IERC20;\\n\\n /// @notice SSV ERC20 token that serves as a payment for operating SSV validators\\n address public immutable SSV_TOKEN_ADDRESS;\\n /// @notice Fee collector address\\n /// @dev this address will receive Execution layer rewards - These are rewards earned for\\n /// executing transactions on the Ethereum network as part of block proposals. They include\\n /// priority fees (fees paid by users for their transactions to be included) and MEV rewards\\n /// (rewards for arranging transactions in a way that benefits the validator).\\n address public immutable FEE_ACCUMULATOR_ADDRESS;\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /// @param _baseConfig Base strategy config with platformAddress (ERC-4626 Vault contract), eg sfrxETH or sDAI,\\n /// and vaultAddress (OToken Vault contract), eg VaultProxy or OETHVaultProxy\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _ssvToken Address of the Erc20 SSV Token contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n /// @param _feeAccumulator Address of the fee accumulator receiving execution layer validator rewards\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n constructor(\\n BaseStrategyConfig memory _baseConfig,\\n address _wethAddress,\\n address _ssvToken,\\n address _ssvNetwork,\\n address _feeAccumulator,\\n address _beaconChainDepositContract\\n )\\n InitializableAbstractStrategy(_baseConfig)\\n ValidatorAccountant(\\n _wethAddress,\\n _baseConfig.vaultAddress,\\n _beaconChainDepositContract,\\n _ssvNetwork\\n )\\n {\\n SSV_TOKEN_ADDRESS = _ssvToken;\\n FEE_ACCUMULATOR_ADDRESS = _feeAccumulator;\\n }\\n\\n /// @notice initialize function, to set up initial internal state\\n /// @param _rewardTokenAddresses Address of reward token for platform\\n /// @param _assets Addresses of initial supported assets\\n /// @param _pTokens Platform Token corresponding addresses\\n function initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) external onlyGovernor initializer {\\n InitializableAbstractStrategy._initialize(\\n _rewardTokenAddresses,\\n _assets,\\n _pTokens\\n );\\n }\\n\\n /// @dev Convert accumulated ETH to WETH and send to the Harvester.\\n /// Will revert if the strategy is paused for accounting.\\n function _collectRewardTokens() internal override whenNotPaused {\\n // collect ETH from execution rewards from the fee accumulator\\n uint256 executionRewards = FeeAccumulator(FEE_ACCUMULATOR_ADDRESS)\\n .collect();\\n\\n // total ETH rewards to be harvested = execution rewards + consensus rewards\\n uint256 ethRewards = executionRewards + consensusRewards;\\n\\n require(\\n address(this).balance >= ethRewards,\\n \\\"insufficient eth balance\\\"\\n );\\n\\n if (ethRewards > 0) {\\n // reset the counter keeping track of beacon chain consensus rewards\\n consensusRewards = 0;\\n\\n // Convert ETH rewards to WETH\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRewards }();\\n\\n emit RewardTokenCollected(\\n harvesterAddress,\\n WETH_TOKEN_ADDRESS,\\n ethRewards\\n );\\n IERC20(WETH_TOKEN_ADDRESS).safeTransfer(\\n harvesterAddress,\\n ethRewards\\n );\\n }\\n }\\n\\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\\n /// It just checks the asset is WETH and emits the Deposit event.\\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n /// @param _asset Address of asset to deposit. Has to be WETH.\\n /// @param _amount Amount of assets that were transferred to the strategy by the vault.\\n function deposit(address _asset, uint256 _amount)\\n external\\n override\\n onlyVault\\n nonReentrant\\n {\\n require(_asset == WETH_TOKEN_ADDRESS, \\\"Unsupported asset\\\");\\n _deposit(_asset, _amount);\\n }\\n\\n /// @dev Deposit WETH to this strategy so it can later be staked into a validator.\\n /// @param _asset Address of WETH\\n /// @param _amount Amount of WETH to deposit\\n function _deposit(address _asset, uint256 _amount) internal {\\n require(_amount > 0, \\\"Must deposit something\\\");\\n /*\\n * We could do a check here that would revert when \\\"_amount % 32 ether != 0\\\". With the idea of\\n * not allowing deposits that will result in WETH sitting on the strategy after all the possible batches\\n * of 32ETH have been staked.\\n * But someone could mess with our strategy by sending some WETH to it. And we might want to deposit just\\n * enough WETH to add it up to 32 so it can be staked. For that reason the check is left out.\\n *\\n * WETH sitting on the strategy won't interfere with the accounting since accounting only operates on ETH.\\n */\\n emit Deposit(_asset, address(0), _amount);\\n }\\n\\n /// @notice Unlike other strategies, this does not deposit assets into the underlying platform.\\n /// It just emits the Deposit event.\\n /// To deposit WETH into validators `registerSsvValidator` and `stakeEth` must be used.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n function depositAll() external override onlyVault nonReentrant {\\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n if (wethBalance > 0) {\\n _deposit(WETH_TOKEN_ADDRESS, wethBalance);\\n }\\n }\\n\\n /// @notice Withdraw WETH from this contract. Used only if some WETH for is lingering on the contract. That\\n /// can happen when:\\n /// - the deposit was not a multiple of 32 WETH\\n /// - someone sent WETH directly to this contract\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n /// @param _recipient Address to receive withdrawn assets\\n /// @param _asset WETH to withdraw\\n /// @param _amount Amount of WETH to withdraw\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external override onlyVault nonReentrant {\\n _withdraw(_recipient, _asset, _amount);\\n }\\n\\n function _withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) internal {\\n require(_amount > 0, \\\"Must withdraw something\\\");\\n require(_recipient != address(0), \\\"Must specify recipient\\\");\\n\\n emit Withdrawal(_asset, address(0), _amount);\\n IERC20(_asset).safeTransfer(_recipient, _amount);\\n }\\n\\n /// @notice transfer all WETH deposits back to the vault.\\n /// This does not withdraw from the validators. That has to be done separately with the\\n /// `exitSsvValidator` and `removeSsvValidator` operations.\\n /// This does not withdraw any execution rewards from the FeeAccumulator or\\n /// consensus rewards in this strategy.\\n /// Any ETH in this strategy that was swept from a full validator withdrawal will not be withdrawn.\\n /// ETH from full validator withdrawals is sent to the Vault using `doAccounting`.\\n /// Will NOT revert if the strategy is paused from an accounting failure.\\n function withdrawAll() external override onlyVaultOrGovernor nonReentrant {\\n uint256 wethBalance = IERC20(WETH_TOKEN_ADDRESS).balanceOf(\\n address(this)\\n );\\n if (wethBalance > 0) {\\n _withdraw(vaultAddress, WETH_TOKEN_ADDRESS, wethBalance);\\n }\\n }\\n\\n function _abstractSetPToken(address _asset, address) internal override {}\\n\\n /// @notice Returns the total value of (W)ETH that is staked to the validators\\n /// and WETH deposits that are still to be staked.\\n /// This does not include ETH from consensus rewards sitting in this strategy\\n /// or ETH from MEV rewards in the FeeAccumulator. These rewards are harvested\\n /// and sent to the Dripper so will eventually be sent to the Vault as WETH.\\n /// @param _asset Address of weth asset\\n /// @return balance Total value of (W)ETH\\n function checkBalance(address _asset)\\n external\\n view\\n override\\n returns (uint256 balance)\\n {\\n require(_asset == WETH_TOKEN_ADDRESS, \\\"Unsupported asset\\\");\\n\\n balance =\\n // add the ETH that has been staked in validators\\n activeDepositedValidators *\\n 32 ether +\\n // add the WETH in the strategy from deposits that are still to be staked\\n IERC20(WETH_TOKEN_ADDRESS).balanceOf(address(this));\\n }\\n\\n function pause() external onlyStrategist {\\n _pause();\\n }\\n\\n /// @notice Returns bool indicating whether asset is supported by strategy.\\n /// @param _asset The address of the asset token.\\n function supportsAsset(address _asset) public view override returns (bool) {\\n return _asset == WETH_TOKEN_ADDRESS;\\n }\\n\\n /// @notice Approves the SSV Network contract to transfer SSV tokens for deposits\\n function safeApproveAllTokens() external override {\\n /// @dev Approves the SSV Network contract to transfer SSV tokens for deposits\\n IERC20(SSV_TOKEN_ADDRESS).approve(\\n SSV_NETWORK_ADDRESS,\\n type(uint256).max\\n );\\n }\\n\\n /**\\n * @notice Only accept ETH from the FeeAccumulator and the WETH contract - required when\\n * unwrapping WETH just before staking it to the validator\\n * @dev don't want to receive donations from anyone else as this will\\n * mess with the accounting of the consensus rewards and validator full withdrawals\\n */\\n receive() external payable {\\n require(\\n msg.sender == FEE_ACCUMULATOR_ADDRESS ||\\n msg.sender == WETH_TOKEN_ADDRESS,\\n \\\"eth not from allowed contracts\\\"\\n );\\n }\\n}\\n\",\"keccak256\":\"0x16d14755655e07e98a4758a1328a8117192b3cb8a4c74725b67c2584560fcb2d\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/ValidatorAccountant.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { ValidatorRegistrator } from \\\"./ValidatorRegistrator.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\n\\n/// @title Validator Accountant\\n/// @notice Attributes the ETH swept from beacon chain validators to this strategy contract\\n/// as either full or partial withdrawals. Partial withdrawals being consensus rewards.\\n/// Full withdrawals are from exited validators.\\n/// @author Origin Protocol Inc\\nabstract contract ValidatorAccountant is ValidatorRegistrator {\\n /// @notice The maximum amount of ETH that can be staked by a validator\\n /// @dev this can change in the future with EIP-7251, Increase the MAX_EFFECTIVE_BALANCE\\n uint256 public constant MAX_STAKE = 32 ether;\\n\\n /// @notice Keeps track of the total consensus rewards swept from the beacon chain\\n uint256 public consensusRewards = 0;\\n\\n /// @notice start of fuse interval\\n uint256 public fuseIntervalStart = 0;\\n /// @notice end of fuse interval\\n uint256 public fuseIntervalEnd = 0;\\n\\n uint256[50] private __gap;\\n\\n event FuseIntervalUpdated(uint256 start, uint256 end);\\n event AccountingFullyWithdrawnValidator(\\n uint256 noOfValidators,\\n uint256 remainingValidators,\\n uint256 wethSentToVault\\n );\\n event AccountingValidatorSlashed(\\n uint256 remainingValidators,\\n uint256 wethSentToVault\\n );\\n event AccountingConsensusRewards(uint256 amount);\\n\\n event AccountingManuallyFixed(\\n int256 validatorsDelta,\\n int256 consensusRewardsDelta,\\n uint256 wethToVault\\n );\\n\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _vaultAddress Address of the Vault\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n constructor(\\n address _wethAddress,\\n address _vaultAddress,\\n address _beaconChainDepositContract,\\n address _ssvNetwork\\n )\\n ValidatorRegistrator(\\n _wethAddress,\\n _vaultAddress,\\n _beaconChainDepositContract,\\n _ssvNetwork\\n )\\n {}\\n\\n /// @notice set fuse interval values\\n function setFuseInterval(\\n uint256 _fuseIntervalStart,\\n uint256 _fuseIntervalEnd\\n ) external onlyGovernor {\\n require(\\n _fuseIntervalStart < _fuseIntervalEnd &&\\n _fuseIntervalStart < 32 ether &&\\n _fuseIntervalEnd < 32 ether &&\\n _fuseIntervalEnd - _fuseIntervalStart >= 4 ether,\\n \\\"incorrect fuse interval\\\"\\n );\\n\\n emit FuseIntervalUpdated(_fuseIntervalStart, _fuseIntervalEnd);\\n\\n fuseIntervalStart = _fuseIntervalStart;\\n fuseIntervalEnd = _fuseIntervalEnd;\\n }\\n\\n /* solhint-disable max-line-length */\\n /// This notion page offers a good explanation of how the accounting functions\\n /// https://www.notion.so/originprotocol/Limited-simplified-native-staking-accounting-67a217c8420d40678eb943b9da0ee77d\\n /// In short, after dividing by 32, if the ETH remaining on the contract falls between 0 and fuseIntervalStart,\\n /// the accounting function will treat that ETH as Beacon chain consensus rewards.\\n /// On the contrary, if after dividing by 32, the ETH remaining on the contract falls between fuseIntervalEnd and 32,\\n /// the accounting function will treat that as a validator slashing.\\n /// @notice Perform the accounting attributing beacon chain ETH to either full or partial withdrawals. Returns true when\\n /// accounting is valid and fuse isn't \\\"blown\\\". Returns false when fuse is blown.\\n /// @dev This function could in theory be permission-less but lets allow only the Registrator (Defender Action) to call it\\n /// for now.\\n /// @return accountingValid true if accounting was successful, false if fuse is blown\\n /* solhint-enable max-line-length */\\n function doAccounting()\\n external\\n onlyRegistrator\\n whenNotPaused\\n returns (bool accountingValid)\\n {\\n // pause the accounting on failure\\n accountingValid = _doAccounting(true);\\n }\\n\\n function _doAccounting(bool pauseOnFail)\\n internal\\n returns (bool accountingValid)\\n {\\n if (address(this).balance < consensusRewards) {\\n return _failAccounting(pauseOnFail);\\n }\\n\\n // Calculate all the new ETH that has been swept to the contract since the last accounting\\n uint256 newSweptETH = address(this).balance - consensusRewards;\\n accountingValid = true;\\n\\n // send the ETH that is from fully withdrawn validators to the Vault\\n if (newSweptETH >= MAX_STAKE) {\\n uint256 fullyWithdrawnValidators = newSweptETH / MAX_STAKE;\\n if (activeDepositedValidators < fullyWithdrawnValidators) {\\n return _failAccounting(pauseOnFail);\\n }\\n activeDepositedValidators -= fullyWithdrawnValidators;\\n\\n uint256 wethToVault = MAX_STAKE * fullyWithdrawnValidators;\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: wethToVault }();\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, wethToVault);\\n\\n emit AccountingFullyWithdrawnValidator(\\n fullyWithdrawnValidators,\\n activeDepositedValidators,\\n wethToVault\\n );\\n }\\n\\n uint256 ethRemaining = address(this).balance - consensusRewards;\\n // should be less than a whole validator stake\\n require(ethRemaining < 32 ether, \\\"unexpected accounting\\\");\\n\\n // If no Beacon chain consensus rewards swept\\n if (ethRemaining == 0) {\\n // do nothing\\n return accountingValid;\\n }\\n // Beacon chain consensus rewards swept (partial validator withdrawals)\\n else if (ethRemaining < fuseIntervalStart) {\\n // solhint-disable-next-line reentrancy\\n consensusRewards += ethRemaining;\\n emit AccountingConsensusRewards(ethRemaining);\\n }\\n // Beacon chain consensus rewards swept but also a slashed validator fully exited\\n else if (ethRemaining > fuseIntervalEnd) {\\n IWETH9(WETH_TOKEN_ADDRESS).deposit{ value: ethRemaining }();\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(VAULT_ADDRESS, ethRemaining);\\n activeDepositedValidators -= 1;\\n\\n emit AccountingValidatorSlashed(\\n activeDepositedValidators,\\n ethRemaining\\n );\\n }\\n // Oh no... Fuse is blown. The Strategist needs to adjust the accounting values.\\n else {\\n return _failAccounting(pauseOnFail);\\n }\\n }\\n\\n /// @dev pause any further accounting if required and return false\\n function _failAccounting(bool pauseOnFail)\\n internal\\n returns (bool accountingValid)\\n {\\n // pause if not already\\n if (pauseOnFail) {\\n _pause();\\n }\\n // fail the accounting\\n accountingValid = false;\\n }\\n\\n /// @notice Allow the Strategist to fix the accounting of this strategy and unpause.\\n /// @param _validatorsDelta adjust the active validators by plus one, minus one or unchanged with zero\\n /// @param _wethToVaultAmount the amount of WETH to be sent to the Vault\\n /// @param _consensusRewardsDelta adjust the accounted for consensus rewards up or down\\n function manuallyFixAccounting(\\n int256 _validatorsDelta,\\n int256 _consensusRewardsDelta,\\n uint256 _wethToVaultAmount\\n ) external onlyStrategist whenPaused {\\n require(\\n _validatorsDelta >= -3 &&\\n _validatorsDelta <= 3 &&\\n // new value must be positive\\n int256(activeDepositedValidators) + _validatorsDelta >= 0,\\n \\\"invalid validatorsDelta\\\"\\n );\\n require(\\n _consensusRewardsDelta >= -332 ether &&\\n _consensusRewardsDelta <= 332 ether &&\\n // new value must be positive\\n int256(consensusRewards) + _consensusRewardsDelta >= 0,\\n \\\"invalid consensusRewardsDelta\\\"\\n );\\n require(_wethToVaultAmount <= 32 ether, \\\"invalid wethToVaultAmount\\\");\\n\\n emit AccountingManuallyFixed(\\n _validatorsDelta,\\n _consensusRewardsDelta,\\n _wethToVaultAmount\\n );\\n\\n activeDepositedValidators = uint256(\\n int256(activeDepositedValidators) + _validatorsDelta\\n );\\n consensusRewards = uint256(\\n int256(consensusRewards) + _consensusRewardsDelta\\n );\\n if (_wethToVaultAmount > 0) {\\n IWETH9(WETH_TOKEN_ADDRESS).transfer(\\n VAULT_ADDRESS,\\n _wethToVaultAmount\\n );\\n }\\n\\n // rerun the accounting to see if it has now been fixed.\\n // Do not pause the accounting on failure as it is already paused\\n require(_doAccounting(false), \\\"fuse still blown\\\");\\n\\n // unpause since doAccounting was successful\\n _unpause();\\n }\\n}\\n\",\"keccak256\":\"0xc6c306bde6b18189944f3d03fc82996b2e0c54b3a2882ee8d0fece0d71949e11\",\"license\":\"MIT\"},\"contracts/strategies/NativeStaking/ValidatorRegistrator.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Pausable } from \\\"@openzeppelin/contracts/security/Pausable.sol\\\";\\nimport { Governable } from \\\"../../governance/Governable.sol\\\";\\nimport { IDepositContract } from \\\"../../interfaces/IDepositContract.sol\\\";\\nimport { IVault } from \\\"../../interfaces/IVault.sol\\\";\\nimport { IWETH9 } from \\\"../../interfaces/IWETH9.sol\\\";\\nimport { ISSVNetwork, Cluster } from \\\"../../interfaces/ISSVNetwork.sol\\\";\\n\\nstruct ValidatorStakeData {\\n bytes pubkey;\\n bytes signature;\\n bytes32 depositDataRoot;\\n}\\n\\n/**\\n * @title Registrator of the validators\\n * @notice This contract implements all the required functionality to register, exit and remove validators.\\n * @author Origin Protocol Inc\\n */\\nabstract contract ValidatorRegistrator is Governable, Pausable {\\n /// @notice The address of the Wrapped ETH (WETH) token contract\\n address public immutable WETH_TOKEN_ADDRESS;\\n /// @notice The address of the beacon chain deposit contract\\n address public immutable BEACON_CHAIN_DEPOSIT_CONTRACT;\\n /// @notice The address of the SSV Network contract used to interface with\\n address public immutable SSV_NETWORK_ADDRESS;\\n /// @notice Address of the OETH Vault proxy contract\\n address public immutable VAULT_ADDRESS;\\n\\n /// @notice Address of the registrator - allowed to register, exit and remove validators\\n address public validatorRegistrator;\\n /// @notice The number of validators that have 32 (!) ETH actively deposited. When a new deposit\\n /// to a validator happens this number increases, when a validator exit is detected this number\\n /// decreases.\\n uint256 public activeDepositedValidators;\\n /// @notice State of the validators keccak256(pubKey) => state\\n mapping(bytes32 => VALIDATOR_STATE) public validatorsStates;\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n enum VALIDATOR_STATE {\\n REGISTERED, // validator is registered on the SSV network\\n STAKED, // validator has funds staked\\n EXITING, // exit message has been posted and validator is in the process of exiting\\n EXIT_COMPLETE // validator has funds withdrawn to the EigenPod and is removed from the SSV\\n }\\n\\n event RegistratorChanged(address newAddress);\\n event ETHStaked(bytes pubkey, uint256 amount, bytes withdrawal_credentials);\\n event SSVValidatorRegistered(bytes pubkey, uint64[] operatorIds);\\n event SSVValidatorExitInitiated(bytes pubkey, uint64[] operatorIds);\\n event SSVValidatorExitCompleted(bytes pubkey, uint64[] operatorIds);\\n\\n /// @dev Throws if called by any account other than the Registrator\\n modifier onlyRegistrator() {\\n require(\\n msg.sender == validatorRegistrator,\\n \\\"Caller is not the Registrator\\\"\\n );\\n _;\\n }\\n\\n /// @dev Throws if called by any account other than the Strategist\\n modifier onlyStrategist() {\\n require(\\n msg.sender == IVault(VAULT_ADDRESS).strategistAddr(),\\n \\\"Caller is not the Strategist\\\"\\n );\\n _;\\n }\\n\\n /// @param _wethAddress Address of the Erc20 WETH Token contract\\n /// @param _vaultAddress Address of the Vault\\n /// @param _beaconChainDepositContract Address of the beacon chain deposit contract\\n /// @param _ssvNetwork Address of the SSV Network contract\\n constructor(\\n address _wethAddress,\\n address _vaultAddress,\\n address _beaconChainDepositContract,\\n address _ssvNetwork\\n ) {\\n WETH_TOKEN_ADDRESS = _wethAddress;\\n BEACON_CHAIN_DEPOSIT_CONTRACT = _beaconChainDepositContract;\\n SSV_NETWORK_ADDRESS = _ssvNetwork;\\n VAULT_ADDRESS = _vaultAddress;\\n }\\n\\n /// @notice Set the address of the registrator which can register, exit and remove validators\\n function setRegistrator(address _address) external onlyGovernor {\\n emit RegistratorChanged(_address);\\n validatorRegistrator = _address;\\n }\\n\\n /// @notice Stakes WETH to the node validators\\n /// @param validators A list of validator data needed to stake.\\n /// The `ValidatorStakeData` struct contains the pubkey, signature and depositDataRoot.\\n /// Only the registrator can call this function.\\n function stakeEth(ValidatorStakeData[] calldata validators)\\n external\\n onlyRegistrator\\n whenNotPaused\\n {\\n uint256 requiredETH = validators.length * 32 ether;\\n\\n // Check there is enough WETH from the deposits sitting in this strategy contract\\n require(\\n requiredETH <= IWETH9(WETH_TOKEN_ADDRESS).balanceOf(address(this)),\\n \\\"insufficient WETH\\\"\\n );\\n\\n // Convert required ETH from WETH\\n IWETH9(WETH_TOKEN_ADDRESS).withdraw(requiredETH);\\n\\n // For each validator\\n for (uint256 i = 0; i < validators.length; ) {\\n bytes32 pubkeyHash = keccak256(validators[i].pubkey);\\n VALIDATOR_STATE currentState = validatorsStates[pubkeyHash];\\n\\n require(\\n currentState == VALIDATOR_STATE.REGISTERED,\\n \\\"Validator not registered\\\"\\n );\\n\\n /* 0x01 to indicate that withdrawal credentials will contain an EOA address that the sweeping function\\n * can sweep funds to.\\n * bytes11(0) to fill up the required zeros\\n * remaining bytes20 are for the address\\n */\\n bytes memory withdrawal_credentials = abi.encodePacked(\\n bytes1(0x01),\\n bytes11(0),\\n address(this)\\n );\\n IDepositContract(BEACON_CHAIN_DEPOSIT_CONTRACT).deposit{\\n value: 32 ether\\n }(\\n validators[i].pubkey,\\n withdrawal_credentials,\\n validators[i].signature,\\n validators[i].depositDataRoot\\n );\\n\\n activeDepositedValidators += 1;\\n emit ETHStaked(\\n validators[i].pubkey,\\n 32 ether,\\n withdrawal_credentials\\n );\\n\\n validatorsStates[pubkeyHash] = VALIDATOR_STATE.STAKED;\\n\\n unchecked {\\n ++i;\\n }\\n }\\n }\\n\\n /// @notice Registers a new validator in the SSV Cluster.\\n /// Only the registrator can call this function.\\n function registerSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds,\\n bytes calldata sharesData,\\n uint256 amount,\\n Cluster calldata cluster\\n ) external onlyRegistrator whenNotPaused {\\n ISSVNetwork(SSV_NETWORK_ADDRESS).registerValidator(\\n publicKey,\\n operatorIds,\\n sharesData,\\n amount,\\n cluster\\n );\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.REGISTERED;\\n emit SSVValidatorRegistered(publicKey, operatorIds);\\n }\\n\\n /// @notice Exit a validator from the Beacon chain.\\n /// The staked ETH will eventually swept to this native staking strategy.\\n /// Only the registrator can call this function.\\n function exitSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds\\n ) external onlyRegistrator whenNotPaused {\\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\\n require(currentState == VALIDATOR_STATE.STAKED, \\\"Validator not staked\\\");\\n\\n ISSVNetwork(SSV_NETWORK_ADDRESS).exitValidator(publicKey, operatorIds);\\n emit SSVValidatorExitInitiated(publicKey, operatorIds);\\n\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXITING;\\n }\\n\\n /// @notice Remove a validator from the SSV Cluster.\\n /// Make sure `exitSsvValidator` is called before and the validate has exited the Beacon chain.\\n /// If removed before the validator has exited the beacon chain will result in the validator being slashed.\\n /// Only the registrator can call this function.\\n function removeSsvValidator(\\n bytes calldata publicKey,\\n uint64[] calldata operatorIds,\\n Cluster calldata cluster\\n ) external onlyRegistrator whenNotPaused {\\n VALIDATOR_STATE currentState = validatorsStates[keccak256(publicKey)];\\n require(\\n currentState == VALIDATOR_STATE.EXITING,\\n \\\"Validator not exiting\\\"\\n );\\n\\n ISSVNetwork(SSV_NETWORK_ADDRESS).removeValidator(\\n publicKey,\\n operatorIds,\\n cluster\\n );\\n emit SSVValidatorExitCompleted(publicKey, operatorIds);\\n\\n validatorsStates[keccak256(publicKey)] = VALIDATOR_STATE.EXIT_COMPLETE;\\n }\\n\\n /// @notice Deposits more SSV Tokens to the SSV Network contract which is used to pay the SSV Operators.\\n /// @dev A SSV cluster is defined by the SSVOwnerAddress and the set of operatorIds.\\n /// uses \\\"onlyStrategist\\\" modifier so continuous front-running can't DOS our maintenance service\\n /// that tries to top up SSV tokens.\\n /// @param cluster The SSV cluster details that must be derived from emitted events from the SSVNetwork contract.\\n function depositSSV(\\n uint64[] memory operatorIds,\\n uint256 amount,\\n Cluster memory cluster\\n ) external onlyStrategist {\\n ISSVNetwork(SSV_NETWORK_ADDRESS).deposit(\\n address(this),\\n operatorIds,\\n amount,\\n cluster\\n );\\n }\\n}\\n\",\"keccak256\":\"0x4bc23d19500e2d306fd546c4ab9c4c53292d4ef54392ec4f1ae62dd7601a3d24\",\"license\":\"MIT\"},\"contracts/token/OUSD.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OUSD Token Contract\\n * @dev ERC20 compatible contract for OUSD\\n * @dev Implements an elastic supply\\n * @author Origin Protocol Inc\\n */\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { InitializableERC20Detailed } from \\\"../utils/InitializableERC20Detailed.sol\\\";\\nimport { StableMath } from \\\"../utils/StableMath.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * NOTE that this is an ERC20 token but the invariant that the sum of\\n * balanceOf(x) for all x is not >= totalSupply(). This is a consequence of the\\n * rebasing design. Any integrations with OUSD should be aware.\\n */\\n\\ncontract OUSD is Initializable, InitializableERC20Detailed, Governable {\\n using SafeMath for uint256;\\n using StableMath for uint256;\\n\\n event TotalSupplyUpdatedHighres(\\n uint256 totalSupply,\\n uint256 rebasingCredits,\\n uint256 rebasingCreditsPerToken\\n );\\n event AccountRebasingEnabled(address account);\\n event AccountRebasingDisabled(address account);\\n\\n enum RebaseOptions {\\n NotSet,\\n OptOut,\\n OptIn\\n }\\n\\n uint256 private constant MAX_SUPPLY = ~uint128(0); // (2^128) - 1\\n uint256 public _totalSupply;\\n mapping(address => mapping(address => uint256)) private _allowances;\\n address public vaultAddress = address(0);\\n mapping(address => uint256) private _creditBalances;\\n uint256 private _rebasingCredits;\\n uint256 private _rebasingCreditsPerToken;\\n // Frozen address/credits are non rebasing (value is held in contracts which\\n // do not receive yield unless they explicitly opt in)\\n uint256 public nonRebasingSupply;\\n mapping(address => uint256) public nonRebasingCreditsPerToken;\\n mapping(address => RebaseOptions) public rebaseState;\\n mapping(address => uint256) public isUpgraded;\\n\\n uint256 private constant RESOLUTION_INCREASE = 1e9;\\n\\n function initialize(\\n string calldata _nameArg,\\n string calldata _symbolArg,\\n address _vaultAddress,\\n uint256 _initialCreditsPerToken\\n ) external onlyGovernor initializer {\\n InitializableERC20Detailed._initialize(_nameArg, _symbolArg, 18);\\n _rebasingCreditsPerToken = _initialCreditsPerToken;\\n vaultAddress = _vaultAddress;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault contract\\n */\\n modifier onlyVault() {\\n require(vaultAddress == msg.sender, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @return The total supply of OUSD.\\n */\\n function totalSupply() public view override returns (uint256) {\\n return _totalSupply;\\n }\\n\\n /**\\n * @return Low resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerToken() public view returns (uint256) {\\n return _rebasingCreditsPerToken / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return Low resolution total number of rebasing credits\\n */\\n function rebasingCredits() public view returns (uint256) {\\n return _rebasingCredits / RESOLUTION_INCREASE;\\n }\\n\\n /**\\n * @return High resolution rebasingCreditsPerToken\\n */\\n function rebasingCreditsPerTokenHighres() public view returns (uint256) {\\n return _rebasingCreditsPerToken;\\n }\\n\\n /**\\n * @return High resolution total number of rebasing credits\\n */\\n function rebasingCreditsHighres() public view returns (uint256) {\\n return _rebasingCredits;\\n }\\n\\n /**\\n * @dev Gets the balance of the specified address.\\n * @param _account Address to query the balance of.\\n * @return A uint256 representing the amount of base units owned by the\\n * specified address.\\n */\\n function balanceOf(address _account)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n if (_creditBalances[_account] == 0) return 0;\\n return\\n _creditBalances[_account].divPrecisely(_creditsPerToken(_account));\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @dev Backwards compatible with old low res credits per token.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256) Credit balance and credits per token of the\\n * address\\n */\\n function creditsBalanceOf(address _account)\\n public\\n view\\n returns (uint256, uint256)\\n {\\n uint256 cpt = _creditsPerToken(_account);\\n if (cpt == 1e27) {\\n // For a period before the resolution upgrade, we created all new\\n // contract accounts at high resolution. Since they are not changing\\n // as a result of this upgrade, we will return their true values\\n return (_creditBalances[_account], cpt);\\n } else {\\n return (\\n _creditBalances[_account] / RESOLUTION_INCREASE,\\n cpt / RESOLUTION_INCREASE\\n );\\n }\\n }\\n\\n /**\\n * @dev Gets the credits balance of the specified address.\\n * @param _account The address to query the balance of.\\n * @return (uint256, uint256, bool) Credit balance, credits per token of the\\n * address, and isUpgraded\\n */\\n function creditsBalanceOfHighres(address _account)\\n public\\n view\\n returns (\\n uint256,\\n uint256,\\n bool\\n )\\n {\\n return (\\n _creditBalances[_account],\\n _creditsPerToken(_account),\\n isUpgraded[_account] == 1\\n );\\n }\\n\\n /**\\n * @dev Transfer tokens to a specified address.\\n * @param _to the address to transfer to.\\n * @param _value the amount to be transferred.\\n * @return true on success.\\n */\\n function transfer(address _to, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(\\n _value <= balanceOf(msg.sender),\\n \\\"Transfer greater than balance\\\"\\n );\\n\\n _executeTransfer(msg.sender, _to, _value);\\n\\n emit Transfer(msg.sender, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Transfer tokens from one address to another.\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value The amount of tokens to be transferred.\\n */\\n function transferFrom(\\n address _from,\\n address _to,\\n uint256 _value\\n ) public override returns (bool) {\\n require(_to != address(0), \\\"Transfer to zero address\\\");\\n require(_value <= balanceOf(_from), \\\"Transfer greater than balance\\\");\\n\\n _allowances[_from][msg.sender] = _allowances[_from][msg.sender].sub(\\n _value\\n );\\n\\n _executeTransfer(_from, _to, _value);\\n\\n emit Transfer(_from, _to, _value);\\n\\n return true;\\n }\\n\\n /**\\n * @dev Update the count of non rebasing credits in response to a transfer\\n * @param _from The address you want to send tokens from.\\n * @param _to The address you want to transfer to.\\n * @param _value Amount of OUSD to transfer\\n */\\n function _executeTransfer(\\n address _from,\\n address _to,\\n uint256 _value\\n ) internal {\\n bool isNonRebasingTo = _isNonRebasingAccount(_to);\\n bool isNonRebasingFrom = _isNonRebasingAccount(_from);\\n\\n // Credits deducted and credited might be different due to the\\n // differing creditsPerToken used by each account\\n uint256 creditsCredited = _value.mulTruncate(_creditsPerToken(_to));\\n uint256 creditsDeducted = _value.mulTruncate(_creditsPerToken(_from));\\n\\n _creditBalances[_from] = _creditBalances[_from].sub(\\n creditsDeducted,\\n \\\"Transfer amount exceeds balance\\\"\\n );\\n _creditBalances[_to] = _creditBalances[_to].add(creditsCredited);\\n\\n if (isNonRebasingTo && !isNonRebasingFrom) {\\n // Transfer to non-rebasing account from rebasing account, credits\\n // are removed from the non rebasing tally\\n nonRebasingSupply = nonRebasingSupply.add(_value);\\n // Update rebasingCredits by subtracting the deducted amount\\n _rebasingCredits = _rebasingCredits.sub(creditsDeducted);\\n } else if (!isNonRebasingTo && isNonRebasingFrom) {\\n // Transfer to rebasing account from non-rebasing account\\n // Decreasing non-rebasing credits by the amount that was sent\\n nonRebasingSupply = nonRebasingSupply.sub(_value);\\n // Update rebasingCredits by adding the credited amount\\n _rebasingCredits = _rebasingCredits.add(creditsCredited);\\n }\\n }\\n\\n /**\\n * @dev Function to check the amount of tokens that _owner has allowed to\\n * `_spender`.\\n * @param _owner The address which owns the funds.\\n * @param _spender The address which will spend the funds.\\n * @return The number of tokens still available for the _spender.\\n */\\n function allowance(address _owner, address _spender)\\n public\\n view\\n override\\n returns (uint256)\\n {\\n return _allowances[_owner][_spender];\\n }\\n\\n /**\\n * @dev Approve the passed address to spend the specified amount of tokens\\n * on behalf of msg.sender. This method is included for ERC20\\n * compatibility. `increaseAllowance` and `decreaseAllowance` should be\\n * used instead.\\n *\\n * Changing an allowance with this method brings the risk that someone\\n * may transfer both the old and the new allowance - if they are both\\n * greater than zero - if a transfer transaction is mined before the\\n * later approve() call is mined.\\n * @param _spender The address which will spend the funds.\\n * @param _value The amount of tokens to be spent.\\n */\\n function approve(address _spender, uint256 _value)\\n public\\n override\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _value;\\n emit Approval(msg.sender, _spender, _value);\\n return true;\\n }\\n\\n /**\\n * @dev Increase the amount of tokens that an owner has allowed to\\n * `_spender`.\\n * This method should be used instead of approve() to avoid the double\\n * approval vulnerability described above.\\n * @param _spender The address which will spend the funds.\\n * @param _addedValue The amount of tokens to increase the allowance by.\\n */\\n function increaseAllowance(address _spender, uint256 _addedValue)\\n public\\n returns (bool)\\n {\\n _allowances[msg.sender][_spender] = _allowances[msg.sender][_spender]\\n .add(_addedValue);\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Decrease the amount of tokens that an owner has allowed to\\n `_spender`.\\n * @param _spender The address which will spend the funds.\\n * @param _subtractedValue The amount of tokens to decrease the allowance\\n * by.\\n */\\n function decreaseAllowance(address _spender, uint256 _subtractedValue)\\n public\\n returns (bool)\\n {\\n uint256 oldValue = _allowances[msg.sender][_spender];\\n if (_subtractedValue >= oldValue) {\\n _allowances[msg.sender][_spender] = 0;\\n } else {\\n _allowances[msg.sender][_spender] = oldValue.sub(_subtractedValue);\\n }\\n emit Approval(msg.sender, _spender, _allowances[msg.sender][_spender]);\\n return true;\\n }\\n\\n /**\\n * @dev Mints new tokens, increasing totalSupply.\\n */\\n function mint(address _account, uint256 _amount) external onlyVault {\\n _mint(_account, _amount);\\n }\\n\\n /**\\n * @dev Creates `_amount` tokens and assigns them to `_account`, increasing\\n * the total supply.\\n *\\n * Emits a {Transfer} event with `from` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `to` cannot be the zero address.\\n */\\n function _mint(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Mint to the zero address\\\");\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n _creditBalances[_account] = _creditBalances[_account].add(creditAmount);\\n\\n // If the account is non rebasing and doesn't have a set creditsPerToken\\n // then set it i.e. this is a mint from a fresh contract\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.add(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.add(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.add(_amount);\\n\\n require(_totalSupply < MAX_SUPPLY, \\\"Max supply\\\");\\n\\n emit Transfer(address(0), _account, _amount);\\n }\\n\\n /**\\n * @dev Burns tokens, decreasing totalSupply.\\n */\\n function burn(address account, uint256 amount) external onlyVault {\\n _burn(account, amount);\\n }\\n\\n /**\\n * @dev Destroys `_amount` tokens from `_account`, reducing the\\n * total supply.\\n *\\n * Emits a {Transfer} event with `to` set to the zero address.\\n *\\n * Requirements\\n *\\n * - `_account` cannot be the zero address.\\n * - `_account` must have at least `_amount` tokens.\\n */\\n function _burn(address _account, uint256 _amount) internal nonReentrant {\\n require(_account != address(0), \\\"Burn from the zero address\\\");\\n if (_amount == 0) {\\n return;\\n }\\n\\n bool isNonRebasingAccount = _isNonRebasingAccount(_account);\\n uint256 creditAmount = _amount.mulTruncate(_creditsPerToken(_account));\\n uint256 currentCredits = _creditBalances[_account];\\n\\n // Remove the credits, burning rounding errors\\n if (\\n currentCredits == creditAmount || currentCredits - 1 == creditAmount\\n ) {\\n // Handle dust from rounding\\n _creditBalances[_account] = 0;\\n } else if (currentCredits > creditAmount) {\\n _creditBalances[_account] = _creditBalances[_account].sub(\\n creditAmount\\n );\\n } else {\\n revert(\\\"Remove exceeds balance\\\");\\n }\\n\\n // Remove from the credit tallies and non-rebasing supply\\n if (isNonRebasingAccount) {\\n nonRebasingSupply = nonRebasingSupply.sub(_amount);\\n } else {\\n _rebasingCredits = _rebasingCredits.sub(creditAmount);\\n }\\n\\n _totalSupply = _totalSupply.sub(_amount);\\n\\n emit Transfer(_account, address(0), _amount);\\n }\\n\\n /**\\n * @dev Get the credits per token for an account. Returns a fixed amount\\n * if the account is non-rebasing.\\n * @param _account Address of the account.\\n */\\n function _creditsPerToken(address _account)\\n internal\\n view\\n returns (uint256)\\n {\\n if (nonRebasingCreditsPerToken[_account] != 0) {\\n return nonRebasingCreditsPerToken[_account];\\n } else {\\n return _rebasingCreditsPerToken;\\n }\\n }\\n\\n /**\\n * @dev Is an account using rebasing accounting or non-rebasing accounting?\\n * Also, ensure contracts are non-rebasing if they have not opted in.\\n * @param _account Address of the account.\\n */\\n function _isNonRebasingAccount(address _account) internal returns (bool) {\\n bool isContract = Address.isContract(_account);\\n if (isContract && rebaseState[_account] == RebaseOptions.NotSet) {\\n _ensureRebasingMigration(_account);\\n }\\n return nonRebasingCreditsPerToken[_account] > 0;\\n }\\n\\n /**\\n * @dev Ensures internal account for rebasing and non-rebasing credits and\\n * supply is updated following deployment of frozen yield change.\\n */\\n function _ensureRebasingMigration(address _account) internal {\\n if (nonRebasingCreditsPerToken[_account] == 0) {\\n emit AccountRebasingDisabled(_account);\\n if (_creditBalances[_account] == 0) {\\n // Since there is no existing balance, we can directly set to\\n // high resolution, and do not have to do any other bookkeeping\\n nonRebasingCreditsPerToken[_account] = 1e27;\\n } else {\\n // Migrate an existing account:\\n\\n // Set fixed credits per token for this account\\n nonRebasingCreditsPerToken[_account] = _rebasingCreditsPerToken;\\n // Update non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(_account));\\n // Update credit tallies\\n _rebasingCredits = _rebasingCredits.sub(\\n _creditBalances[_account]\\n );\\n }\\n }\\n }\\n\\n /**\\n * @notice Enable rebasing for an account.\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n * @param _account Address of the account.\\n */\\n function governanceRebaseOptIn(address _account)\\n public\\n nonReentrant\\n onlyGovernor\\n {\\n _rebaseOptIn(_account);\\n }\\n\\n /**\\n * @dev Add a contract address to the non-rebasing exception list. The\\n * address's balance will be part of rebases and the account will be exposed\\n * to upside and downside.\\n */\\n function rebaseOptIn() public nonReentrant {\\n _rebaseOptIn(msg.sender);\\n }\\n\\n function _rebaseOptIn(address _account) internal {\\n require(_isNonRebasingAccount(_account), \\\"Account has not opted out\\\");\\n\\n // Convert balance into the same amount at the current exchange rate\\n uint256 newCreditBalance = _creditBalances[_account]\\n .mul(_rebasingCreditsPerToken)\\n .div(_creditsPerToken(_account));\\n\\n // Decreasing non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.sub(balanceOf(_account));\\n\\n _creditBalances[_account] = newCreditBalance;\\n\\n // Increase rebasing credits, totalSupply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.add(_creditBalances[_account]);\\n\\n rebaseState[_account] = RebaseOptions.OptIn;\\n\\n // Delete any fixed credits per token\\n delete nonRebasingCreditsPerToken[_account];\\n emit AccountRebasingEnabled(_account);\\n }\\n\\n /**\\n * @dev Explicitly mark that an address is non-rebasing.\\n */\\n function rebaseOptOut() public nonReentrant {\\n require(!_isNonRebasingAccount(msg.sender), \\\"Account has not opted in\\\");\\n\\n // Increase non rebasing supply\\n nonRebasingSupply = nonRebasingSupply.add(balanceOf(msg.sender));\\n // Set fixed credits per token\\n nonRebasingCreditsPerToken[msg.sender] = _rebasingCreditsPerToken;\\n\\n // Decrease rebasing credits, total supply remains unchanged so no\\n // adjustment necessary\\n _rebasingCredits = _rebasingCredits.sub(_creditBalances[msg.sender]);\\n\\n // Mark explicitly opted out of rebasing\\n rebaseState[msg.sender] = RebaseOptions.OptOut;\\n emit AccountRebasingDisabled(msg.sender);\\n }\\n\\n /**\\n * @dev Modify the supply without minting new tokens. This uses a change in\\n * the exchange rate between \\\"credits\\\" and OUSD tokens to change balances.\\n * @param _newTotalSupply New total supply of OUSD.\\n */\\n function changeSupply(uint256 _newTotalSupply)\\n external\\n onlyVault\\n nonReentrant\\n {\\n require(_totalSupply > 0, \\\"Cannot increase 0 supply\\\");\\n\\n if (_totalSupply == _newTotalSupply) {\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n return;\\n }\\n\\n _totalSupply = _newTotalSupply > MAX_SUPPLY\\n ? MAX_SUPPLY\\n : _newTotalSupply;\\n\\n _rebasingCreditsPerToken = _rebasingCredits.divPrecisely(\\n _totalSupply.sub(nonRebasingSupply)\\n );\\n\\n require(_rebasingCreditsPerToken > 0, \\\"Invalid change in supply\\\");\\n\\n _totalSupply = _rebasingCredits\\n .divPrecisely(_rebasingCreditsPerToken)\\n .add(nonRebasingSupply);\\n\\n emit TotalSupplyUpdatedHighres(\\n _totalSupply,\\n _rebasingCredits,\\n _rebasingCreditsPerToken\\n );\\n }\\n}\\n\",\"keccak256\":\"0x2dc66b1ba02716d64eb47dd9117fda62650d8b57669e6c351437e0ad29ad5f19\",\"license\":\"MIT\"},\"contracts/utils/Helpers.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IBasicToken } from \\\"../interfaces/IBasicToken.sol\\\";\\n\\nlibrary Helpers {\\n /**\\n * @notice Fetch the `symbol()` from an ERC20 token\\n * @dev Grabs the `symbol()` from a contract\\n * @param _token Address of the ERC20 token\\n * @return string Symbol of the ERC20 token\\n */\\n function getSymbol(address _token) internal view returns (string memory) {\\n string memory symbol = IBasicToken(_token).symbol();\\n return symbol;\\n }\\n\\n /**\\n * @notice Fetch the `decimals()` from an ERC20 token\\n * @dev Grabs the `decimals()` from a contract and fails if\\n * the decimal value does not live within a certain range\\n * @param _token Address of the ERC20 token\\n * @return uint256 Decimals of the ERC20 token\\n */\\n function getDecimals(address _token) internal view returns (uint256) {\\n uint256 decimals = IBasicToken(_token).decimals();\\n require(\\n decimals >= 4 && decimals <= 18,\\n \\\"Token must have sufficient decimal places\\\"\\n );\\n\\n return decimals;\\n }\\n}\\n\",\"keccak256\":\"0x108b7a69e0140da0072ca18f90a03a3340574400f81aa6076cd2cccdf13699c2\",\"license\":\"MIT\"},\"contracts/utils/Initializable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract any contracts that need to initialize state after deployment.\\n * @author Origin Protocol Inc\\n */\\nabstract contract Initializable {\\n /**\\n * @dev Indicates that the contract has been initialized.\\n */\\n bool private initialized;\\n\\n /**\\n * @dev Indicates that the contract is in the process of being initialized.\\n */\\n bool private initializing;\\n\\n /**\\n * @dev Modifier to protect an initializer function from being invoked twice.\\n */\\n modifier initializer() {\\n require(\\n initializing || !initialized,\\n \\\"Initializable: contract is already initialized\\\"\\n );\\n\\n bool isTopLevelCall = !initializing;\\n if (isTopLevelCall) {\\n initializing = true;\\n initialized = true;\\n }\\n\\n _;\\n\\n if (isTopLevelCall) {\\n initializing = false;\\n }\\n }\\n\\n uint256[50] private ______gap;\\n}\\n\",\"keccak256\":\"0xaadbcc138114afed4af4f353c2ced2916e6ee14be91434789187f192caf0d786\",\"license\":\"MIT\"},\"contracts/utils/InitializableAbstractStrategy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base contract for vault strategies.\\n * @author Origin Protocol Inc\\n */\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { IVault } from \\\"../interfaces/IVault.sol\\\";\\n\\nabstract contract InitializableAbstractStrategy is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event PTokenAdded(address indexed _asset, address _pToken);\\n event PTokenRemoved(address indexed _asset, address _pToken);\\n event Deposit(address indexed _asset, address _pToken, uint256 _amount);\\n event Withdrawal(address indexed _asset, address _pToken, uint256 _amount);\\n event RewardTokenCollected(\\n address recipient,\\n address rewardToken,\\n uint256 amount\\n );\\n event RewardTokenAddressesUpdated(\\n address[] _oldAddresses,\\n address[] _newAddresses\\n );\\n event HarvesterAddressesUpdated(\\n address _oldHarvesterAddress,\\n address _newHarvesterAddress\\n );\\n\\n /// @notice Address of the underlying platform\\n address public immutable platformAddress;\\n /// @notice Address of the OToken vault\\n address public immutable vaultAddress;\\n\\n /// @dev Replaced with an immutable variable\\n // slither-disable-next-line constable-states\\n address private _deprecated_platformAddress;\\n\\n /// @dev Replaced with an immutable\\n // slither-disable-next-line constable-states\\n address private _deprecated_vaultAddress;\\n\\n /// @notice asset => pToken (Platform Specific Token Address)\\n mapping(address => address) public assetToPToken;\\n\\n /// @notice Full list of all assets supported by the strategy\\n address[] internal assetsMapped;\\n\\n // Deprecated: Reward token address\\n // slither-disable-next-line constable-states\\n address private _deprecated_rewardTokenAddress;\\n\\n // Deprecated: now resides in Harvester's rewardTokenConfigs\\n // slither-disable-next-line constable-states\\n uint256 private _deprecated_rewardLiquidationThreshold;\\n\\n /// @notice Address of the Harvester contract allowed to collect reward tokens\\n address public harvesterAddress;\\n\\n /// @notice Address of the reward tokens. eg CRV, BAL, CVX, AURA\\n address[] public rewardTokenAddresses;\\n\\n /* Reserved for future expansion. Used to be 100 storage slots\\n * and has decreased to accommodate:\\n * - harvesterAddress\\n * - rewardTokenAddresses\\n */\\n int256[98] private _reserved;\\n\\n struct BaseStrategyConfig {\\n address platformAddress; // Address of the underlying platform\\n address vaultAddress; // Address of the OToken's Vault\\n }\\n\\n /**\\n * @param _config The platform and OToken vault addresses\\n */\\n constructor(BaseStrategyConfig memory _config) {\\n platformAddress = _config.platformAddress;\\n vaultAddress = _config.vaultAddress;\\n }\\n\\n /**\\n * @dev Internal initialize function, to set up initial internal state\\n * @param _rewardTokenAddresses Address of reward token for platform\\n * @param _assets Addresses of initial supported assets\\n * @param _pTokens Platform Token corresponding addresses\\n */\\n function _initialize(\\n address[] memory _rewardTokenAddresses,\\n address[] memory _assets,\\n address[] memory _pTokens\\n ) internal {\\n rewardTokenAddresses = _rewardTokenAddresses;\\n\\n uint256 assetCount = _assets.length;\\n require(assetCount == _pTokens.length, \\\"Invalid input arrays\\\");\\n for (uint256 i = 0; i < assetCount; ++i) {\\n _setPTokenAddress(_assets[i], _pTokens[i]);\\n }\\n }\\n\\n /**\\n * @notice Collect accumulated reward token and send to Vault.\\n */\\n function collectRewardTokens() external virtual onlyHarvester nonReentrant {\\n _collectRewardTokens();\\n }\\n\\n /**\\n * @dev Default implementation that transfers reward tokens to the Harvester\\n * Implementing strategies need to add custom logic to collect the rewards.\\n */\\n function _collectRewardTokens() internal virtual {\\n uint256 rewardTokenCount = rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n IERC20 rewardToken = IERC20(rewardTokenAddresses[i]);\\n uint256 balance = rewardToken.balanceOf(address(this));\\n if (balance > 0) {\\n emit RewardTokenCollected(\\n harvesterAddress,\\n address(rewardToken),\\n balance\\n );\\n rewardToken.safeTransfer(harvesterAddress, balance);\\n }\\n }\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault.\\n */\\n modifier onlyVault() {\\n require(msg.sender == vaultAddress, \\\"Caller is not the Vault\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Harvester.\\n */\\n modifier onlyHarvester() {\\n require(msg.sender == harvesterAddress, \\\"Caller is not the Harvester\\\");\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault or Governor.\\n */\\n modifier onlyVaultOrGovernor() {\\n require(\\n msg.sender == vaultAddress || msg.sender == governor(),\\n \\\"Caller is not the Vault or Governor\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @dev Verifies that the caller is the Vault, Governor, or Strategist.\\n */\\n modifier onlyVaultOrGovernorOrStrategist() {\\n require(\\n msg.sender == vaultAddress ||\\n msg.sender == governor() ||\\n msg.sender == IVault(vaultAddress).strategistAddr(),\\n \\\"Caller is not the Vault, Governor, or Strategist\\\"\\n );\\n _;\\n }\\n\\n /**\\n * @notice Set the reward token addresses. Any old addresses will be overwritten.\\n * @param _rewardTokenAddresses Array of reward token addresses\\n */\\n function setRewardTokenAddresses(address[] calldata _rewardTokenAddresses)\\n external\\n onlyGovernor\\n {\\n uint256 rewardTokenCount = _rewardTokenAddresses.length;\\n for (uint256 i = 0; i < rewardTokenCount; ++i) {\\n require(\\n _rewardTokenAddresses[i] != address(0),\\n \\\"Can not set an empty address as a reward token\\\"\\n );\\n }\\n\\n emit RewardTokenAddressesUpdated(\\n rewardTokenAddresses,\\n _rewardTokenAddresses\\n );\\n rewardTokenAddresses = _rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Get the reward token addresses.\\n * @return address[] the reward token addresses.\\n */\\n function getRewardTokenAddresses()\\n external\\n view\\n returns (address[] memory)\\n {\\n return rewardTokenAddresses;\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * This method can only be called by the system Governor\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function setPTokenAddress(address _asset, address _pToken)\\n external\\n virtual\\n onlyGovernor\\n {\\n _setPTokenAddress(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Remove a supported asset by passing its index.\\n * This method can only be called by the system Governor\\n * @param _assetIndex Index of the asset to be removed\\n */\\n function removePToken(uint256 _assetIndex) external virtual onlyGovernor {\\n require(_assetIndex < assetsMapped.length, \\\"Invalid index\\\");\\n address asset = assetsMapped[_assetIndex];\\n address pToken = assetToPToken[asset];\\n\\n if (_assetIndex < assetsMapped.length - 1) {\\n assetsMapped[_assetIndex] = assetsMapped[assetsMapped.length - 1];\\n }\\n assetsMapped.pop();\\n assetToPToken[asset] = address(0);\\n\\n emit PTokenRemoved(asset, pToken);\\n }\\n\\n /**\\n * @notice Provide support for asset by passing its pToken address.\\n * Add to internal mappings and execute the platform specific,\\n * abstract method `_abstractSetPToken`\\n * @param _asset Address for the asset\\n * @param _pToken Address for the corresponding platform token\\n */\\n function _setPTokenAddress(address _asset, address _pToken) internal {\\n require(assetToPToken[_asset] == address(0), \\\"pToken already set\\\");\\n require(\\n _asset != address(0) && _pToken != address(0),\\n \\\"Invalid addresses\\\"\\n );\\n\\n assetToPToken[_asset] = _pToken;\\n assetsMapped.push(_asset);\\n\\n emit PTokenAdded(_asset, _pToken);\\n\\n _abstractSetPToken(_asset, _pToken);\\n }\\n\\n /**\\n * @notice Transfer token to governor. Intended for recovering tokens stuck in\\n * strategy contracts, i.e. mistaken sends.\\n * @param _asset Address for the asset\\n * @param _amount Amount of the asset to transfer\\n */\\n function transferToken(address _asset, uint256 _amount)\\n public\\n onlyGovernor\\n {\\n require(!supportsAsset(_asset), \\\"Cannot transfer supported asset\\\");\\n IERC20(_asset).safeTransfer(governor(), _amount);\\n }\\n\\n /**\\n * @notice Set the Harvester contract that can collect rewards.\\n * @param _harvesterAddress Address of the harvester contract.\\n */\\n function setHarvesterAddress(address _harvesterAddress)\\n external\\n onlyGovernor\\n {\\n emit HarvesterAddressesUpdated(harvesterAddress, _harvesterAddress);\\n harvesterAddress = _harvesterAddress;\\n }\\n\\n /***************************************\\n Abstract\\n ****************************************/\\n\\n function _abstractSetPToken(address _asset, address _pToken)\\n internal\\n virtual;\\n\\n function safeApproveAllTokens() external virtual;\\n\\n /**\\n * @notice Deposit an amount of assets into the platform\\n * @param _asset Address for the asset\\n * @param _amount Units of asset to deposit\\n */\\n function deposit(address _asset, uint256 _amount) external virtual;\\n\\n /**\\n * @notice Deposit all supported assets in this strategy contract to the platform\\n */\\n function depositAll() external virtual;\\n\\n /**\\n * @notice Withdraw an `amount` of assets from the platform and\\n * send to the `_recipient`.\\n * @param _recipient Address to which the asset should be sent\\n * @param _asset Address of the asset\\n * @param _amount Units of asset to withdraw\\n */\\n function withdraw(\\n address _recipient,\\n address _asset,\\n uint256 _amount\\n ) external virtual;\\n\\n /**\\n * @notice Withdraw all supported assets from platform and\\n * sends to the OToken's Vault.\\n */\\n function withdrawAll() external virtual;\\n\\n /**\\n * @notice Get the total asset value held in the platform.\\n * This includes any interest that was generated since depositing.\\n * @param _asset Address of the asset\\n * @return balance Total value of the asset in the platform\\n */\\n function checkBalance(address _asset)\\n external\\n view\\n virtual\\n returns (uint256 balance);\\n\\n /**\\n * @notice Check if an asset is supported.\\n * @param _asset Address of the asset\\n * @return bool Whether asset is supported\\n */\\n function supportsAsset(address _asset) public view virtual returns (bool);\\n}\\n\",\"keccak256\":\"0x5e17bb3db9f9e1014b7c5c836547f8fa81e02af7568c0bb8f2a2e0e7c2192db4\",\"license\":\"MIT\"},\"contracts/utils/InitializableERC20Detailed.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/**\\n * @dev Optional functions from the ERC20 standard.\\n * Converted from openzeppelin/contracts/token/ERC20/ERC20Detailed.sol\\n * @author Origin Protocol Inc\\n */\\nabstract contract InitializableERC20Detailed is IERC20 {\\n // Storage gap to skip storage from prior to OUSD reset\\n uint256[100] private _____gap;\\n\\n string private _name;\\n string private _symbol;\\n uint8 private _decimals;\\n\\n /**\\n * @dev Sets the values for `name`, `symbol`, and `decimals`. All three of\\n * these values are immutable: they can only be set once during\\n * construction.\\n * @notice To avoid variable shadowing appended `Arg` after arguments name.\\n */\\n function _initialize(\\n string memory nameArg,\\n string memory symbolArg,\\n uint8 decimalsArg\\n ) internal {\\n _name = nameArg;\\n _symbol = symbolArg;\\n _decimals = decimalsArg;\\n }\\n\\n /**\\n * @notice Returns the name of the token.\\n */\\n function name() public view returns (string memory) {\\n return _name;\\n }\\n\\n /**\\n * @notice Returns the symbol of the token, usually a shorter version of the\\n * name.\\n */\\n function symbol() public view returns (string memory) {\\n return _symbol;\\n }\\n\\n /**\\n * @notice Returns the number of decimals used to get its user representation.\\n * For example, if `decimals` equals `2`, a balance of `505` tokens should\\n * be displayed to a user as `5,05` (`505 / 10 ** 2`).\\n *\\n * Tokens usually opt for a value of 18, imitating the relationship between\\n * Ether and Wei.\\n *\\n * NOTE: This information is only used for _display_ purposes: it in\\n * no way affects any of the arithmetic of the contract, including\\n * {IERC20-balanceOf} and {IERC20-transfer}.\\n */\\n function decimals() public view returns (uint8) {\\n return _decimals;\\n }\\n}\\n\",\"keccak256\":\"0xe35ac2d813a30d845a3b52bba72588d7e936c2b3f3373d15568c14db46aeed60\",\"license\":\"MIT\"},\"contracts/utils/StableMath.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { SafeMath } from \\\"@openzeppelin/contracts/utils/math/SafeMath.sol\\\";\\n\\n// Based on StableMath from Stability Labs Pty. Ltd.\\n// https://github.com/mstable/mStable-contracts/blob/master/contracts/shared/StableMath.sol\\n\\nlibrary StableMath {\\n using SafeMath for uint256;\\n\\n /**\\n * @dev Scaling unit for use in specific calculations,\\n * where 1 * 10**18, or 1e18 represents a unit '1'\\n */\\n uint256 private constant FULL_SCALE = 1e18;\\n\\n /***************************************\\n Helpers\\n ****************************************/\\n\\n /**\\n * @dev Adjust the scale of an integer\\n * @param to Decimals to scale to\\n * @param from Decimals to scale from\\n */\\n function scaleBy(\\n uint256 x,\\n uint256 to,\\n uint256 from\\n ) internal pure returns (uint256) {\\n if (to > from) {\\n x = x.mul(10**(to - from));\\n } else if (to < from) {\\n // slither-disable-next-line divide-before-multiply\\n x = x.div(10**(from - to));\\n }\\n return x;\\n }\\n\\n /***************************************\\n Precise Arithmetic\\n ****************************************/\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncate(uint256 x, uint256 y) internal pure returns (uint256) {\\n return mulTruncateScale(x, y, FULL_SCALE);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the given scale. For example,\\n * when calculating 90% of 10e18, (10e18 * 9e17) / 1e18 = (9e36) / 1e18 = 9e18\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @param scale Scale unit\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit\\n */\\n function mulTruncateScale(\\n uint256 x,\\n uint256 y,\\n uint256 scale\\n ) internal pure returns (uint256) {\\n // e.g. assume scale = fullScale\\n // z = 10e18 * 9e17 = 9e36\\n uint256 z = x.mul(y);\\n // return 9e36 / 1e18 = 9e18\\n return z.div(scale);\\n }\\n\\n /**\\n * @dev Multiplies two precise units, and then truncates by the full scale, rounding up the result\\n * @param x Left hand input to multiplication\\n * @param y Right hand input to multiplication\\n * @return Result after multiplying the two inputs and then dividing by the shared\\n * scale unit, rounded up to the closest base unit.\\n */\\n function mulTruncateCeil(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e17 * 17268172638 = 138145381104e17\\n uint256 scaled = x.mul(y);\\n // e.g. 138145381104e17 + 9.99...e17 = 138145381113.99...e17\\n uint256 ceil = scaled.add(FULL_SCALE.sub(1));\\n // e.g. 13814538111.399...e18 / 1e18 = 13814538111\\n return ceil.div(FULL_SCALE);\\n }\\n\\n /**\\n * @dev Precisely divides two units, by first scaling the left hand operand. Useful\\n * for finding percentage weightings, i.e. 8e18/10e18 = 80% (or 8e17)\\n * @param x Left hand input to division\\n * @param y Right hand input to division\\n * @return Result after multiplying the left operand by the scale, and\\n * executing the division on the right hand input.\\n */\\n function divPrecisely(uint256 x, uint256 y)\\n internal\\n pure\\n returns (uint256)\\n {\\n // e.g. 8e18 * 1e18 = 8e36\\n uint256 z = x.mul(FULL_SCALE);\\n // e.g. 8e36 / 10e18 = 8e17\\n return z.div(y);\\n }\\n}\\n\",\"keccak256\":\"0x1eb49f6f79045d9e0a8e1dced8e01d9e559e5fac554dcbb53e43140b601b04e7\",\"license\":\"MIT\"},\"contracts/vault/VaultStorage.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title OToken VaultStorage contract\\n * @notice The VaultStorage contract defines the storage for the Vault contracts\\n * @author Origin Protocol Inc\\n */\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { IStrategy } from \\\"../interfaces/IStrategy.sol\\\";\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\nimport { OUSD } from \\\"../token/OUSD.sol\\\";\\nimport { Initializable } from \\\"../utils/Initializable.sol\\\";\\nimport \\\"../utils/Helpers.sol\\\";\\n\\ncontract VaultStorage is Initializable, Governable {\\n using SafeERC20 for IERC20;\\n\\n event AssetSupported(address _asset);\\n event AssetDefaultStrategyUpdated(address _asset, address _strategy);\\n event AssetAllocated(address _asset, address _strategy, uint256 _amount);\\n event StrategyApproved(address _addr);\\n event StrategyRemoved(address _addr);\\n event Mint(address _addr, uint256 _value);\\n event Redeem(address _addr, uint256 _value);\\n event CapitalPaused();\\n event CapitalUnpaused();\\n event RebasePaused();\\n event RebaseUnpaused();\\n event VaultBufferUpdated(uint256 _vaultBuffer);\\n event OusdMetaStrategyUpdated(address _ousdMetaStrategy);\\n event RedeemFeeUpdated(uint256 _redeemFeeBps);\\n event PriceProviderUpdated(address _priceProvider);\\n event AllocateThresholdUpdated(uint256 _threshold);\\n event RebaseThresholdUpdated(uint256 _threshold);\\n event StrategistUpdated(address _address);\\n event MaxSupplyDiffChanged(uint256 maxSupplyDiff);\\n event YieldDistribution(address _to, uint256 _yield, uint256 _fee);\\n event TrusteeFeeBpsChanged(uint256 _basis);\\n event TrusteeAddressChanged(address _address);\\n event NetOusdMintForStrategyThresholdChanged(uint256 _threshold);\\n event SwapperChanged(address _address);\\n event SwapAllowedUndervalueChanged(uint256 _basis);\\n event SwapSlippageChanged(address _asset, uint256 _basis);\\n event Swapped(\\n address indexed _fromAsset,\\n address indexed _toAsset,\\n uint256 _fromAssetAmount,\\n uint256 _toAssetAmount\\n );\\n\\n // Assets supported by the Vault, i.e. Stablecoins\\n enum UnitConversion {\\n DECIMALS,\\n GETEXCHANGERATE\\n }\\n // Changed to fit into a single storage slot so the decimals needs to be recached\\n struct Asset {\\n // Note: OETHVaultCore doesn't use `isSupported` when minting,\\n // redeeming or checking balance of assets.\\n bool isSupported;\\n UnitConversion unitConversion;\\n uint8 decimals;\\n // Max allowed slippage from the Oracle price when swapping collateral assets in basis points.\\n // For example 40 == 0.4% slippage\\n uint16 allowedOracleSlippageBps;\\n }\\n\\n /// @dev mapping of supported vault assets to their configuration\\n // slither-disable-next-line uninitialized-state\\n mapping(address => Asset) internal assets;\\n /// @dev list of all assets supported by the vault.\\n // slither-disable-next-line uninitialized-state\\n address[] internal allAssets;\\n\\n // Strategies approved for use by the Vault\\n struct Strategy {\\n bool isSupported;\\n uint256 _deprecated; // Deprecated storage slot\\n }\\n /// @dev mapping of strategy contracts to their configiration\\n mapping(address => Strategy) internal strategies;\\n /// @dev list of all vault strategies\\n address[] internal allStrategies;\\n\\n /// @notice Address of the Oracle price provider contract\\n // slither-disable-next-line uninitialized-state\\n address public priceProvider;\\n /// @notice pause rebasing if true\\n bool public rebasePaused = false;\\n /// @notice pause operations that change the OToken supply.\\n /// eg mint, redeem, allocate, mint/burn for strategy\\n bool public capitalPaused = true;\\n /// @notice Redemption fee in basis points. eg 50 = 0.5%\\n uint256 public redeemFeeBps;\\n /// @notice Percentage of assets to keep in Vault to handle (most) withdrawals. 100% = 1e18.\\n uint256 public vaultBuffer;\\n /// @notice OToken mints over this amount automatically allocate funds. 18 decimals.\\n uint256 public autoAllocateThreshold;\\n /// @notice OToken mints over this amount automatically rebase. 18 decimals.\\n uint256 public rebaseThreshold;\\n\\n /// @dev Address of the OToken token. eg OUSD or OETH.\\n // slither-disable-next-line uninitialized-state\\n OUSD internal oUSD;\\n\\n //keccak256(\\\"OUSD.vault.governor.admin.impl\\\");\\n bytes32 constant adminImplPosition =\\n 0xa2bd3d3cf188a41358c8b401076eb59066b09dec5775650c0de4c55187d17bd9;\\n\\n // Address of the contract responsible for post rebase syncs with AMMs\\n address private _deprecated_rebaseHooksAddr = address(0);\\n\\n // Deprecated: Address of Uniswap\\n // slither-disable-next-line constable-states\\n address private _deprecated_uniswapAddr = address(0);\\n\\n /// @notice Address of the Strategist\\n address public strategistAddr = address(0);\\n\\n /// @notice Mapping of asset address to the Strategy that they should automatically\\n // be allocated to\\n // slither-disable-next-line uninitialized-state\\n mapping(address => address) public assetDefaultStrategies;\\n\\n /// @notice Max difference between total supply and total value of assets. 18 decimals.\\n // slither-disable-next-line uninitialized-state\\n uint256 public maxSupplyDiff;\\n\\n /// @notice Trustee contract that can collect a percentage of yield\\n address public trusteeAddress;\\n\\n /// @notice Amount of yield collected in basis points. eg 2000 = 20%\\n uint256 public trusteeFeeBps;\\n\\n /// @dev Deprecated: Tokens that should be swapped for stablecoins\\n address[] private _deprecated_swapTokens;\\n\\n uint256 constant MINT_MINIMUM_UNIT_PRICE = 0.998e18;\\n\\n /// @notice Metapool strategy that is allowed to mint/burn OTokens without changing collateral\\n address public ousdMetaStrategy = address(0);\\n\\n /// @notice How much OTokens are currently minted by the strategy\\n int256 public netOusdMintedForStrategy = 0;\\n\\n /// @notice How much net total OTokens are allowed to be minted by all strategies\\n uint256 public netOusdMintForStrategyThreshold = 0;\\n\\n uint256 constant MIN_UNIT_PRICE_DRIFT = 0.7e18;\\n uint256 constant MAX_UNIT_PRICE_DRIFT = 1.3e18;\\n\\n /// @notice Collateral swap configuration.\\n /// @dev is packed into a single storage slot to save gas.\\n struct SwapConfig {\\n // Contract that swaps the vault's collateral assets\\n address swapper;\\n // Max allowed percentage the total value can drop below the total supply in basis points.\\n // For example 100 == 1%\\n uint16 allowedUndervalueBps;\\n }\\n SwapConfig internal swapConfig = SwapConfig(address(0), 0);\\n\\n // For future use\\n uint256[50] private __gap;\\n\\n /**\\n * @notice set the implementation for the admin, this needs to be in a base class else we cannot set it\\n * @param newImpl address of the implementation\\n */\\n function setAdminImpl(address newImpl) external onlyGovernor {\\n require(\\n Address.isContract(newImpl),\\n \\\"new implementation is not a contract\\\"\\n );\\n bytes32 position = adminImplPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newImpl)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xbcefeb5e2b88d99a54dbe6542dc25d0a68eeaf3adfe6e12fb70049cc024b1a79\",\"license\":\"MIT\"}},\"version\":1}", "bytecode": "0x610180604052600060685560006069556000606a553480156200002157600080fd5b5060405162004c9a38038062004c9a833981016040819052620000449162000147565b8585876020015183868383838362000062336200011760201b60201c565b60008051602062004c7a833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36033805460ff191690556001600160601b0319606094851b811660805291841b821660a052831b811660c05290821b811660e0528651821b811661010052602090960151811b86166101205298891b851661014052505050509190931b1661016052506200022292505050565b60008051602062004c7a83398151915255565b80516001600160a01b03811681146200014257600080fd5b919050565b60008060008060008086880360e08112156200016257600080fd5b60408112156200017157600080fd5b50604080519081016001600160401b0381118282101715620001a357634e487b7160e01b600052604160045260246000fd5b604052620001b1886200012a565b8152620001c1602089016200012a565b60208201529550620001d6604088016200012a565b9450620001e6606088016200012a565b9350620001f6608088016200012a565b92506200020660a088016200012a565b91506200021660c088016200012a565b90509295509295509295565b60805160601c60a05160601c60c05160601c60e05160601c6101005160601c6101205160601c6101405160601c6101605160601c6148c2620003b8600039600081816102a70152818161096e0152612da901526000818161057d01526122fc01526000818161045101528181610d41015281816118c001528181611a390152818161265b01526128e30152600061093a0152600081816106ec01528181610b09015281816117ee01528181611a8901528181611d6c0152818161332201526135730152600081816109b701528181610bdf015281816116c0015281816122cc015281816123e401526127d90152600081816108a601526114070152600081816102d9015281816104db015281816107bd01528181610a7001528181610db601528181610f850152818161100d015281816111bc01528181611297015281816119aa01528181611a5a01528181611d9b0152818161296e015281816129fd01528181612eae01528181612f3301528181612fa70152818161329c01528181613351015281816134ed01526135a201526148c26000f3fe6080604052600436106102975760003560e01c8063853828b61161015a578063c2e1e3f4116100c1578063d9f00ec71161007a578063d9f00ec714610908578063dbe55e5614610928578063dd505df61461095c578063de5f626814610990578063f1188e40146109a5578063f6ca71b0146109d957600080fd5b8063c2e1e3f414610842578063c7af335214610862578063c98517c514610877578063cceab75014610894578063d38bfff4146108c8578063d9caed12146108e857600080fd5b80639da0e462116101135780639da0e4621461074e578063a4f98af41461078b578063aa388af6146107a0578063ab12edf5146107ed578063ad1728cb1461080d578063bb1b918d1461082257600080fd5b8063853828b61461068057806387bae867146106955780638d7c0e46146106ba5780639092c31c146106da5780639136616a1461070e57806396d538bb1461072e57600080fd5b80635c975abb116101fe5780636e811d38116101b75780636e811d38146105d55780636ef38795146105f557806371a735f3146106155780637b2d9b2c14610635578063842f5c46146106555780638456cb591461066b57600080fd5b80635c975abb146105125780635d36b190146105365780635f5152261461054b5780636093d3801461056b57806366e3667e1461059f57806367c7066c146105b557600080fd5b8063430bf08a11610250578063430bf08a1461043f578063435356d11461047357806347e7ef2414610493578063484be812146104b3578063579a7e1a146104c95780635a063f63146104fd57600080fd5b80630c340a24146103535780630ed57b3a146103855780630fc3b4c4146103a55780631072cbea146103db57806322495dc8146103fb5780633c8649591461041b57600080fd5b3661034e57336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614806102fb5750336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016145b61034c5760405162461bcd60e51b815260206004820152601e60248201527f657468206e6f742066726f6d20616c6c6f77656420636f6e747261637473000060448201526064015b60405180910390fd5b005b600080fd5b34801561035f57600080fd5b506103686109fb565b6040516001600160a01b0390911681526020015b60405180910390f35b34801561039157600080fd5b5061034c6103a0366004613c43565b610a18565b3480156103b157600080fd5b506103686103c0366004613c09565b609f602052600090815260409020546001600160a01b031681565b3480156103e757600080fd5b5061034c6103f6366004613cbd565b610a4a565b34801561040757600080fd5b5061034c610416366004613db1565b610b07565b34801561042757600080fd5b5061043160695481565b60405190815260200161037c565b34801561044b57600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561047f57600080fd5b5061034c61048e366004613d2a565b610c51565b34801561049f57600080fd5b5061034c6104ae366004613cbd565b610d36565b3480156104bf57600080fd5b50610431606a5481565b3480156104d557600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561050957600080fd5b5061034c610e3c565b34801561051e57600080fd5b5060335460ff165b604051901515815260200161037c565b34801561054257600080fd5b5061034c610edb565b34801561055757600080fd5b50610431610566366004613c09565b610f81565b34801561057757600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156105ab57600080fd5b5061043160345481565b3480156105c157600080fd5b5060a354610368906001600160a01b031681565b3480156105e157600080fd5b5061034c6105f0366004613c09565b6110b5565b34801561060157600080fd5b5061034c610610366004613ce9565b61113d565b34801561062157600080fd5b5061034c610630366004613fbf565b6115c9565b34801561064157600080fd5b50610368610650366004613e87565b6117c2565b34801561066157600080fd5b5061043160685481565b34801561067757600080fd5b5061034c6117ec565b34801561068c57600080fd5b5061034c6118b5565b3480156106a157600080fd5b506033546103689061010090046001600160a01b031681565b3480156106c657600080fd5b5061034c6106d5366004614040565b611a87565b3480156106e657600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561071a57600080fd5b5061034c610729366004613e87565b611e6f565b34801561073a57600080fd5b5061034c610749366004613ce9565b61203a565b34801561075a57600080fd5b5061077e610769366004613e87565b60356020526000908152604090205460ff1681565b60405161037c91906144ab565b34801561079757600080fd5b5061052661215a565b3480156107ac57600080fd5b506105266107bb366004613c09565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0390811691161490565b3480156107f957600080fd5b5061034c610808366004614085565b6121b9565b34801561081957600080fd5b5061034c6122b5565b34801561082e57600080fd5b5061034c61083d366004613f0b565b61237b565b34801561084e57600080fd5b5061034c61085d366004613c09565b6124ee565b34801561086e57600080fd5b5061052661257b565b34801561088357600080fd5b506104316801bc16d674ec80000081565b3480156108a057600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156108d457600080fd5b5061034c6108e3366004613c09565b6125ac565b3480156108f457600080fd5b5061034c610903366004613c7c565b612650565b34801561091457600080fd5b5061034c610923366004613ea0565b6126e3565b34801561093457600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561096857600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b34801561099c57600080fd5b5061034c6128d8565b3480156109b157600080fd5b506103687f000000000000000000000000000000000000000000000000000000000000000081565b3480156109e557600080fd5b506109ee612a22565b60405161037c9190614281565b6000610a1360008051602061486d8339815191525490565b905090565b610a2061257b565b610a3c5760405162461bcd60e51b81526004016103439061451d565b610a468282612a84565b5050565b610a5261257b565b610a6e5760405162461bcd60e51b81526004016103439061451d565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b039081169083161415610aeb5760405162461bcd60e51b815260206004820152601f60248201527f43616e6e6f74207472616e7366657220737570706f72746564206173736574006044820152606401610343565b610a46610af66109fb565b6001600160a01b0384169083612be3565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015610b6057600080fd5b505afa158015610b74573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b989190613c26565b6001600160a01b0316336001600160a01b031614610bc85760405162461bcd60e51b8152600401610343906145dd565b60405163bc26e7e560e01b81526001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169063bc26e7e590610c1a9030908790879087906004016141d1565b600060405180830381600087803b158015610c3457600080fd5b505af1158015610c48573d6000803e3d6000fd5b50505050505050565b610c5961257b565b610c755760405162461bcd60e51b81526004016103439061451d565b600054610100900460ff1680610c8e575060005460ff16155b610cf15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610343565b600054610100900460ff16158015610d13576000805461ffff19166101011790555b610d1e848484612c35565b8015610d30576000805461ff00191690555b50505050565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610d7e5760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d83398151915280546002811415610db05760405162461bcd60e51b8152600401610343906145b5565b600282557f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316846001600160a01b031614610e295760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b6044820152606401610343565b610e338484612cf0565b50600190555050565b60a3546001600160a01b03163314610e965760405162461bcd60e51b815260206004820152601b60248201527f43616c6c6572206973206e6f74207468652048617276657374657200000000006044820152606401610343565b60008051602061484d83398151915280546002811415610ec85760405162461bcd60e51b8152600401610343906145b5565b60028255610ed4612d82565b5060019055565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b031614610f765760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b6064820152608401610343565b610f7f33612fd0565b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316826001600160a01b031614610ff85760405162461bcd60e51b8152602060048201526011602482015270155b9cdd5c1c1bdc9d195908185cdcd95d607a1b6044820152606401610343565b6040516370a0823160e01b81523060048201527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561105757600080fd5b505afa15801561106b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061108f919061406c565b6034546110a5906801bc16d674ec80000061473e565b6110af9190614704565b92915050565b6110bd61257b565b6110d95760405162461bcd60e51b81526004016103439061451d565b6040516001600160a01b03821681527f83f29c79feb71f8fba9d0fbc4ba5f0982a28b6b1e868b3fc50e6400d100bca0f9060200160405180910390a1603380546001600160a01b0390921661010002610100600160a81b0319909216919091179055565b60335461010090046001600160a01b0316331461116c5760405162461bcd60e51b81526004016103439061457e565b60335460ff161561118f5760405162461bcd60e51b815260040161034390614554565b60006111a4826801bc16d674ec80000061473e565b6040516370a0823160e01b81523060048201529091507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b15801561120657600080fd5b505afa15801561121a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061123e919061406c565b8111156112815760405162461bcd60e51b81526020600482015260116024820152700d2dce6eaccccd2c6d2cadce840ae8aa89607b1b6044820152606401610343565b604051632e1a7d4d60e01b8152600481018290527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690632e1a7d4d90602401600060405180830381600087803b1580156112e357600080fd5b505af11580156112f7573d6000803e3d6000fd5b5050505060005b82811015610d3057600084848381811061131a5761131a6147fd565b905060200281019061132c919061465a565b6113369080614614565b6040516113449291906141a5565b6040805191829003909120600081815260356020529182205490925060ff1690816003811115611376576113766147d1565b146113c35760405162461bcd60e51b815260206004820152601860248201527f56616c696461746f72206e6f74207265676973746572656400000000000000006044820152606401610343565b60408051600160f81b60208201526000602182018190526bffffffffffffffffffffffff193060601b16602c830152910160405160208183030381529060405290507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663228951186801bc16d674ec800000898988818110611450576114506147fd565b9050602002810190611462919061465a565b61146c9080614614565b858c8c8b81811061147f5761147f6147fd565b9050602002810190611491919061465a565b61149f906020810190614614565b8e8e8d8181106114b1576114b16147fd565b90506020028101906114c3919061465a565b604001356040518863ffffffff1660e01b81526004016114e896959493929190614430565b6000604051808303818588803b15801561150157600080fd5b505af1158015611515573d6000803e3d6000fd5b505050505060016034600082825461152d9190614704565b909155507ffeb31a79d38edb1b090d516e4df3e273651179c6f2c2ec53a9a22ae015b70ba99050878786818110611566576115666147fd565b9050602002810190611578919061465a565b6115829080614614565b6801bc16d674ec8000008460405161159d949392919061447f565b60405180910390a150506000908152603560205260409020805460ff19166001908117909155016112fe565b60335461010090046001600160a01b031633146115f85760405162461bcd60e51b81526004016103439061457e565b60335460ff161561161b5760405162461bcd60e51b815260040161034390614554565b60006035600087876040516116319291906141a5565b604080519182900390912082526020820192909252016000205460ff1690506002816003811115611664576116646147d1565b146116a95760405162461bcd60e51b815260206004820152601560248201527456616c696461746f72206e6f742065786974696e6760581b6044820152606401610343565b6040516312b3fc1960e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906312b3fc19906116fd90899089908990899089906004016143ef565b600060405180830381600087803b15801561171757600080fd5b505af115801561172b573d6000803e3d6000fd5b505050507ff72821b8777f002ccdf6326f1242d9e0f762eb077668b67bebe640535378066d868686866040516117649493929190614366565b60405180910390a160036035600088886040516117829291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156117b5576117b56147d1565b0217905550505050505050565b60a481815481106117d257600080fd5b6000918252602090912001546001600160a01b0316905081565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b15801561184557600080fd5b505afa158015611859573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061187d9190613c26565b6001600160a01b0316336001600160a01b0316146118ad5760405162461bcd60e51b8152600401610343906145dd565b610f7f613091565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016148061190457506118ef6109fb565b6001600160a01b0316336001600160a01b0316145b61195c5760405162461bcd60e51b815260206004820152602360248201527f43616c6c6572206973206e6f7420746865205661756c74206f7220476f7665726044820152623737b960e91b6064820152608401610343565b60008051602061484d8339815191528054600281141561198e5760405162461bcd60e51b8152600401610343906145b5565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156119f457600080fd5b505afa158015611a08573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611a2c919061406c565b90508015611a7f57611a7f7f00000000000000000000000000000000000000000000000000000000000000007f000000000000000000000000000000000000000000000000000000000000000083613106565b505060019055565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663570d8e1d6040518163ffffffff1660e01b815260040160206040518083038186803b158015611ae057600080fd5b505afa158015611af4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b189190613c26565b6001600160a01b0316336001600160a01b031614611b485760405162461bcd60e51b8152600401610343906145dd565b60335460ff16611b915760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610343565b6002198312158015611ba4575060038313155b8015611bbe5750600083603454611bbb91906146c3565b12155b611c0a5760405162461bcd60e51b815260206004820152601760248201527f696e76616c69642076616c696461746f727344656c74610000000000000000006044820152606401610343565b6811ff6cf0fd15afffff198212158015611c2d57506811ff6cf0fd15b000008213155b8015611c475750600082606854611c4491906146c3565b12155b611c935760405162461bcd60e51b815260206004820152601d60248201527f696e76616c696420636f6e73656e7375735265776172647344656c74610000006044820152606401610343565b6801bc16d674ec800000811115611cec5760405162461bcd60e51b815260206004820152601960248201527f696e76616c69642077657468546f5661756c74416d6f756e74000000000000006044820152606401610343565b60408051848152602081018490529081018290527f80d022717ea022455c5886b8dd8a29c037570aae58aeb4d7b136d7a10ec2e4319060600160405180910390a182603454611d3b91906146c3565b603455606854611d4c9083906146c3565b6068558015611e195760405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018390527f0000000000000000000000000000000000000000000000000000000000000000169063a9059cbb90604401602060405180830381600087803b158015611ddf57600080fd5b505af1158015611df3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e179190613e6a565b505b611e2360006131fe565b611e625760405162461bcd60e51b815260206004820152601060248201526f333ab9b29039ba34b63610313637bbb760811b6044820152606401610343565b611e6a613684565b505050565b611e7761257b565b611e935760405162461bcd60e51b81526004016103439061451d565b60a0548110611ed45760405162461bcd60e51b815260206004820152600d60248201526c092dcecc2d8d2c840d2dcc8caf609b1b6044820152606401610343565b600060a08281548110611ee957611ee96147fd565b60009182526020808320909101546001600160a01b03908116808452609f90925260409092205460a05491935090911690611f269060019061475d565b831015611fa85760a08054611f3d9060019061475d565b81548110611f4d57611f4d6147fd565b60009182526020909120015460a080546001600160a01b039092169185908110611f7957611f796147fd565b9060005260206000200160006101000a8154816001600160a01b0302191690836001600160a01b031602179055505b60a0805480611fb957611fb96147e7565b60008281526020808220600019908401810180546001600160a01b031990811690915593019093556001600160a01b03858116808352609f855260409283902080549094169093559051908416815290917f16b7600acff27e39a8a96056b3d533045298de927507f5c1d97e4accde60488c910160405180910390a2505050565b61204261257b565b61205e5760405162461bcd60e51b81526004016103439061451d565b8060005b8181101561211157600084848381811061207e5761207e6147fd565b90506020020160208101906120939190613c09565b6001600160a01b031614156121015760405162461bcd60e51b815260206004820152602e60248201527f43616e206e6f742073657420616e20656d70747920616464726573732061732060448201526d30903932bbb0b932103a37b5b2b760911b6064820152608401610343565b61210a816147a0565b9050612062565b507f04c0b9649497d316554306e53678d5f5f5dbc3a06f97dec13ff4cfe98b986bbc60a48484604051612146939291906142ce565b60405180910390a1610d3060a48484613962565b60335460009061010090046001600160a01b0316331461218c5760405162461bcd60e51b81526004016103439061457e565b60335460ff16156121af5760405162461bcd60e51b815260040161034390614554565b610a1360016131fe565b6121c161257b565b6121dd5760405162461bcd60e51b81526004016103439061451d565b80821080156121f457506801bc16d674ec80000082105b801561220857506801bc16d674ec80000081105b80156122255750673782dace9d900000612222838361475d565b10155b6122715760405162461bcd60e51b815260206004820152601760248201527f696e636f7272656374206675736520696e74657276616c0000000000000000006044820152606401610343565b60408051838152602081018390527fcb8d24e46eb3c402bf344ee60a6576cba9ef2f59ea1af3b311520704924e901a910160405180910390a1606991909155606a55565b60405163095ea7b360e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116600483015260001960248301527f0000000000000000000000000000000000000000000000000000000000000000169063095ea7b390604401602060405180830381600087803b15801561234057600080fd5b505af1158015612354573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123789190613e6a565b50565b60335461010090046001600160a01b031633146123aa5760405162461bcd60e51b81526004016103439061457e565b60335460ff16156123cd5760405162461bcd60e51b815260040161034390614554565b6040516301ba3ee760e21b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906306e8fb9c90612427908b908b908b908b908b908b908b908b9060040161438d565b600060405180830381600087803b15801561244157600080fd5b505af1158015612455573d6000803e3d6000fd5b505050506000603560008a8a60405161246f9291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156124a2576124a26147d1565b02179055507f75c4a66b2c6c28cf46db7131182a812e4fbbb2f0591377aa83a737909a9b68c3888888886040516124dc9493929190614366565b60405180910390a15050505050505050565b6124f661257b565b6125125760405162461bcd60e51b81526004016103439061451d565b60a354604080516001600160a01b03928316815291831660208301527fe48386b84419f4d36e0f96c10cc3510b6fb1a33795620c5098b22472bbe90796910160405180910390a160a380546001600160a01b0319166001600160a01b0392909216919091179055565b600061259360008051602061486d8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b6125b461257b565b6125d05760405162461bcd60e51b81526004016103439061451d565b6125f8817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b031661261860008051602061486d8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146126985760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d833981519152805460028114156126ca5760405162461bcd60e51b8152600401610343906145b5565b600282556126d9858585613106565b5060019055505050565b60335461010090046001600160a01b031633146127125760405162461bcd60e51b81526004016103439061457e565b60335460ff16156127355760405162461bcd60e51b815260040161034390614554565b600060356000868660405161274b9291906141a5565b604080519182900390912082526020820192909252016000205460ff169050600181600381111561277e5761277e6147d1565b146127c25760405162461bcd60e51b815260206004820152601460248201527315985b1a59185d1bdc881b9bdd081cdd185ad95960621b6044820152606401610343565b604051633877322b60e01b81526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001690633877322b90612814908890889088908890600401614366565b600060405180830381600087803b15801561282e57600080fd5b505af1158015612842573d6000803e3d6000fd5b505050507ff8821da16f5ed966b41e0343c3eff9903af782d74f99f1689dd9d4562b6545b38585858560405161287b9493929190614366565b60405180910390a160026035600087876040516128999291906141a5565b60408051918290039091208252602082019290925201600020805460ff191660018360038111156128cc576128cc6147d1565b02179055505050505050565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146129205760405162461bcd60e51b8152600401610343906144e6565b60008051602061484d833981519152805460028114156129525760405162461bcd60e51b8152600401610343906145b5565b600282556040516370a0823160e01b81523060048201526000907f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316906370a082319060240160206040518083038186803b1580156129b857600080fd5b505afa1580156129cc573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129f0919061406c565b90508015611a7f57611a7f7f000000000000000000000000000000000000000000000000000000000000000082612cf0565b606060a4805480602002602001604051908101604052809291908181526020018280548015612a7a57602002820191906000526020600020905b81546001600160a01b03168152600190910190602001808311612a5c575b5050505050905090565b6001600160a01b038281166000908152609f60205260409020541615612ae15760405162461bcd60e51b81526020600482015260126024820152711c151bdad95b88185b1c9958591e481cd95d60721b6044820152606401610343565b6001600160a01b03821615801590612b0157506001600160a01b03811615155b612b415760405162461bcd60e51b8152602060048201526011602482015270496e76616c69642061646472657373657360781b6044820152606401610343565b6001600160a01b038281166000818152609f6020908152604080832080549587166001600160a01b0319968716811790915560a0805460018101825594527f78fdc8d422c49ced035a9edf18d00d3c6a8d81df210f3e5e448e045e77b41e8890930180549095168417909455925190815290917fef6485b84315f9b1483beffa32aae9a0596890395e3d7521f1c5fbb51790e765910160405180910390a25050565b604080516001600160a01b038416602482015260448082018490528251808303909101815260649091019091526020810180516001600160e01b031663a9059cbb60e01b179052611e6a9084906136fe565b8251612c489060a49060208601906139c5565b50815181518114612c925760405162461bcd60e51b8152602060048201526014602482015273496e76616c696420696e7075742061727261797360601b6044820152606401610343565b60005b81811015612ce957612cd9848281518110612cb257612cb26147fd565b6020026020010151848381518110612ccc57612ccc6147fd565b6020026020010151612a84565b612ce2816147a0565b9050612c95565b5050505050565b60008111612d395760405162461bcd60e51b81526020600482015260166024820152754d757374206465706f73697420736f6d657468696e6760501b6044820152606401610343565b6040805160008152602081018390526001600160a01b038416917f5548c837ab068cf56a2c2479df0882a4922fd203edb7517321831d95078c5f62910160405180910390a25050565b60335460ff1615612da55760405162461bcd60e51b815260040161034390614554565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663e52253816040518163ffffffff1660e01b8152600401602060405180830381600087803b158015612e0257600080fd5b505af1158015612e16573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e3a919061406c565b9050600060685482612e4c9190614704565b905080471015612e9e5760405162461bcd60e51b815260206004820152601860248201527f696e73756666696369656e74206574682062616c616e636500000000000000006044820152606401610343565b8015610a465760006068819055507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b158015612f0757600080fd5b505af1158015612f1b573d6000803e3d6000fd5b505060a354604080516001600160a01b0392831681527f0000000000000000000000000000000000000000000000000000000000000000909216602083015281018590527ff6c07a063ed4e63808eb8da7112d46dbcd38de2b40a73dbcc9353c5a94c7235393506060019150612f8e9050565b60405180910390a160a354610a46906001600160a01b037f00000000000000000000000000000000000000000000000000000000000000008116911683612be3565b6001600160a01b0381166130265760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f7220697320616464726573732830290000000000006044820152606401610343565b806001600160a01b031661304660008051602061486d8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36123788160008051602061486d83398151915255565b60335460ff16156130b45760405162461bcd60e51b815260040161034390614554565b6033805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586130e93390565b6040516001600160a01b03909116815260200160405180910390a1565b600081116131565760405162461bcd60e51b815260206004820152601760248201527f4d75737420776974686472617720736f6d657468696e670000000000000000006044820152606401610343565b6001600160a01b0383166131a55760405162461bcd60e51b8152602060048201526016602482015275135d5cdd081cdc1958da599e481c9958da5c1a595b9d60521b6044820152606401610343565b6040805160008152602081018390526001600160a01b038416917f2717ead6b9200dd235aad468c9809ea400fe33ac69b5bfaa6d3e90fc922b6398910160405180910390a2611e6a6001600160a01b0383168483612be3565b6000606854471015613213576110af826137d0565b600060685447613223919061475d565b9050600191506801bc16d674ec800000811061341957600061324e6801bc16d674ec8000008361471c565b905080603454101561326b57613263846137d0565b949350505050565b806034600082825461327d919061475d565b9091555060009050613298826801bc16d674ec80000061473e565b90507f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b1580156132f557600080fd5b505af1158015613309573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b15801561339957600080fd5b505af11580156133ad573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133d19190613e6a565b5060345460408051848152602081019290925281018290527fbe7040030ff7b347853214bf49820c6d455fedf58f3815f85c7bc5216993682b9060600160405180910390a150505b600060685447613429919061475d565b90506801bc16d674ec800000811061347b5760405162461bcd60e51b8152602060048201526015602482015274756e6578706563746564206163636f756e74696e6760581b6044820152606401610343565b80613487575050919050565b6069548110156134e15780606860008282546134a39190614704565b90915550506040518181527f7a745a2c63a535068f52ceca27debd5297bbad5f7f37ec53d044a59d0362445d906020015b60405180910390a161367d565b606a54811115613674577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561354657600080fd5b505af115801561355a573d6000803e3d6000fd5b505060405163a9059cbb60e01b81526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000081166004830152602482018690527f000000000000000000000000000000000000000000000000000000000000000016935063a9059cbb92506044019050602060405180830381600087803b1580156135ea57600080fd5b505af11580156135fe573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906136229190613e6a565b50600160346000828254613636919061475d565b909155505060345460408051918252602082018390527f6aa7e30787b26429ced603a7aba8b19c4b5d5bcf29a3257da953c8d53bcaa3a691016134d4565b613263846137d0565b5050919050565b60335460ff166136cd5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610343565b6033805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa336130e9565b6000613753826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166137e89092919063ffffffff16565b805190915015611e6a57808060200190518101906137719190613e6a565b611e6a5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610343565b600081156137e0576137e0613091565b506000919050565b60606137f78484600085613801565b90505b9392505050565b6060824710156138625760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610343565b843b6138b05760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610343565b600080866001600160a01b031685876040516138cc91906141b5565b60006040518083038185875af1925050503d8060008114613909576040519150601f19603f3d011682016040523d82523d6000602084013e61390e565b606091505b509150915061391e828286613929565b979650505050505050565b606083156139385750816137fa565b8251156139485782518084602001fd5b8160405162461bcd60e51b815260040161034391906144d3565b8280548282559060005260206000209081019282156139b5579160200282015b828111156139b55781546001600160a01b0319166001600160a01b03843516178255602090920191600190910190613982565b506139c1929150613a1a565b5090565b8280548282559060005260206000209081019282156139b5579160200282015b828111156139b557825182546001600160a01b0319166001600160a01b039091161782556020909201916001909101906139e5565b5b808211156139c15760008155600101613a1b565b60008083601f840112613a4157600080fd5b5081356001600160401b03811115613a5857600080fd5b6020830191508360208260051b8501011115613a7357600080fd5b9250929050565b600082601f830112613a8b57600080fd5b81356020613aa0613a9b836146a0565b614670565b80838252828201915082860187848660051b8901011115613ac057600080fd5b60005b85811015613ae8578135613ad681614829565b84529284019290840190600101613ac3565b5090979650505050505050565b60008083601f840112613b0757600080fd5b5081356001600160401b03811115613b1e57600080fd5b602083019150836020828501011115613a7357600080fd5b600060a08284031215613b4857600080fd5b50919050565b600060a08284031215613b6057600080fd5b60405160a081018181106001600160401b0382111715613b8257613b82614813565b604052905080613b9183613bd9565b8152613b9f60208401613bf2565b6020820152613bb060408401613bf2565b60408201526060830135613bc38161483e565b6060820152608092830135920191909152919050565b803563ffffffff81168114613bed57600080fd5b919050565b80356001600160401b0381168114613bed57600080fd5b600060208284031215613c1b57600080fd5b81356137fa81614829565b600060208284031215613c3857600080fd5b81516137fa81614829565b60008060408385031215613c5657600080fd5b8235613c6181614829565b91506020830135613c7181614829565b809150509250929050565b600080600060608486031215613c9157600080fd5b8335613c9c81614829565b92506020840135613cac81614829565b929592945050506040919091013590565b60008060408385031215613cd057600080fd5b8235613cdb81614829565b946020939093013593505050565b60008060208385031215613cfc57600080fd5b82356001600160401b03811115613d1257600080fd5b613d1e85828601613a2f565b90969095509350505050565b600080600060608486031215613d3f57600080fd5b83356001600160401b0380821115613d5657600080fd5b613d6287838801613a7a565b94506020860135915080821115613d7857600080fd5b613d8487838801613a7a565b93506040860135915080821115613d9a57600080fd5b50613da786828701613a7a565b9150509250925092565b600080600060e08486031215613dc657600080fd5b83356001600160401b03811115613ddc57600080fd5b8401601f81018613613ded57600080fd5b80356020613dfd613a9b836146a0565b8083825282820191508285018a848660051b8801011115613e1d57600080fd5b600095505b84861015613e4757613e3381613bf2565b835260019590950194918301918301613e22565b509650508601359350613e61915086905060408601613b4e565b90509250925092565b600060208284031215613e7c57600080fd5b81516137fa8161483e565b600060208284031215613e9957600080fd5b5035919050565b60008060008060408587031215613eb657600080fd5b84356001600160401b0380821115613ecd57600080fd5b613ed988838901613af5565b90965094506020870135915080821115613ef257600080fd5b50613eff87828801613a2f565b95989497509550505050565b600080600080600080600080610120898b031215613f2857600080fd5b88356001600160401b0380821115613f3f57600080fd5b613f4b8c838d01613af5565b909a50985060208b0135915080821115613f6457600080fd5b613f708c838d01613a2f565b909850965060408b0135915080821115613f8957600080fd5b50613f968b828c01613af5565b90955093505060608901359150613fb08a60808b01613b36565b90509295985092959890939650565b600080600080600060e08688031215613fd757600080fd5b85356001600160401b0380821115613fee57600080fd5b613ffa89838a01613af5565b9097509550602088013591508082111561401357600080fd5b5061402088828901613a2f565b909450925061403490508760408801613b36565b90509295509295909350565b60008060006060848603121561405557600080fd5b505081359360208301359350604090920135919050565b60006020828403121561407e57600080fd5b5051919050565b6000806040838503121561409857600080fd5b50508035926020909101359150565b8183526000602080850194508260005b858110156140e3576001600160401b036140d083613bf2565b16875295820195908201906001016140b7565b509495945050505050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b6000815180845261412f816020860160208601614774565b601f01601f19169290920160200192915050565b63ffffffff61415182613bd9565b16825261416060208201613bf2565b6001600160401b0380821660208501528061417d60408501613bf2565b166040850152505060608101356141938161483e565b15156060830152608090810135910152565b8183823760009101908152919050565b600082516141c7818460208701614774565b9190910192915050565b6001600160a01b03851681526101006020808301829052855191830182905260009161012084019187810191845b818110156142245783516001600160401b0316855293820193928201926001016141ff565b505082935086604086015263ffffffff865116606086015280860151925050506001600160401b0380821660808501528060408601511660a085015250506060830151151560c0830152608083015160e083015295945050505050565b6020808252825182820181905260009190848201906040850190845b818110156142c25783516001600160a01b03168352928401929184019160010161429d565b50909695505050505050565b6000604082016040835280865480835260608501915087600052602092508260002060005b828110156143185781546001600160a01b0316845292840192600191820191016142f3565b505050838103828501528481528590820160005b8681101561435a57823561433f81614829565b6001600160a01b03168252918301919083019060010161432c565b50979650505050505050565b60408152600061437a6040830186886140ee565b828103602084015261391e8185876140a7565b60006101208083526143a28184018b8d6140ee565b905082810360208401526143b781898b6140a7565b905082810360408401526143cc8187896140ee565b9150508360608301526143e26080830184614143565b9998505050505050505050565b60e08152600061440360e0830187896140ee565b82810360208401526144168186886140a7565b9150506144266040830184614143565b9695505050505050565b60808152600061444460808301888a6140ee565b82810360208401526144568188614117565b9050828103604084015261446b8186886140ee565b915050826060830152979650505050505050565b6060815260006144936060830186886140ee565b846020840152828103604084015261391e8185614117565b60208101600483106144cd57634e487b7160e01b600052602160045260246000fd5b91905290565b6020815260006137fa6020830184614117565b60208082526017908201527f43616c6c6572206973206e6f7420746865205661756c74000000000000000000604082015260600190565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60208082526010908201526f14185d5cd8589b194e881c185d5cd95960821b604082015260600190565b6020808252601d908201527f43616c6c6572206973206e6f7420746865205265676973747261746f72000000604082015260600190565b6020808252600e908201526d1499595b9d1c985b9d0818d85b1b60921b604082015260600190565b6020808252601c908201527f43616c6c6572206973206e6f7420746865205374726174656769737400000000604082015260600190565b6000808335601e1984360301811261462b57600080fd5b8301803591506001600160401b0382111561464557600080fd5b602001915036819003821315613a7357600080fd5b60008235605e198336030181126141c757600080fd5b604051601f8201601f191681016001600160401b038111828210171561469857614698614813565b604052919050565b60006001600160401b038211156146b9576146b9614813565b5060051b60200190565b600080821280156001600160ff1b03849003851316156146e5576146e56147bb565b600160ff1b83900384128116156146fe576146fe6147bb565b50500190565b60008219821115614717576147176147bb565b500190565b60008261473957634e487b7160e01b600052601260045260246000fd5b500490565b6000816000190483118215151615614758576147586147bb565b500290565b60008282101561476f5761476f6147bb565b500390565b60005b8381101561478f578181015183820152602001614777565b83811115610d305750506000910152565b60006000198214156147b4576147b46147bb565b5060010190565b634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052603160045260246000fd5b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052604160045260246000fd5b6001600160a01b038116811461237857600080fd5b801515811461237857600080fdfe53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac45357bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa264697066735822122002c6785cb55b316b2eea75081179f6e1764ee917e56d0fc72bd1ea4c6b39fa5064736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", diff --git a/contracts/deployments/holesky/NativeStakingSSVStrategyProxy.json b/contracts/deployments/holesky/NativeStakingSSVStrategyProxy.json index e6e3625aba..0972da0b7d 100644 --- a/contracts/deployments/holesky/NativeStakingSSVStrategyProxy.json +++ b/contracts/deployments/holesky/NativeStakingSSVStrategyProxy.json @@ -1,5 +1,5 @@ { - "address": "0x4Eac8847c7AE50e3A3551B1Aa4FF7Cc162151410", + "address": "0xcf4a9e80Ddb173cc17128A361B98B9A140e3932E", "abi": [ { "anonymous": false, @@ -183,40 +183,40 @@ "type": "function" } ], - "transactionHash": "0x8f9577961a6ba3cd743d72c27db2c8f2472a6c26a58fc73150fc25a4cd371ad5", + "transactionHash": "0x25f06b54b637b629c9dda47e609ed96ae2583c17f6368f4b9983f0e7171d6c43", "receipt": { "to": null, "from": "0x1b94CA50D3Ad9f8368851F8526132272d1a5028C", - "contractAddress": "0x4Eac8847c7AE50e3A3551B1Aa4FF7Cc162151410", - "transactionIndex": 46, + "contractAddress": "0xcf4a9e80Ddb173cc17128A361B98B9A140e3932E", + "transactionIndex": 18, "gasUsed": "580428", - "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000020000000004000000000800000000000000000000000000080000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000", - "blockHash": "0xc04b8dec47c654e4489a465ba27058787f5aeb4496c2d3026f3ca88b9f690e3e", - "transactionHash": "0x8f9577961a6ba3cd743d72c27db2c8f2472a6c26a58fc73150fc25a4cd371ad5", + "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000800000000000000000000000000000000000004000000000000002000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000010200000000000800000000000000000000000000020000000000000000000000000000000000000000000000000000000000000008000", + "blockHash": "0xfa1ddfe7e2895d3ea20b590cbee2013a0622f3f1d06047bda7e0dc9c23edda63", + "transactionHash": "0x25f06b54b637b629c9dda47e609ed96ae2583c17f6368f4b9983f0e7171d6c43", "logs": [ { - "transactionIndex": 46, - "blockNumber": 1405102, - "transactionHash": "0x8f9577961a6ba3cd743d72c27db2c8f2472a6c26a58fc73150fc25a4cd371ad5", - "address": "0x4Eac8847c7AE50e3A3551B1Aa4FF7Cc162151410", + "transactionIndex": 18, + "blockNumber": 1489362, + "transactionHash": "0x25f06b54b637b629c9dda47e609ed96ae2583c17f6368f4b9983f0e7171d6c43", + "address": "0xcf4a9e80Ddb173cc17128A361B98B9A140e3932E", "topics": [ "0xc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000001b94ca50d3ad9f8368851f8526132272d1a5028c" ], "data": "0x", - "logIndex": 56, - "blockHash": "0xc04b8dec47c654e4489a465ba27058787f5aeb4496c2d3026f3ca88b9f690e3e" + "logIndex": 45, + "blockHash": "0xfa1ddfe7e2895d3ea20b590cbee2013a0622f3f1d06047bda7e0dc9c23edda63" } ], - "blockNumber": 1405102, - "cumulativeGasUsed": "6315195", + "blockNumber": 1489362, + "cumulativeGasUsed": "3002183", "status": 1, "byzantium": true }, "args": [], "numDeployments": 1, - "solcInputHash": "da4c2bc4af0be4b969e54f8b43895033", + "solcInputHash": "5e7101910c63b5cb160cf1f36fa86058", "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"GovernorshipTransferred\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"previousGovernor\",\"type\":\"address\"},{\"indexed\":true,\"internalType\":\"address\",\"name\":\"newGovernor\",\"type\":\"address\"}],\"name\":\"PendingGovernorshipTransfer\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":true,\"internalType\":\"address\",\"name\":\"implementation\",\"type\":\"address\"}],\"name\":\"Upgraded\",\"type\":\"event\"},{\"stateMutability\":\"payable\",\"type\":\"fallback\"},{\"inputs\":[],\"name\":\"admin\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"claimGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"governor\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"implementation\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_logic\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"_initGovernor\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"_data\",\"type\":\"bytes\"}],\"name\":\"initialize\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isGovernor\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"_newGovernor\",\"type\":\"address\"}],\"name\":\"transferGovernance\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"}],\"name\":\"upgradeTo\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newImplementation\",\"type\":\"address\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"upgradeToAndCall\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"admin()\":{\"returns\":{\"_0\":\"The address of the proxy admin/it's also the governor.\"}},\"implementation()\":{\"returns\":{\"_0\":\"The address of the implementation.\"}},\"initialize(address,address,bytes)\":{\"details\":\"Contract initializer with Governor enforcement\",\"params\":{\"_data\":\"Data to send as msg.data to the implementation to initialize the proxied contract. It should include the signature and the parameters of the function to be called, as described in https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding. This parameter is optional, if no data is given the initialization call to proxied contract will be skipped.\",\"_initGovernor\":\"Address of the initial Governor.\",\"_logic\":\"Address of the initial implementation.\"}},\"transferGovernance(address)\":{\"params\":{\"_newGovernor\":\"Address of the new Governor\"}},\"upgradeTo(address)\":{\"details\":\"Upgrade the backing implementation of the proxy. Only the admin can call this function.\",\"params\":{\"newImplementation\":\"Address of the new implementation.\"}},\"upgradeToAndCall(address,bytes)\":{\"details\":\"Upgrade the backing implementation of the proxy and call a function on the new implementation. This is useful to initialize the proxied contract.\",\"params\":{\"data\":\"Data to send as msg.data in the low level call. It should include the signature and the parameters of the function to be called, as described in https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\",\"newImplementation\":\"Address of the new implementation.\"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"claimGovernance()\":{\"notice\":\"Claim Governance of the contract to a new account (`newGovernor`). Can only be called by the new Governor.\"},\"governor()\":{\"notice\":\"Returns the address of the current Governor.\"},\"isGovernor()\":{\"notice\":\"Returns true if the caller is the current Governor.\"},\"transferGovernance(address)\":{\"notice\":\"Transfers Governance of the contract to a new account (`newGovernor`). Can only be called by the current Governor. Must be claimed for this to complete\"}},\"notice\":\"NativeStakingSSVStrategyProxy delegates calls to NativeStakingSSVStrategy implementation\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/proxies/Proxies.sol\":\"NativeStakingSSVStrategyProxy\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@openzeppelin/contracts/utils/Address.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\\n\\npragma solidity ^0.8.0;\\n\\n/**\\n * @dev Collection of functions related to the address type\\n */\\nlibrary Address {\\n /**\\n * @dev Returns true if `account` is a contract.\\n *\\n * [IMPORTANT]\\n * ====\\n * It is unsafe to assume that an address for which this function returns\\n * false is an externally-owned account (EOA) and not a contract.\\n *\\n * Among others, `isContract` will return false for the following\\n * types of addresses:\\n *\\n * - an externally-owned account\\n * - a contract in construction\\n * - an address where a contract will be created\\n * - an address where a contract lived, but was destroyed\\n * ====\\n */\\n function isContract(address account) internal view returns (bool) {\\n // This method relies on extcodesize, which returns 0 for contracts in\\n // construction, since the code is only stored at the end of the\\n // constructor execution.\\n\\n uint256 size;\\n assembly {\\n size := extcodesize(account)\\n }\\n return size > 0;\\n }\\n\\n /**\\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\\n * `recipient`, forwarding all available gas and reverting on errors.\\n *\\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\\n * imposed by `transfer`, making them unable to receive funds via\\n * `transfer`. {sendValue} removes this limitation.\\n *\\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\\n *\\n * IMPORTANT: because control is transferred to `recipient`, care must be\\n * taken to not create reentrancy vulnerabilities. Consider using\\n * {ReentrancyGuard} or the\\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\\n */\\n function sendValue(address payable recipient, uint256 amount) internal {\\n require(address(this).balance >= amount, \\\"Address: insufficient balance\\\");\\n\\n (bool success, ) = recipient.call{value: amount}(\\\"\\\");\\n require(success, \\\"Address: unable to send value, recipient may have reverted\\\");\\n }\\n\\n /**\\n * @dev Performs a Solidity function call using a low level `call`. A\\n * plain `call` is an unsafe replacement for a function call: use this\\n * function instead.\\n *\\n * If `target` reverts with a revert reason, it is bubbled up by this\\n * function (like regular Solidity function calls).\\n *\\n * Returns the raw returned data. To convert to the expected return value,\\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\\n *\\n * Requirements:\\n *\\n * - `target` must be a contract.\\n * - calling `target` with `data` must not revert.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionCall(target, data, \\\"Address: low-level call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\\n * `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, 0, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but also transferring `value` wei to `target`.\\n *\\n * Requirements:\\n *\\n * - the calling contract must have an ETH balance of at least `value`.\\n * - the called Solidity function must be `payable`.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value\\n ) internal returns (bytes memory) {\\n return functionCallWithValue(target, data, value, \\\"Address: low-level call with value failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\\n * with `errorMessage` as a fallback revert reason when `target` reverts.\\n *\\n * _Available since v3.1._\\n */\\n function functionCallWithValue(\\n address target,\\n bytes memory data,\\n uint256 value,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(address(this).balance >= value, \\\"Address: insufficient balance for call\\\");\\n require(isContract(target), \\\"Address: call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.call{value: value}(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\\n return functionStaticCall(target, data, \\\"Address: low-level static call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a static call.\\n *\\n * _Available since v3.3._\\n */\\n function functionStaticCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal view returns (bytes memory) {\\n require(isContract(target), \\\"Address: static call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.staticcall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\\n return functionDelegateCall(target, data, \\\"Address: low-level delegate call failed\\\");\\n }\\n\\n /**\\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\\n * but performing a delegate call.\\n *\\n * _Available since v3.4._\\n */\\n function functionDelegateCall(\\n address target,\\n bytes memory data,\\n string memory errorMessage\\n ) internal returns (bytes memory) {\\n require(isContract(target), \\\"Address: delegate call to non-contract\\\");\\n\\n (bool success, bytes memory returndata) = target.delegatecall(data);\\n return verifyCallResult(success, returndata, errorMessage);\\n }\\n\\n /**\\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\\n * revert reason using the provided one.\\n *\\n * _Available since v4.3._\\n */\\n function verifyCallResult(\\n bool success,\\n bytes memory returndata,\\n string memory errorMessage\\n ) internal pure returns (bytes memory) {\\n if (success) {\\n return returndata;\\n } else {\\n // Look for revert reason and bubble it up if present\\n if (returndata.length > 0) {\\n // The easiest way to bubble the revert reason is using memory via assembly\\n\\n assembly {\\n let returndata_size := mload(returndata)\\n revert(add(32, returndata), returndata_size)\\n }\\n } else {\\n revert(errorMessage);\\n }\\n }\\n }\\n}\\n\",\"keccak256\":\"0x51b758a8815ecc9596c66c37d56b1d33883a444631a3f916b9fe65cb863ef7c4\",\"license\":\"MIT\"},\"contracts/governance/Governable.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\n/**\\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\\n * from owner to governor and renounce methods removed. Does not use\\n * Context.sol like Ownable.sol does for simplification.\\n * @author Origin Protocol Inc\\n */\\ncontract Governable {\\n // Storage position of the owner and pendingOwner of the contract\\n // keccak256(\\\"OUSD.governor\\\");\\n bytes32 private constant governorPosition =\\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\\n\\n // keccak256(\\\"OUSD.pending.governor\\\");\\n bytes32 private constant pendingGovernorPosition =\\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\\n\\n // keccak256(\\\"OUSD.reentry.status\\\");\\n bytes32 private constant reentryStatusPosition =\\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\\n\\n // See OpenZeppelin ReentrancyGuard implementation\\n uint256 constant _NOT_ENTERED = 1;\\n uint256 constant _ENTERED = 2;\\n\\n event PendingGovernorshipTransfer(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n event GovernorshipTransferred(\\n address indexed previousGovernor,\\n address indexed newGovernor\\n );\\n\\n /**\\n * @dev Initializes the contract setting the deployer as the initial Governor.\\n */\\n constructor() {\\n _setGovernor(msg.sender);\\n emit GovernorshipTransferred(address(0), _governor());\\n }\\n\\n /**\\n * @notice Returns the address of the current Governor.\\n */\\n function governor() public view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @dev Returns the address of the current Governor.\\n */\\n function _governor() internal view returns (address governorOut) {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n governorOut := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Returns the address of the pending Governor.\\n */\\n function _pendingGovernor()\\n internal\\n view\\n returns (address pendingGovernor)\\n {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n pendingGovernor := sload(position)\\n }\\n }\\n\\n /**\\n * @dev Throws if called by any account other than the Governor.\\n */\\n modifier onlyGovernor() {\\n require(isGovernor(), \\\"Caller is not the Governor\\\");\\n _;\\n }\\n\\n /**\\n * @notice Returns true if the caller is the current Governor.\\n */\\n function isGovernor() public view returns (bool) {\\n return msg.sender == _governor();\\n }\\n\\n function _setGovernor(address newGovernor) internal {\\n bytes32 position = governorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @dev Prevents a contract from calling itself, directly or indirectly.\\n * Calling a `nonReentrant` function from another `nonReentrant`\\n * function is not supported. It is possible to prevent this from happening\\n * by making the `nonReentrant` function external, and make it call a\\n * `private` function that does the actual work.\\n */\\n modifier nonReentrant() {\\n bytes32 position = reentryStatusPosition;\\n uint256 _reentry_status;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n _reentry_status := sload(position)\\n }\\n\\n // On the first call to nonReentrant, _notEntered will be true\\n require(_reentry_status != _ENTERED, \\\"Reentrant call\\\");\\n\\n // Any calls to nonReentrant after this point will fail\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _ENTERED)\\n }\\n\\n _;\\n\\n // By storing the original value once again, a refund is triggered (see\\n // https://eips.ethereum.org/EIPS/eip-2200)\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, _NOT_ENTERED)\\n }\\n }\\n\\n function _setPendingGovernor(address newGovernor) internal {\\n bytes32 position = pendingGovernorPosition;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(position, newGovernor)\\n }\\n }\\n\\n /**\\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the current Governor. Must be claimed for this to complete\\n * @param _newGovernor Address of the new Governor\\n */\\n function transferGovernance(address _newGovernor) external onlyGovernor {\\n _setPendingGovernor(_newGovernor);\\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\\n }\\n\\n /**\\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\\n * Can only be called by the new Governor.\\n */\\n function claimGovernance() external {\\n require(\\n msg.sender == _pendingGovernor(),\\n \\\"Only the pending Governor can complete the claim\\\"\\n );\\n _changeGovernor(msg.sender);\\n }\\n\\n /**\\n * @dev Change Governance of the contract to a new account (`newGovernor`).\\n * @param _newGovernor Address of the new Governor\\n */\\n function _changeGovernor(address _newGovernor) internal {\\n require(_newGovernor != address(0), \\\"New Governor is address(0)\\\");\\n emit GovernorshipTransferred(_governor(), _newGovernor);\\n _setGovernor(_newGovernor);\\n }\\n}\\n\",\"keccak256\":\"0xb7133d6ce7a9e673ff79fcedb3fd41ae6e58e251f94915bb65731abe524270b4\",\"license\":\"MIT\"},\"contracts/proxies/InitializeGovernedUpgradeabilityProxy.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { Address } from \\\"@openzeppelin/contracts/utils/Address.sol\\\";\\n\\nimport { Governable } from \\\"../governance/Governable.sol\\\";\\n\\n/**\\n * @title BaseGovernedUpgradeabilityProxy\\n * @dev This contract combines an upgradeability proxy with our governor system.\\n * It is based on an older version of OpenZeppelins BaseUpgradeabilityProxy\\n * with Solidity ^0.8.0.\\n * @author Origin Protocol Inc\\n */\\ncontract InitializeGovernedUpgradeabilityProxy is Governable {\\n /**\\n * @dev Emitted when the implementation is upgraded.\\n * @param implementation Address of the new implementation.\\n */\\n event Upgraded(address indexed implementation);\\n\\n /**\\n * @dev Contract initializer with Governor enforcement\\n * @param _logic Address of the initial implementation.\\n * @param _initGovernor Address of the initial Governor.\\n * @param _data Data to send as msg.data to the implementation to initialize\\n * the proxied contract.\\n * It should include the signature and the parameters of the function to be\\n * called, as described in\\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\\n * This parameter is optional, if no data is given the initialization call\\n * to proxied contract will be skipped.\\n */\\n function initialize(\\n address _logic,\\n address _initGovernor,\\n bytes calldata _data\\n ) public payable onlyGovernor {\\n require(_implementation() == address(0));\\n assert(\\n IMPLEMENTATION_SLOT ==\\n bytes32(uint256(keccak256(\\\"eip1967.proxy.implementation\\\")) - 1)\\n );\\n _setImplementation(_logic);\\n if (_data.length > 0) {\\n (bool success, ) = _logic.delegatecall(_data);\\n require(success);\\n }\\n _changeGovernor(_initGovernor);\\n }\\n\\n /**\\n * @return The address of the proxy admin/it's also the governor.\\n */\\n function admin() external view returns (address) {\\n return _governor();\\n }\\n\\n /**\\n * @return The address of the implementation.\\n */\\n function implementation() external view returns (address) {\\n return _implementation();\\n }\\n\\n /**\\n * @dev Upgrade the backing implementation of the proxy.\\n * Only the admin can call this function.\\n * @param newImplementation Address of the new implementation.\\n */\\n function upgradeTo(address newImplementation) external onlyGovernor {\\n _upgradeTo(newImplementation);\\n }\\n\\n /**\\n * @dev Upgrade the backing implementation of the proxy and call a function\\n * on the new implementation.\\n * This is useful to initialize the proxied contract.\\n * @param newImplementation Address of the new implementation.\\n * @param data Data to send as msg.data in the low level call.\\n * It should include the signature and the parameters of the function to be called, as described in\\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\\n */\\n function upgradeToAndCall(address newImplementation, bytes calldata data)\\n external\\n payable\\n onlyGovernor\\n {\\n _upgradeTo(newImplementation);\\n (bool success, ) = newImplementation.delegatecall(data);\\n require(success);\\n }\\n\\n /**\\n * @dev Fallback function.\\n * Implemented entirely in `_fallback`.\\n */\\n fallback() external payable {\\n _fallback();\\n }\\n\\n /**\\n * @dev Delegates execution to an implementation contract.\\n * This is a low level function that doesn't return to its internal call site.\\n * It will return to the external caller whatever the implementation returns.\\n * @param _impl Address to delegate.\\n */\\n function _delegate(address _impl) internal {\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n // Copy msg.data. We take full control of memory in this inline assembly\\n // block because it will not return to Solidity code. We overwrite the\\n // Solidity scratch pad at memory position 0.\\n calldatacopy(0, 0, calldatasize())\\n\\n // Call the implementation.\\n // out and outsize are 0 because we don't know the size yet.\\n let result := delegatecall(gas(), _impl, 0, calldatasize(), 0, 0)\\n\\n // Copy the returned data.\\n returndatacopy(0, 0, returndatasize())\\n\\n switch result\\n // delegatecall returns 0 on error.\\n case 0 {\\n revert(0, returndatasize())\\n }\\n default {\\n return(0, returndatasize())\\n }\\n }\\n }\\n\\n /**\\n * @dev Function that is run as the first thing in the fallback function.\\n * Can be redefined in derived contracts to add functionality.\\n * Redefinitions must call super._willFallback().\\n */\\n function _willFallback() internal {}\\n\\n /**\\n * @dev fallback implementation.\\n * Extracted to enable manual triggering.\\n */\\n function _fallback() internal {\\n _willFallback();\\n _delegate(_implementation());\\n }\\n\\n /**\\n * @dev Storage slot with the address of the current implementation.\\n * This is the keccak-256 hash of \\\"eip1967.proxy.implementation\\\" subtracted by 1, and is\\n * validated in the constructor.\\n */\\n bytes32 internal constant IMPLEMENTATION_SLOT =\\n 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n /**\\n * @dev Returns the current implementation.\\n * @return impl Address of the current implementation\\n */\\n function _implementation() internal view returns (address impl) {\\n bytes32 slot = IMPLEMENTATION_SLOT;\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n impl := sload(slot)\\n }\\n }\\n\\n /**\\n * @dev Upgrades the proxy to a new implementation.\\n * @param newImplementation Address of the new implementation.\\n */\\n function _upgradeTo(address newImplementation) internal {\\n _setImplementation(newImplementation);\\n emit Upgraded(newImplementation);\\n }\\n\\n /**\\n * @dev Sets the implementation address of the proxy.\\n * @param newImplementation Address of the new implementation.\\n */\\n function _setImplementation(address newImplementation) internal {\\n require(\\n Address.isContract(newImplementation),\\n \\\"Cannot set a proxy implementation to a non-contract address\\\"\\n );\\n\\n bytes32 slot = IMPLEMENTATION_SLOT;\\n\\n // solhint-disable-next-line no-inline-assembly\\n assembly {\\n sstore(slot, newImplementation)\\n }\\n }\\n}\\n\",\"keccak256\":\"0xcf9bc33957fa41a745726edb6461a4bddca875a038c848286a059f0f22b7f184\",\"license\":\"MIT\"},\"contracts/proxies/Proxies.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity ^0.8.0;\\n\\nimport { InitializeGovernedUpgradeabilityProxy } from \\\"./InitializeGovernedUpgradeabilityProxy.sol\\\";\\n\\n/**\\n * @notice OUSDProxy delegates calls to an OUSD implementation\\n */\\ncontract OUSDProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice WrappedOUSDProxy delegates calls to a WrappedOUSD implementation\\n */\\ncontract WrappedOUSDProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice VaultProxy delegates calls to a Vault implementation\\n */\\ncontract VaultProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice CompoundStrategyProxy delegates calls to a CompoundStrategy implementation\\n */\\ncontract CompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice AaveStrategyProxy delegates calls to a AaveStrategy implementation\\n */\\ncontract AaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ThreePoolStrategyProxy delegates calls to a ThreePoolStrategy implementation\\n */\\ncontract ThreePoolStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ConvexStrategyProxy delegates calls to a ConvexStrategy implementation\\n */\\ncontract ConvexStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice HarvesterProxy delegates calls to a Harvester implementation\\n */\\ncontract HarvesterProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice DripperProxy delegates calls to a Dripper implementation\\n */\\ncontract DripperProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice MorphoCompoundStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\\n */\\ncontract MorphoCompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ConvexOUSDMetaStrategyProxy delegates calls to a ConvexOUSDMetaStrategy implementation\\n */\\ncontract ConvexOUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice ConvexLUSDMetaStrategyProxy delegates calls to a ConvexalGeneralizedMetaStrategy implementation\\n */\\ncontract ConvexLUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice MorphoAaveStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\\n */\\ncontract MorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHProxy delegates calls to nowhere for now\\n */\\ncontract OETHProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice WOETHProxy delegates calls to nowhere for now\\n */\\ncontract WOETHProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHVaultProxy delegates calls to a Vault implementation\\n */\\ncontract OETHVaultProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHDripperProxy delegates calls to a OETHDripper implementation\\n */\\ncontract OETHDripperProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHHarvesterProxy delegates calls to a Harvester implementation\\n */\\ncontract OETHHarvesterProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice FraxETHStrategyProxy delegates calls to a FraxETHStrategy implementation\\n */\\ncontract FraxETHStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice CurveEthStrategyProxy delegates calls to a CurveEthStrategy implementation\\n */\\ncontract ConvexEthMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice BuybackProxy delegates calls to Buyback implementation\\n */\\ncontract BuybackProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHMorphoAaveStrategyProxy delegates calls to a MorphoAaveStrategy implementation\\n */\\ncontract OETHMorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHBalancerMetaPoolrEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\\n */\\ncontract OETHBalancerMetaPoolrEthStrategyProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\\n/**\\n * @notice OETHBalancerMetaPoolwstEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\\n */\\ncontract OETHBalancerMetaPoolwstEthStrategyProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\\n/**\\n * @notice FluxStrategyProxy delegates calls to a CompoundStrategy implementation\\n */\\ncontract FluxStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice MakerDsrStrategyProxy delegates calls to a Generalized4626Strategy implementation\\n */\\ncontract MakerDsrStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice FrxEthRedeemStrategyProxy delegates calls to a FrxEthRedeemStrategy implementation\\n */\\ncontract FrxEthRedeemStrategyProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice OETHBuybackProxy delegates calls to Buyback implementation\\n */\\ncontract OETHBuybackProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice BridgedWOETHProxy delegates calls to BridgedWOETH implementation\\n */\\ncontract BridgedWOETHProxy is InitializeGovernedUpgradeabilityProxy {\\n\\n}\\n\\n/**\\n * @notice NativeStakingSSVStrategyProxy delegates calls to NativeStakingSSVStrategy implementation\\n */\\ncontract NativeStakingSSVStrategyProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\\n/**\\n * @notice NativeStakingFeeAccumulatorProxy delegates calls to NativeStakingFeeCollector implementation\\n */\\ncontract NativeStakingFeeAccumulatorProxy is\\n InitializeGovernedUpgradeabilityProxy\\n{\\n\\n}\\n\",\"keccak256\":\"0x2e294507edd91494e1020a2a1c43502d2f5cba01266c228406562ecde7a2d872\",\"license\":\"MIT\"}},\"version\":1}", "bytecode": "0x608060405234801561001057600080fd5b506100273360008051602061099083398151915255565b600080516020610990833981519152546040516001600160a01b03909116906000907fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a908290a36109138061007d6000396000f3fe6080604052600436106100865760003560e01c80635d36b190116100595780635d36b1901461010a578063c7af33521461011f578063cf7a1d7714610144578063d38bfff414610157578063f851a4401461009057610086565b80630c340a24146100905780633659cfe6146100c25780634f1ef286146100e25780635c60da1b146100f5575b61008e610177565b005b34801561009c57600080fd5b506100a5610197565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156100ce57600080fd5b5061008e6100dd366004610745565b6101b4565b61008e6100f03660046107c8565b6101ed565b34801561010157600080fd5b506100a561028a565b34801561011657600080fd5b5061008e6102a2565b34801561012b57600080fd5b50610134610346565b60405190151581526020016100b9565b61008e610152366004610767565b610377565b34801561016357600080fd5b5061008e610172366004610745565b610491565b61019561019060008051602061089e8339815191525490565b610535565b565b60006101af6000805160206108be8339815191525490565b905090565b6101bc610346565b6101e15760405162461bcd60e51b81526004016101d89061082b565b60405180910390fd5b6101ea81610559565b50565b6101f5610346565b6102115760405162461bcd60e51b81526004016101d89061082b565b61021a83610559565b6000836001600160a01b0316838360405161023692919061081b565b600060405180830381855af49150503d8060008114610271576040519150601f19603f3d011682016040523d82523d6000602084013e610276565b606091505b505090508061028457600080fd5b50505050565b60006101af60008051602061089e8339815191525490565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b03161461033d5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b60648201526084016101d8565b61019533610599565b600061035e6000805160206108be8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b61037f610346565b61039b5760405162461bcd60e51b81526004016101d89061082b565b60006103b360008051602061089e8339815191525490565b6001600160a01b0316146103c657600080fd5b6103f160017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd610862565b60008051602061089e8339815191521461040d5761040d610887565b6104168461065a565b8015610488576000846001600160a01b0316838360405161043892919061081b565b600060405180830381855af49150503d8060008114610473576040519150601f19603f3d011682016040523d82523d6000602084013e610478565b606091505b505090508061048657600080fd5b505b61028483610599565b610499610346565b6104b55760405162461bcd60e51b81526004016101d89061082b565b6104dd817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b03166104fd6000805160206108be8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b3660008037600080366000845af43d6000803e808015610554573d6000f35b3d6000fd5b6105628161065a565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6001600160a01b0381166105ef5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f72206973206164647265737328302900000000000060448201526064016101d8565b806001600160a01b031661060f6000805160206108be8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36101ea816000805160206108be83398151915255565b803b6106ce5760405162461bcd60e51b815260206004820152603b60248201527f43616e6e6f742073657420612070726f787920696d706c656d656e746174696f60448201527f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000060648201526084016101d8565b60008051602061089e83398151915255565b80356001600160a01b03811681146106f757600080fd5b919050565b60008083601f84011261070e57600080fd5b50813567ffffffffffffffff81111561072657600080fd5b60208301915083602082850101111561073e57600080fd5b9250929050565b60006020828403121561075757600080fd5b610760826106e0565b9392505050565b6000806000806060858703121561077d57600080fd5b610786856106e0565b9350610794602086016106e0565b9250604085013567ffffffffffffffff8111156107b057600080fd5b6107bc878288016106fc565b95989497509550505050565b6000806000604084860312156107dd57600080fd5b6107e6846106e0565b9250602084013567ffffffffffffffff81111561080257600080fd5b61080e868287016106fc565b9497909650939450505050565b8183823760009101908152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60008282101561088257634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fdfe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212203019a79a43f7d4ec89620197adcc99852be5f4965adfb8a6bbb0ad3954812e2c64736f6c634300080700337bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a", "deployedBytecode": "0x6080604052600436106100865760003560e01c80635d36b190116100595780635d36b1901461010a578063c7af33521461011f578063cf7a1d7714610144578063d38bfff414610157578063f851a4401461009057610086565b80630c340a24146100905780633659cfe6146100c25780634f1ef286146100e25780635c60da1b146100f5575b61008e610177565b005b34801561009c57600080fd5b506100a5610197565b6040516001600160a01b0390911681526020015b60405180910390f35b3480156100ce57600080fd5b5061008e6100dd366004610745565b6101b4565b61008e6100f03660046107c8565b6101ed565b34801561010157600080fd5b506100a561028a565b34801561011657600080fd5b5061008e6102a2565b34801561012b57600080fd5b50610134610346565b60405190151581526020016100b9565b61008e610152366004610767565b610377565b34801561016357600080fd5b5061008e610172366004610745565b610491565b61019561019060008051602061089e8339815191525490565b610535565b565b60006101af6000805160206108be8339815191525490565b905090565b6101bc610346565b6101e15760405162461bcd60e51b81526004016101d89061082b565b60405180910390fd5b6101ea81610559565b50565b6101f5610346565b6102115760405162461bcd60e51b81526004016101d89061082b565b61021a83610559565b6000836001600160a01b0316838360405161023692919061081b565b600060405180830381855af49150503d8060008114610271576040519150601f19603f3d011682016040523d82523d6000602084013e610276565b606091505b505090508061028457600080fd5b50505050565b60006101af60008051602061089e8339815191525490565b7f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db546001600160a01b0316336001600160a01b03161461033d5760405162461bcd60e51b815260206004820152603060248201527f4f6e6c79207468652070656e64696e6720476f7665726e6f722063616e20636f60448201526f6d706c6574652074686520636c61696d60801b60648201526084016101d8565b61019533610599565b600061035e6000805160206108be8339815191525490565b6001600160a01b0316336001600160a01b031614905090565b61037f610346565b61039b5760405162461bcd60e51b81526004016101d89061082b565b60006103b360008051602061089e8339815191525490565b6001600160a01b0316146103c657600080fd5b6103f160017f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbd610862565b60008051602061089e8339815191521461040d5761040d610887565b6104168461065a565b8015610488576000846001600160a01b0316838360405161043892919061081b565b600060405180830381855af49150503d8060008114610473576040519150601f19603f3d011682016040523d82523d6000602084013e610478565b606091505b505090508061048657600080fd5b505b61028483610599565b610499610346565b6104b55760405162461bcd60e51b81526004016101d89061082b565b6104dd817f44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db55565b806001600160a01b03166104fd6000805160206108be8339815191525490565b6001600160a01b03167fa39cc5eb22d0f34d8beaefee8a3f17cc229c1a1d1ef87a5ad47313487b1c4f0d60405160405180910390a350565b3660008037600080366000845af43d6000803e808015610554573d6000f35b3d6000fd5b6105628161065a565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6001600160a01b0381166105ef5760405162461bcd60e51b815260206004820152601a60248201527f4e657720476f7665726e6f72206973206164647265737328302900000000000060448201526064016101d8565b806001600160a01b031661060f6000805160206108be8339815191525490565b6001600160a01b03167fc7c0c772add429241571afb3805861fb3cfa2af374534088b76cdb4325a87e9a60405160405180910390a36101ea816000805160206108be83398151915255565b803b6106ce5760405162461bcd60e51b815260206004820152603b60248201527f43616e6e6f742073657420612070726f787920696d706c656d656e746174696f60448201527f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000060648201526084016101d8565b60008051602061089e83398151915255565b80356001600160a01b03811681146106f757600080fd5b919050565b60008083601f84011261070e57600080fd5b50813567ffffffffffffffff81111561072657600080fd5b60208301915083602082850101111561073e57600080fd5b9250929050565b60006020828403121561075757600080fd5b610760826106e0565b9392505050565b6000806000806060858703121561077d57600080fd5b610786856106e0565b9350610794602086016106e0565b9250604085013567ffffffffffffffff8111156107b057600080fd5b6107bc878288016106fc565b95989497509550505050565b6000806000604084860312156107dd57600080fd5b6107e6846106e0565b9250602084013567ffffffffffffffff81111561080257600080fd5b61080e868287016106fc565b9497909650939450505050565b8183823760009101908152919050565b6020808252601a908201527f43616c6c6572206973206e6f742074686520476f7665726e6f72000000000000604082015260600190565b60008282101561088257634e487b7160e01b600052601160045260246000fd5b500390565b634e487b7160e01b600052600160045260246000fdfe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4aa26469706673582212203019a79a43f7d4ec89620197adcc99852be5f4965adfb8a6bbb0ad3954812e2c64736f6c63430008070033", diff --git a/contracts/deployments/holesky/solcInputs/5e7101910c63b5cb160cf1f36fa86058.json b/contracts/deployments/holesky/solcInputs/5e7101910c63b5cb160cf1f36fa86058.json new file mode 100644 index 0000000000..8b8b49dee9 --- /dev/null +++ b/contracts/deployments/holesky/solcInputs/5e7101910c63b5cb160cf1f36fa86058.json @@ -0,0 +1,44 @@ +{ + "language": "Solidity", + "sources": { + "@openzeppelin/contracts/utils/Address.sol": { + "content": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/Address.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary Address {\n /**\n * @dev Returns true if `account` is a contract.\n *\n * [IMPORTANT]\n * ====\n * It is unsafe to assume that an address for which this function returns\n * false is an externally-owned account (EOA) and not a contract.\n *\n * Among others, `isContract` will return false for the following\n * types of addresses:\n *\n * - an externally-owned account\n * - a contract in construction\n * - an address where a contract will be created\n * - an address where a contract lived, but was destroyed\n * ====\n */\n function isContract(address account) internal view returns (bool) {\n // This method relies on extcodesize, which returns 0 for contracts in\n // construction, since the code is only stored at the end of the\n // constructor execution.\n\n uint256 size;\n assembly {\n size := extcodesize(account)\n }\n return size > 0;\n }\n\n /**\n * @dev Replacement for Solidity's `transfer`: sends `amount` wei to\n * `recipient`, forwarding all available gas and reverting on errors.\n *\n * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost\n * of certain opcodes, possibly making contracts go over the 2300 gas limit\n * imposed by `transfer`, making them unable to receive funds via\n * `transfer`. {sendValue} removes this limitation.\n *\n * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].\n *\n * IMPORTANT: because control is transferred to `recipient`, care must be\n * taken to not create reentrancy vulnerabilities. Consider using\n * {ReentrancyGuard} or the\n * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].\n */\n function sendValue(address payable recipient, uint256 amount) internal {\n require(address(this).balance >= amount, \"Address: insufficient balance\");\n\n (bool success, ) = recipient.call{value: amount}(\"\");\n require(success, \"Address: unable to send value, recipient may have reverted\");\n }\n\n /**\n * @dev Performs a Solidity function call using a low level `call`. A\n * plain `call` is an unsafe replacement for a function call: use this\n * function instead.\n *\n * If `target` reverts with a revert reason, it is bubbled up by this\n * function (like regular Solidity function calls).\n *\n * Returns the raw returned data. To convert to the expected return value,\n * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].\n *\n * Requirements:\n *\n * - `target` must be a contract.\n * - calling `target` with `data` must not revert.\n *\n * _Available since v3.1._\n */\n function functionCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionCall(target, data, \"Address: low-level call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with\n * `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, 0, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but also transferring `value` wei to `target`.\n *\n * Requirements:\n *\n * - the calling contract must have an ETH balance of at least `value`.\n * - the called Solidity function must be `payable`.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value\n ) internal returns (bytes memory) {\n return functionCallWithValue(target, data, value, \"Address: low-level call with value failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but\n * with `errorMessage` as a fallback revert reason when `target` reverts.\n *\n * _Available since v3.1._\n */\n function functionCallWithValue(\n address target,\n bytes memory data,\n uint256 value,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(address(this).balance >= value, \"Address: insufficient balance for call\");\n require(isContract(target), \"Address: call to non-contract\");\n\n (bool success, bytes memory returndata) = target.call{value: value}(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {\n return functionStaticCall(target, data, \"Address: low-level static call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a static call.\n *\n * _Available since v3.3._\n */\n function functionStaticCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal view returns (bytes memory) {\n require(isContract(target), \"Address: static call to non-contract\");\n\n (bool success, bytes memory returndata) = target.staticcall(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {\n return functionDelegateCall(target, data, \"Address: low-level delegate call failed\");\n }\n\n /**\n * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],\n * but performing a delegate call.\n *\n * _Available since v3.4._\n */\n function functionDelegateCall(\n address target,\n bytes memory data,\n string memory errorMessage\n ) internal returns (bytes memory) {\n require(isContract(target), \"Address: delegate call to non-contract\");\n\n (bool success, bytes memory returndata) = target.delegatecall(data);\n return verifyCallResult(success, returndata, errorMessage);\n }\n\n /**\n * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the\n * revert reason using the provided one.\n *\n * _Available since v4.3._\n */\n function verifyCallResult(\n bool success,\n bytes memory returndata,\n string memory errorMessage\n ) internal pure returns (bytes memory) {\n if (success) {\n return returndata;\n } else {\n // Look for revert reason and bubble it up if present\n if (returndata.length > 0) {\n // The easiest way to bubble the revert reason is using memory via assembly\n\n assembly {\n let returndata_size := mload(returndata)\n revert(add(32, returndata), returndata_size)\n }\n } else {\n revert(errorMessage);\n }\n }\n }\n}\n" + }, + "contracts/governance/Governable.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\n/**\n * @title Base for contracts that are managed by the Origin Protocol's Governor.\n * @dev Copy of the openzeppelin Ownable.sol contract with nomenclature change\n * from owner to governor and renounce methods removed. Does not use\n * Context.sol like Ownable.sol does for simplification.\n * @author Origin Protocol Inc\n */\ncontract Governable {\n // Storage position of the owner and pendingOwner of the contract\n // keccak256(\"OUSD.governor\");\n bytes32 private constant governorPosition =\n 0x7bea13895fa79d2831e0a9e28edede30099005a50d652d8957cf8a607ee6ca4a;\n\n // keccak256(\"OUSD.pending.governor\");\n bytes32 private constant pendingGovernorPosition =\n 0x44c4d30b2eaad5130ad70c3ba6972730566f3e6359ab83e800d905c61b1c51db;\n\n // keccak256(\"OUSD.reentry.status\");\n bytes32 private constant reentryStatusPosition =\n 0x53bf423e48ed90e97d02ab0ebab13b2a235a6bfbe9c321847d5c175333ac4535;\n\n // See OpenZeppelin ReentrancyGuard implementation\n uint256 constant _NOT_ENTERED = 1;\n uint256 constant _ENTERED = 2;\n\n event PendingGovernorshipTransfer(\n address indexed previousGovernor,\n address indexed newGovernor\n );\n\n event GovernorshipTransferred(\n address indexed previousGovernor,\n address indexed newGovernor\n );\n\n /**\n * @dev Initializes the contract setting the deployer as the initial Governor.\n */\n constructor() {\n _setGovernor(msg.sender);\n emit GovernorshipTransferred(address(0), _governor());\n }\n\n /**\n * @notice Returns the address of the current Governor.\n */\n function governor() public view returns (address) {\n return _governor();\n }\n\n /**\n * @dev Returns the address of the current Governor.\n */\n function _governor() internal view returns (address governorOut) {\n bytes32 position = governorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n governorOut := sload(position)\n }\n }\n\n /**\n * @dev Returns the address of the pending Governor.\n */\n function _pendingGovernor()\n internal\n view\n returns (address pendingGovernor)\n {\n bytes32 position = pendingGovernorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n pendingGovernor := sload(position)\n }\n }\n\n /**\n * @dev Throws if called by any account other than the Governor.\n */\n modifier onlyGovernor() {\n require(isGovernor(), \"Caller is not the Governor\");\n _;\n }\n\n /**\n * @notice Returns true if the caller is the current Governor.\n */\n function isGovernor() public view returns (bool) {\n return msg.sender == _governor();\n }\n\n function _setGovernor(address newGovernor) internal {\n bytes32 position = governorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, newGovernor)\n }\n }\n\n /**\n * @dev Prevents a contract from calling itself, directly or indirectly.\n * Calling a `nonReentrant` function from another `nonReentrant`\n * function is not supported. It is possible to prevent this from happening\n * by making the `nonReentrant` function external, and make it call a\n * `private` function that does the actual work.\n */\n modifier nonReentrant() {\n bytes32 position = reentryStatusPosition;\n uint256 _reentry_status;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n _reentry_status := sload(position)\n }\n\n // On the first call to nonReentrant, _notEntered will be true\n require(_reentry_status != _ENTERED, \"Reentrant call\");\n\n // Any calls to nonReentrant after this point will fail\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, _ENTERED)\n }\n\n _;\n\n // By storing the original value once again, a refund is triggered (see\n // https://eips.ethereum.org/EIPS/eip-2200)\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, _NOT_ENTERED)\n }\n }\n\n function _setPendingGovernor(address newGovernor) internal {\n bytes32 position = pendingGovernorPosition;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(position, newGovernor)\n }\n }\n\n /**\n * @notice Transfers Governance of the contract to a new account (`newGovernor`).\n * Can only be called by the current Governor. Must be claimed for this to complete\n * @param _newGovernor Address of the new Governor\n */\n function transferGovernance(address _newGovernor) external onlyGovernor {\n _setPendingGovernor(_newGovernor);\n emit PendingGovernorshipTransfer(_governor(), _newGovernor);\n }\n\n /**\n * @notice Claim Governance of the contract to a new account (`newGovernor`).\n * Can only be called by the new Governor.\n */\n function claimGovernance() external {\n require(\n msg.sender == _pendingGovernor(),\n \"Only the pending Governor can complete the claim\"\n );\n _changeGovernor(msg.sender);\n }\n\n /**\n * @dev Change Governance of the contract to a new account (`newGovernor`).\n * @param _newGovernor Address of the new Governor\n */\n function _changeGovernor(address _newGovernor) internal {\n require(_newGovernor != address(0), \"New Governor is address(0)\");\n emit GovernorshipTransferred(_governor(), _newGovernor);\n _setGovernor(_newGovernor);\n }\n}\n" + }, + "contracts/proxies/InitializeGovernedUpgradeabilityProxy.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { Address } from \"@openzeppelin/contracts/utils/Address.sol\";\n\nimport { Governable } from \"../governance/Governable.sol\";\n\n/**\n * @title BaseGovernedUpgradeabilityProxy\n * @dev This contract combines an upgradeability proxy with our governor system.\n * It is based on an older version of OpenZeppelins BaseUpgradeabilityProxy\n * with Solidity ^0.8.0.\n * @author Origin Protocol Inc\n */\ncontract InitializeGovernedUpgradeabilityProxy is Governable {\n /**\n * @dev Emitted when the implementation is upgraded.\n * @param implementation Address of the new implementation.\n */\n event Upgraded(address indexed implementation);\n\n /**\n * @dev Contract initializer with Governor enforcement\n * @param _logic Address of the initial implementation.\n * @param _initGovernor Address of the initial Governor.\n * @param _data Data to send as msg.data to the implementation to initialize\n * the proxied contract.\n * It should include the signature and the parameters of the function to be\n * called, as described in\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\n * This parameter is optional, if no data is given the initialization call\n * to proxied contract will be skipped.\n */\n function initialize(\n address _logic,\n address _initGovernor,\n bytes calldata _data\n ) public payable onlyGovernor {\n require(_implementation() == address(0));\n assert(\n IMPLEMENTATION_SLOT ==\n bytes32(uint256(keccak256(\"eip1967.proxy.implementation\")) - 1)\n );\n _setImplementation(_logic);\n if (_data.length > 0) {\n (bool success, ) = _logic.delegatecall(_data);\n require(success);\n }\n _changeGovernor(_initGovernor);\n }\n\n /**\n * @return The address of the proxy admin/it's also the governor.\n */\n function admin() external view returns (address) {\n return _governor();\n }\n\n /**\n * @return The address of the implementation.\n */\n function implementation() external view returns (address) {\n return _implementation();\n }\n\n /**\n * @dev Upgrade the backing implementation of the proxy.\n * Only the admin can call this function.\n * @param newImplementation Address of the new implementation.\n */\n function upgradeTo(address newImplementation) external onlyGovernor {\n _upgradeTo(newImplementation);\n }\n\n /**\n * @dev Upgrade the backing implementation of the proxy and call a function\n * on the new implementation.\n * This is useful to initialize the proxied contract.\n * @param newImplementation Address of the new implementation.\n * @param data Data to send as msg.data in the low level call.\n * It should include the signature and the parameters of the function to be called, as described in\n * https://solidity.readthedocs.io/en/v0.4.24/abi-spec.html#function-selector-and-argument-encoding.\n */\n function upgradeToAndCall(address newImplementation, bytes calldata data)\n external\n payable\n onlyGovernor\n {\n _upgradeTo(newImplementation);\n (bool success, ) = newImplementation.delegatecall(data);\n require(success);\n }\n\n /**\n * @dev Fallback function.\n * Implemented entirely in `_fallback`.\n */\n fallback() external payable {\n _fallback();\n }\n\n /**\n * @dev Delegates execution to an implementation contract.\n * This is a low level function that doesn't return to its internal call site.\n * It will return to the external caller whatever the implementation returns.\n * @param _impl Address to delegate.\n */\n function _delegate(address _impl) internal {\n // solhint-disable-next-line no-inline-assembly\n assembly {\n // Copy msg.data. We take full control of memory in this inline assembly\n // block because it will not return to Solidity code. We overwrite the\n // Solidity scratch pad at memory position 0.\n calldatacopy(0, 0, calldatasize())\n\n // Call the implementation.\n // out and outsize are 0 because we don't know the size yet.\n let result := delegatecall(gas(), _impl, 0, calldatasize(), 0, 0)\n\n // Copy the returned data.\n returndatacopy(0, 0, returndatasize())\n\n switch result\n // delegatecall returns 0 on error.\n case 0 {\n revert(0, returndatasize())\n }\n default {\n return(0, returndatasize())\n }\n }\n }\n\n /**\n * @dev Function that is run as the first thing in the fallback function.\n * Can be redefined in derived contracts to add functionality.\n * Redefinitions must call super._willFallback().\n */\n function _willFallback() internal {}\n\n /**\n * @dev fallback implementation.\n * Extracted to enable manual triggering.\n */\n function _fallback() internal {\n _willFallback();\n _delegate(_implementation());\n }\n\n /**\n * @dev Storage slot with the address of the current implementation.\n * This is the keccak-256 hash of \"eip1967.proxy.implementation\" subtracted by 1, and is\n * validated in the constructor.\n */\n bytes32 internal constant IMPLEMENTATION_SLOT =\n 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n /**\n * @dev Returns the current implementation.\n * @return impl Address of the current implementation\n */\n function _implementation() internal view returns (address impl) {\n bytes32 slot = IMPLEMENTATION_SLOT;\n // solhint-disable-next-line no-inline-assembly\n assembly {\n impl := sload(slot)\n }\n }\n\n /**\n * @dev Upgrades the proxy to a new implementation.\n * @param newImplementation Address of the new implementation.\n */\n function _upgradeTo(address newImplementation) internal {\n _setImplementation(newImplementation);\n emit Upgraded(newImplementation);\n }\n\n /**\n * @dev Sets the implementation address of the proxy.\n * @param newImplementation Address of the new implementation.\n */\n function _setImplementation(address newImplementation) internal {\n require(\n Address.isContract(newImplementation),\n \"Cannot set a proxy implementation to a non-contract address\"\n );\n\n bytes32 slot = IMPLEMENTATION_SLOT;\n\n // solhint-disable-next-line no-inline-assembly\n assembly {\n sstore(slot, newImplementation)\n }\n }\n}\n" + }, + "contracts/proxies/Proxies.sol": { + "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\nimport { InitializeGovernedUpgradeabilityProxy } from \"./InitializeGovernedUpgradeabilityProxy.sol\";\n\n/**\n * @notice OUSDProxy delegates calls to an OUSD implementation\n */\ncontract OUSDProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice WrappedOUSDProxy delegates calls to a WrappedOUSD implementation\n */\ncontract WrappedOUSDProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice VaultProxy delegates calls to a Vault implementation\n */\ncontract VaultProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice CompoundStrategyProxy delegates calls to a CompoundStrategy implementation\n */\ncontract CompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice AaveStrategyProxy delegates calls to a AaveStrategy implementation\n */\ncontract AaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ThreePoolStrategyProxy delegates calls to a ThreePoolStrategy implementation\n */\ncontract ThreePoolStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ConvexStrategyProxy delegates calls to a ConvexStrategy implementation\n */\ncontract ConvexStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice HarvesterProxy delegates calls to a Harvester implementation\n */\ncontract HarvesterProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice DripperProxy delegates calls to a Dripper implementation\n */\ncontract DripperProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice MorphoCompoundStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\n */\ncontract MorphoCompoundStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ConvexOUSDMetaStrategyProxy delegates calls to a ConvexOUSDMetaStrategy implementation\n */\ncontract ConvexOUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice ConvexLUSDMetaStrategyProxy delegates calls to a ConvexalGeneralizedMetaStrategy implementation\n */\ncontract ConvexLUSDMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice MorphoAaveStrategyProxy delegates calls to a MorphoCompoundStrategy implementation\n */\ncontract MorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHProxy delegates calls to nowhere for now\n */\ncontract OETHProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice WOETHProxy delegates calls to nowhere for now\n */\ncontract WOETHProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHVaultProxy delegates calls to a Vault implementation\n */\ncontract OETHVaultProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHDripperProxy delegates calls to a OETHDripper implementation\n */\ncontract OETHDripperProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHHarvesterProxy delegates calls to a Harvester implementation\n */\ncontract OETHHarvesterProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice FraxETHStrategyProxy delegates calls to a FraxETHStrategy implementation\n */\ncontract FraxETHStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice CurveEthStrategyProxy delegates calls to a CurveEthStrategy implementation\n */\ncontract ConvexEthMetaStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice BuybackProxy delegates calls to Buyback implementation\n */\ncontract BuybackProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHMorphoAaveStrategyProxy delegates calls to a MorphoAaveStrategy implementation\n */\ncontract OETHMorphoAaveStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHBalancerMetaPoolrEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\n */\ncontract OETHBalancerMetaPoolrEthStrategyProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n\n/**\n * @notice OETHBalancerMetaPoolwstEthStrategyProxy delegates calls to a BalancerMetaPoolStrategy implementation\n */\ncontract OETHBalancerMetaPoolwstEthStrategyProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n\n/**\n * @notice FluxStrategyProxy delegates calls to a CompoundStrategy implementation\n */\ncontract FluxStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice MakerDsrStrategyProxy delegates calls to a Generalized4626Strategy implementation\n */\ncontract MakerDsrStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice FrxEthRedeemStrategyProxy delegates calls to a FrxEthRedeemStrategy implementation\n */\ncontract FrxEthRedeemStrategyProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice OETHBuybackProxy delegates calls to Buyback implementation\n */\ncontract OETHBuybackProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice BridgedWOETHProxy delegates calls to BridgedWOETH implementation\n */\ncontract BridgedWOETHProxy is InitializeGovernedUpgradeabilityProxy {\n\n}\n\n/**\n * @notice NativeStakingSSVStrategyProxy delegates calls to NativeStakingSSVStrategy implementation\n */\ncontract NativeStakingSSVStrategyProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n\n/**\n * @notice NativeStakingFeeAccumulatorProxy delegates calls to NativeStakingFeeCollector implementation\n */\ncontract NativeStakingFeeAccumulatorProxy is\n InitializeGovernedUpgradeabilityProxy\n{\n\n}\n" + } + }, + "settings": { + "optimizer": { + "enabled": true, + "runs": 200 + }, + "outputSelection": { + "*": { + "*": [ + "abi", + "evm.bytecode", + "evm.deployedBytecode", + "evm.methodIdentifiers", + "metadata", + "devdoc", + "userdoc", + "storageLayout", + "evm.gasEstimates" + ], + "": [ + "ast" + ] + } + }, + "metadata": { + "useLiteralContent": true + } + } +} \ No newline at end of file diff --git a/contracts/test/behaviour/ssvStrategy.js b/contracts/test/behaviour/ssvStrategy.js index 4ec1dd8070..5aeec4864e 100644 --- a/contracts/test/behaviour/ssvStrategy.js +++ b/contracts/test/behaviour/ssvStrategy.js @@ -127,8 +127,7 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { describe("Validator operations", function () { beforeEach(async () => { - const { weth, domen, nativeStakingSSVStrategy, addresses } = - await context(); + const { weth, domen, nativeStakingSSVStrategy } = await context(); // Add 32 WETH to the strategy so it can be staked await weth @@ -385,7 +384,6 @@ const shouldBehaveLikeAnSsvStrategy = (context) => { oethDripper, weth, validatorRegistrator, - addresses, } = await context(); const dripperWethBefore = await weth.balanceOf(oethDripper.address); diff --git a/contracts/test/helpers.js b/contracts/test/helpers.js index 5db24cc0b0..407d54dd60 100644 --- a/contracts/test/helpers.js +++ b/contracts/test/helpers.js @@ -258,13 +258,15 @@ const isHolesky = hre.network.name == "holesky"; const isExternalNet = isMainnet || isHolesky; const isTest = process.env.IS_TEST === "true"; const isSmokeTest = process.env.SMOKE_TEST === "true"; -const isMainnetOrFork = isMainnet || isFork; +const isMainnetOrFork = + isMainnet || (isFork && process.env.FORK_NETWORK_NAME == "mainnet"); const isForkTest = isFork && isTest; const isForkWithLocalNode = isFork && process.env.LOCAL_PROVIDER_URL; const isArbitrumOne = hre.network.name == "arbitrumOne"; const isTestnetSimplifiedDeploy = isHolesky; const isArbFork = isFork && process.env.FORK_NETWORK_NAME == "arbitrumOne"; const isHoleskyFork = isFork && process.env.FORK_NETWORK_NAME == "holesky"; +const isHoleskyOrFork = isHolesky || isHoleskyFork; const isArbitrumOneOrFork = isArbitrumOne || isArbFork; const isCI = process.env.GITHUB_ACTIONS; @@ -433,7 +435,7 @@ const getAssetAddresses = async (deployments) => { SSVNetwork: addresses.mainnet.SSVNetwork, beaconChainDepositContract: addresses.mainnet.beaconChainDepositContract, }; - } else if (isHolesky) { + } else if (isHoleskyOrFork) { return { WETH: addresses.holesky.WETH, SSV: addresses.holesky.SSV, @@ -793,6 +795,7 @@ module.exports = { isArbitrumOne, isHolesky, isHoleskyFork, + isHoleskyOrFork, isTestnetSimplifiedDeploy, isArbitrumOneOrFork, isArbFork, diff --git a/contracts/utils/resolvers.js b/contracts/utils/resolvers.js index bd22587b5f..e1bc803f06 100644 --- a/contracts/utils/resolvers.js +++ b/contracts/utils/resolvers.js @@ -12,15 +12,15 @@ const resolveAsset = async (symbol) => { // if put outside this function, the following error occurs: // "Hardhat can't be initialized while its config is being defined" const hre = require("hardhat"); - const isFork = process.env.FORK === "true"; - const isMainnet = hre.network.name === "mainnet"; - const isMainnetOrFork = isMainnet || isFork; - if (isMainnetOrFork) { + if (hre.network.name != "hardhat") { const assetAddr = - addresses.mainnet[symbol + "Proxy"] || addresses.mainnet[symbol]; + addresses[hre.network.name][symbol + "Proxy"] || + addresses[hre.network.name][symbol]; if (!assetAddr) { - throw Error(`Failed to resolve symbol "${symbol}" to an address`); + throw Error( + `Failed to resolve symbol "${symbol}" to an address on the "${hre.network.name}" network` + ); } log(`Resolved ${symbol} to ${assetAddr}`); const asset = await ethers.getContractAt("IERC20Metadata", assetAddr); diff --git a/contracts/utils/signers.js b/contracts/utils/signers.js index d35dfb65a5..3ec192d55c 100644 --- a/contracts/utils/signers.js +++ b/contracts/utils/signers.js @@ -1,4 +1,4 @@ -const { Wallet } = require("ethers").utils; +const { Wallet } = require("ethers"); const { Defender } = require("@openzeppelin/defender-sdk"); const { ethereumAddress, privateKey } = require("./regex"); From 2632e401ae37b01588739ccd915e69c6bcfd72e7 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Mon, 6 May 2024 22:45:02 +1000 Subject: [PATCH 29/30] Added Hardhat tasks for generic strategy functions --- contracts/hardhat.config.js | 3 -- contracts/tasks/strategy.js | 55 +++++++++++++++++++++++++++++++++++++ contracts/tasks/tasks.js | 46 +++++++++++++++++++++++++++++++ 3 files changed, 101 insertions(+), 3 deletions(-) create mode 100644 contracts/tasks/strategy.js diff --git a/contracts/hardhat.config.js b/contracts/hardhat.config.js index c09b01ee34..32de4c1a18 100644 --- a/contracts/hardhat.config.js +++ b/contracts/hardhat.config.js @@ -1,14 +1,11 @@ const ethers = require("ethers"); const { task } = require("hardhat/config"); const { - isFork, isArbitrumFork, isHoleskyFork, isHolesky, isForkTest, - isArbForkTest, isHoleskyForkTest, - providerUrl, arbitrumProviderUrl, holeskyProviderUrl, adjustTheForkBlockNumber, diff --git a/contracts/tasks/strategy.js b/contracts/tasks/strategy.js new file mode 100644 index 0000000000..682357353f --- /dev/null +++ b/contracts/tasks/strategy.js @@ -0,0 +1,55 @@ +const { formatUnits } = require("ethers/lib/utils"); +const { resolveContract, resolveAsset } = require("../utils/resolvers"); +const { getSigner } = require("../utils/signers"); +const { logTxDetails } = require("../utils/txLogger"); + +const log = require("../utils/logger")("task:strategy"); + +async function checkBalance({ proxy, symbol }) { + const signer = await getSigner(); + + const asset = await resolveAsset(symbol); + const strategy = await resolveContract( + proxy, + "InitializableAbstractStrategy" + ); + + const balance = await strategy.connect(signer).checkBalance(asset.address); + console.log(`Strategy balance: ${formatUnits(balance)}`); +} + +async function getRewardTokenAddresses({ proxy }) { + const signer = await getSigner(); + + const strategy = await resolveContract( + proxy, + "InitializableAbstractStrategy" + ); + + const rewardTokens = await strategy.connect(signer).getRewardTokenAddresses(); + console.log(`Strategy reward tokens for ${proxy} are: ${rewardTokens}`); +} + +async function setRewardTokenAddresses({ proxy, symbol }) { + const signer = await getSigner(); + + const asset = await resolveAsset(symbol); + const strategy = await resolveContract( + proxy, + "InitializableAbstractStrategy" + ); + + log( + `About to set the reward tokens for the strategy ${proxy} to [${symbol}] ${asset.address}` + ); + const tx = await strategy + .connect(signer) + .setRewardTokenAddresses([asset.address]); + await logTxDetails(tx, "setRewardTokenAddresses"); +} + +module.exports = { + getRewardTokenAddresses, + setRewardTokenAddresses, + checkBalance, +}; diff --git a/contracts/tasks/tasks.js b/contracts/tasks/tasks.js index 587284cdb6..d922fdf25f 100644 --- a/contracts/tasks/tasks.js +++ b/contracts/tasks/tasks.js @@ -61,6 +61,11 @@ const { transferGovernance, claimGovernance, } = require("./governable"); +const { + getRewardTokenAddresses, + setRewardTokenAddresses, + checkBalance, +} = require("./strategy"); const log = require("../utils/logger")("tasks"); @@ -785,6 +790,47 @@ task( ) .setAction(claimGovernance); +// Strategy + +task("checkBalance", "Gets the asset balance of a strategy") + .addParam( + "proxy", + "Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper", + undefined, + types.string + ) + .addParam( + "symbol", + "Symbol of the token. eg WETH, CRV, CVX, BAL or AURA", + undefined, + types.string + ) + .setAction(checkBalance); + +task("getRewardTokenAddresses", "Gets the reward tokens of a strategy") + .addParam( + "proxy", + "Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper", + undefined, + types.string + ) + .setAction(getRewardTokenAddresses); + +task("setRewardTokenAddresses", "Sets the reward token of a strategy") + .addParam( + "proxy", + "Name of the proxy contract or contract name if no proxy. eg OETHVaultProxy or OETHZapper", + undefined, + types.string + ) + .addParam( + "symbol", + "Symbol of the token. eg WETH, CRV, CVX, BAL or AURA", + undefined, + types.string + ) + .setAction(setRewardTokenAddresses); + // SSV subtask("getClusterInfo", "Print out information regarding SSV cluster") From eeed0c8a81668b5c31eb0101cccd225f5e00c702 Mon Sep 17 00:00:00 2001 From: Nicholas Addison Date: Tue, 7 May 2024 22:01:08 +1000 Subject: [PATCH 30/30] remove nativeStakingSSVStrategyProxy from js addresses file --- contracts/utils/addresses.js | 4 ---- 1 file changed, 4 deletions(-) diff --git a/contracts/utils/addresses.js b/contracts/utils/addresses.js index a939fa4eb8..aa6885e32e 100644 --- a/contracts/utils/addresses.js +++ b/contracts/utils/addresses.js @@ -254,10 +254,6 @@ addresses.mainnet.beaconChainDepositContract = "0x00000000219ab540356cBB839Cbe05303d7705Fa"; // Native Staking Strategy -// addresses.mainnet.nativeStakingSSVStrategyProxy = -// "0xdF58F78cebbb2A60740eD2f86cDf0545a485102F"; -// addresses.mainnet.nativeStakingFeeAccumulatorProxy = -// "0x85094b52754591A3dE0002AD97F433584389aea0"; addresses.mainnet.validatorRegistrator = "0x4b91827516f79d6F6a1F292eD99671663b09169a";