@1001-digital/ethereum-names 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 1001.digital
+
+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,126 @@
+# @1001-digital/ethereum-names
+
+One clean, [viem](https://viem.sh)-powered API to resolve Ethereum names across both
+[ENS](https://ens.domains) and the [Gwei Name Service](https://gwei.domains) (GNS).
+
+Point it at a name — `vitalik.eth` or `alice.gwei` — and it figures out which system to
+ask. Point it at an address and it gives you back the primary name. No branching in your
+app code.
+
+## Install
+
+```bash
+npm install @1001-digital/ethereum-names viem
+```
+
+`viem` is a peer dependency.
+
+## Usage
+
+```ts
+import { createEthereumNames } from '@1001-digital/ethereum-names'
+
+const names = createEthereumNames()
+
+// Forward: name → address (the system is detected from the name)
+await names.resolve('vitalik.eth')    // ENS → '0xd8dA...' | null
+await names.resolve('alice.gwei')     // GNS → '0x...'    | null
+await names.resolve('alice')          // bare label → treated as alice.gwei
+await names.resolve('0xd8dA...')      // address → returned checksummed
+
+// Reverse: address → primary name (tries ENS, then GNS)
+await names.reverse('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
+// => 'vitalik.eth' | 'alice.gwei' | null
+
+// Reverse across BOTH systems at once (when an address has names in each)
+await names.reverseAll('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
+// => { ens: 'vitalik.eth', gns: 'vitalik.gwei' }
+
+// Rich lookup: resolve or reverse, and learn which system answered
+await names.lookup('alice.gwei')
+// => { input: 'alice.gwei', name: 'alice.gwei', address: '0x...', system: 'gns' }
+
+// Records work across both systems
+await names.getAvatar('vitalik.eth')
+await names.getText('alice.gwei', 'url')
+
+// Pure, offline system detection
+names.system('alice.gwei') // 'gns'
+names.system('foo.eth')    // 'ens'
+```
+
+## How resolution is routed
+
+| Input                       | System |
+| --------------------------- | ------ |
+| `*.gwei`                    | GNS    |
+| bare label (no dot)         | GNS    |
+| any other dotted name `*.eth`, `*.box`, … | ENS |
+| `0x…` address               | passed through (checksummed) |
+
+Reverse lookups try each system in order (ENS first by default) and return the first
+match. Configure the order with `reversePriority`, or use `reverseAll` to get the primary
+name from **both** systems at once.
+
+By default, reverse lookups are **forward-verified**: after reading an address's primary
+name, the library resolves that name back and confirms it points to the same address
+before trusting it. This guards against spoofed reverse records (ENS reverse records are
+not self-validating). Disable with `verify: false` to save a round-trip.
+
+## Configuration
+
+```ts
+import { createEthereumNames } from '@1001-digital/ethereum-names'
+import { createPublicClient, http } from 'viem'
+import { mainnet } from 'viem/chains'
+
+// Bring your own viem client (recommended for production)
+const client = createPublicClient({ chain: mainnet, transport: http('https://my-rpc') })
+const names = createEthereumNames({ client })
+
+// …or let the library create a mainnet client for you
+const quick = createEthereumNames({ rpcUrl: 'https://my-rpc' })
+
+// Prefer GNS names on reverse lookups
+const gnsFirst = createEthereumNames({ reversePriority: ['gns', 'ens'] })
+```
+
+| Option            | Type                  | Description                                                           |
+| ----------------- | --------------------- | -------------------------------------------------------------------- |
+| `client`          | `PublicClient`        | A viem client to read from. Its chain must have ENS contracts.       |
+| `rpcUrl`          | `string`              | RPC endpoint used when no `client` is given.                         |
+| `chain`           | `Chain`               | Chain used when no `client` is given. Defaults to `mainnet`.         |
+| `gnsContract`     | `Address`             | Override the GNS contract address.                                   |
+| `reversePriority` | `('ens' \| 'gns')[]`  | Order reverse lookups try each system. Defaults to `['ens', 'gns']`. |
+| `verify`          | `boolean`             | Forward-verify reverse lookups before trusting them. Defaults to `true`. |
+
+> **Note:** ENS resolution relies on viem's ENS actions, which require a chain with ENS
+> contracts configured (such as `mainnet`). GNS is live at the same address on Ethereum
+> mainnet and Sepolia.
+
+## API
+
+### `createEthereumNames(config?) → EthereumNames`
+
+| Method                  | Returns                       | Description                                              |
+| ----------------------- | ----------------------------- | ------------------------------------------------------- |
+| `resolve(nameOrAddress)`| `Promise<Address \| null>`    | Name → address. Addresses pass through, checksummed.    |
+| `reverse(address)`      | `Promise<string \| null>`     | Address → primary name across systems.                  |
+| `reverseAll(address)`   | `Promise<ReverseNames>`       | Address → `{ ens, gns }` primary names from both systems.|
+| `lookup(input)`         | `Promise<ResolvedName>`       | Resolve or reverse, with the answering `system`.        |
+| `getAvatar(name)`       | `Promise<string \| null>`     | Avatar record (ENS avatar, or GNS `avatar` text).       |
+| `getText(name, key)`    | `Promise<string \| null>`     | Arbitrary text record.                                  |
+| `system(name)`          | `'ens' \| 'gns' \| null`      | Offline system detection.                               |
+| `client`                | `PublicClient`                | The underlying viem client.                             |
+
+Also exported: `detectSystem(name)`, `DEFAULT_GNS_CONTRACT`, and the types
+`EthereumNames`, `EthereumNamesConfig`, `NameSystem`, `ResolvedName`, `ReverseNames`.
+
+## Credits
+
+GNS resolution builds on [`@donnoh/gns-utils`](https://www.npmjs.com/package/@donnoh/gns-utils)
+by [lucadonnoh](https://github.com/lucadonnoh/gwei-names).
+
+## License
+
+MIT © [1001.digital](https://1001.digital)

package/dist/index.cjs

@@ -0,0 +1,194 @@
+'use strict';
+
+var gnsUtils = require('@donnoh/gns-utils');
+var viem = require('viem');
+var chains = require('viem/chains');
+var actions = require('viem/actions');
+var ens = require('viem/ens');
+
+// src/client.ts
+function detectSystem(input) {
+  const value = input.trim().toLowerCase();
+  if (!value) return null;
+  if (value.endsWith(".gwei")) return "gns";
+  if (value.includes(".")) return "ens";
+  return "gns";
+}
+function safeNormalizeEns(name) {
+  try {
+    return ens.normalize(name);
+  } catch {
+    return null;
+  }
+}
+
+// src/ens.ts
+async function ensResolve(client, name) {
+  const normalized = safeNormalizeEns(name);
+  if (!normalized) return null;
+  return actions.getEnsAddress(client, { name: normalized });
+}
+function ensReverse(client, address) {
+  return actions.getEnsName(client, { address });
+}
+async function ensAvatar(client, name) {
+  const normalized = safeNormalizeEns(name);
+  if (!normalized) return null;
+  return actions.getEnsAvatar(client, { name: normalized });
+}
+async function ensText(client, name, key) {
+  const normalized = safeNormalizeEns(name);
+  if (!normalized) return null;
+  return actions.getEnsText(client, { name: normalized, key });
+}
+var DEFAULT_GNS_CONTRACT = gnsUtils.GNS_CONTRACT;
+function tokenId(client, contract, name) {
+  return actions.readContract(client, {
+    address: contract,
+    abi: gnsUtils.gnsAbi,
+    functionName: "computeId",
+    args: [gnsUtils.normalizeName(name)]
+  });
+}
+async function gnsResolve(client, contract, name) {
+  const id = await tokenId(client, contract, name);
+  if (id === 0n) return null;
+  const addr = await actions.readContract(client, {
+    address: contract,
+    abi: gnsUtils.gnsAbi,
+    functionName: "resolve",
+    args: [id]
+  });
+  if (!addr || viem.isAddressEqual(addr, viem.zeroAddress)) return null;
+  return viem.getAddress(addr);
+}
+async function gnsReverse(client, contract, address) {
+  const name = await actions.readContract(client, {
+    address: contract,
+    abi: gnsUtils.gnsAbi,
+    functionName: "reverseResolve",
+    args: [address]
+  });
+  return name || null;
+}
+async function gnsText(client, contract, name, key) {
+  const id = await tokenId(client, contract, name);
+  if (id === 0n) return null;
+  const value = await actions.readContract(client, {
+    address: contract,
+    abi: gnsUtils.gnsAbi,
+    functionName: "text",
+    args: [id, key]
+  });
+  return value || null;
+}
+
+// src/client.ts
+function createEthereumNames(config = {}) {
+  const client = config.client ?? viem.createPublicClient({
+    chain: config.chain ?? chains.mainnet,
+    transport: viem.http(config.rpcUrl)
+  });
+  const gnsContract = config.gnsContract ?? DEFAULT_GNS_CONTRACT;
+  const reversePriority = config.reversePriority ?? ["ens", "gns"];
+  const verify = config.verify ?? true;
+  function canonical(name, system) {
+    if (system === "gns") return gnsUtils.normalizeName(name);
+    if (system === "ens") return safeNormalizeEns(name);
+    return null;
+  }
+  async function resolveName(name, system) {
+    try {
+      if (system === "ens") return await ensResolve(client, name);
+      return await gnsResolve(client, gnsContract, name);
+    } catch {
+      return null;
+    }
+  }
+  async function rawReverse(system, address) {
+    try {
+      if (system === "ens") return await ensReverse(client, address);
+      return await gnsReverse(client, gnsContract, address);
+    } catch {
+      return null;
+    }
+  }
+  async function reverseFor(system, address) {
+    const name = await rawReverse(system, address);
+    if (!name) return null;
+    if (!verify) return name;
+    const forward = await resolveName(name, system);
+    return forward && viem.isAddressEqual(forward, address) ? name : null;
+  }
+  return {
+    client,
+    system(name) {
+      return detectSystem(name);
+    },
+    async resolve(nameOrAddress) {
+      if (!nameOrAddress) return null;
+      if (viem.isAddress(nameOrAddress)) return viem.getAddress(nameOrAddress);
+      const system = detectSystem(nameOrAddress);
+      if (!system) return null;
+      return resolveName(nameOrAddress, system);
+    },
+    async reverse(address) {
+      if (!viem.isAddress(address)) return null;
+      const checksummed = viem.getAddress(address);
+      for (const system of reversePriority) {
+        const name = await reverseFor(system, checksummed);
+        if (name) return name;
+      }
+      return null;
+    },
+    async reverseAll(address) {
+      if (!viem.isAddress(address)) return { ens: null, gns: null };
+      const checksummed = viem.getAddress(address);
+      const [ens, gns] = await Promise.all([
+        reverseFor("ens", checksummed),
+        reverseFor("gns", checksummed)
+      ]);
+      return { ens, gns };
+    },
+    async lookup(input) {
+      if (viem.isAddress(input)) {
+        const address2 = viem.getAddress(input);
+        for (const system2 of reversePriority) {
+          const name = await reverseFor(system2, address2);
+          if (name) return { input, name, address: address2, system: system2 };
+        }
+        return { input, name: null, address: address2, system: null };
+      }
+      const system = detectSystem(input);
+      if (!system) return { input, name: null, address: null, system: null };
+      const address = await resolveName(input, system);
+      return { input, name: canonical(input, system), address, system };
+    },
+    async getAvatar(name) {
+      const system = detectSystem(name);
+      try {
+        if (system === "ens") return await ensAvatar(client, name);
+        if (system === "gns") return await gnsText(client, gnsContract, name, "avatar");
+      } catch {
+        return null;
+      }
+      return null;
+    },
+    async getText(name, key) {
+      const system = detectSystem(name);
+      try {
+        if (system === "ens") return await ensText(client, name, key);
+        if (system === "gns") return await gnsText(client, gnsContract, name, key);
+      } catch {
+        return null;
+      }
+      return null;
+    }
+  };
+}
+
+exports.DEFAULT_GNS_CONTRACT = DEFAULT_GNS_CONTRACT;
+exports.createEthereumNames = createEthereumNames;
+exports.detectSystem = detectSystem;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/ens.ts","../src/gns.ts","../src/client.ts"],"names":["normalize","getEnsAddress","getEnsName","getEnsAvatar","getEnsText","GNS_CONTRACT","readContract","gnsAbi","normalizeName","isAddressEqual","zeroAddress","getAddress","createPublicClient","mainnet","http","isAddress","address","system"],"mappings":"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","file":"index.cjs","sourcesContent":["import { normalize } from 'viem/ens'\nimport type { NameSystem } from './types.js'\n\n/**\n * Detect which name system an input belongs to, purely from its shape — no\n * network calls.\n *\n * - `*.gwei` and bare labels (no dot) → `gns`\n * - any other dotted name (`*.eth`, `*.box`, …) → `ens`\n * - empty input → `null`\n */\nexport function detectSystem(input: string): NameSystem | null {\n  const value = input.trim().toLowerCase()\n  if (!value) return null\n  if (value.endsWith('.gwei')) return 'gns'\n  if (value.includes('.')) return 'ens'\n  // A bare label is treated as a `.gwei` name, matching @donnoh/gns-utils.\n  return 'gns'\n}\n\n/** Normalize an ENS name (ENSIP-15), returning `null` if it is invalid. */\nexport function safeNormalizeEns(name: string): string | null {\n  try {\n    return normalize(name)\n  } catch {\n    return null\n  }\n}\n","import type { Address, PublicClient } from 'viem'\nimport { getEnsAddress, getEnsAvatar, getEnsName, getEnsText } from 'viem/actions'\nimport { safeNormalizeEns } from './utils.js'\n\n/** Resolve an ENS name to an address via viem's universal resolver. */\nexport async function ensResolve(client: PublicClient, name: string): Promise<Address | null> {\n  const normalized = safeNormalizeEns(name)\n  if (!normalized) return null\n  return getEnsAddress(client, { name: normalized })\n}\n\n/** Reverse resolve an address to its primary ENS name. */\nexport function ensReverse(client: PublicClient, address: Address): Promise<string | null> {\n  return getEnsName(client, { address })\n}\n\n/** Read the ENS avatar record for a name. */\nexport async function ensAvatar(client: PublicClient, name: string): Promise<string | null> {\n  const normalized = safeNormalizeEns(name)\n  if (!normalized) return null\n  return getEnsAvatar(client, { name: normalized })\n}\n\n/** Read an arbitrary ENS text record for a name. */\nexport async function ensText(\n  client: PublicClient,\n  name: string,\n  key: string,\n): Promise<string | null> {\n  const normalized = safeNormalizeEns(name)\n  if (!normalized) return null\n  return getEnsText(client, { name: normalized, key })\n}\n","import { GNS_CONTRACT, gnsAbi, normalizeName } from '@donnoh/gns-utils'\nimport { type Address, getAddress, isAddressEqual, zeroAddress } from 'viem'\nimport type { PublicClient } from 'viem'\nimport { readContract } from 'viem/actions'\n\n/** The canonical GNS contract (same address on mainnet and Sepolia). */\nexport const DEFAULT_GNS_CONTRACT = GNS_CONTRACT as Address\n\n/** Compute the on-chain token id for a `.gwei` name. */\nfunction tokenId(client: PublicClient, contract: Address, name: string): Promise<bigint> {\n  return readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'computeId',\n    args: [normalizeName(name)],\n  }) as Promise<bigint>\n}\n\n/** Resolve a `.gwei` name to an address. */\nexport async function gnsResolve(\n  client: PublicClient,\n  contract: Address,\n  name: string,\n): Promise<Address | null> {\n  const id = await tokenId(client, contract, name)\n  if (id === 0n) return null\n  const addr = (await readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'resolve',\n    args: [id],\n  })) as Address\n  if (!addr || isAddressEqual(addr, zeroAddress)) return null\n  return getAddress(addr)\n}\n\n/** Reverse resolve an address to its primary `.gwei` name. */\nexport async function gnsReverse(\n  client: PublicClient,\n  contract: Address,\n  address: Address,\n): Promise<string | null> {\n  const name = (await readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'reverseResolve',\n    args: [address],\n  })) as string\n  return name || null\n}\n\n/** Read a text record for a `.gwei` name. */\nexport async function gnsText(\n  client: PublicClient,\n  contract: Address,\n  name: string,\n  key: string,\n): Promise<string | null> {\n  const id = await tokenId(client, contract, name)\n  if (id === 0n) return null\n  const value = (await readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'text',\n    args: [id, key],\n  })) as string\n  return value || null\n}\n","import { normalizeName } from '@donnoh/gns-utils'\nimport { http, type Address, createPublicClient, getAddress, isAddress, isAddressEqual } from 'viem'\nimport { mainnet } from 'viem/chains'\nimport { ensAvatar, ensResolve, ensReverse, ensText } from './ens.js'\nimport { DEFAULT_GNS_CONTRACT, gnsResolve, gnsReverse, gnsText } from './gns.js'\nimport type {\n  EthereumNames,\n  EthereumNamesConfig,\n  NameSystem,\n  ResolvedName,\n  ReverseNames,\n} from './types.js'\nimport { detectSystem, safeNormalizeEns } from './utils.js'\n\n/**\n * Create a unified ENS + GNS name client.\n *\n * @example\n * ```ts\n * import { createEthereumNames } from '@1001-digital/ethereum-names'\n *\n * const names = createEthereumNames()\n *\n * await names.resolve('vitalik.eth')   // ENS  → 0x...\n * await names.resolve('alice.gwei')    // GNS  → 0x...\n * await names.reverse('0xd8dA...')     // → 'vitalik.eth' | 'alice.gwei' | null\n * ```\n *\n * @example\n * ```ts\n * // Bring your own viem client\n * import { createPublicClient, http } from 'viem'\n * import { mainnet } from 'viem/chains'\n *\n * const client = createPublicClient({ chain: mainnet, transport: http() })\n * const names = createEthereumNames({ client })\n * ```\n */\nexport function createEthereumNames(config: EthereumNamesConfig = {}): EthereumNames {\n  const client =\n    config.client ??\n    createPublicClient({\n      chain: config.chain ?? mainnet,\n      transport: http(config.rpcUrl),\n    })\n\n  const gnsContract = config.gnsContract ?? DEFAULT_GNS_CONTRACT\n  const reversePriority: NameSystem[] = config.reversePriority ?? ['ens', 'gns']\n  const verify = config.verify ?? true\n\n  /** Canonical form of a name for a given system. */\n  function canonical(name: string, system: NameSystem | null): string | null {\n    if (system === 'gns') return normalizeName(name)\n    if (system === 'ens') return safeNormalizeEns(name)\n    return null\n  }\n\n  async function resolveName(name: string, system: NameSystem): Promise<Address | null> {\n    try {\n      if (system === 'ens') return await ensResolve(client, name)\n      return await gnsResolve(client, gnsContract, name)\n    } catch {\n      return null\n    }\n  }\n\n  async function rawReverse(system: NameSystem, address: Address): Promise<string | null> {\n    try {\n      if (system === 'ens') return await ensReverse(client, address)\n      return await gnsReverse(client, gnsContract, address)\n    } catch {\n      return null\n    }\n  }\n\n  /** Reverse resolve for a single system, forward-verifying the result when enabled. */\n  async function reverseFor(system: NameSystem, address: Address): Promise<string | null> {\n    const name = await rawReverse(system, address)\n    if (!name) return null\n    if (!verify) return name\n    const forward = await resolveName(name, system)\n    return forward && isAddressEqual(forward, address) ? name : null\n  }\n\n  return {\n    client,\n\n    system(name) {\n      return detectSystem(name)\n    },\n\n    async resolve(nameOrAddress) {\n      if (!nameOrAddress) return null\n      if (isAddress(nameOrAddress)) return getAddress(nameOrAddress)\n      const system = detectSystem(nameOrAddress)\n      if (!system) return null\n      return resolveName(nameOrAddress, system)\n    },\n\n    async reverse(address) {\n      if (!isAddress(address)) return null\n      const checksummed = getAddress(address)\n      for (const system of reversePriority) {\n        const name = await reverseFor(system, checksummed)\n        if (name) return name\n      }\n      return null\n    },\n\n    async reverseAll(address): Promise<ReverseNames> {\n      if (!isAddress(address)) return { ens: null, gns: null }\n      const checksummed = getAddress(address)\n      const [ens, gns] = await Promise.all([\n        reverseFor('ens', checksummed),\n        reverseFor('gns', checksummed),\n      ])\n      return { ens, gns }\n    },\n\n    async lookup(input): Promise<ResolvedName> {\n      if (isAddress(input)) {\n        const address = getAddress(input)\n        for (const system of reversePriority) {\n          const name = await reverseFor(system, address)\n          if (name) return { input, name, address, system }\n        }\n        return { input, name: null, address, system: null }\n      }\n\n      const system = detectSystem(input)\n      if (!system) return { input, name: null, address: null, system: null }\n      const address = await resolveName(input, system)\n      return { input, name: canonical(input, system), address, system }\n    },\n\n    async getAvatar(name) {\n      const system = detectSystem(name)\n      try {\n        if (system === 'ens') return await ensAvatar(client, name)\n        if (system === 'gns') return await gnsText(client, gnsContract, name, 'avatar')\n      } catch {\n        return null\n      }\n      return null\n    },\n\n    async getText(name, key) {\n      const system = detectSystem(name)\n      try {\n        if (system === 'ens') return await ensText(client, name, key)\n        if (system === 'gns') return await gnsText(client, gnsContract, name, key)\n      } catch {\n        return null\n      }\n      return null\n    },\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,111 @@
+import { PublicClient, Address, Chain } from 'viem';
+
+/** The name systems this library understands. */
+type NameSystem = 'ens' | 'gns';
+/** Every primary name found for an address, keyed by system. */
+interface ReverseNames {
+    /** Primary ENS name, or `null` if none is set (or it failed verification). */
+    ens: string | null;
+    /** Primary GNS (`.gwei`) name, or `null` if none is set (or it failed verification). */
+    gns: string | null;
+}
+/** Rich result describing a resolved name or address. */
+interface ResolvedName {
+    /** The original input, untouched. */
+    input: string;
+    /** The canonical name, when known (e.g. `vitalik.eth`, `alice.gwei`). */
+    name: string | null;
+    /** The resolved address, when known (checksummed). */
+    address: Address | null;
+    /** Which system produced the result, or `null` if nothing resolved. */
+    system: NameSystem | null;
+}
+interface EthereumNamesConfig {
+    /**
+     * A viem `PublicClient` to read from. The client's chain must have ENS
+     * contracts configured (e.g. `mainnet`) for ENS resolution to work.
+     * If omitted, a mainnet client is created from `rpcUrl`/`chain`.
+     */
+    client?: PublicClient;
+    /** RPC endpoint used when no `client` is supplied. Defaults to viem's public mainnet RPC. */
+    rpcUrl?: string;
+    /** Chain used when no `client` is supplied. Defaults to `mainnet`. */
+    chain?: Chain;
+    /** Override the GNS contract address. Defaults to the canonical deployment. */
+    gnsContract?: Address;
+    /** Order in which reverse lookups try each system. Defaults to `['ens', 'gns']`. */
+    reversePriority?: NameSystem[];
+    /**
+     * Forward-verify reverse lookups: after reading an address's primary name,
+     * resolve that name back and confirm it points to the same address before
+     * trusting it. Guards against spoofed reverse records (notably for ENS, whose
+     * reverse records are not self-validating). Defaults to `true`.
+     */
+    verify?: boolean;
+}
+interface EthereumNames {
+    /** The underlying viem client. */
+    readonly client: PublicClient;
+    /**
+     * Resolve a name to an address. Accepts ENS names (`vitalik.eth`), GNS names
+     * (`alice.gwei` or the bare label `alice`), or an address (returned checksummed).
+     * Returns `null` when nothing resolves.
+     */
+    resolve(nameOrAddress: string): Promise<Address | null>;
+    /** Reverse resolve an address to its primary name, trying each system in priority order. */
+    reverse(address: string): Promise<string | null>;
+    /**
+     * Reverse resolve an address across *both* systems, returning every primary
+     * name found. Use this when an address may have both an ENS and a GNS name.
+     */
+    reverseAll(address: string): Promise<ReverseNames>;
+    /** Resolve or reverse-resolve `input`, returning a rich {@link ResolvedName}. */
+    lookup(input: string): Promise<ResolvedName>;
+    /** Read the `avatar` for a name (ENS avatar record, or the GNS `avatar` text record). */
+    getAvatar(name: string): Promise<string | null>;
+    /** Read an arbitrary text record for a name. */
+    getText(name: string, key: string): Promise<string | null>;
+    /** Detect which system a name belongs to, without any network call. */
+    system(name: string): NameSystem | null;
+}
+
+/**
+ * Create a unified ENS + GNS name client.
+ *
+ * @example
+ * ```ts
+ * import { createEthereumNames } from '@1001-digital/ethereum-names'
+ *
+ * const names = createEthereumNames()
+ *
+ * await names.resolve('vitalik.eth')   // ENS  → 0x...
+ * await names.resolve('alice.gwei')    // GNS  → 0x...
+ * await names.reverse('0xd8dA...')     // → 'vitalik.eth' | 'alice.gwei' | null
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Bring your own viem client
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createPublicClient({ chain: mainnet, transport: http() })
+ * const names = createEthereumNames({ client })
+ * ```
+ */
+declare function createEthereumNames(config?: EthereumNamesConfig): EthereumNames;
+
+/**
+ * Detect which name system an input belongs to, purely from its shape — no
+ * network calls.
+ *
+ * - `*.gwei` and bare labels (no dot) → `gns`
+ * - any other dotted name (`*.eth`, `*.box`, …) → `ens`
+ * - empty input → `null`
+ */
+declare function detectSystem(input: string): NameSystem | null;
+
+/** The canonical GNS contract (same address on mainnet and Sepolia). */
+declare const DEFAULT_GNS_CONTRACT: Address;
+
+export { DEFAULT_GNS_CONTRACT, type EthereumNames, type EthereumNamesConfig, type NameSystem, type ResolvedName, type ReverseNames, createEthereumNames, detectSystem };

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import { PublicClient, Address, Chain } from 'viem';
+
+/** The name systems this library understands. */
+type NameSystem = 'ens' | 'gns';
+/** Every primary name found for an address, keyed by system. */
+interface ReverseNames {
+    /** Primary ENS name, or `null` if none is set (or it failed verification). */
+    ens: string | null;
+    /** Primary GNS (`.gwei`) name, or `null` if none is set (or it failed verification). */
+    gns: string | null;
+}
+/** Rich result describing a resolved name or address. */
+interface ResolvedName {
+    /** The original input, untouched. */
+    input: string;
+    /** The canonical name, when known (e.g. `vitalik.eth`, `alice.gwei`). */
+    name: string | null;
+    /** The resolved address, when known (checksummed). */
+    address: Address | null;
+    /** Which system produced the result, or `null` if nothing resolved. */
+    system: NameSystem | null;
+}
+interface EthereumNamesConfig {
+    /**
+     * A viem `PublicClient` to read from. The client's chain must have ENS
+     * contracts configured (e.g. `mainnet`) for ENS resolution to work.
+     * If omitted, a mainnet client is created from `rpcUrl`/`chain`.
+     */
+    client?: PublicClient;
+    /** RPC endpoint used when no `client` is supplied. Defaults to viem's public mainnet RPC. */
+    rpcUrl?: string;
+    /** Chain used when no `client` is supplied. Defaults to `mainnet`. */
+    chain?: Chain;
+    /** Override the GNS contract address. Defaults to the canonical deployment. */
+    gnsContract?: Address;
+    /** Order in which reverse lookups try each system. Defaults to `['ens', 'gns']`. */
+    reversePriority?: NameSystem[];
+    /**
+     * Forward-verify reverse lookups: after reading an address's primary name,
+     * resolve that name back and confirm it points to the same address before
+     * trusting it. Guards against spoofed reverse records (notably for ENS, whose
+     * reverse records are not self-validating). Defaults to `true`.
+     */
+    verify?: boolean;
+}
+interface EthereumNames {
+    /** The underlying viem client. */
+    readonly client: PublicClient;
+    /**
+     * Resolve a name to an address. Accepts ENS names (`vitalik.eth`), GNS names
+     * (`alice.gwei` or the bare label `alice`), or an address (returned checksummed).
+     * Returns `null` when nothing resolves.
+     */
+    resolve(nameOrAddress: string): Promise<Address | null>;
+    /** Reverse resolve an address to its primary name, trying each system in priority order. */
+    reverse(address: string): Promise<string | null>;
+    /**
+     * Reverse resolve an address across *both* systems, returning every primary
+     * name found. Use this when an address may have both an ENS and a GNS name.
+     */
+    reverseAll(address: string): Promise<ReverseNames>;
+    /** Resolve or reverse-resolve `input`, returning a rich {@link ResolvedName}. */
+    lookup(input: string): Promise<ResolvedName>;
+    /** Read the `avatar` for a name (ENS avatar record, or the GNS `avatar` text record). */
+    getAvatar(name: string): Promise<string | null>;
+    /** Read an arbitrary text record for a name. */
+    getText(name: string, key: string): Promise<string | null>;
+    /** Detect which system a name belongs to, without any network call. */
+    system(name: string): NameSystem | null;
+}
+
+/**
+ * Create a unified ENS + GNS name client.
+ *
+ * @example
+ * ```ts
+ * import { createEthereumNames } from '@1001-digital/ethereum-names'
+ *
+ * const names = createEthereumNames()
+ *
+ * await names.resolve('vitalik.eth')   // ENS  → 0x...
+ * await names.resolve('alice.gwei')    // GNS  → 0x...
+ * await names.reverse('0xd8dA...')     // → 'vitalik.eth' | 'alice.gwei' | null
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Bring your own viem client
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ *
+ * const client = createPublicClient({ chain: mainnet, transport: http() })
+ * const names = createEthereumNames({ client })
+ * ```
+ */
+declare function createEthereumNames(config?: EthereumNamesConfig): EthereumNames;
+
+/**
+ * Detect which name system an input belongs to, purely from its shape — no
+ * network calls.
+ *
+ * - `*.gwei` and bare labels (no dot) → `gns`
+ * - any other dotted name (`*.eth`, `*.box`, …) → `ens`
+ * - empty input → `null`
+ */
+declare function detectSystem(input: string): NameSystem | null;
+
+/** The canonical GNS contract (same address on mainnet and Sepolia). */
+declare const DEFAULT_GNS_CONTRACT: Address;
+
+export { DEFAULT_GNS_CONTRACT, type EthereumNames, type EthereumNamesConfig, type NameSystem, type ResolvedName, type ReverseNames, createEthereumNames, detectSystem };

package/dist/index.js

@@ -0,0 +1,190 @@
+import { GNS_CONTRACT, normalizeName, gnsAbi } from '@donnoh/gns-utils';
+import { createPublicClient, http, isAddress, getAddress, isAddressEqual, zeroAddress } from 'viem';
+import { mainnet } from 'viem/chains';
+import { getEnsText, readContract, getEnsAvatar, getEnsAddress, getEnsName } from 'viem/actions';
+import { normalize } from 'viem/ens';
+
+// src/client.ts
+function detectSystem(input) {
+  const value = input.trim().toLowerCase();
+  if (!value) return null;
+  if (value.endsWith(".gwei")) return "gns";
+  if (value.includes(".")) return "ens";
+  return "gns";
+}
+function safeNormalizeEns(name) {
+  try {
+    return normalize(name);
+  } catch {
+    return null;
+  }
+}
+
+// src/ens.ts
+async function ensResolve(client, name) {
+  const normalized = safeNormalizeEns(name);
+  if (!normalized) return null;
+  return getEnsAddress(client, { name: normalized });
+}
+function ensReverse(client, address) {
+  return getEnsName(client, { address });
+}
+async function ensAvatar(client, name) {
+  const normalized = safeNormalizeEns(name);
+  if (!normalized) return null;
+  return getEnsAvatar(client, { name: normalized });
+}
+async function ensText(client, name, key) {
+  const normalized = safeNormalizeEns(name);
+  if (!normalized) return null;
+  return getEnsText(client, { name: normalized, key });
+}
+var DEFAULT_GNS_CONTRACT = GNS_CONTRACT;
+function tokenId(client, contract, name) {
+  return readContract(client, {
+    address: contract,
+    abi: gnsAbi,
+    functionName: "computeId",
+    args: [normalizeName(name)]
+  });
+}
+async function gnsResolve(client, contract, name) {
+  const id = await tokenId(client, contract, name);
+  if (id === 0n) return null;
+  const addr = await readContract(client, {
+    address: contract,
+    abi: gnsAbi,
+    functionName: "resolve",
+    args: [id]
+  });
+  if (!addr || isAddressEqual(addr, zeroAddress)) return null;
+  return getAddress(addr);
+}
+async function gnsReverse(client, contract, address) {
+  const name = await readContract(client, {
+    address: contract,
+    abi: gnsAbi,
+    functionName: "reverseResolve",
+    args: [address]
+  });
+  return name || null;
+}
+async function gnsText(client, contract, name, key) {
+  const id = await tokenId(client, contract, name);
+  if (id === 0n) return null;
+  const value = await readContract(client, {
+    address: contract,
+    abi: gnsAbi,
+    functionName: "text",
+    args: [id, key]
+  });
+  return value || null;
+}
+
+// src/client.ts
+function createEthereumNames(config = {}) {
+  const client = config.client ?? createPublicClient({
+    chain: config.chain ?? mainnet,
+    transport: http(config.rpcUrl)
+  });
+  const gnsContract = config.gnsContract ?? DEFAULT_GNS_CONTRACT;
+  const reversePriority = config.reversePriority ?? ["ens", "gns"];
+  const verify = config.verify ?? true;
+  function canonical(name, system) {
+    if (system === "gns") return normalizeName(name);
+    if (system === "ens") return safeNormalizeEns(name);
+    return null;
+  }
+  async function resolveName(name, system) {
+    try {
+      if (system === "ens") return await ensResolve(client, name);
+      return await gnsResolve(client, gnsContract, name);
+    } catch {
+      return null;
+    }
+  }
+  async function rawReverse(system, address) {
+    try {
+      if (system === "ens") return await ensReverse(client, address);
+      return await gnsReverse(client, gnsContract, address);
+    } catch {
+      return null;
+    }
+  }
+  async function reverseFor(system, address) {
+    const name = await rawReverse(system, address);
+    if (!name) return null;
+    if (!verify) return name;
+    const forward = await resolveName(name, system);
+    return forward && isAddressEqual(forward, address) ? name : null;
+  }
+  return {
+    client,
+    system(name) {
+      return detectSystem(name);
+    },
+    async resolve(nameOrAddress) {
+      if (!nameOrAddress) return null;
+      if (isAddress(nameOrAddress)) return getAddress(nameOrAddress);
+      const system = detectSystem(nameOrAddress);
+      if (!system) return null;
+      return resolveName(nameOrAddress, system);
+    },
+    async reverse(address) {
+      if (!isAddress(address)) return null;
+      const checksummed = getAddress(address);
+      for (const system of reversePriority) {
+        const name = await reverseFor(system, checksummed);
+        if (name) return name;
+      }
+      return null;
+    },
+    async reverseAll(address) {
+      if (!isAddress(address)) return { ens: null, gns: null };
+      const checksummed = getAddress(address);
+      const [ens, gns] = await Promise.all([
+        reverseFor("ens", checksummed),
+        reverseFor("gns", checksummed)
+      ]);
+      return { ens, gns };
+    },
+    async lookup(input) {
+      if (isAddress(input)) {
+        const address2 = getAddress(input);
+        for (const system2 of reversePriority) {
+          const name = await reverseFor(system2, address2);
+          if (name) return { input, name, address: address2, system: system2 };
+        }
+        return { input, name: null, address: address2, system: null };
+      }
+      const system = detectSystem(input);
+      if (!system) return { input, name: null, address: null, system: null };
+      const address = await resolveName(input, system);
+      return { input, name: canonical(input, system), address, system };
+    },
+    async getAvatar(name) {
+      const system = detectSystem(name);
+      try {
+        if (system === "ens") return await ensAvatar(client, name);
+        if (system === "gns") return await gnsText(client, gnsContract, name, "avatar");
+      } catch {
+        return null;
+      }
+      return null;
+    },
+    async getText(name, key) {
+      const system = detectSystem(name);
+      try {
+        if (system === "ens") return await ensText(client, name, key);
+        if (system === "gns") return await gnsText(client, gnsContract, name, key);
+      } catch {
+        return null;
+      }
+      return null;
+    }
+  };
+}
+
+export { DEFAULT_GNS_CONTRACT, createEthereumNames, detectSystem };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/ens.ts","../src/gns.ts","../src/client.ts"],"names":["normalizeName","isAddressEqual","getAddress","address","system"],"mappings":"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","file":"index.js","sourcesContent":["import { normalize } from 'viem/ens'\nimport type { NameSystem } from './types.js'\n\n/**\n * Detect which name system an input belongs to, purely from its shape — no\n * network calls.\n *\n * - `*.gwei` and bare labels (no dot) → `gns`\n * - any other dotted name (`*.eth`, `*.box`, …) → `ens`\n * - empty input → `null`\n */\nexport function detectSystem(input: string): NameSystem | null {\n  const value = input.trim().toLowerCase()\n  if (!value) return null\n  if (value.endsWith('.gwei')) return 'gns'\n  if (value.includes('.')) return 'ens'\n  // A bare label is treated as a `.gwei` name, matching @donnoh/gns-utils.\n  return 'gns'\n}\n\n/** Normalize an ENS name (ENSIP-15), returning `null` if it is invalid. */\nexport function safeNormalizeEns(name: string): string | null {\n  try {\n    return normalize(name)\n  } catch {\n    return null\n  }\n}\n","import type { Address, PublicClient } from 'viem'\nimport { getEnsAddress, getEnsAvatar, getEnsName, getEnsText } from 'viem/actions'\nimport { safeNormalizeEns } from './utils.js'\n\n/** Resolve an ENS name to an address via viem's universal resolver. */\nexport async function ensResolve(client: PublicClient, name: string): Promise<Address | null> {\n  const normalized = safeNormalizeEns(name)\n  if (!normalized) return null\n  return getEnsAddress(client, { name: normalized })\n}\n\n/** Reverse resolve an address to its primary ENS name. */\nexport function ensReverse(client: PublicClient, address: Address): Promise<string | null> {\n  return getEnsName(client, { address })\n}\n\n/** Read the ENS avatar record for a name. */\nexport async function ensAvatar(client: PublicClient, name: string): Promise<string | null> {\n  const normalized = safeNormalizeEns(name)\n  if (!normalized) return null\n  return getEnsAvatar(client, { name: normalized })\n}\n\n/** Read an arbitrary ENS text record for a name. */\nexport async function ensText(\n  client: PublicClient,\n  name: string,\n  key: string,\n): Promise<string | null> {\n  const normalized = safeNormalizeEns(name)\n  if (!normalized) return null\n  return getEnsText(client, { name: normalized, key })\n}\n","import { GNS_CONTRACT, gnsAbi, normalizeName } from '@donnoh/gns-utils'\nimport { type Address, getAddress, isAddressEqual, zeroAddress } from 'viem'\nimport type { PublicClient } from 'viem'\nimport { readContract } from 'viem/actions'\n\n/** The canonical GNS contract (same address on mainnet and Sepolia). */\nexport const DEFAULT_GNS_CONTRACT = GNS_CONTRACT as Address\n\n/** Compute the on-chain token id for a `.gwei` name. */\nfunction tokenId(client: PublicClient, contract: Address, name: string): Promise<bigint> {\n  return readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'computeId',\n    args: [normalizeName(name)],\n  }) as Promise<bigint>\n}\n\n/** Resolve a `.gwei` name to an address. */\nexport async function gnsResolve(\n  client: PublicClient,\n  contract: Address,\n  name: string,\n): Promise<Address | null> {\n  const id = await tokenId(client, contract, name)\n  if (id === 0n) return null\n  const addr = (await readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'resolve',\n    args: [id],\n  })) as Address\n  if (!addr || isAddressEqual(addr, zeroAddress)) return null\n  return getAddress(addr)\n}\n\n/** Reverse resolve an address to its primary `.gwei` name. */\nexport async function gnsReverse(\n  client: PublicClient,\n  contract: Address,\n  address: Address,\n): Promise<string | null> {\n  const name = (await readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'reverseResolve',\n    args: [address],\n  })) as string\n  return name || null\n}\n\n/** Read a text record for a `.gwei` name. */\nexport async function gnsText(\n  client: PublicClient,\n  contract: Address,\n  name: string,\n  key: string,\n): Promise<string | null> {\n  const id = await tokenId(client, contract, name)\n  if (id === 0n) return null\n  const value = (await readContract(client, {\n    address: contract,\n    abi: gnsAbi,\n    functionName: 'text',\n    args: [id, key],\n  })) as string\n  return value || null\n}\n","import { normalizeName } from '@donnoh/gns-utils'\nimport { http, type Address, createPublicClient, getAddress, isAddress, isAddressEqual } from 'viem'\nimport { mainnet } from 'viem/chains'\nimport { ensAvatar, ensResolve, ensReverse, ensText } from './ens.js'\nimport { DEFAULT_GNS_CONTRACT, gnsResolve, gnsReverse, gnsText } from './gns.js'\nimport type {\n  EthereumNames,\n  EthereumNamesConfig,\n  NameSystem,\n  ResolvedName,\n  ReverseNames,\n} from './types.js'\nimport { detectSystem, safeNormalizeEns } from './utils.js'\n\n/**\n * Create a unified ENS + GNS name client.\n *\n * @example\n * ```ts\n * import { createEthereumNames } from '@1001-digital/ethereum-names'\n *\n * const names = createEthereumNames()\n *\n * await names.resolve('vitalik.eth')   // ENS  → 0x...\n * await names.resolve('alice.gwei')    // GNS  → 0x...\n * await names.reverse('0xd8dA...')     // → 'vitalik.eth' | 'alice.gwei' | null\n * ```\n *\n * @example\n * ```ts\n * // Bring your own viem client\n * import { createPublicClient, http } from 'viem'\n * import { mainnet } from 'viem/chains'\n *\n * const client = createPublicClient({ chain: mainnet, transport: http() })\n * const names = createEthereumNames({ client })\n * ```\n */\nexport function createEthereumNames(config: EthereumNamesConfig = {}): EthereumNames {\n  const client =\n    config.client ??\n    createPublicClient({\n      chain: config.chain ?? mainnet,\n      transport: http(config.rpcUrl),\n    })\n\n  const gnsContract = config.gnsContract ?? DEFAULT_GNS_CONTRACT\n  const reversePriority: NameSystem[] = config.reversePriority ?? ['ens', 'gns']\n  const verify = config.verify ?? true\n\n  /** Canonical form of a name for a given system. */\n  function canonical(name: string, system: NameSystem | null): string | null {\n    if (system === 'gns') return normalizeName(name)\n    if (system === 'ens') return safeNormalizeEns(name)\n    return null\n  }\n\n  async function resolveName(name: string, system: NameSystem): Promise<Address | null> {\n    try {\n      if (system === 'ens') return await ensResolve(client, name)\n      return await gnsResolve(client, gnsContract, name)\n    } catch {\n      return null\n    }\n  }\n\n  async function rawReverse(system: NameSystem, address: Address): Promise<string | null> {\n    try {\n      if (system === 'ens') return await ensReverse(client, address)\n      return await gnsReverse(client, gnsContract, address)\n    } catch {\n      return null\n    }\n  }\n\n  /** Reverse resolve for a single system, forward-verifying the result when enabled. */\n  async function reverseFor(system: NameSystem, address: Address): Promise<string | null> {\n    const name = await rawReverse(system, address)\n    if (!name) return null\n    if (!verify) return name\n    const forward = await resolveName(name, system)\n    return forward && isAddressEqual(forward, address) ? name : null\n  }\n\n  return {\n    client,\n\n    system(name) {\n      return detectSystem(name)\n    },\n\n    async resolve(nameOrAddress) {\n      if (!nameOrAddress) return null\n      if (isAddress(nameOrAddress)) return getAddress(nameOrAddress)\n      const system = detectSystem(nameOrAddress)\n      if (!system) return null\n      return resolveName(nameOrAddress, system)\n    },\n\n    async reverse(address) {\n      if (!isAddress(address)) return null\n      const checksummed = getAddress(address)\n      for (const system of reversePriority) {\n        const name = await reverseFor(system, checksummed)\n        if (name) return name\n      }\n      return null\n    },\n\n    async reverseAll(address): Promise<ReverseNames> {\n      if (!isAddress(address)) return { ens: null, gns: null }\n      const checksummed = getAddress(address)\n      const [ens, gns] = await Promise.all([\n        reverseFor('ens', checksummed),\n        reverseFor('gns', checksummed),\n      ])\n      return { ens, gns }\n    },\n\n    async lookup(input): Promise<ResolvedName> {\n      if (isAddress(input)) {\n        const address = getAddress(input)\n        for (const system of reversePriority) {\n          const name = await reverseFor(system, address)\n          if (name) return { input, name, address, system }\n        }\n        return { input, name: null, address, system: null }\n      }\n\n      const system = detectSystem(input)\n      if (!system) return { input, name: null, address: null, system: null }\n      const address = await resolveName(input, system)\n      return { input, name: canonical(input, system), address, system }\n    },\n\n    async getAvatar(name) {\n      const system = detectSystem(name)\n      try {\n        if (system === 'ens') return await ensAvatar(client, name)\n        if (system === 'gns') return await gnsText(client, gnsContract, name, 'avatar')\n      } catch {\n        return null\n      }\n      return null\n    },\n\n    async getText(name, key) {\n      const system = detectSystem(name)\n      try {\n        if (system === 'ens') return await ensText(client, name, key)\n        if (system === 'gns') return await gnsText(client, gnsContract, name, key)\n      } catch {\n        return null\n      }\n      return null\n    },\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@1001-digital/ethereum-names",
+  "version": "0.1.0",
+  "description": "One clean API to resolve Ethereum names across ENS and the Gwei Name Service (GNS), powered by viem.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "ethereum",
+    "ens",
+    "gns",
+    "gwei",
+    "gwei-name-service",
+    "name-service",
+    "resolver",
+    "viem",
+    "web3"
+  ],
+  "author": "jalil.eth",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1001-digital/ethereum-names.git"
+  },
+  "bugs": {
+    "url": "https://github.com/1001-digital/ethereum-names/issues"
+  },
+  "homepage": "https://github.com/1001-digital/ethereum-names#readme",
+  "dependencies": {
+    "@donnoh/gns-utils": "^0.2.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@changesets/changelog-github": "^0.5.1",
+    "@changesets/cli": "^2.30.0",
+    "@types/node": "^22.19.11",
+    "tsup": "^8.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "~5.8.3",
+    "viem": "^2.45.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test src/*.test.ts",
+    "lint": "biome check src",
+    "format": "biome check --write src",
+    "check": "biome check src && tsc --noEmit",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  }
+}