@t2000/sdk 2.13.2 → 2.14.1

package/dist/{types-WeZQDV54.d.ts → types-BMdhu0D7.d.ts}

@@ -1,6 +1,6 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-import { T as TransactionLeg, k as TransactionRecord } from './types-epj9U13o.js';
+import { T as TransactionLeg, k as TransactionRecord } from './types-I7U99DvG.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 
 /**

package/dist/{types-BY6ovQGK.d.cts → types-C2Va_r0h.d.cts}

@@ -1,6 +1,6 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-import { T as TransactionLeg, k as TransactionRecord } from './types-epj9U13o.cjs';
+import { T as TransactionLeg, k as TransactionRecord } from './types-I7U99DvG.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 
 /**

package/dist/{types-epj9U13o.d.cts → types-I7U99DvG.d.cts}

@@ -167,11 +167,11 @@ declare function buildSwapTx(params: {
  * 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`).
+ * - **Wallet mode** (`inputCoin` omitted) — sources `from`-asset funds
+ *   via `coinWithBalance({ type, balance })` (resolves coin objects +
+ *   address balance at build time), 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
@@ -179,14 +179,18 @@ declare function buildSwapTx(params: {
  *   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.)
+ * **SUI in wallet mode:** ALWAYS sources through `selectSuiCoin` (which
+ * routes via `coinWithBalance({ type: SUI, useGasCoin: false })` under
+ * sponsored flows, OR `tx.splitCoins(tx.gas, ...)` under self-funded
+ * flows). The caller MUST set `sponsoredContext` correctly — otherwise
+ * sponsored swaps with SUI source fail with `Cannot use GasCoin as a
+ * transaction argument` (Enoki owns `tx.gas`, the PTB body referencing
+ * it as an argument is invalid for sponsorship). 2.14.0 shipped without
+ * this branch and broke audric/web-v2 SUI→USDC swaps; restored in 2.14.1
+ * (S.260). For non-sponsored flows (CLI), `T2000.swap()` pre-builds the
+ * inputCoin via `tx.splitCoins(tx.gas, [rawAmount])[0]` and uses chain
+ * mode, sidestepping wallet-mode entirely — this branch is a defensive
+ * safety net for future direct SDK users who pass SUI in wallet mode.
  *
  * **`swapAll` semantics (wallet mode):** if the requested raw amount
  * is >= the wallet's total `from` balance, the appender consumes the
@@ -235,6 +239,19 @@ declare function addSwapToTx(tx: Transaction, client: SuiJsonRpcClient, address:
      * config (the route data already encodes the chosen DEX path).
      */
     precomputedRoute?: SwapRouteResult;
+    /**
+     * Whether this swap is being built inside a sponsored-tx flow (Enoki)
+     * vs self-funded (CLI / direct sign). Load-bearing for SUI-source
+     * swaps in wallet mode: under sponsored flows, `tx.gas` belongs to
+     * the sponsor and CANNOT be referenced as a transaction argument
+     * (Sui protocol rejects with `Cannot use GasCoin as a transaction
+     * argument`). When `true`, SUI source routes through `selectSuiCoin`
+     * with `useGasCoin: false` so the resolver sources from the user's
+     * SUI coin objects + address balance instead. Defaults to `false`
+     * (back-compat — pre-2.14.1 behavior). Audric/web-v2's compose path
+     * threads this through via `composeTx({ sponsoredContext: true })`.
+     */
+    sponsoredContext?: boolean;
 }): Promise<{
     coin: TransactionObjectArgument;
     effectiveAmountIn: number;
@@ -526,6 +543,14 @@ interface PayResult {
     body: unknown;
     paid: boolean;
     cost?: number;
+    /**
+     * SUI gas cost actually paid on chain. Zero for gasless payments —
+     * which means an MPP payment hit the protocol's gasless allowlist
+     * (USDC / USDsui / USDY / FdUSD / AUSD / BUCK / USDB / SUI_USDE) and
+     * was accepted with `gasPrice=0, gasBudget=0, gasPayment=[]`. See
+     * https://docs.sui.io/develop/transaction-payment/gasless-stablecoin-transfers
+     */
+    gasCostSui?: number;
     receipt?: {
         reference: string;
         timestamp: string;

package/dist/{types-epj9U13o.d.ts → types-I7U99DvG.d.ts}

@@ -167,11 +167,11 @@ declare function buildSwapTx(params: {
  * 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`).
+ * - **Wallet mode** (`inputCoin` omitted) — sources `from`-asset funds
+ *   via `coinWithBalance({ type, balance })` (resolves coin objects +
+ *   address balance at build time), 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
@@ -179,14 +179,18 @@ declare function buildSwapTx(params: {
  *   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.)
+ * **SUI in wallet mode:** ALWAYS sources through `selectSuiCoin` (which
+ * routes via `coinWithBalance({ type: SUI, useGasCoin: false })` under
+ * sponsored flows, OR `tx.splitCoins(tx.gas, ...)` under self-funded
+ * flows). The caller MUST set `sponsoredContext` correctly — otherwise
+ * sponsored swaps with SUI source fail with `Cannot use GasCoin as a
+ * transaction argument` (Enoki owns `tx.gas`, the PTB body referencing
+ * it as an argument is invalid for sponsorship). 2.14.0 shipped without
+ * this branch and broke audric/web-v2 SUI→USDC swaps; restored in 2.14.1
+ * (S.260). For non-sponsored flows (CLI), `T2000.swap()` pre-builds the
+ * inputCoin via `tx.splitCoins(tx.gas, [rawAmount])[0]` and uses chain
+ * mode, sidestepping wallet-mode entirely — this branch is a defensive
+ * safety net for future direct SDK users who pass SUI in wallet mode.
  *
  * **`swapAll` semantics (wallet mode):** if the requested raw amount
  * is >= the wallet's total `from` balance, the appender consumes the
@@ -235,6 +239,19 @@ declare function addSwapToTx(tx: Transaction, client: SuiJsonRpcClient, address:
      * config (the route data already encodes the chosen DEX path).
      */
     precomputedRoute?: SwapRouteResult;
+    /**
+     * Whether this swap is being built inside a sponsored-tx flow (Enoki)
+     * vs self-funded (CLI / direct sign). Load-bearing for SUI-source
+     * swaps in wallet mode: under sponsored flows, `tx.gas` belongs to
+     * the sponsor and CANNOT be referenced as a transaction argument
+     * (Sui protocol rejects with `Cannot use GasCoin as a transaction
+     * argument`). When `true`, SUI source routes through `selectSuiCoin`
+     * with `useGasCoin: false` so the resolver sources from the user's
+     * SUI coin objects + address balance instead. Defaults to `false`
+     * (back-compat — pre-2.14.1 behavior). Audric/web-v2's compose path
+     * threads this through via `composeTx({ sponsoredContext: true })`.
+     */
+    sponsoredContext?: boolean;
 }): Promise<{
     coin: TransactionObjectArgument;
     effectiveAmountIn: number;
@@ -526,6 +543,14 @@ interface PayResult {
     body: unknown;
     paid: boolean;
     cost?: number;
+    /**
+     * SUI gas cost actually paid on chain. Zero for gasless payments —
+     * which means an MPP payment hit the protocol's gasless allowlist
+     * (USDC / USDsui / USDY / FdUSD / AUSD / BUCK / USDB / SUI_USDE) and
+     * was accepted with `gasPrice=0, gasBudget=0, gasPayment=[]`. See
+     * https://docs.sui.io/develop/transaction-payment/gasless-stablecoin-transfers
+     */
+    gasCostSui?: number;
     receipt?: {
         reference: string;
         timestamp: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/sdk",
-  "version": "2.13.2",
+  "version": "2.14.1",
   "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",