在开始前应该具备以下知识:
- 对于区块链的基本知识,建议看下《精通比特币》
- 了解太坊智能合约语言solidity,官方文档 https://solidity.readthedocs.io/en/develop/ ,也可以搜索相应的中文文档,不过中文文档的版本可能不会即时更新。
之后会逐步完成一个完整的Dapp(distributed application 分布式应用),这里选择代币合约为例子。代币(token)是目前区块链开发比较活跃的一个领域,ERC-20是以太坊官方的一个代币标准。
方法(Methods)
name
- 返回代币名称,例如"MyToken"。
- 可选的(OPTIONAL)
- 建议实现此方法以提高钱包和交易所的使用体验,但是接口或者其它合约不应依赖于此方法的存在。
function name() constant returns (string name)
symbol
- 返回代币名称的短字符串标识,例如"MTK"。
- 3-8个字符的大写英文字母,没有空白或换行符。
- 可选的(OPTIONAL)
- 建议实现此方法以提高钱包和交易所的使用体验,但是接口或者其它合约不应依赖于此方法的存在。
function symbol() constant returns (string symbol)
decimals
- 返回代币使用的小数位数。例如 8,表示代币数量除以100000000得到用户表示。
- 可选的(OPTIONAL)
- 建议实现此方法以提高钱包和交易所的使用体验,但是接口或者其它合约不应依赖于此方法的存在。
function decimals() constant returns (uint8 decimals)
totalSupply
- 返回代币当前总量。
- 本方法必须实现。
function totalSupply() constant returns (uint256 totalSupply)
balanceOf
- 返回指定地址
_owner
的账户余额。 - 本方法必须实现。
function balanceOf(address _owner) constant returns (uint256 balance)
transfer
- 返回指定地址
_owner
的账户余额。 - 本方法必须实现。
function transfer(address _to, uint256 _value) returns (bool success)
transferFrom
- 将金额为
_value
的代币从地址_from
转移到地址_to
,并且必须(MUST)触发Transfer
事件。 -
transferFrom
方法的设计,可以让合约(contract)代码实现代币转移。 - 注意:0值的代币转移必须(MUST)被视为正常的转移,并且触发
Transfer
事件。 - 本方法必须实现。
function transferFrom(address _from, address _to, uint256 _value) returns (bool success)
approve
- 设置一个金额
_value
,这个金额表示允许_spender
可支配的自己账户的额度,如 果这个函数再次调用,将覆盖当前的额度_value
。 - 本方法必须实现。
function approve(address _spender, uint256 _value) returns (bool success)
allowance
- 返回一个金额,这个金额是
_owner
授权_spender
允许支配自己账户的额度。 - 本方法必须实现。
function allowance(address _owner, address _spender) constant returns (uint256 remaining)
事件(Events)
Transfer
- 代币转移之后必须(MUST)被触发,包括零值的转移。
- 在代币创建时,应该(SHOULD)触发一个
Transfer
事件,这个事件的_from
地址设置为0x0。
event Transfer(address indexed _from, address indexed _to, uint256 _value)
Approval
- 在成功调用方法
approve(address _spender, uint256 _value)
后必须(MUST)被触发。
event Approval(address indexed _owner, address indexed _spender, uint256 _value)
标准创建日期:2015-11-19
参考文档 https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20.md