@t2000/sdk 1.23.1 → 1.24.0

package/dist/index.js

@@ -7442,6 +7442,183 @@ var T2000 = class _T2000 extends EventEmitter {
 // src/index.ts
 init_errors();
 init_coinSelection();
+init_errors();
+init_token_registry();
+init_cetus_swap();
+async function addHarvestToTx(tx, client, address, options = {}) {
+  const slippage = options.slippage ?? 0.01;
+  const minRewardUsd = options.minRewardUsd ?? 0.01;
+  const priceCache = options.priceCache;
+  let rawRewards;
+  try {
+    rawRewards = await vt(address, {
+      env: "prod",
+      client,
+      markets: ["main"]
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new T2000Error(
+      "PROTOCOL_UNAVAILABLE",
+      `NAVI rewards lookup failed: ${msg}`,
+      { source: "navi-harvest-read" },
+      true
+    );
+  }
+  const claimable = (rawRewards ?? []).filter((r) => Number(r.userClaimableReward) > 0);
+  if (claimable.length === 0) {
+    throw new T2000Error(
+      "INVALID_AMOUNT",
+      "No pending rewards to harvest.",
+      { source: "navi-harvest" }
+    );
+  }
+  const aggregated = aggregateClaimableRewards(claimable);
+  let claimed;
+  try {
+    const claimResult = await Ct(tx, claimable, {
+      env: "prod",
+      // 'skip' = NAVI doesn't auto-transfer; coin handles stay in the PTB
+      // for downstream consumption. Verified against NAVI lending source
+      // (index.esm.js@1828–1911) — when type !== 'transfer' && type !==
+      // 'depositNAVI', the `else` branch pushes `{ coin, identifier, ... }`
+      // to the return without consuming the handle.
+      customCoinReceive: { type: "skip" }
+    });
+    const grouped = /* @__PURE__ */ new Map();
+    for (const c of claimResult) {
+      const ct2 = c.identifier.suiCoinType ?? "";
+      if (!ct2) continue;
+      const list = grouped.get(ct2) ?? [];
+      list.push(c.coin);
+      grouped.set(ct2, list);
+    }
+    claimed = [];
+    for (const [coinType, handles] of grouped.entries()) {
+      if (handles.length === 1) {
+        claimed.push({ coin: handles[0], coinType });
+      } else {
+        const [dest, ...rest] = handles;
+        tx.mergeCoins(dest, rest);
+        claimed.push({ coin: dest, coinType });
+      }
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new T2000Error(
+      "PROTOCOL_UNAVAILABLE",
+      `NAVI claim PTB build failed: ${msg}`,
+      { source: "navi-harvest-claim-ptb" },
+      true
+    );
+  }
+  const usdcHandles = [];
+  const swaps = [];
+  const skipped = [];
+  let expectedUsdcDeposited = 0;
+  for (const { coin, coinType } of claimed) {
+    const aggRow = aggregated.find((r) => r.coinType === coinType);
+    if (!aggRow) {
+      continue;
+    }
+    if (coinType === USDC_TYPE) {
+      usdcHandles.push(coin);
+      expectedUsdcDeposited += aggRow.amount;
+      continue;
+    }
+    const meta = getCoinMeta(coinType);
+    const isTradeable = meta && (meta.tier === 1 || meta.tier === 2);
+    if (!isTradeable) {
+      tx.transferObjects([coin], address);
+      skipped.push({
+        symbol: aggRow.symbol,
+        coinType,
+        amount: aggRow.amount,
+        reason: "untradeable"
+      });
+      continue;
+    }
+    if (priceCache && minRewardUsd > 0) {
+      const px = priceCache.get(aggRow.symbol.toUpperCase());
+      if (px && px > 0 && aggRow.amount * px < minRewardUsd) {
+        tx.transferObjects([coin], address);
+        skipped.push({
+          symbol: aggRow.symbol,
+          coinType,
+          amount: aggRow.amount,
+          reason: "dust"
+        });
+        continue;
+      }
+    }
+    try {
+      const swapResult = await addSwapToTx(tx, client, address, {
+        from: aggRow.symbol,
+        to: "USDC",
+        amount: aggRow.amount,
+        slippage,
+        inputCoin: coin,
+        providers: options.providers
+      });
+      usdcHandles.push(swapResult.coin);
+      expectedUsdcDeposited += swapResult.expectedAmountOut;
+      swaps.push({
+        fromSymbol: aggRow.symbol,
+        fromCoinType: coinType,
+        toSymbol: "USDC",
+        inputAmount: swapResult.effectiveAmountIn,
+        expectedOutputUsdc: swapResult.expectedAmountOut
+      });
+    } catch (err) {
+      const code = err instanceof T2000Error ? err.code : "UNKNOWN";
+      if (code !== "SWAP_NO_ROUTE" && code !== "SWAP_FAILED") {
+        throw err;
+      }
+      tx.transferObjects([coin], address);
+      skipped.push({
+        symbol: aggRow.symbol,
+        coinType,
+        amount: aggRow.amount,
+        reason: "no-route"
+      });
+    }
+  }
+  if (usdcHandles.length > 0) {
+    let depositCoin;
+    if (usdcHandles.length === 1) {
+      depositCoin = usdcHandles[0];
+    } else {
+      const [primary, ...rest] = usdcHandles;
+      tx.mergeCoins(primary, rest);
+      depositCoin = primary;
+    }
+    try {
+      await addSaveToTx(tx, client, address, depositCoin, { asset: "USDC" });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      throw new T2000Error(
+        "PROTOCOL_UNAVAILABLE",
+        `NAVI deposit failed during harvest: ${msg}`,
+        { source: "navi-harvest-deposit" },
+        true
+      );
+    }
+  }
+  return {
+    claimed: aggregated,
+    swaps,
+    skipped,
+    expectedUsdcDeposited
+  };
+}
+async function buildHarvestRewardsTx(client, address, options = {}) {
+  const tx = new Transaction();
+  tx.setSender(address);
+  const plan = await addHarvestToTx(tx, client, address, options);
+  return { tx, plan };
+}
+
+// src/composeTx.ts
 init_cetus_swap();
 init_volo();
 init_coinSelection();
@@ -7641,6 +7818,29 @@ var WRITE_APPENDER_REGISTRY = {
     const rewards = await addClaimRewardsToTx(tx, ctx.client, ctx.sender);
     return { preview: { toolName: "claim_rewards", rewards } };
   },
+  // [Track B / 2026-05-08] Macro appender — assembles claim → swap(s) →
+  // save inline. The audric host wires `getSponsoredSwapProviders()` into
+  // `options.providers` automatically when `ctx.sponsoredContext === true`
+  // (parity with `swap_execute` below). Slippage + dust-floor pulled from
+  // the input; price cache is forwarded from the host so the dust filter
+  // can compare claimed amounts to USD.
+  harvest_rewards: async (tx, input, ctx) => {
+    const providers = ctx.sponsoredContext ? await getSponsoredSwapProviders() : void 0;
+    const plan = await addHarvestToTx(tx, ctx.client, ctx.sender, {
+      slippage: input.slippage,
+      minRewardUsd: input.minRewardUsd,
+      providers
+    });
+    return {
+      preview: {
+        toolName: "harvest_rewards",
+        claimed: plan.claimed,
+        swaps: plan.swaps,
+        skipped: plan.skipped,
+        expectedUsdcDeposited: plan.expectedUsdcDeposited
+      }
+    };
+  },
   volo_stake: async (tx, input, ctx) => {
     if (input.amountSui <= 0) {
       throw new T2000Error("INVALID_AMOUNT", "Stake amount must be greater than zero");
@@ -8056,6 +8256,6 @@ function displayHandle(label) {
   (*! scure-base - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
-export { ALL_NAVI_ASSETS, AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, BORROW_FEE_BPS, BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, ETH_TYPE, GAS_RESERVE_MIN, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, IKA_TYPE, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, NaviAdapter, OPERATION_ASSETS, OUTBOUND_OPS, OVERLAY_FEE_RATE, ProtocolRegistry, SAVE_FEE_BPS, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addClaimRewardsToTx, addFeeTransfer, addSendToTx, addStakeVSuiToTx, addSwapToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, allDescriptors, assertAllowedAsset, buildAddLeafTx, buildClaimRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, classifyAction, classifyLabel, classifyTransaction, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getFinancialSummary, getPendingRewards, getRates, getSwapQuote, getTier, getVoloStats, isAllowedAsset, isInRegistry, isSupported, isTier1, isTier2, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, normalizeAsset, normalizeCoinType, parseSuiRpcTx, queryHistory, queryTransaction, rawToStable, rawToUsdc, refineLendingLabel, resolveSymbol, resolveTokenType, saveKey, selectAndSplitCoin, selectSuiCoin, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, walletExists };
+export { ALL_NAVI_ASSETS, AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, BORROW_FEE_BPS, BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, ETH_TYPE, GAS_RESERVE_MIN, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, IKA_TYPE, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, NaviAdapter, OPERATION_ASSETS, OUTBOUND_OPS, OVERLAY_FEE_RATE, ProtocolRegistry, SAVE_FEE_BPS, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addClaimRewardsToTx, addFeeTransfer, addSendToTx, addStakeVSuiToTx, addSwapToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, allDescriptors, assertAllowedAsset, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, classifyAction, classifyLabel, classifyTransaction, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getFinancialSummary, getPendingRewards, getRates, getSwapQuote, getTier, getVoloStats, isAllowedAsset, isInRegistry, isSupported, isTier1, isTier2, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, normalizeAsset, normalizeCoinType, parseSuiRpcTx, queryHistory, queryTransaction, rawToStable, rawToUsdc, refineLendingLabel, resolveSymbol, resolveTokenType, saveKey, selectAndSplitCoin, selectSuiCoin, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, walletExists };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map