ERC-7651: 部分代表的非同质化代币

interface IERC7651 is IERC165 {
  /// @dev 当给定 spender 的部分表示批准被更改或重申时，会发布此事件。
  event FractionalApproval(address indexed owner, address indexed spender, uint256 value);

  /// @dev 当通过任何机制更改部分表示代币的所有权时，会发布此事件。
  ///      当代币被创建和销毁时，会发布此事件，
  ///      即当 from 和 to 分别被分配到零地址时。
  event FractionalTransfer(address indexed from, address indexed to, uint256 amount);

  /// @dev 当为所有者启用或禁用操作员时，会发布此事件。
  ///      操作员可以管理所有者的所有 NFT。
  event ApprovalForAll(
    address indexed owner,
    address indexed operator,
    bool approved
  );

  /// @dev 当给定 NFT 的批准 spender 被更改或重申时，会发布此事件。
  ///      作为 spender 发布的零地址意味着没有地址被批准用于此代币。
  event NonFungibleApproval(
    address indexed owner,
    address indexed spender,
    uint256 indexed id
  );

  /// @dev 当任何 NFT 的所有权通过任何机制更改时，会发布此事件。
  ///      当 NFT 被创建和销毁时，会发布此事件，
  ///      即当 from 和 to 分别被分配到零地址时。
  event NonFungibleTransfer(address indexed from, address indexed to, uint256 indexed id);

  /// @notice 部分表示中的小数位数
  /// @dev 小数位用作确定余额或数量何时
  ///      包含整体或纯粹部分组件的手段
  /// @return 部分表示中使用的小数位数
  function decimals() external view returns (uint8 decimals);

  /// @notice 以部分表示的代币总供应量
  /// @dev 可以通过计算来恢复 NFT 的总供应量
  ///      `totalSupply() / 10 ** decimals()`
  /// @return 以部分表示的代币总供应量
  function totalSupply() external view returns (uint256 totalSupply);

  /// @notice 给定地址以部分表示的余额
  /// @dev 可以通过计算来恢复 NFT 的总供应量
  ///      `totalSupply() / 10 ** decimals()`
  /// @param owner_ 拥有代币的地址
  /// @return 给定地址以部分表示的余额
  function balanceOf(address owner_) external view returns (uint256 balance);

  /// @notice 查询地址是否为另一个地址的授权操作员
  /// @param owner_ 拥有 NFT 的地址
  /// @param operator_ 被检查是否已被批准代表所有者行事的地址
  /// @return 如果 `operator_` 是 `owner_` 的批准操作员，则为 True，否则为 false
  function isApprovedForAll(
    address owner_,
    address operator_
  ) external view returns (bool isApproved);

  /// @notice 查询地址可以为另一个地址花费的允许金额
  /// @param owner_ 拥有部分表示代币的地址
  /// @param spender_ 被检查是否已被批准代表所有者花费的地址
  /// @return 批准 `spender_` 代表 `owner_` 花费的代币数量
  function allowance(
    address owner_,
    address spender_
  ) external view returns (uint256 allowance);

  /// @notice 查询特定 NFT 的所有者。
  /// @dev 由零地址拥有的代币被认为是无效的，应在所有权查询时恢复。
  /// @param id_ NFT 的唯一标识符。
  /// @return 代币所有者的地址。
  function ownerOf(uint256 id_) external view returns (address owner);

  /// @notice 设置批准地址以花费部分金额，
  ///         或花费特定 NFT。
  /// @dev 有效 id 和部分值之间不得有重叠。
  /// @dev 除非 `msg.sender` 是当前 NFT 所有者，或者如果是 id，则是当前所有者的授权
  ///      操作员，否则会抛出异常。
  /// @dev 如果 id 不是有效的 NFT，则抛出异常
  /// @param spender_ 给定代币或价值的 spender。
  /// @param amountOrId_ 要批准的部分值或 id。
  /// @return 批准操作是否成功。
  function approve(
    address spender_,
    uint256 amountOrId_
  ) external returns (bool success);

  /// @notice 设置批准第三方来管理调用者的所有
  ///         非同质化资产
  /// @param operator_ 要添加到调用者授权操作员集的地址
  /// @param approved_ 如果操作员已批准，则为 True，如果未批准，则为 false
  function setApprovalForAll(address operator_, bool approved_) external;

  /// @notice 将部分代币或 NFT 从一个地址转移到另一个地址
  /// @dev 有效 id 和部分值之间不得有重叠
  /// @dev 如果调用者不是 `from_` 或未被批准，则该操作应恢复
  ///      花费 `from_` 拥有的代币或 NFT
  /// @dev 如果值小于 `from_` 的余额或
  ///      如果 NFT 不属于 `from_`，则该操作应恢复
  /// @dev 如果 id 不是有效的 NFT，则抛出异常
  /// @param from_ 从中转移部分代币或 NFT 的地址
  /// @param to_ 将部分代币或 NFT 转移到的地址
  /// @param amountOrId_ 要转移的部分值或不同的 NFT id
  /// @return 如果操作成功，则为 True
  function transferFrom(
    address from_,
    address to_,
    uint256 amountOrId_
  ) external returns (bool success);

  /// @notice 将部分代币从一个地址转移到另一个地址
  /// @dev 如果 amount 小于 `from_` 的余额，则该操作应恢复
  /// @param to_ 将部分代币转移到的地址
  /// @param amount_ 要转移的部分值
  /// @return 如果操作成功，则为 True
  function transfer(address to_, uint256 amount_) external returns (bool success);

  /// @notice 将 NFT 的所有权从一个地址转移到另一个地址
  /// @dev 除非 `msg.sender` 是当前所有者，否则会抛出异常，
  ///      操作员，或此 NFT 的批准地址
  /// @dev 如果 `from_` 不是当前所有者，则抛出异常
  /// @dev 如果 `to_` 是零地址，则抛出异常
  /// @dev 如果 `tokenId_` 不是有效的 NFT，则抛出异常
  /// @dev 当转移完成时，此函数会检查 `to_` 是否为
  ///      智能合约（代码大小 > 0）。如果是，它会调用 `onERC721Received`
  ///      在 `to_` 上，如果返回值不是
  ///      `bytes4(keccak256("onERC721Received(address,uint256,bytes)"))`，则抛出异常。
  /// @param from_ 从中转移 NFT 的地址
  /// @param to_ 将 NFT 转移到的地址
  /// @param tokenId_ 要转移的 NFT
  /// @param data_ 没有指定格式的附加数据，在对 `to_` 的调用中发送
  function safeTransferFrom(
    address from_,
    address to_,
    uint256 id_,
    bytes calldata data_
  ) external;

  /// @notice 将 NFT 的所有权从一个地址转移到另一个地址
  /// @dev 这与上述函数 safeTransferFrom 接口相同
  ///      虽然必须将空字节作为数据传递给 `to_`
  /// @param from_ 从中转移 NFT 的地址
  /// @param to_ 将 NFT 转移到的地址
  /// @param tokenId_ 要转移的 NFT
  function safeTransferFrom(address from_, address to_, uint256 id_) external;
}

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

/// @title ERC-7651 部分非同质化代币标准，可选元数据扩展
interface IERC7651Metadata {
  /// @notice 给定代币集合的描述性长名称
  function name() external view returns (string memory name);

  /// @notice 给定代币集合的缩写短名称
  function symbol() external view returns (string memory symbol);

  /// @notice 给定资产的不同的统一资源标识符 (URI)。
  /// @dev 如果 `tokenId_` 不是有效的 NFT，则抛出异常。URI 在 RFC 中定义
  ///      3986. URI 可以指向符合 "ERC721
  ///      元数据 JSON 模式" 的 JSON 文件。
  /// @param id_ 要获取代币 URI 的 NFT
  /// @return 代币的 URI 作为字符串
  function tokenURI(uint256 id_) external view returns (string memory uri);
}

interface IERC7651NFTBanking {
  /// @notice 获取已铸造但当前未拥有的 NFT 数量。
  /// @dev 这应该是未拥有的 NFT 数量，受总数限制
  ///      部分供应。
  /// @return 当前未拥有的 NFT 数量。
  function getBankedNFTsLength() external view returns (uint256 bankedNFTsLength);

  /// @notice 获取已铸造但当前未拥有的 NFT 的分页列表。
  /// @param start_ 银行中的起始索引。
  /// @param count_ 从起始索引返回的代币数量，包括起始索引。
  /// @return 从 `start_` 开始的 banked NFT 数组，最大长度为 `count_`。
  function getBankedNFTs(
    uint256 start_,
    uint256 count_
  ) external view returns (uint256[] memory bankedNFTs);

  /// @notice 查询当前流通中的 NFT 供应量。
  /// @dev 给定供应量可能仍然是 banked 或未铸造的，此函数应始终是
  ///      由 `totalSupply() / 10 ** decimals()` 包含性地限制的上限。
  /// @return 已铸造的 NFT 的当前供应量
  function totalNonFungibleSupply() external view returns (unit256);
}

interface IERC7651NFTTransferExemptable {
  /// @notice 返回地址是否免于 NFT 转移。
  /// @param account_ 要检查的地址。
  /// @return 地址是否免于 NFT 转移。
  isNFTTransferExempt(address account_) external view returns (bool);

  /// @notice 允许地址将自己设置为免于 NFT 转移。
  /// @param isExempt_ 标志，true 表示免除，false 表示不免除。
  setSelfNFTTransferExempt(bool isExempt_) external;
}