@t2000/sdk 1.4.0 → 1.6.0

package/dist/{types-BhiUiiNs.d.ts → types-B0VlW8Ov.d.ts}

@@ -560,6 +560,16 @@ declare function findSwapRoute(params: {
     amount: bigint;
     byAmountIn: boolean;
     overlayFee?: OverlayFeeConfig;
+    /**
+     * Optional Cetus provider allow-list. When omitted, all 30+ DEXes
+     * are eligible. Sponsored flows (Enoki) MUST pass an exclusion list
+     * computed via `getProvidersExcluding([...])` from the Cetus SDK to
+     * remove Pyth-dependent providers (HAEDALPMM, METASTABLE, OBRIC,
+     * STEAMM_OMM, STEAMM_OMM_V2, SEVENK, HAEDALHMMV2) — those reference
+     * `tx.gas` for oracle fees, which Enoki rejects in sponsored txs.
+     * Non-sponsored callers (CLI, direct SDK) leave this undefined.
+     */
+    providers?: string[];
 }): Promise<SwapRouteResult | null>;
 /**
  * Build a swap PTB from a route result. The caller must provide an input coin
@@ -578,6 +588,70 @@ declare function buildSwapTx(params: {
     slippage: number;
     overlayFee?: OverlayFeeConfig;
 }): Promise<TransactionObjectArgument>;
+/**
+ * Append a swap fragment to an existing PTB. SPEC 7 § "Layer 1" Cetus
+ * appender. Two modes, dispatched by the presence of `input.inputCoin`:
+ *
+ * - **Wallet mode** (`inputCoin` omitted) — fetches `from`-asset coins
+ *   from the sender's wallet (paginated), merges/splits to the
+ *   requested amount, runs the swap. Mirrors the audric host's
+ *   `transactions/prepare/route.ts` swap branch (P2.2c will retire that
+ *   branch in favor of this appender via `composeTx`).
+ *
+ * - **Chain mode** (`inputCoin` provided) — consumes the passed-in coin
+ *   reference (typically produced by an upstream appender like
+ *   `addWithdrawToTx`) directly, no wallet fetch / no merge / no
+ *   split. This is the SPEC 7 multi-write enabler ("withdraw → swap →
+ *   save" without intermediate wallet materialization).
+ *
+ * **SUI in wallet mode:** uses `client.getCoins` like every other
+ * token. This works for sponsored flows (Enoki — `tx.gas` belongs to
+ * the sponsor, swap input comes from the user's separate SUI coin
+ * objects). For non-sponsored flows where `tx.gas` IS the user's SUI,
+ * the caller should pre-build the inputCoin via
+ * `tx.splitCoins(tx.gas, [rawAmount])[0]` and pass it via chain mode
+ * instead. (`T2000.swap()` already handles this internally — direct SDK
+ * users go through the high-level class, not through this appender.)
+ *
+ * **`swapAll` semantics (wallet mode):** if the requested raw amount
+ * is >= the wallet's total `from` balance, the appender consumes the
+ * entire merged primary coin (not a split), matching audric's host
+ * route's `swapAll` clipping. The returned `effectiveAmountIn` reflects
+ * the actual consumed amount in display units.
+ *
+ * **Slippage:** clamped to [0.001, 0.05] (0.1% – 5%). Defaults to 0.01.
+ *
+ * @returns
+ * - `coin` — output coin reference, ready for downstream consumption
+ *   (e.g. `addSaveToTx`) or wallet transfer (`tx.transferObjects`).
+ * - `effectiveAmountIn` — display-units input amount the swap actually
+ *   consumes (handles `swapAll` clipping in wallet mode; in chain mode
+ *   echoes the requested `input.amount`).
+ * - `expectedAmountOut` — display-units output amount per the route
+ *   quote. Actual on-chain output may differ within slippage.
+ * - `route` — raw `SwapRouteResult` for downstream telemetry / logging.
+ */
+declare function addSwapToTx(tx: Transaction, client: SuiJsonRpcClient, address: string, input: {
+    from: string;
+    to: string;
+    amount: number;
+    slippage?: number;
+    byAmountIn?: boolean;
+    overlayFee?: OverlayFeeConfig;
+    inputCoin?: TransactionObjectArgument;
+    /**
+     * Optional Cetus provider allow-list. Forwarded to `findSwapRoute`.
+     * Sponsored flows (Enoki) MUST pass `getProvidersExcluding([...])`
+     * to remove Pyth-dependent providers — see `findSwapRoute`'s JSDoc
+     * for the exclusion list. Non-sponsored callers omit this.
+     */
+    providers?: string[];
+}): Promise<{
+    coin: TransactionObjectArgument;
+    effectiveAmountIn: number;
+    expectedAmountOut: number;
+    route: SwapRouteResult;
+}>;
 
 type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
 interface SafeguardErrorDetails {
@@ -618,4 +692,4 @@ interface TxMetadata {
 declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
 declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
 
-export { WAL_TYPE as $, ALL_NAVI_ASSETS as A, BORROW_FEE_BPS as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type T2000ErrorData as H, IKA_TYPE as I, T2000_OVERLAY_FEE_WALLET as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, TOKEN_MAP as Q, type TransactionSigner as R, SAVE_FEE_BPS as S, T2000Error as T, type TxDirection as U, type TxMetadata as V, USDC_DECIMALS as W, USDC_TYPE as X, USDE_TYPE as Y, USDSUI_TYPE as Z, USDT_TYPE as _, BPS_DENOMINATOR as a, WBTC_TYPE as a0, type ZkLoginProof as a1, ZkLoginSigner as a2, addFeeTransfer as a3, buildSwapTx as a4, calculateFee as a5, classifyAction as a6, classifyLabel as a7, classifyTransaction as a8, extractTransferDetails as a9, validateAddress as aA, CETUS_USDC_SUI_POOL as aB, OPERATION_ASSETS as aC, type Operation as aD, assertAllowedAsset as aE, getCoinMeta as aF, isAllowedAsset as aG, isInRegistry as aH, normalizeCoinType as aI, queryHistory as aJ, queryTransaction as aK, simulateTransaction as aL, throwIfSimulationFailed as aM, extractTxCommands as aa, extractTxSender as ab, fallbackLabel as ac, findSwapRoute as ad, formatAssetAmount as ae, formatSui as af, formatUsd as ag, getDecimals as ah, getDecimalsForCoinType as ai, getTier as aj, isSupported as ak, isTier1 as al, isTier2 as am, mapMoveAbortCode as an, mapWalletError as ao, mistToSui as ap, parseSuiRpcTx as aq, rawToStable as ar, rawToUsdc as as, refineLendingLabel as at, resolveSymbol as au, resolveTokenType as av, stableToRaw as aw, suiToMist as ax, truncateAddress as ay, usdcToRaw as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type ExtractedTransfer as g, KeypairSigner as h, LOFI_TYPE as i, MIST_PER_SUI as j, OVERLAY_FEE_RATE as k, type OverlayFeeConfig as l, STABLE_ASSETS as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SuiRpcTxBlock as w, type SupportedAsset as x, type SwapRouteResult as y, type T2000ErrorCode as z };
+export { WAL_TYPE as $, ALL_NAVI_ASSETS as A, BORROW_FEE_BPS as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type T2000ErrorData as H, IKA_TYPE as I, T2000_OVERLAY_FEE_WALLET as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, TOKEN_MAP as Q, type TransactionSigner as R, SAVE_FEE_BPS as S, T2000Error as T, type TxDirection as U, type TxMetadata as V, USDC_DECIMALS as W, USDC_TYPE as X, USDE_TYPE as Y, USDSUI_TYPE as Z, USDT_TYPE as _, BPS_DENOMINATOR as a, WBTC_TYPE as a0, type ZkLoginProof as a1, ZkLoginSigner as a2, addFeeTransfer as a3, buildSwapTx as a4, calculateFee as a5, classifyAction as a6, classifyLabel as a7, classifyTransaction as a8, extractTransferDetails as a9, validateAddress as aA, CETUS_USDC_SUI_POOL as aB, OPERATION_ASSETS as aC, type Operation as aD, addSwapToTx as aE, assertAllowedAsset as aF, getCoinMeta as aG, isAllowedAsset as aH, isInRegistry as aI, normalizeCoinType as aJ, queryHistory as aK, queryTransaction as aL, simulateTransaction as aM, throwIfSimulationFailed as aN, extractTxCommands as aa, extractTxSender as ab, fallbackLabel as ac, findSwapRoute as ad, formatAssetAmount as ae, formatSui as af, formatUsd as ag, getDecimals as ah, getDecimalsForCoinType as ai, getTier as aj, isSupported as ak, isTier1 as al, isTier2 as am, mapMoveAbortCode as an, mapWalletError as ao, mistToSui as ap, parseSuiRpcTx as aq, rawToStable as ar, rawToUsdc as as, refineLendingLabel as at, resolveSymbol as au, resolveTokenType as av, stableToRaw as aw, suiToMist as ax, truncateAddress as ay, usdcToRaw as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type ExtractedTransfer as g, KeypairSigner as h, LOFI_TYPE as i, MIST_PER_SUI as j, OVERLAY_FEE_RATE as k, type OverlayFeeConfig as l, STABLE_ASSETS as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SuiRpcTxBlock as w, type SupportedAsset as x, type SwapRouteResult as y, type T2000ErrorCode as z };

package/dist/{types-CMVkJNFp.d.cts → types-DrHllxZ5.d.cts}

@@ -560,6 +560,16 @@ declare function findSwapRoute(params: {
     amount: bigint;
     byAmountIn: boolean;
     overlayFee?: OverlayFeeConfig;
+    /**
+     * Optional Cetus provider allow-list. When omitted, all 30+ DEXes
+     * are eligible. Sponsored flows (Enoki) MUST pass an exclusion list
+     * computed via `getProvidersExcluding([...])` from the Cetus SDK to
+     * remove Pyth-dependent providers (HAEDALPMM, METASTABLE, OBRIC,
+     * STEAMM_OMM, STEAMM_OMM_V2, SEVENK, HAEDALHMMV2) — those reference
+     * `tx.gas` for oracle fees, which Enoki rejects in sponsored txs.
+     * Non-sponsored callers (CLI, direct SDK) leave this undefined.
+     */
+    providers?: string[];
 }): Promise<SwapRouteResult | null>;
 /**
  * Build a swap PTB from a route result. The caller must provide an input coin
@@ -578,6 +588,70 @@ declare function buildSwapTx(params: {
     slippage: number;
     overlayFee?: OverlayFeeConfig;
 }): Promise<TransactionObjectArgument>;
+/**
+ * Append a swap fragment to an existing PTB. SPEC 7 § "Layer 1" Cetus
+ * appender. Two modes, dispatched by the presence of `input.inputCoin`:
+ *
+ * - **Wallet mode** (`inputCoin` omitted) — fetches `from`-asset coins
+ *   from the sender's wallet (paginated), merges/splits to the
+ *   requested amount, runs the swap. Mirrors the audric host's
+ *   `transactions/prepare/route.ts` swap branch (P2.2c will retire that
+ *   branch in favor of this appender via `composeTx`).
+ *
+ * - **Chain mode** (`inputCoin` provided) — consumes the passed-in coin
+ *   reference (typically produced by an upstream appender like
+ *   `addWithdrawToTx`) directly, no wallet fetch / no merge / no
+ *   split. This is the SPEC 7 multi-write enabler ("withdraw → swap →
+ *   save" without intermediate wallet materialization).
+ *
+ * **SUI in wallet mode:** uses `client.getCoins` like every other
+ * token. This works for sponsored flows (Enoki — `tx.gas` belongs to
+ * the sponsor, swap input comes from the user's separate SUI coin
+ * objects). For non-sponsored flows where `tx.gas` IS the user's SUI,
+ * the caller should pre-build the inputCoin via
+ * `tx.splitCoins(tx.gas, [rawAmount])[0]` and pass it via chain mode
+ * instead. (`T2000.swap()` already handles this internally — direct SDK
+ * users go through the high-level class, not through this appender.)
+ *
+ * **`swapAll` semantics (wallet mode):** if the requested raw amount
+ * is >= the wallet's total `from` balance, the appender consumes the
+ * entire merged primary coin (not a split), matching audric's host
+ * route's `swapAll` clipping. The returned `effectiveAmountIn` reflects
+ * the actual consumed amount in display units.
+ *
+ * **Slippage:** clamped to [0.001, 0.05] (0.1% – 5%). Defaults to 0.01.
+ *
+ * @returns
+ * - `coin` — output coin reference, ready for downstream consumption
+ *   (e.g. `addSaveToTx`) or wallet transfer (`tx.transferObjects`).
+ * - `effectiveAmountIn` — display-units input amount the swap actually
+ *   consumes (handles `swapAll` clipping in wallet mode; in chain mode
+ *   echoes the requested `input.amount`).
+ * - `expectedAmountOut` — display-units output amount per the route
+ *   quote. Actual on-chain output may differ within slippage.
+ * - `route` — raw `SwapRouteResult` for downstream telemetry / logging.
+ */
+declare function addSwapToTx(tx: Transaction, client: SuiJsonRpcClient, address: string, input: {
+    from: string;
+    to: string;
+    amount: number;
+    slippage?: number;
+    byAmountIn?: boolean;
+    overlayFee?: OverlayFeeConfig;
+    inputCoin?: TransactionObjectArgument;
+    /**
+     * Optional Cetus provider allow-list. Forwarded to `findSwapRoute`.
+     * Sponsored flows (Enoki) MUST pass `getProvidersExcluding([...])`
+     * to remove Pyth-dependent providers — see `findSwapRoute`'s JSDoc
+     * for the exclusion list. Non-sponsored callers omit this.
+     */
+    providers?: string[];
+}): Promise<{
+    coin: TransactionObjectArgument;
+    effectiveAmountIn: number;
+    expectedAmountOut: number;
+    route: SwapRouteResult;
+}>;
 
 type SafeguardRule = 'locked' | 'maxPerTx' | 'maxDailySend';
 interface SafeguardErrorDetails {
@@ -618,4 +692,4 @@ interface TxMetadata {
 declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
 declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
 
-export { WAL_TYPE as $, ALL_NAVI_ASSETS as A, BORROW_FEE_BPS as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type T2000ErrorData as H, IKA_TYPE as I, T2000_OVERLAY_FEE_WALLET as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, TOKEN_MAP as Q, type TransactionSigner as R, SAVE_FEE_BPS as S, T2000Error as T, type TxDirection as U, type TxMetadata as V, USDC_DECIMALS as W, USDC_TYPE as X, USDE_TYPE as Y, USDSUI_TYPE as Z, USDT_TYPE as _, BPS_DENOMINATOR as a, WBTC_TYPE as a0, type ZkLoginProof as a1, ZkLoginSigner as a2, addFeeTransfer as a3, buildSwapTx as a4, calculateFee as a5, classifyAction as a6, classifyLabel as a7, classifyTransaction as a8, extractTransferDetails as a9, validateAddress as aA, CETUS_USDC_SUI_POOL as aB, OPERATION_ASSETS as aC, type Operation as aD, assertAllowedAsset as aE, getCoinMeta as aF, isAllowedAsset as aG, isInRegistry as aH, normalizeCoinType as aI, queryHistory as aJ, queryTransaction as aK, simulateTransaction as aL, throwIfSimulationFailed as aM, extractTxCommands as aa, extractTxSender as ab, fallbackLabel as ac, findSwapRoute as ad, formatAssetAmount as ae, formatSui as af, formatUsd as ag, getDecimals as ah, getDecimalsForCoinType as ai, getTier as aj, isSupported as ak, isTier1 as al, isTier2 as am, mapMoveAbortCode as an, mapWalletError as ao, mistToSui as ap, parseSuiRpcTx as aq, rawToStable as ar, rawToUsdc as as, refineLendingLabel as at, resolveSymbol as au, resolveTokenType as av, stableToRaw as aw, suiToMist as ax, truncateAddress as ay, usdcToRaw as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type ExtractedTransfer as g, KeypairSigner as h, LOFI_TYPE as i, MIST_PER_SUI as j, OVERLAY_FEE_RATE as k, type OverlayFeeConfig as l, STABLE_ASSETS as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SuiRpcTxBlock as w, type SupportedAsset as x, type SwapRouteResult as y, type T2000ErrorCode as z };
+export { WAL_TYPE as $, ALL_NAVI_ASSETS as A, BORROW_FEE_BPS as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type FeeOperation as F, GAS_RESERVE_MIN as G, type T2000ErrorData as H, IKA_TYPE as I, T2000_OVERLAY_FEE_WALLET as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OUTBOUND_OPS as O, type ProtocolFeeInfo as P, TOKEN_MAP as Q, type TransactionSigner as R, SAVE_FEE_BPS as S, T2000Error as T, type TxDirection as U, type TxMetadata as V, USDC_DECIMALS as W, USDC_TYPE as X, USDE_TYPE as Y, USDSUI_TYPE as Z, USDT_TYPE as _, BPS_DENOMINATOR as a, WBTC_TYPE as a0, type ZkLoginProof as a1, ZkLoginSigner as a2, addFeeTransfer as a3, buildSwapTx as a4, calculateFee as a5, classifyAction as a6, classifyLabel as a7, classifyTransaction as a8, extractTransferDetails as a9, validateAddress as aA, CETUS_USDC_SUI_POOL as aB, OPERATION_ASSETS as aC, type Operation as aD, addSwapToTx as aE, assertAllowedAsset as aF, getCoinMeta as aG, isAllowedAsset as aH, isInRegistry as aI, normalizeCoinType as aJ, queryHistory as aK, queryTransaction as aL, simulateTransaction as aM, throwIfSimulationFailed as aN, extractTxCommands as aa, extractTxSender as ab, fallbackLabel as ac, findSwapRoute as ad, formatAssetAmount as ae, formatSui as af, formatUsd as ag, getDecimals as ah, getDecimalsForCoinType as ai, getTier as aj, isSupported as ak, isTier1 as al, isTier2 as am, mapMoveAbortCode as an, mapWalletError as ao, mistToSui as ap, parseSuiRpcTx as aq, rawToStable as ar, rawToUsdc as as, refineLendingLabel as at, resolveSymbol as au, resolveTokenType as av, stableToRaw as aw, suiToMist as ax, truncateAddress as ay, usdcToRaw as az, COIN_REGISTRY as b, type ClassifyBalanceChange as c, type ClassifyResult as d, type CoinMeta as e, DEFAULT_SAFEGUARD_CONFIG as f, type ExtractedTransfer as g, KeypairSigner as h, LOFI_TYPE as i, MIST_PER_SUI as j, OVERLAY_FEE_RATE as k, type OverlayFeeConfig as l, STABLE_ASSETS as m, SUI_DECIMALS as n, SUI_TYPE as o, SUPPORTED_ASSETS as p, type SafeguardConfig as q, SafeguardError as r, type SafeguardErrorDetails as s, type SafeguardRule as t, type SimulationResult as u, type StableAsset as v, type SuiRpcTxBlock as w, type SupportedAsset as x, type SwapRouteResult as y, type T2000ErrorCode as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/sdk",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "TypeScript SDK for AI agent bank accounts on Sui — send, save, borrow, swap. NAVI lending + Cetus aggregator routing, sponsored gas, zkLogin compatible.",
   "type": "module",
   "main": "./dist/index.cjs",