@t2000/sdk 3.2.0 → 4.0.0

package/dist/{types-BmgPRlnq.d.ts → types-CqpN8a8R.d.cts}

@@ -1,6 +1,7 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-import { T as TransactionLeg, k as TransactionRecord } from './types-Bk7NncQ_.js';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+import { T as TransactionLeg, k as TransactionRecord } from './types-HJGbXJ37.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 
 /**
@@ -67,7 +68,7 @@ declare class ZkLoginSigner implements TransactionSigner {
     isExpired(currentEpoch: number): boolean;
 }
 
-type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | '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';
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | '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;
     [key: string]: unknown;
@@ -161,21 +162,71 @@ declare const OPERATION_ASSETS: {
     readonly borrow: readonly ["USDC", "USDsui"];
     readonly withdraw: "*";
     readonly repay: "*";
-    readonly send: "*";
+    readonly send: readonly ["USDC", "USDsui", "SUI"];
     readonly swap: "*";
 };
 type Operation = keyof typeof OPERATION_ASSETS;
 declare function isAllowedAsset(op: Operation, asset: string): boolean;
 /**
  * Throws if the asset is not permitted for the given operation.
- * Passing `undefined` (omitted) is always valid — defaults to USDC.
+ *
+ * [v4.0 Phase A Day 2] Pre-v4 this allowed `undefined` as a silent default
+ * to USDC. Removed because every write path now requires explicit asset
+ * (see `T2000.send` + `buildSendTx` + `composeTx.send_transfer`). Save /
+ * borrow / repay still call this with `params.asset` (which may be
+ * undefined when the caller relies on the per-method `?? 'USDC'` default
+ * before this assertion fires), so the `undefined → no-op` branch stays
+ * for back-compat; the `send_transfer` flow validates non-undefined.
  */
 declare function assertAllowedAsset(op: Operation, asset: string | undefined): void;
+/**
+ * [v4.0 Phase A Day 2] Narrow type alias for assets sendable through the
+ * Agent Wallet. Matches `OPERATION_ASSETS.send` exactly. Exported so the
+ * CLI / SDK / composeTx can share one type without re-declaring it.
+ */
+type SendableAsset = 'USDC' | 'USDsui' | 'SUI';
+declare const SENDABLE_ASSETS: readonly SendableAsset[];
+/**
+ * [v4.0 Phase A Day 2] Coin types for the two gasless-allowlisted stables.
+ * Used by `wallet/send.ts` + `composeTx.send_transfer` to construct the
+ * `0x2::balance::send_funds` Move call's `typeArguments`. SUI is excluded
+ * because SUI transfers are NOT gasless (gas-native, uses `tx.gas` split +
+ * `transferObjects` per the existing path).
+ */
+declare const GASLESS_STABLE_TYPES: Record<'USDC' | 'USDsui', string>;
 declare const T2000_OVERLAY_FEE_WALLET: string;
 declare const DEFAULT_NETWORK: "mainnet";
+declare const DEFAULT_GRPC_URL = "https://fullnode.mainnet.sui.io:443";
+declare const GASLESS_MIN_STABLE_AMOUNT = 0.01;
 declare const CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
 declare const GAS_RESERVE_MIN = 0.05;
 
+declare function getSuiClient(rpcUrl?: string): SuiJsonRpcClient;
+declare function createSuiClient(network?: 'mainnet' | 'testnet'): SuiJsonRpcClient;
+/**
+ * Cached `SuiGrpcClient` for gasless stablecoin transfer builds.
+ *
+ * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+ *
+ * Why this exists: Sui mainnet's protocol-level gasless stablecoin transfers
+ * (`0x2::balance::send_funds` on the USDC + USDsui allowlist) are detected
+ * ONLY when the transaction is built through a `SuiGrpcClient`. The gRPC
+ * client's build resolver inspects the PTB at `tx.build()` time and, if it
+ * matches the gasless pattern, sets `gasPrice=0` + `gasBudget=0` automatically.
+ * Building the SAME PTB through `SuiJsonRpcClient` produces the same bytes
+ * but with non-zero gas — the tx still works, but the user pays SUI gas.
+ *
+ * Execution stays on JSON-RPC (`SuiJsonRpcClient.executeTransactionBlock`)
+ * because (a) the rest of the SDK expects JSON-RPC and (b) Sui's docs
+ * explicitly support a "build via gRPC, execute via JSON-RPC" hybrid:
+ * https://docs.sui.io/develop/transaction-payment/gasless-stablecoin-transfers
+ *
+ * Override the endpoint with the `T2000_GRPC_URL` env var or the
+ * `grpcUrl` arg. Cache is keyed by URL so multiple endpoints can
+ * co-exist (e.g., the rare testnet smoke + production usage from the
+ * same process).
+ */
+declare function getSuiGrpcClient(grpcUrl?: string): SuiGrpcClient;
 declare function validateAddress(address: string): string;
 declare function truncateAddress(address: string): string;
 /**
@@ -597,4 +648,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, SAVEABLE_ASSETS as aA, type SaveableAsset as aB, assertAllowedAsset as aC, getCoinMeta as aD, isAllowedAsset as aE, isInRegistry as aF, normalizeAsset as aG, normalizeCoinType as aH, queryHistory as aI, queryTransaction as aJ, simulateTransaction as aK, throwIfSimulationFailed as aL, 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, CETUS_USDC_SUI_POOL as ax, OPERATION_ASSETS as ay, type Operation 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, 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 };

package/dist/{types-Bk7NncQ_.d.cts → types-HJGbXJ37.d.cts}

@@ -494,21 +494,6 @@ interface CompoundRewardsResult {
     totalCompoundedUsdc: number;
     totalGasCost: number;
 }
-interface StakeVSuiResult {
-    success: boolean;
-    tx: string;
-    amountSui: number;
-    vSuiReceived: number;
-    apy: number;
-    gasCost: number;
-}
-interface UnstakeVSuiResult {
-    success: boolean;
-    tx: string;
-    vSuiAmount: number;
-    suiReceived: number;
-    gasCost: number;
-}
 interface SwapResult {
     success: boolean;
     tx: string;
@@ -579,4 +564,4 @@ interface FinancialSummary {
     fetchedAt: number;
 }
 
-export { type AssetRates as A, type BalanceResponse as B, type ClaimRewardsResult as C, type DepositInfo as D, type EarningsResult as E, type FundStatusResult as F, type GasReserve as G, type HealthFactorResult as H, isCetusRouteFresh as I, serializeCetusRoute as J, verifyCetusRouteCoinMatch as K, type MaxBorrowResult as M, OVERLAY_FEE_RATE as O, type PayOptions as P, type RatesResult as R, type SaveResult as S, type TransactionLeg as T, type UnstakeVSuiResult as U, type WithdrawResult as W, type BorrowResult as a, type MaxWithdrawResult as b, type OverlayFeeConfig as c, type PayResult as d, type PendingReward as e, type PositionEntry as f, type PositionsResult as g, type RepayResult as h, type SendResult as i, type SwapRouteResult as j, type TransactionRecord as k, buildSwapTx as l, findSwapRoute as m, type T2000Options as n, type StakeVSuiResult as o, type SwapResult as p, type SwapQuoteResult as q, type PaymentRequest as r, type CompoundRewardsResult as s, type FinancialSummary as t, type HFAlertLevel as u, type SerializedCetusRoute as v, type SerializedCetusRoutePath as w, type SerializedRouterDataV3 as x, addSwapToTx as y, deserializeCetusRoute as z };
+export { type AssetRates as A, type BalanceResponse as B, type ClaimRewardsResult as C, type DepositInfo as D, type EarningsResult as E, type FundStatusResult as F, type GasReserve as G, type HealthFactorResult as H, serializeCetusRoute as I, verifyCetusRouteCoinMatch as J, type MaxBorrowResult as M, OVERLAY_FEE_RATE as O, type PayOptions as P, type RatesResult as R, type SaveResult as S, type TransactionLeg as T, type WithdrawResult as W, type BorrowResult as a, type MaxWithdrawResult as b, type OverlayFeeConfig as c, type PayResult as d, type PendingReward as e, type PositionEntry as f, type PositionsResult as g, type RepayResult as h, type SendResult as i, type SwapRouteResult as j, type TransactionRecord as k, buildSwapTx as l, findSwapRoute as m, type T2000Options as n, type SwapResult as o, type SwapQuoteResult as p, type PaymentRequest as q, type CompoundRewardsResult as r, type FinancialSummary as s, type HFAlertLevel as t, type SerializedCetusRoute as u, type SerializedCetusRoutePath as v, type SerializedRouterDataV3 as w, addSwapToTx as x, deserializeCetusRoute as y, isCetusRouteFresh as z };

package/dist/{types-Bk7NncQ_.d.ts → types-HJGbXJ37.d.ts}

@@ -494,21 +494,6 @@ interface CompoundRewardsResult {
     totalCompoundedUsdc: number;
     totalGasCost: number;
 }
-interface StakeVSuiResult {
-    success: boolean;
-    tx: string;
-    amountSui: number;
-    vSuiReceived: number;
-    apy: number;
-    gasCost: number;
-}
-interface UnstakeVSuiResult {
-    success: boolean;
-    tx: string;
-    vSuiAmount: number;
-    suiReceived: number;
-    gasCost: number;
-}
 interface SwapResult {
     success: boolean;
     tx: string;
@@ -579,4 +564,4 @@ interface FinancialSummary {
     fetchedAt: number;
 }
 
-export { type AssetRates as A, type BalanceResponse as B, type ClaimRewardsResult as C, type DepositInfo as D, type EarningsResult as E, type FundStatusResult as F, type GasReserve as G, type HealthFactorResult as H, isCetusRouteFresh as I, serializeCetusRoute as J, verifyCetusRouteCoinMatch as K, type MaxBorrowResult as M, OVERLAY_FEE_RATE as O, type PayOptions as P, type RatesResult as R, type SaveResult as S, type TransactionLeg as T, type UnstakeVSuiResult as U, type WithdrawResult as W, type BorrowResult as a, type MaxWithdrawResult as b, type OverlayFeeConfig as c, type PayResult as d, type PendingReward as e, type PositionEntry as f, type PositionsResult as g, type RepayResult as h, type SendResult as i, type SwapRouteResult as j, type TransactionRecord as k, buildSwapTx as l, findSwapRoute as m, type T2000Options as n, type StakeVSuiResult as o, type SwapResult as p, type SwapQuoteResult as q, type PaymentRequest as r, type CompoundRewardsResult as s, type FinancialSummary as t, type HFAlertLevel as u, type SerializedCetusRoute as v, type SerializedCetusRoutePath as w, type SerializedRouterDataV3 as x, addSwapToTx as y, deserializeCetusRoute as z };
+export { type AssetRates as A, type BalanceResponse as B, type ClaimRewardsResult as C, type DepositInfo as D, type EarningsResult as E, type FundStatusResult as F, type GasReserve as G, type HealthFactorResult as H, serializeCetusRoute as I, verifyCetusRouteCoinMatch as J, type MaxBorrowResult as M, OVERLAY_FEE_RATE as O, type PayOptions as P, type RatesResult as R, type SaveResult as S, type TransactionLeg as T, type WithdrawResult as W, type BorrowResult as a, type MaxWithdrawResult as b, type OverlayFeeConfig as c, type PayResult as d, type PendingReward as e, type PositionEntry as f, type PositionsResult as g, type RepayResult as h, type SendResult as i, type SwapRouteResult as j, type TransactionRecord as k, buildSwapTx as l, findSwapRoute as m, type T2000Options as n, type SwapResult as o, type SwapQuoteResult as p, type PaymentRequest as q, type CompoundRewardsResult as r, type FinancialSummary as s, type HFAlertLevel as t, type SerializedCetusRoute as u, type SerializedCetusRoutePath as v, type SerializedRouterDataV3 as w, addSwapToTx as x, deserializeCetusRoute as y, isCetusRouteFresh as z };

package/dist/{types-Bh_0d-te.d.cts → types-_U9XXGFR.d.ts}

@@ -1,6 +1,7 @@
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-import { T as TransactionLeg, k as TransactionRecord } from './types-Bk7NncQ_.cjs';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+import { T as TransactionLeg, k as TransactionRecord } from './types-HJGbXJ37.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 
 /**
@@ -67,7 +68,7 @@ declare class ZkLoginSigner implements TransactionSigner {
     isExpired(currentEpoch: number): boolean;
 }
 
-type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | 'INSUFFICIENT_GAS' | 'INVALID_ADDRESS' | 'INVALID_AMOUNT' | 'WALLET_NOT_FOUND' | 'WALLET_LOCKED' | 'WALLET_EXISTS' | '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';
+type T2000ErrorCode = 'INSUFFICIENT_BALANCE' | '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;
     [key: string]: unknown;
@@ -161,21 +162,71 @@ declare const OPERATION_ASSETS: {
     readonly borrow: readonly ["USDC", "USDsui"];
     readonly withdraw: "*";
     readonly repay: "*";
-    readonly send: "*";
+    readonly send: readonly ["USDC", "USDsui", "SUI"];
     readonly swap: "*";
 };
 type Operation = keyof typeof OPERATION_ASSETS;
 declare function isAllowedAsset(op: Operation, asset: string): boolean;
 /**
  * Throws if the asset is not permitted for the given operation.
- * Passing `undefined` (omitted) is always valid — defaults to USDC.
+ *
+ * [v4.0 Phase A Day 2] Pre-v4 this allowed `undefined` as a silent default
+ * to USDC. Removed because every write path now requires explicit asset
+ * (see `T2000.send` + `buildSendTx` + `composeTx.send_transfer`). Save /
+ * borrow / repay still call this with `params.asset` (which may be
+ * undefined when the caller relies on the per-method `?? 'USDC'` default
+ * before this assertion fires), so the `undefined → no-op` branch stays
+ * for back-compat; the `send_transfer` flow validates non-undefined.
  */
 declare function assertAllowedAsset(op: Operation, asset: string | undefined): void;
+/**
+ * [v4.0 Phase A Day 2] Narrow type alias for assets sendable through the
+ * Agent Wallet. Matches `OPERATION_ASSETS.send` exactly. Exported so the
+ * CLI / SDK / composeTx can share one type without re-declaring it.
+ */
+type SendableAsset = 'USDC' | 'USDsui' | 'SUI';
+declare const SENDABLE_ASSETS: readonly SendableAsset[];
+/**
+ * [v4.0 Phase A Day 2] Coin types for the two gasless-allowlisted stables.
+ * Used by `wallet/send.ts` + `composeTx.send_transfer` to construct the
+ * `0x2::balance::send_funds` Move call's `typeArguments`. SUI is excluded
+ * because SUI transfers are NOT gasless (gas-native, uses `tx.gas` split +
+ * `transferObjects` per the existing path).
+ */
+declare const GASLESS_STABLE_TYPES: Record<'USDC' | 'USDsui', string>;
 declare const T2000_OVERLAY_FEE_WALLET: string;
 declare const DEFAULT_NETWORK: "mainnet";
+declare const DEFAULT_GRPC_URL = "https://fullnode.mainnet.sui.io:443";
+declare const GASLESS_MIN_STABLE_AMOUNT = 0.01;
 declare const CETUS_USDC_SUI_POOL = "0x51e883ba7c0b566a26cbc8a94cd33eb0abd418a77cc1e60ad22fd9b1f29cd2ab";
 declare const GAS_RESERVE_MIN = 0.05;
 
+declare function getSuiClient(rpcUrl?: string): SuiJsonRpcClient;
+declare function createSuiClient(network?: 'mainnet' | 'testnet'): SuiJsonRpcClient;
+/**
+ * Cached `SuiGrpcClient` for gasless stablecoin transfer builds.
+ *
+ * [v4.0 Phase A Day 2 — SPEC_AGENT_WALLET_GREENFIELD §A]
+ *
+ * Why this exists: Sui mainnet's protocol-level gasless stablecoin transfers
+ * (`0x2::balance::send_funds` on the USDC + USDsui allowlist) are detected
+ * ONLY when the transaction is built through a `SuiGrpcClient`. The gRPC
+ * client's build resolver inspects the PTB at `tx.build()` time and, if it
+ * matches the gasless pattern, sets `gasPrice=0` + `gasBudget=0` automatically.
+ * Building the SAME PTB through `SuiJsonRpcClient` produces the same bytes
+ * but with non-zero gas — the tx still works, but the user pays SUI gas.
+ *
+ * Execution stays on JSON-RPC (`SuiJsonRpcClient.executeTransactionBlock`)
+ * because (a) the rest of the SDK expects JSON-RPC and (b) Sui's docs
+ * explicitly support a "build via gRPC, execute via JSON-RPC" hybrid:
+ * https://docs.sui.io/develop/transaction-payment/gasless-stablecoin-transfers
+ *
+ * Override the endpoint with the `T2000_GRPC_URL` env var or the
+ * `grpcUrl` arg. Cache is keyed by URL so multiple endpoints can
+ * co-exist (e.g., the rare testnet smoke + production usage from the
+ * same process).
+ */
+declare function getSuiGrpcClient(grpcUrl?: string): SuiGrpcClient;
 declare function validateAddress(address: string): string;
 declare function truncateAddress(address: string): string;
 /**
@@ -597,4 +648,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, SAVEABLE_ASSETS as aA, type SaveableAsset as aB, assertAllowedAsset as aC, getCoinMeta as aD, isAllowedAsset as aE, isInRegistry as aF, normalizeAsset as aG, normalizeCoinType as aH, queryHistory as aI, queryTransaction as aJ, simulateTransaction as aK, throwIfSimulationFailed as aL, 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, CETUS_USDC_SUI_POOL as ax, OPERATION_ASSETS as ay, type Operation 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, 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@t2000/sdk",
-  "version": "3.2.0",
-  "description": "TypeScript SDK for Agentic Wallets on Sui — send, save, borrow, swap. NAVI lending + Cetus aggregator routing, sponsored gas, zkLogin compatible.",
+  "version": "4.0.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",
   "module": "./dist/index.js",
@@ -36,10 +36,13 @@
     "wallet",
     "ai",
     "agent",
-    "defi",
     "sdk",
     "usdc",
-    "navi"
+    "usdsui",
+    "gasless",
+    "cetus",
+    "navi",
+    "zklogin"
   ],
   "author": "t2000",
   "repository": {