ERC-7652: ERC-721 担保扩展

pragma solidity ^0.8.20;

// import {IERC721} from "@openzeppelin/contracts/token/ERC721/IERC721.sol";

/// @title EIP-721 担保人角色扩展
///  注意：此接口的 EIP-165 标识符是


interface IERC721Guarantee /*is IERC721*/{
    /// @notice           当为 NFT 建立 `担保合约` 时发出
    /// @param user       担保人的地址
    /// @param value      DAO 提供的担保价值
    /// @param DAO        提供担保的 DAO 组织
    /// @param tokenId    担保的 NFT（token ID），
    event GuaranteeIsEstablshed(
        address user,
        uint256 value,
        address DAO,
        uint256 indexed tokenId
    );

    /// @notice           当 `担保合约` 被取消时发出
    /// @dev              封闭 DAO 中的一些用户请求减少他们的担保份额
    /// @param user       担保人的地址
    /// @param value      DAO 提供的担保价值
    /// @param DAO        提供担保的 DAO 组织
    /// @param tokenId    担保的 NFT（token ID），
    event GuaranteeIsCancel(
        address user,
        uint256 value,
        address DAO,
        uint256 indexed tokenId
    );

    /// @notice           当为 NFT 建立 `担保序列` 时发出
    /// @param userGuaranteed      被担保人的地址
    /// @param number  交易的 block.number，
    ///                并且在此之前建立的所有 DAO 将进入担保序列
    /// @param DAOs   提供担保的 DAO 序列
    /// @param tokenId 担保的 NFT（token ID），
    event GuaranteeSequenceIsEstablshed(
        address userGuaranteed,
        uint256 number,
        address DAOs,
        uint256 indexed tokenId
    );

    /// @notice   用户对 NFT（token ID）的评估
    /// @dev      为一个担保人设置担保信息，
    /// 如果 `_tokenId` 不是有效的 NFT，则抛出
    /// @param value  用户对 NFT 的评估，oledr value（旧值）被取消，
    /// @param user   担保人的地址
    /// @param weight 担保人的担保权重
    /// @param tokenId NFT
    /// @return 函数执行的错误状态
    function setNFTGuarantedInfo(
        uint256 value,
        address user,
        uint256 weight,
        uint256 tokenId
    ) external returns (uint256);

    /// @notice   为 NFT（token ID）建立担保序列并分配佣金
    /// @dev      每个 NFT（token ID）保留一个当前的担保序列，
    ///           过期的担保序列不再有效，
    ///           如果 `_tokenId` 不是有效的 NFT，则抛出
    /// @param valueCommission 交易的佣金
    /// @param userGuaranteed   被担保人的地址
    /// @param number  交易的 block.number，
    ///              并且在此之前建立的所有 DAO 将进入担保序列
    /// @param tokenId NFT
    /// @return 函数执行的错误状态
    function establishNFTGuarantee(
        uint256 valueCommission,
        address userGuaranteed,
        uint256 number,
        uint256 tokenId
    ) external returns (uint256);

    /// @notice   履行担保责任的交易
    /// @dev      新的问责交易也需要
    ///           构建新的担保序列
    ///           如果 `_tokenId` 不是有效的 NFT 或 userGuaranteed 不正确，则抛出。

    /// @param  userGuaranteed   被担保人的地址
    /// @param  tokenId NFT
    /// @return 函数执行的错误状态
    function FulfillGuaranteeTransfer(address userGuaranteed, uint256 tokenId)
        external
        returns (uint256);
}