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

package/dist/types/{sdk → src/sdk}/market/pool/createPool.d.ts

@@ -1,4 +1,4 @@
 import type { PoolState } from "../../base/index.js";
-import type { GearboxSDK } from "../../GearboxSDK.js";
+import type { OnchainSDK } from "../../OnchainSDK.js";
 import type { PoolContract } from "./types.js";
-export default function createPool(sdk: GearboxSDK, data: PoolState): PoolContract;
+export default function createPool(sdk: OnchainSDK, data: PoolState): PoolContract;

package/dist/types/{sdk → src/sdk}/market/pool/createPoolQuotaKeeper.d.ts

@@ -1,4 +1,4 @@
 import type { PoolState, QuotaKeeperState } from "../../base/index.js";
-import type { GearboxSDK } from "../../GearboxSDK.js";
+import type { OnchainSDK } from "../../OnchainSDK.js";
 import type { PoolQuotaKeeperContract } from "./types.js";
-export default function createPoolQuotaKeeper(sdk: GearboxSDK, pool: PoolState, pqk: QuotaKeeperState): PoolQuotaKeeperContract;
+export default function createPoolQuotaKeeper(sdk: OnchainSDK, pool: PoolState, pqk: QuotaKeeperState): PoolQuotaKeeperContract;

package/dist/types/{sdk → src/sdk}/market/pool/createRateKeeper.d.ts

@@ -1,4 +1,4 @@
 import type { PoolState, RateKeeperState } from "../../base/index.js";
-import type { GearboxSDK } from "../../GearboxSDK.js";
+import type { OnchainSDK } from "../../OnchainSDK.js";
 import type { IRateKeeperContract } from "./types.js";
-export default function createRateKeeper(sdk: GearboxSDK, pool: PoolState, data: RateKeeperState): IRateKeeperContract;
+export default function createRateKeeper(sdk: OnchainSDK, pool: PoolState, data: RateKeeperState): IRateKeeperContract;

package/dist/types/{sdk → src/sdk}/market/pricefeeds/PriceFeedsRegister.d.ts

@@ -1,7 +1,7 @@
 import { type Address, type BlockTag } from "viem";
 import type { PriceFeedTreeNode } from "../../base/index.js";
 import { SDKConstruct } from "../../base/index.js";
-import type { GearboxSDK } from "../../GearboxSDK.js";
+import type { OnchainSDK } from "../../OnchainSDK.js";
 import type { RawTx } from "../../types/index.js";
 import type { IHooks } from "../../utils/internal/index.js";
 import { type PartialPriceFeedTreeNode } from "./AbstractPriceFeed.js";
@@ -50,7 +50,7 @@ export interface LatestUpdate {
  **/
 export declare class PriceFeedRegister extends SDKConstruct implements IHooks<PriceFeedRegisterHooks> {
     #private;
-    constructor(sdk: GearboxSDK, opts?: PriceFeedRegisterOptions);
+    constructor(sdk: OnchainSDK, opts?: PriceFeedRegisterOptions);
     /**
      * @internal
      * Registers a callback for price-feed register lifecycle events.
@@ -168,4 +168,9 @@ export declare class PriceFeedRegister extends SDKConstruct implements IHooks<Pr
      * `undefined` if no updates have been generated yet.
      **/
     get latestUpdate(): LatestUpdate | undefined;
+    /**
+     * @internal
+     * Returns true if any of the updaters are in historical mode
+     */
+    get historical(): boolean;
 }

package/dist/types/{sdk → src/sdk}/market/pricefeeds/updates/PythUpdater.d.ts

@@ -1,7 +1,8 @@
 import { z } from "zod/v4";
 import { SDKConstruct } from "../../../base/index.js";
-import type { GearboxSDK } from "../../../GearboxSDK.js";
+import type { OnchainSDK } from "../../../OnchainSDK.js";
 import type { IPriceFeedContract } from "../types.js";
+import { PriceUpdatesCache } from "./PriceUpdatesCache.js";
 import { PriceUpdateTx } from "./PriceUpdateTx.js";
 import type { IPriceUpdater, IPriceUpdateTask } from "./types.js";
 export type PythUpdateTask = IPriceUpdateTask;
@@ -14,13 +15,17 @@ export declare const PythOptions: z.ZodObject<{
     cacheTTL: z.ZodOptional<z.ZodNumber>;
     failOnMissingFeeds: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
-export type PythOptions = z.infer<typeof PythOptions>;
+export type PythOptions = z.infer<typeof PythOptions> & {
+    /** Shared cache injected by {@link MultichainSDK} to avoid redundant fetches. */
+    cache?: PriceUpdatesCache;
+};
 /**
  * Class to update multiple pyth price feeds at once
  */
 export declare class PythUpdater extends SDKConstruct implements IPriceUpdater<PythUpdateTask> {
     #private;
-    constructor(sdk: GearboxSDK, opts?: PythOptions);
+    constructor(sdk: OnchainSDK, opts?: PythOptions);
     getUpdateTxs(feeds: IPriceFeedContract[]): Promise<PythUpdateTx[]>;
+    get historical(): boolean;
 }
 export {};

package/dist/types/{sdk → src/sdk}/market/pricefeeds/updates/RedstoneUpdater.d.ts

@@ -1,7 +1,8 @@
 import { z } from "zod/v4";
 import { SDKConstruct } from "../../../base/index.js";
-import type { GearboxSDK } from "../../../GearboxSDK.js";
+import type { OnchainSDK } from "../../../OnchainSDK.js";
 import type { IPriceFeedContract } from "../types.js";
+import { PriceUpdatesCache } from "./PriceUpdatesCache.js";
 import { PriceUpdateTx } from "./PriceUpdateTx.js";
 import type { IPriceUpdater, IPriceUpdateTask } from "./types.js";
 interface RedstoneUpdateTask extends IPriceUpdateTask {
@@ -17,13 +18,17 @@ export declare const RedstoneOptions: z.ZodObject<{
     failOnMissingFeeds: z.ZodOptional<z.ZodBoolean>;
     enableLogging: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
-export type RedstoneOptions = z.infer<typeof RedstoneOptions>;
+export type RedstoneOptions = z.infer<typeof RedstoneOptions> & {
+    /** Shared cache injected by {@link MultichainSDK} to avoid redundant fetches. */
+    cache?: PriceUpdatesCache;
+};
 /**
  * Class to update multiple redstone price feeds at once
  */
 export declare class RedstoneUpdater extends SDKConstruct implements IPriceUpdater<RedstoneUpdateTask> {
     #private;
-    constructor(sdk: GearboxSDK, opts?: RedstoneOptions);
+    constructor(sdk: OnchainSDK, opts?: RedstoneOptions);
     getUpdateTxs(feeds: IPriceFeedContract[]): Promise<RedstoneUpdateTx[]>;
+    get historical(): boolean;
 }
 export {};

package/dist/types/{sdk → src/sdk}/market/pricefeeds/updates/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./fetchPythPayloads.js";
 export * from "./fetchRedstonePayloads.js";
+export { PriceUpdatesCache } from "./PriceUpdatesCache.js";
 export { PythOptions, PythUpdater } from "./PythUpdater.js";
 export { RedstoneOptions, RedstoneUpdater } from "./RedstoneUpdater.js";
 export type * from "./types.js";

package/dist/types/{sdk → src/sdk}/market/pricefeeds/updates/types.d.ts

@@ -9,6 +9,10 @@ export interface IPriceUpdateTask {
 }
 export interface IPriceUpdater<T extends IPriceUpdateTask = IPriceUpdateTask> {
     getUpdateTxs: (feeds: IPriceFeedContract[]) => Promise<IPriceUpdateTx<T>[]>;
+    /**
+     * Returns true if the updater is in historical mode
+     */
+    historical: boolean;
 }
 export interface TimestampedCalldata {
     dataFeedId: string;

package/dist/types/{sdk → src/sdk}/options.d.ts

@@ -2,17 +2,23 @@ import { z } from "zod/v4";
 import type { PluginsMap } from "./plugins/index.js";
 import type { ILogger } from "./types/index.js";
 /**
- * Zod schema for validating {@link SDKOptions} at runtime.
+ * Zod schema for validating {@link OnchainSDKOptions} at runtime.
  **/
-export declare const SDKOptions: z.ZodObject<{
+export declare const OnchainSDKOptionsSchema: z.ZodObject<{
+    strictContractTypes: z.ZodOptional<z.ZodBoolean>;
+    plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    logger: z.ZodAny;
+    gasLimit: z.ZodOptional<z.ZodNullable<z.ZodBigInt>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for validating {@link AttachOptions} at runtime.
+ **/
+export declare const AttachOptionsSchema: z.ZodObject<{
     addressProvider: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
     marketConfigurators: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
     blockNumber: z.ZodOptional<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber]>>;
     ignoreUpdateablePrices: z.ZodOptional<z.ZodBoolean>;
     ignoreMarkets: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>>;
-    strictContractTypes: z.ZodOptional<z.ZodBoolean>;
-    plugins: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    logger: z.ZodAny;
     redstone: z.ZodOptional<z.ZodObject<{
         historicTimestamp: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<true>]>>;
         gateways: z.ZodOptional<z.ZodArray<z.ZodURL>>;
@@ -26,21 +32,15 @@ export declare const SDKOptions: z.ZodObject<{
         cacheTTL: z.ZodOptional<z.ZodNumber>;
         failOnMissingFeeds: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
-    gasLimit: z.ZodOptional<z.ZodNullable<z.ZodBigInt>>;
 }, z.core.$strip>;
 /**
- * Configuration options accepted by {@link GearboxSDK.attach} and related
- * factory methods.
+ * SDK constructor options type.
  *
  * @typeParam Plugins - Map of plugin names to plugin instances.
  **/
-export type SDKOptions<Plugins extends PluginsMap> = Omit<z.infer<typeof SDKOptions>, "logger" | "plugins"> & {
-    /**
-     * Plugins that extend SDK functionality.
-     **/
+export type SDKOptions<Plugins extends PluginsMap> = Omit<z.infer<typeof OnchainSDKOptionsSchema>, "logger" | "plugins"> & {
+    /** Plugins that extend SDK functionality. */
     plugins?: Plugins;
-    /**
-     * Custom logger implementation.
-     **/
+    /** Custom logger implementation. */
     logger?: ILogger;
 };

package/dist/types/{sdk → src/sdk}/plugins/BasePlugin.d.ts

@@ -1,9 +1,9 @@
 import type { Address, PublicClient } from "viem";
 import type { NetworkType } from "../chain/index.js";
-import type { GearboxSDK } from "../GearboxSDK.js";
 import type { ILogger } from "../index.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 /**
- * Convenience base class for {@link IGearboxSDKPlugin} implementations.
+ * Convenience base class for {@link IOnchainSDKPlugin} implementations.
  *
  * Handles the SDK attachment lifecycle, logger setup, and provides
  * common accessors (`network`, `client`). Subclasses only need to
@@ -29,14 +29,20 @@ export declare abstract class BasePlugin<TState extends Record<keyof TState, unk
      * Reference to the parent SDK instance.
      * @throws Error if the SDK has not been attached yet.
      **/
-    get sdk(): GearboxSDK<any>;
-    set sdk(sdk: GearboxSDK<any>);
+    get sdk(): OnchainSDK<any>;
     /**
-     * {@inheritDoc IGearboxSDKPlugin.attach}
+     * @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: OnchainSDK<any>);
+    /**
+     * {@inheritDoc IOnchainSDKPlugin.attach}
      **/
     attach(): Promise<void>;
     /**
-     * {@inheritDoc IGearboxSDKPlugin.syncState}
+     * {@inheritDoc IOnchainSDKPlugin.syncState}
      **/
     syncState(): Promise<void>;
     /**

package/dist/types/src/sdk/plugins/errors.d.ts

@@ -0,0 +1,4 @@
+import type { IOnchainSDKPlugin, IPluginState } from "./types.js";
+export declare class PluginStateVersionError<TState extends IPluginState> extends Error {
+    constructor(plugin: IOnchainSDKPlugin<TState>, state: TState);
+}

package/dist/types/{sdk → src/sdk}/plugins/types.d.ts

@@ -1,5 +1,5 @@
 import type { BaseState, IBaseContract } from "../base/index.js";
-import type { GearboxSDK } from "../GearboxSDK.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 /**
  * Serialisable snapshot of a plugin's state, used for hydration.
  *
@@ -22,7 +22,7 @@ export type IPluginState<State extends Record<keyof State, unknown> = {}> = {
  * @typeParam TState  - Plugin-specific state shape.
  * @typeParam TPlugin - Concrete plugin type produced by the constructor.
  **/
-export type IGearboxSDKPluginConstructor<TState extends Record<keyof TState, unknown>, TPlugin extends IGearboxSDKPlugin<TState>> = new (sdk: GearboxSDK<any>) => TPlugin;
+export type IOnchainSDKPluginConstructor<TState extends Record<keyof TState, unknown>, TPlugin extends IOnchainSDKPlugin<TState>> = new (sdk: OnchainSDK<any>) => TPlugin;
 /**
  * Public contract every SDK plugin must satisfy.
  *
@@ -32,12 +32,12 @@ export type IGearboxSDKPluginConstructor<TState extends Record<keyof TState, unk
  *
  * @typeParam TState - Plugin-specific state shape.
  **/
-export interface IGearboxSDKPlugin<TState extends Record<keyof TState, unknown> = {}> {
+export interface IOnchainSDKPlugin<TState extends Record<keyof TState, unknown> = {}> {
     /**
      * Reference to the parent SDK instance.
      * Set automatically by the SDK constructor.
      **/
-    sdk: GearboxSDK<any>;
+    sdk: OnchainSDK<any>;
     /**
      * Plugin version, used to verify state compatibility during hydration.
      **/
@@ -98,12 +98,12 @@ export interface IGearboxSDKPlugin<TState extends Record<keyof TState, unknown>
 /**
  * Helper type that extracts the state type from a plugin instance.
  **/
-export type PluginState<T> = T extends IGearboxSDKPlugin<infer TState> ? IPluginState<TState> : never;
+export type PluginState<T> = T extends IOnchainSDKPlugin<infer TState> ? IPluginState<TState> : never;
 /**
  * @internal
  * Mapping between plugin name and plugin instance.
  **/
-export type PluginsMap = Record<string, IGearboxSDKPlugin<any>>;
+export type PluginsMap = Record<string, IOnchainSDKPlugin<any>>;
 /**
  * @internal
  * Mapping that infers plugin states from plugin instances.
@@ -111,3 +111,13 @@ export type PluginsMap = Record<string, IGearboxSDKPlugin<any>>;
 export type PluginStatesMap<T extends PluginsMap> = {
     [K in keyof T]: PluginState<T[K]>;
 };
+/**
+ * Factory function that produces a plugin instance.
+ **/
+export type PluginFactory<P extends IOnchainSDKPlugin> = () => P;
+/**
+ * Map of plugin factories keyed by plugin name.
+ **/
+export type PluginFactoriesMap<Plugins extends PluginsMap> = {
+    [K in keyof Plugins]: PluginFactory<Plugins[K]>;
+};

package/dist/types/{sdk → src/sdk}/router/AbstractRouterContract.d.ts

@@ -1,7 +1,7 @@
 import type { Abi, Address } from "viem";
 import { BaseContract, type BaseContractArgs } from "../base/index.js";
-import type { GearboxSDK } from "../GearboxSDK.js";
 import type { IPriceOracleContract } from "../market/index.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 import { AddressMap, AddressSet } from "../utils/index.js";
 import type { Asset, RouterCASlice, RouterCMSlice } from "./types.js";
 export interface ExpectedAndLeftoverOptions {
@@ -29,8 +29,8 @@ export declare abstract class AbstractRouterContract<abi extends Abi | readonly
     /**
      * Reference to the parent SDK instance.
      **/
-    readonly sdk: GearboxSDK;
-    constructor(sdk: GearboxSDK, args: BaseContractArgs<abi>);
+    readonly sdk: OnchainSDK;
+    constructor(sdk: OnchainSDK, args: BaseContractArgs<abi>);
     protected getExpectedAndLeftover(ca: RouterCASlice, cm: RouterCMSlice, options?: ExpectedAndLeftoverOptions): Leftovers;
     protected getDefaultExpectedAndLeftover(ca: RouterCASlice, keepAssets?: Address[], debtOnly?: boolean): Leftovers;
     /**

package/dist/types/{sdk → src/sdk}/router/RouterV310Contract.d.ts

@@ -1,5 +1,5 @@
 import { type Address } from "viem";
-import type { GearboxSDK } from "../GearboxSDK.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 import { AbstractRouterContract } from "./AbstractRouterContract.js";
 import type { FindBestClosePathProps, FindClaimAllRewardsProps, FindOneTokenPathProps, FindOpenStrategyPathProps, IRouterContract, OpenStrategyResult, RouterCloseResult, RouterResult, RouterRewardsResult } from "./types.js";
 declare const abi: readonly [{
@@ -893,7 +893,7 @@ type abi = typeof abi;
  **/
 export declare class RouterV310Contract extends AbstractRouterContract<abi> implements IRouterContract {
     #private;
-    constructor(sdk: GearboxSDK, address: Address, version: number);
+    constructor(sdk: OnchainSDK, address: Address, version: number);
     /**
      * {@inheritDoc IRouterContract.findOneTokenPath}
      **/

package/dist/types/{sdk → src/sdk}/router/createRouter.d.ts

@@ -1,4 +1,4 @@
 import type { Address } from "viem";
-import type { GearboxSDK } from "../GearboxSDK.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 import type { IRouterContract } from "./types.js";
-export declare function createRouter(sdk: GearboxSDK, address: Address, version: number): IRouterContract;
+export declare function createRouter(sdk: OnchainSDK, address: Address, version: number): IRouterContract;

package/dist/types/{sdk → src/sdk}/types/state-human.d.ts

@@ -193,6 +193,7 @@ export interface MarketStateHuman {
     emergencyLiquidators: string[];
 }
 export interface GearboxStateHuman {
+    network: string;
     block: number;
     timestamp: string;
     core: CoreStateHuman;
@@ -200,3 +201,12 @@ export interface GearboxStateHuman {
     plugins: Record<string, unknown>;
     tokens: TokenMetaData[];
 }
+/**
+ * Human-readable state for all chains managed by {@link MultichainSDK}.
+ **/
+export interface MultichainStateHuman {
+    /** State format version. */
+    version: number;
+    /** Per-chain human-readable state. */
+    chains: GearboxStateHuman[];
+}

package/dist/types/{sdk → src/sdk}/types/state.d.ts

@@ -3,10 +3,10 @@ import type { NetworkType } from "../chain/chains.js";
 import type { AddressProviderState } from "../core/index.js";
 import type { PluginStatesMap, PluginsMap } from "../plugins/index.js";
 /**
- * Complete serialisable snapshot of the Gearbox SDK state.
+ * Complete serialisable snapshot of the SDK state for a single chain.
  *
- * Produced by {@link GearboxSDK.state} and consumed by
- * {@link GearboxSDK.hydrate} for instant offline restoration.
+ * Produced by {@link OnchainSDK.state} and consumed by
+ * {@link OnchainSDK.hydrate} for instant offline restoration.
  *
  * @typeParam Plugins - Map of plugin names to plugin instances.
  **/
@@ -45,3 +45,14 @@ export interface GearboxState<Plugins extends PluginsMap = {}> {
      **/
     plugins: PluginStatesMap<Plugins>;
 }
+/**
+ * Serialised state for all chains managed by {@link MultichainSDK}.
+ *
+ * @typeParam Plugins - Map of plugin names to plugin instances.
+ **/
+export interface MultichainState<Plugins extends PluginsMap = {}> {
+    /** State format version. */
+    version: number;
+    /** Per-chain serialised state. */
+    chains: GearboxState<Plugins>[];
+}

package/dist/types/{sdk → src/sdk}/utils/filterDust.d.ts

@@ -1,6 +1,6 @@
 import type { Address } from "viem";
 import type { CreditAccountData } from "../base/index.js";
-import type { GearboxSDK } from "../GearboxSDK.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 /**
  * Helper function to filter out low-balance assets
  * @param account
@@ -8,7 +8,7 @@ import type { GearboxSDK } from "../GearboxSDK.js";
  */
 export declare function filterDust(account: CreditAccountData): Record<Address, bigint>;
 export interface FilterDustUSDOptions {
-    sdk: GearboxSDK;
+    sdk: OnchainSDK;
     account: CreditAccountData;
     /**
      * Dust threshold in USD, without decimals

package/dist/types/{sdk → src/sdk}/utils/isDust.d.ts

@@ -1,7 +1,7 @@
 import type { Address } from "viem";
-import type { GearboxSDK } from "../GearboxSDK.js";
+import type { OnchainSDK } from "../OnchainSDK.js";
 export interface IsDustOptions {
-    sdk: GearboxSDK;
+    sdk: OnchainSDK;
     token: Address;
     balance: bigint;
     creditManager: Address;

package/dist/types/{sdk → src/sdk}/utils/viem/index.d.ts

@@ -4,3 +4,4 @@ export * from "./getLogsSafe.js";
 export * from "./sendRawTx.js";
 export * from "./simulateMulticall.js";
 export * from "./simulateWithPriceUpdates.js";
+export * from "./watchBlocksAsync.js";

package/dist/types/src/sdk/utils/viem/watchBlocksAsync.d.ts

@@ -0,0 +1,74 @@
+import type { Chain, Client, Transport } from "viem";
+import { type GetBlockReturnType } from "viem/actions";
+type Block<chain extends Chain | undefined = Chain> = GetBlockReturnType<chain>;
+/**
+ * Parameters for {@link watchBlocksAsync}.
+ *
+ * @typeParam chain - The chain type, derived from the client.
+ */
+export interface WatchBlocksAsyncParameters<chain extends Chain | undefined = Chain> {
+    /**
+     * Async callback invoked when a new block is received.
+     * If the handler is still running when the next block arrives, the new block
+     * is silently dropped and {@link WatchBlocksAsyncParameters.onDrop | onDrop}
+     * is called instead.
+     */
+    onBlock: (block: Block<chain>, prevBlock: Block<chain> | undefined) => Promise<void>;
+    /** Callback invoked when `getBlock` or `onBlock` throws. */
+    onError?: ((error: Error) => void) | undefined;
+    /**
+     * Synchronous callback invoked when a new block is dropped because the
+     * previous {@link WatchBlocksAsyncParameters.onBlock | onBlock} handler has
+     * not yet resolved.
+     */
+    onDrop?: ((block: Block<chain>) => void) | undefined;
+    /**
+     * Polling frequency in milliseconds.
+     * @defaultValue `client.pollingInterval`
+     */
+    pollingInterval?: number | undefined;
+}
+/** Unwatch function returned by {@link watchBlocksAsync}. */
+export type WatchBlocksAsyncReturnType = () => void;
+/**
+ * Polls for new blocks over HTTP and invokes an **async** `onBlock` handler.
+ *
+ * Unlike viem's built-in `watchBlocks`, the handler is awaited. If a new block
+ * arrives while the previous handler is still running, the block is silently
+ * dropped and the optional `onDrop` callback is invoked synchronously.
+ *
+ * Only HTTP transports are supported (no WebSocket / IPC).
+ *
+ * @param client - A viem {@link Client} configured with an HTTP transport.
+ * @param parameters - {@link WatchBlocksAsyncParameters}
+ * @returns A function that stops polling when called. {@link WatchBlocksAsyncReturnType}
+ *
+ * @example
+ * ```ts
+ * import { createPublicClient, http } from "viem";
+ * import { mainnet } from "viem/chains";
+ * import { watchBlocksAsync } from "./watchBlocksAsync.js";
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * });
+ *
+ * const unwatch = watchBlocksAsync(client, {
+ *   onBlock: async (block, prevBlock) => {
+ *     console.log("new block", block.number);
+ *   },
+ *   onDrop: (block) => {
+ *     console.log("dropped block", block.number);
+ *   },
+ *   onError: (err) => {
+ *     console.error(err);
+ *   },
+ * });
+ *
+ * // later
+ * unwatch();
+ * ```
+ */
+export declare function watchBlocksAsync<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: WatchBlocksAsyncParameters<chain>): WatchBlocksAsyncReturnType;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "13.6.0",
+  "version": "14.0.0-next.2",
   "description": "Gearbox SDK",
   "license": "MIT",
   "main": "./dist/cjs/sdk/index.js",
@@ -86,15 +86,16 @@
     "date-fns": "^4.1.0",
     "decimal.js-light": "^2.5.1",
     "viem": ">=2.23.15 <3.0.0",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.10",
+    "@biomejs/biome": "^2.4.11",
     "@commitlint/cli": "^20.5.0",
     "@commitlint/config-conventional": "^20.5.0",
-    "@gearbox-protocol/biome-config": "^1.0.25",
+    "@gearbox-protocol/biome-config": "^1.0.26",
     "@types/cross-spawn": "^6.0.6",
-    "axios": "^1.14.0",
+    "axios": "^1.15.0",
     "cross-spawn": "^7.0.6",
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
@@ -102,10 +103,10 @@
     "pino-pretty": "^13.1.3",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "viem-deal": "^2.0.4",
-    "vite": "^8.0.3",
-    "vitest": "^4.1.2"
+    "vite": "^8.0.8",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
     "axios": "^1.0.0",

package/dist/cjs/dev/CachedStateSubscriber.js

@@ -1,78 +0,0 @@
-"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 CachedStateSubscriber_exports = {};
-__export(CachedStateSubscriber_exports, {
-  CachedStateSubscriber: () => CachedStateSubscriber
-});
-module.exports = __toCommonJS(CachedStateSubscriber_exports);
-var import_sdk = require("../sdk/index.js");
-class CachedStateSubscriber {
-  #stateURL;
-  #etag;
-  #currentBlock;
-  #sdk;
-  constructor(sdk, stateURL) {
-    this.#stateURL = stateURL;
-    this.#sdk = sdk;
-  }
-  /**
-   * Subscribe to sdk state changes
-   * @param opts - Options
-   * @returns Unsubscribe function
-   */
-  subscribe(opts) {
-    const intervalMs = opts?.pollInterval ?? 10 * 60 * 1e3;
-    const interval = setInterval(async () => {
-      const newBlock = await this.#poll();
-      if (newBlock && opts?.onChange) {
-        opts.onChange(newBlock);
-      }
-    }, intervalMs);
-    return () => clearInterval(interval);
-  }
-  async #poll() {
-    try {
-      const head = await fetch(this.#stateURL, { method: "HEAD" });
-      const etag = head.headers.get("ETag");
-      if (!etag || etag === this.#etag) {
-        return;
-      }
-      const response = await fetch(this.#stateURL);
-      const txt = await response.text();
-      const state = (0, import_sdk.json_parse)(txt);
-      if (state.currentBlock === this.#currentBlock) {
-        return;
-      }
-      this.#etag = etag;
-      this.#currentBlock = state.currentBlock;
-      this.#logger?.debug(`rehydrating state at block ${state.currentBlock}`);
-      this.#sdk.rehydrate(state);
-      return state.currentBlock;
-    } catch (e) {
-      this.#logger?.error(e, "error while polling cached state");
-    }
-  }
-  get #logger() {
-    return this.#sdk.logger;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  CachedStateSubscriber
-});