剖析非同质化代币ERC721-全面解析ERC721标准
有个胖子他姓杨
发表于 2022-11-12 14:36:13
205
0
0
ERC721是什么& @: i8 L- X9 d8 @# \
在创建代币一篇,我们讲到过ERC20代币,
和ERC20一样,ERC721同样是一个代币标准,ERC721官方简要解释是Non-Fungible Tokens,简写为NFTs,多翻译为非同质代币。
* F5 L6 _( w! O
ERC721 是由Dieter Shirley 在2017年9月提出。Dieter Shirley 正是谜恋猫CryptoKitties背后的公司Axiom Zen的技术总监。因此谜恋猫也是第一个实现了ERC721 标准的去中心化应用。ERC721号提议已经被以太坊作为标准接受,但该标准仍处于草稿阶段。本文介绍的ERC721标准基于最新(2018/03/23官方提议。
那怎么理解非同质代币呢?: ] C" P' ]# v) O% ?5 y, `7 l4 P
非同质代表独一无二,谜恋猫为例,每只猫都被赋予拥有基因,是独一无二的(一只猫就是一个NFTs),猫之间是不能置换的。这种独特性使得某些稀有猫具有收藏价值,也因此受到追捧。
ERC20代币是可置换的,且可细分为N份(1 = 10 * 0.1), 而ERC721的Token最小的单位为1,无法再分割。( V9 ~1 m8 f4 Q# ~0 s0 E$ X3 Y
如果同一个集合的两个物品具有不同的特征,这两个物品是非同质的,而同质是某个部分或数量可以被另一个同等部分或数量所代替。- w% H. H1 h9 \
非同质性其实广泛存在于我们的生活中,如图书馆的每一本,宠物商店的每一只宠物,歌手所演唱的歌曲,花店里不同的花等等,因此ERC721合约必定有广泛的应用场景。通过这样一个标准,也可建立跨功能的NFTs管理和销售平台(就像有支持ERC20的交易所和钱包一样),使生态更加强大。9 b! L2 a& I% I' C. T9 m( V. L' j* v
ERC721标准% l/ L* P' m6 c$ A4 b8 Z, ~
ERC721最为一个合约标准,提供了在实现ERC721代币时必须要遵守的协议,要求每个ERC721标准合约需要实现ERC721及ERC165接口,接口定义如下:9 p& B5 s$ T; M% n" k- [) R7 o
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);+ x# Z0 P: `3 n+ D! E: @% S1 G
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);- M% }. W5 r# {+ e" w1 i' c
function safeTransferFrom(address _from, address _to, uint256 _tokenId, bytes data) external payable;3 E1 m/ V! `0 k- ?
function safeTransferFrom(address _from, address _to, uint256 _tokenId) external payable;. q0 E8 o& w! g5 A. h' u. J9 ?3 ~0 ^
function transferFrom(address _from, address _to, uint256 _tokenId) external payable;! j# z' n9 n/ o3 x
function approve(address _approved, uint256 _tokenId) external payable;
function setApprovalForAll(address _operator, bool _approved) external;
function getApproved(uint256 _tokenId) external view returns (address);7 M ?4 ^6 {" A
function isApprovedForAll(address _owner, address _operator) external view returns (bool);8 Q0 r/ Y, H" c0 S7 G8 ]
}5 R2 f0 ?& V: L% O8 N5 A( k' ]4 K
接口说明:
balanceOf(): 返回由_owner 持有的NFTs的数量。8 T1 r( o4 d8 ?" B
) K7 ^! u0 A% j+ _2 }( [5 N6 _
ownerOf(): 返回tokenId代币持有者的地址。3 Q, w5 q9 V/ \; E; l& R
approve(): 授予地址_to具有_tokenId的控制权,方法成功后需触发Approval 事件。
. U3 ]* T: J8 e6 i% }6 j
setApprovalForAll(): 授予地址_operator具有所有NFTs的控制权,成功后需触发ApprovalForAll事件。& Y' n/ }. I7 r
' |! D/ Q3 t+ _% k
getApproved()、isApprovedForAll(): 用来查询授权。5 @/ G% M: y( a3 C% e$ ^
safeTransferFrom(): 转移NFT所有权,一次成功的转移操作必须发起 Transer 事件。函数的实现需要做一下几种检查:
3 ~' r* o' o" p' h6 y5 K
) I" `7 `: s9 \4 `# Z# ]5 M! q1 Y
调用者msg.sender应该是当前tokenId的所有者或被授权的地址_from 必须是 _tokenId的所有者_tokenId 应该是当前合约正在监测的NFTs 中的任何一个_to 地址不应该为 0如果_to 是一个合约应该调用其onERC721Received方法, 并且检查其返回值,如果返回值不为bytes4(keccak256("onERC721Received(address,uint256,bytes)"))抛出异常。一个可接收NFT的合约必须实现ERC721TokenReceiver接口:5 B: j! w# r& @& u# p5 b
& p: U4 ^& Q( |, m3 W! A! g
interface ERC721TokenReceiver {4 z' r# [9 X5 o1 \1 b' v
/// @return `bytes4(keccak256("onERC721Received(address,uint256,bytes)"))`
function onERC721Received(address _from, uint256 _tokenId, bytes data) external returns(bytes4);' A- ^( K1 f( w2 _7 O! n7 }( ]
}0 @8 _5 C$ O" L6 I, t( N! @
transferFrom(): 用来转移NFTs, 方法成功后需触发Transfer事件。调用者自己确认_to地址能正常接收NFT,否则将丢失此NFT。此函数实现时需要检查上面条件的前4条。
' V: z. @4 R& d& H& _. M8 y7 |$ m6 n
ERC165 标准
ERC721标准同时要求必须符合ERC165标准 ,其接口如下:# p- _2 @+ X# g4 P& J% H
interface ERC165 {) d l+ v/ u. ~, s4 m
function supportsInterface(bytes4 interfaceID) external view returns (bool);
}) o ~. x, y: @9 M
ERC165同样是一个合约标准,这个标准要求合约提供其实现了哪些接口,这样再与合约进行交互的时候可以先调用此接口进行查询。
interfaceID为函数选择器,计算方式有两种,如:bytes4(keccak256('supportsInterface(bytes4)'));或ERC165.supportsInterface.selector,多个函数的接口ID为函数选择器的异或值。
关于ERC165,这里不深入介绍,有兴趣的同学可以阅读官方提案。4 `7 O% @# b; h; [: ]; B
可选实现接口:ERC721Metadata3 S- p7 `7 Z1 i/ g
ERC721Metadata 接口用于提供合约的元数据:name , symbol 及 URI(NFT所对应的资源)。5 Y' w0 q, i9 \. c# K$ l' I
其接口定义如下:
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); X1 N, a' J7 C/ Z0 r
}
接口说明:
name(): 返回合约名字,尽管是可选,但强烈建议实现,即便是返回空字符串。symbol(): 返回合约代币符号,尽管是可选,但强烈建议实现,即便是返回空字符串。tokenURI(): 返回_tokenId所对应的外部资源文件的URI(通常是IPFS或HTTP(S)路径)。外部资源文件需要包含名字、描述、图片,其格式的要求如下:
% t4 T8 X% L' K% W, \
{) D: Y6 M$ f l6 Y0 l% ~
"title": "Asset Metadata",
"type": "object",4 M5 E: N2 y* q& F. D" n8 O4 x* p4 N
"properties": {
"name": {/ u L) _7 {' f4 Q: a
"type": "string",
"description": "Identifies the asset to which this NFT represents",1 i& F6 J* v. o1 A* a" f# l
},
"description": {
"type": "string",
"description": "Describes the asset to which this NFT represents",/ ^( u! F, z; b9 Z9 @; a
},! o, a" Y: ?; U4 y* R
"image": {$ Q- x: l8 o. X% G: k
"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.",8 ?& S( i- d$ B0 h7 a
}% n( H$ j# X' V8 w$ l( z2 d4 A
}
}
tokenURI通常是被web3调用,以便在应用层做相应的查询和展示。# K+ Z9 p0 j; M# `: v
可选实现接口:ERC721Enumerable
ERC721Enumerable的主要目的是提高合约中NTF的可访问性,其接口定义如下:
interface ERC721Enumerable /* is ERC721 */ {
function totalSupply() external view returns (uint256);+ c% m5 D& K0 l0 u" ^* c/ m2 O
function tokenByIndex(uint256 _index) external view returns (uint256);
function tokenOfOwnerByIndex(address _owner, uint256 _index) external view returns (uint256);
}
接口说明:, i! ]/ I; y1 d2 S2 h( d* V
totalSupply(): 返回NFT总量tokenByIndex(): 通过索引返回对应的tokenId。tokenOfOwnerByIndex(): 所有者可以一次拥有多个的NFT, 此函数返回_owner拥有的NFT列表中对应索引的tokenId。; B8 m0 @& e, ?! U" Y9 I5 x
" f! l/ j Z0 v( g+ }5 o
补充说明! ~! @- r1 \ S
NTF IDs3 r! k+ a$ c, [9 l) _! J
NTF ID,即tokenId,在合约中用唯一的uint265进行标识,每个NFT的ID在智能合约的生命周期内不允许改变。推荐的实现方式有:
' B+ Q) v: f) N' c+ T- z' X% h" [4 V
从0开始,每新加一个NFT,NTF ID加1使用sha3后uuid 转换为 NTF ID. I* m" b5 N, o+ k# S! m
与ERC-20的兼容性" ` p8 G j1 E1 A
ERC721标准尽可能遵循 ERC-20 的语义,但由于同质代币与非同质代币之间的根本差异,并不能完全兼容ERC-20。6 G) w: C3 x/ r9 ?0 t' E# M5 D
交易、挖矿、销毁
在实现transter相关接口时除了满足上面的的条件外,我们可以根据需要添加自己的逻辑,如加入黑名单等。1 ]: `/ l W3 Y' I; w- x" h1 ]7 K3 ] y
同时挖矿、销毁尽管不是标准的一部分,我们可以根据需要实现。
BitMere.com 比特池塘系信息发布平台,比特池塘仅提供信息存储空间服务。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
成为第一个吐槽的人