ERC721
《什么是ERC-721 代币?》
《智能合约NFT之ERC721代币详解》
本质上说就是定义的函数接口标准
ERC721标准
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
| pragma solidity ^0.4.20;
interface ERC721 { /// @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的所有权从一个地址转移到另一个地址,功能同上,不带data参数。 function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;
/// @notice 转移所有权 -- 调用者负责确认`_to`是否有能力接收NFTs,否则可能永久丢失。 /// @dev 如果`msg.sender` 不是当前的所有者(或授权者、操作员)抛出异常 /// 如果 `_from` 不是所有者、`_to` 是零地址、`_tokenId` 不是有效id 均抛出异常。 function transferFrom(address _from, address _to, uint256 _tokenId) external payable;
/// @notice 更改或确认NFT的授权地址 /// @dev 零地址表示没有授权的地址。 /// 如果`msg.sender` 不是当前的所有者或操作员 /// @param _approved 新授权的控制者 /// @param _tokenId : token id 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` 无效,抛出异常。 /// @param _tokenId : token id /// @return 返回授权地址, 零地址表示没有。 function getApproved(uint256 _tokenId) external view returns (address);
/// @notice 查询一个地址是否是另一个地址的授权操作员 /// @param _owner 所有者 /// @param _operator 代表所有者的授权操作员 function isApprovedForAll(address _owner, address _operator) external view returns (bool); }
|
解析与实现
Transfer event
当任何NFT的所有权更改时(不管哪种方式),就会触发此事件,即成立为交易(包括创建,转让,销毁)
Approval event
当更改或确认NFT的授权地址时触发。
ApprovalForAll event
所有者启用或禁用授权第三方(操作员)管理时触发。
balanceOf*
查找owner的资产数量,参数_owner,返回数量
ownerOf*
查找资产对应所有者,参数资产tokenid,返回拥有者
safeTransferFrom
安全的资产所有权转移(修改owner),参数当前所有者、目的所有者、资产tokenid、任意备注(可不带)
transferFrom*
资产所有权转移,相比safeTransferFrom参数一致
approve*
更改或确认NFT的授权地址,参数新授权人、资产tokenid
setApprovalForAll
所有者启用或禁用授权第三方(操作员)管理,参数要授权的的操作员、启用/禁用布尔值
getApproved*
获取资产授权地址,参数资产tokenid,返回授权地址
isApprovedForAll
查询一个操作员是否是一个所有者的授权操作员,参数所有者、操作员
链码分析
资产本身的信息是一组需要区块链记录的结构体,还有每次进行交易时希望对交易信息进行记录则交易信息也设定为一结构体(特殊类型定义为string 设置为宏定义方便转换用)