@gearbox-protocol/sdk 14.11.0-next.4 → 14.11.0-next.6

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,71 +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 to the credit account that was not part of any
- * facade operation (multicall, liquidation, etc.).
+ * 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;
-    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;
-    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

@@ -1,3 +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

@@ -1,6 +1,6 @@
-import { type Address } from "viem";
-import type { InnerOperation } from "../../history/index.js";
+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. */
@@ -10,12 +10,12 @@ export interface ClassifyInnerOperationsProps {
  * Calldata-only counterpart of the SDK's `classifyMulticallOperations`.
  *
  * Maps each inner multicall entry to an {@link InnerOperation}:
- * - adapter targets become an `Execute` {@link AdapterOperation};
- * - credit-facade self-calls map to the matching inner facade operation;
- * - unknown targets fall back to a generic `Execute`.
+ * - adapter and unknown targets become a pure-descriptor `Execute`
+ *   {@link AdapterOperation};
+ * - credit-facade self-calls map to the matching inner facade operation.
  *
- * Since raw calldata has no execution trace, `transfers` is always empty and
- * `legacy` is a zeroed placeholder; protocol-level fields mirror the adapter
- * call.
+ * 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/extractExpectedBalanceChanges.d.ts

@@ -0,0 +1,22 @@
+import type { ParsedCallV2 } from "../../sdk/index.js";
+import type { ExpectedBalanceChange } from "./types.js";
+/**
+ * Recovers the potential balance changes declared by a router-generated
+ * `storeExpectedBalances`/`compareBalances` pair inside a credit-facade
+ * multicall.
+ *
+ * The detection is intentionally limited to the router shape:
+ * - `onDemandPriceUpdates` calls are dropped first (they may only appear at the
+ *   front of a multicall);
+ * - the remaining calls must start with `storeExpectedBalances` and end with
+ *   `compareBalances`.
+ *
+ * When the multicall does not match this shape, `undefined` is returned. On a
+ * match, the `BalanceDelta[]` argument of `storeExpectedBalances` is decoded
+ * into {@link ExpectedBalanceChange}[] (the `amount` is the signed `int256`
+ * delta and may be negative).
+ *
+ * @param innerCalls - Raw (already-decoded) inner multicall calls.
+ * @returns The declared balance changes, or `undefined` when not router-shaped.
+ */
+export declare function extractExpectedBalanceChanges(innerCalls: ParsedCallV2[]): ExpectedBalanceChange[] | undefined;

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

@@ -1,5 +1,6 @@
 export * from "./classifyInnerOperations.js";
 export * from "./errors.js";
+export * from "./extractExpectedBalanceChanges.js";
 export * from "./parseFacadeOperationCalldata.js";
 export * from "./parseOperationCalldata.js";
 export * from "./parsePoolOperationCalldata.js";

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

@@ -1,6 +1,6 @@
 import { type Hex } from "viem";
-import type { OuterFacadeOperation } from "../../history/index.js";
 import type { CreditFacadeV310Contract, OnchainSDK } from "../../sdk/index.js";
+import type { OuterFacadeOperation } from "./types.js";
 export interface ParseFacadeOperationCalldataProps {
     sdk: OnchainSDK;
     /** Resolved credit facade contract for the transaction target. */
@@ -11,8 +11,9 @@ export interface ParseFacadeOperationCalldataProps {
  * Decodes a credit-facade entry-point call into the matching
  * {@link OuterFacadeOperation}.
  *
- * Metadata is partial: `txHash` is `zeroHash` and `timestamp` is `0` because
- * those are only known once the transaction is mined. `creditAccount` is
+ * Transaction-level metadata (`txHash`, `blockNumber`, `timestamp`) is not part
+ * of the base `preview` operation: those values are only known once the
+ * transaction is mined and are added in `history` mode. `creditAccount` is
  * `zeroAddress` for `openCreditAccount` (the address is assigned on-chain).
  */
 export declare function parseFacadeOperationCalldata(props: ParseFacadeOperationCalldataProps): OuterFacadeOperation;

package/dist/types/preview/parse/types-adapters.d.ts

@@ -0,0 +1,69 @@
+import type { Address } from "viem";
+import type { AdapterProtocolOperation } from "../../plugins/adapters/index.js";
+/**
+ * A single ERC-20 Transfer event captured between Execute boundaries.
+ *
+ * Canonical, public definition owned by the `preview` module; `plugins/adapters`
+ * keeps a structurally identical internal copy for its legacy helpers.
+ */
+export interface TokenTransfer {
+    token: Address;
+    amount: bigint;
+    from: Address;
+    to: Address;
+}
+/**
+ * Pure adapter-call descriptor: everything that can be recovered without an
+ * execution trace (from raw calldata alone).
+ */
+export interface AdapterOperationBase {
+    operation: "Execute";
+    /**
+     * Address of Gearbox Adapter contract
+     */
+    adapter: 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>;
+}
+/**
+ * Adapter `Execute` operation, generic over the extra data added by consumers.
+ *
+ * - calldata-only parse uses `Ext = {}` (pure descriptor);
+ * - trace-based flows (history, facade simulation) use {@link TraceAdapterExt};
+ * - history additionally intersects `{ legacy: LegacyAdapterOperation }`.
+ */
+export type AdapterOperation<Ext extends object = {}> = AdapterOperationBase & Ext;
+/**
+ * Trace-derived adapter data: the protocol-level call and the ERC-20 transfers
+ * made during the adapter call. Both are only available from an execution
+ * trace, so they always travel together.
+ *
+ * `protocol` is optional: it is absent when no external protocol call was
+ * recovered for the adapter `Execute`. This happens for the account-migrator
+ * adapter (its `execute` targets the migrator bot, not an external protocol),
+ * for unknown adapters in non-strict mode (no ABI to decode against), and when
+ * the protocol calldata cannot be decoded.
+ */
+export interface TraceAdapterExt {
+    protocol?: AdapterProtocolOperation;
+    transfers: TokenTransfer[];
+}