⚠️ DEPRECATED — 2026-04-28

This package is no longer maintained. It will not receive updates, bug fixes, or security patches. The repository has been archived. Please do not use this package in new projects.

---

Hybrid Primary Name

Hybrid Primary Name is a Viem extension package that enables reverse ENS resolution to fetch the primary ENS name associated with a given Ethereum address. It integrates seamlessly with both Viem's createPublicClient and ENS's createEnsPublicClient.

Table of Contents

• Hybrid Primary Name
  • Table of Contents
  • Installation
  • Initialization
    • Using Viem's createPublicClient with ENS Contracts
    • Using ENS's createEnsPublicClient
  • Usage

Installation

Install the package via npm or yarn:

npm install @justaname.id/hybrid-primary-name
# or
yarn add @justaname.id/hybrid-primary-name

Initialization

Using Viem's createPublicClient with ENS Contracts

import { createPublicClient, http } from 'viem';
import { addEnsContracts } from '@ensdomains/ensjs';
import { mainnet, sepolia } from 'viem/chains';
import { primaryName } from '@justaname.id/hybrid-primary-name';

const client = createPublicClient({
        chain: addEnsContracts(**mainnet or sepolia**),
        transport: http(**Provider URL**),
    }).extend(primaryName())

Using ENS's createEnsPublicClient

import { http } from 'viem';
import { createEnsPublicClient } from '@ensdomains/ensjs'
import { mainnet, sepolia } from 'viem/chains';
import { primaryName } from '@justaname.id/hybrid-primary-name';

const client = createEnsPublicClient({
        chain: **mainnet or sepolia**,
        transport: http(**Provider URL**),
    }).extend(primaryName())

Usage

The getEnsFromAddress method returns the primary ENS name associated with the given Ethereum address.

await client.getEnsFromAddress(**Address**),