@t2000/sdk 2.18.1 → 2.19.1

package/dist/index.cjs

@@ -1805,6 +1805,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);
@@ -6272,6 +6398,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;
@@ -6301,6 +6435,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) {
@@ -6325,12 +6460,15 @@ var ContactManager = class {
     }
     const contact = this.contacts[nameOrAddress.toLowerCase()];
     if (contact) {
+      warnContactsDeprecation();
       return { address: contact.address, contactName: contact.name };
     }
     throw new exports.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) {
@@ -6700,7 +6838,7 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
     if (!(asset in SUPPORTED_ASSETS)) {
       throw new exports.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(
@@ -6717,11 +6855,63 @@ var T2000 = class _T2000 extends eventemitter3.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 exports.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;
@@ -8398,6 +8588,7 @@ exports.DEFAULT_SAFEGUARD_CONFIG = DEFAULT_SAFEGUARD_CONFIG;
 exports.GAS_RESERVE_MIN = GAS_RESERVE_MIN;
 exports.HF_CRITICAL_THRESHOLD = HF_CRITICAL_THRESHOLD;
 exports.HF_WARN_THRESHOLD = HF_WARN_THRESHOLD;
+exports.InvalidAddressError = InvalidAddressError;
 exports.KNOWN_TARGETS = KNOWN_TARGETS;
 exports.KeypairSigner = KeypairSigner;
 exports.LABEL_PATTERNS = LABEL_PATTERNS;
@@ -8409,10 +8600,15 @@ exports.ProtocolRegistry = ProtocolRegistry;
 exports.SAVE_FEE_BPS = SAVE_FEE_BPS;
 exports.SPONSORED_PYTH_DEPENDENT_PROVIDERS = SPONSORED_PYTH_DEPENDENT_PROVIDERS;
 exports.STABLE_ASSETS = STABLE_ASSETS;
+exports.SUINS_NAME_REGEX = SUINS_NAME_REGEX;
+exports.SUI_ADDRESS_REGEX = SUI_ADDRESS_REGEX;
+exports.SUI_ADDRESS_STRICT_REGEX = SUI_ADDRESS_STRICT_REGEX;
 exports.SUI_DECIMALS = SUI_DECIMALS;
 exports.SUPPORTED_ASSETS = SUPPORTED_ASSETS;
 exports.SafeguardEnforcer = SafeguardEnforcer;
 exports.SafeguardError = SafeguardError;
+exports.SuinsNotRegisteredError = SuinsNotRegisteredError;
+exports.SuinsRpcError = SuinsRpcError;
 exports.T2000 = T2000;
 exports.T2000_OVERLAY_FEE_WALLET = T2000_OVERLAY_FEE_WALLET;
 exports.USDC_DECIMALS = USDC_DECIMALS;
@@ -8476,10 +8672,12 @@ exports.isTier1 = isTier1;
 exports.isTier2 = isTier2;
 exports.keypairFromPrivateKey = keypairFromPrivateKey;
 exports.loadKey = loadKey;
+exports.looksLikeSuiNs = looksLikeSuiNs;
 exports.mapMoveAbortCode = mapMoveAbortCode;
 exports.mapWalletError = mapWalletError;
 exports.mistToSui = mistToSui;
 exports.naviDescriptor = naviDescriptor;
+exports.normalizeAddressInput = normalizeAddressInput;
 exports.normalizeAsset = normalizeAsset;
 exports.normalizeCoinType = normalizeCoinType;
 exports.parseSuiRpcTx = parseSuiRpcTx;
@@ -8488,6 +8686,8 @@ exports.queryTransaction = queryTransaction;
 exports.rawToStable = rawToStable;
 exports.rawToUsdc = rawToUsdc;
 exports.refineLendingLabel = refineLendingLabel;
+exports.resolveAddressToSuinsViaRpc = resolveAddressToSuinsViaRpc;
+exports.resolveSuinsViaRpc = resolveSuinsViaRpc;
 exports.resolveSymbol = resolveSymbol;
 exports.resolveTokenType = resolveTokenType;
 exports.saveKey = saveKey;