@1delta/data-sdk 0.0.46 → 0.0.47

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './chains';
 export * from './lending';
+export * from './remoteCache';
 export * from './tokens';

package/dist/index.js

@@ -862,12 +862,143 @@ var parseFraxlendPairKey = (lender) => {
   return { chainId: m[1], pair: m[2].toLowerCase() };
 };
 
+// src/remoteCache.ts
+var FRESH_TTL_MS = 5 * 60 * 1e3;
+var REMOTE_CACHE_STORE_TTL_S = 7 * 24 * 60 * 60;
+var STATE_KEY = "__1delta_remote_cache__";
+function getState() {
+  const g = globalThis;
+  if (!g[STATE_KEY]) g[STATE_KEY] = { memo: /* @__PURE__ */ new Map(), inflight: /* @__PURE__ */ new Map() };
+  return g[STATE_KEY];
+}
+function setRemoteCacheStore(next) {
+  getState().store = next;
+}
+function setRemoteCacheGithubToken(token) {
+  getState().githubToken = token;
+}
+function clearRemoteCache() {
+  const state = getState();
+  state.memo.clear();
+  state.inflight.clear();
+}
+var RAW_HOST = "https://raw.githubusercontent.com/";
+function githubApiMirror(url) {
+  if (!url.startsWith(RAW_HOST)) return void 0;
+  const [owner, repo, ref, ...path] = url.slice(RAW_HOST.length).split("/");
+  if (!owner || !repo || !ref || path.length === 0) return void 0;
+  return `https://api.github.com/repos/${owner}/${repo}/contents/${path.join("/")}?ref=${ref}`;
+}
+var RemoteFetchError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "RemoteFetchError";
+  }
+  /** 404/410 — re-fetching cannot change the answer. */
+  get isMissing() {
+    return this.status === 404 || this.status === 410;
+  }
+};
+async function fetchRemoteJson(url, label) {
+  const res = await fetch(url);
+  if (res.ok) return await res.json();
+  const mirror = githubApiMirror(url);
+  const worthRetrying = res.status === 429 || res.status >= 500;
+  if (!mirror || !worthRetrying) {
+    throw new RemoteFetchError(`${label} fetch failed: HTTP ${res.status} from ${new URL(url).host}`, res.status);
+  }
+  const headers = {
+    Accept: "application/vnd.github.raw",
+    // The GitHub API rejects a request that sends no User-Agent.
+    "User-Agent": "1delta-data-sdk"
+  };
+  const token = getState().githubToken;
+  if (token) headers.Authorization = `Bearer ${token}`;
+  const viaApi = await fetch(mirror, { headers });
+  if (!viaApi.ok) {
+    throw new RemoteFetchError(
+      `${label} fetch failed: HTTP ${res.status} from raw.githubusercontent.com, HTTP ${viaApi.status} from api.github.com`,
+      res.status
+    );
+  }
+  return await viaApi.json();
+}
+var storeKey = (key) => `remote-cache:v1:${key}`;
+async function readStore(key, isValid) {
+  const { store } = getState();
+  if (!store) return void 0;
+  try {
+    const raw = await store.get(storeKey(key));
+    if (!raw) return void 0;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.at !== "number" || !isValid(parsed.value)) return void 0;
+    return parsed;
+  } catch {
+    return void 0;
+  }
+}
+async function writeStore(key, entry) {
+  const { store } = getState();
+  if (!store) return;
+  try {
+    await store.put(storeKey(key), JSON.stringify(entry), REMOTE_CACHE_STORE_TTL_S);
+  } catch {
+  }
+}
+async function loadCached(key, load, isValid) {
+  const { memo, inflight } = getState();
+  const cached = memo.get(key);
+  if (cached && Date.now() - cached.at < FRESH_TTL_MS) return cached.value;
+  const pending = inflight.get(key);
+  if (pending) return pending;
+  const task = (async () => {
+    const stored = await readStore(key, isValid);
+    if (stored && Date.now() - stored.at < FRESH_TTL_MS) {
+      memo.set(key, stored);
+      return stored.value;
+    }
+    try {
+      const value = await load();
+      const entry = { at: Date.now(), value };
+      memo.set(key, entry);
+      await writeStore(key, entry);
+      return value;
+    } catch (error) {
+      const stale = memo.get(key) ?? stored;
+      if (!stale) throw error;
+      memo.set(key, stale);
+      return stale.value;
+    }
+  })().finally(() => {
+    inflight.delete(key);
+  });
+  inflight.set(key, task);
+  return task;
+}
+async function loadCachedJson(key, url, isValid, label = key) {
+  return loadCached(key, () => fetchRemoteJson(url, label), isValid);
+}
+
 // src/tokens.ts
 var getListUrl = (chainId) => `https://raw.githubusercontent.com/1delta-DAO/token-lists/main/${chainId}.json`;
+var MAIN_TOKENS_URL = "https://raw.githubusercontent.com/1delta-DAO/token-lists/main/main-tokens.json";
+var isTokenListFile = (value) => !!value?.list && typeof value.list === "object";
+async function loadTokenListFile(chainId) {
+  return loadCached(
+    `token-list:${chainId}`,
+    async () => {
+      const json = await fetchRemoteJson(getListUrl(chainId), `Token list for chain ${chainId}`);
+      return {
+        list: json.list,
+        mainTokens: json.mainTokens ?? []
+      };
+    },
+    isTokenListFile
+  );
+}
 async function fetchTokenList(chainId) {
-  const data = await fetch(getListUrl(chainId));
-  if (!data.ok) throw new Error(`HTTP error! status: ${data.status}`);
-  return (await data.json()).list;
+  return (await loadTokenListFile(chainId)).list;
 }
 async function fetchTokenLists(chainIds) {
   const promises = chainIds.map(async (chainId) => {
@@ -878,25 +1009,27 @@ async function fetchTokenLists(chainIds) {
   return Object.fromEntries(results);
 }
 async function fetchTokenListFile(chainId) {
-  const data = await fetch(getListUrl(chainId));
-  if (!data.ok) throw new Error(`HTTP error! status: ${data.status}`);
-  const json = await data.json();
-  return {
-    list: json.list,
-    mainTokens: json.mainTokens ?? []
-  };
+  const file = await loadTokenListFile(chainId);
+  return { list: file.list, mainTokens: file.mainTokens };
 }
-var MAIN_TOKENS_URL = "https://raw.githubusercontent.com/1delta-DAO/token-lists/main/main-tokens.json";
 async function fetchMainTokensMap() {
-  const data = await fetch(MAIN_TOKENS_URL);
-  if (!data.ok) return void 0;
-  return await data.json();
+  try {
+    return await loadCached(
+      "main-tokens",
+      () => fetchRemoteJson(MAIN_TOKENS_URL, "main-tokens"),
+      (value) => !!value && typeof value === "object"
+    );
+  } catch {
+    return void 0;
+  }
 }
 
 exports.CURVANCE_MONAD_CONFIG = CURVANCE_MONAD_CONFIG;
 exports.FRAXLEND_ETHEREUM_CONFIG = FRAXLEND_ETHEREUM_CONFIG;
 exports.GEARBOX_ACCOUNT_COMPRESSOR_V310 = GEARBOX_ACCOUNT_COMPRESSOR_V310;
+exports.REMOTE_CACHE_STORE_TTL_S = REMOTE_CACHE_STORE_TTL_S;
 exports.RESUPPLY_ETHEREUM_CONFIG = RESUPPLY_ETHEREUM_CONFIG;
+exports.RemoteFetchError = RemoteFetchError;
 exports.aaveOracles = aaveOracles;
 exports.aaveOraclesConfig = aaveOraclesConfig;
 exports.aavePools = aavePools;
@@ -909,6 +1042,7 @@ exports.aaveV4Spokes = aaveV4Spokes;
 exports.aaveWethGateway = aaveWethGateway;
 exports.chainLogoURI = chainLogoURI;
 exports.chains = chains;
+exports.clearRemoteCache = clearRemoteCache;
 exports.compoundV2Oracles = compoundV2Oracles;
 exports.compoundV2OraclesConfig = compoundV2OraclesConfig;
 exports.compoundV2Pools = compoundV2Pools;
@@ -942,6 +1076,7 @@ exports.exactlyMarketByAsset = exactlyMarketByAsset;
 exports.exactlyMarkets = exactlyMarkets;
 exports.exactlyMarketsByChain = exactlyMarketsByChain;
 exports.fetchMainTokensMap = fetchMainTokensMap;
+exports.fetchRemoteJson = fetchRemoteJson;
 exports.fetchTokenList = fetchTokenList;
 exports.fetchTokenListFile = fetchTokenListFile;
 exports.fetchTokenLists = fetchTokenLists;
@@ -1011,6 +1146,8 @@ exports.llamaLendMarketByVault = llamaLendMarketByVault;
 exports.llamaLendMarkets = llamaLendMarkets;
 exports.llamaLendSupportsDelegation = llamaLendSupportsDelegation;
 exports.llamaLendSupportsLeverage = llamaLendSupportsLeverage;
+exports.loadCached = loadCached;
+exports.loadCachedJson = loadCachedJson;
 exports.midnightApiBaseOverride = midnightApiBaseOverride;
 exports.midnightConfig = midnightConfig;
 exports.midnightMarketById = midnightMarketById;
@@ -1041,6 +1178,8 @@ exports.riverLendersByChain = riverLendersByChain;
 exports.riverMarketByIndex = riverMarketByIndex;
 exports.riverMarkets = riverMarkets;
 exports.setMidnightApiBase = setMidnightApiBase;
+exports.setRemoteCacheGithubToken = setRemoteCacheGithubToken;
+exports.setRemoteCacheStore = setRemoteCacheStore;
 exports.setTermApiBase = setTermApiBase;
 exports.siloMarkets = siloMarkets;
 exports.siloMarketsV3 = siloMarketsV3;

package/dist/index.mjs

@@ -860,12 +860,143 @@ var parseFraxlendPairKey = (lender) => {
   return { chainId: m[1], pair: m[2].toLowerCase() };
 };
 
+// src/remoteCache.ts
+var FRESH_TTL_MS = 5 * 60 * 1e3;
+var REMOTE_CACHE_STORE_TTL_S = 7 * 24 * 60 * 60;
+var STATE_KEY = "__1delta_remote_cache__";
+function getState() {
+  const g = globalThis;
+  if (!g[STATE_KEY]) g[STATE_KEY] = { memo: /* @__PURE__ */ new Map(), inflight: /* @__PURE__ */ new Map() };
+  return g[STATE_KEY];
+}
+function setRemoteCacheStore(next) {
+  getState().store = next;
+}
+function setRemoteCacheGithubToken(token) {
+  getState().githubToken = token;
+}
+function clearRemoteCache() {
+  const state = getState();
+  state.memo.clear();
+  state.inflight.clear();
+}
+var RAW_HOST = "https://raw.githubusercontent.com/";
+function githubApiMirror(url) {
+  if (!url.startsWith(RAW_HOST)) return void 0;
+  const [owner, repo, ref, ...path] = url.slice(RAW_HOST.length).split("/");
+  if (!owner || !repo || !ref || path.length === 0) return void 0;
+  return `https://api.github.com/repos/${owner}/${repo}/contents/${path.join("/")}?ref=${ref}`;
+}
+var RemoteFetchError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "RemoteFetchError";
+  }
+  /** 404/410 — re-fetching cannot change the answer. */
+  get isMissing() {
+    return this.status === 404 || this.status === 410;
+  }
+};
+async function fetchRemoteJson(url, label) {
+  const res = await fetch(url);
+  if (res.ok) return await res.json();
+  const mirror = githubApiMirror(url);
+  const worthRetrying = res.status === 429 || res.status >= 500;
+  if (!mirror || !worthRetrying) {
+    throw new RemoteFetchError(`${label} fetch failed: HTTP ${res.status} from ${new URL(url).host}`, res.status);
+  }
+  const headers = {
+    Accept: "application/vnd.github.raw",
+    // The GitHub API rejects a request that sends no User-Agent.
+    "User-Agent": "1delta-data-sdk"
+  };
+  const token = getState().githubToken;
+  if (token) headers.Authorization = `Bearer ${token}`;
+  const viaApi = await fetch(mirror, { headers });
+  if (!viaApi.ok) {
+    throw new RemoteFetchError(
+      `${label} fetch failed: HTTP ${res.status} from raw.githubusercontent.com, HTTP ${viaApi.status} from api.github.com`,
+      res.status
+    );
+  }
+  return await viaApi.json();
+}
+var storeKey = (key) => `remote-cache:v1:${key}`;
+async function readStore(key, isValid) {
+  const { store } = getState();
+  if (!store) return void 0;
+  try {
+    const raw = await store.get(storeKey(key));
+    if (!raw) return void 0;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.at !== "number" || !isValid(parsed.value)) return void 0;
+    return parsed;
+  } catch {
+    return void 0;
+  }
+}
+async function writeStore(key, entry) {
+  const { store } = getState();
+  if (!store) return;
+  try {
+    await store.put(storeKey(key), JSON.stringify(entry), REMOTE_CACHE_STORE_TTL_S);
+  } catch {
+  }
+}
+async function loadCached(key, load, isValid) {
+  const { memo, inflight } = getState();
+  const cached = memo.get(key);
+  if (cached && Date.now() - cached.at < FRESH_TTL_MS) return cached.value;
+  const pending = inflight.get(key);
+  if (pending) return pending;
+  const task = (async () => {
+    const stored = await readStore(key, isValid);
+    if (stored && Date.now() - stored.at < FRESH_TTL_MS) {
+      memo.set(key, stored);
+      return stored.value;
+    }
+    try {
+      const value = await load();
+      const entry = { at: Date.now(), value };
+      memo.set(key, entry);
+      await writeStore(key, entry);
+      return value;
+    } catch (error) {
+      const stale = memo.get(key) ?? stored;
+      if (!stale) throw error;
+      memo.set(key, stale);
+      return stale.value;
+    }
+  })().finally(() => {
+    inflight.delete(key);
+  });
+  inflight.set(key, task);
+  return task;
+}
+async function loadCachedJson(key, url, isValid, label = key) {
+  return loadCached(key, () => fetchRemoteJson(url, label), isValid);
+}
+
 // src/tokens.ts
 var getListUrl = (chainId) => `https://raw.githubusercontent.com/1delta-DAO/token-lists/main/${chainId}.json`;
+var MAIN_TOKENS_URL = "https://raw.githubusercontent.com/1delta-DAO/token-lists/main/main-tokens.json";
+var isTokenListFile = (value) => !!value?.list && typeof value.list === "object";
+async function loadTokenListFile(chainId) {
+  return loadCached(
+    `token-list:${chainId}`,
+    async () => {
+      const json = await fetchRemoteJson(getListUrl(chainId), `Token list for chain ${chainId}`);
+      return {
+        list: json.list,
+        mainTokens: json.mainTokens ?? []
+      };
+    },
+    isTokenListFile
+  );
+}
 async function fetchTokenList(chainId) {
-  const data = await fetch(getListUrl(chainId));
-  if (!data.ok) throw new Error(`HTTP error! status: ${data.status}`);
-  return (await data.json()).list;
+  return (await loadTokenListFile(chainId)).list;
 }
 async function fetchTokenLists(chainIds) {
   const promises = chainIds.map(async (chainId) => {
@@ -876,19 +1007,19 @@ async function fetchTokenLists(chainIds) {
   return Object.fromEntries(results);
 }
 async function fetchTokenListFile(chainId) {
-  const data = await fetch(getListUrl(chainId));
-  if (!data.ok) throw new Error(`HTTP error! status: ${data.status}`);
-  const json = await data.json();
-  return {
-    list: json.list,
-    mainTokens: json.mainTokens ?? []
-  };
+  const file = await loadTokenListFile(chainId);
+  return { list: file.list, mainTokens: file.mainTokens };
 }
-var MAIN_TOKENS_URL = "https://raw.githubusercontent.com/1delta-DAO/token-lists/main/main-tokens.json";
 async function fetchMainTokensMap() {
-  const data = await fetch(MAIN_TOKENS_URL);
-  if (!data.ok) return void 0;
-  return await data.json();
+  try {
+    return await loadCached(
+      "main-tokens",
+      () => fetchRemoteJson(MAIN_TOKENS_URL, "main-tokens"),
+      (value) => !!value && typeof value === "object"
+    );
+  } catch {
+    return void 0;
+  }
 }
 
-export { CURVANCE_MONAD_CONFIG, FRAXLEND_ETHEREUM_CONFIG, GEARBOX_ACCOUNT_COMPRESSOR_V310, RESUPPLY_ETHEREUM_CONFIG, aaveOracles, aaveOraclesConfig, aavePools, aaveReserves, aaveTokens, aaveV4Oracles, aaveV4Peripherals, aaveV4SpokeLenderKey, aaveV4Spokes, aaveWethGateway, chainLogoURI, chains, compoundV2Oracles, compoundV2OraclesConfig, compoundV2Pools, compoundV2Reserves, compoundV2TokenArray, compoundV2Tokens, compoundV3BaseData, compoundV3Bulker, compoundV3OraclesData, compoundV3Pools, compoundV3Reserves, curvanceConfig, curvanceConfigFor, curvanceLendersByChain, curvancePositionManager, curvancePositionManagersFor, dolomiteChains, dolomiteConfigs, dolomiteEmode, dolomiteMarketIdByToken, dssChainData, dssConfigFor, dssDebtJoin, dssDebtToken, dssMarketByIlk, eulerConfigs, eulerVaults, exactlyConfig, exactlyMarketByAddress, exactlyMarketByAsset, exactlyMarkets, exactlyMarketsByChain, fetchMainTokensMap, fetchTokenList, fetchTokenListFile, fetchTokenLists, findAaveV4PositionManager, fluidChains, fluidResolvers, fluidVaultEntries, fluidVaults, frankencoinChainData, frankencoinConfig, frankencoinConfigFor, frankencoinLendersByChain, frankencoinMarketByPosition, frankencoinMarkets, fraxlendConfig, fraxlendConfigFor, fraxlendLendersByChain, fraxlendPairKey, fraxlendPairsFor, gearboxAccountCompressor, gearboxAddressProviderV310, gearboxBotListV3, gearboxChains, gearboxMarketCompressor, gearboxMarketConfigurators, gearboxResolvers, gearboxV3LenderKey, getAaveV4GatewayAddresses, getAaveV4PositionManagers, getAaveV4SpokeAccess, getAaveV4SpokeEntry, getAaveV4SpokePeripherals, getChainEntries, getSiloV2MarketEntry, getSiloV3MarketEntry, initConfig, initializeChainData, initializeLenderData, inverseChainData, inverseConfig, inverseConfigFor, inverseLendersByChain, inverseMarketByAddress, inverseMarkets, isAaveV4OperationRestricted, isListaSmartLpAsset, liquityBranchByIndex, liquityBranchByTroveManager, liquityBranchesByChain, liquityConfig, liquityConfigFor, liquityLendersByChain, liquityMarkets, listaCollateralProvider, listaCollateralProviders, listaNativeProvider, listaSmartLpByCollateral, llamaLendApiBaseUrl, llamaLendChainData, llamaLendConfig, llamaLendConfigFor, llamaLendLenderKey, llamaLendLendersByChain, llamaLendLeverageZap, llamaLendMarketByController, llamaLendMarketByVault, llamaLendMarkets, llamaLendSupportsDelegation, llamaLendSupportsLeverage, midnightApiBaseOverride, midnightConfig, midnightMarketById, midnightMarkets, midnightMarketsByChain, morphoBundler3, morphoOracles, morphoPools, morphoTypeMarkets, morphoTypeOracles, morphoTypeVaults, parseAaveV4SpokeLenderKey, parseFraxlendPairKey, parseGearboxV3LenderKey, parseLlamaLendLenderKey, parseSiloV2LenderKey, parseSiloV3LenderKey, parseTermMaxLenderKey, resolveMidnightApiBase, resolveTermApiBase, resupplyConfig, resupplyConfigFor, resupplyLendersByChain, riverChainData, riverConfig, riverConfigFor, riverLendersByChain, riverMarketByIndex, riverMarkets, setMidnightApiBase, setTermApiBase, siloMarkets, siloMarketsV3, siloPeripherals, siloPeripheralsV3, siloV2LenderKey, siloV3LenderKey, skyChainData, skyConfig, skyConfigFor, skyLendersByChain, skyMarkets, tellerConfig, tellerConfigByChain, tellerPoolByAddress, tellerPools, tellerPoolsByChain, termApiBaseOverride, termConfig, termMarketById, termMarkets, termMarketsByChain, termMaxApiBaseUrl, termMaxChainIds, termMaxConfig, termMaxConfigByChain, termMaxLenderKey, usddChainData, usddConfig, usddConfigFor, usddLendersByChain, usddMarketByIlk, usddMarkets };
+export { CURVANCE_MONAD_CONFIG, FRAXLEND_ETHEREUM_CONFIG, GEARBOX_ACCOUNT_COMPRESSOR_V310, REMOTE_CACHE_STORE_TTL_S, RESUPPLY_ETHEREUM_CONFIG, RemoteFetchError, aaveOracles, aaveOraclesConfig, aavePools, aaveReserves, aaveTokens, aaveV4Oracles, aaveV4Peripherals, aaveV4SpokeLenderKey, aaveV4Spokes, aaveWethGateway, chainLogoURI, chains, clearRemoteCache, compoundV2Oracles, compoundV2OraclesConfig, compoundV2Pools, compoundV2Reserves, compoundV2TokenArray, compoundV2Tokens, compoundV3BaseData, compoundV3Bulker, compoundV3OraclesData, compoundV3Pools, compoundV3Reserves, curvanceConfig, curvanceConfigFor, curvanceLendersByChain, curvancePositionManager, curvancePositionManagersFor, dolomiteChains, dolomiteConfigs, dolomiteEmode, dolomiteMarketIdByToken, dssChainData, dssConfigFor, dssDebtJoin, dssDebtToken, dssMarketByIlk, eulerConfigs, eulerVaults, exactlyConfig, exactlyMarketByAddress, exactlyMarketByAsset, exactlyMarkets, exactlyMarketsByChain, fetchMainTokensMap, fetchRemoteJson, fetchTokenList, fetchTokenListFile, fetchTokenLists, findAaveV4PositionManager, fluidChains, fluidResolvers, fluidVaultEntries, fluidVaults, frankencoinChainData, frankencoinConfig, frankencoinConfigFor, frankencoinLendersByChain, frankencoinMarketByPosition, frankencoinMarkets, fraxlendConfig, fraxlendConfigFor, fraxlendLendersByChain, fraxlendPairKey, fraxlendPairsFor, gearboxAccountCompressor, gearboxAddressProviderV310, gearboxBotListV3, gearboxChains, gearboxMarketCompressor, gearboxMarketConfigurators, gearboxResolvers, gearboxV3LenderKey, getAaveV4GatewayAddresses, getAaveV4PositionManagers, getAaveV4SpokeAccess, getAaveV4SpokeEntry, getAaveV4SpokePeripherals, getChainEntries, getSiloV2MarketEntry, getSiloV3MarketEntry, initConfig, initializeChainData, initializeLenderData, inverseChainData, inverseConfig, inverseConfigFor, inverseLendersByChain, inverseMarketByAddress, inverseMarkets, isAaveV4OperationRestricted, isListaSmartLpAsset, liquityBranchByIndex, liquityBranchByTroveManager, liquityBranchesByChain, liquityConfig, liquityConfigFor, liquityLendersByChain, liquityMarkets, listaCollateralProvider, listaCollateralProviders, listaNativeProvider, listaSmartLpByCollateral, llamaLendApiBaseUrl, llamaLendChainData, llamaLendConfig, llamaLendConfigFor, llamaLendLenderKey, llamaLendLendersByChain, llamaLendLeverageZap, llamaLendMarketByController, llamaLendMarketByVault, llamaLendMarkets, llamaLendSupportsDelegation, llamaLendSupportsLeverage, loadCached, loadCachedJson, midnightApiBaseOverride, midnightConfig, midnightMarketById, midnightMarkets, midnightMarketsByChain, morphoBundler3, morphoOracles, morphoPools, morphoTypeMarkets, morphoTypeOracles, morphoTypeVaults, parseAaveV4SpokeLenderKey, parseFraxlendPairKey, parseGearboxV3LenderKey, parseLlamaLendLenderKey, parseSiloV2LenderKey, parseSiloV3LenderKey, parseTermMaxLenderKey, resolveMidnightApiBase, resolveTermApiBase, resupplyConfig, resupplyConfigFor, resupplyLendersByChain, riverChainData, riverConfig, riverConfigFor, riverLendersByChain, riverMarketByIndex, riverMarkets, setMidnightApiBase, setRemoteCacheGithubToken, setRemoteCacheStore, setTermApiBase, siloMarkets, siloMarketsV3, siloPeripherals, siloPeripheralsV3, siloV2LenderKey, siloV3LenderKey, skyChainData, skyConfig, skyConfigFor, skyLendersByChain, skyMarkets, tellerConfig, tellerConfigByChain, tellerPoolByAddress, tellerPools, tellerPoolsByChain, termApiBaseOverride, termConfig, termMarketById, termMarkets, termMarketsByChain, termMaxApiBaseUrl, termMaxChainIds, termMaxConfig, termMaxConfigByChain, termMaxLenderKey, usddChainData, usddConfig, usddConfigFor, usddLendersByChain, usddMarketByIlk, usddMarkets };

package/dist/remoteCache.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Cache for the static JSON this SDK reads from GitHub (token lists, the chain
+ * registry).
+ *
+ * raw.githubusercontent.com rate-limits per EGRESS IP, and Cloudflare Workers
+ * share theirs — so an uncached fetch per request 429s in bursts. Before this
+ * existed that surfaced as a hard `INTERNAL_ERROR` 500 on every route needing a
+ * token list, and as a silently EMPTY chain registry (every chain rendered as
+ * "Chain 8453") that a 10-minute init cache then pinned in place.
+ *
+ * These files change on the order of days, so serving a stale copy is strictly
+ * better than failing — hence the stale-on-error fallback, which is the part
+ * that actually survives an outage.
+ */
+/** How long a persisted copy is kept around purely as the stale fallback. */
+export declare const REMOTE_CACHE_STORE_TTL_S: number;
+/**
+ * Durable backing store — a Cloudflare KV namespace in the workers, absent
+ * everywhere else. Without one the cache is per-process, which still collapses
+ * N requests into one upstream fetch but cannot help a cold start; with one, a
+ * fresh isolate never touches GitHub at all.
+ */
+export interface RemoteCacheStore {
+    get(key: string): Promise<string | null>;
+    put(key: string, value: string, ttlSeconds: number): Promise<void>;
+}
+/** Installs (or with `undefined`, removes) the durable store. */
+export declare function setRemoteCacheStore(next: RemoteCacheStore | undefined): void;
+/**
+ * Optional GitHub token for the API mirror below. Unauthenticated it allows 60
+ * requests/hour per IP, which is thin for a shared Worker egress; a token
+ * raises that to 5,000. Only ever used on the fallback path.
+ */
+export declare function setRemoteCacheGithubToken(token: string | undefined): void;
+/** Drops every cached value. Intended for tests. */
+export declare function clearRemoteCache(): void;
+/**
+ * A non-2xx from the remote. Carries the ORIGIN status so a caller can tell a
+ * settled answer (404/410 — the file is not published) from a transient one
+ * (429/5xx — the same URL may work a second later). Callers that collapse the
+ * two re-fetch known-missing files forever, or treat a rate limit as proof that
+ * a lender has no config.
+ */
+export declare class RemoteFetchError extends Error {
+    /** Status from the ORIGIN host, not from the mirror. */
+    readonly status: number;
+    constructor(message: string, 
+    /** Status from the ORIGIN host, not from the mirror. */
+    status: number);
+    /** 404/410 — re-fetching cannot change the answer. */
+    get isMissing(): boolean;
+}
+/** Fetches JSON from `url`, retrying via the GitHub API when raw rate-limits. */
+export declare function fetchRemoteJson<T>(url: string, label: string): Promise<T>;
+/**
+ * Serves `key` from memory, then the durable store, then `load()` — and on a
+ * failed `load()` falls back to whatever stale copy either layer holds, only
+ * rethrowing when there is nothing to fall back to.
+ *
+ * Concurrent callers for the same key share one in-flight load.
+ *
+ * `isValid` guards the durable layer: a truncated or shape-changed entry is
+ * treated as absent rather than served, since a bad token list silently
+ * mis-decimals every balance built from it.
+ */
+export declare function loadCached<T>(key: string, load: () => Promise<T>, isValid: (value: any) => boolean): Promise<T>;
+/** `loadCached` over a JSON URL, failing on any non-2xx so stale can take over. */
+export declare function loadCachedJson<T>(key: string, url: string, isValid: (value: any) => boolean, label?: string): Promise<T>;

package/dist/tokens.d.ts

@@ -13,10 +13,6 @@ export interface TokenListEntry {
 type TokenList = {
     [addr: string]: TokenListEntry;
 };
-export declare function fetchTokenList(chainId: string): Promise<TokenList>;
-export declare function fetchTokenLists(chainIds: string[]): Promise<{
-    [chainId: string]: TokenList;
-}>;
 export interface TokenListFileData {
     list: TokenList;
     /**
@@ -26,7 +22,18 @@ export interface TokenListFileData {
      */
     mainTokens: string[];
 }
-/** Like {@link fetchTokenList} but keeps the `mainTokens` curation. */
+/**
+ * NOTE: cached — the returned `list` is a SHARED object. Treat it as read-only;
+ * mutating it corrupts the copy every other caller sees.
+ */
+export declare function fetchTokenList(chainId: string): Promise<TokenList>;
+export declare function fetchTokenLists(chainIds: string[]): Promise<{
+    [chainId: string]: TokenList;
+}>;
+/**
+ * Like {@link fetchTokenList} but keeps the `mainTokens` curation. Same
+ * read-only caveat on `list`.
+ */
 export declare function fetchTokenListFile(chainId: string): Promise<TokenListFileData>;
 /**
  * Aggregated chainId → mainTokens map (one small file for all chains, so

package/package.json

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