@gearbox-protocol/sdk 14.9.0 → 14.10.0

package/dist/cjs/{plugins/apy/apy-cache.js → common-utils/axios-cache/AxiosCache.js}

@@ -26,50 +26,57 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var apy_cache_exports = {};
-__export(apy_cache_exports, {
-  ApyOutputCache: () => ApyOutputCache
+var AxiosCache_exports = {};
+__export(AxiosCache_exports, {
+  AxiosCache: () => AxiosCache
 });
-module.exports = __toCommonJS(apy_cache_exports);
+module.exports = __toCommonJS(AxiosCache_exports);
 var import_axios = __toESM(require("axios"));
-class ApyOutputCache {
+class AxiosCache {
   static #instances = /* @__PURE__ */ new Map();
   #url;
   #ttlMs;
   #cache;
   #pending;
   #logger;
-  constructor(url, ttlMs, logger) {
+  #getLogMeta;
+  constructor(url, ttlMs, logger, getLogMeta) {
     this.#url = url;
     this.#ttlMs = ttlMs;
     this.#logger = logger;
+    this.#getLogMeta = getLogMeta;
   }
   /**
    * Returns a shared cache instance for the given URL.
    * The same instance is reused across all callers with identical URL.
    */
-  static get(url, ttlMs, logger) {
-    let instance = ApyOutputCache.#instances.get(url);
+  static get(url, ttlMs, logger, getLogMeta) {
+    let instance = AxiosCache.#instances.get(url);
     if (!instance) {
-      instance = new ApyOutputCache(url, ttlMs, logger);
-      ApyOutputCache.#instances.set(url, instance);
+      instance = new AxiosCache(url, ttlMs, logger, getLogMeta);
+      AxiosCache.#instances.set(url, instance);
     }
     if (logger) {
       instance.#logger = logger;
     }
+    if (getLogMeta) {
+      instance.#getLogMeta = getLogMeta;
+    }
     return instance;
   }
   /**
-   * Returns cached Output if fresh, otherwise fetches from the network.
+   * Returns cached data if fresh, otherwise fetches from the network.
    * Concurrent calls are de-duplicated.
    */
   async fetch() {
     if (this.#cache && Date.now() - this.#cache.fetchedAt < this.#ttlMs) {
-      this.#logger?.debug("apy cache: TTL still valid, returning cached data");
+      this.#logger?.debug(
+        "axios cache: TTL still valid, returning cached data"
+      );
       return this.#cache.data;
     }
     if (this.#pending) {
-      this.#logger?.debug("apy cache: request in flight, waiting");
+      this.#logger?.debug("axios cache: request in flight, waiting");
       return this.#pending;
     }
     this.#pending = this.#doFetch();
@@ -91,30 +98,34 @@ class ApyOutputCache {
       });
       if (response.status === 304 && this.#cache) {
         this.#cache.fetchedAt = Date.now();
-        this.#logger?.debug("apy cache: 304 Not Modified, extended TTL");
+        this.#logger?.debug("axios cache: 304 Not Modified, extended TTL");
         return this.#cache.data;
       }
-      const etag = response.headers["etag"];
+      const etag = response.headers.etag;
       this.#cache = {
         data: response.data,
         etag,
         fetchedAt: Date.now()
       };
+      const meta = this.#getLogMeta?.(response.data);
       this.#logger?.debug(
-        `apy cache: fetched fresh data (timestamp: ${response.data.timestamp})`
+        `axios cache: fetched fresh data${meta ? ` (${meta})` : ""}`
       );
       return response.data;
     } catch (e) {
-      this.#logger?.error(e, "apy cache: fetch failed");
-      return this.#cache?.data;
+      this.#logger?.error(e, "axios cache: fetch failed");
+      if (this.#cache) {
+        return this.#cache.data;
+      }
+      throw e;
     }
   }
   /** Evicts all cached entries. Mainly useful for tests. */
   static clearAll() {
-    ApyOutputCache.#instances.clear();
+    AxiosCache.#instances.clear();
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ApyOutputCache
+  AxiosCache
 });

package/dist/cjs/common-utils/axios-cache/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var axios_cache_exports = {};
+module.exports = __toCommonJS(axios_cache_exports);
+__reExport(axios_cache_exports, require("./AxiosCache.js"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./AxiosCache.js")
+});

package/dist/cjs/common-utils/index.js

@@ -15,11 +15,13 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var common_utils_exports = {};
 module.exports = __toCommonJS(common_utils_exports);
+__reExport(common_utils_exports, require("./axios-cache/index.js"), module.exports);
 __reExport(common_utils_exports, require("./charts/index.js"), module.exports);
 __reExport(common_utils_exports, require("./static/index.js"), module.exports);
 __reExport(common_utils_exports, require("./utils/index.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ...require("./axios-cache/index.js"),
   ...require("./charts/index.js"),
   ...require("./static/index.js"),
   ...require("./utils/index.js")

package/dist/cjs/plugins/apy/ApyPlugin.js

@@ -22,12 +22,12 @@ __export(ApyPlugin_exports, {
 });
 module.exports = __toCommonJS(ApyPlugin_exports);
 var import_marketCompressor = require("../../abi/compressors/marketCompressor.js");
+var import_axios_cache = require("../../common-utils/axios-cache/index.js");
 var import_strategies = require("../../common-utils/utils/strategies/index.js");
 var import_extra_apy = require("../../rewards/rewards/extra-apy.js");
 var import_sdk = require("../../sdk/index.js");
 var import_formatter = require("../../sdk/utils/formatter.js");
 var import_hex = require("../../sdk/utils/hex.js");
-var import_apy_cache = require("./apy-cache.js");
 var import_apy_parser = require("./apy-parser.js");
 var import_constants = require("./constants.js");
 var import_pool_apy_utils = require("./pool-apy-utils.js");
@@ -277,13 +277,13 @@ class ApyPlugin extends import_sdk.BasePlugin {
   // ---------------------------------------------------------------------------
   async #fetchApy() {
     try {
-      const cache = import_apy_cache.ApyOutputCache.get(
+      const cache = import_axios_cache.AxiosCache.get(
         this.#apyUrl,
         this.#cacheTtlMs,
-        this.#logger
+        this.#logger,
+        (data) => `timestamp: ${data.timestamp}`
       );
       const output = await cache.fetch();
-      if (!output) return void 0;
       const chainData = output.chains[this.sdk.chainId];
       if (!chainData) {
         this.#logger?.debug(

package/dist/cjs/plugins/apy/index.js

@@ -16,7 +16,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var apy_exports = {};
 module.exports = __toCommonJS(apy_exports);
 __reExport(apy_exports, require("./ApyPlugin.js"), module.exports);
-__reExport(apy_exports, require("./apy-cache.js"), module.exports);
 __reExport(apy_exports, require("./apy-parser.js"), module.exports);
 __reExport(apy_exports, require("./constants.js"), module.exports);
 __reExport(apy_exports, require("./pool-apy-types.js"), module.exports);
@@ -25,7 +24,6 @@ __reExport(apy_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./ApyPlugin.js"),
-  ...require("./apy-cache.js"),
   ...require("./apy-parser.js"),
   ...require("./constants.js"),
   ...require("./pool-apy-types.js"),

package/dist/cjs/plugins/remote-configs/CustomConfigSource.js

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var CustomConfigSource_exports = {};
+__export(CustomConfigSource_exports, {
+  CustomConfigSource: () => CustomConfigSource
+});
+module.exports = __toCommonJS(CustomConfigSource_exports);
+class CustomConfigSource {
+  #getPools;
+  #getStrategies;
+  constructor(options) {
+    this.#getPools = options.getPools;
+    this.#getStrategies = options.getStrategies;
+  }
+  async getPools() {
+    return this.#getPools();
+  }
+  async getStrategies() {
+    return this.#getStrategies();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CustomConfigSource
+});

package/dist/cjs/plugins/remote-configs/RemoteConfigSource.js

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var RemoteConfigSource_exports = {};
+__export(RemoteConfigSource_exports, {
+  RemoteConfigSource: () => RemoteConfigSource
+});
+module.exports = __toCommonJS(RemoteConfigSource_exports);
+var import_axios_cache = require("../../common-utils/axios-cache/index.js");
+const DEFAULT_POOLS_URL = "https://static.gearbox.finance/client-v3/configs/pools/pools.json";
+const DEFAULT_STRATEGIES_URL = "https://static.gearbox.finance/client-v3/configs/strategies/strategies.json";
+const DEFAULT_CACHE_TTL_MS = 30 * 60 * 1e3;
+class RemoteConfigSource {
+  #poolsCache;
+  #strategiesCache;
+  constructor(options) {
+    const poolsUrl = options?.poolsUrl ?? DEFAULT_POOLS_URL;
+    const strategiesUrl = options?.strategiesUrl ?? DEFAULT_STRATEGIES_URL;
+    const ttlMs = options?.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    this.#poolsCache = import_axios_cache.AxiosCache.get(
+      poolsUrl,
+      ttlMs,
+      options?.logger
+    );
+    this.#strategiesCache = import_axios_cache.AxiosCache.get(
+      strategiesUrl,
+      ttlMs,
+      options?.logger
+    );
+  }
+  async getPools() {
+    return this.#poolsCache.fetch();
+  }
+  async getStrategies() {
+    return this.#strategiesCache.fetch();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RemoteConfigSource
+});

package/dist/cjs/plugins/remote-configs/RemoteConfigsPlugin.js

@@ -0,0 +1,186 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var RemoteConfigsPlugin_exports = {};
+__export(RemoteConfigsPlugin_exports, {
+  RemoteConfigsPlugin: () => RemoteConfigsPlugin
+});
+module.exports = __toCommonJS(RemoteConfigsPlugin_exports);
+var import_viem = require("viem");
+var import_sdk = require("../../sdk/index.js");
+var import_RemoteConfigSource = require("./RemoteConfigSource.js");
+class RemoteConfigsPlugin extends import_sdk.BasePlugin {
+  #sources;
+  #pools;
+  #strategies;
+  constructor(loadOnAttach = false, options) {
+    super(loadOnAttach);
+    this.#sources = options?.sources ?? [new import_RemoteConfigSource.RemoteConfigSource()];
+  }
+  get loaded() {
+    return !!this.#pools && !!this.#strategies;
+  }
+  async load(force) {
+    if (!force && this.loaded) {
+      return this.state;
+    }
+    const [pools, strategies] = await Promise.all([
+      this.#loadPools(),
+      this.#loadStrategies()
+    ]);
+    this.#pools = pools;
+    this.#strategies = strategies;
+    return this.state;
+  }
+  async syncState() {
+    await this.load(false);
+  }
+  get state() {
+    return {
+      pools: this.pools,
+      strategies: this.strategies
+    };
+  }
+  hydrate(state) {
+    this.#pools = state.pools;
+    this.#strategies = state.strategies;
+  }
+  stateHuman(_) {
+    return this.state;
+  }
+  // ---------------------------------------------------------------------------
+  // Accessors
+  // ---------------------------------------------------------------------------
+  /**
+   * Pool configs for the current SDK network.
+   * @throws if plugin is not loaded
+   */
+  get pools() {
+    if (!this.#pools) {
+      throw new Error("remote-configs plugin not loaded");
+    }
+    return this.#pools;
+  }
+  /**
+   * Strategy configs for the current SDK network.
+   * @throws if plugin is not loaded
+   */
+  get strategies() {
+    if (!this.#strategies) {
+      throw new Error("remote-configs plugin not loaded");
+    }
+    return this.#strategies;
+  }
+  // ---------------------------------------------------------------------------
+  // Internal
+  // ---------------------------------------------------------------------------
+  async #loadPools() {
+    for (const source of this.#sources) {
+      try {
+        const data = await source.getPools();
+        const mapped = this.#mapPoolPayload(
+          data.filter(
+            (p) => p.chainId === this.sdk.chainId && p.network.toLowerCase() === this.sdk.networkType.toLowerCase()
+          )
+        );
+        return mapped;
+      } catch (e) {
+        this.logger?.warn(e, `${source.constructor.name} failed to load pools`);
+      }
+    }
+    throw new Error("all config sources failed to load pools");
+  }
+  async #loadStrategies() {
+    for (const source of this.#sources) {
+      try {
+        const data = await source.getStrategies();
+        const mapped = this.#mapStrategyPayload(
+          data.filter(
+            (s) => s.chainId === this.sdk.chainId && s.network.toLowerCase() === this.sdk.networkType.toLowerCase()
+          )
+        );
+        return mapped;
+      } catch (e) {
+        this.logger?.warn(
+          e,
+          `${source.constructor.name} failed to load strategies`
+        );
+      }
+    }
+    throw new Error("all config sources failed to load strategies");
+  }
+  #mapPoolPayload(payload) {
+    return payload.reduce((acc, p) => {
+      const addressLc = p.address.toLowerCase();
+      if ((0, import_viem.isAddress)(addressLc)) {
+        acc.push({
+          ...p,
+          address: addressLc
+        });
+      }
+      return acc;
+    }, []);
+  }
+  #mapStrategyPayload(payload) {
+    return payload.reduce((acc, p) => {
+      const tokenOutAddressLc = p.tokenOutAddress.toLowerCase();
+      const creditManagers = p.creditManagers.filter((cm) => (0, import_viem.isAddress)(cm)).map((cm) => cm.toLowerCase());
+      const zeroSlippage = p.zeroSlippage ? import_sdk.TypedObjectUtils.entries(p.zeroSlippage).reduce((zsAcc, [address, value]) => {
+        const addressLc = address.toLowerCase();
+        if ((0, import_viem.isAddress)(addressLc)) zsAcc[addressLc] = value;
+        return zsAcc;
+      }, {}) : void 0;
+      const additionalRewardQuotas = p.additionalRewardQuotas ? import_sdk.TypedObjectUtils.entries(p.additionalRewardQuotas).reduce((rqAcc, [address, value]) => {
+        const addressLc = address.toLowerCase();
+        if ((0, import_viem.isAddress)(addressLc)) {
+          const rewards = value?.filter((r) => (0, import_viem.isAddress)(r)).map((r) => r.toLowerCase());
+          rqAcc[addressLc] = rewards;
+        }
+        return rqAcc;
+      }, {}) : void 0;
+      const additionalCollaterals = p.additionalCollaterals?.reduce((colAcc, cfg) => {
+        const token = typeof cfg === "string" ? cfg : cfg.token;
+        const tokenLc = token.toLowerCase();
+        const valid = (0, import_viem.isAddress)(tokenLc);
+        if (valid && !colAcc[tokenLc]) colAcc[tokenLc] = [];
+        const nextCfg = typeof cfg === "string" ? tokenLc : {
+          token: tokenLc,
+          cm: cfg.cm.toLowerCase()
+        };
+        if (valid) colAcc[tokenLc].push(nextCfg);
+        return colAcc;
+      }, {});
+      if ((0, import_viem.isAddress)(tokenOutAddressLc)) {
+        const { additionalCollaterals: _, ...rest } = p;
+        acc.push({
+          ...rest,
+          tokenOutAddress: tokenOutAddressLc,
+          creditManagers,
+          ...zeroSlippage ? { zeroSlippage } : {},
+          ...additionalRewardQuotas ? { additionalRewardQuotas } : {},
+          ...additionalCollaterals ? { additionalCollaterals } : {}
+        });
+      }
+      return acc;
+    }, []);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RemoteConfigsPlugin
+});

package/dist/cjs/plugins/remote-configs/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var remote_configs_exports = {};
+module.exports = __toCommonJS(remote_configs_exports);
+__reExport(remote_configs_exports, require("./CustomConfigSource.js"), module.exports);
+__reExport(remote_configs_exports, require("./RemoteConfigSource.js"), module.exports);
+__reExport(remote_configs_exports, require("./RemoteConfigsPlugin.js"), module.exports);
+__reExport(remote_configs_exports, require("./types.js"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./CustomConfigSource.js"),
+  ...require("./RemoteConfigSource.js"),
+  ...require("./RemoteConfigsPlugin.js"),
+  ...require("./types.js")
+});

package/dist/cjs/plugins/remote-configs/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/dist/cjs/plugins/remote-configs/types.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/esm/{plugins/apy/apy-cache.js → common-utils/axios-cache/AxiosCache.js}

@@ -1,42 +1,49 @@
 import axios from "axios";
-class ApyOutputCache {
+class AxiosCache {
   static #instances = /* @__PURE__ */ new Map();
   #url;
   #ttlMs;
   #cache;
   #pending;
   #logger;
-  constructor(url, ttlMs, logger) {
+  #getLogMeta;
+  constructor(url, ttlMs, logger, getLogMeta) {
     this.#url = url;
     this.#ttlMs = ttlMs;
     this.#logger = logger;
+    this.#getLogMeta = getLogMeta;
   }
   /**
    * Returns a shared cache instance for the given URL.
    * The same instance is reused across all callers with identical URL.
    */
-  static get(url, ttlMs, logger) {
-    let instance = ApyOutputCache.#instances.get(url);
+  static get(url, ttlMs, logger, getLogMeta) {
+    let instance = AxiosCache.#instances.get(url);
     if (!instance) {
-      instance = new ApyOutputCache(url, ttlMs, logger);
-      ApyOutputCache.#instances.set(url, instance);
+      instance = new AxiosCache(url, ttlMs, logger, getLogMeta);
+      AxiosCache.#instances.set(url, instance);
     }
     if (logger) {
       instance.#logger = logger;
     }
+    if (getLogMeta) {
+      instance.#getLogMeta = getLogMeta;
+    }
     return instance;
   }
   /**
-   * Returns cached Output if fresh, otherwise fetches from the network.
+   * Returns cached data if fresh, otherwise fetches from the network.
    * Concurrent calls are de-duplicated.
    */
   async fetch() {
     if (this.#cache && Date.now() - this.#cache.fetchedAt < this.#ttlMs) {
-      this.#logger?.debug("apy cache: TTL still valid, returning cached data");
+      this.#logger?.debug(
+        "axios cache: TTL still valid, returning cached data"
+      );
       return this.#cache.data;
     }
     if (this.#pending) {
-      this.#logger?.debug("apy cache: request in flight, waiting");
+      this.#logger?.debug("axios cache: request in flight, waiting");
       return this.#pending;
     }
     this.#pending = this.#doFetch();
@@ -58,29 +65,33 @@ class ApyOutputCache {
       });
       if (response.status === 304 && this.#cache) {
         this.#cache.fetchedAt = Date.now();
-        this.#logger?.debug("apy cache: 304 Not Modified, extended TTL");
+        this.#logger?.debug("axios cache: 304 Not Modified, extended TTL");
         return this.#cache.data;
       }
-      const etag = response.headers["etag"];
+      const etag = response.headers.etag;
       this.#cache = {
         data: response.data,
         etag,
         fetchedAt: Date.now()
       };
+      const meta = this.#getLogMeta?.(response.data);
       this.#logger?.debug(
-        `apy cache: fetched fresh data (timestamp: ${response.data.timestamp})`
+        `axios cache: fetched fresh data${meta ? ` (${meta})` : ""}`
       );
       return response.data;
     } catch (e) {
-      this.#logger?.error(e, "apy cache: fetch failed");
-      return this.#cache?.data;
+      this.#logger?.error(e, "axios cache: fetch failed");
+      if (this.#cache) {
+        return this.#cache.data;
+      }
+      throw e;
     }
   }
   /** Evicts all cached entries. Mainly useful for tests. */
   static clearAll() {
-    ApyOutputCache.#instances.clear();
+    AxiosCache.#instances.clear();
   }
 }
 export {
-  ApyOutputCache
+  AxiosCache
 };

package/dist/esm/common-utils/axios-cache/index.js

@@ -0,0 +1 @@
+export * from "./AxiosCache.js";

package/dist/esm/common-utils/index.js

@@ -1,3 +1,4 @@
+export * from "./axios-cache/index.js";
 export * from "./charts/index.js";
 export * from "./static/index.js";
 export * from "./utils/index.js";

package/dist/esm/plugins/apy/ApyPlugin.js

@@ -1,4 +1,5 @@
 import { marketCompressorAbi } from "../../abi/compressors/marketCompressor.js";
+import { AxiosCache } from "../../common-utils/axios-cache/index.js";
 import {
   getAvailableAndDisabledStrategies,
   getReleasedStrategiesListCore,
@@ -16,7 +17,6 @@ import {
 } from "../../sdk/index.js";
 import { rayToNumber } from "../../sdk/utils/formatter.js";
 import { hexEq } from "../../sdk/utils/hex.js";
-import { ApyOutputCache } from "./apy-cache.js";
 import { parseGearStats, parseNetworkApy } from "./apy-parser.js";
 import { APY_STATE_CACHE_URL, DEFAULT_APY_INTERVAL_MS } from "./constants.js";
 import {
@@ -272,13 +272,13 @@ class ApyPlugin extends BasePlugin {
   // ---------------------------------------------------------------------------
   async #fetchApy() {
     try {
-      const cache = ApyOutputCache.get(
+      const cache = AxiosCache.get(
         this.#apyUrl,
         this.#cacheTtlMs,
-        this.#logger
+        this.#logger,
+        (data) => `timestamp: ${data.timestamp}`
       );
       const output = await cache.fetch();
-      if (!output) return void 0;
       const chainData = output.chains[this.sdk.chainId];
       if (!chainData) {
         this.#logger?.debug(

package/dist/esm/plugins/apy/index.js

@@ -1,5 +1,4 @@
 export * from "./ApyPlugin.js";
-export * from "./apy-cache.js";
 export * from "./apy-parser.js";
 export * from "./constants.js";
 export * from "./pool-apy-types.js";

package/dist/esm/plugins/remote-configs/CustomConfigSource.js

@@ -0,0 +1,17 @@
+class CustomConfigSource {
+  #getPools;
+  #getStrategies;
+  constructor(options) {
+    this.#getPools = options.getPools;
+    this.#getStrategies = options.getStrategies;
+  }
+  async getPools() {
+    return this.#getPools();
+  }
+  async getStrategies() {
+    return this.#getStrategies();
+  }
+}
+export {
+  CustomConfigSource
+};

package/dist/esm/plugins/remote-configs/RemoteConfigSource.js

@@ -0,0 +1,32 @@
+import { AxiosCache } from "../../common-utils/axios-cache/index.js";
+const DEFAULT_POOLS_URL = "https://static.gearbox.finance/client-v3/configs/pools/pools.json";
+const DEFAULT_STRATEGIES_URL = "https://static.gearbox.finance/client-v3/configs/strategies/strategies.json";
+const DEFAULT_CACHE_TTL_MS = 30 * 60 * 1e3;
+class RemoteConfigSource {
+  #poolsCache;
+  #strategiesCache;
+  constructor(options) {
+    const poolsUrl = options?.poolsUrl ?? DEFAULT_POOLS_URL;
+    const strategiesUrl = options?.strategiesUrl ?? DEFAULT_STRATEGIES_URL;
+    const ttlMs = options?.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    this.#poolsCache = AxiosCache.get(
+      poolsUrl,
+      ttlMs,
+      options?.logger
+    );
+    this.#strategiesCache = AxiosCache.get(
+      strategiesUrl,
+      ttlMs,
+      options?.logger
+    );
+  }
+  async getPools() {
+    return this.#poolsCache.fetch();
+  }
+  async getStrategies() {
+    return this.#strategiesCache.fetch();
+  }
+}
+export {
+  RemoteConfigSource
+};

package/dist/esm/plugins/remote-configs/RemoteConfigsPlugin.js

@@ -0,0 +1,165 @@
+import { isAddress } from "viem";
+import {
+  BasePlugin,
+  TypedObjectUtils
+} from "../../sdk/index.js";
+import { RemoteConfigSource } from "./RemoteConfigSource.js";
+class RemoteConfigsPlugin extends BasePlugin {
+  #sources;
+  #pools;
+  #strategies;
+  constructor(loadOnAttach = false, options) {
+    super(loadOnAttach);
+    this.#sources = options?.sources ?? [new RemoteConfigSource()];
+  }
+  get loaded() {
+    return !!this.#pools && !!this.#strategies;
+  }
+  async load(force) {
+    if (!force && this.loaded) {
+      return this.state;
+    }
+    const [pools, strategies] = await Promise.all([
+      this.#loadPools(),
+      this.#loadStrategies()
+    ]);
+    this.#pools = pools;
+    this.#strategies = strategies;
+    return this.state;
+  }
+  async syncState() {
+    await this.load(false);
+  }
+  get state() {
+    return {
+      pools: this.pools,
+      strategies: this.strategies
+    };
+  }
+  hydrate(state) {
+    this.#pools = state.pools;
+    this.#strategies = state.strategies;
+  }
+  stateHuman(_) {
+    return this.state;
+  }
+  // ---------------------------------------------------------------------------
+  // Accessors
+  // ---------------------------------------------------------------------------
+  /**
+   * Pool configs for the current SDK network.
+   * @throws if plugin is not loaded
+   */
+  get pools() {
+    if (!this.#pools) {
+      throw new Error("remote-configs plugin not loaded");
+    }
+    return this.#pools;
+  }
+  /**
+   * Strategy configs for the current SDK network.
+   * @throws if plugin is not loaded
+   */
+  get strategies() {
+    if (!this.#strategies) {
+      throw new Error("remote-configs plugin not loaded");
+    }
+    return this.#strategies;
+  }
+  // ---------------------------------------------------------------------------
+  // Internal
+  // ---------------------------------------------------------------------------
+  async #loadPools() {
+    for (const source of this.#sources) {
+      try {
+        const data = await source.getPools();
+        const mapped = this.#mapPoolPayload(
+          data.filter(
+            (p) => p.chainId === this.sdk.chainId && p.network.toLowerCase() === this.sdk.networkType.toLowerCase()
+          )
+        );
+        return mapped;
+      } catch (e) {
+        this.logger?.warn(e, `${source.constructor.name} failed to load pools`);
+      }
+    }
+    throw new Error("all config sources failed to load pools");
+  }
+  async #loadStrategies() {
+    for (const source of this.#sources) {
+      try {
+        const data = await source.getStrategies();
+        const mapped = this.#mapStrategyPayload(
+          data.filter(
+            (s) => s.chainId === this.sdk.chainId && s.network.toLowerCase() === this.sdk.networkType.toLowerCase()
+          )
+        );
+        return mapped;
+      } catch (e) {
+        this.logger?.warn(
+          e,
+          `${source.constructor.name} failed to load strategies`
+        );
+      }
+    }
+    throw new Error("all config sources failed to load strategies");
+  }
+  #mapPoolPayload(payload) {
+    return payload.reduce((acc, p) => {
+      const addressLc = p.address.toLowerCase();
+      if (isAddress(addressLc)) {
+        acc.push({
+          ...p,
+          address: addressLc
+        });
+      }
+      return acc;
+    }, []);
+  }
+  #mapStrategyPayload(payload) {
+    return payload.reduce((acc, p) => {
+      const tokenOutAddressLc = p.tokenOutAddress.toLowerCase();
+      const creditManagers = p.creditManagers.filter((cm) => isAddress(cm)).map((cm) => cm.toLowerCase());
+      const zeroSlippage = p.zeroSlippage ? TypedObjectUtils.entries(p.zeroSlippage).reduce((zsAcc, [address, value]) => {
+        const addressLc = address.toLowerCase();
+        if (isAddress(addressLc)) zsAcc[addressLc] = value;
+        return zsAcc;
+      }, {}) : void 0;
+      const additionalRewardQuotas = p.additionalRewardQuotas ? TypedObjectUtils.entries(p.additionalRewardQuotas).reduce((rqAcc, [address, value]) => {
+        const addressLc = address.toLowerCase();
+        if (isAddress(addressLc)) {
+          const rewards = value?.filter((r) => isAddress(r)).map((r) => r.toLowerCase());
+          rqAcc[addressLc] = rewards;
+        }
+        return rqAcc;
+      }, {}) : void 0;
+      const additionalCollaterals = p.additionalCollaterals?.reduce((colAcc, cfg) => {
+        const token = typeof cfg === "string" ? cfg : cfg.token;
+        const tokenLc = token.toLowerCase();
+        const valid = isAddress(tokenLc);
+        if (valid && !colAcc[tokenLc]) colAcc[tokenLc] = [];
+        const nextCfg = typeof cfg === "string" ? tokenLc : {
+          token: tokenLc,
+          cm: cfg.cm.toLowerCase()
+        };
+        if (valid) colAcc[tokenLc].push(nextCfg);
+        return colAcc;
+      }, {});
+      if (isAddress(tokenOutAddressLc)) {
+        const { additionalCollaterals: _, ...rest } = p;
+        acc.push({
+          ...rest,
+          tokenOutAddress: tokenOutAddressLc,
+          creditManagers,
+          ...zeroSlippage ? { zeroSlippage } : {},
+          ...additionalRewardQuotas ? { additionalRewardQuotas } : {},
+          ...additionalCollaterals ? { additionalCollaterals } : {}
+        });
+      }
+      return acc;
+    }, []);
+  }
+}
+export {
+  RemoteConfigsPlugin
+};

package/dist/esm/plugins/remote-configs/index.js

@@ -0,0 +1,4 @@
+export * from "./CustomConfigSource.js";
+export * from "./RemoteConfigSource.js";
+export * from "./RemoteConfigsPlugin.js";
+export * from "./types.js";

package/dist/esm/plugins/remote-configs/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

package/dist/types/{plugins/apy/apy-cache.d.ts → common-utils/axios-cache/AxiosCache.d.ts}

@@ -1,28 +1,27 @@
-import type { Output } from "../../rewards/apy/index.js";
 import type { ILogger } from "../../sdk/index.js";
 /**
- * Process-wide cache for the APY state-cache JSON.
+ * Process-wide cache for axios JSON responses.
  *
- * Multiple ApyPlugin instances (one per SDK / network) share the same
+ * Multiple plugin instances (one per SDK / network) share the same
  * cached HTTP response so that only **one** request is made per TTL window
  * regardless of how many SDK instances exist.
  *
  * Concurrent callers that arrive while a fetch is already in flight
  * are de-duplicated — they all await the same promise.
  */
-export declare class ApyOutputCache {
+export declare class AxiosCache<T> {
     #private;
     private constructor();
     /**
      * Returns a shared cache instance for the given URL.
      * The same instance is reused across all callers with identical URL.
      */
-    static get(url: string, ttlMs: number, logger?: ILogger): ApyOutputCache;
+    static get<T>(url: string, ttlMs: number, logger?: ILogger, getLogMeta?: (data: T) => string): AxiosCache<T>;
     /**
-     * Returns cached Output if fresh, otherwise fetches from the network.
+     * Returns cached data if fresh, otherwise fetches from the network.
      * Concurrent calls are de-duplicated.
      */
-    fetch(): Promise<Output<string, string> | undefined>;
+    fetch(): Promise<T>;
     /** Evicts all cached entries. Mainly useful for tests. */
     static clearAll(): void;
 }

package/dist/types/common-utils/axios-cache/index.d.ts

@@ -0,0 +1 @@
+export * from "./AxiosCache.js";

package/dist/types/common-utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./axios-cache/index.js";
 export * from "./charts/index.js";
 export * from "./static/index.js";
 export * from "./utils/index.js";

package/dist/types/plugins/apy/index.d.ts

@@ -1,5 +1,4 @@
 export * from "./ApyPlugin.js";
-export * from "./apy-cache.js";
 export * from "./apy-parser.js";
 export * from "./constants.js";
 export * from "./pool-apy-types.js";

package/dist/types/plugins/remote-configs/CustomConfigSource.d.ts

@@ -0,0 +1,13 @@
+import type { PoolConfigPayload } from "../../common-utils/static/pool-config.js";
+import type { StrategyConfigPayload } from "../../common-utils/static/strategy.js";
+import type { ConfigSource } from "./types.js";
+export interface CustomConfigSourceOptions {
+    getPools: () => Promise<PoolConfigPayload[]>;
+    getStrategies: () => Promise<StrategyConfigPayload[]>;
+}
+export declare class CustomConfigSource implements ConfigSource {
+    #private;
+    constructor(options: CustomConfigSourceOptions);
+    getPools(): Promise<PoolConfigPayload[]>;
+    getStrategies(): Promise<StrategyConfigPayload[]>;
+}

package/dist/types/plugins/remote-configs/RemoteConfigSource.d.ts

@@ -0,0 +1,31 @@
+import type { PoolConfigPayload } from "../../common-utils/static/pool-config.js";
+import type { StrategyConfigPayload } from "../../common-utils/static/strategy.js";
+import type { ILogger } from "../../sdk/index.js";
+import type { ConfigSource } from "./types.js";
+export interface RemoteConfigSourceOptions {
+    /**
+     * URL for pools config JSON.
+     * @default "https://static.gearbox.finance/client-v3/configs/pools/pools.json"
+     */
+    poolsUrl?: string;
+    /**
+     * URL for strategies config JSON.
+     * @default "https://static.gearbox.finance/client-v3/configs/strategies/strategies.json"
+     */
+    strategiesUrl?: string;
+    /**
+     * Cache TTL in milliseconds.
+     * @default 60_000
+     */
+    cacheTtlMs?: number;
+    /**
+     * Optional logger for cache diagnostics.
+     */
+    logger?: ILogger;
+}
+export declare class RemoteConfigSource implements ConfigSource {
+    #private;
+    constructor(options?: RemoteConfigSourceOptions);
+    getPools(): Promise<Array<PoolConfigPayload>>;
+    getStrategies(): Promise<Array<StrategyConfigPayload>>;
+}

package/dist/types/plugins/remote-configs/RemoteConfigsPlugin.d.ts

@@ -0,0 +1,24 @@
+import type { PoolConfigPayload } from "../../common-utils/static/pool-config.js";
+import type { NotValidatedStrategy } from "../../common-utils/utils/strategies/types/strategy.js";
+import { BasePlugin, type IOnchainSDKPlugin } from "../../sdk/index.js";
+import type { RemoteConfigsPluginOptions, RemoteConfigsPluginState } from "./types.js";
+export declare class RemoteConfigsPlugin extends BasePlugin<RemoteConfigsPluginState> implements IOnchainSDKPlugin<RemoteConfigsPluginState> {
+    #private;
+    constructor(loadOnAttach?: boolean, options?: RemoteConfigsPluginOptions);
+    get loaded(): boolean;
+    load(force?: boolean): Promise<RemoteConfigsPluginState>;
+    syncState(): Promise<void>;
+    get state(): RemoteConfigsPluginState;
+    hydrate(state: RemoteConfigsPluginState): void;
+    stateHuman(_?: boolean): RemoteConfigsPluginState;
+    /**
+     * Pool configs for the current SDK network.
+     * @throws if plugin is not loaded
+     */
+    get pools(): PoolConfigPayload[];
+    /**
+     * Strategy configs for the current SDK network.
+     * @throws if plugin is not loaded
+     */
+    get strategies(): NotValidatedStrategy[];
+}

package/dist/types/plugins/remote-configs/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./CustomConfigSource.js";
+export * from "./RemoteConfigSource.js";
+export * from "./RemoteConfigsPlugin.js";
+export * from "./types.js";

package/dist/types/plugins/remote-configs/types.d.ts

@@ -0,0 +1,24 @@
+import type { PoolConfigPayload } from "../../common-utils/static/pool-config.js";
+import type { StrategyConfigPayload } from "../../common-utils/static/strategy.js";
+import type { NotValidatedStrategy } from "../../common-utils/utils/strategies/types/strategy.js";
+export interface RemoteConfigsPluginState {
+    pools: PoolConfigPayload[];
+    strategies: NotValidatedStrategy[];
+}
+/**
+ * Abstraction for a config provider.
+ * Multiple sources can be composed; the plugin tries them in order
+ * until one succeeds.
+ */
+export interface ConfigSource {
+    getPools(): Promise<PoolConfigPayload[]>;
+    getStrategies(): Promise<StrategyConfigPayload[]>;
+}
+export interface RemoteConfigsPluginOptions {
+    /**
+     * Ordered list of config sources.
+     * Defaults to `[new RemoteConfigSource()]` if omitted.
+     */
+    sources?: ConfigSource[];
+}
+export type { NotValidatedStrategy, PoolConfigPayload, StrategyConfigPayload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "14.9.0",
+  "version": "14.10.0",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {