@1delta/data-sdk 0.0.19 → 0.0.21

package/dist/index.js

@@ -38,7 +38,10 @@ globalThis[GLOBAL_LENDER_DATA_KEY] = {
   listaNativeProvider: {},
   compoundV3Bulker: {},
   eulerConfigs: {},
-  eulerVaults: {}
+  eulerVaults: {},
+  aaveV4Spokes: {},
+  aaveV4Oracles: {},
+  aaveV4Peripherals: {}
 };
 function getGlobalData2() {
   return globalThis[GLOBAL_LENDER_DATA_KEY];
@@ -68,7 +71,10 @@ function initializeLenderData({
   listaNativeProviderOverride,
   compoundV3BulkerOverride,
   eulerConfigsOverride,
-  eulerVaultsOverride
+  eulerVaultsOverride,
+  aaveV4SpokesOverride,
+  aaveV4OraclesOverride,
+  aaveV4PeripheralsOverride
 }) {
   const data = getGlobalData2();
   if (aaveTokensOverride) data.aaveTokens = aaveTokensOverride;
@@ -96,6 +102,10 @@ function initializeLenderData({
   if (compoundV3BulkerOverride) data.compoundV3Bulker = compoundV3BulkerOverride;
   if (eulerConfigsOverride) data.eulerConfigs = eulerConfigsOverride;
   if (eulerVaultsOverride) data.eulerVaults = eulerVaultsOverride;
+  if (aaveV4SpokesOverride) data.aaveV4Spokes = aaveV4SpokesOverride;
+  if (aaveV4OraclesOverride) data.aaveV4Oracles = aaveV4OraclesOverride;
+  if (aaveV4PeripheralsOverride)
+    data.aaveV4Peripherals = aaveV4PeripheralsOverride;
 }
 var aaveTokens = () => getGlobalData2()?.aaveTokens;
 var aavePools = () => getGlobalData2()?.aavePools;
@@ -122,6 +132,58 @@ var listaNativeProvider = () => getGlobalData2()?.listaNativeProvider;
 var compoundV3Bulker = () => getGlobalData2()?.compoundV3Bulker;
 var eulerConfigs = () => getGlobalData2()?.eulerConfigs;
 var eulerVaults = () => getGlobalData2()?.eulerVaults;
+var aaveV4Spokes = () => getGlobalData2()?.aaveV4Spokes;
+var aaveV4Oracles = () => getGlobalData2()?.aaveV4Oracles;
+var aaveV4Peripherals = () => getGlobalData2()?.aaveV4Peripherals;
+function getAaveV4SpokeEntry(chainId, lenderKey) {
+  const parsed = parseAaveV4SpokeLenderKey(lenderKey);
+  if (!parsed) return void 0;
+  return getGlobalData2()?.aaveV4Spokes?.[chainId]?.[parsed.spokeAddrLower];
+}
+function getAaveV4GatewayAddresses(chainId, lender, hubOverride) {
+  const c = getGlobalData2()?.aaveV4Peripherals?.[chainId];
+  if (!c) return {};
+  let hubAddr = hubOverride?.toLowerCase();
+  if (!hubAddr) {
+    const spokeEntry = getAaveV4SpokeEntry(chainId, lender);
+    hubAddr = spokeEntry?.reserves?.[0]?.hub?.toLowerCase();
+  }
+  const perHub = hubAddr && c.perHub?.[hubAddr] || void 0;
+  return {
+    nativeGateway: perHub?.nativeGateway ?? c.nativeGateway,
+    signatureGateway: perHub?.signatureGateway ?? c.signatureGateway
+  };
+}
+function getAaveV4SpokePeripherals(chainId, lenderKey) {
+  const parsed = parseAaveV4SpokeLenderKey(lenderKey);
+  if (!parsed) return void 0;
+  return getGlobalData2()?.aaveV4Peripherals?.[chainId]?.perSpoke?.[parsed.spokeAddrLower];
+}
+function getAaveV4PositionManagers(chainId, lenderKey) {
+  const meta = getAaveV4SpokePeripherals(chainId, lenderKey);
+  if (!meta?.positionManagers) return [];
+  return meta.positionManagers.filter((pm) => pm.active !== false && pm.address).map((pm) => pm.address.toLowerCase());
+}
+function findAaveV4PositionManager(chainId, lenderKey, nameQuery) {
+  const meta = getAaveV4SpokePeripherals(chainId, lenderKey);
+  if (!meta?.positionManagers) return void 0;
+  const q = nameQuery.toLowerCase();
+  const hit = meta.positionManagers.find(
+    (pm) => pm.active !== false && pm.address && (pm.name ?? "").toLowerCase().includes(q)
+  );
+  return hit?.address?.toLowerCase();
+}
+function aaveV4SpokeLenderKey(spoke) {
+  if (!spoke || !spoke.startsWith("0x") || spoke.length !== 42) {
+    throw new Error(`aaveV4SpokeLenderKey: invalid spoke address ${spoke}`);
+  }
+  return `AAVE_V4_${spoke.slice(2).toUpperCase()}`;
+}
+function parseAaveV4SpokeLenderKey(lenderKey) {
+  const match = lenderKey.match(/^AAVE_V4_([0-9A-F]{40})$/);
+  if (!match) return void 0;
+  return { spokeAddrLower: "0x" + match[1].toLowerCase() };
+}
 
 // src/tokens.ts
 var getListUrl = (chainId) => `https://raw.githubusercontent.com/1delta-DAO/token-lists/main/${chainId}.json`;
@@ -144,6 +206,10 @@ exports.aaveOraclesConfig = aaveOraclesConfig;
 exports.aavePools = aavePools;
 exports.aaveReserves = aaveReserves;
 exports.aaveTokens = aaveTokens;
+exports.aaveV4Oracles = aaveV4Oracles;
+exports.aaveV4Peripherals = aaveV4Peripherals;
+exports.aaveV4SpokeLenderKey = aaveV4SpokeLenderKey;
+exports.aaveV4Spokes = aaveV4Spokes;
 exports.aaveWethGateway = aaveWethGateway;
 exports.chains = chains;
 exports.compoundV2Oracles = compoundV2Oracles;
@@ -160,6 +226,11 @@ exports.eulerConfigs = eulerConfigs;
 exports.eulerVaults = eulerVaults;
 exports.fetchTokenList = fetchTokenList;
 exports.fetchTokenLists = fetchTokenLists;
+exports.findAaveV4PositionManager = findAaveV4PositionManager;
+exports.getAaveV4GatewayAddresses = getAaveV4GatewayAddresses;
+exports.getAaveV4PositionManagers = getAaveV4PositionManagers;
+exports.getAaveV4SpokeEntry = getAaveV4SpokeEntry;
+exports.getAaveV4SpokePeripherals = getAaveV4SpokePeripherals;
 exports.initConfig = initConfig;
 exports.initializeChainData = initializeChainData;
 exports.initializeLenderData = initializeLenderData;
@@ -169,3 +240,4 @@ exports.morphoOracles = morphoOracles;
 exports.morphoPools = morphoPools;
 exports.morphoTypeMarkets = morphoTypeMarkets;
 exports.morphoTypeOracles = morphoTypeOracles;
+exports.parseAaveV4SpokeLenderKey = parseAaveV4SpokeLenderKey;

package/dist/index.mjs

@@ -36,7 +36,10 @@ globalThis[GLOBAL_LENDER_DATA_KEY] = {
   listaNativeProvider: {},
   compoundV3Bulker: {},
   eulerConfigs: {},
-  eulerVaults: {}
+  eulerVaults: {},
+  aaveV4Spokes: {},
+  aaveV4Oracles: {},
+  aaveV4Peripherals: {}
 };
 function getGlobalData2() {
   return globalThis[GLOBAL_LENDER_DATA_KEY];
@@ -66,7 +69,10 @@ function initializeLenderData({
   listaNativeProviderOverride,
   compoundV3BulkerOverride,
   eulerConfigsOverride,
-  eulerVaultsOverride
+  eulerVaultsOverride,
+  aaveV4SpokesOverride,
+  aaveV4OraclesOverride,
+  aaveV4PeripheralsOverride
 }) {
   const data = getGlobalData2();
   if (aaveTokensOverride) data.aaveTokens = aaveTokensOverride;
@@ -94,6 +100,10 @@ function initializeLenderData({
   if (compoundV3BulkerOverride) data.compoundV3Bulker = compoundV3BulkerOverride;
   if (eulerConfigsOverride) data.eulerConfigs = eulerConfigsOverride;
   if (eulerVaultsOverride) data.eulerVaults = eulerVaultsOverride;
+  if (aaveV4SpokesOverride) data.aaveV4Spokes = aaveV4SpokesOverride;
+  if (aaveV4OraclesOverride) data.aaveV4Oracles = aaveV4OraclesOverride;
+  if (aaveV4PeripheralsOverride)
+    data.aaveV4Peripherals = aaveV4PeripheralsOverride;
 }
 var aaveTokens = () => getGlobalData2()?.aaveTokens;
 var aavePools = () => getGlobalData2()?.aavePools;
@@ -120,6 +130,58 @@ var listaNativeProvider = () => getGlobalData2()?.listaNativeProvider;
 var compoundV3Bulker = () => getGlobalData2()?.compoundV3Bulker;
 var eulerConfigs = () => getGlobalData2()?.eulerConfigs;
 var eulerVaults = () => getGlobalData2()?.eulerVaults;
+var aaveV4Spokes = () => getGlobalData2()?.aaveV4Spokes;
+var aaveV4Oracles = () => getGlobalData2()?.aaveV4Oracles;
+var aaveV4Peripherals = () => getGlobalData2()?.aaveV4Peripherals;
+function getAaveV4SpokeEntry(chainId, lenderKey) {
+  const parsed = parseAaveV4SpokeLenderKey(lenderKey);
+  if (!parsed) return void 0;
+  return getGlobalData2()?.aaveV4Spokes?.[chainId]?.[parsed.spokeAddrLower];
+}
+function getAaveV4GatewayAddresses(chainId, lender, hubOverride) {
+  const c = getGlobalData2()?.aaveV4Peripherals?.[chainId];
+  if (!c) return {};
+  let hubAddr = hubOverride?.toLowerCase();
+  if (!hubAddr) {
+    const spokeEntry = getAaveV4SpokeEntry(chainId, lender);
+    hubAddr = spokeEntry?.reserves?.[0]?.hub?.toLowerCase();
+  }
+  const perHub = hubAddr && c.perHub?.[hubAddr] || void 0;
+  return {
+    nativeGateway: perHub?.nativeGateway ?? c.nativeGateway,
+    signatureGateway: perHub?.signatureGateway ?? c.signatureGateway
+  };
+}
+function getAaveV4SpokePeripherals(chainId, lenderKey) {
+  const parsed = parseAaveV4SpokeLenderKey(lenderKey);
+  if (!parsed) return void 0;
+  return getGlobalData2()?.aaveV4Peripherals?.[chainId]?.perSpoke?.[parsed.spokeAddrLower];
+}
+function getAaveV4PositionManagers(chainId, lenderKey) {
+  const meta = getAaveV4SpokePeripherals(chainId, lenderKey);
+  if (!meta?.positionManagers) return [];
+  return meta.positionManagers.filter((pm) => pm.active !== false && pm.address).map((pm) => pm.address.toLowerCase());
+}
+function findAaveV4PositionManager(chainId, lenderKey, nameQuery) {
+  const meta = getAaveV4SpokePeripherals(chainId, lenderKey);
+  if (!meta?.positionManagers) return void 0;
+  const q = nameQuery.toLowerCase();
+  const hit = meta.positionManagers.find(
+    (pm) => pm.active !== false && pm.address && (pm.name ?? "").toLowerCase().includes(q)
+  );
+  return hit?.address?.toLowerCase();
+}
+function aaveV4SpokeLenderKey(spoke) {
+  if (!spoke || !spoke.startsWith("0x") || spoke.length !== 42) {
+    throw new Error(`aaveV4SpokeLenderKey: invalid spoke address ${spoke}`);
+  }
+  return `AAVE_V4_${spoke.slice(2).toUpperCase()}`;
+}
+function parseAaveV4SpokeLenderKey(lenderKey) {
+  const match = lenderKey.match(/^AAVE_V4_([0-9A-F]{40})$/);
+  if (!match) return void 0;
+  return { spokeAddrLower: "0x" + match[1].toLowerCase() };
+}
 
 // src/tokens.ts
 var getListUrl = (chainId) => `https://raw.githubusercontent.com/1delta-DAO/token-lists/main/${chainId}.json`;
@@ -137,4 +199,4 @@ async function fetchTokenLists(chainIds) {
   return Object.fromEntries(results);
 }
 
-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 };
+export { aaveOracles, aaveOraclesConfig, aavePools, aaveReserves, aaveTokens, aaveV4Oracles, aaveV4Peripherals, aaveV4SpokeLenderKey, aaveV4Spokes, aaveWethGateway, chains, compoundV2Oracles, compoundV2Pools, compoundV2Reserves, compoundV2TokenArray, compoundV2Tokens, compoundV3BaseData, compoundV3Bulker, compoundV3OraclesData, compoundV3Pools, compoundV3Reserves, eulerConfigs, eulerVaults, fetchTokenList, fetchTokenLists, findAaveV4PositionManager, getAaveV4GatewayAddresses, getAaveV4PositionManagers, getAaveV4SpokeEntry, getAaveV4SpokePeripherals, initConfig, initializeChainData, initializeLenderData, listaNativeProvider, morphoBundler3, morphoOracles, morphoPools, morphoTypeMarkets, morphoTypeOracles, parseAaveV4SpokeLenderKey };

package/dist/lending.d.ts

@@ -174,8 +174,88 @@ type EulerVaultsType = {
         [chainId: string]: EulerVaultEntry[];
     };
 };
+export type AaveV4ReserveEntry = {
+    reserveId: number;
+    /** Hub-side asset id (scoped to the entry's `hub`) */
+    assetId: number;
+    underlying: string;
+    /**
+     * Per-reserve hub address. Set at reserve init on-chain — different
+     * reserves on the same spoke can have different hubs.
+     */
+    hub: string;
+    /** Optional per-reserve oracle override (defaults to spoke.oracle) */
+    oracle?: string;
+    oracleDecimals?: number;
+};
+export type AaveV4SpokeEntry = {
+    spoke: string;
+    oracle: string;
+    label: string;
+    dynamicConfigKeyMax?: number;
+    /**
+     * UI/grouping hint only (`AAVE_V4_CORE` / `AAVE_V4_PLUS` / `AAVE_V4_PRIME`).
+     * NOT used for routing or lender keying.
+     */
+    baseHubAttribution?: string;
+    reserves: AaveV4ReserveEntry[];
+};
+/** Top-level: chainId → spokeAddrLower → entry */
+export type AaveV4SpokesType = {
+    [chainId: string]: {
+        [spokeAddrLower: string]: AaveV4SpokeEntry;
+    };
+};
+export type AaveV4OracleEntry = {
+    underlying: string;
+    spoke: string;
+    reserveId: number;
+    oracle: string;
+    decimals?: number;
+    source?: string;
+};
+/** Top-level chainId only — no fork dimension. */
+export type AaveV4OraclesType = {
+    [chainId: string]: AaveV4OracleEntry[];
+};
+export type AaveV4PerHubGateways = {
+    nativeGateway?: string;
+    signatureGateway?: string;
+};
+/**
+ * Per-spoke peripherals — extra metadata the lender-metadata repo carries
+ * for spoke-scoped concerns (curated names, position manager registry, …).
+ * Opaque to the data-sdk; surfaced as `any` so consumers (worker-api,
+ * frontend) can read it without dragging the schema into this package.
+ */
+export type AaveV4PerSpokeMeta = {
+    spokeName?: string;
+    spokeId?: string;
+    positionManagers?: Array<{
+        name?: string;
+        address: string;
+        active?: boolean;
+    }>;
+    [k: string]: unknown;
+};
+export type AaveV4ChainPeripherals = {
+    /** Chain-wide fallback gateway addresses */
+    nativeGateway?: string;
+    signatureGateway?: string;
+    /** Per-hub gateway overrides (keyed by lowercase hub address) */
+    perHub?: {
+        [hubAddrLower: string]: AaveV4PerHubGateways;
+    };
+    /** Per-spoke metadata (curated names, position managers, …) */
+    perSpoke?: {
+        [spokeAddrLower: string]: AaveV4PerSpokeMeta;
+    };
+};
+export type AaveV4PeripheralsType = {
+    [chainId: string]: AaveV4ChainPeripherals;
+};
 /** Override datas used in the SDK - works across all module instances */
-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, }: {
+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, aaveV4SpokesOverride, aaveV4OraclesOverride, aaveV4PeripheralsOverride, }: {
     aaveTokensOverride?: AaveTokensType;
     aavePoolsOverride?: AavePoolsType;
     aaveOraclesOverride?: OracleMap;
@@ -201,6 +281,9 @@ export declare function initializeLenderData({ aaveTokensOverride, aavePoolsOver
     compoundV3BulkerOverride?: CompoundV3BulkerType;
     eulerConfigsOverride?: EulerConfigsType;
     eulerVaultsOverride?: EulerVaultsType;
+    aaveV4SpokesOverride?: AaveV4SpokesType;
+    aaveV4OraclesOverride?: AaveV4OraclesType;
+    aaveV4PeripheralsOverride?: AaveV4PeripheralsType;
 }): void;
 export declare const aaveTokens: () => AaveTokensType;
 export declare const aavePools: () => AavePoolsType;
@@ -227,4 +310,92 @@ export declare const listaNativeProvider: () => ListaNativeProviderType;
 export declare const compoundV3Bulker: () => CompoundV3BulkerType;
 export declare const eulerConfigs: () => EulerConfigsType;
 export declare const eulerVaults: () => EulerVaultsType;
+export declare const aaveV4Spokes: () => AaveV4SpokesType;
+export declare const aaveV4Oracles: () => AaveV4OraclesType;
+export declare const aaveV4Peripherals: () => AaveV4PeripheralsType;
+/**
+ * Look up the spoke entry for a per-spoke V4 lender key (`AAVE_V4_<HEX>`).
+ * Returns `undefined` if no entry exists for that chain/spoke.
+ */
+export declare function getAaveV4SpokeEntry(chainId: string, lenderKey: string): AaveV4SpokeEntry | undefined;
+/**
+ * Native / signature gateway addresses for Aave V4.
+ *
+ * Resolves the spoke from the per-spoke lender key (`AAVE_V4_<HEX>`),
+ * picks the spoke's first reserve to learn its hub, and looks up
+ * `peripherals[chainId].perHub[hub]`. Falls back to the chain-level
+ * default gateways if no per-hub override is set.
+ *
+ * If the caller passes a hub address directly via `hubOverride`, that
+ * takes precedence.
+ */
+export declare function getAaveV4GatewayAddresses(chainId: string, lender: string, hubOverride?: string): {
+    nativeGateway?: string;
+    signatureGateway?: string;
+};
+/**
+ * Look up the per-spoke peripherals metadata for a V4 spoke.
+ *
+ * Sourced from `aave-v4-peripherals.json` `perSpoke[<spokeAddrLower>]`.
+ * Carries curated extras the metadata team maintains alongside the core
+ * registry — most usefully the position-manager registry. Returns
+ * `undefined` if no entry exists for the spoke or if the lender key is
+ * not a per-spoke V4 key.
+ *
+ * Note: the spoke's `label` (curated UI name) lives directly on the
+ * `AaveV4SpokeEntry` from `aaveV4Spokes()` — `perSpoke.spokeName` is a
+ * duplicate of that and is intentionally not surfaced through the public-
+ * data normalizer. Read it through this helper if a consumer needs the
+ * exact value from the peripherals file.
+ */
+export declare function getAaveV4SpokePeripherals(chainId: string, lenderKey: string): AaveV4PerSpokeMeta | undefined;
+/**
+ * Active position-manager addresses for an Aave V4 spoke.
+ *
+ * Returns the lowercase addresses of every entry in
+ * `perSpoke[<spoke>].positionManagers` whose `active` flag is truthy.
+ * Empty array if the spoke has no peripherals entry or no active PMs.
+ *
+ * Use the `byName` lookup form when you need a specific PM (e.g. the
+ * native gateway). Names are matched case-insensitively against the
+ * curated `name` field; partial matches are accepted.
+ */
+export declare function getAaveV4PositionManagers(chainId: string, lenderKey: string): string[];
+/**
+ * Look up a single position-manager address by curated name (partial,
+ * case-insensitive). Returns `undefined` if no match. Useful for
+ * targeting specific PMs like `"native gateway"` or `"signature gateway"`
+ * without hardcoding the addresses.
+ */
+export declare function findAaveV4PositionManager(chainId: string, lenderKey: string, nameQuery: string): string | undefined;
+/**
+ * Synthesize the per-spoke lender key for an Aave V4 spoke.
+ *
+ * Mirrors the Morpho `MORPHO_BLUE_<HEX_NO_0X_UPPER>` convention so the rest
+ * of the codebase can treat each spoke as an isolated market — exactly like a
+ * Morpho Blue market or a Compound V3 Comet — without any V4-specific logic.
+ *
+ * Format: `AAVE_V4_${spokeAddr.slice(2).toUpperCase()}`
+ *
+ * Example:
+ *   spoke = "0x94e7a5dcbe816e498b89ab752661904e2f56c485"
+ *   →     = "AAVE_V4_94E7A5DCBE816E498B89AB752661904E2F56C485"
+ *
+ * The full spoke address is preserved (no truncation) so the key is globally
+ * unique and stable across spoke implementation upgrades (proxy address).
+ * Note: chainId is intentionally NOT in the lender token — the same spoke
+ * address can in principle exist on multiple chains via deterministic
+ * deploys, and chain scoping happens at the marketUid level instead.
+ *
+ * `isAaveV4Type()` continues to work because it uses `startsWith('AAVE_V4')`.
+ */
+export declare function aaveV4SpokeLenderKey(spoke: string): string;
+/**
+ * Inverse of `aaveV4SpokeLenderKey`: given a per-spoke lender key, return
+ * `{ spokeAddrLower }`. Returns `undefined` if the key isn't a per-spoke V4
+ * key (e.g. someone passed the bare prefix `AAVE_V4`).
+ */
+export declare function parseAaveV4SpokeLenderKey(lenderKey: string): {
+    spokeAddrLower: string;
+} | undefined;
 export {};

package/package.json

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