ERC-5604: NFT 留置权

interface IERC_LIEN is ERC721, ERC165 {

    /// === Events ===

    /// @notice 当新的留置权成功设置时必须发出。
    /// @param tokenId 设置留置权的 token。
    /// @param holder 留置权的持有人。
    /// @param extraParams 添加留置权的原始请求的额外参数。
    event OnLienPlaced(uint256 tokenId, address holder, bytes calldata extraParams);

    /// @notice 当现有留置权成功移除时必须发出。
    /// @param tokenId 移除留置权的 token。
    /// @param holder 留置权的持有人。
    /// @param extraParams 移除留置权的原始请求的额外参数。
    event OnLienRemoved(uint256 tokenId, address holder, bytes calldata extraParams);

    /// === CRUD ===

    /// @notice 用于在 token 上设置留置权的方法
    ///         如果同一持有人已在同一 token 上拥有留置权，则必须引发错误。
    /// @param tokenId 设置留置权的 token。
    /// @param holder 留置权的持有人
    /// @param extraParams 用于未来扩展的额外数据。
    function addLienHolder(uint256 tokenId, address holder, bytes calldata extraParams) public;

    /// @notice 用于移除 token 上的留置权的方法
    ///         如果持有人没有留置权，则必须引发错误。
    /// @param tokenId 要移除留置权的 token。
    /// @param holder 留置权的持有人
    /// @param extraParams 用于未来扩展的额外数据。
    function removeLienHolder(uint256 tokenId, address holder, bytes calldata extraParams) public;

    /// @notice 用于查询 token 上是否存在有效留置权的方法。
    ///         如果 tokenId 不存在或不归属，则必须引发错误。
    /// @param tokenId 要查询留置权的 token
    /// @param holder 该方法正在查询关于留置权持有情况的持有人。
    /// @param extraParams 用于未来扩展的额外数据。
    function hasLien(uint256 tokenId, address holder, bytes calldata extraParams) public view returns (bool);
}