Merge branch 'Dapp-Learning-DAO:main' into main

Author: 0x-stan

README.md

@@ -165,8 +165,8 @@ DAPP架构请参考文章--[从架构维度看Web2.0与Web3.0应用之别](https
 58. [Ethereum Virtual Machine Opcodes](basic/58-EVM/readme.md) ⌛
 59. [web3.0 dapp](basic/59-web3-dapp) ⌛
 60. [Referral Code](https://developers.thundercore.com/docs/referral-contract/) ⬜
-61. [ENS](https://app.ens.domains/) ⬜
-63. [HTLC-crosschain](https://yuanxuxu.com/2020/08/05/%E5%8C%BA%E5%9D%97%E9%93%BE%E8%B7%A8%E9%93%BE%E6%8A%80%E6%9C%AF%E4%B9%8B%E5%93%88%E5%B8%8C%E6%97%B6%E9%97%B4%E9%94%81/) ⬜
+61. [ENS](https://app.ens.domains/) ✅
+63. [HTLC-crosschain](https://yuanxuxu.com/2020/08/05/%E5%8C%BA%E5%9D%97%E9%93%BE%E8%B7%A8%E9%93%BE%E6%8A%80%E6%9C%AF%E4%B9%8B%E5%93%88%E5%B8%8C%E6%97%B6%E9%97%B4%E9%94%81/) ✅
 64. [Web3-Rust](https://github.com/tomusdrw/rust-web3) ⬜ 
 65. [ZK-NFT](https://github.com/kevinz917/zk-NFT) 
 66. [Kleros](https://kleros.io/)

basic/59-web3-dapp/1.eth.build-快速上手-Web3.0dApp开发.md renamed to basic/59-web3-dapp/1_eth_build_快速上手_Web3_dApp开发.md

@@ -0,0 +1,9 @@
+node_modules
+.env
+coverage
+coverage.json
+typechain
+
+#Hardhat files
+cache
+artifacts

basic/59-web3-dapp/2.scaffold-eth-快速上手-web3.0dApp开发.md renamed to basic/59-web3-dapp/2_scaffold_eth_快速上手_web3_dApp开发.md

@@ -0,0 +1,73 @@
+# ENSRegistry.sol 合约介绍   
+ENSRegistry 是 ENS 的主合约, 用于注册用户地址对应的域名
+
+## 合约接口解析  
+- construct   
+在 constrcut 中设置根域名的拥有者为合约的部署者, 之后设置一级子域名的时候会校验调用者是否为根域名的拥有者  
+```solidity
+constructor() public {
+        records[0x0].owner = msg.sender;
+    }
+```
+
+- authorised 
+authorised 修饰器确保只有对应域名的 owner 才能进行相应的操作  
+```solidity
+modifier authorised(bytes32 node) {
+        address owner = records[node].owner;
+        require(owner == msg.sender || operators[owner][msg.sender]);
+        _;
+    }
+```
+
+- setOwner   
+转移域名的所有权, 转移时会校验被转移域名的所有者是否为当前的调用者 
+```solidity
+function setOwner(bytes32 node, address owner) public virtual override authorised(node) {
+        _setOwner(node, owner);
+        emit Transfer(node, owner);
+    }
+```
+
+- setResolver  
+设置域名的反相解析器, 此解析器可以用来反向解析域名 Hash 对应的可读域名, 比如 "0x91d1777781884d03a6757a803996e38de2a42967fb37eeaca72729271025a9e2" => 'addr.reverse'
+```solidity
+function setResolver(bytes32 node, address resolver) public virtual override authorised(node) {
+        emit NewResolver(node, resolver);
+        records[node].resolver = resolver;
+    }
+```
+
+- setTTL  
+设置域名的过期时间, 时间单位为 秒, 比如设置 ttl 为 3600, 表示 1 个小时后此域名过期  
+```solidity
+function setTTL(bytes32 node, uint64 ttl) public virtual override authorised(node) {
+        emit NewTTL(node, ttl);
+        records[node].ttl = ttl;
+    }
+```
+
+- setRecord  
+设置域名的拥有者, 反向解析器地址, ttl 时间. 这个方法是在域名已经存在的情况后, 进行设置的  
+```solidity
+function setRecord(bytes32 node, address owner, address resolver, uint64 ttl) external virtual override {
+        setOwner(node, owner);
+        _setResolverAndTTL(node, resolver, ttl);
+    }
+```
+
+- setSubnodeOwner  
+设置子域名的拥有者, 所有一级域名及后续的子域名都需要通过这个接口进行设置
+```solidity
+function setSubnodeOwner(bytes32 node, bytes32 label, address owner) public virtual override authorised(node) returns(bytes32) {
+        bytes32 subnode = keccak256(abi.encodePacked(node, label));
+        _setOwner(subnode, owner);
+        emit NewOwner(node, label, owner);
+        return subnode;
+    }
+````
+
+
+## 总结  
+观察 ENSRegistry 的接口和内部变量, 可以看到合约中只处理了从 "node" => "owner address" 即域名到拥有者的映射, 但没有处理从 "owner address" => "node" 的映射.  
+其实, 从 "owner address" => "node" 的映射可以通过 Graph 进行处理, 在 setOwner 接口中会出发 Transfer 事件, 而通过 Graph 的处理, 就可以得到 "owner address" => "node" 的映射关系. 

basic/59-web3-dapp/3.值的存取应用1.0-web3.0-dApp开发.md renamed to basic/59-web3-dapp/3_值的存取应用1_web3_dApp开发.md

@@ -0,0 +1,47 @@
+# ENSRegistryWithFallback.sol 合约介绍   
+ENSRegistryWithFallback 同 ENSRegistry 功能相同, 唯一的区别是当对应的域名信息在当前合约中不存在时, 会去旧 ENS 合约中查找对应的数据
+
+## 合约接口解析  
+- construct   
+在 constrcut 中设置旧 ENS 合约地址 
+```solidity
+constructor(ENS _old) public ENSRegistry() {
+        old = _old;
+    }
+```
+
+- resolver 
+查找对应域名 Hash 对应的反向解析器, 如果当前 ENS 中没有查找到, 就在 old ENS 中查找 
+```solidity
+function resolver(bytes32 node) public override view returns (address) {
+        if (!recordExists(node)) {
+            return old.resolver(node);
+        }
+
+        return super.resolver(node);
+    }
+```
+
+- owner   
+查找域名的所有者,  如果当前 ENS 中没有查找到, 就在 old ENS 中查找
+```solidity
+function owner(bytes32 node) public override view returns (address) {
+        if (!recordExists(node)) {
+            return old.owner(node);
+        }
+
+        return super.owner(node);
+    }
+```
+
+- ttl  
+查找域名的 TTL , 如果当前 ENS 中没有查找到, 就在 old ENS 中查找
+```solidity
+function ttl(bytes32 node) public override view returns (uint64) {
+        if (!recordExists(node)) {
+            return old.ttl(node);
+        }
+
+        return super.ttl(node);
+    }
+```

basic/59-web3-dapp/4.值的存取应用2.0-Web3.0dApp开发.md renamed to basic/59-web3-dapp/4_值的存取应用2_Web3_dApp开发.md

@@ -0,0 +1,35 @@
+# FIFSRegistrar.sol 合约介绍   
+FIFSRegistrar 是子域名注册器, 用户设置没有被注册的子域名, 或是更改已经注册的子域名 ( 属于调用者的子域名 )  
+
+## 合约接口解析  
+- only_owner     
+用户判断注册子域名的状态. 如果子域名没有被注册, 或是当前子域名属于调用者, 则允许调用; 负责不允许更改子域名状态
+```solidity
+modifier only_owner(bytes32 label) {
+        address currentOwner = ens.owner(keccak256(abi.encodePacked(rootNode, label)));
+        require(currentOwner == address(0x0) || currentOwner == msg.sender);
+        _;
+    }
+```
+
+- constructor  
+构造器中设置了 ENS 的地址和当前的父域名的 Hash 
+```solidity
+constructor(ENS ensAddr, bytes32 node) public {
+        ens = ensAddr;
+        rootNode = node;
+    }
+```
+
+- register  
+子域名注册接口, 调用者通过调用这个接口进行子域名注册. 
+如果我们回到 ENS 合约中观察 ens.setSubnodeOwner 这个接口, 就会发现调用这个接口的时候, ENS 合约会检查 rootNode 域名对应的 owner 是否为调用者 ( 这里为 FIFSRegistrar 合约 ), 所以 ENS 一级域名 ( 如 .eth ,  .com  域名 ) 的所有者是当前 FIFSRegistrar 合约, 这样当 FIFSRegistrar 调用 ens.setSubnodeOwner 接口时, 就可以成功进行调用
+```solidity
+function register(bytes32 label, address owner) public only_owner(label) {
+        ens.setSubnodeOwner(rootNode, label, owner);
+    }
+}
+```
+
+## 总结  
+一般这个这个合约是给一级域名使用的, 对于用户说, 用户在获得对应的二级、 三级 域名后, 可以直接调用 ENS 接口进行相应的设置

basic/59-web3-dapp/5.值的存取应用3.0-Web3.0dApp开发.md renamed to basic/59-web3-dapp/5_值的存取应用3_Web3_dApp开发.md

@@ -0,0 +1,71 @@
+# ReverseRegistrar.sol 合约介绍   
+ReverseRegistrar 反向域名解析器注册器, 用户注册反向域名解析器.  
+反向域名解析器即把对应的域名 Hash 转换为可读域名 , 如 "0x91d1777781884d03a6757a803996e38de2a42967fb37eeaca72729271025a9e2" => 'addr.reverse'.   
+在 ENS 合于中, 我们了解到可以通过查询 Graph 获取 "owner address" => "node Hash" 的映射, 但这里获取 "node Hash" 后，依然不是可读字符, 需要把它转换为可读字符.  
+
+## 合约接口解析  
+- constructor       
+在构造器中, 设置 ENS 地址和 反向域名解析器地址.  
+在部署时, 如果叶子域名对应的所有者不是合约部署者, 则设置叶子域名的所有者为合约部署者.  
+举例来说, 如果存在域名 .edu.eth , 那么用户 0x00123 在这个域名下的叶子域名为 0x00123.edu.eth , 那么设置 0x00123.edu.eth 域名的所有者为 0x00123
+```solidity
+constructor(ENS ensAddr, NameResolver resolverAddr) public {
+        ens = ensAddr;
+        defaultResolver = resolverAddr;
+
+        // Assign ownership of the reverse record to our deployer
+        ReverseRegistrar oldRegistrar = ReverseRegistrar(ens.owner(ADDR_REVERSE_NODE));
+        if (address(oldRegistrar) != address(0x0)) {
+            oldRegistrar.claim(msg.sender);
+        }
+    }
+```
+
+
+- claim    
+转移叶子域名的所有者到对应的用户.  
+此接口主要在部署新 ReverseRegistrar 合约的时候, 调用旧  ReverseRegistrar 合约的  claim  时使用
+```solidity
+function claim(address owner) public returns (bytes32) {
+        return claimWithResolver(owner, address(0x0));
+    }
+```
+
+- setName   
+设置域名 Hash 的对应的可读字符, 比如 "0x91d1777781884d03a6757a803996e38de2a42967fb37eeaca72729271025a9e2" => 'addr.reverse'
+```solidity
+function setName(string memory name) public returns (bytes32) {
+        bytes32 node = claimWithResolver(address(this), address(defaultResolver));
+        defaultResolver.setName(node, name);
+        return node;
+    }
+```
+
+- claimWithResolver 
+设置域名 Hash 的反向解析器,主要在两个接口中被调用.  
+1) claim :  转移叶子域名的所有者到对应的用户. 调用时, resolver 为 0 地址, 此时不更新 resolver 地址, 只更新 owner 地址
+2) setName :  owner 和 resolver 参数都不为 0 地址, 此时先更新叶子域名 ( 如 0x001234.edu.eth ) 的 owner 为当前合约. 注意, 这里更新 owner 的原因为在后续的 ens.setResolver(node, resolver) 中需要 owner 权限的地址才能调用, 所有这里需要先进行权限转移. 然后再调用  ens.setResolver(node, resolver) 进行解析器地址的更新.
+```solidity  
+function claimWithResolver(address owner, address resolver) public returns (bytes32) {
+        bytes32 label = sha3HexAddress(msg.sender);
+        bytes32 node = keccak256(abi.encodePacked(ADDR_REVERSE_NODE, label));
+        address currentOwner = ens.owner(node);
+
+        // Update the resolver if required
+        if (resolver != address(0x0) && resolver != ens.resolver(node)) {
+            // Transfer the name to us first if it's not already
+            if (currentOwner != address(this)) {
+                ens.setSubnodeOwner(ADDR_REVERSE_NODE, label, address(this));
+                currentOwner = address(this);
+            }
+            ens.setResolver(node, resolver);
+        }
+
+        // Update the owner if required
+        if (currentOwner != owner) {
+            ens.setSubnodeOwner(ADDR_REVERSE_NODE, label, owner);
+        }
+
+        return node;
+    }
+```