はじめに
ブロックチェーンを基礎から教えてほしいという要請が社内のみならずエージェントを通じて他社様から舞い込むことが多くなった．
もっと若い人に聞いたほうがいいのでは？と駄々をこねると「若い人はあなたと違って忙しいのだ」などと言う失礼な人はさすがにいないのだが，多分そうなのであろう．
P2PからはじめてコンセンサスアルゴリズムだERC20だと進めていっても生徒さんはおそらく真実とは全く違うものを思い浮かべているだろうという危惧が教えだした当初からあり，実際その通りであったという苦い経験を経て，やはり「作って学ぶ」じゃないとこの世界ダメなのだと．
そして昨年こんな記事を書いたのだった．
https://qiita.com/oldEng/items/557ceb29a7849e92b5f2
viewは1000を超えたもののいっこうに「いいね」がつかないので友人にこの通りにやってもらうとあっちこっちハマりどころがあるのだと．そういうことね，と最近買ったWindows11マシンで最新版に改訂することにした次第．
1. Windows11でUbuntuを使う
まずはWindows11のターミナルで何とかしようなどとは思わずにWSL2を使ってUbuntuを立ち上げよう．
(1) スタートボタン右クリックからターミナル（管理者）を起動
(2) WSL2をインストール
wsl --install
(3) ubuntuでusernameとpasswordを設定
うまくいかないようなら，こちらを参考にしてほしい．
参考：https://qiita.com/oldEng/items/d6f6e296167eb3ddda9b
さて，このububtu上にブロックチェーンを立ち上げるというのが今回の主題．
2. Docker Desktopをインストール
2-1 Docker Desktop stable 2.3.0.2 以上のリリースをダウンロード
Windowsに戻り，
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のバージョンを調べる。
Tips--------------------------------------------------
もし，これが出ずに代わりにN/Aなんて出てしまったら，
$ echo insecure >> ~/.curlrc
というおまじないを試してみよう．ちゃんとリストが表示されるようになる．
-------------------------------------------------------
このリストからLatest LTSであるv18.14.0をubuntu下記コマンドでインストール
$ nvm install v18.14.0
ちゃんとインストールできたか確認するには
$ 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.
****************************************************************
Tips--------------------------------------------------
もし，「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。
$ ./resume.sh
*************************************
Quorum Dev Quickstart
*************************************
Resuming network...
----------------------------------
[+] Running 15/15
⠿ Container quorum-test-network-loki-1 Started 1.2s
⠿ Container quorum-test-network-redis-1 Started 0.5s
⠿ Container quorum-test-network-prometheus-1 Started 1.4s
⠿ Container quorum-test-network-grafana-1 Started 1.2s
⠿ Container quorum-test-network-promtail-1 Started 0.7s
⠿ Container quorum-test-network-validator1-1 Started 1.4s
⠿ Container quorum-test-network-elasticsearch-1 Started 1.2s
⠿ Container quorum-test-network-metricbeat-1 Started 1.3s
⠿ Container quorum-test-network-filebeat-1 Started 1.1s
⠿ Container quorum-test-network-logstash-1 Started 1.0s
⠿ Container quorum-test-network-kibana-1 Started 1.0s
⠿ Container quorum-test-network-validator2-1 Started 1.4s
⠿ Container quorum-test-network-validator3-1 Started 1.0s
⠿ Container quorum-test-network-explorer-1 Started 1.4s
⠿ Container quorum-test-network-ethsignerProxy-1 Started 1.5s
(2) Block explorerでネットワークの概要を見る
Windows11に戻ってブラウザで
http://localhost:25000
を見るとこんなのが見える.ノードの一覧。
Explorerというメニューを選ぶと
ブロックを横断していろいろ検索できる。
NFTのコントラクトをデプロイしてmintしたところ、Transactionの情報も出てきた。
(3) Grafanaでノードたちの様子を見る
次にやはりWindows11のブラウザで
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は眠りにつく。