ERC-4675: 多重分数化非同质化代币

/**
    @title Multi-Fractional Non-Fungible Token Standard
    @dev Note : The ERC-165 identifier for this interface is 0x83f5d35f.
*/
interface IMFNFT {
    /**
        @dev 当任何代币的所有权通过任何机制更改时，都会发出此事件。
        `_from` 参数必须是发送代币的帐户/合约的地址。
        `_to` 参数必须是接收代币的帐户/合约的地址。
        `_id` 参数必须是正在转移的代币类型。（代表 NFT）
        `_value` 参数必须是持有者余额减少的代币数量，并且与接收者余额增加的数量相匹配。
    */
    event Transfer(address indexed _from, address indexed _to, uint256 indexed _id, uint256 _value);

    /**
        @dev 当代币的批准地址被更改或重申时，会发出此事件。
        `_owner` 参数必须是批准提款的帐户/合约的地址。
        `_spender` 参数必须是被批准从 `_owner` 余额中提款的帐户/合约的地址。
        `_id` 参数必须是正在转移的代币类型。（代表 NFT）
        `_value` 参数必须是 `_approved` 能够从 `_owner` 余额中提款的代币数量。
    */
    event Approval(address indexed _owner, address indexed _spender, uint256 indexed _id, uint256 _value);

    /**
        @dev 当添加新的代币类型时，该类型代表非同质化代币的份额，会发出此事件。
        `_parentToken` 参数必须是非同质化代币合约的地址。
        `_parentTokenId` 参数必须是非同质化代币的代币 ID。
        `_id` 参数必须是正在添加的代币类型。（代表 NFT）
        `_totalSupply` 参数必须是代币类型的总代币供应量。
    */
    event TokenAddition(address indexed _parentToken, uint256 indexed _parentTokenId, uint256 _id, uint256 _totalSupply);

    /**
        @notice 将 `_value` 数量的 `_id` 从 msg.sender 地址转移到指定的 `_to` 地址
        @dev msg.sender 必须具有足够的余额来处理从帐户中转移出去的代币。
        如果 `_to` 是零地址，则必须恢复。
        如果 msg.sender 的 `_id` 代币余额低于正在转移的 `_value`，则必须恢复。
        必须在任何其他错误时恢复。
        必须发出 `Transfer` 事件以反映余额更改。
        @param _to      源地址
        @param _id      代币类型的 ID
        @param _value   转移数量
        @return         如果转移成功，则为 True，否则为 False
    */
    function transfer(address _to, uint256 _id, uint256 _value) external returns (bool);

    /**
        @notice 批准将 `_value` 数量的 `_id` 从 msg.sender 转移到指定的 `_spender` 地址。
        @dev 当 `_spender` 想要代表转移代币时，msg.sender 必须具有足够的余额来处理代币。
        如果 `_spender` 是零地址，则必须恢复。
        必须在任何其他错误时恢复。
        必须发出 `Approval` 事件。
        @param _spender Spender 地址（可以代表 msg.sender 提取代币的帐户/合约）
        @param _id      代币类型的 ID
        @param _value   批准数量
        @return         如果批准成功，则为 True，否则为 False
    */
    function approve(address _spender, uint256 _id, uint256 _value) external returns (bool);

    /**
        @notice 将 `_value` 数量的 `_id` 从 `_from` 地址转移到指定的 `_to` 地址。
        @dev 调用者必须被批准管理从 `_from` 帐户中转移出去的代币。
        如果 `_to` 是零地址，则必须恢复。
        如果持有者的 `_id` 代币余额低于发送的 `_value`，则必须恢复。
        必须在任何其他错误时恢复。
        必须发出 `Transfer` 事件以反映余额更改。
        @param _from    源地址
        @param _to      目标地址
        @param _id      代币类型的 ID
        @param _value   转移数量
        @return         如果转移成功，则为 True，否则为 False

    */
    function transferFrom(address _from, address _to, uint256 _id, uint256 _value) external returns (bool);

    /**
        @notice 将 NFT 设置为新的类型代币
        @dev 合约本身应在使用 `_parentNFTContractAddress` 和 `_parentNFTTokenId` 添加代币之前，验证 NFT 的所有权是否属于该合约本身。
        如果已经注册了相同的 NFT，则必须恢复。
        如果 `_parentNFTContractAddress` 是地址零，则必须恢复。
        如果 `_parentNFTContractAddress` 与 ERC-721 不兼容，则必须恢复。
        如果此合约本身不是 NFT 的所有者，则必须恢复。
        必须在任何其他错误时恢复。
        必须发出 `TokenAddition` 事件以反映代币类型添加。
        @param _parentNFTContractAddress    NFT 合约地址
        @param _parentNFTTokenId            NFT 代币 ID
        @param _totalSupply                 总代币供应量
    */
    function setParentNFT(address _parentNFTContractAddress, uint256 _parentNFTTokenId, uint256 _totalSupply) external;

    /**
        @notice 获取代币 ID 的总代币供应量。
        @param _id      代币的 ID
        @return         指定代币类型的总代币供应量
    */
    function totalSupply(uint256 _id) external view returns (uint256);

    /**
        @notice 获取帐户的代币余额。
        @param _owner  代币持有者的地址
        @param _id     代币的 ID
        @return        所请求的代币类型的 _owner 的余额
    */
    function balanceOf(address _owner, uint256 _id) external view returns (uint256);

    /**
        @notice 获取 `_spender` 仍然可以从 `_owner` 提取的数量
        @param _owner   代币持有者的地址
        @param _spender 被批准代表 `_owner` 提取代币的地址
        @param _id      代币的 ID
        @return         `_spender` 仍然可以从 `_owner` 提取的数量
    */
    function allowance(address _owner, address _spender, uint256 _id) external view returns (uint256);

    /**
        @notice 获取一个布尔值，该值表示该 NFT 是否已由此合约注册和分数化。
        @param _parentNFTContractAddress    NFT 合约地址
        @param _parentNFTTokenId            NFT 代币 ID
        @return                             表示 NFT 是否已注册的布尔值。
    */
    function isRegistered(address _parentNFTContractAddress, uint256 _parentNFTTokenId) external view returns (bool);
}

interface ERC165 {
    /**
        @notice 查询合约是否实现了接口
        @param interfaceID 接口标识符，如 ERC-165 中所指定
        @dev 接口标识在 ERC-165 中指定。此函数
        使用的 gas 小于 30,000。
        @return 如果合约实现了 `interfaceID` 且
        `interfaceID` 不是 0xffffffff，则返回 `true`，否则返回 `false`
    */
    function supportsInterface(bytes4 interfaceID) external view returns (bool);
}

/**
    @notice 处理 NFT 的接收
    @param _operator 调用 `safeTransferFrom` 函数的地址
    @param _from 先前拥有代币的地址
    @param _tokenId 正在转移的 NFT 标识符
    @param _data 没有指定格式的附加数据
    @return `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
*/
function onERC721Received(address _operator, address _from, uint256 _tokenId, bytes calldata _data) external pure returns (bytes4);