ERC-5218: NFT 权利管理

pragma solidity ^0.8.0;

/// @title ERC-5218: NFT 权利管理
interface IERC5218 is IERC721 {

  /// @dev 当通过任何机制创建新许可时，都会发出此事件。
  event CreateLicense(uint256 _licenseId, uint256 _tokenId, uint256 _parentLicenseId, address _licenseHolder, string _uri, address _revoker);
 
  /// @dev 当许可被撤销时，会发出此事件。请注意，根据某些
  ///  许可条款，在撤销某些祖先许可后，子许可可能被 `隐式` 撤销。
  ///  在这种情况下，您的智能合约
  ///  可能只为祖先许可发出一次此事件，并且可以暗示撤销
  ///  其所有子许可，而无需消耗额外的 gas。
  event RevokeLicense(uint256 _licenseId);
 
  /// @dev 当许可转移到新的持有人时，会发出此事件。NFT 的
  ///  根许可应与 NFT 一起在 ERC721 中转移
  ///  `transfer` 函数调用。
  event TransferLicense(uint256 _licenseId, address _licenseHolder);
  
  /// @notice 检查许可是否有效。
  /// @dev 不存在或被撤销的许可无效，并且此函数必须
  ///  在其上返回 `false`。根据某些许可条款，许可可能会变得
  ///  无效，因为某些祖先许可已被撤销。在这种情况下，
  ///  此函数应返回 `false`。
  /// @param _licenseId 查询许可的标识符
  /// @return 查询的许可是否有效
  function isLicenseActive(uint256 _licenseId) external view returns (bool);

  /// @notice 检索颁发许可的 token 标识符。
  /// @dev 除非许可有效，否则抛出异常。
  /// @param _licenseId 查询许可的标识符
  /// @return 颁发查询许可的 token 标识符
  function getLicenseTokenId(uint256 _licenseId) external view returns (uint256);

  /// @notice 检索许可的父许可标识符。
  /// @dev 除非许可有效，否则抛出异常。如果许可没有
  ///  父许可，则返回一个不引用任何许可的特殊标识符
  ///  （例如 0）。
  /// @param _licenseId 查询许可的标识符
  /// @return 查询许可的父许可标识符
  function getParentLicenseId(uint256 _licenseId) external view returns (uint256);

  /// @notice 检索许可的持有人。
  /// @dev 除非许可有效，否则抛出异常。
  /// @param _licenseId 查询许可的标识符
  /// @return 查询许可的持有人地址
  function getLicenseHolder(uint256 _licenseId) external view returns (address);

  /// @notice 检索许可的 URI。
  /// @dev 除非许可有效，否则抛出异常。
  /// @param _licenseId 查询许可的标识符
  /// @return 查询许可的 URI
  function getLicenseURI(uint256 _licenseId) external view returns (string memory);

  /// @notice 检索许可的撤销者地址。
  /// @dev 除非许可有效，否则抛出异常。
  /// @param _licenseId 查询许可的标识符
  /// @return 查询许可的撤销者地址
  function getLicenseRevoker(uint256 _licenseId) external view returns (address);

  /// @notice 检索 NFT 的根许可标识符。
  /// @dev 除非查询的 NFT 存在，否则抛出异常。如果 NFT 没有根
  ///  许可绑定到它，则返回一个不引用任何
  ///  许可的特殊标识符（例如 0）。
  /// @param _tokenId 查询 NFT 的标识符
  /// @return 查询 NFT 的根许可标识符
  function getLicenseIdByTokenId(uint256 _tokenId) external view returns (uint256);
  
  /// @notice 创建新许可。
  /// @dev 除非 NFT `_tokenId` 存在，否则抛出异常。除非父
  ///  许可 `_parentLicenseId` 有效，或者 `_parentLicenseId` 是一个特殊的
  ///  不引用任何许可的标识符（例如 0），并且 NFT
  ///  `_tokenId` 没有绑定到它的根许可，否则抛出异常。除非
  ///  消息发送者有资格创建许可，即，要么
  ///  要创建的许可是一个根许可，并且 `msg.sender` 是 NFT 所有者，
  ///  要么要创建的许可是一个子许可，并且 `msg.sender` 是
  ///  父许可的持有人，否则抛出异常。
  /// @param _tokenId 颁发许可的 NFT 的标识符
  /// @param _parentLicenseId 父许可的标识符
  /// @param _licenseHolder 许可持有人的地址
  /// @param _uri 许可条款的 URI
  /// @param _revoker 撤销者地址
  /// @return 创建的许可的标识符
  function createLicense(uint256 _tokenId, uint256 _parentLicenseId, address _licenseHolder, string memory _uri, address _revoker) external returns (uint256);

  /// @notice 撤销许可。
  /// @dev 除非许可有效且消息发送者是
  ///  有资格的撤销者，否则抛出异常。此函数应用于撤销根
  ///  许可和子许可。请注意，如果撤销了根许可，则
  ///  NFT 应转移回其创建者。
  /// @param _licenseId 查询许可的标识符
  function revokeLicense(uint256 _licenseId) external;
  
  /// @notice 转移子许可。
  /// @dev 除非子许可有效且 `msg.sender` 是许可
  ///  持有人，否则抛出异常。请注意，NFT 的根许可应绑定到
  ///  并与 NFT 一起转移。每当通过调用
  ///  ERC721 `transfer` 函数转移 NFT 时，根许可的持有人应
  ///  更改为新的 NFT 所有者。
  /// @param _licenseId 查询许可的标识符
  /// @param _licenseHolder 新的许可持有人
  function transferSublicense(uint256 _licenseId, address _licenseHolder) external;
}

  struct License {
    bool active; // 许可是否有效
    uint256 tokenId; // 许可绑定到的 NFT 的标识符
    uint256 parentLicenseId; // 父许可的标识符
    address licenseHolder; // 许可持有人
    string uri; // 许可 URI
    address revoker; // 许可撤销者
  }
  mapping(uint256 => License) private _licenses; // 从许可标识符映射到许可对象
  mapping(uint256 => uint256) private _licenseIds; // 从 NFT 映射到其根许可标识符