@gearbox-protocol/sdk 8.8.1 → 8.10.0

package/dist/cjs/dev/AccountOpener.js

@@ -117,6 +117,12 @@ class AccountOpener extends import_sdk.SDKConstruct {
       }
     }
     this.#logger?.info(`opened ${success}/${targets.length} accounts`);
+    try {
+      await this.#directlyDistributeTokens(results);
+      this.#logger?.info("distributed direct transfer tokens");
+    } catch (e) {
+      this.#logger?.error(`failed to distribute tokens: ${e}`);
+    }
     return results;
   }
   async #openAccount(input, index, total) {
@@ -503,6 +509,87 @@ class AccountOpener extends import_sdk.SDKConstruct {
     });
     return acc;
   }
+  /**
+   * Claims tokens from faucet, uniformly distributes them to accounts
+   * @param targets
+   * @returns
+   */
+  async #directlyDistributeTokens(targets) {
+    const tokens = new import_sdk.AddressSet(
+      targets.flatMap((t) => t.input.directTransfer ?? [])
+    );
+    if (tokens.size === 0) {
+      return;
+    }
+    const distributorKey = (0, import_accounts.generatePrivateKey)();
+    const distributor = (0, import_accounts.privateKeyToAccount)(distributorKey);
+    await this.#anvil.setBalance({
+      address: distributor.address,
+      value: (0, import_viem.parseEther)("100")
+    });
+    await (0, import_claimFromFaucet.claimFromFaucet)({
+      publicClient: this.#anvil,
+      wallet: this.#anvil,
+      faucet: this.faucet,
+      amountUSD: (minAmountUSD) => minAmountUSD * BigInt(targets.length),
+      claimer: distributor,
+      role: "reward token distributor",
+      logger: this.#logger
+    });
+    const actualBalances = await this.#anvil.multicall({
+      contracts: tokens.map(
+        (token) => ({
+          address: token,
+          abi: import_viem.erc20Abi,
+          functionName: "balanceOf",
+          args: [distributor.address]
+        })
+      ),
+      allowFailure: false
+    });
+    const tokensArr = tokens.asArray();
+    for (let i = 0; i < tokensArr.length; i++) {
+      const token = tokensArr[i];
+      const balance = actualBalances[i];
+      this.#logger?.debug(`${token} balance: ${balance}`);
+    }
+    for (const { account, input } of targets) {
+      if (!account) {
+        continue;
+      }
+      const directTransfer = new import_sdk.AddressSet(input.directTransfer);
+      for (let i = 0; i < tokensArr.length; i++) {
+        const token = tokensArr[i];
+        if (!directTransfer.has(token)) {
+          continue;
+        }
+        const balance = actualBalances[i] / BigInt(targets.length);
+        this.#logger?.debug(
+          `sending ${balance} ${token} to ${account.creditAccount}`
+        );
+        const hash = await this.#anvil.writeContract({
+          account: distributor,
+          address: token,
+          abi: import_viem.erc20Abi,
+          functionName: "transfer",
+          args: [account.creditAccount, balance],
+          chain: this.#anvil.chain
+        });
+        const receipt = await this.#anvil.waitForTransactionReceipt({
+          hash
+        });
+        if (receipt.status === "reverted") {
+          this.#logger?.error(
+            `failed to send ${token} to ${account.creditAccount}, tx ${hash} reverted`
+          );
+        } else {
+          this.#logger?.debug(
+            `sent ${token} to ${account.creditAccount}, tx: ${hash}`
+          );
+        }
+      }
+    }
+  }
   #getCollateralQuota(cm, collateral, collateralAmount, debt, logger) {
     const {
       underlying,

package/dist/cjs/sdk/accounts/AbstractCreditAccountsService.js

@@ -210,19 +210,18 @@ class AbstractCreditAccountService extends import_base.SDKConstruct {
   }
   /**
    * Generates transaction to liquidate credit account
-   * @param account
-   * @param to Address to transfer underlying left after liquidation
-   * @param slippage
-   * @param force TODO: legacy v3 option to remove
+   * @param props - {@link FullyLiquidateProps}
    * @returns
    */
-  async fullyLiquidate(account, to, slippage = 50n, force = false) {
+  async fullyLiquidate(props) {
+    const { account, to, slippage = 50n, force = false, keepAssets } = props;
     const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
     const routerCloseResult = await this.sdk.routerFor(account).findBestClosePath({
       creditAccount: account,
       creditManager: cm.creditManager,
       slippage,
-      force
+      force,
+      keepAssets
     });
     const priceUpdates = await this.getPriceUpdatesForFacade(
       account.creditManager,

package/dist/cjs/sdk/router/AbstractRouterContract.js

@@ -28,8 +28,8 @@ class AbstractRouterContract extends import_base.BaseContract {
   hooks = new import_internal.Hooks();
   addHook = this.hooks.addHook.bind(this.hooks);
   removeHook = this.hooks.removeHook.bind(this.hooks);
-  getExpectedAndLeftover(ca, cm, balances) {
-    const b = balances || this.getDefaultExpectedAndLeftover(ca);
+  getExpectedAndLeftover(ca, cm, balances, keepAssets) {
+    const b = balances || this.getDefaultExpectedAndLeftover(ca, keepAssets);
     const { leftoverBalances, expectedBalances, tokensToClaim } = b;
     const expected = new import_utils.AddressMap();
     const leftover = new import_utils.AddressMap();
@@ -47,16 +47,17 @@ class AbstractRouterContract extends import_base.BaseContract {
       tokensToClaim
     };
   }
-  getDefaultExpectedAndLeftover(ca) {
+  getDefaultExpectedAndLeftover(ca, keepAssets) {
     const expectedBalances = new import_utils.AddressMap();
     const leftoverBalances = new import_utils.AddressMap();
+    const keepAssetsSet = new Set(keepAssets?.map((a) => a.toLowerCase()));
     for (const { token: t, balance, mask } of ca.tokens) {
       const token = t;
       const isEnabled = (mask & ca.enabledTokensMask) !== 0n;
       expectedBalances.upsert(token, { token, balance });
       const decimals = this.sdk.tokensMeta.decimals(token);
       const minBalance = 10n ** BigInt(Math.max(8, decimals) - 8);
-      if (balance < minBalance || !isEnabled) {
+      if (keepAssetsSet.has(token.toLowerCase()) || balance < minBalance || !isEnabled) {
         leftoverBalances.upsert(token, { token, balance });
       }
     }

package/dist/cjs/sdk/router/RouterV300Contract.js

@@ -260,11 +260,12 @@ class RouterV300Contract extends import_AbstractRouterContract.AbstractRouterCon
   /**
    * Implements {@link IRouterContract.getFindClosePathInput}
    */
-  getFindClosePathInput(ca, cm, balances) {
+  getFindClosePathInput(ca, cm, balances, keepAssets) {
     const { expectedBalances, leftoverBalances } = this.getExpectedAndLeftover(
       ca,
       cm,
-      balances
+      balances,
+      keepAssets
     );
     const pathOptions = import_PathOptionFactory.PathOptionFactory.generatePathOptions(
       ca.tokens,

package/dist/cjs/sdk/router/RouterV310Contract.js

@@ -164,7 +164,13 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
    * Implements {@link IRouterContract.findBestClosePath}
    */
   async findBestClosePath(props) {
-    const { creditAccount: ca, creditManager: cm, slippage, balances } = props;
+    const {
+      creditAccount: ca,
+      creditManager: cm,
+      slippage,
+      balances,
+      keepAssets
+    } = props;
     const { expectedBalances, leftoverBalances, tokensToClaim } = this.getExpectedAndLeftover(
       ca,
       cm,
@@ -172,7 +178,8 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
         expectedBalances: (0, import_helpers.assetsMap)(balances.expectedBalances),
         leftoverBalances: (0, import_helpers.assetsMap)(balances.leftoverBalances),
         tokensToClaim: (0, import_helpers.assetsMap)(balances.tokensToClaim || [])
-      } : void 0
+      } : void 0,
+      keepAssets
     );
     const getNumSplits = this.#numSplitsGetter(cm, expectedBalances.values());
     const tData = [];

package/dist/cjs/sdk/utils/AddressSet.js

@@ -0,0 +1,48 @@
+"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 AddressSet_exports = {};
+__export(AddressSet_exports, {
+  AddressSet: () => AddressSet
+});
+module.exports = __toCommonJS(AddressSet_exports);
+var import_viem = require("viem");
+class AddressSet extends Set {
+  constructor(entries) {
+    super(Array.from(entries ?? []).map((a) => (0, import_viem.getAddress)(a)));
+  }
+  add(value) {
+    return super.add((0, import_viem.getAddress)(value));
+  }
+  delete(value) {
+    return super.delete((0, import_viem.getAddress)(value));
+  }
+  has(value) {
+    return super.has((0, import_viem.getAddress)(value));
+  }
+  asArray() {
+    return Array.from(this);
+  }
+  map(fn) {
+    return this.asArray().map(fn);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AddressSet
+});

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

@@ -16,6 +16,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var utils_exports = {};
 module.exports = __toCommonJS(utils_exports);
 __reExport(utils_exports, require("./AddressMap.js"), module.exports);
+__reExport(utils_exports, require("./AddressSet.js"), module.exports);
 __reExport(utils_exports, require("./bytes32ToString.js"), module.exports);
 __reExport(utils_exports, require("./childLogger.js"), module.exports);
 __reExport(utils_exports, require("./createRawTx.js"), module.exports);
@@ -32,6 +33,7 @@ __reExport(utils_exports, require("./zod.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./AddressMap.js"),
+  ...require("./AddressSet.js"),
   ...require("./bytes32ToString.js"),
   ...require("./childLogger.js"),
   ...require("./createRawTx.js"),

package/dist/esm/dev/AccountOpener.js

@@ -1,10 +1,17 @@
-import { BaseError, isAddress, parseEther, parseEventLogs } from "viem";
+import {
+  BaseError,
+  erc20Abi,
+  isAddress,
+  parseEther,
+  parseEventLogs
+} from "viem";
 import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
 import { ierc20Abi } from "../abi/iERC20.js";
 import { iCreditFacadeV300Abi, iPoolV300Abi } from "../abi/v300.js";
 import {
   ADDRESS_0X0,
   AddressMap,
+  AddressSet,
   childLogger,
   formatBN,
   MAX_UINT256,
@@ -102,6 +109,12 @@ class AccountOpener extends SDKConstruct {
       }
     }
     this.#logger?.info(`opened ${success}/${targets.length} accounts`);
+    try {
+      await this.#directlyDistributeTokens(results);
+      this.#logger?.info("distributed direct transfer tokens");
+    } catch (e) {
+      this.#logger?.error(`failed to distribute tokens: ${e}`);
+    }
     return results;
   }
   async #openAccount(input, index, total) {
@@ -488,6 +501,87 @@ class AccountOpener extends SDKConstruct {
     });
     return acc;
   }
+  /**
+   * Claims tokens from faucet, uniformly distributes them to accounts
+   * @param targets
+   * @returns
+   */
+  async #directlyDistributeTokens(targets) {
+    const tokens = new AddressSet(
+      targets.flatMap((t) => t.input.directTransfer ?? [])
+    );
+    if (tokens.size === 0) {
+      return;
+    }
+    const distributorKey = generatePrivateKey();
+    const distributor = privateKeyToAccount(distributorKey);
+    await this.#anvil.setBalance({
+      address: distributor.address,
+      value: parseEther("100")
+    });
+    await claimFromFaucet({
+      publicClient: this.#anvil,
+      wallet: this.#anvil,
+      faucet: this.faucet,
+      amountUSD: (minAmountUSD) => minAmountUSD * BigInt(targets.length),
+      claimer: distributor,
+      role: "reward token distributor",
+      logger: this.#logger
+    });
+    const actualBalances = await this.#anvil.multicall({
+      contracts: tokens.map(
+        (token) => ({
+          address: token,
+          abi: erc20Abi,
+          functionName: "balanceOf",
+          args: [distributor.address]
+        })
+      ),
+      allowFailure: false
+    });
+    const tokensArr = tokens.asArray();
+    for (let i = 0; i < tokensArr.length; i++) {
+      const token = tokensArr[i];
+      const balance = actualBalances[i];
+      this.#logger?.debug(`${token} balance: ${balance}`);
+    }
+    for (const { account, input } of targets) {
+      if (!account) {
+        continue;
+      }
+      const directTransfer = new AddressSet(input.directTransfer);
+      for (let i = 0; i < tokensArr.length; i++) {
+        const token = tokensArr[i];
+        if (!directTransfer.has(token)) {
+          continue;
+        }
+        const balance = actualBalances[i] / BigInt(targets.length);
+        this.#logger?.debug(
+          `sending ${balance} ${token} to ${account.creditAccount}`
+        );
+        const hash = await this.#anvil.writeContract({
+          account: distributor,
+          address: token,
+          abi: erc20Abi,
+          functionName: "transfer",
+          args: [account.creditAccount, balance],
+          chain: this.#anvil.chain
+        });
+        const receipt = await this.#anvil.waitForTransactionReceipt({
+          hash
+        });
+        if (receipt.status === "reverted") {
+          this.#logger?.error(
+            `failed to send ${token} to ${account.creditAccount}, tx ${hash} reverted`
+          );
+        } else {
+          this.#logger?.debug(
+            `sent ${token} to ${account.creditAccount}, tx: ${hash}`
+          );
+        }
+      }
+    }
+  }
   #getCollateralQuota(cm, collateral, collateralAmount, debt, logger) {
     const {
       underlying,

package/dist/esm/sdk/accounts/AbstractCreditAccountsService.js

@@ -201,19 +201,18 @@ class AbstractCreditAccountService extends SDKConstruct {
   }
   /**
    * Generates transaction to liquidate credit account
-   * @param account
-   * @param to Address to transfer underlying left after liquidation
-   * @param slippage
-   * @param force TODO: legacy v3 option to remove
+   * @param props - {@link FullyLiquidateProps}
    * @returns
    */
-  async fullyLiquidate(account, to, slippage = 50n, force = false) {
+  async fullyLiquidate(props) {
+    const { account, to, slippage = 50n, force = false, keepAssets } = props;
     const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
     const routerCloseResult = await this.sdk.routerFor(account).findBestClosePath({
       creditAccount: account,
       creditManager: cm.creditManager,
       slippage,
-      force
+      force,
+      keepAssets
     });
     const priceUpdates = await this.getPriceUpdatesForFacade(
       account.creditManager,

package/dist/esm/sdk/router/AbstractRouterContract.js

@@ -5,8 +5,8 @@ class AbstractRouterContract extends BaseContract {
   hooks = new Hooks();
   addHook = this.hooks.addHook.bind(this.hooks);
   removeHook = this.hooks.removeHook.bind(this.hooks);
-  getExpectedAndLeftover(ca, cm, balances) {
-    const b = balances || this.getDefaultExpectedAndLeftover(ca);
+  getExpectedAndLeftover(ca, cm, balances, keepAssets) {
+    const b = balances || this.getDefaultExpectedAndLeftover(ca, keepAssets);
     const { leftoverBalances, expectedBalances, tokensToClaim } = b;
     const expected = new AddressMap();
     const leftover = new AddressMap();
@@ -24,16 +24,17 @@ class AbstractRouterContract extends BaseContract {
       tokensToClaim
     };
   }
-  getDefaultExpectedAndLeftover(ca) {
+  getDefaultExpectedAndLeftover(ca, keepAssets) {
     const expectedBalances = new AddressMap();
     const leftoverBalances = new AddressMap();
+    const keepAssetsSet = new Set(keepAssets?.map((a) => a.toLowerCase()));
     for (const { token: t, balance, mask } of ca.tokens) {
       const token = t;
       const isEnabled = (mask & ca.enabledTokensMask) !== 0n;
       expectedBalances.upsert(token, { token, balance });
       const decimals = this.sdk.tokensMeta.decimals(token);
       const minBalance = 10n ** BigInt(Math.max(8, decimals) - 8);
-      if (balance < minBalance || !isEnabled) {
+      if (keepAssetsSet.has(token.toLowerCase()) || balance < minBalance || !isEnabled) {
         leftoverBalances.upsert(token, { token, balance });
       }
     }

package/dist/esm/sdk/router/RouterV300Contract.js

@@ -240,11 +240,12 @@ class RouterV300Contract extends AbstractRouterContract {
   /**
    * Implements {@link IRouterContract.getFindClosePathInput}
    */
-  getFindClosePathInput(ca, cm, balances) {
+  getFindClosePathInput(ca, cm, balances, keepAssets) {
     const { expectedBalances, leftoverBalances } = this.getExpectedAndLeftover(
       ca,
       cm,
-      balances
+      balances,
+      keepAssets
     );
     const pathOptions = PathOptionFactory.generatePathOptions(
       ca.tokens,

package/dist/esm/sdk/router/RouterV310Contract.js

@@ -141,7 +141,13 @@ class RouterV310Contract extends AbstractRouterContract {
    * Implements {@link IRouterContract.findBestClosePath}
    */
   async findBestClosePath(props) {
-    const { creditAccount: ca, creditManager: cm, slippage, balances } = props;
+    const {
+      creditAccount: ca,
+      creditManager: cm,
+      slippage,
+      balances,
+      keepAssets
+    } = props;
     const { expectedBalances, leftoverBalances, tokensToClaim } = this.getExpectedAndLeftover(
       ca,
       cm,
@@ -149,7 +155,8 @@ class RouterV310Contract extends AbstractRouterContract {
         expectedBalances: assetsMap(balances.expectedBalances),
         leftoverBalances: assetsMap(balances.leftoverBalances),
         tokensToClaim: assetsMap(balances.tokensToClaim || [])
-      } : void 0
+      } : void 0,
+      keepAssets
     );
     const getNumSplits = this.#numSplitsGetter(cm, expectedBalances.values());
     const tData = [];

package/dist/esm/sdk/utils/AddressSet.js

@@ -0,0 +1,24 @@
+import { getAddress } from "viem";
+class AddressSet extends Set {
+  constructor(entries) {
+    super(Array.from(entries ?? []).map((a) => getAddress(a)));
+  }
+  add(value) {
+    return super.add(getAddress(value));
+  }
+  delete(value) {
+    return super.delete(getAddress(value));
+  }
+  has(value) {
+    return super.has(getAddress(value));
+  }
+  asArray() {
+    return Array.from(this);
+  }
+  map(fn) {
+    return this.asArray().map(fn);
+  }
+}
+export {
+  AddressSet
+};

package/dist/esm/sdk/utils/index.js

@@ -1,4 +1,5 @@
 export * from "./AddressMap.js";
+export * from "./AddressSet.js";
 export * from "./bytes32ToString.js";
 export * from "./childLogger.js";
 export * from "./createRawTx.js";

package/dist/types/dev/AccountOpener.d.ts

@@ -25,6 +25,10 @@ export interface TargetAccount {
      * TODO: not implemented
      */
     collateral?: Address;
+    /**
+     * These tokens will be transferred directly from faucet to credit account
+     */
+    directTransfer?: Address[];
     leverage?: number;
     slippage?: number;
 }

package/dist/types/sdk/accounts/AbstractCreditAccountsService.d.ts

@@ -5,7 +5,7 @@ import type { GearboxSDK } from "../GearboxSDK.js";
 import type { OnDemandPriceUpdate, UpdatePriceFeedsResult } from "../market/index.js";
 import { type Asset, type RouterCASlice } from "../router/index.js";
 import type { MultiCall } from "../types/index.js";
-import type { GetConnectedBotsResult } from "./types";
+import type { FullyLiquidateProps, GetConnectedBotsResult } from "./types";
 import type { AddCollateralProps, ChangeDeptProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, EnableTokensProps, ExecuteSwapProps, GetCreditAccountsOptions, OpenCAProps, PermitResult, PrepareUpdateQuotasProps, Rewards, UpdateQuotasProps } from "./types.js";
 export interface CreditAccountServiceOptions {
     batchSize?: number;
@@ -49,13 +49,10 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
     }>): Promise<GetConnectedBotsResult>;
     /**
      * Generates transaction to liquidate credit account
-     * @param account
-     * @param to Address to transfer underlying left after liquidation
-     * @param slippage
-     * @param force TODO: legacy v3 option to remove
+     * @param props - {@link FullyLiquidateProps}
      * @returns
      */
-    fullyLiquidate(account: RouterCASlice, to: Address, slippage?: bigint, force?: boolean): Promise<CloseCreditAccountResult>;
+    fullyLiquidate(props: FullyLiquidateProps): Promise<CloseCreditAccountResult>;
     /**
      * Closes credit account or closes credit account and keeps it open with zero debt.
        - Ca is closed in the following order: price update -> close path to swap all tokens into underlying ->

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

@@ -239,6 +239,28 @@ export interface ChangeDeptProps {
      */
     amount: bigint;
 }
+export interface FullyLiquidateProps {
+    /**
+     * Credit account to liquidate
+     */
+    account: RouterCASlice;
+    /**
+     * Address to transfer underlying left after liquidation
+     */
+    to: Address;
+    /**
+     * Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
+     */
+    slippage?: bigint;
+    /**
+     * TODO: legacy v3 option to remove
+     */
+    force?: boolean;
+    /**
+     * List of assets to keep on account after liquidation
+     */
+    keepAssets?: Address[];
+}
 export interface PermitResult {
     r: Address;
     s: Address;
@@ -338,13 +360,10 @@ export interface ICreditAccountsService extends SDKConstruct {
     setBot: (props: SetBotProps) => Promise<CreditAccountOperationResult>;
     /**
      * Generates transaction to liquidate credit account
-     * @param account
-     * @param to Address to transfer underlying left after liquidation
-     * @param slippage
-     * @param force TODO: legacy v3 option to remove
+     * @param props - {@link FullyLiquidateProps}
      * @returns
      */
-    fullyLiquidate(account: RouterCASlice, to: Address, slippage?: bigint, force?: boolean): Promise<CloseCreditAccountResult>;
+    fullyLiquidate(props: FullyLiquidateProps): Promise<CloseCreditAccountResult>;
     /**
      * Closes credit account or closes credit account and keeps it open with zero debt.
      * - Ca is closed in the following order: price update -> close path to swap all tokens into underlying ->

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

@@ -1,4 +1,4 @@
-import type { Abi } from "viem";
+import type { Abi, Address } from "viem";
 import { BaseContract } from "../base/index.js";
 import { AddressMap } from "../utils/index.js";
 import type { IHooks } from "../utils/internal/index.js";
@@ -13,6 +13,6 @@ export declare abstract class AbstractRouterContract<abi extends Abi | readonly
     protected readonly hooks: Hooks<RouterHooks>;
     readonly addHook: <K extends "foundPathOptions">(hookName: K, fn: (...args: RouterHooks[K]) => void | Promise<void>) => void;
     readonly removeHook: <K extends "foundPathOptions">(hookName: K, fn: (...args: RouterHooks[K]) => void | Promise<void>) => void;
-    protected getExpectedAndLeftover(ca: RouterCASlice, cm: RouterCMSlice, balances?: Leftovers): Leftovers;
-    protected getDefaultExpectedAndLeftover(ca: RouterCASlice): Leftovers;
+    protected getExpectedAndLeftover(ca: RouterCASlice, cm: RouterCMSlice, balances?: Leftovers, keepAssets?: Address[]): Leftovers;
+    protected getDefaultExpectedAndLeftover(ca: RouterCASlice, keepAssets?: Address[]): Leftovers;
 }

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

@@ -31,7 +31,7 @@ export declare class RouterV300Contract extends AbstractRouterContract<abi> impl
     /**
      * Implements {@link IRouterContract.getFindClosePathInput}
      */
-    getFindClosePathInput(ca: RouterCASlice, cm: RouterCMSlice, balances?: Leftovers): FindClosePathInput;
+    getFindClosePathInput(ca: RouterCASlice, cm: RouterCMSlice, balances?: Leftovers, keepAssets?: Address[]): FindClosePathInput;
     /**
      * Implements {@link IRouterContract.getAvailableConnectors}
      */

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

@@ -201,6 +201,11 @@ export interface FindBestClosePathProps {
      * Balances {@link ClosePathBalances} to close account with, if not provided, all assets will be swapped according to inner logic.
      */
     balances?: ClosePathBalances;
+    /**
+     * List of assets to keep on account after closing.
+     * When balances are explicitly provided, keepAssets is ignored.
+     */
+    keepAssets?: Address[];
     /**
      * TODO: legacy v3 option to pass to contract
      */
@@ -281,9 +286,10 @@ export interface IRouterContract extends IBaseContract {
      * @param ca
      * @param cm
      * @param balances
+     * @param keepAssets
      * @returns
      */
-    getFindClosePathInput: (ca: RouterCASlice, cm: RouterCMSlice, balances?: Leftovers) => FindClosePathInput;
+    getFindClosePathInput: (ca: RouterCASlice, cm: RouterCMSlice, balances?: Leftovers, keepAssets?: Address[]) => FindClosePathInput;
 }
 export type RouterHooks = {
     /**

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

@@ -0,0 +1,9 @@
+import { type Address } from "viem";
+export declare class AddressSet extends Set<Address> {
+    constructor(entries?: Iterable<Address>);
+    add(value: Address): this;
+    delete(value: Address): boolean;
+    has(value: Address): boolean;
+    asArray(): Address[];
+    map<T>(fn: (address: Address) => T): T[];
+}

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

@@ -1,4 +1,5 @@
 export * from "./AddressMap.js";
+export * from "./AddressSet.js";
 export * from "./bytes32ToString.js";
 export * from "./childLogger.js";
 export * from "./createRawTx.js";

package/package.json

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