SharkTeam合约安全系列课程之NFT&GameFi开发与安全。第二课,让我们一起来学习ERC20、ERC721、ERC1155等关键协议。
SharkTeam合约安全系列课程之NFT&GameFi开发与安全。第二课,让我们一起来学习ERC20、ERC721、ERC1155等关键协议。
深入理解以太坊上代币标准的设计,有助于确保正确的进行智能合约开发并确保安全,这也是本课程的主要目标。以下是以太坊上最受欢迎的一些代币标准:
ERC20提供了一个同质化代币(Fungible Token, FT)的标准,换句话说,每个代币与另一个代币(在类型和价值上)完全相同。例如,一个ERC20代币就像以太币一样,意味着一个代币会并永远会与其他代币一样。
ERC20是由Fabian Vogelsteller于2015年11月在EIP20提案中提出的。这是一个能实现智能合约中代币的应用程序接口标准。
EIP20提案是由Fabian Vogelsteller和Vitalik Buterin在2015年11月创建的代币标准,定义了代币合约的标准接口,提供了转移代币的基本功能,并允许代币获得批准,以方便其他链上的第三方使用。此外,该标准接口允许以太坊上定义的任何代币被其他应用程序(钱包、去中心化交易所等)重用。
ERC20 的功能包括但不限于以下几点:
注意:
(1)合约使用的Solidity语言版本必须是0.4.17或以上;
(2)对于返回值success,调用者必须处理success为false的情况,不能假设success永远为true而忽略success为false的情况。
返回代币合约中定义的代币名称,比如”MyToken”。
该函数读取代币合约中定义的代币名称。这里,定义代币名称可以提高代币合约的可用性,但不是代币合约必须定义的属性,但标准的ERC20合约都会定义。
返回代币合约中定义的代币符号,比如”HIX”。
该函数读取代币合约中定义的代币符号。这里,定义代币符号可以提高代币合约的可用性,但不是代币合约必须定义的属性,但标准的ERC20合约都会定义。
返回代币合约中定义的代币的精度,比如18,表示代币的余额除以10^18后才是真正的代币数量。类似于以太的单位换算,余额10^18 Wei表示以太数量为1=10^18/10^18。
该函数读取代币合约中定义的代币精度。这里,定义代币精度可以提高代币合约的可用性,但不是代币合约必须定义的属性,但标准的ERC20合约都会定义。
返回代币的总供应量。
返回地址为_owner的账户的代币余额。
将调用者账户中_value数量的代币转移到地址_to,并且必须触发Transfer事件。如果调用者的账户余额没有足够的代币可以支付_value数量的代币时,该函数应该抛出异常并回滚。
注意:0值作为_value值传入到函数必须被视为正常的函数执行并触发Transfer事件。
将_value数量的代币从地址_from转移到地址_to,并且必须触发Transfer事件。
transferFrom方法用于提款流程,允许合约代表代币所有者账户转移代币。 例如,这可用于允许合约代表代币所有者转移代币和/或以次级货币(sub-currency)的形式收取费用。若函数调用者没有得到_from账户的授权,该函数则会抛出异常并回滚。
注意:0值作为_value值传入到函数必须被视为正常的函数执行并触发Transfer事件。
该函数的调用者账户地址将_value数量的代币授权给_spender,或者更新授权的代币数量,即_spender可以多次提取调用者账户地址的代币,总数量不超过_value,每次提取的代币数量也不能超过调用者账户地址的代币余额,同时提取后会更新_value的值。如果在提取过程中,提取的代币数量超过了代币余额不足,该函数会抛出异常并回滚。
返回账户地址_spender还可以从账户地址_owner中提取的代币数量。
Transfer事件必须在代币转移时触发,包括转移的代币数量为0的情况。
代币合约在铸造代币时应该触发Transfer事件,并将_from地址设置为0。此时,也可以自定义并触发Mint事件:
代币合约在销毁代币时应该触发Transfer事件,并将_to地址设置为0x。此时,也可以自定义并触发Burn事件:
必须在任何调用approve函数并执行成功时触发。
ERC721 为 NFT 引入了一个标准,换言之, 这种类型的代币是独一无二的,并且可能与来自同一智能合约的另一代币有不同的价值,也许是因为它的年份、稀有性、甚至是它的观感。
每一个NFT都有一个uint256类型的变量,名为tokenId,所以对于任何ERC721合约,这对值<contract address, tokenId>必须是全局唯一的。dApp可以有一个“转换器”,该转换器输入tokenId,然后输出一些非常有趣的事物的图像,比如僵尸、武器、技能或非常可爱的猫咪等。
ERC721是由William Entriken、Dieter Shirley、Jacob Evans、Nastassia Sachs于2018年1月在EIP721中提出的一个在智能合约中实现代币API的非同质化代币标准。
BIP721提案描述了智能合约中实现NFT的标准API。 标准提供了跟踪和转移NFT的基本功能。该提案考虑了个人拥有和交易NFT的场景,以及委托给第三方(如:代理人/钱包/拍卖人,称为“操作员”)的情况。
NFT可以代表对数字或物理资产的所有权。我们考虑了资产的多样性,并且我们知道您会想要代表更多:
总的来说,所有房屋都是不同的,没有两只小猫是一样的。NFT是可区分的,必须分别跟踪每个所有者。
ERC721的功能包括但不限于以下几点:
以上定义的函数都是外部函数,函数只能进行外部调用。
查询余额,返回地址_owner拥有的合约定义的NFT的数量,若没有,则返回0。
查询所有者地址,返回tokenId为参数_tokenId的NFT的所有者地址。
安全地转移NFT所有权并发送数据,即将tokenId为参数_tokenId的NFT的所有权由地址_from转移给地址_to,并将额外的数据data发送给地址_to,并触发Transfer事件。参数data没有格式要求。若地址_to是合约地址,data一般包含函数签名值(methodId)以及函数参数值,当data发送给_to时,会调用合约_to中签名值对应的函数或者回调函数。
函数能够执行,必需满足以下条件:
若不满足条件,函数将抛出异常并回滚。
另外,该函数使用了payable修饰符,因此可以接收以太坊原生代币(以太币)。
安全地转移NFT所有权,即将tokenId为参数_tokenId的NFT的所有权由地址_from转移给地址_to,并触发Transfer事件。
调用该函数等价于调用上面的safeTransferFrom中data参数是””的情况,即:
转移NFT所有权,即将tokenId为参数_tokenId的NFT的所有权由地址_from转移给地址_to,并触发Transfer事件。函数能够执行,必需满足以下条件:
若不满足条件,函数将抛出异常并回滚。
将tokenId为参数_tokenId的NFT授权给地址_approved,或者更新授权地址为_approved,并且触发Approve事件。函数能够执行,必需满足以下条件:
若不满足条件,函数将抛出异常并回滚。
将调用者msg.sender的所有NFT资产授权给_operator地址来管理,或者取消授权,并且触发ApprovalForAll事件。
参数_approved是true代表授权;参数_approved是false代表取消授权。
查询单个NFT的授权地址。若_tokenId不是一个有效的NFT的tokenId,该函数会抛出异常并回滚。
查询地址_owner的所有NFT是否授权给了另一个地址_operator来管理。若已授权,则返回true;否则,返回false。
该事件在NFT转移所有权完成时触发。
代币合约在铸造NFT时应该触发Transfer事件,并将_from地址设置为0。此时,也可以自定义并触发Mint事件:
代币合约在销毁NFT时应该触发Transfer事件,并将_to地址设置为0x。此时,也可以自定义并触发Burn事件:
当将_owner地址的单个NFT(其tokenId为参数_tokenId)授权给_approved地址时,在授权完成后触发Approval事件。
当将_owner地址的所有NFT授权给_operator地址或者取消该授权时,触发ApprovalForAll事件。
ERC1155协议是由Witek Radomski, Andrew Cooke等于2018年6月在EIP1155提案中提出的用于多种代币管理的合约标准接口。单个部署的合约可以包括同质化代币、非同质化代币或其他配置(如半同质化代币)的任何组合。
多代币标准的目的是创建一个智能合约接口,可以代表和控制任何数量的同质化和非同质化代币类型。这样一来,ERC-1155代币就具有与ERC20和ERC721代币相同的功能,甚至可以同时使用这两者的功能。而最重要的是,它能改善这两种标准的功能,使其更有效率,并纠正ERC20和ERC721标准上明显的实施错误。
BIP1155提案概述了一个标准的智能合约接口,可以代表任意数量的同质化代币和非同质化代币类型。ERC20等现有标准要求为每种代币类型部署单独的合约。ERC721标准的代币ID是一个单一的非同质化索引,每组非同质化代币都会被部署为具有统一设置的独立的合约。相比之下,ERC1155多代币标准允许每个代币ID表示一个新的可配置代币类型,它可以有自己的元数据、供应量以及其他属性。
每个函数的参数集合中都会包含_id参数,表示交易中的一种特定的代币或代币类型。
ERC1155的功能包括但不限于以下几点:
(1)_to地址为0;
(2)_ids的长度与_values的长度不同;
(3)_ids中代币持有者的任何余额低于发送给接收者的相应_value金额;
(4)出现任何其他错误。
ERC20代币转移,从地址from将value数量的代币转移到地址to,与ERC20协议中的transferFrom功能相同。
ERC1155代币批量转移,包括同质化代币以及非同质化代币。与ERC20与ERC721相比,ERC1155中唯一的区别是将数值作为数组参数进行传递,此外还会传递数组 id。例如,给出ids=[3, 6, 13]和values=[100, 200, 5],传输结果如下:
ERC1155中只有transferFrom,没有transfer。要想像常规的transfer一样使用它,只需将"from"地址设为调用该函数的地址。
查询owner地址的余额,与ERC20协议中的balanceOf功能相同。
账户余额批量查询,在单次调用中获取多个余额。参数中传递所有者账户数组和代币的id数组。例如,对于给出的_ids=[3, 6, 13]和_owners=[0xbeef..., 0x1337..., 0x1111...],返回值将为:
设置操作帐户_operator为已授权账户或取消授权。授权过程与ERC20略有不同。这里不是授权特定金额,而是类似于ERC721协议中的授权,通过 setApprovalForAll 函数,对操作账户进行完全的授权或取消授权。
查询当前的审批状态,即_owner是否对_operator进行了授权。结果为true代表全部授权;结果为false代表未授权。 不能定义要授权代币的数量,甚至代币类型。
ERC1155只支持智能合约的接收钩子函数。钩子函数必须返回一个事先预定义的4字节值,这个值被指定为:
当接收合约返回这一值时,意味着合约知道如何处理ERC1155代币并接受转账。
TransferSingle事件在代币转移成功时触发,包括转移的代币数量为0的情况。另外,代币铸造和销毁时也可以触发TransferSingle事件。与ERC20协议中的Transfer事件相同。
TransferBatch事件在代币批量转移成功时触发,包括转移的代币数量为0的情况。另外,代币批量铸造和销毁时也需要触发TransferBatch事件。
当将_owner地址的所有代币全部授权给_operator地址或者取消该授权时,触发ApprovalForAll事件。
当一个代币ID的URI更新成功时触发URI事件。
ERC777协议是一个易于交易的代币标准,可改进现有的ERC20 标准。与ERC20相比,ERC777提供了以下改进:
钩子是智能合约代码中描述的一个函数。钩子将会在代币通过合约发送或者接收时调用。这将允许智能合约对进出的代币做出互动。
该标准还解决了在ERC20中造成的decimals的混乱。这种清晰度提升了开发者体验。
ERC777合约可以与ERC20合约进行互动。
更多内容,请见EIP777。
ERC165协议创建了一个标准方法来发布和检测智能合约实现的接口。更多内容详见EIP165。
关于我们: SharkTeam的愿景是全面保护Web3世界的安全。团队成员分布在北京、南京、苏州、硅谷,由来自世界各地的经验丰富的安全专业人士和高级研究人员组成,精通区块链和智能合约的底层理论,提供包括威胁建模、智能合约审计、应急响应等在内的综合服务。已与区块链生态系统各个领域的关键参与者,如Huobi Global、OKC、polygon、Polkadot、imToken、ChainIDE等建立长期合作关系。
Telegram:https://t.me/sharkteamorg
Twitter:https://twitter.com/sharkteamorg
Reddit:https://www.reddit.com/r/SharkTeam
更多区块链安全咨询与分析,点击下方链接查看
D查查|链上风险核查 https://m.chainaegis.com
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!