[Aavechan] lbtc onboarding (#562)

* feat: onboard LBTC

* fix cap and bump block height

* Update src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance.md

Co-authored-by: Harsh Pandey <[email protected]>

* Update src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance.md

Co-authored-by: Harsh Pandey <[email protected]>

* Update src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/config.ts

Co-authored-by: Harsh Pandey <[email protected]>

* Update src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223.sol

Co-authored-by: Ian Flexa <[email protected]>

* Update src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance.md

Co-authored-by: Ian Flexa <[email protected]>

* typo in assetListing.ts

---------

Co-authored-by: Harsh Pandey <[email protected]>
Co-authored-by: Ian Flexa <[email protected]>

diffs/AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223_before_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223_after.md

@@ -0,0 +1,152 @@
+## Reserve changes
+
+### Reserves added
+
+#### LBTC ([0x8236a87084f8B84306f72007F36F2618A5634494](https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494))
+
+| description | value |
+| --- | --- |
+| decimals | 8 |
+| isActive | true |
+| isFrozen | false |
+| supplyCap | 800 LBTC |
+| borrowCap | 80 LBTC |
+| debtCeiling | 0 $ [0] |
+| isSiloed | false |
+| isFlashloanable | true |
+| oracle | [0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c](https://etherscan.io/address/0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c) |
+| oracleDecimals | 8 |
+| oracleDescription | BTC / USD |
+| oracleLatestAnswer | 102127.88158314 |
+| usageAsCollateralEnabled | true |
+| ltv | 70 % [7000] |
+| liquidationThreshold | 75 % [7500] |
+| liquidationBonus | 8.5 % |
+| liquidationProtocolFee | 10 % [1000] |
+| reserveFactor | 50 % [5000] |
+| aToken | [0x65906988ADEe75306021C417a1A3458040239602](https://etherscan.io/address/0x65906988ADEe75306021C417a1A3458040239602) |
+| aTokenImpl | [0x7EfFD7b47Bfd17e52fB7559d3f924201b9DbfF3d](https://etherscan.io/address/0x7EfFD7b47Bfd17e52fB7559d3f924201b9DbfF3d) |
+| variableDebtToken | [0x68aeB290C7727D899B47c56d1c96AEAC475cD0dD](https://etherscan.io/address/0x68aeB290C7727D899B47c56d1c96AEAC475cD0dD) |
+| variableDebtTokenImpl | [0xaC725CB59D16C81061BDeA61041a8A5e73DA9EC6](https://etherscan.io/address/0xaC725CB59D16C81061BDeA61041a8A5e73DA9EC6) |
+| borrowingEnabled | true |
+| isBorrowableInIsolation | false |
+| interestRateStrategy | [0x9ec6F08190DeA04A54f8Afc53Db96134e5E3FdFB](https://etherscan.io/address/0x9ec6F08190DeA04A54f8Afc53Db96134e5E3FdFB) |
+| aTokenName | Aave Ethereum LBTC |
+| aTokenSymbol | aEthLBTC |
+| aTokenUnderlyingBalance | 0.001 LBTC [100000] |
+| id | 37 |
+| isPaused | false |
+| variableDebtTokenName | Aave Ethereum Variable Debt LBTC |
+| variableDebtTokenSymbol | variableDebtEthLBTC |
+| virtualAccountingActive | true |
+| virtualBalance | 0.001 LBTC [100000] |
+| optimalUsageRatio | 45 % |
+| maxVariableBorrowRate | 304 % |
+| baseVariableBorrowRate | 0 % |
+| variableRateSlope1 | 4 % |
+| variableRateSlope2 | 300 % |
+| interestRate | ![ir](https://dash.onaave.com/api/static?variableRateSlope1=40000000000000000000000000&variableRateSlope2=3000000000000000000000000000&optimalUsageRatio=450000000000000000000000000&baseVariableBorrowRate=0&maxVariableBorrowRate=3040000000000000000000000000) |
+
+
+## Emodes changed
+
+### EMode: ETH correlated(id: 1)
+
+
+
+### EMode: sUSDe Stablecoins(id: 2)
+
+
+
+### EMode: rsETH LST main(id: 3)
+
+
+
+### EMode: LBTC / WBTC(id: 4)
+
+| description | value before | value after |
+| --- | --- | --- |
+| eMode.label | - | LBTC / WBTC |
+| eMode.ltv | - | 84 % |
+| eMode.liquidationThreshold | - | 86 % |
+| eMode.liquidationBonus | - | 3 % |
+| eMode.borrowableBitmap | - | WBTC |
+| eMode.collateralBitmap | - | LBTC |
+
+
+## Raw diff
+
+```json
+{
+  "eModes": {
+    "4": {
+      "from": null,
+      "to": {
+        "borrowableBitmap": "4",
+        "collateralBitmap": "137438953472",
+        "eModeCategory": 4,
+        "label": "LBTC / WBTC",
+        "liquidationBonus": 10300,
+        "liquidationThreshold": 8600,
+        "ltv": 8400
+      }
+    }
+  },
+  "reserves": {
+    "0x8236a87084f8B84306f72007F36F2618A5634494": {
+      "from": null,
+      "to": {
+        "aToken": "0x65906988ADEe75306021C417a1A3458040239602",
+        "aTokenImpl": "0x7EfFD7b47Bfd17e52fB7559d3f924201b9DbfF3d",
+        "aTokenName": "Aave Ethereum LBTC",
+        "aTokenSymbol": "aEthLBTC",
+        "aTokenUnderlyingBalance": "100000",
+        "borrowCap": 80,
+        "borrowingEnabled": true,
+        "debtCeiling": 0,
+        "decimals": 8,
+        "id": 37,
+        "interestRateStrategy": "0x9ec6F08190DeA04A54f8Afc53Db96134e5E3FdFB",
+        "isActive": true,
+        "isBorrowableInIsolation": false,
+        "isFlashloanable": true,
+        "isFrozen": false,
+        "isPaused": false,
+        "isSiloed": false,
+        "liquidationBonus": 10850,
+        "liquidationProtocolFee": 1000,
+        "liquidationThreshold": 7500,
+        "ltv": 7000,
+        "oracle": "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c",
+        "oracleDecimals": 8,
+        "oracleDescription": "BTC / USD",
+        "oracleLatestAnswer": "10212788158314",
+        "reserveFactor": 5000,
+        "supplyCap": 800,
+        "symbol": "LBTC",
+        "underlying": "0x8236a87084f8B84306f72007F36F2618A5634494",
+        "usageAsCollateralEnabled": true,
+        "variableDebtToken": "0x68aeB290C7727D899B47c56d1c96AEAC475cD0dD",
+        "variableDebtTokenImpl": "0xaC725CB59D16C81061BDeA61041a8A5e73DA9EC6",
+        "variableDebtTokenName": "Aave Ethereum Variable Debt LBTC",
+        "variableDebtTokenSymbol": "variableDebtEthLBTC",
+        "virtualAccountingActive": true,
+        "virtualBalance": "100000"
+      }
+    }
+  },
+  "strategies": {
+    "0x8236a87084f8B84306f72007F36F2618A5634494": {
+      "from": null,
+      "to": {
+        "address": "0x9ec6F08190DeA04A54f8Afc53Db96134e5E3FdFB",
+        "baseVariableBorrowRate": "0",
+        "maxVariableBorrowRate": "3040000000000000000000000000",
+        "optimalUsageRatio": "450000000000000000000000000",
+        "variableRateSlope1": "40000000000000000000000000",
+        "variableRateSlope2": "3000000000000000000000000000"
+      }
+    }
+  }
+}
+```

generator/features/assetListing.ts

@@ -201,7 +201,7 @@ export const assetListing: FeatureModule<Listing[]> = {
           listingTemplate += `| Borrowable in Isolation | ${cfg.borrowableInIsolation} |\n`;
           listingTemplate += `| Oracle | ${cfg.priceFeed} |\n`;
           if (isAddress(cfg.admin)) {
-            listingTemplate += `\nAdditionaly [${cfg.admin}](${getExplorerLink(CHAIN_TO_CHAIN_ID[getPoolChain(pool)], cfg.admin)}) has been set as the emission admin for ${cfg.assetSymbol} and the corresponding aToken.\n`;
+            listingTemplate += `\nAdditionally [${cfg.admin}](${getExplorerLink(CHAIN_TO_CHAIN_ID[getPoolChain(pool)], cfg.admin)}) has been set as the emission admin for ${cfg.assetSymbol} and the corresponding aToken.\n`;
           }
           return listingTemplate;
         }),

src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223.sol

@@ -0,0 +1,109 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AaveV3Ethereum, AaveV3EthereumAssets} from 'aave-address-book/AaveV3Ethereum.sol';
+import {AaveV3PayloadEthereum} from 'aave-helpers/src/v3-config-engine/AaveV3PayloadEthereum.sol';
+import {EngineFlags} from 'aave-v3-origin/contracts/extensions/v3-config-engine/EngineFlags.sol';
+import {IAaveV3ConfigEngine} from 'aave-v3-origin/contracts/extensions/v3-config-engine/IAaveV3ConfigEngine.sol';
+import {IERC20} from 'solidity-utils/contracts/oz-common/interfaces/IERC20.sol';
+import {SafeERC20} from 'solidity-utils/contracts/oz-common/SafeERC20.sol';
+import {IEmissionManager} from 'aave-v3-origin/contracts/rewards/interfaces/IEmissionManager.sol';
+/**
+ * @title Onboard LBTC & Enable LBTC/WBTC liquid E-Mode on Aave v3 Core Instance
+ * @author Aave Chan Initiative
+ * - Snapshot: https://snapshot.box/#/s:aave.eth/proposal/0x61f027ea797763c9e01736693570141a27a0a5d4517a6b63d0fd84474e8be995
+ * - Discussion: https://governance.aave.com/t/arfc-enable-lbtc-wbtc-liquid-e-mode-on-aave-v3-core-instance/20142
+ */
+contract AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223 is
+  AaveV3PayloadEthereum
+{
+  using SafeERC20 for IERC20;
+
+  address public constant LBTC = 0x8236a87084f8B84306f72007F36F2618A5634494;
+  uint256 public constant LBTC_SEED_AMOUNT = 1e5;
+  address public constant LBTC_LM_ADMIN = 0xac140648435d03f784879cd789130F22Ef588Fcd;
+
+  function _postExecute() internal override {
+    IERC20(LBTC).forceApprove(address(AaveV3Ethereum.POOL), LBTC_SEED_AMOUNT);
+    AaveV3Ethereum.POOL.supply(LBTC, LBTC_SEED_AMOUNT, address(AaveV3Ethereum.COLLECTOR), 0);
+
+    (address aLBTC, , ) = AaveV3Ethereum.AAVE_PROTOCOL_DATA_PROVIDER.getReserveTokensAddresses(
+      LBTC
+    );
+    IEmissionManager(AaveV3Ethereum.EMISSION_MANAGER).setEmissionAdmin(LBTC, LBTC_LM_ADMIN);
+    IEmissionManager(AaveV3Ethereum.EMISSION_MANAGER).setEmissionAdmin(aLBTC, LBTC_LM_ADMIN);
+  }
+
+  function eModeCategoriesUpdates()
+    public
+    pure
+    override
+    returns (IAaveV3ConfigEngine.EModeCategoryUpdate[] memory)
+  {
+    IAaveV3ConfigEngine.EModeCategoryUpdate[]
+      memory eModeUpdates = new IAaveV3ConfigEngine.EModeCategoryUpdate[](1);
+
+    eModeUpdates[0] = IAaveV3ConfigEngine.EModeCategoryUpdate({
+      eModeCategory: 4,
+      ltv: 84_00,
+      liqThreshold: 86_00,
+      liqBonus: 3_00,
+      label: 'LBTC / WBTC'
+    });
+
+    return eModeUpdates;
+  }
+  function assetsEModeUpdates()
+    public
+    pure
+    override
+    returns (IAaveV3ConfigEngine.AssetEModeUpdate[] memory)
+  {
+    IAaveV3ConfigEngine.AssetEModeUpdate[]
+      memory assetEModeUpdates = new IAaveV3ConfigEngine.AssetEModeUpdate[](2);
+
+    assetEModeUpdates[0] = IAaveV3ConfigEngine.AssetEModeUpdate({
+      asset: LBTC,
+      eModeCategory: 4,
+      borrowable: EngineFlags.DISABLED,
+      collateral: EngineFlags.ENABLED
+    });
+    assetEModeUpdates[1] = IAaveV3ConfigEngine.AssetEModeUpdate({
+      asset: AaveV3EthereumAssets.WBTC_UNDERLYING,
+      eModeCategory: 4,
+      borrowable: EngineFlags.ENABLED,
+      collateral: EngineFlags.DISABLED
+    });
+
+    return assetEModeUpdates;
+  }
+  function newListings() public pure override returns (IAaveV3ConfigEngine.Listing[] memory) {
+    IAaveV3ConfigEngine.Listing[] memory listings = new IAaveV3ConfigEngine.Listing[](1);
+
+    listings[0] = IAaveV3ConfigEngine.Listing({
+      asset: LBTC,
+      assetSymbol: 'LBTC',
+      priceFeed: 0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c,
+      enabledToBorrow: EngineFlags.ENABLED,
+      borrowableInIsolation: EngineFlags.DISABLED,
+      withSiloedBorrowing: EngineFlags.DISABLED,
+      flashloanable: EngineFlags.ENABLED,
+      ltv: 70_00,
+      liqThreshold: 75_00,
+      liqBonus: 8_50,
+      reserveFactor: 50_00,
+      supplyCap: 800,
+      borrowCap: 80,
+      debtCeiling: 0,
+      liqProtocolFee: 10_00,
+      rateStrategyParams: IAaveV3ConfigEngine.InterestRateInputData({
+        optimalUsageRatio: 45_00,
+        baseVariableBorrowRate: 0,
+        variableRateSlope1: 4_00,
+        variableRateSlope2: 300_00
+      })
+    });
+
+    return listings;
+  }
+}

src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223.t.sol

@@ -0,0 +1,60 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {GovV3Helpers} from 'aave-helpers/src/GovV3Helpers.sol';
+import {AaveV3Ethereum} from 'aave-address-book/AaveV3Ethereum.sol';
+import {IERC20} from 'solidity-utils/contracts/oz-common/interfaces/IERC20.sol';
+import {IEmissionManager} from 'aave-v3-origin/contracts/rewards/interfaces/IEmissionManager.sol';
+
+import 'forge-std/Test.sol';
+import {ProtocolV3TestBase, ReserveConfig} from 'aave-helpers/src/ProtocolV3TestBase.sol';
+import {AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223} from './AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223.sol';
+
+/**
+ * @dev Test for AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223
+ * command: FOUNDRY_PROFILE=mainnet forge test --match-path=src/20241223_AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance/AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223.t.sol -vv
+ */
+contract AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223_Test is
+  ProtocolV3TestBase
+{
+  AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223 internal proposal;
+
+  function setUp() public {
+    vm.createSelectFork(vm.rpcUrl('mainnet'), 21567986);
+    proposal = new AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223();
+  }
+
+  /**
+   * @dev executes the generic test suite including e2e and config snapshots
+   */
+  function test_defaultProposalExecution() public {
+    defaultTest(
+      'AaveV3Ethereum_EnableLBTCWBTCLiquidEModeOnAavev3CoreInstance_20241223',
+      AaveV3Ethereum.POOL,
+      address(proposal)
+    );
+  }
+
+  function test_collectorHasLBTCFunds() public {
+    GovV3Helpers.executePayload(vm, address(proposal));
+    (address aTokenAddress, , ) = AaveV3Ethereum
+      .AAVE_PROTOCOL_DATA_PROVIDER
+      .getReserveTokensAddresses(proposal.LBTC());
+    assertGe(IERC20(aTokenAddress).balanceOf(address(AaveV3Ethereum.COLLECTOR)), 10 ** 5);
+  }
+
+  function test_LBTCAdmin() public {
+    GovV3Helpers.executePayload(vm, address(proposal));
+    (address aLBTC, , ) = AaveV3Ethereum.AAVE_PROTOCOL_DATA_PROVIDER.getReserveTokensAddresses(
+      proposal.LBTC()
+    );
+    assertEq(
+      IEmissionManager(AaveV3Ethereum.EMISSION_MANAGER).getEmissionAdmin(proposal.LBTC()),
+      proposal.LBTC_LM_ADMIN()
+    );
+    assertEq(
+      IEmissionManager(AaveV3Ethereum.EMISSION_MANAGER).getEmissionAdmin(aLBTC),
+      proposal.LBTC_LM_ADMIN()
+    );
+  }
+}