@gearbox-protocol/sdk 14.12.0-next.8 → 14.12.0-next.9

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

@@ -41,15 +41,15 @@ class AbstractRouterContract extends import_base.BaseContract {
       options.debtOnly
     );
     const { leftoverBalances, expectedBalances, tokensToClaim } = b;
-    const expected = new import_utils.AddressMap();
-    const leftover = new import_utils.AddressMap();
+    const expected = new import_utils.AssetsMap();
+    const leftover = new import_utils.AssetsMap();
     for (const token of cm.collateralTokens) {
-      const actual = expectedBalances.get(token)?.balance || 0n;
-      expected.upsert(token, { token, balance: actual > 10n ? actual : 0n });
-      leftover.upsert(token, {
+      const actual = expectedBalances.get(token) || 0n;
+      expected.upsert(token, actual > 10n ? actual : 0n);
+      leftover.upsert(
         token,
-        balance: (0, import_helpers.limitLeftover)(leftoverBalances.get(token)?.balance || 1n, token) ?? 1n
-      });
+        (0, import_helpers.limitLeftover)(leftoverBalances.get(token) || 1n, token) ?? 1n
+      );
     }
     return {
       expectedBalances: expected,
@@ -58,8 +58,8 @@ class AbstractRouterContract extends import_base.BaseContract {
     };
   }
   getDefaultExpectedAndLeftover(ca, keepAssets, debtOnly) {
-    const expectedBalances = new import_utils.AddressMap();
-    const leftoverBalances = new import_utils.AddressMap();
+    const expectedBalances = new import_utils.AssetsMap();
+    const leftoverBalances = new import_utils.AssetsMap();
     const keepAssetsSet = new import_utils.AddressSet(keepAssets);
     if (debtOnly) {
       const result = this.getLeftoversAfterBuyingDebt(ca, keepAssetsSet);
@@ -71,23 +71,23 @@ class AbstractRouterContract extends import_base.BaseContract {
     }
     for (const { token, balance, mask } of ca.tokens) {
       const isEnabled = (mask & ca.enabledTokensMask) !== 0n;
-      expectedBalances.upsert(token, { token, balance });
+      expectedBalances.upsert(token, balance);
       if (keepAssetsSet.has(token) || !isEnabled || (0, import_utils.isDust)({
         sdk: this.sdk,
         token,
         balance,
         creditManager: ca.creditManager
       })) {
-        leftoverBalances.upsert(token, {
+        leftoverBalances.upsert(
           token,
-          balance: (0, import_helpers.limitLeftover)(balance, token) ?? balance
-        });
+          (0, import_helpers.limitLeftover)(balance, token) ?? balance
+        );
       }
     }
     return {
       expectedBalances,
       leftoverBalances,
-      tokensToClaim: new import_utils.AddressMap()
+      tokensToClaim: new import_utils.AssetsMap()
     };
   }
   /**
@@ -100,16 +100,13 @@ class AbstractRouterContract extends import_base.BaseContract {
     const { priceOracle } = this.sdk.marketRegister.findByCreditManager(
       ca.creditManager
     );
-    const expectedBalances = new import_utils.AddressMap();
-    const leftoverBalances = new import_utils.AddressMap();
+    const expectedBalances = new import_utils.AssetsMap();
+    const leftoverBalances = new import_utils.AssetsMap();
     const usdBalances = [];
     for (const { token, balance, mask } of ca.tokens) {
       const isEnabled = (mask & ca.enabledTokensMask) !== 0n;
-      expectedBalances.upsert(token, { token, balance });
-      leftoverBalances.upsert(token, {
-        token,
-        balance: (0, import_helpers.limitLeftover)(balance, token) ?? balance
-      });
+      expectedBalances.upsert(token, balance);
+      leftoverBalances.upsert(token, (0, import_helpers.limitLeftover)(balance, token) ?? balance);
       if (isEnabled && !keepAssets.has(token)) {
         usdBalances.push({
           token,
@@ -139,15 +136,12 @@ class AbstractRouterContract extends import_base.BaseContract {
     if (tokenAmount === 0n) {
       return void 0;
     }
-    let leftoverBalance = leftoverBalances.get(highestToken.token)?.balance ?? 0n;
+    let leftoverBalance = leftoverBalances.get(highestToken.token) ?? 0n;
     leftoverBalance -= tokenAmount;
     if (leftoverBalance < 0n) {
       return void 0;
     }
-    leftoverBalances.upsert(highestToken.token, {
-      token: highestToken.token,
-      balance: leftoverBalance
-    });
+    leftoverBalances.upsert(highestToken.token, leftoverBalance);
     const tokenAmountStr = this.sdk.tokensMeta.formatBN(
       highestToken.token,
       tokenAmount,
@@ -160,7 +154,7 @@ class AbstractRouterContract extends import_base.BaseContract {
     return {
       expectedBalances,
       leftoverBalances,
-      tokensToClaim: new import_utils.AddressMap()
+      tokensToClaim: new import_utils.AssetsMap()
     };
   }
   safeConvertToUSD(priceOracle, token, balance) {

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

@@ -23,14 +23,13 @@ __export(RouterV310Contract_exports, {
 module.exports = __toCommonJS(RouterV310Contract_exports);
 var import_viem = require("viem");
 var import_gearboxRouter = require("../../abi/router/gearboxRouter.js");
-var import_AddressMap = require("../utils/AddressMap.js");
 var import_formatter = require("../utils/formatter.js");
 var import_utils = require("../utils/index.js");
 var import_AbstractRouterContract = require("./AbstractRouterContract.js");
 var import_helpers = require("./helpers.js");
 const abi = import_gearboxRouter.gearboxRouterAbi;
 class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterContract {
-  #numSplits = new import_AddressMap.AddressMap();
+  #numSplits = new import_utils.AddressMap();
   #defaultNumSplits = 4n;
   constructor(sdk, address, version) {
     super(sdk, {
@@ -94,8 +93,8 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
       slippage
     } = props;
     const [expectedMap, leftoverMap] = [
-      (0, import_helpers.balancesMap)(expectedBalances),
-      (0, import_helpers.balancesMap)(leftoverBalances)
+      new import_utils.AssetsMap(expectedBalances),
+      new import_utils.AssetsMap(leftoverBalances)
     ];
     const getNumSplits = this.#numSplitsGetter(cm, expectedBalances);
     const tData = cm.collateralTokens.map(
@@ -180,22 +179,22 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
     } = props;
     const { expectedBalances, leftoverBalances, tokensToClaim } = this.getExpectedAndLeftover(ca, cm, {
       balances: balances ? {
-        expectedBalances: (0, import_helpers.assetsMap)(balances.expectedBalances),
-        leftoverBalances: (0, import_helpers.assetsMap)(balances.leftoverBalances),
-        tokensToClaim: (0, import_helpers.assetsMap)(balances.tokensToClaim || [])
+        expectedBalances: new import_utils.AssetsMap(balances.expectedBalances),
+        leftoverBalances: new import_utils.AssetsMap(balances.leftoverBalances),
+        tokensToClaim: new import_utils.AssetsMap(balances.tokensToClaim || [])
       } : void 0,
       keepAssets: balances ? void 0 : keepAssets,
       debtOnly
     });
-    const getNumSplits = this.#numSplitsGetter(cm, expectedBalances.values());
+    const getNumSplits = this.#numSplitsGetter(cm, expectedBalances.toAssets());
     const tData = [];
     for (const token of cm.collateralTokens) {
       tData.push({
         token,
-        balance: expectedBalances.get(token)?.balance || 0n,
-        leftoverBalance: (0, import_helpers.limitLeftover)(leftoverBalances.get(token)?.balance, token) ?? 0n,
+        balance: expectedBalances.get(token) || 0n,
+        leftoverBalance: (0, import_helpers.limitLeftover)(leftoverBalances.get(token), token) ?? 0n,
         numSplits: getNumSplits(token),
-        claimRewards: !!tokensToClaim.get(token)
+        claimRewards: tokensToClaim.has(token)
       });
     }
     this.logger?.debug(
@@ -278,7 +277,7 @@ class RouterV310Contract extends import_AbstractRouterContract.AbstractRouterCon
       })),
       "balances in usd"
     );
-    const map = new import_AddressMap.AddressMap(
+    const map = new import_utils.AddressMap(
       inUSD.map(({ token }, i) => [
         token,
         i === 0 ? this.#defaultNumSplits : 1n

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,61 @@
+"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
+    );
+  }
+  /**
+   * Adds `amount` to the token balance, treating a missing key as `0n`.
+   */
+  inc(address, amount) {
+    this.upsert(address, (this.get(address) ?? 0n) + amount);
+  }
+  /**
+   * Subtracts `amount` from the token balance, treating a missing key as `0n`.
+   */
+  dec(address, amount) {
+    this.inc(address, -amount);
+  }
+  /**
+   * Converts the map to an array of {@link Asset} objects.
+   */
+  toAssets() {
+    return this.entries().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/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/contracts/AbstractAdapter.js

@@ -107,9 +107,8 @@ class AbstractAdapterContract extends BaseContract {
    * 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. Not mutated.
+   * @param balances - Token balances before the call. Mutated in place.
    * @param calldata - Raw ABI-encoded adapter calldata.
-   * @returns A new balances map with the call's changes applied.
    * @throws When the calldata cannot be decoded or the adapter (or the
    * specific function) has no balance-changes support.
    */
@@ -123,17 +122,19 @@ class AbstractAdapterContract extends BaseContract {
         { cause: e }
       );
     }
-    return this.previewDecodedBalanceChanges(balances, decoded);
+    const leftovers = this.decodeDiffLeftovers(decoded, balances);
+    for (const { tokenIn, leftoverAmount } of leftovers) {
+      balances.upsert(tokenIn, leftoverAmount);
+    }
   }
   /**
-   * Typed hook for {@link previewBalanceChanges}: receives the viem-decoded
-   * adapter call, so overrides can switch on `decoded.functionName` and get
-   * fully-typed `decoded.args` without casts.
+   * Resolves which tokens the diff-style call spends down to which leftovers.
    *
-   * @throws When the adapter (or the specific function) has no balance-changes
-   * support; protocol-specific subclasses override this method.
+   * @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
    */
-  previewDecodedBalanceChanges(_balances, decoded) {
+  decodeDiffLeftovers(decoded, _balances) {
     throw new Error(
       `previewBalanceChanges is not supported for ${decoded.functionName} on ${this.contractType} adapter at ${this.address}`
     );

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

@@ -4,7 +4,6 @@ import {
 } from "viem";
 import { MissingSerializedParamsError } from "../../../sdk/index.js";
 import { iBalancerV3RouterAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 var BalancerV3PoolStatus = /* @__PURE__ */ ((BalancerV3PoolStatus2) => {
   BalancerV3PoolStatus2[BalancerV3PoolStatus2["NOT_ALLOWED"] = 0] = "NOT_ALLOWED";
@@ -72,23 +71,23 @@ class BalancerV3RouterAdapterContract extends AbstractAdapterContract {
       }))
     };
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  decodeDiffLeftovers(decoded, balances) {
     switch (decoded.functionName) {
       case "swapSingleTokenDiffIn": {
         const [, tokenIn, , leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, tokenIn, leftoverAmount);
+        return [{ tokenIn, leftoverAmount }];
       }
       // BPT (pool token) is spent down to the leftover
       case "removeLiquiditySingleTokenDiff": {
         const [pool, leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, pool, leftoverAmount);
+        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.previewDecodedBalanceChanges(balances, decoded);
+        return super.decodeDiffLeftovers(decoded, balances);
     }
   }
 }

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

@@ -4,7 +4,6 @@ import {
 } from "viem";
 import { MissingSerializedParamsError } from "../../../sdk/index.js";
 import { iBalancerV3WrapperAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 const abi = iBalancerV3WrapperAdapterAbi;
 const protocolAbi = iBalancerV3WrapperAbi;
@@ -35,23 +34,19 @@ class BalancerV3WrapperAdapterContract extends AbstractAdapterContract {
       balancerPoolToken: this.#balancerPoolToken ? this.labelAddress(this.#balancerPoolToken) : void 0
     };
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  decodeDiffLeftovers(decoded, balances) {
     switch (decoded.functionName) {
       // mint spends the pool token, burn spends the wrapper (target contract)
       case "mintDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          this.balancerPoolToken,
-          leftoverAmount
-        );
+        return [{ tokenIn: this.balancerPoolToken, leftoverAmount }];
       }
       case "burnDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.targetContract, leftoverAmount);
+        return [{ tokenIn: this.targetContract, leftoverAmount }];
       }
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        return super.decodeDiffLeftovers(decoded, balances);
     }
   }
 }

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

@@ -4,7 +4,6 @@ import {
 } from "viem";
 import { MissingSerializedParamsError } from "../../../sdk/index.js";
 import { iCamelotV3RouterAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 const abi = iCamelotV3AdapterAbi;
 const protocolAbi = iCamelotV3RouterAbi;
@@ -48,19 +47,24 @@ class CamelotV3AdapterContract extends AbstractAdapterContract {
       }))
     };
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  decodeDiffLeftovers(decoded, balances) {
     switch (decoded.functionName) {
       case "exactDiffInputSingle": {
         const [params] = decoded.args;
-        return clampToLeftover(balances, params.tokenIn, params.leftoverAmount);
+        return [
+          {
+            tokenIn: params.tokenIn,
+            leftoverAmount: params.leftoverAmount
+          }
+        ];
       }
       case "exactDiffInput": {
         const [params] = decoded.args;
         const tokenIn = `0x${params.path.replace("0x", "").slice(0, 40)}`;
-        return clampToLeftover(balances, tokenIn, params.leftoverAmount);
+        return [{ tokenIn, leftoverAmount: params.leftoverAmount }];
       }
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        return super.decodeDiffLeftovers(decoded, balances);
     }
   }
 }

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

@@ -7,7 +7,6 @@ import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
 import { iBaseRewardPoolAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover, copyBalances } from "../balanceChanges.js";
 import {
   allTransfersAsTokenAmounts,
   fnSigToName,
@@ -117,26 +116,22 @@ class ConvexV1BaseRewardPoolAdapterContract extends AbstractAdapterContract {
       withdrawAmount: swap.toAmount
     };
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  decodeDiffLeftovers(decoded, balances) {
     switch (decoded.functionName) {
       case "stakeDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.stakingToken, leftoverAmount);
+        return [{ tokenIn: this.stakingToken, leftoverAmount }];
       }
       case "withdrawDiff":
       case "withdrawDiffAndUnwrap": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          this.stakedPhantomToken,
-          leftoverAmount
-        );
+        return [{ tokenIn: this.stakedPhantomToken, leftoverAmount }];
       }
       // no accrued rewards on a freshly opened account
       case "getReward":
-        return copyBalances(balances);
+        return [];
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        return super.decodeDiffLeftovers(decoded, balances);
     }
   }
 }

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

@@ -6,7 +6,6 @@ import {
 } from "../../../sdk/index.js";
 import { iConvexV1BoosterAdapterAbi } from "../abi/iConvexV1BoosterAdapter.js";
 import { iBoosterAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { fnSigToName, swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 const abi = iConvexV1BoosterAdapterAbi;
@@ -84,21 +83,21 @@ class ConvexV1BoosterAdapterContract extends AbstractAdapterContract {
     }
     return super.classifyLegacyOperation(parsed, transfers);
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  decodeDiffLeftovers(decoded, balances) {
     switch (decoded.functionName) {
       // deposit spends the curve LP token, withdraw spends the convex token
       case "depositDiff": {
         const [pid, leftoverAmount] = decoded.args;
         const pool = this.#mustFindPool(Number(pid));
-        return clampToLeftover(balances, pool.curveToken, leftoverAmount);
+        return [{ tokenIn: pool.curveToken, leftoverAmount }];
       }
       case "withdrawDiff": {
         const [pid, leftoverAmount] = decoded.args;
         const pool = this.#mustFindPool(Number(pid));
-        return clampToLeftover(balances, pool.convexToken, leftoverAmount);
+        return [{ tokenIn: pool.convexToken, leftoverAmount }];
       }
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        return super.decodeDiffLeftovers(decoded, balances);
     }
   }
   #mustFindPool(pid) {