@t2000/sdk 1.24.1 → 1.24.3

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-D03bON1v.cjs';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-D03bON1v.cjs';
+import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-DvNhsBbN.cjs';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-DvNhsBbN.cjs';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-BnbL3xN8.cjs';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-BnbL3xN8.cjs';
 import { i as T2000Options, P as PayOptions, c as PayResult, j as StakeVSuiResult, U as UnstakeVSuiResult, k as SwapResult, l as SwapQuoteResult, h as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, m as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, g as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, d as PendingReward, C as ClaimRewardsResult, n as CompoundRewardsResult, f as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, o as FinancialSummary } from './types-jAD-e7Pq.cjs';
@@ -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

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-DCb8Xt_q.js';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-DCb8Xt_q.js';
+import { V as TxMetadata, q as SafeguardConfig, T as T2000Error, R as TransactionSigner, a1 as ZkLoginProof, x as SupportedAsset, l as OverlayFeeConfig, y as SwapRouteResult } from './types-D1-rO-J4.js';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, aB as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, aC as OPERATION_ASSETS, O as OUTBOUND_OPS, k as OVERLAY_FEE_RATE, aD as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, m as STABLE_ASSETS, n as SUI_DECIMALS, o as SUI_TYPE, p as SUPPORTED_ASSETS, r as SafeguardError, s as SafeguardErrorDetails, t as SafeguardRule, u as SimulationResult, v as StableAsset, w as SuiRpcTxBlock, z as T2000ErrorCode, H as T2000ErrorData, J as T2000_OVERLAY_FEE_WALLET, Q as TOKEN_MAP, U as TxDirection, W as USDC_DECIMALS, X as USDC_TYPE, Y as USDE_TYPE, Z as USDSUI_TYPE, _ as USDT_TYPE, $ as WAL_TYPE, a0 as WBTC_TYPE, a2 as ZkLoginSigner, a3 as addFeeTransfer, aE as addSwapToTx, aF as assertAllowedAsset, a4 as buildSwapTx, a5 as calculateFee, a6 as classifyAction, a7 as classifyLabel, a8 as classifyTransaction, a9 as extractTransferDetails, aa as extractTxCommands, ab as extractTxSender, ac as fallbackLabel, ad as findSwapRoute, ae as formatAssetAmount, af as formatSui, ag as formatUsd, aG as getCoinMeta, ah as getDecimals, ai as getDecimalsForCoinType, aj as getTier, aH as isAllowedAsset, aI as isInRegistry, ak as isSupported, al as isTier1, am as isTier2, an as mapMoveAbortCode, ao as mapWalletError, ap as mistToSui, aJ as normalizeAsset, aK as normalizeCoinType, aq as parseSuiRpcTx, aL as queryHistory, aM as queryTransaction, ar as rawToStable, as as rawToUsdc, at as refineLendingLabel, au as resolveSymbol, av as resolveTokenType, aN as simulateTransaction, aw as stableToRaw, ax as suiToMist, aO as throwIfSimulationFailed, ay as truncateAddress, az as usdcToRaw, aA as validateAddress } from './types-D1-rO-J4.js';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-BnbL3xN8.js';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-BnbL3xN8.js';
 import { i as T2000Options, P as PayOptions, c as PayResult, j as StakeVSuiResult, U as UnstakeVSuiResult, k as SwapResult, l as SwapQuoteResult, h as SendResult, B as BalanceResponse, T as TransactionRecord, D as DepositInfo, m as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, g as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, d as PendingReward, C as ClaimRewardsResult, n as CompoundRewardsResult, f as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, o as FinancialSummary } from './types-jAD-e7Pq.js';
@@ -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

@@ -5886,14 +5886,35 @@ var naviDescriptor = {
   packages: [],
   dynamicPackageId: true,
   actionMap: {
+    // Deposit variants (entry_deposit / deposit + account-cap form for
+    // harvest's internal save leg)
     "incentive_v3::entry_deposit": "save",
     "incentive_v3::deposit": "save",
+    "incentive_v3::deposit_with_account_cap": "save",
+    // Withdraw variants
     "incentive_v3::withdraw_v2": "withdraw",
     "incentive_v3::entry_withdraw": "withdraw",
+    "incentive_v3::withdraw_with_account_cap": "withdraw",
+    "incentive_v3::withdraw_with_account_cap_v": "withdraw",
+    "incentive_v3::withdraw": "withdraw",
+    "incentive_v3::withdraw_v": "withdraw",
+    // Borrow variants
     "incentive_v3::borrow_v2": "borrow",
     "incentive_v3::entry_borrow": "borrow",
+    "incentive_v3::borrow": "borrow",
+    "incentive_v3::borrow_v": "borrow",
+    "incentive_v3::borrow_with_account_cap": "borrow",
+    "incentive_v3::borrow_with_account_cap_v": "borrow",
+    // Repay variants
     "incentive_v3::entry_repay": "repay",
-    "incentive_v3::repay": "repay"
+    "incentive_v3::repay": "repay",
+    "incentive_v3::repay_with_account_cap": "repay",
+    // Claim-reward variants — required for `claim_rewards` tagging AND for
+    // `harvest` compound-op detection in the indexer (paired with a save
+    // target, classified as `harvest` instead of `claim`).
+    "incentive_v3::claim_reward": "claim",
+    "incentive_v3::claim_reward_entry": "claim",
+    "incentive_v3::claim_reward_with_account_cap": "claim"
   }
 };
 var allDescriptors = [
@@ -7566,7 +7587,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 +7622,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 +7867,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: {
@@ -8003,7 +8035,7 @@ var FEE_RATES = {
 function calculateFee(operation, amount) {
   const bps = FEE_RATES[operation];
   const feeAmount = amount * Number(bps) / Number(BPS_DENOMINATOR);
-  const rawAmount = usdcToRaw(feeAmount);
+  const rawAmount = stableToRaw(feeAmount, USDC_DECIMALS);
   return {
     amount: feeAmount,
     asset: "USDC",
@@ -8011,11 +8043,11 @@ function calculateFee(operation, amount) {
     rawAmount
   };
 }
-function addFeeTransfer(tx, paymentCoin, feeBps, receiver, amount) {
+function addFeeTransfer(tx, paymentCoin, feeBps, receiver, amount, decimals = USDC_DECIMALS) {
   if (feeBps <= 0n) return;
   if (amount <= 0) return;
   const feeAmount = amount * Number(feeBps) / Number(BPS_DENOMINATOR);
-  const rawFee = usdcToRaw(feeAmount);
+  const rawFee = stableToRaw(feeAmount, decimals);
   if (rawFee <= 0n) return;
   const [feeCoin] = tx.splitCoins(paymentCoin, [tx.pure.u64(rawFee)]);
   tx.transferObjects([feeCoin], tx.pure.address(receiver));