ERC-6617: 基于位的权限

pragma solidity ^0.8.7;

/**
    @title EIP-6617 基于位的权限
    @dev 参见 https://eips.ethereum.org/EIPS/eip-6617
*/
interface IEIP6617 {

    /**
        当权限被授予时必须触发。
        @param _grantor        权限授予者
        @param _permission     被授予的权限
        @param _user           接收权限的用户
    */
    event PermissionGranted(address indexed _grantor, uint256 indexed _permission, address indexed _user);

    /**
        当权限被撤销时必须触发。
        @param _revoker        权限撤销者
        @param _permission     被撤销的权限
        @param _user           失去权限的用户
    */
    event PermissionRevoked(address indexed _revoker, uint256 indexed _permission, address indexed _user);

    /**
        @notice 检查用户是否拥有权限
        @param _user                需要检查权限的用户的地址
        @param _requiredPermission  所需的权限
        @return                     如果 _permission 是 _requiredPermission 的超集，则返回 True，否则返回 False
    */
    function hasPermission(address _user, uint256 _requiredPermission)
        external
        view
        returns (bool);

    /**
        @notice 向用户添加权限
        @param _user                将要添加权限的用户的地址
        @param _permissionToAdd     将要添加的权限
        @return                     包含 _permissionToAdd 的新权限
    */
    function grantPermission(address _user, uint256 _permissionToAdd)
        external
        returns (bool);

    /**
        @notice 撤销用户的权限
        @param _user                将要撤销权限的用户的地址
        @param _permissionToRevoke  将要撤销的权限
        @return                     不包含 _permissionToRevoke 的新权限
    */
    function revokePermission(address _user, uint256 _permissionToRevoke)
        external
        returns (bool);
}

/**
 * @dev 定义了 EIP6617 元数据的接口，可以不实现
 */
interface IEIP6617Meta {
    
    /**
        权限描述的结构体
        @param _permission     权限
        @param _name           权限的名称
        @param _description    权限的描述
    */
    struct PermissionDescription {
        uint256 permission;
        string name;
        string description;
    }

    /**
        当描述更新时必须触发。
        @param _permission     权限
        @param _name           权限的名称
        @param _description    权限的描述
    */
    event UpdatePermissionDescription(uint256 indexed _permission, string indexed _name, string indexed _description);

    /**
        返回给定 `_permission` 的描述。
        @param _permission     权限
    */
    function getPermissionDescription(uint256 _permission) external view returns (PermissionDescription memory description);

    /**
        如果描述被设置则返回 `true`，否则返回 `false`。它必须触发 `UpdatePermissionDescription` 事件。
        @param _permission     权限
        @param _name           权限的名称
        @param _description    权限的描述
    */
    function setPermissionDescription(uint256 _permission, string memory _name, string memory _description)
        external
        returns (bool success);
}