@gearbox-protocol/sdk 14.11.2 → 14.12.0-next.1

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

@@ -0,0 +1,24 @@
+import type { Address, PublicClient } from "viem";
+/**
+ * Address is stable, contract deployed via create2
+ */
+export declare const ONCHAIN_EXECUTION_ID_ADDRESS: Address;
+export type VerifyTestnetParams = {
+    executionId: string;
+} | {
+    alias: string;
+} | {
+    executionId: string;
+    alias: string;
+};
+/**
+ * Tries to read the contract that is deployed on every Gearbox testnet
+ * and verify that we're on expected testnet.
+ *
+ * Used to check that wallet is using correct RPC for the testnet.
+ *
+ * @param client - Public client
+ * @param expected - Expected tesnet alias or execution id
+ * @returns True if we're on expected testnet
+ */
+export declare function verifyTestnet(client: PublicClient, expected: VerifyTestnetParams): Promise<boolean>;

package/dist/types/history/assembleOperations.d.ts

@@ -1,11 +1,16 @@
 import type { Address } from "viem";
+import type { TokenTransfer } from "../preview/parse/index.js";
+import { type FacadeParsedCall, type WithdrawCollateralEventInfo } from "../preview/trace/index.js";
 import type { AddressMap, ChainContractsRegister } from "../sdk/index.js";
-import type { WithdrawCollateralEventInfo } from "./extractTransfers.js";
-import type { ExecuteResult, FacadeParsedCall } from "./internal-types.js";
-import type { FacadeOperationMetadata, OuterFacadeOperation } from "./types.js";
+import type { HistoryFacadeMetadata, OuterFacadeOperation } from "./types.js";
 export interface AssembleOperationsInput {
     facadeCalls: FacadeParsedCall[];
-    executeResults: ExecuteResult[];
+    /**
+     * ERC-20 transfers grouped per facade `Execute` event, one inner array per
+     * Execute event across the whole transaction, in emission order. Sliced per
+     * facade call and consumed one inner array per adapter/unknown inner call.
+     */
+    executeTransfers: TokenTransfer[][];
     register: ChainContractsRegister;
     underlying: Address;
     liquidationRemainingFunds?: bigint;
@@ -17,8 +22,8 @@ export interface AssembleOperationsInput {
  * Combines parsed facade calls with per-Execute transfer data into
  * fully classified {@link OuterFacadeOperation} entries.
  *
- * The flat `executeResults` array (one entry per Execute event across
+ * The flat `executeTransfers` array (one inner array per Execute event across
  * the entire transaction) is sliced per facade call based on how many
  * adapter/unknown inner calls each one contains.
  */
-export declare function assembleOperations(input: AssembleOperationsInput): Omit<OuterFacadeOperation, keyof FacadeOperationMetadata>[];
+export declare function assembleOperations(input: AssembleOperationsInput): Omit<OuterFacadeOperation, keyof HistoryFacadeMetadata>[];

package/dist/types/history/classifyMulticallOperations.d.ts

@@ -1,12 +1,23 @@
-import { type Address, type Hex } from "viem";
+import { type Address } from "viem";
+import type { CallTrace } from "../common-utils/utils/trace.js";
+import type { TokenTransfer } from "../preview/parse/index.js";
+import { type WithdrawCollateralEventInfo } from "../preview/trace/index.js";
 import type { AddressMap, ChainContractsRegister, ParsedCallV2 } from "../sdk/index.js";
-import type { WithdrawCollateralEventInfo } from "./extractTransfers.js";
-import type { InnerOperation } from "./inner-operations.js";
-import type { ExecuteResult } from "./internal-types.js";
+import type { InnerOperation } from "./types.js";
 export interface ClassifyMulticallOperationsInput {
     innerCalls: ParsedCallV2[];
-    executeResults: ExecuteResult[];
-    protocolCalldatas: Hex[];
+    /**
+     * ERC-20 transfers grouped per facade `Execute` event for this facade call,
+     * one inner array per Execute event, in order. One inner array is consumed
+     * per adapter/unknown inner call.
+     */
+    executeTransfers: TokenTransfer[][];
+    /**
+     * Adapter-level call traces (one per Execute event, in order) used to recover
+     * the protocol-level call for adapter inner calls. See
+     * `extractAdapterCallTraces`.
+     */
+    adapterTraces: CallTrace[];
     register: ChainContractsRegister;
     creditAccount: Address;
     underlying: Address;
@@ -17,9 +28,10 @@ export interface ClassifyMulticallOperationsInput {
 /**
  * Classifies each multicall inner call into a {@link InnerOperation}:
  *
- * - **Adapter calls** (target registered as an adapter): delegates to
- *   `adapter.parseAdapterOperation()` and consumes the next entry from
- *   `executeTransfers` (one Execute event per adapter call).
+ * - **Adapter calls** (target registered as an adapter): decodes the
+ *   protocol-level call via `adapter.parseProtocolCall()`, classifies the
+ *   legacy operation via `adapter.classifyLegacyOperation()`, and consumes the
+ *   next entry from `executeTransfers` (one Execute event per adapter call).
  *
  * - **Facade self-calls** (`increaseDebt`, `updateQuota`, etc.): mapped
  *   directly from `functionName` / `rawArgs`. No transfer consumed.

package/dist/types/history/index.d.ts

@@ -1,4 +1,3 @@
-export * from "./inner-operations.js";
 export * from "./mapOperations.js";
 export { parseCreditAccountTransaction } from "./parseCreditAccountTransaction.js";
 export * from "./populateContractsRegister.js";

package/dist/types/history/mapOperations.d.ts

@@ -1,18 +1,16 @@
-import type { AdapterOperation } from "../plugins/adapters/index.js";
-import type { AddCollateralOp, DecreaseDebtOp, IncreaseDebtOp, UpdateQuotaOp, WithdrawCollateralOp } from "./inner-operations.js";
-import type { CloseCreditAccountOperation, CreditAccountOperation, DirectTokenTransferOperation, FacadeOperationMetadata, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, PartialLiquidationOperation } from "./types.js";
+import type { AdapterOperation, AddCollateralOp, CloseCreditAccountOperation, CreditAccountOperation, DecreaseDebtOp, DirectTokenTransferOperation, HistoryFacadeMetadata, IncreaseDebtOp, LiquidateCreditAccountOperation, MulticallOperation, OpenCreditAccountOperation, PartialLiquidationOperation, UpdateQuotaOp, WithdrawCollateralOp } from "./types.js";
 /**
  * Visitor that maps each operation node in a {@link CreditAccountOperation}
  * tree to a new representation.
  *
  */
 export interface OperationVisitor<TInner, TOuter> {
-    Execute(op: AdapterOperation, ctx: FacadeOperationMetadata): TInner;
-    IncreaseBorrowedAmount(op: IncreaseDebtOp, ctx: FacadeOperationMetadata): TInner;
-    DecreaseBorrowedAmount(op: DecreaseDebtOp, ctx: FacadeOperationMetadata): TInner;
-    AddCollateral(op: AddCollateralOp, ctx: FacadeOperationMetadata): TInner;
-    WithdrawCollateral(op: WithdrawCollateralOp, ctx: FacadeOperationMetadata): TInner;
-    UpdateQuota(op: UpdateQuotaOp, ctx: FacadeOperationMetadata): TInner;
+    Execute(op: AdapterOperation, ctx: HistoryFacadeMetadata): TInner;
+    IncreaseBorrowedAmount(op: IncreaseDebtOp, ctx: HistoryFacadeMetadata): TInner;
+    DecreaseBorrowedAmount(op: DecreaseDebtOp, ctx: HistoryFacadeMetadata): TInner;
+    AddCollateral(op: AddCollateralOp, ctx: HistoryFacadeMetadata): TInner;
+    WithdrawCollateral(op: WithdrawCollateralOp, ctx: HistoryFacadeMetadata): TInner;
+    UpdateQuota(op: UpdateQuotaOp, ctx: HistoryFacadeMetadata): TInner;
     DirectTokenTransfer(op: DirectTokenTransferOperation): TOuter;
     MultiCall(op: MulticallOperation, multicall: TInner[]): TOuter;
     OpenCreditAccount(op: OpenCreditAccountOperation, multicall: TInner[]): TOuter;

package/dist/types/history/types.d.ts

@@ -1,77 +1,28 @@
-import type { Address, Hex } from "viem";
-import type { InnerOperation } from "./inner-operations.js";
+import type { LegacyAdapterOperation } from "../plugins/adapters/index.js";
+import type { AdapterOperation as BaseAdapterOperation, CloseCreditAccountOperation as BaseCloseCreditAccountOperation, DirectTokenTransferOperation as BaseDirectTokenTransferOperation, InnerOperation as BaseInnerOperation, LiquidateCreditAccountOperation as BaseLiquidateCreditAccountOperation, MulticallOperation as BaseMulticallOperation, OpenCreditAccountOperation as BaseOpenCreditAccountOperation, PartialLiquidationOperation as BasePartialLiquidationOperation, FacadeOperationMetadata, OperationMetadata, TraceAdapterExt } from "../preview/parse/index.js";
+export type { AddCollateralOp, DecreaseDebtOp, FacadeOperationMetadata, IncreaseDebtOp, InnerFacadeOperation, OperationMetadata, UpdateQuotaOp, WithdrawCollateralOp, } from "../preview/parse/index.js";
 /**
- * An ERC-20 Transfer into or out of the credit account that was not part of
- * any facade operation (multicall, liquidation, etc.).
- *
- * `from`/`to` are the raw transfer endpoints: an inbound transfer (manual
- * top-up / deposit) has `to` == the credit account, an outbound transfer
- * (direct withdrawal) has `from` == the credit account.
+ * History-specific adapter-operation extension: trace-derived data
+ * ({@link TraceAdapterExt}) plus the backward-compatible `legacy` classification
+ * used by charts_server serialization. The `legacy` field lives only in
+ * `history`; the base `preview` operations carry no `legacy`.
  */
-export interface DirectTransferInfo {
-    token: Address;
-    from: Address;
-    to: Address;
-    amount: bigint;
-}
-export interface OperationMetadata {
-    txHash: Hex;
-    blockNumber: number;
-    timestamp: number;
-}
-export interface FacadeOperationMetadata extends OperationMetadata {
-    creditManager: Address;
-    creditFacade: Address;
-}
-export interface MulticallOperation extends FacadeOperationMetadata {
-    operation: "MultiCall" | "BotMulticall";
-    creditAccount: Address;
-    multicall: InnerOperation[];
-}
-export interface OpenCreditAccountOperation extends FacadeOperationMetadata {
-    operation: "OpenCreditAccount";
-    creditAccount: Address;
-    onBehalfOf: Address;
-    referralCode: bigint;
-    multicall: InnerOperation[];
-}
-export interface CloseCreditAccountOperation extends FacadeOperationMetadata {
-    operation: "CloseCreditAccount";
-    creditAccount: Address;
-    multicall: InnerOperation[];
-}
-export interface LiquidateCreditAccountOperation extends FacadeOperationMetadata {
-    operation: "LiquidateCreditAccount";
-    creditAccount: Address;
-    to: Address;
-    token: Address;
-    remainingFunds: bigint;
-    multicall: InnerOperation[];
-}
-export interface PartialLiquidationOperation extends FacadeOperationMetadata {
-    operation: "PartiallyLiquidateCreditAccount";
-    creditAccount: Address;
-    token: Address;
-    repaidAmount: bigint;
-    minSeizedAmount: bigint;
-    to: Address;
-}
-export interface DirectTokenTransferOperation extends OperationMetadata {
-    operation: "DirectTokenTransfer";
-    protocol: Address;
-    token: Address;
-    from: Address;
-    to: Address;
-    creditAccount: Address;
-    amount: bigint;
-}
+export type HistoryAdapterExt = TraceAdapterExt & {
+    legacy: LegacyAdapterOperation;
+};
 /**
- * Discriminated union of all facade-level operation types.
- * One per facade entry-point call within a transaction.
+ * Facade context available in `history` mode: the base facade metadata
+ * (`creditManager`/`creditFacade`) plus the transaction-level
+ * {@link OperationMetadata} that is only known once the transaction is mined.
  */
+export type HistoryFacadeMetadata = FacadeOperationMetadata & OperationMetadata;
+export type AdapterOperation = BaseAdapterOperation<HistoryAdapterExt>;
+export type InnerOperation = BaseInnerOperation<HistoryAdapterExt>;
+export type MulticallOperation = Omit<BaseMulticallOperation<HistoryAdapterExt>, "expectedBalanceChanges"> & OperationMetadata;
+export type OpenCreditAccountOperation = Omit<BaseOpenCreditAccountOperation<HistoryAdapterExt>, "expectedBalanceChanges"> & OperationMetadata;
+export type CloseCreditAccountOperation = Omit<BaseCloseCreditAccountOperation<HistoryAdapterExt>, "expectedBalanceChanges"> & OperationMetadata;
+export type LiquidateCreditAccountOperation = Omit<BaseLiquidateCreditAccountOperation<HistoryAdapterExt>, "expectedBalanceChanges"> & OperationMetadata;
+export type PartialLiquidationOperation = BasePartialLiquidationOperation & OperationMetadata;
+export type DirectTokenTransferOperation = BaseDirectTokenTransferOperation & OperationMetadata;
 export type OuterFacadeOperation = MulticallOperation | OpenCreditAccountOperation | CloseCreditAccountOperation | LiquidateCreditAccountOperation | PartialLiquidationOperation;
-/**
- * Discriminated union of all credit account operation types
- * (facade operations + direct token transfers).
- */
 export type CreditAccountOperation = OuterFacadeOperation | DirectTokenTransferOperation;

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

@@ -1,8 +1,9 @@
-import { type Abi, type Address, type Hex, type PartialBy } from "viem";
+import { type Abi, type Address } from "viem";
+import { type CallTrace } from "../../../common-utils/utils/trace.js";
 import type { ConstructOptions, ParsedCallV2, RelaxedBaseParams } from "../../../sdk/index.js";
 import { BaseContract } from "../../../sdk/index.js";
 import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
-import type { AdapterContractStateHuman, AdapterContractType, AdapterOperation, TokenTransfer } from "../types.js";
+import type { AdapterContractStateHuman, AdapterContractType, AdapterProtocolOperation } from "../types.js";
 export interface ConcreteAdapterContractOptions {
     baseParams: RelaxedBaseParams;
 }
@@ -22,23 +23,19 @@ export declare class AbstractAdapterContract<const abi extends Abi | readonly un
     get adapterType(): AdapterContractType;
     stateHuman(raw?: boolean): AdapterContractStateHuman;
     /**
-     * Builds an {@link AdapterOperation} from a parsed call and ordered transfer entries.
+     * Decodes the protocol-level call (target contract + function name + args)
+     * performed by this adapter, recovered from its adapter-level call trace.
      *
-     * Returns `PartialBy<AdapterOperation, "targetContract">` because the adapter
-     * may not have `targetContract` (adapters created without SDK do not have serializedParams)
+     * Both the `targetContract` and the protocol calldata are taken from the
+     * execution trace.
      *
-     * @param protocolCalldata Raw calldata of the actual CALL to targetContract, extracted from trace
-     * @param strict When true, throws if protocol ABI is missing or decode fails
-     */
-    parseAdapterOperation(parsed: ParsedCallV2, transfers: TokenTransfer[], creditAccount: Address, protocolCalldata: Hex, strict?: boolean): PartialBy<AdapterOperation, "protocol">;
-    /**
-     * Decodes protocol-level function name and args from the raw calldata
-     * sent to targetContract.
+     * Returns `undefined` (in non-strict mode) when no external protocol call can
+     * be recovered, in strict mode throws instead.
+     *
+     * @param trace Adapter-level call trace (a direct child of the facade trace)
+     * @param strict When true, throws instead of returning `undefined`
      */
-    protected parseProtocolCall(calldata: Hex, strict?: boolean): {
-        protocolFunctionName: string;
-        protocolArgs: Record<string, unknown>;
-    };
+    parseProtocolCall(trace: CallTrace, strict?: boolean): AdapterProtocolOperation | undefined;
     /**
      * Classifies an adapter call into a {@link LegacyAdapterOperation} using the
      * parsed call and credit-account transfer deltas.
@@ -50,6 +47,8 @@ export declare class AbstractAdapterContract<const abi extends Abi | readonly un
      * Override in protocol-specific subclasses for richer classification.
      *
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L238-L264
+     *
+     * @deprecated Eventually will be gone, exists to produce output that legacy UI can display
      */
-    protected classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }

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

@@ -1,5 +1,7 @@
+import type { CallTrace } from "../../../common-utils/utils/trace.js";
 import type { ConstructOptions, ParsedCallV2 } from "../../../sdk/index.js";
 import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
+import type { AdapterProtocolOperation } from "../types.js";
 import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
@@ -467,6 +469,13 @@ type protocolAbi = typeof protocolAbi;
 export declare class AccountMigratorAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
     constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
     /** Legacy adapter not present in integrations-v3. */
-    protected classifyLegacyOperation(_parsed: ParsedCallV2, _transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(_parsed: ParsedCallV2, _transfers: Transfers): LegacyAdapterOperation;
+    /**
+     * The account-migrator adapter's `execute` targets the migrator bot, not an
+     * external protocol, so there is no protocol-level call to recover. Returning
+     * `undefined` keeps the `protocol` field aligned with its external-protocol
+     * semantics (see {@link TraceAdapterExt}).
+     */
+    parseProtocolCall(_trace: CallTrace, _strict?: boolean): AdapterProtocolOperation | undefined;
 }
 export {};

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

@@ -689,6 +689,6 @@ export declare class ConvexV1BaseRewardPoolAdapterContract extends AbstractAdapt
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L200-L262
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L76-L83
      */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -420,6 +420,6 @@ export declare class ConvexV1BoosterAdapterContract extends AbstractAdapterContr
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L166-L199
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L84-L91
      */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1776,6 +1776,6 @@ export declare class Curve2AssetsAdapterContract extends AbstractAdapterContract
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1776,6 +1776,6 @@ export declare class Curve3AssetsAdapterContract extends AbstractAdapterContract
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1776,6 +1776,6 @@ export declare class Curve4AssetsAdapterContract extends AbstractAdapterContract
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1040,6 +1040,6 @@ export declare class CurveV1AdapterDeposit extends AbstractAdapterContract<abi,
     get tokens(): [Address, Address, Address, Address];
     get underlyings(): [Address, Address, Address, Address];
     /** Legacy adapter not present in integrations-v3. Go: Curve operations via operation_type.go L132-L164 */
-    protected classifyLegacyOperation(_parsed: ParsedCallV2, _transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(_parsed: ParsedCallV2, _transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1763,6 +1763,6 @@ export declare class CurveV1AdapterStETHContract extends AbstractAdapterContract
     get use256(): boolean;
     get tokens(): [Address, Address];
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1746,6 +1746,6 @@ export declare class CurveV1StableNGAdapterContract extends AbstractAdapterContr
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -204,6 +204,6 @@ export declare class DaiUsdsAdapterContract extends AbstractAdapterContract<abi,
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L51-L68 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -671,6 +671,6 @@ export declare class ERC4626AdapterContract extends AbstractAdapterContract<abi,
      *
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L32-L38
      */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -298,6 +298,6 @@ export declare class ERC4626ReferralAdapterContract extends AbstractAdapterContr
     /**
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L32-L38
      */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -213,6 +213,6 @@ export declare class LidoV1AdapterContract extends AbstractAdapterContract<abi,
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L277-L282 */
-    protected classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -709,6 +709,6 @@ export declare class MellowDVVAdapterContract extends AbstractAdapterContract<ab
     /**
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L32-L38
      */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -676,6 +676,6 @@ export declare class MellowERC4626VaultAdapterContract extends AbstractAdapterCo
      *
      * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L32-L38
      */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -964,6 +964,6 @@ export declare class UniswapV2AdapterContract extends AbstractAdapterContract<ab
     };
     protected stringifyFunctionParams(params: DecodeFunctionDataReturnType<abi>): string[];
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L81-L91 */
-    protected classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -420,6 +420,6 @@ export declare class UniswapV4AdapterContract extends AbstractAdapterContract<ab
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L81-L91 */
-    protected classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -392,6 +392,6 @@ export declare class WstETHV1AdapterContract extends AbstractAdapterContract<abi
         contractType?: string;
     };
     /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L264-L275 */
-    protected classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
+    classifyLegacyOperation(parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

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

@@ -1,6 +1,6 @@
 import { type Address } from "viem";
 import type { BasicSwapCall, CurveAddLiquidity, CurveRemoveLiquidity, LegacyAdapterOperation, TokenAmount, Transfers } from "./legacyAdapterOperations.js";
-import type { TokenTransfer } from "./types.js";
+import type { TokenTransfer } from "./transfers.js";
 /**
  * Converts an ordered array of {@link TokenTransfer} into net signed balance
  * changes ({@link Transfers}) for the given credit account.

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

@@ -0,0 +1,17 @@
+import type { Address } from "viem";
+/**
+ * A single ERC-20 Transfer event captured between Execute boundaries.
+ *
+ * Internal to `plugins/adapters` (kept here so {@link toNetTransfers} stays
+ * typed) and intentionally **not** re-exported from the package barrel: the
+ * canonical, public `TokenTransfer` lives in the `preview` module. The two are
+ * structurally identical, so values flow between the modules without casts.
+ *
+ * @deprecated Will be deprecated when we get rid of classifyLegacyOperation
+ */
+export interface TokenTransfer {
+    token: Address;
+    amount: bigint;
+    from: Address;
+    to: Address;
+}

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

@@ -1,6 +1,5 @@
 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 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::SECURITIZE_ONRAMP" | "ADAPTER::SECURITIZE_REDEMPTION" | "ADAPTER::SECURITIZE_SWAP" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADER_JOE_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 {
@@ -57,59 +56,22 @@ export interface AdapterContractStateHuman extends BaseContractStateHuman {
     targetContract?: string;
 }
 /**
- * A single ERC-20 Transfer event captured between Execute boundaries.
+ * Protocol-level call performed by an adapter: the target (protocol) contract
+ * together with the decoded function name and arguments of the actual CALL the
+ * adapter made to it. Recovered from an execution trace, so it is only present
+ * when a trace is available (history, facade simulation).
  */
-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;
+export interface AdapterProtocolOperation {
     /**
      * 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>;
+    contract: Address;
     /**
      * Function name protocol called by adapter
      */
-    protocolFunctionName: string;
+    functionName: 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;
+    functionArgs: Record<string, unknown>;
 }

package/dist/types/preview/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./parse/index.js";
+export * from "./prerequisites/index.js";
+export * from "./simulate/index.js";
+export * from "./trace/index.js";

package/dist/types/preview/parse/classifyInnerOperations.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from "viem";
+import type { OnchainSDK, ParsedCallV2 } from "../../sdk/index.js";
+import type { InnerOperation } from "./types.js";
+export interface ClassifyInnerOperationsProps {
+    sdk: OnchainSDK;
+    /** Underlying token of the credit manager, used for debt operations. */
+    underlying: Address;
+}
+/**
+ * Calldata-only counterpart of the SDK's `classifyMulticallOperations`.
+ *
+ * Maps each inner multicall entry to an {@link InnerOperation}:
+ * - adapter and unknown targets become a pure-descriptor `Execute`
+ *   {@link AdapterOperation};
+ * - credit-facade self-calls map to the matching inner facade operation.
+ *
+ * Raw calldata has no execution trace, so the trace-derived adapter data
+ * (`protocol`, `transfers`) and `legacy` are intentionally absent; they are only
+ * recovered by trace-based flows (history, facade simulation).
+ */
+export declare function classifyInnerOperations(calls: ParsedCallV2[], props: ClassifyInnerOperationsProps): InnerOperation[];

package/dist/types/preview/parse/errors.d.ts

@@ -0,0 +1,17 @@
+import type { Address } from "viem";
+/**
+ * Thrown when the target of a transaction is neither a known Gearbox pool nor a
+ * credit facade.
+ */
+export declare class UnsupportedTargetError extends Error {
+    readonly target: Address;
+    constructor(target: Address);
+}
+/**
+ * Thrown when a pool call uses a function other than ERC4626 `deposit`/`redeem`.
+ */
+export declare class UnsupportedPoolFunctionError extends Error {
+    readonly pool: Address;
+    readonly functionName: string;
+    constructor(pool: Address, functionName: string);
+}