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

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);
+}

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

@@ -0,0 +1,7 @@
+export * from "./classifyInnerOperations.js";
+export * from "./errors.js";
+export * from "./extractExpectedBalanceChanges.js";
+export * from "./parseFacadeOperationCalldata.js";
+export * from "./parseOperationCalldata.js";
+export * from "./parsePoolOperationCalldata.js";
+export * from "./types.js";

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

@@ -0,0 +1,19 @@
+import { type Hex } from "viem";
+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. */
+    facade: CreditFacadeV310Contract;
+    calldata: Hex;
+}
+/**
+ * Decodes a credit-facade entry-point call into the matching
+ * {@link OuterFacadeOperation}.
+ *
+ * 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/parseOperationCalldata.d.ts

@@ -0,0 +1,23 @@
+import type { Address, Hex } from "viem";
+import { type PluginsMap } from "../../sdk/index.js";
+import type { Operation, SdkWithAdapters } from "./types.js";
+export interface ParseOperationCalldataInput<P extends PluginsMap = PluginsMap> {
+    /**
+     * Already-attached SDK; chain, RPC and block are baked in at attach time.
+     * Must be created with the adapters plugin (enforced at compile time) so
+     * adapter contracts resolve during multicall classification.
+     */
+    sdk: SdkWithAdapters<P>;
+    to: Address;
+    calldata: Hex;
+    /** Transaction sender, contextual only. */
+    sender: Address;
+}
+/**
+ * Decodes raw operation calldata into an {@link Operation}.
+ *
+ * Routes by the resolved contract at `to`: a pool yields a deposit/redeem
+ * operation, a credit facade yields one facade operation. Anything else throws
+ * {@link UnsupportedTargetError}.
+ */
+export declare function parseOperationCalldata<P extends PluginsMap>(input: ParseOperationCalldataInput<P>): Operation;

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

@@ -0,0 +1,17 @@
+import type { Hex } from "viem";
+import type { OnchainSDK, PoolV310Contract } from "../../sdk/index.js";
+import type { PoolOperation } from "./types.js";
+export interface ParsePoolOperationCalldataProps {
+    sdk: OnchainSDK;
+    /** Resolved pool contract for the transaction target. */
+    pool: PoolV310Contract;
+    calldata: Hex;
+}
+/**
+ * Decodes ERC4626 pool calldata into a {@link PoolOperation}. Supports every
+ * deposit/mint/withdraw/redeem variant of `IPoolV3` (and the `IERC4626` base it
+ * extends): `deposit`/`depositWithReferral`, `mint`/`mintWithReferral`,
+ * `withdraw` and `redeem`. Any other selector throws
+ * {@link UnsupportedPoolFunctionError}.
+ */
+export declare function parsePoolOperationCalldata(props: ParsePoolOperationCalldataProps): PoolOperation;

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[];
+}

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

@@ -0,0 +1,158 @@
+import type { Address, Hex } from "viem";
+import type { AdapterOperation } from "./types-adapters.js";
+/**
+ * Increase debt (borrow more).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L149-L154
+ */
+export interface IncreaseDebtOp {
+    operation: "IncreaseBorrowedAmount";
+    token: Address;
+    amount: bigint;
+}
+/**
+ * Decrease debt (repay).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L155-L161
+ */
+export interface DecreaseDebtOp {
+    operation: "DecreaseBorrowedAmount";
+    token: Address;
+    amount: bigint;
+}
+/**
+ * Add collateral to credit account.
+ */
+export interface AddCollateralOp {
+    operation: "AddCollateral";
+    token: Address;
+    amount: bigint;
+}
+/**
+ * Withdraw collateral from credit account.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L162-L171
+ */
+export interface WithdrawCollateralOp {
+    operation: "WithdrawCollateral";
+    token: Address;
+    amount: bigint;
+    to: Address;
+    phantomToken?: Address;
+}
+/**
+ * Update token quota on credit account.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L172-L178
+ */
+export interface UpdateQuotaOp {
+    operation: "UpdateQuota";
+    token: Address;
+    change: bigint;
+}
+/**
+ * Union of facade inner-call operation types (non-adapter credit account operations).
+ * Discriminated on the `operation` field.
+ */
+export type InnerFacadeOperation = IncreaseDebtOp | DecreaseDebtOp | AddCollateralOp | WithdrawCollateralOp | UpdateQuotaOp;
+/**
+ * All operations that can happen within a CreditFacade's multicall and that we're interested in.
+ *
+ * Generic over the adapter-operation extension `Ext` (see {@link AdapterOperation}).
+ */
+export type InnerOperation<Ext extends object = {}> = AdapterOperation<Ext> | InnerFacadeOperation;
+/**
+ * Transaction-level metadata available only when parsing a mined transaction
+ * (the `history` mode). It is intentionally absent from base `preview`
+ * operations, which describe not-yet-mined calls where these values are unknown.
+ */
+export interface OperationMetadata {
+    txHash: Hex;
+    blockNumber: number;
+    timestamp: number;
+}
+export interface FacadeOperationMetadata {
+    creditManager: Address;
+    creditFacade: Address;
+}
+/**
+ * Signed token balance delta recovered from a router-generated
+ * `storeExpectedBalances` call (the `BalanceDelta` struct). `amount` is the
+ * signed `int256` delta, so it may be negative.
+ */
+export interface ExpectedBalanceChange {
+    token: Address;
+    delta: bigint;
+}
+export interface MulticallOperation<Ext extends object = {}> extends FacadeOperationMetadata {
+    operation: "MultiCall" | "BotMulticall";
+    creditAccount: Address;
+    multicall: InnerOperation<Ext>[];
+    /**
+     * Potential balance changes declared by a router-generated
+     * `storeExpectedBalances`/`compareBalances` pair, or `undefined` when the
+     * multicall is not router-shaped. See {@link ExpectedBalanceChange}.
+     */
+    expectedBalanceChanges?: ExpectedBalanceChange[];
+}
+export interface OpenCreditAccountOperation<Ext extends object = {}> extends FacadeOperationMetadata {
+    operation: "OpenCreditAccount";
+    creditAccount: Address;
+    onBehalfOf: Address;
+    referralCode: bigint;
+    multicall: InnerOperation<Ext>[];
+    /**
+     * Potential balance changes declared by a router-generated
+     * `storeExpectedBalances`/`compareBalances` pair, or `undefined` when the
+     * multicall is not router-shaped. See {@link ExpectedBalanceChange}.
+     */
+    expectedBalanceChanges?: ExpectedBalanceChange[];
+}
+export interface CloseCreditAccountOperation<Ext extends object = {}> extends FacadeOperationMetadata {
+    operation: "CloseCreditAccount";
+    creditAccount: Address;
+    multicall: InnerOperation<Ext>[];
+    /**
+     * Potential balance changes declared by a router-generated
+     * `storeExpectedBalances`/`compareBalances` pair, or `undefined` when the
+     * multicall is not router-shaped. See {@link ExpectedBalanceChange}.
+     */
+    expectedBalanceChanges?: ExpectedBalanceChange[];
+}
+export interface LiquidateCreditAccountOperation<Ext extends object = {}> extends FacadeOperationMetadata {
+    operation: "LiquidateCreditAccount";
+    creditAccount: Address;
+    to: Address;
+    token: Address;
+    remainingFunds: bigint;
+    multicall: InnerOperation<Ext>[];
+    /**
+     * Potential balance changes declared by a router-generated
+     * `storeExpectedBalances`/`compareBalances` pair, or `undefined` when the
+     * multicall is not router-shaped. See {@link ExpectedBalanceChange}.
+     */
+    expectedBalanceChanges?: ExpectedBalanceChange[];
+}
+export interface PartialLiquidationOperation extends FacadeOperationMetadata {
+    operation: "PartiallyLiquidateCreditAccount";
+    creditAccount: Address;
+    token: Address;
+    repaidAmount: bigint;
+    minSeizedAmount: bigint;
+    to: Address;
+}
+export interface DirectTokenTransferOperation {
+    operation: "DirectTokenTransfer";
+    protocol: Address;
+    token: Address;
+    from: Address;
+    to: Address;
+    creditAccount: Address;
+    amount: bigint;
+}
+/**
+ * Discriminated union of all facade-level operation types.
+ * One per facade entry-point call within a transaction.
+ */
+export type OuterFacadeOperation<Ext extends object = {}> = MulticallOperation<Ext> | OpenCreditAccountOperation<Ext> | CloseCreditAccountOperation<Ext> | LiquidateCreditAccountOperation<Ext> | PartialLiquidationOperation;
+/**
+ * Discriminated union of all credit account operation types
+ * (facade operations + direct token transfers).
+ */
+export type CreditAccountOperation<Ext extends object = {}> = OuterFacadeOperation<Ext> | DirectTokenTransferOperation;

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

@@ -0,0 +1,55 @@
+import type { Address } from "viem";
+/**
+ * ERC4626 `deposit` into a Gearbox pool.
+ */
+export interface PoolDepositOperation {
+    operation: "Deposit";
+    pool: Address;
+    receiver: Address;
+    /** Underlying assets supplied to the pool. */
+    assets: bigint;
+    underlying: Address;
+    /** Referral code, present only for `depositWithReferral` calls. */
+    referralCode?: bigint;
+}
+/**
+ * ERC4626 `mint` into a Gearbox pool. Unlike `deposit`, the caller specifies the
+ * amount of shares to mint; the assets pulled are resolved by the pool.
+ */
+export interface PoolMintOperation {
+    operation: "Mint";
+    pool: Address;
+    receiver: Address;
+    /** Pool shares (diesel) minted to the receiver. */
+    shares: bigint;
+    underlying: Address;
+    /** Referral code, present only for `mintWithReferral` calls. */
+    referralCode?: bigint;
+}
+/**
+ * ERC4626 `withdraw` from a Gearbox pool. Unlike `redeem`, the caller specifies
+ * the amount of underlying assets to withdraw; the shares burned are resolved by
+ * the pool.
+ */
+export interface PoolWithdrawOperation {
+    operation: "Withdraw";
+    pool: Address;
+    receiver: Address;
+    owner: Address;
+    /** Underlying assets withdrawn to the receiver. */
+    assets: bigint;
+    underlying: Address;
+}
+/**
+ * ERC4626 `redeem` from a Gearbox pool.
+ */
+export interface PoolRedeemOperation {
+    operation: "Redeem";
+    pool: Address;
+    receiver: Address;
+    owner: Address;
+    /** Pool shares (diesel) burned. */
+    shares: bigint;
+    underlying: Address;
+}
+export type PoolOperation = PoolDepositOperation | PoolMintOperation | PoolWithdrawOperation | PoolRedeemOperation;

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

@@ -0,0 +1,44 @@
+import type { AdaptersPlugin } from "../../plugins/adapters/index.js";
+import type { OnchainSDK, PluginsMap } from "../../sdk/index.js";
+import type { OuterFacadeOperation } from "./types-facades.js";
+import type { PoolOperation } from "./types-pools.js";
+export * from "./types-adapters.js";
+export * from "./types-facades.js";
+export * from "./types-pools.js";
+/**
+ * True when the plugin map `P` contains the {@link AdaptersPlugin} under any
+ * key. Matched nominally (the plugin's private fields make it non-structural),
+ * so unrelated plugins never satisfy it.
+ */
+export type HasAdaptersPlugin<P extends PluginsMap> = Extract<P[keyof P], AdaptersPlugin> extends never ? false : true;
+/**
+ * Compile-time guard for the adapters plugin. Resolves to a no-op (`unknown`)
+ * when `P` includes the {@link AdaptersPlugin}, otherwise to an error-shaped
+ * type that makes the surrounding call fail to type-check.
+ *
+ * Intended to be intersected with a function argument so callers must pass an
+ * SDK whose adapter contracts are registered (required for multicall
+ * classification).
+ */
+export type RequireAdaptersPlugin<P extends PluginsMap> = HasAdaptersPlugin<P> extends true ? unknown : {
+    "OnchainSDK must be created with the AdaptersPlugin": never;
+};
+/**
+ * {@link OnchainSDK} whose plugin map is guaranteed at compile time to include
+ * the {@link AdaptersPlugin}.
+ */
+export type SdkWithAdapters<P extends PluginsMap = PluginsMap> = OnchainSDK<P> & RequireAdaptersPlugin<P>;
+/**
+ * Result of decoding a single raw operation calldata: either a pool
+ * deposit/redeem or one of the credit-facade operations.
+ *
+ * Calldata-only parse produces base (descriptor) adapter operations, so the
+ * facade operations are used with the default `Ext = {}`.
+ */
+export type Operation = PoolOperation | OuterFacadeOperation;
+/**
+ * Narrows an {@link Operation} to a {@link PoolOperation} (deposit, mint,
+ * withdraw or redeem). Used by the UI to decide whether a custom view exists for
+ * the parsed result; everything else falls back to the raw JSON view.
+ */
+export declare function isPoolOperation(tx: Operation): tx is PoolOperation;