はじめに
一生懸命最適解を探しているAIも可愛いが、せっせとブロックを積み上げているValidatorたちも愛らしい。
この箱庭の愉悦を会社の皆さんに味わってもらおうと、ハンズオンの資料を作ろうとした老技術者。
ところがだ。
開発チームの皆さんは当然のごとくMac使いなのだが、ビジネスチームは皆さんWindows使い。
一昔前だとVMwareだのVirtual PCというそれこそ箱庭の中でごにょごにょするわけだったのだが、現代はWSLなる便利なものをMSさんが用意してくれている。
そして最近それがWSL2になったそうだから気にはなっていたのである。
というわけで久々に火を入れたWindowsマシンでWSL2投入し、ここを乗り切ることにしたのだった。
1. Windows10でUbuntuを使う
参考： https://qiita.com/whim0321/items/ed76b490daaec152dc69
1-1 スタートボタンを右クリックWindows Powershell（管理者）を立ち上げる
1-2 デフォルトでWSL2を使うように設定
Powershellで
wsl --install
でまずはWSLをインストールし,システム再起動。
再度Powershellで
wsl --set-default-version 2
と打ち込みリターン。
1-3 Microsoft StoreからUbuntu 20.04 LTSをインストールし起動
1-4 Ubuntu用ユーザIDとパスワードを設定
設定すると次のようなメッセージが出る。
1-5 現在のwslのバージョンを確認
Powershellで
wsl -l -v
と打ち込みリターン。
Ubuntu-20.04の行のVERSIONが2となっていればOK。
NAME STATE VERSION
* Ubuntu-20.04 Stopped 2
Tips. Windows-Linux間のファイル共有
LinuxからのWindows上のファイルへのアクセス
WindowsのCドライブがLinuxの/mnt/cにマウントされている。/mnt/cにアクセスすることで、Windows上のファイルにアクセス可能。
WindowsからLinux上のファイルへのアクセス
\\wsl.localhost\[ディストリビューション名]
でLinux上のファイルにアクセス可能。
Ubuntuを使っている場合は、
\\wsl.localhost\Ubuntu-20.04\
でアクセスする。
2. WSL2上で Docker Desktopを使う
2-1 Docker Desktop stable 2.3.0.2 以上のリリースをダウンロード
https://hub.docker.com/editions/community/docker-ce-desktop-windows/
からインストーラをダウンロードしインストール。
通常の Docker Desktop のインストール手順に従い、インストールを行いWindows スタート・メニューから Docker Desktop をスタート。
2-2 WSL2 対応エンジンを使う
Docker メニューから、 Settings > General を選択。
Use WSL 2 based engine （WSL2 対応エンジンを使う） のチェックボックスを選択。
Apply & Restart （適用と再起動）をクリック。
（WSL 2 をサポートしているシステム上に Docker Desktop をインストールした場合は、デフォルトでこのオプションが有効化されているので確認後Cancelをクリック）。
3. node.jsのインストール
3-1 nvmのインストール
まず、ubuntuをスタートメニューから立ち上げ、
ubuntuで下記のコマンドでインストールスクリプトを実行する。
（参考：https://github.com/nvm-sh/nvm#install--update-script）
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash
実行後、ubuntu再起動。
3-2 node.jsのインストール
$ nvm list-remote
で利用可能なNodeのバージョンを調べる。
このリストからLatest LTSであるv18.12.1をubuntu下記コマンドでインストール
$ nvm install v18.12.1
ちゃんとインストールできたか確認するには
$ nvm list
を実行して
こんなのが出ていればOK。
4. Truffleのインストール
これ一発でOK。
$ npm install truffle -g
結構時間かかるが、
$ truffle version
でこういうのが出ればOK。
5. cURLのインストール
これ一発でOK
$ sudo apt install curl
確認は
$ curl -V
Vは大文字にしないとエラーになる。
みたいなのが出ればOK。
6. MetaMaskのインストール
Windows10側のChromeに拡張機能MetaMaskを追加。
これで、後で作るBesuに外から操作ができるようになる。
https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn?hl=ja
から「Chromeに追加」でOK。
こんなのが出るので開始をクリック。
こんなのが出るので「ウォレットの作成」を選択。
7. Hyperledger Besuで遊ぼう
(1) Hyperledger Besuネットワークを生成する
Ubuntuから
$ npx quorum-dev-quickstart
を実行すると、どんどんやってくれる。
はじめに質問が出るので、
Hyperledger Besuを選ぶ
Codefi Orchestrate、Quorum Key Managerとprivate transactionsはnと答える。
logging with ELKを選ぶ
BlockscoutはNと答える
Where should we create the config files for this network?
という問いにはEnterでdefault設定にする｡
Installation complete.が出ればOK！
$ cd quorum-test-network
で移動して、Dockerを起動しているのを確認してから，
$ ./run.sh
こんなのが出たら成功。
*************************************
Quorum Dev Quickstart
*************************************
Setting up the index patterns in kibana ...
----------------------------------
List endpoints and services
----------------------------------
JSON-RPC HTTP service endpoint : http://localhost:8545
JSON-RPC WebSocket service endpoint : ws://localhost:8546
Web block explorer address : http://localhost:25000/explorer/nodes
Prometheus address : http://localhost:9090/graph
Grafana address : http://localhost:3000/d/XE4V0WGZz/besu-overview?orgId=1&refresh=10s&from=now-30m&to=now&var-system=All
Collated logs using Grafana and Loki : http://localhost:3000/d/Ak6eXLsPxFemKYKEXfcH/quorum-logs-loki?orgId=1&var-app=besu&var-search=
Collated logs using Kibana endpoint : http://localhost:5601/app/kibana#/discover
For more information on the endpoints and services, refer to README.md in the installation directory.
****************************************************************
もし，「docker endpoint for "default" not found」で止まったら
以下ディレクトリにある「meta.json」を削除します。
C:\Users\<ユーザ名>.docker\contexts\meta\XXXXXX\meta.json
この「XXXXXX」部分は任意の長い文字列です。.dockerディレクトリにcontextsしかない場合は.dockerディレクトリから全削除しても問題ありません。
2回目からはWindows上でスタートボタンメニューで出てきたUbuntuをつついて起動し、
Docker Desktop起動後に
$ cd quorum-test-network
で移動して、
$ ./resume.sh
でこんなのが出ればOK。
Resuming network...
----------------------------------
[+] Running 15/15
⠿ Container quorum-test-network-grafana-1 Started 6.3s
⠿ Container quorum-test-network-elasticsearch-1 Started 5.4s
⠿ Container quorum-test-network-redis-1 Started 5.8s
⠿ Container quorum-test-network-prometheus-1 Started 5.7s
⠿ Container quorum-test-network-validator1-1 Started 8.5s
⠿ Container quorum-test-network-kibana-1 Started 3.9s
⠿ Container quorum-test-network-metricbeat-1 Started 3.1s
⠿ Container quorum-test-network-filebeat-1 Started 4.0s
⠿ Container quorum-test-network-logstash-1 Started 3.8s
⠿ Container quorum-test-network-validator3-1 Started 6.8s
⠿ Container quorum-test-network-validator4-1 Started 5.9s
⠿ Container quorum-test-network-validator2-1 Started 7.3s
⠿ Container rpcnode Started 6.3s
⠿ Container quorum-test-network-explorer-1 Started 3.6s
⠿ Container quorum-test-network-ethsignerProxy-1 Started
(2) Block explorerでネットワークの概要を見る
Windows10側のブラウザで
http://localhost:25000
を見るとこんなのが見える.ノードの一覧。
Explorerというメニューを選ぶと
ブロックを横断していろいろ検索できる。
NFTのコントラクトをデプロイしてmintしたところ、Transactionの情報も出てきた。
(3) Grafanaでノードたちの様子を見る
次にやはりWindows10側のブラウザで
http://localhost:3000/
を見ると、こういうのが出るので、
「Besu Overview」をクリックすると
という感じでノードの状況がグラフィカルに確認できる。
8. JSON-RPC requests
(1) Besuのバージョン
ubuntuから
$ curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}' http://localhost:8545
を実行するとこんなのが返ってくる。
{
"jsonrpc" : "2.0",
"id" : 1,
"result" : "besu/v21.7.1/linux-x86_64/adoptopenjdk-java-11"
}
返ってきたJSONの意味は
"jsonrpc" : "2.0"
→ JSON-RPC 2.0 spec formatを使用
"id" : 1
→ request identifier（request と responseの突合用idでこの tutorialでは常に 1）
"result" : "besu/v21.7.1/linux-x86_64/adoptopenjdk-java-11"
→ besu/v21.7.1は走行しているBesuのバージョン
linux-x86_64はこのバージョンをビルドしたアーキテクチャ
adoptopenjdk-java-11はこのバージョンをビルドしたJVMの属性
(2) つながっているノード数
ubuntuから
$ curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' http://localhost:8545
を実行するとこんなのが返ってくる。
{
"jsonrpc" : "2.0",
"id" : 1,
"result" : "0x4"
}
→ JSON-RPC requestを受け取ったノードがいくつのノードとつながっているかがresultの値で、この場合は4つである。
(3) 最後に確定したブロックナンバー
ubuntuから
$ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://localhost:8545
を実行するとこんなのが返ってくる。
{
"jsonrpc" : "2.0",
"id" : 1,
"result" : "0x204d"
}
9. MetaMaskを使ってアカウント間でETHを送る
(1) アカウント作成
Chrome拡張機能リストのMetaMaskのアイコンをクリック。
ネットワークからLocalhost 8545を選ぶ。イーサリアムメインネットしか見えないときは上部の「表示・非表示」をクリックして「テストネットワークを表示」をオンにする。
これで先ほど立ち上げたBesuのネットワークにMetaMaskが接続した。
次にアカウントのインポート。
https://besu.hyperledger.org/en/stable/Tutorials/Examples/Private-Network-Example/#create-a-transaction-using-metamask
にあるprivate key to copyをどれか拝借してコピペしたのちインポートする。
大変なお金持ちになっている。
もう１つアカウントを作成する。
アカウント名を入れて、作成をクリック。
一文無しである。
(2) 送金する
では90000ETH持っているAccount2から一文無しのTestAccount2に15000ETH送金する
まず送金先TestAccount2のアドレスをコピー。
送金元のAccount2に移って送金クリック。
送金先に上でコピーしたアドレスをペーストし送金額15000ETHを入力し次へをクリックする。
確認をクリック。
少しの間の後に残高が変わった。
これで送金完了である。
10. Remixでスマートコントラクトの実装とデプロイ
参考 https://ai-china.hatenablog.com/entry/2022/01/01/130000
Remixというweb上でSolidityのコードを書いてコンパイルまでできる便利なツールを使ってスマートコントラクトを作成，Besu上にデプロイしてみる。
(1) スマートコントラクトを書く
まずRemixを開いて、
https://remix.ethereum.org/
test文字を右クリックしてNew Fileを選択し，新規ファイルを作成。
作成したいスマートコントラクト名.sol，例えばtakaToken1.solとファイル名を設定する。
こうしてできた新しいタブにコードを書いていく。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.2;
import "@openzeppelin/contracts@4.4.1/token/ERC20/ERC20.sol";
contract takaCoin0 is ERC20 {
constructor() ERC20("taka Coin", "TKC") {
_mint(msg.sender, 150000 * 10 ** decimals());
}
}
これを書き終えたら左側のSOLIDITY COMPILERをクリックする。そうするとこのようなCompile takaToken1.solというボタンが表示されるので突いてみる。
Remix表示中のタブでMetamaskを立ち上げてすでに作成しておいた例えばAccount1というアカウントを表示する。
RemixでDEPLOY & RUN TRANSACTIONを左側で選択、ENVIRONMENTをInjected Web3にし、AccountをMetamaskの先ほどのアカウントAccount2のアドレスにしてDeploy｡
するとガス代が見積もられるが、どうせガスフリーだから気にせず確認ボタンを押す。
ぴぽぱぽーんという音とともにこんなのが小さく出てくる。
そうしたら左下の端に出てくるこれをコピーボタンで取得し
Metamaskのトークンをインポートを押す。
トークンコントラクトアドレスに先ほどコピーで取得したやつをペースト、トークンシンボルにTKCと入れてカストムトークンを追加。
トークンをインポート。
入った。TKCで大富豪になった。
11. 終了する
ubuntuで
$ cd quorum-test-network
とした後、
$ ./stop.sh
でBesuは眠りにつく。