@1delta/data-sdk 0.0.17 → 0.0.19

package/README.md

@@ -0,0 +1,658 @@
+# @1delta/data-sdk
+
+Global registry for lending protocol deployments, chain metadata, and token lists. Provides getters to access pool configurations, reserve lists, oracle addresses, and protocol-specific contract addresses across all supported chains and lending protocol forks.
+
+## Installation
+
+```bash
+pnpm add @1delta/data-sdk
+```
+
+## Overview
+
+The SDK is a **read-only data layer** organized into three modules:
+
+| Module | Description |
+|--------|-------------|
+| **Lending** | Pool configs, reserves, tokens, oracles for all lending protocols |
+| **Chains** | Chain metadata (RPC endpoints, explorers, native currency) |
+| **Tokens** | Token lists per chain (fetched from remote) |
+
+All data is stored in a global registry (`globalThis`) so it's shared across module instances. Data is populated once via `initializeLenderData()` / `initializeChainData()` (typically called by `@1delta/initializer-sdk`) and then accessed through getter functions.
+
+---
+
+## Initialization
+
+Data must be initialized before use. This is typically handled by `@1delta/initializer-sdk`:
+
+```ts
+import { fetchLenderMetaFromDirAndInitializeAll } from '@1delta/initializer-sdk'
+
+// Loads all deployment data from the lender-metadata repo
+await fetchLenderMetaFromDirAndInitializeAll()
+```
+
+Or initialize directly with custom data:
+
+```ts
+import { initializeLenderData, initializeChainData } from '@1delta/data-sdk'
+
+initializeLenderData({
+  aavePoolsOverride: myAavePools,
+  compoundV2PoolsOverride: myCompoundPools,
+  // ... other overrides
+})
+
+initializeChainData({
+  chainsOverride: myChainInfo,
+})
+```
+
+---
+
+## Lending Data
+
+All lending getters are synchronous and return data from the global registry.
+
+### Aave (V2 / V3 / all forks)
+
+Covers: AAVE_V3, SPARK, LENDLE, ZEROLEND, AVALON, RADIANT_V2, KINZA, YLDR, and 70+ other forks.
+
+#### `aavePools()`
+
+Pool and data provider addresses per fork per chain.
+
+```ts
+import { aavePools } from '@1delta/data-sdk'
+
+const pools = aavePools()
+// {
+//   AAVE_V3: {
+//     '1': { pool: '0x87870...', protocolDataProvider: '0x7B4E...' },
+//     '56': { pool: '0x6807...', protocolDataProvider: '0x23dF...' },
+//   },
+//   SPARK: {
+//     '1': { pool: '0xC13e...', protocolDataProvider: '0xFc21...' },
+//   },
+//   ZEROLEND: { ... },
+//   ...
+// }
+
+// Type: { [fork: string]: { [chainId: string]: { pool: string; protocolDataProvider: string } } }
+```
+
+#### `aaveReserves()`
+
+List of underlying asset addresses per fork per chain.
+
+```ts
+import { aaveReserves } from '@1delta/data-sdk'
+
+const reserves = aaveReserves()
+// {
+//   AAVE_V3: {
+//     '1': ['0xC02a...', '0x6B17...', '0xdAC1...'],  // WETH, DAI, USDT, ...
+//     '56': ['0xbb4C...', '0x55d3...'],
+//   },
+//   ...
+// }
+
+// Type: { [fork: string]: { [chainId: string]: string[] } }
+```
+
+#### `aaveTokens()`
+
+Mapping of underlying assets to their aToken, sToken, and vToken addresses.
+
+```ts
+import { aaveTokens } from '@1delta/data-sdk'
+
+const tokens = aaveTokens()
+// {
+//   AAVE_V3: {
+//     '1': {
+//       '0xC02a...': {          // WETH underlying
+//         aToken: '0x4d5F...',
+//         sToken: '0x102e...',
+//         vToken: '0xeA51...',
+//       },
+//       ...
+//     },
+//   },
+// }
+
+// Type: { [fork: string]: { [chainId: string]: { [underlying: string]: { aToken: string; sToken: string; vToken: string } } } }
+```
+
+#### `aaveOracles()`
+
+Price oracle addresses per fork per chain.
+
+```ts
+import { aaveOracles } from '@1delta/data-sdk'
+
+const oracles = aaveOracles()
+// { AAVE_V3: { '1': '0x54586...', '56': '0x6970...' }, ... }
+
+// Type: { [lender: string]: { [chainId: string]: string } }
+```
+
+#### `aaveWethGateway()`
+
+WETH gateway contract addresses for native asset wrapping.
+
+```ts
+import { aaveWethGateway } from '@1delta/data-sdk'
+
+const gateways = aaveWethGateway()
+// { AAVE_V3: { '1': '0xD322...' }, SPARK: { '1': '0x...' }, ... }
+
+// Type: { [fork: string]: { [chainId: string]: string } }
+```
+
+---
+
+### Compound V2 (all forks)
+
+Covers: COMPOUND_V2, VENUS (+ pool variants), BENQI, MENDI, MOONWELL, TECTONIC, ENCLABS, and 30+ other forks.
+
+#### `compoundV2Pools()`
+
+Comptroller addresses per fork per chain.
+
+```ts
+import { compoundV2Pools } from '@1delta/data-sdk'
+
+const pools = compoundV2Pools()
+// {
+//   COMPOUND_V2: { '1': '0x3d9819...' },
+//   VENUS: { '56': '0xfD36E2...' },
+//   VENUS_ETH: { '56': '0x...' },
+//   BENQI: { '43114': '0x486Af...' },
+//   ...
+// }
+
+// Type: { [fork: string]: { [chainId: string]: string } }
+```
+
+#### `compoundV2Reserves()`
+
+Reserve asset addresses per fork per chain.
+
+```ts
+import { compoundV2Reserves } from '@1delta/data-sdk'
+
+const reserves = compoundV2Reserves()
+// { VENUS: { '56': ['0xbb4C...', '0x55d3...'] }, ... }
+
+// Type: { [fork: string]: { [chainId: string]: string[] } }
+```
+
+#### `compoundV2TokenArray()`
+
+cToken to underlying mapping as an array (preferred for iteration).
+
+```ts
+import { compoundV2TokenArray } from '@1delta/data-sdk'
+
+const tokenArray = compoundV2TokenArray()
+// {
+//   VENUS: {
+//     '56': [
+//       { cToken: '0xA07c5b74...', underlying: '0xbb4CdB9C...' },
+//       { cToken: '0xecA88125...', underlying: '0x55d398326...' },
+//     ],
+//   },
+// }
+
+// Type: { [lender: string]: { [chainId: string]: Array<{ cToken: string; underlying: string }> } }
+```
+
+#### `compoundV2Tokens()`
+
+cToken address mapping (keyed by address).
+
+```ts
+import { compoundV2Tokens } from '@1delta/data-sdk'
+
+const tokens = compoundV2Tokens()
+// { VENUS: { '56': { '0xA07c5b74...': '0xbb4CdB9C...' } } }
+
+// Type: { [lender: string]: { [chainId: string]: { [cTokenAddress: string]: string } } }
+```
+
+#### `compoundV2Oracles()`
+
+Oracle addresses per fork per chain.
+
+```ts
+import { compoundV2Oracles } from '@1delta/data-sdk'
+
+const oracles = compoundV2Oracles()
+// { VENUS: { '56': '0xd8B6dA...' }, ... }
+
+// Type: { [lender: string]: { [chainId: string]: string } }
+```
+
+---
+
+### Compound V3 (Comet)
+
+Covers: COMPOUND_V3_USDC, COMPOUND_V3_USDT, COMPOUND_V3_WETH, COMPOUND_V3_WSTETH, and other Comet markets.
+
+#### `compoundV3Pools()`
+
+Comet proxy addresses. Note: keyed by `chainId` first, then by comet/lender name.
+
+```ts
+import { compoundV3Pools } from '@1delta/data-sdk'
+
+const pools = compoundV3Pools()
+// {
+//   '1': {
+//     'COMPOUND_V3_USDC': '0xc3d688...',
+//     'COMPOUND_V3_WETH': '0xA17581...',
+//   },
+//   '42161': {
+//     'COMPOUND_V3_USDC': '0xA5EDBDD...',
+//   },
+// }
+
+// Type: { [chainId: string]: { [comet: string]: string } }
+```
+
+#### `compoundV3BaseData()`
+
+Base asset and minimum borrow amount per Comet market.
+
+```ts
+import { compoundV3BaseData } from '@1delta/data-sdk'
+
+const baseData = compoundV3BaseData()
+// {
+//   COMPOUND_V3_USDC: {
+//     '1': { baseAsset: '0xA0b86991...', baseBorrowMin: 100000000n },
+//   },
+// }
+
+// Type: { [lender: string]: { [chainId: string]: { baseAsset: string; baseBorrowMin: bigint } } }
+```
+
+#### `compoundV3Reserves()`
+
+Collateral asset addresses per Comet market.
+
+```ts
+import { compoundV3Reserves } from '@1delta/data-sdk'
+
+const reserves = compoundV3Reserves()
+// { COMPOUND_V3_USDC: { '1': ['0xC02a...', '0x2260...'] }, ... }
+
+// Type: { [fork: string]: { [chainId: string]: string[] } }
+```
+
+#### `compoundV3OraclesData()`
+
+Per-asset oracle addresses and descriptions for Comet markets.
+
+```ts
+import { compoundV3OraclesData } from '@1delta/data-sdk'
+
+const oracles = compoundV3OraclesData()
+// {
+//   COMPOUND_V3_USDC: {
+//     '1': {
+//       '0xC02a...': { oracle: '0x5f4eC3...', description: 'ETH / USD' },
+//       '0x2260...': { oracle: '0xF4030...', description: 'BTC / USD' },
+//     },
+//   },
+// }
+
+// Type: { [lender: string]: { [chainId: string]: { [assetAddress: string]: { oracle: string; description: string } } } }
+```
+
+#### `compoundV3Bulker()`
+
+Bulker contract addresses for batched Comet operations.
+
+```ts
+import { compoundV3Bulker } from '@1delta/data-sdk'
+
+const bulkers = compoundV3Bulker()
+// { COMPOUND_V3_USDC: { '1': '0xa397...' }, ... }
+
+// Type: { [lender: string]: { [chainId: string]: string } }
+```
+
+---
+
+### Morpho Blue
+
+Covers: MORPHO_BLUE, LISTA_DAO.
+
+#### `morphoPools()`
+
+Morpho Blue singleton contract addresses.
+
+```ts
+import { morphoPools } from '@1delta/data-sdk'
+
+const pools = morphoPools()
+// {
+//   MORPHO_BLUE: { '1': '0xBBBBBbb...', '8453': '0xBBBBBbb...' },
+//   LISTA_DAO: { '56': '0x...' },
+// }
+
+// Type: { [fork: string]: { [chainId: string]: string } }
+```
+
+#### `morphoTypeMarkets()`
+
+Market IDs (hashes) per protocol per chain.
+
+```ts
+import { morphoTypeMarkets } from '@1delta/data-sdk'
+
+const markets = morphoTypeMarkets()
+// {
+//   MORPHO_BLUE: {
+//     '1': ['0xb323495f...', '0xc54d7ac...', ...],
+//     '8453': ['0x1234...', ...],
+//   },
+//   LISTA_DAO: {
+//     '56': ['0xabcd...', ...],
+//   },
+// }
+
+// Type: { [protocol: string]: { [chainId: string]: string[] } }
+```
+
+#### `morphoOracles()`
+
+Oracle info per market (keyed by market hash or chain).
+
+```ts
+import { morphoOracles } from '@1delta/data-sdk'
+
+const oracles = morphoOracles()
+// {
+//   '0xb323495f...': [{
+//     oracle: '0x...',
+//     loanAsset: '0xA0b8...',
+//     collateralAsset: '0xC02a...',
+//     loanAssetDecimals: 6,
+//     collateralAssetDecimals: 18,
+//   }],
+// }
+
+// Type: { [key: string]: MrophoOracleInfo[] }
+```
+
+#### `morphoTypeOracles()`
+
+Oracle info grouped by chain then protocol.
+
+```ts
+import { morphoTypeOracles } from '@1delta/data-sdk'
+
+const oracles = morphoTypeOracles()
+// {
+//   '1': {
+//     'MORPHO_BLUE': [{ oracle, loanAsset, collateralAsset, ... }],
+//   },
+// }
+
+// Type: { [chainId: string]: { [protocol: string]: MrophoOracleInfo[] } }
+```
+
+#### `morphoBundler3()`
+
+Morpho Bundler3 and adapter contract addresses.
+
+```ts
+import { morphoBundler3 } from '@1delta/data-sdk'
+
+const bundlers = morphoBundler3()
+// {
+//   '1': {
+//     bundler3: '0x...',
+//     generalAdapter1: '0x...',
+//     paraswapAdapter: '0x...',
+//     aaveV3CoreMigrationAdapter: '0x...',
+//     // ... other optional adapters
+//   },
+// }
+
+// Type: { [chainId: string]: MorphoBundler3ChainConfig }
+```
+
+---
+
+### Euler V2
+
+#### `eulerConfigs()`
+
+Core Euler V2 infrastructure addresses.
+
+```ts
+import { eulerConfigs } from '@1delta/data-sdk'
+
+const configs = eulerConfigs()
+// {
+//   EULER_V2: {
+//     '1': {
+//       evc: '0x...',
+//       eVaultFactory: '0x...',
+//       protocolConfig: '0x...',
+//       vaultLens: '0x...',
+//       accountLens: '0x...',
+//       oracleLens: '0x...',
+//       irmLens: '0x...',
+//       utilsLens: '0x...',
+//     },
+//   },
+// }
+
+// Type: { [fork: string]: { [chainId: string]: EulerConfigEntry } }
+```
+
+#### `eulerVaults()`
+
+Vault addresses and their underlying assets.
+
+```ts
+import { eulerVaults } from '@1delta/data-sdk'
+
+const vaults = eulerVaults()
+// {
+//   EULER_V2: {
+//     '1': [
+//       { underlying: '0xC02a...', vault: '0x...' },
+//       { underlying: '0xA0b8...', vault: '0x...' },
+//     ],
+//   },
+// }
+
+// Type: { [fork: string]: { [chainId: string]: Array<{ underlying: string; vault: string }> } }
+```
+
+---
+
+### Init Protocol
+
+#### `initConfig()`
+
+Init protocol pool configurations.
+
+```ts
+import { initConfig } from '@1delta/data-sdk'
+
+const config = initConfig()
+// {
+//   INIT: {
+//     '5000': [
+//       { pool: '0x...', underlying: '0x...', modes: [1, 2] },
+//     ],
+//   },
+// }
+
+// Type: { [lender: string]: { [chainId: string]: Array<{ pool: string; underlying: string; modes: number[] }> } }
+```
+
+---
+
+### Lista DAO
+
+#### `listaNativeProvider()`
+
+Lista DAO native asset provider addresses.
+
+```ts
+import { listaNativeProvider } from '@1delta/data-sdk'
+
+const providers = listaNativeProvider()
+// { '56': { nativeProvider: '0x...' } }
+
+// Type: { [chainId: string]: { nativeProvider: string } }
+```
+
+---
+
+## Chain Data
+
+#### `chains()`
+
+Chain metadata for all supported networks.
+
+```ts
+import { chains } from '@1delta/data-sdk'
+
+const allChains = chains()
+// {
+//   '1': {
+//     name: 'Ethereum Mainnet',
+//     chain: 'ETH',
+//     chainId: '1',
+//     rpc: ['https://...'],
+//     nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+//     explorers: [{ name: 'Etherscan', url: 'https://etherscan.io', standard: 'EIP3091' }],
+//     enum: 'ETHEREUM',
+//     ...
+//   },
+//   '56': { name: 'BNB Smart Chain', ... },
+// }
+
+// Type: { [chainId: string]: ChainInfo }
+```
+
+---
+
+## Token Lists
+
+Token data is fetched remotely from `github.com/1delta-DAO/token-lists`.
+
+#### `fetchTokenList(chainId)`
+
+```ts
+import { fetchTokenList } from '@1delta/data-sdk'
+
+const tokens = await fetchTokenList('1')
+// {
+//   '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2': {
+//     chainId: '1',
+//     name: 'Wrapped Ether',
+//     address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+//     symbol: 'WETH',
+//     decimals: 18,
+//     logoURI: 'https://...',
+//     assetGroup: 'ETH',
+//   },
+//   ...
+// }
+
+// Type: { [address: string]: TokenListEntry }
+```
+
+#### `fetchTokenLists(chainIds)`
+
+Batch fetch token lists for multiple chains in parallel.
+
+```ts
+import { fetchTokenLists } from '@1delta/data-sdk'
+
+const lists = await fetchTokenLists(['1', '56', '42161'])
+// { '1': { ... }, '56': { ... }, '42161': { ... } }
+
+// Type: { [chainId: string]: TokenList }
+```
+
+---
+
+## Enumerating All Deployments
+
+A common pattern for iterating over all lender+chain pairs:
+
+```ts
+import { aavePools, compoundV2Pools, compoundV3Pools, morphoPools, eulerConfigs } from '@1delta/data-sdk'
+
+const deployments: { lender: string; chainId: string }[] = []
+
+// Aave forks: [fork] -> [chainId] -> pool config
+for (const [lender, chains] of Object.entries(aavePools() ?? {})) {
+  for (const chainId of Object.keys(chains)) {
+    deployments.push({ lender, chainId })
+  }
+}
+
+// Compound V2 forks: [fork] -> [chainId] -> comptroller
+for (const [lender, chains] of Object.entries(compoundV2Pools() ?? {})) {
+  for (const chainId of Object.keys(chains)) {
+    deployments.push({ lender, chainId })
+  }
+}
+
+// Compound V3: [chainId] -> [comet] -> address (note: different nesting)
+for (const [chainId, comets] of Object.entries(compoundV3Pools() ?? {})) {
+  for (const lender of Object.keys(comets)) {
+    deployments.push({ lender, chainId })
+  }
+}
+
+// Morpho: [fork] -> [chainId] -> singleton address
+for (const [lender, chains] of Object.entries(morphoPools() ?? {})) {
+  for (const chainId of Object.keys(chains)) {
+    deployments.push({ lender, chainId })
+  }
+}
+
+// Euler: [fork] -> [chainId] -> config
+for (const [lender, chains] of Object.entries(eulerConfigs() ?? {})) {
+  for (const chainId of Object.keys(chains)) {
+    deployments.push({ lender, chainId })
+  }
+}
+```
+
+---
+
+## Data Source
+
+All deployment data originates from the `1delta-DAO/lender-metadata` GitHub repository and is loaded at runtime by `@1delta/initializer-sdk`. The data-sdk itself contains no hardcoded deployment data — it only provides the typed getter/setter interface to the global registry.
+
+| Source file | Getter |
+|-------------|--------|
+| `config/aave-pools.json` | `aavePools()` |
+| `config/compound-v2-pools.json` | `compoundV2Pools()` |
+| `config/compound-v3-pools.json` | `compoundV3Pools()` |
+| `config/morpho-pools.json` | `morphoPools()` |
+| `config/euler-configs.json` | `eulerConfigs()` |
+| `config/init-pools.json` | `initConfig()` |
+| `data/aave-reserves.json` | `aaveReserves()` |
+| `data/aave-tokens.json` | `aaveTokens()` |
+| `data/compound-v2-reserves.json` | `compoundV2Reserves()` |
+| `data/compound-v2-c-tokens.json` | `compoundV2Tokens()` |
+| `data/compound-v2-tokens.json` | `compoundV2TokenArray()` |
+| `data/compound-v3-base-data.json` | `compoundV3BaseData()` |
+| `data/compound-v3-reserves.json` | `compoundV3Reserves()` |
+| `data/euler-vaults.json` | `eulerVaults()` |

package/dist/index.js

@@ -28,10 +28,11 @@ globalThis[GLOBAL_LENDER_DATA_KEY] = {
   compoundV3Reserves: {},
   aaveOracles: {},
   compoundV2Oracles: {},
-  compoundV3Oracles: {},
+  compoundV3OraclesData: {},
   morphoOracles: {},
   morphoTypeOracles: {},
   morphoTypeMarkets: {},
+  aaveOraclesConfig: {},
   aaveWethGateway: {},
   morphoBundler3: {},
   listaNativeProvider: {},
@@ -47,7 +48,7 @@ function initializeLenderData({
   aavePoolsOverride,
   aaveOraclesOverride,
   compoundV2OraclesOverride,
-  compoundV3OraclesOverride,
+  compoundV3OraclesDataOverride,
   compoundV3PoolsOverride,
   compoundV3BaseDataOverride,
   morphoPoolsOverride,
@@ -61,6 +62,7 @@ function initializeLenderData({
   morphoOraclesOverride,
   morphoTypeOraclesOverride,
   morphoTypeMarketsOverride,
+  aaveOraclesConfigOverride,
   aaveWethGatewayOverride,
   morphoBundler3Override,
   listaNativeProviderOverride,
@@ -72,7 +74,7 @@ function initializeLenderData({
   if (aaveTokensOverride) data.aaveTokens = aaveTokensOverride;
   if (aaveOraclesOverride) data.aaveOracles = aaveOraclesOverride;
   if (compoundV2OraclesOverride) data.compoundV2Oracles = compoundV2OraclesOverride;
-  if (compoundV3OraclesOverride) data.compoundV3Oracles = compoundV3OraclesOverride;
+  if (compoundV3OraclesDataOverride) data.compoundV3OraclesData = compoundV3OraclesDataOverride;
   if (aavePoolsOverride) data.aavePools = aavePoolsOverride;
   if (compoundV3PoolsOverride) data.compoundV3Pools = compoundV3PoolsOverride;
   if (morphoPoolsOverride) data.morphoPools = morphoPoolsOverride;
@@ -87,6 +89,7 @@ function initializeLenderData({
   if (morphoOraclesOverride) data.morphoOracles = morphoOraclesOverride;
   if (morphoTypeOraclesOverride) data.morphoTypeOracles = morphoTypeOraclesOverride;
   if (morphoTypeMarketsOverride) data.morphoTypeMarkets = morphoTypeMarketsOverride;
+  if (aaveOraclesConfigOverride) data.aaveOraclesConfig = aaveOraclesConfigOverride;
   if (aaveWethGatewayOverride) data.aaveWethGateway = aaveWethGatewayOverride;
   if (morphoBundler3Override) data.morphoBundler3 = morphoBundler3Override;
   if (listaNativeProviderOverride) data.listaNativeProvider = listaNativeProviderOverride;
@@ -98,7 +101,7 @@ var aaveTokens = () => getGlobalData2()?.aaveTokens;
 var aavePools = () => getGlobalData2()?.aavePools;
 var aaveOracles = () => getGlobalData2()?.aaveOracles;
 var compoundV2Oracles = () => getGlobalData2()?.compoundV2Oracles;
-var compoundV3Oracles = () => getGlobalData2()?.compoundV3Oracles;
+var compoundV3OraclesData = () => getGlobalData2()?.compoundV3OraclesData;
 var morphoOracles = () => getGlobalData2()?.morphoOracles;
 var morphoTypeOracles = () => getGlobalData2()?.morphoTypeOracles;
 var morphoTypeMarkets = () => getGlobalData2()?.morphoTypeMarkets;
@@ -112,6 +115,7 @@ var compoundV2Pools = () => getGlobalData2()?.compoundV2Pools;
 var compoundV2Tokens = () => getGlobalData2()?.compoundV2Tokens;
 var compoundV2TokenArray = () => getGlobalData2()?.compoundV2TokenArray;
 var initConfig = () => getGlobalData2()?.initConfig;
+var aaveOraclesConfig = () => getGlobalData2()?.aaveOraclesConfig;
 var aaveWethGateway = () => getGlobalData2()?.aaveWethGateway;
 var morphoBundler3 = () => getGlobalData2()?.morphoBundler3;
 var listaNativeProvider = () => getGlobalData2()?.listaNativeProvider;
@@ -136,6 +140,7 @@ async function fetchTokenLists(chainIds) {
 }
 
 exports.aaveOracles = aaveOracles;
+exports.aaveOraclesConfig = aaveOraclesConfig;
 exports.aavePools = aavePools;
 exports.aaveReserves = aaveReserves;
 exports.aaveTokens = aaveTokens;
@@ -148,7 +153,7 @@ exports.compoundV2TokenArray = compoundV2TokenArray;
 exports.compoundV2Tokens = compoundV2Tokens;
 exports.compoundV3BaseData = compoundV3BaseData;
 exports.compoundV3Bulker = compoundV3Bulker;
-exports.compoundV3Oracles = compoundV3Oracles;
+exports.compoundV3OraclesData = compoundV3OraclesData;
 exports.compoundV3Pools = compoundV3Pools;
 exports.compoundV3Reserves = compoundV3Reserves;
 exports.eulerConfigs = eulerConfigs;

package/dist/index.mjs

@@ -26,10 +26,11 @@ globalThis[GLOBAL_LENDER_DATA_KEY] = {
   compoundV3Reserves: {},
   aaveOracles: {},
   compoundV2Oracles: {},
-  compoundV3Oracles: {},
+  compoundV3OraclesData: {},
   morphoOracles: {},
   morphoTypeOracles: {},
   morphoTypeMarkets: {},
+  aaveOraclesConfig: {},
   aaveWethGateway: {},
   morphoBundler3: {},
   listaNativeProvider: {},
@@ -45,7 +46,7 @@ function initializeLenderData({
   aavePoolsOverride,
   aaveOraclesOverride,
   compoundV2OraclesOverride,
-  compoundV3OraclesOverride,
+  compoundV3OraclesDataOverride,
   compoundV3PoolsOverride,
   compoundV3BaseDataOverride,
   morphoPoolsOverride,
@@ -59,6 +60,7 @@ function initializeLenderData({
   morphoOraclesOverride,
   morphoTypeOraclesOverride,
   morphoTypeMarketsOverride,
+  aaveOraclesConfigOverride,
   aaveWethGatewayOverride,
   morphoBundler3Override,
   listaNativeProviderOverride,
@@ -70,7 +72,7 @@ function initializeLenderData({
   if (aaveTokensOverride) data.aaveTokens = aaveTokensOverride;
   if (aaveOraclesOverride) data.aaveOracles = aaveOraclesOverride;
   if (compoundV2OraclesOverride) data.compoundV2Oracles = compoundV2OraclesOverride;
-  if (compoundV3OraclesOverride) data.compoundV3Oracles = compoundV3OraclesOverride;
+  if (compoundV3OraclesDataOverride) data.compoundV3OraclesData = compoundV3OraclesDataOverride;
   if (aavePoolsOverride) data.aavePools = aavePoolsOverride;
   if (compoundV3PoolsOverride) data.compoundV3Pools = compoundV3PoolsOverride;
   if (morphoPoolsOverride) data.morphoPools = morphoPoolsOverride;
@@ -85,6 +87,7 @@ function initializeLenderData({
   if (morphoOraclesOverride) data.morphoOracles = morphoOraclesOverride;
   if (morphoTypeOraclesOverride) data.morphoTypeOracles = morphoTypeOraclesOverride;
   if (morphoTypeMarketsOverride) data.morphoTypeMarkets = morphoTypeMarketsOverride;
+  if (aaveOraclesConfigOverride) data.aaveOraclesConfig = aaveOraclesConfigOverride;
   if (aaveWethGatewayOverride) data.aaveWethGateway = aaveWethGatewayOverride;
   if (morphoBundler3Override) data.morphoBundler3 = morphoBundler3Override;
   if (listaNativeProviderOverride) data.listaNativeProvider = listaNativeProviderOverride;
@@ -96,7 +99,7 @@ var aaveTokens = () => getGlobalData2()?.aaveTokens;
 var aavePools = () => getGlobalData2()?.aavePools;
 var aaveOracles = () => getGlobalData2()?.aaveOracles;
 var compoundV2Oracles = () => getGlobalData2()?.compoundV2Oracles;
-var compoundV3Oracles = () => getGlobalData2()?.compoundV3Oracles;
+var compoundV3OraclesData = () => getGlobalData2()?.compoundV3OraclesData;
 var morphoOracles = () => getGlobalData2()?.morphoOracles;
 var morphoTypeOracles = () => getGlobalData2()?.morphoTypeOracles;
 var morphoTypeMarkets = () => getGlobalData2()?.morphoTypeMarkets;
@@ -110,6 +113,7 @@ var compoundV2Pools = () => getGlobalData2()?.compoundV2Pools;
 var compoundV2Tokens = () => getGlobalData2()?.compoundV2Tokens;
 var compoundV2TokenArray = () => getGlobalData2()?.compoundV2TokenArray;
 var initConfig = () => getGlobalData2()?.initConfig;
+var aaveOraclesConfig = () => getGlobalData2()?.aaveOraclesConfig;
 var aaveWethGateway = () => getGlobalData2()?.aaveWethGateway;
 var morphoBundler3 = () => getGlobalData2()?.morphoBundler3;
 var listaNativeProvider = () => getGlobalData2()?.listaNativeProvider;
@@ -133,4 +137,4 @@ async function fetchTokenLists(chainIds) {
   return Object.fromEntries(results);
 }
 
-export { aaveOracles, aavePools, aaveReserves, aaveTokens, aaveWethGateway, chains, compoundV2Oracles, compoundV2Pools, compoundV2Reserves, compoundV2TokenArray, compoundV2Tokens, compoundV3BaseData, compoundV3Bulker, compoundV3Oracles, compoundV3Pools, compoundV3Reserves, eulerConfigs, eulerVaults, fetchTokenList, fetchTokenLists, initConfig, initializeChainData, initializeLenderData, listaNativeProvider, morphoBundler3, morphoOracles, morphoPools, morphoTypeMarkets, morphoTypeOracles };
+export { aaveOracles, aaveOraclesConfig, aavePools, aaveReserves, aaveTokens, aaveWethGateway, chains, compoundV2Oracles, compoundV2Pools, compoundV2Reserves, compoundV2TokenArray, compoundV2Tokens, compoundV3BaseData, compoundV3Bulker, compoundV3OraclesData, compoundV3Pools, compoundV3Reserves, eulerConfigs, eulerVaults, fetchTokenList, fetchTokenLists, initConfig, initializeChainData, initializeLenderData, listaNativeProvider, morphoBundler3, morphoOracles, morphoPools, morphoTypeMarkets, morphoTypeOracles };

package/dist/lending.d.ts

@@ -71,10 +71,14 @@ type OracleMap = {
         [chainId: string]: string;
     };
 };
-type OraclePerAssetMap = {
+type CompoundV3OracleEntry = {
+    oracle: string;
+    description: string;
+};
+type CompoundV3OracleDataMap = {
     [lender: string]: {
         [chainId: string]: {
-            [assetAddress: string]: string;
+            [assetAddress: string]: CompoundV3OracleEntry;
         };
     };
 };
@@ -128,6 +132,19 @@ type MorphoTypeMarkets = {
         [chainId: string]: string[];
     };
 };
+type AaveOraclesConfigEntry = {
+    /** Base asset address (if lender uses non-USD base) */
+    baseAsset?: string;
+    /** Fallback BASE_CURRENCY_UNIT as string (converted to bigint at usage) */
+    baseCurrencyUnit?: string;
+    /** Another AAVE fork on the same chain to use as source for base asset USD price */
+    baseAssetSource?: string;
+};
+type AaveOraclesConfigType = {
+    [lender: string]: {
+        [chainId: string]: AaveOraclesConfigEntry;
+    };
+};
 type AaveWethGatewayType = {
     [fork: string]: {
         [chainId: string]: string;
@@ -158,12 +175,12 @@ type EulerVaultsType = {
     };
 };
 /** Override datas used in the SDK - works across all module instances */
-export declare function initializeLenderData({ aaveTokensOverride, aavePoolsOverride, aaveOraclesOverride, compoundV2OraclesOverride, compoundV3OraclesOverride, compoundV3PoolsOverride, compoundV3BaseDataOverride, morphoPoolsOverride, compoundV2TokensOverride, compoundV2TokenArrayOverride, compoundV2PoolsOverride, initConfigOverride, aaveReservesOverride, compoundV3ReservesOverride, compoundV2ReservesOverride, morphoOraclesOverride, morphoTypeOraclesOverride, morphoTypeMarketsOverride, aaveWethGatewayOverride, morphoBundler3Override, listaNativeProviderOverride, compoundV3BulkerOverride, eulerConfigsOverride, eulerVaultsOverride, }: {
+export declare function initializeLenderData({ aaveTokensOverride, aavePoolsOverride, aaveOraclesOverride, compoundV2OraclesOverride, compoundV3OraclesDataOverride, compoundV3PoolsOverride, compoundV3BaseDataOverride, morphoPoolsOverride, compoundV2TokensOverride, compoundV2TokenArrayOverride, compoundV2PoolsOverride, initConfigOverride, aaveReservesOverride, compoundV3ReservesOverride, compoundV2ReservesOverride, morphoOraclesOverride, morphoTypeOraclesOverride, morphoTypeMarketsOverride, aaveOraclesConfigOverride, aaveWethGatewayOverride, morphoBundler3Override, listaNativeProviderOverride, compoundV3BulkerOverride, eulerConfigsOverride, eulerVaultsOverride, }: {
     aaveTokensOverride?: AaveTokensType;
     aavePoolsOverride?: AavePoolsType;
     aaveOraclesOverride?: OracleMap;
     compoundV2OraclesOverride?: OracleMap;
-    compoundV3OraclesOverride?: OraclePerAssetMap;
+    compoundV3OraclesDataOverride?: CompoundV3OracleDataMap;
     compoundV3PoolsOverride?: CompoundV3PoolsType;
     compoundV3BaseDataOverride?: CompoundV3BaseDataType;
     morphoPoolsOverride?: MorphoPoolsType;
@@ -177,6 +194,7 @@ export declare function initializeLenderData({ aaveTokensOverride, aavePoolsOver
     morphoOraclesOverride?: MorphoOracles;
     morphoTypeOraclesOverride?: MorphoTypeOracles;
     morphoTypeMarketsOverride?: MorphoTypeMarkets;
+    aaveOraclesConfigOverride?: AaveOraclesConfigType;
     aaveWethGatewayOverride?: AaveWethGatewayType;
     morphoBundler3Override?: MorphoBundler3Type;
     listaNativeProviderOverride?: ListaNativeProviderType;
@@ -188,7 +206,7 @@ export declare const aaveTokens: () => AaveTokensType;
 export declare const aavePools: () => AavePoolsType;
 export declare const aaveOracles: () => OracleMap;
 export declare const compoundV2Oracles: () => OracleMap;
-export declare const compoundV3Oracles: () => OraclePerAssetMap;
+export declare const compoundV3OraclesData: () => CompoundV3OracleDataMap;
 export declare const morphoOracles: () => MorphoOracles;
 export declare const morphoTypeOracles: () => MorphoTypeOracles;
 export declare const morphoTypeMarkets: () => MorphoTypeMarkets;
@@ -202,6 +220,7 @@ export declare const compoundV2Pools: () => CompoundV2PoolsType;
 export declare const compoundV2Tokens: () => CompoundV2TokensType;
 export declare const compoundV2TokenArray: () => CompoundV2TokenArrayType;
 export declare const initConfig: () => InitConfigType;
+export declare const aaveOraclesConfig: () => AaveOraclesConfigType;
 export declare const aaveWethGateway: () => AaveWethGatewayType;
 export declare const morphoBundler3: () => MorphoBundler3Type;
 export declare const listaNativeProvider: () => ListaNativeProviderType;

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "Hold and initialize lending protocol data across a stack",
   "files": [
     "dist"