@gearbox-protocol/sdk 13.6.0 → 14.0.0-next.2

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

@@ -17,10 +17,12 @@ var core_exports = {};
 module.exports = __toCommonJS(core_exports);
 __reExport(core_exports, require("./AddressProviderV310Contract.js"), module.exports);
 __reExport(core_exports, require("./createAddressProvider.js"), module.exports);
+__reExport(core_exports, require("./errors.js"), module.exports);
 __reExport(core_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./AddressProviderV310Contract.js"),
   ...require("./createAddressProvider.js"),
+  ...require("./errors.js"),
   ...require("./types.js")
 });

package/dist/cjs/sdk/index.js

@@ -20,8 +20,9 @@ __reExport(sdk_exports, require("./base/index.js"), module.exports);
 __reExport(sdk_exports, require("./chain/index.js"), module.exports);
 __reExport(sdk_exports, require("./constants/index.js"), module.exports);
 __reExport(sdk_exports, require("./core/index.js"), module.exports);
-__reExport(sdk_exports, require("./GearboxSDK.js"), module.exports);
+__reExport(sdk_exports, require("./MultichainSDK.js"), module.exports);
 __reExport(sdk_exports, require("./market/index.js"), module.exports);
+__reExport(sdk_exports, require("./OnchainSDK.js"), module.exports);
 __reExport(sdk_exports, require("./options.js"), module.exports);
 __reExport(sdk_exports, require("./plugins/index.js"), module.exports);
 __reExport(sdk_exports, require("./pools/index.js"), module.exports);
@@ -36,8 +37,9 @@ __reExport(sdk_exports, require("./utils/viem/index.js"), module.exports);
   ...require("./chain/index.js"),
   ...require("./constants/index.js"),
   ...require("./core/index.js"),
-  ...require("./GearboxSDK.js"),
+  ...require("./MultichainSDK.js"),
   ...require("./market/index.js"),
+  ...require("./OnchainSDK.js"),
   ...require("./options.js"),
   ...require("./plugins/index.js"),
   ...require("./pools/index.js"),

package/dist/cjs/sdk/market/pricefeeds/PriceFeedsRegister.js

@@ -344,6 +344,13 @@ class PriceFeedRegister extends import_base.SDKConstruct {
   get latestUpdate() {
     return this.#latestUpdate;
   }
+  /**
+   * @internal
+   * Returns true if any of the updaters are in historical mode
+   */
+  get historical() {
+    return this.#updaters.some((u) => u.historical);
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/sdk/market/pricefeeds/updates/PythUpdater.js

@@ -54,6 +54,9 @@ const PythOptions = import_v4.z.object({
 });
 class PythUpdater extends import_base.SDKConstruct {
   #cache;
+  /**
+   * Fixed pyth historic timestamp in seconds
+   */
   #historicalTimestamp;
   #apiProxy;
   #failOnMissingFeeds;
@@ -68,10 +71,7 @@ class PythUpdater extends import_base.SDKConstruct {
         `using historical timestamp ${this.#historicalTimestamp}`
       );
     }
-    this.#cache = new import_PriceUpdatesCache.PriceUpdatesCache({
-      // currently staleness period is 240 seconds on all networks, add some buffer
-      // this period of 4 minutes is selected based on time that is required for user to sign transaction with wallet
-      // so it's unlikely to decrease
+    this.#cache = opts.cache ?? new import_PriceUpdatesCache.PriceUpdatesCache({
       ttl: cacheTTL ?? 225 * 1e3,
       historical: !!historicTimestamp
     });
@@ -120,6 +120,9 @@ class PythUpdater extends import_base.SDKConstruct {
     );
     return results;
   }
+  get historical() {
+    return !!this.#historicalTimestamp;
+  }
   /**
    * Gets pyth payloads
    * @param dataFeedsIds

package/dist/cjs/sdk/market/pricefeeds/updates/RedstoneUpdater.js

@@ -76,10 +76,7 @@ class RedstoneUpdater extends import_base.SDKConstruct {
         `using historical timestamp ${this.#historicalTimestampMs}`
       );
     }
-    this.#cache = new import_PriceUpdatesCache.PriceUpdatesCache({
-      // currently staleness period is 240 seconds on all networks, add some buffer
-      // this period of 4 minutes is selected based on time that is required for user to sign transaction with wallet
-      // so it's unlikely to decrease
+    this.#cache = opts.cache ?? new import_PriceUpdatesCache.PriceUpdatesCache({
       ttl: opts.cacheTTL ?? 225 * 1e3,
       historical: !!ts
     });
@@ -150,6 +147,9 @@ class RedstoneUpdater extends import_base.SDKConstruct {
     );
     return results;
   }
+  get historical() {
+    return !!this.#historicalTimestampMs;
+  }
   /**
    * Gets payloads, retries once if it has expired while inflight
    * @param dataServiceId

package/dist/cjs/sdk/market/pricefeeds/updates/index.js

@@ -19,6 +19,7 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var updates_exports = {};
 __export(updates_exports, {
+  PriceUpdatesCache: () => import_PriceUpdatesCache.PriceUpdatesCache,
   PythOptions: () => import_PythUpdater.PythOptions,
   PythUpdater: () => import_PythUpdater.PythUpdater,
   RedstoneOptions: () => import_RedstoneUpdater.RedstoneOptions,
@@ -27,10 +28,12 @@ __export(updates_exports, {
 module.exports = __toCommonJS(updates_exports);
 __reExport(updates_exports, require("./fetchPythPayloads.js"), module.exports);
 __reExport(updates_exports, require("./fetchRedstonePayloads.js"), module.exports);
+var import_PriceUpdatesCache = require("./PriceUpdatesCache.js");
 var import_PythUpdater = require("./PythUpdater.js");
 var import_RedstoneUpdater = require("./RedstoneUpdater.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  PriceUpdatesCache,
   PythOptions,
   PythUpdater,
   RedstoneOptions,

package/dist/cjs/sdk/options.js

@@ -18,59 +18,20 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var options_exports = {};
 __export(options_exports, {
-  SDKOptions: () => SDKOptions
+  AttachOptionsSchema: () => AttachOptionsSchema,
+  OnchainSDKOptionsSchema: () => OnchainSDKOptionsSchema
 });
 module.exports = __toCommonJS(options_exports);
 var import_v4 = require("zod/v4");
 var import_updates = require("./market/pricefeeds/updates/index.js");
 var import_utils = require("./utils/index.js");
-const SDKOptions = import_v4.z.object({
-  /**
-   * Override address of the Gearbox AddressProvider contract.
-   * If not set, uses default universal address provider address {@link ADDRESS_PROVIDER_V310}
-   **/
-  addressProvider: (0, import_utils.ZodAddress)().optional(),
-  /**
-   * Addresses of market configurator contracts to load.
-   * If not set, all default market configurators for the chain are loaded
-   * (from {@link GearboxChain.defaultMarketConfigurators})
-   **/
-  marketConfigurators: import_v4.z.array((0, import_utils.ZodAddress)()).optional(),
-  /**
-   * Pin SDK to a specific block number during attach.
-   * When set, all on-chain reads use this block instead of `latest`.
-   **/
-  blockNumber: import_v4.z.union([import_v4.z.bigint().nonnegative(), import_v4.z.number().int().nonnegative()]).optional(),
-  /**
-   * Skip fetching updatable price feeds on attach and sync.
-   * Speeds up initialisation when prices are not needed.
-   **/
-  ignoreUpdateablePrices: import_v4.z.boolean().optional(),
-  /**
-   * Pool addresses whose markets should be skipped during attach/hydrate/sync.
-   **/
-  ignoreMarkets: import_v4.z.array((0, import_utils.ZodAddress)()).optional(),
-  /**
-   * When `true`, throw on unrecognised contract types instead of falling
-   * back to a generic contract wrapper.
-   **/
+const OnchainSDKOptionsSchema = import_v4.z.object({
+  /** When `true`, throw on unrecognised contract types. */
   strictContractTypes: import_v4.z.boolean().optional(),
-  /**
-   * Plugins that extend SDK functionality.
-   **/
+  /** Plugins that extend SDK functionality. */
   plugins: import_v4.z.record(import_v4.z.string(), import_v4.z.any()).optional(),
-  /**
-   * Custom logger implementation.
-   **/
+  /** Custom logger implementation. */
   logger: import_v4.z.any(),
-  /**
-   * Options for Redstone price-feed updates.
-   **/
-  redstone: import_updates.RedstoneOptions.optional(),
-  /**
-   * Options for Pyth price-feed updates.
-   **/
-  pyth: import_updates.PythOptions.optional(),
   /**
    * Explicit gas limit for read-only `eth_call` requests.
    * `null` disables the gas limit entirely; `undefined` uses the SDK default.
@@ -78,7 +39,24 @@ const SDKOptions = import_v4.z.object({
    **/
   gasLimit: import_v4.z.bigint().nonnegative().nullable().optional()
 });
+const AttachOptionsSchema = import_v4.z.object({
+  /** Override address of the Gearbox AddressProvider contract. */
+  addressProvider: (0, import_utils.ZodAddress)().optional(),
+  /** Addresses of market configurator contracts to load. */
+  marketConfigurators: import_v4.z.array((0, import_utils.ZodAddress)()).optional(),
+  /** Pin SDK to a specific block number during attach. */
+  blockNumber: import_v4.z.union([import_v4.z.bigint().nonnegative(), import_v4.z.number().int().nonnegative()]).optional(),
+  /** Skip fetching updatable price feeds on attach and sync. */
+  ignoreUpdateablePrices: import_v4.z.boolean().optional(),
+  /** Pool addresses whose markets should be skipped. */
+  ignoreMarkets: import_v4.z.array((0, import_utils.ZodAddress)()).optional(),
+  /** Options for Redstone price-feed updates. */
+  redstone: import_updates.RedstoneOptions.optional(),
+  /** Options for Pyth price-feed updates. */
+  pyth: import_updates.PythOptions.optional()
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  SDKOptions
+  AttachOptionsSchema,
+  OnchainSDKOptionsSchema
 });

package/dist/cjs/sdk/plugins/BasePlugin.js

@@ -21,6 +21,7 @@ __export(BasePlugin_exports, {
   BasePlugin: () => BasePlugin
 });
 module.exports = __toCommonJS(BasePlugin_exports);
+var import_core = require("../core/index.js");
 class BasePlugin {
   #sdk;
   logger;
@@ -43,19 +44,25 @@ class BasePlugin {
    **/
   get sdk() {
     if (!this.#sdk) {
-      throw new Error("SDK is not attached");
+      throw new import_core.SdkNotAttachedError();
     }
     return this.#sdk;
   }
+  /**
+   * @internal
+   * Set the SDK instance. Called by the SDK constructor.
+   * @param sdk - The SDK instance.
+   * @throws Error if the SDK is already attached.
+   */
   set sdk(sdk) {
     if (this.#sdk) {
-      throw new Error("SDK is already attached");
+      throw new import_core.SdkAlreadyAttachedError();
     }
     this.#sdk = sdk;
     this.logger = sdk.logger?.child?.({ name: this.constructor.name }) ?? sdk.logger;
   }
   /**
-   * {@inheritDoc IGearboxSDKPlugin.attach}
+   * {@inheritDoc IOnchainSDKPlugin.attach}
    **/
   async attach() {
     if (this.loadOnAttach) {
@@ -63,7 +70,7 @@ class BasePlugin {
     }
   }
   /**
-   * {@inheritDoc IGearboxSDKPlugin.syncState}
+   * {@inheritDoc IOnchainSDKPlugin.syncState}
    **/
   async syncState() {
     await this.load(false);

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

@@ -21,6 +21,7 @@ __reExport(viem_exports, require("./getLogsSafe.js"), module.exports);
 __reExport(viem_exports, require("./sendRawTx.js"), module.exports);
 __reExport(viem_exports, require("./simulateMulticall.js"), module.exports);
 __reExport(viem_exports, require("./simulateWithPriceUpdates.js"), module.exports);
+__reExport(viem_exports, require("./watchBlocksAsync.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./cast.js"),
@@ -28,5 +29,6 @@ __reExport(viem_exports, require("./simulateWithPriceUpdates.js"), module.export
   ...require("./getLogsSafe.js"),
   ...require("./sendRawTx.js"),
   ...require("./simulateMulticall.js"),
-  ...require("./simulateWithPriceUpdates.js")
+  ...require("./simulateWithPriceUpdates.js"),
+  ...require("./watchBlocksAsync.js")
 });

package/dist/cjs/sdk/utils/viem/watchBlocksAsync.js

@@ -0,0 +1,76 @@
+"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 watchBlocksAsync_exports = {};
+__export(watchBlocksAsync_exports, {
+  watchBlocksAsync: () => watchBlocksAsync
+});
+module.exports = __toCommonJS(watchBlocksAsync_exports);
+var import_actions = require("viem/actions");
+var import_utils = require("viem/utils");
+function watchBlocksAsync(client, parameters) {
+  const {
+    onBlock,
+    onError,
+    onDrop,
+    pollingInterval = client.pollingInterval
+  } = parameters;
+  let active = true;
+  let busy = false;
+  let prevBlock;
+  const poll = async () => {
+    if (!active) return;
+    let block;
+    try {
+      block = await (0, import_utils.getAction)(
+        client,
+        import_actions.getBlock,
+        "getBlock"
+      )({});
+    } catch (err) {
+      onError?.(err);
+      return;
+    }
+    if (!active) return;
+    if (block.number !== null && prevBlock?.number != null && block.number <= prevBlock.number) {
+      return;
+    }
+    if (busy) {
+      onDrop?.(block);
+      return;
+    }
+    busy = true;
+    try {
+      await onBlock(block, prevBlock);
+      prevBlock = block;
+    } catch (err) {
+      onError?.(err);
+    } finally {
+      busy = false;
+    }
+  };
+  const timer = setInterval(poll, pollingInterval);
+  return () => {
+    active = false;
+    clearInterval(timer);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  watchBlocksAsync
+});

package/dist/esm/dev/index.js

@@ -1,5 +1,4 @@
 export * from "./AccountOpener.js";
-export * from "./CachedStateSubscriber.js";
 export * from "./calcLiquidatableLTs.js";
 export * from "./claimFromFaucet.js";
 export * from "./create2.js";

package/dist/esm/history/errors.js

@@ -33,6 +33,8 @@ class AdapterTraceAlignmentError extends Error {
     this.actual = actual;
     this.name = "AdapterTracesAlignmentError";
   }
+  expected;
+  actual;
 }
 class UnexpectedFacadeEventOrderError extends Error {
   constructor(e) {

package/dist/esm/permissionless/utils/price-update/get-price-feeds.js

@@ -1,6 +1,6 @@
 import {
   AP_PRICE_FEED_COMPRESSOR,
-  GearboxSDK
+  OnchainSDK
 } from "../../../sdk/index.js";
 import { AddressProviderContract } from "../../bindings/index.js";
 import { Addresses } from "../../deployment/addresses.js";
@@ -47,11 +47,17 @@ async function getCallsTouchedUpdatablePriceFeeds({
     AP_PRICE_FEED_COMPRESSOR,
     310n
   );
-  const sdk = await GearboxSDK.attach({
-    client,
-    marketConfigurators: [],
-    gasLimit
-  });
+  const gearboxClient = client;
+  const chain = gearboxClient.chain;
+  if (!chain) {
+    throw new Error("Chain not defined on client");
+  }
+  const sdk = new OnchainSDK(
+    chain.network,
+    { client: gearboxClient },
+    { gasLimit }
+  );
+  await sdk.attach({ marketConfigurators: [] });
   const touchedFeeds = parsedCalls.flatMap(
     (call) => getCallTouchedPriceFeeds(call)
   );

package/dist/esm/permissionless/utils/price-update/get-price-update-tx.js

@@ -3,8 +3,8 @@ import {
 } from "viem";
 import {
   createRawTx,
-  GearboxSDK,
-  getRawPriceUpdates
+  getRawPriceUpdates,
+  OnchainSDK
 } from "../../../sdk/index.js";
 import { PriceFeedStoreContract } from "../../bindings/index.js";
 import { Addresses } from "../../deployment/addresses.js";
@@ -18,11 +18,17 @@ async function getPriceUpdateTx({
     Addresses.PRICE_FEED_STORE,
     client
   );
-  const sdk = await GearboxSDK.attach({
-    client,
-    marketConfigurators: [],
-    gasLimit
-  });
+  const gearboxClient = client;
+  const chain = gearboxClient.chain;
+  if (!chain) {
+    throw new Error("Chain not defined on client");
+  }
+  const sdk = new OnchainSDK(
+    chain.network,
+    { client: gearboxClient },
+    { gasLimit }
+  );
+  await sdk.attach({ marketConfigurators: [] });
   const updateTxs = await sdk.priceFeeds.generateExternalPriceFeedsUpdateTxs(priceFeeds);
   if (useMulticall3) {
     const multicallCalls = updateTxs.txs.map((tx) => ({

package/dist/esm/permissionless/utils/price-update/get-prices.js

@@ -1,7 +1,7 @@
 import {
   multicall3Abi
 } from "viem";
-import { GearboxSDK, simulateMulticall } from "../../../sdk/index.js";
+import { OnchainSDK, simulateMulticall } from "../../../sdk/index.js";
 const latestRoundDataAbi = [
   {
     inputs: [],
@@ -80,12 +80,18 @@ async function getPrices({
   if (!client.chain) {
     throw new Error("Chain not defined");
   }
-  const sdk = await GearboxSDK.attach({
-    client,
-    gasLimit,
-    marketConfigurators: [],
-    redstone: {},
-    pyth: {}
+  const gearboxClient = client;
+  const chain = gearboxClient.chain;
+  if (!chain) {
+    throw new Error("Chain not defined on client");
+  }
+  const sdk = new OnchainSDK(
+    chain.network,
+    { client: gearboxClient },
+    { gasLimit }
+  );
+  await sdk.attach({
+    marketConfigurators: []
   });
   const chunks = [];
   for (let i = 0; i < priceFeeds.length; i += chunkSize) {

package/dist/esm/sdk/MultichainSDK.js

@@ -0,0 +1,208 @@
+import { getNetworkType } from "./chain/chains.js";
+import {
+  SdkMissingChainStateError,
+  SdkStateVersionMismatchError,
+  SdkSyncFailedError
+} from "./core/index.js";
+import {
+  PriceUpdatesCache
+} from "./market/pricefeeds/updates/index.js";
+import {
+  OnchainSDK,
+  STATE_VERSION
+} from "./OnchainSDK.js";
+class MultichainSDK {
+  #chains;
+  #redstoneCache;
+  #pythCache;
+  constructor(options) {
+    this.#chains = /* @__PURE__ */ new Map();
+    for (const [network, chainConfig] of Object.entries(options.chains)) {
+      const { gasLimit, ...clientOptions } = chainConfig;
+      let plugins;
+      if (options.plugins) {
+        plugins = Object.fromEntries(
+          Object.entries(options.plugins).map(([name, factory]) => [
+            name,
+            factory()
+          ])
+        );
+      }
+      const sdkOptions = {
+        logger: options.logger?.child?.({ network }),
+        strictContractTypes: options.strictContractTypes,
+        gasLimit: gasLimit ?? options.gasLimit,
+        plugins
+      };
+      const sdk = new OnchainSDK(
+        network,
+        clientOptions,
+        sdkOptions
+      );
+      this.#chains.set(network, sdk);
+    }
+  }
+  /**
+   * Attach all configured chains in parallel.
+   *
+   * @param options - Shared and per-chain attach options.
+   */
+  async attach(options) {
+    if (options?.redstone) {
+      this.#redstoneCache = new PriceUpdatesCache({
+        ttl: options.redstone.cacheTTL ?? 225e3,
+        historical: !!options.redstone.historicTimestamp
+      });
+    }
+    if (options?.pyth) {
+      this.#pythCache = new PriceUpdatesCache({
+        ttl: options.pyth.cacheTTL ?? 225e3,
+        historical: !!options.pyth.historicTimestamp
+      });
+    }
+    await Promise.all(
+      [...this.#chains.entries()].map(([network, sdk]) => {
+        const perChainOpts = options?.perChain?.[network] ?? {};
+        return sdk.attach({
+          ...perChainOpts,
+          redstone: {
+            ...options?.redstone,
+            cache: this.#redstoneCache,
+            ...perChainOpts.redstone
+          },
+          pyth: {
+            ...options?.pyth,
+            cache: this.#pythCache,
+            ...perChainOpts.pyth
+          }
+        });
+      })
+    );
+  }
+  /**
+   * Hydrate all configured chains from serialised state.
+   *
+   * @param state - Multichain serialised state.
+   * @param options - Shared and per-chain hydrate options.
+   * @throws {@link SdkStateVersionMismatchError} if version doesn't match.
+   * @throws {@link SdkMissingChainStateError} if a configured chain has no state.
+   */
+  hydrate(state, options) {
+    if (state.version !== STATE_VERSION) {
+      throw new SdkStateVersionMismatchError(STATE_VERSION, state.version);
+    }
+    if (options?.redstone) {
+      this.#redstoneCache = new PriceUpdatesCache({
+        ttl: options.redstone.cacheTTL ?? 225e3,
+        historical: !!options.redstone.historicTimestamp
+      });
+    }
+    if (options?.pyth) {
+      this.#pythCache = new PriceUpdatesCache({
+        ttl: options.pyth.cacheTTL ?? 225e3,
+        historical: !!options.pyth.historicTimestamp
+      });
+    }
+    const stateByNetwork = new Map(state.chains.map((cs) => [cs.network, cs]));
+    for (const [network, sdk] of this.#chains) {
+      const chainState = stateByNetwork.get(network);
+      if (!chainState) {
+        throw new SdkMissingChainStateError(network);
+      }
+      const perChainOpts = options?.perChain?.[network] ?? {};
+      sdk.hydrate(chainState, {
+        ...perChainOpts,
+        redstone: {
+          ...options?.redstone,
+          cache: this.#redstoneCache,
+          ...perChainOpts.redstone
+        },
+        pyth: {
+          ...options?.pyth,
+          cache: this.#pythCache,
+          ...perChainOpts.pyth
+        }
+      });
+    }
+  }
+  /**
+   * Returns the {@link OnchainSDK} for a given network or chain ID.
+   *
+   * @param networkOrChainId - Network type string or numeric chain ID.
+   * @throws If the network/chain is not configured.
+   */
+  chain(networkOrChainId) {
+    let network;
+    if (typeof networkOrChainId === "number") {
+      network = getNetworkType(networkOrChainId);
+    } else {
+      network = networkOrChainId;
+    }
+    const sdk = this.#chains.get(network);
+    if (!sdk) {
+      throw new Error(
+        `Chain ${String(networkOrChainId)} is not configured in this MultichainSDK`
+      );
+    }
+    return sdk;
+  }
+  /**
+   * Read-only map of all configured chains.
+   **/
+  get chains() {
+    return this.#chains;
+  }
+  /**
+   * Sync state for all chains in parallel.
+   *
+   * @param opts - Sync options.
+   * @throws {@link SdkSyncFailedError} if any chain fails.
+   */
+  async syncState(opts) {
+    const errors = {};
+    const results = await Promise.allSettled(
+      [...this.#chains.entries()].map(async ([_network, sdk]) => {
+        const block = await sdk.client.getBlock({ blockTag: "latest" });
+        const synced = await sdk.syncState({
+          blockNumber: block.number,
+          timestamp: block.timestamp,
+          ignoreUpdateablePrices: opts?.ignoreUpdateablePrices
+        });
+        if (!synced) {
+          return;
+        }
+      })
+    );
+    for (const [i, result] of results.entries()) {
+      if (result.status === "rejected") {
+        const network = [...this.#chains.keys()][i];
+        errors[network] = result.reason;
+      }
+    }
+    if (Object.keys(errors).length > 0) {
+      throw new SdkSyncFailedError(errors);
+    }
+  }
+  /**
+   * Serialisable snapshot of all chains' state.
+   **/
+  get state() {
+    return {
+      version: STATE_VERSION,
+      chains: [...this.#chains.values()].map((sdk) => sdk.state)
+    };
+  }
+  /**
+   * Human-readable snapshot of all chains' state.
+   * @param raw - When `true`, include raw numeric values.
+   */
+  stateHuman(raw) {
+    return {
+      version: STATE_VERSION,
+      chains: [...this.#chains.values()].map((sdk) => sdk.stateHuman(raw))
+    };
+  }
+}
+export {
+  MultichainSDK
+};