web3-eth-ens

What is web3-eth-ens?

The web3-eth-ens package is a part of the Web3.js library that provides functionality for interacting with the Ethereum Name Service (ENS). ENS is a distributed, open, and extensible naming system based on the Ethereum blockchain. It allows users to resolve human-readable names like 'myname.eth' into machine-readable identifiers such as Ethereum addresses, content hashes, and metadata.

What are web3-eth-ens's main functionalities?

Resolving ENS Names to Ethereum Addresses

This feature allows you to resolve a human-readable ENS name to an Ethereum address. The code sample demonstrates how to use the web3-eth-ens package to resolve 'myname.eth' to its corresponding Ethereum address.

const Web3 = require('web3');
const ENS = require('web3-eth-ens');

const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');
const ens = new ENS(web3);

async function resolveENSName(name) {
  try {
    const address = await ens.getAddress(name);
    console.log(`Address for ${name}: ${address}`);
  } catch (error) {
    console.error(`Error resolving ENS name: ${error}`);
  }
}

resolveENSName('myname.eth');

Reverse Resolution (Address to ENS Name)

This feature allows you to perform a reverse resolution, converting an Ethereum address back to its associated ENS name. The code sample demonstrates how to use the web3-eth-ens package to reverse resolve an Ethereum address to its ENS name.

const Web3 = require('web3');
const ENS = require('web3-eth-ens');

const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');
const ens = new ENS(web3);

async function reverseResolveAddress(address) {
  try {
    const name = await ens.getName(address);
    console.log(`ENS name for ${address}: ${name}`);
  } catch (error) {
    console.error(`Error reverse resolving address: ${error}`);
  }
}

reverseResolveAddress('0x1234567890abcdef1234567890abcdef12345678');

Setting ENS Records

This feature allows you to set ENS records, such as associating an ENS name with an Ethereum address. The code sample demonstrates how to use the web3-eth-ens package to set the address for 'myname.eth' to a specified Ethereum address.

const Web3 = require('web3');
const ENS = require('web3-eth-ens');

const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');
const ens = new ENS(web3);

async function setENSRecord(name, address) {
  try {
    const accounts = await web3.eth.getAccounts();
    await ens.setAddress(name, address, { from: accounts[0] });
    console.log(`Set address for ${name} to ${address}`);
  } catch (error) {
    console.error(`Error setting ENS record: ${error}`);
  }
}

setENSRecord('myname.eth', '0x1234567890abcdef1234567890abcdef12345678');

Other packages similar to web3-eth-ens

eth-ens-namehash

The eth-ens-namehash package provides utilities for working with ENS names, including namehashing and normalization. It is more focused on the technical aspects of ENS name processing, whereas web3-eth-ens provides higher-level functionality for interacting with the ENS system.

ethers

The ethers package is a complete Ethereum library and includes support for ENS. It provides functionalities for resolving ENS names, reverse resolution, and interacting with ENS records. Compared to web3-eth-ens, ethers is a more comprehensive library that covers a broader range of Ethereum-related functionalities.

README

web3.js - ENS

This is a sub-package of web3.js.

web3-eth-ens This package has ENS functions for interacting with Ethereum Name Service.

Installation

You can install the package either using NPM or using Yarn

Using NPM

npm install web3-eth-ens

Using Yarn

yarn add web3-eth-ens

Getting Started

• :writing_hand: If you have questions submit an issue or join us on Discord

Prerequisites

• :gear: NodeJS (LTS/Fermium)
• :toolbox: Yarn/Lerna

Package.json Scripts

Script	Description
clean	Uses rimraf to remove dist/
build	Uses tsc to build package and dependent packages
lint	Uses eslint to lint package
lint:fix	Uses eslint to check and fix any warnings
format	Uses prettier to format the code
test	Uses jest to run unit tests
test:integration	Uses jest to run tests under /test/integration
test:unit	Uses jest to run tests under /test/unit

Changelog

[4.4.0]

Added

web3-eth

• Catch TransactionPollingTimeoutError was added to send transaction events (#6623)

Changed

web3-eth-abi

• Use AbiError instead of Error for errors at web3-eth-abi (#6641).

web3-eth-contract

• Allow the deploy function to accept parameters, even when no ABI was provided to the Contract(#6635)

web3

• Dependencies updated

Fixed

web3-eth-abi

• Fixed an issue with detecting Uint8Array (#6486)

web3-eth-accounts

• Send Transaction config used to be ignored if the passed common did not have a copy() and the chainId was not provided (#6663)
• Fixed an issue with detecting Uint8Array (#6486)

web3-eth-contract

• Fix and error that happen when trying to get past events by calling contract.getPastEvents or contract.events.allEvents(), if there is no matching events. (#6647)
• Fixed: The Contract is not using the context wallet passed if context was passed at constructor. (#6661)

web3-utils

• Fixed an issue with detecting Uint8Array (#6486)

web3-validator

• Fixed an issue with detecting Uint8Array (#6486)