@t2000/cli 2.18.1 → 2.19.1

package/dist/{dist-EFTMN6BY.js → dist-A7D5R6SM.js}

@@ -16,6 +16,7 @@ import {
   HF_CRITICAL_THRESHOLD,
   HF_WARN_THRESHOLD,
   IKA_TYPE,
+  InvalidAddressError,
   KNOWN_TARGETS,
   KeypairSigner,
   LABEL_PATTERNS,
@@ -31,11 +32,16 @@ import {
   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,
@@ -111,10 +117,12 @@ import {
   isTier2,
   keypairFromPrivateKey,
   loadKey,
+  looksLikeSuiNs,
   mapMoveAbortCode,
   mapWalletError,
   mistToSui,
   naviDescriptor,
+  normalizeAddressInput,
   normalizeAsset,
   normalizeCoinType,
   parseSuiRpcTx,
@@ -123,6 +131,8 @@ import {
   rawToStable,
   rawToUsdc,
   refineLendingLabel,
+  resolveAddressToSuinsViaRpc,
+  resolveSuinsViaRpc,
   resolveSymbol,
   resolveTokenType,
   saveKey,
@@ -139,7 +149,7 @@ import {
   validateLabel,
   verifyCetusRouteCoinMatch,
   walletExists
-} from "./chunk-ZNZ4MOY2.js";
+} from "./chunk-R7KXQRHQ.js";
 import "./chunk-ZRPJE7U5.js";
 import "./chunk-OCLKPYUU.js";
 import "./chunk-SI54PO2N.js";
@@ -167,6 +177,7 @@ export {
   HF_CRITICAL_THRESHOLD,
   HF_WARN_THRESHOLD,
   IKA_TYPE,
+  InvalidAddressError,
   KNOWN_TARGETS,
   KeypairSigner,
   LABEL_PATTERNS,
@@ -182,11 +193,16 @@ export {
   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,
@@ -262,10 +278,12 @@ export {
   isTier2,
   keypairFromPrivateKey,
   loadKey,
+  looksLikeSuiNs,
   mapMoveAbortCode,
   mapWalletError,
   mistToSui,
   naviDescriptor,
+  normalizeAddressInput,
   normalizeAsset,
   normalizeCoinType,
   parseSuiRpcTx,
@@ -274,6 +292,8 @@ export {
   rawToStable,
   rawToUsdc,
   refineLendingLabel,
+  resolveAddressToSuinsViaRpc,
+  resolveSuinsViaRpc,
   resolveSymbol,
   resolveTokenType,
   saveKey,
@@ -291,4 +311,4 @@ export {
   verifyCetusRouteCoinMatch,
   walletExists
 };
-//# sourceMappingURL=dist-EFTMN6BY.js.map
+//# sourceMappingURL=dist-A7D5R6SM.js.map

package/dist/{dist-APKOY2VV.js → dist-EUGE6UAA.js}

@@ -134943,6 +134943,76 @@ function extractCommands(txBlock) {
   return result;
 }
 init_token_registry();
+var SUI_MAINNET_URL = "https://fullnode.mainnet.sui.io:443";
+var SUI_ADDRESS_REGEX = /^0x[a-fA-F0-9]{1,64}$/i;
+var SUINS_NAME_REGEX = /^[a-z0-9-]+(\.[a-z0-9-]+)*\.sui$/;
+var InvalidAddressError4 = 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 InvalidAddressError4(rawName);
+  }
+  const url3 = ctx.suiRpcUrl || SUI_MAINNET_URL;
+  let res;
+  try {
+    res = await fetch(url3, {
+      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;
+}
 function ulebEncode2(num2) {
   let bigNum = BigInt(num2);
   const arr = [];
@@ -139313,6 +139383,14 @@ var SafeguardEnforcer = class {
 };
 init_errors9();
 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;
@@ -139342,6 +139420,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) {
@@ -139366,12 +139445,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) {
@@ -139741,7 +139823,7 @@ var T2000 = class _T2000 extends import_index2.default {
     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(
@@ -139758,11 +139840,63 @@ var T2000 = class _T2000 extends import_index2.default {
       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 address2 = await resolveSuinsViaRpc(name);
+        if (!address2) {
+          throw new SuinsNotRegisteredError(name);
+        }
+        return { address: address2.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;
@@ -140862,7 +140996,7 @@ Call t2000_services first to discover the right endpoint, then t2000_pay to exec
   );
   server.tool(
     "t2000_contacts",
-    "List saved contacts (name \u2192 address mappings). Use contact names with t2000_send instead of raw addresses. Use t2000_contact_add to save new contacts.",
+    "DEPRECATED \u2014 List saved local contacts (~/.t2000/contacts.json name \u2192 address mappings). The local contact map is being sunset; the canonical name system is SuiNS (e.g. alex.sui \u2014 resolved by t2000_send automatically). This tool will be removed in the next major SDK release. Prefer pasting 0x addresses or using SuiNS names directly with t2000_send.",
     {},
     async () => {
       try {
@@ -140911,16 +141045,16 @@ function registerWriteTools(server, agent) {
   const mutex = new TxMutex();
   server.tool(
     "t2000_send",
-    "Send USDC to a Sui address or contact name. Amount is in dollars. Subject to per-transaction and daily send limits. Set dryRun: true to preview without signing.",
+    "Send USDC (or another supported asset) to a 0x Sui address, a SuiNS name (e.g. alex.sui), or a saved contact alias. Amount is in dollars. Subject to per-transaction and daily send limits. Set dryRun: true to preview without signing. SuiNS is the preferred name path; saved contacts (~/.t2000/contacts.json) are deprecated and will be removed in the next major SDK release.",
     {
-      to: external_exports.string().describe("Recipient Sui address (0x...) or contact name (e.g. 'Tom')"),
+      to: external_exports.string().describe("Recipient: 0x Sui address, SuiNS name like 'alex.sui', or saved contact name. SuiNS preferred; contact aliases are deprecated."),
       amount: external_exports.number().describe("Amount in dollars to send"),
       asset: external_exports.string().optional().describe("Asset to send (default: USDC)"),
       dryRun: external_exports.boolean().optional().describe("Preview without signing (default: false)")
     },
     async ({ to: to2, amount: amount2, asset, dryRun }) => {
       try {
-        const resolved = agent.contacts.resolve(to2);
+        const resolved = await agent.resolveRecipient(to2);
         if (dryRun) {
           agent.enforcer.check({ operation: "send", amount: amount2 });
           const balance = await agent.balance();
@@ -140934,6 +141068,7 @@ function registerWriteTools(server, agent) {
                 amount: amount2,
                 to: resolved.address,
                 contactName: resolved.contactName,
+                suinsName: resolved.suinsName,
                 asset: asset ?? "USDC",
                 currentBalance: balance.available,
                 balanceAfter: balance.available - amount2,
@@ -141224,7 +141359,7 @@ ${text}`;
   );
   server.tool(
     "t2000_contact_add",
-    'Save a contact name \u2192 Sui address mapping. After saving, use the name with t2000_send instead of pasting addresses. Example: save "Tom" as 0x1234... then send to "Tom".',
+    "DEPRECATED \u2014 Save a contact name \u2192 Sui address mapping to ~/.t2000/contacts.json. The local-file contact map is being sunset; the canonical name system is SuiNS (register your-name.sui at https://suins.io once and every Sui app resolves it). Use this tool only if the recipient has no SuiNS name AND you need a memorable local alias. Will be removed in the next major SDK release.",
     {
       name: external_exports.string().describe('Contact name (e.g. "Tom", "Alice")'),
       address: external_exports.string().describe("Sui wallet address (0x...)")
@@ -141240,7 +141375,7 @@ ${text}`;
   );
   server.tool(
     "t2000_contact_remove",
-    "Remove a saved contact by name.",
+    "DEPRECATED \u2014 Remove a saved local contact by name. The local-file contact map is being sunset; will be removed entirely in the next major SDK release.",
     {
       name: external_exports.string().describe("Contact name to remove")
     },
@@ -142008,7 +142143,7 @@ ${context}
     })
   );
 }
-var PKG_VERSION = "2.18.1";
+var PKG_VERSION = "2.19.1";
 console.log = (...args) => console.error("[log]", ...args);
 console.warn = (...args) => console.error("[warn]", ...args);
 async function startMcpServer(opts) {
@@ -142099,4 +142234,4 @@ axios/dist/node/axios.cjs:
 @scure/bip39/index.js:
   (*! scure-bip39 - MIT License (c) 2022 Patricio Palladino, Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=dist-APKOY2VV.js.map
+//# sourceMappingURL=dist-EUGE6UAA.js.map