@t2000/sdk 2.13.1 → 2.14.0

package/dist/{types-BY6ovQGK.d.cts → types-1WUNZK-9.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-CFJrgLm2.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 
 /**

package/dist/{types-epj9U13o.d.cts → types-CFJrgLm2.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,14 @@ 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:** routes through `selectAndSplitCoin` like every
+ * other token, which uses `coinWithBalance` to pull from the user's SUI
+ * (coin objects + address balance) — NOT from `tx.gas`. This is correct
+ * for sponsored flows (Enoki owns `tx.gas`). 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 this appender.)
  *
  * **`swapAll` semantics (wallet mode):** if the requested raw amount
  * is >= the wallet's total `from` balance, the appender consumes the
@@ -526,6 +526,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-CFJrgLm2.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,14 @@ 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:** routes through `selectAndSplitCoin` like every
+ * other token, which uses `coinWithBalance` to pull from the user's SUI
+ * (coin objects + address balance) — NOT from `tx.gas`. This is correct
+ * for sponsored flows (Enoki owns `tx.gas`). 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 this appender.)
  *
  * **`swapAll` semantics (wallet mode):** if the requested raw amount
  * is >= the wallet's total `from` balance, the appender consumes the
@@ -526,6 +526,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-WeZQDV54.d.ts → types-D65N3sBO.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-CFJrgLm2.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 
 /**

package/package.json

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