{"file_path":"contracts/p1/BackingManager.sol","creation_status":"success","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../interfaces/IAsset.sol\";\nimport \"../interfaces/IBackingManager.sol\";\nimport \"../interfaces/IMain.sol\";\nimport \"../libraries/Array.sol\";\nimport \"../libraries/Fixed.sol\";\nimport \"./mixins/Trading.sol\";\nimport \"./mixins/RecollateralizationLib.sol\";\n\n/**\n * @title BackingManager\n * @notice The backing manager holds + manages the backing for an RToken\n */\n\n/// @custom:oz-upgrades-unsafe-allow external-library-linking\ncontract BackingManagerP1 is TradingP1, IBackingManager {\n    using FixLib for uint192;\n    using SafeERC20 for IERC20;\n\n    // Cache of peer components\n    IAssetRegistry private assetRegistry;\n    IBasketHandler private basketHandler;\n    IDistributor private distributor;\n    IRToken private rToken;\n    IERC20 private rsr;\n    IStRSR private stRSR;\n    IRevenueTrader private rsrTrader;\n    IRevenueTrader private rTokenTrader;\n    uint48 public constant MAX_TRADING_DELAY = 60 * 60 * 24 * 365; // {s} 1 year\n    uint192 public constant MAX_BACKING_BUFFER = FIX_ONE; // {1} 100%\n\n    uint48 public tradingDelay; // {s} how long to wait until resuming trading after switching\n    uint192 public backingBuffer; // {1} how much extra backing collateral to keep\n\n    // === 3.0.0 ===\n    IFurnace private furnace;\n    mapping(TradeKind => uint48) private tradeEnd; // {s} last endTime() of an auction per kind\n\n    // === 3.1.0 ===\n    mapping(IERC20 => uint192) private tokensOut; // {tok} token balances out in ITrades\n\n    // ==== Invariants ====\n    // tradingDelay <= MAX_TRADING_DELAY and backingBuffer <= MAX_BACKING_BUFFER\n\n    function init(\n        IMain main_,\n        uint48 tradingDelay_,\n        uint192 backingBuffer_,\n        uint192 maxTradeSlippage_,\n        uint192 minTradeVolume_\n    ) external initializer {\n        __Component_init(main_);\n        __Trading_init(main_, maxTradeSlippage_, minTradeVolume_);\n\n        cacheComponents();\n        setTradingDelay(tradingDelay_);\n        setBackingBuffer(backingBuffer_);\n    }\n\n    /// Give RToken max allowance over the registered token `erc20`\n    /// @custom:interaction CEI\n    // checks: erc20 in assetRegistry\n    // action: set allowance on erc20 for rToken to UINT_MAX\n    // Using two safeApprove calls instead of safeIncreaseAllowance to support USDT\n    function grantRTokenAllowance(IERC20 erc20) external notFrozen globalNonReentrant {\n        require(assetRegistry.isRegistered(erc20), \"erc20 unregistered\");\n        // == Interaction ==\n        IERC20(address(erc20)).safeApprove(address(rToken), 0);\n        IERC20(address(erc20)).safeApprove(address(rToken), type(uint256).max);\n    }\n\n    /// Settle a single trade. If the caller is the trade, try chaining into rebalance()\n    /// While this function is not nonReentrant, its two subsets each individually are\n    /// If the caller is a trade contract, initiate the next trade.\n    /// This is done in order to better align incentives,\n    /// and have the last bidder be the one to start the next auction.\n    /// This behaviour currently only happens for Dutch Trade.\n    /// @param sell The sell token in the trade\n    /// @return trade The ITrade contract settled\n    /// @custom:interaction\n    function settleTrade(IERC20 sell) public override(ITrading, TradingP1) returns (ITrade trade) {\n        delete tokensOut[sell];\n        trade = super.settleTrade(sell); // nonReentrant\n\n        TradeKind kind = trade.KIND();\n        if (tradeEnd[kind] > block.timestamp) tradeEnd[kind] = uint48(block.timestamp);\n\n        // if the settler is the trade contract itself, try chaining with another rebalance()\n        if (_msgSender() == address(trade)) {\n            // solhint-disable-next-line no-empty-blocks\n            try this.rebalance(trade.KIND()) {} catch (bytes memory errData) {\n                // prevent MEV searchers from providing less gas on purpose by reverting if OOG\n                // untested:\n                //     OOG pattern tested in other contracts, cost to test here is high\n                // see: docs/solidity-style.md#Catching-Empty-Data\n                if (errData.length == 0) revert(); // solhint-disable-line reason-string\n            }\n        }\n    }\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 not RCEI; nonReentrant\n    function rebalance(TradeKind kind) external globalNonReentrant {\n        requireNotTradingPausedOrFrozen();\n\n        // == Refresh ==\n        assetRegistry.refresh();\n\n        // DoS prevention:\n        // unless caller is self, require that the next auction is not in same block\n        require(\n            _msgSender() == address(this) || tradeEnd[kind] < block.timestamp,\n            \"already rebalancing\"\n        );\n\n        require(tradesOpen == 0, \"trade open\");\n        require(basketHandler.isReady(), \"basket not ready\");\n        require(block.timestamp >= basketHandler.timestamp() + tradingDelay, \"trading delayed\");\n\n        BasketRange memory basketsHeld = basketHandler.basketsHeldBy(address(this));\n        require(basketsHeld.bottom < rToken.basketsNeeded(), \"already collateralized\");\n        // require(!basketHandler.fullyCollateralized())\n\n        // First dissolve any held RToken balance\n        // gas-optimization: 1 whole RToken must be worth 100 trillion dollars for this to skip $1\n        uint256 balance = rToken.balanceOf(address(this));\n        if (balance >= MAX_DISTRIBUTION * MAX_DESTINATIONS) rToken.dissolve(balance);\n        if (basketsHeld.bottom >= rToken.basketsNeeded()) return; // return if now capitalized\n\n        /*\n         * Recollateralization\n         *\n         * Strategy: iteratively move the system on a forgiving path towards collateralization\n         * through a narrowing BU price band. The initial large spread reflects the\n         * uncertainty associated with the market price of defaulted/volatile collateral, as\n         * well as potential losses due to trading slippage. In the absence of further\n         * collateral default, the size of the BU price band should decrease with each trade\n         * until it is 0, at which point collateralization is restored.\n         *\n         * If we run out of capital and are still undercollateralized, we compromise\n         * rToken.basketsNeeded to the current basket holdings. Haircut time.\n         */\n\n        (TradingContext memory ctx, Registry memory reg) = tradingContext(basketsHeld);\n        (\n            bool doTrade,\n            TradeRequest memory req,\n            TradePrices memory prices\n        ) = RecollateralizationLibP1.prepareRecollateralizationTrade(ctx, reg);\n\n        if (doTrade) {\n            IERC20 sellERC20 = req.sell.erc20();\n\n            // Seize RSR if needed\n            if (sellERC20 == rsr) {\n                uint256 bal = sellERC20.balanceOf(address(this));\n                if (req.sellAmount > bal) stRSR.seizeRSR(req.sellAmount - bal);\n            }\n\n            // Execute Trade\n            ITrade trade = tryTrade(kind, req, prices);\n            tradeEnd[kind] = trade.endTime(); // {s}\n            tokensOut[sellERC20] = trade.sellAmount(); // {tok}\n        } else {\n            // Haircut time\n            compromiseBasketsNeeded(basketsHeld.bottom);\n        }\n    }\n\n    /// Forward revenue to RevenueTraders; reverts if not fully collateralized\n    /// @param erc20s The tokens to forward\n    /// @custom:interaction not RCEI; nonReentrant\n    function forwardRevenue(IERC20[] calldata erc20s) external globalNonReentrant {\n        requireNotTradingPausedOrFrozen();\n        require(ArrayLib.allUnique(erc20s), \"duplicate tokens\");\n\n        assetRegistry.refresh();\n\n        BasketRange memory basketsHeld = basketHandler.basketsHeldBy(address(this));\n\n        require(tradesOpen == 0, \"trade open\");\n        require(basketHandler.isReady(), \"basket not ready\");\n        require(block.timestamp >= basketHandler.timestamp() + tradingDelay, \"trading delayed\");\n        require(basketsHeld.bottom >= rToken.basketsNeeded(), \"undercollateralized\");\n        // require(basketHandler.fullyCollateralized())\n\n        /**\n         * Assumptions:\n         *   - Fully collateralized. All collateral meet balance requirements.\n         *   - All backing capital is held at BackingManager's address. No capital is out on-trade\n         *   - Neither RToken nor RSR are in the basket\n         *   - Each address in erc20s is unique\n         *\n         * Steps:\n         *   1. Forward all held RSR to the RSR trader to prevent using it for RToken appreciation\n         *      (action: send rsr().balanceOf(this) to rsrTrader)\n         *   2. Using whatever balances of collateral are there, fast-issue all RToken possible.\n         *      (in detail: mint RToken and set basketsNeeded so that the BU/rtok exchange rate is\n         *       roughly constant, and strictly does not decrease,\n         *   3. Handout all RToken held above the backingBuffer portion of the supply, and all\n         *      non-RToken surplus asset balances to the RSR and\n         *      RToken traders according to the distribution totals.\n         */\n\n        // Forward any RSR held to StRSR pool and payout rewards\n        // RSR should never be sold for RToken yield\n        if (rsr.balanceOf(address(this)) != 0) {\n            // For CEI, this is an interaction \"within our system\" even though RSR is already live\n            IERC20(address(rsr)).safeTransfer(address(stRSR), rsr.balanceOf(address(this)));\n            stRSR.payoutRewards();\n        }\n\n        // Mint revenue RToken\n        // Keep backingBuffer worth of collateral before recognizing revenue\n        uint192 baskets = (basketsHeld.bottom.div(FIX_ONE + backingBuffer));\n        if (baskets > rToken.basketsNeeded()) {\n            rToken.mint(baskets - rToken.basketsNeeded());\n        }\n\n        uint192 needed = rToken.basketsNeeded().mul(FIX_ONE + backingBuffer); // {BU}\n\n        // At this point, even though basketsNeeded may have changed, we are:\n        // - We're fully collateralized\n        // - The BU exchange rate {BU/rTok} did not decrease\n\n        // Handout surplus assets + newly minted RToken\n\n        uint256 length = erc20s.length;\n        RevenueTotals memory totals = distributor.totals();\n        for (uint256 i = 0; i < length; ++i) {\n            IAsset asset = assetRegistry.toAsset(erc20s[i]);\n\n            // Use same quantity-rounding as BasketHandler.basketsHeldBy()\n            // {tok} = {BU} * {tok/BU}\n            uint192 req = needed.mul(basketHandler.quantity(erc20s[i]), CEIL);\n            uint192 bal = asset.bal(address(this));\n\n            if (bal.gt(req)) {\n                // delta: {qTok}, the excess quantity of this asset that we hold\n                uint256 delta = bal.minus(req).shiftl_toUint(int8(asset.erc20Decimals()));\n                uint256 tokensPerShare = delta / (totals.rTokenTotal + totals.rsrTotal);\n                if (tokensPerShare == 0) continue;\n\n                // no div-by-0: Distributor guarantees (totals.rTokenTotal + totals.rsrTotal) > 0\n                // initial division is intentional here! We'd rather save the dust than be unfair\n\n                if (totals.rsrTotal != 0) {\n                    erc20s[i].safeTransfer(address(rsrTrader), tokensPerShare * totals.rsrTotal);\n                }\n                if (totals.rTokenTotal != 0) {\n                    erc20s[i].safeTransfer(\n                        address(rTokenTrader),\n                        tokensPerShare * totals.rTokenTotal\n                    );\n                }\n            }\n        }\n        // It's okay if there is leftover dust for RToken or a surplus asset (not RSR)\n    }\n\n    // === View ===\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        public\n        view\n        returns (TradingContext memory ctx, Registry memory reg)\n    {\n        reg = assetRegistry.getRegistry();\n\n        ctx.basketsHeld = basketsHeld;\n        ctx.bh = basketHandler;\n        ctx.ar = assetRegistry;\n        ctx.stRSR = stRSR;\n        ctx.rsr = rsr;\n        ctx.rToken = rToken;\n        ctx.minTradeVolume = minTradeVolume;\n        ctx.maxTradeSlippage = maxTradeSlippage;\n        ctx.quantities = new uint192[](reg.erc20s.length);\n        ctx.bals = new uint192[](reg.erc20s.length);\n\n        for (uint256 i = 0; i < reg.erc20s.length; ++i) {\n            IERC20 erc20 = reg.erc20s[i];\n            IAsset asset = reg.assets[i];\n\n            ctx.quantities[i] = basketHandler.quantityUnsafe(erc20, asset);\n            // quantities round up, and exclude issuance premium\n\n            // include balances out on trade\n            ctx.bals[i] = asset.bal(address(this)) + tokensOut[erc20];\n\n            // include StRSR's balance for RSR\n            if (erc20 == rsr) ctx.bals[i] += asset.bal(address(stRSR));\n        }\n    }\n\n    // === Private ===\n\n    /// Compromise on how many baskets are needed in order to recollateralize-by-accounting\n    /// @param basketsHeldBottom {BU} The number of full basket units held by the BackingManager\n    function compromiseBasketsNeeded(uint192 basketsHeldBottom) private {\n        // assert(tradesOpen == 0 && !basketHandler.fullyCollateralized());\n        assert(tradesOpen == 0);\n        rToken.setBasketsNeeded(basketsHeldBottom);\n    }\n\n    // === Governance ===\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) public override(TradingP1, ITrading) {\n        delete tokensOut[trade.sell()];\n        super.forceSettleTrade(trade); // enforces governance only; nonReentrant\n    }\n\n    /// @custom:governance\n    function setTradingDelay(uint48 val) public {\n        requireGovernanceOnly();\n        require(val <= MAX_TRADING_DELAY, \"invalid tradingDelay\");\n        emit TradingDelaySet(tradingDelay, val);\n        tradingDelay = val;\n    }\n\n    /// @custom:governance\n    function setBackingBuffer(uint192 val) public {\n        requireGovernanceOnly();\n        require(val <= MAX_BACKING_BUFFER, \"invalid backingBuffer\");\n        emit BackingBufferSet(backingBuffer, val);\n        backingBuffer = val;\n    }\n\n    /// Call after upgrade to >= 3.0.0\n    function cacheComponents() public {\n        assetRegistry = main.assetRegistry();\n        basketHandler = main.basketHandler();\n        distributor = main.distributor();\n        rToken = main.rToken();\n        rsr = main.rsr();\n        stRSR = main.stRSR();\n        rsrTrader = main.rsrTrader();\n        rTokenTrader = main.rTokenTrader();\n        furnace = main.furnace();\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[38] private __gap;\n}\n","deployed_bytecode":"0x6080604052600436106101d85760003560e01c806372fb729811610102578063b9bebb0411610095578063d50e7a7011610064578063d50e7a7014610527578063dffeadd0146105a2578063e7227de6146105c2578063f4ae1474146105e957600080fd5b8063b9bebb0414610527578063bcaeb7b914610543578063c76aeb1214610563578063cb9414f81461058257600080fd5b8063a9f752e5116100d1578063a9f752e514610483578063ac9650d8146104b9578063adaef42c146104e6578063b51f8f881461050657600080fd5b806372fb7298146103ff5780637cbf6db21461042d5780638767e6381461044d57806398026d941461046357600080fd5b806336a02f571161017a5780634f1ef286116101495780634f1ef2861461038057806352d1902d1461039357806354fd4d50146103b65780637162c797146103ea57600080fd5b806336a02f571461030b578063372500ab1461032b5780633854430c14610340578063386eafd91461036057600080fd5b806312701397116101b6578063127013971461027b57806312d5025a1461029c5780632bca33e9146102bc5780633659cfe6146102eb57600080fd5b80630db3d42c146101dd5780630e0264d11461022157806310e4d36b14610259575b600080fd5b3480156101e957600080fd5b5060fd5461020490600160301b90046001600160c01b031681565b6040516001600160c01b0390911681526020015b60405180910390f35b34801561022d57600080fd5b5061024161023c36600461500d565b610609565b6040516001600160a01b039091168152602001610218565b34801561026557600080fd5b5061027961027436600461503f565b610855565b005b34801561028757600080fd5b5061013554610204906001600160c01b031681565b3480156102a857600080fd5b506102796102b736600461500d565b610926565b3480156102c857600080fd5b506102d46301e1338081565b60405165ffffffffffff9091168152602001610218565b3480156102f757600080fd5b5061027961030636600461500d565b6109c0565b34801561031757600080fd5b5061027961032636600461503f565b610a9c565b34801561033757600080fd5b50610279610b6c565b34801561034c57600080fd5b5061027961035b3660046150a7565b610cba565b34801561036c57600080fd5b5061027961037b3660046150fc565b61191f565b61027961038e3660046151a9565b6119f3565b34801561039f57600080fd5b506103a8611ac3565b604051908152602001610218565b3480156103c257600080fd5b5060408051808201825260058152640342e322e360dc1b6020820152905161021891906152a4565b3480156103f657600080fd5b50610279611b76565b34801561040b57600080fd5b5061041f61041a3660046152b7565b612028565b6040516102189291906153e0565b34801561043957600080fd5b5060fe54610204906001600160c01b031681565b34801561045957600080fd5b506103a860ff5481565b34801561046f57600080fd5b5061027961047e36600461500d565b612487565b34801561048f57600080fd5b5061024161049e36600461500d565b60fc602052600090815260409020546001600160a01b031681565b3480156104c557600080fd5b506104d96104d43660046150a7565b6126f0565b60405161021891906154f5565b3480156104f257600080fd5b5061027961050136600461500d565b6127d8565b34801561051257600080fd5b506102046c01431e0fae6d7217caa000000081565b34801561053357600080fd5b50610204670de0b6b3a764000081565b34801561054f57600080fd5b5061027961055e36600461555a565b612928565b34801561056f57600080fd5b5060fd546102d49065ffffffffffff1681565b34801561058e57600080fd5b5061027961059d36600461503f565b612a63565b3480156105ae57600080fd5b50609754610241906001600160a01b031681565b3480156105ce57600080fd5b50610134546102d490600160a01b900465ffffffffffff1681565b3480156105f557600080fd5b506102796106043660046155d8565b612b49565b6001600160a01b03811660009081526101386020526040812080546001600160c01b031916905561063982613539565b90506000816001600160a01b031663c872da3c6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561067b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061069f91906155f5565b90504261013760008360018111156106b9576106b9615612565b60018111156106ca576106ca615612565b815260208101919091526040016000205465ffffffffffff1611156107435742610137600083600181111561070157610701615612565b600181111561071257610712615612565b815260200190815260200160002060006101000a81548165ffffffffffff021916908365ffffffffffff1602179055505b6001600160a01b038216330361084f57306001600160a01b031663f4ae1474836001600160a01b031663c872da3c6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107a0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107c491906155f5565b6040518263ffffffff1660e01b81526004016107e0919061564a565b600060405180830381600087803b1580156107fa57600080fd5b505af192505050801561080b575060015b61084f573d808015610839576040519150601f19603f3d011682016040523d82523d6000602084013e61083e565b606091505b50805160000361084d57600080fd5b505b50919050565b61085d61388b565b670de0b6b3a76400006001600160c01b03821611156108bb5760405162461bcd60e51b815260206004820152601560248201527434b73b30b634b2103130b1b5b4b733a13ab33332b960591b60448201526064015b60405180910390fd5b61013554604080516001600160c01b03928316815291831660208301527f4ec8ac3ba3ecc0b9d7690e98f4bf8f5c70b8f2a9b4326c757b44ba3d19c18796910160405180910390a161013580546001600160c01b0319166001600160c01b0392909216919091179055565b6101386000826001600160a01b031663457100746040518163ffffffff1660e01b8152600401602060405180830381865afa158015610969573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061098d9190615658565b6001600160a01b03168152602081019190915260400160002080546001600160c01b03191690556109bd81613974565b50565b6001600160a01b037f00000000000000000000000062a574b9f4bcc1ddf877e154963c5b4e792985d6163003610a085760405162461bcd60e51b81526004016108b290615675565b7f00000000000000000000000062a574b9f4bcc1ddf877e154963c5b4e792985d66001600160a01b0316610a51600080516020615f06833981519152546001600160a01b031690565b6001600160a01b031614610a775760405162461bcd60e51b81526004016108b2906156c1565b610a8081613c17565b604080516000808252602082019092526109bd91839190613c66565b610aa461388b565b6c01431e0fae6d7217caa00000006001600160c01b0382161115610b035760405162461bcd60e51b8152602060048201526016602482015275696e76616c6964206d696e5472616465566f6c756d6560501b60448201526064016108b2565b60fe54604080516001600160c01b03928316815291831660208301527f1dec1ae9fd64ef0d8a6b130d853a8ab21d337625027cc60c63028f3d383495dc910160405180910390a160fe80546001600160c01b0319166001600160c01b0392909216919091179055565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610bbc57600080fd5b505af1158015610bd0573d6000803e3d6000fd5b50505050610bdc613dd6565b60975460408051634bcebf4360e11b81529051610c50926001600160a01b03169163979d7e869160048083019260209291908290030181865afa158015610c27573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c4b9190615658565b613e9a565b609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610ca057600080fd5b505af1158015610cb4573d6000803e3d6000fd5b50505050565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610d0a57600080fd5b505af1158015610d1e573d6000803e3d6000fd5b50505050610d2a613dd6565b610d66828280806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250613fab92505050565b610da55760405162461bcd60e51b815260206004820152601060248201526f6475706c696361746520746f6b656e7360801b60448201526064016108b2565b61012d60009054906101000a90046001600160a01b03166001600160a01b031663f8ac93e86040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610df657600080fd5b505af1158015610e0a573d6000803e3d6000fd5b505061012e54604051635523caaf60e11b8152306004820152600093506001600160a01b03909116915063aa47955e906024016040805180830381865afa158015610e59573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e7d919061570d565b60fd5490915065ffffffffffff1615610ec55760405162461bcd60e51b815260206004820152600a6024820152693a3930b2329037b832b760b11b60448201526064016108b2565b61012e60009054906101000a90046001600160a01b03166001600160a01b031663a094a0316040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f19573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f3d9190615759565b610f7c5760405162461bcd60e51b815260206004820152601060248201526f6261736b6574206e6f7420726561647960801b60448201526064016108b2565b61013460149054906101000a900465ffffffffffff1661012e60009054906101000a90046001600160a01b03166001600160a01b031663b80777ea6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fe6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061100a9190615774565b61101491906157a7565b65ffffffffffff1642101561105d5760405162461bcd60e51b815260206004820152600f60248201526e1d1c98591a5b99c819195b185e5959608a1b60448201526064016108b2565b61013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110b1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d591906157c5565b6001600160c01b031681600001516001600160c01b031610156111305760405162461bcd60e51b81526020600482015260136024820152721d5b99195c98dbdb1b185d195c985b1a5e9959606a1b60448201526064016108b2565b610131546040516370a0823160e01b81523060048201526001600160a01b03909116906370a0823190602401602060405180830381865afa158015611179573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061119d91906157e2565b156112975761013254610131546040516370a0823160e01b815230600482015261122d926001600160a01b039081169216906370a0823190602401602060405180830381865afa1580156111f5573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061121991906157e2565b610131546001600160a01b03169190614037565b61013260009054906101000a90046001600160a01b03166001600160a01b031663296130866040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561127e57600080fd5b505af1158015611292573d6000803e3d6000fd5b505050505b610135546000906112ce906112bd906001600160c01b0316670de0b6b3a76400006157fb565b83516001600160c01b03169061409a565b905061013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa158015611324573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061134891906157c5565b6001600160c01b0316816001600160c01b0316111561143c576101305460408051637121c27360e01b815290516001600160a01b039092169163aeb14bf6918391637121c273916004808201926020929091908290030181865afa1580156113b4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113d891906157c5565b6113e2908461581a565b6040516001600160e01b031960e084901b1681526001600160c01b039091166004820152602401600060405180830381600087803b15801561142357600080fd5b505af1158015611437573d6000803e3d6000fd5b505050505b610135546000906114e990611462906001600160c01b0316670de0b6b3a76400006157fb565b61013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa1580156114b6573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114da91906157c5565b6001600160c01b0316906140af565b61012f546040805163601c51c760e11b8152815193945087936000936001600160a01b03169263c038a38e92600480820193918290030181865afa158015611535573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611559919061584c565b905060005b828110156118b95761012d546000906001600160a01b031663cde2be8a8a8a8581811061158d5761158d61587f565b90506020020160208101906115a2919061500d565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156115e6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061160a9190615658565b61012e549091506000906116c7906001600160a01b031663a5a5828c8c8c878181106116385761163861587f565b905060200201602081019061164d919061500d565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015611691573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116b591906157c5565b6001600160c01b0388169060026140b9565b604051632ac07b9560e11b81523060048201529091506000906001600160a01b03841690635580f72a90602401602060405180830381865afa158015611711573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061173591906157c5565b90506001600160c01b0382811690821611156118ad5760006117d4846001600160a01b0316633cb5d3796040518163ffffffff1660e01b8152600401602060405180830381865afa15801561178e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906117b29190615895565b6117c56001600160c01b038516866140f3565b6001600160c01b0316906140ff565b90506000866020015187600001516117ec91906158b8565b6117fb9062ffffff16836158e9565b90508060000361180f5750505050506118b1565b602087015162ffffff161561187b5761013354602088015161187b916001600160a01b0316906118449062ffffff16846158fd565b8f8f8a8181106118565761185661587f565b905060200201602081019061186b919061500d565b6001600160a01b03169190614037565b865162ffffff16156118aa576101345487516118aa916001600160a01b0316906118449062ffffff16846158fd565b50505b5050505b60010161155e565b5050609754604080516331cfec0560e01b815290516001600160a01b0390921695506331cfec05945060048082019450600093509082900301818387803b15801561190357600080fd5b505af1158015611917573d6000803e3d6000fd5b505050505050565b61192761388b565b6301e1338065ffffffffffff8216111561197a5760405162461bcd60e51b8152602060048201526014602482015273696e76616c69642074726164696e6744656c617960601b60448201526064016108b2565b610134546040805165ffffffffffff600160a01b9093048316815291831660208301527f4af929ab8885bbdcb8b01903439a99e3fb33354657d151119f731b01db793bdb910160405180910390a1610134805465ffffffffffff909216600160a01b0265ffffffffffff60a01b19909216919091179055565b6001600160a01b037f00000000000000000000000062a574b9f4bcc1ddf877e154963c5b4e792985d6163003611a3b5760405162461bcd60e51b81526004016108b290615675565b7f00000000000000000000000062a574b9f4bcc1ddf877e154963c5b4e792985d66001600160a01b0316611a84600080516020615f06833981519152546001600160a01b031690565b6001600160a01b031614611aaa5760405162461bcd60e51b81526004016108b2906156c1565b611ab382613c17565b611abf82826001613c66565b5050565b6000306001600160a01b037f00000000000000000000000062a574b9f4bcc1ddf877e154963c5b4e792985d61614611b635760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c000000000000000060648201526084016108b2565b50600080516020615f0683398151915290565b609760009054906101000a90046001600160a01b03166001600160a01b031663979d7e866040518163ffffffff1660e01b8152600401602060405180830381865afa158015611bc9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611bed9190615658565b61012d80546001600160a01b0319166001600160a01b0392831617905560975460408051632f2439b160e01b815290519190921691632f2439b19160048083019260209291908290030181865afa158015611c4c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c709190615658565b61012e80546001600160a01b0319166001600160a01b03928316179055609754604080516317fc212560e31b81529051919092169163bfe109289160048083019260209291908290030181865afa158015611ccf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611cf39190615658565b61012f80546001600160a01b0319166001600160a01b03928316179055609754604080516320632fb960e11b8152905191909216916340c65f729160048083019260209291908290030181865afa158015611d52573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d769190615658565b61013080546001600160a01b0319166001600160a01b039283161790556097546040805163c99dc3dd60e01b81529051919092169163c99dc3dd9160048083019260209291908290030181865afa158015611dd5573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611df99190615658565b61013180546001600160a01b0319166001600160a01b0392831617905560975460408051634780a5e560e01b815290519190921691634780a5e59160048083019260209291908290030181865afa158015611e58573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e7c9190615658565b61013280546001600160a01b0319166001600160a01b0392831617905560975460408051635313676360e01b81529051919092169163531367639160048083019260209291908290030181865afa158015611edb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611eff9190615658565b61013380546001600160a01b0319166001600160a01b03928316179055609754604080516320df862760e11b8152905191909216916341bf0c4e9160048083019260209291908290030181865afa158015611f5e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f829190615658565b61013480546001600160a01b0319166001600160a01b039283161790556097546040805163656e96e160e01b81529051919092169163656e96e19160048083019260209291908290030181865afa158015611fe1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906120059190615658565b61013680546001600160a01b0319166001600160a01b0392909216919091179055565b60408051610180810182526000610140820181815261016083018290528252602080830182905282840182905260608084018390526080840183905260a0840183905260c0840183905260e0840183905261010084018190526101208401819052845180860186528181529182015261012d548451635ab1bd5360e01b81529451939491936001600160a01b0390911692635ab1bd5392600480820193918290030181865afa1580156120df573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261210791908101906159ad565b83835261012e546001600160a01b03908116602085015261012d548116604085015261013254811660608501526101315481166080850152610130541660a084015260fe546001600160c01b0390811660c085015260fd54600160301b90041660e08401528051519091506001600160401b0381111561218957612189615119565b6040519080825280602002602001820160405280156121b2578160200160208202803683370190505b506101008301528051516001600160401b038111156121d3576121d3615119565b6040519080825280602002602001820160405280156121fc578160200160208202803683370190505b5061012083015260005b815151811015612481576000826000015182815181106122285761222861587f565b6020026020010151905060008360200151838151811061224a5761224a61587f565b602090810291909101015161012e5460405163d3252db560e01b81526001600160a01b038581166004830152808416602483015292935091169063d3252db590604401602060405180830381865afa1580156122aa573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122ce91906157c5565b85610100015184815181106122e5576122e561587f565b6001600160c01b039283166020918202929092018101919091526001600160a01b038481166000908152610138909252604091829020549151632ac07b9560e11b81523060048201529190921691831690635580f72a90602401602060405180830381865afa15801561235c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061238091906157c5565b61238a91906157fb565b85610120015184815181106123a1576123a161587f565b6001600160c01b0390921660209283029190910190910152610131546001600160a01b03908116908316036124775761013254604051632ac07b9560e11b81526001600160a01b03918216600482015290821690635580f72a90602401602060405180830381865afa15801561241b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061243f91906157c5565b85610120015184815181106124565761245661587f565b6020026020010181815161246a91906157fb565b6001600160c01b03169052505b5050600101612206565b50915091565b609760009054906101000a90046001600160a01b03166001600160a01b031663054f7d9c6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156124da573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906124fe9190615759565b156125345760405162461bcd60e51b8152602060048201526006602482015265333937bd32b760d11b60448201526064016108b2565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561258457600080fd5b505af1158015612598573d6000803e3d6000fd5b505061012d5460405163c3c5a54760e01b81526001600160a01b038581166004830152909116925063c3c5a5479150602401602060405180830381865afa1580156125e7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061260b9190615759565b61264c5760405162461bcd60e51b8152602060048201526012602482015271195c98cc8c081d5b9c9959da5cdd195c995960721b60448201526064016108b2565b61013054612668906001600160a01b038381169116600061410d565b61013054612685906001600160a01b03838116911660001961410d565b609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156126d557600080fd5b505af11580156126e9573d6000803e3d6000fd5b5050505050565b604080516000815260208101909152606090826001600160401b0381111561271a5761271a615119565b60405190808252806020026020018201604052801561274d57816020015b60608152602001906001900390816127385790505b50915060005b838110156127cf576127aa308686848181106127715761277161587f565b90506020028101906127839190615abc565b8560405160200161279693929190615b02565b604051602081830303815290604052614222565b8382815181106127bc576127bc61587f565b6020908102919091010152600101612753565b50505b92915050565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561282857600080fd5b505af115801561283c573d6000803e3d6000fd5b50505050612848613dd6565b60975460408051634bcebf4360e11b81529051612685926001600160a01b03169163979d7e869160048083019260209291908290030181865afa158015612893573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906128b79190615658565b6040516366f15f4560e11b81526001600160a01b038481166004830152919091169063cde2be8a90602401602060405180830381865afa1580156128ff573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129239190615658565b614247565b600054610100900460ff16158080156129485750600054600160ff909116105b806129625750303b158015612962575060005460ff166001145b6129c55760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016108b2565b6000805460ff1916600117905580156129e8576000805461ff0019166101001790555b6129f1866142ad565b6129fc86848461434b565b612a04611b76565b612a0d8561191f565b612a1684610855565b8015611917576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a1505050505050565b612a6b61388b565b670de0b6b3a76400006001600160c01b0382161115612acc5760405162461bcd60e51b815260206004820152601860248201527f696e76616c6964206d61785472616465536c697070616765000000000000000060448201526064016108b2565b60fd54604080516001600160c01b03600160301b9093048316815291831660208301527f58d1f6b92b372d2913abb309ec9503acc2a53ed508ec34f478d7aeab07760f99910160405180910390a160fd80546001600160c01b03909216600160301b026601000000000000600160f01b0319909216919091179055565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b158015612b9957600080fd5b505af1158015612bad573d6000803e3d6000fd5b50505050612bb9613dd6565b61012d60009054906101000a90046001600160a01b03166001600160a01b031663f8ac93e86040518163ffffffff1660e01b8152600401600060405180830381600087803b158015612c0a57600080fd5b505af1158015612c1e573d6000803e3d6000fd5b50505050306001600160a01b0316612c333390565b6001600160a01b03161480612c875750426101376000836001811115612c5b57612c5b615612565b6001811115612c6c57612c6c615612565b815260208101919091526040016000205465ffffffffffff16105b612cc95760405162461bcd60e51b8152602060048201526013602482015272616c726561647920726562616c616e63696e6760681b60448201526064016108b2565b60fd5465ffffffffffff1615612d0e5760405162461bcd60e51b815260206004820152600a6024820152693a3930b2329037b832b760b11b60448201526064016108b2565b61012e60009054906101000a90046001600160a01b03166001600160a01b031663a094a0316040518163ffffffff1660e01b8152600401602060405180830381865afa158015612d62573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612d869190615759565b612dc55760405162461bcd60e51b815260206004820152601060248201526f6261736b6574206e6f7420726561647960801b60448201526064016108b2565b61013460149054906101000a900465ffffffffffff1661012e60009054906101000a90046001600160a01b03166001600160a01b031663b80777ea6040518163ffffffff1660e01b8152600401602060405180830381865afa158015612e2f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e539190615774565b612e5d91906157a7565b65ffffffffffff16421015612ea65760405162461bcd60e51b815260206004820152600f60248201526e1d1c98591a5b99c819195b185e5959608a1b60448201526064016108b2565b61012e54604051635523caaf60e11b81523060048201526000916001600160a01b03169063aa47955e906024016040805180830381865afa158015612eef573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f13919061570d565b905061013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa158015612f69573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f8d91906157c5565b6001600160c01b031681600001516001600160c01b031610612fea5760405162461bcd60e51b8152602060048201526016602482015275185b1c9958591e4818dbdb1b185d195c985b1a5e995960521b60448201526064016108b2565b610130546040516370a0823160e01b81523060048201526000916001600160a01b0316906370a0823190602401602060405180830381865afa158015613034573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061305891906157e2565b905061306760646127106158fd565b81106130cd5761013054604051637c8595ff60e11b8152600481018390526001600160a01b039091169063f90b2bfe90602401600060405180830381600087803b1580156130b457600080fd5b505af11580156130c8573d6000803e3d6000fd5b505050505b61013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa158015613121573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061314591906157c5565b6001600160c01b031682600001516001600160c01b031610613168575050612685565b60008061317484612028565b91509150600080600073d595456ac36aab96cf9d10d1adf8c3b4576c793763ba00555a86866040518363ffffffff1660e01b81526004016131b69291906153e0565b61012060405180830381865af41580156131d4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906131f89190615b29565b92509250925082156134e257600082600001516001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa158015613248573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061326c9190615658565b610131549091506001600160a01b0390811690821603613378576040516370a0823160e01b81523060048201526000906001600160a01b038316906370a0823190602401602060405180830381865afa1580156132cd573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906132f191906157e2565b90508084604001511115613376576101325460408501516001600160a01b039091169063a439622f90613325908490615aa9565b6040518263ffffffff1660e01b815260040161334391815260200190565b600060405180830381600087803b15801561335d57600080fd5b505af1158015613371573d6000803e3d6000fd5b505050505b505b60006133858a8585614406565b9050806001600160a01b0316633197cbb66040518163ffffffff1660e01b8152600401602060405180830381865afa1580156133c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133e99190615774565b61013760008c600181111561340057613400615612565b600181111561341157613411615612565b815260200190815260200160002060006101000a81548165ffffffffffff021916908365ffffffffffff160217905550806001600160a01b0316633f407b846040518163ffffffff1660e01b8152600401602060405180830381865afa15801561347f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906134a391906157c5565b6001600160a01b039290921660009081526101386020526040902080546001600160c01b0319166001600160c01b0390931692909217909155506134ed565b86516134ed90614685565b5050609754604080516331cfec0560e01b815290516001600160a01b0390921696506331cfec059550600480820195506000945091925082900301818387803b1580156126d557600080fd5b60975460408051630a7a6f6960e11b815290516000926001600160a01b0316916314f4ded2916004808301928692919082900301818387803b15801561357e57600080fd5b505af1158015613592573d6000803e3d6000fd5b505050506001600160a01b03828116600090815260fc6020526040902054169050806135f05760405162461bcd60e51b815260206004820152600d60248201526c3737903a3930b2329037b832b760991b60448201526064016108b2565b806001600160a01b031663faf7ba6a6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561362e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906136529190615759565b6136925760405162461bcd60e51b815260206004820152601160248201527018d85b9b9bdd081cd95d1d1b19481e595d607a1b60448201526064016108b2565b6001600160a01b038216600090815260fc6020526040812080546001600160a01b031916905560fd805465ffffffffffff16916136ce83615c12565b91906101000a81548165ffffffffffff021916908365ffffffffffff16021790555050600080826001600160a01b03166311da60b46040518163ffffffff1660e01b815260040160408051808303816000875af1158015613733573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906137579190615c34565b91509150826001600160a01b031663a6f2ae3a6040518163ffffffff1660e01b8152600401602060405180830381865afa158015613799573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906137bd9190615658565b6001600160a01b0316846001600160a01b0316846001600160a01b03167f058fb1fa484531f400806f666315faf1a45941db93ba069405882b78ba40dc878585604051613814929190918252602082015260400190565b60405180910390a45050609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561386e57600080fd5b505af1158015613882573d6000803e3d6000fd5b50505050919050565b60975460408051808201909152600581526427aba722a960d91b60208201526001600160a01b03909116906391d14854906138c590615c58565b336040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa158015613910573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906139349190615759565b6139725760405162461bcd60e51b815260206004820152600f60248201526e676f7665726e616e6365206f6e6c7960881b60448201526064016108b2565b565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156139c457600080fd5b505af11580156139d8573d6000803e3d6000fd5b505050506139e461388b565b6000816001600160a01b031663457100746040518163ffffffff1660e01b8152600401602060405180830381865afa158015613a24573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613a489190615658565b6001600160a01b03818116600090815260fc6020526040902054919250838116911614613aa55760405162461bcd60e51b815260206004820152600b60248201526a77726f6e6720747261646560a81b60448201526064016108b2565b6001600160a01b038116600090815260fc6020526040812080546001600160a01b031916905560fd805465ffffffffffff1691613ae183615c12565b91906101000a81548165ffffffffffff021916908365ffffffffffff16021790555050816001600160a01b031663a6f2ae3a6040518163ffffffff1660e01b8152600401602060405180830381865afa158015613b42573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613b669190615658565b6001600160a01b0316816001600160a01b0316836001600160a01b03167f058fb1fa484531f400806f666315faf1a45941db93ba069405882b78ba40dc87600080604051613bbe929190918252602082015260400190565b60405180910390a450609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156126d557600080fd5b6097546001600160a01b0316336001600160a01b0316146109bd5760405162461bcd60e51b81526020600482015260096024820152686d61696e206f6e6c7960b81b60448201526064016108b2565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff1615613c9e57613c99836146ec565b505050565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015613cf8575060408051601f3d908101601f19168201909252613cf5918101906157e2565b60015b613d5b5760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b60648201526084016108b2565b600080516020615f068339815191528114613dca5760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b60648201526084016108b2565b50613c99838383614788565b609760009054906101000a90046001600160a01b03166001600160a01b03166398f73e526040518163ffffffff1660e01b8152600401602060405180830381865afa158015613e29573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e4d9190615759565b156139725760405162461bcd60e51b815260206004820152601860248201527f66726f7a656e206f722074726164696e6720706175736564000000000000000060448201526064016108b2565b6000816001600160a01b0316635ab1bd536040518163ffffffff1660e01b8152600401600060405180830381865afa158015613eda573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052613f0291908101906159ad565b60208101515190915060005b81811015610cb4576040805160048152602481018252602080820180516001600160e01b031663372500ab60e01b179052825180840190935260148352731c995dd85c991cc818db185a5b4819985a5b195960621b838201528501518051613fa293919085908110613f8257613f8261587f565b60200260200101516001600160a01b03166147ad9092919063ffffffff16565b50600101613f0e565b805160009060015b8181101561402d5760005b8181101561402457848181518110613fd857613fd861587f565b60200260200101516001600160a01b0316858381518110613ffb57613ffb61587f565b60200260200101516001600160a01b03160361401c57506000949350505050565b600101613fbe565b50600101613fb3565b5060019392505050565b6040516001600160a01b038316602482015260448101829052613c9990849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152614825565b60006140a8838360006148fa565b9392505050565b60006140a8838360015b60006140eb6140e66140d76001600160c01b038087169088166158fd565b670de0b6b3a764000085614929565b6149c4565b949350505050565b60006140a8828461581a565b60006140a8838360006149f2565b8015806141875750604051636eb1769f60e11b81523060048201526001600160a01b03838116602483015284169063dd62ed3e90604401602060405180830381865afa158015614161573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061418591906157e2565b155b6141f25760405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b60648201526084016108b2565b6040516001600160a01b038316602482015260448101829052613c9990849063095ea7b360e01b90606401614063565b60606140a88383604051806060016040528060278152602001615f26602791396147ad565b6040805160048152602481018252602080820180516001600160e01b031663372500ab60e01b179052825180840190935260148352731c995dd85c991cc818db185a5b4819985a5b195960621b90830152611abf916001600160a01b03841691906147ad565b600054610100900460ff166142d45760405162461bcd60e51b81526004016108b290615c7c565b6001600160a01b0381166143215760405162461bcd60e51b81526020600482015260146024820152736d61696e206973207a65726f206164647265737360601b60448201526064016108b2565b614329614ad3565b609780546001600160a01b0319166001600160a01b0392909216919091179055565b600054610100900460ff166143725760405162461bcd60e51b81526004016108b290615c7c565b826001600160a01b031663abff01106040518163ffffffff1660e01b8152600401602060405180830381865afa1580156143b0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906143d49190615658565b60fb80546001600160a01b0319166001600160a01b03929092169190911790556143fd82612a63565b613c9981610a9c565b60008083600001516001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa15801561444b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061446f9190615658565b6001600160a01b03808216600090815260fc6020526040902054919250161561449a5761449a615cc7565b60fb5460408501516144b99183916001600160a01b0390911690614afa565b60fb546040516314bf206560e21b81526001600160a01b03909116906352fc8194906144ed90889088908890600401615cdd565b6020604051808303816000875af115801561450c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906145309190615658565b6001600160a01b03828116600090815260fc6020526040812080546001600160a01b0319169284169290921790915560fd8054929450916145789065ffffffffffff16615d63565b91906101000a81548165ffffffffffff021916908365ffffffffffff16021790555060ff600081546145a990615d8c565b9190508190555083602001516001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa1580156145f2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906146169190615658565b6001600160a01b0316816001600160a01b0316836001600160a01b03167ff18b757d93c36d059284838a0328b06d8eb30d7214ffadde3266465a0006f6b387604001518860600151604051614675929190918252602082015260400190565b60405180910390a4509392505050565b60fd5465ffffffffffff161561469d5761469d615cc7565b61013054604051636396544960e01b81526001600160c01b03831660048201526001600160a01b0390911690636396544990602401600060405180830381600087803b1580156126d557600080fd5b6001600160a01b0381163b6147595760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084016108b2565b600080516020615f0683398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b61479183614e13565b60008251118061479e5750805b15613c9957610cb48383614222565b6060600080856001600160a01b0316856040516147ca9190615da5565b600060405180830381855af49150503d8060008114614805576040519150601f19603f3d011682016040523d82523d6000602084013e61480a565b606091505b509150915061481b86838387614e53565b9695505050505050565b600061487a826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316614ecc9092919063ffffffff16565b905080516000148061489b57508080602001905181019061489b9190615759565b613c995760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016108b2565b60006140eb6140e661491d670de0b6b3a76400006001600160c01b0388166158fd565b856001600160c01b0316855b60008061493684866158e9565b9050600083600281111561494c5761494c615612565b036149585790506140a8565b600183600281111561496c5761496c615612565b036149ab57600261497e600186615aa9565b61498891906158e9565b6149928587615dc1565b11156149a657806149a281615d8c565b9150505b6140eb565b6149b58486615dc1565b156140eb578061481b81615d8c565b60006001600160c01b038211156149ee5760405163f44398f560e01b815260040160405180910390fd5b5090565b6000836001600160c01b0316600003614a0d575060006140a8565b6029198360000b13614a46576002826002811115614a2d57614a2d615612565b14614a39576000614a3c565b60015b60ff1690506140a8565b8260000b606013614a6a5760405163f44398f560e01b815260040160405180910390fd5b614a75601284615dd5565b92506000614a858460000b614edb565b614a9090600a615edd565b905060008460000b1215614ab757614ab2856001600160c01b03168285614929565b614aca565b614aca816001600160c01b0387166158fd565b95945050505050565b600054610100900460ff166139725760405162461bcd60e51b81526004016108b290615c7c565b60405163095ea7b360e01b81526001600160a01b0383811660048301526000602483015284919082169063095ea7b390604401600060405180830381600087803b158015614b4757600080fd5b505af1158015614b5b573d6000803e3d6000fd5b5050604051636eb1769f60e11b81523060048201526001600160a01b0386811660248301528416925063dd62ed3e9150604401602060405180830381865afa158015614bab573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614bcf91906157e2565b15614c0e5760405162461bcd60e51b815260206004820152600f60248201526e0616c6c6f77616e6365206e6f74203608c1b60448201526064016108b2565b81600003614c1c5750505050565b60405163095ea7b360e01b81526001600160a01b038481166004830152602482018490526000919083169063095ea7b390604401600060405180830381600087803b158015614c6a57600080fd5b505af1925050508015614c7b575060015b15614cf757604051636eb1769f60e11b81523060048201526001600160a01b03858116602483015284919084169063dd62ed3e90604401602060405180830381865afa158015614ccf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614cf391906157e2565b1490505b806126e95760405163095ea7b360e01b81526001600160a01b038581166004830152600019602483015283169063095ea7b390604401600060405180830381600087803b158015614d4757600080fd5b505af1158015614d5b573d6000803e3d6000fd5b5050604051636eb1769f60e11b81523060048201526001600160a01b0387811660248301528693508516915063dd62ed3e90604401602060405180830381865afa158015614dad573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614dd191906157e2565b10156126e95760405162461bcd60e51b8152602060048201526011602482015270616c6c6f77616e6365206d697373696e6760781b60448201526064016108b2565b614e1c816146ec565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60608315614ec2578251600003614ebb576001600160a01b0385163b614ebb5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016108b2565b50816140eb565b6140eb8383614ef3565b60606140eb8484600085614f1d565b6000808212614eea57816127d2565b6127d282615ee9565b815115614f035781518083602001fd5b8060405162461bcd60e51b81526004016108b291906152a4565b606082471015614f7e5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b60648201526084016108b2565b600080866001600160a01b03168587604051614f9a9190615da5565b60006040518083038185875af1925050503d8060008114614fd7576040519150601f19603f3d011682016040523d82523d6000602084013e614fdc565b606091505b5091509150614fed87838387614e53565b979650505050505050565b6001600160a01b03811681146109bd57600080fd5b60006020828403121561501f57600080fd5b81356140a881614ff8565b6001600160c01b03811681146109bd57600080fd5b60006020828403121561505157600080fd5b81356140a88161502a565b60008083601f84011261506e57600080fd5b5081356001600160401b0381111561508557600080fd5b6020830191508360208260051b85010111156150a057600080fd5b9250929050565b600080602083850312156150ba57600080fd5b82356001600160401b038111156150d057600080fd5b6150dc8582860161505c565b90969095509350505050565b65ffffffffffff811681146109bd57600080fd5b60006020828403121561510e57600080fd5b81356140a8816150e8565b634e487b7160e01b600052604160045260246000fd5b604080519081016001600160401b038111828210171561515157615151615119565b60405290565b604051608081016001600160401b038111828210171561515157615151615119565b604051601f8201601f191681016001600160401b03811182821017156151a1576151a1615119565b604052919050565b600080604083850312156151bc57600080fd5b82356151c781614ff8565b915060208301356001600160401b038111156151e257600080fd5b8301601f810185136151f357600080fd5b80356001600160401b0381111561520c5761520c615119565b61521f601f8201601f1916602001615179565b81815286602083850101111561523457600080fd5b816020840160208301376000602083830101528093505050509250929050565b60005b8381101561526f578181015183820152602001615257565b50506000910152565b60008151808452615290816020860160208601615254565b601f01601f19169290920160200192915050565b6020815260006140a86020830184615278565b600060408284031280156152ca57600080fd5b506152d361512f565b82356152de8161502a565b815260208301356152ee8161502a565b60208201529392505050565b600081518084526020840193506020830160005b828110156153355781516001600160c01b031686526020958601959091019060010161530e565b5093949350505050565b80516040808452815190840181905260009160200190829060608601905b808310156153895783516001600160a01b0316825260208201915060208401935060018301925061535d565b506020858101518783038883015280518084529082019450910191506000905b808210156153d55783516001600160a01b031683526020830192506020840193506001820191506153a9565b509095945050505050565b6040815261540860408201845180516001600160c01b03908116835260209182015116910152565b6000602084015161542460808401826001600160a01b03169052565b5060408401516001600160a01b03811660a08401525060608401516001600160a01b03811660c08401525060808401516001600160a01b03811660e08401525060a08401516001600160a01b0381166101008401525060c08401516001600160c01b0381166101208401525060e08401516001600160c01b03811661014084015250610100840151610160808401526154c16101a08401826152fa565b9050610120850151603f19848303016101808501526154e082826152fa565b9150508281036020840152614aca818561533f565b6000602082016020835280845180835260408501915060408160051b86010192506020860160005b8281101561554e57603f19878603018452615539858351615278565b9450602093840193919091019060010161551d565b50929695505050505050565b600080600080600060a0868803121561557257600080fd5b853561557d81614ff8565b9450602086013561558d816150e8565b9350604086013561559d8161502a565b925060608601356155ad8161502a565b915060808601356155bd8161502a565b809150509295509295909350565b600281106109bd57600080fd5b6000602082840312156155ea57600080fd5b81356140a8816155cb565b60006020828403121561560757600080fd5b81516140a8816155cb565b634e487b7160e01b600052602160045260246000fd5b6002811061564657634e487b7160e01b600052602160045260246000fd5b9052565b602081016127d28284615628565b60006020828403121561566a57600080fd5b81516140a881614ff8565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b6000604082840312801561572057600080fd5b5061572961512f565b82516157348161502a565b815260208301516152ee8161502a565b8051801515811461575457600080fd5b919050565b60006020828403121561576b57600080fd5b6140a882615744565b60006020828403121561578657600080fd5b81516140a8816150e8565b634e487b7160e01b600052601160045260246000fd5b65ffffffffffff81811683821601908111156127d2576127d2615791565b6000602082840312156157d757600080fd5b81516140a88161502a565b6000602082840312156157f457600080fd5b5051919050565b6001600160c01b0381811683821601908111156127d2576127d2615791565b6001600160c01b0382811682821603908111156127d2576127d2615791565b805162ffffff8116811461575457600080fd5b6000604082840312801561585f57600080fd5b5061586861512f565b61587183615839565b81526152ee60208401615839565b634e487b7160e01b600052603260045260246000fd5b6000602082840312156158a757600080fd5b815160ff811681146140a857600080fd5b62ffffff81811683821601908111156127d2576127d2615791565b634e487b7160e01b600052601260045260246000fd5b6000826158f8576158f86158d3565b500490565b80820281158282048414176127d2576127d2615791565b60006001600160401b0382111561592d5761592d615119565b5060051b60200190565b600082601f83011261594857600080fd5b815161595b61595682615914565b615179565b8082825260208201915060208360051b86010192508583111561597d57600080fd5b602085015b838110156159a357805161599581614ff8565b835260209283019201615982565b5095945050505050565b6000602082840312156159bf57600080fd5b81516001600160401b038111156159d557600080fd5b8201604081850312156159e757600080fd5b6159ef61512f565b81516001600160401b03811115615a0557600080fd5b8201601f81018613615a1657600080fd5b8051615a2461595682615914565b8082825260208201915060208360051b850101925088831115615a4657600080fd5b6020840193505b82841015615a71578351615a6081614ff8565b825260209384019390910190615a4d565b845250505060208201516001600160401b03811115615a8f57600080fd5b615a9b86828501615937565b602083015250949350505050565b818103818111156127d2576127d2615791565b6000808335601e19843603018112615ad357600080fd5b8301803591506001600160401b03821115615aed57600080fd5b6020019150368190038213156150a057600080fd5b828482376000838201600081528351615b1f818360208801615254565b0195945050505050565b6000806000838503610120811215615b4057600080fd5b615b4985615744565b93506080601f1982011215615b5d57600080fd5b615b65615157565b6020860151615b7381614ff8565b81526040860151615b8381614ff8565b6020820152606086810151604083015260808088015191830191909152909350609f1982011215615bb357600080fd5b50615bbc615157565b60a0850151615bca8161502a565b815260c0850151615bda8161502a565b602082015260e0850151615bed8161502a565b6040820152610100850151615c018161502a565b606082015292959194509192509050565b600065ffffffffffff821680615c2a57615c2a615791565b6000190192915050565b60008060408385031215615c4757600080fd5b505080516020909101519092909150565b8051602080830151919081101561084f5760001960209190910360031b1b16919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6101208101615cec8286615628565b83516001600160a01b03908116602084810191909152808601519091166040808501919091528086015160608086019190915295860151608085015284516001600160c01b0390811660a086015291850151821660c0850152840151811660e0840152929093015190911661010090910152919050565b600065ffffffffffff821665ffffffffffff8103615d8357615d83615791565b60010192915050565b600060018201615d9e57615d9e615791565b5060010190565b60008251615db7818460208701615254565b9190910192915050565b600082615dd057615dd06158d3565b500690565b600082810b9082900b03607f198112607f821317156127d2576127d2615791565b6001815b6001841115615e3157808504811115615e1557615e15615791565b6001841615615e2357908102905b60019390931c928002615dfa565b935093915050565b600082615e48575060016127d2565b81615e55575060006127d2565b8160018114615e6b5760028114615e7557615e91565b60019150506127d2565b60ff841115615e8657615e86615791565b50506001821b6127d2565b5060208310610133831016604e8410600b8410161715615eb4575081810a6127d2565b615ec16000198484615df6565b8060001904821115615ed557615ed5615791565b029392505050565b60006140a88383615e39565b6000600160ff1b8201615efe57615efe615791565b506000039056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212205c99abe84ae2a4a8e5b02a4d11a7e52819277e6123204cf516864685cc19661a64736f6c634300081c0033","optimization_enabled":true,"verified_twin_address_hash":null,"is_verified":true,"compiler_settings":{"evmVersion":"paris","libraries":{"contracts/p1/BackingManager.sol":{"RecollateralizationLibP1":"0xd595456ac36aab96cf9d10d1adf8c3b4576c7937"}},"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-10T11:35:17.786291Z","implementations":[],"proxy_type":null,"external_libraries":[{"name":"RecollateralizationLibP1","address_hash":"0xD595456AC36aab96CF9d10d1ADF8C3b4576C7937"}],"creation_bytecode":"0x60a06040523060805234801561001457600080fd5b50600054610100900460ff16158080156100355750600054600160ff909116105b8061004f5750303b15801561004f575060005460ff166001145b6100b65760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840160405180910390fd5b6000805460ff1916600117905580156100d9576000805461ff0019166101001790555b801561011f576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50608051615f82610157600039600081816109ca01528181610a0a015281816119fd01528181611a3d0152611ad00152615f826000f3fe6080604052600436106101d85760003560e01c806372fb729811610102578063b9bebb0411610095578063d50e7a7011610064578063d50e7a7014610527578063dffeadd0146105a2578063e7227de6146105c2578063f4ae1474146105e957600080fd5b8063b9bebb0414610527578063bcaeb7b914610543578063c76aeb1214610563578063cb9414f81461058257600080fd5b8063a9f752e5116100d1578063a9f752e514610483578063ac9650d8146104b9578063adaef42c146104e6578063b51f8f881461050657600080fd5b806372fb7298146103ff5780637cbf6db21461042d5780638767e6381461044d57806398026d941461046357600080fd5b806336a02f571161017a5780634f1ef286116101495780634f1ef2861461038057806352d1902d1461039357806354fd4d50146103b65780637162c797146103ea57600080fd5b806336a02f571461030b578063372500ab1461032b5780633854430c14610340578063386eafd91461036057600080fd5b806312701397116101b6578063127013971461027b57806312d5025a1461029c5780632bca33e9146102bc5780633659cfe6146102eb57600080fd5b80630db3d42c146101dd5780630e0264d11461022157806310e4d36b14610259575b600080fd5b3480156101e957600080fd5b5060fd5461020490600160301b90046001600160c01b031681565b6040516001600160c01b0390911681526020015b60405180910390f35b34801561022d57600080fd5b5061024161023c36600461500d565b610609565b6040516001600160a01b039091168152602001610218565b34801561026557600080fd5b5061027961027436600461503f565b610855565b005b34801561028757600080fd5b5061013554610204906001600160c01b031681565b3480156102a857600080fd5b506102796102b736600461500d565b610926565b3480156102c857600080fd5b506102d46301e1338081565b60405165ffffffffffff9091168152602001610218565b3480156102f757600080fd5b5061027961030636600461500d565b6109c0565b34801561031757600080fd5b5061027961032636600461503f565b610a9c565b34801561033757600080fd5b50610279610b6c565b34801561034c57600080fd5b5061027961035b3660046150a7565b610cba565b34801561036c57600080fd5b5061027961037b3660046150fc565b61191f565b61027961038e3660046151a9565b6119f3565b34801561039f57600080fd5b506103a8611ac3565b604051908152602001610218565b3480156103c257600080fd5b5060408051808201825260058152640342e322e360dc1b6020820152905161021891906152a4565b3480156103f657600080fd5b50610279611b76565b34801561040b57600080fd5b5061041f61041a3660046152b7565b612028565b6040516102189291906153e0565b34801561043957600080fd5b5060fe54610204906001600160c01b031681565b34801561045957600080fd5b506103a860ff5481565b34801561046f57600080fd5b5061027961047e36600461500d565b612487565b34801561048f57600080fd5b5061024161049e36600461500d565b60fc602052600090815260409020546001600160a01b031681565b3480156104c557600080fd5b506104d96104d43660046150a7565b6126f0565b60405161021891906154f5565b3480156104f257600080fd5b5061027961050136600461500d565b6127d8565b34801561051257600080fd5b506102046c01431e0fae6d7217caa000000081565b34801561053357600080fd5b50610204670de0b6b3a764000081565b34801561054f57600080fd5b5061027961055e36600461555a565b612928565b34801561056f57600080fd5b5060fd546102d49065ffffffffffff1681565b34801561058e57600080fd5b5061027961059d36600461503f565b612a63565b3480156105ae57600080fd5b50609754610241906001600160a01b031681565b3480156105ce57600080fd5b50610134546102d490600160a01b900465ffffffffffff1681565b3480156105f557600080fd5b506102796106043660046155d8565b612b49565b6001600160a01b03811660009081526101386020526040812080546001600160c01b031916905561063982613539565b90506000816001600160a01b031663c872da3c6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561067b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061069f91906155f5565b90504261013760008360018111156106b9576106b9615612565b60018111156106ca576106ca615612565b815260208101919091526040016000205465ffffffffffff1611156107435742610137600083600181111561070157610701615612565b600181111561071257610712615612565b815260200190815260200160002060006101000a81548165ffffffffffff021916908365ffffffffffff1602179055505b6001600160a01b038216330361084f57306001600160a01b031663f4ae1474836001600160a01b031663c872da3c6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107a0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107c491906155f5565b6040518263ffffffff1660e01b81526004016107e0919061564a565b600060405180830381600087803b1580156107fa57600080fd5b505af192505050801561080b575060015b61084f573d808015610839576040519150601f19603f3d011682016040523d82523d6000602084013e61083e565b606091505b50805160000361084d57600080fd5b505b50919050565b61085d61388b565b670de0b6b3a76400006001600160c01b03821611156108bb5760405162461bcd60e51b815260206004820152601560248201527434b73b30b634b2103130b1b5b4b733a13ab33332b960591b60448201526064015b60405180910390fd5b61013554604080516001600160c01b03928316815291831660208301527f4ec8ac3ba3ecc0b9d7690e98f4bf8f5c70b8f2a9b4326c757b44ba3d19c18796910160405180910390a161013580546001600160c01b0319166001600160c01b0392909216919091179055565b6101386000826001600160a01b031663457100746040518163ffffffff1660e01b8152600401602060405180830381865afa158015610969573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061098d9190615658565b6001600160a01b03168152602081019190915260400160002080546001600160c01b03191690556109bd81613974565b50565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163003610a085760405162461bcd60e51b81526004016108b290615675565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316610a51600080516020615f06833981519152546001600160a01b031690565b6001600160a01b031614610a775760405162461bcd60e51b81526004016108b2906156c1565b610a8081613c17565b604080516000808252602082019092526109bd91839190613c66565b610aa461388b565b6c01431e0fae6d7217caa00000006001600160c01b0382161115610b035760405162461bcd60e51b8152602060048201526016602482015275696e76616c6964206d696e5472616465566f6c756d6560501b60448201526064016108b2565b60fe54604080516001600160c01b03928316815291831660208301527f1dec1ae9fd64ef0d8a6b130d853a8ab21d337625027cc60c63028f3d383495dc910160405180910390a160fe80546001600160c01b0319166001600160c01b0392909216919091179055565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610bbc57600080fd5b505af1158015610bd0573d6000803e3d6000fd5b50505050610bdc613dd6565b60975460408051634bcebf4360e11b81529051610c50926001600160a01b03169163979d7e869160048083019260209291908290030181865afa158015610c27573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c4b9190615658565b613e9a565b609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610ca057600080fd5b505af1158015610cb4573d6000803e3d6000fd5b50505050565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610d0a57600080fd5b505af1158015610d1e573d6000803e3d6000fd5b50505050610d2a613dd6565b610d66828280806020026020016040519081016040528093929190818152602001838360200280828437600092019190915250613fab92505050565b610da55760405162461bcd60e51b815260206004820152601060248201526f6475706c696361746520746f6b656e7360801b60448201526064016108b2565b61012d60009054906101000a90046001600160a01b03166001600160a01b031663f8ac93e86040518163ffffffff1660e01b8152600401600060405180830381600087803b158015610df657600080fd5b505af1158015610e0a573d6000803e3d6000fd5b505061012e54604051635523caaf60e11b8152306004820152600093506001600160a01b03909116915063aa47955e906024016040805180830381865afa158015610e59573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e7d919061570d565b60fd5490915065ffffffffffff1615610ec55760405162461bcd60e51b815260206004820152600a6024820152693a3930b2329037b832b760b11b60448201526064016108b2565b61012e60009054906101000a90046001600160a01b03166001600160a01b031663a094a0316040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f19573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f3d9190615759565b610f7c5760405162461bcd60e51b815260206004820152601060248201526f6261736b6574206e6f7420726561647960801b60448201526064016108b2565b61013460149054906101000a900465ffffffffffff1661012e60009054906101000a90046001600160a01b03166001600160a01b031663b80777ea6040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fe6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061100a9190615774565b61101491906157a7565b65ffffffffffff1642101561105d5760405162461bcd60e51b815260206004820152600f60248201526e1d1c98591a5b99c819195b185e5959608a1b60448201526064016108b2565b61013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110b1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d591906157c5565b6001600160c01b031681600001516001600160c01b031610156111305760405162461bcd60e51b81526020600482015260136024820152721d5b99195c98dbdb1b185d195c985b1a5e9959606a1b60448201526064016108b2565b610131546040516370a0823160e01b81523060048201526001600160a01b03909116906370a0823190602401602060405180830381865afa158015611179573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061119d91906157e2565b156112975761013254610131546040516370a0823160e01b815230600482015261122d926001600160a01b039081169216906370a0823190602401602060405180830381865afa1580156111f5573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061121991906157e2565b610131546001600160a01b03169190614037565b61013260009054906101000a90046001600160a01b03166001600160a01b031663296130866040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561127e57600080fd5b505af1158015611292573d6000803e3d6000fd5b505050505b610135546000906112ce906112bd906001600160c01b0316670de0b6b3a76400006157fb565b83516001600160c01b03169061409a565b905061013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa158015611324573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061134891906157c5565b6001600160c01b0316816001600160c01b0316111561143c576101305460408051637121c27360e01b815290516001600160a01b039092169163aeb14bf6918391637121c273916004808201926020929091908290030181865afa1580156113b4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113d891906157c5565b6113e2908461581a565b6040516001600160e01b031960e084901b1681526001600160c01b039091166004820152602401600060405180830381600087803b15801561142357600080fd5b505af1158015611437573d6000803e3d6000fd5b505050505b610135546000906114e990611462906001600160c01b0316670de0b6b3a76400006157fb565b61013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa1580156114b6573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114da91906157c5565b6001600160c01b0316906140af565b61012f546040805163601c51c760e11b8152815193945087936000936001600160a01b03169263c038a38e92600480820193918290030181865afa158015611535573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611559919061584c565b905060005b828110156118b95761012d546000906001600160a01b031663cde2be8a8a8a8581811061158d5761158d61587f565b90506020020160208101906115a2919061500d565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156115e6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061160a9190615658565b61012e549091506000906116c7906001600160a01b031663a5a5828c8c8c878181106116385761163861587f565b905060200201602081019061164d919061500d565b6040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa158015611691573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116b591906157c5565b6001600160c01b0388169060026140b9565b604051632ac07b9560e11b81523060048201529091506000906001600160a01b03841690635580f72a90602401602060405180830381865afa158015611711573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061173591906157c5565b90506001600160c01b0382811690821611156118ad5760006117d4846001600160a01b0316633cb5d3796040518163ffffffff1660e01b8152600401602060405180830381865afa15801561178e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906117b29190615895565b6117c56001600160c01b038516866140f3565b6001600160c01b0316906140ff565b90506000866020015187600001516117ec91906158b8565b6117fb9062ffffff16836158e9565b90508060000361180f5750505050506118b1565b602087015162ffffff161561187b5761013354602088015161187b916001600160a01b0316906118449062ffffff16846158fd565b8f8f8a8181106118565761185661587f565b905060200201602081019061186b919061500d565b6001600160a01b03169190614037565b865162ffffff16156118aa576101345487516118aa916001600160a01b0316906118449062ffffff16846158fd565b50505b5050505b60010161155e565b5050609754604080516331cfec0560e01b815290516001600160a01b0390921695506331cfec05945060048082019450600093509082900301818387803b15801561190357600080fd5b505af1158015611917573d6000803e3d6000fd5b505050505050565b61192761388b565b6301e1338065ffffffffffff8216111561197a5760405162461bcd60e51b8152602060048201526014602482015273696e76616c69642074726164696e6744656c617960601b60448201526064016108b2565b610134546040805165ffffffffffff600160a01b9093048316815291831660208301527f4af929ab8885bbdcb8b01903439a99e3fb33354657d151119f731b01db793bdb910160405180910390a1610134805465ffffffffffff909216600160a01b0265ffffffffffff60a01b19909216919091179055565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163003611a3b5760405162461bcd60e51b81526004016108b290615675565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316611a84600080516020615f06833981519152546001600160a01b031690565b6001600160a01b031614611aaa5760405162461bcd60e51b81526004016108b2906156c1565b611ab382613c17565b611abf82826001613c66565b5050565b6000306001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614611b635760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c000000000000000060648201526084016108b2565b50600080516020615f0683398151915290565b609760009054906101000a90046001600160a01b03166001600160a01b031663979d7e866040518163ffffffff1660e01b8152600401602060405180830381865afa158015611bc9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611bed9190615658565b61012d80546001600160a01b0319166001600160a01b0392831617905560975460408051632f2439b160e01b815290519190921691632f2439b19160048083019260209291908290030181865afa158015611c4c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c709190615658565b61012e80546001600160a01b0319166001600160a01b03928316179055609754604080516317fc212560e31b81529051919092169163bfe109289160048083019260209291908290030181865afa158015611ccf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611cf39190615658565b61012f80546001600160a01b0319166001600160a01b03928316179055609754604080516320632fb960e11b8152905191909216916340c65f729160048083019260209291908290030181865afa158015611d52573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611d769190615658565b61013080546001600160a01b0319166001600160a01b039283161790556097546040805163c99dc3dd60e01b81529051919092169163c99dc3dd9160048083019260209291908290030181865afa158015611dd5573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611df99190615658565b61013180546001600160a01b0319166001600160a01b0392831617905560975460408051634780a5e560e01b815290519190921691634780a5e59160048083019260209291908290030181865afa158015611e58573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611e7c9190615658565b61013280546001600160a01b0319166001600160a01b0392831617905560975460408051635313676360e01b81529051919092169163531367639160048083019260209291908290030181865afa158015611edb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611eff9190615658565b61013380546001600160a01b0319166001600160a01b03928316179055609754604080516320df862760e11b8152905191909216916341bf0c4e9160048083019260209291908290030181865afa158015611f5e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f829190615658565b61013480546001600160a01b0319166001600160a01b039283161790556097546040805163656e96e160e01b81529051919092169163656e96e19160048083019260209291908290030181865afa158015611fe1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906120059190615658565b61013680546001600160a01b0319166001600160a01b0392909216919091179055565b60408051610180810182526000610140820181815261016083018290528252602080830182905282840182905260608084018390526080840183905260a0840183905260c0840183905260e0840183905261010084018190526101208401819052845180860186528181529182015261012d548451635ab1bd5360e01b81529451939491936001600160a01b0390911692635ab1bd5392600480820193918290030181865afa1580156120df573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261210791908101906159ad565b83835261012e546001600160a01b03908116602085015261012d548116604085015261013254811660608501526101315481166080850152610130541660a084015260fe546001600160c01b0390811660c085015260fd54600160301b90041660e08401528051519091506001600160401b0381111561218957612189615119565b6040519080825280602002602001820160405280156121b2578160200160208202803683370190505b506101008301528051516001600160401b038111156121d3576121d3615119565b6040519080825280602002602001820160405280156121fc578160200160208202803683370190505b5061012083015260005b815151811015612481576000826000015182815181106122285761222861587f565b6020026020010151905060008360200151838151811061224a5761224a61587f565b602090810291909101015161012e5460405163d3252db560e01b81526001600160a01b038581166004830152808416602483015292935091169063d3252db590604401602060405180830381865afa1580156122aa573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122ce91906157c5565b85610100015184815181106122e5576122e561587f565b6001600160c01b039283166020918202929092018101919091526001600160a01b038481166000908152610138909252604091829020549151632ac07b9560e11b81523060048201529190921691831690635580f72a90602401602060405180830381865afa15801561235c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061238091906157c5565b61238a91906157fb565b85610120015184815181106123a1576123a161587f565b6001600160c01b0390921660209283029190910190910152610131546001600160a01b03908116908316036124775761013254604051632ac07b9560e11b81526001600160a01b03918216600482015290821690635580f72a90602401602060405180830381865afa15801561241b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061243f91906157c5565b85610120015184815181106124565761245661587f565b6020026020010181815161246a91906157fb565b6001600160c01b03169052505b5050600101612206565b50915091565b609760009054906101000a90046001600160a01b03166001600160a01b031663054f7d9c6040518163ffffffff1660e01b8152600401602060405180830381865afa1580156124da573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906124fe9190615759565b156125345760405162461bcd60e51b8152602060048201526006602482015265333937bd32b760d11b60448201526064016108b2565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561258457600080fd5b505af1158015612598573d6000803e3d6000fd5b505061012d5460405163c3c5a54760e01b81526001600160a01b038581166004830152909116925063c3c5a5479150602401602060405180830381865afa1580156125e7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061260b9190615759565b61264c5760405162461bcd60e51b8152602060048201526012602482015271195c98cc8c081d5b9c9959da5cdd195c995960721b60448201526064016108b2565b61013054612668906001600160a01b038381169116600061410d565b61013054612685906001600160a01b03838116911660001961410d565b609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156126d557600080fd5b505af11580156126e9573d6000803e3d6000fd5b5050505050565b604080516000815260208101909152606090826001600160401b0381111561271a5761271a615119565b60405190808252806020026020018201604052801561274d57816020015b60608152602001906001900390816127385790505b50915060005b838110156127cf576127aa308686848181106127715761277161587f565b90506020028101906127839190615abc565b8560405160200161279693929190615b02565b604051602081830303815290604052614222565b8382815181106127bc576127bc61587f565b6020908102919091010152600101612753565b50505b92915050565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561282857600080fd5b505af115801561283c573d6000803e3d6000fd5b50505050612848613dd6565b60975460408051634bcebf4360e11b81529051612685926001600160a01b03169163979d7e869160048083019260209291908290030181865afa158015612893573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906128b79190615658565b6040516366f15f4560e11b81526001600160a01b038481166004830152919091169063cde2be8a90602401602060405180830381865afa1580156128ff573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906129239190615658565b614247565b600054610100900460ff16158080156129485750600054600160ff909116105b806129625750303b158015612962575060005460ff166001145b6129c55760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016108b2565b6000805460ff1916600117905580156129e8576000805461ff0019166101001790555b6129f1866142ad565b6129fc86848461434b565b612a04611b76565b612a0d8561191f565b612a1684610855565b8015611917576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a1505050505050565b612a6b61388b565b670de0b6b3a76400006001600160c01b0382161115612acc5760405162461bcd60e51b815260206004820152601860248201527f696e76616c6964206d61785472616465536c697070616765000000000000000060448201526064016108b2565b60fd54604080516001600160c01b03600160301b9093048316815291831660208301527f58d1f6b92b372d2913abb309ec9503acc2a53ed508ec34f478d7aeab07760f99910160405180910390a160fd80546001600160c01b03909216600160301b026601000000000000600160f01b0319909216919091179055565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b158015612b9957600080fd5b505af1158015612bad573d6000803e3d6000fd5b50505050612bb9613dd6565b61012d60009054906101000a90046001600160a01b03166001600160a01b031663f8ac93e86040518163ffffffff1660e01b8152600401600060405180830381600087803b158015612c0a57600080fd5b505af1158015612c1e573d6000803e3d6000fd5b50505050306001600160a01b0316612c333390565b6001600160a01b03161480612c875750426101376000836001811115612c5b57612c5b615612565b6001811115612c6c57612c6c615612565b815260208101919091526040016000205465ffffffffffff16105b612cc95760405162461bcd60e51b8152602060048201526013602482015272616c726561647920726562616c616e63696e6760681b60448201526064016108b2565b60fd5465ffffffffffff1615612d0e5760405162461bcd60e51b815260206004820152600a6024820152693a3930b2329037b832b760b11b60448201526064016108b2565b61012e60009054906101000a90046001600160a01b03166001600160a01b031663a094a0316040518163ffffffff1660e01b8152600401602060405180830381865afa158015612d62573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612d869190615759565b612dc55760405162461bcd60e51b815260206004820152601060248201526f6261736b6574206e6f7420726561647960801b60448201526064016108b2565b61013460149054906101000a900465ffffffffffff1661012e60009054906101000a90046001600160a01b03166001600160a01b031663b80777ea6040518163ffffffff1660e01b8152600401602060405180830381865afa158015612e2f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e539190615774565b612e5d91906157a7565b65ffffffffffff16421015612ea65760405162461bcd60e51b815260206004820152600f60248201526e1d1c98591a5b99c819195b185e5959608a1b60448201526064016108b2565b61012e54604051635523caaf60e11b81523060048201526000916001600160a01b03169063aa47955e906024016040805180830381865afa158015612eef573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f13919061570d565b905061013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa158015612f69573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f8d91906157c5565b6001600160c01b031681600001516001600160c01b031610612fea5760405162461bcd60e51b8152602060048201526016602482015275185b1c9958591e4818dbdb1b185d195c985b1a5e995960521b60448201526064016108b2565b610130546040516370a0823160e01b81523060048201526000916001600160a01b0316906370a0823190602401602060405180830381865afa158015613034573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061305891906157e2565b905061306760646127106158fd565b81106130cd5761013054604051637c8595ff60e11b8152600481018390526001600160a01b039091169063f90b2bfe90602401600060405180830381600087803b1580156130b457600080fd5b505af11580156130c8573d6000803e3d6000fd5b505050505b61013060009054906101000a90046001600160a01b03166001600160a01b0316637121c2736040518163ffffffff1660e01b8152600401602060405180830381865afa158015613121573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061314591906157c5565b6001600160c01b031682600001516001600160c01b031610613168575050612685565b60008061317484612028565b91509150600080600073d595456ac36aab96cf9d10d1adf8c3b4576c793763ba00555a86866040518363ffffffff1660e01b81526004016131b69291906153e0565b61012060405180830381865af41580156131d4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906131f89190615b29565b92509250925082156134e257600082600001516001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa158015613248573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061326c9190615658565b610131549091506001600160a01b0390811690821603613378576040516370a0823160e01b81523060048201526000906001600160a01b038316906370a0823190602401602060405180830381865afa1580156132cd573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906132f191906157e2565b90508084604001511115613376576101325460408501516001600160a01b039091169063a439622f90613325908490615aa9565b6040518263ffffffff1660e01b815260040161334391815260200190565b600060405180830381600087803b15801561335d57600080fd5b505af1158015613371573d6000803e3d6000fd5b505050505b505b60006133858a8585614406565b9050806001600160a01b0316633197cbb66040518163ffffffff1660e01b8152600401602060405180830381865afa1580156133c5573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133e99190615774565b61013760008c600181111561340057613400615612565b600181111561341157613411615612565b815260200190815260200160002060006101000a81548165ffffffffffff021916908365ffffffffffff160217905550806001600160a01b0316633f407b846040518163ffffffff1660e01b8152600401602060405180830381865afa15801561347f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906134a391906157c5565b6001600160a01b039290921660009081526101386020526040902080546001600160c01b0319166001600160c01b0390931692909217909155506134ed565b86516134ed90614685565b5050609754604080516331cfec0560e01b815290516001600160a01b0390921696506331cfec059550600480820195506000945091925082900301818387803b1580156126d557600080fd5b60975460408051630a7a6f6960e11b815290516000926001600160a01b0316916314f4ded2916004808301928692919082900301818387803b15801561357e57600080fd5b505af1158015613592573d6000803e3d6000fd5b505050506001600160a01b03828116600090815260fc6020526040902054169050806135f05760405162461bcd60e51b815260206004820152600d60248201526c3737903a3930b2329037b832b760991b60448201526064016108b2565b806001600160a01b031663faf7ba6a6040518163ffffffff1660e01b8152600401602060405180830381865afa15801561362e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906136529190615759565b6136925760405162461bcd60e51b815260206004820152601160248201527018d85b9b9bdd081cd95d1d1b19481e595d607a1b60448201526064016108b2565b6001600160a01b038216600090815260fc6020526040812080546001600160a01b031916905560fd805465ffffffffffff16916136ce83615c12565b91906101000a81548165ffffffffffff021916908365ffffffffffff16021790555050600080826001600160a01b03166311da60b46040518163ffffffff1660e01b815260040160408051808303816000875af1158015613733573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906137579190615c34565b91509150826001600160a01b031663a6f2ae3a6040518163ffffffff1660e01b8152600401602060405180830381865afa158015613799573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906137bd9190615658565b6001600160a01b0316846001600160a01b0316846001600160a01b03167f058fb1fa484531f400806f666315faf1a45941db93ba069405882b78ba40dc878585604051613814929190918252602082015260400190565b60405180910390a45050609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561386e57600080fd5b505af1158015613882573d6000803e3d6000fd5b50505050919050565b60975460408051808201909152600581526427aba722a960d91b60208201526001600160a01b03909116906391d14854906138c590615c58565b336040516001600160e01b031960e085901b16815260048101929092526001600160a01b03166024820152604401602060405180830381865afa158015613910573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906139349190615759565b6139725760405162461bcd60e51b815260206004820152600f60248201526e676f7665726e616e6365206f6e6c7960881b60448201526064016108b2565b565b609760009054906101000a90046001600160a01b03166001600160a01b03166314f4ded26040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156139c457600080fd5b505af11580156139d8573d6000803e3d6000fd5b505050506139e461388b565b6000816001600160a01b031663457100746040518163ffffffff1660e01b8152600401602060405180830381865afa158015613a24573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613a489190615658565b6001600160a01b03818116600090815260fc6020526040902054919250838116911614613aa55760405162461bcd60e51b815260206004820152600b60248201526a77726f6e6720747261646560a81b60448201526064016108b2565b6001600160a01b038116600090815260fc6020526040812080546001600160a01b031916905560fd805465ffffffffffff1691613ae183615c12565b91906101000a81548165ffffffffffff021916908365ffffffffffff16021790555050816001600160a01b031663a6f2ae3a6040518163ffffffff1660e01b8152600401602060405180830381865afa158015613b42573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613b669190615658565b6001600160a01b0316816001600160a01b0316836001600160a01b03167f058fb1fa484531f400806f666315faf1a45941db93ba069405882b78ba40dc87600080604051613bbe929190918252602082015260400190565b60405180910390a450609760009054906101000a90046001600160a01b03166001600160a01b03166331cfec056040518163ffffffff1660e01b8152600401600060405180830381600087803b1580156126d557600080fd5b6097546001600160a01b0316336001600160a01b0316146109bd5760405162461bcd60e51b81526020600482015260096024820152686d61696e206f6e6c7960b81b60448201526064016108b2565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff1615613c9e57613c99836146ec565b505050565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015613cf8575060408051601f3d908101601f19168201909252613cf5918101906157e2565b60015b613d5b5760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b60648201526084016108b2565b600080516020615f068339815191528114613dca5760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b60648201526084016108b2565b50613c99838383614788565b609760009054906101000a90046001600160a01b03166001600160a01b03166398f73e526040518163ffffffff1660e01b8152600401602060405180830381865afa158015613e29573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e4d9190615759565b156139725760405162461bcd60e51b815260206004820152601860248201527f66726f7a656e206f722074726164696e6720706175736564000000000000000060448201526064016108b2565b6000816001600160a01b0316635ab1bd536040518163ffffffff1660e01b8152600401600060405180830381865afa158015613eda573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052613f0291908101906159ad565b60208101515190915060005b81811015610cb4576040805160048152602481018252602080820180516001600160e01b031663372500ab60e01b179052825180840190935260148352731c995dd85c991cc818db185a5b4819985a5b195960621b838201528501518051613fa293919085908110613f8257613f8261587f565b60200260200101516001600160a01b03166147ad9092919063ffffffff16565b50600101613f0e565b805160009060015b8181101561402d5760005b8181101561402457848181518110613fd857613fd861587f565b60200260200101516001600160a01b0316858381518110613ffb57613ffb61587f565b60200260200101516001600160a01b03160361401c57506000949350505050565b600101613fbe565b50600101613fb3565b5060019392505050565b6040516001600160a01b038316602482015260448101829052613c9990849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152614825565b60006140a8838360006148fa565b9392505050565b60006140a8838360015b60006140eb6140e66140d76001600160c01b038087169088166158fd565b670de0b6b3a764000085614929565b6149c4565b949350505050565b60006140a8828461581a565b60006140a8838360006149f2565b8015806141875750604051636eb1769f60e11b81523060048201526001600160a01b03838116602483015284169063dd62ed3e90604401602060405180830381865afa158015614161573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061418591906157e2565b155b6141f25760405162461bcd60e51b815260206004820152603660248201527f5361666545524332303a20617070726f76652066726f6d206e6f6e2d7a65726f60448201527520746f206e6f6e2d7a65726f20616c6c6f77616e636560501b60648201526084016108b2565b6040516001600160a01b038316602482015260448101829052613c9990849063095ea7b360e01b90606401614063565b60606140a88383604051806060016040528060278152602001615f26602791396147ad565b6040805160048152602481018252602080820180516001600160e01b031663372500ab60e01b179052825180840190935260148352731c995dd85c991cc818db185a5b4819985a5b195960621b90830152611abf916001600160a01b03841691906147ad565b600054610100900460ff166142d45760405162461bcd60e51b81526004016108b290615c7c565b6001600160a01b0381166143215760405162461bcd60e51b81526020600482015260146024820152736d61696e206973207a65726f206164647265737360601b60448201526064016108b2565b614329614ad3565b609780546001600160a01b0319166001600160a01b0392909216919091179055565b600054610100900460ff166143725760405162461bcd60e51b81526004016108b290615c7c565b826001600160a01b031663abff01106040518163ffffffff1660e01b8152600401602060405180830381865afa1580156143b0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906143d49190615658565b60fb80546001600160a01b0319166001600160a01b03929092169190911790556143fd82612a63565b613c9981610a9c565b60008083600001516001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa15801561444b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061446f9190615658565b6001600160a01b03808216600090815260fc6020526040902054919250161561449a5761449a615cc7565b60fb5460408501516144b99183916001600160a01b0390911690614afa565b60fb546040516314bf206560e21b81526001600160a01b03909116906352fc8194906144ed90889088908890600401615cdd565b6020604051808303816000875af115801561450c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906145309190615658565b6001600160a01b03828116600090815260fc6020526040812080546001600160a01b0319169284169290921790915560fd8054929450916145789065ffffffffffff16615d63565b91906101000a81548165ffffffffffff021916908365ffffffffffff16021790555060ff600081546145a990615d8c565b9190508190555083602001516001600160a01b031663785e9e866040518163ffffffff1660e01b8152600401602060405180830381865afa1580156145f2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906146169190615658565b6001600160a01b0316816001600160a01b0316836001600160a01b03167ff18b757d93c36d059284838a0328b06d8eb30d7214ffadde3266465a0006f6b387604001518860600151604051614675929190918252602082015260400190565b60405180910390a4509392505050565b60fd5465ffffffffffff161561469d5761469d615cc7565b61013054604051636396544960e01b81526001600160c01b03831660048201526001600160a01b0390911690636396544990602401600060405180830381600087803b1580156126d557600080fd5b6001600160a01b0381163b6147595760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084016108b2565b600080516020615f0683398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b61479183614e13565b60008251118061479e5750805b15613c9957610cb48383614222565b6060600080856001600160a01b0316856040516147ca9190615da5565b600060405180830381855af49150503d8060008114614805576040519150601f19603f3d011682016040523d82523d6000602084013e61480a565b606091505b509150915061481b86838387614e53565b9695505050505050565b600061487a826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316614ecc9092919063ffffffff16565b905080516000148061489b57508080602001905181019061489b9190615759565b613c995760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016108b2565b60006140eb6140e661491d670de0b6b3a76400006001600160c01b0388166158fd565b856001600160c01b0316855b60008061493684866158e9565b9050600083600281111561494c5761494c615612565b036149585790506140a8565b600183600281111561496c5761496c615612565b036149ab57600261497e600186615aa9565b61498891906158e9565b6149928587615dc1565b11156149a657806149a281615d8c565b9150505b6140eb565b6149b58486615dc1565b156140eb578061481b81615d8c565b60006001600160c01b038211156149ee5760405163f44398f560e01b815260040160405180910390fd5b5090565b6000836001600160c01b0316600003614a0d575060006140a8565b6029198360000b13614a46576002826002811115614a2d57614a2d615612565b14614a39576000614a3c565b60015b60ff1690506140a8565b8260000b606013614a6a5760405163f44398f560e01b815260040160405180910390fd5b614a75601284615dd5565b92506000614a858460000b614edb565b614a9090600a615edd565b905060008460000b1215614ab757614ab2856001600160c01b03168285614929565b614aca565b614aca816001600160c01b0387166158fd565b95945050505050565b600054610100900460ff166139725760405162461bcd60e51b81526004016108b290615c7c565b60405163095ea7b360e01b81526001600160a01b0383811660048301526000602483015284919082169063095ea7b390604401600060405180830381600087803b158015614b4757600080fd5b505af1158015614b5b573d6000803e3d6000fd5b5050604051636eb1769f60e11b81523060048201526001600160a01b0386811660248301528416925063dd62ed3e9150604401602060405180830381865afa158015614bab573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614bcf91906157e2565b15614c0e5760405162461bcd60e51b815260206004820152600f60248201526e0616c6c6f77616e6365206e6f74203608c1b60448201526064016108b2565b81600003614c1c5750505050565b60405163095ea7b360e01b81526001600160a01b038481166004830152602482018490526000919083169063095ea7b390604401600060405180830381600087803b158015614c6a57600080fd5b505af1925050508015614c7b575060015b15614cf757604051636eb1769f60e11b81523060048201526001600160a01b03858116602483015284919084169063dd62ed3e90604401602060405180830381865afa158015614ccf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614cf391906157e2565b1490505b806126e95760405163095ea7b360e01b81526001600160a01b038581166004830152600019602483015283169063095ea7b390604401600060405180830381600087803b158015614d4757600080fd5b505af1158015614d5b573d6000803e3d6000fd5b5050604051636eb1769f60e11b81523060048201526001600160a01b0387811660248301528693508516915063dd62ed3e90604401602060405180830381865afa158015614dad573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614dd191906157e2565b10156126e95760405162461bcd60e51b8152602060048201526011602482015270616c6c6f77616e6365206d697373696e6760781b60448201526064016108b2565b614e1c816146ec565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60608315614ec2578251600003614ebb576001600160a01b0385163b614ebb5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016108b2565b50816140eb565b6140eb8383614ef3565b60606140eb8484600085614f1d565b6000808212614eea57816127d2565b6127d282615ee9565b815115614f035781518083602001fd5b8060405162461bcd60e51b81526004016108b291906152a4565b606082471015614f7e5760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b60648201526084016108b2565b600080866001600160a01b03168587604051614f9a9190615da5565b60006040518083038185875af1925050503d8060008114614fd7576040519150601f19603f3d011682016040523d82523d6000602084013e614fdc565b606091505b5091509150614fed87838387614e53565b979650505050505050565b6001600160a01b03811681146109bd57600080fd5b60006020828403121561501f57600080fd5b81356140a881614ff8565b6001600160c01b03811681146109bd57600080fd5b60006020828403121561505157600080fd5b81356140a88161502a565b60008083601f84011261506e57600080fd5b5081356001600160401b0381111561508557600080fd5b6020830191508360208260051b85010111156150a057600080fd5b9250929050565b600080602083850312156150ba57600080fd5b82356001600160401b038111156150d057600080fd5b6150dc8582860161505c565b90969095509350505050565b65ffffffffffff811681146109bd57600080fd5b60006020828403121561510e57600080fd5b81356140a8816150e8565b634e487b7160e01b600052604160045260246000fd5b604080519081016001600160401b038111828210171561515157615151615119565b60405290565b604051608081016001600160401b038111828210171561515157615151615119565b604051601f8201601f191681016001600160401b03811182821017156151a1576151a1615119565b604052919050565b600080604083850312156151bc57600080fd5b82356151c781614ff8565b915060208301356001600160401b038111156151e257600080fd5b8301601f810185136151f357600080fd5b80356001600160401b0381111561520c5761520c615119565b61521f601f8201601f1916602001615179565b81815286602083850101111561523457600080fd5b816020840160208301376000602083830101528093505050509250929050565b60005b8381101561526f578181015183820152602001615257565b50506000910152565b60008151808452615290816020860160208601615254565b601f01601f19169290920160200192915050565b6020815260006140a86020830184615278565b600060408284031280156152ca57600080fd5b506152d361512f565b82356152de8161502a565b815260208301356152ee8161502a565b60208201529392505050565b600081518084526020840193506020830160005b828110156153355781516001600160c01b031686526020958601959091019060010161530e565b5093949350505050565b80516040808452815190840181905260009160200190829060608601905b808310156153895783516001600160a01b0316825260208201915060208401935060018301925061535d565b506020858101518783038883015280518084529082019450910191506000905b808210156153d55783516001600160a01b031683526020830192506020840193506001820191506153a9565b509095945050505050565b6040815261540860408201845180516001600160c01b03908116835260209182015116910152565b6000602084015161542460808401826001600160a01b03169052565b5060408401516001600160a01b03811660a08401525060608401516001600160a01b03811660c08401525060808401516001600160a01b03811660e08401525060a08401516001600160a01b0381166101008401525060c08401516001600160c01b0381166101208401525060e08401516001600160c01b03811661014084015250610100840151610160808401526154c16101a08401826152fa565b9050610120850151603f19848303016101808501526154e082826152fa565b9150508281036020840152614aca818561533f565b6000602082016020835280845180835260408501915060408160051b86010192506020860160005b8281101561554e57603f19878603018452615539858351615278565b9450602093840193919091019060010161551d565b50929695505050505050565b600080600080600060a0868803121561557257600080fd5b853561557d81614ff8565b9450602086013561558d816150e8565b9350604086013561559d8161502a565b925060608601356155ad8161502a565b915060808601356155bd8161502a565b809150509295509295909350565b600281106109bd57600080fd5b6000602082840312156155ea57600080fd5b81356140a8816155cb565b60006020828403121561560757600080fd5b81516140a8816155cb565b634e487b7160e01b600052602160045260246000fd5b6002811061564657634e487b7160e01b600052602160045260246000fd5b9052565b602081016127d28284615628565b60006020828403121561566a57600080fd5b81516140a881614ff8565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b6000604082840312801561572057600080fd5b5061572961512f565b82516157348161502a565b815260208301516152ee8161502a565b8051801515811461575457600080fd5b919050565b60006020828403121561576b57600080fd5b6140a882615744565b60006020828403121561578657600080fd5b81516140a8816150e8565b634e487b7160e01b600052601160045260246000fd5b65ffffffffffff81811683821601908111156127d2576127d2615791565b6000602082840312156157d757600080fd5b81516140a88161502a565b6000602082840312156157f457600080fd5b5051919050565b6001600160c01b0381811683821601908111156127d2576127d2615791565b6001600160c01b0382811682821603908111156127d2576127d2615791565b805162ffffff8116811461575457600080fd5b6000604082840312801561585f57600080fd5b5061586861512f565b61587183615839565b81526152ee60208401615839565b634e487b7160e01b600052603260045260246000fd5b6000602082840312156158a757600080fd5b815160ff811681146140a857600080fd5b62ffffff81811683821601908111156127d2576127d2615791565b634e487b7160e01b600052601260045260246000fd5b6000826158f8576158f86158d3565b500490565b80820281158282048414176127d2576127d2615791565b60006001600160401b0382111561592d5761592d615119565b5060051b60200190565b600082601f83011261594857600080fd5b815161595b61595682615914565b615179565b8082825260208201915060208360051b86010192508583111561597d57600080fd5b602085015b838110156159a357805161599581614ff8565b835260209283019201615982565b5095945050505050565b6000602082840312156159bf57600080fd5b81516001600160401b038111156159d557600080fd5b8201604081850312156159e757600080fd5b6159ef61512f565b81516001600160401b03811115615a0557600080fd5b8201601f81018613615a1657600080fd5b8051615a2461595682615914565b8082825260208201915060208360051b850101925088831115615a4657600080fd5b6020840193505b82841015615a71578351615a6081614ff8565b825260209384019390910190615a4d565b845250505060208201516001600160401b03811115615a8f57600080fd5b615a9b86828501615937565b602083015250949350505050565b818103818111156127d2576127d2615791565b6000808335601e19843603018112615ad357600080fd5b8301803591506001600160401b03821115615aed57600080fd5b6020019150368190038213156150a057600080fd5b828482376000838201600081528351615b1f818360208801615254565b0195945050505050565b6000806000838503610120811215615b4057600080fd5b615b4985615744565b93506080601f1982011215615b5d57600080fd5b615b65615157565b6020860151615b7381614ff8565b81526040860151615b8381614ff8565b6020820152606086810151604083015260808088015191830191909152909350609f1982011215615bb357600080fd5b50615bbc615157565b60a0850151615bca8161502a565b815260c0850151615bda8161502a565b602082015260e0850151615bed8161502a565b6040820152610100850151615c018161502a565b606082015292959194509192509050565b600065ffffffffffff821680615c2a57615c2a615791565b6000190192915050565b60008060408385031215615c4757600080fd5b505080516020909101519092909150565b8051602080830151919081101561084f5760001960209190910360031b1b16919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6101208101615cec8286615628565b83516001600160a01b03908116602084810191909152808601519091166040808501919091528086015160608086019190915295860151608085015284516001600160c01b0390811660a086015291850151821660c0850152840151811660e0840152929093015190911661010090910152919050565b600065ffffffffffff821665ffffffffffff8103615d8357615d83615791565b60010192915050565b600060018201615d9e57615d9e615791565b5060010190565b60008251615db7818460208701615254565b9190910192915050565b600082615dd057615dd06158d3565b500690565b600082810b9082900b03607f198112607f821317156127d2576127d2615791565b6001815b6001841115615e3157808504811115615e1557615e15615791565b6001841615615e2357908102905b60019390931c928002615dfa565b935093915050565b600082615e48575060016127d2565b81615e55575060006127d2565b8160018114615e6b5760028114615e7557615e91565b60019150506127d2565b60ff841115615e8657615e86615791565b50506001821b6127d2565b5060208310610133831016604e8410600b8410161715615eb4575081810a6127d2565b615ec16000198484615df6565b8060001904821115615ed557615ed5615791565b029392505050565b60006140a88383615e39565b6000600160ff1b8201615efe57615efe615791565b506000039056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212205c99abe84ae2a4a8e5b02a4d11a7e52819277e6123204cf516864685cc19661a64736f6c634300081c0033","name":"BackingManagerP1","is_blueprint":false,"license_type":"none","is_fully_verified":false,"is_verified_via_eth_bytecode_db":false,"language":"solidity","evm_version":"paris","can_be_visualized_via_sol2uml":true,"is_verified_via_sourcify":false,"additional_sources":[{"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/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":"@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    /// Emitted when the mandate is set\n    event MandateSet(string indexed oldVal, string 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 setMandate(string calldata mandate) external;\n\n    function mandate() external view returns (string memory);\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":"@openzeppelin/contracts/utils/Address.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 Address {\n    /**\n     * @dev Returns true if `account` is a contract.\n     *\n     * [IMPORTANT]\n     * ====\n     * It is unsafe to assume that an address for which this function returns\n     * false is an externally-owned account (EOA) and not a contract.\n     *\n     * Among others, `isContract` will return false for the following\n     * types of addresses:\n     *\n     *  - an externally-owned account\n     *  - a contract in construction\n     *  - an address where a contract will be created\n     *  - an address where a contract lived, but was destroyed\n     *\n     * 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":"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/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/libraries/Allowance.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\ninterface IERC20ApproveOnly {\n    function approve(address spender, uint256 value) external;\n\n    function allowance(address owner, address spender) external view returns (uint256);\n}\n\nlibrary AllowanceLib {\n    /// An approve helper that:\n    ///   1. Sets initial allowance to 0\n    ///   2. Tries to set the provided allowance\n    ///   3. Falls back to setting a maximum allowance, if (2) fails\n    /// Context: Some new-age ERC20s think it's a good idea to revert for allowances\n    /// that are > 0 but < type(uint256).max.\n    function safeApproveFallbackToMax(\n        address tokenAddress,\n        address spender,\n        uint256 value\n    ) internal {\n        IERC20ApproveOnly token = IERC20ApproveOnly(tokenAddress);\n\n        // 1. Set initial allowance to 0\n        token.approve(spender, 0);\n        // untestable:\n        //    allowance should always be 0 if token behaves correctly\n        require(token.allowance(address(this), spender) == 0, \"allowance not 0\");\n\n        if (value == 0) return;\n\n        // 2. Try to set the provided allowance\n        bool success; // bool success = false;\n        try token.approve(spender, value) {\n            success = token.allowance(address(this), spender) == value;\n            // solhint-disable-next-line no-empty-blocks\n        } catch {}\n\n        // 3. Fall-back to setting a maximum allowance\n        if (!success) {\n            token.approve(spender, type(uint256).max);\n            // untestable:\n            //    allowance should always be max value if token behaves correctly\n            require(token.allowance(address(this), spender) >= value, \"allowance missing\");\n        }\n    }\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/p1/mixins/RecollateralizationLib.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 \"./TradeLib.sol\";\n\n/**\n * @title RecollateralizationLibP1\n * @notice An informal extension of BackingManager that implements the rebalancing logic\n *   Users:\n *     - BackingManager\n *     - RTokenAsset (uses `basketRange()`)\n *\n * Interface:\n *  1. prepareRecollateralizationTrade() (external)\n *  2. basketRange() (internal)\n */\nlibrary RecollateralizationLibP1 {\n    using FixLib for uint192;\n    using TradeLib for TradeInfo;\n    using TradeLib for IBackingManager;\n\n    /// Select and prepare a trade that moves us closer to capitalization, using the\n    /// basket range to avoid overeager/duplicate trading.\n    /// The basket range is the full range of projected outcomes for the rebalancing process.\n    // This is the \"main loop\" for recollateralization trading:\n    // actions:\n    //   let range = basketRange(...)\n    //   let trade = nextTradePair(...)\n    //   if trade.sell is not a defaulted collateral, prepareTradeToCoverDeficit(...)\n    //   otherwise, prepareTradeSell(...) taking the minBuyAmount as the dependent variable\n    function prepareRecollateralizationTrade(TradingContext memory ctx, Registry memory reg)\n        external\n        view\n        returns (\n            bool doTrade,\n            TradeRequest memory req,\n            TradePrices memory prices\n        )\n    {\n        // Compute a target basket range for trading -  {BU}\n        // The basket range is the full range of projected outcomes for the rebalancing process\n        BasketRange memory range = basketRange(ctx, reg);\n\n        // Select a pair to trade next, if one exists\n        TradeInfo memory trade = nextTradePair(ctx, reg, range);\n\n        // Don't trade if no pair is selected\n        if (address(trade.sell) == address(0) || address(trade.buy) == address(0)) {\n            return (false, req, prices);\n        }\n\n        // If we are selling a fully unpriced asset or UNSOUND collateral, do not cover deficit\n        // untestable:\n        //     sellLow will not be zero, those assets are skipped in nextTradePair\n        if (\n            trade.prices.sellLow == 0 ||\n            (trade.sell.isCollateral() &&\n                ICollateral(address(trade.sell)).status() != CollateralStatus.SOUND)\n        ) {\n            // Emergency case\n            // Set minBuyAmount as a function of sellAmount\n            (doTrade, req) = trade.prepareTradeSell(ctx.minTradeVolume, ctx.maxTradeSlippage);\n        } else {\n            // Normal case\n            // Set sellAmount as a function of minBuyAmount\n            (doTrade, req) = trade.prepareTradeToCoverDeficit(\n                ctx.minTradeVolume,\n                ctx.maxTradeSlippage\n            );\n        }\n\n        // At this point doTrade _must_ be true, otherwise nextTradePair assumptions are broken\n        assert(doTrade);\n\n        return (doTrade, req, trade.prices);\n    }\n\n    // Compute the target basket range\n    // Algorithm intuition: Trade conservatively. Quantify uncertainty based on the proportion of\n    // token balances requiring trading vs not requiring trading. Seek to decrease uncertainty\n    // the largest amount possible with each trade.\n    //\n    // Algorithm Invariant: every increase of basketsHeld.bottom causes basketsRange().low to\n    //  reach a new maximum. Note that basketRange().low may decrease slightly along the way.\n    // Assumptions: constant oracle prices; monotonically increasing refPerTok; no supply changes\n    //\n    // Preconditions:\n    // - ctx is correctly populated, with current basketsHeld.bottom + basketsHeld.top\n    // - reg contains erc20 + asset + quantities arrays in same order and without duplicates\n    // Trading Strategy:\n    // - We will not aim to hold more than rToken.basketsNeeded() BUs\n    // - No double trades: capital converted from token A to token B should not go to token C\n    //       unless the clearing price was outside the expected price range\n    // - The best price we might get for a trade is at the high sell price and low buy price\n    // - The worst price we might get for a trade is at the low sell price and\n    //     the high buy price, multiplied by ( 1 - maxTradeSlippage )\n    // - In the worst-case an additional dust balance can be lost, up to minTradeVolume\n    // - Given all that, we're aiming to hold as many BUs as possible using the assets we own.\n    //\n    // More concretely:\n    // - range.top = min(rToken.basketsNeeded, basketsHeld.top - least baskets missing\n    //                                                                   + most baskets surplus)\n    // - range.bottom = min(rToken.basketsNeeded, basketsHeld.bottom + least baskets purchaseable)\n    //   where \"least baskets purchaseable\" involves trading at the worst price,\n    //   incurring the full maxTradeSlippage, and taking up to a minTradeVolume loss due to dust.\n    function basketRange(TradingContext memory ctx, Registry memory reg)\n        internal\n        view\n        returns (BasketRange memory range)\n    {\n        // tradesOpen will be 0 when called by prepareRecollateralizationTrade()\n        // tradesOpen can be > 0 when called by RTokenAsset.basketRange()\n\n        (uint192 buPriceLow, uint192 buPriceHigh) = ctx.bh.price(false); // {UoA/BU}\n        require(buPriceLow != 0 && buPriceHigh != FIX_MAX, \"BUs unpriced\");\n\n        uint192 basketsNeeded = ctx.rToken.basketsNeeded(); // {BU}\n\n        // Cap ctx.basketsHeld.top\n        if (ctx.basketsHeld.top > basketsNeeded) {\n            ctx.basketsHeld.top = basketsNeeded;\n        }\n\n        // === (1/3) Calculate contributions from surplus/deficits ===\n\n        // for range.top, anchor to min(ctx.basketsHeld.top, basketsNeeded)\n        // for range.bottom, anchor to min(ctx.basketsHeld.bottom, basketsNeeded)\n\n        // a signed delta to be applied to range.top\n        int256 deltaTop; // D18{BU} even though this is int256, it is D18\n        // not required for range.bottom\n\n        // to minimize total operations, range.bottom is calculated from a summed UoA\n        uint192 uoaBottom; // {UoA} pessimistic UoA estimate of balances above basketsHeld.bottom\n\n        // (no space on the stack to cache erc20s.length)\n        for (uint256 i = 0; i < reg.erc20s.length; ++i) {\n            // Exclude RToken balances to avoid double counting value\n            if (reg.erc20s[i] == IERC20(address(ctx.rToken))) continue;\n\n            (uint192 low, uint192 high) = reg.assets[i].price(); // {UoA/tok}\n\n            // Skip over dust-balance assets not in the basket\n            // Intentionally include value of IFFY/DISABLED collateral\n            if (\n                ctx.quantities[i] == 0 &&\n                !TradeLib.isEnoughToSell(reg.assets[i], ctx.bals[i], low, ctx.minTradeVolume)\n            ) {\n                continue;\n            }\n\n            // throughout these sections +/- is same as Fix.plus/Fix.minus and </> is Fix.gt/.lt\n\n            // deltaTop: optimistic case\n            // if in deficit relative to ctx.basketsHeld.top: deduct missing baskets\n            // if in surplus relative to ctx.basketsHeld.top: add-in surplus baskets\n            {\n                // {tok} = {tok/BU} * {BU}\n                uint192 anchor = ctx.quantities[i].mul(ctx.basketsHeld.top, CEIL);\n\n                if (anchor > ctx.bals[i]) {\n                    // deficit: deduct optimistic estimate of baskets missing\n\n                    // {BU} = {UoA/tok} * {tok} / {UoA/BU}\n                    deltaTop -= int256(\n                        uint256(low.mulDiv(anchor - ctx.bals[i], buPriceHigh, FLOOR))\n                    );\n                    // does not need underflow protection: using low price of asset\n                } else {\n                    // surplus: add-in optimistic estimate of baskets purchaseable\n\n                    //  {BU} = {UoA/tok} * {tok} / {UoA/BU}\n                    deltaTop += int256(\n                        uint256(high.safeMulDiv(ctx.bals[i] - anchor, buPriceLow, CEIL))\n                    );\n                }\n            }\n\n            // range.bottom: pessimistic case\n            // add-in surplus baskets relative to ctx.basketsHeld.bottom\n            {\n                // {tok} = {tok/BU} * {BU}\n                uint192 anchor = ctx.quantities[i].mul(ctx.basketsHeld.bottom, FLOOR);\n\n                // (1) Sum token value at low price\n                // {UoA} = {UoA/tok} * {tok}\n                uint192 val = low.mul(ctx.bals[i] - anchor, FLOOR);\n\n                // (2) Lose minTradeVolume to dust (why: auctions can return tokens)\n                // Q: Why is this precisely where we should take out minTradeVolume?\n                // A: Our use of isEnoughToSell always uses the low price,\n                //   so min trade volumes are always assessed based on low prices. At this point\n                //   in the calculation we have already calculated the UoA amount corresponding to\n                //   the excess token balance based on its low price, so we are already set up\n                //   to straightforwardly deduct the minTradeVolume before trying to buy BUs.\n                uoaBottom += (val < ctx.minTradeVolume) ? 0 : val - ctx.minTradeVolume;\n            }\n        }\n\n        // ==== (2/3) Add-in ctx.*BasketsHeld safely ====\n\n        // range.top\n        if (deltaTop < 0) {\n            range.top = ctx.basketsHeld.top - _safeWrap(uint256(-deltaTop));\n            // reverting on underflow is appropriate here\n        } else {\n            // guard against overflow; > is same as Fix.gt\n            if (uint256(deltaTop) + ctx.basketsHeld.top > FIX_MAX) range.top = FIX_MAX;\n            else range.top = ctx.basketsHeld.top + _safeWrap(uint256(deltaTop));\n        }\n\n        // range.bottom\n        // (3) Buy BUs at their high price with the remaining value\n        // (4) Assume maximum slippage in trade\n        // {BU} = {UoA} * {1} / {UoA/BU}\n        range.bottom =\n            ctx.basketsHeld.bottom +\n            uoaBottom.mulDiv(FIX_ONE.minus(ctx.maxTradeSlippage), buPriceHigh, FLOOR);\n        // reverting on overflow is appropriate here\n\n        // ==== (3/3) Enforce (range.bottom <= range.top <= basketsNeeded) ====\n\n        if (range.top > basketsNeeded) range.top = basketsNeeded;\n        if (range.bottom > range.top) range.bottom = range.top;\n    }\n\n    // ===========================================================================================\n\n    // === Private ===\n\n    // Used in memory in `nextTradePair` to duck the stack limit\n    struct MaxSurplusDeficit {\n        CollateralStatus surplusStatus; // starts SOUND\n        uint192 surplus; // {UoA}\n        uint192 deficit; // {UoA}\n    }\n\n    // Choose next sell/buy pair to trade, with reference to the basket range\n    // Skip over trading surplus dust amounts\n    /// @return trade\n    ///   sell: Surplus collateral OR address(0)\n    ///   deficit Deficit collateral OR address(0)\n    ///   sellAmount {sellTok} Surplus amount (whole tokens)\n    ///   buyAmount {buyTok} Deficit amount (whole tokens)\n    ///   prices.sellLow {UoA/sellTok} The worst-case price of the sell token on secondary markets\n    ///   prices.sellHigh {UoA/sellTok} The best-case price of the sell token on secondary markets\n    ///   prices.buyLow {UoA/buyTok} The best-case price of the buy token on secondary markets\n    ///   prices.buyHigh {UoA/buyTok} The worst-case price of the buy token on secondary markets\n    ///\n    // For each asset e:\n    //   If bal(e) > (quantity(e) * range.top), then e is in surplus by the difference\n    //   If bal(e) < (quantity(e) * range.bottom), then e is in deficit by the difference\n    //\n    // First, ignoring RSR:\n    //   `trade.sell` is the token from erc20s with the greatest surplus value (in UoA),\n    //   and sellAmount is the quantity of that token that it's in surplus (in qTok).\n    //   if `trade.sell` == 0, then no token is in surplus by at least minTradeSize,\n    //        and `trade.sellAmount` and `trade.sellLow` / `trade.sellHigh are unset.\n    //\n    //   `trade.buy` is the token from erc20s with the greatest deficit value (in UoA),\n    //   and buyAmount is the quantity of that token that it's in deficit (in qTok).\n    //   if `trade.buy` == 0, then no token is in deficit at all,\n    //        and `trade.buyAmount` and `trade.buyLow` / `trade.buyHigh` are unset.\n    //\n    // Then, just if we have a buy asset and no sell asset, consider selling available RSR.\n    //\n    // Prefer selling assets in this order: DISABLED -> SOUND -> IFFY.\n    // Sell IFFY last because it may recover value in the future.\n    // All collateral in the basket have already been guaranteed to be SOUND by upstream checks.\n    // Warning: If the trading algorithm is changed to trade unpriced (0, FIX_MAX) assets it can\n    //          result in losses in GnosisTrade. Unpriced assets should not be sold in rebalancing.\n    function nextTradePair(\n        TradingContext memory ctx,\n        Registry memory reg,\n        BasketRange memory range\n    ) private view returns (TradeInfo memory trade) {\n        // assert(tradesOpen == 0); // guaranteed by BackingManager.rebalance()\n\n        MaxSurplusDeficit memory maxes;\n        maxes.surplusStatus = CollateralStatus.IFFY; // least-desirable sell status\n\n        uint256 rsrIndex = reg.erc20s.length; // invalid index, to-start\n\n        // Iterate over non-RSR/non-RToken assets\n        // (no space on the stack to cache erc20s.length)\n        for (uint256 i = 0; i < reg.erc20s.length; ++i) {\n            if (address(reg.erc20s[i]) == address(ctx.rToken)) continue;\n            else if (reg.erc20s[i] == ctx.rsr) {\n                rsrIndex = i;\n                continue;\n            }\n\n            // {tok} = {BU} * {tok/BU}\n            // needed(Top): token balance needed for range.top baskets: quantity(e) * range.top\n            uint192 needed = range.top.mul(ctx.quantities[i], CEIL); // {tok}\n\n            if (ctx.bals[i].gt(needed)) {\n                (uint192 low, uint192 high) = reg.assets[i].price(); // {UoA/sellTok}\n\n                if (high == 0) continue; // skip over worthless assets\n\n                // {UoA} = {sellTok} * {UoA/sellTok}\n                uint192 delta = ctx.bals[i].minus(needed).mul(low, FLOOR);\n\n                // status = asset.status() if asset.isCollateral() else SOUND\n                CollateralStatus status; // starts SOUND\n                if (reg.assets[i].isCollateral()) {\n                    status = ICollateral(address(reg.assets[i])).status();\n                }\n\n                // Select the most-in-surplus \"best\" asset still enough to sell,\n                // as defined by a (status, surplusAmt) ordering\n                if (\n                    isBetterSurplus(maxes, status, delta) &&\n                    TradeLib.isEnoughToSell(\n                        reg.assets[i],\n                        ctx.bals[i].minus(needed),\n                        low,\n                        ctx.minTradeVolume\n                    )\n                ) {\n                    trade.sell = reg.assets[i];\n                    trade.sellAmount = ctx.bals[i].minus(needed);\n                    trade.prices.sellLow = low;\n                    trade.prices.sellHigh = high;\n\n                    maxes.surplusStatus = status;\n                    maxes.surplus = delta;\n                }\n            } else {\n                // needed(Bottom): token balance needed at bottom of the basket range\n                needed = range.bottom.mul(ctx.quantities[i], CEIL); // {buyTok};\n\n                if (ctx.bals[i].lt(needed)) {\n                    uint192 amtShort = needed.minus(ctx.bals[i]); // {buyTok}\n                    (uint192 low, uint192 high) = reg.assets[i].price(); // {UoA/buyTok}\n\n                    // {UoA} = {buyTok} * {UoA/buyTok}\n                    uint192 delta = amtShort.mul(high, CEIL);\n\n                    // The best asset to buy is whichever asset has the largest deficit\n                    if (delta.gt(maxes.deficit)) {\n                        trade.buy = reg.assets[i];\n                        trade.buyAmount = amtShort;\n                        trade.prices.buyLow = low;\n                        trade.prices.buyHigh = high;\n\n                        maxes.deficit = delta;\n                    }\n                }\n            }\n        }\n\n        // Use RSR if needed\n        if (address(trade.sell) == address(0) && address(trade.buy) != address(0)) {\n            (uint192 low, uint192 high) = reg.assets[rsrIndex].price(); // {UoA/RSR}\n\n            // if rsr does not have a registered asset the below array accesses will revert\n            if (\n                high != 0 &&\n                TradeLib.isEnoughToSell(\n                    reg.assets[rsrIndex],\n                    ctx.bals[rsrIndex],\n                    low,\n                    ctx.minTradeVolume\n                )\n            ) {\n                trade.sell = reg.assets[rsrIndex];\n                trade.sellAmount = ctx.bals[rsrIndex];\n                trade.prices.sellLow = low;\n                trade.prices.sellHigh = high;\n            }\n        }\n    }\n\n    /// @param curr The current MaxSurplusDeficit containing the best surplus so far\n    /// @param other The collateral status of the asset in consideration\n    /// @param surplusAmt {UoA} The amount by which the asset in consideration is in surplus\n    function isBetterSurplus(\n        MaxSurplusDeficit memory curr,\n        CollateralStatus other,\n        uint192 surplusAmt\n    ) private pure returns (bool) {\n        // NOTE: If the CollateralStatus enum changes then this has to change!\n        if (curr.surplusStatus == CollateralStatus.DISABLED) {\n            return other == CollateralStatus.DISABLED && surplusAmt.gt(curr.surplus);\n        } else if (curr.surplusStatus == CollateralStatus.SOUND) {\n            return\n                other == CollateralStatus.DISABLED ||\n                (other == CollateralStatus.SOUND && surplusAmt.gt(curr.surplus));\n        } else {\n            // curr is IFFY\n            return other != CollateralStatus.IFFY || surplusAmt.gt(curr.surplus);\n        }\n    }\n}\n"},{"file_path":"contracts/p1/mixins/Trading.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../../interfaces/ITrade.sol\";\nimport \"../../interfaces/ITrading.sol\";\nimport \"../../libraries/Allowance.sol\";\nimport \"../../libraries/Fixed.sol\";\nimport \"../../vendor/oz/Multicall.sol\";\nimport \"./Component.sol\";\nimport \"./RewardableLib.sol\";\n\n/// Abstract trading mixin for BackingManager + RevenueTrader.\n/// @dev The use of Multicall here instead of MulticallUpgradeable cannot be\n///   changed without breaking <3.0.0 RTokens. The only difference in\n///   MulticallUpgradeable is the 50 slot storage gap and an empty constructor.\n///   It should be fine to leave the non-upgradeable Multicall here permanently.\n///   Note: For >=4.1.0 RTokens, ReentrancyGuardUpgradeable is deprecated and\n///         replaced with GlobalReentrancyGuard (`globalNonReentrant`), but\n///         kept as base contract for storage slot compatibility.\nabstract contract TradingP1 is Multicall, ComponentP1, ReentrancyGuardUpgradeable, ITrading {\n    using FixLib for uint192;\n\n    uint192 public constant MAX_TRADE_VOLUME = 1e29; // {UoA}\n    uint192 public constant MAX_TRADE_SLIPPAGE = 1e18; // {%}\n\n    // Peer contracts, immutable after init()\n    IBroker private broker;\n\n    // All open trades\n    mapping(IERC20 => ITrade) public trades;\n    uint48 public tradesOpen;\n\n    // === Governance param ===\n    uint192 public maxTradeSlippage; // {%}\n    uint192 public minTradeVolume; // {UoA}\n\n    // === 3.0.0 ===\n    uint256 public tradesNonce; // to keep track of how many trades have been opened in total\n\n    // ==== Invariants ====\n    // tradesOpen = len(values(trades))\n    // trades[sell] != 0 iff trade[sell] has been opened and not yet settled\n\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 __Trading_init(\n        IMain main_,\n        uint192 maxTradeSlippage_,\n        uint192 minTradeVolume_\n    ) internal onlyInitializing {\n        broker = main_.broker();\n        setMaxTradeSlippage(maxTradeSlippage_);\n        setMinTradeVolume(minTradeVolume_);\n    }\n\n    /// Contract-size helper\n    // solhint-disable-next-line no-empty-blocks\n    function requireNotTradingPausedOrFrozen() internal view notTradingPausedOrFrozen {}\n\n    // contract-size-saver\n    // solhint-disable-next-line no-empty-blocks\n    function requireGovernanceOnly() internal view governance {}\n\n    /// Claim all rewards\n    /// Collective Action\n    /// @custom:interaction CEI (marked `nonReentrant`)\n    function claimRewards() external globalNonReentrant {\n        requireNotTradingPausedOrFrozen();\n        RewardableLibP1.claimRewards(main.assetRegistry());\n    }\n\n    /// Claim rewards for a single asset\n    /// Collective Action\n    /// @param erc20 The ERC20 to claimRewards on\n    /// @custom:interaction CEI (marked `nonReentrant`)\n    function claimRewardsSingle(IERC20 erc20) external globalNonReentrant {\n        requireNotTradingPausedOrFrozen();\n        RewardableLibP1.claimRewardsSingle(main.assetRegistry().toAsset(erc20));\n    }\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 trade The ITrade contract settled\n    /// @custom:interaction (only reads or writes trades, and is marked `nonReentrant`)\n    // checks:\n    //   !paused (trading), !frozen\n    //   trade[sell].canSettle()\n    //   (see override)\n    // actions:\n    //   trade[sell].settle()\n    // effects:\n    //   trades.set(sell, 0)\n    //   tradesOpen' = tradesOpen - 1\n    function settleTrade(IERC20 sell) public virtual globalNonReentrant returns (ITrade trade) {\n        trade = trades[sell];\n        require(address(trade) != address(0), \"no trade open\");\n        require(trade.canSettle(), \"cannot settle yet\");\n\n        delete trades[sell];\n        tradesOpen--;\n\n        // == Interactions ==\n        (uint256 soldAmt, uint256 boughtAmt) = trade.settle();\n        emit TradeSettled(trade, sell, trade.buy(), soldAmt, boughtAmt);\n    }\n\n    /// Try to initiate a trade with a trading partner provided by the broker\n    /// @param kind TradeKind.DUTCH_AUCTION or TradeKind.BATCH_AUCTION\n    /// @return trade The trade contract created\n    /// @custom:interaction Assumption: Caller is nonReentrant\n    // checks:\n    //   (not external, so we don't need auth or pause checks)\n    //   trades[req.sell] == 0\n    // actions:\n    //   req.sell.increaseAllowance(broker, req.sellAmount) - two safeApprove calls to support USDT\n    //   tradeID = broker.openTrade(req)\n    // effects:\n    //   trades' = trades.set(req.sell, tradeID)\n    //   tradesOpen' = tradesOpen + 1\n    function tryTrade(\n        TradeKind kind,\n        TradeRequest memory req,\n        TradePrices memory prices\n    ) internal returns (ITrade trade) {\n        IERC20 sell = req.sell.erc20();\n        assert(address(trades[sell]) == address(0)); // ensure calling class has checked this\n\n        // Set allowance via custom approval -- first sets allowance to 0, then sets allowance\n        // to either the requested amount or the maximum possible amount, if that fails.\n        //\n        // Context: wcUSDCv3 has a non-standard approve() function that reverts if the approve\n        // amount is > 0 and < type(uint256).max.\n        AllowanceLib.safeApproveFallbackToMax(address(sell), address(broker), req.sellAmount);\n\n        trade = broker.openTrade(kind, req, prices);\n        trades[sell] = trade;\n        ++tradesOpen;\n        ++tradesNonce;\n\n        emit TradeStarted(trade, sell, req.buy.erc20(), req.sellAmount, req.minBuyAmount);\n    }\n\n    // === Governance ===\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) public virtual globalNonReentrant {\n        requireGovernanceOnly();\n        // should not call any ERC20 functions, in case bricked\n\n        IERC20Metadata sell = trade.sell();\n        require(trades[sell] == trade, \"wrong trade\");\n        delete trades[sell];\n        tradesOpen--;\n        emit TradeSettled(trade, sell, trade.buy(), 0, 0);\n    }\n\n    /// @custom:governance\n    function setMaxTradeSlippage(uint192 val) public {\n        requireGovernanceOnly();\n        require(val <= MAX_TRADE_SLIPPAGE, \"invalid maxTradeSlippage\");\n        emit MaxTradeSlippageSet(maxTradeSlippage, val);\n        maxTradeSlippage = val;\n    }\n\n    /// @custom:governance\n    function setMinTradeVolume(uint192 val) public {\n        requireGovernanceOnly();\n        require(val <= MAX_TRADE_VOLUME, \"invalid minTradeVolume\");\n        emit MinTradeVolumeSet(minTradeVolume, val);\n        minTradeVolume = val;\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[45] 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/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/token/ERC20/extensions/IERC20Permit.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 IERC20Permit {\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/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":"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)\n\npragma solidity ^0.8.0;\n\nimport \"../IERC20.sol\";\nimport \"../extensions/IERC20Permit.sol\";\nimport \"../../../utils/Address.sol\";\n\n/**\n * @title SafeERC20\n * @dev Wrappers around ERC20 operations that throw on failure (when the token\n * contract returns false). Tokens that return no value (and instead revert or\n * throw on failure) are also supported, non-reverting calls are assumed to be\n * successful.\n * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,\n * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.\n */\nlibrary SafeERC20 {\n    using Address for address;\n\n    /**\n     * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful.\n     */\n    function safeTransfer(IERC20 token, address to, uint256 value) internal {\n        _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));\n    }\n\n    /**\n     * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the\n     * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.\n     */\n    function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {\n        _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));\n    }\n\n    /**\n     * @dev Deprecated. This function has issues similar to the ones found in\n     * {IERC20-approve}, and its usage is discouraged.\n     *\n     * Whenever possible, use {safeIncreaseAllowance} and\n     * {safeDecreaseAllowance} instead.\n     */\n    function safeApprove(IERC20 token, address spender, uint256 value) internal {\n        // safeApprove should only be called when setting an initial allowance,\n        // or when resetting it to zero. To increase and decrease it, use\n        // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'\n        require(\n            (value == 0) || (token.allowance(address(this), spender) == 0),\n            \"SafeERC20: approve from non-zero to non-zero allowance\"\n        );\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));\n    }\n\n    /**\n     * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful.\n     */\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n        uint256 oldAllowance = token.allowance(address(this), spender);\n        _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));\n    }\n\n    /**\n     * @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful.\n     */\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {\n        unchecked {\n            uint256 oldAllowance = token.allowance(address(this), spender);\n            require(oldAllowance >= value, \"SafeERC20: decreased allowance below zero\");\n            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));\n        }\n    }\n\n    /**\n     * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,\n     * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval\n     * to be set to zero before setting it to a non-zero value, such as USDT.\n     */\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\n        bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);\n\n        if (!_callOptionalReturnBool(token, approvalCall)) {\n            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));\n            _callOptionalReturn(token, approvalCall);\n        }\n    }\n\n    /**\n     * @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.\n     * Revert on invalid signature.\n     */\n    function safePermit(\n        IERC20Permit token,\n        address owner,\n        address spender,\n        uint256 value,\n        uint256 deadline,\n        uint8 v,\n        bytes32 r,\n        bytes32 s\n    ) internal {\n        uint256 nonceBefore = token.nonces(owner);\n        token.permit(owner, spender, value, deadline, v, r, s);\n        uint256 nonceAfter = token.nonces(owner);\n        require(nonceAfter == nonceBefore + 1, \"SafeERC20: permit did not succeed\");\n    }\n\n    /**\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\n     * @param token The token targeted by the call.\n     * @param data The call data (encoded using abi.encode or one of its variants).\n     */\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\n        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n        // we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that\n        // the target address contains contract code and also asserts for success in the low-level call.\n\n        bytes memory returndata = address(token).functionCall(data, \"SafeERC20: low-level call failed\");\n        require(returndata.length == 0 || abi.decode(returndata, (bool)), \"SafeERC20: ERC20 operation did not succeed\");\n    }\n\n    /**\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\n     * @param token The token targeted by the call.\n     * @param data The call data (encoded using abi.encode or one of its variants).\n     *\n     * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.\n     */\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\n        // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since\n        // we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false\n        // and not revert is the subcall reverts.\n\n        (bool success, bytes memory returndata) = address(token).call(data);\n        return\n            success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));\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/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/libraries/Array.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\n\nlibrary ArrayLib {\n    /// O(n^2)\n    /// @return If the array contains all unique addresses\n    function allUnique(IERC20[] memory arr) internal pure returns (bool) {\n        uint256 arrLen = arr.length;\n        for (uint256 i = 1; i < arrLen; ++i) {\n            for (uint256 j = 0; j < i; ++j) {\n                if (arr[i] == arr[j]) return false;\n            }\n        }\n        return true;\n    }\n\n    /// O(n) -- must already be in sorted ascending order!\n    /// @return If the array contains all unique addresses, in ascending order\n    function sortedAndAllUnique(IERC20[] memory arr) internal pure returns (bool) {\n        uint256 arrLen = arr.length;\n        for (uint256 i = 1; i < arrLen; ++i) {\n            if (uint160(address(arr[i])) <= uint160(address(arr[i - 1]))) return false;\n        }\n        return true;\n    }\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":"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":"contracts/vendor/oz/Multicall.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.5) (utils/Multicall.sol)\n\npragma solidity ^0.8.0;\n\nimport \"@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol\";\nimport \"@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol\";\nimport { Initializable } from \"@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol\";\n\n/**\n * @dev Forked from OpenZeppelin v4.9.6, removes gap\n *\n */\nabstract contract Multicall is Initializable, ContextUpgradeable {\n    /**\n     * @dev Receives and executes a batch of function calls on this contract.\n     * @custom:oz-upgrades-unsafe-allow-reachable delegatecall\n     */\n    function multicall(bytes[] calldata data) external virtual returns (bytes[] memory results) {\n        bytes memory context = msg.sender == _msgSender()\n            ? new bytes(0)\n            : msg.data[msg.data.length - _contextSuffixLength():];\n\n        results = new bytes[](data.length);\n        for (uint256 i = 0; i < data.length; i++) {\n            results[i] = AddressUpgradeable.functionDelegateCall(\n                address(this),\n                bytes.concat(data[i], context)\n            );\n        }\n        return results;\n    }\n}\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/TradeLib.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"../../interfaces/IAsset.sol\";\nimport \"../../libraries/Fixed.sol\";\n\nstruct TradeInfo {\n    IAsset sell;\n    IAsset buy;\n    uint192 sellAmount; // {sellTok}\n    uint192 buyAmount; // {buyTok}\n    TradePrices prices;\n}\n\n/**\n * @title TradeLib\n * @notice An internal lib for preparing individual trades on particular asset pairs\n *   Users:\n *     - RecollateralizationLib\n *     - RevenueTrader\n */\nlibrary TradeLib {\n    using FixLib for uint192;\n\n    /// Prepare a trade to sell `trade.sellAmount` that guarantees a reasonable closing price,\n    /// without explicitly aiming at a particular buy amount.\n    /// @param trade:\n    ///   sell != 0, sellAmount >= 0 {sellTok}, prices.sellLow >= 0 {UoA/sellTok}\n    ///   buy != 0, buyAmount (unused) {buyTok}, prices.buyHigh > 0 {UoA/buyTok}\n    /// @return notDust True when the trade is larger than the dust amount\n    /// @return req The prepared trade request to send to the Broker\n    //\n    // If notDust is true, then the returned trade request satisfies:\n    //   req.sell == trade.sell and req.buy == trade.buy,\n    //   req.minBuyAmount * trade.prices.buyHigh ~=\n    //        trade.sellAmount * trade.prices.sellLow * (1-maxTradeSlippage),\n    //   req.sellAmount == min(trade.sell.maxTradeSize(), trade.sellAmount)\n    //   1 < req.sellAmount\n    //\n    // If notDust is false, no trade exists that satisfies those constraints.\n    function prepareTradeSell(\n        TradeInfo memory trade,\n        uint192 minTradeVolume,\n        uint192 maxTradeSlippage\n    ) internal view returns (bool notDust, TradeRequest memory req) {\n        // checked for in RevenueTrader / CollateralizatlionLib\n        assert(\n            trade.prices.buyHigh != 0 &&\n                trade.prices.buyHigh != FIX_MAX &&\n                trade.prices.sellLow != FIX_MAX\n        );\n\n        notDust = isEnoughToSell(\n            trade.sell,\n            trade.sellAmount,\n            trade.prices.sellLow,\n            minTradeVolume\n        );\n\n        // Cap sell amount using the high price\n        // Under price decay trade.prices.sellHigh can become up to 2x the savedHighPrice before\n        // becoming FIX_MAX after the full price timeout\n        uint192 s = trade.sellAmount;\n        if (trade.prices.sellHigh != FIX_MAX) {\n            // {sellTok}\n            uint192 maxSell = maxTradeSize(trade.sell, trade.buy, trade.prices.sellHigh);\n            require(maxSell > 1, \"trade sizing error\");\n            if (s > maxSell) s = maxSell;\n        } else {\n            require(trade.prices.sellLow == 0, \"trade pricing error\");\n        }\n\n        // Calculate equivalent buyAmount within [0, FIX_MAX]\n        // {buyTok} = {sellTok} * {1} * {UoA/sellTok} / {UoA/buyTok}\n        uint192 b = s.mul(FIX_ONE.minus(maxTradeSlippage)).safeMulDiv(\n            trade.prices.sellLow,\n            trade.prices.buyHigh,\n            CEIL\n        );\n\n        // {*tok} => {q*Tok}\n        req.sellAmount = s.shiftl_toUint(int8(trade.sell.erc20Decimals()), FLOOR);\n        req.minBuyAmount = b.shiftl_toUint(int8(trade.buy.erc20Decimals()), CEIL);\n        req.sell = trade.sell;\n        req.buy = trade.buy;\n\n        return (notDust, req);\n    }\n\n    /// Assuming we have `trade.sellAmount` sell tokens available, prepare a trade to cover as\n    /// much of our deficit of `trade.buyAmount` buy tokens as possible, given expected trade\n    /// slippage and maxTradeVolume().\n    /// @param trade:\n    ///   sell != 0\n    ///   buy != 0\n    ///   sellAmount (unused) {sellTok}\n    ///   buyAmount >= 0 {buyTok}\n    ///   prices.sellLow > 0 {UoA/sellTok}\n    ///   prices.buyHigh > 0 {UoA/buyTok}\n    /// @return notDust Whether the prepared trade is large enough to be worth trading\n    /// @return req The prepared trade request to send to the Broker\n    //\n    // Returns prepareTradeSell(trade, rules), where\n    //   req.sellAmount = min(trade.sellAmount,\n    //                trade.buyAmount * (buyHigh / sellLow) / (1-maxTradeSlippage))\n    //   i.e, the minimum of trade.sellAmount and (a sale amount that, at current prices and\n    //   maximum slippage, will yield at least the requested trade.buyAmount)\n    //\n    // Which means we should get that, if notDust is true, then:\n    //   req.sell = sell and req.buy = buy\n    //\n    //   1 <= req.minBuyAmount <= max(trade.buyAmount, buy.minTradeSize()))\n    //   1 < req.sellAmount <= min(trade.sellAmount, sell.maxTradeSize())\n    //   req.minBuyAmount ~= trade.sellAmount * sellLow / buyHigh * (1-maxTradeSlippage)\n    //\n    //   req.sellAmount (and req.minBuyAmount) are maximal satisfying all these conditions\n    function prepareTradeToCoverDeficit(\n        TradeInfo memory trade,\n        uint192 minTradeVolume,\n        uint192 maxTradeSlippage\n    ) internal view returns (bool notDust, TradeRequest memory req) {\n        assert(\n            trade.prices.sellLow != 0 &&\n                trade.prices.sellLow != FIX_MAX &&\n                trade.prices.buyHigh != 0 &&\n                trade.prices.buyHigh != FIX_MAX\n        );\n\n        // Don't buy dust.\n        trade.buyAmount = fixMax(\n            trade.buyAmount,\n            minTradeSize(minTradeVolume, trade.prices.buyHigh)\n        );\n\n        // {sellTok} = {buyTok} * {UoA/buyTok} / {UoA/sellTok}\n        uint192 exactSellAmount = trade.buyAmount.mulDiv(\n            trade.prices.buyHigh,\n            trade.prices.sellLow,\n            CEIL\n        );\n        // exactSellAmount: Amount to sell to buy `deficitAmount` if there's no slippage\n\n        // slippedSellAmount: Amount needed to sell to buy `deficitAmount`, counting slippage\n        uint192 slippedSellAmount = exactSellAmount.div(FIX_ONE.minus(maxTradeSlippage), CEIL);\n\n        trade.sellAmount = fixMin(slippedSellAmount, trade.sellAmount); // {sellTok}\n        return prepareTradeSell(trade, minTradeVolume, maxTradeSlippage);\n    }\n\n    /// @param asset The asset in consideration\n    /// @param amt {tok} The number of whole tokens we plan to sell\n    /// @param price {UoA/tok} The price to use for sizing\n    /// @param minTradeVolume {UoA} The min trade volume, passed in for gas optimization\n    /// @return If amt is sufficiently large to be worth selling into our trading platforms\n    function isEnoughToSell(\n        IAsset asset,\n        uint192 amt,\n        uint192 price,\n        uint192 minTradeVolume\n    ) internal view returns (bool) {\n        return\n            amt.gte(minTradeSize(minTradeVolume, price)) &&\n            // Trading platforms often don't allow token quanta trades for rounding reasons\n            // {qTok} = {tok} / {tok/qTok}\n            amt.shiftl_toUint(int8(asset.erc20Decimals())) > 1;\n    }\n\n    // === Private ===\n\n    /// Calculates the minTradeSize for an asset based on the given minTradeVolume and price\n    /// @param minTradeVolume {UoA} The min trade volume, passed in for gas optimization\n    /// @return {tok} The min trade size for the asset in whole tokens\n    function minTradeSize(uint192 minTradeVolume, uint192 price) private pure returns (uint192) {\n        // {tok} = {UoA} / {UoA/tok}\n        uint192 size = price == 0 ? FIX_MAX : minTradeVolume.div(price, CEIL);\n        return size != 0 ? size : 1;\n    }\n\n    /// Calculates the maximum trade size for a trade pair of tokens\n    /// @return {tok} The max trade size for the trade overall\n    function maxTradeSize(\n        IAsset sell,\n        IAsset buy,\n        uint192 price\n    ) private view returns (uint192) {\n        // D18{tok} = D18{UoA} / D18{UoA/tok}\n        uint192 size = fixMin(sell.maxTradeVolume(), buy.maxTradeVolume()).safeDiv(price, FLOOR);\n        return size != 0 ? size : 1;\n    }\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/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":"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/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/p1/mixins/Component.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-upgradeable/utils/ContextUpgradeable.sol\";\nimport \"../../interfaces/IComponent.sol\";\nimport \"../../interfaces/IMain.sol\";\nimport \"../../mixins/Versioned.sol\";\n\n/**\n * Abstract superclass for system contracts registered in Main\n */\nabstract contract ComponentP1 is\n    Versioned,\n    Initializable,\n    ContextUpgradeable,\n    UUPSUpgradeable,\n    IComponent\n{\n    IMain public main;\n\n    /// @custom:oz-upgrades-unsafe-allow constructor\n    // solhint-disable-next-line no-empty-blocks\n    constructor() initializer {}\n\n    // Sets main for the component - Can only be called during initialization\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 __Component_init(IMain main_) internal onlyInitializing {\n        require(address(main_) != address(0), \"main is zero address\");\n        __UUPSUpgradeable_init();\n        main = main_;\n    }\n\n    // === See docs/pause-freeze-states.md ===\n\n    modifier notTradingPausedOrFrozen() {\n        require(!main.tradingPausedOrFrozen(), \"frozen or trading paused\");\n        _;\n    }\n\n    modifier notIssuancePausedOrFrozen() {\n        require(!main.issuancePausedOrFrozen(), \"frozen or issuance paused\");\n        _;\n    }\n\n    modifier notFrozen() {\n        require(!main.frozen(), \"frozen\");\n        _;\n    }\n\n    modifier governance() {\n        require(main.hasRole(OWNER, _msgSender()), \"governance only\");\n        _;\n    }\n\n    modifier onlyMain() {\n        require(_msgSender() == address(main), \"main only\");\n        _;\n    }\n\n    // === Control Flow ===\n\n    /**\n     * @dev Prevents reentrancy by implementing a global lock shared by all components\n     * Calling a `globalNonReentrant` function from another `globalNonReentrant`\n     * function is not supported.\n     */\n    modifier globalNonReentrant() {\n        main.beginTx();\n        _;\n        main.endTx();\n    }\n\n    // solhint-disable-next-line no-empty-blocks\n    function _authorizeUpgrade(address newImplementation) internal view override onlyMain {}\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/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/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/p1/mixins/RewardableLib.sol","source_code":"// SPDX-License-Identifier: BlueOak-1.0.0\npragma solidity 0.8.28;\n\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/utils/Address.sol\";\nimport \"../../interfaces/IAssetRegistry.sol\";\nimport \"../../interfaces/IBackingManager.sol\";\n\n/**\n * @title RewardableLibP1\n * @notice A library that allows a contract to claim rewards\n * @dev The caller must implement the IRewardable interface!\n */\nlibrary RewardableLibP1 {\n    using Address for address;\n    using SafeERC20 for IERC20;\n\n    // === Used by Traders + RToken ===\n\n    /// Claim all rewards\n    // actions:\n    //   do asset.delegatecall(abi.encodeWithSignature(\"claimRewards()\")) for asset in assets\n    function claimRewards(IAssetRegistry reg) internal {\n        Registry memory registry = reg.getRegistry();\n        uint256 len = registry.assets.length;\n        for (uint256 i = 0; i < len; ++i) {\n            // Claim rewards via delegatecall\n            address(registry.assets[i]).functionDelegateCall(\n                abi.encodeWithSignature(\"claimRewards()\"),\n                \"rewards claim failed\"\n            );\n        }\n    }\n\n    /// Claim rewards for a single ERC20\n    // actions:\n    //   do asset.delegatecall(abi.encodeWithSignature(\"claimRewards()\"))\n    function claimRewardsSingle(IAsset asset) internal {\n        // Claim rewards via delegatecall\n        address(asset).functionDelegateCall(\n            abi.encodeWithSignature(\"claimRewards()\"),\n            \"rewards claim failed\"\n        );\n    }\n}\n"},{"file_path":"@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol","source_code":"// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)\n\npragma solidity ^0.8.0;\nimport {Initializable} from \"../proxy/utils/Initializable.sol\";\n\n/**\n * @dev Contract module that helps prevent reentrant calls to a function.\n *\n * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier\n * available, which can be applied to functions to make sure there are no nested\n * (reentrant) calls to them.\n *\n * Note that because there is a single `nonReentrant` guard, functions marked as\n * `nonReentrant` may not call one another. This can be worked around by making\n * those functions `private`, and then adding `external` `nonReentrant` entry\n * points to them.\n *\n * TIP: If you would like to learn more about reentrancy and alternative ways\n * to protect against it, check out our blog post\n * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].\n */\nabstract contract ReentrancyGuardUpgradeable 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    uint256 private _status;\n\n    function __ReentrancyGuard_init() internal onlyInitializing {\n        __ReentrancyGuard_init_unchained();\n    }\n\n    function __ReentrancyGuard_init_unchained() internal onlyInitializing {\n        _status = _NOT_ENTERED;\n    }\n\n    /**\n     * @dev Prevents a contract from calling itself, directly or indirectly.\n     * Calling a `nonReentrant` function from another `nonReentrant`\n     * function is not supported. It is possible to prevent this from happening\n     * by making the `nonReentrant` function external, and making it call a\n     * `private` function that does the actual work.\n     */\n    modifier nonReentrant() {\n        _nonReentrantBefore();\n        _;\n        _nonReentrantAfter();\n    }\n\n    function _nonReentrantBefore() private {\n        // On the first call to nonReentrant, _status will be _NOT_ENTERED\n        require(_status != _ENTERED, \"ReentrancyGuard: reentrant call\");\n\n        // Any calls to nonReentrant after this point will fail\n        _status = _ENTERED;\n    }\n\n    function _nonReentrantAfter() private {\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    /**\n     * @dev Returns true if the reentrancy guard is currently set to \"entered\", which indicates there is a\n     * `nonReentrant` function in the call stack.\n     */\n    function _reentrancyGuardEntered() internal view returns (bool) {\n        return _status == _ENTERED;\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/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"}],"certified":false,"conflicting_implementations":null,"abi":[{"inputs":[],"name":"UIntOutOfBounds","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":"uint192","name":"oldVal","type":"uint192"},{"indexed":false,"internalType":"uint192","name":"newVal","type":"uint192"}],"name":"BackingBufferSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint192","name":"oldVal","type":"uint192"},{"indexed":false,"internalType":"uint192","name":"newVal","type":"uint192"}],"name":"MaxTradeSlippageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint192","name":"oldVal","type":"uint192"},{"indexed":false,"internalType":"uint192","name":"newVal","type":"uint192"}],"name":"MinTradeVolumeSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"contract IERC20","name":"erc20","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"RewardsClaimed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"contract ITrade","name":"trade","type":"address"},{"indexed":true,"internalType":"contract IERC20","name":"sell","type":"address"},{"indexed":true,"internalType":"contract IERC20","name":"buy","type":"address"},{"indexed":false,"internalType":"uint256","name":"sellAmount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"buyAmount","type":"uint256"}],"name":"TradeSettled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"contract ITrade","name":"trade","type":"address"},{"indexed":true,"internalType":"contract IERC20","name":"sell","type":"address"},{"indexed":true,"internalType":"contract IERC20","name":"buy","type":"address"},{"indexed":false,"internalType":"uint256","name":"sellAmount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"minBuyAmount","type":"uint256"}],"name":"TradeStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint48","name":"oldVal","type":"uint48"},{"indexed":false,"internalType":"uint48","name":"newVal","type":"uint48"}],"name":"TradingDelaySet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"MAX_BACKING_BUFFER","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_TRADE_SLIPPAGE","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_TRADE_VOLUME","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_TRADING_DELAY","outputs":[{"internalType":"uint48","name":"","type":"uint48"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"backingBuffer","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cacheComponents","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"claimRewards","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"erc20","type":"address"}],"name":"claimRewardsSingle","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract ITrade","name":"trade","type":"address"}],"name":"forceSettleTrade","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20[]","name":"erc20s","type":"address[]"}],"name":"forwardRevenue","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"erc20","type":"address"}],"name":"grantRTokenAllowance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IMain","name":"main_","type":"address"},{"internalType":"uint48","name":"tradingDelay_","type":"uint48"},{"internalType":"uint192","name":"backingBuffer_","type":"uint192"},{"internalType":"uint192","name":"maxTradeSlippage_","type":"uint192"},{"internalType":"uint192","name":"minTradeVolume_","type":"uint192"}],"name":"init","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"main","outputs":[{"internalType":"contract IMain","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxTradeSlippage","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"minTradeVolume","outputs":[{"internalType":"uint192","name":"","type":"uint192"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes[]","name":"data","type":"bytes[]"}],"name":"multicall","outputs":[{"internalType":"bytes[]","name":"results","type":"bytes[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"enum TradeKind","name":"kind","type":"uint8"}],"name":"rebalance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint192","name":"val","type":"uint192"}],"name":"setBackingBuffer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint192","name":"val","type":"uint192"}],"name":"setMaxTradeSlippage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint192","name":"val","type":"uint192"}],"name":"setMinTradeVolume","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint48","name":"val","type":"uint48"}],"name":"setTradingDelay","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"sell","type":"address"}],"name":"settleTrade","outputs":[{"internalType":"contract ITrade","name":"trade","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"","type":"address"}],"name":"trades","outputs":[{"internalType":"contract ITrade","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tradesNonce","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tradesOpen","outputs":[{"internalType":"uint48","name":"","type":"uint48"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"uint192","name":"bottom","type":"uint192"},{"internalType":"uint192","name":"top","type":"uint192"}],"internalType":"struct BasketRange","name":"basketsHeld","type":"tuple"}],"name":"tradingContext","outputs":[{"components":[{"components":[{"internalType":"uint192","name":"bottom","type":"uint192"},{"internalType":"uint192","name":"top","type":"uint192"}],"internalType":"struct BasketRange","name":"basketsHeld","type":"tuple"},{"internalType":"contract IBasketHandler","name":"bh","type":"address"},{"internalType":"contract IAssetRegistry","name":"ar","type":"address"},{"internalType":"contract IStRSR","name":"stRSR","type":"address"},{"internalType":"contract IERC20","name":"rsr","type":"address"},{"internalType":"contract IRToken","name":"rToken","type":"address"},{"internalType":"uint192","name":"minTradeVolume","type":"uint192"},{"internalType":"uint192","name":"maxTradeSlippage","type":"uint192"},{"internalType":"uint192[]","name":"quantities","type":"uint192[]"},{"internalType":"uint192[]","name":"bals","type":"uint192[]"}],"internalType":"struct TradingContext","name":"ctx","type":"tuple"},{"components":[{"internalType":"contract IERC20[]","name":"erc20s","type":"address[]"},{"internalType":"contract IAsset[]","name":"assets","type":"address[]"}],"internalType":"struct Registry","name":"reg","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tradingDelay","outputs":[{"internalType":"uint48","name":"","type":"uint48"}],"stateMutability":"view","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"}],"is_changed_bytecode":false,"is_partially_verified":true,"constructor_args":null}