您好,欢迎访问蓝狮在线!
当前位置: 首页 > 荣誉资质 > 科技证书
蓝狮平台-ERC777 功能型代币(通证)最佳实践
2024-08-04 阅读
本文摘要:毕竟很多同学都早已用于过ERC20 创立过代币[1],也许早已被老板拒绝在ERC20代币上构建一些可选功能做的焦头烂额,如果还有自由选择,一定要自由选择 ERC777 。

毕竟很多同学都早已用于过ERC20 创立过代币[1],也许早已被老板拒绝在ERC20代币上构建一些可选功能做的焦头烂额,如果还有自由选择,一定要自由选择 ERC777。ERC20 的问题以下是一个遇上很多次的场景:有一天老板过来去找你(开发者),最近存币生息很火,我们也做到一个合约吧, 用户打币过来给他计算出来利息, 看上去是一个很非常简单的市场需求,你满口答应谈谈,结果自己一研究找到,用于 ERC20 标准没有办法在合约里记录是谁发过来多少币,从而不了计算出来利息(因为接收者合约并不知道自己接管到ERC20代币)。ERC20 标准下,可以通过一个变通的办法,使用两个交易人组已完成,方法是:第1步:再行让用户把要移往的金额用 ERC20 的approve 许可的存币生息合约(这步一般来说称作关卡),第2步:再度让用户调用存币生息合约的计息函数,计息函数中通过 transferFrom 把代币从用户手里移往的合约内,并开始计息。

某种程度由于ERC20 标准没一个账户通报机制,很多ERC20代币误将转至合约之后,很久没办法把币移往出来,早已有大量的ERC20 因为这个原因被失灵,如失灵的QTUM[2],失灵的EOS[3]。另外一个问题是ERC20 账户时,无法装载额外的信息,例如:我们有一些客户期望让用户用于 ERC20 代币出售商品,因为账户不了装载额外的信息, 用户的代币移往过来,不告诉用户明确要出售哪件商品,从而展加了线下额外的交流成本。ERC777很好的解决问题了这些问题,同时ERC777 也相容 ERC20 标准。因此强烈建议新的研发的代币用于ERC777标准。

ERC777 在 ERC20的基础上定义了 send(dest, value, data) 来移往代币, send函数额外的参数用来装载其他的信息,send函数不会检查持有者和接收者否构建了适当的钩子函数,如果有构建(不管是普通用户地址还是合约地址都可以构建钩子函数),则调用适当的钩子函数。ERC1820 模块注册表合约即便是一个普通用户地址,网卓新闻网,某种程度可以构建对 ERC777 账户的监听, 听得一起有点神秘,只不过这是通过 ERC1820 模块注册表合约来是构建的。ERC1820 如此的最重要,以至于ERC777分开把它拆出来作为一个EIP。

ERC1820 是一个全局的合约,有一个唯一在以太坊链上都完全相同的合约地址,它总是 0x1820a4B7618BdE71Dce8cdc73aAB6C95905faD24 ,这个合约是通过十分精妙的方式展开部署的,有兴趣的同学可以读者EIP1820文档[4]。ERC 1820 合约的官方构建代码在ERC1820文档[5]可以查询,这里解释合约构建的主要内容。ERC1820合约提到了两个主要模块:•setInterfaceImplementer(address _addr, bytes32 _interfaceHash, address _implementer) 用来设置地址(_addr)的模块(_interfaceHash 模块名称的 keccak256 )由哪个合约构建(_implementer)。

•getInterfaceImplementer(address _addr, bytes32 _interfaceHash) external view returns (address) 这个函数用来查找地址(_addr)的模块由哪个合约构建。setInterfaceImplementer函数不会参数信息记录到下面这个interfaces同构里:// 记录 地址(第一个键) 的模块(第二个键)的构建地址(第二个值)mapping(address = mapping(bytes32 = address)) interfaces;比较不应的 getInterfaceImplementer() 通过 interfaces 这个mapping 来取得模块的构建。ERC777 用于 send账户时会分别在持有者和接收者地址上用于ERC1820 的getInterfaceImplementer函数展开查找,查阅否有对应的构建合约,ERC777 标准规范里预计了模块及函数名称,如果有构建则展开适当的调用。

ERC777 标准规范ERC777 模块ERC777 为了在构建上可以相容ERC20,除了查找函数和ERC20完全一致外,操作者模块皆使用的独立国家的命名(防止完全相同的命令无法辨别是哪个标准),ERC777的接口定义如下,拒绝所有的ERC777代币合约都必需构建这些模块:interface ERC777Token {function name() external view returns (string memory);function symbol() external view returns (string memory);function totalSupply() external view returns (uint256);function balanceOf(address holder) external view returns (uint256);// 定义代币大于的区分粒度function granularity() external view returns (uint256);// 操作员 涉及的操作者(操作员是可以代表持有者发送到和封存代币的账号地址)function defaultOperators() external view returns (address[] memory);function isOperatorFor(address operator,address holder) external view returns (bool);function authorizeOperator(address operator) external;function revokeOperator(address operator) external;// 发送到代币function send(address to, uint256 amount, bytes calldata data) external;function operatorSend(address from,address to,uint256 amount,bytes calldata data,bytes calldata operatorData) external;// 封存代币function burn(uint256 amount, bytes calldata data) external;function operatorBurn(address from,uint256 amount,bytes calldata data,bytes calldata operatorData) external;// 发送到代币事件event Sent(address indexed operator,address indexed from,address indexed to,uint256 amount,bytes data,bytes operatorData);// 铸币事件event Minted(address indexed operator,address indexed to,uint256 amount,bytes data,bytes operatorData);// 封存代币事件event Burned(address indexed operator,address indexed from,uint256 amount,bytes data,bytes operatorData);// 许可操作员事件event AuthorizedOperator(address indexed operator,address indexed holder);// 撤消操作员事件event RevokedOperator(address indexed operator, address indexed holder);}接口定义在 openzeppelin代码库[6] 里寻找,路径为:contracts/token/ERC777/IERC777.sol。模块解释与构建誓约所有的ERC777 合约除了必需构建上述模块,还有一些其他的必需遵从的誓约(必要造成了ERC777官方文档又宽又粪...大哭~)。

ERC777 合约必需要通过 ERC1820 登记 ERC777Token 模块,这样任何人都可以查找合约是否是ERC777标准的合约,登记方法是: 调用ERC1820 登记合约的 setInterfaceImplementer 方法,参数 _addr 及 _implementer 皆是合约的地址,_interfaceHash 是 ERC777Token 的 keccak256 哈希值(0xac7fbab5...177054)如果 ERC777 要构建ERC20标准,还必需通过ERC1820 登记ERC20Token模块。ERC777 信息解释函数name(),symbol(),totalSupply(),balanceOf(address) 和含义和在ERC20 中几乎一样。granularity() 用来定义代币大于的区分粒度(=1), 拒绝必需在创立时原作,之后不可以变更,不管是在铸币、发送到还是封存操作者的代币数量,必须是粒度的整数倍。

granularity 和 ERC20 的 decimals 不一样,decimals用来定义小数位数,decimals 是ERC20 可选函数,为了相容 ERC20 代币, decimals 函数拒绝必需回到18。而 granularity 回应的是基于大于位数(内部存储)的区分粒度。例如:0.5个代币存储为 500,000,000,000,000,000 (0.5 X 10^18),如果粒度为2,则大于账户单位是2(相对于500,000,000,000,000,000)。操作员ERC777 定义了一个新的操作员角色,操作员被作为移动代币的地址。

每个地址直观地移动自己的代币,将持有人和操作员的概念分离可以获取更大的灵活性。与ERC20中的 approve 、 transferFrom 有所不同,其并未具体定义批准后地址的角色。此外,ERC777还可以定义配置文件操作员(配置文件操作员列表不能在代币创立时定义的,并且无法变更),配置文件操作员是被所有持有人许可的操作员,这可以为项目方管理代币带给便利,当然认何持有人依然有权撤消配置文件操作员。

操作员涉及的函数:•defaultOperators(): 提供代币合约配置文件的操作员列表.•authorizeOperator(address operator): 设置一个地址作为msg.sender 的操作员,必须启动时AuthorizedOperator事件。•revokeOperator(address operator): 去除 msg.sender 上 operator 操作员的权限, 必须启动时RevokedOperator事件。•isOperatorFor(address operator, address holder):是否是某个持有者的操作员。

发送到代币ERC777 发送到代币 用于以下两个方法:send(address to, uint256 amount, bytes calldata data) externalfunction operatorSend(address from,address to,uint256 amount,bytes calldata data,bytes calldata operatorData) externaloperatorSend 可以通过参数operatorData装载操作者的信息,发送到代币除了继续执行对应账户的余额以此类推和启动时事件之外,还有额外的规定:1.如果持有者有通过 ERC1820 登记 ERC777TokensSender 构建模块, 代币合约必需调用其 tokensToSend 钩子函数。2.如果接收者有通过 ERC1820 登记 ERC777TokensRecipient 构建模块, 代币合约必需调用其 tokensReceived 钩子函数。3.如果有 tokensToSend 钩子函数,必需在改动余额状态之前调用。4.如果有 tokensReceived 钩子函数,必需在改动余额状态之后调用。

5.调用钩子函数及启动时事件时, data 和 operatorData必需原貌传送,因为 tokensToSend 和 tokensReceived 函数有可能根据这个数据中止账户(启动时 revert)。ERC777TokensSender 接口定义如下:interface ERC777TokensSender {function tokensToSend(address operator,address from,address to,uint256 amount,bytes calldata userData,bytes calldata operatorData) external;}如果持有者期望在账户时接到代币移往通报,就必须在ERC1820合约上登记及构建 ERC777TokensSender 模块(几天后有案例讲解)。有一个地方必须留意: 对于所有的 ERC777 合约, 一个持有者地址不能登记一个ERC777TokensSender模块构建。

因此 ERC777TokensSender 构建不会被多个ERC777合约调用,在ERC777TokensSender模块的构建合约里, msg.sender 是ERC777合约地址,而不是操作者。ERC777TokensRecipient 接口定义如下:interface ERC777TokensRecipient {function tokensReceived(address operator,address from,address to,uint256 amount,bytes calldata data,bytes calldata operatorData) external;}如果接收者期望在账户时接到代币移往通报,就必须在ERC1820合约上登记及构建 ERC777TokensRecipient 模块。

如果接收者是一个合约地址, 则必需要登记及构建 ERC777TokensRecipient 模块(这样可以避免代币被失灵),如果没构建,ERC777代币合约必需revert 重设交易状态。铸币与封存铸币(挖矿)是产生新币的过程,封存代币则忽略,在ERC20 中,没具体定义这两个不道德,一般来说不会transfer方法和Transfer事件来传达。

ERC777 则定义了代币从铸币、移往到封存的整个生命周期。ERC777 没定义铸币的方法名,只定义了 Minted事件,因为很多代币,是在创立的时候就确认好代币的数量。如果有必须合约可以自己定义铸币函数,铸币函数在构建时拒绝:1.必需启动时Minted事件2.发行量必须再加铸币量, 接收者是不为 0 ,且接收者余额再加铸币量。

3.如果接收者有通过 ERC1820 登记 ERC777TokensRecipient 构建模块, 代币合约必需调用其 tokensReceived 钩子函数。ERC777 定义了两个函数用作封存代币 (burn 和 operatorBurn),可以便利钱包和dapps有统一的模块交互。burn 和 operatorBurn 的构建拒绝:1.必需启动时Burned事件。

2.总供应量必需增加代币封存量, 持有者的余额必需增加代币封存的数量。3.如果持有者通过ERC1820登记ERC777TokensSender 构建,必需调用持有者的tokensToSend钩子函数。

留意,零个代币数量的交易(不管是移往、铸币与封存)也是合法的,某种程度符合粒度(granularity) 的整数倍,因此必须正确处理。ERC777 代币构建OpenZeppelin 构建了一个 ERC777 基础合约,要构建自己的ERC777代币只必须承继 OpenZeppelin ERC777。想要理解 OpenZeppelin 的 ERC777 的构建可读者ERC777 源码解析[7]。

如果大家是Truffle研发(或者是Node工程),可以用于以下方式加装 OpenZeppelin 合约库:npm install @openzeppelin/contracts发售一个 2100 个的 LBC7 代币的代码就很非常简单了:pragma solidity ^0.5.0;import "@openzeppelin/contracts/token/ERC777/ERC777.sol";contract MyERC777 is ERC777 {constructor(address[] memory defaultOperators)ERC777("MyERC777", "LBC7", defaultOperators)public{uint initialSupply = 2100 * 10 ** 18;_mint(msg.sender, msg.sender, initialSupply, "", "");}}构建主要是两步:通过基类ERC777的构造函数证实代币名称、代号以及配置文件操作员(可为空),然后调用 _mint 初始化发行量,留意发行量的小数位是相同的18位(和ether保持一致),在合约内部是按小数位留存的,因此发售的币数必须乘以1018。监听代币收款我们假设有这样一个市场需求:寺庙要构建了一个功德箱合约接管捐献,功德箱合约必须记录每位供养的善款金额。这时候就可以通过构建 ERC777TokensRecipient模块来已完成。

代码也很非常简单:pragma solidity ^0.5.0;import "@openzeppelin/contracts/token/ERC777/IERC777Recipient.sol";import "@openzeppelin/contracts/token/ERC777/IERC777.sol";import "@openzeppelin/contracts/introspection/IERC1820Registry.sol";contract Merit is IERC777Recipient { mapping(address = uint) public givers; address _owner; IERC777 _token; IERC1820Registry private _erc1820 = IERC1820Registry(0x1820a4B7618BdE71Dce8cdc73aAB6C95905faD24); // keccak256("ERC777TokensRecipient") bytes32 constant private TOKENS_RECIPIENT_INTERFACE_HASH = 0xb281fc8c12954d22544db45de3159a39272895b169a852b314f9cc762e44c53b; constructor(IERC777 token) public {_erc1820.setInterfaceImplementer(address(this), TOKENS_RECIPIENT_INTERFACE_HASH, address(this));_owner = msg.sender;_token = token; }// 收款时被消息传递 function tokensReceived( address operator, address from, address to, uint amount, bytes calldata userData, bytes calldata operatorData ) external {givers[from] += amount; }// 方丈拿回功德箱token function withdraw () external {require(msg.sender == _owner, "no permision");uint balance = _token.balanceOf(address(this));_token.send(_owner, balance, ""); }}功德箱合约在结构时,调用 ERC1820 注册表合约的 setInterfaceImplementer函数 登记ERC777TokensRecipient模块构建(模块的构建是自身),这样在接到代币时,不会消息传递 tokensReceived函数,tokensReceived函数通过givers同构来留存每个供养的善款金额。留意:如果是在本地的开发者网络环境,可能会没ERC1820 注册表合约,如果没必须再行部署ERC1820注册表合约,参照eip-1820 中文文档[8]。功德箱这个实例意味着是抛砖引玉,告诉他大家如何构建收款时的消息传递,之后有时间,我写出一个原始的存币生息应用于。

普通账户地址监听代币并转出有功德箱合约的例子,收款地址和收款监听是同一个合约, 现在来想到一个普通的用户地址,如何委托一个合约来监听代币的补足。监听代币的补足可以让持有者对收到去的代币有更加多的掌控,例如持有者可以设置一些黑名单,禁令操作员对黑名单内账号账户。References[1] ERC20 创立过代币: https://learnblockchain.cn/2018/01/12/create_token/[2] 失灵的QTUM: https://etherscan.io/address/0x9a642d6b3368ddc662CA244bAdf32cDA716005BC[3] 失灵的EOS: https://etherscan.io/address/0x86fa049857e0209aa7d9e616f7eb3b3b78ecfdb0[4] EIP1820文档: https://learnblockchain.cn/docs/eips/eip-1820.html[5] ERC1820文档: https://learnblockchain.cn/docs/eips/eip-1820.html[6] openzeppelin代码库: https://github.com/OpenZeppelin/openzeppelin-contracts[7] ERC777 源码解析: https://learnblockchain.cn/2019/09/26/erc777-code/[8] eip-1820 中文文档: https://learnblockchain.cn/docs/eips/eip-1820.html[9] 我的小专栏: https://xiaozhuanlan.。


本文关键词:蓝狮在线,蓝狮在线平台,蓝狮在线注册,蓝狮平台

本文来源:蓝狮在线-www.xczwfwzx.com

网站备案号:ICP备23170701号-2    粤公网安备 00000000000000号   Copyright © 2002-2024 www.xczwfwzx.com. 蓝狮在线科技 版权所有
地址:天津市天津市天津区支标大楼975号 电话:020-88889999