Ruka hadi kwenye maudhui makuu

Jinsi ya kuendeleza na kujaribu dApp kwenye testnet ya ndani, yenye wateja wengi

wateja
nodi
mikataba erevu
utunzi
safu ya makubaliano
safu ya utekelezaji
majaribio
Wastani
Tedi Mitiku
11 Aprili 2023
11 soma ndani ya dakika

Utangulizi

Mwongozo huu unakuelekeza katika mchakato wa kuanzisha testnet ya Ethereum ya ndani inayoweza kusanidiwa, kupeleka mkataba-erevu kwayo, na kutumia testnet kufanya majaribio dhidi ya dApp yako. Mwongozo huu umeundwa kwa ajili ya wasanidi programu wa dApp wanaotaka kuendeleza na kujaribu dApps zao ndani dhidi ya usanidi tofauti wa mtandao kabla ya kupeleka kwenye testnet hai au Mtandao Mkuu.

Katika mwongozo huu, utaweza:

  • Anzisha testnet ya Ethereum ya ndani na eth-network-package (opens in a new tab) ukitumia Kurtosis (opens in a new tab),
  • Unganisha mazingira yako ya uendelezaji wa dApp ya Hardhat kwenye testnet ya ndani ili kuandaa, kupeleka, na kujaribu dApp, na
  • Sanidi testnet ya ndani, ikijumuisha vigezo kama idadi ya nodi na jozi maalum za mteja wa EL/CL, ili kuwezesha mtiririko wa kazi wa uendelezaji na upimaji dhidi ya usanidi mbalimbali wa mtandao.

Kurtosis ni nini?

Kurtosis (opens in a new tab) ni mfumo wa ujenzi unaoweza kuunganishwa ulioundwa kwa ajili ya kusanidi mazingira ya majaribio ya makontena mengi. Inawawezesha wasanidi programu kuunda mazingira yanayoweza kurudiwa ambayo yanahitaji mantiki ya usanidi inayobadilika, kama vile testnets za mnyororo wa bloku.

Katika mwongozo huu, kifurushi cha eth-network cha Kurtosis kinawasha testnet ya ndani ya Ethereum inayotumia mteja wa Safu ya Utekelezaji (EL) wa geth (opens in a new tab), pamoja na wateja wa Safu ya Makubaliano (CL) wa teku (opens in a new tab), lighthouse (opens in a new tab), na lodestar (opens in a new tab). Kifurushi hiki kinatumika kama mbadala unaoweza kusanidiwa na kuunganishwa kwa mitandao katika mifumo kama vile Mtandao wa Hardhat, Ganache, na Anvil. Kurtosis huwapa wasanidi programu udhibiti na wepesi zaidi juu ya testnets wanazotumia, ambayo ni sababu kubwa kwa nini Msingi wa Ethereum ulitumia Kurtosis kupima Muungano (opens in a new tab) na unaendelea kuitumia kwa kupima masasisho ya mtandao.

Kusanidi Kurtosis

Kabla ya kuendelea, hakikisha una:

Kuanzisha testnet ya Ethereum ya ndani

Ili kuwasha testnet ya Ethereum ya ndani, endesha:

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

Kumbuka: Amri hii inaupa mtandao wako jina: "local-eth-testnet" kwa kutumia kiashiria cha --enclave.

Kurtosis itachapisha hatua inazochukua chinichini inapofanya kazi ya kufasiri, kuhakiki, na kisha kutekeleza maagizo. Mwishowe, unapaswa kuona matokeo yanayofanana na yafuatayo:

Hongera! Ulitumia Kurtosis kuanzisha testnet ya Ethereum ya ndani, na mteja wa CL (lighthouse) na EL (geth), juu ya Docker.

Mapitio

Katika sehemu hii, ulitekeleza amri iliyoelekeza Kurtosis kutumia eth-network-package iliyohifadhiwa mbali kwenye GitHub (opens in a new tab) kuwasha testnet ya Ethereum ya ndani ndani ya Enclave (opens in a new tab) ya Kurtosis. Ndani ya enclave yako, utapata "file artifacts" na "user services".

Vifaa vya Faili (opens in a new tab) katika enclave yako vinajumuisha data zote zilizozalishwa na kutumika kuanzisha wateja wa EL na CL. Data iliundwa kwa kutumia huduma ya prelaunch-data-generator iliyojengwa kutoka kwa picha hii ya Docker (opens in a new tab)

Huduma za mtumiaji huonyesha huduma zote zilizowekwa kwenye kontena zinazofanya kazi katika enclave yako. Utaona kwamba nodi moja, yenye mteja wa EL na mteja wa CL, imeundwa.

Unganisha mazingira yako ya uendelezaji wa dApp kwenye testnet ya Ethereum ya ndani

Sanidi mazingira ya uendelezaji wa dApp

Sasa kwa kuwa una testnet ya ndani inayofanya kazi, unaweza kuunganisha mazingira yako ya uendelezaji wa dApp ili kutumia testnet yako ya ndani. Mfumo wa Hardhat utatumika katika mwongozo huu kupeleka dApp ya blackjack kwenye testnet yako ya ndani.

Ili kusanidi mazingira yako ya uendelezaji wa dApp, nakili hazina iliyo na sampuli yetu ya dApp na usakinishe vitegemezi vyake, endesha:

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

Folda ya smart-contract-example (opens in a new tab) inayotumiwa hapa ina usanidi wa kawaida kwa msanidi programu wa dApp anayetumia mfumo wa Hardhat (opens in a new tab):

Sanidi Hardhat ili itumie testnet ya ndani

Pamoja na mazingira yako ya uendelezaji wa dApp yakiwa yamesanidiwa, sasa utaunganisha Hardhat ili itumie testnet ya Ethereum ya ndani iliyoundwa kwa kutumia Kurtosis. Ili kufanikisha hili, badilisha <$YOUR_PORT> katika muundo wa localnet katika faili yako ya usanidi ya hardhat.config.ts na bandari ya matokeo ya rpc uri kutoka huduma yoyote ya el-client-<num>. Katika kisa hiki cha sampuli, bandari itakuwa 64248. Bandari yako itakuwa tofauti.

Mfano katika hardhat.config.ts:

Mara tu unapohifadhi faili yako, mazingira yako ya uendelezaji wa dApp ya Hardhat sasa yameunganishwa na testnet yako ya Ethereum ya ndani! Unaweza kuthibitisha kwamba testnet yako inafanya kazi kwa kuendesha:

npx hardhat balances --network localnet

Matokeo yanapaswa kuonekana kama hivi:

0x878705ba3f8Bc32FCf7F4CAa1A35E72AF65CF766 has balance 10000000000000000000000000
0x4E9A3d9D1cd2A2b2371b8b3F489aE72259886f1A has balance 10000000000000000000000000
0xdF8466f277964Bb7a0FFD819403302C34DCD530A has balance 10000000000000000000000000
0x5c613e39Fc0Ad91AfDA24587e6f52192d75FBA50 has balance 10000000000000000000000000
0x375ae6107f8cC4cF34842B71C6F746a362Ad8EAc has balance 10000000000000000000000000
0x1F6298457C5d76270325B724Da5d1953923a6B88 has balance 10000000000000000000000000

Hii inathibitisha kuwa Hardhat inatumia testnet yako ya ndani na inagundua akaunti zilizofadhiliwa awali zilizoundwa na eth-network-package.

Peleka na ujaribu dApp yako ndani

Wakati mazingira ya uendelezaji wa dApp yameunganishwa kikamilifu kwenye testnet ya Ethereum ya ndani, sasa unaweza kuendesha mtiririko wa kazi wa uendelezaji na upimaji dhidi ya dApp yako ukitumia testnet ya ndani.

Ili kuandaa na kupeleka mkataba-erevu wa ChipToken.sol kwa ajili ya uundaji wa mfano wa ndani na uendelezaji, endesha:

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

Matokeo yanapaswa kuonekana kama:

ChipToken imepelekwa kwa: 0xAb2A01BC351770D09611Ac80f1DE076D56E0487d

Sasa jaribu kuendesha jaribio la simple.js dhidi ya dApp yako ya ndani ili kuthibitisha kila mchezaji katika dApp yetu ya Blackjack ametengenezewa 1000:

Matokeo yanapaswa kuonekana kama hivi:

npx hardhat test --network localnet

Matokeo yanapaswa kuonekana kama hivi:

ChipToken
    tengeneza
      ✔ inapaswa kutengeneza chipu 1000 kwa MCHEZAJI MMOJA

  1 imepita (654ms)

Mapitio

Kufikia hapa, sasa umesanidi mazingira ya uendelezaji wa dApp, umeiunganisha kwenye mtandao wa Ethereum wa ndani ulioundwa na Kurtosis, na umeandaa, umepeleka, na umeendesha jaribio rahisi dhidi ya dApp yako.

Sasa hebu tuchunguze jinsi unavyoweza kusanidi mtandao wa msingi kwa ajili ya kupima dApps zetu chini ya usanidi mbalimbali wa mtandao.

Kusanidi testnet ya Ethereum ya ndani

Kubadilisha usanidi wa mteja na idadi ya nodi

Testnet yako ya Ethereum ya ndani inaweza kusanidiwa kutumia jozi tofauti za wateja wa EL na CL, pamoja na idadi tofauti ya nodi, kulingana na hali na usanidi maalum wa mtandao unaotaka kuendeleza au kupima. Hii inamaanisha kuwa, mara tu itakaposanidiwa, unaweza kuwasha testnet ya ndani iliyobinafsishwa na kuitumia kuendesha mtiririko sawa wa kazi (upelekaji, majaribio, n.k.) chini ya usanidi mbalimbali wa mtandao ili kuhakikisha kila kitu kinafanya kazi kama inavyotarajiwa. Ili kujifunza zaidi kuhusu vigezo vingine unavyoweza kurekebisha, tembelea kiungo hiki.

Jaribu! Unaweza kupitisha chaguo mbalimbali za usanidi kwa eth-network-package kupitia faili ya JSON. Faili hii ya JSON ya vigezo vya mtandao hutoa usanidi maalum ambao Kurtosis utatumia kusanidi mtandao wa ndani wa Ethereum.

Chukua faili chaguo-msingi ya usanidi na uihariri ili kuwasha nodi mbili zenye jozi tofauti za EL/CL:

  • Nodi ya 1 na geth/lighthouse
  • Nodi ya 2 na geth/lodestar
  • Nodi ya 3 na geth/teku

Usanidi huu unaunda mtandao wenye utekelezaji mchanganyiko wa nodi za Ethereum kwa ajili ya kupima dApp yako. Faili yako ya usanidi sasa inapaswa kuonekana hivi:

Kila muundo wa participants unahusiana na nodi moja katika mtandao, kwa hivyo miundo 3 ya participants itaiambia Kurtosis iwashe nodi 3 kwenye mtandao wako. Kila muundo wa participants utakuruhusu kubainisha jozi ya EL na CL inayotumika kwa nodi hiyo maalum.

Muundo wa network_params unasanidi mipangilio ya mtandao inayotumika kuunda faili za genesis kwa kila nodi pamoja na mipangilio mingine kama sekunde kwa kila slot ya mtandao.

Hifadhi faili yako ya vigezo iliyohaririwa katika saraka yoyote unayotaka (katika mfano hapa chini, imehifadhiwa kwenye eneo-kazi) na kisha itumie kuendesha kifurushi chako cha Kurtosis kwa kuendesha:

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

Kumbuka: amri ya kurtosis clean -a inatumika hapa kuielekeza Kurtosis kuharibu testnet ya zamani na yaliyomo kabla ya kuanzisha mpya.

Tena, Kurtosis itafanya kazi kwa muda mfupi na kuchapisha hatua za kibinafsi zinazofanyika. Hatimaye, matokeo yanapaswa kuonekana kama:

Hongera! Umefanikiwa kusanidi testnet yako ya ndani iwe na nodi 3 badala ya 1. Ili kuendesha mtiririko sawa wa kazi uliofanya hapo awali dhidi ya dApp yako (kupeleka na kupima), fanya shughuli zilezile tulizofanya hapo awali kwa kubadilisha <$YOUR_PORT> katika muundo wa localnet katika faili yako ya usanidi ya hardhat.config.ts na bandari ya matokeo ya rpc uri kutoka huduma yoyote ya el-client-<num> katika testnet yako mpya ya ndani yenye nodi 3.

Hitimisho

Na ndivyo hivyo! Ili kufupisha mwongozo huu mfupi, wewe:

  • Uliunda testnet ya Ethereum ya ndani juu ya Docker ukitumia Kurtosis
  • Uliunganisha mazingira yako ya uendelezaji wa dApp ya ndani kwenye mtandao wa Ethereum wa ndani
  • Ulipeleka dApp na kuendesha jaribio rahisi dhidi yake kwenye mtandao wa Ethereum wa ndani
  • Ulisanidi mtandao wa msingi wa Ethereum uwe na nodi 3

Tungependa kusikia kutoka kwako juu ya kile kilichokwenda vizuri kwako, kile kinachoweza kuboreshwa, au kujibu maswali yako yoyote. Usisite kuwasiliana kupitia GitHub (opens in a new tab) au tutumie barua pepe (opens email client)!

Mifano na miongozo mingine

Tunakuhimiza uangalie mwongozo wetu wa haraka (opens in a new tab) (ambapo utajenga hifadhidata ya Postgres na API juu yake) na mifano yetu mingine katika hazina yetu ya awesome-kurtosis (opens in a new tab) ambapo utapata mifano mizuri, ikijumuisha vifurushi vya:

Ukurasa ulisasishwa mwisho: 3 Machi 2026

mdqstm (opens in a new tab)
brossetti1b (opens in a new tab)
corwintinesc (opens in a new tab)
+3

Je, mafunzo haya yalikuwa ya msaada?