@t2000/sdk 5.5.0 → 5.5.1

package/dist/index.d.cts

@@ -303,31 +303,35 @@ declare class SuinsRpcError extends Error {
  */
 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.
+ * Resolve a SuiNS name to its on-chain Sui address via the Sui GraphQL
+ * `address(name:)` query. Returns `null` if the name resolves to no address
+ * (= not registered or expired). Throws `SuinsRpcError` on transport 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.
+ * `ctx.signal` is honored for cancellation. (`ctx.suiRpcUrl` is retained for
+ * call-site back-compat but no longer used — resolution runs against the
+ * canonical GraphQL endpoint via `getSuiGraphQLClient()`.)
  */
 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.
+ * Reverse-resolve a 0x address to its SuiNS name via the Sui GraphQL
+ * `address(address:){ defaultNameRecord { domain } }` query. Returns a
+ * single-element array with the address's **default (primary)** name, or
+ * `[]` when it has none. Throws `SuinsRpcError` on transport failure.
+ *
+ * Behavior note: the legacy JSON-RPC path returned *all* names for the
+ * address; GraphQL exposes the explicitly-configured default record, which is
+ * the one every consumer here actually uses (the LLM `resolve_suins` tool +
+ * card titles only ever render the primary). Returning `[primary]` keeps the
+ * `string[]` contract intact.
+ *
+ * Why this is its own helper (not folded into `normalizeAddressInput`): a
+ * reverse lookup adds a second 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;

package/dist/index.d.ts

@@ -303,31 +303,35 @@ declare class SuinsRpcError extends Error {
  */
 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.
+ * Resolve a SuiNS name to its on-chain Sui address via the Sui GraphQL
+ * `address(name:)` query. Returns `null` if the name resolves to no address
+ * (= not registered or expired). Throws `SuinsRpcError` on transport 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.
+ * `ctx.signal` is honored for cancellation. (`ctx.suiRpcUrl` is retained for
+ * call-site back-compat but no longer used — resolution runs against the
+ * canonical GraphQL endpoint via `getSuiGraphQLClient()`.)
  */
 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.
+ * Reverse-resolve a 0x address to its SuiNS name via the Sui GraphQL
+ * `address(address:){ defaultNameRecord { domain } }` query. Returns a
+ * single-element array with the address's **default (primary)** name, or
+ * `[]` when it has none. Throws `SuinsRpcError` on transport failure.
+ *
+ * Behavior note: the legacy JSON-RPC path returned *all* names for the
+ * address; GraphQL exposes the explicitly-configured default record, which is
+ * the one every consumer here actually uses (the LLM `resolve_suins` tool +
+ * card titles only ever render the primary). Returning `[primary]` keeps the
+ * `string[]` contract intact.
+ *
+ * Why this is its own helper (not folded into `normalizeAddressInput`): a
+ * reverse lookup adds a second 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;

package/dist/index.js

@@ -1552,7 +1552,7 @@ var TX_NODE_FRAGMENT = `
   }
 `;
 var HISTORY_QUERY = `query History($address: SuiAddress!, $last: Int!) {
-  transactions(last: $last, filter: { sentAddress: $address }) {
+  transactions(last: $last, filter: { affectedAddress: $address }) {
     nodes {${TX_NODE_FRAGMENT}}
   }
 }`;
@@ -1679,7 +1679,12 @@ function extractCommands(txBlock) {
 init_token_registry();
 
 // src/utils/suins.ts
-var SUI_MAINNET_URL = "https://fullnode.mainnet.sui.io:443";
+var RESOLVE_NAME_QUERY = `query ResolveSuins($name: String!) {
+  address(name: $name) { address }
+}`;
+var REVERSE_NAME_QUERY = `query ReverseSuins($address: SuiAddress!) {
+  address(address: $address) { defaultNameRecord { domain } }
+}`;
 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$/;
@@ -1717,76 +1722,45 @@ async function resolveSuinsViaRpc(rawName, ctx = {}) {
   if (!SUINS_NAME_REGEX.test(name)) {
     throw new InvalidAddressError(rawName);
   }
-  const url = ctx.suiRpcUrl || SUI_MAINNET_URL;
+  const gql = getSuiGraphQLClient();
   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)
+    res = await gql.query({
+      query: RESOLVE_NAME_QUERY,
+      variables: { name },
+      signal: ctx.signal
     });
   } 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);
+  if (res.errors?.length) {
+    throw new SuinsRpcError(name, res.errors.map((e) => e.message ?? "unknown error").join("; "));
   }
-  return body.result ?? null;
+  return res.data?.address?.address ?? 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;
+  const gql = getSuiGraphQLClient();
   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)
+    res = await gql.query({
+      query: REVERSE_NAME_QUERY,
+      variables: { address },
+      signal: ctx.signal
     });
   } 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);
+  if (res.errors?.length) {
+    throw new SuinsRpcError(address, res.errors.map((e) => e.message ?? "unknown error").join("; "));
   }
-  return body.result?.data ?? [];
+  const domain = res.data?.address?.defaultNameRecord?.domain;
+  return domain ? [domain] : [];
 }
 async function normalizeAddressInput(value, ctx = {}) {
   const trimmed = value.trim();