TRC20 代幣合約範例的中文注釋
pragma solidity ^0.4.16; interface tokenRecipient { function receiveApproval(address _from, uint256 _value, address _token, bytes _extraData) external; } contract TokenTRC20 { // 代幣的公共變數 string public name; string public symbol; uint8 public decimals = 18; //強烈建議使用預設的 18位小數 uint256 public totalSupply; // 建立一個存入所有餘額的陣列 mapping (address => uint256) public balanceOf; mapping (address => mapping (address => uint256)) public allowance; // 在鏈上產生一個通知客戶端程式的公共事件 event Transfer(address indexed from, address indexed to, uint256 value); // 通知客戶端燒掉多少代幣 event Burn(address indexed from, uint256 value); /** * 建構函數 * * 用合約的代幣供應量來初始化合約 */ function TokenTRC20( uint256 initialSupply, string tokenName, string tokenSymbol ) public { totalSupply = initialSupply * 10 ** uint256(decimals); // 用小數的總量來更新代幣的總量 balanceOf[msg.sender] = totalSupply; // 把所有的代幣全部給建立者 name = tokenName; // 代幣名稱 symbol = tokenSymbol; // 代幣符號 } /** * 內部轉移,只能被這個合約呼叫 */ function _transfer(address _from, address _to, uint _value) internal { // 防止轉移到 0x0 的地址,如果要燒掉代幣,就用 burn() require(_to != 0x0); // 檢查傳送者是不是有足多的餘額 require(balanceOf[_from] >= _value); // 溢位檢查 require(balanceOf[_to] + _value >= balanceOf[_to]); // 儲存雙方餘額,以備未來判斷 uint previousBalances = balanceOf[_from] + balanceOf[_to]; // 從傳送者減掉代幣數量 balanceOf[_from] -= _value; // 把代幣數量加到接收者 balanceOf[_to] += _value; emit Transfer(_from, _to, _value); // 使用統計來分析判斷你的代碼是不是有 Bug assert(balanceOf[_from] + balanceOf[_to] == previousBalances); } /** * 轉移代幣 * * 從你的帳號轉移 `_value` 數量的代幣,到`_to` 這個帳號 * * @param _to 接收者地址 * @param _value 代幣要轉移的數量 */ function transfer(address _to, uint256 _value) public { _transfer(msg.sender, _to, _value); } /** * 從其他地址轉移代幣 * * 從 `_from` 轉移 `_value` 數量的代幣,到 `_to` 地址 * * @param _from 傳送者地址 * @param _to 接收者地址 * @param _value 代幣要轉移的數量 */ function transferFrom(address _from, address _to, uint256 _value) public returns (bool success) { require(_value <= allowance[_from][msg.sender]); // 檢查是不是經過允許 allowance[_from][msg.sender] -= _value; _transfer(_from, _to, _value); return true; } /** * 允許其他地址使用你的代幣 * * 允許其他地址 `_spender` 使用你不多於 `_value` 數量的代幣 * * @param _spender 允許使用你代幣的其他地址 * @param _value 允許使用的最大代幣數量 */ function approve(address _spender, uint256 _value) public returns (bool success) { allowance[msg.sender][_spender] = _value; return true; } /** * 允許並通知其他地址使用你的代幣 * * 允許其他地址 `_spender` 使用你不多於 `_value` 數量的代幣,並且通知合約 * * @param _spender 允許使用你代幣的其他地址 * @param _value 允許使用的最大代幣數量 * @param _extraData 額外的信息發送到批准的合約 */ function approveAndCall(address _spender, uint256 _value, bytes _extraData) public returns (bool success) { tokenRecipient spender = tokenRecipient(_spender); if (approve(_spender, _value)) { spender.receiveApproval(msg.sender, _value, this, _extraData); return true; } } /** * 銷毀代幣 * * 系統性不可復原的刪除 `_value` 數量的代幣 * * @param _value 要燒掉的代幣數量 */ function burn(uint256 _value) public returns (bool success) { require(balanceOf[msg.sender] >= _value); // 檢查傳送者的代幣是否足夠 balanceOf[msg.sender] -= _value; // 從傳送者扣掉代幣 totalSupply -= _value; // 更新總量 emit Burn(msg.sender, _value); return true; } /** * 從其他帳號銷毀代幣 * * 系統性不可復原的從 `_from` 帳號刪除 `_value` 數量的代表 * * @param _from 要刪除帳號的代幣 * @param _value 要燒掉的代幣數量 */ function burnFrom(address _from, uint256 _value) public returns (bool success) { require(balanceOf[_from] >= _value); // 檢查要刪除的帳號代幣是否足夠 require(_value <= allowance[_from][msg.sender]); // 檢查是否被允許 balanceOf[_from] -= _value; // 從帳號刪除 allowance[_from][msg.sender] -= _value; // 從傳送者裡面的允許數量裡刪除 totalSupply -= _value; // 更新總量 emit Burn(_from, _value); return true; } }
波場Tron 的 TRC20 代幣很像以太坊 Ethereum 的 ERC20 代幣,當然不同的區塊鏈有不同的機制,兩者不完全相同。
沒有開發過 Token 合約的小伙伴,稍微注意一下所謂小點數 Decimal 的用法。一個簡單的想像,比如 decimal 等於 6 的意思就是把小數點後第六位當成個位數 。這個範例裡面的 decimal 的預設值是 18 ,就是把小數點後第18位當成個位數。所以 1 個 token 的就是 100000000000000000 。
參考
https://tronprotocol.github.io/documentation-en/contracts/trc20/