SIP20-SRC20 代幣標準
簡要說明
代幣(Token)的標準介面。
摘要
本標準說明了在智能合約中實現代幣的標準API。
該標準提供了代幣的基本功能:如轉移代幣,授權代幣給其他人(如鏈上第三方應用)使用。
動機
標準介面允許以太坊上的任何代幣被其他應用程序重用,如錢包、去中心化交易所等。
API 規範
函數
注意:
- 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)
實現
在以太坊網絡上已經有大量符合 ERC20 的代幣。 各個團隊有不同的實現,有些注重安全性,有些關注使用更少的 gas。