初探区块链数字加密资产标准ERC721

Posted 2021-10-15 JoeyHua

ERC721介绍

数字加密货币大致可以分为原生币（coin）和代币（token）两大类。前者如BTC、ETH等，拥有自己的区块链。后者如Tether、TRON、ONT等，依附于现有的区块链。市场上流通的基于以太坊的代币大都遵从ERC20协议。最近出现了一种被称为ERC721的数字加密资产，例如CryptoKitties。

ERC20可能是其中最广为人知的标准了。它诞生于2015年，到2017年9月被正式标准化。协议规定了具有可互换性（fungible）代币的一组基本接口，包括代币符号、发行量、转账、授权等。所谓可互换性（fungibility）指代币之间无差异，同等数量的两笔代币价值相等。交易所里流通的绝大部分代币都是可互换的，一单位的币无论在哪儿都价值一单位。

与之相对的则是非互换性（non-fungible）资产。比如CryptoKitties中的宠物猫就是典型的非互换性资产，因为每只猫各有千秋，而且由于不同辈分的稀缺性不同，市场价格也差异巨大。这种非标准化资产很长时间内都没有标准协议，直到2017年9月才出现ERC721提案，定义了一组常用的接口。ERC721至今仍旧处于草案阶段，但已经被不少dApp采用，甚至出现了专门的交易所。

ERC721标准

下面先给出ERC721标准的具体内容，后面会讲解。

每个符合ERC721标准的合约必须实现ERC721和ERC165接口。

pragma solidity ^0.4.20;

/// @title ERC-721 Non-Fungible Token Standard
/// @dev See https://eips.ethereum.org/EIPS/eip-721
///  Note: the ERC-165 identifier for this interface is 0x80ac58cd.
interface ERC721 /* is ERC165 */ {
    /// @dev This emits when ownership of any NFT changes by any mechanism.
    ///  This event emits when NFTs are created (`from` == 0) and destroyed
    ///  (`to` == 0). Exception: during contract creation, any number of NFTs
    ///  may be created and assigned without emitting Transfer. At the time of
    ///  any transfer, the approved address for that NFT (if any) is reset to none.
    event Transfer(address indexed _from, address indexed _to, uint256 indexed _tokenId);

    /// @dev This emits when the approved address for an NFT is changed or
    ///  reaffirmed. The zero address indicates there is no approved address.
    ///  When a Transfer event emits, this also indicates that the approved
    ///  address for that NFT (if any) is reset to none.
    event Approval(address indexed _owner, address indexed _approved, uint256 indexed _tokenId);

    /// @dev This emits when an operator is enabled or disabled for an owner.
    ///  The operator can manage all NFTs of the owner.
    event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);

    /// @notice Count all NFTs assigned to an owner
    /// @dev NFTs assigned to the zero address are considered invalid, and this
    ///  function throws for queries about the zero address.
    /// @param _owner An address for whom to query the balance
    /// @return The number of NFTs owned by `_owner`, possibly zero
    function balanceOf(address _owner) external view returns (uint256);

    /// @notice Find the owner of an NFT
    /// @dev NFTs assigned to zero address are considered invalid, and queries
    ///  about them do throw.
    /// @param _tokenId The identifier for an NFT
    /// @return The address of the owner of the NFT
    function ownerOf(uint256 _tokenId) external view returns (address);

    /// @notice Transfers the ownership of an NFT from one address to another address
    /// @dev Throws unless `msg.sender` is the current owner, an authorized
    ///  operator, or the approved address for this NFT. Throws if `_from` is
    ///  not the current owner. Throws if `_to` is the zero address. Throws if
    ///  `_tokenId` is not a valid NFT. When transfer is complete, this function
    ///  checks if `_to` is a smart contract (code size > 0). If so, it calls
    ///  `onERC721Received` on `_to` and throws if the return value is not
    ///  `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`.
    /// @param _from The current owner of the NFT
    /// @param _to The new owner
    /// @param _tokenId The NFT to transfer
    /// @param data Additional data with no specified format, sent in call to `_to`
    function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;

    /// @notice Transfers the ownership of an NFT from one address to another address
    /// @dev This works identically to the other function with an extra data parameter,
    ///  except this function just sets data to "".
    /// @param _from The current owner of the NFT
    /// @param _to The new owner
    /// @param _tokenId The NFT to transfer
    function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;

    /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE
    ///  TO CONFIRM THAT `_to` IS CAPABLE OF RECEIVING NFTS OR ELSE
    ///  THEY MAY BE PERMANENTLY LOST
    /// @dev Throws unless `msg.sender` is the current owner, an authorized
    ///  operator, or the approved address for this NFT. Throws if `_from` is
    ///  not the current owner. Throws if `_to` is the zero address. Throws if
    ///  `_tokenId` is not a valid NFT.
    /// @param _from The current owner of the NFT
    /// @param _to The new owner
    /// @param _tokenId The NFT to transfer
    function transferFrom(address _from, address _to, uint256 _tokenId) external payable;

    /// @notice Change or reaffirm the approved address for an NFT
    /// @dev The zero address indicates there is no approved address.
    ///  Throws unless `msg.sender` is the current NFT owner, or an authorized
    ///  operator of the current owner.
    /// @param _approved The new approved NFT controller
    /// @param _tokenId The NFT to approve
    function approve(address _approved, uint256 _tokenId) external payable;

    /// @notice Enable or disable approval for a third party ("operator") to manage
    ///  all of `msg.sender`\'s assets
    /// @dev Emits the ApprovalForAll event. The contract MUST allow
    ///  multiple operators per owner.
    /// @param _operator Address to add to the set of authorized operators
    /// @param _approved True if the operator is approved, false to revoke approval
    function setApprovalForAll(address _operator, bool _approved) external;

    /// @notice Get the approved address for a single NFT
    /// @dev Throws if `_tokenId` is not a valid NFT.
    /// @param _tokenId The NFT to find the approved address for
    /// @return The approved address for this NFT, or the zero address if there is none
    function getApproved(uint256 _tokenId) external view returns (address);

    /// @notice Query if an address is an authorized operator for another address
    /// @param _owner The address that owns the NFTs
    /// @param _operator The address that acts on behalf of the owner
    /// @return True if `_operator` is an approved operator for `_owner`, false otherwise
    function isApprovedForAll(address _owner, address _operator) external view returns (bool);
}

interface ERC165 {
    /// @notice Query if a contract implements an interface
    /// @param interfaceID The interface identifier, as specified in ERC-165
    /// @dev Interface identification is specified in ERC-165. This function
    ///  uses less than 30,000 gas.
    /// @return `true` if the contract implements `interfaceID` and
    ///  `interfaceID` is not 0xffffffff, `false` otherwise
    function supportsInterface(bytes4 interfaceID) external view returns (bool);
}

如果钱包程序接受安全转账，它必须实现钱包接口。

/// @dev Note: the ERC-165 identifier for this interface is 0x150b7a02.
interface ERC721TokenReceiver {
    /// @notice Handle the receipt of an NFT
    /// @dev The ERC721 smart contract calls this function on the recipient
    ///  after a `transfer`. This function MAY throw to revert and reject the
    ///  transfer. Return of other than the magic value MUST result in the
    ///  transaction being reverted.
    ///  Note: the contract address is always the message sender.
    /// @param _operator The address which called `safeTransferFrom` function
    /// @param _from The address which previously owned the token
    /// @param _tokenId The NFT identifier which is being transferred
    /// @param _data Additional data with no specified format
    /// @return `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`
    ///  unless throwing
    function onERC721Received(address _operator, address _from, uint256 _tokenId, bytes _data) external returns(bytes4);
}

ERC721接口解析

先来一波名词解释：

• NFT: 非互换性资产(non-fungible token)
• tokenId: NFT的id，类型为uint256
• owner: NFT的拥有者，类型为address
• balance: 用户拥有的NFT数量，类型为uint256
• approved: NFT的管理者，只有NFT的owner和approved可以对NFT进行操作，类型为address
• operator：operator拥有一个用户所有NFT的管理权限，类型为address

接下来解释下接口内的事件和方法：

event Transfer(address indexed _from, address indexed _to, uint256 indexed _tokenId);

当NFT被转移时会触发Transfer事件，在NFT被创建和销毁时也会触发此事件。在NFT被转移时，他的approved会被重置为零地址。

event Approval(address indexed _owner, address indexed _approved, uint256 indexed _tokenId);

当NFT的管理者，也就是approved被改变的时候，会触发Approval事件。如果approved是零地址，说明NFT没有管理者。

event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);

当NFT的owner指定一个用户拥有他所有NFT的管理权限时，会触发ApprovalForAll事件。operator拥有owner所有NFT的管理权限。

function function balanceOf(address _owner) external view returns (uint256);

查询一个用户拥有的NFT数量。

function ownerOf(uint256 _tokenId) external view returns (address);

查询一个NFT的拥有者。

function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;

NFT的拥有者或管理者把一个NFT转移给别人，当to是一个合约的地址时，这个方法会调用onERC721Received方法。

function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;

NFT的拥有者或管理者把一个NFT转移给别人，这个方法有一个额外的data参数，上面那个safeTransferFrom方法会调用这个方法，然后把data置为""。

function transferFrom(address _from, address _to, uint256 _tokenId) external payable;

NFT的拥有者或管理者把一个NFT转移给别人，可以看到，这个方法比起上面两个要少了个safe，说明是不安全的转移，转移者要自己验证to是不是一个正确的地址，如果不是的话，NFT可能会永久丢失。

function approve(address _approved, uint256 _tokenId) external payable;

NFT的拥有者把NFT的管理权限授予一个用户。

function setApprovalForAll(address _operator, bool _approved) external;

NFT的拥有者授权一个用户是否拥有自己所有NFT的管理权限。合约必须允许一个用户有多个operator。

function getApproved(uint256 _tokenId) external view returns (address);

查询一个NFT的管理者

function isApprovedForAll(address _owner, address _operator) external view returns (bool);

查询指定的operator是否拥有owner所有NFT的管理权限。

function supportsInterface(bytes4 interfaceID) external view returns (bool);

查询一个合约是否实现了一个接口。

function onERC721Received(address _operator, address _from, uint256 _tokenId, bytes _data) external returns(bytes4);

这个方法处理NFT的转移，当一笔转移被发起时，这个方法可能会被调用，目的是拒绝这次转移。

ERC721的实现

Github上已经有ERC721的实现了，地址：https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/token/ERC721/ERC721.sol

不过这是solidity的实现，并且基于公链，如果要基于联盟链，可以看一下我的这篇文章基于Hyperledger Fabric实现ERC721

参考

https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md
https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/token/ERC721/ERC721.sol
https://zhuanlan.zhihu.com/p/112275276

剖析非同质化代币ERC721-全面解析ERC721标准

什么是ERC-721？现在我们看到的各种加密猫猫狗狗都是基于ERC-721创造出来的，每只都是一个独一无二的ERC-721代币，不过ERC-721在区块链世界远不止猫猫狗狗，它更大的想象空间在于将物理世界的资产映射到区块链上。本文就来剖析下什么是ERC721.

ERC721是什么

在创建代币一篇，我们讲到过ERC20代币，
和ERC20一样，ERC721同样是一个代币标准，ERC721官方简要解释是Non-Fungible Tokens，简写为NFTs，多翻译为非同质代币。

ERC721 是由Dieter Shirley 在2017年9月提出。Dieter Shirley 正是谜恋猫CryptoKitties背后的公司Axiom Zen的技术总监。因此谜恋猫也是第一个实现了ERC721 标准的去中心化应用。ERC721号提议已经被以太坊作为标准接受，但该标准仍处于草稿阶段。本文介绍的ERC721标准基于最新(2018/03/23官方提议。

那怎么理解非同质代币呢?

非同质代表独一无二，谜恋猫为例，每只猫都被赋予拥有基因，是独一无二的（一只猫就是一个NFTs），猫之间是不能置换的。这种独特性使得某些稀有猫具有收藏价值，也因此受到追捧。

ERC20代币是可置换的，且可细分为N份（1 = 10 * 0.1）, 而ERC721的Token最小的单位为1，无法再分割。

如果同一个集合的两个物品具有不同的特征，这两个物品是非同质的，而同质是某个部分或数量可以被另一个同等部分或数量所代替。

非同质性其实广泛存在于我们的生活中，如图书馆的每一本，宠物商店的每一只宠物，歌手所演唱的歌曲，花店里不同的花等等，因此ERC721合约必定有广泛的应用场景。通过这样一个标准，也可建立跨功能的NFTs管理和销售平台（就像有支持ERC20的交易所和钱包一样），使生态更加强大。

ERC721标准

ERC721最为一个合约标准，提供了在实现ERC721代币时必须要遵守的协议，要求每个ERC721标准合约需要实现ERC721及ERC165接口，接口定义如下：

pragma solidity ^0.4.20;

interface ERC721 /* is ERC165 */ {

    event Transfer(address indexed _from, address indexed _to, uint256 _tokenId);
    event Approval(address indexed _owner, address indexed _approved, uint256 _tokenId);
    event ApprovalForAll(address indexed _owner, address indexed _operator, bool _approved);

    function balanceOf(address _owner) external view returns (uint256);
    function ownerOf(uint256 _tokenId) external view returns (address);

    function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;
    function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;
    function transferFrom(address _from, address _to, uint256 _tokenId) external payable;

    function approve(address _approved, uint256 _tokenId) external payable;
    function setApprovalForAll(address _operator, bool _approved) external;
    function getApproved(uint256 _tokenId) external view returns (address);
    function isApprovedForAll(address _owner, address _operator) external view returns (bool);
}

接口说明：

• balanceOf(): 返回由_owner 持有的NFTs的数量。
• ownerOf(): 返回tokenId代币持有者的地址。
• approve(): 授予地址_to具有_tokenId的控制权，方法成功后需触发Approval 事件。
• setApprovalForAll(): 授予地址_operator具有所有NFTs的控制权，成功后需触发ApprovalForAll事件。

• getApproved()、isApprovedForAll(): 用来查询授权。

• safeTransferFrom(): 转移NFT所有权，一次成功的转移操作必须发起 Transer 事件。函数的实现需要做一下几种检查：
  1. 调用者msg.sender应该是当前tokenId的所有者或被授权的地址
  2. _from 必须是 _tokenId的所有者
  3. _tokenId 应该是当前合约正在监测的NFTs 中的任何一个
  4. _to 地址不应该为 0
  5. 如果_to 是一个合约应该调用其onERC721Received方法, 并且检查其返回值，如果返回值不为bytes4(keccak256("onERC721Received(address,uint256,bytes)"))抛出异常。
     一个可接收NFT的合约必须实现ERC721TokenReceiver接口：

     interface ERC721TokenReceiver {
     /// @return `bytes4(keccak256("onERC721Received(address,uint256,bytes)"))`
     function onERC721Received(address _from, uint256 _tokenId, bytes data) external returns(bytes4);
     }

• transferFrom(): 用来转移NFTs, 方法成功后需触发Transfer事件。调用者自己确认_to地址能正常接收NFT，否则将丢失此NFT。此函数实现时需要检查上面条件的前4条。

ERC165 标准

ERC721标准同时要求必须符合ERC165标准 ，其接口如下：

interface ERC165 {
    function supportsInterface(bytes4 interfaceID) external view returns (bool);
}

ERC165同样是一个合约标准，这个标准要求合约提供其实现了哪些接口，这样再与合约进行交互的时候可以先调用此接口进行查询。
interfaceID为函数选择器，计算方式有两种，如：bytes4(keccak256(‘supportsInterface(bytes4)‘));或ERC165.supportsInterface.selector，多个函数的接口ID为函数选择器的异或值。
关于ERC165，这里不深入介绍，有兴趣的同学可以阅读官方提案。

可选实现接口：ERC721Metadata

ERC721Metadata 接口用于提供合约的元数据：name , symbol 及 URI（NFT所对应的资源）。
其接口定义如下：

interface ERC721Metadata /* is ERC721 */ {
    function name() external pure returns (string _name);
    function symbol() external pure returns (string _symbol);
    function tokenURI(uint256 _tokenId) external view returns (string);
}

接口说明：

• name(): 返回合约名字，尽管是可选，但强烈建议实现，即便是返回空字符串。
• symbol(): 返回合约代币符号，尽管是可选，但强烈建议实现，即便是返回空字符串。
• tokenURI(): 返回_tokenId所对应的外部资源文件的URI（通常是IPFS或HTTP(S)路径）。外部资源文件需要包含名字、描述、图片，其格式的要求如下：

  {
  "title": "Asset Metadata",
  "type": "object",
  "properties": {
      "name": {
          "type": "string",
          "description": "Identifies the asset to which this NFT represents",
      },
      "description": {
          "type": "string",
          "description": "Describes the asset to which this NFT represents",
      },
      "image": {
          "type": "string",
          "description": "A URI pointing to a resource with mime type image/* representing the asset to which this NFT represents. Consider making any images at a width between 320 and 1080 pixels and aspect ratio between 1.91:1 and 4:5 inclusive.",
      }
  }
  }

  tokenURI通常是被web3调用，以便在应用层做相应的查询和展示。

可选实现接口：ERC721Enumerable

ERC721Enumerable的主要目的是提高合约中NTF的可访问性，其接口定义如下：

interface ERC721Enumerable /* is ERC721 */ {
    function totalSupply() external view returns (uint256);
    function tokenByIndex(uint256 _index) external view returns (uint256);
    function tokenOfOwnerByIndex(address _owner, uint256 _index) external view returns (uint256);
}

接口说明：

• totalSupply(): 返回NFT总量
• tokenByIndex(): 通过索引返回对应的tokenId。
• tokenOfOwnerByIndex(): 所有者可以一次拥有多个的NFT, 此函数返回_owner拥有的NFT列表中对应索引的tokenId。

补充说明

NTF IDs

NTF ID，即tokenId，在合约中用唯一的uint265进行标识，每个NFT的ID在智能合约的生命周期内不允许改变。推荐的实现方式有：

1. 从0开始，每新加一个NFT，NTF ID加1
2. 使用sha3后uuid 转换为 NTF ID

与ERC-20的兼容性

ERC721标准尽可能遵循 ERC-20 的语义，但由于同质代币与非同质代币之间的根本差异，并不能完全兼容ERC-20。

交易、挖矿、销毁

在实现transter相关接口时除了满足上面的的条件外，我们可以根据需要添加自己的逻辑，如加入黑名单等。
同时挖矿、销毁尽管不是标准的一部分，我们可以根据需要实现。

参考实现

参考实现为订阅用户专有福利，请订阅我的小专栏：区块链技术查看。

## 参考文献 1. [EIPS-165](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-165.md) 2. [EIPS-721](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md) 3. [深入浅出区块链](https://learnblockchain.cn/) - 系统学习区块链，打造最好的区块链技术博客。