@gearbox-protocol/sdk 3.0.0-vfour.87 → 3.0.0-vfour.89

package/dist/cjs/sdk/index.cjs

@@ -19671,6 +19671,18 @@ var BaseContract = class extends SDKConstruct {
     }
     return `${this.name}.${decoded.functionName}({${paramsHuman.join(", ")}})`;
   }
+  /**
+   * Return args and function name from calldata
+   * @param calldata
+   * @returns
+   */
+  parseFunctionDataToObject(calldata) {
+    const decoded = viem.decodeFunctionData({
+      abi: this.abi,
+      data: calldata
+    });
+    return decoded;
+  }
   parseFunctionParams(_params) {
     return void 0;
   }
@@ -22418,11 +22430,11 @@ var CreditAccountsService = class extends SDKConstruct {
    */
   async fullyLiquidate(account, to, slippage = 50n) {
     const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
-    const routerCloseResult = await this.sdk.router.findBestClosePath(
-      account,
-      cm.creditManager,
+    const routerCloseResult = await this.sdk.router.findBestClosePath({
+      creditAccount: account,
+      creditManager: cm.creditManager,
       slippage
-    );
+    });
     const priceUpdates = await this.getPriceUpdatesForFacade(account);
     const tx = cm.creditFacade.liquidateCreditAccount(
       account.creditAccount,
@@ -22434,7 +22446,7 @@ var CreditAccountsService = class extends SDKConstruct {
   /**
    * Closes credit account or sets debt to zero (but keep account)
    * @param operation
-   * @param ca
+   * @param creditAccount
    * @param assetsToWithdraw Tokens to withdraw from credit account
    * @param to Address to withdraw underlying to
    * @param slippage
@@ -22444,13 +22456,17 @@ var CreditAccountsService = class extends SDKConstruct {
   async closeCreditAccount({
     operation,
     assetsToWithdraw,
-    ca,
+    creditAccount: ca,
     to,
     slippage = 50n,
     closePath
   }) {
     const cm = this.sdk.marketRegister.findCreditManager(ca.creditManager);
-    const routerCloseResult = closePath || await this.sdk.router.findBestClosePath(ca, cm.creditManager, slippage);
+    const routerCloseResult = closePath || await this.sdk.router.findBestClosePath({
+      creditAccount: ca,
+      creditManager: cm.creditManager,
+      slippage
+    });
     const calls = [
       ...routerCloseResult.calls,
       ...this.#prepareDisableQuotas(ca),
@@ -22466,7 +22482,7 @@ var CreditAccountsService = class extends SDKConstruct {
   /**
    * Repays credit account or sets debt to zero (but keep account)
    * @param operation
-   * @param ca
+   * @param creditAccount
    * @param assetsToWithdraw Tokens to withdraw from credit account
    * @param collateralAssets Tokens to pay for
    * @param to Address to withdraw underlying to
@@ -22478,7 +22494,7 @@ var CreditAccountsService = class extends SDKConstruct {
     operation,
     collateralAssets,
     assetsToWithdraw,
-    ca,
+    creditAccount: ca,
     permits,
     to
   }) {
@@ -22489,6 +22505,7 @@ var CreditAccountsService = class extends SDKConstruct {
       ...this.#prepareDisableQuotas(ca),
       ...this.#prepareDecreaseDebt(ca),
       ...this.#prepareDisableTokens(ca),
+      // TODO: probably needs a way to handle reward tokens
       ...assetsToWithdraw.map(
         (t) => this.#prepareWithdrawToken(ca, t, MAX_UINT256, to)
       )
@@ -22498,7 +22515,7 @@ var CreditAccountsService = class extends SDKConstruct {
   }
   /**
    * Repays liquidatable credit account
-   * @param ca
+   * @param creditAccount
    * @param assetsToWithdraw Tokens to withdraw from credit account
    * @param collateralAssets Tokens to pay for
    * @param to Address to withdraw underlying to
@@ -22508,7 +22525,7 @@ var CreditAccountsService = class extends SDKConstruct {
   async repayAndLiquidateCreditAccount({
     collateralAssets,
     assetsToWithdraw,
-    ca,
+    creditAccount: ca,
     permits,
     to
   }) {
@@ -23022,7 +23039,16 @@ var RouterV3Contract = class extends BaseContract {
    * @param slippage
    * @returns
    */
-  async findAllSwaps(ca, cm, swapOperation, tokenIn, tokenOut, amount, leftoverAmount, slippage) {
+  async findAllSwaps({
+    creditAccount: ca,
+    creditManager: cm,
+    swapOperation,
+    tokenIn,
+    tokenOut,
+    amount,
+    leftoverAmount,
+    slippage
+  }) {
     const connectors = this.getAvailableConnectors(cm.collateralTokens);
     const swapTask = {
       swapOperation: SWAP_OPERATIONS[swapOperation],
@@ -23052,15 +23078,22 @@ var RouterV3Contract = class extends BaseContract {
   }
   /**
    * Finds best path to swap all Normal tokens and tokens "on the way" to target one and vice versa
-   * @param ca
-   * @param cm
+   * @param creditAccount
+   * @param creditManager
    * @param tokenIn
    * @param tokenOut
    * @param amount
    * @param slippage
    * @returns
    */
-  async findOneTokenPath(ca, cm, tokenIn, tokenOut, amount, slippage) {
+  async findOneTokenPath({
+    creditAccount: ca,
+    creditManager: cm,
+    tokenIn,
+    tokenOut,
+    amount,
+    slippage
+  }) {
     const connectors = this.getAvailableConnectors(cm.collateralTokens);
     const { result } = await this.contract.simulate.findOneTokenPath(
       [
@@ -23083,7 +23116,7 @@ var RouterV3Contract = class extends BaseContract {
   }
   /**
    * @dev Finds the best path for opening Credit Account and converting all NORMAL tokens and LP token in the way to TARGET
-   * @param cm CreditManagerData which represents credit manager you want to use to open Credit Account
+   * @param creditManager CreditManagerData which represents credit manager you want to use to open Credit Account
    * @param expectedBalances Expected balances which would be on account accounting also debt. For example,
    *    if you open an USDC Credit Account, borrow 50_000 USDC and provide 10 WETH and 10_USDC as collateral
    *    from your own funds, expectedBalances should be: { "USDC": 60_000 * (10**6), "<address of WETH>": WAD.mul(10) }
@@ -23092,7 +23125,13 @@ var RouterV3Contract = class extends BaseContract {
    * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
    * @returns PathFinderOpenStrategyResult which
    */
-  async findOpenStrategyPath(cm, expectedBalances, leftoverBalances, target, slippage) {
+  async findOpenStrategyPath({
+    creditManager: cm,
+    expectedBalances,
+    leftoverBalances,
+    target,
+    slippage
+  }) {
     const [expectedMap, leftoverMap] = [
       balancesMap(expectedBalances),
       balancesMap(leftoverBalances)
@@ -23134,14 +23173,19 @@ var RouterV3Contract = class extends BaseContract {
   /**
    * @dev Finds the path to swap / withdraw all assets from CreditAccount into underlying asset
    *   Can bu used for closing Credit Account and for liquidations as well.
-   * @param ca CreditAccountStruct object used for close path computation
-   * @param cm CreditManagerSlice for corresponding credit manager
+   * @param creditAccount CreditAccountStruct object used for close path computation
+   * @param creditManager CreditManagerSlice for corresponding credit manager
    * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
    * @return The best option in PathFinderCloseResult format, which
    *          - underlyingBalance - total balance of underlying token
    *          - calls - list of calls which should be done to swap & unwrap everything to underlying token
    */
-  async findBestClosePath(ca, cm, slippage, balances) {
+  async findBestClosePath({
+    creditAccount: ca,
+    creditManager: cm,
+    slippage,
+    balances
+  }) {
     const { pathOptions, expected, leftover, connectors } = this.getFindClosePathInput(
       ca,
       cm,
@@ -23405,6 +23449,31 @@ var GearboxSDK = class _GearboxSDK {
       (call) => this.parseFunctionData(call.target, call.callData)
     );
   }
+  /**
+   * Return args, function, type and address name from contract call
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseFunctionDataToObject(address, calldata) {
+    const contract = this.contracts.get(address);
+    return contract ? {
+      ...contract.parseFunctionDataToObject(calldata),
+      address,
+      type: contract.contractType
+    } : null;
+  }
+  /**
+   * Converts multicalls into call info
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseMultiCallToObject(calls) {
+    return calls.map(
+      (call) => this.parseFunctionDataToObject(call.target, call.callData)
+    );
+  }
   stateHuman(raw = true) {
     return {
       block: Number(this.currentBlock),

package/dist/cjs/sdk/index.d.ts

@@ -1,3 +1,4 @@
+import * as viem from 'viem';
 import { Address, Chain, Transport, PublicClient, Abi, Log, ContractEventName, DecodeFunctionDataReturnType, Hex, ContractFunctionName, EncodeFunctionDataParameters, TransactionReceipt, UnionOmit, RequiredBy, GetContractReturnType, Client, ContractFunctionParameters, CallParameters, MulticallContracts, Narrow, AbiStateMutability, MulticallResults, GetChainContractAddressErrorType, ReadContractErrorType, GetContractErrorReturnType, EncodeFunctionDataErrorType, DecodeFunctionResultErrorType } from 'viem';
 import { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from 'abitype';
 
@@ -24891,7 +24892,7 @@ interface PathOption {
 }
 type PathOptionSerie = PathOption[];
 interface SwapTask {
-    swapOperation: bigint;
+    swapOperation: number;
     creditAccount: Address;
     tokenIn: Address;
     tokenOut: Address;
@@ -24921,6 +24922,37 @@ interface Asset {
 }
 
 type abi = typeof routerV3Abi;
+interface FindAllSwapsProps {
+    creditAccount: CreditAccountDataSlice;
+    creditManager: CreditManagerSlice;
+    swapOperation: SwapOperation;
+    tokenIn: Address;
+    tokenOut: Address;
+    amount: bigint;
+    leftoverAmount: bigint;
+    slippage: number | bigint;
+}
+interface FindOneTokenPathProps {
+    creditAccount: CreditAccountDataSlice;
+    creditManager: CreditManagerSlice;
+    tokenIn: Address;
+    tokenOut: Address;
+    amount: bigint;
+    slippage: number | bigint;
+}
+interface FindOpenStrategyPathProps {
+    creditManager: CreditManagerSlice;
+    expectedBalances: Asset[];
+    leftoverBalances: Asset[];
+    target: Address;
+    slippage: number | bigint;
+}
+interface FindBestClosePathProps {
+    creditAccount: CreditAccountDataSlice;
+    creditManager: CreditManagerSlice;
+    slippage: bigint | number;
+    balances?: ClosePathBalances;
+}
 interface FindClosePathInput {
     pathOptions: PathOptionSerie[];
     expected: Asset[];
@@ -24964,21 +24996,21 @@ declare class RouterV3Contract extends BaseContract<abi> implements IHooks<Route
      * @param slippage
      * @returns
      */
-    findAllSwaps(ca: CreditAccountDataSlice, cm: CreditManagerSlice, swapOperation: SwapOperation, tokenIn: Address, tokenOut: Address, amount: bigint, leftoverAmount: bigint, slippage: number | bigint): Promise<RouterResult[]>;
+    findAllSwaps({ creditAccount: ca, creditManager: cm, swapOperation, tokenIn, tokenOut, amount, leftoverAmount, slippage, }: FindAllSwapsProps): Promise<RouterResult[]>;
     /**
      * Finds best path to swap all Normal tokens and tokens "on the way" to target one and vice versa
-     * @param ca
-     * @param cm
+     * @param creditAccount
+     * @param creditManager
      * @param tokenIn
      * @param tokenOut
      * @param amount
      * @param slippage
      * @returns
      */
-    findOneTokenPath(ca: CreditAccountDataSlice, cm: CreditManagerSlice, tokenIn: Address, tokenOut: Address, amount: bigint, slippage: number | bigint): Promise<RouterResult>;
+    findOneTokenPath({ creditAccount: ca, creditManager: cm, tokenIn, tokenOut, amount, slippage, }: FindOneTokenPathProps): Promise<RouterResult>;
     /**
      * @dev Finds the best path for opening Credit Account and converting all NORMAL tokens and LP token in the way to TARGET
-     * @param cm CreditManagerData which represents credit manager you want to use to open Credit Account
+     * @param creditManager CreditManagerData which represents credit manager you want to use to open Credit Account
      * @param expectedBalances Expected balances which would be on account accounting also debt. For example,
      *    if you open an USDC Credit Account, borrow 50_000 USDC and provide 10 WETH and 10_USDC as collateral
      *    from your own funds, expectedBalances should be: { "USDC": 60_000 * (10**6), "<address of WETH>": WAD.mul(10) }
@@ -24987,18 +25019,18 @@ declare class RouterV3Contract extends BaseContract<abi> implements IHooks<Route
      * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
      * @returns PathFinderOpenStrategyResult which
      */
-    findOpenStrategyPath(cm: CreditManagerSlice, expectedBalances: Asset[], leftoverBalances: Asset[], target: Address, slippage: number | bigint): Promise<OpenStrategyResult>;
+    findOpenStrategyPath({ creditManager: cm, expectedBalances, leftoverBalances, target, slippage, }: FindOpenStrategyPathProps): Promise<OpenStrategyResult>;
     /**
      * @dev Finds the path to swap / withdraw all assets from CreditAccount into underlying asset
      *   Can bu used for closing Credit Account and for liquidations as well.
-     * @param ca CreditAccountStruct object used for close path computation
-     * @param cm CreditManagerSlice for corresponding credit manager
+     * @param creditAccount CreditAccountStruct object used for close path computation
+     * @param creditManager CreditManagerSlice for corresponding credit manager
      * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
      * @return The best option in PathFinderCloseResult format, which
      *          - underlyingBalance - total balance of underlying token
      *          - calls - list of calls which should be done to swap & unwrap everything to underlying token
      */
-    findBestClosePath(ca: CreditAccountDataSlice, cm: CreditManagerSlice, slippage: bigint | number, balances?: ClosePathBalances): Promise<RouterCloseResult>;
+    findBestClosePath({ creditAccount: ca, creditManager: cm, slippage, balances, }: FindBestClosePathProps): Promise<RouterCloseResult>;
     /**
      * Finds input to be used with findBestClosePath
      * @param ca
@@ -25081,6 +25113,30 @@ declare class GearboxSDK {
      * @returns
      */
     parseMultiCall(calls: MultiCall[]): string[];
+    /**
+     * Return args, function, type and address name from contract call
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    parseFunctionDataToObject(address: Address, calldata: Hex): {
+        address: `0x${string}`;
+        type: string;
+        args: any[];
+        functionName: any;
+    } | null;
+    /**
+     * Converts multicalls into call info
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    parseMultiCallToObject(calls: MultiCall[]): ({
+        address: `0x${string}`;
+        type: string;
+        args: any[];
+        functionName: any;
+    } | null)[];
     stateHuman(raw?: boolean): GearboxStateHuman;
     tvl(): Promise<void>;
     /**
@@ -25153,6 +25209,12 @@ declare abstract class BaseContract<abi extends Abi | readonly unknown[]> extend
      * @returns
      */
     parseFunctionData(calldata: Hex): string;
+    /**
+     * Return args and function name from calldata
+     * @param calldata
+     * @returns
+     */
+    parseFunctionDataToObject(calldata: Hex): DecodeFunctionDataReturnType<abi, ContractFunctionName<abi, viem.AbiStateMutability>>;
     parseFunctionParams(_params: DecodeFunctionDataReturnType<abi>): Array<string> | undefined;
     getVersion(): Promise<number>;
     createRawTx<functionName extends ContractFunctionName<abi> | undefined = undefined>(parameters: Omit<EncodeFunctionDataParameters<abi, functionName>, "abi"> & {
@@ -25194,7 +25256,7 @@ interface RepayCreditAccountResult {
 type CloseOptions = "close" | "zeroDebt";
 interface CloseCreditAccountProps {
     operation: CloseOptions;
-    ca: CreditAccountDataSlice;
+    creditAccount: CreditAccountDataSlice;
     assetsToWithdraw: Address[];
     to: Address;
     slippage?: bigint;
@@ -25206,7 +25268,7 @@ interface RepayCreditAccountProps extends RepayAndLiquidateCreditAccountProps {
 interface RepayAndLiquidateCreditAccountProps {
     collateralAssets: Asset[];
     assetsToWithdraw: Address[];
-    ca: CreditAccountDataSlice;
+    creditAccount: CreditAccountDataSlice;
     to: Address;
     permits: Record<string, PermitResult>;
 }
@@ -25255,18 +25317,18 @@ declare class CreditAccountsService extends SDKConstruct {
     /**
      * Closes credit account or sets debt to zero (but keep account)
      * @param operation
-     * @param ca
+     * @param creditAccount
      * @param assetsToWithdraw Tokens to withdraw from credit account
      * @param to Address to withdraw underlying to
      * @param slippage
      * @param closePath
      * @returns
      */
-    closeCreditAccount({ operation, assetsToWithdraw, ca, to, slippage, closePath, }: CloseCreditAccountProps): Promise<CloseCreditAccountResult>;
+    closeCreditAccount({ operation, assetsToWithdraw, creditAccount: ca, to, slippage, closePath, }: CloseCreditAccountProps): Promise<CloseCreditAccountResult>;
     /**
      * Repays credit account or sets debt to zero (but keep account)
      * @param operation
-     * @param ca
+     * @param creditAccount
      * @param assetsToWithdraw Tokens to withdraw from credit account
      * @param collateralAssets Tokens to pay for
      * @param to Address to withdraw underlying to
@@ -25274,17 +25336,17 @@ declare class CreditAccountsService extends SDKConstruct {
      * @param permits
      * @returns
      */
-    repayCreditAccount({ operation, collateralAssets, assetsToWithdraw, ca, permits, to, }: RepayCreditAccountProps): Promise<RepayCreditAccountResult>;
+    repayCreditAccount({ operation, collateralAssets, assetsToWithdraw, creditAccount: ca, permits, to, }: RepayCreditAccountProps): Promise<RepayCreditAccountResult>;
     /**
      * Repays liquidatable credit account
-     * @param ca
+     * @param creditAccount
      * @param assetsToWithdraw Tokens to withdraw from credit account
      * @param collateralAssets Tokens to pay for
      * @param to Address to withdraw underlying to
      * @param slippage
      * @returns
      */
-    repayAndLiquidateCreditAccount({ collateralAssets, assetsToWithdraw, ca, permits, to, }: RepayAndLiquidateCreditAccountProps): Promise<RepayCreditAccountResult>;
+    repayAndLiquidateCreditAccount({ collateralAssets, assetsToWithdraw, creditAccount: ca, permits, to, }: RepayAndLiquidateCreditAccountProps): Promise<RepayCreditAccountResult>;
     /**
      * Returns raw txs that are needed to update all price feeds so that all credit accounts (possibly from different markets) compute
      * @param accounts

package/dist/esm/sdk/index.d.mts

@@ -1,3 +1,4 @@
+import * as viem from 'viem';
 import { Address, Chain, Transport, PublicClient, Abi, Log, ContractEventName, DecodeFunctionDataReturnType, Hex, ContractFunctionName, EncodeFunctionDataParameters, TransactionReceipt, UnionOmit, RequiredBy, GetContractReturnType, Client, ContractFunctionParameters, CallParameters, MulticallContracts, Narrow, AbiStateMutability, MulticallResults, GetChainContractAddressErrorType, ReadContractErrorType, GetContractErrorReturnType, EncodeFunctionDataErrorType, DecodeFunctionResultErrorType } from 'viem';
 import { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from 'abitype';
 
@@ -24891,7 +24892,7 @@ interface PathOption {
 }
 type PathOptionSerie = PathOption[];
 interface SwapTask {
-    swapOperation: bigint;
+    swapOperation: number;
     creditAccount: Address;
     tokenIn: Address;
     tokenOut: Address;
@@ -24921,6 +24922,37 @@ interface Asset {
 }
 
 type abi = typeof routerV3Abi;
+interface FindAllSwapsProps {
+    creditAccount: CreditAccountDataSlice;
+    creditManager: CreditManagerSlice;
+    swapOperation: SwapOperation;
+    tokenIn: Address;
+    tokenOut: Address;
+    amount: bigint;
+    leftoverAmount: bigint;
+    slippage: number | bigint;
+}
+interface FindOneTokenPathProps {
+    creditAccount: CreditAccountDataSlice;
+    creditManager: CreditManagerSlice;
+    tokenIn: Address;
+    tokenOut: Address;
+    amount: bigint;
+    slippage: number | bigint;
+}
+interface FindOpenStrategyPathProps {
+    creditManager: CreditManagerSlice;
+    expectedBalances: Asset[];
+    leftoverBalances: Asset[];
+    target: Address;
+    slippage: number | bigint;
+}
+interface FindBestClosePathProps {
+    creditAccount: CreditAccountDataSlice;
+    creditManager: CreditManagerSlice;
+    slippage: bigint | number;
+    balances?: ClosePathBalances;
+}
 interface FindClosePathInput {
     pathOptions: PathOptionSerie[];
     expected: Asset[];
@@ -24964,21 +24996,21 @@ declare class RouterV3Contract extends BaseContract<abi> implements IHooks<Route
      * @param slippage
      * @returns
      */
-    findAllSwaps(ca: CreditAccountDataSlice, cm: CreditManagerSlice, swapOperation: SwapOperation, tokenIn: Address, tokenOut: Address, amount: bigint, leftoverAmount: bigint, slippage: number | bigint): Promise<RouterResult[]>;
+    findAllSwaps({ creditAccount: ca, creditManager: cm, swapOperation, tokenIn, tokenOut, amount, leftoverAmount, slippage, }: FindAllSwapsProps): Promise<RouterResult[]>;
     /**
      * Finds best path to swap all Normal tokens and tokens "on the way" to target one and vice versa
-     * @param ca
-     * @param cm
+     * @param creditAccount
+     * @param creditManager
      * @param tokenIn
      * @param tokenOut
      * @param amount
      * @param slippage
      * @returns
      */
-    findOneTokenPath(ca: CreditAccountDataSlice, cm: CreditManagerSlice, tokenIn: Address, tokenOut: Address, amount: bigint, slippage: number | bigint): Promise<RouterResult>;
+    findOneTokenPath({ creditAccount: ca, creditManager: cm, tokenIn, tokenOut, amount, slippage, }: FindOneTokenPathProps): Promise<RouterResult>;
     /**
      * @dev Finds the best path for opening Credit Account and converting all NORMAL tokens and LP token in the way to TARGET
-     * @param cm CreditManagerData which represents credit manager you want to use to open Credit Account
+     * @param creditManager CreditManagerData which represents credit manager you want to use to open Credit Account
      * @param expectedBalances Expected balances which would be on account accounting also debt. For example,
      *    if you open an USDC Credit Account, borrow 50_000 USDC and provide 10 WETH and 10_USDC as collateral
      *    from your own funds, expectedBalances should be: { "USDC": 60_000 * (10**6), "<address of WETH>": WAD.mul(10) }
@@ -24987,18 +25019,18 @@ declare class RouterV3Contract extends BaseContract<abi> implements IHooks<Route
      * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
      * @returns PathFinderOpenStrategyResult which
      */
-    findOpenStrategyPath(cm: CreditManagerSlice, expectedBalances: Asset[], leftoverBalances: Asset[], target: Address, slippage: number | bigint): Promise<OpenStrategyResult>;
+    findOpenStrategyPath({ creditManager: cm, expectedBalances, leftoverBalances, target, slippage, }: FindOpenStrategyPathProps): Promise<OpenStrategyResult>;
     /**
      * @dev Finds the path to swap / withdraw all assets from CreditAccount into underlying asset
      *   Can bu used for closing Credit Account and for liquidations as well.
-     * @param ca CreditAccountStruct object used for close path computation
-     * @param cm CreditManagerSlice for corresponding credit manager
+     * @param creditAccount CreditAccountStruct object used for close path computation
+     * @param creditManager CreditManagerSlice for corresponding credit manager
      * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
      * @return The best option in PathFinderCloseResult format, which
      *          - underlyingBalance - total balance of underlying token
      *          - calls - list of calls which should be done to swap & unwrap everything to underlying token
      */
-    findBestClosePath(ca: CreditAccountDataSlice, cm: CreditManagerSlice, slippage: bigint | number, balances?: ClosePathBalances): Promise<RouterCloseResult>;
+    findBestClosePath({ creditAccount: ca, creditManager: cm, slippage, balances, }: FindBestClosePathProps): Promise<RouterCloseResult>;
     /**
      * Finds input to be used with findBestClosePath
      * @param ca
@@ -25081,6 +25113,30 @@ declare class GearboxSDK {
      * @returns
      */
     parseMultiCall(calls: MultiCall[]): string[];
+    /**
+     * Return args, function, type and address name from contract call
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    parseFunctionDataToObject(address: Address, calldata: Hex): {
+        address: `0x${string}`;
+        type: string;
+        args: any[];
+        functionName: any;
+    } | null;
+    /**
+     * Converts multicalls into call info
+     * @param address
+     * @param calldata
+     * @returns
+     */
+    parseMultiCallToObject(calls: MultiCall[]): ({
+        address: `0x${string}`;
+        type: string;
+        args: any[];
+        functionName: any;
+    } | null)[];
     stateHuman(raw?: boolean): GearboxStateHuman;
     tvl(): Promise<void>;
     /**
@@ -25153,6 +25209,12 @@ declare abstract class BaseContract<abi extends Abi | readonly unknown[]> extend
      * @returns
      */
     parseFunctionData(calldata: Hex): string;
+    /**
+     * Return args and function name from calldata
+     * @param calldata
+     * @returns
+     */
+    parseFunctionDataToObject(calldata: Hex): DecodeFunctionDataReturnType<abi, ContractFunctionName<abi, viem.AbiStateMutability>>;
     parseFunctionParams(_params: DecodeFunctionDataReturnType<abi>): Array<string> | undefined;
     getVersion(): Promise<number>;
     createRawTx<functionName extends ContractFunctionName<abi> | undefined = undefined>(parameters: Omit<EncodeFunctionDataParameters<abi, functionName>, "abi"> & {
@@ -25194,7 +25256,7 @@ interface RepayCreditAccountResult {
 type CloseOptions = "close" | "zeroDebt";
 interface CloseCreditAccountProps {
     operation: CloseOptions;
-    ca: CreditAccountDataSlice;
+    creditAccount: CreditAccountDataSlice;
     assetsToWithdraw: Address[];
     to: Address;
     slippage?: bigint;
@@ -25206,7 +25268,7 @@ interface RepayCreditAccountProps extends RepayAndLiquidateCreditAccountProps {
 interface RepayAndLiquidateCreditAccountProps {
     collateralAssets: Asset[];
     assetsToWithdraw: Address[];
-    ca: CreditAccountDataSlice;
+    creditAccount: CreditAccountDataSlice;
     to: Address;
     permits: Record<string, PermitResult>;
 }
@@ -25255,18 +25317,18 @@ declare class CreditAccountsService extends SDKConstruct {
     /**
      * Closes credit account or sets debt to zero (but keep account)
      * @param operation
-     * @param ca
+     * @param creditAccount
      * @param assetsToWithdraw Tokens to withdraw from credit account
      * @param to Address to withdraw underlying to
      * @param slippage
      * @param closePath
      * @returns
      */
-    closeCreditAccount({ operation, assetsToWithdraw, ca, to, slippage, closePath, }: CloseCreditAccountProps): Promise<CloseCreditAccountResult>;
+    closeCreditAccount({ operation, assetsToWithdraw, creditAccount: ca, to, slippage, closePath, }: CloseCreditAccountProps): Promise<CloseCreditAccountResult>;
     /**
      * Repays credit account or sets debt to zero (but keep account)
      * @param operation
-     * @param ca
+     * @param creditAccount
      * @param assetsToWithdraw Tokens to withdraw from credit account
      * @param collateralAssets Tokens to pay for
      * @param to Address to withdraw underlying to
@@ -25274,17 +25336,17 @@ declare class CreditAccountsService extends SDKConstruct {
      * @param permits
      * @returns
      */
-    repayCreditAccount({ operation, collateralAssets, assetsToWithdraw, ca, permits, to, }: RepayCreditAccountProps): Promise<RepayCreditAccountResult>;
+    repayCreditAccount({ operation, collateralAssets, assetsToWithdraw, creditAccount: ca, permits, to, }: RepayCreditAccountProps): Promise<RepayCreditAccountResult>;
     /**
      * Repays liquidatable credit account
-     * @param ca
+     * @param creditAccount
      * @param assetsToWithdraw Tokens to withdraw from credit account
      * @param collateralAssets Tokens to pay for
      * @param to Address to withdraw underlying to
      * @param slippage
      * @returns
      */
-    repayAndLiquidateCreditAccount({ collateralAssets, assetsToWithdraw, ca, permits, to, }: RepayAndLiquidateCreditAccountProps): Promise<RepayCreditAccountResult>;
+    repayAndLiquidateCreditAccount({ collateralAssets, assetsToWithdraw, creditAccount: ca, permits, to, }: RepayAndLiquidateCreditAccountProps): Promise<RepayCreditAccountResult>;
     /**
      * Returns raw txs that are needed to update all price feeds so that all credit accounts (possibly from different markets) compute
      * @param accounts

package/dist/esm/sdk/index.mjs

@@ -19669,6 +19669,18 @@ var BaseContract = class extends SDKConstruct {
     }
     return `${this.name}.${decoded.functionName}({${paramsHuman.join(", ")}})`;
   }
+  /**
+   * Return args and function name from calldata
+   * @param calldata
+   * @returns
+   */
+  parseFunctionDataToObject(calldata) {
+    const decoded = decodeFunctionData({
+      abi: this.abi,
+      data: calldata
+    });
+    return decoded;
+  }
   parseFunctionParams(_params) {
     return void 0;
   }
@@ -22416,11 +22428,11 @@ var CreditAccountsService = class extends SDKConstruct {
    */
   async fullyLiquidate(account, to, slippage = 50n) {
     const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
-    const routerCloseResult = await this.sdk.router.findBestClosePath(
-      account,
-      cm.creditManager,
+    const routerCloseResult = await this.sdk.router.findBestClosePath({
+      creditAccount: account,
+      creditManager: cm.creditManager,
       slippage
-    );
+    });
     const priceUpdates = await this.getPriceUpdatesForFacade(account);
     const tx = cm.creditFacade.liquidateCreditAccount(
       account.creditAccount,
@@ -22432,7 +22444,7 @@ var CreditAccountsService = class extends SDKConstruct {
   /**
    * Closes credit account or sets debt to zero (but keep account)
    * @param operation
-   * @param ca
+   * @param creditAccount
    * @param assetsToWithdraw Tokens to withdraw from credit account
    * @param to Address to withdraw underlying to
    * @param slippage
@@ -22442,13 +22454,17 @@ var CreditAccountsService = class extends SDKConstruct {
   async closeCreditAccount({
     operation,
     assetsToWithdraw,
-    ca,
+    creditAccount: ca,
     to,
     slippage = 50n,
     closePath
   }) {
     const cm = this.sdk.marketRegister.findCreditManager(ca.creditManager);
-    const routerCloseResult = closePath || await this.sdk.router.findBestClosePath(ca, cm.creditManager, slippage);
+    const routerCloseResult = closePath || await this.sdk.router.findBestClosePath({
+      creditAccount: ca,
+      creditManager: cm.creditManager,
+      slippage
+    });
     const calls = [
       ...routerCloseResult.calls,
       ...this.#prepareDisableQuotas(ca),
@@ -22464,7 +22480,7 @@ var CreditAccountsService = class extends SDKConstruct {
   /**
    * Repays credit account or sets debt to zero (but keep account)
    * @param operation
-   * @param ca
+   * @param creditAccount
    * @param assetsToWithdraw Tokens to withdraw from credit account
    * @param collateralAssets Tokens to pay for
    * @param to Address to withdraw underlying to
@@ -22476,7 +22492,7 @@ var CreditAccountsService = class extends SDKConstruct {
     operation,
     collateralAssets,
     assetsToWithdraw,
-    ca,
+    creditAccount: ca,
     permits,
     to
   }) {
@@ -22487,6 +22503,7 @@ var CreditAccountsService = class extends SDKConstruct {
       ...this.#prepareDisableQuotas(ca),
       ...this.#prepareDecreaseDebt(ca),
       ...this.#prepareDisableTokens(ca),
+      // TODO: probably needs a way to handle reward tokens
       ...assetsToWithdraw.map(
         (t) => this.#prepareWithdrawToken(ca, t, MAX_UINT256, to)
       )
@@ -22496,7 +22513,7 @@ var CreditAccountsService = class extends SDKConstruct {
   }
   /**
    * Repays liquidatable credit account
-   * @param ca
+   * @param creditAccount
    * @param assetsToWithdraw Tokens to withdraw from credit account
    * @param collateralAssets Tokens to pay for
    * @param to Address to withdraw underlying to
@@ -22506,7 +22523,7 @@ var CreditAccountsService = class extends SDKConstruct {
   async repayAndLiquidateCreditAccount({
     collateralAssets,
     assetsToWithdraw,
-    ca,
+    creditAccount: ca,
     permits,
     to
   }) {
@@ -23020,7 +23037,16 @@ var RouterV3Contract = class extends BaseContract {
    * @param slippage
    * @returns
    */
-  async findAllSwaps(ca, cm, swapOperation, tokenIn, tokenOut, amount, leftoverAmount, slippage) {
+  async findAllSwaps({
+    creditAccount: ca,
+    creditManager: cm,
+    swapOperation,
+    tokenIn,
+    tokenOut,
+    amount,
+    leftoverAmount,
+    slippage
+  }) {
     const connectors = this.getAvailableConnectors(cm.collateralTokens);
     const swapTask = {
       swapOperation: SWAP_OPERATIONS[swapOperation],
@@ -23050,15 +23076,22 @@ var RouterV3Contract = class extends BaseContract {
   }
   /**
    * Finds best path to swap all Normal tokens and tokens "on the way" to target one and vice versa
-   * @param ca
-   * @param cm
+   * @param creditAccount
+   * @param creditManager
    * @param tokenIn
    * @param tokenOut
    * @param amount
    * @param slippage
    * @returns
    */
-  async findOneTokenPath(ca, cm, tokenIn, tokenOut, amount, slippage) {
+  async findOneTokenPath({
+    creditAccount: ca,
+    creditManager: cm,
+    tokenIn,
+    tokenOut,
+    amount,
+    slippage
+  }) {
     const connectors = this.getAvailableConnectors(cm.collateralTokens);
     const { result } = await this.contract.simulate.findOneTokenPath(
       [
@@ -23081,7 +23114,7 @@ var RouterV3Contract = class extends BaseContract {
   }
   /**
    * @dev Finds the best path for opening Credit Account and converting all NORMAL tokens and LP token in the way to TARGET
-   * @param cm CreditManagerData which represents credit manager you want to use to open Credit Account
+   * @param creditManager CreditManagerData which represents credit manager you want to use to open Credit Account
    * @param expectedBalances Expected balances which would be on account accounting also debt. For example,
    *    if you open an USDC Credit Account, borrow 50_000 USDC and provide 10 WETH and 10_USDC as collateral
    *    from your own funds, expectedBalances should be: { "USDC": 60_000 * (10**6), "<address of WETH>": WAD.mul(10) }
@@ -23090,7 +23123,13 @@ var RouterV3Contract = class extends BaseContract {
    * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
    * @returns PathFinderOpenStrategyResult which
    */
-  async findOpenStrategyPath(cm, expectedBalances, leftoverBalances, target, slippage) {
+  async findOpenStrategyPath({
+    creditManager: cm,
+    expectedBalances,
+    leftoverBalances,
+    target,
+    slippage
+  }) {
     const [expectedMap, leftoverMap] = [
       balancesMap(expectedBalances),
       balancesMap(leftoverBalances)
@@ -23132,14 +23171,19 @@ var RouterV3Contract = class extends BaseContract {
   /**
    * @dev Finds the path to swap / withdraw all assets from CreditAccount into underlying asset
    *   Can bu used for closing Credit Account and for liquidations as well.
-   * @param ca CreditAccountStruct object used for close path computation
-   * @param cm CreditManagerSlice for corresponding credit manager
+   * @param creditAccount CreditAccountStruct object used for close path computation
+   * @param creditManager CreditManagerSlice for corresponding credit manager
    * @param slippage Slippage in PERCENTAGE_FORMAT (100% = 10_000) per operation
    * @return The best option in PathFinderCloseResult format, which
    *          - underlyingBalance - total balance of underlying token
    *          - calls - list of calls which should be done to swap & unwrap everything to underlying token
    */
-  async findBestClosePath(ca, cm, slippage, balances) {
+  async findBestClosePath({
+    creditAccount: ca,
+    creditManager: cm,
+    slippage,
+    balances
+  }) {
     const { pathOptions, expected, leftover, connectors } = this.getFindClosePathInput(
       ca,
       cm,
@@ -23403,6 +23447,31 @@ var GearboxSDK = class _GearboxSDK {
       (call) => this.parseFunctionData(call.target, call.callData)
     );
   }
+  /**
+   * Return args, function, type and address name from contract call
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseFunctionDataToObject(address, calldata) {
+    const contract = this.contracts.get(address);
+    return contract ? {
+      ...contract.parseFunctionDataToObject(calldata),
+      address,
+      type: contract.contractType
+    } : null;
+  }
+  /**
+   * Converts multicalls into call info
+   * @param address
+   * @param calldata
+   * @returns
+   */
+  parseMultiCallToObject(calls) {
+    return calls.map(
+      (call) => this.parseFunctionDataToObject(call.target, call.callData)
+    );
+  }
   stateHuman(raw = true) {
     return {
       block: Number(this.currentBlock),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "3.0.0-vfour.87",
+  "version": "3.0.0-vfour.89",
   "description": "Gearbox SDK",
   "license": "MIT",
   "main": "./dist/cjs/sdk/index.cjs",