@t2000/sdk 2.18.1 → 2.19.1

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-C2Va_r0h.cjs';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-C2Va_r0h.cjs';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-DOnXJXL2.cjs';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-DOnXJXL2.cjs';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-DqIb4AnV.cjs';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-DqIb4AnV.cjs';
-import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-I7U99DvG.cjs';
-export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-I7U99DvG.cjs';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-Bk7NncQ_.cjs';
+export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-Bk7NncQ_.cjs';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.cjs';
@@ -136,6 +136,37 @@ declare class T2000 extends EventEmitter<T2000Events> {
         amount: number;
         asset?: string;
     }): Promise<SendResult>;
+    /**
+     * [S.279 / CLI-CONTACTS-CLEANUP — 2026-05-23] Resolve a recipient
+     * string into a canonical 0x address, trying each shape in priority
+     * order:
+     *   1. **hex** — `0x…` is used directly (no RPC round-trip).
+     *   2. **SuiNS** — `alex.sui` resolves via `suix_resolveNameServiceAddress`.
+     *   3. **saved contact** — `ContactManager.resolve()` falls back to the
+     *      legacy `~/.t2000/contacts.json` alias map. Deprecated; the
+     *      manager surfaces a one-time `console.warn` when this path fires.
+     *
+     * Returns `{ address, suinsName?, contactName? }` so `send()` can stamp
+     * the name source on the receipt without re-resolving.
+     *
+     * Throws `T2000Error('SUINS_NOT_REGISTERED', …)` for well-formed but
+     * unregistered SuiNS names (vs. propagating the engine-style
+     * `SuinsNotRegisteredError` — keeps the SDK's error surface
+     * `T2000Error`-only, consistent with every other write helper).
+     *
+     * [S.279.1 / 2026-05-23 — patch v2.19.1] Promoted from `private` to
+     * `public` so MCP's `t2000_send` dryRun preview path can share the
+     * same resolution logic as the live execute path. Pre-2.19.1 the
+     * MCP dryRun called `agent.contacts.resolve(to)` directly, which
+     * rejected SuiNS names — preview-then-execute flows broke for
+     * `alex.sui`-style recipients. SSOT: never let preview and execute
+     * resolve the same input differently.
+     */
+    resolveRecipient(input: string): Promise<{
+        address: string;
+        contactName?: string;
+        suinsName?: string;
+    }>;
     balance(): Promise<BalanceResponse>;
     history(params?: {
         limit?: number;
@@ -223,6 +254,116 @@ declare class T2000 extends EventEmitter<T2000Events> {
     private emitBalanceChange;
 }
 
+/**
+ * Canonical 0x-address shape. Loose lower bound (>= 1 hex char) so
+ * pre-v1.0 short addresses still validate; tools that need a full 64-hex
+ * address can additionally check `length === 66`. Case-insensitive on
+ * the `0x` prefix because some upstream callers (and historic tests)
+ * uppercase the prefix as part of address normalization tests; the
+ * normalizer always returns the lowercased canonical form regardless.
+ */
+declare const SUI_ADDRESS_REGEX: RegExp;
+/**
+ * Strict canonical 0x-address shape (66 chars total). Used by the
+ * resolver's "looks like" check to disambiguate "user pasted an
+ * address" vs "user typed a SuiNS name".
+ */
+declare const SUI_ADDRESS_STRICT_REGEX: RegExp;
+/**
+ * Mirrors the pattern in `audric/apps/web-v2/lib/suins-cache.ts` so the
+ * host-side send executor and the engine-side read normalizer agree on
+ * what counts as a SuiNS name. SuiNS allows nested labels (`team.alex.sui`)
+ * but every label must use only `[a-z0-9-]`.
+ */
+declare const SUINS_NAME_REGEX: RegExp;
+declare class InvalidAddressError extends Error {
+    readonly raw: string;
+    constructor(raw: string);
+}
+declare class SuinsNotRegisteredError extends Error {
+    readonly name_: string;
+    constructor(name_: string);
+}
+declare class SuinsRpcError extends Error {
+    readonly name_: string;
+    constructor(name_: string, detail: string);
+}
+/**
+ * Returns true if `value` looks like a SuiNS name (case-insensitive).
+ * Cheap synchronous check — use to avoid an unnecessary RPC round-trip
+ * for inputs that obviously aren't names (0x addresses, contact handles).
+ */
+declare function looksLikeSuiNs(value: string): boolean;
+/**
+ * Resolve a SuiNS name to its on-chain Sui address via the public
+ * `suix_resolveNameServiceAddress` JSON-RPC method. Returns `null` if
+ * the name resolves to no address (= not registered or expired). Throws
+ * `SuinsRpcError` on RPC/network failure.
+ *
+ * The host SHOULD pass a `rpcUrl` that includes any vendor key (e.g.
+ * audric's BlockVision-keyed URL) so the call benefits from the host's
+ * paid retry/cache budget. Falls back to the public mainnet endpoint.
+ */
+declare function resolveSuinsViaRpc(rawName: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<string | null>;
+/**
+ * Reverse-resolve a 0x address to its registered SuiNS names via
+ * `suix_resolveNameServiceNames`. Returns the names sorted by the
+ * registry (the first entry is conventionally the user's "primary"
+ * name on dApps that show one), or `[]` when the address has no
+ * SuiNS records. Throws `SuinsRpcError` on RPC/network failure.
+ *
+ * Why this is its own helper (not folded into `normalizeAddressInput`):
+ * a reverse lookup adds a second RPC round-trip per tool call. We don't
+ * want every read tool that takes an `address` to silently double its
+ * latency. The lookup primitive is opt-in via the `resolve_suins` tool;
+ * normalizers stay forward-only.
+ */
+declare function resolveAddressToSuinsViaRpc(rawAddress: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<string[]>;
+interface NormalizedAddress {
+    /**
+     * Canonical 0x-prefixed lowercase hex address. Always set on success.
+     * Tools should use this for any downstream query (BlockVision, NAVI,
+     * positionFetcher, etc.) and for cache keys.
+     */
+    address: string;
+    /**
+     * The user-facing name when the input was resolved via SuiNS, otherwise
+     * `null`. Tools should stamp this on result data so card titles can
+     * render "Balance · obehi.sui" instead of "Balance · 0x1234…abcd".
+     */
+    suinsName: string | null;
+    /**
+     * The original input (pre-normalization). Useful for error narration —
+     * "I tried to resolve `Obehi.Sui` and …" reads better than the
+     * post-trim/lowercase form.
+     */
+    raw: string;
+}
+/**
+ * Canonical normalizer. Accepts a 0x address OR a SuiNS name; returns
+ * a structured `NormalizedAddress`. Throws:
+ *   - `InvalidAddressError` if the input matches neither shape.
+ *   - `SuinsNotRegisteredError` if the SuiNS name is well-formed but
+ *     resolves to null (= not registered).
+ *   - `SuinsRpcError` if the RPC fails.
+ *
+ * Every read tool (engine) and write helper (SDK `T2000.send()`) that
+ * accepts a user-supplied recipient MUST call this helper before any
+ * downstream lookup. Doing the check inline (1) duplicates the regex,
+ * (2) silently rejects SuiNS names, (3) makes cache keys inconsistent
+ * across tools.
+ */
+declare function normalizeAddressInput(value: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<NormalizedAddress>;
+
 declare function generateKeypair(): Ed25519Keypair;
 declare function keypairFromPrivateKey(privateKey: string): Ed25519Keypair;
 declare function saveKey(keypair: Ed25519Keypair, passphrase: string, keyPath?: string): Promise<string>;
@@ -1347,4 +1488,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 BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, StakeVSuiResult, type StepPreview, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStakeInput, type VoloStats, type VoloUnstakeInput, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, addStakeVSuiToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildUnstakeVSuiTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, StakeVSuiResult, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStakeInput, type VoloStats, type VoloUnstakeInput, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, addStakeVSuiToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildUnstakeVSuiTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import { EventEmitter } from 'eventemitter3';
 import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
-import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-BMdhu0D7.js';
-export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-BMdhu0D7.js';
+import { Q as TxMetadata, o as SafeguardConfig, T as T2000Error, H as TransactionSigner, _ as ZkLoginProof, v as SupportedAsset } from './types-CfBlFLmU.js';
+export { A as ALL_NAVI_ASSETS, B as BORROW_FEE_BPS, a as BPS_DENOMINATOR, ax as CETUS_USDC_SUI_POOL, C as CLOCK_ID, b as COIN_REGISTRY, c as ClassifyBalanceChange, d as ClassifyResult, e as CoinMeta, D as DEFAULT_NETWORK, f as DEFAULT_SAFEGUARD_CONFIG, E as ETH_TYPE, g as ExtractedTransfer, F as FeeOperation, G as GAS_RESERVE_MIN, I as IKA_TYPE, K as KNOWN_TARGETS, h as KeypairSigner, L as LABEL_PATTERNS, i as LOFI_TYPE, M as MANIFEST_TYPE, j as MIST_PER_SUI, N as NAVX_TYPE, ay as OPERATION_ASSETS, O as OUTBOUND_OPS, az as Operation, P as ProtocolFeeInfo, S as SAVE_FEE_BPS, k as STABLE_ASSETS, l as SUI_DECIMALS, m as SUI_TYPE, n as SUPPORTED_ASSETS, p as SafeguardError, q as SafeguardErrorDetails, r as SafeguardRule, s as SimulationResult, t as StableAsset, u as SuiRpcTxBlock, w as T2000ErrorCode, x as T2000ErrorData, y as T2000_OVERLAY_FEE_WALLET, z as TOKEN_MAP, J as TxDirection, U as USDC_DECIMALS, R as USDC_TYPE, V as USDE_TYPE, W as USDSUI_TYPE, X as USDT_TYPE, Y as WAL_TYPE, Z as WBTC_TYPE, $ as ZkLoginSigner, a0 as addFeeTransfer, aA as assertAllowedAsset, a1 as calculateFee, a2 as classifyAction, a3 as classifyLabel, a4 as classifyTransaction, a5 as extractAllUserLegs, a6 as extractTransferDetails, a7 as extractTxCommands, a8 as extractTxSender, a9 as fallbackLabel, aa as formatAssetAmount, ab as formatSui, ac as formatUsd, aB as getCoinMeta, ad as getDecimals, ae as getDecimalsForCoinType, af as getTier, aC as isAllowedAsset, aD as isInRegistry, ag as isSupported, ah as isTier1, ai as isTier2, aj as mapMoveAbortCode, ak as mapWalletError, al as mistToSui, aE as normalizeAsset, aF as normalizeCoinType, am as parseSuiRpcTx, aG as queryHistory, aH as queryTransaction, an as rawToStable, ao as rawToUsdc, ap as refineLendingLabel, aq as resolveSymbol, ar as resolveTokenType, aI as simulateTransaction, as as stableToRaw, at as suiToMist, aJ as throwIfSimulationFailed, au as truncateAddress, av as usdcToRaw, aw as validateAddress } from './types-CfBlFLmU.js';
 import { L as LendingAdapter, a as LendingRates, P as PendingReward$1 } from './descriptors-DqIb4AnV.js';
 export { A as AdapterCapability, b as AdapterPositions, c as AdapterTxResult, H as HealthInfo, d as ProtocolDescriptor, e as allDescriptors, n as naviDescriptor } from './descriptors-DqIb4AnV.js';
-import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-I7U99DvG.js';
-export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-I7U99DvG.js';
+import { n as T2000Options, P as PayOptions, d as PayResult, o as StakeVSuiResult, U as UnstakeVSuiResult, p as SwapResult, q as SwapQuoteResult, i as SendResult, B as BalanceResponse, k as TransactionRecord, D as DepositInfo, r as PaymentRequest, S as SaveResult, W as WithdrawResult, b as MaxWithdrawResult, a as BorrowResult, h as RepayResult, M as MaxBorrowResult, H as HealthFactorResult, e as PendingReward, C as ClaimRewardsResult, s as CompoundRewardsResult, g as PositionsResult, R as RatesResult, E as EarningsResult, F as FundStatusResult, c as OverlayFeeConfig, j as SwapRouteResult, t as FinancialSummary } from './types-Bk7NncQ_.js';
+export { A as AssetRates, G as GasReserve, u as HFAlertLevel, O as OVERLAY_FEE_RATE, f as PositionEntry, v as SerializedCetusRoute, w as SerializedCetusRoutePath, x as SerializedRouterDataV3, T as TransactionLeg, y as addSwapToTx, l as buildSwapTx, z as deserializeCetusRoute, m as findSwapRoute, I as isCetusRouteFresh, J as serializeCetusRoute, K as verifyCetusRouteCoinMatch } from './types-Bk7NncQ_.js';
 import { Transaction, TransactionObjectArgument } from '@mysten/sui/transactions';
 import { SuinsClient } from '@mysten/suins';
 export { NaviAdapter, ProtocolRegistry } from './adapters/index.js';
@@ -136,6 +136,37 @@ declare class T2000 extends EventEmitter<T2000Events> {
         amount: number;
         asset?: string;
     }): Promise<SendResult>;
+    /**
+     * [S.279 / CLI-CONTACTS-CLEANUP — 2026-05-23] Resolve a recipient
+     * string into a canonical 0x address, trying each shape in priority
+     * order:
+     *   1. **hex** — `0x…` is used directly (no RPC round-trip).
+     *   2. **SuiNS** — `alex.sui` resolves via `suix_resolveNameServiceAddress`.
+     *   3. **saved contact** — `ContactManager.resolve()` falls back to the
+     *      legacy `~/.t2000/contacts.json` alias map. Deprecated; the
+     *      manager surfaces a one-time `console.warn` when this path fires.
+     *
+     * Returns `{ address, suinsName?, contactName? }` so `send()` can stamp
+     * the name source on the receipt without re-resolving.
+     *
+     * Throws `T2000Error('SUINS_NOT_REGISTERED', …)` for well-formed but
+     * unregistered SuiNS names (vs. propagating the engine-style
+     * `SuinsNotRegisteredError` — keeps the SDK's error surface
+     * `T2000Error`-only, consistent with every other write helper).
+     *
+     * [S.279.1 / 2026-05-23 — patch v2.19.1] Promoted from `private` to
+     * `public` so MCP's `t2000_send` dryRun preview path can share the
+     * same resolution logic as the live execute path. Pre-2.19.1 the
+     * MCP dryRun called `agent.contacts.resolve(to)` directly, which
+     * rejected SuiNS names — preview-then-execute flows broke for
+     * `alex.sui`-style recipients. SSOT: never let preview and execute
+     * resolve the same input differently.
+     */
+    resolveRecipient(input: string): Promise<{
+        address: string;
+        contactName?: string;
+        suinsName?: string;
+    }>;
     balance(): Promise<BalanceResponse>;
     history(params?: {
         limit?: number;
@@ -223,6 +254,116 @@ declare class T2000 extends EventEmitter<T2000Events> {
     private emitBalanceChange;
 }
 
+/**
+ * Canonical 0x-address shape. Loose lower bound (>= 1 hex char) so
+ * pre-v1.0 short addresses still validate; tools that need a full 64-hex
+ * address can additionally check `length === 66`. Case-insensitive on
+ * the `0x` prefix because some upstream callers (and historic tests)
+ * uppercase the prefix as part of address normalization tests; the
+ * normalizer always returns the lowercased canonical form regardless.
+ */
+declare const SUI_ADDRESS_REGEX: RegExp;
+/**
+ * Strict canonical 0x-address shape (66 chars total). Used by the
+ * resolver's "looks like" check to disambiguate "user pasted an
+ * address" vs "user typed a SuiNS name".
+ */
+declare const SUI_ADDRESS_STRICT_REGEX: RegExp;
+/**
+ * Mirrors the pattern in `audric/apps/web-v2/lib/suins-cache.ts` so the
+ * host-side send executor and the engine-side read normalizer agree on
+ * what counts as a SuiNS name. SuiNS allows nested labels (`team.alex.sui`)
+ * but every label must use only `[a-z0-9-]`.
+ */
+declare const SUINS_NAME_REGEX: RegExp;
+declare class InvalidAddressError extends Error {
+    readonly raw: string;
+    constructor(raw: string);
+}
+declare class SuinsNotRegisteredError extends Error {
+    readonly name_: string;
+    constructor(name_: string);
+}
+declare class SuinsRpcError extends Error {
+    readonly name_: string;
+    constructor(name_: string, detail: string);
+}
+/**
+ * Returns true if `value` looks like a SuiNS name (case-insensitive).
+ * Cheap synchronous check — use to avoid an unnecessary RPC round-trip
+ * for inputs that obviously aren't names (0x addresses, contact handles).
+ */
+declare function looksLikeSuiNs(value: string): boolean;
+/**
+ * Resolve a SuiNS name to its on-chain Sui address via the public
+ * `suix_resolveNameServiceAddress` JSON-RPC method. Returns `null` if
+ * the name resolves to no address (= not registered or expired). Throws
+ * `SuinsRpcError` on RPC/network failure.
+ *
+ * The host SHOULD pass a `rpcUrl` that includes any vendor key (e.g.
+ * audric's BlockVision-keyed URL) so the call benefits from the host's
+ * paid retry/cache budget. Falls back to the public mainnet endpoint.
+ */
+declare function resolveSuinsViaRpc(rawName: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<string | null>;
+/**
+ * Reverse-resolve a 0x address to its registered SuiNS names via
+ * `suix_resolveNameServiceNames`. Returns the names sorted by the
+ * registry (the first entry is conventionally the user's "primary"
+ * name on dApps that show one), or `[]` when the address has no
+ * SuiNS records. Throws `SuinsRpcError` on RPC/network failure.
+ *
+ * Why this is its own helper (not folded into `normalizeAddressInput`):
+ * a reverse lookup adds a second RPC round-trip per tool call. We don't
+ * want every read tool that takes an `address` to silently double its
+ * latency. The lookup primitive is opt-in via the `resolve_suins` tool;
+ * normalizers stay forward-only.
+ */
+declare function resolveAddressToSuinsViaRpc(rawAddress: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<string[]>;
+interface NormalizedAddress {
+    /**
+     * Canonical 0x-prefixed lowercase hex address. Always set on success.
+     * Tools should use this for any downstream query (BlockVision, NAVI,
+     * positionFetcher, etc.) and for cache keys.
+     */
+    address: string;
+    /**
+     * The user-facing name when the input was resolved via SuiNS, otherwise
+     * `null`. Tools should stamp this on result data so card titles can
+     * render "Balance · obehi.sui" instead of "Balance · 0x1234…abcd".
+     */
+    suinsName: string | null;
+    /**
+     * The original input (pre-normalization). Useful for error narration —
+     * "I tried to resolve `Obehi.Sui` and …" reads better than the
+     * post-trim/lowercase form.
+     */
+    raw: string;
+}
+/**
+ * Canonical normalizer. Accepts a 0x address OR a SuiNS name; returns
+ * a structured `NormalizedAddress`. Throws:
+ *   - `InvalidAddressError` if the input matches neither shape.
+ *   - `SuinsNotRegisteredError` if the SuiNS name is well-formed but
+ *     resolves to null (= not registered).
+ *   - `SuinsRpcError` if the RPC fails.
+ *
+ * Every read tool (engine) and write helper (SDK `T2000.send()`) that
+ * accepts a user-supplied recipient MUST call this helper before any
+ * downstream lookup. Doing the check inline (1) duplicates the regex,
+ * (2) silently rejects SuiNS names, (3) makes cache keys inconsistent
+ * across tools.
+ */
+declare function normalizeAddressInput(value: string, ctx?: {
+    suiRpcUrl?: string;
+    signal?: AbortSignal;
+}): Promise<NormalizedAddress>;
+
 declare function generateKeypair(): Ed25519Keypair;
 declare function keypairFromPrivateKey(privateKey: string): Ed25519Keypair;
 declare function saveKey(keypair: Ed25519Keypair, passphrase: string, keyPath?: string): Promise<string>;
@@ -1347,4 +1488,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 BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, StakeVSuiResult, type StepPreview, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStakeInput, type VoloStats, type VoloUnstakeInput, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, addStakeVSuiToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildUnstakeVSuiTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };
+export { AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, type AppenderContext, BalanceResponse, type BorrowInput, BorrowResult, type BuildAddLeafParams, type BuildHarvestRewardsTxOptions, type BuildRevokeLeafParams, type ClaimRewardsInput, ClaimRewardsResult, type CoinPage, type ComposeTxFeeHookContext, type ComposeTxFeeHooks, type ComposeTxOptions, type ComposeTxResult, CompoundRewardsResult, ContactManager, DepositInfo, EarningsResult, FinancialSummary, type FinancialSummaryOptions, FundStatusResult, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, type HarvestPlan, type HarvestSkippedLeg, type HarvestSwapLeg, HealthFactorResult, InvalidAddressError, type LabelValidationResult, LendingAdapter, LendingRates, MaxBorrowResult, MaxWithdrawResult, type NormalizedAddress, OverlayFeeConfig, PayOptions, PayResult, PaymentRequest, PendingReward, PositionsResult, RatesResult, type RepayDebtInput, RepayResult, SPONSORED_PYTH_DEPENDENT_PROVIDERS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SafeguardConfig, SafeguardEnforcer, type SaveDepositInput, SaveResult, type SelectAndSplitResult, SendResult, type SendTransferInput, StakeVSuiResult, type StepPreview, SuinsNotRegisteredError, SuinsRpcError, SupportedAsset, type SwapExecuteInput, SwapQuoteResult, SwapResult, SwapRouteResult, T2000, T2000Error, T2000Options, TransactionRecord, TransactionSigner, TxMetadata, UnstakeVSuiResult, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, type VoloStakeInput, type VoloStats, type VoloUnstakeInput, WRITE_APPENDER_REGISTRY, type WithdrawInput, WithdrawResult, type WriteStep, type WriteToolName, ZkLoginProof, addClaimRewardsToTx, addSendToTx, addStakeVSuiToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildUnstakeVSuiTx, composeTx, deriveAllowedAddressesFromPtb, displayHandle, exportPrivateKey, fetchAllCoins, fullHandle, generateKeypair, getAddress, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getVoloStats, keypairFromPrivateKey, loadKey, looksLikeSuiNs, normalizeAddressInput, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, saveKey, selectAndSplitCoin, selectSuiCoin, validateLabel, walletExists };

package/dist/index.js

@@ -1799,6 +1799,132 @@ function extractCommands(txBlock) {
 // src/t2000.ts
 init_token_registry();
 
+// src/utils/suins.ts
+var SUI_MAINNET_URL = "https://fullnode.mainnet.sui.io:443";
+var SUI_ADDRESS_REGEX = /^0x[a-fA-F0-9]{1,64}$/i;
+var SUI_ADDRESS_STRICT_REGEX = /^0x[a-fA-F0-9]{64}$/i;
+var SUINS_NAME_REGEX = /^[a-z0-9-]+(\.[a-z0-9-]+)*\.sui$/;
+var InvalidAddressError = class extends Error {
+  constructor(raw) {
+    super(
+      `"${raw}" isn't a valid Sui address or SuiNS name. Pass a 0x-prefixed hex address (e.g. 0x40cd\u20263e62) or a SuiNS name ending in .sui (e.g. alex.sui).`
+    );
+    this.raw = raw;
+    this.name = "InvalidAddressError";
+  }
+};
+var SuinsNotRegisteredError = class extends Error {
+  constructor(name_) {
+    super(
+      `"${name_}" isn't a registered SuiNS name. Double-check the spelling, or paste the full Sui address (0x\u2026 64 hex characters).`
+    );
+    this.name_ = name_;
+    this.name = "SuinsNotRegisteredError";
+  }
+};
+var SuinsRpcError = class extends Error {
+  constructor(name_, detail) {
+    super(`SuiNS lookup failed for "${name_}" (${detail}). Try again, or paste the full Sui address.`);
+    this.name_ = name_;
+    this.name = "SuinsRpcError";
+  }
+};
+function looksLikeSuiNs(value) {
+  if (!value) return false;
+  return SUINS_NAME_REGEX.test(value.trim().toLowerCase());
+}
+async function resolveSuinsViaRpc(rawName, ctx = {}) {
+  const name = rawName.trim().toLowerCase();
+  if (!SUINS_NAME_REGEX.test(name)) {
+    throw new InvalidAddressError(rawName);
+  }
+  const url = ctx.suiRpcUrl || SUI_MAINNET_URL;
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "suix_resolveNameServiceAddress",
+        params: [name]
+      }),
+      signal: ctx.signal ?? AbortSignal.timeout(8e3)
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new SuinsRpcError(name, msg);
+  }
+  if (!res.ok) {
+    throw new SuinsRpcError(name, `HTTP ${res.status}`);
+  }
+  let body;
+  try {
+    body = await res.json();
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new SuinsRpcError(name, `JSON parse failed: ${msg}`);
+  }
+  if (body.error) {
+    throw new SuinsRpcError(name, body.error.message);
+  }
+  return body.result ?? null;
+}
+async function resolveAddressToSuinsViaRpc(rawAddress, ctx = {}) {
+  const address = rawAddress.trim().toLowerCase();
+  if (!SUI_ADDRESS_REGEX.test(address)) {
+    throw new InvalidAddressError(rawAddress);
+  }
+  const url = ctx.suiRpcUrl || SUI_MAINNET_URL;
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "suix_resolveNameServiceNames",
+        params: [address]
+      }),
+      signal: ctx.signal ?? AbortSignal.timeout(8e3)
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new SuinsRpcError(address, msg);
+  }
+  if (!res.ok) {
+    throw new SuinsRpcError(address, `HTTP ${res.status}`);
+  }
+  let body;
+  try {
+    body = await res.json();
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new SuinsRpcError(address, `JSON parse failed: ${msg}`);
+  }
+  if (body.error) {
+    throw new SuinsRpcError(address, body.error.message);
+  }
+  return body.result?.data ?? [];
+}
+async function normalizeAddressInput(value, ctx = {}) {
+  const trimmed = value.trim();
+  if (SUI_ADDRESS_REGEX.test(trimmed)) {
+    return { address: trimmed.toLowerCase(), suinsName: null, raw: value };
+  }
+  if (looksLikeSuiNs(trimmed)) {
+    const name = trimmed.toLowerCase();
+    const address = await resolveSuinsViaRpc(name, ctx);
+    if (!address) {
+      throw new SuinsNotRegisteredError(name);
+    }
+    return { address: address.toLowerCase(), suinsName: name, raw: value };
+  }
+  throw new InvalidAddressError(value);
+}
+
 // ../../node_modules/.pnpm/@mysten+bcs@2.0.2/node_modules/@mysten/bcs/dist/uleb.mjs
 function ulebEncode(num) {
   let bigNum = BigInt(num);
@@ -6266,6 +6392,14 @@ var SafeguardEnforcer = class {
 };
 init_errors();
 var RESERVED_NAMES = /* @__PURE__ */ new Set(["to", "all", "address"]);
+var deprecationWarned = false;
+function warnContactsDeprecation() {
+  if (deprecationWarned) return;
+  deprecationWarned = true;
+  console.warn(
+    "[t2000] DEPRECATION: ~/.t2000/contacts.json alias resolution is deprecated and will be removed in the next major release. Use SuiNS names instead (e.g. `t2000 send alex.sui 10 USDC`). Register a SuiNS name at https://suins.io if you need a memorable handle."
+  );
+}
 var ContactManager = class {
   contacts = {};
   filePath;
@@ -6295,6 +6429,7 @@ var ContactManager = class {
     const existed = key in this.contacts;
     this.contacts[key] = { name, address: normalized };
     this.save();
+    warnContactsDeprecation();
     return { action: existed ? "updated" : "added" };
   }
   remove(name) {
@@ -6319,12 +6454,15 @@ var ContactManager = class {
     }
     const contact = this.contacts[nameOrAddress.toLowerCase()];
     if (contact) {
+      warnContactsDeprecation();
       return { address: contact.address, contactName: contact.name };
     }
     throw new T2000Error(
       "CONTACT_NOT_FOUND",
       `"${nameOrAddress}" is not a valid Sui address or saved contact.
-  Add it: t2000 contacts add ${nameOrAddress} 0x...`
+  Use a SuiNS name (e.g. alex.sui \u2014 register at https://suins.io)
+  or paste the full Sui address (0x... 64 hex characters).
+  Legacy contact aliases: \`t2000 contacts add ${nameOrAddress} 0x...\` (deprecated).`
     );
   }
   validateName(name) {
@@ -6694,7 +6832,7 @@ var T2000 = class _T2000 extends EventEmitter {
     if (!(asset in SUPPORTED_ASSETS)) {
       throw new T2000Error("ASSET_NOT_SUPPORTED", `Asset ${asset} is not supported`);
     }
-    const resolved = this.contacts.resolve(params.to);
+    const resolved = await this.resolveRecipient(params.to);
     const sendAmount = params.amount;
     const sendTo = resolved.address;
     const gasResult = await executeTx(
@@ -6711,11 +6849,63 @@ var T2000 = class _T2000 extends EventEmitter {
       amount: sendAmount,
       to: resolved.address,
       contactName: resolved.contactName,
+      suinsName: resolved.suinsName,
       gasCost: gasResult.gasCostSui,
       gasCostUnit: "SUI",
       balance
     };
   }
+  /**
+   * [S.279 / CLI-CONTACTS-CLEANUP — 2026-05-23] Resolve a recipient
+   * string into a canonical 0x address, trying each shape in priority
+   * order:
+   *   1. **hex** — `0x…` is used directly (no RPC round-trip).
+   *   2. **SuiNS** — `alex.sui` resolves via `suix_resolveNameServiceAddress`.
+   *   3. **saved contact** — `ContactManager.resolve()` falls back to the
+   *      legacy `~/.t2000/contacts.json` alias map. Deprecated; the
+   *      manager surfaces a one-time `console.warn` when this path fires.
+   *
+   * Returns `{ address, suinsName?, contactName? }` so `send()` can stamp
+   * the name source on the receipt without re-resolving.
+   *
+   * Throws `T2000Error('SUINS_NOT_REGISTERED', …)` for well-formed but
+   * unregistered SuiNS names (vs. propagating the engine-style
+   * `SuinsNotRegisteredError` — keeps the SDK's error surface
+   * `T2000Error`-only, consistent with every other write helper).
+   *
+   * [S.279.1 / 2026-05-23 — patch v2.19.1] Promoted from `private` to
+   * `public` so MCP's `t2000_send` dryRun preview path can share the
+   * same resolution logic as the live execute path. Pre-2.19.1 the
+   * MCP dryRun called `agent.contacts.resolve(to)` directly, which
+   * rejected SuiNS names — preview-then-execute flows broke for
+   * `alex.sui`-style recipients. SSOT: never let preview and execute
+   * resolve the same input differently.
+   */
+  async resolveRecipient(input) {
+    const trimmed = input.trim();
+    if (SUI_ADDRESS_REGEX.test(trimmed)) {
+      return { address: trimmed.toLowerCase() };
+    }
+    if (looksLikeSuiNs(trimmed)) {
+      try {
+        const name = trimmed.toLowerCase();
+        const address = await resolveSuinsViaRpc(name);
+        if (!address) {
+          throw new SuinsNotRegisteredError(name);
+        }
+        return { address: address.toLowerCase(), suinsName: name };
+      } catch (err) {
+        if (err instanceof SuinsNotRegisteredError) {
+          throw new T2000Error(
+            "SUINS_NOT_REGISTERED",
+            err.message
+          );
+        }
+        throw err;
+      }
+    }
+    return this.contacts.resolve(input);
+  }
   async balance() {
     const bal = await queryBalance(this.client, this._address);
     let chainTotal = bal.available + bal.gasReserve.usdEquiv;
@@ -8379,6 +8569,6 @@ function displayHandle(label) {
   (*! scure-base - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
-export { ALL_NAVI_ASSETS, AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, BORROW_FEE_BPS, BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, ETH_TYPE, GAS_RESERVE_MIN, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, IKA_TYPE, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, NaviAdapter, OPERATION_ASSETS, OUTBOUND_OPS, OVERLAY_FEE_RATE, ProtocolRegistry, SAVE_FEE_BPS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addClaimRewardsToTx, addFeeTransfer, addSendToTx, addStakeVSuiToTx, addSwapToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, allDescriptors, assertAllowedAsset, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, classifyAction, classifyLabel, classifyTransaction, composeTx, deriveAllowedAddressesFromPtb, deserializeCetusRoute, displayHandle, exportPrivateKey, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getTier, getVoloStats, isAllowedAsset, isCetusRouteFresh, isInRegistry, isSupported, isTier1, isTier2, keypairFromPrivateKey, loadKey, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, normalizeAsset, normalizeCoinType, parseSuiRpcTx, queryHistory, queryTransaction, rawToStable, rawToUsdc, refineLendingLabel, resolveSymbol, resolveTokenType, saveKey, selectAndSplitCoin, selectSuiCoin, serializeCetusRoute, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, verifyCetusRouteCoinMatch, walletExists };
+export { ALL_NAVI_ASSETS, AUDRIC_PARENT_NAME, AUDRIC_PARENT_NFT_ID, BORROW_FEE_BPS, BPS_DENOMINATOR, CETUS_USDC_SUI_POOL, CLOCK_ID, COIN_REGISTRY, ContactManager, DEFAULT_NETWORK, DEFAULT_SAFEGUARD_CONFIG, ETH_TYPE, GAS_RESERVE_MIN, HF_CRITICAL_THRESHOLD, HF_WARN_THRESHOLD, IKA_TYPE, InvalidAddressError, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LOFI_TYPE, MANIFEST_TYPE, MIST_PER_SUI, NAVX_TYPE, NaviAdapter, OPERATION_ASSETS, OUTBOUND_OPS, OVERLAY_FEE_RATE, ProtocolRegistry, SAVE_FEE_BPS, SPONSORED_PYTH_DEPENDENT_PROVIDERS, STABLE_ASSETS, SUINS_NAME_REGEX, SUI_ADDRESS_REGEX, SUI_ADDRESS_STRICT_REGEX, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, SafeguardEnforcer, SafeguardError, SuinsNotRegisteredError, SuinsRpcError, T2000, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, VOLO_METADATA, VOLO_PKG, VOLO_POOL, VSUI_TYPE, WAL_TYPE, WBTC_TYPE, WRITE_APPENDER_REGISTRY, ZkLoginSigner, addClaimRewardsToTx, addFeeTransfer, addSendToTx, addStakeVSuiToTx, addSwapToTx, addUnstakeVSuiToTx, aggregateClaimableRewards, allDescriptors, assertAllowedAsset, buildAddLeafTx, buildClaimRewardsTx, buildHarvestRewardsTx, buildRevokeLeafTx, buildSendTx, buildStakeVSuiTx, buildSwapTx, buildUnstakeVSuiTx, calculateFee, classifyAction, classifyLabel, classifyTransaction, composeTx, deriveAllowedAddressesFromPtb, deserializeCetusRoute, displayHandle, exportPrivateKey, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchAllCoins, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fullHandle, generateKeypair, getAddress, getCoinMeta, getDecimals, getDecimalsForCoinType, getFinancialSummary, getPendingRewards, getPendingRewardsByAddress, getRates, getSponsoredSwapProviders, getSwapQuote, getTier, getVoloStats, isAllowedAsset, isCetusRouteFresh, isInRegistry, isSupported, isTier1, isTier2, keypairFromPrivateKey, loadKey, looksLikeSuiNs, mapMoveAbortCode, mapWalletError, mistToSui, naviDescriptor, normalizeAddressInput, normalizeAsset, normalizeCoinType, parseSuiRpcTx, queryHistory, queryTransaction, rawToStable, rawToUsdc, refineLendingLabel, resolveAddressToSuinsViaRpc, resolveSuinsViaRpc, resolveSymbol, resolveTokenType, saveKey, selectAndSplitCoin, selectSuiCoin, serializeCetusRoute, simulateTransaction, stableToRaw, suiToMist, throwIfSimulationFailed, truncateAddress, usdcToRaw, validateAddress, validateLabel, verifyCetusRouteCoinMatch, walletExists };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map