@1delta/data-sdk 0.0.20 → 0.0.22

package/dist/index.js

@@ -40,8 +40,12 @@ globalThis[GLOBAL_LENDER_DATA_KEY] = {
   eulerConfigs: {},
   eulerVaults: {},
   aaveV4Spokes: {},
-  aaveV4Reserves: {},
-  aaveV4Oracles: {}
+  aaveV4Oracles: {},
+  aaveV4Peripherals: {},
+  siloMarkets: {},
+  siloPeripherals: {},
+  siloMarketsV3: {},
+  siloPeripheralsV3: {}
 };
 function getGlobalData2() {
   return globalThis[GLOBAL_LENDER_DATA_KEY];
@@ -73,8 +77,12 @@ function initializeLenderData({
   eulerConfigsOverride,
   eulerVaultsOverride,
   aaveV4SpokesOverride,
-  aaveV4ReservesOverride,
-  aaveV4OraclesOverride
+  aaveV4OraclesOverride,
+  aaveV4PeripheralsOverride,
+  siloMarketsOverride,
+  siloPeripheralsOverride,
+  siloMarketsV3Override,
+  siloPeripheralsV3Override
 }) {
   const data = getGlobalData2();
   if (aaveTokensOverride) data.aaveTokens = aaveTokensOverride;
@@ -103,8 +111,14 @@ function initializeLenderData({
   if (eulerConfigsOverride) data.eulerConfigs = eulerConfigsOverride;
   if (eulerVaultsOverride) data.eulerVaults = eulerVaultsOverride;
   if (aaveV4SpokesOverride) data.aaveV4Spokes = aaveV4SpokesOverride;
-  if (aaveV4ReservesOverride) data.aaveV4Reserves = aaveV4ReservesOverride;
   if (aaveV4OraclesOverride) data.aaveV4Oracles = aaveV4OraclesOverride;
+  if (aaveV4PeripheralsOverride)
+    data.aaveV4Peripherals = aaveV4PeripheralsOverride;
+  if (siloMarketsOverride) data.siloMarkets = siloMarketsOverride;
+  if (siloPeripheralsOverride) data.siloPeripherals = siloPeripheralsOverride;
+  if (siloMarketsV3Override) data.siloMarketsV3 = siloMarketsV3Override;
+  if (siloPeripheralsV3Override)
+    data.siloPeripheralsV3 = siloPeripheralsV3Override;
 }
 var aaveTokens = () => getGlobalData2()?.aaveTokens;
 var aavePools = () => getGlobalData2()?.aavePools;
@@ -132,8 +146,101 @@ var compoundV3Bulker = () => getGlobalData2()?.compoundV3Bulker;
 var eulerConfigs = () => getGlobalData2()?.eulerConfigs;
 var eulerVaults = () => getGlobalData2()?.eulerVaults;
 var aaveV4Spokes = () => getGlobalData2()?.aaveV4Spokes;
-var aaveV4Reserves = () => getGlobalData2()?.aaveV4Reserves;
 var aaveV4Oracles = () => getGlobalData2()?.aaveV4Oracles;
+var aaveV4Peripherals = () => getGlobalData2()?.aaveV4Peripherals;
+var siloMarkets = () => getGlobalData2()?.siloMarkets;
+var siloPeripherals = () => getGlobalData2()?.siloPeripherals;
+var siloMarketsV3 = () => getGlobalData2()?.siloMarketsV3;
+var siloPeripheralsV3 = () => getGlobalData2()?.siloPeripheralsV3;
+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() };
+}
+function siloV2LenderKey(siloConfig) {
+  if (!siloConfig || !siloConfig.startsWith("0x") || siloConfig.length !== 42) {
+    throw new Error(`siloV2LenderKey: invalid siloConfig address ${siloConfig}`);
+  }
+  return `SILO_V2_${siloConfig.slice(2).toUpperCase()}`;
+}
+function parseSiloV2LenderKey(lenderKey) {
+  const match = lenderKey.match(/^SILO_V2_([0-9A-F]{40})$/);
+  if (!match) return void 0;
+  return { siloConfigAddrLower: "0x" + match[1].toLowerCase() };
+}
+function getSiloV2MarketEntry(chainId, lenderKey) {
+  const parsed = parseSiloV2LenderKey(lenderKey);
+  if (!parsed) return void 0;
+  const list = getGlobalData2()?.siloMarkets?.[chainId];
+  if (!list) return void 0;
+  return list.find(
+    (m) => m.siloConfig.toLowerCase() === parsed.siloConfigAddrLower
+  );
+}
+function siloV3LenderKey(siloConfig) {
+  if (!siloConfig || !siloConfig.startsWith("0x") || siloConfig.length !== 42) {
+    throw new Error(`siloV3LenderKey: invalid siloConfig address ${siloConfig}`);
+  }
+  return `SILO_V3_${siloConfig.slice(2).toUpperCase()}`;
+}
+function parseSiloV3LenderKey(lenderKey) {
+  const match = lenderKey.match(/^SILO_V3_([0-9A-F]{40})$/);
+  if (!match) return void 0;
+  return { siloConfigAddrLower: "0x" + match[1].toLowerCase() };
+}
+function getSiloV3MarketEntry(chainId, lenderKey) {
+  const parsed = parseSiloV3LenderKey(lenderKey);
+  if (!parsed) return void 0;
+  const list = getGlobalData2()?.siloMarketsV3?.[chainId];
+  if (!list) return void 0;
+  return list.find(
+    (m) => m.siloConfig.toLowerCase() === parsed.siloConfigAddrLower
+  );
+}
 
 // src/tokens.ts
 var getListUrl = (chainId) => `https://raw.githubusercontent.com/1delta-DAO/token-lists/main/${chainId}.json`;
@@ -157,7 +264,8 @@ exports.aavePools = aavePools;
 exports.aaveReserves = aaveReserves;
 exports.aaveTokens = aaveTokens;
 exports.aaveV4Oracles = aaveV4Oracles;
-exports.aaveV4Reserves = aaveV4Reserves;
+exports.aaveV4Peripherals = aaveV4Peripherals;
+exports.aaveV4SpokeLenderKey = aaveV4SpokeLenderKey;
 exports.aaveV4Spokes = aaveV4Spokes;
 exports.aaveWethGateway = aaveWethGateway;
 exports.chains = chains;
@@ -175,6 +283,13 @@ 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.getSiloV2MarketEntry = getSiloV2MarketEntry;
+exports.getSiloV3MarketEntry = getSiloV3MarketEntry;
 exports.initConfig = initConfig;
 exports.initializeChainData = initializeChainData;
 exports.initializeLenderData = initializeLenderData;
@@ -184,3 +299,12 @@ exports.morphoOracles = morphoOracles;
 exports.morphoPools = morphoPools;
 exports.morphoTypeMarkets = morphoTypeMarkets;
 exports.morphoTypeOracles = morphoTypeOracles;
+exports.parseAaveV4SpokeLenderKey = parseAaveV4SpokeLenderKey;
+exports.parseSiloV2LenderKey = parseSiloV2LenderKey;
+exports.parseSiloV3LenderKey = parseSiloV3LenderKey;
+exports.siloMarkets = siloMarkets;
+exports.siloMarketsV3 = siloMarketsV3;
+exports.siloPeripherals = siloPeripherals;
+exports.siloPeripheralsV3 = siloPeripheralsV3;
+exports.siloV2LenderKey = siloV2LenderKey;
+exports.siloV3LenderKey = siloV3LenderKey;

package/dist/index.mjs

@@ -38,8 +38,12 @@ globalThis[GLOBAL_LENDER_DATA_KEY] = {
   eulerConfigs: {},
   eulerVaults: {},
   aaveV4Spokes: {},
-  aaveV4Reserves: {},
-  aaveV4Oracles: {}
+  aaveV4Oracles: {},
+  aaveV4Peripherals: {},
+  siloMarkets: {},
+  siloPeripherals: {},
+  siloMarketsV3: {},
+  siloPeripheralsV3: {}
 };
 function getGlobalData2() {
   return globalThis[GLOBAL_LENDER_DATA_KEY];
@@ -71,8 +75,12 @@ function initializeLenderData({
   eulerConfigsOverride,
   eulerVaultsOverride,
   aaveV4SpokesOverride,
-  aaveV4ReservesOverride,
-  aaveV4OraclesOverride
+  aaveV4OraclesOverride,
+  aaveV4PeripheralsOverride,
+  siloMarketsOverride,
+  siloPeripheralsOverride,
+  siloMarketsV3Override,
+  siloPeripheralsV3Override
 }) {
   const data = getGlobalData2();
   if (aaveTokensOverride) data.aaveTokens = aaveTokensOverride;
@@ -101,8 +109,14 @@ function initializeLenderData({
   if (eulerConfigsOverride) data.eulerConfigs = eulerConfigsOverride;
   if (eulerVaultsOverride) data.eulerVaults = eulerVaultsOverride;
   if (aaveV4SpokesOverride) data.aaveV4Spokes = aaveV4SpokesOverride;
-  if (aaveV4ReservesOverride) data.aaveV4Reserves = aaveV4ReservesOverride;
   if (aaveV4OraclesOverride) data.aaveV4Oracles = aaveV4OraclesOverride;
+  if (aaveV4PeripheralsOverride)
+    data.aaveV4Peripherals = aaveV4PeripheralsOverride;
+  if (siloMarketsOverride) data.siloMarkets = siloMarketsOverride;
+  if (siloPeripheralsOverride) data.siloPeripherals = siloPeripheralsOverride;
+  if (siloMarketsV3Override) data.siloMarketsV3 = siloMarketsV3Override;
+  if (siloPeripheralsV3Override)
+    data.siloPeripheralsV3 = siloPeripheralsV3Override;
 }
 var aaveTokens = () => getGlobalData2()?.aaveTokens;
 var aavePools = () => getGlobalData2()?.aavePools;
@@ -130,8 +144,101 @@ var compoundV3Bulker = () => getGlobalData2()?.compoundV3Bulker;
 var eulerConfigs = () => getGlobalData2()?.eulerConfigs;
 var eulerVaults = () => getGlobalData2()?.eulerVaults;
 var aaveV4Spokes = () => getGlobalData2()?.aaveV4Spokes;
-var aaveV4Reserves = () => getGlobalData2()?.aaveV4Reserves;
 var aaveV4Oracles = () => getGlobalData2()?.aaveV4Oracles;
+var aaveV4Peripherals = () => getGlobalData2()?.aaveV4Peripherals;
+var siloMarkets = () => getGlobalData2()?.siloMarkets;
+var siloPeripherals = () => getGlobalData2()?.siloPeripherals;
+var siloMarketsV3 = () => getGlobalData2()?.siloMarketsV3;
+var siloPeripheralsV3 = () => getGlobalData2()?.siloPeripheralsV3;
+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() };
+}
+function siloV2LenderKey(siloConfig) {
+  if (!siloConfig || !siloConfig.startsWith("0x") || siloConfig.length !== 42) {
+    throw new Error(`siloV2LenderKey: invalid siloConfig address ${siloConfig}`);
+  }
+  return `SILO_V2_${siloConfig.slice(2).toUpperCase()}`;
+}
+function parseSiloV2LenderKey(lenderKey) {
+  const match = lenderKey.match(/^SILO_V2_([0-9A-F]{40})$/);
+  if (!match) return void 0;
+  return { siloConfigAddrLower: "0x" + match[1].toLowerCase() };
+}
+function getSiloV2MarketEntry(chainId, lenderKey) {
+  const parsed = parseSiloV2LenderKey(lenderKey);
+  if (!parsed) return void 0;
+  const list = getGlobalData2()?.siloMarkets?.[chainId];
+  if (!list) return void 0;
+  return list.find(
+    (m) => m.siloConfig.toLowerCase() === parsed.siloConfigAddrLower
+  );
+}
+function siloV3LenderKey(siloConfig) {
+  if (!siloConfig || !siloConfig.startsWith("0x") || siloConfig.length !== 42) {
+    throw new Error(`siloV3LenderKey: invalid siloConfig address ${siloConfig}`);
+  }
+  return `SILO_V3_${siloConfig.slice(2).toUpperCase()}`;
+}
+function parseSiloV3LenderKey(lenderKey) {
+  const match = lenderKey.match(/^SILO_V3_([0-9A-F]{40})$/);
+  if (!match) return void 0;
+  return { siloConfigAddrLower: "0x" + match[1].toLowerCase() };
+}
+function getSiloV3MarketEntry(chainId, lenderKey) {
+  const parsed = parseSiloV3LenderKey(lenderKey);
+  if (!parsed) return void 0;
+  const list = getGlobalData2()?.siloMarketsV3?.[chainId];
+  if (!list) return void 0;
+  return list.find(
+    (m) => m.siloConfig.toLowerCase() === parsed.siloConfigAddrLower
+  );
+}
 
 // src/tokens.ts
 var getListUrl = (chainId) => `https://raw.githubusercontent.com/1delta-DAO/token-lists/main/${chainId}.json`;
@@ -149,4 +256,4 @@ async function fetchTokenLists(chainIds) {
   return Object.fromEntries(results);
 }
 
-export { aaveOracles, aaveOraclesConfig, aavePools, aaveReserves, aaveTokens, aaveV4Oracles, aaveV4Reserves, aaveV4Spokes, 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, getSiloV2MarketEntry, getSiloV3MarketEntry, initConfig, initializeChainData, initializeLenderData, listaNativeProvider, morphoBundler3, morphoOracles, morphoPools, morphoTypeMarkets, morphoTypeOracles, parseAaveV4SpokeLenderKey, parseSiloV2LenderKey, parseSiloV3LenderKey, siloMarkets, siloMarketsV3, siloPeripherals, siloPeripheralsV3, siloV2LenderKey, siloV3LenderKey };

package/dist/lending.d.ts

@@ -174,18 +174,113 @@ type EulerVaultsType = {
         [chainId: string]: EulerVaultEntry[];
     };
 };
-type AaveV4SpokeEntry = {
+export type SiloHalfStatic = {
+    /** silo (vault) address */
+    silo: string;
+    /** underlying borrowable asset for this side */
+    token: string;
+    /** ERC-20 decimals for `token`, cached to avoid an extra RPC */
+    decimals: number;
+    /** Optional symbol cache for UI; not consumed by the fetcher */
+    symbol?: string;
+    /** Share-token addresses (for user-data fetchers / liquidations) */
+    protectedShareToken: string;
+    collateralShareToken: string;
+    debtShareToken: string;
+    /** Per-side oracles (1e18-scaled price quoting) */
+    solvencyOracle: string;
+    maxLtvOracle: string;
+    /** Interest rate model contract */
+    interestRateModel: string;
+    /** LTV at 1e18 scale */
+    maxLtv: string;
+    /** Liquidation threshold (LLTV) at 1e18 scale */
+    lt: string;
+    /** Target LTV after liquidation (1e18) */
+    liquidationTargetLtv: string;
+    /** Fee parameters (1e18) */
+    liquidationFee: string;
+    flashloanFee: string;
+    daoFee: string;
+    deployerFee: string;
+    /** Optional hook receiver / quote-before flag */
+    hookReceiver?: string;
+    callBeforeQuote?: boolean;
+};
+export type SiloMarketEntry = {
+    /** Shared SiloConfig address (one per pair) */
+    siloConfig: string;
+    /** Optional human-readable name from the factory event / curated list */
+    name?: string;
+    silo0: SiloHalfStatic;
+    silo1: SiloHalfStatic;
+};
+/**
+ * chainId → list of (silo0, silo1) pairs.
+ *
+ * Stored as an array to match the on-disk `silo-v2-markets.json` shape.
+ * Per-chain pair counts are small (~100 max), so the linear lookup in
+ * `getSiloV2MarketEntry` is fine. If that ever changes, build an index
+ * lazily here.
+ */
+export type SiloMarketsType = {
+    [chainId: string]: SiloMarketEntry[];
+};
+/**
+ * Per-chain Silo v2 peripheral / singleton addresses.
+ *
+ * Both `lens` and `factory` are deployed once per chain and shared by every
+ * Silo v2 market on that chain, so they live together in one map instead of
+ * being split across `siloLens` / `siloFactory`. Add new chain-wide
+ * singletons (e.g. `siloRouter`, `siloIncentivesController`) here.
+ */
+export type SiloPeripheralsEntry = {
+    /** SiloLens (v2) — exposes getDepositAPR / getBorrowAPR / getUtilization */
+    lens: string;
+    /** SiloFactory — used by the initializer to discover deployed silo pairs */
+    factory: string;
+    /** Optional: router / wrapped-native gateway, populated when needed */
+    router?: string;
+    /** Optional: incentives controller for reward APR */
+    incentivesController?: string;
+};
+/** chainId → Silo v2 peripheral addresses */
+export type SiloPeripheralsType = {
+    [chainId: string]: SiloPeripheralsEntry;
+};
+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;
-    hub?: string;
-};
-type AaveV4SpokesType = {
-    [fork: string]: {
-        [chainId: string]: AaveV4SpokeEntry[];
+    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;
     };
 };
-type AaveV4OracleEntry = {
+export type AaveV4OracleEntry = {
     underlying: string;
     spoke: string;
     reserveId: number;
@@ -193,25 +288,48 @@ type AaveV4OracleEntry = {
     decimals?: number;
     source?: string;
 };
-type AaveV4OraclesType = {
-    [fork: string]: {
-        [chainId: string]: AaveV4OracleEntry[];
+/** 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;
     };
-};
-type AaveV4ReserveEntry = {
-    reserveId: number;
-    assetId: number;
-    underlying: string;
-};
-type AaveV4ReservesType = {
-    [fork: string]: {
-        [chainId: string]: {
-            [spokeAddress: string]: AaveV4ReserveEntry[];
-        };
+    /** 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, aaveV4SpokesOverride, aaveV4ReservesOverride, aaveV4OraclesOverride, }: {
+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, siloMarketsOverride, siloPeripheralsOverride, siloMarketsV3Override, siloPeripheralsV3Override, }: {
     aaveTokensOverride?: AaveTokensType;
     aavePoolsOverride?: AavePoolsType;
     aaveOraclesOverride?: OracleMap;
@@ -238,8 +356,12 @@ export declare function initializeLenderData({ aaveTokensOverride, aavePoolsOver
     eulerConfigsOverride?: EulerConfigsType;
     eulerVaultsOverride?: EulerVaultsType;
     aaveV4SpokesOverride?: AaveV4SpokesType;
-    aaveV4ReservesOverride?: AaveV4ReservesType;
     aaveV4OraclesOverride?: AaveV4OraclesType;
+    aaveV4PeripheralsOverride?: AaveV4PeripheralsType;
+    siloMarketsOverride?: SiloMarketsType;
+    siloPeripheralsOverride?: SiloPeripheralsType;
+    siloMarketsV3Override?: SiloMarketsType;
+    siloPeripheralsV3Override?: SiloPeripheralsType;
 }): void;
 export declare const aaveTokens: () => AaveTokensType;
 export declare const aavePools: () => AavePoolsType;
@@ -267,6 +389,146 @@ export declare const compoundV3Bulker: () => CompoundV3BulkerType;
 export declare const eulerConfigs: () => EulerConfigsType;
 export declare const eulerVaults: () => EulerVaultsType;
 export declare const aaveV4Spokes: () => AaveV4SpokesType;
-export declare const aaveV4Reserves: () => AaveV4ReservesType;
 export declare const aaveV4Oracles: () => AaveV4OraclesType;
+export declare const aaveV4Peripherals: () => AaveV4PeripheralsType;
+export declare const siloMarkets: () => SiloMarketsType;
+export declare const siloPeripherals: () => SiloPeripheralsType;
+export declare const siloMarketsV3: () => SiloMarketsType;
+export declare const siloPeripheralsV3: () => SiloPeripheralsType;
+/**
+ * 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;
+/**
+ * Synthesize the per-pair lender key for a Silo v2 market.
+ *
+ * Mirrors `aaveV4SpokeLenderKey` and the Morpho `MORPHO_BLUE_<HEX>`
+ * convention so each Silo pair shows up as its own isolated lender —
+ * exactly like an Aave V4 spoke or a Morpho Blue market — without any
+ * Silo-specific routing logic in the rest of the codebase.
+ *
+ * Format: `SILO_V2_${siloConfigAddr.slice(2).toUpperCase()}`
+ *
+ * Keyed by `SiloConfig` rather than either silo because the config is the
+ * stable, shared identity of the pair (silo0/silo1 are derived from it).
+ *
+ * `isSiloV2Type()` works on this because it matches `startsWith('SILO_V2')`.
+ */
+export declare function siloV2LenderKey(siloConfig: string): string;
+/**
+ * Inverse of `siloV2LenderKey`: given a per-pair lender key, return
+ * `{ siloConfigAddrLower }`. Returns `undefined` if the key isn't a per-pair
+ * Silo v2 key (e.g. someone passed the bare prefix `SILO_V2`).
+ */
+export declare function parseSiloV2LenderKey(lenderKey: string): {
+    siloConfigAddrLower: string;
+} | undefined;
+/**
+ * Look up a Silo v2 market entry by per-pair lender key.
+ * Returns `undefined` if no entry exists for that chain/config.
+ */
+export declare function getSiloV2MarketEntry(chainId: string, lenderKey: string): SiloMarketEntry | undefined;
+/**
+ * Silo v3 per-pair lender key helpers.
+ *
+ * Silo v3 uses the exact same on-chain data model and metadata shape as v2
+ * (`SiloMarketEntry`/`SiloHalfStatic`) — only the deployment set, factory
+ * and indexer protocol tag differ — so v3 pairs get their own isolated
+ * lender token namespace (`SILO_V3_<HEX>`) and live in a separate
+ * `siloMarketsV3` registry slot. Keeping the two separate means a v2 and
+ * v3 pair with the same `SiloConfig` address could in principle coexist
+ * without clashing, and downstream consumers can filter by prefix.
+ *
+ * Format: `SILO_V3_${siloConfigAddr.slice(2).toUpperCase()}`
+ */
+export declare function siloV3LenderKey(siloConfig: string): string;
+export declare function parseSiloV3LenderKey(lenderKey: string): {
+    siloConfigAddrLower: string;
+} | undefined;
+/**
+ * Look up a Silo v3 market entry by per-pair lender key.
+ * Returns `undefined` if no entry exists for that chain/config.
+ */
+export declare function getSiloV3MarketEntry(chainId: string, lenderKey: string): SiloMarketEntry | undefined;
 export {};

package/package.json

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