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

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/dist/types/sdk/accounts/CreditAccountsServiceV310.d.ts

@@ -6,7 +6,7 @@ import type { RWAOpenAccountRequirements } from "../market/rwa/index.js";
 import type { OnchainSDK } from "../OnchainSDK.js";
 import { type RouterCASlice } from "../router/index.js";
 import type { MultiCall, RawTx } from "../types/index.js";
-import type { AccountToCheck, AddCollateralProps, ChangeDeptProps, ClaimDelayedProps, ClaimFarmRewardsProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, CreditAccountTokensSlice, CreditManagerOperationResult, DefaultPartialLiquidationParams, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetOpenAccountRequirementsProps, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, RepayAndLiquidateCreditAccountProps, RepayCreditAccountProps, Rewards, SetBotProps, StartDelayedWithdrawalProps, UpdateQuotasProps, WithdrawCollateralProps } from "./types.js";
+import type { AccountToCheck, AddCollateralProps, AssembleCaUpdateCallsProps, ChangeDeptProps, ClaimDelayedProps, ClaimFarmRewardsProps, CloseCreditAccountProps, CloseCreditAccountResult, CreditAccountOperationResult, CreditAccountTokensSlice, CreditManagerOperationResult, DefaultPartialLiquidationParams, ExecuteSwapProps, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsOptions, GetOpenAccountRequirementsProps, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, ICreditAccountsService, OpenCAProps, PartiallyLiquidateProps, PreviewDelayedWithdrawalProps, PreviewDelayedWithdrawalResult, RepayAndLiquidateCreditAccountProps, RepayCreditAccountProps, Rewards, SetBotProps, StartDelayedWithdrawalProps, UpdateQuotasProps, WithdrawCollateralProps } from "./types.js";
 /**
  * Options for configuring the credit account service.
  **/
@@ -204,6 +204,26 @@ export declare class CreditAccountsServiceV310 extends SDKConstruct implements I
     botMulticall(creditAccount: RouterCASlice, calls: MultiCall[], options?: {
         ignoreReservePrices?: boolean;
     }): Promise<RawTx>;
+    /**
+     * {@inheritDoc ICreditAccountsService.prependPriceUpdates}
+     */
+    prependPriceUpdates(creditManager: Address, calls: MultiCall[], creditAccount?: RouterCASlice, options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<MultiCall[]>;
+    /**
+     * {@inheritDoc ICreditAccountsService.assembleCaUpdateCalls}
+     */
+    assembleCaUpdateCalls({ operations, routerCallGroups, creditFacade, withdrawTo, creditAccount, underlyingToken, }: AssembleCaUpdateCallsProps): MultiCall[];
+    /**
+     * {@inheritDoc ICreditAccountsService.executeCaUpdate}
+     */
+    executeCaUpdate(creditAccount: RouterCASlice, calls: MultiCall[], options?: {
+        ignoreReservePrices?: boolean;
+        ethAmount?: bigint;
+    }): Promise<{
+        tx: RawTx;
+        calls: MultiCall[];
+    }>;
     /**
      * Returns addresses of market configurators
      */

package/dist/types/sdk/accounts/types.d.ts

@@ -672,6 +672,53 @@ export type GetApprovalAddressProps = {
     creditManager: Address;
     creditAccount: Address;
 };
+/**
+ * A single step in a generic credit account update operation chain.
+ *
+ * Used by {@link ICreditAccountsService.assembleCaUpdateCalls} to build the
+ * underlying credit facade multicall calls.
+ */
+export type CreditAccountUpdateOperation = {
+    type: "increaseDebt";
+    amount: bigint;
+} | {
+    type: "decreaseDebt";
+    amount: bigint;
+} | {
+    type: "addCollateral";
+    token: Address;
+    amount: bigint;
+} | {
+    type: "withdrawCollateral";
+    token: Address;
+    amount: bigint;
+} | {
+    type: "swap";
+} | {
+    type: "changeQuota";
+    quotaIncrease: Array<Asset>;
+    quotaDecrease: Array<Asset>;
+} | {
+    type: "closeCreditAccount";
+};
+/**
+ * Input for {@link ICreditAccountsService.assembleCaUpdateCalls}.
+ */
+export type AssembleCaUpdateCallsProps = {
+    operations: Array<CreditAccountUpdateOperation>;
+    /** One group per swap leg (in order), or a single group for the close path. */
+    routerCallGroups: Array<Array<MultiCall>>;
+    creditFacade: Address;
+    withdrawTo: Address;
+    creditAccount: {
+        debt: bigint;
+        assets: Array<Asset>;
+        initialQuotas: Record<Address, {
+            quota: bigint;
+        }>;
+    };
+    underlyingToken: Address;
+};
 export interface ICreditAccountsService extends Construct {
     sdk: OnchainSDK;
     /**
@@ -883,6 +930,41 @@ export interface ICreditAccountsService extends Construct {
     botMulticall(creditAccount: RouterCASlice, calls: Array<MultiCall>, options?: {
         ignoreReservePrices?: boolean;
     }): Promise<RawTx>;
+    /**
+     * Analyzes a multicall array and prepends necessary on-demand price feed updates.
+     *
+     * @param creditManager - Credit manager address
+     * @param calls - Original multicall payload
+     * @param creditAccount - Optional credit account slice (used to determine which tokens need prices)
+     * @param options - Optional settings for price update generation
+     * @returns Multicall payload with price updates prepended when needed
+     */
+    prependPriceUpdates(creditManager: Address, calls: Array<MultiCall>, creditAccount?: RouterCASlice, options?: {
+        ignoreReservePrices?: boolean;
+    }): Promise<Array<MultiCall>>;
+    /**
+     * Builds the credit facade multicall calls for a chain of update operations.
+     *
+     * @param props - Operation chain, router call groups and account context
+     * @returns Array of facade multicall calls (without price feed updates)
+     */
+    assembleCaUpdateCalls(props: AssembleCaUpdateCallsProps): Array<MultiCall>;
+    /**
+     * Executes a credit account update: prepends price feed updates and builds the raw
+     * multicall transaction. Uses the RWA factory when applicable.
+     *
+     * @param creditAccount - Credit account to update
+     * @param calls - Operation calls to execute
+     * @param options - Optional price update and ETH value settings
+     * @returns Raw transaction and the final multicall payload
+     */
+    executeCaUpdate(creditAccount: RouterCASlice, calls: Array<MultiCall>, options?: {
+        ignoreReservePrices?: boolean;
+        ethAmount?: bigint;
+    }): Promise<{
+        tx: RawTx;
+        calls: Array<MultiCall>;
+    }>;
     /**
      * Returns multicall entries to redeem (unwrap) RWA ERC-4626 vault shares into underlying for the given credit manager.
      * Used when withdrawing debt from a RWA market: redeems adapter vault shares so the underlying can be withdrawn.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "14.11.3",
+  "version": "14.12.0-next.1",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {
@@ -44,6 +44,11 @@
       "import": "./dist/esm/permissionless/index.js",
       "default": "./dist/cjs/permissionless/index.js"
     },
+    "./preview": {
+      "types": "./dist/types/preview/index.d.ts",
+      "import": "./dist/esm/preview/index.js",
+      "default": "./dist/cjs/preview/index.js"
+    },
     "./common-utils": {
       "types": "./dist/types/common-utils/index.d.ts",
       "import": "./dist/esm/common-utils/index.js",

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