@gearbox-protocol/sdk 4.1.9 → 4.2.0-next.1

package/dist/cjs/sdk/GearboxSDK.js

@@ -18,7 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var GearboxSDK_exports = {};
 __export(GearboxSDK_exports, {
-  GearboxSDK: () => GearboxSDK
+  GearboxSDK: () => GearboxSDK,
+  STATE_VERSION: () => STATE_VERSION
 });
 module.exports = __toCommonJS(GearboxSDK_exports);
 var import_viem = require("viem");
@@ -34,6 +35,7 @@ var import_utils = require("./utils/index.js");
 var import_internal = require("./utils/internal/index.js");
 var import_viem2 = require("./utils/viem/index.js");
 const ERR_NOT_ATTACHED = new Error("Gearbox SDK not attached");
+const STATE_VERSION = 1;
 class GearboxSDK {
   #hooks = new import_internal.Hooks();
   // Represents chain object
@@ -45,13 +47,9 @@ class GearboxSDK {
   #syncing = false;
   // Collection of core singleton contracts
   #addressProvider;
-  #botListContract;
-  #gearStakingContract;
   #attachConfig;
   // Collection of markets
   #marketRegister;
-  // Routers by address
-  #routers = new import_utils.AddressMap();
   logger;
   /**
    * Interest rate models can be reused across chain (and SDK operates on chain level)
@@ -119,6 +117,15 @@ class GearboxSDK {
       marketConfigurators
     });
   }
+  static hydrate(options, state) {
+    const { logger, ...rest } = options;
+    const provider = new import_chain.Provider({
+      ...rest,
+      chainId: state.chainId,
+      networkType: state.network
+    });
+    return new GearboxSDK({ provider, logger }).#hydrate(rest, state);
+  }
   constructor(options) {
     this.#provider = options.provider;
     this.logger = options.logger;
@@ -139,7 +146,6 @@ class GearboxSDK {
       addressProvider,
       blockNumber,
       redstoneHistoricTimestamp,
-      redstoneGateways,
       ignoreUpdateablePrices,
       marketConfigurators
     } = opts;
@@ -167,12 +173,7 @@ class GearboxSDK {
     );
     this.#currentBlock = block.number;
     this.#timestamp = block.timestamp;
-    if (redstoneHistoricTimestamp) {
-      this.priceFeeds.redstoneUpdater.historicalTimestamp = redstoneHistoricTimestamp === true ? Number(block.timestamp) * 1e3 : redstoneHistoricTimestamp;
-    }
-    if (redstoneGateways?.length) {
-      this.priceFeeds.redstoneUpdater.gateways = redstoneGateways;
-    }
+    this.#confugureRedstone(opts);
     this.logger?.debug(
       `${re}attach block number ${this.currentBlock} timestamp ${this.timestamp}`
     );
@@ -181,23 +182,6 @@ class GearboxSDK {
       `address provider version: ${this.#addressProvider.version}`
     );
     await this.#addressProvider.syncState(this.currentBlock);
-    try {
-      const botListAddress = this.#addressProvider.getAddress(
-        import_constants.AP_BOT_LIST,
-        import_constants.NO_VERSION
-      );
-      this.#botListContract = new import_core.BotListContract(this, botListAddress);
-    } catch (e) {
-      this.logger?.error(e);
-    }
-    const gearStakingAddress = this.#addressProvider.getAddress(
-      import_constants.AP_GEAR_STAKING,
-      import_constants.NO_VERSION
-    );
-    this.#gearStakingContract = new import_core.GearStakingContract(
-      this,
-      gearStakingAddress
-    );
     this.#marketRegister = new import_MarketRegister.MarketRegister(this);
     await this.#marketRegister.loadMarkets(
       marketConfigurators,
@@ -224,13 +208,48 @@ class GearboxSDK {
     this.logger?.info(`${re}attach time: ${Date.now() - time} ms`);
     return this;
   }
+  #hydrate(options, state) {
+    const { logger: _logger, ...opts } = options;
+    if (state.version !== STATE_VERSION) {
+      throw new Error(
+        `hydrated state version is ${state.version}, but expected ${STATE_VERSION}`
+      );
+    }
+    this.#currentBlock = state.currentBlock;
+    this.#timestamp = state.timestamp;
+    this.#confugureRedstone(opts);
+    this.#addressProvider = (0, import_core.hydrateAddressProvider)(this, state.addressProvider);
+    this.logger?.debug(
+      `address provider version: ${this.#addressProvider.version}`
+    );
+    this.#marketRegister = new import_MarketRegister.MarketRegister(this);
+    this.#marketRegister.hydrate(state.markets);
+    this.#attachConfig = {
+      ...opts,
+      addressProvider: this.addressProvider.address,
+      marketConfigurators: this.marketRegister.marketConfigurators.map(
+        (m) => m.address
+      ),
+      blockNumber: this.currentBlock
+    };
+    return this;
+  }
+  #confugureRedstone(opts) {
+    const { redstoneGateways, redstoneHistoricTimestamp } = opts;
+    if (redstoneHistoricTimestamp) {
+      this.priceFeeds.redstoneUpdater.historicalTimestamp = redstoneHistoricTimestamp === true ? Number(this.timestamp) * 1e3 : redstoneHistoricTimestamp;
+    }
+    if (redstoneGateways?.length) {
+      this.priceFeeds.redstoneUpdater.gateways = redstoneGateways;
+    }
+  }
   /**
    * Reattach SDK with the same config as before, without re-creating instance. Will load all state from scratch
    * Be mindful of block number, for example
    */
   async reattach() {
     if (!this.#attachConfig) {
-      throw new Error("SDK not attached");
+      throw new Error("cannot reattach, attach config is not set");
     }
     await this.#attach(this.#attachConfig);
   }
@@ -288,8 +307,8 @@ class GearboxSDK {
       timestamp: Number(this.timestamp),
       core: {
         addressProviderV3: this.addressProvider.stateHuman(raw),
-        botList: this.botListContract.stateHuman(raw),
-        gearStakingV3: this.gearStakingContract.stateHuman(raw)
+        botList: this.botListContract?.stateHuman(raw),
+        gearStakingV3: this.gearStakingContract?.stateHuman(raw)
       },
       tokens: this.tokensMeta.values(),
       plugins: Object.fromEntries(
@@ -303,7 +322,11 @@ class GearboxSDK {
   }
   get state() {
     return {
+      version: STATE_VERSION,
+      network: this.provider.networkType,
+      chainId: this.provider.chainId,
       currentBlock: this.currentBlock,
+      timestamp: this.timestamp,
       addressProvider: this.addressProvider.state,
       markets: this.marketRegister.state
     };
@@ -419,16 +442,18 @@ class GearboxSDK {
     return this.#addressProvider;
   }
   get botListContract() {
-    if (this.#botListContract === void 0) {
-      throw ERR_NOT_ATTACHED;
+    const addr = this.addressProvider.getAddress(import_constants.AP_BOT_LIST, import_constants.NO_VERSION);
+    if (!this.contracts.has(addr)) {
+      return new import_core.BotListContract(this, addr);
     }
-    return this.#botListContract;
+    return this.contracts.get(addr);
   }
   get gearStakingContract() {
-    if (this.#gearStakingContract === void 0) {
-      throw ERR_NOT_ATTACHED;
+    const addr = this.addressProvider.getAddress(import_constants.AP_GEAR_STAKING, import_constants.NO_VERSION);
+    if (!this.contracts.has(addr)) {
+      return new import_core.GearStakingContract(this, addr);
     }
-    return this.#gearStakingContract;
+    return this.contracts.get(addr);
   }
   get marketRegister() {
     if (this.#marketRegister === void 0) {
@@ -463,13 +488,14 @@ class GearboxSDK {
       );
     }
     const [routerAddr, routerV] = routerEntry;
-    if (!this.#routers.has(routerAddr)) {
-      this.#routers.upsert(routerAddr, (0, import_router.createRouter)(this, routerAddr, routerV));
+    if (!this.contracts.has(routerAddr)) {
+      return (0, import_router.createRouter)(this, routerAddr, routerV);
     }
-    return this.#routers.mustGet(routerAddr);
+    return this.contracts.get(routerAddr);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  GearboxSDK
+  GearboxSDK,
+  STATE_VERSION
 });

package/dist/cjs/sdk/core/address-provider/{AddressProviderV3Contract.js → AddressProviderV300Contract.js}

@@ -26,26 +26,26 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var AddressProviderV3Contract_exports = {};
-__export(AddressProviderV3Contract_exports, {
-  AddressProviderContractV3: () => AddressProviderContractV3
+var AddressProviderV300Contract_exports = {};
+__export(AddressProviderV300Contract_exports, {
+  AddressProviderV300Contract: () => AddressProviderV300Contract
 });
-module.exports = __toCommonJS(AddressProviderV3Contract_exports);
+module.exports = __toCommonJS(AddressProviderV300Contract_exports);
 var import_viem = require("viem");
 var import_v300 = require("../../../abi/v300.js");
 var import_constants = require("../../constants/index.js");
 var import_viem2 = require("../../utils/viem/index.js");
 var import_AbstractAddressProviderContract = __toESM(require("./AbstractAddressProviderContract.js"));
 const abi = import_v300.iAddressProviderV300Abi;
-class AddressProviderContractV3 extends import_AbstractAddressProviderContract.default {
-  constructor(sdk, address, addresses = {}) {
+class AddressProviderV300Contract extends import_AbstractAddressProviderContract.default {
+  constructor(sdk, address, version, addresses = {}) {
     super(
       sdk,
       {
         addr: address,
-        name: "AddressProviderV3",
+        name: "AddressProviderV300",
         abi,
-        version: 300
+        version
       },
       addresses
     );
@@ -108,5 +108,5 @@ class AddressProviderContractV3 extends import_AbstractAddressProviderContract.d
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AddressProviderContractV3
+  AddressProviderV300Contract
 });

package/dist/cjs/sdk/core/address-provider/{AddressProviderV3_1Contract.js → AddressProviderV310Contract.js}

@@ -26,24 +26,24 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var AddressProviderV3_1Contract_exports = {};
-__export(AddressProviderV3_1Contract_exports, {
-  AddressProviderContractV3_1: () => AddressProviderContractV3_1
+var AddressProviderV310Contract_exports = {};
+__export(AddressProviderV310Contract_exports, {
+  AddressProviderV310Contract: () => AddressProviderV310Contract
 });
-module.exports = __toCommonJS(AddressProviderV3_1Contract_exports);
+module.exports = __toCommonJS(AddressProviderV310Contract_exports);
 var import_viem = require("viem");
 var import_v310 = require("../../../abi/v310.js");
 var import_AbstractAddressProviderContract = __toESM(require("./AbstractAddressProviderContract.js"));
 const abi = import_v310.iAddressProviderV310Abi;
-class AddressProviderContractV3_1 extends import_AbstractAddressProviderContract.default {
-  constructor(sdk, address, addresses = {}) {
+class AddressProviderV310Contract extends import_AbstractAddressProviderContract.default {
+  constructor(sdk, address, version, addresses = {}) {
     super(
       sdk,
       {
         addr: address,
-        name: "AddressProviderV3_1",
+        name: "AddressProviderV310",
         abi,
-        version: 310
+        version
       },
       addresses
     );
@@ -93,5 +93,5 @@ class AddressProviderContractV3_1 extends import_AbstractAddressProviderContract
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AddressProviderContractV3_1
+  AddressProviderV310Contract
 });

package/dist/cjs/sdk/core/address-provider/createAddressProvider.js

@@ -18,41 +18,37 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var createAddressProvider_exports = {};
 __export(createAddressProvider_exports, {
-  createAddressProvider: () => createAddressProvider
+  createAddressProvider: () => createAddressProvider,
+  hydrateAddressProvider: () => hydrateAddressProvider
 });
 module.exports = __toCommonJS(createAddressProvider_exports);
 var import_iVersion = require("../../../abi/iVersion.js");
-var import_AddressProviderV3_1Contract = require("./AddressProviderV3_1Contract.js");
-var import_AddressProviderV3Contract = require("./AddressProviderV3Contract.js");
-async function createAddressProvider(sdk, address, options) {
-  const addr = options?.state?.baseParams.addr ?? address;
-  let v = options?.state?.baseParams.version ?? options?.version;
-  if (!v) {
-    const vv = await sdk.provider.publicClient.readContract({
-      address: addr,
-      abi: import_iVersion.iVersionAbi,
-      functionName: "version"
-    });
-    v = Number(vv);
+var import_utils = require("../../utils/index.js");
+var import_AddressProviderV300Contract = require("./AddressProviderV300Contract.js");
+var import_AddressProviderV310Contract = require("./AddressProviderV310Contract.js");
+async function createAddressProvider(sdk, address) {
+  const v = await sdk.provider.publicClient.readContract({
+    address,
+    abi: import_iVersion.iVersionAbi,
+    functionName: "version"
+  });
+  return newAddressProvider(sdk, address, Number(v));
+}
+function hydrateAddressProvider(sdk, state) {
+  const { addr, version } = state.baseParams;
+  return newAddressProvider(sdk, addr, Number(version), state.addresses);
+}
+function newAddressProvider(sdk, address, version, addresses) {
+  if ((0, import_utils.isV300)(version)) {
+    return new import_AddressProviderV300Contract.AddressProviderV300Contract(sdk, address, version, addresses);
   }
-  switch (v) {
-    case 300:
-      return new import_AddressProviderV3Contract.AddressProviderContractV3(
-        sdk,
-        addr,
-        options?.state?.addresses
-      );
-    case 310:
-      return new import_AddressProviderV3_1Contract.AddressProviderContractV3_1(
-        sdk,
-        addr,
-        options?.state?.addresses
-      );
-    default:
-      throw new Error(`Unsupported address provider version: ${v}`);
+  if ((0, import_utils.isV310)(version)) {
+    return new import_AddressProviderV310Contract.AddressProviderV310Contract(sdk, address, version, addresses);
   }
+  throw new Error(`unsupported address provider version: ${version}`);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createAddressProvider
+  createAddressProvider,
+  hydrateAddressProvider
 });

package/dist/cjs/sdk/core/address-provider/index.js

@@ -15,14 +15,14 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var address_provider_exports = {};
 module.exports = __toCommonJS(address_provider_exports);
-__reExport(address_provider_exports, require("./AddressProviderV3_1Contract.js"), module.exports);
-__reExport(address_provider_exports, require("./AddressProviderV3Contract.js"), module.exports);
+__reExport(address_provider_exports, require("./AddressProviderV300Contract.js"), module.exports);
+__reExport(address_provider_exports, require("./AddressProviderV310Contract.js"), module.exports);
 __reExport(address_provider_exports, require("./createAddressProvider.js"), module.exports);
 __reExport(address_provider_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ...require("./AddressProviderV3_1Contract.js"),
-  ...require("./AddressProviderV3Contract.js"),
+  ...require("./AddressProviderV300Contract.js"),
+  ...require("./AddressProviderV310Contract.js"),
   ...require("./createAddressProvider.js"),
   ...require("./types.js")
 });

package/dist/cjs/sdk/gauges/GaugeStakingService.js

@@ -37,7 +37,13 @@ class GaugeStakingService extends import_base.SDKConstruct {
    */
   async getGaugeStakingData(wallet) {
     const marketFilter = this.sdk.marketRegister.marketFilter;
-    if (!marketFilter) throw new Error("market filter is not set");
+    const gearStaking = this.sdk.gearStakingContract;
+    if (!marketFilter) {
+      throw new Error("market filter is not set");
+    }
+    if (!gearStaking) {
+      throw new Error("gear staking contract is not set");
+    }
     const [gauges, availableBalance, totalBalance, withdrawableAmounts, epoch] = await this.provider.publicClient.multicall({
       allowFailure: false,
       contracts: [
@@ -48,26 +54,26 @@ class GaugeStakingService extends import_base.SDKConstruct {
           args: [marketFilter, wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "availableBalance",
           args: [wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "balanceOf",
           args: [wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "getWithdrawableAmounts",
           args: [wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "getCurrentEpoch",
           args: []
         }

package/dist/cjs/sdk/market/MarketRegister.js

@@ -34,10 +34,13 @@ class MarketRegister extends import_base.SDKConstruct {
    */
   #markets = new import_utils.AddressMap(void 0, "markets");
   #marketFilter;
-  constructor(sdk, markets) {
+  constructor(sdk) {
     super(sdk);
     this.#logger = (0, import_utils.childLogger)("MarketRegister", sdk.logger);
-    for (const data of markets ?? []) {
+  }
+  hydrate(state) {
+    this.#markets.clear();
+    for (const data of state) {
       this.#markets.upsert(
         data.pool.baseParams.addr,
         new import_MarketSuite.MarketSuite(this.sdk, data)

package/dist/cjs/sdk/utils/index.js

@@ -27,6 +27,7 @@ __reExport(utils_exports, require("./json.js"), module.exports);
 __reExport(utils_exports, require("./mappers.js"), module.exports);
 __reExport(utils_exports, require("./retry.js"), module.exports);
 __reExport(utils_exports, require("./toAddress.js"), module.exports);
+__reExport(utils_exports, require("./version.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./AddressMap.js"),
@@ -40,5 +41,6 @@ __reExport(utils_exports, require("./toAddress.js"), module.exports);
   ...require("./json.js"),
   ...require("./mappers.js"),
   ...require("./retry.js"),
-  ...require("./toAddress.js")
+  ...require("./toAddress.js"),
+  ...require("./version.js")
 });

package/dist/cjs/sdk/utils/version.js

@@ -0,0 +1,35 @@
+"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 version_exports = {};
+__export(version_exports, {
+  isV300: () => isV300,
+  isV310: () => isV310
+});
+module.exports = __toCommonJS(version_exports);
+function isV300(version) {
+  return version >= 300 && version < 310;
+}
+function isV310(version) {
+  return version >= 310 && version < 320;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isV300,
+  isV310
+});

package/dist/esm/sdk/GearboxSDK.js

@@ -17,7 +17,8 @@ import {
 import {
   BotListContract,
   createAddressProvider,
-  GearStakingContract
+  GearStakingContract,
+  hydrateAddressProvider
 } from "./core/index.js";
 import { MarketRegister } from "./market/MarketRegister.js";
 import { PriceFeedRegister } from "./market/pricefeeds/index.js";
@@ -34,6 +35,7 @@ import {
 import { Hooks } from "./utils/internal/index.js";
 import { getLogsSafe } from "./utils/viem/index.js";
 const ERR_NOT_ATTACHED = new Error("Gearbox SDK not attached");
+const STATE_VERSION = 1;
 class GearboxSDK {
   #hooks = new Hooks();
   // Represents chain object
@@ -45,13 +47,9 @@ class GearboxSDK {
   #syncing = false;
   // Collection of core singleton contracts
   #addressProvider;
-  #botListContract;
-  #gearStakingContract;
   #attachConfig;
   // Collection of markets
   #marketRegister;
-  // Routers by address
-  #routers = new AddressMap();
   logger;
   /**
    * Interest rate models can be reused across chain (and SDK operates on chain level)
@@ -119,6 +117,15 @@ class GearboxSDK {
       marketConfigurators
     });
   }
+  static hydrate(options, state) {
+    const { logger, ...rest } = options;
+    const provider = new Provider({
+      ...rest,
+      chainId: state.chainId,
+      networkType: state.network
+    });
+    return new GearboxSDK({ provider, logger }).#hydrate(rest, state);
+  }
   constructor(options) {
     this.#provider = options.provider;
     this.logger = options.logger;
@@ -139,7 +146,6 @@ class GearboxSDK {
       addressProvider,
       blockNumber,
       redstoneHistoricTimestamp,
-      redstoneGateways,
       ignoreUpdateablePrices,
       marketConfigurators
     } = opts;
@@ -167,12 +173,7 @@ class GearboxSDK {
     );
     this.#currentBlock = block.number;
     this.#timestamp = block.timestamp;
-    if (redstoneHistoricTimestamp) {
-      this.priceFeeds.redstoneUpdater.historicalTimestamp = redstoneHistoricTimestamp === true ? Number(block.timestamp) * 1e3 : redstoneHistoricTimestamp;
-    }
-    if (redstoneGateways?.length) {
-      this.priceFeeds.redstoneUpdater.gateways = redstoneGateways;
-    }
+    this.#confugureRedstone(opts);
     this.logger?.debug(
       `${re}attach block number ${this.currentBlock} timestamp ${this.timestamp}`
     );
@@ -181,23 +182,6 @@ class GearboxSDK {
       `address provider version: ${this.#addressProvider.version}`
     );
     await this.#addressProvider.syncState(this.currentBlock);
-    try {
-      const botListAddress = this.#addressProvider.getAddress(
-        AP_BOT_LIST,
-        NO_VERSION
-      );
-      this.#botListContract = new BotListContract(this, botListAddress);
-    } catch (e) {
-      this.logger?.error(e);
-    }
-    const gearStakingAddress = this.#addressProvider.getAddress(
-      AP_GEAR_STAKING,
-      NO_VERSION
-    );
-    this.#gearStakingContract = new GearStakingContract(
-      this,
-      gearStakingAddress
-    );
     this.#marketRegister = new MarketRegister(this);
     await this.#marketRegister.loadMarkets(
       marketConfigurators,
@@ -224,13 +208,48 @@ class GearboxSDK {
     this.logger?.info(`${re}attach time: ${Date.now() - time} ms`);
     return this;
   }
+  #hydrate(options, state) {
+    const { logger: _logger, ...opts } = options;
+    if (state.version !== STATE_VERSION) {
+      throw new Error(
+        `hydrated state version is ${state.version}, but expected ${STATE_VERSION}`
+      );
+    }
+    this.#currentBlock = state.currentBlock;
+    this.#timestamp = state.timestamp;
+    this.#confugureRedstone(opts);
+    this.#addressProvider = hydrateAddressProvider(this, state.addressProvider);
+    this.logger?.debug(
+      `address provider version: ${this.#addressProvider.version}`
+    );
+    this.#marketRegister = new MarketRegister(this);
+    this.#marketRegister.hydrate(state.markets);
+    this.#attachConfig = {
+      ...opts,
+      addressProvider: this.addressProvider.address,
+      marketConfigurators: this.marketRegister.marketConfigurators.map(
+        (m) => m.address
+      ),
+      blockNumber: this.currentBlock
+    };
+    return this;
+  }
+  #confugureRedstone(opts) {
+    const { redstoneGateways, redstoneHistoricTimestamp } = opts;
+    if (redstoneHistoricTimestamp) {
+      this.priceFeeds.redstoneUpdater.historicalTimestamp = redstoneHistoricTimestamp === true ? Number(this.timestamp) * 1e3 : redstoneHistoricTimestamp;
+    }
+    if (redstoneGateways?.length) {
+      this.priceFeeds.redstoneUpdater.gateways = redstoneGateways;
+    }
+  }
   /**
    * Reattach SDK with the same config as before, without re-creating instance. Will load all state from scratch
    * Be mindful of block number, for example
    */
   async reattach() {
     if (!this.#attachConfig) {
-      throw new Error("SDK not attached");
+      throw new Error("cannot reattach, attach config is not set");
     }
     await this.#attach(this.#attachConfig);
   }
@@ -288,8 +307,8 @@ class GearboxSDK {
       timestamp: Number(this.timestamp),
       core: {
         addressProviderV3: this.addressProvider.stateHuman(raw),
-        botList: this.botListContract.stateHuman(raw),
-        gearStakingV3: this.gearStakingContract.stateHuman(raw)
+        botList: this.botListContract?.stateHuman(raw),
+        gearStakingV3: this.gearStakingContract?.stateHuman(raw)
       },
       tokens: this.tokensMeta.values(),
       plugins: Object.fromEntries(
@@ -303,7 +322,11 @@ class GearboxSDK {
   }
   get state() {
     return {
+      version: STATE_VERSION,
+      network: this.provider.networkType,
+      chainId: this.provider.chainId,
       currentBlock: this.currentBlock,
+      timestamp: this.timestamp,
       addressProvider: this.addressProvider.state,
       markets: this.marketRegister.state
     };
@@ -419,16 +442,18 @@ class GearboxSDK {
     return this.#addressProvider;
   }
   get botListContract() {
-    if (this.#botListContract === void 0) {
-      throw ERR_NOT_ATTACHED;
+    const addr = this.addressProvider.getAddress(AP_BOT_LIST, NO_VERSION);
+    if (!this.contracts.has(addr)) {
+      return new BotListContract(this, addr);
     }
-    return this.#botListContract;
+    return this.contracts.get(addr);
   }
   get gearStakingContract() {
-    if (this.#gearStakingContract === void 0) {
-      throw ERR_NOT_ATTACHED;
+    const addr = this.addressProvider.getAddress(AP_GEAR_STAKING, NO_VERSION);
+    if (!this.contracts.has(addr)) {
+      return new GearStakingContract(this, addr);
     }
-    return this.#gearStakingContract;
+    return this.contracts.get(addr);
   }
   get marketRegister() {
     if (this.#marketRegister === void 0) {
@@ -463,12 +488,13 @@ class GearboxSDK {
       );
     }
     const [routerAddr, routerV] = routerEntry;
-    if (!this.#routers.has(routerAddr)) {
-      this.#routers.upsert(routerAddr, createRouter(this, routerAddr, routerV));
+    if (!this.contracts.has(routerAddr)) {
+      return createRouter(this, routerAddr, routerV);
     }
-    return this.#routers.mustGet(routerAddr);
+    return this.contracts.get(routerAddr);
   }
 }
 export {
-  GearboxSDK
+  GearboxSDK,
+  STATE_VERSION
 };

package/dist/esm/sdk/core/address-provider/{AddressProviderV3Contract.js → AddressProviderV300Contract.js}

@@ -4,15 +4,15 @@ import { ADDRESS_PROVIDER_BLOCK } from "../../constants/index.js";
 import { getLogsSafe } from "../../utils/viem/index.js";
 import AbstractAddressProviderContract from "./AbstractAddressProviderContract.js";
 const abi = iAddressProviderV300Abi;
-class AddressProviderContractV3 extends AbstractAddressProviderContract {
-  constructor(sdk, address, addresses = {}) {
+class AddressProviderV300Contract extends AbstractAddressProviderContract {
+  constructor(sdk, address, version, addresses = {}) {
     super(
       sdk,
       {
         addr: address,
-        name: "AddressProviderV3",
+        name: "AddressProviderV300",
         abi,
-        version: 300
+        version
       },
       addresses
     );
@@ -74,5 +74,5 @@ class AddressProviderContractV3 extends AbstractAddressProviderContract {
   }
 }
 export {
-  AddressProviderContractV3
+  AddressProviderV300Contract
 };

package/dist/esm/sdk/core/address-provider/{AddressProviderV3_1Contract.js → AddressProviderV310Contract.js}

@@ -2,15 +2,15 @@ import { bytesToString, parseEventLogs, toBytes } from "viem";
 import { iAddressProviderV310Abi } from "../../../abi/v310.js";
 import AbstractAddressProviderContract from "./AbstractAddressProviderContract.js";
 const abi = iAddressProviderV310Abi;
-class AddressProviderContractV3_1 extends AbstractAddressProviderContract {
-  constructor(sdk, address, addresses = {}) {
+class AddressProviderV310Contract extends AbstractAddressProviderContract {
+  constructor(sdk, address, version, addresses = {}) {
     super(
       sdk,
       {
         addr: address,
-        name: "AddressProviderV3_1",
+        name: "AddressProviderV310",
         abi,
-        version: 310
+        version
       },
       addresses
     );
@@ -59,5 +59,5 @@ class AddressProviderContractV3_1 extends AbstractAddressProviderContract {
   }
 }
 export {
-  AddressProviderContractV3_1
+  AddressProviderV310Contract
 };

package/dist/esm/sdk/core/address-provider/createAddressProvider.js

@@ -1,34 +1,29 @@
 import { iVersionAbi } from "../../../abi/iVersion.js";
-import { AddressProviderContractV3_1 } from "./AddressProviderV3_1Contract.js";
-import { AddressProviderContractV3 } from "./AddressProviderV3Contract.js";
-async function createAddressProvider(sdk, address, options) {
-  const addr = options?.state?.baseParams.addr ?? address;
-  let v = options?.state?.baseParams.version ?? options?.version;
-  if (!v) {
-    const vv = await sdk.provider.publicClient.readContract({
-      address: addr,
-      abi: iVersionAbi,
-      functionName: "version"
-    });
-    v = Number(vv);
+import { isV300, isV310 } from "../../utils/index.js";
+import { AddressProviderV300Contract } from "./AddressProviderV300Contract.js";
+import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
+async function createAddressProvider(sdk, address) {
+  const v = await sdk.provider.publicClient.readContract({
+    address,
+    abi: iVersionAbi,
+    functionName: "version"
+  });
+  return newAddressProvider(sdk, address, Number(v));
+}
+function hydrateAddressProvider(sdk, state) {
+  const { addr, version } = state.baseParams;
+  return newAddressProvider(sdk, addr, Number(version), state.addresses);
+}
+function newAddressProvider(sdk, address, version, addresses) {
+  if (isV300(version)) {
+    return new AddressProviderV300Contract(sdk, address, version, addresses);
   }
-  switch (v) {
-    case 300:
-      return new AddressProviderContractV3(
-        sdk,
-        addr,
-        options?.state?.addresses
-      );
-    case 310:
-      return new AddressProviderContractV3_1(
-        sdk,
-        addr,
-        options?.state?.addresses
-      );
-    default:
-      throw new Error(`Unsupported address provider version: ${v}`);
+  if (isV310(version)) {
+    return new AddressProviderV310Contract(sdk, address, version, addresses);
   }
+  throw new Error(`unsupported address provider version: ${version}`);
 }
 export {
-  createAddressProvider
+  createAddressProvider,
+  hydrateAddressProvider
 };

package/dist/esm/sdk/core/address-provider/index.js

@@ -1,4 +1,4 @@
-export * from "./AddressProviderV3_1Contract.js";
-export * from "./AddressProviderV3Contract.js";
+export * from "./AddressProviderV300Contract.js";
+export * from "./AddressProviderV310Contract.js";
 export * from "./createAddressProvider.js";
 export * from "./types.js";

package/dist/esm/sdk/gauges/GaugeStakingService.js

@@ -14,7 +14,13 @@ class GaugeStakingService extends SDKConstruct {
    */
   async getGaugeStakingData(wallet) {
     const marketFilter = this.sdk.marketRegister.marketFilter;
-    if (!marketFilter) throw new Error("market filter is not set");
+    const gearStaking = this.sdk.gearStakingContract;
+    if (!marketFilter) {
+      throw new Error("market filter is not set");
+    }
+    if (!gearStaking) {
+      throw new Error("gear staking contract is not set");
+    }
     const [gauges, availableBalance, totalBalance, withdrawableAmounts, epoch] = await this.provider.publicClient.multicall({
       allowFailure: false,
       contracts: [
@@ -25,26 +31,26 @@ class GaugeStakingService extends SDKConstruct {
           args: [marketFilter, wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "availableBalance",
           args: [wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "balanceOf",
           args: [wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "getWithdrawableAmounts",
           args: [wallet]
         },
         {
-          address: this.sdk.gearStakingContract.address,
-          abi: this.sdk.gearStakingContract.abi,
+          address: gearStaking.address,
+          abi: gearStaking.abi,
           functionName: "getCurrentEpoch",
           args: []
         }

package/dist/esm/sdk/market/MarketRegister.js

@@ -11,10 +11,13 @@ class MarketRegister extends SDKConstruct {
    */
   #markets = new AddressMap(void 0, "markets");
   #marketFilter;
-  constructor(sdk, markets) {
+  constructor(sdk) {
     super(sdk);
     this.#logger = childLogger("MarketRegister", sdk.logger);
-    for (const data of markets ?? []) {
+  }
+  hydrate(state) {
+    this.#markets.clear();
+    for (const data of state) {
       this.#markets.upsert(
         data.pool.baseParams.addr,
         new MarketSuite(this.sdk, data)

package/dist/esm/sdk/utils/index.js

@@ -10,3 +10,4 @@ export * from "./json.js";
 export * from "./mappers.js";
 export * from "./retry.js";
 export * from "./toAddress.js";
+export * from "./version.js";

package/dist/esm/sdk/utils/version.js

@@ -0,0 +1,10 @@
+function isV300(version) {
+  return version >= 300 && version < 310;
+}
+function isV310(version) {
+  return version >= 310 && version < 320;
+}
+export {
+  isV300,
+  isV310
+};

package/dist/types/sdk/GearboxSDK.d.ts

@@ -11,6 +11,10 @@ import { type PluginInstances, type PluginMap } from "./plugins/index.js";
 import { type IRouterContract } from "./router/index.js";
 import type { GearboxState, GearboxStateHuman, ILogger, MultiCall } from "./types/index.js";
 import { AddressMap } from "./utils/index.js";
+/**
+ * State version, checked duryng hydration
+ */
+export declare const STATE_VERSION = 1;
 export interface SDKOptions<Plugins extends PluginMap = {}> {
     /**
      * If not set, address provider address is determinted automatically from networkType
@@ -51,6 +55,7 @@ export interface SDKOptions<Plugins extends PluginMap = {}> {
      */
     logger?: ILogger;
 }
+export type HydrateOptions = Pick<SDKOptions, "ignoreUpdateablePrices" | "logger" | "redstoneGateways" | "redstoneHistoricTimestamp" | "strictContractTypes">;
 export interface SyncStateOptions {
     blockNumber: bigint;
     timestamp: bigint;
@@ -87,6 +92,7 @@ export declare class GearboxSDK<Plugins extends PluginMap = {}> {
     addHook: <K extends "syncState">(hookName: K, fn: (...args: SDKHooks[K]) => void | Promise<void>) => void;
     removeHook: <K extends "syncState">(hookName: K, fn: (...args: SDKHooks[K]) => void | Promise<void>) => void;
     static attach<Plugins extends PluginMap>(options: SDKOptions<Plugins> & Partial<NetworkOptions> & ConnectionOptions & TransportOptions): Promise<GearboxSDK<Plugins>>;
+    static hydrate(options: HydrateOptions & ConnectionOptions & TransportOptions, state: GearboxState): GearboxSDK;
     private constructor();
     /**
      * Reattach SDK with the same config as before, without re-creating instance. Will load all state from scratch
@@ -147,8 +153,8 @@ export declare class GearboxSDK<Plugins extends PluginMap = {}> {
     get timestamp(): bigint;
     get gear(): Address | undefined;
     get addressProvider(): IAddressProviderContract;
-    get botListContract(): BotListContract;
-    get gearStakingContract(): GearStakingContract;
+    get botListContract(): BotListContract | undefined;
+    get gearStakingContract(): GearStakingContract | undefined;
     get marketRegister(): MarketRegister;
     /**
      * Returns router contract that will work for given credit manager or credit facade

package/dist/types/sdk/core/address-provider/{AddressProviderV3Contract.d.ts → AddressProviderV300Contract.d.ts}

@@ -88,8 +88,8 @@ declare const abi: readonly [{
     readonly anonymous: false;
 }];
 type abi = typeof abi;
-export declare class AddressProviderContractV3 extends AbstractAddressProviderContract<abi> implements IAddressProviderContract {
-    constructor(sdk: GearboxSDK, address: Address, addresses?: Record<string, Record<number, Address>>);
+export declare class AddressProviderV300Contract extends AbstractAddressProviderContract<abi> implements IAddressProviderContract {
+    constructor(sdk: GearboxSDK, address: Address, version: number, addresses?: Record<string, Record<number, Address>>);
     protected parseFunctionParams(params: DecodeFunctionDataReturnType<abi>): Array<string> | undefined;
     processLog(log: Log<bigint, number, false, undefined, undefined, abi, ContractEventName<abi>>): void;
     syncState(blockNumber?: bigint): Promise<void>;

package/dist/types/sdk/core/address-provider/{AddressProviderV3_1Contract.d.ts → AddressProviderV310Contract.d.ts}

@@ -253,8 +253,8 @@ declare const abi: readonly [{
     readonly name: "ZeroAddressException";
 }];
 type abi = typeof abi;
-export declare class AddressProviderContractV3_1 extends AbstractAddressProviderContract<abi> implements IAddressProviderContract {
-    constructor(sdk: GearboxSDK, address: Address, addresses?: Record<string, Record<number, Address>>);
+export declare class AddressProviderV310Contract extends AbstractAddressProviderContract<abi> implements IAddressProviderContract {
+    constructor(sdk: GearboxSDK, address: Address, version: number, addresses?: Record<string, Record<number, Address>>);
     protected parseFunctionParams(params: DecodeFunctionDataReturnType<abi>): Array<string> | undefined;
     processLog(log: Log<bigint, number, false, undefined, undefined, abi, ContractEventName<abi>>): void;
     syncState(blockNumber?: bigint): Promise<void>;

package/dist/types/sdk/core/address-provider/createAddressProvider.d.ts

@@ -1,8 +1,5 @@
 import type { Address } from "viem";
 import type { GearboxSDK } from "../../GearboxSDK.js";
 import type { AddressProviderState, IAddressProviderContract } from "./types.js";
-export interface CreateAddressProviderOptions {
-    version?: number;
-    state?: AddressProviderState;
-}
-export declare function createAddressProvider(sdk: GearboxSDK, address: Address, options?: CreateAddressProviderOptions): Promise<IAddressProviderContract>;
+export declare function createAddressProvider(sdk: GearboxSDK, address: Address): Promise<IAddressProviderContract>;
+export declare function hydrateAddressProvider(sdk: GearboxSDK, state: AddressProviderState): IAddressProviderContract;

package/dist/types/sdk/core/address-provider/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./AddressProviderV3_1Contract.js";
-export * from "./AddressProviderV3Contract.js";
+export * from "./AddressProviderV300Contract.js";
+export * from "./AddressProviderV310Contract.js";
 export * from "./createAddressProvider.js";
 export * from "./types.js";

package/dist/types/sdk/market/MarketRegister.d.ts

@@ -10,7 +10,8 @@ import { MarketSuite } from "./MarketSuite.js";
 import type { PoolSuite } from "./pool/index.js";
 export declare class MarketRegister extends SDKConstruct {
     #private;
-    constructor(sdk: GearboxSDK, markets?: MarketData[]);
+    constructor(sdk: GearboxSDK);
+    hydrate(state: MarketData[]): void;
     loadMarkets(marketConfigurators: Address[], ignoreUpdateablePrices?: boolean): Promise<void>;
     get marketFilter(): {
         configurators: readonly `0x${string}`[];

package/dist/types/sdk/types/state-human.d.ts

@@ -16,8 +16,8 @@ export interface GearStakingV3StateHuman extends BaseContractStateHuman {
 export type BotListStateHuman = BaseContractStateHuman;
 export interface CoreStateHuman {
     addressProviderV3: AddressProviderV3StateHuman;
-    botList: BotListStateHuman;
-    gearStakingV3: GearStakingV3StateHuman;
+    botList?: BotListStateHuman;
+    gearStakingV3?: GearStakingV3StateHuman;
 }
 export type PriceFeedStateHuman = BoundedOracleStateHuman | AssetPriceFeedStateHuman | RedstonePriceFeedStateHuman | LPPriceFeedStateHuman | BalancerWeightedPriceFeedStateHuman;
 export interface BasePriceFeedStateHuman extends BaseContractStateHuman {

package/dist/types/sdk/types/state.d.ts

@@ -1,7 +1,16 @@
 import type { MarketData } from "../base/index.js";
+import type { NetworkType } from "../chain/chains.js";
 import type { AddressProviderState } from "../core/index.js";
 export interface GearboxState {
+    /**
+     * State version, checked duryng hydration
+     * This is not the same as @gearbox-protocol/sdk package version
+     */
+    version: number;
+    network: NetworkType;
+    chainId: number;
     currentBlock: bigint;
+    timestamp: bigint;
     addressProvider: AddressProviderState;
     markets: MarketData[];
 }

package/dist/types/sdk/utils/index.d.ts

@@ -10,3 +10,4 @@ export * from "./json.js";
 export * from "./mappers.js";
 export * from "./retry.js";
 export * from "./toAddress.js";
+export * from "./version.js";

package/dist/types/sdk/utils/version.d.ts

@@ -0,0 +1,2 @@
+export declare function isV300(version: number): boolean;
+export declare function isV310(version: number): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "4.1.9",
+  "version": "4.2.0-next.1",
   "description": "Gearbox SDK",
   "license": "MIT",
   "main": "./dist/cjs/sdk/index.js",