{"file_path":"contracts/p1/Main.sol","creation_status":"success","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../interfaces/IMain.sol\";\nimport \"./mixins/GlobalReentrancyGuard.sol\";\nimport \"../mixins/ComponentRegistry.sol\";\nimport \"../mixins/Auth.sol\";\nimport \"../mixins/Versioned.sol\";\nimport \"../registry/VersionRegistry.sol\";\nimport \"../registry/AssetPluginRegistry.sol\";\nimport \"../registry/DAOFeeRegistry.sol\";\nimport \"../interfaces/IBroker.sol\";\n\n/**\n * @title Main\n * @notice The center of the system around which Components orbit.\n */\n// solhint-disable max-states-count\ncontract MainP1 is\n    Versioned,\n    Initializable,\n    Auth,\n    ComponentRegistry,\n    UUPSUpgradeable,\n    GlobalReentrancyGuard,\n    IMain\n{\n    IERC20 public rsr;\n    VersionRegistry public versionRegistry;\n    AssetPluginRegistry public assetPluginRegistry;\n    DAOFeeRegistry public daoFeeRegistry;\n\n    /// @custom:oz-upgrades-unsafe-allow constructor\n    // solhint-disable-next-line no-empty-blocks\n    constructor() initializer {}\n\n    /// Initializer\n    function init(\n        Components memory components,\n        IERC20 rsr_,\n        uint48 shortFreeze_,\n        uint48 longFreeze_\n    ) public virtual initializer {\n        require(address(rsr_) != address(0), \"invalid RSR address\");\n        __Auth_init(shortFreeze_, longFreeze_);\n        __ComponentRegistry_init(components);\n        __ReentrancyGuard_init();\n        __UUPSUpgradeable_init();\n\n        rsr = rsr_;\n        emit MainInitialized();\n    }\n\n    /// @custom:refresher\n    /// @custom:interaction CEI\n    /// @dev Not intended to be used in production, only for equivalence with P0\n    function poke() external {\n        // == Refresher ==\n        assetRegistry.refresh(); // runs furnace.melt()\n\n        // == CE block ==\n        stRSR.payoutRewards();\n    }\n\n    /// Set Version Registry\n    /// @dev Can only be called once.\n    function setVersionRegistry(VersionRegistry versionRegistry_) external onlyRole(OWNER) {\n        require(address(versionRegistry_) != address(0), \"invalid registry address\");\n        require(address(versionRegistry) == address(0), \"already set\");\n\n        versionRegistry = VersionRegistry(versionRegistry_);\n    }\n\n    /// Set Asset Plugin Registry\n    /// @dev Can only be called once.\n    function setAssetPluginRegistry(AssetPluginRegistry registry_) external onlyRole(OWNER) {\n        require(address(registry_) != address(0), \"invalid registry address\");\n        require(address(assetPluginRegistry) == address(0), \"already set\");\n\n        assetPluginRegistry = AssetPluginRegistry(registry_);\n    }\n\n    /// Set DAO Fee Registry\n    /// @dev Can only be called once.\n    function setDAOFeeRegistry(DAOFeeRegistry feeRegistry_) external onlyRole(OWNER) {\n        require(address(feeRegistry_) != address(0), \"invalid registry address\");\n        require(address(daoFeeRegistry) == address(0), \"already set\");\n\n        daoFeeRegistry = DAOFeeRegistry(feeRegistry_);\n    }\n\n    function hasRole(bytes32 role, address account)\n        public\n        view\n        override(IAccessControlUpgradeable, AccessControlUpgradeable)\n        returns (bool)\n    {\n        return super.hasRole(role, account);\n    }\n\n    /**\n     * @dev When upgrading from a prior version to 4.0.0,\n     *      this must happen in the Governance proposal.\n     */\n    function upgradeMainTo(bytes32 versionHash) external onlyRole(OWNER) {\n        require(address(versionRegistry) != address(0), \"no registry\");\n        require(!versionRegistry.isDeprecated(versionHash), \"version deprecated\");\n\n        Implementations memory implementation = versionRegistry.getImplementationForVersion(\n            versionHash\n        );\n\n        _upgradeProxy(address(this), address(implementation.main));\n        require(keccak256(abi.encodePacked(this.version())) == versionHash, \"upgrade mismatch\");\n    }\n\n    function upgradeRTokenTo(\n        bytes32 versionHash,\n        bool preValidation,\n        bool postValidation\n    ) external onlyRole(OWNER) {\n        require(address(versionRegistry) != address(0), \"no registry\");\n        require(keccak256(abi.encodePacked(this.version())) == versionHash, \"upgrade main first\");\n\n        Implementations memory implementation = versionRegistry.getImplementationForVersion(\n            versionHash\n        );\n\n        if (preValidation) {\n            // Validate before the upgrade.\n            assetRegistry.validateCurrentAssets();\n        }\n\n        _upgradeProxy(address(rToken), address(implementation.components.rToken));\n        _upgradeProxy(address(stRSR), address(implementation.components.stRSR));\n        _upgradeProxy(address(assetRegistry), address(implementation.components.assetRegistry));\n        _upgradeProxy(address(basketHandler), address(implementation.components.basketHandler));\n        _upgradeProxy(address(backingManager), address(implementation.components.backingManager));\n        _upgradeProxy(address(distributor), address(implementation.components.distributor));\n        _upgradeProxy(address(furnace), address(implementation.components.furnace));\n        _upgradeProxy(address(broker), address(implementation.components.broker));\n        _upgradeProxy(address(rsrTrader), address(implementation.components.rsrTrader));\n        _upgradeProxy(address(rTokenTrader), address(implementation.components.rTokenTrader));\n\n        if (postValidation) {\n            // ...then validate after the upgrade.\n            assetRegistry.validateCurrentAssets();\n        }\n\n        IExtendedBroker(address(broker)).setBatchTradeImplementation(\n            implementation.trading.gnosisTrade\n        );\n        IExtendedBroker(address(broker)).setDutchTradeImplementation(\n            implementation.trading.dutchTrade\n        );\n    }\n\n    // === Control Flow ===\n\n    function beginTx() external virtual onlyComponent {\n        _nonReentrantBefore();\n    }\n\n    function endTx() external virtual onlyComponent {\n        _nonReentrantAfter();\n    }\n\n    // === Upgradeability ===\n    function _authorizeUpgrade(address) internal view override {\n        require(msg.sender == address(this), \"not self\");\n    }\n\n    function _upgradeProxy(address proxy, address implementation) internal {\n        (bool success, ) = proxy.call(\n            abi.encodeWithSelector(UUPSUpgradeable.upgradeTo.selector, implementation)\n        );\n\n        require(success, \"upgrade failed\");\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[46] private __gap;\n}\n","deployed_bytecode":"0x60806040526004361061038c5760003560e01c80636a28f000116101dc578063bfe1092811610102578063df23cbb1116100a0578063e63ab1e91161006f578063e63ab1e914610b05578063f41c869514610b1a578063f8aa0c4e14610b3a578063fe8aa12a14610b6057600080fd5b8063df23cbb114610a7e578063df5e9b2914610a93578063e083b5e614610ac3578063e58378bb14610af057600080fd5b8063d547741f116100dc578063d547741f146109fd578063d99ba25014610a1d578063dc8af5f614610a3e578063de1611cf14610a5e57600080fd5b8063bfe109281461099b578063c691af92146109bb578063c99dc3dd146109dc57600080fd5b806394c7f2991161017a5780639980cb23116101495780639980cb2314610925578063a217fddf14610946578063abff01101461095b578063be2cb3b41461097b57600080fd5b806394c7f299146108bb578063979d7e86146108d057806398f73e52146108f0578063992e1d6a1461090557600080fd5b80637162c797116101b65780637162c797146107895780637173a83a1461086657806375a8f9261461088657806391d148541461089b57600080fd5b80636a28f00014610735578063705a66181461074a57806370d4bb001461076957600080fd5b806336568abe116102c15780635187ae681161025f57806354fd4d501161022e57806354fd4d50146106ab578063590f6b1a146106df57806360893515146106f4578063656e96e11461071557600080fd5b80635187ae681461063557806352d1902d14610655578063531367631461066a57806353e23e2e1461068a57600080fd5b806341bf0c4e1161029b57806341bf0c4e146105cd578063456068d2146105ed5780634780a5e5146106025780634f1ef2861461062257600080fd5b806336568abe1461056d5780633659cfe61461058d57806340c65f72146105ad57600080fd5b8063248a9ca31161032e5780632d870960116103085780632d870960146104eb5780632f2439b1146105005780632f2ff15d1461053857806331cfec051461055857600080fd5b8063248a9ca31461045b5780632585a270146104995780632b56d18a146104ae57600080fd5b80630f702ed31161036a5780630f702ed3146104075780631031e36e1461041c57806314f4ded214610431578063181783581461044657600080fd5b806301ffc9a714610391578063054f7d9c146103c6578063092f248b146103e5575b600080fd5b34801561039d57600080fd5b506103b16103ac36600461375f565b610b75565b60405190151581526020015b60405180910390f35b3480156103d257600080fd5b5060985465ffffffffffff1642106103b1565b3480156103f157600080fd5b50610405610400366004613789565b610bac565b005b34801561041357600080fd5b50610405610e29565b34801561042857600080fd5b50610405610ec1565b34801561043d57600080fd5b50610405610f50565b34801561045257600080fd5b50610405610fab565b34801561046757600080fd5b5061048b610476366004613789565b60009081526065602052604090206001015490565b6040519081526020016103bd565b3480156104a557600080fd5b5061040561107d565b3480156104ba57600080fd5b506098546104d490600160301b900465ffffffffffff1681565b60405165ffffffffffff90911681526020016103bd565b3480156104f757600080fd5b5061048b611106565b34801561050c57600080fd5b5060cc54610520906001600160a01b031681565b6040516001600160a01b0390911681526020016103bd565b34801561054457600080fd5b506104056105533660046137b7565b611137565b34801561056457600080fd5b50610405611203565b34801561057957600080fd5b506104056105883660046137b7565b61127d565b34801561059957600080fd5b506104056105a83660046137e7565b6112fb565b3480156105b957600080fd5b5060c954610520906001600160a01b031681565b3480156105d957600080fd5b5060d054610520906001600160a01b031681565b3480156105f957600080fd5b506104056113d7565b34801561060e57600080fd5b5060ca54610520906001600160a01b031681565b6104056106303660046138c0565b611460565b34801561064157600080fd5b5061040561065036600461396e565b61152c565b34801561066157600080fd5b5061048b611643565b34801561067657600080fd5b5060cf54610520906001600160a01b031681565b34801561069657600080fd5b506098546103b190600160901b900460ff1681565b3480156106b757600080fd5b5060408051808201825260058152640342e322e360dc1b602082015290516103bd91906139ad565b3480156106eb57600080fd5b5061048b6116f6565b34801561070057600080fd5b5061016054610520906001600160a01b031681565b34801561072157600080fd5b5060d154610520906001600160a01b031681565b34801561074157600080fd5b50610405611725565b34801561075657600080fd5b506098546104d49065ffffffffffff1681565b34801561077557600080fd5b506104056107843660046137e7565b6117b8565b34801561079557600080fd5b5060c9546001600160a01b03908116600090815260d360205260408082208054600160ff19918216811790925560ca5485168452828420805482168317905560cb5485168452828420805482168317905560cc5485168452828420805482168317905560cd5485168452828420805482168317905560ce5485168452828420805482168317905560cf5485168452828420805482168317905560d05485168452828420805482168317905560d15485168452828420805482168317905560d254909416835291208054909216179055005b34801561087257600080fd5b506104056108813660046137e7565b61185c565b34801561089257600080fd5b506103b1611900565b3480156108a757600080fd5b506103b16108b63660046137b7565b611929565b3480156108c757600080fd5b50610405611957565b3480156108dc57600080fd5b5060cb54610520906001600160a01b031681565b3480156108fc57600080fd5b506103b1611996565b34801561091157600080fd5b506104056109203660046139eb565b6119bd565b34801561093157600080fd5b5061016254610520906001600160a01b031681565b34801561095257600080fd5b5061048b600081565b34801561096757600080fd5b5060d254610520906001600160a01b031681565b34801561098757600080fd5b506104056109963660046137e7565b611b7e565b3480156109a757600080fd5b5060ce54610520906001600160a01b031681565b3480156109c757600080fd5b506098546103b190600160981b900460ff1681565b3480156109e857600080fd5b5061015f54610520906001600160a01b031681565b348015610a0957600080fd5b50610405610a183660046137b7565b611c22565b348015610a2957600080fd5b5061016154610520906001600160a01b031681565b348015610a4a57600080fd5b5060cd54610520906001600160a01b031681565b348015610a6a57600080fd5b50610405610a7936600461396e565b611c47565b348015610a8a57600080fd5b50610405611d60565b348015610a9f57600080fd5b506103b1610aae3660046137e7565b60d36020526000908152604090205460ff1681565b348015610acf57600080fd5b5061048b610ade3660046137e7565b60976020526000908152604090205481565b348015610afc57600080fd5b5061048b611def565b348015610b1157600080fd5b5061048b611e16565b348015610b2657600080fd5b50610405610b35366004613b09565b611e3e565b348015610b4657600080fd5b506098546104d490600160601b900465ffffffffffff1681565b348015610b6c57600080fd5b506104056122d6565b60006001600160e01b03198216637965db0b60e01b1480610ba657506301ffc9a760e01b6001600160e01b03198316145b92915050565b6040518060400160405280600581526020016427aba722a960d91b815250610bd390613b4b565b610bdc81612399565b610160546001600160a01b0316610c285760405162461bcd60e51b815260206004820152600b60248201526a6e6f20726567697374727960a81b60448201526064015b60405180910390fd5b610160546040516237935760e61b8152600481018490526001600160a01b0390911690630de4d5c090602401602060405180830381865afa158015610c71573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c959190613b72565b15610cd75760405162461bcd60e51b81526020600482015260126024820152711d995c9cda5bdb8819195c1c9958d85d195960721b6044820152606401610c1f565b61016054604051632777202560e11b8152600481018490526000916001600160a01b031690634eee404a906024016101a060405180830381865afa158015610d23573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d479190613bff565b9050610d573082600001516123a3565b82306001600160a01b03166354fd4d506040518163ffffffff1660e01b8152600401600060405180830381865afa158015610d96573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610dbe9190810190613d14565b604051602001610dce9190613d8b565b6040516020818303038152906040528051906020012014610e245760405162461bcd60e51b815260206004820152601060248201526f0eae0cee4c2c8ca40dad2e6dac2e8c6d60831b6044820152606401610c1f565b505050565b6040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b815250610e5890613b4b565b610e6181612399565b610e996040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b815250610e9390613b4b565b3361247b565b609854610ebe90610eb990600160301b900465ffffffffffff1642613dbd565b6124e2565b50565b604051806040016040528060068152602001652820aaa9a2a960d11b815250610ee990613b4b565b610ef281612399565b60985460408051600160901b90920460ff1615158252600160208301527f87161063ac9982961a7044485445fe4f7bb1a458f731e5ad5ca31b97f3d452bf910160405180910390a1506098805460ff60901b1916600160901b179055565b33600090815260d3602052604090205460ff16610fa15760405162461bcd60e51b815260206004820152600f60248201526e1b9bdd08184818dbdb5c1bdb995b9d608a1b6044820152606401610c1f565b610fa961258e565b565b60cb60009054906101000a90046001600160a01b03166001600160a01b031663f8ac93e86040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610ffb57600080fd5b505af115801561100f573d6000803e3d6000fd5b5050505060ca60009054906101000a90046001600160a01b03166001600160a01b031663296130866040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561106357600080fd5b505af1158015611077573d6000803e3d6000fd5b50505050565b604051806040016040528060068152602001652820aaa9a2a960d11b8152506110a590613b4b565b6110ae81612399565b60985460408051600160981b90920460ff1615158252600060208301527f5ab09e6f82d5fade96a17975df4c40286cfcce3b71eeea0f1c76567f0296447d910160405180910390a1506098805460ff60981b19169055565b6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525061113490613b4b565b81565b60008281526065602052604090206001015461115281612399565b6001600160a01b0382166111a85760405162461bcd60e51b815260206004820152601e60248201527f63616e6e6f74206772616e7420726f6c6520746f2061646472657373203000006044820152606401610c1f565b6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b8152506111d690613b4b565b83036111f9576001600160a01b0382166000908152609760205260409020600690555b610e2483836125d8565b33600090815260d3602052604090205460ff166112545760405162461bcd60e51b815260206004820152600f60248201526e1b9bdd08184818dbdb5c1bdb995b9d608a1b6044820152606401610c1f565b610fa960017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0055565b6001600160a01b03811633146112ed5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610c1f565b6112f7828261247b565b5050565b6001600160a01b037f000000000000000000000000c5bf686cfb85786fcfff557297d4aff8f4e15e441630036113435760405162461bcd60e51b8152600401610c1f90613ddb565b7f000000000000000000000000c5bf686cfb85786fcfff557297d4aff8f4e15e446001600160a01b031661138c60008051602061402d833981519152546001600160a01b031690565b6001600160a01b0316146113b25760405162461bcd60e51b8152600401610c1f90613e27565b6113bb81612684565b60408051600080825260208201909252610ebe918391906126be565b604051806040016040528060068152602001652820aaa9a2a960d11b8152506113ff90613b4b565b61140881612399565b60985460408051600160901b90920460ff1615158252600060208301527f87161063ac9982961a7044485445fe4f7bb1a458f731e5ad5ca31b97f3d452bf910160405180910390a1506098805460ff60901b19169055565b6001600160a01b037f000000000000000000000000c5bf686cfb85786fcfff557297d4aff8f4e15e441630036114a85760405162461bcd60e51b8152600401610c1f90613ddb565b7f000000000000000000000000c5bf686cfb85786fcfff557297d4aff8f4e15e446001600160a01b03166114f160008051602061402d833981519152546001600160a01b031690565b6001600160a01b0316146115175760405162461bcd60e51b8152600401610c1f90613e27565b61152082612684565b6112f7828260016126be565b6040518060400160405280600581526020016427aba722a960d91b81525061155390613b4b565b61155c81612399565b65ffffffffffff82161580159061157f57506301e1338065ffffffffffff831611155b6115cb5760405162461bcd60e51b815260206004820152601860248201527f6c6f6e6720667265657a65206f7574206f662072616e676500000000000000006044820152606401610c1f565b6098546040805165ffffffffffff600160601b9093048316815291841660208301527f2b855a9093ce8fb8bd37179aa306b424a5008d3a000751f4c2e721c51b89f9a2910160405180910390a1506098805465ffffffffffff909216600160601b0265ffffffffffff60601b19909216919091179055565b6000306001600160a01b037f000000000000000000000000c5bf686cfb85786fcfff557297d4aff8f4e15e4416146116e35760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c00000000000000006064820152608401610c1f565b5060008051602061402d83398151915290565b6040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b81525061113490613b4b565b6040518060400160405280600581526020016427aba722a960d91b81525061174c90613b4b565b61175581612399565b6098546040805165ffffffffffff92831681524290921660208301527f4fd793fe252ef26ede0a814ca52971990ff5ade10f86376fb1914bfb17c57e08910160405180910390a1506098805465ffffffffffff19164265ffffffffffff16179055565b6040518060400160405280600581526020016427aba722a960d91b8152506117df90613b4b565b6117e881612399565b6001600160a01b03821661180e5760405162461bcd60e51b8152600401610c1f90613e73565b610160546001600160a01b0316156118385760405162461bcd60e51b8152600401610c1f90613eaa565b5061016080546001600160a01b0319166001600160a01b0392909216919091179055565b6040518060400160405280600581526020016427aba722a960d91b81525061188390613b4b565b61188c81612399565b6001600160a01b0382166118b25760405162461bcd60e51b8152600401610c1f90613e73565b610162546001600160a01b0316156118dc5760405162461bcd60e51b8152600401610c1f90613eaa565b5061016280546001600160a01b0319166001600160a01b0392909216919091179055565b609854600090600160981b900460ff1680611924575060985465ffffffffffff1642105b905090565b60008281526065602090815260408083206001600160a01b038516845290915281205460ff165b9392505050565b6040518060400160405280600581526020016427aba722a960d91b81525061197e90613b4b565b61198781612399565b610ebe65ffffffffffff6124e2565b609854600090600160901b900460ff168061192457505060985465ffffffffffff16421090565b600054610100900460ff16158080156119dd5750600054600160ff909116105b806119f75750303b1580156119f7575060005460ff166001145b611a5a5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610c1f565b6000805460ff191660011790558015611a7d576000805461ff0019166101001790555b6001600160a01b038416611ac95760405162461bcd60e51b8152602060048201526013602482015272696e76616c696420525352206164647265737360681b6044820152606401610c1f565b611ad38383612829565b611adc8561297e565b611ae4612a27565b611aec612a56565b61015f80546001600160a01b0319166001600160a01b0386161790556040517fb3d8a26384852953cab1d93ea954a4ac74e1dc9f5c29576d4a4f45cdb230130e90600090a18015611b77576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6040518060400160405280600581526020016427aba722a960d91b815250611ba590613b4b565b611bae81612399565b6001600160a01b038216611bd45760405162461bcd60e51b8152600401610c1f90613e73565b610161546001600160a01b031615611bfe5760405162461bcd60e51b8152600401610c1f90613eaa565b5061016180546001600160a01b0319166001600160a01b0392909216919091179055565b600082815260656020526040902060010154611c3d81612399565b610e24838361247b565b6040518060400160405280600581526020016427aba722a960d91b815250611c6e90613b4b565b611c7781612399565b65ffffffffffff821615801590611c99575062278d0065ffffffffffff831611155b611ce55760405162461bcd60e51b815260206004820152601960248201527f73686f727420667265657a65206f7574206f662072616e6765000000000000006044820152606401610c1f565b6098546040805165ffffffffffff600160301b9093048316815291841660208301527f84af4c1855ea2ef70449c6ae7119d367873ea35277b9681e0e47898900266f94910160405180910390a1506098805465ffffffffffff909216600160301b026bffffffffffff00000000000019909216919091179055565b604051806040016040528060068152602001652820aaa9a2a960d11b815250611d8890613b4b565b611d9181612399565b60985460408051600160981b90920460ff1615158252600160208301527f5ab09e6f82d5fade96a17975df4c40286cfcce3b71eeea0f1c76567f0296447d910160405180910390a1506098805460ff60981b1916600160981b179055565b6040518060400160405280600581526020016427aba722a960d91b81525061113490613b4b565b604051806040016040528060068152602001652820aaa9a2a960d11b81525061113490613b4b565b6040518060400160405280600581526020016427aba722a960d91b815250611e6590613b4b565b611e6e81612399565b610160546001600160a01b0316611eb55760405162461bcd60e51b815260206004820152600b60248201526a6e6f20726567697374727960a81b6044820152606401610c1f565b83306001600160a01b03166354fd4d506040518163ffffffff1660e01b8152600401600060405180830381865afa158015611ef4573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052611f1c9190810190613d14565b604051602001611f2c9190613d8b565b6040516020818303038152906040528051906020012014611f845760405162461bcd60e51b81526020600482015260126024820152711d5c19dc985919481b585a5b88199a5c9cdd60721b6044820152606401610c1f565b61016054604051632777202560e11b8152600481018690526000916001600160a01b031690634eee404a906024016101a060405180830381865afa158015611fd0573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ff49190613bff565b905083156120635760cb60009054906101000a90046001600160a01b03166001600160a01b03166332e0f32f6040518163ffffffff1660e01b815260040160006040518083038186803b15801561204a57600080fd5b505afa15801561205e573d6000803e3d6000fd5b505050505b60c95460208201515161207f916001600160a01b0316906123a3565b60ca54602080830151015161209d916001600160a01b0316906123a3565b60cb546020820151604001516120bc916001600160a01b0316906123a3565b60cc546020820151606001516120db916001600160a01b0316906123a3565b60cd546020820151608001516120fa916001600160a01b0316906123a3565b60ce54602082015160a00151612119916001600160a01b0316906123a3565b60d154602082015160c00151612138916001600160a01b0316906123a3565b60d254602082015160e00151612157916001600160a01b0316906123a3565b60cf5460208201516101000151612177916001600160a01b0316906123a3565b60d05460208201516101200151612197916001600160a01b0316906123a3565b82156122045760cb60009054906101000a90046001600160a01b03166001600160a01b03166332e0f32f6040518163ffffffff1660e01b815260040160006040518083038186803b1580156121eb57600080fd5b505afa1580156121ff573d6000803e3d6000fd5b505050505b60d2546040828101515190516306e3005960e41b81526001600160a01b039182166004820152911690636e30059090602401600060405180830381600087803b15801561225057600080fd5b505af1158015612264573d6000803e3d6000fd5b505060d254604084810151602001519051631535c2ed60e11b81526001600160a01b03918216600482015291169250632a6b85da9150602401600060405180830381600087803b1580156122b757600080fd5b505af11580156122cb573d6000803e3d6000fd5b505050505050505050565b6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525061230490613b4b565b61230d81612399565b33600090815260976020526040812080546001929061232d908490613ecf565b9091555050336000908152609760205260408120549003612379576123796040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b815250610e9390613b4b565b609854610ebe90610eb990600160601b900465ffffffffffff1642613dbd565b610ebe8133612a7d565b604080516001600160a01b0383811660248084019190915283518084039091018152604490920183526020820180516001600160e01b0316631b2ce7f360e11b17905291516000928516916123f791613d8b565b6000604051808303816000865af19150503d8060008114612434576040519150601f19603f3d011682016040523d82523d6000602084013e612439565b606091505b5050905080610e245760405162461bcd60e51b815260206004820152600e60248201526d1d5c19dc9859194819985a5b195960921b6044820152606401610c1f565b6124858282611929565b156112f75760008281526065602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b60985465ffffffffffff908116908216116125285760405162461bcd60e51b8152602060048201526006602482015265333937bd32b760d11b6044820152606401610c1f565b6098546040805165ffffffffffff928316815291831660208301527f4fd793fe252ef26ede0a814ca52971990ff5ade10f86376fb1914bfb17c57e08910160405180910390a16098805465ffffffffffff191665ffffffffffff92909216919091179055565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f008054600119016125d257604051633ee5aeb560e01b815260040160405180910390fd5b60029055565b6125e28282611929565b6112f75760008281526065602090815260408083206001600160a01b03851684529091529020805460ff1916600117905561261a3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0055565b333014610ebe5760405162461bcd60e51b81526020600482015260086024820152673737ba1039b2b63360c11b6044820152606401610c1f565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156126f157610e2483612ad6565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa92505050801561274b575060408051601f3d908101601f1916820190925261274891810190613ee2565b60015b6127ae5760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b6064820152608401610c1f565b60008051602061402d833981519152811461281d5760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b6064820152608401610c1f565b50610e24838383612b72565b600054610100900460ff166128505760405162461bcd60e51b8152600401610c1f90613efb565b612858612a56565b6128ae6040518060400160405280600581526020016427aba722a960d91b81525061288290613b4b565b6040518060400160405280600581526020016427aba722a960d91b8152506128a990613b4b565b612b97565b6128e06040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b81525061288290613b4b565b6129116040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525061288290613b4b565b61293c604051806040016040528060068152602001652820aaa9a2a960d11b81525061288290613b4b565b61296c6040518060400160405280600581526020016427aba722a960d91b81525061296690613b4b565b336125d8565b61297582611c47565b6112f78161152c565b600054610100900460ff166129a55760405162461bcd60e51b8152600401610c1f90613efb565b6129b28160800151612be2565b6129bf8160600151612cb6565b6129cd816101000151612d8a565b6129db816101200151612e5e565b6129e88160400151612f32565b6129f58160a00151613006565b612a028160c001516130da565b612a0f8160e001516131ae565b612a1c816020015161327b565b8051610ebe90613347565b600054610100900460ff16612a4e5760405162461bcd60e51b8152600401610c1f90613efb565b610fa9613407565b600054610100900460ff16610fa95760405162461bcd60e51b8152600401610c1f90613efb565b612a878282611929565b6112f757612a948161342e565b612a9f836020613440565b604051602001612ab0929190613f46565b60408051601f198184030181529082905262461bcd60e51b8252610c1f916004016139ad565b6001600160a01b0381163b612b435760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610c1f565b60008051602061402d83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b612b7b836135dc565b600082511180612b885750805b15610e2457611077838361361c565b600082815260656020526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b6001600160a01b038116612c385760405162461bcd60e51b815260206004820152601e60248201527f696e76616c6964204261636b696e674d616e61676572206164647265737300006044820152606401610c1f565b60cd546040517fd4ec685c4e7367fc82d24a1c90d8c91c07a0e204b5b4655fc1a6d5b6b9d9eeb791612c77916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cd80546001600160a01b0319169091179055565b6001600160a01b038116612d0c5760405162461bcd60e51b815260206004820152601d60248201527f696e76616c6964204261736b657448616e646c657220616464726573730000006044820152606401610c1f565b60cc546040517fa41efa7d680b9ae9379ca75b956c50587b28ed07453f7d19388c7199397a1e8e91612d4b916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cc80546001600160a01b0319169091179055565b6001600160a01b038116612de05760405162461bcd60e51b815260206004820152601960248201527f696e76616c6964205253525472616465722061646472657373000000000000006044820152606401610c1f565b60cf546040517f2fa6596476f0ebdb5fef9a37bedb7ef956e0e1c4e094464cbf49c38f44f7e8d191612e1f916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cf80546001600160a01b0319169091179055565b6001600160a01b038116612eb45760405162461bcd60e51b815260206004820152601c60248201527f696e76616c69642052546f6b656e5472616465722061646472657373000000006044820152606401610c1f565b60d0546040517f0d76a5d5849780e9a81127e61df7ee55bf3f766bc326510d3a52ede3caea168f91612ef3916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560d080546001600160a01b0319169091179055565b6001600160a01b038116612f885760405162461bcd60e51b815260206004820152601d60248201527f696e76616c6964204173736574526567697374727920616464726573730000006044820152606401610c1f565b60cb546040517f5c69d378772ea2f02015deabd3b7ee1db0851dba819e216585de7a155d22a14891612fc7916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cb80546001600160a01b0319169091179055565b6001600160a01b03811661305c5760405162461bcd60e51b815260206004820152601b60248201527f696e76616c6964204469737472696275746f72206164647265737300000000006044820152606401610c1f565b60ce546040517f8c6eabd1db7fe5a1951a7c78767c0e3633c5352578d15d45f99aa4c4db01c55a9161309b916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560ce80546001600160a01b0319169091179055565b6001600160a01b0381166131305760405162461bcd60e51b815260206004820152601760248201527f696e76616c6964204675726e61636520616464726573730000000000000000006044820152606401610c1f565b60d1546040517fe0c9d7fae2ccca1a3980ce26aada40d9f7fc84406cdb3adbdcfb8f9dd21c9b539161316f916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560d180546001600160a01b0319169091179055565b6001600160a01b0381166131fd5760405162461bcd60e51b8152602060048201526016602482015275696e76616c69642042726f6b6572206164647265737360501b6044820152606401610c1f565b60d2546040517fc29cab4074359a76aba74458623910a8b95269ded89ad9f98cd2db1de3ead3569161323c916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560d280546001600160a01b0319169091179055565b6001600160a01b0381166132c95760405162461bcd60e51b8152602060048201526015602482015274696e76616c6964205374525352206164647265737360581b6044820152606401610c1f565b60ca546040517f1b29dc90e15d6ade122a9e27d886b4a077e66131c7e0cc805fc303e49690c9fc91613308916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560ca80546001600160a01b0319169091179055565b6001600160a01b0381166133965760405162461bcd60e51b8152602060048201526016602482015275696e76616c69642052546f6b656e206164647265737360501b6044820152606401610c1f565b60c9546040516001600160a01b038084169216907f2d2909c1d06afe38080a70d63a8793874674efb0fdf3b3bf3fd046056688b3ea90600090a36001600160a01b0316600081815260d360205260409020805460ff1916600117905560c980546001600160a01b0319169091179055565b600054610100900460ff1661265e5760405162461bcd60e51b8152600401610c1f90613efb565b6060610ba66001600160a01b03831660145b6060600061344f836002613fd5565b61345a906002613fec565b67ffffffffffffffff81111561347257613472613804565b6040519080825280601f01601f19166020018201604052801561349c576020820181803683370190505b509050600360fc1b816000815181106134b7576134b7613fff565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106134e6576134e6613fff565b60200101906001600160f81b031916908160001a905350600061350a846002613fd5565b613515906001613fec565b90505b600181111561358d576f181899199a1a9b1b9c1cb0b131b232b360811b85600f166010811061354957613549613fff565b1a60f81b82828151811061355f5761355f613fff565b60200101906001600160f81b031916908160001a90535060049490941c9361358681614015565b9050613518565b5083156119505760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610c1f565b6135e581612ad6565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060611950838360405180606001604052806027815260200161404d602791396060600080856001600160a01b0316856040516136599190613d8b565b600060405180830381855af49150503d8060008114613694576040519150601f19603f3d011682016040523d82523d6000602084013e613699565b606091505b50915091506136aa868383876136b4565b9695505050505050565b6060831561372357825160000361371c576001600160a01b0385163b61371c5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610c1f565b508161372d565b61372d8383613735565b949350505050565b8151156137455781518083602001fd5b8060405162461bcd60e51b8152600401610c1f91906139ad565b60006020828403121561377157600080fd5b81356001600160e01b03198116811461195057600080fd5b60006020828403121561379b57600080fd5b5035919050565b6001600160a01b0381168114610ebe57600080fd5b600080604083850312156137ca57600080fd5b8235915060208301356137dc816137a2565b809150509250929050565b6000602082840312156137f957600080fd5b8135611950816137a2565b634e487b7160e01b600052604160045260246000fd5b604051610140810167ffffffffffffffff8111828210171561383e5761383e613804565b60405290565b6040516060810167ffffffffffffffff8111828210171561383e5761383e613804565b604051601f8201601f1916810167ffffffffffffffff8111828210171561389057613890613804565b604052919050565b600067ffffffffffffffff8211156138b2576138b2613804565b50601f01601f191660200190565b600080604083850312156138d357600080fd5b82356138de816137a2565b9150602083013567ffffffffffffffff8111156138fa57600080fd5b8301601f8101851361390b57600080fd5b803561391e61391982613898565b613867565b81815286602083850101111561393357600080fd5b816020840160208301376000602083830101528093505050509250929050565b803565ffffffffffff8116811461396957600080fd5b919050565b60006020828403121561398057600080fd5b61195082613953565b60005b838110156139a457818101518382015260200161398c565b50506000910152565b60208152600082518060208401526139cc816040850160208701613989565b601f01601f19169190910160400192915050565b8035613969816137a2565b6000806000808486036101a0811215613a0357600080fd5b610140811215613a1257600080fd5b50613a1b61381a565b613a24866139e0565b8152613a32602087016139e0565b6020820152613a43604087016139e0565b6040820152613a54606087016139e0565b6060820152613a65608087016139e0565b6080820152613a7660a087016139e0565b60a0820152613a8760c087016139e0565b60c0820152613a9860e087016139e0565b60e0820152613aaa61010087016139e0565b610100820152613abd61012087016139e0565b6101208201529350613ad261014086016139e0565b9250613ae16101608601613953565b9150613af06101808601613953565b905092959194509250565b8015158114610ebe57600080fd5b600080600060608486031215613b1e57600080fd5b833592506020840135613b3081613afb565b91506040840135613b4081613afb565b809150509250925092565b80516020808301519190811015613b6c576000198160200360031b1b821691505b50919050565b600060208284031215613b8457600080fd5b815161195081613afb565b8051613969816137a2565b600060408284031215613bac57600080fd5b6040805190810167ffffffffffffffff81118282101715613bcf57613bcf613804565b80604052508091508251613be2816137a2565b81526020830151613bf2816137a2565b6020919091015292915050565b60008183036101a081128015613c1457600080fd5b50613c1d613844565b8351613c28816137a2565b8152610140601f1983011215613c3d57600080fd5b613c4561381a565b9150613c5360208501613b8f565b8252613c6160408501613b8f565b6020830152613c7260608501613b8f565b6040830152613c8360808501613b8f565b6060830152613c9460a08501613b8f565b6080830152613ca560c08501613b8f565b60a0830152613cb660e08501613b8f565b60c0830152613cc86101008501613b8f565b60e0830152613cda6101208501613b8f565b610100830152613ced6101408501613b8f565b610120830152816020820152613d07856101608601613b9a565b6040820152949350505050565b600060208284031215613d2657600080fd5b815167ffffffffffffffff811115613d3d57600080fd5b8201601f81018413613d4e57600080fd5b8051613d5c61391982613898565b818152856020838501011115613d7157600080fd5b613d82826020830160208601613989565b95945050505050565b60008251613d9d818460208701613989565b9190910192915050565b634e487b7160e01b600052601160045260246000fd5b65ffffffffffff8181168382160190811115610ba657610ba6613da7565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b60208082526018908201527f696e76616c696420726567697374727920616464726573730000000000000000604082015260600190565b6020808252600b908201526a185b1c9958591e481cd95d60aa1b604082015260600190565b81810381811115610ba657610ba6613da7565b600060208284031215613ef457600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613f7e816017850160208801613989565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613faf816028840160208801613989565b01602801949350505050565b6001600160a01b0392831681529116602082015260400190565b8082028115828204841417610ba657610ba6613da7565b80820180821115610ba657610ba6613da7565b634e487b7160e01b600052603260045260246000fd5b60008161402457614024613da7565b50600019019056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220000e8c68d2dd0933c7bb1966043e55bad2b2d86cebf28629409b3b9b50ea070d64736f6c634300081c0033","optimization_enabled":true,"verified_twin_address_hash":null,"is_verified":true,"compiler_settings":{"evmVersion":"paris","libraries":{},"optimizer":{"enabled":true,"runs":200},"outputSelection":{"*":{"":["*"],"*":["*"]}}},"optimization_runs":200,"sourcify_repo_url":null,"decoded_constructor_args":null,"compiler_version":"v0.8.28+commit.7893614a","is_verified_via_verifier_alliance":false,"verified_at":"2026-03-25T21:59:03.165408Z","implementations":[],"proxy_type":null,"external_libraries":[],"creation_bytecode":"0x60a06040523060805234801561001457600080fd5b50600054610100900460ff16158080156100355750600054600160ff909116105b8061004f5750303b15801561004f575060005460ff166001145b6100b65760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840160405180910390fd5b6000805460ff1916600117905580156100d9576000805461ff0019166101001790555b801561011f576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b506080516140a961015760003960008181611305015281816113450152818161146a015281816114aa015261165001526140a96000f3fe60806040526004361061038c5760003560e01c80636a28f000116101dc578063bfe1092811610102578063df23cbb1116100a0578063e63ab1e91161006f578063e63ab1e914610b05578063f41c869514610b1a578063f8aa0c4e14610b3a578063fe8aa12a14610b6057600080fd5b8063df23cbb114610a7e578063df5e9b2914610a93578063e083b5e614610ac3578063e58378bb14610af057600080fd5b8063d547741f116100dc578063d547741f146109fd578063d99ba25014610a1d578063dc8af5f614610a3e578063de1611cf14610a5e57600080fd5b8063bfe109281461099b578063c691af92146109bb578063c99dc3dd146109dc57600080fd5b806394c7f2991161017a5780639980cb23116101495780639980cb2314610925578063a217fddf14610946578063abff01101461095b578063be2cb3b41461097b57600080fd5b806394c7f299146108bb578063979d7e86146108d057806398f73e52146108f0578063992e1d6a1461090557600080fd5b80637162c797116101b65780637162c797146107895780637173a83a1461086657806375a8f9261461088657806391d148541461089b57600080fd5b80636a28f00014610735578063705a66181461074a57806370d4bb001461076957600080fd5b806336568abe116102c15780635187ae681161025f57806354fd4d501161022e57806354fd4d50146106ab578063590f6b1a146106df57806360893515146106f4578063656e96e11461071557600080fd5b80635187ae681461063557806352d1902d14610655578063531367631461066a57806353e23e2e1461068a57600080fd5b806341bf0c4e1161029b57806341bf0c4e146105cd578063456068d2146105ed5780634780a5e5146106025780634f1ef2861461062257600080fd5b806336568abe1461056d5780633659cfe61461058d57806340c65f72146105ad57600080fd5b8063248a9ca31161032e5780632d870960116103085780632d870960146104eb5780632f2439b1146105005780632f2ff15d1461053857806331cfec051461055857600080fd5b8063248a9ca31461045b5780632585a270146104995780632b56d18a146104ae57600080fd5b80630f702ed31161036a5780630f702ed3146104075780631031e36e1461041c57806314f4ded214610431578063181783581461044657600080fd5b806301ffc9a714610391578063054f7d9c146103c6578063092f248b146103e5575b600080fd5b34801561039d57600080fd5b506103b16103ac36600461375f565b610b75565b60405190151581526020015b60405180910390f35b3480156103d257600080fd5b5060985465ffffffffffff1642106103b1565b3480156103f157600080fd5b50610405610400366004613789565b610bac565b005b34801561041357600080fd5b50610405610e29565b34801561042857600080fd5b50610405610ec1565b34801561043d57600080fd5b50610405610f50565b34801561045257600080fd5b50610405610fab565b34801561046757600080fd5b5061048b610476366004613789565b60009081526065602052604090206001015490565b6040519081526020016103bd565b3480156104a557600080fd5b5061040561107d565b3480156104ba57600080fd5b506098546104d490600160301b900465ffffffffffff1681565b60405165ffffffffffff90911681526020016103bd565b3480156104f757600080fd5b5061048b611106565b34801561050c57600080fd5b5060cc54610520906001600160a01b031681565b6040516001600160a01b0390911681526020016103bd565b34801561054457600080fd5b506104056105533660046137b7565b611137565b34801561056457600080fd5b50610405611203565b34801561057957600080fd5b506104056105883660046137b7565b61127d565b34801561059957600080fd5b506104056105a83660046137e7565b6112fb565b3480156105b957600080fd5b5060c954610520906001600160a01b031681565b3480156105d957600080fd5b5060d054610520906001600160a01b031681565b3480156105f957600080fd5b506104056113d7565b34801561060e57600080fd5b5060ca54610520906001600160a01b031681565b6104056106303660046138c0565b611460565b34801561064157600080fd5b5061040561065036600461396e565b61152c565b34801561066157600080fd5b5061048b611643565b34801561067657600080fd5b5060cf54610520906001600160a01b031681565b34801561069657600080fd5b506098546103b190600160901b900460ff1681565b3480156106b757600080fd5b5060408051808201825260058152640342e322e360dc1b602082015290516103bd91906139ad565b3480156106eb57600080fd5b5061048b6116f6565b34801561070057600080fd5b5061016054610520906001600160a01b031681565b34801561072157600080fd5b5060d154610520906001600160a01b031681565b34801561074157600080fd5b50610405611725565b34801561075657600080fd5b506098546104d49065ffffffffffff1681565b34801561077557600080fd5b506104056107843660046137e7565b6117b8565b34801561079557600080fd5b5060c9546001600160a01b03908116600090815260d360205260408082208054600160ff19918216811790925560ca5485168452828420805482168317905560cb5485168452828420805482168317905560cc5485168452828420805482168317905560cd5485168452828420805482168317905560ce5485168452828420805482168317905560cf5485168452828420805482168317905560d05485168452828420805482168317905560d15485168452828420805482168317905560d254909416835291208054909216179055005b34801561087257600080fd5b506104056108813660046137e7565b61185c565b34801561089257600080fd5b506103b1611900565b3480156108a757600080fd5b506103b16108b63660046137b7565b611929565b3480156108c757600080fd5b50610405611957565b3480156108dc57600080fd5b5060cb54610520906001600160a01b031681565b3480156108fc57600080fd5b506103b1611996565b34801561091157600080fd5b506104056109203660046139eb565b6119bd565b34801561093157600080fd5b5061016254610520906001600160a01b031681565b34801561095257600080fd5b5061048b600081565b34801561096757600080fd5b5060d254610520906001600160a01b031681565b34801561098757600080fd5b506104056109963660046137e7565b611b7e565b3480156109a757600080fd5b5060ce54610520906001600160a01b031681565b3480156109c757600080fd5b506098546103b190600160981b900460ff1681565b3480156109e857600080fd5b5061015f54610520906001600160a01b031681565b348015610a0957600080fd5b50610405610a183660046137b7565b611c22565b348015610a2957600080fd5b5061016154610520906001600160a01b031681565b348015610a4a57600080fd5b5060cd54610520906001600160a01b031681565b348015610a6a57600080fd5b50610405610a7936600461396e565b611c47565b348015610a8a57600080fd5b50610405611d60565b348015610a9f57600080fd5b506103b1610aae3660046137e7565b60d36020526000908152604090205460ff1681565b348015610acf57600080fd5b5061048b610ade3660046137e7565b60976020526000908152604090205481565b348015610afc57600080fd5b5061048b611def565b348015610b1157600080fd5b5061048b611e16565b348015610b2657600080fd5b50610405610b35366004613b09565b611e3e565b348015610b4657600080fd5b506098546104d490600160601b900465ffffffffffff1681565b348015610b6c57600080fd5b506104056122d6565b60006001600160e01b03198216637965db0b60e01b1480610ba657506301ffc9a760e01b6001600160e01b03198316145b92915050565b6040518060400160405280600581526020016427aba722a960d91b815250610bd390613b4b565b610bdc81612399565b610160546001600160a01b0316610c285760405162461bcd60e51b815260206004820152600b60248201526a6e6f20726567697374727960a81b60448201526064015b60405180910390fd5b610160546040516237935760e61b8152600481018490526001600160a01b0390911690630de4d5c090602401602060405180830381865afa158015610c71573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c959190613b72565b15610cd75760405162461bcd60e51b81526020600482015260126024820152711d995c9cda5bdb8819195c1c9958d85d195960721b6044820152606401610c1f565b61016054604051632777202560e11b8152600481018490526000916001600160a01b031690634eee404a906024016101a060405180830381865afa158015610d23573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d479190613bff565b9050610d573082600001516123a3565b82306001600160a01b03166354fd4d506040518163ffffffff1660e01b8152600401600060405180830381865afa158015610d96573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610dbe9190810190613d14565b604051602001610dce9190613d8b565b6040516020818303038152906040528051906020012014610e245760405162461bcd60e51b815260206004820152601060248201526f0eae0cee4c2c8ca40dad2e6dac2e8c6d60831b6044820152606401610c1f565b505050565b6040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b815250610e5890613b4b565b610e6181612399565b610e996040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b815250610e9390613b4b565b3361247b565b609854610ebe90610eb990600160301b900465ffffffffffff1642613dbd565b6124e2565b50565b604051806040016040528060068152602001652820aaa9a2a960d11b815250610ee990613b4b565b610ef281612399565b60985460408051600160901b90920460ff1615158252600160208301527f87161063ac9982961a7044485445fe4f7bb1a458f731e5ad5ca31b97f3d452bf910160405180910390a1506098805460ff60901b1916600160901b179055565b33600090815260d3602052604090205460ff16610fa15760405162461bcd60e51b815260206004820152600f60248201526e1b9bdd08184818dbdb5c1bdb995b9d608a1b6044820152606401610c1f565b610fa961258e565b565b60cb60009054906101000a90046001600160a01b03166001600160a01b031663f8ac93e86040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610ffb57600080fd5b505af115801561100f573d6000803e3d6000fd5b5050505060ca60009054906101000a90046001600160a01b03166001600160a01b031663296130866040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561106357600080fd5b505af1158015611077573d6000803e3d6000fd5b50505050565b604051806040016040528060068152602001652820aaa9a2a960d11b8152506110a590613b4b565b6110ae81612399565b60985460408051600160981b90920460ff1615158252600060208301527f5ab09e6f82d5fade96a17975df4c40286cfcce3b71eeea0f1c76567f0296447d910160405180910390a1506098805460ff60981b19169055565b6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525061113490613b4b565b81565b60008281526065602052604090206001015461115281612399565b6001600160a01b0382166111a85760405162461bcd60e51b815260206004820152601e60248201527f63616e6e6f74206772616e7420726f6c6520746f2061646472657373203000006044820152606401610c1f565b6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b8152506111d690613b4b565b83036111f9576001600160a01b0382166000908152609760205260409020600690555b610e2483836125d8565b33600090815260d3602052604090205460ff166112545760405162461bcd60e51b815260206004820152600f60248201526e1b9bdd08184818dbdb5c1bdb995b9d608a1b6044820152606401610c1f565b610fa960017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0055565b6001600160a01b03811633146112ed5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610c1f565b6112f7828261247b565b5050565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036113435760405162461bcd60e51b8152600401610c1f90613ddb565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031661138c60008051602061402d833981519152546001600160a01b031690565b6001600160a01b0316146113b25760405162461bcd60e51b8152600401610c1f90613e27565b6113bb81612684565b60408051600080825260208201909252610ebe918391906126be565b604051806040016040528060068152602001652820aaa9a2a960d11b8152506113ff90613b4b565b61140881612399565b60985460408051600160901b90920460ff1615158252600060208301527f87161063ac9982961a7044485445fe4f7bb1a458f731e5ad5ca31b97f3d452bf910160405180910390a1506098805460ff60901b19169055565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036114a85760405162461bcd60e51b8152600401610c1f90613ddb565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166114f160008051602061402d833981519152546001600160a01b031690565b6001600160a01b0316146115175760405162461bcd60e51b8152600401610c1f90613e27565b61152082612684565b6112f7828260016126be565b6040518060400160405280600581526020016427aba722a960d91b81525061155390613b4b565b61155c81612399565b65ffffffffffff82161580159061157f57506301e1338065ffffffffffff831611155b6115cb5760405162461bcd60e51b815260206004820152601860248201527f6c6f6e6720667265657a65206f7574206f662072616e676500000000000000006044820152606401610c1f565b6098546040805165ffffffffffff600160601b9093048316815291841660208301527f2b855a9093ce8fb8bd37179aa306b424a5008d3a000751f4c2e721c51b89f9a2910160405180910390a1506098805465ffffffffffff909216600160601b0265ffffffffffff60601b19909216919091179055565b6000306001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146116e35760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c00000000000000006064820152608401610c1f565b5060008051602061402d83398151915290565b6040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b81525061113490613b4b565b6040518060400160405280600581526020016427aba722a960d91b81525061174c90613b4b565b61175581612399565b6098546040805165ffffffffffff92831681524290921660208301527f4fd793fe252ef26ede0a814ca52971990ff5ade10f86376fb1914bfb17c57e08910160405180910390a1506098805465ffffffffffff19164265ffffffffffff16179055565b6040518060400160405280600581526020016427aba722a960d91b8152506117df90613b4b565b6117e881612399565b6001600160a01b03821661180e5760405162461bcd60e51b8152600401610c1f90613e73565b610160546001600160a01b0316156118385760405162461bcd60e51b8152600401610c1f90613eaa565b5061016080546001600160a01b0319166001600160a01b0392909216919091179055565b6040518060400160405280600581526020016427aba722a960d91b81525061188390613b4b565b61188c81612399565b6001600160a01b0382166118b25760405162461bcd60e51b8152600401610c1f90613e73565b610162546001600160a01b0316156118dc5760405162461bcd60e51b8152600401610c1f90613eaa565b5061016280546001600160a01b0319166001600160a01b0392909216919091179055565b609854600090600160981b900460ff1680611924575060985465ffffffffffff1642105b905090565b60008281526065602090815260408083206001600160a01b038516845290915281205460ff165b9392505050565b6040518060400160405280600581526020016427aba722a960d91b81525061197e90613b4b565b61198781612399565b610ebe65ffffffffffff6124e2565b609854600090600160901b900460ff168061192457505060985465ffffffffffff16421090565b600054610100900460ff16158080156119dd5750600054600160ff909116105b806119f75750303b1580156119f7575060005460ff166001145b611a5a5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610c1f565b6000805460ff191660011790558015611a7d576000805461ff0019166101001790555b6001600160a01b038416611ac95760405162461bcd60e51b8152602060048201526013602482015272696e76616c696420525352206164647265737360681b6044820152606401610c1f565b611ad38383612829565b611adc8561297e565b611ae4612a27565b611aec612a56565b61015f80546001600160a01b0319166001600160a01b0386161790556040517fb3d8a26384852953cab1d93ea954a4ac74e1dc9f5c29576d4a4f45cdb230130e90600090a18015611b77576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6040518060400160405280600581526020016427aba722a960d91b815250611ba590613b4b565b611bae81612399565b6001600160a01b038216611bd45760405162461bcd60e51b8152600401610c1f90613e73565b610161546001600160a01b031615611bfe5760405162461bcd60e51b8152600401610c1f90613eaa565b5061016180546001600160a01b0319166001600160a01b0392909216919091179055565b600082815260656020526040902060010154611c3d81612399565b610e24838361247b565b6040518060400160405280600581526020016427aba722a960d91b815250611c6e90613b4b565b611c7781612399565b65ffffffffffff821615801590611c99575062278d0065ffffffffffff831611155b611ce55760405162461bcd60e51b815260206004820152601960248201527f73686f727420667265657a65206f7574206f662072616e6765000000000000006044820152606401610c1f565b6098546040805165ffffffffffff600160301b9093048316815291841660208301527f84af4c1855ea2ef70449c6ae7119d367873ea35277b9681e0e47898900266f94910160405180910390a1506098805465ffffffffffff909216600160301b026bffffffffffff00000000000019909216919091179055565b604051806040016040528060068152602001652820aaa9a2a960d11b815250611d8890613b4b565b611d9181612399565b60985460408051600160981b90920460ff1615158252600160208301527f5ab09e6f82d5fade96a17975df4c40286cfcce3b71eeea0f1c76567f0296447d910160405180910390a1506098805460ff60981b1916600160981b179055565b6040518060400160405280600581526020016427aba722a960d91b81525061113490613b4b565b604051806040016040528060068152602001652820aaa9a2a960d11b81525061113490613b4b565b6040518060400160405280600581526020016427aba722a960d91b815250611e6590613b4b565b611e6e81612399565b610160546001600160a01b0316611eb55760405162461bcd60e51b815260206004820152600b60248201526a6e6f20726567697374727960a81b6044820152606401610c1f565b83306001600160a01b03166354fd4d506040518163ffffffff1660e01b8152600401600060405180830381865afa158015611ef4573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052611f1c9190810190613d14565b604051602001611f2c9190613d8b565b6040516020818303038152906040528051906020012014611f845760405162461bcd60e51b81526020600482015260126024820152711d5c19dc985919481b585a5b88199a5c9cdd60721b6044820152606401610c1f565b61016054604051632777202560e11b8152600481018690526000916001600160a01b031690634eee404a906024016101a060405180830381865afa158015611fd0573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ff49190613bff565b905083156120635760cb60009054906101000a90046001600160a01b03166001600160a01b03166332e0f32f6040518163ffffffff1660e01b815260040160006040518083038186803b15801561204a57600080fd5b505afa15801561205e573d6000803e3d6000fd5b505050505b60c95460208201515161207f916001600160a01b0316906123a3565b60ca54602080830151015161209d916001600160a01b0316906123a3565b60cb546020820151604001516120bc916001600160a01b0316906123a3565b60cc546020820151606001516120db916001600160a01b0316906123a3565b60cd546020820151608001516120fa916001600160a01b0316906123a3565b60ce54602082015160a00151612119916001600160a01b0316906123a3565b60d154602082015160c00151612138916001600160a01b0316906123a3565b60d254602082015160e00151612157916001600160a01b0316906123a3565b60cf5460208201516101000151612177916001600160a01b0316906123a3565b60d05460208201516101200151612197916001600160a01b0316906123a3565b82156122045760cb60009054906101000a90046001600160a01b03166001600160a01b03166332e0f32f6040518163ffffffff1660e01b815260040160006040518083038186803b1580156121eb57600080fd5b505afa1580156121ff573d6000803e3d6000fd5b505050505b60d2546040828101515190516306e3005960e41b81526001600160a01b039182166004820152911690636e30059090602401600060405180830381600087803b15801561225057600080fd5b505af1158015612264573d6000803e3d6000fd5b505060d254604084810151602001519051631535c2ed60e11b81526001600160a01b03918216600482015291169250632a6b85da9150602401600060405180830381600087803b1580156122b757600080fd5b505af11580156122cb573d6000803e3d6000fd5b505050505050505050565b6040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525061230490613b4b565b61230d81612399565b33600090815260976020526040812080546001929061232d908490613ecf565b9091555050336000908152609760205260408120549003612379576123796040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b815250610e9390613b4b565b609854610ebe90610eb990600160601b900465ffffffffffff1642613dbd565b610ebe8133612a7d565b604080516001600160a01b0383811660248084019190915283518084039091018152604490920183526020820180516001600160e01b0316631b2ce7f360e11b17905291516000928516916123f791613d8b565b6000604051808303816000865af19150503d8060008114612434576040519150601f19603f3d011682016040523d82523d6000602084013e612439565b606091505b5050905080610e245760405162461bcd60e51b815260206004820152600e60248201526d1d5c19dc9859194819985a5b195960921b6044820152606401610c1f565b6124858282611929565b156112f75760008281526065602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b60985465ffffffffffff908116908216116125285760405162461bcd60e51b8152602060048201526006602482015265333937bd32b760d11b6044820152606401610c1f565b6098546040805165ffffffffffff928316815291831660208301527f4fd793fe252ef26ede0a814ca52971990ff5ade10f86376fb1914bfb17c57e08910160405180910390a16098805465ffffffffffff191665ffffffffffff92909216919091179055565b7f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f008054600119016125d257604051633ee5aeb560e01b815260040160405180910390fd5b60029055565b6125e28282611929565b6112f75760008281526065602090815260408083206001600160a01b03851684529091529020805460ff1916600117905561261a3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60017f9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f0055565b333014610ebe5760405162461bcd60e51b81526020600482015260086024820152673737ba1039b2b63360c11b6044820152606401610c1f565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156126f157610e2483612ad6565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa92505050801561274b575060408051601f3d908101601f1916820190925261274891810190613ee2565b60015b6127ae5760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b6064820152608401610c1f565b60008051602061402d833981519152811461281d5760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b6064820152608401610c1f565b50610e24838383612b72565b600054610100900460ff166128505760405162461bcd60e51b8152600401610c1f90613efb565b612858612a56565b6128ae6040518060400160405280600581526020016427aba722a960d91b81525061288290613b4b565b6040518060400160405280600581526020016427aba722a960d91b8152506128a990613b4b565b612b97565b6128e06040518060400160405280600d81526020016c29a427a92a2fa32922a2ad22a960991b81525061288290613b4b565b6129116040518060400160405280600c81526020016b2627a723afa32922a2ad22a960a11b81525061288290613b4b565b61293c604051806040016040528060068152602001652820aaa9a2a960d11b81525061288290613b4b565b61296c6040518060400160405280600581526020016427aba722a960d91b81525061296690613b4b565b336125d8565b61297582611c47565b6112f78161152c565b600054610100900460ff166129a55760405162461bcd60e51b8152600401610c1f90613efb565b6129b28160800151612be2565b6129bf8160600151612cb6565b6129cd816101000151612d8a565b6129db816101200151612e5e565b6129e88160400151612f32565b6129f58160a00151613006565b612a028160c001516130da565b612a0f8160e001516131ae565b612a1c816020015161327b565b8051610ebe90613347565b600054610100900460ff16612a4e5760405162461bcd60e51b8152600401610c1f90613efb565b610fa9613407565b600054610100900460ff16610fa95760405162461bcd60e51b8152600401610c1f90613efb565b612a878282611929565b6112f757612a948161342e565b612a9f836020613440565b604051602001612ab0929190613f46565b60408051601f198184030181529082905262461bcd60e51b8252610c1f916004016139ad565b6001600160a01b0381163b612b435760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610c1f565b60008051602061402d83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b612b7b836135dc565b600082511180612b885750805b15610e2457611077838361361c565b600082815260656020526040808220600101805490849055905190918391839186917fbd79b86ffe0ab8e8776151514217cd7cacd52c909f66475c3af44e129f0b00ff9190a4505050565b6001600160a01b038116612c385760405162461bcd60e51b815260206004820152601e60248201527f696e76616c6964204261636b696e674d616e61676572206164647265737300006044820152606401610c1f565b60cd546040517fd4ec685c4e7367fc82d24a1c90d8c91c07a0e204b5b4655fc1a6d5b6b9d9eeb791612c77916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cd80546001600160a01b0319169091179055565b6001600160a01b038116612d0c5760405162461bcd60e51b815260206004820152601d60248201527f696e76616c6964204261736b657448616e646c657220616464726573730000006044820152606401610c1f565b60cc546040517fa41efa7d680b9ae9379ca75b956c50587b28ed07453f7d19388c7199397a1e8e91612d4b916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cc80546001600160a01b0319169091179055565b6001600160a01b038116612de05760405162461bcd60e51b815260206004820152601960248201527f696e76616c6964205253525472616465722061646472657373000000000000006044820152606401610c1f565b60cf546040517f2fa6596476f0ebdb5fef9a37bedb7ef956e0e1c4e094464cbf49c38f44f7e8d191612e1f916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cf80546001600160a01b0319169091179055565b6001600160a01b038116612eb45760405162461bcd60e51b815260206004820152601c60248201527f696e76616c69642052546f6b656e5472616465722061646472657373000000006044820152606401610c1f565b60d0546040517f0d76a5d5849780e9a81127e61df7ee55bf3f766bc326510d3a52ede3caea168f91612ef3916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560d080546001600160a01b0319169091179055565b6001600160a01b038116612f885760405162461bcd60e51b815260206004820152601d60248201527f696e76616c6964204173736574526567697374727920616464726573730000006044820152606401610c1f565b60cb546040517f5c69d378772ea2f02015deabd3b7ee1db0851dba819e216585de7a155d22a14891612fc7916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560cb80546001600160a01b0319169091179055565b6001600160a01b03811661305c5760405162461bcd60e51b815260206004820152601b60248201527f696e76616c6964204469737472696275746f72206164647265737300000000006044820152606401610c1f565b60ce546040517f8c6eabd1db7fe5a1951a7c78767c0e3633c5352578d15d45f99aa4c4db01c55a9161309b916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560ce80546001600160a01b0319169091179055565b6001600160a01b0381166131305760405162461bcd60e51b815260206004820152601760248201527f696e76616c6964204675726e61636520616464726573730000000000000000006044820152606401610c1f565b60d1546040517fe0c9d7fae2ccca1a3980ce26aada40d9f7fc84406cdb3adbdcfb8f9dd21c9b539161316f916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560d180546001600160a01b0319169091179055565b6001600160a01b0381166131fd5760405162461bcd60e51b8152602060048201526016602482015275696e76616c69642042726f6b6572206164647265737360501b6044820152606401610c1f565b60d2546040517fc29cab4074359a76aba74458623910a8b95269ded89ad9f98cd2db1de3ead3569161323c916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560d280546001600160a01b0319169091179055565b6001600160a01b0381166132c95760405162461bcd60e51b8152602060048201526015602482015274696e76616c6964205374525352206164647265737360581b6044820152606401610c1f565b60ca546040517f1b29dc90e15d6ade122a9e27d886b4a077e66131c7e0cc805fc303e49690c9fc91613308916001600160a01b03909116908490613fbb565b60405180910390a16001600160a01b0316600081815260d360205260409020805460ff1916600117905560ca80546001600160a01b0319169091179055565b6001600160a01b0381166133965760405162461bcd60e51b8152602060048201526016602482015275696e76616c69642052546f6b656e206164647265737360501b6044820152606401610c1f565b60c9546040516001600160a01b038084169216907f2d2909c1d06afe38080a70d63a8793874674efb0fdf3b3bf3fd046056688b3ea90600090a36001600160a01b0316600081815260d360205260409020805460ff1916600117905560c980546001600160a01b0319169091179055565b600054610100900460ff1661265e5760405162461bcd60e51b8152600401610c1f90613efb565b6060610ba66001600160a01b03831660145b6060600061344f836002613fd5565b61345a906002613fec565b67ffffffffffffffff81111561347257613472613804565b6040519080825280601f01601f19166020018201604052801561349c576020820181803683370190505b509050600360fc1b816000815181106134b7576134b7613fff565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106134e6576134e6613fff565b60200101906001600160f81b031916908160001a905350600061350a846002613fd5565b613515906001613fec565b90505b600181111561358d576f181899199a1a9b1b9c1cb0b131b232b360811b85600f166010811061354957613549613fff565b1a60f81b82828151811061355f5761355f613fff565b60200101906001600160f81b031916908160001a90535060049490941c9361358681614015565b9050613518565b5083156119505760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610c1f565b6135e581612ad6565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b6060611950838360405180606001604052806027815260200161404d602791396060600080856001600160a01b0316856040516136599190613d8b565b600060405180830381855af49150503d8060008114613694576040519150601f19603f3d011682016040523d82523d6000602084013e613699565b606091505b50915091506136aa868383876136b4565b9695505050505050565b6060831561372357825160000361371c576001600160a01b0385163b61371c5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610c1f565b508161372d565b61372d8383613735565b949350505050565b8151156137455781518083602001fd5b8060405162461bcd60e51b8152600401610c1f91906139ad565b60006020828403121561377157600080fd5b81356001600160e01b03198116811461195057600080fd5b60006020828403121561379b57600080fd5b5035919050565b6001600160a01b0381168114610ebe57600080fd5b600080604083850312156137ca57600080fd5b8235915060208301356137dc816137a2565b809150509250929050565b6000602082840312156137f957600080fd5b8135611950816137a2565b634e487b7160e01b600052604160045260246000fd5b604051610140810167ffffffffffffffff8111828210171561383e5761383e613804565b60405290565b6040516060810167ffffffffffffffff8111828210171561383e5761383e613804565b604051601f8201601f1916810167ffffffffffffffff8111828210171561389057613890613804565b604052919050565b600067ffffffffffffffff8211156138b2576138b2613804565b50601f01601f191660200190565b600080604083850312156138d357600080fd5b82356138de816137a2565b9150602083013567ffffffffffffffff8111156138fa57600080fd5b8301601f8101851361390b57600080fd5b803561391e61391982613898565b613867565b81815286602083850101111561393357600080fd5b816020840160208301376000602083830101528093505050509250929050565b803565ffffffffffff8116811461396957600080fd5b919050565b60006020828403121561398057600080fd5b61195082613953565b60005b838110156139a457818101518382015260200161398c565b50506000910152565b60208152600082518060208401526139cc816040850160208701613989565b601f01601f19169190910160400192915050565b8035613969816137a2565b6000806000808486036101a0811215613a0357600080fd5b610140811215613a1257600080fd5b50613a1b61381a565b613a24866139e0565b8152613a32602087016139e0565b6020820152613a43604087016139e0565b6040820152613a54606087016139e0565b6060820152613a65608087016139e0565b6080820152613a7660a087016139e0565b60a0820152613a8760c087016139e0565b60c0820152613a9860e087016139e0565b60e0820152613aaa61010087016139e0565b610100820152613abd61012087016139e0565b6101208201529350613ad261014086016139e0565b9250613ae16101608601613953565b9150613af06101808601613953565b905092959194509250565b8015158114610ebe57600080fd5b600080600060608486031215613b1e57600080fd5b833592506020840135613b3081613afb565b91506040840135613b4081613afb565b809150509250925092565b80516020808301519190811015613b6c576000198160200360031b1b821691505b50919050565b600060208284031215613b8457600080fd5b815161195081613afb565b8051613969816137a2565b600060408284031215613bac57600080fd5b6040805190810167ffffffffffffffff81118282101715613bcf57613bcf613804565b80604052508091508251613be2816137a2565b81526020830151613bf2816137a2565b6020919091015292915050565b60008183036101a081128015613c1457600080fd5b50613c1d613844565b8351613c28816137a2565b8152610140601f1983011215613c3d57600080fd5b613c4561381a565b9150613c5360208501613b8f565b8252613c6160408501613b8f565b6020830152613c7260608501613b8f565b6040830152613c8360808501613b8f565b6060830152613c9460a08501613b8f565b6080830152613ca560c08501613b8f565b60a0830152613cb660e08501613b8f565b60c0830152613cc86101008501613b8f565b60e0830152613cda6101208501613b8f565b610100830152613ced6101408501613b8f565b610120830152816020820152613d07856101608601613b9a565b6040820152949350505050565b600060208284031215613d2657600080fd5b815167ffffffffffffffff811115613d3d57600080fd5b8201601f81018413613d4e57600080fd5b8051613d5c61391982613898565b818152856020838501011115613d7157600080fd5b613d82826020830160208601613989565b95945050505050565b60008251613d9d818460208701613989565b9190910192915050565b634e487b7160e01b600052601160045260246000fd5b65ffffffffffff8181168382160190811115610ba657610ba6613da7565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b60208082526018908201527f696e76616c696420726567697374727920616464726573730000000000000000604082015260600190565b6020808252600b908201526a185b1c9958591e481cd95d60aa1b604082015260600190565b81810381811115610ba657610ba6613da7565b600060208284031215613ef457600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351613f7e816017850160208801613989565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351613faf816028840160208801613989565b01602801949350505050565b6001600160a01b0392831681529116602082015260400190565b8082028115828204841417610ba657610ba6613da7565b80820180821115610ba657610ba6613da7565b634e487b7160e01b600052603260045260246000fd5b60008161402457614024613da7565b50600019019056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220000e8c68d2dd0933c7bb1966043e55bad2b2d86cebf28629409b3b9b50ea070d64736f6c634300081c0033","name":"MainP1","is_blueprint":false,"license_type":"none","is_fully_verified":true,"is_verified_via_eth_bytecode_db":true,"language":"solidity","evm_version":"paris","can_be_visualized_via_sol2uml":true,"is_verified_via_sourcify":false,"additional_sources":[{"file_path":"@openzeppelin/contracts/access/IAccessControl.sol","source_code":"// 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"},{"file_path":"contracts/registry/AssetPluginRegistry.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport { Ownable } from \"@openzeppelin/contracts/access/Ownable.sol\";\nimport { VersionRegistry } from \"./VersionRegistry.sol\";\nimport { RoleRegistry } from \"./RoleRegistry.sol\";\n\n/**\n * @title Asset Plugin Registry\n * @notice A tiny contract for tracking asset plugins\n */\ncontract AssetPluginRegistry {\n    VersionRegistry public versionRegistry;\n    RoleRegistry public roleRegistry;\n    // versionHash => asset => isValid\n    mapping(bytes32 => mapping(address => bool)) private _isValidAsset;\n    mapping(address => bool) public isDeprecated;\n\n    error AssetPluginRegistry__InvalidAsset();\n    error AssetPluginRegistry__InvalidCaller();\n    error AssetPluginRegistry__InvalidVersion();\n    error AssetPluginRegistry__LengthMismatch();\n\n    event AssetPluginRegistryUpdated(bytes32 versionHash, address asset, bool validity);\n\n    constructor(address _versionRegistry) {\n        versionRegistry = VersionRegistry(_versionRegistry);\n        roleRegistry = versionRegistry.roleRegistry();\n    }\n\n    function registerAsset(address _asset, bytes32[] calldata validForVersions) external {\n        if (!roleRegistry.isOwner(msg.sender)) {\n            revert AssetPluginRegistry__InvalidCaller();\n        }\n        if (_asset == address(0)) {\n            revert AssetPluginRegistry__InvalidAsset();\n        }\n\n        for (uint256 i = 0; i < validForVersions.length; ++i) {\n            bytes32 versionHash = validForVersions[i];\n            if (address(versionRegistry.deployments(versionHash)) == address(0)) {\n                revert AssetPluginRegistry__InvalidVersion();\n            }\n\n            _isValidAsset[versionHash][_asset] = true;\n\n            emit AssetPluginRegistryUpdated(versionHash, _asset, true);\n        }\n    }\n\n    function updateVersionsByAsset(\n        address _asset,\n        bytes32[] calldata _versionHashes,\n        bool[] calldata _validities\n    ) external {\n        if (!roleRegistry.isOwner(msg.sender)) {\n            revert AssetPluginRegistry__InvalidCaller();\n        }\n        if (_versionHashes.length != _validities.length) {\n            revert AssetPluginRegistry__LengthMismatch();\n        }\n\n        if (_asset == address(0)) {\n            revert AssetPluginRegistry__InvalidAsset();\n        }\n\n        for (uint256 i = 0; i < _versionHashes.length; ++i) {\n            bytes32 versionHash = _versionHashes[i];\n            if (address(versionRegistry.deployments(versionHash)) == address(0)) {\n                revert AssetPluginRegistry__InvalidVersion();\n            }\n\n            _isValidAsset[versionHash][_asset] = _validities[i];\n\n            emit AssetPluginRegistryUpdated(versionHash, _asset, _validities[i]);\n        }\n    }\n\n    function updateAssetsByVersion(\n        bytes32 _versionHash,\n        address[] calldata _assets,\n        bool[] calldata _validities\n    ) external {\n        if (!roleRegistry.isOwner(msg.sender)) {\n            revert AssetPluginRegistry__InvalidCaller();\n        }\n        if (_assets.length != _validities.length) {\n            revert AssetPluginRegistry__LengthMismatch();\n        }\n\n        if (address(versionRegistry.deployments(_versionHash)) == address(0)) {\n            revert AssetPluginRegistry__InvalidVersion();\n        }\n\n        for (uint256 i = 0; i < _assets.length; ++i) {\n            address asset = _assets[i];\n            if (asset == address(0)) {\n                revert AssetPluginRegistry__InvalidAsset();\n            }\n\n            _isValidAsset[_versionHash][asset] = _validities[i];\n\n            emit AssetPluginRegistryUpdated(_versionHash, asset, _validities[i]);\n        }\n    }\n\n    function deprecateAsset(address _asset) external {\n        if (!roleRegistry.isOwnerOrEmergencyCouncil(msg.sender)) {\n            revert AssetPluginRegistry__InvalidCaller();\n        }\n\n        isDeprecated[_asset] = true;\n    }\n\n    function isValidAsset(bytes32 _versionHash, address _asset) external view returns (bool) {\n        if (!isDeprecated[_asset]) {\n            return _isValidAsset[_versionHash][_asset];\n        }\n\n        return false;\n    }\n}\n"},{"file_path":"contracts/interfaces/IAsset.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport \"../libraries/Fixed.sol\";\nimport \"./IMain.sol\";\nimport \"./IRewardable.sol\";\n\n// Not used directly in the IAsset interface, but used by many consumers to save stack space\nstruct Price {\n    uint192 low; // {UoA/tok}\n    uint192 high; // {UoA/tok}\n}\n\n/**\n * @title IAsset\n * @notice Supertype. Any token that interacts with our system must be wrapped in an asset,\n * whether it is used as RToken backing or not. Any token that can report a price in the UoA\n * is eligible to be an asset.\n */\ninterface IAsset is IRewardable {\n    /// Refresh saved price\n    /// The Reserve protocol calls this at least once per transaction, before relying on\n    /// the Asset's other functions.\n    /// @dev Called immediately after deployment, before use\n    function refresh() external;\n\n    /// Should not revert\n    /// low should be nonzero if the asset could be worth selling\n    /// @return low {UoA/tok} The lower end of the price estimate\n    /// @return high {UoA/tok} The upper end of the price estimate\n    function price() external view returns (uint192 low, uint192 high);\n\n    /// @return {tok} The balance of the ERC20 in whole tokens\n    function bal(address account) external view returns (uint192);\n\n    /// @return The ERC20 contract of the token with decimals() available\n    function erc20() external view returns (IERC20Metadata);\n\n    /// @return The number of decimals in the ERC20; just for gas optimization\n    function erc20Decimals() external view returns (uint8);\n\n    /// @return If the asset is an instance of ICollateral or not\n    function isCollateral() external view returns (bool);\n\n    /// @return {UoA} The max trade volume, in UoA\n    function maxTradeVolume() external view returns (uint192);\n\n    /// @return {s} The timestamp of the last refresh() that saved prices\n    function lastSave() external view returns (uint48);\n}\n\n// Used only in Testing. Strictly speaking an Asset does not need to adhere to this interface\ninterface TestIAsset is IAsset {\n    /// @return The address of the chainlink feed\n    function chainlinkFeed() external view returns (AggregatorV3Interface);\n\n    /// {1} The max % deviation allowed by the oracle\n    function oracleError() external view returns (uint192);\n\n    /// @return {s} Seconds that an oracle value is considered valid\n    function oracleTimeout() external view returns (uint48);\n\n    /// @return {s} The maximum of all oracle timeouts on the plugin\n    function maxOracleTimeout() external view returns (uint48);\n\n    /// @return {s} Seconds that the price() should decay over, after stale price\n    function priceTimeout() external view returns (uint48);\n\n    /// @return {UoA/tok} The last saved low price\n    function savedLowPrice() external view returns (uint192);\n\n    /// @return {UoA/tok} The last saved high price\n    function savedHighPrice() external view returns (uint192);\n}\n\n/// CollateralStatus must obey a linear ordering. That is:\n/// - being DISABLED is worse than being IFFY, or SOUND\n/// - being IFFY is worse than being SOUND.\nenum CollateralStatus {\n    SOUND,\n    IFFY, // When a peg is not holding or a chainlink feed is stale\n    DISABLED // When the collateral has completely defaulted\n}\n\n/// Upgrade-safe maximum operator for CollateralStatus\nlibrary CollateralStatusComparator {\n    /// @return Whether a is worse than b\n    function worseThan(CollateralStatus a, CollateralStatus b) internal pure returns (bool) {\n        return uint256(a) > uint256(b);\n    }\n}\n\n/**\n * @title ICollateral\n * @notice A subtype of Asset that consists of the tokens eligible to back the RToken.\n */\ninterface ICollateral is IAsset {\n    /// Emitted whenever the collateral status is changed\n    /// @param newStatus The old CollateralStatus\n    /// @param newStatus The updated CollateralStatus\n    event CollateralStatusChanged(\n        CollateralStatus indexed oldStatus,\n        CollateralStatus indexed newStatus\n    );\n\n    /// @dev refresh()\n    /// Refresh exchange rates and update default status.\n    /// VERY IMPORTANT: In any valid implementation, status() MUST become DISABLED in refresh() if\n    /// refPerTok() has ever decreased since last call.\n\n    /// @return The canonical name of this collateral's target unit.\n    function targetName() external view returns (bytes32);\n\n    /// @return The status of this collateral asset. (Is it defaulting? Might it soon?)\n    function status() external view returns (CollateralStatus);\n\n    // ==== Exchange Rates ====\n\n    /// @return {ref/tok} Quantity of whole reference units per whole collateral tokens\n    function refPerTok() external view returns (uint192);\n\n    /// @return {target/ref} Quantity of whole target units per whole reference unit in the peg\n    function targetPerRef() external view returns (uint192);\n\n    /// @return {target/ref} The peg price of the token during the last update\n    function savedPegPrice() external view returns (uint192);\n}\n\n// Used only in Testing. Strictly speaking a Collateral does not need to adhere to this interface\ninterface TestICollateral is TestIAsset, ICollateral {\n    /// @return The epoch timestamp when the collateral will default from IFFY to DISABLED\n    function whenDefault() external view returns (uint256);\n\n    /// @return The amount of time a collateral must be in IFFY status until being DISABLED\n    function delayUntilDefault() external view returns (uint48);\n\n    /// @return The underlying refPerTok, likely not included in all collaterals however.\n    function underlyingRefPerTok() external view returns (uint192);\n}\n"},{"file_path":"contracts/interfaces/IStRSR.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20MetadataUpgradeable.sol\";\n// solhint-disable-next-line max-line-length\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-IERC20PermitUpgradeable.sol\";\nimport \"../libraries/Fixed.sol\";\nimport \"./IComponent.sol\";\n\n/**\n * @title IStRSR\n * @notice An ERC20 token representing shares of the RSR over-collateralization pool.\n *\n * StRSR permits the BackingManager to take RSR in times of need. In return, the BackingManager\n * benefits the StRSR pool with RSR rewards purchased with a portion of its revenue.\n *\n * In the absence of collateral default or losses due to slippage, StRSR should have a\n * monotonically increasing exchange rate with respect to RSR, meaning that over time\n * StRSR is redeemable for more RSR. It is non-rebasing.\n */\ninterface IStRSR is IERC20MetadataUpgradeable, IERC20PermitUpgradeable, IComponent {\n    error InsufficientBalance();\n    error IndexOutOfBounds();\n    error WithdrawalUnavailable();\n    error RTokenNotReady();\n    error NotBackingManager();\n    error SeizeExceedsBalance();\n    error RatesStillSafe();\n    error DecreaseAllowanceError();\n    error InsufficientAllowance();\n    error TransferToSelf();\n    error ZeroAddress();\n    error ZeroAmount();\n    error ExpiredDeadline();\n    error InvalidUnstakingDelay();\n    error InvalidRewardRatio();\n    error InvalidWithdrawalLeak();\n    error SignatureExpired();\n    error InvalidNonce();\n    error FutureLookup();\n    error NameEmpty();\n    error SymbolEmpty();\n\n    /// Emitted when RSR is staked\n    /// @param era The era at time of staking\n    /// @param staker The address of the staker\n    /// @param rsrAmount {qRSR} How much RSR was staked\n    /// @param stRSRAmount {qStRSR} How much stRSR was minted by this staking\n    event Staked(\n        uint256 indexed era,\n        address indexed staker,\n        uint256 rsrAmount,\n        uint256 stRSRAmount\n    );\n\n    /// Emitted when an unstaking is started\n    /// @param draftId The id of the draft.\n    /// @param draftEra The era of the draft.\n    /// @param staker The address of the unstaker\n    ///   The triple (staker, draftEra, draftId) is a unique ID\n    /// @param rsrAmount {qRSR} How much RSR this unstaking will be worth, absent seizures\n    /// @param stRSRAmount {qStRSR} How much stRSR was burned by this unstaking\n    event UnstakingStarted(\n        uint256 indexed draftId,\n        uint256 indexed draftEra,\n        address indexed staker,\n        uint256 rsrAmount,\n        uint256 stRSRAmount,\n        uint256 availableAt\n    );\n\n    /// Emitted when RSR is unstaked\n    /// @param firstId The beginning of the range of draft IDs withdrawn in this transaction\n    /// @param endId The end of range of draft IDs withdrawn in this transaction\n    ///   (ID i was withdrawn if firstId <= i < endId)\n    /// @param draftEra The era of the draft.\n    ///   The triple (staker, draftEra, id) is a unique ID among drafts\n    /// @param staker The address of the unstaker\n\n    /// @param rsrAmount {qRSR} How much RSR this unstaking was worth\n    event UnstakingCompleted(\n        uint256 indexed firstId,\n        uint256 indexed endId,\n        uint256 draftEra,\n        address indexed staker,\n        uint256 rsrAmount\n    );\n\n    /// Emitted when RSR unstaking is cancelled\n    /// @param firstId The beginning of the range of draft IDs withdrawn in this transaction\n    /// @param endId The end of range of draft IDs withdrawn in this transaction\n    ///   (ID i was withdrawn if firstId <= i < endId)\n    /// @param draftEra The era of the draft.\n    ///   The triple (staker, draftEra, id) is a unique ID among drafts\n    /// @param staker The address of the unstaker\n\n    /// @param rsrAmount {qRSR} How much RSR this unstaking was worth\n    event UnstakingCancelled(\n        uint256 indexed firstId,\n        uint256 indexed endId,\n        uint256 draftEra,\n        address indexed staker,\n        uint256 rsrAmount\n    );\n\n    /// Emitted whenever the exchange rate changes\n    event ExchangeRateSet(uint192 oldVal, uint192 newVal);\n\n    /// Emitted whenever RSR are paids out\n    event RewardsPaid(uint256 rsrAmt);\n\n    /// Emitted if all the RSR in the staking pool is seized and all balances are reset to zero.\n    event AllBalancesReset(uint256 indexed newEra);\n    /// Emitted if all the RSR in the unstakin pool is seized, and all ongoing unstaking is voided.\n    event AllUnstakingReset(uint256 indexed newEra);\n\n    event UnstakingDelaySet(uint48 oldVal, uint48 newVal);\n    event RewardRatioSet(uint192 oldVal, uint192 newVal);\n    event WithdrawalLeakSet(uint192 oldVal, uint192 newVal);\n\n    // Initialization\n    function init(\n        IMain main_,\n        string memory name_,\n        string memory symbol_,\n        uint48 unstakingDelay_,\n        uint192 rewardRatio_,\n        uint192 withdrawalLeak_\n    ) external;\n\n    /// Gather and payout rewards from rsrTrader\n    /// @custom:interaction\n    function payoutRewards() external;\n\n    /// Stakes an RSR `amount` on the corresponding RToken to earn yield and over-collateralized\n    /// the system\n    /// @param amount {qRSR}\n    /// @custom:interaction\n    function stake(uint256 amount) external;\n\n    /// Begins a delayed unstaking for `amount` stRSR\n    /// @param amount {qStRSR}\n    /// @custom:interaction\n    function unstake(uint256 amount) external;\n\n    /// Complete delayed unstaking for the account, up to (but not including!) `endId`\n    /// @custom:interaction\n    function withdraw(address account, uint256 endId) external;\n\n    /// Cancel unstaking for the account, up to (but not including!) `endId`\n    /// @custom:interaction\n    function cancelUnstake(uint256 endId) external;\n\n    /// Seize RSR, only callable by main.backingManager()\n    /// @custom:protected\n    function seizeRSR(uint256 amount) external;\n\n    /// Reset all stakes and advance era\n    /// @custom:governance\n    function resetStakes() external;\n\n    /// Return the maximum valid value of endId such that withdraw(endId) should immediately work\n    function endIdForWithdraw(address account) external view returns (uint256 endId);\n\n    /// @return {qRSR/qStRSR} The exchange rate between RSR and StRSR\n    function exchangeRate() external view returns (uint192);\n}\n\ninterface TestIStRSR is IStRSR {\n    function rewardRatio() external view returns (uint192);\n\n    function setRewardRatio(uint192) external;\n\n    function unstakingDelay() external view returns (uint48);\n\n    function setUnstakingDelay(uint48) external;\n\n    function withdrawalLeak() external view returns (uint192);\n\n    function setWithdrawalLeak(uint192) external;\n\n    function increaseAllowance(address, uint256) external returns (bool);\n\n    function decreaseAllowance(address, uint256) external returns (bool);\n\n    /// @return {qStRSR/qRSR} The exchange rate between StRSR and RSR\n    function exchangeRate() external view returns (uint192);\n}\n"},{"file_path":"contracts/interfaces/IFurnace.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"../libraries/Fixed.sol\";\nimport \"./IComponent.sol\";\n\n/**\n * @title IFurnace\n * @notice A helper contract to burn RTokens slowly and permisionlessly.\n */\ninterface IFurnace is IComponent {\n    // Initialization\n    function init(IMain main_, uint192 ratio_) external;\n\n    /// Emitted when the melting ratio is changed\n    /// @param oldRatio The old ratio\n    /// @param newRatio The new ratio\n    event RatioSet(uint192 oldRatio, uint192 newRatio);\n\n    function ratio() external view returns (uint192);\n\n    ///    Needed value range: [0, 1], granularity 1e-9\n    /// @custom:governance\n    function setRatio(uint192) external;\n\n    /// Performs any RToken melting that has vested since the last payout.\n    /// @custom:refresher\n    function melt() external;\n}\n\ninterface TestIFurnace is IFurnace {\n    function lastPayout() external view returns (uint256);\n\n    function lastPayoutBal() external view returns (uint256);\n}\n"},{"file_path":"@openzeppelin/contracts/utils/structs/EnumerableSet.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/structs/EnumerableSet.sol)\n// This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.\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 * ```solidity\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 *\n * [WARNING]\n * ====\n * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure\n * unusable.\n * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.\n *\n * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an\n * array of EnumerableSet.\n * ====\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        bytes32[] memory store = _values(set._inner);\n        bytes32[] memory result;\n\n        /// @solidity memory-safe-assembly\n        assembly {\n            result := store\n        }\n\n        return result;\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        /// @solidity memory-safe-assembly\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 in 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        /// @solidity memory-safe-assembly\n        assembly {\n            result := store\n        }\n\n        return result;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20MetadataUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20Upgradeable.sol\";\n\n/**\n * @dev Interface for the optional metadata functions from the ERC20 standard.\n *\n * _Available since v4.1._\n */\ninterface IERC20MetadataUpgradeable is IERC20Upgradeable {\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"},{"file_path":"@openzeppelin/contracts-upgradeable/proxy/beacon/IBeaconUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This is the interface that {BeaconProxy} expects of its beacon.\n */\ninterface IBeaconUpgradeable {\n    /**\n     * @dev Must return an address that can be used as a delegate call target.\n     *\n     * {BeaconProxy} will check that this address is a contract.\n     */\n    function implementation() external view returns (address);\n}\n"},{"file_path":"@reserve-protocol/trusted-fillers/contracts/interfaces/IBaseTrustedFiller.sol","source_code":"// SPDX-License-Identifier: MIT\npragma solidity ^0.8.19;\n\nimport { IERC20 } from \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport { IERC1271 } from \"@openzeppelin/contracts/interfaces/IERC1271.sol\";\n\ninterface IBaseTrustedFiller is IERC1271 {\n    error BaseTrustedFiller__SwapActive();\n\n    function initialize(\n        address _creator,\n        IERC20 _sellToken,\n        IERC20 _buyToken,\n        uint256 _sellAmount,\n        uint256 _minBuyAmount\n    ) external;\n\n    function buyToken() external view returns (IERC20);\n\n    function sellToken() external view returns (IERC20);\n\n    function swapActive() external view returns (bool);\n\n    function closeFiller() external;\n\n    function rescueToken(IERC20 token) external;\n\n    function setPartiallyFillable(bool _partiallyFillable) external;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../ERC1967/ERC1967UpgradeUpgradeable.sol\";\nimport {Initializable} from \"./Initializable.sol\";\n\n/**\n * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an\n * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.\n *\n * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is\n * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing\n * `UUPSUpgradeable` with a custom implementation of upgrades.\n *\n * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.\n *\n * _Available since v4.1._\n */\nabstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {\n    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment\n    address private immutable __self = address(this);\n\n    /**\n     * @dev Check that the execution is being performed through a delegatecall call and that the execution context is\n     * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case\n     * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a\n     * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to\n     * fail.\n     */\n    modifier onlyProxy() {\n        require(address(this) != __self, \"Function must be called through delegatecall\");\n        require(_getImplementation() == __self, \"Function must be called through active proxy\");\n        _;\n    }\n\n    /**\n     * @dev Check that the execution is not being performed through a delegate call. This allows a function to be\n     * callable on the implementing contract but not through proxies.\n     */\n    modifier notDelegated() {\n        require(address(this) == __self, \"UUPSUpgradeable: must not be called through delegatecall\");\n        _;\n    }\n\n    function __UUPSUpgradeable_init() internal onlyInitializing {\n    }\n\n    function __UUPSUpgradeable_init_unchained() internal onlyInitializing {\n    }\n    /**\n     * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the\n     * implementation. It is used to validate the implementation's compatibility when performing an upgrade.\n     *\n     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n     * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.\n     */\n    function proxiableUUID() external view virtual override notDelegated returns (bytes32) {\n        return _IMPLEMENTATION_SLOT;\n    }\n\n    /**\n     * @dev Upgrade the implementation of the proxy to `newImplementation`.\n     *\n     * Calls {_authorizeUpgrade}.\n     *\n     * Emits an {Upgraded} event.\n     *\n     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n     */\n    function upgradeTo(address newImplementation) public virtual onlyProxy {\n        _authorizeUpgrade(newImplementation);\n        _upgradeToAndCallUUPS(newImplementation, new bytes(0), false);\n    }\n\n    /**\n     * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call\n     * encoded in `data`.\n     *\n     * Calls {_authorizeUpgrade}.\n     *\n     * Emits an {Upgraded} event.\n     *\n     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n     */\n    function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {\n        _authorizeUpgrade(newImplementation);\n        _upgradeToAndCallUUPS(newImplementation, data, true);\n    }\n\n    /**\n     * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by\n     * {upgradeTo} and {upgradeToAndCall}.\n     *\n     * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.\n     *\n     * ```solidity\n     * function _authorizeUpgrade(address) internal override onlyOwner {}\n     * ```\n     */\n    function _authorizeUpgrade(address newImplementation) internal virtual;\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[50] private __gap;\n}\n"},{"file_path":"contracts/interfaces/IVersioned.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\ninterface IVersioned {\n    function version() external view returns (string memory);\n}\n"},{"file_path":"@openzeppelin/contracts/utils/introspection/IERC165.sol","source_code":"// 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"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (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 IERC20Upgradeable {\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    /**\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 `to`.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transfer(address to, 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 `from` to `to` 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(address from, address to, uint256 amount) external returns (bool);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/interfaces/IERC1967Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.\n *\n * _Available since v4.8.3._\n */\ninterface IERC1967Upgradeable {\n    /**\n     * @dev Emitted when the implementation is upgraded.\n     */\n    event Upgraded(address indexed implementation);\n\n    /**\n     * @dev Emitted when the admin account has changed.\n     */\n    event AdminChanged(address previousAdmin, address newAdmin);\n\n    /**\n     * @dev Emitted when the beacon is changed.\n     */\n    event BeaconUpgraded(address indexed beacon);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/StorageSlotUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)\n// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Library for reading and writing primitive types to specific storage slots.\n *\n * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.\n * This library helps with reading and writing to such slots without the need for inline assembly.\n *\n * The functions in this library return Slot structs that contain a `value` member that can be used to read or write.\n *\n * Example usage to set ERC1967 implementation slot:\n * ```solidity\n * contract ERC1967 {\n *     bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n *\n *     function _getImplementation() internal view returns (address) {\n *         return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n *     }\n *\n *     function _setImplementation(address newImplementation) internal {\n *         require(Address.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n *         StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n *     }\n * }\n * ```\n *\n * _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._\n * _Available since v4.9 for `string`, `bytes`._\n */\nlibrary StorageSlotUpgradeable {\n    struct AddressSlot {\n        address value;\n    }\n\n    struct BooleanSlot {\n        bool value;\n    }\n\n    struct Bytes32Slot {\n        bytes32 value;\n    }\n\n    struct Uint256Slot {\n        uint256 value;\n    }\n\n    struct StringSlot {\n        string value;\n    }\n\n    struct BytesSlot {\n        bytes value;\n    }\n\n    /**\n     * @dev Returns an `AddressSlot` with member `value` located at `slot`.\n     */\n    function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `BooleanSlot` with member `value` located at `slot`.\n     */\n    function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `Bytes32Slot` with member `value` located at `slot`.\n     */\n    function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `Uint256Slot` with member `value` located at `slot`.\n     */\n    function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `StringSlot` with member `value` located at `slot`.\n     */\n    function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `StringSlot` representation of the string storage pointer `store`.\n     */\n    function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := store.slot\n        }\n    }\n\n    /**\n     * @dev Returns an `BytesSlot` with member `value` located at `slot`.\n     */\n    function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := slot\n        }\n    }\n\n    /**\n     * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.\n     */\n    function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {\n        /// @solidity memory-safe-assembly\n        assembly {\n            r.slot := store.slot\n        }\n    }\n}\n"},{"file_path":"contracts/interfaces/IRewardable.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\n/**\n * @title IRewardable\n * @notice A simple interface mixin to support claiming of rewards.\n */\ninterface IRewardable {\n    /// Emitted whenever a reward token balance is claimed\n    /// @param erc20 The ERC20 of the reward token\n    /// @param amount {qTok}\n    event RewardsClaimed(IERC20 indexed erc20, uint256 amount);\n\n    /// Claim rewards earned by holding a balance of the ERC20 token\n    /// Must emit `RewardsClaimed` for each token rewards are claimed for\n    /// @custom:interaction\n    function claimRewards() external;\n}\n\n/**\n * @title IRewardableComponent\n * @notice A simple interface mixin to support claiming of rewards.\n */\ninterface IRewardableComponent is IRewardable {\n    /// Claim rewards for a single ERC20\n    /// Must emit `RewardsClaimed` for each token rewards are claimed for\n    /// @custom:interaction\n    function claimRewardsSingle(IERC20 erc20) external;\n}\n"},{"file_path":"@reserve-protocol/trusted-fillers/contracts/interfaces/ITrustedFillerRegistry.sol","source_code":"// SPDX-License-Identifier: MIT\npragma solidity ^0.8.19;\n\nimport { IBaseTrustedFiller } from \"./IBaseTrustedFiller.sol\";\n\ninterface ITrustedFillerRegistry {\n    error TrustedFillerRegistry__InvalidCaller();\n    error TrustedFillerRegistry__InvalidRoleRegistry();\n    error TrustedFillerRegistry__InvalidFiller();\n\n    event TrustedFillerCreated(address creator, IBaseTrustedFiller filler);\n    event TrustedFillerAdded(IBaseTrustedFiller filler);\n    event TrustedFillerDeprecated(IBaseTrustedFiller filler);\n\n    function addTrustedFiller(IBaseTrustedFiller _filler) external;\n\n    function deprecateTrustedFiller(IBaseTrustedFiller _filler) external;\n\n    function createTrustedFiller(\n        address senderSource,\n        address trustedFiller,\n        bytes32 deploymentSalt\n    ) external returns (IBaseTrustedFiller trustedFillerInstance);\n\n    function isAllowed(address _filler) external view returns (bool);\n}\n"},{"file_path":"contracts/interfaces/IRToken.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20MetadataUpgradeable.sol\";\n// solhint-disable-next-line max-line-length\nimport \"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-IERC20PermitUpgradeable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../libraries/Throttle.sol\";\nimport \"./IComponent.sol\";\n\n/**\n * @title IRToken\n * @notice An RToken is an ERC20 that is permissionlessly issuable/redeemable and tracks an\n *   exchange rate against a single unit: baskets, or {BU} in our type notation.\n */\ninterface IRToken is IComponent, IERC20MetadataUpgradeable, IERC20PermitUpgradeable {\n    /// Emitted when an issuance of RToken occurs, whether it occurs via slow minting or not\n    /// @param issuer The address holding collateral tokens\n    /// @param recipient The address of the recipient of the RTokens\n    /// @param amount The quantity of RToken being issued\n    /// @param baskets The corresponding number of baskets\n    event Issuance(\n        address indexed issuer,\n        address indexed recipient,\n        uint256 amount,\n        uint192 baskets\n    );\n\n    /// Emitted when a redemption of RToken occurs\n    /// @param redeemer The address holding RToken\n    /// @param recipient The address of the account receiving the backing collateral tokens\n    /// @param amount The quantity of RToken being redeemed\n    /// @param baskets The corresponding number of baskets\n    /// @param amount {qRTok} The amount of RTokens canceled\n    event Redemption(\n        address indexed redeemer,\n        address indexed recipient,\n        uint256 amount,\n        uint192 baskets\n    );\n\n    /// Emitted when the number of baskets needed changes\n    /// @param oldBasketsNeeded Previous number of baskets units needed\n    /// @param newBasketsNeeded New number of basket units needed\n    event BasketsNeededChanged(uint192 oldBasketsNeeded, uint192 newBasketsNeeded);\n\n    /// Emitted when RToken is melted, i.e the RToken supply is decreased but basketsNeeded is not\n    /// @param amount {qRTok}\n    event Melted(uint256 amount);\n\n    /// Emitted when issuance SupplyThrottle params are set\n    event IssuanceThrottleSet(ThrottleLib.Params oldVal, ThrottleLib.Params newVal);\n\n    /// Emitted when redemption SupplyThrottle params are set\n    event RedemptionThrottleSet(ThrottleLib.Params oldVal, ThrottleLib.Params newVal);\n\n    // Initialization\n    function init(\n        IMain main_,\n        string memory name_,\n        string memory symbol_,\n        string memory mandate_,\n        ThrottleLib.Params calldata issuanceThrottleParams,\n        ThrottleLib.Params calldata redemptionThrottleParams\n    ) external;\n\n    /// Issue an RToken with basket collateral\n    /// @param amount {qRTok} The quantity of RToken to issue\n    /// @custom:interaction\n    function issue(uint256 amount) external;\n\n    /// Issue an RToken with basket collateral, to a particular recipient\n    /// @param recipient The address to receive the issued RTokens\n    /// @param amount {qRTok} The quantity of RToken to issue\n    /// @custom:interaction\n    function issueTo(address recipient, uint256 amount) external;\n\n    /// Redeem RToken for basket collateral\n    /// @dev Use redeemCustom for non-current baskets\n    /// @param amount {qRTok} The quantity {qRToken} of RToken to redeem\n    /// @custom:interaction\n    function redeem(uint256 amount) external;\n\n    /// Redeem RToken for basket collateral to a particular recipient\n    /// @dev Use redeemCustom for non-current baskets\n    /// @param recipient The address to receive the backing collateral tokens\n    /// @param amount {qRTok} The quantity {qRToken} of RToken to redeem\n    /// @custom:interaction\n    function redeemTo(address recipient, uint256 amount) external;\n\n    /// Redeem RToken for a linear combination of historical baskets, to a particular recipient\n    /// @dev Allows partial redemptions up to the minAmounts\n    /// @param recipient The address to receive the backing collateral tokens\n    /// @param amount {qRTok} The quantity {qRToken} of RToken to redeem\n    /// @param basketNonces An array of basket nonces to do redemption from\n    /// @param portions {1} An array of Fix quantities that must add up to FIX_ONE\n    /// @param expectedERC20sOut An array of ERC20s expected out\n    /// @param minAmounts {qTok} The minimum ERC20 quantities the caller should receive\n    /// @custom:interaction\n    function redeemCustom(\n        address recipient,\n        uint256 amount,\n        uint48[] memory basketNonces,\n        uint192[] memory portions,\n        address[] memory expectedERC20sOut,\n        uint256[] memory minAmounts\n    ) external;\n\n    /// Mint an amount of RToken equivalent to baskets BUs, scaling basketsNeeded up\n    /// Callable only by BackingManager\n    /// @param baskets {BU} The number of baskets to mint RToken for\n    /// @custom:protected\n    function mint(uint192 baskets) external;\n\n    /// Melt a quantity of RToken from the caller's account\n    /// @param amount {qRTok} The amount to be melted\n    /// @custom:protected\n    function melt(uint256 amount) external;\n\n    /// Burn an amount of RToken from caller's account and scale basketsNeeded down\n    /// Callable only by BackingManager\n    /// @custom:protected\n    function dissolve(uint256 amount) external;\n\n    /// Set the number of baskets needed directly, callable only by the BackingManager\n    /// @param basketsNeeded {BU} The number of baskets to target\n    ///                      needed range: pretty interesting\n    /// @custom:protected\n    function setBasketsNeeded(uint192 basketsNeeded) external;\n\n    /// @return {BU} How many baskets are being targeted\n    function basketsNeeded() external view returns (uint192);\n\n    /// @return {qRTok} The maximum issuance that can be performed in the current block\n    function issuanceAvailable() external view returns (uint256);\n\n    /// @return {qRTok} The maximum redemption that can be performed in the current block\n    function redemptionAvailable() external view returns (uint256);\n}\n\ninterface TestIRToken is IRToken {\n    function setIssuanceThrottleParams(ThrottleLib.Params calldata) external;\n\n    function setRedemptionThrottleParams(ThrottleLib.Params calldata) external;\n\n    function setThrottleParams(\n        ThrottleLib.Params calldata issuanceParams,\n        ThrottleLib.Params calldata redemptionParams\n    ) external;\n\n    function issuanceThrottleParams() external view returns (ThrottleLib.Params memory);\n\n    function redemptionThrottleParams() external view returns (ThrottleLib.Params memory);\n\n    function increaseAllowance(address, uint256) external returns (bool);\n\n    function decreaseAllowance(address, uint256) external returns (bool);\n\n    function monetizeDonations(IERC20) external;\n}\n"},{"file_path":"contracts/interfaces/IMain.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/access/IAccessControlUpgradeable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../registry/AssetPluginRegistry.sol\";\nimport \"../registry/VersionRegistry.sol\";\nimport \"../registry/DAOFeeRegistry.sol\";\nimport \"./IAssetRegistry.sol\";\nimport \"./IBasketHandler.sol\";\nimport \"./IBackingManager.sol\";\nimport \"./IBroker.sol\";\nimport \"./IDistributor.sol\";\nimport \"./IFurnace.sol\";\nimport \"./IGnosis.sol\";\nimport \"./IRToken.sol\";\nimport \"./IRevenueTrader.sol\";\nimport \"./IStRSR.sol\";\nimport \"./ITrading.sol\";\nimport \"./IVersioned.sol\";\n\n// === Auth roles ===\n\nbytes32 constant OWNER = bytes32(bytes(\"OWNER\"));\nbytes32 constant SHORT_FREEZER = bytes32(bytes(\"SHORT_FREEZER\"));\nbytes32 constant LONG_FREEZER = bytes32(bytes(\"LONG_FREEZER\"));\nbytes32 constant PAUSER = bytes32(bytes(\"PAUSER\"));\n\n/**\n * Main is a central hub that maintains a list of Component contracts.\n *\n * Components:\n *   - perform a specific function\n *   - defer auth to Main\n *   - usually (but not always) contain sizeable state that require a proxy\n */\nstruct Components {\n    // Definitely need proxy\n    IRToken rToken;\n    IStRSR stRSR;\n    IAssetRegistry assetRegistry;\n    IBasketHandler basketHandler;\n    IBackingManager backingManager;\n    IDistributor distributor;\n    IFurnace furnace;\n    IBroker broker;\n    IRevenueTrader rsrTrader;\n    IRevenueTrader rTokenTrader;\n}\n\ninterface IAuth is IAccessControlUpgradeable {\n    /// Emitted when `unfreezeAt` is changed\n    /// @param oldVal The old value of `unfreezeAt`\n    /// @param newVal The new value of `unfreezeAt`\n    event UnfreezeAtSet(uint48 oldVal, uint48 newVal);\n\n    /// Emitted when the short freeze duration governance param is changed\n    /// @param oldDuration The old short freeze duration\n    /// @param newDuration The new short freeze duration\n    event ShortFreezeDurationSet(uint48 oldDuration, uint48 newDuration);\n\n    /// Emitted when the long freeze duration governance param is changed\n    /// @param oldDuration The old long freeze duration\n    /// @param newDuration The new long freeze duration\n    event LongFreezeDurationSet(uint48 oldDuration, uint48 newDuration);\n\n    /// Emitted when the system is paused or unpaused for trading\n    /// @param oldVal The old value of `tradingPaused`\n    /// @param newVal The new value of `tradingPaused`\n    event TradingPausedSet(bool oldVal, bool newVal);\n\n    /// Emitted when the system is paused or unpaused for issuance\n    /// @param oldVal The old value of `issuancePaused`\n    /// @param newVal The new value of `issuancePaused`\n    event IssuancePausedSet(bool oldVal, bool newVal);\n\n    /**\n     * Trading Paused: Disable everything except for OWNER actions, RToken.issue, RToken.redeem,\n     * StRSR.stake, and StRSR.payoutRewards\n     * Issuance Paused: Disable RToken.issue\n     * Frozen: Disable everything except for OWNER actions + StRSR.stake (for governance)\n     */\n\n    function tradingPausedOrFrozen() external view returns (bool);\n\n    function issuancePausedOrFrozen() external view returns (bool);\n\n    function frozen() external view returns (bool);\n\n    function shortFreeze() external view returns (uint48);\n\n    function longFreeze() external view returns (uint48);\n\n    // ====\n\n    // onlyRole(OWNER)\n    function freezeForever() external;\n\n    // onlyRole(SHORT_FREEZER)\n    function freezeShort() external;\n\n    // onlyRole(LONG_FREEZER)\n    function freezeLong() external;\n\n    // onlyRole(OWNER)\n    function unfreeze() external;\n\n    function pauseTrading() external;\n\n    function unpauseTrading() external;\n\n    function pauseIssuance() external;\n\n    function unpauseIssuance() external;\n}\n\ninterface IComponentRegistry {\n    // === Component setters/getters ===\n\n    event RTokenSet(IRToken indexed oldVal, IRToken indexed newVal);\n\n    function rToken() external view returns (IRToken);\n\n    event StRSRSet(IStRSR oldVal, IStRSR newVal);\n\n    function stRSR() external view returns (IStRSR);\n\n    event AssetRegistrySet(IAssetRegistry oldVal, IAssetRegistry newVal);\n\n    function assetRegistry() external view returns (IAssetRegistry);\n\n    event BasketHandlerSet(IBasketHandler oldVal, IBasketHandler newVal);\n\n    function basketHandler() external view returns (IBasketHandler);\n\n    event BackingManagerSet(IBackingManager oldVal, IBackingManager newVal);\n\n    function backingManager() external view returns (IBackingManager);\n\n    event DistributorSet(IDistributor oldVal, IDistributor newVal);\n\n    function distributor() external view returns (IDistributor);\n\n    event RSRTraderSet(IRevenueTrader oldVal, IRevenueTrader newVal);\n\n    function rsrTrader() external view returns (IRevenueTrader);\n\n    event RTokenTraderSet(IRevenueTrader oldVal, IRevenueTrader newVal);\n\n    function rTokenTrader() external view returns (IRevenueTrader);\n\n    event FurnaceSet(IFurnace oldVal, IFurnace newVal);\n\n    function furnace() external view returns (IFurnace);\n\n    event BrokerSet(IBroker oldVal, IBroker newVal);\n\n    function broker() external view returns (IBroker);\n\n    function isComponent(address addr) external view returns (bool);\n}\n\n/**\n * @title IMain\n * @notice The central hub for the entire system. Maintains components and an owner singleton role\n */\ninterface IMain is IVersioned, IAuth, IComponentRegistry {\n    function poke() external; // not used in p1\n\n    // === Initialization ===\n\n    event MainInitialized();\n\n    function init(\n        Components memory components,\n        IERC20 rsr_,\n        uint48 shortFreeze_,\n        uint48 longFreeze_\n    ) external;\n\n    function rsr() external view returns (IERC20);\n\n    function assetPluginRegistry() external view returns (AssetPluginRegistry);\n\n    function versionRegistry() external view returns (VersionRegistry);\n\n    function daoFeeRegistry() external view returns (DAOFeeRegistry);\n\n    // === Control flow ===\n\n    function beginTx() external;\n\n    function endTx() external;\n}\n\ninterface TestIMain is IMain {\n    error ReentrancyGuardReentrantCall();\n\n    function setVersionRegistry(VersionRegistry) external;\n\n    function setAssetPluginRegistry(AssetPluginRegistry) external;\n\n    function setDAOFeeRegistry(DAOFeeRegistry) external;\n\n    /// @custom:governance\n    function setShortFreeze(uint48) external;\n\n    /// @custom:governance\n    function setLongFreeze(uint48) external;\n\n    function shortFreeze() external view returns (uint48);\n\n    function longFreeze() external view returns (uint48);\n\n    function longFreezes(address account) external view returns (uint256);\n\n    function tradingPaused() external view returns (bool);\n\n    function issuancePaused() external view returns (bool);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\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 ContextUpgradeable is Initializable {\n    function __Context_init() internal onlyInitializing {\n    }\n\n    function __Context_init_unchained() internal onlyInitializing {\n    }\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    function _contextSuffixLength() internal view virtual returns (uint256) {\n        return 0;\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[50] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard math utilities missing in the Solidity language.\n */\nlibrary MathUpgradeable {\n    enum Rounding {\n        Down, // Toward negative infinity\n        Up, // Toward infinity\n        Zero // Toward zero\n    }\n\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 == 0 ? 0 : (a - 1) / b + 1;\n    }\n\n    /**\n     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n     * with further edits by Uniswap Labs also under MIT license.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n        unchecked {\n            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n            // variables such that product = prod1 * 2^256 + prod0.\n            uint256 prod0; // Least significant 256 bits of the product\n            uint256 prod1; // Most significant 256 bits of the product\n            assembly {\n                let mm := mulmod(x, y, not(0))\n                prod0 := mul(x, y)\n                prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n            }\n\n            // Handle non-overflow cases, 256 by 256 division.\n            if (prod1 == 0) {\n                // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n                // The surrounding unchecked block does not change this fact.\n                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n                return prod0 / denominator;\n            }\n\n            // Make sure the result is less than 2^256. Also prevents denominator == 0.\n            require(denominator > prod1, \"Math: mulDiv overflow\");\n\n            ///////////////////////////////////////////////\n            // 512 by 256 division.\n            ///////////////////////////////////////////////\n\n            // Make division exact by subtracting the remainder from [prod1 prod0].\n            uint256 remainder;\n            assembly {\n                // Compute remainder using mulmod.\n                remainder := mulmod(x, y, denominator)\n\n                // Subtract 256 bit number from 512 bit number.\n                prod1 := sub(prod1, gt(remainder, prod0))\n                prod0 := sub(prod0, remainder)\n            }\n\n            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n            // See https://cs.stackexchange.com/q/138556/92363.\n\n            // Does not overflow because the denominator cannot be zero at this stage in the function.\n            uint256 twos = denominator & (~denominator + 1);\n            assembly {\n                // Divide denominator by twos.\n                denominator := div(denominator, twos)\n\n                // Divide [prod1 prod0] by twos.\n                prod0 := div(prod0, twos)\n\n                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n                twos := add(div(sub(0, twos), twos), 1)\n            }\n\n            // Shift in bits from prod1 into prod0.\n            prod0 |= prod1 * twos;\n\n            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n            // four bits. That is, denominator * inv = 1 mod 2^4.\n            uint256 inverse = (3 * denominator) ^ 2;\n\n            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n            // in modular arithmetic, doubling the correct bits in each step.\n            inverse *= 2 - denominator * inverse; // inverse mod 2^8\n            inverse *= 2 - denominator * inverse; // inverse mod 2^16\n            inverse *= 2 - denominator * inverse; // inverse mod 2^32\n            inverse *= 2 - denominator * inverse; // inverse mod 2^64\n            inverse *= 2 - denominator * inverse; // inverse mod 2^128\n            inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n            // is no longer required.\n            result = prod0 * inverse;\n            return result;\n        }\n    }\n\n    /**\n     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n        uint256 result = mulDiv(x, y, denominator);\n        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n            result += 1;\n        }\n        return result;\n    }\n\n    /**\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n     *\n     * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n     */\n    function sqrt(uint256 a) internal pure returns (uint256) {\n        if (a == 0) {\n            return 0;\n        }\n\n        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n        //\n        // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n        //\n        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n        //\n        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n        uint256 result = 1 << (log2(a) >> 1);\n\n        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n        // into the expected uint128 result.\n        unchecked {\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            return min(result, a / result);\n        }\n    }\n\n    /**\n     * @notice Calculates sqrt(a), following the selected rounding direction.\n     */\n    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = sqrt(a);\n            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 2, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 128;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 64;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 32;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 16;\n            }\n            if (value >> 8 > 0) {\n                value >>= 8;\n                result += 8;\n            }\n            if (value >> 4 > 0) {\n                value >>= 4;\n                result += 4;\n            }\n            if (value >> 2 > 0) {\n                value >>= 2;\n                result += 2;\n            }\n            if (value >> 1 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log2(value);\n            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 10, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >= 10 ** 64) {\n                value /= 10 ** 64;\n                result += 64;\n            }\n            if (value >= 10 ** 32) {\n                value /= 10 ** 32;\n                result += 32;\n            }\n            if (value >= 10 ** 16) {\n                value /= 10 ** 16;\n                result += 16;\n            }\n            if (value >= 10 ** 8) {\n                value /= 10 ** 8;\n                result += 8;\n            }\n            if (value >= 10 ** 4) {\n                value /= 10 ** 4;\n                result += 4;\n            }\n            if (value >= 10 ** 2) {\n                value /= 10 ** 2;\n                result += 2;\n            }\n            if (value >= 10 ** 1) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log10(value);\n            return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 256, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     *\n     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n     */\n    function log256(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 16;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 8;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 4;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 2;\n            }\n            if (value >> 8 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log256(value);\n            return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n        }\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IERC165Upgradeable.sol\";\nimport {Initializable} from \"../../proxy/utils/Initializable.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 ERC165Upgradeable is Initializable, IERC165Upgradeable {\n    function __ERC165_init() internal onlyInitializing {\n    }\n\n    function __ERC165_init_unchained() internal onlyInitializing {\n    }\n    /**\n     * @dev See {IERC165-supportsInterface}.\n     */\n    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n        return interfaceId == type(IERC165Upgradeable).interfaceId;\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[50] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/proxy/ERC1967/ERC1967UpgradeUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../beacon/IBeaconUpgradeable.sol\";\nimport \"../../interfaces/IERC1967Upgradeable.sol\";\nimport \"../../interfaces/draft-IERC1822Upgradeable.sol\";\nimport \"../../utils/AddressUpgradeable.sol\";\nimport \"../../utils/StorageSlotUpgradeable.sol\";\nimport {Initializable} from \"../utils/Initializable.sol\";\n\n/**\n * @dev This abstract contract provides getters and event emitting update functions for\n * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.\n *\n * _Available since v4.1._\n */\nabstract contract ERC1967UpgradeUpgradeable is Initializable, IERC1967Upgradeable {\n    // This is the keccak-256 hash of \"eip1967.proxy.rollback\" subtracted by 1\n    bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;\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 = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\n\n    function __ERC1967Upgrade_init() internal onlyInitializing {\n    }\n\n    function __ERC1967Upgrade_init_unchained() internal onlyInitializing {\n    }\n    /**\n     * @dev Returns the current implementation address.\n     */\n    function _getImplementation() internal view returns (address) {\n        return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;\n    }\n\n    /**\n     * @dev Stores a new address in the EIP1967 implementation slot.\n     */\n    function _setImplementation(address newImplementation) private {\n        require(AddressUpgradeable.isContract(newImplementation), \"ERC1967: new implementation is not a contract\");\n        StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;\n    }\n\n    /**\n     * @dev Perform implementation upgrade\n     *\n     * Emits an {Upgraded} event.\n     */\n    function _upgradeTo(address newImplementation) internal {\n        _setImplementation(newImplementation);\n        emit Upgraded(newImplementation);\n    }\n\n    /**\n     * @dev Perform implementation upgrade with additional setup call.\n     *\n     * Emits an {Upgraded} event.\n     */\n    function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {\n        _upgradeTo(newImplementation);\n        if (data.length > 0 || forceCall) {\n            AddressUpgradeable.functionDelegateCall(newImplementation, data);\n        }\n    }\n\n    /**\n     * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.\n     *\n     * Emits an {Upgraded} event.\n     */\n    function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {\n        // Upgrades from old implementations will perform a rollback test. This test requires the new\n        // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing\n        // this special case will break upgrade paths from old UUPS implementation to new ones.\n        if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {\n            _setImplementation(newImplementation);\n        } else {\n            try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {\n                require(slot == _IMPLEMENTATION_SLOT, \"ERC1967Upgrade: unsupported proxiableUUID\");\n            } catch {\n                revert(\"ERC1967Upgrade: new implementation is not UUPS\");\n            }\n            _upgradeToAndCall(newImplementation, data, forceCall);\n        }\n    }\n\n    /**\n     * @dev Storage slot with the admin of the contract.\n     * This is the keccak-256 hash of \"eip1967.proxy.admin\" subtracted by 1, and is\n     * validated in the constructor.\n     */\n    bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;\n\n    /**\n     * @dev Returns the current admin.\n     */\n    function _getAdmin() internal view returns (address) {\n        return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;\n    }\n\n    /**\n     * @dev Stores a new address in the EIP1967 admin slot.\n     */\n    function _setAdmin(address newAdmin) private {\n        require(newAdmin != address(0), \"ERC1967: new admin is the zero address\");\n        StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;\n    }\n\n    /**\n     * @dev Changes the admin of the proxy.\n     *\n     * Emits an {AdminChanged} event.\n     */\n    function _changeAdmin(address newAdmin) internal {\n        emit AdminChanged(_getAdmin(), newAdmin);\n        _setAdmin(newAdmin);\n    }\n\n    /**\n     * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.\n     * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.\n     */\n    bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;\n\n    /**\n     * @dev Returns the current beacon.\n     */\n    function _getBeacon() internal view returns (address) {\n        return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;\n    }\n\n    /**\n     * @dev Stores a new beacon in the EIP1967 beacon slot.\n     */\n    function _setBeacon(address newBeacon) private {\n        require(AddressUpgradeable.isContract(newBeacon), \"ERC1967: new beacon is not a contract\");\n        require(\n            AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),\n            \"ERC1967: beacon implementation is not a contract\"\n        );\n        StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;\n    }\n\n    /**\n     * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does\n     * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).\n     *\n     * Emits a {BeaconUpgraded} event.\n     */\n    function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {\n        _setBeacon(newBeacon);\n        emit BeaconUpgraded(newBeacon);\n        if (data.length > 0 || forceCall) {\n            AddressUpgradeable.functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);\n        }\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[50] private __gap;\n}\n"},{"file_path":"contracts/libraries/Throttle.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"./Fixed.sol\";\n\nuint48 constant ONE_HOUR = 3600; // {seconds/hour}\n\n/**\n * @title ThrottleLib\n * A library that implements a usage throttle that can be used to ensure net issuance\n * or net redemption for an RToken never exceeds some bounds per unit time (hour).\n *\n * It is expected for the RToken to use this library with two instances, one for issuance\n * and one for redemption. Issuance causes the available redemption amount to increase, and\n * visa versa.\n */\nlibrary ThrottleLib {\n    using FixLib for uint192;\n\n    struct Params {\n        uint256 amtRate; // {qRTok/hour} a quantity of RToken hourly; cannot be 0\n        uint192 pctRate; // {1/hour} a fraction of RToken hourly; can be 0\n    }\n\n    struct Throttle {\n        // === Gov params ===\n        Params params;\n        // === Cache ===\n        uint48 lastTimestamp; // {seconds}\n        uint256 lastAvailable; // {qRTok}\n    }\n\n    /// Reverts if usage amount exceeds available amount\n    /// @param supply {qRTok} Total RToken supply beforehand\n    /// @param amount {qRTok} Amount of RToken to use. Should be negative for the issuance\n    ///   throttle during redemption and for the redemption throttle during issuance.\n    function useAvailable(\n        Throttle storage throttle,\n        uint256 supply,\n        int256 amount\n    ) internal {\n        // untestable: amtRate will always be > 0 due to previous validations\n        if (throttle.params.amtRate == 0 && throttle.params.pctRate == 0) return;\n\n        // Calculate hourly limit\n        uint256 limit = hourlyLimit(throttle, supply); // {qRTok}\n\n        // Calculate available amount before supply change\n        uint256 available = currentlyAvailable(throttle, limit);\n\n        // Update throttle.timestamp if available amount changed or at limit\n        if (available != throttle.lastAvailable || available == limit) {\n            throttle.lastTimestamp = uint48(block.timestamp);\n        }\n\n        // Update throttle.lastAvailable\n        if (amount > 0) {\n            require(uint256(amount) <= available, \"supply change throttled\");\n            available -= uint256(amount);\n            // untestable: the final else statement, amount will never be 0\n        } else if (amount < 0) {\n            available += uint256(-amount);\n        }\n        throttle.lastAvailable = available;\n    }\n\n    /// @param limit {qRTok/hour} The hourly limit\n    /// @return available {qRTok} Amount currently available for consumption\n    function currentlyAvailable(Throttle storage throttle, uint256 limit)\n        internal\n        view\n        returns (uint256 available)\n    {\n        uint48 delta = uint48(block.timestamp) - throttle.lastTimestamp; // {seconds}\n        available = throttle.lastAvailable + (limit * delta) / ONE_HOUR;\n        if (available > limit) available = limit;\n    }\n\n    /// @return limit {qRTok} The hourly limit\n    function hourlyLimit(Throttle storage throttle, uint256 supply)\n        internal\n        view\n        returns (uint256 limit)\n    {\n        Params storage params = throttle.params;\n\n        // Calculate hourly limit as: max(params.amtRate, supply.mul(params.pctRate))\n        limit = (supply * params.pctRate) / FIX_ONE_256; // {qRTok}\n        if (params.amtRate > limit) limit = params.amtRate;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/access/IAccessControlUpgradeable.sol","source_code":"// 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 IAccessControlUpgradeable {\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"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)\n\npragma solidity ^0.8.1;\n\n/**\n * @dev Collection of functions related to the address type\n */\nlibrary AddressUpgradeable {\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     * Furthermore, `isContract` will also return true if the target contract within\n     * the same transaction is already scheduled for destruction by `SELFDESTRUCT`,\n     * which only has an effect at the end of a transaction.\n     * ====\n     *\n     * [IMPORTANT]\n     * ====\n     * You shouldn't rely on `isContract` to protect against flash loan attacks!\n     *\n     * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets\n     * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract\n     * constructor.\n     * ====\n     */\n    function isContract(address account) internal view returns (bool) {\n        // This method relies on extcodesize/address.code.length, which returns 0\n        // for contracts in construction, since the code is only stored at the end\n        // of the constructor execution.\n\n        return account.code.length > 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://consensys.net/diligence/blog/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.8.0/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 functionCallWithValue(target, data, 0, \"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(address target, bytes memory data, uint256 value) 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        (bool success, bytes memory returndata) = target.call{value: value}(data);\n        return verifyCallResultFromTarget(target, 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        (bool success, bytes memory returndata) = target.staticcall(data);\n        return verifyCallResultFromTarget(target, 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        (bool success, bytes memory returndata) = target.delegatecall(data);\n        return verifyCallResultFromTarget(target, success, returndata, errorMessage);\n    }\n\n    /**\n     * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling\n     * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.\n     *\n     * _Available since v4.8._\n     */\n    function verifyCallResultFromTarget(\n        address target,\n        bool success,\n        bytes memory returndata,\n        string memory errorMessage\n    ) internal view returns (bytes memory) {\n        if (success) {\n            if (returndata.length == 0) {\n                // only check isContract if the call was successful and the return data is empty\n                // otherwise we already know that it was a contract\n                require(isContract(target), \"Address: call to non-contract\");\n            }\n            return returndata;\n        } else {\n            _revert(returndata, errorMessage);\n        }\n    }\n\n    /**\n     * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the\n     * revert reason or 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            _revert(returndata, errorMessage);\n        }\n    }\n\n    function _revert(bytes memory returndata, string memory errorMessage) private pure {\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            /// @solidity memory-safe-assembly\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"},{"file_path":"@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/ContextUpgradeable.sol\";\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract OwnableUpgradeable is Initializable, ContextUpgradeable {\n    address private _owner;\n\n    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n    /**\n     * @dev Initializes the contract setting the deployer as the initial owner.\n     */\n    function __Ownable_init() internal onlyInitializing {\n        __Ownable_init_unchained();\n    }\n\n    function __Ownable_init_unchained() internal onlyInitializing {\n        _transferOwnership(_msgSender());\n    }\n\n    /**\n     * @dev Throws if called by any account other than the owner.\n     */\n    modifier onlyOwner() {\n        _checkOwner();\n        _;\n    }\n\n    /**\n     * @dev Returns the address of the current owner.\n     */\n    function owner() public view virtual returns (address) {\n        return _owner;\n    }\n\n    /**\n     * @dev Throws if the sender is not the owner.\n     */\n    function _checkOwner() internal view virtual {\n        require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n    }\n\n    /**\n     * @dev Leaves the contract without owner. It will not be possible to call\n     * `onlyOwner` functions. Can only be called by the current owner.\n     *\n     * NOTE: Renouncing ownership will leave the contract without an owner,\n     * thereby disabling any functionality that is only available to the owner.\n     */\n    function renounceOwnership() public virtual onlyOwner {\n        _transferOwnership(address(0));\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Can only be called by the current owner.\n     */\n    function transferOwnership(address newOwner) public virtual onlyOwner {\n        require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n        _transferOwnership(newOwner);\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Internal function without access restriction.\n     */\n    function _transferOwnership(address newOwner) internal virtual {\n        address oldOwner = _owner;\n        _owner = newOwner;\n        emit OwnershipTransferred(oldOwner, newOwner);\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[49] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMathUpgradeable {\n    /**\n     * @dev Returns the largest of two signed numbers.\n     */\n    function max(int256 a, int256 b) internal pure returns (int256) {\n        return a > b ? a : b;\n    }\n\n    /**\n     * @dev Returns the smallest of two signed numbers.\n     */\n    function min(int256 a, int256 b) internal pure returns (int256) {\n        return a < b ? a : b;\n    }\n\n    /**\n     * @dev Returns the average of two signed numbers without overflow.\n     * The result is rounded towards zero.\n     */\n    function average(int256 a, int256 b) internal pure returns (int256) {\n        // Formula from the book \"Hacker's Delight\"\n        int256 x = (a & b) + ((a ^ b) >> 1);\n        return x + (int256(uint256(x) >> 255) & (a ^ b));\n    }\n\n    /**\n     * @dev Returns the absolute unsigned value of a signed value.\n     */\n    function abs(int256 n) internal pure returns (uint256) {\n        unchecked {\n            // must be unchecked in order to support `n = type(int256).min`\n            return uint256(n >= 0 ? n : -n);\n        }\n    }\n}\n"},{"file_path":"contracts/interfaces/IBackingManager.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"./IAssetRegistry.sol\";\nimport \"./IBasketHandler.sol\";\nimport \"./IComponent.sol\";\nimport \"./IRToken.sol\";\nimport \"./IStRSR.sol\";\nimport \"./ITrading.sol\";\n\n/// Memory struct for RecollateralizationLibP1 + RTokenAsset\n/// Struct purposes:\n///   1. Configure trading\n///   2. Stay under stack limit with fewer vars\n///   3. Cache information such as component addresses and basket quantities, to save on gas\nstruct TradingContext {\n    BasketRange basketsHeld; // {BU}\n    // basketsHeld.top is the number of partial baskets units held\n    // basketsHeld.bottom is the number of full basket units held\n\n    // Components\n    IBasketHandler bh;\n    IAssetRegistry ar;\n    IStRSR stRSR;\n    IERC20 rsr;\n    IRToken rToken;\n    // Gov Vars\n    uint192 minTradeVolume; // {UoA}\n    uint192 maxTradeSlippage; // {1}\n    // Cached values\n    uint192[] quantities; // {tok/BU} basket quantities\n    uint192[] bals; // {tok} balances in BackingManager + out on trades\n}\n\n/**\n * @title IBackingManager\n * @notice The BackingManager handles changes in the ERC20 balances that back an RToken.\n *   - It computes which trades to perform, if any, and initiates these trades with the Broker.\n *     - rebalance()\n *   - If already collateralized, excess assets are transferred to RevenueTraders.\n *     - forwardRevenue(IERC20[] calldata erc20s)\n */\ninterface IBackingManager is IComponent, ITrading {\n    /// Emitted when the trading delay is changed\n    /// @param oldVal The old trading delay\n    /// @param newVal The new trading delay\n    event TradingDelaySet(uint48 oldVal, uint48 newVal);\n\n    /// Emitted when the backing buffer is changed\n    /// @param oldVal The old backing buffer\n    /// @param newVal The new backing buffer\n    event BackingBufferSet(uint192 oldVal, uint192 newVal);\n\n    // Initialization\n    function init(\n        IMain main_,\n        uint48 tradingDelay_,\n        uint192 backingBuffer_,\n        uint192 maxTradeSlippage_,\n        uint192 minTradeVolume_\n    ) external;\n\n    // Give RToken max allowance over a registered token\n    /// @custom:refresher\n    /// @custom:interaction\n    function grantRTokenAllowance(IERC20) external;\n\n    /// Apply the overall backing policy using the specified TradeKind, taking a haircut if unable\n    /// @param kind TradeKind.DUTCH_AUCTION or TradeKind.BATCH_AUCTION\n    /// @custom:interaction RCEI\n    function rebalance(TradeKind kind) external;\n\n    /// Forward revenue to RevenueTraders; reverts if not fully collateralized\n    /// @param erc20s The tokens to forward\n    /// @custom:interaction RCEI\n    function forwardRevenue(IERC20[] calldata erc20s) external;\n\n    /// Structs for trading\n    /// @param basketsHeld The number of baskets held by the BackingManager\n    /// @return ctx The TradingContext\n    /// @return reg Contents of AssetRegistry.getRegistry()\n    function tradingContext(BasketRange memory basketsHeld)\n        external\n        view\n        returns (TradingContext memory ctx, Registry memory reg);\n}\n\ninterface TestIBackingManager is IBackingManager, TestITrading {\n    function tradingDelay() external view returns (uint48);\n\n    function backingBuffer() external view returns (uint192);\n\n    function setTradingDelay(uint48 val) external;\n\n    function setBackingBuffer(uint192 val) external;\n}\n"},{"file_path":"contracts/mixins/Versioned.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"../interfaces/IVersioned.sol\";\n\n// This value should be updated on each release\nstring constant VERSION = \"4.2.0\";\n\n/**\n * @title Versioned\n * @notice A mix-in to track semantic versioning uniformly across contracts.\n */\nabstract contract Versioned is IVersioned {\n    function version() public pure virtual override returns (string memory) {\n        return VERSION;\n    }\n}\n"},{"file_path":"contracts/registry/VersionRegistry.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport { IDeployer, Implementations } from \"../interfaces/IDeployer.sol\";\nimport { RoleRegistry } from \"./RoleRegistry.sol\";\n\n/**\n * @title VersionRegistry\n * @notice A tiny contract for tracking deployment versions\n *         All versions registered are expected to be >=4.0.0\n */\ncontract VersionRegistry {\n    mapping(bytes32 => IDeployer) public deployments;\n    mapping(bytes32 => bool) public isDeprecated;\n    bytes32 private latestVersion;\n    RoleRegistry public roleRegistry;\n\n    error VersionRegistry__ZeroAddress();\n    error VersionRegistry__InvalidRegistration();\n    error VersionRegistry__AlreadyDeprecated();\n    error VersionRegistry__InvalidRoleRegistry();\n    error VersionRegistry__InvalidCaller();\n\n    event VersionRegistered(bytes32 versionHash, IDeployer deployer);\n    event VersionDeprecated(bytes32 versionHash);\n\n    constructor(RoleRegistry _roleRegistry) {\n        if (address(_roleRegistry) == address(0)) {\n            revert VersionRegistry__ZeroAddress();\n        }\n\n        roleRegistry = _roleRegistry;\n    }\n\n    /// Register a deployer address, keyed by version.\n    /// @param deployer The deployer contract address for the version to be added.\n    function registerVersion(IDeployer deployer) external {\n        if (!roleRegistry.isOwner(msg.sender)) {\n            revert VersionRegistry__InvalidCaller();\n        }\n\n        if (address(deployer) == address(0)) {\n            revert VersionRegistry__ZeroAddress();\n        }\n\n        string memory version = deployer.version();\n        bytes32 versionHash = keccak256(abi.encodePacked(version));\n\n        if (address(deployments[versionHash]) != address(0)) {\n            revert VersionRegistry__InvalidRegistration();\n        }\n\n        deployments[versionHash] = deployer;\n        latestVersion = versionHash;\n\n        emit VersionRegistered(versionHash, deployer);\n    }\n\n    function deprecateVersion(bytes32 versionHash) external {\n        if (!roleRegistry.isOwnerOrEmergencyCouncil(msg.sender)) {\n            revert VersionRegistry__InvalidCaller();\n        }\n\n        if (isDeprecated[versionHash]) {\n            revert VersionRegistry__AlreadyDeprecated();\n        }\n        isDeprecated[versionHash] = true;\n\n        emit VersionDeprecated(versionHash);\n    }\n\n    function getLatestVersion()\n        external\n        view\n        returns (\n            bytes32 versionHash,\n            string memory version,\n            IDeployer deployer,\n            bool deprecated\n        )\n    {\n        versionHash = latestVersion;\n        deployer = deployments[versionHash];\n        version = deployer.version();\n        deprecated = isDeprecated[versionHash];\n    }\n\n    function getImplementationForVersion(bytes32 versionHash)\n        external\n        view\n        returns (Implementations memory)\n    {\n        return deployments[versionHash].implementations();\n    }\n}\n"},{"file_path":"contracts/libraries/Fixed.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\n// solhint-disable func-name-mixedcase func-visibility\n// slither-disable-start divide-before-multiply\npragma solidity 0.8.28;\n\n/// @title FixedPoint, a fixed-point arithmetic library defining the custom type uint192\n/// @author Matt Elder <matt.elder@reserve.org> and the Reserve Team <https://reserve.org>\n\n/** The logical type `uint192 ` is a 192 bit value, representing an 18-decimal Fixed-point\n    fractional value.  This is what's described in the Solidity documentation as\n    \"fixed192x18\" -- a value represented by 192 bits, that makes 18 digits available to\n    the right of the decimal point.\n\n    The range of values that uint192 can represent is [0, 2^192-1 / 10^18 = 6.2e39].\n    Unless a function explicitly says otherwise, it will fail on overflow.\n    To be clear, the following should hold:\n    toFix(0) == 0\n    toFix(1) == 1e18\n*/\n\n// Analysis notes:\n//   Every function should revert iff its result is out of bounds.\n//   Unless otherwise noted, when a rounding mode is given, that mode is applied to\n//     a single division that may happen as the last step in the computation.\n//   Unless otherwise noted, when a rounding mode is *not* given but is needed, it's FLOOR.\n//   For each, we comment:\n//   - @return is the value expressed  in \"value space\", where uint192(1e18) \"is\" 1.0\n//   - as-ints: is the value expressed in \"implementation space\", where uint192(1e18) \"is\" 1e18\n//   The \"@return\" expression is suitable for actually using the library\n//   The \"as-ints\" expression is suitable for testing\n\n// A uint value passed to this library was out of bounds for uint192 operations\nerror UIntOutOfBounds();\nbytes32 constant UIntOutofBoundsHash = keccak256(abi.encodeWithSignature(\"UIntOutOfBounds()\"));\n\n// Used by P1 implementation for easier casting\nuint256 constant FIX_ONE_256 = 1e18;\nuint8 constant FIX_DECIMALS = 18;\n\n// If a particular uint192 is represented by the uint192 n, then the uint192 represents the\n// value n/FIX_SCALE.\nuint64 constant FIX_SCALE = 1e18;\n\n// FIX_SCALE Squared:\nuint128 constant FIX_SCALE_SQ = 1e36;\n\n// The largest integer that can be converted to uint192.\n// This is a bit bigger than 6.2e39\nuint192 constant FIX_MAX_INT = type(uint192).max / FIX_SCALE;\n\nuint192 constant FIX_ZERO = 0; // The uint192 representation of zero.\nuint192 constant FIX_ONE = FIX_SCALE; // The uint192 representation of one.\nuint192 constant FIX_MAX = type(uint192).max; // The largest uint192. (Not an integer!)\nuint192 constant FIX_MIN = 0; // The smallest uint192.\n\n/// An enum that describes a rounding approach for converting to ints\nenum RoundingMode {\n    FLOOR, // Round towards zero\n    ROUND, // Round to the nearest int\n    CEIL // Round away from zero\n}\n\nRoundingMode constant FLOOR = RoundingMode.FLOOR;\nRoundingMode constant ROUND = RoundingMode.ROUND;\nRoundingMode constant CEIL = RoundingMode.CEIL;\n\n/* @dev Solidity 0.8.x only allows you to change one of type or size per type conversion.\n   Thus, all the tedious-looking double conversions like uint256(uint256 (foo))\n   See: https://docs.soliditylang.org/en/v0.8.17/080-breaking-changes.html#new-restrictions\n */\n\n/// Explicitly convert a uint256 to a uint192. Revert if the input is out of bounds.\nfunction _safeWrap(uint256 x) pure returns (uint192) {\n    if (FIX_MAX < x) revert UIntOutOfBounds();\n    return uint192(x);\n}\n\n/// Convert a uint to its Fix representation.\n/// @return x\n// as-ints: x * 1e18\nfunction toFix(uint256 x) pure returns (uint192) {\n    return _safeWrap(x * FIX_SCALE);\n}\n\n/// Convert a uint to its fixed-point representation, and left-shift its value `shiftLeft`\n/// decimal digits.\n/// @return x * 10**shiftLeft\n// as-ints: x * 10**(shiftLeft + 18)\nfunction shiftl_toFix(uint256 x, int8 shiftLeft) pure returns (uint192) {\n    return shiftl_toFix(x, shiftLeft, FLOOR);\n}\n\n/// @return x * 10**shiftLeft\n// as-ints: x * 10**(shiftLeft + 18)\nfunction shiftl_toFix(\n    uint256 x,\n    int8 shiftLeft,\n    RoundingMode rounding\n) pure returns (uint192) {\n    // conditions for avoiding overflow\n    if (x == 0) return 0;\n    if (shiftLeft <= -96) return (rounding == CEIL ? 1 : 0); // 0 < uint.max / 10**77 < 0.5\n    if (40 <= shiftLeft) revert UIntOutOfBounds(); // 10**57 < FIX_MAX < 10**58\n\n    shiftLeft += 18;\n\n    uint256 coeff = 10**abs(shiftLeft);\n    uint256 shifted = (shiftLeft >= 0) ? x * coeff : _divrnd(x, coeff, rounding);\n\n    return _safeWrap(shifted);\n}\n\n/// Divide a uint by a uint192, yielding a uint192\n/// This may also fail if the result is MIN_uint192! not fixing this for optimization's sake.\n/// @return x / y\n// as-ints: x * 1e36 / y\nfunction divFix(uint256 x, uint192 y) pure returns (uint192) {\n    // If we didn't have to worry about overflow, we'd just do `return x * 1e36 / _y`\n    // If it's safe to do this operation the easy way, do it:\n    if (x < uint256(type(uint256).max / FIX_SCALE_SQ)) {\n        return _safeWrap(uint256(x * FIX_SCALE_SQ) / y);\n    } else {\n        return _safeWrap(mulDiv256(x, FIX_SCALE_SQ, y));\n    }\n}\n\n/// Divide a uint by a uint, yielding a  uint192\n/// @return x / y\n// as-ints: x * 1e18 / y\nfunction divuu(uint256 x, uint256 y) pure returns (uint192) {\n    return _safeWrap(mulDiv256(FIX_SCALE, x, y));\n}\n\n/// @return min(x,y)\n// as-ints: min(x,y)\nfunction fixMin(uint192 x, uint192 y) pure returns (uint192) {\n    return x < y ? x : y;\n}\n\n/// @return max(x,y)\n// as-ints: max(x,y)\nfunction fixMax(uint192 x, uint192 y) pure returns (uint192) {\n    return x > y ? x : y;\n}\n\n/// @return absoluteValue(x,y)\n// as-ints: absoluteValue(x,y)\nfunction abs(int256 x) pure returns (uint256) {\n    return x < 0 ? uint256(-x) : uint256(x);\n}\n\n/// Divide two uints, returning a uint, using rounding mode `rounding`.\n/// @return numerator / divisor\n// as-ints: numerator / divisor\nfunction _divrnd(\n    uint256 numerator,\n    uint256 divisor,\n    RoundingMode rounding\n) pure returns (uint256) {\n    uint256 result = numerator / divisor;\n\n    if (rounding == FLOOR) return result;\n\n    if (rounding == ROUND) {\n        if (numerator % divisor > (divisor - 1) / 2) {\n            result++;\n        }\n    } else {\n        if (numerator % divisor != 0) {\n            result++;\n        }\n    }\n\n    return result;\n}\n\nlibrary FixLib {\n    /// Again, all arithmetic functions fail if and only if the result is out of bounds.\n\n    /// Convert this fixed-point value to a uint. Round towards zero if needed.\n    /// @return x\n    // as-ints: x / 1e18\n    function toUint(uint192 x) internal pure returns (uint136) {\n        return toUint(x, FLOOR);\n    }\n\n    /// Convert this uint192 to a uint\n    /// @return x\n    // as-ints: x / 1e18 with rounding\n    function toUint(uint192 x, RoundingMode rounding) internal pure returns (uint136) {\n        return uint136(_divrnd(uint256(x), FIX_SCALE, rounding));\n    }\n\n    /// Return the uint192 shifted to the left by `decimal` digits\n    /// (Similar to a bitshift but in base 10)\n    /// @return x * 10**decimals\n    // as-ints: x * 10**decimals\n    function shiftl(uint192 x, int8 decimals) internal pure returns (uint192) {\n        return shiftl(x, decimals, FLOOR);\n    }\n\n    /// Return the uint192 shifted to the left by `decimal` digits\n    /// (Similar to a bitshift but in base 10)\n    /// @return x * 10**decimals\n    // as-ints: x * 10**decimals\n    function shiftl(\n        uint192 x,\n        int8 decimals,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        // Handle overflow cases\n        if (x == 0) return 0;\n        if (decimals <= -59) return (rounding == CEIL ? 1 : 0); // 59, because 1e58 > 2**192\n        if (58 <= decimals) revert UIntOutOfBounds(); // 58, because x * 1e58 > 2 ** 192 if x != 0\n\n        uint256 coeff = uint256(10**abs(decimals));\n        return _safeWrap(decimals >= 0 ? x * coeff : _divrnd(x, coeff, rounding));\n    }\n\n    /// Add a uint192 to this uint192\n    /// @return x + y\n    // as-ints: x + y\n    function plus(uint192 x, uint192 y) internal pure returns (uint192) {\n        return x + y;\n    }\n\n    /// Add a uint to this uint192\n    /// @return x + y\n    // as-ints: x + y*1e18\n    function plusu(uint192 x, uint256 y) internal pure returns (uint192) {\n        return _safeWrap(x + y * FIX_SCALE);\n    }\n\n    /// Subtract a uint192 from this uint192\n    /// @return x - y\n    // as-ints: x - y\n    function minus(uint192 x, uint192 y) internal pure returns (uint192) {\n        return x - y;\n    }\n\n    /// Subtract a uint from this uint192\n    /// @return x - y\n    // as-ints: x - y*1e18\n    function minusu(uint192 x, uint256 y) internal pure returns (uint192) {\n        return _safeWrap(uint256(x) - uint256(y * FIX_SCALE));\n    }\n\n    /// Multiply this uint192 by a uint192\n    /// Round truncated values to the nearest available value. 5e-19 rounds away from zero.\n    /// @return x * y\n    // as-ints: x * y/1e18  [division using ROUND, not FLOOR]\n    function mul(uint192 x, uint192 y) internal pure returns (uint192) {\n        return mul(x, y, ROUND);\n    }\n\n    /// Multiply this uint192 by a uint192\n    /// @return x * y\n    // as-ints: x * y/1e18\n    function mul(\n        uint192 x,\n        uint192 y,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        return _safeWrap(_divrnd(uint256(x) * uint256(y), FIX_SCALE, rounding));\n    }\n\n    /// Multiply this uint192 by a uint\n    /// @return x * y\n    // as-ints: x * y\n    function mulu(uint192 x, uint256 y) internal pure returns (uint192) {\n        return _safeWrap(x * y);\n    }\n\n    /// Divide this uint192 by a uint192\n    /// @return x / y\n    // as-ints: x * 1e18 / y\n    function div(uint192 x, uint192 y) internal pure returns (uint192) {\n        return div(x, y, FLOOR);\n    }\n\n    /// Divide this uint192 by a uint192\n    /// @return x / y\n    // as-ints: x * 1e18 / y\n    function div(\n        uint192 x,\n        uint192 y,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        // Multiply-in FIX_SCALE before dividing by y to preserve precision.\n        return _safeWrap(_divrnd(uint256(x) * FIX_SCALE, y, rounding));\n    }\n\n    /// Divide this uint192 by a uint\n    /// @return x / y\n    // as-ints: x / y\n    function divu(uint192 x, uint256 y) internal pure returns (uint192) {\n        return divu(x, y, FLOOR);\n    }\n\n    /// Divide this uint192 by a uint\n    /// @return x / y\n    // as-ints: x / y\n    function divu(\n        uint192 x,\n        uint256 y,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        return _safeWrap(_divrnd(x, y, rounding));\n    }\n\n    uint64 constant FIX_HALF = uint64(FIX_SCALE) / 2;\n\n    /// Raise this uint192 to a nonnegative integer power. Requires that x_ <= FIX_ONE\n    /// Gas cost is O(lg(y)), precision is +- 1e-18.\n    /// @return x_ ** y\n    // as-ints: x_ ** y / 1e18**(y-1)    <- technically correct for y = 0. :D\n    function powu(uint192 x_, uint48 y) internal pure returns (uint192) {\n        require(x_ <= FIX_ONE);\n        if (y == 1) return x_;\n        if (x_ == FIX_ONE || y == 0) return FIX_ONE;\n        uint256 x = uint256(x_) * FIX_SCALE; // x is D36\n        uint256 result = FIX_SCALE_SQ; // result is D36\n        while (true) {\n            if (y & 1 == 1) result = (result * x + FIX_SCALE_SQ / 2) / FIX_SCALE_SQ;\n            if (y <= 1) break;\n            y = (y >> 1);\n            x = (x * x + FIX_SCALE_SQ / 2) / FIX_SCALE_SQ;\n        }\n        return _safeWrap(result / FIX_SCALE);\n    }\n\n    function sqrt(uint192 x) internal pure returns (uint192) {\n        return _safeWrap(sqrt256(x * FIX_ONE_256)); // FLOOR\n    }\n\n    /// Comparison operators...\n    function lt(uint192 x, uint192 y) internal pure returns (bool) {\n        return x < y;\n    }\n\n    function lte(uint192 x, uint192 y) internal pure returns (bool) {\n        return x <= y;\n    }\n\n    function gt(uint192 x, uint192 y) internal pure returns (bool) {\n        return x > y;\n    }\n\n    function gte(uint192 x, uint192 y) internal pure returns (bool) {\n        return x >= y;\n    }\n\n    function eq(uint192 x, uint192 y) internal pure returns (bool) {\n        return x == y;\n    }\n\n    function neq(uint192 x, uint192 y) internal pure returns (bool) {\n        return x != y;\n    }\n\n    /// Return whether or not this uint192 is less than epsilon away from y.\n    /// @return |x - y| < epsilon\n    // as-ints: |x - y| < epsilon\n    function near(\n        uint192 x,\n        uint192 y,\n        uint192 epsilon\n    ) internal pure returns (bool) {\n        uint192 diff = x <= y ? y - x : x - y;\n        return diff < epsilon;\n    }\n\n    // ================ Chained Operations ================\n    // The operation foo_bar() always means:\n    //   Do foo() followed by bar(), and overflow only if the _end_ result doesn't fit in an uint192\n\n    /// Shift this uint192 left by `decimals` digits, and convert to a uint\n    /// @return x * 10**decimals\n    // as-ints: x * 10**(decimals - 18)\n    function shiftl_toUint(uint192 x, int8 decimals) internal pure returns (uint256) {\n        return shiftl_toUint(x, decimals, FLOOR);\n    }\n\n    /// Shift this uint192 left by `decimals` digits, and convert to a uint.\n    /// @return x * 10**decimals\n    // as-ints: x * 10**(decimals - 18)\n    function shiftl_toUint(\n        uint192 x,\n        int8 decimals,\n        RoundingMode rounding\n    ) internal pure returns (uint256) {\n        // Handle overflow cases\n        if (x == 0) return 0; // always computable, no matter what decimals is\n        if (decimals <= -42) return (rounding == CEIL ? 1 : 0);\n        if (96 <= decimals) revert UIntOutOfBounds();\n\n        decimals -= 18; // shift so that toUint happens at the same time.\n\n        uint256 coeff = uint256(10**abs(decimals));\n        return decimals >= 0 ? uint256(x * coeff) : uint256(_divrnd(x, coeff, rounding));\n    }\n\n    /// Multiply this uint192 by a uint, and output the result as a uint\n    /// @return x * y\n    // as-ints: x * y / 1e18\n    function mulu_toUint(uint192 x, uint256 y) internal pure returns (uint256) {\n        return mulDiv256(uint256(x), y, FIX_SCALE);\n    }\n\n    /// Multiply this uint192 by a uint, and output the result as a uint\n    /// @return x * y\n    // as-ints: x * y / 1e18\n    function mulu_toUint(\n        uint192 x,\n        uint256 y,\n        RoundingMode rounding\n    ) internal pure returns (uint256) {\n        return mulDiv256(uint256(x), y, FIX_SCALE, rounding);\n    }\n\n    /// Multiply this uint192 by a uint192 and output the result as a uint\n    /// @return x * y\n    // as-ints: x * y / 1e36\n    function mul_toUint(uint192 x, uint192 y) internal pure returns (uint256) {\n        return mulDiv256(uint256(x), uint256(y), FIX_SCALE_SQ);\n    }\n\n    /// Multiply this uint192 by a uint192 and output the result as a uint\n    /// @return x * y\n    // as-ints: x * y / 1e36\n    function mul_toUint(\n        uint192 x,\n        uint192 y,\n        RoundingMode rounding\n    ) internal pure returns (uint256) {\n        return mulDiv256(uint256(x), uint256(y), FIX_SCALE_SQ, rounding);\n    }\n\n    /// Compute x * y / z avoiding intermediate overflow\n    /// @dev Only use if you need to avoid overflow; costlier than x * y / z\n    /// @return x * y / z\n    // as-ints: x * y / z\n    function muluDivu(\n        uint192 x,\n        uint256 y,\n        uint256 z\n    ) internal pure returns (uint192) {\n        return muluDivu(x, y, z, FLOOR);\n    }\n\n    /// Compute x * y / z, avoiding intermediate overflow\n    /// @dev Only use if you need to avoid overflow; costlier than x * y / z\n    /// @return x * y / z\n    // as-ints: x * y / z\n    function muluDivu(\n        uint192 x,\n        uint256 y,\n        uint256 z,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        return _safeWrap(mulDiv256(x, y, z, rounding));\n    }\n\n    /// Compute x * y / z on Fixes, avoiding intermediate overflow\n    /// @dev Only use if you need to avoid overflow; costlier than x * y / z\n    /// @return x * y / z\n    // as-ints: x * y / z\n    function mulDiv(\n        uint192 x,\n        uint192 y,\n        uint192 z\n    ) internal pure returns (uint192) {\n        return mulDiv(x, y, z, FLOOR);\n    }\n\n    /// Compute x * y / z on Fixes, avoiding intermediate overflow\n    /// @dev Only use if you need to avoid overflow; costlier than x * y / z\n    /// @return x * y / z\n    // as-ints: x * y / z\n    function mulDiv(\n        uint192 x,\n        uint192 y,\n        uint192 z,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        return _safeWrap(mulDiv256(x, y, z, rounding));\n    }\n\n    // === safe*() ===\n\n    /// Multiply two fixes, rounding up to FIX_MAX and down to 0\n    /// @param a First param to multiply\n    /// @param b Second param to multiply\n    function safeMul(\n        uint192 a,\n        uint192 b,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        // untestable:\n        //      a will never = 0 here because of the check in _price()\n        if (a == 0 || b == 0) return 0;\n        // untestable:\n        //      a = FIX_MAX iff b = 0\n        if (a == FIX_MAX || b == FIX_MAX) return FIX_MAX;\n\n        // return FIX_MAX instead of throwing overflow errors.\n        unchecked {\n            // p and mul *are* Fix values, so have 18 decimals (D18)\n            uint256 rawDelta = uint256(b) * a; // {D36} = {D18} * {D18}\n            // if we overflowed, then return FIX_MAX\n            if (rawDelta / b != a) return FIX_MAX;\n            uint256 shiftDelta = rawDelta;\n\n            // add in rounding\n            if (rounding == RoundingMode.ROUND) shiftDelta += (FIX_ONE / 2);\n            else if (rounding == RoundingMode.CEIL) shiftDelta += FIX_ONE - 1;\n\n            // untestable (here there be dragons):\n            // (below explanation is for the ROUND case, but it extends to the FLOOR/CEIL too)\n            //          A)  shiftDelta = rawDelta + (FIX_ONE / 2)\n            //      shiftDelta overflows if:\n            //          B)  shiftDelta = MAX_UINT256 - FIX_ONE/2 + 1\n            //              rawDelta + (FIX_ONE/2) = MAX_UINT256 - FIX_ONE/2 + 1\n            //              b * a = MAX_UINT256 - FIX_ONE + 1\n            //      therefore shiftDelta overflows if:\n            //          C)  b = (MAX_UINT256 - FIX_ONE + 1) / a\n            //      MAX_UINT256 ~= 1e77 , FIX_MAX ~= 6e57 (6e20 difference in magnitude)\n            //      a <= 1e21 (MAX_TARGET_AMT)\n            //      a must be between 1e19 & 1e20 in order for b in (C) to be uint192,\n            //      but a would have to be < 1e18 in order for (A) to overflow\n            if (shiftDelta < rawDelta) return FIX_MAX;\n\n            // return FIX_MAX if return result would truncate\n            if (shiftDelta / FIX_ONE > FIX_MAX) return FIX_MAX;\n\n            // return _div(rawDelta, FIX_ONE, rounding)\n            return uint192(shiftDelta / FIX_ONE); // {D18} = {D36} / {D18}\n        }\n    }\n\n    /// Divide two fixes, rounding up to FIX_MAX and down to 0\n    /// @param a Numerator\n    /// @param b Denominator\n    function safeDiv(\n        uint192 a,\n        uint192 b,\n        RoundingMode rounding\n    ) internal pure returns (uint192) {\n        if (a == 0) return 0;\n        if (b == 0) return FIX_MAX;\n\n        uint256 raw = _divrnd(FIX_ONE_256 * a, uint256(b), rounding);\n        if (raw >= FIX_MAX) return FIX_MAX;\n        return uint192(raw); // don't need _safeWrap\n    }\n\n    /// Multiplies two fixes and divide by a third\n    /// @param a First to multiply\n    /// @param b Second to multiply\n    /// @param c Denominator\n    function safeMulDiv(\n        uint192 a,\n        uint192 b,\n        uint192 c,\n        RoundingMode rounding\n    ) internal pure returns (uint192 result) {\n        if (a == 0 || b == 0) return 0;\n        if (a == FIX_MAX || b == FIX_MAX || c == 0) return FIX_MAX;\n\n        uint256 result_256;\n        unchecked {\n            (uint256 hi, uint256 lo) = fullMul(a, b);\n            if (hi >= c) return FIX_MAX;\n            uint256 mm = mulmod(a, b, c);\n            if (mm > lo) hi -= 1;\n            lo -= mm;\n            uint256 pow2 = c & (0 - c);\n\n            uint256 c_256 = uint256(c);\n            c_256 /= pow2;\n            lo /= pow2;\n            lo += hi * ((0 - pow2) / pow2 + 1);\n            uint256 r = 1;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            r *= 2 - c_256 * r;\n            result_256 = lo * r;\n\n            // Apply rounding\n            if (rounding == CEIL) {\n                if (mm != 0) result_256 += 1;\n            } else if (rounding == ROUND) {\n                if (mm > ((c - 1) / 2)) result_256 += 1; // intentional: use pre-divided c here\n            }\n        }\n\n        if (result_256 >= FIX_MAX) return FIX_MAX;\n        return uint192(result_256);\n    }\n}\n\n// ================ a couple pure-uint helpers================\n// as-ints comments are omitted here, because they're the same as @return statements, because\n// these are all pure uint functions\n\n/// Return (x*y/z), avoiding intermediate overflow.\n//  Adapted from sources:\n//    https://medium.com/coinmonks/4db014e080b1, https://medium.com/wicketh/afa55870a65\n//    and quite a few of the other excellent \"Mathemagic\" posts from https://medium.com/wicketh\n/// @dev Only use if you need to avoid overflow; costlier than x * y / z\n/// @return result x * y / z\nfunction mulDiv256(\n    uint256 x,\n    uint256 y,\n    uint256 z\n) pure returns (uint256 result) {\n    unchecked {\n        (uint256 hi, uint256 lo) = fullMul(x, y);\n        if (hi >= z) revert UIntOutOfBounds();\n        uint256 mm = mulmod(x, y, z);\n        if (mm > lo) hi -= 1;\n        lo -= mm;\n        uint256 pow2 = z & (0 - z);\n        z /= pow2;\n        lo /= pow2;\n        lo += hi * ((0 - pow2) / pow2 + 1);\n        uint256 r = 1;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        r *= 2 - z * r;\n        result = lo * r;\n    }\n}\n\n/// Return (x*y/z), avoiding intermediate overflow.\n/// @dev Only use if you need to avoid overflow; costlier than x * y / z\n/// @return x * y / z\nfunction mulDiv256(\n    uint256 x,\n    uint256 y,\n    uint256 z,\n    RoundingMode rounding\n) pure returns (uint256) {\n    uint256 result = mulDiv256(x, y, z);\n    if (rounding == FLOOR) return result;\n\n    uint256 mm = mulmod(x, y, z);\n    if (rounding == CEIL) {\n        if (mm != 0) result += 1;\n    } else {\n        if (mm > ((z - 1) / 2)) result += 1; // z should be z-1\n    }\n    return result;\n}\n\n/// Return (x*y) as a \"virtual uint512\" (lo, hi), representing (hi*2**256 + lo)\n///   Adapted from sources:\n///   https://medium.com/wicketh/27650fec525d, https://medium.com/coinmonks/4db014e080b1\n/// @dev Intended to be internal to this library\n/// @return hi (hi, lo) satisfies  hi*(2**256) + lo == x * y\n/// @return lo (paired with `hi`)\nfunction fullMul(uint256 x, uint256 y) pure returns (uint256 hi, uint256 lo) {\n    unchecked {\n        uint256 mm = mulmod(x, y, uint256(0) - uint256(1));\n        lo = x * y;\n        hi = mm - lo;\n        if (mm < lo) hi -= 1;\n    }\n}\n\n// =============== from prbMath at commit 28055f6cd9a2367f9ad7ab6c8e01c9ac8e9acc61 ===============\n/// @notice Calculates the square root of x using the Babylonian method.\n///\n/// @dev See https://en.wikipedia.org/wiki/Methods_of_computing_square_roots#Babylonian_method.\n///\n/// Notes:\n/// - If x is not a perfect square, the result is rounded down.\n/// - Credits to OpenZeppelin for the explanations in comments below.\n///\n/// @param x The uint256 number for which to calculate the square root.\n/// @return result The result as a uint256.\nfunction sqrt256(uint256 x) pure returns (uint256 result) {\n    if (x == 0) {\n        return 0;\n    }\n\n    // For our first guess, we calculate the biggest power of 2 which is smaller than the square root of x.\n    //\n    // We know that the \"msb\" (most significant bit) of x is a power of 2 such that we have:\n    //\n    // $$\n    // msb(x) <= x <= 2*msb(x)$\n    // $$\n    //\n    // We write $msb(x)$ as $2^k$, and we get:\n    //\n    // $$\n    // k = log_2(x)\n    // $$\n    //\n    // Thus, we can write the initial inequality as:\n    //\n    // $$\n    // 2^{log_2(x)} <= x <= 2*2^{log_2(x)+1} \\\\\n    // sqrt(2^k) <= sqrt(x) < sqrt(2^{k+1}) \\\\\n    // 2^{k/2} <= sqrt(x) < 2^{(k+1)/2} <= 2^{(k/2)+1}\n    // $$\n    //\n    // Consequently, $2^{log_2(x) /2} is a good first approximation of sqrt(x) with at least one correct bit.\n    uint256 xAux = uint256(x);\n    result = 1;\n    if (xAux >= 2**128) {\n        xAux >>= 128;\n        result <<= 64;\n    }\n    if (xAux >= 2**64) {\n        xAux >>= 64;\n        result <<= 32;\n    }\n    if (xAux >= 2**32) {\n        xAux >>= 32;\n        result <<= 16;\n    }\n    if (xAux >= 2**16) {\n        xAux >>= 16;\n        result <<= 8;\n    }\n    if (xAux >= 2**8) {\n        xAux >>= 8;\n        result <<= 4;\n    }\n    if (xAux >= 2**4) {\n        xAux >>= 4;\n        result <<= 2;\n    }\n    if (xAux >= 2**2) {\n        result <<= 1;\n    }\n\n    // At this point, `result` is an estimation with at least one bit of precision. We know the true value has at\n    // most 128 bits, since it is the square root of a uint256. Newton's method converges quadratically (precision\n    // doubles at every iteration). We thus need at most 7 iteration to turn our partial result with one bit of\n    // precision into the expected uint128 result.\n    unchecked {\n        result = (result + x / result) >> 1;\n        result = (result + x / result) >> 1;\n        result = (result + x / result) >> 1;\n        result = (result + x / result) >> 1;\n        result = (result + x / result) >> 1;\n        result = (result + x / result) >> 1;\n        result = (result + x / result) >> 1;\n\n        // If x is not a perfect square, round the result toward zero.\n        uint256 roundedResult = x / result;\n        if (result >= roundedResult) {\n            result = roundedResult;\n        }\n    }\n}\n// slither-disable-end divide-before-multiply\n"},{"file_path":"@openzeppelin/contracts-upgradeable/interfaces/draft-IERC1822Upgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified\n * proxy whose upgrades are fully controlled by the current implementation.\n */\ninterface IERC1822ProxiableUpgradeable {\n    /**\n     * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation\n     * address.\n     *\n     * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks\n     * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this\n     * function revert if invoked through a proxy.\n     */\n    function proxiableUUID() external view returns (bytes32);\n}\n"},{"file_path":"@openzeppelin/contracts/utils/introspection/ERC165.sol","source_code":"// 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"},{"file_path":"@openzeppelin/contracts/utils/Strings.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/Math.sol\";\nimport \"./math/SignedMath.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary Strings {\n    bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n    uint8 private constant _ADDRESS_LENGTH = 20;\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        unchecked {\n            uint256 length = Math.log10(value) + 1;\n            string memory buffer = new string(length);\n            uint256 ptr;\n            /// @solidity memory-safe-assembly\n            assembly {\n                ptr := add(buffer, add(32, length))\n            }\n            while (true) {\n                ptr--;\n                /// @solidity memory-safe-assembly\n                assembly {\n                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n                }\n                value /= 10;\n                if (value == 0) break;\n            }\n            return buffer;\n        }\n    }\n\n    /**\n     * @dev Converts a `int256` to its ASCII `string` decimal representation.\n     */\n    function toString(int256 value) internal pure returns (string memory) {\n        return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMath.abs(value))));\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        unchecked {\n            return toHexString(value, Math.log256(value) + 1);\n        }\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] = _SYMBOLS[value & 0xf];\n            value >>= 4;\n        }\n        require(value == 0, \"Strings: hex length insufficient\");\n        return string(buffer);\n    }\n\n    /**\n     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n     */\n    function toHexString(address addr) internal pure returns (string memory) {\n        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n    }\n\n    /**\n     * @dev Returns true if the two strings are equal.\n     */\n    function equal(string memory a, string memory b) internal pure returns (bool) {\n        return keccak256(bytes(a)) == keccak256(bytes(b));\n    }\n}\n"},{"file_path":"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol","source_code":"// 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"},{"file_path":"contracts/interfaces/ITrade.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport \"./IBroker.sol\";\nimport \"./IVersioned.sol\";\n\nenum TradeStatus {\n    NOT_STARTED, // before init()\n    OPEN, // after init() and before settle()\n    CLOSED, // after settle()\n    // === Intermediate-tx state ===\n    PENDING // during init() or settle() (reentrancy protection)\n}\n\n/**\n * Simple generalized trading interface for all Trade contracts to obey\n *\n * Usage: if (canSettle()) settle()\n */\ninterface ITrade is IVersioned {\n    /// Complete the trade and transfer tokens back to the origin trader\n    /// @return soldAmt {qSellTok} The quantity of tokens sold\n    /// @return boughtAmt {qBuyTok} The quantity of tokens bought\n    function settle() external returns (uint256 soldAmt, uint256 boughtAmt);\n\n    function sell() external view returns (IERC20Metadata);\n\n    function buy() external view returns (IERC20Metadata);\n\n    /// @return {tok} The sell amount of the trade, in whole tokens\n    function sellAmount() external view returns (uint192);\n\n    /// @return The timestamp at which the trade is projected to become settle-able\n    function endTime() external view returns (uint48);\n\n    /// @return True if the trade can be settled\n    /// @dev Should be guaranteed to be true eventually as an invariant\n    function canSettle() external view returns (bool);\n\n    /// @return TradeKind.DUTCH_AUCTION or TradeKind.BATCH_AUCTION\n    // solhint-disable-next-line func-name-mixedcase\n    function KIND() external view returns (TradeKind);\n}\n"},{"file_path":"@openzeppelin/contracts/interfaces/IERC1271.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC1271 standard signature validation method for\n * contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].\n *\n * _Available since v4.1._\n */\ninterface IERC1271 {\n    /**\n     * @dev Should return whether the signature provided is valid for the provided data\n     * @param hash      Hash of the data to be signed\n     * @param signature Signature byte array associated with _data\n     */\n    function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);\n}\n"},{"file_path":"@openzeppelin/contracts/access/AccessControlEnumerable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (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 virtual 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 virtual 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"},{"file_path":"contracts/registry/DAOFeeRegistry.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport { RoleRegistry } from \"./RoleRegistry.sol\";\n\nuint256 constant MAX_FEE_NUMERATOR = 15_00; // Max DAO Fee: 15%\nuint256 constant FEE_DENOMINATOR = 100_00;\n\ncontract DAOFeeRegistry {\n    RoleRegistry public roleRegistry;\n\n    address private feeRecipient;\n    uint256 private defaultFeeNumerator; // 0%\n\n    mapping(address => uint256) private rTokenFeeNumerator;\n    mapping(address => bool) private rTokenFeeSet;\n\n    error DAOFeeRegistry__FeeRecipientAlreadySet();\n    error DAOFeeRegistry__InvalidFeeRecipient();\n    error DAOFeeRegistry__InvalidFeeNumerator();\n    error DAOFeeRegistry__InvalidRoleRegistry();\n    error DAOFeeRegistry__InvalidCaller();\n\n    event FeeRecipientSet(address indexed feeRecipient);\n    event DefaultFeeNumeratorSet(uint256 defaultFeeNumerator);\n    event RTokenFeeNumeratorSet(address indexed rToken, uint256 feeNumerator, bool isActive);\n\n    modifier onlyOwner() {\n        if (!roleRegistry.isOwner(msg.sender)) {\n            revert DAOFeeRegistry__InvalidCaller();\n        }\n        _;\n    }\n\n    constructor(RoleRegistry _roleRegistry, address _feeRecipient) {\n        if (address(_roleRegistry) == address(0)) {\n            revert DAOFeeRegistry__InvalidRoleRegistry();\n        }\n\n        roleRegistry = _roleRegistry;\n        feeRecipient = _feeRecipient;\n    }\n\n    function setFeeRecipient(address feeRecipient_) external onlyOwner {\n        if (feeRecipient_ == address(0)) {\n            revert DAOFeeRegistry__InvalidFeeRecipient();\n        }\n        if (feeRecipient_ == feeRecipient) {\n            revert DAOFeeRegistry__FeeRecipientAlreadySet();\n        }\n\n        feeRecipient = feeRecipient_;\n        emit FeeRecipientSet(feeRecipient_);\n    }\n\n    function setDefaultFeeNumerator(uint256 feeNumerator_) external onlyOwner {\n        if (feeNumerator_ > MAX_FEE_NUMERATOR) {\n            revert DAOFeeRegistry__InvalidFeeNumerator();\n        }\n\n        defaultFeeNumerator = feeNumerator_;\n        emit DefaultFeeNumeratorSet(defaultFeeNumerator);\n    }\n\n    /// @dev A fee below 1% not recommended due to poor precision in the Distributor\n    function setRTokenFeeNumerator(address rToken, uint256 feeNumerator_) external onlyOwner {\n        if (feeNumerator_ > MAX_FEE_NUMERATOR) {\n            revert DAOFeeRegistry__InvalidFeeNumerator();\n        }\n\n        rTokenFeeNumerator[rToken] = feeNumerator_;\n        rTokenFeeSet[rToken] = true;\n        emit RTokenFeeNumeratorSet(rToken, feeNumerator_, true);\n    }\n\n    function resetRTokenFee(address rToken) external onlyOwner {\n        rTokenFeeNumerator[rToken] = 0;\n        rTokenFeeSet[rToken] = false;\n\n        emit RTokenFeeNumeratorSet(rToken, 0, false);\n    }\n\n    function getFeeDetails(address rToken)\n        external\n        view\n        returns (\n            address recipient,\n            uint256 feeNumerator,\n            uint256 feeDenominator\n        )\n    {\n        recipient = feeRecipient;\n        feeNumerator = rTokenFeeSet[rToken] ? rTokenFeeNumerator[rToken] : defaultFeeNumerator;\n        feeDenominator = FEE_DENOMINATOR;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts/access/IAccessControlEnumerable.sol","source_code":"// 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"},{"file_path":"contracts/registry/RoleRegistry.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\n// solhint-disable-next-line max-line-length\nimport { AccessControlEnumerable } from \"@openzeppelin/contracts/access/AccessControlEnumerable.sol\";\n\n/**\n * @title RoleRegistry\n * @notice Contract to manage roles for RToken <> DAO interactions\n */\ncontract RoleRegistry is AccessControlEnumerable {\n    bytes32 public constant EMERGENCY_COUNCIL = keccak256(\"EMERGENCY_COUNCIL\");\n\n    constructor() {\n        _setupRole(DEFAULT_ADMIN_ROLE, msg.sender);\n    }\n\n    function isOwner(address account) public view returns (bool) {\n        return hasRole(DEFAULT_ADMIN_ROLE, account);\n    }\n\n    function isEmergencyCouncil(address account) public view returns (bool) {\n        return hasRole(EMERGENCY_COUNCIL, account);\n    }\n\n    function isOwnerOrEmergencyCouncil(address account) public view returns (bool) {\n        return hasRole(DEFAULT_ADMIN_ROLE, account) || hasRole(EMERGENCY_COUNCIL, account);\n    }\n}\n"},{"file_path":"contracts/interfaces/IBroker.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport \"@reserve-protocol/trusted-fillers/contracts/interfaces/ITrustedFillerRegistry.sol\";\nimport \"./IAsset.sol\";\nimport \"./IComponent.sol\";\nimport \"./IGnosis.sol\";\nimport \"./ITrade.sol\";\n\nenum TradeKind {\n    DUTCH_AUCTION,\n    BATCH_AUCTION\n}\n\n/// Cache of all prices for a pair to prevent re-lookup\nstruct TradePrices {\n    uint192 sellLow; // {UoA/sellTok} can be 0\n    uint192 sellHigh; // {UoA/sellTok} should not be 0\n    uint192 buyLow; // {UoA/buyTok} should not be 0\n    uint192 buyHigh; // {UoA/buyTok} should not be 0 or FIX_MAX\n}\n\n/// The data format that describes a request for trade with the Broker\nstruct TradeRequest {\n    IAsset sell;\n    IAsset buy;\n    uint256 sellAmount; // {qSellTok}\n    uint256 minBuyAmount; // {qBuyTok}\n}\n\n/**\n * @title IBroker\n * @notice The Broker deploys oneshot Trade contracts for Traders and monitors\n *   the continued proper functioning of trading platforms.\n */\ninterface IBroker is IComponent {\n    event BatchTradeImplementationSet(ITrade oldVal, ITrade newVal);\n    event DutchTradeImplementationSet(ITrade oldVal, ITrade newVal);\n    event BatchAuctionLengthSet(uint48 oldVal, uint48 newVal);\n    event DutchAuctionLengthSet(uint48 oldVal, uint48 newVal);\n    event BatchTradeDisabledSet(bool prevVal, bool newVal);\n    event DutchTradeDisabledSet(IERC20Metadata indexed erc20, bool prevVal, bool newVal);\n    event TrustedFillerRegistrySet(address trustedFillerRegistry, bool isEnabled);\n\n    // Initialization\n    function init(\n        IMain main_,\n        ITrade batchTradeImplemention_,\n        uint48 batchAuctionLength_,\n        ITrade dutchTradeImplemention_,\n        uint48 dutchAuctionLength_\n    ) external;\n\n    /// Request a trade from the broker\n    /// @dev Requires setting an allowance in advance\n    /// @custom:interaction\n    function openTrade(\n        TradeKind kind,\n        TradeRequest memory req,\n        TradePrices memory prices\n    ) external returns (ITrade);\n\n    /// Only callable by one of the trading contracts the broker deploys\n    function reportViolation() external;\n\n    function batchTradeDisabled() external view returns (bool);\n\n    function dutchTradeDisabled(IERC20Metadata erc20) external view returns (bool);\n}\n\ninterface IExtendedBroker is IBroker {\n    function setBatchTradeImplementation(ITrade newTradeImplementation) external;\n\n    function setDutchTradeImplementation(ITrade newTradeImplementation) external;\n\n    function setTrustedFillerRegistry(address newRegistry, bool enabled) external;\n\n    function trustedFillerRegistry() external view returns (ITrustedFillerRegistry);\n\n    function trustedFillerEnabled() external view returns (bool);\n}\n\ninterface TestIBroker is IBroker {\n    function gnosis() external view returns (IGnosis);\n\n    function batchTradeImplementation() external view returns (ITrade);\n\n    function dutchTradeImplementation() external view returns (ITrade);\n\n    function batchAuctionLength() external view returns (uint48);\n\n    function dutchAuctionLength() external view returns (uint48);\n\n    function setBatchTradeImplementation(ITrade newTradeImplementation) external;\n\n    function setBatchAuctionLength(uint48 newAuctionLength) external;\n\n    function setDutchTradeImplementation(ITrade newTradeImplementation) external;\n\n    function setDutchAuctionLength(uint48 newAuctionLength) external;\n\n    function enableBatchTrade() external;\n\n    function enableDutchTrade(IERC20Metadata erc20) external;\n\n    // only present on pre-3.0.0 Brokers; used by EasyAuction regression test\n    function disabled() external view returns (bool);\n\n    function setTrustedFillerRegistry(address newRegistry, bool enabled) external;\n\n    function trustedFillerRegistry() external view returns (ITrustedFillerRegistry);\n\n    function trustedFillerEnabled() external view returns (bool);\n}\n"},{"file_path":"@openzeppelin/contracts/utils/Context.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (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    function _contextSuffixLength() internal view virtual returns (uint256) {\n        return 0;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/draft-IERC20PermitUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/extensions/draft-IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n// EIP-2612 is Final as of 2022-11-01. This file is deprecated.\n\nimport \"./IERC20PermitUpgradeable.sol\";\n"},{"file_path":"@openzeppelin/contracts/token/ERC20/IERC20.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (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 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    /**\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 `to`.\n     *\n     * Returns a boolean value indicating whether the operation succeeded.\n     *\n     * Emits a {Transfer} event.\n     */\n    function transfer(address to, 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 `from` to `to` 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(address from, address to, uint256 amount) external returns (bool);\n}\n"},{"file_path":"@openzeppelin/contracts/utils/math/SignedMath.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Standard signed math utilities missing in the Solidity language.\n */\nlibrary SignedMath {\n    /**\n     * @dev Returns the largest of two signed numbers.\n     */\n    function max(int256 a, int256 b) internal pure returns (int256) {\n        return a > b ? a : b;\n    }\n\n    /**\n     * @dev Returns the smallest of two signed numbers.\n     */\n    function min(int256 a, int256 b) internal pure returns (int256) {\n        return a < b ? a : b;\n    }\n\n    /**\n     * @dev Returns the average of two signed numbers without overflow.\n     * The result is rounded towards zero.\n     */\n    function average(int256 a, int256 b) internal pure returns (int256) {\n        // Formula from the book \"Hacker's Delight\"\n        int256 x = (a & b) + ((a ^ b) >> 1);\n        return x + (int256(uint256(x) >> 255) & (a ^ b));\n    }\n\n    /**\n     * @dev Returns the absolute unsigned value of a signed value.\n     */\n    function abs(int256 n) internal pure returns (uint256) {\n        unchecked {\n            // must be unchecked in order to support `n = type(int256).min`\n            return uint256(n >= 0 ? n : -n);\n        }\n    }\n}\n"},{"file_path":"contracts/interfaces/IGnosis.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\nstruct GnosisAuctionData {\n    IERC20 auctioningToken;\n    IERC20 biddingToken;\n    uint256 orderCancellationEndDate;\n    uint256 auctionEndDate;\n    bytes32 initialAuctionOrder;\n    uint256 minimumBiddingAmountPerOrder;\n    uint256 interimSumBidAmount;\n    bytes32 interimOrder;\n    bytes32 clearingPriceOrder;\n    uint96 volumeClearingPriceOrder;\n    bool minFundingThresholdNotReached;\n    bool isAtomicClosureAllowed;\n    uint256 feeNumerator;\n    uint256 minFundingThreshold;\n}\n\n/// The relevant portion of the interface of the live Gnosis EasyAuction contract\n/// https://github.com/gnosis/ido-contracts/blob/main/contracts/EasyAuction.sol\ninterface IGnosis {\n    function initiateAuction(\n        IERC20 auctioningToken,\n        IERC20 biddingToken,\n        uint256 orderCancellationEndDate,\n        uint256 auctionEndDate,\n        uint96 auctionedSellAmount,\n        uint96 minBuyAmount,\n        uint256 minimumBiddingAmountPerOrder,\n        uint256 minFundingThreshold,\n        bool isAtomicClosureAllowed,\n        address accessManagerContract,\n        bytes memory accessManagerContractData\n    ) external returns (uint256 auctionId);\n\n    function auctionData(uint256 auctionId) external view returns (GnosisAuctionData memory);\n\n    /// @param auctionId The external auction id\n    /// @dev See here for decoding: https://git.io/JMang\n    /// @return encodedOrder The order, encoded in a bytes 32\n    function settleAuction(uint256 auctionId) external returns (bytes32 encodedOrder);\n\n    /// @return The numerator over a 1000-valued denominator\n    function feeNumerator() external returns (uint256);\n}\n"},{"file_path":"contracts/interfaces/IDeployer.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\";\nimport \"../libraries/Throttle.sol\";\nimport \"./IAsset.sol\";\nimport \"./IDistributor.sol\";\nimport \"./IGnosis.sol\";\nimport \"./IMain.sol\";\nimport \"./IRToken.sol\";\nimport \"./IStRSR.sol\";\nimport \"./ITrade.sol\";\nimport \"./IVersioned.sol\";\n\nimport \"../registry/VersionRegistry.sol\";\nimport \"../registry/AssetPluginRegistry.sol\";\nimport \"../registry/DAOFeeRegistry.sol\";\nimport \"@reserve-protocol/trusted-fillers/contracts/interfaces/ITrustedFillerRegistry.sol\";\n\n/**\n * @title DeploymentParams\n * @notice The set of protocol params needed to configure a new system deployment.\n * meaning that after deployment there is freedom to allow parametrizations to deviate.\n */\nstruct DeploymentParams {\n    // === Revenue sharing ===\n    RevenueShare dist; // revenue sharing splits between RToken and RSR\n    //\n    // === Trade sizing ===\n    uint192 minTradeVolume; // {UoA}\n    uint192 rTokenMaxTradeVolume; // {UoA}\n    //\n    // === Freezing ===\n    uint48 shortFreeze; // {s} how long an initial freeze lasts\n    uint48 longFreeze; // {s} how long each freeze extension lasts\n    //\n    // === Rewards (Furnace + StRSR) ===\n    uint192 rewardRatio; // the fraction of available revenues that are paid out each block period\n    //\n    // === StRSR ===\n    uint48 unstakingDelay; // {s} the \"thawing time\" of staked RSR before withdrawal\n    uint192 withdrawalLeak; // {1} fraction of RSR that can be withdrawn without refresh\n    //\n    // === BasketHandler ===\n    uint48 warmupPeriod; // {s} how long to wait until issuance/trading after regaining SOUND\n    bool reweightable; // whether the target amounts in the prime basket can change\n    bool enableIssuancePremium; // whether to enable the issuance premium\n    //\n    // === BackingManager ===\n    uint48 tradingDelay; // {s} how long to wait until starting auctions after switching basket\n    uint48 batchAuctionLength; // {s} the length of a Gnosis EasyAuction\n    uint48 dutchAuctionLength; // {s} the length of a falling-price dutch auction\n    uint192 backingBuffer; // {1} how much extra backing collateral to keep\n    uint192 maxTradeSlippage; // {1} max slippage acceptable in a trade\n    //\n    // === RToken Supply Throttles ===\n    ThrottleLib.Params issuanceThrottle; // see ThrottleLib\n    ThrottleLib.Params redemptionThrottle;\n}\n\n/**\n * @title Implementations\n * @notice The set of implementation contracts to be used for proxies in the Deployer\n */\nstruct Implementations {\n    IMain main;\n    Components components;\n    TradePlugins trading;\n}\n\nstruct TradePlugins {\n    ITrade gnosisTrade;\n    ITrade dutchTrade;\n}\n\n/**\n * @title IDeployer\n * @notice Factory contract for an RToken system instance\n */\ninterface IDeployer is IVersioned {\n    /// Emitted when a new RToken and accompanying system is deployed\n    /// @param main The address of `Main`\n    /// @param rToken The address of the RToken ERC20\n    /// @param stRSR The address of the StRSR ERC20 staking pool/token\n    /// @param owner The owner of the newly deployed system\n    /// @param version The semantic versioning version string (see: https://semver.org)\n    event RTokenCreated(\n        IMain indexed main,\n        IRToken indexed rToken,\n        IStRSR stRSR,\n        address indexed owner,\n        string version\n    );\n\n    /// Emitted when a new RTokenAsset is deployed during `deployRTokenAsset`\n    /// @param rToken The address of the RToken ERC20\n    /// @param rTokenAsset The address of the RTokenAsset\n    event RTokenAssetCreated(IRToken indexed rToken, IAsset rTokenAsset);\n\n    struct Registries {\n        VersionRegistry versionRegistry;\n        AssetPluginRegistry assetPluginRegistry;\n        DAOFeeRegistry daoFeeRegistry;\n        ITrustedFillerRegistry trustedFillerRegistry;\n    }\n\n    /// Deploys an instance of the entire system\n    /// @param name The name of the RToken to deploy\n    /// @param symbol The symbol of the RToken to deploy\n    /// @param mandate An IPFS link or direct string; describes what the RToken _should be_\n    /// @param owner The address that should own the entire system, hopefully a governance contract\n    /// @param params Deployment params\n    /// @param registries Registries list; can be 0 to unset\n    /// @return The address of the newly deployed Main instance.\n    function deploy(\n        string calldata name,\n        string calldata symbol,\n        string calldata mandate,\n        address owner,\n        DeploymentParams calldata params,\n        Registries calldata registries\n    ) external returns (address);\n\n    function implementations() external view returns (Implementations memory);\n}\n"},{"file_path":"contracts/p1/mixins/GlobalReentrancyGuard.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\n// solhint-disable-next-line max-line-length\n// Based on OpenZeppelin Upgradeable Contracts (last updated v5.1.0) (utils/ReentrancyGuardUpgradeable.sol)\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module that helps prevent global reentrant calls.\n *\n * Inheriting from `GlobalReentrancyGuard` will allow to implement a global lock\n * and allow other contracts to define the {globalNonReentrant} modifier,\n * which can be applied to functions to make sure there are no nested (reentrant)\n * calls among them.\n *\n */\nabstract contract GlobalReentrancyGuard is Initializable {\n    // Booleans are more expensive than uint256 or any type that takes up a full\n    // word because each write operation emits an extra SLOAD to first read the\n    // slot's contents, replace the bits taken up by the boolean, and then write\n    // back. This is the compiler's defense against contract upgrades and\n    // pointer aliasing, and it cannot be disabled.\n\n    // The values being non-zero value makes deployment a bit more expensive,\n    // but in exchange the refund on every call to nonReentrant will be lower in\n    // amount. Since refunds are capped to a percentage of the total\n    // transaction's gas, it is best to keep them low in cases like this one, to\n    // increase the likelihood of the full refund coming into effect.\n    uint256 private constant NOT_ENTERED = 1;\n    uint256 private constant ENTERED = 2;\n\n    /// @custom:storage-location erc7201:openzeppelin.storage.ReentrancyGuard\n    struct ReentrancyGuardStorage {\n        uint256 _status;\n    }\n\n    // solhint-disable-next-line max-line-length\n    // keccak256(abi.encode(uint256(keccak256(\"openzeppelin.storage.ReentrancyGuard\")) - 1)) & ~bytes32(uint256(0xff))\n    bytes32 private constant ReentrancyGuardStorageLocation =\n        0x9b779b17422d0df92223018b32b4d1fa46e071723d6817e2486d003becc55f00;\n\n    function _getReentrancyGuardStorage() private pure returns (ReentrancyGuardStorage storage $) {\n        assembly {\n            $.slot := ReentrancyGuardStorageLocation\n        }\n    }\n\n    /**\n     * @dev Unauthorized reentrant call.\n     */\n    error ReentrancyGuardReentrantCall();\n\n    function __ReentrancyGuard_init() internal onlyInitializing {\n        __ReentrancyGuard_init_unchained();\n    }\n\n    function __ReentrancyGuard_init_unchained() internal onlyInitializing {\n        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();\n        $._status = NOT_ENTERED;\n    }\n\n    function _nonReentrantBefore() internal {\n        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();\n        // On the first call to nonReentrant, _status will be NOT_ENTERED\n        if ($._status == ENTERED) {\n            revert ReentrancyGuardReentrantCall();\n        }\n\n        // Any calls to nonReentrant after this point will fail\n        $._status = ENTERED;\n    }\n\n    function _nonReentrantAfter() internal {\n        ReentrancyGuardStorage storage $ = _getReentrancyGuardStorage();\n        // By storing the original value once again, a refund is triggered (see\n        // https://eips.ethereum.org/EIPS/eip-2200)\n        $._status = NOT_ENTERED;\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./math/MathUpgradeable.sol\";\nimport \"./math/SignedMathUpgradeable.sol\";\n\n/**\n * @dev String operations.\n */\nlibrary StringsUpgradeable {\n    bytes16 private constant _SYMBOLS = \"0123456789abcdef\";\n    uint8 private constant _ADDRESS_LENGTH = 20;\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        unchecked {\n            uint256 length = MathUpgradeable.log10(value) + 1;\n            string memory buffer = new string(length);\n            uint256 ptr;\n            /// @solidity memory-safe-assembly\n            assembly {\n                ptr := add(buffer, add(32, length))\n            }\n            while (true) {\n                ptr--;\n                /// @solidity memory-safe-assembly\n                assembly {\n                    mstore8(ptr, byte(mod(value, 10), _SYMBOLS))\n                }\n                value /= 10;\n                if (value == 0) break;\n            }\n            return buffer;\n        }\n    }\n\n    /**\n     * @dev Converts a `int256` to its ASCII `string` decimal representation.\n     */\n    function toString(int256 value) internal pure returns (string memory) {\n        return string(abi.encodePacked(value < 0 ? \"-\" : \"\", toString(SignedMathUpgradeable.abs(value))));\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        unchecked {\n            return toHexString(value, MathUpgradeable.log256(value) + 1);\n        }\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] = _SYMBOLS[value & 0xf];\n            value >>= 4;\n        }\n        require(value == 0, \"Strings: hex length insufficient\");\n        return string(buffer);\n    }\n\n    /**\n     * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.\n     */\n    function toHexString(address addr) internal pure returns (string memory) {\n        return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);\n    }\n\n    /**\n     * @dev Returns true if the two strings are equal.\n     */\n    function equal(string memory a, string memory b) internal pure returns (bool) {\n        return keccak256(bytes(a)) == keccak256(bytes(b));\n    }\n}\n"},{"file_path":"@openzeppelin/contracts/access/AccessControl.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (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 * ```solidity\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 * ```solidity\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. We recommend using {AccessControlDefaultAdminRules}\n * to enforce additional security measures for this role.\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);\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 virtual override returns (bool) {\n        return _roles[role].members[account];\n    }\n\n    /**\n     * @dev Revert with a standard message if `_msgSender()` is missing `role`.\n     * Overriding this function changes the behavior of the {onlyRole} modifier.\n     *\n     * Format of the revert message is described in {_checkRole}.\n     *\n     * _Available since v4.6._\n     */\n    function _checkRole(bytes32 role) internal view virtual {\n        _checkRole(role, _msgSender());\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 virtual {\n        if (!hasRole(role, account)) {\n            revert(\n                string(\n                    abi.encodePacked(\n                        \"AccessControl: account \",\n                        Strings.toHexString(account),\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 virtual 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     * May emit a {RoleGranted} event.\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     * May emit a {RoleRevoked} event.\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     * May emit a {RoleRevoked} event.\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     * May emit a {RoleGranted} event.\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     * May emit a {RoleGranted} event.\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     * May emit a {RoleRevoked} event.\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"},{"file_path":"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)\n\npragma solidity ^0.8.2;\n\nimport \"../../utils/AddressUpgradeable.sol\";\n\n/**\n * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed\n * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an\n * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer\n * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.\n *\n * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be\n * reused. This mechanism prevents re-execution of each \"step\" but allows the creation of new initialization steps in\n * case an upgrade adds a module that needs to be initialized.\n *\n * For example:\n *\n * [.hljs-theme-light.nopadding]\n * ```solidity\n * contract MyToken is ERC20Upgradeable {\n *     function initialize() initializer public {\n *         __ERC20_init(\"MyToken\", \"MTK\");\n *     }\n * }\n *\n * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {\n *     function initializeV2() reinitializer(2) public {\n *         __ERC20Permit_init(\"MyToken\");\n *     }\n * }\n * ```\n *\n * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as\n * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.\n *\n * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure\n * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.\n *\n * [CAUTION]\n * ====\n * Avoid leaving a contract uninitialized.\n *\n * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation\n * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke\n * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:\n *\n * [.hljs-theme-light.nopadding]\n * ```\n * /// @custom:oz-upgrades-unsafe-allow constructor\n * constructor() {\n *     _disableInitializers();\n * }\n * ```\n * ====\n */\nabstract contract Initializable {\n    /**\n     * @dev Indicates that the contract has been initialized.\n     * @custom:oz-retyped-from bool\n     */\n    uint8 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 Triggered when the contract has been initialized or reinitialized.\n     */\n    event Initialized(uint8 version);\n\n    /**\n     * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,\n     * `onlyInitializing` functions can be used to initialize parent contracts.\n     *\n     * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a\n     * constructor.\n     *\n     * Emits an {Initialized} event.\n     */\n    modifier initializer() {\n        bool isTopLevelCall = !_initializing;\n        require(\n            (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),\n            \"Initializable: contract is already initialized\"\n        );\n        _initialized = 1;\n        if (isTopLevelCall) {\n            _initializing = true;\n        }\n        _;\n        if (isTopLevelCall) {\n            _initializing = false;\n            emit Initialized(1);\n        }\n    }\n\n    /**\n     * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the\n     * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be\n     * used to initialize parent contracts.\n     *\n     * A reinitializer may be used after the original initialization step. This is essential to configure modules that\n     * are added through upgrades and that require initialization.\n     *\n     * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`\n     * cannot be nested. If one is invoked in the context of another, execution will revert.\n     *\n     * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in\n     * a contract, executing them in the right order is up to the developer or operator.\n     *\n     * WARNING: setting the version to 255 will prevent any future reinitialization.\n     *\n     * Emits an {Initialized} event.\n     */\n    modifier reinitializer(uint8 version) {\n        require(!_initializing && _initialized < version, \"Initializable: contract is already initialized\");\n        _initialized = version;\n        _initializing = true;\n        _;\n        _initializing = false;\n        emit Initialized(version);\n    }\n\n    /**\n     * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the\n     * {initializer} and {reinitializer} modifiers, directly or indirectly.\n     */\n    modifier onlyInitializing() {\n        require(_initializing, \"Initializable: contract is not initializing\");\n        _;\n    }\n\n    /**\n     * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.\n     * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized\n     * to any version. It is recommended to use this to lock implementation contracts that are designed to be called\n     * through proxies.\n     *\n     * Emits an {Initialized} event the first time it is successfully executed.\n     */\n    function _disableInitializers() internal virtual {\n        require(!_initializing, \"Initializable: contract is initializing\");\n        if (_initialized != type(uint8).max) {\n            _initialized = type(uint8).max;\n            emit Initialized(type(uint8).max);\n        }\n    }\n\n    /**\n     * @dev Returns the highest version that has been initialized. See {reinitializer}.\n     */\n    function _getInitializedVersion() internal view returns (uint8) {\n        return _initialized;\n    }\n\n    /**\n     * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.\n     */\n    function _isInitializing() internal view returns (bool) {\n        return _initializing;\n    }\n}\n"},{"file_path":"@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol","source_code":"// 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  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"},{"file_path":"@openzeppelin/contracts-upgradeable/token/ERC20/extensions/IERC20PermitUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in\n * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].\n *\n * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by\n * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't\n * need to send a transaction, and thus is not required to hold Ether at all.\n *\n * ==== Security Considerations\n *\n * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature\n * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be\n * considered as an intention to spend the allowance in any specific way. The second is that because permits have\n * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should\n * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be\n * generally recommended is:\n *\n * ```solidity\n * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {\n *     try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}\n *     doThing(..., value);\n * }\n *\n * function doThing(..., uint256 value) public {\n *     token.safeTransferFrom(msg.sender, address(this), value);\n *     ...\n * }\n * ```\n *\n * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of\n * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also\n * {SafeERC20-safeTransferFrom}).\n *\n * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so\n * contracts should have entry points that don't rely on permit.\n */\ninterface IERC20PermitUpgradeable {\n    /**\n     * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,\n     * given ``owner``'s signed approval.\n     *\n     * IMPORTANT: The same issues {IERC20-approve} has related to transaction\n     * ordering also apply here.\n     *\n     * Emits an {Approval} event.\n     *\n     * Requirements:\n     *\n     * - `spender` cannot be the zero address.\n     * - `deadline` must be a timestamp in the future.\n     * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`\n     * over the EIP712-formatted function arguments.\n     * - the signature must use ``owner``'s current nonce (see {nonces}).\n     *\n     * For more information on the signature format, see the\n     * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP\n     * section].\n     *\n     * CAUTION: See Security Considerations above.\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    /**\n     * @dev Returns the current nonce for `owner`. This value must be\n     * included whenever a signature is generated for {permit}.\n     *\n     * Every successful call to {permit} increases ``owner``'s nonce by one. This\n     * prevents a signature from being used multiple times.\n     */\n    function nonces(address owner) external view returns (uint256);\n\n    /**\n     * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.\n     */\n    // solhint-disable-next-line func-name-mixedcase\n    function DOMAIN_SEPARATOR() external view returns (bytes32);\n}\n"},{"file_path":"contracts/interfaces/IAssetRegistry.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"./IAsset.sol\";\nimport \"./IComponent.sol\";\n\n/// A serialization of the AssetRegistry to be passed around in the P1 impl for gas optimization\nstruct Registry {\n    IERC20[] erc20s;\n    IAsset[] assets;\n}\n\n/**\n * @title IAssetRegistry\n * @notice The AssetRegistry is in charge of maintaining the ERC20 tokens eligible\n *   to be handled by the rest of the system. If an asset is in the registry, this means:\n *      1. Its ERC20 contract has been vetted\n *      2. The asset is the only asset for that ERC20\n *      3. The asset can be priced in the UoA, usually via an oracle\n */\ninterface IAssetRegistry is IComponent {\n    /// Emitted when an asset is added to the registry\n    /// @param erc20 The ERC20 contract for the asset\n    /// @param asset The asset contract added to the registry\n    event AssetRegistered(IERC20 indexed erc20, IAsset indexed asset);\n\n    /// Emitted when an asset is removed from the registry\n    /// @param erc20 The ERC20 contract for the asset\n    /// @param asset The asset contract removed from the registry\n    event AssetUnregistered(IERC20 indexed erc20, IAsset indexed asset);\n\n    // Initialization\n    function init(IMain main_, IAsset[] memory assets_) external;\n\n    /// Fully refresh all asset state\n    /// @custom:refresher\n    function refresh() external;\n\n    /// Register a new JIT-deployed RTokenAsset instance\n    /// @param maxTradeVolume {UoA} The maximum trade volume for the RTokenAsset\n    /// @return swapped If the asset was swapped for a previously-registered asset\n    /// @custom:governance\n    function registerNewRTokenAsset(uint192 maxTradeVolume) external returns (bool swapped);\n\n    /// Register `asset`\n    /// If either the erc20 address or the asset was already registered, fail\n    /// @return true if the erc20 address was not already registered.\n    /// @custom:governance\n    function register(IAsset asset) external returns (bool);\n\n    /// Register `asset` if and only if its erc20 address is already registered.\n    /// If the erc20 address was not registered, revert.\n    /// @return swapped If the asset was swapped for a previously-registered asset\n    /// @custom:governance\n    function swapRegistered(IAsset asset) external returns (bool swapped);\n\n    /// Unregister an asset, requiring that it is already registered\n    /// @custom:governance\n    function unregister(IAsset asset) external;\n\n    /// @return {s} The timestamp of the last refresh\n    function lastRefresh() external view returns (uint48);\n\n    /// @return The corresponding asset for ERC20, or reverts if not registered\n    function toAsset(IERC20 erc20) external view returns (IAsset);\n\n    /// @return The corresponding collateral, or reverts if unregistered or not collateral\n    function toColl(IERC20 erc20) external view returns (ICollateral);\n\n    /// @return If the ERC20 is registered\n    function isRegistered(IERC20 erc20) external view returns (bool);\n\n    /// @return A list of all registered ERC20s\n    function erc20s() external view returns (IERC20[] memory);\n\n    /// @return reg The list of registered ERC20s and Assets, in the same order\n    function getRegistry() external view returns (Registry memory reg);\n\n    /// Validate that the current assets in the registry are compatible with the current version\n    function validateCurrentAssets() external view;\n\n    /// @return The number of registered ERC20s\n    function size() external view returns (uint256);\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/utils/introspection/IERC165Upgradeable.sol","source_code":"// 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 IERC165Upgradeable {\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"},{"file_path":"@openzeppelin/contracts/utils/math/Math.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (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    enum Rounding {\n        Down, // Toward negative infinity\n        Up, // Toward infinity\n        Zero // Toward zero\n    }\n\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 == 0 ? 0 : (a - 1) / b + 1;\n    }\n\n    /**\n     * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0\n     * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)\n     * with further edits by Uniswap Labs also under MIT license.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {\n        unchecked {\n            // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use\n            // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\n            // variables such that product = prod1 * 2^256 + prod0.\n            uint256 prod0; // Least significant 256 bits of the product\n            uint256 prod1; // Most significant 256 bits of the product\n            assembly {\n                let mm := mulmod(x, y, not(0))\n                prod0 := mul(x, y)\n                prod1 := sub(sub(mm, prod0), lt(mm, prod0))\n            }\n\n            // Handle non-overflow cases, 256 by 256 division.\n            if (prod1 == 0) {\n                // Solidity will revert if denominator == 0, unlike the div opcode on its own.\n                // The surrounding unchecked block does not change this fact.\n                // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.\n                return prod0 / denominator;\n            }\n\n            // Make sure the result is less than 2^256. Also prevents denominator == 0.\n            require(denominator > prod1, \"Math: mulDiv overflow\");\n\n            ///////////////////////////////////////////////\n            // 512 by 256 division.\n            ///////////////////////////////////////////////\n\n            // Make division exact by subtracting the remainder from [prod1 prod0].\n            uint256 remainder;\n            assembly {\n                // Compute remainder using mulmod.\n                remainder := mulmod(x, y, denominator)\n\n                // Subtract 256 bit number from 512 bit number.\n                prod1 := sub(prod1, gt(remainder, prod0))\n                prod0 := sub(prod0, remainder)\n            }\n\n            // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.\n            // See https://cs.stackexchange.com/q/138556/92363.\n\n            // Does not overflow because the denominator cannot be zero at this stage in the function.\n            uint256 twos = denominator & (~denominator + 1);\n            assembly {\n                // Divide denominator by twos.\n                denominator := div(denominator, twos)\n\n                // Divide [prod1 prod0] by twos.\n                prod0 := div(prod0, twos)\n\n                // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.\n                twos := add(div(sub(0, twos), twos), 1)\n            }\n\n            // Shift in bits from prod1 into prod0.\n            prod0 |= prod1 * twos;\n\n            // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such\n            // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for\n            // four bits. That is, denominator * inv = 1 mod 2^4.\n            uint256 inverse = (3 * denominator) ^ 2;\n\n            // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works\n            // in modular arithmetic, doubling the correct bits in each step.\n            inverse *= 2 - denominator * inverse; // inverse mod 2^8\n            inverse *= 2 - denominator * inverse; // inverse mod 2^16\n            inverse *= 2 - denominator * inverse; // inverse mod 2^32\n            inverse *= 2 - denominator * inverse; // inverse mod 2^64\n            inverse *= 2 - denominator * inverse; // inverse mod 2^128\n            inverse *= 2 - denominator * inverse; // inverse mod 2^256\n\n            // Because the division is now exact we can divide by multiplying with the modular inverse of denominator.\n            // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is\n            // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1\n            // is no longer required.\n            result = prod0 * inverse;\n            return result;\n        }\n    }\n\n    /**\n     * @notice Calculates x * y / denominator with full precision, following the selected rounding direction.\n     */\n    function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {\n        uint256 result = mulDiv(x, y, denominator);\n        if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {\n            result += 1;\n        }\n        return result;\n    }\n\n    /**\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.\n     *\n     * Inspired by Henry S. Warren, Jr.'s \"Hacker's Delight\" (Chapter 11).\n     */\n    function sqrt(uint256 a) internal pure returns (uint256) {\n        if (a == 0) {\n            return 0;\n        }\n\n        // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.\n        //\n        // We know that the \"msb\" (most significant bit) of our target number `a` is a power of 2 such that we have\n        // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.\n        //\n        // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`\n        // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`\n        // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`\n        //\n        // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.\n        uint256 result = 1 << (log2(a) >> 1);\n\n        // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,\n        // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at\n        // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision\n        // into the expected uint128 result.\n        unchecked {\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            result = (result + a / result) >> 1;\n            return min(result, a / result);\n        }\n    }\n\n    /**\n     * @notice Calculates sqrt(a), following the selected rounding direction.\n     */\n    function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = sqrt(a);\n            return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 2, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 128;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 64;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 32;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 16;\n            }\n            if (value >> 8 > 0) {\n                value >>= 8;\n                result += 8;\n            }\n            if (value >> 4 > 0) {\n                value >>= 4;\n                result += 4;\n            }\n            if (value >> 2 > 0) {\n                value >>= 2;\n                result += 2;\n            }\n            if (value >> 1 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 2, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log2(value);\n            return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 10, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >= 10 ** 64) {\n                value /= 10 ** 64;\n                result += 64;\n            }\n            if (value >= 10 ** 32) {\n                value /= 10 ** 32;\n                result += 32;\n            }\n            if (value >= 10 ** 16) {\n                value /= 10 ** 16;\n                result += 16;\n            }\n            if (value >= 10 ** 8) {\n                value /= 10 ** 8;\n                result += 8;\n            }\n            if (value >= 10 ** 4) {\n                value /= 10 ** 4;\n                result += 4;\n            }\n            if (value >= 10 ** 2) {\n                value /= 10 ** 2;\n                result += 2;\n            }\n            if (value >= 10 ** 1) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 10, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log10(value);\n            return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);\n        }\n    }\n\n    /**\n     * @dev Return the log in base 256, rounded down, of a positive value.\n     * Returns 0 if given 0.\n     *\n     * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.\n     */\n    function log256(uint256 value) internal pure returns (uint256) {\n        uint256 result = 0;\n        unchecked {\n            if (value >> 128 > 0) {\n                value >>= 128;\n                result += 16;\n            }\n            if (value >> 64 > 0) {\n                value >>= 64;\n                result += 8;\n            }\n            if (value >> 32 > 0) {\n                value >>= 32;\n                result += 4;\n            }\n            if (value >> 16 > 0) {\n                value >>= 16;\n                result += 2;\n            }\n            if (value >> 8 > 0) {\n                result += 1;\n            }\n        }\n        return result;\n    }\n\n    /**\n     * @dev Return the log in base 256, following the selected rounding direction, of a positive value.\n     * Returns 0 if given 0.\n     */\n    function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {\n        unchecked {\n            uint256 result = log256(value);\n            return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);\n        }\n    }\n}\n"},{"file_path":"contracts/interfaces/IComponent.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"./IMain.sol\";\nimport \"./IVersioned.sol\";\n\n/**\n * @title IComponent\n * @notice A Component is the central building block of all our system contracts. Components\n *   contain important state that must be migrated during upgrades, and they delegate\n *   their ownership to Main's owner.\n */\ninterface IComponent is IVersioned {\n    function main() external view returns (IMain);\n}\n"},{"file_path":"@openzeppelin/contracts/access/Ownable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../utils/Context.sol\";\n\n/**\n * @dev Contract module which provides a basic access control mechanism, where\n * there is an account (an owner) that can be granted exclusive access to\n * specific functions.\n *\n * By default, the owner account will be the one that deploys the contract. This\n * can later be changed with {transferOwnership}.\n *\n * This module is used through inheritance. It will make available the modifier\n * `onlyOwner`, which can be applied to your functions to restrict their use to\n * the owner.\n */\nabstract contract Ownable is Context {\n    address private _owner;\n\n    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);\n\n    /**\n     * @dev Initializes the contract setting the deployer as the initial owner.\n     */\n    constructor() {\n        _transferOwnership(_msgSender());\n    }\n\n    /**\n     * @dev Throws if called by any account other than the owner.\n     */\n    modifier onlyOwner() {\n        _checkOwner();\n        _;\n    }\n\n    /**\n     * @dev Returns the address of the current owner.\n     */\n    function owner() public view virtual returns (address) {\n        return _owner;\n    }\n\n    /**\n     * @dev Throws if the sender is not the owner.\n     */\n    function _checkOwner() internal view virtual {\n        require(owner() == _msgSender(), \"Ownable: caller is not the owner\");\n    }\n\n    /**\n     * @dev Leaves the contract without owner. It will not be possible to call\n     * `onlyOwner` functions. Can only be called by the current owner.\n     *\n     * NOTE: Renouncing ownership will leave the contract without an owner,\n     * thereby disabling any functionality that is only available to the owner.\n     */\n    function renounceOwnership() public virtual onlyOwner {\n        _transferOwnership(address(0));\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Can only be called by the current owner.\n     */\n    function transferOwnership(address newOwner) public virtual onlyOwner {\n        require(newOwner != address(0), \"Ownable: new owner is the zero address\");\n        _transferOwnership(newOwner);\n    }\n\n    /**\n     * @dev Transfers ownership of the contract to a new account (`newOwner`).\n     * Internal function without access restriction.\n     */\n    function _transferOwnership(address newOwner) internal virtual {\n        address oldOwner = _owner;\n        _owner = newOwner;\n        emit OwnershipTransferred(oldOwner, newOwner);\n    }\n}\n"},{"file_path":"contracts/interfaces/IDistributor.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"./IComponent.sol\";\n\nuint256 constant MAX_DISTRIBUTION = 1e4; // 10,000\nuint8 constant MAX_DESTINATIONS = 100; // maximum number of RevenueShare destinations\n\n// === 4.0.0 ===\n// Invariant: sum across destinations must be at *least* MAX_DISTRIBUTION\n\nstruct RevenueShare {\n    uint16 rTokenDist; // {revShare} A value between [0, 10,000]\n    uint16 rsrDist; // {revShare} A value between [0, 10,000]\n}\n\n/// Assumes no more than 100 independent distributions.\nstruct RevenueTotals {\n    uint24 rTokenTotal; // {revShare}\n    uint24 rsrTotal; // {revShare}\n}\n\n/**\n * @title IDistributor\n * @notice The Distributor Component maintains a revenue distribution table that dictates\n *   how to divide revenue across the Furnace, StRSR, and any other destinations.\n */\ninterface IDistributor is IComponent {\n    /// Emitted when a distribution is set\n    /// @param dest The address set to receive the distribution\n    /// @param rTokenDist The distribution of RToken that should go to `dest`\n    /// @param rsrDist The distribution of RSR that should go to `dest`\n    event DistributionSet(address indexed dest, uint16 rTokenDist, uint16 rsrDist);\n\n    /// Emitted when revenue is distributed\n    /// @param erc20 The token being distributed, either RSR or the RToken itself\n    /// @param source The address providing the revenue\n    /// @param amount The amount of the revenue\n    event RevenueDistributed(IERC20 indexed erc20, address indexed source, uint256 amount);\n\n    // Initialization\n    function init(IMain main_, RevenueShare calldata dist) external;\n\n    /// @custom:governance\n    function setDistribution(address dest, RevenueShare calldata share) external;\n\n    /// @custom:governance\n    function setDistributions(address[] calldata dests, RevenueShare[] calldata shares) external;\n\n    /// Distribute the `erc20` token across all revenue destinations\n    /// Only callable by RevenueTraders\n    /// @custom:protected\n    function distribute(IERC20 erc20, uint256 amount) external;\n\n    /// @return revTotals The total of all  destinations\n    function totals() external view returns (RevenueTotals memory revTotals);\n}\n\ninterface TestIDistributor is IDistributor {\n    // solhint-disable-next-line func-name-mixedcase\n    function FURNACE() external view returns (address);\n\n    // solhint-disable-next-line func-name-mixedcase\n    function ST_RSR() external view returns (address);\n\n    /// @return rTokenDist The RToken distribution for the address\n    /// @return rsrDist The RSR distribution for the address\n    function distribution(address) external view returns (uint16 rTokenDist, uint16 rsrDist);\n}\n"},{"file_path":"contracts/mixins/Auth.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol\";\nimport \"../interfaces/IMain.sol\";\n\nuint256 constant LONG_FREEZE_CHARGES = 6; // 6 uses\nuint48 constant MAX_UNFREEZE_AT = type(uint48).max;\nuint48 constant MAX_SHORT_FREEZE = 2592000; // 1 month\nuint48 constant MAX_LONG_FREEZE = 31536000; // 1 year\n\n/**\n * @title Auth\n * @notice Provides fine-grained access controls and exports frozen/paused states to Components.\n */\nabstract contract Auth is AccessControlUpgradeable, IAuth {\n    /**\n     * System-wide states (does not impact ERC20 functions)\n     *  - Frozen: only allow OWNER actions and staking.\n     *  - Trading Paused: only allow OWNER actions, issuance, redemption, staking,\n     *                    and rewards payout.\n     *  - Issuance Paused: disallow issuance\n     *\n     * Typically freezing thaws on its own in a predetermined number of blocks.\n     *   However, OWNER can freeze forever and unfreeze.\n     */\n\n    /// The rest of the contract uses the shorthand; these declarations are here for getters\n    bytes32 public constant OWNER_ROLE = OWNER;\n    bytes32 public constant SHORT_FREEZER_ROLE = SHORT_FREEZER;\n    bytes32 public constant LONG_FREEZER_ROLE = LONG_FREEZER;\n    bytes32 public constant PAUSER_ROLE = PAUSER;\n\n    // === Freezing ===\n\n    mapping(address => uint256) public longFreezes;\n\n    uint48 public unfreezeAt; // {s} uint48.max to pause indefinitely\n    uint48 public shortFreeze; // {s} length of an initial freeze\n    uint48 public longFreeze; // {s} length of a freeze extension\n\n    // === Pausing ===\n\n    /// @custom:oz-renamed-from paused\n    bool public tradingPaused;\n    bool public issuancePaused;\n\n    /* ==== Invariants ====\n       0 <= longFreeze[a] <= LONG_FREEZE_CHARGES for all addrs a\n       set{a has LONG_FREEZER} == set{a : longFreeze[a] == 0}\n    */\n\n    // checks:\n    // - __Auth_init has not previously been called\n    // - 0 < shortFreeze_ <= MAX_SHORT_FREEZE\n    // - 0 < longFreeze_ <= MAX_LONG_FREEZE\n    // effects:\n    // - caller has only the OWNER role\n    // - OWNER is the admin role for all roles\n    // - shortFreeze' == shortFreeze_\n    // - longFreeze' == longFreeze_\n    // questions: (what do I know about the values of paused and unfreezeAt?)\n    // untestable:\n    //      `else` branch of `onlyInitializing` (ie. revert) is currently untestable.\n    //      This function is only called inside other `init` functions, each of which is wrapped\n    //      in an `initializer` modifier, which would fail first.\n    // solhint-disable-next-line func-name-mixedcase\n    function __Auth_init(uint48 shortFreeze_, uint48 longFreeze_) internal onlyInitializing {\n        __AccessControl_init();\n\n        // Role setup\n        _setRoleAdmin(OWNER, OWNER);\n        _setRoleAdmin(SHORT_FREEZER, OWNER);\n        _setRoleAdmin(LONG_FREEZER, OWNER);\n        _setRoleAdmin(PAUSER, OWNER);\n\n        _grantRole(OWNER, _msgSender());\n\n        setShortFreeze(shortFreeze_);\n        setLongFreeze(longFreeze_);\n    }\n\n    // checks: caller is an admin for role, account is not 0\n    // effects:\n    // - account has the `role` role\n    // - if role is LONG_FREEZER, then longFreezes'[account] == LONG_FREEZE_CHARGES\n    function grantRole(bytes32 role, address account)\n        public\n        override(AccessControlUpgradeable, IAccessControlUpgradeable)\n        onlyRole(getRoleAdmin(role))\n    {\n        require(account != address(0), \"cannot grant role to address 0\");\n        if (role == LONG_FREEZER) longFreezes[account] = LONG_FREEZE_CHARGES;\n        _grantRole(role, account);\n    }\n\n    // ==== System-wide views ====\n    // returns: bool(main is frozen) == now < unfreezeAt\n    function frozen() public view returns (bool) {\n        return block.timestamp < unfreezeAt;\n    }\n\n    /// @dev This -or- condition is a performance optimization for the consuming Component\n    // returns: bool(main is frozen or tradingPaused) == tradingPaused || (now < unfreezeAt)\n    function tradingPausedOrFrozen() public view returns (bool) {\n        return tradingPaused || block.timestamp < unfreezeAt;\n    }\n\n    /// @dev This -or- condition is a performance optimization for the consuming Component\n    // returns: bool(main is frozen or issuancePaused) == issuancePaused || (now < unfreezeAt)\n    function issuancePausedOrFrozen() public view returns (bool) {\n        return issuancePaused || block.timestamp < unfreezeAt;\n    }\n\n    // === Freezing ===\n\n    /// Enter a freeze for the `shortFreeze` duration\n    // checks:\n    // - caller has the SHORT_FREEZER role\n    // - now + shortFreeze >= unfreezeAt (that is, this call should increase unfreezeAt)\n    // effects:\n    // - unfreezeAt' = now + shortFreeze\n    // - after, caller does not have the SHORT_FREEZER role\n    function freezeShort() external onlyRole(SHORT_FREEZER) {\n        // Revoke short freezer role after one use\n        _revokeRole(SHORT_FREEZER, _msgSender());\n        freezeUntil(uint48(block.timestamp) + shortFreeze);\n    }\n\n    /// Enter a freeze by the `longFreeze` duration\n    // checks:\n    // - caller has the LONG_FREEZER role\n    // - longFreezes[caller] > 0\n    // - now + longFreeze >= unfreezeAt (that is, this call should increase unfreezeAt)\n    // effects:\n    // - unfreezeAt' = now + longFreeze\n    // - longFreezes'[caller] = longFreezes[caller] - 1\n    // - if longFreezes'[caller] == 0 then caller loses the LONG_FREEZER role\n    function freezeLong() external onlyRole(LONG_FREEZER) {\n        longFreezes[_msgSender()] -= 1; // reverts on underflow\n\n        // Revoke on 0 charges as a cleanup step\n        if (longFreezes[_msgSender()] == 0) _revokeRole(LONG_FREEZER, _msgSender());\n        freezeUntil(uint48(block.timestamp) + longFreeze);\n    }\n\n    /// Enter a permanent freeze\n    // checks:\n    // - caller has the OWNER role\n    // - unfreezeAt != type(uint48).max\n    // effects: unfreezeAt' = type(uint48).max\n    function freezeForever() external onlyRole(OWNER) {\n        freezeUntil(MAX_UNFREEZE_AT);\n    }\n\n    /// End all freezes\n    // checks:\n    // - unfreezeAt > now  (i.e, frozen() == true before the call)\n    // - caller has the OWNER role\n    // effects: unfreezeAt' = now  (i.e, frozen() == false after the call)\n    function unfreeze() external onlyRole(OWNER) {\n        emit UnfreezeAtSet(unfreezeAt, uint48(block.timestamp));\n        unfreezeAt = uint48(block.timestamp);\n    }\n\n    // === Pausing ===\n    // checks: caller has PAUSER\n    // effects: tradingPaused' = true\n    function pauseTrading() external onlyRole(PAUSER) {\n        emit TradingPausedSet(tradingPaused, true);\n        tradingPaused = true;\n    }\n\n    // checks: caller has PAUSER\n    // effects: tradingPaused' = false\n    function unpauseTrading() external onlyRole(PAUSER) {\n        emit TradingPausedSet(tradingPaused, false);\n        tradingPaused = false;\n    }\n\n    // checks: caller has PAUSER\n    // effects: issuancePaused' = true\n    function pauseIssuance() external onlyRole(PAUSER) {\n        emit IssuancePausedSet(issuancePaused, true);\n        issuancePaused = true;\n    }\n\n    // checks: caller has PAUSER\n    // effects: issuancePaused' = false\n    function unpauseIssuance() external onlyRole(PAUSER) {\n        emit IssuancePausedSet(issuancePaused, false);\n        issuancePaused = false;\n    }\n\n    // === Gov params ===\n\n    /// @custom:governance\n    function setShortFreeze(uint48 shortFreeze_) public onlyRole(OWNER) {\n        require(shortFreeze_ != 0 && shortFreeze_ <= MAX_SHORT_FREEZE, \"short freeze out of range\");\n        emit ShortFreezeDurationSet(shortFreeze, shortFreeze_);\n        shortFreeze = shortFreeze_;\n    }\n\n    /// @custom:governance\n    function setLongFreeze(uint48 longFreeze_) public onlyRole(OWNER) {\n        require(longFreeze_ != 0 && longFreeze_ <= MAX_LONG_FREEZE, \"long freeze out of range\");\n        emit LongFreezeDurationSet(longFreeze, longFreeze_);\n        longFreeze = longFreeze_;\n    }\n\n    // === Private Helper ===\n    // checks: newUnfreezeAt > unfreezeAt\n    // effects: unfreezeAt' = newUnfreezeAt\n    function freezeUntil(uint48 newUnfreezeAt) private {\n        require(newUnfreezeAt > unfreezeAt, \"frozen\");\n        emit UnfreezeAtSet(unfreezeAt, newUnfreezeAt);\n        unfreezeAt = newUnfreezeAt;\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[48] private __gap;\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./IAccessControlUpgradeable.sol\";\nimport \"../utils/ContextUpgradeable.sol\";\nimport \"../utils/StringsUpgradeable.sol\";\nimport \"../utils/introspection/ERC165Upgradeable.sol\";\nimport {Initializable} from \"../proxy/utils/Initializable.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 * ```solidity\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 * ```solidity\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. We recommend using {AccessControlDefaultAdminRules}\n * to enforce additional security measures for this role.\n */\nabstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControlUpgradeable, ERC165Upgradeable {\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);\n        _;\n    }\n\n    function __AccessControl_init() internal onlyInitializing {\n    }\n\n    function __AccessControl_init_unchained() internal onlyInitializing {\n    }\n    /**\n     * @dev See {IERC165-supportsInterface}.\n     */\n    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {\n        return interfaceId == type(IAccessControlUpgradeable).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 virtual override returns (bool) {\n        return _roles[role].members[account];\n    }\n\n    /**\n     * @dev Revert with a standard message if `_msgSender()` is missing `role`.\n     * Overriding this function changes the behavior of the {onlyRole} modifier.\n     *\n     * Format of the revert message is described in {_checkRole}.\n     *\n     * _Available since v4.6._\n     */\n    function _checkRole(bytes32 role) internal view virtual {\n        _checkRole(role, _msgSender());\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 virtual {\n        if (!hasRole(role, account)) {\n            revert(\n                string(\n                    abi.encodePacked(\n                        \"AccessControl: account \",\n                        StringsUpgradeable.toHexString(account),\n                        \" is missing role \",\n                        StringsUpgradeable.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 virtual 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     * May emit a {RoleGranted} event.\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     * May emit a {RoleRevoked} event.\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     * May emit a {RoleRevoked} event.\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     * May emit a {RoleGranted} event.\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     * May emit a {RoleGranted} event.\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     * May emit a {RoleRevoked} event.\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    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[49] private __gap;\n}\n"},{"file_path":"contracts/interfaces/IRevenueTrader.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"./IComponent.sol\";\nimport \"./ITrading.sol\";\n\n/**\n * @title IRevenueTrader\n * @notice The RevenueTrader is an extension of the trading mixin that trades all\n *   assets at its address for a single target asset. There are two runtime instances\n *   of the RevenueTrader, 1 for RToken and 1 for RSR.\n */\ninterface IRevenueTrader is IComponent, ITrading {\n    // Initialization\n    function init(\n        IMain main_,\n        IERC20 tokenToBuy_,\n        uint192 maxTradeSlippage_,\n        uint192 minTradeVolume_\n    ) external;\n\n    /// Distribute tokenToBuy to its destinations\n    /// @dev Special-case of manageTokens()\n    /// @custom:interaction\n    function distributeTokenToBuy() external;\n\n    /// Return registered ERC20s to the BackingManager if distribution for tokenToBuy is 0\n    /// @custom:interaction\n    function returnTokens(IERC20[] memory erc20s) external;\n\n    /// Process some number of tokens\n    /// If the tokenToBuy is included in erc20s, RevenueTrader will distribute it at end of the tx\n    /// @param erc20s The ERC20s to manage; can be tokenToBuy or anything registered\n    /// @param kinds The kinds of auctions to launch: DUTCH_AUCTION | BATCH_AUCTION\n    /// @custom:interaction\n    function manageTokens(IERC20[] memory erc20s, TradeKind[] memory kinds) external;\n\n    function tokenToBuy() external view returns (IERC20);\n}\n\n// solhint-disable-next-line no-empty-blocks\ninterface TestIRevenueTrader is IRevenueTrader, TestITrading {\n\n}\n"},{"file_path":"contracts/interfaces/ITrading.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../libraries/Fixed.sol\";\nimport \"./IComponent.sol\";\nimport \"./ITrade.sol\";\nimport \"./IRewardable.sol\";\n\n/**\n * @title ITrading\n * @notice Common events and refresher function for all Trading contracts\n */\ninterface ITrading is IComponent, IRewardableComponent {\n    event MaxTradeSlippageSet(uint192 oldVal, uint192 newVal);\n    event MinTradeVolumeSet(uint192 oldVal, uint192 newVal);\n\n    /// Emitted when a trade is started\n    /// @param trade The one-time-use trade contract that was just deployed\n    /// @param sell The token to sell\n    /// @param buy The token to buy\n    /// @param sellAmount {qSellTok} The quantity of the selling token\n    /// @param minBuyAmount {qBuyTok} The minimum quantity of the buying token to accept\n    event TradeStarted(\n        ITrade indexed trade,\n        IERC20 indexed sell,\n        IERC20 indexed buy,\n        uint256 sellAmount,\n        uint256 minBuyAmount\n    );\n\n    /// Emitted after a trade ends\n    /// @param trade The one-time-use trade contract\n    /// @param sell The token to sell\n    /// @param buy The token to buy\n    /// @param sellAmount {qSellTok} The quantity of the token sold\n    /// @param buyAmount {qBuyTok} The quantity of the token bought\n    event TradeSettled(\n        ITrade indexed trade,\n        IERC20 indexed sell,\n        IERC20 indexed buy,\n        uint256 sellAmount,\n        uint256 buyAmount\n    );\n\n    /// Forcibly settle a trade, losing all value\n    /// Should only be called in case of censorship\n    /// @param trade The trade address itself\n    /// @custom:governance\n    function forceSettleTrade(ITrade trade) external;\n\n    /// Settle a single trade, expected to be used with multicall for efficient mass settlement\n    /// @param sell The sell token in the trade\n    /// @return The trade settled\n    /// @custom:refresher\n    function settleTrade(IERC20 sell) external returns (ITrade);\n\n    /// @return {%} The maximum trade slippage acceptable\n    function maxTradeSlippage() external view returns (uint192);\n\n    /// @return {UoA} The minimum trade volume in UoA, applies to all assets\n    function minTradeVolume() external view returns (uint192);\n\n    /// @return The ongoing trade for a sell token, or the zero address\n    function trades(IERC20 sell) external view returns (ITrade);\n\n    /// @return The number of ongoing trades open\n    function tradesOpen() external view returns (uint48);\n\n    /// @return The number of total trades ever opened\n    function tradesNonce() external view returns (uint256);\n}\n\ninterface TestITrading is ITrading {\n    /// @custom:governance\n    function setMaxTradeSlippage(uint192 val) external;\n\n    /// @custom:governance\n    function setMinTradeVolume(uint192 val) external;\n}\n"},{"file_path":"contracts/interfaces/IBasketHandler.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../libraries/Fixed.sol\";\nimport \"./IAsset.sol\";\nimport \"./IComponent.sol\";\n\nstruct BasketRange {\n    uint192 bottom; // {BU}\n    uint192 top; // {BU}\n}\n\n/**\n * @title IBasketHandler\n * @notice The BasketHandler aims to maintain a reference basket of constant target unit amounts.\n * When a collateral token defaults, a new reference basket of equal target units is set.\n * When _all_ collateral tokens default for a target unit, only then is the basket allowed to fall\n *   in terms of target unit amounts. The basket is considered defaulted in this case.\n */\ninterface IBasketHandler is IComponent {\n    /// Emitted when the prime basket is set\n    /// @param erc20s The collateral tokens for the prime basket\n    /// @param targetAmts {target/BU} A list of quantities of target unit per basket unit\n    /// @param targetNames Each collateral token's targetName\n    event PrimeBasketSet(IERC20[] erc20s, uint192[] targetAmts, bytes32[] targetNames);\n\n    /// Emitted when the reference basket is set\n    /// @param nonce {basketNonce} The basket nonce\n    /// @param erc20s The list of collateral tokens in the reference basket\n    /// @param refAmts {ref/BU} The reference amounts of the basket collateral tokens\n    /// @param disabled True when the list of erc20s + refAmts may not be correct\n    event BasketSet(uint256 indexed nonce, IERC20[] erc20s, uint192[] refAmts, bool disabled);\n\n    /// Emitted when a backup config is set for a target unit\n    /// @param targetName The name of the target unit as a bytes32\n    /// @param max The max number to use from `erc20s`\n    /// @param erc20s The set of backup collateral tokens\n    event BackupConfigSet(bytes32 indexed targetName, uint256 max, IERC20[] erc20s);\n\n    /// Emitted when the warmup period is changed\n    /// @param oldVal The old warmup period\n    /// @param newVal The new warmup period\n    event WarmupPeriodSet(uint48 oldVal, uint48 newVal);\n\n    /// Emitted when the issuance premium logic is changed\n    /// @param oldVal The old value of enableIssuancePremium\n    /// @param newVal The new value of enableIssuancePremium\n    event EnableIssuancePremiumSet(bool oldVal, bool newVal);\n\n    /// Emitted when the status of a basket has changed\n    /// @param oldStatus The previous basket status\n    /// @param newStatus The new basket status\n    event BasketStatusChanged(CollateralStatus oldStatus, CollateralStatus newStatus);\n\n    /// Emitted when the last basket nonce available for redemption is changed\n    /// @param oldVal The old value of lastCollateralized\n    /// @param newVal The new value of lastCollateralized\n    event LastCollateralizedChanged(uint48 oldVal, uint48 newVal);\n\n    // Initialization\n    function init(\n        IMain main_,\n        uint48 warmupPeriod_,\n        bool reweightable_,\n        bool enableIssuancePremium_\n    ) external;\n\n    /// Set the prime basket, checking target amounts are constant\n    /// @param erc20s The collateral tokens for the new prime basket\n    /// @param targetAmts The target amounts (in) {target/BU} for the new prime basket\n    ///                   required range: 1e9 values; absolute range irrelevant.\n    /// @custom:governance\n    function setPrimeBasket(IERC20[] calldata erc20s, uint192[] calldata targetAmts) external;\n\n    /// Set the prime basket, skipping any constant target amount checks if RToken is reweightable\n    /// Warning: Reweightable RTokens SHOULD use a spell to execute this function to avoid\n    ///          accidentally changing the UoA value of the RToken.\n    /// @param erc20s The collateral tokens for the new prime basket\n    /// @param targetAmts The target amounts (in) {target/BU} for the new prime basket\n    ///                   required range: 1e9 values; absolute range irrelevant.\n    /// @custom:governance\n    function forceSetPrimeBasket(IERC20[] calldata erc20s, uint192[] calldata targetAmts) external;\n\n    /// Set the backup configuration for a given target\n    /// @param targetName The name of the target as a bytes32\n    /// @param max The maximum number of collateral tokens to use from this target\n    ///            Required range: 1-255\n    /// @param erc20s A list of ordered backup collateral tokens\n    /// @custom:governance\n    function setBackupConfig(\n        bytes32 targetName,\n        uint256 max,\n        IERC20[] calldata erc20s\n    ) external;\n\n    /// Default the basket in order to schedule a basket refresh\n    /// @custom:protected\n    function disableBasket() external;\n\n    /// Governance-controlled setter to cause a basket switch explicitly\n    /// @custom:governance\n    /// @custom:interaction\n    function refreshBasket() external;\n\n    /// Track basket status and collateralization changes\n    /// @custom:refresher\n    function trackStatus() external;\n\n    /// @return If the BackingManager has sufficient collateral to redeem the entire RToken supply\n    function fullyCollateralized() external view returns (bool);\n\n    /// @return status The worst CollateralStatus of all collateral in the basket\n    function status() external view returns (CollateralStatus status);\n\n    /// @return If the basket is ready to issue and trade\n    function isReady() external view returns (bool);\n\n    /// Returns basket quantity rounded up, wihout any issuance premium\n    /// @param erc20 The ERC20 token contract for the asset\n    /// @return {tok/BU} The redemption quantity of token in the reference basket, rounded up\n    /// Returns 0 if erc20 is not registered or not in the basket\n    /// Returns FIX_MAX (in lieu of +infinity) if Collateral.refPerTok() is 0.\n    /// Otherwise, returns (token's basket.refAmts / token's Collateral.refPerTok())\n    function quantity(IERC20 erc20) external view returns (uint192);\n\n    /// Returns basket quantity rounded up, wihout any issuance premium\n    /// Like quantity(), but unsafe because it DOES NOT CONFIRM THAT THE ASSET IS CORRECT\n    /// @param erc20 The ERC20 token contract for the asset\n    /// @param asset The registered asset plugin contract for the erc20\n    /// @return {tok/BU} The redemption quantity of token in the reference basket, rounded up\n    /// Returns 0 if erc20 is not registered or not in the basket\n    /// Returns FIX_MAX (in lieu of +infinity) if Collateral.refPerTok() is 0.\n    /// Otherwise, returns (token's basket.refAmts / token's Collateral.refPerTok())\n    function quantityUnsafe(IERC20 erc20, IAsset asset) external view returns (uint192);\n\n    /// @param amount {BU}\n    /// @param applyIssuancePremium Whether to apply the issuance premium\n    /// @return erc20s The addresses of the ERC20 tokens in the reference basket\n    /// @return quantities {qTok} The quantity of each ERC20 token to issue `amount` baskets\n    function quote(\n        uint192 amount,\n        bool applyIssuancePremium,\n        RoundingMode rounding\n    ) external view returns (address[] memory erc20s, uint256[] memory quantities);\n\n    /// Return the redemption value of `amount` BUs for a linear combination of historical baskets\n    /// @param basketNonces An array of basket nonces to do redemption from\n    /// @param portions {1} An array of Fix quantities that must add up to FIX_ONE\n    /// @param amount {BU}\n    /// @return erc20s The backing collateral erc20s\n    /// @return quantities {qTok} ERC20 token quantities equal to `amount` BUs\n    function quoteCustomRedemption(\n        uint48[] memory basketNonces,\n        uint192[] memory portions,\n        uint192 amount\n    ) external view returns (address[] memory erc20s, uint256[] memory quantities);\n\n    /// @return top {BU} The number of partial basket units: e.g max(coll.map((c) => c.balAsBUs())\n    ///         bottom {BU} The number of whole basket units held by the account\n    function basketsHeldBy(address account) external view returns (BasketRange memory);\n\n    /// Should not revert\n    /// low should be nonzero when BUs are worth selling\n    /// @param applyIssuancePremium Whether to apply the issuance premium to the high price\n    /// @return low {UoA/BU} The lower end of the price estimate\n    /// @return high {UoA/BU} The upper end of the price estimate\n    function price(bool applyIssuancePremium) external view returns (uint192 low, uint192 high);\n\n    /// @return timestamp The timestamp at which the basket was last set\n    function timestamp() external view returns (uint48);\n\n    /// @return The current basket nonce, regardless of status\n    function nonce() external view returns (uint48);\n}\n\ninterface TestIBasketHandler is IBasketHandler {\n    function getPrimeBasket()\n        external\n        view\n        returns (\n            IERC20[] memory erc20s,\n            bytes32[] memory targetNames,\n            uint192[] memory targetAmts\n        );\n\n    function getBackupConfig(bytes32 targetName)\n        external\n        view\n        returns (IERC20[] memory erc20s, uint256 max);\n\n    function lastCollateralized() external view returns (uint48);\n\n    function warmupPeriod() external view returns (uint48);\n\n    function setWarmupPeriod(uint48 val) external;\n\n    function enableIssuancePremium() external view returns (bool);\n\n    function setIssuancePremiumEnabled(bool val) external;\n}\n"},{"file_path":"contracts/mixins/ComponentRegistry.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"./Auth.sol\";\n\n/**\n * @title ComponentRegistry\n */\nabstract contract ComponentRegistry is Initializable, Auth, IComponentRegistry {\n    // untestable:\n    //      `else` branch of `onlyInitializing` (ie. revert) is currently untestable.\n    //      This function is only called inside other `init` functions, each of which is wrapped\n    //      in an `initializer` modifier, which would fail first.\n    // solhint-disable-next-line func-name-mixedcase\n    function __ComponentRegistry_init(Components memory components_) internal onlyInitializing {\n        _setBackingManager(components_.backingManager);\n        _setBasketHandler(components_.basketHandler);\n        _setRSRTrader(components_.rsrTrader);\n        _setRTokenTrader(components_.rTokenTrader);\n        _setAssetRegistry(components_.assetRegistry);\n        _setDistributor(components_.distributor);\n        _setFurnace(components_.furnace);\n        _setBroker(components_.broker);\n        _setStRSR(components_.stRSR);\n        _setRToken(components_.rToken);\n    }\n\n    // === Components ===\n\n    IRToken public rToken;\n\n    function _setRToken(IRToken val) private {\n        require(address(val) != address(0), \"invalid RToken address\");\n        emit RTokenSet(rToken, val);\n        isComponent[address(val)] = true;\n        rToken = val;\n    }\n\n    IStRSR public stRSR;\n\n    function _setStRSR(IStRSR val) private {\n        require(address(val) != address(0), \"invalid StRSR address\");\n        emit StRSRSet(stRSR, val);\n        isComponent[address(val)] = true;\n        stRSR = val;\n    }\n\n    IAssetRegistry public assetRegistry;\n\n    function _setAssetRegistry(IAssetRegistry val) private {\n        require(address(val) != address(0), \"invalid AssetRegistry address\");\n        emit AssetRegistrySet(assetRegistry, val);\n        isComponent[address(val)] = true;\n        assetRegistry = val;\n    }\n\n    IBasketHandler public basketHandler;\n\n    function _setBasketHandler(IBasketHandler val) private {\n        require(address(val) != address(0), \"invalid BasketHandler address\");\n        emit BasketHandlerSet(basketHandler, val);\n        isComponent[address(val)] = true;\n        basketHandler = val;\n    }\n\n    IBackingManager public backingManager;\n\n    function _setBackingManager(IBackingManager val) private {\n        require(address(val) != address(0), \"invalid BackingManager address\");\n        emit BackingManagerSet(backingManager, val);\n        isComponent[address(val)] = true;\n        backingManager = val;\n    }\n\n    IDistributor public distributor;\n\n    function _setDistributor(IDistributor val) private {\n        require(address(val) != address(0), \"invalid Distributor address\");\n        emit DistributorSet(distributor, val);\n        isComponent[address(val)] = true;\n        distributor = val;\n    }\n\n    IRevenueTrader public rsrTrader;\n\n    function _setRSRTrader(IRevenueTrader val) private {\n        require(address(val) != address(0), \"invalid RSRTrader address\");\n        emit RSRTraderSet(rsrTrader, val);\n        isComponent[address(val)] = true;\n        rsrTrader = val;\n    }\n\n    IRevenueTrader public rTokenTrader;\n\n    function _setRTokenTrader(IRevenueTrader val) private {\n        require(address(val) != address(0), \"invalid RTokenTrader address\");\n        emit RTokenTraderSet(rTokenTrader, val);\n        isComponent[address(val)] = true;\n        rTokenTrader = val;\n    }\n\n    IFurnace public furnace;\n\n    function _setFurnace(IFurnace val) private {\n        require(address(val) != address(0), \"invalid Furnace address\");\n        emit FurnaceSet(furnace, val);\n        isComponent[address(val)] = true;\n        furnace = val;\n    }\n\n    IBroker public broker;\n\n    function _setBroker(IBroker val) private {\n        require(address(val) != address(0), \"invalid Broker address\");\n        emit BrokerSet(broker, val);\n        isComponent[address(val)] = true;\n        broker = val;\n    }\n\n    // 4.1.0 - Required for global lock\n    mapping(address => bool) public isComponent;\n\n    modifier onlyComponent() {\n        require(isComponent[_msgSender()], \"not a component\");\n        _;\n    }\n\n    function cacheComponents() external {\n        isComponent[address(rToken)] = true;\n        isComponent[address(stRSR)] = true;\n        isComponent[address(assetRegistry)] = true;\n        isComponent[address(basketHandler)] = true;\n        isComponent[address(backingManager)] = true;\n        isComponent[address(distributor)] = true;\n        isComponent[address(rsrTrader)] = true;\n        isComponent[address(rTokenTrader)] = true;\n        isComponent[address(furnace)] = true;\n        isComponent[address(broker)] = true;\n    }\n\n    /**\n     * @dev This empty reserved space is put in place to allow future versions to add new\n     * variables without shifting down storage in the inheritance chain.\n     * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps\n     */\n    uint256[39] private __gap;\n}\n"}],"certified":false,"conflicting_implementations":null,"abi":[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IAssetRegistry","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IAssetRegistry","name":"newVal","type":"address"}],"name":"AssetRegistrySet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IBackingManager","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IBackingManager","name":"newVal","type":"address"}],"name":"BackingManagerSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IBasketHandler","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IBasketHandler","name":"newVal","type":"address"}],"name":"BasketHandlerSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IBroker","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IBroker","name":"newVal","type":"address"}],"name":"BrokerSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IDistributor","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IDistributor","name":"newVal","type":"address"}],"name":"DistributorSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IFurnace","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IFurnace","name":"newVal","type":"address"}],"name":"FurnaceSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"oldVal","type":"bool"},{"indexed":false,"internalType":"bool","name":"newVal","type":"bool"}],"name":"IssuancePausedSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint48","name":"oldDuration","type":"uint48"},{"indexed":false,"internalType":"uint48","name":"newDuration","type":"uint48"}],"name":"LongFreezeDurationSet","type":"event"},{"anonymous":false,"inputs":[],"name":"MainInitialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IRevenueTrader","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IRevenueTrader","name":"newVal","type":"address"}],"name":"RSRTraderSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"contract IRToken","name":"oldVal","type":"address"},{"indexed":true,"internalType":"contract IRToken","name":"newVal","type":"address"}],"name":"RTokenSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IRevenueTrader","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IRevenueTrader","name":"newVal","type":"address"}],"name":"RTokenTraderSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint48","name":"oldDuration","type":"uint48"},{"indexed":false,"internalType":"uint48","name":"newDuration","type":"uint48"}],"name":"ShortFreezeDurationSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"contract IStRSR","name":"oldVal","type":"address"},{"indexed":false,"internalType":"contract IStRSR","name":"newVal","type":"address"}],"name":"StRSRSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"oldVal","type":"bool"},{"indexed":false,"internalType":"bool","name":"newVal","type":"bool"}],"name":"TradingPausedSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint48","name":"oldVal","type":"uint48"},{"indexed":false,"internalType":"uint48","name":"newVal","type":"uint48"}],"name":"UnfreezeAtSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LONG_FREEZER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OWNER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PAUSER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SHORT_FREEZER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"assetPluginRegistry","outputs":[{"internalType":"contract AssetPluginRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"assetRegistry","outputs":[{"internalType":"contract IAssetRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"backingManager","outputs":[{"internalType":"contract IBackingManager","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"basketHandler","outputs":[{"internalType":"contract IBasketHandler","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"beginTx","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"broker","outputs":[{"internalType":"contract IBroker","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cacheComponents","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"daoFeeRegistry","outputs":[{"internalType":"contract DAOFeeRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"distributor","outputs":[{"internalType":"contract IDistributor","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"endTx","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"freezeForever","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"freezeLong","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"freezeShort","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"frozen","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"furnace","outputs":[{"internalType":"contract IFurnace","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"contract IRToken","name":"rToken","type":"address"},{"internalType":"contract IStRSR","name":"stRSR","type":"address"},{"internalType":"contract IAssetRegistry","name":"assetRegistry","type":"address"},{"internalType":"contract IBasketHandler","name":"basketHandler","type":"address"},{"internalType":"contract IBackingManager","name":"backingManager","type":"address"},{"internalType":"contract IDistributor","name":"distributor","type":"address"},{"internalType":"contract IFurnace","name":"furnace","type":"address"},{"internalType":"contract IBroker","name":"broker","type":"address"},{"internalType":"contract IRevenueTrader","name":"rsrTrader","type":"address"},{"internalType":"contract IRevenueTrader","name":"rTokenTrader","type":"address"}],"internalType":"struct Components","name":"components","type":"tuple"},{"internalType":"contract IERC20","name":"rsr_","type":"address"},{"internalType":"uint48","name":"shortFreeze_","type":"uint48"},{"internalType":"uint48","name":"longFreeze_","type":"uint48"}],"name":"init","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"isComponent","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"issuancePaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"issuancePausedOrFrozen","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"longFreeze","outputs":[{"internalType":"uint48","name":"","type":"uint48"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"longFreezes","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pauseIssuance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"pauseTrading","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"poke","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rToken","outputs":[{"internalType":"contract IRToken","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rTokenTrader","outputs":[{"internalType":"contract IRevenueTrader","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rsr","outputs":[{"internalType":"contract IERC20","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rsrTrader","outputs":[{"internalType":"contract IRevenueTrader","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract AssetPluginRegistry","name":"registry_","type":"address"}],"name":"setAssetPluginRegistry","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract DAOFeeRegistry","name":"feeRegistry_","type":"address"}],"name":"setDAOFeeRegistry","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint48","name":"longFreeze_","type":"uint48"}],"name":"setLongFreeze","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint48","name":"shortFreeze_","type":"uint48"}],"name":"setShortFreeze","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract VersionRegistry","name":"versionRegistry_","type":"address"}],"name":"setVersionRegistry","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"shortFreeze","outputs":[{"internalType":"uint48","name":"","type":"uint48"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stRSR","outputs":[{"internalType":"contract IStRSR","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tradingPaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tradingPausedOrFrozen","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"unfreeze","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unfreezeAt","outputs":[{"internalType":"uint48","name":"","type":"uint48"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"unpauseIssuance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpauseTrading","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"versionHash","type":"bytes32"}],"name":"upgradeMainTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"versionHash","type":"bytes32"},{"internalType":"bool","name":"preValidation","type":"bool"},{"internalType":"bool","name":"postValidation","type":"bool"}],"name":"upgradeRTokenTo","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"},{"inputs":[],"name":"version","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"versionRegistry","outputs":[{"internalType":"contract VersionRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"}],"is_changed_bytecode":false,"is_partially_verified":false,"constructor_args":null}