From dda357657e3104e1dcc59ad93bf99a0c3a2c3a6b Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 09:34:54 +0300
Subject: [PATCH 01/28] docs(audits): add Bailsec Core report for v3.2.1

Covers commit 0ce59af across the parallelizer and tokens repositories.
---
 ...- Parallel Protocol - Core - 1st Report.pdf | Bin 0 -> 667777 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 docs/audits/v3.2.1/Bailsec - Parallel Protocol - Core - 1st Report.pdf

diff --git a/docs/audits/v3.2.1/Bailsec - Parallel Protocol - Core - 1st Report.pdf b/docs/audits/v3.2.1/Bailsec - Parallel Protocol - Core - 1st Report.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..239fd57dea7502915a39d55950d8ad25bfa0a7cb
GIT binary patch
literal 667777
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%0Aa(tFLeNBRC1YU77`^>fyLWal$(rhat9+j
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
Q10x_i;*pTh(9z`ie<+ZOO8@`>

literal 0
HcmV?d00001


From 9c4d48b0573c6c7beb74ce8ece4c9e8497ffffd8 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 09:34:54 +0300
Subject: [PATCH 02/28] fix(harvester): restrict harvest to trusted callers

harvest forwards caller-supplied router calldata and refreshes the
collateral oracle, so it cannot be exposed to arbitrary callers. This
aligns GenericHarvester with MultiBlockHarvester, which already gates
both of its entry points.

Closes Bailsec Core Issue_04, Issue_05 and Issue_07.
---
 contracts/helpers/GenericHarvester.sol | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/contracts/helpers/GenericHarvester.sol b/contracts/helpers/GenericHarvester.sol
index 3b31873..cf2efcb 100644
--- a/contracts/helpers/GenericHarvester.sol
+++ b/contracts/helpers/GenericHarvester.sol
@@ -25,7 +25,7 @@ enum SwapType {
 /// @title GenericHarvester
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
-/// @dev Generic contract for anyone to permissionlessly adjust the reserves of Angle Parallelizer
+/// @dev Generic contract for trusted callers to adjust the reserves of Angle Parallelizer
 /// @dev This contract is an authorized fork of Angle's GenericHarvester contract:
 /// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol
 contract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {
@@ -98,7 +98,9 @@ contract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper
   /// `yieldBearingAsset` to the target exposure
   /// @dev scale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest,
   /// it is used to lower the amount of the asset to harvest for example to have a lower slippage
-  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual {
+  /// @dev Restricted to trusted callers: the flow forwards caller-supplied router calldata and refreshes the
+  /// collateral oracle, neither of which can be safely exposed to arbitrary callers
+  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual onlyTrusted {
     if (scale > 1e9) revert InvalidParam();
     updateLimitExposuresYieldAsset(yieldBearingAsset);
     YieldBearingParams memory yieldBearingInfo = yieldBearingData[yieldBearingAsset];

From a5fccc20b62c6abe51e74ef0fe3437cfe9e3e62a Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 09:34:54 +0300
Subject: [PATCH 03/28] fix(oracle): bound and log the MAX target ratchet

updateOracle raised the stored target to the current spot with no bound
on the increase, and emitted nothing, so a transient upward print could
be locked in permanently and left no trace in the logs.

A single update is now capped at MAX_ORACLE_RATCHET_STEP and emits
OracleTargetUpdated. Failing to ratchet is the conservative direction:
readMint clamps at the lower of spot and target, and readBurn cannot
raise a stale target above its stored value.

Part of Bailsec Core Issue_04.
---
 .../parallelizer/libraries/LibOracle.sol      | 19 +++++------
 contracts/utils/Constants.sol                 |  2 ++
 tests/fuzz/Oracle.t.sol                       | 34 +++++++++++++++++--
 3 files changed, 43 insertions(+), 12 deletions(-)

diff --git a/contracts/parallelizer/libraries/LibOracle.sol b/contracts/parallelizer/libraries/LibOracle.sol
index c0a84a7..54431f8 100644
--- a/contracts/parallelizer/libraries/LibOracle.sol
+++ b/contracts/parallelizer/libraries/LibOracle.sol
@@ -17,6 +17,9 @@ import "../Storage.sol";
 /// @dev This library is an authorized fork of Angle's `LibOracle` library
 /// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/transmuter/libraries/LibOracle.sol
 library LibOracle {
+  /// @notice Emitted when a MAX target price is ratcheted up by `updateOracle`
+  event OracleTargetUpdated(address indexed collateral, uint256 previousTarget, uint256 newTarget);
+
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
     ACTIONS SPECIFIC ORACLES
   //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
@@ -254,17 +257,13 @@ library LibOracle {
     uint256 oracleValue = read(oracleType, BASE_18, oracleData);
 
     uint256 maxValue = abi.decode(targetData, (uint256));
-    if (oracleValue > maxValue) {
-      ts.collaterals[collateral].oracleConfig = abi.encode(
-        oracleType,
-        targetType,
-        oracleData,
-        // There are no checks whether the value increased or not
-        abi.encode(oracleValue),
-        hyperparameters
-      );
-    } else {
+    // The ratchet is one-way and only governance can lower the target again through `setOracle`, so a single
+    // update is bounded: a transient upward print cannot be locked in beyond `MAX_ORACLE_RATCHET_STEP`
+    if (oracleValue <= maxValue || oracleValue * BASE_18 > maxValue * (BASE_18 + MAX_ORACLE_RATCHET_STEP)) {
       revert OracleUpdateFailed();
     }
+    ts.collaterals[collateral].oracleConfig =
+      abi.encode(oracleType, targetType, oracleData, abi.encode(oracleValue), hyperparameters);
+    emit OracleTargetUpdated(collateral, maxValue, oracleValue);
   }
 }
diff --git a/contracts/utils/Constants.sol b/contracts/utils/Constants.sol
index d78bc0d..9ad8d55 100644
--- a/contracts/utils/Constants.sol
+++ b/contracts/utils/Constants.sol
@@ -40,6 +40,8 @@ uint256 constant MAX_MINT_FEE = BASE_12 - 1;
 uint256 constant MAX_PAYEES = 10;
 uint256 constant SECONDS_PER_YEAR = 365 days;
 uint256 constant MAX_STORED_ASSETS_INIT_STALENESS = 30 minutes;
+/// @dev Largest relative increase a single `updateOracle` ratchet may apply to a MAX target price
+uint256 constant MAX_ORACLE_RATCHET_STEP = 5e16;
 
 /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
                                                      REENTRANT                                                      
diff --git a/tests/fuzz/Oracle.t.sol b/tests/fuzz/Oracle.t.sol
index d2c929e..a2f7505 100644
--- a/tests/fuzz/Oracle.t.sol
+++ b/tests/fuzz/Oracle.t.sol
@@ -717,6 +717,30 @@ contract OracleTest is Fixture, FunctionUtils {
     parallelizer.updateOracle(collateral);
   }
 
+  function test_revertWhen_updateOracle_AboveRatchetStep() public {
+    vm.prank(governor);
+    parallelizer.toggleTrusted(alice, Storage.TrustedType.Seller);
+
+    address collateral = _collaterals[0];
+    (Storage.OracleReadType readType,, bytes memory data,,) = parallelizer.getOracle(collateral);
+    (uint256 oracleValue,,,,) = parallelizer.getOracleValues(collateral);
+
+    vm.prank(governor);
+    parallelizer.setOracle(
+      collateral,
+      abi.encode(readType, Storage.OracleReadType.MAX, data, abi.encode(oracleValue), abi.encode(uint128(0), uint128(0)))
+    );
+
+    (, int256 currentValue,,,) = _oracles[0].latestRoundData();
+    // One wei above the largest increase a single ratchet may apply
+    uint256 aboveCap = (uint256(currentValue) * (BASE_18 + MAX_ORACLE_RATCHET_STEP)) / BASE_18 + 1;
+    MockChainlinkOracle(address(_oracles[0])).setLatestAnswer(int256(aboveCap));
+
+    vm.prank(alice);
+    vm.expectRevert(Errors.OracleUpdateFailed.selector);
+    parallelizer.updateOracle(collateral);
+  }
+
   function testFuzz_updateOracle_Success(uint256 updateOracleValue, uint32 heartbeat) public {
     vm.prank(governor);
     parallelizer.toggleTrusted(alice, Storage.TrustedType.Seller);
@@ -743,8 +767,14 @@ contract OracleTest is Fixture, FunctionUtils {
     uint256 newOracleValue;
     {
       (, int256 oracleValueTmp,,,) = _oracles[indexCollat].latestRoundData();
-      updateOracleValue = bound(updateOracleValue, uint256(oracleValueTmp) + 1, _maxOracleValue);
-      if (updateOracleValue > _maxOracleValue) return;
+      uint256 currentValue = uint256(oracleValueTmp);
+      // A single ratchet cannot lift the target by more than `MAX_ORACLE_RATCHET_STEP`
+      uint256 upperBound = (currentValue * (BASE_18 + MAX_ORACLE_RATCHET_STEP)) / BASE_18;
+      if (upperBound > _maxOracleValue) upperBound = _maxOracleValue;
+      uint256 lowerBound = currentValue + 1;
+      if (lowerBound < _minOracleValue * 10) lowerBound = _minOracleValue * 10;
+      if (lowerBound > upperBound) return;
+      updateOracleValue = bound(updateOracleValue, lowerBound, upperBound);
 
       uint256[3] memory latestOracleValue = [updateOracleValue, BASE_8, BASE_8];
       latestOracleValue = _updateOracleValues(latestOracleValue);

From dda91448409288447d739aea890ca9d66099ff27 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 10:12:42 +0300
Subject: [PATCH 04/28] fix(harvester): make setMaxSlippage write the live
 limit

setMaxSlippage wrote to maxTokenSlippage, a mapping no harvest path
reads: every live check uses yieldBearingData[asset].maxSlippage. A
governance tightening therefore appeared to succeed on chain while
leaving the effective limit untouched.

The setter now writes the parameter the harvests read, the dead mapping
is removed, and the bound matches setYieldBearingAssetData: 1e9 means
zero slippage protection and is rejected.

Closes Bailsec Core Issue_03.
---
 contracts/helpers/BaseHarvester.sol |  6 ++--
 tests/units/Harvester.t.sol         | 53 +++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 4 deletions(-)
 create mode 100644 tests/units/Harvester.t.sol

diff --git a/contracts/helpers/BaseHarvester.sol b/contracts/helpers/BaseHarvester.sol
index 4f6fc9a..5b618a7 100644
--- a/contracts/helpers/BaseHarvester.sol
+++ b/contracts/helpers/BaseHarvester.sol
@@ -67,8 +67,6 @@ abstract contract BaseHarvester is IHarvester, AccessManaged {
   IParallelizer public immutable parallelizer;
   /// @notice TokenP handled by the `parallelizer` of interest
   ITokenP public immutable tokenP;
-  /// @notice Max slippage when dealing with the Parallelizer
-  mapping(address => uint96) public maxTokenSlippage;
   /// @notice Data associated to a yield bearing asset
   mapping(address => YieldBearingParams) public yieldBearingData;
   /// @notice trusted addresses that can update target exposure and do others non critical operations
@@ -283,8 +281,8 @@ abstract contract BaseHarvester is IHarvester, AccessManaged {
   }
 
   function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {
-    if (newMaxSlippage > 1e9) revert InvalidParam();
-    maxTokenSlippage[yieldBearingAsset] = newMaxSlippage;
+    if (newMaxSlippage >= 1e9) revert InvalidParam();
+    yieldBearingData[yieldBearingAsset].maxSlippage = newMaxSlippage;
   }
 
   function _scaleAmountBasedOnDecimals(
diff --git a/tests/units/Harvester.t.sol b/tests/units/Harvester.t.sol
new file mode 100644
index 0000000..5c3aa6d
--- /dev/null
+++ b/tests/units/Harvester.t.sol
@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: BUSL-1.1
+
+pragma solidity 0.8.28;
+
+import { MultiBlockHarvester } from "contracts/helpers/MultiBlockHarvester.sol";
+import { IParallelizer } from "contracts/interfaces/IParallelizer.sol";
+import "contracts/utils/Constants.sol";
+import "contracts/utils/Errors.sol" as Errors;
+
+import { Fixture } from "../Fixture.sol";
+
+contract Test_Harvester_MaxSlippage is Fixture {
+  MultiBlockHarvester internal harvester;
+
+  address internal yieldBearingAsset;
+
+  function setUp() public override {
+    super.setUp();
+
+    yieldBearingAsset = address(eurY);
+    harvester = new MultiBlockHarvester(address(accessManager), tokenP, IParallelizer(address(parallelizer)));
+
+    vm.startPrank(governor);
+    accessManager.setTargetFunctionRole(
+      address(harvester), getGuardianBaseHarvesterSelectorAccess(), GUARDIAN_ROLE
+    );
+    accessManager.grantRole(GUARDIAN_ROLE, guardian, 0);
+    vm.stopPrank();
+
+    vm.prank(guardian);
+    harvester.setYieldBearingAssetData(yieldBearingAsset, address(eurA), 5e8, 1e8, 9e8, 1, 5e7);
+  }
+
+  function test_SetMaxSlippage_UpdatesTheLiveLimit() public {
+    vm.prank(guardian);
+    harvester.setMaxSlippage(yieldBearingAsset, 1e7);
+
+    (,,,,, uint96 maxSlippage) = harvester.yieldBearingData(yieldBearingAsset);
+    assertEq(maxSlippage, 1e7);
+  }
+
+  function test_RevertWhen_SetMaxSlippageIsFullSlippage() public {
+    vm.prank(guardian);
+    vm.expectRevert(Errors.InvalidParam.selector);
+    harvester.setMaxSlippage(yieldBearingAsset, 1e9);
+  }
+
+  function test_RevertWhen_SetMaxSlippageNotGuardian() public {
+    vm.prank(alice);
+    vm.expectRevert(abi.encodeWithSelector(Errors.AccessManagedUnauthorized.selector, alice));
+    harvester.setMaxSlippage(yieldBearingAsset, 1e7);
+  }
+}

From e744bdf89224226805a134ab011bf3ae783bcbfc Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 10:22:18 +0300
Subject: [PATCH 05/28] fix(harvester): reject partial router fills and credit
 positive settlement

Two defects in onFlashLoan, both already carried by the unmerged
rebalancer work and ported here so the audit remediation is complete on
its own.

The router was assumed to consume the full declared input while only the
output balance was checked. A partial fill left both the unspent input
and its standing allowance on the contract, outside the Parallelizer's
accounting. The input balance is now compared across the swap.

Settlement was also asymmetric: a shortfall was charged to the initiating
caller while a surplus stayed as an unattributed contract balance the
caller could not withdraw. The positive branch now credits the caller.

Closes Bailsec Core Issue_07 and Issue_08.
---
 contracts/helpers/GenericHarvester.sol | 11 ++++++++++-
 contracts/utils/Errors.sol             |  1 +
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/contracts/helpers/GenericHarvester.sol b/contracts/helpers/GenericHarvester.sol
index cf2efcb..a46f909 100644
--- a/contracts/helpers/GenericHarvester.sol
+++ b/contracts/helpers/GenericHarvester.sol
@@ -155,17 +155,26 @@ contract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper
         tokenOut = asset;
       }
     }
+    uint256 tokenInBalanceBefore = IERC20(tokenIn).balanceOf(address(this));
+
     uint256 amountOut =
       parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);
 
-    // Swap to tokenIn
+    // Swap to tokenOut
     amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);
 
+    // A partial fill would leave both the unspent input and its router allowance on this contract
+    if (IERC20(tokenIn).balanceOf(address(this)) > tokenInBalanceBefore) {
+      revert RouterDidNotConsumeAllTokens();
+    }
+
     _adjustAllowance(tokenOut, address(parallelizer), amountOut);
     uint256 amountStableOut =
       parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);
     if (amount > amountStableOut) {
       budget[sender] -= amount - amountStableOut; // Will revert if not enough funds
+    } else if (amountStableOut > amount) {
+      budget[sender] += amountStableOut - amount;
     }
     return CALLBACK_SUCCESS;
   }
diff --git a/contracts/utils/Errors.sol b/contracts/utils/Errors.sol
index 6ee3525..39b1db1 100644
--- a/contracts/utils/Errors.sol
+++ b/contracts/utils/Errors.sol
@@ -55,6 +55,7 @@ error ZeroAddress();
 error ZeroAmount();
 error ZeroSurplusAmount();
 error SwapError();
+error RouterDidNotConsumeAllTokens();
 error SlippageTooHigh();
 error InsufficientFunds();
 error Undercollateralized();

From fc99cdb56f37c333000a331622a129f64464b4ed Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 10:42:34 +0300
Subject: [PATCH 06/28] refactor(rebalancer): rename Harvester to Rebalancer

The contracts adjust the Parallelizer's exposure between a yield bearing
asset and its underlying, they do not collect yield, so Rebalancer is the
accurate name. It also aligns this repository with the contracts already
deployed under that name on Base and Avalanche.

Renamed: BaseHarvester, GenericHarvester and MultiBlockHarvester, along
with their deploy scripts, configuration keys and registry entries. The
IHarvester interface and the legacy ContractType.Harvester entry keep
their names so registry ordinals are unchanged, matching the deployed
contracts. Existing deployment records are left untouched: they document
what was deployed under the old name.
---
 README.md                                     | 10 +++----
 .../{BaseHarvester.sol => BaseRebalancer.sol} | 10 +++----
 ...ricHarvester.sol => GenericRebalancer.sol} | 12 ++++----
 ...Harvester.sol => MultiBlockRebalancer.sol} | 12 ++++----
 deploy/config/avalanche/config.json           |  2 +-
 deploy/config/base/config.json                |  2 +-
 deploy/config/hyperevm/config.json            |  2 +-
 deploy/config/mainnet/config.json             |  2 +-
 deploy/config/sonic/config.json               |  2 +-
 ...nericHarvester.ts => GenericRebalancer.ts} | 16 +++++------
 deploy/utils/types.ts                         |  6 ++--
 ...BaseHarvester.d.ts => BaseRebalancer.d.ts} | 23 ++-------------
 .../{BaseHarvester.js => BaseRebalancer.js}   | 21 +-------------
 generated/abis/DiamondInitializer.d.ts        | 25 +++++++++++++++++
 generated/abis/DiamondInitializer.js          | 25 +++++++++++++++++
 ...cHarvester.d.ts => GenericRebalancer.d.ts} | 28 +++++--------------
 ...nericHarvester.js => GenericRebalancer.js} | 26 ++++-------------
 generated/abis/LibOracle.d.ts                 | 28 ++++++++++++++++++-
 generated/abis/LibOracle.js                   | 28 ++++++++++++++++++-
 ...rvester.d.ts => MultiBlockRebalancer.d.ts} | 23 ++-------------
 ...ckHarvester.js => MultiBlockRebalancer.js} | 21 +-------------
 generated/abis/SettersGovernor.d.ts           | 25 +++++++++++++++++
 generated/abis/SettersGovernor.js             | 25 +++++++++++++++++
 generated/abis/index.d.ts                     |  7 +++--
 generated/abis/index.js                       |  7 +++--
 libs/helpers/CommonUtils.sol                  |  8 +++---
 libs/helpers/Constants.sol                    |  4 +--
 libs/helpers/registry/registry.json           |  4 +--
 scripts/SetGenericHarvesterRoles.s.sol        | 26 -----------------
 scripts/SetGenericRebalancerRoles.s.sol       | 26 +++++++++++++++++
 ...l => SetupGenericRebalancerExposure.s.sol} | 10 +++----
 .../{Harvester.t.sol => Rebalancer.t.sol}     | 20 ++++++-------
 tests/utils/ConfigAccessManager.sol           | 28 +++++++++----------
 33 files changed, 282 insertions(+), 232 deletions(-)
 rename contracts/helpers/{BaseHarvester.sol => BaseRebalancer.sol} (97%)
 rename contracts/helpers/{GenericHarvester.sol => GenericRebalancer.sol} (96%)
 rename contracts/helpers/{MultiBlockHarvester.sol => MultiBlockRebalancer.sol} (96%)
 rename deploy/scripts/{GenericHarvester.ts => GenericRebalancer.ts} (71%)
 rename generated/abis/{BaseHarvester.d.ts => BaseRebalancer.d.ts} (94%)
 rename generated/abis/{BaseHarvester.js => BaseRebalancer.js} (95%)
 rename generated/abis/{GenericHarvester.d.ts => GenericRebalancer.d.ts} (96%)
 rename generated/abis/{GenericHarvester.js => GenericRebalancer.js} (97%)
 rename generated/abis/{MultiBlockHarvester.d.ts => MultiBlockRebalancer.d.ts} (95%)
 rename generated/abis/{MultiBlockHarvester.js => MultiBlockRebalancer.js} (96%)
 delete mode 100644 scripts/SetGenericHarvesterRoles.s.sol
 create mode 100644 scripts/SetGenericRebalancerRoles.s.sol
 rename scripts/{SetupGenericHarvesterExposure.s.sol => SetupGenericRebalancerExposure.s.sol} (61%)
 rename tests/units/{Harvester.t.sol => Rebalancer.t.sol} (59%)

diff --git a/README.md b/README.md
index f1ba6af..6356c98 100644
--- a/README.md
+++ b/README.md
@@ -73,7 +73,7 @@ Some changed has been made to the original Angle's Transmuter:
 | Swapper Facet         | [0x506Ba37aa8e265bE445913B9c4080852277f3c5a](https:///etherscan.io/address/0x506Ba37aa8e265bE445913B9c4080852277f3c5a) |
 | Parallelizer USDp     | [0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2](https:///etherscan.io/address/0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2) |
 | sUSDp (Savings)       | [0x0d45b129dc868963025Db79A9074EA9c9e32Cae4](https:///etherscan.io/address/0x0d45b129dc868963025Db79A9074EA9c9e32Cae4) |
-| GenericHarvester USDp | [0x36DA06796fD9d22BCD6287b66A87FfdadB12636C](https:///etherscan.io/address/0x36DA06796fD9d22BCD6287b66A87FfdadB12636C) |
+| GenericRebalancer USDp | [0x36DA06796fD9d22BCD6287b66A87FfdadB12636C](https:///etherscan.io/address/0x36DA06796fD9d22BCD6287b66A87FfdadB12636C) |
 
 ### Base
 
@@ -89,7 +89,7 @@ Some changed has been made to the original Angle's Transmuter:
 | Swapper Facet         | [0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7](https:///basescan.org/address/0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7) |
 | Parallelizer USDp     | [0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD](https:///basescan.org/address/0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD) |
 | sUSDp (Savings)       | [0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7](https:///basescan.org/address/0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7) |
-| GenericHarvester USDp | [0xCa43eCFCDFBA1fED003649e946Ae6091646B410a](https:///basescan.org/address/0xCa43eCFCDFBA1fED003649e946Ae6091646B410a) |
+| GenericRebalancer USDp | [0xCa43eCFCDFBA1fED003649e946Ae6091646B410a](https:///basescan.org/address/0xCa43eCFCDFBA1fED003649e946Ae6091646B410a) |
 
 ### Sonic
 
@@ -105,7 +105,7 @@ Some changed has been made to the original Angle's Transmuter:
 | Swapper Facet         | [0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF](https:///sonicscan.org/address/0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF) |
 | Parallelizer USDp     | [0xBEFBAe2330186F031b469e26283aCc66bb5F8826](https:///sonicscan.org/address/0xBEFBAe2330186F031b469e26283aCc66bb5F8826) |
 | sUSDp (Savings)       | [0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b](https:///sonicscan.org/address/0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b) |
-| GenericHarvester USDp | [0x120805265fA944834DC6e930De2995768806a9d2](https:///sonicscan.org/address/0x120805265fA944834DC6e930De2995768806a9d2) |
+| GenericRebalancer USDp | [0x120805265fA944834DC6e930De2995768806a9d2](https:///sonicscan.org/address/0x120805265fA944834DC6e930De2995768806a9d2) |
 
 #### HyperEVM
 
@@ -121,7 +121,7 @@ Some changed has been made to the original Angle's Transmuter:
 | Swapper Facet         | [0x1b2741dB9F46a0411852e4cC28dDC476851b5179](https:///www.hyperscan.com/address/0x1b2741dB9F46a0411852e4cC28dDC476851b5179) |
 | Parallelizer USDp     | [0x1250304F66404cd153fA39388DDCDAec7E0f1707](https:///www.hyperscan.com/address/0x1250304F66404cd153fA39388DDCDAec7E0f1707) |
 | sUSDp (Savings)       | [0x9B3a8f7CEC208e247d97dEE13313690977e24459](https:///www.hyperscan.com/address/0x9B3a8f7CEC208e247d97dEE13313690977e24459) |
-| GenericHarvester USDp | [0x57770C1721Eb35509f38210A935c8b1911db7E0e](https:///www.hyperscan.com/address/0x57770C1721Eb35509f38210A935c8b1911db7E0e) |
+| GenericRebalancer USDp | [0x57770C1721Eb35509f38210A935c8b1911db7E0e](https:///www.hyperscan.com/address/0x57770C1721Eb35509f38210A935c8b1911db7E0e) |
 
 #### Avalanche
 
@@ -137,7 +137,7 @@ Some changed has been made to the original Angle's Transmuter:
 | Swapper Facet         | [0x57265a3D7db8f4a4a155eadF6c7326926caC1490](https:///www.snowscan.xyz/address/0x57265a3D7db8f4a4a155eadF6c7326926caC1490) |
 | Parallelizer USDp     | [0x41d58951cbd12D4Ef49b0437897677bbF5547C80](https:///www.snowscan.xyz/address/0x41d58951cbd12D4Ef49b0437897677bbF5547C80) |
 | sUSDp (Savings)       | [0x9d92c21205383651610f90722131655a5b8ed3e0](https:///www.snowscan.xyz/address/0x9d92c21205383651610f90722131655a5b8ed3e0) |
-| GenericHarvester USDp | [0x0d45b129dc868963025db79a9074ea9c9e32cae4](https:///www.snowscan.xyz/address/0x0d45b129dc868963025db79a9074ea9c9e32cae4) |
+| GenericRebalancer USDp | [0x0d45b129dc868963025db79a9074ea9c9e32cae4](https:///www.snowscan.xyz/address/0x0d45b129dc868963025db79a9074ea9c9e32cae4) |
 
 ### Testnet
 
diff --git a/contracts/helpers/BaseHarvester.sol b/contracts/helpers/BaseRebalancer.sol
similarity index 97%
rename from contracts/helpers/BaseHarvester.sol
rename to contracts/helpers/BaseRebalancer.sol
index 5b618a7..79d21ba 100644
--- a/contracts/helpers/BaseHarvester.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -26,13 +26,13 @@ struct YieldBearingParams {
   uint96 maxSlippage;
 }
 
-/// @title BaseHarvester
+/// @title BaseRebalancer
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
-/// @dev Abstract contract for a harvester that aims at rebalancing a Parallelizer
-/// @dev This contract is an authorized fork of Angle's BaseHarvester contract:
-/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol
-abstract contract BaseHarvester is IHarvester, AccessManaged {
+/// @dev Abstract contract for a rebalancer that aims at rebalancing a Parallelizer
+/// @dev This contract is an authorized fork of Angle's BaseRebalancer contract:
+/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseRebalancer.sol
+abstract contract BaseRebalancer is IHarvester, AccessManaged {
   using SafeERC20 for IERC20;
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
diff --git a/contracts/helpers/GenericHarvester.sol b/contracts/helpers/GenericRebalancer.sol
similarity index 96%
rename from contracts/helpers/GenericHarvester.sol
rename to contracts/helpers/GenericRebalancer.sol
index a46f909..32dd100 100644
--- a/contracts/helpers/GenericHarvester.sol
+++ b/contracts/helpers/GenericRebalancer.sol
@@ -15,20 +15,20 @@ import { IERC4626 } from "contracts/interfaces/external/IERC4626.sol";
 
 import "../utils/Errors.sol";
 
-import { BaseHarvester, YieldBearingParams } from "./BaseHarvester.sol";
+import { BaseRebalancer, YieldBearingParams } from "./BaseRebalancer.sol";
 
 enum SwapType {
   VAULT,
   SWAP
 }
 
-/// @title GenericHarvester
+/// @title GenericRebalancer
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
 /// @dev Generic contract for trusted callers to adjust the reserves of Angle Parallelizer
-/// @dev This contract is an authorized fork of Angle's GenericHarvester contract:
-/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol
-contract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {
+/// @dev This contract is an authorized fork of Angle's GenericRebalancer contract:
+/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericRebalancer.sol
+contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapper {
   using SafeCast for uint256;
   using SafeERC20 for IERC20;
 
@@ -52,7 +52,7 @@ contract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper
     IERC3156FlashLender definitiveFlashloan
   )
     RouterSwapper(initialSwapRouter, initialTokenTransferAddress)
-    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)
+    BaseRebalancer(initialAuthority, definitivetokenP, definitiveParallelizer)
   {
     if (address(definitiveFlashloan) == address(0)) revert ZeroAddress();
     flashloan = definitiveFlashloan;
diff --git a/contracts/helpers/MultiBlockHarvester.sol b/contracts/helpers/MultiBlockRebalancer.sol
similarity index 96%
rename from contracts/helpers/MultiBlockHarvester.sol
rename to contracts/helpers/MultiBlockRebalancer.sol
index c050e75..d8b9697 100644
--- a/contracts/helpers/MultiBlockHarvester.sol
+++ b/contracts/helpers/MultiBlockRebalancer.sol
@@ -5,7 +5,7 @@ import { IERC20Metadata } from "@openzeppelin/contracts/token/ERC20/extensions/I
 import { SafeERC20 } from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
 import { Math } from "@openzeppelin/contracts/utils/math/Math.sol";
 import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
-import { BaseHarvester, YieldBearingParams } from "./BaseHarvester.sol";
+import { BaseRebalancer, YieldBearingParams } from "./BaseRebalancer.sol";
 import { IParallelizer } from "contracts/interfaces/IParallelizer.sol";
 import { ITokenP } from "contracts/interfaces/ITokenP.sol";
 import { IPool } from "contracts/interfaces/IPool.sol";
@@ -13,13 +13,13 @@ import { IPool } from "contracts/interfaces/IPool.sol";
 import "../utils/Errors.sol";
 import "../utils/Constants.sol";
 
-/// @title MultiBlockHarvester
+/// @title MultiBlockRebalancer
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
 /// @dev Contract to harvest yield from multiple yield bearing assets in multiple blocks transactions
-/// @dev This contract is an authorized fork of Angle's MultiBlockHarvester contract:
-/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/MultiBlockHarvester.sol
-contract MultiBlockHarvester is BaseHarvester {
+/// @dev This contract is an authorized fork of Angle's MultiBlockRebalancer contract:
+/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/MultiBlockRebalancer.sol
+contract MultiBlockRebalancer is BaseRebalancer {
   using SafeERC20 for IERC20;
   using Math for uint256;
 
@@ -39,7 +39,7 @@ contract MultiBlockHarvester is BaseHarvester {
     ITokenP definitivetokenP,
     IParallelizer definitiveParallelizer
   )
-    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)
+    BaseRebalancer(initialAuthority, definitivetokenP, definitiveParallelizer)
   { }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
diff --git a/deploy/config/avalanche/config.json b/deploy/config/avalanche/config.json
index 5d10d47..3594b30 100644
--- a/deploy/config/avalanche/config.json
+++ b/deploy/config/avalanche/config.json
@@ -59,7 +59,7 @@
       "symbol": "sUSDp"
     }
   },
-  "genericHarvester": {
+  "genericRebalancer": {
     "usdp": {
       "swapRouter": "0x88de50b233052e4fb783d4f6db78cc34fea3e9fc",
       "tokenTransferAddress": "0x88de50b233052e4fb783d4f6db78cc34fea3e9fc",
diff --git a/deploy/config/base/config.json b/deploy/config/base/config.json
index f6a6c4d..beb60e7 100644
--- a/deploy/config/base/config.json
+++ b/deploy/config/base/config.json
@@ -59,7 +59,7 @@
       "symbol": "sUSDp"
     }
   },
-  "genericHarvester": {
+  "genericRebalancer": {
     "usdp": {
       "swapRouter": "0x19ceead7105607cd444f5ad10dd51356436095a1",
       "tokenTransferAddress": "0x19ceead7105607cd444f5ad10dd51356436095a1",
diff --git a/deploy/config/hyperevm/config.json b/deploy/config/hyperevm/config.json
index 3af5446..e98b3dc 100644
--- a/deploy/config/hyperevm/config.json
+++ b/deploy/config/hyperevm/config.json
@@ -62,7 +62,7 @@
       "symbol": "sUSDp"
     }
   },
-  "genericHarvester": {
+  "genericRebalancer": {
     "usdp": {
       "swapRouter": "0x744489ee3d540777a66f2cf297479745e0852f7a",
       "tokenTransferAddress": "0x744489ee3d540777a66f2cf297479745e0852f7a",
diff --git a/deploy/config/mainnet/config.json b/deploy/config/mainnet/config.json
index 83cbc8d..236a4ff 100644
--- a/deploy/config/mainnet/config.json
+++ b/deploy/config/mainnet/config.json
@@ -99,7 +99,7 @@
       "symbol": "sUSDp"
     }
   },
-  "genericHarvester": {
+  "genericRebalancer": {
     "usdp": {
       "swapRouter": "0xcf5540fffcdc3d510b18bfca6d2b9987b0772559",
       "tokenTransferAddress": "0xcf5540fffcdc3d510b18bfca6d2b9987b0772559",
diff --git a/deploy/config/sonic/config.json b/deploy/config/sonic/config.json
index 53a7ba0..4a2a45c 100644
--- a/deploy/config/sonic/config.json
+++ b/deploy/config/sonic/config.json
@@ -99,7 +99,7 @@
       "symbol": "sUSDp"
     }
   },
-  "genericHarvester": {
+  "genericRebalancer": {
     "usdp": {
       "swapRouter": "0xaC041Df48dF9791B0654f1Dbbf2CC8450C5f2e9D",
       "tokenTransferAddress": "0xaC041Df48dF9791B0654f1Dbbf2CC8450C5f2e9D",
diff --git a/deploy/scripts/GenericHarvester.ts b/deploy/scripts/GenericRebalancer.ts
similarity index 71%
rename from deploy/scripts/GenericHarvester.ts
rename to deploy/scripts/GenericRebalancer.ts
index c6c3b86..69e89a2 100644
--- a/deploy/scripts/GenericHarvester.ts
+++ b/deploy/scripts/GenericRebalancer.ts
@@ -4,7 +4,7 @@ import { deployScript, artifacts } from "@rocketh";
 import { checkAddressValid, parseToConfigData } from "../utils";
 import { readFileSync } from "fs";
 
-const contractName = "GenericHarvester";
+const contractName = "GenericRebalancer";
 
 const token = "USDp";
 
@@ -28,26 +28,26 @@ export default deployScript(
       "Invalid tokenP address",
     );
 
-    const genericHarvesterConfig = config.genericHarvester[token.toLowerCase() as keyof typeof config.genericHarvester];
-    const swapRouter = checkAddressValid(genericHarvesterConfig.swapRouter, "Invalid swapRouter address");
+    const genericRebalancerConfig = config.genericRebalancer[token.toLowerCase() as keyof typeof config.genericRebalancer];
+    const swapRouter = checkAddressValid(genericRebalancerConfig.swapRouter, "Invalid swapRouter address");
     const tokenTransferAddress = checkAddressValid(
-      genericHarvesterConfig.tokenTransferAddress,
+      genericRebalancerConfig.tokenTransferAddress,
       "Invalid tokenTransferAddress address",
     );
 
-    const flashloan = checkAddressValid(genericHarvesterConfig.flashloan, "Invalid flashloan address");
+    const flashloan = checkAddressValid(genericRebalancerConfig.flashloan, "Invalid flashloan address");
     const parallelizer = get(`Parallelizer_${token}`);
     if (!parallelizer) {
       throw new Error(`Parallelizer_${token} not found`);
     }
 
-    const genericHarvester = await deploy(`${contractName}_${token}`, {
+    const genericRebalancer = await deploy(`${contractName}_${token}`, {
       account: deployer,
-      artifact: artifacts.GenericHarvester,
+      artifact: artifacts.GenericRebalancer,
       args: [tokenTransferAddress, swapRouter, tokenP, parallelizer.address, accessManager, flashloan],
     });
 
-    console.log(`Deployed ${contractName}_${token}, network: ${chainName}, address: ${genericHarvester.address}`);
+    console.log(`Deployed ${contractName}_${token}, network: ${chainName}, address: ${genericRebalancer.address}`);
   },
   {
     tags: [contractName],
diff --git a/deploy/utils/types.ts b/deploy/utils/types.ts
index 68fbdb3..902fc18 100644
--- a/deploy/utils/types.ts
+++ b/deploy/utils/types.ts
@@ -81,7 +81,7 @@ export type SavingsConfig = {
   symbol: string;
 };
 
-export type GenericHarvesterConfig = {
+export type GenericRebalancerConfig = {
   swapRouter: Address;
   tokenTransferAddress: Address;
   flashloan: Address;
@@ -101,7 +101,7 @@ export type ConfigData = {
   savings: {
     [tokenP: string]: SavingsConfig;
   };
-  genericHarvester: {
-    [tokenP: string]: GenericHarvesterConfig;
+  genericRebalancer: {
+    [tokenP: string]: GenericRebalancerConfig;
   };
 };
diff --git a/generated/abis/BaseHarvester.d.ts b/generated/abis/BaseRebalancer.d.ts
similarity index 94%
rename from generated/abis/BaseHarvester.d.ts
rename to generated/abis/BaseRebalancer.d.ts
index b8e44df..c2b2c58 100644
--- a/generated/abis/BaseHarvester.d.ts
+++ b/generated/abis/BaseRebalancer.d.ts
@@ -1,4 +1,4 @@
-export type Abi_BaseHarvester = [
+export type Abi_BaseRebalancer = [
   {
     "inputs": [
       {
@@ -207,25 +207,6 @@ export type Abi_BaseHarvester = [
     "stateMutability": "view",
     "type": "function"
   },
-  {
-    "inputs": [
-      {
-        "internalType": "address",
-        "name": "",
-        "type": "address"
-      }
-    ],
-    "name": "maxTokenSlippage",
-    "outputs": [
-      {
-        "internalType": "uint96",
-        "name": "",
-        "type": "uint96"
-      }
-    ],
-    "stateMutability": "view",
-    "type": "function"
-  },
   {
     "inputs": [],
     "name": "parallelizer",
@@ -438,4 +419,4 @@ export type Abi_BaseHarvester = [
     "type": "function"
   }
 ];
-export declare const Abi_BaseHarvester: Abi_BaseHarvester;
+export declare const Abi_BaseRebalancer: Abi_BaseRebalancer;
diff --git a/generated/abis/BaseHarvester.js b/generated/abis/BaseRebalancer.js
similarity index 95%
rename from generated/abis/BaseHarvester.js
rename to generated/abis/BaseRebalancer.js
index 19475d9..9fbc394 100644
--- a/generated/abis/BaseHarvester.js
+++ b/generated/abis/BaseRebalancer.js
@@ -1,4 +1,4 @@
-export const Abi_BaseHarvester = /** @type {const} **/ ([
+export const Abi_BaseRebalancer = /** @type {const} **/ ([
   {
     "inputs": [
       {
@@ -207,25 +207,6 @@ export const Abi_BaseHarvester = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
-  {
-    "inputs": [
-      {
-        "internalType": "address",
-        "name": "",
-        "type": "address"
-      }
-    ],
-    "name": "maxTokenSlippage",
-    "outputs": [
-      {
-        "internalType": "uint96",
-        "name": "",
-        "type": "uint96"
-      }
-    ],
-    "stateMutability": "view",
-    "type": "function"
-  },
   {
     "inputs": [],
     "name": "parallelizer",
diff --git a/generated/abis/DiamondInitializer.d.ts b/generated/abis/DiamondInitializer.d.ts
index 618141d..b3d3555 100644
--- a/generated/abis/DiamondInitializer.d.ts
+++ b/generated/abis/DiamondInitializer.d.ts
@@ -112,6 +112,31 @@ export type Abi_DiamondInitializer = [
     "name": "OracleSet",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "collateral",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "previousTarget",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newTarget",
+        "type": "uint256"
+      }
+    ],
+    "name": "OracleTargetUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/DiamondInitializer.js b/generated/abis/DiamondInitializer.js
index 421dce0..383de8b 100644
--- a/generated/abis/DiamondInitializer.js
+++ b/generated/abis/DiamondInitializer.js
@@ -112,6 +112,31 @@ export const Abi_DiamondInitializer = /** @type {const} **/ ([
     "name": "OracleSet",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "collateral",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "previousTarget",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newTarget",
+        "type": "uint256"
+      }
+    ],
+    "name": "OracleTargetUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/GenericHarvester.d.ts b/generated/abis/GenericRebalancer.d.ts
similarity index 96%
rename from generated/abis/GenericHarvester.d.ts
rename to generated/abis/GenericRebalancer.d.ts
index d62a89e..2649a77 100644
--- a/generated/abis/GenericHarvester.d.ts
+++ b/generated/abis/GenericRebalancer.d.ts
@@ -1,4 +1,4 @@
-export type Abi_GenericHarvester = [
+export type Abi_GenericRebalancer = [
   {
     "inputs": [
       {
@@ -88,6 +88,11 @@ export type Abi_GenericHarvester = [
     "name": "NotTrustedOrGuardian",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "RouterDidNotConsumeAllTokens",
+    "type": "error"
+  },
   {
     "inputs": [
       {
@@ -352,25 +357,6 @@ export type Abi_GenericHarvester = [
     "stateMutability": "view",
     "type": "function"
   },
-  {
-    "inputs": [
-      {
-        "internalType": "address",
-        "name": "",
-        "type": "address"
-      }
-    ],
-    "name": "maxTokenSlippage",
-    "outputs": [
-      {
-        "internalType": "uint96",
-        "name": "",
-        "type": "uint96"
-      }
-    ],
-    "stateMutability": "view",
-    "type": "function"
-  },
   {
     "inputs": [
       {
@@ -692,4 +678,4 @@ export type Abi_GenericHarvester = [
     "type": "function"
   }
 ];
-export declare const Abi_GenericHarvester: Abi_GenericHarvester;
+export declare const Abi_GenericRebalancer: Abi_GenericRebalancer;
diff --git a/generated/abis/GenericHarvester.js b/generated/abis/GenericRebalancer.js
similarity index 97%
rename from generated/abis/GenericHarvester.js
rename to generated/abis/GenericRebalancer.js
index 475cb12..626c4fb 100644
--- a/generated/abis/GenericHarvester.js
+++ b/generated/abis/GenericRebalancer.js
@@ -1,4 +1,4 @@
-export const Abi_GenericHarvester = /** @type {const} **/ ([
+export const Abi_GenericRebalancer = /** @type {const} **/ ([
   {
     "inputs": [
       {
@@ -88,6 +88,11 @@ export const Abi_GenericHarvester = /** @type {const} **/ ([
     "name": "NotTrustedOrGuardian",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "RouterDidNotConsumeAllTokens",
+    "type": "error"
+  },
   {
     "inputs": [
       {
@@ -352,25 +357,6 @@ export const Abi_GenericHarvester = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
-  {
-    "inputs": [
-      {
-        "internalType": "address",
-        "name": "",
-        "type": "address"
-      }
-    ],
-    "name": "maxTokenSlippage",
-    "outputs": [
-      {
-        "internalType": "uint96",
-        "name": "",
-        "type": "uint96"
-      }
-    ],
-    "stateMutability": "view",
-    "type": "function"
-  },
   {
     "inputs": [
       {
diff --git a/generated/abis/LibOracle.d.ts b/generated/abis/LibOracle.d.ts
index 3c75f74..6705c7d 100644
--- a/generated/abis/LibOracle.d.ts
+++ b/generated/abis/LibOracle.d.ts
@@ -1,2 +1,28 @@
-export type Abi_LibOracle = [];
+export type Abi_LibOracle = [
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "collateral",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "previousTarget",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newTarget",
+        "type": "uint256"
+      }
+    ],
+    "name": "OracleTargetUpdated",
+    "type": "event"
+  }
+];
 export declare const Abi_LibOracle: Abi_LibOracle;
diff --git a/generated/abis/LibOracle.js b/generated/abis/LibOracle.js
index d801996..69e7551 100644
--- a/generated/abis/LibOracle.js
+++ b/generated/abis/LibOracle.js
@@ -1 +1,27 @@
-export const Abi_LibOracle = /** @type {const} **/ ([]);
\ No newline at end of file
+export const Abi_LibOracle = /** @type {const} **/ ([
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "collateral",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "previousTarget",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newTarget",
+        "type": "uint256"
+      }
+    ],
+    "name": "OracleTargetUpdated",
+    "type": "event"
+  }
+]);
\ No newline at end of file
diff --git a/generated/abis/MultiBlockHarvester.d.ts b/generated/abis/MultiBlockRebalancer.d.ts
similarity index 95%
rename from generated/abis/MultiBlockHarvester.d.ts
rename to generated/abis/MultiBlockRebalancer.d.ts
index 1320704..96cff3f 100644
--- a/generated/abis/MultiBlockHarvester.d.ts
+++ b/generated/abis/MultiBlockRebalancer.d.ts
@@ -1,4 +1,4 @@
-export type Abi_MultiBlockHarvester = [
+export type Abi_MultiBlockRebalancer = [
   {
     "inputs": [
       {
@@ -261,25 +261,6 @@ export type Abi_MultiBlockHarvester = [
     "stateMutability": "view",
     "type": "function"
   },
-  {
-    "inputs": [
-      {
-        "internalType": "address",
-        "name": "",
-        "type": "address"
-      }
-    ],
-    "name": "maxTokenSlippage",
-    "outputs": [
-      {
-        "internalType": "uint96",
-        "name": "",
-        "type": "uint96"
-      }
-    ],
-    "stateMutability": "view",
-    "type": "function"
-  },
   {
     "inputs": [],
     "name": "parallelizer",
@@ -529,4 +510,4 @@ export type Abi_MultiBlockHarvester = [
     "type": "function"
   }
 ];
-export declare const Abi_MultiBlockHarvester: Abi_MultiBlockHarvester;
+export declare const Abi_MultiBlockRebalancer: Abi_MultiBlockRebalancer;
diff --git a/generated/abis/MultiBlockHarvester.js b/generated/abis/MultiBlockRebalancer.js
similarity index 96%
rename from generated/abis/MultiBlockHarvester.js
rename to generated/abis/MultiBlockRebalancer.js
index cd433b6..c2abb49 100644
--- a/generated/abis/MultiBlockHarvester.js
+++ b/generated/abis/MultiBlockRebalancer.js
@@ -1,4 +1,4 @@
-export const Abi_MultiBlockHarvester = /** @type {const} **/ ([
+export const Abi_MultiBlockRebalancer = /** @type {const} **/ ([
   {
     "inputs": [
       {
@@ -261,25 +261,6 @@ export const Abi_MultiBlockHarvester = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
-  {
-    "inputs": [
-      {
-        "internalType": "address",
-        "name": "",
-        "type": "address"
-      }
-    ],
-    "name": "maxTokenSlippage",
-    "outputs": [
-      {
-        "internalType": "uint96",
-        "name": "",
-        "type": "uint96"
-      }
-    ],
-    "stateMutability": "view",
-    "type": "function"
-  },
   {
     "inputs": [],
     "name": "parallelizer",
diff --git a/generated/abis/SettersGovernor.d.ts b/generated/abis/SettersGovernor.d.ts
index 86591a0..7b99c32 100644
--- a/generated/abis/SettersGovernor.d.ts
+++ b/generated/abis/SettersGovernor.d.ts
@@ -283,6 +283,31 @@ export type Abi_SettersGovernor = [
     "name": "OracleSet",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "collateral",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "previousTarget",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newTarget",
+        "type": "uint256"
+      }
+    ],
+    "name": "OracleTargetUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/SettersGovernor.js b/generated/abis/SettersGovernor.js
index b75adf4..b09aaa5 100644
--- a/generated/abis/SettersGovernor.js
+++ b/generated/abis/SettersGovernor.js
@@ -283,6 +283,31 @@ export const Abi_SettersGovernor = /** @type {const} **/ ([
     "name": "OracleSet",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "collateral",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "previousTarget",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "newTarget",
+        "type": "uint256"
+      }
+    ],
+    "name": "OracleTargetUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/index.d.ts b/generated/abis/index.d.ts
index 77a69c7..a554fcb 100644
--- a/generated/abis/index.d.ts
+++ b/generated/abis/index.d.ts
@@ -1,6 +1,6 @@
-export {Abi_BaseHarvester as BaseHarvester} from "./BaseHarvester.js"
-export {Abi_GenericHarvester as GenericHarvester} from "./GenericHarvester.js"
-export {Abi_MultiBlockHarvester as MultiBlockHarvester} from "./MultiBlockHarvester.js"
+export {Abi_BaseRebalancer as BaseRebalancer} from "./BaseRebalancer.js"
+export {Abi_GenericRebalancer as GenericRebalancer} from "./GenericRebalancer.js"
+export {Abi_MultiBlockRebalancer as MultiBlockRebalancer} from "./MultiBlockRebalancer.js"
 export {Abi_IDiamondCut as IDiamondCut} from "./IDiamondCut.js"
 export {Abi_IDiamondEtherscan as IDiamondEtherscan} from "./IDiamondEtherscan.js"
 export {Abi_IDiamondLoupe as IDiamondLoupe} from "./IDiamondLoupe.js"
@@ -58,6 +58,7 @@ export {Abi_BaseSavings as BaseSavings} from "./BaseSavings.js"
 export {Abi_EIP3009 as EIP3009} from "./EIP3009.js"
 export {Abi_Savings as Savings} from "./Savings.js"
 export {Abi_SavingsEIP3009 as SavingsEIP3009} from "./SavingsEIP3009.js"
+export {Abi_SavingsSunset as SavingsSunset} from "./SavingsSunset.js"
 export {Abi_SavingsNameable as SavingsNameable} from "./SavingsNameable.js"
 export {Abi_AccessManaged as AccessManaged} from "./AccessManaged.js"
 export {Abi_AccessManagedUpgradeable as AccessManagedUpgradeable} from "./AccessManagedUpgradeable.js"
diff --git a/generated/abis/index.js b/generated/abis/index.js
index 77a69c7..a554fcb 100644
--- a/generated/abis/index.js
+++ b/generated/abis/index.js
@@ -1,6 +1,6 @@
-export {Abi_BaseHarvester as BaseHarvester} from "./BaseHarvester.js"
-export {Abi_GenericHarvester as GenericHarvester} from "./GenericHarvester.js"
-export {Abi_MultiBlockHarvester as MultiBlockHarvester} from "./MultiBlockHarvester.js"
+export {Abi_BaseRebalancer as BaseRebalancer} from "./BaseRebalancer.js"
+export {Abi_GenericRebalancer as GenericRebalancer} from "./GenericRebalancer.js"
+export {Abi_MultiBlockRebalancer as MultiBlockRebalancer} from "./MultiBlockRebalancer.js"
 export {Abi_IDiamondCut as IDiamondCut} from "./IDiamondCut.js"
 export {Abi_IDiamondEtherscan as IDiamondEtherscan} from "./IDiamondEtherscan.js"
 export {Abi_IDiamondLoupe as IDiamondLoupe} from "./IDiamondLoupe.js"
@@ -58,6 +58,7 @@ export {Abi_BaseSavings as BaseSavings} from "./BaseSavings.js"
 export {Abi_EIP3009 as EIP3009} from "./EIP3009.js"
 export {Abi_Savings as Savings} from "./Savings.js"
 export {Abi_SavingsEIP3009 as SavingsEIP3009} from "./SavingsEIP3009.js"
+export {Abi_SavingsSunset as SavingsSunset} from "./SavingsSunset.js"
 export {Abi_SavingsNameable as SavingsNameable} from "./SavingsNameable.js"
 export {Abi_AccessManaged as AccessManaged} from "./AccessManaged.js"
 export {Abi_AccessManagedUpgradeable as AccessManagedUpgradeable} from "./AccessManagedUpgradeable.js"
diff --git a/libs/helpers/CommonUtils.sol b/libs/helpers/CommonUtils.sol
index dd45412..35cac93 100644
--- a/libs/helpers/CommonUtils.sol
+++ b/libs/helpers/CommonUtils.sol
@@ -209,10 +209,10 @@ contract CommonUtils is CommonBase, JsonReader {
       return "USD.Treasury";
     } else if (name == ContractType.FlashLoan) {
       return "FlashLoan";
-    } else if (name == ContractType.MultiBlockHarvester) {
-      return "USD.MultiBlockHarvester";
-    } else if (name == ContractType.GenericHarvester) {
-      return "USD.GenericHarvester";
+    } else if (name == ContractType.MultiBlockRebalancer) {
+      return "USD.MultiBlockRebalancer";
+    } else if (name == ContractType.GenericRebalancer) {
+      return "USD.GenericRebalancer";
     } else if (name == ContractType.Harvester) {
       return "USD.Harvester";
     } else if (name == ContractType.Rebalancer) {
diff --git a/libs/helpers/Constants.sol b/libs/helpers/Constants.sol
index 4f7ee3b..0902649 100644
--- a/libs/helpers/Constants.sol
+++ b/libs/helpers/Constants.sol
@@ -23,8 +23,8 @@ enum ContractType {
   TreasuryEURp,
   TreasuryUSDp,
   FlashLoan,
-  MultiBlockHarvester,
-  GenericHarvester,
+  MultiBlockRebalancer,
+  GenericRebalancer,
   Harvester,
   Rebalancer,
   MulticallWithFailure,
diff --git a/libs/helpers/registry/registry.json b/libs/helpers/registry/registry.json
index ba3563c..c99988a 100644
--- a/libs/helpers/registry/registry.json
+++ b/libs/helpers/registry/registry.json
@@ -14,8 +14,8 @@
       "Transmuter": "0x000000000000000000000000000000000000000d",
       "Treasury": "0x000000000000000000000000000000000000000f",
       "Harvester": "0x0000000000000000000000000000000000000013",
-      "GenericHarvester": "0x0000000000000000000000000000000000000012",
-      "MultiBlockHarvester": "0x0000000000000000000000000000000000000011",
+      "GenericRebalancer": "0x0000000000000000000000000000000000000012",
+      "MultiBlockRebalancer": "0x0000000000000000000000000000000000000011",
       "Rebalancer": "0x0000000000000000000000000000000000000014"
     },
     "PRL": "0x0000000000000000000000000000000000000005",
diff --git a/scripts/SetGenericHarvesterRoles.s.sol b/scripts/SetGenericHarvesterRoles.s.sol
deleted file mode 100644
index 4a37568..0000000
--- a/scripts/SetGenericHarvesterRoles.s.sol
+++ /dev/null
@@ -1,26 +0,0 @@
-// SPDX-License-Identifier: MIT
-pragma solidity 0.8.28;
-
-import "./Base.s.sol";
-
-import { GenericHarvester } from "contracts/helpers/GenericHarvester.sol";
-import { BaseHarvester } from "contracts/helpers/BaseHarvester.sol";
-
-contract SetGenericHarvesterRoles is BaseScript {
-  address genericHarvester = 0x57770C1721Eb35509f38210A935c8b1911db7E0e;
-
-  function run() public broadcast {
-    bytes4[] memory guardianSelectors = new bytes4[](5);
-    guardianSelectors[0] = BaseHarvester.setYieldBearingAssetData.selector;
-    guardianSelectors[1] = BaseHarvester.setMaxSlippage.selector;
-    guardianSelectors[2] = BaseHarvester.toggleTrusted.selector;
-    guardianSelectors[3] = BaseHarvester.recoverERC20.selector;
-    guardianSelectors[4] = BaseHarvester.setTargetExposure.selector;
-    accessManager.setTargetFunctionRole(genericHarvester, guardianSelectors, Roles.GUARDIAN_ROLE);
-
-    bytes4[] memory governorSelectors = new bytes4[](2);
-    governorSelectors[0] = GenericHarvester.setTokenTransferAddress.selector;
-    governorSelectors[1] = GenericHarvester.setSwapRouter.selector;
-    accessManager.setTargetFunctionRole(genericHarvester, governorSelectors, Roles.GOVERNOR_ROLE);
-  }
-}
diff --git a/scripts/SetGenericRebalancerRoles.s.sol b/scripts/SetGenericRebalancerRoles.s.sol
new file mode 100644
index 0000000..6f81662
--- /dev/null
+++ b/scripts/SetGenericRebalancerRoles.s.sol
@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.28;
+
+import "./Base.s.sol";
+
+import { GenericRebalancer } from "contracts/helpers/GenericRebalancer.sol";
+import { BaseRebalancer } from "contracts/helpers/BaseRebalancer.sol";
+
+contract SetGenericRebalancerRoles is BaseScript {
+  address genericRebalancer = 0x57770C1721Eb35509f38210A935c8b1911db7E0e;
+
+  function run() public broadcast {
+    bytes4[] memory guardianSelectors = new bytes4[](5);
+    guardianSelectors[0] = BaseRebalancer.setYieldBearingAssetData.selector;
+    guardianSelectors[1] = BaseRebalancer.setMaxSlippage.selector;
+    guardianSelectors[2] = BaseRebalancer.toggleTrusted.selector;
+    guardianSelectors[3] = BaseRebalancer.recoverERC20.selector;
+    guardianSelectors[4] = BaseRebalancer.setTargetExposure.selector;
+    accessManager.setTargetFunctionRole(genericRebalancer, guardianSelectors, Roles.GUARDIAN_ROLE);
+
+    bytes4[] memory governorSelectors = new bytes4[](2);
+    governorSelectors[0] = GenericRebalancer.setTokenTransferAddress.selector;
+    governorSelectors[1] = GenericRebalancer.setSwapRouter.selector;
+    accessManager.setTargetFunctionRole(genericRebalancer, governorSelectors, Roles.GOVERNOR_ROLE);
+  }
+}
diff --git a/scripts/SetupGenericHarvesterExposure.s.sol b/scripts/SetupGenericRebalancerExposure.s.sol
similarity index 61%
rename from scripts/SetupGenericHarvesterExposure.s.sol
rename to scripts/SetupGenericRebalancerExposure.s.sol
index 72c9c7a..6b3ccc4 100644
--- a/scripts/SetupGenericHarvesterExposure.s.sol
+++ b/scripts/SetupGenericRebalancerExposure.s.sol
@@ -3,15 +3,15 @@ pragma solidity 0.8.28;
 
 import "./Base.s.sol";
 
-import { GenericHarvester } from "contracts/helpers/GenericHarvester.sol";
-import { BaseHarvester } from "contracts/helpers/BaseHarvester.sol";
+import { GenericRebalancer } from "contracts/helpers/GenericRebalancer.sol";
+import { BaseRebalancer } from "contracts/helpers/BaseRebalancer.sol";
 
-contract SetupGenericHarvesterExposure is BaseScript {
-  BaseHarvester genericHarvester = BaseHarvester(0x57770C1721Eb35509f38210A935c8b1911db7E0e);
+contract SetupGenericRebalancerExposure is BaseScript {
+  BaseRebalancer genericRebalancer = BaseRebalancer(0x57770C1721Eb35509f38210A935c8b1911db7E0e);
 
   function run() public broadcast {
     accessManager.grantRole(Roles.GUARDIAN_ROLE, broadcaster, 0);
-    genericHarvester.setYieldBearingAssetData(
+    genericRebalancer.setYieldBearingAssetData(
       // yieldBearingAsset
       address(0x211Cc4DD073734dA055fbF44a2b4667d5E5fE5d2),
       // asset
diff --git a/tests/units/Harvester.t.sol b/tests/units/Rebalancer.t.sol
similarity index 59%
rename from tests/units/Harvester.t.sol
rename to tests/units/Rebalancer.t.sol
index 5c3aa6d..7312797 100644
--- a/tests/units/Harvester.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -2,15 +2,15 @@
 
 pragma solidity 0.8.28;
 
-import { MultiBlockHarvester } from "contracts/helpers/MultiBlockHarvester.sol";
+import { MultiBlockRebalancer } from "contracts/helpers/MultiBlockRebalancer.sol";
 import { IParallelizer } from "contracts/interfaces/IParallelizer.sol";
 import "contracts/utils/Constants.sol";
 import "contracts/utils/Errors.sol" as Errors;
 
 import { Fixture } from "../Fixture.sol";
 
-contract Test_Harvester_MaxSlippage is Fixture {
-  MultiBlockHarvester internal harvester;
+contract Test_Rebalancer_MaxSlippage is Fixture {
+  MultiBlockRebalancer internal rebalancer;
 
   address internal yieldBearingAsset;
 
@@ -18,36 +18,36 @@ contract Test_Harvester_MaxSlippage is Fixture {
     super.setUp();
 
     yieldBearingAsset = address(eurY);
-    harvester = new MultiBlockHarvester(address(accessManager), tokenP, IParallelizer(address(parallelizer)));
+    rebalancer = new MultiBlockRebalancer(address(accessManager), tokenP, IParallelizer(address(parallelizer)));
 
     vm.startPrank(governor);
     accessManager.setTargetFunctionRole(
-      address(harvester), getGuardianBaseHarvesterSelectorAccess(), GUARDIAN_ROLE
+      address(rebalancer), getGuardianBaseRebalancerSelectorAccess(), GUARDIAN_ROLE
     );
     accessManager.grantRole(GUARDIAN_ROLE, guardian, 0);
     vm.stopPrank();
 
     vm.prank(guardian);
-    harvester.setYieldBearingAssetData(yieldBearingAsset, address(eurA), 5e8, 1e8, 9e8, 1, 5e7);
+    rebalancer.setYieldBearingAssetData(yieldBearingAsset, address(eurA), 5e8, 1e8, 9e8, 1, 5e7);
   }
 
   function test_SetMaxSlippage_UpdatesTheLiveLimit() public {
     vm.prank(guardian);
-    harvester.setMaxSlippage(yieldBearingAsset, 1e7);
+    rebalancer.setMaxSlippage(yieldBearingAsset, 1e7);
 
-    (,,,,, uint96 maxSlippage) = harvester.yieldBearingData(yieldBearingAsset);
+    (,,,,, uint96 maxSlippage) = rebalancer.yieldBearingData(yieldBearingAsset);
     assertEq(maxSlippage, 1e7);
   }
 
   function test_RevertWhen_SetMaxSlippageIsFullSlippage() public {
     vm.prank(guardian);
     vm.expectRevert(Errors.InvalidParam.selector);
-    harvester.setMaxSlippage(yieldBearingAsset, 1e9);
+    rebalancer.setMaxSlippage(yieldBearingAsset, 1e9);
   }
 
   function test_RevertWhen_SetMaxSlippageNotGuardian() public {
     vm.prank(alice);
     vm.expectRevert(abi.encodeWithSelector(Errors.AccessManagedUnauthorized.selector, alice));
-    harvester.setMaxSlippage(yieldBearingAsset, 1e7);
+    rebalancer.setMaxSlippage(yieldBearingAsset, 1e7);
   }
 }
diff --git a/tests/utils/ConfigAccessManager.sol b/tests/utils/ConfigAccessManager.sol
index 13c08ee..c603576 100644
--- a/tests/utils/ConfigAccessManager.sol
+++ b/tests/utils/ConfigAccessManager.sol
@@ -7,9 +7,9 @@ import { UUPSUpgradeable } from "@openzeppelin/contracts/proxy/utils/UUPSUpgrade
 import { Savings } from "contracts/savings/Savings.sol";
 import { SavingsNameable } from "contracts/savings/nameable/SavingsNameable.sol";
 import { BaseSavings } from "contracts/savings/BaseSavings.sol";
-import { BaseHarvester } from "contracts/helpers/BaseHarvester.sol";
-import { MultiBlockHarvester } from "contracts/helpers/MultiBlockHarvester.sol";
-import { GenericHarvester } from "contracts/helpers/GenericHarvester.sol";
+import { BaseRebalancer } from "contracts/helpers/BaseRebalancer.sol";
+import { MultiBlockRebalancer } from "contracts/helpers/MultiBlockRebalancer.sol";
+import { GenericRebalancer } from "contracts/helpers/GenericRebalancer.sol";
 import { SettersGuardian } from "contracts/parallelizer/facets/SettersGuardian.sol";
 import { SettersGovernor } from "contracts/parallelizer/facets/SettersGovernor.sol";
 import { DiamondEtherscan } from "contracts/parallelizer/facets/DiamondEtherscan.sol";
@@ -62,26 +62,26 @@ abstract contract ConfigAccessManager is Helper {
     return selectors;
   }
 
-  function getGuardianBaseHarvesterSelectorAccess() internal pure returns (bytes4[] memory) {
+  function getGuardianBaseRebalancerSelectorAccess() internal pure returns (bytes4[] memory) {
     bytes4[] memory selectors = new bytes4[](5);
-    selectors[0] = BaseHarvester.setYieldBearingAssetData.selector;
-    selectors[1] = BaseHarvester.setMaxSlippage.selector;
-    selectors[2] = BaseHarvester.toggleTrusted.selector;
-    selectors[3] = BaseHarvester.recoverERC20.selector;
-    selectors[4] = BaseHarvester.setTargetExposure.selector;
+    selectors[0] = BaseRebalancer.setYieldBearingAssetData.selector;
+    selectors[1] = BaseRebalancer.setMaxSlippage.selector;
+    selectors[2] = BaseRebalancer.toggleTrusted.selector;
+    selectors[3] = BaseRebalancer.recoverERC20.selector;
+    selectors[4] = BaseRebalancer.setTargetExposure.selector;
     return selectors;
   }
 
-  function getGovernorMultiBlockHarvesterSelectorAccess() internal pure returns (bytes4[] memory) {
+  function getGovernorMultiBlockRebalancerSelectorAccess() internal pure returns (bytes4[] memory) {
     bytes4[] memory selectors = new bytes4[](1);
-    selectors[0] = MultiBlockHarvester.setYieldBearingToDepositAddress.selector;
+    selectors[0] = MultiBlockRebalancer.setYieldBearingToDepositAddress.selector;
     return selectors;
   }
 
-  function getGovernorGenericHarvesterSelectorAccess() internal pure returns (bytes4[] memory) {
+  function getGovernorGenericRebalancerSelectorAccess() internal pure returns (bytes4[] memory) {
     bytes4[] memory selectors = new bytes4[](2);
-    selectors[0] = GenericHarvester.setTokenTransferAddress.selector;
-    selectors[1] = GenericHarvester.setSwapRouter.selector;
+    selectors[0] = GenericRebalancer.setTokenTransferAddress.selector;
+    selectors[1] = GenericRebalancer.setSwapRouter.selector;
     return selectors;
   }
 

From a4722334f5c9a0ab4b2194ddd64a90ae20620e8e Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 10:49:28 +0300
Subject: [PATCH 07/28] refactor(rebalancer): rename IHarvester and drop stale
 deployment records

Completes the rename: the interface follows the contracts that implement
it. The upstream reference to Angle's IHarvester is left as written since
it names a file in their repository.

The GenericHarvester deployment records are removed. They are internal
helper contracts, no code resolves them by name, and the entries would
otherwise point at an implementation this repository no longer builds.
---
 contracts/helpers/BaseRebalancer.sol          |    4 +-
 .../{IHarvester.sol => IRebalancer.sol}       |    4 +-
 .../avalanche/GenericHarvester_USDp.json      | 1190 -----------------
 deployments/base/GenericHarvester_USDp.json   | 1124 ----------------
 .../hyperevm/GenericHarvester_USDp.json       | 1124 ----------------
 .../mainnet/GenericHarvester_USDp.json        | 1124 ----------------
 deployments/sonic/GenericHarvester_USDp.json  | 1124 ----------------
 .../{IHarvester.d.ts => IRebalancer.d.ts}     |    4 +-
 .../abis/{IHarvester.js => IRebalancer.js}    |    2 +-
 generated/abis/index.d.ts                     |    2 +-
 generated/abis/index.js                       |    2 +-
 11 files changed, 9 insertions(+), 5695 deletions(-)
 rename contracts/interfaces/{IHarvester.sol => IRebalancer.sol} (94%)
 delete mode 100644 deployments/avalanche/GenericHarvester_USDp.json
 delete mode 100644 deployments/base/GenericHarvester_USDp.json
 delete mode 100644 deployments/hyperevm/GenericHarvester_USDp.json
 delete mode 100644 deployments/mainnet/GenericHarvester_USDp.json
 delete mode 100644 deployments/sonic/GenericHarvester_USDp.json
 rename generated/abis/{IHarvester.d.ts => IRebalancer.d.ts} (95%)
 rename generated/abis/{IHarvester.js => IRebalancer.js} (97%)

diff --git a/contracts/helpers/BaseRebalancer.sol b/contracts/helpers/BaseRebalancer.sol
index 79d21ba..ca74d53 100644
--- a/contracts/helpers/BaseRebalancer.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -6,7 +6,7 @@ import { AccessManaged } from "../utils/AccessManaged.sol";
 import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
 import { IParallelizer } from "contracts/interfaces/IParallelizer.sol";
 import { ITokenP } from "contracts/interfaces/ITokenP.sol";
-import "contracts/interfaces/IHarvester.sol";
+import "contracts/interfaces/IRebalancer.sol";
 
 import "../utils/Errors.sol";
 
@@ -32,7 +32,7 @@ struct YieldBearingParams {
 /// @dev Abstract contract for a rebalancer that aims at rebalancing a Parallelizer
 /// @dev This contract is an authorized fork of Angle's BaseRebalancer contract:
 /// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseRebalancer.sol
-abstract contract BaseRebalancer is IHarvester, AccessManaged {
+abstract contract BaseRebalancer is IRebalancer, AccessManaged {
   using SafeERC20 for IERC20;
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
diff --git a/contracts/interfaces/IHarvester.sol b/contracts/interfaces/IRebalancer.sol
similarity index 94%
rename from contracts/interfaces/IHarvester.sol
rename to contracts/interfaces/IRebalancer.sol
index 8264790..6991e60 100644
--- a/contracts/interfaces/IHarvester.sol
+++ b/contracts/interfaces/IRebalancer.sol
@@ -1,12 +1,12 @@
 // SPDX-License-Identifier: GPL-3.0
 pragma solidity 0.8.28;
 
-/// @title IHarvester
+/// @title IRebalancer
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
 /// @dev This interface is an authorized fork of Angle's `IHarvester` interface
 /// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IHarvester.sol
-interface IHarvester {
+interface IRebalancer {
   function setYieldBearingAssetData(
     address yieldBearingAsset,
     address stablecoin,
diff --git a/deployments/avalanche/GenericHarvester_USDp.json b/deployments/avalanche/GenericHarvester_USDp.json
deleted file mode 100644
index 0507bdb..0000000
--- a/deployments/avalanche/GenericHarvester_USDp.json
+++ /dev/null
@@ -1,1190 +0,0 @@
-{
-  "address": "0x0d45b129dc868963025db79a9074ea9c9e32cae4",
-  "abi": [
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initialTokenTransferAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialSwapRouter",
-          "type": "address"
-        },
-        {
-          "internalType": "contract ITokenP",
-          "name": "definitivetokenP",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IParallelizer",
-          "name": "definitiveParallelizer",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialAuthority",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "definitiveFlashloan",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "constructor"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedInvalidAuthority",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        },
-        {
-          "internalType": "uint32",
-          "name": "delay",
-          "type": "uint32"
-        }
-      ],
-      "name": "AccessManagedRequiredDelay",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedUnauthorized",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "InvalidParam",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrusted",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrustedOrGuardian",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        }
-      ],
-      "name": "SafeERC20FailedOperation",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "SwapError",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAddress",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAmount",
-      "type": "error"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AuthorityUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "Recovered",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "SwapRouterUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "TokenTransferAddressUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "bool",
-          "name": "status",
-          "type": "bool"
-        }
-      ],
-      "name": "TrustedToggled",
-      "type": "event"
-    },
-    {
-      "inputs": [],
-      "name": "CALLBACK_SUCCESS",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "addBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "authority",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "budget",
-      "outputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "computeRebalanceAmount",
-      "outputs": [
-        {
-          "internalType": "uint8",
-          "name": "increase",
-          "type": "uint8"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "flashloan",
-      "outputs": [
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "scale",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "extraData",
-          "type": "bytes"
-        }
-      ],
-      "name": "harvest",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "isConsumingScheduledOp",
-      "outputs": [
-        {
-          "internalType": "bytes4",
-          "name": "",
-          "type": "bytes4"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "isTrusted",
-      "outputs": [
-        {
-          "internalType": "bool",
-          "name": "",
-          "type": "bool"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "maxTokenSlippage",
-      "outputs": [
-        {
-          "internalType": "uint96",
-          "name": "",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initiator",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "uint256",
-          "name": "fee",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "data",
-          "type": "bytes"
-        }
-      ],
-      "name": "onFlashLoan",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "parallelizer",
-      "outputs": [
-        {
-          "internalType": "contract IParallelizer",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "tokenAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amountToRecover",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "recoverERC20",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "removeBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newAuthority",
-          "type": "address"
-        }
-      ],
-      "name": "setAuthority",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint96",
-          "name": "newMaxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setMaxSlippage",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "setSwapRouter",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        }
-      ],
-      "name": "setTargetExposure",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "setTokenTransferAddress",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setYieldBearingAssetData",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "swapRouter",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        }
-      ],
-      "name": "toggleTrusted",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenP",
-      "outputs": [
-        {
-          "internalType": "contract ITokenP",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenTransferAddress",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "updateLimitExposuresYieldAsset",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "yieldBearingData",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    }
-  ],
-  "contractName": "GenericHarvester",
-  "sourceName": "contracts/helpers/GenericHarvester.sol",
-  "bytecode": "0x60e080604052346101e95760c08161270c803803809161001f828561020f565b8339810103126101e95761003281610246565b9061003f60208201610246565b6040820151926001600160a01b038416918285036101e95760608401516001600160a01b03811681036101e95760a061007a60808701610246565b950151956001600160a01b038716958688036101e9575f80546001600160a01b0319166001600160a01b0390921691821790556040519081527f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad90602090a160a052608052600480546001600160a01b039283166001600160a01b0319918216179091556005805493909216921691909117905581156102005760446020925f9460c052604051948593849263095ea7b360e01b84526004840152811960248401525af180156101f5576101b9575b6040516124b1908161025b823960805181818161027601528181610ce601528181610e1e01528181611cd70152612069015260a0518181816103bf0152818161066c01528181610e4b015281816115790152611600015260c05181818161040701528181610d5b01526115bd0152f35b6020813d6020116101ed575b816101d26020938361020f565b810103126101e95751801515036101e9575f610149565b5f80fd5b3d91506101c5565b6040513d5f823e3d90fd5b63d92e233d60e01b5f5260045ffd5b601f909101601f19168101906001600160401b0382119082101761023257604052565b634e487b7160e01b5f52604160045260245ffd5b51906001600160a01b03821682036101e95756fe60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461166a57806313047520146116245780631978a5ed146115e15780631b89b61a1461159e578063212c8fb1146114e557806323e30c8b14610d0a57806335b37d1a14610cc75780634127365714610c455780635a7cb38f14610c1f578063641bd50314610b6d5780637a9e5e4b14610a9f5780637ee8434914610a0e5780638195001d146109ed5780638237e538146109b35780638fb360371461094057806396d64879146109035780639ae784861461082e578063b51609b4146107a7578063bf7e214f14610782578063c31c9c071461075c578063c5e6d5ea146106cb578063c9c6667414610693578063d2d0ec101461062a578063da94e205146105b1578063e234b903146105025763edf0ef0314610138575f80fd5b346104ae5760603660031901126104ae576101516118c0565b60243560443567ffffffffffffffff81116104ae576101749036906004016118ec565b9290633b9aca0083116104da578161018d600293611a33565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca84611972565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611cca565b979097611a79565b049586156104b2578301926040818503126104ae5780359360028510156104ae57602082013567ffffffffffffffff81116104ae5761026b92016119e0565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ae575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610492575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047e5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a79565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122a3565b03601f1981018452836119a2565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122a3565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047357610437575080f35b6020813d60201161046b575b81610450602093836119a2565b810103126104675751801515036104645780f35b80fd5b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049f9198505f906119a2565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ae5760203660031901126104ae576001600160a01b036105236118c0565b610536336105313633611a8c565b61191a565b168015610589576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ae5760403660031901126104ae576105ca6118c0565b602435906bffffffffffffffffffffffff82168092036104ae576105f2336105313633611a8c565b633b9aca0082116104da576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ae5760403660031901126104ae576106916004356106496118d6565b335f52600660205260405f20610660838254611a26565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661224c565b005b346104ae5760203660031901126104ae576001600160a01b036106b46118c0565b165f526006602052602060405f2054604051908152f35b346104ae5760203660031901126104ae576001600160a01b036106ec6118c0565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ae575f3660031901126104ae5760206001600160a01b0360045416604051908152f35b346104ae575f3660031901126104ae5760206001600160a01b035f5416604051908152f35b346104ae5760603660031901126104ae576107c06118c0565b6024356044356001600160a01b0381168082036104ae577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f560606106919561080c336105313633611a8c565b6001600160a01b036040519116938482528660208301526040820152a161224c565b346104ae5760403660031901126104ae576108476118c0565b60243567ffffffffffffffff811681036104ae57335f52600360205260ff60405f20541615806108f2575b6108ca576001600160a01b0361069192165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fd3633611a8c565b15610872565b346104ae5760203660031901126104ae576001600160a01b036109246118c0565b165f526003602052602060ff60405f2054166040519015158152f35b346104ae575f3660031901126104ae575f5460a01c60ff16156109ab5760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f610981565b346104ae575f3660031901126104ae5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ae5760203660031901126104ae57610691610a096118c0565b611a33565b346104ae5760203660031901126104ae576001600160a01b03610a2f6118c0565b610a3d336105313633611a8c565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ae5760203660031901126104ae57610ab86118c0565b5f54906001600160a01b0382163303610b5b57803b15610b265773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ae5760203660031901126104ae576040610c10610b8b6118c0565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bbb85611972565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611cca565b60ff8351921682526020820152f35b346104ae575f3660031901126104ae5760206001600160a01b0360055416604051908152f35b346104ae5760203660031901126104ae576001600160a01b03610c666118c0565b610c74336105313633611a8c565b168015610589576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ae575f3660031901126104ae5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ae5760a03660031901126104ae57610d236118c0565b610d2b6118d6565b5060443560843567ffffffffffffffff81116104ae57610d4f9036906004016118ec565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114d1575b5080156114c6575b61149e5782019060e0838303126104ae57610da88361195e565b92610db56040820161195e565b610dc16060830161195e565b9360a08301359060028210156104ae5760c08401359067ffffffffffffffff82116104ae57610dfc6001600160a01b039291839287016119e0565b9616921694600160208501351495865f146114985792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b038716998a60648401523060848401524260a48401525af19384156110c9575f94611464575b505f92600181036112c357505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c9575f9561128f575b50604093845192610f1686856119a2565b60018452601f1986019182366020870137610f3085612029565b52855192610f3e87856119a2565b600184525f5b83811061127e5750610f5584612029565b52610f5f83612029565b50855191610f6d87846119a2565b60018352366020840137610f8082612029565b528251925f5b84811061111c57505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111357505f916110d4575b5060809660c4936001600160a01b03610fdc60209897955f95611a26565b945b610fe9868583611c29565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c9575f92611095575b50818111611061575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b039161107391611a26565b91165f52600660205261108b60405f20918254611a26565b9055808080611037565b9091506020813d6020116110c1575b816110b1602093836119a2565b810103126104ae5751908361102e565b3d91506110a4565b6040513d5f823e3d90fd5b905060209493919294813d60201161110b575b816110f4602093836119a2565b810103126104ae5751929390929091906080610fbe565b3d91506110e7565b513d5f823e3d90fd5b6001600160a01b0361112e828461204a565b51166001600160a01b036005541690611147838661204a565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa938415611274575f94611241575b50808410611225575b505050505f8061119b838761204a565b516001600160a01b036004541682602083519301915af13d1561121d573d906111c3826119c4565b916111d08a5193846119a2565b82523d5f602084013e5b156111e85750600101610f86565b80519081611218577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b6060906111da565b6112389361123291611a26565b91612334565b8e80808061118b565b9093506020813d821161126c575b8161125c602093836119a2565b810103126104ae5751925f611182565b3d915061124f565b8b513d5f823e3d90fd5b806060602080938801015201610f44565b9094506020813d6020116112bb575b816112ab602093836119a2565b810103126104ae5751938b610f05565b3d915061129e565b9091939492989a979550156112f0575b50505050925f6080969360c4936001600160a01b03602097610fde565b9396509192869290156113ba5750611309918391611c29565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c9575f91611380575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112d3565b95929390506020863d6020116113b2575b8161139e602093836119a2565b810103126104ae579451919492915f61135c565b3d9150611391565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c9575f9161142a575b50925f6080969360c4936001600160a01b03602097611372565b95929390506020863d60201161145c575b81611448602093836119a2565b810103126104ae579451919492915f611410565b3d915061143b565b9093506020813d602011611490575b81611480602093836119a2565b810103126104ae5751928c610ec0565b3d9150611473565b91610e14565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8e565b6001600160a01b0316301415905084610d86565b346104ae5760403660031901126104ae576106916004356001600160a01b0361150c6118d6565b165f52600660205260405f2061152382825461193d565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261156f6084826119a2565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166122c7565b346104ae575f3660031901126104ae5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ae575f3660031901126104ae5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ae5760203660031901126104ae576001600160a01b036116456118c0565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ae5760e03660031901126104ae576116836118c0565b61168b6118d6565b6044359167ffffffffffffffff8316918284036104ae576064359267ffffffffffffffff8416918285036104ae576084359567ffffffffffffffff87168097036104ae5760a4359467ffffffffffffffff8616908187036104ae5760c435906bffffffffffffffffffffffff82168092036104ae576001600160a01b0390611717336105313633611a8c565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104da57633b9aca008110156104da576117a460019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461187857505083633b9aca0081109182159261186d575b50506104da576106919267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b101590508385611821565b929150925061069193507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff82541617905561205e565b600435906001600160a01b03821682036104ae57565b602435906001600160a01b03821682036104ae57565b9181601f840112156104ae5782359167ffffffffffffffff83116104ae57602083818601950101116104ae57565b156119225750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161194a57565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ae57565b60c0810190811067ffffffffffffffff82111761198e57604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761198e57604052565b67ffffffffffffffff811161198e57601f01601f191660200190565b81601f820112156104ae578035906119f7826119c4565b92611a0560405194856119a2565b828452602083830101116104ae57815f926020809301838601378301015290565b9190820391821161194a57565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a635750565b806001600160a01b03611a7792541661205e565b565b8181029291811591840414171561194a57565b905f915f54916001600160a01b03831692816004116104ae575f5f9060405f8151966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611b246084826119a2565b828052826020525190895afa611c16575b15611b46575b505050505050600190565b63ffffffff1615611c0d5760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ae576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c957611bfa575b5060ff60a01b1981541690555f8080808080611b3b565b611c0691505f906119a2565b5f5f611be3565b50505050505f90565b50505f516020518060201c150290611b35565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c9575f94611c80575b508310611c7557505050565b611a77921991612334565b9093506020813d602011611cac575b81611c9c602093836119a2565b810103126104ae5751925f611c69565b3d9150611c8f565b91908260409103126104ae576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c9575f905f92611ee6575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c9575f93611eb4575b50611d7b8267ffffffffffffffff602088015116611a79565b633b9aca008202828104633b9aca00148315171561194a57811015611e2b576040611dba611dc39493633b9aca0067ffffffffffffffff940490611a26565b96015116611a79565b633b9aca008202828104633b9aca00148315171561194a57811015611de957505f925050565b611df3848361193d565b633b9aca00810290808204633b9aca00149015171561194a578110611e16575050565b611e28929350633b9aca009004611a26565b90565b95509067ffffffffffffffff6060611dba611e4e94633b9aca0060019a04611a26565b633b9aca008202828104633b9aca00148315171561194a5781811015611e7657505f93505050565b633b9aca008502858104633b9aca00148615171561194a57611e98908361193d565b11611ea1575050565b611e28929350633b9aca00900490611a26565b611ed791935060403d604011611edf575b611ecf81836119a2565b810190611cb4565b50915f611d62565b503d611ec5565b9050611f01915060403d604011611edf57611ecf81836119a2565b905f611d2d565b67ffffffffffffffff811161198e5760051b60200190565b91906040838203126104ae57825167ffffffffffffffff81116104ae57830181601f820112156104ae578051611f5581611f08565b91611f6360405193846119a2565b81835260208084019260051b820101908482116104ae57602001915b818310612008575050509260208101519067ffffffffffffffff82116104ae57019080601f830112156104ae57815190611fb882611f08565b92611fc660405194856119a2565b82845260208085019360051b8201019182116104ae57602001915b818310611fee5750505090565b82518060070b81036104ae57815260209283019201611fe1565b825167ffffffffffffffff811681036104ae57815260209283019201611f7f565b8051156120365760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120365760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c9575f9261222f575b508151600181116121e9575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c9575f926121c4575b508151916001831161216a575060010180546fffffffffffffffff00000000000000001916905550565b600119830192831161194a5767ffffffffffffffff61218e611a779460019361204a565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6121e19192503d805f833e6121d981836119a2565b810190611f20565b50905f612140565b600119810190811161194a5761220967ffffffffffffffff915f9461204a565b511667ffffffffffffffff60018501911667ffffffffffffffff198254161790556120ff565b6122449192503d805f833e6121d981836119a2565b50905f6120d6565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a779161229e8260648101610376565b6122c7565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b905f602091828151910182855af1156110c9575f513d61232b57506001600160a01b0381163b155b6122f65750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b600114156122ef565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c9575f90612447575b61237d925061193d565b9160205f604051946123c8866123ba8582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f1981018852876119a2565b85519082865af1903d5f519083612428575b505050156123e757505050565b61229e611a77936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124226064826119a2565b826122c7565b9192509061243d57503b15155b5f80806123da565b6001915014612435565b506020823d602011612473575b81612461602093836119a2565b810103126104ae5761237d9151612373565b3d915061245456fea2646970667358221220c91ca8ea8899ca08b3839156df940b48fa1be932a747ba5243a6a03e6a682f0564736f6c634300081c0033",
-  "deployedBytecode": "0x60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461166a57806313047520146116245780631978a5ed146115e15780631b89b61a1461159e578063212c8fb1146114e557806323e30c8b14610d0a57806335b37d1a14610cc75780634127365714610c455780635a7cb38f14610c1f578063641bd50314610b6d5780637a9e5e4b14610a9f5780637ee8434914610a0e5780638195001d146109ed5780638237e538146109b35780638fb360371461094057806396d64879146109035780639ae784861461082e578063b51609b4146107a7578063bf7e214f14610782578063c31c9c071461075c578063c5e6d5ea146106cb578063c9c6667414610693578063d2d0ec101461062a578063da94e205146105b1578063e234b903146105025763edf0ef0314610138575f80fd5b346104ae5760603660031901126104ae576101516118c0565b60243560443567ffffffffffffffff81116104ae576101749036906004016118ec565b9290633b9aca0083116104da578161018d600293611a33565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca84611972565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611cca565b979097611a79565b049586156104b2578301926040818503126104ae5780359360028510156104ae57602082013567ffffffffffffffff81116104ae5761026b92016119e0565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ae575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610492575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047e5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a79565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122a3565b03601f1981018452836119a2565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122a3565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047357610437575080f35b6020813d60201161046b575b81610450602093836119a2565b810103126104675751801515036104645780f35b80fd5b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049f9198505f906119a2565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ae5760203660031901126104ae576001600160a01b036105236118c0565b610536336105313633611a8c565b61191a565b168015610589576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ae5760403660031901126104ae576105ca6118c0565b602435906bffffffffffffffffffffffff82168092036104ae576105f2336105313633611a8c565b633b9aca0082116104da576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ae5760403660031901126104ae576106916004356106496118d6565b335f52600660205260405f20610660838254611a26565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661224c565b005b346104ae5760203660031901126104ae576001600160a01b036106b46118c0565b165f526006602052602060405f2054604051908152f35b346104ae5760203660031901126104ae576001600160a01b036106ec6118c0565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ae575f3660031901126104ae5760206001600160a01b0360045416604051908152f35b346104ae575f3660031901126104ae5760206001600160a01b035f5416604051908152f35b346104ae5760603660031901126104ae576107c06118c0565b6024356044356001600160a01b0381168082036104ae577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f560606106919561080c336105313633611a8c565b6001600160a01b036040519116938482528660208301526040820152a161224c565b346104ae5760403660031901126104ae576108476118c0565b60243567ffffffffffffffff811681036104ae57335f52600360205260ff60405f20541615806108f2575b6108ca576001600160a01b0361069192165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fd3633611a8c565b15610872565b346104ae5760203660031901126104ae576001600160a01b036109246118c0565b165f526003602052602060ff60405f2054166040519015158152f35b346104ae575f3660031901126104ae575f5460a01c60ff16156109ab5760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f610981565b346104ae575f3660031901126104ae5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ae5760203660031901126104ae57610691610a096118c0565b611a33565b346104ae5760203660031901126104ae576001600160a01b03610a2f6118c0565b610a3d336105313633611a8c565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ae5760203660031901126104ae57610ab86118c0565b5f54906001600160a01b0382163303610b5b57803b15610b265773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ae5760203660031901126104ae576040610c10610b8b6118c0565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bbb85611972565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611cca565b60ff8351921682526020820152f35b346104ae575f3660031901126104ae5760206001600160a01b0360055416604051908152f35b346104ae5760203660031901126104ae576001600160a01b03610c666118c0565b610c74336105313633611a8c565b168015610589576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ae575f3660031901126104ae5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ae5760a03660031901126104ae57610d236118c0565b610d2b6118d6565b5060443560843567ffffffffffffffff81116104ae57610d4f9036906004016118ec565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114d1575b5080156114c6575b61149e5782019060e0838303126104ae57610da88361195e565b92610db56040820161195e565b610dc16060830161195e565b9360a08301359060028210156104ae5760c08401359067ffffffffffffffff82116104ae57610dfc6001600160a01b039291839287016119e0565b9616921694600160208501351495865f146114985792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687916001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b038716998a60648401523060848401524260a48401525af19384156110c9575f94611464575b505f92600181036112c357505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c9575f9561128f575b50604093845192610f1686856119a2565b60018452601f1986019182366020870137610f3085612029565b52855192610f3e87856119a2565b600184525f5b83811061127e5750610f5584612029565b52610f5f83612029565b50855191610f6d87846119a2565b60018352366020840137610f8082612029565b528251925f5b84811061111c57505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111357505f916110d4575b5060809660c4936001600160a01b03610fdc60209897955f95611a26565b945b610fe9868583611c29565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c9575f92611095575b50818111611061575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b039161107391611a26565b91165f52600660205261108b60405f20918254611a26565b9055808080611037565b9091506020813d6020116110c1575b816110b1602093836119a2565b810103126104ae5751908361102e565b3d91506110a4565b6040513d5f823e3d90fd5b905060209493919294813d60201161110b575b816110f4602093836119a2565b810103126104ae5751929390929091906080610fbe565b3d91506110e7565b513d5f823e3d90fd5b6001600160a01b0361112e828461204a565b51166001600160a01b036005541690611147838661204a565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa938415611274575f94611241575b50808410611225575b505050505f8061119b838761204a565b516001600160a01b036004541682602083519301915af13d1561121d573d906111c3826119c4565b916111d08a5193846119a2565b82523d5f602084013e5b156111e85750600101610f86565b80519081611218577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b6060906111da565b6112389361123291611a26565b91612334565b8e80808061118b565b9093506020813d821161126c575b8161125c602093836119a2565b810103126104ae5751925f611182565b3d915061124f565b8b513d5f823e3d90fd5b806060602080938801015201610f44565b9094506020813d6020116112bb575b816112ab602093836119a2565b810103126104ae5751938b610f05565b3d915061129e565b9091939492989a979550156112f0575b50505050925f6080969360c4936001600160a01b03602097610fde565b9396509192869290156113ba5750611309918391611c29565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c9575f91611380575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112d3565b95929390506020863d6020116113b2575b8161139e602093836119a2565b810103126104ae579451919492915f61135c565b3d9150611391565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c9575f9161142a575b50925f6080969360c4936001600160a01b03602097611372565b95929390506020863d60201161145c575b81611448602093836119a2565b810103126104ae579451919492915f611410565b3d915061143b565b9093506020813d602011611490575b81611480602093836119a2565b810103126104ae5751928c610ec0565b3d9150611473565b91610e14565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8e565b6001600160a01b0316301415905084610d86565b346104ae5760403660031901126104ae576106916004356001600160a01b0361150c6118d6565b165f52600660205260405f2061152382825461193d565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261156f6084826119a2565b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000166122c7565b346104ae575f3660031901126104ae5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ae575f3660031901126104ae5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ae5760203660031901126104ae576001600160a01b036116456118c0565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ae5760e03660031901126104ae576116836118c0565b61168b6118d6565b6044359167ffffffffffffffff8316918284036104ae576064359267ffffffffffffffff8416918285036104ae576084359567ffffffffffffffff87168097036104ae5760a4359467ffffffffffffffff8616908187036104ae5760c435906bffffffffffffffffffffffff82168092036104ae576001600160a01b0390611717336105313633611a8c565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104da57633b9aca008110156104da576117a460019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461187857505083633b9aca0081109182159261186d575b50506104da576106919267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b101590508385611821565b929150925061069193507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff82541617905561205e565b600435906001600160a01b03821682036104ae57565b602435906001600160a01b03821682036104ae57565b9181601f840112156104ae5782359167ffffffffffffffff83116104ae57602083818601950101116104ae57565b156119225750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161194a57565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ae57565b60c0810190811067ffffffffffffffff82111761198e57604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761198e57604052565b67ffffffffffffffff811161198e57601f01601f191660200190565b81601f820112156104ae578035906119f7826119c4565b92611a0560405194856119a2565b828452602083830101116104ae57815f926020809301838601378301015290565b9190820391821161194a57565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a635750565b806001600160a01b03611a7792541661205e565b565b8181029291811591840414171561194a57565b905f915f54916001600160a01b03831692816004116104ae575f5f9060405f8151966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611b246084826119a2565b828052826020525190895afa611c16575b15611b46575b505050505050600190565b63ffffffff1615611c0d5760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ae576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c957611bfa575b5060ff60a01b1981541690555f8080808080611b3b565b611c0691505f906119a2565b5f5f611be3565b50505050505f90565b50505f516020518060201c150290611b35565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c9575f94611c80575b508310611c7557505050565b611a77921991612334565b9093506020813d602011611cac575b81611c9c602093836119a2565b810103126104ae5751925f611c69565b3d9150611c8f565b91908260409103126104ae576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c9575f905f92611ee6575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c9575f93611eb4575b50611d7b8267ffffffffffffffff602088015116611a79565b633b9aca008202828104633b9aca00148315171561194a57811015611e2b576040611dba611dc39493633b9aca0067ffffffffffffffff940490611a26565b96015116611a79565b633b9aca008202828104633b9aca00148315171561194a57811015611de957505f925050565b611df3848361193d565b633b9aca00810290808204633b9aca00149015171561194a578110611e16575050565b611e28929350633b9aca009004611a26565b90565b95509067ffffffffffffffff6060611dba611e4e94633b9aca0060019a04611a26565b633b9aca008202828104633b9aca00148315171561194a5781811015611e7657505f93505050565b633b9aca008502858104633b9aca00148615171561194a57611e98908361193d565b11611ea1575050565b611e28929350633b9aca00900490611a26565b611ed791935060403d604011611edf575b611ecf81836119a2565b810190611cb4565b50915f611d62565b503d611ec5565b9050611f01915060403d604011611edf57611ecf81836119a2565b905f611d2d565b67ffffffffffffffff811161198e5760051b60200190565b91906040838203126104ae57825167ffffffffffffffff81116104ae57830181601f820112156104ae578051611f5581611f08565b91611f6360405193846119a2565b81835260208084019260051b820101908482116104ae57602001915b818310612008575050509260208101519067ffffffffffffffff82116104ae57019080601f830112156104ae57815190611fb882611f08565b92611fc660405194856119a2565b82845260208085019360051b8201019182116104ae57602001915b818310611fee5750505090565b82518060070b81036104ae57815260209283019201611fe1565b825167ffffffffffffffff811681036104ae57815260209283019201611f7f565b8051156120365760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120365760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c9575f9261222f575b508151600181116121e9575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c9575f926121c4575b508151916001831161216a575060010180546fffffffffffffffff00000000000000001916905550565b600119830192831161194a5767ffffffffffffffff61218e611a779460019361204a565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6121e19192503d805f833e6121d981836119a2565b810190611f20565b50905f612140565b600119810190811161194a5761220967ffffffffffffffff915f9461204a565b511667ffffffffffffffff60018501911667ffffffffffffffff198254161790556120ff565b6122449192503d805f833e6121d981836119a2565b50905f6120d6565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a779161229e8260648101610376565b6122c7565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b905f602091828151910182855af1156110c9575f513d61232b57506001600160a01b0381163b155b6122f65750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b600114156122ef565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c9575f90612447575b61237d925061193d565b9160205f604051946123c8866123ba8582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f1981018852876119a2565b85519082865af1903d5f519083612428575b505050156123e757505050565b61229e611a77936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124226064826119a2565b826122c7565b9192509061243d57503b15155b5f80806123da565b6001915014612435565b506020823d602011612473575b81612461602093836119a2565b810103126104ae5761237d9151612373565b3d915061245456fea2646970667358221220c91ca8ea8899ca08b3839156df940b48fa1be932a747ba5243a6a03e6a682f0564736f6c634300081c0033",
-  "linkReferences": {},
-  "deployedLinkReferences": {},
-  "immutableReferences": {
-    "7707": [
-      {
-        "length": 32,
-        "start": 630
-      },
-      {
-        "length": 32,
-        "start": 3302
-      },
-      {
-        "length": 32,
-        "start": 3614
-      },
-      {
-        "length": 32,
-        "start": 7383
-      },
-      {
-        "length": 32,
-        "start": 8297
-      }
-    ],
-    "7711": [
-      {
-        "length": 32,
-        "start": 959
-      },
-      {
-        "length": 32,
-        "start": 1644
-      },
-      {
-        "length": 32,
-        "start": 3659
-      },
-      {
-        "length": 32,
-        "start": 5497
-      },
-      {
-        "length": 32,
-        "start": 5632
-      }
-    ],
-    "8438": [
-      {
-        "length": 32,
-        "start": 1031
-      },
-      {
-        "length": 32,
-        "start": 3419
-      },
-      {
-        "length": 32,
-        "start": 5565
-      }
-    ]
-  },
-  "inputSourceName": "project/contracts/helpers/GenericHarvester.sol",
-  "devdoc": {
-    "author": "Cooper Labs",
-    "custom:contact": "security@cooperlabs.xyz",
-    "details": "Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol",
-    "errors": {
-      "SafeERC20FailedOperation(address)": [
-        {
-          "details": "An operation with an ERC-20 token failed."
-        }
-      ]
-    },
-    "events": {
-      "AuthorityUpdated(address)": {
-        "details": "Authority that manages this contract was updated."
-      }
-    },
-    "kind": "dev",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to add to the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "authority()": {
-        "details": "Returns the current authority."
-      },
-      "computeRebalanceAmount(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        },
-        "returns": {
-          "amount": "amount to be rebalanced",
-          "increase": "whether the exposure should be increased"
-        }
-      },
-      "harvest(address,uint256,bytes)": {
-        "details": "This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage"
-      },
-      "isConsumingScheduledOp()": {
-        "details": "Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls."
-      },
-      "onFlashLoan(address,address,uint256,uint256,bytes)": {
-        "details": "Receive a flash loan.",
-        "params": {
-          "amount": "The amount of tokens lent.",
-          "data": "Arbitrary data structure, intended to contain user-defined parameters.",
-          "fee": "The additional amount of tokens to repay.",
-          "initiator": "The initiator of the loan.",
-          "token": "The loan currency."
-        },
-        "returns": {
-          "_0": "The keccak256 hash of \"ERC3156FlashBorrower.onFlashLoan\""
-        }
-      },
-      "recoverERC20(address,uint256,address)": {
-        "params": {
-          "amountToRecover": "amount to recover",
-          "to": "address to send the recovered tokens",
-          "tokenAddress": "address of the token to recover"
-        }
-      },
-      "removeBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to remove from the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "setAuthority(address)": {
-        "details": "Transfers control to a new authority. The caller must be the current authority."
-      },
-      "setMaxSlippage(address,uint96)": {
-        "params": {
-          "newMaxSlippage": "new max allowed slippage"
-        }
-      },
-      "setSwapRouter(address)": {
-        "params": {
-          "newSwapRouter": "address of the swap router"
-        }
-      },
-      "setTargetExposure(address,uint64)": {
-        "params": {
-          "targetExposure": "target exposure to the yield bearing asset used",
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      },
-      "setTokenTransferAddress(address)": {
-        "params": {
-          "newTokenTransferAddress": "address of the token transfer contract"
-        }
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "params": {
-          "asset": "address of the asset",
-          "maxExposure": "maximum exposure within the Parallelizer to the asset",
-          "minExposure": "minimum exposure within the Parallelizer to the asset",
-          "overrideExposures": "whether limit exposures should be overriden or read onchain through the Parallelizer",
-          "targetExposure": "target exposure to the yieldBearingAsset asset used",
-          "yieldBearingAsset": "address of the yieldBearingAsset"
-        }
-      },
-      "toggleTrusted(address)": {
-        "params": {
-          "trusted": "address to toggle the trusted status"
-        }
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      }
-    },
-    "title": "GenericHarvester",
-    "version": 1
-  },
-  "evm": {
-    "gasEstimates": {
-      "creation": {
-        "codeDepositCost": "1878600",
-        "executionCost": "infinite",
-        "totalCost": "infinite"
-      },
-      "external": {
-        "CALLBACK_SUCCESS()": "433",
-        "addBudget(uint256,address)": "infinite",
-        "authority()": "2663",
-        "budget(address)": "2862",
-        "computeRebalanceAmount(address)": "infinite",
-        "flashloan()": "infinite",
-        "harvest(address,uint256,bytes)": "infinite",
-        "isConsumingScheduledOp()": "2606",
-        "isTrusted(address)": "2742",
-        "maxTokenSlippage(address)": "2428",
-        "onFlashLoan(address,address,uint256,uint256,bytes)": "infinite",
-        "parallelizer()": "infinite",
-        "recoverERC20(address,uint256,address)": "infinite",
-        "removeBudget(uint256,address)": "infinite",
-        "setAuthority(address)": "28360",
-        "setMaxSlippage(address,uint96)": "infinite",
-        "setSwapRouter(address)": "infinite",
-        "setTargetExposure(address,uint64)": "infinite",
-        "setTokenTransferAddress(address)": "infinite",
-        "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": "infinite",
-        "swapRouter()": "2686",
-        "toggleTrusted(address)": "infinite",
-        "tokenP()": "infinite",
-        "tokenTransferAddress()": "2444",
-        "updateLimitExposuresYieldAsset(address)": "infinite",
-        "yieldBearingData(address)": "7217"
-      },
-      "internal": {
-        "_adjustYieldExposure(uint256,uint8,address,address,uint256,enum SwapType,bytes memory)": "infinite",
-        "_swapToTokenOut(uint256,address,address,uint256,enum SwapType,bytes memory)": "infinite",
-        "_swapToTokenOutSwap(address,address,uint256,bytes memory)": "infinite",
-        "_swapToTokenOutVault(uint256,address,address,uint256)": "infinite"
-      }
-    }
-  },
-  "metadata": "{\"compiler\":{\"version\":\"0.8.28+commit.7893614a\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initialTokenTransferAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialSwapRouter\",\"type\":\"address\"},{\"internalType\":\"contract ITokenP\",\"name\":\"definitivetokenP\",\"type\":\"address\"},{\"internalType\":\"contract IParallelizer\",\"name\":\"definitiveParallelizer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialAuthority\",\"type\":\"address\"},{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"definitiveFlashloan\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AccessManagedInvalidAuthority\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"delay\",\"type\":\"uint32\"}],\"name\":\"AccessManagedRequiredDelay\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"AccessManagedUnauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidParam\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrusted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrustedOrGuardian\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"SafeERC20FailedOperation\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"SwapError\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAmount\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AuthorityUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"Recovered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"SwapRouterUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"TokenTransferAddressUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"status\",\"type\":\"bool\"}],\"name\":\"TrustedToggled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"CALLBACK_SUCCESS\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"addBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"budget\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"computeRebalanceAmount\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"increase\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"flashloan\",\"outputs\":[{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"scale\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"extraData\",\"type\":\"bytes\"}],\"name\":\"harvest\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isConsumingScheduledOp\",\"outputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"isTrusted\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"maxTokenSlippage\",\"outputs\":[{\"internalType\":\"uint96\",\"name\":\"\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initiator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"fee\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"onFlashLoan\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"parallelizer\",\"outputs\":[{\"internalType\":\"contract IParallelizer\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amountToRecover\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"recoverERC20\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"removeBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAuthority\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint96\",\"name\":\"newMaxSlippage\",\"type\":\"uint96\"}],\"name\":\"setMaxSlippage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"setSwapRouter\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"}],\"name\":\"setTargetExposure\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"setTokenTransferAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"name\":\"setYieldBearingAssetData\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"swapRouter\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"}],\"name\":\"toggleTrusted\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenP\",\"outputs\":[{\"internalType\":\"contract ITokenP\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenTransferAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"updateLimitExposuresYieldAsset\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"yieldBearingData\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Cooper Labs\",\"custom:contact\":\"security@cooperlabs.xyz\",\"details\":\"Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\",\"errors\":{\"SafeERC20FailedOperation(address)\":[{\"details\":\"An operation with an ERC-20 token failed.\"}]},\"events\":{\"AuthorityUpdated(address)\":{\"details\":\"Authority that manages this contract was updated.\"}},\"kind\":\"dev\",\"methods\":{\"addBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to add to the budget\",\"receiver\":\"address of the receiver\"}},\"authority()\":{\"details\":\"Returns the current authority.\"},\"computeRebalanceAmount(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"},\"returns\":{\"amount\":\"amount to be rebalanced\",\"increase\":\"whether the exposure should be increased\"}},\"harvest(address,uint256,bytes)\":{\"details\":\"This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage\"},\"isConsumingScheduledOp()\":{\"details\":\"Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls.\"},\"onFlashLoan(address,address,uint256,uint256,bytes)\":{\"details\":\"Receive a flash loan.\",\"params\":{\"amount\":\"The amount of tokens lent.\",\"data\":\"Arbitrary data structure, intended to contain user-defined parameters.\",\"fee\":\"The additional amount of tokens to repay.\",\"initiator\":\"The initiator of the loan.\",\"token\":\"The loan currency.\"},\"returns\":{\"_0\":\"The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\"}},\"recoverERC20(address,uint256,address)\":{\"params\":{\"amountToRecover\":\"amount to recover\",\"to\":\"address to send the recovered tokens\",\"tokenAddress\":\"address of the token to recover\"}},\"removeBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to remove from the budget\",\"receiver\":\"address of the receiver\"}},\"setAuthority(address)\":{\"details\":\"Transfers control to a new authority. The caller must be the current authority.\"},\"setMaxSlippage(address,uint96)\":{\"params\":{\"newMaxSlippage\":\"new max allowed slippage\"}},\"setSwapRouter(address)\":{\"params\":{\"newSwapRouter\":\"address of the swap router\"}},\"setTargetExposure(address,uint64)\":{\"params\":{\"targetExposure\":\"target exposure to the yield bearing asset used\",\"yieldBearingAsset\":\"address of the yield bearing asset\"}},\"setTokenTransferAddress(address)\":{\"params\":{\"newTokenTransferAddress\":\"address of the token transfer contract\"}},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"params\":{\"asset\":\"address of the asset\",\"maxExposure\":\"maximum exposure within the Parallelizer to the asset\",\"minExposure\":\"minimum exposure within the Parallelizer to the asset\",\"overrideExposures\":\"whether limit exposures should be overriden or read onchain through the Parallelizer\",\"targetExposure\":\"target exposure to the yieldBearingAsset asset used\",\"yieldBearingAsset\":\"address of the yieldBearingAsset\"}},\"toggleTrusted(address)\":{\"params\":{\"trusted\":\"address to toggle the trusted status\"}},\"updateLimitExposuresYieldAsset(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"}}},\"title\":\"GenericHarvester\",\"version\":1},\"userdoc\":{\"events\":{\"SwapRouterUpdated(address)\":{\"notice\":\"Event emitted when the swap router is updated\"},\"TokenTransferAddressUpdated(address)\":{\"notice\":\"Event emitted when the token proxy is updated\"}},\"kind\":\"user\",\"methods\":{\"addBudget(uint256,address)\":{\"notice\":\"Add budget to be spent by the receiver during the flashloan\"},\"budget(address)\":{\"notice\":\"Budget of tokenP available for each users\"},\"computeRebalanceAmount(address)\":{\"notice\":\"Compute the amount needed to rebalance the Parallelizer\"},\"flashloan()\":{\"notice\":\"Parallel stablecoin flashloan contract\"},\"harvest(address,uint256,bytes)\":{\"notice\":\"Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset\"},\"isTrusted(address)\":{\"notice\":\"trusted addresses that can update target exposure and do others non critical operations\"},\"maxTokenSlippage(address)\":{\"notice\":\"Max slippage when dealing with the Parallelizer\"},\"parallelizer()\":{\"notice\":\"Reference to the `parallelizer` implementation this contract aims at rebalancing\"},\"recoverERC20(address,uint256,address)\":{\"notice\":\"Recover ERC20 tokens\"},\"removeBudget(uint256,address)\":{\"notice\":\"Remove budget from the owner and send it to the receiver\"},\"setMaxSlippage(address,uint96)\":{\"notice\":\"Set the max allowed slippage\"},\"setSwapRouter(address)\":{\"notice\":\"Set the swap router\"},\"setTargetExposure(address,uint64)\":{\"notice\":\"Set the target exposure of a yield bearing asset\"},\"setTokenTransferAddress(address)\":{\"notice\":\"Set the token transfer address\"},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"notice\":\"Set the yieldBearingAsset data\"},\"swapRouter()\":{\"notice\":\"address of the router/aggregator\"},\"toggleTrusted(address)\":{\"notice\":\"Toggle the trusted status of an address\"},\"tokenP()\":{\"notice\":\"TokenP handled by the `parallelizer` of interest\"},\"tokenTransferAddress()\":{\"notice\":\"address to approve to transfer tokens to\"},\"updateLimitExposuresYieldAsset(address)\":{\"notice\":\"Set the limit exposures to the asset linked to the yield bearing asset\"},\"yieldBearingData(address)\":{\"notice\":\"Data associated to a yield bearing asset\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"project/contracts/helpers/GenericHarvester.sol\":\"GenericHarvester\"},\"evmVersion\":\"cancun\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000},\"remappings\":[\"npm/@openzeppelin/contracts-upgradeable@5.4.0/:@openzeppelin/contracts/=npm/@openzeppelin/contracts@5.4.0/\",\"project/:@helpers/=project/libs/helpers/\",\"project/:@openzeppelin/contracts-upgradeable/=npm/@openzeppelin/contracts-upgradeable@5.4.0/\",\"project/:@openzeppelin/contracts/=npm/@openzeppelin/contracts@5.4.0/\",\"project/:contracts/=project/contracts/\"],\"viaIR\":true},\"sources\":{\"npm/@openzeppelin/contracts@5.4.0/access/manager/AuthorityUtils.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.3.0) (access/manager/AuthorityUtils.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IAuthority} from \\\"./IAuthority.sol\\\";\\n\\nlibrary AuthorityUtils {\\n    /**\\n     * @dev Since `AccessManager` implements an extended IAuthority interface, invoking `canCall` with backwards compatibility\\n     * for the preexisting `IAuthority` interface requires special care to avoid reverting on insufficient return data.\\n     * This helper function takes care of invoking `canCall` in a backwards compatible way without reverting.\\n     */\\n    function canCallWithDelay(\\n        address authority,\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) internal view returns (bool immediate, uint32 delay) {\\n        bytes memory data = abi.encodeCall(IAuthority.canCall, (caller, target, selector));\\n\\n        assembly (\\\"memory-safe\\\") {\\n            mstore(0x00, 0x00)\\n            mstore(0x20, 0x00)\\n\\n            if staticcall(gas(), authority, add(data, 0x20), mload(data), 0x00, 0x40) {\\n                immediate := mload(0x00)\\n                delay := mload(0x20)\\n\\n                // If delay does not fit in a uint32, return 0 (no delay)\\n                // equivalent to: if gt(delay, 0xFFFFFFFF) { delay := 0 }\\n                delay := mul(delay, iszero(shr(32, delay)))\\n            }\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0x05fd06ae5bca9dc7470fb2dfae764315c81a84f591e86be6fec0c115474edc6c\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/access/manager/IAccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (access/manager/IAccessManaged.sol)\\n\\npragma solidity >=0.8.4;\\n\\ninterface IAccessManaged {\\n    /**\\n     * @dev Authority that manages this contract was updated.\\n     */\\n    event AuthorityUpdated(address authority);\\n\\n    error AccessManagedUnauthorized(address caller);\\n    error AccessManagedRequiredDelay(address caller, uint32 delay);\\n    error AccessManagedInvalidAuthority(address authority);\\n\\n    /**\\n     * @dev Returns the current authority.\\n     */\\n    function authority() external view returns (address);\\n\\n    /**\\n     * @dev Transfers control to a new authority. The caller must be the current authority.\\n     */\\n    function setAuthority(address) external;\\n\\n    /**\\n     * @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n     * being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n     * attacker controlled calls.\\n     */\\n    function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0x1121e070554cffc6d536f658332a1a3d65fb2ea5573cd774f4ecbd02a2fcf4b7\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/access/manager/IAccessManager.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (access/manager/IAccessManager.sol)\\n\\npragma solidity >=0.8.4;\\n\\ninterface IAccessManager {\\n    /**\\n     * @dev A delayed operation was scheduled.\\n     */\\n    event OperationScheduled(\\n        bytes32 indexed operationId,\\n        uint32 indexed nonce,\\n        uint48 schedule,\\n        address caller,\\n        address target,\\n        bytes data\\n    );\\n\\n    /**\\n     * @dev A scheduled operation was executed.\\n     */\\n    event OperationExecuted(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev A scheduled operation was canceled.\\n     */\\n    event OperationCanceled(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev Informational labelling for a roleId.\\n     */\\n    event RoleLabel(uint64 indexed roleId, string label);\\n\\n    /**\\n     * @dev Emitted when `account` is granted `roleId`.\\n     *\\n     * NOTE: The meaning of the `since` argument depends on the `newMember` argument.\\n     * If the role is granted to a new member, the `since` argument indicates when the account becomes a member of the role,\\n     * otherwise it indicates the execution delay for this account and roleId is updated.\\n     */\\n    event RoleGranted(uint64 indexed roleId, address indexed account, uint32 delay, uint48 since, bool newMember);\\n\\n    /**\\n     * @dev Emitted when `account` membership or `roleId` is revoked. Unlike granting, revoking is instantaneous.\\n     */\\n    event RoleRevoked(uint64 indexed roleId, address indexed account);\\n\\n    /**\\n     * @dev Role acting as admin over a given `roleId` is updated.\\n     */\\n    event RoleAdminChanged(uint64 indexed roleId, uint64 indexed admin);\\n\\n    /**\\n     * @dev Role acting as guardian over a given `roleId` is updated.\\n     */\\n    event RoleGuardianChanged(uint64 indexed roleId, uint64 indexed guardian);\\n\\n    /**\\n     * @dev Grant delay for a given `roleId` will be updated to `delay` when `since` is reached.\\n     */\\n    event RoleGrantDelayChanged(uint64 indexed roleId, uint32 delay, uint48 since);\\n\\n    /**\\n     * @dev Target mode is updated (true = closed, false = open).\\n     */\\n    event TargetClosed(address indexed target, bool closed);\\n\\n    /**\\n     * @dev Role required to invoke `selector` on `target` is updated to `roleId`.\\n     */\\n    event TargetFunctionRoleUpdated(address indexed target, bytes4 selector, uint64 indexed roleId);\\n\\n    /**\\n     * @dev Admin delay for a given `target` will be updated to `delay` when `since` is reached.\\n     */\\n    event TargetAdminDelayUpdated(address indexed target, uint32 delay, uint48 since);\\n\\n    error AccessManagerAlreadyScheduled(bytes32 operationId);\\n    error AccessManagerNotScheduled(bytes32 operationId);\\n    error AccessManagerNotReady(bytes32 operationId);\\n    error AccessManagerExpired(bytes32 operationId);\\n    error AccessManagerLockedRole(uint64 roleId);\\n    error AccessManagerBadConfirmation();\\n    error AccessManagerUnauthorizedAccount(address msgsender, uint64 roleId);\\n    error AccessManagerUnauthorizedCall(address caller, address target, bytes4 selector);\\n    error AccessManagerUnauthorizedConsume(address target);\\n    error AccessManagerUnauthorizedCancel(address msgsender, address caller, address target, bytes4 selector);\\n    error AccessManagerInvalidInitialAdmin(address initialAdmin);\\n\\n    /**\\n     * @dev Check if an address (`caller`) is authorised to call a given function on a given contract directly (with\\n     * no restriction). Additionally, it returns the delay needed to perform the call indirectly through the {schedule}\\n     * & {execute} workflow.\\n     *\\n     * This function is usually called by the targeted contract to control immediate execution of restricted functions.\\n     * Therefore we only return true if the call can be performed without any delay. If the call is subject to a\\n     * previously set delay (not zero), then the function should return false and the caller should schedule the operation\\n     * for future execution.\\n     *\\n     * If `allowed` is true, the delay can be disregarded and the operation can be immediately executed, otherwise\\n     * the operation can be executed if and only if delay is greater than 0.\\n     *\\n     * NOTE: The IAuthority interface does not include the `uint32` delay. This is an extension of that interface that\\n     * is backward compatible. Some contracts may thus ignore the second return argument. In that case they will fail\\n     * to identify the indirect workflow, and will consider calls that require a delay to be forbidden.\\n     *\\n     * NOTE: This function does not report the permissions of the admin functions in the manager itself. These are defined by the\\n     * {AccessManager} documentation.\\n     */\\n    function canCall(\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) external view returns (bool allowed, uint32 delay);\\n\\n    /**\\n     * @dev Expiration delay for scheduled proposals. Defaults to 1 week.\\n     *\\n     * IMPORTANT: Avoid overriding the expiration with 0. Otherwise every contract proposal will be expired immediately,\\n     * disabling any scheduling usage.\\n     */\\n    function expiration() external view returns (uint32);\\n\\n    /**\\n     * @dev Minimum setback for all delay updates, with the exception of execution delays. It\\n     * can be increased without setback (and reset via {revokeRole} in the case event of an\\n     * accidental increase). Defaults to 5 days.\\n     */\\n    function minSetback() external view returns (uint32);\\n\\n    /**\\n     * @dev Get whether the contract is closed disabling any access. Otherwise role permissions are applied.\\n     *\\n     * NOTE: When the manager itself is closed, admin functions are still accessible to avoid locking the contract.\\n     */\\n    function isTargetClosed(address target) external view returns (bool);\\n\\n    /**\\n     * @dev Get the role required to call a function.\\n     */\\n    function getTargetFunctionRole(address target, bytes4 selector) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the admin delay for a target contract. Changes to contract configuration are subject to this delay.\\n     */\\n    function getTargetAdminDelay(address target) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the id of the role that acts as an admin for the given role.\\n     *\\n     * The admin permission is required to grant the role, revoke the role and update the execution delay to execute\\n     * an operation that is restricted to this role.\\n     */\\n    function getRoleAdmin(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role that acts as a guardian for a given role.\\n     *\\n     * The guardian permission allows canceling operations that have been scheduled under the role.\\n     */\\n    function getRoleGuardian(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role current grant delay.\\n     *\\n     * Its value may change at any point without an event emitted following a call to {setGrantDelay}.\\n     * Changes to this value, including effect timepoint are notified in advance by the {RoleGrantDelayChanged} event.\\n     */\\n    function getRoleGrantDelay(uint64 roleId) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the access details for a given account for a given role. These details include the timepoint at which\\n     * membership becomes active, and the delay applied to all operation by this user that requires this permission\\n     * level.\\n     *\\n     * Returns:\\n     * [0] Timestamp at which the account membership becomes valid. 0 means role is not granted.\\n     * [1] Current execution delay for the account.\\n     * [2] Pending execution delay for the account.\\n     * [3] Timestamp at which the pending execution delay will become active. 0 means no delay update is scheduled.\\n     */\\n    function getAccess(\\n        uint64 roleId,\\n        address account\\n    ) external view returns (uint48 since, uint32 currentDelay, uint32 pendingDelay, uint48 effect);\\n\\n    /**\\n     * @dev Check if a given account currently has the permission level corresponding to a given role. Note that this\\n     * permission might be associated with an execution delay. {getAccess} can provide more details.\\n     */\\n    function hasRole(uint64 roleId, address account) external view returns (bool isMember, uint32 executionDelay);\\n\\n    /**\\n     * @dev Give a label to a role, for improved role discoverability by UIs.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleLabel} event.\\n     */\\n    function labelRole(uint64 roleId, string calldata label) external;\\n\\n    /**\\n     * @dev Add `account` to `roleId`, or change its execution delay.\\n     *\\n     * This gives the account the authorization to call any function that is restricted to this role. An optional\\n     * execution delay (in seconds) can be set. If that delay is non 0, the user is required to schedule any operation\\n     * that is restricted to members of this role. The user will only be able to execute the operation after the delay has\\n     * passed, before it has expired. During this period, admin and guardians can cancel the operation (see {cancel}).\\n     *\\n     * If the account has already been granted this role, the execution delay will be updated. This update is not\\n     * immediate and follows the delay rules. For example, if a user currently has a delay of 3 hours, and this is\\n     * called to reduce that delay to 1 hour, the new delay will take some time to take effect, enforcing that any\\n     * operation executed in the 3 hours that follows this update was indeed scheduled before this update.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - granted role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleGranted} event.\\n     */\\n    function grantRole(uint64 roleId, address account, uint32 executionDelay) external;\\n\\n    /**\\n     * @dev Remove an account from a role, with immediate effect. If the account does not have the role, this call has\\n     * no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - revoked role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function revokeRole(uint64 roleId, address account) external;\\n\\n    /**\\n     * @dev Renounce role permissions for the calling account with immediate effect. If the sender is not in\\n     * the role this call has no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be `callerConfirmation`.\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function renounceRole(uint64 roleId, address callerConfirmation) external;\\n\\n    /**\\n     * @dev Change admin role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleAdminChanged} event\\n     */\\n    function setRoleAdmin(uint64 roleId, uint64 admin) external;\\n\\n    /**\\n     * @dev Change guardian role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGuardianChanged} event\\n     */\\n    function setRoleGuardian(uint64 roleId, uint64 guardian) external;\\n\\n    /**\\n     * @dev Update the delay for granting a `roleId`.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGrantDelayChanged} event.\\n     */\\n    function setGrantDelay(uint64 roleId, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the role required to call functions identified by the `selectors` in the `target` contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetFunctionRoleUpdated} event per selector.\\n     */\\n    function setTargetFunctionRole(address target, bytes4[] calldata selectors, uint64 roleId) external;\\n\\n    /**\\n     * @dev Set the delay for changing the configuration of a given target contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetAdminDelayUpdated} event.\\n     */\\n    function setTargetAdminDelay(address target, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the closed flag for a contract.\\n     *\\n     * Closing the manager itself won't disable access to admin methods to avoid locking the contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetClosed} event.\\n     */\\n    function setTargetClosed(address target, bool closed) external;\\n\\n    /**\\n     * @dev Return the timepoint at which a scheduled operation will be ready for execution. This returns 0 if the\\n     * operation is not yet scheduled, has expired, was executed, or was canceled.\\n     */\\n    function getSchedule(bytes32 id) external view returns (uint48);\\n\\n    /**\\n     * @dev Return the nonce for the latest scheduled operation with a given id. Returns 0 if the operation has never\\n     * been scheduled.\\n     */\\n    function getNonce(bytes32 id) external view returns (uint32);\\n\\n    /**\\n     * @dev Schedule a delayed operation for future execution, and return the operation identifier. It is possible to\\n     * choose the timestamp at which the operation becomes executable as long as it satisfies the execution delays\\n     * required for the caller. The special value zero will automatically set the earliest possible time.\\n     *\\n     * Returns the `operationId` that was scheduled. Since this value is a hash of the parameters, it can reoccur when\\n     * the same parameters are used; if this is relevant, the returned `nonce` can be used to uniquely identify this\\n     * scheduled operation from other occurrences of the same `operationId` in invocations of {execute} and {cancel}.\\n     *\\n     * Emits a {OperationScheduled} event.\\n     *\\n     * NOTE: It is not possible to concurrently schedule more than one operation with the same `target` and `data`. If\\n     * this is necessary, a random byte can be appended to `data` to act as a salt that will be ignored by the target\\n     * contract if it is using standard Solidity ABI encoding.\\n     */\\n    function schedule(\\n        address target,\\n        bytes calldata data,\\n        uint48 when\\n    ) external returns (bytes32 operationId, uint32 nonce);\\n\\n    /**\\n     * @dev Execute a function that is delay restricted, provided it was properly scheduled beforehand, or the\\n     * execution delay is 0.\\n     *\\n     * Returns the nonce that identifies the previously scheduled operation that is executed, or 0 if the\\n     * operation wasn't previously scheduled (if the caller doesn't have an execution delay).\\n     *\\n     * Emits an {OperationExecuted} event only if the call was scheduled and delayed.\\n     */\\n    function execute(address target, bytes calldata data) external payable returns (uint32);\\n\\n    /**\\n     * @dev Cancel a scheduled (delayed) operation. Returns the nonce that identifies the previously scheduled\\n     * operation that is cancelled.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be the proposer, a guardian of the targeted function, or a global admin\\n     *\\n     * Emits a {OperationCanceled} event.\\n     */\\n    function cancel(address caller, address target, bytes calldata data) external returns (uint32);\\n\\n    /**\\n     * @dev Consume a scheduled operation targeting the caller. If such an operation exists, mark it as consumed\\n     * (emit an {OperationExecuted} event and clean the state). Otherwise, throw an error.\\n     *\\n     * This is useful for contract that want to enforce that calls targeting them were scheduled on the manager,\\n     * with all the verifications that it implies.\\n     *\\n     * Emit a {OperationExecuted} event.\\n     */\\n    function consumeScheduledOp(address caller, bytes calldata data) external;\\n\\n    /**\\n     * @dev Hashing function for delayed operations.\\n     */\\n    function hashOperation(address caller, address target, bytes calldata data) external view returns (bytes32);\\n\\n    /**\\n     * @dev Changes the authority of a target managed by this manager instance.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     */\\n    function updateAuthority(address target, address newAuthority) external;\\n}\\n\",\"keccak256\":\"0x640fe2b6e5201c47322d458f81078d6dcf23ccf9954f8995b1b7bfbec0eb1421\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/access/manager/IAuthority.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (access/manager/IAuthority.sol)\\n\\npragma solidity >=0.4.16;\\n\\n/**\\n * @dev Standard interface for permissioning originally defined in Dappsys.\\n */\\ninterface IAuthority {\\n    /**\\n     * @dev Returns true if the caller can invoke on a target the function identified by a function selector.\\n     */\\n    function canCall(address caller, address target, bytes4 selector) external view returns (bool allowed);\\n}\\n\",\"keccak256\":\"0x9c9a58dd831b9bb4a0ea47d96b53c13ab9a6e4270a518ea395b1424092fd74dc\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/interfaces/IERC1363.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC1363.sol)\\n\\npragma solidity >=0.6.2;\\n\\nimport {IERC20} from \\\"./IERC20.sol\\\";\\nimport {IERC165} from \\\"./IERC165.sol\\\";\\n\\n/**\\n * @title IERC1363\\n * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].\\n *\\n * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract\\n * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.\\n */\\ninterface IERC1363 is IERC20, IERC165 {\\n    /*\\n     * Note: the ERC-165 identifier for this interface is 0xb0202a11.\\n     * 0xb0202a11 ===\\n     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))\\n     */\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @param data Additional data with no specified format, sent in call to `spender`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);\\n}\\n\",\"keccak256\":\"0xd5ea07362ab630a6a3dee4285a74cf2377044ca2e4be472755ad64d7c5d4b69d\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/interfaces/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC165.sol)\\n\\npragma solidity >=0.4.16;\\n\\nimport {IERC165} from \\\"../utils/introspection/IERC165.sol\\\";\\n\",\"keccak256\":\"0x0afcb7e740d1537b252cb2676f600465ce6938398569f09ba1b9ca240dde2dfc\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/interfaces/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC20.sol)\\n\\npragma solidity >=0.4.16;\\n\\nimport {IERC20} from \\\"../token/ERC20/IERC20.sol\\\";\\n\",\"keccak256\":\"0x1a6221315ce0307746c2c4827c125d821ee796c74a676787762f4778671d4f44\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/interfaces/IERC3156FlashBorrower.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC3156FlashBorrower.sol)\\n\\npragma solidity >=0.5.0;\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashBorrower, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashBorrower {\\n    /**\\n     * @dev Receive a flash loan.\\n     * @param initiator The initiator of the loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param fee The additional amount of tokens to repay.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     * @return The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\\n     */\\n    function onFlashLoan(\\n        address initiator,\\n        address token,\\n        uint256 amount,\\n        uint256 fee,\\n        bytes calldata data\\n    ) external returns (bytes32);\\n}\\n\",\"keccak256\":\"0x4e4b982b56b50290dd1dcaa2fef1178b1574dfc7c0f0a8ef9cb68a207d72582e\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/interfaces/IERC3156FlashLender.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC3156FlashLender.sol)\\n\\npragma solidity >=0.5.0;\\n\\nimport {IERC3156FlashBorrower} from \\\"./IERC3156FlashBorrower.sol\\\";\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashLender, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashLender {\\n    /**\\n     * @dev The amount of currency available to be lended.\\n     * @param token The loan currency.\\n     * @return The amount of `token` that can be borrowed.\\n     */\\n    function maxFlashLoan(address token) external view returns (uint256);\\n\\n    /**\\n     * @dev The fee to be charged for a given loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @return The amount of `token` to be charged for the loan, on top of the returned principal.\\n     */\\n    function flashFee(address token, uint256 amount) external view returns (uint256);\\n\\n    /**\\n     * @dev Initiate a flash loan.\\n     * @param receiver The receiver of the tokens in the loan, and the receiver of the callback.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     */\\n    function flashLoan(\\n        IERC3156FlashBorrower receiver,\\n        address token,\\n        uint256 amount,\\n        bytes calldata data\\n    ) external returns (bool);\\n}\\n\",\"keccak256\":\"0x218d708e7d8df417db24a497727eefb7772e61c7cde3886fc42bbcb6aafa6947\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity >=0.4.16;\\n\\n/**\\n * @dev Interface of the ERC-20 standard as defined in the ERC.\\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 value of tokens in existence.\\n     */\\n    function totalSupply() external view returns (uint256);\\n\\n    /**\\n     * @dev Returns the value of tokens owned by `account`.\\n     */\\n    function balanceOf(address account) external view returns (uint256);\\n\\n    /**\\n     * @dev Moves a `value` amount of 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 value) 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 a `value` amount of tokens as the allowance of `spender` over the\\n     * 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 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the\\n     * allowance mechanism. `value` 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 value) external returns (bool);\\n}\\n\",\"keccak256\":\"0x74ed01eb66b923d0d0cfe3be84604ac04b76482a55f9dd655e1ef4d367f95bc2\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity >=0.6.2;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC-20 standard.\\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\",\"keccak256\":\"0xd6fa4088198f04eef10c5bce8a2f4d60554b7ec4b987f684393c01bf79b94d9f\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.3.0) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\nimport {IERC1363} from \\\"../../../interfaces/IERC1363.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC-20 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    /**\\n     * @dev An operation with an ERC-20 token failed.\\n     */\\n    error SafeERC20FailedOperation(address token);\\n\\n    /**\\n     * @dev Indicates a failed `decreaseAllowance` request.\\n     */\\n    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);\\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.encodeCall(token.transfer, (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.encodeCall(token.transferFrom, (from, to, value)));\\n    }\\n\\n    /**\\n     * @dev Variant of {safeTransfer} that returns a bool instead of reverting if the operation is not successful.\\n     */\\n    function trySafeTransfer(IERC20 token, address to, uint256 value) internal returns (bool) {\\n        return _callOptionalReturnBool(token, abi.encodeCall(token.transfer, (to, value)));\\n    }\\n\\n    /**\\n     * @dev Variant of {safeTransferFrom} that returns a bool instead of reverting if the operation is not successful.\\n     */\\n    function trySafeTransferFrom(IERC20 token, address from, address to, uint256 value) internal returns (bool) {\\n        return _callOptionalReturnBool(token, abi.encodeCall(token.transferFrom, (from, to, 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     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n        uint256 oldAllowance = token.allowance(address(this), spender);\\n        forceApprove(token, spender, oldAllowance + value);\\n    }\\n\\n    /**\\n     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no\\n     * value, non-reverting calls are assumed to be successful.\\n     *\\n     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {\\n        unchecked {\\n            uint256 currentAllowance = token.allowance(address(this), spender);\\n            if (currentAllowance < requestedDecrease) {\\n                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);\\n            }\\n            forceApprove(token, spender, currentAllowance - requestedDecrease);\\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     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function\\n     * only sets the \\\"standard\\\" allowance. Any temporary allowance will remain active, in addition to the value being\\n     * set here.\\n     */\\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));\\n\\n        if (!_callOptionalReturnBool(token, approvalCall)) {\\n            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));\\n            _callOptionalReturn(token, approvalCall);\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            safeTransfer(token, to, value);\\n        } else if (!token.transferAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target\\n     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferFromAndCallRelaxed(\\n        IERC1363 token,\\n        address from,\\n        address to,\\n        uint256 value,\\n        bytes memory data\\n    ) internal {\\n        if (to.code.length == 0) {\\n            safeTransferFrom(token, from, to, value);\\n        } else if (!token.transferFromAndCall(from, to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.\\n     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}\\n     * once without retrying, and relies on the returned value to be true.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            forceApprove(token, to, value);\\n        } else if (!token.approveAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.\\n     */\\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            // bubble errors\\n            if iszero(success) {\\n                let ptr := mload(0x40)\\n                returndatacopy(ptr, 0, returndatasize())\\n                revert(ptr, returndatasize())\\n            }\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n\\n        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.\\n     */\\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n        bool success;\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\\n    }\\n}\\n\",\"keccak256\":\"0x982c5cb790ab941d1e04f807120a71709d4c313ba0bfc16006447ffbd27fbbd5\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)\\n\\npragma solidity ^0.8.20;\\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\",\"keccak256\":\"0x493033a8d1b176a037b2cc6a04dad01a5c157722049bbecf632ca876224dd4b2\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.4.0) (utils/introspection/IERC165.sol)\\n\\npragma solidity >=0.4.16;\\n\\n/**\\n * @dev Interface of the ERC-165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[ERC].\\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[ERC 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\",\"keccak256\":\"0x8891738ffe910f0cf2da09566928589bf5d63f4524dd734fd9cedbac3274dd5c\",\"license\":\"MIT\"},\"npm/@openzeppelin/contracts@5.4.0/utils/math/SafeCast.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)\\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow\\n * checks.\\n *\\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\\n * easily result in undesired exploitation or bugs, since developers usually\\n * assume that overflows raise errors. `SafeCast` restores this intuition by\\n * reverting the transaction when such an operation overflows.\\n *\\n * Using this library instead of the unchecked operations eliminates an entire\\n * class of bugs, so it's recommended to use it always.\\n */\\nlibrary SafeCast {\\n    /**\\n     * @dev Value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);\\n\\n    /**\\n     * @dev An int value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedIntToUint(int256 value);\\n\\n    /**\\n     * @dev Value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);\\n\\n    /**\\n     * @dev An uint value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedUintToInt(uint256 value);\\n\\n    /**\\n     * @dev Returns the downcasted uint248 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint248).\\n     *\\n     * Counterpart to Solidity's `uint248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toUint248(uint256 value) internal pure returns (uint248) {\\n        if (value > type(uint248).max) {\\n            revert SafeCastOverflowedUintDowncast(248, value);\\n        }\\n        return uint248(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint240 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint240).\\n     *\\n     * Counterpart to Solidity's `uint240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toUint240(uint256 value) internal pure returns (uint240) {\\n        if (value > type(uint240).max) {\\n            revert SafeCastOverflowedUintDowncast(240, value);\\n        }\\n        return uint240(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint232 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint232).\\n     *\\n     * Counterpart to Solidity's `uint232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toUint232(uint256 value) internal pure returns (uint232) {\\n        if (value > type(uint232).max) {\\n            revert SafeCastOverflowedUintDowncast(232, value);\\n        }\\n        return uint232(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint224 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint224).\\n     *\\n     * Counterpart to Solidity's `uint224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toUint224(uint256 value) internal pure returns (uint224) {\\n        if (value > type(uint224).max) {\\n            revert SafeCastOverflowedUintDowncast(224, value);\\n        }\\n        return uint224(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint216 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint216).\\n     *\\n     * Counterpart to Solidity's `uint216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toUint216(uint256 value) internal pure returns (uint216) {\\n        if (value > type(uint216).max) {\\n            revert SafeCastOverflowedUintDowncast(216, value);\\n        }\\n        return uint216(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint208 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint208).\\n     *\\n     * Counterpart to Solidity's `uint208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toUint208(uint256 value) internal pure returns (uint208) {\\n        if (value > type(uint208).max) {\\n            revert SafeCastOverflowedUintDowncast(208, value);\\n        }\\n        return uint208(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint200 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint200).\\n     *\\n     * Counterpart to Solidity's `uint200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toUint200(uint256 value) internal pure returns (uint200) {\\n        if (value > type(uint200).max) {\\n            revert SafeCastOverflowedUintDowncast(200, value);\\n        }\\n        return uint200(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint192 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint192).\\n     *\\n     * Counterpart to Solidity's `uint192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toUint192(uint256 value) internal pure returns (uint192) {\\n        if (value > type(uint192).max) {\\n            revert SafeCastOverflowedUintDowncast(192, value);\\n        }\\n        return uint192(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint184 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint184).\\n     *\\n     * Counterpart to Solidity's `uint184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toUint184(uint256 value) internal pure returns (uint184) {\\n        if (value > type(uint184).max) {\\n            revert SafeCastOverflowedUintDowncast(184, value);\\n        }\\n        return uint184(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint176 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint176).\\n     *\\n     * Counterpart to Solidity's `uint176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toUint176(uint256 value) internal pure returns (uint176) {\\n        if (value > type(uint176).max) {\\n            revert SafeCastOverflowedUintDowncast(176, value);\\n        }\\n        return uint176(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint168 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint168).\\n     *\\n     * Counterpart to Solidity's `uint168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toUint168(uint256 value) internal pure returns (uint168) {\\n        if (value > type(uint168).max) {\\n            revert SafeCastOverflowedUintDowncast(168, value);\\n        }\\n        return uint168(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint160 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint160).\\n     *\\n     * Counterpart to Solidity's `uint160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toUint160(uint256 value) internal pure returns (uint160) {\\n        if (value > type(uint160).max) {\\n            revert SafeCastOverflowedUintDowncast(160, value);\\n        }\\n        return uint160(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint152 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint152).\\n     *\\n     * Counterpart to Solidity's `uint152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toUint152(uint256 value) internal pure returns (uint152) {\\n        if (value > type(uint152).max) {\\n            revert SafeCastOverflowedUintDowncast(152, value);\\n        }\\n        return uint152(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint144 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint144).\\n     *\\n     * Counterpart to Solidity's `uint144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toUint144(uint256 value) internal pure returns (uint144) {\\n        if (value > type(uint144).max) {\\n            revert SafeCastOverflowedUintDowncast(144, value);\\n        }\\n        return uint144(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint136 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint136).\\n     *\\n     * Counterpart to Solidity's `uint136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toUint136(uint256 value) internal pure returns (uint136) {\\n        if (value > type(uint136).max) {\\n            revert SafeCastOverflowedUintDowncast(136, value);\\n        }\\n        return uint136(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint128 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint128).\\n     *\\n     * Counterpart to Solidity's `uint128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toUint128(uint256 value) internal pure returns (uint128) {\\n        if (value > type(uint128).max) {\\n            revert SafeCastOverflowedUintDowncast(128, value);\\n        }\\n        return uint128(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint120 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint120).\\n     *\\n     * Counterpart to Solidity's `uint120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toUint120(uint256 value) internal pure returns (uint120) {\\n        if (value > type(uint120).max) {\\n            revert SafeCastOverflowedUintDowncast(120, value);\\n        }\\n        return uint120(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint112 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint112).\\n     *\\n     * Counterpart to Solidity's `uint112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toUint112(uint256 value) internal pure returns (uint112) {\\n        if (value > type(uint112).max) {\\n            revert SafeCastOverflowedUintDowncast(112, value);\\n        }\\n        return uint112(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint104 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint104).\\n     *\\n     * Counterpart to Solidity's `uint104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toUint104(uint256 value) internal pure returns (uint104) {\\n        if (value > type(uint104).max) {\\n            revert SafeCastOverflowedUintDowncast(104, value);\\n        }\\n        return uint104(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint96 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint96).\\n     *\\n     * Counterpart to Solidity's `uint96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toUint96(uint256 value) internal pure returns (uint96) {\\n        if (value > type(uint96).max) {\\n            revert SafeCastOverflowedUintDowncast(96, value);\\n        }\\n        return uint96(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint88 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint88).\\n     *\\n     * Counterpart to Solidity's `uint88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toUint88(uint256 value) internal pure returns (uint88) {\\n        if (value > type(uint88).max) {\\n            revert SafeCastOverflowedUintDowncast(88, value);\\n        }\\n        return uint88(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint80 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint80).\\n     *\\n     * Counterpart to Solidity's `uint80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toUint80(uint256 value) internal pure returns (uint80) {\\n        if (value > type(uint80).max) {\\n            revert SafeCastOverflowedUintDowncast(80, value);\\n        }\\n        return uint80(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint72 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint72).\\n     *\\n     * Counterpart to Solidity's `uint72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toUint72(uint256 value) internal pure returns (uint72) {\\n        if (value > type(uint72).max) {\\n            revert SafeCastOverflowedUintDowncast(72, value);\\n        }\\n        return uint72(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint64 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint64).\\n     *\\n     * Counterpart to Solidity's `uint64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toUint64(uint256 value) internal pure returns (uint64) {\\n        if (value > type(uint64).max) {\\n            revert SafeCastOverflowedUintDowncast(64, value);\\n        }\\n        return uint64(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint56 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint56).\\n     *\\n     * Counterpart to Solidity's `uint56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toUint56(uint256 value) internal pure returns (uint56) {\\n        if (value > type(uint56).max) {\\n            revert SafeCastOverflowedUintDowncast(56, value);\\n        }\\n        return uint56(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint48 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint48).\\n     *\\n     * Counterpart to Solidity's `uint48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toUint48(uint256 value) internal pure returns (uint48) {\\n        if (value > type(uint48).max) {\\n            revert SafeCastOverflowedUintDowncast(48, value);\\n        }\\n        return uint48(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint40 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint40).\\n     *\\n     * Counterpart to Solidity's `uint40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toUint40(uint256 value) internal pure returns (uint40) {\\n        if (value > type(uint40).max) {\\n            revert SafeCastOverflowedUintDowncast(40, value);\\n        }\\n        return uint40(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint32 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint32).\\n     *\\n     * Counterpart to Solidity's `uint32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toUint32(uint256 value) internal pure returns (uint32) {\\n        if (value > type(uint32).max) {\\n            revert SafeCastOverflowedUintDowncast(32, value);\\n        }\\n        return uint32(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint24 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint24).\\n     *\\n     * Counterpart to Solidity's `uint24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toUint24(uint256 value) internal pure returns (uint24) {\\n        if (value > type(uint24).max) {\\n            revert SafeCastOverflowedUintDowncast(24, value);\\n        }\\n        return uint24(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint16 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint16).\\n     *\\n     * Counterpart to Solidity's `uint16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toUint16(uint256 value) internal pure returns (uint16) {\\n        if (value > type(uint16).max) {\\n            revert SafeCastOverflowedUintDowncast(16, value);\\n        }\\n        return uint16(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint8 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint8).\\n     *\\n     * Counterpart to Solidity's `uint8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toUint8(uint256 value) internal pure returns (uint8) {\\n        if (value > type(uint8).max) {\\n            revert SafeCastOverflowedUintDowncast(8, value);\\n        }\\n        return uint8(value);\\n    }\\n\\n    /**\\n     * @dev Converts a signed int256 into an unsigned uint256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be greater than or equal to 0.\\n     */\\n    function toUint256(int256 value) internal pure returns (uint256) {\\n        if (value < 0) {\\n            revert SafeCastOverflowedIntToUint(value);\\n        }\\n        return uint256(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int248 from int256, reverting on\\n     * overflow (when the input is less than smallest int248 or\\n     * greater than largest int248).\\n     *\\n     * Counterpart to Solidity's `int248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toInt248(int256 value) internal pure returns (int248 downcasted) {\\n        downcasted = int248(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(248, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int240 from int256, reverting on\\n     * overflow (when the input is less than smallest int240 or\\n     * greater than largest int240).\\n     *\\n     * Counterpart to Solidity's `int240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toInt240(int256 value) internal pure returns (int240 downcasted) {\\n        downcasted = int240(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(240, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int232 from int256, reverting on\\n     * overflow (when the input is less than smallest int232 or\\n     * greater than largest int232).\\n     *\\n     * Counterpart to Solidity's `int232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toInt232(int256 value) internal pure returns (int232 downcasted) {\\n        downcasted = int232(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(232, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int224 from int256, reverting on\\n     * overflow (when the input is less than smallest int224 or\\n     * greater than largest int224).\\n     *\\n     * Counterpart to Solidity's `int224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toInt224(int256 value) internal pure returns (int224 downcasted) {\\n        downcasted = int224(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(224, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int216 from int256, reverting on\\n     * overflow (when the input is less than smallest int216 or\\n     * greater than largest int216).\\n     *\\n     * Counterpart to Solidity's `int216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toInt216(int256 value) internal pure returns (int216 downcasted) {\\n        downcasted = int216(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(216, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int208 from int256, reverting on\\n     * overflow (when the input is less than smallest int208 or\\n     * greater than largest int208).\\n     *\\n     * Counterpart to Solidity's `int208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toInt208(int256 value) internal pure returns (int208 downcasted) {\\n        downcasted = int208(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(208, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int200 from int256, reverting on\\n     * overflow (when the input is less than smallest int200 or\\n     * greater than largest int200).\\n     *\\n     * Counterpart to Solidity's `int200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toInt200(int256 value) internal pure returns (int200 downcasted) {\\n        downcasted = int200(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(200, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int192 from int256, reverting on\\n     * overflow (when the input is less than smallest int192 or\\n     * greater than largest int192).\\n     *\\n     * Counterpart to Solidity's `int192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toInt192(int256 value) internal pure returns (int192 downcasted) {\\n        downcasted = int192(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(192, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int184 from int256, reverting on\\n     * overflow (when the input is less than smallest int184 or\\n     * greater than largest int184).\\n     *\\n     * Counterpart to Solidity's `int184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toInt184(int256 value) internal pure returns (int184 downcasted) {\\n        downcasted = int184(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(184, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int176 from int256, reverting on\\n     * overflow (when the input is less than smallest int176 or\\n     * greater than largest int176).\\n     *\\n     * Counterpart to Solidity's `int176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toInt176(int256 value) internal pure returns (int176 downcasted) {\\n        downcasted = int176(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(176, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int168 from int256, reverting on\\n     * overflow (when the input is less than smallest int168 or\\n     * greater than largest int168).\\n     *\\n     * Counterpart to Solidity's `int168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toInt168(int256 value) internal pure returns (int168 downcasted) {\\n        downcasted = int168(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(168, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int160 from int256, reverting on\\n     * overflow (when the input is less than smallest int160 or\\n     * greater than largest int160).\\n     *\\n     * Counterpart to Solidity's `int160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toInt160(int256 value) internal pure returns (int160 downcasted) {\\n        downcasted = int160(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(160, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int152 from int256, reverting on\\n     * overflow (when the input is less than smallest int152 or\\n     * greater than largest int152).\\n     *\\n     * Counterpart to Solidity's `int152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toInt152(int256 value) internal pure returns (int152 downcasted) {\\n        downcasted = int152(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(152, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int144 from int256, reverting on\\n     * overflow (when the input is less than smallest int144 or\\n     * greater than largest int144).\\n     *\\n     * Counterpart to Solidity's `int144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toInt144(int256 value) internal pure returns (int144 downcasted) {\\n        downcasted = int144(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(144, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int136 from int256, reverting on\\n     * overflow (when the input is less than smallest int136 or\\n     * greater than largest int136).\\n     *\\n     * Counterpart to Solidity's `int136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toInt136(int256 value) internal pure returns (int136 downcasted) {\\n        downcasted = int136(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(136, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int128 from int256, reverting on\\n     * overflow (when the input is less than smallest int128 or\\n     * greater than largest int128).\\n     *\\n     * Counterpart to Solidity's `int128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toInt128(int256 value) internal pure returns (int128 downcasted) {\\n        downcasted = int128(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(128, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int120 from int256, reverting on\\n     * overflow (when the input is less than smallest int120 or\\n     * greater than largest int120).\\n     *\\n     * Counterpart to Solidity's `int120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toInt120(int256 value) internal pure returns (int120 downcasted) {\\n        downcasted = int120(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(120, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int112 from int256, reverting on\\n     * overflow (when the input is less than smallest int112 or\\n     * greater than largest int112).\\n     *\\n     * Counterpart to Solidity's `int112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toInt112(int256 value) internal pure returns (int112 downcasted) {\\n        downcasted = int112(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(112, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int104 from int256, reverting on\\n     * overflow (when the input is less than smallest int104 or\\n     * greater than largest int104).\\n     *\\n     * Counterpart to Solidity's `int104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toInt104(int256 value) internal pure returns (int104 downcasted) {\\n        downcasted = int104(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(104, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int96 from int256, reverting on\\n     * overflow (when the input is less than smallest int96 or\\n     * greater than largest int96).\\n     *\\n     * Counterpart to Solidity's `int96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toInt96(int256 value) internal pure returns (int96 downcasted) {\\n        downcasted = int96(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(96, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int88 from int256, reverting on\\n     * overflow (when the input is less than smallest int88 or\\n     * greater than largest int88).\\n     *\\n     * Counterpart to Solidity's `int88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toInt88(int256 value) internal pure returns (int88 downcasted) {\\n        downcasted = int88(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(88, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int80 from int256, reverting on\\n     * overflow (when the input is less than smallest int80 or\\n     * greater than largest int80).\\n     *\\n     * Counterpart to Solidity's `int80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toInt80(int256 value) internal pure returns (int80 downcasted) {\\n        downcasted = int80(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(80, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int72 from int256, reverting on\\n     * overflow (when the input is less than smallest int72 or\\n     * greater than largest int72).\\n     *\\n     * Counterpart to Solidity's `int72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toInt72(int256 value) internal pure returns (int72 downcasted) {\\n        downcasted = int72(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(72, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int64 from int256, reverting on\\n     * overflow (when the input is less than smallest int64 or\\n     * greater than largest int64).\\n     *\\n     * Counterpart to Solidity's `int64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toInt64(int256 value) internal pure returns (int64 downcasted) {\\n        downcasted = int64(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(64, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int56 from int256, reverting on\\n     * overflow (when the input is less than smallest int56 or\\n     * greater than largest int56).\\n     *\\n     * Counterpart to Solidity's `int56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toInt56(int256 value) internal pure returns (int56 downcasted) {\\n        downcasted = int56(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(56, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int48 from int256, reverting on\\n     * overflow (when the input is less than smallest int48 or\\n     * greater than largest int48).\\n     *\\n     * Counterpart to Solidity's `int48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toInt48(int256 value) internal pure returns (int48 downcasted) {\\n        downcasted = int48(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(48, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int40 from int256, reverting on\\n     * overflow (when the input is less than smallest int40 or\\n     * greater than largest int40).\\n     *\\n     * Counterpart to Solidity's `int40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toInt40(int256 value) internal pure returns (int40 downcasted) {\\n        downcasted = int40(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(40, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int32 from int256, reverting on\\n     * overflow (when the input is less than smallest int32 or\\n     * greater than largest int32).\\n     *\\n     * Counterpart to Solidity's `int32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toInt32(int256 value) internal pure returns (int32 downcasted) {\\n        downcasted = int32(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(32, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int24 from int256, reverting on\\n     * overflow (when the input is less than smallest int24 or\\n     * greater than largest int24).\\n     *\\n     * Counterpart to Solidity's `int24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toInt24(int256 value) internal pure returns (int24 downcasted) {\\n        downcasted = int24(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(24, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int16 from int256, reverting on\\n     * overflow (when the input is less than smallest int16 or\\n     * greater than largest int16).\\n     *\\n     * Counterpart to Solidity's `int16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toInt16(int256 value) internal pure returns (int16 downcasted) {\\n        downcasted = int16(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(16, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int8 from int256, reverting on\\n     * overflow (when the input is less than smallest int8 or\\n     * greater than largest int8).\\n     *\\n     * Counterpart to Solidity's `int8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toInt8(int256 value) internal pure returns (int8 downcasted) {\\n        downcasted = int8(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(8, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Converts an unsigned uint256 into a signed int256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be less than or equal to maxInt256.\\n     */\\n    function toInt256(uint256 value) internal pure returns (int256) {\\n        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\\n        if (value > uint256(type(int256).max)) {\\n            revert SafeCastOverflowedUintToInt(value);\\n        }\\n        return int256(value);\\n    }\\n\\n    /**\\n     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.\\n     */\\n    function toUint(bool b) internal pure returns (uint256 u) {\\n        assembly (\\\"memory-safe\\\") {\\n            u := iszero(iszero(b))\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0x195533c86d0ef72bcc06456a4f66a9b941f38eb403739b00f21fd7c1abd1ae54\",\"license\":\"MIT\"},\"project/contracts/helpers/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { AccessManaged } from \\\"../utils/AccessManaged.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport \\\"contracts/interfaces/IHarvester.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nstruct YieldBearingParams {\\n  // Address of the asset used to mint the yield bearing asset\\n  address asset;\\n  // Target exposure to the collateral yield bearing asset used\\n  uint64 targetExposure;\\n  // Maximum exposure within the Parallelizer to the deposit asset\\n  uint64 maxExposure;\\n  // Minimum exposure within the Parallelizer to the deposit asset\\n  uint64 minExposure;\\n  // Whether limit exposures should be overriden or read onchain through the Parallelizer\\n  // This value should be 1 to override exposures or 2 if these shouldn't be overriden\\n  uint64 overrideExposures;\\n  // Maximum slippage when dealing with the Parallelizer\\n  uint96 maxSlippage;\\n}\\n\\n/// @title BaseHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Abstract contract for a harvester that aims at rebalancing a Parallelizer\\n/// @dev This contract is an authorized fork of Angle's BaseHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol\\nabstract contract BaseHarvester is IHarvester, AccessManaged {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       MODIFIERS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrusted() {\\n    if (!isTrusted[msg.sender]) revert NotTrusted();\\n    _;\\n  }\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted or guardian to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrustedOrRestricted() {\\n    if (!isTrusted[msg.sender] && !_checkCanCall(_msgSender(), _msgData())) {\\n      revert NotTrustedOrGuardian();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       VARIABLES\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Reference to the `parallelizer` implementation this contract aims at rebalancing\\n  IParallelizer public immutable parallelizer;\\n  /// @notice TokenP handled by the `parallelizer` of interest\\n  ITokenP public immutable tokenP;\\n  /// @notice Max slippage when dealing with the Parallelizer\\n  mapping(address => uint96) public maxTokenSlippage;\\n  /// @notice Data associated to a yield bearing asset\\n  mapping(address => YieldBearingParams) public yieldBearingData;\\n  /// @notice trusted addresses that can update target exposure and do others non critical operations\\n  mapping(address => bool) public isTrusted;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EVENTS                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  event Recovered(address token, uint256 amount, address to);\\n  event TrustedToggled(address trusted, bool status);\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       CONSTRUCTOR\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialAuthority,\\n    ITokenP definitiveTokenP,\\n    IParallelizer definitiveParallelizer\\n  )\\n    AccessManaged(initialAuthority)\\n  {\\n    tokenP = definitiveTokenP;\\n    parallelizer = definitiveParallelizer;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        GUARDIAN FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the yieldBearingAsset data\\n   * @param yieldBearingAsset address of the yieldBearingAsset\\n   * @param asset address of the asset\\n   * @param targetExposure target exposure to the yieldBearingAsset asset used\\n   * @param minExposure minimum exposure within the Parallelizer to the asset\\n   * @param maxExposure maximum exposure within the Parallelizer to the asset\\n   * @param overrideExposures whether limit exposures should be overriden or read onchain through the Parallelizer\\n   */\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external\\n    restricted\\n  {\\n    _setYieldBearingAssetData(\\n      yieldBearingAsset, asset, targetExposure, minExposure, maxExposure, overrideExposures, maxSlippage\\n    );\\n  }\\n\\n  /**\\n   * @notice Set the limit exposures to the asset linked to the yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   */\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) public virtual {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    if (yieldBearingInfo.overrideExposures == 2) {\\n      _updateLimitExposuresYieldAsset(yieldBearingInfo.asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  /**\\n   * @notice Set the max allowed slippage\\n   * @param newMaxSlippage new max allowed slippage\\n   */\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external restricted {\\n    _setMaxSlippage(yieldBearingAsset, newMaxSlippage);\\n  }\\n\\n  /**\\n   * @notice Toggle the trusted status of an address\\n   * @param trusted address to toggle the trusted status\\n   */\\n  function toggleTrusted(address trusted) external restricted {\\n    emit TrustedToggled(trusted, isTrusted[trusted]);\\n    isTrusted[trusted] = !isTrusted[trusted];\\n  }\\n\\n  /**\\n   * @notice Recover ERC20 tokens\\n   * @param tokenAddress address of the token to recover\\n   * @param amountToRecover amount to recover\\n   * @param to address to send the recovered tokens\\n   */\\n  function recoverERC20(address tokenAddress, uint256 amountToRecover, address to) external restricted {\\n    emit Recovered(tokenAddress, amountToRecover, to);\\n    IERC20(tokenAddress).safeTransfer(to, amountToRecover);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        TRUSTED FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the target exposure of a yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @param targetExposure target exposure to the yield bearing asset used\\n   */\\n  function setTargetExposure(address yieldBearingAsset, uint64 targetExposure) external onlyTrustedOrRestricted {\\n    yieldBearingData[yieldBearingAsset].targetExposure = targetExposure;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        VIEW FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Compute the amount needed to rebalance the Parallelizer\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @return increase whether the exposure should be increased\\n   * @return amount amount to be rebalanced\\n   */\\n  function computeRebalanceAmount(address yieldBearingAsset) external view returns (uint8 increase, uint256 amount) {\\n    return _computeRebalanceAmount(yieldBearingAsset, yieldBearingData[yieldBearingAsset]);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        INTERNAL FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _computeRebalanceAmount(\\n    address yieldBearingAsset,\\n    YieldBearingParams memory yieldBearingInfo\\n  )\\n    internal\\n    view\\n    returns (uint8 increase, uint256 amount)\\n  {\\n    (uint256 stablecoinsFromYieldBearingAsset, uint256 stablecoinsIssued) =\\n      parallelizer.getIssuedByCollateral(yieldBearingAsset);\\n    (uint256 stablecoinsFromAsset,) = parallelizer.getIssuedByCollateral(yieldBearingInfo.asset);\\n    uint256 targetExposureScaled = yieldBearingInfo.targetExposure * stablecoinsIssued;\\n    if (stablecoinsFromYieldBearingAsset * 1e9 > targetExposureScaled) {\\n      // Need to decrease exposure to yield bearing asset\\n      amount = stablecoinsFromYieldBearingAsset - targetExposureScaled / 1e9;\\n      uint256 maxValueScaled = yieldBearingInfo.maxExposure * stablecoinsIssued;\\n      // These checks assume that there are no transaction fees on the stablecoin->collateral conversion and so\\n      // it's still possible that exposure goes above the max exposure in some rare cases\\n      if (stablecoinsFromAsset * 1e9 > maxValueScaled) {\\n        amount = 0;\\n      } else if ((stablecoinsFromAsset + amount) * 1e9 > maxValueScaled) {\\n        amount = maxValueScaled / 1e9 - stablecoinsFromAsset;\\n      }\\n    } else {\\n      // In this case, exposure after the operation might remain slightly below the targetExposure as less\\n      // collateral may be obtained by burning stablecoins for the yield asset and unwrapping it\\n      increase = 1;\\n      amount = targetExposureScaled / 1e9 - stablecoinsFromYieldBearingAsset;\\n      uint256 minValueScaled = yieldBearingInfo.minExposure * stablecoinsIssued;\\n      if (stablecoinsFromAsset * 1e9 < minValueScaled) {\\n        amount = 0;\\n      } else if (stablecoinsFromAsset * 1e9 < minValueScaled + amount * 1e9) {\\n        amount = stablecoinsFromAsset - minValueScaled / 1e9;\\n      }\\n    }\\n  }\\n\\n  function _setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    internal\\n    virtual\\n  {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    yieldBearingInfo.asset = asset;\\n    if (targetExposure >= 1e9) revert InvalidParam();\\n    if (maxSlippage >= 1e9) revert InvalidParam();\\n    yieldBearingInfo.targetExposure = targetExposure;\\n    yieldBearingInfo.overrideExposures = overrideExposures;\\n    yieldBearingInfo.maxSlippage = maxSlippage;\\n    if (overrideExposures == 1) {\\n      if (maxExposure >= 1e9 || minExposure >= maxExposure) revert InvalidParam();\\n      yieldBearingInfo.maxExposure = maxExposure;\\n      yieldBearingInfo.minExposure = minExposure;\\n    } else {\\n      yieldBearingInfo.overrideExposures = 2;\\n      _updateLimitExposuresYieldAsset(asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  function _updateLimitExposuresYieldAsset(\\n    address asset,\\n    YieldBearingParams storage yieldBearingInfo\\n  )\\n    internal\\n    virtual\\n  {\\n    uint64[] memory xFeeMint;\\n    (xFeeMint,) = parallelizer.getCollateralMintFees(asset);\\n    uint256 length = xFeeMint.length;\\n    if (length <= 1) yieldBearingInfo.maxExposure = 1e9;\\n    else yieldBearingInfo.maxExposure = xFeeMint[length - 2];\\n\\n    uint64[] memory xFeeBurn;\\n    (xFeeBurn,) = parallelizer.getCollateralBurnFees(asset);\\n    length = xFeeBurn.length;\\n    if (length <= 1) yieldBearingInfo.minExposure = 0;\\n    else yieldBearingInfo.minExposure = xFeeBurn[length - 2];\\n  }\\n\\n  function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {\\n    if (newMaxSlippage > 1e9) revert InvalidParam();\\n    maxTokenSlippage[yieldBearingAsset] = newMaxSlippage;\\n  }\\n\\n  function _scaleAmountBasedOnDecimals(\\n    uint256 decimalsTokenIn,\\n    uint256 decimalsTokenOut,\\n    uint256 amountIn,\\n    bool assetIn\\n  )\\n    internal\\n    pure\\n    returns (uint256)\\n  {\\n    if (decimalsTokenIn > decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn /= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      } else {\\n        amountIn *= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      }\\n    } else if (decimalsTokenIn < decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn *= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      } else {\\n        amountIn /= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      }\\n    }\\n    return amountIn;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    HELPER                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _adjustAllowance(address token, address sender, uint256 amountIn) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), sender);\\n    if (allowance < amountIn) IERC20(token).safeIncreaseAllowance(sender, type(uint256).max - allowance);\\n  }\\n}\\n\",\"keccak256\":\"0x82e2ae57997043160d7529488b34591c710cd74e267213b61009daa96e9eeaaf\",\"license\":\"GPL-3.0\"},\"project/contracts/helpers/GenericHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeCast } from \\\"@openzeppelin/contracts/utils/math/SafeCast.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IERC20Metadata } from \\\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\\\";\\nimport { IERC3156FlashBorrower } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\\\";\\nimport { IERC3156FlashLender } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\\\";\\nimport { RouterSwapper } from \\\"@helpers/RouterSwapper.sol\\\";\\n\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport { IERC4626 } from \\\"contracts/interfaces/external/IERC4626.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nimport { BaseHarvester, YieldBearingParams } from \\\"./BaseHarvester.sol\\\";\\n\\nenum SwapType {\\n  VAULT,\\n  SWAP\\n}\\n\\n/// @title GenericHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Generic contract for anyone to permissionlessly adjust the reserves of Angle Parallelizer\\n/// @dev This contract is an authorized fork of Angle's GenericHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\\ncontract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {\\n  using SafeCast for uint256;\\n  using SafeERC20 for IERC20;\\n\\n  bytes32 public constant CALLBACK_SUCCESS = keccak256(\\\"ERC3156FlashBorrower.onFlashLoan\\\");\\n\\n  /// @notice Parallel stablecoin flashloan contract\\n  IERC3156FlashLender public immutable flashloan;\\n  /// @notice Budget of tokenP available for each users\\n  mapping(address => uint256) public budget;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INITIALIZATION                                                  \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialTokenTransferAddress,\\n    address initialSwapRouter,\\n    ITokenP definitivetokenP,\\n    IParallelizer definitiveParallelizer,\\n    address initialAuthority,\\n    IERC3156FlashLender definitiveFlashloan\\n  )\\n    RouterSwapper(initialSwapRouter, initialTokenTransferAddress)\\n    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)\\n  {\\n    if (address(definitiveFlashloan) == address(0)) revert ZeroAddress();\\n    flashloan = definitiveFlashloan;\\n\\n    IERC20(tokenP).approve(address(definitiveFlashloan), type(uint256).max);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        BUDGET HANDLING\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Add budget to be spent by the receiver during the flashloan\\n   * @param amount amount of tokenP to add to the budget\\n   * @param receiver address of the receiver\\n   */\\n  function addBudget(uint256 amount, address receiver) public virtual {\\n    budget[receiver] += amount;\\n\\n    IERC20(tokenP).safeTransferFrom(msg.sender, address(this), amount);\\n  }\\n\\n  /**\\n   * @notice Remove budget from the owner and send it to the receiver\\n   * @param amount amount of tokenP to remove from the budget\\n   * @param receiver address of the receiver\\n   */\\n  function removeBudget(uint256 amount, address receiver) public virtual {\\n    budget[msg.sender] -= amount; // Will revert if not enough funds\\n\\n    IERC20(tokenP).safeTransfer(receiver, amount);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        HARVEST\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure\\n  ///  to this yieldBearingAsset\\n  /// @dev This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up\\n  /// some yieldBearingAsset that can then be used for people looking to burn deposit tokens\\n  /// @dev Due to potential transaction fees within the Parallelizer, this function doesn't exactly bring\\n  /// `yieldBearingAsset` to the target exposure\\n  /// @dev scale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest,\\n  /// it is used to lower the amount of the asset to harvest for example to have a lower slippage\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual {\\n    if (scale > 1e9) revert InvalidParam();\\n    updateLimitExposuresYieldAsset(yieldBearingAsset);\\n    YieldBearingParams memory yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    (uint8 increase, uint256 amount) = _computeRebalanceAmount(yieldBearingAsset, yieldBearingInfo);\\n    amount = (amount * scale) / 1e9;\\n    if (amount == 0) revert ZeroAmount();\\n    (SwapType swapType, bytes memory data) = abi.decode(extraData, (SwapType, bytes));\\n    try parallelizer.updateOracle(yieldBearingAsset) { } catch { }\\n    _adjustYieldExposure(\\n      amount,\\n      increase,\\n      yieldBearingAsset,\\n      yieldBearingInfo.asset,\\n      (amount * (1e9 - yieldBearingInfo.maxSlippage)) / 1e9,\\n      swapType,\\n      data\\n    );\\n  }\\n\\n  /// @inheritdoc IERC3156FlashBorrower\\n  function onFlashLoan(\\n    address initiator,\\n    address,\\n    uint256 amount,\\n    uint256 fee,\\n    bytes calldata data\\n  )\\n    public\\n    virtual\\n    returns (bytes32)\\n  {\\n    if (msg.sender != address(flashloan) || initiator != address(this) || fee != 0) revert NotTrusted();\\n    address sender;\\n    uint256 typeAction;\\n    uint256 minAmountOut;\\n    SwapType swapType;\\n    bytes memory callData;\\n    address tokenOut;\\n    address tokenIn;\\n    {\\n      address yieldBearingAsset;\\n      address asset;\\n      (sender, typeAction, yieldBearingAsset, asset, minAmountOut, swapType, callData) =\\n        abi.decode(data, (address, uint256, address, address, uint256, SwapType, bytes));\\n      if (typeAction == 1) {\\n        // Increase yield exposure action: we bring in the yield bearing asset\\n        tokenOut = yieldBearingAsset;\\n        tokenIn = asset;\\n      } else {\\n        // Decrease yield exposure action: we bring in the deposit asset\\n        tokenIn = yieldBearingAsset;\\n        tokenOut = asset;\\n      }\\n    }\\n    uint256 amountOut =\\n      parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);\\n\\n    // Swap to tokenIn\\n    amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);\\n\\n    _adjustAllowance(tokenOut, address(parallelizer), amountOut);\\n    uint256 amountStableOut =\\n      parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);\\n    if (amount > amountStableOut) {\\n      budget[sender] -= amount - amountStableOut; // Will revert if not enough funds\\n    }\\n    return CALLBACK_SUCCESS;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    SETTERS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the token transfer contract\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress) public override restricted {\\n    super.setTokenTransferAddress(newTokenTransferAddress);\\n  }\\n\\n  /**\\n   * @notice Set the swap router\\n   * @param newSwapRouter address of the swap router\\n   */\\n  function setSwapRouter(address newSwapRouter) public override restricted {\\n    super.setSwapRouter(newSwapRouter);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INTERNALS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Burns `amountStablecoins` for one yieldBearing asset, swap for asset then mints deposit tokens\\n  /// from the proceeds of the swap.\\n  /// @dev If `increase` is 1, then the system tries to increase its exposure to the yield bearing asset which means\\n  /// burning tokenP for the deposit asset, swapping for the yield bearing asset, then minting the tokenP\\n  /// @dev This function reverts if the second tokenP mint gives less than `minAmountOut` of ag tokens\\n  /// @dev This function reverts if the swap slippage is higher than `maxSlippage`\\n  function _adjustYieldExposure(\\n    uint256 amountStablecoins,\\n    uint8 increase,\\n    address yieldBearingAsset,\\n    address asset,\\n    uint256 minAmountOut,\\n    SwapType swapType,\\n    bytes memory extraData\\n  )\\n    internal\\n  {\\n    flashloan.flashLoan(\\n      IERC3156FlashBorrower(address(this)),\\n      address(tokenP),\\n      amountStablecoins,\\n      abi.encode(msg.sender, increase, yieldBearingAsset, asset, minAmountOut, swapType, extraData)\\n    );\\n  }\\n\\n  function _swapToTokenOut(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    SwapType swapType,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (swapType == SwapType.SWAP) {\\n      amountOut = _swapToTokenOutSwap(tokenIn, tokenOut, amount, callData);\\n    } else if (swapType == SwapType.VAULT) {\\n      amountOut = _swapToTokenOutVault(typeAction, tokenIn, tokenOut, amount);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap token using the router/aggregator\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _swapToTokenOutSwap(\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256)\\n  {\\n    uint256 balance = IERC20(tokenOut).balanceOf(address(this));\\n\\n    address[] memory tokens = new address[](1);\\n    tokens[0] = tokenIn;\\n    bytes[] memory callDatas = new bytes[](1);\\n    callDatas[0] = callData;\\n    uint256[] memory amounts = new uint256[](1);\\n    amounts[0] = amount;\\n    _swap(tokens, callDatas, amounts);\\n\\n    return IERC20(tokenOut).balanceOf(address(this)) - balance;\\n  }\\n\\n  /**\\n   * @dev Deposit or redeem the vault asset\\n   * @param typeAction 1 for deposit, 2 for redeem\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   */\\n  function _swapToTokenOutVault(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (typeAction == 1) {\\n      // Granting allowance with the yieldBearingAsset for the vault asset\\n      _adjustAllowance(tokenIn, tokenOut, amount);\\n      amountOut = IERC4626(tokenOut).deposit(amount, address(this));\\n    } else {\\n      amountOut = IERC4626(tokenIn).redeem(amount, address(this), address(this));\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x604c4f9c755b2eb704dc15ba59046201c0258134ef2fbe15a529c510c68cb40a\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/IDiamondCut.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IDiamondCut\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondCut.sol by mudgen\\n/// @dev This interface is an authorized fork of Angle's `IDiamondCut` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IDiamondCut.sol\\ninterface IDiamondCut {\\n  /// @notice Add/replace/remove any number of functions and optionally execute a function with delegatecall\\n  /// @param _diamondCut Contains the facet addresses and function selectors\\n  /// @param _init The address of the contract or facet to execute _calldata\\n  /// @param _calldata A function call, including function selector and arguments, executed with delegatecall on\\n  /// _init\\n  function diamondCut(FacetCut[] calldata _diamondCut, address _init, bytes calldata _calldata) external;\\n}\\n\",\"keccak256\":\"0x08a01f77b740f7da424f0ea27a6a292f9e292058e23d1fe960d2d19a44496c7b\",\"license\":\"MIT\"},\"project/contracts/interfaces/IDiamondEtherscan.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\n/// @title IDiamondEtherscan\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface IDiamondEtherscan {\\n  /// @notice Sets a dummy implementation with the same layout at the diamond proxy contract with all its facets\\n  function setDummyImplementation(address _implementation) external;\\n\\n  /// @notice Address of the dummy implementation used to make the DiamondProxy contract interpretable by Etherscan\\n  function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xf742b55592d129e02fb755d25f7a97ed976a14c4c744d6ac46726809e8f1e037\",\"license\":\"MIT\"},\"project/contracts/interfaces/IDiamondLoupe.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @notice IDiamondLoupe\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondLoupe.sol by mudgen\\ninterface IDiamondLoupe {\\n  /// @notice Gets all facet addresses and their four byte function selectors.\\n  /// @return facets_ Facet\\n  function facets() external view returns (Facet[] memory facets_);\\n\\n  /// @notice Gets all the function selectors supported by a specific facet.\\n  /// @param _facet The facet address.\\n  /// @return facetFunctionSelectors_\\n  function facetFunctionSelectors(address _facet) external view returns (bytes4[] memory facetFunctionSelectors_);\\n\\n  /// @notice Get all the facet addresses used by a diamond.\\n  /// @return facetAddresses_\\n  function facetAddresses() external view returns (address[] memory facetAddresses_);\\n\\n  /// @notice Gets the facet that supports the given selector.\\n  /// @dev If facet is not found return address(0).\\n  /// @param _functionSelector The function selector.\\n  /// @return facetAddress_ The facet address.\\n  function facetAddress(bytes4 _functionSelector) external view returns (address facetAddress_);\\n}\\n\",\"keccak256\":\"0xa5580958acabe2c44967e835e77a748eb0b8812f70cd071191201508c9388ca8\",\"license\":\"MIT\"},\"project/contracts/interfaces/IGetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IGetters\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IGetters` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IGetters.sol\\ninterface IGetters {\\n  /// @notice Checks whether a given `selector` is actually a valid selector corresponding to a function in one of\\n  /// the\\n  /// facets of the proxy\\n  function isValidSelector(bytes4 selector) external view returns (bool);\\n\\n  /// @notice Stablecoin minted by parallelizer\\n  function tokenP() external view returns (ITokenP);\\n\\n  /// @notice Returns the list of collateral assets supported by the system\\n  function getCollateralList() external view returns (address[] memory);\\n\\n  /// @notice Returns all the info in storage associated to a `collateral`\\n  function getCollateralInfo(address collateral) external view returns (Collateral memory);\\n\\n  /// @notice Returns the decimals of a given `collateral`\\n  function getCollateralDecimals(address collateral) external view returns (uint8);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to mint\\n  /// with `collateral`\\n  function getCollateralMintFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to burn\\n  /// for `collateral`\\n  function getCollateralBurnFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays used to compute the penalty factor depending on the collateral\\n  /// ratio when users come to redeem\\n  function getRedemptionFees() external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the collateral ratio of Parallelizer in base `10**9` and a rounded version of the total amount\\n  /// of stablecoins issued\\n  function getCollateralRatio() external view returns (uint64 collatRatio, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the total amount of stablecoins issued through Parallelizer\\n  function getTotalIssued() external view returns (uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the amount of stablecoins issued from `collateral` and the total amount of stablecoins issued\\n  /// through Parallelizer\\n  function getIssuedByCollateral(address collateral)\\n    external\\n    view\\n    returns (uint256 stablecoinsFromCollateral, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns if a collateral is \\\"managed\\\" and the associated manager configuration\\n  function getManagerData(address collateral)\\n    external\\n    view\\n    returns (bool isManaged, IERC20[] memory subCollaterals, bytes memory config);\\n\\n  /// @notice Returns the oracle values associated to `collateral`\\n  /// @return mint Oracle value to be used for a mint transaction with `collateral`\\n  /// @return burn Oracle value that will be used for `collateral` for a burn transaction. This value\\n  /// is then used along with oracle values for all other collateral assets to get a global burn value for the oracle\\n  /// @return ratio Ratio, in base `10**18` between the oracle value of the `collateral` and its target price.\\n  /// This value is 10**18 if the oracle is greater than the collateral price\\n  /// @return minRatio Minimum ratio across all collateral assets between a collateral burn price and its target\\n  /// price. This value is independent of `collateral` and is used to normalize the burn oracle value for burn\\n  /// transactions.\\n  /// @return redemption Oracle value that would be used to price `collateral` when computing the collateral ratio\\n  /// during a redemption\\n  function getOracleValues(address collateral)\\n    external\\n    view\\n    returns (uint256 mint, uint256 burn, uint256 ratio, uint256 minRatio, uint256 redemption);\\n\\n  /// @notice Returns the data used to compute oracle values for `collateral`\\n  /// @return oracleType Type of oracle (Chainlink, external smart contract, ...)\\n  /// @return targetType Type passed to read the value of the target price\\n  /// @return oracleData Extra data needed to read the oracle. For Chainlink oracles, this data is supposed to give\\n  /// the addresses of the Chainlink feeds to read, the stale periods for each feed, ...\\n  /// @return targetData Extra data needed to read the target price of the asset\\n  function getOracle(address collateral)\\n    external\\n    view\\n    returns (\\n      OracleReadType oracleType,\\n      OracleReadType targetType,\\n      bytes memory oracleData,\\n      bytes memory targetData,\\n      bytes memory hyperparameters\\n    );\\n\\n  /// @notice Returns if the associated functionality is paused or not\\n  function isPaused(address collateral, ActionType action) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update normalizers\\n  function isTrusted(address sender) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update sell rewards\\n  function isTrustedSeller(address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` has a non null entry in the `isWhitelistedForType` storage mapping\\n  /// @dev Note that ultimately whitelisting may depend as well on external providers\\n  function isWhitelistedForType(WhitelistType whitelistType, address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` can deal with `collateral` during burns and redemptions\\n  function isWhitelistedForCollateral(address collateral, address sender) external returns (bool);\\n\\n  /// @notice Checks whether only whitelisted address can deal with `collateral` during burns and redemptions\\n  function isWhitelistedCollateral(address collateral) external view returns (bool);\\n\\n  /// @notice Gets the data needed to deal with whitelists for `collateral`\\n  function getCollateralWhitelistData(address collateral) external view returns (bytes memory);\\n\\n  /// @notice Returns the stablecoin cap for `collateral`\\n  function getStablecoinCap(address collateral) external view returns (uint256);\\n\\n  /// @notice Returns the address of the `accessManager` contract\\n  function accessManager() external view returns (address);\\n\\n  /// @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n  /// being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n  /// attacker controlled calls.\\n  function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaa9eba6ee7770d6146fedbfef07ad10ff09524692319ca0cc32abfa64a2b597b\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/IHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IHarvester` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IHarvester.sol\\ninterface IHarvester {\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address stablecoin,\\n    uint64 targetExposure,\\n    uint64 minExposureYieldAsset,\\n    uint64 maxExposureYieldAsset,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external;\\n\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) external;\\n\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external;\\n\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) external;\\n}\\n\",\"keccak256\":\"0x0d4e8fee737f4f747060a3c5044c8cb2f153faa228ad37a661a659ca62aab055\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/IParallelizer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IDiamondCut } from \\\"./IDiamondCut.sol\\\";\\nimport { IDiamondEtherscan } from \\\"./IDiamondEtherscan.sol\\\";\\nimport { IDiamondLoupe } from \\\"./IDiamondLoupe.sol\\\";\\nimport { IGetters } from \\\"./IGetters.sol\\\";\\nimport { IRedeemer } from \\\"./IRedeemer.sol\\\";\\nimport { IRewardHandler } from \\\"./IRewardHandler.sol\\\";\\nimport { ISettersGovernor, ISettersGuardian } from \\\"./ISetters.sol\\\";\\nimport { ISwapper } from \\\"./ISwapper.sol\\\";\\n\\n/// @title IParallelizer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IParallelizer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IParallelizer.sol\\ninterface IParallelizer is\\n  IDiamondCut,\\n  IDiamondEtherscan,\\n  IDiamondLoupe,\\n  IGetters,\\n  IRedeemer,\\n  IRewardHandler,\\n  ISettersGovernor,\\n  ISettersGuardian,\\n  ISwapper\\n{ }\\n\",\"keccak256\":\"0x8bd964110c6a122bdb6cf58a194a97c894900237ebd7f3b11e2f43c6ee56ae7c\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/IRedeemer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRedeemer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRedeemer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRedeemer.sol\\ninterface IRedeemer {\\n  /// @notice Redeems `amount` of stablecoins from the system\\n  /// @param receiver Address which should be receiving the output tokens\\n  /// @param deadline Timestamp before which the redemption should have occured\\n  /// @param minAmountOuts Minimum amount of each token given back in the redemption to obtain\\n  /// @return tokens List of tokens returned\\n  /// @return amounts Amount given for each token in the `tokens` array\\n  function redeem(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Same as the redeem function above with the additional feature to specify a list of `forfeitTokens` for\\n  /// which the Parallelizer system will not try to do a transfer to `receiver`.\\n  function redeemWithForfeit(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts,\\n    address[] memory forfeitTokens\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Simulate the exact output that a redemption of `amount` of stablecoins would give at a given block\\n  /// @return tokens List of tokens that would be given\\n  /// @return amounts Amount that would be obtained for each token in the `tokens` array\\n  function quoteRedemptionCurve(uint256 amount)\\n    external\\n    view\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Updates the normalizer variable by `amount`\\n  function updateNormalizer(uint256 amount, bool increase) external returns (uint256);\\n}\\n\",\"keccak256\":\"0xb3522ee0380b321c64d02bf2db2acb658d8b314b811dd54b6a718d6708b5fb21\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/IRewardHandler.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRewardHandler\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRewardHandler` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRewardHandler.sol\\ninterface IRewardHandler {\\n  /// @notice Sells some external tokens through a odos call\\n  /// @param minAmountOut Minimum amount of the outToken to get\\n  /// @param payload Payload to pass to odos\\n  /// @return amountOut Amount obtained of the outToken\\n  function sellRewards(uint256 minAmountOut, bytes memory payload) external returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xff2afcbc8d1c25297324159d3684a323e60b3c9408129aba70d3d6938d093255\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/ISetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/interfaces/IERC20.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISettersGovernor` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISetters.sol\\ninterface ISettersGovernor {\\n  /// @notice Recovers `amount` of `token` from the Parallelizer contract\\n  function recoverERC20(address collateral, IERC20 token, address to, uint256 amount) external;\\n\\n  /// @notice Sets a new access manager address\\n  function setAccessManager(address _newAccessManager) external;\\n\\n  /// @notice Sets (or unsets) a collateral manager  `collateral`\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before setting the new manager\\n  function setCollateralManager(\\n    address collateral,\\n    bool checkExternalManagerBalance,\\n    ManagerStorage memory managerData\\n  )\\n    external;\\n\\n  /// @notice Sets the allowance of the contract on `token` for `spender` to `amount`\\n  function changeAllowance(IERC20 token, address spender, uint256 amount) external;\\n\\n  /// @notice Changes the trusted status for `sender` when for selling rewards or updating the normalizer\\n  function toggleTrusted(address sender, TrustedType t) external;\\n\\n  /// @notice Changes whether a `collateral` can only be handled during burns and redemptions by whitelisted\\n  /// addresses\\n  /// and sets the data used to read into the whitelist\\n  function setWhitelistStatus(address collateral, uint8 whitelistStatus, bytes memory whitelistData) external;\\n\\n  /// @notice Add `collateral` as a supported collateral in the system\\n  function addCollateral(address collateral) external;\\n\\n  /// @notice Adjusts the amount of stablecoins issued from `collateral` by `amount`\\n  function adjustStablecoins(address collateral, uint128 amount, bool increase) external;\\n\\n  /// @notice Revokes `collateral` from the system\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before revoking the collateral\\n  function revokeCollateral(address collateral, bool checkExternalManagerBalance) external;\\n\\n  /// @notice Sets the `oracleConfig` used to read the value of `collateral` for the mint, burn and redemption\\n  /// operations\\n  function setOracle(address collateral, bytes memory oracleConfig) external;\\n\\n  /// @notice Update oracle data for a given `collateral`\\n  function updateOracle(address collateral) external;\\n}\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface ISettersGuardian {\\n  /// @notice Changes the pause status for mint or burn transactions for `collateral`\\n  function togglePause(address collateral, ActionType action) external;\\n\\n  /// @notice Sets the mint or burn fees for `collateral`\\n  function setFees(address collateral, uint64[] memory xFee, int64[] memory yFee, bool mint) external;\\n\\n  /// @notice Sets the parameters for the redemption curve\\n  function setRedemptionCurveParams(uint64[] memory xFee, int64[] memory yFee) external;\\n\\n  /// @notice Changes the whitelist status for a collateral with `whitelistType` for an address `who`\\n  function toggleWhitelist(WhitelistType whitelistType, address who) external;\\n\\n  /// @notice Sets the stablecoin cap that can be issued from a `collateral`\\n  function setStablecoinCap(address collateral, uint256 stablecoinCap) external;\\n}\\n\",\"keccak256\":\"0xc3fb2012e7c2f97ae93b12276afc4293aaeb97a6fe4d60109acaa94ef6945575\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/ISwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title ISwapper\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISwapper` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISwapper.sol\\ninterface ISwapper {\\n  /// @notice Swaps (that is to say mints or burns) an exact amount of `tokenIn` for an amount of `tokenOut`\\n  /// @param amountIn Amount of `tokenIn` to bring\\n  /// @param amountOutMin Minimum amount of `tokenOut` to get: if `amountOut` is inferior to this amount, the\\n  /// function will revert\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountOut Amount of `tokenOut` obtained through the swap\\n  function swapExactInput(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Same as `swapExactInput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactInputWithPermit(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Swaps (that is to say mints or burns) an amount of `tokenIn` for an exact amount of `tokenOut`\\n  /// @param amountOut Amount of `tokenOut` to obtain from the swap\\n  /// @param amountInMax Maximum amount of `tokenIn` to bring in order to get `amountOut` of `tokenOut`\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountIn Amount of `tokenIn` used to perform the swap\\n  function swapExactOutput(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Same as `swapExactOutput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactOutputWithPermit(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Simulates what a call to `swapExactInput` with `amountIn` of `tokenIn` for `tokenOut` would give.\\n  /// If called right before and at the same block, the `amountOut` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactInput`\\n  function quoteIn(uint256 amountIn, address tokenIn, address tokenOut) external view returns (uint256 amountOut);\\n\\n  /// @notice Simulates what a call to `swapExactOutput` for `amountOut` of `tokenOut` with `tokenIn` would give.\\n  /// If called right before and at the same block, the `amountIn` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactOutput`\\n  function quoteOut(uint256 amountOut, address tokenIn, address tokenOut) external view returns (uint256 amountIn);\\n}\\n\",\"keccak256\":\"0x47e4b2742a51b82b9df72fb681335affe8519f4114fb540cd29d8f48ed182ffd\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/ITokenP.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/// @title ITokenP\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @notice Interface for the stablecoins `tokenP` contracts\\n/// @dev This interface is an authorized fork of Angle's `IAgToken` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IAgToken.sol\\ninterface ITokenP is IERC20 {\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    MINTER ROLE ONLY FUNCTIONS                                            \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Lets a whitelisted contract mint tokenPs\\n  /// @param account Address to mint to\\n  /// @param amount Amount to mint\\n  function mint(address account, uint256 amount) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address after being asked to by `sender`\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @param sender Address which requested the burn from `burner`\\n  /// @dev This method is to be called by a contract with the minter right after being requested\\n  /// to do so by a `sender` address willing to burn tokens from another `burner` address\\n  /// @dev The method checks the allowance between the `sender` and the `burner`\\n  function burnFrom(uint256 amount, address burner, address sender) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @dev This method is to be called by a contract with a minter right on the tokenP after being\\n  /// requested to do so by an address willing to burn tokens from its address\\n  function burnSelf(uint256 amount, address burner) external;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EXTERNAL FUNCTIONS                                                \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Amount of decimals of the stablecoin\\n  function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x64a1305faa8c5c91767a11af0eae16e4b463aa0bfe10f11b74aae9d96681a5eb\",\"license\":\"GPL-3.0\"},\"project/contracts/interfaces/external/IERC4626.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\n// OpenZeppelin Contracts (last updated v4.7.0) (interfaces/IERC4626.sol)\\n\\npragma solidity >=0.5.0;\\n\\n/// @notice ERC4626 interface\\n/// @author OpenZeppelin\\n/// @dev In this implementation, the interface only contains the functions that the IERC4626 interface adds on top of\\n/// the IERC20 interface\\ninterface IERC4626 {\\n  /**\\n   * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.\\n   *\\n   * - MUST be an ERC-20 token contract.\\n   * - MUST NOT revert.\\n   */\\n  function asset() external view returns (address assetTokenAddress);\\n\\n  /**\\n   * @dev Returns the total amount of the underlying asset that is \\u201cmanaged\\u201d by Vault.\\n   *\\n   * - SHOULD include any compounding that occurs from yield.\\n   * - MUST be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT revert.\\n   */\\n  function totalAssets() external view returns (uint256 totalManagedAssets);\\n\\n  /**\\n   * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToShares(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToAssets(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,\\n   * through a deposit call.\\n   *\\n   * - MUST return a limited value if receiver is subject to some deposit limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.\\n   * - MUST NOT revert.\\n   */\\n  function maxDeposit(address receiver) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit\\n   *   call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called\\n   *   in the same transaction.\\n   * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the\\n   *   deposit would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewDeposit(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   deposit execution, and are accounted for during deposit.\\n   * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function deposit(uint256 assets, address receiver) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.\\n   * - MUST return a limited value if receiver is subject to some mint limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.\\n   * - MUST NOT revert.\\n   */\\n  function maxMint(address receiver) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call\\n   *   in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the\\n   *   same transaction.\\n   * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint\\n   *   would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by minting.\\n   */\\n  function previewMint(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint\\n   *   execution, and are accounted for during mint.\\n   * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function mint(uint256 shares, address receiver) external returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the\\n   * Vault, through a withdraw call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxWithdraw(address owner) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw\\n   *   call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if\\n   *   called\\n   *   in the same transaction.\\n   * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though\\n   *   the withdrawal would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewWithdraw(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   withdraw execution, and are accounted for during withdraw.\\n   * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,\\n   * through a redeem call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxRedeem(address owner) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call\\n   *   in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the\\n   *   same transaction.\\n   * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the\\n   *   redemption would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by redeeming.\\n   */\\n  function previewRedeem(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   redeem execution, and are accounted for during redeem.\\n   * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);\\n}\\n\",\"keccak256\":\"0xd730d6a6b679201eec89dff3133de651da20b3e72e74f01b734078bfacf952ad\",\"license\":\"GPL-3.0\"},\"project/contracts/parallelizer/Storage.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        ENUMS                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nenum FacetCutAction {\\n  Add,\\n  Replace,\\n  Remove\\n}\\n\\nenum ManagerType {\\n  EXTERNAL\\n}\\n\\nenum ActionType {\\n  Mint,\\n  Burn,\\n  Redeem\\n}\\n\\nenum TrustedType {\\n  Updater,\\n  Seller\\n}\\n\\nenum QuoteType {\\n  MintExactInput,\\n  MintExactOutput,\\n  BurnExactInput,\\n  BurnExactOutput\\n}\\n\\nenum OracleReadType {\\n  CHAINLINK_FEEDS,\\n  EXTERNAL,\\n  NO_ORACLE,\\n  STABLE,\\n  WSTETH,\\n  CBETH,\\n  RETH,\\n  SFRXETH,\\n  MAX,\\n  MORPHO_ORACLE\\n}\\n\\nenum OracleQuoteType {\\n  UNIT,\\n  TARGET\\n}\\n\\nenum WhitelistType {\\n  BACKED\\n}\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                    STRUCTS                                                     \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nstruct Permit2Details {\\n  address to; // Address that will receive the funds\\n  uint256 nonce; // Nonce of the transaction\\n  bytes signature; // Permit signature of the user\\n}\\n\\nstruct FacetCut {\\n  address facetAddress; // Facet contract address\\n  FacetCutAction action; // Can be add, remove or replace\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct Facet {\\n  address facetAddress; // Facet contract address\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct FacetInfo {\\n  address facetAddress; // Facet contract address\\n  uint16 selectorPosition; // Position in the list of all selectors\\n}\\n\\nstruct DiamondStorage {\\n  bytes4[] selectors; // List of all available selectors\\n  mapping(bytes4 => FacetInfo) selectorInfo; // Selector to (address, position in list)\\n  IAccessManager accessManager; // Contract handling access management\\n}\\n\\nstruct ImplementationStorage {\\n  address implementation; // Dummy implementation address for Etherscan usability\\n}\\n\\nstruct ManagerStorage {\\n  IERC20[] subCollaterals; // Subtokens handled by the manager or strategies\\n  bytes config; // Additional configuration data\\n}\\n\\nstruct Collateral {\\n  uint8 isManaged; // If the collateral is managed through external strategies\\n  uint8 isMintLive; // If minting from this asset is unpaused\\n  uint8 isBurnLive; // If burning to this asset is unpaused\\n  uint8 decimals; // IERC20Metadata(collateral).decimals()\\n  uint8 onlyWhitelisted; // If only whitelisted addresses can burn or redeem for this token\\n  uint216 normalizedStables; // Normalized amount of stablecoins issued from this collateral\\n  uint64[] xFeeMint; // Increasing exposures in [0,BASE_9[\\n  int64[] yFeeMint; // Mint fees at the exposures specified in `xFeeMint`\\n  uint64[] xFeeBurn; // Decreasing exposures in ]0,BASE_9]\\n  int64[] yFeeBurn; // Burn fees at the exposures specified in `xFeeBurn`\\n  bytes oracleConfig; // Data about the oracle used for the collateral\\n  bytes whitelistData; // For whitelisted collateral, data used to verify whitelists\\n  ManagerStorage managerData; // For managed collateral, data used to handle the strategies\\n  uint256 stablecoinCap; // Cap on the amount of stablecoins that can be issued from this collateral\\n}\\n\\nstruct ParallelizerStorage {\\n  ITokenP tokenP; // tokenP handled by the system\\n  uint8 isRedemptionLive; // If redemption is unpaused\\n  uint8 statusReentrant; // If call is reentrant or not\\n  bool consumingSchedule; // If the contract is consuming a scheduled operation\\n  uint128 normalizedStables; // Normalized amount of stablecoins issued by the system\\n  uint128 normalizer; // To reconcile `normalizedStables` values with the actual amount\\n  address[] collateralList; // List of collateral assets supported by the system\\n  uint64[] xRedemptionCurve; // Increasing collateral ratios > 0\\n  int64[] yRedemptionCurve; // Value of the redemption fees at `xRedemptionCurve`\\n  mapping(address => Collateral) collaterals; // Maps a collateral asset to its parameters\\n  mapping(address => uint256) isTrusted; // If an address is trusted to update the normalizer value\\n  mapping(address => uint256) isSellerTrusted; // If an address is trusted to sell accruing reward tokens or to run\\n    // keeper jobs on oracles\\n  mapping(WhitelistType => mapping(address => uint256)) isWhitelistedForType;\\n}\\n// Whether an address is whitelisted for a specific whitelist type\\n\",\"keccak256\":\"0x3f4313dd110dbe390038320b2d3cf24dcbe9b75cd9573e7f048f7233c02dd227\",\"license\":\"BUSL-1.1\"},\"project/contracts/utils/AccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { AuthorityUtils } from \\\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { IAccessManaged } from \\\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\\\";\\nimport { Context } from \\\"@openzeppelin/contracts/utils/Context.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\n/// @title AccessControl\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Fork of OpenZeppelin's `AccessManaged` contract\\n/// updated to make _checkCanCall to return bool\\n/// https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/manager/AccessManaged.sol\\ncontract AccessManaged is Context, IAccessManaged {\\n  address private _authority;\\n\\n  bool private _consumingSchedule;\\n\\n  /**\\n   * @dev Initializes the contract connected to an initial authority.\\n   */\\n  constructor(address initialAuthority) {\\n    _setAuthority(initialAuthority);\\n  }\\n\\n  /**\\n   * @dev Restricts access to a function as defined by the connected Authority for this contract and the\\n   * caller and selector of the function that entered the contract.\\n   *\\n   * [IMPORTANT]\\n   * ====\\n   * In general, this modifier should only be used on `external` functions. It is okay to use it on `public`\\n   * functions that are used as external entry points and are not called internally. Unless you know what you're\\n   * doing, it should never be used on `internal` functions. Failure to follow these rules can have critical security\\n   * implications! This is because the permissions are determined by the function that entered the contract, i.e. the\\n   * function at the bottom of the call stack, and not the function where the modifier is visible in the source code.\\n   * ====\\n   *\\n   * [WARNING]\\n   * ====\\n   * Avoid adding this modifier to the\\n   * https://docs.soliditylang.org/en/v0.8.20/contracts.html#receive-ether-function[`receive()`]\\n   * function or the https://docs.soliditylang.org/en/v0.8.20/contracts.html#fallback-function[`fallback()`]. These\\n   * functions are the only execution paths where a function selector cannot be unambiguously determined from the\\n   * calldata\\n   * since the selector defaults to `0x00000000` in the `receive()` function and similarly in the `fallback()`\\n   * function\\n   * if no calldata is provided. (See {_checkCanCall}).\\n   *\\n   * The `receive()` function will always panic whereas the `fallback()` may panic depending on the calldata length.\\n   * ====\\n   */\\n  modifier restricted() {\\n    address caller = _msgSender();\\n    require(_checkCanCall(caller, _msgData()), AccessManagedUnauthorized(caller));\\n    _;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function authority() public view virtual returns (address) {\\n    return _authority;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function setAuthority(address newAuthority) public virtual {\\n    address caller = _msgSender();\\n    if (caller != authority()) {\\n      revert AccessManagedUnauthorized(caller);\\n    }\\n    if (newAuthority.code.length == 0) {\\n      revert AccessManagedInvalidAuthority(newAuthority);\\n    }\\n    _setAuthority(newAuthority);\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function isConsumingScheduledOp() public view returns (bytes4) {\\n    return _consumingSchedule ? this.isConsumingScheduledOp.selector : bytes4(0);\\n  }\\n\\n  /**\\n   * @dev Transfers control to a new authority. Internal function with no access restriction. Allows bypassing the\\n   * permissions set by the current authority.\\n   */\\n  function _setAuthority(address newAuthority) internal virtual {\\n    _authority = newAuthority;\\n    emit AuthorityUpdated(newAuthority);\\n  }\\n\\n  function _checkCanCall(address caller, bytes calldata data) internal virtual returns (bool) {\\n    (bool immediate, uint32 delay) =\\n      AuthorityUtils.canCallWithDelay(authority(), caller, address(this), bytes4(data[0:4]));\\n    if (!immediate) {\\n      if (delay > 0) {\\n        _consumingSchedule = true;\\n        IAccessManager(authority()).consumeScheduledOp(caller, data);\\n        _consumingSchedule = false;\\n      } else {\\n        return false;\\n      }\\n    }\\n    return true;\\n  }\\n}\\n\",\"keccak256\":\"0x40dfee0e736695b3005df6c150a2d794ac06f3f4b91745e2959623e770044798\",\"license\":\"BUSL-1.1\"},\"project/contracts/utils/Errors.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nerror AccessManagedUnauthorized(address caller);\\nerror AlreadyAdded();\\nerror CannotAddFunctionToDiamondThatAlreadyExists(bytes4 _selector);\\nerror CannotAddSelectorsToZeroAddress(bytes4[] _selectors);\\nerror CannotRemoveFunctionThatDoesNotExist(bytes4 _selector);\\nerror CannotRemoveImmutableFunction(bytes4 _selector);\\nerror CannotReplaceFunctionsFromFacetWithZeroAddress(bytes4[] _selectors);\\nerror CannotReplaceFunctionThatDoesNotExists(bytes4 _selector);\\nerror CannotReplaceFunctionWithTheSameFunctionFromTheSameFacet(bytes4 _selector);\\nerror CannotReplaceImmutableFunction(bytes4 _selector);\\nerror ContractHasNoCode();\\nerror CollateralBacked();\\nerror FunctionNotFound(bytes4 _functionSelector);\\nerror IncorrectFacetCutAction(uint8 _action);\\nerror InitializationFunctionReverted(address _initializationContractAddress, bytes _calldata);\\nerror InvalidChainlinkRate();\\nerror InvalidLengths();\\nerror InvalidNegativeFees();\\nerror InvalidOracleType();\\nerror InvalidParam();\\nerror InvalidParams();\\nerror InvalidRate();\\nerror InvalidSwap();\\nerror InvalidTokens();\\nerror InvalidAccessManager();\\nerror ManagerHasAssets();\\nerror NoSelectorsProvidedForFacetForCut(address _facetAddress);\\nerror NotAllowed();\\nerror NotCollateral();\\nerror NotGovernor();\\nerror NotGuardian();\\nerror NotTrusted();\\nerror NotTrustedOrGuardian();\\nerror NotWhitelisted();\\nerror OdosSwapFailed();\\nerror OracleUpdateFailed();\\nerror Paused();\\nerror ReentrantCall();\\nerror RemoveFacetAddressMustBeZeroAddress(address _facetAddress);\\nerror TooBigAmountIn();\\nerror TooLate();\\nerror TooSmallAmountOut();\\nerror ZeroAddress();\\nerror ZeroAmount();\\nerror SwapError();\\nerror SlippageTooHigh();\\nerror InsufficientFunds();\\n\",\"keccak256\":\"0x1e2f6812ef78e948e5155d32213b52afff8c0ba5463d18bee10694efbf886130\",\"license\":\"BUSL-1.1\"},\"project/libs/helpers/RouterSwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\n/// @title Swapper\\n/// @author Angle Labs, Inc.\\n/// @dev Abstract contract for swapping tokens using a router/aggregator\\n/// @dev This contract is an authorized fork of Angle's `RouterSwapper` contract\\n/// https://github.com/AngleProtocol/utils/blob/main/src/RouterSwapper.sol\\nabstract contract RouterSwapper {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               ERRORS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  error SwapError();\\n  error ZeroAddress();\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                EVENTS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   *  @notice Event emitted when the swap router is updated\\n   */\\n  event SwapRouterUpdated(address newSwapRouter);\\n  /**\\n   *  @notice Event emitted when the token proxy is updated\\n   */\\n  event TokenTransferAddressUpdated(address newTokenTransferAddress);\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                MODIFIERS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  modifier noZeroAddress(address targetAddress) {\\n    if (targetAddress == address(0)) {\\n      revert ZeroAddress();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                            MUTABLE VARIABLES\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice address of the router/aggregator\\n   */\\n  address public swapRouter;\\n  /**\\n   * @notice address to approve to transfer tokens to\\n   */\\n  address public tokenTransferAddress;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               CONSTRUCTOR\\n    //////////////////////////////////////////////////////////////*/\\n\\n  constructor(address initialSwapRouter, address initialTokenTransferAddress) {\\n    swapRouter = initialSwapRouter;\\n    tokenTransferAddress = initialTokenTransferAddress;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             ADMIN FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the router/aggregator address\\n   * @param newSwapRouter address of the new router/aggregator\\n   */\\n  function setSwapRouter(address newSwapRouter) public virtual noZeroAddress(newSwapRouter) {\\n    swapRouter = newSwapRouter;\\n\\n    emit SwapRouterUpdated(newSwapRouter);\\n  }\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the new token transfer address\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress)\\n    public\\n    virtual\\n    noZeroAddress(newTokenTransferAddress)\\n  {\\n    tokenTransferAddress = newTokenTransferAddress;\\n\\n    emit TokenTransferAddressUpdated(newTokenTransferAddress);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             SWAP FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Approve the router/aggregator to spend the token if needed\\n   * @param token address of the token to approve\\n   * @param spender address of the router/aggregator\\n   * @param amount amount to approve\\n   */\\n  function _approveTokenIfNeeded(address token, address spender, uint256 amount) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), spender);\\n    if (allowance < amount) {\\n      IERC20(token).safeIncreaseAllowance(spender, amount - allowance);\\n    }\\n  }\\n\\n  /**\\n   * @notice Perform the swap using the router/aggregator\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _performRouterSwap(bytes memory callData) internal {\\n    (bool success, bytes memory retData) = swapRouter.call(callData);\\n\\n    if (!success) {\\n      if (retData.length != 0) {\\n        assembly (\\\"memory-safe\\\") {\\n          revert(add(32, retData), mload(retData))\\n        }\\n      }\\n      revert SwapError();\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swapCalldata(address[] calldata tokens, bytes[] calldata callDatas, uint256[] calldata amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swap(address[] memory tokens, bytes[] memory callDatas, uint256[] memory amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x8c5a6b026a95816806814ef681b6b225ea4c405a39a4eab0111921853202829c\",\"license\":\"GPL-3.0\"}},\"version\":1}",
-  "storageLayout": {
-    "storage": [
-      {
-        "astId": 22488,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_authority",
-        "offset": 0,
-        "slot": "0",
-        "type": "t_address"
-      },
-      {
-        "astId": 22490,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_consumingSchedule",
-        "offset": 20,
-        "slot": "0",
-        "type": "t_bool"
-      },
-      {
-        "astId": 7716,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "maxTokenSlippage",
-        "offset": 0,
-        "slot": "1",
-        "type": "t_mapping(t_address,t_uint96)"
-      },
-      {
-        "astId": 7722,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "yieldBearingData",
-        "offset": 0,
-        "slot": "2",
-        "type": "t_mapping(t_address,t_struct(YieldBearingParams)7657_storage)"
-      },
-      {
-        "astId": 7727,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "isTrusted",
-        "offset": 0,
-        "slot": "3",
-        "type": "t_mapping(t_address,t_bool)"
-      },
-      {
-        "astId": 23206,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "swapRouter",
-        "offset": 0,
-        "slot": "4",
-        "type": "t_address"
-      },
-      {
-        "astId": 23209,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "tokenTransferAddress",
-        "offset": 0,
-        "slot": "5",
-        "type": "t_address"
-      },
-      {
-        "astId": 8443,
-        "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "budget",
-        "offset": 0,
-        "slot": "6",
-        "type": "t_mapping(t_address,t_uint256)"
-      }
-    ],
-    "types": {
-      "t_address": {
-        "encoding": "inplace",
-        "label": "address",
-        "numberOfBytes": "20"
-      },
-      "t_bool": {
-        "encoding": "inplace",
-        "label": "bool",
-        "numberOfBytes": "1"
-      },
-      "t_mapping(t_address,t_bool)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => bool)",
-        "numberOfBytes": "32",
-        "value": "t_bool"
-      },
-      "t_mapping(t_address,t_struct(YieldBearingParams)7657_storage)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => struct YieldBearingParams)",
-        "numberOfBytes": "32",
-        "value": "t_struct(YieldBearingParams)7657_storage"
-      },
-      "t_mapping(t_address,t_uint256)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint256)",
-        "numberOfBytes": "32",
-        "value": "t_uint256"
-      },
-      "t_mapping(t_address,t_uint96)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint96)",
-        "numberOfBytes": "32",
-        "value": "t_uint96"
-      },
-      "t_struct(YieldBearingParams)7657_storage": {
-        "encoding": "inplace",
-        "label": "struct YieldBearingParams",
-        "members": [
-          {
-            "astId": 7646,
-            "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "asset",
-            "offset": 0,
-            "slot": "0",
-            "type": "t_address"
-          },
-          {
-            "astId": 7648,
-            "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "targetExposure",
-            "offset": 20,
-            "slot": "0",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 7650,
-            "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxExposure",
-            "offset": 0,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 7652,
-            "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "minExposure",
-            "offset": 8,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 7654,
-            "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "overrideExposures",
-            "offset": 16,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 7656,
-            "contract": "project/contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxSlippage",
-            "offset": 0,
-            "slot": "2",
-            "type": "t_uint96"
-          }
-        ],
-        "numberOfBytes": "96"
-      },
-      "t_uint256": {
-        "encoding": "inplace",
-        "label": "uint256",
-        "numberOfBytes": "32"
-      },
-      "t_uint64": {
-        "encoding": "inplace",
-        "label": "uint64",
-        "numberOfBytes": "8"
-      },
-      "t_uint96": {
-        "encoding": "inplace",
-        "label": "uint96",
-        "numberOfBytes": "12"
-      }
-    }
-  },
-  "userdoc": {
-    "events": {
-      "SwapRouterUpdated(address)": {
-        "notice": "Event emitted when the swap router is updated"
-      },
-      "TokenTransferAddressUpdated(address)": {
-        "notice": "Event emitted when the token proxy is updated"
-      }
-    },
-    "kind": "user",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "notice": "Add budget to be spent by the receiver during the flashloan"
-      },
-      "budget(address)": {
-        "notice": "Budget of tokenP available for each users"
-      },
-      "computeRebalanceAmount(address)": {
-        "notice": "Compute the amount needed to rebalance the Parallelizer"
-      },
-      "flashloan()": {
-        "notice": "Parallel stablecoin flashloan contract"
-      },
-      "harvest(address,uint256,bytes)": {
-        "notice": "Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset"
-      },
-      "isTrusted(address)": {
-        "notice": "trusted addresses that can update target exposure and do others non critical operations"
-      },
-      "maxTokenSlippage(address)": {
-        "notice": "Max slippage when dealing with the Parallelizer"
-      },
-      "parallelizer()": {
-        "notice": "Reference to the `parallelizer` implementation this contract aims at rebalancing"
-      },
-      "recoverERC20(address,uint256,address)": {
-        "notice": "Recover ERC20 tokens"
-      },
-      "removeBudget(uint256,address)": {
-        "notice": "Remove budget from the owner and send it to the receiver"
-      },
-      "setMaxSlippage(address,uint96)": {
-        "notice": "Set the max allowed slippage"
-      },
-      "setSwapRouter(address)": {
-        "notice": "Set the swap router"
-      },
-      "setTargetExposure(address,uint64)": {
-        "notice": "Set the target exposure of a yield bearing asset"
-      },
-      "setTokenTransferAddress(address)": {
-        "notice": "Set the token transfer address"
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "notice": "Set the yieldBearingAsset data"
-      },
-      "swapRouter()": {
-        "notice": "address of the router/aggregator"
-      },
-      "toggleTrusted(address)": {
-        "notice": "Toggle the trusted status of an address"
-      },
-      "tokenP()": {
-        "notice": "TokenP handled by the `parallelizer` of interest"
-      },
-      "tokenTransferAddress()": {
-        "notice": "address to approve to transfer tokens to"
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "notice": "Set the limit exposures to the asset linked to the yield bearing asset"
-      },
-      "yieldBearingData(address)": {
-        "notice": "Data associated to a yield bearing asset"
-      }
-    },
-    "version": 1
-  },
-  "argsData": "0x00000000000000000000000088de50b233052e4fb783d4f6db78cc34fea3e9fc00000000000000000000000088de50b233052e4fb783d4f6db78cc34fea3e9fc0000000000000000000000009ee1963f05553ef838604dd39403be21cef26aa400000000000000000000000041d58951cbd12d4ef49b0437897677bbf5547c80000000000000000000000000fd28f108e95f4d41daae9dbfff707d677985998e0000000000000000000000009e0dcf7a33bbde6689560c5c807dd2a3df991277",
-  "transaction": {
-    "hash": "0xf9fdb881ae9b14af38626a6adee579e13a3946b210c7409a354a6d8751eec211",
-    "nonce": "0x78",
-    "origin": "0x66ccec236bbce5f1bbd1b2fc0a4014e57a55ad02"
-  },
-  "receipt": {
-    "blockHash": "0x77da7b9248dabc067ce7019a829d0e178c0d3f299517d26e64d65280050d51a4",
-    "blockNumber": "0x4104093",
-    "transactionIndex": "0x7"
-  }
-}
\ No newline at end of file
diff --git a/deployments/base/GenericHarvester_USDp.json b/deployments/base/GenericHarvester_USDp.json
deleted file mode 100644
index 59dcfa2..0000000
--- a/deployments/base/GenericHarvester_USDp.json
+++ /dev/null
@@ -1,1124 +0,0 @@
-{
-  "address": "0xCa43eCFCDFBA1fED003649e946Ae6091646B410a",
-  "abi": [
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initialTokenTransferAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialSwapRouter",
-          "type": "address"
-        },
-        {
-          "internalType": "contract ITokenP",
-          "name": "definitivetokenP",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IParallelizer",
-          "name": "definitiveParallelizer",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialAuthority",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "definitiveFlashloan",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "constructor"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedInvalidAuthority",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        },
-        {
-          "internalType": "uint32",
-          "name": "delay",
-          "type": "uint32"
-        }
-      ],
-      "name": "AccessManagedRequiredDelay",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedUnauthorized",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "InvalidParam",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrusted",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrustedOrGuardian",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        }
-      ],
-      "name": "SafeERC20FailedOperation",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "SwapError",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAddress",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAmount",
-      "type": "error"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AuthorityUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "Recovered",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "SwapRouterUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "TokenTransferAddressUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "bool",
-          "name": "status",
-          "type": "bool"
-        }
-      ],
-      "name": "TrustedToggled",
-      "type": "event"
-    },
-    {
-      "inputs": [],
-      "name": "CALLBACK_SUCCESS",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "addBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "authority",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "budget",
-      "outputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "computeRebalanceAmount",
-      "outputs": [
-        {
-          "internalType": "uint8",
-          "name": "increase",
-          "type": "uint8"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "flashloan",
-      "outputs": [
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "scale",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "extraData",
-          "type": "bytes"
-        }
-      ],
-      "name": "harvest",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "isConsumingScheduledOp",
-      "outputs": [
-        {
-          "internalType": "bytes4",
-          "name": "",
-          "type": "bytes4"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "isTrusted",
-      "outputs": [
-        {
-          "internalType": "bool",
-          "name": "",
-          "type": "bool"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "maxTokenSlippage",
-      "outputs": [
-        {
-          "internalType": "uint96",
-          "name": "",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initiator",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "uint256",
-          "name": "fee",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "data",
-          "type": "bytes"
-        }
-      ],
-      "name": "onFlashLoan",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "parallelizer",
-      "outputs": [
-        {
-          "internalType": "contract IParallelizer",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "tokenAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amountToRecover",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "recoverERC20",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "removeBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newAuthority",
-          "type": "address"
-        }
-      ],
-      "name": "setAuthority",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint96",
-          "name": "newMaxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setMaxSlippage",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "setSwapRouter",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        }
-      ],
-      "name": "setTargetExposure",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "setTokenTransferAddress",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setYieldBearingAssetData",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "swapRouter",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        }
-      ],
-      "name": "toggleTrusted",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenP",
-      "outputs": [
-        {
-          "internalType": "contract ITokenP",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenTransferAddress",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "updateLimitExposuresYieldAsset",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "yieldBearingData",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    }
-  ],
-  "transactionHash": "0x9a88645c33c969e68e41437d785b884db2c9e783597a09c2a7fd4f173749fcef",
-  "receipt": {
-    "to": null,
-    "from": "0x66CcEC236bbcE5f1bBd1b2fC0a4014e57A55ad02",
-    "contractAddress": "0xCa43eCFCDFBA1fED003649e946Ae6091646B410a",
-    "transactionIndex": 51,
-    "gasUsed": "2210613",
-    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000040000000000000200000000000000000000010000000000000000000000000200000000000000000000000100400000000000000000000000000000000000000000000100000100000000000000000000000000000000000000000000000000000000000000100000000000000000000000008000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000010000000010000000000000000008000000000004000000000000000000001000000010",
-    "blockHash": "0x1d4aa3216f7e53cae7dd2878a8a75262c1a2e0cf151a774a5bf9f18fcdfdb9de",
-    "transactionHash": "0x9a88645c33c969e68e41437d785b884db2c9e783597a09c2a7fd4f173749fcef",
-    "logs": [
-      {
-        "transactionIndex": 51,
-        "blockNumber": 31946047,
-        "transactionHash": "0x9a88645c33c969e68e41437d785b884db2c9e783597a09c2a7fd4f173749fcef",
-        "address": "0xCa43eCFCDFBA1fED003649e946Ae6091646B410a",
-        "topics": [
-          "0x2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad"
-        ],
-        "data": "0x0000000000000000000000000e4e7ca9d7b1e6293d0713efefb4bca010debf46",
-        "logIndex": 213,
-        "blockHash": "0x1d4aa3216f7e53cae7dd2878a8a75262c1a2e0cf151a774a5bf9f18fcdfdb9de"
-      },
-      {
-        "transactionIndex": 51,
-        "blockNumber": 31946047,
-        "transactionHash": "0x9a88645c33c969e68e41437d785b884db2c9e783597a09c2a7fd4f173749fcef",
-        "address": "0x76A9A0062ec6712b99B4f63bD2b4270185759dd5",
-        "topics": [
-          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
-          "0x000000000000000000000000ca43ecfcdfba1fed003649e946ae6091646b410a",
-          "0x00000000000000000000000008417cdb7f52a5021bb4eb6e0deaf3f295c3f182"
-        ],
-        "data": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
-        "logIndex": 214,
-        "blockHash": "0x1d4aa3216f7e53cae7dd2878a8a75262c1a2e0cf151a774a5bf9f18fcdfdb9de"
-      }
-    ],
-    "blockNumber": 31946047,
-    "cumulativeGasUsed": "17679273",
-    "status": 1,
-    "byzantium": true
-  },
-  "args": [
-    "0x19ceead7105607cd444f5ad10dd51356436095a1",
-    "0x19ceead7105607cd444f5ad10dd51356436095a1",
-    "0x76A9A0062ec6712b99B4f63bD2b4270185759dd5",
-    "0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD",
-    "0x0e4e7Ca9D7b1e6293D0713EFEfB4BCA010DeBF46",
-    "0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182"
-  ],
-  "numDeployments": 1,
-  "solcInputHash": "9e6800737641b3b015331b65b5c620c3",
-  "metadata": "{\"compiler\":{\"version\":\"0.8.28+commit.7893614a\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initialTokenTransferAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialSwapRouter\",\"type\":\"address\"},{\"internalType\":\"contract ITokenP\",\"name\":\"definitivetokenP\",\"type\":\"address\"},{\"internalType\":\"contract IParallelizer\",\"name\":\"definitiveParallelizer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialAuthority\",\"type\":\"address\"},{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"definitiveFlashloan\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AccessManagedInvalidAuthority\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"delay\",\"type\":\"uint32\"}],\"name\":\"AccessManagedRequiredDelay\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"AccessManagedUnauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidParam\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrusted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrustedOrGuardian\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"SafeERC20FailedOperation\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"SwapError\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAmount\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AuthorityUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"Recovered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"SwapRouterUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"TokenTransferAddressUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"status\",\"type\":\"bool\"}],\"name\":\"TrustedToggled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"CALLBACK_SUCCESS\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"addBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"budget\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"computeRebalanceAmount\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"increase\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"flashloan\",\"outputs\":[{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"scale\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"extraData\",\"type\":\"bytes\"}],\"name\":\"harvest\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isConsumingScheduledOp\",\"outputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"isTrusted\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"maxTokenSlippage\",\"outputs\":[{\"internalType\":\"uint96\",\"name\":\"\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initiator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"fee\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"onFlashLoan\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"parallelizer\",\"outputs\":[{\"internalType\":\"contract IParallelizer\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amountToRecover\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"recoverERC20\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"removeBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAuthority\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint96\",\"name\":\"newMaxSlippage\",\"type\":\"uint96\"}],\"name\":\"setMaxSlippage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"setSwapRouter\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"}],\"name\":\"setTargetExposure\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"setTokenTransferAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"name\":\"setYieldBearingAssetData\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"swapRouter\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"}],\"name\":\"toggleTrusted\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenP\",\"outputs\":[{\"internalType\":\"contract ITokenP\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenTransferAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"updateLimitExposuresYieldAsset\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"yieldBearingData\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Cooper Labs\",\"custom:contact\":\"security@cooperlabs.xyz\",\"details\":\"Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\",\"errors\":{\"SafeERC20FailedOperation(address)\":[{\"details\":\"An operation with an ERC-20 token failed.\"}]},\"events\":{\"AuthorityUpdated(address)\":{\"details\":\"Authority that manages this contract was updated.\"}},\"kind\":\"dev\",\"methods\":{\"addBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to add to the budget\",\"receiver\":\"address of the receiver\"}},\"authority()\":{\"details\":\"Returns the current authority.\"},\"computeRebalanceAmount(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"},\"returns\":{\"amount\":\"amount to be rebalanced\",\"increase\":\"whether the exposure should be increased\"}},\"harvest(address,uint256,bytes)\":{\"details\":\"This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage\"},\"isConsumingScheduledOp()\":{\"details\":\"Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls.\"},\"onFlashLoan(address,address,uint256,uint256,bytes)\":{\"details\":\"Receive a flash loan.\",\"params\":{\"amount\":\"The amount of tokens lent.\",\"data\":\"Arbitrary data structure, intended to contain user-defined parameters.\",\"fee\":\"The additional amount of tokens to repay.\",\"initiator\":\"The initiator of the loan.\",\"token\":\"The loan currency.\"},\"returns\":{\"_0\":\"The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\"}},\"recoverERC20(address,uint256,address)\":{\"params\":{\"amountToRecover\":\"amount to recover\",\"to\":\"address to send the recovered tokens\",\"tokenAddress\":\"address of the token to recover\"}},\"removeBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to remove from the budget\",\"receiver\":\"address of the receiver\"}},\"setAuthority(address)\":{\"details\":\"Transfers control to a new authority. The caller must be the current authority.\"},\"setMaxSlippage(address,uint96)\":{\"params\":{\"newMaxSlippage\":\"new max allowed slippage\"}},\"setSwapRouter(address)\":{\"params\":{\"newSwapRouter\":\"address of the swap router\"}},\"setTargetExposure(address,uint64)\":{\"params\":{\"targetExposure\":\"target exposure to the yield bearing asset used\",\"yieldBearingAsset\":\"address of the yield bearing asset\"}},\"setTokenTransferAddress(address)\":{\"params\":{\"newTokenTransferAddress\":\"address of the token transfer contract\"}},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"params\":{\"asset\":\"address of the asset\",\"maxExposure\":\"maximum exposure within the Parallelizer to the asset\",\"minExposure\":\"minimum exposure within the Parallelizer to the asset\",\"overrideExposures\":\"whether limit exposures should be overriden or read onchain through the Parallelizer\",\"targetExposure\":\"target exposure to the yieldBearingAsset asset used\",\"yieldBearingAsset\":\"address of the yieldBearingAsset\"}},\"toggleTrusted(address)\":{\"params\":{\"trusted\":\"address to toggle the trusted status\"}},\"updateLimitExposuresYieldAsset(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"}}},\"title\":\"GenericHarvester\",\"version\":1},\"userdoc\":{\"events\":{\"SwapRouterUpdated(address)\":{\"notice\":\"Event emitted when the swap router is updated\"},\"TokenTransferAddressUpdated(address)\":{\"notice\":\"Event emitted when the token proxy is updated\"}},\"kind\":\"user\",\"methods\":{\"addBudget(uint256,address)\":{\"notice\":\"Add budget to be spent by the receiver during the flashloan\"},\"budget(address)\":{\"notice\":\"Budget of tokenP available for each users\"},\"computeRebalanceAmount(address)\":{\"notice\":\"Compute the amount needed to rebalance the Parallelizer\"},\"flashloan()\":{\"notice\":\"Parallel stablecoin flashloan contract\"},\"harvest(address,uint256,bytes)\":{\"notice\":\"Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset\"},\"isTrusted(address)\":{\"notice\":\"trusted addresses that can update target exposure and do others non critical operations\"},\"maxTokenSlippage(address)\":{\"notice\":\"Max slippage when dealing with the Parallelizer\"},\"parallelizer()\":{\"notice\":\"Reference to the `parallelizer` implementation this contract aims at rebalancing\"},\"recoverERC20(address,uint256,address)\":{\"notice\":\"Recover ERC20 tokens\"},\"removeBudget(uint256,address)\":{\"notice\":\"Remove budget from the owner and send it to the receiver\"},\"setMaxSlippage(address,uint96)\":{\"notice\":\"Set the max allowed slippage\"},\"setSwapRouter(address)\":{\"notice\":\"Set the swap router\"},\"setTargetExposure(address,uint64)\":{\"notice\":\"Set the target exposure of a yield bearing asset\"},\"setTokenTransferAddress(address)\":{\"notice\":\"Set the token transfer address\"},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"notice\":\"Set the yieldBearingAsset data\"},\"swapRouter()\":{\"notice\":\"address of the router/aggregator\"},\"toggleTrusted(address)\":{\"notice\":\"Toggle the trusted status of an address\"},\"tokenP()\":{\"notice\":\"TokenP handled by the `parallelizer` of interest\"},\"tokenTransferAddress()\":{\"notice\":\"address to approve to transfer tokens to\"},\"updateLimitExposuresYieldAsset(address)\":{\"notice\":\"Set the limit exposures to the asset linked to the yield bearing asset\"},\"yieldBearingData(address)\":{\"notice\":\"Data associated to a yield bearing asset\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/helpers/GenericHarvester.sol\":\"GenericHarvester\"},\"evmVersion\":\"cancun\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@helpers/RouterSwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\n/// @title Swapper\\n/// @author Angle Labs, Inc.\\n/// @dev Abstract contract for swapping tokens using a router/aggregator\\n/// @dev This contract is an authorized fork of Angle's `RouterSwapper` contract\\n/// https://github.com/AngleProtocol/utils/blob/main/src/RouterSwapper.sol\\nabstract contract RouterSwapper {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               ERRORS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  error SwapError();\\n  error ZeroAddress();\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                EVENTS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   *  @notice Event emitted when the swap router is updated\\n   */\\n  event SwapRouterUpdated(address newSwapRouter);\\n  /**\\n   *  @notice Event emitted when the token proxy is updated\\n   */\\n  event TokenTransferAddressUpdated(address newTokenTransferAddress);\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                MODIFIERS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  modifier noZeroAddress(address targetAddress) {\\n    if (targetAddress == address(0)) {\\n      revert ZeroAddress();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                            MUTABLE VARIABLES\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice address of the router/aggregator\\n   */\\n  address public swapRouter;\\n  /**\\n   * @notice address to approve to transfer tokens to\\n   */\\n  address public tokenTransferAddress;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               CONSTRUCTOR\\n    //////////////////////////////////////////////////////////////*/\\n\\n  constructor(address initialSwapRouter, address initialTokenTransferAddress) {\\n    swapRouter = initialSwapRouter;\\n    tokenTransferAddress = initialTokenTransferAddress;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             ADMIN FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the router/aggregator address\\n   * @param newSwapRouter address of the new router/aggregator\\n   */\\n  function setSwapRouter(address newSwapRouter) public virtual noZeroAddress(newSwapRouter) {\\n    swapRouter = newSwapRouter;\\n\\n    emit SwapRouterUpdated(newSwapRouter);\\n  }\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the new token transfer address\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress)\\n    public\\n    virtual\\n    noZeroAddress(newTokenTransferAddress)\\n  {\\n    tokenTransferAddress = newTokenTransferAddress;\\n\\n    emit TokenTransferAddressUpdated(newTokenTransferAddress);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             SWAP FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Approve the router/aggregator to spend the token if needed\\n   * @param token address of the token to approve\\n   * @param spender address of the router/aggregator\\n   * @param amount amount to approve\\n   */\\n  function _approveTokenIfNeeded(address token, address spender, uint256 amount) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), spender);\\n    if (allowance < amount) {\\n      IERC20(token).safeIncreaseAllowance(spender, amount - allowance);\\n    }\\n  }\\n\\n  /**\\n   * @notice Perform the swap using the router/aggregator\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _performRouterSwap(bytes memory callData) internal {\\n    (bool success, bytes memory retData) = swapRouter.call(callData);\\n\\n    if (!success) {\\n      if (retData.length != 0) {\\n        assembly (\\\"memory-safe\\\") {\\n          revert(add(32, retData), mload(retData))\\n        }\\n      }\\n      revert SwapError();\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swapCalldata(address[] calldata tokens, bytes[] calldata callDatas, uint256[] calldata amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swap(address[] memory tokens, bytes[] memory callDatas, uint256[] memory amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x8c5a6b026a95816806814ef681b6b225ea4c405a39a4eab0111921853202829c\",\"license\":\"GPL-3.0\"},\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/AuthorityUtils.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IAuthority} from \\\"./IAuthority.sol\\\";\\n\\nlibrary AuthorityUtils {\\n    /**\\n     * @dev Since `AccessManager` implements an extended IAuthority interface, invoking `canCall` with backwards compatibility\\n     * for the preexisting `IAuthority` interface requires special care to avoid reverting on insufficient return data.\\n     * This helper function takes care of invoking `canCall` in a backwards compatible way without reverting.\\n     */\\n    function canCallWithDelay(\\n        address authority,\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) internal view returns (bool immediate, uint32 delay) {\\n        (bool success, bytes memory data) = authority.staticcall(\\n            abi.encodeCall(IAuthority.canCall, (caller, target, selector))\\n        );\\n        if (success) {\\n            if (data.length >= 0x40) {\\n                (immediate, delay) = abi.decode(data, (bool, uint32));\\n            } else if (data.length >= 0x20) {\\n                immediate = abi.decode(data, (bool));\\n            }\\n        }\\n        return (immediate, delay);\\n    }\\n}\\n\",\"keccak256\":\"0xb3875997b0d8705e29aa20fee88e1dfef93df438794ae1ad8ba2eb016a4dd4e4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAccessManaged.sol)\\n\\npragma solidity ^0.8.20;\\n\\ninterface IAccessManaged {\\n    /**\\n     * @dev Authority that manages this contract was updated.\\n     */\\n    event AuthorityUpdated(address authority);\\n\\n    error AccessManagedUnauthorized(address caller);\\n    error AccessManagedRequiredDelay(address caller, uint32 delay);\\n    error AccessManagedInvalidAuthority(address authority);\\n\\n    /**\\n     * @dev Returns the current authority.\\n     */\\n    function authority() external view returns (address);\\n\\n    /**\\n     * @dev Transfers control to a new authority. The caller must be the current authority.\\n     */\\n    function setAuthority(address) external;\\n\\n    /**\\n     * @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n     * being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n     * attacker controlled calls.\\n     */\\n    function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaba93d42cd70e1418782951132d97b31ddce5f50ad81090884b6d0e41caac9d6\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManager.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (access/manager/IAccessManager.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Time} from \\\"../../utils/types/Time.sol\\\";\\n\\ninterface IAccessManager {\\n    /**\\n     * @dev A delayed operation was scheduled.\\n     */\\n    event OperationScheduled(\\n        bytes32 indexed operationId,\\n        uint32 indexed nonce,\\n        uint48 schedule,\\n        address caller,\\n        address target,\\n        bytes data\\n    );\\n\\n    /**\\n     * @dev A scheduled operation was executed.\\n     */\\n    event OperationExecuted(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev A scheduled operation was canceled.\\n     */\\n    event OperationCanceled(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev Informational labelling for a roleId.\\n     */\\n    event RoleLabel(uint64 indexed roleId, string label);\\n\\n    /**\\n     * @dev Emitted when `account` is granted `roleId`.\\n     *\\n     * NOTE: The meaning of the `since` argument depends on the `newMember` argument.\\n     * If the role is granted to a new member, the `since` argument indicates when the account becomes a member of the role,\\n     * otherwise it indicates the execution delay for this account and roleId is updated.\\n     */\\n    event RoleGranted(uint64 indexed roleId, address indexed account, uint32 delay, uint48 since, bool newMember);\\n\\n    /**\\n     * @dev Emitted when `account` membership or `roleId` is revoked. Unlike granting, revoking is instantaneous.\\n     */\\n    event RoleRevoked(uint64 indexed roleId, address indexed account);\\n\\n    /**\\n     * @dev Role acting as admin over a given `roleId` is updated.\\n     */\\n    event RoleAdminChanged(uint64 indexed roleId, uint64 indexed admin);\\n\\n    /**\\n     * @dev Role acting as guardian over a given `roleId` is updated.\\n     */\\n    event RoleGuardianChanged(uint64 indexed roleId, uint64 indexed guardian);\\n\\n    /**\\n     * @dev Grant delay for a given `roleId` will be updated to `delay` when `since` is reached.\\n     */\\n    event RoleGrantDelayChanged(uint64 indexed roleId, uint32 delay, uint48 since);\\n\\n    /**\\n     * @dev Target mode is updated (true = closed, false = open).\\n     */\\n    event TargetClosed(address indexed target, bool closed);\\n\\n    /**\\n     * @dev Role required to invoke `selector` on `target` is updated to `roleId`.\\n     */\\n    event TargetFunctionRoleUpdated(address indexed target, bytes4 selector, uint64 indexed roleId);\\n\\n    /**\\n     * @dev Admin delay for a given `target` will be updated to `delay` when `since` is reached.\\n     */\\n    event TargetAdminDelayUpdated(address indexed target, uint32 delay, uint48 since);\\n\\n    error AccessManagerAlreadyScheduled(bytes32 operationId);\\n    error AccessManagerNotScheduled(bytes32 operationId);\\n    error AccessManagerNotReady(bytes32 operationId);\\n    error AccessManagerExpired(bytes32 operationId);\\n    error AccessManagerLockedRole(uint64 roleId);\\n    error AccessManagerBadConfirmation();\\n    error AccessManagerUnauthorizedAccount(address msgsender, uint64 roleId);\\n    error AccessManagerUnauthorizedCall(address caller, address target, bytes4 selector);\\n    error AccessManagerUnauthorizedConsume(address target);\\n    error AccessManagerUnauthorizedCancel(address msgsender, address caller, address target, bytes4 selector);\\n    error AccessManagerInvalidInitialAdmin(address initialAdmin);\\n\\n    /**\\n     * @dev Check if an address (`caller`) is authorised to call a given function on a given contract directly (with\\n     * no restriction). Additionally, it returns the delay needed to perform the call indirectly through the {schedule}\\n     * & {execute} workflow.\\n     *\\n     * This function is usually called by the targeted contract to control immediate execution of restricted functions.\\n     * Therefore we only return true if the call can be performed without any delay. If the call is subject to a\\n     * previously set delay (not zero), then the function should return false and the caller should schedule the operation\\n     * for future execution.\\n     *\\n     * If `immediate` is true, the delay can be disregarded and the operation can be immediately executed, otherwise\\n     * the operation can be executed if and only if delay is greater than 0.\\n     *\\n     * NOTE: The IAuthority interface does not include the `uint32` delay. This is an extension of that interface that\\n     * is backward compatible. Some contracts may thus ignore the second return argument. In that case they will fail\\n     * to identify the indirect workflow, and will consider calls that require a delay to be forbidden.\\n     *\\n     * NOTE: This function does not report the permissions of the admin functions in the manager itself. These are defined by the\\n     * {AccessManager} documentation.\\n     */\\n    function canCall(\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) external view returns (bool allowed, uint32 delay);\\n\\n    /**\\n     * @dev Expiration delay for scheduled proposals. Defaults to 1 week.\\n     *\\n     * IMPORTANT: Avoid overriding the expiration with 0. Otherwise every contract proposal will be expired immediately,\\n     * disabling any scheduling usage.\\n     */\\n    function expiration() external view returns (uint32);\\n\\n    /**\\n     * @dev Minimum setback for all delay updates, with the exception of execution delays. It\\n     * can be increased without setback (and reset via {revokeRole} in the case event of an\\n     * accidental increase). Defaults to 5 days.\\n     */\\n    function minSetback() external view returns (uint32);\\n\\n    /**\\n     * @dev Get whether the contract is closed disabling any access. Otherwise role permissions are applied.\\n     *\\n     * NOTE: When the manager itself is closed, admin functions are still accessible to avoid locking the contract.\\n     */\\n    function isTargetClosed(address target) external view returns (bool);\\n\\n    /**\\n     * @dev Get the role required to call a function.\\n     */\\n    function getTargetFunctionRole(address target, bytes4 selector) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the admin delay for a target contract. Changes to contract configuration are subject to this delay.\\n     */\\n    function getTargetAdminDelay(address target) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the id of the role that acts as an admin for the given role.\\n     *\\n     * The admin permission is required to grant the role, revoke the role and update the execution delay to execute\\n     * an operation that is restricted to this role.\\n     */\\n    function getRoleAdmin(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role that acts as a guardian for a given role.\\n     *\\n     * The guardian permission allows canceling operations that have been scheduled under the role.\\n     */\\n    function getRoleGuardian(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role current grant delay.\\n     *\\n     * Its value may change at any point without an event emitted following a call to {setGrantDelay}.\\n     * Changes to this value, including effect timepoint are notified in advance by the {RoleGrantDelayChanged} event.\\n     */\\n    function getRoleGrantDelay(uint64 roleId) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the access details for a given account for a given role. These details include the timepoint at which\\n     * membership becomes active, and the delay applied to all operation by this user that requires this permission\\n     * level.\\n     *\\n     * Returns:\\n     * [0] Timestamp at which the account membership becomes valid. 0 means role is not granted.\\n     * [1] Current execution delay for the account.\\n     * [2] Pending execution delay for the account.\\n     * [3] Timestamp at which the pending execution delay will become active. 0 means no delay update is scheduled.\\n     */\\n    function getAccess(\\n        uint64 roleId,\\n        address account\\n    ) external view returns (uint48 since, uint32 currentDelay, uint32 pendingDelay, uint48 effect);\\n\\n    /**\\n     * @dev Check if a given account currently has the permission level corresponding to a given role. Note that this\\n     * permission might be associated with an execution delay. {getAccess} can provide more details.\\n     */\\n    function hasRole(uint64 roleId, address account) external view returns (bool isMember, uint32 executionDelay);\\n\\n    /**\\n     * @dev Give a label to a role, for improved role discoverability by UIs.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleLabel} event.\\n     */\\n    function labelRole(uint64 roleId, string calldata label) external;\\n\\n    /**\\n     * @dev Add `account` to `roleId`, or change its execution delay.\\n     *\\n     * This gives the account the authorization to call any function that is restricted to this role. An optional\\n     * execution delay (in seconds) can be set. If that delay is non 0, the user is required to schedule any operation\\n     * that is restricted to members of this role. The user will only be able to execute the operation after the delay has\\n     * passed, before it has expired. During this period, admin and guardians can cancel the operation (see {cancel}).\\n     *\\n     * If the account has already been granted this role, the execution delay will be updated. This update is not\\n     * immediate and follows the delay rules. For example, if a user currently has a delay of 3 hours, and this is\\n     * called to reduce that delay to 1 hour, the new delay will take some time to take effect, enforcing that any\\n     * operation executed in the 3 hours that follows this update was indeed scheduled before this update.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - granted role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleGranted} event.\\n     */\\n    function grantRole(uint64 roleId, address account, uint32 executionDelay) external;\\n\\n    /**\\n     * @dev Remove an account from a role, with immediate effect. If the account does not have the role, this call has\\n     * no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - revoked role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function revokeRole(uint64 roleId, address account) external;\\n\\n    /**\\n     * @dev Renounce role permissions for the calling account with immediate effect. If the sender is not in\\n     * the role this call has no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be `callerConfirmation`.\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function renounceRole(uint64 roleId, address callerConfirmation) external;\\n\\n    /**\\n     * @dev Change admin role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleAdminChanged} event\\n     */\\n    function setRoleAdmin(uint64 roleId, uint64 admin) external;\\n\\n    /**\\n     * @dev Change guardian role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGuardianChanged} event\\n     */\\n    function setRoleGuardian(uint64 roleId, uint64 guardian) external;\\n\\n    /**\\n     * @dev Update the delay for granting a `roleId`.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGrantDelayChanged} event.\\n     */\\n    function setGrantDelay(uint64 roleId, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the role required to call functions identified by the `selectors` in the `target` contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetFunctionRoleUpdated} event per selector.\\n     */\\n    function setTargetFunctionRole(address target, bytes4[] calldata selectors, uint64 roleId) external;\\n\\n    /**\\n     * @dev Set the delay for changing the configuration of a given target contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetAdminDelayUpdated} event.\\n     */\\n    function setTargetAdminDelay(address target, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the closed flag for a contract.\\n     *\\n     * Closing the manager itself won't disable access to admin methods to avoid locking the contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetClosed} event.\\n     */\\n    function setTargetClosed(address target, bool closed) external;\\n\\n    /**\\n     * @dev Return the timepoint at which a scheduled operation will be ready for execution. This returns 0 if the\\n     * operation is not yet scheduled, has expired, was executed, or was canceled.\\n     */\\n    function getSchedule(bytes32 id) external view returns (uint48);\\n\\n    /**\\n     * @dev Return the nonce for the latest scheduled operation with a given id. Returns 0 if the operation has never\\n     * been scheduled.\\n     */\\n    function getNonce(bytes32 id) external view returns (uint32);\\n\\n    /**\\n     * @dev Schedule a delayed operation for future execution, and return the operation identifier. It is possible to\\n     * choose the timestamp at which the operation becomes executable as long as it satisfies the execution delays\\n     * required for the caller. The special value zero will automatically set the earliest possible time.\\n     *\\n     * Returns the `operationId` that was scheduled. Since this value is a hash of the parameters, it can reoccur when\\n     * the same parameters are used; if this is relevant, the returned `nonce` can be used to uniquely identify this\\n     * scheduled operation from other occurrences of the same `operationId` in invocations of {execute} and {cancel}.\\n     *\\n     * Emits a {OperationScheduled} event.\\n     *\\n     * NOTE: It is not possible to concurrently schedule more than one operation with the same `target` and `data`. If\\n     * this is necessary, a random byte can be appended to `data` to act as a salt that will be ignored by the target\\n     * contract if it is using standard Solidity ABI encoding.\\n     */\\n    function schedule(\\n        address target,\\n        bytes calldata data,\\n        uint48 when\\n    ) external returns (bytes32 operationId, uint32 nonce);\\n\\n    /**\\n     * @dev Execute a function that is delay restricted, provided it was properly scheduled beforehand, or the\\n     * execution delay is 0.\\n     *\\n     * Returns the nonce that identifies the previously scheduled operation that is executed, or 0 if the\\n     * operation wasn't previously scheduled (if the caller doesn't have an execution delay).\\n     *\\n     * Emits an {OperationExecuted} event only if the call was scheduled and delayed.\\n     */\\n    function execute(address target, bytes calldata data) external payable returns (uint32);\\n\\n    /**\\n     * @dev Cancel a scheduled (delayed) operation. Returns the nonce that identifies the previously scheduled\\n     * operation that is cancelled.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be the proposer, a guardian of the targeted function, or a global admin\\n     *\\n     * Emits a {OperationCanceled} event.\\n     */\\n    function cancel(address caller, address target, bytes calldata data) external returns (uint32);\\n\\n    /**\\n     * @dev Consume a scheduled operation targeting the caller. If such an operation exists, mark it as consumed\\n     * (emit an {OperationExecuted} event and clean the state). Otherwise, throw an error.\\n     *\\n     * This is useful for contract that want to enforce that calls targeting them were scheduled on the manager,\\n     * with all the verifications that it implies.\\n     *\\n     * Emit a {OperationExecuted} event.\\n     */\\n    function consumeScheduledOp(address caller, bytes calldata data) external;\\n\\n    /**\\n     * @dev Hashing function for delayed operations.\\n     */\\n    function hashOperation(address caller, address target, bytes calldata data) external view returns (bytes32);\\n\\n    /**\\n     * @dev Changes the authority of a target managed by this manager instance.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     */\\n    function updateAuthority(address target, address newAuthority) external;\\n}\\n\",\"keccak256\":\"0x9be2d08a326515805bc9cf6315b7953f8d1ebe88abf48c2d645fb1fa8211a0e2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAuthority.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAuthority.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Standard interface for permissioning originally defined in Dappsys.\\n */\\ninterface IAuthority {\\n    /**\\n     * @dev Returns true if the caller can invoke on a target the function identified by a function selector.\\n     */\\n    function canCall(address caller, address target, bytes4 selector) external view returns (bool allowed);\\n}\\n\",\"keccak256\":\"0x4cc0766bd7fb7b3bafb70afa2a93b6e313a0baec7a35ad1b57505be7861c1030\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC1363.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1363.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"./IERC20.sol\\\";\\nimport {IERC165} from \\\"./IERC165.sol\\\";\\n\\n/**\\n * @title IERC1363\\n * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].\\n *\\n * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract\\n * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.\\n */\\ninterface IERC1363 is IERC20, IERC165 {\\n    /*\\n     * Note: the ERC-165 identifier for this interface is 0xb0202a11.\\n     * 0xb0202a11 ===\\n     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))\\n     */\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @param data Additional data with no specified format, sent in call to `spender`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);\\n}\\n\",\"keccak256\":\"0x9b6b3e7803bc5f2f8cd7ad57db8ac1def61a9930a5a3107df4882e028a9605d7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC165} from \\\"../utils/introspection/IERC165.sol\\\";\\n\",\"keccak256\":\"0xde7e9fd9aee8d4f40772f96bb3b58836cbc6dfc0227014a061947f8821ea9724\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../token/ERC20/IERC20.sol\\\";\\n\",\"keccak256\":\"0xce41876e78d1badc0512229b4d14e4daf83bc1003d7f83978d18e0e56f965b9c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashBorrower.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashBorrower, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashBorrower {\\n    /**\\n     * @dev Receive a flash loan.\\n     * @param initiator The initiator of the loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param fee The additional amount of tokens to repay.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     * @return The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\\n     */\\n    function onFlashLoan(\\n        address initiator,\\n        address token,\\n        uint256 amount,\\n        uint256 fee,\\n        bytes calldata data\\n    ) external returns (bytes32);\\n}\\n\",\"keccak256\":\"0x0b1459615b9b47c2a4eec8e72f23ccc601f1d711f679a1c06b3390459021a341\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashLender.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC3156FlashBorrower} from \\\"./IERC3156FlashBorrower.sol\\\";\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashLender, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashLender {\\n    /**\\n     * @dev The amount of currency available to be lended.\\n     * @param token The loan currency.\\n     * @return The amount of `token` that can be borrowed.\\n     */\\n    function maxFlashLoan(address token) external view returns (uint256);\\n\\n    /**\\n     * @dev The fee to be charged for a given loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @return The amount of `token` to be charged for the loan, on top of the returned principal.\\n     */\\n    function flashFee(address token, uint256 amount) external view returns (uint256);\\n\\n    /**\\n     * @dev Initiate a flash loan.\\n     * @param receiver The receiver of the tokens in the loan, and the receiver of the callback.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     */\\n    function flashLoan(\\n        IERC3156FlashBorrower receiver,\\n        address token,\\n        uint256 amount,\\n        bytes calldata data\\n    ) external returns (bool);\\n}\\n\",\"keccak256\":\"0x5d19ea24c555cf6a5dbafea9fac57887cc3e72154f3ee8e0a2bf67971811c14b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-20 standard as defined in the ERC.\\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 value of tokens in existence.\\n     */\\n    function totalSupply() external view returns (uint256);\\n\\n    /**\\n     * @dev Returns the value of tokens owned by `account`.\\n     */\\n    function balanceOf(address account) external view returns (uint256);\\n\\n    /**\\n     * @dev Moves a `value` amount of 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 value) 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 a `value` amount of tokens as the allowance of `spender` over the\\n     * 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 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the\\n     * allowance mechanism. `value` 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 value) external returns (bool);\\n}\\n\",\"keccak256\":\"0xe06a3f08a987af6ad2e1c1e774405d4fe08f1694b67517438b467cecf0da0ef7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC-20 standard.\\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\",\"keccak256\":\"0x70f2f713b13b7ce4610bcd0ac9fec0f3cc43693b043abcb8dc40a42a726eb330\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.2.0) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\nimport {IERC1363} from \\\"../../../interfaces/IERC1363.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC-20 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    /**\\n     * @dev An operation with an ERC-20 token failed.\\n     */\\n    error SafeERC20FailedOperation(address token);\\n\\n    /**\\n     * @dev Indicates a failed `decreaseAllowance` request.\\n     */\\n    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);\\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.encodeCall(token.transfer, (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.encodeCall(token.transferFrom, (from, to, 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     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n        uint256 oldAllowance = token.allowance(address(this), spender);\\n        forceApprove(token, spender, oldAllowance + value);\\n    }\\n\\n    /**\\n     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no\\n     * value, non-reverting calls are assumed to be successful.\\n     *\\n     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {\\n        unchecked {\\n            uint256 currentAllowance = token.allowance(address(this), spender);\\n            if (currentAllowance < requestedDecrease) {\\n                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);\\n            }\\n            forceApprove(token, spender, currentAllowance - requestedDecrease);\\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     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function\\n     * only sets the \\\"standard\\\" allowance. Any temporary allowance will remain active, in addition to the value being\\n     * set here.\\n     */\\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));\\n\\n        if (!_callOptionalReturnBool(token, approvalCall)) {\\n            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));\\n            _callOptionalReturn(token, approvalCall);\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            safeTransfer(token, to, value);\\n        } else if (!token.transferAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target\\n     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferFromAndCallRelaxed(\\n        IERC1363 token,\\n        address from,\\n        address to,\\n        uint256 value,\\n        bytes memory data\\n    ) internal {\\n        if (to.code.length == 0) {\\n            safeTransferFrom(token, from, to, value);\\n        } else if (!token.transferFromAndCall(from, to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.\\n     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}\\n     * once without retrying, and relies on the returned value to be true.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            forceApprove(token, to, value);\\n        } else if (!token.approveAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.\\n     */\\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            // bubble errors\\n            if iszero(success) {\\n                let ptr := mload(0x40)\\n                returndatacopy(ptr, 0, returndatasize())\\n                revert(ptr, returndatasize())\\n            }\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n\\n        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.\\n     */\\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n        bool success;\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\\n    }\\n}\\n\",\"keccak256\":\"0x4ea01544758fd2c7045961904686bfe232d2220a04ecaa2d6b08dac17827febf\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)\\n\\npragma solidity ^0.8.20;\\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\",\"keccak256\":\"0x493033a8d1b176a037b2cc6a04dad01a5c157722049bbecf632ca876224dd4b2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Panic.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Helper library for emitting standardized panic codes.\\n *\\n * ```solidity\\n * contract Example {\\n *      using Panic for uint256;\\n *\\n *      // Use any of the declared internal constants\\n *      function foo() { Panic.GENERIC.panic(); }\\n *\\n *      // Alternatively\\n *      function foo() { Panic.panic(Panic.GENERIC); }\\n * }\\n * ```\\n *\\n * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].\\n *\\n * _Available since v5.1._\\n */\\n// slither-disable-next-line unused-state\\nlibrary Panic {\\n    /// @dev generic / unspecified error\\n    uint256 internal constant GENERIC = 0x00;\\n    /// @dev used by the assert() builtin\\n    uint256 internal constant ASSERT = 0x01;\\n    /// @dev arithmetic underflow or overflow\\n    uint256 internal constant UNDER_OVERFLOW = 0x11;\\n    /// @dev division or modulo by zero\\n    uint256 internal constant DIVISION_BY_ZERO = 0x12;\\n    /// @dev enum conversion error\\n    uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;\\n    /// @dev invalid encoding in storage\\n    uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;\\n    /// @dev empty array pop\\n    uint256 internal constant EMPTY_ARRAY_POP = 0x31;\\n    /// @dev array out of bounds access\\n    uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;\\n    /// @dev resource error (too large allocation or too large array)\\n    uint256 internal constant RESOURCE_ERROR = 0x41;\\n    /// @dev calling invalid internal function\\n    uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;\\n\\n    /// @dev Reverts with a panic code. Recommended to use with\\n    /// the internal constants with predefined codes.\\n    function panic(uint256 code) internal pure {\\n        assembly (\\\"memory-safe\\\") {\\n            mstore(0x00, 0x4e487b71)\\n            mstore(0x20, code)\\n            revert(0x1c, 0x24)\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0xf7fe324703a64fc51702311dc51562d5cb1497734f074e4f483bfb6717572d7a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[ERC].\\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[ERC 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\",\"keccak256\":\"0x79796192ec90263f21b464d5bc90b777a525971d3de8232be80d9c4f9fb353b8\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Panic} from \\\"../Panic.sol\\\";\\nimport {SafeCast} from \\\"./SafeCast.sol\\\";\\n\\n/**\\n * @dev Standard math utilities missing in the Solidity language.\\n */\\nlibrary Math {\\n    enum Rounding {\\n        Floor, // Toward negative infinity\\n        Ceil, // Toward positive infinity\\n        Trunc, // Toward zero\\n        Expand // Away from zero\\n    }\\n\\n    /**\\n     * @dev Returns the addition of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            uint256 c = a + b;\\n            if (c < a) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b > a) return (false, 0);\\n            return (true, a - b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n            // benefit is lost if 'b' is also tested.\\n            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n            if (a == 0) return (true, 0);\\n            uint256 c = a * b;\\n            if (c / a != b) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the division of two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a / b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a % b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.\\n     *\\n     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.\\n     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute\\n     * one branch when needed, making this function more expensive.\\n     */\\n    function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {\\n        unchecked {\\n            // branchless ternary works because:\\n            // b ^ (a ^ b) == a\\n            // b ^ 0 == b\\n            return b ^ ((a ^ b) * SafeCast.toUint(condition));\\n        }\\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 ternary(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 ternary(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 towards infinity instead\\n     * of rounding towards zero.\\n     */\\n    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\\n        if (b == 0) {\\n            // Guarantee the same behavior as in a regular Solidity division.\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n\\n        // The following calculation ensures accurate ceiling division without overflow.\\n        // Since a is non-zero, (a - 1) / b will not overflow.\\n        // The largest possible result occurs when (a - 1) / b is type(uint256).max,\\n        // but the largest value we can obtain is type(uint256).max - 1, which happens\\n        // when a = type(uint256).max and b = 1.\\n        unchecked {\\n            return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);\\n        }\\n    }\\n\\n    /**\\n     * @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or\\n     * denominator == 0.\\n     *\\n     * Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by\\n     * 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\\u00b2\\u2075\\u2076 and mod 2\\u00b2\\u2075\\u2076 - 1, then use\\n            // the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\\n            // variables such that product = prod1 * 2\\u00b2\\u2075\\u2076 + prod0.\\n            uint256 prod0 = x * y; // 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                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\\u00b2\\u2075\\u2076. Also prevents denominator == 0.\\n            if (denominator <= prod1) {\\n                Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));\\n            }\\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.\\n            // Always >= 1. See https://cs.stackexchange.com/q/138556/92363.\\n\\n            uint256 twos = denominator & (0 - denominator);\\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\\u00b2\\u2075\\u2076 / 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\\u00b2\\u2075\\u2076. Now that denominator is an odd number, it has an inverse modulo 2\\u00b2\\u2075\\u2076 such\\n            // that denominator * inv \\u2261 1 mod 2\\u00b2\\u2075\\u2076. Compute the inverse by starting with a seed that is correct for\\n            // four bits. That is, denominator * inv \\u2261 1 mod 2\\u2074.\\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\\n            // works in modular arithmetic, doubling the correct bits in each step.\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u2076\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b3\\u00b2\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2076\\u2074\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u00b2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b2\\u2075\\u2076\\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\\u00b2\\u2075\\u2076. Since the preconditions guarantee that the outcome is\\n            // less than 2\\u00b2\\u2075\\u2076, 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     * @dev 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        return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);\\n    }\\n\\n    /**\\n     * @dev Calculate the modular multiplicative inverse of a number in Z/nZ.\\n     *\\n     * If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.\\n     * If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.\\n     *\\n     * If the input value is not inversible, 0 is returned.\\n     *\\n     * NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the\\n     * inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.\\n     */\\n    function invMod(uint256 a, uint256 n) internal pure returns (uint256) {\\n        unchecked {\\n            if (n == 0) return 0;\\n\\n            // The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)\\n            // Used to compute integers x and y such that: ax + ny = gcd(a, n).\\n            // When the gcd is 1, then the inverse of a modulo n exists and it's x.\\n            // ax + ny = 1\\n            // ax = 1 + (-y)n\\n            // ax \\u2261 1 (mod n) # x is the inverse of a modulo n\\n\\n            // If the remainder is 0 the gcd is n right away.\\n            uint256 remainder = a % n;\\n            uint256 gcd = n;\\n\\n            // Therefore the initial coefficients are:\\n            // ax + ny = gcd(a, n) = n\\n            // 0a + 1n = n\\n            int256 x = 0;\\n            int256 y = 1;\\n\\n            while (remainder != 0) {\\n                uint256 quotient = gcd / remainder;\\n\\n                (gcd, remainder) = (\\n                    // The old remainder is the next gcd to try.\\n                    remainder,\\n                    // Compute the next remainder.\\n                    // Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd\\n                    // where gcd is at most n (capped to type(uint256).max)\\n                    gcd - remainder * quotient\\n                );\\n\\n                (x, y) = (\\n                    // Increment the coefficient of a.\\n                    y,\\n                    // Decrement the coefficient of n.\\n                    // Can overflow, but the result is casted to uint256 so that the\\n                    // next value of y is \\\"wrapped around\\\" to a value between 0 and n - 1.\\n                    x - y * int256(quotient)\\n                );\\n            }\\n\\n            if (gcd != 1) return 0; // No inverse exists.\\n            return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.\\n     *\\n     * From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is\\n     * prime, then `a**(p-1) \\u2261 1 mod p`. As a consequence, we have `a * a**(p-2) \\u2261 1 mod p`, which means that\\n     * `a**(p-2)` is the modular multiplicative inverse of a in Fp.\\n     *\\n     * NOTE: this function does NOT check that `p` is a prime greater than `2`.\\n     */\\n    function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {\\n        unchecked {\\n            return Math.modExp(a, p - 2, p);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)\\n     *\\n     * Requirements:\\n     * - modulus can't be zero\\n     * - underlying staticcall to precompile must succeed\\n     *\\n     * IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make\\n     * sure the chain you're using it on supports the precompiled contract for modular exponentiation\\n     * at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,\\n     * the underlying function will succeed given the lack of a revert, but the result may be incorrectly\\n     * interpreted as 0.\\n     */\\n    function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {\\n        (bool success, uint256 result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).\\n     * It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying\\n     * to operate modulo 0 or if the underlying precompile reverted.\\n     *\\n     * IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain\\n     * you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in\\n     * https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack\\n     * of a revert, but the result may be incorrectly interpreted as 0.\\n     */\\n    function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {\\n        if (m == 0) return (false, 0);\\n        assembly (\\\"memory-safe\\\") {\\n            let ptr := mload(0x40)\\n            // | Offset    | Content    | Content (Hex)                                                      |\\n            // |-----------|------------|--------------------------------------------------------------------|\\n            // | 0x00:0x1f | size of b  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x20:0x3f | size of e  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x40:0x5f | size of m  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x60:0x7f | value of b | 0x<.............................................................b> |\\n            // | 0x80:0x9f | value of e | 0x<.............................................................e> |\\n            // | 0xa0:0xbf | value of m | 0x<.............................................................m> |\\n            mstore(ptr, 0x20)\\n            mstore(add(ptr, 0x20), 0x20)\\n            mstore(add(ptr, 0x40), 0x20)\\n            mstore(add(ptr, 0x60), b)\\n            mstore(add(ptr, 0x80), e)\\n            mstore(add(ptr, 0xa0), m)\\n\\n            // Given the result < m, it's guaranteed to fit in 32 bytes,\\n            // so we can use the memory scratch space located at offset 0.\\n            success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)\\n            result := mload(0x00)\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {modExp} that supports inputs of arbitrary length.\\n     */\\n    function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {\\n        (bool success, bytes memory result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Variant of {tryModExp} that supports inputs of arbitrary length.\\n     */\\n    function tryModExp(\\n        bytes memory b,\\n        bytes memory e,\\n        bytes memory m\\n    ) internal view returns (bool success, bytes memory result) {\\n        if (_zeroBytes(m)) return (false, new bytes(0));\\n\\n        uint256 mLen = m.length;\\n\\n        // Encode call args in result and move the free memory pointer\\n        result = abi.encodePacked(b.length, e.length, mLen, b, e, m);\\n\\n        assembly (\\\"memory-safe\\\") {\\n            let dataPtr := add(result, 0x20)\\n            // Write result on top of args to avoid allocating extra memory.\\n            success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)\\n            // Overwrite the length.\\n            // result.length > returndatasize() is guaranteed because returndatasize() == m.length\\n            mstore(result, mLen)\\n            // Set the memory pointer after the returned data.\\n            mstore(0x40, add(dataPtr, mLen))\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether the provided byte array is zero.\\n     */\\n    function _zeroBytes(bytes memory byteArray) private pure returns (bool) {\\n        for (uint256 i = 0; i < byteArray.length; ++i) {\\n            if (byteArray[i] != 0) {\\n                return false;\\n            }\\n        }\\n        return true;\\n    }\\n\\n    /**\\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded\\n     * towards zero.\\n     *\\n     * This method is based on Newton's method for computing square roots; the algorithm is restricted to only\\n     * using integer operations.\\n     */\\n    function sqrt(uint256 a) internal pure returns (uint256) {\\n        unchecked {\\n            // Take care of easy edge cases when a == 0 or a == 1\\n            if (a <= 1) {\\n                return a;\\n            }\\n\\n            // In this function, we use Newton's method to get a root of `f(x) := x\\u00b2 - a`. It involves building a\\n            // sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between\\n            // the current value as `\\u03b5_n = | x_n - sqrt(a) |`.\\n            //\\n            // For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root\\n            // of the target. (i.e. `2**(e-1) \\u2264 sqrt(a) < 2**e`). We know that `e \\u2264 128` because `(2\\u00b9\\u00b2\\u2078)\\u00b2 = 2\\u00b2\\u2075\\u2076` is\\n            // bigger than any uint256.\\n            //\\n            // By noticing that\\n            // `2**(e-1) \\u2264 sqrt(a) < 2**e \\u2192 (2**(e-1))\\u00b2 \\u2264 a < (2**e)\\u00b2 \\u2192 2**(2*e-2) \\u2264 a < 2**(2*e)`\\n            // we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar\\n            // to the msb function.\\n            uint256 aa = a;\\n            uint256 xn = 1;\\n\\n            if (aa >= (1 << 128)) {\\n                aa >>= 128;\\n                xn <<= 64;\\n            }\\n            if (aa >= (1 << 64)) {\\n                aa >>= 64;\\n                xn <<= 32;\\n            }\\n            if (aa >= (1 << 32)) {\\n                aa >>= 32;\\n                xn <<= 16;\\n            }\\n            if (aa >= (1 << 16)) {\\n                aa >>= 16;\\n                xn <<= 8;\\n            }\\n            if (aa >= (1 << 8)) {\\n                aa >>= 8;\\n                xn <<= 4;\\n            }\\n            if (aa >= (1 << 4)) {\\n                aa >>= 4;\\n                xn <<= 2;\\n            }\\n            if (aa >= (1 << 2)) {\\n                xn <<= 1;\\n            }\\n\\n            // We now have x_n such that `x_n = 2**(e-1) \\u2264 sqrt(a) < 2**e = 2 * x_n`. This implies \\u03b5_n \\u2264 2**(e-1).\\n            //\\n            // We can refine our estimation by noticing that the middle of that interval minimizes the error.\\n            // If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to \\u03b5_n \\u2264 2**(e-2).\\n            // This is going to be our x_0 (and \\u03b5_0)\\n            xn = (3 * xn) >> 1; // \\u03b5_0 := | x_0 - sqrt(a) | \\u2264 2**(e-2)\\n\\n            // From here, Newton's method give us:\\n            // x_{n+1} = (x_n + a / x_n) / 2\\n            //\\n            // One should note that:\\n            // x_{n+1}\\u00b2 - a = ((x_n + a / x_n) / 2)\\u00b2 - a\\n            //              = ((x_n\\u00b2 + a) / (2 * x_n))\\u00b2 - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2) - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2 - 4 * a * x_n\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u2074 - 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u00b2 - a)\\u00b2 / (2 * x_n)\\u00b2\\n            //              = ((x_n\\u00b2 - a) / (2 * x_n))\\u00b2\\n            //              \\u2265 0\\n            // Which proves that for all n \\u2265 1, sqrt(a) \\u2264 x_n\\n            //\\n            // This gives us the proof of quadratic convergence of the sequence:\\n            // \\u03b5_{n+1} = | x_{n+1} - sqrt(a) |\\n            //         = | (x_n + a / x_n) / 2 - sqrt(a) |\\n            //         = | (x_n\\u00b2 + a - 2*x_n*sqrt(a)) / (2 * x_n) |\\n            //         = | (x_n - sqrt(a))\\u00b2 / (2 * x_n) |\\n            //         = | \\u03b5_n\\u00b2 / (2 * x_n) |\\n            //         = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //\\n            // For the first iteration, we have a special case where x_0 is known:\\n            // \\u03b5_1 = \\u03b5_0\\u00b2 / | (2 * x_0) |\\n            //     \\u2264 (2**(e-2))\\u00b2 / (2 * (2**(e-1) + 2**(e-2)))\\n            //     \\u2264 2**(2*e-4) / (3 * 2**(e-1))\\n            //     \\u2264 2**(e-3) / 3\\n            //     \\u2264 2**(e-3-log2(3))\\n            //     \\u2264 2**(e-4.5)\\n            //\\n            // For the following iterations, we use the fact that, 2**(e-1) \\u2264 sqrt(a) \\u2264 x_n:\\n            // \\u03b5_{n+1} = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //         \\u2264 (2**(e-k))\\u00b2 / (2 * 2**(e-1))\\n            //         \\u2264 2**(2*e-2*k) / 2**e\\n            //         \\u2264 2**(e-2*k)\\n            xn = (xn + a / xn) >> 1; // \\u03b5_1 := | x_1 - sqrt(a) | \\u2264 2**(e-4.5)  -- special case, see above\\n            xn = (xn + a / xn) >> 1; // \\u03b5_2 := | x_2 - sqrt(a) | \\u2264 2**(e-9)    -- general case with k = 4.5\\n            xn = (xn + a / xn) >> 1; // \\u03b5_3 := | x_3 - sqrt(a) | \\u2264 2**(e-18)   -- general case with k = 9\\n            xn = (xn + a / xn) >> 1; // \\u03b5_4 := | x_4 - sqrt(a) | \\u2264 2**(e-36)   -- general case with k = 18\\n            xn = (xn + a / xn) >> 1; // \\u03b5_5 := | x_5 - sqrt(a) | \\u2264 2**(e-72)   -- general case with k = 36\\n            xn = (xn + a / xn) >> 1; // \\u03b5_6 := | x_6 - sqrt(a) | \\u2264 2**(e-144)  -- general case with k = 72\\n\\n            // Because e \\u2264 128 (as discussed during the first estimation phase), we know have reached a precision\\n            // \\u03b5_6 \\u2264 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either\\n            // sqrt(a) or sqrt(a) + 1.\\n            return xn - SafeCast.toUint(xn > a / xn);\\n        }\\n    }\\n\\n    /**\\n     * @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 2 of a positive value rounded towards zero.\\n     * Returns 0 if given 0.\\n     */\\n    function log2(uint256 value) internal pure returns (uint256) {\\n        uint256 result = 0;\\n        uint256 exp;\\n        unchecked {\\n            exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            result += SafeCast.toUint(value > 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 10 of a positive value rounded towards zero.\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 256 of a positive value rounded towards zero.\\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        uint256 isGt;\\n        unchecked {\\n            isGt = SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= isGt * 128;\\n            result += isGt * 16;\\n\\n            isGt = SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= isGt * 64;\\n            result += isGt * 8;\\n\\n            isGt = SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= isGt * 32;\\n            result += isGt * 4;\\n\\n            isGt = SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= isGt * 16;\\n            result += isGt * 2;\\n\\n            result += SafeCast.toUint(value > (1 << 8) - 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.\\n     */\\n    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {\\n        return uint8(rounding) % 2 == 1;\\n    }\\n}\\n\",\"keccak256\":\"0xa00be322d7db5786750ce0ac7e2f5b633ac30a5ed5fa1ced1e74acfc19acecea\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeCast.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)\\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow\\n * checks.\\n *\\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\\n * easily result in undesired exploitation or bugs, since developers usually\\n * assume that overflows raise errors. `SafeCast` restores this intuition by\\n * reverting the transaction when such an operation overflows.\\n *\\n * Using this library instead of the unchecked operations eliminates an entire\\n * class of bugs, so it's recommended to use it always.\\n */\\nlibrary SafeCast {\\n    /**\\n     * @dev Value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);\\n\\n    /**\\n     * @dev An int value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedIntToUint(int256 value);\\n\\n    /**\\n     * @dev Value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);\\n\\n    /**\\n     * @dev An uint value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedUintToInt(uint256 value);\\n\\n    /**\\n     * @dev Returns the downcasted uint248 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint248).\\n     *\\n     * Counterpart to Solidity's `uint248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toUint248(uint256 value) internal pure returns (uint248) {\\n        if (value > type(uint248).max) {\\n            revert SafeCastOverflowedUintDowncast(248, value);\\n        }\\n        return uint248(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint240 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint240).\\n     *\\n     * Counterpart to Solidity's `uint240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toUint240(uint256 value) internal pure returns (uint240) {\\n        if (value > type(uint240).max) {\\n            revert SafeCastOverflowedUintDowncast(240, value);\\n        }\\n        return uint240(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint232 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint232).\\n     *\\n     * Counterpart to Solidity's `uint232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toUint232(uint256 value) internal pure returns (uint232) {\\n        if (value > type(uint232).max) {\\n            revert SafeCastOverflowedUintDowncast(232, value);\\n        }\\n        return uint232(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint224 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint224).\\n     *\\n     * Counterpart to Solidity's `uint224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toUint224(uint256 value) internal pure returns (uint224) {\\n        if (value > type(uint224).max) {\\n            revert SafeCastOverflowedUintDowncast(224, value);\\n        }\\n        return uint224(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint216 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint216).\\n     *\\n     * Counterpart to Solidity's `uint216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toUint216(uint256 value) internal pure returns (uint216) {\\n        if (value > type(uint216).max) {\\n            revert SafeCastOverflowedUintDowncast(216, value);\\n        }\\n        return uint216(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint208 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint208).\\n     *\\n     * Counterpart to Solidity's `uint208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toUint208(uint256 value) internal pure returns (uint208) {\\n        if (value > type(uint208).max) {\\n            revert SafeCastOverflowedUintDowncast(208, value);\\n        }\\n        return uint208(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint200 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint200).\\n     *\\n     * Counterpart to Solidity's `uint200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toUint200(uint256 value) internal pure returns (uint200) {\\n        if (value > type(uint200).max) {\\n            revert SafeCastOverflowedUintDowncast(200, value);\\n        }\\n        return uint200(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint192 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint192).\\n     *\\n     * Counterpart to Solidity's `uint192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toUint192(uint256 value) internal pure returns (uint192) {\\n        if (value > type(uint192).max) {\\n            revert SafeCastOverflowedUintDowncast(192, value);\\n        }\\n        return uint192(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint184 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint184).\\n     *\\n     * Counterpart to Solidity's `uint184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toUint184(uint256 value) internal pure returns (uint184) {\\n        if (value > type(uint184).max) {\\n            revert SafeCastOverflowedUintDowncast(184, value);\\n        }\\n        return uint184(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint176 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint176).\\n     *\\n     * Counterpart to Solidity's `uint176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toUint176(uint256 value) internal pure returns (uint176) {\\n        if (value > type(uint176).max) {\\n            revert SafeCastOverflowedUintDowncast(176, value);\\n        }\\n        return uint176(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint168 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint168).\\n     *\\n     * Counterpart to Solidity's `uint168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toUint168(uint256 value) internal pure returns (uint168) {\\n        if (value > type(uint168).max) {\\n            revert SafeCastOverflowedUintDowncast(168, value);\\n        }\\n        return uint168(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint160 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint160).\\n     *\\n     * Counterpart to Solidity's `uint160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toUint160(uint256 value) internal pure returns (uint160) {\\n        if (value > type(uint160).max) {\\n            revert SafeCastOverflowedUintDowncast(160, value);\\n        }\\n        return uint160(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint152 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint152).\\n     *\\n     * Counterpart to Solidity's `uint152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toUint152(uint256 value) internal pure returns (uint152) {\\n        if (value > type(uint152).max) {\\n            revert SafeCastOverflowedUintDowncast(152, value);\\n        }\\n        return uint152(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint144 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint144).\\n     *\\n     * Counterpart to Solidity's `uint144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toUint144(uint256 value) internal pure returns (uint144) {\\n        if (value > type(uint144).max) {\\n            revert SafeCastOverflowedUintDowncast(144, value);\\n        }\\n        return uint144(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint136 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint136).\\n     *\\n     * Counterpart to Solidity's `uint136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toUint136(uint256 value) internal pure returns (uint136) {\\n        if (value > type(uint136).max) {\\n            revert SafeCastOverflowedUintDowncast(136, value);\\n        }\\n        return uint136(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint128 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint128).\\n     *\\n     * Counterpart to Solidity's `uint128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toUint128(uint256 value) internal pure returns (uint128) {\\n        if (value > type(uint128).max) {\\n            revert SafeCastOverflowedUintDowncast(128, value);\\n        }\\n        return uint128(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint120 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint120).\\n     *\\n     * Counterpart to Solidity's `uint120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toUint120(uint256 value) internal pure returns (uint120) {\\n        if (value > type(uint120).max) {\\n            revert SafeCastOverflowedUintDowncast(120, value);\\n        }\\n        return uint120(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint112 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint112).\\n     *\\n     * Counterpart to Solidity's `uint112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toUint112(uint256 value) internal pure returns (uint112) {\\n        if (value > type(uint112).max) {\\n            revert SafeCastOverflowedUintDowncast(112, value);\\n        }\\n        return uint112(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint104 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint104).\\n     *\\n     * Counterpart to Solidity's `uint104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toUint104(uint256 value) internal pure returns (uint104) {\\n        if (value > type(uint104).max) {\\n            revert SafeCastOverflowedUintDowncast(104, value);\\n        }\\n        return uint104(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint96 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint96).\\n     *\\n     * Counterpart to Solidity's `uint96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toUint96(uint256 value) internal pure returns (uint96) {\\n        if (value > type(uint96).max) {\\n            revert SafeCastOverflowedUintDowncast(96, value);\\n        }\\n        return uint96(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint88 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint88).\\n     *\\n     * Counterpart to Solidity's `uint88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toUint88(uint256 value) internal pure returns (uint88) {\\n        if (value > type(uint88).max) {\\n            revert SafeCastOverflowedUintDowncast(88, value);\\n        }\\n        return uint88(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint80 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint80).\\n     *\\n     * Counterpart to Solidity's `uint80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toUint80(uint256 value) internal pure returns (uint80) {\\n        if (value > type(uint80).max) {\\n            revert SafeCastOverflowedUintDowncast(80, value);\\n        }\\n        return uint80(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint72 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint72).\\n     *\\n     * Counterpart to Solidity's `uint72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toUint72(uint256 value) internal pure returns (uint72) {\\n        if (value > type(uint72).max) {\\n            revert SafeCastOverflowedUintDowncast(72, value);\\n        }\\n        return uint72(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint64 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint64).\\n     *\\n     * Counterpart to Solidity's `uint64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toUint64(uint256 value) internal pure returns (uint64) {\\n        if (value > type(uint64).max) {\\n            revert SafeCastOverflowedUintDowncast(64, value);\\n        }\\n        return uint64(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint56 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint56).\\n     *\\n     * Counterpart to Solidity's `uint56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toUint56(uint256 value) internal pure returns (uint56) {\\n        if (value > type(uint56).max) {\\n            revert SafeCastOverflowedUintDowncast(56, value);\\n        }\\n        return uint56(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint48 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint48).\\n     *\\n     * Counterpart to Solidity's `uint48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toUint48(uint256 value) internal pure returns (uint48) {\\n        if (value > type(uint48).max) {\\n            revert SafeCastOverflowedUintDowncast(48, value);\\n        }\\n        return uint48(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint40 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint40).\\n     *\\n     * Counterpart to Solidity's `uint40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toUint40(uint256 value) internal pure returns (uint40) {\\n        if (value > type(uint40).max) {\\n            revert SafeCastOverflowedUintDowncast(40, value);\\n        }\\n        return uint40(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint32 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint32).\\n     *\\n     * Counterpart to Solidity's `uint32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toUint32(uint256 value) internal pure returns (uint32) {\\n        if (value > type(uint32).max) {\\n            revert SafeCastOverflowedUintDowncast(32, value);\\n        }\\n        return uint32(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint24 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint24).\\n     *\\n     * Counterpart to Solidity's `uint24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toUint24(uint256 value) internal pure returns (uint24) {\\n        if (value > type(uint24).max) {\\n            revert SafeCastOverflowedUintDowncast(24, value);\\n        }\\n        return uint24(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint16 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint16).\\n     *\\n     * Counterpart to Solidity's `uint16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toUint16(uint256 value) internal pure returns (uint16) {\\n        if (value > type(uint16).max) {\\n            revert SafeCastOverflowedUintDowncast(16, value);\\n        }\\n        return uint16(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint8 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint8).\\n     *\\n     * Counterpart to Solidity's `uint8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toUint8(uint256 value) internal pure returns (uint8) {\\n        if (value > type(uint8).max) {\\n            revert SafeCastOverflowedUintDowncast(8, value);\\n        }\\n        return uint8(value);\\n    }\\n\\n    /**\\n     * @dev Converts a signed int256 into an unsigned uint256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be greater than or equal to 0.\\n     */\\n    function toUint256(int256 value) internal pure returns (uint256) {\\n        if (value < 0) {\\n            revert SafeCastOverflowedIntToUint(value);\\n        }\\n        return uint256(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int248 from int256, reverting on\\n     * overflow (when the input is less than smallest int248 or\\n     * greater than largest int248).\\n     *\\n     * Counterpart to Solidity's `int248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toInt248(int256 value) internal pure returns (int248 downcasted) {\\n        downcasted = int248(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(248, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int240 from int256, reverting on\\n     * overflow (when the input is less than smallest int240 or\\n     * greater than largest int240).\\n     *\\n     * Counterpart to Solidity's `int240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toInt240(int256 value) internal pure returns (int240 downcasted) {\\n        downcasted = int240(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(240, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int232 from int256, reverting on\\n     * overflow (when the input is less than smallest int232 or\\n     * greater than largest int232).\\n     *\\n     * Counterpart to Solidity's `int232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toInt232(int256 value) internal pure returns (int232 downcasted) {\\n        downcasted = int232(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(232, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int224 from int256, reverting on\\n     * overflow (when the input is less than smallest int224 or\\n     * greater than largest int224).\\n     *\\n     * Counterpart to Solidity's `int224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toInt224(int256 value) internal pure returns (int224 downcasted) {\\n        downcasted = int224(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(224, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int216 from int256, reverting on\\n     * overflow (when the input is less than smallest int216 or\\n     * greater than largest int216).\\n     *\\n     * Counterpart to Solidity's `int216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toInt216(int256 value) internal pure returns (int216 downcasted) {\\n        downcasted = int216(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(216, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int208 from int256, reverting on\\n     * overflow (when the input is less than smallest int208 or\\n     * greater than largest int208).\\n     *\\n     * Counterpart to Solidity's `int208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toInt208(int256 value) internal pure returns (int208 downcasted) {\\n        downcasted = int208(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(208, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int200 from int256, reverting on\\n     * overflow (when the input is less than smallest int200 or\\n     * greater than largest int200).\\n     *\\n     * Counterpart to Solidity's `int200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toInt200(int256 value) internal pure returns (int200 downcasted) {\\n        downcasted = int200(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(200, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int192 from int256, reverting on\\n     * overflow (when the input is less than smallest int192 or\\n     * greater than largest int192).\\n     *\\n     * Counterpart to Solidity's `int192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toInt192(int256 value) internal pure returns (int192 downcasted) {\\n        downcasted = int192(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(192, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int184 from int256, reverting on\\n     * overflow (when the input is less than smallest int184 or\\n     * greater than largest int184).\\n     *\\n     * Counterpart to Solidity's `int184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toInt184(int256 value) internal pure returns (int184 downcasted) {\\n        downcasted = int184(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(184, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int176 from int256, reverting on\\n     * overflow (when the input is less than smallest int176 or\\n     * greater than largest int176).\\n     *\\n     * Counterpart to Solidity's `int176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toInt176(int256 value) internal pure returns (int176 downcasted) {\\n        downcasted = int176(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(176, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int168 from int256, reverting on\\n     * overflow (when the input is less than smallest int168 or\\n     * greater than largest int168).\\n     *\\n     * Counterpart to Solidity's `int168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toInt168(int256 value) internal pure returns (int168 downcasted) {\\n        downcasted = int168(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(168, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int160 from int256, reverting on\\n     * overflow (when the input is less than smallest int160 or\\n     * greater than largest int160).\\n     *\\n     * Counterpart to Solidity's `int160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toInt160(int256 value) internal pure returns (int160 downcasted) {\\n        downcasted = int160(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(160, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int152 from int256, reverting on\\n     * overflow (when the input is less than smallest int152 or\\n     * greater than largest int152).\\n     *\\n     * Counterpart to Solidity's `int152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toInt152(int256 value) internal pure returns (int152 downcasted) {\\n        downcasted = int152(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(152, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int144 from int256, reverting on\\n     * overflow (when the input is less than smallest int144 or\\n     * greater than largest int144).\\n     *\\n     * Counterpart to Solidity's `int144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toInt144(int256 value) internal pure returns (int144 downcasted) {\\n        downcasted = int144(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(144, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int136 from int256, reverting on\\n     * overflow (when the input is less than smallest int136 or\\n     * greater than largest int136).\\n     *\\n     * Counterpart to Solidity's `int136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toInt136(int256 value) internal pure returns (int136 downcasted) {\\n        downcasted = int136(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(136, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int128 from int256, reverting on\\n     * overflow (when the input is less than smallest int128 or\\n     * greater than largest int128).\\n     *\\n     * Counterpart to Solidity's `int128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toInt128(int256 value) internal pure returns (int128 downcasted) {\\n        downcasted = int128(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(128, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int120 from int256, reverting on\\n     * overflow (when the input is less than smallest int120 or\\n     * greater than largest int120).\\n     *\\n     * Counterpart to Solidity's `int120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toInt120(int256 value) internal pure returns (int120 downcasted) {\\n        downcasted = int120(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(120, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int112 from int256, reverting on\\n     * overflow (when the input is less than smallest int112 or\\n     * greater than largest int112).\\n     *\\n     * Counterpart to Solidity's `int112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toInt112(int256 value) internal pure returns (int112 downcasted) {\\n        downcasted = int112(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(112, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int104 from int256, reverting on\\n     * overflow (when the input is less than smallest int104 or\\n     * greater than largest int104).\\n     *\\n     * Counterpart to Solidity's `int104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toInt104(int256 value) internal pure returns (int104 downcasted) {\\n        downcasted = int104(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(104, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int96 from int256, reverting on\\n     * overflow (when the input is less than smallest int96 or\\n     * greater than largest int96).\\n     *\\n     * Counterpart to Solidity's `int96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toInt96(int256 value) internal pure returns (int96 downcasted) {\\n        downcasted = int96(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(96, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int88 from int256, reverting on\\n     * overflow (when the input is less than smallest int88 or\\n     * greater than largest int88).\\n     *\\n     * Counterpart to Solidity's `int88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toInt88(int256 value) internal pure returns (int88 downcasted) {\\n        downcasted = int88(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(88, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int80 from int256, reverting on\\n     * overflow (when the input is less than smallest int80 or\\n     * greater than largest int80).\\n     *\\n     * Counterpart to Solidity's `int80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toInt80(int256 value) internal pure returns (int80 downcasted) {\\n        downcasted = int80(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(80, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int72 from int256, reverting on\\n     * overflow (when the input is less than smallest int72 or\\n     * greater than largest int72).\\n     *\\n     * Counterpart to Solidity's `int72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toInt72(int256 value) internal pure returns (int72 downcasted) {\\n        downcasted = int72(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(72, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int64 from int256, reverting on\\n     * overflow (when the input is less than smallest int64 or\\n     * greater than largest int64).\\n     *\\n     * Counterpart to Solidity's `int64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toInt64(int256 value) internal pure returns (int64 downcasted) {\\n        downcasted = int64(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(64, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int56 from int256, reverting on\\n     * overflow (when the input is less than smallest int56 or\\n     * greater than largest int56).\\n     *\\n     * Counterpart to Solidity's `int56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toInt56(int256 value) internal pure returns (int56 downcasted) {\\n        downcasted = int56(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(56, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int48 from int256, reverting on\\n     * overflow (when the input is less than smallest int48 or\\n     * greater than largest int48).\\n     *\\n     * Counterpart to Solidity's `int48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toInt48(int256 value) internal pure returns (int48 downcasted) {\\n        downcasted = int48(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(48, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int40 from int256, reverting on\\n     * overflow (when the input is less than smallest int40 or\\n     * greater than largest int40).\\n     *\\n     * Counterpart to Solidity's `int40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toInt40(int256 value) internal pure returns (int40 downcasted) {\\n        downcasted = int40(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(40, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int32 from int256, reverting on\\n     * overflow (when the input is less than smallest int32 or\\n     * greater than largest int32).\\n     *\\n     * Counterpart to Solidity's `int32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toInt32(int256 value) internal pure returns (int32 downcasted) {\\n        downcasted = int32(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(32, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int24 from int256, reverting on\\n     * overflow (when the input is less than smallest int24 or\\n     * greater than largest int24).\\n     *\\n     * Counterpart to Solidity's `int24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toInt24(int256 value) internal pure returns (int24 downcasted) {\\n        downcasted = int24(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(24, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int16 from int256, reverting on\\n     * overflow (when the input is less than smallest int16 or\\n     * greater than largest int16).\\n     *\\n     * Counterpart to Solidity's `int16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toInt16(int256 value) internal pure returns (int16 downcasted) {\\n        downcasted = int16(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(16, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int8 from int256, reverting on\\n     * overflow (when the input is less than smallest int8 or\\n     * greater than largest int8).\\n     *\\n     * Counterpart to Solidity's `int8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toInt8(int256 value) internal pure returns (int8 downcasted) {\\n        downcasted = int8(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(8, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Converts an unsigned uint256 into a signed int256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be less than or equal to maxInt256.\\n     */\\n    function toInt256(uint256 value) internal pure returns (int256) {\\n        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\\n        if (value > uint256(type(int256).max)) {\\n            revert SafeCastOverflowedUintToInt(value);\\n        }\\n        return int256(value);\\n    }\\n\\n    /**\\n     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.\\n     */\\n    function toUint(bool b) internal pure returns (uint256 u) {\\n        assembly (\\\"memory-safe\\\") {\\n            u := iszero(iszero(b))\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0x195533c86d0ef72bcc06456a4f66a9b941f38eb403739b00f21fd7c1abd1ae54\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/types/Time.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/types/Time.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Math} from \\\"../math/Math.sol\\\";\\nimport {SafeCast} from \\\"../math/SafeCast.sol\\\";\\n\\n/**\\n * @dev This library provides helpers for manipulating time-related objects.\\n *\\n * It uses the following types:\\n * - `uint48` for timepoints\\n * - `uint32` for durations\\n *\\n * While the library doesn't provide specific types for timepoints and duration, it does provide:\\n * - a `Delay` type to represent duration that can be programmed to change value automatically at a given point\\n * - additional helper functions\\n */\\nlibrary Time {\\n    using Time for *;\\n\\n    /**\\n     * @dev Get the block timestamp as a Timepoint.\\n     */\\n    function timestamp() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.timestamp);\\n    }\\n\\n    /**\\n     * @dev Get the block number as a Timepoint.\\n     */\\n    function blockNumber() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.number);\\n    }\\n\\n    // ==================================================== Delay =====================================================\\n    /**\\n     * @dev A `Delay` is a uint32 duration that can be programmed to change value automatically at a given point in the\\n     * future. The \\\"effect\\\" timepoint describes when the transitions happens from the \\\"old\\\" value to the \\\"new\\\" value.\\n     * This allows updating the delay applied to some operation while keeping some guarantees.\\n     *\\n     * In particular, the {update} function guarantees that if the delay is reduced, the old delay still applies for\\n     * some time. For example if the delay is currently 7 days to do an upgrade, the admin should not be able to set\\n     * the delay to 0 and upgrade immediately. If the admin wants to reduce the delay, the old delay (7 days) should\\n     * still apply for some time.\\n     *\\n     *\\n     * The `Delay` type is 112 bits long, and packs the following:\\n     *\\n     * ```\\n     *   | [uint48]: effect date (timepoint)\\n     *   |           | [uint32]: value before (duration)\\n     *   \\u2193           \\u2193       \\u2193 [uint32]: value after (duration)\\n     * 0xAAAAAAAAAAAABBBBBBBBCCCCCCCC\\n     * ```\\n     *\\n     * NOTE: The {get} and {withUpdate} functions operate using timestamps. Block number based delays are not currently\\n     * supported.\\n     */\\n    type Delay is uint112;\\n\\n    /**\\n     * @dev Wrap a duration into a Delay to add the one-step \\\"update in the future\\\" feature\\n     */\\n    function toDelay(uint32 duration) internal pure returns (Delay) {\\n        return Delay.wrap(duration);\\n    }\\n\\n    /**\\n     * @dev Get the value at a given timepoint plus the pending value and effect timepoint if there is a scheduled\\n     * change after this timepoint. If the effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function _getFullAt(\\n        Delay self,\\n        uint48 timepoint\\n    ) private pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        (valueBefore, valueAfter, effect) = self.unpack();\\n        return effect <= timepoint ? (valueAfter, 0, 0) : (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev Get the current value plus the pending value and effect timepoint if there is a scheduled change. If the\\n     * effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function getFull(Delay self) internal view returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        return _getFullAt(self, timestamp());\\n    }\\n\\n    /**\\n     * @dev Get the current value.\\n     */\\n    function get(Delay self) internal view returns (uint32) {\\n        (uint32 delay, , ) = self.getFull();\\n        return delay;\\n    }\\n\\n    /**\\n     * @dev Update a Delay object so that it takes a new duration after a timepoint that is automatically computed to\\n     * enforce the old delay at the moment of the update. Returns the updated Delay object and the timestamp when the\\n     * new delay becomes effective.\\n     */\\n    function withUpdate(\\n        Delay self,\\n        uint32 newValue,\\n        uint32 minSetback\\n    ) internal view returns (Delay updatedDelay, uint48 effect) {\\n        uint32 value = self.get();\\n        uint32 setback = uint32(Math.max(minSetback, value > newValue ? value - newValue : 0));\\n        effect = timestamp() + setback;\\n        return (pack(value, newValue, effect), effect);\\n    }\\n\\n    /**\\n     * @dev Split a delay into its components: valueBefore, valueAfter and effect (transition timepoint).\\n     */\\n    function unpack(Delay self) internal pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        uint112 raw = Delay.unwrap(self);\\n\\n        valueAfter = uint32(raw);\\n        valueBefore = uint32(raw >> 32);\\n        effect = uint48(raw >> 64);\\n\\n        return (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev pack the components into a Delay object.\\n     */\\n    function pack(uint32 valueBefore, uint32 valueAfter, uint48 effect) internal pure returns (Delay) {\\n        return Delay.wrap((uint112(effect) << 64) | (uint112(valueBefore) << 32) | uint112(valueAfter));\\n    }\\n}\\n\",\"keccak256\":\"0x36776530f012618bc7526ceb28e77b85e582cb12d9b9466a71d4bd6bf952e4cc\",\"license\":\"MIT\"},\"contracts/helpers/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { AccessManaged } from \\\"../utils/AccessManaged.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport \\\"contracts/interfaces/IHarvester.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nstruct YieldBearingParams {\\n  // Address of the asset used to mint the yield bearing asset\\n  address asset;\\n  // Target exposure to the collateral yield bearing asset used\\n  uint64 targetExposure;\\n  // Maximum exposure within the Parallelizer to the deposit asset\\n  uint64 maxExposure;\\n  // Minimum exposure within the Parallelizer to the deposit asset\\n  uint64 minExposure;\\n  // Whether limit exposures should be overriden or read onchain through the Parallelizer\\n  // This value should be 1 to override exposures or 2 if these shouldn't be overriden\\n  uint64 overrideExposures;\\n  // Maximum slippage when dealing with the Parallelizer\\n  uint96 maxSlippage;\\n}\\n\\n/// @title BaseHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Abstract contract for a harvester that aims at rebalancing a Parallelizer\\n/// @dev This contract is an authorized fork of Angle's BaseHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol\\nabstract contract BaseHarvester is IHarvester, AccessManaged {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       MODIFIERS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrusted() {\\n    if (!isTrusted[msg.sender]) revert NotTrusted();\\n    _;\\n  }\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted or guardian to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrustedOrRestricted() {\\n    if (!isTrusted[msg.sender] && !_checkCanCall(_msgSender(), _msgData())) {\\n      revert NotTrustedOrGuardian();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       VARIABLES\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Reference to the `parallelizer` implementation this contract aims at rebalancing\\n  IParallelizer public immutable parallelizer;\\n  /// @notice TokenP handled by the `parallelizer` of interest\\n  ITokenP public immutable tokenP;\\n  /// @notice Max slippage when dealing with the Parallelizer\\n  mapping(address => uint96) public maxTokenSlippage;\\n  /// @notice Data associated to a yield bearing asset\\n  mapping(address => YieldBearingParams) public yieldBearingData;\\n  /// @notice trusted addresses that can update target exposure and do others non critical operations\\n  mapping(address => bool) public isTrusted;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EVENTS                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  event Recovered(address token, uint256 amount, address to);\\n  event TrustedToggled(address trusted, bool status);\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       CONSTRUCTOR\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialAuthority,\\n    ITokenP definitiveTokenP,\\n    IParallelizer definitiveParallelizer\\n  )\\n    AccessManaged(initialAuthority)\\n  {\\n    tokenP = definitiveTokenP;\\n    parallelizer = definitiveParallelizer;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        GUARDIAN FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the yieldBearingAsset data\\n   * @param yieldBearingAsset address of the yieldBearingAsset\\n   * @param asset address of the asset\\n   * @param targetExposure target exposure to the yieldBearingAsset asset used\\n   * @param minExposure minimum exposure within the Parallelizer to the asset\\n   * @param maxExposure maximum exposure within the Parallelizer to the asset\\n   * @param overrideExposures whether limit exposures should be overriden or read onchain through the Parallelizer\\n   */\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external\\n    restricted\\n  {\\n    _setYieldBearingAssetData(\\n      yieldBearingAsset, asset, targetExposure, minExposure, maxExposure, overrideExposures, maxSlippage\\n    );\\n  }\\n\\n  /**\\n   * @notice Set the limit exposures to the asset linked to the yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   */\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) public virtual {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    if (yieldBearingInfo.overrideExposures == 2) {\\n      _updateLimitExposuresYieldAsset(yieldBearingInfo.asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  /**\\n   * @notice Set the max allowed slippage\\n   * @param newMaxSlippage new max allowed slippage\\n   */\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external restricted {\\n    _setMaxSlippage(yieldBearingAsset, newMaxSlippage);\\n  }\\n\\n  /**\\n   * @notice Toggle the trusted status of an address\\n   * @param trusted address to toggle the trusted status\\n   */\\n  function toggleTrusted(address trusted) external restricted {\\n    emit TrustedToggled(trusted, isTrusted[trusted]);\\n    isTrusted[trusted] = !isTrusted[trusted];\\n  }\\n\\n  /**\\n   * @notice Recover ERC20 tokens\\n   * @param tokenAddress address of the token to recover\\n   * @param amountToRecover amount to recover\\n   * @param to address to send the recovered tokens\\n   */\\n  function recoverERC20(address tokenAddress, uint256 amountToRecover, address to) external restricted {\\n    emit Recovered(tokenAddress, amountToRecover, to);\\n    IERC20(tokenAddress).safeTransfer(to, amountToRecover);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        TRUSTED FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the target exposure of a yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @param targetExposure target exposure to the yield bearing asset used\\n   */\\n  function setTargetExposure(address yieldBearingAsset, uint64 targetExposure) external onlyTrustedOrRestricted {\\n    yieldBearingData[yieldBearingAsset].targetExposure = targetExposure;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        VIEW FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Compute the amount needed to rebalance the Parallelizer\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @return increase whether the exposure should be increased\\n   * @return amount amount to be rebalanced\\n   */\\n  function computeRebalanceAmount(address yieldBearingAsset) external view returns (uint8 increase, uint256 amount) {\\n    return _computeRebalanceAmount(yieldBearingAsset, yieldBearingData[yieldBearingAsset]);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        INTERNAL FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _computeRebalanceAmount(\\n    address yieldBearingAsset,\\n    YieldBearingParams memory yieldBearingInfo\\n  )\\n    internal\\n    view\\n    returns (uint8 increase, uint256 amount)\\n  {\\n    (uint256 stablecoinsFromYieldBearingAsset, uint256 stablecoinsIssued) =\\n      parallelizer.getIssuedByCollateral(yieldBearingAsset);\\n    (uint256 stablecoinsFromAsset,) = parallelizer.getIssuedByCollateral(yieldBearingInfo.asset);\\n    uint256 targetExposureScaled = yieldBearingInfo.targetExposure * stablecoinsIssued;\\n    if (stablecoinsFromYieldBearingAsset * 1e9 > targetExposureScaled) {\\n      // Need to decrease exposure to yield bearing asset\\n      amount = stablecoinsFromYieldBearingAsset - targetExposureScaled / 1e9;\\n      uint256 maxValueScaled = yieldBearingInfo.maxExposure * stablecoinsIssued;\\n      // These checks assume that there are no transaction fees on the stablecoin->collateral conversion and so\\n      // it's still possible that exposure goes above the max exposure in some rare cases\\n      if (stablecoinsFromAsset * 1e9 > maxValueScaled) {\\n        amount = 0;\\n      } else if ((stablecoinsFromAsset + amount) * 1e9 > maxValueScaled) {\\n        amount = maxValueScaled / 1e9 - stablecoinsFromAsset;\\n      }\\n    } else {\\n      // In this case, exposure after the operation might remain slightly below the targetExposure as less\\n      // collateral may be obtained by burning stablecoins for the yield asset and unwrapping it\\n      increase = 1;\\n      amount = targetExposureScaled / 1e9 - stablecoinsFromYieldBearingAsset;\\n      uint256 minValueScaled = yieldBearingInfo.minExposure * stablecoinsIssued;\\n      if (stablecoinsFromAsset * 1e9 < minValueScaled) {\\n        amount = 0;\\n      } else if (stablecoinsFromAsset * 1e9 < minValueScaled + amount * 1e9) {\\n        amount = stablecoinsFromAsset - minValueScaled / 1e9;\\n      }\\n    }\\n  }\\n\\n  function _setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    internal\\n    virtual\\n  {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    yieldBearingInfo.asset = asset;\\n    if (targetExposure >= 1e9) revert InvalidParam();\\n    if (maxSlippage >= 1e9) revert InvalidParam();\\n    yieldBearingInfo.targetExposure = targetExposure;\\n    yieldBearingInfo.overrideExposures = overrideExposures;\\n    yieldBearingInfo.maxSlippage = maxSlippage;\\n    if (overrideExposures == 1) {\\n      if (maxExposure >= 1e9 || minExposure >= maxExposure) revert InvalidParam();\\n      yieldBearingInfo.maxExposure = maxExposure;\\n      yieldBearingInfo.minExposure = minExposure;\\n    } else {\\n      yieldBearingInfo.overrideExposures = 2;\\n      _updateLimitExposuresYieldAsset(asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  function _updateLimitExposuresYieldAsset(\\n    address asset,\\n    YieldBearingParams storage yieldBearingInfo\\n  )\\n    internal\\n    virtual\\n  {\\n    uint64[] memory xFeeMint;\\n    (xFeeMint,) = parallelizer.getCollateralMintFees(asset);\\n    uint256 length = xFeeMint.length;\\n    if (length <= 1) yieldBearingInfo.maxExposure = 1e9;\\n    else yieldBearingInfo.maxExposure = xFeeMint[length - 2];\\n\\n    uint64[] memory xFeeBurn;\\n    (xFeeBurn,) = parallelizer.getCollateralBurnFees(asset);\\n    length = xFeeBurn.length;\\n    if (length <= 1) yieldBearingInfo.minExposure = 0;\\n    else yieldBearingInfo.minExposure = xFeeBurn[length - 2];\\n  }\\n\\n  function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {\\n    if (newMaxSlippage > 1e9) revert InvalidParam();\\n    maxTokenSlippage[yieldBearingAsset] = newMaxSlippage;\\n  }\\n\\n  function _scaleAmountBasedOnDecimals(\\n    uint256 decimalsTokenIn,\\n    uint256 decimalsTokenOut,\\n    uint256 amountIn,\\n    bool assetIn\\n  )\\n    internal\\n    pure\\n    returns (uint256)\\n  {\\n    if (decimalsTokenIn > decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn /= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      } else {\\n        amountIn *= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      }\\n    } else if (decimalsTokenIn < decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn *= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      } else {\\n        amountIn /= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      }\\n    }\\n    return amountIn;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    HELPER                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _adjustAllowance(address token, address sender, uint256 amountIn) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), sender);\\n    if (allowance < amountIn) IERC20(token).safeIncreaseAllowance(sender, type(uint256).max - allowance);\\n  }\\n}\\n\",\"keccak256\":\"0x82e2ae57997043160d7529488b34591c710cd74e267213b61009daa96e9eeaaf\",\"license\":\"GPL-3.0\"},\"contracts/helpers/GenericHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeCast } from \\\"@openzeppelin/contracts/utils/math/SafeCast.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IERC20Metadata } from \\\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\\\";\\nimport { IERC3156FlashBorrower } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\\\";\\nimport { IERC3156FlashLender } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\\\";\\nimport { RouterSwapper } from \\\"@helpers/RouterSwapper.sol\\\";\\n\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport { IERC4626 } from \\\"contracts/interfaces/external/IERC4626.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nimport { BaseHarvester, YieldBearingParams } from \\\"./BaseHarvester.sol\\\";\\n\\nenum SwapType {\\n  VAULT,\\n  SWAP\\n}\\n\\n/// @title GenericHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Generic contract for anyone to permissionlessly adjust the reserves of Angle Parallelizer\\n/// @dev This contract is an authorized fork of Angle's GenericHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\\ncontract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {\\n  using SafeCast for uint256;\\n  using SafeERC20 for IERC20;\\n\\n  bytes32 public constant CALLBACK_SUCCESS = keccak256(\\\"ERC3156FlashBorrower.onFlashLoan\\\");\\n\\n  /// @notice Parallel stablecoin flashloan contract\\n  IERC3156FlashLender public immutable flashloan;\\n  /// @notice Budget of tokenP available for each users\\n  mapping(address => uint256) public budget;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INITIALIZATION                                                  \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialTokenTransferAddress,\\n    address initialSwapRouter,\\n    ITokenP definitivetokenP,\\n    IParallelizer definitiveParallelizer,\\n    address initialAuthority,\\n    IERC3156FlashLender definitiveFlashloan\\n  )\\n    RouterSwapper(initialSwapRouter, initialTokenTransferAddress)\\n    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)\\n  {\\n    if (address(definitiveFlashloan) == address(0)) revert ZeroAddress();\\n    flashloan = definitiveFlashloan;\\n\\n    IERC20(tokenP).approve(address(definitiveFlashloan), type(uint256).max);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        BUDGET HANDLING\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Add budget to be spent by the receiver during the flashloan\\n   * @param amount amount of tokenP to add to the budget\\n   * @param receiver address of the receiver\\n   */\\n  function addBudget(uint256 amount, address receiver) public virtual {\\n    budget[receiver] += amount;\\n\\n    IERC20(tokenP).safeTransferFrom(msg.sender, address(this), amount);\\n  }\\n\\n  /**\\n   * @notice Remove budget from the owner and send it to the receiver\\n   * @param amount amount of tokenP to remove from the budget\\n   * @param receiver address of the receiver\\n   */\\n  function removeBudget(uint256 amount, address receiver) public virtual {\\n    budget[msg.sender] -= amount; // Will revert if not enough funds\\n\\n    IERC20(tokenP).safeTransfer(receiver, amount);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        HARVEST\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure\\n  ///  to this yieldBearingAsset\\n  /// @dev This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up\\n  /// some yieldBearingAsset that can then be used for people looking to burn deposit tokens\\n  /// @dev Due to potential transaction fees within the Parallelizer, this function doesn't exactly bring\\n  /// `yieldBearingAsset` to the target exposure\\n  /// @dev scale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest,\\n  /// it is used to lower the amount of the asset to harvest for example to have a lower slippage\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual {\\n    if (scale > 1e9) revert InvalidParam();\\n    updateLimitExposuresYieldAsset(yieldBearingAsset);\\n    YieldBearingParams memory yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    (uint8 increase, uint256 amount) = _computeRebalanceAmount(yieldBearingAsset, yieldBearingInfo);\\n    amount = (amount * scale) / 1e9;\\n    if (amount == 0) revert ZeroAmount();\\n    (SwapType swapType, bytes memory data) = abi.decode(extraData, (SwapType, bytes));\\n    try parallelizer.updateOracle(yieldBearingAsset) { } catch { }\\n    _adjustYieldExposure(\\n      amount,\\n      increase,\\n      yieldBearingAsset,\\n      yieldBearingInfo.asset,\\n      (amount * (1e9 - yieldBearingInfo.maxSlippage)) / 1e9,\\n      swapType,\\n      data\\n    );\\n  }\\n\\n  /// @inheritdoc IERC3156FlashBorrower\\n  function onFlashLoan(\\n    address initiator,\\n    address,\\n    uint256 amount,\\n    uint256 fee,\\n    bytes calldata data\\n  )\\n    public\\n    virtual\\n    returns (bytes32)\\n  {\\n    if (msg.sender != address(flashloan) || initiator != address(this) || fee != 0) revert NotTrusted();\\n    address sender;\\n    uint256 typeAction;\\n    uint256 minAmountOut;\\n    SwapType swapType;\\n    bytes memory callData;\\n    address tokenOut;\\n    address tokenIn;\\n    {\\n      address yieldBearingAsset;\\n      address asset;\\n      (sender, typeAction, yieldBearingAsset, asset, minAmountOut, swapType, callData) =\\n        abi.decode(data, (address, uint256, address, address, uint256, SwapType, bytes));\\n      if (typeAction == 1) {\\n        // Increase yield exposure action: we bring in the yield bearing asset\\n        tokenOut = yieldBearingAsset;\\n        tokenIn = asset;\\n      } else {\\n        // Decrease yield exposure action: we bring in the deposit asset\\n        tokenIn = yieldBearingAsset;\\n        tokenOut = asset;\\n      }\\n    }\\n    uint256 amountOut =\\n      parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);\\n\\n    // Swap to tokenIn\\n    amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);\\n\\n    _adjustAllowance(tokenOut, address(parallelizer), amountOut);\\n    uint256 amountStableOut =\\n      parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);\\n    if (amount > amountStableOut) {\\n      budget[sender] -= amount - amountStableOut; // Will revert if not enough funds\\n    }\\n    return CALLBACK_SUCCESS;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    SETTERS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the token transfer contract\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress) public override restricted {\\n    super.setTokenTransferAddress(newTokenTransferAddress);\\n  }\\n\\n  /**\\n   * @notice Set the swap router\\n   * @param newSwapRouter address of the swap router\\n   */\\n  function setSwapRouter(address newSwapRouter) public override restricted {\\n    super.setSwapRouter(newSwapRouter);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INTERNALS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Burns `amountStablecoins` for one yieldBearing asset, swap for asset then mints deposit tokens\\n  /// from the proceeds of the swap.\\n  /// @dev If `increase` is 1, then the system tries to increase its exposure to the yield bearing asset which means\\n  /// burning tokenP for the deposit asset, swapping for the yield bearing asset, then minting the tokenP\\n  /// @dev This function reverts if the second tokenP mint gives less than `minAmountOut` of ag tokens\\n  /// @dev This function reverts if the swap slippage is higher than `maxSlippage`\\n  function _adjustYieldExposure(\\n    uint256 amountStablecoins,\\n    uint8 increase,\\n    address yieldBearingAsset,\\n    address asset,\\n    uint256 minAmountOut,\\n    SwapType swapType,\\n    bytes memory extraData\\n  )\\n    internal\\n  {\\n    flashloan.flashLoan(\\n      IERC3156FlashBorrower(address(this)),\\n      address(tokenP),\\n      amountStablecoins,\\n      abi.encode(msg.sender, increase, yieldBearingAsset, asset, minAmountOut, swapType, extraData)\\n    );\\n  }\\n\\n  function _swapToTokenOut(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    SwapType swapType,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (swapType == SwapType.SWAP) {\\n      amountOut = _swapToTokenOutSwap(tokenIn, tokenOut, amount, callData);\\n    } else if (swapType == SwapType.VAULT) {\\n      amountOut = _swapToTokenOutVault(typeAction, tokenIn, tokenOut, amount);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap token using the router/aggregator\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _swapToTokenOutSwap(\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256)\\n  {\\n    uint256 balance = IERC20(tokenOut).balanceOf(address(this));\\n\\n    address[] memory tokens = new address[](1);\\n    tokens[0] = tokenIn;\\n    bytes[] memory callDatas = new bytes[](1);\\n    callDatas[0] = callData;\\n    uint256[] memory amounts = new uint256[](1);\\n    amounts[0] = amount;\\n    _swap(tokens, callDatas, amounts);\\n\\n    return IERC20(tokenOut).balanceOf(address(this)) - balance;\\n  }\\n\\n  /**\\n   * @dev Deposit or redeem the vault asset\\n   * @param typeAction 1 for deposit, 2 for redeem\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   */\\n  function _swapToTokenOutVault(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (typeAction == 1) {\\n      // Granting allowance with the yieldBearingAsset for the vault asset\\n      _adjustAllowance(tokenIn, tokenOut, amount);\\n      amountOut = IERC4626(tokenOut).deposit(amount, address(this));\\n    } else {\\n      amountOut = IERC4626(tokenIn).redeem(amount, address(this), address(this));\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x604c4f9c755b2eb704dc15ba59046201c0258134ef2fbe15a529c510c68cb40a\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IDiamondCut.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IDiamondCut\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondCut.sol by mudgen\\n/// @dev This interface is an authorized fork of Angle's `IDiamondCut` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IDiamondCut.sol\\ninterface IDiamondCut {\\n  /// @notice Add/replace/remove any number of functions and optionally execute a function with delegatecall\\n  /// @param _diamondCut Contains the facet addresses and function selectors\\n  /// @param _init The address of the contract or facet to execute _calldata\\n  /// @param _calldata A function call, including function selector and arguments, executed with delegatecall on\\n  /// _init\\n  function diamondCut(FacetCut[] calldata _diamondCut, address _init, bytes calldata _calldata) external;\\n}\\n\",\"keccak256\":\"0x08a01f77b740f7da424f0ea27a6a292f9e292058e23d1fe960d2d19a44496c7b\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondEtherscan.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\n/// @title IDiamondEtherscan\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface IDiamondEtherscan {\\n  /// @notice Sets a dummy implementation with the same layout at the diamond proxy contract with all its facets\\n  function setDummyImplementation(address _implementation) external;\\n\\n  /// @notice Address of the dummy implementation used to make the DiamondProxy contract interpretable by Etherscan\\n  function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xf742b55592d129e02fb755d25f7a97ed976a14c4c744d6ac46726809e8f1e037\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondLoupe.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @notice IDiamondLoupe\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondLoupe.sol by mudgen\\ninterface IDiamondLoupe {\\n  /// @notice Gets all facet addresses and their four byte function selectors.\\n  /// @return facets_ Facet\\n  function facets() external view returns (Facet[] memory facets_);\\n\\n  /// @notice Gets all the function selectors supported by a specific facet.\\n  /// @param _facet The facet address.\\n  /// @return facetFunctionSelectors_\\n  function facetFunctionSelectors(address _facet) external view returns (bytes4[] memory facetFunctionSelectors_);\\n\\n  /// @notice Get all the facet addresses used by a diamond.\\n  /// @return facetAddresses_\\n  function facetAddresses() external view returns (address[] memory facetAddresses_);\\n\\n  /// @notice Gets the facet that supports the given selector.\\n  /// @dev If facet is not found return address(0).\\n  /// @param _functionSelector The function selector.\\n  /// @return facetAddress_ The facet address.\\n  function facetAddress(bytes4 _functionSelector) external view returns (address facetAddress_);\\n}\\n\",\"keccak256\":\"0xa5580958acabe2c44967e835e77a748eb0b8812f70cd071191201508c9388ca8\",\"license\":\"MIT\"},\"contracts/interfaces/IGetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IGetters\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IGetters` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IGetters.sol\\ninterface IGetters {\\n  /// @notice Checks whether a given `selector` is actually a valid selector corresponding to a function in one of\\n  /// the\\n  /// facets of the proxy\\n  function isValidSelector(bytes4 selector) external view returns (bool);\\n\\n  /// @notice Stablecoin minted by parallelizer\\n  function tokenP() external view returns (ITokenP);\\n\\n  /// @notice Returns the list of collateral assets supported by the system\\n  function getCollateralList() external view returns (address[] memory);\\n\\n  /// @notice Returns all the info in storage associated to a `collateral`\\n  function getCollateralInfo(address collateral) external view returns (Collateral memory);\\n\\n  /// @notice Returns the decimals of a given `collateral`\\n  function getCollateralDecimals(address collateral) external view returns (uint8);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to mint\\n  /// with `collateral`\\n  function getCollateralMintFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to burn\\n  /// for `collateral`\\n  function getCollateralBurnFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays used to compute the penalty factor depending on the collateral\\n  /// ratio when users come to redeem\\n  function getRedemptionFees() external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the collateral ratio of Parallelizer in base `10**9` and a rounded version of the total amount\\n  /// of stablecoins issued\\n  function getCollateralRatio() external view returns (uint64 collatRatio, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the total amount of stablecoins issued through Parallelizer\\n  function getTotalIssued() external view returns (uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the amount of stablecoins issued from `collateral` and the total amount of stablecoins issued\\n  /// through Parallelizer\\n  function getIssuedByCollateral(address collateral)\\n    external\\n    view\\n    returns (uint256 stablecoinsFromCollateral, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns if a collateral is \\\"managed\\\" and the associated manager configuration\\n  function getManagerData(address collateral)\\n    external\\n    view\\n    returns (bool isManaged, IERC20[] memory subCollaterals, bytes memory config);\\n\\n  /// @notice Returns the oracle values associated to `collateral`\\n  /// @return mint Oracle value to be used for a mint transaction with `collateral`\\n  /// @return burn Oracle value that will be used for `collateral` for a burn transaction. This value\\n  /// is then used along with oracle values for all other collateral assets to get a global burn value for the oracle\\n  /// @return ratio Ratio, in base `10**18` between the oracle value of the `collateral` and its target price.\\n  /// This value is 10**18 if the oracle is greater than the collateral price\\n  /// @return minRatio Minimum ratio across all collateral assets between a collateral burn price and its target\\n  /// price. This value is independent of `collateral` and is used to normalize the burn oracle value for burn\\n  /// transactions.\\n  /// @return redemption Oracle value that would be used to price `collateral` when computing the collateral ratio\\n  /// during a redemption\\n  function getOracleValues(address collateral)\\n    external\\n    view\\n    returns (uint256 mint, uint256 burn, uint256 ratio, uint256 minRatio, uint256 redemption);\\n\\n  /// @notice Returns the data used to compute oracle values for `collateral`\\n  /// @return oracleType Type of oracle (Chainlink, external smart contract, ...)\\n  /// @return targetType Type passed to read the value of the target price\\n  /// @return oracleData Extra data needed to read the oracle. For Chainlink oracles, this data is supposed to give\\n  /// the addresses of the Chainlink feeds to read, the stale periods for each feed, ...\\n  /// @return targetData Extra data needed to read the target price of the asset\\n  function getOracle(address collateral)\\n    external\\n    view\\n    returns (\\n      OracleReadType oracleType,\\n      OracleReadType targetType,\\n      bytes memory oracleData,\\n      bytes memory targetData,\\n      bytes memory hyperparameters\\n    );\\n\\n  /// @notice Returns if the associated functionality is paused or not\\n  function isPaused(address collateral, ActionType action) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update normalizers\\n  function isTrusted(address sender) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update sell rewards\\n  function isTrustedSeller(address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` has a non null entry in the `isWhitelistedForType` storage mapping\\n  /// @dev Note that ultimately whitelisting may depend as well on external providers\\n  function isWhitelistedForType(WhitelistType whitelistType, address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` can deal with `collateral` during burns and redemptions\\n  function isWhitelistedForCollateral(address collateral, address sender) external returns (bool);\\n\\n  /// @notice Checks whether only whitelisted address can deal with `collateral` during burns and redemptions\\n  function isWhitelistedCollateral(address collateral) external view returns (bool);\\n\\n  /// @notice Gets the data needed to deal with whitelists for `collateral`\\n  function getCollateralWhitelistData(address collateral) external view returns (bytes memory);\\n\\n  /// @notice Returns the stablecoin cap for `collateral`\\n  function getStablecoinCap(address collateral) external view returns (uint256);\\n\\n  /// @notice Returns the address of the `accessManager` contract\\n  function accessManager() external view returns (address);\\n\\n  /// @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n  /// being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n  /// attacker controlled calls.\\n  function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaa9eba6ee7770d6146fedbfef07ad10ff09524692319ca0cc32abfa64a2b597b\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IHarvester` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IHarvester.sol\\ninterface IHarvester {\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address stablecoin,\\n    uint64 targetExposure,\\n    uint64 minExposureYieldAsset,\\n    uint64 maxExposureYieldAsset,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external;\\n\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) external;\\n\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external;\\n\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) external;\\n}\\n\",\"keccak256\":\"0x0d4e8fee737f4f747060a3c5044c8cb2f153faa228ad37a661a659ca62aab055\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IParallelizer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IDiamondCut } from \\\"./IDiamondCut.sol\\\";\\nimport { IDiamondEtherscan } from \\\"./IDiamondEtherscan.sol\\\";\\nimport { IDiamondLoupe } from \\\"./IDiamondLoupe.sol\\\";\\nimport { IGetters } from \\\"./IGetters.sol\\\";\\nimport { IRedeemer } from \\\"./IRedeemer.sol\\\";\\nimport { IRewardHandler } from \\\"./IRewardHandler.sol\\\";\\nimport { ISettersGovernor, ISettersGuardian } from \\\"./ISetters.sol\\\";\\nimport { ISwapper } from \\\"./ISwapper.sol\\\";\\n\\n/// @title IParallelizer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IParallelizer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IParallelizer.sol\\ninterface IParallelizer is\\n  IDiamondCut,\\n  IDiamondEtherscan,\\n  IDiamondLoupe,\\n  IGetters,\\n  IRedeemer,\\n  IRewardHandler,\\n  ISettersGovernor,\\n  ISettersGuardian,\\n  ISwapper\\n{ }\\n\",\"keccak256\":\"0x8bd964110c6a122bdb6cf58a194a97c894900237ebd7f3b11e2f43c6ee56ae7c\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRedeemer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRedeemer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRedeemer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRedeemer.sol\\ninterface IRedeemer {\\n  /// @notice Redeems `amount` of stablecoins from the system\\n  /// @param receiver Address which should be receiving the output tokens\\n  /// @param deadline Timestamp before which the redemption should have occured\\n  /// @param minAmountOuts Minimum amount of each token given back in the redemption to obtain\\n  /// @return tokens List of tokens returned\\n  /// @return amounts Amount given for each token in the `tokens` array\\n  function redeem(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Same as the redeem function above with the additional feature to specify a list of `forfeitTokens` for\\n  /// which the Parallelizer system will not try to do a transfer to `receiver`.\\n  function redeemWithForfeit(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts,\\n    address[] memory forfeitTokens\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Simulate the exact output that a redemption of `amount` of stablecoins would give at a given block\\n  /// @return tokens List of tokens that would be given\\n  /// @return amounts Amount that would be obtained for each token in the `tokens` array\\n  function quoteRedemptionCurve(uint256 amount)\\n    external\\n    view\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Updates the normalizer variable by `amount`\\n  function updateNormalizer(uint256 amount, bool increase) external returns (uint256);\\n}\\n\",\"keccak256\":\"0xb3522ee0380b321c64d02bf2db2acb658d8b314b811dd54b6a718d6708b5fb21\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRewardHandler.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRewardHandler\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRewardHandler` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRewardHandler.sol\\ninterface IRewardHandler {\\n  /// @notice Sells some external tokens through a odos call\\n  /// @param minAmountOut Minimum amount of the outToken to get\\n  /// @param payload Payload to pass to odos\\n  /// @return amountOut Amount obtained of the outToken\\n  function sellRewards(uint256 minAmountOut, bytes memory payload) external returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xff2afcbc8d1c25297324159d3684a323e60b3c9408129aba70d3d6938d093255\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/interfaces/IERC20.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISettersGovernor` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISetters.sol\\ninterface ISettersGovernor {\\n  /// @notice Recovers `amount` of `token` from the Parallelizer contract\\n  function recoverERC20(address collateral, IERC20 token, address to, uint256 amount) external;\\n\\n  /// @notice Sets a new access manager address\\n  function setAccessManager(address _newAccessManager) external;\\n\\n  /// @notice Sets (or unsets) a collateral manager  `collateral`\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before setting the new manager\\n  function setCollateralManager(\\n    address collateral,\\n    bool checkExternalManagerBalance,\\n    ManagerStorage memory managerData\\n  )\\n    external;\\n\\n  /// @notice Sets the allowance of the contract on `token` for `spender` to `amount`\\n  function changeAllowance(IERC20 token, address spender, uint256 amount) external;\\n\\n  /// @notice Changes the trusted status for `sender` when for selling rewards or updating the normalizer\\n  function toggleTrusted(address sender, TrustedType t) external;\\n\\n  /// @notice Changes whether a `collateral` can only be handled during burns and redemptions by whitelisted\\n  /// addresses\\n  /// and sets the data used to read into the whitelist\\n  function setWhitelistStatus(address collateral, uint8 whitelistStatus, bytes memory whitelistData) external;\\n\\n  /// @notice Add `collateral` as a supported collateral in the system\\n  function addCollateral(address collateral) external;\\n\\n  /// @notice Adjusts the amount of stablecoins issued from `collateral` by `amount`\\n  function adjustStablecoins(address collateral, uint128 amount, bool increase) external;\\n\\n  /// @notice Revokes `collateral` from the system\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before revoking the collateral\\n  function revokeCollateral(address collateral, bool checkExternalManagerBalance) external;\\n\\n  /// @notice Sets the `oracleConfig` used to read the value of `collateral` for the mint, burn and redemption\\n  /// operations\\n  function setOracle(address collateral, bytes memory oracleConfig) external;\\n\\n  /// @notice Update oracle data for a given `collateral`\\n  function updateOracle(address collateral) external;\\n}\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface ISettersGuardian {\\n  /// @notice Changes the pause status for mint or burn transactions for `collateral`\\n  function togglePause(address collateral, ActionType action) external;\\n\\n  /// @notice Sets the mint or burn fees for `collateral`\\n  function setFees(address collateral, uint64[] memory xFee, int64[] memory yFee, bool mint) external;\\n\\n  /// @notice Sets the parameters for the redemption curve\\n  function setRedemptionCurveParams(uint64[] memory xFee, int64[] memory yFee) external;\\n\\n  /// @notice Changes the whitelist status for a collateral with `whitelistType` for an address `who`\\n  function toggleWhitelist(WhitelistType whitelistType, address who) external;\\n\\n  /// @notice Sets the stablecoin cap that can be issued from a `collateral`\\n  function setStablecoinCap(address collateral, uint256 stablecoinCap) external;\\n}\\n\",\"keccak256\":\"0xc3fb2012e7c2f97ae93b12276afc4293aaeb97a6fe4d60109acaa94ef6945575\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title ISwapper\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISwapper` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISwapper.sol\\ninterface ISwapper {\\n  /// @notice Swaps (that is to say mints or burns) an exact amount of `tokenIn` for an amount of `tokenOut`\\n  /// @param amountIn Amount of `tokenIn` to bring\\n  /// @param amountOutMin Minimum amount of `tokenOut` to get: if `amountOut` is inferior to this amount, the\\n  /// function will revert\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountOut Amount of `tokenOut` obtained through the swap\\n  function swapExactInput(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Same as `swapExactInput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactInputWithPermit(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Swaps (that is to say mints or burns) an amount of `tokenIn` for an exact amount of `tokenOut`\\n  /// @param amountOut Amount of `tokenOut` to obtain from the swap\\n  /// @param amountInMax Maximum amount of `tokenIn` to bring in order to get `amountOut` of `tokenOut`\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountIn Amount of `tokenIn` used to perform the swap\\n  function swapExactOutput(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Same as `swapExactOutput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactOutputWithPermit(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Simulates what a call to `swapExactInput` with `amountIn` of `tokenIn` for `tokenOut` would give.\\n  /// If called right before and at the same block, the `amountOut` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactInput`\\n  function quoteIn(uint256 amountIn, address tokenIn, address tokenOut) external view returns (uint256 amountOut);\\n\\n  /// @notice Simulates what a call to `swapExactOutput` for `amountOut` of `tokenOut` with `tokenIn` would give.\\n  /// If called right before and at the same block, the `amountIn` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactOutput`\\n  function quoteOut(uint256 amountOut, address tokenIn, address tokenOut) external view returns (uint256 amountIn);\\n}\\n\",\"keccak256\":\"0x47e4b2742a51b82b9df72fb681335affe8519f4114fb540cd29d8f48ed182ffd\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ITokenP.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/// @title ITokenP\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @notice Interface for the stablecoins `tokenP` contracts\\n/// @dev This interface is an authorized fork of Angle's `IAgToken` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IAgToken.sol\\ninterface ITokenP is IERC20 {\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    MINTER ROLE ONLY FUNCTIONS                                            \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Lets a whitelisted contract mint tokenPs\\n  /// @param account Address to mint to\\n  /// @param amount Amount to mint\\n  function mint(address account, uint256 amount) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address after being asked to by `sender`\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @param sender Address which requested the burn from `burner`\\n  /// @dev This method is to be called by a contract with the minter right after being requested\\n  /// to do so by a `sender` address willing to burn tokens from another `burner` address\\n  /// @dev The method checks the allowance between the `sender` and the `burner`\\n  function burnFrom(uint256 amount, address burner, address sender) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @dev This method is to be called by a contract with a minter right on the tokenP after being\\n  /// requested to do so by an address willing to burn tokens from its address\\n  function burnSelf(uint256 amount, address burner) external;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EXTERNAL FUNCTIONS                                                \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Amount of decimals of the stablecoin\\n  function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x64a1305faa8c5c91767a11af0eae16e4b463aa0bfe10f11b74aae9d96681a5eb\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/IERC4626.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\n// OpenZeppelin Contracts (last updated v4.7.0) (interfaces/IERC4626.sol)\\n\\npragma solidity >=0.5.0;\\n\\n/// @notice ERC4626 interface\\n/// @author OpenZeppelin\\n/// @dev In this implementation, the interface only contains the functions that the IERC4626 interface adds on top of\\n/// the IERC20 interface\\ninterface IERC4626 {\\n  /**\\n   * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.\\n   *\\n   * - MUST be an ERC-20 token contract.\\n   * - MUST NOT revert.\\n   */\\n  function asset() external view returns (address assetTokenAddress);\\n\\n  /**\\n   * @dev Returns the total amount of the underlying asset that is \\u201cmanaged\\u201d by Vault.\\n   *\\n   * - SHOULD include any compounding that occurs from yield.\\n   * - MUST be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT revert.\\n   */\\n  function totalAssets() external view returns (uint256 totalManagedAssets);\\n\\n  /**\\n   * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToShares(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToAssets(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,\\n   * through a deposit call.\\n   *\\n   * - MUST return a limited value if receiver is subject to some deposit limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.\\n   * - MUST NOT revert.\\n   */\\n  function maxDeposit(address receiver) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit\\n   *   call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called\\n   *   in the same transaction.\\n   * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the\\n   *   deposit would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewDeposit(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   deposit execution, and are accounted for during deposit.\\n   * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function deposit(uint256 assets, address receiver) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.\\n   * - MUST return a limited value if receiver is subject to some mint limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.\\n   * - MUST NOT revert.\\n   */\\n  function maxMint(address receiver) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call\\n   *   in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the\\n   *   same transaction.\\n   * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint\\n   *   would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by minting.\\n   */\\n  function previewMint(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint\\n   *   execution, and are accounted for during mint.\\n   * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function mint(uint256 shares, address receiver) external returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the\\n   * Vault, through a withdraw call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxWithdraw(address owner) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw\\n   *   call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if\\n   *   called\\n   *   in the same transaction.\\n   * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though\\n   *   the withdrawal would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewWithdraw(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   withdraw execution, and are accounted for during withdraw.\\n   * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,\\n   * through a redeem call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxRedeem(address owner) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call\\n   *   in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the\\n   *   same transaction.\\n   * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the\\n   *   redemption would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by redeeming.\\n   */\\n  function previewRedeem(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   redeem execution, and are accounted for during redeem.\\n   * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);\\n}\\n\",\"keccak256\":\"0xd730d6a6b679201eec89dff3133de651da20b3e72e74f01b734078bfacf952ad\",\"license\":\"GPL-3.0\"},\"contracts/parallelizer/Storage.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        ENUMS                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nenum FacetCutAction {\\n  Add,\\n  Replace,\\n  Remove\\n}\\n\\nenum ManagerType {\\n  EXTERNAL\\n}\\n\\nenum ActionType {\\n  Mint,\\n  Burn,\\n  Redeem\\n}\\n\\nenum TrustedType {\\n  Updater,\\n  Seller\\n}\\n\\nenum QuoteType {\\n  MintExactInput,\\n  MintExactOutput,\\n  BurnExactInput,\\n  BurnExactOutput\\n}\\n\\nenum OracleReadType {\\n  CHAINLINK_FEEDS,\\n  EXTERNAL,\\n  NO_ORACLE,\\n  STABLE,\\n  WSTETH,\\n  CBETH,\\n  RETH,\\n  SFRXETH,\\n  MAX,\\n  MORPHO_ORACLE\\n}\\n\\nenum OracleQuoteType {\\n  UNIT,\\n  TARGET\\n}\\n\\nenum WhitelistType {\\n  BACKED\\n}\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                    STRUCTS                                                     \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nstruct Permit2Details {\\n  address to; // Address that will receive the funds\\n  uint256 nonce; // Nonce of the transaction\\n  bytes signature; // Permit signature of the user\\n}\\n\\nstruct FacetCut {\\n  address facetAddress; // Facet contract address\\n  FacetCutAction action; // Can be add, remove or replace\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct Facet {\\n  address facetAddress; // Facet contract address\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct FacetInfo {\\n  address facetAddress; // Facet contract address\\n  uint16 selectorPosition; // Position in the list of all selectors\\n}\\n\\nstruct DiamondStorage {\\n  bytes4[] selectors; // List of all available selectors\\n  mapping(bytes4 => FacetInfo) selectorInfo; // Selector to (address, position in list)\\n  IAccessManager accessManager; // Contract handling access management\\n}\\n\\nstruct ImplementationStorage {\\n  address implementation; // Dummy implementation address for Etherscan usability\\n}\\n\\nstruct ManagerStorage {\\n  IERC20[] subCollaterals; // Subtokens handled by the manager or strategies\\n  bytes config; // Additional configuration data\\n}\\n\\nstruct Collateral {\\n  uint8 isManaged; // If the collateral is managed through external strategies\\n  uint8 isMintLive; // If minting from this asset is unpaused\\n  uint8 isBurnLive; // If burning to this asset is unpaused\\n  uint8 decimals; // IERC20Metadata(collateral).decimals()\\n  uint8 onlyWhitelisted; // If only whitelisted addresses can burn or redeem for this token\\n  uint216 normalizedStables; // Normalized amount of stablecoins issued from this collateral\\n  uint64[] xFeeMint; // Increasing exposures in [0,BASE_9[\\n  int64[] yFeeMint; // Mint fees at the exposures specified in `xFeeMint`\\n  uint64[] xFeeBurn; // Decreasing exposures in ]0,BASE_9]\\n  int64[] yFeeBurn; // Burn fees at the exposures specified in `xFeeBurn`\\n  bytes oracleConfig; // Data about the oracle used for the collateral\\n  bytes whitelistData; // For whitelisted collateral, data used to verify whitelists\\n  ManagerStorage managerData; // For managed collateral, data used to handle the strategies\\n  uint256 stablecoinCap; // Cap on the amount of stablecoins that can be issued from this collateral\\n}\\n\\nstruct ParallelizerStorage {\\n  ITokenP tokenP; // tokenP handled by the system\\n  uint8 isRedemptionLive; // If redemption is unpaused\\n  uint8 statusReentrant; // If call is reentrant or not\\n  bool consumingSchedule; // If the contract is consuming a scheduled operation\\n  uint128 normalizedStables; // Normalized amount of stablecoins issued by the system\\n  uint128 normalizer; // To reconcile `normalizedStables` values with the actual amount\\n  address[] collateralList; // List of collateral assets supported by the system\\n  uint64[] xRedemptionCurve; // Increasing collateral ratios > 0\\n  int64[] yRedemptionCurve; // Value of the redemption fees at `xRedemptionCurve`\\n  mapping(address => Collateral) collaterals; // Maps a collateral asset to its parameters\\n  mapping(address => uint256) isTrusted; // If an address is trusted to update the normalizer value\\n  mapping(address => uint256) isSellerTrusted; // If an address is trusted to sell accruing reward tokens or to run\\n    // keeper jobs on oracles\\n  mapping(WhitelistType => mapping(address => uint256)) isWhitelistedForType;\\n}\\n// Whether an address is whitelisted for a specific whitelist type\\n\",\"keccak256\":\"0x3f4313dd110dbe390038320b2d3cf24dcbe9b75cd9573e7f048f7233c02dd227\",\"license\":\"BUSL-1.1\"},\"contracts/utils/AccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { AuthorityUtils } from \\\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { IAccessManaged } from \\\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\\\";\\nimport { Context } from \\\"@openzeppelin/contracts/utils/Context.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\n/// @title AccessControl\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Fork of OpenZeppelin's `AccessManaged` contract\\n/// updated to make _checkCanCall to return bool\\n/// https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/manager/AccessManaged.sol\\ncontract AccessManaged is Context, IAccessManaged {\\n  address private _authority;\\n\\n  bool private _consumingSchedule;\\n\\n  /**\\n   * @dev Initializes the contract connected to an initial authority.\\n   */\\n  constructor(address initialAuthority) {\\n    _setAuthority(initialAuthority);\\n  }\\n\\n  /**\\n   * @dev Restricts access to a function as defined by the connected Authority for this contract and the\\n   * caller and selector of the function that entered the contract.\\n   *\\n   * [IMPORTANT]\\n   * ====\\n   * In general, this modifier should only be used on `external` functions. It is okay to use it on `public`\\n   * functions that are used as external entry points and are not called internally. Unless you know what you're\\n   * doing, it should never be used on `internal` functions. Failure to follow these rules can have critical security\\n   * implications! This is because the permissions are determined by the function that entered the contract, i.e. the\\n   * function at the bottom of the call stack, and not the function where the modifier is visible in the source code.\\n   * ====\\n   *\\n   * [WARNING]\\n   * ====\\n   * Avoid adding this modifier to the\\n   * https://docs.soliditylang.org/en/v0.8.20/contracts.html#receive-ether-function[`receive()`]\\n   * function or the https://docs.soliditylang.org/en/v0.8.20/contracts.html#fallback-function[`fallback()`]. These\\n   * functions are the only execution paths where a function selector cannot be unambiguously determined from the\\n   * calldata\\n   * since the selector defaults to `0x00000000` in the `receive()` function and similarly in the `fallback()`\\n   * function\\n   * if no calldata is provided. (See {_checkCanCall}).\\n   *\\n   * The `receive()` function will always panic whereas the `fallback()` may panic depending on the calldata length.\\n   * ====\\n   */\\n  modifier restricted() {\\n    address caller = _msgSender();\\n    require(_checkCanCall(caller, _msgData()), AccessManagedUnauthorized(caller));\\n    _;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function authority() public view virtual returns (address) {\\n    return _authority;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function setAuthority(address newAuthority) public virtual {\\n    address caller = _msgSender();\\n    if (caller != authority()) {\\n      revert AccessManagedUnauthorized(caller);\\n    }\\n    if (newAuthority.code.length == 0) {\\n      revert AccessManagedInvalidAuthority(newAuthority);\\n    }\\n    _setAuthority(newAuthority);\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function isConsumingScheduledOp() public view returns (bytes4) {\\n    return _consumingSchedule ? this.isConsumingScheduledOp.selector : bytes4(0);\\n  }\\n\\n  /**\\n   * @dev Transfers control to a new authority. Internal function with no access restriction. Allows bypassing the\\n   * permissions set by the current authority.\\n   */\\n  function _setAuthority(address newAuthority) internal virtual {\\n    _authority = newAuthority;\\n    emit AuthorityUpdated(newAuthority);\\n  }\\n\\n  function _checkCanCall(address caller, bytes calldata data) internal virtual returns (bool) {\\n    (bool immediate, uint32 delay) =\\n      AuthorityUtils.canCallWithDelay(authority(), caller, address(this), bytes4(data[0:4]));\\n    if (!immediate) {\\n      if (delay > 0) {\\n        _consumingSchedule = true;\\n        IAccessManager(authority()).consumeScheduledOp(caller, data);\\n        _consumingSchedule = false;\\n      } else {\\n        return false;\\n      }\\n    }\\n    return true;\\n  }\\n}\\n\",\"keccak256\":\"0x40dfee0e736695b3005df6c150a2d794ac06f3f4b91745e2959623e770044798\",\"license\":\"BUSL-1.1\"},\"contracts/utils/Errors.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nerror AccessManagedUnauthorized(address caller);\\nerror AlreadyAdded();\\nerror CannotAddFunctionToDiamondThatAlreadyExists(bytes4 _selector);\\nerror CannotAddSelectorsToZeroAddress(bytes4[] _selectors);\\nerror CannotRemoveFunctionThatDoesNotExist(bytes4 _selector);\\nerror CannotRemoveImmutableFunction(bytes4 _selector);\\nerror CannotReplaceFunctionsFromFacetWithZeroAddress(bytes4[] _selectors);\\nerror CannotReplaceFunctionThatDoesNotExists(bytes4 _selector);\\nerror CannotReplaceFunctionWithTheSameFunctionFromTheSameFacet(bytes4 _selector);\\nerror CannotReplaceImmutableFunction(bytes4 _selector);\\nerror ContractHasNoCode();\\nerror CollateralBacked();\\nerror FunctionNotFound(bytes4 _functionSelector);\\nerror IncorrectFacetCutAction(uint8 _action);\\nerror InitializationFunctionReverted(address _initializationContractAddress, bytes _calldata);\\nerror InvalidChainlinkRate();\\nerror InvalidLengths();\\nerror InvalidNegativeFees();\\nerror InvalidOracleType();\\nerror InvalidParam();\\nerror InvalidParams();\\nerror InvalidRate();\\nerror InvalidSwap();\\nerror InvalidTokens();\\nerror InvalidAccessManager();\\nerror ManagerHasAssets();\\nerror NoSelectorsProvidedForFacetForCut(address _facetAddress);\\nerror NotAllowed();\\nerror NotCollateral();\\nerror NotGovernor();\\nerror NotGuardian();\\nerror NotTrusted();\\nerror NotTrustedOrGuardian();\\nerror NotWhitelisted();\\nerror OdosSwapFailed();\\nerror OracleUpdateFailed();\\nerror Paused();\\nerror ReentrantCall();\\nerror RemoveFacetAddressMustBeZeroAddress(address _facetAddress);\\nerror TooBigAmountIn();\\nerror TooLate();\\nerror TooSmallAmountOut();\\nerror ZeroAddress();\\nerror ZeroAmount();\\nerror SwapError();\\nerror SlippageTooHigh();\\nerror InsufficientFunds();\\n\",\"keccak256\":\"0x1e2f6812ef78e948e5155d32213b52afff8c0ba5463d18bee10694efbf886130\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
-  "bytecode": "0x60e080604052346101e95760c08161278a803803809161001f828561020f565b8339810103126101e95761003281610246565b9061003f60208201610246565b6040820151926001600160a01b038416918285036101e95760608401516001600160a01b03811681036101e95760a061007a60808701610246565b950151956001600160a01b038716958688036101e9575f80546001600160a01b0319166001600160a01b0390921691821790556040519081527f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad90602090a160a052608052600480546001600160a01b039283166001600160a01b0319918216179091556005805493909216921691909117905581156102005760446020925f9460c052604051948593849263095ea7b360e01b84526004840152811960248401525af180156101f5576101b9575b60405161252f908161025b823960805181818161027601528181610ce401528181610e1b01528181611d1901526120ab015260a0518181816103bf0152818161066a01528181610e480152818161155201526115d9015260c05181818161040701528181610d5901526115960152f35b6020813d6020116101ed575b816101d26020938361020f565b810103126101e95751801515036101e9575f610149565b5f80fd5b3d91506101c5565b6040513d5f823e3d90fd5b63d92e233d60e01b5f5260045ffd5b601f909101601f19168101906001600160401b0382119082101761023257604052565b634e487b7160e01b5f52604160045260245ffd5b51906001600160a01b03821682036101e95756fe60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220ec283012c4b4807e318035ba023be8591bf414e2388206dea6cd585b6cb7364064736f6c634300081c0033",
-  "deployedBytecode": "0x60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220ec283012c4b4807e318035ba023be8591bf414e2388206dea6cd585b6cb7364064736f6c634300081c0033",
-  "devdoc": {
-    "author": "Cooper Labs",
-    "custom:contact": "security@cooperlabs.xyz",
-    "details": "Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol",
-    "errors": {
-      "SafeERC20FailedOperation(address)": [
-        {
-          "details": "An operation with an ERC-20 token failed."
-        }
-      ]
-    },
-    "events": {
-      "AuthorityUpdated(address)": {
-        "details": "Authority that manages this contract was updated."
-      }
-    },
-    "kind": "dev",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to add to the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "authority()": {
-        "details": "Returns the current authority."
-      },
-      "computeRebalanceAmount(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        },
-        "returns": {
-          "amount": "amount to be rebalanced",
-          "increase": "whether the exposure should be increased"
-        }
-      },
-      "harvest(address,uint256,bytes)": {
-        "details": "This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage"
-      },
-      "isConsumingScheduledOp()": {
-        "details": "Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls."
-      },
-      "onFlashLoan(address,address,uint256,uint256,bytes)": {
-        "details": "Receive a flash loan.",
-        "params": {
-          "amount": "The amount of tokens lent.",
-          "data": "Arbitrary data structure, intended to contain user-defined parameters.",
-          "fee": "The additional amount of tokens to repay.",
-          "initiator": "The initiator of the loan.",
-          "token": "The loan currency."
-        },
-        "returns": {
-          "_0": "The keccak256 hash of \"ERC3156FlashBorrower.onFlashLoan\""
-        }
-      },
-      "recoverERC20(address,uint256,address)": {
-        "params": {
-          "amountToRecover": "amount to recover",
-          "to": "address to send the recovered tokens",
-          "tokenAddress": "address of the token to recover"
-        }
-      },
-      "removeBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to remove from the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "setAuthority(address)": {
-        "details": "Transfers control to a new authority. The caller must be the current authority."
-      },
-      "setMaxSlippage(address,uint96)": {
-        "params": {
-          "newMaxSlippage": "new max allowed slippage"
-        }
-      },
-      "setSwapRouter(address)": {
-        "params": {
-          "newSwapRouter": "address of the swap router"
-        }
-      },
-      "setTargetExposure(address,uint64)": {
-        "params": {
-          "targetExposure": "target exposure to the yield bearing asset used",
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      },
-      "setTokenTransferAddress(address)": {
-        "params": {
-          "newTokenTransferAddress": "address of the token transfer contract"
-        }
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "params": {
-          "asset": "address of the asset",
-          "maxExposure": "maximum exposure within the Parallelizer to the asset",
-          "minExposure": "minimum exposure within the Parallelizer to the asset",
-          "overrideExposures": "whether limit exposures should be overriden or read onchain through the Parallelizer",
-          "targetExposure": "target exposure to the yieldBearingAsset asset used",
-          "yieldBearingAsset": "address of the yieldBearingAsset"
-        }
-      },
-      "toggleTrusted(address)": {
-        "params": {
-          "trusted": "address to toggle the trusted status"
-        }
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      }
-    },
-    "title": "GenericHarvester",
-    "version": 1
-  },
-  "userdoc": {
-    "events": {
-      "SwapRouterUpdated(address)": {
-        "notice": "Event emitted when the swap router is updated"
-      },
-      "TokenTransferAddressUpdated(address)": {
-        "notice": "Event emitted when the token proxy is updated"
-      }
-    },
-    "kind": "user",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "notice": "Add budget to be spent by the receiver during the flashloan"
-      },
-      "budget(address)": {
-        "notice": "Budget of tokenP available for each users"
-      },
-      "computeRebalanceAmount(address)": {
-        "notice": "Compute the amount needed to rebalance the Parallelizer"
-      },
-      "flashloan()": {
-        "notice": "Parallel stablecoin flashloan contract"
-      },
-      "harvest(address,uint256,bytes)": {
-        "notice": "Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset"
-      },
-      "isTrusted(address)": {
-        "notice": "trusted addresses that can update target exposure and do others non critical operations"
-      },
-      "maxTokenSlippage(address)": {
-        "notice": "Max slippage when dealing with the Parallelizer"
-      },
-      "parallelizer()": {
-        "notice": "Reference to the `parallelizer` implementation this contract aims at rebalancing"
-      },
-      "recoverERC20(address,uint256,address)": {
-        "notice": "Recover ERC20 tokens"
-      },
-      "removeBudget(uint256,address)": {
-        "notice": "Remove budget from the owner and send it to the receiver"
-      },
-      "setMaxSlippage(address,uint96)": {
-        "notice": "Set the max allowed slippage"
-      },
-      "setSwapRouter(address)": {
-        "notice": "Set the swap router"
-      },
-      "setTargetExposure(address,uint64)": {
-        "notice": "Set the target exposure of a yield bearing asset"
-      },
-      "setTokenTransferAddress(address)": {
-        "notice": "Set the token transfer address"
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "notice": "Set the yieldBearingAsset data"
-      },
-      "swapRouter()": {
-        "notice": "address of the router/aggregator"
-      },
-      "toggleTrusted(address)": {
-        "notice": "Toggle the trusted status of an address"
-      },
-      "tokenP()": {
-        "notice": "TokenP handled by the `parallelizer` of interest"
-      },
-      "tokenTransferAddress()": {
-        "notice": "address to approve to transfer tokens to"
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "notice": "Set the limit exposures to the asset linked to the yield bearing asset"
-      },
-      "yieldBearingData(address)": {
-        "notice": "Data associated to a yield bearing asset"
-      }
-    },
-    "version": 1
-  },
-  "storageLayout": {
-    "storage": [
-      {
-        "astId": 22996,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_authority",
-        "offset": 0,
-        "slot": "0",
-        "type": "t_address"
-      },
-      {
-        "astId": 22998,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_consumingSchedule",
-        "offset": 20,
-        "slot": "0",
-        "type": "t_bool"
-      },
-      {
-        "astId": 8228,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "maxTokenSlippage",
-        "offset": 0,
-        "slot": "1",
-        "type": "t_mapping(t_address,t_uint96)"
-      },
-      {
-        "astId": 8234,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "yieldBearingData",
-        "offset": 0,
-        "slot": "2",
-        "type": "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)"
-      },
-      {
-        "astId": 8239,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "isTrusted",
-        "offset": 0,
-        "slot": "3",
-        "type": "t_mapping(t_address,t_bool)"
-      },
-      {
-        "astId": 43,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "swapRouter",
-        "offset": 0,
-        "slot": "4",
-        "type": "t_address"
-      },
-      {
-        "astId": 46,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "tokenTransferAddress",
-        "offset": 0,
-        "slot": "5",
-        "type": "t_address"
-      },
-      {
-        "astId": 8955,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "budget",
-        "offset": 0,
-        "slot": "6",
-        "type": "t_mapping(t_address,t_uint256)"
-      }
-    ],
-    "types": {
-      "t_address": {
-        "encoding": "inplace",
-        "label": "address",
-        "numberOfBytes": "20"
-      },
-      "t_bool": {
-        "encoding": "inplace",
-        "label": "bool",
-        "numberOfBytes": "1"
-      },
-      "t_mapping(t_address,t_bool)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => bool)",
-        "numberOfBytes": "32",
-        "value": "t_bool"
-      },
-      "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => struct YieldBearingParams)",
-        "numberOfBytes": "32",
-        "value": "t_struct(YieldBearingParams)8169_storage"
-      },
-      "t_mapping(t_address,t_uint256)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint256)",
-        "numberOfBytes": "32",
-        "value": "t_uint256"
-      },
-      "t_mapping(t_address,t_uint96)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint96)",
-        "numberOfBytes": "32",
-        "value": "t_uint96"
-      },
-      "t_struct(YieldBearingParams)8169_storage": {
-        "encoding": "inplace",
-        "label": "struct YieldBearingParams",
-        "members": [
-          {
-            "astId": 8158,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "asset",
-            "offset": 0,
-            "slot": "0",
-            "type": "t_address"
-          },
-          {
-            "astId": 8160,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "targetExposure",
-            "offset": 20,
-            "slot": "0",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8162,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxExposure",
-            "offset": 0,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8164,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "minExposure",
-            "offset": 8,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8166,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "overrideExposures",
-            "offset": 16,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8168,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxSlippage",
-            "offset": 0,
-            "slot": "2",
-            "type": "t_uint96"
-          }
-        ],
-        "numberOfBytes": "96"
-      },
-      "t_uint256": {
-        "encoding": "inplace",
-        "label": "uint256",
-        "numberOfBytes": "32"
-      },
-      "t_uint64": {
-        "encoding": "inplace",
-        "label": "uint64",
-        "numberOfBytes": "8"
-      },
-      "t_uint96": {
-        "encoding": "inplace",
-        "label": "uint96",
-        "numberOfBytes": "12"
-      }
-    }
-  }
-}
\ No newline at end of file
diff --git a/deployments/hyperevm/GenericHarvester_USDp.json b/deployments/hyperevm/GenericHarvester_USDp.json
deleted file mode 100644
index e1ef8fc..0000000
--- a/deployments/hyperevm/GenericHarvester_USDp.json
+++ /dev/null
@@ -1,1124 +0,0 @@
-{
-  "address": "0x57770C1721Eb35509f38210A935c8b1911db7E0e",
-  "abi": [
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initialTokenTransferAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialSwapRouter",
-          "type": "address"
-        },
-        {
-          "internalType": "contract ITokenP",
-          "name": "definitivetokenP",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IParallelizer",
-          "name": "definitiveParallelizer",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialAuthority",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "definitiveFlashloan",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "constructor"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedInvalidAuthority",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        },
-        {
-          "internalType": "uint32",
-          "name": "delay",
-          "type": "uint32"
-        }
-      ],
-      "name": "AccessManagedRequiredDelay",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedUnauthorized",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "InvalidParam",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrusted",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrustedOrGuardian",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        }
-      ],
-      "name": "SafeERC20FailedOperation",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "SwapError",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAddress",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAmount",
-      "type": "error"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AuthorityUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "Recovered",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "SwapRouterUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "TokenTransferAddressUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "bool",
-          "name": "status",
-          "type": "bool"
-        }
-      ],
-      "name": "TrustedToggled",
-      "type": "event"
-    },
-    {
-      "inputs": [],
-      "name": "CALLBACK_SUCCESS",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "addBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "authority",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "budget",
-      "outputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "computeRebalanceAmount",
-      "outputs": [
-        {
-          "internalType": "uint8",
-          "name": "increase",
-          "type": "uint8"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "flashloan",
-      "outputs": [
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "scale",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "extraData",
-          "type": "bytes"
-        }
-      ],
-      "name": "harvest",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "isConsumingScheduledOp",
-      "outputs": [
-        {
-          "internalType": "bytes4",
-          "name": "",
-          "type": "bytes4"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "isTrusted",
-      "outputs": [
-        {
-          "internalType": "bool",
-          "name": "",
-          "type": "bool"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "maxTokenSlippage",
-      "outputs": [
-        {
-          "internalType": "uint96",
-          "name": "",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initiator",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "uint256",
-          "name": "fee",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "data",
-          "type": "bytes"
-        }
-      ],
-      "name": "onFlashLoan",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "parallelizer",
-      "outputs": [
-        {
-          "internalType": "contract IParallelizer",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "tokenAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amountToRecover",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "recoverERC20",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "removeBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newAuthority",
-          "type": "address"
-        }
-      ],
-      "name": "setAuthority",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint96",
-          "name": "newMaxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setMaxSlippage",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "setSwapRouter",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        }
-      ],
-      "name": "setTargetExposure",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "setTokenTransferAddress",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setYieldBearingAssetData",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "swapRouter",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        }
-      ],
-      "name": "toggleTrusted",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenP",
-      "outputs": [
-        {
-          "internalType": "contract ITokenP",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenTransferAddress",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "updateLimitExposuresYieldAsset",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "yieldBearingData",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    }
-  ],
-  "transactionHash": "0x6c350767c797c798d57bc744249b0a5a16583184117d70fbfd341c0218768067",
-  "receipt": {
-    "to": null,
-    "from": "0x66CcEC236bbcE5f1bBd1b2fC0a4014e57A55ad02",
-    "contractAddress": "0x57770C1721Eb35509f38210A935c8b1911db7E0e",
-    "transactionIndex": 0,
-    "gasUsed": "2210613",
-    "logsBloom": "0x08000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000200000000000000000000000000000000000000000100100000000000800000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000040000000000000009000000000002000000000000000000020000000000000000000000080000000000000000000000000000000000000000000000000000000000100000000000200000000000000000000000000000000210000000000000000008000000000000000000000000000000000000000000",
-    "blockHash": "0xe3c06780634d363711f4758fa230c97447200aeeefe7732b7a7cc015cfc5428a",
-    "transactionHash": "0x6c350767c797c798d57bc744249b0a5a16583184117d70fbfd341c0218768067",
-    "logs": [
-      {
-        "transactionIndex": 0,
-        "blockNumber": 6538100,
-        "transactionHash": "0x6c350767c797c798d57bc744249b0a5a16583184117d70fbfd341c0218768067",
-        "address": "0x57770C1721Eb35509f38210A935c8b1911db7E0e",
-        "topics": [
-          "0x2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad"
-        ],
-        "data": "0x000000000000000000000000fd28f108e95f4d41daae9dbfff707d677985998e",
-        "logIndex": 0,
-        "blockHash": "0xe3c06780634d363711f4758fa230c97447200aeeefe7732b7a7cc015cfc5428a"
-      },
-      {
-        "transactionIndex": 0,
-        "blockNumber": 6538100,
-        "transactionHash": "0x6c350767c797c798d57bc744249b0a5a16583184117d70fbfd341c0218768067",
-        "address": "0xBE65F0F410A72BeC163dC65d46c83699e957D588",
-        "topics": [
-          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
-          "0x00000000000000000000000057770c1721eb35509f38210a935c8b1911db7e0e",
-          "0x00000000000000000000000015452454a9735d68df430879b2941316a09295b1"
-        ],
-        "data": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
-        "logIndex": 1,
-        "blockHash": "0xe3c06780634d363711f4758fa230c97447200aeeefe7732b7a7cc015cfc5428a"
-      }
-    ],
-    "blockNumber": 6538100,
-    "cumulativeGasUsed": "2210613",
-    "status": 1,
-    "byzantium": true
-  },
-  "args": [
-    "0x744489ee3d540777a66f2cf297479745e0852f7a",
-    "0x744489ee3d540777a66f2cf297479745e0852f7a",
-    "0xBE65F0F410A72BeC163dC65d46c83699e957D588",
-    "0x1250304F66404cd153fA39388DDCDAec7E0f1707",
-    "0xfD28f108e95f4D41daAE9dbfFf707D677985998E",
-    "0x15452454A9735D68df430879B2941316a09295B1"
-  ],
-  "numDeployments": 1,
-  "solcInputHash": "ac7717979711c6e452015444ccc68db6",
-  "metadata": "{\"compiler\":{\"version\":\"0.8.28+commit.7893614a\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initialTokenTransferAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialSwapRouter\",\"type\":\"address\"},{\"internalType\":\"contract ITokenP\",\"name\":\"definitivetokenP\",\"type\":\"address\"},{\"internalType\":\"contract IParallelizer\",\"name\":\"definitiveParallelizer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialAuthority\",\"type\":\"address\"},{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"definitiveFlashloan\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AccessManagedInvalidAuthority\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"delay\",\"type\":\"uint32\"}],\"name\":\"AccessManagedRequiredDelay\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"AccessManagedUnauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidParam\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrusted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrustedOrGuardian\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"SafeERC20FailedOperation\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"SwapError\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAmount\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AuthorityUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"Recovered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"SwapRouterUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"TokenTransferAddressUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"status\",\"type\":\"bool\"}],\"name\":\"TrustedToggled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"CALLBACK_SUCCESS\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"addBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"budget\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"computeRebalanceAmount\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"increase\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"flashloan\",\"outputs\":[{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"scale\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"extraData\",\"type\":\"bytes\"}],\"name\":\"harvest\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isConsumingScheduledOp\",\"outputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"isTrusted\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"maxTokenSlippage\",\"outputs\":[{\"internalType\":\"uint96\",\"name\":\"\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initiator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"fee\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"onFlashLoan\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"parallelizer\",\"outputs\":[{\"internalType\":\"contract IParallelizer\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amountToRecover\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"recoverERC20\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"removeBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAuthority\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint96\",\"name\":\"newMaxSlippage\",\"type\":\"uint96\"}],\"name\":\"setMaxSlippage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"setSwapRouter\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"}],\"name\":\"setTargetExposure\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"setTokenTransferAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"name\":\"setYieldBearingAssetData\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"swapRouter\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"}],\"name\":\"toggleTrusted\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenP\",\"outputs\":[{\"internalType\":\"contract ITokenP\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenTransferAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"updateLimitExposuresYieldAsset\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"yieldBearingData\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Cooper Labs\",\"custom:contact\":\"security@cooperlabs.xyz\",\"details\":\"Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\",\"errors\":{\"SafeERC20FailedOperation(address)\":[{\"details\":\"An operation with an ERC-20 token failed.\"}]},\"events\":{\"AuthorityUpdated(address)\":{\"details\":\"Authority that manages this contract was updated.\"}},\"kind\":\"dev\",\"methods\":{\"addBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to add to the budget\",\"receiver\":\"address of the receiver\"}},\"authority()\":{\"details\":\"Returns the current authority.\"},\"computeRebalanceAmount(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"},\"returns\":{\"amount\":\"amount to be rebalanced\",\"increase\":\"whether the exposure should be increased\"}},\"harvest(address,uint256,bytes)\":{\"details\":\"This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage\"},\"isConsumingScheduledOp()\":{\"details\":\"Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls.\"},\"onFlashLoan(address,address,uint256,uint256,bytes)\":{\"details\":\"Receive a flash loan.\",\"params\":{\"amount\":\"The amount of tokens lent.\",\"data\":\"Arbitrary data structure, intended to contain user-defined parameters.\",\"fee\":\"The additional amount of tokens to repay.\",\"initiator\":\"The initiator of the loan.\",\"token\":\"The loan currency.\"},\"returns\":{\"_0\":\"The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\"}},\"recoverERC20(address,uint256,address)\":{\"params\":{\"amountToRecover\":\"amount to recover\",\"to\":\"address to send the recovered tokens\",\"tokenAddress\":\"address of the token to recover\"}},\"removeBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to remove from the budget\",\"receiver\":\"address of the receiver\"}},\"setAuthority(address)\":{\"details\":\"Transfers control to a new authority. The caller must be the current authority.\"},\"setMaxSlippage(address,uint96)\":{\"params\":{\"newMaxSlippage\":\"new max allowed slippage\"}},\"setSwapRouter(address)\":{\"params\":{\"newSwapRouter\":\"address of the swap router\"}},\"setTargetExposure(address,uint64)\":{\"params\":{\"targetExposure\":\"target exposure to the yield bearing asset used\",\"yieldBearingAsset\":\"address of the yield bearing asset\"}},\"setTokenTransferAddress(address)\":{\"params\":{\"newTokenTransferAddress\":\"address of the token transfer contract\"}},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"params\":{\"asset\":\"address of the asset\",\"maxExposure\":\"maximum exposure within the Parallelizer to the asset\",\"minExposure\":\"minimum exposure within the Parallelizer to the asset\",\"overrideExposures\":\"whether limit exposures should be overriden or read onchain through the Parallelizer\",\"targetExposure\":\"target exposure to the yieldBearingAsset asset used\",\"yieldBearingAsset\":\"address of the yieldBearingAsset\"}},\"toggleTrusted(address)\":{\"params\":{\"trusted\":\"address to toggle the trusted status\"}},\"updateLimitExposuresYieldAsset(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"}}},\"title\":\"GenericHarvester\",\"version\":1},\"userdoc\":{\"events\":{\"SwapRouterUpdated(address)\":{\"notice\":\"Event emitted when the swap router is updated\"},\"TokenTransferAddressUpdated(address)\":{\"notice\":\"Event emitted when the token proxy is updated\"}},\"kind\":\"user\",\"methods\":{\"addBudget(uint256,address)\":{\"notice\":\"Add budget to be spent by the receiver during the flashloan\"},\"budget(address)\":{\"notice\":\"Budget of tokenP available for each users\"},\"computeRebalanceAmount(address)\":{\"notice\":\"Compute the amount needed to rebalance the Parallelizer\"},\"flashloan()\":{\"notice\":\"Parallel stablecoin flashloan contract\"},\"harvest(address,uint256,bytes)\":{\"notice\":\"Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset\"},\"isTrusted(address)\":{\"notice\":\"trusted addresses that can update target exposure and do others non critical operations\"},\"maxTokenSlippage(address)\":{\"notice\":\"Max slippage when dealing with the Parallelizer\"},\"parallelizer()\":{\"notice\":\"Reference to the `parallelizer` implementation this contract aims at rebalancing\"},\"recoverERC20(address,uint256,address)\":{\"notice\":\"Recover ERC20 tokens\"},\"removeBudget(uint256,address)\":{\"notice\":\"Remove budget from the owner and send it to the receiver\"},\"setMaxSlippage(address,uint96)\":{\"notice\":\"Set the max allowed slippage\"},\"setSwapRouter(address)\":{\"notice\":\"Set the swap router\"},\"setTargetExposure(address,uint64)\":{\"notice\":\"Set the target exposure of a yield bearing asset\"},\"setTokenTransferAddress(address)\":{\"notice\":\"Set the token transfer address\"},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"notice\":\"Set the yieldBearingAsset data\"},\"swapRouter()\":{\"notice\":\"address of the router/aggregator\"},\"toggleTrusted(address)\":{\"notice\":\"Toggle the trusted status of an address\"},\"tokenP()\":{\"notice\":\"TokenP handled by the `parallelizer` of interest\"},\"tokenTransferAddress()\":{\"notice\":\"address to approve to transfer tokens to\"},\"updateLimitExposuresYieldAsset(address)\":{\"notice\":\"Set the limit exposures to the asset linked to the yield bearing asset\"},\"yieldBearingData(address)\":{\"notice\":\"Data associated to a yield bearing asset\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/helpers/GenericHarvester.sol\":\"GenericHarvester\"},\"evmVersion\":\"cancun\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@helpers/RouterSwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\n/// @title Swapper\\n/// @author Angle Labs, Inc.\\n/// @dev Abstract contract for swapping tokens using a router/aggregator\\n/// @dev This contract is an authorized fork of Angle's `RouterSwapper` contract\\n/// https://github.com/AngleProtocol/utils/blob/main/src/RouterSwapper.sol\\nabstract contract RouterSwapper {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               ERRORS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  error SwapError();\\n  error ZeroAddress();\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                EVENTS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   *  @notice Event emitted when the swap router is updated\\n   */\\n  event SwapRouterUpdated(address newSwapRouter);\\n  /**\\n   *  @notice Event emitted when the token proxy is updated\\n   */\\n  event TokenTransferAddressUpdated(address newTokenTransferAddress);\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                MODIFIERS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  modifier noZeroAddress(address targetAddress) {\\n    if (targetAddress == address(0)) {\\n      revert ZeroAddress();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                            MUTABLE VARIABLES\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice address of the router/aggregator\\n   */\\n  address public swapRouter;\\n  /**\\n   * @notice address to approve to transfer tokens to\\n   */\\n  address public tokenTransferAddress;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               CONSTRUCTOR\\n    //////////////////////////////////////////////////////////////*/\\n\\n  constructor(address initialSwapRouter, address initialTokenTransferAddress) {\\n    swapRouter = initialSwapRouter;\\n    tokenTransferAddress = initialTokenTransferAddress;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             ADMIN FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the router/aggregator address\\n   * @param newSwapRouter address of the new router/aggregator\\n   */\\n  function setSwapRouter(address newSwapRouter) public virtual noZeroAddress(newSwapRouter) {\\n    swapRouter = newSwapRouter;\\n\\n    emit SwapRouterUpdated(newSwapRouter);\\n  }\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the new token transfer address\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress)\\n    public\\n    virtual\\n    noZeroAddress(newTokenTransferAddress)\\n  {\\n    tokenTransferAddress = newTokenTransferAddress;\\n\\n    emit TokenTransferAddressUpdated(newTokenTransferAddress);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             SWAP FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Approve the router/aggregator to spend the token if needed\\n   * @param token address of the token to approve\\n   * @param spender address of the router/aggregator\\n   * @param amount amount to approve\\n   */\\n  function _approveTokenIfNeeded(address token, address spender, uint256 amount) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), spender);\\n    if (allowance < amount) {\\n      IERC20(token).safeIncreaseAllowance(spender, amount - allowance);\\n    }\\n  }\\n\\n  /**\\n   * @notice Perform the swap using the router/aggregator\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _performRouterSwap(bytes memory callData) internal {\\n    (bool success, bytes memory retData) = swapRouter.call(callData);\\n\\n    if (!success) {\\n      if (retData.length != 0) {\\n        assembly (\\\"memory-safe\\\") {\\n          revert(add(32, retData), mload(retData))\\n        }\\n      }\\n      revert SwapError();\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swapCalldata(address[] calldata tokens, bytes[] calldata callDatas, uint256[] calldata amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swap(address[] memory tokens, bytes[] memory callDatas, uint256[] memory amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x8c5a6b026a95816806814ef681b6b225ea4c405a39a4eab0111921853202829c\",\"license\":\"GPL-3.0\"},\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/AuthorityUtils.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IAuthority} from \\\"./IAuthority.sol\\\";\\n\\nlibrary AuthorityUtils {\\n    /**\\n     * @dev Since `AccessManager` implements an extended IAuthority interface, invoking `canCall` with backwards compatibility\\n     * for the preexisting `IAuthority` interface requires special care to avoid reverting on insufficient return data.\\n     * This helper function takes care of invoking `canCall` in a backwards compatible way without reverting.\\n     */\\n    function canCallWithDelay(\\n        address authority,\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) internal view returns (bool immediate, uint32 delay) {\\n        (bool success, bytes memory data) = authority.staticcall(\\n            abi.encodeCall(IAuthority.canCall, (caller, target, selector))\\n        );\\n        if (success) {\\n            if (data.length >= 0x40) {\\n                (immediate, delay) = abi.decode(data, (bool, uint32));\\n            } else if (data.length >= 0x20) {\\n                immediate = abi.decode(data, (bool));\\n            }\\n        }\\n        return (immediate, delay);\\n    }\\n}\\n\",\"keccak256\":\"0xb3875997b0d8705e29aa20fee88e1dfef93df438794ae1ad8ba2eb016a4dd4e4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAccessManaged.sol)\\n\\npragma solidity ^0.8.20;\\n\\ninterface IAccessManaged {\\n    /**\\n     * @dev Authority that manages this contract was updated.\\n     */\\n    event AuthorityUpdated(address authority);\\n\\n    error AccessManagedUnauthorized(address caller);\\n    error AccessManagedRequiredDelay(address caller, uint32 delay);\\n    error AccessManagedInvalidAuthority(address authority);\\n\\n    /**\\n     * @dev Returns the current authority.\\n     */\\n    function authority() external view returns (address);\\n\\n    /**\\n     * @dev Transfers control to a new authority. The caller must be the current authority.\\n     */\\n    function setAuthority(address) external;\\n\\n    /**\\n     * @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n     * being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n     * attacker controlled calls.\\n     */\\n    function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaba93d42cd70e1418782951132d97b31ddce5f50ad81090884b6d0e41caac9d6\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManager.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (access/manager/IAccessManager.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Time} from \\\"../../utils/types/Time.sol\\\";\\n\\ninterface IAccessManager {\\n    /**\\n     * @dev A delayed operation was scheduled.\\n     */\\n    event OperationScheduled(\\n        bytes32 indexed operationId,\\n        uint32 indexed nonce,\\n        uint48 schedule,\\n        address caller,\\n        address target,\\n        bytes data\\n    );\\n\\n    /**\\n     * @dev A scheduled operation was executed.\\n     */\\n    event OperationExecuted(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev A scheduled operation was canceled.\\n     */\\n    event OperationCanceled(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev Informational labelling for a roleId.\\n     */\\n    event RoleLabel(uint64 indexed roleId, string label);\\n\\n    /**\\n     * @dev Emitted when `account` is granted `roleId`.\\n     *\\n     * NOTE: The meaning of the `since` argument depends on the `newMember` argument.\\n     * If the role is granted to a new member, the `since` argument indicates when the account becomes a member of the role,\\n     * otherwise it indicates the execution delay for this account and roleId is updated.\\n     */\\n    event RoleGranted(uint64 indexed roleId, address indexed account, uint32 delay, uint48 since, bool newMember);\\n\\n    /**\\n     * @dev Emitted when `account` membership or `roleId` is revoked. Unlike granting, revoking is instantaneous.\\n     */\\n    event RoleRevoked(uint64 indexed roleId, address indexed account);\\n\\n    /**\\n     * @dev Role acting as admin over a given `roleId` is updated.\\n     */\\n    event RoleAdminChanged(uint64 indexed roleId, uint64 indexed admin);\\n\\n    /**\\n     * @dev Role acting as guardian over a given `roleId` is updated.\\n     */\\n    event RoleGuardianChanged(uint64 indexed roleId, uint64 indexed guardian);\\n\\n    /**\\n     * @dev Grant delay for a given `roleId` will be updated to `delay` when `since` is reached.\\n     */\\n    event RoleGrantDelayChanged(uint64 indexed roleId, uint32 delay, uint48 since);\\n\\n    /**\\n     * @dev Target mode is updated (true = closed, false = open).\\n     */\\n    event TargetClosed(address indexed target, bool closed);\\n\\n    /**\\n     * @dev Role required to invoke `selector` on `target` is updated to `roleId`.\\n     */\\n    event TargetFunctionRoleUpdated(address indexed target, bytes4 selector, uint64 indexed roleId);\\n\\n    /**\\n     * @dev Admin delay for a given `target` will be updated to `delay` when `since` is reached.\\n     */\\n    event TargetAdminDelayUpdated(address indexed target, uint32 delay, uint48 since);\\n\\n    error AccessManagerAlreadyScheduled(bytes32 operationId);\\n    error AccessManagerNotScheduled(bytes32 operationId);\\n    error AccessManagerNotReady(bytes32 operationId);\\n    error AccessManagerExpired(bytes32 operationId);\\n    error AccessManagerLockedRole(uint64 roleId);\\n    error AccessManagerBadConfirmation();\\n    error AccessManagerUnauthorizedAccount(address msgsender, uint64 roleId);\\n    error AccessManagerUnauthorizedCall(address caller, address target, bytes4 selector);\\n    error AccessManagerUnauthorizedConsume(address target);\\n    error AccessManagerUnauthorizedCancel(address msgsender, address caller, address target, bytes4 selector);\\n    error AccessManagerInvalidInitialAdmin(address initialAdmin);\\n\\n    /**\\n     * @dev Check if an address (`caller`) is authorised to call a given function on a given contract directly (with\\n     * no restriction). Additionally, it returns the delay needed to perform the call indirectly through the {schedule}\\n     * & {execute} workflow.\\n     *\\n     * This function is usually called by the targeted contract to control immediate execution of restricted functions.\\n     * Therefore we only return true if the call can be performed without any delay. If the call is subject to a\\n     * previously set delay (not zero), then the function should return false and the caller should schedule the operation\\n     * for future execution.\\n     *\\n     * If `immediate` is true, the delay can be disregarded and the operation can be immediately executed, otherwise\\n     * the operation can be executed if and only if delay is greater than 0.\\n     *\\n     * NOTE: The IAuthority interface does not include the `uint32` delay. This is an extension of that interface that\\n     * is backward compatible. Some contracts may thus ignore the second return argument. In that case they will fail\\n     * to identify the indirect workflow, and will consider calls that require a delay to be forbidden.\\n     *\\n     * NOTE: This function does not report the permissions of the admin functions in the manager itself. These are defined by the\\n     * {AccessManager} documentation.\\n     */\\n    function canCall(\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) external view returns (bool allowed, uint32 delay);\\n\\n    /**\\n     * @dev Expiration delay for scheduled proposals. Defaults to 1 week.\\n     *\\n     * IMPORTANT: Avoid overriding the expiration with 0. Otherwise every contract proposal will be expired immediately,\\n     * disabling any scheduling usage.\\n     */\\n    function expiration() external view returns (uint32);\\n\\n    /**\\n     * @dev Minimum setback for all delay updates, with the exception of execution delays. It\\n     * can be increased without setback (and reset via {revokeRole} in the case event of an\\n     * accidental increase). Defaults to 5 days.\\n     */\\n    function minSetback() external view returns (uint32);\\n\\n    /**\\n     * @dev Get whether the contract is closed disabling any access. Otherwise role permissions are applied.\\n     *\\n     * NOTE: When the manager itself is closed, admin functions are still accessible to avoid locking the contract.\\n     */\\n    function isTargetClosed(address target) external view returns (bool);\\n\\n    /**\\n     * @dev Get the role required to call a function.\\n     */\\n    function getTargetFunctionRole(address target, bytes4 selector) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the admin delay for a target contract. Changes to contract configuration are subject to this delay.\\n     */\\n    function getTargetAdminDelay(address target) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the id of the role that acts as an admin for the given role.\\n     *\\n     * The admin permission is required to grant the role, revoke the role and update the execution delay to execute\\n     * an operation that is restricted to this role.\\n     */\\n    function getRoleAdmin(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role that acts as a guardian for a given role.\\n     *\\n     * The guardian permission allows canceling operations that have been scheduled under the role.\\n     */\\n    function getRoleGuardian(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role current grant delay.\\n     *\\n     * Its value may change at any point without an event emitted following a call to {setGrantDelay}.\\n     * Changes to this value, including effect timepoint are notified in advance by the {RoleGrantDelayChanged} event.\\n     */\\n    function getRoleGrantDelay(uint64 roleId) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the access details for a given account for a given role. These details include the timepoint at which\\n     * membership becomes active, and the delay applied to all operation by this user that requires this permission\\n     * level.\\n     *\\n     * Returns:\\n     * [0] Timestamp at which the account membership becomes valid. 0 means role is not granted.\\n     * [1] Current execution delay for the account.\\n     * [2] Pending execution delay for the account.\\n     * [3] Timestamp at which the pending execution delay will become active. 0 means no delay update is scheduled.\\n     */\\n    function getAccess(\\n        uint64 roleId,\\n        address account\\n    ) external view returns (uint48 since, uint32 currentDelay, uint32 pendingDelay, uint48 effect);\\n\\n    /**\\n     * @dev Check if a given account currently has the permission level corresponding to a given role. Note that this\\n     * permission might be associated with an execution delay. {getAccess} can provide more details.\\n     */\\n    function hasRole(uint64 roleId, address account) external view returns (bool isMember, uint32 executionDelay);\\n\\n    /**\\n     * @dev Give a label to a role, for improved role discoverability by UIs.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleLabel} event.\\n     */\\n    function labelRole(uint64 roleId, string calldata label) external;\\n\\n    /**\\n     * @dev Add `account` to `roleId`, or change its execution delay.\\n     *\\n     * This gives the account the authorization to call any function that is restricted to this role. An optional\\n     * execution delay (in seconds) can be set. If that delay is non 0, the user is required to schedule any operation\\n     * that is restricted to members of this role. The user will only be able to execute the operation after the delay has\\n     * passed, before it has expired. During this period, admin and guardians can cancel the operation (see {cancel}).\\n     *\\n     * If the account has already been granted this role, the execution delay will be updated. This update is not\\n     * immediate and follows the delay rules. For example, if a user currently has a delay of 3 hours, and this is\\n     * called to reduce that delay to 1 hour, the new delay will take some time to take effect, enforcing that any\\n     * operation executed in the 3 hours that follows this update was indeed scheduled before this update.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - granted role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleGranted} event.\\n     */\\n    function grantRole(uint64 roleId, address account, uint32 executionDelay) external;\\n\\n    /**\\n     * @dev Remove an account from a role, with immediate effect. If the account does not have the role, this call has\\n     * no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - revoked role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function revokeRole(uint64 roleId, address account) external;\\n\\n    /**\\n     * @dev Renounce role permissions for the calling account with immediate effect. If the sender is not in\\n     * the role this call has no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be `callerConfirmation`.\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function renounceRole(uint64 roleId, address callerConfirmation) external;\\n\\n    /**\\n     * @dev Change admin role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleAdminChanged} event\\n     */\\n    function setRoleAdmin(uint64 roleId, uint64 admin) external;\\n\\n    /**\\n     * @dev Change guardian role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGuardianChanged} event\\n     */\\n    function setRoleGuardian(uint64 roleId, uint64 guardian) external;\\n\\n    /**\\n     * @dev Update the delay for granting a `roleId`.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGrantDelayChanged} event.\\n     */\\n    function setGrantDelay(uint64 roleId, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the role required to call functions identified by the `selectors` in the `target` contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetFunctionRoleUpdated} event per selector.\\n     */\\n    function setTargetFunctionRole(address target, bytes4[] calldata selectors, uint64 roleId) external;\\n\\n    /**\\n     * @dev Set the delay for changing the configuration of a given target contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetAdminDelayUpdated} event.\\n     */\\n    function setTargetAdminDelay(address target, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the closed flag for a contract.\\n     *\\n     * Closing the manager itself won't disable access to admin methods to avoid locking the contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetClosed} event.\\n     */\\n    function setTargetClosed(address target, bool closed) external;\\n\\n    /**\\n     * @dev Return the timepoint at which a scheduled operation will be ready for execution. This returns 0 if the\\n     * operation is not yet scheduled, has expired, was executed, or was canceled.\\n     */\\n    function getSchedule(bytes32 id) external view returns (uint48);\\n\\n    /**\\n     * @dev Return the nonce for the latest scheduled operation with a given id. Returns 0 if the operation has never\\n     * been scheduled.\\n     */\\n    function getNonce(bytes32 id) external view returns (uint32);\\n\\n    /**\\n     * @dev Schedule a delayed operation for future execution, and return the operation identifier. It is possible to\\n     * choose the timestamp at which the operation becomes executable as long as it satisfies the execution delays\\n     * required for the caller. The special value zero will automatically set the earliest possible time.\\n     *\\n     * Returns the `operationId` that was scheduled. Since this value is a hash of the parameters, it can reoccur when\\n     * the same parameters are used; if this is relevant, the returned `nonce` can be used to uniquely identify this\\n     * scheduled operation from other occurrences of the same `operationId` in invocations of {execute} and {cancel}.\\n     *\\n     * Emits a {OperationScheduled} event.\\n     *\\n     * NOTE: It is not possible to concurrently schedule more than one operation with the same `target` and `data`. If\\n     * this is necessary, a random byte can be appended to `data` to act as a salt that will be ignored by the target\\n     * contract if it is using standard Solidity ABI encoding.\\n     */\\n    function schedule(\\n        address target,\\n        bytes calldata data,\\n        uint48 when\\n    ) external returns (bytes32 operationId, uint32 nonce);\\n\\n    /**\\n     * @dev Execute a function that is delay restricted, provided it was properly scheduled beforehand, or the\\n     * execution delay is 0.\\n     *\\n     * Returns the nonce that identifies the previously scheduled operation that is executed, or 0 if the\\n     * operation wasn't previously scheduled (if the caller doesn't have an execution delay).\\n     *\\n     * Emits an {OperationExecuted} event only if the call was scheduled and delayed.\\n     */\\n    function execute(address target, bytes calldata data) external payable returns (uint32);\\n\\n    /**\\n     * @dev Cancel a scheduled (delayed) operation. Returns the nonce that identifies the previously scheduled\\n     * operation that is cancelled.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be the proposer, a guardian of the targeted function, or a global admin\\n     *\\n     * Emits a {OperationCanceled} event.\\n     */\\n    function cancel(address caller, address target, bytes calldata data) external returns (uint32);\\n\\n    /**\\n     * @dev Consume a scheduled operation targeting the caller. If such an operation exists, mark it as consumed\\n     * (emit an {OperationExecuted} event and clean the state). Otherwise, throw an error.\\n     *\\n     * This is useful for contract that want to enforce that calls targeting them were scheduled on the manager,\\n     * with all the verifications that it implies.\\n     *\\n     * Emit a {OperationExecuted} event.\\n     */\\n    function consumeScheduledOp(address caller, bytes calldata data) external;\\n\\n    /**\\n     * @dev Hashing function for delayed operations.\\n     */\\n    function hashOperation(address caller, address target, bytes calldata data) external view returns (bytes32);\\n\\n    /**\\n     * @dev Changes the authority of a target managed by this manager instance.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     */\\n    function updateAuthority(address target, address newAuthority) external;\\n}\\n\",\"keccak256\":\"0x9be2d08a326515805bc9cf6315b7953f8d1ebe88abf48c2d645fb1fa8211a0e2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAuthority.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAuthority.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Standard interface for permissioning originally defined in Dappsys.\\n */\\ninterface IAuthority {\\n    /**\\n     * @dev Returns true if the caller can invoke on a target the function identified by a function selector.\\n     */\\n    function canCall(address caller, address target, bytes4 selector) external view returns (bool allowed);\\n}\\n\",\"keccak256\":\"0x4cc0766bd7fb7b3bafb70afa2a93b6e313a0baec7a35ad1b57505be7861c1030\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC1363.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1363.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"./IERC20.sol\\\";\\nimport {IERC165} from \\\"./IERC165.sol\\\";\\n\\n/**\\n * @title IERC1363\\n * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].\\n *\\n * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract\\n * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.\\n */\\ninterface IERC1363 is IERC20, IERC165 {\\n    /*\\n     * Note: the ERC-165 identifier for this interface is 0xb0202a11.\\n     * 0xb0202a11 ===\\n     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))\\n     */\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @param data Additional data with no specified format, sent in call to `spender`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);\\n}\\n\",\"keccak256\":\"0x9b6b3e7803bc5f2f8cd7ad57db8ac1def61a9930a5a3107df4882e028a9605d7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC165} from \\\"../utils/introspection/IERC165.sol\\\";\\n\",\"keccak256\":\"0xde7e9fd9aee8d4f40772f96bb3b58836cbc6dfc0227014a061947f8821ea9724\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../token/ERC20/IERC20.sol\\\";\\n\",\"keccak256\":\"0xce41876e78d1badc0512229b4d14e4daf83bc1003d7f83978d18e0e56f965b9c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashBorrower.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashBorrower, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashBorrower {\\n    /**\\n     * @dev Receive a flash loan.\\n     * @param initiator The initiator of the loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param fee The additional amount of tokens to repay.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     * @return The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\\n     */\\n    function onFlashLoan(\\n        address initiator,\\n        address token,\\n        uint256 amount,\\n        uint256 fee,\\n        bytes calldata data\\n    ) external returns (bytes32);\\n}\\n\",\"keccak256\":\"0x0b1459615b9b47c2a4eec8e72f23ccc601f1d711f679a1c06b3390459021a341\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashLender.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC3156FlashBorrower} from \\\"./IERC3156FlashBorrower.sol\\\";\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashLender, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashLender {\\n    /**\\n     * @dev The amount of currency available to be lended.\\n     * @param token The loan currency.\\n     * @return The amount of `token` that can be borrowed.\\n     */\\n    function maxFlashLoan(address token) external view returns (uint256);\\n\\n    /**\\n     * @dev The fee to be charged for a given loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @return The amount of `token` to be charged for the loan, on top of the returned principal.\\n     */\\n    function flashFee(address token, uint256 amount) external view returns (uint256);\\n\\n    /**\\n     * @dev Initiate a flash loan.\\n     * @param receiver The receiver of the tokens in the loan, and the receiver of the callback.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     */\\n    function flashLoan(\\n        IERC3156FlashBorrower receiver,\\n        address token,\\n        uint256 amount,\\n        bytes calldata data\\n    ) external returns (bool);\\n}\\n\",\"keccak256\":\"0x5d19ea24c555cf6a5dbafea9fac57887cc3e72154f3ee8e0a2bf67971811c14b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-20 standard as defined in the ERC.\\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 value of tokens in existence.\\n     */\\n    function totalSupply() external view returns (uint256);\\n\\n    /**\\n     * @dev Returns the value of tokens owned by `account`.\\n     */\\n    function balanceOf(address account) external view returns (uint256);\\n\\n    /**\\n     * @dev Moves a `value` amount of 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 value) 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 a `value` amount of tokens as the allowance of `spender` over the\\n     * 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 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the\\n     * allowance mechanism. `value` 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 value) external returns (bool);\\n}\\n\",\"keccak256\":\"0xe06a3f08a987af6ad2e1c1e774405d4fe08f1694b67517438b467cecf0da0ef7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC-20 standard.\\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\",\"keccak256\":\"0x70f2f713b13b7ce4610bcd0ac9fec0f3cc43693b043abcb8dc40a42a726eb330\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.2.0) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\nimport {IERC1363} from \\\"../../../interfaces/IERC1363.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC-20 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    /**\\n     * @dev An operation with an ERC-20 token failed.\\n     */\\n    error SafeERC20FailedOperation(address token);\\n\\n    /**\\n     * @dev Indicates a failed `decreaseAllowance` request.\\n     */\\n    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);\\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.encodeCall(token.transfer, (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.encodeCall(token.transferFrom, (from, to, 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     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n        uint256 oldAllowance = token.allowance(address(this), spender);\\n        forceApprove(token, spender, oldAllowance + value);\\n    }\\n\\n    /**\\n     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no\\n     * value, non-reverting calls are assumed to be successful.\\n     *\\n     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {\\n        unchecked {\\n            uint256 currentAllowance = token.allowance(address(this), spender);\\n            if (currentAllowance < requestedDecrease) {\\n                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);\\n            }\\n            forceApprove(token, spender, currentAllowance - requestedDecrease);\\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     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function\\n     * only sets the \\\"standard\\\" allowance. Any temporary allowance will remain active, in addition to the value being\\n     * set here.\\n     */\\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));\\n\\n        if (!_callOptionalReturnBool(token, approvalCall)) {\\n            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));\\n            _callOptionalReturn(token, approvalCall);\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            safeTransfer(token, to, value);\\n        } else if (!token.transferAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target\\n     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferFromAndCallRelaxed(\\n        IERC1363 token,\\n        address from,\\n        address to,\\n        uint256 value,\\n        bytes memory data\\n    ) internal {\\n        if (to.code.length == 0) {\\n            safeTransferFrom(token, from, to, value);\\n        } else if (!token.transferFromAndCall(from, to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.\\n     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}\\n     * once without retrying, and relies on the returned value to be true.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            forceApprove(token, to, value);\\n        } else if (!token.approveAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.\\n     */\\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            // bubble errors\\n            if iszero(success) {\\n                let ptr := mload(0x40)\\n                returndatacopy(ptr, 0, returndatasize())\\n                revert(ptr, returndatasize())\\n            }\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n\\n        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.\\n     */\\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n        bool success;\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\\n    }\\n}\\n\",\"keccak256\":\"0x4ea01544758fd2c7045961904686bfe232d2220a04ecaa2d6b08dac17827febf\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)\\n\\npragma solidity ^0.8.20;\\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\",\"keccak256\":\"0x493033a8d1b176a037b2cc6a04dad01a5c157722049bbecf632ca876224dd4b2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Panic.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Helper library for emitting standardized panic codes.\\n *\\n * ```solidity\\n * contract Example {\\n *      using Panic for uint256;\\n *\\n *      // Use any of the declared internal constants\\n *      function foo() { Panic.GENERIC.panic(); }\\n *\\n *      // Alternatively\\n *      function foo() { Panic.panic(Panic.GENERIC); }\\n * }\\n * ```\\n *\\n * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].\\n *\\n * _Available since v5.1._\\n */\\n// slither-disable-next-line unused-state\\nlibrary Panic {\\n    /// @dev generic / unspecified error\\n    uint256 internal constant GENERIC = 0x00;\\n    /// @dev used by the assert() builtin\\n    uint256 internal constant ASSERT = 0x01;\\n    /// @dev arithmetic underflow or overflow\\n    uint256 internal constant UNDER_OVERFLOW = 0x11;\\n    /// @dev division or modulo by zero\\n    uint256 internal constant DIVISION_BY_ZERO = 0x12;\\n    /// @dev enum conversion error\\n    uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;\\n    /// @dev invalid encoding in storage\\n    uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;\\n    /// @dev empty array pop\\n    uint256 internal constant EMPTY_ARRAY_POP = 0x31;\\n    /// @dev array out of bounds access\\n    uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;\\n    /// @dev resource error (too large allocation or too large array)\\n    uint256 internal constant RESOURCE_ERROR = 0x41;\\n    /// @dev calling invalid internal function\\n    uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;\\n\\n    /// @dev Reverts with a panic code. Recommended to use with\\n    /// the internal constants with predefined codes.\\n    function panic(uint256 code) internal pure {\\n        assembly (\\\"memory-safe\\\") {\\n            mstore(0x00, 0x4e487b71)\\n            mstore(0x20, code)\\n            revert(0x1c, 0x24)\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0xf7fe324703a64fc51702311dc51562d5cb1497734f074e4f483bfb6717572d7a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[ERC].\\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[ERC 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\",\"keccak256\":\"0x79796192ec90263f21b464d5bc90b777a525971d3de8232be80d9c4f9fb353b8\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Panic} from \\\"../Panic.sol\\\";\\nimport {SafeCast} from \\\"./SafeCast.sol\\\";\\n\\n/**\\n * @dev Standard math utilities missing in the Solidity language.\\n */\\nlibrary Math {\\n    enum Rounding {\\n        Floor, // Toward negative infinity\\n        Ceil, // Toward positive infinity\\n        Trunc, // Toward zero\\n        Expand // Away from zero\\n    }\\n\\n    /**\\n     * @dev Returns the addition of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            uint256 c = a + b;\\n            if (c < a) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b > a) return (false, 0);\\n            return (true, a - b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n            // benefit is lost if 'b' is also tested.\\n            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n            if (a == 0) return (true, 0);\\n            uint256 c = a * b;\\n            if (c / a != b) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the division of two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a / b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a % b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.\\n     *\\n     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.\\n     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute\\n     * one branch when needed, making this function more expensive.\\n     */\\n    function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {\\n        unchecked {\\n            // branchless ternary works because:\\n            // b ^ (a ^ b) == a\\n            // b ^ 0 == b\\n            return b ^ ((a ^ b) * SafeCast.toUint(condition));\\n        }\\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 ternary(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 ternary(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 towards infinity instead\\n     * of rounding towards zero.\\n     */\\n    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\\n        if (b == 0) {\\n            // Guarantee the same behavior as in a regular Solidity division.\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n\\n        // The following calculation ensures accurate ceiling division without overflow.\\n        // Since a is non-zero, (a - 1) / b will not overflow.\\n        // The largest possible result occurs when (a - 1) / b is type(uint256).max,\\n        // but the largest value we can obtain is type(uint256).max - 1, which happens\\n        // when a = type(uint256).max and b = 1.\\n        unchecked {\\n            return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);\\n        }\\n    }\\n\\n    /**\\n     * @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or\\n     * denominator == 0.\\n     *\\n     * Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by\\n     * 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\\u00b2\\u2075\\u2076 and mod 2\\u00b2\\u2075\\u2076 - 1, then use\\n            // the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\\n            // variables such that product = prod1 * 2\\u00b2\\u2075\\u2076 + prod0.\\n            uint256 prod0 = x * y; // 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                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\\u00b2\\u2075\\u2076. Also prevents denominator == 0.\\n            if (denominator <= prod1) {\\n                Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));\\n            }\\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.\\n            // Always >= 1. See https://cs.stackexchange.com/q/138556/92363.\\n\\n            uint256 twos = denominator & (0 - denominator);\\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\\u00b2\\u2075\\u2076 / 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\\u00b2\\u2075\\u2076. Now that denominator is an odd number, it has an inverse modulo 2\\u00b2\\u2075\\u2076 such\\n            // that denominator * inv \\u2261 1 mod 2\\u00b2\\u2075\\u2076. Compute the inverse by starting with a seed that is correct for\\n            // four bits. That is, denominator * inv \\u2261 1 mod 2\\u2074.\\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\\n            // works in modular arithmetic, doubling the correct bits in each step.\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u2076\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b3\\u00b2\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2076\\u2074\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u00b2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b2\\u2075\\u2076\\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\\u00b2\\u2075\\u2076. Since the preconditions guarantee that the outcome is\\n            // less than 2\\u00b2\\u2075\\u2076, 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     * @dev 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        return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);\\n    }\\n\\n    /**\\n     * @dev Calculate the modular multiplicative inverse of a number in Z/nZ.\\n     *\\n     * If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.\\n     * If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.\\n     *\\n     * If the input value is not inversible, 0 is returned.\\n     *\\n     * NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the\\n     * inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.\\n     */\\n    function invMod(uint256 a, uint256 n) internal pure returns (uint256) {\\n        unchecked {\\n            if (n == 0) return 0;\\n\\n            // The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)\\n            // Used to compute integers x and y such that: ax + ny = gcd(a, n).\\n            // When the gcd is 1, then the inverse of a modulo n exists and it's x.\\n            // ax + ny = 1\\n            // ax = 1 + (-y)n\\n            // ax \\u2261 1 (mod n) # x is the inverse of a modulo n\\n\\n            // If the remainder is 0 the gcd is n right away.\\n            uint256 remainder = a % n;\\n            uint256 gcd = n;\\n\\n            // Therefore the initial coefficients are:\\n            // ax + ny = gcd(a, n) = n\\n            // 0a + 1n = n\\n            int256 x = 0;\\n            int256 y = 1;\\n\\n            while (remainder != 0) {\\n                uint256 quotient = gcd / remainder;\\n\\n                (gcd, remainder) = (\\n                    // The old remainder is the next gcd to try.\\n                    remainder,\\n                    // Compute the next remainder.\\n                    // Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd\\n                    // where gcd is at most n (capped to type(uint256).max)\\n                    gcd - remainder * quotient\\n                );\\n\\n                (x, y) = (\\n                    // Increment the coefficient of a.\\n                    y,\\n                    // Decrement the coefficient of n.\\n                    // Can overflow, but the result is casted to uint256 so that the\\n                    // next value of y is \\\"wrapped around\\\" to a value between 0 and n - 1.\\n                    x - y * int256(quotient)\\n                );\\n            }\\n\\n            if (gcd != 1) return 0; // No inverse exists.\\n            return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.\\n     *\\n     * From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is\\n     * prime, then `a**(p-1) \\u2261 1 mod p`. As a consequence, we have `a * a**(p-2) \\u2261 1 mod p`, which means that\\n     * `a**(p-2)` is the modular multiplicative inverse of a in Fp.\\n     *\\n     * NOTE: this function does NOT check that `p` is a prime greater than `2`.\\n     */\\n    function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {\\n        unchecked {\\n            return Math.modExp(a, p - 2, p);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)\\n     *\\n     * Requirements:\\n     * - modulus can't be zero\\n     * - underlying staticcall to precompile must succeed\\n     *\\n     * IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make\\n     * sure the chain you're using it on supports the precompiled contract for modular exponentiation\\n     * at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,\\n     * the underlying function will succeed given the lack of a revert, but the result may be incorrectly\\n     * interpreted as 0.\\n     */\\n    function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {\\n        (bool success, uint256 result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).\\n     * It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying\\n     * to operate modulo 0 or if the underlying precompile reverted.\\n     *\\n     * IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain\\n     * you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in\\n     * https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack\\n     * of a revert, but the result may be incorrectly interpreted as 0.\\n     */\\n    function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {\\n        if (m == 0) return (false, 0);\\n        assembly (\\\"memory-safe\\\") {\\n            let ptr := mload(0x40)\\n            // | Offset    | Content    | Content (Hex)                                                      |\\n            // |-----------|------------|--------------------------------------------------------------------|\\n            // | 0x00:0x1f | size of b  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x20:0x3f | size of e  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x40:0x5f | size of m  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x60:0x7f | value of b | 0x<.............................................................b> |\\n            // | 0x80:0x9f | value of e | 0x<.............................................................e> |\\n            // | 0xa0:0xbf | value of m | 0x<.............................................................m> |\\n            mstore(ptr, 0x20)\\n            mstore(add(ptr, 0x20), 0x20)\\n            mstore(add(ptr, 0x40), 0x20)\\n            mstore(add(ptr, 0x60), b)\\n            mstore(add(ptr, 0x80), e)\\n            mstore(add(ptr, 0xa0), m)\\n\\n            // Given the result < m, it's guaranteed to fit in 32 bytes,\\n            // so we can use the memory scratch space located at offset 0.\\n            success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)\\n            result := mload(0x00)\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {modExp} that supports inputs of arbitrary length.\\n     */\\n    function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {\\n        (bool success, bytes memory result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Variant of {tryModExp} that supports inputs of arbitrary length.\\n     */\\n    function tryModExp(\\n        bytes memory b,\\n        bytes memory e,\\n        bytes memory m\\n    ) internal view returns (bool success, bytes memory result) {\\n        if (_zeroBytes(m)) return (false, new bytes(0));\\n\\n        uint256 mLen = m.length;\\n\\n        // Encode call args in result and move the free memory pointer\\n        result = abi.encodePacked(b.length, e.length, mLen, b, e, m);\\n\\n        assembly (\\\"memory-safe\\\") {\\n            let dataPtr := add(result, 0x20)\\n            // Write result on top of args to avoid allocating extra memory.\\n            success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)\\n            // Overwrite the length.\\n            // result.length > returndatasize() is guaranteed because returndatasize() == m.length\\n            mstore(result, mLen)\\n            // Set the memory pointer after the returned data.\\n            mstore(0x40, add(dataPtr, mLen))\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether the provided byte array is zero.\\n     */\\n    function _zeroBytes(bytes memory byteArray) private pure returns (bool) {\\n        for (uint256 i = 0; i < byteArray.length; ++i) {\\n            if (byteArray[i] != 0) {\\n                return false;\\n            }\\n        }\\n        return true;\\n    }\\n\\n    /**\\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded\\n     * towards zero.\\n     *\\n     * This method is based on Newton's method for computing square roots; the algorithm is restricted to only\\n     * using integer operations.\\n     */\\n    function sqrt(uint256 a) internal pure returns (uint256) {\\n        unchecked {\\n            // Take care of easy edge cases when a == 0 or a == 1\\n            if (a <= 1) {\\n                return a;\\n            }\\n\\n            // In this function, we use Newton's method to get a root of `f(x) := x\\u00b2 - a`. It involves building a\\n            // sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between\\n            // the current value as `\\u03b5_n = | x_n - sqrt(a) |`.\\n            //\\n            // For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root\\n            // of the target. (i.e. `2**(e-1) \\u2264 sqrt(a) < 2**e`). We know that `e \\u2264 128` because `(2\\u00b9\\u00b2\\u2078)\\u00b2 = 2\\u00b2\\u2075\\u2076` is\\n            // bigger than any uint256.\\n            //\\n            // By noticing that\\n            // `2**(e-1) \\u2264 sqrt(a) < 2**e \\u2192 (2**(e-1))\\u00b2 \\u2264 a < (2**e)\\u00b2 \\u2192 2**(2*e-2) \\u2264 a < 2**(2*e)`\\n            // we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar\\n            // to the msb function.\\n            uint256 aa = a;\\n            uint256 xn = 1;\\n\\n            if (aa >= (1 << 128)) {\\n                aa >>= 128;\\n                xn <<= 64;\\n            }\\n            if (aa >= (1 << 64)) {\\n                aa >>= 64;\\n                xn <<= 32;\\n            }\\n            if (aa >= (1 << 32)) {\\n                aa >>= 32;\\n                xn <<= 16;\\n            }\\n            if (aa >= (1 << 16)) {\\n                aa >>= 16;\\n                xn <<= 8;\\n            }\\n            if (aa >= (1 << 8)) {\\n                aa >>= 8;\\n                xn <<= 4;\\n            }\\n            if (aa >= (1 << 4)) {\\n                aa >>= 4;\\n                xn <<= 2;\\n            }\\n            if (aa >= (1 << 2)) {\\n                xn <<= 1;\\n            }\\n\\n            // We now have x_n such that `x_n = 2**(e-1) \\u2264 sqrt(a) < 2**e = 2 * x_n`. This implies \\u03b5_n \\u2264 2**(e-1).\\n            //\\n            // We can refine our estimation by noticing that the middle of that interval minimizes the error.\\n            // If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to \\u03b5_n \\u2264 2**(e-2).\\n            // This is going to be our x_0 (and \\u03b5_0)\\n            xn = (3 * xn) >> 1; // \\u03b5_0 := | x_0 - sqrt(a) | \\u2264 2**(e-2)\\n\\n            // From here, Newton's method give us:\\n            // x_{n+1} = (x_n + a / x_n) / 2\\n            //\\n            // One should note that:\\n            // x_{n+1}\\u00b2 - a = ((x_n + a / x_n) / 2)\\u00b2 - a\\n            //              = ((x_n\\u00b2 + a) / (2 * x_n))\\u00b2 - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2) - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2 - 4 * a * x_n\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u2074 - 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u00b2 - a)\\u00b2 / (2 * x_n)\\u00b2\\n            //              = ((x_n\\u00b2 - a) / (2 * x_n))\\u00b2\\n            //              \\u2265 0\\n            // Which proves that for all n \\u2265 1, sqrt(a) \\u2264 x_n\\n            //\\n            // This gives us the proof of quadratic convergence of the sequence:\\n            // \\u03b5_{n+1} = | x_{n+1} - sqrt(a) |\\n            //         = | (x_n + a / x_n) / 2 - sqrt(a) |\\n            //         = | (x_n\\u00b2 + a - 2*x_n*sqrt(a)) / (2 * x_n) |\\n            //         = | (x_n - sqrt(a))\\u00b2 / (2 * x_n) |\\n            //         = | \\u03b5_n\\u00b2 / (2 * x_n) |\\n            //         = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //\\n            // For the first iteration, we have a special case where x_0 is known:\\n            // \\u03b5_1 = \\u03b5_0\\u00b2 / | (2 * x_0) |\\n            //     \\u2264 (2**(e-2))\\u00b2 / (2 * (2**(e-1) + 2**(e-2)))\\n            //     \\u2264 2**(2*e-4) / (3 * 2**(e-1))\\n            //     \\u2264 2**(e-3) / 3\\n            //     \\u2264 2**(e-3-log2(3))\\n            //     \\u2264 2**(e-4.5)\\n            //\\n            // For the following iterations, we use the fact that, 2**(e-1) \\u2264 sqrt(a) \\u2264 x_n:\\n            // \\u03b5_{n+1} = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //         \\u2264 (2**(e-k))\\u00b2 / (2 * 2**(e-1))\\n            //         \\u2264 2**(2*e-2*k) / 2**e\\n            //         \\u2264 2**(e-2*k)\\n            xn = (xn + a / xn) >> 1; // \\u03b5_1 := | x_1 - sqrt(a) | \\u2264 2**(e-4.5)  -- special case, see above\\n            xn = (xn + a / xn) >> 1; // \\u03b5_2 := | x_2 - sqrt(a) | \\u2264 2**(e-9)    -- general case with k = 4.5\\n            xn = (xn + a / xn) >> 1; // \\u03b5_3 := | x_3 - sqrt(a) | \\u2264 2**(e-18)   -- general case with k = 9\\n            xn = (xn + a / xn) >> 1; // \\u03b5_4 := | x_4 - sqrt(a) | \\u2264 2**(e-36)   -- general case with k = 18\\n            xn = (xn + a / xn) >> 1; // \\u03b5_5 := | x_5 - sqrt(a) | \\u2264 2**(e-72)   -- general case with k = 36\\n            xn = (xn + a / xn) >> 1; // \\u03b5_6 := | x_6 - sqrt(a) | \\u2264 2**(e-144)  -- general case with k = 72\\n\\n            // Because e \\u2264 128 (as discussed during the first estimation phase), we know have reached a precision\\n            // \\u03b5_6 \\u2264 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either\\n            // sqrt(a) or sqrt(a) + 1.\\n            return xn - SafeCast.toUint(xn > a / xn);\\n        }\\n    }\\n\\n    /**\\n     * @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 2 of a positive value rounded towards zero.\\n     * Returns 0 if given 0.\\n     */\\n    function log2(uint256 value) internal pure returns (uint256) {\\n        uint256 result = 0;\\n        uint256 exp;\\n        unchecked {\\n            exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            result += SafeCast.toUint(value > 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 10 of a positive value rounded towards zero.\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 256 of a positive value rounded towards zero.\\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        uint256 isGt;\\n        unchecked {\\n            isGt = SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= isGt * 128;\\n            result += isGt * 16;\\n\\n            isGt = SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= isGt * 64;\\n            result += isGt * 8;\\n\\n            isGt = SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= isGt * 32;\\n            result += isGt * 4;\\n\\n            isGt = SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= isGt * 16;\\n            result += isGt * 2;\\n\\n            result += SafeCast.toUint(value > (1 << 8) - 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.\\n     */\\n    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {\\n        return uint8(rounding) % 2 == 1;\\n    }\\n}\\n\",\"keccak256\":\"0xa00be322d7db5786750ce0ac7e2f5b633ac30a5ed5fa1ced1e74acfc19acecea\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeCast.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)\\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow\\n * checks.\\n *\\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\\n * easily result in undesired exploitation or bugs, since developers usually\\n * assume that overflows raise errors. `SafeCast` restores this intuition by\\n * reverting the transaction when such an operation overflows.\\n *\\n * Using this library instead of the unchecked operations eliminates an entire\\n * class of bugs, so it's recommended to use it always.\\n */\\nlibrary SafeCast {\\n    /**\\n     * @dev Value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);\\n\\n    /**\\n     * @dev An int value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedIntToUint(int256 value);\\n\\n    /**\\n     * @dev Value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);\\n\\n    /**\\n     * @dev An uint value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedUintToInt(uint256 value);\\n\\n    /**\\n     * @dev Returns the downcasted uint248 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint248).\\n     *\\n     * Counterpart to Solidity's `uint248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toUint248(uint256 value) internal pure returns (uint248) {\\n        if (value > type(uint248).max) {\\n            revert SafeCastOverflowedUintDowncast(248, value);\\n        }\\n        return uint248(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint240 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint240).\\n     *\\n     * Counterpart to Solidity's `uint240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toUint240(uint256 value) internal pure returns (uint240) {\\n        if (value > type(uint240).max) {\\n            revert SafeCastOverflowedUintDowncast(240, value);\\n        }\\n        return uint240(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint232 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint232).\\n     *\\n     * Counterpart to Solidity's `uint232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toUint232(uint256 value) internal pure returns (uint232) {\\n        if (value > type(uint232).max) {\\n            revert SafeCastOverflowedUintDowncast(232, value);\\n        }\\n        return uint232(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint224 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint224).\\n     *\\n     * Counterpart to Solidity's `uint224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toUint224(uint256 value) internal pure returns (uint224) {\\n        if (value > type(uint224).max) {\\n            revert SafeCastOverflowedUintDowncast(224, value);\\n        }\\n        return uint224(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint216 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint216).\\n     *\\n     * Counterpart to Solidity's `uint216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toUint216(uint256 value) internal pure returns (uint216) {\\n        if (value > type(uint216).max) {\\n            revert SafeCastOverflowedUintDowncast(216, value);\\n        }\\n        return uint216(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint208 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint208).\\n     *\\n     * Counterpart to Solidity's `uint208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toUint208(uint256 value) internal pure returns (uint208) {\\n        if (value > type(uint208).max) {\\n            revert SafeCastOverflowedUintDowncast(208, value);\\n        }\\n        return uint208(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint200 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint200).\\n     *\\n     * Counterpart to Solidity's `uint200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toUint200(uint256 value) internal pure returns (uint200) {\\n        if (value > type(uint200).max) {\\n            revert SafeCastOverflowedUintDowncast(200, value);\\n        }\\n        return uint200(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint192 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint192).\\n     *\\n     * Counterpart to Solidity's `uint192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toUint192(uint256 value) internal pure returns (uint192) {\\n        if (value > type(uint192).max) {\\n            revert SafeCastOverflowedUintDowncast(192, value);\\n        }\\n        return uint192(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint184 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint184).\\n     *\\n     * Counterpart to Solidity's `uint184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toUint184(uint256 value) internal pure returns (uint184) {\\n        if (value > type(uint184).max) {\\n            revert SafeCastOverflowedUintDowncast(184, value);\\n        }\\n        return uint184(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint176 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint176).\\n     *\\n     * Counterpart to Solidity's `uint176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toUint176(uint256 value) internal pure returns (uint176) {\\n        if (value > type(uint176).max) {\\n            revert SafeCastOverflowedUintDowncast(176, value);\\n        }\\n        return uint176(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint168 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint168).\\n     *\\n     * Counterpart to Solidity's `uint168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toUint168(uint256 value) internal pure returns (uint168) {\\n        if (value > type(uint168).max) {\\n            revert SafeCastOverflowedUintDowncast(168, value);\\n        }\\n        return uint168(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint160 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint160).\\n     *\\n     * Counterpart to Solidity's `uint160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toUint160(uint256 value) internal pure returns (uint160) {\\n        if (value > type(uint160).max) {\\n            revert SafeCastOverflowedUintDowncast(160, value);\\n        }\\n        return uint160(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint152 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint152).\\n     *\\n     * Counterpart to Solidity's `uint152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toUint152(uint256 value) internal pure returns (uint152) {\\n        if (value > type(uint152).max) {\\n            revert SafeCastOverflowedUintDowncast(152, value);\\n        }\\n        return uint152(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint144 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint144).\\n     *\\n     * Counterpart to Solidity's `uint144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toUint144(uint256 value) internal pure returns (uint144) {\\n        if (value > type(uint144).max) {\\n            revert SafeCastOverflowedUintDowncast(144, value);\\n        }\\n        return uint144(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint136 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint136).\\n     *\\n     * Counterpart to Solidity's `uint136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toUint136(uint256 value) internal pure returns (uint136) {\\n        if (value > type(uint136).max) {\\n            revert SafeCastOverflowedUintDowncast(136, value);\\n        }\\n        return uint136(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint128 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint128).\\n     *\\n     * Counterpart to Solidity's `uint128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toUint128(uint256 value) internal pure returns (uint128) {\\n        if (value > type(uint128).max) {\\n            revert SafeCastOverflowedUintDowncast(128, value);\\n        }\\n        return uint128(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint120 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint120).\\n     *\\n     * Counterpart to Solidity's `uint120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toUint120(uint256 value) internal pure returns (uint120) {\\n        if (value > type(uint120).max) {\\n            revert SafeCastOverflowedUintDowncast(120, value);\\n        }\\n        return uint120(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint112 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint112).\\n     *\\n     * Counterpart to Solidity's `uint112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toUint112(uint256 value) internal pure returns (uint112) {\\n        if (value > type(uint112).max) {\\n            revert SafeCastOverflowedUintDowncast(112, value);\\n        }\\n        return uint112(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint104 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint104).\\n     *\\n     * Counterpart to Solidity's `uint104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toUint104(uint256 value) internal pure returns (uint104) {\\n        if (value > type(uint104).max) {\\n            revert SafeCastOverflowedUintDowncast(104, value);\\n        }\\n        return uint104(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint96 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint96).\\n     *\\n     * Counterpart to Solidity's `uint96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toUint96(uint256 value) internal pure returns (uint96) {\\n        if (value > type(uint96).max) {\\n            revert SafeCastOverflowedUintDowncast(96, value);\\n        }\\n        return uint96(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint88 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint88).\\n     *\\n     * Counterpart to Solidity's `uint88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toUint88(uint256 value) internal pure returns (uint88) {\\n        if (value > type(uint88).max) {\\n            revert SafeCastOverflowedUintDowncast(88, value);\\n        }\\n        return uint88(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint80 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint80).\\n     *\\n     * Counterpart to Solidity's `uint80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toUint80(uint256 value) internal pure returns (uint80) {\\n        if (value > type(uint80).max) {\\n            revert SafeCastOverflowedUintDowncast(80, value);\\n        }\\n        return uint80(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint72 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint72).\\n     *\\n     * Counterpart to Solidity's `uint72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toUint72(uint256 value) internal pure returns (uint72) {\\n        if (value > type(uint72).max) {\\n            revert SafeCastOverflowedUintDowncast(72, value);\\n        }\\n        return uint72(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint64 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint64).\\n     *\\n     * Counterpart to Solidity's `uint64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toUint64(uint256 value) internal pure returns (uint64) {\\n        if (value > type(uint64).max) {\\n            revert SafeCastOverflowedUintDowncast(64, value);\\n        }\\n        return uint64(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint56 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint56).\\n     *\\n     * Counterpart to Solidity's `uint56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toUint56(uint256 value) internal pure returns (uint56) {\\n        if (value > type(uint56).max) {\\n            revert SafeCastOverflowedUintDowncast(56, value);\\n        }\\n        return uint56(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint48 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint48).\\n     *\\n     * Counterpart to Solidity's `uint48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toUint48(uint256 value) internal pure returns (uint48) {\\n        if (value > type(uint48).max) {\\n            revert SafeCastOverflowedUintDowncast(48, value);\\n        }\\n        return uint48(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint40 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint40).\\n     *\\n     * Counterpart to Solidity's `uint40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toUint40(uint256 value) internal pure returns (uint40) {\\n        if (value > type(uint40).max) {\\n            revert SafeCastOverflowedUintDowncast(40, value);\\n        }\\n        return uint40(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint32 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint32).\\n     *\\n     * Counterpart to Solidity's `uint32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toUint32(uint256 value) internal pure returns (uint32) {\\n        if (value > type(uint32).max) {\\n            revert SafeCastOverflowedUintDowncast(32, value);\\n        }\\n        return uint32(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint24 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint24).\\n     *\\n     * Counterpart to Solidity's `uint24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toUint24(uint256 value) internal pure returns (uint24) {\\n        if (value > type(uint24).max) {\\n            revert SafeCastOverflowedUintDowncast(24, value);\\n        }\\n        return uint24(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint16 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint16).\\n     *\\n     * Counterpart to Solidity's `uint16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toUint16(uint256 value) internal pure returns (uint16) {\\n        if (value > type(uint16).max) {\\n            revert SafeCastOverflowedUintDowncast(16, value);\\n        }\\n        return uint16(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint8 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint8).\\n     *\\n     * Counterpart to Solidity's `uint8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toUint8(uint256 value) internal pure returns (uint8) {\\n        if (value > type(uint8).max) {\\n            revert SafeCastOverflowedUintDowncast(8, value);\\n        }\\n        return uint8(value);\\n    }\\n\\n    /**\\n     * @dev Converts a signed int256 into an unsigned uint256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be greater than or equal to 0.\\n     */\\n    function toUint256(int256 value) internal pure returns (uint256) {\\n        if (value < 0) {\\n            revert SafeCastOverflowedIntToUint(value);\\n        }\\n        return uint256(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int248 from int256, reverting on\\n     * overflow (when the input is less than smallest int248 or\\n     * greater than largest int248).\\n     *\\n     * Counterpart to Solidity's `int248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toInt248(int256 value) internal pure returns (int248 downcasted) {\\n        downcasted = int248(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(248, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int240 from int256, reverting on\\n     * overflow (when the input is less than smallest int240 or\\n     * greater than largest int240).\\n     *\\n     * Counterpart to Solidity's `int240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toInt240(int256 value) internal pure returns (int240 downcasted) {\\n        downcasted = int240(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(240, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int232 from int256, reverting on\\n     * overflow (when the input is less than smallest int232 or\\n     * greater than largest int232).\\n     *\\n     * Counterpart to Solidity's `int232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toInt232(int256 value) internal pure returns (int232 downcasted) {\\n        downcasted = int232(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(232, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int224 from int256, reverting on\\n     * overflow (when the input is less than smallest int224 or\\n     * greater than largest int224).\\n     *\\n     * Counterpart to Solidity's `int224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toInt224(int256 value) internal pure returns (int224 downcasted) {\\n        downcasted = int224(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(224, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int216 from int256, reverting on\\n     * overflow (when the input is less than smallest int216 or\\n     * greater than largest int216).\\n     *\\n     * Counterpart to Solidity's `int216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toInt216(int256 value) internal pure returns (int216 downcasted) {\\n        downcasted = int216(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(216, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int208 from int256, reverting on\\n     * overflow (when the input is less than smallest int208 or\\n     * greater than largest int208).\\n     *\\n     * Counterpart to Solidity's `int208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toInt208(int256 value) internal pure returns (int208 downcasted) {\\n        downcasted = int208(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(208, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int200 from int256, reverting on\\n     * overflow (when the input is less than smallest int200 or\\n     * greater than largest int200).\\n     *\\n     * Counterpart to Solidity's `int200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toInt200(int256 value) internal pure returns (int200 downcasted) {\\n        downcasted = int200(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(200, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int192 from int256, reverting on\\n     * overflow (when the input is less than smallest int192 or\\n     * greater than largest int192).\\n     *\\n     * Counterpart to Solidity's `int192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toInt192(int256 value) internal pure returns (int192 downcasted) {\\n        downcasted = int192(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(192, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int184 from int256, reverting on\\n     * overflow (when the input is less than smallest int184 or\\n     * greater than largest int184).\\n     *\\n     * Counterpart to Solidity's `int184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toInt184(int256 value) internal pure returns (int184 downcasted) {\\n        downcasted = int184(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(184, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int176 from int256, reverting on\\n     * overflow (when the input is less than smallest int176 or\\n     * greater than largest int176).\\n     *\\n     * Counterpart to Solidity's `int176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toInt176(int256 value) internal pure returns (int176 downcasted) {\\n        downcasted = int176(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(176, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int168 from int256, reverting on\\n     * overflow (when the input is less than smallest int168 or\\n     * greater than largest int168).\\n     *\\n     * Counterpart to Solidity's `int168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toInt168(int256 value) internal pure returns (int168 downcasted) {\\n        downcasted = int168(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(168, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int160 from int256, reverting on\\n     * overflow (when the input is less than smallest int160 or\\n     * greater than largest int160).\\n     *\\n     * Counterpart to Solidity's `int160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toInt160(int256 value) internal pure returns (int160 downcasted) {\\n        downcasted = int160(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(160, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int152 from int256, reverting on\\n     * overflow (when the input is less than smallest int152 or\\n     * greater than largest int152).\\n     *\\n     * Counterpart to Solidity's `int152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toInt152(int256 value) internal pure returns (int152 downcasted) {\\n        downcasted = int152(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(152, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int144 from int256, reverting on\\n     * overflow (when the input is less than smallest int144 or\\n     * greater than largest int144).\\n     *\\n     * Counterpart to Solidity's `int144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toInt144(int256 value) internal pure returns (int144 downcasted) {\\n        downcasted = int144(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(144, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int136 from int256, reverting on\\n     * overflow (when the input is less than smallest int136 or\\n     * greater than largest int136).\\n     *\\n     * Counterpart to Solidity's `int136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toInt136(int256 value) internal pure returns (int136 downcasted) {\\n        downcasted = int136(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(136, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int128 from int256, reverting on\\n     * overflow (when the input is less than smallest int128 or\\n     * greater than largest int128).\\n     *\\n     * Counterpart to Solidity's `int128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toInt128(int256 value) internal pure returns (int128 downcasted) {\\n        downcasted = int128(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(128, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int120 from int256, reverting on\\n     * overflow (when the input is less than smallest int120 or\\n     * greater than largest int120).\\n     *\\n     * Counterpart to Solidity's `int120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toInt120(int256 value) internal pure returns (int120 downcasted) {\\n        downcasted = int120(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(120, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int112 from int256, reverting on\\n     * overflow (when the input is less than smallest int112 or\\n     * greater than largest int112).\\n     *\\n     * Counterpart to Solidity's `int112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toInt112(int256 value) internal pure returns (int112 downcasted) {\\n        downcasted = int112(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(112, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int104 from int256, reverting on\\n     * overflow (when the input is less than smallest int104 or\\n     * greater than largest int104).\\n     *\\n     * Counterpart to Solidity's `int104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toInt104(int256 value) internal pure returns (int104 downcasted) {\\n        downcasted = int104(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(104, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int96 from int256, reverting on\\n     * overflow (when the input is less than smallest int96 or\\n     * greater than largest int96).\\n     *\\n     * Counterpart to Solidity's `int96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toInt96(int256 value) internal pure returns (int96 downcasted) {\\n        downcasted = int96(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(96, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int88 from int256, reverting on\\n     * overflow (when the input is less than smallest int88 or\\n     * greater than largest int88).\\n     *\\n     * Counterpart to Solidity's `int88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toInt88(int256 value) internal pure returns (int88 downcasted) {\\n        downcasted = int88(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(88, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int80 from int256, reverting on\\n     * overflow (when the input is less than smallest int80 or\\n     * greater than largest int80).\\n     *\\n     * Counterpart to Solidity's `int80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toInt80(int256 value) internal pure returns (int80 downcasted) {\\n        downcasted = int80(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(80, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int72 from int256, reverting on\\n     * overflow (when the input is less than smallest int72 or\\n     * greater than largest int72).\\n     *\\n     * Counterpart to Solidity's `int72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toInt72(int256 value) internal pure returns (int72 downcasted) {\\n        downcasted = int72(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(72, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int64 from int256, reverting on\\n     * overflow (when the input is less than smallest int64 or\\n     * greater than largest int64).\\n     *\\n     * Counterpart to Solidity's `int64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toInt64(int256 value) internal pure returns (int64 downcasted) {\\n        downcasted = int64(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(64, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int56 from int256, reverting on\\n     * overflow (when the input is less than smallest int56 or\\n     * greater than largest int56).\\n     *\\n     * Counterpart to Solidity's `int56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toInt56(int256 value) internal pure returns (int56 downcasted) {\\n        downcasted = int56(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(56, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int48 from int256, reverting on\\n     * overflow (when the input is less than smallest int48 or\\n     * greater than largest int48).\\n     *\\n     * Counterpart to Solidity's `int48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toInt48(int256 value) internal pure returns (int48 downcasted) {\\n        downcasted = int48(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(48, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int40 from int256, reverting on\\n     * overflow (when the input is less than smallest int40 or\\n     * greater than largest int40).\\n     *\\n     * Counterpart to Solidity's `int40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toInt40(int256 value) internal pure returns (int40 downcasted) {\\n        downcasted = int40(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(40, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int32 from int256, reverting on\\n     * overflow (when the input is less than smallest int32 or\\n     * greater than largest int32).\\n     *\\n     * Counterpart to Solidity's `int32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toInt32(int256 value) internal pure returns (int32 downcasted) {\\n        downcasted = int32(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(32, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int24 from int256, reverting on\\n     * overflow (when the input is less than smallest int24 or\\n     * greater than largest int24).\\n     *\\n     * Counterpart to Solidity's `int24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toInt24(int256 value) internal pure returns (int24 downcasted) {\\n        downcasted = int24(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(24, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int16 from int256, reverting on\\n     * overflow (when the input is less than smallest int16 or\\n     * greater than largest int16).\\n     *\\n     * Counterpart to Solidity's `int16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toInt16(int256 value) internal pure returns (int16 downcasted) {\\n        downcasted = int16(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(16, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int8 from int256, reverting on\\n     * overflow (when the input is less than smallest int8 or\\n     * greater than largest int8).\\n     *\\n     * Counterpart to Solidity's `int8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toInt8(int256 value) internal pure returns (int8 downcasted) {\\n        downcasted = int8(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(8, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Converts an unsigned uint256 into a signed int256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be less than or equal to maxInt256.\\n     */\\n    function toInt256(uint256 value) internal pure returns (int256) {\\n        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\\n        if (value > uint256(type(int256).max)) {\\n            revert SafeCastOverflowedUintToInt(value);\\n        }\\n        return int256(value);\\n    }\\n\\n    /**\\n     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.\\n     */\\n    function toUint(bool b) internal pure returns (uint256 u) {\\n        assembly (\\\"memory-safe\\\") {\\n            u := iszero(iszero(b))\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0x195533c86d0ef72bcc06456a4f66a9b941f38eb403739b00f21fd7c1abd1ae54\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/types/Time.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/types/Time.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Math} from \\\"../math/Math.sol\\\";\\nimport {SafeCast} from \\\"../math/SafeCast.sol\\\";\\n\\n/**\\n * @dev This library provides helpers for manipulating time-related objects.\\n *\\n * It uses the following types:\\n * - `uint48` for timepoints\\n * - `uint32` for durations\\n *\\n * While the library doesn't provide specific types for timepoints and duration, it does provide:\\n * - a `Delay` type to represent duration that can be programmed to change value automatically at a given point\\n * - additional helper functions\\n */\\nlibrary Time {\\n    using Time for *;\\n\\n    /**\\n     * @dev Get the block timestamp as a Timepoint.\\n     */\\n    function timestamp() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.timestamp);\\n    }\\n\\n    /**\\n     * @dev Get the block number as a Timepoint.\\n     */\\n    function blockNumber() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.number);\\n    }\\n\\n    // ==================================================== Delay =====================================================\\n    /**\\n     * @dev A `Delay` is a uint32 duration that can be programmed to change value automatically at a given point in the\\n     * future. The \\\"effect\\\" timepoint describes when the transitions happens from the \\\"old\\\" value to the \\\"new\\\" value.\\n     * This allows updating the delay applied to some operation while keeping some guarantees.\\n     *\\n     * In particular, the {update} function guarantees that if the delay is reduced, the old delay still applies for\\n     * some time. For example if the delay is currently 7 days to do an upgrade, the admin should not be able to set\\n     * the delay to 0 and upgrade immediately. If the admin wants to reduce the delay, the old delay (7 days) should\\n     * still apply for some time.\\n     *\\n     *\\n     * The `Delay` type is 112 bits long, and packs the following:\\n     *\\n     * ```\\n     *   | [uint48]: effect date (timepoint)\\n     *   |           | [uint32]: value before (duration)\\n     *   \\u2193           \\u2193       \\u2193 [uint32]: value after (duration)\\n     * 0xAAAAAAAAAAAABBBBBBBBCCCCCCCC\\n     * ```\\n     *\\n     * NOTE: The {get} and {withUpdate} functions operate using timestamps. Block number based delays are not currently\\n     * supported.\\n     */\\n    type Delay is uint112;\\n\\n    /**\\n     * @dev Wrap a duration into a Delay to add the one-step \\\"update in the future\\\" feature\\n     */\\n    function toDelay(uint32 duration) internal pure returns (Delay) {\\n        return Delay.wrap(duration);\\n    }\\n\\n    /**\\n     * @dev Get the value at a given timepoint plus the pending value and effect timepoint if there is a scheduled\\n     * change after this timepoint. If the effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function _getFullAt(\\n        Delay self,\\n        uint48 timepoint\\n    ) private pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        (valueBefore, valueAfter, effect) = self.unpack();\\n        return effect <= timepoint ? (valueAfter, 0, 0) : (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev Get the current value plus the pending value and effect timepoint if there is a scheduled change. If the\\n     * effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function getFull(Delay self) internal view returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        return _getFullAt(self, timestamp());\\n    }\\n\\n    /**\\n     * @dev Get the current value.\\n     */\\n    function get(Delay self) internal view returns (uint32) {\\n        (uint32 delay, , ) = self.getFull();\\n        return delay;\\n    }\\n\\n    /**\\n     * @dev Update a Delay object so that it takes a new duration after a timepoint that is automatically computed to\\n     * enforce the old delay at the moment of the update. Returns the updated Delay object and the timestamp when the\\n     * new delay becomes effective.\\n     */\\n    function withUpdate(\\n        Delay self,\\n        uint32 newValue,\\n        uint32 minSetback\\n    ) internal view returns (Delay updatedDelay, uint48 effect) {\\n        uint32 value = self.get();\\n        uint32 setback = uint32(Math.max(minSetback, value > newValue ? value - newValue : 0));\\n        effect = timestamp() + setback;\\n        return (pack(value, newValue, effect), effect);\\n    }\\n\\n    /**\\n     * @dev Split a delay into its components: valueBefore, valueAfter and effect (transition timepoint).\\n     */\\n    function unpack(Delay self) internal pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        uint112 raw = Delay.unwrap(self);\\n\\n        valueAfter = uint32(raw);\\n        valueBefore = uint32(raw >> 32);\\n        effect = uint48(raw >> 64);\\n\\n        return (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev pack the components into a Delay object.\\n     */\\n    function pack(uint32 valueBefore, uint32 valueAfter, uint48 effect) internal pure returns (Delay) {\\n        return Delay.wrap((uint112(effect) << 64) | (uint112(valueBefore) << 32) | uint112(valueAfter));\\n    }\\n}\\n\",\"keccak256\":\"0x36776530f012618bc7526ceb28e77b85e582cb12d9b9466a71d4bd6bf952e4cc\",\"license\":\"MIT\"},\"contracts/helpers/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { AccessManaged } from \\\"../utils/AccessManaged.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport \\\"contracts/interfaces/IHarvester.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nstruct YieldBearingParams {\\n  // Address of the asset used to mint the yield bearing asset\\n  address asset;\\n  // Target exposure to the collateral yield bearing asset used\\n  uint64 targetExposure;\\n  // Maximum exposure within the Parallelizer to the deposit asset\\n  uint64 maxExposure;\\n  // Minimum exposure within the Parallelizer to the deposit asset\\n  uint64 minExposure;\\n  // Whether limit exposures should be overriden or read onchain through the Parallelizer\\n  // This value should be 1 to override exposures or 2 if these shouldn't be overriden\\n  uint64 overrideExposures;\\n  // Maximum slippage when dealing with the Parallelizer\\n  uint96 maxSlippage;\\n}\\n\\n/// @title BaseHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Abstract contract for a harvester that aims at rebalancing a Parallelizer\\n/// @dev This contract is an authorized fork of Angle's BaseHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol\\nabstract contract BaseHarvester is IHarvester, AccessManaged {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       MODIFIERS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrusted() {\\n    if (!isTrusted[msg.sender]) revert NotTrusted();\\n    _;\\n  }\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted or guardian to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrustedOrRestricted() {\\n    if (!isTrusted[msg.sender] && !_checkCanCall(_msgSender(), _msgData())) {\\n      revert NotTrustedOrGuardian();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       VARIABLES\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Reference to the `parallelizer` implementation this contract aims at rebalancing\\n  IParallelizer public immutable parallelizer;\\n  /// @notice TokenP handled by the `parallelizer` of interest\\n  ITokenP public immutable tokenP;\\n  /// @notice Max slippage when dealing with the Parallelizer\\n  mapping(address => uint96) public maxTokenSlippage;\\n  /// @notice Data associated to a yield bearing asset\\n  mapping(address => YieldBearingParams) public yieldBearingData;\\n  /// @notice trusted addresses that can update target exposure and do others non critical operations\\n  mapping(address => bool) public isTrusted;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EVENTS                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  event Recovered(address token, uint256 amount, address to);\\n  event TrustedToggled(address trusted, bool status);\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       CONSTRUCTOR\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialAuthority,\\n    ITokenP definitiveTokenP,\\n    IParallelizer definitiveParallelizer\\n  )\\n    AccessManaged(initialAuthority)\\n  {\\n    tokenP = definitiveTokenP;\\n    parallelizer = definitiveParallelizer;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        GUARDIAN FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the yieldBearingAsset data\\n   * @param yieldBearingAsset address of the yieldBearingAsset\\n   * @param asset address of the asset\\n   * @param targetExposure target exposure to the yieldBearingAsset asset used\\n   * @param minExposure minimum exposure within the Parallelizer to the asset\\n   * @param maxExposure maximum exposure within the Parallelizer to the asset\\n   * @param overrideExposures whether limit exposures should be overriden or read onchain through the Parallelizer\\n   */\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external\\n    restricted\\n  {\\n    _setYieldBearingAssetData(\\n      yieldBearingAsset, asset, targetExposure, minExposure, maxExposure, overrideExposures, maxSlippage\\n    );\\n  }\\n\\n  /**\\n   * @notice Set the limit exposures to the asset linked to the yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   */\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) public virtual {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    if (yieldBearingInfo.overrideExposures == 2) {\\n      _updateLimitExposuresYieldAsset(yieldBearingInfo.asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  /**\\n   * @notice Set the max allowed slippage\\n   * @param newMaxSlippage new max allowed slippage\\n   */\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external restricted {\\n    _setMaxSlippage(yieldBearingAsset, newMaxSlippage);\\n  }\\n\\n  /**\\n   * @notice Toggle the trusted status of an address\\n   * @param trusted address to toggle the trusted status\\n   */\\n  function toggleTrusted(address trusted) external restricted {\\n    emit TrustedToggled(trusted, isTrusted[trusted]);\\n    isTrusted[trusted] = !isTrusted[trusted];\\n  }\\n\\n  /**\\n   * @notice Recover ERC20 tokens\\n   * @param tokenAddress address of the token to recover\\n   * @param amountToRecover amount to recover\\n   * @param to address to send the recovered tokens\\n   */\\n  function recoverERC20(address tokenAddress, uint256 amountToRecover, address to) external restricted {\\n    emit Recovered(tokenAddress, amountToRecover, to);\\n    IERC20(tokenAddress).safeTransfer(to, amountToRecover);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        TRUSTED FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the target exposure of a yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @param targetExposure target exposure to the yield bearing asset used\\n   */\\n  function setTargetExposure(address yieldBearingAsset, uint64 targetExposure) external onlyTrustedOrRestricted {\\n    yieldBearingData[yieldBearingAsset].targetExposure = targetExposure;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        VIEW FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Compute the amount needed to rebalance the Parallelizer\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @return increase whether the exposure should be increased\\n   * @return amount amount to be rebalanced\\n   */\\n  function computeRebalanceAmount(address yieldBearingAsset) external view returns (uint8 increase, uint256 amount) {\\n    return _computeRebalanceAmount(yieldBearingAsset, yieldBearingData[yieldBearingAsset]);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        INTERNAL FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _computeRebalanceAmount(\\n    address yieldBearingAsset,\\n    YieldBearingParams memory yieldBearingInfo\\n  )\\n    internal\\n    view\\n    returns (uint8 increase, uint256 amount)\\n  {\\n    (uint256 stablecoinsFromYieldBearingAsset, uint256 stablecoinsIssued) =\\n      parallelizer.getIssuedByCollateral(yieldBearingAsset);\\n    (uint256 stablecoinsFromAsset,) = parallelizer.getIssuedByCollateral(yieldBearingInfo.asset);\\n    uint256 targetExposureScaled = yieldBearingInfo.targetExposure * stablecoinsIssued;\\n    if (stablecoinsFromYieldBearingAsset * 1e9 > targetExposureScaled) {\\n      // Need to decrease exposure to yield bearing asset\\n      amount = stablecoinsFromYieldBearingAsset - targetExposureScaled / 1e9;\\n      uint256 maxValueScaled = yieldBearingInfo.maxExposure * stablecoinsIssued;\\n      // These checks assume that there are no transaction fees on the stablecoin->collateral conversion and so\\n      // it's still possible that exposure goes above the max exposure in some rare cases\\n      if (stablecoinsFromAsset * 1e9 > maxValueScaled) {\\n        amount = 0;\\n      } else if ((stablecoinsFromAsset + amount) * 1e9 > maxValueScaled) {\\n        amount = maxValueScaled / 1e9 - stablecoinsFromAsset;\\n      }\\n    } else {\\n      // In this case, exposure after the operation might remain slightly below the targetExposure as less\\n      // collateral may be obtained by burning stablecoins for the yield asset and unwrapping it\\n      increase = 1;\\n      amount = targetExposureScaled / 1e9 - stablecoinsFromYieldBearingAsset;\\n      uint256 minValueScaled = yieldBearingInfo.minExposure * stablecoinsIssued;\\n      if (stablecoinsFromAsset * 1e9 < minValueScaled) {\\n        amount = 0;\\n      } else if (stablecoinsFromAsset * 1e9 < minValueScaled + amount * 1e9) {\\n        amount = stablecoinsFromAsset - minValueScaled / 1e9;\\n      }\\n    }\\n  }\\n\\n  function _setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    internal\\n    virtual\\n  {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    yieldBearingInfo.asset = asset;\\n    if (targetExposure >= 1e9) revert InvalidParam();\\n    if (maxSlippage >= 1e9) revert InvalidParam();\\n    yieldBearingInfo.targetExposure = targetExposure;\\n    yieldBearingInfo.overrideExposures = overrideExposures;\\n    yieldBearingInfo.maxSlippage = maxSlippage;\\n    if (overrideExposures == 1) {\\n      if (maxExposure >= 1e9 || minExposure >= maxExposure) revert InvalidParam();\\n      yieldBearingInfo.maxExposure = maxExposure;\\n      yieldBearingInfo.minExposure = minExposure;\\n    } else {\\n      yieldBearingInfo.overrideExposures = 2;\\n      _updateLimitExposuresYieldAsset(asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  function _updateLimitExposuresYieldAsset(\\n    address asset,\\n    YieldBearingParams storage yieldBearingInfo\\n  )\\n    internal\\n    virtual\\n  {\\n    uint64[] memory xFeeMint;\\n    (xFeeMint,) = parallelizer.getCollateralMintFees(asset);\\n    uint256 length = xFeeMint.length;\\n    if (length <= 1) yieldBearingInfo.maxExposure = 1e9;\\n    else yieldBearingInfo.maxExposure = xFeeMint[length - 2];\\n\\n    uint64[] memory xFeeBurn;\\n    (xFeeBurn,) = parallelizer.getCollateralBurnFees(asset);\\n    length = xFeeBurn.length;\\n    if (length <= 1) yieldBearingInfo.minExposure = 0;\\n    else yieldBearingInfo.minExposure = xFeeBurn[length - 2];\\n  }\\n\\n  function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {\\n    if (newMaxSlippage > 1e9) revert InvalidParam();\\n    maxTokenSlippage[yieldBearingAsset] = newMaxSlippage;\\n  }\\n\\n  function _scaleAmountBasedOnDecimals(\\n    uint256 decimalsTokenIn,\\n    uint256 decimalsTokenOut,\\n    uint256 amountIn,\\n    bool assetIn\\n  )\\n    internal\\n    pure\\n    returns (uint256)\\n  {\\n    if (decimalsTokenIn > decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn /= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      } else {\\n        amountIn *= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      }\\n    } else if (decimalsTokenIn < decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn *= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      } else {\\n        amountIn /= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      }\\n    }\\n    return amountIn;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    HELPER                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _adjustAllowance(address token, address sender, uint256 amountIn) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), sender);\\n    if (allowance < amountIn) IERC20(token).safeIncreaseAllowance(sender, type(uint256).max - allowance);\\n  }\\n}\\n\",\"keccak256\":\"0x82e2ae57997043160d7529488b34591c710cd74e267213b61009daa96e9eeaaf\",\"license\":\"GPL-3.0\"},\"contracts/helpers/GenericHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeCast } from \\\"@openzeppelin/contracts/utils/math/SafeCast.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IERC20Metadata } from \\\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\\\";\\nimport { IERC3156FlashBorrower } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\\\";\\nimport { IERC3156FlashLender } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\\\";\\nimport { RouterSwapper } from \\\"@helpers/RouterSwapper.sol\\\";\\n\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport { IERC4626 } from \\\"contracts/interfaces/external/IERC4626.sol\\\";\\n\\nimport \\\"../utils/Constants.sol\\\";\\nimport \\\"../utils/Errors.sol\\\";\\n\\nimport { BaseHarvester, YieldBearingParams } from \\\"./BaseHarvester.sol\\\";\\n\\nenum SwapType {\\n  VAULT,\\n  SWAP\\n}\\n\\n/// @title GenericHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Generic contract for anyone to permissionlessly adjust the reserves of Angle Parallelizer\\n/// @dev This contract is an authorized fork of Angle's GenericHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\\ncontract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {\\n  using SafeCast for uint256;\\n  using SafeERC20 for IERC20;\\n\\n  bytes32 public constant CALLBACK_SUCCESS = keccak256(\\\"ERC3156FlashBorrower.onFlashLoan\\\");\\n\\n  /// @notice Parallel stablecoin flashloan contract\\n  IERC3156FlashLender public immutable flashloan;\\n  /// @notice Budget of tokenP available for each users\\n  mapping(address => uint256) public budget;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INITIALIZATION                                                  \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialTokenTransferAddress,\\n    address initialSwapRouter,\\n    ITokenP definitivetokenP,\\n    IParallelizer definitiveParallelizer,\\n    address initialAuthority,\\n    IERC3156FlashLender definitiveFlashloan\\n  )\\n    RouterSwapper(initialSwapRouter, initialTokenTransferAddress)\\n    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)\\n  {\\n    if (address(definitiveFlashloan) == address(0)) revert ZeroAddress();\\n    flashloan = definitiveFlashloan;\\n\\n    IERC20(tokenP).approve(address(definitiveFlashloan), type(uint256).max);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        BUDGET HANDLING\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Add budget to be spent by the receiver during the flashloan\\n   * @param amount amount of tokenP to add to the budget\\n   * @param receiver address of the receiver\\n   */\\n  function addBudget(uint256 amount, address receiver) public virtual {\\n    budget[receiver] += amount;\\n\\n    IERC20(tokenP).safeTransferFrom(msg.sender, address(this), amount);\\n  }\\n\\n  /**\\n   * @notice Remove budget from the owner and send it to the receiver\\n   * @param amount amount of tokenP to remove from the budget\\n   * @param receiver address of the receiver\\n   */\\n  function removeBudget(uint256 amount, address receiver) public virtual {\\n    budget[msg.sender] -= amount; // Will revert if not enough funds\\n\\n    IERC20(tokenP).safeTransfer(receiver, amount);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        HARVEST\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure\\n  ///  to this yieldBearingAsset\\n  /// @dev This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up\\n  /// some yieldBearingAsset that can then be used for people looking to burn deposit tokens\\n  /// @dev Due to potential transaction fees within the Parallelizer, this function doesn't exactly bring\\n  /// `yieldBearingAsset` to the target exposure\\n  /// @dev scale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest,\\n  /// it is used to lower the amount of the asset to harvest for example to have a lower slippage\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual {\\n    if (scale > 1e9) revert InvalidParam();\\n    updateLimitExposuresYieldAsset(yieldBearingAsset);\\n    YieldBearingParams memory yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    (uint8 increase, uint256 amount) = _computeRebalanceAmount(yieldBearingAsset, yieldBearingInfo);\\n    amount = (amount * scale) / 1e9;\\n    if (amount == 0) revert ZeroAmount();\\n    (SwapType swapType, bytes memory data) = abi.decode(extraData, (SwapType, bytes));\\n    try parallelizer.updateOracle(yieldBearingAsset) { } catch { }\\n    _adjustYieldExposure(\\n      amount,\\n      increase,\\n      yieldBearingAsset,\\n      yieldBearingInfo.asset,\\n      (amount * (1e9 - yieldBearingInfo.maxSlippage)) / 1e9,\\n      swapType,\\n      data\\n    );\\n  }\\n\\n  /// @inheritdoc IERC3156FlashBorrower\\n  function onFlashLoan(\\n    address initiator,\\n    address,\\n    uint256 amount,\\n    uint256 fee,\\n    bytes calldata data\\n  )\\n    public\\n    virtual\\n    returns (bytes32)\\n  {\\n    if (msg.sender != address(flashloan) || initiator != address(this) || fee != 0) revert NotTrusted();\\n    address sender;\\n    uint256 typeAction;\\n    uint256 minAmountOut;\\n    SwapType swapType;\\n    bytes memory callData;\\n    address tokenOut;\\n    address tokenIn;\\n    {\\n      address yieldBearingAsset;\\n      address asset;\\n      (sender, typeAction, yieldBearingAsset, asset, minAmountOut, swapType, callData) =\\n        abi.decode(data, (address, uint256, address, address, uint256, SwapType, bytes));\\n      if (typeAction == 1) {\\n        // Increase yield exposure action: we bring in the yield bearing asset\\n        tokenOut = yieldBearingAsset;\\n        tokenIn = asset;\\n      } else {\\n        // Decrease yield exposure action: we bring in the deposit asset\\n        tokenIn = yieldBearingAsset;\\n        tokenOut = asset;\\n      }\\n    }\\n    uint256 amountOut =\\n      parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);\\n\\n    // Swap to tokenIn\\n    amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);\\n\\n    _adjustAllowance(tokenOut, address(parallelizer), amountOut);\\n    uint256 amountStableOut =\\n      parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);\\n    if (amount > amountStableOut) {\\n      budget[sender] -= amount - amountStableOut; // Will revert if not enough funds\\n    }\\n    return CALLBACK_SUCCESS;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    SETTERS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the token transfer contract\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress) public override restricted {\\n    super.setTokenTransferAddress(newTokenTransferAddress);\\n  }\\n\\n  /**\\n   * @notice Set the swap router\\n   * @param newSwapRouter address of the swap router\\n   */\\n  function setSwapRouter(address newSwapRouter) public override restricted {\\n    super.setSwapRouter(newSwapRouter);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INTERNALS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Burns `amountStablecoins` for one yieldBearing asset, swap for asset then mints deposit tokens\\n  /// from the proceeds of the swap.\\n  /// @dev If `increase` is 1, then the system tries to increase its exposure to the yield bearing asset which means\\n  /// burning tokenP for the deposit asset, swapping for the yield bearing asset, then minting the tokenP\\n  /// @dev This function reverts if the second tokenP mint gives less than `minAmountOut` of ag tokens\\n  /// @dev This function reverts if the swap slippage is higher than `maxSlippage`\\n  function _adjustYieldExposure(\\n    uint256 amountStablecoins,\\n    uint8 increase,\\n    address yieldBearingAsset,\\n    address asset,\\n    uint256 minAmountOut,\\n    SwapType swapType,\\n    bytes memory extraData\\n  )\\n    internal\\n  {\\n    flashloan.flashLoan(\\n      IERC3156FlashBorrower(address(this)),\\n      address(tokenP),\\n      amountStablecoins,\\n      abi.encode(msg.sender, increase, yieldBearingAsset, asset, minAmountOut, swapType, extraData)\\n    );\\n  }\\n\\n  function _swapToTokenOut(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    SwapType swapType,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (swapType == SwapType.SWAP) {\\n      amountOut = _swapToTokenOutSwap(tokenIn, tokenOut, amount, callData);\\n    } else if (swapType == SwapType.VAULT) {\\n      amountOut = _swapToTokenOutVault(typeAction, tokenIn, tokenOut, amount);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap token using the router/aggregator\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _swapToTokenOutSwap(\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256)\\n  {\\n    uint256 balance = IERC20(tokenOut).balanceOf(address(this));\\n\\n    address[] memory tokens = new address[](1);\\n    tokens[0] = tokenIn;\\n    bytes[] memory callDatas = new bytes[](1);\\n    callDatas[0] = callData;\\n    uint256[] memory amounts = new uint256[](1);\\n    amounts[0] = amount;\\n    _swap(tokens, callDatas, amounts);\\n\\n    return IERC20(tokenOut).balanceOf(address(this)) - balance;\\n  }\\n\\n  /**\\n   * @dev Deposit or redeem the vault asset\\n   * @param typeAction 1 for deposit, 2 for redeem\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   */\\n  function _swapToTokenOutVault(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (typeAction == 1) {\\n      // Granting allowance with the yieldBearingAsset for the vault asset\\n      _adjustAllowance(tokenIn, tokenOut, amount);\\n      amountOut = IERC4626(tokenOut).deposit(amount, address(this));\\n    } else {\\n      amountOut = IERC4626(tokenIn).redeem(amount, address(this), address(this));\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x764fdb8964ca0b949d1b3f336cd8046c9c77c86aae4011b0a8760cedc5bb7971\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IDiamondCut.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IDiamondCut\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondCut.sol by mudgen\\n/// @dev This interface is an authorized fork of Angle's `IDiamondCut` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IDiamondCut.sol\\ninterface IDiamondCut {\\n  /// @notice Add/replace/remove any number of functions and optionally execute a function with delegatecall\\n  /// @param _diamondCut Contains the facet addresses and function selectors\\n  /// @param _init The address of the contract or facet to execute _calldata\\n  /// @param _calldata A function call, including function selector and arguments, executed with delegatecall on\\n  /// _init\\n  function diamondCut(FacetCut[] calldata _diamondCut, address _init, bytes calldata _calldata) external;\\n}\\n\",\"keccak256\":\"0x08a01f77b740f7da424f0ea27a6a292f9e292058e23d1fe960d2d19a44496c7b\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondEtherscan.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\n/// @title IDiamondEtherscan\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface IDiamondEtherscan {\\n  /// @notice Sets a dummy implementation with the same layout at the diamond proxy contract with all its facets\\n  function setDummyImplementation(address _implementation) external;\\n\\n  /// @notice Address of the dummy implementation used to make the DiamondProxy contract interpretable by Etherscan\\n  function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xf742b55592d129e02fb755d25f7a97ed976a14c4c744d6ac46726809e8f1e037\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondLoupe.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @notice IDiamondLoupe\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondLoupe.sol by mudgen\\ninterface IDiamondLoupe {\\n  /// @notice Gets all facet addresses and their four byte function selectors.\\n  /// @return facets_ Facet\\n  function facets() external view returns (Facet[] memory facets_);\\n\\n  /// @notice Gets all the function selectors supported by a specific facet.\\n  /// @param _facet The facet address.\\n  /// @return facetFunctionSelectors_\\n  function facetFunctionSelectors(address _facet) external view returns (bytes4[] memory facetFunctionSelectors_);\\n\\n  /// @notice Get all the facet addresses used by a diamond.\\n  /// @return facetAddresses_\\n  function facetAddresses() external view returns (address[] memory facetAddresses_);\\n\\n  /// @notice Gets the facet that supports the given selector.\\n  /// @dev If facet is not found return address(0).\\n  /// @param _functionSelector The function selector.\\n  /// @return facetAddress_ The facet address.\\n  function facetAddress(bytes4 _functionSelector) external view returns (address facetAddress_);\\n}\\n\",\"keccak256\":\"0xa5580958acabe2c44967e835e77a748eb0b8812f70cd071191201508c9388ca8\",\"license\":\"MIT\"},\"contracts/interfaces/IGetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IGetters\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IGetters` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IGetters.sol\\ninterface IGetters {\\n  /// @notice Checks whether a given `selector` is actually a valid selector corresponding to a function in one of\\n  /// the\\n  /// facets of the proxy\\n  function isValidSelector(bytes4 selector) external view returns (bool);\\n\\n  /// @notice Stablecoin minted by parallelizer\\n  function tokenP() external view returns (ITokenP);\\n\\n  /// @notice Returns the list of collateral assets supported by the system\\n  function getCollateralList() external view returns (address[] memory);\\n\\n  /// @notice Returns all the info in storage associated to a `collateral`\\n  function getCollateralInfo(address collateral) external view returns (Collateral memory);\\n\\n  /// @notice Returns the decimals of a given `collateral`\\n  function getCollateralDecimals(address collateral) external view returns (uint8);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to mint\\n  /// with `collateral`\\n  function getCollateralMintFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to burn\\n  /// for `collateral`\\n  function getCollateralBurnFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays used to compute the penalty factor depending on the collateral\\n  /// ratio when users come to redeem\\n  function getRedemptionFees() external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the collateral ratio of Parallelizer in base `10**9` and a rounded version of the total amount\\n  /// of stablecoins issued\\n  function getCollateralRatio() external view returns (uint64 collatRatio, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the total amount of stablecoins issued through Parallelizer\\n  function getTotalIssued() external view returns (uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the amount of stablecoins issued from `collateral` and the total amount of stablecoins issued\\n  /// through Parallelizer\\n  function getIssuedByCollateral(address collateral)\\n    external\\n    view\\n    returns (uint256 stablecoinsFromCollateral, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns if a collateral is \\\"managed\\\" and the associated manager configuration\\n  function getManagerData(address collateral)\\n    external\\n    view\\n    returns (bool isManaged, IERC20[] memory subCollaterals, bytes memory config);\\n\\n  /// @notice Returns the oracle values associated to `collateral`\\n  /// @return mint Oracle value to be used for a mint transaction with `collateral`\\n  /// @return burn Oracle value that will be used for `collateral` for a burn transaction. This value\\n  /// is then used along with oracle values for all other collateral assets to get a global burn value for the oracle\\n  /// @return ratio Ratio, in base `10**18` between the oracle value of the `collateral` and its target price.\\n  /// This value is 10**18 if the oracle is greater than the collateral price\\n  /// @return minRatio Minimum ratio across all collateral assets between a collateral burn price and its target\\n  /// price. This value is independent of `collateral` and is used to normalize the burn oracle value for burn\\n  /// transactions.\\n  /// @return redemption Oracle value that would be used to price `collateral` when computing the collateral ratio\\n  /// during a redemption\\n  function getOracleValues(address collateral)\\n    external\\n    view\\n    returns (uint256 mint, uint256 burn, uint256 ratio, uint256 minRatio, uint256 redemption);\\n\\n  /// @notice Returns the data used to compute oracle values for `collateral`\\n  /// @return oracleType Type of oracle (Chainlink, external smart contract, ...)\\n  /// @return targetType Type passed to read the value of the target price\\n  /// @return oracleData Extra data needed to read the oracle. For Chainlink oracles, this data is supposed to give\\n  /// the addresses of the Chainlink feeds to read, the stale periods for each feed, ...\\n  /// @return targetData Extra data needed to read the target price of the asset\\n  function getOracle(address collateral)\\n    external\\n    view\\n    returns (\\n      OracleReadType oracleType,\\n      OracleReadType targetType,\\n      bytes memory oracleData,\\n      bytes memory targetData,\\n      bytes memory hyperparameters\\n    );\\n\\n  /// @notice Returns if the associated functionality is paused or not\\n  function isPaused(address collateral, ActionType action) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update normalizers\\n  function isTrusted(address sender) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update sell rewards\\n  function isTrustedSeller(address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` has a non null entry in the `isWhitelistedForType` storage mapping\\n  /// @dev Note that ultimately whitelisting may depend as well on external providers\\n  function isWhitelistedForType(WhitelistType whitelistType, address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` can deal with `collateral` during burns and redemptions\\n  function isWhitelistedForCollateral(address collateral, address sender) external returns (bool);\\n\\n  /// @notice Checks whether only whitelisted address can deal with `collateral` during burns and redemptions\\n  function isWhitelistedCollateral(address collateral) external view returns (bool);\\n\\n  /// @notice Gets the data needed to deal with whitelists for `collateral`\\n  function getCollateralWhitelistData(address collateral) external view returns (bytes memory);\\n\\n  /// @notice Returns the stablecoin cap for `collateral`\\n  function getStablecoinCap(address collateral) external view returns (uint256);\\n\\n  /// @notice Returns the address of the `accessManager` contract\\n  function accessManager() external view returns (address);\\n\\n  /// @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n  /// being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n  /// attacker controlled calls.\\n  function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaa9eba6ee7770d6146fedbfef07ad10ff09524692319ca0cc32abfa64a2b597b\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IHarvester` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IHarvester.sol\\ninterface IHarvester {\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address stablecoin,\\n    uint64 targetExposure,\\n    uint64 minExposureYieldAsset,\\n    uint64 maxExposureYieldAsset,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external;\\n\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) external;\\n\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external;\\n\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) external;\\n}\\n\",\"keccak256\":\"0x0d4e8fee737f4f747060a3c5044c8cb2f153faa228ad37a661a659ca62aab055\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IParallelizer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IDiamondCut } from \\\"./IDiamondCut.sol\\\";\\nimport { IDiamondEtherscan } from \\\"./IDiamondEtherscan.sol\\\";\\nimport { IDiamondLoupe } from \\\"./IDiamondLoupe.sol\\\";\\nimport { IGetters } from \\\"./IGetters.sol\\\";\\nimport { IRedeemer } from \\\"./IRedeemer.sol\\\";\\nimport { IRewardHandler } from \\\"./IRewardHandler.sol\\\";\\nimport { ISettersGovernor, ISettersGuardian } from \\\"./ISetters.sol\\\";\\nimport { ISwapper } from \\\"./ISwapper.sol\\\";\\n\\n/// @title IParallelizer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IParallelizer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IParallelizer.sol\\ninterface IParallelizer is\\n  IDiamondCut,\\n  IDiamondEtherscan,\\n  IDiamondLoupe,\\n  IGetters,\\n  IRedeemer,\\n  IRewardHandler,\\n  ISettersGovernor,\\n  ISettersGuardian,\\n  ISwapper\\n{ }\\n\",\"keccak256\":\"0x8bd964110c6a122bdb6cf58a194a97c894900237ebd7f3b11e2f43c6ee56ae7c\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRedeemer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRedeemer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRedeemer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRedeemer.sol\\ninterface IRedeemer {\\n  /// @notice Redeems `amount` of stablecoins from the system\\n  /// @param receiver Address which should be receiving the output tokens\\n  /// @param deadline Timestamp before which the redemption should have occured\\n  /// @param minAmountOuts Minimum amount of each token given back in the redemption to obtain\\n  /// @return tokens List of tokens returned\\n  /// @return amounts Amount given for each token in the `tokens` array\\n  function redeem(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Same as the redeem function above with the additional feature to specify a list of `forfeitTokens` for\\n  /// which the Parallelizer system will not try to do a transfer to `receiver`.\\n  function redeemWithForfeit(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts,\\n    address[] memory forfeitTokens\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Simulate the exact output that a redemption of `amount` of stablecoins would give at a given block\\n  /// @return tokens List of tokens that would be given\\n  /// @return amounts Amount that would be obtained for each token in the `tokens` array\\n  function quoteRedemptionCurve(uint256 amount)\\n    external\\n    view\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Updates the normalizer variable by `amount`\\n  function updateNormalizer(uint256 amount, bool increase) external returns (uint256);\\n}\\n\",\"keccak256\":\"0xb3522ee0380b321c64d02bf2db2acb658d8b314b811dd54b6a718d6708b5fb21\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRewardHandler.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRewardHandler\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRewardHandler` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRewardHandler.sol\\ninterface IRewardHandler {\\n  /// @notice Sells some external tokens through a odos call\\n  /// @param minAmountOut Minimum amount of the outToken to get\\n  /// @param payload Payload to pass to odos\\n  /// @return amountOut Amount obtained of the outToken\\n  function sellRewards(uint256 minAmountOut, bytes memory payload) external returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xff2afcbc8d1c25297324159d3684a323e60b3c9408129aba70d3d6938d093255\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/interfaces/IERC20.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISettersGovernor` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISetters.sol\\ninterface ISettersGovernor {\\n  /// @notice Recovers `amount` of `token` from the Parallelizer contract\\n  function recoverERC20(address collateral, IERC20 token, address to, uint256 amount) external;\\n\\n  /// @notice Sets a new access manager address\\n  function setAccessManager(address _newAccessManager) external;\\n\\n  /// @notice Sets (or unsets) a collateral manager  `collateral`\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before setting the new manager\\n  function setCollateralManager(\\n    address collateral,\\n    bool checkExternalManagerBalance,\\n    ManagerStorage memory managerData\\n  )\\n    external;\\n\\n  /// @notice Sets the allowance of the contract on `token` for `spender` to `amount`\\n  function changeAllowance(IERC20 token, address spender, uint256 amount) external;\\n\\n  /// @notice Changes the trusted status for `sender` when for selling rewards or updating the normalizer\\n  function toggleTrusted(address sender, TrustedType t) external;\\n\\n  /// @notice Changes whether a `collateral` can only be handled during burns and redemptions by whitelisted\\n  /// addresses\\n  /// and sets the data used to read into the whitelist\\n  function setWhitelistStatus(address collateral, uint8 whitelistStatus, bytes memory whitelistData) external;\\n\\n  /// @notice Add `collateral` as a supported collateral in the system\\n  function addCollateral(address collateral) external;\\n\\n  /// @notice Adjusts the amount of stablecoins issued from `collateral` by `amount`\\n  function adjustStablecoins(address collateral, uint128 amount, bool increase) external;\\n\\n  /// @notice Revokes `collateral` from the system\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before revoking the collateral\\n  function revokeCollateral(address collateral, bool checkExternalManagerBalance) external;\\n\\n  /// @notice Sets the `oracleConfig` used to read the value of `collateral` for the mint, burn and redemption\\n  /// operations\\n  function setOracle(address collateral, bytes memory oracleConfig) external;\\n\\n  /// @notice Update oracle data for a given `collateral`\\n  function updateOracle(address collateral) external;\\n}\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface ISettersGuardian {\\n  /// @notice Changes the pause status for mint or burn transactions for `collateral`\\n  function togglePause(address collateral, ActionType action) external;\\n\\n  /// @notice Sets the mint or burn fees for `collateral`\\n  function setFees(address collateral, uint64[] memory xFee, int64[] memory yFee, bool mint) external;\\n\\n  /// @notice Sets the parameters for the redemption curve\\n  function setRedemptionCurveParams(uint64[] memory xFee, int64[] memory yFee) external;\\n\\n  /// @notice Changes the whitelist status for a collateral with `whitelistType` for an address `who`\\n  function toggleWhitelist(WhitelistType whitelistType, address who) external;\\n\\n  /// @notice Sets the stablecoin cap that can be issued from a `collateral`\\n  function setStablecoinCap(address collateral, uint256 stablecoinCap) external;\\n}\\n\",\"keccak256\":\"0xc3fb2012e7c2f97ae93b12276afc4293aaeb97a6fe4d60109acaa94ef6945575\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title ISwapper\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISwapper` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISwapper.sol\\ninterface ISwapper {\\n  /// @notice Swaps (that is to say mints or burns) an exact amount of `tokenIn` for an amount of `tokenOut`\\n  /// @param amountIn Amount of `tokenIn` to bring\\n  /// @param amountOutMin Minimum amount of `tokenOut` to get: if `amountOut` is inferior to this amount, the\\n  /// function will revert\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountOut Amount of `tokenOut` obtained through the swap\\n  function swapExactInput(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Same as `swapExactInput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactInputWithPermit(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Swaps (that is to say mints or burns) an amount of `tokenIn` for an exact amount of `tokenOut`\\n  /// @param amountOut Amount of `tokenOut` to obtain from the swap\\n  /// @param amountInMax Maximum amount of `tokenIn` to bring in order to get `amountOut` of `tokenOut`\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountIn Amount of `tokenIn` used to perform the swap\\n  function swapExactOutput(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Same as `swapExactOutput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactOutputWithPermit(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Simulates what a call to `swapExactInput` with `amountIn` of `tokenIn` for `tokenOut` would give.\\n  /// If called right before and at the same block, the `amountOut` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactInput`\\n  function quoteIn(uint256 amountIn, address tokenIn, address tokenOut) external view returns (uint256 amountOut);\\n\\n  /// @notice Simulates what a call to `swapExactOutput` for `amountOut` of `tokenOut` with `tokenIn` would give.\\n  /// If called right before and at the same block, the `amountIn` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactOutput`\\n  function quoteOut(uint256 amountOut, address tokenIn, address tokenOut) external view returns (uint256 amountIn);\\n}\\n\",\"keccak256\":\"0x47e4b2742a51b82b9df72fb681335affe8519f4114fb540cd29d8f48ed182ffd\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ITokenP.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/// @title ITokenP\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @notice Interface for the stablecoins `tokenP` contracts\\n/// @dev This interface is an authorized fork of Angle's `IAgToken` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IAgToken.sol\\ninterface ITokenP is IERC20 {\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    MINTER ROLE ONLY FUNCTIONS                                            \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Lets a whitelisted contract mint tokenPs\\n  /// @param account Address to mint to\\n  /// @param amount Amount to mint\\n  function mint(address account, uint256 amount) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address after being asked to by `sender`\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @param sender Address which requested the burn from `burner`\\n  /// @dev This method is to be called by a contract with the minter right after being requested\\n  /// to do so by a `sender` address willing to burn tokens from another `burner` address\\n  /// @dev The method checks the allowance between the `sender` and the `burner`\\n  function burnFrom(uint256 amount, address burner, address sender) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @dev This method is to be called by a contract with a minter right on the tokenP after being\\n  /// requested to do so by an address willing to burn tokens from its address\\n  function burnSelf(uint256 amount, address burner) external;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EXTERNAL FUNCTIONS                                                \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Amount of decimals of the stablecoin\\n  function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x64a1305faa8c5c91767a11af0eae16e4b463aa0bfe10f11b74aae9d96681a5eb\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/IERC4626.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\n// OpenZeppelin Contracts (last updated v4.7.0) (interfaces/IERC4626.sol)\\n\\npragma solidity >=0.5.0;\\n\\n/// @notice ERC4626 interface\\n/// @author OpenZeppelin\\n/// @dev In this implementation, the interface only contains the functions that the IERC4626 interface adds on top of\\n/// the IERC20 interface\\ninterface IERC4626 {\\n  /**\\n   * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.\\n   *\\n   * - MUST be an ERC-20 token contract.\\n   * - MUST NOT revert.\\n   */\\n  function asset() external view returns (address assetTokenAddress);\\n\\n  /**\\n   * @dev Returns the total amount of the underlying asset that is \\u201cmanaged\\u201d by Vault.\\n   *\\n   * - SHOULD include any compounding that occurs from yield.\\n   * - MUST be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT revert.\\n   */\\n  function totalAssets() external view returns (uint256 totalManagedAssets);\\n\\n  /**\\n   * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToShares(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToAssets(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,\\n   * through a deposit call.\\n   *\\n   * - MUST return a limited value if receiver is subject to some deposit limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.\\n   * - MUST NOT revert.\\n   */\\n  function maxDeposit(address receiver) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit\\n   *   call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called\\n   *   in the same transaction.\\n   * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the\\n   *   deposit would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewDeposit(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   deposit execution, and are accounted for during deposit.\\n   * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function deposit(uint256 assets, address receiver) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.\\n   * - MUST return a limited value if receiver is subject to some mint limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.\\n   * - MUST NOT revert.\\n   */\\n  function maxMint(address receiver) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call\\n   *   in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the\\n   *   same transaction.\\n   * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint\\n   *   would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by minting.\\n   */\\n  function previewMint(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint\\n   *   execution, and are accounted for during mint.\\n   * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function mint(uint256 shares, address receiver) external returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the\\n   * Vault, through a withdraw call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxWithdraw(address owner) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw\\n   *   call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if\\n   *   called\\n   *   in the same transaction.\\n   * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though\\n   *   the withdrawal would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewWithdraw(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   withdraw execution, and are accounted for during withdraw.\\n   * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,\\n   * through a redeem call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxRedeem(address owner) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call\\n   *   in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the\\n   *   same transaction.\\n   * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the\\n   *   redemption would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by redeeming.\\n   */\\n  function previewRedeem(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   redeem execution, and are accounted for during redeem.\\n   * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);\\n}\\n\",\"keccak256\":\"0xd730d6a6b679201eec89dff3133de651da20b3e72e74f01b734078bfacf952ad\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/coinbase/ICbETH.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\npragma solidity >=0.5.0;\\n\\n/// @title ICbETH\\n/// @notice Interface for the `cbETH` contract\\ninterface ICbETH {\\n  function exchangeRate() external view returns (uint256);\\n}\\n\",\"keccak256\":\"0xb159341cb0e25c478912b274cdda2d50fa84692aeac87b6823d281aaea2aed04\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/frax/ISfrxETH.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\npragma solidity >=0.5.0;\\n\\n/// @title ISfrxETH\\n/// @notice Interface for the `sfrxETH` contract\\ninterface ISfrxETH {\\n  function pricePerShare() external view returns (uint256);\\n}\\n\",\"keccak256\":\"0x914cbea276f817c7db62bfca21e15bd8f7892faa9f39d86baaef574cf12b859f\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/lido/IStETH.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\npragma solidity >=0.5.0;\\n\\n/// @title IStETH\\n/// @notice Interface for the `StETH` contract\\ninterface IStETH {\\n  function getPooledEthByShares(uint256 _sharesAmount) external view returns (uint256);\\n\\n  function submit(address) external payable returns (uint256);\\n\\n  function getSharesByPooledEth(uint256 _ethAmount) external view returns (uint256);\\n}\\n\",\"keccak256\":\"0xf21e3d8bdadc236b34bf2122b0e0b939d2d6bb6e2889b508636cbb7b84f59680\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/rocketPool/IRETH.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\npragma solidity >=0.5.0;\\n\\n/// @title IRETH\\n/// @notice Interface for the `rETH` contract\\ninterface IRETH {\\n  function getExchangeRate() external view returns (uint256);\\n}\\n\",\"keccak256\":\"0x567a378e95d40160e297c1adb617ccaa69c03e49c4ad72a6ce651dd43cdbd5cd\",\"license\":\"GPL-3.0\"},\"contracts/parallelizer/Storage.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        ENUMS                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nenum FacetCutAction {\\n  Add,\\n  Replace,\\n  Remove\\n}\\n\\nenum ManagerType {\\n  EXTERNAL\\n}\\n\\nenum ActionType {\\n  Mint,\\n  Burn,\\n  Redeem\\n}\\n\\nenum TrustedType {\\n  Updater,\\n  Seller\\n}\\n\\nenum QuoteType {\\n  MintExactInput,\\n  MintExactOutput,\\n  BurnExactInput,\\n  BurnExactOutput\\n}\\n\\nenum OracleReadType {\\n  CHAINLINK_FEEDS,\\n  EXTERNAL,\\n  NO_ORACLE,\\n  STABLE,\\n  WSTETH,\\n  CBETH,\\n  RETH,\\n  SFRXETH,\\n  MAX,\\n  MORPHO_ORACLE\\n}\\n\\nenum OracleQuoteType {\\n  UNIT,\\n  TARGET\\n}\\n\\nenum WhitelistType {\\n  BACKED\\n}\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                    STRUCTS                                                     \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nstruct Permit2Details {\\n  address to; // Address that will receive the funds\\n  uint256 nonce; // Nonce of the transaction\\n  bytes signature; // Permit signature of the user\\n}\\n\\nstruct FacetCut {\\n  address facetAddress; // Facet contract address\\n  FacetCutAction action; // Can be add, remove or replace\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct Facet {\\n  address facetAddress; // Facet contract address\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct FacetInfo {\\n  address facetAddress; // Facet contract address\\n  uint16 selectorPosition; // Position in the list of all selectors\\n}\\n\\nstruct DiamondStorage {\\n  bytes4[] selectors; // List of all available selectors\\n  mapping(bytes4 => FacetInfo) selectorInfo; // Selector to (address, position in list)\\n  IAccessManager accessManager; // Contract handling access management\\n}\\n\\nstruct ImplementationStorage {\\n  address implementation; // Dummy implementation address for Etherscan usability\\n}\\n\\nstruct ManagerStorage {\\n  IERC20[] subCollaterals; // Subtokens handled by the manager or strategies\\n  bytes config; // Additional configuration data\\n}\\n\\nstruct Collateral {\\n  uint8 isManaged; // If the collateral is managed through external strategies\\n  uint8 isMintLive; // If minting from this asset is unpaused\\n  uint8 isBurnLive; // If burning to this asset is unpaused\\n  uint8 decimals; // IERC20Metadata(collateral).decimals()\\n  uint8 onlyWhitelisted; // If only whitelisted addresses can burn or redeem for this token\\n  uint216 normalizedStables; // Normalized amount of stablecoins issued from this collateral\\n  uint64[] xFeeMint; // Increasing exposures in [0,BASE_9[\\n  int64[] yFeeMint; // Mint fees at the exposures specified in `xFeeMint`\\n  uint64[] xFeeBurn; // Decreasing exposures in ]0,BASE_9]\\n  int64[] yFeeBurn; // Burn fees at the exposures specified in `xFeeBurn`\\n  bytes oracleConfig; // Data about the oracle used for the collateral\\n  bytes whitelistData; // For whitelisted collateral, data used to verify whitelists\\n  ManagerStorage managerData; // For managed collateral, data used to handle the strategies\\n  uint256 stablecoinCap; // Cap on the amount of stablecoins that can be issued from this collateral\\n}\\n\\nstruct ParallelizerStorage {\\n  ITokenP tokenP; // tokenP handled by the system\\n  uint8 isRedemptionLive; // If redemption is unpaused\\n  uint8 statusReentrant; // If call is reentrant or not\\n  bool consumingSchedule; // If the contract is consuming a scheduled operation\\n  uint128 normalizedStables; // Normalized amount of stablecoins issued by the system\\n  uint128 normalizer; // To reconcile `normalizedStables` values with the actual amount\\n  address[] collateralList; // List of collateral assets supported by the system\\n  uint64[] xRedemptionCurve; // Increasing collateral ratios > 0\\n  int64[] yRedemptionCurve; // Value of the redemption fees at `xRedemptionCurve`\\n  mapping(address => Collateral) collaterals; // Maps a collateral asset to its parameters\\n  mapping(address => uint256) isTrusted; // If an address is trusted to update the normalizer value\\n  mapping(address => uint256) isSellerTrusted; // If an address is trusted to sell accruing reward tokens or to run\\n    // keeper jobs on oracles\\n  mapping(WhitelistType => mapping(address => uint256)) isWhitelistedForType;\\n}\\n// Whether an address is whitelisted for a specific whitelist type\\n\",\"keccak256\":\"0x3f4313dd110dbe390038320b2d3cf24dcbe9b75cd9573e7f048f7233c02dd227\",\"license\":\"BUSL-1.1\"},\"contracts/utils/AccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { AuthorityUtils } from \\\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { IAccessManaged } from \\\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\\\";\\nimport { Context } from \\\"@openzeppelin/contracts/utils/Context.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\n/// @title AccessControl\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Fork of OpenZeppelin's `AccessManaged` contract\\n/// updated to make _checkCanCall to return bool\\n/// https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/manager/AccessManaged.sol\\ncontract AccessManaged is Context, IAccessManaged {\\n  address private _authority;\\n\\n  bool private _consumingSchedule;\\n\\n  /**\\n   * @dev Initializes the contract connected to an initial authority.\\n   */\\n  constructor(address initialAuthority) {\\n    _setAuthority(initialAuthority);\\n  }\\n\\n  /**\\n   * @dev Restricts access to a function as defined by the connected Authority for this contract and the\\n   * caller and selector of the function that entered the contract.\\n   *\\n   * [IMPORTANT]\\n   * ====\\n   * In general, this modifier should only be used on `external` functions. It is okay to use it on `public`\\n   * functions that are used as external entry points and are not called internally. Unless you know what you're\\n   * doing, it should never be used on `internal` functions. Failure to follow these rules can have critical security\\n   * implications! This is because the permissions are determined by the function that entered the contract, i.e. the\\n   * function at the bottom of the call stack, and not the function where the modifier is visible in the source code.\\n   * ====\\n   *\\n   * [WARNING]\\n   * ====\\n   * Avoid adding this modifier to the\\n   * https://docs.soliditylang.org/en/v0.8.20/contracts.html#receive-ether-function[`receive()`]\\n   * function or the https://docs.soliditylang.org/en/v0.8.20/contracts.html#fallback-function[`fallback()`]. These\\n   * functions are the only execution paths where a function selector cannot be unambiguously determined from the\\n   * calldata\\n   * since the selector defaults to `0x00000000` in the `receive()` function and similarly in the `fallback()`\\n   * function\\n   * if no calldata is provided. (See {_checkCanCall}).\\n   *\\n   * The `receive()` function will always panic whereas the `fallback()` may panic depending on the calldata length.\\n   * ====\\n   */\\n  modifier restricted() {\\n    address caller = _msgSender();\\n    require(_checkCanCall(caller, _msgData()), AccessManagedUnauthorized(caller));\\n    _;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function authority() public view virtual returns (address) {\\n    return _authority;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function setAuthority(address newAuthority) public virtual {\\n    address caller = _msgSender();\\n    if (caller != authority()) {\\n      revert AccessManagedUnauthorized(caller);\\n    }\\n    if (newAuthority.code.length == 0) {\\n      revert AccessManagedInvalidAuthority(newAuthority);\\n    }\\n    _setAuthority(newAuthority);\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function isConsumingScheduledOp() public view returns (bytes4) {\\n    return _consumingSchedule ? this.isConsumingScheduledOp.selector : bytes4(0);\\n  }\\n\\n  /**\\n   * @dev Transfers control to a new authority. Internal function with no access restriction. Allows bypassing the\\n   * permissions set by the current authority.\\n   */\\n  function _setAuthority(address newAuthority) internal virtual {\\n    _authority = newAuthority;\\n    emit AuthorityUpdated(newAuthority);\\n  }\\n\\n  function _checkCanCall(address caller, bytes calldata data) internal virtual returns (bool) {\\n    (bool immediate, uint32 delay) =\\n      AuthorityUtils.canCallWithDelay(authority(), caller, address(this), bytes4(data[0:4]));\\n    if (!immediate) {\\n      if (delay > 0) {\\n        _consumingSchedule = true;\\n        IAccessManager(authority()).consumeScheduledOp(caller, data);\\n        _consumingSchedule = false;\\n      } else {\\n        return false;\\n      }\\n    }\\n    return true;\\n  }\\n}\\n\",\"keccak256\":\"0x40dfee0e736695b3005df6c150a2d794ac06f3f4b91745e2959623e770044798\",\"license\":\"BUSL-1.1\"},\"contracts/utils/Constants.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { ICbETH } from \\\"contracts/interfaces/external/coinbase/ICbETH.sol\\\";\\nimport { ISfrxETH } from \\\"contracts/interfaces/external/frax/ISfrxETH.sol\\\";\\nimport { IStETH } from \\\"contracts/interfaces/external/lido/IStETH.sol\\\";\\nimport { IRETH } from \\\"contracts/interfaces/external/rocketPool/IRETH.sol\\\";\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                 STORAGE SLOTS                                                  \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n/// @dev Storage position of `DiamondStorage` structure\\n/// @dev Equals `keccak256(\\\"diamond.standard.diamond.storage\\\") - 1`\\nbytes32 constant DIAMOND_STORAGE_POSITION = 0xc8fcad8db84d3cc18b4c41d551ea0ee66dd599cde068d998e57d5e09332c131b;\\n\\n/// @dev Storage position of `ParallelizerStorage` structure\\n/// @dev Equals `keccak256(\\\"diamond.standard.parallelizer.storage\\\") - 1`\\nbytes32 constant TRANSMUTER_STORAGE_POSITION = 0x4b2dd303f68b99d244b702089c802b6e9ea1b5d4ef61fd436d6c41abb1178c75;\\n\\n/// @dev Storage position of `ImplementationStorage` structure\\n/// @dev Equals `keccak256(\\\"eip1967.proxy.implementation\\\") - 1`\\nbytes32 constant IMPLEMENTATION_STORAGE_POSITION = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                     MATHS                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nuint256 constant BASE_6 = 1e6;\\nuint256 constant BASE_8 = 1e8;\\nuint256 constant BASE_9 = 1e9;\\nuint256 constant BASE_12 = 1e12;\\nuint256 constant BPS = 1e14;\\nuint256 constant BASE_18 = 1e18;\\nuint256 constant HALF_BASE_27 = 1e27 / 2;\\nuint256 constant BASE_27 = 1e27;\\nuint256 constant BASE_36 = 1e36;\\nuint256 constant MAX_BURN_FEE = 999_000_000;\\nuint256 constant MAX_MINT_FEE = BASE_12 - 1;\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                     REENTRANT                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\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.\\nuint8 constant NOT_ENTERED = 1;\\nuint8 constant ENTERED = 2;\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                     REENTRANT                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n// Role IDs for the AccessManager\\nuint64 constant GOVERNOR_ROLE = 10;\\nuint64 constant GUARDIAN_ROLE = 20;\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                               COMMON ADDRESSES                                                 \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\naddress constant PERMIT_2 = 0x000000000022D473030F116dDEE9F6B43aC78BA3;\\naddress constant ODOS_ROUTER = 0x19cEeAd7105607Cd444F5ad10dd51356436095a1;\\nICbETH constant CBETH = ICbETH(0xBe9895146f7AF43049ca1c1AE358B0541Ea49704);\\nIRETH constant RETH = IRETH(0xae78736Cd615f374D3085123A210448E74Fc6393);\\nIStETH constant STETH = IStETH(0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84);\\nISfrxETH constant SFRXETH = ISfrxETH(0xac3E018457B222d93114458476f3E3416Abbe38F);\\naddress constant XEVT = 0x3Ee320c9F73a84D1717557af00695A34b26d1F1d;\\naddress constant USDM = 0x59D9356E565Ab3A36dD77763Fc0d87fEaf85508C;\\naddress constant USDC = 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48;\\naddress constant EURC = 0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c;\\n\",\"keccak256\":\"0xc96a9c89a4d1b9f1a7f4ff42f56942d6f757e5b8528ecea53b18b68e2f88b559\",\"license\":\"BUSL-1.1\"},\"contracts/utils/Errors.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nerror AccessManagedUnauthorized(address caller);\\nerror AlreadyAdded();\\nerror CannotAddFunctionToDiamondThatAlreadyExists(bytes4 _selector);\\nerror CannotAddSelectorsToZeroAddress(bytes4[] _selectors);\\nerror CannotRemoveFunctionThatDoesNotExist(bytes4 _selector);\\nerror CannotRemoveImmutableFunction(bytes4 _selector);\\nerror CannotReplaceFunctionsFromFacetWithZeroAddress(bytes4[] _selectors);\\nerror CannotReplaceFunctionThatDoesNotExists(bytes4 _selector);\\nerror CannotReplaceFunctionWithTheSameFunctionFromTheSameFacet(bytes4 _selector);\\nerror CannotReplaceImmutableFunction(bytes4 _selector);\\nerror ContractHasNoCode();\\nerror CollateralBacked();\\nerror FunctionNotFound(bytes4 _functionSelector);\\nerror IncorrectFacetCutAction(uint8 _action);\\nerror InitializationFunctionReverted(address _initializationContractAddress, bytes _calldata);\\nerror InvalidChainlinkRate();\\nerror InvalidLengths();\\nerror InvalidNegativeFees();\\nerror InvalidOracleType();\\nerror InvalidParam();\\nerror InvalidParams();\\nerror InvalidRate();\\nerror InvalidSwap();\\nerror InvalidTokens();\\nerror InvalidAccessManager();\\nerror ManagerHasAssets();\\nerror NoSelectorsProvidedForFacetForCut(address _facetAddress);\\nerror NotAllowed();\\nerror NotCollateral();\\nerror NotGovernor();\\nerror NotGuardian();\\nerror NotTrusted();\\nerror NotTrustedOrGuardian();\\nerror NotWhitelisted();\\nerror OdosSwapFailed();\\nerror OracleUpdateFailed();\\nerror Paused();\\nerror ReentrantCall();\\nerror RemoveFacetAddressMustBeZeroAddress(address _facetAddress);\\nerror TooBigAmountIn();\\nerror TooLate();\\nerror TooSmallAmountOut();\\nerror ZeroAddress();\\nerror ZeroAmount();\\nerror SwapError();\\nerror SlippageTooHigh();\\nerror InsufficientFunds();\\n\",\"keccak256\":\"0x1e2f6812ef78e948e5155d32213b52afff8c0ba5463d18bee10694efbf886130\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
-  "bytecode": "0x60e080604052346101e95760c08161278a803803809161001f828561020f565b8339810103126101e95761003281610246565b9061003f60208201610246565b6040820151926001600160a01b038416918285036101e95760608401516001600160a01b03811681036101e95760a061007a60808701610246565b950151956001600160a01b038716958688036101e9575f80546001600160a01b0319166001600160a01b0390921691821790556040519081527f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad90602090a160a052608052600480546001600160a01b039283166001600160a01b0319918216179091556005805493909216921691909117905581156102005760446020925f9460c052604051948593849263095ea7b360e01b84526004840152811960248401525af180156101f5576101b9575b60405161252f908161025b823960805181818161027601528181610ce401528181610e1b01528181611d1901526120ab015260a0518181816103bf0152818161066a01528181610e480152818161155201526115d9015260c05181818161040701528181610d5901526115960152f35b6020813d6020116101ed575b816101d26020938361020f565b810103126101e95751801515036101e9575f610149565b5f80fd5b3d91506101c5565b6040513d5f823e3d90fd5b63d92e233d60e01b5f5260045ffd5b601f909101601f19168101906001600160401b0382119082101761023257604052565b634e487b7160e01b5f52604160045260245ffd5b51906001600160a01b03821682036101e95756fe60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220f7392220a2d873c27631cf836ea0ca59ac953830b210fab4acd0d45ac60142a264736f6c634300081c0033",
-  "deployedBytecode": "0x60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220f7392220a2d873c27631cf836ea0ca59ac953830b210fab4acd0d45ac60142a264736f6c634300081c0033",
-  "devdoc": {
-    "author": "Cooper Labs",
-    "custom:contact": "security@cooperlabs.xyz",
-    "details": "Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol",
-    "errors": {
-      "SafeERC20FailedOperation(address)": [
-        {
-          "details": "An operation with an ERC-20 token failed."
-        }
-      ]
-    },
-    "events": {
-      "AuthorityUpdated(address)": {
-        "details": "Authority that manages this contract was updated."
-      }
-    },
-    "kind": "dev",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to add to the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "authority()": {
-        "details": "Returns the current authority."
-      },
-      "computeRebalanceAmount(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        },
-        "returns": {
-          "amount": "amount to be rebalanced",
-          "increase": "whether the exposure should be increased"
-        }
-      },
-      "harvest(address,uint256,bytes)": {
-        "details": "This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage"
-      },
-      "isConsumingScheduledOp()": {
-        "details": "Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls."
-      },
-      "onFlashLoan(address,address,uint256,uint256,bytes)": {
-        "details": "Receive a flash loan.",
-        "params": {
-          "amount": "The amount of tokens lent.",
-          "data": "Arbitrary data structure, intended to contain user-defined parameters.",
-          "fee": "The additional amount of tokens to repay.",
-          "initiator": "The initiator of the loan.",
-          "token": "The loan currency."
-        },
-        "returns": {
-          "_0": "The keccak256 hash of \"ERC3156FlashBorrower.onFlashLoan\""
-        }
-      },
-      "recoverERC20(address,uint256,address)": {
-        "params": {
-          "amountToRecover": "amount to recover",
-          "to": "address to send the recovered tokens",
-          "tokenAddress": "address of the token to recover"
-        }
-      },
-      "removeBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to remove from the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "setAuthority(address)": {
-        "details": "Transfers control to a new authority. The caller must be the current authority."
-      },
-      "setMaxSlippage(address,uint96)": {
-        "params": {
-          "newMaxSlippage": "new max allowed slippage"
-        }
-      },
-      "setSwapRouter(address)": {
-        "params": {
-          "newSwapRouter": "address of the swap router"
-        }
-      },
-      "setTargetExposure(address,uint64)": {
-        "params": {
-          "targetExposure": "target exposure to the yield bearing asset used",
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      },
-      "setTokenTransferAddress(address)": {
-        "params": {
-          "newTokenTransferAddress": "address of the token transfer contract"
-        }
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "params": {
-          "asset": "address of the asset",
-          "maxExposure": "maximum exposure within the Parallelizer to the asset",
-          "minExposure": "minimum exposure within the Parallelizer to the asset",
-          "overrideExposures": "whether limit exposures should be overriden or read onchain through the Parallelizer",
-          "targetExposure": "target exposure to the yieldBearingAsset asset used",
-          "yieldBearingAsset": "address of the yieldBearingAsset"
-        }
-      },
-      "toggleTrusted(address)": {
-        "params": {
-          "trusted": "address to toggle the trusted status"
-        }
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      }
-    },
-    "title": "GenericHarvester",
-    "version": 1
-  },
-  "userdoc": {
-    "events": {
-      "SwapRouterUpdated(address)": {
-        "notice": "Event emitted when the swap router is updated"
-      },
-      "TokenTransferAddressUpdated(address)": {
-        "notice": "Event emitted when the token proxy is updated"
-      }
-    },
-    "kind": "user",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "notice": "Add budget to be spent by the receiver during the flashloan"
-      },
-      "budget(address)": {
-        "notice": "Budget of tokenP available for each users"
-      },
-      "computeRebalanceAmount(address)": {
-        "notice": "Compute the amount needed to rebalance the Parallelizer"
-      },
-      "flashloan()": {
-        "notice": "Parallel stablecoin flashloan contract"
-      },
-      "harvest(address,uint256,bytes)": {
-        "notice": "Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset"
-      },
-      "isTrusted(address)": {
-        "notice": "trusted addresses that can update target exposure and do others non critical operations"
-      },
-      "maxTokenSlippage(address)": {
-        "notice": "Max slippage when dealing with the Parallelizer"
-      },
-      "parallelizer()": {
-        "notice": "Reference to the `parallelizer` implementation this contract aims at rebalancing"
-      },
-      "recoverERC20(address,uint256,address)": {
-        "notice": "Recover ERC20 tokens"
-      },
-      "removeBudget(uint256,address)": {
-        "notice": "Remove budget from the owner and send it to the receiver"
-      },
-      "setMaxSlippage(address,uint96)": {
-        "notice": "Set the max allowed slippage"
-      },
-      "setSwapRouter(address)": {
-        "notice": "Set the swap router"
-      },
-      "setTargetExposure(address,uint64)": {
-        "notice": "Set the target exposure of a yield bearing asset"
-      },
-      "setTokenTransferAddress(address)": {
-        "notice": "Set the token transfer address"
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "notice": "Set the yieldBearingAsset data"
-      },
-      "swapRouter()": {
-        "notice": "address of the router/aggregator"
-      },
-      "toggleTrusted(address)": {
-        "notice": "Toggle the trusted status of an address"
-      },
-      "tokenP()": {
-        "notice": "TokenP handled by the `parallelizer` of interest"
-      },
-      "tokenTransferAddress()": {
-        "notice": "address to approve to transfer tokens to"
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "notice": "Set the limit exposures to the asset linked to the yield bearing asset"
-      },
-      "yieldBearingData(address)": {
-        "notice": "Data associated to a yield bearing asset"
-      }
-    },
-    "version": 1
-  },
-  "storageLayout": {
-    "storage": [
-      {
-        "astId": 22997,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_authority",
-        "offset": 0,
-        "slot": "0",
-        "type": "t_address"
-      },
-      {
-        "astId": 22999,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_consumingSchedule",
-        "offset": 20,
-        "slot": "0",
-        "type": "t_bool"
-      },
-      {
-        "astId": 8228,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "maxTokenSlippage",
-        "offset": 0,
-        "slot": "1",
-        "type": "t_mapping(t_address,t_uint96)"
-      },
-      {
-        "astId": 8234,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "yieldBearingData",
-        "offset": 0,
-        "slot": "2",
-        "type": "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)"
-      },
-      {
-        "astId": 8239,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "isTrusted",
-        "offset": 0,
-        "slot": "3",
-        "type": "t_mapping(t_address,t_bool)"
-      },
-      {
-        "astId": 43,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "swapRouter",
-        "offset": 0,
-        "slot": "4",
-        "type": "t_address"
-      },
-      {
-        "astId": 46,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "tokenTransferAddress",
-        "offset": 0,
-        "slot": "5",
-        "type": "t_address"
-      },
-      {
-        "astId": 8956,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "budget",
-        "offset": 0,
-        "slot": "6",
-        "type": "t_mapping(t_address,t_uint256)"
-      }
-    ],
-    "types": {
-      "t_address": {
-        "encoding": "inplace",
-        "label": "address",
-        "numberOfBytes": "20"
-      },
-      "t_bool": {
-        "encoding": "inplace",
-        "label": "bool",
-        "numberOfBytes": "1"
-      },
-      "t_mapping(t_address,t_bool)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => bool)",
-        "numberOfBytes": "32",
-        "value": "t_bool"
-      },
-      "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => struct YieldBearingParams)",
-        "numberOfBytes": "32",
-        "value": "t_struct(YieldBearingParams)8169_storage"
-      },
-      "t_mapping(t_address,t_uint256)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint256)",
-        "numberOfBytes": "32",
-        "value": "t_uint256"
-      },
-      "t_mapping(t_address,t_uint96)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint96)",
-        "numberOfBytes": "32",
-        "value": "t_uint96"
-      },
-      "t_struct(YieldBearingParams)8169_storage": {
-        "encoding": "inplace",
-        "label": "struct YieldBearingParams",
-        "members": [
-          {
-            "astId": 8158,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "asset",
-            "offset": 0,
-            "slot": "0",
-            "type": "t_address"
-          },
-          {
-            "astId": 8160,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "targetExposure",
-            "offset": 20,
-            "slot": "0",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8162,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxExposure",
-            "offset": 0,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8164,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "minExposure",
-            "offset": 8,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8166,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "overrideExposures",
-            "offset": 16,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8168,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxSlippage",
-            "offset": 0,
-            "slot": "2",
-            "type": "t_uint96"
-          }
-        ],
-        "numberOfBytes": "96"
-      },
-      "t_uint256": {
-        "encoding": "inplace",
-        "label": "uint256",
-        "numberOfBytes": "32"
-      },
-      "t_uint64": {
-        "encoding": "inplace",
-        "label": "uint64",
-        "numberOfBytes": "8"
-      },
-      "t_uint96": {
-        "encoding": "inplace",
-        "label": "uint96",
-        "numberOfBytes": "12"
-      }
-    }
-  }
-}
\ No newline at end of file
diff --git a/deployments/mainnet/GenericHarvester_USDp.json b/deployments/mainnet/GenericHarvester_USDp.json
deleted file mode 100644
index ed0ab7c..0000000
--- a/deployments/mainnet/GenericHarvester_USDp.json
+++ /dev/null
@@ -1,1124 +0,0 @@
-{
-  "address": "0x36DA06796fD9d22BCD6287b66A87FfdadB12636C",
-  "abi": [
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initialTokenTransferAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialSwapRouter",
-          "type": "address"
-        },
-        {
-          "internalType": "contract ITokenP",
-          "name": "definitivetokenP",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IParallelizer",
-          "name": "definitiveParallelizer",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialAuthority",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "definitiveFlashloan",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "constructor"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedInvalidAuthority",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        },
-        {
-          "internalType": "uint32",
-          "name": "delay",
-          "type": "uint32"
-        }
-      ],
-      "name": "AccessManagedRequiredDelay",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedUnauthorized",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "InvalidParam",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrusted",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrustedOrGuardian",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        }
-      ],
-      "name": "SafeERC20FailedOperation",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "SwapError",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAddress",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAmount",
-      "type": "error"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AuthorityUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "Recovered",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "SwapRouterUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "TokenTransferAddressUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "bool",
-          "name": "status",
-          "type": "bool"
-        }
-      ],
-      "name": "TrustedToggled",
-      "type": "event"
-    },
-    {
-      "inputs": [],
-      "name": "CALLBACK_SUCCESS",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "addBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "authority",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "budget",
-      "outputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "computeRebalanceAmount",
-      "outputs": [
-        {
-          "internalType": "uint8",
-          "name": "increase",
-          "type": "uint8"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "flashloan",
-      "outputs": [
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "scale",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "extraData",
-          "type": "bytes"
-        }
-      ],
-      "name": "harvest",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "isConsumingScheduledOp",
-      "outputs": [
-        {
-          "internalType": "bytes4",
-          "name": "",
-          "type": "bytes4"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "isTrusted",
-      "outputs": [
-        {
-          "internalType": "bool",
-          "name": "",
-          "type": "bool"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "maxTokenSlippage",
-      "outputs": [
-        {
-          "internalType": "uint96",
-          "name": "",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initiator",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "uint256",
-          "name": "fee",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "data",
-          "type": "bytes"
-        }
-      ],
-      "name": "onFlashLoan",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "parallelizer",
-      "outputs": [
-        {
-          "internalType": "contract IParallelizer",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "tokenAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amountToRecover",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "recoverERC20",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "removeBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newAuthority",
-          "type": "address"
-        }
-      ],
-      "name": "setAuthority",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint96",
-          "name": "newMaxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setMaxSlippage",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "setSwapRouter",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        }
-      ],
-      "name": "setTargetExposure",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "setTokenTransferAddress",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setYieldBearingAssetData",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "swapRouter",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        }
-      ],
-      "name": "toggleTrusted",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenP",
-      "outputs": [
-        {
-          "internalType": "contract ITokenP",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenTransferAddress",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "updateLimitExposuresYieldAsset",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "yieldBearingData",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    }
-  ],
-  "transactionHash": "0x78fe720c21dd98061214a9c0d69c36b334885e137b70a84d82896ec5a122ed43",
-  "receipt": {
-    "to": null,
-    "from": "0x66CcEC236bbcE5f1bBd1b2fC0a4014e57A55ad02",
-    "contractAddress": "0x36DA06796fD9d22BCD6287b66A87FfdadB12636C",
-    "transactionIndex": 23,
-    "gasUsed": "2210601",
-    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000010000000000000000000000000000000000400000000000000000000000000000008000000000000000000040000000000020000000080010000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000008000000000000010011000000000000008000000000000000000000000820000000000000000",
-    "blockHash": "0x72aeb2adc9b23d9bcb197b167959c0e6a72b511afdcb61b2ce66a5d6ef399fa3",
-    "transactionHash": "0x78fe720c21dd98061214a9c0d69c36b334885e137b70a84d82896ec5a122ed43",
-    "logs": [
-      {
-        "transactionIndex": 23,
-        "blockNumber": 22767046,
-        "transactionHash": "0x78fe720c21dd98061214a9c0d69c36b334885e137b70a84d82896ec5a122ed43",
-        "address": "0x36DA06796fD9d22BCD6287b66A87FfdadB12636C",
-        "topics": [
-          "0x2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad"
-        ],
-        "data": "0x00000000000000000000000094ea8800444017695345156319e96bdb1e355f7a",
-        "logIndex": 222,
-        "blockHash": "0x72aeb2adc9b23d9bcb197b167959c0e6a72b511afdcb61b2ce66a5d6ef399fa3"
-      },
-      {
-        "transactionIndex": 23,
-        "blockNumber": 22767046,
-        "transactionHash": "0x78fe720c21dd98061214a9c0d69c36b334885e137b70a84d82896ec5a122ed43",
-        "address": "0x9B3a8f7CEC208e247d97dEE13313690977e24459",
-        "topics": [
-          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
-          "0x00000000000000000000000036da06796fd9d22bcd6287b66a87ffdadb12636c",
-          "0x000000000000000000000000c9b6279baa19dbb8bcc3250c89caa093aaba0bfc"
-        ],
-        "data": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
-        "logIndex": 223,
-        "blockHash": "0x72aeb2adc9b23d9bcb197b167959c0e6a72b511afdcb61b2ce66a5d6ef399fa3"
-      }
-    ],
-    "blockNumber": 22767046,
-    "cumulativeGasUsed": "10462236",
-    "status": 1,
-    "byzantium": true
-  },
-  "args": [
-    "0xcf5540fffcdc3d510b18bfca6d2b9987b0772559",
-    "0xcf5540fffcdc3d510b18bfca6d2b9987b0772559",
-    "0x9B3a8f7CEC208e247d97dEE13313690977e24459",
-    "0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2",
-    "0x94Ea8800444017695345156319e96bdB1E355F7a",
-    "0xC9B6279baa19dBB8bCc3250c89cAa093AaBA0bfc"
-  ],
-  "numDeployments": 1,
-  "solcInputHash": "9e6800737641b3b015331b65b5c620c3",
-  "metadata": "{\"compiler\":{\"version\":\"0.8.28+commit.7893614a\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initialTokenTransferAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialSwapRouter\",\"type\":\"address\"},{\"internalType\":\"contract ITokenP\",\"name\":\"definitivetokenP\",\"type\":\"address\"},{\"internalType\":\"contract IParallelizer\",\"name\":\"definitiveParallelizer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialAuthority\",\"type\":\"address\"},{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"definitiveFlashloan\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AccessManagedInvalidAuthority\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"delay\",\"type\":\"uint32\"}],\"name\":\"AccessManagedRequiredDelay\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"AccessManagedUnauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidParam\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrusted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrustedOrGuardian\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"SafeERC20FailedOperation\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"SwapError\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAmount\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AuthorityUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"Recovered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"SwapRouterUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"TokenTransferAddressUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"status\",\"type\":\"bool\"}],\"name\":\"TrustedToggled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"CALLBACK_SUCCESS\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"addBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"budget\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"computeRebalanceAmount\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"increase\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"flashloan\",\"outputs\":[{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"scale\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"extraData\",\"type\":\"bytes\"}],\"name\":\"harvest\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isConsumingScheduledOp\",\"outputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"isTrusted\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"maxTokenSlippage\",\"outputs\":[{\"internalType\":\"uint96\",\"name\":\"\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initiator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"fee\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"onFlashLoan\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"parallelizer\",\"outputs\":[{\"internalType\":\"contract IParallelizer\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amountToRecover\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"recoverERC20\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"removeBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAuthority\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint96\",\"name\":\"newMaxSlippage\",\"type\":\"uint96\"}],\"name\":\"setMaxSlippage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"setSwapRouter\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"}],\"name\":\"setTargetExposure\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"setTokenTransferAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"name\":\"setYieldBearingAssetData\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"swapRouter\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"}],\"name\":\"toggleTrusted\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenP\",\"outputs\":[{\"internalType\":\"contract ITokenP\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenTransferAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"updateLimitExposuresYieldAsset\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"yieldBearingData\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Cooper Labs\",\"custom:contact\":\"security@cooperlabs.xyz\",\"details\":\"Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\",\"errors\":{\"SafeERC20FailedOperation(address)\":[{\"details\":\"An operation with an ERC-20 token failed.\"}]},\"events\":{\"AuthorityUpdated(address)\":{\"details\":\"Authority that manages this contract was updated.\"}},\"kind\":\"dev\",\"methods\":{\"addBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to add to the budget\",\"receiver\":\"address of the receiver\"}},\"authority()\":{\"details\":\"Returns the current authority.\"},\"computeRebalanceAmount(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"},\"returns\":{\"amount\":\"amount to be rebalanced\",\"increase\":\"whether the exposure should be increased\"}},\"harvest(address,uint256,bytes)\":{\"details\":\"This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage\"},\"isConsumingScheduledOp()\":{\"details\":\"Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls.\"},\"onFlashLoan(address,address,uint256,uint256,bytes)\":{\"details\":\"Receive a flash loan.\",\"params\":{\"amount\":\"The amount of tokens lent.\",\"data\":\"Arbitrary data structure, intended to contain user-defined parameters.\",\"fee\":\"The additional amount of tokens to repay.\",\"initiator\":\"The initiator of the loan.\",\"token\":\"The loan currency.\"},\"returns\":{\"_0\":\"The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\"}},\"recoverERC20(address,uint256,address)\":{\"params\":{\"amountToRecover\":\"amount to recover\",\"to\":\"address to send the recovered tokens\",\"tokenAddress\":\"address of the token to recover\"}},\"removeBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to remove from the budget\",\"receiver\":\"address of the receiver\"}},\"setAuthority(address)\":{\"details\":\"Transfers control to a new authority. The caller must be the current authority.\"},\"setMaxSlippage(address,uint96)\":{\"params\":{\"newMaxSlippage\":\"new max allowed slippage\"}},\"setSwapRouter(address)\":{\"params\":{\"newSwapRouter\":\"address of the swap router\"}},\"setTargetExposure(address,uint64)\":{\"params\":{\"targetExposure\":\"target exposure to the yield bearing asset used\",\"yieldBearingAsset\":\"address of the yield bearing asset\"}},\"setTokenTransferAddress(address)\":{\"params\":{\"newTokenTransferAddress\":\"address of the token transfer contract\"}},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"params\":{\"asset\":\"address of the asset\",\"maxExposure\":\"maximum exposure within the Parallelizer to the asset\",\"minExposure\":\"minimum exposure within the Parallelizer to the asset\",\"overrideExposures\":\"whether limit exposures should be overriden or read onchain through the Parallelizer\",\"targetExposure\":\"target exposure to the yieldBearingAsset asset used\",\"yieldBearingAsset\":\"address of the yieldBearingAsset\"}},\"toggleTrusted(address)\":{\"params\":{\"trusted\":\"address to toggle the trusted status\"}},\"updateLimitExposuresYieldAsset(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"}}},\"title\":\"GenericHarvester\",\"version\":1},\"userdoc\":{\"events\":{\"SwapRouterUpdated(address)\":{\"notice\":\"Event emitted when the swap router is updated\"},\"TokenTransferAddressUpdated(address)\":{\"notice\":\"Event emitted when the token proxy is updated\"}},\"kind\":\"user\",\"methods\":{\"addBudget(uint256,address)\":{\"notice\":\"Add budget to be spent by the receiver during the flashloan\"},\"budget(address)\":{\"notice\":\"Budget of tokenP available for each users\"},\"computeRebalanceAmount(address)\":{\"notice\":\"Compute the amount needed to rebalance the Parallelizer\"},\"flashloan()\":{\"notice\":\"Parallel stablecoin flashloan contract\"},\"harvest(address,uint256,bytes)\":{\"notice\":\"Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset\"},\"isTrusted(address)\":{\"notice\":\"trusted addresses that can update target exposure and do others non critical operations\"},\"maxTokenSlippage(address)\":{\"notice\":\"Max slippage when dealing with the Parallelizer\"},\"parallelizer()\":{\"notice\":\"Reference to the `parallelizer` implementation this contract aims at rebalancing\"},\"recoverERC20(address,uint256,address)\":{\"notice\":\"Recover ERC20 tokens\"},\"removeBudget(uint256,address)\":{\"notice\":\"Remove budget from the owner and send it to the receiver\"},\"setMaxSlippage(address,uint96)\":{\"notice\":\"Set the max allowed slippage\"},\"setSwapRouter(address)\":{\"notice\":\"Set the swap router\"},\"setTargetExposure(address,uint64)\":{\"notice\":\"Set the target exposure of a yield bearing asset\"},\"setTokenTransferAddress(address)\":{\"notice\":\"Set the token transfer address\"},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"notice\":\"Set the yieldBearingAsset data\"},\"swapRouter()\":{\"notice\":\"address of the router/aggregator\"},\"toggleTrusted(address)\":{\"notice\":\"Toggle the trusted status of an address\"},\"tokenP()\":{\"notice\":\"TokenP handled by the `parallelizer` of interest\"},\"tokenTransferAddress()\":{\"notice\":\"address to approve to transfer tokens to\"},\"updateLimitExposuresYieldAsset(address)\":{\"notice\":\"Set the limit exposures to the asset linked to the yield bearing asset\"},\"yieldBearingData(address)\":{\"notice\":\"Data associated to a yield bearing asset\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/helpers/GenericHarvester.sol\":\"GenericHarvester\"},\"evmVersion\":\"cancun\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@helpers/RouterSwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\n/// @title Swapper\\n/// @author Angle Labs, Inc.\\n/// @dev Abstract contract for swapping tokens using a router/aggregator\\n/// @dev This contract is an authorized fork of Angle's `RouterSwapper` contract\\n/// https://github.com/AngleProtocol/utils/blob/main/src/RouterSwapper.sol\\nabstract contract RouterSwapper {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               ERRORS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  error SwapError();\\n  error ZeroAddress();\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                EVENTS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   *  @notice Event emitted when the swap router is updated\\n   */\\n  event SwapRouterUpdated(address newSwapRouter);\\n  /**\\n   *  @notice Event emitted when the token proxy is updated\\n   */\\n  event TokenTransferAddressUpdated(address newTokenTransferAddress);\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                MODIFIERS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  modifier noZeroAddress(address targetAddress) {\\n    if (targetAddress == address(0)) {\\n      revert ZeroAddress();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                            MUTABLE VARIABLES\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice address of the router/aggregator\\n   */\\n  address public swapRouter;\\n  /**\\n   * @notice address to approve to transfer tokens to\\n   */\\n  address public tokenTransferAddress;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               CONSTRUCTOR\\n    //////////////////////////////////////////////////////////////*/\\n\\n  constructor(address initialSwapRouter, address initialTokenTransferAddress) {\\n    swapRouter = initialSwapRouter;\\n    tokenTransferAddress = initialTokenTransferAddress;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             ADMIN FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the router/aggregator address\\n   * @param newSwapRouter address of the new router/aggregator\\n   */\\n  function setSwapRouter(address newSwapRouter) public virtual noZeroAddress(newSwapRouter) {\\n    swapRouter = newSwapRouter;\\n\\n    emit SwapRouterUpdated(newSwapRouter);\\n  }\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the new token transfer address\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress)\\n    public\\n    virtual\\n    noZeroAddress(newTokenTransferAddress)\\n  {\\n    tokenTransferAddress = newTokenTransferAddress;\\n\\n    emit TokenTransferAddressUpdated(newTokenTransferAddress);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             SWAP FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Approve the router/aggregator to spend the token if needed\\n   * @param token address of the token to approve\\n   * @param spender address of the router/aggregator\\n   * @param amount amount to approve\\n   */\\n  function _approveTokenIfNeeded(address token, address spender, uint256 amount) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), spender);\\n    if (allowance < amount) {\\n      IERC20(token).safeIncreaseAllowance(spender, amount - allowance);\\n    }\\n  }\\n\\n  /**\\n   * @notice Perform the swap using the router/aggregator\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _performRouterSwap(bytes memory callData) internal {\\n    (bool success, bytes memory retData) = swapRouter.call(callData);\\n\\n    if (!success) {\\n      if (retData.length != 0) {\\n        assembly (\\\"memory-safe\\\") {\\n          revert(add(32, retData), mload(retData))\\n        }\\n      }\\n      revert SwapError();\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swapCalldata(address[] calldata tokens, bytes[] calldata callDatas, uint256[] calldata amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swap(address[] memory tokens, bytes[] memory callDatas, uint256[] memory amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x8c5a6b026a95816806814ef681b6b225ea4c405a39a4eab0111921853202829c\",\"license\":\"GPL-3.0\"},\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/AuthorityUtils.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IAuthority} from \\\"./IAuthority.sol\\\";\\n\\nlibrary AuthorityUtils {\\n    /**\\n     * @dev Since `AccessManager` implements an extended IAuthority interface, invoking `canCall` with backwards compatibility\\n     * for the preexisting `IAuthority` interface requires special care to avoid reverting on insufficient return data.\\n     * This helper function takes care of invoking `canCall` in a backwards compatible way without reverting.\\n     */\\n    function canCallWithDelay(\\n        address authority,\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) internal view returns (bool immediate, uint32 delay) {\\n        (bool success, bytes memory data) = authority.staticcall(\\n            abi.encodeCall(IAuthority.canCall, (caller, target, selector))\\n        );\\n        if (success) {\\n            if (data.length >= 0x40) {\\n                (immediate, delay) = abi.decode(data, (bool, uint32));\\n            } else if (data.length >= 0x20) {\\n                immediate = abi.decode(data, (bool));\\n            }\\n        }\\n        return (immediate, delay);\\n    }\\n}\\n\",\"keccak256\":\"0xb3875997b0d8705e29aa20fee88e1dfef93df438794ae1ad8ba2eb016a4dd4e4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAccessManaged.sol)\\n\\npragma solidity ^0.8.20;\\n\\ninterface IAccessManaged {\\n    /**\\n     * @dev Authority that manages this contract was updated.\\n     */\\n    event AuthorityUpdated(address authority);\\n\\n    error AccessManagedUnauthorized(address caller);\\n    error AccessManagedRequiredDelay(address caller, uint32 delay);\\n    error AccessManagedInvalidAuthority(address authority);\\n\\n    /**\\n     * @dev Returns the current authority.\\n     */\\n    function authority() external view returns (address);\\n\\n    /**\\n     * @dev Transfers control to a new authority. The caller must be the current authority.\\n     */\\n    function setAuthority(address) external;\\n\\n    /**\\n     * @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n     * being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n     * attacker controlled calls.\\n     */\\n    function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaba93d42cd70e1418782951132d97b31ddce5f50ad81090884b6d0e41caac9d6\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManager.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (access/manager/IAccessManager.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Time} from \\\"../../utils/types/Time.sol\\\";\\n\\ninterface IAccessManager {\\n    /**\\n     * @dev A delayed operation was scheduled.\\n     */\\n    event OperationScheduled(\\n        bytes32 indexed operationId,\\n        uint32 indexed nonce,\\n        uint48 schedule,\\n        address caller,\\n        address target,\\n        bytes data\\n    );\\n\\n    /**\\n     * @dev A scheduled operation was executed.\\n     */\\n    event OperationExecuted(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev A scheduled operation was canceled.\\n     */\\n    event OperationCanceled(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev Informational labelling for a roleId.\\n     */\\n    event RoleLabel(uint64 indexed roleId, string label);\\n\\n    /**\\n     * @dev Emitted when `account` is granted `roleId`.\\n     *\\n     * NOTE: The meaning of the `since` argument depends on the `newMember` argument.\\n     * If the role is granted to a new member, the `since` argument indicates when the account becomes a member of the role,\\n     * otherwise it indicates the execution delay for this account and roleId is updated.\\n     */\\n    event RoleGranted(uint64 indexed roleId, address indexed account, uint32 delay, uint48 since, bool newMember);\\n\\n    /**\\n     * @dev Emitted when `account` membership or `roleId` is revoked. Unlike granting, revoking is instantaneous.\\n     */\\n    event RoleRevoked(uint64 indexed roleId, address indexed account);\\n\\n    /**\\n     * @dev Role acting as admin over a given `roleId` is updated.\\n     */\\n    event RoleAdminChanged(uint64 indexed roleId, uint64 indexed admin);\\n\\n    /**\\n     * @dev Role acting as guardian over a given `roleId` is updated.\\n     */\\n    event RoleGuardianChanged(uint64 indexed roleId, uint64 indexed guardian);\\n\\n    /**\\n     * @dev Grant delay for a given `roleId` will be updated to `delay` when `since` is reached.\\n     */\\n    event RoleGrantDelayChanged(uint64 indexed roleId, uint32 delay, uint48 since);\\n\\n    /**\\n     * @dev Target mode is updated (true = closed, false = open).\\n     */\\n    event TargetClosed(address indexed target, bool closed);\\n\\n    /**\\n     * @dev Role required to invoke `selector` on `target` is updated to `roleId`.\\n     */\\n    event TargetFunctionRoleUpdated(address indexed target, bytes4 selector, uint64 indexed roleId);\\n\\n    /**\\n     * @dev Admin delay for a given `target` will be updated to `delay` when `since` is reached.\\n     */\\n    event TargetAdminDelayUpdated(address indexed target, uint32 delay, uint48 since);\\n\\n    error AccessManagerAlreadyScheduled(bytes32 operationId);\\n    error AccessManagerNotScheduled(bytes32 operationId);\\n    error AccessManagerNotReady(bytes32 operationId);\\n    error AccessManagerExpired(bytes32 operationId);\\n    error AccessManagerLockedRole(uint64 roleId);\\n    error AccessManagerBadConfirmation();\\n    error AccessManagerUnauthorizedAccount(address msgsender, uint64 roleId);\\n    error AccessManagerUnauthorizedCall(address caller, address target, bytes4 selector);\\n    error AccessManagerUnauthorizedConsume(address target);\\n    error AccessManagerUnauthorizedCancel(address msgsender, address caller, address target, bytes4 selector);\\n    error AccessManagerInvalidInitialAdmin(address initialAdmin);\\n\\n    /**\\n     * @dev Check if an address (`caller`) is authorised to call a given function on a given contract directly (with\\n     * no restriction). Additionally, it returns the delay needed to perform the call indirectly through the {schedule}\\n     * & {execute} workflow.\\n     *\\n     * This function is usually called by the targeted contract to control immediate execution of restricted functions.\\n     * Therefore we only return true if the call can be performed without any delay. If the call is subject to a\\n     * previously set delay (not zero), then the function should return false and the caller should schedule the operation\\n     * for future execution.\\n     *\\n     * If `immediate` is true, the delay can be disregarded and the operation can be immediately executed, otherwise\\n     * the operation can be executed if and only if delay is greater than 0.\\n     *\\n     * NOTE: The IAuthority interface does not include the `uint32` delay. This is an extension of that interface that\\n     * is backward compatible. Some contracts may thus ignore the second return argument. In that case they will fail\\n     * to identify the indirect workflow, and will consider calls that require a delay to be forbidden.\\n     *\\n     * NOTE: This function does not report the permissions of the admin functions in the manager itself. These are defined by the\\n     * {AccessManager} documentation.\\n     */\\n    function canCall(\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) external view returns (bool allowed, uint32 delay);\\n\\n    /**\\n     * @dev Expiration delay for scheduled proposals. Defaults to 1 week.\\n     *\\n     * IMPORTANT: Avoid overriding the expiration with 0. Otherwise every contract proposal will be expired immediately,\\n     * disabling any scheduling usage.\\n     */\\n    function expiration() external view returns (uint32);\\n\\n    /**\\n     * @dev Minimum setback for all delay updates, with the exception of execution delays. It\\n     * can be increased without setback (and reset via {revokeRole} in the case event of an\\n     * accidental increase). Defaults to 5 days.\\n     */\\n    function minSetback() external view returns (uint32);\\n\\n    /**\\n     * @dev Get whether the contract is closed disabling any access. Otherwise role permissions are applied.\\n     *\\n     * NOTE: When the manager itself is closed, admin functions are still accessible to avoid locking the contract.\\n     */\\n    function isTargetClosed(address target) external view returns (bool);\\n\\n    /**\\n     * @dev Get the role required to call a function.\\n     */\\n    function getTargetFunctionRole(address target, bytes4 selector) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the admin delay for a target contract. Changes to contract configuration are subject to this delay.\\n     */\\n    function getTargetAdminDelay(address target) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the id of the role that acts as an admin for the given role.\\n     *\\n     * The admin permission is required to grant the role, revoke the role and update the execution delay to execute\\n     * an operation that is restricted to this role.\\n     */\\n    function getRoleAdmin(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role that acts as a guardian for a given role.\\n     *\\n     * The guardian permission allows canceling operations that have been scheduled under the role.\\n     */\\n    function getRoleGuardian(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role current grant delay.\\n     *\\n     * Its value may change at any point without an event emitted following a call to {setGrantDelay}.\\n     * Changes to this value, including effect timepoint are notified in advance by the {RoleGrantDelayChanged} event.\\n     */\\n    function getRoleGrantDelay(uint64 roleId) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the access details for a given account for a given role. These details include the timepoint at which\\n     * membership becomes active, and the delay applied to all operation by this user that requires this permission\\n     * level.\\n     *\\n     * Returns:\\n     * [0] Timestamp at which the account membership becomes valid. 0 means role is not granted.\\n     * [1] Current execution delay for the account.\\n     * [2] Pending execution delay for the account.\\n     * [3] Timestamp at which the pending execution delay will become active. 0 means no delay update is scheduled.\\n     */\\n    function getAccess(\\n        uint64 roleId,\\n        address account\\n    ) external view returns (uint48 since, uint32 currentDelay, uint32 pendingDelay, uint48 effect);\\n\\n    /**\\n     * @dev Check if a given account currently has the permission level corresponding to a given role. Note that this\\n     * permission might be associated with an execution delay. {getAccess} can provide more details.\\n     */\\n    function hasRole(uint64 roleId, address account) external view returns (bool isMember, uint32 executionDelay);\\n\\n    /**\\n     * @dev Give a label to a role, for improved role discoverability by UIs.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleLabel} event.\\n     */\\n    function labelRole(uint64 roleId, string calldata label) external;\\n\\n    /**\\n     * @dev Add `account` to `roleId`, or change its execution delay.\\n     *\\n     * This gives the account the authorization to call any function that is restricted to this role. An optional\\n     * execution delay (in seconds) can be set. If that delay is non 0, the user is required to schedule any operation\\n     * that is restricted to members of this role. The user will only be able to execute the operation after the delay has\\n     * passed, before it has expired. During this period, admin and guardians can cancel the operation (see {cancel}).\\n     *\\n     * If the account has already been granted this role, the execution delay will be updated. This update is not\\n     * immediate and follows the delay rules. For example, if a user currently has a delay of 3 hours, and this is\\n     * called to reduce that delay to 1 hour, the new delay will take some time to take effect, enforcing that any\\n     * operation executed in the 3 hours that follows this update was indeed scheduled before this update.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - granted role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleGranted} event.\\n     */\\n    function grantRole(uint64 roleId, address account, uint32 executionDelay) external;\\n\\n    /**\\n     * @dev Remove an account from a role, with immediate effect. If the account does not have the role, this call has\\n     * no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - revoked role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function revokeRole(uint64 roleId, address account) external;\\n\\n    /**\\n     * @dev Renounce role permissions for the calling account with immediate effect. If the sender is not in\\n     * the role this call has no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be `callerConfirmation`.\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function renounceRole(uint64 roleId, address callerConfirmation) external;\\n\\n    /**\\n     * @dev Change admin role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleAdminChanged} event\\n     */\\n    function setRoleAdmin(uint64 roleId, uint64 admin) external;\\n\\n    /**\\n     * @dev Change guardian role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGuardianChanged} event\\n     */\\n    function setRoleGuardian(uint64 roleId, uint64 guardian) external;\\n\\n    /**\\n     * @dev Update the delay for granting a `roleId`.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGrantDelayChanged} event.\\n     */\\n    function setGrantDelay(uint64 roleId, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the role required to call functions identified by the `selectors` in the `target` contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetFunctionRoleUpdated} event per selector.\\n     */\\n    function setTargetFunctionRole(address target, bytes4[] calldata selectors, uint64 roleId) external;\\n\\n    /**\\n     * @dev Set the delay for changing the configuration of a given target contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetAdminDelayUpdated} event.\\n     */\\n    function setTargetAdminDelay(address target, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the closed flag for a contract.\\n     *\\n     * Closing the manager itself won't disable access to admin methods to avoid locking the contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetClosed} event.\\n     */\\n    function setTargetClosed(address target, bool closed) external;\\n\\n    /**\\n     * @dev Return the timepoint at which a scheduled operation will be ready for execution. This returns 0 if the\\n     * operation is not yet scheduled, has expired, was executed, or was canceled.\\n     */\\n    function getSchedule(bytes32 id) external view returns (uint48);\\n\\n    /**\\n     * @dev Return the nonce for the latest scheduled operation with a given id. Returns 0 if the operation has never\\n     * been scheduled.\\n     */\\n    function getNonce(bytes32 id) external view returns (uint32);\\n\\n    /**\\n     * @dev Schedule a delayed operation for future execution, and return the operation identifier. It is possible to\\n     * choose the timestamp at which the operation becomes executable as long as it satisfies the execution delays\\n     * required for the caller. The special value zero will automatically set the earliest possible time.\\n     *\\n     * Returns the `operationId` that was scheduled. Since this value is a hash of the parameters, it can reoccur when\\n     * the same parameters are used; if this is relevant, the returned `nonce` can be used to uniquely identify this\\n     * scheduled operation from other occurrences of the same `operationId` in invocations of {execute} and {cancel}.\\n     *\\n     * Emits a {OperationScheduled} event.\\n     *\\n     * NOTE: It is not possible to concurrently schedule more than one operation with the same `target` and `data`. If\\n     * this is necessary, a random byte can be appended to `data` to act as a salt that will be ignored by the target\\n     * contract if it is using standard Solidity ABI encoding.\\n     */\\n    function schedule(\\n        address target,\\n        bytes calldata data,\\n        uint48 when\\n    ) external returns (bytes32 operationId, uint32 nonce);\\n\\n    /**\\n     * @dev Execute a function that is delay restricted, provided it was properly scheduled beforehand, or the\\n     * execution delay is 0.\\n     *\\n     * Returns the nonce that identifies the previously scheduled operation that is executed, or 0 if the\\n     * operation wasn't previously scheduled (if the caller doesn't have an execution delay).\\n     *\\n     * Emits an {OperationExecuted} event only if the call was scheduled and delayed.\\n     */\\n    function execute(address target, bytes calldata data) external payable returns (uint32);\\n\\n    /**\\n     * @dev Cancel a scheduled (delayed) operation. Returns the nonce that identifies the previously scheduled\\n     * operation that is cancelled.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be the proposer, a guardian of the targeted function, or a global admin\\n     *\\n     * Emits a {OperationCanceled} event.\\n     */\\n    function cancel(address caller, address target, bytes calldata data) external returns (uint32);\\n\\n    /**\\n     * @dev Consume a scheduled operation targeting the caller. If such an operation exists, mark it as consumed\\n     * (emit an {OperationExecuted} event and clean the state). Otherwise, throw an error.\\n     *\\n     * This is useful for contract that want to enforce that calls targeting them were scheduled on the manager,\\n     * with all the verifications that it implies.\\n     *\\n     * Emit a {OperationExecuted} event.\\n     */\\n    function consumeScheduledOp(address caller, bytes calldata data) external;\\n\\n    /**\\n     * @dev Hashing function for delayed operations.\\n     */\\n    function hashOperation(address caller, address target, bytes calldata data) external view returns (bytes32);\\n\\n    /**\\n     * @dev Changes the authority of a target managed by this manager instance.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     */\\n    function updateAuthority(address target, address newAuthority) external;\\n}\\n\",\"keccak256\":\"0x9be2d08a326515805bc9cf6315b7953f8d1ebe88abf48c2d645fb1fa8211a0e2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAuthority.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAuthority.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Standard interface for permissioning originally defined in Dappsys.\\n */\\ninterface IAuthority {\\n    /**\\n     * @dev Returns true if the caller can invoke on a target the function identified by a function selector.\\n     */\\n    function canCall(address caller, address target, bytes4 selector) external view returns (bool allowed);\\n}\\n\",\"keccak256\":\"0x4cc0766bd7fb7b3bafb70afa2a93b6e313a0baec7a35ad1b57505be7861c1030\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC1363.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1363.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"./IERC20.sol\\\";\\nimport {IERC165} from \\\"./IERC165.sol\\\";\\n\\n/**\\n * @title IERC1363\\n * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].\\n *\\n * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract\\n * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.\\n */\\ninterface IERC1363 is IERC20, IERC165 {\\n    /*\\n     * Note: the ERC-165 identifier for this interface is 0xb0202a11.\\n     * 0xb0202a11 ===\\n     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))\\n     */\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @param data Additional data with no specified format, sent in call to `spender`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);\\n}\\n\",\"keccak256\":\"0x9b6b3e7803bc5f2f8cd7ad57db8ac1def61a9930a5a3107df4882e028a9605d7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC165} from \\\"../utils/introspection/IERC165.sol\\\";\\n\",\"keccak256\":\"0xde7e9fd9aee8d4f40772f96bb3b58836cbc6dfc0227014a061947f8821ea9724\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../token/ERC20/IERC20.sol\\\";\\n\",\"keccak256\":\"0xce41876e78d1badc0512229b4d14e4daf83bc1003d7f83978d18e0e56f965b9c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashBorrower.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashBorrower, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashBorrower {\\n    /**\\n     * @dev Receive a flash loan.\\n     * @param initiator The initiator of the loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param fee The additional amount of tokens to repay.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     * @return The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\\n     */\\n    function onFlashLoan(\\n        address initiator,\\n        address token,\\n        uint256 amount,\\n        uint256 fee,\\n        bytes calldata data\\n    ) external returns (bytes32);\\n}\\n\",\"keccak256\":\"0x0b1459615b9b47c2a4eec8e72f23ccc601f1d711f679a1c06b3390459021a341\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashLender.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC3156FlashBorrower} from \\\"./IERC3156FlashBorrower.sol\\\";\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashLender, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashLender {\\n    /**\\n     * @dev The amount of currency available to be lended.\\n     * @param token The loan currency.\\n     * @return The amount of `token` that can be borrowed.\\n     */\\n    function maxFlashLoan(address token) external view returns (uint256);\\n\\n    /**\\n     * @dev The fee to be charged for a given loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @return The amount of `token` to be charged for the loan, on top of the returned principal.\\n     */\\n    function flashFee(address token, uint256 amount) external view returns (uint256);\\n\\n    /**\\n     * @dev Initiate a flash loan.\\n     * @param receiver The receiver of the tokens in the loan, and the receiver of the callback.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     */\\n    function flashLoan(\\n        IERC3156FlashBorrower receiver,\\n        address token,\\n        uint256 amount,\\n        bytes calldata data\\n    ) external returns (bool);\\n}\\n\",\"keccak256\":\"0x5d19ea24c555cf6a5dbafea9fac57887cc3e72154f3ee8e0a2bf67971811c14b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-20 standard as defined in the ERC.\\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 value of tokens in existence.\\n     */\\n    function totalSupply() external view returns (uint256);\\n\\n    /**\\n     * @dev Returns the value of tokens owned by `account`.\\n     */\\n    function balanceOf(address account) external view returns (uint256);\\n\\n    /**\\n     * @dev Moves a `value` amount of 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 value) 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 a `value` amount of tokens as the allowance of `spender` over the\\n     * 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 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the\\n     * allowance mechanism. `value` 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 value) external returns (bool);\\n}\\n\",\"keccak256\":\"0xe06a3f08a987af6ad2e1c1e774405d4fe08f1694b67517438b467cecf0da0ef7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC-20 standard.\\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\",\"keccak256\":\"0x70f2f713b13b7ce4610bcd0ac9fec0f3cc43693b043abcb8dc40a42a726eb330\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.2.0) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\nimport {IERC1363} from \\\"../../../interfaces/IERC1363.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC-20 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    /**\\n     * @dev An operation with an ERC-20 token failed.\\n     */\\n    error SafeERC20FailedOperation(address token);\\n\\n    /**\\n     * @dev Indicates a failed `decreaseAllowance` request.\\n     */\\n    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);\\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.encodeCall(token.transfer, (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.encodeCall(token.transferFrom, (from, to, 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     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n        uint256 oldAllowance = token.allowance(address(this), spender);\\n        forceApprove(token, spender, oldAllowance + value);\\n    }\\n\\n    /**\\n     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no\\n     * value, non-reverting calls are assumed to be successful.\\n     *\\n     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {\\n        unchecked {\\n            uint256 currentAllowance = token.allowance(address(this), spender);\\n            if (currentAllowance < requestedDecrease) {\\n                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);\\n            }\\n            forceApprove(token, spender, currentAllowance - requestedDecrease);\\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     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function\\n     * only sets the \\\"standard\\\" allowance. Any temporary allowance will remain active, in addition to the value being\\n     * set here.\\n     */\\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));\\n\\n        if (!_callOptionalReturnBool(token, approvalCall)) {\\n            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));\\n            _callOptionalReturn(token, approvalCall);\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            safeTransfer(token, to, value);\\n        } else if (!token.transferAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target\\n     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferFromAndCallRelaxed(\\n        IERC1363 token,\\n        address from,\\n        address to,\\n        uint256 value,\\n        bytes memory data\\n    ) internal {\\n        if (to.code.length == 0) {\\n            safeTransferFrom(token, from, to, value);\\n        } else if (!token.transferFromAndCall(from, to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.\\n     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}\\n     * once without retrying, and relies on the returned value to be true.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            forceApprove(token, to, value);\\n        } else if (!token.approveAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.\\n     */\\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            // bubble errors\\n            if iszero(success) {\\n                let ptr := mload(0x40)\\n                returndatacopy(ptr, 0, returndatasize())\\n                revert(ptr, returndatasize())\\n            }\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n\\n        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.\\n     */\\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n        bool success;\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\\n    }\\n}\\n\",\"keccak256\":\"0x4ea01544758fd2c7045961904686bfe232d2220a04ecaa2d6b08dac17827febf\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)\\n\\npragma solidity ^0.8.20;\\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\",\"keccak256\":\"0x493033a8d1b176a037b2cc6a04dad01a5c157722049bbecf632ca876224dd4b2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Panic.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Helper library for emitting standardized panic codes.\\n *\\n * ```solidity\\n * contract Example {\\n *      using Panic for uint256;\\n *\\n *      // Use any of the declared internal constants\\n *      function foo() { Panic.GENERIC.panic(); }\\n *\\n *      // Alternatively\\n *      function foo() { Panic.panic(Panic.GENERIC); }\\n * }\\n * ```\\n *\\n * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].\\n *\\n * _Available since v5.1._\\n */\\n// slither-disable-next-line unused-state\\nlibrary Panic {\\n    /// @dev generic / unspecified error\\n    uint256 internal constant GENERIC = 0x00;\\n    /// @dev used by the assert() builtin\\n    uint256 internal constant ASSERT = 0x01;\\n    /// @dev arithmetic underflow or overflow\\n    uint256 internal constant UNDER_OVERFLOW = 0x11;\\n    /// @dev division or modulo by zero\\n    uint256 internal constant DIVISION_BY_ZERO = 0x12;\\n    /// @dev enum conversion error\\n    uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;\\n    /// @dev invalid encoding in storage\\n    uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;\\n    /// @dev empty array pop\\n    uint256 internal constant EMPTY_ARRAY_POP = 0x31;\\n    /// @dev array out of bounds access\\n    uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;\\n    /// @dev resource error (too large allocation or too large array)\\n    uint256 internal constant RESOURCE_ERROR = 0x41;\\n    /// @dev calling invalid internal function\\n    uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;\\n\\n    /// @dev Reverts with a panic code. Recommended to use with\\n    /// the internal constants with predefined codes.\\n    function panic(uint256 code) internal pure {\\n        assembly (\\\"memory-safe\\\") {\\n            mstore(0x00, 0x4e487b71)\\n            mstore(0x20, code)\\n            revert(0x1c, 0x24)\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0xf7fe324703a64fc51702311dc51562d5cb1497734f074e4f483bfb6717572d7a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[ERC].\\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[ERC 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\",\"keccak256\":\"0x79796192ec90263f21b464d5bc90b777a525971d3de8232be80d9c4f9fb353b8\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Panic} from \\\"../Panic.sol\\\";\\nimport {SafeCast} from \\\"./SafeCast.sol\\\";\\n\\n/**\\n * @dev Standard math utilities missing in the Solidity language.\\n */\\nlibrary Math {\\n    enum Rounding {\\n        Floor, // Toward negative infinity\\n        Ceil, // Toward positive infinity\\n        Trunc, // Toward zero\\n        Expand // Away from zero\\n    }\\n\\n    /**\\n     * @dev Returns the addition of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            uint256 c = a + b;\\n            if (c < a) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b > a) return (false, 0);\\n            return (true, a - b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n            // benefit is lost if 'b' is also tested.\\n            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n            if (a == 0) return (true, 0);\\n            uint256 c = a * b;\\n            if (c / a != b) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the division of two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a / b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a % b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.\\n     *\\n     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.\\n     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute\\n     * one branch when needed, making this function more expensive.\\n     */\\n    function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {\\n        unchecked {\\n            // branchless ternary works because:\\n            // b ^ (a ^ b) == a\\n            // b ^ 0 == b\\n            return b ^ ((a ^ b) * SafeCast.toUint(condition));\\n        }\\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 ternary(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 ternary(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 towards infinity instead\\n     * of rounding towards zero.\\n     */\\n    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\\n        if (b == 0) {\\n            // Guarantee the same behavior as in a regular Solidity division.\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n\\n        // The following calculation ensures accurate ceiling division without overflow.\\n        // Since a is non-zero, (a - 1) / b will not overflow.\\n        // The largest possible result occurs when (a - 1) / b is type(uint256).max,\\n        // but the largest value we can obtain is type(uint256).max - 1, which happens\\n        // when a = type(uint256).max and b = 1.\\n        unchecked {\\n            return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);\\n        }\\n    }\\n\\n    /**\\n     * @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or\\n     * denominator == 0.\\n     *\\n     * Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by\\n     * 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\\u00b2\\u2075\\u2076 and mod 2\\u00b2\\u2075\\u2076 - 1, then use\\n            // the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\\n            // variables such that product = prod1 * 2\\u00b2\\u2075\\u2076 + prod0.\\n            uint256 prod0 = x * y; // 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                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\\u00b2\\u2075\\u2076. Also prevents denominator == 0.\\n            if (denominator <= prod1) {\\n                Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));\\n            }\\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.\\n            // Always >= 1. See https://cs.stackexchange.com/q/138556/92363.\\n\\n            uint256 twos = denominator & (0 - denominator);\\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\\u00b2\\u2075\\u2076 / 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\\u00b2\\u2075\\u2076. Now that denominator is an odd number, it has an inverse modulo 2\\u00b2\\u2075\\u2076 such\\n            // that denominator * inv \\u2261 1 mod 2\\u00b2\\u2075\\u2076. Compute the inverse by starting with a seed that is correct for\\n            // four bits. That is, denominator * inv \\u2261 1 mod 2\\u2074.\\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\\n            // works in modular arithmetic, doubling the correct bits in each step.\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u2076\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b3\\u00b2\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2076\\u2074\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u00b2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b2\\u2075\\u2076\\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\\u00b2\\u2075\\u2076. Since the preconditions guarantee that the outcome is\\n            // less than 2\\u00b2\\u2075\\u2076, 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     * @dev 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        return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);\\n    }\\n\\n    /**\\n     * @dev Calculate the modular multiplicative inverse of a number in Z/nZ.\\n     *\\n     * If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.\\n     * If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.\\n     *\\n     * If the input value is not inversible, 0 is returned.\\n     *\\n     * NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the\\n     * inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.\\n     */\\n    function invMod(uint256 a, uint256 n) internal pure returns (uint256) {\\n        unchecked {\\n            if (n == 0) return 0;\\n\\n            // The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)\\n            // Used to compute integers x and y such that: ax + ny = gcd(a, n).\\n            // When the gcd is 1, then the inverse of a modulo n exists and it's x.\\n            // ax + ny = 1\\n            // ax = 1 + (-y)n\\n            // ax \\u2261 1 (mod n) # x is the inverse of a modulo n\\n\\n            // If the remainder is 0 the gcd is n right away.\\n            uint256 remainder = a % n;\\n            uint256 gcd = n;\\n\\n            // Therefore the initial coefficients are:\\n            // ax + ny = gcd(a, n) = n\\n            // 0a + 1n = n\\n            int256 x = 0;\\n            int256 y = 1;\\n\\n            while (remainder != 0) {\\n                uint256 quotient = gcd / remainder;\\n\\n                (gcd, remainder) = (\\n                    // The old remainder is the next gcd to try.\\n                    remainder,\\n                    // Compute the next remainder.\\n                    // Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd\\n                    // where gcd is at most n (capped to type(uint256).max)\\n                    gcd - remainder * quotient\\n                );\\n\\n                (x, y) = (\\n                    // Increment the coefficient of a.\\n                    y,\\n                    // Decrement the coefficient of n.\\n                    // Can overflow, but the result is casted to uint256 so that the\\n                    // next value of y is \\\"wrapped around\\\" to a value between 0 and n - 1.\\n                    x - y * int256(quotient)\\n                );\\n            }\\n\\n            if (gcd != 1) return 0; // No inverse exists.\\n            return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.\\n     *\\n     * From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is\\n     * prime, then `a**(p-1) \\u2261 1 mod p`. As a consequence, we have `a * a**(p-2) \\u2261 1 mod p`, which means that\\n     * `a**(p-2)` is the modular multiplicative inverse of a in Fp.\\n     *\\n     * NOTE: this function does NOT check that `p` is a prime greater than `2`.\\n     */\\n    function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {\\n        unchecked {\\n            return Math.modExp(a, p - 2, p);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)\\n     *\\n     * Requirements:\\n     * - modulus can't be zero\\n     * - underlying staticcall to precompile must succeed\\n     *\\n     * IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make\\n     * sure the chain you're using it on supports the precompiled contract for modular exponentiation\\n     * at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,\\n     * the underlying function will succeed given the lack of a revert, but the result may be incorrectly\\n     * interpreted as 0.\\n     */\\n    function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {\\n        (bool success, uint256 result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).\\n     * It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying\\n     * to operate modulo 0 or if the underlying precompile reverted.\\n     *\\n     * IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain\\n     * you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in\\n     * https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack\\n     * of a revert, but the result may be incorrectly interpreted as 0.\\n     */\\n    function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {\\n        if (m == 0) return (false, 0);\\n        assembly (\\\"memory-safe\\\") {\\n            let ptr := mload(0x40)\\n            // | Offset    | Content    | Content (Hex)                                                      |\\n            // |-----------|------------|--------------------------------------------------------------------|\\n            // | 0x00:0x1f | size of b  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x20:0x3f | size of e  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x40:0x5f | size of m  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x60:0x7f | value of b | 0x<.............................................................b> |\\n            // | 0x80:0x9f | value of e | 0x<.............................................................e> |\\n            // | 0xa0:0xbf | value of m | 0x<.............................................................m> |\\n            mstore(ptr, 0x20)\\n            mstore(add(ptr, 0x20), 0x20)\\n            mstore(add(ptr, 0x40), 0x20)\\n            mstore(add(ptr, 0x60), b)\\n            mstore(add(ptr, 0x80), e)\\n            mstore(add(ptr, 0xa0), m)\\n\\n            // Given the result < m, it's guaranteed to fit in 32 bytes,\\n            // so we can use the memory scratch space located at offset 0.\\n            success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)\\n            result := mload(0x00)\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {modExp} that supports inputs of arbitrary length.\\n     */\\n    function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {\\n        (bool success, bytes memory result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Variant of {tryModExp} that supports inputs of arbitrary length.\\n     */\\n    function tryModExp(\\n        bytes memory b,\\n        bytes memory e,\\n        bytes memory m\\n    ) internal view returns (bool success, bytes memory result) {\\n        if (_zeroBytes(m)) return (false, new bytes(0));\\n\\n        uint256 mLen = m.length;\\n\\n        // Encode call args in result and move the free memory pointer\\n        result = abi.encodePacked(b.length, e.length, mLen, b, e, m);\\n\\n        assembly (\\\"memory-safe\\\") {\\n            let dataPtr := add(result, 0x20)\\n            // Write result on top of args to avoid allocating extra memory.\\n            success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)\\n            // Overwrite the length.\\n            // result.length > returndatasize() is guaranteed because returndatasize() == m.length\\n            mstore(result, mLen)\\n            // Set the memory pointer after the returned data.\\n            mstore(0x40, add(dataPtr, mLen))\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether the provided byte array is zero.\\n     */\\n    function _zeroBytes(bytes memory byteArray) private pure returns (bool) {\\n        for (uint256 i = 0; i < byteArray.length; ++i) {\\n            if (byteArray[i] != 0) {\\n                return false;\\n            }\\n        }\\n        return true;\\n    }\\n\\n    /**\\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded\\n     * towards zero.\\n     *\\n     * This method is based on Newton's method for computing square roots; the algorithm is restricted to only\\n     * using integer operations.\\n     */\\n    function sqrt(uint256 a) internal pure returns (uint256) {\\n        unchecked {\\n            // Take care of easy edge cases when a == 0 or a == 1\\n            if (a <= 1) {\\n                return a;\\n            }\\n\\n            // In this function, we use Newton's method to get a root of `f(x) := x\\u00b2 - a`. It involves building a\\n            // sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between\\n            // the current value as `\\u03b5_n = | x_n - sqrt(a) |`.\\n            //\\n            // For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root\\n            // of the target. (i.e. `2**(e-1) \\u2264 sqrt(a) < 2**e`). We know that `e \\u2264 128` because `(2\\u00b9\\u00b2\\u2078)\\u00b2 = 2\\u00b2\\u2075\\u2076` is\\n            // bigger than any uint256.\\n            //\\n            // By noticing that\\n            // `2**(e-1) \\u2264 sqrt(a) < 2**e \\u2192 (2**(e-1))\\u00b2 \\u2264 a < (2**e)\\u00b2 \\u2192 2**(2*e-2) \\u2264 a < 2**(2*e)`\\n            // we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar\\n            // to the msb function.\\n            uint256 aa = a;\\n            uint256 xn = 1;\\n\\n            if (aa >= (1 << 128)) {\\n                aa >>= 128;\\n                xn <<= 64;\\n            }\\n            if (aa >= (1 << 64)) {\\n                aa >>= 64;\\n                xn <<= 32;\\n            }\\n            if (aa >= (1 << 32)) {\\n                aa >>= 32;\\n                xn <<= 16;\\n            }\\n            if (aa >= (1 << 16)) {\\n                aa >>= 16;\\n                xn <<= 8;\\n            }\\n            if (aa >= (1 << 8)) {\\n                aa >>= 8;\\n                xn <<= 4;\\n            }\\n            if (aa >= (1 << 4)) {\\n                aa >>= 4;\\n                xn <<= 2;\\n            }\\n            if (aa >= (1 << 2)) {\\n                xn <<= 1;\\n            }\\n\\n            // We now have x_n such that `x_n = 2**(e-1) \\u2264 sqrt(a) < 2**e = 2 * x_n`. This implies \\u03b5_n \\u2264 2**(e-1).\\n            //\\n            // We can refine our estimation by noticing that the middle of that interval minimizes the error.\\n            // If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to \\u03b5_n \\u2264 2**(e-2).\\n            // This is going to be our x_0 (and \\u03b5_0)\\n            xn = (3 * xn) >> 1; // \\u03b5_0 := | x_0 - sqrt(a) | \\u2264 2**(e-2)\\n\\n            // From here, Newton's method give us:\\n            // x_{n+1} = (x_n + a / x_n) / 2\\n            //\\n            // One should note that:\\n            // x_{n+1}\\u00b2 - a = ((x_n + a / x_n) / 2)\\u00b2 - a\\n            //              = ((x_n\\u00b2 + a) / (2 * x_n))\\u00b2 - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2) - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2 - 4 * a * x_n\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u2074 - 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u00b2 - a)\\u00b2 / (2 * x_n)\\u00b2\\n            //              = ((x_n\\u00b2 - a) / (2 * x_n))\\u00b2\\n            //              \\u2265 0\\n            // Which proves that for all n \\u2265 1, sqrt(a) \\u2264 x_n\\n            //\\n            // This gives us the proof of quadratic convergence of the sequence:\\n            // \\u03b5_{n+1} = | x_{n+1} - sqrt(a) |\\n            //         = | (x_n + a / x_n) / 2 - sqrt(a) |\\n            //         = | (x_n\\u00b2 + a - 2*x_n*sqrt(a)) / (2 * x_n) |\\n            //         = | (x_n - sqrt(a))\\u00b2 / (2 * x_n) |\\n            //         = | \\u03b5_n\\u00b2 / (2 * x_n) |\\n            //         = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //\\n            // For the first iteration, we have a special case where x_0 is known:\\n            // \\u03b5_1 = \\u03b5_0\\u00b2 / | (2 * x_0) |\\n            //     \\u2264 (2**(e-2))\\u00b2 / (2 * (2**(e-1) + 2**(e-2)))\\n            //     \\u2264 2**(2*e-4) / (3 * 2**(e-1))\\n            //     \\u2264 2**(e-3) / 3\\n            //     \\u2264 2**(e-3-log2(3))\\n            //     \\u2264 2**(e-4.5)\\n            //\\n            // For the following iterations, we use the fact that, 2**(e-1) \\u2264 sqrt(a) \\u2264 x_n:\\n            // \\u03b5_{n+1} = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //         \\u2264 (2**(e-k))\\u00b2 / (2 * 2**(e-1))\\n            //         \\u2264 2**(2*e-2*k) / 2**e\\n            //         \\u2264 2**(e-2*k)\\n            xn = (xn + a / xn) >> 1; // \\u03b5_1 := | x_1 - sqrt(a) | \\u2264 2**(e-4.5)  -- special case, see above\\n            xn = (xn + a / xn) >> 1; // \\u03b5_2 := | x_2 - sqrt(a) | \\u2264 2**(e-9)    -- general case with k = 4.5\\n            xn = (xn + a / xn) >> 1; // \\u03b5_3 := | x_3 - sqrt(a) | \\u2264 2**(e-18)   -- general case with k = 9\\n            xn = (xn + a / xn) >> 1; // \\u03b5_4 := | x_4 - sqrt(a) | \\u2264 2**(e-36)   -- general case with k = 18\\n            xn = (xn + a / xn) >> 1; // \\u03b5_5 := | x_5 - sqrt(a) | \\u2264 2**(e-72)   -- general case with k = 36\\n            xn = (xn + a / xn) >> 1; // \\u03b5_6 := | x_6 - sqrt(a) | \\u2264 2**(e-144)  -- general case with k = 72\\n\\n            // Because e \\u2264 128 (as discussed during the first estimation phase), we know have reached a precision\\n            // \\u03b5_6 \\u2264 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either\\n            // sqrt(a) or sqrt(a) + 1.\\n            return xn - SafeCast.toUint(xn > a / xn);\\n        }\\n    }\\n\\n    /**\\n     * @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 2 of a positive value rounded towards zero.\\n     * Returns 0 if given 0.\\n     */\\n    function log2(uint256 value) internal pure returns (uint256) {\\n        uint256 result = 0;\\n        uint256 exp;\\n        unchecked {\\n            exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            result += SafeCast.toUint(value > 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 10 of a positive value rounded towards zero.\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 256 of a positive value rounded towards zero.\\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        uint256 isGt;\\n        unchecked {\\n            isGt = SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= isGt * 128;\\n            result += isGt * 16;\\n\\n            isGt = SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= isGt * 64;\\n            result += isGt * 8;\\n\\n            isGt = SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= isGt * 32;\\n            result += isGt * 4;\\n\\n            isGt = SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= isGt * 16;\\n            result += isGt * 2;\\n\\n            result += SafeCast.toUint(value > (1 << 8) - 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.\\n     */\\n    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {\\n        return uint8(rounding) % 2 == 1;\\n    }\\n}\\n\",\"keccak256\":\"0xa00be322d7db5786750ce0ac7e2f5b633ac30a5ed5fa1ced1e74acfc19acecea\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeCast.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)\\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow\\n * checks.\\n *\\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\\n * easily result in undesired exploitation or bugs, since developers usually\\n * assume that overflows raise errors. `SafeCast` restores this intuition by\\n * reverting the transaction when such an operation overflows.\\n *\\n * Using this library instead of the unchecked operations eliminates an entire\\n * class of bugs, so it's recommended to use it always.\\n */\\nlibrary SafeCast {\\n    /**\\n     * @dev Value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);\\n\\n    /**\\n     * @dev An int value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedIntToUint(int256 value);\\n\\n    /**\\n     * @dev Value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);\\n\\n    /**\\n     * @dev An uint value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedUintToInt(uint256 value);\\n\\n    /**\\n     * @dev Returns the downcasted uint248 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint248).\\n     *\\n     * Counterpart to Solidity's `uint248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toUint248(uint256 value) internal pure returns (uint248) {\\n        if (value > type(uint248).max) {\\n            revert SafeCastOverflowedUintDowncast(248, value);\\n        }\\n        return uint248(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint240 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint240).\\n     *\\n     * Counterpart to Solidity's `uint240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toUint240(uint256 value) internal pure returns (uint240) {\\n        if (value > type(uint240).max) {\\n            revert SafeCastOverflowedUintDowncast(240, value);\\n        }\\n        return uint240(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint232 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint232).\\n     *\\n     * Counterpart to Solidity's `uint232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toUint232(uint256 value) internal pure returns (uint232) {\\n        if (value > type(uint232).max) {\\n            revert SafeCastOverflowedUintDowncast(232, value);\\n        }\\n        return uint232(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint224 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint224).\\n     *\\n     * Counterpart to Solidity's `uint224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toUint224(uint256 value) internal pure returns (uint224) {\\n        if (value > type(uint224).max) {\\n            revert SafeCastOverflowedUintDowncast(224, value);\\n        }\\n        return uint224(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint216 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint216).\\n     *\\n     * Counterpart to Solidity's `uint216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toUint216(uint256 value) internal pure returns (uint216) {\\n        if (value > type(uint216).max) {\\n            revert SafeCastOverflowedUintDowncast(216, value);\\n        }\\n        return uint216(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint208 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint208).\\n     *\\n     * Counterpart to Solidity's `uint208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toUint208(uint256 value) internal pure returns (uint208) {\\n        if (value > type(uint208).max) {\\n            revert SafeCastOverflowedUintDowncast(208, value);\\n        }\\n        return uint208(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint200 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint200).\\n     *\\n     * Counterpart to Solidity's `uint200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toUint200(uint256 value) internal pure returns (uint200) {\\n        if (value > type(uint200).max) {\\n            revert SafeCastOverflowedUintDowncast(200, value);\\n        }\\n        return uint200(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint192 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint192).\\n     *\\n     * Counterpart to Solidity's `uint192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toUint192(uint256 value) internal pure returns (uint192) {\\n        if (value > type(uint192).max) {\\n            revert SafeCastOverflowedUintDowncast(192, value);\\n        }\\n        return uint192(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint184 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint184).\\n     *\\n     * Counterpart to Solidity's `uint184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toUint184(uint256 value) internal pure returns (uint184) {\\n        if (value > type(uint184).max) {\\n            revert SafeCastOverflowedUintDowncast(184, value);\\n        }\\n        return uint184(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint176 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint176).\\n     *\\n     * Counterpart to Solidity's `uint176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toUint176(uint256 value) internal pure returns (uint176) {\\n        if (value > type(uint176).max) {\\n            revert SafeCastOverflowedUintDowncast(176, value);\\n        }\\n        return uint176(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint168 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint168).\\n     *\\n     * Counterpart to Solidity's `uint168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toUint168(uint256 value) internal pure returns (uint168) {\\n        if (value > type(uint168).max) {\\n            revert SafeCastOverflowedUintDowncast(168, value);\\n        }\\n        return uint168(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint160 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint160).\\n     *\\n     * Counterpart to Solidity's `uint160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toUint160(uint256 value) internal pure returns (uint160) {\\n        if (value > type(uint160).max) {\\n            revert SafeCastOverflowedUintDowncast(160, value);\\n        }\\n        return uint160(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint152 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint152).\\n     *\\n     * Counterpart to Solidity's `uint152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toUint152(uint256 value) internal pure returns (uint152) {\\n        if (value > type(uint152).max) {\\n            revert SafeCastOverflowedUintDowncast(152, value);\\n        }\\n        return uint152(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint144 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint144).\\n     *\\n     * Counterpart to Solidity's `uint144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toUint144(uint256 value) internal pure returns (uint144) {\\n        if (value > type(uint144).max) {\\n            revert SafeCastOverflowedUintDowncast(144, value);\\n        }\\n        return uint144(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint136 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint136).\\n     *\\n     * Counterpart to Solidity's `uint136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toUint136(uint256 value) internal pure returns (uint136) {\\n        if (value > type(uint136).max) {\\n            revert SafeCastOverflowedUintDowncast(136, value);\\n        }\\n        return uint136(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint128 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint128).\\n     *\\n     * Counterpart to Solidity's `uint128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toUint128(uint256 value) internal pure returns (uint128) {\\n        if (value > type(uint128).max) {\\n            revert SafeCastOverflowedUintDowncast(128, value);\\n        }\\n        return uint128(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint120 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint120).\\n     *\\n     * Counterpart to Solidity's `uint120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toUint120(uint256 value) internal pure returns (uint120) {\\n        if (value > type(uint120).max) {\\n            revert SafeCastOverflowedUintDowncast(120, value);\\n        }\\n        return uint120(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint112 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint112).\\n     *\\n     * Counterpart to Solidity's `uint112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toUint112(uint256 value) internal pure returns (uint112) {\\n        if (value > type(uint112).max) {\\n            revert SafeCastOverflowedUintDowncast(112, value);\\n        }\\n        return uint112(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint104 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint104).\\n     *\\n     * Counterpart to Solidity's `uint104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toUint104(uint256 value) internal pure returns (uint104) {\\n        if (value > type(uint104).max) {\\n            revert SafeCastOverflowedUintDowncast(104, value);\\n        }\\n        return uint104(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint96 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint96).\\n     *\\n     * Counterpart to Solidity's `uint96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toUint96(uint256 value) internal pure returns (uint96) {\\n        if (value > type(uint96).max) {\\n            revert SafeCastOverflowedUintDowncast(96, value);\\n        }\\n        return uint96(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint88 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint88).\\n     *\\n     * Counterpart to Solidity's `uint88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toUint88(uint256 value) internal pure returns (uint88) {\\n        if (value > type(uint88).max) {\\n            revert SafeCastOverflowedUintDowncast(88, value);\\n        }\\n        return uint88(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint80 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint80).\\n     *\\n     * Counterpart to Solidity's `uint80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toUint80(uint256 value) internal pure returns (uint80) {\\n        if (value > type(uint80).max) {\\n            revert SafeCastOverflowedUintDowncast(80, value);\\n        }\\n        return uint80(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint72 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint72).\\n     *\\n     * Counterpart to Solidity's `uint72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toUint72(uint256 value) internal pure returns (uint72) {\\n        if (value > type(uint72).max) {\\n            revert SafeCastOverflowedUintDowncast(72, value);\\n        }\\n        return uint72(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint64 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint64).\\n     *\\n     * Counterpart to Solidity's `uint64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toUint64(uint256 value) internal pure returns (uint64) {\\n        if (value > type(uint64).max) {\\n            revert SafeCastOverflowedUintDowncast(64, value);\\n        }\\n        return uint64(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint56 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint56).\\n     *\\n     * Counterpart to Solidity's `uint56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toUint56(uint256 value) internal pure returns (uint56) {\\n        if (value > type(uint56).max) {\\n            revert SafeCastOverflowedUintDowncast(56, value);\\n        }\\n        return uint56(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint48 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint48).\\n     *\\n     * Counterpart to Solidity's `uint48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toUint48(uint256 value) internal pure returns (uint48) {\\n        if (value > type(uint48).max) {\\n            revert SafeCastOverflowedUintDowncast(48, value);\\n        }\\n        return uint48(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint40 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint40).\\n     *\\n     * Counterpart to Solidity's `uint40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toUint40(uint256 value) internal pure returns (uint40) {\\n        if (value > type(uint40).max) {\\n            revert SafeCastOverflowedUintDowncast(40, value);\\n        }\\n        return uint40(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint32 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint32).\\n     *\\n     * Counterpart to Solidity's `uint32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toUint32(uint256 value) internal pure returns (uint32) {\\n        if (value > type(uint32).max) {\\n            revert SafeCastOverflowedUintDowncast(32, value);\\n        }\\n        return uint32(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint24 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint24).\\n     *\\n     * Counterpart to Solidity's `uint24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toUint24(uint256 value) internal pure returns (uint24) {\\n        if (value > type(uint24).max) {\\n            revert SafeCastOverflowedUintDowncast(24, value);\\n        }\\n        return uint24(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint16 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint16).\\n     *\\n     * Counterpart to Solidity's `uint16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toUint16(uint256 value) internal pure returns (uint16) {\\n        if (value > type(uint16).max) {\\n            revert SafeCastOverflowedUintDowncast(16, value);\\n        }\\n        return uint16(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint8 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint8).\\n     *\\n     * Counterpart to Solidity's `uint8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toUint8(uint256 value) internal pure returns (uint8) {\\n        if (value > type(uint8).max) {\\n            revert SafeCastOverflowedUintDowncast(8, value);\\n        }\\n        return uint8(value);\\n    }\\n\\n    /**\\n     * @dev Converts a signed int256 into an unsigned uint256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be greater than or equal to 0.\\n     */\\n    function toUint256(int256 value) internal pure returns (uint256) {\\n        if (value < 0) {\\n            revert SafeCastOverflowedIntToUint(value);\\n        }\\n        return uint256(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int248 from int256, reverting on\\n     * overflow (when the input is less than smallest int248 or\\n     * greater than largest int248).\\n     *\\n     * Counterpart to Solidity's `int248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toInt248(int256 value) internal pure returns (int248 downcasted) {\\n        downcasted = int248(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(248, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int240 from int256, reverting on\\n     * overflow (when the input is less than smallest int240 or\\n     * greater than largest int240).\\n     *\\n     * Counterpart to Solidity's `int240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toInt240(int256 value) internal pure returns (int240 downcasted) {\\n        downcasted = int240(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(240, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int232 from int256, reverting on\\n     * overflow (when the input is less than smallest int232 or\\n     * greater than largest int232).\\n     *\\n     * Counterpart to Solidity's `int232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toInt232(int256 value) internal pure returns (int232 downcasted) {\\n        downcasted = int232(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(232, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int224 from int256, reverting on\\n     * overflow (when the input is less than smallest int224 or\\n     * greater than largest int224).\\n     *\\n     * Counterpart to Solidity's `int224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toInt224(int256 value) internal pure returns (int224 downcasted) {\\n        downcasted = int224(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(224, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int216 from int256, reverting on\\n     * overflow (when the input is less than smallest int216 or\\n     * greater than largest int216).\\n     *\\n     * Counterpart to Solidity's `int216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toInt216(int256 value) internal pure returns (int216 downcasted) {\\n        downcasted = int216(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(216, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int208 from int256, reverting on\\n     * overflow (when the input is less than smallest int208 or\\n     * greater than largest int208).\\n     *\\n     * Counterpart to Solidity's `int208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toInt208(int256 value) internal pure returns (int208 downcasted) {\\n        downcasted = int208(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(208, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int200 from int256, reverting on\\n     * overflow (when the input is less than smallest int200 or\\n     * greater than largest int200).\\n     *\\n     * Counterpart to Solidity's `int200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toInt200(int256 value) internal pure returns (int200 downcasted) {\\n        downcasted = int200(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(200, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int192 from int256, reverting on\\n     * overflow (when the input is less than smallest int192 or\\n     * greater than largest int192).\\n     *\\n     * Counterpart to Solidity's `int192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toInt192(int256 value) internal pure returns (int192 downcasted) {\\n        downcasted = int192(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(192, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int184 from int256, reverting on\\n     * overflow (when the input is less than smallest int184 or\\n     * greater than largest int184).\\n     *\\n     * Counterpart to Solidity's `int184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toInt184(int256 value) internal pure returns (int184 downcasted) {\\n        downcasted = int184(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(184, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int176 from int256, reverting on\\n     * overflow (when the input is less than smallest int176 or\\n     * greater than largest int176).\\n     *\\n     * Counterpart to Solidity's `int176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toInt176(int256 value) internal pure returns (int176 downcasted) {\\n        downcasted = int176(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(176, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int168 from int256, reverting on\\n     * overflow (when the input is less than smallest int168 or\\n     * greater than largest int168).\\n     *\\n     * Counterpart to Solidity's `int168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toInt168(int256 value) internal pure returns (int168 downcasted) {\\n        downcasted = int168(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(168, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int160 from int256, reverting on\\n     * overflow (when the input is less than smallest int160 or\\n     * greater than largest int160).\\n     *\\n     * Counterpart to Solidity's `int160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toInt160(int256 value) internal pure returns (int160 downcasted) {\\n        downcasted = int160(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(160, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int152 from int256, reverting on\\n     * overflow (when the input is less than smallest int152 or\\n     * greater than largest int152).\\n     *\\n     * Counterpart to Solidity's `int152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toInt152(int256 value) internal pure returns (int152 downcasted) {\\n        downcasted = int152(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(152, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int144 from int256, reverting on\\n     * overflow (when the input is less than smallest int144 or\\n     * greater than largest int144).\\n     *\\n     * Counterpart to Solidity's `int144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toInt144(int256 value) internal pure returns (int144 downcasted) {\\n        downcasted = int144(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(144, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int136 from int256, reverting on\\n     * overflow (when the input is less than smallest int136 or\\n     * greater than largest int136).\\n     *\\n     * Counterpart to Solidity's `int136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toInt136(int256 value) internal pure returns (int136 downcasted) {\\n        downcasted = int136(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(136, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int128 from int256, reverting on\\n     * overflow (when the input is less than smallest int128 or\\n     * greater than largest int128).\\n     *\\n     * Counterpart to Solidity's `int128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toInt128(int256 value) internal pure returns (int128 downcasted) {\\n        downcasted = int128(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(128, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int120 from int256, reverting on\\n     * overflow (when the input is less than smallest int120 or\\n     * greater than largest int120).\\n     *\\n     * Counterpart to Solidity's `int120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toInt120(int256 value) internal pure returns (int120 downcasted) {\\n        downcasted = int120(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(120, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int112 from int256, reverting on\\n     * overflow (when the input is less than smallest int112 or\\n     * greater than largest int112).\\n     *\\n     * Counterpart to Solidity's `int112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toInt112(int256 value) internal pure returns (int112 downcasted) {\\n        downcasted = int112(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(112, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int104 from int256, reverting on\\n     * overflow (when the input is less than smallest int104 or\\n     * greater than largest int104).\\n     *\\n     * Counterpart to Solidity's `int104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toInt104(int256 value) internal pure returns (int104 downcasted) {\\n        downcasted = int104(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(104, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int96 from int256, reverting on\\n     * overflow (when the input is less than smallest int96 or\\n     * greater than largest int96).\\n     *\\n     * Counterpart to Solidity's `int96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toInt96(int256 value) internal pure returns (int96 downcasted) {\\n        downcasted = int96(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(96, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int88 from int256, reverting on\\n     * overflow (when the input is less than smallest int88 or\\n     * greater than largest int88).\\n     *\\n     * Counterpart to Solidity's `int88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toInt88(int256 value) internal pure returns (int88 downcasted) {\\n        downcasted = int88(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(88, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int80 from int256, reverting on\\n     * overflow (when the input is less than smallest int80 or\\n     * greater than largest int80).\\n     *\\n     * Counterpart to Solidity's `int80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toInt80(int256 value) internal pure returns (int80 downcasted) {\\n        downcasted = int80(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(80, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int72 from int256, reverting on\\n     * overflow (when the input is less than smallest int72 or\\n     * greater than largest int72).\\n     *\\n     * Counterpart to Solidity's `int72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toInt72(int256 value) internal pure returns (int72 downcasted) {\\n        downcasted = int72(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(72, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int64 from int256, reverting on\\n     * overflow (when the input is less than smallest int64 or\\n     * greater than largest int64).\\n     *\\n     * Counterpart to Solidity's `int64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toInt64(int256 value) internal pure returns (int64 downcasted) {\\n        downcasted = int64(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(64, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int56 from int256, reverting on\\n     * overflow (when the input is less than smallest int56 or\\n     * greater than largest int56).\\n     *\\n     * Counterpart to Solidity's `int56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toInt56(int256 value) internal pure returns (int56 downcasted) {\\n        downcasted = int56(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(56, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int48 from int256, reverting on\\n     * overflow (when the input is less than smallest int48 or\\n     * greater than largest int48).\\n     *\\n     * Counterpart to Solidity's `int48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toInt48(int256 value) internal pure returns (int48 downcasted) {\\n        downcasted = int48(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(48, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int40 from int256, reverting on\\n     * overflow (when the input is less than smallest int40 or\\n     * greater than largest int40).\\n     *\\n     * Counterpart to Solidity's `int40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toInt40(int256 value) internal pure returns (int40 downcasted) {\\n        downcasted = int40(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(40, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int32 from int256, reverting on\\n     * overflow (when the input is less than smallest int32 or\\n     * greater than largest int32).\\n     *\\n     * Counterpart to Solidity's `int32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toInt32(int256 value) internal pure returns (int32 downcasted) {\\n        downcasted = int32(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(32, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int24 from int256, reverting on\\n     * overflow (when the input is less than smallest int24 or\\n     * greater than largest int24).\\n     *\\n     * Counterpart to Solidity's `int24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toInt24(int256 value) internal pure returns (int24 downcasted) {\\n        downcasted = int24(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(24, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int16 from int256, reverting on\\n     * overflow (when the input is less than smallest int16 or\\n     * greater than largest int16).\\n     *\\n     * Counterpart to Solidity's `int16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toInt16(int256 value) internal pure returns (int16 downcasted) {\\n        downcasted = int16(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(16, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int8 from int256, reverting on\\n     * overflow (when the input is less than smallest int8 or\\n     * greater than largest int8).\\n     *\\n     * Counterpart to Solidity's `int8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toInt8(int256 value) internal pure returns (int8 downcasted) {\\n        downcasted = int8(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(8, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Converts an unsigned uint256 into a signed int256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be less than or equal to maxInt256.\\n     */\\n    function toInt256(uint256 value) internal pure returns (int256) {\\n        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\\n        if (value > uint256(type(int256).max)) {\\n            revert SafeCastOverflowedUintToInt(value);\\n        }\\n        return int256(value);\\n    }\\n\\n    /**\\n     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.\\n     */\\n    function toUint(bool b) internal pure returns (uint256 u) {\\n        assembly (\\\"memory-safe\\\") {\\n            u := iszero(iszero(b))\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0x195533c86d0ef72bcc06456a4f66a9b941f38eb403739b00f21fd7c1abd1ae54\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/types/Time.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/types/Time.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Math} from \\\"../math/Math.sol\\\";\\nimport {SafeCast} from \\\"../math/SafeCast.sol\\\";\\n\\n/**\\n * @dev This library provides helpers for manipulating time-related objects.\\n *\\n * It uses the following types:\\n * - `uint48` for timepoints\\n * - `uint32` for durations\\n *\\n * While the library doesn't provide specific types for timepoints and duration, it does provide:\\n * - a `Delay` type to represent duration that can be programmed to change value automatically at a given point\\n * - additional helper functions\\n */\\nlibrary Time {\\n    using Time for *;\\n\\n    /**\\n     * @dev Get the block timestamp as a Timepoint.\\n     */\\n    function timestamp() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.timestamp);\\n    }\\n\\n    /**\\n     * @dev Get the block number as a Timepoint.\\n     */\\n    function blockNumber() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.number);\\n    }\\n\\n    // ==================================================== Delay =====================================================\\n    /**\\n     * @dev A `Delay` is a uint32 duration that can be programmed to change value automatically at a given point in the\\n     * future. The \\\"effect\\\" timepoint describes when the transitions happens from the \\\"old\\\" value to the \\\"new\\\" value.\\n     * This allows updating the delay applied to some operation while keeping some guarantees.\\n     *\\n     * In particular, the {update} function guarantees that if the delay is reduced, the old delay still applies for\\n     * some time. For example if the delay is currently 7 days to do an upgrade, the admin should not be able to set\\n     * the delay to 0 and upgrade immediately. If the admin wants to reduce the delay, the old delay (7 days) should\\n     * still apply for some time.\\n     *\\n     *\\n     * The `Delay` type is 112 bits long, and packs the following:\\n     *\\n     * ```\\n     *   | [uint48]: effect date (timepoint)\\n     *   |           | [uint32]: value before (duration)\\n     *   \\u2193           \\u2193       \\u2193 [uint32]: value after (duration)\\n     * 0xAAAAAAAAAAAABBBBBBBBCCCCCCCC\\n     * ```\\n     *\\n     * NOTE: The {get} and {withUpdate} functions operate using timestamps. Block number based delays are not currently\\n     * supported.\\n     */\\n    type Delay is uint112;\\n\\n    /**\\n     * @dev Wrap a duration into a Delay to add the one-step \\\"update in the future\\\" feature\\n     */\\n    function toDelay(uint32 duration) internal pure returns (Delay) {\\n        return Delay.wrap(duration);\\n    }\\n\\n    /**\\n     * @dev Get the value at a given timepoint plus the pending value and effect timepoint if there is a scheduled\\n     * change after this timepoint. If the effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function _getFullAt(\\n        Delay self,\\n        uint48 timepoint\\n    ) private pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        (valueBefore, valueAfter, effect) = self.unpack();\\n        return effect <= timepoint ? (valueAfter, 0, 0) : (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev Get the current value plus the pending value and effect timepoint if there is a scheduled change. If the\\n     * effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function getFull(Delay self) internal view returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        return _getFullAt(self, timestamp());\\n    }\\n\\n    /**\\n     * @dev Get the current value.\\n     */\\n    function get(Delay self) internal view returns (uint32) {\\n        (uint32 delay, , ) = self.getFull();\\n        return delay;\\n    }\\n\\n    /**\\n     * @dev Update a Delay object so that it takes a new duration after a timepoint that is automatically computed to\\n     * enforce the old delay at the moment of the update. Returns the updated Delay object and the timestamp when the\\n     * new delay becomes effective.\\n     */\\n    function withUpdate(\\n        Delay self,\\n        uint32 newValue,\\n        uint32 minSetback\\n    ) internal view returns (Delay updatedDelay, uint48 effect) {\\n        uint32 value = self.get();\\n        uint32 setback = uint32(Math.max(minSetback, value > newValue ? value - newValue : 0));\\n        effect = timestamp() + setback;\\n        return (pack(value, newValue, effect), effect);\\n    }\\n\\n    /**\\n     * @dev Split a delay into its components: valueBefore, valueAfter and effect (transition timepoint).\\n     */\\n    function unpack(Delay self) internal pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        uint112 raw = Delay.unwrap(self);\\n\\n        valueAfter = uint32(raw);\\n        valueBefore = uint32(raw >> 32);\\n        effect = uint48(raw >> 64);\\n\\n        return (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev pack the components into a Delay object.\\n     */\\n    function pack(uint32 valueBefore, uint32 valueAfter, uint48 effect) internal pure returns (Delay) {\\n        return Delay.wrap((uint112(effect) << 64) | (uint112(valueBefore) << 32) | uint112(valueAfter));\\n    }\\n}\\n\",\"keccak256\":\"0x36776530f012618bc7526ceb28e77b85e582cb12d9b9466a71d4bd6bf952e4cc\",\"license\":\"MIT\"},\"contracts/helpers/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { AccessManaged } from \\\"../utils/AccessManaged.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport \\\"contracts/interfaces/IHarvester.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nstruct YieldBearingParams {\\n  // Address of the asset used to mint the yield bearing asset\\n  address asset;\\n  // Target exposure to the collateral yield bearing asset used\\n  uint64 targetExposure;\\n  // Maximum exposure within the Parallelizer to the deposit asset\\n  uint64 maxExposure;\\n  // Minimum exposure within the Parallelizer to the deposit asset\\n  uint64 minExposure;\\n  // Whether limit exposures should be overriden or read onchain through the Parallelizer\\n  // This value should be 1 to override exposures or 2 if these shouldn't be overriden\\n  uint64 overrideExposures;\\n  // Maximum slippage when dealing with the Parallelizer\\n  uint96 maxSlippage;\\n}\\n\\n/// @title BaseHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Abstract contract for a harvester that aims at rebalancing a Parallelizer\\n/// @dev This contract is an authorized fork of Angle's BaseHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol\\nabstract contract BaseHarvester is IHarvester, AccessManaged {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       MODIFIERS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrusted() {\\n    if (!isTrusted[msg.sender]) revert NotTrusted();\\n    _;\\n  }\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted or guardian to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrustedOrRestricted() {\\n    if (!isTrusted[msg.sender] && !_checkCanCall(_msgSender(), _msgData())) {\\n      revert NotTrustedOrGuardian();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       VARIABLES\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Reference to the `parallelizer` implementation this contract aims at rebalancing\\n  IParallelizer public immutable parallelizer;\\n  /// @notice TokenP handled by the `parallelizer` of interest\\n  ITokenP public immutable tokenP;\\n  /// @notice Max slippage when dealing with the Parallelizer\\n  mapping(address => uint96) public maxTokenSlippage;\\n  /// @notice Data associated to a yield bearing asset\\n  mapping(address => YieldBearingParams) public yieldBearingData;\\n  /// @notice trusted addresses that can update target exposure and do others non critical operations\\n  mapping(address => bool) public isTrusted;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EVENTS                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  event Recovered(address token, uint256 amount, address to);\\n  event TrustedToggled(address trusted, bool status);\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       CONSTRUCTOR\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialAuthority,\\n    ITokenP definitiveTokenP,\\n    IParallelizer definitiveParallelizer\\n  )\\n    AccessManaged(initialAuthority)\\n  {\\n    tokenP = definitiveTokenP;\\n    parallelizer = definitiveParallelizer;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        GUARDIAN FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the yieldBearingAsset data\\n   * @param yieldBearingAsset address of the yieldBearingAsset\\n   * @param asset address of the asset\\n   * @param targetExposure target exposure to the yieldBearingAsset asset used\\n   * @param minExposure minimum exposure within the Parallelizer to the asset\\n   * @param maxExposure maximum exposure within the Parallelizer to the asset\\n   * @param overrideExposures whether limit exposures should be overriden or read onchain through the Parallelizer\\n   */\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external\\n    restricted\\n  {\\n    _setYieldBearingAssetData(\\n      yieldBearingAsset, asset, targetExposure, minExposure, maxExposure, overrideExposures, maxSlippage\\n    );\\n  }\\n\\n  /**\\n   * @notice Set the limit exposures to the asset linked to the yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   */\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) public virtual {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    if (yieldBearingInfo.overrideExposures == 2) {\\n      _updateLimitExposuresYieldAsset(yieldBearingInfo.asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  /**\\n   * @notice Set the max allowed slippage\\n   * @param newMaxSlippage new max allowed slippage\\n   */\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external restricted {\\n    _setMaxSlippage(yieldBearingAsset, newMaxSlippage);\\n  }\\n\\n  /**\\n   * @notice Toggle the trusted status of an address\\n   * @param trusted address to toggle the trusted status\\n   */\\n  function toggleTrusted(address trusted) external restricted {\\n    emit TrustedToggled(trusted, isTrusted[trusted]);\\n    isTrusted[trusted] = !isTrusted[trusted];\\n  }\\n\\n  /**\\n   * @notice Recover ERC20 tokens\\n   * @param tokenAddress address of the token to recover\\n   * @param amountToRecover amount to recover\\n   * @param to address to send the recovered tokens\\n   */\\n  function recoverERC20(address tokenAddress, uint256 amountToRecover, address to) external restricted {\\n    emit Recovered(tokenAddress, amountToRecover, to);\\n    IERC20(tokenAddress).safeTransfer(to, amountToRecover);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        TRUSTED FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the target exposure of a yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @param targetExposure target exposure to the yield bearing asset used\\n   */\\n  function setTargetExposure(address yieldBearingAsset, uint64 targetExposure) external onlyTrustedOrRestricted {\\n    yieldBearingData[yieldBearingAsset].targetExposure = targetExposure;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        VIEW FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Compute the amount needed to rebalance the Parallelizer\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @return increase whether the exposure should be increased\\n   * @return amount amount to be rebalanced\\n   */\\n  function computeRebalanceAmount(address yieldBearingAsset) external view returns (uint8 increase, uint256 amount) {\\n    return _computeRebalanceAmount(yieldBearingAsset, yieldBearingData[yieldBearingAsset]);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        INTERNAL FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _computeRebalanceAmount(\\n    address yieldBearingAsset,\\n    YieldBearingParams memory yieldBearingInfo\\n  )\\n    internal\\n    view\\n    returns (uint8 increase, uint256 amount)\\n  {\\n    (uint256 stablecoinsFromYieldBearingAsset, uint256 stablecoinsIssued) =\\n      parallelizer.getIssuedByCollateral(yieldBearingAsset);\\n    (uint256 stablecoinsFromAsset,) = parallelizer.getIssuedByCollateral(yieldBearingInfo.asset);\\n    uint256 targetExposureScaled = yieldBearingInfo.targetExposure * stablecoinsIssued;\\n    if (stablecoinsFromYieldBearingAsset * 1e9 > targetExposureScaled) {\\n      // Need to decrease exposure to yield bearing asset\\n      amount = stablecoinsFromYieldBearingAsset - targetExposureScaled / 1e9;\\n      uint256 maxValueScaled = yieldBearingInfo.maxExposure * stablecoinsIssued;\\n      // These checks assume that there are no transaction fees on the stablecoin->collateral conversion and so\\n      // it's still possible that exposure goes above the max exposure in some rare cases\\n      if (stablecoinsFromAsset * 1e9 > maxValueScaled) {\\n        amount = 0;\\n      } else if ((stablecoinsFromAsset + amount) * 1e9 > maxValueScaled) {\\n        amount = maxValueScaled / 1e9 - stablecoinsFromAsset;\\n      }\\n    } else {\\n      // In this case, exposure after the operation might remain slightly below the targetExposure as less\\n      // collateral may be obtained by burning stablecoins for the yield asset and unwrapping it\\n      increase = 1;\\n      amount = targetExposureScaled / 1e9 - stablecoinsFromYieldBearingAsset;\\n      uint256 minValueScaled = yieldBearingInfo.minExposure * stablecoinsIssued;\\n      if (stablecoinsFromAsset * 1e9 < minValueScaled) {\\n        amount = 0;\\n      } else if (stablecoinsFromAsset * 1e9 < minValueScaled + amount * 1e9) {\\n        amount = stablecoinsFromAsset - minValueScaled / 1e9;\\n      }\\n    }\\n  }\\n\\n  function _setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    internal\\n    virtual\\n  {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    yieldBearingInfo.asset = asset;\\n    if (targetExposure >= 1e9) revert InvalidParam();\\n    if (maxSlippage >= 1e9) revert InvalidParam();\\n    yieldBearingInfo.targetExposure = targetExposure;\\n    yieldBearingInfo.overrideExposures = overrideExposures;\\n    yieldBearingInfo.maxSlippage = maxSlippage;\\n    if (overrideExposures == 1) {\\n      if (maxExposure >= 1e9 || minExposure >= maxExposure) revert InvalidParam();\\n      yieldBearingInfo.maxExposure = maxExposure;\\n      yieldBearingInfo.minExposure = minExposure;\\n    } else {\\n      yieldBearingInfo.overrideExposures = 2;\\n      _updateLimitExposuresYieldAsset(asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  function _updateLimitExposuresYieldAsset(\\n    address asset,\\n    YieldBearingParams storage yieldBearingInfo\\n  )\\n    internal\\n    virtual\\n  {\\n    uint64[] memory xFeeMint;\\n    (xFeeMint,) = parallelizer.getCollateralMintFees(asset);\\n    uint256 length = xFeeMint.length;\\n    if (length <= 1) yieldBearingInfo.maxExposure = 1e9;\\n    else yieldBearingInfo.maxExposure = xFeeMint[length - 2];\\n\\n    uint64[] memory xFeeBurn;\\n    (xFeeBurn,) = parallelizer.getCollateralBurnFees(asset);\\n    length = xFeeBurn.length;\\n    if (length <= 1) yieldBearingInfo.minExposure = 0;\\n    else yieldBearingInfo.minExposure = xFeeBurn[length - 2];\\n  }\\n\\n  function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {\\n    if (newMaxSlippage > 1e9) revert InvalidParam();\\n    maxTokenSlippage[yieldBearingAsset] = newMaxSlippage;\\n  }\\n\\n  function _scaleAmountBasedOnDecimals(\\n    uint256 decimalsTokenIn,\\n    uint256 decimalsTokenOut,\\n    uint256 amountIn,\\n    bool assetIn\\n  )\\n    internal\\n    pure\\n    returns (uint256)\\n  {\\n    if (decimalsTokenIn > decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn /= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      } else {\\n        amountIn *= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      }\\n    } else if (decimalsTokenIn < decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn *= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      } else {\\n        amountIn /= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      }\\n    }\\n    return amountIn;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    HELPER                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _adjustAllowance(address token, address sender, uint256 amountIn) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), sender);\\n    if (allowance < amountIn) IERC20(token).safeIncreaseAllowance(sender, type(uint256).max - allowance);\\n  }\\n}\\n\",\"keccak256\":\"0x82e2ae57997043160d7529488b34591c710cd74e267213b61009daa96e9eeaaf\",\"license\":\"GPL-3.0\"},\"contracts/helpers/GenericHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeCast } from \\\"@openzeppelin/contracts/utils/math/SafeCast.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IERC20Metadata } from \\\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\\\";\\nimport { IERC3156FlashBorrower } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\\\";\\nimport { IERC3156FlashLender } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\\\";\\nimport { RouterSwapper } from \\\"@helpers/RouterSwapper.sol\\\";\\n\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport { IERC4626 } from \\\"contracts/interfaces/external/IERC4626.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nimport { BaseHarvester, YieldBearingParams } from \\\"./BaseHarvester.sol\\\";\\n\\nenum SwapType {\\n  VAULT,\\n  SWAP\\n}\\n\\n/// @title GenericHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Generic contract for anyone to permissionlessly adjust the reserves of Angle Parallelizer\\n/// @dev This contract is an authorized fork of Angle's GenericHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\\ncontract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {\\n  using SafeCast for uint256;\\n  using SafeERC20 for IERC20;\\n\\n  bytes32 public constant CALLBACK_SUCCESS = keccak256(\\\"ERC3156FlashBorrower.onFlashLoan\\\");\\n\\n  /// @notice Parallel stablecoin flashloan contract\\n  IERC3156FlashLender public immutable flashloan;\\n  /// @notice Budget of tokenP available for each users\\n  mapping(address => uint256) public budget;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INITIALIZATION                                                  \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialTokenTransferAddress,\\n    address initialSwapRouter,\\n    ITokenP definitivetokenP,\\n    IParallelizer definitiveParallelizer,\\n    address initialAuthority,\\n    IERC3156FlashLender definitiveFlashloan\\n  )\\n    RouterSwapper(initialSwapRouter, initialTokenTransferAddress)\\n    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)\\n  {\\n    if (address(definitiveFlashloan) == address(0)) revert ZeroAddress();\\n    flashloan = definitiveFlashloan;\\n\\n    IERC20(tokenP).approve(address(definitiveFlashloan), type(uint256).max);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        BUDGET HANDLING\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Add budget to be spent by the receiver during the flashloan\\n   * @param amount amount of tokenP to add to the budget\\n   * @param receiver address of the receiver\\n   */\\n  function addBudget(uint256 amount, address receiver) public virtual {\\n    budget[receiver] += amount;\\n\\n    IERC20(tokenP).safeTransferFrom(msg.sender, address(this), amount);\\n  }\\n\\n  /**\\n   * @notice Remove budget from the owner and send it to the receiver\\n   * @param amount amount of tokenP to remove from the budget\\n   * @param receiver address of the receiver\\n   */\\n  function removeBudget(uint256 amount, address receiver) public virtual {\\n    budget[msg.sender] -= amount; // Will revert if not enough funds\\n\\n    IERC20(tokenP).safeTransfer(receiver, amount);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        HARVEST\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure\\n  ///  to this yieldBearingAsset\\n  /// @dev This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up\\n  /// some yieldBearingAsset that can then be used for people looking to burn deposit tokens\\n  /// @dev Due to potential transaction fees within the Parallelizer, this function doesn't exactly bring\\n  /// `yieldBearingAsset` to the target exposure\\n  /// @dev scale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest,\\n  /// it is used to lower the amount of the asset to harvest for example to have a lower slippage\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual {\\n    if (scale > 1e9) revert InvalidParam();\\n    updateLimitExposuresYieldAsset(yieldBearingAsset);\\n    YieldBearingParams memory yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    (uint8 increase, uint256 amount) = _computeRebalanceAmount(yieldBearingAsset, yieldBearingInfo);\\n    amount = (amount * scale) / 1e9;\\n    if (amount == 0) revert ZeroAmount();\\n    (SwapType swapType, bytes memory data) = abi.decode(extraData, (SwapType, bytes));\\n    try parallelizer.updateOracle(yieldBearingAsset) { } catch { }\\n    _adjustYieldExposure(\\n      amount,\\n      increase,\\n      yieldBearingAsset,\\n      yieldBearingInfo.asset,\\n      (amount * (1e9 - yieldBearingInfo.maxSlippage)) / 1e9,\\n      swapType,\\n      data\\n    );\\n  }\\n\\n  /// @inheritdoc IERC3156FlashBorrower\\n  function onFlashLoan(\\n    address initiator,\\n    address,\\n    uint256 amount,\\n    uint256 fee,\\n    bytes calldata data\\n  )\\n    public\\n    virtual\\n    returns (bytes32)\\n  {\\n    if (msg.sender != address(flashloan) || initiator != address(this) || fee != 0) revert NotTrusted();\\n    address sender;\\n    uint256 typeAction;\\n    uint256 minAmountOut;\\n    SwapType swapType;\\n    bytes memory callData;\\n    address tokenOut;\\n    address tokenIn;\\n    {\\n      address yieldBearingAsset;\\n      address asset;\\n      (sender, typeAction, yieldBearingAsset, asset, minAmountOut, swapType, callData) =\\n        abi.decode(data, (address, uint256, address, address, uint256, SwapType, bytes));\\n      if (typeAction == 1) {\\n        // Increase yield exposure action: we bring in the yield bearing asset\\n        tokenOut = yieldBearingAsset;\\n        tokenIn = asset;\\n      } else {\\n        // Decrease yield exposure action: we bring in the deposit asset\\n        tokenIn = yieldBearingAsset;\\n        tokenOut = asset;\\n      }\\n    }\\n    uint256 amountOut =\\n      parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);\\n\\n    // Swap to tokenIn\\n    amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);\\n\\n    _adjustAllowance(tokenOut, address(parallelizer), amountOut);\\n    uint256 amountStableOut =\\n      parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);\\n    if (amount > amountStableOut) {\\n      budget[sender] -= amount - amountStableOut; // Will revert if not enough funds\\n    }\\n    return CALLBACK_SUCCESS;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    SETTERS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the token transfer contract\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress) public override restricted {\\n    super.setTokenTransferAddress(newTokenTransferAddress);\\n  }\\n\\n  /**\\n   * @notice Set the swap router\\n   * @param newSwapRouter address of the swap router\\n   */\\n  function setSwapRouter(address newSwapRouter) public override restricted {\\n    super.setSwapRouter(newSwapRouter);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INTERNALS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Burns `amountStablecoins` for one yieldBearing asset, swap for asset then mints deposit tokens\\n  /// from the proceeds of the swap.\\n  /// @dev If `increase` is 1, then the system tries to increase its exposure to the yield bearing asset which means\\n  /// burning tokenP for the deposit asset, swapping for the yield bearing asset, then minting the tokenP\\n  /// @dev This function reverts if the second tokenP mint gives less than `minAmountOut` of ag tokens\\n  /// @dev This function reverts if the swap slippage is higher than `maxSlippage`\\n  function _adjustYieldExposure(\\n    uint256 amountStablecoins,\\n    uint8 increase,\\n    address yieldBearingAsset,\\n    address asset,\\n    uint256 minAmountOut,\\n    SwapType swapType,\\n    bytes memory extraData\\n  )\\n    internal\\n  {\\n    flashloan.flashLoan(\\n      IERC3156FlashBorrower(address(this)),\\n      address(tokenP),\\n      amountStablecoins,\\n      abi.encode(msg.sender, increase, yieldBearingAsset, asset, minAmountOut, swapType, extraData)\\n    );\\n  }\\n\\n  function _swapToTokenOut(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    SwapType swapType,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (swapType == SwapType.SWAP) {\\n      amountOut = _swapToTokenOutSwap(tokenIn, tokenOut, amount, callData);\\n    } else if (swapType == SwapType.VAULT) {\\n      amountOut = _swapToTokenOutVault(typeAction, tokenIn, tokenOut, amount);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap token using the router/aggregator\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _swapToTokenOutSwap(\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256)\\n  {\\n    uint256 balance = IERC20(tokenOut).balanceOf(address(this));\\n\\n    address[] memory tokens = new address[](1);\\n    tokens[0] = tokenIn;\\n    bytes[] memory callDatas = new bytes[](1);\\n    callDatas[0] = callData;\\n    uint256[] memory amounts = new uint256[](1);\\n    amounts[0] = amount;\\n    _swap(tokens, callDatas, amounts);\\n\\n    return IERC20(tokenOut).balanceOf(address(this)) - balance;\\n  }\\n\\n  /**\\n   * @dev Deposit or redeem the vault asset\\n   * @param typeAction 1 for deposit, 2 for redeem\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   */\\n  function _swapToTokenOutVault(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (typeAction == 1) {\\n      // Granting allowance with the yieldBearingAsset for the vault asset\\n      _adjustAllowance(tokenIn, tokenOut, amount);\\n      amountOut = IERC4626(tokenOut).deposit(amount, address(this));\\n    } else {\\n      amountOut = IERC4626(tokenIn).redeem(amount, address(this), address(this));\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x604c4f9c755b2eb704dc15ba59046201c0258134ef2fbe15a529c510c68cb40a\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IDiamondCut.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IDiamondCut\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondCut.sol by mudgen\\n/// @dev This interface is an authorized fork of Angle's `IDiamondCut` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IDiamondCut.sol\\ninterface IDiamondCut {\\n  /// @notice Add/replace/remove any number of functions and optionally execute a function with delegatecall\\n  /// @param _diamondCut Contains the facet addresses and function selectors\\n  /// @param _init The address of the contract or facet to execute _calldata\\n  /// @param _calldata A function call, including function selector and arguments, executed with delegatecall on\\n  /// _init\\n  function diamondCut(FacetCut[] calldata _diamondCut, address _init, bytes calldata _calldata) external;\\n}\\n\",\"keccak256\":\"0x08a01f77b740f7da424f0ea27a6a292f9e292058e23d1fe960d2d19a44496c7b\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondEtherscan.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\n/// @title IDiamondEtherscan\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface IDiamondEtherscan {\\n  /// @notice Sets a dummy implementation with the same layout at the diamond proxy contract with all its facets\\n  function setDummyImplementation(address _implementation) external;\\n\\n  /// @notice Address of the dummy implementation used to make the DiamondProxy contract interpretable by Etherscan\\n  function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xf742b55592d129e02fb755d25f7a97ed976a14c4c744d6ac46726809e8f1e037\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondLoupe.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @notice IDiamondLoupe\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondLoupe.sol by mudgen\\ninterface IDiamondLoupe {\\n  /// @notice Gets all facet addresses and their four byte function selectors.\\n  /// @return facets_ Facet\\n  function facets() external view returns (Facet[] memory facets_);\\n\\n  /// @notice Gets all the function selectors supported by a specific facet.\\n  /// @param _facet The facet address.\\n  /// @return facetFunctionSelectors_\\n  function facetFunctionSelectors(address _facet) external view returns (bytes4[] memory facetFunctionSelectors_);\\n\\n  /// @notice Get all the facet addresses used by a diamond.\\n  /// @return facetAddresses_\\n  function facetAddresses() external view returns (address[] memory facetAddresses_);\\n\\n  /// @notice Gets the facet that supports the given selector.\\n  /// @dev If facet is not found return address(0).\\n  /// @param _functionSelector The function selector.\\n  /// @return facetAddress_ The facet address.\\n  function facetAddress(bytes4 _functionSelector) external view returns (address facetAddress_);\\n}\\n\",\"keccak256\":\"0xa5580958acabe2c44967e835e77a748eb0b8812f70cd071191201508c9388ca8\",\"license\":\"MIT\"},\"contracts/interfaces/IGetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IGetters\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IGetters` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IGetters.sol\\ninterface IGetters {\\n  /// @notice Checks whether a given `selector` is actually a valid selector corresponding to a function in one of\\n  /// the\\n  /// facets of the proxy\\n  function isValidSelector(bytes4 selector) external view returns (bool);\\n\\n  /// @notice Stablecoin minted by parallelizer\\n  function tokenP() external view returns (ITokenP);\\n\\n  /// @notice Returns the list of collateral assets supported by the system\\n  function getCollateralList() external view returns (address[] memory);\\n\\n  /// @notice Returns all the info in storage associated to a `collateral`\\n  function getCollateralInfo(address collateral) external view returns (Collateral memory);\\n\\n  /// @notice Returns the decimals of a given `collateral`\\n  function getCollateralDecimals(address collateral) external view returns (uint8);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to mint\\n  /// with `collateral`\\n  function getCollateralMintFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to burn\\n  /// for `collateral`\\n  function getCollateralBurnFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays used to compute the penalty factor depending on the collateral\\n  /// ratio when users come to redeem\\n  function getRedemptionFees() external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the collateral ratio of Parallelizer in base `10**9` and a rounded version of the total amount\\n  /// of stablecoins issued\\n  function getCollateralRatio() external view returns (uint64 collatRatio, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the total amount of stablecoins issued through Parallelizer\\n  function getTotalIssued() external view returns (uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the amount of stablecoins issued from `collateral` and the total amount of stablecoins issued\\n  /// through Parallelizer\\n  function getIssuedByCollateral(address collateral)\\n    external\\n    view\\n    returns (uint256 stablecoinsFromCollateral, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns if a collateral is \\\"managed\\\" and the associated manager configuration\\n  function getManagerData(address collateral)\\n    external\\n    view\\n    returns (bool isManaged, IERC20[] memory subCollaterals, bytes memory config);\\n\\n  /// @notice Returns the oracle values associated to `collateral`\\n  /// @return mint Oracle value to be used for a mint transaction with `collateral`\\n  /// @return burn Oracle value that will be used for `collateral` for a burn transaction. This value\\n  /// is then used along with oracle values for all other collateral assets to get a global burn value for the oracle\\n  /// @return ratio Ratio, in base `10**18` between the oracle value of the `collateral` and its target price.\\n  /// This value is 10**18 if the oracle is greater than the collateral price\\n  /// @return minRatio Minimum ratio across all collateral assets between a collateral burn price and its target\\n  /// price. This value is independent of `collateral` and is used to normalize the burn oracle value for burn\\n  /// transactions.\\n  /// @return redemption Oracle value that would be used to price `collateral` when computing the collateral ratio\\n  /// during a redemption\\n  function getOracleValues(address collateral)\\n    external\\n    view\\n    returns (uint256 mint, uint256 burn, uint256 ratio, uint256 minRatio, uint256 redemption);\\n\\n  /// @notice Returns the data used to compute oracle values for `collateral`\\n  /// @return oracleType Type of oracle (Chainlink, external smart contract, ...)\\n  /// @return targetType Type passed to read the value of the target price\\n  /// @return oracleData Extra data needed to read the oracle. For Chainlink oracles, this data is supposed to give\\n  /// the addresses of the Chainlink feeds to read, the stale periods for each feed, ...\\n  /// @return targetData Extra data needed to read the target price of the asset\\n  function getOracle(address collateral)\\n    external\\n    view\\n    returns (\\n      OracleReadType oracleType,\\n      OracleReadType targetType,\\n      bytes memory oracleData,\\n      bytes memory targetData,\\n      bytes memory hyperparameters\\n    );\\n\\n  /// @notice Returns if the associated functionality is paused or not\\n  function isPaused(address collateral, ActionType action) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update normalizers\\n  function isTrusted(address sender) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update sell rewards\\n  function isTrustedSeller(address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` has a non null entry in the `isWhitelistedForType` storage mapping\\n  /// @dev Note that ultimately whitelisting may depend as well on external providers\\n  function isWhitelistedForType(WhitelistType whitelistType, address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` can deal with `collateral` during burns and redemptions\\n  function isWhitelistedForCollateral(address collateral, address sender) external returns (bool);\\n\\n  /// @notice Checks whether only whitelisted address can deal with `collateral` during burns and redemptions\\n  function isWhitelistedCollateral(address collateral) external view returns (bool);\\n\\n  /// @notice Gets the data needed to deal with whitelists for `collateral`\\n  function getCollateralWhitelistData(address collateral) external view returns (bytes memory);\\n\\n  /// @notice Returns the stablecoin cap for `collateral`\\n  function getStablecoinCap(address collateral) external view returns (uint256);\\n\\n  /// @notice Returns the address of the `accessManager` contract\\n  function accessManager() external view returns (address);\\n\\n  /// @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n  /// being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n  /// attacker controlled calls.\\n  function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaa9eba6ee7770d6146fedbfef07ad10ff09524692319ca0cc32abfa64a2b597b\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IHarvester` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IHarvester.sol\\ninterface IHarvester {\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address stablecoin,\\n    uint64 targetExposure,\\n    uint64 minExposureYieldAsset,\\n    uint64 maxExposureYieldAsset,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external;\\n\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) external;\\n\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external;\\n\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) external;\\n}\\n\",\"keccak256\":\"0x0d4e8fee737f4f747060a3c5044c8cb2f153faa228ad37a661a659ca62aab055\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IParallelizer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IDiamondCut } from \\\"./IDiamondCut.sol\\\";\\nimport { IDiamondEtherscan } from \\\"./IDiamondEtherscan.sol\\\";\\nimport { IDiamondLoupe } from \\\"./IDiamondLoupe.sol\\\";\\nimport { IGetters } from \\\"./IGetters.sol\\\";\\nimport { IRedeemer } from \\\"./IRedeemer.sol\\\";\\nimport { IRewardHandler } from \\\"./IRewardHandler.sol\\\";\\nimport { ISettersGovernor, ISettersGuardian } from \\\"./ISetters.sol\\\";\\nimport { ISwapper } from \\\"./ISwapper.sol\\\";\\n\\n/// @title IParallelizer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IParallelizer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IParallelizer.sol\\ninterface IParallelizer is\\n  IDiamondCut,\\n  IDiamondEtherscan,\\n  IDiamondLoupe,\\n  IGetters,\\n  IRedeemer,\\n  IRewardHandler,\\n  ISettersGovernor,\\n  ISettersGuardian,\\n  ISwapper\\n{ }\\n\",\"keccak256\":\"0x8bd964110c6a122bdb6cf58a194a97c894900237ebd7f3b11e2f43c6ee56ae7c\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRedeemer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRedeemer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRedeemer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRedeemer.sol\\ninterface IRedeemer {\\n  /// @notice Redeems `amount` of stablecoins from the system\\n  /// @param receiver Address which should be receiving the output tokens\\n  /// @param deadline Timestamp before which the redemption should have occured\\n  /// @param minAmountOuts Minimum amount of each token given back in the redemption to obtain\\n  /// @return tokens List of tokens returned\\n  /// @return amounts Amount given for each token in the `tokens` array\\n  function redeem(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Same as the redeem function above with the additional feature to specify a list of `forfeitTokens` for\\n  /// which the Parallelizer system will not try to do a transfer to `receiver`.\\n  function redeemWithForfeit(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts,\\n    address[] memory forfeitTokens\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Simulate the exact output that a redemption of `amount` of stablecoins would give at a given block\\n  /// @return tokens List of tokens that would be given\\n  /// @return amounts Amount that would be obtained for each token in the `tokens` array\\n  function quoteRedemptionCurve(uint256 amount)\\n    external\\n    view\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Updates the normalizer variable by `amount`\\n  function updateNormalizer(uint256 amount, bool increase) external returns (uint256);\\n}\\n\",\"keccak256\":\"0xb3522ee0380b321c64d02bf2db2acb658d8b314b811dd54b6a718d6708b5fb21\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRewardHandler.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRewardHandler\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRewardHandler` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRewardHandler.sol\\ninterface IRewardHandler {\\n  /// @notice Sells some external tokens through a odos call\\n  /// @param minAmountOut Minimum amount of the outToken to get\\n  /// @param payload Payload to pass to odos\\n  /// @return amountOut Amount obtained of the outToken\\n  function sellRewards(uint256 minAmountOut, bytes memory payload) external returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xff2afcbc8d1c25297324159d3684a323e60b3c9408129aba70d3d6938d093255\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/interfaces/IERC20.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISettersGovernor` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISetters.sol\\ninterface ISettersGovernor {\\n  /// @notice Recovers `amount` of `token` from the Parallelizer contract\\n  function recoverERC20(address collateral, IERC20 token, address to, uint256 amount) external;\\n\\n  /// @notice Sets a new access manager address\\n  function setAccessManager(address _newAccessManager) external;\\n\\n  /// @notice Sets (or unsets) a collateral manager  `collateral`\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before setting the new manager\\n  function setCollateralManager(\\n    address collateral,\\n    bool checkExternalManagerBalance,\\n    ManagerStorage memory managerData\\n  )\\n    external;\\n\\n  /// @notice Sets the allowance of the contract on `token` for `spender` to `amount`\\n  function changeAllowance(IERC20 token, address spender, uint256 amount) external;\\n\\n  /// @notice Changes the trusted status for `sender` when for selling rewards or updating the normalizer\\n  function toggleTrusted(address sender, TrustedType t) external;\\n\\n  /// @notice Changes whether a `collateral` can only be handled during burns and redemptions by whitelisted\\n  /// addresses\\n  /// and sets the data used to read into the whitelist\\n  function setWhitelistStatus(address collateral, uint8 whitelistStatus, bytes memory whitelistData) external;\\n\\n  /// @notice Add `collateral` as a supported collateral in the system\\n  function addCollateral(address collateral) external;\\n\\n  /// @notice Adjusts the amount of stablecoins issued from `collateral` by `amount`\\n  function adjustStablecoins(address collateral, uint128 amount, bool increase) external;\\n\\n  /// @notice Revokes `collateral` from the system\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before revoking the collateral\\n  function revokeCollateral(address collateral, bool checkExternalManagerBalance) external;\\n\\n  /// @notice Sets the `oracleConfig` used to read the value of `collateral` for the mint, burn and redemption\\n  /// operations\\n  function setOracle(address collateral, bytes memory oracleConfig) external;\\n\\n  /// @notice Update oracle data for a given `collateral`\\n  function updateOracle(address collateral) external;\\n}\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface ISettersGuardian {\\n  /// @notice Changes the pause status for mint or burn transactions for `collateral`\\n  function togglePause(address collateral, ActionType action) external;\\n\\n  /// @notice Sets the mint or burn fees for `collateral`\\n  function setFees(address collateral, uint64[] memory xFee, int64[] memory yFee, bool mint) external;\\n\\n  /// @notice Sets the parameters for the redemption curve\\n  function setRedemptionCurveParams(uint64[] memory xFee, int64[] memory yFee) external;\\n\\n  /// @notice Changes the whitelist status for a collateral with `whitelistType` for an address `who`\\n  function toggleWhitelist(WhitelistType whitelistType, address who) external;\\n\\n  /// @notice Sets the stablecoin cap that can be issued from a `collateral`\\n  function setStablecoinCap(address collateral, uint256 stablecoinCap) external;\\n}\\n\",\"keccak256\":\"0xc3fb2012e7c2f97ae93b12276afc4293aaeb97a6fe4d60109acaa94ef6945575\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title ISwapper\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISwapper` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISwapper.sol\\ninterface ISwapper {\\n  /// @notice Swaps (that is to say mints or burns) an exact amount of `tokenIn` for an amount of `tokenOut`\\n  /// @param amountIn Amount of `tokenIn` to bring\\n  /// @param amountOutMin Minimum amount of `tokenOut` to get: if `amountOut` is inferior to this amount, the\\n  /// function will revert\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountOut Amount of `tokenOut` obtained through the swap\\n  function swapExactInput(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Same as `swapExactInput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactInputWithPermit(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Swaps (that is to say mints or burns) an amount of `tokenIn` for an exact amount of `tokenOut`\\n  /// @param amountOut Amount of `tokenOut` to obtain from the swap\\n  /// @param amountInMax Maximum amount of `tokenIn` to bring in order to get `amountOut` of `tokenOut`\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountIn Amount of `tokenIn` used to perform the swap\\n  function swapExactOutput(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Same as `swapExactOutput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactOutputWithPermit(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Simulates what a call to `swapExactInput` with `amountIn` of `tokenIn` for `tokenOut` would give.\\n  /// If called right before and at the same block, the `amountOut` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactInput`\\n  function quoteIn(uint256 amountIn, address tokenIn, address tokenOut) external view returns (uint256 amountOut);\\n\\n  /// @notice Simulates what a call to `swapExactOutput` for `amountOut` of `tokenOut` with `tokenIn` would give.\\n  /// If called right before and at the same block, the `amountIn` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactOutput`\\n  function quoteOut(uint256 amountOut, address tokenIn, address tokenOut) external view returns (uint256 amountIn);\\n}\\n\",\"keccak256\":\"0x47e4b2742a51b82b9df72fb681335affe8519f4114fb540cd29d8f48ed182ffd\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ITokenP.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/// @title ITokenP\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @notice Interface for the stablecoins `tokenP` contracts\\n/// @dev This interface is an authorized fork of Angle's `IAgToken` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IAgToken.sol\\ninterface ITokenP is IERC20 {\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    MINTER ROLE ONLY FUNCTIONS                                            \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Lets a whitelisted contract mint tokenPs\\n  /// @param account Address to mint to\\n  /// @param amount Amount to mint\\n  function mint(address account, uint256 amount) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address after being asked to by `sender`\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @param sender Address which requested the burn from `burner`\\n  /// @dev This method is to be called by a contract with the minter right after being requested\\n  /// to do so by a `sender` address willing to burn tokens from another `burner` address\\n  /// @dev The method checks the allowance between the `sender` and the `burner`\\n  function burnFrom(uint256 amount, address burner, address sender) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @dev This method is to be called by a contract with a minter right on the tokenP after being\\n  /// requested to do so by an address willing to burn tokens from its address\\n  function burnSelf(uint256 amount, address burner) external;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EXTERNAL FUNCTIONS                                                \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Amount of decimals of the stablecoin\\n  function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x64a1305faa8c5c91767a11af0eae16e4b463aa0bfe10f11b74aae9d96681a5eb\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/IERC4626.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\n// OpenZeppelin Contracts (last updated v4.7.0) (interfaces/IERC4626.sol)\\n\\npragma solidity >=0.5.0;\\n\\n/// @notice ERC4626 interface\\n/// @author OpenZeppelin\\n/// @dev In this implementation, the interface only contains the functions that the IERC4626 interface adds on top of\\n/// the IERC20 interface\\ninterface IERC4626 {\\n  /**\\n   * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.\\n   *\\n   * - MUST be an ERC-20 token contract.\\n   * - MUST NOT revert.\\n   */\\n  function asset() external view returns (address assetTokenAddress);\\n\\n  /**\\n   * @dev Returns the total amount of the underlying asset that is \\u201cmanaged\\u201d by Vault.\\n   *\\n   * - SHOULD include any compounding that occurs from yield.\\n   * - MUST be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT revert.\\n   */\\n  function totalAssets() external view returns (uint256 totalManagedAssets);\\n\\n  /**\\n   * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToShares(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToAssets(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,\\n   * through a deposit call.\\n   *\\n   * - MUST return a limited value if receiver is subject to some deposit limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.\\n   * - MUST NOT revert.\\n   */\\n  function maxDeposit(address receiver) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit\\n   *   call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called\\n   *   in the same transaction.\\n   * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the\\n   *   deposit would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewDeposit(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   deposit execution, and are accounted for during deposit.\\n   * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function deposit(uint256 assets, address receiver) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.\\n   * - MUST return a limited value if receiver is subject to some mint limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.\\n   * - MUST NOT revert.\\n   */\\n  function maxMint(address receiver) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call\\n   *   in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the\\n   *   same transaction.\\n   * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint\\n   *   would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by minting.\\n   */\\n  function previewMint(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint\\n   *   execution, and are accounted for during mint.\\n   * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function mint(uint256 shares, address receiver) external returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the\\n   * Vault, through a withdraw call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxWithdraw(address owner) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw\\n   *   call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if\\n   *   called\\n   *   in the same transaction.\\n   * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though\\n   *   the withdrawal would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewWithdraw(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   withdraw execution, and are accounted for during withdraw.\\n   * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,\\n   * through a redeem call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxRedeem(address owner) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call\\n   *   in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the\\n   *   same transaction.\\n   * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the\\n   *   redemption would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by redeeming.\\n   */\\n  function previewRedeem(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   redeem execution, and are accounted for during redeem.\\n   * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);\\n}\\n\",\"keccak256\":\"0xd730d6a6b679201eec89dff3133de651da20b3e72e74f01b734078bfacf952ad\",\"license\":\"GPL-3.0\"},\"contracts/parallelizer/Storage.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        ENUMS                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nenum FacetCutAction {\\n  Add,\\n  Replace,\\n  Remove\\n}\\n\\nenum ManagerType {\\n  EXTERNAL\\n}\\n\\nenum ActionType {\\n  Mint,\\n  Burn,\\n  Redeem\\n}\\n\\nenum TrustedType {\\n  Updater,\\n  Seller\\n}\\n\\nenum QuoteType {\\n  MintExactInput,\\n  MintExactOutput,\\n  BurnExactInput,\\n  BurnExactOutput\\n}\\n\\nenum OracleReadType {\\n  CHAINLINK_FEEDS,\\n  EXTERNAL,\\n  NO_ORACLE,\\n  STABLE,\\n  WSTETH,\\n  CBETH,\\n  RETH,\\n  SFRXETH,\\n  MAX,\\n  MORPHO_ORACLE\\n}\\n\\nenum OracleQuoteType {\\n  UNIT,\\n  TARGET\\n}\\n\\nenum WhitelistType {\\n  BACKED\\n}\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                    STRUCTS                                                     \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nstruct Permit2Details {\\n  address to; // Address that will receive the funds\\n  uint256 nonce; // Nonce of the transaction\\n  bytes signature; // Permit signature of the user\\n}\\n\\nstruct FacetCut {\\n  address facetAddress; // Facet contract address\\n  FacetCutAction action; // Can be add, remove or replace\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct Facet {\\n  address facetAddress; // Facet contract address\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct FacetInfo {\\n  address facetAddress; // Facet contract address\\n  uint16 selectorPosition; // Position in the list of all selectors\\n}\\n\\nstruct DiamondStorage {\\n  bytes4[] selectors; // List of all available selectors\\n  mapping(bytes4 => FacetInfo) selectorInfo; // Selector to (address, position in list)\\n  IAccessManager accessManager; // Contract handling access management\\n}\\n\\nstruct ImplementationStorage {\\n  address implementation; // Dummy implementation address for Etherscan usability\\n}\\n\\nstruct ManagerStorage {\\n  IERC20[] subCollaterals; // Subtokens handled by the manager or strategies\\n  bytes config; // Additional configuration data\\n}\\n\\nstruct Collateral {\\n  uint8 isManaged; // If the collateral is managed through external strategies\\n  uint8 isMintLive; // If minting from this asset is unpaused\\n  uint8 isBurnLive; // If burning to this asset is unpaused\\n  uint8 decimals; // IERC20Metadata(collateral).decimals()\\n  uint8 onlyWhitelisted; // If only whitelisted addresses can burn or redeem for this token\\n  uint216 normalizedStables; // Normalized amount of stablecoins issued from this collateral\\n  uint64[] xFeeMint; // Increasing exposures in [0,BASE_9[\\n  int64[] yFeeMint; // Mint fees at the exposures specified in `xFeeMint`\\n  uint64[] xFeeBurn; // Decreasing exposures in ]0,BASE_9]\\n  int64[] yFeeBurn; // Burn fees at the exposures specified in `xFeeBurn`\\n  bytes oracleConfig; // Data about the oracle used for the collateral\\n  bytes whitelistData; // For whitelisted collateral, data used to verify whitelists\\n  ManagerStorage managerData; // For managed collateral, data used to handle the strategies\\n  uint256 stablecoinCap; // Cap on the amount of stablecoins that can be issued from this collateral\\n}\\n\\nstruct ParallelizerStorage {\\n  ITokenP tokenP; // tokenP handled by the system\\n  uint8 isRedemptionLive; // If redemption is unpaused\\n  uint8 statusReentrant; // If call is reentrant or not\\n  bool consumingSchedule; // If the contract is consuming a scheduled operation\\n  uint128 normalizedStables; // Normalized amount of stablecoins issued by the system\\n  uint128 normalizer; // To reconcile `normalizedStables` values with the actual amount\\n  address[] collateralList; // List of collateral assets supported by the system\\n  uint64[] xRedemptionCurve; // Increasing collateral ratios > 0\\n  int64[] yRedemptionCurve; // Value of the redemption fees at `xRedemptionCurve`\\n  mapping(address => Collateral) collaterals; // Maps a collateral asset to its parameters\\n  mapping(address => uint256) isTrusted; // If an address is trusted to update the normalizer value\\n  mapping(address => uint256) isSellerTrusted; // If an address is trusted to sell accruing reward tokens or to run\\n    // keeper jobs on oracles\\n  mapping(WhitelistType => mapping(address => uint256)) isWhitelistedForType;\\n}\\n// Whether an address is whitelisted for a specific whitelist type\\n\",\"keccak256\":\"0x3f4313dd110dbe390038320b2d3cf24dcbe9b75cd9573e7f048f7233c02dd227\",\"license\":\"BUSL-1.1\"},\"contracts/utils/AccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { AuthorityUtils } from \\\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { IAccessManaged } from \\\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\\\";\\nimport { Context } from \\\"@openzeppelin/contracts/utils/Context.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\n/// @title AccessControl\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Fork of OpenZeppelin's `AccessManaged` contract\\n/// updated to make _checkCanCall to return bool\\n/// https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/manager/AccessManaged.sol\\ncontract AccessManaged is Context, IAccessManaged {\\n  address private _authority;\\n\\n  bool private _consumingSchedule;\\n\\n  /**\\n   * @dev Initializes the contract connected to an initial authority.\\n   */\\n  constructor(address initialAuthority) {\\n    _setAuthority(initialAuthority);\\n  }\\n\\n  /**\\n   * @dev Restricts access to a function as defined by the connected Authority for this contract and the\\n   * caller and selector of the function that entered the contract.\\n   *\\n   * [IMPORTANT]\\n   * ====\\n   * In general, this modifier should only be used on `external` functions. It is okay to use it on `public`\\n   * functions that are used as external entry points and are not called internally. Unless you know what you're\\n   * doing, it should never be used on `internal` functions. Failure to follow these rules can have critical security\\n   * implications! This is because the permissions are determined by the function that entered the contract, i.e. the\\n   * function at the bottom of the call stack, and not the function where the modifier is visible in the source code.\\n   * ====\\n   *\\n   * [WARNING]\\n   * ====\\n   * Avoid adding this modifier to the\\n   * https://docs.soliditylang.org/en/v0.8.20/contracts.html#receive-ether-function[`receive()`]\\n   * function or the https://docs.soliditylang.org/en/v0.8.20/contracts.html#fallback-function[`fallback()`]. These\\n   * functions are the only execution paths where a function selector cannot be unambiguously determined from the\\n   * calldata\\n   * since the selector defaults to `0x00000000` in the `receive()` function and similarly in the `fallback()`\\n   * function\\n   * if no calldata is provided. (See {_checkCanCall}).\\n   *\\n   * The `receive()` function will always panic whereas the `fallback()` may panic depending on the calldata length.\\n   * ====\\n   */\\n  modifier restricted() {\\n    address caller = _msgSender();\\n    require(_checkCanCall(caller, _msgData()), AccessManagedUnauthorized(caller));\\n    _;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function authority() public view virtual returns (address) {\\n    return _authority;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function setAuthority(address newAuthority) public virtual {\\n    address caller = _msgSender();\\n    if (caller != authority()) {\\n      revert AccessManagedUnauthorized(caller);\\n    }\\n    if (newAuthority.code.length == 0) {\\n      revert AccessManagedInvalidAuthority(newAuthority);\\n    }\\n    _setAuthority(newAuthority);\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function isConsumingScheduledOp() public view returns (bytes4) {\\n    return _consumingSchedule ? this.isConsumingScheduledOp.selector : bytes4(0);\\n  }\\n\\n  /**\\n   * @dev Transfers control to a new authority. Internal function with no access restriction. Allows bypassing the\\n   * permissions set by the current authority.\\n   */\\n  function _setAuthority(address newAuthority) internal virtual {\\n    _authority = newAuthority;\\n    emit AuthorityUpdated(newAuthority);\\n  }\\n\\n  function _checkCanCall(address caller, bytes calldata data) internal virtual returns (bool) {\\n    (bool immediate, uint32 delay) =\\n      AuthorityUtils.canCallWithDelay(authority(), caller, address(this), bytes4(data[0:4]));\\n    if (!immediate) {\\n      if (delay > 0) {\\n        _consumingSchedule = true;\\n        IAccessManager(authority()).consumeScheduledOp(caller, data);\\n        _consumingSchedule = false;\\n      } else {\\n        return false;\\n      }\\n    }\\n    return true;\\n  }\\n}\\n\",\"keccak256\":\"0x40dfee0e736695b3005df6c150a2d794ac06f3f4b91745e2959623e770044798\",\"license\":\"BUSL-1.1\"},\"contracts/utils/Errors.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nerror AccessManagedUnauthorized(address caller);\\nerror AlreadyAdded();\\nerror CannotAddFunctionToDiamondThatAlreadyExists(bytes4 _selector);\\nerror CannotAddSelectorsToZeroAddress(bytes4[] _selectors);\\nerror CannotRemoveFunctionThatDoesNotExist(bytes4 _selector);\\nerror CannotRemoveImmutableFunction(bytes4 _selector);\\nerror CannotReplaceFunctionsFromFacetWithZeroAddress(bytes4[] _selectors);\\nerror CannotReplaceFunctionThatDoesNotExists(bytes4 _selector);\\nerror CannotReplaceFunctionWithTheSameFunctionFromTheSameFacet(bytes4 _selector);\\nerror CannotReplaceImmutableFunction(bytes4 _selector);\\nerror ContractHasNoCode();\\nerror CollateralBacked();\\nerror FunctionNotFound(bytes4 _functionSelector);\\nerror IncorrectFacetCutAction(uint8 _action);\\nerror InitializationFunctionReverted(address _initializationContractAddress, bytes _calldata);\\nerror InvalidChainlinkRate();\\nerror InvalidLengths();\\nerror InvalidNegativeFees();\\nerror InvalidOracleType();\\nerror InvalidParam();\\nerror InvalidParams();\\nerror InvalidRate();\\nerror InvalidSwap();\\nerror InvalidTokens();\\nerror InvalidAccessManager();\\nerror ManagerHasAssets();\\nerror NoSelectorsProvidedForFacetForCut(address _facetAddress);\\nerror NotAllowed();\\nerror NotCollateral();\\nerror NotGovernor();\\nerror NotGuardian();\\nerror NotTrusted();\\nerror NotTrustedOrGuardian();\\nerror NotWhitelisted();\\nerror OdosSwapFailed();\\nerror OracleUpdateFailed();\\nerror Paused();\\nerror ReentrantCall();\\nerror RemoveFacetAddressMustBeZeroAddress(address _facetAddress);\\nerror TooBigAmountIn();\\nerror TooLate();\\nerror TooSmallAmountOut();\\nerror ZeroAddress();\\nerror ZeroAmount();\\nerror SwapError();\\nerror SlippageTooHigh();\\nerror InsufficientFunds();\\n\",\"keccak256\":\"0x1e2f6812ef78e948e5155d32213b52afff8c0ba5463d18bee10694efbf886130\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
-  "bytecode": "0x60e080604052346101e95760c08161278a803803809161001f828561020f565b8339810103126101e95761003281610246565b9061003f60208201610246565b6040820151926001600160a01b038416918285036101e95760608401516001600160a01b03811681036101e95760a061007a60808701610246565b950151956001600160a01b038716958688036101e9575f80546001600160a01b0319166001600160a01b0390921691821790556040519081527f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad90602090a160a052608052600480546001600160a01b039283166001600160a01b0319918216179091556005805493909216921691909117905581156102005760446020925f9460c052604051948593849263095ea7b360e01b84526004840152811960248401525af180156101f5576101b9575b60405161252f908161025b823960805181818161027601528181610ce401528181610e1b01528181611d1901526120ab015260a0518181816103bf0152818161066a01528181610e480152818161155201526115d9015260c05181818161040701528181610d5901526115960152f35b6020813d6020116101ed575b816101d26020938361020f565b810103126101e95751801515036101e9575f610149565b5f80fd5b3d91506101c5565b6040513d5f823e3d90fd5b63d92e233d60e01b5f5260045ffd5b601f909101601f19168101906001600160401b0382119082101761023257604052565b634e487b7160e01b5f52604160045260245ffd5b51906001600160a01b03821682036101e95756fe60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220ec283012c4b4807e318035ba023be8591bf414e2388206dea6cd585b6cb7364064736f6c634300081c0033",
-  "deployedBytecode": "0x60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220ec283012c4b4807e318035ba023be8591bf414e2388206dea6cd585b6cb7364064736f6c634300081c0033",
-  "devdoc": {
-    "author": "Cooper Labs",
-    "custom:contact": "security@cooperlabs.xyz",
-    "details": "Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol",
-    "errors": {
-      "SafeERC20FailedOperation(address)": [
-        {
-          "details": "An operation with an ERC-20 token failed."
-        }
-      ]
-    },
-    "events": {
-      "AuthorityUpdated(address)": {
-        "details": "Authority that manages this contract was updated."
-      }
-    },
-    "kind": "dev",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to add to the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "authority()": {
-        "details": "Returns the current authority."
-      },
-      "computeRebalanceAmount(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        },
-        "returns": {
-          "amount": "amount to be rebalanced",
-          "increase": "whether the exposure should be increased"
-        }
-      },
-      "harvest(address,uint256,bytes)": {
-        "details": "This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage"
-      },
-      "isConsumingScheduledOp()": {
-        "details": "Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls."
-      },
-      "onFlashLoan(address,address,uint256,uint256,bytes)": {
-        "details": "Receive a flash loan.",
-        "params": {
-          "amount": "The amount of tokens lent.",
-          "data": "Arbitrary data structure, intended to contain user-defined parameters.",
-          "fee": "The additional amount of tokens to repay.",
-          "initiator": "The initiator of the loan.",
-          "token": "The loan currency."
-        },
-        "returns": {
-          "_0": "The keccak256 hash of \"ERC3156FlashBorrower.onFlashLoan\""
-        }
-      },
-      "recoverERC20(address,uint256,address)": {
-        "params": {
-          "amountToRecover": "amount to recover",
-          "to": "address to send the recovered tokens",
-          "tokenAddress": "address of the token to recover"
-        }
-      },
-      "removeBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to remove from the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "setAuthority(address)": {
-        "details": "Transfers control to a new authority. The caller must be the current authority."
-      },
-      "setMaxSlippage(address,uint96)": {
-        "params": {
-          "newMaxSlippage": "new max allowed slippage"
-        }
-      },
-      "setSwapRouter(address)": {
-        "params": {
-          "newSwapRouter": "address of the swap router"
-        }
-      },
-      "setTargetExposure(address,uint64)": {
-        "params": {
-          "targetExposure": "target exposure to the yield bearing asset used",
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      },
-      "setTokenTransferAddress(address)": {
-        "params": {
-          "newTokenTransferAddress": "address of the token transfer contract"
-        }
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "params": {
-          "asset": "address of the asset",
-          "maxExposure": "maximum exposure within the Parallelizer to the asset",
-          "minExposure": "minimum exposure within the Parallelizer to the asset",
-          "overrideExposures": "whether limit exposures should be overriden or read onchain through the Parallelizer",
-          "targetExposure": "target exposure to the yieldBearingAsset asset used",
-          "yieldBearingAsset": "address of the yieldBearingAsset"
-        }
-      },
-      "toggleTrusted(address)": {
-        "params": {
-          "trusted": "address to toggle the trusted status"
-        }
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      }
-    },
-    "title": "GenericHarvester",
-    "version": 1
-  },
-  "userdoc": {
-    "events": {
-      "SwapRouterUpdated(address)": {
-        "notice": "Event emitted when the swap router is updated"
-      },
-      "TokenTransferAddressUpdated(address)": {
-        "notice": "Event emitted when the token proxy is updated"
-      }
-    },
-    "kind": "user",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "notice": "Add budget to be spent by the receiver during the flashloan"
-      },
-      "budget(address)": {
-        "notice": "Budget of tokenP available for each users"
-      },
-      "computeRebalanceAmount(address)": {
-        "notice": "Compute the amount needed to rebalance the Parallelizer"
-      },
-      "flashloan()": {
-        "notice": "Parallel stablecoin flashloan contract"
-      },
-      "harvest(address,uint256,bytes)": {
-        "notice": "Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset"
-      },
-      "isTrusted(address)": {
-        "notice": "trusted addresses that can update target exposure and do others non critical operations"
-      },
-      "maxTokenSlippage(address)": {
-        "notice": "Max slippage when dealing with the Parallelizer"
-      },
-      "parallelizer()": {
-        "notice": "Reference to the `parallelizer` implementation this contract aims at rebalancing"
-      },
-      "recoverERC20(address,uint256,address)": {
-        "notice": "Recover ERC20 tokens"
-      },
-      "removeBudget(uint256,address)": {
-        "notice": "Remove budget from the owner and send it to the receiver"
-      },
-      "setMaxSlippage(address,uint96)": {
-        "notice": "Set the max allowed slippage"
-      },
-      "setSwapRouter(address)": {
-        "notice": "Set the swap router"
-      },
-      "setTargetExposure(address,uint64)": {
-        "notice": "Set the target exposure of a yield bearing asset"
-      },
-      "setTokenTransferAddress(address)": {
-        "notice": "Set the token transfer address"
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "notice": "Set the yieldBearingAsset data"
-      },
-      "swapRouter()": {
-        "notice": "address of the router/aggregator"
-      },
-      "toggleTrusted(address)": {
-        "notice": "Toggle the trusted status of an address"
-      },
-      "tokenP()": {
-        "notice": "TokenP handled by the `parallelizer` of interest"
-      },
-      "tokenTransferAddress()": {
-        "notice": "address to approve to transfer tokens to"
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "notice": "Set the limit exposures to the asset linked to the yield bearing asset"
-      },
-      "yieldBearingData(address)": {
-        "notice": "Data associated to a yield bearing asset"
-      }
-    },
-    "version": 1
-  },
-  "storageLayout": {
-    "storage": [
-      {
-        "astId": 22996,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_authority",
-        "offset": 0,
-        "slot": "0",
-        "type": "t_address"
-      },
-      {
-        "astId": 22998,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_consumingSchedule",
-        "offset": 20,
-        "slot": "0",
-        "type": "t_bool"
-      },
-      {
-        "astId": 8228,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "maxTokenSlippage",
-        "offset": 0,
-        "slot": "1",
-        "type": "t_mapping(t_address,t_uint96)"
-      },
-      {
-        "astId": 8234,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "yieldBearingData",
-        "offset": 0,
-        "slot": "2",
-        "type": "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)"
-      },
-      {
-        "astId": 8239,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "isTrusted",
-        "offset": 0,
-        "slot": "3",
-        "type": "t_mapping(t_address,t_bool)"
-      },
-      {
-        "astId": 43,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "swapRouter",
-        "offset": 0,
-        "slot": "4",
-        "type": "t_address"
-      },
-      {
-        "astId": 46,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "tokenTransferAddress",
-        "offset": 0,
-        "slot": "5",
-        "type": "t_address"
-      },
-      {
-        "astId": 8955,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "budget",
-        "offset": 0,
-        "slot": "6",
-        "type": "t_mapping(t_address,t_uint256)"
-      }
-    ],
-    "types": {
-      "t_address": {
-        "encoding": "inplace",
-        "label": "address",
-        "numberOfBytes": "20"
-      },
-      "t_bool": {
-        "encoding": "inplace",
-        "label": "bool",
-        "numberOfBytes": "1"
-      },
-      "t_mapping(t_address,t_bool)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => bool)",
-        "numberOfBytes": "32",
-        "value": "t_bool"
-      },
-      "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => struct YieldBearingParams)",
-        "numberOfBytes": "32",
-        "value": "t_struct(YieldBearingParams)8169_storage"
-      },
-      "t_mapping(t_address,t_uint256)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint256)",
-        "numberOfBytes": "32",
-        "value": "t_uint256"
-      },
-      "t_mapping(t_address,t_uint96)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint96)",
-        "numberOfBytes": "32",
-        "value": "t_uint96"
-      },
-      "t_struct(YieldBearingParams)8169_storage": {
-        "encoding": "inplace",
-        "label": "struct YieldBearingParams",
-        "members": [
-          {
-            "astId": 8158,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "asset",
-            "offset": 0,
-            "slot": "0",
-            "type": "t_address"
-          },
-          {
-            "astId": 8160,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "targetExposure",
-            "offset": 20,
-            "slot": "0",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8162,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxExposure",
-            "offset": 0,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8164,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "minExposure",
-            "offset": 8,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8166,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "overrideExposures",
-            "offset": 16,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8168,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxSlippage",
-            "offset": 0,
-            "slot": "2",
-            "type": "t_uint96"
-          }
-        ],
-        "numberOfBytes": "96"
-      },
-      "t_uint256": {
-        "encoding": "inplace",
-        "label": "uint256",
-        "numberOfBytes": "32"
-      },
-      "t_uint64": {
-        "encoding": "inplace",
-        "label": "uint64",
-        "numberOfBytes": "8"
-      },
-      "t_uint96": {
-        "encoding": "inplace",
-        "label": "uint96",
-        "numberOfBytes": "12"
-      }
-    }
-  }
-}
\ No newline at end of file
diff --git a/deployments/sonic/GenericHarvester_USDp.json b/deployments/sonic/GenericHarvester_USDp.json
deleted file mode 100644
index ec8c813..0000000
--- a/deployments/sonic/GenericHarvester_USDp.json
+++ /dev/null
@@ -1,1124 +0,0 @@
-{
-  "address": "0x120805265fA944834DC6e930De2995768806a9d2",
-  "abi": [
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initialTokenTransferAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialSwapRouter",
-          "type": "address"
-        },
-        {
-          "internalType": "contract ITokenP",
-          "name": "definitivetokenP",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IParallelizer",
-          "name": "definitiveParallelizer",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "initialAuthority",
-          "type": "address"
-        },
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "definitiveFlashloan",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "constructor"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedInvalidAuthority",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        },
-        {
-          "internalType": "uint32",
-          "name": "delay",
-          "type": "uint32"
-        }
-      ],
-      "name": "AccessManagedRequiredDelay",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "caller",
-          "type": "address"
-        }
-      ],
-      "name": "AccessManagedUnauthorized",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "InvalidParam",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrusted",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "NotTrustedOrGuardian",
-      "type": "error"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        }
-      ],
-      "name": "SafeERC20FailedOperation",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "SwapError",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAddress",
-      "type": "error"
-    },
-    {
-      "inputs": [],
-      "name": "ZeroAmount",
-      "type": "error"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "authority",
-          "type": "address"
-        }
-      ],
-      "name": "AuthorityUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "token",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "Recovered",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "SwapRouterUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "TokenTransferAddressUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        },
-        {
-          "indexed": false,
-          "internalType": "bool",
-          "name": "status",
-          "type": "bool"
-        }
-      ],
-      "name": "TrustedToggled",
-      "type": "event"
-    },
-    {
-      "inputs": [],
-      "name": "CALLBACK_SUCCESS",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "addBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "authority",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "budget",
-      "outputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "computeRebalanceAmount",
-      "outputs": [
-        {
-          "internalType": "uint8",
-          "name": "increase",
-          "type": "uint8"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "flashloan",
-      "outputs": [
-        {
-          "internalType": "contract IERC3156FlashLender",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "scale",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "extraData",
-          "type": "bytes"
-        }
-      ],
-      "name": "harvest",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "isConsumingScheduledOp",
-      "outputs": [
-        {
-          "internalType": "bytes4",
-          "name": "",
-          "type": "bytes4"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "isTrusted",
-      "outputs": [
-        {
-          "internalType": "bool",
-          "name": "",
-          "type": "bool"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "maxTokenSlippage",
-      "outputs": [
-        {
-          "internalType": "uint96",
-          "name": "",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "initiator",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "uint256",
-          "name": "fee",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes",
-          "name": "data",
-          "type": "bytes"
-        }
-      ],
-      "name": "onFlashLoan",
-      "outputs": [
-        {
-          "internalType": "bytes32",
-          "name": "",
-          "type": "bytes32"
-        }
-      ],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "parallelizer",
-      "outputs": [
-        {
-          "internalType": "contract IParallelizer",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "tokenAddress",
-          "type": "address"
-        },
-        {
-          "internalType": "uint256",
-          "name": "amountToRecover",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "to",
-          "type": "address"
-        }
-      ],
-      "name": "recoverERC20",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "amount",
-          "type": "uint256"
-        },
-        {
-          "internalType": "address",
-          "name": "receiver",
-          "type": "address"
-        }
-      ],
-      "name": "removeBudget",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newAuthority",
-          "type": "address"
-        }
-      ],
-      "name": "setAuthority",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint96",
-          "name": "newMaxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setMaxSlippage",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newSwapRouter",
-          "type": "address"
-        }
-      ],
-      "name": "setSwapRouter",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        }
-      ],
-      "name": "setTargetExposure",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newTokenTransferAddress",
-          "type": "address"
-        }
-      ],
-      "name": "setTokenTransferAddress",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        },
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "name": "setYieldBearingAssetData",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "swapRouter",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "trusted",
-          "type": "address"
-        }
-      ],
-      "name": "toggleTrusted",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenP",
-      "outputs": [
-        {
-          "internalType": "contract ITokenP",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "tokenTransferAddress",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "yieldBearingAsset",
-          "type": "address"
-        }
-      ],
-      "name": "updateLimitExposuresYieldAsset",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "name": "yieldBearingData",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "asset",
-          "type": "address"
-        },
-        {
-          "internalType": "uint64",
-          "name": "targetExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "maxExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "minExposure",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint64",
-          "name": "overrideExposures",
-          "type": "uint64"
-        },
-        {
-          "internalType": "uint96",
-          "name": "maxSlippage",
-          "type": "uint96"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    }
-  ],
-  "transactionHash": "0xdaef90c334810e232fb133c5ab664d331d2271b181c1476ac7cfec619b369e0d",
-  "receipt": {
-    "to": null,
-    "from": "0x66CcEC236bbcE5f1bBd1b2fC0a4014e57A55ad02",
-    "contractAddress": "0x120805265fA944834DC6e930De2995768806a9d2",
-    "transactionIndex": 1,
-    "gasUsed": "2489551",
-    "logsBloom": "0x20000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200010000000000000040000000000000000000000000000000000000000000010000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000010000008000000000000000008000000000000020000000000000000000000000000000000000000000000010000000000000000000000000000004000100000000000000000000000000000000000000020000010000000000000000008000000000008000000000000000000000000000000",
-    "blockHash": "0xfd87a8e9818d7d35faa73985bf5d5f49c50923521e5c64035ff6d8f29ca14273",
-    "transactionHash": "0xdaef90c334810e232fb133c5ab664d331d2271b181c1476ac7cfec619b369e0d",
-    "logs": [
-      {
-        "transactionIndex": 1,
-        "blockNumber": 35498524,
-        "transactionHash": "0xdaef90c334810e232fb133c5ab664d331d2271b181c1476ac7cfec619b369e0d",
-        "address": "0x120805265fA944834DC6e930De2995768806a9d2",
-        "topics": [
-          "0x2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad"
-        ],
-        "data": "0x0000000000000000000000008efb3ded78fbaef2a4efe01e01bbd911e4094b78",
-        "logIndex": 8,
-        "blockHash": "0xfd87a8e9818d7d35faa73985bf5d5f49c50923521e5c64035ff6d8f29ca14273"
-      },
-      {
-        "transactionIndex": 1,
-        "blockNumber": 35498524,
-        "transactionHash": "0xdaef90c334810e232fb133c5ab664d331d2271b181c1476ac7cfec619b369e0d",
-        "address": "0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182",
-        "topics": [
-          "0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
-          "0x000000000000000000000000120805265fa944834dc6e930de2995768806a9d2",
-          "0x0000000000000000000000002cb56df31b909854b01d4b1ead5676cf90e885e7"
-        ],
-        "data": "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
-        "logIndex": 9,
-        "blockHash": "0xfd87a8e9818d7d35faa73985bf5d5f49c50923521e5c64035ff6d8f29ca14273"
-      }
-    ],
-    "blockNumber": 35498524,
-    "cumulativeGasUsed": "2653746",
-    "status": 1,
-    "byzantium": true
-  },
-  "args": [
-    "0xaC041Df48dF9791B0654f1Dbbf2CC8450C5f2e9D",
-    "0xaC041Df48dF9791B0654f1Dbbf2CC8450C5f2e9D",
-    "0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182",
-    "0xBEFBAe2330186F031b469e26283aCc66bb5F8826",
-    "0x8eFb3DED78FbaEF2a4eFe01E01BBD911E4094b78",
-    "0x2cb56dF31b909854B01D4B1EAd5676cf90e885E7"
-  ],
-  "numDeployments": 1,
-  "solcInputHash": "9e6800737641b3b015331b65b5c620c3",
-  "metadata": "{\"compiler\":{\"version\":\"0.8.28+commit.7893614a\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initialTokenTransferAddress\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialSwapRouter\",\"type\":\"address\"},{\"internalType\":\"contract ITokenP\",\"name\":\"definitivetokenP\",\"type\":\"address\"},{\"internalType\":\"contract IParallelizer\",\"name\":\"definitiveParallelizer\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"initialAuthority\",\"type\":\"address\"},{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"definitiveFlashloan\",\"type\":\"address\"}],\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AccessManagedInvalidAuthority\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"},{\"internalType\":\"uint32\",\"name\":\"delay\",\"type\":\"uint32\"}],\"name\":\"AccessManagedRequiredDelay\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"caller\",\"type\":\"address\"}],\"name\":\"AccessManagedUnauthorized\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"InvalidParam\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrusted\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"NotTrustedOrGuardian\",\"type\":\"error\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"}],\"name\":\"SafeERC20FailedOperation\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"SwapError\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAddress\",\"type\":\"error\"},{\"inputs\":[],\"name\":\"ZeroAmount\",\"type\":\"error\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"authority\",\"type\":\"address\"}],\"name\":\"AuthorityUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"token\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"indexed\":false,\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"Recovered\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"SwapRouterUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"TokenTransferAddressUpdated\",\"type\":\"event\"},{\"anonymous\":false,\"inputs\":[{\"indexed\":false,\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"},{\"indexed\":false,\"internalType\":\"bool\",\"name\":\"status\",\"type\":\"bool\"}],\"name\":\"TrustedToggled\",\"type\":\"event\"},{\"inputs\":[],\"name\":\"CALLBACK_SUCCESS\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"addBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"authority\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"budget\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"computeRebalanceAmount\",\"outputs\":[{\"internalType\":\"uint8\",\"name\":\"increase\",\"type\":\"uint8\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"flashloan\",\"outputs\":[{\"internalType\":\"contract IERC3156FlashLender\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"scale\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"extraData\",\"type\":\"bytes\"}],\"name\":\"harvest\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"isConsumingScheduledOp\",\"outputs\":[{\"internalType\":\"bytes4\",\"name\":\"\",\"type\":\"bytes4\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"isTrusted\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"maxTokenSlippage\",\"outputs\":[{\"internalType\":\"uint96\",\"name\":\"\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"initiator\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"fee\",\"type\":\"uint256\"},{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"}],\"name\":\"onFlashLoan\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"\",\"type\":\"bytes32\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"parallelizer\",\"outputs\":[{\"internalType\":\"contract IParallelizer\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"tokenAddress\",\"type\":\"address\"},{\"internalType\":\"uint256\",\"name\":\"amountToRecover\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"to\",\"type\":\"address\"}],\"name\":\"recoverERC20\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"amount\",\"type\":\"uint256\"},{\"internalType\":\"address\",\"name\":\"receiver\",\"type\":\"address\"}],\"name\":\"removeBudget\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newAuthority\",\"type\":\"address\"}],\"name\":\"setAuthority\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint96\",\"name\":\"newMaxSlippage\",\"type\":\"uint96\"}],\"name\":\"setMaxSlippage\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newSwapRouter\",\"type\":\"address\"}],\"name\":\"setSwapRouter\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"}],\"name\":\"setTargetExposure\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"newTokenTransferAddress\",\"type\":\"address\"}],\"name\":\"setTokenTransferAddress\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"},{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"name\":\"setYieldBearingAssetData\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"swapRouter\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"trusted\",\"type\":\"address\"}],\"name\":\"toggleTrusted\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenP\",\"outputs\":[{\"internalType\":\"contract ITokenP\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"tokenTransferAddress\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"yieldBearingAsset\",\"type\":\"address\"}],\"name\":\"updateLimitExposuresYieldAsset\",\"outputs\":[],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"address\",\"name\":\"\",\"type\":\"address\"}],\"name\":\"yieldBearingData\",\"outputs\":[{\"internalType\":\"address\",\"name\":\"asset\",\"type\":\"address\"},{\"internalType\":\"uint64\",\"name\":\"targetExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"maxExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"minExposure\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"overrideExposures\",\"type\":\"uint64\"},{\"internalType\":\"uint96\",\"name\":\"maxSlippage\",\"type\":\"uint96\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"author\":\"Cooper Labs\",\"custom:contact\":\"security@cooperlabs.xyz\",\"details\":\"Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\",\"errors\":{\"SafeERC20FailedOperation(address)\":[{\"details\":\"An operation with an ERC-20 token failed.\"}]},\"events\":{\"AuthorityUpdated(address)\":{\"details\":\"Authority that manages this contract was updated.\"}},\"kind\":\"dev\",\"methods\":{\"addBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to add to the budget\",\"receiver\":\"address of the receiver\"}},\"authority()\":{\"details\":\"Returns the current authority.\"},\"computeRebalanceAmount(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"},\"returns\":{\"amount\":\"amount to be rebalanced\",\"increase\":\"whether the exposure should be increased\"}},\"harvest(address,uint256,bytes)\":{\"details\":\"This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage\"},\"isConsumingScheduledOp()\":{\"details\":\"Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls.\"},\"onFlashLoan(address,address,uint256,uint256,bytes)\":{\"details\":\"Receive a flash loan.\",\"params\":{\"amount\":\"The amount of tokens lent.\",\"data\":\"Arbitrary data structure, intended to contain user-defined parameters.\",\"fee\":\"The additional amount of tokens to repay.\",\"initiator\":\"The initiator of the loan.\",\"token\":\"The loan currency.\"},\"returns\":{\"_0\":\"The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\"}},\"recoverERC20(address,uint256,address)\":{\"params\":{\"amountToRecover\":\"amount to recover\",\"to\":\"address to send the recovered tokens\",\"tokenAddress\":\"address of the token to recover\"}},\"removeBudget(uint256,address)\":{\"params\":{\"amount\":\"amount of tokenP to remove from the budget\",\"receiver\":\"address of the receiver\"}},\"setAuthority(address)\":{\"details\":\"Transfers control to a new authority. The caller must be the current authority.\"},\"setMaxSlippage(address,uint96)\":{\"params\":{\"newMaxSlippage\":\"new max allowed slippage\"}},\"setSwapRouter(address)\":{\"params\":{\"newSwapRouter\":\"address of the swap router\"}},\"setTargetExposure(address,uint64)\":{\"params\":{\"targetExposure\":\"target exposure to the yield bearing asset used\",\"yieldBearingAsset\":\"address of the yield bearing asset\"}},\"setTokenTransferAddress(address)\":{\"params\":{\"newTokenTransferAddress\":\"address of the token transfer contract\"}},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"params\":{\"asset\":\"address of the asset\",\"maxExposure\":\"maximum exposure within the Parallelizer to the asset\",\"minExposure\":\"minimum exposure within the Parallelizer to the asset\",\"overrideExposures\":\"whether limit exposures should be overriden or read onchain through the Parallelizer\",\"targetExposure\":\"target exposure to the yieldBearingAsset asset used\",\"yieldBearingAsset\":\"address of the yieldBearingAsset\"}},\"toggleTrusted(address)\":{\"params\":{\"trusted\":\"address to toggle the trusted status\"}},\"updateLimitExposuresYieldAsset(address)\":{\"params\":{\"yieldBearingAsset\":\"address of the yield bearing asset\"}}},\"title\":\"GenericHarvester\",\"version\":1},\"userdoc\":{\"events\":{\"SwapRouterUpdated(address)\":{\"notice\":\"Event emitted when the swap router is updated\"},\"TokenTransferAddressUpdated(address)\":{\"notice\":\"Event emitted when the token proxy is updated\"}},\"kind\":\"user\",\"methods\":{\"addBudget(uint256,address)\":{\"notice\":\"Add budget to be spent by the receiver during the flashloan\"},\"budget(address)\":{\"notice\":\"Budget of tokenP available for each users\"},\"computeRebalanceAmount(address)\":{\"notice\":\"Compute the amount needed to rebalance the Parallelizer\"},\"flashloan()\":{\"notice\":\"Parallel stablecoin flashloan contract\"},\"harvest(address,uint256,bytes)\":{\"notice\":\"Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset\"},\"isTrusted(address)\":{\"notice\":\"trusted addresses that can update target exposure and do others non critical operations\"},\"maxTokenSlippage(address)\":{\"notice\":\"Max slippage when dealing with the Parallelizer\"},\"parallelizer()\":{\"notice\":\"Reference to the `parallelizer` implementation this contract aims at rebalancing\"},\"recoverERC20(address,uint256,address)\":{\"notice\":\"Recover ERC20 tokens\"},\"removeBudget(uint256,address)\":{\"notice\":\"Remove budget from the owner and send it to the receiver\"},\"setMaxSlippage(address,uint96)\":{\"notice\":\"Set the max allowed slippage\"},\"setSwapRouter(address)\":{\"notice\":\"Set the swap router\"},\"setTargetExposure(address,uint64)\":{\"notice\":\"Set the target exposure of a yield bearing asset\"},\"setTokenTransferAddress(address)\":{\"notice\":\"Set the token transfer address\"},\"setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)\":{\"notice\":\"Set the yieldBearingAsset data\"},\"swapRouter()\":{\"notice\":\"address of the router/aggregator\"},\"toggleTrusted(address)\":{\"notice\":\"Toggle the trusted status of an address\"},\"tokenP()\":{\"notice\":\"TokenP handled by the `parallelizer` of interest\"},\"tokenTransferAddress()\":{\"notice\":\"address to approve to transfer tokens to\"},\"updateLimitExposuresYieldAsset(address)\":{\"notice\":\"Set the limit exposures to the asset linked to the yield bearing asset\"},\"yieldBearingData(address)\":{\"notice\":\"Data associated to a yield bearing asset\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"contracts/helpers/GenericHarvester.sol\":\"GenericHarvester\"},\"evmVersion\":\"cancun\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\",\"useLiteralContent\":true},\"optimizer\":{\"enabled\":true,\"runs\":1000},\"remappings\":[],\"viaIR\":true},\"sources\":{\"@helpers/RouterSwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20, IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\n\\n/// @title Swapper\\n/// @author Angle Labs, Inc.\\n/// @dev Abstract contract for swapping tokens using a router/aggregator\\n/// @dev This contract is an authorized fork of Angle's `RouterSwapper` contract\\n/// https://github.com/AngleProtocol/utils/blob/main/src/RouterSwapper.sol\\nabstract contract RouterSwapper {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               ERRORS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  error SwapError();\\n  error ZeroAddress();\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                EVENTS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   *  @notice Event emitted when the swap router is updated\\n   */\\n  event SwapRouterUpdated(address newSwapRouter);\\n  /**\\n   *  @notice Event emitted when the token proxy is updated\\n   */\\n  event TokenTransferAddressUpdated(address newTokenTransferAddress);\\n\\n  /*//////////////////////////////////////////////////////////////\\n                                MODIFIERS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  modifier noZeroAddress(address targetAddress) {\\n    if (targetAddress == address(0)) {\\n      revert ZeroAddress();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                            MUTABLE VARIABLES\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice address of the router/aggregator\\n   */\\n  address public swapRouter;\\n  /**\\n   * @notice address to approve to transfer tokens to\\n   */\\n  address public tokenTransferAddress;\\n\\n  /*//////////////////////////////////////////////////////////////\\n                               CONSTRUCTOR\\n    //////////////////////////////////////////////////////////////*/\\n\\n  constructor(address initialSwapRouter, address initialTokenTransferAddress) {\\n    swapRouter = initialSwapRouter;\\n    tokenTransferAddress = initialTokenTransferAddress;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             ADMIN FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the router/aggregator address\\n   * @param newSwapRouter address of the new router/aggregator\\n   */\\n  function setSwapRouter(address newSwapRouter) public virtual noZeroAddress(newSwapRouter) {\\n    swapRouter = newSwapRouter;\\n\\n    emit SwapRouterUpdated(newSwapRouter);\\n  }\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the new token transfer address\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress)\\n    public\\n    virtual\\n    noZeroAddress(newTokenTransferAddress)\\n  {\\n    tokenTransferAddress = newTokenTransferAddress;\\n\\n    emit TokenTransferAddressUpdated(newTokenTransferAddress);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////\\n                             SWAP FUNCTIONS\\n    //////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Approve the router/aggregator to spend the token if needed\\n   * @param token address of the token to approve\\n   * @param spender address of the router/aggregator\\n   * @param amount amount to approve\\n   */\\n  function _approveTokenIfNeeded(address token, address spender, uint256 amount) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), spender);\\n    if (allowance < amount) {\\n      IERC20(token).safeIncreaseAllowance(spender, amount - allowance);\\n    }\\n  }\\n\\n  /**\\n   * @notice Perform the swap using the router/aggregator\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _performRouterSwap(bytes memory callData) internal {\\n    (bool success, bytes memory retData) = swapRouter.call(callData);\\n\\n    if (!success) {\\n      if (retData.length != 0) {\\n        assembly (\\\"memory-safe\\\") {\\n          revert(add(32, retData), mload(retData))\\n        }\\n      }\\n      revert SwapError();\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swapCalldata(address[] calldata tokens, bytes[] calldata callDatas, uint256[] calldata amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap tokens using the router/aggregator\\n   * @param tokens array of tokens to swap\\n   * @param callDatas array of bytes to call the router/aggregator\\n   * @param amounts array of amounts to swap\\n   */\\n  function _swap(address[] memory tokens, bytes[] memory callDatas, uint256[] memory amounts) internal {\\n    uint256 length = tokens.length;\\n    for (uint256 i; i < length; ++i) {\\n      _approveTokenIfNeeded(tokens[i], tokenTransferAddress, amounts[i]);\\n      _performRouterSwap(callDatas[i]);\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x8c5a6b026a95816806814ef681b6b225ea4c405a39a4eab0111921853202829c\",\"license\":\"GPL-3.0\"},\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/AuthorityUtils.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IAuthority} from \\\"./IAuthority.sol\\\";\\n\\nlibrary AuthorityUtils {\\n    /**\\n     * @dev Since `AccessManager` implements an extended IAuthority interface, invoking `canCall` with backwards compatibility\\n     * for the preexisting `IAuthority` interface requires special care to avoid reverting on insufficient return data.\\n     * This helper function takes care of invoking `canCall` in a backwards compatible way without reverting.\\n     */\\n    function canCallWithDelay(\\n        address authority,\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) internal view returns (bool immediate, uint32 delay) {\\n        (bool success, bytes memory data) = authority.staticcall(\\n            abi.encodeCall(IAuthority.canCall, (caller, target, selector))\\n        );\\n        if (success) {\\n            if (data.length >= 0x40) {\\n                (immediate, delay) = abi.decode(data, (bool, uint32));\\n            } else if (data.length >= 0x20) {\\n                immediate = abi.decode(data, (bool));\\n            }\\n        }\\n        return (immediate, delay);\\n    }\\n}\\n\",\"keccak256\":\"0xb3875997b0d8705e29aa20fee88e1dfef93df438794ae1ad8ba2eb016a4dd4e4\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAccessManaged.sol)\\n\\npragma solidity ^0.8.20;\\n\\ninterface IAccessManaged {\\n    /**\\n     * @dev Authority that manages this contract was updated.\\n     */\\n    event AuthorityUpdated(address authority);\\n\\n    error AccessManagedUnauthorized(address caller);\\n    error AccessManagedRequiredDelay(address caller, uint32 delay);\\n    error AccessManagedInvalidAuthority(address authority);\\n\\n    /**\\n     * @dev Returns the current authority.\\n     */\\n    function authority() external view returns (address);\\n\\n    /**\\n     * @dev Transfers control to a new authority. The caller must be the current authority.\\n     */\\n    function setAuthority(address) external;\\n\\n    /**\\n     * @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n     * being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n     * attacker controlled calls.\\n     */\\n    function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaba93d42cd70e1418782951132d97b31ddce5f50ad81090884b6d0e41caac9d6\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAccessManager.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (access/manager/IAccessManager.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Time} from \\\"../../utils/types/Time.sol\\\";\\n\\ninterface IAccessManager {\\n    /**\\n     * @dev A delayed operation was scheduled.\\n     */\\n    event OperationScheduled(\\n        bytes32 indexed operationId,\\n        uint32 indexed nonce,\\n        uint48 schedule,\\n        address caller,\\n        address target,\\n        bytes data\\n    );\\n\\n    /**\\n     * @dev A scheduled operation was executed.\\n     */\\n    event OperationExecuted(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev A scheduled operation was canceled.\\n     */\\n    event OperationCanceled(bytes32 indexed operationId, uint32 indexed nonce);\\n\\n    /**\\n     * @dev Informational labelling for a roleId.\\n     */\\n    event RoleLabel(uint64 indexed roleId, string label);\\n\\n    /**\\n     * @dev Emitted when `account` is granted `roleId`.\\n     *\\n     * NOTE: The meaning of the `since` argument depends on the `newMember` argument.\\n     * If the role is granted to a new member, the `since` argument indicates when the account becomes a member of the role,\\n     * otherwise it indicates the execution delay for this account and roleId is updated.\\n     */\\n    event RoleGranted(uint64 indexed roleId, address indexed account, uint32 delay, uint48 since, bool newMember);\\n\\n    /**\\n     * @dev Emitted when `account` membership or `roleId` is revoked. Unlike granting, revoking is instantaneous.\\n     */\\n    event RoleRevoked(uint64 indexed roleId, address indexed account);\\n\\n    /**\\n     * @dev Role acting as admin over a given `roleId` is updated.\\n     */\\n    event RoleAdminChanged(uint64 indexed roleId, uint64 indexed admin);\\n\\n    /**\\n     * @dev Role acting as guardian over a given `roleId` is updated.\\n     */\\n    event RoleGuardianChanged(uint64 indexed roleId, uint64 indexed guardian);\\n\\n    /**\\n     * @dev Grant delay for a given `roleId` will be updated to `delay` when `since` is reached.\\n     */\\n    event RoleGrantDelayChanged(uint64 indexed roleId, uint32 delay, uint48 since);\\n\\n    /**\\n     * @dev Target mode is updated (true = closed, false = open).\\n     */\\n    event TargetClosed(address indexed target, bool closed);\\n\\n    /**\\n     * @dev Role required to invoke `selector` on `target` is updated to `roleId`.\\n     */\\n    event TargetFunctionRoleUpdated(address indexed target, bytes4 selector, uint64 indexed roleId);\\n\\n    /**\\n     * @dev Admin delay for a given `target` will be updated to `delay` when `since` is reached.\\n     */\\n    event TargetAdminDelayUpdated(address indexed target, uint32 delay, uint48 since);\\n\\n    error AccessManagerAlreadyScheduled(bytes32 operationId);\\n    error AccessManagerNotScheduled(bytes32 operationId);\\n    error AccessManagerNotReady(bytes32 operationId);\\n    error AccessManagerExpired(bytes32 operationId);\\n    error AccessManagerLockedRole(uint64 roleId);\\n    error AccessManagerBadConfirmation();\\n    error AccessManagerUnauthorizedAccount(address msgsender, uint64 roleId);\\n    error AccessManagerUnauthorizedCall(address caller, address target, bytes4 selector);\\n    error AccessManagerUnauthorizedConsume(address target);\\n    error AccessManagerUnauthorizedCancel(address msgsender, address caller, address target, bytes4 selector);\\n    error AccessManagerInvalidInitialAdmin(address initialAdmin);\\n\\n    /**\\n     * @dev Check if an address (`caller`) is authorised to call a given function on a given contract directly (with\\n     * no restriction). Additionally, it returns the delay needed to perform the call indirectly through the {schedule}\\n     * & {execute} workflow.\\n     *\\n     * This function is usually called by the targeted contract to control immediate execution of restricted functions.\\n     * Therefore we only return true if the call can be performed without any delay. If the call is subject to a\\n     * previously set delay (not zero), then the function should return false and the caller should schedule the operation\\n     * for future execution.\\n     *\\n     * If `immediate` is true, the delay can be disregarded and the operation can be immediately executed, otherwise\\n     * the operation can be executed if and only if delay is greater than 0.\\n     *\\n     * NOTE: The IAuthority interface does not include the `uint32` delay. This is an extension of that interface that\\n     * is backward compatible. Some contracts may thus ignore the second return argument. In that case they will fail\\n     * to identify the indirect workflow, and will consider calls that require a delay to be forbidden.\\n     *\\n     * NOTE: This function does not report the permissions of the admin functions in the manager itself. These are defined by the\\n     * {AccessManager} documentation.\\n     */\\n    function canCall(\\n        address caller,\\n        address target,\\n        bytes4 selector\\n    ) external view returns (bool allowed, uint32 delay);\\n\\n    /**\\n     * @dev Expiration delay for scheduled proposals. Defaults to 1 week.\\n     *\\n     * IMPORTANT: Avoid overriding the expiration with 0. Otherwise every contract proposal will be expired immediately,\\n     * disabling any scheduling usage.\\n     */\\n    function expiration() external view returns (uint32);\\n\\n    /**\\n     * @dev Minimum setback for all delay updates, with the exception of execution delays. It\\n     * can be increased without setback (and reset via {revokeRole} in the case event of an\\n     * accidental increase). Defaults to 5 days.\\n     */\\n    function minSetback() external view returns (uint32);\\n\\n    /**\\n     * @dev Get whether the contract is closed disabling any access. Otherwise role permissions are applied.\\n     *\\n     * NOTE: When the manager itself is closed, admin functions are still accessible to avoid locking the contract.\\n     */\\n    function isTargetClosed(address target) external view returns (bool);\\n\\n    /**\\n     * @dev Get the role required to call a function.\\n     */\\n    function getTargetFunctionRole(address target, bytes4 selector) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the admin delay for a target contract. Changes to contract configuration are subject to this delay.\\n     */\\n    function getTargetAdminDelay(address target) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the id of the role that acts as an admin for the given role.\\n     *\\n     * The admin permission is required to grant the role, revoke the role and update the execution delay to execute\\n     * an operation that is restricted to this role.\\n     */\\n    function getRoleAdmin(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role that acts as a guardian for a given role.\\n     *\\n     * The guardian permission allows canceling operations that have been scheduled under the role.\\n     */\\n    function getRoleGuardian(uint64 roleId) external view returns (uint64);\\n\\n    /**\\n     * @dev Get the role current grant delay.\\n     *\\n     * Its value may change at any point without an event emitted following a call to {setGrantDelay}.\\n     * Changes to this value, including effect timepoint are notified in advance by the {RoleGrantDelayChanged} event.\\n     */\\n    function getRoleGrantDelay(uint64 roleId) external view returns (uint32);\\n\\n    /**\\n     * @dev Get the access details for a given account for a given role. These details include the timepoint at which\\n     * membership becomes active, and the delay applied to all operation by this user that requires this permission\\n     * level.\\n     *\\n     * Returns:\\n     * [0] Timestamp at which the account membership becomes valid. 0 means role is not granted.\\n     * [1] Current execution delay for the account.\\n     * [2] Pending execution delay for the account.\\n     * [3] Timestamp at which the pending execution delay will become active. 0 means no delay update is scheduled.\\n     */\\n    function getAccess(\\n        uint64 roleId,\\n        address account\\n    ) external view returns (uint48 since, uint32 currentDelay, uint32 pendingDelay, uint48 effect);\\n\\n    /**\\n     * @dev Check if a given account currently has the permission level corresponding to a given role. Note that this\\n     * permission might be associated with an execution delay. {getAccess} can provide more details.\\n     */\\n    function hasRole(uint64 roleId, address account) external view returns (bool isMember, uint32 executionDelay);\\n\\n    /**\\n     * @dev Give a label to a role, for improved role discoverability by UIs.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleLabel} event.\\n     */\\n    function labelRole(uint64 roleId, string calldata label) external;\\n\\n    /**\\n     * @dev Add `account` to `roleId`, or change its execution delay.\\n     *\\n     * This gives the account the authorization to call any function that is restricted to this role. An optional\\n     * execution delay (in seconds) can be set. If that delay is non 0, the user is required to schedule any operation\\n     * that is restricted to members of this role. The user will only be able to execute the operation after the delay has\\n     * passed, before it has expired. During this period, admin and guardians can cancel the operation (see {cancel}).\\n     *\\n     * If the account has already been granted this role, the execution delay will be updated. This update is not\\n     * immediate and follows the delay rules. For example, if a user currently has a delay of 3 hours, and this is\\n     * called to reduce that delay to 1 hour, the new delay will take some time to take effect, enforcing that any\\n     * operation executed in the 3 hours that follows this update was indeed scheduled before this update.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - granted role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleGranted} event.\\n     */\\n    function grantRole(uint64 roleId, address account, uint32 executionDelay) external;\\n\\n    /**\\n     * @dev Remove an account from a role, with immediate effect. If the account does not have the role, this call has\\n     * no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be an admin for the role (see {getRoleAdmin})\\n     * - revoked role must not be the `PUBLIC_ROLE`\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function revokeRole(uint64 roleId, address account) external;\\n\\n    /**\\n     * @dev Renounce role permissions for the calling account with immediate effect. If the sender is not in\\n     * the role this call has no effect.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be `callerConfirmation`.\\n     *\\n     * Emits a {RoleRevoked} event if the account had the role.\\n     */\\n    function renounceRole(uint64 roleId, address callerConfirmation) external;\\n\\n    /**\\n     * @dev Change admin role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleAdminChanged} event\\n     */\\n    function setRoleAdmin(uint64 roleId, uint64 admin) external;\\n\\n    /**\\n     * @dev Change guardian role for a given role.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGuardianChanged} event\\n     */\\n    function setRoleGuardian(uint64 roleId, uint64 guardian) external;\\n\\n    /**\\n     * @dev Update the delay for granting a `roleId`.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {RoleGrantDelayChanged} event.\\n     */\\n    function setGrantDelay(uint64 roleId, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the role required to call functions identified by the `selectors` in the `target` contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetFunctionRoleUpdated} event per selector.\\n     */\\n    function setTargetFunctionRole(address target, bytes4[] calldata selectors, uint64 roleId) external;\\n\\n    /**\\n     * @dev Set the delay for changing the configuration of a given target contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetAdminDelayUpdated} event.\\n     */\\n    function setTargetAdminDelay(address target, uint32 newDelay) external;\\n\\n    /**\\n     * @dev Set the closed flag for a contract.\\n     *\\n     * Closing the manager itself won't disable access to admin methods to avoid locking the contract.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     *\\n     * Emits a {TargetClosed} event.\\n     */\\n    function setTargetClosed(address target, bool closed) external;\\n\\n    /**\\n     * @dev Return the timepoint at which a scheduled operation will be ready for execution. This returns 0 if the\\n     * operation is not yet scheduled, has expired, was executed, or was canceled.\\n     */\\n    function getSchedule(bytes32 id) external view returns (uint48);\\n\\n    /**\\n     * @dev Return the nonce for the latest scheduled operation with a given id. Returns 0 if the operation has never\\n     * been scheduled.\\n     */\\n    function getNonce(bytes32 id) external view returns (uint32);\\n\\n    /**\\n     * @dev Schedule a delayed operation for future execution, and return the operation identifier. It is possible to\\n     * choose the timestamp at which the operation becomes executable as long as it satisfies the execution delays\\n     * required for the caller. The special value zero will automatically set the earliest possible time.\\n     *\\n     * Returns the `operationId` that was scheduled. Since this value is a hash of the parameters, it can reoccur when\\n     * the same parameters are used; if this is relevant, the returned `nonce` can be used to uniquely identify this\\n     * scheduled operation from other occurrences of the same `operationId` in invocations of {execute} and {cancel}.\\n     *\\n     * Emits a {OperationScheduled} event.\\n     *\\n     * NOTE: It is not possible to concurrently schedule more than one operation with the same `target` and `data`. If\\n     * this is necessary, a random byte can be appended to `data` to act as a salt that will be ignored by the target\\n     * contract if it is using standard Solidity ABI encoding.\\n     */\\n    function schedule(\\n        address target,\\n        bytes calldata data,\\n        uint48 when\\n    ) external returns (bytes32 operationId, uint32 nonce);\\n\\n    /**\\n     * @dev Execute a function that is delay restricted, provided it was properly scheduled beforehand, or the\\n     * execution delay is 0.\\n     *\\n     * Returns the nonce that identifies the previously scheduled operation that is executed, or 0 if the\\n     * operation wasn't previously scheduled (if the caller doesn't have an execution delay).\\n     *\\n     * Emits an {OperationExecuted} event only if the call was scheduled and delayed.\\n     */\\n    function execute(address target, bytes calldata data) external payable returns (uint32);\\n\\n    /**\\n     * @dev Cancel a scheduled (delayed) operation. Returns the nonce that identifies the previously scheduled\\n     * operation that is cancelled.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be the proposer, a guardian of the targeted function, or a global admin\\n     *\\n     * Emits a {OperationCanceled} event.\\n     */\\n    function cancel(address caller, address target, bytes calldata data) external returns (uint32);\\n\\n    /**\\n     * @dev Consume a scheduled operation targeting the caller. If such an operation exists, mark it as consumed\\n     * (emit an {OperationExecuted} event and clean the state). Otherwise, throw an error.\\n     *\\n     * This is useful for contract that want to enforce that calls targeting them were scheduled on the manager,\\n     * with all the verifications that it implies.\\n     *\\n     * Emit a {OperationExecuted} event.\\n     */\\n    function consumeScheduledOp(address caller, bytes calldata data) external;\\n\\n    /**\\n     * @dev Hashing function for delayed operations.\\n     */\\n    function hashOperation(address caller, address target, bytes calldata data) external view returns (bytes32);\\n\\n    /**\\n     * @dev Changes the authority of a target managed by this manager instance.\\n     *\\n     * Requirements:\\n     *\\n     * - the caller must be a global admin\\n     */\\n    function updateAuthority(address target, address newAuthority) external;\\n}\\n\",\"keccak256\":\"0x9be2d08a326515805bc9cf6315b7953f8d1ebe88abf48c2d645fb1fa8211a0e2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/access/manager/IAuthority.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (access/manager/IAuthority.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Standard interface for permissioning originally defined in Dappsys.\\n */\\ninterface IAuthority {\\n    /**\\n     * @dev Returns true if the caller can invoke on a target the function identified by a function selector.\\n     */\\n    function canCall(address caller, address target, bytes4 selector) external view returns (bool allowed);\\n}\\n\",\"keccak256\":\"0x4cc0766bd7fb7b3bafb70afa2a93b6e313a0baec7a35ad1b57505be7861c1030\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC1363.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC1363.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"./IERC20.sol\\\";\\nimport {IERC165} from \\\"./IERC165.sol\\\";\\n\\n/**\\n * @title IERC1363\\n * @dev Interface of the ERC-1363 standard as defined in the https://eips.ethereum.org/EIPS/eip-1363[ERC-1363].\\n *\\n * Defines an extension interface for ERC-20 tokens that supports executing code on a recipient contract\\n * after `transfer` or `transferFrom`, or code on a spender contract after `approve`, in a single transaction.\\n */\\ninterface IERC1363 is IERC20, IERC165 {\\n    /*\\n     * Note: the ERC-165 identifier for this interface is 0xb0202a11.\\n     * 0xb0202a11 ===\\n     *   bytes4(keccak256('transferAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^\\n     *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256)')) ^\\n     *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))\\n     */\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from the caller's account to `to`\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the allowance mechanism\\n     * and then calls {IERC1363Receiver-onTransferReceived} on `to`.\\n     * @param from The address which you want to send tokens from.\\n     * @param to The address which you want to transfer to.\\n     * @param value The amount of tokens to be transferred.\\n     * @param data Additional data with no specified format, sent in call to `to`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value) external returns (bool);\\n\\n    /**\\n     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the\\n     * caller's tokens and then calls {IERC1363Spender-onApprovalReceived} on `spender`.\\n     * @param spender The address which will spend the funds.\\n     * @param value The amount of tokens to be spent.\\n     * @param data Additional data with no specified format, sent in call to `spender`.\\n     * @return A boolean value indicating whether the operation succeeded unless throwing.\\n     */\\n    function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);\\n}\\n\",\"keccak256\":\"0x9b6b3e7803bc5f2f8cd7ad57db8ac1def61a9930a5a3107df4882e028a9605d7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC165} from \\\"../utils/introspection/IERC165.sol\\\";\\n\",\"keccak256\":\"0xde7e9fd9aee8d4f40772f96bb3b58836cbc6dfc0227014a061947f8821ea9724\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../token/ERC20/IERC20.sol\\\";\\n\",\"keccak256\":\"0xce41876e78d1badc0512229b4d14e4daf83bc1003d7f83978d18e0e56f965b9c\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashBorrower.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashBorrower, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashBorrower {\\n    /**\\n     * @dev Receive a flash loan.\\n     * @param initiator The initiator of the loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param fee The additional amount of tokens to repay.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     * @return The keccak256 hash of \\\"ERC3156FlashBorrower.onFlashLoan\\\"\\n     */\\n    function onFlashLoan(\\n        address initiator,\\n        address token,\\n        uint256 amount,\\n        uint256 fee,\\n        bytes calldata data\\n    ) external returns (bytes32);\\n}\\n\",\"keccak256\":\"0x0b1459615b9b47c2a4eec8e72f23ccc601f1d711f679a1c06b3390459021a341\",\"license\":\"MIT\"},\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC3156FlashLender.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC3156FlashBorrower} from \\\"./IERC3156FlashBorrower.sol\\\";\\n\\n/**\\n * @dev Interface of the ERC-3156 FlashLender, as defined in\\n * https://eips.ethereum.org/EIPS/eip-3156[ERC-3156].\\n */\\ninterface IERC3156FlashLender {\\n    /**\\n     * @dev The amount of currency available to be lended.\\n     * @param token The loan currency.\\n     * @return The amount of `token` that can be borrowed.\\n     */\\n    function maxFlashLoan(address token) external view returns (uint256);\\n\\n    /**\\n     * @dev The fee to be charged for a given loan.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @return The amount of `token` to be charged for the loan, on top of the returned principal.\\n     */\\n    function flashFee(address token, uint256 amount) external view returns (uint256);\\n\\n    /**\\n     * @dev Initiate a flash loan.\\n     * @param receiver The receiver of the tokens in the loan, and the receiver of the callback.\\n     * @param token The loan currency.\\n     * @param amount The amount of tokens lent.\\n     * @param data Arbitrary data structure, intended to contain user-defined parameters.\\n     */\\n    function flashLoan(\\n        IERC3156FlashBorrower receiver,\\n        address token,\\n        uint256 amount,\\n        bytes calldata data\\n    ) external returns (bool);\\n}\\n\",\"keccak256\":\"0x5d19ea24c555cf6a5dbafea9fac57887cc3e72154f3ee8e0a2bf67971811c14b\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/IERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-20 standard as defined in the ERC.\\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 value of tokens in existence.\\n     */\\n    function totalSupply() external view returns (uint256);\\n\\n    /**\\n     * @dev Returns the value of tokens owned by `account`.\\n     */\\n    function balanceOf(address account) external view returns (uint256);\\n\\n    /**\\n     * @dev Moves a `value` amount of 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 value) 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 a `value` amount of tokens as the allowance of `spender` over the\\n     * 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 value) external returns (bool);\\n\\n    /**\\n     * @dev Moves a `value` amount of tokens from `from` to `to` using the\\n     * allowance mechanism. `value` 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 value) external returns (bool);\\n}\\n\",\"keccak256\":\"0xe06a3f08a987af6ad2e1c1e774405d4fe08f1694b67517438b467cecf0da0ef7\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/extensions/IERC20Metadata.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\n\\n/**\\n * @dev Interface for the optional metadata functions from the ERC-20 standard.\\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\",\"keccak256\":\"0x70f2f713b13b7ce4610bcd0ac9fec0f3cc43693b043abcb8dc40a42a726eb330\",\"license\":\"MIT\"},\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.2.0) (token/ERC20/utils/SafeERC20.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {IERC20} from \\\"../IERC20.sol\\\";\\nimport {IERC1363} from \\\"../../../interfaces/IERC1363.sol\\\";\\n\\n/**\\n * @title SafeERC20\\n * @dev Wrappers around ERC-20 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    /**\\n     * @dev An operation with an ERC-20 token failed.\\n     */\\n    error SafeERC20FailedOperation(address token);\\n\\n    /**\\n     * @dev Indicates a failed `decreaseAllowance` request.\\n     */\\n    error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease);\\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.encodeCall(token.transfer, (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.encodeCall(token.transferFrom, (from, to, 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     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {\\n        uint256 oldAllowance = token.allowance(address(this), spender);\\n        forceApprove(token, spender, oldAllowance + value);\\n    }\\n\\n    /**\\n     * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no\\n     * value, non-reverting calls are assumed to be successful.\\n     *\\n     * IMPORTANT: If the token implements ERC-7674 (ERC-20 with temporary allowance), and if the \\\"client\\\"\\n     * smart contract uses ERC-7674 to set temporary allowances, then the \\\"client\\\" smart contract should avoid using\\n     * this function. Performing a {safeIncreaseAllowance} or {safeDecreaseAllowance} operation on a token contract\\n     * that has a non-zero temporary allowance (for that particular owner-spender) will result in unexpected behavior.\\n     */\\n    function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal {\\n        unchecked {\\n            uint256 currentAllowance = token.allowance(address(this), spender);\\n            if (currentAllowance < requestedDecrease) {\\n                revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease);\\n            }\\n            forceApprove(token, spender, currentAllowance - requestedDecrease);\\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     * NOTE: If the token implements ERC-7674, this function will not modify any temporary allowance. This function\\n     * only sets the \\\"standard\\\" allowance. Any temporary allowance will remain active, in addition to the value being\\n     * set here.\\n     */\\n    function forceApprove(IERC20 token, address spender, uint256 value) internal {\\n        bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value));\\n\\n        if (!_callOptionalReturnBool(token, approvalCall)) {\\n            _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0)));\\n            _callOptionalReturn(token, approvalCall);\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferAndCall, with a fallback to the simple {ERC20} transfer if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            safeTransfer(token, to, value);\\n        } else if (!token.transferAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} transferFromAndCall, with a fallback to the simple {ERC20} transferFrom if the target\\n     * has no code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function transferFromAndCallRelaxed(\\n        IERC1363 token,\\n        address from,\\n        address to,\\n        uint256 value,\\n        bytes memory data\\n    ) internal {\\n        if (to.code.length == 0) {\\n            safeTransferFrom(token, from, to, value);\\n        } else if (!token.transferFromAndCall(from, to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Performs an {ERC1363} approveAndCall, with a fallback to the simple {ERC20} approve if the target has no\\n     * code. This can be used to implement an {ERC721}-like safe transfer that rely on {ERC1363} checks when\\n     * targeting contracts.\\n     *\\n     * NOTE: When the recipient address (`to`) has no code (i.e. is an EOA), this function behaves as {forceApprove}.\\n     * Opposedly, when the recipient address (`to`) has code, this function only attempts to call {ERC1363-approveAndCall}\\n     * once without retrying, and relies on the returned value to be true.\\n     *\\n     * Reverts if the returned value is other than `true`.\\n     */\\n    function approveAndCallRelaxed(IERC1363 token, address to, uint256 value, bytes memory data) internal {\\n        if (to.code.length == 0) {\\n            forceApprove(token, to, value);\\n        } else if (!token.approveAndCall(to, value, data)) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturnBool} that reverts if call fails to meet the requirements.\\n     */\\n    function _callOptionalReturn(IERC20 token, bytes memory data) private {\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            let success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            // bubble errors\\n            if iszero(success) {\\n                let ptr := mload(0x40)\\n                returndatacopy(ptr, 0, returndatasize())\\n                revert(ptr, returndatasize())\\n            }\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n\\n        if (returnSize == 0 ? address(token).code.length == 0 : returnValue != 1) {\\n            revert SafeERC20FailedOperation(address(token));\\n        }\\n    }\\n\\n    /**\\n     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement\\n     * on the return value: the return value is optional (but if data is returned, it must not be false).\\n     * @param token The token targeted by the call.\\n     * @param data The call data (encoded using abi.encode or one of its variants).\\n     *\\n     * This is a variant of {_callOptionalReturn} that silently catches all reverts and returns a bool instead.\\n     */\\n    function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {\\n        bool success;\\n        uint256 returnSize;\\n        uint256 returnValue;\\n        assembly (\\\"memory-safe\\\") {\\n            success := call(gas(), token, 0, add(data, 0x20), mload(data), 0, 0x20)\\n            returnSize := returndatasize()\\n            returnValue := mload(0)\\n        }\\n        return success && (returnSize == 0 ? address(token).code.length > 0 : returnValue == 1);\\n    }\\n}\\n\",\"keccak256\":\"0x4ea01544758fd2c7045961904686bfe232d2220a04ecaa2d6b08dac17827febf\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Context.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)\\n\\npragma solidity ^0.8.20;\\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\",\"keccak256\":\"0x493033a8d1b176a037b2cc6a04dad01a5c157722049bbecf632ca876224dd4b2\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/Panic.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Helper library for emitting standardized panic codes.\\n *\\n * ```solidity\\n * contract Example {\\n *      using Panic for uint256;\\n *\\n *      // Use any of the declared internal constants\\n *      function foo() { Panic.GENERIC.panic(); }\\n *\\n *      // Alternatively\\n *      function foo() { Panic.panic(Panic.GENERIC); }\\n * }\\n * ```\\n *\\n * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].\\n *\\n * _Available since v5.1._\\n */\\n// slither-disable-next-line unused-state\\nlibrary Panic {\\n    /// @dev generic / unspecified error\\n    uint256 internal constant GENERIC = 0x00;\\n    /// @dev used by the assert() builtin\\n    uint256 internal constant ASSERT = 0x01;\\n    /// @dev arithmetic underflow or overflow\\n    uint256 internal constant UNDER_OVERFLOW = 0x11;\\n    /// @dev division or modulo by zero\\n    uint256 internal constant DIVISION_BY_ZERO = 0x12;\\n    /// @dev enum conversion error\\n    uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;\\n    /// @dev invalid encoding in storage\\n    uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;\\n    /// @dev empty array pop\\n    uint256 internal constant EMPTY_ARRAY_POP = 0x31;\\n    /// @dev array out of bounds access\\n    uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;\\n    /// @dev resource error (too large allocation or too large array)\\n    uint256 internal constant RESOURCE_ERROR = 0x41;\\n    /// @dev calling invalid internal function\\n    uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;\\n\\n    /// @dev Reverts with a panic code. Recommended to use with\\n    /// the internal constants with predefined codes.\\n    function panic(uint256 code) internal pure {\\n        assembly (\\\"memory-safe\\\") {\\n            mstore(0x00, 0x4e487b71)\\n            mstore(0x20, code)\\n            revert(0x1c, 0x24)\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0xf7fe324703a64fc51702311dc51562d5cb1497734f074e4f483bfb6717572d7a\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/introspection/IERC165.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Interface of the ERC-165 standard, as defined in the\\n * https://eips.ethereum.org/EIPS/eip-165[ERC].\\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[ERC 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\",\"keccak256\":\"0x79796192ec90263f21b464d5bc90b777a525971d3de8232be80d9c4f9fb353b8\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/Math.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Panic} from \\\"../Panic.sol\\\";\\nimport {SafeCast} from \\\"./SafeCast.sol\\\";\\n\\n/**\\n * @dev Standard math utilities missing in the Solidity language.\\n */\\nlibrary Math {\\n    enum Rounding {\\n        Floor, // Toward negative infinity\\n        Ceil, // Toward positive infinity\\n        Trunc, // Toward zero\\n        Expand // Away from zero\\n    }\\n\\n    /**\\n     * @dev Returns the addition of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            uint256 c = a + b;\\n            if (c < a) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b > a) return (false, 0);\\n            return (true, a - b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow).\\n     */\\n    function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the\\n            // benefit is lost if 'b' is also tested.\\n            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522\\n            if (a == 0) return (true, 0);\\n            uint256 c = a * b;\\n            if (c / a != b) return (false, 0);\\n            return (true, c);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the division of two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a / b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).\\n     */\\n    function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {\\n        unchecked {\\n            if (b == 0) return (false, 0);\\n            return (true, a % b);\\n        }\\n    }\\n\\n    /**\\n     * @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.\\n     *\\n     * IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.\\n     * However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute\\n     * one branch when needed, making this function more expensive.\\n     */\\n    function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {\\n        unchecked {\\n            // branchless ternary works because:\\n            // b ^ (a ^ b) == a\\n            // b ^ 0 == b\\n            return b ^ ((a ^ b) * SafeCast.toUint(condition));\\n        }\\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 ternary(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 ternary(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 towards infinity instead\\n     * of rounding towards zero.\\n     */\\n    function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {\\n        if (b == 0) {\\n            // Guarantee the same behavior as in a regular Solidity division.\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n\\n        // The following calculation ensures accurate ceiling division without overflow.\\n        // Since a is non-zero, (a - 1) / b will not overflow.\\n        // The largest possible result occurs when (a - 1) / b is type(uint256).max,\\n        // but the largest value we can obtain is type(uint256).max - 1, which happens\\n        // when a = type(uint256).max and b = 1.\\n        unchecked {\\n            return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);\\n        }\\n    }\\n\\n    /**\\n     * @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or\\n     * denominator == 0.\\n     *\\n     * Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by\\n     * 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\\u00b2\\u2075\\u2076 and mod 2\\u00b2\\u2075\\u2076 - 1, then use\\n            // the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256\\n            // variables such that product = prod1 * 2\\u00b2\\u2075\\u2076 + prod0.\\n            uint256 prod0 = x * y; // 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                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\\u00b2\\u2075\\u2076. Also prevents denominator == 0.\\n            if (denominator <= prod1) {\\n                Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));\\n            }\\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.\\n            // Always >= 1. See https://cs.stackexchange.com/q/138556/92363.\\n\\n            uint256 twos = denominator & (0 - denominator);\\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\\u00b2\\u2075\\u2076 / 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\\u00b2\\u2075\\u2076. Now that denominator is an odd number, it has an inverse modulo 2\\u00b2\\u2075\\u2076 such\\n            // that denominator * inv \\u2261 1 mod 2\\u00b2\\u2075\\u2076. Compute the inverse by starting with a seed that is correct for\\n            // four bits. That is, denominator * inv \\u2261 1 mod 2\\u2074.\\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\\n            // works in modular arithmetic, doubling the correct bits in each step.\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u2076\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b3\\u00b2\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u2076\\u2074\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b9\\u00b2\\u2078\\n            inverse *= 2 - denominator * inverse; // inverse mod 2\\u00b2\\u2075\\u2076\\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\\u00b2\\u2075\\u2076. Since the preconditions guarantee that the outcome is\\n            // less than 2\\u00b2\\u2075\\u2076, 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     * @dev 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        return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);\\n    }\\n\\n    /**\\n     * @dev Calculate the modular multiplicative inverse of a number in Z/nZ.\\n     *\\n     * If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.\\n     * If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.\\n     *\\n     * If the input value is not inversible, 0 is returned.\\n     *\\n     * NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the\\n     * inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.\\n     */\\n    function invMod(uint256 a, uint256 n) internal pure returns (uint256) {\\n        unchecked {\\n            if (n == 0) return 0;\\n\\n            // The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)\\n            // Used to compute integers x and y such that: ax + ny = gcd(a, n).\\n            // When the gcd is 1, then the inverse of a modulo n exists and it's x.\\n            // ax + ny = 1\\n            // ax = 1 + (-y)n\\n            // ax \\u2261 1 (mod n) # x is the inverse of a modulo n\\n\\n            // If the remainder is 0 the gcd is n right away.\\n            uint256 remainder = a % n;\\n            uint256 gcd = n;\\n\\n            // Therefore the initial coefficients are:\\n            // ax + ny = gcd(a, n) = n\\n            // 0a + 1n = n\\n            int256 x = 0;\\n            int256 y = 1;\\n\\n            while (remainder != 0) {\\n                uint256 quotient = gcd / remainder;\\n\\n                (gcd, remainder) = (\\n                    // The old remainder is the next gcd to try.\\n                    remainder,\\n                    // Compute the next remainder.\\n                    // Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd\\n                    // where gcd is at most n (capped to type(uint256).max)\\n                    gcd - remainder * quotient\\n                );\\n\\n                (x, y) = (\\n                    // Increment the coefficient of a.\\n                    y,\\n                    // Decrement the coefficient of n.\\n                    // Can overflow, but the result is casted to uint256 so that the\\n                    // next value of y is \\\"wrapped around\\\" to a value between 0 and n - 1.\\n                    x - y * int256(quotient)\\n                );\\n            }\\n\\n            if (gcd != 1) return 0; // No inverse exists.\\n            return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.\\n     *\\n     * From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is\\n     * prime, then `a**(p-1) \\u2261 1 mod p`. As a consequence, we have `a * a**(p-2) \\u2261 1 mod p`, which means that\\n     * `a**(p-2)` is the modular multiplicative inverse of a in Fp.\\n     *\\n     * NOTE: this function does NOT check that `p` is a prime greater than `2`.\\n     */\\n    function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {\\n        unchecked {\\n            return Math.modExp(a, p - 2, p);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)\\n     *\\n     * Requirements:\\n     * - modulus can't be zero\\n     * - underlying staticcall to precompile must succeed\\n     *\\n     * IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make\\n     * sure the chain you're using it on supports the precompiled contract for modular exponentiation\\n     * at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,\\n     * the underlying function will succeed given the lack of a revert, but the result may be incorrectly\\n     * interpreted as 0.\\n     */\\n    function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {\\n        (bool success, uint256 result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).\\n     * It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying\\n     * to operate modulo 0 or if the underlying precompile reverted.\\n     *\\n     * IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain\\n     * you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in\\n     * https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack\\n     * of a revert, but the result may be incorrectly interpreted as 0.\\n     */\\n    function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {\\n        if (m == 0) return (false, 0);\\n        assembly (\\\"memory-safe\\\") {\\n            let ptr := mload(0x40)\\n            // | Offset    | Content    | Content (Hex)                                                      |\\n            // |-----------|------------|--------------------------------------------------------------------|\\n            // | 0x00:0x1f | size of b  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x20:0x3f | size of e  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x40:0x5f | size of m  | 0x0000000000000000000000000000000000000000000000000000000000000020 |\\n            // | 0x60:0x7f | value of b | 0x<.............................................................b> |\\n            // | 0x80:0x9f | value of e | 0x<.............................................................e> |\\n            // | 0xa0:0xbf | value of m | 0x<.............................................................m> |\\n            mstore(ptr, 0x20)\\n            mstore(add(ptr, 0x20), 0x20)\\n            mstore(add(ptr, 0x40), 0x20)\\n            mstore(add(ptr, 0x60), b)\\n            mstore(add(ptr, 0x80), e)\\n            mstore(add(ptr, 0xa0), m)\\n\\n            // Given the result < m, it's guaranteed to fit in 32 bytes,\\n            // so we can use the memory scratch space located at offset 0.\\n            success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)\\n            result := mload(0x00)\\n        }\\n    }\\n\\n    /**\\n     * @dev Variant of {modExp} that supports inputs of arbitrary length.\\n     */\\n    function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {\\n        (bool success, bytes memory result) = tryModExp(b, e, m);\\n        if (!success) {\\n            Panic.panic(Panic.DIVISION_BY_ZERO);\\n        }\\n        return result;\\n    }\\n\\n    /**\\n     * @dev Variant of {tryModExp} that supports inputs of arbitrary length.\\n     */\\n    function tryModExp(\\n        bytes memory b,\\n        bytes memory e,\\n        bytes memory m\\n    ) internal view returns (bool success, bytes memory result) {\\n        if (_zeroBytes(m)) return (false, new bytes(0));\\n\\n        uint256 mLen = m.length;\\n\\n        // Encode call args in result and move the free memory pointer\\n        result = abi.encodePacked(b.length, e.length, mLen, b, e, m);\\n\\n        assembly (\\\"memory-safe\\\") {\\n            let dataPtr := add(result, 0x20)\\n            // Write result on top of args to avoid allocating extra memory.\\n            success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)\\n            // Overwrite the length.\\n            // result.length > returndatasize() is guaranteed because returndatasize() == m.length\\n            mstore(result, mLen)\\n            // Set the memory pointer after the returned data.\\n            mstore(0x40, add(dataPtr, mLen))\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether the provided byte array is zero.\\n     */\\n    function _zeroBytes(bytes memory byteArray) private pure returns (bool) {\\n        for (uint256 i = 0; i < byteArray.length; ++i) {\\n            if (byteArray[i] != 0) {\\n                return false;\\n            }\\n        }\\n        return true;\\n    }\\n\\n    /**\\n     * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded\\n     * towards zero.\\n     *\\n     * This method is based on Newton's method for computing square roots; the algorithm is restricted to only\\n     * using integer operations.\\n     */\\n    function sqrt(uint256 a) internal pure returns (uint256) {\\n        unchecked {\\n            // Take care of easy edge cases when a == 0 or a == 1\\n            if (a <= 1) {\\n                return a;\\n            }\\n\\n            // In this function, we use Newton's method to get a root of `f(x) := x\\u00b2 - a`. It involves building a\\n            // sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between\\n            // the current value as `\\u03b5_n = | x_n - sqrt(a) |`.\\n            //\\n            // For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root\\n            // of the target. (i.e. `2**(e-1) \\u2264 sqrt(a) < 2**e`). We know that `e \\u2264 128` because `(2\\u00b9\\u00b2\\u2078)\\u00b2 = 2\\u00b2\\u2075\\u2076` is\\n            // bigger than any uint256.\\n            //\\n            // By noticing that\\n            // `2**(e-1) \\u2264 sqrt(a) < 2**e \\u2192 (2**(e-1))\\u00b2 \\u2264 a < (2**e)\\u00b2 \\u2192 2**(2*e-2) \\u2264 a < 2**(2*e)`\\n            // we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar\\n            // to the msb function.\\n            uint256 aa = a;\\n            uint256 xn = 1;\\n\\n            if (aa >= (1 << 128)) {\\n                aa >>= 128;\\n                xn <<= 64;\\n            }\\n            if (aa >= (1 << 64)) {\\n                aa >>= 64;\\n                xn <<= 32;\\n            }\\n            if (aa >= (1 << 32)) {\\n                aa >>= 32;\\n                xn <<= 16;\\n            }\\n            if (aa >= (1 << 16)) {\\n                aa >>= 16;\\n                xn <<= 8;\\n            }\\n            if (aa >= (1 << 8)) {\\n                aa >>= 8;\\n                xn <<= 4;\\n            }\\n            if (aa >= (1 << 4)) {\\n                aa >>= 4;\\n                xn <<= 2;\\n            }\\n            if (aa >= (1 << 2)) {\\n                xn <<= 1;\\n            }\\n\\n            // We now have x_n such that `x_n = 2**(e-1) \\u2264 sqrt(a) < 2**e = 2 * x_n`. This implies \\u03b5_n \\u2264 2**(e-1).\\n            //\\n            // We can refine our estimation by noticing that the middle of that interval minimizes the error.\\n            // If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to \\u03b5_n \\u2264 2**(e-2).\\n            // This is going to be our x_0 (and \\u03b5_0)\\n            xn = (3 * xn) >> 1; // \\u03b5_0 := | x_0 - sqrt(a) | \\u2264 2**(e-2)\\n\\n            // From here, Newton's method give us:\\n            // x_{n+1} = (x_n + a / x_n) / 2\\n            //\\n            // One should note that:\\n            // x_{n+1}\\u00b2 - a = ((x_n + a / x_n) / 2)\\u00b2 - a\\n            //              = ((x_n\\u00b2 + a) / (2 * x_n))\\u00b2 - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2) - a\\n            //              = (x_n\\u2074 + 2 * a * x_n\\u00b2 + a\\u00b2 - 4 * a * x_n\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u2074 - 2 * a * x_n\\u00b2 + a\\u00b2) / (4 * x_n\\u00b2)\\n            //              = (x_n\\u00b2 - a)\\u00b2 / (2 * x_n)\\u00b2\\n            //              = ((x_n\\u00b2 - a) / (2 * x_n))\\u00b2\\n            //              \\u2265 0\\n            // Which proves that for all n \\u2265 1, sqrt(a) \\u2264 x_n\\n            //\\n            // This gives us the proof of quadratic convergence of the sequence:\\n            // \\u03b5_{n+1} = | x_{n+1} - sqrt(a) |\\n            //         = | (x_n + a / x_n) / 2 - sqrt(a) |\\n            //         = | (x_n\\u00b2 + a - 2*x_n*sqrt(a)) / (2 * x_n) |\\n            //         = | (x_n - sqrt(a))\\u00b2 / (2 * x_n) |\\n            //         = | \\u03b5_n\\u00b2 / (2 * x_n) |\\n            //         = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //\\n            // For the first iteration, we have a special case where x_0 is known:\\n            // \\u03b5_1 = \\u03b5_0\\u00b2 / | (2 * x_0) |\\n            //     \\u2264 (2**(e-2))\\u00b2 / (2 * (2**(e-1) + 2**(e-2)))\\n            //     \\u2264 2**(2*e-4) / (3 * 2**(e-1))\\n            //     \\u2264 2**(e-3) / 3\\n            //     \\u2264 2**(e-3-log2(3))\\n            //     \\u2264 2**(e-4.5)\\n            //\\n            // For the following iterations, we use the fact that, 2**(e-1) \\u2264 sqrt(a) \\u2264 x_n:\\n            // \\u03b5_{n+1} = \\u03b5_n\\u00b2 / | (2 * x_n) |\\n            //         \\u2264 (2**(e-k))\\u00b2 / (2 * 2**(e-1))\\n            //         \\u2264 2**(2*e-2*k) / 2**e\\n            //         \\u2264 2**(e-2*k)\\n            xn = (xn + a / xn) >> 1; // \\u03b5_1 := | x_1 - sqrt(a) | \\u2264 2**(e-4.5)  -- special case, see above\\n            xn = (xn + a / xn) >> 1; // \\u03b5_2 := | x_2 - sqrt(a) | \\u2264 2**(e-9)    -- general case with k = 4.5\\n            xn = (xn + a / xn) >> 1; // \\u03b5_3 := | x_3 - sqrt(a) | \\u2264 2**(e-18)   -- general case with k = 9\\n            xn = (xn + a / xn) >> 1; // \\u03b5_4 := | x_4 - sqrt(a) | \\u2264 2**(e-36)   -- general case with k = 18\\n            xn = (xn + a / xn) >> 1; // \\u03b5_5 := | x_5 - sqrt(a) | \\u2264 2**(e-72)   -- general case with k = 36\\n            xn = (xn + a / xn) >> 1; // \\u03b5_6 := | x_6 - sqrt(a) | \\u2264 2**(e-144)  -- general case with k = 72\\n\\n            // Because e \\u2264 128 (as discussed during the first estimation phase), we know have reached a precision\\n            // \\u03b5_6 \\u2264 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either\\n            // sqrt(a) or sqrt(a) + 1.\\n            return xn - SafeCast.toUint(xn > a / xn);\\n        }\\n    }\\n\\n    /**\\n     * @dev 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 + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 2 of a positive value rounded towards zero.\\n     * Returns 0 if given 0.\\n     */\\n    function log2(uint256 value) internal pure returns (uint256) {\\n        uint256 result = 0;\\n        uint256 exp;\\n        unchecked {\\n            exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);\\n            value >>= exp;\\n            result += exp;\\n\\n            result += SafeCast.toUint(value > 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 10 of a positive value rounded towards zero.\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Return the log in base 256 of a positive value rounded towards zero.\\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        uint256 isGt;\\n        unchecked {\\n            isGt = SafeCast.toUint(value > (1 << 128) - 1);\\n            value >>= isGt * 128;\\n            result += isGt * 16;\\n\\n            isGt = SafeCast.toUint(value > (1 << 64) - 1);\\n            value >>= isGt * 64;\\n            result += isGt * 8;\\n\\n            isGt = SafeCast.toUint(value > (1 << 32) - 1);\\n            value >>= isGt * 32;\\n            result += isGt * 4;\\n\\n            isGt = SafeCast.toUint(value > (1 << 16) - 1);\\n            value >>= isGt * 16;\\n            result += isGt * 2;\\n\\n            result += SafeCast.toUint(value > (1 << 8) - 1);\\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 + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.\\n     */\\n    function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {\\n        return uint8(rounding) % 2 == 1;\\n    }\\n}\\n\",\"keccak256\":\"0xa00be322d7db5786750ce0ac7e2f5b633ac30a5ed5fa1ced1e74acfc19acecea\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/math/SafeCast.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)\\n// This file was procedurally generated from scripts/generate/templates/SafeCast.js.\\n\\npragma solidity ^0.8.20;\\n\\n/**\\n * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow\\n * checks.\\n *\\n * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can\\n * easily result in undesired exploitation or bugs, since developers usually\\n * assume that overflows raise errors. `SafeCast` restores this intuition by\\n * reverting the transaction when such an operation overflows.\\n *\\n * Using this library instead of the unchecked operations eliminates an entire\\n * class of bugs, so it's recommended to use it always.\\n */\\nlibrary SafeCast {\\n    /**\\n     * @dev Value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);\\n\\n    /**\\n     * @dev An int value doesn't fit in an uint of `bits` size.\\n     */\\n    error SafeCastOverflowedIntToUint(int256 value);\\n\\n    /**\\n     * @dev Value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);\\n\\n    /**\\n     * @dev An uint value doesn't fit in an int of `bits` size.\\n     */\\n    error SafeCastOverflowedUintToInt(uint256 value);\\n\\n    /**\\n     * @dev Returns the downcasted uint248 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint248).\\n     *\\n     * Counterpart to Solidity's `uint248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toUint248(uint256 value) internal pure returns (uint248) {\\n        if (value > type(uint248).max) {\\n            revert SafeCastOverflowedUintDowncast(248, value);\\n        }\\n        return uint248(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint240 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint240).\\n     *\\n     * Counterpart to Solidity's `uint240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toUint240(uint256 value) internal pure returns (uint240) {\\n        if (value > type(uint240).max) {\\n            revert SafeCastOverflowedUintDowncast(240, value);\\n        }\\n        return uint240(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint232 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint232).\\n     *\\n     * Counterpart to Solidity's `uint232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toUint232(uint256 value) internal pure returns (uint232) {\\n        if (value > type(uint232).max) {\\n            revert SafeCastOverflowedUintDowncast(232, value);\\n        }\\n        return uint232(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint224 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint224).\\n     *\\n     * Counterpart to Solidity's `uint224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toUint224(uint256 value) internal pure returns (uint224) {\\n        if (value > type(uint224).max) {\\n            revert SafeCastOverflowedUintDowncast(224, value);\\n        }\\n        return uint224(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint216 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint216).\\n     *\\n     * Counterpart to Solidity's `uint216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toUint216(uint256 value) internal pure returns (uint216) {\\n        if (value > type(uint216).max) {\\n            revert SafeCastOverflowedUintDowncast(216, value);\\n        }\\n        return uint216(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint208 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint208).\\n     *\\n     * Counterpart to Solidity's `uint208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toUint208(uint256 value) internal pure returns (uint208) {\\n        if (value > type(uint208).max) {\\n            revert SafeCastOverflowedUintDowncast(208, value);\\n        }\\n        return uint208(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint200 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint200).\\n     *\\n     * Counterpart to Solidity's `uint200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toUint200(uint256 value) internal pure returns (uint200) {\\n        if (value > type(uint200).max) {\\n            revert SafeCastOverflowedUintDowncast(200, value);\\n        }\\n        return uint200(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint192 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint192).\\n     *\\n     * Counterpart to Solidity's `uint192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toUint192(uint256 value) internal pure returns (uint192) {\\n        if (value > type(uint192).max) {\\n            revert SafeCastOverflowedUintDowncast(192, value);\\n        }\\n        return uint192(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint184 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint184).\\n     *\\n     * Counterpart to Solidity's `uint184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toUint184(uint256 value) internal pure returns (uint184) {\\n        if (value > type(uint184).max) {\\n            revert SafeCastOverflowedUintDowncast(184, value);\\n        }\\n        return uint184(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint176 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint176).\\n     *\\n     * Counterpart to Solidity's `uint176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toUint176(uint256 value) internal pure returns (uint176) {\\n        if (value > type(uint176).max) {\\n            revert SafeCastOverflowedUintDowncast(176, value);\\n        }\\n        return uint176(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint168 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint168).\\n     *\\n     * Counterpart to Solidity's `uint168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toUint168(uint256 value) internal pure returns (uint168) {\\n        if (value > type(uint168).max) {\\n            revert SafeCastOverflowedUintDowncast(168, value);\\n        }\\n        return uint168(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint160 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint160).\\n     *\\n     * Counterpart to Solidity's `uint160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toUint160(uint256 value) internal pure returns (uint160) {\\n        if (value > type(uint160).max) {\\n            revert SafeCastOverflowedUintDowncast(160, value);\\n        }\\n        return uint160(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint152 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint152).\\n     *\\n     * Counterpart to Solidity's `uint152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toUint152(uint256 value) internal pure returns (uint152) {\\n        if (value > type(uint152).max) {\\n            revert SafeCastOverflowedUintDowncast(152, value);\\n        }\\n        return uint152(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint144 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint144).\\n     *\\n     * Counterpart to Solidity's `uint144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toUint144(uint256 value) internal pure returns (uint144) {\\n        if (value > type(uint144).max) {\\n            revert SafeCastOverflowedUintDowncast(144, value);\\n        }\\n        return uint144(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint136 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint136).\\n     *\\n     * Counterpart to Solidity's `uint136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toUint136(uint256 value) internal pure returns (uint136) {\\n        if (value > type(uint136).max) {\\n            revert SafeCastOverflowedUintDowncast(136, value);\\n        }\\n        return uint136(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint128 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint128).\\n     *\\n     * Counterpart to Solidity's `uint128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toUint128(uint256 value) internal pure returns (uint128) {\\n        if (value > type(uint128).max) {\\n            revert SafeCastOverflowedUintDowncast(128, value);\\n        }\\n        return uint128(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint120 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint120).\\n     *\\n     * Counterpart to Solidity's `uint120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toUint120(uint256 value) internal pure returns (uint120) {\\n        if (value > type(uint120).max) {\\n            revert SafeCastOverflowedUintDowncast(120, value);\\n        }\\n        return uint120(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint112 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint112).\\n     *\\n     * Counterpart to Solidity's `uint112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toUint112(uint256 value) internal pure returns (uint112) {\\n        if (value > type(uint112).max) {\\n            revert SafeCastOverflowedUintDowncast(112, value);\\n        }\\n        return uint112(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint104 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint104).\\n     *\\n     * Counterpart to Solidity's `uint104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toUint104(uint256 value) internal pure returns (uint104) {\\n        if (value > type(uint104).max) {\\n            revert SafeCastOverflowedUintDowncast(104, value);\\n        }\\n        return uint104(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint96 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint96).\\n     *\\n     * Counterpart to Solidity's `uint96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toUint96(uint256 value) internal pure returns (uint96) {\\n        if (value > type(uint96).max) {\\n            revert SafeCastOverflowedUintDowncast(96, value);\\n        }\\n        return uint96(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint88 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint88).\\n     *\\n     * Counterpart to Solidity's `uint88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toUint88(uint256 value) internal pure returns (uint88) {\\n        if (value > type(uint88).max) {\\n            revert SafeCastOverflowedUintDowncast(88, value);\\n        }\\n        return uint88(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint80 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint80).\\n     *\\n     * Counterpart to Solidity's `uint80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toUint80(uint256 value) internal pure returns (uint80) {\\n        if (value > type(uint80).max) {\\n            revert SafeCastOverflowedUintDowncast(80, value);\\n        }\\n        return uint80(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint72 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint72).\\n     *\\n     * Counterpart to Solidity's `uint72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toUint72(uint256 value) internal pure returns (uint72) {\\n        if (value > type(uint72).max) {\\n            revert SafeCastOverflowedUintDowncast(72, value);\\n        }\\n        return uint72(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint64 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint64).\\n     *\\n     * Counterpart to Solidity's `uint64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toUint64(uint256 value) internal pure returns (uint64) {\\n        if (value > type(uint64).max) {\\n            revert SafeCastOverflowedUintDowncast(64, value);\\n        }\\n        return uint64(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint56 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint56).\\n     *\\n     * Counterpart to Solidity's `uint56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toUint56(uint256 value) internal pure returns (uint56) {\\n        if (value > type(uint56).max) {\\n            revert SafeCastOverflowedUintDowncast(56, value);\\n        }\\n        return uint56(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint48 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint48).\\n     *\\n     * Counterpart to Solidity's `uint48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toUint48(uint256 value) internal pure returns (uint48) {\\n        if (value > type(uint48).max) {\\n            revert SafeCastOverflowedUintDowncast(48, value);\\n        }\\n        return uint48(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint40 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint40).\\n     *\\n     * Counterpart to Solidity's `uint40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toUint40(uint256 value) internal pure returns (uint40) {\\n        if (value > type(uint40).max) {\\n            revert SafeCastOverflowedUintDowncast(40, value);\\n        }\\n        return uint40(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint32 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint32).\\n     *\\n     * Counterpart to Solidity's `uint32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toUint32(uint256 value) internal pure returns (uint32) {\\n        if (value > type(uint32).max) {\\n            revert SafeCastOverflowedUintDowncast(32, value);\\n        }\\n        return uint32(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint24 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint24).\\n     *\\n     * Counterpart to Solidity's `uint24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toUint24(uint256 value) internal pure returns (uint24) {\\n        if (value > type(uint24).max) {\\n            revert SafeCastOverflowedUintDowncast(24, value);\\n        }\\n        return uint24(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint16 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint16).\\n     *\\n     * Counterpart to Solidity's `uint16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toUint16(uint256 value) internal pure returns (uint16) {\\n        if (value > type(uint16).max) {\\n            revert SafeCastOverflowedUintDowncast(16, value);\\n        }\\n        return uint16(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted uint8 from uint256, reverting on\\n     * overflow (when the input is greater than largest uint8).\\n     *\\n     * Counterpart to Solidity's `uint8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toUint8(uint256 value) internal pure returns (uint8) {\\n        if (value > type(uint8).max) {\\n            revert SafeCastOverflowedUintDowncast(8, value);\\n        }\\n        return uint8(value);\\n    }\\n\\n    /**\\n     * @dev Converts a signed int256 into an unsigned uint256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be greater than or equal to 0.\\n     */\\n    function toUint256(int256 value) internal pure returns (uint256) {\\n        if (value < 0) {\\n            revert SafeCastOverflowedIntToUint(value);\\n        }\\n        return uint256(value);\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int248 from int256, reverting on\\n     * overflow (when the input is less than smallest int248 or\\n     * greater than largest int248).\\n     *\\n     * Counterpart to Solidity's `int248` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 248 bits\\n     */\\n    function toInt248(int256 value) internal pure returns (int248 downcasted) {\\n        downcasted = int248(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(248, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int240 from int256, reverting on\\n     * overflow (when the input is less than smallest int240 or\\n     * greater than largest int240).\\n     *\\n     * Counterpart to Solidity's `int240` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 240 bits\\n     */\\n    function toInt240(int256 value) internal pure returns (int240 downcasted) {\\n        downcasted = int240(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(240, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int232 from int256, reverting on\\n     * overflow (when the input is less than smallest int232 or\\n     * greater than largest int232).\\n     *\\n     * Counterpart to Solidity's `int232` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 232 bits\\n     */\\n    function toInt232(int256 value) internal pure returns (int232 downcasted) {\\n        downcasted = int232(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(232, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int224 from int256, reverting on\\n     * overflow (when the input is less than smallest int224 or\\n     * greater than largest int224).\\n     *\\n     * Counterpart to Solidity's `int224` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 224 bits\\n     */\\n    function toInt224(int256 value) internal pure returns (int224 downcasted) {\\n        downcasted = int224(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(224, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int216 from int256, reverting on\\n     * overflow (when the input is less than smallest int216 or\\n     * greater than largest int216).\\n     *\\n     * Counterpart to Solidity's `int216` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 216 bits\\n     */\\n    function toInt216(int256 value) internal pure returns (int216 downcasted) {\\n        downcasted = int216(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(216, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int208 from int256, reverting on\\n     * overflow (when the input is less than smallest int208 or\\n     * greater than largest int208).\\n     *\\n     * Counterpart to Solidity's `int208` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 208 bits\\n     */\\n    function toInt208(int256 value) internal pure returns (int208 downcasted) {\\n        downcasted = int208(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(208, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int200 from int256, reverting on\\n     * overflow (when the input is less than smallest int200 or\\n     * greater than largest int200).\\n     *\\n     * Counterpart to Solidity's `int200` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 200 bits\\n     */\\n    function toInt200(int256 value) internal pure returns (int200 downcasted) {\\n        downcasted = int200(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(200, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int192 from int256, reverting on\\n     * overflow (when the input is less than smallest int192 or\\n     * greater than largest int192).\\n     *\\n     * Counterpart to Solidity's `int192` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 192 bits\\n     */\\n    function toInt192(int256 value) internal pure returns (int192 downcasted) {\\n        downcasted = int192(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(192, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int184 from int256, reverting on\\n     * overflow (when the input is less than smallest int184 or\\n     * greater than largest int184).\\n     *\\n     * Counterpart to Solidity's `int184` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 184 bits\\n     */\\n    function toInt184(int256 value) internal pure returns (int184 downcasted) {\\n        downcasted = int184(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(184, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int176 from int256, reverting on\\n     * overflow (when the input is less than smallest int176 or\\n     * greater than largest int176).\\n     *\\n     * Counterpart to Solidity's `int176` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 176 bits\\n     */\\n    function toInt176(int256 value) internal pure returns (int176 downcasted) {\\n        downcasted = int176(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(176, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int168 from int256, reverting on\\n     * overflow (when the input is less than smallest int168 or\\n     * greater than largest int168).\\n     *\\n     * Counterpart to Solidity's `int168` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 168 bits\\n     */\\n    function toInt168(int256 value) internal pure returns (int168 downcasted) {\\n        downcasted = int168(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(168, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int160 from int256, reverting on\\n     * overflow (when the input is less than smallest int160 or\\n     * greater than largest int160).\\n     *\\n     * Counterpart to Solidity's `int160` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 160 bits\\n     */\\n    function toInt160(int256 value) internal pure returns (int160 downcasted) {\\n        downcasted = int160(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(160, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int152 from int256, reverting on\\n     * overflow (when the input is less than smallest int152 or\\n     * greater than largest int152).\\n     *\\n     * Counterpart to Solidity's `int152` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 152 bits\\n     */\\n    function toInt152(int256 value) internal pure returns (int152 downcasted) {\\n        downcasted = int152(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(152, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int144 from int256, reverting on\\n     * overflow (when the input is less than smallest int144 or\\n     * greater than largest int144).\\n     *\\n     * Counterpart to Solidity's `int144` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 144 bits\\n     */\\n    function toInt144(int256 value) internal pure returns (int144 downcasted) {\\n        downcasted = int144(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(144, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int136 from int256, reverting on\\n     * overflow (when the input is less than smallest int136 or\\n     * greater than largest int136).\\n     *\\n     * Counterpart to Solidity's `int136` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 136 bits\\n     */\\n    function toInt136(int256 value) internal pure returns (int136 downcasted) {\\n        downcasted = int136(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(136, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int128 from int256, reverting on\\n     * overflow (when the input is less than smallest int128 or\\n     * greater than largest int128).\\n     *\\n     * Counterpart to Solidity's `int128` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 128 bits\\n     */\\n    function toInt128(int256 value) internal pure returns (int128 downcasted) {\\n        downcasted = int128(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(128, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int120 from int256, reverting on\\n     * overflow (when the input is less than smallest int120 or\\n     * greater than largest int120).\\n     *\\n     * Counterpart to Solidity's `int120` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 120 bits\\n     */\\n    function toInt120(int256 value) internal pure returns (int120 downcasted) {\\n        downcasted = int120(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(120, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int112 from int256, reverting on\\n     * overflow (when the input is less than smallest int112 or\\n     * greater than largest int112).\\n     *\\n     * Counterpart to Solidity's `int112` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 112 bits\\n     */\\n    function toInt112(int256 value) internal pure returns (int112 downcasted) {\\n        downcasted = int112(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(112, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int104 from int256, reverting on\\n     * overflow (when the input is less than smallest int104 or\\n     * greater than largest int104).\\n     *\\n     * Counterpart to Solidity's `int104` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 104 bits\\n     */\\n    function toInt104(int256 value) internal pure returns (int104 downcasted) {\\n        downcasted = int104(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(104, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int96 from int256, reverting on\\n     * overflow (when the input is less than smallest int96 or\\n     * greater than largest int96).\\n     *\\n     * Counterpart to Solidity's `int96` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 96 bits\\n     */\\n    function toInt96(int256 value) internal pure returns (int96 downcasted) {\\n        downcasted = int96(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(96, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int88 from int256, reverting on\\n     * overflow (when the input is less than smallest int88 or\\n     * greater than largest int88).\\n     *\\n     * Counterpart to Solidity's `int88` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 88 bits\\n     */\\n    function toInt88(int256 value) internal pure returns (int88 downcasted) {\\n        downcasted = int88(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(88, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int80 from int256, reverting on\\n     * overflow (when the input is less than smallest int80 or\\n     * greater than largest int80).\\n     *\\n     * Counterpart to Solidity's `int80` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 80 bits\\n     */\\n    function toInt80(int256 value) internal pure returns (int80 downcasted) {\\n        downcasted = int80(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(80, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int72 from int256, reverting on\\n     * overflow (when the input is less than smallest int72 or\\n     * greater than largest int72).\\n     *\\n     * Counterpart to Solidity's `int72` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 72 bits\\n     */\\n    function toInt72(int256 value) internal pure returns (int72 downcasted) {\\n        downcasted = int72(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(72, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int64 from int256, reverting on\\n     * overflow (when the input is less than smallest int64 or\\n     * greater than largest int64).\\n     *\\n     * Counterpart to Solidity's `int64` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 64 bits\\n     */\\n    function toInt64(int256 value) internal pure returns (int64 downcasted) {\\n        downcasted = int64(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(64, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int56 from int256, reverting on\\n     * overflow (when the input is less than smallest int56 or\\n     * greater than largest int56).\\n     *\\n     * Counterpart to Solidity's `int56` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 56 bits\\n     */\\n    function toInt56(int256 value) internal pure returns (int56 downcasted) {\\n        downcasted = int56(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(56, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int48 from int256, reverting on\\n     * overflow (when the input is less than smallest int48 or\\n     * greater than largest int48).\\n     *\\n     * Counterpart to Solidity's `int48` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 48 bits\\n     */\\n    function toInt48(int256 value) internal pure returns (int48 downcasted) {\\n        downcasted = int48(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(48, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int40 from int256, reverting on\\n     * overflow (when the input is less than smallest int40 or\\n     * greater than largest int40).\\n     *\\n     * Counterpart to Solidity's `int40` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 40 bits\\n     */\\n    function toInt40(int256 value) internal pure returns (int40 downcasted) {\\n        downcasted = int40(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(40, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int32 from int256, reverting on\\n     * overflow (when the input is less than smallest int32 or\\n     * greater than largest int32).\\n     *\\n     * Counterpart to Solidity's `int32` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 32 bits\\n     */\\n    function toInt32(int256 value) internal pure returns (int32 downcasted) {\\n        downcasted = int32(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(32, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int24 from int256, reverting on\\n     * overflow (when the input is less than smallest int24 or\\n     * greater than largest int24).\\n     *\\n     * Counterpart to Solidity's `int24` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 24 bits\\n     */\\n    function toInt24(int256 value) internal pure returns (int24 downcasted) {\\n        downcasted = int24(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(24, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int16 from int256, reverting on\\n     * overflow (when the input is less than smallest int16 or\\n     * greater than largest int16).\\n     *\\n     * Counterpart to Solidity's `int16` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 16 bits\\n     */\\n    function toInt16(int256 value) internal pure returns (int16 downcasted) {\\n        downcasted = int16(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(16, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Returns the downcasted int8 from int256, reverting on\\n     * overflow (when the input is less than smallest int8 or\\n     * greater than largest int8).\\n     *\\n     * Counterpart to Solidity's `int8` operator.\\n     *\\n     * Requirements:\\n     *\\n     * - input must fit into 8 bits\\n     */\\n    function toInt8(int256 value) internal pure returns (int8 downcasted) {\\n        downcasted = int8(value);\\n        if (downcasted != value) {\\n            revert SafeCastOverflowedIntDowncast(8, value);\\n        }\\n    }\\n\\n    /**\\n     * @dev Converts an unsigned uint256 into a signed int256.\\n     *\\n     * Requirements:\\n     *\\n     * - input must be less than or equal to maxInt256.\\n     */\\n    function toInt256(uint256 value) internal pure returns (int256) {\\n        // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive\\n        if (value > uint256(type(int256).max)) {\\n            revert SafeCastOverflowedUintToInt(value);\\n        }\\n        return int256(value);\\n    }\\n\\n    /**\\n     * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.\\n     */\\n    function toUint(bool b) internal pure returns (uint256 u) {\\n        assembly (\\\"memory-safe\\\") {\\n            u := iszero(iszero(b))\\n        }\\n    }\\n}\\n\",\"keccak256\":\"0x195533c86d0ef72bcc06456a4f66a9b941f38eb403739b00f21fd7c1abd1ae54\",\"license\":\"MIT\"},\"@openzeppelin/contracts/utils/types/Time.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\n// OpenZeppelin Contracts (last updated v5.1.0) (utils/types/Time.sol)\\n\\npragma solidity ^0.8.20;\\n\\nimport {Math} from \\\"../math/Math.sol\\\";\\nimport {SafeCast} from \\\"../math/SafeCast.sol\\\";\\n\\n/**\\n * @dev This library provides helpers for manipulating time-related objects.\\n *\\n * It uses the following types:\\n * - `uint48` for timepoints\\n * - `uint32` for durations\\n *\\n * While the library doesn't provide specific types for timepoints and duration, it does provide:\\n * - a `Delay` type to represent duration that can be programmed to change value automatically at a given point\\n * - additional helper functions\\n */\\nlibrary Time {\\n    using Time for *;\\n\\n    /**\\n     * @dev Get the block timestamp as a Timepoint.\\n     */\\n    function timestamp() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.timestamp);\\n    }\\n\\n    /**\\n     * @dev Get the block number as a Timepoint.\\n     */\\n    function blockNumber() internal view returns (uint48) {\\n        return SafeCast.toUint48(block.number);\\n    }\\n\\n    // ==================================================== Delay =====================================================\\n    /**\\n     * @dev A `Delay` is a uint32 duration that can be programmed to change value automatically at a given point in the\\n     * future. The \\\"effect\\\" timepoint describes when the transitions happens from the \\\"old\\\" value to the \\\"new\\\" value.\\n     * This allows updating the delay applied to some operation while keeping some guarantees.\\n     *\\n     * In particular, the {update} function guarantees that if the delay is reduced, the old delay still applies for\\n     * some time. For example if the delay is currently 7 days to do an upgrade, the admin should not be able to set\\n     * the delay to 0 and upgrade immediately. If the admin wants to reduce the delay, the old delay (7 days) should\\n     * still apply for some time.\\n     *\\n     *\\n     * The `Delay` type is 112 bits long, and packs the following:\\n     *\\n     * ```\\n     *   | [uint48]: effect date (timepoint)\\n     *   |           | [uint32]: value before (duration)\\n     *   \\u2193           \\u2193       \\u2193 [uint32]: value after (duration)\\n     * 0xAAAAAAAAAAAABBBBBBBBCCCCCCCC\\n     * ```\\n     *\\n     * NOTE: The {get} and {withUpdate} functions operate using timestamps. Block number based delays are not currently\\n     * supported.\\n     */\\n    type Delay is uint112;\\n\\n    /**\\n     * @dev Wrap a duration into a Delay to add the one-step \\\"update in the future\\\" feature\\n     */\\n    function toDelay(uint32 duration) internal pure returns (Delay) {\\n        return Delay.wrap(duration);\\n    }\\n\\n    /**\\n     * @dev Get the value at a given timepoint plus the pending value and effect timepoint if there is a scheduled\\n     * change after this timepoint. If the effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function _getFullAt(\\n        Delay self,\\n        uint48 timepoint\\n    ) private pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        (valueBefore, valueAfter, effect) = self.unpack();\\n        return effect <= timepoint ? (valueAfter, 0, 0) : (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev Get the current value plus the pending value and effect timepoint if there is a scheduled change. If the\\n     * effect timepoint is 0, then the pending value should not be considered.\\n     */\\n    function getFull(Delay self) internal view returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        return _getFullAt(self, timestamp());\\n    }\\n\\n    /**\\n     * @dev Get the current value.\\n     */\\n    function get(Delay self) internal view returns (uint32) {\\n        (uint32 delay, , ) = self.getFull();\\n        return delay;\\n    }\\n\\n    /**\\n     * @dev Update a Delay object so that it takes a new duration after a timepoint that is automatically computed to\\n     * enforce the old delay at the moment of the update. Returns the updated Delay object and the timestamp when the\\n     * new delay becomes effective.\\n     */\\n    function withUpdate(\\n        Delay self,\\n        uint32 newValue,\\n        uint32 minSetback\\n    ) internal view returns (Delay updatedDelay, uint48 effect) {\\n        uint32 value = self.get();\\n        uint32 setback = uint32(Math.max(minSetback, value > newValue ? value - newValue : 0));\\n        effect = timestamp() + setback;\\n        return (pack(value, newValue, effect), effect);\\n    }\\n\\n    /**\\n     * @dev Split a delay into its components: valueBefore, valueAfter and effect (transition timepoint).\\n     */\\n    function unpack(Delay self) internal pure returns (uint32 valueBefore, uint32 valueAfter, uint48 effect) {\\n        uint112 raw = Delay.unwrap(self);\\n\\n        valueAfter = uint32(raw);\\n        valueBefore = uint32(raw >> 32);\\n        effect = uint48(raw >> 64);\\n\\n        return (valueBefore, valueAfter, effect);\\n    }\\n\\n    /**\\n     * @dev pack the components into a Delay object.\\n     */\\n    function pack(uint32 valueBefore, uint32 valueAfter, uint48 effect) internal pure returns (Delay) {\\n        return Delay.wrap((uint112(effect) << 64) | (uint112(valueBefore) << 32) | uint112(valueAfter));\\n    }\\n}\\n\",\"keccak256\":\"0x36776530f012618bc7526ceb28e77b85e582cb12d9b9466a71d4bd6bf952e4cc\",\"license\":\"MIT\"},\"contracts/helpers/BaseHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { AccessManaged } from \\\"../utils/AccessManaged.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport \\\"contracts/interfaces/IHarvester.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nstruct YieldBearingParams {\\n  // Address of the asset used to mint the yield bearing asset\\n  address asset;\\n  // Target exposure to the collateral yield bearing asset used\\n  uint64 targetExposure;\\n  // Maximum exposure within the Parallelizer to the deposit asset\\n  uint64 maxExposure;\\n  // Minimum exposure within the Parallelizer to the deposit asset\\n  uint64 minExposure;\\n  // Whether limit exposures should be overriden or read onchain through the Parallelizer\\n  // This value should be 1 to override exposures or 2 if these shouldn't be overriden\\n  uint64 overrideExposures;\\n  // Maximum slippage when dealing with the Parallelizer\\n  uint96 maxSlippage;\\n}\\n\\n/// @title BaseHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Abstract contract for a harvester that aims at rebalancing a Parallelizer\\n/// @dev This contract is an authorized fork of Angle's BaseHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol\\nabstract contract BaseHarvester is IHarvester, AccessManaged {\\n  using SafeERC20 for IERC20;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       MODIFIERS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrusted() {\\n    if (!isTrusted[msg.sender]) revert NotTrusted();\\n    _;\\n  }\\n\\n  /**\\n   * @notice Checks whether the `msg.sender` is trusted or guardian to update\\n   * target exposure and do others non critical operations\\n   */\\n  modifier onlyTrustedOrRestricted() {\\n    if (!isTrusted[msg.sender] && !_checkCanCall(_msgSender(), _msgData())) {\\n      revert NotTrustedOrGuardian();\\n    }\\n    _;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       VARIABLES\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Reference to the `parallelizer` implementation this contract aims at rebalancing\\n  IParallelizer public immutable parallelizer;\\n  /// @notice TokenP handled by the `parallelizer` of interest\\n  ITokenP public immutable tokenP;\\n  /// @notice Max slippage when dealing with the Parallelizer\\n  mapping(address => uint96) public maxTokenSlippage;\\n  /// @notice Data associated to a yield bearing asset\\n  mapping(address => YieldBearingParams) public yieldBearingData;\\n  /// @notice trusted addresses that can update target exposure and do others non critical operations\\n  mapping(address => bool) public isTrusted;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EVENTS                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  event Recovered(address token, uint256 amount, address to);\\n  event TrustedToggled(address trusted, bool status);\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                       CONSTRUCTOR\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialAuthority,\\n    ITokenP definitiveTokenP,\\n    IParallelizer definitiveParallelizer\\n  )\\n    AccessManaged(initialAuthority)\\n  {\\n    tokenP = definitiveTokenP;\\n    parallelizer = definitiveParallelizer;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        GUARDIAN FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the yieldBearingAsset data\\n   * @param yieldBearingAsset address of the yieldBearingAsset\\n   * @param asset address of the asset\\n   * @param targetExposure target exposure to the yieldBearingAsset asset used\\n   * @param minExposure minimum exposure within the Parallelizer to the asset\\n   * @param maxExposure maximum exposure within the Parallelizer to the asset\\n   * @param overrideExposures whether limit exposures should be overriden or read onchain through the Parallelizer\\n   */\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external\\n    restricted\\n  {\\n    _setYieldBearingAssetData(\\n      yieldBearingAsset, asset, targetExposure, minExposure, maxExposure, overrideExposures, maxSlippage\\n    );\\n  }\\n\\n  /**\\n   * @notice Set the limit exposures to the asset linked to the yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   */\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) public virtual {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    if (yieldBearingInfo.overrideExposures == 2) {\\n      _updateLimitExposuresYieldAsset(yieldBearingInfo.asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  /**\\n   * @notice Set the max allowed slippage\\n   * @param newMaxSlippage new max allowed slippage\\n   */\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external restricted {\\n    _setMaxSlippage(yieldBearingAsset, newMaxSlippage);\\n  }\\n\\n  /**\\n   * @notice Toggle the trusted status of an address\\n   * @param trusted address to toggle the trusted status\\n   */\\n  function toggleTrusted(address trusted) external restricted {\\n    emit TrustedToggled(trusted, isTrusted[trusted]);\\n    isTrusted[trusted] = !isTrusted[trusted];\\n  }\\n\\n  /**\\n   * @notice Recover ERC20 tokens\\n   * @param tokenAddress address of the token to recover\\n   * @param amountToRecover amount to recover\\n   * @param to address to send the recovered tokens\\n   */\\n  function recoverERC20(address tokenAddress, uint256 amountToRecover, address to) external restricted {\\n    emit Recovered(tokenAddress, amountToRecover, to);\\n    IERC20(tokenAddress).safeTransfer(to, amountToRecover);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        TRUSTED FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the target exposure of a yield bearing asset\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @param targetExposure target exposure to the yield bearing asset used\\n   */\\n  function setTargetExposure(address yieldBearingAsset, uint64 targetExposure) external onlyTrustedOrRestricted {\\n    yieldBearingData[yieldBearingAsset].targetExposure = targetExposure;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        VIEW FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Compute the amount needed to rebalance the Parallelizer\\n   * @param yieldBearingAsset address of the yield bearing asset\\n   * @return increase whether the exposure should be increased\\n   * @return amount amount to be rebalanced\\n   */\\n  function computeRebalanceAmount(address yieldBearingAsset) external view returns (uint8 increase, uint256 amount) {\\n    return _computeRebalanceAmount(yieldBearingAsset, yieldBearingData[yieldBearingAsset]);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        INTERNAL FUNCTIONS\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _computeRebalanceAmount(\\n    address yieldBearingAsset,\\n    YieldBearingParams memory yieldBearingInfo\\n  )\\n    internal\\n    view\\n    returns (uint8 increase, uint256 amount)\\n  {\\n    (uint256 stablecoinsFromYieldBearingAsset, uint256 stablecoinsIssued) =\\n      parallelizer.getIssuedByCollateral(yieldBearingAsset);\\n    (uint256 stablecoinsFromAsset,) = parallelizer.getIssuedByCollateral(yieldBearingInfo.asset);\\n    uint256 targetExposureScaled = yieldBearingInfo.targetExposure * stablecoinsIssued;\\n    if (stablecoinsFromYieldBearingAsset * 1e9 > targetExposureScaled) {\\n      // Need to decrease exposure to yield bearing asset\\n      amount = stablecoinsFromYieldBearingAsset - targetExposureScaled / 1e9;\\n      uint256 maxValueScaled = yieldBearingInfo.maxExposure * stablecoinsIssued;\\n      // These checks assume that there are no transaction fees on the stablecoin->collateral conversion and so\\n      // it's still possible that exposure goes above the max exposure in some rare cases\\n      if (stablecoinsFromAsset * 1e9 > maxValueScaled) {\\n        amount = 0;\\n      } else if ((stablecoinsFromAsset + amount) * 1e9 > maxValueScaled) {\\n        amount = maxValueScaled / 1e9 - stablecoinsFromAsset;\\n      }\\n    } else {\\n      // In this case, exposure after the operation might remain slightly below the targetExposure as less\\n      // collateral may be obtained by burning stablecoins for the yield asset and unwrapping it\\n      increase = 1;\\n      amount = targetExposureScaled / 1e9 - stablecoinsFromYieldBearingAsset;\\n      uint256 minValueScaled = yieldBearingInfo.minExposure * stablecoinsIssued;\\n      if (stablecoinsFromAsset * 1e9 < minValueScaled) {\\n        amount = 0;\\n      } else if (stablecoinsFromAsset * 1e9 < minValueScaled + amount * 1e9) {\\n        amount = stablecoinsFromAsset - minValueScaled / 1e9;\\n      }\\n    }\\n  }\\n\\n  function _setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address asset,\\n    uint64 targetExposure,\\n    uint64 minExposure,\\n    uint64 maxExposure,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    internal\\n    virtual\\n  {\\n    YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    yieldBearingInfo.asset = asset;\\n    if (targetExposure >= 1e9) revert InvalidParam();\\n    if (maxSlippage >= 1e9) revert InvalidParam();\\n    yieldBearingInfo.targetExposure = targetExposure;\\n    yieldBearingInfo.overrideExposures = overrideExposures;\\n    yieldBearingInfo.maxSlippage = maxSlippage;\\n    if (overrideExposures == 1) {\\n      if (maxExposure >= 1e9 || minExposure >= maxExposure) revert InvalidParam();\\n      yieldBearingInfo.maxExposure = maxExposure;\\n      yieldBearingInfo.minExposure = minExposure;\\n    } else {\\n      yieldBearingInfo.overrideExposures = 2;\\n      _updateLimitExposuresYieldAsset(asset, yieldBearingInfo);\\n    }\\n  }\\n\\n  function _updateLimitExposuresYieldAsset(\\n    address asset,\\n    YieldBearingParams storage yieldBearingInfo\\n  )\\n    internal\\n    virtual\\n  {\\n    uint64[] memory xFeeMint;\\n    (xFeeMint,) = parallelizer.getCollateralMintFees(asset);\\n    uint256 length = xFeeMint.length;\\n    if (length <= 1) yieldBearingInfo.maxExposure = 1e9;\\n    else yieldBearingInfo.maxExposure = xFeeMint[length - 2];\\n\\n    uint64[] memory xFeeBurn;\\n    (xFeeBurn,) = parallelizer.getCollateralBurnFees(asset);\\n    length = xFeeBurn.length;\\n    if (length <= 1) yieldBearingInfo.minExposure = 0;\\n    else yieldBearingInfo.minExposure = xFeeBurn[length - 2];\\n  }\\n\\n  function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {\\n    if (newMaxSlippage > 1e9) revert InvalidParam();\\n    maxTokenSlippage[yieldBearingAsset] = newMaxSlippage;\\n  }\\n\\n  function _scaleAmountBasedOnDecimals(\\n    uint256 decimalsTokenIn,\\n    uint256 decimalsTokenOut,\\n    uint256 amountIn,\\n    bool assetIn\\n  )\\n    internal\\n    pure\\n    returns (uint256)\\n  {\\n    if (decimalsTokenIn > decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn /= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      } else {\\n        amountIn *= 10 ** (decimalsTokenIn - decimalsTokenOut);\\n      }\\n    } else if (decimalsTokenIn < decimalsTokenOut) {\\n      if (assetIn) {\\n        amountIn *= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      } else {\\n        amountIn /= 10 ** (decimalsTokenOut - decimalsTokenIn);\\n      }\\n    }\\n    return amountIn;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    HELPER                                                      \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  function _adjustAllowance(address token, address sender, uint256 amountIn) internal {\\n    uint256 allowance = IERC20(token).allowance(address(this), sender);\\n    if (allowance < amountIn) IERC20(token).safeIncreaseAllowance(sender, type(uint256).max - allowance);\\n  }\\n}\\n\",\"keccak256\":\"0x82e2ae57997043160d7529488b34591c710cd74e267213b61009daa96e9eeaaf\",\"license\":\"GPL-3.0\"},\"contracts/helpers/GenericHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { SafeCast } from \\\"@openzeppelin/contracts/utils/math/SafeCast.sol\\\";\\nimport { SafeERC20 } from \\\"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\\\";\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IERC20Metadata } from \\\"@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol\\\";\\nimport { IERC3156FlashBorrower } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol\\\";\\nimport { IERC3156FlashLender } from \\\"@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol\\\";\\nimport { RouterSwapper } from \\\"@helpers/RouterSwapper.sol\\\";\\n\\nimport { IParallelizer } from \\\"contracts/interfaces/IParallelizer.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\nimport { IERC4626 } from \\\"contracts/interfaces/external/IERC4626.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\nimport { BaseHarvester, YieldBearingParams } from \\\"./BaseHarvester.sol\\\";\\n\\nenum SwapType {\\n  VAULT,\\n  SWAP\\n}\\n\\n/// @title GenericHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Generic contract for anyone to permissionlessly adjust the reserves of Angle Parallelizer\\n/// @dev This contract is an authorized fork of Angle's GenericHarvester contract:\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol\\ncontract GenericHarvester is BaseHarvester, IERC3156FlashBorrower, RouterSwapper {\\n  using SafeCast for uint256;\\n  using SafeERC20 for IERC20;\\n\\n  bytes32 public constant CALLBACK_SUCCESS = keccak256(\\\"ERC3156FlashBorrower.onFlashLoan\\\");\\n\\n  /// @notice Parallel stablecoin flashloan contract\\n  IERC3156FlashLender public immutable flashloan;\\n  /// @notice Budget of tokenP available for each users\\n  mapping(address => uint256) public budget;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INITIALIZATION                                                  \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  constructor(\\n    address initialTokenTransferAddress,\\n    address initialSwapRouter,\\n    ITokenP definitivetokenP,\\n    IParallelizer definitiveParallelizer,\\n    address initialAuthority,\\n    IERC3156FlashLender definitiveFlashloan\\n  )\\n    RouterSwapper(initialSwapRouter, initialTokenTransferAddress)\\n    BaseHarvester(initialAuthority, definitivetokenP, definitiveParallelizer)\\n  {\\n    if (address(definitiveFlashloan) == address(0)) revert ZeroAddress();\\n    flashloan = definitiveFlashloan;\\n\\n    IERC20(tokenP).approve(address(definitiveFlashloan), type(uint256).max);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        BUDGET HANDLING\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Add budget to be spent by the receiver during the flashloan\\n   * @param amount amount of tokenP to add to the budget\\n   * @param receiver address of the receiver\\n   */\\n  function addBudget(uint256 amount, address receiver) public virtual {\\n    budget[receiver] += amount;\\n\\n    IERC20(tokenP).safeTransferFrom(msg.sender, address(this), amount);\\n  }\\n\\n  /**\\n   * @notice Remove budget from the owner and send it to the receiver\\n   * @param amount amount of tokenP to remove from the budget\\n   * @param receiver address of the receiver\\n   */\\n  function removeBudget(uint256 amount, address receiver) public virtual {\\n    budget[msg.sender] -= amount; // Will revert if not enough funds\\n\\n    IERC20(tokenP).safeTransfer(receiver, amount);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        HARVEST\\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure\\n  ///  to this yieldBearingAsset\\n  /// @dev This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up\\n  /// some yieldBearingAsset that can then be used for people looking to burn deposit tokens\\n  /// @dev Due to potential transaction fees within the Parallelizer, this function doesn't exactly bring\\n  /// `yieldBearingAsset` to the target exposure\\n  /// @dev scale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest,\\n  /// it is used to lower the amount of the asset to harvest for example to have a lower slippage\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) public virtual {\\n    if (scale > 1e9) revert InvalidParam();\\n    updateLimitExposuresYieldAsset(yieldBearingAsset);\\n    YieldBearingParams memory yieldBearingInfo = yieldBearingData[yieldBearingAsset];\\n    (uint8 increase, uint256 amount) = _computeRebalanceAmount(yieldBearingAsset, yieldBearingInfo);\\n    amount = (amount * scale) / 1e9;\\n    if (amount == 0) revert ZeroAmount();\\n    (SwapType swapType, bytes memory data) = abi.decode(extraData, (SwapType, bytes));\\n    try parallelizer.updateOracle(yieldBearingAsset) { } catch { }\\n    _adjustYieldExposure(\\n      amount,\\n      increase,\\n      yieldBearingAsset,\\n      yieldBearingInfo.asset,\\n      (amount * (1e9 - yieldBearingInfo.maxSlippage)) / 1e9,\\n      swapType,\\n      data\\n    );\\n  }\\n\\n  /// @inheritdoc IERC3156FlashBorrower\\n  function onFlashLoan(\\n    address initiator,\\n    address,\\n    uint256 amount,\\n    uint256 fee,\\n    bytes calldata data\\n  )\\n    public\\n    virtual\\n    returns (bytes32)\\n  {\\n    if (msg.sender != address(flashloan) || initiator != address(this) || fee != 0) revert NotTrusted();\\n    address sender;\\n    uint256 typeAction;\\n    uint256 minAmountOut;\\n    SwapType swapType;\\n    bytes memory callData;\\n    address tokenOut;\\n    address tokenIn;\\n    {\\n      address yieldBearingAsset;\\n      address asset;\\n      (sender, typeAction, yieldBearingAsset, asset, minAmountOut, swapType, callData) =\\n        abi.decode(data, (address, uint256, address, address, uint256, SwapType, bytes));\\n      if (typeAction == 1) {\\n        // Increase yield exposure action: we bring in the yield bearing asset\\n        tokenOut = yieldBearingAsset;\\n        tokenIn = asset;\\n      } else {\\n        // Decrease yield exposure action: we bring in the deposit asset\\n        tokenIn = yieldBearingAsset;\\n        tokenOut = asset;\\n      }\\n    }\\n    uint256 amountOut =\\n      parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);\\n\\n    // Swap to tokenIn\\n    amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);\\n\\n    _adjustAllowance(tokenOut, address(parallelizer), amountOut);\\n    uint256 amountStableOut =\\n      parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);\\n    if (amount > amountStableOut) {\\n      budget[sender] -= amount - amountStableOut; // Will revert if not enough funds\\n    }\\n    return CALLBACK_SUCCESS;\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    SETTERS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /**\\n   * @notice Set the token transfer address\\n   * @param newTokenTransferAddress address of the token transfer contract\\n   */\\n  function setTokenTransferAddress(address newTokenTransferAddress) public override restricted {\\n    super.setTokenTransferAddress(newTokenTransferAddress);\\n  }\\n\\n  /**\\n   * @notice Set the swap router\\n   * @param newSwapRouter address of the swap router\\n   */\\n  function setSwapRouter(address newSwapRouter) public override restricted {\\n    super.setSwapRouter(newSwapRouter);\\n  }\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    INTERNALS                                                     \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Burns `amountStablecoins` for one yieldBearing asset, swap for asset then mints deposit tokens\\n  /// from the proceeds of the swap.\\n  /// @dev If `increase` is 1, then the system tries to increase its exposure to the yield bearing asset which means\\n  /// burning tokenP for the deposit asset, swapping for the yield bearing asset, then minting the tokenP\\n  /// @dev This function reverts if the second tokenP mint gives less than `minAmountOut` of ag tokens\\n  /// @dev This function reverts if the swap slippage is higher than `maxSlippage`\\n  function _adjustYieldExposure(\\n    uint256 amountStablecoins,\\n    uint8 increase,\\n    address yieldBearingAsset,\\n    address asset,\\n    uint256 minAmountOut,\\n    SwapType swapType,\\n    bytes memory extraData\\n  )\\n    internal\\n  {\\n    flashloan.flashLoan(\\n      IERC3156FlashBorrower(address(this)),\\n      address(tokenP),\\n      amountStablecoins,\\n      abi.encode(msg.sender, increase, yieldBearingAsset, asset, minAmountOut, swapType, extraData)\\n    );\\n  }\\n\\n  function _swapToTokenOut(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    SwapType swapType,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (swapType == SwapType.SWAP) {\\n      amountOut = _swapToTokenOutSwap(tokenIn, tokenOut, amount, callData);\\n    } else if (swapType == SwapType.VAULT) {\\n      amountOut = _swapToTokenOutVault(typeAction, tokenIn, tokenOut, amount);\\n    }\\n  }\\n\\n  /**\\n   * @notice Swap token using the router/aggregator\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   * @param callData bytes to call the router/aggregator\\n   */\\n  function _swapToTokenOutSwap(\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount,\\n    bytes memory callData\\n  )\\n    internal\\n    returns (uint256)\\n  {\\n    uint256 balance = IERC20(tokenOut).balanceOf(address(this));\\n\\n    address[] memory tokens = new address[](1);\\n    tokens[0] = tokenIn;\\n    bytes[] memory callDatas = new bytes[](1);\\n    callDatas[0] = callData;\\n    uint256[] memory amounts = new uint256[](1);\\n    amounts[0] = amount;\\n    _swap(tokens, callDatas, amounts);\\n\\n    return IERC20(tokenOut).balanceOf(address(this)) - balance;\\n  }\\n\\n  /**\\n   * @dev Deposit or redeem the vault asset\\n   * @param typeAction 1 for deposit, 2 for redeem\\n   * @param tokenIn address of the token to swap\\n   * @param tokenOut address of the token to receive\\n   * @param amount amount of token to swap\\n   */\\n  function _swapToTokenOutVault(\\n    uint256 typeAction,\\n    address tokenIn,\\n    address tokenOut,\\n    uint256 amount\\n  )\\n    internal\\n    returns (uint256 amountOut)\\n  {\\n    if (typeAction == 1) {\\n      // Granting allowance with the yieldBearingAsset for the vault asset\\n      _adjustAllowance(tokenIn, tokenOut, amount);\\n      amountOut = IERC4626(tokenOut).deposit(amount, address(this));\\n    } else {\\n      amountOut = IERC4626(tokenIn).redeem(amount, address(this), address(this));\\n    }\\n  }\\n}\\n\",\"keccak256\":\"0x604c4f9c755b2eb704dc15ba59046201c0258134ef2fbe15a529c510c68cb40a\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IDiamondCut.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IDiamondCut\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondCut.sol by mudgen\\n/// @dev This interface is an authorized fork of Angle's `IDiamondCut` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IDiamondCut.sol\\ninterface IDiamondCut {\\n  /// @notice Add/replace/remove any number of functions and optionally execute a function with delegatecall\\n  /// @param _diamondCut Contains the facet addresses and function selectors\\n  /// @param _init The address of the contract or facet to execute _calldata\\n  /// @param _calldata A function call, including function selector and arguments, executed with delegatecall on\\n  /// _init\\n  function diamondCut(FacetCut[] calldata _diamondCut, address _init, bytes calldata _calldata) external;\\n}\\n\",\"keccak256\":\"0x08a01f77b740f7da424f0ea27a6a292f9e292058e23d1fe960d2d19a44496c7b\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondEtherscan.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\n/// @title IDiamondEtherscan\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface IDiamondEtherscan {\\n  /// @notice Sets a dummy implementation with the same layout at the diamond proxy contract with all its facets\\n  function setDummyImplementation(address _implementation) external;\\n\\n  /// @notice Address of the dummy implementation used to make the DiamondProxy contract interpretable by Etherscan\\n  function implementation() external view returns (address);\\n}\\n\",\"keccak256\":\"0xf742b55592d129e02fb755d25f7a97ed976a14c4c744d6ac46726809e8f1e037\",\"license\":\"MIT\"},\"contracts/interfaces/IDiamondLoupe.sol\":{\"content\":\"// SPDX-License-Identifier: MIT\\npragma solidity 0.8.28;\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @notice IDiamondLoupe\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Reference: EIP-2535 Diamonds\\n/// @dev Forked from https://github.com/mudgen/diamond-3/blob/master/contracts/interfaces/IDiamondLoupe.sol by mudgen\\ninterface IDiamondLoupe {\\n  /// @notice Gets all facet addresses and their four byte function selectors.\\n  /// @return facets_ Facet\\n  function facets() external view returns (Facet[] memory facets_);\\n\\n  /// @notice Gets all the function selectors supported by a specific facet.\\n  /// @param _facet The facet address.\\n  /// @return facetFunctionSelectors_\\n  function facetFunctionSelectors(address _facet) external view returns (bytes4[] memory facetFunctionSelectors_);\\n\\n  /// @notice Get all the facet addresses used by a diamond.\\n  /// @return facetAddresses_\\n  function facetAddresses() external view returns (address[] memory facetAddresses_);\\n\\n  /// @notice Gets the facet that supports the given selector.\\n  /// @dev If facet is not found return address(0).\\n  /// @param _functionSelector The function selector.\\n  /// @return facetAddress_ The facet address.\\n  function facetAddress(bytes4 _functionSelector) external view returns (address facetAddress_);\\n}\\n\",\"keccak256\":\"0xa5580958acabe2c44967e835e77a748eb0b8812f70cd071191201508c9388ca8\",\"license\":\"MIT\"},\"contracts/interfaces/IGetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title IGetters\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IGetters` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IGetters.sol\\ninterface IGetters {\\n  /// @notice Checks whether a given `selector` is actually a valid selector corresponding to a function in one of\\n  /// the\\n  /// facets of the proxy\\n  function isValidSelector(bytes4 selector) external view returns (bool);\\n\\n  /// @notice Stablecoin minted by parallelizer\\n  function tokenP() external view returns (ITokenP);\\n\\n  /// @notice Returns the list of collateral assets supported by the system\\n  function getCollateralList() external view returns (address[] memory);\\n\\n  /// @notice Returns all the info in storage associated to a `collateral`\\n  function getCollateralInfo(address collateral) external view returns (Collateral memory);\\n\\n  /// @notice Returns the decimals of a given `collateral`\\n  function getCollateralDecimals(address collateral) external view returns (uint8);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to mint\\n  /// with `collateral`\\n  function getCollateralMintFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays from which fees are computed when coming to burn\\n  /// for `collateral`\\n  function getCollateralBurnFees(address collateral) external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the `xFee` and `yFee` arrays used to compute the penalty factor depending on the collateral\\n  /// ratio when users come to redeem\\n  function getRedemptionFees() external view returns (uint64[] memory, int64[] memory);\\n\\n  /// @notice Returns the collateral ratio of Parallelizer in base `10**9` and a rounded version of the total amount\\n  /// of stablecoins issued\\n  function getCollateralRatio() external view returns (uint64 collatRatio, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the total amount of stablecoins issued through Parallelizer\\n  function getTotalIssued() external view returns (uint256 stablecoinsIssued);\\n\\n  /// @notice Returns the amount of stablecoins issued from `collateral` and the total amount of stablecoins issued\\n  /// through Parallelizer\\n  function getIssuedByCollateral(address collateral)\\n    external\\n    view\\n    returns (uint256 stablecoinsFromCollateral, uint256 stablecoinsIssued);\\n\\n  /// @notice Returns if a collateral is \\\"managed\\\" and the associated manager configuration\\n  function getManagerData(address collateral)\\n    external\\n    view\\n    returns (bool isManaged, IERC20[] memory subCollaterals, bytes memory config);\\n\\n  /// @notice Returns the oracle values associated to `collateral`\\n  /// @return mint Oracle value to be used for a mint transaction with `collateral`\\n  /// @return burn Oracle value that will be used for `collateral` for a burn transaction. This value\\n  /// is then used along with oracle values for all other collateral assets to get a global burn value for the oracle\\n  /// @return ratio Ratio, in base `10**18` between the oracle value of the `collateral` and its target price.\\n  /// This value is 10**18 if the oracle is greater than the collateral price\\n  /// @return minRatio Minimum ratio across all collateral assets between a collateral burn price and its target\\n  /// price. This value is independent of `collateral` and is used to normalize the burn oracle value for burn\\n  /// transactions.\\n  /// @return redemption Oracle value that would be used to price `collateral` when computing the collateral ratio\\n  /// during a redemption\\n  function getOracleValues(address collateral)\\n    external\\n    view\\n    returns (uint256 mint, uint256 burn, uint256 ratio, uint256 minRatio, uint256 redemption);\\n\\n  /// @notice Returns the data used to compute oracle values for `collateral`\\n  /// @return oracleType Type of oracle (Chainlink, external smart contract, ...)\\n  /// @return targetType Type passed to read the value of the target price\\n  /// @return oracleData Extra data needed to read the oracle. For Chainlink oracles, this data is supposed to give\\n  /// the addresses of the Chainlink feeds to read, the stale periods for each feed, ...\\n  /// @return targetData Extra data needed to read the target price of the asset\\n  function getOracle(address collateral)\\n    external\\n    view\\n    returns (\\n      OracleReadType oracleType,\\n      OracleReadType targetType,\\n      bytes memory oracleData,\\n      bytes memory targetData,\\n      bytes memory hyperparameters\\n    );\\n\\n  /// @notice Returns if the associated functionality is paused or not\\n  function isPaused(address collateral, ActionType action) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update normalizers\\n  function isTrusted(address sender) external view returns (bool);\\n\\n  /// @notice Returns if `sender` is trusted to update sell rewards\\n  function isTrustedSeller(address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` has a non null entry in the `isWhitelistedForType` storage mapping\\n  /// @dev Note that ultimately whitelisting may depend as well on external providers\\n  function isWhitelistedForType(WhitelistType whitelistType, address sender) external view returns (bool);\\n\\n  /// @notice Checks whether `sender` can deal with `collateral` during burns and redemptions\\n  function isWhitelistedForCollateral(address collateral, address sender) external returns (bool);\\n\\n  /// @notice Checks whether only whitelisted address can deal with `collateral` during burns and redemptions\\n  function isWhitelistedCollateral(address collateral) external view returns (bool);\\n\\n  /// @notice Gets the data needed to deal with whitelists for `collateral`\\n  function getCollateralWhitelistData(address collateral) external view returns (bytes memory);\\n\\n  /// @notice Returns the stablecoin cap for `collateral`\\n  function getStablecoinCap(address collateral) external view returns (uint256);\\n\\n  /// @notice Returns the address of the `accessManager` contract\\n  function accessManager() external view returns (address);\\n\\n  /// @dev Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is\\n  /// being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs\\n  /// attacker controlled calls.\\n  function isConsumingScheduledOp() external view returns (bytes4);\\n}\\n\",\"keccak256\":\"0xaa9eba6ee7770d6146fedbfef07ad10ff09524692319ca0cc32abfa64a2b597b\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IHarvester.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IHarvester\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IHarvester` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IHarvester.sol\\ninterface IHarvester {\\n  function setYieldBearingAssetData(\\n    address yieldBearingAsset,\\n    address stablecoin,\\n    uint64 targetExposure,\\n    uint64 minExposureYieldAsset,\\n    uint64 maxExposureYieldAsset,\\n    uint64 overrideExposures,\\n    uint96 maxSlippage\\n  )\\n    external;\\n\\n  function updateLimitExposuresYieldAsset(address yieldBearingAsset) external;\\n\\n  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external;\\n\\n  function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) external;\\n}\\n\",\"keccak256\":\"0x0d4e8fee737f4f747060a3c5044c8cb2f153faa228ad37a661a659ca62aab055\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IParallelizer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IDiamondCut } from \\\"./IDiamondCut.sol\\\";\\nimport { IDiamondEtherscan } from \\\"./IDiamondEtherscan.sol\\\";\\nimport { IDiamondLoupe } from \\\"./IDiamondLoupe.sol\\\";\\nimport { IGetters } from \\\"./IGetters.sol\\\";\\nimport { IRedeemer } from \\\"./IRedeemer.sol\\\";\\nimport { IRewardHandler } from \\\"./IRewardHandler.sol\\\";\\nimport { ISettersGovernor, ISettersGuardian } from \\\"./ISetters.sol\\\";\\nimport { ISwapper } from \\\"./ISwapper.sol\\\";\\n\\n/// @title IParallelizer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IParallelizer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IParallelizer.sol\\ninterface IParallelizer is\\n  IDiamondCut,\\n  IDiamondEtherscan,\\n  IDiamondLoupe,\\n  IGetters,\\n  IRedeemer,\\n  IRewardHandler,\\n  ISettersGovernor,\\n  ISettersGuardian,\\n  ISwapper\\n{ }\\n\",\"keccak256\":\"0x8bd964110c6a122bdb6cf58a194a97c894900237ebd7f3b11e2f43c6ee56ae7c\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRedeemer.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRedeemer\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRedeemer` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRedeemer.sol\\ninterface IRedeemer {\\n  /// @notice Redeems `amount` of stablecoins from the system\\n  /// @param receiver Address which should be receiving the output tokens\\n  /// @param deadline Timestamp before which the redemption should have occured\\n  /// @param minAmountOuts Minimum amount of each token given back in the redemption to obtain\\n  /// @return tokens List of tokens returned\\n  /// @return amounts Amount given for each token in the `tokens` array\\n  function redeem(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Same as the redeem function above with the additional feature to specify a list of `forfeitTokens` for\\n  /// which the Parallelizer system will not try to do a transfer to `receiver`.\\n  function redeemWithForfeit(\\n    uint256 amount,\\n    address receiver,\\n    uint256 deadline,\\n    uint256[] memory minAmountOuts,\\n    address[] memory forfeitTokens\\n  )\\n    external\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Simulate the exact output that a redemption of `amount` of stablecoins would give at a given block\\n  /// @return tokens List of tokens that would be given\\n  /// @return amounts Amount that would be obtained for each token in the `tokens` array\\n  function quoteRedemptionCurve(uint256 amount)\\n    external\\n    view\\n    returns (address[] memory tokens, uint256[] memory amounts);\\n\\n  /// @notice Updates the normalizer variable by `amount`\\n  function updateNormalizer(uint256 amount, bool increase) external returns (uint256);\\n}\\n\",\"keccak256\":\"0xb3522ee0380b321c64d02bf2db2acb658d8b314b811dd54b6a718d6708b5fb21\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/IRewardHandler.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title IRewardHandler\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `IRewardHandler` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRewardHandler.sol\\ninterface IRewardHandler {\\n  /// @notice Sells some external tokens through a odos call\\n  /// @param minAmountOut Minimum amount of the outToken to get\\n  /// @param payload Payload to pass to odos\\n  /// @return amountOut Amount obtained of the outToken\\n  function sellRewards(uint256 minAmountOut, bytes memory payload) external returns (uint256 amountOut);\\n}\\n\",\"keccak256\":\"0xff2afcbc8d1c25297324159d3684a323e60b3c9408129aba70d3d6938d093255\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISetters.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/interfaces/IERC20.sol\\\";\\n\\nimport \\\"../parallelizer/Storage.sol\\\";\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISettersGovernor` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISetters.sol\\ninterface ISettersGovernor {\\n  /// @notice Recovers `amount` of `token` from the Parallelizer contract\\n  function recoverERC20(address collateral, IERC20 token, address to, uint256 amount) external;\\n\\n  /// @notice Sets a new access manager address\\n  function setAccessManager(address _newAccessManager) external;\\n\\n  /// @notice Sets (or unsets) a collateral manager  `collateral`\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before setting the new manager\\n  function setCollateralManager(\\n    address collateral,\\n    bool checkExternalManagerBalance,\\n    ManagerStorage memory managerData\\n  )\\n    external;\\n\\n  /// @notice Sets the allowance of the contract on `token` for `spender` to `amount`\\n  function changeAllowance(IERC20 token, address spender, uint256 amount) external;\\n\\n  /// @notice Changes the trusted status for `sender` when for selling rewards or updating the normalizer\\n  function toggleTrusted(address sender, TrustedType t) external;\\n\\n  /// @notice Changes whether a `collateral` can only be handled during burns and redemptions by whitelisted\\n  /// addresses\\n  /// and sets the data used to read into the whitelist\\n  function setWhitelistStatus(address collateral, uint8 whitelistStatus, bytes memory whitelistData) external;\\n\\n  /// @notice Add `collateral` as a supported collateral in the system\\n  function addCollateral(address collateral) external;\\n\\n  /// @notice Adjusts the amount of stablecoins issued from `collateral` by `amount`\\n  function adjustStablecoins(address collateral, uint128 amount, bool increase) external;\\n\\n  /// @notice Revokes `collateral` from the system\\n  /// @dev If `checkExternalManagerBalance` is true, the function will check that the current manager no longer has\\n  /// assets before revoking the collateral\\n  function revokeCollateral(address collateral, bool checkExternalManagerBalance) external;\\n\\n  /// @notice Sets the `oracleConfig` used to read the value of `collateral` for the mint, burn and redemption\\n  /// operations\\n  function setOracle(address collateral, bytes memory oracleConfig) external;\\n\\n  /// @notice Update oracle data for a given `collateral`\\n  function updateOracle(address collateral) external;\\n}\\n\\n/// @title ISettersGovernor\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\ninterface ISettersGuardian {\\n  /// @notice Changes the pause status for mint or burn transactions for `collateral`\\n  function togglePause(address collateral, ActionType action) external;\\n\\n  /// @notice Sets the mint or burn fees for `collateral`\\n  function setFees(address collateral, uint64[] memory xFee, int64[] memory yFee, bool mint) external;\\n\\n  /// @notice Sets the parameters for the redemption curve\\n  function setRedemptionCurveParams(uint64[] memory xFee, int64[] memory yFee) external;\\n\\n  /// @notice Changes the whitelist status for a collateral with `whitelistType` for an address `who`\\n  function toggleWhitelist(WhitelistType whitelistType, address who) external;\\n\\n  /// @notice Sets the stablecoin cap that can be issued from a `collateral`\\n  function setStablecoinCap(address collateral, uint256 stablecoinCap) external;\\n}\\n\",\"keccak256\":\"0xc3fb2012e7c2f97ae93b12276afc4293aaeb97a6fe4d60109acaa94ef6945575\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ISwapper.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\n/// @title ISwapper\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev This interface is an authorized fork of Angle's `ISwapper` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/ISwapper.sol\\ninterface ISwapper {\\n  /// @notice Swaps (that is to say mints or burns) an exact amount of `tokenIn` for an amount of `tokenOut`\\n  /// @param amountIn Amount of `tokenIn` to bring\\n  /// @param amountOutMin Minimum amount of `tokenOut` to get: if `amountOut` is inferior to this amount, the\\n  /// function will revert\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountOut Amount of `tokenOut` obtained through the swap\\n  function swapExactInput(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Same as `swapExactInput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactInputWithPermit(\\n    uint256 amountIn,\\n    uint256 amountOutMin,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountOut);\\n\\n  /// @notice Swaps (that is to say mints or burns) an amount of `tokenIn` for an exact amount of `tokenOut`\\n  /// @param amountOut Amount of `tokenOut` to obtain from the swap\\n  /// @param amountInMax Maximum amount of `tokenIn` to bring in order to get `amountOut` of `tokenOut`\\n  /// @param tokenIn Token to bring for the swap\\n  /// @param tokenOut Token to get out of the swap\\n  /// @param to Address to which `tokenOut` must be sent\\n  /// @param deadline Timestamp before which the transaction must be executed\\n  /// @return amountIn Amount of `tokenIn` used to perform the swap\\n  function swapExactOutput(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address tokenOut,\\n    address to,\\n    uint256 deadline\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Same as `swapExactOutput`, but using Permit2 signatures for `tokenIn`\\n  /// @dev Can only be used to mint, hence `tokenOut` is not needed\\n  function swapExactOutputWithPermit(\\n    uint256 amountOut,\\n    uint256 amountInMax,\\n    address tokenIn,\\n    address to,\\n    uint256 deadline,\\n    bytes calldata permitData\\n  )\\n    external\\n    returns (uint256 amountIn);\\n\\n  /// @notice Simulates what a call to `swapExactInput` with `amountIn` of `tokenIn` for `tokenOut` would give.\\n  /// If called right before and at the same block, the `amountOut` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactInput`\\n  function quoteIn(uint256 amountIn, address tokenIn, address tokenOut) external view returns (uint256 amountOut);\\n\\n  /// @notice Simulates what a call to `swapExactOutput` for `amountOut` of `tokenOut` with `tokenIn` would give.\\n  /// If called right before and at the same block, the `amountIn` outputted by this function is exactly the\\n  /// amount that will be obtained with `swapExactOutput`\\n  function quoteOut(uint256 amountOut, address tokenIn, address tokenOut) external view returns (uint256 amountIn);\\n}\\n\",\"keccak256\":\"0x47e4b2742a51b82b9df72fb681335affe8519f4114fb540cd29d8f48ed182ffd\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/ITokenP.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\n\\n/// @title ITokenP\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @notice Interface for the stablecoins `tokenP` contracts\\n/// @dev This interface is an authorized fork of Angle's `IAgToken` interface\\n/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IAgToken.sol\\ninterface ITokenP is IERC20 {\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    MINTER ROLE ONLY FUNCTIONS                                            \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Lets a whitelisted contract mint tokenPs\\n  /// @param account Address to mint to\\n  /// @param amount Amount to mint\\n  function mint(address account, uint256 amount) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address after being asked to by `sender`\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @param sender Address which requested the burn from `burner`\\n  /// @dev This method is to be called by a contract with the minter right after being requested\\n  /// to do so by a `sender` address willing to burn tokens from another `burner` address\\n  /// @dev The method checks the allowance between the `sender` and the `burner`\\n  function burnFrom(uint256 amount, address burner, address sender) external;\\n\\n  /// @notice Burns `amount` tokens from a `burner` address\\n  /// @param amount Amount of tokens to burn\\n  /// @param burner Address to burn from\\n  /// @dev This method is to be called by a contract with a minter right on the tokenP after being\\n  /// requested to do so by an address willing to burn tokens from its address\\n  function burnSelf(uint256 amount, address burner) external;\\n\\n  /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n    EXTERNAL FUNCTIONS                                                \\n  //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\n  /// @notice Amount of decimals of the stablecoin\\n  function decimals() external view returns (uint8);\\n}\\n\",\"keccak256\":\"0x64a1305faa8c5c91767a11af0eae16e4b463aa0bfe10f11b74aae9d96681a5eb\",\"license\":\"GPL-3.0\"},\"contracts/interfaces/external/IERC4626.sol\":{\"content\":\"// SPDX-License-Identifier: GPL-3.0\\n\\n// OpenZeppelin Contracts (last updated v4.7.0) (interfaces/IERC4626.sol)\\n\\npragma solidity >=0.5.0;\\n\\n/// @notice ERC4626 interface\\n/// @author OpenZeppelin\\n/// @dev In this implementation, the interface only contains the functions that the IERC4626 interface adds on top of\\n/// the IERC20 interface\\ninterface IERC4626 {\\n  /**\\n   * @dev Returns the address of the underlying token used for the Vault for accounting, depositing, and withdrawing.\\n   *\\n   * - MUST be an ERC-20 token contract.\\n   * - MUST NOT revert.\\n   */\\n  function asset() external view returns (address assetTokenAddress);\\n\\n  /**\\n   * @dev Returns the total amount of the underlying asset that is \\u201cmanaged\\u201d by Vault.\\n   *\\n   * - SHOULD include any compounding that occurs from yield.\\n   * - MUST be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT revert.\\n   */\\n  function totalAssets() external view returns (uint256 totalManagedAssets);\\n\\n  /**\\n   * @dev Returns the amount of shares that the Vault would exchange for the amount of assets provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToShares(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the amount of assets that the Vault would exchange for the amount of shares provided, in an ideal\\n   * scenario where all the conditions are met.\\n   *\\n   * - MUST NOT be inclusive of any fees that are charged against assets in the Vault.\\n   * - MUST NOT show any variations depending on the caller.\\n   * - MUST NOT reflect slippage or other on-chain conditions, when performing the actual exchange.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: This calculation MAY NOT reflect the \\u201cper-user\\u201d price-per-share, and instead should reflect the\\n   * \\u201caverage-user\\u2019s\\u201d price-per-share, meaning what the average user should expect to see when exchanging to and\\n   * from.\\n   */\\n  function convertToAssets(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be deposited into the Vault for the receiver,\\n   * through a deposit call.\\n   *\\n   * - MUST return a limited value if receiver is subject to some deposit limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of assets that may be deposited.\\n   * - MUST NOT revert.\\n   */\\n  function maxDeposit(address receiver) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their deposit at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of Vault shares that would be minted in a deposit\\n   *   call in the same transaction. I.e. deposit should return the same or more shares as previewDeposit if called\\n   *   in the same transaction.\\n   * - MUST NOT account for deposit limits like those returned from maxDeposit and should always act as though the\\n   *   deposit would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewDeposit SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewDeposit(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Mints shares Vault shares to receiver by depositing exactly amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   deposit execution, and are accounted for during deposit.\\n   * - MUST revert if all of assets cannot be deposited (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function deposit(uint256 assets, address receiver) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of the Vault shares that can be minted for the receiver, through a mint call.\\n   * - MUST return a limited value if receiver is subject to some mint limit.\\n   * - MUST return 2 ** 256 - 1 if there is no limit on the maximum amount of shares that may be minted.\\n   * - MUST NOT revert.\\n   */\\n  function maxMint(address receiver) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their mint at the current block, given\\n   * current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of assets that would be deposited in a mint call\\n   *   in the same transaction. I.e. mint should return the same or fewer assets as previewMint if called in the\\n   *   same transaction.\\n   * - MUST NOT account for mint limits like those returned from maxMint and should always act as though the mint\\n   *   would be accepted, regardless if the user has enough tokens approved, etc.\\n   * - MUST be inclusive of deposit fees. Integrators should be aware of the existence of deposit fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewMint SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by minting.\\n   */\\n  function previewMint(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Mints exactly shares Vault shares to receiver by depositing amount of underlying tokens.\\n   *\\n   * - MUST emit the Deposit event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the mint\\n   *   execution, and are accounted for during mint.\\n   * - MUST revert if all of shares cannot be minted (due to deposit limit being reached, slippage, the user not\\n   *   approving enough underlying tokens to the Vault contract, etc).\\n   *\\n   * NOTE: most implementations will require pre-approval of the Vault with the Vault\\u2019s underlying asset token.\\n   */\\n  function mint(uint256 shares, address receiver) external returns (uint256 assets);\\n\\n  /**\\n   * @dev Returns the maximum amount of the underlying asset that can be withdrawn from the owner balance in the\\n   * Vault, through a withdraw call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxWithdraw(address owner) external view returns (uint256 maxAssets);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their withdrawal at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no fewer than the exact amount of Vault shares that would be burned in a withdraw\\n   *   call in the same transaction. I.e. withdraw should return the same or fewer shares as previewWithdraw if\\n   *   called\\n   *   in the same transaction.\\n   * - MUST NOT account for withdrawal limits like those returned from maxWithdraw and should always act as though\\n   *   the withdrawal would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToShares and previewWithdraw SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by depositing.\\n   */\\n  function previewWithdraw(uint256 assets) external view returns (uint256 shares);\\n\\n  /**\\n   * @dev Burns shares from owner and sends exactly assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   withdraw execution, and are accounted for during withdraw.\\n   * - MUST revert if all of assets cannot be withdrawn (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * Note that some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function withdraw(uint256 assets, address receiver, address owner) external returns (uint256 shares);\\n\\n  /**\\n   * @dev Returns the maximum amount of Vault shares that can be redeemed from the owner balance in the Vault,\\n   * through a redeem call.\\n   *\\n   * - MUST return a limited value if owner is subject to some withdrawal limit or timelock.\\n   * - MUST return balanceOf(owner) if owner is not subject to any withdrawal limit or timelock.\\n   * - MUST NOT revert.\\n   */\\n  function maxRedeem(address owner) external view returns (uint256 maxShares);\\n\\n  /**\\n   * @dev Allows an on-chain or off-chain user to simulate the effects of their redeemption at the current block,\\n   * given current on-chain conditions.\\n   *\\n   * - MUST return as close to and no more than the exact amount of assets that would be withdrawn in a redeem call\\n   *   in the same transaction. I.e. redeem should return the same or more assets as previewRedeem if called in the\\n   *   same transaction.\\n   * - MUST NOT account for redemption limits like those returned from maxRedeem and should always act as though the\\n   *   redemption would be accepted, regardless if the user has enough shares, etc.\\n   * - MUST be inclusive of withdrawal fees. Integrators should be aware of the existence of withdrawal fees.\\n   * - MUST NOT revert.\\n   *\\n   * NOTE: any unfavorable discrepancy between convertToAssets and previewRedeem SHOULD be considered slippage in\\n   * share price or some other type of condition, meaning the depositor will lose assets by redeeming.\\n   */\\n  function previewRedeem(uint256 shares) external view returns (uint256 assets);\\n\\n  /**\\n   * @dev Burns exactly shares from owner and sends assets of underlying tokens to receiver.\\n   *\\n   * - MUST emit the Withdraw event.\\n   * - MAY support an additional flow in which the underlying tokens are owned by the Vault contract before the\\n   *   redeem execution, and are accounted for during redeem.\\n   * - MUST revert if all of shares cannot be redeemed (due to withdrawal limit being reached, slippage, the owner\\n   *   not having enough shares, etc).\\n   *\\n   * NOTE: some implementations will require pre-requesting to the Vault before a withdrawal may be performed.\\n   * Those methods should be performed separately.\\n   */\\n  function redeem(uint256 shares, address receiver, address owner) external returns (uint256 assets);\\n}\\n\",\"keccak256\":\"0xd730d6a6b679201eec89dff3133de651da20b3e72e74f01b734078bfacf952ad\",\"license\":\"GPL-3.0\"},\"contracts/parallelizer/Storage.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { IERC20 } from \\\"@openzeppelin/contracts/token/ERC20/IERC20.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { ITokenP } from \\\"contracts/interfaces/ITokenP.sol\\\";\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                        ENUMS                                                      \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nenum FacetCutAction {\\n  Add,\\n  Replace,\\n  Remove\\n}\\n\\nenum ManagerType {\\n  EXTERNAL\\n}\\n\\nenum ActionType {\\n  Mint,\\n  Burn,\\n  Redeem\\n}\\n\\nenum TrustedType {\\n  Updater,\\n  Seller\\n}\\n\\nenum QuoteType {\\n  MintExactInput,\\n  MintExactOutput,\\n  BurnExactInput,\\n  BurnExactOutput\\n}\\n\\nenum OracleReadType {\\n  CHAINLINK_FEEDS,\\n  EXTERNAL,\\n  NO_ORACLE,\\n  STABLE,\\n  WSTETH,\\n  CBETH,\\n  RETH,\\n  SFRXETH,\\n  MAX,\\n  MORPHO_ORACLE\\n}\\n\\nenum OracleQuoteType {\\n  UNIT,\\n  TARGET\\n}\\n\\nenum WhitelistType {\\n  BACKED\\n}\\n\\n/*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////\\n                                                    STRUCTS                                                     \\n//////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/\\n\\nstruct Permit2Details {\\n  address to; // Address that will receive the funds\\n  uint256 nonce; // Nonce of the transaction\\n  bytes signature; // Permit signature of the user\\n}\\n\\nstruct FacetCut {\\n  address facetAddress; // Facet contract address\\n  FacetCutAction action; // Can be add, remove or replace\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct Facet {\\n  address facetAddress; // Facet contract address\\n  bytes4[] functionSelectors; // Ex. bytes4(keccak256(\\\"transfer(address,uint256)\\\"))\\n}\\n\\nstruct FacetInfo {\\n  address facetAddress; // Facet contract address\\n  uint16 selectorPosition; // Position in the list of all selectors\\n}\\n\\nstruct DiamondStorage {\\n  bytes4[] selectors; // List of all available selectors\\n  mapping(bytes4 => FacetInfo) selectorInfo; // Selector to (address, position in list)\\n  IAccessManager accessManager; // Contract handling access management\\n}\\n\\nstruct ImplementationStorage {\\n  address implementation; // Dummy implementation address for Etherscan usability\\n}\\n\\nstruct ManagerStorage {\\n  IERC20[] subCollaterals; // Subtokens handled by the manager or strategies\\n  bytes config; // Additional configuration data\\n}\\n\\nstruct Collateral {\\n  uint8 isManaged; // If the collateral is managed through external strategies\\n  uint8 isMintLive; // If minting from this asset is unpaused\\n  uint8 isBurnLive; // If burning to this asset is unpaused\\n  uint8 decimals; // IERC20Metadata(collateral).decimals()\\n  uint8 onlyWhitelisted; // If only whitelisted addresses can burn or redeem for this token\\n  uint216 normalizedStables; // Normalized amount of stablecoins issued from this collateral\\n  uint64[] xFeeMint; // Increasing exposures in [0,BASE_9[\\n  int64[] yFeeMint; // Mint fees at the exposures specified in `xFeeMint`\\n  uint64[] xFeeBurn; // Decreasing exposures in ]0,BASE_9]\\n  int64[] yFeeBurn; // Burn fees at the exposures specified in `xFeeBurn`\\n  bytes oracleConfig; // Data about the oracle used for the collateral\\n  bytes whitelistData; // For whitelisted collateral, data used to verify whitelists\\n  ManagerStorage managerData; // For managed collateral, data used to handle the strategies\\n  uint256 stablecoinCap; // Cap on the amount of stablecoins that can be issued from this collateral\\n}\\n\\nstruct ParallelizerStorage {\\n  ITokenP tokenP; // tokenP handled by the system\\n  uint8 isRedemptionLive; // If redemption is unpaused\\n  uint8 statusReentrant; // If call is reentrant or not\\n  bool consumingSchedule; // If the contract is consuming a scheduled operation\\n  uint128 normalizedStables; // Normalized amount of stablecoins issued by the system\\n  uint128 normalizer; // To reconcile `normalizedStables` values with the actual amount\\n  address[] collateralList; // List of collateral assets supported by the system\\n  uint64[] xRedemptionCurve; // Increasing collateral ratios > 0\\n  int64[] yRedemptionCurve; // Value of the redemption fees at `xRedemptionCurve`\\n  mapping(address => Collateral) collaterals; // Maps a collateral asset to its parameters\\n  mapping(address => uint256) isTrusted; // If an address is trusted to update the normalizer value\\n  mapping(address => uint256) isSellerTrusted; // If an address is trusted to sell accruing reward tokens or to run\\n    // keeper jobs on oracles\\n  mapping(WhitelistType => mapping(address => uint256)) isWhitelistedForType;\\n}\\n// Whether an address is whitelisted for a specific whitelist type\\n\",\"keccak256\":\"0x3f4313dd110dbe390038320b2d3cf24dcbe9b75cd9573e7f048f7233c02dd227\",\"license\":\"BUSL-1.1\"},\"contracts/utils/AccessManaged.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nimport { AuthorityUtils } from \\\"@openzeppelin/contracts/access/manager/AuthorityUtils.sol\\\";\\nimport { IAccessManager } from \\\"@openzeppelin/contracts/access/manager/IAccessManager.sol\\\";\\nimport { IAccessManaged } from \\\"@openzeppelin/contracts/access/manager/IAccessManaged.sol\\\";\\nimport { Context } from \\\"@openzeppelin/contracts/utils/Context.sol\\\";\\n\\nimport \\\"../utils/Errors.sol\\\";\\n\\n/// @title AccessControl\\n/// @author Cooper Labs\\n/// @custom:contact security@cooperlabs.xyz\\n/// @dev Fork of OpenZeppelin's `AccessManaged` contract\\n/// updated to make _checkCanCall to return bool\\n/// https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/access/manager/AccessManaged.sol\\ncontract AccessManaged is Context, IAccessManaged {\\n  address private _authority;\\n\\n  bool private _consumingSchedule;\\n\\n  /**\\n   * @dev Initializes the contract connected to an initial authority.\\n   */\\n  constructor(address initialAuthority) {\\n    _setAuthority(initialAuthority);\\n  }\\n\\n  /**\\n   * @dev Restricts access to a function as defined by the connected Authority for this contract and the\\n   * caller and selector of the function that entered the contract.\\n   *\\n   * [IMPORTANT]\\n   * ====\\n   * In general, this modifier should only be used on `external` functions. It is okay to use it on `public`\\n   * functions that are used as external entry points and are not called internally. Unless you know what you're\\n   * doing, it should never be used on `internal` functions. Failure to follow these rules can have critical security\\n   * implications! This is because the permissions are determined by the function that entered the contract, i.e. the\\n   * function at the bottom of the call stack, and not the function where the modifier is visible in the source code.\\n   * ====\\n   *\\n   * [WARNING]\\n   * ====\\n   * Avoid adding this modifier to the\\n   * https://docs.soliditylang.org/en/v0.8.20/contracts.html#receive-ether-function[`receive()`]\\n   * function or the https://docs.soliditylang.org/en/v0.8.20/contracts.html#fallback-function[`fallback()`]. These\\n   * functions are the only execution paths where a function selector cannot be unambiguously determined from the\\n   * calldata\\n   * since the selector defaults to `0x00000000` in the `receive()` function and similarly in the `fallback()`\\n   * function\\n   * if no calldata is provided. (See {_checkCanCall}).\\n   *\\n   * The `receive()` function will always panic whereas the `fallback()` may panic depending on the calldata length.\\n   * ====\\n   */\\n  modifier restricted() {\\n    address caller = _msgSender();\\n    require(_checkCanCall(caller, _msgData()), AccessManagedUnauthorized(caller));\\n    _;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function authority() public view virtual returns (address) {\\n    return _authority;\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function setAuthority(address newAuthority) public virtual {\\n    address caller = _msgSender();\\n    if (caller != authority()) {\\n      revert AccessManagedUnauthorized(caller);\\n    }\\n    if (newAuthority.code.length == 0) {\\n      revert AccessManagedInvalidAuthority(newAuthority);\\n    }\\n    _setAuthority(newAuthority);\\n  }\\n\\n  /// @inheritdoc IAccessManaged\\n  function isConsumingScheduledOp() public view returns (bytes4) {\\n    return _consumingSchedule ? this.isConsumingScheduledOp.selector : bytes4(0);\\n  }\\n\\n  /**\\n   * @dev Transfers control to a new authority. Internal function with no access restriction. Allows bypassing the\\n   * permissions set by the current authority.\\n   */\\n  function _setAuthority(address newAuthority) internal virtual {\\n    _authority = newAuthority;\\n    emit AuthorityUpdated(newAuthority);\\n  }\\n\\n  function _checkCanCall(address caller, bytes calldata data) internal virtual returns (bool) {\\n    (bool immediate, uint32 delay) =\\n      AuthorityUtils.canCallWithDelay(authority(), caller, address(this), bytes4(data[0:4]));\\n    if (!immediate) {\\n      if (delay > 0) {\\n        _consumingSchedule = true;\\n        IAccessManager(authority()).consumeScheduledOp(caller, data);\\n        _consumingSchedule = false;\\n      } else {\\n        return false;\\n      }\\n    }\\n    return true;\\n  }\\n}\\n\",\"keccak256\":\"0x40dfee0e736695b3005df6c150a2d794ac06f3f4b91745e2959623e770044798\",\"license\":\"BUSL-1.1\"},\"contracts/utils/Errors.sol\":{\"content\":\"// SPDX-License-Identifier: BUSL-1.1\\npragma solidity 0.8.28;\\n\\nerror AccessManagedUnauthorized(address caller);\\nerror AlreadyAdded();\\nerror CannotAddFunctionToDiamondThatAlreadyExists(bytes4 _selector);\\nerror CannotAddSelectorsToZeroAddress(bytes4[] _selectors);\\nerror CannotRemoveFunctionThatDoesNotExist(bytes4 _selector);\\nerror CannotRemoveImmutableFunction(bytes4 _selector);\\nerror CannotReplaceFunctionsFromFacetWithZeroAddress(bytes4[] _selectors);\\nerror CannotReplaceFunctionThatDoesNotExists(bytes4 _selector);\\nerror CannotReplaceFunctionWithTheSameFunctionFromTheSameFacet(bytes4 _selector);\\nerror CannotReplaceImmutableFunction(bytes4 _selector);\\nerror ContractHasNoCode();\\nerror CollateralBacked();\\nerror FunctionNotFound(bytes4 _functionSelector);\\nerror IncorrectFacetCutAction(uint8 _action);\\nerror InitializationFunctionReverted(address _initializationContractAddress, bytes _calldata);\\nerror InvalidChainlinkRate();\\nerror InvalidLengths();\\nerror InvalidNegativeFees();\\nerror InvalidOracleType();\\nerror InvalidParam();\\nerror InvalidParams();\\nerror InvalidRate();\\nerror InvalidSwap();\\nerror InvalidTokens();\\nerror InvalidAccessManager();\\nerror ManagerHasAssets();\\nerror NoSelectorsProvidedForFacetForCut(address _facetAddress);\\nerror NotAllowed();\\nerror NotCollateral();\\nerror NotGovernor();\\nerror NotGuardian();\\nerror NotTrusted();\\nerror NotTrustedOrGuardian();\\nerror NotWhitelisted();\\nerror OdosSwapFailed();\\nerror OracleUpdateFailed();\\nerror Paused();\\nerror ReentrantCall();\\nerror RemoveFacetAddressMustBeZeroAddress(address _facetAddress);\\nerror TooBigAmountIn();\\nerror TooLate();\\nerror TooSmallAmountOut();\\nerror ZeroAddress();\\nerror ZeroAmount();\\nerror SwapError();\\nerror SlippageTooHigh();\\nerror InsufficientFunds();\\n\",\"keccak256\":\"0x1e2f6812ef78e948e5155d32213b52afff8c0ba5463d18bee10694efbf886130\",\"license\":\"BUSL-1.1\"}},\"version\":1}",
-  "bytecode": "0x60e080604052346101e95760c08161278a803803809161001f828561020f565b8339810103126101e95761003281610246565b9061003f60208201610246565b6040820151926001600160a01b038416918285036101e95760608401516001600160a01b03811681036101e95760a061007a60808701610246565b950151956001600160a01b038716958688036101e9575f80546001600160a01b0319166001600160a01b0390921691821790556040519081527f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad90602090a160a052608052600480546001600160a01b039283166001600160a01b0319918216179091556005805493909216921691909117905581156102005760446020925f9460c052604051948593849263095ea7b360e01b84526004840152811960248401525af180156101f5576101b9575b60405161252f908161025b823960805181818161027601528181610ce401528181610e1b01528181611d1901526120ab015260a0518181816103bf0152818161066a01528181610e480152818161155201526115d9015260c05181818161040701528181610d5901526115960152f35b6020813d6020116101ed575b816101d26020938361020f565b810103126101e95751801515036101e9575f610149565b5f80fd5b3d91506101c5565b6040513d5f823e3d90fd5b63d92e233d60e01b5f5260045ffd5b601f909101601f19168101906001600160401b0382119082101761023257604052565b634e487b7160e01b5f52604160045260245ffd5b51906001600160a01b03821682036101e95756fe60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220ec283012c4b4807e318035ba023be8591bf414e2388206dea6cd585b6cb7364064736f6c634300081c0033",
-  "deployedBytecode": "0x60806040526004361015610011575f80fd5b5f5f3560e01c80630dd3932d1461164357806313047520146115fd5780631978a5ed146115ba5780631b89b61a14611577578063212c8fb1146114be57806323e30c8b14610d0857806335b37d1a14610cc55780634127365714610c435780635a7cb38f14610c1d578063641bd50314610b6b5780637a9e5e4b14610a9d5780637ee8434914610a0c5780638195001d146109eb5780638237e538146109b15780638fb360371461093e57806396d64879146109015780639ae784861461082c578063b51609b4146107a5578063bf7e214f14610780578063c31c9c071461075a578063c5e6d5ea146106c9578063c9c6667414610691578063d2d0ec1014610628578063da94e205146105af578063e234b903146105005763edf0ef0314610138575f80fd5b346104ac5760603660031901126104ac57610151611899565b60243560443567ffffffffffffffff81116104ac576101749036906004016118c5565b9290633b9aca0083116104d8578161018d600293611a0c565b6001600160a01b03811690815f5283602052633b9aca0061022c61022460405f206bffffffffffffffffffffffff6040519889926101ca8461194b565b67ffffffffffffffff81546001600160a01b038116865260a01c16602085015267ffffffffffffffff60018201548181166040870152818160401c16606087015260801c1660808501520154169460a08201958652611d0c565b979097611a52565b049586156104b0578301926040818503126104ac5780359360028510156104ac57602082013567ffffffffffffffff81116104ac5761026b92016119b9565b936001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016803b156104ac575f80916024604051809481937f1cb44dfc0000000000000000000000000000000000000000000000000000000083528960048401525af1610490575b506001600160a01b036bffffffffffffffffffffffff915116915116633b9aca00036bffffffffffffffffffffffff811161047c5760ff946103fa97946103849460209894633b9aca0061033e6bffffffffffffffffffffffff61037697168a611a52565b0491604051998a97338d8a01521660408801526060870152608086015260a085015260c084015260e0808401526101008301906122e5565b03601f19810184528361197b565b60405193849283927f5cffe9de0000000000000000000000000000000000000000000000000000000084523060048501526001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016602485015260448401526080606484015260848301906122e5565b0381856001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000165af1801561047157610437575080f35b6020813d602011610469575b816104506020938361197b565b810103126104655761046190612309565b5080f35b5080fd5b3d9150610443565b6040513d84823e3d90fd5b602488634e487b7160e01b81526011600452fd5b61049d9198505f9061197b565b5f966001600160a01b036102d9565b5f80fd5b7f1f2a2005000000000000000000000000000000000000000000000000000000005f5260045ffd5b7fd2529034000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760203660031901126104ac576001600160a01b03610521611899565b6105343361052f3633611a65565b6118f3565b168015610587576020817ffd238617dbf7bc2e2e9c11b00a61a76432989bf0d6ca3a5aa34381a8752db4039273ffffffffffffffffffffffffffffffffffffffff196005541617600555604051908152a1005b7fd92e233d000000000000000000000000000000000000000000000000000000005f5260045ffd5b346104ac5760403660031901126104ac576105c8611899565b602435906bffffffffffffffffffffffff82168092036104ac576105f03361052f3633611a65565b633b9aca0082116104d8576001600160a01b03165f52600160205260405f20906bffffffffffffffffffffffff198254161790555f80f35b346104ac5760403660031901126104ac5761068f6004356106476118af565b335f52600660205260405f2061065e8382546119ff565b90556001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001661228e565b005b346104ac5760203660031901126104ac576001600160a01b036106b2611899565b165f526006602052602060405f2054604051908152f35b346104ac5760203660031901126104ac576001600160a01b036106ea611899565b165f52600260205260c060405f2080549067ffffffffffffffff6bffffffffffffffffffffffff60026001840154930154169181604051946001600160a01b038116865260a01c1660208501528181166040850152818160401c16606085015260801c16608083015260a0820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360045416604051908152f35b346104ac575f3660031901126104ac5760206001600160a01b035f5416604051908152f35b346104ac5760603660031901126104ac576107be611899565b6024356044356001600160a01b0381168082036104ac577fb197f0a554c4d7840105e6ae65f0e275e9e8605a969dffa8caa7f1f118a2e1f5606061068f9561080a3361052f3633611a65565b6001600160a01b036040519116938482528660208301526040820152a161228e565b346104ac5760403660031901126104ac57610845611899565b60243567ffffffffffffffff811681036104ac57335f52600360205260ff60405f20541615806108f0575b6108c8576001600160a01b0361068f92165f52600260205260405f20907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b7f0dcc030f000000000000000000000000000000000000000000000000000000005f5260045ffd5b506108fb3633611a65565b15610870565b346104ac5760203660031901126104ac576001600160a01b03610922611899565b165f526003602052602060ff60405f2054166040519015158152f35b346104ac575f3660031901126104ac575f5460a01c60ff16156109a95760207f8fb36037000000000000000000000000000000000000000000000000000000005b7fffffffff0000000000000000000000000000000000000000000000000000000060405191168152f35b60205f61097f565b346104ac575f3660031901126104ac5760206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b346104ac5760203660031901126104ac5761068f610a07611899565b611a0c565b346104ac5760203660031901126104ac576001600160a01b03610a2d611899565b610a3b3361052f3633611a65565b16805f5260036020527f7628ea5f6112a16b36a8239aa208395a8e8f221688cfb3a5461faffb9700abcd604060ff815f20541681519084825215156020820152a15f908152600360205260409020805460ff818116151660ff19909116179055005b346104ac5760203660031901126104ac57610ab6611899565b5f54906001600160a01b0382163303610b5957803b15610b245773ffffffffffffffffffffffffffffffffffffffff197f2f658b440c35314f52658ea8a740e05b284cdc84dc9ae01e891f21b8933e7cad926001600160a01b036020931691829116175f55604051908152a1005b6001600160a01b03907fc2f31e5e000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b62d1953b60e31b5f523360045260245ffd5b346104ac5760203660031901126104ac576040610c0e610b89611899565b6001600160a01b0381165f526002602052825f20906bffffffffffffffffffffffff6002855193610bb98561194b565b67ffffffffffffffff81546001600160a01b038116875260a01c16602086015267ffffffffffffffff60018201548181168988015281818a1c16606088015260801c16608086015201541660a0830152611d0c565b60ff8351921682526020820152f35b346104ac575f3660031901126104ac5760206001600160a01b0360055416604051908152f35b346104ac5760203660031901126104ac576001600160a01b03610c64611899565b610c723361052f3633611a65565b168015610587576020817f36db479a3b4d3672bd6f5fca4484283f60b5ac70647b1ceec13ecbb1d030a2df9273ffffffffffffffffffffffffffffffffffffffff196004541617600455604051908152a1005b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760a03660031901126104ac57610d21611899565b610d296118af565b5060443560843567ffffffffffffffff81116104ac57610d4d9036906004016118c5565b90926001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000163314908115916114aa575b50801561149f575b6114775782019060e0838303126104ac57610da683611937565b92610db360408201611937565b610dbf60608301611937565b60a08301359460028610156104ac5760c08401359067ffffffffffffffff82116104ac57610df96001600160a01b039291839287016119b9565b9216921694600160208501351495865f146114715792915b6001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000169687926001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001694604051926301db50ff60e51b84528960048501525f602485015286604485015260208460c4815f6001600160a01b0387169a8b60648401523060848401524260a48401525af19384156110c6575f9461143d575b505f926001810361129957505050506001600160a01b03851690604051936370a0823160e01b8552306004860152602085602481865afa9485156110c6575f95611265575b50604093845192610f13868561197b565b60018452601f1986019283366020870137610f2d8561206b565b52855191610f3b878461197b565b600183525f5b8481106112545750610f528361206b565b52610f5c8261206b565b50855192610f6a878561197b565b60018452366020850137610f7d8361206b565b528251925f5b84811061111957505050505060206024918351928380926370a0823160e01b82523060048301525afa91821561111057505f916110d1575b5060809660c4936001600160a01b03610fd960209897955f956119ff565b945b610fe6868583611c6b565b6040519a8b9889976301db50ff60e51b895260048901520135602487015216604485015260648401523060848401524260a48401525af19182156110c6575f92611092575b5081811161105e575b60206040517f439148f0bbc682ca079e46d6e2c2f0c1e3b820f1a291b069d8882abf8cf18dd98152f35b6001600160a01b0391611070916119ff565b91165f52600660205261108860405f209182546119ff565b9055808080611034565b9091506020813d6020116110be575b816110ae6020938361197b565b810103126104ac5751908361102b565b3d91506110a1565b6040513d5f823e3d90fd5b905060209493919294813d602011611108575b816110f16020938361197b565b810103126104ac5751929390929091906080610fbb565b3d91506110e4565b513d5f823e3d90fd5b6001600160a01b0361112b828461208c565b51166001600160a01b036005541690611144838761208c565b518951636eb1769f60e11b81523060048201526001600160a01b03841660248201529290602084604481865afa93841561124a575f94611217575b508084106111fb575b505050505f80611198838661208c565b516001600160a01b036004541682602083519301915af16111b7612316565b90156111c65750600101610f83565b805190816111f6577f7c3eb9ca000000000000000000000000000000000000000000000000000000005f5260045ffd5b602001fd5b61120e93611208916119ff565b916123b2565b8e808080611188565b9093506020813d8211611242575b816112326020938361197b565b810103126104ac5751925f61117f565b3d9150611225565b8b513d5f823e3d90fd5b806060602080938701015201610f41565b9094506020813d602011611291575b816112816020938361197b565b810103126104ac5751938b610f02565b3d9150611274565b90919394505f9a979592989a50156112c9575b50505050925f6080969360c4936001600160a01b03602097610fdb565b93965091928692901561139357506112e2918391611c6b565b604051907f6e553f6500000000000000000000000000000000000000000000000000000000825260048201523060248201526020816044815f6001600160a01b0389165af19081156110c6575f91611359575b50925f6080969360c4936001600160a01b036020975b9750829699508195506112ac565b95929390506020863d60201161138b575b816113776020938361197b565b810103126104ac579451919492915f611335565b3d915061136a565b90506020915060645f9360405194859384927fba08765200000000000000000000000000000000000000000000000000000000845260048401523060248401523060448401525af19081156110c6575f91611403575b50925f6080969360c4936001600160a01b0360209761134b565b95929390506020863d602011611435575b816114216020938361197b565b810103126104ac579451919492915f6113e9565b3d9150611414565b9093506020813d602011611469575b816114596020938361197b565b810103126104ac5751928c610ebd565b3d915061144c565b91610e11565b7fc22a648e000000000000000000000000000000000000000000000000000000005f5260045ffd5b506064351515610d8c565b6001600160a01b0316301415905084610d84565b346104ac5760403660031901126104ac5761068f6004356001600160a01b036114e56118af565b165f52600660205260405f206114fc828254611916565b9055604051907f23b872dd00000000000000000000000000000000000000000000000000000000602083015233602483015230604483015260648201526064815261154860848261197b565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016612345565b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac575f3660031901126104ac5760206040516001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000168152f35b346104ac5760203660031901126104ac576001600160a01b0361161e611899565b165f52600160205260206bffffffffffffffffffffffff60405f205416604051908152f35b346104ac5760e03660031901126104ac5761165c611899565b6116646118af565b6044359167ffffffffffffffff8316918284036104ac576064359267ffffffffffffffff8416918285036104ac576084359567ffffffffffffffff87168097036104ac5760a4359467ffffffffffffffff8616908187036104ac5760c435906bffffffffffffffffffffffff82168092036104ac576001600160a01b03906116f03361052f3633611a65565b165f526002602052633b9aca0060405f20956001600160a01b03861673ffffffffffffffffffffffffffffffffffffffff1988541617875510156104d857633b9aca008110156104d85761177d60019386907fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff67ffffffffffffffff60a01b83549260a01b169116179055565b828501967fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff77ffffffffffffffff0000000000000000000000000000000089549260801b16911617875560028501906bffffffffffffffffffffffff19825416179055145f1461185157505083633b9aca00811091821592611846575b50506104d85761068f9267ffffffffffffffff19825416178155906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b1015905083856117fa565b929150925061068f93507002000000000000000000000000000000007fffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffff8254161790556120a0565b600435906001600160a01b03821682036104ac57565b602435906001600160a01b03821682036104ac57565b9181601f840112156104ac5782359167ffffffffffffffff83116104ac57602083818601950101116104ac57565b156118fb5750565b6001600160a01b039062d1953b60e31b5f521660045260245ffd5b9190820180921161192357565b634e487b7160e01b5f52601160045260245ffd5b35906001600160a01b03821682036104ac57565b60c0810190811067ffffffffffffffff82111761196757604052565b634e487b7160e01b5f52604160045260245ffd5b90601f8019910116810190811067ffffffffffffffff82111761196757604052565b67ffffffffffffffff811161196757601f01601f191660200190565b81601f820112156104ac578035906119d08261199d565b926119de604051948561197b565b828452602083830101116104ac57815f926020809301838601378301015290565b9190820391821161192357565b6001600160a01b03165f52600260205260405f20600267ffffffffffffffff600183015460801c1614611a3c5750565b806001600160a01b03611a509254166120a0565b565b8181029291811591840414171561192357565b905f915f54916001600160a01b03831692816004116104ac575f5f905f80604051966001600160a01b0360208901917fb700961300000000000000000000000000000000000000000000000000000000835216978860248201523060448201527fffffffff00000000000000000000000000000000000000000000000000000000833516606482015260648152611afd60848261197b565b5190895afa611b0a612316565b90611bf2575b5015611b22575b505050505050600190565b63ffffffff1615611be95760ff60a01b191674010000000000000000000000000000000000000000175f55823b156104ac576064925f92836040519586809581947f94c7d7ee0000000000000000000000000000000000000000000000000000000083526004830152604060248301528060448301528084848401378181018301849052601f01601f191681010301925af180156110c657611bd6575b5060ff60a01b1981541690555f8080808080611b17565b611be291505f9061197b565b5f5f611bbf565b50505050505f90565b80519092909160408310611c3457505081604091810103126104ac576040611c1c60208301612309565b91015163ffffffff811681036104ac57905b5f611b10565b916020819492941015611c49575b5050611c2e565b81925090602091810103126104ac576020611c649101612309565b5f80611c42565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152909391169190602084604481865afa9384156110c6575f94611cc2575b508310611cb757505050565b611a509219916123b2565b9093506020813d602011611cee575b81611cde6020938361197b565b810103126104ac5751925f611cab565b3d9150611cd1565b91908260409103126104ac576020825192015190565b915f926001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906001600160a01b0360405191634a71aecf60e11b8352166004820152604081602481855afa9081156110c6575f905f92611f28575b5060406001600160a01b038651166024825180968193634a71aecf60e11b835260048301525afa9283156110c6575f93611ef6575b50611dbd8267ffffffffffffffff602088015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e6d576040611dfc611e059493633b9aca0067ffffffffffffffff9404906119ff565b96015116611a52565b633b9aca008202828104633b9aca00148315171561192357811015611e2b57505f925050565b611e358483611916565b633b9aca00810290808204633b9aca001490151715611923578110611e58575050565b611e6a929350633b9aca0090046119ff565b90565b95509067ffffffffffffffff6060611dfc611e9094633b9aca0060019a046119ff565b633b9aca008202828104633b9aca0014831517156119235781811015611eb857505f93505050565b633b9aca008502858104633b9aca00148615171561192357611eda9083611916565b11611ee3575050565b611e6a929350633b9aca009004906119ff565b611f1991935060403d604011611f21575b611f11818361197b565b810190611cf6565b50915f611da4565b503d611f07565b9050611f43915060403d604011611f2157611f11818361197b565b905f611d6f565b67ffffffffffffffff81116119675760051b60200190565b91906040838203126104ac57825167ffffffffffffffff81116104ac57830181601f820112156104ac578051611f9781611f4a565b91611fa5604051938461197b565b81835260208084019260051b820101908482116104ac57602001915b81831061204a575050509260208101519067ffffffffffffffff82116104ac57019080601f830112156104ac57815190611ffa82611f4a565b92612008604051948561197b565b82845260208085019360051b8201019182116104ac57602001915b8183106120305750505090565b82518060070b81036104ac57815260209283019201612023565b825167ffffffffffffffff811681036104ac57815260209283019201611fc1565b8051156120785760200190565b634e487b7160e01b5f52603260045260245ffd5b80518210156120785760209160051b010190565b906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016916001600160a01b03604051917fb85780bc000000000000000000000000000000000000000000000000000000008352168060048301525f82602481875afa9182156110c6575f92612271575b5081516001811161222b575060018301805467ffffffffffffffff1916633b9aca001790555f91505b6024604051809581937f847da7be00000000000000000000000000000000000000000000000000000000835260048301525afa9182156110c6575f92612206575b50815191600183116121ac575060010180546fffffffffffffffff00000000000000001916905550565b60011983019283116119235767ffffffffffffffff6121d0611a509460019361208c565b51169101906fffffffffffffffff0000000000000000196fffffffffffffffff000000000000000083549260401b169116179055565b6122239192503d805f833e61221b818361197b565b810190611f62565b50905f612182565b60011981019081116119235761224b67ffffffffffffffff915f9461208c565b511667ffffffffffffffff60018501911667ffffffffffffffff19825416179055612141565b6122869192503d805f833e61221b818361197b565b50905f612118565b6040517fa9059cbb0000000000000000000000000000000000000000000000000000000060208201526001600160a01b0390921660248301526044820192909252611a50916122e08260648101610376565b612345565b805180835260209291819084018484015e5f828201840152601f01601f1916010190565b519081151582036104ac57565b3d15612340573d906123278261199d565b91612335604051938461197b565b82523d5f602084013e565b606090565b905f602091828151910182855af1156110c6575f513d6123a957506001600160a01b0381163b155b6123745750565b6001600160a01b03907f5274afe7000000000000000000000000000000000000000000000000000000005f521660045260245ffd5b6001141561236d565b604051636eb1769f60e11b81523060048201526001600160a01b038381166024830152929392821692602082604481875afa80156110c6575f906124c5575b6123fb9250611916565b9160205f60405194612446866124388582019363095ea7b360e01b85528a60248401602090939291936001600160a01b0360408201951681520152565b03601f19810188528761197b565b85519082865af1903d5f5190836124a6575b5050501561246557505050565b6122e0611a50936001600160a01b036040519163095ea7b360e01b60208401521660248201525f6044820152604481526124a060648261197b565b82612345565b919250906124bb57503b15155b5f8080612458565b60019150146124b3565b506020823d6020116124f1575b816124df6020938361197b565b810103126104ac576123fb91516123f1565b3d91506124d256fea2646970667358221220ec283012c4b4807e318035ba023be8591bf414e2388206dea6cd585b6cb7364064736f6c634300081c0033",
-  "devdoc": {
-    "author": "Cooper Labs",
-    "custom:contact": "security@cooperlabs.xyz",
-    "details": "Generic contract for anyone to permissionlessly adjust the reserves of Angle ParallelizerThis contract is an authorized fork of Angle's GenericHarvester contract: https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol",
-    "errors": {
-      "SafeERC20FailedOperation(address)": [
-        {
-          "details": "An operation with an ERC-20 token failed."
-        }
-      ]
-    },
-    "events": {
-      "AuthorityUpdated(address)": {
-        "details": "Authority that manages this contract was updated."
-      }
-    },
-    "kind": "dev",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to add to the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "authority()": {
-        "details": "Returns the current authority."
-      },
-      "computeRebalanceAmount(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        },
-        "returns": {
-          "amount": "amount to be rebalanced",
-          "increase": "whether the exposure should be increased"
-        }
-      },
-      "harvest(address,uint256,bytes)": {
-        "details": "This transaction either reduces the exposure to `yieldBearingAsset` in the Parallelizer or frees up some yieldBearingAsset that can then be used for people looking to burn deposit tokensDue to potential transaction fees within the Parallelizer, this function doesn't exactly bring `yieldBearingAsset` to the target exposurescale is a number between 0 and 1e9 that represents the proportion of the tokenP to harvest, it is used to lower the amount of the asset to harvest for example to have a lower slippage"
-      },
-      "isConsumingScheduledOp()": {
-        "details": "Returns true only in the context of a delayed restricted call, at the moment that the scheduled operation is being consumed. Prevents denial of service for delayed restricted calls in the case that the contract performs attacker controlled calls."
-      },
-      "onFlashLoan(address,address,uint256,uint256,bytes)": {
-        "details": "Receive a flash loan.",
-        "params": {
-          "amount": "The amount of tokens lent.",
-          "data": "Arbitrary data structure, intended to contain user-defined parameters.",
-          "fee": "The additional amount of tokens to repay.",
-          "initiator": "The initiator of the loan.",
-          "token": "The loan currency."
-        },
-        "returns": {
-          "_0": "The keccak256 hash of \"ERC3156FlashBorrower.onFlashLoan\""
-        }
-      },
-      "recoverERC20(address,uint256,address)": {
-        "params": {
-          "amountToRecover": "amount to recover",
-          "to": "address to send the recovered tokens",
-          "tokenAddress": "address of the token to recover"
-        }
-      },
-      "removeBudget(uint256,address)": {
-        "params": {
-          "amount": "amount of tokenP to remove from the budget",
-          "receiver": "address of the receiver"
-        }
-      },
-      "setAuthority(address)": {
-        "details": "Transfers control to a new authority. The caller must be the current authority."
-      },
-      "setMaxSlippage(address,uint96)": {
-        "params": {
-          "newMaxSlippage": "new max allowed slippage"
-        }
-      },
-      "setSwapRouter(address)": {
-        "params": {
-          "newSwapRouter": "address of the swap router"
-        }
-      },
-      "setTargetExposure(address,uint64)": {
-        "params": {
-          "targetExposure": "target exposure to the yield bearing asset used",
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      },
-      "setTokenTransferAddress(address)": {
-        "params": {
-          "newTokenTransferAddress": "address of the token transfer contract"
-        }
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "params": {
-          "asset": "address of the asset",
-          "maxExposure": "maximum exposure within the Parallelizer to the asset",
-          "minExposure": "minimum exposure within the Parallelizer to the asset",
-          "overrideExposures": "whether limit exposures should be overriden or read onchain through the Parallelizer",
-          "targetExposure": "target exposure to the yieldBearingAsset asset used",
-          "yieldBearingAsset": "address of the yieldBearingAsset"
-        }
-      },
-      "toggleTrusted(address)": {
-        "params": {
-          "trusted": "address to toggle the trusted status"
-        }
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "params": {
-          "yieldBearingAsset": "address of the yield bearing asset"
-        }
-      }
-    },
-    "title": "GenericHarvester",
-    "version": 1
-  },
-  "userdoc": {
-    "events": {
-      "SwapRouterUpdated(address)": {
-        "notice": "Event emitted when the swap router is updated"
-      },
-      "TokenTransferAddressUpdated(address)": {
-        "notice": "Event emitted when the token proxy is updated"
-      }
-    },
-    "kind": "user",
-    "methods": {
-      "addBudget(uint256,address)": {
-        "notice": "Add budget to be spent by the receiver during the flashloan"
-      },
-      "budget(address)": {
-        "notice": "Budget of tokenP available for each users"
-      },
-      "computeRebalanceAmount(address)": {
-        "notice": "Compute the amount needed to rebalance the Parallelizer"
-      },
-      "flashloan()": {
-        "notice": "Parallel stablecoin flashloan contract"
-      },
-      "harvest(address,uint256,bytes)": {
-        "notice": "Invests or divests from the yield asset associated to `yieldBearingAsset` based on the current exposure  to this yieldBearingAsset"
-      },
-      "isTrusted(address)": {
-        "notice": "trusted addresses that can update target exposure and do others non critical operations"
-      },
-      "maxTokenSlippage(address)": {
-        "notice": "Max slippage when dealing with the Parallelizer"
-      },
-      "parallelizer()": {
-        "notice": "Reference to the `parallelizer` implementation this contract aims at rebalancing"
-      },
-      "recoverERC20(address,uint256,address)": {
-        "notice": "Recover ERC20 tokens"
-      },
-      "removeBudget(uint256,address)": {
-        "notice": "Remove budget from the owner and send it to the receiver"
-      },
-      "setMaxSlippage(address,uint96)": {
-        "notice": "Set the max allowed slippage"
-      },
-      "setSwapRouter(address)": {
-        "notice": "Set the swap router"
-      },
-      "setTargetExposure(address,uint64)": {
-        "notice": "Set the target exposure of a yield bearing asset"
-      },
-      "setTokenTransferAddress(address)": {
-        "notice": "Set the token transfer address"
-      },
-      "setYieldBearingAssetData(address,address,uint64,uint64,uint64,uint64,uint96)": {
-        "notice": "Set the yieldBearingAsset data"
-      },
-      "swapRouter()": {
-        "notice": "address of the router/aggregator"
-      },
-      "toggleTrusted(address)": {
-        "notice": "Toggle the trusted status of an address"
-      },
-      "tokenP()": {
-        "notice": "TokenP handled by the `parallelizer` of interest"
-      },
-      "tokenTransferAddress()": {
-        "notice": "address to approve to transfer tokens to"
-      },
-      "updateLimitExposuresYieldAsset(address)": {
-        "notice": "Set the limit exposures to the asset linked to the yield bearing asset"
-      },
-      "yieldBearingData(address)": {
-        "notice": "Data associated to a yield bearing asset"
-      }
-    },
-    "version": 1
-  },
-  "storageLayout": {
-    "storage": [
-      {
-        "astId": 22996,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_authority",
-        "offset": 0,
-        "slot": "0",
-        "type": "t_address"
-      },
-      {
-        "astId": 22998,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "_consumingSchedule",
-        "offset": 20,
-        "slot": "0",
-        "type": "t_bool"
-      },
-      {
-        "astId": 8228,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "maxTokenSlippage",
-        "offset": 0,
-        "slot": "1",
-        "type": "t_mapping(t_address,t_uint96)"
-      },
-      {
-        "astId": 8234,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "yieldBearingData",
-        "offset": 0,
-        "slot": "2",
-        "type": "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)"
-      },
-      {
-        "astId": 8239,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "isTrusted",
-        "offset": 0,
-        "slot": "3",
-        "type": "t_mapping(t_address,t_bool)"
-      },
-      {
-        "astId": 43,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "swapRouter",
-        "offset": 0,
-        "slot": "4",
-        "type": "t_address"
-      },
-      {
-        "astId": 46,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "tokenTransferAddress",
-        "offset": 0,
-        "slot": "5",
-        "type": "t_address"
-      },
-      {
-        "astId": 8955,
-        "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-        "label": "budget",
-        "offset": 0,
-        "slot": "6",
-        "type": "t_mapping(t_address,t_uint256)"
-      }
-    ],
-    "types": {
-      "t_address": {
-        "encoding": "inplace",
-        "label": "address",
-        "numberOfBytes": "20"
-      },
-      "t_bool": {
-        "encoding": "inplace",
-        "label": "bool",
-        "numberOfBytes": "1"
-      },
-      "t_mapping(t_address,t_bool)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => bool)",
-        "numberOfBytes": "32",
-        "value": "t_bool"
-      },
-      "t_mapping(t_address,t_struct(YieldBearingParams)8169_storage)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => struct YieldBearingParams)",
-        "numberOfBytes": "32",
-        "value": "t_struct(YieldBearingParams)8169_storage"
-      },
-      "t_mapping(t_address,t_uint256)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint256)",
-        "numberOfBytes": "32",
-        "value": "t_uint256"
-      },
-      "t_mapping(t_address,t_uint96)": {
-        "encoding": "mapping",
-        "key": "t_address",
-        "label": "mapping(address => uint96)",
-        "numberOfBytes": "32",
-        "value": "t_uint96"
-      },
-      "t_struct(YieldBearingParams)8169_storage": {
-        "encoding": "inplace",
-        "label": "struct YieldBearingParams",
-        "members": [
-          {
-            "astId": 8158,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "asset",
-            "offset": 0,
-            "slot": "0",
-            "type": "t_address"
-          },
-          {
-            "astId": 8160,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "targetExposure",
-            "offset": 20,
-            "slot": "0",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8162,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxExposure",
-            "offset": 0,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8164,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "minExposure",
-            "offset": 8,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8166,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "overrideExposures",
-            "offset": 16,
-            "slot": "1",
-            "type": "t_uint64"
-          },
-          {
-            "astId": 8168,
-            "contract": "contracts/helpers/GenericHarvester.sol:GenericHarvester",
-            "label": "maxSlippage",
-            "offset": 0,
-            "slot": "2",
-            "type": "t_uint96"
-          }
-        ],
-        "numberOfBytes": "96"
-      },
-      "t_uint256": {
-        "encoding": "inplace",
-        "label": "uint256",
-        "numberOfBytes": "32"
-      },
-      "t_uint64": {
-        "encoding": "inplace",
-        "label": "uint64",
-        "numberOfBytes": "8"
-      },
-      "t_uint96": {
-        "encoding": "inplace",
-        "label": "uint96",
-        "numberOfBytes": "12"
-      }
-    }
-  }
-}
\ No newline at end of file
diff --git a/generated/abis/IHarvester.d.ts b/generated/abis/IRebalancer.d.ts
similarity index 95%
rename from generated/abis/IHarvester.d.ts
rename to generated/abis/IRebalancer.d.ts
index 971f5f1..71bebfc 100644
--- a/generated/abis/IHarvester.d.ts
+++ b/generated/abis/IRebalancer.d.ts
@@ -1,4 +1,4 @@
-export type Abi_IHarvester = [
+export type Abi_IRebalancer = [
   {
     "inputs": [
       {
@@ -97,4 +97,4 @@ export type Abi_IHarvester = [
     "type": "function"
   }
 ];
-export declare const Abi_IHarvester: Abi_IHarvester;
+export declare const Abi_IRebalancer: Abi_IRebalancer;
diff --git a/generated/abis/IHarvester.js b/generated/abis/IRebalancer.js
similarity index 97%
rename from generated/abis/IHarvester.js
rename to generated/abis/IRebalancer.js
index 6c01bbf..f69a3a1 100644
--- a/generated/abis/IHarvester.js
+++ b/generated/abis/IRebalancer.js
@@ -1,4 +1,4 @@
-export const Abi_IHarvester = /** @type {const} **/ ([
+export const Abi_IRebalancer = /** @type {const} **/ ([
   {
     "inputs": [
       {
diff --git a/generated/abis/index.d.ts b/generated/abis/index.d.ts
index a554fcb..9586460 100644
--- a/generated/abis/index.d.ts
+++ b/generated/abis/index.d.ts
@@ -5,11 +5,11 @@ export {Abi_IDiamondCut as IDiamondCut} from "./IDiamondCut.js"
 export {Abi_IDiamondEtherscan as IDiamondEtherscan} from "./IDiamondEtherscan.js"
 export {Abi_IDiamondLoupe as IDiamondLoupe} from "./IDiamondLoupe.js"
 export {Abi_IGetters as IGetters} from "./IGetters.js"
-export {Abi_IHarvester as IHarvester} from "./IHarvester.js"
 export {Abi_IManager as IManager} from "./IManager.js"
 export {Abi_IParallelizer as IParallelizer} from "./IParallelizer.js"
 export {Abi_IParallelizerOracle as IParallelizerOracle} from "./IParallelizerOracle.js"
 export {Abi_IPool as IPool} from "./IPool.js"
+export {Abi_IRebalancer as IRebalancer} from "./IRebalancer.js"
 export {Abi_IRedeemer as IRedeemer} from "./IRedeemer.js"
 export {Abi_IRewardHandler as IRewardHandler} from "./IRewardHandler.js"
 export {Abi_ISavings as ISavings} from "./ISavings.js"
diff --git a/generated/abis/index.js b/generated/abis/index.js
index a554fcb..9586460 100644
--- a/generated/abis/index.js
+++ b/generated/abis/index.js
@@ -5,11 +5,11 @@ export {Abi_IDiamondCut as IDiamondCut} from "./IDiamondCut.js"
 export {Abi_IDiamondEtherscan as IDiamondEtherscan} from "./IDiamondEtherscan.js"
 export {Abi_IDiamondLoupe as IDiamondLoupe} from "./IDiamondLoupe.js"
 export {Abi_IGetters as IGetters} from "./IGetters.js"
-export {Abi_IHarvester as IHarvester} from "./IHarvester.js"
 export {Abi_IManager as IManager} from "./IManager.js"
 export {Abi_IParallelizer as IParallelizer} from "./IParallelizer.js"
 export {Abi_IParallelizerOracle as IParallelizerOracle} from "./IParallelizerOracle.js"
 export {Abi_IPool as IPool} from "./IPool.js"
+export {Abi_IRebalancer as IRebalancer} from "./IRebalancer.js"
 export {Abi_IRedeemer as IRedeemer} from "./IRedeemer.js"
 export {Abi_IRewardHandler as IRewardHandler} from "./IRewardHandler.js"
 export {Abi_ISavings as ISavings} from "./ISavings.js"

From dab8270df9df8676dae6a2c31a85adc4241de532 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 10:55:54 +0300
Subject: [PATCH 08/28] docs(rebalancer): restore upstream names in the Angle
 attribution

The rename also rewrote the references to Angle's own files, so the
attribution named contracts that do not exist upstream and the links no
longer resolved. Angle's files are BaseHarvester, GenericHarvester and
MultiBlockHarvester, and the notices now name them again.

BaseRebalancer and GenericRebalancer are marked as substantially
modified, which is accurate for both; MultiBlockRebalancer is unchanged
beyond its name and keeps the plain notice.
---
 contracts/helpers/BaseRebalancer.sol       | 4 ++--
 contracts/helpers/GenericRebalancer.sol    | 4 ++--
 contracts/helpers/MultiBlockRebalancer.sol | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/contracts/helpers/BaseRebalancer.sol b/contracts/helpers/BaseRebalancer.sol
index ca74d53..9ee9da5 100644
--- a/contracts/helpers/BaseRebalancer.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -30,8 +30,8 @@ struct YieldBearingParams {
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
 /// @dev Abstract contract for a rebalancer that aims at rebalancing a Parallelizer
-/// @dev This contract is an authorized fork of Angle's BaseRebalancer contract:
-/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseRebalancer.sol
+/// @dev This contract is an authorized fork of Angle's BaseHarvester contract, substantially modified:
+/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/BaseHarvester.sol
 abstract contract BaseRebalancer is IRebalancer, AccessManaged {
   using SafeERC20 for IERC20;
 
diff --git a/contracts/helpers/GenericRebalancer.sol b/contracts/helpers/GenericRebalancer.sol
index 32dd100..dec0ebe 100644
--- a/contracts/helpers/GenericRebalancer.sol
+++ b/contracts/helpers/GenericRebalancer.sol
@@ -26,8 +26,8 @@ enum SwapType {
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
 /// @dev Generic contract for trusted callers to adjust the reserves of Angle Parallelizer
-/// @dev This contract is an authorized fork of Angle's GenericRebalancer contract:
-/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericRebalancer.sol
+/// @dev This contract is an authorized fork of Angle's GenericHarvester contract, substantially modified:
+/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/GenericHarvester.sol
 contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapper {
   using SafeCast for uint256;
   using SafeERC20 for IERC20;
diff --git a/contracts/helpers/MultiBlockRebalancer.sol b/contracts/helpers/MultiBlockRebalancer.sol
index d8b9697..aa1166a 100644
--- a/contracts/helpers/MultiBlockRebalancer.sol
+++ b/contracts/helpers/MultiBlockRebalancer.sol
@@ -17,8 +17,8 @@ import "../utils/Constants.sol";
 /// @author Cooper Labs
 /// @custom:contact security@cooperlabs.xyz
 /// @dev Contract to harvest yield from multiple yield bearing assets in multiple blocks transactions
-/// @dev This contract is an authorized fork of Angle's MultiBlockRebalancer contract:
-/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/MultiBlockRebalancer.sol
+/// @dev This contract is an authorized fork of Angle's MultiBlockHarvester contract:
+/// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/helpers/MultiBlockHarvester.sol
 contract MultiBlockRebalancer is BaseRebalancer {
   using SafeERC20 for IERC20;
   using Math for uint256;

From 87a788178f6c76b1778c3cf471baf3718535eef5 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 11:09:18 +0300
Subject: [PATCH 09/28] fix(rebalancer): return unconsumed router input instead
 of reverting

The previous check rejected any route that consumed less than it was
offered. That is too strict: the input is sized on chain from the live
Parallelizer state while the router calldata is built off chain, so the
two cannot be expected to match exactly, and any upward drift between
the keeper's simulation and inclusion would have failed the rebalance.

The remainder is now swapped back through the Parallelizer and added to
the settlement, so it reaches the initiating caller's budget rather than
being stranded. The router allowance is also cleared after the swap so a
partial fill leaves nothing standing.

Refines Bailsec Core Issue_07.
---
 contracts/helpers/GenericRebalancer.sol | 28 ++++++++++++++++++++-----
 contracts/utils/Errors.sol              |  1 -
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/contracts/helpers/GenericRebalancer.sol b/contracts/helpers/GenericRebalancer.sol
index dec0ebe..fa40258 100644
--- a/contracts/helpers/GenericRebalancer.sol
+++ b/contracts/helpers/GenericRebalancer.sol
@@ -163,14 +163,12 @@ contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapp
     // Swap to tokenOut
     amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);
 
-    // A partial fill would leave both the unspent input and its router allowance on this contract
-    if (IERC20(tokenIn).balanceOf(address(this)) > tokenInBalanceBefore) {
-      revert RouterDidNotConsumeAllTokens();
-    }
-
     _adjustAllowance(tokenOut, address(parallelizer), amountOut);
     uint256 amountStableOut =
       parallelizer.swapExactInput(amountOut, minAmountOut, tokenOut, address(tokenP), address(this), block.timestamp);
+
+    amountStableOut += _recoverResidualInput(tokenIn, tokenInBalanceBefore);
+
     if (amount > amountStableOut) {
       budget[sender] -= amount - amountStableOut; // Will revert if not enough funds
     } else if (amountStableOut > amount) {
@@ -228,6 +226,24 @@ contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapp
     );
   }
 
+  /**
+   * @dev Returns any input the route did not consume to the Parallelizer
+   * @param tokenIn address of the token offered to the route
+   * @param balanceBefore balance of `tokenIn` held before the operation
+   * @return the tokenP obtained from the remainder, zero when the route consumed everything
+   *
+   * Router calldata is built off chain while the input is sized on chain, so a route can consume
+   * less than was offered. Returning the remainder keeps it inside the Parallelizer's accounting
+   * instead of stranding it here, and it settles with the rest of the operation.
+   */
+  function _recoverResidualInput(address tokenIn, uint256 balanceBefore) internal returns (uint256) {
+    uint256 balanceAfter = IERC20(tokenIn).balanceOf(address(this));
+    if (balanceAfter <= balanceBefore) return 0;
+    uint256 residual = balanceAfter - balanceBefore;
+    _adjustAllowance(tokenIn, address(parallelizer), residual);
+    return parallelizer.swapExactInput(residual, 0, tokenIn, address(tokenP), address(this), block.timestamp);
+  }
+
   function _swapToTokenOut(
     uint256 typeAction,
     address tokenIn,
@@ -271,6 +287,8 @@ contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapp
     uint256[] memory amounts = new uint256[](1);
     amounts[0] = amount;
     _swap(tokens, callDatas, amounts);
+    // A route that consumed less than offered would otherwise leave the difference approved
+    IERC20(tokenIn).forceApprove(tokenTransferAddress, 0);
 
     return IERC20(tokenOut).balanceOf(address(this)) - balance;
   }
diff --git a/contracts/utils/Errors.sol b/contracts/utils/Errors.sol
index 39b1db1..6ee3525 100644
--- a/contracts/utils/Errors.sol
+++ b/contracts/utils/Errors.sol
@@ -55,7 +55,6 @@ error ZeroAddress();
 error ZeroAmount();
 error ZeroSurplusAmount();
 error SwapError();
-error RouterDidNotConsumeAllTokens();
 error SlippageTooHigh();
 error InsufficientFunds();
 error Undercollateralized();

From 7497d1cbf19d1b1ac6d9be376bdc8c5aac12103c Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 11:18:15 +0300
Subject: [PATCH 10/28] test(rebalancer): cover the harvest flash loan
 settlement path

onFlashLoan had no coverage at all, so neither the router leg nor the
budget settlement was exercised. A zero-fee ERC-3156 lender mock lets the
existing MockRouter drive a route that consumes less input than it was
offered.

Without the recovery the run leaves 781.198 of the input stranded on the
rebalancer; the test asserts nothing is left, no router allowance
survives, and the recovered value reaches the caller's budget.
---
 tests/mock/MockFlashLoan.sol | 37 ++++++++++++++++++
 tests/units/Rebalancer.t.sol | 76 ++++++++++++++++++++++++++++++++++++
 2 files changed, 113 insertions(+)
 create mode 100644 tests/mock/MockFlashLoan.sol

diff --git a/tests/mock/MockFlashLoan.sol b/tests/mock/MockFlashLoan.sol
new file mode 100644
index 0000000..b2ac3f0
--- /dev/null
+++ b/tests/mock/MockFlashLoan.sol
@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: Unlicensed
+pragma solidity 0.8.28;
+
+import { IERC3156FlashBorrower } from "@openzeppelin/contracts/interfaces/IERC3156FlashBorrower.sol";
+import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+
+import { MockTokenPermit } from "./MockTokenPermit.sol";
+
+/// @dev Zero-fee ERC-3156 lender: mints the principal to the borrower and pulls it back through the
+/// allowance the borrower granted, mirroring FlashParallelToken closely enough for the rebalancer.
+contract MockFlashLoan {
+  bytes32 internal constant CALLBACK_SUCCESS = keccak256("ERC3156FlashBorrower.onFlashLoan");
+
+  function maxFlashLoan(address) external pure returns (uint256) {
+    return type(uint256).max;
+  }
+
+  function flashFee(address, uint256) external pure returns (uint256) {
+    return 0;
+  }
+
+  function flashLoan(
+    IERC3156FlashBorrower receiver,
+    address token,
+    uint256 amount,
+    bytes calldata data
+  )
+    external
+    returns (bool)
+  {
+    MockTokenPermit(token).mint(address(receiver), amount);
+    require(receiver.onFlashLoan(msg.sender, token, amount, 0, data) == CALLBACK_SUCCESS, "bad callback");
+    IERC20(token).transferFrom(address(receiver), address(this), amount);
+    MockTokenPermit(token).burn(address(this), amount);
+    return true;
+  }
+}
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index 7312797..00f0244 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -3,6 +3,13 @@
 pragma solidity 0.8.28;
 
 import { MultiBlockRebalancer } from "contracts/helpers/MultiBlockRebalancer.sol";
+import { GenericRebalancer, SwapType } from "contracts/helpers/GenericRebalancer.sol";
+import { IERC3156FlashLender } from "@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol";
+import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+
+import { MockRouter } from "../mock/MockRouter.sol";
+import { MockFlashLoan } from "../mock/MockFlashLoan.sol";
+import { MockTokenPermit } from "../mock/MockTokenPermit.sol";
 import { IParallelizer } from "contracts/interfaces/IParallelizer.sol";
 import "contracts/utils/Constants.sol";
 import "contracts/utils/Errors.sol" as Errors;
@@ -51,3 +58,72 @@ contract Test_Rebalancer_MaxSlippage is Fixture {
     rebalancer.setMaxSlippage(yieldBearingAsset, 1e7);
   }
 }
+
+
+contract Test_Rebalancer_ResidualInput is Fixture {
+  GenericRebalancer internal rebalancer;
+  MockRouter internal router;
+  MockFlashLoan internal lender;
+
+  function setUp() public override {
+    super.setUp();
+
+    router = new MockRouter();
+    lender = new MockFlashLoan();
+    rebalancer = new GenericRebalancer(
+      address(router), address(router), tokenP, parallelizer, address(accessManager), IERC3156FlashLender(address(lender))
+    );
+
+    vm.startPrank(governor);
+    accessManager.setTargetFunctionRole(
+      address(rebalancer), getGuardianBaseRebalancerSelectorAccess(), GUARDIAN_ROLE
+    );
+    accessManager.grantRole(GUARDIAN_ROLE, guardian, 0);
+    vm.stopPrank();
+
+    // eurY is the yield bearing asset, eurA its underlying. Target exposure well below the live one
+    // so the rebalance decreases eurY and the router leg runs with eurY as the input.
+    vm.startPrank(guardian);
+    rebalancer.toggleTrusted(alice);
+    rebalancer.setYieldBearingAssetData(address(eurY), address(eurA), 2e8, 1e7, 9e8, 1, 5e8);
+    vm.stopPrank();
+
+    _mintCollateral(address(eurY), 100_000 ether);
+    _mintCollateral(address(eurA), 1000 * BASE_6);
+
+    // The router needs the output leg to hand back, and alice a budget to settle against
+    deal(address(eurA), address(router), 1_000_000 * BASE_6);
+    deal(address(tokenP), alice, 100_000 ether);
+    vm.startPrank(alice);
+    IERC20(address(tokenP)).approve(address(rebalancer), type(uint256).max);
+    rebalancer.addBudget(50_000 ether, alice);
+    vm.stopPrank();
+  }
+
+  function _mintCollateral(address collateral, uint256 amount) internal {
+    deal(collateral, governor, amount);
+    vm.startPrank(governor);
+    IERC20(collateral).approve(address(parallelizer), amount);
+    parallelizer.swapExactInput(amount, 0, collateral, address(tokenP), governor, block.timestamp + 1 hours);
+    vm.stopPrank();
+  }
+
+  /// @dev The route consumes less input than it was offered: the remainder must come back rather
+  /// than sit on the rebalancer, and no router allowance may survive the call.
+  function test_Harvest_ReturnsInputTheRouteDidNotConsume() public {
+    uint256 consumed = 1 ether;
+    bytes memory swapData = abi.encodeWithSelector(
+      MockRouter.swap.selector, consumed, address(eurY), 5000 * BASE_6, address(eurA)
+    );
+
+    uint256 budgetBefore = rebalancer.budget(alice);
+
+    vm.prank(alice);
+    rebalancer.harvest(address(eurY), 1e7, abi.encode(SwapType.SWAP, swapData));
+
+    assertEq(IERC20(address(eurY)).balanceOf(address(rebalancer)), 0, "input left stranded on the rebalancer");
+    assertEq(IERC20(address(eurY)).allowance(address(rebalancer), address(router)), 0, "router allowance survived");
+    // The recovered input settles with the operation, so the surplus reaches the initiating caller
+    assertGt(rebalancer.budget(alice), budgetBefore, "settlement surplus not credited");
+  }
+}

From f57482c66f646b9455074a7e6e7d03b3f82f2432 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 11:30:57 +0300
Subject: [PATCH 11/28] fix(rebalancer): revoke allowances a configuration
 rotation leaves behind

Rebalancing grants unlimited allowances and never reduces them, while
rotating a yield bearing asset or a deposit address only overwrote the
configuration. The outgoing spender kept authority over any of that token
the contract later held, for the rest of the contract's life.

Both rotations now revoke the approval they made obsolete, and governance
gets resetAllowance as the escape hatch for anything else, as recommended.

Closes Bailsec Core Issue_02.
---
 contracts/helpers/BaseRebalancer.sol       | 21 ++++++
 contracts/helpers/MultiBlockRebalancer.sol |  7 ++
 generated/abis/BaseRebalancer.d.ts         | 37 +++++++++++
 generated/abis/BaseRebalancer.js           | 37 +++++++++++
 generated/abis/GenericRebalancer.d.ts      | 42 ++++++++++--
 generated/abis/GenericRebalancer.js        | 42 ++++++++++--
 generated/abis/MultiBlockRebalancer.d.ts   | 37 +++++++++++
 generated/abis/MultiBlockRebalancer.js     | 37 +++++++++++
 scripts/SetGenericRebalancerRoles.s.sol    |  3 +-
 tests/units/Rebalancer.t.sol               | 75 ++++++++++++++++++++++
 tests/utils/ConfigAccessManager.sol        |  3 +-
 11 files changed, 329 insertions(+), 12 deletions(-)

diff --git a/contracts/helpers/BaseRebalancer.sol b/contracts/helpers/BaseRebalancer.sol
index 9ee9da5..b9d22a6 100644
--- a/contracts/helpers/BaseRebalancer.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -78,6 +78,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
 
   event Recovered(address token, uint256 amount, address to);
   event TrustedToggled(address trusted, bool status);
+  event AllowanceReset(address indexed token, address indexed spender);
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
                                                        CONSTRUCTOR
@@ -163,6 +164,19 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     IERC20(tokenAddress).safeTransfer(to, amountToRecover);
   }
 
+  /**
+   * @notice Set an allowance this contract granted back to zero
+   * @param token address of the token
+   * @param spender address losing the allowance
+   * @dev Rebalancing grants unlimited allowances that are never reduced. Rotating a yield bearing
+   * asset's configuration revokes the approvals it created, but this covers a spender that became
+   * untrusted for any other reason.
+   */
+  function resetAllowance(address token, address spender) external restricted {
+    IERC20(token).forceApprove(spender, 0);
+    emit AllowanceReset(token, spender);
+  }
+
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
                                                         TRUSTED FUNCTIONS
   //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
@@ -244,6 +258,13 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     virtual
   {
     YieldBearingParams storage yieldBearingInfo = yieldBearingData[yieldBearingAsset];
+    address previousAsset = yieldBearingInfo.asset;
+    // Allowances are granted without expiry, so the outgoing asset would keep the yield bearing
+    // vault authorised over any of it later held here
+    if (previousAsset != address(0) && previousAsset != asset) {
+      IERC20(previousAsset).forceApprove(yieldBearingAsset, 0);
+      emit AllowanceReset(previousAsset, yieldBearingAsset);
+    }
     yieldBearingInfo.asset = asset;
     if (targetExposure >= 1e9) revert InvalidParam();
     if (maxSlippage >= 1e9) revert InvalidParam();
diff --git a/contracts/helpers/MultiBlockRebalancer.sol b/contracts/helpers/MultiBlockRebalancer.sol
index aa1166a..8edd3f5 100644
--- a/contracts/helpers/MultiBlockRebalancer.sol
+++ b/contracts/helpers/MultiBlockRebalancer.sol
@@ -52,6 +52,13 @@ contract MultiBlockRebalancer is BaseRebalancer {
    * @param newDepositAddress address to deposit to receive yieldBearingAsset
    */
   function setYieldBearingToDepositAddress(address yieldBearingAsset, address newDepositAddress) external restricted {
+    address previousDepositAddress = yieldBearingToDepositAddress[yieldBearingAsset];
+    address asset = yieldBearingData[yieldBearingAsset].asset;
+    // The outgoing deposit address would otherwise keep its allowance over the underlying asset
+    if (previousDepositAddress != address(0) && previousDepositAddress != newDepositAddress && asset != address(0)) {
+      IERC20(asset).forceApprove(previousDepositAddress, 0);
+      emit AllowanceReset(asset, previousDepositAddress);
+    }
     yieldBearingToDepositAddress[yieldBearingAsset] = newDepositAddress;
   }
 
diff --git a/generated/abis/BaseRebalancer.d.ts b/generated/abis/BaseRebalancer.d.ts
index c2b2c58..c0b1549 100644
--- a/generated/abis/BaseRebalancer.d.ts
+++ b/generated/abis/BaseRebalancer.d.ts
@@ -58,6 +58,25 @@ export type Abi_BaseRebalancer = [
     "name": "SafeERC20FailedOperation",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "AllowanceReset",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -243,6 +262,24 @@ export type Abi_BaseRebalancer = [
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "resetAllowance",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/BaseRebalancer.js b/generated/abis/BaseRebalancer.js
index 9fbc394..01d033e 100644
--- a/generated/abis/BaseRebalancer.js
+++ b/generated/abis/BaseRebalancer.js
@@ -58,6 +58,25 @@ export const Abi_BaseRebalancer = /** @type {const} **/ ([
     "name": "SafeERC20FailedOperation",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "AllowanceReset",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -243,6 +262,24 @@ export const Abi_BaseRebalancer = /** @type {const} **/ ([
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "resetAllowance",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/GenericRebalancer.d.ts b/generated/abis/GenericRebalancer.d.ts
index 2649a77..02676fa 100644
--- a/generated/abis/GenericRebalancer.d.ts
+++ b/generated/abis/GenericRebalancer.d.ts
@@ -88,11 +88,6 @@ export type Abi_GenericRebalancer = [
     "name": "NotTrustedOrGuardian",
     "type": "error"
   },
-  {
-    "inputs": [],
-    "name": "RouterDidNotConsumeAllTokens",
-    "type": "error"
-  },
   {
     "inputs": [
       {
@@ -119,6 +114,25 @@ export type Abi_GenericRebalancer = [
     "name": "ZeroAmount",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "AllowanceReset",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -450,6 +464,24 @@ export type Abi_GenericRebalancer = [
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "resetAllowance",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/GenericRebalancer.js b/generated/abis/GenericRebalancer.js
index 626c4fb..816a64c 100644
--- a/generated/abis/GenericRebalancer.js
+++ b/generated/abis/GenericRebalancer.js
@@ -88,11 +88,6 @@ export const Abi_GenericRebalancer = /** @type {const} **/ ([
     "name": "NotTrustedOrGuardian",
     "type": "error"
   },
-  {
-    "inputs": [],
-    "name": "RouterDidNotConsumeAllTokens",
-    "type": "error"
-  },
   {
     "inputs": [
       {
@@ -119,6 +114,25 @@ export const Abi_GenericRebalancer = /** @type {const} **/ ([
     "name": "ZeroAmount",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "AllowanceReset",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -450,6 +464,24 @@ export const Abi_GenericRebalancer = /** @type {const} **/ ([
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "resetAllowance",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/MultiBlockRebalancer.d.ts b/generated/abis/MultiBlockRebalancer.d.ts
index 96cff3f..18e1fcb 100644
--- a/generated/abis/MultiBlockRebalancer.d.ts
+++ b/generated/abis/MultiBlockRebalancer.d.ts
@@ -94,6 +94,25 @@ export type Abi_MultiBlockRebalancer = [
     "name": "ZeroAmount",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "AllowanceReset",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -297,6 +316,24 @@ export type Abi_MultiBlockRebalancer = [
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "resetAllowance",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/MultiBlockRebalancer.js b/generated/abis/MultiBlockRebalancer.js
index c2abb49..523e7b2 100644
--- a/generated/abis/MultiBlockRebalancer.js
+++ b/generated/abis/MultiBlockRebalancer.js
@@ -94,6 +94,25 @@ export const Abi_MultiBlockRebalancer = /** @type {const} **/ ([
     "name": "ZeroAmount",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "AllowanceReset",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -297,6 +316,24 @@ export const Abi_MultiBlockRebalancer = /** @type {const} **/ ([
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "token",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "name": "resetAllowance",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/scripts/SetGenericRebalancerRoles.s.sol b/scripts/SetGenericRebalancerRoles.s.sol
index 6f81662..086c6ef 100644
--- a/scripts/SetGenericRebalancerRoles.s.sol
+++ b/scripts/SetGenericRebalancerRoles.s.sol
@@ -10,12 +10,13 @@ contract SetGenericRebalancerRoles is BaseScript {
   address genericRebalancer = 0x57770C1721Eb35509f38210A935c8b1911db7E0e;
 
   function run() public broadcast {
-    bytes4[] memory guardianSelectors = new bytes4[](5);
+    bytes4[] memory guardianSelectors = new bytes4[](6);
     guardianSelectors[0] = BaseRebalancer.setYieldBearingAssetData.selector;
     guardianSelectors[1] = BaseRebalancer.setMaxSlippage.selector;
     guardianSelectors[2] = BaseRebalancer.toggleTrusted.selector;
     guardianSelectors[3] = BaseRebalancer.recoverERC20.selector;
     guardianSelectors[4] = BaseRebalancer.setTargetExposure.selector;
+    guardianSelectors[5] = BaseRebalancer.resetAllowance.selector;
     accessManager.setTargetFunctionRole(genericRebalancer, guardianSelectors, Roles.GUARDIAN_ROLE);
 
     bytes4[] memory governorSelectors = new bytes4[](2);
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index 00f0244..d0376ea 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -127,3 +127,78 @@ contract Test_Rebalancer_ResidualInput is Fixture {
     assertGt(rebalancer.budget(alice), budgetBefore, "settlement surplus not credited");
   }
 }
+
+
+contract Test_Rebalancer_Allowances is Fixture {
+  MultiBlockRebalancer internal rebalancer;
+
+  function setUp() public override {
+    super.setUp();
+
+    rebalancer = new MultiBlockRebalancer(address(accessManager), tokenP, parallelizer);
+
+    vm.startPrank(governor);
+    accessManager.setTargetFunctionRole(
+      address(rebalancer), getGuardianBaseRebalancerSelectorAccess(), GUARDIAN_ROLE
+    );
+    accessManager.setTargetFunctionRole(
+      address(rebalancer), getGovernorMultiBlockRebalancerSelectorAccess(), GOVERNOR_ROLE
+    );
+    accessManager.grantRole(GUARDIAN_ROLE, guardian, 0);
+    vm.stopPrank();
+
+    vm.prank(guardian);
+    rebalancer.setYieldBearingAssetData(address(eurY), address(eurA), 5e8, 1e8, 9e8, 1, 5e7);
+  }
+
+  /// @dev Stands in for the unlimited allowance a previous rebalance would have granted
+  function _seedAllowance(address token, address spender) internal {
+    vm.prank(address(rebalancer));
+    IERC20(token).approve(spender, type(uint256).max);
+    assertEq(IERC20(token).allowance(address(rebalancer), spender), type(uint256).max);
+  }
+
+  function test_RotatingTheAsset_RevokesTheOutgoingAllowance() public {
+    _seedAllowance(address(eurA), address(eurY));
+
+    vm.prank(guardian);
+    rebalancer.setYieldBearingAssetData(address(eurY), address(eurB), 5e8, 1e8, 9e8, 1, 5e7);
+
+    assertEq(IERC20(address(eurA)).allowance(address(rebalancer), address(eurY)), 0);
+  }
+
+  function test_RotatingTheAsset_KeepsTheAllowanceWhenAssetIsUnchanged() public {
+    _seedAllowance(address(eurA), address(eurY));
+
+    vm.prank(guardian);
+    rebalancer.setYieldBearingAssetData(address(eurY), address(eurA), 4e8, 1e8, 9e8, 1, 5e7);
+
+    assertEq(IERC20(address(eurA)).allowance(address(rebalancer), address(eurY)), type(uint256).max);
+  }
+
+  function test_RotatingTheDepositAddress_RevokesTheOutgoingAllowance() public {
+    vm.prank(governor);
+    rebalancer.setYieldBearingToDepositAddress(address(eurY), bob);
+    _seedAllowance(address(eurA), bob);
+
+    vm.prank(governor);
+    rebalancer.setYieldBearingToDepositAddress(address(eurY), charlie);
+
+    assertEq(IERC20(address(eurA)).allowance(address(rebalancer), bob), 0);
+  }
+
+  function test_ResetAllowance() public {
+    _seedAllowance(address(eurA), bob);
+
+    vm.prank(guardian);
+    rebalancer.resetAllowance(address(eurA), bob);
+
+    assertEq(IERC20(address(eurA)).allowance(address(rebalancer), bob), 0);
+  }
+
+  function test_RevertWhen_ResetAllowanceNotGuardian() public {
+    vm.prank(alice);
+    vm.expectRevert(abi.encodeWithSelector(Errors.AccessManagedUnauthorized.selector, alice));
+    rebalancer.resetAllowance(address(eurA), bob);
+  }
+}
diff --git a/tests/utils/ConfigAccessManager.sol b/tests/utils/ConfigAccessManager.sol
index c603576..3fa285e 100644
--- a/tests/utils/ConfigAccessManager.sol
+++ b/tests/utils/ConfigAccessManager.sol
@@ -63,12 +63,13 @@ abstract contract ConfigAccessManager is Helper {
   }
 
   function getGuardianBaseRebalancerSelectorAccess() internal pure returns (bytes4[] memory) {
-    bytes4[] memory selectors = new bytes4[](5);
+    bytes4[] memory selectors = new bytes4[](6);
     selectors[0] = BaseRebalancer.setYieldBearingAssetData.selector;
     selectors[1] = BaseRebalancer.setMaxSlippage.selector;
     selectors[2] = BaseRebalancer.toggleTrusted.selector;
     selectors[3] = BaseRebalancer.recoverERC20.selector;
     selectors[4] = BaseRebalancer.setTargetExposure.selector;
+    selectors[5] = BaseRebalancer.resetAllowance.selector;
     return selectors;
   }
 

From 9a12fc6c1ea83df2a24885a3692f4f83b008719e Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 12:16:21 +0300
Subject: [PATCH 12/28] fix(rebalancer): settle the flash loan fee instead of
 rejecting it

`onFlashLoan` refused any callback reporting a non-zero fee, so enabling the
USDp flash loan fee would have left the rebalancer with no working path to
adjust the Parallelizer's yield bearing exposure.

The fee is now folded into what the lender pulls back and settled against the
budget of the address that called `harvest`, alongside the usual shortfall or
surplus. A fee the caller cannot cover fails the rebalance rather than reaching
into another caller's budget.

Bailsec Core Issue_06
---
 contracts/helpers/GenericRebalancer.sol |  6 +-
 tests/mock/MockFlashLoan.sol            | 17 +++--
 tests/units/Rebalancer.t.sol            | 97 +++++++++++++++++++++++++
 3 files changed, 114 insertions(+), 6 deletions(-)

diff --git a/contracts/helpers/GenericRebalancer.sol b/contracts/helpers/GenericRebalancer.sol
index fa40258..5984850 100644
--- a/contracts/helpers/GenericRebalancer.sol
+++ b/contracts/helpers/GenericRebalancer.sol
@@ -121,6 +121,8 @@ contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapp
   }
 
   /// @inheritdoc IERC3156FlashBorrower
+  /// @dev A non-zero lender fee is charged to the budget of the address that called `harvest`, alongside any
+  /// shortfall between the principal and the tokenP the rebalance minted back
   function onFlashLoan(
     address initiator,
     address,
@@ -132,7 +134,7 @@ contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapp
     virtual
     returns (bytes32)
   {
-    if (msg.sender != address(flashloan) || initiator != address(this) || fee != 0) revert NotTrusted();
+    if (msg.sender != address(flashloan) || initiator != address(this)) revert NotTrusted();
     address sender;
     uint256 typeAction;
     uint256 minAmountOut;
@@ -159,6 +161,8 @@ contract GenericRebalancer is BaseRebalancer, IERC3156FlashBorrower, RouterSwapp
 
     uint256 amountOut =
       parallelizer.swapExactInput(amount, 0, address(tokenP), tokenIn, address(this), block.timestamp);
+    // The principal is spent, what the lender will pull back is the principal plus its fee
+    amount += fee;
 
     // Swap to tokenOut
     amountOut = _swapToTokenOut(typeAction, tokenIn, tokenOut, amountOut, swapType, callData);
diff --git a/tests/mock/MockFlashLoan.sol b/tests/mock/MockFlashLoan.sol
index b2ac3f0..94d818e 100644
--- a/tests/mock/MockFlashLoan.sol
+++ b/tests/mock/MockFlashLoan.sol
@@ -6,17 +6,23 @@ import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
 
 import { MockTokenPermit } from "./MockTokenPermit.sol";
 
-/// @dev Zero-fee ERC-3156 lender: mints the principal to the borrower and pulls it back through the
+/// @dev ERC-3156 lender: mints the principal to the borrower and pulls back principal plus fee through the
 /// allowance the borrower granted, mirroring FlashParallelToken closely enough for the rebalancer.
 contract MockFlashLoan {
   bytes32 internal constant CALLBACK_SUCCESS = keccak256("ERC3156FlashBorrower.onFlashLoan");
 
+  uint256 public feeRate;
+
+  function setFeeRate(uint256 newFeeRate) external {
+    feeRate = newFeeRate;
+  }
+
   function maxFlashLoan(address) external pure returns (uint256) {
     return type(uint256).max;
   }
 
-  function flashFee(address, uint256) external pure returns (uint256) {
-    return 0;
+  function flashFee(address, uint256 amount) public view returns (uint256) {
+    return (amount * feeRate) / 1e9;
   }
 
   function flashLoan(
@@ -28,9 +34,10 @@ contract MockFlashLoan {
     external
     returns (bool)
   {
+    uint256 fee = flashFee(token, amount);
     MockTokenPermit(token).mint(address(receiver), amount);
-    require(receiver.onFlashLoan(msg.sender, token, amount, 0, data) == CALLBACK_SUCCESS, "bad callback");
-    IERC20(token).transferFrom(address(receiver), address(this), amount);
+    require(receiver.onFlashLoan(msg.sender, token, amount, fee, data) == CALLBACK_SUCCESS, "bad callback");
+    IERC20(token).transferFrom(address(receiver), address(this), amount + fee);
     MockTokenPermit(token).burn(address(this), amount);
     return true;
   }
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index d0376ea..b981c14 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -4,6 +4,7 @@ pragma solidity 0.8.28;
 
 import { MultiBlockRebalancer } from "contracts/helpers/MultiBlockRebalancer.sol";
 import { GenericRebalancer, SwapType } from "contracts/helpers/GenericRebalancer.sol";
+import { stdError } from "@forge-std/Test.sol";
 import { IERC3156FlashLender } from "@openzeppelin/contracts/interfaces/IERC3156FlashLender.sol";
 import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
 
@@ -202,3 +203,99 @@ contract Test_Rebalancer_Allowances is Fixture {
     rebalancer.resetAllowance(address(eurA), bob);
   }
 }
+
+
+contract Test_Rebalancer_FlashLoanFee is Fixture {
+  GenericRebalancer internal rebalancer;
+  MockRouter internal router;
+  MockFlashLoan internal lender;
+
+  function setUp() public override {
+    super.setUp();
+
+    router = new MockRouter();
+    lender = new MockFlashLoan();
+    rebalancer = new GenericRebalancer(
+      address(router), address(router), tokenP, parallelizer, address(accessManager), IERC3156FlashLender(address(lender))
+    );
+
+    vm.startPrank(governor);
+    accessManager.setTargetFunctionRole(
+      address(rebalancer), getGuardianBaseRebalancerSelectorAccess(), GUARDIAN_ROLE
+    );
+    accessManager.grantRole(GUARDIAN_ROLE, guardian, 0);
+    vm.stopPrank();
+
+    vm.startPrank(guardian);
+    rebalancer.toggleTrusted(alice);
+    rebalancer.setYieldBearingAssetData(address(eurY), address(eurA), 2e8, 1e7, 9e8, 1, 5e8);
+    vm.stopPrank();
+
+    _mintCollateral(address(eurY), 100_000 ether);
+    _mintCollateral(address(eurA), 1000 * BASE_6);
+
+    deal(address(eurA), address(router), 1_000_000 * BASE_6);
+    deal(address(tokenP), alice, 100_000 ether);
+    vm.startPrank(alice);
+    IERC20(address(tokenP)).approve(address(rebalancer), type(uint256).max);
+    rebalancer.addBudget(50_000 ether, alice);
+    vm.stopPrank();
+  }
+
+  function _mintCollateral(address collateral, uint256 amount) internal {
+    deal(collateral, governor, amount);
+    vm.startPrank(governor);
+    IERC20(collateral).approve(address(parallelizer), amount);
+    parallelizer.swapExactInput(amount, 0, collateral, address(tokenP), governor, block.timestamp + 1 hours);
+    vm.stopPrank();
+  }
+
+  function _harvest() internal {
+    bytes memory swapData =
+      abi.encodeWithSelector(MockRouter.swap.selector, 1 ether, address(eurY), 5000 * BASE_6, address(eurA));
+    vm.prank(alice);
+    rebalancer.harvest(address(eurY), 1e7, abi.encode(SwapType.SWAP, swapData));
+  }
+
+  /// @dev A lender charging a fee must not lock the rebalancer out of its only rebalance path
+  function test_Harvest_SucceedsWithANonZeroFee() public {
+    lender.setFeeRate(5e5);
+
+    _harvest();
+
+    assertGt(lender.flashFee(address(tokenP), 1 ether), 0, "fee rate produced no fee");
+  }
+
+  /// @dev The fee is settled out of the budget of the address that asked for the rebalance
+  function test_Harvest_ChargesTheFeeToTheCallerBudget() public {
+    uint256 snapshot = vm.snapshotState();
+
+    _harvest();
+    uint256 budgetWithoutFee = rebalancer.budget(alice);
+
+    vm.revertToState(snapshot);
+
+    lender.setFeeRate(5e5);
+    _harvest();
+    uint256 budgetWithFee = rebalancer.budget(alice);
+
+    assertLt(budgetWithFee, budgetWithoutFee, "fee was not charged");
+    // The lender kept exactly what it was owed on top of the principal
+    assertEq(
+      budgetWithoutFee - budgetWithFee,
+      IERC20(address(tokenP)).balanceOf(address(lender)),
+      "budget delta does not match the fee the lender collected"
+    );
+  }
+
+  /// @dev A fee the caller cannot cover fails the rebalance rather than dipping into other budgets
+  function test_RevertWhen_FeeExceedsTheCallerBudget() public {
+    lender.setFeeRate(1e15);
+
+    bytes memory swapData =
+      abi.encodeWithSelector(MockRouter.swap.selector, 1 ether, address(eurY), 5000 * BASE_6, address(eurA));
+    vm.prank(alice);
+    vm.expectRevert(stdError.arithmeticError);
+    rebalancer.harvest(address(eurY), 1e7, abi.encode(SwapType.SWAP, swapData));
+  }
+}

From 07c159f236eac7e6ca5182c7f95abe53f8e94245 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 12:55:34 +0300
Subject: [PATCH 13/28] test(rebalancer): express the mock flash loan fee in
 basis points

FlashParallelToken stores `feesRate` as a uint16 in basis points, capped at
100%. The mock scaled by 1e9 instead, so its rates read five orders of
magnitude away from anything governance could actually set.

The budget shortfall case now uses that real ceiling against a route that
clears `minAmountOut` with nothing spare, rather than a fee rate the live
contract would reject.
---
 tests/mock/MockFlashLoan.sol | 10 ++++++----
 tests/units/Rebalancer.t.sol | 13 +++++++++----
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/tests/mock/MockFlashLoan.sol b/tests/mock/MockFlashLoan.sol
index 94d818e..139ada6 100644
--- a/tests/mock/MockFlashLoan.sol
+++ b/tests/mock/MockFlashLoan.sol
@@ -11,10 +11,12 @@ import { MockTokenPermit } from "./MockTokenPermit.sol";
 contract MockFlashLoan {
   bytes32 internal constant CALLBACK_SUCCESS = keccak256("ERC3156FlashBorrower.onFlashLoan");
 
-  uint256 public feeRate;
+  /// @dev Basis points, as FlashParallelToken stores it
+  uint16 public feeRateBps;
 
-  function setFeeRate(uint256 newFeeRate) external {
-    feeRate = newFeeRate;
+  function setFeeRateBps(uint16 newFeeRateBps) external {
+    require(newFeeRateBps <= 1e4, "fee rate above 100%");
+    feeRateBps = newFeeRateBps;
   }
 
   function maxFlashLoan(address) external pure returns (uint256) {
@@ -22,7 +24,7 @@ contract MockFlashLoan {
   }
 
   function flashFee(address, uint256 amount) public view returns (uint256) {
-    return (amount * feeRate) / 1e9;
+    return (amount * feeRateBps) / 1e4;
   }
 
   function flashLoan(
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index b981c14..0754144 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -259,7 +259,7 @@ contract Test_Rebalancer_FlashLoanFee is Fixture {
 
   /// @dev A lender charging a fee must not lock the rebalancer out of its only rebalance path
   function test_Harvest_SucceedsWithANonZeroFee() public {
-    lender.setFeeRate(5e5);
+    lender.setFeeRateBps(5);
 
     _harvest();
 
@@ -275,7 +275,7 @@ contract Test_Rebalancer_FlashLoanFee is Fixture {
 
     vm.revertToState(snapshot);
 
-    lender.setFeeRate(5e5);
+    lender.setFeeRateBps(5);
     _harvest();
     uint256 budgetWithFee = rebalancer.budget(alice);
 
@@ -290,10 +290,15 @@ contract Test_Rebalancer_FlashLoanFee is Fixture {
 
   /// @dev A fee the caller cannot cover fails the rebalance rather than dipping into other budgets
   function test_RevertWhen_FeeExceedsTheCallerBudget() public {
-    lender.setFeeRate(1e15);
+    // The ceiling FlashParallelToken allows governance to set
+    lender.setFeeRateBps(1e4);
+    uint256 drained = rebalancer.budget(alice) - 1 ether;
+    vm.prank(alice);
+    rebalancer.removeBudget(drained, alice);
 
+    // A route that clears `minAmountOut` but leaves nothing spare to absorb the fee
     bytes memory swapData =
-      abi.encodeWithSelector(MockRouter.swap.selector, 1 ether, address(eurY), 5000 * BASE_6, address(eurA));
+      abi.encodeWithSelector(MockRouter.swap.selector, 1 ether, address(eurY), 500 * BASE_6, address(eurA));
     vm.prank(alice);
     vm.expectRevert(stdError.arithmeticError);
     rebalancer.harvest(address(eurY), 1e7, abi.encode(SwapType.SWAP, swapData));

From cbe2e3ea37cfaede78bfb1c9e05357320b253efe Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 15:47:19 +0300
Subject: [PATCH 14/28] fix(redeemer): bind the redemption output list to the
 caller's intent

`minAmountOuts` is positional and the output list is rebuilt at execution time
from the live `collateralList`. A revoke (swap and pop) followed by an add
preserves the length while reshuffling the tokens, so each minimum ends up
guarding a token the caller never quoted.

The three redeem entry points now take an `expectedTokensHash` over the output
list, checked against the live one, and the authorized path folds it into the
derived EIP-3009 nonce so a relayer cannot hold a signature until governance
rotates collateral.

This changes the ABI of `redeem`, `redeemWithForfeit` and
`redeemWithAuthorization`, and invalidates any redemption signature outstanding
at upgrade time.

Bailsec Core Issue_09
---
 contracts/interfaces/IRedeemer.sol            |  16 +-
 contracts/parallelizer/facets/Redeemer.sol    |  43 +--
 .../libraries/LibAuthorization.sol            |   8 +-
 contracts/utils/Errors.sol                    |   1 +
 generated/abis/IParallelizer.d.ts             |  15 +
 generated/abis/IParallelizer.js               |  15 +
 generated/abis/IRedeemer.d.ts                 |  15 +
 generated/abis/IRedeemer.js                   |  15 +
 generated/abis/Redeemer.d.ts                  |  20 ++
 generated/abis/Redeemer.js                    |  20 ++
 .../generated/DummyDiamondImplementation.sol  |   6 +-
 .../DummyDiamondImplementationSidechain.sol   |   6 +-
 tests/Fixture.sol                             |  29 +-
 tests/fuzz/Redeem.t.sol                       | 329 +++++++++++-------
 tests/invariants/actors/Arbitrager.t.sol      |  10 +-
 .../actors/ArbitragerWithSplit.t.sol          |  16 +-
 tests/invariants/actors/BaseActor.t.sol       |   7 +
 tests/mock/MockReentrant.sol                  |  18 +-
 tests/units/RedemptionTokenBinding.t.sol      | 111 ++++++
 tests/units/Setters.t.sol                     |   6 +-
 20 files changed, 526 insertions(+), 180 deletions(-)
 create mode 100644 tests/units/RedemptionTokenBinding.t.sol

diff --git a/contracts/interfaces/IRedeemer.sol b/contracts/interfaces/IRedeemer.sol
index 029b77c..912434c 100644
--- a/contracts/interfaces/IRedeemer.sol
+++ b/contracts/interfaces/IRedeemer.sol
@@ -11,13 +11,17 @@ interface IRedeemer {
   /// @param receiver Address which should be receiving the output tokens
   /// @param deadline Timestamp before which the redemption should have occured
   /// @param minAmountOuts Minimum amount of each token given back in the redemption to obtain
+  /// @param expectedTokensHash `keccak256(abi.encodePacked(tokens))` over the output list the caller was
+  /// quoted, as returned by `quoteRedemptionCurve`. The redemption reverts if the live list differs, since
+  /// `minAmountOuts` is positional and a collateral rotation can change which token each entry protects
   /// @return tokens List of tokens returned
   /// @return amounts Amount given for each token in the `tokens` array
   function redeem(
     uint256 amount,
     address receiver,
     uint256 deadline,
-    uint256[] memory minAmountOuts
+    uint256[] memory minAmountOuts,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts);
@@ -29,7 +33,8 @@ interface IRedeemer {
     address receiver,
     uint256 deadline,
     uint256[] memory minAmountOuts,
-    address[] memory forfeitTokens
+    address[] memory forfeitTokens,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts);
@@ -37,14 +42,17 @@ interface IRedeemer {
   /// @notice Same as `redeemWithForfeit` but using a single EIP-3009 authorization for the tokenP
   /// transfer.
   /// @dev The signed EIP-3009 nonce MUST equal `LibAuthorization.computeRedeemNonce(...)` so that
-  /// mutating `receiver`, `amount`, `deadline`, `minAmountOuts` or `forfeitTokens` invalidates the
-  /// signature. `authData.nonce` carries the caller-chosen `userSalt`.
+  /// mutating `receiver`, `amount`, `deadline`, `minAmountOuts`, `forfeitTokens` or `expectedTokensHash`
+  /// invalidates the signature. `authData.nonce` carries the caller-chosen `userSalt`.
+  /// @dev `expectedTokensHash` matters most here: a signature stays executable for its whole validity
+  /// window, so without it a relayer could hold one until a collateral rotation reshuffles the output list
   function redeemWithAuthorization(
     uint256 amount,
     address receiver,
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes memory authData
   )
     external
diff --git a/contracts/parallelizer/facets/Redeemer.sol b/contracts/parallelizer/facets/Redeemer.sol
index 7539018..f1a3a3f 100644
--- a/contracts/parallelizer/facets/Redeemer.sol
+++ b/contracts/parallelizer/facets/Redeemer.sol
@@ -66,12 +66,13 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     uint256 amount,
     address receiver,
     uint256 deadline,
-    uint256[] memory minAmountOuts
+    uint256[] memory minAmountOuts,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
   {
-    return _redeem(amount, receiver, deadline, minAmountOuts, new address[](0), "");
+    return _redeem(amount, receiver, deadline, minAmountOuts, new address[](0), expectedTokensHash, "");
   }
 
   /// @inheritdoc IRedeemer
@@ -82,12 +83,13 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     address receiver,
     uint256 deadline,
     uint256[] memory minAmountOuts,
-    address[] memory forfeitTokens
+    address[] memory forfeitTokens,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
   {
-    return _redeem(amount, receiver, deadline, minAmountOuts, forfeitTokens, "");
+    return _redeem(amount, receiver, deadline, minAmountOuts, forfeitTokens, expectedTokensHash, "");
   }
 
   /// @inheritdoc IRedeemer
@@ -97,12 +99,13 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes memory authData
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
   {
-    return _redeem(amount, receiver, deadline, minAmountOuts, forfeitTokens, authData);
+    return _redeem(amount, receiver, deadline, minAmountOuts, forfeitTokens, expectedTokensHash, authData);
   }
 
   /// @inheritdoc IRedeemer
@@ -148,6 +151,7 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes memory authData
   )
     internal
@@ -165,9 +169,13 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
 
     (redemption.tokens, redemption.amounts, redemption.subCollateralsTracker) = _quoteRedemptionCurve(amount);
     if (redemption.amounts.length != minAmountOuts.length) revert InvalidLengths();
+    // `minAmountOuts` is positional, so it only protects quantities. Binding the output list itself is what
+    // ties each minimum to the token it was quoted against, across a collateral rotation
+    if (keccak256(abi.encodePacked(redemption.tokens)) != expectedTokensHash) revert UnexpectedRedemptionTokens();
     _updateNormalizer(amount, false);
 
-    redemption.from = _consumeAuthAndBurn(amount, to, deadline, minAmountOuts, forfeitTokens, authData);
+    redemption.from =
+      _consumeAuthAndBurn(amount, to, deadline, minAmountOuts, forfeitTokens, expectedTokensHash, authData);
 
     _distributeRedemption(redemption);
     emit Redeemed(
@@ -197,9 +205,7 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
           revert NotWhitelisted();
         }
         if (collatInfo.isManaged > 0) {
-          LibManager.release(
-            redemption.tokens[i], redemption.to, redemption.amounts[i], collatInfo.managerData.config
-          );
+          LibManager.release(redemption.tokens[i], redemption.to, redemption.amounts[i], collatInfo.managerData.config);
         } else {
           IERC20(redemption.tokens[i]).safeTransfer(redemption.to, redemption.amounts[i]);
         }
@@ -216,6 +222,7 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes memory authData
   )
     internal
@@ -223,7 +230,7 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
   {
     ITokenP tokenP = s.transmuterStorage().tokenP;
     if (authData.length > 0) {
-      from = _executeAuthorization(amount, to, deadline, minAmountOuts, forfeitTokens, authData);
+      from = _executeAuthorization(amount, to, deadline, minAmountOuts, forfeitTokens, expectedTokensHash, authData);
       tokenP.burnSelf(amount, address(this));
     } else {
       from = msg.sender;
@@ -240,6 +247,7 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes memory authData
   )
     internal
@@ -248,17 +256,12 @@ contract Redeemer is IRedeemer, AccessManagedModifiers {
     AuthorizationParams memory params = abi.decode(authData, (AuthorizationParams));
     if (params.value != amount) revert InvalidSwap();
     bytes32 derivedNonce = LibAuthorization.computeRedeemNonce(
-      params.from, amount, receiver, deadline, minAmountOuts, forfeitTokens, params.nonce
-    );
-    IEIP3009(address(s.transmuterStorage().tokenP)).receiveWithAuthorization(
-      params.from,
-      address(this),
-      params.value,
-      params.validAfter,
-      params.validBefore,
-      derivedNonce,
-      params.signature
+      params.from, amount, receiver, deadline, minAmountOuts, forfeitTokens, expectedTokensHash, params.nonce
     );
+    IEIP3009(address(s.transmuterStorage().tokenP))
+      .receiveWithAuthorization(
+        params.from, address(this), params.value, params.validAfter, params.validBefore, derivedNonce, params.signature
+      );
     return params.from;
   }
 
diff --git a/contracts/parallelizer/libraries/LibAuthorization.sol b/contracts/parallelizer/libraries/LibAuthorization.sol
index 8b9bbdf..ad70d37 100644
--- a/contracts/parallelizer/libraries/LibAuthorization.sol
+++ b/contracts/parallelizer/libraries/LibAuthorization.sol
@@ -25,9 +25,9 @@ library LibAuthorization {
     0x41378613b6b468c26472b6d9a40faaeaf3c63b23ae57d1d7e3a7c3d2c356b1ed;
 
   // keccak256("RedeemWithAuthorization(address from,uint256 amount,address receiver,uint256 deadline,bytes32
-  // minAmountOutsHash,bytes32 forfeitTokensHash,bytes32 userSalt)")
+  // minAmountOutsHash,bytes32 forfeitTokensHash,bytes32 expectedTokensHash,bytes32 userSalt)")
   bytes32 internal constant REDEEM_WITH_AUTHORIZATION_TYPEHASH =
-    0xcff34e096e1842f6f6ae4c0d0c6eefd4855c8bdc5bc64155d7c14b2dbeee661a;
+    0xb6577f08e668b53303325a19233e8315142d69bedb6d7e1d8d0e9af2473486d4;
 
   function computeSwapExactInputNonce(
     address from,
@@ -87,6 +87,8 @@ library LibAuthorization {
     );
   }
 
+  /// @param expectedTokensHash `keccak256(abi.encodePacked(tokens))` over the redemption output list the
+  /// authorizer was quoted, binding token identity and ordering rather than raw amounts alone
   function computeRedeemNonce(
     address from,
     uint256 amount,
@@ -94,6 +96,7 @@ library LibAuthorization {
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes32 userSalt
   )
     internal
@@ -109,6 +112,7 @@ library LibAuthorization {
         deadline,
         keccak256(abi.encodePacked(minAmountOuts)),
         keccak256(abi.encodePacked(forfeitTokens)),
+        expectedTokensHash,
         userSalt
       )
     );
diff --git a/contracts/utils/Errors.sol b/contracts/utils/Errors.sol
index 6ee3525..35b7d99 100644
--- a/contracts/utils/Errors.sol
+++ b/contracts/utils/Errors.sol
@@ -51,6 +51,7 @@ error RemoveFacetAddressMustBeZeroAddress(address _facetAddress);
 error TooBigAmountIn();
 error TooLate();
 error TooSmallAmountOut();
+error UnexpectedRedemptionTokens();
 error ZeroAddress();
 error ZeroAmount();
 error ZeroSurplusAmount();
diff --git a/generated/abis/IParallelizer.d.ts b/generated/abis/IParallelizer.d.ts
index 83c7203..40cf117 100644
--- a/generated/abis/IParallelizer.d.ts
+++ b/generated/abis/IParallelizer.d.ts
@@ -1064,6 +1064,11 @@ export type Abi_IParallelizer = [
         "internalType": "uint256[]",
         "name": "minAmountOuts",
         "type": "uint256[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeem",
@@ -1109,6 +1114,11 @@ export type Abi_IParallelizer = [
         "name": "forfeitTokens",
         "type": "address[]"
       },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
+      },
       {
         "internalType": "bytes",
         "name": "authData",
@@ -1157,6 +1167,11 @@ export type Abi_IParallelizer = [
         "internalType": "address[]",
         "name": "forfeitTokens",
         "type": "address[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeemWithForfeit",
diff --git a/generated/abis/IParallelizer.js b/generated/abis/IParallelizer.js
index 167cd07..c95621f 100644
--- a/generated/abis/IParallelizer.js
+++ b/generated/abis/IParallelizer.js
@@ -1064,6 +1064,11 @@ export const Abi_IParallelizer = /** @type {const} **/ ([
         "internalType": "uint256[]",
         "name": "minAmountOuts",
         "type": "uint256[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeem",
@@ -1109,6 +1114,11 @@ export const Abi_IParallelizer = /** @type {const} **/ ([
         "name": "forfeitTokens",
         "type": "address[]"
       },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
+      },
       {
         "internalType": "bytes",
         "name": "authData",
@@ -1157,6 +1167,11 @@ export const Abi_IParallelizer = /** @type {const} **/ ([
         "internalType": "address[]",
         "name": "forfeitTokens",
         "type": "address[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeemWithForfeit",
diff --git a/generated/abis/IRedeemer.d.ts b/generated/abis/IRedeemer.d.ts
index 2880336..cbbde1c 100644
--- a/generated/abis/IRedeemer.d.ts
+++ b/generated/abis/IRedeemer.d.ts
@@ -44,6 +44,11 @@ export type Abi_IRedeemer = [
         "internalType": "uint256[]",
         "name": "minAmountOuts",
         "type": "uint256[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeem",
@@ -89,6 +94,11 @@ export type Abi_IRedeemer = [
         "name": "forfeitTokens",
         "type": "address[]"
       },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
+      },
       {
         "internalType": "bytes",
         "name": "authData",
@@ -137,6 +147,11 @@ export type Abi_IRedeemer = [
         "internalType": "address[]",
         "name": "forfeitTokens",
         "type": "address[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeemWithForfeit",
diff --git a/generated/abis/IRedeemer.js b/generated/abis/IRedeemer.js
index fed69ca..ea35c21 100644
--- a/generated/abis/IRedeemer.js
+++ b/generated/abis/IRedeemer.js
@@ -44,6 +44,11 @@ export const Abi_IRedeemer = /** @type {const} **/ ([
         "internalType": "uint256[]",
         "name": "minAmountOuts",
         "type": "uint256[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeem",
@@ -89,6 +94,11 @@ export const Abi_IRedeemer = /** @type {const} **/ ([
         "name": "forfeitTokens",
         "type": "address[]"
       },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
+      },
       {
         "internalType": "bytes",
         "name": "authData",
@@ -137,6 +147,11 @@ export const Abi_IRedeemer = /** @type {const} **/ ([
         "internalType": "address[]",
         "name": "forfeitTokens",
         "type": "address[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeemWithForfeit",
diff --git a/generated/abis/Redeemer.d.ts b/generated/abis/Redeemer.d.ts
index d421a03..d818654 100644
--- a/generated/abis/Redeemer.d.ts
+++ b/generated/abis/Redeemer.d.ts
@@ -76,6 +76,11 @@ export type Abi_Redeemer = [
     "name": "TooSmallAmountOut",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "UnexpectedRedemptionTokens",
+    "type": "error"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -177,6 +182,11 @@ export type Abi_Redeemer = [
         "internalType": "uint256[]",
         "name": "minAmountOuts",
         "type": "uint256[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeem",
@@ -222,6 +232,11 @@ export type Abi_Redeemer = [
         "name": "forfeitTokens",
         "type": "address[]"
       },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
+      },
       {
         "internalType": "bytes",
         "name": "authData",
@@ -270,6 +285,11 @@ export type Abi_Redeemer = [
         "internalType": "address[]",
         "name": "forfeitTokens",
         "type": "address[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeemWithForfeit",
diff --git a/generated/abis/Redeemer.js b/generated/abis/Redeemer.js
index cc04aa6..13ddb7e 100644
--- a/generated/abis/Redeemer.js
+++ b/generated/abis/Redeemer.js
@@ -76,6 +76,11 @@ export const Abi_Redeemer = /** @type {const} **/ ([
     "name": "TooSmallAmountOut",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "UnexpectedRedemptionTokens",
+    "type": "error"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -177,6 +182,11 @@ export const Abi_Redeemer = /** @type {const} **/ ([
         "internalType": "uint256[]",
         "name": "minAmountOuts",
         "type": "uint256[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeem",
@@ -222,6 +232,11 @@ export const Abi_Redeemer = /** @type {const} **/ ([
         "name": "forfeitTokens",
         "type": "address[]"
       },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
+      },
       {
         "internalType": "bytes",
         "name": "authData",
@@ -270,6 +285,11 @@ export const Abi_Redeemer = /** @type {const} **/ ([
         "internalType": "address[]",
         "name": "forfeitTokens",
         "type": "address[]"
+      },
+      {
+        "internalType": "bytes32",
+        "name": "expectedTokensHash",
+        "type": "bytes32"
       }
     ],
     "name": "redeemWithForfeit",
diff --git a/scripts/generated/DummyDiamondImplementation.sol b/scripts/generated/DummyDiamondImplementation.sol
index c439866..dc142cb 100644
--- a/scripts/generated/DummyDiamondImplementation.sol
+++ b/scripts/generated/DummyDiamondImplementation.sol
@@ -229,7 +229,8 @@ contract DummyDiamondImplementation {
     uint256 amount,
     address receiver,
     uint256 deadline,
-    uint256[] memory minAmountOuts
+    uint256[] memory minAmountOuts,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
@@ -240,7 +241,8 @@ contract DummyDiamondImplementation {
     address receiver,
     uint256 deadline,
     uint256[] memory minAmountOuts,
-    address[] memory forfeitTokens
+    address[] memory forfeitTokens,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
diff --git a/scripts/generated/DummyDiamondImplementationSidechain.sol b/scripts/generated/DummyDiamondImplementationSidechain.sol
index 6bcb412..6019c8c 100644
--- a/scripts/generated/DummyDiamondImplementationSidechain.sol
+++ b/scripts/generated/DummyDiamondImplementationSidechain.sol
@@ -234,7 +234,8 @@ contract DummyDiamondImplementation {
     uint256 amount,
     address receiver,
     uint256 deadline,
-    uint256[] memory minAmountOuts
+    uint256[] memory minAmountOuts,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
@@ -245,7 +246,8 @@ contract DummyDiamondImplementation {
     address receiver,
     uint256 deadline,
     uint256[] memory minAmountOuts,
-    address[] memory forfeitTokens
+    address[] memory forfeitTokens,
+    bytes32 expectedTokensHash
   )
     external
     returns (address[] memory tokens, uint256[] memory amounts)
diff --git a/tests/Fixture.sol b/tests/Fixture.sol
index 36b3032..0cd48e7 100644
--- a/tests/Fixture.sol
+++ b/tests/Fixture.sol
@@ -132,7 +132,7 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
   }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-    ASSERTIONS                                                    
+    ASSERTIONS
   //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
   // Allow to have larger deviation for very small amounts
@@ -155,7 +155,7 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
   }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-    ACTIONS                                                     
+    ACTIONS
   //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
   function _mintExactOutput(address owner, address tokenIn, uint256 amountStable, uint256 estimatedAmountIn) internal {
@@ -229,7 +229,7 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
 
   bytes32 internal constant PARALLELIZER_REDEEM_TYPEHASH = keccak256(
     "RedeemWithAuthorization(address from,uint256 amount,address receiver,uint256 deadline,"
-    "bytes32 minAmountOutsHash,bytes32 forfeitTokensHash,bytes32 userSalt)"
+    "bytes32 minAmountOutsHash,bytes32 forfeitTokensHash,bytes32 expectedTokensHash,bytes32 userSalt)"
   );
 
   function _buildSwapExactInputAuth(
@@ -249,15 +249,7 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
   {
     bytes32 derivedNonce = keccak256(
       abi.encode(
-        PARALLELIZER_SWAP_EXACT_INPUT_TYPEHASH,
-        from,
-        tokenIn,
-        tokenOut,
-        amountIn,
-        amountOutMin,
-        to,
-        deadline,
-        userSalt
+        PARALLELIZER_SWAP_EXACT_INPUT_TYPEHASH, from, tokenIn, tokenOut, amountIn, amountOutMin, to, deadline, userSalt
       )
     );
     return _signAndPackAuth(privateKey, tokenIn, from, amountIn, derivedNonce, userSalt);
@@ -302,6 +294,7 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
     uint256 deadline,
     uint256[] memory minAmountOuts,
     address[] memory forfeitTokens,
+    bytes32 expectedTokensHash,
     bytes32 userSalt
   )
     internal
@@ -317,12 +310,20 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
         deadline,
         keccak256(abi.encodePacked(minAmountOuts)),
         keccak256(abi.encodePacked(forfeitTokens)),
+        expectedTokensHash,
         userSalt
       )
     );
     return _signAndPackAuth(privateKey, address(tokenP), from, amount, derivedNonce, userSalt);
   }
 
+  /// @dev The output list a redemption of `amount` would produce right now, hashed as the redeem
+  /// entry points expect it
+  function _redemptionTokensHash(uint256 amount) internal view returns (bytes32) {
+    (address[] memory tokens,) = parallelizer.quoteRedemptionCurve(amount);
+    return keccak256(abi.encodePacked(tokens));
+  }
+
   /// @dev Signs an EIP-3009 `ReceiveWithAuthorization` with `nonce = signedNonce` and packs an
   /// `AuthorizationParams` whose on-the-wire `nonce` field carries `userSalt`, matching what the
   /// Parallelizer facets expect.
@@ -340,9 +341,7 @@ contract Fixture is Parallelizer, SavingsUtils, ConfigAccessManager {
   {
     uint256 validBefore = block.timestamp + 1 hours;
     bytes32 structHash = keccak256(
-      abi.encode(
-        RECEIVE_WITH_AUTHORIZATION_TYPEHASH, from, address(parallelizer), value, 0, validBefore, signedNonce
-      )
+      abi.encode(RECEIVE_WITH_AUTHORIZATION_TYPEHASH, from, address(parallelizer), value, 0, validBefore, signedNonce)
     );
     bytes32 digest = MessageHashUtils.toTypedDataHash(MockTokenPermit(token).DOMAIN_SEPARATOR(), structHash);
     (uint8 v, bytes32 r, bytes32 s) = vm.sign(privateKey, digest);
diff --git a/tests/fuzz/Redeem.t.sol b/tests/fuzz/Redeem.t.sol
index 60ca6c2..eccc559 100644
--- a/tests/fuzz/Redeem.t.sol
+++ b/tests/fuzz/Redeem.t.sol
@@ -34,6 +34,9 @@ struct AssertQuoteParams {
 }
 
 contract RedeemTest is Fixture, FunctionUtils {
+  /// @dev Kept in storage rather than a local: these fuzz tests already sit on the EVM stack limit
+  bytes32 internal tokensHash;
+
   using Math for uint256;
   using SafeERC20 for IERC20;
 
@@ -269,15 +272,19 @@ contract RedeemTest is Fixture, FunctionUtils {
     // --> redemption should be exactly in proportion of current balances
     vm.startPrank(alice);
     uint256 amountBurnt = tokenP.balanceOf(alice);
+    uint256[] memory quoteAmounts;
+    {
+      address[] memory quoteTokens;
+      if (mintedStables == 0) vm.expectRevert(stdError.divisionError);
+      else if (mintedStables == amountBurnt) vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
+      (quoteTokens, quoteAmounts) = parallelizer.quoteRedemptionCurve(amountBurnt);
+      tokensHash = keccak256(abi.encodePacked(quoteTokens));
+    }
     if (mintedStables == 0) vm.expectRevert(stdError.divisionError);
     else if (mintedStables == amountBurnt) vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    (, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(amountBurnt);
-    if (mintedStables == 0) vm.expectRevert(stdError.divisionError);
-    else if (mintedStables == amountBurnt) vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    // uint256[] memory forfeitTokens = new uint256[](0);
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     (address[] memory tokens, uint256[] memory amounts) =
-      parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+      parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, tokensHash);
     vm.stopPrank();
 
     if (mintedStables == 0 || mintedStables == amountBurnt) return;
@@ -328,7 +335,12 @@ contract RedeemTest is Fixture, FunctionUtils {
     uint256 amountBurnt = tokenP.balanceOf(alice);
     if (mintedStables == 0) vm.expectRevert(stdError.divisionError);
     else if (mintedStables == amountBurnt) vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    (, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(amountBurnt);
+    uint256[] memory quoteAmounts;
+    {
+      address[] memory quoteTokens;
+      (quoteTokens, quoteAmounts) = parallelizer.quoteRedemptionCurve(amountBurnt);
+      tokensHash = keccak256(abi.encodePacked(quoteTokens));
+    }
     if (mintedStables == 0) vm.expectRevert(stdError.divisionError);
     else if (mintedStables == amountBurnt) vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
     address[] memory tokens;
@@ -336,7 +348,7 @@ contract RedeemTest is Fixture, FunctionUtils {
     {
       // uint256[] memory forfeitTokens = new uint256[](0);
       uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
-      (tokens, amounts) = parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+      (tokens, amounts) = parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, tokensHash);
     }
     vm.stopPrank();
 
@@ -398,7 +410,9 @@ contract RedeemTest is Fixture, FunctionUtils {
       uint256[] memory amounts;
       {
         uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
-        (tokens, amounts) = parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+        (tokens, amounts) = parallelizer.redeem(
+          amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, _redemptionTokensHash(amountBurnt)
+        );
       }
       vm.stopPrank();
 
@@ -440,7 +454,9 @@ contract RedeemTest is Fixture, FunctionUtils {
 
       {
         uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
-        (tokens, amounts) = parallelizer.redeem(amountBurntBob, bob, block.timestamp + 1 days, minAmountOuts);
+        (tokens, amounts) = parallelizer.redeem(
+          amountBurntBob, bob, block.timestamp + 1 days, minAmountOuts, _redemptionTokensHash(amountBurntBob)
+        );
       }
       vm.stopPrank();
 
@@ -494,7 +510,7 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, bytes32(0));
   }
 
   function testFuzz_RevertWhen_BurningAllStableIssuedWithWhitelist(
@@ -513,10 +529,12 @@ contract RedeemTest is Fixture, FunctionUtils {
     }
 
     // Enable whitelist on the first collateral and whitelist alice
-    bytes memory emptyData;
-    bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
-    hoax(governor);
-    parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    {
+      bytes memory emptyData;
+      bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
+      hoax(governor);
+      parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    }
     hoax(guardian);
     parallelizer.toggleWhitelist(WhitelistType.BACKED, alice);
 
@@ -527,7 +545,7 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, bytes32(0));
   }
 
   function testFuzz_RedeemWithForfeit_RevertWhen_BurningAllStableIssued(
@@ -564,7 +582,9 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeemWithForfeit(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+    parallelizer.redeemWithForfeit(
+      amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens, bytes32(0)
+    );
   }
 
   function testFuzz_RedeemWithForfeit_RevertWhen_BurningAllStableIssuedWithWhitelist(
@@ -595,10 +615,12 @@ contract RedeemTest is Fixture, FunctionUtils {
     }
 
     // Enable whitelist on the first collateral and whitelist alice
-    bytes memory emptyData;
-    bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
-    hoax(governor);
-    parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    {
+      bytes memory emptyData;
+      bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
+      hoax(governor);
+      parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    }
     hoax(guardian);
     parallelizer.toggleWhitelist(WhitelistType.BACKED, alice);
 
@@ -609,7 +631,9 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeemWithForfeit(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+    parallelizer.redeemWithForfeit(
+      amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens, bytes32(0)
+    );
   }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
@@ -745,7 +769,9 @@ contract RedeemTest is Fixture, FunctionUtils {
       address[] memory tokens;
       {
         uint256[] memory minAmountOuts = new uint256[](quoteAmounts.length);
-        (tokens, amounts) = parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+        (tokens, amounts) = parallelizer.redeem(
+          amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, _redemptionTokensHash(amountBurnt)
+        );
       }
       vm.stopPrank();
 
@@ -780,7 +806,9 @@ contract RedeemTest is Fixture, FunctionUtils {
       if (mintedStables == 0 || amountBurntBob >= mintedStables) return;
       {
         uint256[] memory minAmountOuts = new uint256[](quoteAmounts.length);
-        (tokens, amounts) = parallelizer.redeem(amountBurntBob, bob, block.timestamp + 1 days, minAmountOuts);
+        (tokens, amounts) = parallelizer.redeem(
+          amountBurntBob, bob, block.timestamp + 1 days, minAmountOuts, _redemptionTokensHash(amountBurntBob)
+        );
       }
       vm.stopPrank();
 
@@ -871,7 +899,7 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, bytes32(0));
   }
 
   function testFuzz_RevertWhen_BurningAllStableIssuedWithManagerAndWhitelist(
@@ -920,10 +948,12 @@ contract RedeemTest is Fixture, FunctionUtils {
     _randomRedeemptionFees(xFeeRedeemUnbounded, yFeeRedeemUnbounded);
 
     // Enable whitelist on the first collateral and whitelist alice
-    bytes memory emptyData;
-    bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
-    hoax(governor);
-    parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    {
+      bytes memory emptyData;
+      bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
+      hoax(governor);
+      parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    }
     hoax(guardian);
     parallelizer.toggleWhitelist(WhitelistType.BACKED, alice);
 
@@ -934,7 +964,7 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, bytes32(0));
   }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
@@ -955,6 +985,7 @@ contract RedeemTest is Fixture, FunctionUtils {
     vm.startPrank(alice);
     uint256 amountBurnt = tokenP.balanceOf(alice);
     if (amountBurnt == mintedStables) return;
+    tokensHash = _redemptionTokensHash(amountBurnt);
     {
       uint256[] memory minAmountOuts;
       {
@@ -962,7 +993,7 @@ contract RedeemTest is Fixture, FunctionUtils {
         minAmountOuts = new uint256[](quoteAmounts.length - 1);
       }
       vm.expectRevert(Errors.InvalidLengths.selector);
-      parallelizer.redeem(amountBurnt, alice, block.timestamp * 2, minAmountOuts);
+      parallelizer.redeem(amountBurnt, alice, block.timestamp * 2, minAmountOuts, tokensHash);
     }
     {
       uint256[] memory minAmountOuts;
@@ -971,7 +1002,7 @@ contract RedeemTest is Fixture, FunctionUtils {
         minAmountOuts = new uint256[](quoteAmounts.length + 1);
       }
       vm.expectRevert(Errors.InvalidLengths.selector);
-      parallelizer.redeem(amountBurnt, alice, block.timestamp * 2, minAmountOuts);
+      parallelizer.redeem(amountBurnt, alice, block.timestamp * 2, minAmountOuts, tokensHash);
     }
     vm.stopPrank();
   }
@@ -1031,8 +1062,14 @@ contract RedeemTest is Fixture, FunctionUtils {
       address[] memory forfeitTokens = _getForfeitTokens(areForfeit);
       {
         uint256[] memory minAmountOuts = new uint256[](quoteAmounts.length);
-        (tokens, amounts) =
-          parallelizer.redeemWithForfeit(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+        (tokens, amounts) = parallelizer.redeemWithForfeit(
+          amountBurnt,
+          alice,
+          block.timestamp + 1 days,
+          minAmountOuts,
+          forfeitTokens,
+          _redemptionTokensHash(amountBurnt)
+        );
       }
       vm.stopPrank();
 
@@ -1066,7 +1103,9 @@ contract RedeemTest is Fixture, FunctionUtils {
       if (mintedStables == 0 || amountBurntBob >= mintedStables) return;
       {
         uint256[] memory minAmountOuts = new uint256[](quoteAmounts.length);
-        (tokens, amounts) = parallelizer.redeem(amountBurntBob, bob, block.timestamp + 1 days, minAmountOuts);
+        (tokens, amounts) = parallelizer.redeem(
+          amountBurntBob, bob, block.timestamp + 1 days, minAmountOuts, _redemptionTokensHash(amountBurntBob)
+        );
       }
       vm.stopPrank();
 
@@ -1149,7 +1188,9 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     vm.expectRevert(Errors.CannotBurnAllStableIssued.selector);
-    parallelizer.redeemWithForfeit(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+    parallelizer.redeemWithForfeit(
+      amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens, bytes32(0)
+    );
   }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
@@ -1163,10 +1204,12 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     _sweepBalances(alice, _collaterals);
 
-    bytes memory emptyData;
-    bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
-    hoax(governor);
-    parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    {
+      bytes memory emptyData;
+      bytes memory whitelistData = abi.encode(WhitelistType.BACKED, emptyData);
+      hoax(governor);
+      parallelizer.setWhitelistStatus(address(eurA), 1, whitelistData);
+    }
 
     vm.startPrank(alice);
     uint256 amountBurnt = tokenP.balanceOf(alice);
@@ -1174,10 +1217,11 @@ contract RedeemTest is Fixture, FunctionUtils {
     (, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(amountBurnt);
     // There should be a non zero amount of EURA to transfer
     if (quoteAmounts[0] == 0) return;
+    tokensHash = _redemptionTokensHash(amountBurnt);
     vm.expectRevert(Errors.NotWhitelisted.selector);
 
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
-    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+    parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, tokensHash);
     vm.stopPrank();
 
     hoax(guardian);
@@ -1185,10 +1229,10 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     vm.startPrank(alice);
     vm.expectRevert(Errors.NotWhitelisted.selector);
-    parallelizer.redeem(amountBurnt, bob, block.timestamp + 1 days, minAmountOuts);
+    parallelizer.redeem(amountBurnt, bob, block.timestamp + 1 days, minAmountOuts, tokensHash);
 
     (address[] memory tokens, uint256[] memory amounts) =
-      parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts);
+      parallelizer.redeem(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, tokensHash);
     vm.stopPrank();
 
     assertEq(amounts, quoteAmounts);
@@ -1228,30 +1272,38 @@ contract RedeemTest is Fixture, FunctionUtils {
     if (mintedStables == 0 || amountBurnt == 0 || amountBurnt == mintedStables) return;
     (, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(amountBurnt);
     if (quoteAmounts[0] == 0 || quoteAmounts[1] == 0) return;
+    tokensHash = _redemptionTokensHash(amountBurnt);
     uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
     {
       vm.startPrank(alice);
       address[] memory forfeitTokens = new address[](0);
       vm.expectRevert(Errors.NotWhitelisted.selector);
-      parallelizer.redeemWithForfeit(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+      parallelizer.redeemWithForfeit(
+        amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens, tokensHash
+      );
 
       address[] memory forfeitTokens1 = new address[](1);
       forfeitTokens1[0] = address(eurA);
       vm.expectRevert(Errors.NotWhitelisted.selector);
-      parallelizer.redeemWithForfeit(amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+      parallelizer.redeemWithForfeit(
+        amountBurnt, alice, block.timestamp + 1 days, minAmountOuts, forfeitTokens, tokensHash
+      );
       vm.stopPrank();
       hoax(guardian);
       parallelizer.toggleWhitelist(WhitelistType.BACKED, alice);
       vm.startPrank(alice);
       vm.expectRevert(Errors.NotWhitelisted.selector);
-      parallelizer.redeemWithForfeit(amountBurnt, bob, block.timestamp + 1 days, minAmountOuts, forfeitTokens);
+      parallelizer.redeemWithForfeit(
+        amountBurnt, bob, block.timestamp + 1 days, minAmountOuts, forfeitTokens, tokensHash
+      );
     }
 
     address[] memory forfeitTokens2 = new address[](2);
     forfeitTokens2[0] = address(eurA);
     forfeitTokens2[1] = address(eurB);
-    (address[] memory tokens, uint256[] memory amounts) =
-      parallelizer.redeemWithForfeit(amountBurnt, bob, block.timestamp + 1 days, minAmountOuts, forfeitTokens2);
+    (address[] memory tokens, uint256[] memory amounts) = parallelizer.redeemWithForfeit(
+      amountBurnt, bob, block.timestamp + 1 days, minAmountOuts, forfeitTokens2, tokensHash
+    );
     vm.stopPrank();
 
     assertEq(amounts, quoteAmounts);
@@ -1811,8 +1863,9 @@ contract RedeemTest is Fixture, FunctionUtils {
     uint256 stablecoinsIssued = parallelizer.getTotalIssued();
     if (stablecoinsIssued > 1) {
       uint256[] memory minOuts = new uint256[](3);
+      tokensHash = _redemptionTokensHash(stablecoinsIssued - 1);
       vm.expectRevert();
-      parallelizer.redeem(stablecoinsIssued - 1, attacker, block.timestamp * 2, minOuts);
+      parallelizer.redeem(stablecoinsIssued - 1, attacker, block.timestamp * 2, minOuts, tokensHash);
     }
     vm.stopPrank();
 
@@ -1825,7 +1878,9 @@ contract RedeemTest is Fixture, FunctionUtils {
     uint256 mintB,
     uint256 mintY,
     uint256 redeemRatio
-  ) public {
+  )
+    public
+  {
     mintA = bound(mintA, 1e6, 1_000_000e6);
     mintB = bound(mintB, 1e12, 1_000_000e12);
     mintY = bound(mintY, 1e18, 1_000_000e18);
@@ -1843,8 +1898,9 @@ contract RedeemTest is Fixture, FunctionUtils {
     if (redeemAmount >= stablecoinsIssued) redeemAmount = stablecoinsIssued - 1;
 
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     vm.startPrank(alice);
-    parallelizer.redeem(redeemAmount, alice, block.timestamp * 2, minOuts);
+    parallelizer.redeem(redeemAmount, alice, block.timestamp * 2, minOuts, tokensHash);
     vm.stopPrank();
 
     assertGt(
@@ -1890,24 +1946,27 @@ contract RedeemTest is Fixture, FunctionUtils {
     uint256 tokenPBal = tokenP.balanceOf(alice);
     uint256 redeemAmount = tokenPBal / 4;
 
-    vm.startPrank(guardian);
-    uint64[] memory xRedemption = new uint64[](1);
-    xRedemption[0] = uint64(0);
-    int64[] memory yRedemption = new int64[](1);
-    yRedemption[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xRedemption, yRedemption);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xRedemption = new uint64[](1);
+      xRedemption[0] = uint64(0);
+      int64[] memory yRedemption = new int64[](1);
+      yRedemption[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xRedemption, yRedemption);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     address[] memory forfeit = new address[](0);
     bytes memory authData =
-      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, bytes32("redeem1"));
+      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, bytes32("redeem1"));
 
     // bob relays alice's signed authorization
     vm.prank(bob);
     (address[] memory tokens, uint256[] memory amounts) =
-      parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, authData);
+      parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, authData);
 
     assertEq(tokens.length, 3);
     for (uint256 i; i < amounts.length; i++) {
@@ -1925,46 +1984,62 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256 redeemAmount = tokenP.balanceOf(alice) / 4;
 
-    vm.startPrank(guardian);
-    uint64[] memory xR = new uint64[](1);
-    xR[0] = uint64(0);
-    int64[] memory yR = new int64[](1);
-    yR[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xR, yR);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xR = new uint64[](1);
+      xR[0] = uint64(0);
+      int64[] memory yR = new int64[](1);
+      yR[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xR, yR);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     address[] memory forfeit = new address[](0);
-    bytes memory aliceAuth =
-      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, bytes32("redeem_frontrun"));
+    bytes memory aliceAuth = _buildRedeemAuth(
+      1, alice, redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, bytes32("redeem_frontrun")
+    );
 
     vm.prank(bob);
     vm.expectRevert(bytes("invalid signature"));
-    parallelizer.redeemWithAuthorization(redeemAmount, bob, deadline, minOuts, forfeit, aliceAuth);
+    parallelizer.redeemWithAuthorization(redeemAmount, bob, deadline, minOuts, forfeit, tokensHash, aliceAuth);
   }
 
   function test_RedeemWithAuthorization_RevertWhen_ValueMismatch() public {
     _mintExactInput(alice, address(eurA), 100 * BASE_6, 0);
     uint256 redeemAmount = tokenP.balanceOf(alice) / 4;
 
-    vm.startPrank(guardian);
-    uint64[] memory xR = new uint64[](1);
-    xR[0] = uint64(0);
-    int64[] memory yR = new int64[](1);
-    yR[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xR, yR);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xR = new uint64[](1);
+      xR[0] = uint64(0);
+      int64[] memory yR = new int64[](1);
+      yR[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xR, yR);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     address[] memory forfeit = new address[](0);
-    bytes memory authData =
-      _buildRedeemAuth(1, alice, redeemAmount / 2, alice, deadline, minOuts, forfeit, bytes32("bad_redeem"));
+    bytes memory authData = _buildRedeemAuth(
+      1,
+      alice,
+      redeemAmount / 2,
+      alice,
+      deadline,
+      minOuts,
+      forfeit,
+      _redemptionTokensHash(redeemAmount / 2),
+      bytes32("bad_redeem")
+    );
 
     vm.prank(bob);
     vm.expectRevert();
-    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, authData);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, authData);
   }
 
   function test_RedeemWithAuthorization_RevertWhen_ReusedNonce() public {
@@ -1975,27 +2050,32 @@ contract RedeemTest is Fixture, FunctionUtils {
     uint256 redeemAmount = tokenP.balanceOf(alice) / 8;
     bytes32 userSalt = bytes32("reuse_redeem");
 
-    vm.startPrank(guardian);
-    uint64[] memory xR = new uint64[](1);
-    xR[0] = uint64(0);
-    int64[] memory yR = new int64[](1);
-    yR[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xR, yR);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xR = new uint64[](1);
+      xR[0] = uint64(0);
+      int64[] memory yR = new int64[](1);
+      yR[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xR, yR);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     address[] memory forfeit = new address[](0);
-    bytes memory authData1 = _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, userSalt);
+    bytes memory authData1 =
+      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, userSalt);
 
     vm.prank(bob);
-    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, authData1);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, authData1);
 
-    bytes memory authData2 = _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, userSalt);
+    bytes memory authData2 =
+      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, userSalt);
 
     vm.prank(bob);
     vm.expectRevert();
-    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, authData2);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, authData2);
   }
 
   event Redeemed(
@@ -2014,27 +2094,30 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256 redeemAmount = tokenP.balanceOf(alice) / 4;
 
-    vm.startPrank(guardian);
-    uint64[] memory xR = new uint64[](1);
-    xR[0] = uint64(0);
-    int64[] memory yR = new int64[](1);
-    yR[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xR, yR);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xR = new uint64[](1);
+      xR[0] = uint64(0);
+      int64[] memory yR = new int64[](1);
+      yR[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xR, yR);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     address[] memory forfeit = new address[](1);
     forfeit[0] = address(eurA);
 
     bytes memory authData =
-      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, bytes32("forfeit_ok"));
+      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, bytes32("forfeit_ok"));
 
     uint256 eurABefore = IERC20(address(eurA)).balanceOf(alice);
     uint256 eurBBefore = IERC20(address(eurB)).balanceOf(alice);
 
     vm.prank(bob);
-    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, authData);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, authData);
 
     assertEq(IERC20(address(eurA)).balanceOf(alice), eurABefore, "forfeited token must not be transferred");
     assertGt(IERC20(address(eurB)).balanceOf(alice), eurBBefore, "non-forfeited token must be transferred");
@@ -2047,28 +2130,32 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256 redeemAmount = tokenP.balanceOf(alice) / 4;
 
-    vm.startPrank(guardian);
-    uint64[] memory xR = new uint64[](1);
-    xR[0] = uint64(0);
-    int64[] memory yR = new int64[](1);
-    yR[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xR, yR);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xR = new uint64[](1);
+      xR[0] = uint64(0);
+      int64[] memory yR = new int64[](1);
+      yR[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xR, yR);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
 
     address[] memory signedForfeit = new address[](1);
     signedForfeit[0] = address(eurA);
-    bytes memory authData =
-      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, signedForfeit, bytes32("forfeit_bind"));
+    bytes memory authData = _buildRedeemAuth(
+      1, alice, redeemAmount, alice, deadline, minOuts, signedForfeit, tokensHash, bytes32("forfeit_bind")
+    );
 
     address[] memory tamperedForfeit = new address[](1);
     tamperedForfeit[0] = address(eurB);
 
     vm.prank(bob);
     vm.expectRevert(bytes("invalid signature"));
-    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, tamperedForfeit, authData);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, tamperedForfeit, tokensHash, authData);
   }
 
   function test_RedeemWithAuthorization_EmitsAuthorizerNotRelayer() public {
@@ -2078,24 +2165,28 @@ contract RedeemTest is Fixture, FunctionUtils {
 
     uint256 redeemAmount = tokenP.balanceOf(alice) / 4;
 
-    vm.startPrank(guardian);
-    uint64[] memory xR = new uint64[](1);
-    xR[0] = uint64(0);
-    int64[] memory yR = new int64[](1);
-    yR[0] = int64(int256(BASE_9));
-    parallelizer.setRedemptionCurveParams(xR, yR);
-    vm.stopPrank();
+    {
+      vm.startPrank(guardian);
+      uint64[] memory xR = new uint64[](1);
+      xR[0] = uint64(0);
+      int64[] memory yR = new int64[](1);
+      yR[0] = int64(int256(BASE_9));
+      parallelizer.setRedemptionCurveParams(xR, yR);
+      vm.stopPrank();
+    }
 
     uint256 deadline = block.timestamp + 1 hours;
     uint256[] memory minOuts = new uint256[](3);
+    tokensHash = _redemptionTokensHash(redeemAmount);
     address[] memory forfeit = new address[](0);
-    bytes memory authData =
-      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, bytes32("event_attr_redeem"));
+    bytes memory authData = _buildRedeemAuth(
+      1, alice, redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, bytes32("event_attr_redeem")
+    );
 
     vm.expectEmit(true, true, false, false, address(parallelizer));
     emit Redeemed(0, new address[](0), new uint256[](0), new address[](0), alice, alice);
 
     vm.prank(bob);
-    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, authData);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, tokensHash, authData);
   }
 }
diff --git a/tests/invariants/actors/Arbitrager.t.sol b/tests/invariants/actors/Arbitrager.t.sol
index cd586c8..310038f 100644
--- a/tests/invariants/actors/Arbitrager.t.sol
+++ b/tests/invariants/actors/Arbitrager.t.sol
@@ -3,7 +3,12 @@ pragma solidity 0.8.28;
 
 import "contracts/utils/Constants.sol";
 import {
-  AggregatorV3Interface, BaseActor, IERC20, IERC20Metadata, IParallelizer, TestStorage
+  AggregatorV3Interface,
+  BaseActor,
+  IERC20,
+  IERC20Metadata,
+  IParallelizer,
+  TestStorage
 } from "./BaseActor.t.sol";
 import { QuoteType } from "contracts/parallelizer/Storage.sol";
 import { console } from "@forge-std/console.sol";
@@ -185,8 +190,9 @@ contract Arbitrager is BaseActor {
         // don't care about slippage
         uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
         address[] memory redeemTokens;
+        bytes32 tokensHash = _redemptionTokensHash(_parallelizer, amount);
         (redeemTokens, redeemAmounts) = _parallelizer.redeemWithForfeit(
-          amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens
+          amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
         );
       }
 
diff --git a/tests/invariants/actors/ArbitragerWithSplit.t.sol b/tests/invariants/actors/ArbitragerWithSplit.t.sol
index 8a54e49..0ee4a8e 100644
--- a/tests/invariants/actors/ArbitragerWithSplit.t.sol
+++ b/tests/invariants/actors/ArbitragerWithSplit.t.sol
@@ -3,7 +3,12 @@ pragma solidity 0.8.28;
 
 import "contracts/utils/Constants.sol";
 import {
-  AggregatorV3Interface, BaseActor, IERC20, IERC20Metadata, IParallelizer, TestStorage
+  AggregatorV3Interface,
+  BaseActor,
+  IERC20,
+  IERC20Metadata,
+  IParallelizer,
+  TestStorage
 } from "./BaseActor.t.sol";
 import { QuoteType } from "contracts/parallelizer/Storage.sol";
 import { console } from "@forge-std/console.sol";
@@ -260,8 +265,9 @@ contract ArbitragerWithSplit is BaseActor {
         // don't care about slippage
         uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
         address[] memory redeemTokens;
+        bytes32 tokensHash = _redemptionTokensHash(_parallelizer, amount);
         (redeemTokens, redeemAmounts) = _parallelizer.redeemWithForfeit(
-          amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens
+          amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
         );
       }
 
@@ -298,12 +304,14 @@ contract ArbitragerWithSplit is BaseActor {
         address[] memory redeemTokens;
 
         uint256 amountSplit = (amount * splitProportion) / BASE_9;
+        bytes32 tokensHash = _redemptionTokensHash(_parallelizerSplit, amountSplit);
         (redeemTokens, redeemAmountsSplit1) = _parallelizerSplit.redeemWithForfeit(
-          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens
+          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
         );
         amountSplit = amount - amountSplit;
+        tokensHash = _redemptionTokensHash(_parallelizerSplit, amountSplit);
         (, redeemAmountsSplit2) = _parallelizerSplit.redeemWithForfeit(
-          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens
+          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
         );
       }
 
diff --git a/tests/invariants/actors/BaseActor.t.sol b/tests/invariants/actors/BaseActor.t.sol
index e4fdd05..cb0e37f 100644
--- a/tests/invariants/actors/BaseActor.t.sol
+++ b/tests/invariants/actors/BaseActor.t.sol
@@ -79,4 +79,11 @@ contract BaseActor is Test {
     _maxTokenAmount.push(_maxAmountWithoutDecimals * 10 ** IERC20Metadata(_collaterals[1]).decimals());
     _maxTokenAmount.push(_maxAmountWithoutDecimals * 10 ** IERC20Metadata(_collaterals[2]).decimals());
   }
+
+  /// @dev The output list a redemption of `amount` would produce right now, hashed as the redeem
+  /// entry points expect it
+  function _redemptionTokensHash(IParallelizer target, uint256 amount) internal view returns (bytes32) {
+    (address[] memory tokens,) = target.quoteRedemptionCurve(amount);
+    return keccak256(abi.encodePacked(tokens));
+  }
 }
diff --git a/tests/mock/MockReentrant.sol b/tests/mock/MockReentrant.sol
index 19e1a98..719657c 100644
--- a/tests/mock/MockReentrant.sol
+++ b/tests/mock/MockReentrant.sol
@@ -19,10 +19,11 @@ contract ReentrantRedeemGetCollateralRatio {
   }
 
   function testERC777Reentrancy(uint256 redeemAmount) public {
-    uint256[] memory minAmountOuts;
-    (, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(redeemAmount);
-    minAmountOuts = new uint256[](quoteAmounts.length);
-    parallelizer.redeem(redeemAmount, address(this), block.timestamp * 2, minAmountOuts);
+    (address[] memory quoteTokens, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(redeemAmount);
+    uint256[] memory minAmountOuts = new uint256[](quoteAmounts.length);
+    parallelizer.redeem(
+      redeemAmount, address(this), block.timestamp * 2, minAmountOuts, keccak256(abi.encodePacked(quoteTokens))
+    );
   }
 
   function setInterfaceImplementer() public {
@@ -60,10 +61,11 @@ contract ReentrantRedeemSwap {
   }
 
   function testERC777Reentrancy(uint256 redeemAmount) public {
-    uint256[] memory minAmountOuts;
-    (, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(redeemAmount);
-    minAmountOuts = new uint256[](quoteAmounts.length);
-    parallelizer.redeem(redeemAmount, address(this), block.timestamp * 2, minAmountOuts);
+    (address[] memory quoteTokens, uint256[] memory quoteAmounts) = parallelizer.quoteRedemptionCurve(redeemAmount);
+    uint256[] memory minAmountOuts = new uint256[](quoteAmounts.length);
+    parallelizer.redeem(
+      redeemAmount, address(this), block.timestamp * 2, minAmountOuts, keccak256(abi.encodePacked(quoteTokens))
+    );
   }
 
   function setInterfaceImplementer() public {
diff --git a/tests/units/RedemptionTokenBinding.t.sol b/tests/units/RedemptionTokenBinding.t.sol
new file mode 100644
index 0000000..298b762
--- /dev/null
+++ b/tests/units/RedemptionTokenBinding.t.sol
@@ -0,0 +1,111 @@
+// SPDX-License-Identifier: BUSL-1.1
+
+pragma solidity 0.8.28;
+
+import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+
+import { Fixture } from "../Fixture.sol";
+import { OracleReadType } from "contracts/parallelizer/Storage.sol";
+import "contracts/utils/Constants.sol";
+import "contracts/utils/Errors.sol" as Errors;
+
+/// @notice The redemption output list is rebuilt from the live `collateralList`, while `minAmountOuts`
+/// is positional. A revoke (swap and pop) followed by an add preserves the length but reshuffles the
+/// tokens, so a caller's minima would end up guarding tokens they never quoted.
+contract Test_RedemptionTokenBinding is Fixture {
+  uint256 internal redeemAmount;
+
+  function setUp() public override {
+    super.setUp();
+
+    // eurB stays unbacked so governance is allowed to revoke it
+    _mintExactInput(alice, address(eurA), 100 * BASE_6, 0);
+    _mintExactInput(alice, address(eurY), 100 * BASE_18, 0);
+
+    uint64[] memory xRedemption = new uint64[](1);
+    int64[] memory yRedemption = new int64[](1);
+    yRedemption[0] = int64(int256(BASE_9));
+    hoax(guardian);
+    parallelizer.setRedemptionCurveParams(xRedemption, yRedemption);
+
+    redeemAmount = tokenP.balanceOf(alice) / 4;
+  }
+
+  function _tokensHash() internal view returns (bytes32) {
+    (address[] memory tokens,) = parallelizer.quoteRedemptionCurve(redeemAmount);
+    return keccak256(abi.encodePacked(tokens));
+  }
+
+  /// @dev Revoking eurB pops eurY into its slot, and adding eurB back appends it: same length,
+  /// different order
+  function _rotateCollateral() internal {
+    (
+      OracleReadType oracleType,
+      OracleReadType targetType,
+      bytes memory oracleData,
+      bytes memory targetData,
+      bytes memory hyperparameters
+    ) = parallelizer.getOracle(address(eurB));
+
+    hoax(governor);
+    parallelizer.revokeCollateral(address(eurB), true);
+    hoax(governor);
+    parallelizer.addCollateral(address(eurB));
+    hoax(governor);
+    parallelizer.setOracle(
+      address(eurB), abi.encode(oracleType, targetType, oracleData, targetData, hyperparameters)
+    );
+  }
+
+  function test_Redeem_SucceedsWhenTheOutputListMatches() public {
+    uint256[] memory minAmountOuts = new uint256[](3);
+    bytes32 quotedHash = _tokensHash();
+
+    vm.prank(alice);
+    (address[] memory tokens,) =
+      parallelizer.redeem(redeemAmount, alice, block.timestamp + 1 days, minAmountOuts, quotedHash);
+
+    assertEq(tokens.length, 3);
+  }
+
+  function test_RevertWhen_CollateralRotationReordersTheOutputList() public {
+    bytes32 quotedHash = _tokensHash();
+    (address[] memory quotedTokens,) = parallelizer.quoteRedemptionCurve(redeemAmount);
+
+    _rotateCollateral();
+
+    (address[] memory liveTokens,) = parallelizer.quoteRedemptionCurve(redeemAmount);
+    assertEq(liveTokens.length, quotedTokens.length, "the rotation must preserve the length");
+    assertNotEq(liveTokens[1], quotedTokens[1], "the rotation must reorder the list");
+
+    uint256[] memory minAmountOuts = new uint256[](3);
+    vm.prank(alice);
+    vm.expectRevert(Errors.UnexpectedRedemptionTokens.selector);
+    parallelizer.redeem(redeemAmount, alice, block.timestamp + 1 days, minAmountOuts, quotedHash);
+  }
+
+  /// @dev A signature stays executable for its whole validity window, so a relayer could otherwise
+  /// hold one until governance reshuffles the list
+  function test_RevertWhen_AuthorizationOutlivesTheOutputList() public {
+    uint256 deadline = block.timestamp + 1 hours;
+    uint256[] memory minOuts = new uint256[](3);
+    address[] memory forfeit = new address[](0);
+    bytes32 quotedHash = _tokensHash();
+
+    bytes memory authData =
+      _buildRedeemAuth(1, alice, redeemAmount, alice, deadline, minOuts, forfeit, quotedHash, bytes32("rotate"));
+
+    _rotateCollateral();
+
+    // The relayer cannot satisfy the on-chain check with what was signed
+    vm.prank(bob);
+    vm.expectRevert(Errors.UnexpectedRedemptionTokens.selector);
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, quotedHash, authData);
+
+    // Nor swap in the live list, which no longer derives the signed nonce
+    bytes32 liveHash = _tokensHash();
+    vm.prank(bob);
+    vm.expectRevert(bytes("invalid signature"));
+    parallelizer.redeemWithAuthorization(redeemAmount, alice, deadline, minOuts, forfeit, liveHash, authData);
+  }
+}
diff --git a/tests/units/Setters.t.sol b/tests/units/Setters.t.sol
index fe542bc..5e251e0 100644
--- a/tests/units/Setters.t.sol
+++ b/tests/units/Setters.t.sol
@@ -80,10 +80,12 @@ contract Test_Setters_Pause is Fixture {
     assert(parallelizer.isPaused(address(eurA), ActionType.Redeem));
 
     vm.expectRevert(Errors.Paused.selector);
-    parallelizer.redeem(1 ether, alice, block.timestamp + 10, new uint256[](3));
+    parallelizer.redeem(1 ether, alice, block.timestamp + 10, new uint256[](3), bytes32(0));
 
     vm.expectRevert(Errors.Paused.selector);
-    parallelizer.redeemWithForfeit(1 ether, alice, block.timestamp + 10, new uint256[](3), new address[](0));
+    parallelizer.redeemWithForfeit(
+      1 ether, alice, block.timestamp + 10, new uint256[](3), new address[](0), bytes32(0)
+    );
   }
 }
 

From 7cceca756adb5842129820157dfe115428af9065 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 18:07:54 +0300
Subject: [PATCH 15/28] test(invariants): make the path independence suite
 measure path independence

`invariant_PathIndependenceCollateralRatio` failed once during the audit work at
0.2176% against a 0.2% tolerance. The driver was not the documented one.

`ArbitragerWithSplit` split a redemption that forfeited tokens. Forfeited tokens
stay in the reserve while the others shrink, so the composition drifts and each
later redemption forfeits a larger share of value. Measured against a plain
redemption split the same way:

  splits          2      4      8     16
  no forfeit      0      0      0      0   bps
  forfeit B     193    289    337    360   bps
  forfeit B+Y   146    209    238    252   bps

So a single split already sat an order of magnitude above the tolerance, and the
suite only passed because the fuzzer rarely landed a large forfeited redemption.
The comment credited non-flat fee curves and the entry-time penalty, both of
which measure zero here.

Forfeit is what breaks the comparison when split, not forfeit itself, so it moves
to its own `redeemWithForfeit` handler that applies the same unsplit redemption to
both systems. They drift together, the forfeit branch and its payout assertions
stay covered, and only the plain redemption is split.

Across 25 seeded campaigns the residual divergence peaks at 1.4e-8%, down from
4.1e-6%, so the collateral ratio tolerance drops from 0.2% to 0.01%, matching the
total supply one.
---
 tests/invariants/PathIndeInvariants.t.sol     |  21 +++-
 .../actors/ArbitragerWithSplit.t.sol          | 109 +++++++++++++-----
 2 files changed, 96 insertions(+), 34 deletions(-)

diff --git a/tests/invariants/PathIndeInvariants.t.sol b/tests/invariants/PathIndeInvariants.t.sol
index 8440a31..1a0c634 100644
--- a/tests/invariants/PathIndeInvariants.t.sol
+++ b/tests/invariants/PathIndeInvariants.t.sol
@@ -114,9 +114,10 @@ contract PathIndeInvariants is Fixture {
     }
 
     {
-      bytes4[] memory selectors = new bytes4[](2);
+      bytes4[] memory selectors = new bytes4[](3);
       selectors[0] = ArbitragerWithSplit.swap.selector;
       selectors[1] = ArbitragerWithSplit.redeem.selector;
+      selectors[2] = ArbitragerWithSplit.redeemWithForfeit.selector;
       targetSelector(FuzzSelector({ addr: address(_arbitragerHandler), selectors: selectors }));
     }
 
@@ -139,6 +140,7 @@ contract PathIndeInvariants is Fixture {
     console.log("Trader:swap", _traderHandler.calls("swap"));
     console.log("Arbitrager:swap", _arbitragerHandler.calls("swap"));
     console.log("Arbitrager:redeem", _arbitragerHandler.calls("redeem"));
+    console.log("Arbitrager:redeemForfeit", _arbitragerHandler.calls("redeemForfeit"));
     console.log("oracle", _governanceHandler.calls("oracle"));
     console.log("Mint fees", _governanceHandler.calls("feeMint"));
     console.log("Burn fees", _governanceHandler.calls("feeBurn"));
@@ -216,21 +218,28 @@ contract PathIndeInvariants is Fixture {
   // Path independence holds exactly only where the mint/burn/redemption curves are flat. The
   // redemption penalty is evaluated at the entry-time collateral ratio on the full amount (Cyfrin
   // finding I-6) and governance may install non-flat fee curves, so single-path and split-path
-  // outcomes legitimately diverge by a bounded amount. These tolerances bound that intended path
-  // dependence (1% on collateral balances, 0.2% on the collateral ratio) while still catching gross
-  // path-dependence regressions.
+  // outcomes legitimately diverge by a bounded amount.
+  //
+  // The dominant source used to be elsewhere: `ArbitragerWithSplit` split a redemption that forfeited
+  // tokens. Forfeited tokens stay in the reserve while the others shrink, so the composition drifts
+  // and each later redemption forfeits a larger share of value. Splitting one moved the collateral
+  // ratio by 150 to 200 bps, an order of magnitude past this tolerance.
+  //
+  // Forfeit is still exercised, through `redeemWithForfeit`, but applied identically and unsplit to
+  // both systems so they drift together. Only the plain redemption is split. The residual divergence
+  // measured over 25 seeded campaigns peaks at 1.4e-8%, against 4.1e-6% before.
   function invariant_PathIndependenceBalanceCollaterals() public {
     for (uint256 i; i < _collaterals.length; i++) {
       uint256 balance = IERC20(_collaterals[i]).balanceOf(address(parallelizer));
       uint256 balanceSplit = IERC20(_collaterals[i]).balanceOf(address(parallelizerSplit));
-      assertApproxEqRelDecimal(balance, balanceSplit, _MAX_PERCENTAGE_DEVIATION * 10000, 18);
+      assertApproxEqRelDecimal(balance, balanceSplit, _MAX_PERCENTAGE_DEVIATION * 10_000, 18);
     }
   }
 
   function invariant_PathIndependenceCollateralRatio() public {
     (uint256 collateralRatio,) = parallelizer.getCollateralRatio();
     (uint256 collateralRatioSplit,) = parallelizerSplit.getCollateralRatio();
-    assertApproxEqRelDecimal(collateralRatio, collateralRatioSplit, _MAX_PERCENTAGE_DEVIATION * 2000, 18);
+    assertApproxEqRelDecimal(collateralRatio, collateralRatioSplit, _MAX_PERCENTAGE_DEVIATION * 100, 18);
   }
 
   function invariantSystemState() public view {
diff --git a/tests/invariants/actors/ArbitragerWithSplit.t.sol b/tests/invariants/actors/ArbitragerWithSplit.t.sol
index 0ee4a8e..e7ee4ec 100644
--- a/tests/invariants/actors/ArbitragerWithSplit.t.sol
+++ b/tests/invariants/actors/ArbitragerWithSplit.t.sol
@@ -217,23 +217,23 @@ contract ArbitragerWithSplit is BaseActor {
     return (testS.amountIn, testS.amountOut);
   }
 
-  function redeem(
+  /// @dev Forfeit is exercised here, but applied identically and unsplit to both systems, so they
+  /// drift together and the path independence invariants stay meaningful. Splitting a forfeited
+  /// redemption is what breaks them: the forfeited tokens stay in the reserve while the others
+  /// shrink, so the composition drifts and each later redemption forfeits a larger share of value.
+  function redeemWithForfeit(
     bool[3] memory isForfeitTokens,
     uint256 amount,
-    uint256 splitProportion,
     uint256 actorIndex
   )
     public
     useActor(actorIndex)
-    countCall("redeem")
+    countCall("redeemForfeit")
   {
     uint256 balancetokenP = tokenP.balanceOf(_currentActor);
     amount = bound(amount, 0, balancetokenP / 2);
-    splitProportion = bound(splitProportion, 1, BASE_9);
     if (amount == 0) return;
 
-    // Build forfeitTokens from isForfeitTokens so the protocol skips them; the post-redeem
-    // assertions below assume forfeited tokens are not credited to the actor.
     address[] memory forfeitTokens;
     {
       uint256 count;
@@ -249,6 +249,70 @@ contract ArbitragerWithSplit is BaseActor {
         }
       }
     }
+    if (forfeitTokens.length == 0) return;
+
+    console.log("");
+    console.log("========= Redeem With Forfeit =========");
+
+    _redeemForfeitOn(_parallelizer, amount, isForfeitTokens, forfeitTokens);
+    _redeemForfeitOn(_parallelizerSplit, amount, isForfeitTokens, forfeitTokens);
+  }
+
+  /// @dev Extracted so the caller stays within the EVM stack-depth limit
+  function _redeemForfeitOn(
+    IParallelizer target,
+    uint256 amount,
+    bool[3] memory isForfeitTokens,
+    address[] memory forfeitTokens
+  )
+    internal
+  {
+    uint256[] memory balanceTokens = new uint256[](_collaterals.length);
+    for (uint256 i; i < balanceTokens.length; ++i) {
+      balanceTokens[i] = IERC20(_collaterals[i]).balanceOf(_currentActor);
+    }
+
+    (uint64 prevCollateralRatio,) = target.getCollateralRatio();
+    uint256[] memory redeemAmounts;
+    {
+      uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
+      bytes32 tokensHash = _redemptionTokensHash(target, amount);
+      (, redeemAmounts) = target.redeemWithForfeit(
+        amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
+      );
+    }
+
+    // forfeiting leaves value behind, so the ratio can only improve
+    (uint64 collateralRatio,) = target.getCollateralRatio();
+    assertGe(collateralRatio, prevCollateralRatio);
+    for (uint256 i; i < balanceTokens.length; ++i) {
+      if (isForfeitTokens[i]) {
+        assertEq(IERC20(_collaterals[i]).balanceOf(_currentActor), balanceTokens[i]);
+      } else {
+        assertEq(IERC20(_collaterals[i]).balanceOf(_currentActor), balanceTokens[i] + redeemAmounts[i]);
+      }
+    }
+  }
+
+  /// @dev No forfeit here, unlike the non-split `Arbitrager`. Forfeited tokens stay in the reserve
+  /// while the others shrink, so the composition drifts and each later redemption forfeits a larger
+  /// share of value. That makes redemption genuinely path dependent: a single split moves the
+  /// collateral ratio by around 150 to 200 bps against 0 for a plain redemption, which is what the
+  /// path independence invariants measure. `Arbitrager` keeps the forfeit coverage for the other suites.
+  function redeem(
+    uint256 amount,
+    uint256 splitProportion,
+    uint256 actorIndex
+  )
+    public
+    useActor(actorIndex)
+    countCall("redeem")
+  {
+    uint256 balancetokenP = tokenP.balanceOf(_currentActor);
+    amount = bound(amount, 0, balancetokenP / 2);
+    splitProportion = bound(splitProportion, 1, BASE_9);
+    if (amount == 0) return;
+
     // Redeem on the true parallelizer
     {
       uint256[] memory balanceTokens = new uint256[](_collaterals.length);
@@ -264,11 +328,9 @@ contract ArbitragerWithSplit is BaseActor {
       {
         // don't care about slippage
         uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
-        address[] memory redeemTokens;
         bytes32 tokensHash = _redemptionTokensHash(_parallelizer, amount);
-        (redeemTokens, redeemAmounts) = _parallelizer.redeemWithForfeit(
-          amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
-        );
+        (, redeemAmounts) =
+          _parallelizer.redeem(amount, _currentActor, block.timestamp + 1 hours, minAmountOuts, tokensHash);
       }
 
       // if it is a burn it should always increase the collateral ratio
@@ -277,11 +339,7 @@ contract ArbitragerWithSplit is BaseActor {
       assertEq(tokenP.balanceOf(_currentActor), balancetokenP - amount);
       balancetokenP -= amount;
       for (uint256 i; i < balanceTokens.length; ++i) {
-        if (!isForfeitTokens[i]) {
-          assertEq(IERC20(_collaterals[i]).balanceOf(_currentActor), balanceTokens[i] + redeemAmounts[i]);
-        } else {
-          assertEq(IERC20(_collaterals[i]).balanceOf(_currentActor), balanceTokens[i]);
-        }
+        assertEq(IERC20(_collaterals[i]).balanceOf(_currentActor), balanceTokens[i] + redeemAmounts[i]);
       }
     }
 
@@ -301,17 +359,16 @@ contract ArbitragerWithSplit is BaseActor {
       {
         // don't care about slippage
         uint256[] memory minAmountOuts = new uint256[](_collaterals.length);
-        address[] memory redeemTokens;
 
         uint256 amountSplit = (amount * splitProportion) / BASE_9;
         bytes32 tokensHash = _redemptionTokensHash(_parallelizerSplit, amountSplit);
-        (redeemTokens, redeemAmountsSplit1) = _parallelizerSplit.redeemWithForfeit(
-          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
+        (, redeemAmountsSplit1) = _parallelizerSplit.redeem(
+          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, tokensHash
         );
         amountSplit = amount - amountSplit;
         tokensHash = _redemptionTokensHash(_parallelizerSplit, amountSplit);
-        (, redeemAmountsSplit2) = _parallelizerSplit.redeemWithForfeit(
-          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, forfeitTokens, tokensHash
+        (, redeemAmountsSplit2) = _parallelizerSplit.redeem(
+          amountSplit, _currentActor, block.timestamp + 1 hours, minAmountOuts, tokensHash
         );
       }
 
@@ -320,14 +377,10 @@ contract ArbitragerWithSplit is BaseActor {
       assertGe(collateralRatio, prevCollateralRatio);
       assertEq(tokenP.balanceOf(_currentActor), balancetokenP - amount);
       for (uint256 i; i < balanceTokens.length; ++i) {
-        if (!isForfeitTokens[i]) {
-          assertEq(
-            IERC20(_collaterals[i]).balanceOf(_currentActor),
-            balanceTokens[i] + redeemAmountsSplit1[i] + redeemAmountsSplit2[i]
-          );
-        } else {
-          assertEq(IERC20(_collaterals[i]).balanceOf(_currentActor), balanceTokens[i]);
-        }
+        assertEq(
+          IERC20(_collaterals[i]).balanceOf(_currentActor),
+          balanceTokens[i] + redeemAmountsSplit1[i] + redeemAmountsSplit2[i]
+        );
       }
     }
   }

From 5710e3cd6d6db88a2f0ba7c1bfdf84bece3de973 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 21:41:41 +0300
Subject: [PATCH 16/28] perf(rebalancer): pack the yield bearing params into
 two slots

`maxSlippage` was a uint96, a width inherited from the Angle fork where it was a
standalone variable that had a slot to itself. Inside `YieldBearingParams` its 12
bytes no longer fit beside the four uint64 exposures, so it spilled into a third
slot and left 20 bytes unused.

The value is bounded below 1e9, so uint64 is ample and closes the second slot
exactly:

  asset             slot 0  offset  0
  targetExposure    slot 0  offset 20
  maxExposure       slot 1  offset  0
  minExposure       slot 1  offset  8
  overrideExposures slot 1  offset 16
  maxSlippage       slot 1  offset 24

Configuring an asset drops from 104588 to 82501 gas.
---
 contracts/helpers/BaseRebalancer.sol       | 13 +++++++------
 contracts/helpers/MultiBlockRebalancer.sol |  2 +-
 contracts/interfaces/IRebalancer.sol       |  4 ++--
 tests/units/Rebalancer.t.sol               |  2 +-
 4 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/contracts/helpers/BaseRebalancer.sol b/contracts/helpers/BaseRebalancer.sol
index b9d22a6..19abd87 100644
--- a/contracts/helpers/BaseRebalancer.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -22,8 +22,9 @@ struct YieldBearingParams {
   // Whether limit exposures should be overriden or read onchain through the Parallelizer
   // This value should be 1 to override exposures or 2 if these shouldn't be overriden
   uint64 overrideExposures;
-  // Maximum slippage when dealing with the Parallelizer
-  uint96 maxSlippage;
+  // Maximum slippage when dealing with the Parallelizer, bounded below 1e9 so uint64 leaves the
+  // struct packed in two slots
+  uint64 maxSlippage;
 }
 
 /// @title BaseRebalancer
@@ -115,7 +116,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     uint64 minExposure,
     uint64 maxExposure,
     uint64 overrideExposures,
-    uint96 maxSlippage
+    uint64 maxSlippage
   )
     external
     restricted
@@ -140,7 +141,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
    * @notice Set the max allowed slippage
    * @param newMaxSlippage new max allowed slippage
    */
-  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external restricted {
+  function setMaxSlippage(address yieldBearingAsset, uint64 newMaxSlippage) external restricted {
     _setMaxSlippage(yieldBearingAsset, newMaxSlippage);
   }
 
@@ -252,7 +253,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     uint64 minExposure,
     uint64 maxExposure,
     uint64 overrideExposures,
-    uint96 maxSlippage
+    uint64 maxSlippage
   )
     internal
     virtual
@@ -301,7 +302,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     else yieldBearingInfo.minExposure = xFeeBurn[length - 2];
   }
 
-  function _setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) internal virtual {
+  function _setMaxSlippage(address yieldBearingAsset, uint64 newMaxSlippage) internal virtual {
     if (newMaxSlippage >= 1e9) revert InvalidParam();
     yieldBearingData[yieldBearingAsset].maxSlippage = newMaxSlippage;
   }
diff --git a/contracts/helpers/MultiBlockRebalancer.sol b/contracts/helpers/MultiBlockRebalancer.sol
index 8edd3f5..172ab3c 100644
--- a/contracts/helpers/MultiBlockRebalancer.sol
+++ b/contracts/helpers/MultiBlockRebalancer.sol
@@ -148,7 +148,7 @@ contract MultiBlockRebalancer is BaseRebalancer {
     address asset,
     address depositAddress,
     bool assetIn,
-    uint96 maxSlippage
+    uint64 maxSlippage
   )
     internal
     view
diff --git a/contracts/interfaces/IRebalancer.sol b/contracts/interfaces/IRebalancer.sol
index 6991e60..5a33c3a 100644
--- a/contracts/interfaces/IRebalancer.sol
+++ b/contracts/interfaces/IRebalancer.sol
@@ -14,13 +14,13 @@ interface IRebalancer {
     uint64 minExposureYieldAsset,
     uint64 maxExposureYieldAsset,
     uint64 overrideExposures,
-    uint96 maxSlippage
+    uint64 maxSlippage
   )
     external;
 
   function updateLimitExposuresYieldAsset(address yieldBearingAsset) external;
 
-  function setMaxSlippage(address yieldBearingAsset, uint96 newMaxSlippage) external;
+  function setMaxSlippage(address yieldBearingAsset, uint64 newMaxSlippage) external;
 
   function harvest(address yieldBearingAsset, uint256 scale, bytes calldata extraData) external;
 }
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index 0754144..37e7963 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -43,7 +43,7 @@ contract Test_Rebalancer_MaxSlippage is Fixture {
     vm.prank(guardian);
     rebalancer.setMaxSlippage(yieldBearingAsset, 1e7);
 
-    (,,,,, uint96 maxSlippage) = rebalancer.yieldBearingData(yieldBearingAsset);
+    (,,,,, uint64 maxSlippage) = rebalancer.yieldBearingData(yieldBearingAsset);
     assertEq(maxSlippage, 1e7);
   }
 

From b035be8bf10fbdb917e7739d99f04f1851914821 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 7 Sep 2026 22:19:11 +0300
Subject: [PATCH 17/28] fix(reward-handler): make the swap router configurable
 per chain

`sellRewards` forwarded its payload to `ODOS_ROUTER`, a constant holding the
Ethereum Odos address. The same facet bytecode ships to every chain, so the
target was wrong everywhere but mainnet. Checked on the five live deployments:

  mainnet     bytecode present, the Odos router
  sonic       bytecode present, an unrelated contract
  base        no bytecode
  avalanche   no bytecode
  hyperevm    no bytecode

A raw call to an address with no code returns success with empty returndata, so
the flow ran on to find no balance increase and reverted with InvalidSwap. The
selector is wired on all five diamonds.

The target moves to `swapRouter`, appended to `ParallelizerStorage` and set by
governance. Nothing is Odos specific: the payload is executed with a raw call, so
any aggregator or DEX can be configured. `ODOS_ROUTER` is gone, `OdosSwapFailed`
becomes `RewardSwapFailed`, and `MockOdosRouter` becomes `MockSwapRouter`.

An unset router now reverts instead of calling address zero, which would have
reported success and left the swap silently unperformed.

Layout.sol had drifted: it documented 9 slots while the struct had grown to 15
with the surplus distribution fields. It now mirrors all 16, and the layout test
asserts the tail so an append cannot slip through unnoticed again.

Governance must call `setSwapRouter` on every chain after the upgrade, before
rewards can be sold.

Bailsec Core Issue_15
---
 contracts/interfaces/IGetters.sol             |   3 +
 contracts/interfaces/IRewardHandler.sol       |   4 +-
 contracts/interfaces/ISetters.sol             |   5 +
 contracts/parallelizer/Layout.sol             |  11 +-
 contracts/parallelizer/Storage.sol            |   2 +
 contracts/parallelizer/facets/Getters.sol     |   5 +
 .../parallelizer/facets/RewardHandler.sol     |  10 +-
 .../parallelizer/facets/SettersGovernor.sol   |   5 +
 .../parallelizer/libraries/LibSetters.sol     |   8 ++
 contracts/utils/Constants.sol                 |  11 +-
 contracts/utils/Errors.sol                    |   2 +-
 generated/abis/BaseRebalancer.d.ts            |  12 +-
 generated/abis/BaseRebalancer.js              |  12 +-
 generated/abis/GenericRebalancer.d.ts         |  12 +-
 generated/abis/GenericRebalancer.js           |  12 +-
 generated/abis/Getters.d.ts                   |  13 +++
 generated/abis/Getters.js                     |  13 +++
 generated/abis/IGetters.d.ts                  |  13 +++
 generated/abis/IGetters.js                    |  13 +++
 generated/abis/IParallelizer.d.ts             |  26 +++++
 generated/abis/IParallelizer.js               |  26 +++++
 generated/abis/IRebalancer.d.ts               |   8 +-
 generated/abis/IRebalancer.js                 |   8 +-
 generated/abis/ISettersGovernor.d.ts          |  13 +++
 generated/abis/ISettersGovernor.js            |  13 +++
 generated/abis/Layout.d.ts                    | 109 ++++++++++++++++++
 generated/abis/Layout.js                      | 109 ++++++++++++++++++
 generated/abis/LibSetters.d.ts                |  13 +++
 generated/abis/LibSetters.js                  |  13 +++
 generated/abis/MultiBlockRebalancer.d.ts      |  12 +-
 generated/abis/MultiBlockRebalancer.js        |  12 +-
 generated/abis/RewardHandler.d.ts             |   9 +-
 generated/abis/RewardHandler.js               |   9 +-
 generated/abis/SettersGovernor.d.ts           |  31 +++++
 generated/abis/SettersGovernor.js             |  31 +++++
 scripts/SetParallelizerRoles.s.sol            |   3 +-
 ...{MockOdosRouter.sol => MockSwapRouter.sol} |   2 +-
 tests/units/Layout.t.sol                      |  26 ++++-
 tests/units/RewardHandlerTest.t.sol           | 102 ++++++++++------
 tests/utils/ConfigAccessManager.sol           |   3 +-
 40 files changed, 641 insertions(+), 103 deletions(-)
 rename tests/mock/{MockOdosRouter.sol => MockSwapRouter.sol} (97%)

diff --git a/contracts/interfaces/IGetters.sol b/contracts/interfaces/IGetters.sol
index 6f0d6e2..6e78de6 100644
--- a/contracts/interfaces/IGetters.sol
+++ b/contracts/interfaces/IGetters.sol
@@ -144,6 +144,9 @@ interface IGetters {
 
   /// @notice Returns the minimum collateral ratio that must hold after surplus processing
   /// @dev Expressed in base 1e9, and always >= 1e9
+  /// @notice Returns the aggregator or DEX the `RewardHandler` forwards its swap payload to
+  function getSwapRouter() external view returns (address);
+
   function getSurplusBufferRatio() external view returns (uint64);
 
   /// @notice Computes the surplus of a collateral.
diff --git a/contracts/interfaces/IRewardHandler.sol b/contracts/interfaces/IRewardHandler.sol
index 742cd72..1ae085b 100644
--- a/contracts/interfaces/IRewardHandler.sol
+++ b/contracts/interfaces/IRewardHandler.sol
@@ -7,9 +7,9 @@ pragma solidity 0.8.28;
 /// @dev This interface is an authorized fork of Angle's `IRewardHandler` interface
 /// https://github.com/AngleProtocol/angle-transmuter/blob/main/contracts/interfaces/IRewardHandler.sol
 interface IRewardHandler {
-  /// @notice Sells some external tokens through a odos call
+  /// @notice Sells some external tokens through a call to the configured swap router
   /// @param minAmountOut Minimum amount of the outToken to get
-  /// @param payload Payload to pass to odos
+  /// @param payload Payload to pass to the swap router
   /// @return amountOut Amount obtained of the outToken
   function sellRewards(uint256 minAmountOut, bytes memory payload) external returns (uint256 amountOut);
 }
diff --git a/contracts/interfaces/ISetters.sol b/contracts/interfaces/ISetters.sol
index 17b514b..d20111e 100644
--- a/contracts/interfaces/ISetters.sol
+++ b/contracts/interfaces/ISetters.sol
@@ -72,6 +72,11 @@ interface ISettersGovernor {
   /// @dev The surplus buffer ratio is the minimum collateral ratio required after surplus processing
   /// @param _surplusBufferRatio The new surplus buffer ratio in BASE_9
   function updateSurplusBufferRatio(uint64 _surplusBufferRatio) external;
+
+  /// @notice Sets the aggregator or DEX the `RewardHandler` forwards its swap payload to
+  /// @dev The payload is executed with a raw call, so any router can be configured. It is chain
+  /// specific and must be set on every deployment before rewards can be sold
+  function setSwapRouter(address swapRouter) external;
 }
 
 /// @title ISettersGovernor
diff --git a/contracts/parallelizer/Layout.sol b/contracts/parallelizer/Layout.sol
index 05dd496..6d2d640 100644
--- a/contracts/parallelizer/Layout.sol
+++ b/contracts/parallelizer/Layout.sol
@@ -36,8 +36,15 @@ contract Layout {
   mapping(address => uint256) public isTrusted; // slot 7
   mapping(address => uint256) public isSellerTrusted; // slot 8
   mapping(WhitelistType => mapping(address => uint256)) public isWhitelistedForType; // slot 9
-  // uint256(DIAMOND_STORAGE_POSITION) - ParallelizerStorage offset (9) - uint256(TRANSMUTER_STORAGE_POSITION)
-  uint256[56_904_584_862_873_869_173_946_452_133_933_512_717_281_559_375_467_474_726_875_187_792_230_718_146_205]
+  mapping(address => uint256) public slippageTolerance; // slot 10
+  uint64 public surplusBufferRatio; // slot 11
+  uint256 public lastReleasedAt; // slot 12
+  uint256 public totalShares; // slot 13
+  address[] public payees; // slot 14
+  mapping(address => uint256) public shares; // slot 15
+  address public swapRouter; // slot 16
+  // uint256(DIAMOND_STORAGE_POSITION) - ParallelizerStorage offset (16) - uint256(TRANSMUTER_STORAGE_POSITION)
+  uint256[56_904_584_862_873_869_173_946_452_133_933_512_717_281_559_375_467_474_726_875_187_792_230_718_146_198]
     private __gap3;
   bytes4[] public selectors; // slot 1
   mapping(bytes4 => FacetInfo) public selectorInfo; // slot 2
diff --git a/contracts/parallelizer/Storage.sol b/contracts/parallelizer/Storage.sol
index a77e16f..d735820 100644
--- a/contracts/parallelizer/Storage.sol
+++ b/contracts/parallelizer/Storage.sol
@@ -149,4 +149,6 @@ struct ParallelizerStorage {
   uint256 totalShares; // The total shares of the totalShares for all payees
   address[] payees; // The addresses of the payees
   mapping(address => uint256) shares; // The shares of the totalShares for each payee
+  // Aggregator or DEX the `RewardHandler` forwards its swap payload to
+  address swapRouter;
 }
diff --git a/contracts/parallelizer/facets/Getters.sol b/contracts/parallelizer/facets/Getters.sol
index e8e734f..bf58020 100644
--- a/contracts/parallelizer/facets/Getters.sol
+++ b/contracts/parallelizer/facets/Getters.sol
@@ -235,6 +235,11 @@ contract Getters is IGetters {
     return s.transmuterStorage().slippageTolerance[collateral];
   }
 
+  /// @inheritdoc IGetters
+  function getSwapRouter() external view returns (address) {
+    return s.transmuterStorage().swapRouter;
+  }
+
   /// @inheritdoc IGetters
   function getSurplusBufferRatio() external view returns (uint64) {
     return s.transmuterStorage().surplusBufferRatio;
diff --git a/contracts/parallelizer/facets/RewardHandler.sol b/contracts/parallelizer/facets/RewardHandler.sol
index 36892ac..2f8d063 100644
--- a/contracts/parallelizer/facets/RewardHandler.sol
+++ b/contracts/parallelizer/facets/RewardHandler.sol
@@ -30,7 +30,7 @@ contract RewardHandler is IRewardHandler, AccessManagedModifiers {
   /// @dev It is impossible to sell a token that is a collateral through this function
   /// @dev Trusted sellers and governance only may call this function
   /// @dev Only governance can set which tokens can be swapped through this function by passing a prior approval
-  /// transaction to Odos router for the token to be swapped
+  /// transaction to the configured `swapRouter` for the token to be swapped
   function sellRewards(uint256 minAmountOut, bytes memory payload) external nonReentrant returns (uint256 amountOut) {
     ParallelizerStorage storage ts = s.transmuterStorage();
     if (!LibDiamond.checkCanCall(msg.sender, msg.data) && ts.isSellerTrusted[msg.sender] == 0) revert NotTrusted();
@@ -44,8 +44,10 @@ contract RewardHandler is IRewardHandler, AccessManagedModifiers {
       balances[i] = IERC20(list[i]).balanceOf(address(this));
     }
     uint256 tokenPBalance = IERC20(address(ts.tokenP)).balanceOf(address(this));
+    address swapRouter = ts.swapRouter;
+    if (swapRouter == address(0)) revert ZeroAddress();
     //solhint-disable-next-line
-    (bool success, bytes memory result) = ODOS_ROUTER.call(payload);
+    (bool success, bytes memory result) = swapRouter.call(payload);
     if (!success) _revertBytes(result);
     if (IERC20(address(ts.tokenP)).balanceOf(address(this)) < tokenPBalance) revert InvalidTokens();
     bool hasIncreased;
@@ -70,7 +72,7 @@ contract RewardHandler is IRewardHandler, AccessManagedModifiers {
     }
   }
 
-  /// @notice Processes odos revert messages
+  /// @notice Processes the router's revert messages
   function _revertBytes(bytes memory errMsg) private pure {
     if (errMsg.length > 0) {
       //solhint-disable-next-line
@@ -78,6 +80,6 @@ contract RewardHandler is IRewardHandler, AccessManagedModifiers {
         revert(add(32, errMsg), mload(errMsg))
       }
     }
-    revert OdosSwapFailed();
+    revert RewardSwapFailed();
   }
 }
diff --git a/contracts/parallelizer/facets/SettersGovernor.sol b/contracts/parallelizer/facets/SettersGovernor.sol
index 8101664..1add36a 100644
--- a/contracts/parallelizer/facets/SettersGovernor.sol
+++ b/contracts/parallelizer/facets/SettersGovernor.sol
@@ -132,4 +132,9 @@ contract SettersGovernor is AccessManagedModifiers, ISettersGovernor {
   function updateSurplusBufferRatio(uint64 _surplusBufferRatio) external restricted {
     LibSetters.updateSurplusBufferRatio(_surplusBufferRatio);
   }
+
+  /// @inheritdoc ISettersGovernor
+  function setSwapRouter(address swapRouter) external restricted {
+    LibSetters.setSwapRouter(swapRouter);
+  }
 }
diff --git a/contracts/parallelizer/libraries/LibSetters.sol b/contracts/parallelizer/libraries/LibSetters.sol
index 7c72224..7de70b5 100644
--- a/contracts/parallelizer/libraries/LibSetters.sol
+++ b/contracts/parallelizer/libraries/LibSetters.sol
@@ -39,6 +39,7 @@ library LibSetters {
   event PayeeAdded(address indexed payee, uint256 shares);
   event SlippageToleranceUpdated(address indexed collateral, uint256 slippageTolerance);
   event SurplusBufferRatioUpdated(uint64 surplusBufferRatio);
+  event SwapRouterUpdated(address indexed swapRouter);
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
     ONLY GOVERNOR ACTIONS
@@ -303,6 +304,13 @@ library LibSetters {
     emit SlippageToleranceUpdated(collateral, slippageTolerance);
   }
 
+  /// @notice Internal version of `setSwapRouter`
+  function setSwapRouter(address swapRouter) internal {
+    if (swapRouter == address(0)) revert ZeroAddress();
+    s.transmuterStorage().swapRouter = swapRouter;
+    emit SwapRouterUpdated(swapRouter);
+  }
+
   /// @notice Internal version of `updateSurplusBufferRatio`
   function updateSurplusBufferRatio(uint64 _surplusBufferRatio) internal {
     if (_surplusBufferRatio < uint64(BASE_9)) revert InvalidParam();
diff --git a/contracts/utils/Constants.sol b/contracts/utils/Constants.sol
index 9ad8d55..da477a3 100644
--- a/contracts/utils/Constants.sol
+++ b/contracts/utils/Constants.sol
@@ -7,7 +7,7 @@ import { IStETH } from "contracts/interfaces/external/lido/IStETH.sol";
 import { IRETH } from "contracts/interfaces/external/rocketPool/IRETH.sol";
 
 /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-                                                 STORAGE SLOTS                                                  
+                                                 STORAGE SLOTS
 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
 /// @dev Storage position of `DiamondStorage` structure
@@ -23,7 +23,7 @@ bytes32 constant TRANSMUTER_STORAGE_POSITION = 0x4b2dd303f68b99d244b702089c802b6
 bytes32 constant IMPLEMENTATION_STORAGE_POSITION = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
 
 /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-                                                     MATHS                                                      
+                                                     MATHS
 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
 uint256 constant BASE_6 = 1e6;
@@ -44,7 +44,7 @@ uint256 constant MAX_STORED_ASSETS_INIT_STALENESS = 30 minutes;
 uint256 constant MAX_ORACLE_RATCHET_STEP = 5e16;
 
 /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-                                                     REENTRANT                                                      
+                                                     REENTRANT
 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
 // The values being non-zero value makes deployment a bit more expensive,
@@ -56,7 +56,7 @@ uint8 constant NOT_ENTERED = 1;
 uint8 constant ENTERED = 2;
 
 /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-                                                     REENTRANT                                                      
+                                                     REENTRANT
 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
 // Role IDs for the AccessManager
@@ -65,11 +65,10 @@ uint64 constant GUARDIAN_ROLE = 20;
 uint64 constant KEEPER_ROLE = 30;
 
 /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-                                               COMMON ADDRESSES                                                 
+                                               COMMON ADDRESSES
 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
 address constant PERMIT_2 = 0x000000000022D473030F116dDEE9F6B43aC78BA3;
-address constant ODOS_ROUTER = 0xCf5540fFFCdC3d510B18bFcA6d2b9987b0772559;
 ICbETH constant CBETH = ICbETH(0xBe9895146f7AF43049ca1c1AE358B0541Ea49704);
 IRETH constant RETH = IRETH(0xae78736Cd615f374D3085123A210448E74Fc6393);
 IStETH constant STETH = IStETH(0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84);
diff --git a/contracts/utils/Errors.sol b/contracts/utils/Errors.sol
index 35b7d99..6127e29 100644
--- a/contracts/utils/Errors.sol
+++ b/contracts/utils/Errors.sol
@@ -40,7 +40,7 @@ error NotGuardian();
 error NotTrusted();
 error NotTrustedOrGuardian();
 error NotWhitelisted();
-error OdosSwapFailed();
+error RewardSwapFailed();
 error OracleUpdateFailed();
 error SurplusBufferRatioNotSet();
 error Paused();
diff --git a/generated/abis/BaseRebalancer.d.ts b/generated/abis/BaseRebalancer.d.ts
index c0b1549..e4b84cf 100644
--- a/generated/abis/BaseRebalancer.d.ts
+++ b/generated/abis/BaseRebalancer.d.ts
@@ -301,9 +301,9 @@ export type Abi_BaseRebalancer = [
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -362,9 +362,9 @@ export type Abi_BaseRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
@@ -447,9 +447,9 @@ export type Abi_BaseRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "stateMutability": "view",
diff --git a/generated/abis/BaseRebalancer.js b/generated/abis/BaseRebalancer.js
index 01d033e..ae7124b 100644
--- a/generated/abis/BaseRebalancer.js
+++ b/generated/abis/BaseRebalancer.js
@@ -301,9 +301,9 @@ export const Abi_BaseRebalancer = /** @type {const} **/ ([
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -362,9 +362,9 @@ export const Abi_BaseRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
@@ -447,9 +447,9 @@ export const Abi_BaseRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "stateMutability": "view",
diff --git a/generated/abis/GenericRebalancer.d.ts b/generated/abis/GenericRebalancer.d.ts
index 02676fa..2631a39 100644
--- a/generated/abis/GenericRebalancer.d.ts
+++ b/generated/abis/GenericRebalancer.d.ts
@@ -503,9 +503,9 @@ export type Abi_GenericRebalancer = [
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -590,9 +590,9 @@ export type Abi_GenericRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
@@ -701,9 +701,9 @@ export type Abi_GenericRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "stateMutability": "view",
diff --git a/generated/abis/GenericRebalancer.js b/generated/abis/GenericRebalancer.js
index 816a64c..618e224 100644
--- a/generated/abis/GenericRebalancer.js
+++ b/generated/abis/GenericRebalancer.js
@@ -503,9 +503,9 @@ export const Abi_GenericRebalancer = /** @type {const} **/ ([
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -590,9 +590,9 @@ export const Abi_GenericRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
@@ -701,9 +701,9 @@ export const Abi_GenericRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "stateMutability": "view",
diff --git a/generated/abis/Getters.d.ts b/generated/abis/Getters.d.ts
index 5b672f5..3017b70 100644
--- a/generated/abis/Getters.d.ts
+++ b/generated/abis/Getters.d.ts
@@ -547,6 +547,19 @@ export type Abi_Getters = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "getSwapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "getTotalIssued",
diff --git a/generated/abis/Getters.js b/generated/abis/Getters.js
index c9ab986..c354e77 100644
--- a/generated/abis/Getters.js
+++ b/generated/abis/Getters.js
@@ -547,6 +547,19 @@ export const Abi_Getters = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "getSwapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "getTotalIssued",
diff --git a/generated/abis/IGetters.d.ts b/generated/abis/IGetters.d.ts
index c80683b..f8d2479 100644
--- a/generated/abis/IGetters.d.ts
+++ b/generated/abis/IGetters.d.ts
@@ -506,6 +506,19 @@ export type Abi_IGetters = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "getSwapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "getTotalIssued",
diff --git a/generated/abis/IGetters.js b/generated/abis/IGetters.js
index 3ea36b6..d816162 100644
--- a/generated/abis/IGetters.js
+++ b/generated/abis/IGetters.js
@@ -506,6 +506,19 @@ export const Abi_IGetters = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "getSwapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "getTotalIssued",
diff --git a/generated/abis/IParallelizer.d.ts b/generated/abis/IParallelizer.d.ts
index 40cf117..fc55b22 100644
--- a/generated/abis/IParallelizer.d.ts
+++ b/generated/abis/IParallelizer.d.ts
@@ -681,6 +681,19 @@ export type Abi_IParallelizer = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "getSwapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "getTotalIssued",
@@ -1393,6 +1406,19 @@ export type Abi_IParallelizer = [
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "setSwapRouter",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/IParallelizer.js b/generated/abis/IParallelizer.js
index c95621f..fc8f2ef 100644
--- a/generated/abis/IParallelizer.js
+++ b/generated/abis/IParallelizer.js
@@ -681,6 +681,19 @@ export const Abi_IParallelizer = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "getSwapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "getTotalIssued",
@@ -1393,6 +1406,19 @@ export const Abi_IParallelizer = /** @type {const} **/ ([
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "setSwapRouter",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/IRebalancer.d.ts b/generated/abis/IRebalancer.d.ts
index 71bebfc..f465af5 100644
--- a/generated/abis/IRebalancer.d.ts
+++ b/generated/abis/IRebalancer.d.ts
@@ -30,9 +30,9 @@ export type Abi_IRebalancer = [
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -73,9 +73,9 @@ export type Abi_IRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
diff --git a/generated/abis/IRebalancer.js b/generated/abis/IRebalancer.js
index f69a3a1..3f56760 100644
--- a/generated/abis/IRebalancer.js
+++ b/generated/abis/IRebalancer.js
@@ -30,9 +30,9 @@ export const Abi_IRebalancer = /** @type {const} **/ ([
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -73,9 +73,9 @@ export const Abi_IRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
diff --git a/generated/abis/ISettersGovernor.d.ts b/generated/abis/ISettersGovernor.d.ts
index afe2a07..bb0a501 100644
--- a/generated/abis/ISettersGovernor.d.ts
+++ b/generated/abis/ISettersGovernor.d.ts
@@ -170,6 +170,19 @@ export type Abi_ISettersGovernor = [
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "setSwapRouter",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/ISettersGovernor.js b/generated/abis/ISettersGovernor.js
index 8f7c6b2..fe08435 100644
--- a/generated/abis/ISettersGovernor.js
+++ b/generated/abis/ISettersGovernor.js
@@ -170,6 +170,19 @@ export const Abi_ISettersGovernor = /** @type {const} **/ ([
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "setSwapRouter",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/Layout.d.ts b/generated/abis/Layout.d.ts
index aef94a5..6c98465 100644
--- a/generated/abis/Layout.d.ts
+++ b/generated/abis/Layout.d.ts
@@ -208,6 +208,19 @@ export type Abi_Layout = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "lastReleasedAt",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "nonReentrant",
@@ -247,6 +260,25 @@ export type Abi_Layout = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "name": "payees",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -290,6 +322,70 @@ export type Abi_Layout = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "shares",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "slippageTolerance",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "surplusBufferRatio",
+    "outputs": [
+      {
+        "internalType": "uint64",
+        "name": "",
+        "type": "uint64"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "swapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "tokenP",
@@ -303,6 +399,19 @@ export type Abi_Layout = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "totalShares",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/Layout.js b/generated/abis/Layout.js
index 3baba84..143e2fc 100644
--- a/generated/abis/Layout.js
+++ b/generated/abis/Layout.js
@@ -208,6 +208,19 @@ export const Abi_Layout = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "lastReleasedAt",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "nonReentrant",
@@ -247,6 +260,25 @@ export const Abi_Layout = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "name": "payees",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -290,6 +322,70 @@ export const Abi_Layout = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "shares",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "slippageTolerance",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "surplusBufferRatio",
+    "outputs": [
+      {
+        "internalType": "uint64",
+        "name": "",
+        "type": "uint64"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "swapRouter",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "tokenP",
@@ -303,6 +399,19 @@ export const Abi_Layout = /** @type {const} **/ ([
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "totalShares",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/LibSetters.d.ts b/generated/abis/LibSetters.d.ts
index 96f2fd7..74c1586 100644
--- a/generated/abis/LibSetters.d.ts
+++ b/generated/abis/LibSetters.d.ts
@@ -289,6 +289,19 @@ export type Abi_LibSetters = [
     "name": "SurplusBufferRatioUpdated",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "SwapRouterUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/LibSetters.js b/generated/abis/LibSetters.js
index 28025fe..e3e8446 100644
--- a/generated/abis/LibSetters.js
+++ b/generated/abis/LibSetters.js
@@ -289,6 +289,19 @@ export const Abi_LibSetters = /** @type {const} **/ ([
     "name": "SurplusBufferRatioUpdated",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "SwapRouterUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/MultiBlockRebalancer.d.ts b/generated/abis/MultiBlockRebalancer.d.ts
index 18e1fcb..0eb6141 100644
--- a/generated/abis/MultiBlockRebalancer.d.ts
+++ b/generated/abis/MultiBlockRebalancer.d.ts
@@ -355,9 +355,9 @@ export type Abi_MultiBlockRebalancer = [
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -416,9 +416,9 @@ export type Abi_MultiBlockRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
@@ -519,9 +519,9 @@ export type Abi_MultiBlockRebalancer = [
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "stateMutability": "view",
diff --git a/generated/abis/MultiBlockRebalancer.js b/generated/abis/MultiBlockRebalancer.js
index 523e7b2..b999476 100644
--- a/generated/abis/MultiBlockRebalancer.js
+++ b/generated/abis/MultiBlockRebalancer.js
@@ -355,9 +355,9 @@ export const Abi_MultiBlockRebalancer = /** @type {const} **/ ([
         "type": "address"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "newMaxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setMaxSlippage",
@@ -416,9 +416,9 @@ export const Abi_MultiBlockRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "name": "setYieldBearingAssetData",
@@ -519,9 +519,9 @@ export const Abi_MultiBlockRebalancer = /** @type {const} **/ ([
         "type": "uint64"
       },
       {
-        "internalType": "uint96",
+        "internalType": "uint64",
         "name": "maxSlippage",
-        "type": "uint96"
+        "type": "uint64"
       }
     ],
     "stateMutability": "view",
diff --git a/generated/abis/RewardHandler.d.ts b/generated/abis/RewardHandler.d.ts
index 8aa4d3a..14b0fdc 100644
--- a/generated/abis/RewardHandler.d.ts
+++ b/generated/abis/RewardHandler.d.ts
@@ -16,12 +16,12 @@ export type Abi_RewardHandler = [
   },
   {
     "inputs": [],
-    "name": "OdosSwapFailed",
+    "name": "ReentrantCall",
     "type": "error"
   },
   {
     "inputs": [],
-    "name": "ReentrantCall",
+    "name": "RewardSwapFailed",
     "type": "error"
   },
   {
@@ -40,6 +40,11 @@ export type Abi_RewardHandler = [
     "name": "TooSmallAmountOut",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "ZeroAddress",
+    "type": "error"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/RewardHandler.js b/generated/abis/RewardHandler.js
index b5a1e24..2ddf666 100644
--- a/generated/abis/RewardHandler.js
+++ b/generated/abis/RewardHandler.js
@@ -16,12 +16,12 @@ export const Abi_RewardHandler = /** @type {const} **/ ([
   },
   {
     "inputs": [],
-    "name": "OdosSwapFailed",
+    "name": "ReentrantCall",
     "type": "error"
   },
   {
     "inputs": [],
-    "name": "ReentrantCall",
+    "name": "RewardSwapFailed",
     "type": "error"
   },
   {
@@ -40,6 +40,11 @@ export const Abi_RewardHandler = /** @type {const} **/ ([
     "name": "TooSmallAmountOut",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "ZeroAddress",
+    "type": "error"
+  },
   {
     "anonymous": false,
     "inputs": [
diff --git a/generated/abis/SettersGovernor.d.ts b/generated/abis/SettersGovernor.d.ts
index 7b99c32..2f0ba6e 100644
--- a/generated/abis/SettersGovernor.d.ts
+++ b/generated/abis/SettersGovernor.d.ts
@@ -133,6 +133,11 @@ export type Abi_SettersGovernor = [
     "name": "SafeERC20FailedOperation",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "ZeroAddress",
+    "type": "error"
+  },
   {
     "inputs": [],
     "name": "ZeroAmount",
@@ -428,6 +433,19 @@ export type Abi_SettersGovernor = [
     "name": "SurplusBufferRatioUpdated",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "SwapRouterUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -624,6 +642,19 @@ export type Abi_SettersGovernor = [
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "setSwapRouter",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/generated/abis/SettersGovernor.js b/generated/abis/SettersGovernor.js
index b09aaa5..50359af 100644
--- a/generated/abis/SettersGovernor.js
+++ b/generated/abis/SettersGovernor.js
@@ -133,6 +133,11 @@ export const Abi_SettersGovernor = /** @type {const} **/ ([
     "name": "SafeERC20FailedOperation",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "ZeroAddress",
+    "type": "error"
+  },
   {
     "inputs": [],
     "name": "ZeroAmount",
@@ -428,6 +433,19 @@ export const Abi_SettersGovernor = /** @type {const} **/ ([
     "name": "SurplusBufferRatioUpdated",
     "type": "event"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "SwapRouterUpdated",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -624,6 +642,19 @@ export const Abi_SettersGovernor = /** @type {const} **/ ([
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "swapRouter",
+        "type": "address"
+      }
+    ],
+    "name": "setSwapRouter",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [
       {
diff --git a/scripts/SetParallelizerRoles.s.sol b/scripts/SetParallelizerRoles.s.sol
index 8762e67..ea01ede 100644
--- a/scripts/SetParallelizerRoles.s.sol
+++ b/scripts/SetParallelizerRoles.s.sol
@@ -21,7 +21,7 @@ contract SetParallelizerRoles is BaseScript {
     guardianSelectors[6] = IDiamondEtherscan.setDummyImplementation.selector;
     accessManager.setTargetFunctionRole(parallelizer, guardianSelectors, Roles.GUARDIAN_ROLE);
 
-    bytes4[] memory governorSelectors = new bytes4[](14);
+    bytes4[] memory governorSelectors = new bytes4[](15);
     governorSelectors[0] = ISettersGovernor.recoverERC20.selector;
     governorSelectors[1] = ISettersGovernor.setAccessManager.selector;
     governorSelectors[2] = ISettersGovernor.setCollateralManager.selector;
@@ -36,6 +36,7 @@ contract SetParallelizerRoles is BaseScript {
     governorSelectors[11] = ISettersGovernor.updatePayees.selector;
     governorSelectors[12] = ISettersGovernor.updateSlippageTolerance.selector;
     governorSelectors[13] = ISettersGovernor.updateSurplusBufferRatio.selector;
+    governorSelectors[14] = ISettersGovernor.setSwapRouter.selector;
     accessManager.setTargetFunctionRole(parallelizer, governorSelectors, Roles.GOVERNOR_ROLE);
 
     bytes4[] memory keeperSelectors = new bytes4[](2);
diff --git a/tests/mock/MockOdosRouter.sol b/tests/mock/MockSwapRouter.sol
similarity index 97%
rename from tests/mock/MockOdosRouter.sol
rename to tests/mock/MockSwapRouter.sol
index f71e78e..2118141 100644
--- a/tests/mock/MockOdosRouter.sol
+++ b/tests/mock/MockSwapRouter.sol
@@ -7,7 +7,7 @@ import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
 import "../../contracts/utils/Constants.sol";
 import "../../contracts/utils/Errors.sol";
 
-contract MockOdosRouter {
+contract MockSwapRouter {
   using SafeERC20 for IERC20;
 
   bool public setRevert;
diff --git a/tests/units/Layout.t.sol b/tests/units/Layout.t.sol
index decfdc4..d61828d 100644
--- a/tests/units/Layout.t.sol
+++ b/tests/units/Layout.t.sol
@@ -24,6 +24,20 @@ contract Test_Layout is Fixture {
     layout = Layout(address(parallelizer));
   }
 
+  /// @dev Read before `_etch()` replaces the diamond's code, kept in storage so `test_Layout`
+  /// stays within the EVM stack-depth limit
+  uint64 internal _surplusBufferRatio;
+  uint256 internal _lastReleasedAt;
+  uint256 internal _totalShares;
+
+  /// @dev The tail of `ParallelizerStorage`, added after the initial layout was written down
+  function _assertStructTail() internal view {
+    assertEq(layout.surplusBufferRatio(), _surplusBufferRatio);
+    assertEq(layout.lastReleasedAt(), _lastReleasedAt);
+    assertEq(layout.totalShares(), _totalShares);
+    assertEq(layout.swapRouter(), address(bob));
+  }
+
   function test_Layout() public {
     address tokenP = address(parallelizer.tokenP());
     uint8 isRedemptionLive = parallelizer.isPaused(address(0), ActionType.Redeem) ? 0 : 1;
@@ -36,6 +50,11 @@ contract Test_Layout is Fixture {
     hoax(governor);
     parallelizer.toggleTrusted(alice, TrustedType.Seller);
     address accessManager = parallelizer.accessManager();
+    hoax(governor);
+    parallelizer.setSwapRouter(address(bob));
+    _surplusBufferRatio = parallelizer.getSurplusBufferRatio();
+    _lastReleasedAt = parallelizer.getLastReleasedAt();
+    _totalShares = parallelizer.getTotalShares();
     hoax(guardian);
     parallelizer.setDummyImplementation(address(alice));
     address implementation = parallelizer.implementation();
@@ -62,8 +81,7 @@ contract Test_Layout is Fixture {
       uint8 onlyWhitelisted,
       uint216 normalizedStables,
       bytes memory oracleConfig,
-      bytes memory whitelistData,
-      ,
+      bytes memory whitelistData,,
     ) = layout.collaterals(collateralList[0]);
 
     assertEq(isManaged, collateral.isManaged);
@@ -86,12 +104,14 @@ contract Test_Layout is Fixture {
       assertEq(layout.selectors(selectorPosition), selectors[i]);
     }
 
+    _assertStructTail();
+
     assertEq(layout.accessManager(), accessManager);
     assertEq(layout.implementation(), implementation);
   }
 
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-    INTERNAL                                                     
+    INTERNAL
   //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
 
   function _etch() internal {
diff --git a/tests/units/RewardHandlerTest.t.sol b/tests/units/RewardHandlerTest.t.sol
index 03558cc..33276d5 100644
--- a/tests/units/RewardHandlerTest.t.sol
+++ b/tests/units/RewardHandlerTest.t.sol
@@ -6,7 +6,7 @@ import { IERC20 } from "@openzeppelin/contracts/interfaces/IERC20.sol";
 
 import { stdError } from "@forge-std/Test.sol";
 
-import { MockOdosRouter } from "tests/mock/MockOdosRouter.sol";
+import { MockSwapRouter } from "tests/mock/MockSwapRouter.sol";
 import { MockTokenPermit } from "tests/mock/MockTokenPermit.sol";
 
 import "contracts/parallelizer/Storage.sol";
@@ -17,19 +17,18 @@ import "../Fixture.sol";
 contract RewardHandlerTest is Fixture {
   event RewardsSoldFor(address indexed tokenObtained, uint256 balanceUpdate);
 
-  MockOdosRouter odos;
+  MockSwapRouter router;
   IERC20 tokenA;
   IERC20 tokenB;
 
   function setUp() public override {
     super.setUp();
-    odos = MockOdosRouter(ODOS_ROUTER);
-
     tokenA = IERC20(address(new MockTokenPermit("tokenA", "tokenA", 18)));
     tokenB = IERC20(address(new MockTokenPermit("tokenA", "tokenA", 9)));
 
-    MockOdosRouter tempRouter = new MockOdosRouter();
-    vm.etch(address(odos), address(tempRouter).code);
+    router = new MockSwapRouter();
+    hoax(governor);
+    parallelizer.setSwapRouter(address(router));
   }
 
   function test_RevertWhen_SellRewards_NotTrusted() public {
@@ -42,7 +41,7 @@ contract RewardHandlerTest is Fixture {
   function test_RevertWhen_SellRewards_NoApproval() public {
     vm.startPrank(guardian);
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
     vm.expectRevert();
     parallelizer.sellRewards(0, payload);
     vm.stopPrank();
@@ -50,12 +49,12 @@ contract RewardHandlerTest is Fixture {
 
   function test_RevertWhen_SellRewards_NoIncrease() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
     vm.startPrank(governor);
 
     deal(address(tokenA), address(parallelizer), 100);
-    deal(address(tokenB), address(odos), 100);
-    parallelizer.changeAllowance(tokenA, address(odos), 100);
+    deal(address(tokenB), address(router), 100);
+    parallelizer.changeAllowance(tokenA, address(router), 100);
     vm.expectRevert(Errors.InvalidSwap.selector);
     parallelizer.sellRewards(0, payload);
     vm.stopPrank();
@@ -63,12 +62,12 @@ contract RewardHandlerTest is Fixture {
 
   function test_RevertWhen_SellRewards_TooSmallAmountOut() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(eurA));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(eurA));
     vm.startPrank(governor);
 
     deal(address(tokenA), address(parallelizer), 100);
-    deal(address(eurA), address(odos), 100);
-    parallelizer.changeAllowance(tokenA, address(odos), 100);
+    deal(address(eurA), address(router), 100);
+    parallelizer.changeAllowance(tokenA, address(router), 100);
     vm.expectRevert(Errors.TooSmallAmountOut.selector);
     parallelizer.sellRewards(1000, payload);
     vm.stopPrank();
@@ -76,39 +75,39 @@ contract RewardHandlerTest is Fixture {
 
   function test_RevertWhen_SellRewards_EmptyErrorMessage() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
     vm.startPrank(governor);
 
     deal(address(tokenA), address(parallelizer), 100);
-    deal(address(tokenB), address(odos), 100);
-    parallelizer.changeAllowance(tokenA, address(odos), 100);
-    odos.setRevertStatuses(true, false);
-    vm.expectRevert(Errors.OdosSwapFailed.selector);
+    deal(address(tokenB), address(router), 100);
+    parallelizer.changeAllowance(tokenA, address(router), 100);
+    router.setRevertStatuses(true, false);
+    vm.expectRevert(Errors.RewardSwapFailed.selector);
     parallelizer.sellRewards(0, payload);
     vm.stopPrank();
   }
 
   function test_RevertWhen_SellRewards_ErrorMessage() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(tokenB));
     vm.startPrank(governor);
 
     deal(address(tokenA), address(parallelizer), 100);
-    deal(address(tokenB), address(odos), 100);
-    parallelizer.changeAllowance(tokenA, address(odos), 100);
-    odos.setRevertStatuses(false, true);
+    deal(address(tokenB), address(router), 100);
+    parallelizer.changeAllowance(tokenA, address(router), 100);
+    router.setRevertStatuses(false, true);
     vm.expectRevert("wrong swap");
     parallelizer.sellRewards(0, payload);
     vm.stopPrank();
   }
 
   function test_RevertWhen_SellRewards_InvalidSwapBecauseTokenSold() public {
-    bytes memory payload = abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(eurA), address(eurB));
+    bytes memory payload = abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(eurA), address(eurB));
     vm.startPrank(governor);
 
     deal(address(eurA), address(parallelizer), 100);
-    deal(address(eurB), address(odos), 100);
-    parallelizer.changeAllowance(eurA, address(odos), 100);
+    deal(address(eurB), address(router), 100);
+    parallelizer.changeAllowance(eurA, address(router), 100);
     vm.expectRevert(Errors.InvalidSwap.selector);
     parallelizer.sellRewards(0, payload);
     vm.stopPrank();
@@ -116,12 +115,12 @@ contract RewardHandlerTest is Fixture {
 
   function test_SellRewards_WithOneTokenIncrease() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(eurA));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(eurA));
     vm.startPrank(governor);
 
     deal(address(tokenA), address(parallelizer), 100);
-    deal(address(eurA), address(odos), 100);
-    parallelizer.changeAllowance(tokenA, address(odos), 100);
+    deal(address(eurA), address(router), 100);
+    parallelizer.changeAllowance(tokenA, address(router), 100);
     vm.expectEmit(address(parallelizer));
     emit RewardsSoldFor(address(eurA), 100);
     parallelizer.sellRewards(0, payload);
@@ -130,12 +129,12 @@ contract RewardHandlerTest is Fixture {
 
   function test_RevertWhen_SellRewards_TokenPSold() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenP), address(eurA));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenP), address(eurA));
     vm.startPrank(governor);
 
     deal(address(tokenP), address(parallelizer), 100);
-    deal(address(eurA), address(odos), 100);
-    parallelizer.changeAllowance(IERC20(address(tokenP)), address(odos), 100);
+    deal(address(eurA), address(router), 100);
+    parallelizer.changeAllowance(IERC20(address(tokenP)), address(router), 100);
     vm.expectRevert(Errors.InvalidTokens.selector);
     parallelizer.sellRewards(0, payload);
     vm.stopPrank();
@@ -143,14 +142,14 @@ contract RewardHandlerTest is Fixture {
 
   function test_SellRewards_WithOneTokenIncreaseAndTrusted() public {
     bytes memory payload =
-      abi.encodeWithSelector(MockOdosRouter.swap.selector, 100, 100, address(tokenA), address(eurA));
+      abi.encodeWithSelector(MockSwapRouter.swap.selector, 100, 100, address(tokenA), address(eurA));
     vm.startPrank(governor);
     parallelizer.toggleTrusted(alice, TrustedType.Seller);
-    parallelizer.changeAllowance(tokenA, address(odos), 100);
+    parallelizer.changeAllowance(tokenA, address(router), 100);
     vm.stopPrank();
 
     deal(address(tokenA), address(parallelizer), 100);
-    deal(address(eurA), address(odos), 100);
+    deal(address(eurA), address(router), 100);
 
     vm.expectEmit(address(parallelizer));
     emit RewardsSoldFor(address(eurA), 100);
@@ -158,3 +157,38 @@ contract RewardHandlerTest is Fixture {
     parallelizer.sellRewards(0, payload);
   }
 }
+
+contract Test_SwapRouter is Fixture {
+  event SwapRouterUpdated(address indexed swapRouter);
+
+  function test_SetSwapRouter_UpdatesTheLiveRouter() public {
+    assertEq(parallelizer.getSwapRouter(), address(0), "no router before governance sets one");
+
+    vm.expectEmit(address(parallelizer));
+    emit SwapRouterUpdated(bob);
+    hoax(governor);
+    parallelizer.setSwapRouter(bob);
+
+    assertEq(parallelizer.getSwapRouter(), bob);
+  }
+
+  function test_RevertWhen_SetSwapRouterIsZero() public {
+    hoax(governor);
+    vm.expectRevert(Errors.ZeroAddress.selector);
+    parallelizer.setSwapRouter(address(0));
+  }
+
+  function test_RevertWhen_SetSwapRouterNotGovernor() public {
+    hoax(guardian);
+    vm.expectRevert(abi.encodeWithSelector(Errors.AccessManagedUnauthorized.selector, guardian));
+    parallelizer.setSwapRouter(bob);
+  }
+
+  /// @dev A raw call to address zero would report success and leave the swap silently unperformed
+  function test_RevertWhen_SellRewardsBeforeARouterIsSet() public {
+    bytes memory payload;
+    hoax(governor);
+    vm.expectRevert(Errors.ZeroAddress.selector);
+    parallelizer.sellRewards(0, payload);
+  }
+}
diff --git a/tests/utils/ConfigAccessManager.sol b/tests/utils/ConfigAccessManager.sol
index 3fa285e..8359831 100644
--- a/tests/utils/ConfigAccessManager.sol
+++ b/tests/utils/ConfigAccessManager.sol
@@ -99,7 +99,7 @@ abstract contract ConfigAccessManager is Helper {
   }
 
   function getParallelizerGovernorSelectorAccess() internal pure returns (bytes4[] memory) {
-    bytes4[] memory selectors = new bytes4[](14);
+    bytes4[] memory selectors = new bytes4[](15);
     selectors[0] = SettersGovernor.recoverERC20.selector;
     selectors[1] = SettersGovernor.setAccessManager.selector;
     selectors[2] = SettersGovernor.setCollateralManager.selector;
@@ -114,6 +114,7 @@ abstract contract ConfigAccessManager is Helper {
     selectors[11] = SettersGovernor.updatePayees.selector;
     selectors[12] = SettersGovernor.updateSlippageTolerance.selector;
     selectors[13] = SettersGovernor.updateSurplusBufferRatio.selector;
+    selectors[14] = SettersGovernor.setSwapRouter.selector;
     return selectors;
   }
 

From bf2508607c58b6f1e1faffb66b8fa8237d421587 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Tue, 8 Sep 2026 10:31:13 +0300
Subject: [PATCH 18/28] test(redeemer): measure the donation attack and what
 actually starves it

Bailsec Core Issue_10 records the remediation as smoothing the redemption curve
to prevent profitability. The curve live on all five chains is indeed shallow:

  collateral ratio  75%    85%    95%    97%
  payout factor     99.5%  95%    95%    99.5%

A 4.5 point band, against the 40 point swing the finding illustrates. It raises
the bar without closing it. Against those exact parameters, with a second holder
present so the transfer is visible and a correctly priced donation asset:

  attacker share    25%     30%     35%     40%     50%
  net result       -444    -133    +178    +489   +1111

Break-even sits between 30% and 35% of supply. At 50% the attacker gains 1111
while the other holder loses 1106, so it is a transfer, not an artefact. No
overvalued collateral is needed, unlike the finding's illustration.

What decides profitability is not that a deterrent exists but how steeply it
climbs back. The attacker pays in ratio points and is repaid in payout points on
their own redemption, recovering the share `f` they still hold a claim on, so a
ramp starves the attack when its slope stays below (1 - f) / (f * H/S). Holding
the same 4.5 point deterrent and widening the band:

  slope            0.900   0.450   0.225   0.112
  attacker at 50%   loses   loses   loses   loses
  attacker at 90%   GAINS   GAINS   GAINS   loses

Measured thresholds match the formula: about 1.05 against half the supply, about
0.12 against ninety percent. The deployed curve sits at 2.25.

So the deterrent does not have to be given up. Ramping the same 4.5 points from a
60% ratio up to 100% lands at slope 0.112 and starves the attack even against a
holder of ninety percent of the supply, while removing the current shape's oddity
of paying its best rate at the deepest undercollateralization.

Flattening also works, and `y[last]` prices every redemption above a 100% ratio,
so it has to flatten at 99.5%: flattening at 95% would cost healthy redeemers
4.52% instead of 0.5%.

Bounds are asserted rather than only printed, so changing the curve fails these
tests and forces the trade-off to be re-measured.
---
 .../units/DonationRedemptionCoefficient.t.sol | 324 ++++++++++++++++++
 1 file changed, 324 insertions(+)
 create mode 100644 tests/units/DonationRedemptionCoefficient.t.sol

diff --git a/tests/units/DonationRedemptionCoefficient.t.sol b/tests/units/DonationRedemptionCoefficient.t.sol
new file mode 100644
index 0000000..7a8082d
--- /dev/null
+++ b/tests/units/DonationRedemptionCoefficient.t.sol
@@ -0,0 +1,324 @@
+// SPDX-License-Identifier: BUSL-1.1
+
+pragma solidity 0.8.28;
+
+import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+import { IERC20Metadata } from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
+import { console } from "@forge-std/console.sol";
+
+import { MockChainlinkOracle } from "../mock/MockChainlinkOracle.sol";
+import { Fixture } from "../Fixture.sol";
+import "contracts/utils/Constants.sol";
+
+/// @notice Bailsec Core Issue_10. A donation lifts the reported collateral ratio without lifting
+/// tracked issuance, so it can buy a better redemption coefficient. Measured against the redemption
+/// curve live on all five chains, with a second holder present so the transfer of value is visible.
+contract Test_DonationRedemptionCoefficient is Fixture {
+  /// @dev The curve deployed on mainnet, sonic, base, avalanche and hyperevm
+  function _setLiveRedemptionCurve() internal {
+    uint64[] memory x = new uint64[](4);
+    x[0] = 750_000_000;
+    x[1] = 850_000_000;
+    x[2] = 950_000_000;
+    x[3] = 970_000_000;
+    int64[] memory y = new int64[](4);
+    y[0] = 995_000_000;
+    y[1] = 950_000_000;
+    y[2] = 950_000_000;
+    y[3] = 995_000_000;
+    hoax(guardian);
+    parallelizer.setRedemptionCurveParams(x, y);
+  }
+
+  function setUp() public override {
+    super.setUp();
+    _setLiveRedemptionCurve();
+    // alice attacks, bob is the holder she would be extracting from. Splitting the position by
+    // transfer rather than a second mint keeps the exposure fee curve out of the measurement
+    _mintExactInput(alice, address(eurA), 100_000 * BASE_6, 0);
+    _setRatioTo(950_000_000);
+  }
+
+  /// @dev Calibrates the eurA oracle so the reported ratio lands on `target`, rather than assuming
+  /// what the fixture's mints issued
+  function _setRatioTo(uint64 target) internal {
+    uint256 issued = parallelizer.getTotalIssued();
+    uint256 balance = IERC20(address(eurA)).balanceOf(address(parallelizer));
+    uint8 dec = IERC20Metadata(address(eurA)).decimals();
+    // answer is 8 decimals, balance carries `dec`, issued and target are 18 and 9 decimals
+    uint256 answer = (uint256(target) * issued * (10 ** dec) * BASE_8) / (BASE_9 * balance * BASE_18);
+    MockChainlinkOracle(address(oracleA)).setLatestAnswer(int256(answer));
+  }
+
+  function _valueOf(address token, uint256 amount) internal view returns (uint256) {
+    (,,,, uint256 oracleValue) = parallelizer.getOracleValues(token);
+    return (oracleValue * amount) / (10 ** IERC20Metadata(token).decimals());
+  }
+
+  /// @dev Oracle value of the collateral `who` holds outside the Parallelizer
+  function _walletValue(address who) internal view returns (uint256 total) {
+    address[] memory list = parallelizer.getCollateralList();
+    for (uint256 i; i < list.length; ++i) {
+      total += _valueOf(list[i], IERC20(list[i]).balanceOf(who));
+    }
+  }
+
+  /// @dev Oracle value `who` would get by redeeming everything they still hold
+  function _claimValue(address who) internal view returns (uint256 total) {
+    uint256 bal = tokenP.balanceOf(who);
+    if (bal == 0) return 0;
+    // the quote refuses to price the entire remaining issuance
+    if (bal >= parallelizer.getTotalIssued()) bal = parallelizer.getTotalIssued() - 1;
+    (address[] memory tokens, uint256[] memory amounts) = parallelizer.quoteRedemptionCurve(bal);
+    for (uint256 i; i < tokens.length; ++i) {
+      total += _valueOf(tokens[i], amounts[i]);
+    }
+  }
+
+  function _redeem(address who, uint256 amount) internal {
+    (address[] memory tokens,) = parallelizer.quoteRedemptionCurve(amount);
+    uint256[] memory minOuts = new uint256[](tokens.length);
+    vm.prank(who);
+    parallelizer.redeem(amount, who, block.timestamp + 1 days, minOuts, keccak256(abi.encodePacked(tokens)));
+  }
+
+  /// @dev Alice's total position after the run, and what bob is left holding
+  function _run(uint256 redeemAmount, uint256 donation) internal returns (uint256 aliceNet, uint256 bobClaim) {
+    uint256 cost;
+    if (donation > 0) {
+      deal(address(eurB), alice, donation);
+      cost = _valueOf(address(eurB), donation);
+      vm.prank(alice);
+      IERC20(address(eurB)).transfer(address(parallelizer), donation);
+    }
+    _redeem(alice, redeemAmount);
+    aliceNet = _walletValue(alice) + _claimValue(alice) - cost;
+    bobClaim = _claimValue(bob);
+  }
+
+  /// @dev A curve with no upward segment: the reported ratio no longer prices the redemption, so a
+  /// donation has nothing to buy. `level` sets how much of a run deterrent is kept.
+  function _setFlatRedemptionCurve(int64 level) internal {
+    uint64[] memory x = new uint64[](2);
+    x[0] = 0;
+    x[1] = 1_000_000_000;
+    int64[] memory y = new int64[](2);
+    y[0] = level;
+    y[1] = level;
+    hoax(guardian);
+    parallelizer.setRedemptionCurveParams(x, y);
+  }
+
+  function _attackerNet(uint256 donation) internal returns (int256) {
+    _splitSupply(50);
+    uint256 amount = tokenP.balanceOf(alice);
+    uint256 inner = vm.snapshotState();
+    (uint256 baseAlice,) = _run(amount, 0);
+    vm.revertToState(inner);
+    (uint256 a,) = _run(amount, donation);
+    vm.revertToState(inner);
+    return int256(a) - int256(baseAlice);
+  }
+
+  /// @dev Flattening removes the profit at any level, so the level is free to serve the run
+  /// deterrent rather than the donation defence
+  function test_FlatCurve_RemovesTheDonationProfit() public {
+    uint256 donation = 2000e12;
+
+    int256 live = _attackerNet(donation);
+    console.log("live curve  (99.5 / 95 / 95 / 99.5)");
+    _log(live);
+
+    _setFlatRedemptionCurve(995_000_000);
+    int256 flatHigh = _attackerNet(donation);
+    console.log("flat at 99.5%, no deterrent kept");
+    _log(flatHigh);
+
+    _setFlatRedemptionCurve(950_000_000);
+    int256 flatLow = _attackerNet(donation);
+    console.log("flat at 95%, 5 point deterrent kept");
+    _log(flatLow);
+
+    assertGt(live, int256(0), "the deployed curve is exploitable at this share");
+    assertLt(flatHigh, int256(0), "flattening high must remove the profit");
+    assertLt(flatLow, int256(0), "flattening low must remove the profit");
+  }
+
+  /// @dev `y[last]` also prices every redemption above a 100% ratio, so flattening the curve at a
+  /// lower level would raise the fee paid in normal conditions
+  function test_FlatLevel_AlsoPricesHealthyRedemptions() public {
+    _setRatioTo(1_100_000_000);
+    _splitSupply(50);
+    uint256 amount = tokenP.balanceOf(alice);
+
+    uint256 snap = vm.snapshotState();
+    _setFlatRedemptionCurve(995_000_000);
+    _redeem(alice, amount);
+    uint256 at995 = _walletValue(alice);
+    vm.revertToState(snap);
+
+    _setFlatRedemptionCurve(950_000_000);
+    _redeem(alice, amount);
+    uint256 at950 = _walletValue(alice);
+    vm.revertToState(snap);
+
+    console.log("healthy redemption at a 110% ratio");
+    console.log("  proceeds with y[last] = 99.5%", at995);
+    console.log("  proceeds with y[last] = 95%  ", at950);
+    console.log("  cost of flattening low       ", at995 - at950);
+    assertGt(at995, at950, "a lower flat level taxes healthy redemptions");
+  }
+
+  /// @dev Same 4.5 point deterrent, ramping back to `y[last]` from `rampStart` up to a 100% ratio.
+  /// The attacker pays in ratio points and is paid in payout points, so the slope of that ramp is
+  /// what decides profitability, not whether a deterrent exists.
+  function _setRampedCurve(uint64 rampStart) internal {
+    uint64[] memory x = new uint64[](3);
+    x[0] = 0;
+    x[1] = rampStart;
+    x[2] = 1_000_000_000;
+    int64[] memory y = new int64[](3);
+    y[0] = 950_000_000;
+    y[1] = 950_000_000;
+    y[2] = 995_000_000;
+    hoax(guardian);
+    parallelizer.setRedemptionCurveParams(x, y);
+  }
+
+  function _attackerNetAtShare(uint256 sharePct, uint256 donation) internal returns (int256) {
+    _splitSupply(100 - sharePct);
+    uint256 amount = tokenP.balanceOf(alice);
+    uint256 inner = vm.snapshotState();
+    (uint256 baseAlice,) = _run(amount, 0);
+    vm.revertToState(inner);
+    (uint256 a,) = _run(amount, donation);
+    vm.revertToState(inner);
+    return int256(a) - int256(baseAlice);
+  }
+
+  /// @dev A gentle enough ramp keeps the deterrent and still starves the attack, including against
+  /// a holder large enough to recover most of their own donation
+  function test_RampSlope_DecidesProfitability() public {
+    uint256 donation = 2000e12;
+    uint64[4] memory rampStarts = [uint64(950_000_000), 900_000_000, 800_000_000, 600_000_000];
+    uint256[2] memory shares = [uint256(50), 90];
+
+    console.log("4.5 payout points ramping up to a 100% ratio, over a widening band");
+    for (uint256 i; i < rampStarts.length; ++i) {
+      uint256 width = 1_000_000_000 - rampStarts[i];
+      console.log("  ramp starts at (1e9)", rampStarts[i]);
+      console.log("    slope x1000", (uint256(45_000_000) * 1000) / width);
+      for (uint256 j; j < shares.length; ++j) {
+        uint256 snap = vm.snapshotState();
+        _setRampedCurve(rampStarts[i]);
+        int256 net = _attackerNetAtShare(shares[j], donation);
+        vm.revertToState(snap);
+        console.log("      attacker share pct", shares[j]);
+        _log(net);
+
+        // The attacker pays `d` in ratio points and is repaid `slope * d` in payout points on their
+        // own redemption, while recovering the share `f` of the donation they still have a claim
+        // on. So a ramp starves the attack when slope < (1 - f) / (f * H/S). At half the supply
+        // that threshold is about 1.05, at ninety percent about 0.12.
+        uint256 threshold = shares[j] == 50 ? 1053 : 117;
+        if ((uint256(45_000_000) * 1000) / width < threshold) {
+          assertLt(net, int256(0), "a ramp below the threshold must not pay");
+        } else {
+          assertGt(net, int256(0), "a ramp above the threshold still pays");
+        }
+      }
+    }
+  }
+
+  function _log(int256 net) internal pure {
+    if (net > 0) console.log("    attacker GAINS", uint256(net));
+    else console.log("    attacker LOSES", uint256(-net));
+  }
+
+  /// @dev Moves `pct` of the supply to bob, leaving alice with the rest
+  function _splitSupply(uint256 pctToBob) internal {
+    uint256 send = (tokenP.balanceOf(alice) * pctToBob) / 100;
+    vm.prank(alice);
+    IERC20(address(tokenP)).transfer(bob, send);
+  }
+
+  /// @dev Donation sized to walk the ratio from 95% up onto the 97% shoulder of the curve
+  function test_Measure_ProfitabilityByAttackerShare() public {
+    uint256[5] memory attackerPct = [uint256(25), 30, 35, 40, 50];
+    uint256 donation = 2000e12;
+
+    console.log("attacker share -> net result, donating 2000 of correctly priced collateral");
+    for (uint256 i; i < attackerPct.length; ++i) {
+      uint256 snap = vm.snapshotState();
+      _splitSupply(100 - attackerPct[i]);
+      uint256 amount = tokenP.balanceOf(alice);
+
+      uint256 inner = vm.snapshotState();
+      (uint256 baseAlice,) = _run(amount, 0);
+      vm.revertToState(inner);
+      (uint256 a, uint256 b) = _run(amount, donation);
+      uint256 baseBob;
+      {
+        vm.revertToState(inner);
+        (, baseBob) = _run(amount, 0);
+      }
+      vm.revertToState(snap);
+
+      console.log("  attacker holds pct", attackerPct[i]);
+      if (a > baseAlice) console.log("    attacker GAINS", a - baseAlice);
+      else console.log("    attacker LOSES", baseAlice - a);
+      if (b < baseBob) console.log("    others   LOSE ", baseBob - b);
+      else console.log("    others   gain ", b - baseBob);
+
+      // Break-even sits between 30% and 35% of the supply on the deployed curve. These bounds are
+      // the documented exposure: widening the curve's upward segment would move them, and this
+      // test is meant to fail so the trade-off gets re-measured.
+      if (attackerPct[i] <= 30) assertLt(a, baseAlice, "attack should not pay at this share");
+      if (attackerPct[i] >= 35) assertGt(a, baseAlice, "attack should still pay at this share");
+    }
+  }
+
+  function test_Measure_DonationTransfersValueFromOtherHolders() public {
+    _splitSupply(50);
+    uint256 startingAlice = tokenP.balanceOf(alice);
+    uint256[3] memory donations = [uint256(500e12), 2000e12, 5000e12];
+
+    uint256 snap = vm.snapshotState();
+    (uint256 baseAlice, uint256 baseBob) = _run(startingAlice, 0);
+    vm.revertToState(snap);
+    require(tokenP.balanceOf(alice) == startingAlice, "snapshot did not restore");
+
+    (uint64 crStart,) = parallelizer.getCollateralRatio();
+    console.log("starting collateral ratio (1e9)", crStart);
+    console.log("baseline, no donation");
+    console.log("  alice net position", baseAlice);
+    console.log("  bob   claim value", baseBob);
+
+    for (uint256 i; i < donations.length; ++i) {
+      snap = vm.snapshotState();
+      deal(address(eurB), alice, donations[i]);
+      vm.prank(alice);
+      IERC20(address(eurB)).transfer(address(parallelizer), donations[i]);
+      (uint64 crAfter,) = parallelizer.getCollateralRatio();
+      vm.revertToState(snap);
+
+      snap = vm.snapshotState();
+      (uint256 a, uint256 b) = _run(startingAlice, donations[i]);
+      uint256 eurBBack = IERC20(address(eurB)).balanceOf(alice);
+      vm.revertToState(snap);
+      require(tokenP.balanceOf(alice) == startingAlice, "snapshot did not restore");
+
+      console.log("donation oracle value", _valueOfStatic(donations[i]));
+      console.log("  ratio moves to (1e9)", crAfter);
+      console.log("  eurB returned to alice (oracle value)", _valueOfStatic(eurBBack));
+      if (a > baseAlice) console.log("  alice GAINS", a - baseAlice);
+      else console.log("  alice LOSES", baseAlice - a);
+      if (b < baseBob) console.log("  bob   LOSES", baseBob - b);
+      else console.log("  bob   gains", b - baseBob);
+    }
+  }
+
+  function _valueOfStatic(uint256 amount) internal view returns (uint256) {
+    return _valueOf(address(eurB), amount);
+  }
+}

From 6e12402349b197d4e4868c0ba6a8fadaeeb4e17c Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Tue, 8 Sep 2026 12:03:01 +0300
Subject: [PATCH 19/28] fix(redeemer): ramp the redemption curve out of
 donation range

The deployed curve returned to 99.5% over two ratio points, a slope of 2.25. An
attacker pays in ratio points and is repaid in payout points on their own
redemption while recovering the share they still hold a claim on, so a donation
pays whenever that slope exceeds (1 - f) / (f * H/S): about 1.05 against half the
supply, about 0.12 against ninety percent.

  x  75%    85%    95%    97%          ->   0      60%    100%
  y  99.5%  95%    95%    99.5%        ->   95%    95%    99.5%

The same 4.5 point deterrent now spans a 60% to 100% band, a slope of 0.112,
under the threshold even for a holder of ninety percent of the supply. `y[last]`
stays at 99.5% because it also prices every redemption above a 100% ratio.

Ramping monotonically also drops the previous shape's oddity of paying its best
rate at the deepest undercollateralization.

Carried in the six deploy configs for fresh deployments, and in
`SetRedemptionCurve.s.sol` for the five live ones, one run per chain.

Bailsec Core Issue_10
---
 deploy/config/avalanche/config.json |  4 ++--
 deploy/config/base/config.json      |  4 ++--
 deploy/config/hyperevm/config.json  |  4 ++--
 deploy/config/mainnet/config.json   |  4 ++--
 deploy/config/sepolia/config.json   |  4 ++--
 deploy/config/sonic/config.json     |  4 ++--
 scripts/SetRedemptionCurve.s.sol    | 37 +++++++++++++++++++++++++++++
 7 files changed, 49 insertions(+), 12 deletions(-)
 create mode 100644 scripts/SetRedemptionCurve.s.sol

diff --git a/deploy/config/avalanche/config.json b/deploy/config/avalanche/config.json
index 3594b30..1a0b34d 100644
--- a/deploy/config/avalanche/config.json
+++ b/deploy/config/avalanche/config.json
@@ -48,8 +48,8 @@
         }
       ],
       "redemptionSetup": {
-        "xRedeemFee": [750000000, 850000000, 950000000, 970000000],
-        "yRedeemFee": [995000000, 950000000, 950000000, 995000000]
+        "xRedeemFee": [0, 600000000, 1000000000],
+        "yRedeemFee": [950000000, 950000000, 995000000]
       }
     }
   },
diff --git a/deploy/config/base/config.json b/deploy/config/base/config.json
index beb60e7..3bae2fc 100644
--- a/deploy/config/base/config.json
+++ b/deploy/config/base/config.json
@@ -48,8 +48,8 @@
         }
       ],
       "redemptionSetup": {
-        "xRedeemFee": [750000000, 850000000, 950000000, 970000000],
-        "yRedeemFee": [995000000, 950000000, 950000000, 995000000]
+        "xRedeemFee": [0, 600000000, 1000000000],
+        "yRedeemFee": [950000000, 950000000, 995000000]
       }
     }
   },
diff --git a/deploy/config/hyperevm/config.json b/deploy/config/hyperevm/config.json
index e98b3dc..2ff7831 100644
--- a/deploy/config/hyperevm/config.json
+++ b/deploy/config/hyperevm/config.json
@@ -51,8 +51,8 @@
         }
       ],
       "redemptionSetup": {
-        "xRedeemFee": [750000000, 850000000, 950000000, 970000000],
-        "yRedeemFee": [995000000, 950000000, 950000000, 995000000]
+        "xRedeemFee": [0, 600000000, 1000000000],
+        "yRedeemFee": [950000000, 950000000, 995000000]
       }
     }
   },
diff --git a/deploy/config/mainnet/config.json b/deploy/config/mainnet/config.json
index 236a4ff..b47a24b 100644
--- a/deploy/config/mainnet/config.json
+++ b/deploy/config/mainnet/config.json
@@ -88,8 +88,8 @@
         }
       ],
       "redemptionSetup": {
-        "xRedeemFee": [750000000, 850000000, 950000000, 970000000],
-        "yRedeemFee": [995000000, 950000000, 950000000, 995000000]
+        "xRedeemFee": [0, 600000000, 1000000000],
+        "yRedeemFee": [950000000, 950000000, 995000000]
       }
     }
   },
diff --git a/deploy/config/sepolia/config.json b/deploy/config/sepolia/config.json
index e5c071c..2cb18d0 100644
--- a/deploy/config/sepolia/config.json
+++ b/deploy/config/sepolia/config.json
@@ -31,8 +31,8 @@
         }
       ],
       "redemptionSetup": {
-        "xRedeemFee": [750000000, 850000000, 950000000, 970000000],
-        "yRedeemFee": [995000000, 950000000, 950000000, 995000000]
+        "xRedeemFee": [0, 600000000, 1000000000],
+        "yRedeemFee": [950000000, 950000000, 995000000]
       }
     }
   },
diff --git a/deploy/config/sonic/config.json b/deploy/config/sonic/config.json
index 4a2a45c..03709ce 100644
--- a/deploy/config/sonic/config.json
+++ b/deploy/config/sonic/config.json
@@ -88,8 +88,8 @@
         }
       ],
       "redemptionSetup": {
-        "xRedeemFee": [750000000, 850000000, 950000000, 970000000],
-        "yRedeemFee": [995000000, 950000000, 950000000, 995000000]
+        "xRedeemFee": [0, 600000000, 1000000000],
+        "yRedeemFee": [950000000, 950000000, 995000000]
       }
     }
   },
diff --git a/scripts/SetRedemptionCurve.s.sol b/scripts/SetRedemptionCurve.s.sol
new file mode 100644
index 0000000..8d7de72
--- /dev/null
+++ b/scripts/SetRedemptionCurve.s.sol
@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.28;
+
+import "./Base.s.sol";
+
+import { ISettersGuardian } from "contracts/interfaces/ISetters.sol";
+
+/// @notice Replaces the redemption curve with a ramp gentle enough that a donation cannot pay for
+/// the coefficient it buys. Bailsec Core Issue_10.
+///
+/// The previous curve returned to 99.5% over two ratio points, a slope of 2.25. An attacker pays in
+/// ratio points and is repaid in payout points on their own redemption, while recovering the share
+/// `f` they still hold a claim on, so the attack pays whenever the slope exceeds
+/// (1 - f) / (f * H/S): about 1.05 against half the supply, about 0.12 against ninety percent.
+///
+/// The same 4.5 point deterrent now spans a 60% to 100% ratio band, a slope of 0.112, which stays
+/// under the threshold even for a holder of ninety percent of the supply. Ramping monotonically also
+/// drops the old shape's oddity of paying its best rate at the deepest undercollateralization.
+///
+/// Run once per chain, against that chain's Parallelizer.
+contract SetRedemptionCurve is BaseScript {
+  address internal constant PARALLELIZER = 0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2;
+
+  function run() public broadcast {
+    uint64[] memory xFee = new uint64[](3);
+    xFee[0] = 0;
+    xFee[1] = 600_000_000; // 60% collateral ratio
+    xFee[2] = 1_000_000_000; // 100% collateral ratio
+
+    int64[] memory yFee = new int64[](3);
+    yFee[0] = 950_000_000; // 95% payout, the deterrent floor
+    yFee[1] = 950_000_000;
+    yFee[2] = 995_000_000; // 99.5%, also the fee every healthy redemption pays
+
+    ISettersGuardian(PARALLELIZER).setRedemptionCurveParams(xFee, yFee);
+  }
+}

From ec5f1dffb0b513168132f687a6d4570362fc0189 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Tue, 8 Sep 2026 13:25:34 +0300
Subject: [PATCH 20/28] fix(oracle): move the deviation tolerance onto the burn
 side

Bailsec Core Issue_22 asks that fees be set so `userDeviation` cannot be
exploited. Reading the code, the finding points instead at a live configuration
the contract already refuses to accept.

`userDeviation` replaces a spot inside its band with the target for both mint and
burn. So `readMint` credits a discounted collateral at face value, and because
the snap runs before the burn firewall, the collateral stops contributing any
depeg haircut while it sits inside the band.

`setOracle` already guards this:

  if (userDeviation > burnRatioDeviation) revert InvalidParams();

The invariant is exactly right: while the snap applies the firewall would not
have fired anyway, so the snap can never suppress it. Two mainnet collaterals
violate it, pairing a 5 bps snap band with a zero firewall band, and they predate
the check. `DiamondInitializer` routes through the same `setOracle`, so the
shipped config would no longer deploy.

The tolerance moves to the burn side, matching the two collaterals already
configured that way. Measured, nothing is lost:

                mint pricing                  firewall 4 bps   firewall 20 bps
  before        face value, discount taken    suppressed       suppressed
  after         true spot, discount to minter tolerated        engages

Seven collateral entries across five chains corrected in the deploy configs.
Governance must apply the same change on chain through `setOracle`.
---
 deploy/config/avalanche/config.json |   4 +-
 deploy/config/base/config.json      |   4 +-
 deploy/config/hyperevm/config.json  |   4 +-
 deploy/config/mainnet/config.json   |   8 +--
 deploy/config/sonic/config.json     |   8 +--
 tests/units/UserDeviation.t.sol     | 100 ++++++++++++++++++++++++++++
 6 files changed, 114 insertions(+), 14 deletions(-)
 create mode 100644 tests/units/UserDeviation.t.sol

diff --git a/deploy/config/avalanche/config.json b/deploy/config/avalanche/config.json
index 1a0b34d..43805cd 100644
--- a/deploy/config/avalanche/config.json
+++ b/deploy/config/avalanche/config.json
@@ -20,8 +20,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
diff --git a/deploy/config/base/config.json b/deploy/config/base/config.json
index 3bae2fc..dd632e9 100644
--- a/deploy/config/base/config.json
+++ b/deploy/config/base/config.json
@@ -20,8 +20,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
diff --git a/deploy/config/hyperevm/config.json b/deploy/config/hyperevm/config.json
index 2ff7831..90931c1 100644
--- a/deploy/config/hyperevm/config.json
+++ b/deploy/config/hyperevm/config.json
@@ -20,8 +20,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
diff --git a/deploy/config/mainnet/config.json b/deploy/config/mainnet/config.json
index b47a24b..6d0d0c8 100644
--- a/deploy/config/mainnet/config.json
+++ b/deploy/config/mainnet/config.json
@@ -20,8 +20,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
@@ -57,8 +57,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
diff --git a/deploy/config/sonic/config.json b/deploy/config/sonic/config.json
index 03709ce..d709173 100644
--- a/deploy/config/sonic/config.json
+++ b/deploy/config/sonic/config.json
@@ -20,8 +20,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
@@ -57,8 +57,8 @@
             "circuitChainIsMultiplied": [1],
             "chainlinkDecimals": [8],
             "hyperparameters": {
-              "userDeviation": 500000000000000,
-              "burnRatioDeviation": 0
+              "userDeviation": 0,
+              "burnRatioDeviation": 500000000000000
             }
           },
           "xMintFee": [0],
diff --git a/tests/units/UserDeviation.t.sol b/tests/units/UserDeviation.t.sol
new file mode 100644
index 0000000..9fa944e
--- /dev/null
+++ b/tests/units/UserDeviation.t.sol
@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: BUSL-1.1
+
+pragma solidity 0.8.28;
+
+import { IERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+import { console } from "@forge-std/console.sol";
+
+import { MockChainlinkOracle } from "../mock/MockChainlinkOracle.sol";
+import { Fixture } from "../Fixture.sol";
+import { OracleReadType } from "contracts/parallelizer/Storage.sol";
+import "contracts/utils/Constants.sol";
+import "contracts/utils/Errors.sol" as Errors;
+
+/// @notice Bailsec Core Issue_22. `userDeviation` snaps a spot inside its band up to the target for
+/// both mint and burn, so a collateral bought at a discount mints at face value. The band is also
+/// what keeps ordinary oracle noise from tripping the burn firewall, which is why zeroing it is not
+/// the answer.
+contract Test_UserDeviation is Fixture {
+  function _oracleConfig(
+    address collateral,
+    uint128 userDeviation,
+    uint128 burnRatioDeviation
+  )
+    internal
+    view
+    returns (bytes memory)
+  {
+    (OracleReadType oracleType, OracleReadType targetType, bytes memory oracleData, bytes memory targetData,) =
+      parallelizer.getOracle(collateral);
+    return abi.encode(oracleType, targetType, oracleData, targetData, abi.encode(userDeviation, burnRatioDeviation));
+  }
+
+  function _setDeviations(address collateral, uint128 userDeviation, uint128 burnRatioDeviation) internal {
+    bytes memory config = _oracleConfig(collateral, userDeviation, burnRatioDeviation);
+    hoax(governor);
+    parallelizer.setOracle(collateral, config);
+  }
+
+  /// @dev eurA quoted `bps` basis points under its target
+  function _discountEurA(uint256 bps) internal {
+    MockChainlinkOracle(address(oracleA)).setLatestAnswer(int256((BASE_8 * (10_000 - bps)) / 10_000));
+  }
+
+  function _mintValue(uint256 amountIn) internal returns (uint256 tokenPOut) {
+    deal(address(eurA), alice, amountIn);
+    vm.startPrank(alice);
+    IERC20(address(eurA)).approve(address(parallelizer), amountIn);
+    uint256 before = tokenP.balanceOf(alice);
+    parallelizer.swapExactInput(amountIn, 0, address(eurA), address(tokenP), alice, block.timestamp + 1 days);
+    tokenPOut = tokenP.balanceOf(alice) - before;
+    vm.stopPrank();
+  }
+
+  /// @dev `setOracle` refuses a snap band wider than the firewall band, which is exactly the
+  /// pairing two mainnet collaterals carry today. They predate the check, and `DiamondInitializer`
+  /// routes through the same `setOracle`, so the current config would not deploy.
+  function test_SetOracle_RejectsTheLiveMainnetPairing() public {
+    bytes memory config = _oracleConfig(address(eurA), 5e14, 0);
+    hoax(governor);
+    vm.expectRevert(Errors.InvalidParams.selector);
+    parallelizer.setOracle(address(eurA), config);
+  }
+
+  /// @dev Moving the same tolerance to the burn side prices the mint at the true spot, so the
+  /// discount is no longer captured
+  function test_ToleranceOnTheBurnSide_PricesTheMintCorrectly() public {
+    _setDeviations(address(eurA), 0, 5e14);
+
+    uint256 snap = vm.snapshotState();
+    uint256 atPeg = _mintValue(10_000 * BASE_6);
+    vm.revertToState(snap);
+
+    _discountEurA(4);
+    uint256 discounted = _mintValue(10_000 * BASE_6);
+
+    console.log("userDeviation 0, burnRatioDeviation 5bps");
+    console.log("  tokenP minted at peg            ", atPeg);
+    console.log("  tokenP minted 4 bps under peg   ", discounted);
+    console.log("  shortfall carried by the minter ", atPeg - discounted);
+    assertLt(discounted, atPeg, "the discount must reach the minter, not the protocol");
+    // the shortfall tracks the 4 bps discount rather than being absorbed by the reserve
+    assertApproxEqRel(atPeg - discounted, (atPeg * 4) / 10_000, 0.02e18, "shortfall should track the spot");
+  }
+
+  /// @dev And the burn firewall still tolerates the same noise, so nothing is lost by the move
+  function test_ToleranceOnTheBurnSide_StillAbsorbsOracleNoise() public {
+    _setDeviations(address(eurA), 0, 5e14);
+    _discountEurA(4);
+
+    (,, uint256 ratio,,) = parallelizer.getOracleValues(address(eurA));
+    console.log("burn ratio with a 4 bps depeg, tolerance on the burn side", ratio);
+    assertEq(ratio, BASE_18, "a 4 bps wobble must not haircut every burn");
+
+    // past the band the firewall engages as intended
+    _discountEurA(20);
+    (,, ratio,,) = parallelizer.getOracleValues(address(eurA));
+    console.log("burn ratio with a 20 bps depeg", ratio);
+    assertLt(ratio, BASE_18, "a real depeg must still haircut burns");
+  }
+}

From 7648a26bf1915e3dda8dc73317715be9f8deb23c Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Tue, 8 Sep 2026 15:11:57 +0300
Subject: [PATCH 21/28] fix(surplus): reject the Parallelizer itself as a payee

`_addPayee` validated only that the share was non-zero. The Parallelizer holds
the income being distributed, so a share allocated to itself is handed straight
back to `release` as fresh income on the next call, redistributing itself.

`address(0)` deliberately stays valid. `LibSurplus._release` treats it as the
sentinel for burning that share, and the live surplus policy uses it. An earlier
draft rejected both and broke the surplus tests, which is how the sentinel
surfaced.

Bailsec Core Issue_19
---
 .../parallelizer/libraries/LibSetters.sol     |  4 +++
 contracts/utils/Errors.sol                    |  1 +
 tests/units/Setters.t.sol                     | 26 +++++++++++++++++++
 3 files changed, 31 insertions(+)

diff --git a/contracts/parallelizer/libraries/LibSetters.sol b/contracts/parallelizer/libraries/LibSetters.sol
index 7de70b5..8154ad6 100644
--- a/contracts/parallelizer/libraries/LibSetters.sol
+++ b/contracts/parallelizer/libraries/LibSetters.sol
@@ -382,6 +382,10 @@ library LibSetters {
   /// @param _shares The number of shares assigned to the fee receiver.
   function _addPayee(address _payee, uint256 _shares) internal returns (uint256) {
     if (_shares == 0) revert ZeroAmount();
+    // The Parallelizer holds the income being distributed, so a share allocated to itself is handed
+    // back to `release` as fresh income on the next call. `address(0)` stays valid: `LibSurplus`
+    // treats it as the sentinel for burning that share.
+    if (_payee == address(this)) revert InvalidPayee();
     ParallelizerStorage storage ts = s.transmuterStorage();
 
     ts.payees.push(_payee);
diff --git a/contracts/utils/Errors.sol b/contracts/utils/Errors.sol
index 6127e29..53501a9 100644
--- a/contracts/utils/Errors.sol
+++ b/contracts/utils/Errors.sol
@@ -26,6 +26,7 @@ error InvalidNegativeFees();
 error InvalidOracleType();
 error InvalidParam();
 error InvalidParams();
+error InvalidPayee();
 error InvalidRate();
 error InvalidSwap();
 error InvalidTokens();
diff --git a/tests/units/Setters.t.sol b/tests/units/Setters.t.sol
index 5e251e0..efddb50 100644
--- a/tests/units/Setters.t.sol
+++ b/tests/units/Setters.t.sol
@@ -1528,6 +1528,32 @@ contract Test_Setters_UpdatePayees is Fixture {
     assertEq(parallelizer.getTotalShares(), 3 ether);
   }
 
+  /// @dev Bailsec Core Issue_19: a share allocated to the Parallelizer is handed back to `release`
+  /// as fresh income on the next call, so it recursively redistributes itself
+  function test_RevertWhen_PayeeIsTheParallelizer() public {
+    address[] memory payees = new address[](1);
+    payees[0] = address(parallelizer);
+    uint256[] memory shares = new uint256[](1);
+    shares[0] = 1 ether;
+
+    hoax(governor);
+    vm.expectRevert(Errors.InvalidPayee.selector);
+    parallelizer.updatePayees(payees, shares, false);
+  }
+
+  /// @dev `address(0)` is the sentinel `LibSurplus` uses to burn a share, so it stays valid
+  function test_PayeeCanBeZeroAddress() public {
+    address[] memory payees = new address[](1);
+    payees[0] = address(0);
+    uint256[] memory shares = new uint256[](1);
+    shares[0] = 1 ether;
+
+    hoax(governor);
+    parallelizer.updatePayees(payees, shares, false);
+
+    assertEq(parallelizer.getShares(address(0)), 1 ether);
+  }
+
   modifier initializePayees() {
     address[] memory payees = new address[](1);
     payees[0] = address(alice);

From 95c5ccb90aedfd2590756d6be3362e1e3c0a8ca6 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Tue, 8 Sep 2026 15:18:45 +0300
Subject: [PATCH 22/28] style(tests): wrap the over-length line the ratchet
 test introduced

`bun run lint:sol` reports it as an error rather than a warning, so it would fail
CI. Introduced by the Issue_04 fix.
---
 tests/fuzz/Oracle.t.sol | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/fuzz/Oracle.t.sol b/tests/fuzz/Oracle.t.sol
index a2f7505..c461910 100644
--- a/tests/fuzz/Oracle.t.sol
+++ b/tests/fuzz/Oracle.t.sol
@@ -726,9 +726,10 @@ contract OracleTest is Fixture, FunctionUtils {
     (uint256 oracleValue,,,,) = parallelizer.getOracleValues(collateral);
 
     vm.prank(governor);
+    bytes memory hyperparameters = abi.encode(uint128(0), uint128(0));
     parallelizer.setOracle(
       collateral,
-      abi.encode(readType, Storage.OracleReadType.MAX, data, abi.encode(oracleValue), abi.encode(uint128(0), uint128(0)))
+      abi.encode(readType, Storage.OracleReadType.MAX, data, abi.encode(oracleValue), hyperparameters)
     );
 
     (, int256 currentValue,,,) = _oracles[0].latestRoundData();

From eae104c8aa54799e9aa6a7ba75ac221cff212cf4 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 28 Sep 2026 10:08:17 +0300
Subject: [PATCH 23/28] fix(oracle): seed the MAX target at deployment instead
 of leaving it at zero

The ratchet bounds each step against the stored target, so a target left at 0
can never be raised: every positive spot exceeds 0 by more than 5%. New chains
would deploy with a permanently frozen oracle.

The initializer now seeds the target from spot once, and the ratchet governs
every later move. Seeding is refused on an already-set target, so it cannot be
used to sidestep the bound.

Reported by Bailsec against the Issue_04 remediation.
---
 .../configs/DiamondInitializer.sol            |  2 +-
 .../parallelizer/libraries/LibOracle.sol      | 27 +++++++++++++++++++
 tests/fuzz/Oracle.t.sol                       | 22 +++++++++++++++
 3 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/contracts/parallelizer/configs/DiamondInitializer.sol b/contracts/parallelizer/configs/DiamondInitializer.sol
index 7f1c428..457b394 100644
--- a/contracts/parallelizer/configs/DiamondInitializer.sol
+++ b/contracts/parallelizer/configs/DiamondInitializer.sol
@@ -33,7 +33,7 @@ contract DiamondInitializer {
       LibSetters.unpause(collateral.token, ActionType.Mint);
       LibSetters.unpause(collateral.token, ActionType.Burn);
       LibSetters.setStablecoinCap(collateral.token, 100_000_000 ether);
-      if (collateral.targetMax) LibOracle.updateOracle(collateral.token);
+      if (collateral.targetMax) LibOracle.initializeOracleTarget(collateral.token);
     }
 
     // setRedemptionCurveParams
diff --git a/contracts/parallelizer/libraries/LibOracle.sol b/contracts/parallelizer/libraries/LibOracle.sol
index 54431f8..c400e70 100644
--- a/contracts/parallelizer/libraries/LibOracle.sol
+++ b/contracts/parallelizer/libraries/LibOracle.sol
@@ -241,6 +241,33 @@ library LibOracle {
     return abi.decode(oracleConfig, (OracleReadType, OracleReadType, bytes, bytes, bytes));
   }
 
+  /// @notice Seeds the MAX target with the current spot, for a collateral that has never been ratcheted
+  /// @dev `updateOracle` bounds every step to `MAX_ORACLE_RATCHET_STEP` against the stored target, so a target
+  /// left at 0 can never be raised. Deployment goes through here once, then the ratchet takes over
+  function initializeOracleTarget(address collateral) internal {
+    ParallelizerStorage storage ts = s.transmuterStorage();
+    if (ts.collaterals[collateral].decimals == 0) revert NotCollateral();
+
+    (
+      OracleReadType oracleType,
+      OracleReadType targetType,
+      bytes memory oracleData,
+      bytes memory targetData,
+      bytes memory hyperparameters
+    ) = _parseOracleConfig(ts.collaterals[collateral].oracleConfig);
+
+    if (targetType != OracleReadType.MAX) revert OracleUpdateFailed();
+    // Only an unset target may be seeded, so this cannot be used to sidestep the ratchet later on
+    if (abi.decode(targetData, (uint256)) != 0) revert OracleUpdateFailed();
+
+    uint256 oracleValue = read(oracleType, BASE_18, oracleData);
+    if (oracleValue == 0) revert OracleUpdateFailed();
+
+    ts.collaterals[collateral].oracleConfig =
+      abi.encode(oracleType, targetType, oracleData, abi.encode(oracleValue), hyperparameters);
+    emit OracleTargetUpdated(collateral, 0, oracleValue);
+  }
+
   function updateOracle(address collateral) internal {
     ParallelizerStorage storage ts = s.transmuterStorage();
     if (ts.collaterals[collateral].decimals == 0) revert NotCollateral();
diff --git a/tests/fuzz/Oracle.t.sol b/tests/fuzz/Oracle.t.sol
index c461910..790b157 100644
--- a/tests/fuzz/Oracle.t.sol
+++ b/tests/fuzz/Oracle.t.sol
@@ -742,6 +742,28 @@ contract OracleTest is Fixture, FunctionUtils {
     parallelizer.updateOracle(collateral);
   }
 
+  function test_updateOracle_CannotLiftATargetLeftAtZero() public {
+    vm.prank(governor);
+    parallelizer.toggleTrusted(alice, Storage.TrustedType.Seller);
+
+    address collateral = _collaterals[0];
+    (Storage.OracleReadType readType,, bytes memory data,,) = parallelizer.getOracle(collateral);
+
+    // A MAX target seeded with 0, which is what the deployment script encoded before the initializer seeded spot
+    vm.prank(governor);
+    parallelizer.setOracle(
+      collateral,
+      abi.encode(
+        readType, Storage.OracleReadType.MAX, data, abi.encode(uint256(0)), abi.encode(uint128(0), uint128(0))
+      )
+    );
+
+    // Every positive spot is above 0 by more than the ratchet step, so the target can never be raised
+    vm.prank(alice);
+    vm.expectRevert(Errors.OracleUpdateFailed.selector);
+    parallelizer.updateOracle(collateral);
+  }
+
   function testFuzz_updateOracle_Success(uint256 updateOracleValue, uint32 heartbeat) public {
     vm.prank(governor);
     parallelizer.toggleTrusted(alice, Storage.TrustedType.Seller);

From 9a35f75ebc5930ba366589e6cb1e37c25afe0381 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 28 Sep 2026 10:08:17 +0300
Subject: [PATCH 24/28] fix(rebalancer): clear the deposit address approval
 when the asset rotates

Asset rotation cleared `oldUnderlying -> yieldBearingAsset`, the vault path's
relationship. The MultiBlock deposit path instead approves
`underlying -> depositAddress`, so that allowance survived the rotation and the
regression test asserted the same wrong pair.

A virtual hook lets each rebalancer revoke what it actually granted. The new
test fails without the override.

Reported by Bailsec against the Issue_02 remediation.
---
 contracts/helpers/BaseRebalancer.sol          |  6 +++++
 contracts/helpers/MultiBlockRebalancer.sol    | 10 ++++++++
 .../units/DonationRedemptionCoefficient.t.sol | 24 +++++++++++++++++++
 tests/units/Rebalancer.t.sol                  | 12 ++++++++++
 4 files changed, 52 insertions(+)

diff --git a/contracts/helpers/BaseRebalancer.sol b/contracts/helpers/BaseRebalancer.sol
index 19abd87..e313579 100644
--- a/contracts/helpers/BaseRebalancer.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -265,6 +265,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     if (previousAsset != address(0) && previousAsset != asset) {
       IERC20(previousAsset).forceApprove(yieldBearingAsset, 0);
       emit AllowanceReset(previousAsset, yieldBearingAsset);
+      _revokeAssetAllowances(yieldBearingAsset, previousAsset);
     }
     yieldBearingInfo.asset = asset;
     if (targetExposure >= 1e9) revert InvalidParam();
@@ -282,6 +283,11 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     }
   }
 
+  /// @notice Revokes the allowances a derived rebalancer granted over an asset being rotated out
+  /// @dev `_setYieldBearingAssetData` only clears the `asset -> yieldBearingAsset` approval the vault path uses.
+  /// A rebalancer that approves a different spender overrides this to clear its own relationship
+  function _revokeAssetAllowances(address yieldBearingAsset, address previousAsset) internal virtual { }
+
   function _updateLimitExposuresYieldAsset(
     address asset,
     YieldBearingParams storage yieldBearingInfo
diff --git a/contracts/helpers/MultiBlockRebalancer.sol b/contracts/helpers/MultiBlockRebalancer.sol
index 172ab3c..421b28a 100644
--- a/contracts/helpers/MultiBlockRebalancer.sol
+++ b/contracts/helpers/MultiBlockRebalancer.sol
@@ -62,6 +62,16 @@ contract MultiBlockRebalancer is BaseRebalancer {
     yieldBearingToDepositAddress[yieldBearingAsset] = newDepositAddress;
   }
 
+  /// @inheritdoc BaseRebalancer
+  /// @dev The deposit path approves `asset -> depositAddress`, so rotating the asset has to clear that too
+  function _revokeAssetAllowances(address yieldBearingAsset, address previousAsset) internal override {
+    address depositAddress = yieldBearingToDepositAddress[yieldBearingAsset];
+    if (depositAddress != address(0)) {
+      IERC20(previousAsset).forceApprove(depositAddress, 0);
+      emit AllowanceReset(previousAsset, depositAddress);
+    }
+  }
+
   /*//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
                                                         TRUSTED FUNCTIONS
   //////////////////////////////////////////////////////////////////////////////////////////////////////////////////*/
diff --git a/tests/units/DonationRedemptionCoefficient.t.sol b/tests/units/DonationRedemptionCoefficient.t.sol
index 7a8082d..fdf2fa9 100644
--- a/tests/units/DonationRedemptionCoefficient.t.sol
+++ b/tests/units/DonationRedemptionCoefficient.t.sol
@@ -230,6 +230,30 @@ contract Test_DonationRedemptionCoefficient is Fixture {
     }
   }
 
+  /// @dev Bailsec's residual case needs the system to be undercollateralised. Once the ratio reaches
+  /// 100% the curve sits at its cap, the donation buys no coefficient lift, and the attacker is left
+  /// paying the spread on the collateral they donated
+  function test_Overcollateralized_RemovesTheDonationProfit() public {
+    uint256 donation = 2000e12;
+
+    uint256 snap = vm.snapshotState();
+    _setRampedCurve(600_000_000);
+    int256 under = _attackerNetAtShare(90, donation);
+    vm.revertToState(snap);
+
+    snap = vm.snapshotState();
+    _setRampedCurve(600_000_000);
+    _setRatioTo(1_050_000_000);
+    int256 over = _attackerNetAtShare(90, donation);
+    vm.revertToState(snap);
+
+    console.log("undercollateralised:");
+    _log(under);
+    console.log("overcollateralised:");
+    _log(over);
+    assertLt(over, int256(0), "an overcollateralised system must not pay the donation attack");
+  }
+
   function _log(int256 net) internal pure {
     if (net > 0) console.log("    attacker GAINS", uint256(net));
     else console.log("    attacker LOSES", uint256(-net));
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index 37e7963..cef902b 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -177,6 +177,18 @@ contract Test_Rebalancer_Allowances is Fixture {
     assertEq(IERC20(address(eurA)).allowance(address(rebalancer), address(eurY)), type(uint256).max);
   }
 
+  function test_RotatingTheAsset_RevokesTheDepositAddressAllowance() public {
+    vm.prank(governor);
+    rebalancer.setYieldBearingToDepositAddress(address(eurY), bob);
+    // The deposit path approves the underlying to the deposit address, not to the yield bearing asset
+    _seedAllowance(address(eurA), bob);
+
+    vm.prank(guardian);
+    rebalancer.setYieldBearingAssetData(address(eurY), address(eurB), 5e8, 1e8, 9e8, 1, 5e7);
+
+    assertEq(IERC20(address(eurA)).allowance(address(rebalancer), bob), 0);
+  }
+
   function test_RotatingTheDepositAddress_RevokesTheOutgoingAllowance() public {
     vm.prank(governor);
     rebalancer.setYieldBearingToDepositAddress(address(eurY), bob);

From ce9c01637894fbcda0e8ac13bc4ef54a563b8dc8 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 28 Sep 2026 11:00:52 +0300
Subject: [PATCH 25/28] test(redemption): pin the donation attack against the
 surplus buffer steady state

processSurplus drives the ratio to surplusBufferRatio, 100.5% on mainnet, so the
margin over the profitable region is under a point rather than the headroom a
spot reading suggests.

The measurements also correct the earlier framing: the break-even sits just under
100% whatever the ramp, so the defence is the cap at 100% rather than the slope.
Widening the ramp or trimming the deterrent barely moves it.
---
 .../units/DonationRedemptionCoefficient.t.sol | 29 ++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/tests/units/DonationRedemptionCoefficient.t.sol b/tests/units/DonationRedemptionCoefficient.t.sol
index fdf2fa9..49704ba 100644
--- a/tests/units/DonationRedemptionCoefficient.t.sol
+++ b/tests/units/DonationRedemptionCoefficient.t.sol
@@ -232,7 +232,8 @@ contract Test_DonationRedemptionCoefficient is Fixture {
 
   /// @dev Bailsec's residual case needs the system to be undercollateralised. Once the ratio reaches
   /// 100% the curve sits at its cap, the donation buys no coefficient lift, and the attacker is left
-  /// paying the spread on the collateral they donated
+  /// paying the spread on the collateral they donated. The defence is the 100% kink rather than the
+  /// slope: widening the ramp barely moves the break-even, which sits just under 100% either way
   function test_Overcollateralized_RemovesTheDonationProfit() public {
     uint256 donation = 2000e12;
 
@@ -254,6 +255,32 @@ contract Test_DonationRedemptionCoefficient is Fixture {
     assertLt(over, int256(0), "an overcollateralised system must not pay the donation attack");
   }
 
+  /// @dev `processSurplus` drives the ratio down to `surplusBufferRatio`, 100.5% on mainnet, so the
+  /// margin over the profitable region is under a point rather than the headroom a fresh reading
+  /// suggests. This pins where the donation attack turns positive from that steady state
+  function test_SurplusBufferSteadyState_LeavesAThinMargin() public {
+    uint256 donation = 2000e12;
+
+    uint256 snap = vm.snapshotState();
+    _setRampedCurve(600_000_000);
+    _setRatioTo(1_005_000_000);
+    int256 atBuffer = _attackerNetAtShare(90, donation);
+    vm.revertToState(snap);
+
+    snap = vm.snapshotState();
+    _setRampedCurve(600_000_000);
+    _setRatioTo(995_000_000);
+    int256 belowBuffer = _attackerNetAtShare(90, donation);
+    vm.revertToState(snap);
+
+    console.log("at the 100.5% surplus buffer:");
+    _log(atBuffer);
+    console.log("one point below it:");
+    _log(belowBuffer);
+
+    assertLt(atBuffer, int256(0), "the attack must not pay at the surplus buffer");
+  }
+
   function _log(int256 net) internal pure {
     if (net > 0) console.log("    attacker GAINS", uint256(net));
     else console.log("    attacker LOSES", uint256(-net));

From 3e7d93a8e17fedd5267006f4bc69525ce70671f0 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 28 Sep 2026 11:11:21 +0300
Subject: [PATCH 26/28] test(redemption): measure the donation attack across
 the monthly surplus cycle

processSurplus runs monthly, so the ratio sawtooths between the buffer and
whatever yield adds before the next run. The trough is the block the run lands
in, which is both the thinnest and the most predictable moment.

Both ends of the cycle stay loss-making, and by almost the same margin: above
100% the curve is capped, so extra headroom buys nothing. That is the cap doing
the work rather than the size of the buffer.
---
 contracts/helpers/BaseRebalancer.sol          |  4 +-
 contracts/helpers/MultiBlockRebalancer.sol    |  1 -
 .../parallelizer/libraries/LibOracle.sol      |  7 ++--
 .../units/DonationRedemptionCoefficient.t.sol | 37 +++++++++++++++----
 tests/units/Rebalancer.t.sol                  |  1 -
 5 files changed, 34 insertions(+), 16 deletions(-)

diff --git a/contracts/helpers/BaseRebalancer.sol b/contracts/helpers/BaseRebalancer.sol
index e313579..37300a5 100644
--- a/contracts/helpers/BaseRebalancer.sol
+++ b/contracts/helpers/BaseRebalancer.sol
@@ -283,9 +283,7 @@ abstract contract BaseRebalancer is IRebalancer, AccessManaged {
     }
   }
 
-  /// @notice Revokes the allowances a derived rebalancer granted over an asset being rotated out
-  /// @dev `_setYieldBearingAssetData` only clears the `asset -> yieldBearingAsset` approval the vault path uses.
-  /// A rebalancer that approves a different spender overrides this to clear its own relationship
+  /// @notice Lets a rebalancer revoke the allowances it granted over an asset being rotated out
   function _revokeAssetAllowances(address yieldBearingAsset, address previousAsset) internal virtual { }
 
   function _updateLimitExposuresYieldAsset(
diff --git a/contracts/helpers/MultiBlockRebalancer.sol b/contracts/helpers/MultiBlockRebalancer.sol
index 421b28a..6b293a9 100644
--- a/contracts/helpers/MultiBlockRebalancer.sol
+++ b/contracts/helpers/MultiBlockRebalancer.sol
@@ -63,7 +63,6 @@ contract MultiBlockRebalancer is BaseRebalancer {
   }
 
   /// @inheritdoc BaseRebalancer
-  /// @dev The deposit path approves `asset -> depositAddress`, so rotating the asset has to clear that too
   function _revokeAssetAllowances(address yieldBearingAsset, address previousAsset) internal override {
     address depositAddress = yieldBearingToDepositAddress[yieldBearingAsset];
     if (depositAddress != address(0)) {
diff --git a/contracts/parallelizer/libraries/LibOracle.sol b/contracts/parallelizer/libraries/LibOracle.sol
index c400e70..db45436 100644
--- a/contracts/parallelizer/libraries/LibOracle.sol
+++ b/contracts/parallelizer/libraries/LibOracle.sol
@@ -241,9 +241,8 @@ library LibOracle {
     return abi.decode(oracleConfig, (OracleReadType, OracleReadType, bytes, bytes, bytes));
   }
 
-  /// @notice Seeds the MAX target with the current spot, for a collateral that has never been ratcheted
-  /// @dev `updateOracle` bounds every step to `MAX_ORACLE_RATCHET_STEP` against the stored target, so a target
-  /// left at 0 can never be raised. Deployment goes through here once, then the ratchet takes over
+  /// @notice Seeds the MAX target with the current spot at deployment
+  /// @dev `updateOracle` bounds each step against the stored target, so a target left at 0 can never be raised
   function initializeOracleTarget(address collateral) internal {
     ParallelizerStorage storage ts = s.transmuterStorage();
     if (ts.collaterals[collateral].decimals == 0) revert NotCollateral();
@@ -257,7 +256,7 @@ library LibOracle {
     ) = _parseOracleConfig(ts.collaterals[collateral].oracleConfig);
 
     if (targetType != OracleReadType.MAX) revert OracleUpdateFailed();
-    // Only an unset target may be seeded, so this cannot be used to sidestep the ratchet later on
+    // Only an unset target may be seeded, so this cannot sidestep the ratchet later on
     if (abi.decode(targetData, (uint256)) != 0) revert OracleUpdateFailed();
 
     uint256 oracleValue = read(oracleType, BASE_18, oracleData);
diff --git a/tests/units/DonationRedemptionCoefficient.t.sol b/tests/units/DonationRedemptionCoefficient.t.sol
index 49704ba..f2f1687 100644
--- a/tests/units/DonationRedemptionCoefficient.t.sol
+++ b/tests/units/DonationRedemptionCoefficient.t.sol
@@ -230,10 +230,8 @@ contract Test_DonationRedemptionCoefficient is Fixture {
     }
   }
 
-  /// @dev Bailsec's residual case needs the system to be undercollateralised. Once the ratio reaches
-  /// 100% the curve sits at its cap, the donation buys no coefficient lift, and the attacker is left
-  /// paying the spread on the collateral they donated. The defence is the 100% kink rather than the
-  /// slope: widening the ramp barely moves the break-even, which sits just under 100% either way
+  /// @dev At or above 100% the curve sits at its cap, so the donation buys no coefficient lift and the
+  /// attacker is left paying the spread. The cap is what closes this, not the slope of the ramp
   function test_Overcollateralized_RemovesTheDonationProfit() public {
     uint256 donation = 2000e12;
 
@@ -255,9 +253,8 @@ contract Test_DonationRedemptionCoefficient is Fixture {
     assertLt(over, int256(0), "an overcollateralised system must not pay the donation attack");
   }
 
-  /// @dev `processSurplus` drives the ratio down to `surplusBufferRatio`, 100.5% on mainnet, so the
-  /// margin over the profitable region is under a point rather than the headroom a fresh reading
-  /// suggests. This pins where the donation attack turns positive from that steady state
+  /// @dev `processSurplus` drives the ratio down to `surplusBufferRatio`, so the margin over the
+  /// profitable region is under a point rather than whatever a spot reading suggests
   function test_SurplusBufferSteadyState_LeavesAThinMargin() public {
     uint256 donation = 2000e12;
 
@@ -281,6 +278,32 @@ contract Test_DonationRedemptionCoefficient is Fixture {
     assertLt(atBuffer, int256(0), "the attack must not pay at the surplus buffer");
   }
 
+  /// @dev The ratio sawtooths between the buffer and whatever yield adds before the next run, so the
+  /// trough is the block the run lands in
+  function test_MonthlySawtooth_TroughIsTheExposedPoint() public {
+    uint256 donation = 2000e12;
+
+    uint256 snap = vm.snapshotState();
+    _setRampedCurve(600_000_000);
+    _setRatioTo(1_005_000_000);
+    int256 trough = _attackerNetAtShare(90, donation);
+    vm.revertToState(snap);
+
+    snap = vm.snapshotState();
+    _setRampedCurve(600_000_000);
+    _setRatioTo(1_011_000_000);
+    int256 lateCycle = _attackerNetAtShare(90, donation);
+    vm.revertToState(snap);
+
+    console.log("trough, just after processSurplus:");
+    _log(trough);
+    console.log("late in the cycle, after a month of yield:");
+    _log(lateCycle);
+
+    assertLt(trough, int256(0), "the trough must still not pay the attack");
+    assertLt(lateCycle, int256(0), "later in the cycle must not pay either");
+  }
+
   function _log(int256 net) internal pure {
     if (net > 0) console.log("    attacker GAINS", uint256(net));
     else console.log("    attacker LOSES", uint256(-net));
diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index cef902b..61a94a9 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -180,7 +180,6 @@ contract Test_Rebalancer_Allowances is Fixture {
   function test_RotatingTheAsset_RevokesTheDepositAddressAllowance() public {
     vm.prank(governor);
     rebalancer.setYieldBearingToDepositAddress(address(eurY), bob);
-    // The deposit path approves the underlying to the deposit address, not to the yield bearing asset
     _seedAllowance(address(eurA), bob);
 
     vm.prank(guardian);

From 038164ed967011547ba050652ec8b76c21a49115 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 28 Sep 2026 13:47:26 +0300
Subject: [PATCH 27/28] style(tests): wrap the rebalancer constructor calls
 over the line limit

solhint caps lines at 120 and the two GenericRebalancer constructions ran to 122,
which failed the lint job and skipped the test jobs behind it.
---
 tests/units/Rebalancer.t.sol | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/tests/units/Rebalancer.t.sol b/tests/units/Rebalancer.t.sol
index 61a94a9..e7dbf19 100644
--- a/tests/units/Rebalancer.t.sol
+++ b/tests/units/Rebalancer.t.sol
@@ -72,7 +72,12 @@ contract Test_Rebalancer_ResidualInput is Fixture {
     router = new MockRouter();
     lender = new MockFlashLoan();
     rebalancer = new GenericRebalancer(
-      address(router), address(router), tokenP, parallelizer, address(accessManager), IERC3156FlashLender(address(lender))
+      address(router),
+      address(router),
+      tokenP,
+      parallelizer,
+      address(accessManager),
+      IERC3156FlashLender(address(lender))
     );
 
     vm.startPrank(governor);
@@ -227,7 +232,12 @@ contract Test_Rebalancer_FlashLoanFee is Fixture {
     router = new MockRouter();
     lender = new MockFlashLoan();
     rebalancer = new GenericRebalancer(
-      address(router), address(router), tokenP, parallelizer, address(accessManager), IERC3156FlashLender(address(lender))
+      address(router),
+      address(router),
+      tokenP,
+      parallelizer,
+      address(accessManager),
+      IERC3156FlashLender(address(lender))
     );
 
     vm.startPrank(governor);

From 518cb9141cf8c51c8d933bae0147e00416d218a6 Mon Sep 17 00:00:00 2001
From: FabienCoutant <your.primary.email@example.com>
Date: Mon, 28 Sep 2026 13:51:12 +0300
Subject: [PATCH 28/28] style(docs): realign the README tables after the
 rebalancer rename

Shortening the facet names left the markdown columns unaligned, which failed the
prettier check in the lint job.
---
 README.md | 120 +++++++++++++++++++++++++++---------------------------
 1 file changed, 60 insertions(+), 60 deletions(-)

diff --git a/README.md b/README.md
index 6356c98..40892dc 100644
--- a/README.md
+++ b/README.md
@@ -61,82 +61,82 @@ Some changed has been made to the original Angle's Transmuter:
 
 ### Mainnet
 
-| Contract              | Explore                                                                                                                |
-| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| DiamondCut Facet      | [0xad58Fc13a682a121e5fe2f8E45D4D988A7e51B0D](https:///etherscan.io/address/0xad58Fc13a682a121e5fe2f8E45D4D988A7e51B0D) |
-| DiamondLoupe Facet    | [0xA360E5aD9F17caff53715346888aA0d13541c2F5](https:///etherscan.io/address/0xA360E5aD9F17caff53715346888aA0d13541c2F5) |
-| Getters Facet         | [0xa9C21Cf291ad935e0C9B05a55A42254fB159181d](https:///etherscan.io/address/0xa9C21Cf291ad935e0C9B05a55A42254fB159181d) |
-| Redeemer Facet        | [0x1bB46FC55E3fd91Ca0F162DCC0B3ef574C8ff97E](https:///etherscan.io/address/0x1bB46FC55E3fd91Ca0F162DCC0B3ef574C8ff97E) |
-| RewardHandler Facet   | [0xd8cc2A51556Da84b5DB309e86f30Ff98B5309862](https:///etherscan.io/address/0xd8cc2A51556Da84b5DB309e86f30Ff98B5309862) |
-| SettersGovernor Facet | [0xeB197439D1425F3129F01F7763EC511DF2489095](https:///etherscan.io/address/0xeB197439D1425F3129F01F7763EC511DF2489095) |
-| SettersGuardian Facet | [0xc743BeDE8412228B42Ae755cD64A33Cd3ae4A92f](https:///etherscan.io/address/0xc743BeDE8412228B42Ae755cD64A33Cd3ae4A92f) |
-| Swapper Facet         | [0x506Ba37aa8e265bE445913B9c4080852277f3c5a](https:///etherscan.io/address/0x506Ba37aa8e265bE445913B9c4080852277f3c5a) |
-| Parallelizer USDp     | [0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2](https:///etherscan.io/address/0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2) |
-| sUSDp (Savings)       | [0x0d45b129dc868963025Db79A9074EA9c9e32Cae4](https:///etherscan.io/address/0x0d45b129dc868963025Db79A9074EA9c9e32Cae4) |
+| Contract               | Explore                                                                                                                |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| DiamondCut Facet       | [0xad58Fc13a682a121e5fe2f8E45D4D988A7e51B0D](https:///etherscan.io/address/0xad58Fc13a682a121e5fe2f8E45D4D988A7e51B0D) |
+| DiamondLoupe Facet     | [0xA360E5aD9F17caff53715346888aA0d13541c2F5](https:///etherscan.io/address/0xA360E5aD9F17caff53715346888aA0d13541c2F5) |
+| Getters Facet          | [0xa9C21Cf291ad935e0C9B05a55A42254fB159181d](https:///etherscan.io/address/0xa9C21Cf291ad935e0C9B05a55A42254fB159181d) |
+| Redeemer Facet         | [0x1bB46FC55E3fd91Ca0F162DCC0B3ef574C8ff97E](https:///etherscan.io/address/0x1bB46FC55E3fd91Ca0F162DCC0B3ef574C8ff97E) |
+| RewardHandler Facet    | [0xd8cc2A51556Da84b5DB309e86f30Ff98B5309862](https:///etherscan.io/address/0xd8cc2A51556Da84b5DB309e86f30Ff98B5309862) |
+| SettersGovernor Facet  | [0xeB197439D1425F3129F01F7763EC511DF2489095](https:///etherscan.io/address/0xeB197439D1425F3129F01F7763EC511DF2489095) |
+| SettersGuardian Facet  | [0xc743BeDE8412228B42Ae755cD64A33Cd3ae4A92f](https:///etherscan.io/address/0xc743BeDE8412228B42Ae755cD64A33Cd3ae4A92f) |
+| Swapper Facet          | [0x506Ba37aa8e265bE445913B9c4080852277f3c5a](https:///etherscan.io/address/0x506Ba37aa8e265bE445913B9c4080852277f3c5a) |
+| Parallelizer USDp      | [0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2](https:///etherscan.io/address/0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2) |
+| sUSDp (Savings)        | [0x0d45b129dc868963025Db79A9074EA9c9e32Cae4](https:///etherscan.io/address/0x0d45b129dc868963025Db79A9074EA9c9e32Cae4) |
 | GenericRebalancer USDp | [0x36DA06796fD9d22BCD6287b66A87FfdadB12636C](https:///etherscan.io/address/0x36DA06796fD9d22BCD6287b66A87FfdadB12636C) |
 
 ### Base
 
-| Contract              | Explore                                                                                                                |
-| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| DiamondCut Facet      | [0x15452454A9735D68df430879B2941316a09295B1](https:///basescan.org/address/0x15452454A9735D68df430879B2941316a09295B1) |
-| DiamondLoupe Facet    | [0x24CeF236056834f38e9247A1Fff6681Dd313d3aa](https:///basescan.org/address/0x24CeF236056834f38e9247A1Fff6681Dd313d3aa) |
-| Getters Facet         | [0xBE65F0F410A72BeC163dC65d46c83699e957D588](https:///basescan.org/address/0xBE65F0F410A72BeC163dC65d46c83699e957D588) |
-| Redeemer Facet        | [0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8](https:///basescan.org/address/0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8) |
-| RewardHandler Facet   | [0x2B6C7c275404e93A14A05b549AF292231D6e4DeC](https:///basescan.org/address/0x2B6C7c275404e93A14A05b549AF292231D6e4DeC) |
-| SettersGovernor Facet | [0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43](https:///basescan.org/address/0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43) |
-| SettersGuardian Facet | [0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8](https:///basescan.org/address/0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8) |
-| Swapper Facet         | [0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7](https:///basescan.org/address/0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7) |
-| Parallelizer USDp     | [0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD](https:///basescan.org/address/0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD) |
-| sUSDp (Savings)       | [0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7](https:///basescan.org/address/0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7) |
+| Contract               | Explore                                                                                                                |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| DiamondCut Facet       | [0x15452454A9735D68df430879B2941316a09295B1](https:///basescan.org/address/0x15452454A9735D68df430879B2941316a09295B1) |
+| DiamondLoupe Facet     | [0x24CeF236056834f38e9247A1Fff6681Dd313d3aa](https:///basescan.org/address/0x24CeF236056834f38e9247A1Fff6681Dd313d3aa) |
+| Getters Facet          | [0xBE65F0F410A72BeC163dC65d46c83699e957D588](https:///basescan.org/address/0xBE65F0F410A72BeC163dC65d46c83699e957D588) |
+| Redeemer Facet         | [0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8](https:///basescan.org/address/0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8) |
+| RewardHandler Facet    | [0x2B6C7c275404e93A14A05b549AF292231D6e4DeC](https:///basescan.org/address/0x2B6C7c275404e93A14A05b549AF292231D6e4DeC) |
+| SettersGovernor Facet  | [0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43](https:///basescan.org/address/0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43) |
+| SettersGuardian Facet  | [0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8](https:///basescan.org/address/0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8) |
+| Swapper Facet          | [0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7](https:///basescan.org/address/0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7) |
+| Parallelizer USDp      | [0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD](https:///basescan.org/address/0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD) |
+| sUSDp (Savings)        | [0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7](https:///basescan.org/address/0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7) |
 | GenericRebalancer USDp | [0xCa43eCFCDFBA1fED003649e946Ae6091646B410a](https:///basescan.org/address/0xCa43eCFCDFBA1fED003649e946Ae6091646B410a) |
 
 ### Sonic
 
-| Contract              | Explore                                                                                                                 |
-| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| DiamondCut Facet      | [0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8](https:///sonicscan.org/address/0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8) |
-| DiamondLoupe Facet    | [0x2B6C7c275404e93A14A05b549AF292231D6e4DeC](https:///sonicscan.org/address/0x2B6C7c275404e93A14A05b549AF292231D6e4DeC) |
-| Getters Facet         | [0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43](https:///sonicscan.org/address/0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43) |
-| Redeemer Facet        | [0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8](https:///sonicscan.org/address/0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8) |
-| RewardHandler Facet   | [0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7](https:///sonicscan.org/address/0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7) |
-| SettersGovernor Facet | [0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD](https:///sonicscan.org/address/0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD) |
-| SettersGuardian Facet | [0xCa43eCFCDFBA1fED003649e946Ae6091646B410a](https:///sonicscan.org/address/0xCa43eCFCDFBA1fED003649e946Ae6091646B410a) |
-| Swapper Facet         | [0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF](https:///sonicscan.org/address/0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF) |
-| Parallelizer USDp     | [0xBEFBAe2330186F031b469e26283aCc66bb5F8826](https:///sonicscan.org/address/0xBEFBAe2330186F031b469e26283aCc66bb5F8826) |
-| sUSDp (Savings)       | [0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b](https:///sonicscan.org/address/0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b) |
+| Contract               | Explore                                                                                                                 |
+| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| DiamondCut Facet       | [0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8](https:///sonicscan.org/address/0xe9fe4720FA99f9b28584dA44ABB8cf91f15990e8) |
+| DiamondLoupe Facet     | [0x2B6C7c275404e93A14A05b549AF292231D6e4DeC](https:///sonicscan.org/address/0x2B6C7c275404e93A14A05b549AF292231D6e4DeC) |
+| Getters Facet          | [0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43](https:///sonicscan.org/address/0x90e4AE8bA8C6Fd51fcED0f9331668b05c7a4Ee43) |
+| Redeemer Facet         | [0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8](https:///sonicscan.org/address/0xe5C82b4F09Fd4d079757e156Db44AFD2c8032CC8) |
+| RewardHandler Facet    | [0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7](https:///sonicscan.org/address/0xfB2D070270e9FfC2dB107D0162b47c2Ed291E3F7) |
+| SettersGovernor Facet  | [0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD](https:///sonicscan.org/address/0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD) |
+| SettersGuardian Facet  | [0xCa43eCFCDFBA1fED003649e946Ae6091646B410a](https:///sonicscan.org/address/0xCa43eCFCDFBA1fED003649e946Ae6091646B410a) |
+| Swapper Facet          | [0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF](https:///sonicscan.org/address/0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF) |
+| Parallelizer USDp      | [0xBEFBAe2330186F031b469e26283aCc66bb5F8826](https:///sonicscan.org/address/0xBEFBAe2330186F031b469e26283aCc66bb5F8826) |
+| sUSDp (Savings)        | [0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b](https:///sonicscan.org/address/0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b) |
 | GenericRebalancer USDp | [0x120805265fA944834DC6e930De2995768806a9d2](https:///sonicscan.org/address/0x120805265fA944834DC6e930De2995768806a9d2) |
 
 #### HyperEVM
 
-| Contract              | Explore                                                                                                                     |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| DiamondCut Facet      | [0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF](https:///www.hyperscan.com/address/0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF) |
-| DiamondLoupe Facet    | [0xBEFBAe2330186F031b469e26283aCc66bb5F8826](https:///www.hyperscan.com/address/0xBEFBAe2330186F031b469e26283aCc66bb5F8826) |
-| Getters Facet         | [0x120805265fA944834DC6e930De2995768806a9d2](https:///www.hyperscan.com/address/0x120805265fA944834DC6e930De2995768806a9d2) |
-| Redeemer Facet        | [0xF92eD96C7bEc4aD46FF7937Cae633c907EBDf594](https:///www.hyperscan.com/address/0xF92eD96C7bEc4aD46FF7937Cae633c907EBDf594) |
-| RewardHandler Facet   | [0xa5d9CAA2EF06D39d5992b5046e2DEFFf6D5Cbd18](https:///www.hyperscan.com/address/0xa5d9CAA2EF06D39d5992b5046e2DEFFf6D5Cbd18) |
-| SettersGovernor Facet | [0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7](https:///www.hyperscan.com/address/0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7) |
-| SettersGuardian Facet | [0xaE2Fb66d1989EC1684fF095B75D151Ae8E403E2e](https:///www.hyperscan.com/address/0xaE2Fb66d1989EC1684fF095B75D151Ae8E403E2e) |
-| Swapper Facet         | [0x1b2741dB9F46a0411852e4cC28dDC476851b5179](https:///www.hyperscan.com/address/0x1b2741dB9F46a0411852e4cC28dDC476851b5179) |
-| Parallelizer USDp     | [0x1250304F66404cd153fA39388DDCDAec7E0f1707](https:///www.hyperscan.com/address/0x1250304F66404cd153fA39388DDCDAec7E0f1707) |
-| sUSDp (Savings)       | [0x9B3a8f7CEC208e247d97dEE13313690977e24459](https:///www.hyperscan.com/address/0x9B3a8f7CEC208e247d97dEE13313690977e24459) |
+| Contract               | Explore                                                                                                                     |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| DiamondCut Facet       | [0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF](https:///www.hyperscan.com/address/0xA65821FfE86E6Eb613DAa1F70AF350C5A21759dF) |
+| DiamondLoupe Facet     | [0xBEFBAe2330186F031b469e26283aCc66bb5F8826](https:///www.hyperscan.com/address/0xBEFBAe2330186F031b469e26283aCc66bb5F8826) |
+| Getters Facet          | [0x120805265fA944834DC6e930De2995768806a9d2](https:///www.hyperscan.com/address/0x120805265fA944834DC6e930De2995768806a9d2) |
+| Redeemer Facet         | [0xF92eD96C7bEc4aD46FF7937Cae633c907EBDf594](https:///www.hyperscan.com/address/0xF92eD96C7bEc4aD46FF7937Cae633c907EBDf594) |
+| RewardHandler Facet    | [0xa5d9CAA2EF06D39d5992b5046e2DEFFf6D5Cbd18](https:///www.hyperscan.com/address/0xa5d9CAA2EF06D39d5992b5046e2DEFFf6D5Cbd18) |
+| SettersGovernor Facet  | [0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7](https:///www.hyperscan.com/address/0x472eD57b376fE400259FB28e5C46eB53f0E3e7E7) |
+| SettersGuardian Facet  | [0xaE2Fb66d1989EC1684fF095B75D151Ae8E403E2e](https:///www.hyperscan.com/address/0xaE2Fb66d1989EC1684fF095B75D151Ae8E403E2e) |
+| Swapper Facet          | [0x1b2741dB9F46a0411852e4cC28dDC476851b5179](https:///www.hyperscan.com/address/0x1b2741dB9F46a0411852e4cC28dDC476851b5179) |
+| Parallelizer USDp      | [0x1250304F66404cd153fA39388DDCDAec7E0f1707](https:///www.hyperscan.com/address/0x1250304F66404cd153fA39388DDCDAec7E0f1707) |
+| sUSDp (Savings)        | [0x9B3a8f7CEC208e247d97dEE13313690977e24459](https:///www.hyperscan.com/address/0x9B3a8f7CEC208e247d97dEE13313690977e24459) |
 | GenericRebalancer USDp | [0x57770C1721Eb35509f38210A935c8b1911db7E0e](https:///www.hyperscan.com/address/0x57770C1721Eb35509f38210A935c8b1911db7E0e) |
 
 #### Avalanche
 
-| Contract              | Explore                                                                                                                    |
-| --------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| DiamondCut Facet      | [0x657acB8A3BF9383e561565d422ea9b9A90ce0052](https:///www.snowscan.xyz/address/0x657acB8A3BF9383e561565d422ea9b9A90ce0052) |
-| DiamondLoupe Facet    | [0x23D491aa7C0972087F8a607F6f4c7106a02BA95d](https:///www.snowscan.xyz/address/0x23D491aa7C0972087F8a607F6f4c7106a02BA95d) |
-| Getters Facet         | [0xF6Cc47E981ED5902BE382dbe7B54e3696De22dBb](https:///www.snowscan.xyz/address/0xF6Cc47E981ED5902BE382dbe7B54e3696De22dBb) |
-| Redeemer Facet        | [0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2](https:///www.snowscan.xyz/address/0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2) |
-| RewardHandler Facet   | [0x36DA06796fD9d22BCD6287b66A87FfdadB12636C](https:///www.snowscan.xyz/address/0x36DA06796fD9d22BCD6287b66A87FfdadB12636C) |
-| SettersGovernor Facet | [0x5bEADA21a6B9Cb229117B3EA2C0D1594785013A2](https:///www.snowscan.xyz/address/0x5bEADA21a6B9Cb229117B3EA2C0D1594785013A2) |
-| SettersGuardian Facet | [0xbBC90E685C4a66EBBDC71a3A1437d3111e43Fe84](https:///www.snowscan.xyz/address/0xbBC90E685C4a66EBBDC71a3A1437d3111e43Fe84) |
-| Swapper Facet         | [0x57265a3D7db8f4a4a155eadF6c7326926caC1490](https:///www.snowscan.xyz/address/0x57265a3D7db8f4a4a155eadF6c7326926caC1490) |
-| Parallelizer USDp     | [0x41d58951cbd12D4Ef49b0437897677bbF5547C80](https:///www.snowscan.xyz/address/0x41d58951cbd12D4Ef49b0437897677bbF5547C80) |
-| sUSDp (Savings)       | [0x9d92c21205383651610f90722131655a5b8ed3e0](https:///www.snowscan.xyz/address/0x9d92c21205383651610f90722131655a5b8ed3e0) |
+| Contract               | Explore                                                                                                                    |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| DiamondCut Facet       | [0x657acB8A3BF9383e561565d422ea9b9A90ce0052](https:///www.snowscan.xyz/address/0x657acB8A3BF9383e561565d422ea9b9A90ce0052) |
+| DiamondLoupe Facet     | [0x23D491aa7C0972087F8a607F6f4c7106a02BA95d](https:///www.snowscan.xyz/address/0x23D491aa7C0972087F8a607F6f4c7106a02BA95d) |
+| Getters Facet          | [0xF6Cc47E981ED5902BE382dbe7B54e3696De22dBb](https:///www.snowscan.xyz/address/0xF6Cc47E981ED5902BE382dbe7B54e3696De22dBb) |
+| Redeemer Facet         | [0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2](https:///www.snowscan.xyz/address/0x6efeDDF9269c3683Ba516cb0e2124FE335F262a2) |
+| RewardHandler Facet    | [0x36DA06796fD9d22BCD6287b66A87FfdadB12636C](https:///www.snowscan.xyz/address/0x36DA06796fD9d22BCD6287b66A87FfdadB12636C) |
+| SettersGovernor Facet  | [0x5bEADA21a6B9Cb229117B3EA2C0D1594785013A2](https:///www.snowscan.xyz/address/0x5bEADA21a6B9Cb229117B3EA2C0D1594785013A2) |
+| SettersGuardian Facet  | [0xbBC90E685C4a66EBBDC71a3A1437d3111e43Fe84](https:///www.snowscan.xyz/address/0xbBC90E685C4a66EBBDC71a3A1437d3111e43Fe84) |
+| Swapper Facet          | [0x57265a3D7db8f4a4a155eadF6c7326926caC1490](https:///www.snowscan.xyz/address/0x57265a3D7db8f4a4a155eadF6c7326926caC1490) |
+| Parallelizer USDp      | [0x41d58951cbd12D4Ef49b0437897677bbF5547C80](https:///www.snowscan.xyz/address/0x41d58951cbd12D4Ef49b0437897677bbF5547C80) |
+| sUSDp (Savings)        | [0x9d92c21205383651610f90722131655a5b8ed3e0](https:///www.snowscan.xyz/address/0x9d92c21205383651610f90722131655a5b8ed3e0) |
 | GenericRebalancer USDp | [0x0d45b129dc868963025db79a9074ea9c9e32cae4](https:///www.snowscan.xyz/address/0x0d45b129dc868963025db79a9074ea9c9e32cae4) |
 
 ### Testnet