@gearbox-protocol/sdk 13.0.0-next.9 → 13.0.1

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

@@ -1,6 +1,7 @@
-import type { AbiParameter } from "viem";
+import type { AbiParameter, Address } from "viem";
+import type { BaseContractStateHuman } from "../../sdk/types/state-human.js";
+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";
 export declare enum AdapterType {
     ACCOUNT_MIGRATOR = "ACCOUNT_MIGRATOR",
@@ -48,3 +49,64 @@ export declare enum AdapterType {
     VELODROME_V2_ROUTER = "VELODROME_V2_ROUTER",
     YEARN_V2 = "YEARN_V2"
 }
+export interface AdapterContractStateHuman extends BaseContractStateHuman {
+    creditManager?: string;
+    targetContract?: string;
+}
+/**
+ * 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/plugins/bots/abi/index.d.ts

@@ -1,2 +1 @@
-export * from "./iPartialLiquidationBotV300.js";
 export * from "./iPartialLiquidationBotV310.js";

package/dist/types/plugins/zappers/ZappersPlugin.d.ts

@@ -0,0 +1,18 @@
+import type { Address } from "viem";
+import type { IGearboxSDKPlugin } from "../../sdk/index.js";
+import { AddressMap, BasePlugin } from "../../sdk/index.js";
+import type { ZapperDataFull, ZapperStateHuman } from "./types.js";
+export interface ZappersPluginState {
+    zappers: Record<Address, ZapperDataFull[]>;
+}
+export declare class ZappersPlugin extends BasePlugin<ZappersPluginState> implements IGearboxSDKPlugin<ZappersPluginState> {
+    #private;
+    constructor(extraZappers?: ZapperDataFull[], loadOnAttach?: boolean);
+    load(force?: boolean): Promise<ZappersPluginState>;
+    get extraZappers(): AddressMap<ZapperDataFull[]>;
+    get zappers(): AddressMap<ZapperDataFull[]>;
+    get loaded(): boolean;
+    stateHuman(_?: boolean): ZapperStateHuman[];
+    get state(): ZappersPluginState;
+    hydrate(state: ZappersPluginState): void;
+}

package/dist/types/plugins/zappers/extraZappers.d.ts

@@ -0,0 +1,6 @@
+import type { NetworkType } from "../../sdk/index.js";
+import type { ZapperDataFull } from "./types.js";
+/**
+ * Temporary zappers
+ */
+export declare const extraZappers: Partial<Record<NetworkType, ZapperDataFull[]>>;

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

@@ -0,0 +1,3 @@
+export * from "./extraZappers.js";
+export * from "./types.js";
+export * from "./ZappersPlugin.js";

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

@@ -0,0 +1,12 @@
+import type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from "abitype";
+import type { Address } from "viem";
+import type { peripheryCompressorAbi } from "../../abi/compressors/peripheryCompressor.js";
+import type { BaseContractStateHuman, Unarray } from "../../sdk/index.js";
+export type ZapperData = Unarray<AbiParametersToPrimitiveTypes<ExtractAbiFunction<typeof peripheryCompressorAbi, "getZappers">["outputs"]>>;
+export interface ZapperDataFull extends ZapperData {
+    pool: Address;
+}
+export interface ZapperStateHuman extends BaseContractStateHuman {
+    tokenIn: string;
+    tokenOut: string;
+}

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

@@ -6,7 +6,6 @@ import { ChainContractsRegister } from "./base/index.js";
 import type { GearboxChain, NetworkType } from "./chain/chains.js";
 import type { VersionRange } from "./constants/index.js";
 import type { IAddressProviderContract } from "./core/index.js";
-import { BotListContract, GearStakingContract } from "./core/index.js";
 import { MarketRegister } from "./market/MarketRegister.js";
 import { PriceFeedRegister } from "./market/pricefeeds/index.js";
 import type { SDKOptions } from "./options.js";
@@ -102,8 +101,6 @@ export declare class GearboxSDK<const Plugins extends PluginsMap = {}> extends C
     get priceFeeds(): PriceFeedRegister;
     get gear(): Address | undefined;
     get addressProvider(): IAddressProviderContract;
-    get botListContract(): BotListContract | undefined;
-    get gearStakingContract(): GearStakingContract | undefined;
     get marketRegister(): MarketRegister;
     /**
      * Returns router contract that will work for given credit manager or credit facade, or simply version range

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 { OnDemandPriceUpdates, 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 { AccountToCheck, AddCollateralProps, ChangeDeptProps, ClaimDelayedProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, OpenCAProps, PermitResult, PrepareUpdateQuotasProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, PriceUpdatesOptions, Rewards, StartDelayedWithdrawalProps, UpdateQuotasProps } from "./types.js";
 export interface CreditAccountServiceOptions {
     batchSize?: number;
 }
@@ -141,14 +141,6 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @returns
     */
     claimDelayed({ creditAccount, minQuota, averageQuota, claimableNow, }: ClaimDelayedProps): Promise<CreditAccountOperationResult>;
-    /**
-     * Executes enable/disable tokens specified by given tokens lists and token prices
-     * @param {RouterCASlice} creditAccount - minimal credit account data {@link RouterCASlice} on which operation is performed
-     * @param {Array<Asset>} enabledTokens - list of tokens to enable {@link Asset};
-     * @param {Array<Asset>} disabledTokens - list of tokens to disable {@link Asset};
-     * @returns All necessary data to execute the transaction (call, credit facade)
-     */
-    enableTokens({ enabledTokens, disabledTokens, creditAccount: ca, }: EnableTokensProps): Promise<CreditAccountOperationResult>;
     /**
      * 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 ->
@@ -199,7 +191,7 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
      * @param options
      * @returns
      */
-    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<OnDemandPriceUpdates<PriceUpdateV310 | PriceUpdateV300>>;
+    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<OnDemandPriceUpdates>;
     /**
      * Returns price updates in format that is accepted by various credit facade methods (multicall, close/liquidate, etc...).
      * - If there are desiredQuotas and creditAccount update quotaBalance > 0 || (balance > 10n && isEnabled). Is used when account has both: balances and quota buys.
@@ -212,8 +204,6 @@ export declare abstract class AbstractCreditAccountService extends SDKConstruct
     protected prepareDisableQuotas(ca: RouterCASlice): Array<MultiCall>;
     protected prepareUpdateQuotas(creditFacade: Address, { averageQuota, minQuota }: PrepareUpdateQuotasProps): Array<MultiCall>;
     protected prepareDecreaseDebt(ca: RouterCASlice): Array<MultiCall>;
-    protected prepareDisableTokens(ca: RouterCASlice): Array<MultiCall>;
-    protected prepareDisableToken(creditFacade: Address, token: Address): MultiCall;
     protected prepareWithdrawToken(creditFacade: Address, token: Address, amount: bigint, to: Address): MultiCall;
     protected prepareAddCollateral(creditFacade: Address, assets: Array<Asset>, permits: Record<string, PermitResult>): Array<MultiCall>;
     /**

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

@@ -20,7 +20,7 @@ export declare class CreditAccountServiceV310 extends AbstractCreditAccountServi
     /**
      * Implements {@link ICreditAccountsService.claimFarmRewards}
      */
-    claimFarmRewards({ calls: legacyCalls, creditAccount: ca, minQuota, averageQuota, tokensToClaim, forceCalls, }: ClaimFarmRewardsProps): Promise<CreditAccountOperationResult>;
+    claimFarmRewards({ calls: externalCalls, creditAccount: ca, minQuota, averageQuota, tokensToClaim, }: ClaimFarmRewardsProps): Promise<CreditAccountOperationResult>;
     previewWithdrawLlamathenaProportionally(_: PreviewWithdrawLlamathenaProportionallyProps): Promise<PreviewWithdrawLlamathenaProportionallyResult>;
     withdrawLlamathenaProportionally(_: LlamathenaProportionalWithdrawProps): Promise<CreditAccountOperationResult>;
 }

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

@@ -3,7 +3,7 @@ import type { CreditAccountServiceOptions } from "./AbstractCreditAccountsServic
 import type { ICreditAccountsService } from "./types.js";
 /**
  * @sdk
- * @version version of desired credit facade; if no credit facade is considered (you only want to get ca list), either v300 or v310 is fine, because ca compressor has nothing to do with credit facade version
+ * @version version of desired credit facade
  * @returns
  */
 export declare function createCreditAccountService(sdk: GearboxSDK, version: number, options?: CreditAccountServiceOptions): ICreditAccountsService;

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

@@ -1,5 +1,4 @@
 export * from "./AbstractCreditAccountsService.js";
-export * from "./CreditAccountsServiceV300.js";
 export * from "./CreditAccountsServiceV310.js";
 export * from "./createCreditAccountService.js";
 export * from "./types.js";

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

@@ -3,7 +3,7 @@ import type { creditAccountCompressorAbi } from "../../abi/compressors/creditAcc
 import type { iWithdrawalCompressorV310Abi } from "../../abi/IWithdrawalCompressorV310.js";
 import type { ConnectedBotData, Construct, CreditAccountData } from "../base/index.js";
 import type { GearboxSDK } from "../GearboxSDK.js";
-import type { CreditSuite, OnDemandPriceUpdates, PriceUpdateV300, PriceUpdateV310, UpdatePriceFeedsResult } from "../market/index.js";
+import type { CreditSuite, OnDemandPriceUpdates, UpdatePriceFeedsResult } from "../market/index.js";
 import type { Asset, CreditAccountTokensSlice, RouterCASlice, RouterCloseResult } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
 export type GetCreditAccountsArgs = ContractFunctionArgs<typeof creditAccountCompressorAbi, "pure" | "view", "getCreditAccounts">;
@@ -235,29 +235,17 @@ export interface ClaimFarmRewardsProps extends PrepareUpdateQuotasProps {
     */
     tokensToDisable: Array<Asset>;
     /**
-     * Legacy property - array of MultiCall from getRewards
+     * External calls to execute instead of finding claim path
      */
-    calls: Array<MultiCall>;
+    calls: Array<MultiCall> | undefined;
     /**
      * minimal credit account data on which operation is performed
      */
     creditAccount: RouterCASlice;
-    tokensToClaim: Asset[];
-    forceCalls?: boolean;
-}
-export interface EnableTokensProps {
-    /**
-     * List of tokens to disable
-     */
-    disabledTokens: Array<Address>;
-    /**
-     * List of tokens to enable
-     */
-    enabledTokens: Array<Address>;
     /**
-     * Minimal credit account data on which operation is performed
+     * List of token rewards of which we want to claim
      */
-    creditAccount: RouterCASlice;
+    tokensToClaim: Asset[];
 }
 export interface OpenCAProps extends PrepareUpdateQuotasProps {
     /**
@@ -329,10 +317,6 @@ export interface FullyLiquidateProps {
      * 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
      */
@@ -473,7 +457,7 @@ export interface ICreditAccountsService extends Construct {
         additionalBots: Array<Omit<NonNullable<GetConnectedMigrationBotsResult>, "botAddress">>;
     }>;
     /**
-     * V3.1 method, throws in V3. Connects/disables a bot and updates prices
+     * Connects/disables a bot and updates prices
      * @param props - {@link SetBotProps}
      * @return All necessary data to execute the transaction (call, credit facade)
      */
@@ -546,12 +530,6 @@ export interface ICreditAccountsService extends Construct {
      * @returns
     */
     claimDelayed(props: ClaimDelayedProps): Promise<CreditAccountOperationResult>;
-    /**
-     * Executes enable/disable tokens specified by given tokens lists and token prices
-     * @param props - {@link EnableTokensProps}
-     * @returns All necessary data to execute the transaction (call, credit facade)
-     */
-    enableTokens(props: EnableTokensProps): Promise<CreditAccountOperationResult>;
     /**
      * 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 ->
@@ -589,7 +567,7 @@ export interface ICreditAccountsService extends Construct {
      * @param options
      * @returns
      */
-    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<OnDemandPriceUpdates<PriceUpdateV310 | PriceUpdateV300>>;
+    getOnDemandPriceUpdates(options: PriceUpdatesOptions): Promise<OnDemandPriceUpdates>;
     /**
      * Returns price updates in format that is accepted by various credit facade methods (multicall, close/liquidate, etc...).
      * @param options
@@ -608,8 +586,6 @@ export interface ICreditAccountsService extends Construct {
      * Fully repays credit account or repays credit account and keeps it open with zero debt
      * - Repays in the following order: price update -> add collateral to cover the debt ->
      *   -> disable quotas for all tokens -> decrease debt -> disable tokens all tokens -> withdraw all tokens
-     * - V3.0 claims rewards for tokens which are specified in legacy SDK
-     * - V3.1 claims rewards for all tokens IF router is also V3.1
      * @param props - {@link RepayCreditAccountProps}
      * @return All necessary data to execute the transaction (call, credit facade)
      */
@@ -618,18 +594,14 @@ export interface ICreditAccountsService extends Construct {
      * Fully repays liquidatable account
      * - Repay and liquidate is executed in the following order: price update -> add collateral to cover the debt ->
      *   withdraw all tokens from credit account
-     * - V3.0 claims rewards for tokens which are specified in legacy SDK
-     * - V3.1 claims rewards for all tokens IF router is also V3.1
      * @param props - {@link RepayAndLiquidateCreditAccountProps}
      * @return All necessary data to execute the transaction (call, credit facade)
      */
     repayAndLiquidateCreditAccount(props: RepayAndLiquidateCreditAccountProps): Promise<CreditAccountOperationResult>;
     /**
-     * Executes swap specified by given calls, update quotas of affected tokens
+     * Claims farm rewards and optionally updates quotas
      *  - Claim rewards is executed in the following order: price update -> execute claim calls ->
-     *   -> (optionally: disable reward tokens) -> (optionally: update quotas)
-     * - V3.0 claims rewards for tokens which are specified in legacy SDK
-     * - V3.1 claims rewards for all tokens IF router is also V3.1 and falls back to legacy calls if router is not v3.0
+     *   -> (optionally: update quotas)
      * @param props - {@link ClaimFarmRewardsProps}
      * @return All necessary data to execute the transaction (call, credit facade)
      */

package/dist/types/sdk/base/BaseContract.d.ts

@@ -1,8 +1,8 @@
-import type { Abi, Address, Chain, ContractEventName, ContractFunctionName, DecodeFunctionDataReturnType, EncodeFunctionDataParameters, GetContractReturnType, Hex, Log, PublicClient, Transport } from "viem";
-import { BaseError, type ContractEventArgs, type GetContractEventsReturnType } from "viem";
+import type { Abi, Address, Chain, ContractEventArgs, ContractEventName, ContractFunctionName, DecodeFunctionDataReturnType, EncodeFunctionDataParameters, GetContractEventsReturnType, GetContractReturnType, Hex, Log, PublicClient, Transport } from "viem";
+import { BaseError } from "viem";
 import type { BaseContractStateHuman, RawTx } from "../types/index.js";
 import { Construct, type ConstructOptions } from "./Construct.js";
-import type { IBaseContract, ParsedCall, ParsedCallArgs } from "./types.js";
+import type { IBaseContract, ParsedCall, ParsedCallArgs, ParsedCallV2 } from "./types.js";
 export interface BaseContractArgs<abi extends Abi | readonly unknown[]> {
     abi: abi;
     addr: Address;
@@ -28,7 +28,7 @@ export declare class BaseContract<abi extends Abi | readonly unknown[]> extends
     readonly version: number;
     readonly address: Address;
     readonly name: string;
-    constructor({ client, logger }: ConstructOptions, args: BaseContractArgs<abi>);
+    constructor(options: ConstructOptions, args: BaseContractArgs<abi>);
     stateHuman(_?: boolean): BaseContractStateHuman;
     /**
      * Updates (or not) contract's internal state from event
@@ -78,6 +78,19 @@ export declare class BaseContract<abi extends Abi | readonly unknown[]> extends
      */
     protected stringifyFunctionParams(decoded: DecodeFunctionDataReturnType<abi>): string[];
     protected wrapParseCall(functionName: string, args: Record<string, string>): ParsedCall;
+    /**
+     * Parses calldata into structured result with preserved original types.
+     * When strict is true, throws {@link ContractParseError} on unknown selectors;
+     * otherwise returns a fallback with the raw calldata.
+     */
+    parseFunctionDataV2(calldata: Hex, strict?: boolean): ParsedCallV2;
+    /**
+     * Converts viem-decoded function arguments to a record preserving original types.
+     * Override in subclasses to handle nesting (e.g., multicall inner calls).
+     * @param strict - propagated from parseFunctionDataV2 for recursive parsing
+     */
+    protected parseFunctionParamsV2(params: DecodeFunctionDataReturnType<abi>, _strict?: boolean): Record<string, unknown>;
+    protected wrapParseCallV2(functionName: string, rawArgs: Record<string, unknown>): ParsedCallV2;
     /**
      * Creates a raw transaction for a function in this contract
      * @param parameters

package/dist/types/sdk/base/ChainContractsRegister.d.ts

@@ -3,11 +3,9 @@ import type { MultiCall } from "../types/index.js";
 import type { ILogger } from "../types/logger.js";
 import type { BaseContract } from "./BaseContract.js";
 import { TokensMeta } from "./TokensMeta.js";
-import type { ParsedCall } from "./types.js";
+import type { ParsedCall, ParsedCallV2 } from "./types.js";
 export type ContractOrInterface<T> = T extends Abi | readonly unknown[] ? BaseContract<T> : T;
 export declare class ChainContractsRegister {
-    #private;
-    static for(client: PublicClient<Transport, Chain>, logger?: ILogger): ChainContractsRegister;
     private readonly contracts;
     private readonly labels;
     readonly client: PublicClient<Transport, Chain>;
@@ -55,4 +53,14 @@ export declare class ChainContractsRegister {
      * @returns
      */
     parseMultiCall(calls: MultiCall[]): ParsedCall[];
+    /**
+     * Parses calldata for a contract at the given address, preserving original types.
+     * When strict is true, throws on unknown address or selector; otherwise returns a fallback.
+     */
+    parseFunctionDataV2(address: Address, calldata: Hex, strict?: boolean): ParsedCallV2;
+    /**
+     * Parses multicalls preserving original types.
+     * When strict is true, throws on unknown targets or selectors.
+     */
+    parseMultiCallV2(calls: MultiCall[], strict?: boolean): ParsedCallV2[];
 }

package/dist/types/sdk/base/Construct.d.ts

@@ -3,16 +3,24 @@ import type { NetworkType } from "../chain/index.js";
 import type { ILogger } from "../types/index.js";
 import { ChainContractsRegister } from "./ChainContractsRegister.js";
 import type { TokensMeta } from "./TokensMeta.js";
-export interface ConstructOptions {
+export type ConstructOptions = ChainContractsRegister | {
     client: PublicClient<Transport, Chain>;
     logger?: ILogger;
-}
+} | {
+    register: ChainContractsRegister;
+    logger?: ILogger;
+};
 export declare class Construct {
     #private;
     readonly logger?: ILogger;
     readonly client: PublicClient<Transport, Chain>;
-    readonly register: ChainContractsRegister;
-    constructor({ client, logger }: ConstructOptions);
+    constructor(options: ConstructOptions);
+    /**
+     * Throws if register was not provided in constructor options
+     * Ephemeral contracts that do not need to access other contracts may not need it
+     */
+    get register(): ChainContractsRegister;
+    protected safeGetRegister(): ChainContractsRegister | undefined;
     get chain(): Chain;
     get chainId(): number;
     get networkType(): NetworkType;
@@ -21,16 +29,8 @@ export declare class Construct {
      */
     get dirty(): boolean;
     protected set dirty(value: boolean);
-    /**
-     * Syntax sugar for rgister.tokensMeta
-     */
     protected get tokensMeta(): TokensMeta;
-    /**
-     * Syntax suggar for getting contract labels
-     * @param address
-     * @returns
-     */
-    protected labelAddress(address: Address): string;
+    protected labelAddress(address: Address, omitAddress?: boolean): string;
     /**
      * Returns list of addresses that should be watched for events to sync state
      */

package/dist/types/sdk/base/PlaceholderContract.d.ts

@@ -1,9 +1,9 @@
-import type { GearboxSDK } from "../GearboxSDK.js";
 import type { BaseContractArgs } from "./BaseContract.js";
 import { BaseContract } from "./BaseContract.js";
+import type { ConstructOptions } from "./index.js";
 declare const abi: unknown[];
 type abi = typeof abi;
 export declare class PlaceholderContract extends BaseContract<abi> {
-    constructor(sdk: GearboxSDK, args: Omit<BaseContractArgs<abi>, "abi">);
+    constructor(options: ConstructOptions, args: Omit<BaseContractArgs<abi>, "abi">);
 }
 export {};

package/dist/types/sdk/base/TokensMeta.d.ts

@@ -1,33 +1,40 @@
-import { type Address, type Chain, type PublicClient, type Transport } from "viem";
+import type { Address, Chain, PublicClient, Transport } from "viem";
+import type { PhantomTokenContractType } from "../constants/index.js";
 import type { Asset } from "../router/index.js";
 import { AddressMap } from "../utils/index.js";
-import type { KYCTokenMeta, PhantomTokenMeta, TokenMetaData } from "./token-types.js";
+import type { TokenMetaData } from "./types.js";
 export interface FormatBNOptions {
     precision?: number;
     symbol?: boolean;
 }
-export declare class TokensMeta extends AddressMap<TokenMetaData> {
+export interface TokenMetaDataExtended extends TokenMetaData {
+    /**
+     * Undefined if token is not a phantom token
+     */
+    phantomTokenType?: PhantomTokenContractType;
+}
+export declare class TokensMeta extends AddressMap<TokenMetaDataExtended> {
     #private;
     constructor(client: PublicClient<Transport, Chain>);
     reset(): void;
     symbol(token: Address): string;
     decimals(token: Address): number;
-    isPhantomToken(t: TokenMetaData): t is PhantomTokenMeta;
-    isKYCUnderlying(t: TokenMetaData): t is KYCTokenMeta;
+    /**
+     * Returns the phantom token type for a given token, or undefined for normal tokens
+     * Throws if the phantom token data is not loaded
+     */
+    phantomTokenType(token: Address): PhantomTokenContractType | undefined;
     /**
      * Returns a map of all phantom tokens
      * Throws if the phantom token data is not loaded
      */
-    get phantomTokens(): AddressMap<PhantomTokenMeta>;
-    get kycUnderlyings(): AddressMap<KYCTokenMeta>;
+    get phantomTokens(): AddressMap<TokenMetaDataExtended>;
     formatBN(asset: Asset, options?: FormatBNOptions): string;
     formatBN(token: Address, amount: number | bigint | string | undefined, options?: FormatBNOptions): string;
     findBySymbol(symbol: string): TokenMetaData | undefined;
     mustFindBySymbol(symbol: string): TokenMetaData;
     /**
-     * Loads token information about phantom token and KYC underlying tokens
-     *
-     * @param tokens - tokens to load data for, defaults to all tokens
+     * Loads phantom token data for all known tokens from chain
      */
-    loadTokenData(...tokens: Address[]): Promise<void>;
+    loadPhantomTokens(): Promise<void>;
 }

package/dist/types/sdk/base/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class MissingSerializedParamsError extends Error {
+    constructor(propertyName: string);
+}

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

@@ -1,8 +1,8 @@
 export * from "./BaseContract.js";
 export * from "./ChainContractsRegister.js";
 export * from "./Construct.js";
+export * from "./errors.js";
 export * from "./PlaceholderContract.js";
 export * from "./SDKConstruct.js";
 export * from "./TokensMeta.js";
-export * from "./token-types.js";
 export * from "./types.js";

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

@@ -12,6 +12,15 @@ export interface BaseParams {
     contractType: Hex;
     serializedParams: Hex;
 }
+export interface RelaxedBaseParams {
+    addr: Address;
+    version: number | bigint;
+    /**
+     * Hex or parsed hex32 string
+     */
+    contractType: string;
+    serializedParams?: Hex;
+}
 export interface BaseState {
     baseParams: BaseParams;
 }
@@ -26,6 +35,7 @@ export type CreditManagerState = CreditSuiteState["creditManager"];
 export type CreditFacadeState = CreditSuiteState["creditFacade"];
 export type CreditConfiguratorState = CreditSuiteState["creditConfigurator"];
 export type AdapterData = Unarray<CreditSuiteState["adapters"]>;
+export type TokenMetaData = Unarray<MarketData["tokens"]>;
 export type PoolState = MarketData["pool"];
 export type QuotaKeeperState = MarketData["quotaKeeper"];
 export type QuotaState = Unarray<QuotaKeeperState["quotas"]>;
@@ -49,6 +59,23 @@ export interface ParsedCall {
     functionName: string;
     args: ParsedCallArgs;
 }
+export interface ParsedCallV2 {
+    chainId: number;
+    target: Address;
+    contractType: string;
+    label?: string;
+    version: number;
+    /**
+     * Function signature produced by viem's `toFunctionSignature`, e.g.:
+     * - `"balanceOf(address)"`
+     * - `"multicall(address,(address,bytes)[])"`
+     * - `"swap(uint256,uint256,bool)"`
+     *
+     * For unknown selectors: `"unknown function 0x1a2b3c4d"`
+     */
+    functionName: string;
+    rawArgs: Record<string, unknown>;
+}
 export interface IBaseContract {
     /**
      * Contract address
@@ -71,6 +98,11 @@ export interface IBaseContract {
      * Indicates that contract state diverged from onchain state and needs to be updated
      */
     dirty: boolean;
+    /**
+     * Human-readable contract state
+     * @param raw
+     */
+    stateHuman(raw?: boolean): unknown;
     /**
      * Return parsed args and function name from calldata belonging to this contract
      * Target of the call is always this contract, but args can be parsed into calls to other contracts (de-facto recursive ParsedCall)
@@ -89,4 +121,9 @@ export interface IBaseContract {
      * Same as {@link stringifyFunctionData}, but throws if error occurs
      **/
     mustStringifyFunctionData: (calldata: Hex) => string;
+    /**
+     * Parses calldata into structured result with preserved original types.
+     * When strict is true, throws on unknown selectors; otherwise returns a fallback.
+     **/
+    parseFunctionDataV2: (calldata: Hex, strict?: boolean) => ParsedCallV2;
 }

package/dist/types/sdk/chain/chains.d.ts

@@ -1,6 +1,6 @@
 import type { Address, Chain } from "viem";
 import { z } from "zod/v4";
-export type Curator = "Chaos Labs" | "K3" | "cp0x" | "Re7" | "Invariant Group" | "Tulipa" | "M11 Credit" | "kpk" | "Hyperithm" | "Edge UltraYield" | "TelosC" | "Gami Labs";
+export type Curator = "Chaos Labs" | "K3" | "cp0x" | "Re7" | "Invariant Group" | "Tulipa" | "M11 Credit" | "kpk" | "Hyperithm" | "UltraYield" | "TelosC" | "Gami Labs";
 export interface GearboxChain extends Chain {
     network: NetworkType;
     defaultMarketConfigurators: Record<Address, Curator>;

package/dist/types/sdk/constants/addresses.d.ts

@@ -1,5 +1,4 @@
 import type { Address } from "viem";
-import type { NetworkType } from "../chain/index.js";
 export declare const MULTICALL_ADDRESS: Address;
 /**
  * Address 0x0000000000000000000000000000000000000000
@@ -9,21 +8,3 @@ export declare const ADDRESS_0X0: Address;
  * Dummy address to satisfy `0x${string}` typecheck, but fail on `isAddress` check
  */
 export declare const NOT_DEPLOYED = "0xNOT DEPLOYED";
-/**
- * Well-known USDC token address used to determine NetworkType on testnets with different chain ids
- *
- * @deprecated TODO: delete me
- */
-/**
- * @deprecated TODO: delete me
- */
-/**
- * @deprecated TODO: delete me
- */
-export declare const TIMELOCK: Record<NetworkType, Address>;
-export declare const GEARBOX_MULTISIG: Record<NetworkType, Address>;
-export declare const GEARBOX_RISK_CURATORS: Record<NetworkType, Address[]>;
-/**
- * Depreciated pools
- */
-export declare const DEPRECIATED_POOLS: Record<NetworkType, Record<Address, string>>;

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

@@ -4,4 +4,5 @@ export * from "./bot-permissions.js";
 export * from "./math.js";
 export * from "./networks.js";
 export * from "./periphery.js";
+export * from "./phantom-tokens.js";
 export * from "./versions.js";