域名解析

解析至以太坊地址

ENS中最简单和最常用的函数是域名解析函数。域名可以关联多种类型的资源，其中最常见的是以太坊地址。借助ENS库，将域名解析为以太坊地址很简单：

ethereum-ens

var address = await ens.resolver('alice.eth').addr();

web3.js

var address = ens.getAddress('alice.eth');

ethjs-ens

var address = await ens.lookup('alice.eth');

ethers.js

var address = await provider.resolveName('alice.eth');

ethers.js还能支持在任何需要使用地址的地方也可以使用ENS域名，也就是说一般不需要直接调用resolveName。例如，要查询一个账户的余额，你可以这样做:

var balance = await provider.getBalance('alice.eth');

或者，实例化一个合约:

const abi = [
  "function getValue() view returns (string value)",
  "function setValue(string value)"
];
const contract = new ethers.Contract('contract.alice.eth', abi, provider);

1
2
3
4
5

go-ens

address, err := ens.Resolve(client, "alice.eth")

web3.py

address = ns.address('alice.eth')

web3j

String address = ens.resolve("alice.eth");

web3j同样支持在任何需要使用地址的地方也可以使用ENS域名，所以你通常不需要直接与EnsResolver对象交互。例如，要实例化一个合约接口，你可以这样做：

YourSmartContract contract = YourSmartContract.load(
        "contract.alice.eth", web3j, credentials, GAS_PRICE, GAS_LIMIT);

1
2

如果不借助ENS库，解析的过程可以分为三步：

对将要解析的域名进行规范化和散列，详细信息请参阅域名处理。
在ENS注册表上调用resolver()，并将第1步输出的散列作为参数传递，然后resolver()会返回负责解析这个域名的解析器的地址。
使用resolver接口，在第2步返回的解析器地址上调用addr()，并将第1步输出的散列作为参数传递。

对多币地址解析的支持是通过重载addr()来实现的。要解析多币地址，必须要有相应加密货币的Namehash和符合SLIP44规范的链ID。例如，要解析一个比特币地址，可以调用addr(hash, 0)。注意，返回的地址是用二进制表示的，因此要通过解码来得到文本格式的地址，详细内容请参阅EIP2304。

警告: 使用addr()进行解析时，必须将来自解析器0x00…00的返回值视为未设置的记录。否则，在用户配置了解析器却没有为域名设置解析地址的情况下，可能导致用户的资金被发送到空地址!

解析至其他资源

除了以太坊地址，ENS还支持将域名解析至许多其他类型的资源，其中包括存储在Swarm或IPFS中的数据的内容散列、合约接口(ABIs)和基于文本的元数据。查询这些信息的过程因采用的ENS库而有所差异，相关信息，请参阅所选库的文档。

如果不借助ENS库来实现这些类型的解析，同样需要遵循上面介绍过的3步过程，只是在第3步中调用的不再是addr()，而是解析器上与这些类型相对应的函数。

反向解析

"常规"解析实现了从域名到地址的映射，而反向解析是指从地址映射回域名或其他元数据。ENS支持反向解析，以便应用程序用ENS域名代替显示十六进制地址。

反向解析是通过专用域名 addr.reverse 和解析器的name()函数实现的。addr.reverse 的所有权属于一个专用的注册中心合约，该合约将子域名分配给相应地址的所有者。例如，地址 0x314159265dd8dbb310642f98f50c066173c1259b 可以要求使用 314159265dd8dbb310642f98f50c066173c1259b.addr.reverse，并设置解析器和解析记录。通过这个解析器的name()函数可以取得与该地址关联的域名。

警告: ENS并不强制要求反向记录的准确性。例如，每个人都可以声明其地址的域名为"alice.eth"。所以，为了确保声明是准确的，你必须始终对返回的域名执行正向解析，并检查正向解析得到的地址是否与原始地址匹配。

大多数ENS库提供了执行反向解析的功能：

ethereum-ens:

const address = '0x1234...';
var name = await ens.reverse(address).name()
// Check to be sure the reverse record is correct.
if(address != await ens.resolver(name).addr()) {
  name = null;
}

1
2
3
4
5
6

web3.js 不支持

ethjs-ens:

var address = '0x1234...';
var name = await ens.reverse(address);
// Check to be sure the reverse record is correct.
if(address != await ens.lookup(name)) {
  name = null;
}

1
2
3
4
5
6

ethers.js:

var address = '0x1234...';
var name = await provider.lookupAddress(address);
// ethers.js automatically checks that the forward resolution matches.

1
2
3

go-ens:

name, err := ens.ReverseResolve(client, common.HexToAddress("0x1234...")

web3.py:

address = '0x1234...'
name = ns.reverse(address)
# Check to be sure the reverse record is correct.
if address != ns.address(name):
  name = None

1
2
3
4
5

web3j::

String address = "0x1234...";
String name = ens.reverseResolve(address);
// Check to be sure the reverse record is correct.
if(address != ens.resolve(name)) {
  name = null;
}

1
2
3
4
5
6

如果不使用库，实现反向解析的过程也是一样的：查询1234....addr.reverse（其中的 1234... 是需要进行反向解析的地址）的解析器并在该解析器上调用name()函数。然后，执行正向解析以验证记录是否准确。

# 域名解析

# 解析至以太坊地址

# 解析至其他资源

# 反向解析

域名解析

解析至以太坊地址

解析至其他资源

反向解析