@t2000/sdk 4.2.1 → 4.3.0

package/dist/{types-BTbqE8AE.d.ts → types-CFV4VcJJ.d.cts}

@@ -1,8 +1,8 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-import { SuiGrpcClient } from '@mysten/sui/grpc';
-import { T as TransactionLeg, k as TransactionRecord } from './types-DUmk5ivZ.js';
+import { P as PayOptions, d as PayResult, T as TransactionLeg, k as TransactionRecord } from './types-Ch0zVUpC.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -61,13 +61,111 @@ declare class ZkLoginSigner implements TransactionSigner {
     signTransaction(txBytes: Uint8Array): Promise<{
         signature: string;
     }>;
-    signPersonalMessage(_messageBytes: Uint8Array): Promise<{
+    signPersonalMessage(messageBytes: Uint8Array): Promise<{
         signature: string;
         bytes: string;
     }>;
     isExpired(currentEpoch: number): boolean;
 }
 
+/**
+ * Unified token registry — single source of truth for coin types, decimals, symbols, and tiers.
+ *
+ * ZERO heavy dependencies. Safe to import from any context (server, browser, Edge).
+ *
+ * Tier 1: USDC — the financial layer (save, borrow, receive, yield, allowances, marketplace, MPP).
+ * Tier 2: 15 curated swap assets — hold, trade, and send only.
+ * No tier: Legacy tokens kept for display accuracy (existing NAVI positions). No new operations.
+ *
+ * To add a new token: add ONE entry to COIN_REGISTRY below. Everything else derives from it.
+ * Gate for Tier 2 addition: confirmed deep Cetus liquidity + clear user need.
+ */
+interface CoinMeta {
+    type: string;
+    decimals: number;
+    symbol: string;
+    tier?: 1 | 2;
+}
+/**
+ * Canonical coin registry.
+ * Key = user-friendly name (used in swap_execute, CLI, prompts).
+ */
+declare const COIN_REGISTRY: Record<string, CoinMeta>;
+/**
+ * Returns the registry metadata for a coin type, or `undefined` if the coin
+ * is not in the registry. Use this when you need to distinguish "known coin"
+ * from "supported coin" — `isSupported` only flags tiered (active) coins,
+ * but legacy coins like USDsui / USDe / USDT are in the registry without a
+ * tier and still need canonical-symbol resolution.
+ */
+declare function getCoinMeta(coinType: string): CoinMeta | undefined;
+/**
+ * Returns true if the coin type appears anywhere in COIN_REGISTRY (tier 1, 2,
+ * OR legacy/no-tier). Different from `isSupported`, which excludes legacy
+ * entries. The blockvision-prices canonical-symbol gate uses this looser
+ * check so that USDsui (legacy/no-tier today, but with a registry-canonical
+ * mixed-case symbol) still wins over BlockVision's uppercase 'USDSUI'.
+ */
+declare function isInRegistry(coinType: string): boolean;
+/** Returns true if the coin type is Tier 1 (USDC — the financial layer). */
+declare function isTier1(coinType: string): boolean;
+/** Returns true if the coin type is Tier 2 (curated swap asset). */
+declare function isTier2(coinType: string): boolean;
+/** Returns true if the coin type is actively supported (Tier 1 or Tier 2). */
+declare function isSupported(coinType: string): boolean;
+/** Returns the tier for a coin type, or undefined if legacy/unknown. */
+declare function getTier(coinType: string): 1 | 2 | undefined;
+/**
+ * Get decimals for any coin type. Checks full type match, then suffix match, then defaults to 9.
+ * Works for both tiered and legacy tokens.
+ */
+declare function getDecimalsForCoinType(coinType: string): number;
+/**
+ * Resolve a full coin type to a user-friendly symbol.
+ * Returns the last `::` segment if not in the registry.
+ */
+declare function resolveSymbol(coinType: string): string;
+/**
+ * Name → type map for swap resolution. Derived from COIN_REGISTRY.
+ * Contains BOTH original-case and UPPERCASE keys for case-insensitive lookup.
+ */
+declare const TOKEN_MAP: Record<string, string>;
+/**
+ * Resolve a user-friendly token name to its full coin type.
+ * Returns the input unchanged if already a full coin type (contains "::").
+ * Case-insensitive: 'usde', 'USDe', 'USDE' all resolve correctly.
+ */
+declare function resolveTokenType(nameOrType: string): string | null;
+/** Common type constants for direct import. */
+declare const SUI_TYPE: string;
+declare const USDC_TYPE: string;
+declare const USDT_TYPE: string;
+declare const USDSUI_TYPE: string;
+declare const USDE_TYPE: string;
+declare const ETH_TYPE: string;
+declare const WBTC_TYPE: string;
+declare const WAL_TYPE: string;
+declare const NAVX_TYPE: string;
+declare const IKA_TYPE: string;
+declare const LOFI_TYPE: string;
+declare const MANIFEST_TYPE: string;
+
+declare function payWithMpp(args: {
+    signer: TransactionSigner;
+    client: SuiJsonRpcClient;
+    options: PayOptions;
+}): Promise<PayResult>;
+
+type SuiTransactionEffects = NonNullable<Awaited<ReturnType<SuiJsonRpcClient['executeTransactionBlock']>>['effects']>;
+type BuildClient = NonNullable<Parameters<Transaction['build']>[0]>['client'];
+declare function executeTx(client: SuiJsonRpcClient, signer: TransactionSigner, buildTx: () => Promise<Transaction> | Transaction, options?: {
+    buildClient?: BuildClient;
+}): Promise<{
+    digest: string;
+    gasCostSui: number;
+    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' | 'HEALTH_FACTOR_TOO_LOW' | 'WITHDRAW_WOULD_LIQUIDATE' | 'WITHDRAW_FAILED' | 'NO_COLLATERAL' | 'PROTOCOL_PAUSED' | '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;
@@ -246,88 +344,6 @@ declare function truncateAddress(address: string): string;
  */
 declare function normalizeCoinType(coinType: string): string;
 
-/**
- * Unified token registry — single source of truth for coin types, decimals, symbols, and tiers.
- *
- * ZERO heavy dependencies. Safe to import from any context (server, browser, Edge).
- *
- * Tier 1: USDC — the financial layer (save, borrow, receive, yield, allowances, marketplace, MPP).
- * Tier 2: 15 curated swap assets — hold, trade, and send only.
- * No tier: Legacy tokens kept for display accuracy (existing NAVI positions). No new operations.
- *
- * To add a new token: add ONE entry to COIN_REGISTRY below. Everything else derives from it.
- * Gate for Tier 2 addition: confirmed deep Cetus liquidity + clear user need.
- */
-interface CoinMeta {
-    type: string;
-    decimals: number;
-    symbol: string;
-    tier?: 1 | 2;
-}
-/**
- * Canonical coin registry.
- * Key = user-friendly name (used in swap_execute, CLI, prompts).
- */
-declare const COIN_REGISTRY: Record<string, CoinMeta>;
-/**
- * Returns the registry metadata for a coin type, or `undefined` if the coin
- * is not in the registry. Use this when you need to distinguish "known coin"
- * from "supported coin" — `isSupported` only flags tiered (active) coins,
- * but legacy coins like USDsui / USDe / USDT are in the registry without a
- * tier and still need canonical-symbol resolution.
- */
-declare function getCoinMeta(coinType: string): CoinMeta | undefined;
-/**
- * Returns true if the coin type appears anywhere in COIN_REGISTRY (tier 1, 2,
- * OR legacy/no-tier). Different from `isSupported`, which excludes legacy
- * entries. The blockvision-prices canonical-symbol gate uses this looser
- * check so that USDsui (legacy/no-tier today, but with a registry-canonical
- * mixed-case symbol) still wins over BlockVision's uppercase 'USDSUI'.
- */
-declare function isInRegistry(coinType: string): boolean;
-/** Returns true if the coin type is Tier 1 (USDC — the financial layer). */
-declare function isTier1(coinType: string): boolean;
-/** Returns true if the coin type is Tier 2 (curated swap asset). */
-declare function isTier2(coinType: string): boolean;
-/** Returns true if the coin type is actively supported (Tier 1 or Tier 2). */
-declare function isSupported(coinType: string): boolean;
-/** Returns the tier for a coin type, or undefined if legacy/unknown. */
-declare function getTier(coinType: string): 1 | 2 | undefined;
-/**
- * Get decimals for any coin type. Checks full type match, then suffix match, then defaults to 9.
- * Works for both tiered and legacy tokens.
- */
-declare function getDecimalsForCoinType(coinType: string): number;
-/**
- * Resolve a full coin type to a user-friendly symbol.
- * Returns the last `::` segment if not in the registry.
- */
-declare function resolveSymbol(coinType: string): string;
-/**
- * Name → type map for swap resolution. Derived from COIN_REGISTRY.
- * Contains BOTH original-case and UPPERCASE keys for case-insensitive lookup.
- */
-declare const TOKEN_MAP: Record<string, string>;
-/**
- * Resolve a user-friendly token name to its full coin type.
- * Returns the input unchanged if already a full coin type (contains "::").
- * Case-insensitive: 'usde', 'USDe', 'USDE' all resolve correctly.
- */
-declare function resolveTokenType(nameOrType: string): string | null;
-/** Common type constants for direct import. */
-declare const SUI_TYPE: string;
-declare const USDC_TYPE: string;
-declare const USDT_TYPE: string;
-declare const USDSUI_TYPE: string;
-declare const USDE_TYPE: string;
-declare const ETH_TYPE: string;
-declare const WBTC_TYPE: string;
-declare const WAL_TYPE: string;
-declare const NAVX_TYPE: string;
-declare const IKA_TYPE: string;
-declare const LOFI_TYPE: string;
-declare const MANIFEST_TYPE: string;
-
 /**
  * Shared transaction classifier.
  *
@@ -648,4 +664,4 @@ interface TxMetadata {
 declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
 declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
 
-export { ZkLoginSigner 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 TransactionSigner as H, IKA_TYPE as I, type TxDirection 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, type TxMetadata as Q, USDC_TYPE as R, SAVE_FEE_BPS as S, T2000Error as T, USDC_DECIMALS as U, USDE_TYPE as V, USDSUI_TYPE as W, USDT_TYPE as X, WAL_TYPE as Y, WBTC_TYPE as Z, type ZkLoginProof as _, BPS_DENOMINATOR as a, addFeeTransfer as a0, calculateFee as a1, classifyAction as a2, classifyLabel as a3, classifyTransaction as a4, extractAllUserLegs as a5, extractTransferDetails as a6, extractTxCommands as a7, extractTxSender as a8, fallbackLabel as a9, GASLESS_MIN_STABLE_AMOUNT as aA, GASLESS_STABLE_TYPES as aB, OPERATION_ASSETS as aC, type Operation as aD, SAVEABLE_ASSETS as aE, SENDABLE_ASSETS as aF, type SaveableAsset as aG, assertAllowedAsset as aH, createSuiClient as aI, getCoinMeta as aJ, getSuiClient as aK, getSuiGrpcClient as aL, isAllowedAsset as aM, isInRegistry as aN, normalizeAsset as aO, normalizeCoinType as aP, queryHistory as aQ, queryTransaction as aR, simulateTransaction as aS, throwIfSimulationFailed as aT, formatAssetAmount as aa, formatSui as ab, formatUsd as ac, getDecimals as ad, getDecimalsForCoinType as ae, getTier as af, isSupported as ag, isTier1 as ah, isTier2 as ai, mapMoveAbortCode as aj, mapWalletError as ak, mistToSui as al, parseSuiRpcTx as am, rawToStable as an, rawToUsdc as ao, refineLendingLabel as ap, resolveSymbol as aq, resolveTokenType as ar, stableToRaw as as, suiToMist as at, truncateAddress as au, usdcToRaw as av, validateAddress as aw, type SendableAsset as ax, CETUS_USDC_SUI_POOL as ay, DEFAULT_GRPC_URL 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, STABLE_ASSETS as k, SUI_DECIMALS as l, SUI_TYPE as m, SUPPORTED_ASSETS as n, type SafeguardConfig as o, SafeguardError as p, type SafeguardErrorDetails as q, type SafeguardRule as r, type SimulationResult as s, type StableAsset as t, type SuiRpcTxBlock as u, type SupportedAsset as v, type T2000ErrorCode as w, type T2000ErrorData as x, T2000_OVERLAY_FEE_WALLET as y, TOKEN_MAP as z };
+export { ZkLoginSigner 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 TransactionSigner as H, IKA_TYPE as I, type TxDirection 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, type TxMetadata as Q, USDC_TYPE as R, SAVE_FEE_BPS as S, T2000Error as T, USDC_DECIMALS as U, USDE_TYPE as V, USDSUI_TYPE as W, USDT_TYPE as X, WAL_TYPE as Y, WBTC_TYPE as Z, type ZkLoginProof as _, BPS_DENOMINATOR as a, addFeeTransfer as a0, calculateFee as a1, classifyAction as a2, classifyLabel as a3, classifyTransaction as a4, executeTx as a5, extractAllUserLegs as a6, extractTransferDetails as a7, extractTxCommands as a8, extractTxSender as a9, CETUS_USDC_SUI_POOL as aA, DEFAULT_GRPC_URL as aB, GASLESS_MIN_STABLE_AMOUNT as aC, GASLESS_STABLE_TYPES as aD, OPERATION_ASSETS as aE, type Operation as aF, SAVEABLE_ASSETS as aG, SENDABLE_ASSETS as aH, type SaveableAsset as aI, assertAllowedAsset as aJ, createSuiClient as aK, getCoinMeta as aL, getSuiClient as aM, getSuiGrpcClient as aN, isAllowedAsset as aO, isInRegistry as aP, normalizeAsset as aQ, normalizeCoinType as aR, queryHistory as aS, queryTransaction as aT, simulateTransaction as aU, throwIfSimulationFailed as aV, fallbackLabel as aa, formatAssetAmount as ab, formatSui as ac, formatUsd as ad, getDecimals as ae, getDecimalsForCoinType as af, getTier as ag, isSupported as ah, isTier1 as ai, isTier2 as aj, mapMoveAbortCode as ak, mapWalletError as al, mistToSui as am, parseSuiRpcTx as an, payWithMpp as ao, rawToStable as ap, rawToUsdc as aq, refineLendingLabel as ar, resolveSymbol as as, resolveTokenType as at, stableToRaw as au, suiToMist as av, truncateAddress as aw, usdcToRaw as ax, validateAddress as ay, type SendableAsset 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, STABLE_ASSETS as k, SUI_DECIMALS as l, SUI_TYPE as m, SUPPORTED_ASSETS as n, type SafeguardConfig as o, SafeguardError as p, type SafeguardErrorDetails as q, type SafeguardRule as r, type SimulationResult as s, type StableAsset as t, type SuiRpcTxBlock as u, type SupportedAsset as v, type T2000ErrorCode as w, type T2000ErrorData as x, T2000_OVERLAY_FEE_WALLET as y, TOKEN_MAP as z };

package/dist/{types-DUmk5ivZ.d.cts → types-Ch0zVUpC.d.cts}

@@ -92,6 +92,7 @@ interface SelectAndSplitResult {
 declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, coinType: string, amount: bigint | 'all', options?: {
     allowSwapAll?: boolean;
     sponsoredContext?: boolean;
+    mergeCache?: SponsoredCoinMergeCache;
 }): Promise<SelectAndSplitResult>;
 /**
  * Coin-object-only selection for sponsored (Enoki) transactions. Fetches the
@@ -114,14 +115,20 @@ declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, o
  * `primary` instead of re-fetching + re-merging.
  *
  * Why this exists (S.xxx, 2026-06-02): a sponsored bundle with 2+ legs
- * sourcing the same coin (e.g. `SUI→WAL` + `SUI→DEEP`) called
- * `selectCoinObjectsOnly` once per leg. Each call emitted its own
- * `mergeCoins` over the SAME coin objects, so the second leg's merge
- * referenced coins the first leg already consumed → Enoki dry-run failed
- * with `CommandArgumentError { ArgumentWithoutValue }`. Non-SUI legs dodge
- * this because they go through `coinWithBalance`, whose resolver batches
- * all intents for one coin type into a single build-time merge. The SUI
- * sponsored path has no such batching, so the cache supplies it.
+ * sourcing the same coin (e.g. `SUI→WAL` + `SUI→DEEP`, or `swap USDC` +
+ * `save USDC`) called `selectCoinObjectsOnly` once per leg. Each call
+ * emitted its own `mergeCoins` over the SAME coin objects, so the second
+ * leg's merge referenced coins the first leg already consumed → Enoki
+ * dry-run failed with `CommandArgumentError { ArgumentWithoutValue }`.
+ *
+ * This is NOT SUI-specific. Under sponsorship, `selectAndSplitCoin` routes
+ * EVERY asset through `selectCoinObjectsOnly` (the `coinWithBalance`
+ * batching that would otherwise dedup these merges only runs for
+ * non-sponsored CLI/direct flows — its address-balance `FundsWithdrawal`
+ * reservation is what Enoki can't deserialize, issue #93). So the cache is
+ * the dedup layer for ALL coin types in a sponsored multi-leg PTB, keyed
+ * by coin type. SUI was simply the first asset observed failing in the
+ * wild because it's the most common swap source.
  */
 type SponsoredCoinMergeCache = Map<string, {
     primary: TransactionObjectArgument;
@@ -395,14 +402,16 @@ declare function addSwapToTx(tx: Transaction, client: SuiJsonRpcClient, address:
      */
     sponsoredContext?: boolean;
     /**
-     * Per-PTB merge cache for sponsored SUI sourcing. Provided by
-     * `composeTx`'s orchestration loop so multiple SUI-source legs in one
-     * bundle share a single merged primary coin instead of each emitting
-     * its own `mergeCoins` (the second of which references already-consumed
-     * coins → Enoki dry-run `ArgumentWithoutValue`). Single swaps / non-SUI
-     * sources don't need it; omit. See `SponsoredCoinMergeCache` JSDoc.
+     * Per-PTB merge cache for sponsored coin-object sourcing (any coin
+     * type — SUI in the dedicated branch, USDC/USDsui/etc. in the wallet
+     * branch). Provided by `composeTx`'s orchestration loop so multiple
+     * legs sourcing the same coin in one bundle share a single merged
+     * primary coin instead of each emitting its own `mergeCoins` (the
+     * second of which references already-consumed coins → Enoki dry-run
+     * `ArgumentWithoutValue`). Single swaps don't need it; omit. See
+     * `SponsoredCoinMergeCache` JSDoc.
      */
-    suiMergeCache?: SponsoredCoinMergeCache;
+    coinMergeCache?: SponsoredCoinMergeCache;
 }): Promise<{
     coin: TransactionObjectArgument;
     effectiveAmountIn: number;

package/dist/{types-DUmk5ivZ.d.ts → types-Ch0zVUpC.d.ts}

@@ -92,6 +92,7 @@ interface SelectAndSplitResult {
 declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, owner: string, coinType: string, amount: bigint | 'all', options?: {
     allowSwapAll?: boolean;
     sponsoredContext?: boolean;
+    mergeCache?: SponsoredCoinMergeCache;
 }): Promise<SelectAndSplitResult>;
 /**
  * Coin-object-only selection for sponsored (Enoki) transactions. Fetches the
@@ -114,14 +115,20 @@ declare function selectAndSplitCoin(tx: Transaction, client: SuiJsonRpcClient, o
  * `primary` instead of re-fetching + re-merging.
  *
  * Why this exists (S.xxx, 2026-06-02): a sponsored bundle with 2+ legs
- * sourcing the same coin (e.g. `SUI→WAL` + `SUI→DEEP`) called
- * `selectCoinObjectsOnly` once per leg. Each call emitted its own
- * `mergeCoins` over the SAME coin objects, so the second leg's merge
- * referenced coins the first leg already consumed → Enoki dry-run failed
- * with `CommandArgumentError { ArgumentWithoutValue }`. Non-SUI legs dodge
- * this because they go through `coinWithBalance`, whose resolver batches
- * all intents for one coin type into a single build-time merge. The SUI
- * sponsored path has no such batching, so the cache supplies it.
+ * sourcing the same coin (e.g. `SUI→WAL` + `SUI→DEEP`, or `swap USDC` +
+ * `save USDC`) called `selectCoinObjectsOnly` once per leg. Each call
+ * emitted its own `mergeCoins` over the SAME coin objects, so the second
+ * leg's merge referenced coins the first leg already consumed → Enoki
+ * dry-run failed with `CommandArgumentError { ArgumentWithoutValue }`.
+ *
+ * This is NOT SUI-specific. Under sponsorship, `selectAndSplitCoin` routes
+ * EVERY asset through `selectCoinObjectsOnly` (the `coinWithBalance`
+ * batching that would otherwise dedup these merges only runs for
+ * non-sponsored CLI/direct flows — its address-balance `FundsWithdrawal`
+ * reservation is what Enoki can't deserialize, issue #93). So the cache is
+ * the dedup layer for ALL coin types in a sponsored multi-leg PTB, keyed
+ * by coin type. SUI was simply the first asset observed failing in the
+ * wild because it's the most common swap source.
  */
 type SponsoredCoinMergeCache = Map<string, {
     primary: TransactionObjectArgument;
@@ -395,14 +402,16 @@ declare function addSwapToTx(tx: Transaction, client: SuiJsonRpcClient, address:
      */
     sponsoredContext?: boolean;
     /**
-     * Per-PTB merge cache for sponsored SUI sourcing. Provided by
-     * `composeTx`'s orchestration loop so multiple SUI-source legs in one
-     * bundle share a single merged primary coin instead of each emitting
-     * its own `mergeCoins` (the second of which references already-consumed
-     * coins → Enoki dry-run `ArgumentWithoutValue`). Single swaps / non-SUI
-     * sources don't need it; omit. See `SponsoredCoinMergeCache` JSDoc.
+     * Per-PTB merge cache for sponsored coin-object sourcing (any coin
+     * type — SUI in the dedicated branch, USDC/USDsui/etc. in the wallet
+     * branch). Provided by `composeTx`'s orchestration loop so multiple
+     * legs sourcing the same coin in one bundle share a single merged
+     * primary coin instead of each emitting its own `mergeCoins` (the
+     * second of which references already-consumed coins → Enoki dry-run
+     * `ArgumentWithoutValue`). Single swaps don't need it; omit. See
+     * `SponsoredCoinMergeCache` JSDoc.
      */
-    suiMergeCache?: SponsoredCoinMergeCache;
+    coinMergeCache?: SponsoredCoinMergeCache;
 }): Promise<{
     coin: TransactionObjectArgument;
     effectiveAmountIn: number;

package/dist/{types-8CNP74n6.d.cts → types-DqRLGfOC.d.ts}

@@ -1,8 +1,8 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-import { SuiGrpcClient } from '@mysten/sui/grpc';
-import { T as TransactionLeg, k as TransactionRecord } from './types-DUmk5ivZ.cjs';
+import { P as PayOptions, d as PayResult, T as TransactionLeg, k as TransactionRecord } from './types-Ch0zVUpC.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 
 /**
  * Abstract signing interface that decouples the SDK from any specific
@@ -61,13 +61,111 @@ declare class ZkLoginSigner implements TransactionSigner {
     signTransaction(txBytes: Uint8Array): Promise<{
         signature: string;
     }>;
-    signPersonalMessage(_messageBytes: Uint8Array): Promise<{
+    signPersonalMessage(messageBytes: Uint8Array): Promise<{
         signature: string;
         bytes: string;
     }>;
     isExpired(currentEpoch: number): boolean;
 }
 
+/**
+ * Unified token registry — single source of truth for coin types, decimals, symbols, and tiers.
+ *
+ * ZERO heavy dependencies. Safe to import from any context (server, browser, Edge).
+ *
+ * Tier 1: USDC — the financial layer (save, borrow, receive, yield, allowances, marketplace, MPP).
+ * Tier 2: 15 curated swap assets — hold, trade, and send only.
+ * No tier: Legacy tokens kept for display accuracy (existing NAVI positions). No new operations.
+ *
+ * To add a new token: add ONE entry to COIN_REGISTRY below. Everything else derives from it.
+ * Gate for Tier 2 addition: confirmed deep Cetus liquidity + clear user need.
+ */
+interface CoinMeta {
+    type: string;
+    decimals: number;
+    symbol: string;
+    tier?: 1 | 2;
+}
+/**
+ * Canonical coin registry.
+ * Key = user-friendly name (used in swap_execute, CLI, prompts).
+ */
+declare const COIN_REGISTRY: Record<string, CoinMeta>;
+/**
+ * Returns the registry metadata for a coin type, or `undefined` if the coin
+ * is not in the registry. Use this when you need to distinguish "known coin"
+ * from "supported coin" — `isSupported` only flags tiered (active) coins,
+ * but legacy coins like USDsui / USDe / USDT are in the registry without a
+ * tier and still need canonical-symbol resolution.
+ */
+declare function getCoinMeta(coinType: string): CoinMeta | undefined;
+/**
+ * Returns true if the coin type appears anywhere in COIN_REGISTRY (tier 1, 2,
+ * OR legacy/no-tier). Different from `isSupported`, which excludes legacy
+ * entries. The blockvision-prices canonical-symbol gate uses this looser
+ * check so that USDsui (legacy/no-tier today, but with a registry-canonical
+ * mixed-case symbol) still wins over BlockVision's uppercase 'USDSUI'.
+ */
+declare function isInRegistry(coinType: string): boolean;
+/** Returns true if the coin type is Tier 1 (USDC — the financial layer). */
+declare function isTier1(coinType: string): boolean;
+/** Returns true if the coin type is Tier 2 (curated swap asset). */
+declare function isTier2(coinType: string): boolean;
+/** Returns true if the coin type is actively supported (Tier 1 or Tier 2). */
+declare function isSupported(coinType: string): boolean;
+/** Returns the tier for a coin type, or undefined if legacy/unknown. */
+declare function getTier(coinType: string): 1 | 2 | undefined;
+/**
+ * Get decimals for any coin type. Checks full type match, then suffix match, then defaults to 9.
+ * Works for both tiered and legacy tokens.
+ */
+declare function getDecimalsForCoinType(coinType: string): number;
+/**
+ * Resolve a full coin type to a user-friendly symbol.
+ * Returns the last `::` segment if not in the registry.
+ */
+declare function resolveSymbol(coinType: string): string;
+/**
+ * Name → type map for swap resolution. Derived from COIN_REGISTRY.
+ * Contains BOTH original-case and UPPERCASE keys for case-insensitive lookup.
+ */
+declare const TOKEN_MAP: Record<string, string>;
+/**
+ * Resolve a user-friendly token name to its full coin type.
+ * Returns the input unchanged if already a full coin type (contains "::").
+ * Case-insensitive: 'usde', 'USDe', 'USDE' all resolve correctly.
+ */
+declare function resolveTokenType(nameOrType: string): string | null;
+/** Common type constants for direct import. */
+declare const SUI_TYPE: string;
+declare const USDC_TYPE: string;
+declare const USDT_TYPE: string;
+declare const USDSUI_TYPE: string;
+declare const USDE_TYPE: string;
+declare const ETH_TYPE: string;
+declare const WBTC_TYPE: string;
+declare const WAL_TYPE: string;
+declare const NAVX_TYPE: string;
+declare const IKA_TYPE: string;
+declare const LOFI_TYPE: string;
+declare const MANIFEST_TYPE: string;
+
+declare function payWithMpp(args: {
+    signer: TransactionSigner;
+    client: SuiJsonRpcClient;
+    options: PayOptions;
+}): Promise<PayResult>;
+
+type SuiTransactionEffects = NonNullable<Awaited<ReturnType<SuiJsonRpcClient['executeTransactionBlock']>>['effects']>;
+type BuildClient = NonNullable<Parameters<Transaction['build']>[0]>['client'];
+declare function executeTx(client: SuiJsonRpcClient, signer: TransactionSigner, buildTx: () => Promise<Transaction> | Transaction, options?: {
+    buildClient?: BuildClient;
+}): Promise<{
+    digest: string;
+    gasCostSui: number;
+    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' | 'HEALTH_FACTOR_TOO_LOW' | 'WITHDRAW_WOULD_LIQUIDATE' | 'WITHDRAW_FAILED' | 'NO_COLLATERAL' | 'PROTOCOL_PAUSED' | '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;
@@ -246,88 +344,6 @@ declare function truncateAddress(address: string): string;
  */
 declare function normalizeCoinType(coinType: string): string;
 
-/**
- * Unified token registry — single source of truth for coin types, decimals, symbols, and tiers.
- *
- * ZERO heavy dependencies. Safe to import from any context (server, browser, Edge).
- *
- * Tier 1: USDC — the financial layer (save, borrow, receive, yield, allowances, marketplace, MPP).
- * Tier 2: 15 curated swap assets — hold, trade, and send only.
- * No tier: Legacy tokens kept for display accuracy (existing NAVI positions). No new operations.
- *
- * To add a new token: add ONE entry to COIN_REGISTRY below. Everything else derives from it.
- * Gate for Tier 2 addition: confirmed deep Cetus liquidity + clear user need.
- */
-interface CoinMeta {
-    type: string;
-    decimals: number;
-    symbol: string;
-    tier?: 1 | 2;
-}
-/**
- * Canonical coin registry.
- * Key = user-friendly name (used in swap_execute, CLI, prompts).
- */
-declare const COIN_REGISTRY: Record<string, CoinMeta>;
-/**
- * Returns the registry metadata for a coin type, or `undefined` if the coin
- * is not in the registry. Use this when you need to distinguish "known coin"
- * from "supported coin" — `isSupported` only flags tiered (active) coins,
- * but legacy coins like USDsui / USDe / USDT are in the registry without a
- * tier and still need canonical-symbol resolution.
- */
-declare function getCoinMeta(coinType: string): CoinMeta | undefined;
-/**
- * Returns true if the coin type appears anywhere in COIN_REGISTRY (tier 1, 2,
- * OR legacy/no-tier). Different from `isSupported`, which excludes legacy
- * entries. The blockvision-prices canonical-symbol gate uses this looser
- * check so that USDsui (legacy/no-tier today, but with a registry-canonical
- * mixed-case symbol) still wins over BlockVision's uppercase 'USDSUI'.
- */
-declare function isInRegistry(coinType: string): boolean;
-/** Returns true if the coin type is Tier 1 (USDC — the financial layer). */
-declare function isTier1(coinType: string): boolean;
-/** Returns true if the coin type is Tier 2 (curated swap asset). */
-declare function isTier2(coinType: string): boolean;
-/** Returns true if the coin type is actively supported (Tier 1 or Tier 2). */
-declare function isSupported(coinType: string): boolean;
-/** Returns the tier for a coin type, or undefined if legacy/unknown. */
-declare function getTier(coinType: string): 1 | 2 | undefined;
-/**
- * Get decimals for any coin type. Checks full type match, then suffix match, then defaults to 9.
- * Works for both tiered and legacy tokens.
- */
-declare function getDecimalsForCoinType(coinType: string): number;
-/**
- * Resolve a full coin type to a user-friendly symbol.
- * Returns the last `::` segment if not in the registry.
- */
-declare function resolveSymbol(coinType: string): string;
-/**
- * Name → type map for swap resolution. Derived from COIN_REGISTRY.
- * Contains BOTH original-case and UPPERCASE keys for case-insensitive lookup.
- */
-declare const TOKEN_MAP: Record<string, string>;
-/**
- * Resolve a user-friendly token name to its full coin type.
- * Returns the input unchanged if already a full coin type (contains "::").
- * Case-insensitive: 'usde', 'USDe', 'USDE' all resolve correctly.
- */
-declare function resolveTokenType(nameOrType: string): string | null;
-/** Common type constants for direct import. */
-declare const SUI_TYPE: string;
-declare const USDC_TYPE: string;
-declare const USDT_TYPE: string;
-declare const USDSUI_TYPE: string;
-declare const USDE_TYPE: string;
-declare const ETH_TYPE: string;
-declare const WBTC_TYPE: string;
-declare const WAL_TYPE: string;
-declare const NAVX_TYPE: string;
-declare const IKA_TYPE: string;
-declare const LOFI_TYPE: string;
-declare const MANIFEST_TYPE: string;
-
 /**
  * Shared transaction classifier.
  *
@@ -648,4 +664,4 @@ interface TxMetadata {
 declare const OUTBOUND_OPS: Set<"save" | "borrow" | "withdraw" | "repay" | "send" | "pay">;
 declare const DEFAULT_SAFEGUARD_CONFIG: SafeguardConfig;
 
-export { ZkLoginSigner 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 TransactionSigner as H, IKA_TYPE as I, type TxDirection 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, type TxMetadata as Q, USDC_TYPE as R, SAVE_FEE_BPS as S, T2000Error as T, USDC_DECIMALS as U, USDE_TYPE as V, USDSUI_TYPE as W, USDT_TYPE as X, WAL_TYPE as Y, WBTC_TYPE as Z, type ZkLoginProof as _, BPS_DENOMINATOR as a, addFeeTransfer as a0, calculateFee as a1, classifyAction as a2, classifyLabel as a3, classifyTransaction as a4, extractAllUserLegs as a5, extractTransferDetails as a6, extractTxCommands as a7, extractTxSender as a8, fallbackLabel as a9, GASLESS_MIN_STABLE_AMOUNT as aA, GASLESS_STABLE_TYPES as aB, OPERATION_ASSETS as aC, type Operation as aD, SAVEABLE_ASSETS as aE, SENDABLE_ASSETS as aF, type SaveableAsset as aG, assertAllowedAsset as aH, createSuiClient as aI, getCoinMeta as aJ, getSuiClient as aK, getSuiGrpcClient as aL, isAllowedAsset as aM, isInRegistry as aN, normalizeAsset as aO, normalizeCoinType as aP, queryHistory as aQ, queryTransaction as aR, simulateTransaction as aS, throwIfSimulationFailed as aT, formatAssetAmount as aa, formatSui as ab, formatUsd as ac, getDecimals as ad, getDecimalsForCoinType as ae, getTier as af, isSupported as ag, isTier1 as ah, isTier2 as ai, mapMoveAbortCode as aj, mapWalletError as ak, mistToSui as al, parseSuiRpcTx as am, rawToStable as an, rawToUsdc as ao, refineLendingLabel as ap, resolveSymbol as aq, resolveTokenType as ar, stableToRaw as as, suiToMist as at, truncateAddress as au, usdcToRaw as av, validateAddress as aw, type SendableAsset as ax, CETUS_USDC_SUI_POOL as ay, DEFAULT_GRPC_URL 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, STABLE_ASSETS as k, SUI_DECIMALS as l, SUI_TYPE as m, SUPPORTED_ASSETS as n, type SafeguardConfig as o, SafeguardError as p, type SafeguardErrorDetails as q, type SafeguardRule as r, type SimulationResult as s, type StableAsset as t, type SuiRpcTxBlock as u, type SupportedAsset as v, type T2000ErrorCode as w, type T2000ErrorData as x, T2000_OVERLAY_FEE_WALLET as y, TOKEN_MAP as z };
+export { ZkLoginSigner 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 TransactionSigner as H, IKA_TYPE as I, type TxDirection 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, type TxMetadata as Q, USDC_TYPE as R, SAVE_FEE_BPS as S, T2000Error as T, USDC_DECIMALS as U, USDE_TYPE as V, USDSUI_TYPE as W, USDT_TYPE as X, WAL_TYPE as Y, WBTC_TYPE as Z, type ZkLoginProof as _, BPS_DENOMINATOR as a, addFeeTransfer as a0, calculateFee as a1, classifyAction as a2, classifyLabel as a3, classifyTransaction as a4, executeTx as a5, extractAllUserLegs as a6, extractTransferDetails as a7, extractTxCommands as a8, extractTxSender as a9, CETUS_USDC_SUI_POOL as aA, DEFAULT_GRPC_URL as aB, GASLESS_MIN_STABLE_AMOUNT as aC, GASLESS_STABLE_TYPES as aD, OPERATION_ASSETS as aE, type Operation as aF, SAVEABLE_ASSETS as aG, SENDABLE_ASSETS as aH, type SaveableAsset as aI, assertAllowedAsset as aJ, createSuiClient as aK, getCoinMeta as aL, getSuiClient as aM, getSuiGrpcClient as aN, isAllowedAsset as aO, isInRegistry as aP, normalizeAsset as aQ, normalizeCoinType as aR, queryHistory as aS, queryTransaction as aT, simulateTransaction as aU, throwIfSimulationFailed as aV, fallbackLabel as aa, formatAssetAmount as ab, formatSui as ac, formatUsd as ad, getDecimals as ae, getDecimalsForCoinType as af, getTier as ag, isSupported as ah, isTier1 as ai, isTier2 as aj, mapMoveAbortCode as ak, mapWalletError as al, mistToSui as am, parseSuiRpcTx as an, payWithMpp as ao, rawToStable as ap, rawToUsdc as aq, refineLendingLabel as ar, resolveSymbol as as, resolveTokenType as at, stableToRaw as au, suiToMist as av, truncateAddress as aw, usdcToRaw as ax, validateAddress as ay, type SendableAsset 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, STABLE_ASSETS as k, SUI_DECIMALS as l, SUI_TYPE as m, SUPPORTED_ASSETS as n, type SafeguardConfig as o, SafeguardError as p, type SafeguardErrorDetails as q, type SafeguardRule as r, type SimulationResult as s, type StableAsset as t, type SuiRpcTxBlock as u, type SupportedAsset as v, type T2000ErrorCode as w, type T2000ErrorData as x, T2000_OVERLAY_FEE_WALLET as y, TOKEN_MAP as z };

package/package.json

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