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

package/dist/cjs/plugins/adapters/contracts/UniswapV4AdapterContract.js

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(UniswapV4AdapterContract_exports);
 var import_integrations_v3 = require("@gearbox-protocol/integrations-v3");
 var import_viem = require("viem");
 var import_sdk = require("../../../sdk/index.js");
+var import_balanceChanges = require("../balanceChanges.js");
 var import_transferHelpers = require("../transferHelpers.js");
 var import_AbstractAdapter = require("./AbstractAdapter.js");
 const abi = import_integrations_v3.iUniswapV4AdapterAbi;
@@ -81,6 +82,20 @@ class UniswapV4AdapterContract extends import_AbstractAdapter.AbstractAdapterCon
   classifyLegacyOperation(_parsed, transfers) {
     return { operation: "UniswapSwap", ...(0, import_transferHelpers.swapFromTransfers)(transfers) };
   }
+  previewDecodedBalanceChanges(balances, decoded) {
+    switch (decoded.functionName) {
+      case "swapExactInputSingleDiff": {
+        const [poolKey, zeroForOne, leftoverAmount] = decoded.args;
+        return (0, import_balanceChanges.clampToLeftover)(
+          balances,
+          zeroForOne ? poolKey.token0 : poolKey.token1,
+          leftoverAmount
+        );
+      }
+      default:
+        return super.previewDecodedBalanceChanges(balances, decoded);
+    }
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/plugins/adapters/contracts/UpshiftVaultAdapterContract.js

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(UpshiftVaultAdapterContract_exports);
 var import_integrations_v3 = require("@gearbox-protocol/integrations-v3");
 var import_viem = require("viem");
 var import_sdk = require("../../../sdk/index.js");
+var import_balanceChanges = require("../balanceChanges.js");
 var import_AbstractAdapter = require("./AbstractAdapter.js");
 const abi = import_integrations_v3.iUpshiftVaultAdapterAbi;
 const protocolAbi = import_integrations_v3.iUpshiftVaultGatewayAbi;
@@ -70,6 +71,20 @@ class UpshiftVaultAdapterContract extends import_AbstractAdapter.AbstractAdapter
       stakedPhantomToken: this.#stakedPhantomToken ? this.labelAddress(this.#stakedPhantomToken) : void 0
     };
   }
+  previewDecodedBalanceChanges(balances, decoded) {
+    switch (decoded.functionName) {
+      case "depositDiff": {
+        const [leftoverAmount] = decoded.args;
+        return (0, import_balanceChanges.clampToLeftover)(balances, this.asset, leftoverAmount);
+      }
+      case "redeemDiff": {
+        const [leftoverAmount] = decoded.args;
+        return (0, import_balanceChanges.clampToLeftover)(balances, this.vault, leftoverAmount);
+      }
+      default:
+        return super.previewDecodedBalanceChanges(balances, decoded);
+    }
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/plugins/adapters/contracts/VelodromeV2AdapterContract.js

@@ -25,6 +25,7 @@ var import_integrations_v3 = require("@gearbox-protocol/integrations-v3");
 var import_viem = require("viem");
 var import_sdk = require("../../../sdk/index.js");
 var import_targetContractAbi = require("../abi/targetContractAbi.js");
+var import_balanceChanges = require("../balanceChanges.js");
 var import_AbstractAdapter = require("./AbstractAdapter.js");
 const abi = import_integrations_v3.iVelodromeV2RouterAdapterAbi;
 const protocolAbi = import_targetContractAbi.iVelodromeV2RouterAbi;
@@ -74,6 +75,16 @@ class VelodromeV2RouterAdapterContract extends import_AbstractAdapter.AbstractAd
       }))
     };
   }
+  previewDecodedBalanceChanges(balances, decoded) {
+    switch (decoded.functionName) {
+      case "swapDiffTokensForTokens": {
+        const [leftoverAmount, , routes] = decoded.args;
+        return (0, import_balanceChanges.clampToLeftover)(balances, routes[0].from, leftoverAmount);
+      }
+      default:
+        return super.previewDecodedBalanceChanges(balances, decoded);
+    }
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/plugins/adapters/contracts/WstETHV1AdapterContract.js

@@ -25,6 +25,7 @@ var import_integrations_v3 = require("@gearbox-protocol/integrations-v3");
 var import_viem = require("viem");
 var import_sdk = require("../../../sdk/index.js");
 var import_targetContractAbi = require("../abi/targetContractAbi.js");
+var import_balanceChanges = require("../balanceChanges.js");
 var import_transferHelpers = require("../transferHelpers.js");
 var import_AbstractAdapter = require("./AbstractAdapter.js");
 const abi = import_integrations_v3.iwstEthv1AdapterAbi;
@@ -65,6 +66,21 @@ class WstETHV1AdapterContract extends import_AbstractAdapter.AbstractAdapterCont
     }
     return super.classifyLegacyOperation(parsed, transfers);
   }
+  previewDecodedBalanceChanges(balances, decoded) {
+    switch (decoded.functionName) {
+      case "wrapDiff": {
+        const [leftoverAmount] = decoded.args;
+        return (0, import_balanceChanges.clampToLeftover)(balances, this.stETH, leftoverAmount);
+      }
+      // wstETH is the adapter's target contract
+      case "unwrapDiff": {
+        const [leftoverAmount] = decoded.args;
+        return (0, import_balanceChanges.clampToLeftover)(balances, this.targetContract, leftoverAmount);
+      }
+      default:
+        return super.previewDecodedBalanceChanges(balances, decoded);
+    }
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/plugins/adapters/index.js

@@ -17,6 +17,7 @@ var adapters_exports = {};
 module.exports = __toCommonJS(adapters_exports);
 __reExport(adapters_exports, require("./AdaptersPlugin.js"), module.exports);
 __reExport(adapters_exports, require("./abi/index.js"), module.exports);
+__reExport(adapters_exports, require("./balanceChanges.js"), module.exports);
 __reExport(adapters_exports, require("./contracts/index.js"), module.exports);
 __reExport(adapters_exports, require("./createAdapter.js"), module.exports);
 __reExport(adapters_exports, require("./legacyAdapterOperations.js"), module.exports);
@@ -26,6 +27,7 @@ __reExport(adapters_exports, require("./types.js"), module.exports);
 0 && (module.exports = {
   ...require("./AdaptersPlugin.js"),
   ...require("./abi/index.js"),
+  ...require("./balanceChanges.js"),
   ...require("./contracts/index.js"),
   ...require("./createAdapter.js"),
   ...require("./legacyAdapterOperations.js"),

package/dist/cjs/preview/preview/errors.js

@@ -18,9 +18,24 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var errors_exports = {};
 __export(errors_exports, {
+  InvalidTransactionValueError: () => InvalidTransactionValueError,
   UnsupportedOperationError: () => UnsupportedOperationError
 });
 module.exports = __toCommonJS(errors_exports);
+class InvalidTransactionValueError extends Error {
+  /** Transaction `msg.value`. */
+  value;
+  /** Amount of wrapped native token added as collateral. */
+  wethCollateral;
+  constructor(value, wethCollateral) {
+    super(
+      `transaction value ${value} exceeds WETH collateral ${wethCollateral}`
+    );
+    this.name = "InvalidTransactionValueError";
+    this.value = value;
+    this.wethCollateral = wethCollateral;
+  }
+}
 class UnsupportedOperationError extends Error {
   /** The parsed operation kind (the `operation` discriminant). */
   operation;
@@ -32,5 +47,6 @@ class UnsupportedOperationError extends Error {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  InvalidTransactionValueError,
   UnsupportedOperationError
 });

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

@@ -22,22 +22,44 @@ __export(extractExpectedBalanceChanges_exports, {
 });
 module.exports = __toCommonJS(extractExpectedBalanceChanges_exports);
 function extractExpectedBalanceChanges(innerCalls) {
-  const calls = innerCalls.filter(
-    (call) => functionName(call) !== "onDemandPriceUpdates"
-  );
-  if (calls.length === 0) {
-    return void 0;
+  const storeIndices = [];
+  const compareIndices = [];
+  for (let i = 0; i < innerCalls.length; i++) {
+    const name = functionName(innerCalls[i]);
+    if (name === "storeExpectedBalances") {
+      storeIndices.push(i);
+    } else if (name === "compareBalances") {
+      compareIndices.push(i);
+    }
   }
-  const first = calls[0];
-  const last = calls[calls.length - 1];
-  if (functionName(first) !== "storeExpectedBalances" || functionName(last) !== "compareBalances") {
+  if (storeIndices.length === 0 && compareIndices.length === 0) {
     return void 0;
   }
-  const balanceDeltas = first.rawArgs.balanceDeltas;
+  if (storeIndices.length !== 1 || compareIndices.length !== 1) {
+    throw new Error(
+      `malformed multicall: expected exactly one storeExpectedBalances/compareBalances pair, got ${storeIndices.length} storeExpectedBalances and ${compareIndices.length} compareBalances calls`
+    );
+  }
+  if (compareIndices[0] < storeIndices[0]) {
+    throw new Error(
+      "malformed multicall: compareBalances appears before storeExpectedBalances"
+    );
+  }
+  const store = innerCalls[storeIndices[0]];
+  const balanceDeltas = store.rawArgs.balanceDeltas;
   if (!balanceDeltas) {
-    return void 0;
+    throw new Error(
+      "malformed multicall: storeExpectedBalances has no balanceDeltas argument"
+    );
   }
-  return balanceDeltas.map(({ token, amount }) => ({ token, balance: amount }));
+  return {
+    deltas: balanceDeltas.map(({ token, amount }) => ({
+      token,
+      balance: amount
+    })),
+    startIndex: storeIndices[0],
+    endIndex: compareIndices[0]
+  };
 }
 function functionName(call) {
   return call.functionName.split("(")[0];

package/dist/cjs/preview/preview/previewOpenCreditAccount.js

@@ -21,10 +21,12 @@ __export(previewOpenCreditAccount_exports, {
   previewOpenCreditAccount: () => previewOpenCreditAccount
 });
 module.exports = __toCommonJS(previewOpenCreditAccount_exports);
+var import_adapters = require("../../plugins/adapters/index.js");
 var import_sdk = require("../../sdk/index.js");
 var import_extractExpectedBalanceChanges = require("./extractExpectedBalanceChanges.js");
+var import_unwrapNativeCollateral = require("./unwrapNativeCollateral.js");
 function previewOpenCreditAccount(input, operation) {
-  const { sdk, to, calldata } = input;
+  const { sdk, to, calldata, value = 0n } = input;
   const market = sdk.marketRegister.findByCreditManager(
     operation.creditManager
   );
@@ -62,21 +64,49 @@ function previewOpenCreditAccount(input, operation) {
         break;
     }
   }
-  const collateral = collateralByToken.values();
+  let collateral = collateralByToken.values();
   const collateralValue = collateral.reduce(
     (acc, { token, balance }) => acc + market.priceOracle.convert(token, market.underlying, balance),
     0n
   );
+  collateral = (0, import_unwrapNativeCollateral.unwrapNativeCollateral)(
+    collateral,
+    value,
+    sdk.addressProvider.getAddress(import_sdk.AP_WETH_TOKEN, import_sdk.NO_VERSION)
+  );
   const parsed = sdk.parseFunctionDataV2(to, calldata);
   const innerCalls = parsed.rawArgs.calls ?? [];
-  const deltas = (0, import_extractExpectedBalanceChanges.extractExpectedBalanceChanges)(innerCalls) ?? [];
-  for (const { token, balance } of deltas) {
-    addBalance(token, balance);
+  const expected = (0, import_extractExpectedBalanceChanges.extractExpectedBalanceChanges)(innerCalls);
+  let finalBalances = balances;
+  if (expected) {
+    const rawCalls = extractRawInnerCalls(sdk, to, calldata);
+    if (rawCalls.length !== innerCalls.length) {
+      throw new Error(
+        `raw and parsed inner calls of ${to} are misaligned: ${rawCalls.length} raw vs ${innerCalls.length} parsed`
+      );
+    }
+    const snapshot = (0, import_adapters.copyBalances)(balances);
+    for (let i = expected.startIndex + 1; i < expected.endIndex; i++) {
+      const call = rawCalls[i];
+      const adapter = sdk.getContract(call.target);
+      if (!(adapter instanceof import_adapters.AbstractAdapterContract)) {
+        throw new Error(
+          `call to ${call.target} between storeExpectedBalances and compareBalances is not an adapter call`
+        );
+      }
+      finalBalances = adapter.previewBalanceChanges(
+        finalBalances,
+        call.callData
+      );
+    }
+    for (const { token, balance } of expected.deltas) {
+      finalBalances.upsert(token, (snapshot.get(token) ?? 0n) + balance);
+    }
   }
-  const assets = balances.entries().filter(([, balance]) => balance > 1n).map(([token, balance]) => ({ token, balance }));
+  const assets = finalBalances.entries().filter(([, balance]) => balance > 1n).map(([token, balance]) => ({ token, balance }));
   return {
     operation: operation.operation,
-    target: inferTargetAsset(operation.multicall, balances),
+    target: inferTargetAsset(operation.multicall, finalBalances),
     collateral,
     collateralValue,
     debt,
@@ -84,6 +114,15 @@ function previewOpenCreditAccount(input, operation) {
     assets
   };
 }
+function extractRawInnerCalls(sdk, to, calldata) {
+  const entry = sdk.getContract(to);
+  if (entry instanceof import_sdk.CreditFacadeV310BaseContract || entry instanceof import_sdk.SecuritizeRWAFactory) {
+    return entry.extractRawInnerCalls(calldata);
+  }
+  throw new Error(
+    `cannot extract raw inner calls from ${to}: neither a credit facade nor a supported RWA factory`
+  );
+}
 function inferTargetAsset(multicall, balances) {
   for (const op of multicall) {
     if (op.operation === "UpdateQuota" && op.change > 0n) {

package/dist/cjs/preview/preview/unwrapNativeCollateral.js

@@ -0,0 +1,59 @@
+"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 unwrapNativeCollateral_exports = {};
+__export(unwrapNativeCollateral_exports, {
+  unwrapNativeCollateral: () => unwrapNativeCollateral
+});
+module.exports = __toCommonJS(unwrapNativeCollateral_exports);
+var import_viem = require("viem");
+var import_sdk = require("../../sdk/index.js");
+var import_errors = require("./errors.js");
+function unwrapNativeCollateral(collateral, nativeAmount, wethToken) {
+  if (nativeAmount === 0n) {
+    return collateral;
+  }
+  let unwrapped = false;
+  const result = [];
+  for (const asset of collateral) {
+    const isWeth = !unwrapped && (0, import_viem.isAddressEqual)(asset.token, wethToken);
+    if (!isWeth) {
+      result.push(asset);
+      continue;
+    }
+    if (asset.balance < nativeAmount) {
+      throw new import_errors.InvalidTransactionValueError(nativeAmount, asset.balance);
+    }
+    result.push({ token: import_sdk.NATIVE_ADDRESS, balance: nativeAmount });
+    if (asset.balance > nativeAmount) {
+      result.push({
+        token: asset.token,
+        balance: asset.balance - nativeAmount
+      });
+    }
+    unwrapped = true;
+  }
+  if (!unwrapped) {
+    throw new import_errors.InvalidTransactionValueError(nativeAmount, 0n);
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  unwrapNativeCollateral
+});

package/dist/cjs/sdk/market/credit/CreditFacadeV310BaseContract.js

@@ -22,6 +22,7 @@ __export(CreditFacadeV310BaseContract_exports, {
   creditFacadeV310Abi: () => abi
 });
 module.exports = __toCommonJS(CreditFacadeV310BaseContract_exports);
+var import_viem = require("viem");
 var import_generated = require("../../../abi/310/generated.js");
 var import_iPausable = require("../../../abi/iPausable.js");
 var import_base = require("../../base/index.js");
@@ -34,6 +35,36 @@ class CreditFacadeV310BaseContract extends import_base.BaseContract {
   constructor(options, args) {
     super(options, { ...args, abi });
   }
+  /**
+   * Decodes entry-point calldata with the facade ABI and returns the untouched
+   * inner multicall structs (targets with still-ABI-encoded `callData`).
+   *
+   * Unlike {@link ChainContractsRegister.parseMultiCallV2}, the inner calls are
+   * not decoded, so callers can re-decode them with a specific contract's ABI.
+   *
+   * @throws When the calldata cannot be decoded or the function has no inner
+   * multicall argument.
+   */
+  extractRawInnerCalls(calldata) {
+    const decoded = (0, import_viem.decodeFunctionData)({ abi: this.abi, data: calldata });
+    switch (decoded.functionName) {
+      case "openCreditAccount":
+      case "closeCreditAccount":
+      case "botMulticall":
+      case "multicall": {
+        const [, calls] = decoded.args;
+        return [...calls];
+      }
+      case "liquidateCreditAccount": {
+        const [, , calls] = decoded.args;
+        return [...calls];
+      }
+      default:
+        throw new Error(
+          `function ${decoded.functionName} on ${this.name} has no inner multicall`
+        );
+    }
+  }
   parseFunctionParamsV2(params, strict) {
     switch (params.functionName) {
       case "openCreditAccount": {

package/dist/cjs/sdk/market/rwa/securitize/SecuritizeRWAFactory.js

@@ -70,6 +70,31 @@ class SecuritizeRWAFactory extends import_base.BaseContract {
       operators: [...t.operators]
     }));
   }
+  /**
+   * Decodes entry-point calldata with the factory ABI and returns the
+   * untouched inner multicall structs (targets with still-ABI-encoded
+   * `callData`).
+   *
+   * Unlike {@link ChainContractsRegister.parseMultiCallV2}, the inner calls are
+   * not decoded, so callers can re-decode them with a specific contract's ABI.
+   *
+   * @throws When the calldata cannot be decoded or the function has no inner
+   * multicall argument.
+   */
+  extractRawInnerCalls(calldata) {
+    const decoded = (0, import_viem.decodeFunctionData)({ abi: this.abi, data: calldata });
+    switch (decoded.functionName) {
+      case "openCreditAccount":
+      case "multicall": {
+        const [, calls] = decoded.args;
+        return [...calls];
+      }
+      default:
+        throw new Error(
+          `function ${decoded.functionName} on ${this.name} has no inner multicall`
+        );
+    }
+  }
   parseFunctionParamsV2(params, strict) {
     switch (params.functionName) {
       case "openCreditAccount": {

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/balanceChanges.js

@@ -0,0 +1,21 @@
+import { AddressMap } from "../../sdk/index.js";
+function copyBalances(balances) {
+  return new AddressMap(balances.entries());
+}
+function clampToLeftover(balances, tokenIn, leftoverAmount) {
+  const next = copyBalances(balances);
+  next.upsert(tokenIn, leftoverAmount);
+  return next;
+}
+function curveCoin(tokens, i) {
+  const token = tokens[Number(i)];
+  if (!token) {
+    throw new Error(`curve coin index ${i} is out of range`);
+  }
+  return token;
+}
+export {
+  clampToLeftover,
+  copyBalances,
+  curveCoin
+};

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

@@ -103,6 +103,41 @@ 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. Not mutated.
+   * @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.
+   */
+  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 }
+      );
+    }
+    return this.previewDecodedBalanceChanges(balances, decoded);
+  }
+  /**
+   * 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.
+   *
+   * @throws When the adapter (or the specific function) has no balance-changes
+   * support; protocol-specific subclasses override this method.
+   */
+  previewDecodedBalanceChanges(_balances, decoded) {
+    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/BalancerV3RouterAdapterContract.js

@@ -1,7 +1,10 @@
 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 { clampToLeftover } from "../balanceChanges.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 var BalancerV3PoolStatus = /* @__PURE__ */ ((BalancerV3PoolStatus2) => {
   BalancerV3PoolStatus2[BalancerV3PoolStatus2["NOT_ALLOWED"] = 0] = "NOT_ALLOWED";
@@ -69,6 +72,25 @@ class BalancerV3RouterAdapterContract extends AbstractAdapterContract {
       }))
     };
   }
+  previewDecodedBalanceChanges(balances, decoded) {
+    switch (decoded.functionName) {
+      case "swapSingleTokenDiffIn": {
+        const [, tokenIn, , leftoverAmount] = decoded.args;
+        return clampToLeftover(balances, tokenIn, leftoverAmount);
+      }
+      // BPT (pool token) is spent down to the leftover
+      case "removeLiquiditySingleTokenDiff": {
+        const [pool, leftoverAmount] = decoded.args;
+        return clampToLeftover(balances, 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);
+    }
+  }
 }
 export {
   BalancerV3PoolStatus,