【Ethereum】Ethereumで独自のトークンの作成してみる

Ethereumのトークンとは

Ethereum上でトークンとよばれるコントラクトを作成することで独自の暗号通貨を作成することが可能です。 トークンを使うことで、コイン、ポイントなど様々な仮想的な価値をEthereumの仕組みの上で利用することができます。 トークンはEhereumのネットワーク上のアカウント間で自由にやりとりすることが可能です。

トークンコンストラクト

トークンを定義するためのコンストラクトには、幾つかの標準APIが定義されています。
トークンAPIの議論についてはここでされています。
Ethereumのトークンのサンプル実装は、ここにあります。

pragma solidity ^0.4.8;
contract tokenRecipient { function receiveApproval(address _from, uint256 _value, address _token, bytes _extraData); }

contract MyToken {
    /* Public variables of the token */
    string public standard = 'Token 0.1';
    string public name;
    string public symbol;
    uint8 public decimals;
    uint256 public totalSupply;

    /* This creates an array with all balances */
    mapping (address => uint256) public balanceOf;
    mapping (address => mapping (address => uint256)) public allowance;

    /* This generates a public event on the blockchain that will notify clients */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /* This notifies clients about the amount burnt */
    event Burn(address indexed from, uint256 value);

    /* Initializes contract with initial supply tokens to the creator of the contract */
    function MyToken(
        uint256 initialSupply,
        string tokenName,
        uint8 decimalUnits,
        string tokenSymbol
        ) {
        balanceOf[msg.sender] = initialSupply;              // Give the creator all initial tokens
        totalSupply = initialSupply;                        // Update total supply
        name = tokenName;                                   // Set the name for display purposes
        symbol = tokenSymbol;                               // Set the symbol for display purposes
        decimals = decimalUnits;                            // Amount of decimals for display purposes
    }

    /* Send coins */
    function transfer(address _to, uint256 _value) {
        if (_to == 0x0) revert();                               // Prevent transfer to 0x0 address. Use burn() instead
        if (balanceOf[msg.sender] < _value) revert();           // Check if the sender has enough
        if (balanceOf[_to] + _value < balanceOf[_to]) revert(); // Check for overflows
        balanceOf[msg.sender] -= _value;                     // Subtract from the sender
        balanceOf[_to] += _value;                            // Add the same to the recipient
        Transfer(msg.sender, _to, _value);                   // Notify anyone listening that this transfer took place
    }

    /* Allow another contract to spend some tokens in your behalf */
    function approve(address _spender, uint256 _value)
        returns (bool success) {
        allowance[msg.sender][_spender] = _value;
        return true;
    }

    /* Approve and then communicate the approved contract in a single tx */
    function approveAndCall(address _spender, uint256 _value, bytes _extraData)
        returns (bool success) {
        tokenRecipient spender = tokenRecipient(_spender);
        if (approve(_spender, _value)) {
            spender.receiveApproval(msg.sender, _value, this, _extraData);
            return true;
        }
    }        

    /* A contract attempts to get the coins */
    function transferFrom(address _from, address _to, uint256 _value) returns (bool success) {
        if (_to == 0x0) revert();                                // Prevent transfer to 0x0 address. Use burn() instead
        if (balanceOf[_from] < _value) revert();                 // Check if the sender has enough
        if (balanceOf[_to] + _value < balanceOf[_to]) revert();  // Check for overflows
        if (_value > allowance[_from][msg.sender]) revert();     // Check allowance
        balanceOf[_from] -= _value;                           // Subtract from the sender
        balanceOf[_to] += _value;                             // Add the same to the recipient
        allowance[_from][msg.sender] -= _value;
        Transfer(_from, _to, _value);
        return true;
    }

    function burn(uint256 _value) returns (bool success) {
        if (balanceOf[msg.sender] < _value) revert();            // Check if the sender has enough
        balanceOf[msg.sender] -= _value;                      // Subtract from the sender
        totalSupply -= _value;                                // Updates totalSupply
        Burn(msg.sender, _value);
        return true;
    }

    function burnFrom(address _from, uint256 _value) returns (bool success) {
        if (balanceOf[_from] < _value) revert();                // Check if the sender has enough
        if (_value > allowance[_from][msg.sender]) revert();    // Check allowance
        balanceOf[_from] -= _value;                          // Subtract from the sender
        totalSupply -= _value;                               // Updates totalSupply
        Burn(_from, _value);
        return true;
    }
}

• 上記がサンプル実装のトークンコントラクトのソースです。
• プログラム処理としてはそれほど難しくないため、何となく書いてあることは理解できます。

各構文の理解もしていきたいのですが、今回はこのトークンコントラクトのサンプルソースを使って、新しいトークンをデプロイしてみます。

実行環境

• Ubuntu14.04 on docker

Ethereumのプライベートネットワークを作成する

• トークンは本番ネットワークではなくプライベートネットワークで作成します。
• プライベートネットワークの作成については以下を参照ください。

inon29.hateblo.jp

プライベートネットワーク(node)の起動

プライベートネットワークを起動してコントラクトを作成する準備をします。
コントラクトを作成するトランザクションでマイニングが必要なため予めマイニングをスタートしておきます。

geth \
--datadir /ethereum/eth_private  \
--mine  \
--nodiscover  \
--maxpeers 0  \
--networkid 13  \
--rpc  \
--rpcport 8545  \
--rpcaddr "0.0.0.0"  \
--rpcapi="db,eth,net,web3,personal,web3" \
--rpccorsdomain "*" 

• mine: マイニングを許可する。このオプションを指定するとマイニングが始まります。
• nodiscover: Gethはデフォルトで自動的に（同じネットワークID）のEthereumネットワークのノード（Peer）を探し接続を試みます。プライベート・ネットで未知のノードとの接続を避けるため、このオプションを指定することで自動Peer探索機能を無効にします。
• maxpeers: ネットワークに接続するノードの最大数(デフォルト25) 0を指定するとネットワークが無効になります。
• networkid: ネットワークID(デフォルト1) 1を指定するとグローバルのネットワークに接続されます。
  • 2,3,4も予約されているようです。(2=Morden (disused), 3=Ropsten)
• rpc: HTTP-RPC serverとして動作を許可する
• rpcport: HTTP-RPCで使用するポート番号
• rpcaddr: 接続ホスト
• rpcapi: HTTP-RPCのインタフェースの種類
• rpccorsdomain クロスオリジンを許可するリスト

後述するEthereum walletでJSON-RPC経由で接続するためにRPCの許可をしています。

送信先のテストアカウントを作成

作成したトークンを送信するためのテストアカウントをコンソール上で作成しておきます。

> personal.newAccount('<任意のパスフレーズ>')
"0xe41253c3218ade0650469b87dcb97a3298d3b5d8"

• コンソールからアカウントを作成します。

Ethereum walletのインストール

• Ethereum walletとはEthereumの公式のツールです。Ethereum Walletを使うとウォレットの管理をGUIベースで行うことができます。
• その他にもEthereum walletでは、コントラクトの作成や独自トークンの管理など便利な機能があります。
• 今回はこのEthereum walletを使って独自のトークンを作成&デプロイします。

### インストール

• ダウンロードページから自分にあった環境のツールをダウンロードします。
  • 僕はDocker環境上でプライベートネットワークを動かしていますが、Ethereum walletはMac上のアプリとしてインストールしました。

Ethereum walletの起動(Mac環境)

% /Applications/Ethereum\ Wallet.app/Contents/MacOS/Ethereum\ Wallet --rpc http://localhost:8545

• MacアプリのEthereum walletから先程起動したプライベートノードへ接続します
  • 僕は、Geth環境をDocker上に作成しているため、あらかじめDockerで8545ポートをフォワーディングしています。

• rpcのセキュリティ警告がでますがOKを押下して進みます。
  • (RPCは接続制御ができないため、テスト環境以外では使わない方がいいと思います。)

• LAUNCH APPLICATIONを押下します

• ネットワークの接続に成功するとwallet画面が表示されます
• 先程作成したアカウント(coinbaseと送信用)が2つ表示されていれば正しく接続されています。

カスタムトークンをデプロイする

• Ethereum wallet上からカスタムのトークンを作成してみます。
• アプリ上メニューのCONTRACTS > DEPLOY NEW CONTRACT を押下

• Deploy contract画面を少しスクロールしてSOLIDITY CONTRACT SOURCE CODEの部分にサンプルソースをそのまま添付します

• しばらくするとコンパイルが完了するので、画面右のSELECT CONTRACT TO DEPLOYからMy Tokenを選択します

• 作成するトークンの情報を入力します
• Initial supply: 初期のトークン総量。今回は10000トークン発行します。
• Token name: トークンの名前です。今回はMyTokenという名前のトークンを発行します。
• Decimal units: トークンの小数点以下の桁数を入力します。(下2桁であれば2と入力する)。今回は2にします。
  • Initial supplyが10000でDecimal unitsが2の場合、100.00になります。下2桁までいれて合計10000トークンということです。
• Token symbol: トークンの単位です。今回はmtとしました。(1トークン=1mt)

この辺、ちゃんと理解できていないのですが、SELECT FEEは1トランザクションを処理する時の手数料で、 大きな値を設定するほど、トランザクション処理の時間が短くなるということっぽいです。 今回は、そのまま指定の値で作成します。

全て入力を終えたらDeployボタンを押下します。

• 作成するContractの情報が表示されるので、作成アカウントのパスワードを入力してSEND TRANSACTIONを押下します。

• wallet画面にもどるので、トランザクションの承認が終わるまで待ちます。

• 承認が終わったら、Contractを作成したアカウントを押下してアカウントの詳細画面へ遷移すると自分が作成したトークン情報が確認できます。

トークンを送信してみる。

• アカウント画面のMyTokenの右にあるSendボタンを押下してみます。

• トークンの送信画面になるので、相手先のアカウントのアドレスと送信したいトークン数を入力してトークンを送ってみます。
• 相手のアカウントのアドレスは予めコピーしておきます。

• パスワードを入力してトランザクションを送信します。

• 送信相手のアカウント情報を見てみると30mtが送られていることが確認できます。

参考リンク

• www.ethereum.org

• ブロックチェーンEthereum入門 3 | NTTデータ先端技術株式会社