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

package/dist/cjs/preview/parse/extractExpectedBalanceChanges.js

@@ -0,0 +1,48 @@
+"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 extractExpectedBalanceChanges_exports = {};
+__export(extractExpectedBalanceChanges_exports, {
+  extractExpectedBalanceChanges: () => extractExpectedBalanceChanges
+});
+module.exports = __toCommonJS(extractExpectedBalanceChanges_exports);
+function extractExpectedBalanceChanges(innerCalls) {
+  const calls = innerCalls.filter(
+    (call) => functionName(call) !== "onDemandPriceUpdates"
+  );
+  if (calls.length === 0) {
+    return void 0;
+  }
+  const first = calls[0];
+  const last = calls[calls.length - 1];
+  if (functionName(first) !== "storeExpectedBalances" || functionName(last) !== "compareBalances") {
+    return void 0;
+  }
+  const balanceDeltas = first.rawArgs.balanceDeltas;
+  if (!balanceDeltas) {
+    return void 0;
+  }
+  return balanceDeltas.map(({ token, amount }) => ({ token, delta: amount }));
+}
+function functionName(call) {
+  return call.functionName.split("(")[0];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  extractExpectedBalanceChanges
+});

package/dist/cjs/preview/parse/index.js

@@ -17,6 +17,7 @@ var parse_exports = {};
 module.exports = __toCommonJS(parse_exports);
 __reExport(parse_exports, require("./classifyInnerOperations.js"), module.exports);
 __reExport(parse_exports, require("./errors.js"), module.exports);
+__reExport(parse_exports, require("./extractExpectedBalanceChanges.js"), module.exports);
 __reExport(parse_exports, require("./parseFacadeOperationCalldata.js"), module.exports);
 __reExport(parse_exports, require("./parseOperationCalldata.js"), module.exports);
 __reExport(parse_exports, require("./parsePoolOperationCalldata.js"), module.exports);
@@ -25,6 +26,7 @@ __reExport(parse_exports, require("./types.js"), module.exports);
 0 && (module.exports = {
   ...require("./classifyInnerOperations.js"),
   ...require("./errors.js"),
+  ...require("./extractExpectedBalanceChanges.js"),
   ...require("./parseFacadeOperationCalldata.js"),
   ...require("./parseOperationCalldata.js"),
   ...require("./parsePoolOperationCalldata.js"),

package/dist/cjs/preview/parse/parseFacadeOperationCalldata.js

@@ -23,6 +23,7 @@ __export(parseFacadeOperationCalldata_exports, {
 module.exports = __toCommonJS(parseFacadeOperationCalldata_exports);
 var import_viem = require("viem");
 var import_classifyInnerOperations = require("./classifyInnerOperations.js");
+var import_extractExpectedBalanceChanges = require("./extractExpectedBalanceChanges.js");
 function parseFacadeOperationCalldata(props) {
   const { sdk, facade, calldata } = props;
   const parsed = sdk.parseFunctionDataV2(facade.address, calldata);
@@ -43,20 +44,23 @@ function parseFacadeOperationCalldata(props) {
     sdk,
     underlying: suite.underlying
   });
+  const expectedBalanceChanges = (0, import_extractExpectedBalanceChanges.extractExpectedBalanceChanges)(innerCalls);
   switch (functionName) {
     case "multicall":
       return {
         ...metadata,
         operation: "MultiCall",
         creditAccount: rawArgs.creditAccount,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "botMulticall":
       return {
         ...metadata,
         operation: "BotMulticall",
         creditAccount: rawArgs.creditAccount,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "openCreditAccount":
       return {
@@ -65,14 +69,16 @@ function parseFacadeOperationCalldata(props) {
         creditAccount: import_viem.zeroAddress,
         onBehalfOf: rawArgs.onBehalfOf,
         referralCode: rawArgs.referralCode,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "closeCreditAccount":
       return {
         ...metadata,
         operation: "CloseCreditAccount",
         creditAccount: rawArgs.creditAccount,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "liquidateCreditAccount":
       return {
@@ -84,7 +90,8 @@ function parseFacadeOperationCalldata(props) {
         // liquidation, so they are not recoverable from raw calldata.
         token: import_viem.zeroAddress,
         remainingFunds: 0n,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "partiallyLiquidateCreditAccount":
       return {

package/dist/esm/preview/parse/extractExpectedBalanceChanges.js

@@ -0,0 +1,24 @@
+function extractExpectedBalanceChanges(innerCalls) {
+  const calls = innerCalls.filter(
+    (call) => functionName(call) !== "onDemandPriceUpdates"
+  );
+  if (calls.length === 0) {
+    return void 0;
+  }
+  const first = calls[0];
+  const last = calls[calls.length - 1];
+  if (functionName(first) !== "storeExpectedBalances" || functionName(last) !== "compareBalances") {
+    return void 0;
+  }
+  const balanceDeltas = first.rawArgs.balanceDeltas;
+  if (!balanceDeltas) {
+    return void 0;
+  }
+  return balanceDeltas.map(({ token, amount }) => ({ token, delta: amount }));
+}
+function functionName(call) {
+  return call.functionName.split("(")[0];
+}
+export {
+  extractExpectedBalanceChanges
+};

package/dist/esm/preview/parse/index.js

@@ -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/esm/preview/parse/parseFacadeOperationCalldata.js

@@ -1,5 +1,6 @@
 import { isAddressEqual, zeroAddress } from "viem";
 import { classifyInnerOperations } from "./classifyInnerOperations.js";
+import { extractExpectedBalanceChanges } from "./extractExpectedBalanceChanges.js";
 function parseFacadeOperationCalldata(props) {
   const { sdk, facade, calldata } = props;
   const parsed = sdk.parseFunctionDataV2(facade.address, calldata);
@@ -20,20 +21,23 @@ function parseFacadeOperationCalldata(props) {
     sdk,
     underlying: suite.underlying
   });
+  const expectedBalanceChanges = extractExpectedBalanceChanges(innerCalls);
   switch (functionName) {
     case "multicall":
       return {
         ...metadata,
         operation: "MultiCall",
         creditAccount: rawArgs.creditAccount,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "botMulticall":
       return {
         ...metadata,
         operation: "BotMulticall",
         creditAccount: rawArgs.creditAccount,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "openCreditAccount":
       return {
@@ -42,14 +46,16 @@ function parseFacadeOperationCalldata(props) {
         creditAccount: zeroAddress,
         onBehalfOf: rawArgs.onBehalfOf,
         referralCode: rawArgs.referralCode,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "closeCreditAccount":
       return {
         ...metadata,
         operation: "CloseCreditAccount",
         creditAccount: rawArgs.creditAccount,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "liquidateCreditAccount":
       return {
@@ -61,7 +67,8 @@ function parseFacadeOperationCalldata(props) {
         // liquidation, so they are not recoverable from raw calldata.
         token: zeroAddress,
         remainingFunds: 0n,
-        multicall
+        multicall,
+        expectedBalanceChanges
       };
     case "partiallyLiquidateCreditAccount":
       return {

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

@@ -18,10 +18,10 @@ export type HistoryAdapterExt = TraceAdapterExt & {
 export type HistoryFacadeMetadata = FacadeOperationMetadata & OperationMetadata;
 export type AdapterOperation = BaseAdapterOperation<HistoryAdapterExt>;
 export type InnerOperation = BaseInnerOperation<HistoryAdapterExt>;
-export type MulticallOperation = BaseMulticallOperation<HistoryAdapterExt> & OperationMetadata;
-export type OpenCreditAccountOperation = BaseOpenCreditAccountOperation<HistoryAdapterExt> & OperationMetadata;
-export type CloseCreditAccountOperation = BaseCloseCreditAccountOperation<HistoryAdapterExt> & OperationMetadata;
-export type LiquidateCreditAccountOperation = BaseLiquidateCreditAccountOperation<HistoryAdapterExt> & OperationMetadata;
+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;

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/types-facades.d.ts

@@ -71,10 +71,25 @@ 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";
@@ -82,11 +97,23 @@ export interface OpenCreditAccountOperation<Ext extends object = {}> extends Fac
     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";
@@ -95,6 +122,12 @@ export interface LiquidateCreditAccountOperation<Ext extends object = {}> extend
     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";

package/package.json

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