feat!: ts eModes exports (#629)

BREAKING CHANGE: The eMode exports on the js side now contain the full eMode configuration with the decoded bitmaps. Abis are exported via /abis to no longer mix with the addresses. Removing tokenlist from ts exports as there's no good reason to use it from here (integrations work with the toplevel json)

Author: sakulstra

README.md

@@ -62,7 +62,7 @@ import { AaveV2Avalanche } from "@bgd-labs/aave-address-book"; // import specifi
 console.log(AaveV2Avalanche.POOL_ADDRESSES_PROVIDER);
 // "0xa97684ead0e402dC232d5A977953DF7ECBaB3CDb"
 
-// in addition the chainId of the respecitve addresses is exported alongside
+// in addition the chainId of the respective addresses is exported alongside
 console.log(AaveV2Avalanche.CHAIN_ID);
 // 43114
 ```
@@ -106,3 +106,11 @@ b) Adding an address that **cannot be obtained via onchain calls** so it needs t
 To achieve an addition here, you need to alter the [additionalAddresses section](https://github.com/bgd-labs/aave-address-book/blob/main/scripts/config.ts#L46) on the pool type and add your address to the respective pools. Additional addresses will currently be exported as type `address`. There's currently no possibility to define a custom type.
 
 In any case you need to run `yarn generate:addresses` afterwards and commit the altered artifacts.
+
+### Troubleshooting
+
+#### Error generating the addresses
+
+This repository will try to use public rpcs.
+For some networks they are not very reliable though, therefore you can set `RPC_<NETWORK>` in your .env to use a private rpc.
+Check https://github.com/bgd-labs/aave-address-book/blob/main/scripts/clients.ts#L39 for the chain naming convention.

package.json

@@ -25,6 +25,18 @@
       },
       "types": "./dist/AaveAddressBook.d.ts",
       "default": "./dist/AaveAddressBook.js"
+    },
+    "./abis": {
+      "require": {
+        "types": "./dist/abis/index.d.ts",
+        "default": "./dist/abis/index.js"
+      },
+      "import": {
+        "types": "./dist/abis/index.mts",
+        "default": "./dist/abis/index.mjs"
+      },
+      "types": "./dist/abis/index.d.ts",
+      "default": "./dist/abis/index.js"
     }
   },
   "sideEffects": false,
@@ -52,7 +64,7 @@
   "homepage": "https://github.com/bgd-labs/aave-address-book#readme",
   "devDependencies": {
     "@bgd-labs/js-utils": "1.4.2",
-    "@bgd-labs/react-web3-icons": "^1.4.4",
+    "@bgd-labs/react-web3-icons": "^1.5.3",
     "@types/node": "^22.4.1",
     "@uniswap/token-lists": "^1.0.0-beta.33",
     "ajv": "^8.12.0",

safe.csv

@@ -0,0 +1,13 @@
+import * as addressBook from '../../src/ts/AaveAddressBook';
+
+export function getGovernance(chainId: number) {
+  for (const [name, lib] of Object.entries(addressBook)) {
+    if (name.startsWith('GovernanceV3') && lib.CHAIN_ID === chainId) return lib;
+  }
+}
+
+export function getMisc(chainId: number) {
+  for (const [name, lib] of Object.entries(addressBook)) {
+    if (name.startsWith('Misc') && lib.CHAIN_ID === chainId) return lib;
+  }
+}

scripts/checks/utils.ts

@@ -0,0 +1,33 @@
+import {getContract} from 'viem';
+import {CHAIN_ID_CLIENT_MAP} from '../clients';
+import {IOwnable_ABI} from '../../src/ts/abis/IOwnable';
+import {getGovernance} from './utils';
+
+export async function check(addresses: Record<string, any>) {
+  if (addresses.WETH_GATEWAY) {
+    const client = CHAIN_ID_CLIENT_MAP[addresses.CHAIN_ID];
+    // on testnets owners are usually not governance
+    if (!client.chain?.testnet) {
+      const gateway = getContract({
+        abi: IOwnable_ABI,
+        address: addresses.WETH_GATEWAY,
+        client,
+      });
+      const owner = await gateway.read.owner();
+      const governance = getGovernance(addresses.CHAIN_ID);
+      if (!governance) {
+        console.log(
+          'SANITY_GATEWAY: Skipped due to missing governance on chainId: ${addresses.CHAIN_ID}',
+        );
+      } else {
+        const l1Executor = (governance as any).EXECUTOR_LVL_1;
+        // prettier would be to check against executor lvl_1
+        if (owner !== l1Executor) {
+          throw new Error(
+            `SANITY_GATEWAY: OWNER MISMATCH ${addresses.POOL}.${addresses.WETH_GATEWAY}:${owner} != ${l1Executor}`,
+          );
+        }
+      }
+    }
+  }
+}

scripts/checks/wethGateway.ts

@@ -21,6 +21,7 @@ export const ABI_INTERFACES = [
   'IAToken',
   'IDefaultInterestRateStrategy',
   'lib/aave-v3-origin/src/contracts/interfaces/IAaveOracle.sol:IAaveOracle',
+  'lib/aave-v3-origin/src/contracts/rewards/interfaces/IRewardsController.sol:IRewardsController',
   'IExecutor',
   'ICrossChainController',
   'IWithGuardian',
@@ -35,6 +36,7 @@ export const ABI_INTERFACES = [
   'IStakeToken',
   'IStataTokenFactory',
   'IStataTokenV2',
+  'lib/aave-v3-origin/src/contracts/helpers/interfaces/IWrappedTokenGatewayV3.sol:IWrappedTokenGatewayV3',
 ];
 
 /**

scripts/configs/abis.ts

@@ -81,6 +81,7 @@ export type ReserveData = {
   symbol: string;
   UNDERLYING: Hex;
   decimals: number;
+  id: number;
   A_TOKEN: Hex;
   V_TOKEN: Hex;
   INTEREST_RATE_STRATEGY: Hex;
@@ -89,6 +90,15 @@ export type ReserveData = {
   STATA_TOKEN?: Hex;
 };
 
+export type EMode = {
+  label: string;
+  ltv: number;
+  liquidationThreshold: number;
+  liquidationBonus: number;
+  collateralBitmap: bigint;
+  borrowableBitmap: bigint;
+};
+
 /**
  * @dev config for addresses that belong more to a network then to a specific pool
  */

scripts/configs/types.ts

@@ -15,7 +15,6 @@ export async function generateABIs(removeExisting: boolean) {
   } else {
     mkdirSync('./src/ts/abis');
   }
-  const imports: string[] = [];
   for (const INTERFACE_PATH of ABI_INTERFACES) {
     const {stdout, stderr} = await awaitableExec(`forge inspect ${INTERFACE_PATH} abi`);
     const INTERFACE =

scripts/generateABIs.ts

@@ -163,6 +163,8 @@ async function main() {
 
   const abis = generateABIImports();
 
+  writeFileSync('./src/ts/abis/index.ts', abis.join('\n'));
+
   const imports = [
     governanceNames,
     v1Library,
@@ -172,7 +174,6 @@ async function main() {
     govImports,
     smImports,
     tokenListImports,
-    abis,
   ].flat();
 
   const jsExports = imports.map((f) => f.js).flat();

scripts/generateAddresses.ts

@@ -6,14 +6,11 @@ export function generateABIImports() {
     const INTERFACE =
       INTERFACE_PATH.split(':').length > 1 ? INTERFACE_PATH.split(':')[1] : INTERFACE_PATH;
     const varName = `${INTERFACE}_ABI`;
-    jsExports.push(`export {${varName}} from './abis/${INTERFACE}';`);
+    jsExports.push(`export {${varName}} from './${INTERFACE}';`);
   }
   for (const INTERFACE of DOWNLOAD_ABI_INTERFACES) {
     const varName = `${INTERFACE.name}_ABI`;
-    jsExports.push(`export {${varName}} from './abis/${INTERFACE.name}';`);
+    jsExports.push(`export {${varName}} from './${INTERFACE.name}';`);
   }
-  return {
-    solidity: [],
-    js: jsExports,
-  };
+  return jsExports;
 }