ERC-5585: ERC-721 NFT 授权

interface IERC5585 {

    struct UserRecord {
        address user;
        string[] rights;
        uint256 expires;
    }

    /// @notice 获取此 NFT 项目的所有可用权利
    /// @return 可以授权给用户的所有权利
    function getRights() external view returns(string[]);

    /// @notice NFT 持有者将 NFT 的所有权利授权给用户指定的时间段
    /// @dev 零地址表示没有用户
    /// @param tokenId 被授权的 NFT
    /// @param user 被授权 NFT 的用户
    /// @param duration 授权持续的时间段
    function authorizeUser(uint256 tokenId, address user, uint duration) external;

    /// @notice NFT 持有者将特定权利授权给用户指定的时间段
    /// @dev 零地址表示没有用户。当权利未由此 NFT 项目定义时，将抛出异常
    /// @param tokenId 被授权的 NFT
    /// @param user 被授权 NFT 的用户
    /// @param rights 授权给用户的权利，例如租赁、分发或展示等
    /// @param duration 授权持续的时间段
    function authorizeUser(uint256 tokenId, address user, string[] rights, uint duration) external;
    
    /// @notice NFT 的用户将其权利转移给新用户
    /// @dev 零地址表示没有用户
    /// @param tokenId 此 NFT 的权利已转移给新用户
    /// @param newUser 新用户
    function transferUserRights(uint256 tokenId, address newUser) external;

    /// @notice NFT 持有者延长授权的持续时间
    /// @dev 零地址表示没有用户。当权利未由此 NFT 项目定义时，将抛出异常
    /// @param tokenId 已被授权的 NFT
    /// @param user 已被授权 NFT 的用户
    /// @param duration 授权的新持续时间
    function extendDuration(uint256 tokenId, address user, uint duration) external;

    /// @notice NFT 持有者更新授权的权利
    /// @dev 零地址表示没有用户
    /// @param tokenId 已被授权的 NFT
    /// @param user 已被授权 NFT 的用户
    /// @param rights 授权给用户的新权利
    function updateUserRights(uint256 tokenId, address user, string[] rights) external;

    /// @notice 获取指定 NFT 和用户的授权到期时间
    /// @dev 零地址表示没有用户
    /// @param tokenId 要获取用户到期时间的 NFT
    /// @param user 已被授权的用户
    /// @return 授权到期时间
    function getExpires(uint256 tokenId, address user) external view returns(uint);

    /// @notice 获取指定 NFT 和用户的权利
    /// @dev 零地址表示没有用户
    /// @param tokenId 要获取权利的 NFT
    /// @param user 已被授权的用户
    /// @return 已被授权的权利
    function getUserRights(uint256 tokenId, address user) external view returns(string[]);

    /// @notice 合约所有者可以更新每个 NFT 可以授权的用户数量
    /// @param userLimit 仅由运营商设置的用户数量限制
    function updateUserLimit(uint256 userLimit) external onlyOwner;

    /// @notice resetAllowed 标志可以由合约所有者更新，以控制是否可以撤销授权
    /// @param resetAllowed 这是一个布尔标志
    function updateResetAllowed(bool resetAllowed) external onlyOwner;

    /// @notice 检查 token 是否可用于授权
    /// @dev 如果 tokenId 不是有效的 NFT，则抛出异常
    /// @param tokenId 要检查可用性的 NFT
    /// @return true 或 false，表示 NFT 是否可用于授权
    function checkAuthorizationAvailability(uint256 tokenId) public view returns(bool);

    /// @notice 清除指定用户的授权
    /// @dev 零地址表示没有用户。当 resetAllowed 为 true 时，该函数有效，当为 false 时，将抛出异常
    /// @param tokenId 授权基于的 NFT
    /// @param user 将清除授权的用户
    function resetUser(uint256 tokenId, address user) external;


    /// @notice 当 NFT 的用户更改或授权到期时间更新时发出
    /// param tokenId 授权基于的 NFT
    /// param indexed user 被授权 NFT 的用户
    /// @param rights 授权给用户的权利
    /// @param expires 授权的到期时间
    event authorizeUser(uint256 indexed tokenId, address indexed user, string[] rights, uint expires);

    /// @notice 当每个 NFT 可以授权的用户数量更新时发出
    /// @param userLimit 仅由运营商设置的用户数量限制
    event updateUserLimit(uint256 userLimit);
}