サービス

技能：エンジニア

技能：デザイナー

技能：ビジネス職

技能：バックオフィス

ジャンル

<h2>はじめに</h2>

<p>はじめまして。DMM.comラボ CTO室のKIMと申します。 最先端技術の調査や検証・研究開発をしております。</p>

<p>今回は、Ethereum DApps(Decentralized Applications: 分散型アプリケーション)開発におけるツールとその使い方についてご紹介したいと思います。記事で紹介するソースコードは<a href="https://github.com/jkcomment/perigordTestDapp" target="_blank">ここ</a>にありますので、是非参考にしてみてください。</p>

<h2>GoでDApps開発をしたい</h2>

<p>最近EthereumのクライアントライブラリであるWeb3.jsを各言語にコンバートしたライブラリや便利な開発ツールがいろいろ出てきてますね！</p>

<p>例えば</p>

<table border="1" cellpadding="1" cellspacing="1" style="width:500px;">
	<tbody>
		<tr>
			<td style="background-color: rgb(247, 247, 247);"><strong>言語</strong></td>
			<td style="background-color: rgb(247, 247, 247);"><strong>ライブラリ(ツール)</strong></td>
		</tr>
		<tr>
			<td>JavaScript</td>
			<td><a href="https://github.com/ethereum/web3.js" target="_blank">Web3.js</a></td>
		</tr>
		<tr>
			<td>Python</td>
			<td><a href="https://github.com/ethereum/web3.py" target="_blank">Web3.py</a></td>
		</tr>
		<tr>
			<td>Java</td>
			<td><a href="https://web3j.io/" target="_blank">web3j(非公式)</a></td>
		</tr>
		<tr>
			<td>Ruby</td>
			<td><a href="https://github.com/EthWorks/ethereum.rb" target="_blank">ethereum.rb(非公式)</a></td>
		</tr>
	</tbody>
</table>

<p>上記の表のように他の言語には代表的な便利なツールやライブラリがありますが、 Goにはこれといった開発ツールやライブラリは今までありませんでした(ライブラリを使わなくてもGoでDAppsを開発することはできますが、その手順ややり方がややこしく、そのまま使うには少しハードルが高いものになっています)。</p>

<p>そこで、Go実装の開発ツールであるPerigordを使って、Ethereumに接続し、DAppsを実行するところまで試してみました。</p>

<h2>Perigordとは</h2>

<p>Perigordは、Goで簡単かつ効率良くDAppsが開発できるツール(フレームワーク)です。</p>

<p>上述したように、 GoでDAppsを開発することはできますが、その手順ややり方がややこしく、そのまま使うには少しハードルが高いものになっています。そういった部分を使いやすく、シンプルにしたのがこのPerigordです。 Truffleに似ていて、<a href="https://polyswarm.io/ja/" target="_blank">PolySwarm</a>というプロダクトの基盤技術として使われています。</p>

<div data-oembed-url="https://github.com/polyswarm/perigord">
<div>
<div style="left: 0; width: 100%; height: 0; position: relative; padding-bottom: 50%; padding-top: 120px;"><iframe allowfullscreen="" src="//if-cdn.com/H4fGnjO?app=1" style="top: 0; left: 0; width: 100%; height: 100%; position: absolute; border: 0;" tabindex="-1"></iframe></div>
</div>
<script async="" charset="utf-8" src="//if-cdn.com/embed.js"></script></div>

<h2>使い方</h2>

<p>Perigordは、かなりシンプルで、コマンドを叩くだけでプロジェクト作成ができたり、コントラクトが追加できたりします(もちろんビルドも、テストもです)。 Truffleを経験したことがある人であればTruffleに似ていることがすぐわかると思います(実際に、Perigordの作者はTruffleからいろいろと影響を受けたと語っています)。</p>

<h3>Perigordでよく使うコマンド一覧</h3>

<table border="1" cellpadding="1" cellspacing="1" style="width:500px;">
	<tbody>
		<tr>
			<td style="background-color: rgb(247, 247, 247);">コマンド</td>
			<td style="background-color: rgb(247, 247, 247);">説明</td>
		</tr>
		<tr>
			<td>perigord init &lt;プロジェクト名&gt;&nbsp;</td>
			<td>新規プロジェクト初期化</td>
		</tr>
		<tr>
			<td>perigord build</td>
			<td>ビルド</td>
		</tr>
		<tr>
			<td>perigord add contract &lt;コントラクト名&gt;</td>
			<td>新規Contract作成</td>
		</tr>
		<tr>
			<td>perigord add migration &lt;コントラクト名&gt;</td>
			<td>migration追加</td>
		</tr>
		<tr>
			<td>perigord add test &lt;コントラクト名&gt;</td>
			<td>test追加</td>
		</tr>
		<tr>
			<td>perigord test</td>
			<td>test実行</td>
		</tr>
	</tbody>
</table>

<h3>簡単なDAppsを作ってみる</h3>

<p>ここで簡単なDAppsの作り方をご紹介したいと思います。 まずインストール方法から見てみましょう。</p>

<h3>事前準備</h3>

<p>Perigordを利用するには、下記のものが必須となります。</p>

<ul>
	<li>Go</li>
	<li>Geth</li>
	<li>Solc</li>
	<li>abigen</li>
</ul>

<p>今回は、Macで検証を行なったため、Macベースでのインストール方法をご紹介します。</p>

<h2>前提条件</h2>

<ul>
	<li>Homebrewインストール済</li>
	<li>Goインストール済(GOPATHの設定も含む)</li>
	<li>ここではGethやSolidity言語に関する詳細なお話はしません。ご了承ください</li>
</ul>

<h2>Geth、Solcのインストール</h2>

<p>Geth、Solcのインストールは、Homebrewで行います。</p>

<pre>
<code>$ brew tap ethereum/ethereum
$ brew install ethereum solidity</code></pre>

<h2>abigenインストール</h2>

<p>abigenは、コントラクトを簡単かつ安全にBindingできるようにABIベースのGo Codeを生成してくれるツールです。</p>

<p>go getコマンドでインストールします。</p>

<pre>
<code>$ go get github.com/ethereum/go-ethereum
$ pushd $GOPATH/src/github.com/ethereum/go-ethereum
$ go install ./cmd/abigen
$ popd</code></pre>

<h2>Perigordインストール</h2>

<p>今回の主人公です。</p>

<p>go getコマンドでインストールします。</p>

<pre>
<code>$ go get -u github.com/polyswarm/perigord/... &amp;&amp; \
    go get -u github.com/jteeuwen/go-bindata/...</code></pre>

<h2>確認</h2>

<p>perigordコマンドを叩いて、下記のような画面が表示されたら正常にインストール完了です。</p>

<pre>
<code>$ perigord
A golang development environment for Ethereum

Usage:
  perigord [command]

Available Commands:
  add         Add a new contract or test to the project
  build       (alias for compile)
  compile     Compile contract source files
  deploy      (alias for migrate)
  generate    (alias for compile)
  help        Help about any command
  init        Initialize new Ethereum project with example contracts and tests
  migrate     Run migrations to deploy contracts
  test        Run go and solidity tests

Flags:
  -h, --help   help for perigord

Use "perigord [command] --help" for more information about a command.</code></pre>

<h2>新しいプロジェクト作成</h2>

<p>perigordコマンドを使って新しいDAppプロジェクトを作成します。</p>

<pre>
<code>$ perigord init perigordTestDapp
$ pushd $GOPATH/src/perigordTestDapp</code></pre>

<p>下記のようなプロジェクトのディレクトリ構成になります。</p>

<pre>
<code>$ tree
.
├── contracts
│   └── Foo.sol
├── generate.go
├── main.go
├── migrations
│   └── 1_Migrations.go
├── perigord.yaml
├── stub
│   ├── README.md
│   └── main.go
├── stub_test.go
└── tests
    └── Foo.go</code></pre>

<h2>コントラクト作成</h2>

<p>Greeterという名前の新しいコントラクトを生成します。</p>

<pre>
<code>$ perigord add contract Greeter</code></pre>

<p>生成したコントラクトの中身を下記のように変更します。</p>

<h3>contracts/Greeter.sol</h3>

<pre>
<code>pragma solidity ^0.4.4;

contract Greeter {
    string public greeting;

    event Result(address from, string stored);

    function Greeter() {
        greeting = "Hello";
    }

    function setGreeting(string _greeting) public {
        greeting = _greeting;
        Result(msg.sender, greeting);
    }

    function greet() constant returns (string) {
        return greeting;
    }
}
</code></pre>

<h2>ビルド</h2>

<p>作成したコントラクトをビルドします。</p>

<pre>
<code>$ perigord build</code></pre>

<p>ビルドが完了すると、bindingsとbuildディレクトリが生成されます。</p>

<p>また、生成された各ディレクトリの下にデプロイに必要なファイルが生成されていることがわかります。</p>

<pre>
<code>$ tree
.
├── bindings
│   ├── Foo.go
│   └── Greeter.go
├── build
│   ├── Foo.abi
│   ├── Foo.bin
│   ├── Foo.link
│   ├── Greeter.abi
│   ├── Greeter.bin
│   └── Greeter.link
. . .</code></pre>

<h2>マイグレーション</h2>

<p>コントラクトをデプロイするには、マイグレーションを追加する必要があります。</p>

<pre>
<code>$ perigord add migration Greeter</code></pre>

<p>migrationsディレクトリに2_Greeter.goというファイルが生成されます。</p>

<pre>
<code>$ tree
. . .
├── migrations
│   └── 1_Migrations.go
│   └── 2_Greeter.go
. . .
</code></pre>

<h2>GoでDAppsを操作する</h2>

<p>GoでDAppsを操作するために、Goでコードを書きます。</p>

<p>今回は３つのファイルに分けて、DAppsの操作に必要な機能やデータインタフェースを作ります。</p>

<h3>main.go</h3>

<p>今回のサンプルのメイン処理を定義するファイルです。</p>

<p>main関数の中の流れは、下記の順になります。</p>

<pre>
<code>　　　初期化
　　　　　　↓
　　　　 デプロイ
　　　　　　↓
　　　コントラクト接続
　　　　　　↓
イベント監視用チャンネル設定
　　　　　　↓
　　　データ取得と更新
　　　　　　↓
　イベント取得とデータ取得</code></pre>

<pre>
<code>package main

import (
    "context"
    "fmt"
    "perigordTestDapp/bindings"
    _ "perigordTestDapp/migrations"
    "log"

    "github.com/polyswarm/perigord/contract"
    "github.com/polyswarm/perigord/migration"
    "github.com/polyswarm/perigord/network"
)

var greeter *Greeter

func main() {
    // 初期化
    network.InitNetworks()

    // perigord.yamlから情報を取得し、接続を行う
    nw, err := network.Dial("dev")
    if err != nil {
        log.Fatalln("Could not connect to dev network: ", err)
    }

    // マイグレーション実行(デプロイ)
    if err := migration.RunMigrations(context.Background(), nw, false); err != nil {
        log.Fatalln("Error running migrations: ", err)
    }

    // コントラクト接続
    session, ok := contract.Session("Greeter").(*bindings.GreeterSession)
    if !ok {
        log.Fatalln("Error retrieving session")
    }

    greeter = NewGreeter(session, nw.Client())
    // イベント監視用チャンネル
    eventChan := make(chan *Event)
    if err := greeter.WatchForEvents(eventChan); err != nil {
        log.Println("error listening for incoming events:", err)
        return
    }

    // データ取得
    fmt.Printf("更新前: %s\n", greeter.Greet())

    // データ更新
    greeter.SetGreeting("Hello, World!:D")

    //  イベント監視
    for {
        event := &lt;-eventChan
        fmt.Println("Event結果\n")
        fmt.Printf("from: %v\n", event.Body.(*NewEvent).From.Hex())
        fmt.Printf("stored: %v\n", event.Body.(*NewEvent).Stored)
        // 先ほど更新した内容("Hello, World!:D")に更新されているか確認
        fmt.Printf("更新後: %s\n", greeter.Greet())
    }
}</code></pre>

<h3>greeter.go</h3>

<p>Greeterコントラクトに定義されている機能を実行します。GetやSet、Event監視機能があります。</p>

<pre>
<code>package main

import (
    "context"
    "encoding/json"
    "perigordTestDapp/bindings"
    "log"
    "strings"

    ethereum "github.com/ethereum/go-ethereum"
    "github.com/ethereum/go-ethereum/accounts/abi"
    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/core/types"
    "github.com/ethereum/go-ethereum/ethclient"
    "github.com/polyswarm/perigord"
    "github.com/polyswarm/perigord/contract"
)

type Greeter struct {
    session *bindings.GreeterSession
    client  *ethclient.Client
}

func NewGreeter(session *bindings.GreeterSession, client *ethclient.Client) *Greeter {
    return &amp;Greeter{
        session: session,
        client:  client,
    }
}

func (g *Greeter) Greet() string {
    greet, _ := g.session.Greet()
    return greet
}

func (g *Greeter) SetGreeting(greeting string) error {
    if result, _ := g.session.SetGreeting(greeting); result == nil {
        log.Fatalln("failed set greeting.")
    }
    return nil
}

// イベント監視
func (g *Greeter) WatchForEvents(eventChan chan *Event) error {
    topics := map[string]common.Hash{
        "Result": perigord.EventSignatureToTopicHash("Result(address,string)"),
    }

    q := ethereum.FilterQuery{
        Addresses: []common.Address{contract.AddressOf("Greeter")},
        Topics: [][]common.Hash{{
            topics["Result"],
        }},
    }

    dec := json.NewDecoder(strings.NewReader(bindings.GreeterABI))
    var abi abi.ABI
    if err := dec.Decode(&amp;abi); err != nil {
        return err
    }

    logChan := make(chan types.Log)
    sub, err := greeter.client.SubscribeFilterLogs(context.Background(), q, logChan)
    if err != nil {
        return err
    }
    go func() {
        log.Println("Starting event monitor")
        for {
            select {
            case logMsg := &lt;-logChan:
                if len(logMsg.Topics) != 1 {
                    log.Println("incorrect number of topics")
                    break
                }

                var nbe NewEventLog
                if err := abi.Unpack(&amp;nbe, "Result", logMsg.Data); err != nil {
                    log.Println("error unpacking log: ", err)
                    break
                }

                event := &amp;Event{
                    Type: "Result",
                    Body: NewEventFromLog(nbe),
                }
                eventChan &lt;- event
                break
            case err := &lt;-sub.Err():
                log.Println(err)
                break
            }
        }
    }()

    return nil
}</code></pre>

<h3>event.go</h3>

<p>Event監視の時に使うデータインタフェースを定義します。</p>

<pre>
<code>package main

import "github.com/ethereum/go-ethereum/common"

type Event struct {
    Type string
    Body interface{}
}

type NewEventLog struct {
    From   common.Address
    Stored string
}

type NewEvent struct {
    From   common.Address
    Stored string
}

func NewEventFromLog(nbe NewEventLog) *NewEvent {
    return &amp;NewEvent{
        From:   nbe.From,
        Stored: nbe.Stored,
    }
}</code></pre>

<h2>実行</h2>

<p>まず、testnetを実行します。</p>

<p>インストールしたperigordディレクトリの中に、testnetの実行スクリプトファイルがあるので、それを使ってtestnetを実行します(別のターミナルで実行することをお勧めします)。</p>

<pre>
<code>$ $GOPATH/src/github.com/polyswarm/perigord/scripts/launch_geth_testnet.sh</code></pre>

<p>次に、ビルドの前にファイルの内容を少し修正します。</p>

<p>Perigord buildコマンドで生成されたものをそのままビルド・実行すると、実行後にアカウントのパスワードを聞かれるので、ビルド前にmigrationsディレクトリにあるファイルを修正します。</p>

<h3>migrations/1_Migrations.go, migrations/2_Greeter.go</h3>

<pre>
<code>. . .
func (d *GreeterDeployer) Deploy(ctx context.Context, network *network.Network) (common.Address, *types.Transaction, interface{}, error) {
    account := network.Accounts()[0]
    // 下記の行をコメントアウトもしくは削除
    network.UnlockWithPrompt(account)
    // 下記の行を追加
    network.Unlock(account, "blah")

    . . .
}

func (d *GreeterDeployer) Bind(ctx context.Context, network *network.Network, address common.Address) (interface{}, error) {
    account := network.Accounts()[0]
    // 下記の行をコメントアウトもしくは削除
    network.UnlockWithPrompt(account)
    // 下記の行を追加
    network.Unlock(account, "blah")

    . . .
}
. . .</code></pre>

<p>最後に、go buildコマンドでGoファイルをビルドし、実行します。</p>

<pre>
<code>$ go build main.go greeter.go event.go
$ ./main</code></pre>

<p>実行すると、下記のような結果が画面に表示されます。</p>

<figure class="image"><img alt="" height="227" src="https://image.dmm-corp.com/tbb1309pdajec5jq6omhzsbyirvf" width="800" />
<figcaption>実行結果</figcaption>
</figure>

<h2>終わりに</h2>

<p>まだプロジェクト自体の歴史も浅いですし、Truffleなどの他のツールに比べるとまだまだって感じがしますが、 GoでDAppsの開発ができるのはやはり大きいかなと思います。今後が楽しみですね！</p>

<h2>参考</h2>

<p><a href="https://decentralize.today/introducing-perigord-golang-tools-for-ethereum-dapp-development-60556c2d9fd">https://decentralize.today/introducing-perigord-golang-tools-for-ethereum-dapp-development-60556c2d9fd</a></p>

<p><a href="https://github.com/polyswarm/perigord" target="_blank">GitHub - polyswarm/perigord: Perigord: Golang Tools for Ethereum Development</a></p>

<p><a href="https://github.com/ethereum/go-ethereum/wiki/Native-DApps:-Go-bindings-to-Ethereum-contracts" target="_blank">Native DApps: Go bindings to Ethereum contracts &middot; ethereum/go-ethereum Wiki &middot; GitHub</a></p>

<p><a href="https://ethereum.stackexchange.com/questions/28637/how-to-decode-log-data-in-go" target="_blank">go ethereum - How to decode Log.Data in Go - Ethereum Stack Exchange</a></p>


Go言語でEthereumへ接続し、DAppsを実行する

シェア