@gearbox-protocol/sdk 13.0.0-next.3 → 13.0.0-next.31

package/dist/types/plugins/adapters/contracts/types.d.ts

@@ -4,12 +4,6 @@ export declare enum BalancerV2PoolStatus {
     SWAP_ONLY = 2,
     WITHDRAWAL_ONLY = 3
 }
-export declare enum KodiakIslandStatus {
-    NOT_ALLOWED = 0,
-    ALLOWED = 1,
-    SWAP_AND_EXIT_ONLY = 2,
-    EXIT_ONLY = 3
-}
 export declare enum PendleTokenType {
     PT = 0,
     LP = 1

package/dist/types/plugins/adapters/createAdapter.d.ts

@@ -0,0 +1,7 @@
+import { type Address } from "viem";
+import type { ConstructOptions, IBaseContract, RelaxedBaseParams } from "../../sdk/index.js";
+export interface AdapterFactoryArgs {
+    baseParams: RelaxedBaseParams;
+    targetContract?: Address;
+}
+export declare function createAdapter(options: ConstructOptions, data: AdapterFactoryArgs, strict?: boolean): IBaseContract;

package/dist/types/plugins/adapters/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./AdaptersPlugin.js";
 export * from "./abi/index.js";
 export * from "./contracts/index.js";
+export * from "./createAdapter.js";
+export * from "./legacyAdapterOperations.js";
+export * from "./transferHelpers.js";
 export * from "./types.js";

package/dist/types/plugins/adapters/legacyAdapterOperations.d.ts

@@ -0,0 +1,200 @@
+import type { Address } from "viem";
+/**
+ * Signed token balance changes for a credit account within a single Execute boundary.
+ * Negative values = outflow, positive values = inflow.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go
+ */
+export type Transfers = Record<Address, bigint>;
+/**
+ * A token address paired with an amount.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L50-L53
+ */
+export interface TokenAmount {
+    token: Address;
+    amount: string;
+}
+/**
+ * A simple swap: one token in, one token out.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L119-L124
+ */
+export interface BasicSwapCall {
+    from: Address;
+    fromAmount: string;
+    to: Address;
+    toAmount: string;
+}
+/** Default swap fallback for adapters without a specific override. */
+export interface Swap extends BasicSwapCall {
+    operation: "Swap";
+}
+/**
+ * Uniswap V2/V3/V4 swap.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L132
+ */
+export interface UniswapSwap extends BasicSwapCall {
+    operation: "UniswapSwap";
+}
+/**
+ * Balancer V2/V3 swap.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L106-L125
+ */
+export interface BalancerSwap extends BasicSwapCall {
+    operation: "BalancerSwap";
+}
+/**
+ * Curve pool exchange (any `exchange`* function).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L138
+ */
+export interface CurveExchange extends BasicSwapCall {
+    operation: "CurveExchange";
+}
+/**
+ * Curve remove liquidity to a single coin.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L139-L144
+ */
+export interface CurveRemoveLiquidityOneCoin extends BasicSwapCall {
+    operation: "CurveRemoveLiquidityOneCoin";
+}
+/**
+ * Curve add liquidity (multi-coin deposit into pool).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L154-L164
+ */
+export interface CurveAddLiquidity {
+    operation: "CurveAddLiquidity";
+    addedLiquidity: TokenAmount[];
+    lpToken: Address;
+    lpAmount: string;
+}
+/**
+ * Curve remove liquidity (multi-coin withdrawal from pool).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L145-L153
+ */
+export interface CurveRemoveLiquidity {
+    operation: "CurveRemoveLiquidity";
+    tokenReceived: TokenAmount[];
+    lpToken: Address;
+    lpAmount: string;
+}
+/**
+ * Curve reward claims (e.g. `withdrawAll(bool)` on BaseRewardPool).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L20-L23
+ */
+export interface CurveClaims {
+    operation: "CurveClaims";
+    claims: TokenAmount[];
+}
+/**
+ * Curve/Convex booster withdrawal.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L25
+ */
+export interface CurveWithdrawal extends BasicSwapCall {
+    operation: "CurveWithdrawal";
+}
+/**
+ * Convex deposit + stake in one operation.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L134-L138
+ */
+export interface ConvexDepositAndStake {
+    operation: "ConvexDepositAndStake";
+    depositToken: Address;
+    depositAmount: string;
+}
+/**
+ * Convex deposit without staking.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L139
+ */
+export interface ConvexDeposit extends BasicSwapCall {
+    operation: "ConvexDeposit";
+}
+/**
+ * Convex unstake/withdraw without claiming rewards.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L140-L144
+ */
+export interface ConvexWithdraw {
+    operation: "ConvexWithdraw";
+    withdrawToken: Address;
+    withdrawAmount: string;
+}
+/**
+ * Convex withdraw + claim rewards in one operation.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L145-L148
+ */
+export interface ConvexWithdrawAndClaim {
+    operation: "ConvexWithdrawAndClaim";
+    rewards: TokenAmount[];
+}
+/**
+ * Convex stake (phantom token accounting).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L149-L152
+ */
+export interface ConvexStake {
+    operation: "ConvexStake";
+    stakedToken: TokenAmount;
+}
+/**
+ * Reward claim from Convex BaseRewardPool or similar.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L214-L226
+ */
+export interface GetReward {
+    operation: "GetReward";
+    rewards: TokenAmount[];
+}
+/**
+ * Wrap stETH -> wstETH.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L171
+ */
+export interface WstETHWrap extends BasicSwapCall {
+    operation: "WstETHWrap";
+}
+/**
+ * Unwrap wstETH -> stETH.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L170
+ */
+export interface WstETHUnwrap extends BasicSwapCall {
+    operation: "WstETHUnwrap";
+}
+/**
+ * Lido ETH -> stETH submit.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L172
+ */
+export interface LidoSubmit extends BasicSwapCall {
+    operation: "LidoSubmit";
+}
+/**
+ * ERC4626 / generic vault deposit.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L51-L56
+ */
+export interface VaultDeposit extends BasicSwapCall {
+    operation: "VaultDeposit";
+}
+/**
+ * ERC4626 / sDAI redeem.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L130
+ */
+export interface MakerRedeem extends BasicSwapCall {
+    operation: "MakerRedeem";
+}
+/**
+ * Deposit to vault / protocol where only the outflow (from CA) is visible.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L240-L245
+ */
+export interface MakerDeposit {
+    operation: "MakerDeposit";
+    token: Address;
+    amount: string;
+}
+/**
+ * Withdraw collateral from credit account (only inflow visible).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L162-L171
+ */
+export interface WithdrawCollateral {
+    operation: "WithdrawCollateral";
+    token: Address;
+    amount: string;
+}
+/**
+ * Union of all adapter-produced operation types.
+ * Discriminated on the `operation` field.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go
+ */
+export type LegacyAdapterOperation = Swap | UniswapSwap | BalancerSwap | CurveExchange | CurveRemoveLiquidityOneCoin | CurveAddLiquidity | CurveRemoveLiquidity | CurveClaims | CurveWithdrawal | ConvexDepositAndStake | ConvexDeposit | ConvexWithdraw | ConvexWithdrawAndClaim | ConvexStake | GetReward | WstETHWrap | WstETHUnwrap | LidoSubmit | VaultDeposit | MakerRedeem | MakerDeposit | WithdrawCollateral;

package/dist/types/plugins/adapters/transferHelpers.d.ts

@@ -0,0 +1,60 @@
+import { type Address } from "viem";
+import type { BasicSwapCall, CurveAddLiquidity, CurveRemoveLiquidity, LegacyAdapterOperation, TokenAmount, Transfers } from "./legacyAdapterOperations.js";
+import type { TokenTransfer } from "./types.js";
+/**
+ * Converts an ordered array of {@link TokenTransfer} into net signed balance
+ * changes ({@link Transfers}) for the given credit account.
+ */
+export declare function toNetTransfers(transfers: TokenTransfer[], creditAccount: Address): Transfers;
+/**
+ * Extracts the bare function name from a Solidity signature.
+ * `"redeemDiff(uint256)"` → `"redeemDiff"`, `"getReward()"` → `"getReward"`
+ */
+export declare function fnSigToName(signature: string): string;
+/**
+ * Splits signed transfer map into positive (inflows) and negative (outflows, stored as absolute values).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L274-L289 — Go `parsePosNegAmount`
+ */
+export declare function parsePosNegAmount(transfers: Transfers): {
+    pos: TokenAmount[];
+    neg: TokenAmount[];
+};
+/**
+ * Parses transfers into a basic swap (one token in, one token out).
+ * Expects at most 1 positive and 1 negative entry.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L306-L321 — Go `SwapParse`
+ */
+export declare function swapFromTransfers(transfers: Transfers): BasicSwapCall;
+/**
+ * Returns all positive-balance entries as reward token amounts.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L214-L226 — Go `getReward` handler
+ */
+export declare function rewardsFromTransfers(transfers: Transfers): TokenAmount[];
+/**
+ * Returns all transfer entries as token amounts (absolute values).
+ * Used for ConvexWithdrawAndClaim where all transfers (including withdrawals) are reported.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L250-L261
+ */
+export declare function allTransfersAsTokenAmounts(transfers: Transfers): TokenAmount[];
+/**
+ * Parses transfers into a CurveAddLiquidity operation.
+ * Negative entries are the added liquidity tokens, the single positive entry is the LP token received.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L154-L164
+ */
+export declare function curveAddLiquidityFromTransfers(transfers: Transfers): CurveAddLiquidity;
+/**
+ * Parses transfers into a CurveRemoveLiquidity operation.
+ * Positive entries are the received tokens, the single negative entry is the LP token burned.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L145-L153
+ */
+export declare function curveRemoveLiquidityFromTransfers(transfers: Transfers): CurveRemoveLiquidity;
+/**
+ * Shared classification logic for Curve adapter operations.
+ * Uses {@link fnSigToName} to strip parameter types so matching works with both
+ * bare names (`"exchange"`) and full signatures (`"exchange(int128,int128,uint256,uint256)"`).
+ * Also handles `_diff_` adapter variants (e.g. `remove_diff_liquidity_one_coin`).
+ *
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L39-L104
+ */
+export declare function classifyCurveOperation(functionName: string, transfers: Transfers): LegacyAdapterOperation | undefined;

package/dist/types/plugins/adapters/types.d.ts

@@ -1,4 +1,5 @@
-import type { AbiParameter } from "viem";
+import type { AbiParameter, Address } from "viem";
+import type { LegacyAdapterOperation } from "./legacyAdapterOperations.js";
 export type VersionedAbi = Record<number, readonly AbiParameter[]>;
 export type AdapterContractTypeLegacy = "AD_AAVE_V3_LENDING_POOL" | "AD_BALANCER_VAULT" | "AD_CAMELOT_V3_ROUTER" | "AD_CONVEX_L2_BOOSTER" | "AD_CONVEX_L2_REWARD_POOL" | "AD_CONVEX_V1_BASE_REWARD_POOL" | "AD_CONVEX_V1_BOOSTER" | "AD_CURVE_STABLE_NG" | "AD_CURVE_V1_2ASSETS" | "AD_CURVE_V1_3ASSETS" | "AD_CURVE_V1_4ASSETS" | "AD_CURVE_V1_EXCHANGE_ONLY" | "AD_CURVE_V1_STECRV_POOL" | "AD_CURVE_V1_WRAPPER" | "AD_DAI_USDS_EXCHANGE" | "AD_EQUALIZER_ROUTER" | "AD_ERC4626_VAULT" | "AD_LIDO_V1" | "AD_LIDO_WSTETH_V1" | "AD_MELLOW_ERC4626_VAULT" | "AD_MELLOW_LRT_VAULT" | "AD_PENDLE_ROUTER" | "AD_STAKING_REWARDS" | "AD_SYMBIOTIC_DEFAULT_COLLATERAL" | "AD_UNISWAP_V2_ROUTER" | "AD_UNISWAP_V3_ROUTER" | "AD_VELODROME_V2_ROUTER" | "AD_YEARN_V2" | "AD_ZIRCUIT_POOL";
 export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::BALANCER_VAULT" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CURVE_V1_WRAPPER" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::EQUALIZER_ROUTER" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::INFRARED_VAULT" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::KODIAK_ISLAND_GATEWAY" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_LRT_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MELLOW_DEPOSIT_QUEUE_QUEUE" | "ADAPTER::MELLOW_REDEEM_QUEUE_QUEUE" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADERJOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER" | "ADAPTER::YEARN_V2";
@@ -48,3 +49,60 @@ export declare enum AdapterType {
     VELODROME_V2_ROUTER = "VELODROME_V2_ROUTER",
     YEARN_V2 = "YEARN_V2"
 }
+/**
+ * A single ERC-20 Transfer event captured between Execute boundaries.
+ */
+export interface TokenTransfer {
+    token: Address;
+    amount: bigint;
+    from: Address;
+    to: Address;
+}
+/**
+ * Parsed adapter operation to display in credit account transactions history
+ */
+export interface AdapterOperation {
+    operation: "Execute";
+    /**
+     * Address of Gearbox Adapter contract
+     */
+    adapter: Address;
+    /**
+     * Address of protocol contract (targetContract of adapter contract)
+     */
+    protocol: Address;
+    /**
+     * Namespaced adapter type
+     * E.g. "ADAPTER::FLUID_DEX"
+     */
+    adapterType: string;
+    /**
+     * Adapter contract version
+     */
+    version: number;
+    /**
+     * Label of protocol contract (NOT adapter contract)
+     */
+    label?: string;
+    /**
+     * Function name of adapter contract
+     */
+    adapterFunctionName: string;
+    /**
+     * Arguments of adapter contract
+     */
+    adapterArgs: Record<string, unknown>;
+    /**
+     * Function name protocol called by adapter
+     */
+    protocolFunctionName: string;
+    /**
+     * Arguments of protocol called by adapter
+     */
+    protocolArgs: Record<string, unknown>;
+    /**
+     * ERC20 transfer to and from credit account made during adapter call
+     */
+    transfers: TokenTransfer[];
+    legacy: LegacyAdapterOperation;
+}

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

@@ -2,10 +2,10 @@ import type { Address } from "viem";
 import type { CreditAccountData } from "../base/index.js";
 import { SDKConstruct } from "../base/index.js";
 import type { GearboxSDK } from "../GearboxSDK.js";
-import type { OnDemandPriceUpdates, PriceUpdateV300, PriceUpdateV310, UpdatePriceFeedsResult } from "../market/index.js";
+import type { CreditSuite, MarketSuite, OnDemandPriceUpdates, PriceUpdateV300, PriceUpdateV310, UpdatePriceFeedsResult } from "../market/index.js";
 import { type Asset, type RouterCASlice } from "../router/index.js";
-import type { MultiCall } from "../types/index.js";
-import type { AccountToCheck, AddCollateralProps, ChangeDeptProps, ClaimDelayedProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, EnableTokensProps, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, OpenCAProps, PermitResult, PrepareUpdateQuotasProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, PriceUpdatesOptions, Rewards, StartDelayedWithdrawalProps, UpdateQuotasProps } from "./types.js";
+import type { IPriceUpdateTx, MultiCall, RawTx } from "../types/index.js";
+import type { AccountToCheck, AddCollateralProps, ChangeDeptProps, ClaimDelayedProps, CloseCreditAccountProps, CloseCreditAccountResult, CloseOptions, CreditAccountDataWithInvestor, CreditAccountOperationResult, EnableTokensProps, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, OpenCAProps, PermitResult, PrepareUpdateQuotasProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, PriceUpdatesOptions, Rewards, StartDelayedWithdrawalProps, UpdateQuotasProps } from "./types.js";
 export interface CreditAccountServiceOptions {
     batchSize?: number;
 }
@@ -21,6 +21,14 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @returns
      */
     getCreditAccountData(account: Address, blockNumber?: bigint): Promise<CreditAccountData | undefined>;
+    /**
+     * Returns credit account data for a single account with the investor address resolved.
+     * Loads CA via getCreditAccountData; for KYC underlyings fetches the investor from the KYC factory's getInvestor(creditAccount), otherwise uses the account owner.
+     * @param account - Credit account address
+     * @param blockNumber - Optional block number for the read
+     * @returns CreditAccountDataWithInvestor (CA data + investor address), or undefined if the account is not found
+     */
+    getCreditAccountDataWithInvestor(account: Address, blockNumber?: bigint): Promise<CreditAccountDataWithInvestor | undefined>;
     /**
      * Methods to get all credit accounts with some optional filtering
      * Performs all necessary price feed updates under the hood
@@ -29,7 +37,31 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @param blockNumber
      * @returns returned credit accounts are sorted by health factor in ascending order
      */
-    getCreditAccounts(options?: GetCreditAccountsOptions, blockNumber?: bigint): Promise<Array<CreditAccountData>>;
+    getCreditAccounts(options?: GetCreditAccountsOptions, blockNumber?: bigint, priceUpdate?: UpdatePriceFeedsResult): Promise<Array<CreditAccountData>>;
+    /**
+     * Returns all credit accounts matching the filter, with investor set on each item.
+     * Delegates to getCreditAccounts; when options.owner is set, also loads KYC credit accounts for that owner and merges them into the list. Result is sorted by health factor ascending.
+     * @param options - Filter options (owner, creditManager, health factor, etc.)
+     * @param blockNumber - Optional block number for the read
+     * @returns Array of credit accounts (with investor field), sorted by health factor ascending
+     */
+    getCreditAccountsWithInvestor(options?: GetCreditAccountsOptions, blockNumber?: bigint): Promise<Array<CreditAccountDataWithInvestor>>;
+    protected getKYCCreditAccountsOfOwner(owner: Address, priceUpdateTxs: IPriceUpdateTx<{
+        priceFeed: `0x${string}`;
+        timestamp: number;
+    }>[], blockNumber?: bigint): Promise<Array<CreditAccountDataWithInvestor>>;
+    /**
+     * Loads credit account data for the given addresses using simulateWithPriceUpdates.
+     * Applies the provided price update txs before reading, so returned data is consistent with up-to-date prices.
+     * @param accounts - Credit account addresses to load
+     * @param priceUpdateTxs - Price feed update txs to simulate before the read (e.g. from generatePriceFeedsUpdateTxs)
+     * @param blockNumber - Optional block number for the read
+     * @returns Array of CreditAccountData in the same order as accounts (throws if any getCreditAccountData call reverts)
+     */
+    loadSpecifiedAccounts(accounts: Address[], priceUpdateTxs: IPriceUpdateTx<{
+        priceFeed: `0x${string}`;
+        timestamp: number;
+    }>[], blockNumber?: bigint): Promise<Array<CreditAccountData>>;
     /**
      * Method to get all claimable rewards for credit account (ex. stkUSDS SKY rewards)
        Assosiates rewards by adapter + stakedPhantomToken
@@ -104,7 +136,7 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
         positive value for debt increase.
      * @returns All necessary data to execute the transaction (call, credit facade)
      */
-    changeDebt({ creditAccount, amount, addCollateral, }: ChangeDeptProps): Promise<CreditAccountOperationResult>;
+    changeDebt({ creditAccount, amount, collateral, wrapAsset, }: ChangeDeptProps): Promise<CreditAccountOperationResult>;
     /**
      * Executes swap specified by given calls, update quotas of affected tokens
        - Swap is executed in the following order: price update -> execute swap path -> update quotas
@@ -149,31 +181,25 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @returns All necessary data to execute the transaction (call, credit facade)
      */
     enableTokens({ enabledTokens, disabledTokens, creditAccount: ca, }: EnableTokensProps): Promise<CreditAccountOperationResult>;
+    /**
+     * Returns address to which approval should be given on collateral token
+     * It's credit manager for classical markets and special wallet for KYC markets
+     * @param options - {@link GetApprovalAddressProps}
+     * @returns
+     **/
+    getApprovalAddress(options: GetApprovalAddressProps): Promise<Address>;
     /**
      * Executes swap specified by given calls, update quotas of affected tokens
-       - Open credit account is executed in the following order: price update -> increase debt -> add collateral ->
-        -> update quotas -> (optionally: execute swap path for trading/strategy) ->
-        -> (optionally: withdraw debt for lending)
-      - Basic open credit account: price update -> increase debt -> add collateral -> update quotas
-      - Lending: price update -> increase debt -> add collateral -> update quotas -> withdraw debt
-      - Strategy/trading: price update -> increase debt -> add collateral -> update quotas -> execute swap path
-      - In strategy is possible situation when collateral is added, but not swapped; the only swapped value in this case will be debt
-     * @param {bigint} ethAmount - native token amount to attach to tx
-     * @param {Address} creditManager - address of credit manager to open credit account on
-     * @param {Array<Asset>} collateral - array of collateral which can be just directly added or swapped using the path {@link Asset}
-     * @param {Record<Address, PermitResult>} permits - permits of collateral tokens (in any permittable token is present) {@link PermitResult}
-     * @param {bigint} debt - debt to open credit account with
-     * @param {boolean} withdrawDebt - flag to withdraw debt to wallet after opening credit account;
-        used for borrowing functionality
-     * @param {bigint} referralCode - referral code to open credit account with
-     * @param {Address} to - wallet address to transfer credit account to\
-     * @param {Array<MultiCall>} calls - array of MultiCall from router methods findOpenStrategyPath {@link MultiCall}.
-        Used for trading and strategy functionality
-     * @param {Array<Asset>} averageQuota - average quota for tokens after open {@link Asset}
-     * @param {Array<Asset>} minQuota - minimum quota for tokens after open  {@link Asset}
+     * - Open credit account is executed in the following order: price update -> increase debt -> add collateral ->
+     *  -> update quotas -> (optionally: execute swap path for trading/strategy) ->
+     *  -> (optionally: withdraw debt for lending)
+     *- Basic open credit account: price update -> increase debt -> add collateral -> update quotas
+     *- Lending: price update -> increase debt -> add collateral -> update quotas -> withdraw debt
+     *- Strategy/trading: price update -> increase debt -> add collateral -> update quotas -> execute swap path
+     *- In strategy is possible situation when collateral is added, but not swapped; the only swapped value in this case will be debt
      * @returns All necessary data to execute the transaction (call, credit facade)
-     */
-    openCA({ ethAmount, creditManager, collateral, permits, debt, withdrawDebt, referralCode, to, calls: openPathCalls, minQuota, averageQuota, }: OpenCAProps): Promise<CreditAccountOperationResult>;
+     **/
+    openCA(props: OpenCAProps): Promise<CreditAccountOperationResult>;
     /**
      * Returns borrow rate with 4 digits precision (10000 = 100%)
      * @param ca
@@ -185,6 +211,42 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @param ca
      */
     getOptimalHFForPartialLiquidation(ca: CreditAccountData): bigint;
+    /**
+     * Returns multicall entries to redeem (unwrap) KYC ERC-4626 vault shares into underlying for the given credit manager.
+     * Used when withdrawing debt from a KYC market: redeems adapter vault shares so the underlying can be withdrawn.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Number of vault shares (adapter tokens) to redeem
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getKYCUnwrapCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
+    /**
+     * Returns multicall entries to deposit (wrap) underlying into KYC ERC-4626 vault shares for the given credit manager.
+     * Used when adding debt on a KYC market: deposits underlying into the adapter vault so shares are minted on the account.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Amount of underlying assets to deposit into the vault (in underlying decimals)
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getKYCWrapCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
+    /**
+     * Returns multicall entries to call redeemDiff on the KYC ERC-4626 adapter for the given credit manager.
+     * Redeems the leftover vault shares (e.g. after repaying debt) so the account does not hold excess KYC vault tokens.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Leftover vault share amount to redeem (in adapter/vault decimals)
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getRedeemDiffCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
+    /**
+     * Returns multicall entries to call depositDiff on the KYC ERC-4626 adapter for the given credit manager.
+     * Deposits the leftover underlying (e.g. after decreasing debt) into the vault so the account does not hold excess underlying.
+     * Only applies when the credit manager's underlying is KYC-gated and has an ERC-4626 adapter configured.
+     * @param amount - Leftover underlying amount to deposit into the vault (in underlying decimals)
+     * @param creditManager - Credit manager address
+     * @returns Array of MultiCall to pass to credit facade multicall, or undefined if underlying is not KYC or no adapter is configured
+     */
+    getDepositDiffCalls(amount: bigint, creditManager: Address): Promise<Array<MultiCall> | undefined>;
     /**
      * Returns raw txs that are needed to update all price feeds so that all credit accounts (possibly from different markets) compute
      *
@@ -222,4 +284,38 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
     private get marketConfigurators();
     private get rewardCompressor();
     private get peripheryCompressor();
+    /**
+     * Wrapper that selects between credit facade and KYC factory
+     * @param suite
+     * @param to
+     * @param calls
+     * @param referralCode
+     * @returns
+     */
+    protected openCreditAccountTx(suite: CreditSuite, to: Address, calls: MultiCall[], referralCode?: bigint): Promise<RawTx>;
+    /**
+     * Wrapper that selects between credit facade and KYC factory
+     * @param suite
+     * @param creditAccount
+     * @param calls
+     * @returns
+     */
+    protected multicallTx(suite: CreditSuite, creditAccount: Address, calls: MultiCall[]): Promise<RawTx>;
+    /**
+     * Wrapper that selects between credit facade and KYC factory
+     * @param suite
+     * @param creditAccount
+     * @param calls
+     * @param operation
+     * @returns
+     */
+    protected closeCreditAccountTx(suite: CreditSuite, creditAccount: Address, calls: MultiCall[], operation: CloseOptions): Promise<RawTx>;
+    /**
+     * Returns all KYC credit account addresses for an investor across the given market suites.
+     * Resolves KYC factory per suite, then multicalls each factory's getCreditAccounts(investor).
+     * @param investor - Owner address to query
+     * @param suites - Market suites (KYC factories are resolved for each; undefined entries are skipped)
+     * @returns Flat array of credit account addresses from all KYC markets
+     */
+    protected getKYCCaOfInvestor(investor: Address, suites: Array<MarketSuite | undefined>): Promise<`0x${string}`[]>;
 }

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

@@ -12,7 +12,7 @@ export declare class CreditAccountServiceV310 extends AbstractCreditAccountServi
     /**
      * Implements {@link ICreditAccountsService.repayCreditAccount}
      */
-    repayCreditAccount({ operation, collateralAssets, assetsToWithdraw, creditAccount: ca, permits, to, tokensToClaim, }: RepayCreditAccountProps): Promise<CreditAccountOperationResult>;
+    repayCreditAccount({ operation, collateralAssets, assetsToWithdraw, creditAccount: ca, permits, to, tokensToClaim, calls: wrapCalls, }: RepayCreditAccountProps): Promise<CreditAccountOperationResult>;
     /**
      * Implements {@link ICreditAccountsService.repayAndLiquidateCreditAccount}
      */