SIP-721 標準 ​

pragma solidity ^0.4.20;

/// @title ERC-721非同质化代币标准
/// @dev 參考 https://learnblockchain.cn/docs/eips/eip-721.html
///  注意：ERC-165 接口id為 0x80ac58cd。
interface ERC721 /* is ERC165 */ {
    /// @dev 當任何NFT的所有權更改時（不管哪種方式），就會觸發此事件。
    ///  包括在創建時（`from` == 0）和銷毀時(`to` == 0)，合約創建時除外。
    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 所有者啟用或禁用操作員時觸發。（操作員可管理所有者所持有的NFTs）
    event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);

    /// @notice 統計所持有的NFTs數量
    /// @dev NFT 不能分配給零地址，查詢零地址同樣會拋出異常
    /// @param _owner ： 待查地址
    /// @return 返回數量，也許是0
    function balanceOf(address _owner) external view returns (uint256);

    /// @notice 返回所有者
    /// @dev NFT 不能分配給零地址，查詢零地址拋出異常
    /// @param _tokenId NFT 的id
    /// @return 返回所有者地址
    function ownerOf(uint256 _tokenId) external view returns (address);

    /// @notice 將NFT的所有權從一個地址轉移到另一個地址
    /// @dev 如果`msg.sender` 不是當前的所有者（或授權者）拋出異常
    /// 如果 `_from` 不是所有者、`_to` 是零地址、`_tokenId` 不是有效id 均拋出異常。
    ///  當轉移完成時，函數檢查  `_to` 是否是合約，如果是，調用 `_to`的 `onERC721Received` 並且檢查返回值是否是 `0x150b7a02`（即：`bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`）  如果不是拋出異常。
    /// @param _from ：當前的所有者
    /// @param _to ：新的所有者
    /// @param _tokenId ：要轉移的token id.
    /// @param data 其他參數
    function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;

    /// @notice 將NFT的所有權從一個地址轉移到另一個地址
    /// @dev 當轉移完成時，函數檢查 `_to` 是否是合約，如果是，調用 `_to`的 `onERC721Received` 並且檢查返回值是否是 `0x150b7a02`（即：`bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`）  如果不是拋出異常。
    ///  當轉移完成時，發出一個 `Transfer` 事件。
    /// @param _from ：當前的所有者
    /// @param _to ：新的所有者
    /// @param _tokenId ：要轉移的token id.
    function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;

    /// @notice 將NFT的所有權從一個地址轉移到另一個地址
    /// @dev 如果`msg.sender` 不是當前的所有者（或授權者）拋出異常
    /// 如果 `_from` 不是所有者、`_to` 是零地址、`_tokenId` 不是有效id 均拋出異常。
    /// @param _from ：當前的所有者
    /// @param _to ：新的所有者
    /// @param _tokenId ：要轉移的token id.
    function transferFrom(address _from, address _to, uint256 _tokenId) external payable;

    /// @notice 批准地址的NFT，這個地址可以操作所有的NFT。
    /// @dev 在`Approval`事件觸發之前，合約必須允許所有者通過`ownerOf`函數查詢NFT。
    /// @param _approved ：權限被授權給的地址。
    /// @param _tokenId ：NFT的id。
    function approve(address _approved, uint256 _tokenId) external payable;

    /// @notice 批准或撤銷對另一個地址的授權操作。
    /// @dev 實現合約必須要檢查 `operator` 是否能操作所有者 `_owner` 所持有的NFT。
    /// @param _operator ： 操作者的地址。
    /// @param _approved ： 是否批准操作者。
    function setApprovalForAll(address _operator, bool _approved) external;

    /// @notice 獲取操作者對所有者地址的授權狀態。
    /// @param _owner ： 所有者的地址。
    /// @param _operator ： 操作者的地址。
    /// @return 返回真，如果操作者被授權操作所有者地址的NFT。
    function isApprovedForAll(address _owner, address _operator) external view returns (bool);
}

interface ERC165 {
    /// @notice 判斷合約是否實現了接口
    /// @param interfaceID ERC-165 定義的接口 ID
    /// @dev 函數執行需要少於 30,000 gas。
    /// @return 如果合約實現了 interfaceID（不等於 0xffffffff），則返回 true，否則返回 false。
    function supportsInterface(bytes4 interfaceID) external view returns (bool);
}

/// @dev 根據 ERC-165 標準，介面 ID 為 0x150b7a02。
interface ERC721TokenReceiver {
    /// @notice 處理接收NFT
    /// @dev 在 ERC721 智能合約的 `transfer` 函數完成後，在接收地址上調用此函數。
    /// 函數可以通過 revert 拒絕接收。返回非 `0x150b7a02` 也是拒絕接收。
    /// 注意：調用此函數的 `msg.sender` 是 ERC721 的合約地址。
    /// @param _operator：調用 `safeTransferFrom` 函數的地址。
    /// @param _from：之前的NFT擁有者。
    /// @param _tokenId：NFT token ID。
    /// @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://learnblockchain.cn/docs/eips/eip-721.html
///  注意：根據 ERC-165 標準，介面 ID 為 0x5b5e139f。
interface ERC721Metadata /* is ERC721 */ {
    /// @notice NFTs 集合的名稱
    function name() external view returns (string _name);

    /// @notice NFTs 縮寫代號
    function symbol() external view returns (string _symbol);

    /// @notice 一個給定資產的唯一統一資源標識符（URI）
    /// @dev 如果 `_tokenId` 無效，拋出異常。URIs 在 RFC 3986 定義，
    /// URI 也許指向一個符合 "ERC721 元數據 JSON Schema" 的 JSON 文件。
    function tokenURI(uint256 _tokenId) external view returns (string);
}

/// @title ERC-721非同質化代幣標準枚舉擴展信息
/// @dev 參考 https://learnblockchain.cn/docs/eips/eip-721.html
///  注意：根據 ERC-165 標準，介面 ID 為 0x780e9d63。
interface ERC721Enumerable /* is ERC721 */ {
    /// @notice  NFTs 計數
    /// @return  返回合約有效跟踪（所有者不為零地址）的 NFT 數量
    function totalSupply() external view returns (uint256);

    /// @notice 枚舉索引NFT
    /// @dev 如果 `_index` >= `totalSupply()` 則拋出異常
    /// @param _index 小於 `totalSupply()` 的索引號
    /// @return 對應的 token id（標準不指定排序方式)
    function tokenByIndex(uint256 _index) external view returns (uint256);

    /// @notice 枚舉索引某個所有者的 NFTs
    /// @dev  如果 `_index` >= `balanceOf(_owner)` 或 `_owner` 是零地址，拋出異常
    /// @param _owner 查詢的所有者地址
    /// @param _index 小於 `balanceOf(_owner)` 的索引號
    /// @return 對應的 token id （標準不指定排序方式)
    function tokenOfOwnerByIndex(address _owner, uint256 _index) external view returns (uint256);
}