看這篇文章需要對以太坊,智能合約,代幣等概念有基本的瞭解。
什麼是ERC20
可以把ERC20簡單理解成以太坊上的一個代幣協議,所有基於以太坊開發的代幣合約都遵守這個協議。遵守這些協議的代幣我們可以認爲是標準化的代幣,而標準化帶來的好處是兼容性好。這些標準化的代幣可以被各種以太坊錢包支持,用於不同的平臺和項目。說白了,你要是想在以太坊上發行代幣融資,必須要遵守ERC20標準。
ERC20的標準接口是這樣的:
contract ERC20 {
function name() constant returns (string name)
function symbol() constant returns (string symbol)
function decimals() constant returns (uint8 decimals)
function totalSupply() constant returns (uint totalSupply);
function balanceOf(address _owner) constant returns (uint balance);
function transfer(address _to, uint _value) returns (bool success);
function transferFrom(address _from, address _to, uint _value) returns (bool success);
function approve(address _spender, uint _value) returns (bool success);
function allowance(address _owner, address _spender) constant returns (uint remaining);
event Transfer(address indexed _from, address indexed _to, uint _value);
event Approval(address indexed _owner, address indexed _spender, uint _value);
}
name
返回ERC20代幣的名字,例如"My test token"。
symbol
返回代幣的簡稱,例如:MTT,這個也是我們一般在代幣交易所看到的名字。
decimals
返回token使用的小數點後幾位。比如如果設置爲3,就是支持0.001表示。
totalSupply
返回token的總供應量
balanceOf
返回某個地址(賬戶)的賬戶餘額
transfer
從代幣合約的調用者地址上轉移 _value的數量token到的地址 _to,並且必須觸發Transfer事件。
transferFrom
從地址 _from發送數量爲 _value的token到地址 _to,必須觸發Transfer事件。
transferFrom方法用於允許合同代理某人轉移token。條件是from賬戶必須經過了approve。這個後面會舉例說明。
approve
允許 _spender多次取回您的帳戶,最高達 _value金額。 如果再次調用此函數,它將以 _value覆蓋當前的餘量。
allowance
返回 _spender仍然被允許從 _owner提取的金額。
後面三個方法不好理解,這裏還需要補充說明一下,
approve是授權第三方(比如某個服務合約)從發送者賬戶轉移代幣,然後通過 transferFrom() 函數來執行具體的轉移操作。
賬戶A有1000個ETH,想允許B賬戶隨意調用他的100個ETH,過程如下:
- A賬戶按照以下形式調用approve函數approve(B,100)
- B賬戶想用這100個ETH中的10個ETH給C賬戶,調用transferFrom(A, C, 10)
- 調用allowance(A, B)可以查看B賬戶還能夠調用A賬戶多少個token
另外,我推薦這篇文章,對這部分概念講解的比較清楚。
(編者按:亦見文末超鏈接《科普 | 釋放阻塞的以太坊交易》)
後面兩個是事件,事件是爲了獲取日誌方便提供的。前者是在代幣被轉移時觸發,後者是在調用approve方法時觸發。
基於ERC20編寫的一個代幣合約
pragma solidity ^0.4.16;
contract Token{
uint256 public totalSupply;
function balanceOf(address _owner) public constant returns (uint256 balance);
function transfer(address _to, uint256 _value) public returns (bool success);
function transferFrom(address _from, address _to, uint256 _value) public returns
(bool success);
function approve(address _spender, uint256 _value) public returns (bool success);
function allowance(address _owner, address _spender) public constant returns
(uint256 remaining);
event Transfer(address indexed _from, address indexed _to, uint256 _value);
event Approval(address indexed _owner, address indexed _spender, uint256
_value);
}
contract TokenDemo is Token {
string public name; //名稱,例如"My test token"
uint8 public decimals; //返回token使用的小數點後幾位。比如如果設置爲3,就是支持0.001表示.
string public symbol; //token簡稱,like MTT
function TokenDemo(uint256 _initialAmount, string _tokenName, uint8 _decimalUnits, string _tokenSymbol) public {
totalSupply = _initialAmount * 10 ** uint256(_decimalUnits); // 設置初始總量
balances[msg.sender] = totalSupply; // 初始token數量給予消息發送者,因爲是構造函數,所以這裏也是合約的創建者
name = _tokenName;
decimals = _decimalUnits;
symbol = _tokenSymbol;
}
function transfer(address _to, uint256 _value) public returns (bool success) {
//默認totalSupply 不會超過最大值 (2^256 - 1).
//如果隨着時間的推移將會有新的token生成,則可以用下面這句避免溢出的異常
require(balances[msg.sender] >= _value && balances[_to] + _value > balances[_to]);
require(_to != 0x0);
balances[msg.sender] -= _value;//從消息發送者賬戶中減去token數量_value
balances[_to] += _value;//往接收賬戶增加token數量_value
Transfer(msg.sender, _to, _value);//觸發轉幣交易事件
return true;
}
function transferFrom(address _from, address _to, uint256 _value) public returns
(bool success) {
require(balances[_from] >= _value && allowed[_from][msg.sender] >= _value);
balances[_to] += _value;//接收賬戶增加token數量_value
balances[_from] -= _value; //支出賬戶_from減去token數量_value
allowed[_from][msg.sender] -= _value;//消息發送者可以從賬戶_from中轉出的數量減少_value
Transfer(_from, _to, _value);//觸發轉幣交易事件
return true;
}
function balanceOf(address _owner) public constant returns (uint256 balance) {
return balances[_owner];
}
function approve(address _spender, uint256 _value) public returns (bool success)
{
allowed[msg.sender][_spender] = _value;
Approval(msg.sender, _spender, _value);
return true;
}
function allowance(address _owner, address _spender) public constant returns (uint256 remaining) {
return allowed[_owner][_spender];//允許_spender從_owner中轉出的token數
}
mapping (address => uint256) balances;
mapping (address => mapping (address => uint256)) allowed;
}
代碼不必過多的解釋,註釋都寫得很清楚了。
這裏可能有人會有疑問,name,totalSupply這些按照標準不應該都是方法嗎,怎麼這裏定義的是屬性變量? 這是因爲solidity會自動給public變量生成同名的getter接口。
部署測試
我會提供兩個環境的部署測試流程,都是親測過的,大家可以根據自己的喜好選擇。我個人平時用得比較多的是後者。
Remix+MetaMask環境部署測試
這部分要求你的瀏覽器已經安裝了MetaMask插件,至於什麼是MetaMask以及如何安裝和使用請自行搜索查詢。MetaMask我們用的是測試環境的網絡,在測試網絡中可以申請一些以太幣進行測試。
我們把代碼複製到remix編譯,沒問題的話如下圖所示點擊create創建合約,參數可以按照下圖的方式設置。注意環境選擇injected web3,這樣會打開瀏覽器插件MetaMask進行測試部署。
-image-
點擊create後會彈出合約確認界面,直接點擊submit,等待合約確認。
-image-
我們可以在MetaMask裏點擊該筆合約提交的明細,就會跳轉到以太坊的瀏覽器中,可以在這裏看到合約的各種信息:
-image-
如上圖所示,1表示該筆交易(合約也是一種交易)的hash值,2是當前合約所處的區塊位置(當然是測試環境)和已經被確認的區塊鏈數量,3是合約的創建地址,4是合約本省所在的地址。
3和4的概念容易混淆,注意理解。
進入MetaMask的token界面中,點擊add token,然後我們把合約的地址複製到過去提交就可以看到我們的代幣了。還可以點擊代幣的圖標打開瀏覽器查看代幣的詳細信息。
-image-
到這裏你已經完成了代幣的開發部署。接下來我們還要看看如何進行代幣的轉賬,這個也是代幣比較常用的操作。轉賬我們需要結合以太坊錢包MyEtherWallet,這是個以太坊的網頁版輕量級錢包,利用它可以很方便的對我們的以太幣和其它代幣進行管理。
轉賬前我們首先要把代幣加入到錢包中,
-image-
-image-
注意在上圖中,我們選擇的環境同樣是測試環境並且和MetaMask中的環境一致。點擊add custome token,輸入代幣地址等信息就可以看到代幣了,然後進行轉賬操作。
-image-
我們隨便轉入一個地址,轉賬完成後,發現代幣餘額確實減少了。
-image-
以太坊錢包mist+geth私有環境部署測試
我個人開發用這個環境比較多,不過這個環境安裝起來比較麻煩,具體流程可以看下我以前的文章。
打開mist錢包,進入合約界面,然後點擊deploy new contact,然後把代碼複製進去編譯。
-image-
然後點擊deploy
-image-
輸入賬戶密碼開始部署。
隨着挖礦的進行,合約就被部署到我的geth私有環境中了,
-image-
回到錢包的合約界面已經可以看到合約了,
-image-
點擊transfer ether&tokens,進入轉賬界面,進行轉賬。
-image-
-image-
成功後可以看到餘額已經減少,並且轉入賬戶的餘額增加。
-image-
-image-
參考
-
乾貨 | 代幣支付的以太坊智能服務(http://www.aibbt.com/a/26166.html)
-
區塊鏈學習(4)發佈代幣(token)並通過智能合約與網頁交互(mac版)(http://www.aibbt.com/a/29159.html)