ENS 域名注册表智能合约解析

Adonia ·
更新时间:2024-09-20
· 788 次阅读

ENS 注册表合约是 ENS 系统中的核心合约,了解这个合约可以敲开我们理解 ENS 域名系统的大门。

下面是用 Solidity 语言编写的详细代码。当前部署在以太坊中的 ENS 注册表合约是用 LLL 语言编写的(ENS 最早采用 LLL 语言的原因),但因为 LLL 语言的可读性很差,于是 ENS 官方团队公布了用 Solidity 语言实现的 ENS 注册表合约。

pragma solidity ^0.5.0; import "./ENS.sol"; contract ENSRegistry is ENS { struct Record { address owner; address resolver; uint64 ttl; } mapping (bytes32 => Record) records; modifier only_owner(bytes32 node) { require(records[node].owner == msg.sender); _; } constructor() public { records[0x0].owner = msg.sender; } function setOwner(bytes32 node, address owner) external only_owner(node) { emit Transfer(node, owner); records[node].owner = owner; } function setSubnodeOwner(bytes32 node, bytes32 label, address owner) external only_owner(node) { bytes32 subnode = keccak256(abi.encodePacked(node, label)); emit NewOwner(node, label, owner); records[subnode].owner = owner; } function setResolver(bytes32 node, address resolver) external only_owner(node) { emit NewResolver(node, resolver); records[node].resolver = resolver; } function setTTL(bytes32 node, uint64 ttl) external only_owner(node) { emit NewTTL(node, ttl); records[node].ttl = ttl; } function owner(bytes32 node) external view returns (address) { return records[node].owner; } function resolver(bytes32 node) external view returns (address) { return records[node].resolver; } function ttl(bytes32 node) external view returns (uint64) { return records[node].ttl; } } ENSRegistry.sol

下面我们来一步一步解析这个智能合约。

pragma solidity ^0.5.0;

这是 solidity 版本声明,0.5.0代表 solidity 版本,^ 号表示向上兼容。

import "./ENS.sol";

表示合约引用了 ENS.sol 合约。ENS.sol 合约是一个注册表接口合约,而 ENSRegistry.sol 合约包含着具体的注册表实现代码。

struct Record { address owner; address resolver; uint64 ttl; }

定义了 ENS 记录的结构。

字段 address 表示一个 ENS 域名的所有者地址。
字段 address 表示一个 ENS 域名的解析器地址。
字段 ttl 表示一个 ENS 域名的 TTL 值。

mapping (bytes32 => Record) records;

创建了一个名为 records 的映射类型,表示从节点到记录的映射。节点是指在 ENS 系统中用来标识域名的一个哈希值,节点的处理是 ENS 系统中的关键内容,有兴趣的可以进一步了解 ENS 域名处理。

modifier only_owner(bytes32 node) { require(records[node].owner == msg.sender); _; }

创建了一个函数修改器,用来限定那些只允许指定节点的所有者来执行的函数。

constructor() public { records[0x0].owner = msg.sender; }

合约构造器。合约部署时会将 ENS 域名根域的所有权赋予部署者。

function setOwner(bytes32 node, address owner) external only_owner(node) { emit Transfer(node, owner); records[node].owner = owner; }

setOwner 函数实现将一个节点的所有权转让给另一个地址,该函数只能由该节点当前的所有者来调用。

参数 node 表示需要转让所有权的节点。
参数 owner 表示接收节点所有权的地址。

function setSubnodeOwner(bytes32 node, bytes32 label, address owner) external only_owner(node) { bytes32 subnode = keccak256(abi.encodePacked(node, label)); emit NewOwner(node, label, owner); records[subnode].owner = owner; }

setSubnodeOwner 函数将一个子节点的所有权转让给一个新的地址,该函数只能由其父节点的所有者来调用。

参数 node 表示父节点。
参数 label 表示指定子节点标签的哈希。
参数 owner 表示接收子节点所有权的地址。

function setResolver(bytes32 node, address resolver) external only_owner(node) { emit NewResolver(node, resolver); records[node].resolver = resolver; }

setResolver 函数用来设置指定节点的解析器地址,该函数只能由这个节点的所有者来调用。

参数 node 表示需要设置的节点。
参数 resolver 表示解析器地址。

function setTTL(bytes32 node, uint64 ttl) external only_owner(node) { emit NewTTL(node, ttl); records[node].ttl = ttl; }

setTTL 函数用来设置指定节点的 TTL,该函数只能由这个节点的所有者来调用。

参数 node 表示需要设置的节点。
参数 ttl 表示以秒为单位的 TTL 值。

function owner(bytes32 node) external view returns (address) { return records[node].owner; }

owner 函数用来获取指定节点的所有者地址。

function resolver(bytes32 node) external view returns (address) { return records[node].resolver; }

resolver 函数用来获取指定节点的解析器地址。

function ttl(bytes32 node) external view returns (uint64) { return records[node].ttl; }

ttl 函数用来获取指定节点的 TTL 值。

以上就是 ENSRegistry.sol 合约的全部代码,这个合约自部署到以太坊主网来以来,一直没有变更过,相当于 ENS 的 “户籍系统” ,它记录着所有的 ENS 域名的所有者、解析器等 “户口信息” 。

ENS 在未来会有更加广泛的应用。如果您对 ENS 域名有兴趣,一定要在下面留言与我交流。


作者:ENSUser



智能合约 注册表 域名 ens

需要 登录 后方可回复, 如果你还没有账号请 注册新账号