مرکزی مواد پر جائیں

⁦مقامی، ملٹی کلائنٹ آزمائشی نیٹ ورک پر غیر مرکزی ایپلی کیشن (dapp) تیار اور ٹیسٹ کرنے کا طریقہ⁩

کلائنٹس
نوڈز
سمارٹ کنٹریکٹس
قابلِ ترکیبیت
اتفاق رائے کی تہہ
عمل درآمد کی تہہ
ٹیسٹنگ
درمیانی
ٹیڈی میٹیکو
۱۱ اپریل، ۲۰۲۳
14 منٹ کا مطالعہ
صفحہ میں ترمیم کریں (opens in a new tab)

تعارف

یہ گائیڈ آپ کو ایک قابلِ تشکیل مقامی ایتھیریم آزمائشی نیٹ ورک شروع کرنے، اس پر سمارٹ کنٹریکٹ تعینات کرنے، اور اپنی غیر مرکزی ایپلی کیشن (dapp) کے خلاف ٹیسٹ چلانے کے لیے آزمائشی نیٹ ورک استعمال کرنے کے عمل سے آگاہ کرتی ہے۔ یہ گائیڈ ان dapp ڈیولپرز کے لیے بنائی گئی ہے جو لائیو آزمائشی نیٹ ورک یا مین نیٹ پر تعینات کرنے سے پہلے مختلف نیٹ ورک کنفیگریشنز کے خلاف مقامی طور پر اپنی dapps تیار اور ٹیسٹ کرنا چاہتے ہیں۔

اس گائیڈ میں، آپ یہ کریں گے:

  • Kurtosis (opens in a new tab) کا استعمال کرتے ہوئے eth-network-package (opens in a new tab) کے ساتھ ایک مقامی ایتھیریم آزمائشی نیٹ ورک شروع کریں گے،
  • ایک dapp کو مرتب کرنے، تعینات کرنے اور ٹیسٹ کرنے کے لیے اپنے Hardhat 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 --enclave local-eth-testnet run github.com/kurtosis-tech/eth-network-package

نوٹ: یہ کمانڈ --enclave فلیگ کا استعمال کرتے ہوئے آپ کے نیٹ ورک کا نام "local-eth-testnet" رکھتی ہے۔

Kurtosis اندرونی طور پر اٹھائے جانے والے اقدامات کو پرنٹ کرے گا کیونکہ یہ ہدایات کی تشریح، توثیق، اور پھر ان پر عمل درآمد کرنے کا کام کرتا ہے۔ آخر میں، آپ کو ایک آؤٹ پٹ نظر آنی چاہیے جو درج ذیل سے ملتی جلتی ہو:

مبارک ہو! آپ نے Docker پر CL (lighthouse) اور EL کلائنٹ (geth) کے ساتھ ایک مقامی ایتھیریم آزمائشی نیٹ ورک شروع کرنے کے لیے Kurtosis کا استعمال کیا ہے۔

جائزہ

اس سیکشن میں، آپ نے ایک کمانڈ چلائی جس نے Kurtosis کو ہدایت کی کہ وہ Kurtosis Enclave (opens in a new tab) کے اندر ایک مقامی ایتھیریم آزمائشی نیٹ ورک شروع کرنے کے لیے GitHub پر دور دراز سے ہوسٹ کیے گئے eth-network-package (opens in a new tab) کا استعمال کرے۔ آپ کے انکلیو (enclave) کے اندر، آپ کو "فائل آرٹفیکٹس" اور "صارف کی خدمات" دونوں ملیں گے۔

آپ کے انکلیو میں موجود فائل آرٹفیکٹس (opens in a new tab) میں وہ تمام ڈیٹا شامل ہے جو EL اور CL کلائنٹس کو بوٹ اسٹریپ کرنے کے لیے تیار اور استعمال کیا گیا ہے۔ یہ ڈیٹا اس Docker امیج (opens in a new tab) سے بنی prelaunch-data-generator سروس کا استعمال کرتے ہوئے بنایا گیا تھا۔

صارف کی خدمات آپ کے انکلیو میں کام کرنے والی تمام کنٹینرائزڈ خدمات کو ظاہر کرتی ہیں۔ آپ دیکھیں گے کہ ایک واحد نوڈ، جس میں EL کلائنٹ اور CL کلائنٹ دونوں شامل ہیں، بنایا گیا ہے۔

اپنے dapp ڈیولپمنٹ ماحول کو مقامی ایتھیریم آزمائشی نیٹ ورک سے جوڑیں

dapp ڈیولپمنٹ ماحول سیٹ اپ کریں

اب جب کہ آپ کے پاس ایک چلتا ہوا مقامی آزمائشی نیٹ ورک ہے، آپ اپنے مقامی آزمائشی نیٹ ورک کو استعمال کرنے کے لیے اپنے dapp ڈیولپمنٹ ماحول کو جوڑ سکتے ہیں۔ اس گائیڈ میں آپ کے مقامی آزمائشی نیٹ ورک پر بلیک جیک dapp کو تعینات کرنے کے لیے Hardhat فریم ورک کا استعمال کیا جائے گا۔

اپنے dapp ڈیولپمنٹ ماحول کو سیٹ اپ کرنے کے لیے، اس ریپوزٹری کو کلون کریں جس میں ہماری نمونہ dapp شامل ہے اور اس کی انحصاریاں (dependencies) انسٹال کریں، یہ چلائیں:

git 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) میں بلیک جیک dapp کے لیے چند سادہ سمارٹ کنٹریکٹس شامل ہیں
  • scripts/ (opens in a new tab) میں آپ کے مقامی ایتھیریم نیٹ ورک پر ٹوکن کنٹریکٹ تعینات کرنے کے لیے ایک اسکرپٹ شامل ہے
  • test/ (opens in a new tab) میں آپ کے ٹوکن کنٹریکٹ کے لیے ایک سادہ .js ٹیسٹ شامل ہے تاکہ اس بات کی تصدیق کی جا سکے کہ ہماری بلیک جیک dapp میں ہر کھلاڑی کے لیے 1000 منٹ (mint) کیے گئے ہیں
  • hardhat.config.ts (opens in a new tab) آپ کے Hardhat سیٹ اپ کو کنفیگر کرتا ہے

مقامی آزمائشی نیٹ ورک استعمال کرنے کے لیے Hardhat کو کنفیگر کریں

اپنے dapp ڈیولپمنٹ ماحول کے سیٹ اپ کے ساتھ، اب آپ Kurtosis کا استعمال کرتے ہوئے تیار کردہ مقامی ایتھیریم آزمائشی نیٹ ورک کو استعمال کرنے کے لیے Hardhat کو جوڑیں گے۔ اسے مکمل کرنے کے لیے، اپنی hardhat.config.ts کنفیگریشن فائل میں localnet اسٹرکٹ (struct) میں موجود <$YOUR_PORT> کو کسی بھی el-client-<num> سروس سے rpc uri آؤٹ پٹ کی پورٹ سے تبدیل کریں۔ اس نمونے کے معاملے میں، پورٹ 64248 ہوگی۔ آپ کی پورٹ مختلف ہوگی۔

hardhat.config.ts میں مثال:

ایک بار جب آپ اپنی فائل محفوظ کر لیتے ہیں، تو آپ کا Hardhat dapp ڈیولپمنٹ ماحول اب آپ کے مقامی ایتھیریم آزمائشی نیٹ ورک سے جڑ گیا ہے! آپ یہ چلا کر تصدیق کر سکتے ہیں کہ آپ کا آزمائشی نیٹ ورک کام کر رہا ہے:

npx hardhat balances --network localnet

آؤٹ پٹ کچھ اس طرح نظر آنی چاہیے:

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

یہ اس بات کی تصدیق کرتا ہے کہ Hardhat آپ کا مقامی آزمائشی نیٹ ورک استعمال کر رہا ہے اور eth-network-package کے ذریعے بنائے گئے پہلے سے فنڈڈ اکاؤنٹس کا پتہ لگاتا ہے۔

مقامی طور پر اپنی dapp کو تعینات اور ٹیسٹ کریں

dapp ڈیولپمنٹ ماحول کے مقامی ایتھیریم آزمائشی نیٹ ورک سے مکمل طور پر جڑ جانے کے بعد، اب آپ مقامی آزمائشی نیٹ ورک کا استعمال کرتے ہوئے اپنی dapp کے خلاف ڈیولپمنٹ اور ٹیسٹنگ ورک فلو چلا سکتے ہیں۔

مقامی پروٹو ٹائپنگ اور ڈیولپمنٹ کے لیے ChipToken.sol سمارٹ کنٹریکٹ کو مرتب اور تعینات کرنے کے لیے، یہ چلائیں:

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

آؤٹ پٹ کچھ اس طرح نظر آنی چاہیے:

ChipToken deployed to: 0xAb2A01BC351770D09611Ac80f1DE076D56E0487d

اب اپنی مقامی dapp کے خلاف simple.js ٹیسٹ چلانے کی کوشش کریں تاکہ اس بات کی تصدیق کی جا سکے کہ ہماری بلیک جیک dapp میں ہر کھلاڑی کے لیے 1000 منٹ (mint) کیے گئے ہیں:

آؤٹ پٹ کچھ اس طرح نظر آنی چاہیے:

npx hardhat test --network localnet

آؤٹ پٹ کچھ اس طرح نظر آنی چاہیے:

ChipToken
    mint
      ✔ should mint 1000 chips for PLAYER ONE

  1 passing (654ms)

جائزہ

اس مقام پر، اب آپ نے ایک dapp ڈیولپمنٹ ماحول سیٹ اپ کر لیا ہے، اسے Kurtosis کے ذریعے بنائے گئے مقامی ایتھیریم نیٹ ورک سے جوڑ دیا ہے، اور اپنی dapp کے خلاف ایک سادہ ٹیسٹ مرتب، تعینات، اور چلا لیا ہے۔

اب آئیے دریافت کرتے ہیں کہ آپ مختلف نیٹ ورک کنفیگریشنز کے تحت ہماری dapps کی ٹیسٹنگ کے لیے بنیادی نیٹ ورک کو کیسے کنفیگر کر سکتے ہیں۔

مقامی ایتھیریم آزمائشی نیٹ ورک کو کنفیگر کرنا

کلائنٹ کنفیگریشنز اور نوڈز کی تعداد کو تبدیل کرنا

آپ کے مقامی ایتھیریم آزمائشی نیٹ ورک کو مختلف EL اور CL کلائنٹ کے جوڑوں کے ساتھ ساتھ نوڈز کی مختلف تعداد استعمال کرنے کے لیے کنفیگر کیا جا سکتا ہے، جس کا انحصار اس منظر نامے اور مخصوص نیٹ ورک کنفیگریشن پر ہے جسے آپ تیار یا ٹیسٹ کرنا چاہتے ہیں۔ اس کا مطلب یہ ہے کہ، ایک بار سیٹ اپ ہونے کے بعد، آپ ایک حسب ضرورت مقامی آزمائشی نیٹ ورک شروع کر سکتے ہیں اور اسے مختلف نیٹ ورک کنفیگریشنز کے تحت انہی ورک فلوز (تعیناتی، ٹیسٹ وغیرہ) کو چلانے کے لیے استعمال کر سکتے ہیں تاکہ یہ یقینی بنایا جا سکے کہ سب کچھ توقع کے مطابق کام کر رہا ہے۔ ان دیگر پیرامیٹرز کے بارے میں مزید جاننے کے لیے جنہیں آپ تبدیل کر سکتے ہیں، اس لنک پر جائیں۔

اسے آزما کر دیکھیں! آپ JSON فائل کے ذریعے eth-network-package کو مختلف کنفیگریشن آپشنز پاس کر سکتے ہیں۔ یہ نیٹ ورک پیرامیٹرز JSON فائل وہ مخصوص کنفیگریشنز فراہم کرتی ہے جنہیں Kurtosis مقامی ایتھیریم نیٹ ورک سیٹ اپ کرنے کے لیے استعمال کرے گا۔

ڈیفالٹ کنفیگریشن فائل لیں اور مختلف EL/CL جوڑوں کے ساتھ دو نوڈز شروع کرنے کے لیے اس میں ترمیم کریں:

  • geth/lighthouse کے ساتھ نوڈ 1
  • geth/lodestar کے ساتھ نوڈ 2
  • geth/teku کے ساتھ نوڈ 3

یہ کنفیگریشن آپ کی dapp کی ٹیسٹنگ کے لیے ایتھیریم نوڈ کے نفاذ کا ایک متضاد (heterogeneous) نیٹ ورک بناتی ہے۔ آپ کی کنفیگریشن فائل اب اس طرح نظر آنی چاہیے:

ہر participants اسٹرکٹ (struct) نیٹ ورک میں ایک نوڈ سے میپ ہوتا ہے، لہذا 3 participants اسٹرکٹس Kurtosis کو آپ کے نیٹ ورک میں 3 نوڈز شروع کرنے کا بتائیں گے۔ ہر participants اسٹرکٹ آپ کو اس مخصوص نوڈ کے لیے استعمال ہونے والے EL اور CL جوڑے کی وضاحت کرنے کی اجازت دے گا۔

network_params اسٹرکٹ ان نیٹ ورک سیٹنگز کو کنفیگر کرتا ہے جو ہر نوڈ کے لیے جینیسس (genesis) فائلیں بنانے کے ساتھ ساتھ نیٹ ورک کے سیکنڈز فی سلاٹ جیسی دیگر سیٹنگز کے لیے استعمال ہوتی ہیں۔

اپنی ترمیم شدہ پیرامیٹرز فائل کو اپنی مرضی کی کسی بھی ڈائرکٹری میں محفوظ کریں (نیچے دی گئی مثال میں، اسے ڈیسک ٹاپ پر محفوظ کیا گیا ہے) اور پھر اسے چلا کر اپنا Kurtosis پیکیج چلانے کے لیے استعمال کریں:

kurtosis 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 تھوڑی دیر کے لیے کام کرے گا اور ہونے والے انفرادی اقدامات کو پرنٹ کرے گا۔ بالآخر، آؤٹ پٹ کچھ اس طرح نظر آنی چاہیے:

مبارک ہو! آپ نے کامیابی کے ساتھ اپنے مقامی آزمائشی نیٹ ورک کو 1 کے بجائے 3 نوڈز رکھنے کے لیے کنفیگر کر لیا ہے۔ اپنی dapp کے خلاف وہی ورک فلوز چلانے کے لیے جو آپ نے پہلے کیے تھے (تعینات اور ٹیسٹ)، اپنی hardhat.config.ts کنفیگریشن فائل میں localnet اسٹرکٹ میں موجود <$YOUR_PORT> کو اپنے نئے، 3-نوڈ مقامی آزمائشی نیٹ ورک میں کسی بھی el-client-<num> سروس سے rpc uri آؤٹ پٹ کی پورٹ سے تبدیل کر کے وہی کام انجام دیں جو ہم نے پہلے کیے تھے۔

نتیجہ

اور بس! اس مختصر گائیڈ کا خلاصہ کرنے کے لیے، آپ نے:

  • 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) میں ہماری دیگر مثالیں دیکھیں جہاں آپ کو کچھ بہترین مثالیں ملیں گی، بشمول ان کے پیکیجز:

صفحہ کی آخری اپ ڈیٹ: ۳ مارچ، ۲۰۲۶