Come sviluppare e testare una dapp su una testnet locale multi-client
Introduzione
Questa guida ti accompagna nel processo di istanziazione di una testnet Ethereum locale configurabile, nella distribuzione di uno smart contract su di essa e nell'utilizzo della testnet per eseguire test sulla tua applicazione decentralizzata (dapp). Questa guida è pensata per gli sviluppatori di dapp che desiderano sviluppare e testare le proprie dapp localmente su diverse configurazioni di rete prima di distribuirle su una testnet pubblica o sulla Mainnet.
In questa guida:
- Istanzierai una testnet Ethereum locale con
eth-network-package(opens in a new tab) utilizzando Kurtosis (opens in a new tab), - Connetterai il tuo ambiente di sviluppo per dapp Hardhat alla testnet locale per compilare, distribuire e testare una dapp, e
- Configurerai la testnet locale, inclusi parametri come il numero di nodi e gli abbinamenti specifici di client EL/CL, per abilitare i flussi di lavoro di sviluppo e test su varie configurazioni di rete.
Cos'è Kurtosis?
Kurtosis (opens in a new tab) è un sistema di build componibile progettato per configurare ambienti di test multi-container. Consente specificamente agli sviluppatori di creare ambienti riproducibili che richiedono una logica di configurazione dinamica, come le testnet blockchain.
In questa guida, il pacchetto eth-network-package di Kurtosis avvia una testnet Ethereum locale con supporto per il client del livello di esecuzione (EL) geth (opens in a new tab), oltre ai client del livello di consenso (CL) teku (opens in a new tab), lighthouse (opens in a new tab) e lodestar (opens in a new tab). Questo pacchetto funge da alternativa configurabile e componibile alle reti in framework come Hardhat Network, Ganache e Anvil. Kurtosis offre agli sviluppatori un maggiore controllo e flessibilità sulle testnet che utilizzano, il che è uno dei motivi principali per cui la Ethereum Foundation ha utilizzato Kurtosis per testare The Merge (opens in a new tab) e continua a utilizzarlo per testare gli aggiornamenti della rete.
Configurazione di Kurtosis
Prima di procedere, assicurati di aver:
- Installato e avviato il motore Docker (opens in a new tab) sulla tua macchina locale
- Installato la CLI di Kurtosis (opens in a new tab) (o aggiornata all'ultima versione, se hai già installato la CLI)
- Installato Node.js (opens in a new tab), yarn (opens in a new tab) e npx (opens in a new tab) (per il tuo ambiente dapp)
Istanziare una testnet Ethereum locale
Per avviare una testnet Ethereum locale, esegui:
kurtosis --enclave local-eth-testnet run github.com/kurtosis-tech/eth-network-package
Nota: questo comando nomina la tua rete: "local-eth-testnet” utilizzando il flag --enclave.
Kurtosis stamperà i passaggi che sta eseguendo internamente mentre lavora per interpretare, convalidare e quindi eseguire le istruzioni. Alla fine, dovresti vedere un output simile al seguente:
INFO[2023-04-04T18:09:44-04:00] ======================================================
INFO[2023-04-04T18:09:44-04:00] || Created enclave: local-eth-testnet ||
INFO[2023-04-04T18:09:44-04:00] ======================================================
Name: local-eth-testnet
UUID: 39372d756ae8
Status: RUNNING
Creation Time: Tue, 04 Apr 2023 18:09:03 EDT
========================================= Files Artifacts =========================================
UUID Name
d4085a064230 cl-genesis-data
1c62cb792e4c el-genesis-data
bd60489b73a7 genesis-generation-config-cl
b2e593fe5228 genesis-generation-config-el
d552a54acf78 geth-prefunded-keys
5f7e661eb838 prysm-password
054e7338bb59 validator-keystore-0
========================================== User Services ==========================================
UUID Name Ports Status
e20f129ee0c5 cl-client-0-beacon http: 4000/tcp -> <http://127.0.0.1:54261> RUNNING
metrics: 5054/tcp -> <http://127.0.0.1:54262>
tcp-discovery: 9000/tcp -> 127.0.0.1:54263
udp-discovery: 9000/udp -> 127.0.0.1:60470
a8b6c926cdb4 cl-client-0-validator http: 5042/tcp -> 127.0.0.1:54267 RUNNING
metrics: 5064/tcp -> <http://127.0.0.1:54268>
d7b802f623e8 el-client-0 engine-rpc: 8551/tcp -> 127.0.0.1:54253 RUNNING
rpc: 8545/tcp -> 127.0.0.1:54251
tcp-discovery: 30303/tcp -> 127.0.0.1:54254
udp-discovery: 30303/udp -> 127.0.0.1:53834
ws: 8546/tcp -> 127.0.0.1:54252
514a829c0a84 prelaunch-data-generator-1680646157905431468 <none> STOPPED
62bd62d0aa7a prelaunch-data-generator-1680646157915424301 <none> STOPPED
05e9619e0e90 prelaunch-data-generator-1680646157922872635 <none> STOPPED
Congratulazioni! Hai utilizzato Kurtosis per istanziare una testnet Ethereum locale, con un client CL (lighthouse) e un client EL (geth), su Docker.
Riepilogo
In questa sezione, hai eseguito un comando che ha indicato a Kurtosis di utilizzare il pacchetto eth-network-package ospitato in remoto su GitHub (opens in a new tab) per avviare una testnet Ethereum locale all'interno di un'Enclave (opens in a new tab) di Kurtosis. All'interno della tua enclave, troverai sia "artefatti di file" che "servizi utente".
Gli Artefatti di file (opens in a new tab) nella tua enclave includono tutti i dati generati e utilizzati per avviare i client EL e CL. I dati sono stati creati utilizzando il servizio prelaunch-data-generator compilato da questa immagine Docker (opens in a new tab)
I servizi utente mostrano tutti i servizi containerizzati operativi nella tua enclave. Noterai che è stato creato un singolo nodo, che presenta sia un client EL che un client CL.
Connettere l'ambiente di sviluppo della dapp alla testnet Ethereum locale
Configurare l'ambiente di sviluppo della dapp
Ora che hai una testnet locale in esecuzione, puoi connettere il tuo ambiente di sviluppo per dapp per utilizzare la tua testnet locale. In questa guida verrà utilizzato il framework Hardhat per distribuire una dapp di blackjack sulla tua testnet locale.
Per configurare il tuo ambiente di sviluppo per dapp, clona il repository che contiene la nostra dapp di esempio e installa le sue dipendenze, esegui:
git clone https://github.com/kurtosis-tech/awesome-kurtosis.git && cd awesome-kurtosis/smart-contract-example && yarn
La cartella smart-contract-example (opens in a new tab) utilizzata qui contiene la configurazione tipica per uno sviluppatore di dapp che utilizza il framework Hardhat (opens in a new tab):
contracts/(opens in a new tab) contiene alcuni semplici smart contract per una dapp di Blackjackscripts/(opens in a new tab) contiene uno script per distribuire un contratto di token sulla tua rete Ethereum localetest/(opens in a new tab) contiene un semplice test .js per il tuo contratto di token per confermare che ogni giocatore nella nostra dapp di Blackjack abbia 1000 token coniati per séhardhat.config.ts(opens in a new tab) configura la tua installazione di Hardhat
Configurare Hardhat per utilizzare la testnet locale
Con il tuo ambiente di sviluppo per dapp configurato, ora connetterai Hardhat per utilizzare la testnet Ethereum locale generata utilizzando Kurtosis. Per farlo, sostituisci <$YOUR_PORT> nella struttura localnet nel tuo file di configurazione hardhat.config.ts con la porta dell'URI RPC in output da qualsiasi servizio el-client-<num>. In questo caso di esempio, la porta sarebbe 64248. La tua porta sarà diversa.
Esempio in hardhat.config.ts:
localnet: {
url: 'http://127.0.0.1:<$YOUR_PORT>',// TODO: SOSTITUISCI $YOUR_PORT CON LA PORTA DI UN URI DEL NODO PRODOTTO DAL PACCHETTO KURTOSIS DELLA RETE ETH
// Queste sono chiavi private associate ad account di test prefinanziati creati dall'eth-network-package
// <https://github.com/kurtosis-tech/eth-network-package/blob/main/src/prelaunch_data_generator/genesis_constants/genesis_constants.star>
accounts: [
"ef5177cd0b6b21c87db5a0bf35d4084a8a57a9d6a064f86d51ac85f2b873a4e2",
"48fcc39ae27a0e8bf0274021ae6ebd8fe4a0e12623d61464c498900b28feb567",
"7988b3a148716ff800414935b305436493e1f25237a2a03e5eebc343735e2f31",
"b3c409b6b0b3aa5e65ab2dc1930534608239a478106acf6f3d9178e9f9b00b35",
"df9bb6de5d3dc59595bcaa676397d837ff49441d211878c024eabda2cd067c9f",
"7da08f856b5956d40a72968f93396f6acff17193f013e8053f6fbb6c08c194d6",
],
},
Una volta salvato il file, il tuo ambiente di sviluppo per dapp Hardhat è ora connesso alla tua testnet Ethereum locale! Puoi verificare che la tua testnet funzioni eseguendo:
npx hardhat balances --network localnet
L'output dovrebbe essere simile a questo:
0x878705ba3f8Bc32FCf7F4CAa1A35E72AF65CF766 has balance 10000000000000000000000000
0x4E9A3d9D1cd2A2b2371b8b3F489aE72259886f1A has balance 10000000000000000000000000
0xdF8466f277964Bb7a0FFD819403302C34DCD530A has balance 10000000000000000000000000
0x5c613e39Fc0Ad91AfDA24587e6f52192d75FBA50 has balance 10000000000000000000000000
0x375ae6107f8cC4cF34842B71C6F746a362Ad8EAc has balance 10000000000000000000000000
0x1F6298457C5d76270325B724Da5d1953923a6B88 has balance 10000000000000000000000000
Questo conferma che Hardhat sta utilizzando la tua testnet locale e rileva gli account prefinanziati creati da eth-network-package.
Distribuire e testare la tua dapp localmente
Con l'ambiente di sviluppo per dapp completamente connesso alla testnet Ethereum locale, ora puoi eseguire flussi di lavoro di sviluppo e test sulla tua dapp utilizzando la testnet locale.
Per compilare e distribuire lo smart contract ChipToken.sol per la prototipazione e lo sviluppo locale, esegui:
npx hardhat compile
npx hardhat run scripts/deploy.ts --network localnet
L'output dovrebbe essere simile a:
ChipToken deployed to: 0xAb2A01BC351770D09611Ac80f1DE076D56E0487d
Ora prova a eseguire il test simple.js sulla tua dapp locale per confermare che ogni giocatore nella nostra dapp di Blackjack abbia 1000 token coniati per sé:
L'output dovrebbe essere simile a questo:
npx hardhat test --network localnet
L'output dovrebbe essere simile a questo:
ChipToken
mint
✔ should mint 1000 chips for PLAYER ONE
1 passing (654ms)
Riepilogo
A questo punto, hai configurato un ambiente di sviluppo per dapp, lo hai connesso a una rete Ethereum locale creata da Kurtosis e hai compilato, distribuito ed eseguito un semplice test sulla tua dapp.
Ora esploriamo come puoi configurare la rete sottostante per testare le nostre dapp in diverse configurazioni di rete.
Configurare la testnet Ethereum locale
Modificare le configurazioni dei client e il numero di nodi
La tua testnet Ethereum locale può essere configurata per utilizzare diverse coppie di client EL e CL, oltre a un numero variabile di nodi, a seconda dello scenario e della configurazione di rete specifica che desideri sviluppare o testare. Ciò significa che, una volta configurata, puoi avviare una testnet locale personalizzata e utilizzarla per eseguire gli stessi flussi di lavoro (distribuzione, test, ecc.) in varie configurazioni di rete per assicurarti che tutto funzioni come previsto. Per saperne di più sugli altri parametri che puoi modificare, visita questo link.
Fai una prova! Puoi passare varie opzioni di configurazione a eth-network-package tramite un file JSON. Questo file JSON dei parametri di rete fornisce le configurazioni specifiche che Kurtosis utilizzerà per configurare la rete Ethereum locale.
Prendi il file di configurazione predefinito e modificalo per avviare due nodi con diverse coppie EL/CL:
- Nodo 1 con
geth/lighthouse - Nodo 2 con
geth/lodestar - Nodo 3 con
geth/teku
Questa configurazione crea una rete eterogenea di implementazioni di nodi Ethereum per testare la tua dapp. Il tuo file di configurazione dovrebbe ora apparire così:
{
"participants":
[
{
"el_client_type": "geth",
"el_client_image": "",
"el_client_log_level": "",
"cl_client_type": "lighthouse",
"cl_client_image": "",
"cl_client_log_level": "",
"beacon_extra_params": [],
"el_extra_params": [],
"validator_extra_params": [],
"builder_network_params": null,
},
{
"el_client_type": "geth",
"el_client_image": "",
"el_client_log_level": "",
"cl_client_type": "lodestar",
"cl_client_image": "",
"cl_client_log_level": "",
"beacon_extra_params": [],
"el_extra_params": [],
"validator_extra_params": [],
"builder_network_params": null,
},
{
"el_client_type": "geth",
"el_client_image": "",
"el_client_log_level": "",
"cl_client_type": "teku",
"cl_client_image": "",
"cl_client_log_level": "",
"beacon_extra_params": [],
"el_extra_params": [],
"validator_extra_params": [],
"builder_network_params": null,
},
],
"network_params":
{
"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",
"num_validator_keys_per_node": 64,
"network_id": "3151908",
"deposit_contract_address": "0x4242424242424242424242424242424242424242",
"seconds_per_slot": 12,
"genesis_delay": 120,
"capella_fork_epoch": 5,
},
}
Ogni struttura participants è mappata a un nodo nella rete, quindi 3 strutture participants indicheranno a Kurtosis di avviare 3 nodi nella tua rete. Ogni struttura participants ti consentirà di specificare la coppia EL e CL utilizzata per quel nodo specifico.
La struttura network_params configura le impostazioni di rete che vengono utilizzate per creare i file di genesi per ogni nodo, oltre ad altre impostazioni come i secondi per slot della rete.
Salva il file dei parametri modificato in qualsiasi directory desideri (nell'esempio seguente, è salvato sul desktop) e quindi utilizzalo per eseguire il tuo pacchetto Kurtosis eseguendo:
kurtosis clean -a && kurtosis run --enclave local-eth-testnet github.com/kurtosis-tech/eth-network-package "$(cat ~/eth-network-params.json)"
Nota: il comando kurtosis clean -a viene utilizzato qui per indicare a Kurtosis di distruggere la vecchia testnet e i suoi contenuti prima di avviarne una nuova.
Ancora una volta, Kurtosis lavorerà per un po' e stamperà i singoli passaggi in corso. Alla fine, l'output dovrebbe essere simile a:
Starlark code successfully run. No output was returned.
INFO[2023-04-07T11:43:16-04:00] ==========================================================
INFO[2023-04-07T11:43:16-04:00] || Created enclave: local-eth-testnet ||
INFO[2023-04-07T11:43:16-04:00] ==========================================================
Name: local-eth-testnet
UUID: bef8c192008e
Status: RUNNING
Creation Time: Fri, 07 Apr 2023 11:41:58 EDT
========================================= Files Artifacts =========================================
UUID Name
cc495a8e364a cl-genesis-data
7033fcdb5471 el-genesis-data
a3aef43fc738 genesis-generation-config-cl
8e968005fc9d genesis-generation-config-el
3182cca9d3cd geth-prefunded-keys
8421166e234f prysm-password
d9e6e8d44d99 validator-keystore-0
23f5ba517394 validator-keystore-1
4d28dea40b5c validator-keystore-2
========================================== User Services ==========================================
UUID Name Ports Status
485e6fde55ae cl-client-0-beacon http: 4000/tcp -> http://127.0.0.1:65010 RUNNING
metrics: 5054/tcp -> http://127.0.0.1:65011
tcp-discovery: 9000/tcp -> 127.0.0.1:65012
udp-discovery: 9000/udp -> 127.0.0.1:54455
73739bd158b2 cl-client-0-validator http: 5042/tcp -> 127.0.0.1:65016 RUNNING
metrics: 5064/tcp -> http://127.0.0.1:65017
1b0a233cd011 cl-client-1-beacon http: 4000/tcp -> 127.0.0.1:65021 RUNNING
metrics: 8008/tcp -> 127.0.0.1:65023
tcp-discovery: 9000/tcp -> 127.0.0.1:65024
udp-discovery: 9000/udp -> 127.0.0.1:56031
validator-metrics: 5064/tcp -> 127.0.0.1:65022
949b8220cd53 cl-client-1-validator http: 4000/tcp -> 127.0.0.1:65028 RUNNING
metrics: 8008/tcp -> 127.0.0.1:65030
tcp-discovery: 9000/tcp -> 127.0.0.1:65031
udp-discovery: 9000/udp -> 127.0.0.1:60784
validator-metrics: 5064/tcp -> 127.0.0.1:65029
c34417bea5fa cl-client-2 http: 4000/tcp -> 127.0.0.1:65037 RUNNING
metrics: 8008/tcp -> 127.0.0.1:65035
tcp-discovery: 9000/tcp -> 127.0.0.1:65036
udp-discovery: 9000/udp -> 127.0.0.1:63581
e19738e6329d el-client-0 engine-rpc: 8551/tcp -> 127.0.0.1:64986 RUNNING
rpc: 8545/tcp -> 127.0.0.1:64988
tcp-discovery: 30303/tcp -> 127.0.0.1:64987
udp-discovery: 30303/udp -> 127.0.0.1:55706
ws: 8546/tcp -> 127.0.0.1:64989
e904687449d9 el-client-1 engine-rpc: 8551/tcp -> 127.0.0.1:64993 RUNNING
rpc: 8545/tcp -> 127.0.0.1:64995
tcp-discovery: 30303/tcp -> 127.0.0.1:64994
udp-discovery: 30303/udp -> 127.0.0.1:58096
ws: 8546/tcp -> 127.0.0.1:64996
ad6f401126fa el-client-2 engine-rpc: 8551/tcp -> 127.0.0.1:65003 RUNNING
rpc: 8545/tcp -> 127.0.0.1:65001
tcp-discovery: 30303/tcp -> 127.0.0.1:65000
udp-discovery: 30303/udp -> 127.0.0.1:57269
ws: 8546/tcp -> 127.0.0.1:65002
12d04a9dbb69 prelaunch-data-generator-1680882122181135513 <none> STOPPED
5b45f9c0504b prelaunch-data-generator-1680882122192182847 <none> STOPPED
3d4aaa75e218 prelaunch-data-generator-1680882122201668972 <none> STOPPED
Congratulazioni! Hai configurato con successo la tua testnet locale per avere 3 nodi invece di 1. Per eseguire gli stessi flussi di lavoro di prima sulla tua dapp (distribuzione e test), esegui le stesse operazioni di prima sostituendo <$YOUR_PORT> nella struttura localnet nel tuo file di configurazione hardhat.config.ts con la porta dell'URI RPC in output da qualsiasi servizio el-client-<num> nella tua nuova testnet locale a 3 nodi.
Conclusione
E questo è tutto! Per riassumere questa breve guida, hai:
- Creato una testnet Ethereum locale su Docker utilizzando Kurtosis
- Connesso il tuo ambiente di sviluppo per dapp locale alla rete Ethereum locale
- Distribuito una dapp ed eseguito un semplice test su di essa sulla rete Ethereum locale
- Configurato la rete Ethereum sottostante per avere 3 nodi
Ci piacerebbe sapere da te cosa è andato bene, cosa potrebbe essere migliorato o rispondere a qualsiasi tua domanda. Non esitare a contattarci tramite GitHub (opens in a new tab) o inviaci un'e-mail (opens email client)!
Altri esempi e guide
Ti invitiamo a dare un'occhiata alla nostra guida rapida (opens in a new tab) (dove costruirai un database Postgres e un'API su di esso) e agli altri nostri esempi nel nostro repository awesome-kurtosis (opens in a new tab) dove troverai alcuni ottimi esempi, inclusi pacchetti per:
- Avviare la stessa testnet Ethereum locale (opens in a new tab), ma con servizi aggiuntivi connessi come uno spammer di transazioni (per simulare transazioni), un monitor di fork e un'istanza Grafana e Prometheus connessa
- Eseguire un test di sottorete (opens in a new tab) sulla stessa rete Ethereum locale
Ultimo aggiornamento della pagina: 3 marzo 2026
