Technical Documentation
Dapp Developer Guide
Contract API Reference
Contract Developer Guide
ENS Migration (February 2020)
Working with ENS
Before you can begin interacting with ENS, you will need to obtain a reference to the ENS registry. How you do this depends on the library you are using.
Example code for the Javascript-based APIs (ensjs, web3.js, ethjs-ens, and ethers.js) here expect that they are being run inside a DApp browser, such as Chrome with metamask installed, which exposes the
ethereum object.ensjs
web3.js
ethjs-ens
ethers.js
go-ens
web3.py
web3j
1
import ENS, { getEnsAddress } from '@ensdomains/ensjs'
2
​
3
const ens = new ENS({ provider, ensAddress: getEnsAddress('1') })
Copied!
1
var Web3 = require("web3")
2
​
3
var accounts = ethereum.enable();
4
var web3 = new Web3(ethereum);
5
var ens = web3.eth.ens;
Copied!
1
const ENS = require('ethjs-ens');
2
// Currently requires both provider and
3
// either a network or registryAddress param
4
var accounts = ethereum.enable();
5
const ens = new ENS({ ethereum, network: '1' });
Copied!
1
var ethers = require('ethers');
2
var provider = new ethers.providers.Web3Provider(ethereum);
3
// ENS functionality is provided directly on the core provider object.
Copied!
1
import (
2
ens "github.com/wealdtech/go-ens/v2"
3
ethereum "github.com/ethereum/go-ethereum"
4
)
5
​
6
// Can dial up a connection through either IPC or HTTP/HTTPS
7
client, err := ethereum.Dial("/home/ethereum/.ethereum/geth.ipc")
8
registry, err := ens.Registry(client)
Copied!
1
from ens.auto import ns
Copied!
1
EnsResolver ens = new EnsResolver(web3j, 300 /* sync threshold, seconds */);
Copied!
Some web3 libraries - e.g., ethers.js, web3j, and web3.py - have integrated support for name resolution. In these libraries, you can pass in an ENS name anywhere you can supply an address, meaning you do not need to interact directly with their ENS APIs unless you want to manually resolve names or do other ENS operations.
If no library is available for your platform, you can instantiate the ENS registry contract directly using the interface definition here. Addresses for the ENS registry on each supported network are available in the ENS Deployments page.
Copy link
Edit on GitHub