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

package/dist/cjs/sdk/router/helpers.js

@@ -19,14 +19,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var helpers_exports = {};
 __export(helpers_exports, {
   assetsMap: () => assetsMap,
-  balancesMap: () => balancesMap,
   limitLeftover: () => limitLeftover
 });
 module.exports = __toCommonJS(helpers_exports);
 var import_utils = require("../utils/index.js");
-function balancesMap(assets) {
-  return new import_utils.AddressMap(assets.map(({ token, balance }) => [token, balance]));
-}
 function assetsMap(assets) {
   return new import_utils.AddressMap(assets.map((a) => [a.token, a]));
 }
@@ -42,6 +38,5 @@ function limitLeftover(balance, token) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   assetsMap,
-  balancesMap,
   limitLeftover
 });

package/dist/cjs/sdk/utils/AddressMap.js

@@ -136,6 +136,12 @@ class AddressMap {
   keys() {
     return Array.from(this.#map.keys());
   }
+  /**
+   * Returns an unfrozen shallow copy of the map.
+   **/
+  clone() {
+    return new AddressMap(this.entries(), this.name);
+  }
   /**
    * Converts the map to a plain `Record<Address, T>` object.
    **/

package/dist/cjs/sdk/utils/AssetsMap.js

@@ -0,0 +1,97 @@
+"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 AssetsMap_exports = {};
+__export(AssetsMap_exports, {
+  AssetsMap: () => AssetsMap
+});
+module.exports = __toCommonJS(AssetsMap_exports);
+var import_AddressMap = require("./AddressMap.js");
+class AssetsMap extends import_AddressMap.AddressMap {
+  /**
+   * @param entries - Optional initial entries as `[address, balance]` tuples or {@link Asset} objects.
+   * @param name - Optional label used in error messages when a lookup fails.
+   */
+  constructor(entries, name) {
+    super(
+      entries?.map((e) => Array.isArray(e) ? e : [e.token, e.balance]),
+      name
+    );
+  }
+  /**
+   * Looks up a token balance, treating a missing key as `0n`.
+   */
+  getOrZero(address) {
+    return this.get(address) ?? 0n;
+  }
+  /**
+   * Adds `amount` to the token balance, treating a missing key as `0n`.
+   */
+  inc(address, amount) {
+    this.upsert(address, this.getOrZero(address) + amount);
+  }
+  /**
+   * Subtracts `amount` from the token balance, treating a missing key as `0n`.
+   */
+  dec(address, amount) {
+    this.inc(address, -amount);
+  }
+  /**
+   * Per-token difference `this - before`, non-zero entries only.
+   *
+   * Assumes this map's keys are a superset of `before`'s keys; tokens present
+   * only in `before` are not reported.
+   */
+  difference(before) {
+    const result = new AssetsMap();
+    for (const [token, balance] of this.entries()) {
+      const change = balance - before.getOrZero(token);
+      if (change !== 0n) {
+        result.upsert(token, change);
+      }
+    }
+    return result;
+  }
+  /**
+   * Sums `fn` over all entries.
+   */
+  sum(fn) {
+    return this.entries().reduce(
+      (acc, [token, balance]) => acc + fn(token, balance),
+      0n
+    );
+  }
+  /**
+   * Converts the map to an array of {@link Asset} objects.
+   * @param minBalance - If provided, keeps only entries with a balance
+   * strictly greater than this threshold (e.g. `1n` to filter out dust).
+   */
+  toAssets(minBalance) {
+    const abs = (balance) => balance > 0n ? balance : -balance;
+    return this.entries().filter(
+      ([, balance]) => minBalance === void 0 || abs(balance) > minBalance
+    ).map(([token, balance]) => ({ token, balance }));
+  }
+  clone() {
+    return new AssetsMap(this.entries(), this.name);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AssetsMap
+});

package/dist/cjs/sdk/utils/index.js

@@ -17,6 +17,7 @@ var utils_exports = {};
 module.exports = __toCommonJS(utils_exports);
 __reExport(utils_exports, require("./AddressMap.js"), module.exports);
 __reExport(utils_exports, require("./AddressSet.js"), module.exports);
+__reExport(utils_exports, require("./AssetsMap.js"), module.exports);
 __reExport(utils_exports, require("./abi-decode.js"), module.exports);
 __reExport(utils_exports, require("./bytes32ToString.js"), module.exports);
 __reExport(utils_exports, require("./childLogger.js"), module.exports);
@@ -36,6 +37,7 @@ __reExport(utils_exports, require("./zod.js"), module.exports);
 0 && (module.exports = {
   ...require("./AddressMap.js"),
   ...require("./AddressSet.js"),
+  ...require("./AssetsMap.js"),
   ...require("./abi-decode.js"),
   ...require("./bytes32ToString.js"),
   ...require("./childLogger.js"),

package/dist/esm/abi/iZapper.js

@@ -1,80 +1,118 @@
 const iZapperAbi = [
   {
     type: "function",
+    name: "contractType",
     inputs: [],
+    outputs: [{ name: "", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
     name: "pool",
-    outputs: [{ name: "", internalType: "address", type: "address" }],
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
   },
   {
     type: "function",
+    name: "previewDeposit",
     inputs: [
-      { name: "tokenInAmount", internalType: "uint256", type: "uint256" }
+      { name: "tokenInAmount", type: "uint256", internalType: "uint256" }
     ],
-    name: "previewDeposit",
     outputs: [
-      { name: "tokenOutAmount", internalType: "uint256", type: "uint256" }
+      { name: "tokenOutAmount", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "view"
   },
   {
     type: "function",
+    name: "previewRedeem",
     inputs: [
-      { name: "tokenOutAmount", internalType: "uint256", type: "uint256" }
+      { name: "tokenOutAmount", type: "uint256", internalType: "uint256" }
     ],
-    name: "previewRedeem",
     outputs: [
-      { name: "tokenInAmount", internalType: "uint256", type: "uint256" }
+      { name: "tokenInAmount", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "view"
   },
   {
     type: "function",
+    name: "redeem",
     inputs: [
-      { name: "tokenOutAmount", internalType: "uint256", type: "uint256" },
-      { name: "receiver", internalType: "address", type: "address" }
+      { name: "tokenOutAmount", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" }
     ],
-    name: "redeem",
     outputs: [
-      { name: "tokenInAmount", internalType: "uint256", type: "uint256" }
+      { name: "tokenInAmount", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
+    name: "redeemWithPermit",
     inputs: [
-      { name: "tokenOutAmount", internalType: "uint256", type: "uint256" },
-      { name: "receiver", internalType: "address", type: "address" },
-      { name: "deadline", internalType: "uint256", type: "uint256" },
-      { name: "v", internalType: "uint8", type: "uint8" },
-      { name: "r", internalType: "bytes32", type: "bytes32" },
-      { name: "s", internalType: "bytes32", type: "bytes32" }
+      { name: "tokenOutAmount", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" },
+      { name: "deadline", type: "uint256", internalType: "uint256" },
+      { name: "v", type: "uint8", internalType: "uint8" },
+      { name: "r", type: "bytes32", internalType: "bytes32" },
+      { name: "s", type: "bytes32", internalType: "bytes32" }
     ],
-    name: "redeemWithPermit",
     outputs: [
-      { name: "tokenInAmount", internalType: "uint256", type: "uint256" }
+      { name: "tokenInAmount", type: "uint256", internalType: "uint256" }
     ],
     stateMutability: "nonpayable"
   },
   {
     type: "function",
+    name: "redeemWithPermitAllowed",
+    inputs: [
+      { name: "tokenOutAmount", type: "uint256", internalType: "uint256" },
+      { name: "receiver", type: "address", internalType: "address" },
+      { name: "nonce", type: "uint256", internalType: "uint256" },
+      { name: "expiry", type: "uint256", internalType: "uint256" },
+      { name: "v", type: "uint8", internalType: "uint8" },
+      { name: "r", type: "bytes32", internalType: "bytes32" },
+      { name: "s", type: "bytes32", internalType: "bytes32" }
+    ],
+    outputs: [
+      { name: "tokenInAmount", type: "uint256", internalType: "uint256" }
+    ],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "serialize",
     inputs: [],
-    name: "tokenIn",
-    outputs: [{ name: "", internalType: "address", type: "address" }],
+    outputs: [{ name: "serializedData", type: "bytes", internalType: "bytes" }],
     stateMutability: "view"
   },
   {
     type: "function",
+    name: "tokenIn",
     inputs: [],
-    name: "tokenOut",
-    outputs: [{ name: "", internalType: "address", type: "address" }],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
     stateMutability: "view"
   },
   {
     type: "function",
+    name: "tokenOut",
     inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
     name: "underlying",
-    outputs: [{ name: "", internalType: "address", type: "address" }],
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "version",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256", internalType: "uint256" }],
     stateMutability: "view"
   }
 ];

package/dist/esm/dev/AccountOpener.js

@@ -12,6 +12,7 @@ import {
   ADDRESS_0X0,
   AddressMap,
   AddressSet,
+  AssetsMap,
   childLogger,
   MAX_UINT256,
   PERCENTAGE_FACTOR,
@@ -373,7 +374,7 @@ class AccountOpener extends SDKConstruct {
   }
   async #depositIntoPools(targets) {
     this.#logger?.debug("checking and topping up pools if necessary");
-    const minAvailableByPool = {};
+    const minAvailableByPool = new AssetsMap();
     for (let i = 0; i < targets.length; i++) {
       const t = targets[i];
       const leverage = this.#getLeverage(t);
@@ -381,14 +382,14 @@ class AccountOpener extends SDKConstruct {
       const minDebt = this.#minDebtMultiplier * cm.creditFacade.minDebt / PERCENTAGE_FACTOR;
       let amount = minDebt * (leverage - PERCENTAGE_FACTOR) / PERCENTAGE_FACTOR * this.#poolDepositMultiplier / PERCENTAGE_FACTOR;
       amount = amount > cm.creditFacade.maxDebt ? cm.creditFacade.maxDebt : amount;
-      minAvailableByPool[cm.pool] = (minAvailableByPool[cm.pool] ?? 0n) + amount;
+      minAvailableByPool.inc(cm.pool, amount);
       this.#logger?.debug(
         `target #${i + 1} (${this.labelAddress(t.target)}) needs ${this.sdk.tokensMeta.formatBN(cm.underlying, amount, { symbol: true })} in pool (leverage: ${Number(leverage / PERCENTAGE_FACTOR)}%)`
       );
     }
     const deposits = [];
-    const claims = new AddressMap();
-    for (const [p, minAvailable] of Object.entries(minAvailableByPool)) {
+    const claims = new AssetsMap();
+    for (const [p, minAvailable] of minAvailableByPool.entries()) {
       const market = this.sdk.marketRegister.findByPool(p);
       const pool = market.pool.pool;
       let diff = minAvailable - pool.availableLiquidity;
@@ -405,9 +406,7 @@ class AccountOpener extends SDKConstruct {
       );
       if (diff > 0n) {
         deposits.push([pool, diff]);
-        let claim = claims.get(pool.underlying) ?? 0n;
-        claim += diff * PERCENTAGE_FACTOR / 8950n;
-        claims.upsert(pool.underlying, claim);
+        claims.inc(pool.underlying, diff * PERCENTAGE_FACTOR / 8950n);
       }
     }
     const depositor = await this.#getDepositor();
@@ -564,18 +563,14 @@ class AccountOpener extends SDKConstruct {
   async #prepareBorrower(targets) {
     const borrower = await this.#getBorrower();
     const degenNFTS = {};
-    const claims = new AddressMap();
+    const claims = new AssetsMap();
     for (const target of targets) {
       const cm = this.sdk.marketRegister.findCreditManager(
         target.creditManager
       );
-      const market = this.sdk.marketRegister.findByCreditManager(
-        target.creditManager
-      );
       const { degenNFT } = cm.creditFacade;
       const minDebt = this.#minDebtMultiplier * cm.creditFacade.minDebt / PERCENTAGE_FACTOR;
-      const claim = claims.get(cm.underlying) ?? 0n;
-      claims.upsert(cm.underlying, claim + minDebt * 11n / 10n);
+      claims.inc(cm.underlying, minDebt * 11n / 10n);
       if (isAddress(degenNFT) && degenNFT !== ADDRESS_0X0) {
         degenNFTS[degenNFT] = (degenNFTS[degenNFT] ?? 0) + 1;
       }

package/dist/esm/history/classifyMulticallOperations.js

@@ -45,6 +45,7 @@ function classifyMulticallOperations(input) {
         label: call.label,
         adapterFunctionName: call.functionName,
         adapterArgs: call.rawArgs,
+        calldata: call.calldata,
         protocol,
         transfers: transfers2,
         legacy
@@ -80,6 +81,7 @@ function classifyMulticallOperations(input) {
       label: call.label,
       adapterFunctionName: call.functionName,
       adapterArgs: call.rawArgs,
+      calldata: call.calldata,
       // Unknown adapter (non-strict): we have no ABI to decode the protocol
       // call, so `protocol` is left absent rather than filled with placeholders.
       protocol: void 0,

package/dist/esm/history/mapOperations.js

@@ -12,6 +12,13 @@ function mapInnerOperation(op, visitor, ctx) {
       return visitor.WithdrawCollateral(op, ctx);
     case "UpdateQuota":
       return visitor.UpdateQuota(op, ctx);
+    // The history classifier never emits other InnerOperation variants
+    // (e.g. StoreExpectedBalances/CompareBalances, which it drops), so this
+    // guards against silently returning undefined if that ever changes.
+    default:
+      throw new Error(
+        `unexpected inner operation: ${op.operation}`
+      );
   }
 }
 function mapOuterOperation(op, visitor) {

package/dist/esm/plugins/adapters/abi/iConvexV1BoosterAdapter.js

@@ -0,0 +1,119 @@
+const iConvexV1BoosterAdapterAbi = [
+  {
+    type: "function",
+    inputs: [],
+    name: "contractType",
+    outputs: [{ name: "", internalType: "bytes32", type: "bytes32" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [],
+    name: "creditManager",
+    outputs: [{ name: "", internalType: "address", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [
+      { name: "_pid", internalType: "uint256", type: "uint256" },
+      { name: "", internalType: "uint256", type: "uint256" },
+      { name: "_stake", internalType: "bool", type: "bool" }
+    ],
+    name: "deposit",
+    outputs: [{ name: "useSafePrices", internalType: "bool", type: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    inputs: [
+      { name: "_pid", internalType: "uint256", type: "uint256" },
+      { name: "leftoverAmount", internalType: "uint256", type: "uint256" },
+      { name: "_stake", internalType: "bool", type: "bool" }
+    ],
+    name: "depositDiff",
+    outputs: [{ name: "useSafePrices", internalType: "bool", type: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    inputs: [{ name: "", internalType: "uint256", type: "uint256" }],
+    name: "pidToConvexToken",
+    outputs: [{ name: "", internalType: "address", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [{ name: "", internalType: "uint256", type: "uint256" }],
+    name: "pidToCurveToken",
+    outputs: [{ name: "", internalType: "address", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [{ name: "", internalType: "uint256", type: "uint256" }],
+    name: "pidToPhantomToken",
+    outputs: [{ name: "", internalType: "address", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [],
+    name: "serialize",
+    outputs: [{ name: "serializedData", internalType: "bytes", type: "bytes" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [],
+    name: "targetContract",
+    outputs: [{ name: "", internalType: "address", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [],
+    name: "updateSupportedPids",
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    inputs: [],
+    name: "version",
+    outputs: [{ name: "", internalType: "uint256", type: "uint256" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    inputs: [
+      { name: "_pid", internalType: "uint256", type: "uint256" },
+      { name: "", internalType: "uint256", type: "uint256" }
+    ],
+    name: "withdraw",
+    outputs: [{ name: "useSafePrices", internalType: "bool", type: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    inputs: [
+      { name: "_pid", internalType: "uint256", type: "uint256" },
+      { name: "leftoverAmount", internalType: "uint256", type: "uint256" }
+    ],
+    name: "withdrawDiff",
+    outputs: [{ name: "useSafePrices", internalType: "bool", type: "bool" }],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "event",
+    anonymous: false,
+    inputs: [
+      { name: "pid", internalType: "uint256", type: "uint256", indexed: true }
+    ],
+    name: "AddSupportedPid"
+  },
+  { type: "error", inputs: [], name: "UnsupportedPidException" }
+];
+export {
+  iConvexV1BoosterAdapterAbi
+};

package/dist/esm/plugins/adapters/abi/index.js

@@ -1,5 +1,6 @@
 export * from "./actionAbi.js";
 export * from "./conctructorAbi.js";
+export * from "./iConvexV1BoosterAdapter.js";
 export * from "./securitize/index.js";
 export * from "./targetContractAbi.js";
 export * from "./utils.js";

package/dist/esm/plugins/adapters/contracts/AbstractAdapter.js

@@ -103,6 +103,42 @@ class AbstractAdapterContract extends BaseContract {
       return void 0;
     }
   }
+  /**
+   * Applies the balance changes implied by a router-generated diff-style
+   * adapter call to a map of credit-account token balances.
+   *
+   * @param balances - Token balances before the call. Mutated in place.
+   * @param calldata - Raw ABI-encoded adapter calldata.
+   * @throws When the calldata cannot be decoded or the adapter (or the
+   * specific function) has no balance-changes support.
+   */
+  previewBalanceChanges(balances, calldata) {
+    let decoded;
+    try {
+      decoded = decodeFunctionData({ abi: this.abi, data: calldata });
+    } catch (e) {
+      throw new Error(
+        `previewBalanceChanges: cannot decode selector ${calldata.slice(0, 10)} on ${this.contractType} adapter at ${this.address}`,
+        { cause: e }
+      );
+    }
+    const leftovers = this.decodeDiffLeftovers(decoded, balances);
+    for (const { tokenIn, leftoverAmount } of leftovers) {
+      balances.upsert(tokenIn, leftoverAmount);
+    }
+  }
+  /**
+   * Resolves which tokens the diff-style call spends down to which leftovers.
+   *
+   * @param decoded - The viem-decoded adapter call
+   * @param _balances - Token balances before the call
+   * @throws When the adapter (or the specific function) has no balance-changes support
+   */
+  decodeDiffLeftovers(decoded, _balances) {
+    throw new Error(
+      `previewBalanceChanges is not supported for ${decoded.functionName} on ${this.contractType} adapter at ${this.address}`
+    );
+  }
   /**
    * Classifies an adapter call into a {@link LegacyAdapterOperation} using the
    * parsed call and credit-account transfer deltas.

package/dist/esm/plugins/adapters/contracts/AbstractCurveAdapter.js

@@ -0,0 +1,42 @@
+import { classifyCurveOperation } from "../transferHelpers.js";
+import { AbstractAdapterContract } from "./AbstractAdapter.js";
+class AbstractCurveAdapterContract extends AbstractAdapterContract {
+  /** @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164 */
+  classifyLegacyOperation(parsed, transfers) {
+    return classifyCurveOperation(parsed.functionName, transfers) ?? super.classifyLegacyOperation(parsed, transfers);
+  }
+  decodeDiffLeftovers(decoded, balances) {
+    const { functionName, args } = decoded;
+    switch (functionName) {
+      case "exchange_diff": {
+        const [i, , leftoverAmount] = args;
+        return [{ tokenIn: this.curveCoin(i), leftoverAmount }];
+      }
+      case "add_diff_liquidity_one_coin": {
+        const [leftoverAmount, i] = args;
+        return [{ tokenIn: this.curveCoin(i), leftoverAmount }];
+      }
+      case "remove_diff_liquidity_one_coin": {
+        const [leftoverAmount] = args;
+        return [{ tokenIn: this.lpToken, leftoverAmount }];
+      }
+      default:
+        return super.decodeDiffLeftovers(decoded, balances);
+    }
+  }
+  /**
+   * Resolves a Curve pool coin index to its token address.
+   *
+   * @throws When the index is out of range for the pool.
+   */
+  curveCoin(i) {
+    const token = this.tokens[Number(i)];
+    if (!token) {
+      throw new Error(`curve coin index ${i} is out of range`);
+    }
+    return token;
+  }
+}
+export {
+  AbstractCurveAdapterContract
+};

package/dist/esm/plugins/adapters/contracts/BalancerV3RouterAdapterContract.js

@@ -1,5 +1,7 @@
 import { iBalancerV3RouterAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import { decodeAbiParameters } from "viem";
+import {
+  decodeAbiParameters
+} from "viem";
 import { MissingSerializedParamsError } from "../../../sdk/index.js";
 import { iBalancerV3RouterAbi } from "../abi/targetContractAbi.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
@@ -69,6 +71,25 @@ class BalancerV3RouterAdapterContract extends AbstractAdapterContract {
       }))
     };
   }
+  decodeDiffLeftovers(decoded, balances) {
+    switch (decoded.functionName) {
+      case "swapSingleTokenDiffIn": {
+        const [, tokenIn, , leftoverAmount] = decoded.args;
+        return [{ tokenIn, leftoverAmount }];
+      }
+      // BPT (pool token) is spent down to the leftover
+      case "removeLiquiditySingleTokenDiff": {
+        const [pool, leftoverAmount] = decoded.args;
+        return [{ tokenIn: pool, leftoverAmount }];
+      }
+      case "addLiquidityUnbalancedDiff":
+        throw new Error(
+          `previewBalanceChanges cannot resolve pool tokens for addLiquidityUnbalancedDiff on ${this.contractType} adapter at ${this.address}`
+        );
+      default:
+        return super.decodeDiffLeftovers(decoded, balances);
+    }
+  }
 }
 export {
   BalancerV3PoolStatus,

package/dist/esm/plugins/adapters/contracts/BalancerV3WrapperAdapterContract.js

@@ -1,5 +1,7 @@
 import { iBalancerV3WrapperAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import { decodeAbiParameters } from "viem";
+import {
+  decodeAbiParameters
+} from "viem";
 import { MissingSerializedParamsError } from "../../../sdk/index.js";
 import { iBalancerV3WrapperAbi } from "../abi/targetContractAbi.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
@@ -32,6 +34,21 @@ class BalancerV3WrapperAdapterContract extends AbstractAdapterContract {
       balancerPoolToken: this.#balancerPoolToken ? this.labelAddress(this.#balancerPoolToken) : void 0
     };
   }
+  decodeDiffLeftovers(decoded, balances) {
+    switch (decoded.functionName) {
+      // mint spends the pool token, burn spends the wrapper (target contract)
+      case "mintDiff": {
+        const [leftoverAmount] = decoded.args;
+        return [{ tokenIn: this.balancerPoolToken, leftoverAmount }];
+      }
+      case "burnDiff": {
+        const [leftoverAmount] = decoded.args;
+        return [{ tokenIn: this.targetContract, leftoverAmount }];
+      }
+      default:
+        return super.decodeDiffLeftovers(decoded, balances);
+    }
+  }
 }
 export {
   BalancerV3WrapperAdapterContract