@gearbox-protocol/sdk 14.12.0-next.8 → 14.12.0-test.1

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

@@ -1,4 +1,3 @@
-import { iConvexV1BaseRewardPoolAdapterAbi } from "@gearbox-protocol/integrations-v3";
 import {
   decodeAbiParameters,
   zeroAddress
@@ -6,8 +5,8 @@ import {
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iConvexV1BaseRewardPoolAdapterAbi } from "../abi/adapters/index.js";
 import { iBaseRewardPoolAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover, copyBalances } from "../balanceChanges.js";
 import {
   allTransfersAsTokenAmounts,
   fnSigToName,
@@ -23,8 +22,8 @@ class ConvexV1BaseRewardPoolAdapterContract extends AbstractAdapterContract {
   #stakingToken;
   #stakedPhantomToken;
   #extraRewards;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -117,26 +116,24 @@ class ConvexV1BaseRewardPoolAdapterContract extends AbstractAdapterContract {
       withdrawAmount: swap.toAmount
     };
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  async applyBalanceChanges(balances, decoded) {
     switch (decoded.functionName) {
       case "stakeDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.stakingToken, leftoverAmount);
+        this.setLeftover(balances, this.stakingToken, leftoverAmount);
+        break;
       }
       case "withdrawDiff":
       case "withdrawDiffAndUnwrap": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          this.stakedPhantomToken,
-          leftoverAmount
-        );
+        this.setLeftover(balances, this.stakedPhantomToken, leftoverAmount);
+        break;
       }
       // no accrued rewards on a freshly opened account
       case "getReward":
-        return copyBalances(balances);
+        break;
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        await super.applyBalanceChanges(balances, decoded);
     }
   }
 }

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

@@ -4,17 +4,16 @@ import {
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
-import { iConvexV1BoosterAdapterAbi } from "../abi/iConvexV1BoosterAdapter.js";
+import { iConvexV1BoosterAdapterAbi } from "../abi/adapters/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;
 const protocolAbi = iBoosterAbi;
 class ConvexV1BoosterAdapterContract extends AbstractAdapterContract {
   #supportedPools;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -84,21 +83,23 @@ class ConvexV1BoosterAdapterContract extends AbstractAdapterContract {
     }
     return super.classifyLegacyOperation(parsed, transfers);
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  async applyBalanceChanges(balances, decoded) {
     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);
+        this.setLeftover(balances, pool.curveToken, leftoverAmount);
+        break;
       }
       case "withdrawDiff": {
         const [pid, leftoverAmount] = decoded.args;
         const pool = this.#mustFindPool(Number(pid));
-        return clampToLeftover(balances, pool.convexToken, leftoverAmount);
+        this.setLeftover(balances, pool.convexToken, leftoverAmount);
+        break;
       }
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        await super.applyBalanceChanges(balances, decoded);
     }
   }
   #mustFindPool(pid) {

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

@@ -1,25 +1,21 @@
-import { iCurveV1_2AssetsAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import {
-  decodeAbiParameters
-} from "viem";
+import { decodeAbiParameters } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iCurveV1_2AssetsAdapterAbi } from "../abi/adapters/index.js";
 import { iCurvePool_2Abi, iCurvePoolAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover, curveCoin } from "../balanceChanges.js";
-import { classifyCurveOperation } from "../transferHelpers.js";
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
+import { AbstractCurveAdapterContract } from "./AbstractCurveAdapter.js";
 const abi = iCurveV1_2AssetsAdapterAbi;
 const protocolAbi = [...iCurvePoolAbi, ...iCurvePool_2Abi];
-class Curve2AssetsAdapterContract extends AbstractAdapterContract {
+class Curve2AssetsAdapterContract extends AbstractCurveAdapterContract {
   #token;
   #lpToken;
   #metapoolBase;
   #use256;
   #tokens;
   #underlyings;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -85,36 +81,6 @@ class Curve2AssetsAdapterContract extends AbstractAdapterContract {
       underlyings: this.#underlyings?.map((t) => this.labelAddress(t))
     };
   }
-  /** @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);
-  }
-  previewDecodedBalanceChanges(balances, decoded) {
-    switch (decoded.functionName) {
-      case "exchange_diff": {
-        const [i, , leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "add_diff_liquidity_one_coin": {
-        const [leftoverAmount, i] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "remove_diff_liquidity_one_coin": {
-        const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.lpToken, leftoverAmount);
-      }
-      default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
-    }
-  }
 }
 export {
   Curve2AssetsAdapterContract

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

@@ -1,25 +1,21 @@
-import { iCurveV1_3AssetsAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import {
-  decodeAbiParameters
-} from "viem";
+import { decodeAbiParameters } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iCurveV1_3AssetsAdapterAbi } from "../abi/adapters/index.js";
 import { iCurvePool_3Abi, iCurvePoolAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover, curveCoin } from "../balanceChanges.js";
-import { classifyCurveOperation } from "../transferHelpers.js";
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
+import { AbstractCurveAdapterContract } from "./AbstractCurveAdapter.js";
 const abi = iCurveV1_3AssetsAdapterAbi;
 const protocolAbi = [...iCurvePoolAbi, ...iCurvePool_3Abi];
-class Curve3AssetsAdapterContract extends AbstractAdapterContract {
+class Curve3AssetsAdapterContract extends AbstractCurveAdapterContract {
   #token;
   #lpToken;
   #metapoolBase;
   #use256;
   #tokens;
   #underlyings;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -85,36 +81,6 @@ class Curve3AssetsAdapterContract extends AbstractAdapterContract {
       underlyings: this.#underlyings?.map((t) => this.labelAddress(t))
     };
   }
-  /** @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);
-  }
-  previewDecodedBalanceChanges(balances, decoded) {
-    switch (decoded.functionName) {
-      case "exchange_diff": {
-        const [i, , leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "add_diff_liquidity_one_coin": {
-        const [leftoverAmount, i] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "remove_diff_liquidity_one_coin": {
-        const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.lpToken, leftoverAmount);
-      }
-      default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
-    }
-  }
 }
 export {
   Curve3AssetsAdapterContract

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

@@ -1,25 +1,21 @@
-import { iCurveV1_4AssetsAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import {
-  decodeAbiParameters
-} from "viem";
+import { decodeAbiParameters } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iCurveV1_4AssetsAdapterAbi } from "../abi/adapters/index.js";
 import { iCurvePool_4Abi, iCurvePoolAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover, curveCoin } from "../balanceChanges.js";
-import { classifyCurveOperation } from "../transferHelpers.js";
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
+import { AbstractCurveAdapterContract } from "./AbstractCurveAdapter.js";
 const abi = iCurveV1_4AssetsAdapterAbi;
 const protocolAbi = [...iCurvePoolAbi, ...iCurvePool_4Abi];
-class Curve4AssetsAdapterContract extends AbstractAdapterContract {
+class Curve4AssetsAdapterContract extends AbstractCurveAdapterContract {
   #token;
   #lpToken;
   #metapoolBase;
   #use256;
   #tokens;
   #underlyings;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -90,36 +86,6 @@ class Curve4AssetsAdapterContract extends AbstractAdapterContract {
       underlyings: this.#underlyings?.map((t) => this.labelAddress(t))
     };
   }
-  /** @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);
-  }
-  previewDecodedBalanceChanges(balances, decoded) {
-    switch (decoded.functionName) {
-      case "exchange_diff": {
-        const [i, , leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "add_diff_liquidity_one_coin": {
-        const [leftoverAmount, i] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "remove_diff_liquidity_one_coin": {
-        const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.lpToken, leftoverAmount);
-      }
-      default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
-    }
-  }
 }
 export {
   Curve4AssetsAdapterContract

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

@@ -1,25 +1,21 @@
-import { iCurveV1_2AssetsAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import {
-  decodeAbiParameters
-} from "viem";
+import { decodeAbiParameters } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iCurveV1_2AssetsAdapterAbi } from "../abi/adapters/index.js";
 import { iCurvePool_2Abi, iCurvePoolAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover, curveCoin } from "../balanceChanges.js";
-import { classifyCurveOperation } from "../transferHelpers.js";
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
+import { AbstractCurveAdapterContract } from "./AbstractCurveAdapter.js";
 const abi = iCurveV1_2AssetsAdapterAbi;
 const protocolAbi = [...iCurvePoolAbi, ...iCurvePool_2Abi];
-class CurveV1AdapterStETHContract extends AbstractAdapterContract {
+class CurveV1AdapterStETHContract extends AbstractCurveAdapterContract {
   #token;
   #lpToken;
   #metapoolBase;
   #nCoins;
   #use256;
   #tokens;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -68,36 +64,6 @@ class CurveV1AdapterStETHContract extends AbstractAdapterContract {
     if (!this.#tokens) throw new MissingSerializedParamsError("tokens");
     return this.#tokens;
   }
-  /** @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);
-  }
-  previewDecodedBalanceChanges(balances, decoded) {
-    switch (decoded.functionName) {
-      case "exchange_diff": {
-        const [i, , leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "add_diff_liquidity_one_coin": {
-        const [leftoverAmount, i] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "remove_diff_liquidity_one_coin": {
-        const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.lpToken, leftoverAmount);
-      }
-      default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
-    }
-  }
 }
 export {
   CurveV1AdapterStETHContract

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

@@ -1,20 +1,16 @@
-import { iCurveV1StableNgAdapterAbi } from "@gearbox-protocol/integrations-v3";
-import {
-  decodeAbiParameters
-} from "viem";
+import { decodeAbiParameters } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iCurveV1StableNgAdapterAbi } from "../abi/adapters/index.js";
 import {
   iCurvePoolAbi,
   iCurvePoolStableNGAbi
 } from "../abi/targetContractAbi.js";
-import { clampToLeftover, curveCoin } from "../balanceChanges.js";
-import { classifyCurveOperation } from "../transferHelpers.js";
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
+import { AbstractCurveAdapterContract } from "./AbstractCurveAdapter.js";
 const abi = iCurveV1StableNgAdapterAbi;
 const protocolAbi = [...iCurvePoolAbi, ...iCurvePoolStableNGAbi];
-class CurveV1StableNGAdapterContract extends AbstractAdapterContract {
+class CurveV1StableNGAdapterContract extends AbstractCurveAdapterContract {
   #token;
   #lpToken;
   #metapoolBase;
@@ -22,8 +18,8 @@ class CurveV1StableNGAdapterContract extends AbstractAdapterContract {
   #use256;
   #tokens;
   #underlyings;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -101,36 +97,6 @@ class CurveV1StableNGAdapterContract extends AbstractAdapterContract {
       underlyings: this.#underlyings?.map((t) => this.labelAddress(t))
     };
   }
-  /** @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);
-  }
-  previewDecodedBalanceChanges(balances, decoded) {
-    switch (decoded.functionName) {
-      case "exchange_diff": {
-        const [i, , leftoverAmount] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "add_diff_liquidity_one_coin": {
-        const [leftoverAmount, i] = decoded.args;
-        return clampToLeftover(
-          balances,
-          curveCoin(this.tokens, i),
-          leftoverAmount
-        );
-      }
-      case "remove_diff_liquidity_one_coin": {
-        const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.lpToken, leftoverAmount);
-      }
-      default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
-    }
-  }
 }
 export {
   CurveV1StableNGAdapterContract

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

@@ -1,12 +1,11 @@
-import { iDaiUsdsAdapterAbi } from "@gearbox-protocol/integrations-v3";
 import {
   decodeAbiParameters
 } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { iDaiUsdsAdapterAbi } from "../abi/adapters/index.js";
 import { iDaiUsdsAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 const abi = iDaiUsdsAdapterAbi;
@@ -14,8 +13,8 @@ const protocolAbi = iDaiUsdsAbi;
 class DaiUsdsAdapterContract extends AbstractAdapterContract {
   #dai;
   #usds;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -56,18 +55,20 @@ class DaiUsdsAdapterContract extends AbstractAdapterContract {
     }
     return super.classifyLegacyOperation(parsed, transfers);
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  async applyBalanceChanges(balances, decoded) {
     switch (decoded.functionName) {
       case "daiToUsdsDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.dai, leftoverAmount);
+        this.setLeftover(balances, this.dai, leftoverAmount);
+        break;
       }
       case "usdsToDaiDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.usds, leftoverAmount);
+        this.setLeftover(balances, this.usds, leftoverAmount);
+        break;
       }
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        await super.applyBalanceChanges(balances, decoded);
     }
   }
 }

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

@@ -1,13 +1,12 @@
-import { ierc4626AdapterAbi } from "@gearbox-protocol/integrations-v3";
 import {
   decodeAbiParameters,
   zeroAddress
 } from "viem";
+import { ierc4626AdapterAbi } from "../../../abi/ierc4626Adapter.js";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
 import { iERC4626Abi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { fnSigToName, swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 const abi = ierc4626AdapterAbi;
@@ -15,8 +14,8 @@ const protocolAbi = iERC4626Abi;
 class ERC4626AdapterContract extends AbstractAdapterContract {
   #vault;
   #asset;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const version = Number(args.baseParams.version);
       if (version <= 311) {
@@ -53,6 +52,14 @@ class ERC4626AdapterContract extends AbstractAdapterContract {
     if (!this.#asset) throw new MissingSerializedParamsError("asset");
     return this.#asset;
   }
+  /**
+   * Vault share token: the serialized `vault` when set; for v<=311 the
+   * serialized vault is zeroAddress and the adapter targets the vault
+   * directly, so the target contract is the share token.
+   */
+  get share() {
+    return this.#vault && this.#vault !== zeroAddress ? this.#vault : this.targetContract;
+  }
   stateHuman(raw) {
     return {
       ...super.stateHuman(raw),
@@ -74,19 +81,34 @@ class ERC4626AdapterContract extends AbstractAdapterContract {
     }
     return super.classifyLegacyOperation(parsed, transfers);
   }
-  previewDecodedBalanceChanges(balances, decoded) {
-    const share = this.#vault && this.#vault !== zeroAddress ? this.#vault : this.targetContract;
+  async applyBalanceChanges(balances, decoded) {
     switch (decoded.functionName) {
       case "depositDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.asset, leftoverAmount);
+        this.setLeftover(balances, this.asset, leftoverAmount);
+        break;
       }
       case "redeemDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, share, leftoverAmount);
+        this.setLeftover(balances, this.share, leftoverAmount);
+        break;
+      }
+      // no-op:
+      // the only in-bracket producer of plain `redeem` is the
+      // withdrawal compressor, and sdk now encodes the spent
+      // shares as a negative storeExpectedBalances delta. The router never
+      // emits plain `redeem` — its workers use `redeemDiff` only. If the
+      // router (or another assembler) ever starts emitting in-bracket plain
+      // `redeem` without the negative delta, this case must decrease `share`
+      // by `shares` again (see commented-out lines). Out-of-bracket RWA
+      // wrap/unwrap `redeem` goes through applyRWAWrapUnwrap, not here.
+      case "redeem": {
+        break;
       }
+      // `withdraw`/`deposit`/`mint` stay unsupported: they are not emitted
+      // by the router (which uses diff variants) or the withdrawal compressor
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        await super.applyBalanceChanges(balances, decoded);
     }
   }
 }

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

@@ -1,12 +1,11 @@
-import { erc4626ReferralAdapterAbi } from "@gearbox-protocol/integrations-v3";
 import {
   decodeAbiParameters
 } from "viem";
 import {
   MissingSerializedParamsError
 } from "../../../sdk/index.js";
+import { erc4626ReferralAdapterAbi } from "../abi/adapters/index.js";
 import { iERC4626ReferralAbi } from "../abi/targetContractAbi.js";
-import { clampToLeftover } from "../balanceChanges.js";
 import { fnSigToName, swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 const abi = erc4626ReferralAdapterAbi;
@@ -14,8 +13,8 @@ const protocolAbi = iERC4626ReferralAbi;
 class ERC4626ReferralAdapterContract extends AbstractAdapterContract {
   #asset;
   #referral;
-  constructor(options, args) {
-    super(options, { ...args, abi, protocolAbi });
+  constructor(sdk, args) {
+    super(sdk, { ...args, abi, protocolAbi });
     if (args.baseParams.serializedParams) {
       const decoded = decodeAbiParameters(
         [
@@ -56,18 +55,20 @@ class ERC4626ReferralAdapterContract extends AbstractAdapterContract {
     }
     return super.classifyLegacyOperation(parsed, transfers);
   }
-  previewDecodedBalanceChanges(balances, decoded) {
+  async applyBalanceChanges(balances, decoded) {
     switch (decoded.functionName) {
       case "depositDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.asset, leftoverAmount);
+        this.setLeftover(balances, this.asset, leftoverAmount);
+        break;
       }
       case "redeemDiff": {
         const [leftoverAmount] = decoded.args;
-        return clampToLeftover(balances, this.targetContract, leftoverAmount);
+        this.setLeftover(balances, this.targetContract, leftoverAmount);
+        break;
       }
       default:
-        return super.previewDecodedBalanceChanges(balances, decoded);
+        await super.applyBalanceChanges(balances, decoded);
     }
   }
 }