How to Resolve ENS Domains Given a Wallet Address
In this tutorial, we’ll be using Alchemy’s NFT API to fetch all ENS Domain Names owned by a user.
What tools do you need to find an ENS name?
- 1.
- 2.Select a wallet address to request ENS domains from (i.e. “0x…XXX”)
- 3.
How do you find a wallet’s owned ENS names?
Because all ENS domains are ERC721 tokens (NFTs), Alchemy's NFT API is a powerful tool for querying blockchains for data about wallets that own ENS domains. Let’s set up our basic environment in your code editor and terminal by following instructions as mentioned in the NFT API Quickstart Guide. We’ll be using npm in this example.
1. Create a new repository with Alchemy's NFT API
Open up a terminal, and from the command line, create a new repository to hold your quickstart scripts. We'll also initialize the repo as an npm project.
1
mkdir alchemy-nft-api
2
cd alchemy-nft-api
3
npm init --yes
Copied!
2. Install the Alchemy Web3 SDK
Navigate into your project directory and run:
1
npm install @alch/alchemy-web3
Copied!
3. [optional] Load ES6 modules
If you run into module errors, you may need to add
'type':'module' to your package.json because we'll be utilizing import syntax to load ES6 modules in our script. package.json
1
{
2
...
3
"type": "module"
4
}
5
Copied!
To get the ENS domains for a given address, we'll make a request to getNFTs with contract filtering The contract that we'll specify in the request is the address for all ENS contracts:
0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85In this example we'll get the owned ENS domains for address 0x458d1E307CcA61C0Bea82f7663F66831175EcDe8
Create a file in your repository called
resolve-ens.js and paste in the followingresolve-ens.js
1
// Installation: https://github.com/alchemyplatform/alchemy-web3
2
import { createAlchemyWeb3 } from "@alch/alchemy-web3";
3
4
const apiKey = "demo"; // replace with your unique Alchemy API Key
5
const web3 = createAlchemyWeb3(
6
"https://eth-mainnet.alchemyapi.io/v2/"+ apiKey
7
);
8
9
const walletAddress = "0x458d1E307CcA61C0Bea82f7663F66831175EcDe8"; // replace with wallet address
10
const ensContractAddress = "0x57f1887a8BF19b14fC0dF6Fd9B2acc9Af147eA85";
11
const nfts = await web3.alchemy.getNfts({owner: walletAddress, contractAddresses: [ensContractAddress]})
12
13
console.log(nfts);
Copied!
5. Print ENS objects
From the command line, run
node resolve-ens.js :1
{
2
ownedNfts: [
3
{
4
contract: [Object],
5
id: [Object],
6
balance: '1',
7
title: 'elanhalpern.eth',
8
description: 'elanhalpern.eth, an ENS name.',
9
tokenUri: [Object],
10
media: [Array],
11
metadata: [Object],
12
timeLastUpdated: '2022-03-07T07:50:03.443Z'
13
},
14
{
15
contract: [Object],
16
id: [Object],
17
balance: '1',
18
title: 'cryptocreamery.eth',
19
description: 'cryptocreamery.eth, an ENS name.',
20
tokenUri: [Object],
21
media: [Array],
22
metadata: [Object],
23
timeLastUpdated: '2022-03-05T06:21:12.583Z'
24
}
25
],
26
totalCount: 2,
27
blockHash: '0xc983065bae1b5a52a87b3bdce7f3669cb56f9f843c348ffe44d23742bf5fff76'
28
}
Copied!
The title field in our
ownedNFT objects is the name of the ENS domain. In this case, the address owns two ENS domains:elanhalpern.ethcryptocreamery.eth
And that's it! You can now easily get any ENS domains from a given wallet address
🎉