@1delta/initializer-sdk 0.0.3 → 0.0.6

package/README.md

@@ -0,0 +1,228 @@
+# @1delta/initializer-sdk
+
+Fetches lending protocol deployment metadata from GitHub and populates the global registries used by `@1delta/data-sdk`.
+
+## Installation
+
+```bash
+pnpm add @1delta/initializer-sdk
+```
+
+## How It Works
+
+```
+GitHub (lender-metadata repo)  ──fetch──►  initializer-sdk  ──populate──►  data-sdk global registry
+                                                                                    │
+                                                                           aavePools(), morphoPools(), ...
+```
+
+The initializer fetches JSON files from `1delta-DAO/lender-metadata` (pool configs, reserves, oracles, tokens) and `1delta-DAO/chains` (chain metadata), then calls `initializeLenderData()` / `initializeChainData()` from `@1delta/data-sdk` to populate the global registry. After initialization, all data is accessible via the data-sdk getter functions.
+
+---
+
+## Quick Start
+
+### Initialize everything
+
+```ts
+import { fetchLenderMetaFromDirAndInitializeAll } from '@1delta/initializer-sdk'
+
+await fetchLenderMetaFromDirAndInitializeAll()
+
+// Now data-sdk getters work:
+import { aavePools, compoundV2Pools, morphoPools, chains } from '@1delta/data-sdk'
+console.log(Object.keys(aavePools()))   // ['AAVE_V3', 'SPARK', 'LENDLE', ...]
+console.log(Object.keys(chains()))      // ['1', '56', '42161', ...]
+```
+
+### Initialize selectively
+
+Only load what you need — reduces fetch time and memory:
+
+```ts
+import { fetchLenderMetaFromDirAndInitialize } from '@1delta/initializer-sdk'
+
+await fetchLenderMetaFromDirAndInitialize({
+  aavePools: true,
+  aaveReserves: true,
+  compoundV2Pools: true,
+  compoundV2TokenArray: true,
+  chains: true,
+})
+```
+
+---
+
+## API
+
+### `fetchLenderMetaFromDirAndInitializeAll()`
+
+Fetches **all** metadata files and initializes the global registry. Equivalent to calling `fetchLenderMetaFromDirAndInitialize` with every flag set to `true`.
+
+```ts
+await fetchLenderMetaFromDirAndInitializeAll()
+```
+
+### `fetchLenderMetaFromDirAndInitialize(flags)`
+
+Fetches only the metadata specified by `flags` and initializes the registry.
+
+```ts
+await fetchLenderMetaFromDirAndInitialize({
+  aavePools: true,       // fetch aave pool configs
+  aaveReserves: true,    // fetch aave reserve lists
+  morphoPools: true,     // fetch morpho singleton addresses
+  chains: true,          // fetch chain metadata
+  // all other flags default to false
+})
+```
+
+### `fetchLenderMetaFromDir(flags)`
+
+Fetches metadata without initializing. Returns an object of overrides you can pass to `inititalizeAllData()` manually.
+
+```ts
+const params = await fetchLenderMetaFromDir({ aavePools: true, aaveReserves: true })
+// params.aavePoolsOverride = { AAVE_V3: { '1': { pool, protocolDataProvider } }, ... }
+// params.aaveReservesOverride = { AAVE_V3: { '1': ['0x...', ...] }, ... }
+```
+
+### `inititalizeAllData(params)`
+
+Populates the global registry from a params object (as returned by `fetchLenderMetaFromDir`).
+
+```ts
+const params = await fetchLenderMetaFromDir({ aavePools: true })
+inititalizeAllData(params)
+```
+
+### `getDeltaTokenList(chainId)`
+
+Fetches the token list for a chain from the `1delta-DAO/token-lists` repo.
+
+```ts
+import { getDeltaTokenList } from '@1delta/initializer-sdk'
+
+const tokens = await getDeltaTokenList('1')
+// {
+//   '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2': {
+//     chainId: '1', name: 'Wrapped Ether', symbol: 'WETH',
+//     address: '0xc02a...', decimals: 18, logoURI: '...',
+//   },
+//   ...
+// }
+```
+
+---
+
+## Fetch Flags
+
+All flags default to `false`. Set to `true` to fetch the corresponding data.
+
+### Aave (V2 / V3 / all forks)
+
+| Flag | Remote file | data-sdk getter |
+|------|------------|-----------------|
+| `aavePools` | `config/aave-pools.json` | `aavePools()` |
+| `aaveReserves` | `data/aave-reserves.json` | `aaveReserves()` |
+| `aaveTokens` | `data/aave-tokens.json` | `aaveTokens()` |
+| `aaveOracles` | `data/aave-oracles.json` | `aaveOracles()` |
+| `aaveWethGateway` | `config/aave-weth-gateway.json` | `aaveWethGateway()` |
+
+### Compound V2 (all forks)
+
+| Flag | Remote file | data-sdk getter |
+|------|------------|-----------------|
+| `compoundV2Pools` | `config/compound-v2-pools.json` | `compoundV2Pools()` |
+| `compoundV2Reserves` | `data/compound-v2-reserves.json` | `compoundV2Reserves()` |
+| `compoundV2Tokens` | `data/compound-v2-c-tokens.json` | `compoundV2Tokens()` |
+| `compoundV2TokenArray` | `data/compound-v2-tokens.json` | `compoundV2TokenArray()` |
+| `compoundV2Oracles` | `data/compound-v2-oracles.json` | `compoundV2Oracles()` |
+
+### Compound V3
+
+| Flag | Remote file | data-sdk getter |
+|------|------------|-----------------|
+| `compoundV3Pools` | `config/compound-v3-pools.json` | `compoundV3Pools()` |
+| `compoundV3Reserves` | `data/compound-v3-reserves.json` | `compoundV3Reserves()` |
+| `compoundV3BaseData` | `data/compound-v3-base-data.json` | `compoundV3BaseData()` |
+| `compoundV3Oracles` | `data/compound-v3-oracles.json` | `compoundV3Oracles()` |
+| `compoundV3Bulker` | `data/compound-v3-bulkers.json` | `compoundV3Bulker()` |
+
+### Morpho
+
+| Flag | Remote file | data-sdk getter |
+|------|------------|-----------------|
+| `morphoPools` | `config/morpho-pools.json` | `morphoPools()` |
+| `morphoOracles` | `data/morpho-oracles.json` | `morphoOracles()` |
+| `morphoTypeOracles` | `data/morpho-type-oracles.json` | `morphoTypeOracles()` |
+| `morphoTypeMarkets` | `data/morpho-type-markets.json` | `morphoTypeMarkets()` |
+| `morphoBundler3` | `data/morpho-bundler3.json` | `morphoBundler3()` |
+
+### Euler
+
+| Flag | Remote file | data-sdk getter |
+|------|------------|-----------------|
+| `eulerConfigs` | `config/euler-configs.json` | `eulerConfigs()` |
+| `eulerVaults` | `data/euler-vaults.json` | `eulerVaults()` |
+
+### Other
+
+| Flag | Remote file | data-sdk getter |
+|------|------------|-----------------|
+| `initPools` | `config/init-pools.json` | `initConfig()` |
+| `initConfig` | `data/init-config.json` | `initConfig()` |
+| `listaNativeProvider` | `data/lista-providers.json` | `listaNativeProvider()` |
+| `chains` | `data.json` (from chains repo) | `chains()` |
+
+---
+
+## Data Sources
+
+| Repository | Content |
+|-----------|---------|
+| `github.com/1delta-DAO/lender-metadata` | Pool configs, reserves, oracles, tokens for all protocols |
+| `github.com/1delta-DAO/chains` | Chain metadata (RPC, explorers, native currency) |
+| `github.com/1delta-DAO/token-lists` | Per-chain token lists |
+
+---
+
+## Usage with irm-sdk
+
+The typical flow for fetching IRM data across all protocols:
+
+```ts
+import { fetchLenderMetaFromDirAndInitialize } from '@1delta/initializer-sdk'
+import { aavePools, compoundV2Pools, compoundV3Pools, morphoPools, eulerConfigs } from '@1delta/data-sdk'
+import { prepareFetch, batchPrepared } from '@1delta/irm-sdk'
+import { multicallRetryUniversal } from '@1delta/providers'
+
+// 1. Initialize the registry (only pool + reserve data needed for IRM)
+await fetchLenderMetaFromDirAndInitialize({
+  aavePools: true,
+  aaveReserves: true,
+  compoundV2Pools: true,
+  compoundV2TokenArray: true,
+  compoundV3Pools: true,
+  compoundV3BaseData: true,
+  morphoPools: true,
+  morphoTypeMarkets: true,
+  eulerConfigs: true,
+  eulerVaults: true,
+})
+
+// 2. Enumerate all deployments
+const targets = []
+for (const [lender, chains] of Object.entries(aavePools() ?? {}))
+  for (const chainId of Object.keys(chains))
+    targets.push({ lender, chainId })
+// ... repeat for compoundV2Pools, compoundV3Pools, morphoPools, eulerConfigs
+
+// 3. Fetch IRM data per chain
+for (const [chainId, lenders] of Object.entries(groupByChain(targets))) {
+  const prepared = lenders
+    .map(({ lender }) => prepareFetch({ chainId, lender }))
+    .filter(Boolean)
+  const results = await batchPrepared(chainId, prepared, multicallRetryUniversal)
+}
+```

package/dist/index.js

@@ -15,6 +15,8 @@ var compoundV3Pools = baseUrl + "/config/compound-v3-pools.json";
 var compoundV3Oracles = baseUrl + "/data/compound-v3-oracles.json";
 var initPools = baseUrl + "/config/init-pools.json";
 var morphoPools = baseUrl + "/config/morpho-pools.json";
+var morphoBundler3 = baseUrl + "/data/morpho-bundler3.json";
+var listaNativeProvider = baseUrl + "/data/lista-providers.json";
 var aaveReserves = baseUrl + "/data/aave-reserves.json";
 var compoundV2Reserves = baseUrl + "/data/compound-v2-reserves.json";
 var compoundV3Reserves = baseUrl + "/data/compound-v3-reserves.json";
@@ -23,6 +25,10 @@ var aaveTokens = baseUrl + "/data/aave-tokens.json";
 var compoundV2CTokens = baseUrl + "/data/compound-v2-c-tokens.json";
 var compoundV2TokenArray = baseUrl + "/data/compound-v2-tokens.json";
 var compoundV3Base = baseUrl + "/data/compound-v3-base-data.json";
+var aaveWethGateway = baseUrl + "/config/aave-weth-gateway.json";
+var compoundV3Bulker = baseUrl + "/data/compound-v3-bulkers.json";
+var eulerConfigs = baseUrl + "/config/euler-configs.json";
+var eulerVaults = baseUrl + "/data/euler-vaults.json";
 var baseUrlChains = "https://raw.githubusercontent.com/1delta-DAO/chains/main";
 var chains = baseUrlChains + "/data.json";
 async function fetchLenderMetaFromDirAndInitialize(flags = {}) {
@@ -50,6 +56,12 @@ async function fetchLenderMetaFromDirAndInitializeAll() {
     morphoOracles: true,
     morphoTypeOracles: true,
     morphoTypeMarkets: true,
+    aaveWethGateway: true,
+    morphoBundler3: true,
+    listaNativeProvider: true,
+    compoundV3Bulker: true,
+    eulerConfigs: true,
+    eulerVaults: true,
     chains: true
   };
   const params = await fetchLenderMetaFromDir(all);
@@ -81,10 +93,21 @@ async function fetchLenderMetaFromDir(flags = {}) {
     morphoOracles: false,
     morphoTypeOracles: false,
     morphoTypeMarkets: false,
+    aaveWethGateway: false,
+    morphoBundler3: false,
+    listaNativeProvider: false,
+    compoundV3Bulker: false,
+    eulerConfigs: false,
+    eulerVaults: false,
     chains: false
   };
   const merged = { ...defaults, ...flags };
-  const fetchIf = async (flag, url) => flag ? fetch(url).then((r) => r.json()) : void 0;
+  const fetchIf = async (flag, url) => {
+    if (!flag) return void 0;
+    const r = await fetch(url);
+    if (!r.ok) return void 0;
+    return r.json();
+  };
   return {
     aavePoolsOverride: await fetchIf(merged.aavePools, aavePools),
     compoundV2PoolsOverride: await fetchIf(merged.compoundV2Pools, compoundV2Pools),
@@ -105,6 +128,12 @@ async function fetchLenderMetaFromDir(flags = {}) {
     morphoOraclesOverride: await fetchIf(merged.morphoOracles, morphoOracles),
     morphoTypeOraclesOverride: await fetchIf(merged.morphoTypeOracles, morphoTypeOracles),
     morphoTypeMarketsOverride: await fetchIf(merged.morphoTypeMarkets, morphoTypeMarkets),
+    aaveWethGatewayOverride: await fetchIf(merged.aaveWethGateway, aaveWethGateway),
+    morphoBundler3Override: await fetchIf(merged.morphoBundler3, morphoBundler3),
+    listaNativeProviderOverride: await fetchIf(merged.listaNativeProvider, listaNativeProvider),
+    compoundV3BulkerOverride: await fetchIf(merged.compoundV3Bulker, compoundV3Bulker),
+    eulerConfigsOverride: await fetchIf(merged.eulerConfigs, eulerConfigs),
+    eulerVaultsOverride: await fetchIf(merged.eulerVaults, eulerVaults),
     chainsOverride: await fetchIf(merged.chains, chains)
   };
 }

package/dist/index.mjs

@@ -13,6 +13,8 @@ var compoundV3Pools = baseUrl + "/config/compound-v3-pools.json";
 var compoundV3Oracles = baseUrl + "/data/compound-v3-oracles.json";
 var initPools = baseUrl + "/config/init-pools.json";
 var morphoPools = baseUrl + "/config/morpho-pools.json";
+var morphoBundler3 = baseUrl + "/data/morpho-bundler3.json";
+var listaNativeProvider = baseUrl + "/data/lista-providers.json";
 var aaveReserves = baseUrl + "/data/aave-reserves.json";
 var compoundV2Reserves = baseUrl + "/data/compound-v2-reserves.json";
 var compoundV3Reserves = baseUrl + "/data/compound-v3-reserves.json";
@@ -21,6 +23,10 @@ var aaveTokens = baseUrl + "/data/aave-tokens.json";
 var compoundV2CTokens = baseUrl + "/data/compound-v2-c-tokens.json";
 var compoundV2TokenArray = baseUrl + "/data/compound-v2-tokens.json";
 var compoundV3Base = baseUrl + "/data/compound-v3-base-data.json";
+var aaveWethGateway = baseUrl + "/config/aave-weth-gateway.json";
+var compoundV3Bulker = baseUrl + "/data/compound-v3-bulkers.json";
+var eulerConfigs = baseUrl + "/config/euler-configs.json";
+var eulerVaults = baseUrl + "/data/euler-vaults.json";
 var baseUrlChains = "https://raw.githubusercontent.com/1delta-DAO/chains/main";
 var chains = baseUrlChains + "/data.json";
 async function fetchLenderMetaFromDirAndInitialize(flags = {}) {
@@ -48,6 +54,12 @@ async function fetchLenderMetaFromDirAndInitializeAll() {
     morphoOracles: true,
     morphoTypeOracles: true,
     morphoTypeMarkets: true,
+    aaveWethGateway: true,
+    morphoBundler3: true,
+    listaNativeProvider: true,
+    compoundV3Bulker: true,
+    eulerConfigs: true,
+    eulerVaults: true,
     chains: true
   };
   const params = await fetchLenderMetaFromDir(all);
@@ -79,10 +91,21 @@ async function fetchLenderMetaFromDir(flags = {}) {
     morphoOracles: false,
     morphoTypeOracles: false,
     morphoTypeMarkets: false,
+    aaveWethGateway: false,
+    morphoBundler3: false,
+    listaNativeProvider: false,
+    compoundV3Bulker: false,
+    eulerConfigs: false,
+    eulerVaults: false,
     chains: false
   };
   const merged = { ...defaults, ...flags };
-  const fetchIf = async (flag, url) => flag ? fetch(url).then((r) => r.json()) : void 0;
+  const fetchIf = async (flag, url) => {
+    if (!flag) return void 0;
+    const r = await fetch(url);
+    if (!r.ok) return void 0;
+    return r.json();
+  };
   return {
     aavePoolsOverride: await fetchIf(merged.aavePools, aavePools),
     compoundV2PoolsOverride: await fetchIf(merged.compoundV2Pools, compoundV2Pools),
@@ -103,6 +126,12 @@ async function fetchLenderMetaFromDir(flags = {}) {
     morphoOraclesOverride: await fetchIf(merged.morphoOracles, morphoOracles),
     morphoTypeOraclesOverride: await fetchIf(merged.morphoTypeOracles, morphoTypeOracles),
     morphoTypeMarketsOverride: await fetchIf(merged.morphoTypeMarkets, morphoTypeMarkets),
+    aaveWethGatewayOverride: await fetchIf(merged.aaveWethGateway, aaveWethGateway),
+    morphoBundler3Override: await fetchIf(merged.morphoBundler3, morphoBundler3),
+    listaNativeProviderOverride: await fetchIf(merged.listaNativeProvider, listaNativeProvider),
+    compoundV3BulkerOverride: await fetchIf(merged.compoundV3Bulker, compoundV3Bulker),
+    eulerConfigsOverride: await fetchIf(merged.eulerConfigs, eulerConfigs),
+    eulerVaultsOverride: await fetchIf(merged.eulerVaults, eulerVaults),
     chainsOverride: await fetchIf(merged.chains, chains)
   };
 }

package/dist/initializer.d.ts

@@ -26,6 +26,12 @@ export interface FetchFlags {
     morphoOracles: boolean;
     morphoTypeOracles: boolean;
     morphoTypeMarkets: boolean;
+    aaveWethGateway: boolean;
+    morphoBundler3: boolean;
+    listaNativeProvider: boolean;
+    compoundV3Bulker: boolean;
+    eulerConfigs: boolean;
+    eulerVaults: boolean;
     chains: boolean;
 }
 /**
@@ -51,5 +57,11 @@ export declare function fetchLenderMetaFromDir(flags?: Partial<FetchFlags>): Pro
     morphoOraclesOverride: any;
     morphoTypeOraclesOverride: any;
     morphoTypeMarketsOverride: any;
+    aaveWethGatewayOverride: any;
+    morphoBundler3Override: any;
+    listaNativeProviderOverride: any;
+    compoundV3BulkerOverride: any;
+    eulerConfigsOverride: any;
+    eulerVaultsOverride: any;
     chainsOverride: any;
 }>;

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.3",
+  "version": "0.0.6",
   "description": "Deterministic initializer for lending protocol data across the stack",
   "files": [
     "dist"
@@ -21,7 +21,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@1delta/data-sdk": "0.0.13"
+    "@1delta/data-sdk": "0.0.17"
   },
   "engines": {
     "node": ">=20"