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

package/dist/types/{history → preview/trace}/errors.d.ts

@@ -9,16 +9,6 @@ export declare class TransferAlignmentError extends Error {
 export declare class WithdrawCollateralAlignmentError extends Error {
     constructor(expected: number, actual: number);
 }
-export declare class ProtocolCallNotFoundError extends Error {
-    readonly targetContract: Address;
-    readonly executeIndex: number;
-    constructor(targetContract: Address, executeIndex: number);
-}
-export declare class AdapterTraceAlignmentError extends Error {
-    readonly expected: number;
-    readonly actual: number;
-    constructor(expected: number, actual: number);
-}
 export declare class UnexpectedFacadeEventOrderError extends Error {
     constructor(e: {
         eventName: string;

package/dist/types/preview/trace/extractAdapterCallTraces.d.ts

@@ -0,0 +1,23 @@
+import { type CallTrace } from "../../common-utils/utils/trace.js";
+/**
+ * Extracts the user multicall's adapter-level call traces from a single facade
+ * call trace.
+ *
+ * Returns the direct children of the facade trace that perform an external
+ * protocol call (their subtree resolves to a `CreditManager.execute(bytes)`
+ * that reaches a leaf CALL to a target contract), in trace order.
+ *
+ * Scoping to direct children of the facade trace (rather than flattening the
+ * whole subtree) avoids over-counting in nested credit-manager scenarios such
+ * as account migration, where a single migrate-adapter subtree nests another
+ * account's `execute(bytes)` calls.
+ *
+ * Facade-synthesized phantom-token withdrawals are excluded: while processing
+ * `withdrawCollateral` on a phantom token the facade issues its own
+ * `withdrawPhantomToken` adapter call, which also reaches an external target
+ * but does not correspond to a user multicall inner call. These are detected
+ * via the preceding `getPhantomTokenInfo()` probe (see
+ * {@link isSynthesizedPhantomWithdrawal}), so the returned traces line up 1:1,
+ * in order, with the multicall's adapter inner calls.
+ */
+export declare function extractAdapterCallTraces(facadeTrace: CallTrace): CallTrace[];

package/dist/types/{history → preview/trace}/extractTransfers.d.ts

@@ -1,7 +1,6 @@
 import { type Address, type Log } from "viem";
-import { AddressMap } from "../sdk/index.js";
-import type { ExecuteResult } from "./internal-types.js";
-import type { DirectTransferInfo } from "./types.js";
+import { AddressMap } from "../../sdk/index.js";
+import type { TokenTransfer } from "../parse/index.js";
 type RawLog = Log<bigint | number, number, false>;
 /**
  * Effective `withdrawCollateral` outcome decoded from the facade's
@@ -25,8 +24,18 @@ export interface WithdrawCollateralEventInfo {
  * @param creditAccount - the credit account address to track
  */
 export interface ExtractTransfersResult {
-    executeResults: ExecuteResult[];
-    directTransfers: DirectTransferInfo[];
+    /**
+     * ERC-20 transfers grouped per facade `Execute` event, one inner array per
+     * Execute event across the whole transaction, in emission order. Each inner
+     * array holds the transfers to/from the credit account that occurred between
+     * that Execute boundary and the previous one.
+     */
+    executeTransfers: TokenTransfer[][];
+    /**
+     * ERC-20 transfers that are not part of a facade `Execute` event and are
+     * direct incoming transfers to the credit account.
+     */
+    directTransfers: TokenTransfer[];
     liquidationRemainingFunds?: bigint;
     /** Maps phantom token address to its deposited (underlying) token address. */
     phantomTokens: AddressMap<Address>;

package/dist/types/{history → preview/trace}/findFacadeCalls.d.ts

@@ -1,6 +1,7 @@
 import { type Address } from "viem";
-import type { ChainContractsRegister } from "../sdk/index.js";
-import type { CallTrace, FacadeParsedCall } from "./internal-types.js";
+import { type CallTrace } from "../../common-utils/utils/trace.js";
+import type { ChainContractsRegister } from "../../sdk/index.js";
+import type { FacadeParsedCall } from "./types.js";
 /**
  * Walks a `debug_traceTransaction` callTracer tree, finds all non-reverted
  * calls to the credit facade, parses them via the register, and returns

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

@@ -0,0 +1,5 @@
+export * from "./errors.js";
+export * from "./extractAdapterCallTraces.js";
+export * from "./extractTransfers.js";
+export * from "./findFacadeCalls.js";
+export * from "./types.js";

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

@@ -0,0 +1,21 @@
+import type { Address } from "viem";
+import type { CallTrace } from "../../common-utils/utils/trace.js";
+import type { ParsedCallV2 } from "../../sdk/index.js";
+/**
+ * The set of credit facade entry-point functions that produce history operations.
+ */
+export type FacadeCallType = "MultiCall" | "BotMulticall" | "OpenCreditAccount" | "CloseCreditAccount" | "LiquidateCreditAccount" | "PartiallyLiquidateCreditAccount";
+/**
+ * A parsed credit facade call extracted from a call trace,
+ * with inner multicall calls already decoded.
+ */
+export interface FacadeParsedCall {
+    operation: FacadeCallType;
+    creditAccount: Address;
+    /** The full ParsedCallV2 from facade calldata parsing. */
+    parsed: ParsedCallV2;
+    /** Inner multicall entries from rawArgs.calls (empty for partiallyLiquidateCreditAccount). */
+    innerCalls: ParsedCallV2[];
+    /** The full call trace node for this facade call (used to extract protocol-level calldata). */
+    trace: CallTrace;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "14.11.0-next.4",
+  "version": "14.11.0-next.5",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {

package/dist/cjs/history/extractProtocolCalls.js

@@ -1,53 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var extractProtocolCalls_exports = {};
-__export(extractProtocolCalls_exports, {
-  extractProtocolCalls: () => extractProtocolCalls
-});
-module.exports = __toCommonJS(extractProtocolCalls_exports);
-var import_errors = require("./errors.js");
-var import_trace_utils = require("./trace-utils.js");
-function extractProtocolCalls(facadeTrace, executeResults) {
-  if (executeResults.length === 0) {
-    return [];
-  }
-  const subtraces = facadeTrace.calls ?? [];
-  const result = [];
-  let subtraceIdx = 0;
-  for (let i = 0; i < executeResults.length; i++) {
-    const { targetContract } = executeResults[i];
-    let found;
-    while (subtraceIdx < subtraces.length && !found) {
-      found = (0, import_trace_utils.findCallTo)(subtraces[subtraceIdx], targetContract);
-      subtraceIdx++;
-    }
-    if (!found) {
-      throw new import_errors.ProtocolCallNotFoundError(targetContract, i);
-    }
-    result.push(found.input);
-  }
-  if (result.length !== executeResults.length) {
-    throw new import_errors.AdapterTraceAlignmentError(executeResults.length, result.length);
-  }
-  return result;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  extractProtocolCalls
-});

package/dist/esm/history/extractProtocolCalls.js

@@ -1,32 +0,0 @@
-import {
-  AdapterTraceAlignmentError,
-  ProtocolCallNotFoundError
-} from "./errors.js";
-import { findCallTo } from "./trace-utils.js";
-function extractProtocolCalls(facadeTrace, executeResults) {
-  if (executeResults.length === 0) {
-    return [];
-  }
-  const subtraces = facadeTrace.calls ?? [];
-  const result = [];
-  let subtraceIdx = 0;
-  for (let i = 0; i < executeResults.length; i++) {
-    const { targetContract } = executeResults[i];
-    let found;
-    while (subtraceIdx < subtraces.length && !found) {
-      found = findCallTo(subtraces[subtraceIdx], targetContract);
-      subtraceIdx++;
-    }
-    if (!found) {
-      throw new ProtocolCallNotFoundError(targetContract, i);
-    }
-    result.push(found.input);
-  }
-  if (result.length !== executeResults.length) {
-    throw new AdapterTraceAlignmentError(executeResults.length, result.length);
-  }
-  return result;
-}
-export {
-  extractProtocolCalls
-};

package/dist/esm/history/trace-utils.js

@@ -1,36 +0,0 @@
-import { isAddressEqual } from "viem";
-function findCallTo(node, target) {
-  if (node.error) {
-    return void 0;
-  }
-  if (node.type === "CALL" && isAddressEqual(node.to, target)) {
-    return node;
-  }
-  if (node.calls) {
-    for (const child of node.calls) {
-      const found = findCallTo(child, target);
-      if (found) {
-        return found;
-      }
-    }
-  }
-  return void 0;
-}
-function collectTraces(node, target) {
-  const results = [];
-  if (node.error) {
-    return results;
-  }
-  if (node.type === "CALL" && isAddressEqual(node.to, target)) {
-    results.push(node);
-  } else if (node.calls) {
-    for (const child of node.calls) {
-      results.push(...collectTraces(child, target));
-    }
-  }
-  return results;
-}
-export {
-  collectTraces,
-  findCallTo
-};

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

@@ -1,8 +0,0 @@
-import type { Hex } from "viem";
-import type { CallTrace, ExecuteResult } from "./internal-types.js";
-/**
- * Extracts calldata sent to target contract for each Execute event.
- *
- * @returns
- */
-export declare function extractProtocolCalls(facadeTrace: CallTrace, executeResults: ExecuteResult[]): Hex[];

package/dist/types/history/inner-operations.d.ts

@@ -1,57 +0,0 @@
-import type { Address } from "viem";
-import type { AdapterOperation } from "../plugins/adapters/index.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.
- */
-export type InnerOperation = AdapterOperation | InnerFacadeOperation;

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

@@ -1,47 +0,0 @@
-import type { Address, Hex } from "viem";
-import type { TokenTransfer } from "../plugins/adapters/index.js";
-import type { ParsedCallV2 } from "../sdk/index.js";
-/**
- * A single frame from Ethereum's `debug_traceTransaction` callTracer output.
- * Recursive: each frame may contain nested sub-calls.
- */
-export interface CallTrace {
-    from: Address;
-    to: Address;
-    input: Hex;
-    output: Hex;
-    value: Hex;
-    /** "CALL", "DELEGATECALL", "STATICCALL", "CREATE", etc. */
-    type: string;
-    /** Present when the call reverted (e.g. "execution reverted"). */
-    error?: string;
-    /** ABI-encoded revert data, if available. */
-    revertReason?: Hex;
-    calls?: CallTrace[];
-}
-/**
- * The set of credit facade entry-point functions that produce history operations.
- */
-export type FacadeCallType = "MultiCall" | "BotMulticall" | "OpenCreditAccount" | "CloseCreditAccount" | "LiquidateCreditAccount" | "PartiallyLiquidateCreditAccount";
-/**
- * A parsed credit facade call extracted from a call trace,
- * with inner multicall calls already decoded.
- */
-export interface FacadeParsedCall {
-    operation: FacadeCallType;
-    creditAccount: Address;
-    /** The full ParsedCallV2 from facade calldata parsing. */
-    parsed: ParsedCallV2;
-    /** Inner multicall entries from rawArgs.calls (empty for partiallyLiquidateCreditAccount). */
-    innerCalls: ParsedCallV2[];
-    /** The full call trace node for this facade call (used to extract protocol-level calldata). */
-    trace: CallTrace;
-}
-/**
- * Data extracted from a single Execute event: the ERC-20 transfers that
- * occurred between Execute boundaries and the target contract address.
- */
-export interface ExecuteResult {
-    transfers: TokenTransfer[];
-    targetContract: Address;
-}

package/dist/types/history/trace-utils.d.ts

@@ -1,12 +0,0 @@
-import { type Address } from "viem";
-import type { CallTrace } from "./internal-types.js";
-/**
- * Finds the first non-reverted CALL to `target` anywhere in a trace subtree.
- */
-export declare function findCallTo(node: CallTrace, target: Address): CallTrace | undefined;
-/**
- * DFS walk of the call trace tree, collecting non-reverted CALL entries
- * to the given address.
- * Does not recurse into children of matched nodes
- */
-export declare function collectTraces(node: CallTrace, target: Address): CallTrace[];