Перейти до основного контенту

Як розробляти та тестувати dApp у локальній багатоклієнтській тестовій мережі

клієнти
вузли
Смарт-контракти
композиційність
шар консенсусу
шар виконання
тестування
Середнячок
Tedi Mitiku
11 квітня 2023 р.
10 читається за хвилину

Вступ

У цьому посібнику описано процес інстанціювання настроюваної локальної тестової мережі Ethereum, розгортання в ній смарт-контракту та використання цієї тестової мережі для запуску тестів вашого dApp. Цей посібник призначений для розробників dApp, які хочуть розробляти та тестувати свої dApp локально в різних конфігураціях мережі перед розгортанням у діючій тестовій мережі або в основній мережі.

У цьому посібнику ви:

  • Інстанціювати локальну тестову мережу Ethereum за допомогою eth-network-package (opens in a new tab) з використанням Kurtosis (opens in a new tab),
  • Підключити середовище розробки dApp Hardhat до локальної тестової мережі для компіляції, розгортання та тестування dApp, та
  • Налаштувати локальну тестову мережу, включно з такими параметрами, як кількість вузлів і конкретні пари клієнтів EL/CL, щоб уможливити робочі процеси розробки та тестування в різних конфігураціях мережі.

Що таке Kurtosis?

Kurtosis (opens in a new tab) — це компонована система збирання, призначена для налаштування багатоконтейнерних тестових середовищ. Вона спеціально дає змогу розробникам створювати відтворювані середовища, які вимагають динамічної логіки налаштування, наприклад тестові мережі блокчейну.

У цьому посібнику пакет Kurtosis eth-network-package розгортає локальну тестову мережу Ethereum з підтримкою клієнта шару виконання (EL) geth (opens in a new tab), а також клієнтів шару консенсусу (CL) teku (opens in a new tab), lighthouse (opens in a new tab) і lodestar (opens in a new tab). Цей пакет слугує настроюваною та компонованою альтернативою мережам у таких фреймворках, як Hardhat Network, Ganache та Anvil. Kurtosis пропонує розробникам більший контроль і гнучкість над тестовими мережами, які вони використовують, що є основною причиною, чому Ethereum Foundation використовував Kurtosis для тестування The Merge (opens in a new tab) і продовжує використовувати його для тестування оновлень мережі.

Налаштування Kurtosis

Перш ніж продовжити, переконайтеся, що у вас є:

Інстанціювання локальної тестової мережі Ethereum

Щоб розгорнути локальну тестову мережу Ethereum, виконайте:

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

Примітка: ця команда дає вашій мережі назву "local-eth-testnet" за допомогою прапора --enclave.

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 для інстанціювання локальної тестової мережі Ethereum із клієнтом CL (lighthouse) і клієнтом EL (geth) через Docker.

Огляд

У цьому розділі ви виконали команду, яка вказала Kurtosis використовувати eth-network-package, розміщений віддалено на GitHub (opens in a new tab), для розгортання локальної тестової мережі Ethereum у анклаві (opens in a new tab) Kurtosis. Усередині вашого анклаву ви знайдете як "артефакти файлів", так і "служби користувачів".

Артефакти файлів (opens in a new tab) у вашому анклаві містять усі дані, створені та використані для початкового завантаження клієнтів EL і CL. Дані були створені за допомогою служби prelaunch-data-generator, зібраної з цього образу Docker (opens in a new tab)

Служби користувачів відображають усі контейнеризовані служби, що працюють у вашому анклаві. Ви помітите, що був створений один вузол, який містить як клієнт EL, так і клієнт CL.

Підключіть своє середовище розробки dApp до локальної тестової мережі Ethereum

Налаштування середовища розробки dApp

Тепер, коли у вас є запущена локальна тестова мережа, ви можете підключити своє середовище розробки dApp для її використання. У цьому посібнику для розгортання dApp для гри в блекджек у вашій локальній тестовій мережі буде використовуватися фреймворк Hardhat.

Щоб налаштувати середовище розробки 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), що використовується тут, містить типове налаштування для розробника dApp, який використовує фреймворк Hardhat (opens in a new tab):

  • contracts/ (opens in a new tab) містить кілька простих смарт-контрактів для dApp для гри в блекджек
  • scripts/ (opens in a new tab) містить скрипт для розгортання контракту токена у вашій локальній мережі Ethereum
  • test/ (opens in a new tab) містить простий тест .js для вашого контракту токена, щоб підтвердити, що для кожного гравця в нашому dApp для гри в блекджек викарбувано 1000 токенів
  • hardhat.config.ts (opens in a new tab) налаштовує ваш Hardhat

Налаштування Hardhat для використання локальної тестової мережі

Після налаштування середовища розробки dApp ви підключите Hardhat до локальної тестової мережі Ethereum, створеної за допомогою Kurtosis. Для цього замініть <$YOUR_PORT> у структурі localnet у вашому файлі конфігурації hardhat.config.ts на порт rpc-uri, виведеного будь-якою службою el-client-<num>. У цьому прикладі порт буде 64248. Ваш порт буде іншим.

Приклад у hardhat.config.ts:

1localnet: {
2url: 'http://127.0.0.1:<$YOUR_PORT>',// TODO: ЗАМІНІТЬ $YOUR_PORT НА ПОРТ URI ВУЗЛА, ЯКИЙ НАДАЄ ПАКЕТ KURTOSIS МЕРЕЖІ ETH
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},

Після збереження файлу ваше середовище розробки dApp Hardhat буде підключено до вашої локальної тестової мережі Ethereum! Ви можете перевірити, чи працює ваша тестова мережа, виконавши команду:

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 повністю підключено до локальної тестової мережі Ethereum, ви можете запускати робочі процеси розробки та тестування вашого dApp, використовуючи локальну тестову мережу.

Щоб скомпілювати та розгорнути смарт-контракт ChipToken.sol для локального прототипування та розробки, виконайте:

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

Вивід має виглядати приблизно так:

1ChipToken розгорнуто за адресою: 0xAb2A01BC351770D09611Ac80f1DE076D56E0487d

Тепер спробуйте запустити тест simple.js для вашого локального dApp, щоб підтвердити, що для кожного гравця в нашому dApp для гри в блекджек викарбувано 1000 токенів:

Результат має виглядати приблизно так:

1npx hardhat test --network localnet

Результат має виглядати приблизно так:

1ChipToken
2    mint
3      ✔ має викарбувати 1000 фішок для ПЕРШОГО ГРАВЦЯ
4

5  1 пройдено (654 мс)

Огляд

На цьому етапі ви налаштували середовище розробки dApp, підключили його до локальної мережі Ethereum, створеної Kurtosis, а також скомпілювали, розгорнули та виконали простий тест для вашого dApp.

Тепер давайте розглянемо, як можна налаштувати базову мережу для тестування наших dApp у різних конфігураціях мережі.

Налаштування локальної тестової мережі Ethereum

Зміна конфігурацій клієнта та кількості вузлів

Вашу локальну тестову мережу Ethereum можна налаштувати на використання різних пар клієнтів EL та CL, а також різної кількості вузлів, залежно від сценарію та конкретної конфігурації мережі, яку ви хочете розробити чи протестувати. Це означає, що після налаштування ви можете розгорнути налаштовану локальну тестову мережу та використовувати її для виконання тих самих робочих процесів (розгортання, тестування тощо) у різних конфігураціях мережі, щоб переконатися, що все працює належним чином. Щоб дізнатися більше про інші параметри, які можна змінити, перейдіть за цим посиланням.

Спробуйте! Ви можете передавати різні параметри конфігурації в eth-network-package через файл JSON. Цей JSON-файл параметрів мережі надає конкретні конфігурації, які Kurtosis використовуватиме для налаштування локальної мережі Ethereum.

Візьміть файл конфігурації за замовчуванням і відредагуйте його, щоб розгорнути два вузли з різними парами EL/CL:

  • Вузол 1 із geth/lighthouse
  • Вузол 2 із geth/lodestar
  • Вузол 3 із geth/teku

Ця конфігурація створює гетерогенну мережу реалізацій вузлів Ethereum для тестування вашого 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

Вітаємо! Ви успішно налаштували свою локальну тестову мережу, щоб вона мала 3 вузли замість 1. Щоб виконати ті самі робочі процеси, що й раніше, для вашого dApp (розгортання та тестування), виконайте ті самі операції, що й раніше, замінивши <$YOUR_PORT> у структурі localnet у вашому файлі конфігурації hardhat.config.ts на порт rpc-uri, виведений будь-якою службою el-client-<num> у вашій новій локальній тестовій мережі з 3 вузлами.

Висновок

І це все! Підсумовуючи цей короткий посібник, ви:

  • Створили локальну тестову мережу Ethereum через Docker за допомогою Kurtosis
  • Підключили своє локальне середовище розробки dApp до локальної мережі Ethereum
  • Розгорнули dApp і виконали простий тест для нього в локальній мережі Ethereum
  • Налаштували базову мережу Ethereum, щоб вона мала 3 вузли

Ми хотіли б почути від вас, що у вас вийшло добре, що можна було б покращити, або відповісти на будь-які ваші запитання. Не соромтеся звертатися до нас через GitHub (opens in a new tab) або напишіть нам (opens email client)!

Інші приклади та посібники

Рекомендуємо ознайомитися з нашим швидким стартом (opens in a new tab) (де ви створите базу даних Postgres та API на її основі) та іншими прикладами в нашому репозиторії awesome-kurtosis (opens in a new tab), де ви знайдете чудові приклади, включно з пакетами для:

  • Розгортання тієї ж локальної тестової мережі Ethereum, але з підключеними додатковими службами, такими як спамер транзакцій (для імітації транзакцій), монітор форків, а також підключені екземпляри Grafana та Prometheus
  • Виконання тесту підмереж (opens in a new tab) для тієї ж локальної мережі Ethereum

Останні оновлення сторінки: 3 березня 2026 р.

myelinated-wackerowm (opens in a new tab)
mdqstm (opens in a new tab)
brossetti1b (opens in a new tab)
+4

Чи була ця інструкція корисною?