@t2000/cli 2.18.1 → 2.19.1

package/README.md

@@ -180,14 +180,18 @@ t2000 init
 |---------|-------------|
 | `t2000 earn` | Show all earning opportunities — savings yield |
 
-### Contacts
+### Contacts (DEPRECATED — sunset in next major)
+
+The local `~/.t2000/contacts.json` alias map is being retired. **Use SuiNS instead**: register `your-name.sui` once at https://suins.io and every Sui app — including `t2000 send` — resolves it automatically. The first time a process resolves or writes a legacy contact alias, the CLI prints a one-shot deprecation warning to stderr.
 
 | Command | Description |
 |---------|-------------|
-| `t2000 contacts` | List saved contacts |
-| `t2000 contacts add <name> <address>` | Save a named contact |
+| `t2000 contacts` | List saved contacts (deprecated) |
+| `t2000 contacts add <name> <address>` | Save a named contact (deprecated; warns once) |
 | `t2000 contacts remove <name>` | Remove a contact |
 
+`t2000 send` accepts SuiNS names natively — `t2000 send 10 USDC to alex.sui` works with no setup. Priority order for the recipient argument: `0x` address > SuiNS name > saved contact alias.
+
 ### Safeguards
 
 | Command | Description |

package/dist/{chunk-ZNZ4MOY2.js → chunk-R7KXQRHQ.js}

@@ -17575,6 +17575,130 @@ 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 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);
+}
 function ulebEncode(num) {
   let bigNum = BigInt(num);
   const arr = [];
@@ -21999,6 +22123,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;
@@ -22028,6 +22160,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) {
@@ -22052,12 +22185,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) {
@@ -22427,7 +22563,7 @@ var T2000 = class _T2000 extends import_index.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(
@@ -22444,11 +22580,63 @@ var T2000 = class _T2000 extends import_index.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 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;
@@ -24196,6 +24384,16 @@ export {
   parseSuiRpcTx,
   extractTxSender,
   extractTxCommands,
+  SUI_ADDRESS_REGEX,
+  SUI_ADDRESS_STRICT_REGEX,
+  SUINS_NAME_REGEX,
+  InvalidAddressError,
+  SuinsNotRegisteredError,
+  SuinsRpcError,
+  looksLikeSuiNs,
+  resolveSuinsViaRpc,
+  resolveAddressToSuinsViaRpc,
+  normalizeAddressInput,
   getRates,
   getPendingRewardsByAddress,
   getPendingRewards,
@@ -24257,4 +24455,4 @@ axios/dist/node/axios.cjs:
 @scure/bip39/index.js:
   (*! scure-bip39 - MIT License (c) 2022 Patricio Palladino, Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=chunk-ZNZ4MOY2.js.map
+//# sourceMappingURL=chunk-R7KXQRHQ.js.map