ERC20协议API接口规范

Posted 2022-06-10 杰哥的技术杂货铺

注意:

• 当要实现一个满足 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)