@gearbox-protocol/sdk 13.3.2 → 13.3.4

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

@@ -1,14 +1,14 @@
 import type { Address } from "viem";
 import type { CreditAccountData, IBaseContract } from "../base/index.js";
 import type { MultiCall } from "../types/index.js";
-import type { Leftovers } from "./AbstractRouterContract.js";
+/**
+ * Type of swap the router should perform.
+ *
+ * - `"EXACT_INPUT"` — swap an exact amount of the input token.
+ * - `"EXACT_INPUT_ALL"` — swap the entire balance of the input token.
+ * - `"EXACT_OUTPUT"` — swap to receive an exact amount of the output token (no longer supported by the router).
+ **/
 export type SwapOperation = "EXACT_INPUT" | "EXACT_INPUT_ALL" | "EXACT_OUTPUT";
-export interface PathOption {
-    target: Address;
-    option: number;
-    totalOptions: number;
-}
-export type PathOptionSerie = Array<PathOption>;
 /**
  * Result returned from router contract
  */
@@ -65,8 +65,18 @@ export interface RouterCloseResult extends RouterResult {
      */
     underlyingBalance: bigint;
 }
+/**
+ * A token address paired with a balance, used throughout the router to
+ * represent holdings, collateral inputs, and leftover targets.
+ **/
 export interface Asset {
+    /**
+     * ERC-20 token address.
+     **/
     token: Address;
+    /**
+     * Token amount in the token's native decimals.
+     **/
     balance: bigint;
 }
 /**
@@ -78,50 +88,14 @@ export interface RouterCMSlice {
     collateralTokens: Array<Address>;
 }
 /**
- * Slice of credit account data required for router operations
- */
+ * Minimal slice of credit-account data required by router operations.
+ **/
 export type RouterCASlice = Pick<CreditAccountData, "tokens" | "enabledTokensMask" | "underlying" | "creditAccount" | "creditFacade" | "debt" | "totalDebtUSD" | "creditManager">;
+/**
+ * Lightweight slice of credit-account data containing only token
+ * balances and the enabled-tokens bitmask.
+ **/
 export type CreditAccountTokensSlice = Pick<CreditAccountData, "creditAccount" | "tokens" | "enabledTokensMask">;
-export interface FindAllSwapsProps {
-    /**
-     * Minimal credit account data on which operation is performed
-     */
-    creditAccount: RouterCASlice;
-    /**
-     * Minimal credit manager data on which operation is performed
-     */
-    creditManager: RouterCMSlice;
-    /**
-     * {@link SwapOperation} = "EXACT_INPUT" | "EXACT_INPUT_ALL" | "EXACT_OUTPUT"; however router stopped to support EXACT_OUTPUT
-     */
-    swapOperation: SwapOperation;
-    /**
-     * Address of input token
-     */
-    tokenIn: Address;
-    /**
-     * Address of target token
-     */
-    tokenOut: Address;
-    /**
-     * Incoming amount of tokenIn to swap
-     */
-    amount: bigint;
-    /**
-     * Amount that should be left on account after swap; technically equals to 0 in the most of the cases
-     */
-    leftoverAmount: bigint;
-    /**
-     * Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
-     */
-    slippage: number | bigint;
-}
-export interface FindClosePathInput {
-    pathOptions: Array<PathOptionSerie>;
-    expected: Array<Asset>;
-    leftover: Array<Asset>;
-    connectors: Array<Address>;
-}
 export interface FindOneTokenPathProps {
     /**
      * Minimal credit account data on which operation is performed
@@ -136,7 +110,7 @@ export interface FindOneTokenPathProps {
      */
     tokenIn: Address;
     /**
-     * Adddress of target token
+     * Address of target token
      */
     tokenOut: Address;
     /**
@@ -206,7 +180,7 @@ export interface FindBestClosePathProps {
      */
     keepAssets?: Address[];
     /**
-     * Debt only mode - will try to sell just enought of most valuable token to cover debt
+     * Debt only mode - will try to sell just enough of most valuable token to cover debt
      */
     debtOnly?: boolean;
 }
@@ -228,35 +202,43 @@ export interface ClosePathBalances {
      */
     tokensToClaim?: Array<Asset>;
 }
-export interface ExpectedAndLeftoverOptions {
-    balances?: Leftovers;
-    keepAssets?: Address[];
-    debtOnly?: boolean;
-}
+/**
+ * On-chain router contract that finds optimal multi-hop swap paths
+ * for credit-account operations: single-token swaps, open-strategy
+ * collateral conversion, reward claiming, and full account closure.
+ **/
 export interface IRouterContract extends IBaseContract {
     /**
-     * Find the best path to swap token A to token B (target token).
+     * Find the best path to swap one token into another.
+     *
      * @param props - {@link FindOneTokenPathProps}
-     * @return result - {@link RouterResult}
-     */
+     * @returns The optimal swap result including amount, slippage-adjusted
+     *   minimum, and the multi-call sequence to execute.
+     **/
     findOneTokenPath: (props: FindOneTokenPathProps) => Promise<RouterResult>;
     /**
-     * Finds the best path for opening Credit Account; converts all expectedBalances besides leftoverBalances into target token
+     * Find the best path for opening a credit account by converting all
+     * collateral (except leftovers) into a single target token.
+     *
      * @param props - {@link FindOpenStrategyPathProps}
-     * @returns result - {@link OpenStrategyResult}
-     */
+     * @returns Swap result with projected post-open balances.
+     **/
     findOpenStrategyPath: (props: FindOpenStrategyPathProps) => Promise<OpenStrategyResult>;
     /**
-     * Constructs calls to claim all rewards for Credit Account
+     * Construct calls to claim all pending rewards on a credit account
+     * and swap them to the underlying token.
+     *
      * @param props - {@link FindClaimAllRewardsProps}
-     * @returns result - {@link RouterRewardsResult}
-     */
+     * @returns Multi-call sequence for claiming and swapping rewards.
+     **/
     findClaimAllRewards: (props: FindClaimAllRewardsProps) => Promise<RouterRewardsResult>;
     /**
-     * Finds the path to swap / withdraw all assets from CreditAccount into underlying asset
-     * Can be used for closing Credit Account and for liquidations as well.
+     * Find the best path to swap all credit-account assets into the
+     * underlying token. Used for account closure and liquidation.
+     *
      * @param props - {@link FindBestClosePathProps}
-     * @return result - {@link RouterCloseResult}
-     */
+     * @returns Swap result including the total underlying balance
+     *   after all swaps.
+     **/
     findBestClosePath: (props: FindBestClosePathProps) => Promise<RouterCloseResult>;
 }

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

@@ -2,17 +2,46 @@ import type { MarketData } from "../base/index.js";
 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.
+ *
+ * Produced by {@link GearboxSDK.state} and consumed by
+ * {@link GearboxSDK.hydrate} for instant offline restoration.
+ *
+ * @typeParam Plugins - Map of plugin names to plugin instances.
+ **/
 export interface GearboxState<Plugins extends PluginsMap = {}> {
     /**
-     * State version, checked duryng hydration
-     * This is not the same as @gearbox-protocol/sdk package version
-     */
+     * State format version, checked during hydration.
+     * This is *not* the `@gearbox-protocol/sdk` package version.
+     **/
     version: number;
+    /**
+     * Gearbox network type the snapshot was taken from.
+     **/
     network: NetworkType;
+    /**
+     * EVM chain ID the snapshot was taken from.
+     **/
     chainId: number;
+    /**
+     * Block number the snapshot corresponds to.
+     **/
     currentBlock: bigint;
+    /**
+     * Block timestamp (Unix epoch seconds).
+     **/
     timestamp: bigint;
+    /**
+     * Address provider contract state.
+     **/
     addressProvider: AddressProviderState;
+    /**
+     * All loaded market data.
+     **/
     markets: MarketData[];
+    /**
+     * Per-plugin serialised state.
+     **/
     plugins: PluginStatesMap<Plugins>;
 }

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

@@ -1,50 +1,94 @@
 import type { Address } from "viem";
+/**
+ * Case-insensitive map keyed by EVM addresses.
+ *
+ * All keys are checksummed via viem's {@link getAddress} on insertion and
+ * lookup, so `0xabc...` and `0xABC...` resolve to the same entry.
+ *
+ * @typeParam T - Type of values stored in the map.
+ */
 export declare class AddressMap<T> {
     #private;
+    /**
+     * @param entries - Optional initial key-value pairs. Address strings are checksummed automatically.
+     * @param name - Optional label used in error messages when a lookup fails.
+     */
     constructor(entries?: Array<[string, T]>, name?: string);
     /**
-     * Adds or updates value, undefined removes value
-     * @param address
-     * @param value
+     * Adds or updates a value. Passing `undefined` removes the entry.
+     * @param address - EVM address (checksummed automatically).
+     * @param value - Value to store, or `undefined` to delete the entry.
+     * @throws If the map has been {@link freeze | frozen}.
      */
     upsert(address: string, value: T | undefined): void;
     /**
-     * Adds value, throws if this address is already used
-     * @param address
-     * @param value
+     * Inserts a value, throwing if the address is already present.
+     * @param address - EVM address (checksummed automatically).
+     * @param value - Value to store.
+     * @throws If the map has been {@link freeze | frozen} or if `address` already exists.
      */
     insert(address: string, value: T): void;
     /**
-     * Checks if address is present in map
-     * @param address
-     * @returns
+     * Checks whether an address is present in the map.
+     * @param address - EVM address (case-insensitive).
      */
     has(address: string): boolean;
     /**
-     * Returns value, or undefined if the address is not in map
-     * @param address
-     * @returns
+     * Looks up a value by EVM address (case-insensitive).
+     * @param address - EVM address to look up.
+     * @returns The stored value, or `undefined` if not present.
      */
     get(address: string): T | undefined;
     /**
-     * Gets address from map, throws if not found
-     * @param address
-     * @returns
+     * Looks up a value by EVM address, throwing if the address is absent.
+     * @param address - EVM address to look up.
+     * @throws If `address` is not in the map.
      */
     mustGet(address: string): T;
     /**
-     * Deletes address from map
-     * @param address
+     * Removes an entry by address. No-op if the address is absent.
+     * @param address - EVM address to remove.
      */
     delete(address: string): void;
+    /**
+     * Removes all entries from the map.
+     **/
     clear(): void;
+    /**
+     * Returns all entries as an array of `[checksummedAddress, value]` tuples.
+     **/
     entries(): Array<[Address, T]>;
+    /**
+     * Returns all values in insertion order.
+     **/
     values(): T[];
+    /**
+     * Returns all checksummed addresses in insertion order.
+     **/
     keys(): Address[];
+    /**
+     * Converts the map to a plain `Record<Address, T>` object.
+     **/
     asRecord(): Record<Address, T>;
+    /**
+     * Number of entries in the map.
+     **/
     get size(): number;
+    /**
+     * Prevents further mutations. Any subsequent call to {@link upsert},
+     * {@link insert}, or {@link delete} will throw.
+     */
     freeze(): void;
     protected get name(): string | undefined;
+    /**
+     * Creates an `AddressMap` from a plain record object.
+     * @param record - Object whose keys are EVM addresses.
+     */
     static fromRecord<T>(record: Record<Address, T>): AddressMap<T>;
+    /**
+     * Creates an `AddressMap` by extracting an address from each array element.
+     * @param array - Source items.
+     * @param mapFn - Function that returns the address key for a given item.
+     */
     static fromMappedArray<T>(array: T[], mapFn: (item: T) => Address): AddressMap<T>;
 }

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

@@ -1,9 +1,24 @@
 import { type Address } from "viem";
+/**
+ * Case-insensitive set of EVM addresses.
+ *
+ * All addresses are checksummed via viem's {@link getAddress} on insertion and
+ * lookup, so `0xabc...` and `0xABC...` are treated as the same entry.
+ */
 export declare class AddressSet extends Set<Address> {
+    /**
+     * @param entries - Optional initial addresses. Each is checksummed automatically.
+     */
     constructor(entries?: Iterable<Address>);
     add(value: Address): this;
     delete(value: Address): boolean;
     has(value: Address): boolean;
+    /**
+     * Returns all addresses as an array.
+     **/
     asArray(): Address[];
+    /**
+     * Maps each address through `fn` and returns the resulting array.
+     **/
     map<T>(fn: (address: Address) => T): T[];
 }

package/dist/types/sdk/utils/viem/sendRawTx.d.ts

@@ -1,7 +1,11 @@
 import type { Account, Chain, Client, SendTransactionRequest, SendTransactionReturnType, Transport } from "viem";
-import { type SendTransactionParameters } from "viem/actions";
+import { type EstimateGasParameters, type SendTransactionParameters } from "viem/actions";
 import type { RawTx } from "../../types/index.js";
 export type SendRawTxParameters<chain extends Chain, account extends Account | undefined, request extends SendTransactionRequest<chain, chainOverride>, chainOverride extends Chain | undefined = undefined> = Omit<SendTransactionParameters<chain, account, chainOverride, request>, "data" | "to" | "value"> & {
     tx: Pick<RawTx, "to" | "callData" | "value">;
 };
 export declare function sendRawTx<chain extends Chain, account extends Account | undefined, const request extends SendTransactionRequest<chain, chainOverride>, chainOverride extends Chain | undefined>(client: Client<Transport, chain, account>, params: SendRawTxParameters<chain, account, request, chainOverride>): Promise<SendTransactionReturnType>;
+export type EstimateRawTxGasParameters<chain extends Chain> = Omit<EstimateGasParameters<chain>, "data" | "to" | "value"> & {
+    tx: Pick<RawTx, "to" | "callData" | "value">;
+};
+export declare function estimateRawTxGas<chain extends Chain, account extends Account | undefined>(client: Client<Transport, chain, account>, params: EstimateRawTxGasParameters<chain>): Promise<bigint>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "13.3.2",
+  "version": "13.3.4",
   "description": "Gearbox SDK",
   "license": "MIT",
   "main": "./dist/cjs/sdk/index.js",
@@ -70,7 +70,8 @@
     "check:ci": "biome check --diagnostic-level=error",
     "typecheck:ci": "tsc --noEmit",
     "docs": "NODE_OPTIONS='--max-old-space-size=8192' pnpm --filter @gearbox-protocol/sdk-docs build",
-    "docs:dev": "pnpm --filter @gearbox-protocol/sdk-docs start"
+    "docs:dev": "pnpm --filter @gearbox-protocol/sdk-docs start",
+    "docs:serve": "pnpm --filter @gearbox-protocol/sdk-docs serve"
   },
   "dependencies": {
     "@gearbox-protocol/integrations-v3": "1.54.2",
@@ -103,6 +104,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "viem-deal": "^2.0.4",
+    "vite": "^8.0.3",
     "vitest": "^4.1.2"
   },
   "peerDependencies": {

package/dist/cjs/rewards/rewards/apy.js

@@ -1,177 +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 apy_exports = {};
-__export(apy_exports, {
-  GearboxRewardsApy: () => GearboxRewardsApy
-});
-module.exports = __toCommonJS(apy_exports);
-var import_common_utils = require("../../common-utils/index.js");
-var import_sdk = require("../../sdk/index.js");
-const PERCENTAGE_FACTOR_1KK = import_sdk.PERCENTAGE_DECIMALS * import_sdk.PERCENTAGE_FACTOR;
-const ONE = PERCENTAGE_FACTOR_1KK * 10n;
-class GearboxRewardsApy {
-  constructor() {
-  }
-  static getPoolExtraAPY_V3({
-    rewardPoolsInfo,
-    stakedDieselToken,
-    ...restProps
-  }) {
-    const { version } = restProps.pool;
-    const isV3 = version >= 300 && version < 400;
-    if (!isV3 || !stakedDieselToken) return [];
-    const info = rewardPoolsInfo[stakedDieselToken];
-    if (!info) return [];
-    const extra = (Array.isArray(info) ? info : [info]).map(
-      (inf) => GearboxRewardsApy.getPoolSingleExtraLmAPY_V3({
-        ...restProps,
-        stakedDieselToken,
-        rewardPoolsInfo: inf
-      })
-    );
-    return extra;
-  }
-  static getPoolSingleExtraLmAPY_V3({
-    stakedDieselToken,
-    pool,
-    prices,
-    rewardPoolsInfo,
-    rewardPoolsSupply,
-    tokensList,
-    currentTimestamp
-  }) {
-    const { underlyingToken, dieselRateRay } = pool;
-    const safeSupply = rewardPoolsSupply[stakedDieselToken] ?? 0n;
-    const { decimals: underlyingDecimals = 18 } = tokensList[underlyingToken] || {};
-    const underlyingPrice = prices[underlyingToken] ?? 0n;
-    const dieselPrice = underlyingPrice * dieselRateRay / import_sdk.RAY;
-    const rewardAddress = rewardPoolsInfo?.token || "";
-    const { decimals: rewardDecimals = 18 } = tokensList[rewardAddress] || {};
-    const rewardPrice = prices[rewardAddress] ?? 0n;
-    const r = GearboxRewardsApy.calculateAPY_V3({
-      currentTimestamp,
-      info: rewardPoolsInfo,
-      supply: {
-        amount: safeSupply,
-        decimals: underlyingDecimals,
-        price: dieselPrice
-      },
-      reward: {
-        price: rewardPrice,
-        decimals: rewardDecimals
-      }
-    }) / Number(import_sdk.PERCENTAGE_FACTOR);
-    return {
-      token: stakedDieselToken,
-      balance: null,
-      apy: r,
-      rewardToken: rewardAddress,
-      rewardTokenSymbol: rewardPoolsInfo.symbol
-    };
-  }
-  static calculateAPY_V3({
-    info,
-    supply,
-    reward,
-    currentTimestamp
-  }) {
-    const finished = info.finished <= currentTimestamp;
-    if (finished) return 0;
-    if (supply.amount <= 0n) return 0;
-    if (supply.price === 0n || reward.price === 0n) return 0;
-    if (info.duration === 0n) return 0;
-    const supplyMoney = import_common_utils.PriceUtils.calcTotalPrice(
-      supply.price,
-      supply.amount,
-      supply.decimals
-    );
-    const rewardMoney = import_common_utils.PriceUtils.calcTotalPrice(
-      reward.price,
-      info.reward,
-      reward.decimals
-    );
-    const durationRatio = (0, import_sdk.toBigInt)(import_sdk.SECONDS_PER_YEAR) * import_sdk.WAD / info.duration;
-    const apyBn = rewardMoney * ONE / supplyMoney * durationRatio / import_sdk.WAD;
-    return Math.round(Number(apyBn) / 10);
-  }
-  static getCAExtraAPY_V3({
-    rewardInfo,
-    assets,
-    ...restProps
-  }) {
-    const extra = assets.reduce(
-      (acc, asset) => {
-        const { token } = asset;
-        const info = rewardInfo[token || ""];
-        if (!info || info.length === 0) return acc;
-        const extra2 = info.map(
-          (inf) => GearboxRewardsApy.getCASingleExtraAPY_V3({
-            ...restProps,
-            asset,
-            rewardInfo: inf
-          })
-        );
-        acc.push(...extra2);
-        return acc;
-      },
-      []
-    );
-    return extra;
-  }
-  static getCASingleExtraAPY_V3({
-    asset,
-    prices,
-    rewardInfo,
-    supply,
-    tokensList,
-    currentTimestamp
-  }) {
-    const { token, balance } = asset;
-    const safeSupply = supply[token] ?? 0n;
-    const { decimals: tokenDecimals = 18 } = tokensList[token] || {};
-    const tokenPrice = prices[token] ?? 0n;
-    const rewardAddress = rewardInfo?.token || "";
-    const { decimals: rewardDecimals = 18 } = tokensList[rewardAddress] || {};
-    const rewardPrice = prices[rewardAddress] ?? 0n;
-    const r = GearboxRewardsApy.calculateAPY_V3({
-      currentTimestamp,
-      info: rewardInfo,
-      supply: {
-        amount: typeof safeSupply === "bigint" ? safeSupply : safeSupply.balance,
-        decimals: tokenDecimals,
-        price: tokenPrice
-      },
-      reward: {
-        price: rewardPrice,
-        decimals: rewardDecimals
-      }
-    }) / Number(import_sdk.PERCENTAGE_FACTOR);
-    return {
-      token,
-      balance,
-      apy: r,
-      rewardToken: rewardAddress,
-      rewardTokenSymbol: rewardInfo.symbol
-    };
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  GearboxRewardsApy
-});