以太坊智能合约开发指南1(ERC-20代币标准)

在开始前应该具备以下知识:

  • 对于区块链的基本知识,建议看下《精通比特币》
  • 了解太坊智能合约语言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

你可能感兴趣的:(以太坊智能合约开发指南1(ERC-20代币标准))