@monadns/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Monad Name Service
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# @monadns/sdk
+
+Resolve **.mon** names on the Monad network. The official SDK for the Monad Name Service.
+
+## Install
+
+```bash
+npm install @monadns/sdk viem
+```
+
+## Quick Start
+
+```typescript
+import { resolveName, lookupAddress } from '@monadns/sdk';
+
+// Forward: name → address
+const address = await resolveName('alice.mon');
+// '0xa0123BF1eda5bbC2b3aCAF03D04f77bD7d66Cc47'
+
+// Reverse: address → name
+const name = await lookupAddress('0xa0123BF1eda5bbC2b3aCAF03D04f77bD7d66Cc47');
+// 'alice.mon'
+```
+
+## React Hooks
+
+```bash
+npm install @monadns/sdk viem react
+```
+
+```tsx
+import { useMNSDisplay, useMNSResolve } from '@monadns/sdk/react';
+
+// Display .mon name instead of address
+function UserBadge({ address }: { address: string }) {
+  const { displayName, monName } = useMNSDisplay(address);
+  return <span className={monName ? 'font-bold' : ''}>{displayName}</span>;
+}
+
+// Input field that accepts names or addresses
+function RecipientInput() {
+  const { resolve, address, loading, error } = useMNSResolve();
+  return (
+    <div>
+      <input
+        placeholder="Address or .mon name"
+        onChange={(e) => resolve(e.target.value)}
+      />
+      {loading && <span>Resolving...</span>}
+      {address && <span>→ {address}</span>}
+      {error && <span>{error}</span>}
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### Core Functions
+
+| Function                   | Description                              |
+| -------------------------- | ---------------------------------------- |
+| `resolveName(name)`        | Forward resolve: `alice.mon` → `0x...`   |
+| `lookupAddress(address)`   | Reverse resolve: `0x...` → `alice.mon`   |
+| `getDisplayName(address)`  | Returns `.mon` name or truncated address |
+| `resolveInput(input)`      | Accepts name or address, returns address |
+| `getTextRecord(name, key)` | Get text record (avatar, url, etc.)      |
+| `isRegistered(name)`       | Check if a name is taken                 |
+| `clearCache()`             | Clear the resolution cache               |
+
+### React Hooks
+
+| Hook                     | Description                                  |
+| ------------------------ | -------------------------------------------- |
+| `useMNSName(address)`    | `{ name, loading, error }`                   |
+| `useMNSAddress(name)`    | `{ address, loading, error }`                |
+| `useMNSDisplay(address)` | `{ displayName, monName, loading }`          |
+| `useMNSResolve()`        | `{ resolve, address, name, loading, error }` |
+| `useMNSText(name, key)`  | `{ value, loading, error }`                  |
+
+### Custom RPC
+
+All functions accept an optional config object:
+
+```typescript
+const name = await lookupAddress('0x...', {
+  rpcUrl: 'https://your-custom-rpc.com',
+});
+```
+
+Or pass an existing viem client:
+
+```typescript
+import { createPublicClient, http } from 'viem';
+import { monad } from 'viem/chains';
+
+const client = createPublicClient({ chain: monad, transport: http() });
+const name = await lookupAddress('0x...', { client });
+```
+
+## Contracts
+
+| Contract        | Address                                      |
+| --------------- | -------------------------------------------- |
+| Registry        | `0x13f963486e741c8d3fcdc0a34a910920339a19ce` |
+| Public Resolver | `0xa2eb94c88e55d944aced2066c5cec9b759801f97` |
+
+Chain: Monad Mainnet (Chain ID 143)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,228 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  MNS_PUBLIC_RESOLVER: () => MNS_PUBLIC_RESOLVER,
+  MNS_REGISTRY: () => MNS_REGISTRY,
+  clearCache: () => clearCache,
+  getDisplayName: () => getDisplayName,
+  getMNSClient: () => getMNSClient,
+  getTextRecord: () => getTextRecord,
+  isRegistered: () => isRegistered,
+  lookupAddress: () => lookupAddress,
+  resolveInput: () => resolveInput,
+  resolveName: () => resolveName
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/resolve.ts
+var import_viem2 = require("viem");
+
+// src/client.ts
+var import_viem = require("viem");
+var import_chains = require("viem/chains");
+var defaultClient = null;
+function getMNSClient(config) {
+  if (config?.client) return config.client;
+  if (config?.rpcUrl) {
+    return (0, import_viem.createPublicClient)({
+      chain: import_chains.monad,
+      transport: (0, import_viem.http)(config.rpcUrl)
+    });
+  }
+  if (!defaultClient) {
+    defaultClient = (0, import_viem.createPublicClient)({
+      chain: import_chains.monad,
+      transport: (0, import_viem.http)()
+    });
+  }
+  return defaultClient;
+}
+
+// src/constants.ts
+var MNS_REGISTRY = "0x13f963486e741c8d3fcdc0a34a910920339a19ce";
+var MNS_PUBLIC_RESOLVER = "0xa2eb94c88e55d944aced2066c5cec9b759801f97";
+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 = (0, import_viem2.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 = (0, import_viem2.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 = (0, import_viem2.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;
+  }
+}
+async function getDisplayName(address, config) {
+  const name = await lookupAddress(address, config);
+  if (name) return name;
+  return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+async function resolveInput(input, config) {
+  const trimmed = input.trim();
+  if (!trimmed) return null;
+  if (trimmed.startsWith("0x") && trimmed.length === 42) return trimmed;
+  if (trimmed.endsWith(".mon")) return resolveName(trimmed, config);
+  return resolveName(`${trimmed}.mon`, config);
+}
+async function isRegistered(name, config) {
+  const addr = await resolveName(name, config);
+  return addr !== null;
+}
+function clearCache() {
+  nameCache.clear();
+  addrCache.clear();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MNS_PUBLIC_RESOLVER,
+  MNS_REGISTRY,
+  clearCache,
+  getDisplayName,
+  getMNSClient,
+  getTextRecord,
+  isRegistered,
+  lookupAddress,
+  resolveInput,
+  resolveName
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/resolve.ts","../src/client.ts","../src/constants.ts"],"sourcesContent":["// Core resolution\nexport {\n  resolveName,\n  lookupAddress,\n  getTextRecord,\n  getDisplayName,\n  resolveInput,\n  isRegistered,\n  clearCache,\n} from './resolve';\n\n// Client config\nexport { getMNSClient } from './client';\nexport type { MNSClientConfig } from './client';\n\n// Constants\nexport { MNS_REGISTRY, MNS_PUBLIC_RESOLVER } from './constants';\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":["import_viem"]}

package/dist/index.d.cts

@@ -0,0 +1,104 @@
+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>;
+};
+/**
+ * Get or create the MNS public client.
+ * Reuses a singleton by default; pass config to override.
+ */
+declare function getMNSClient(config?: MNSClientConfig): PublicClient<Transport, Chain>;
+
+/**
+ * Resolve a .mon name to an address.
+ *
+ * @param name - Full name including .mon (e.g. "alice.mon")
+ * @param config - Optional client configuration
+ * @returns The resolved address, or null if not found
+ *
+ * @example
+ * ```ts
+ * import { resolveName } from '@monadns/sdk'
+ *
+ * const address = await resolveName('alice.mon')
+ * // '0xa05a8BF1eda5bbC2b3aCAF03D04f77bD7d66Cc47'
+ * ```
+ */
+declare function resolveName(name: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Look up the primary .mon name for an address.
+ *
+ * @param address - A 0x-prefixed Monad address
+ * @param config - Optional client configuration
+ * @returns The primary name (e.g. "alice.mon"), or null
+ *
+ * @example
+ * ```ts
+ * import { lookupAddress } from '@monadns/sdk'
+ *
+ * const name = await lookupAddress('0xa05a8BF1...')
+ * // 'alice.mon'
+ * ```
+ */
+declare function lookupAddress(address: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Get a text record for a .mon name.
+ *
+ * @param name - Full name including .mon
+ * @param key - The text record key (e.g. "avatar", "url", "com.twitter")
+ * @param config - Optional client configuration
+ *
+ * @example
+ * ```ts
+ * const avatar = await getTextRecord('alice.mon', 'avatar')
+ * const twitter = await getTextRecord('alice.mon', 'com.twitter')
+ * ```
+ */
+declare function getTextRecord(name: string, key: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Get a display-friendly name for an address.
+ * Returns the .mon name if set, otherwise a truncated address.
+ *
+ * @example
+ * ```ts
+ * const display = await getDisplayName('0xa05a8BF1...')
+ * // 'alice.mon' or '0xa05a...Cc47'
+ * ```
+ */
+declare function getDisplayName(address: string, config?: MNSClientConfig): Promise<string>;
+/**
+ * Smart resolver — accepts either a .mon name or a raw address.
+ * Useful for input fields where users can type either.
+ *
+ * @returns The resolved address, or null if invalid/not found
+ *
+ * @example
+ * ```ts
+ * const addr = await resolveInput('alice.mon')   // resolves name
+ * const addr = await resolveInput('alice')        // tries alice.mon
+ * const addr = await resolveInput('0xa05a...')    // passes through
+ * ```
+ */
+declare function resolveInput(input: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Check if a .mon name is registered.
+ *
+ * @example
+ * ```ts
+ * const taken = await isRegistered('alice.mon')
+ * ```
+ */
+declare function isRegistered(name: string, config?: MNSClientConfig): Promise<boolean>;
+/**
+ * Clear the internal resolution cache.
+ * Useful after a new registration.
+ */
+declare function clearCache(): void;
+
+declare const MNS_REGISTRY: "0x13f963486e741c8d3fcdc0a34a910920339a19ce";
+declare const MNS_PUBLIC_RESOLVER: "0xa2eb94c88e55d944aced2066c5cec9b759801f97";
+
+export { type MNSClientConfig, MNS_PUBLIC_RESOLVER, MNS_REGISTRY, clearCache, getDisplayName, getMNSClient, getTextRecord, isRegistered, lookupAddress, resolveInput, resolveName };

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+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>;
+};
+/**
+ * Get or create the MNS public client.
+ * Reuses a singleton by default; pass config to override.
+ */
+declare function getMNSClient(config?: MNSClientConfig): PublicClient<Transport, Chain>;
+
+/**
+ * Resolve a .mon name to an address.
+ *
+ * @param name - Full name including .mon (e.g. "alice.mon")
+ * @param config - Optional client configuration
+ * @returns The resolved address, or null if not found
+ *
+ * @example
+ * ```ts
+ * import { resolveName } from '@monadns/sdk'
+ *
+ * const address = await resolveName('alice.mon')
+ * // '0xa05a8BF1eda5bbC2b3aCAF03D04f77bD7d66Cc47'
+ * ```
+ */
+declare function resolveName(name: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Look up the primary .mon name for an address.
+ *
+ * @param address - A 0x-prefixed Monad address
+ * @param config - Optional client configuration
+ * @returns The primary name (e.g. "alice.mon"), or null
+ *
+ * @example
+ * ```ts
+ * import { lookupAddress } from '@monadns/sdk'
+ *
+ * const name = await lookupAddress('0xa05a8BF1...')
+ * // 'alice.mon'
+ * ```
+ */
+declare function lookupAddress(address: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Get a text record for a .mon name.
+ *
+ * @param name - Full name including .mon
+ * @param key - The text record key (e.g. "avatar", "url", "com.twitter")
+ * @param config - Optional client configuration
+ *
+ * @example
+ * ```ts
+ * const avatar = await getTextRecord('alice.mon', 'avatar')
+ * const twitter = await getTextRecord('alice.mon', 'com.twitter')
+ * ```
+ */
+declare function getTextRecord(name: string, key: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Get a display-friendly name for an address.
+ * Returns the .mon name if set, otherwise a truncated address.
+ *
+ * @example
+ * ```ts
+ * const display = await getDisplayName('0xa05a8BF1...')
+ * // 'alice.mon' or '0xa05a...Cc47'
+ * ```
+ */
+declare function getDisplayName(address: string, config?: MNSClientConfig): Promise<string>;
+/**
+ * Smart resolver — accepts either a .mon name or a raw address.
+ * Useful for input fields where users can type either.
+ *
+ * @returns The resolved address, or null if invalid/not found
+ *
+ * @example
+ * ```ts
+ * const addr = await resolveInput('alice.mon')   // resolves name
+ * const addr = await resolveInput('alice')        // tries alice.mon
+ * const addr = await resolveInput('0xa05a...')    // passes through
+ * ```
+ */
+declare function resolveInput(input: string, config?: MNSClientConfig): Promise<string | null>;
+/**
+ * Check if a .mon name is registered.
+ *
+ * @example
+ * ```ts
+ * const taken = await isRegistered('alice.mon')
+ * ```
+ */
+declare function isRegistered(name: string, config?: MNSClientConfig): Promise<boolean>;
+/**
+ * Clear the internal resolution cache.
+ * Useful after a new registration.
+ */
+declare function clearCache(): void;
+
+declare const MNS_REGISTRY: "0x13f963486e741c8d3fcdc0a34a910920339a19ce";
+declare const MNS_PUBLIC_RESOLVER: "0xa2eb94c88e55d944aced2066c5cec9b759801f97";
+
+export { type MNSClientConfig, MNS_PUBLIC_RESOLVER, MNS_REGISTRY, clearCache, getDisplayName, getMNSClient, getTextRecord, isRegistered, lookupAddress, resolveInput, resolveName };