控制器
本节要讲的是.eth注册中心控制器（ETHRegistrarController）的各个部分，这些内容与那些编写注册中心控制器交互工具的开发者息息相关。为简洁起见，省略了注册中心所有者特有的功能。
控制器只与明文标签一起工作（例如，"alice"代表"alice.eth"）。
为了防止域名抢注，.eth注册中心控制器需要对新域名注册(但不需要对续期)执行一个"委托-揭示"的过程。要注册一个域名，用户必须:
- 利用待注册域名和一个秘密值生成一个固定长度的散列。
- 将第1步中生成的定长散列提交给控制器。
- 等待至少1分钟，但别超过24小时。
- 将这个域名的注册请求以及来自第1步的秘密值一起提交。
这个过程保证了注册不会被抢注，除非攻击者能够审查至少1分钟前用户委托注册域名的交易。
示例
域名注册
下面的示例演示了注册域名所需的步骤。
web3.js
const controller = web3.eth.contract(controller_abi).at(controller_address);
async function register(name, owner, duration) {
// Generate a random value to mask our commitment
const random = new Uint8Array(32);
crypto.getRandomValues(random);
const salt = "0x" + Array.from(random).map(b => b.toString(16).padStart(2, "0")).join("");
// Submit our commitment to the smart contract
const commitment = await controller.makeCommitment(name, owner, salt);
// Add 10% to account for price fluctuation; the difference is refunded.
const price = (await controller.rentPrice(name, duration)) * 1.1;
// Wait 60 seconds before registering
setTimeout(async () => {
// Submit our registration request
await controller.register(name, owner, duration, salt, {value: price});
}, 60000);
}
For clarity, this example is written using async rather than callbacks. As a result, this example works in web3 1.0.x; note that it will not work in the web3 injected by MetaMask, as this presently is an older version lacking async support.
读取操作
获取最短委托时间
uint constant public MIN_COMMITMENT_AGE;
这个公共常量表示委托的最短时间（以秒为单位），一次委托只能在它被打包后至少经过这么多秒才能被揭示。
DApps应该获取这个常量，而不是对当前值进行硬编码，因为这个常量可能会在以后的升级中发生变化。
获取最长委托时间
uint constant public MAX_COMMITMENT_AGE;
这个公共常量表示委托的最长时间（以秒为单位），一个委托在它被打包后经过这么多秒之后就会失效，不能再用于注册域名。
DApps应该获取这个常量，而不是对当前值进行硬编码，因为这个常量可能会在以后的升级中发生变化。
获取最短注册时间
uint constant public MIN_REGISTRATION_DURATION;
这个公共常量表示注册的最短持续时间(以秒为单位)，少于此期限的注册将被拒绝。
DApps应该获取这个常量，而不是对当前值进行硬编码，因为这个常量可能会在以后的升级中发生变化。
获取委托时间戳
mapping(bytes32=>uint) public commitments;
commitments存储了从每一份提交的委托到对应委托时间戳的映射。在提交注册交易之前，希望验证委托有效性的调用者应该先检查这个映射。
获取租金价格
function rentPrice(string name, uint duration) view public returns(uint);
rentPrice按照参数中提供的域名和时长，返回注册或续期所需的费用（以wei为单位）。调用者应该注意到这个价格可能随着时间的推移而变化，特别是价格预言机依赖于Fiat汇率的时候。
调用者应该使用这个函数来获取注册费用并显示给用户，而不是在应用程序内部计算这些费用，因为以后对价格预言机的变更或升级可能会产生不同的定价方案，而且每年的注册费用取决于域名长度、注册持续时间或其他变量。
检查域名的有效性
function valid(string name) public view returns(bool);
如果这个域名符合该控制器对注册的有效性要求(比如它满足长度要求)，则valid返回true。
检查域名的可用性
function available(string name) public view returns(bool);
如果这个域名符合该控制器对注册的有效性要求，并且可以注册，则available返回true。在这个函数内部，使用了valid函数(上面的)和注册中心合约中的available函数，available函数同时检查域名在旧版ENS注册中心和当前ENS注册中心中的可用性。
调用者应该使用这个函数来检查域名是否可以注册，而不要用注册中心合约中的available函数，后者不检查域名的长度。
计算委托散列
function makeCommitment(string name, address owner, bytes32 secret) pure public returns(bytes32);
makeCommitment从域名标签（比如'myname'，而不是'myname.eth'）和秘密值生成并返回一个委托散列。
写入操作
提交委托
function commit(bytes32 commitment) public;
commit用于提交预委托，这个预委托是通过调用makeCommitment生成的。
注册域名
function register(string name, address owner, uint duration, bytes32 secret) public payable;
register用于注册域名，有效的注册请求必须符合下列准则:
available(name) == trueduration >= MIN_REGISTRATION_DURATIONsecret用于判定一个有效的委托（例如，commitments[makeCommitment(name, secret)]）存在，并且在1分钟到24小时之间msg.value >= rentPrice(name, duration)
由于租金价格可能会随时间变化，所以建议调用者发送的租金略高于rentPrice返回的价格，5-10%的溢价应该就足够了，多余的资金都会返还给调用者。
调用成功会触发以下事件：
event NameRegistered(string name, bytes32 indexed label, address indexed owner, uint cost, uint expires);
调用成功还会连带注册中心触发一个域名注册事件，并连带ENS注册表触发一个NewOwner事件。
延长域名有效期
function renew(string name, uint duration) external payable;
renew用于续期一个域名。只要提供足够的资金，任何人都可以调用这个函数。由于租金价格可能会随时间变化，所以建议调用者发送的租金略高于rentPrice返回的价格，5-10%的溢价应该就足够了，多余的资金都会返还给调用者。
调用成功会触发以下事件：
event NameRenewed(string name, bytes32 indexed label, uint cost, uint expires);
调用成功还会连带注册中心触发一个域名续期事件。