@t2000/sdk 0.20.0 → 0.20.2

package/dist/index.d.cts

@@ -6,6 +6,7 @@ export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H
 import { T as T2000Options, P as PayOptions, a as PayResult, S as StakeVSuiResult, U as UnstakeVSuiResult, b as SwapResult, c as SwapQuoteResult, d as SendResult, B as BalanceResponse, e as TransactionRecord, D as DepositInfo, f as SaveResult, W as WithdrawResult, M as MaxWithdrawResult, g as BorrowResult, R as RepayResult, h as MaxBorrowResult, H as HealthFactorResult, i as PendingReward, C as ClaimRewardsResult, j as PositionsResult, k as RatesResult, E as EarningsResult, F as FundStatusResult, G as GasMethod } from './index-MP_J_nSO.cjs';
 export { A as AssetRates, l as GasReserve, N as NaviAdapter, m as PositionEntry, n as ProtocolRegistry } from './index-MP_J_nSO.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -388,6 +389,82 @@ declare function throwIfSimulationFailed(sim: SimulationResult): void;
 
 declare function getRates(client: SuiJsonRpcClient): Promise<RatesResult>;
 
+declare function getSwapQuote(params: {
+    walletAddress: string;
+    from: string;
+    to: string;
+    amount: number;
+    byAmountIn?: boolean;
+}): Promise<SwapQuoteResult>;
+
+/**
+ * Cetus Aggregator V3 SDK wrapper — the ONLY file that imports @cetusprotocol/aggregator-sdk.
+ * Documented CLAUDE.md exception: multi-DEX routing cannot be feasibly replaced by thin tx builders.
+ */
+
+interface SwapRouteResult {
+    routerData: RouterDataV3;
+    amountIn: string;
+    amountOut: string;
+    byAmountIn: boolean;
+    priceImpact: number;
+    insufficientLiquidity: boolean;
+}
+/**
+ * Find the optimal swap route via Cetus Aggregator REST API.
+ */
+declare function findSwapRoute(params: {
+    walletAddress: string;
+    from: string;
+    to: string;
+    amount: bigint;
+    byAmountIn: boolean;
+}): Promise<SwapRouteResult | null>;
+/**
+ * Build a swap PTB from a route result. The caller must provide an input coin
+ * obtained by splitting/merging wallet coins.
+ */
+declare function buildSwapTx(params: {
+    walletAddress: string;
+    route: SwapRouteResult;
+    tx: Transaction;
+    inputCoin: TransactionObjectArgument;
+    slippage: number;
+}): Promise<TransactionObjectArgument>;
+declare const TOKEN_MAP: Record<string, string>;
+/**
+ * Resolve a user-friendly token name ("SUI", "USDC") to its full coin type string.
+ * Returns the input unchanged if already a full coin type (contains "::").
+ */
+declare function resolveTokenType(nameOrType: string): string | null;
+
+/**
+ * VOLO vSUI liquid staking — thin transaction builders.
+ * No SDK dependency. Two Move calls, immutable contract addresses.
+ */
+
+declare const VOLO_PKG = "0x68d22cf8bdbcd11ecba1e094922873e4080d4d11133e2443fddda0bfd11dae20";
+declare const VOLO_POOL = "0x2d914e23d82fedef1b5f56a32d5c64bdcc3087ccfea2b4d6ea51a71f587840e5";
+declare const VOLO_METADATA = "0x680cd26af32b2bde8d3361e804c53ec1d1cfe24c7f039eb7f549e8dfde389a60";
+declare const VSUI_TYPE = "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT";
+interface VoloStats {
+    apy: number;
+    exchangeRate: number;
+    tvl: number;
+}
+/**
+ * Fetch VOLO vSUI staking stats (APY, exchange rate, TVL).
+ */
+declare function getVoloStats(): Promise<VoloStats>;
+/**
+ * Build a PTB to stake SUI for vSUI.
+ */
+declare function buildStakeVSuiTx(_client: SuiJsonRpcClient, address: string, amountMist: bigint): Promise<Transaction>;
+/**
+ * Build a PTB to unstake vSUI back to SUI.
+ */
+declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, amountMist: bigint | 'all'): Promise<Transaction>;
+
 type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
 interface SafeguardErrorDetails {
     attempted?: number;
@@ -458,4 +535,4 @@ interface GasStatusResponse {
 }
 declare function getGasStatus(address?: string): Promise<GasStatusResponse>;
 
-export { type AutoTopUpResult, BPS_DENOMINATOR, BalanceResponse, BorrowResult, CETUS_USDC_SUI_POOL, CLOCK_ID, ClaimRewardsResult, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, DepositInfo, EarningsResult, type FeeOperation, FundStatusResult, GAS_RESERVE_MIN, type GasExecutionResult, GasMethod, type GasRequestType, type GasSponsorResponse, type GasStatusResponse, HealthFactorResult, KeypairSigner, LendingAdapter, LendingRates, MIST_PER_SUI, MaxBorrowResult, MaxWithdrawResult, OUTBOUND_OPS, PayOptions, PayResult, PendingReward, PositionsResult, type ProtocolFeeInfo, RatesResult, RepayResult, STABLE_ASSETS, SUI_DECIMALS, SUPPORTED_ASSETS, type SafeguardConfig, SafeguardEnforcer, SafeguardError, type SafeguardErrorDetails, type SafeguardRule, SaveResult, SendResult, type SimulationResult, type StableAsset, StakeVSuiResult, type SupportedAsset, SwapQuoteResult, SwapResult, T2000, T2000Error, type T2000ErrorCode, type T2000ErrorData, T2000Options, TransactionRecord, type TransactionSigner, type TxMetadata, USDC_DECIMALS, UnstakeVSuiResult, WithdrawResult, type ZkLoginProof, ZkLoginSigner, addCollectFeeToTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getGasStatus, getRates, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, rawToStable, rawToUsdc, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };
+export { type AutoTopUpResult, BPS_DENOMINATOR, BalanceResponse, BorrowResult, CETUS_USDC_SUI_POOL, CLOCK_ID, ClaimRewardsResult, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, DepositInfo, EarningsResult, type FeeOperation, FundStatusResult, GAS_RESERVE_MIN, type GasExecutionResult, GasMethod, type GasRequestType, type GasSponsorResponse, type GasStatusResponse, HealthFactorResult, KeypairSigner, LendingAdapter, LendingRates, MIST_PER_SUI, MaxBorrowResult, MaxWithdrawResult, OUTBOUND_OPS, PayOptions, PayResult, PendingReward, PositionsResult, type ProtocolFeeInfo, RatesResult, RepayResult, STABLE_ASSETS, SUI_DECIMALS, SUPPORTED_ASSETS, type SafeguardConfig, SafeguardEnforcer, SafeguardError, type SafeguardErrorDetails, type SafeguardRule, SaveResult, SendResult, type SimulationResult, type StableAsset, StakeVSuiResult, type SupportedAsset, SwapQuoteResult, SwapResult, type SwapRouteResult, T2000, T2000Error, type T2000ErrorCode, type T2000ErrorData, T2000Options, TOKEN_MAP, TransactionRecord, type TransactionSigner, type TxMetadata, USDC_DECIMALS, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStats, WithdrawResult, type ZkLoginProof, ZkLoginSigner, addCollectFeeToTx, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, findSwapRoute, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getGasStatus, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, rawToStable, rawToUsdc, resolveTokenType, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H
 import { T as T2000Options, P as PayOptions, a as PayResult, S as StakeVSuiResult, U as UnstakeVSuiResult, b as SwapResult, c as SwapQuoteResult, d as SendResult, B as BalanceResponse, e as TransactionRecord, D as DepositInfo, f as SaveResult, W as WithdrawResult, M as MaxWithdrawResult, g as BorrowResult, R as RepayResult, h as MaxBorrowResult, H as HealthFactorResult, i as PendingReward, C as ClaimRewardsResult, j as PositionsResult, k as RatesResult, E as EarningsResult, F as FundStatusResult, G as GasMethod } from './index-D1DxZ1DK.js';
 export { A as AssetRates, l as GasReserve, N as NaviAdapter, m as PositionEntry, n as ProtocolRegistry } from './index-D1DxZ1DK.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { RouterDataV3 } from '@cetusprotocol/aggregator-sdk';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -388,6 +389,82 @@ declare function throwIfSimulationFailed(sim: SimulationResult): void;
 
 declare function getRates(client: SuiJsonRpcClient): Promise<RatesResult>;
 
+declare function getSwapQuote(params: {
+    walletAddress: string;
+    from: string;
+    to: string;
+    amount: number;
+    byAmountIn?: boolean;
+}): Promise<SwapQuoteResult>;
+
+/**
+ * Cetus Aggregator V3 SDK wrapper — the ONLY file that imports @cetusprotocol/aggregator-sdk.
+ * Documented CLAUDE.md exception: multi-DEX routing cannot be feasibly replaced by thin tx builders.
+ */
+
+interface SwapRouteResult {
+    routerData: RouterDataV3;
+    amountIn: string;
+    amountOut: string;
+    byAmountIn: boolean;
+    priceImpact: number;
+    insufficientLiquidity: boolean;
+}
+/**
+ * Find the optimal swap route via Cetus Aggregator REST API.
+ */
+declare function findSwapRoute(params: {
+    walletAddress: string;
+    from: string;
+    to: string;
+    amount: bigint;
+    byAmountIn: boolean;
+}): Promise<SwapRouteResult | null>;
+/**
+ * Build a swap PTB from a route result. The caller must provide an input coin
+ * obtained by splitting/merging wallet coins.
+ */
+declare function buildSwapTx(params: {
+    walletAddress: string;
+    route: SwapRouteResult;
+    tx: Transaction;
+    inputCoin: TransactionObjectArgument;
+    slippage: number;
+}): Promise<TransactionObjectArgument>;
+declare const TOKEN_MAP: Record<string, string>;
+/**
+ * Resolve a user-friendly token name ("SUI", "USDC") to its full coin type string.
+ * Returns the input unchanged if already a full coin type (contains "::").
+ */
+declare function resolveTokenType(nameOrType: string): string | null;
+
+/**
+ * VOLO vSUI liquid staking — thin transaction builders.
+ * No SDK dependency. Two Move calls, immutable contract addresses.
+ */
+
+declare const VOLO_PKG = "0x68d22cf8bdbcd11ecba1e094922873e4080d4d11133e2443fddda0bfd11dae20";
+declare const VOLO_POOL = "0x2d914e23d82fedef1b5f56a32d5c64bdcc3087ccfea2b4d6ea51a71f587840e5";
+declare const VOLO_METADATA = "0x680cd26af32b2bde8d3361e804c53ec1d1cfe24c7f039eb7f549e8dfde389a60";
+declare const VSUI_TYPE = "0x549e8b69270defbfafd4f94e17ec44cdbdd99820b33bda2278dea3b9a32d3f55::cert::CERT";
+interface VoloStats {
+    apy: number;
+    exchangeRate: number;
+    tvl: number;
+}
+/**
+ * Fetch VOLO vSUI staking stats (APY, exchange rate, TVL).
+ */
+declare function getVoloStats(): Promise<VoloStats>;
+/**
+ * Build a PTB to stake SUI for vSUI.
+ */
+declare function buildStakeVSuiTx(_client: SuiJsonRpcClient, address: string, amountMist: bigint): Promise<Transaction>;
+/**
+ * Build a PTB to unstake vSUI back to SUI.
+ */
+declare function buildUnstakeVSuiTx(client: SuiJsonRpcClient, address: string, amountMist: bigint | 'all'): Promise<Transaction>;
+
 type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
 interface SafeguardErrorDetails {
     attempted?: number;
@@ -458,4 +535,4 @@ interface GasStatusResponse {
 }
 declare function getGasStatus(address?: string): Promise<GasStatusResponse>;
 
-export { type AutoTopUpResult, BPS_DENOMINATOR, BalanceResponse, BorrowResult, CETUS_USDC_SUI_POOL, CLOCK_ID, ClaimRewardsResult, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, DepositInfo, EarningsResult, type FeeOperation, FundStatusResult, GAS_RESERVE_MIN, type GasExecutionResult, GasMethod, type GasRequestType, type GasSponsorResponse, type GasStatusResponse, HealthFactorResult, KeypairSigner, LendingAdapter, LendingRates, MIST_PER_SUI, MaxBorrowResult, MaxWithdrawResult, OUTBOUND_OPS, PayOptions, PayResult, PendingReward, PositionsResult, type ProtocolFeeInfo, RatesResult, RepayResult, STABLE_ASSETS, SUI_DECIMALS, SUPPORTED_ASSETS, type SafeguardConfig, SafeguardEnforcer, SafeguardError, type SafeguardErrorDetails, type SafeguardRule, SaveResult, SendResult, type SimulationResult, type StableAsset, StakeVSuiResult, type SupportedAsset, SwapQuoteResult, SwapResult, T2000, T2000Error, type T2000ErrorCode, type T2000ErrorData, T2000Options, TransactionRecord, type TransactionSigner, type TxMetadata, USDC_DECIMALS, UnstakeVSuiResult, WithdrawResult, type ZkLoginProof, ZkLoginSigner, addCollectFeeToTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getGasStatus, getRates, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, rawToStable, rawToUsdc, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };
+export { type AutoTopUpResult, BPS_DENOMINATOR, BalanceResponse, BorrowResult, CETUS_USDC_SUI_POOL, CLOCK_ID, ClaimRewardsResult, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, DepositInfo, EarningsResult, type FeeOperation, FundStatusResult, GAS_RESERVE_MIN, type GasExecutionResult, GasMethod, type GasRequestType, type GasSponsorResponse, type GasStatusResponse, HealthFactorResult, KeypairSigner, LendingAdapter, LendingRates, MIST_PER_SUI, MaxBorrowResult, MaxWithdrawResult, OUTBOUND_OPS, PayOptions, PayResult, PendingReward, PositionsResult, type ProtocolFeeInfo, RatesResult, RepayResult, STABLE_ASSETS, SUI_DECIMALS, SUPPORTED_ASSETS, type SafeguardConfig, SafeguardEnforcer, SafeguardError, type SafeguardErrorDetails, type SafeguardRule, SaveResult, SendResult, type SimulationResult, type StableAsset, StakeVSuiResult, type SupportedAsset, SwapQuoteResult, SwapResult, type SwapRouteResult, T2000, T2000Error, type T2000ErrorCode, type T2000ErrorData, T2000Options, TOKEN_MAP, TransactionRecord, type TransactionSigner, type TxMetadata, USDC_DECIMALS, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStats, WithdrawResult, type ZkLoginProof, ZkLoginSigner, addCollectFeeToTx, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, findSwapRoute, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getGasStatus, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, rawToStable, rawToUsdc, resolveTokenType, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };

package/dist/index.js

@@ -3167,6 +3167,45 @@ function parseMoveAbort(errorStr) {
   return { reason: errorStr };
 }
 
-export { BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, GAS_RESERVE_MIN, KeypairSigner, MIST_PER_SUI, NaviAdapter, OUTBOUND_OPS, ProtocolRegistry, STABLE_ASSETS, SUI_DECIMALS, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, USDC_DECIMALS, ZkLoginSigner, addCollectFeeToTx, allDescriptors, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getGasStatus, getRates, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, rawToStable, rawToUsdc, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };
+// src/swap-quote.ts
+async function getSwapQuote(params) {
+  const { findSwapRoute: findSwapRoute2, resolveTokenType: resolveTokenType2, TOKEN_MAP: TOKEN_MAP2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+  const fromType = resolveTokenType2(params.from);
+  const toType = resolveTokenType2(params.to);
+  if (!fromType) throw new Error(`Unknown token: ${params.from}. Provide the full coin type.`);
+  if (!toType) throw new Error(`Unknown token: ${params.to}. Provide the full coin type.`);
+  const byAmountIn = params.byAmountIn ?? true;
+  const fromEntry = Object.values(TOKEN_MAP2).includes(fromType) ? Object.entries(SUPPORTED_ASSETS).find(([, v]) => v.type === fromType) : null;
+  const fromDecimals = fromEntry ? fromEntry[1].decimals : fromType === "0x2::sui::SUI" ? 9 : 6;
+  const rawAmount = BigInt(Math.floor(params.amount * 10 ** fromDecimals));
+  const route = await findSwapRoute2({
+    walletAddress: params.walletAddress,
+    from: fromType,
+    to: toType,
+    amount: rawAmount,
+    byAmountIn
+  });
+  if (!route) throw new Error(`No swap route found for ${params.from} -> ${params.to}.`);
+  if (route.insufficientLiquidity) throw new Error(`Insufficient liquidity for ${params.from} -> ${params.to}.`);
+  const toEntry = Object.entries(SUPPORTED_ASSETS).find(([, v]) => v.type === toType);
+  const toDecimals = toEntry ? toEntry[1].decimals : toType === "0x2::sui::SUI" ? 9 : 6;
+  const fromAmount = Number(route.amountIn) / 10 ** fromDecimals;
+  const toAmount = Number(route.amountOut) / 10 ** toDecimals;
+  const routeDesc = route.routerData.paths?.map((p) => p.provider).filter(Boolean).slice(0, 3).join(" + ") ?? "Cetus Aggregator";
+  return {
+    fromToken: params.from,
+    toToken: params.to,
+    fromAmount,
+    toAmount,
+    priceImpact: route.priceImpact,
+    route: routeDesc
+  };
+}
+
+// src/index.ts
+init_cetus_swap();
+init_volo();
+
+export { BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, GAS_RESERVE_MIN, KeypairSigner, MIST_PER_SUI, NaviAdapter, OUTBOUND_OPS, ProtocolRegistry, STABLE_ASSETS, SUI_DECIMALS, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, TOKEN_MAP, USDC_DECIMALS, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, ZkLoginSigner, addCollectFeeToTx, allDescriptors, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, executeAutoTopUp, executeWithGas, exportPrivateKey, findSwapRoute, formatAssetAmount, formatSui, formatUsd, generateKeypair, getAddress, getDecimals, getGasStatus, getRates, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, rawToStable, rawToUsdc, resolveTokenType, saveKey, shouldAutoTopUp, simulateTransaction, solveHashcash, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, walletExists };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map