@gearbox-protocol/sdk 12.8.1 → 12.9.0-txparser.2

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,65 @@ export declare enum AdapterType {
     VELODROME_V2_ROUTER = "VELODROME_V2_ROUTER",
     YEARN_V2 = "YEARN_V2"
 }
+export interface TokenInfo {
+    address: Address;
+    symbol: string;
+    decimals: number;
+}
+/**
+ * A single ERC-20 Transfer event captured between Execute boundaries.
+ */
+export interface TokenTransfer<TToken = Address> {
+    token: TToken;
+    amount: bigint;
+    from: Address;
+    to: Address;
+}
+/**
+ * Parsed adapter operation to display in credit account transactions history
+ */
+export interface AdapterOperation<TToken = Address> {
+    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<TToken>[];
+    legacy: LegacyAdapterOperation;
+}

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

@@ -2,7 +2,7 @@ import type { Abi, Address, Chain, ContractEventName, ContractFunctionName, Deco
 import { BaseError, type ContractEventArgs, type GetContractEventsReturnType } 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;
@@ -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,7 +3,7 @@ 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;
@@ -55,4 +55,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/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,5 +1,5 @@
 import type { Address, Chain, PublicClient, Transport } from "viem";
-import { type PhantomTokenContractType } from "../index.js";
+import type { PhantomTokenContractType } from "../constants/index.js";
 import type { Asset } from "../router/index.js";
 import { AddressMap } from "../utils/index.js";
 import type { TokenMetaData } from "./types.js";

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,6 +1,7 @@
 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";

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;
 }
@@ -50,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
@@ -90,4 +116,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/market/adapters/PlaceholderAdapterContracts.d.ts

@@ -1,9 +1,14 @@
 import type { Address } from "viem";
-import type { AdapterData } from "../../base/index.js";
+import type { ConstructOptions } from "../../base/index.js";
 import { PlaceholderContract } from "../../base/index.js";
-import type { GearboxSDK } from "../../GearboxSDK.js";
+import type { RelaxedBaseParams } from "../../index.js";
 import type { IAdapterContract } from "./types.js";
+export interface PlaceholderAdapterContractOptions {
+    baseParams: RelaxedBaseParams;
+    targetContract?: Address;
+}
 export declare class PlaceholderAdapterContract extends PlaceholderContract implements IAdapterContract {
-    readonly targetContract: Address;
-    constructor(sdk: GearboxSDK, args: AdapterData);
+    #private;
+    constructor(options: ConstructOptions, args: PlaceholderAdapterContractOptions);
+    get targetContract(): Address;
 }

package/dist/types/sdk/market/adapters/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./factory.js";
+export * from "./createAdapter.js";
 export * from "./PlaceholderAdapterContracts.js";
 export * from "./types.js";