@t2000/sdk 5.5.1 → 5.6.0

package/dist/{simulate-KETPmlDo.d.cts → send-D2nKpwJN.d.cts}

@@ -286,6 +286,63 @@ type SponsoredCoinMergeCache = Map<string, {
  */
 declare function selectSuiCoin(tx: Transaction, client: SuiCoreClient, owner: string, amountMist: bigint, sponsoredContext: boolean, mergeCache?: SponsoredCoinMergeCache): Promise<SelectAndSplitResult>;
 
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'ADDRESS_BALANCE_UNSPONSORABLE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'WALLET_CORRUPT' | 'INVALID_KEY' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'INVALID_ASSET' | 'PROTOCOL_UNAVAILABLE' | 'RPC_ERROR' | 'RPC_UNREACHABLE' | 'PRICE_EXCEEDS_LIMIT' | 'UNSUPPORTED_NETWORK' | 'PAYMENT_EXPIRED' | 'DUPLICATE_PAYMENT' | 'FACILITATOR_REJECTION' | 'CONTACT_NOT_FOUND' | 'INVALID_CONTACT_NAME' | 'SUINS_NOT_REGISTERED' | 'FACILITATOR_TIMEOUT' | 'SAFEGUARD_BLOCKED' | 'SWAP_NO_ROUTE' | 'SWAP_FAILED' | 'CHAIN_MODE_INVALID' | 'UNKNOWN';
+interface T2000ErrorData {
+    reason?: string;
+    [key: string]: unknown;
+}
+declare class T2000Error extends Error {
+    readonly code: T2000ErrorCode;
+    readonly data?: T2000ErrorData;
+    readonly retryable: boolean;
+    constructor(code: T2000ErrorCode, message: string, data?: T2000ErrorData, retryable?: boolean);
+    toJSON(): {
+        retryable: boolean;
+        data?: T2000ErrorData | undefined;
+        error: T2000ErrorCode;
+        message: string;
+    };
+}
+declare function mapWalletError(error: unknown): T2000Error;
+declare function mapMoveAbortCode(code: number): string;
+
+/**
+ * The result of a synchronous preflight check. `valid: false` carries a
+ * `T2000ErrorCode` + human message so the host can surface a precise reason
+ * (and the builder can rethrow it as a `T2000Error` verbatim).
+ */
+type PreflightResult = {
+    valid: true;
+} | {
+    valid: false;
+    code: T2000ErrorCode;
+    error: string;
+};
+/**
+ * Fat-finger / overflow ceiling for an asset amount. NOT a spending policy
+ * (that's the `@t2000/sdk/limits` module — USD-denominated, opt-in, stateful);
+ * this is the "obviously wrong number" guard the safeguards rule prescribes
+ * (`amount > 1_000_000` → unreasonable).
+ */
+declare const PREFLIGHT_MAX_AMOUNT = 1000000;
+declare const PREFLIGHT_OK: PreflightResult;
+declare function preflightFail(code: T2000ErrorCode, error: string): PreflightResult;
+/**
+ * Pure positive-finite-amount sanity check (no network). Rejects NaN/Infinity
+ * and non-positive values. The absurd-value ceiling defaults to
+ * {@link PREFLIGHT_MAX_AMOUNT} but callers can raise it — pass
+ * `max: Number.POSITIVE_INFINITY` for swaps of low-unit-value tokens
+ * (memecoins legitimately trade in millions/billions of units), where a fixed
+ * display-amount ceiling would be a false positive.
+ */
+declare function checkPositiveAmount(amount: number, label?: string, max?: number): PreflightResult;
+/**
+ * Pure, synchronous Sui-address validity (no throw, no network) — the
+ * non-throwing sibling of `validateAddress`. Use in preflight; use
+ * `validateAddress` when you need the normalized form.
+ */
+declare function checkSuiAddress(address: string, label?: string): PreflightResult;
+
 /**
  * Unified token registry — single source of truth for coin types, decimals,
  * and symbols. ZERO heavy dependencies; safe to import anywhere (server,
@@ -373,6 +430,21 @@ declare const MANIFEST_TYPE: string;
  * by removing the singleton pattern that hid the misconfig.
  */
 
+/**
+ * Synchronous, network-free preflight for `swap`. Validates the from/to token
+ * args + amount sanity, and rejects an identity swap — the cheap checks the
+ * host runs before routing. Returns a `PreflightResult`; never throws.
+ * Route-finding, liquidity, slippage + decimals resolution stay in the async
+ * path (`findSwapRoute`/`buildSwapTx`/`getSwapQuote`).
+ *
+ * v3 drops the swap *tool*, but `swap` survives as an SDK/CLI builder (§8) so
+ * it gets the same builder-appropriate preflight as send/pay.
+ */
+declare function preflightSwap(input: {
+    from: string;
+    to: string;
+    amount: number;
+}): PreflightResult;
 interface OverlayFeeConfig {
     /** Fee rate as a fraction (e.g. 0.001 = 0.1%). Pass 0 to disable. */
     rate: number;
@@ -836,6 +908,17 @@ interface PayResult {
     };
 }
 
+/**
+ * Synchronous, network-free preflight for `pay` (x402 Service call). Validates
+ * the target URL shape and the `maxPrice` ceiling when present — the cheap
+ * checks the v3 host runs before dispatching the paid tool / showing the
+ * tap-to-confirm card. Returns a `PreflightResult`; never throws. The probe +
+ * 402 handshake + balance migration stay in `payWithMpp` (network).
+ */
+declare function preflightPay(input: {
+    url: string;
+    maxPrice?: number;
+}): PreflightResult;
 declare function payWithMpp(args: {
     signer: TransactionSigner;
     client: SuiGrpcClient;
@@ -852,26 +935,6 @@ declare function executeTx(client: SuiCoreClient, signer: TransactionSigner, bui
     effects: SuiTransactionEffects | undefined;
 }>;
 
-type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'ADDRESS_BALANCE_UNSPONSORABLE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'WALLET_CORRUPT' | 'INVALID_KEY' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'INVALID_ASSET' | 'PROTOCOL_UNAVAILABLE' | 'RPC_ERROR' | 'RPC_UNREACHABLE' | 'PRICE_EXCEEDS_LIMIT' | 'UNSUPPORTED_NETWORK' | 'PAYMENT_EXPIRED' | 'DUPLICATE_PAYMENT' | 'FACILITATOR_REJECTION' | 'CONTACT_NOT_FOUND' | 'INVALID_CONTACT_NAME' | 'SUINS_NOT_REGISTERED' | 'FACILITATOR_TIMEOUT' | 'SAFEGUARD_BLOCKED' | 'SWAP_NO_ROUTE' | 'SWAP_FAILED' | 'CHAIN_MODE_INVALID' | 'UNKNOWN';
-interface T2000ErrorData {
-    reason?: string;
-    [key: string]: unknown;
-}
-declare class T2000Error extends Error {
-    readonly code: T2000ErrorCode;
-    readonly data?: T2000ErrorData;
-    readonly retryable: boolean;
-    constructor(code: T2000ErrorCode, message: string, data?: T2000ErrorData, retryable?: boolean);
-    toJSON(): {
-        retryable: boolean;
-        data?: T2000ErrorData | undefined;
-        error: T2000ErrorCode;
-        message: string;
-    };
-}
-declare function mapWalletError(error: unknown): T2000Error;
-declare function mapMoveAbortCode(code: number): string;
-
 declare const MIST_PER_SUI = 1000000000n;
 declare const SUI_DECIMALS = 9;
 declare const USDC_DECIMALS = 6;
@@ -1202,4 +1265,82 @@ interface SimulationResult {
 declare function simulateTransaction(client: SuiCoreClient, tx: Transaction, sender: string): Promise<SimulationResult>;
 declare function throwIfSimulationFailed(sim: SimulationResult): void;
 
-export { classifyAction as $, type TransactionRecord as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type TransactionSigner as F, GAS_RESERVE_MIN as G, type TxDirection as H, IKA_TYPE as I, USDC_TYPE as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, type PayOptions as P, USDE_TYPE as Q, USDSUI_TYPE as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, USDT_TYPE as V, WAL_TYPE as W, WBTC_TYPE as X, ZkLoginSigner as Y, type ZkLoginProof as Z, buildSwapTx as _, COIN_REGISTRY as a, selectSuiCoin as a$, classifyLabel as a0, classifyTransaction as a1, executeTx as a2, extractAllUserLegs as a3, extractTransferDetails as a4, extractTxCommands as a5, extractTxSender as a6, fallbackLabel as a7, findSwapRoute as a8, formatAssetAmount as a9, CETUS_USDC_SUI_POOL as aA, type CoinPage as aB, DEFAULT_GRPC_URL as aC, GASLESS_MIN_STABLE_AMOUNT as aD, GASLESS_STABLE_TYPES as aE, OPERATION_ASSETS as aF, type Operation as aG, SENDABLE_ASSETS as aH, type SelectAndSplitResult as aI, type SerializedCetusRoute as aJ, type SerializedCetusRoutePath as aK, type SerializedRouterDataV3 as aL, addSwapToTx as aM, assertAllowedAsset as aN, deserializeCetusRoute as aO, fetchAllCoins as aP, getCoinMeta as aQ, getSuiClient as aR, getSuiGrpcClient as aS, isAllowedAsset as aT, isCetusRouteFresh as aU, isInRegistry as aV, normalizeAsset as aW, normalizeCoinType as aX, queryHistory as aY, queryTransaction as aZ, selectAndSplitCoin as a_, formatSui as aa, formatUsd as ab, getDecimals as ac, getDecimalsForCoinType as ad, mapMoveAbortCode as ae, mapWalletError as af, mistToSui as ag, parseSuiRpcTx as ah, payWithMpp as ai, rawToStable as aj, rawToUsdc as ak, refineLendingLabel as al, resolveSymbol as am, resolveTokenType as an, stableToRaw as ao, suiToMist as ap, truncateAddress as aq, usdcToRaw as ar, validateAddress as as, type T2000Options as at, type SwapResult as au, type SwapQuoteResult as av, type PaymentRequest as aw, type SuiCoreClient as ax, type SendableAsset as ay, type SponsoredCoinMergeCache as az, type ClassifyBalanceChange as b, serializeCetusRoute as b0, simulateTransaction as b1, throwIfSimulationFailed as b2, verifyCetusRouteCoinMatch as b3, type ClassifyResult as c, type CoinMeta as d, type DepositInfo as e, type ExtractedTransfer as f, KeypairSigner as g, LOFI_TYPE as h, MIST_PER_SUI as i, type OverlayFeeConfig as j, type PayResult as k, SUI_DECIMALS as l, SUI_TYPE as m, SUPPORTED_ASSETS as n, type SendResult as o, type SimulationResult as p, type StableAsset as q, type SuiHolding as r, type SuiRpcTxBlock as s, type SupportedAsset as t, type SwapRouteResult as u, type T2000ErrorCode as v, type T2000ErrorData as w, T2000_OVERLAY_FEE_WALLET as x, TOKEN_MAP as y, type TransactionLeg as z };
+/**
+ * Synchronous, network-free preflight for `send`. Validates asset membership,
+ * amount sanity, the gasless stable floor, and recipient address shape — the
+ * cheap checks the v3 host runs before the LLM round-trip / tap-to-confirm.
+ * Returns a `PreflightResult`; never throws. `buildSendTx` calls this first,
+ * then layers the network balance read on top.
+ */
+declare function preflightSend(input: {
+    to: string;
+    amount: number;
+    asset: string;
+}): PreflightResult;
+/**
+ * Build a PTB that sends `amount` of `asset` from `address` to `to`.
+ *
+ * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+ *
+ * Asset constraint: `'USDC' | 'USDsui' | 'SUI'` only. Other assets throw
+ * `INVALID_ASSET` via `assertAllowedAsset('send', asset)`. The constrained
+ * set matches Sui mainnet's gasless allowlist (USDC + USDsui) plus SUI
+ * for users who want a gas-native transfer.
+ *
+ * Build paths:
+ * - **USDC / USDsui** — `0x2::balance::send_funds` Move call with a
+ *   `tx.balance({ type, balance })` input. When built via `SuiGrpcClient`,
+ *   the gRPC resolver auto-detects gasless eligibility and zeros gas.
+ *   When built via `SuiJsonRpcClient`, the same PTB still executes but
+ *   the caller pays normal gas. Minimum 0.01 (protocol allowlist floor).
+ * - **SUI** — `tx.splitCoins(tx.gas, [amount]) → tx.transferObjects()`.
+ *   Standard gas-native transfer. No minimum.
+ *
+ * Pre-flight balance check stays on JSON-RPC (`client.getBalance`) — it
+ * sums coin objects + address balance so the legacy `getCoins` page miss
+ * doesn't break for users whose stables landed via gasless deposits.
+ *
+ * `asset` is REQUIRED (no implicit USDC default — pre-v4 hid LLM intent
+ * errors). Callers passing the wrong asset get an explicit error rather
+ * than a silent currency substitution.
+ */
+declare function buildSendTx({ client, address, to, amount, asset, }: {
+    client: SuiCoreClient;
+    address: string;
+    to: string;
+    amount: number;
+    asset: SendableAsset;
+}): Promise<Transaction>;
+/**
+ * Fragment-appender for the chain-mode send leg of SPEC 7 multi-write
+ * Payment Intents. Consumes a coin reference produced by a previous
+ * appender (e.g. `addWithdrawToTx`, `addSwapToTx`) and transfers it to
+ * `recipient` within the same Payment Intent — no intermediate wallet
+ * materialization.
+ *
+ * Codifies the hand-built send leg from
+ * `scripts/smoke-spec7-withdraw-then-send.ts` (P2.1) into a typed
+ * appender. SPEC 7 § "Layer 1" — P2.2b will register this in the
+ * `WRITE_APPENDER_REGISTRY` under `send_transfer` for chain-mode
+ * dispatch; the registry adapter will handle the wallet-fetch fallback
+ * by delegating to `buildSendTx` when no upstream coin is available.
+ *
+ * For single-step send_transfer flows (no chained predecessor), use
+ * `buildSendTx` directly — it builds a complete tx including the
+ * wallet-coin selection / merge / split prelude.
+ *
+ * [v4.0 Phase A Day 2] Stays on the legacy `transferObjects` path
+ * because chain-mode bundles are NEVER gasless — by definition they
+ * combine multiple Move calls (`withdraw → send`, `swap → send`) which
+ * fail the protocol allowlist check (only `balance::send_funds` and
+ * a few related helpers are eligible). The bundled flow still works,
+ * the user just pays gas (or has it sponsored by audric via Enoki).
+ *
+ * @returns void — the coin is consumed by `tx.transferObjects`. Callers
+ *   that need the post-transfer "effective amount" should rely on the
+ *   upstream appender's `effectiveAmount` (e.g. `addWithdrawToTx`'s
+ *   return), not on this appender.
+ */
+declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, recipient: string): void;
+
+export { type ZkLoginProof as $, T2000_OVERLAY_FEE_WALLET as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, TOKEN_MAP as F, GAS_RESERVE_MIN as G, type TransactionLeg as H, IKA_TYPE as I, type TransactionRecord as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, PREFLIGHT_MAX_AMOUNT as P, type TransactionSigner as Q, type TxDirection as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, USDC_TYPE as V, USDE_TYPE as W, USDSUI_TYPE as X, USDT_TYPE as Y, WAL_TYPE as Z, WBTC_TYPE as _, COIN_REGISTRY as a, getCoinMeta as a$, ZkLoginSigner as a0, buildSendTx as a1, buildSwapTx as a2, checkPositiveAmount as a3, checkSuiAddress as a4, classifyAction as a5, classifyLabel as a6, classifyTransaction as a7, executeTx as a8, extractAllUserLegs as a9, truncateAddress as aA, usdcToRaw as aB, validateAddress as aC, type T2000Options as aD, type SwapResult as aE, type SwapQuoteResult as aF, type PaymentRequest as aG, type SuiCoreClient as aH, type SponsoredCoinMergeCache as aI, type SendableAsset as aJ, CETUS_USDC_SUI_POOL as aK, type CoinPage as aL, DEFAULT_GRPC_URL as aM, GASLESS_MIN_STABLE_AMOUNT as aN, GASLESS_STABLE_TYPES as aO, OPERATION_ASSETS as aP, type Operation as aQ, SENDABLE_ASSETS as aR, type SelectAndSplitResult as aS, type SerializedCetusRoute as aT, type SerializedCetusRoutePath as aU, type SerializedRouterDataV3 as aV, addSendToTx as aW, addSwapToTx as aX, assertAllowedAsset as aY, deserializeCetusRoute as aZ, fetchAllCoins as a_, extractTransferDetails as aa, extractTxCommands as ab, extractTxSender as ac, fallbackLabel as ad, findSwapRoute as ae, formatAssetAmount as af, formatSui as ag, formatUsd as ah, getDecimals as ai, getDecimalsForCoinType as aj, mapMoveAbortCode as ak, mapWalletError as al, mistToSui as am, parseSuiRpcTx as an, payWithMpp as ao, preflightFail as ap, preflightPay as aq, preflightSend as ar, preflightSwap as as, rawToStable as at, rawToUsdc as au, refineLendingLabel as av, resolveSymbol as aw, resolveTokenType as ax, stableToRaw as ay, suiToMist as az, type ClassifyBalanceChange as b, getSuiClient as b0, getSuiGrpcClient as b1, isAllowedAsset as b2, isCetusRouteFresh as b3, isInRegistry as b4, normalizeAsset as b5, normalizeCoinType as b6, queryHistory as b7, queryTransaction as b8, selectAndSplitCoin as b9, selectSuiCoin as ba, serializeCetusRoute as bb, simulateTransaction as bc, throwIfSimulationFailed as bd, verifyCetusRouteCoinMatch as be, type ClassifyResult as c, type CoinMeta as d, type DepositInfo as e, type ExtractedTransfer as f, KeypairSigner as g, LOFI_TYPE as h, MIST_PER_SUI as i, type OverlayFeeConfig as j, PREFLIGHT_OK as k, type PayOptions as l, type PayResult as m, type PreflightResult as n, SUI_DECIMALS as o, SUI_TYPE as p, SUPPORTED_ASSETS as q, type SendResult as r, type SimulationResult as s, type StableAsset as t, type SuiHolding as u, type SuiRpcTxBlock as v, type SupportedAsset as w, type SwapRouteResult as x, type T2000ErrorCode as y, type T2000ErrorData as z };

package/dist/{simulate-KETPmlDo.d.ts → send-D2nKpwJN.d.ts}

@@ -286,6 +286,63 @@ type SponsoredCoinMergeCache = Map<string, {
  */
 declare function selectSuiCoin(tx: Transaction, client: SuiCoreClient, owner: string, amountMist: bigint, sponsoredContext: boolean, mergeCache?: SponsoredCoinMergeCache): Promise<SelectAndSplitResult>;
 
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'ADDRESS_BALANCE_UNSPONSORABLE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'WALLET_CORRUPT' | 'INVALID_KEY' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'INVALID_ASSET' | 'PROTOCOL_UNAVAILABLE' | 'RPC_ERROR' | 'RPC_UNREACHABLE' | 'PRICE_EXCEEDS_LIMIT' | 'UNSUPPORTED_NETWORK' | 'PAYMENT_EXPIRED' | 'DUPLICATE_PAYMENT' | 'FACILITATOR_REJECTION' | 'CONTACT_NOT_FOUND' | 'INVALID_CONTACT_NAME' | 'SUINS_NOT_REGISTERED' | 'FACILITATOR_TIMEOUT' | 'SAFEGUARD_BLOCKED' | 'SWAP_NO_ROUTE' | 'SWAP_FAILED' | 'CHAIN_MODE_INVALID' | 'UNKNOWN';
+interface T2000ErrorData {
+    reason?: string;
+    [key: string]: unknown;
+}
+declare class T2000Error extends Error {
+    readonly code: T2000ErrorCode;
+    readonly data?: T2000ErrorData;
+    readonly retryable: boolean;
+    constructor(code: T2000ErrorCode, message: string, data?: T2000ErrorData, retryable?: boolean);
+    toJSON(): {
+        retryable: boolean;
+        data?: T2000ErrorData | undefined;
+        error: T2000ErrorCode;
+        message: string;
+    };
+}
+declare function mapWalletError(error: unknown): T2000Error;
+declare function mapMoveAbortCode(code: number): string;
+
+/**
+ * The result of a synchronous preflight check. `valid: false` carries a
+ * `T2000ErrorCode` + human message so the host can surface a precise reason
+ * (and the builder can rethrow it as a `T2000Error` verbatim).
+ */
+type PreflightResult = {
+    valid: true;
+} | {
+    valid: false;
+    code: T2000ErrorCode;
+    error: string;
+};
+/**
+ * Fat-finger / overflow ceiling for an asset amount. NOT a spending policy
+ * (that's the `@t2000/sdk/limits` module — USD-denominated, opt-in, stateful);
+ * this is the "obviously wrong number" guard the safeguards rule prescribes
+ * (`amount > 1_000_000` → unreasonable).
+ */
+declare const PREFLIGHT_MAX_AMOUNT = 1000000;
+declare const PREFLIGHT_OK: PreflightResult;
+declare function preflightFail(code: T2000ErrorCode, error: string): PreflightResult;
+/**
+ * Pure positive-finite-amount sanity check (no network). Rejects NaN/Infinity
+ * and non-positive values. The absurd-value ceiling defaults to
+ * {@link PREFLIGHT_MAX_AMOUNT} but callers can raise it — pass
+ * `max: Number.POSITIVE_INFINITY` for swaps of low-unit-value tokens
+ * (memecoins legitimately trade in millions/billions of units), where a fixed
+ * display-amount ceiling would be a false positive.
+ */
+declare function checkPositiveAmount(amount: number, label?: string, max?: number): PreflightResult;
+/**
+ * Pure, synchronous Sui-address validity (no throw, no network) — the
+ * non-throwing sibling of `validateAddress`. Use in preflight; use
+ * `validateAddress` when you need the normalized form.
+ */
+declare function checkSuiAddress(address: string, label?: string): PreflightResult;
+
 /**
  * Unified token registry — single source of truth for coin types, decimals,
  * and symbols. ZERO heavy dependencies; safe to import anywhere (server,
@@ -373,6 +430,21 @@ declare const MANIFEST_TYPE: string;
  * by removing the singleton pattern that hid the misconfig.
  */
 
+/**
+ * Synchronous, network-free preflight for `swap`. Validates the from/to token
+ * args + amount sanity, and rejects an identity swap — the cheap checks the
+ * host runs before routing. Returns a `PreflightResult`; never throws.
+ * Route-finding, liquidity, slippage + decimals resolution stay in the async
+ * path (`findSwapRoute`/`buildSwapTx`/`getSwapQuote`).
+ *
+ * v3 drops the swap *tool*, but `swap` survives as an SDK/CLI builder (§8) so
+ * it gets the same builder-appropriate preflight as send/pay.
+ */
+declare function preflightSwap(input: {
+    from: string;
+    to: string;
+    amount: number;
+}): PreflightResult;
 interface OverlayFeeConfig {
     /** Fee rate as a fraction (e.g. 0.001 = 0.1%). Pass 0 to disable. */
     rate: number;
@@ -836,6 +908,17 @@ interface PayResult {
     };
 }
 
+/**
+ * Synchronous, network-free preflight for `pay` (x402 Service call). Validates
+ * the target URL shape and the `maxPrice` ceiling when present — the cheap
+ * checks the v3 host runs before dispatching the paid tool / showing the
+ * tap-to-confirm card. Returns a `PreflightResult`; never throws. The probe +
+ * 402 handshake + balance migration stay in `payWithMpp` (network).
+ */
+declare function preflightPay(input: {
+    url: string;
+    maxPrice?: number;
+}): PreflightResult;
 declare function payWithMpp(args: {
     signer: TransactionSigner;
     client: SuiGrpcClient;
@@ -852,26 +935,6 @@ declare function executeTx(client: SuiCoreClient, signer: TransactionSigner, bui
     effects: SuiTransactionEffects | undefined;
 }>;
 
-type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'ADDRESS_BALANCE_UNSPONSORABLE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | 'WALLET_CORRUPT' | 'INVALID_KEY' | 'SIMULATION_FAILED' | 'TRANSACTION_FAILED' | 'ASSET_NOT_SUPPORTED' | 'INVALID_ASSET' | 'PROTOCOL_UNAVAILABLE' | 'RPC_ERROR' | 'RPC_UNREACHABLE' | 'PRICE_EXCEEDS_LIMIT' | 'UNSUPPORTED_NETWORK' | 'PAYMENT_EXPIRED' | 'DUPLICATE_PAYMENT' | 'FACILITATOR_REJECTION' | 'CONTACT_NOT_FOUND' | 'INVALID_CONTACT_NAME' | 'SUINS_NOT_REGISTERED' | 'FACILITATOR_TIMEOUT' | 'SAFEGUARD_BLOCKED' | 'SWAP_NO_ROUTE' | 'SWAP_FAILED' | 'CHAIN_MODE_INVALID' | 'UNKNOWN';
-interface T2000ErrorData {
-    reason?: string;
-    [key: string]: unknown;
-}
-declare class T2000Error extends Error {
-    readonly code: T2000ErrorCode;
-    readonly data?: T2000ErrorData;
-    readonly retryable: boolean;
-    constructor(code: T2000ErrorCode, message: string, data?: T2000ErrorData, retryable?: boolean);
-    toJSON(): {
-        retryable: boolean;
-        data?: T2000ErrorData | undefined;
-        error: T2000ErrorCode;
-        message: string;
-    };
-}
-declare function mapWalletError(error: unknown): T2000Error;
-declare function mapMoveAbortCode(code: number): string;
-
 declare const MIST_PER_SUI = 1000000000n;
 declare const SUI_DECIMALS = 9;
 declare const USDC_DECIMALS = 6;
@@ -1202,4 +1265,82 @@ interface SimulationResult {
 declare function simulateTransaction(client: SuiCoreClient, tx: Transaction, sender: string): Promise<SimulationResult>;
 declare function throwIfSimulationFailed(sim: SimulationResult): void;
 
-export { classifyAction as $, type TransactionRecord as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, type TransactionSigner as F, GAS_RESERVE_MIN as G, type TxDirection as H, IKA_TYPE as I, USDC_TYPE as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, type PayOptions as P, USDE_TYPE as Q, USDSUI_TYPE as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, USDT_TYPE as V, WAL_TYPE as W, WBTC_TYPE as X, ZkLoginSigner as Y, type ZkLoginProof as Z, buildSwapTx as _, COIN_REGISTRY as a, selectSuiCoin as a$, classifyLabel as a0, classifyTransaction as a1, executeTx as a2, extractAllUserLegs as a3, extractTransferDetails as a4, extractTxCommands as a5, extractTxSender as a6, fallbackLabel as a7, findSwapRoute as a8, formatAssetAmount as a9, CETUS_USDC_SUI_POOL as aA, type CoinPage as aB, DEFAULT_GRPC_URL as aC, GASLESS_MIN_STABLE_AMOUNT as aD, GASLESS_STABLE_TYPES as aE, OPERATION_ASSETS as aF, type Operation as aG, SENDABLE_ASSETS as aH, type SelectAndSplitResult as aI, type SerializedCetusRoute as aJ, type SerializedCetusRoutePath as aK, type SerializedRouterDataV3 as aL, addSwapToTx as aM, assertAllowedAsset as aN, deserializeCetusRoute as aO, fetchAllCoins as aP, getCoinMeta as aQ, getSuiClient as aR, getSuiGrpcClient as aS, isAllowedAsset as aT, isCetusRouteFresh as aU, isInRegistry as aV, normalizeAsset as aW, normalizeCoinType as aX, queryHistory as aY, queryTransaction as aZ, selectAndSplitCoin as a_, formatSui as aa, formatUsd as ab, getDecimals as ac, getDecimalsForCoinType as ad, mapMoveAbortCode as ae, mapWalletError as af, mistToSui as ag, parseSuiRpcTx as ah, payWithMpp as ai, rawToStable as aj, rawToUsdc as ak, refineLendingLabel as al, resolveSymbol as am, resolveTokenType as an, stableToRaw as ao, suiToMist as ap, truncateAddress as aq, usdcToRaw as ar, validateAddress as as, type T2000Options as at, type SwapResult as au, type SwapQuoteResult as av, type PaymentRequest as aw, type SuiCoreClient as ax, type SendableAsset as ay, type SponsoredCoinMergeCache as az, type ClassifyBalanceChange as b, serializeCetusRoute as b0, simulateTransaction as b1, throwIfSimulationFailed as b2, verifyCetusRouteCoinMatch as b3, type ClassifyResult as c, type CoinMeta as d, type DepositInfo as e, type ExtractedTransfer as f, KeypairSigner as g, LOFI_TYPE as h, MIST_PER_SUI as i, type OverlayFeeConfig as j, type PayResult as k, SUI_DECIMALS as l, SUI_TYPE as m, SUPPORTED_ASSETS as n, type SendResult as o, type SimulationResult as p, type StableAsset as q, type SuiHolding as r, type SuiRpcTxBlock as s, type SupportedAsset as t, type SwapRouteResult as u, type T2000ErrorCode as v, type T2000ErrorData as w, T2000_OVERLAY_FEE_WALLET as x, TOKEN_MAP as y, type TransactionLeg as z };
+/**
+ * Synchronous, network-free preflight for `send`. Validates asset membership,
+ * amount sanity, the gasless stable floor, and recipient address shape — the
+ * cheap checks the v3 host runs before the LLM round-trip / tap-to-confirm.
+ * Returns a `PreflightResult`; never throws. `buildSendTx` calls this first,
+ * then layers the network balance read on top.
+ */
+declare function preflightSend(input: {
+    to: string;
+    amount: number;
+    asset: string;
+}): PreflightResult;
+/**
+ * Build a PTB that sends `amount` of `asset` from `address` to `to`.
+ *
+ * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+ *
+ * Asset constraint: `'USDC' | 'USDsui' | 'SUI'` only. Other assets throw
+ * `INVALID_ASSET` via `assertAllowedAsset('send', asset)`. The constrained
+ * set matches Sui mainnet's gasless allowlist (USDC + USDsui) plus SUI
+ * for users who want a gas-native transfer.
+ *
+ * Build paths:
+ * - **USDC / USDsui** — `0x2::balance::send_funds` Move call with a
+ *   `tx.balance({ type, balance })` input. When built via `SuiGrpcClient`,
+ *   the gRPC resolver auto-detects gasless eligibility and zeros gas.
+ *   When built via `SuiJsonRpcClient`, the same PTB still executes but
+ *   the caller pays normal gas. Minimum 0.01 (protocol allowlist floor).
+ * - **SUI** — `tx.splitCoins(tx.gas, [amount]) → tx.transferObjects()`.
+ *   Standard gas-native transfer. No minimum.
+ *
+ * Pre-flight balance check stays on JSON-RPC (`client.getBalance`) — it
+ * sums coin objects + address balance so the legacy `getCoins` page miss
+ * doesn't break for users whose stables landed via gasless deposits.
+ *
+ * `asset` is REQUIRED (no implicit USDC default — pre-v4 hid LLM intent
+ * errors). Callers passing the wrong asset get an explicit error rather
+ * than a silent currency substitution.
+ */
+declare function buildSendTx({ client, address, to, amount, asset, }: {
+    client: SuiCoreClient;
+    address: string;
+    to: string;
+    amount: number;
+    asset: SendableAsset;
+}): Promise<Transaction>;
+/**
+ * Fragment-appender for the chain-mode send leg of SPEC 7 multi-write
+ * Payment Intents. Consumes a coin reference produced by a previous
+ * appender (e.g. `addWithdrawToTx`, `addSwapToTx`) and transfers it to
+ * `recipient` within the same Payment Intent — no intermediate wallet
+ * materialization.
+ *
+ * Codifies the hand-built send leg from
+ * `scripts/smoke-spec7-withdraw-then-send.ts` (P2.1) into a typed
+ * appender. SPEC 7 § "Layer 1" — P2.2b will register this in the
+ * `WRITE_APPENDER_REGISTRY` under `send_transfer` for chain-mode
+ * dispatch; the registry adapter will handle the wallet-fetch fallback
+ * by delegating to `buildSendTx` when no upstream coin is available.
+ *
+ * For single-step send_transfer flows (no chained predecessor), use
+ * `buildSendTx` directly — it builds a complete tx including the
+ * wallet-coin selection / merge / split prelude.
+ *
+ * [v4.0 Phase A Day 2] Stays on the legacy `transferObjects` path
+ * because chain-mode bundles are NEVER gasless — by definition they
+ * combine multiple Move calls (`withdraw → send`, `swap → send`) which
+ * fail the protocol allowlist check (only `balance::send_funds` and
+ * a few related helpers are eligible). The bundled flow still works,
+ * the user just pays gas (or has it sponsored by audric via Enoki).
+ *
+ * @returns void — the coin is consumed by `tx.transferObjects`. Callers
+ *   that need the post-transfer "effective amount" should rely on the
+ *   upstream appender's `effectiveAmount` (e.g. `addWithdrawToTx`'s
+ *   return), not on this appender.
+ */
+declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, recipient: string): void;
+
+export { type ZkLoginProof as $, T2000_OVERLAY_FEE_WALLET as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_NETWORK as D, ETH_TYPE as E, TOKEN_MAP as F, GAS_RESERVE_MIN as G, type TransactionLeg as H, IKA_TYPE as I, type TransactionRecord as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, PREFLIGHT_MAX_AMOUNT as P, type TransactionSigner as Q, type TxDirection as R, STABLE_ASSETS as S, T2000Error as T, USDC_DECIMALS as U, USDC_TYPE as V, USDE_TYPE as W, USDSUI_TYPE as X, USDT_TYPE as Y, WAL_TYPE as Z, WBTC_TYPE as _, COIN_REGISTRY as a, getCoinMeta as a$, ZkLoginSigner as a0, buildSendTx as a1, buildSwapTx as a2, checkPositiveAmount as a3, checkSuiAddress as a4, classifyAction as a5, classifyLabel as a6, classifyTransaction as a7, executeTx as a8, extractAllUserLegs as a9, truncateAddress as aA, usdcToRaw as aB, validateAddress as aC, type T2000Options as aD, type SwapResult as aE, type SwapQuoteResult as aF, type PaymentRequest as aG, type SuiCoreClient as aH, type SponsoredCoinMergeCache as aI, type SendableAsset as aJ, CETUS_USDC_SUI_POOL as aK, type CoinPage as aL, DEFAULT_GRPC_URL as aM, GASLESS_MIN_STABLE_AMOUNT as aN, GASLESS_STABLE_TYPES as aO, OPERATION_ASSETS as aP, type Operation as aQ, SENDABLE_ASSETS as aR, type SelectAndSplitResult as aS, type SerializedCetusRoute as aT, type SerializedCetusRoutePath as aU, type SerializedRouterDataV3 as aV, addSendToTx as aW, addSwapToTx as aX, assertAllowedAsset as aY, deserializeCetusRoute as aZ, fetchAllCoins as a_, extractTransferDetails as aa, extractTxCommands as ab, extractTxSender as ac, fallbackLabel as ad, findSwapRoute as ae, formatAssetAmount as af, formatSui as ag, formatUsd as ah, getDecimals as ai, getDecimalsForCoinType as aj, mapMoveAbortCode as ak, mapWalletError as al, mistToSui as am, parseSuiRpcTx as an, payWithMpp as ao, preflightFail as ap, preflightPay as aq, preflightSend as ar, preflightSwap as as, rawToStable as at, rawToUsdc as au, refineLendingLabel as av, resolveSymbol as aw, resolveTokenType as ax, stableToRaw as ay, suiToMist as az, type ClassifyBalanceChange as b, getSuiClient as b0, getSuiGrpcClient as b1, isAllowedAsset as b2, isCetusRouteFresh as b3, isInRegistry as b4, normalizeAsset as b5, normalizeCoinType as b6, queryHistory as b7, queryTransaction as b8, selectAndSplitCoin as b9, selectSuiCoin as ba, serializeCetusRoute as bb, simulateTransaction as bc, throwIfSimulationFailed as bd, verifyCetusRouteCoinMatch as be, type ClassifyResult as c, type CoinMeta as d, type DepositInfo as e, type ExtractedTransfer as f, KeypairSigner as g, LOFI_TYPE as h, MIST_PER_SUI as i, type OverlayFeeConfig as j, PREFLIGHT_OK as k, type PayOptions as l, type PayResult as m, type PreflightResult as n, SUI_DECIMALS as o, SUI_TYPE as p, SUPPORTED_ASSETS as q, type SendResult as r, type SimulationResult as s, type StableAsset as t, type SuiHolding as u, type SuiRpcTxBlock as v, type SupportedAsset as w, type SwapRouteResult as x, type T2000ErrorCode as y, type T2000ErrorData as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/sdk",
-  "version": "5.5.1",
+  "version": "5.6.0",
   "description": "TypeScript SDK for Agent Wallets on Sui — gasless USDC + USDsui transfers, Cetus swap routing, NAVI lending (programmatic), MPP paid API access, zkLogin compatible.",
   "type": "module",
   "main": "./dist/index.cjs",