@gearbox-protocol/sdk 15.0.0 → 15.1.0-next.2

package/dist/cjs/sdk/OnchainSDK.js

@@ -1,533 +1,500 @@
-"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 OnchainSDK_exports = {};
-__export(OnchainSDK_exports, {
-  OnchainSDK: () => OnchainSDK,
-  STATE_VERSION: () => STATE_VERSION
-});
-module.exports = __toCommonJS(OnchainSDK_exports);
-var import_viem = require("viem");
-var import_accounts = require("./accounts/index.js");
-var import_base = require("./base/index.js");
-var import_chain = require("./chain/index.js");
-var import_constants = require("./constants/index.js");
-var import_core = require("./core/index.js");
-var import_market = require("./market/index.js");
-var import_MarketRegister = require("./market/MarketRegister.js");
-var import_pricefeeds = require("./market/pricefeeds/index.js");
-var import_plugins = require("./plugins/index.js");
-var import_pools = require("./pools/index.js");
-var import_router = require("./router/index.js");
-var import_utils = require("./utils/index.js");
-var import_viem2 = require("./utils/viem/index.js");
-const STATE_VERSION = 1;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_utils_mappers = require("./utils/mappers.js");
+const require_sdk_chain_chains = require("./chain/chains.js");
+require("./chain/index.js");
+const require_sdk_constants_address_provider = require("./constants/address-provider.js");
+const require_sdk_constants_versions = require("./constants/versions.js");
+require("./constants/index.js");
+const require_sdk_utils_formatter = require("./utils/formatter.js");
+const require_sdk_utils_toAddress = require("./utils/toAddress.js");
+require("./utils/index.js");
+const require_sdk_utils_viem_executeMulticallBatches = require("./utils/viem/executeMulticallBatches.js");
+const require_sdk_base_ChainContractsRegister = require("./base/ChainContractsRegister.js");
+require("./base/index.js");
+const require_sdk_utils_viem_executeDelegatedMulticalls = require("./utils/viem/executeDelegatedMulticalls.js");
+require("./utils/viem/index.js");
+const require_sdk_market_pricefeeds_PriceFeedsRegister = require("./market/pricefeeds/PriceFeedsRegister.js");
+require("./market/pricefeeds/index.js");
+const require_sdk_market_MarketRegister = require("./market/MarketRegister.js");
+const require_sdk_market_rwa_RWARegistry = require("./market/rwa/RWARegistry.js");
+require("./market/index.js");
+const require_sdk_accounts_CreditAccountsServiceV310 = require("./accounts/CreditAccountsServiceV310.js");
+const require_sdk_accounts_liquidations_LiquidationsService = require("./accounts/liquidations/LiquidationsService.js");
+const require_sdk_accounts_withdrawal_compressor_createRedemptionLogger = require("./accounts/withdrawal-compressor/createRedemptionLogger.js");
+const require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor = require("./accounts/withdrawal-compressor/createWithdrawalCompressor.js");
+require("./accounts/index.js");
+const require_sdk_core_createAddressProvider = require("./core/createAddressProvider.js");
+const require_sdk_core_errors = require("./core/errors.js");
+require("./core/index.js");
+const require_sdk_opportunities_OpportunitiesService = require("./opportunities/OpportunitiesService.js");
+require("./opportunities/index.js");
+const require_sdk_plugins_errors = require("./plugins/errors.js");
+require("./plugins/index.js");
+const require_sdk_pools_PoolService = require("./pools/PoolService.js");
+require("./pools/index.js");
+const require_sdk_positions_PositionsService = require("./positions/PositionsService.js");
+require("./positions/index.js");
+const require_sdk_router_createRouter = require("./router/createRouter.js");
+require("./router/index.js");
+let viem = require("viem");
+//#region src/sdk/OnchainSDK.ts
+/**
+* Serialised state format version, checked during hydration to detect
+* incompatible snapshots.
+**/
+const STATE_VERSION = 2;
+/**
+* @internal
+* Creates a viem `PublicClient` from the given connection options.
+*/
 function createViemClient(opts, chain) {
-  if ("client" in opts) {
-    return opts.client;
-  }
-  let transport;
-  if ("transport" in opts) {
-    transport = opts.transport;
-  } else {
-    const rpcs = opts.rpcURLs.map(
-      (url) => (0, import_viem.http)(url, {
-        ...opts.httpTransportOptions,
-        timeout: opts.timeout,
-        retryCount: opts.retryCount
-      })
-    );
-    transport = rpcs.length > 1 ? (0, import_viem.fallback)(rpcs) : rpcs[0];
-  }
-  return (0, import_viem.createPublicClient)({ transport, chain });
+	if ("client" in opts) return opts.client;
+	let transport;
+	if ("transport" in opts) transport = opts.transport;
+	else {
+		const rpcs = opts.rpcURLs.map((url) => (0, viem.http)(url, {
+			...opts.httpTransportOptions,
+			timeout: opts.timeout,
+			retryCount: opts.retryCount
+		}));
+		transport = rpcs.length > 1 ? (0, viem.fallback)(rpcs) : rpcs[0];
+	}
+	return (0, viem.createPublicClient)({
+		transport,
+		chain
+	});
 }
-class OnchainSDK extends import_base.ChainContractsRegister {
-  /** Registered plugin instances, keyed by plugin name. */
-  plugins;
-  #currentBlock;
-  #timestamp;
-  #syncing = false;
-  #attached = false;
-  #addressProvider;
-  #rwa;
-  #marketRegister;
-  #priceFeeds;
-  /**
-   * Gas limit applied to read-only `eth_call` requests.
-   **/
-  gasLimit;
-  /**
-   * When `true`, the SDK throws on unrecognised contract types.
-   **/
-  strictContractTypes;
-  /**
-   * Namespace for credit accounts operations.
-   */
-  accounts;
-  /**
-   * Namespace for pool operations.
-   */
-  pools;
-  /**
-   * @param network - Gearbox network type (e.g. `"Mainnet"`, `"Monad"`).
-   * @param clientOptions - Connection options (RPC URLs, transport, or client).
-   * @param options - SDK configuration options.
-   */
-  constructor(network, clientOptions, options) {
-    const gearboxChain = (0, import_chain.getChain)(network);
-    if ("client" in clientOptions) {
-      const clientChainId = clientOptions.client.chain?.id;
-      if (clientChainId !== void 0 && clientChainId !== gearboxChain.id) {
-        throw new import_core.SdkChainMismatchError(gearboxChain.id, clientChainId);
-      }
-    }
-    const client = createViemClient(clientOptions, gearboxChain);
-    super(client, options?.logger);
-    this.strictContractTypes = options?.strictContractTypes ?? false;
-    this.plugins = options?.plugins ?? {};
-    this.#rwa = new import_market.RWARegistry(this);
-    for (const plugin of Object.values(this.plugins)) {
-      plugin.sdk = this;
-    }
-    if (options?.gasLimit !== null) {
-      this.gasLimit = options?.gasLimit ?? (0, import_chain.getChain)(this.networkType).gasLimit;
-    }
-    this.accounts = new import_accounts.CreditAccountsServiceV310(this);
-    this.pools = new import_pools.PoolService(this);
-  }
-  /**
-   * Initialises the SDK by reading live on-chain state.
-   *
-   * @param options - Attach configuration.
-   * @throws {@link SdkAlreadyAttachedError} if already attached.
-   */
-  async attach(options) {
-    if (this.#attached) {
-      throw new import_core.SdkAlreadyAttachedError();
-    }
-    const {
-      addressProvider = import_constants.ADDRESS_PROVIDER_V310,
-      blockNumber,
-      ignoreUpdateablePrices,
-      ignoreMarkets,
-      marketConfigurators: mcs,
-      redstone
-    } = options ?? {};
-    const marketConfigurators = mcs ?? import_utils.TypedObjectUtils.keys(
-      this.client.chain.defaultMarketConfigurators
-    );
-    const rwaFactories = options?.rwaFactories ?? this.client.chain.rwaFactories;
-    this.logger?.info(
-      {
-        networkType: this.networkType,
-        chainId: this.chainId,
-        addressProvider,
-        marketConfigurators,
-        blockNumber,
-        ignoreMarkets
-      },
-      "attaching sdk"
-    );
-    const time = Date.now();
-    const block = await this.client.getBlock(
-      blockNumber ? { blockNumber: BigInt(blockNumber) } : { blockTag: "latest" }
-    );
-    this.#currentBlock = block.number;
-    this.#timestamp = block.timestamp;
-    if (blockNumber && !redstone?.historicTimestamp && time - Number(block.timestamp) * 1e3 > 60 * 1e3) {
-      this.logger?.warn(
-        "attaching to fixed block number, but redstone historicTimestamp is not set. price updates might fail"
-      );
-    }
-    this.#priceFeeds = new import_pricefeeds.PriceFeedRegister(this, { redstone });
-    this.logger?.debug(
-      `attach block number ${this.currentBlock} timestamp ${this.timestamp}`
-    );
-    this.#addressProvider = await (0, import_core.createAddressProvider)(this, addressProvider);
-    this.logger?.debug(
-      `address provider version: ${this.#addressProvider.version}`
-    );
-    await this.#addressProvider.syncState(this.currentBlock);
-    this.#marketRegister = new import_MarketRegister.MarketRegister(this, ignoreMarkets);
-    if (!marketConfigurators.length) {
-      this.logger?.warn(
-        "no market configurators provided, skipping market loading"
-      );
-    } else {
-      const delegated = [
-        ...this.#marketRegister.getLoadMulticalls(marketConfigurators),
-        ...this.#rwa.getLoadMulticalls(marketConfigurators, rwaFactories)
-      ];
-      let txs = [];
-      if (!ignoreUpdateablePrices) {
-        const updatables = await this.#priceFeeds.getPartialUpdatablePriceFeeds(
-          marketConfigurators
-        );
-        const updates = await this.#priceFeeds.generatePriceFeedsUpdateTxs(updatables);
-        txs = updates.txs;
-      }
-      this.logger?.debug(
-        { configurators: marketConfigurators },
-        `calling getMarkets with ${txs.length} price updates in block ${this.currentBlock}`
-      );
-      await (0, import_viem2.executeDelegatedMulticalls)(this.client, delegated, {
-        priceUpdates: txs,
-        blockNumber: this.currentBlock,
-        gas: this.gasLimit
-      });
-    }
-    const pluginsList = import_utils.TypedObjectUtils.entries(this.plugins);
-    const pluginResponse = await Promise.allSettled(
-      pluginsList.map(([name, plugin]) => {
-        if (plugin.attach) {
-          this.logger?.debug(`attaching plugin ${name}`);
-          return plugin.attach();
-        }
-        return void 0;
-      })
-    );
-    pluginResponse.forEach((r, i) => {
-      const [name, plugin] = pluginsList[i];
-      if (plugin.attach && r.status === "fulfilled") {
-        this.logger?.debug(`attached plugin ${name}`);
-      } else if (plugin.attach && r.status === "rejected") {
-        this.logger?.error(r.reason, `failed to attach plugin ${name}`);
-      }
-    });
-    this.logger?.info(`attach time: ${Date.now() - time} ms`);
-    this.#attached = true;
-  }
-  /**
-   * Restores SDK state from a previously serialised {@link GearboxState}
-   * snapshot, without making any on-chain calls.
-   *
-   * @param state - Serialised state obtained from {@link OnchainSDK.state}.
-   * @param options - Hydrate configuration.
-   * @throws {@link SdkAlreadyAttachedError} if already attached.
-   * @throws {@link SdkStateVersionMismatchError} if snapshot version doesn't match.
-   * @throws {@link SdkChainMismatchError} if snapshot network doesn't match.
-   */
-  hydrate(state, options) {
-    if (this.#attached) {
-      throw new import_core.SdkAlreadyAttachedError();
-    }
-    if (state.version !== STATE_VERSION) {
-      throw new import_core.SdkStateVersionMismatchError(STATE_VERSION, state.version);
-    }
-    if (state.network !== this.networkType) {
-      throw new import_core.SdkChainMismatchError(this.networkType, state.network);
-    }
-    const { ignoreMarkets, redstone } = options ?? {};
-    this.logger?.info({ networkType: this.networkType }, "hydrating sdk state");
-    this.#currentBlock = state.currentBlock;
-    this.#timestamp = state.timestamp;
-    this.#priceFeeds = new import_pricefeeds.PriceFeedRegister(this, { redstone });
-    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, ignoreMarkets);
-    this.#marketRegister.hydrate(state.markets);
-    this.#rwa = new import_market.RWARegistry(this);
-    this.#rwa.setState(state.rwa);
-    for (const [name, plugin] of import_utils.TypedObjectUtils.entries(this.plugins)) {
-      const pluginState = state.plugins[name];
-      if (plugin.hydrate && pluginState) {
-        if (!pluginState.loaded) {
-          this.logger?.debug(
-            `skipping hydrating plugin ${name} state: not loaded`
-          );
-          continue;
-        }
-        if (pluginState.version !== plugin.version) {
-          throw new import_plugins.PluginStateVersionError(plugin, pluginState);
-        }
-        plugin.hydrate(pluginState);
-      }
-    }
-    this.logger?.info("hydrated sdk state");
-    this.#attached = true;
-  }
-  /**
-   * Gearbox network type the SDK is connected to (e.g. `"Mainnet"`, `"Arbitrum"`).
-   **/
-  get networkType() {
-    return this.client.chain.network;
-  }
-  /**
-   * Whether the SDK has been initialised via {@link attach} or {@link hydrate}.
-   **/
-  get attached() {
-    return this.#attached;
-  }
-  /**
-   * Returns a human-readable snapshot of the entire SDK state.
-   * @param raw - When `true`, include raw numeric values alongside formatted ones.
-   */
-  stateHuman(raw = true) {
-    return {
-      network: this.networkType,
-      block: Number(this.currentBlock),
-      timestamp: (0, import_utils.formatTimestamp)(Number(this.timestamp), raw),
-      core: {
-        addressProviderV3: this.addressProvider.stateHuman(raw)
-      },
-      tokens: this.tokensMeta.values(),
-      rwa: this.#rwa.stateHuman(raw),
-      plugins: Object.fromEntries(
-        import_utils.TypedObjectUtils.entries(this.plugins).map(([name, plugin]) => [
-          name,
-          plugin.loaded ? plugin.stateHuman?.(raw) : void 0
-        ])
-      ),
-      ...this.marketRegister.stateHuman(raw)
-    };
-  }
-  /** Serialisable snapshot of the current SDK state. */
-  get state() {
-    return {
-      version: STATE_VERSION,
-      network: this.networkType,
-      chainId: this.chainId,
-      currentBlock: this.currentBlock,
-      timestamp: this.timestamp,
-      addressProvider: this.addressProvider.state,
-      markets: this.marketRegister.state,
-      rwa: this.#rwa.state,
-      plugins: Object.fromEntries(
-        import_utils.TypedObjectUtils.entries(this.plugins).map(([name, plugin]) => [
-          name,
-          plugin.loaded ? { version: plugin.version, loaded: true, ...plugin.state } : { version: plugin.version, loaded: false }
-        ])
-      )
-    };
-  }
-  /**
-   * Incrementally updates SDK state by replaying on-chain events.
-   *
-   * @param opts - Target block and sync behaviour.
-   * @returns `true` if the sync completed successfully.
-   */
-  async syncState(opts) {
-    let { blockNumber, timestamp, ignoreUpdateablePrices } = opts ?? {};
-    if (this.priceFeeds.historical && !ignoreUpdateablePrices) {
-      this.logger?.warn(
-        "syncState is not supported with redstone historicTimestamp"
-      );
-    }
-    if (!blockNumber || !timestamp) {
-      const block = await this.client.getBlock({
-        blockTag: "latest"
-      });
-      blockNumber = block.number;
-      timestamp = block.timestamp;
-    }
-    if (blockNumber <= this.currentBlock) {
-      return false;
-    }
-    if (this.#syncing) {
-      this.logger?.warn(
-        `cannot sync to ${blockNumber}, already syncing at ${this.currentBlock}`
-      );
-      return false;
-    }
-    this.#syncing = true;
-    const prevBlock = this.currentBlock;
-    const prevTimestamp = this.timestamp;
-    let success = false;
-    try {
-      let delta = Math.floor(Date.now() / 1e3) - Number(timestamp);
-      this.logger?.debug(
-        `syncing state to block ${blockNumber} (delta ${delta}s )...`
-      );
-      const watchAddresses = [
-        ...Array.from(this.marketRegister.watchAddresses),
-        this.addressProvider.address
-      ];
-      const fromBlock = this.currentBlock + 1n;
-      this.logger?.debug(
-        `getting logs from ${watchAddresses.length} addresses in [${fromBlock}:${blockNumber}]`
-      );
-      const logs = await this.client.getLogs({
-        fromBlock,
-        toBlock: blockNumber,
-        address: watchAddresses
-      });
-      for (const log of logs) {
-        const contract = this.getContract(log.address);
-        if (contract) {
-          const event = (0, import_viem.parseEventLogs)({
-            abi: contract.abi,
-            logs: [log]
-          })[0];
-          contract.processLog(event);
-        }
-      }
-      this.#currentBlock = blockNumber;
-      this.#timestamp = timestamp;
-      await this.marketRegister.syncState(ignoreUpdateablePrices);
-      const pluginsList = import_utils.TypedObjectUtils.entries(this.plugins);
-      const pluginResponse = await Promise.allSettled(
-        pluginsList.map(([name, plugin]) => {
-          if (plugin.syncState) {
-            this.logger?.debug(`syncing plugin ${name}`);
-            return plugin.syncState();
-          }
-          return void 0;
-        })
-      );
-      pluginResponse.forEach((r, i) => {
-        const [name, plugin] = pluginsList[i];
-        if (plugin.syncState && r.status === "fulfilled") {
-          this.logger?.debug(`synced plugin ${name}`);
-        } else if (plugin.syncState && r.status === "rejected") {
-          this.logger?.error(r.reason, `failed to sync plugin ${name}`);
-        }
-      });
-      delta = Math.floor(Date.now() / 1e3) - Number(timestamp);
-      this.logger?.debug(
-        `synced state to block ${blockNumber} (delta ${delta}s)`
-      );
-      success = true;
-    } catch (e) {
-      this.logger?.error(
-        `sync state to block ${blockNumber} with ts ${timestamp} failed, reverting to old block ${prevBlock} with ts ${prevTimestamp}: ${e}`
-      );
-      this.#currentBlock = prevBlock;
-      this.#timestamp = prevTimestamp;
-    } finally {
-      this.#syncing = false;
-    }
-    return success;
-  }
-  /**
-   * Block number that the SDK state corresponds to.
-   * @throws {@link SdkNotAttachedError} if not attached.
-   */
-  get currentBlock() {
-    if (this.#currentBlock === void 0) {
-      throw new import_core.SdkNotAttachedError();
-    }
-    return this.#currentBlock;
-  }
-  /**
-   * Block timestamp (Unix epoch seconds) corresponding to {@link currentBlock}.
-   * @throws {@link SdkNotAttachedError} if not attached.
-   */
-  get timestamp() {
-    if (this.#timestamp === void 0) {
-      throw new import_core.SdkNotAttachedError();
-    }
-    return this.#timestamp;
-  }
-  /**
-   * Global registry of all price feeds known to the SDK.
-   * @throws {@link SdkNotAttachedError} if not attached.
-   */
-  get priceFeeds() {
-    if (this.#priceFeeds === void 0) {
-      throw new import_core.SdkNotAttachedError();
-    }
-    return this.#priceFeeds;
-  }
-  /** GEAR governance token address, or `undefined` if not listed. */
-  get gear() {
-    try {
-      const g = this.addressProvider.getAddress(import_constants.AP_GEAR_TOKEN, import_constants.NO_VERSION);
-      return g;
-    } catch (e) {
-      this.logger?.warn(e);
-      return void 0;
-    }
-  }
-  /**
-   * The chain's address provider contract.
-   * @throws {@link SdkNotAttachedError} if not attached.
-   */
-  get addressProvider() {
-    if (this.#addressProvider === void 0) {
-      throw new import_core.SdkNotAttachedError();
-    }
-    return this.#addressProvider;
-  }
-  /**
-   * Registry of all loaded markets.
-   * @throws {@link SdkNotAttachedError} if not attached.
-   */
-  get marketRegister() {
-    if (this.#marketRegister === void 0) {
-      throw new import_core.SdkNotAttachedError();
-    }
-    return this.#marketRegister;
-  }
-  /**
-   * RWA register for RWA-wrapped underlying tokens and factories.
-   *
-   * @throws If the SDK has not been attached or hydrated yet.
-   **/
-  get rwa() {
-    if (this.#rwa === void 0) {
-      throw new import_core.SdkNotAttachedError();
-    }
-    return this.#rwa;
-  }
-  /**
-   * @internal
-   * Resolves the appropriate router contract for a given credit manager,
-   * credit facade, or explicit version range.
-   *
-   * @param params - Identifies the context: a credit manager address/state,
-   *   a credit facade address/state, or a {@link VersionRange}.
-   * @returns The matching router contract instance.
-   * @throws If the credit facade version is unsupported or no router is
-   *   registered for the resolved version range.
-   **/
-  routerFor(params) {
-    let routerRange;
-    if (Array.isArray(params)) {
-      routerRange = params;
-    } else {
-      let facadeAddr;
-      if ("creditFacade" in params) {
-        facadeAddr = (0, import_utils.toAddress)(params.creditFacade);
-      } else {
-        const cm = this.marketRegister.findCreditManager(
-          (0, import_utils.toAddress)(params.creditManager)
-        );
-        facadeAddr = cm.creditFacade.address;
-      }
-      const facadeV = this.mustGetContract(facadeAddr).version;
-      if ((0, import_constants.isV310)(facadeV)) {
-        routerRange = import_constants.VERSION_RANGE_310;
-      } else {
-        throw new Error(`Unsupported credit facade version ${facadeV}`);
-      }
-    }
-    const routerEntry = this.addressProvider.getLatest(import_constants.AP_ROUTER, routerRange);
-    if (!routerEntry) {
-      throw new Error(`router not found in version range ${routerRange}`);
-    }
-    const [routerAddr, routerV] = routerEntry;
-    return (0, import_router.createRouter)(this, routerAddr, routerV);
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  OnchainSDK,
-  STATE_VERSION
-});
+/**
+* Single-chain entry point for the Gearbox SDK.
+*
+* `OnchainSDK` aggregates on-chain state for the Gearbox protocol — markets,
+* credit managers, pools, price oracles, and price feeds — into a single
+* queryable object that can be kept up-to-date via {@link syncState} or
+* serialised/restored via {@link state}/{@link hydrate}.
+*
+* Create an instance with `new OnchainSDK(network, clientOptions, options)`,
+* then call {@link attach} (live chain data) or {@link hydrate} (saved snapshot).
+*
+* @typeParam Plugins - Map of plugin names to plugin instances that extend
+*   the SDK with additional domain-specific functionality.
+**/
+var OnchainSDK = class extends require_sdk_base_ChainContractsRegister.ChainContractsRegister {
+	/** Registered plugin instances, keyed by plugin name. */
+	plugins;
+	#currentBlock;
+	#timestamp;
+	#syncing = false;
+	#attached = false;
+	#addressProvider;
+	#rwa;
+	#marketRegister;
+	#priceFeeds;
+	#withdrawalCompressor;
+	#redemptionLogger;
+	/**
+	* Gas limit applied to read-only `eth_call` requests.
+	**/
+	gasLimit;
+	/**
+	* When `true`, the SDK throws on unrecognised contract types.
+	**/
+	strictContractTypes;
+	/**
+	* Namespace for credit accounts operations.
+	*/
+	accounts;
+	/**
+	* Namespace for pool operations.
+	*/
+	pools;
+	/**
+	* Namespace for liquidatable credit accounts discovery.
+	*/
+	liquidations;
+	/**
+	* Namespace for the pool and strategy opportunities of this chain.
+	*/
+	opportunities;
+	/**
+	* Namespace for the positions a wallet holds on this chain.
+	*/
+	positions;
+	/**
+	* @param network - Gearbox network type (e.g. `"Mainnet"`, `"Monad"`).
+	* @param clientOptions - Connection options (RPC URLs, transport, or client).
+	* @param options - SDK configuration options.
+	*/
+	constructor(network, clientOptions, options) {
+		const gearboxChain = require_sdk_chain_chains.getChain(network);
+		if ("client" in clientOptions) {
+			const clientChainId = clientOptions.client.chain?.id;
+			if (clientChainId !== void 0 && clientChainId !== gearboxChain.id) throw new require_sdk_core_errors.SdkChainMismatchError(gearboxChain.id, clientChainId);
+		}
+		const client = createViemClient(clientOptions, gearboxChain);
+		super(client, options?.logger);
+		this.strictContractTypes = options?.strictContractTypes ?? false;
+		this.plugins = options?.plugins ?? {};
+		this.#rwa = new require_sdk_market_rwa_RWARegistry.RWARegistry(this);
+		for (const plugin of Object.values(this.plugins)) plugin.sdk = this;
+		if (options?.gasLimit !== null) this.gasLimit = options?.gasLimit ?? require_sdk_chain_chains.getChain(this.networkType).gasLimit;
+		this.accounts = new require_sdk_accounts_CreditAccountsServiceV310.CreditAccountsServiceV310(this);
+		this.pools = new require_sdk_pools_PoolService.PoolService(this);
+		this.liquidations = new require_sdk_accounts_liquidations_LiquidationsService.LiquidationsService(this);
+		this.opportunities = new require_sdk_opportunities_OpportunitiesService.OpportunitiesService(this);
+		this.positions = new require_sdk_positions_PositionsService.PositionsService(this);
+		this.#withdrawalCompressor = require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor.createWithdrawalCompressor(this);
+	}
+	/**
+	* Initialises the SDK by reading live on-chain state.
+	*
+	* @param options - Attach configuration.
+	* @throws {@link SdkAlreadyAttachedError} if already attached.
+	*/
+	async attach(options) {
+		if (this.#attached) throw new require_sdk_core_errors.SdkAlreadyAttachedError();
+		const { addressProvider = require_sdk_constants_address_provider.ADDRESS_PROVIDER_V310, blockNumber, ignoreUpdateablePrices, ignoreMarkets, marketConfigurators: mcs, redstone } = options ?? {};
+		const marketConfigurators = mcs ?? require_sdk_utils_mappers.TypedObjectUtils.keys(this.client.chain.defaultMarketConfigurators);
+		const rwaFactories = options?.rwaFactories ?? this.client.chain.rwaFactories;
+		this.logger?.info({
+			networkType: this.networkType,
+			chainId: this.chainId,
+			addressProvider,
+			marketConfigurators,
+			blockNumber,
+			ignoreMarkets
+		}, "attaching sdk");
+		const time = Date.now();
+		const block = await this.client.getBlock(blockNumber ? { blockNumber: BigInt(blockNumber) } : { blockTag: "latest" });
+		this.#currentBlock = block.number;
+		this.#timestamp = block.timestamp;
+		if (blockNumber && !redstone?.historicTimestamp && time - Number(block.timestamp) * 1e3 > 6e4) this.logger?.warn("attaching to fixed block number, but redstone historicTimestamp is not set. price updates might fail");
+		this.#priceFeeds = new require_sdk_market_pricefeeds_PriceFeedsRegister.PriceFeedRegister(this, { redstone });
+		this.logger?.debug(`attach block number ${this.currentBlock} timestamp ${this.timestamp}`);
+		this.#addressProvider = await require_sdk_core_createAddressProvider.createAddressProvider(this, addressProvider);
+		this.logger?.debug(`address provider version: ${this.#addressProvider.version}`);
+		await this.#addressProvider.syncState(this.currentBlock);
+		this.#marketRegister = new require_sdk_market_MarketRegister.MarketRegister(this, ignoreMarkets);
+		if (!marketConfigurators.length) this.logger?.warn("no market configurators provided, skipping market loading");
+		else {
+			const priceUpdates = await this.#getPriceUpdateTxs(marketConfigurators, ignoreUpdateablePrices);
+			this.logger?.debug({ configurators: marketConfigurators }, `calling getMarkets with ${priceUpdates.length} price updates in block ${this.currentBlock}`);
+			const delegated = [...this.#marketRegister.getLoadMulticalls(marketConfigurators), ...this.#rwa.getLoadMulticalls(marketConfigurators, rwaFactories)];
+			await require_sdk_utils_viem_executeDelegatedMulticalls.executeDelegatedMulticalls(this.client, delegated, {
+				priceUpdates,
+				blockNumber: this.currentBlock,
+				gas: this.gasLimit
+			});
+			await this.#warmup();
+		}
+		const pluginsList = require_sdk_utils_mappers.TypedObjectUtils.entries(this.plugins);
+		(await Promise.allSettled(pluginsList.map(([name, plugin]) => {
+			if (plugin.attach) {
+				this.logger?.debug(`attaching plugin ${name}`);
+				return plugin.attach();
+			}
+		}))).forEach((r, i) => {
+			const [name, plugin] = pluginsList[i];
+			if (plugin.attach && r.status === "fulfilled") this.logger?.debug(`attached plugin ${name}`);
+			else if (plugin.attach && r.status === "rejected") this.logger?.error(r.reason, `failed to attach plugin ${name}`);
+		});
+		this.logger?.info(`attach time: ${Date.now() - time} ms`);
+		this.#attached = true;
+	}
+	/**
+	* @internal
+	* Pass 0 of attach: resolves the price updates that the market reads of
+	* pass 1 are simulated with.
+	*
+	* @param configurators - Market configurators whose feeds are considered.
+	* @param ignoreUpdateablePrices - When `true`, no updates are fetched.
+	**/
+	async #getPriceUpdateTxs(configurators, ignoreUpdateablePrices) {
+		if (ignoreUpdateablePrices) return [];
+		const updatables = await this.priceFeeds.getPartialUpdatablePriceFeeds(configurators);
+		const { txs } = await this.priceFeeds.generatePriceFeedsUpdateTxs(updatables);
+		return txs;
+	}
+	/**
+	* @internal
+	* Pass 2 of attach: loads the data that is read synchronously afterwards
+	* (zappers, withdrawable assets, extended token data) in a single multicall.
+	*
+	* Also re-run after a sync that reloaded the markets these caches derive from.
+	*
+	* @param force - Reload caches that are already populated.
+	**/
+	async #warmup(force = false) {
+		await require_sdk_utils_viem_executeMulticallBatches.executeMulticallBatches(this.client, [
+			this.marketRegister.getLoadZappersMulticall(force),
+			...this.#withdrawalCompressor ? [this.#withdrawalCompressor.getLoadWithdrawableAssetsMulticall(force)] : [],
+			this.tokensMeta.getLoadTokenDataMulticall()
+		], { blockNumber: this.currentBlock });
+	}
+	/**
+	* Restores SDK state from a previously serialised {@link GearboxState}
+	* snapshot, without making any on-chain calls.
+	*
+	* @param state - Serialised state obtained from {@link OnchainSDK.state}.
+	* @param options - Hydrate configuration.
+	* @throws {@link SdkAlreadyAttachedError} if already attached.
+	* @throws {@link SdkStateVersionMismatchError} if snapshot version doesn't match.
+	* @throws {@link SdkChainMismatchError} if snapshot network doesn't match.
+	*/
+	hydrate(state, options) {
+		if (this.#attached) throw new require_sdk_core_errors.SdkAlreadyAttachedError();
+		if (state.version !== 2) throw new require_sdk_core_errors.SdkStateVersionMismatchError(2, state.version);
+		if (state.network !== this.networkType) throw new require_sdk_core_errors.SdkChainMismatchError(this.networkType, state.network);
+		const { ignoreMarkets, redstone } = options ?? {};
+		this.logger?.info({ networkType: this.networkType }, "hydrating sdk state");
+		this.#currentBlock = state.currentBlock;
+		this.#timestamp = state.timestamp;
+		this.#priceFeeds = new require_sdk_market_pricefeeds_PriceFeedsRegister.PriceFeedRegister(this, { redstone });
+		this.#addressProvider = require_sdk_core_createAddressProvider.hydrateAddressProvider(this, state.addressProvider);
+		this.logger?.debug(`address provider version: ${this.#addressProvider.version}`);
+		this.#marketRegister = new require_sdk_market_MarketRegister.MarketRegister(this, ignoreMarkets);
+		this.#marketRegister.hydrate(state);
+		this.#rwa = new require_sdk_market_rwa_RWARegistry.RWARegistry(this);
+		this.#rwa.setState(state.rwa);
+		if (state.withdrawals) this.#withdrawalCompressor?.hydrate(state.withdrawals);
+		if (state.tokens) this.tokensMeta.hydrate(state.tokens);
+		for (const [name, plugin] of require_sdk_utils_mappers.TypedObjectUtils.entries(this.plugins)) {
+			const pluginState = state.plugins[name];
+			if (plugin.hydrate && pluginState) {
+				if (!pluginState.loaded) {
+					this.logger?.debug(`skipping hydrating plugin ${name} state: not loaded`);
+					continue;
+				}
+				if (pluginState.version !== plugin.version) throw new require_sdk_plugins_errors.PluginStateVersionError(plugin, pluginState);
+				plugin.hydrate(pluginState);
+			}
+		}
+		this.logger?.info("hydrated sdk state");
+		this.#attached = true;
+	}
+	/**
+	* Gearbox network type the SDK is connected to (e.g. `"Mainnet"`, `"Arbitrum"`).
+	**/
+	get networkType() {
+		return this.client.chain.network;
+	}
+	/**
+	* Whether the SDK has been initialised via {@link attach} or {@link hydrate}.
+	**/
+	get attached() {
+		return this.#attached;
+	}
+	/**
+	* Returns a human-readable snapshot of the entire SDK state.
+	* @param raw - When `true`, include raw numeric values alongside formatted ones.
+	*/
+	stateHuman(raw = true) {
+		return {
+			network: this.networkType,
+			block: Number(this.currentBlock),
+			timestamp: require_sdk_utils_formatter.formatTimestamp(Number(this.timestamp), raw),
+			core: { addressProviderV3: this.addressProvider.stateHuman(raw) },
+			tokens: this.tokensMeta.values(),
+			rwa: this.#rwa.stateHuman(raw),
+			plugins: Object.fromEntries(require_sdk_utils_mappers.TypedObjectUtils.entries(this.plugins).map(([name, plugin]) => [name, plugin.loaded ? plugin.stateHuman?.(raw) : void 0])),
+			...this.marketRegister.stateHuman(raw)
+		};
+	}
+	/** Serialisable snapshot of the current SDK state. */
+	get state() {
+		return {
+			version: 2,
+			network: this.networkType,
+			chainId: this.chainId,
+			currentBlock: this.currentBlock,
+			timestamp: this.timestamp,
+			addressProvider: this.addressProvider.state,
+			...this.marketRegister.state,
+			tokens: this.tokensMeta.state,
+			rwa: this.#rwa.state,
+			withdrawals: this.#withdrawalCompressor?.state,
+			plugins: Object.fromEntries(require_sdk_utils_mappers.TypedObjectUtils.entries(this.plugins).map(([name, plugin]) => [name, plugin.loaded ? {
+				version: plugin.version,
+				loaded: true,
+				...plugin.state
+			} : {
+				version: plugin.version,
+				loaded: false
+			}]))
+		};
+	}
+	/**
+	* Incrementally updates SDK state by replaying on-chain events.
+	*
+	* @param opts - Target block and sync behaviour.
+	* @returns `true` if the sync completed successfully.
+	*/
+	async syncState(opts) {
+		let { blockNumber, timestamp, ignoreUpdateablePrices } = opts ?? {};
+		if (this.priceFeeds.historical && !ignoreUpdateablePrices) this.logger?.warn("syncState is not supported with redstone historicTimestamp");
+		if (!blockNumber || !timestamp) {
+			const block = await this.client.getBlock({ blockTag: "latest" });
+			blockNumber = block.number;
+			timestamp = block.timestamp;
+		}
+		if (blockNumber <= this.currentBlock) return false;
+		if (this.#syncing) {
+			this.logger?.warn(`cannot sync to ${blockNumber}, already syncing at ${this.currentBlock}`);
+			return false;
+		}
+		this.#syncing = true;
+		const prevBlock = this.currentBlock;
+		const prevTimestamp = this.timestamp;
+		let success = false;
+		try {
+			let delta = Math.floor(Date.now() / 1e3) - Number(timestamp);
+			this.logger?.debug(`syncing state to block ${blockNumber} (delta ${delta}s )...`);
+			const watchAddresses = [...Array.from(this.marketRegister.watchAddresses), this.addressProvider.address];
+			const fromBlock = this.currentBlock + 1n;
+			this.logger?.debug(`getting logs from ${watchAddresses.length} addresses in [${fromBlock}:${blockNumber}]`);
+			const logs = await this.client.getLogs({
+				fromBlock,
+				toBlock: blockNumber,
+				address: watchAddresses
+			});
+			for (const log of logs) {
+				const contract = this.getContract(log.address);
+				if (contract) {
+					const event = (0, viem.parseEventLogs)({
+						abi: contract.abi,
+						logs: [log]
+					})[0];
+					contract.processLog(event);
+				}
+			}
+			this.#currentBlock = blockNumber;
+			this.#timestamp = timestamp;
+			if (await this.marketRegister.syncState(ignoreUpdateablePrices, this.#rwa.getSyncMulticalls())) await this.#warmup(true);
+			const pluginsList = require_sdk_utils_mappers.TypedObjectUtils.entries(this.plugins);
+			(await Promise.allSettled(pluginsList.map(([name, plugin]) => {
+				if (plugin.syncState) {
+					this.logger?.debug(`syncing plugin ${name}`);
+					return plugin.syncState();
+				}
+			}))).forEach((r, i) => {
+				const [name, plugin] = pluginsList[i];
+				if (plugin.syncState && r.status === "fulfilled") this.logger?.debug(`synced plugin ${name}`);
+				else if (plugin.syncState && r.status === "rejected") this.logger?.error(r.reason, `failed to sync plugin ${name}`);
+			});
+			delta = Math.floor(Date.now() / 1e3) - Number(timestamp);
+			this.logger?.debug(`synced state to block ${blockNumber} (delta ${delta}s)`);
+			success = true;
+		} catch (e) {
+			this.logger?.error(`sync state to block ${blockNumber} with ts ${timestamp} failed, reverting to old block ${prevBlock} with ts ${prevTimestamp}: ${e}`);
+			this.#currentBlock = prevBlock;
+			this.#timestamp = prevTimestamp;
+		} finally {
+			this.#syncing = false;
+		}
+		return success;
+	}
+	/**
+	* Block number that the SDK state corresponds to.
+	* @throws {@link SdkNotAttachedError} if not attached.
+	*/
+	get currentBlock() {
+		if (this.#currentBlock === void 0) throw new require_sdk_core_errors.SdkNotAttachedError();
+		return this.#currentBlock;
+	}
+	/**
+	* Block timestamp (Unix epoch seconds) corresponding to {@link currentBlock}.
+	* @throws {@link SdkNotAttachedError} if not attached.
+	*/
+	get timestamp() {
+		if (this.#timestamp === void 0) throw new require_sdk_core_errors.SdkNotAttachedError();
+		return this.#timestamp;
+	}
+	/**
+	* Global registry of all price feeds known to the SDK.
+	* @throws {@link SdkNotAttachedError} if not attached.
+	*/
+	get priceFeeds() {
+		if (this.#priceFeeds === void 0) throw new require_sdk_core_errors.SdkNotAttachedError();
+		return this.#priceFeeds;
+	}
+	/** GEAR governance token address, or `undefined` if not listed. */
+	get gear() {
+		try {
+			return this.addressProvider.getAddress(require_sdk_constants_address_provider.AP_GEAR_TOKEN, 0);
+		} catch (e) {
+			this.logger?.warn(e);
+			return;
+		}
+	}
+	/**
+	* The chain's address provider contract.
+	* @throws {@link SdkNotAttachedError} if not attached.
+	*/
+	get addressProvider() {
+		if (this.#addressProvider === void 0) throw new require_sdk_core_errors.SdkNotAttachedError();
+		return this.#addressProvider;
+	}
+	/**
+	* Registry of all loaded markets.
+	* @throws {@link SdkNotAttachedError} if not attached.
+	*/
+	get marketRegister() {
+		if (this.#marketRegister === void 0) throw new require_sdk_core_errors.SdkNotAttachedError();
+		return this.#marketRegister;
+	}
+	/**
+	* RWA register for RWA-wrapped underlying tokens and factories.
+	*
+	* @throws If the SDK has not been attached or hydrated yet.
+	**/
+	get rwa() {
+		if (this.#rwa === void 0) throw new require_sdk_core_errors.SdkNotAttachedError();
+		return this.#rwa;
+	}
+	/**
+	* @internal
+	* Resolves the appropriate router contract for a given credit manager,
+	* credit facade, or explicit version range.
+	*
+	* @param params - Identifies the context: a credit manager address/state,
+	*   a credit facade address/state, or a {@link VersionRange}.
+	* @returns The matching router contract instance.
+	* @throws If the credit facade version is unsupported or no router is
+	*   registered for the resolved version range.
+	**/
+	routerFor(params) {
+		let routerRange;
+		if (Array.isArray(params)) routerRange = params;
+		else {
+			let facadeAddr;
+			if ("creditFacade" in params) facadeAddr = require_sdk_utils_toAddress.toAddress(params.creditFacade);
+			else facadeAddr = this.marketRegister.findCreditManager(require_sdk_utils_toAddress.toAddress(params.creditManager)).creditFacade.address;
+			const facadeV = this.mustGetContract(facadeAddr).version;
+			if (require_sdk_constants_versions.isV310(facadeV)) routerRange = require_sdk_constants_versions.VERSION_RANGE_310;
+			else throw new Error(`Unsupported credit facade version ${facadeV}`);
+		}
+		const routerEntry = this.addressProvider.getLatest(require_sdk_constants_address_provider.AP_ROUTER, routerRange);
+		if (!routerEntry) throw new Error(`router not found in version range ${routerRange}`);
+		const [routerAddr, routerV] = routerEntry;
+		return require_sdk_router_createRouter.createRouter(this, routerAddr, routerV);
+	}
+	/**
+	* Withdrawal compressor contract for the current chain, or `undefined`
+	* when no withdrawal compressor is supported on it.
+	**/
+	get withdrawalCompressor() {
+		return this.#withdrawalCompressor;
+	}
+	/**
+	* `RedemptionLogger` contract for the current chain, or `undefined` when
+	* it is not deployed on it. Created lazily on first access: the contract
+	* is resolved from the address provider, which is only available after
+	* the SDK is attached or hydrated.
+	**/
+	get redemptionLogger() {
+		this.#redemptionLogger ??= require_sdk_accounts_withdrawal_compressor_createRedemptionLogger.createRedemptionLogger(this);
+		return this.#redemptionLogger;
+	}
+};
+//#endregion
+exports.OnchainSDK = OnchainSDK;
+exports.STATE_VERSION = STATE_VERSION;