pragma solidity ^0.4.20;

/// @title ERC-721 非同质化代币标准
/// @dev 参见 https://eips.ethereum.org/EIPS/eip-721
///  注意：此接口的ERC-165标识符是 0x80ac58cd
interface ERC721 /* 继承自 ERC165 */ {
    /// @dev 当任何NFT的所有权通过任何机制发生变化时触发此事件
    ///  创建NFT时（`from` == 0）和销毁NFT时（`to` == 0）会触发此事件
    ///  例外：在合约创建期间，可以创建和分配任意数量的NFT而不触发Transfer事件
    ///  在任何转移时，该NFT的批准地址（如果有）将重置为无。
    event Transfer(address indexed _from, address indexed _to, uint256 indexed _tokenId);

    /// @dev 当NFT的批准地址更改或重新确认时触发此事件
    ///  零地址表示没有批准的地址
    ///  当触发Transfer事件时，这也表示该NFT的批准地址（如果有）将重置为无
    event Approval(address indexed _owner, address indexed _approved, uint256 indexed _tokenId);

    /// @dev 当为所有者启用或禁用操作者时触发此事件
    ///  操作者可以管理所有者的所有NFT
    event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);

    /// @notice 计算分配给所有者的所有NFT数量
    /// @dev 分配给零地址的NFT被视为无效，此函数对零地址的查询会抛出异常
    /// @param _owner 要查询余额的地址
    /// @return `_owner`拥有的NFT数量，可能为零
    function balanceOf(address _owner) external view returns (uint256);

    /// @notice 查找NFT的所有者
    /// @dev 分配给零地址的NFT被视为无效，对其查询会抛出异常
    /// @param _tokenId NFT的标识符
    /// @return NFT所有者的地址
    function ownerOf(uint256 _tokenId) external view returns (address);

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

    /// @notice 将NFT的所有权从一个地址转移到另一个地址
    /// @dev 此函数与带有额外数据参数的其他函数功能相同，
    ///  只是此函数将数据设置为""
    /// @param _from NFT的当前所有者
    /// @param _to 新所有者
    /// @param _tokenId 要转移的NFT
    function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;

    /// @notice 转移NFT的所有权 — 调用者有责任
    ///  确认`_to`能够接收NFT，否则
    ///  NFT可能永久丢失
    /// @dev 除非`msg.sender`是当前所有者、授权操作者或此NFT的批准地址，否则抛出异常
    ///  如果`_from`不是当前所有者，则抛出异常。如果`_to`是零地址，则抛出异常
    ///  如果`_tokenId`不是有效的NFT，则抛出异常
    /// @param _from NFT的当前所有者
    /// @param _to 新所有者
    /// @param _tokenId 要转移的NFT
    function transferFrom(address _from, address _to, uint256 _tokenId) external payable;

    /// @notice 更改或重新确认NFT的批准地址
    /// @dev 零地址表示没有批准的地址
    ///  除非`msg.sender`是当前NFT所有者或当前所有者的授权操作者，否则抛出异常
    /// @param _approved 新的NFT批准控制器
    /// @param _tokenId 要批准的NFT
    function approve(address _approved, uint256 _tokenId) external payable;

    /// @notice 启用或禁用第三方（"操作者"）管理
    ///  所有`msg.sender`资产
    /// @dev 触发ApprovalForAll事件。合约必须允许
    ///  每个所有者有多个操作者
    /// @param _operator 要添加到授权操作者集合的地址
    /// @param _approved 如果操作者被批准则为true，撤销批准则为false
    function setApprovalForAll(address _operator, bool _approved) external;

    /// @notice 获取单个NFT的批准地址
    /// @dev 如果`_tokenId`不是有效的NFT，则抛出异常
    /// @param _tokenId 要查找批准地址的NFT
    /// @return 此NFT的批准地址，如果没有则为零地址
    function getApproved(uint256 _tokenId) external view returns (address);

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

interface ERC165 {
    /// @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);
}

/// @dev 注意：此接口的ERC-165标识符是 0x150b7a02。
interface ERC721TokenReceiver {
    /// @notice 处理NFT的接收
    /// @dev ERC721智能合约在`transfer`之后在接收者上调用此函数。
    ///  此函数可能抛出异常来回滚并拒绝转移。
    ///  返回非魔法值的其他值必须导致交易被回滚。
    ///  注意：合约地址始终是消息发送者。
    /// @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 _data) external returns(bytes4);
}

/// @title ERC-721 非同质化代币标准，可选元数据扩展
/// @dev 参见 https://eips.ethereum.org/EIPS/eip-721
///  注意：此接口的ERC-165标识符是 0x5b5e139f。
interface ERC721Metadata /* 继承自 ERC721 */ {
    /// @notice 此合约中NFT集合的描述性名称
    function name() external view returns (string _name);

    /// @notice 此合约中NFT的缩写名称
    function symbol() external view returns (string _symbol);

    /// @notice 给定资产的唯一资源标识符（URI）
    /// @dev 如果`_tokenId`不是有效的NFT，则抛出异常
    ///  URI在RFC 3986中定义。URI可能指向符合"ERC721
    ///  元数据JSON模式"的JSON文件
    function tokenURI(uint256 _tokenId) external view returns (string);
}

{
    "title": "资产元数据",
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "标识此NFT代表的资产"
        },
        "description": {
            "type": "string",
            "description": "描述此NFT代表的资产"
        },
        "image": {
            "type": "string",
            "description": "指向表示此NFT代表资产的mime类型为image/*资源的URI。建议使图像宽度在320到1080像素之间，宽高比在1.91:1到4:5之间"
        }
    }
}

/// @title ERC-721 非同质化代币标准，可选枚举扩展
/// @dev 参见 https://eips.ethereum.org/EIPS/eip-721
///  注意：此接口的ERC-165标识符是 0x780e9d63。
interface ERC721Enumerable /* 继承自 ERC721 */ {
    /// @notice 计算此合约跟踪的NFT数量
    /// @return 此合约跟踪的有效NFT数量，其中每个NFT
    ///  都有一个已分配且可查询的所有者，不等于零地址
    function totalSupply() external view returns (uint256);

    /// @notice 枚举有效NFT
    /// @dev 如果`_index` >= `totalSupply()`，则抛出异常。
    /// @param _index 小于`totalSupply()`的计数器
    /// @return 第`_index`个NFT的代币标识符，
    ///  （排序顺序未指定）
    function tokenByIndex(uint256 _index) external view returns (uint256);

    /// @notice 枚举分配给所有者的NFT
    /// @dev 如果`_index` >= `balanceOf(_owner)`或如果
    ///  `_owner`是零地址（代表无效的NFT），则抛出异常。
    /// @param _owner 我们对其拥有的NFT感兴趣的地址
    /// @param _index 小于`balanceOf(_owner)`的计数器
    /// @return 分配给`_owner`的第`_index`个NFT的代币标识符，
    ///   （排序顺序未指定）
    function tokenOfOwnerByIndex(address _owner, uint256 _index) external view returns (uint256);
}