区块链100讲:ERC20 中文版
1
摘要
ERC20 中文版简单总结即:代币的标准接口。
下面的标准允许在智能合约中代币的标准API的实现。 该标准提供了转账代币的基本功能,并允许批准代币,以便其他链上第三方可以使用这些代币。
2
动机
标准接口允许以太坊上的任一代币可以被其他应用程序重用:从钱包转到去中心化的交易所。
3
规范
代币
方法
注意: 调用者必须处理 returns (bool success) 返回的 false 。调用者一定不能假设从不返回 false !
name
返回代币的名字 - 比如 "MyToken" 。Returns the name of the token - e.g. "MyToken".
可选的 - 该方法可以用来改善可用性, 但接口及其他合约一定不能期望这些值存在。(译者注:即不能假设 name 一定可以返回代币名字)
function name() view returns (string name)
symbol
返回代币的标识符。 如 “HIX”。
可选的 - 该方法可以用来改善可用性, 但接口及其他合约一定不能期望这些值存在。(译者注:即不能假设 name 一定可以返回代币名字)
function symbol() view returns (string symbol)
decimals
返回代币使用的小数点位数 - 如 8 ,意思是代币数量除以 100000000 以得到代表用户的最小单位。
可选的 - 该方法可以用来改善可用性, 但接口及其他合约一定不能期望这些值存在。(译者注:即不能假设 name 一定可以返回代币名字)
function decimals() view returns (uint8 decimals)
totalSupply
返回全部的代币供应量。Returns the total token supply.
function totalSupply() view returns (uint256 totalSupply)
balanceOf
返回 _owner 地址的账户余额。
function balanceOf(address _owner) view returns (uint256 balance)
transfer
转账 _value 数量的代币给地址 _to , 且一定会触发 Transfer 事件。 如果 _from 账户余额不足,则该方法应该 throw 。
注意 值为0的转账必须当做正常转账处理且触发 Transfer 事件。
function transfer(address _to, uint256 _value) returns (bool success)
transferFrom
从 _from 地址转账 _value 给地址 _to ,且必须触发 Transfer 事件。
transferFrom 方法用于取款工作流,允许合约代表你来转账代币。 比如这可以用于允许合约代币你来转账代币,或以子货币来收取费用。 如果 _from 账户没有有意的通过某种机制授权消息的发送者,则该方法应该 throw 。
注意 值为0的转账必须当做正常转账处理且触发 Transfer 事件。
function transferFrom(address _from, address _to, uint256 _value) returns (bool success)
approve
允许 _spender 从你的账户多次取款,最大额度为 _value 。如果该方法再次调用,会用 _value 重新当前的额度。
注意:为了防止攻击向量,如这个这里所述 以及 这里讨论,客户应该确保创建用户接口,为相同花费者设置其他值的最大额度前,首先设置当前额度为 0 。 尽管合约本身不应该强制如此,然而这是为了允许向后兼容之前部署的合同。
function approve(address _spender, uint256 _value) returns (bool success)
allowance
返回 _spender 还被允许从 _owner 提款的额度。
function allowance(address _owner, address _spender) view returns (uint256 remaining)
Events
Transfer
代币转账时必须触发,包括价值为0的转账。
创建新代币的合约,在代币创建时应该触发 Transfer 事件,并将 _from 地址设为 0x0 。
event Transfer(address indexed _from, address indexed _to, uint256 _value)
Approval
任何成功的调用 approve(address _spender, uint256 _value) 都必须触发该事件。
event Approval(address indexed _owner, address indexed _spender, uint256 _value)
4
实现
已经有许多 ERC20 兼容的代币部署在以太坊网络上。 不同的团队编写了不同的实现,这些团队有不同的权衡:从节约 gas 到提高安全性。
可用的示例实现如下:
https://github.com/ConsenSys/Tokens/blob/master/contracts/eip20/EIP20.sol
再次调用"approve"前增加强制设为0的实现:
https://github.com/Giveth/minime/blob/master/contracts/MiniMeToken.sol
5
历史
与该标准有关的历史链接:
**Vitalik Buterin的原始提议: **
**Reddit discussion: **
https://www.reddit.com/r/ethereum/comments/3n8fkn/lets_talk_about_the_coin_standard/
**Original Issue #20: **
https://github.com/ethereum/EIPs/issues/20
本文作者:HiBlock区块链技术布道群-Bob
原文发布于GitHub
原文地址:
https://github.com/bobjiang/EIPs/blob/master/EIPS-CN/eip-20.md
加微信baobaotalk_com,加入技术布道群
线下活动推荐
image image