ERC20协议API接口规范

注意:

  • 当要实现一个满足 ERC-20 接口标准的 Token 智能合约时,该合约必须满足以下内容实现
  • API 规范使用 Solidity 0.4.17(或以上版本)的语法
  • 调用者必须处理 returns (bool success) 返回false , 不能假定false不会返回。

一、可选函数

- 可选函数: name

函数返回代币的名称 - 如 “MyToken” 或 “我的代币”

此函数是可选函数,但是这个函数可以提高代币可用性,不过调用者不能假定这个函数存在。

function name() public view returns (string)

- 可选函数: symbol

函数返回代币的代号(通常为字母缩写),如 “HIX”,“UPT”。

此函数是可选函数,但是这个函数可以提高代币可用性,不过调用者不能假定这个函数存在。

function symbol() public view returns (string)

- 可选函数: decimals

返回令牌使用的小数位数 - 例如"8",意味着将令牌量除以"100000000"以获取其用户表示形式。

此函数是可选函数,但是这个函数可以提高代币可用性,不过调用者不能假定这个函数存在。

function decimals() public view returns (uint8)

二、必须函数

函数: totalSupply

返回总令牌供应量。

function totalSupply() public view returns (uint256)

函数: balanceOf

返回帐户(通过参数"_owner")的余额。

function balanceOf(address _owner) public view returns (uint256 balance)

函数: transfer

向 _to 地址转移 _value 数量的代币,函数必须触发事件 Transfer 。

如果调用方的帐户余额没有足够的令牌,则该函数需要抛出异常。

注意 转移0个代币也是正常转移动作,同样需要触发 Transfer 事件。

function transfer(address _to, uint256 _value) public returns (bool success)

函数: transferFrom

从 _from 向 _to 地址转移 _value 数量的代币,函数必须触发事件 Transfer 。

transferFrom 函数,可以允许第三方代表我们转移代币。

如果 _from 账号没有授权调用帐户转移代币,则该函数需要抛出异常。

注意 转移0个代币也是正常转移动作,同样需要触发 Transfer 事件。

function transferFrom(address _from, address _to, uint256 _value) public returns (bool success)

函数: approve

授权 _spender 可以从我们账户最多转移代币的数量 _value,可以多次转移,总量不超过 _value 。

这个函数可以再次调用,以覆盖授权额度 _value 。

注意: 为了阻止向量攻击(这里有描述和讨论),调用者可以在调整授权额度时,先设置为0,然后在设置为一个其他额度。

简单描述下:向量攻击, 假如 Alice 开始时给Bob授权了 N, 现在 Alice 想调整为 M ,于是发起了一笔调整授权的交易,这时Bob观察到了这笔交易, 迅速通过 transferFrom 交易(用更高的手续费,矿工优先打包)把 N 个币转移走,待 Alice 调整授权的交易打包后,Bob 又获得了 M 个授权。 这就相当于Bob 获得了 N + M个授权, 而不是 Alice 想要的 M个授权。

function approve(address _spender, uint256 _value) public returns (bool success)

函数: allowance

查询 _owner 授权给 _spender 的额度。

function allowance(address _owner, address _spender) public view returns (uint256 remaining)

三、事件Events

- 事件:Transfer

当有代币转移时(包括转移0),必须触发 Transfer 事件。

如果是新产生代币,触发 Transfer 事件的 _from 应该设置为 0x0 。

event Transfer(address indexed _from, address indexed _to, uint256 _value)

- 事件:Approval
approve(address _spender, uint256 _value) 函数成功执行时,必须触发 Approval 事件。

event Approval(address indexed _owner, address indexed _spender, uint256 _value)

猜你喜欢

转载自blog.csdn.net/cljdsc/article/details/125204450