@t2000/sdk 1.24.1 → 1.24.2

package/dist/index.d.cts

@@ -992,6 +992,22 @@ interface HarvestPlan {
     /** Display-units USDC that will be deposited to the NAVI USDC pool. */
     expectedUsdcDeposited: number;
 }
+/**
+ * Callback invoked right before the harvest's internal `addSaveToTx`.
+ * Mirrors the shape of `composeTx`'s `feeHooks.save_deposit` so audric's
+ * existing hook can be threaded straight through without adapters. The
+ * SDK never invents a fee — the host decides whether to skim from
+ * `coin` and to where. See CLAUDE.md rule #9 (fees are a host concern).
+ */
+type HarvestSaveFeeHook = (ctx: {
+    tx: Transaction;
+    coin: TransactionObjectArgument;
+    input: {
+        asset: 'USDC';
+        amount: number;
+    };
+    sender: string;
+}) => void | Promise<void>;
 interface BuildHarvestRewardsTxOptions {
     /** Per-swap slippage tolerance (0.001–0.05). Defaults to 0.01 (1%). */
     slippage?: number;
@@ -1014,6 +1030,27 @@ interface BuildHarvestRewardsTxOptions {
      * Pyth-free. Non-sponsored callers omit this.
      */
     providers?: string[];
+    /**
+     * [v1.24.2 fee wiring] Overlay fee forwarded to EACH internal
+     * `addSwapToTx` call. When set, every swap leg charges the rate to
+     * the receiver (typically `T2000_OVERLAY_FEE_WALLET` for audric).
+     * Omit for fee-free harvests (CLI / direct SDK callers).
+     */
+    overlayFee?: OverlayFeeConfig;
+    /**
+     * [v1.24.2 fee wiring] Fired immediately before the internal
+     * `addSaveToTx` consumes the merged USDC deposit coin. The hook
+     * receives the deposit handle so it can split a fee off via
+     * `addFeeTransfer(...)` (host's call). Audric threads its
+     * `feeHooks.save_deposit` straight through here so a harvest's
+     * deposit leg pays the same `SAVE_FEE_BPS` as a single-op `save`.
+     *
+     * Order is load-bearing: this hook fires AFTER all USDC handles
+     * are merged into one and BEFORE the NAVI deposit consumes it.
+     * Fee receiver gets recorded as a top-level transferObjects, so
+     * it's automatically picked up by `derivedAllowedAddresses`.
+     */
+    saveFeeHook?: HarvestSaveFeeHook;
 }
 /**
  * Standalone harvest builder — creates a fresh PTB, sets the sender,

package/dist/index.d.ts

@@ -992,6 +992,22 @@ interface HarvestPlan {
     /** Display-units USDC that will be deposited to the NAVI USDC pool. */
     expectedUsdcDeposited: number;
 }
+/**
+ * Callback invoked right before the harvest's internal `addSaveToTx`.
+ * Mirrors the shape of `composeTx`'s `feeHooks.save_deposit` so audric's
+ * existing hook can be threaded straight through without adapters. The
+ * SDK never invents a fee — the host decides whether to skim from
+ * `coin` and to where. See CLAUDE.md rule #9 (fees are a host concern).
+ */
+type HarvestSaveFeeHook = (ctx: {
+    tx: Transaction;
+    coin: TransactionObjectArgument;
+    input: {
+        asset: 'USDC';
+        amount: number;
+    };
+    sender: string;
+}) => void | Promise<void>;
 interface BuildHarvestRewardsTxOptions {
     /** Per-swap slippage tolerance (0.001–0.05). Defaults to 0.01 (1%). */
     slippage?: number;
@@ -1014,6 +1030,27 @@ interface BuildHarvestRewardsTxOptions {
      * Pyth-free. Non-sponsored callers omit this.
      */
     providers?: string[];
+    /**
+     * [v1.24.2 fee wiring] Overlay fee forwarded to EACH internal
+     * `addSwapToTx` call. When set, every swap leg charges the rate to
+     * the receiver (typically `T2000_OVERLAY_FEE_WALLET` for audric).
+     * Omit for fee-free harvests (CLI / direct SDK callers).
+     */
+    overlayFee?: OverlayFeeConfig;
+    /**
+     * [v1.24.2 fee wiring] Fired immediately before the internal
+     * `addSaveToTx` consumes the merged USDC deposit coin. The hook
+     * receives the deposit handle so it can split a fee off via
+     * `addFeeTransfer(...)` (host's call). Audric threads its
+     * `feeHooks.save_deposit` straight through here so a harvest's
+     * deposit leg pays the same `SAVE_FEE_BPS` as a single-op `save`.
+     *
+     * Order is load-bearing: this hook fires AFTER all USDC handles
+     * are merged into one and BEFORE the NAVI deposit consumes it.
+     * Fee receiver gets recorded as a top-level transferObjects, so
+     * it's automatically picked up by `derivedAllowedAddresses`.
+     */
+    saveFeeHook?: HarvestSaveFeeHook;
 }
 /**
  * Standalone harvest builder — creates a fresh PTB, sets the sender,

package/dist/index.js

@@ -7566,7 +7566,8 @@ async function addHarvestToTx(tx, client, address, options = {}) {
         amount: aggRow.amount,
         slippage,
         inputCoin: coin,
-        providers: options.providers
+        providers: options.providers,
+        overlayFee: options.overlayFee
       });
       usdcHandles.push(swapResult.coin);
       expectedUsdcDeposited += swapResult.expectedAmountOut;
@@ -7600,6 +7601,14 @@ async function addHarvestToTx(tx, client, address, options = {}) {
       tx.mergeCoins(primary, rest);
       depositCoin = primary;
     }
+    if (options.saveFeeHook) {
+      await options.saveFeeHook({
+        tx,
+        coin: depositCoin,
+        input: { asset: "USDC", amount: expectedUsdcDeposited },
+        sender: address
+      });
+    }
     try {
       await addSaveToTx(tx, client, address, depositCoin, { asset: "USDC" });
     } catch (err) {
@@ -7837,7 +7846,9 @@ var WRITE_APPENDER_REGISTRY = {
     const plan = await addHarvestToTx(tx, ctx.client, ctx.sender, {
       slippage: input.slippage,
       minRewardUsd: input.minRewardUsd,
-      providers
+      providers,
+      overlayFee: ctx.overlayFee,
+      saveFeeHook: ctx.feeHooks?.save_deposit
     });
     return {
       preview: {