@monadns/sdk 1.0.0

package/dist/react.d.cts

@@ -0,0 +1,109 @@
+import { PublicClient, Transport, Chain } from 'viem';
+
+type MNSClientConfig = {
+    /** Custom RPC URL. Defaults to the public Monad RPC. */
+    rpcUrl?: string;
+    /** Existing viem PublicClient to reuse instead of creating a new one. */
+    client?: PublicClient<Transport, Chain>;
+};
+
+/**
+ * Reverse resolution hook: address → .mon name
+ *
+ * @example
+ * ```tsx
+ * function Profile({ address }: { address: string }) {
+ *   const { name, loading } = useMNSName(address)
+ *   return <span>{loading ? '...' : name ?? address}</span>
+ * }
+ * ```
+ */
+declare function useMNSName(address: string | undefined, config?: MNSClientConfig): {
+    name: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Forward resolution hook: .mon name → address
+ *
+ * @example
+ * ```tsx
+ * function Lookup() {
+ *   const { address, loading } = useMNSAddress('alice.mon')
+ *   return <span>{loading ? 'Resolving...' : address}</span>
+ * }
+ * ```
+ */
+declare function useMNSAddress(name: string | undefined, config?: MNSClientConfig): {
+    address: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Display name hook: .mon name if available, otherwise truncated address
+ *
+ * @example
+ * ```tsx
+ * function Badge({ address }: { address: string }) {
+ *   const { displayName, monName } = useMNSDisplay(address)
+ *   return (
+ *     <span className={monName ? 'text-purple-400' : 'text-gray-500'}>
+ *       {displayName}
+ *     </span>
+ *   )
+ * }
+ * ```
+ */
+declare function useMNSDisplay(address: string | undefined, config?: MNSClientConfig): {
+    displayName: string;
+    monName: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * On-demand resolver hook: for input fields accepting names or addresses
+ *
+ * @example
+ * ```tsx
+ * function SendForm() {
+ *   const { resolve, address, name, loading, error } = useMNSResolve()
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         placeholder="Address or .mon name"
+ *         onChange={(e) => resolve(e.target.value)}
+ *       />
+ *       {loading && <span>Resolving...</span>}
+ *       {error && <span className="text-red-500">{error}</span>}
+ *       {address && <span className="text-green-500">→ {address}</span>}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useMNSResolve(config?: MNSClientConfig): {
+    resolve: (input: string) => Promise<void>;
+    address: string | null;
+    name: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Text record hook: get metadata like avatar, URL, twitter handle
+ *
+ * @example
+ * ```tsx
+ * function Avatar({ name }: { name: string }) {
+ *   const { value } = useMNSText(name, 'avatar')
+ *   return value ? <img src={value} /> : null
+ * }
+ * ```
+ */
+declare function useMNSText(name: string | undefined, key: string, config?: MNSClientConfig): {
+    value: string | null;
+    loading: boolean;
+    error: string | null;
+};
+
+export { type MNSClientConfig, useMNSAddress, useMNSDisplay, useMNSName, useMNSResolve, useMNSText };

package/dist/react.d.ts

@@ -0,0 +1,109 @@
+import { PublicClient, Transport, Chain } from 'viem';
+
+type MNSClientConfig = {
+    /** Custom RPC URL. Defaults to the public Monad RPC. */
+    rpcUrl?: string;
+    /** Existing viem PublicClient to reuse instead of creating a new one. */
+    client?: PublicClient<Transport, Chain>;
+};
+
+/**
+ * Reverse resolution hook: address → .mon name
+ *
+ * @example
+ * ```tsx
+ * function Profile({ address }: { address: string }) {
+ *   const { name, loading } = useMNSName(address)
+ *   return <span>{loading ? '...' : name ?? address}</span>
+ * }
+ * ```
+ */
+declare function useMNSName(address: string | undefined, config?: MNSClientConfig): {
+    name: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Forward resolution hook: .mon name → address
+ *
+ * @example
+ * ```tsx
+ * function Lookup() {
+ *   const { address, loading } = useMNSAddress('alice.mon')
+ *   return <span>{loading ? 'Resolving...' : address}</span>
+ * }
+ * ```
+ */
+declare function useMNSAddress(name: string | undefined, config?: MNSClientConfig): {
+    address: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Display name hook: .mon name if available, otherwise truncated address
+ *
+ * @example
+ * ```tsx
+ * function Badge({ address }: { address: string }) {
+ *   const { displayName, monName } = useMNSDisplay(address)
+ *   return (
+ *     <span className={monName ? 'text-purple-400' : 'text-gray-500'}>
+ *       {displayName}
+ *     </span>
+ *   )
+ * }
+ * ```
+ */
+declare function useMNSDisplay(address: string | undefined, config?: MNSClientConfig): {
+    displayName: string;
+    monName: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * On-demand resolver hook: for input fields accepting names or addresses
+ *
+ * @example
+ * ```tsx
+ * function SendForm() {
+ *   const { resolve, address, name, loading, error } = useMNSResolve()
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         placeholder="Address or .mon name"
+ *         onChange={(e) => resolve(e.target.value)}
+ *       />
+ *       {loading && <span>Resolving...</span>}
+ *       {error && <span className="text-red-500">{error}</span>}
+ *       {address && <span className="text-green-500">→ {address}</span>}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useMNSResolve(config?: MNSClientConfig): {
+    resolve: (input: string) => Promise<void>;
+    address: string | null;
+    name: string | null;
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Text record hook: get metadata like avatar, URL, twitter handle
+ *
+ * @example
+ * ```tsx
+ * function Avatar({ name }: { name: string }) {
+ *   const { value } = useMNSText(name, 'avatar')
+ *   return value ? <img src={value} /> : null
+ * }
+ * ```
+ */
+declare function useMNSText(name: string | undefined, key: string, config?: MNSClientConfig): {
+    value: string | null;
+    loading: boolean;
+    error: string | null;
+};
+
+export { type MNSClientConfig, useMNSAddress, useMNSDisplay, useMNSName, useMNSResolve, useMNSText };

package/dist/react.js

@@ -0,0 +1,297 @@
+// src/react.ts
+import { useState, useEffect, useCallback } from "react";
+
+// src/resolve.ts
+import { namehash } from "viem";
+
+// src/client.ts
+import {
+  createPublicClient,
+  http
+} from "viem";
+import { monad } from "viem/chains";
+var defaultClient = null;
+function getMNSClient(config) {
+  if (config?.client) return config.client;
+  if (config?.rpcUrl) {
+    return createPublicClient({
+      chain: monad,
+      transport: http(config.rpcUrl)
+    });
+  }
+  if (!defaultClient) {
+    defaultClient = createPublicClient({
+      chain: monad,
+      transport: http()
+    });
+  }
+  return defaultClient;
+}
+
+// src/constants.ts
+var MNS_REGISTRY = "0x13f963486e741c8d3fcdc0a34a910920339a19ce";
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+var registryAbi = [
+  {
+    name: "resolver",
+    type: "function",
+    inputs: [{ name: "node", type: "bytes32" }],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  }
+];
+var resolverAbi = [
+  {
+    name: "addr",
+    type: "function",
+    inputs: [{ name: "node", type: "bytes32" }],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view"
+  },
+  {
+    name: "name",
+    type: "function",
+    inputs: [{ name: "node", type: "bytes32" }],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  },
+  {
+    name: "text",
+    type: "function",
+    inputs: [
+      { name: "node", type: "bytes32" },
+      { name: "key", type: "string" }
+    ],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view"
+  }
+];
+
+// src/resolve.ts
+var nameCache = /* @__PURE__ */ new Map();
+var addrCache = /* @__PURE__ */ new Map();
+var CACHE_TTL = 6e4;
+function getCached(cache, key) {
+  const entry = cache.get(key);
+  if (entry && Date.now() - entry.ts < CACHE_TTL) return entry.value;
+  return void 0;
+}
+async function resolveName(name, config) {
+  const key = name.toLowerCase();
+  const cached = getCached(addrCache, key);
+  if (cached !== void 0) return cached;
+  try {
+    const client = getMNSClient(config);
+    const node = namehash(key);
+    const resolver = await client.readContract({
+      address: MNS_REGISTRY,
+      abi: registryAbi,
+      functionName: "resolver",
+      args: [node]
+    });
+    if (resolver === ZERO_ADDRESS) {
+      addrCache.set(key, { value: null, ts: Date.now() });
+      return null;
+    }
+    const addr = await client.readContract({
+      address: resolver,
+      abi: resolverAbi,
+      functionName: "addr",
+      args: [node]
+    });
+    const result = addr === ZERO_ADDRESS ? null : addr;
+    addrCache.set(key, { value: result, ts: Date.now() });
+    return result;
+  } catch {
+    addrCache.set(key, { value: null, ts: Date.now() });
+    return null;
+  }
+}
+async function lookupAddress(address, config) {
+  const key = address.toLowerCase();
+  const cached = getCached(nameCache, key);
+  if (cached !== void 0) return cached;
+  try {
+    const client = getMNSClient(config);
+    const reverseNode = namehash(
+      `${key.slice(2)}.addr.reverse`
+    );
+    const resolver = await client.readContract({
+      address: MNS_REGISTRY,
+      abi: registryAbi,
+      functionName: "resolver",
+      args: [reverseNode]
+    });
+    if (resolver === ZERO_ADDRESS) {
+      nameCache.set(key, { value: null, ts: Date.now() });
+      return null;
+    }
+    const name = await client.readContract({
+      address: resolver,
+      abi: resolverAbi,
+      functionName: "name",
+      args: [reverseNode]
+    });
+    const result = name || null;
+    nameCache.set(key, { value: result, ts: Date.now() });
+    return result;
+  } catch {
+    nameCache.set(key, { value: null, ts: Date.now() });
+    return null;
+  }
+}
+async function getTextRecord(name, key, config) {
+  try {
+    const client = getMNSClient(config);
+    const node = namehash(name.toLowerCase());
+    const resolver = await client.readContract({
+      address: MNS_REGISTRY,
+      abi: registryAbi,
+      functionName: "resolver",
+      args: [node]
+    });
+    if (resolver === ZERO_ADDRESS) return null;
+    const value = await client.readContract({
+      address: resolver,
+      abi: resolverAbi,
+      functionName: "text",
+      args: [node, key]
+    });
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
+// src/react.ts
+function useMNSName(address, config) {
+  const [name, setName] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (!address || !address.startsWith("0x") || address.length !== 42) {
+      setName(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    lookupAddress(address, config).then((n) => {
+      if (!cancelled) setName(n);
+    }).catch((e) => {
+      if (!cancelled) setError(e.message);
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [address]);
+  return { name, loading, error };
+}
+function useMNSAddress(name, config) {
+  const [address, setAddress] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (!name) {
+      setAddress(null);
+      return;
+    }
+    const fullName = name.endsWith(".mon") ? name : `${name}.mon`;
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    resolveName(fullName, config).then((a) => {
+      if (!cancelled) setAddress(a);
+    }).catch((e) => {
+      if (!cancelled) setError(e.message);
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [name]);
+  return { address, loading, error };
+}
+function useMNSDisplay(address, config) {
+  const { name, loading, error } = useMNSName(address, config);
+  const truncated = address ? `${address.slice(0, 6)}...${address.slice(-4)}` : "";
+  return {
+    displayName: name || truncated,
+    monName: name,
+    loading,
+    error
+  };
+}
+function useMNSResolve(config) {
+  const [address, setAddress] = useState(null);
+  const [name, setName] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const resolve = useCallback(async (input) => {
+    const trimmed = input.trim();
+    setError(null);
+    if (!trimmed) {
+      setAddress(null);
+      setName(null);
+      return;
+    }
+    if (trimmed.startsWith("0x") && trimmed.length === 42) {
+      setAddress(trimmed);
+      setLoading(true);
+      const n = await lookupAddress(trimmed, config);
+      setName(n);
+      setLoading(false);
+      return;
+    }
+    const fullName = trimmed.endsWith(".mon") ? trimmed : `${trimmed}.mon`;
+    setName(fullName);
+    setLoading(true);
+    try {
+      const addr = await resolveName(fullName, config);
+      setAddress(addr);
+      if (!addr) setError(`${fullName} not found`);
+    } catch (e) {
+      setError(e.message);
+      setAddress(null);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  return { resolve, address, name, loading, error };
+}
+function useMNSText(name, key, config) {
+  const [value, setValue] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (!name) {
+      setValue(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    getTextRecord(name, key, config).then((v) => {
+      if (!cancelled) setValue(v);
+    }).catch((e) => {
+      if (!cancelled) setError(e.message);
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [name, key]);
+  return { value, loading, error };
+}
+export {
+  useMNSAddress,
+  useMNSDisplay,
+  useMNSName,
+  useMNSResolve,
+  useMNSText
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts","../src/resolve.ts","../src/client.ts","../src/constants.ts"],"sourcesContent":["import { useState, useEffect, useCallback } from 'react';\nimport { resolveName, lookupAddress, getTextRecord } from './resolve';\nimport { type MNSClientConfig } from './client';\n\nexport type { MNSClientConfig };\n\n/**\n * Reverse resolution hook: address → .mon name\n *\n * @example\n * ```tsx\n * function Profile({ address }: { address: string }) {\n *   const { name, loading } = useMNSName(address)\n *   return <span>{loading ? '...' : name ?? address}</span>\n * }\n * ```\n */\nexport function useMNSName(\n  address: string | undefined,\n  config?: MNSClientConfig,\n) {\n  const [name, setName] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!address || !address.startsWith('0x') || address.length !== 42) {\n      setName(null);\n      return;\n    }\n\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n\n    lookupAddress(address, config)\n      .then((n) => {\n        if (!cancelled) setName(n);\n      })\n      .catch((e) => {\n        if (!cancelled) setError(e.message);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [address]);\n\n  return { name, loading, error };\n}\n\n/**\n * Forward resolution hook: .mon name → address\n *\n * @example\n * ```tsx\n * function Lookup() {\n *   const { address, loading } = useMNSAddress('alice.mon')\n *   return <span>{loading ? 'Resolving...' : address}</span>\n * }\n * ```\n */\nexport function useMNSAddress(\n  name: string | undefined,\n  config?: MNSClientConfig,\n) {\n  const [address, setAddress] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!name) {\n      setAddress(null);\n      return;\n    }\n    const fullName = name.endsWith('.mon') ? name : `${name}.mon`;\n\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n\n    resolveName(fullName, config)\n      .then((a) => {\n        if (!cancelled) setAddress(a);\n      })\n      .catch((e) => {\n        if (!cancelled) setError(e.message);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [name]);\n\n  return { address, loading, error };\n}\n\n/**\n * Display name hook: .mon name if available, otherwise truncated address\n *\n * @example\n * ```tsx\n * function Badge({ address }: { address: string }) {\n *   const { displayName, monName } = useMNSDisplay(address)\n *   return (\n *     <span className={monName ? 'text-purple-400' : 'text-gray-500'}>\n *       {displayName}\n *     </span>\n *   )\n * }\n * ```\n */\nexport function useMNSDisplay(\n  address: string | undefined,\n  config?: MNSClientConfig,\n) {\n  const { name, loading, error } = useMNSName(address, config);\n  const truncated = address\n    ? `${address.slice(0, 6)}...${address.slice(-4)}`\n    : '';\n\n  return {\n    displayName: name || truncated,\n    monName: name,\n    loading,\n    error,\n  };\n}\n\n/**\n * On-demand resolver hook: for input fields accepting names or addresses\n *\n * @example\n * ```tsx\n * function SendForm() {\n *   const { resolve, address, name, loading, error } = useMNSResolve()\n *\n *   return (\n *     <div>\n *       <input\n *         placeholder=\"Address or .mon name\"\n *         onChange={(e) => resolve(e.target.value)}\n *       />\n *       {loading && <span>Resolving...</span>}\n *       {error && <span className=\"text-red-500\">{error}</span>}\n *       {address && <span className=\"text-green-500\">→ {address}</span>}\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useMNSResolve(config?: MNSClientConfig) {\n  const [address, setAddress] = useState<string | null>(null);\n  const [name, setName] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const resolve = useCallback(async (input: string) => {\n    const trimmed = input.trim();\n    setError(null);\n\n    if (!trimmed) {\n      setAddress(null);\n      setName(null);\n      return;\n    }\n\n    // Direct address\n    if (trimmed.startsWith('0x') && trimmed.length === 42) {\n      setAddress(trimmed);\n      setLoading(true);\n      const n = await lookupAddress(trimmed, config);\n      setName(n);\n      setLoading(false);\n      return;\n    }\n\n    // Name input\n    const fullName = trimmed.endsWith('.mon') ? trimmed : `${trimmed}.mon`;\n    setName(fullName);\n    setLoading(true);\n\n    try {\n      const addr = await resolveName(fullName, config);\n      setAddress(addr);\n      if (!addr) setError(`${fullName} not found`);\n    } catch (e: any) {\n      setError(e.message);\n      setAddress(null);\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  return { resolve, address, name, loading, error };\n}\n\n/**\n * Text record hook: get metadata like avatar, URL, twitter handle\n *\n * @example\n * ```tsx\n * function Avatar({ name }: { name: string }) {\n *   const { value } = useMNSText(name, 'avatar')\n *   return value ? <img src={value} /> : null\n * }\n * ```\n */\nexport function useMNSText(\n  name: string | undefined,\n  key: string,\n  config?: MNSClientConfig,\n) {\n  const [value, setValue] = useState<string | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (!name) {\n      setValue(null);\n      return;\n    }\n\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n\n    getTextRecord(name, key, config)\n      .then((v) => {\n        if (!cancelled) setValue(v);\n      })\n      .catch((e) => {\n        if (!cancelled) setError(e.message);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [name, key]);\n\n  return { value, loading, error };\n}\n","import { namehash } from 'viem';\nimport { getMNSClient, type MNSClientConfig } from './client';\nimport {\n  MNS_REGISTRY,\n  ZERO_ADDRESS,\n  registryAbi,\n  resolverAbi,\n} from './constants';\n\n// ─── Cache ─────────────────────────────────────────────────────\n\nconst nameCache = new Map<string, { value: string | null; ts: number }>();\nconst addrCache = new Map<string, { value: string | null; ts: number }>();\n\nconst CACHE_TTL = 60_000; // 1 minute\n\nfunction getCached(\n  cache: Map<string, { value: string | null; ts: number }>,\n  key: string,\n) {\n  const entry = cache.get(key);\n  if (entry && Date.now() - entry.ts < CACHE_TTL) return entry.value;\n  return undefined;\n}\n\n// ─── Forward Resolution ────────────────────────────────────────\n\n/**\n * Resolve a .mon name to an address.\n *\n * @param name - Full name including .mon (e.g. \"alice.mon\")\n * @param config - Optional client configuration\n * @returns The resolved address, or null if not found\n *\n * @example\n * ```ts\n * import { resolveName } from '@monadns/sdk'\n *\n * const address = await resolveName('alice.mon')\n * // '0xa05a8BF1eda5bbC2b3aCAF03D04f77bD7d66Cc47'\n * ```\n */\nexport async function resolveName(\n  name: string,\n  config?: MNSClientConfig,\n): Promise<string | null> {\n  const key = name.toLowerCase();\n  const cached = getCached(addrCache, key);\n  if (cached !== undefined) return cached;\n\n  try {\n    const client = getMNSClient(config);\n    const node = namehash(key) as `0x${string}`;\n\n    const resolver = await client.readContract({\n      address: MNS_REGISTRY,\n      abi: registryAbi,\n      functionName: 'resolver',\n      args: [node],\n    });\n\n    if (resolver === ZERO_ADDRESS) {\n      addrCache.set(key, { value: null, ts: Date.now() });\n      return null;\n    }\n\n    const addr = await client.readContract({\n      address: resolver,\n      abi: resolverAbi,\n      functionName: 'addr',\n      args: [node],\n    });\n\n    const result = addr === ZERO_ADDRESS ? null : addr;\n    addrCache.set(key, { value: result, ts: Date.now() });\n    return result;\n  } catch {\n    addrCache.set(key, { value: null, ts: Date.now() });\n    return null;\n  }\n}\n\n// ─── Reverse Resolution ────────────────────────────────────────\n\n/**\n * Look up the primary .mon name for an address.\n *\n * @param address - A 0x-prefixed Monad address\n * @param config - Optional client configuration\n * @returns The primary name (e.g. \"alice.mon\"), or null\n *\n * @example\n * ```ts\n * import { lookupAddress } from '@monadns/sdk'\n *\n * const name = await lookupAddress('0xa05a8BF1...')\n * // 'alice.mon'\n * ```\n */\nexport async function lookupAddress(\n  address: string,\n  config?: MNSClientConfig,\n): Promise<string | null> {\n  const key = address.toLowerCase();\n  const cached = getCached(nameCache, key);\n  if (cached !== undefined) return cached;\n\n  try {\n    const client = getMNSClient(config);\n    const reverseNode = namehash(\n      `${key.slice(2)}.addr.reverse`,\n    ) as `0x${string}`;\n\n    const resolver = await client.readContract({\n      address: MNS_REGISTRY,\n      abi: registryAbi,\n      functionName: 'resolver',\n      args: [reverseNode],\n    });\n\n    if (resolver === ZERO_ADDRESS) {\n      nameCache.set(key, { value: null, ts: Date.now() });\n      return null;\n    }\n\n    const name = await client.readContract({\n      address: resolver,\n      abi: resolverAbi,\n      functionName: 'name',\n      args: [reverseNode],\n    });\n\n    const result = name || null;\n    nameCache.set(key, { value: result, ts: Date.now() });\n    return result;\n  } catch {\n    nameCache.set(key, { value: null, ts: Date.now() });\n    return null;\n  }\n}\n\n// ─── Text Records ──────────────────────────────────────────────\n\n/**\n * Get a text record for a .mon name.\n *\n * @param name - Full name including .mon\n * @param key - The text record key (e.g. \"avatar\", \"url\", \"com.twitter\")\n * @param config - Optional client configuration\n *\n * @example\n * ```ts\n * const avatar = await getTextRecord('alice.mon', 'avatar')\n * const twitter = await getTextRecord('alice.mon', 'com.twitter')\n * ```\n */\nexport async function getTextRecord(\n  name: string,\n  key: string,\n  config?: MNSClientConfig,\n): Promise<string | null> {\n  try {\n    const client = getMNSClient(config);\n    const node = namehash(name.toLowerCase()) as `0x${string}`;\n\n    const resolver = await client.readContract({\n      address: MNS_REGISTRY,\n      abi: registryAbi,\n      functionName: 'resolver',\n      args: [node],\n    });\n\n    if (resolver === ZERO_ADDRESS) return null;\n\n    const value = await client.readContract({\n      address: resolver,\n      abi: resolverAbi,\n      functionName: 'text',\n      args: [node, key],\n    });\n\n    return value || null;\n  } catch {\n    return null;\n  }\n}\n\n// ─── Helpers ───────────────────────────────────────────────────\n\n/**\n * Get a display-friendly name for an address.\n * Returns the .mon name if set, otherwise a truncated address.\n *\n * @example\n * ```ts\n * const display = await getDisplayName('0xa05a8BF1...')\n * // 'alice.mon' or '0xa05a...Cc47'\n * ```\n */\nexport async function getDisplayName(\n  address: string,\n  config?: MNSClientConfig,\n): Promise<string> {\n  const name = await lookupAddress(address, config);\n  if (name) return name;\n  return `${address.slice(0, 6)}...${address.slice(-4)}`;\n}\n\n/**\n * Smart resolver — accepts either a .mon name or a raw address.\n * Useful for input fields where users can type either.\n *\n * @returns The resolved address, or null if invalid/not found\n *\n * @example\n * ```ts\n * const addr = await resolveInput('alice.mon')   // resolves name\n * const addr = await resolveInput('alice')        // tries alice.mon\n * const addr = await resolveInput('0xa05a...')    // passes through\n * ```\n */\nexport async function resolveInput(\n  input: string,\n  config?: MNSClientConfig,\n): Promise<string | null> {\n  const trimmed = input.trim();\n  if (!trimmed) return null;\n\n  if (trimmed.startsWith('0x') && trimmed.length === 42) return trimmed;\n  if (trimmed.endsWith('.mon')) return resolveName(trimmed, config);\n\n  // Try appending .mon\n  return resolveName(`${trimmed}.mon`, config);\n}\n\n/**\n * Check if a .mon name is registered.\n *\n * @example\n * ```ts\n * const taken = await isRegistered('alice.mon')\n * ```\n */\nexport async function isRegistered(\n  name: string,\n  config?: MNSClientConfig,\n): Promise<boolean> {\n  const addr = await resolveName(name, config);\n  return addr !== null;\n}\n\n/**\n * Clear the internal resolution cache.\n * Useful after a new registration.\n */\nexport function clearCache() {\n  nameCache.clear();\n  addrCache.clear();\n}\n","import {\n  createPublicClient,\n  http,\n  type PublicClient,\n  type Chain,\n  type Transport,\n} from 'viem';\nimport { monad } from 'viem/chains';\n\nexport type MNSClientConfig = {\n  /** Custom RPC URL. Defaults to the public Monad RPC. */\n  rpcUrl?: string;\n  /** Existing viem PublicClient to reuse instead of creating a new one. */\n  client?: PublicClient<Transport, Chain>;\n};\n\nlet defaultClient: PublicClient<Transport, Chain> | null = null;\n\n/**\n * Get or create the MNS public client.\n * Reuses a singleton by default; pass config to override.\n */\nexport function getMNSClient(\n  config?: MNSClientConfig,\n): PublicClient<Transport, Chain> {\n  if (config?.client) return config.client;\n\n  if (config?.rpcUrl) {\n    return createPublicClient({\n      chain: monad,\n      transport: http(config.rpcUrl),\n    });\n  }\n\n  if (!defaultClient) {\n    defaultClient = createPublicClient({\n      chain: monad,\n      transport: http(),\n    });\n  }\n\n  return defaultClient;\n}\n","export const MNS_REGISTRY =\n  '0x13f963486e741c8d3fcdc0a34a910920339a19ce' as const;\nexport const MNS_PUBLIC_RESOLVER =\n  '0xa2eb94c88e55d944aced2066c5cec9b759801f97' as const;\n\nexport const ZERO_ADDRESS =\n  '0x0000000000000000000000000000000000000000' as const;\n\nexport const registryAbi = [\n  {\n    name: 'resolver',\n    type: 'function',\n    inputs: [{ name: 'node', type: 'bytes32' }],\n    outputs: [{ name: '', type: 'address' }],\n    stateMutability: 'view',\n  },\n] as const;\n\nexport const resolverAbi = [\n  {\n    name: 'addr',\n    type: 'function',\n    inputs: [{ name: 'node', type: 'bytes32' }],\n    outputs: [{ name: '', type: 'address' }],\n    stateMutability: 'view',\n  },\n  {\n    name: 'name',\n    type: 'function',\n    inputs: [{ name: 'node', type: 'bytes32' }],\n    outputs: [{ name: '', type: 'string' }],\n    stateMutability: 'view',\n  },\n  {\n    name: 'text',\n    type: 'function',\n    inputs: [\n      { name: 'node', type: 'bytes32' },\n      { name: 'key', type: 'string' },\n    ],\n    outputs: [{ name: '', type: 'string' }],\n    stateMutability: 'view',\n  },\n] as const;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@monadns/sdk",
+  "version": "1.0.0",
+  "description": "Monad Name Service SDK — resolve .mon names on Monad",
+  "author": "Monad Name Service",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/monadns/sdk"
+  },
+  "keywords": [
+    "monad",
+    "ens",
+    "name-service",
+    "web3",
+    "dns",
+    ".mon"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "viem": "^2.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "react": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}