@t2000/sdk 5.5.1 → 5.6.0

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { T as T2000Error, at as T2000Options, F as TransactionSigner, P as PayOptions, k as PayResult, au as SwapResult, av as SwapQuoteResult, t as SupportedAsset, o as SendResult, B as BalanceResponse, A as TransactionRecord, e as DepositInfo, aw as PaymentRequest, Z as ZkLoginProof, ax as SuiCoreClient, ay as SendableAsset, j as OverlayFeeConfig, az as SponsoredCoinMergeCache, u as SwapRouteResult } from './simulate-KETPmlDo.cjs';
-export { aA as CETUS_USDC_SUI_POOL, C as CLOCK_ID, a as COIN_REGISTRY, b as ClassifyBalanceChange, c as ClassifyResult, d as CoinMeta, aB as CoinPage, aC as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, E as ETH_TYPE, f as ExtractedTransfer, aD as GASLESS_MIN_STABLE_AMOUNT, aE as GASLESS_STABLE_TYPES, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, g as KeypairSigner, L as LABEL_PATTERNS, h as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, aF as OPERATION_ASSETS, O as OVERLAY_FEE_RATE, aG as Operation, aH as SENDABLE_ASSETS, S as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, aI as SelectAndSplitResult, aJ as SerializedCetusRoute, aK as SerializedCetusRoutePath, aL as SerializedRouterDataV3, p as SimulationResult, q as StableAsset, r as SuiHolding, s as SuiRpcTxBlock, v as T2000ErrorCode, w as T2000ErrorData, x as T2000_OVERLAY_FEE_WALLET, y as TOKEN_MAP, z as TransactionLeg, H as TxDirection, U as USDC_DECIMALS, J as USDC_TYPE, Q as USDE_TYPE, R as USDSUI_TYPE, V as USDT_TYPE, W as WAL_TYPE, X as WBTC_TYPE, Y as ZkLoginSigner, aM as addSwapToTx, aN as assertAllowedAsset, _ as buildSwapTx, $ as classifyAction, a0 as classifyLabel, a1 as classifyTransaction, aO as deserializeCetusRoute, a2 as executeTx, a3 as extractAllUserLegs, a4 as extractTransferDetails, a5 as extractTxCommands, a6 as extractTxSender, a7 as fallbackLabel, aP as fetchAllCoins, a8 as findSwapRoute, a9 as formatAssetAmount, aa as formatSui, ab as formatUsd, aQ as getCoinMeta, ac as getDecimals, ad as getDecimalsForCoinType, aR as getSuiClient, aS as getSuiGrpcClient, aT as isAllowedAsset, aU as isCetusRouteFresh, aV as isInRegistry, ae as mapMoveAbortCode, af as mapWalletError, ag as mistToSui, aW as normalizeAsset, aX as normalizeCoinType, ah as parseSuiRpcTx, ai as payWithMpp, aY as queryHistory, aZ as queryTransaction, aj as rawToStable, ak as rawToUsdc, al as refineLendingLabel, am as resolveSymbol, an as resolveTokenType, a_ as selectAndSplitCoin, a$ as selectSuiCoin, b0 as serializeCetusRoute, b1 as simulateTransaction, ao as stableToRaw, ap as suiToMist, b2 as throwIfSimulationFailed, aq as truncateAddress, ar as usdcToRaw, as as validateAddress, b3 as verifyCetusRouteCoinMatch } from './simulate-KETPmlDo.cjs';
-import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { T as T2000Error, aD as T2000Options, Q as TransactionSigner, l as PayOptions, m as PayResult, aE as SwapResult, aF as SwapQuoteResult, w as SupportedAsset, r as SendResult, B as BalanceResponse, J as TransactionRecord, e as DepositInfo, aG as PaymentRequest, $ as ZkLoginProof, aH as SuiCoreClient, j as OverlayFeeConfig, aI as SponsoredCoinMergeCache, x as SwapRouteResult, aJ as SendableAsset } from './send-D2nKpwJN.cjs';
+export { aK as CETUS_USDC_SUI_POOL, C as CLOCK_ID, a as COIN_REGISTRY, b as ClassifyBalanceChange, c as ClassifyResult, d as CoinMeta, aL as CoinPage, aM as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, E as ETH_TYPE, f as ExtractedTransfer, aN as GASLESS_MIN_STABLE_AMOUNT, aO as GASLESS_STABLE_TYPES, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, g as KeypairSigner, L as LABEL_PATTERNS, h as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, aP as OPERATION_ASSETS, O as OVERLAY_FEE_RATE, aQ as Operation, P as PREFLIGHT_MAX_AMOUNT, k as PREFLIGHT_OK, n as PreflightResult, aR as SENDABLE_ASSETS, S as STABLE_ASSETS, o as SUI_DECIMALS, p as SUI_TYPE, q as SUPPORTED_ASSETS, aS as SelectAndSplitResult, aT as SerializedCetusRoute, aU as SerializedCetusRoutePath, aV as SerializedRouterDataV3, s as SimulationResult, t as StableAsset, u as SuiHolding, v as SuiRpcTxBlock, y as T2000ErrorCode, z as T2000ErrorData, A as T2000_OVERLAY_FEE_WALLET, F as TOKEN_MAP, H as TransactionLeg, R as TxDirection, U as USDC_DECIMALS, V as USDC_TYPE, W as USDE_TYPE, X as USDSUI_TYPE, Y as USDT_TYPE, Z as WAL_TYPE, _ as WBTC_TYPE, a0 as ZkLoginSigner, aW as addSendToTx, aX as addSwapToTx, aY as assertAllowedAsset, a1 as buildSendTx, a2 as buildSwapTx, a3 as checkPositiveAmount, a4 as checkSuiAddress, a5 as classifyAction, a6 as classifyLabel, a7 as classifyTransaction, aZ as deserializeCetusRoute, a8 as executeTx, a9 as extractAllUserLegs, aa as extractTransferDetails, ab as extractTxCommands, ac as extractTxSender, ad as fallbackLabel, a_ as fetchAllCoins, ae as findSwapRoute, af as formatAssetAmount, ag as formatSui, ah as formatUsd, a$ as getCoinMeta, ai as getDecimals, aj as getDecimalsForCoinType, b0 as getSuiClient, b1 as getSuiGrpcClient, b2 as isAllowedAsset, b3 as isCetusRouteFresh, b4 as isInRegistry, ak as mapMoveAbortCode, al as mapWalletError, am as mistToSui, b5 as normalizeAsset, b6 as normalizeCoinType, an as parseSuiRpcTx, ao as payWithMpp, ap as preflightFail, aq as preflightPay, ar as preflightSend, as as preflightSwap, b7 as queryHistory, b8 as queryTransaction, at as rawToStable, au as rawToUsdc, av as refineLendingLabel, aw as resolveSymbol, ax as resolveTokenType, b9 as selectAndSplitCoin, ba as selectSuiCoin, bb as serializeCetusRoute, bc as simulateTransaction, ay as stableToRaw, az as suiToMist, bd as throwIfSimulationFailed, aA as truncateAddress, aB as usdcToRaw, aC as validateAddress, be as verifyCetusRouteCoinMatch } from './send-D2nKpwJN.cjs';
+import { TransactionObjectArgument, Transaction } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 import '@mysten/sui/client';
 import '@cetusprotocol/aggregator-sdk';
@@ -376,6 +376,19 @@ declare function normalizeAddressInput(value: string, ctx?: {
     signal?: AbortSignal;
 }): Promise<NormalizedAddress>;
 
+/**
+ * Full wallet balance: **every** held coin, not just the curated stables + SUI.
+ *
+ * Uses one `listBalances` (paginated) instead of N `getBalance` calls, then
+ * partitions: stables → priced $1, SUI → Cetus-oracle priced, **everything else
+ * → `tokens[]` amount-only** (`usdValue: null` — no price oracle for arbitrary
+ * tokens; we don't guess). Decimals for non-registry tokens are read on-chain
+ * (the only added call, and only for tokens you actually hold — necessary for a
+ * correct amount). `totalUsd` sums **priced holdings only** so it never
+ * overstates; `tokens` surfaces the rest honestly.
+ */
+declare function queryBalance(client: SuiCoreClient, address: string): Promise<BalanceResponse>;
+
 declare function generateKeypair(): Ed25519Keypair;
 declare function keypairFromPrivateKey(privateKey: string): Ed25519Keypair;
 /**
@@ -409,72 +422,6 @@ declare function walletExists(keyPath?: string): Promise<boolean>;
 declare function exportPrivateKey(keypair: Ed25519Keypair): string;
 declare function getAddress(keypair: Ed25519Keypair): string;
 
-/**
- * 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;
-
 /**
  * SPEC 7 v0.4 § Layer 0 — Canonical Write Architecture.
  *
@@ -981,4 +928,4 @@ declare function fullHandle(label: string): string;
  */
 declare function displayHandle(label: string): string;
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ComposeTxOptions, type ComposeTxResult, type DailySpend, DepositInfo, InvalidAddressError, type LabelValidationResult, type LimitAssertInput, LimitEnforcer, LimitExceededError, type LimitKind, type LimitOperation, type LimitsConfig, type LimitsFile, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, ZkLoginProof, addSendToTx, approxUsdValue, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getLimits, getSponsoredSwapProviders, getSwapQuote, hasLimits, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, readLimitsFile, recordDailySpend, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, setLimits, validateLabel, walletExists, writeLimitsFile };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ComposeTxOptions, type ComposeTxResult, type DailySpend, DepositInfo, InvalidAddressError, type LabelValidationResult, type LimitAssertInput, LimitEnforcer, LimitExceededError, type LimitKind, type LimitOperation, type LimitsConfig, type LimitsFile, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, ZkLoginProof, approxUsdValue, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getLimits, getSponsoredSwapProviders, getSwapQuote, hasLimits, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, queryBalance, readLimitsFile, recordDailySpend, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, setLimits, validateLabel, walletExists, writeLimitsFile };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { T as T2000Error, at as T2000Options, F as TransactionSigner, P as PayOptions, k as PayResult, au as SwapResult, av as SwapQuoteResult, t as SupportedAsset, o as SendResult, B as BalanceResponse, A as TransactionRecord, e as DepositInfo, aw as PaymentRequest, Z as ZkLoginProof, ax as SuiCoreClient, ay as SendableAsset, j as OverlayFeeConfig, az as SponsoredCoinMergeCache, u as SwapRouteResult } from './simulate-KETPmlDo.js';
-export { aA as CETUS_USDC_SUI_POOL, C as CLOCK_ID, a as COIN_REGISTRY, b as ClassifyBalanceChange, c as ClassifyResult, d as CoinMeta, aB as CoinPage, aC as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, E as ETH_TYPE, f as ExtractedTransfer, aD as GASLESS_MIN_STABLE_AMOUNT, aE as GASLESS_STABLE_TYPES, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, g as KeypairSigner, L as LABEL_PATTERNS, h as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, aF as OPERATION_ASSETS, O as OVERLAY_FEE_RATE, aG as Operation, aH as SENDABLE_ASSETS, S as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, aI as SelectAndSplitResult, aJ as SerializedCetusRoute, aK as SerializedCetusRoutePath, aL as SerializedRouterDataV3, p as SimulationResult, q as StableAsset, r as SuiHolding, s as SuiRpcTxBlock, v as T2000ErrorCode, w as T2000ErrorData, x as T2000_OVERLAY_FEE_WALLET, y as TOKEN_MAP, z as TransactionLeg, H as TxDirection, U as USDC_DECIMALS, J as USDC_TYPE, Q as USDE_TYPE, R as USDSUI_TYPE, V as USDT_TYPE, W as WAL_TYPE, X as WBTC_TYPE, Y as ZkLoginSigner, aM as addSwapToTx, aN as assertAllowedAsset, _ as buildSwapTx, $ as classifyAction, a0 as classifyLabel, a1 as classifyTransaction, aO as deserializeCetusRoute, a2 as executeTx, a3 as extractAllUserLegs, a4 as extractTransferDetails, a5 as extractTxCommands, a6 as extractTxSender, a7 as fallbackLabel, aP as fetchAllCoins, a8 as findSwapRoute, a9 as formatAssetAmount, aa as formatSui, ab as formatUsd, aQ as getCoinMeta, ac as getDecimals, ad as getDecimalsForCoinType, aR as getSuiClient, aS as getSuiGrpcClient, aT as isAllowedAsset, aU as isCetusRouteFresh, aV as isInRegistry, ae as mapMoveAbortCode, af as mapWalletError, ag as mistToSui, aW as normalizeAsset, aX as normalizeCoinType, ah as parseSuiRpcTx, ai as payWithMpp, aY as queryHistory, aZ as queryTransaction, aj as rawToStable, ak as rawToUsdc, al as refineLendingLabel, am as resolveSymbol, an as resolveTokenType, a_ as selectAndSplitCoin, a$ as selectSuiCoin, b0 as serializeCetusRoute, b1 as simulateTransaction, ao as stableToRaw, ap as suiToMist, b2 as throwIfSimulationFailed, aq as truncateAddress, ar as usdcToRaw, as as validateAddress, b3 as verifyCetusRouteCoinMatch } from './simulate-KETPmlDo.js';
-import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
+import { T as T2000Error, aD as T2000Options, Q as TransactionSigner, l as PayOptions, m as PayResult, aE as SwapResult, aF as SwapQuoteResult, w as SupportedAsset, r as SendResult, B as BalanceResponse, J as TransactionRecord, e as DepositInfo, aG as PaymentRequest, $ as ZkLoginProof, aH as SuiCoreClient, j as OverlayFeeConfig, aI as SponsoredCoinMergeCache, x as SwapRouteResult, aJ as SendableAsset } from './send-D2nKpwJN.js';
+export { aK as CETUS_USDC_SUI_POOL, C as CLOCK_ID, a as COIN_REGISTRY, b as ClassifyBalanceChange, c as ClassifyResult, d as CoinMeta, aL as CoinPage, aM as DEFAULT_GRPC_URL, D as DEFAULT_NETWORK, E as ETH_TYPE, f as ExtractedTransfer, aN as GASLESS_MIN_STABLE_AMOUNT, aO as GASLESS_STABLE_TYPES, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, g as KeypairSigner, L as LABEL_PATTERNS, h as LOFI_TYPE, M as MANIFEST_TYPE, i as MIST_PER_SUI, N as NAVX_TYPE, aP as OPERATION_ASSETS, O as OVERLAY_FEE_RATE, aQ as Operation, P as PREFLIGHT_MAX_AMOUNT, k as PREFLIGHT_OK, n as PreflightResult, aR as SENDABLE_ASSETS, S as STABLE_ASSETS, o as SUI_DECIMALS, p as SUI_TYPE, q as SUPPORTED_ASSETS, aS as SelectAndSplitResult, aT as SerializedCetusRoute, aU as SerializedCetusRoutePath, aV as SerializedRouterDataV3, s as SimulationResult, t as StableAsset, u as SuiHolding, v as SuiRpcTxBlock, y as T2000ErrorCode, z as T2000ErrorData, A as T2000_OVERLAY_FEE_WALLET, F as TOKEN_MAP, H as TransactionLeg, R as TxDirection, U as USDC_DECIMALS, V as USDC_TYPE, W as USDE_TYPE, X as USDSUI_TYPE, Y as USDT_TYPE, Z as WAL_TYPE, _ as WBTC_TYPE, a0 as ZkLoginSigner, aW as addSendToTx, aX as addSwapToTx, aY as assertAllowedAsset, a1 as buildSendTx, a2 as buildSwapTx, a3 as checkPositiveAmount, a4 as checkSuiAddress, a5 as classifyAction, a6 as classifyLabel, a7 as classifyTransaction, aZ as deserializeCetusRoute, a8 as executeTx, a9 as extractAllUserLegs, aa as extractTransferDetails, ab as extractTxCommands, ac as extractTxSender, ad as fallbackLabel, a_ as fetchAllCoins, ae as findSwapRoute, af as formatAssetAmount, ag as formatSui, ah as formatUsd, a$ as getCoinMeta, ai as getDecimals, aj as getDecimalsForCoinType, b0 as getSuiClient, b1 as getSuiGrpcClient, b2 as isAllowedAsset, b3 as isCetusRouteFresh, b4 as isInRegistry, ak as mapMoveAbortCode, al as mapWalletError, am as mistToSui, b5 as normalizeAsset, b6 as normalizeCoinType, an as parseSuiRpcTx, ao as payWithMpp, ap as preflightFail, aq as preflightPay, ar as preflightSend, as as preflightSwap, b7 as queryHistory, b8 as queryTransaction, at as rawToStable, au as rawToUsdc, av as refineLendingLabel, aw as resolveSymbol, ax as resolveTokenType, b9 as selectAndSplitCoin, ba as selectSuiCoin, bb as serializeCetusRoute, bc as simulateTransaction, ay as stableToRaw, az as suiToMist, bd as throwIfSimulationFailed, aA as truncateAddress, aB as usdcToRaw, aC as validateAddress, be as verifyCetusRouteCoinMatch } from './send-D2nKpwJN.js';
+import { TransactionObjectArgument, Transaction } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 import '@mysten/sui/client';
 import '@cetusprotocol/aggregator-sdk';
@@ -376,6 +376,19 @@ declare function normalizeAddressInput(value: string, ctx?: {
     signal?: AbortSignal;
 }): Promise<NormalizedAddress>;
 
+/**
+ * Full wallet balance: **every** held coin, not just the curated stables + SUI.
+ *
+ * Uses one `listBalances` (paginated) instead of N `getBalance` calls, then
+ * partitions: stables → priced $1, SUI → Cetus-oracle priced, **everything else
+ * → `tokens[]` amount-only** (`usdValue: null` — no price oracle for arbitrary
+ * tokens; we don't guess). Decimals for non-registry tokens are read on-chain
+ * (the only added call, and only for tokens you actually hold — necessary for a
+ * correct amount). `totalUsd` sums **priced holdings only** so it never
+ * overstates; `tokens` surfaces the rest honestly.
+ */
+declare function queryBalance(client: SuiCoreClient, address: string): Promise<BalanceResponse>;
+
 declare function generateKeypair(): Ed25519Keypair;
 declare function keypairFromPrivateKey(privateKey: string): Ed25519Keypair;
 /**
@@ -409,72 +422,6 @@ declare function walletExists(keyPath?: string): Promise<boolean>;
 declare function exportPrivateKey(keypair: Ed25519Keypair): string;
 declare function getAddress(keypair: Ed25519Keypair): string;
 
-/**
- * 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;
-
 /**
  * SPEC 7 v0.4 § Layer 0 — Canonical Write Architecture.
  *
@@ -981,4 +928,4 @@ declare function fullHandle(label: string): string;
  */
 declare function displayHandle(label: string): string;
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ComposeTxOptions, type ComposeTxResult, type DailySpend, DepositInfo, InvalidAddressError, type LabelValidationResult, type LimitAssertInput, LimitEnforcer, LimitExceededError, type LimitKind, type LimitOperation, type LimitsConfig, type LimitsFile, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, ZkLoginProof, addSendToTx, approxUsdValue, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getLimits, getSponsoredSwapProviders, getSwapQuote, hasLimits, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, readLimitsFile, recordDailySpend, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, setLimits, validateLabel, walletExists, writeLimitsFile };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BuildAddLeafParams, type BuildRevokeLeafParams, type ComposeTxOptions, type ComposeTxResult, type DailySpend, DepositInfo, InvalidAddressError, type LabelValidationResult, type LimitAssertInput, LimitEnforcer, LimitExceededError, type LimitKind, type LimitOperation, type LimitsConfig, type LimitsFile, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SendResult, type SendTransferInput, SendableAsset, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, WRITE_APPENDER_REGISTRY, type WriteStep, type WriteToolName, ZkLoginProof, approxUsdValue, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fullHandle, generateKeypair, getAddress, getLimits, getSponsoredSwapProviders, getSwapQuote, hasLimits, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, queryBalance, readLimitsFile, recordDailySpend, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveBech32, saveKey, setLimits, validateLabel, walletExists, writeLimitsFile };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { normalizeStructTag, isValidSuiAddress, normalizeSuiAddress, fromBase64 } from '@mysten/sui/utils';
 import { coinWithBalance, Transaction } from '@mysten/sui/transactions';
 import { AggregatorClient, Env } from '@cetusprotocol/aggregator-sdk';
 import BN from 'bn.js';
@@ -5,7 +6,6 @@ import { EventEmitter } from 'eventemitter3';
 import { createPaymentTransactionUri } from '@mysten/payment-kit';
 import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { SuiGraphQLClient } from '@mysten/sui/graphql';
-import { normalizeStructTag, normalizeSuiAddress, isValidSuiAddress, fromBase64 } from '@mysten/sui/utils';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { decodeSuiPrivateKey } from '@mysten/sui/cryptography';
 import { access, mkdir, writeFile, readFile } from 'fs/promises';
@@ -112,6 +112,37 @@ var init_errors = __esm({
     };
   }
 });
+function preflightFail(code, error) {
+  return { valid: false, code, error };
+}
+function checkPositiveAmount(amount, label = "Amount", max = PREFLIGHT_MAX_AMOUNT) {
+  if (typeof amount !== "number" || !Number.isFinite(amount)) {
+    return preflightFail("INVALID_AMOUNT", `${label} must be a finite number`);
+  }
+  if (amount <= 0) {
+    return preflightFail("INVALID_AMOUNT", `${label} must be greater than zero`);
+  }
+  if (amount > max) {
+    return preflightFail("INVALID_AMOUNT", `${label} ${amount} exceeds the sane maximum (${max})`);
+  }
+  return PREFLIGHT_OK;
+}
+function checkSuiAddress(address, label = "recipient") {
+  try {
+    if (typeof address === "string" && address.trim() !== "" && isValidSuiAddress(normalizeSuiAddress(address))) {
+      return PREFLIGHT_OK;
+    }
+  } catch {
+  }
+  return preflightFail("INVALID_ADDRESS", `Invalid ${label} address: ${address}`);
+}
+var PREFLIGHT_MAX_AMOUNT, PREFLIGHT_OK;
+var init_preflight = __esm({
+  "src/preflight.ts"() {
+    PREFLIGHT_MAX_AMOUNT = 1e6;
+    PREFLIGHT_OK = { valid: true };
+  }
+});
 
 // src/token-registry.ts
 var token_registry_exports = {};
@@ -376,10 +407,28 @@ __export(cetus_swap_exports, {
   findSwapRoute: () => findSwapRoute,
   isCetusRouteFresh: () => isCetusRouteFresh,
   isPrecomputedRouteCompatibleWithProviders: () => isPrecomputedRouteCompatibleWithProviders,
+  preflightSwap: () => preflightSwap,
   resolveTokenType: () => resolveTokenType,
   serializeCetusRoute: () => serializeCetusRoute,
   verifyCetusRouteCoinMatch: () => verifyCetusRouteCoinMatch
 });
+function preflightSwap(input) {
+  if (typeof input.from !== "string" || input.from.trim() === "") {
+    return preflightFail("INVALID_ASSET", "A `from` token is required to swap");
+  }
+  if (typeof input.to !== "string" || input.to.trim() === "") {
+    return preflightFail("INVALID_ASSET", "A `to` token is required to swap");
+  }
+  const amountCheck = checkPositiveAmount(input.amount, "Amount", Number.POSITIVE_INFINITY);
+  if (!amountCheck.valid) return amountCheck;
+  const resolvedFrom = resolveTokenType(input.from);
+  const resolvedTo = resolveTokenType(input.to);
+  const sameToken = input.from.trim() === input.to.trim() || resolvedFrom !== null && resolvedFrom === resolvedTo;
+  if (sameToken) {
+    return preflightFail("INVALID_ASSET", `Cannot swap ${input.from} to itself`);
+  }
+  return PREFLIGHT_OK;
+}
 function serializeCetusRoute(route, context) {
   return {
     routerData: serializeRouterDataV3(route.routerData),
@@ -631,6 +680,7 @@ var OVERLAY_FEE_RATE, clientCache;
 var init_cetus_swap = __esm({
   "src/protocols/cetus-swap.ts"() {
     init_token_registry();
+    init_preflight();
     init_token_registry();
     OVERLAY_FEE_RATE = 1e-3;
     clientCache = /* @__PURE__ */ new Map();
@@ -1004,8 +1054,33 @@ async function executeTx(client, signer, buildTx, options = {}) {
 
 // src/wallet/pay.ts
 init_errors();
+init_preflight();
+function preflightPay(input) {
+  if (typeof input.url !== "string" || input.url.trim() === "") {
+    return preflightFail("FACILITATOR_REJECTION", "A target URL is required to pay");
+  }
+  let parsed;
+  try {
+    parsed = new URL(input.url);
+  } catch {
+    return preflightFail("FACILITATOR_REJECTION", `Invalid URL: ${input.url}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    return preflightFail(
+      "FACILITATOR_REJECTION",
+      `URL must be http(s): got ${parsed.protocol}//`
+    );
+  }
+  if (input.maxPrice !== void 0) {
+    const priceCheck = checkPositiveAmount(input.maxPrice, "maxPrice");
+    if (!priceCheck.valid) return priceCheck;
+  }
+  return PREFLIGHT_OK;
+}
 async function payWithMpp(args) {
   const { signer, client, options } = args;
+  const pf = preflightPay({ url: options.url, maxPrice: options.maxPrice });
+  if (!pf.valid) throw new T2000Error(pf.code, pf.error);
   const method = (options.method ?? "GET").toUpperCase();
   const canHaveBody = method !== "GET" && method !== "HEAD";
   const reqInit = {
@@ -1240,6 +1315,25 @@ function normalizeAsset(input) {
 }
 
 // src/wallet/send.ts
+init_preflight();
+function preflightSend(input) {
+  try {
+    assertAllowedAsset("send", input.asset);
+  } catch (e) {
+    return preflightFail("INVALID_ASSET", e.message);
+  }
+  const amountCheck = checkPositiveAmount(input.amount);
+  if (!amountCheck.valid) return amountCheck;
+  if ((input.asset === "USDC" || input.asset === "USDsui") && input.amount < GASLESS_MIN_STABLE_AMOUNT) {
+    return preflightFail(
+      "INVALID_AMOUNT",
+      `Minimum gasless transfer is ${GASLESS_MIN_STABLE_AMOUNT} ${input.asset}. Got ${input.amount}.`
+    );
+  }
+  const addressCheck = checkSuiAddress(input.to);
+  if (!addressCheck.valid) return addressCheck;
+  return PREFLIGHT_OK;
+}
 async function buildSendTx({
   client,
   address,
@@ -1247,17 +1341,11 @@ async function buildSendTx({
   amount,
   asset
 }) {
-  assertAllowedAsset("send", asset);
+  const pf = preflightSend({ to, amount, asset });
+  if (!pf.valid) throw new T2000Error(pf.code, pf.error);
   const recipient = validateAddress(to);
   const assetInfo = SUPPORTED_ASSETS[asset];
   if (!assetInfo) throw new T2000Error("ASSET_NOT_SUPPORTED", `Asset ${asset} is not supported`);
-  if (amount <= 0) throw new T2000Error("INVALID_AMOUNT", "Amount must be greater than zero");
-  if ((asset === "USDC" || asset === "USDsui") && amount < GASLESS_MIN_STABLE_AMOUNT) {
-    throw new T2000Error(
-      "INVALID_AMOUNT",
-      `Minimum gasless transfer is ${GASLESS_MIN_STABLE_AMOUNT} ${asset}. Got ${amount}.`
-    );
-  }
   const rawAmount = displayToRaw(amount, assetInfo.decimals);
   const tx = new Transaction();
   tx.setSender(address);
@@ -2053,7 +2141,9 @@ var T2000 = class _T2000 extends EventEmitter {
       amountUsd: approxUsdValue(params.from, params.amount) ?? 0,
       force: params.force
     });
-    const { findSwapRoute: findSwapRoute2, buildSwapTx: buildSwapTx2, resolveTokenType: resolveTokenType2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+    const { findSwapRoute: findSwapRoute2, buildSwapTx: buildSwapTx2, resolveTokenType: resolveTokenType2, preflightSwap: preflightSwap2 } = await Promise.resolve().then(() => (init_cetus_swap(), cetus_swap_exports));
+    const pf = preflightSwap2({ from: params.from, to: params.to, amount: params.amount });
+    if (!pf.valid) throw new T2000Error(pf.code, pf.error);
     const fromType = resolveTokenType2(params.from);
     const toType = resolveTokenType2(params.to);
     if (!fromType) throw new T2000Error("ASSET_NOT_SUPPORTED", `Unknown token: ${params.from}. Provide the full coin type.`);
@@ -2783,6 +2873,9 @@ function displayHandle(label) {
   return `${label}@${parentDisplay}`;
 }
 
-export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, DEFAULT_GRPC_URL, DEFAULT_NETWORK, ETH_TYPE, GASLESS_MIN_STABLE_AMOUNT, GASLESS_STABLE_TYPES, GAS_RESERVE_MIN, IKA_TYPE, InvalidAddressError, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, LimitEnforcer, LimitExceededError, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, OPERATION_ASSETS, OVERLAY_FEE_RATE, SENDABLE_ASSETS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, STABLE_ASSETS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SuinsNotRegisteredError, SuinsRpcError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addSendToTx, addSwapToTx, approxUsdValue, assertAllowedAsset, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, buildSwapTx, classifyAction, classifyLabel, classifyTransaction, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, deserializeCetusRoute, displayHandle, executeTx, exportPrivateKey, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getLimits, getSponsoredSwapProviders, getSuiClient, getSuiGrpcClient, getSwapQuote, hasLimits, isAllowedAsset, isCetusRouteFresh, isInRegistry, keypairFromPrivateKey, loadKey, looksLikeSuiNs, mapMoveAbortCode, mapWalletError, mistToSui, normalizeAddressInput, normalizeAsset, normalizeCoinType, parseSuiRpcTx, payWithMpp, queryHistory, queryTransaction, rawToStable, rawToUsdc, readLimitsFile, recordDailySpend, refineLendingLabel, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, resolveSymbol, resolveTokenType, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, serializeCetusRoute, setLimits, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, verifyCetusRouteCoinMatch, walletExists, writeLimitsFile };
+// src/index.ts
+init_preflight();
+
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, DEFAULT_GRPC_URL, DEFAULT_NETWORK, ETH_TYPE, GASLESS_MIN_STABLE_AMOUNT, GASLESS_STABLE_TYPES, GAS_RESERVE_MIN, IKA_TYPE, InvalidAddressError, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, LimitEnforcer, LimitExceededError, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, OPERATION_ASSETS, OVERLAY_FEE_RATE, PREFLIGHT_MAX_AMOUNT, PREFLIGHT_OK, SENDABLE_ASSETS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, STABLE_ASSETS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SuinsNotRegisteredError, SuinsRpcError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addSendToTx, addSwapToTx, approxUsdValue, assertAllowedAsset, assertLimitConfig, buildAddLeafTx, buildRevokeLeafTx, buildSendTx, buildSwapTx, checkPositiveAmount, checkSuiAddress, classifyAction, classifyLabel, classifyTransaction, clearLimits, composeTx, dailySpentToday, deriveAllowedAddressesFromPtb, deserializeCetusRoute, displayHandle, executeTx, exportPrivateKey, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getLimits, getSponsoredSwapProviders, getSuiClient, getSuiGrpcClient, getSwapQuote, hasLimits, isAllowedAsset, isCetusRouteFresh, isInRegistry, keypairFromPrivateKey, loadKey, looksLikeSuiNs, mapMoveAbortCode, mapWalletError, mistToSui, normalizeAddressInput, normalizeAsset, normalizeCoinType, parseSuiRpcTx, payWithMpp, preflightFail, preflightPay, preflightSend, preflightSwap, queryBalance, queryHistory, queryTransaction, rawToStable, rawToUsdc, readLimitsFile, recordDailySpend, refineLendingLabel, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, resolveSymbol, resolveTokenType, saveBech32, saveKey, selectAndSplitCoin, selectSuiCoin, serializeCetusRoute, setLimits, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, verifyCetusRouteCoinMatch, walletExists, writeLimitsFile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map