@gearbox-protocol/sdk 14.0.0-next.4 → 14.0.0-next.5

package/dist/cjs/sdk/MultichainSDK.js

@@ -99,7 +99,8 @@ class MultichainSDK {
    * @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.
+   * @throws {@link SdkMissingChainStateError} if a configured chain has no
+   *   state and `allowMissingChains` is not set.
    */
   hydrate(state, options) {
     if (state.version !== import_OnchainSDK.STATE_VERSION) {
@@ -121,6 +122,9 @@ class MultichainSDK {
     for (const [network, sdk] of this.#chains) {
       const chainState = stateByNetwork.get(network);
       if (!chainState) {
+        if (options?.allowMissingChains) {
+          continue;
+        }
         throw new import_core.SdkMissingChainStateError(network);
       }
       const perChainOpts = options?.perChain?.[network] ?? {};

package/dist/cjs/sdk/OnchainSDK.js

@@ -228,10 +228,18 @@ class OnchainSDK extends import_base.ChainContractsRegister {
     this.logger?.info("hydrated sdk state");
     this.#attached = true;
   }
-  /** Gearbox network type the SDK is connected to (e.g. `"Mainnet"`, `"Arbitrum"`). */
+  /**
+   * 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.

package/dist/esm/sdk/MultichainSDK.js

@@ -85,7 +85,8 @@ class MultichainSDK {
    * @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.
+   * @throws {@link SdkMissingChainStateError} if a configured chain has no
+   *   state and `allowMissingChains` is not set.
    */
   hydrate(state, options) {
     if (state.version !== STATE_VERSION) {
@@ -107,6 +108,9 @@ class MultichainSDK {
     for (const [network, sdk] of this.#chains) {
       const chainState = stateByNetwork.get(network);
       if (!chainState) {
+        if (options?.allowMissingChains) {
+          continue;
+        }
         throw new SdkMissingChainStateError(network);
       }
       const perChainOpts = options?.perChain?.[network] ?? {};

package/dist/esm/sdk/OnchainSDK.js

@@ -223,10 +223,18 @@ class OnchainSDK extends ChainContractsRegister {
     this.logger?.info("hydrated sdk state");
     this.#attached = true;
   }
-  /** Gearbox network type the SDK is connected to (e.g. `"Mainnet"`, `"Arbitrum"`). */
+  /**
+   * 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.

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

@@ -72,6 +72,14 @@ export interface MultichainHydrateOptions {
      * Options for Pyth price-feed updates (shared cache across chains).
      **/
     pyth?: PythOptions;
+    /**
+     * When `true`, chains missing from the serialised state are silently skipped
+     * instead of throwing {@link SdkMissingChainStateError}.
+     *
+     * Useful when a deprecated chain is no longer included in cached state snapshots
+     * but users still need it in legacy mode to exit existing positions.
+     **/
+    allowMissingChains?: boolean;
 }
 /**
  * Options for {@link MultichainSDK.syncState}.
@@ -102,7 +110,8 @@ export declare class MultichainSDK<const Plugins extends PluginsMap = {}> {
      * @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.
+     * @throws {@link SdkMissingChainStateError} if a configured chain has no
+     *   state and `allowMissingChains` is not set.
      */
     hydrate(state: MultichainState<Plugins>, options?: MultichainHydrateOptions): void;
     /**

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

@@ -196,8 +196,14 @@ export declare class OnchainSDK<const Plugins extends PluginsMap = {}> extends C
      * @throws {@link SdkChainMismatchError} if snapshot network doesn't match.
      */
     hydrate(state: GearboxState<Plugins>, options?: HydrateOptions): void;
-    /** Gearbox network type the SDK is connected to (e.g. `"Mainnet"`, `"Arbitrum"`). */
+    /**
+     * Gearbox network type the SDK is connected to (e.g. `"Mainnet"`, `"Arbitrum"`).
+     **/
     get networkType(): NetworkType;
+    /**
+     * Whether the SDK has been initialised via {@link attach} or {@link hydrate}.
+     **/
+    get attached(): boolean;
     /**
      * Returns a human-readable snapshot of the entire SDK state.
      * @param raw - When `true`, include raw numeric values alongside formatted ones.

package/package.json

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