本次将通过一个叫做vitalik.eth
的域名去示例阐述一下整个解析流程;
其总体分为两个步骤:
- 去官方app中查询一下注册人。
- 在官方合约中查询其owner是否与其一致。
好的,废话不多说,开始进入主题。
第一步,在ens官方App中查询一下vitalik.eth
的注册信息,当前查询的结果信息,我已截图并展示如下:
通过上图,可以看到其注册人地址为0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
。
ok,那接下来,
第二步,在这里我们没有通过代码方式(还得写代码,太麻烦,哈哈),而是使用简单方便的etherscan区块浏览器。
首先,找到ENS的官方合约,然后再去找一下查询某个域名owner的方法。
点击Contract
->Read Contract
后,你很快就找到一个叫做owner
方法,接下来就是很开心的去查询一下vitalik.eth
的owner信息,当开始输入参数时,你傻眼了,该方法截图如下:
怎么回事输入参数是bytes32,不是字符串,这怎么查,难道不是这个方法,再找找,发现没有其他方法!!!
哈哈,其实就是它。
只是合约实现上的一个细节,即ENS的团队为了效率以及扩展性,从而采用一种固定长度的256位(32字节)加密散列值来代替人类可读的名称。
下面,我们去探究一下散列值的技术实现细节。
首先,先熟悉一下ENS中的几个术语:
- 域名(domain):完整的、人类可读的名称(name)形式;例如,iam.alice.eth,由多个独立部分(标签)组成,标签之间用点分隔。
- 标签(label):域名中的一个组件,如iam、alice或eth。
- 标签哈希(label hash):应用于标签的kecak -256函数的输出;例如,keccak256(' eth ') = * 0x4f5b812789fc606be1b3b16908db13fc7a9adf7ca72641f84d75b47069d3d7f0
- 节点(node):名称散列函数的输出值,用于ENS中标识唯一的名称。
然后,再熟悉一下node的生成算法:
先通过字符"."
将域名划分为多个标签。因此,vitalik.wallet.eth
变成一个数组清单[‘vitalik’、‘wallet’、‘eth’]。
接着,按如下方式递归定义namehash函数
namehash([]) = 0x0000000000000000000000000000000000000000000000000000000000000000
namehash([label, …]) = keccak256(namehash(…), keccak256(label))
最后生成一个32字节的node标识。
下面提供几个常见的实现方式:
- solidity的实现:
function hash() public pure returns(bytes32 namehash){
namehash = 0x0000000000000000000000000000000000000000000000000000000000000000;
namehash = keccak256(abi.encodePacked(namehash, keccak256(abi.encodePacked('eth'))));
namehash = keccak256(abi.encodePacked(namehash, keccak256(abi.encodePacked('wallet'))));
namehash = keccak256(abi.encodePacked(namehash,keccak256(abi.encodePacked('vitalik'))));
}
- nodejs的实现:
# 使用官方类库
var namehash = require('@ensdomains/eth-ens-namehash')
console.log(namehash.hash('vitalik.wallet.eth'));
# 自己实现
function hash(name) {
var labels = name.split('.');
sha3 = require('js-sha3');
var node = '';
for (var i = 0; i < 32; i++) {
node += '00';
}
for (var i = labels.length - 1; i >= 0; i--) {
var labelSha = sha3.keccak_256(labels[i]);
node = sha3.keccak_256(Buffer.from(node + labelSha, 'hex'));
}
return '0x' + node;
}
另外,需要注意下UTS46规范。
了解上述细节知识后,我们回归至第二步,先把名称vitalik.eth
进行namehash生成唯一的node标识,即
0xee6c4522aab0003e8d14cd40a6af439055fd2577951148c14b6cea9a53475835
接着,将信息输入至onwer
方法的node参数,查询的owner结果如截图所示:
图中发现owner与第一步获取的REGISTRANT一致。
到此,在链上ENS合约中解析域名vitalik.eth
的owner整个流程就结束了。
参考资源
https://docs.ens.domains/contract-api-reference/name-processing