ローカルのマルチクライアントテストネットでdAppを開発・テストする方法

クライアント

ノード

スマートコントラクト

構成可能性

コンセンサスレイヤー

実行レイヤー

テスト

中級

Tedi Mitiku

2023年4月11日

16 分の読書

はじめに

このガイドでは、設定可能なローカルイーサリアムテストネットのインスタンス化、そこへのスマートコントラクトのデプロイ、およびdAppに対するテストを実行するためのテストネットの使用というプロセスを順を追って説明します。このガイドは、ライブのテストネットやメインネットにデプロイする前に、さまざまなネットワーク構成に対してdAppをローカルで開発・テストしたいdApp開発者向けに設計されています。

このガイドでは、次のことを行います。

Kurtosis (opens in a new tab)を使用して、eth-network-package (opens in a new tab)でローカルイーサリアムテストネットをインスタンス化する
Hardhat dApp開発環境をローカルテストネットに接続し、dAppをコンパイル、デプロイ、テストする、そして
ノード数や特定のEL/CLクライアントのペアリングなどのパラメータを含むローカルテストネットを設定し、さまざまなネットワーク構成に対する開発およびテストのワークフローを可能にする。

Kurtosisとは？

Kurtosis (opens in a new tab)は、マルチコンテナのテスト環境を構成するために設計された、構成可能なビルドシステムです。これにより、開発者は、ブロックチェーンテストネットなどの動的なセットアップロジックを必要とする再現可能な環境を作成できます。

このガイドでは、Kurtosis eth-network-packageが、geth (opens in a new tab)実行レイヤー(EL)クライアント、およびteku (opens in a new tab)、lighthouse (opens in a new tab)、lodestar (opens in a new tab)コンセンサスレイヤー(CL)クライアントをサポートするローカルイーサリアムテストネットを起動します。このパッケージは、Hardhat Network、Ganache、Anvilのようなフレームワークのネットワークに代わる、設定可能で構成可能な代替手段として機能します。 Kurtosisは、開発者が使用するテストネットに対してより優れた制御と柔軟性を提供します。これは、イーサリアム・ファウンデーションがマージのテストにKurtosisを使用した (opens in a new tab)主な理由であり、ネットワークのアップグレードをテストするためにKurtosisを使い続けている理由でもあります。

Kurtosisのセットアップ

続行する前に、次のものがあることを確認してください。

ローカルマシンにDockerエンジンをインストールして起動 (opens in a new tab)していること
Kurtosis CLIをインストール (opens in a new tab)していること(CLIがすでにインストールされている場合は、最新リリースにアップグレードしていること)
Node.js (opens in a new tab)、yarn (opens in a new tab)、およびnpx (opens in a new tab) (dApp環境用) をインストールしていること

ローカルイーサリアムテストネットのインスタンス化

ローカルイーサリアムテストネットを起動するには、次を実行します。

1kurtosis --enclave local-eth-testnet run github.com/kurtosis-tech/eth-network-package

注: このコマンドは、--enclaveフラグを使用して、ネットワークに「local-eth-testnet」という名前を付けます。

Kurtosisは、指示を解釈、検証、そして実行する際に、内部で行われている手順を出力します。最後に、次のような出力が表示されるはずです。

1INFO[2023-04-04T18:09:44-04:00] ======================================================
2INFO[2023-04-04T18:09:44-04:00] ||          Created enclave: local-eth-testnet      ||
3INFO[2023-04-04T18:09:44-04:00] ======================================================
4Name:            local-eth-testnet
5UUID:            39372d756ae8
6Status:          RUNNING
7Creation Time:   Tue, 04 Apr 2023 18:09:03 EDT
8
9========================================= Files Artifacts =========================================
10UUID           Name
11d4085a064230   cl-genesis-data
121c62cb792e4c   el-genesis-data
13bd60489b73a7   genesis-generation-config-cl
14b2e593fe5228   genesis-generation-config-el
15d552a54acf78   geth-prefunded-keys
165f7e661eb838   prysm-password
17054e7338bb59   validator-keystore-0
18
19========================================== User Services ==========================================
20UUID           Name                                           Ports                                         Status
21e20f129ee0c5   cl-client-0-beacon                             http: 4000/tcp -> <http://127.0.0.1:54261>    RUNNING
22                                                              metrics: 5054/tcp -> <http://127.0.0.1:54262>
23                                                              tcp-discovery: 9000/tcp -> 127.0.0.1:54263
24                                                              udp-discovery: 9000/udp -> 127.0.0.1:60470
25a8b6c926cdb4   cl-client-0-validator                          http: 5042/tcp -> 127.0.0.1:54267             RUNNING
26                                                              metrics: 5064/tcp -> <http://127.0.0.1:54268>
27d7b802f623e8   el-client-0                                    engine-rpc: 8551/tcp -> 127.0.0.1:54253       RUNNING
28                                                              rpc: 8545/tcp -> 127.0.0.1:54251
29                                                              tcp-discovery: 30303/tcp -> 127.0.0.1:54254
30                                                              udp-discovery: 30303/udp -> 127.0.0.1:53834
31                                                              ws: 8546/tcp -> 127.0.0.1:54252
32514a829c0a84   prelaunch-data-generator-1680646157905431468   <none>                                        STOPPED
3362bd62d0aa7a   prelaunch-data-generator-1680646157915424301   <none>                                        STOPPED
3405e9619e0e90   prelaunch-data-generator-1680646157922872635   <none>                                        STOPPED
35
すべて表示

おめでとうございます！ Kurtosisを使用して、CL (lighthouse)とELクライアント(geth)を持つローカルイーサリアムテストネットをDocker経由でインスタンス化しました。

レビュー

このセクションでは、KurtosisにGitHubでリモートホストされているeth-network-package (opens in a new tab)を使用して、Kurtosis Enclave (opens in a new tab)内にローカルイーサリアムテストネットを起動するよう指示するコマンドを実行しました。エンクレーブ内には、「ファイルアーティファクト」と「ユーザーサービス」の両方があります。

エンクレーブ内のファイルアーティファクト (opens in a new tab)には、ELおよびCLクライアントをブートストラップするために生成および利用されたすべてのデータが含まれます。データは、このDockerイメージ (opens in a new tab)から構築された prelaunch-data-generator サービスを使用して作成されました。

ユーザーサービスには、エンクレーブで動作しているすべてのコンテナ化されたサービスが表示されます。 ELクライアントとCLクライアントの両方を備えた単一のノードが作成されていることがわかります。

dApp開発環境をローカルイーサリアムテストネットに接続する

dApp開発環境のセットアップ

実行中のローカルテストネットができたので、dApp開発環境を接続してローカルテストネットを使用できます。このガイドでは、Hardhatフレームワークを使用して、ブラックジャックdAppをローカルテストネットにデプロイします。

dApp開発環境をセットアップするには、サンプルdAppを含むリポジトリをクローンし、その依存関係をインストールして、次を実行します。

1git clone https://github.com/kurtosis-tech/awesome-kurtosis.git && cd awesome-kurtosis/smart-contract-example && yarn

ここで使用するsmart-contract-example (opens in a new tab)フォルダには、Hardhat (opens in a new tab)フレームワークを使用するdApp開発者のための一般的なセットアップが含まれています。

contracts/ (opens in a new tab) には、Blackjack dApp用のいくつかのシンプルなスマートコントラクトが含まれています
scripts/ (opens in a new tab) には、ローカルのイーサリアムネットワークにトークンコントラクトをデプロイするためのスクリプトが含まれています
test/ (opens in a new tab) には、Blackjack dAppの各プレイヤーに1000がミントされていることを確認するための、トークンコントラクト用の簡単な .js テストが含まれています
hardhat.config.ts (opens in a new tab) はHardhatセットアップを構成します

Hardhatがローカルテストネットを使用するように設定する

dApp開発環境がセットアップされたので、今度はHardhatを接続して、Kurtosisを使用して生成されたローカルイーサリアムテストネットを使用します。これを実現するには、hardhat.config.ts設定ファイルのlocalnet構造体にある<$YOUR_PORT>を、任意のel-client-<num>サービスから出力されたrpc uriのポートに置き換えます。このサンプルケースでは、ポートは64248になります。ポートは異なります。

hardhat.config.tsでの例:

1localnet: {
2url: 'http://127.0.0.1:<$YOUR_PORT>',// TODO: $YOUR_PORTを、ETH NETWORK KURTOSIS PACKAGEによって生成されたノードURIのポートに置き換えてください
3
4// これらはeth-network-packageによって作成された、事前に入金済みのテストアカウントに関連付けられた秘密鍵です
5// <https://github.com/kurtosis-tech/eth-network-package/blob/main/src/prelaunch_data_generator/genesis_constants/genesis_constants.star>
6accounts: [
7    "ef5177cd0b6b21c87db5a0bf35d4084a8a57a9d6a064f86d51ac85f2b873a4e2",
8    "48fcc39ae27a0e8bf0274021ae6ebd8fe4a0e12623d61464c498900b28feb567",
9    "7988b3a148716ff800414935b305436493e1f25237a2a03e5eebc343735e2f31",
10    "b3c409b6b0b3aa5e65ab2dc1930534608239a478106acf6f3d9178e9f9b00b35",
11    "df9bb6de5d3dc59595bcaa676397d837ff49441d211878c024eabda2cd067c9f",
12    "7da08f856b5956d40a72968f93396f6acff17193f013e8053f6fbb6c08c194d6",
13  ],
14},
すべて表示

ファイルを保存すると、Hardhat dApp開発環境がローカルイーサリアムテストネットに接続されます。次を実行して、テストネットが機能していることを確認できます。

1npx hardhat balances --network localnet

出力は次のようになります。

10x878705ba3f8Bc32FCf7F4CAa1A35E72AF65CF766 has balance 10000000000000000000000000
20x4E9A3d9D1cd2A2b2371b8b3F489aE72259886f1A has balance 10000000000000000000000000
30xdF8466f277964Bb7a0FFD819403302C34DCD530A has balance 10000000000000000000000000
40x5c613e39Fc0Ad91AfDA24587e6f52192d75FBA50 has balance 10000000000000000000000000
50x375ae6107f8cC4cF34842B71C6F746a362Ad8EAc has balance 10000000000000000000000000
60x1F6298457C5d76270325B724Da5d1953923a6B88 has balance 10000000000000000000000000

これにより、Hardhatがローカルテストネットを使用しており、eth-network-packageによって作成された事前に入金されたアカウントを検出していることが確認できます。

dAppをローカルでデプロイしてテストする

dApp開発環境がローカルイーサリアムテストネットに完全に接続されたので、ローカルテストネットを使用してdAppに対する開発およびテストワークフローを実行できます。

ローカルでのプロトタイピングと開発のためにChipToken.solスマートコントラクトをコンパイルしてデプロイするには、次を実行します。

1npx hardhat compile
2npx hardhat run scripts/deploy.ts --network localnet

出力は次のようになります。

1ChipTokenのデプロイ先: 0xAb2A01BC351770D09611Ac80f1DE076D56E0487d

次に、ローカルdAppに対してsimple.jsテストを実行し、Blackjack dAppの各プレイヤーに1000がミントされていることを確認します。

出力は次のようになります。

1npx hardhat test --network localnet

出力は次のようになります。

1ChipToken
2    mint
3      ✔ PLAYER ONEに1000チップがミントされるべき
4
5  1件合格 (654ms)

レビュー

この時点で、dApp開発環境をセットアップし、Kurtosisによって作成されたローカルイーサリアムネットワークに接続し、dAppに対してコンパイル、デプロイ、および簡単なテストを実行しました。

次に、さまざまなネットワーク構成でdAppをテストするために、基盤となるネットワークをどのように構成できるかを見ていきましょう。

ローカルイーサリアムテストネットの設定

クライアント構成とノード数の変更

ローカルイーサリアムテストネットは、開発またはテストしたいシナリオや特定のネットワーク構成に応じて、異なるELおよびCLクライアントペア、ならびにさまざまな数のノードを使用するように構成できます。これは、一度セットアップすれば、カスタマイズされたローカルテストネットを起動し、それを使用して同じワークフロー(デプロイ、テストなど)を実行できることを意味します。さまざまなネットワーク構成の下で、すべてが期待どおりに機能することを確認します。変更できる他のパラメータの詳細については、このリンクをご覧ください。

試してみましょう。 JSONファイルを介して、さまざまな構成オプションを eth-network-package に渡すことができます。このネットワークパラメータJSONファイルは、Kurtosisがローカルイーサリアムネットワークをセットアップするために使用する特定の設定を提供します。

デフォルトの設定ファイルを取得し、それを編集して、異なるEL/CLペアを持つ2つのノードを起動します。

ノード1：geth/lighthouse
ノード2：geth/lodestar
ノード3：geth/teku

この構成により、dAppをテストするためのイーサリアムノード実装の異種ネットワークが作成されます。設定ファイルは次のようになります。

1{
2  "participants":
3    [
4      {
5        "el_client_type": "geth",
6        "el_client_image": "",
7        "el_client_log_level": "",
8        "cl_client_type": "lighthouse",
9        "cl_client_image": "",
10        "cl_client_log_level": "",
11        "beacon_extra_params": [],
12        "el_extra_params": [],
13        "validator_extra_params": [],
14        "builder_network_params": null,
15      },
16      {
17        "el_client_type": "geth",
18        "el_client_image": "",
19        "el_client_log_level": "",
20        "cl_client_type": "lodestar",
21        "cl_client_image": "",
22        "cl_client_log_level": "",
23        "beacon_extra_params": [],
24        "el_extra_params": [],
25        "validator_extra_params": [],
26        "builder_network_params": null,
27      },
28      {
29        "el_client_type": "geth",
30        "el_client_image": "",
31        "el_client_log_level": "",
32        "cl_client_type": "teku",
33        "cl_client_image": "",
34        "cl_client_log_level": "",
35        "beacon_extra_params": [],
36        "el_extra_params": [],
37        "validator_extra_params": [],
38        "builder_network_params": null,
39      },
40    ],
41  "network_params":
42    {
43      "preregistered_validator_keys_mnemonic": "giant issue aisle success illegal bike spike question tent bar rely arctic volcano long crawl hungry vocal artwork sniff fantasy very lucky have athlete",
44      "num_validator_keys_per_node": 64,
45      "network_id": "3151908",
46      "deposit_contract_address": "0x4242424242424242424242424242424242424242",
47      "seconds_per_slot": 12,
48      "genesis_delay": 120,
49      "capella_fork_epoch": 5,
50    },
51}
すべて表示

各participants構造体はネットワーク内のノードにマッピングされるため、3つのparticipants構造体はKurtosisにネットワーク内で3つのノードを起動するように指示します。各participants構造体では、その特定のノードに使用されるELとCLのペアを指定できます。

network_params構造体は、各ノードのジェネシスファイルを作成するために使用されるネットワーク設定や、ネットワークのスロットごとの秒数などの他の設定を構成します。

編集したパラメータファイルを任意のディレクトリに保存し(以下の例ではデスクトップに保存)、次を実行してKurtosisパッケージを実行します。

1kurtosis clean -a && kurtosis run --enclave local-eth-testnet github.com/kurtosis-tech/eth-network-package "$(cat ~/eth-network-params.json)"

注: ここでは、kurtosis clean -aコマンドを使用して、新しいテストネットを開始する前に古いテストネットとその内容を破棄するようにKurtosisに指示します。

再び、Kurtosisは少しの間動作し、実行されている個々のステップを出力します。最終的に、出力は次のようになります。

1Starlark code successfully run. No output was returned.
2INFO[2023-04-07T11:43:16-04:00] ==========================================================
3INFO[2023-04-07T11:43:16-04:00] ||          Created enclave: local-eth-testnet          ||
4INFO[2023-04-07T11:43:16-04:00] ==========================================================
5Name:            local-eth-testnet
6UUID:            bef8c192008e
7Status:          RUNNING
8Creation Time:   Fri, 07 Apr 2023 11:41:58 EDT
9
10========================================= Files Artifacts =========================================
11UUID           Name
12cc495a8e364a   cl-genesis-data
137033fcdb5471   el-genesis-data
14a3aef43fc738   genesis-generation-config-cl
158e968005fc9d   genesis-generation-config-el
163182cca9d3cd   geth-prefunded-keys
178421166e234f   prysm-password
18d9e6e8d44d99   validator-keystore-0
1923f5ba517394   validator-keystore-1
204d28dea40b5c   validator-keystore-2
21
22========================================== User Services ==========================================
23UUID           Name                                           Ports                                            Status
24485e6fde55ae   cl-client-0-beacon                             http: 4000/tcp -> http://127.0.0.1:65010         RUNNING
25                                                              metrics: 5054/tcp -> http://127.0.0.1:65011
26                                                              tcp-discovery: 9000/tcp -> 127.0.0.1:65012
27                                                              udp-discovery: 9000/udp -> 127.0.0.1:54455
2873739bd158b2   cl-client-0-validator                          http: 5042/tcp -> 127.0.0.1:65016                RUNNING
29                                                              metrics: 5064/tcp -> http://127.0.0.1:65017
301b0a233cd011   cl-client-1-beacon                             http: 4000/tcp -> 127.0.0.1:65021                RUNNING
31                                                              metrics: 8008/tcp -> 127.0.0.1:65023
32                                                              tcp-discovery: 9000/tcp -> 127.0.0.1:65024
33                                                              udp-discovery: 9000/udp -> 127.0.0.1:56031
34                                                              validator-metrics: 5064/tcp -> 127.0.0.1:65022
35949b8220cd53   cl-client-1-validator                          http: 4000/tcp -> 127.0.0.1:65028                RUNNING
36                                                              metrics: 8008/tcp -> 127.0.0.1:65030
37                                                              tcp-discovery: 9000/tcp -> 127.0.0.1:65031
38                                                              udp-discovery: 9000/udp -> 127.0.0.1:60784
39                                                              validator-metrics: 5064/tcp -> 127.0.0.1:65029
40c34417bea5fa   cl-client-2                                    http: 4000/tcp -> 127.0.0.1:65037                RUNNING
41                                                              metrics: 8008/tcp -> 127.0.0.1:65035
42                                                              tcp-discovery: 9000/tcp -> 127.0.0.1:65036
43                                                              udp-discovery: 9000/udp -> 127.0.0.1:63581
44e19738e6329d   el-client-0                                    engine-rpc: 8551/tcp -> 127.0.0.1:64986          RUNNING
45                                                              rpc: 8545/tcp -> 127.0.0.1:64988
46                                                              tcp-discovery: 30303/tcp -> 127.0.0.1:64987
47                                                              udp-discovery: 30303/udp -> 127.0.0.1:55706
48                                                              ws: 8546/tcp -> 127.0.0.1:64989
49e904687449d9   el-client-1                                    engine-rpc: 8551/tcp -> 127.0.0.1:64993          RUNNING
50                                                              rpc: 8545/tcp -> 127.0.0.1:64995
51                                                              tcp-discovery: 30303/tcp -> 127.0.0.1:64994
52                                                              udp-discovery: 30303/udp -> 127.0.0.1:58096
53                                                              ws: 8546/tcp -> 127.0.0.1:64996
54ad6f401126fa   el-client-2                                    engine-rpc: 8551/tcp -> 127.0.0.1:65003          RUNNING
55                                                              rpc: 8545/tcp -> 127.0.0.1:65001
56                                                              tcp-discovery: 30303/tcp -> 127.0.0.1:65000
57                                                              udp-discovery: 30303/udp -> 127.0.0.1:57269
58                                                              ws: 8546/tcp -> 127.0.0.1:65002
5912d04a9dbb69   prelaunch-data-generator-1680882122181135513   <none>                                           STOPPED
605b45f9c0504b   prelaunch-data-generator-1680882122192182847   <none>                                           STOPPED
613d4aaa75e218   prelaunch-data-generator-1680882122201668972   <none>                                           STOPPED
すべて表示

おめでとうございます！ローカルテストネットを1つではなく3つのノードを持つように正常に設定しました。 dAppに対して以前と同じワークフロー(デプロイ＆テスト)を実行するには、新しい3ノードのローカルテストネットのel-client-<num>サービスから出力されたrpc uriのポートで、hardhat.config.ts構成ファイルのlocalnet構造体にある<$YOUR_PORT>を置き換えることで、以前と同じ操作を実行します。

結論

完成です！この短いガイドを要約すると、次のことを行いました。

Kurtosisを使用してDocker上にローカルイーサリアムテストネットを作成
ローカルdApp開発環境をローカルイーサリアムネットワークに接続
dAppをデプロイし、ローカルイーサリアムネットワーク上で簡単なテストを実行
基盤となるイーサリアムネットワークを3つのノードを持つように構成

何がうまくいったか、何を改善できるか、また質問への回答など、ご意見をお聞かせください。 GitHub (opens in a new tab)またはメール (opens email client)でお気軽にご連絡ください。

その他の例とガイド

クイックスタート (opens in a new tab)(PostgresデータベースとAPIを構築します)や、awesome-kurtosisリポジトリ (opens in a new tab)にあるその他の例を確認することをお勧めします。そこには、次のようなパッケージを含む素晴らしい例があります。

同じローカルイーサリアムテストネットを起動 (opens in a new tab)しますが、トランザクションスパマー(トランザクションをシミュレートするため)、フォークモニター、接続されたGrafanaおよびPrometheusインスタンスなどの追加サービスも接続します
同じローカルイーサリアムネットワークに対してサブネットワーキングテスト (opens in a new tab)を実行する

最終更新： 2025年9月23日

ローカルのマルチクライアントテストネットでdAppを開発・テストする方法

はじめに

Kurtosisとは？

Kurtosisのセットアップ

ローカルイーサリアムテストネットのインスタンス化

レビュー

dApp開発環境をローカルイーサリアムテストネットに接続する

dApp開発環境のセットアップ

Hardhatがローカルテストネットを使用するように設定する

dAppをローカルでデプロイしてテストする

レビュー

ローカルイーサリアムテストネットの設定

クライアント構成とノード数の変更

結論

その他の例とガイド

このチュートリアルは役に立ちましたか?