ERC-4834: 分层域名

interface IDomain {
    /// @notice     查询域是否具有具有给定名称的子域
    /// @param      name 要查询的子域，从右到左的顺序
    /// @return     如果域具有具有给定名称的子域，则为 `true`，否则为 `false`
    function hasDomain(string[] memory name) external view returns (bool);

    /// @notice     获取具有给定名称的子域
    /// @dev        如果 `hasDomain(name)` 为 `false`，则应恢复
    /// @param      name 要获取的子域，从右到左的顺序
    /// @return     具有给定名称的子域
    function getDomain(string[] memory name) external view returns (address);
}

function resolve(string[] calldata splitName, IDomain root) public view returns (address) {
    IDomain current = root;
    string[] memory path = [];
    for (uint i = splitName.length - 1; i >= 0; i--) {
        // Append to back of list
        path.push(splitName[i]);
        // Require that the current domain has a domain
        require(current.hasDomain(path), "Name resolution failed");
        // Resolve subdomain
        current = current.getDomain(path);
    }
    return current;
}

interface IDomainRegisterable is IDomain {
    //// Events
    
    /// @notice     当创建新的子域时必须发出（例如，通过 `createDomain`）
    /// @param      sender createDomain 的 msg.sender
    /// @param      name createDomain 的名称
    /// @param      subdomain createDomain 中的子域
    event SubdomainCreate(address indexed sender, string name, address subdomain);

    /// @notice     当域的已解析地址更改时必须发出（例如，使用 `setDomain`）
    /// @param      sender setDomain 的 msg.sender
    /// @param      name setDomain 的名称
    /// @param      subdomain setDomain 中的子域
    /// @param      oldSubdomain 旧子域
    event SubdomainUpdate(address indexed sender, string name, address subdomain, address oldSubdomain);

    /// @notice     当域被取消映射时必须发出（例如，使用 `deleteDomain`）
    /// @param      sender deleteDomain 的 msg.sender
    /// @param      name deleteDomain 的名称
    /// @param      subdomain 旧子域
    event SubdomainDelete(address indexed sender, string name, address subdomain);

    //// CRUD
    
    /// @notice     使用给定的名称创建子域
    /// @dev        如果 `canCreateDomain(msg.sender, name, pointer)` 为 `false` 或域存在，则应恢复
    /// @param      name 要创建的子域名
    /// @param      subdomain 要创建的子域
    function createDomain(string memory name, address subdomain) external payable;

    /// @notice     使用给定的名称更新子域
    /// @dev        如果 `canSetDomain(msg.sender, name, pointer)` 为 `false` 或域不存在，则应恢复
    /// @param      name 要更新的子域名
    /// @param      subdomain 要设置的子域
    function setDomain(string memory name, address subdomain) external;

    /// @notice     删除具有给定名称的子域
    /// @dev        如果域不存在或 `canDeleteDomain(msg.sender, name)` 为 `false`，则应恢复
    /// @param      name 要删除的子域
    function deleteDomain(string memory name) external;


    //// 父域访问控制

    /// @notice     获取帐户是否可以使用给定的名称创建子域
    /// @dev        如果 `hasDomain(name)` 为 `true`，则必须返回 `false`。
    /// @param      updater 可能能够或可能无法创建/更新子域的帐户
    /// @param      name 将被创建/更新的子域名
    /// @param      subdomain 将被设置的子域
    /// @return     帐户是否可以更新或创建子域
    function canCreateDomain(address updater, string memory name, address subdomain) external view returns (bool);

    /// @notice     获取帐户是否可以更新或创建具有给定名称的子域
    /// @dev        如果 `hasDomain(name)` 为 `false`，则必须返回 `false`。
    ///             如果 `getDomain(name)` 也是实现子域访问控制扩展的域，如果 `getDomain(name).canMoveSubdomain(msg.sender, this, subdomain)` 为 `false`，则应返回 `false`。
    /// @param      updater 可能能够或可能无法创建/更新子域的帐户
    /// @param      name 将被创建/更新的子域名
    /// @param      subdomain 将被设置的子域
    /// @return     帐户是否可以更新或创建子域
    function canSetDomain(address updater, string memory name, address subdomain) external view returns (bool);

    /// @notice     获取帐户是否可以删除具有给定名称的子域
    /// @dev        如果 `hasDomain(name)` 为 `false`，则必须返回 `false`。
    ///             如果 `getDomain(name)` 是实现子域访问控制扩展的域，如果 `getDomain(name).canDeleteSubdomain(msg.sender, this, subdomain)` 为 `false`，则应返回 `false`。
    /// @param      updater 可能能够或可能无法删除子域的帐户
    /// @param      name 要删除的子域
    /// @return     帐户是否可以删除子域
    function canDeleteDomain(address updater, string memory name) external view returns (bool);
}

interface IDomainEnumerable is IDomain {
    /// @notice     查询所有子域。如果域的数量未知或无限，则必须恢复。
    /// @return     具有给定索引的子域。
    function subdomainByIndex(uint256 index) external view returns (string memory);
    
    /// @notice     获取子域的总数。如果域的数量未知或无限，则必须恢复。
    /// @return     子域的总数。
    function totalSubdomains() external view returns (uint256);
}

interface IDomainAccessControl is IDomain {
    /// @notice     获取帐户是否可以将子域从当前域移开
    /// @dev        可能由父域的 `canSetDomain` 调用 - 在此处实现访问控制！！！
    /// @param      updater 可能正在移动子域的帐户
    /// @param      name 子域名
    /// @param      parent 父域
    /// @param      newSubdomain 接下来要设置的域
    /// @return     帐户是否可以更新子域
    function canMoveSubdomain(address updater, string memory name, IDomain parent, address newSubdomain) external view returns (bool);

    /// @notice     获取帐户是否可以取消设置此域作为子域
    /// @dev        可能由父域的 `canDeleteDomain` 调用 - 在此处实现访问控制！！！
    /// @param      updater 可能能够或可能无法删除子域的帐户。
    /// @param      name 要删除的子域
    /// @param      parent 父域
    /// @return     帐户是否可以删除子域
    function canDeleteSubdomain(address updater, string memory name, IDomain parent) external view returns (bool);
}