تخطي إلى المحتوى الرئيسي

كيفية تطوير واختبار تطبيق لامركزي (⁦dapp⁩) على شبكة اختبار محلية متعددة العملاء

العملاء
العقد
العقود الذكية
قابلية التركيب
طبقة الإجماع
طبقة التنفيذ
الاختبار
متوسط
تيدي ميتيكو
11 أبريل 2023
11 دقيقة للقراءة

مقدمة

يرشدك هذا الدليل خلال عملية إنشاء شبكة اختبار إيثيريوم محلية قابلة للتكوين، ونشر عقد ذكي عليها، واستخدام شبكة الاختبار لإجراء اختبارات على تطبيقك اللامركزي (dapp). صُمم هذا الدليل لمطوري التطبيقات اللامركزية الذين يرغبون في تطوير واختبار تطبيقاتهم اللامركزية محليًا مقابل تكوينات شبكة مختلفة قبل النشر على شبكة اختبار حية أو الشبكة الرئيسية.

في هذا الدليل، ستقوم بما يلي:

  • إنشاء شبكة اختبار إيثيريوم محلية باستخدام eth-network-package (opens in a new tab) عبر Kurtosis (opens in a new tab)،
  • ربط بيئة تطوير التطبيق اللامركزي (dapp) الخاصة بك في Hardhat بشبكة الاختبار المحلية لتجميع ونشر واختبار تطبيق لامركزي، و
  • تكوين شبكة الاختبار المحلية، بما في ذلك المعلمات مثل عدد العقد واقترانات عملاء طبقة التنفيذ/طبقة الإجماع (EL/CL) المحددة، لتمكين مسارات عمل التطوير والاختبار مقابل تكوينات الشبكة المختلفة.

ما هو Kurtosis؟

Kurtosis (opens in a new tab) هو نظام بناء قابل للتركيب مصمم لتكوين بيئات اختبار متعددة الحاويات. وهو يمكّن المطورين تحديدًا من إنشاء بيئات قابلة لإعادة الإنتاج تتطلب منطق إعداد ديناميكي، مثل شبكات اختبار سلسلة الكتل.

في هذا الدليل، تقوم حزمة eth-network-package من Kurtosis بتشغيل شبكة اختبار إيثيريوم محلية مع دعم لعميل طبقة التنفيذ (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 للمطورين تحكمًا ومرونة أكبر في شبكات الاختبار التي يستخدمونها، وهو سبب رئيسي وراء استخدام مؤسسة إيثيريوم لـ Kurtosis لاختبار الدمج (opens in a new tab) واستمرارها في استخدامه لاختبار ترقيات الشبكة.

إعداد Kurtosis

قبل المتابعة، تأكد من أن لديك:

إنشاء شبكة اختبار إيثيريوم محلية

لتشغيل شبكة اختبار إيثيريوم محلية، قم بتشغيل:

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

ملاحظة: يقوم هذا الأمر بتسمية شبكتك: "local-eth-testnet" باستخدام العلامة --enclave.

سيطبع Kurtosis الخطوات التي يتخذها داخليًا أثناء عمله على تفسير التعليمات والتحقق من صحتها ثم تنفيذها. في النهاية، يجب أن ترى مخرجات تشبه ما يلي:

تهانينا! لقد استخدمت Kurtosis لإنشاء شبكة اختبار إيثيريوم محلية، مع عميل طبقة إجماع (CL) (lighthouse) وعميل طبقة تنفيذ (EL) (geth)، عبر Docker.

مراجعة

في هذا القسم، قمت بتنفيذ أمر يوجه Kurtosis لاستخدام eth-network-package المستضافة عن بُعد على GitHub (opens in a new tab) لتشغيل شبكة اختبار إيثيريوم محلية داخل Enclave (opens in a new tab) الخاص بـ Kurtosis. داخل الـ Enclave الخاص بك، ستجد كلاً من "القطع الأثرية للملفات" (file artifacts) و"خدمات المستخدم" (user services).

تتضمن القطع الأثرية للملفات (opens in a new tab) في الـ Enclave الخاص بك جميع البيانات التي تم إنشاؤها واستخدامها لتمهيد عملاء طبقة التنفيذ (EL) وطبقة الإجماع (CL). تم إنشاء البيانات باستخدام خدمة prelaunch-data-generator المبنية من صورة Docker (opens in a new tab) هذه.

تعرض خدمات المستخدم جميع الخدمات المعبأة في حاويات والتي تعمل في الـ Enclave الخاص بك. ستلاحظ أنه تم إنشاء عقدة واحدة، تتميز بكل من عميل طبقة التنفيذ (EL) وعميل طبقة الإجماع (CL).

ربط بيئة تطوير التطبيق اللامركزي (dapp) بشبكة اختبار إيثيريوم المحلية

إعداد بيئة تطوير التطبيق اللامركزي

الآن بعد أن أصبح لديك شبكة اختبار محلية قيد التشغيل، يمكنك ربط بيئة تطوير التطبيق اللامركزي الخاصة بك لاستخدام شبكة الاختبار المحلية. سيتم استخدام إطار عمل Hardhat في هذا الدليل لنشر تطبيق لامركزي للعبة البلاك جاك (blackjack) على شبكة الاختبار المحلية الخاصة بك.

لإعداد بيئة تطوير التطبيق اللامركزي الخاصة بك، قم باستنساخ المستودع الذي يحتوي على نموذج التطبيق اللامركزي الخاص بنا وتثبيت تبعياته، عن طريق تشغيل:

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):

  • يحتوي contracts/ (opens in a new tab) على بعض العقود الذكية البسيطة لتطبيق لامركزي للعبة البلاك جاك
  • يحتوي scripts/ (opens in a new tab) على برنامج نصي لنشر عقد رمز مميز على شبكة إيثيريوم المحلية الخاصة بك
  • يحتوي test/ (opens in a new tab) على اختبار .js بسيط لعقد الرمز المميز الخاص بك لتأكيد أن كل لاعب في تطبيق البلاك جاك اللامركزي الخاص بنا قد تم سك 1000 رمز له
  • يقوم hardhat.config.ts (opens in a new tab) بتكوين إعداد Hardhat الخاص بك

تكوين Hardhat لاستخدام شبكة الاختبار المحلية

مع إعداد بيئة تطوير التطبيق اللامركزي الخاصة بك، ستقوم الآن بربط Hardhat لاستخدام شبكة اختبار إيثيريوم المحلية التي تم إنشاؤها باستخدام Kurtosis. لتحقيق ذلك، استبدل <$YOUR_PORT> في بنية localnet في ملف التكوين hardhat.config.ts الخاص بك بمنفذ مخرجات rpc uri من أي خدمة el-client-<num>. في حالة هذا النموذج، سيكون المنفذ 64248. سيكون المنفذ الخاص بك مختلفًا.

مثال في hardhat.config.ts:

بمجرد حفظ ملفك، ستكون بيئة تطوير التطبيق اللامركزي في Hardhat متصلة الآن بشبكة اختبار إيثيريوم المحلية الخاصة بك! يمكنك التحقق من أن شبكة الاختبار الخاصة بك تعمل عن طريق تشغيل:

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.

نشر واختبار تطبيقك اللامركزي محليًا

مع اتصال بيئة تطوير التطبيق اللامركزي بالكامل بشبكة اختبار إيثيريوم المحلية، يمكنك الآن تشغيل مسارات عمل التطوير والاختبار على تطبيقك اللامركزي باستخدام شبكة الاختبار المحلية.

لتجميع ونشر العقد الذكي ChipToken.sol للنماذج الأولية والتطوير المحلي، قم بتشغيل:

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

يجب أن تبدو المخرجات مشابهة لما يلي:

ChipToken deployed to: 0xAb2A01BC351770D09611Ac80f1DE076D56E0487d

حاول الآن تشغيل اختبار simple.js على تطبيقك اللامركزي المحلي لتأكيد أن كل لاعب في تطبيق البلاك جاك اللامركزي الخاص بنا قد تم سك 1000 رمز له:

يجب أن تبدو المخرجات مشابهة لما يلي:

npx hardhat test --network localnet

يجب أن تبدو المخرجات مشابهة لما يلي:

ChipToken
    mint
      ✔ should mint 1000 chips for PLAYER ONE

  1 passing (654ms)

مراجعة

في هذه المرحلة، تكون قد قمت بإعداد بيئة تطوير تطبيق لامركزي، وربطتها بشبكة إيثيريوم محلية تم إنشاؤها بواسطة Kurtosis، وقمت بتجميع ونشر وتشغيل اختبار بسيط على تطبيقك اللامركزي.

دعنا نستكشف الآن كيف يمكنك تكوين الشبكة الأساسية لاختبار تطبيقاتنا اللامركزية في ظل تكوينات شبكة مختلفة.

تكوين شبكة اختبار إيثيريوم المحلية

تغيير تكوينات العميل وعدد العقد

يمكن تكوين شبكة اختبار إيثيريوم المحلية الخاصة بك لاستخدام أزواج مختلفة من عملاء طبقة التنفيذ (EL) وطبقة الإجماع (CL)، بالإضافة إلى عدد متفاوت من العقد، اعتمادًا على السيناريو وتكوين الشبكة المحدد الذي تريد تطويره أو اختباره. هذا يعني أنه بمجرد الإعداد، يمكنك تشغيل شبكة اختبار محلية مخصصة واستخدامها لتشغيل نفس مسارات العمل (النشر، الاختبارات، إلخ) في ظل تكوينات شبكة مختلفة لضمان عمل كل شيء كما هو متوقع. لمعرفة المزيد حول المعلمات الأخرى التي يمكنك تعديلها، قم بزيارة هذا الرابط.

جرب ذلك! يمكنك تمرير خيارات تكوين مختلفة إلى eth-network-package عبر ملف JSON. يوفر ملف JSON لمعلمات الشبكة هذا التكوينات المحددة التي سيستخدمها Kurtosis لإعداد شبكة إيثيريوم المحلية.

خذ ملف التكوين الافتراضي وقم بتحريره لتشغيل عقدتين بأزواج مختلفة من طبقة التنفيذ/طبقة الإجماع (EL/CL):

  • العقدة 1 مع geth/lighthouse
  • العقدة 2 مع geth/lodestar
  • العقدة 3 مع geth/teku

ينشئ هذا التكوين شبكة غير متجانسة من تطبيقات عقدة إيثيريوم لاختبار تطبيقك اللامركزي. يجب أن يبدو ملف التكوين الخاص بك الآن كما يلي:

ترتبط كل بنية participants بعقدة في الشبكة، لذا فإن 3 بنيات participants ستخبر Kurtosis بتشغيل 3 عقد في شبكتك. ستسمح لك كل بنية participants بتحديد زوج طبقة التنفيذ (EL) وطبقة الإجماع (CL) المستخدم لتلك العقدة المحددة.

تقوم بنية network_params بتكوين إعدادات الشبكة التي تُستخدم لإنشاء ملفات التكوين (genesis files) لكل عقدة بالإضافة إلى إعدادات أخرى مثل الثواني لكل خانة (slot) في الشبكة.

احفظ ملف المعلمات المحرر في أي دليل تريده (في المثال أدناه، تم حفظه على سطح المكتب) ثم استخدمه لتشغيل حزمة 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 لفترة من الوقت ويطبع الخطوات الفردية التي تحدث. في النهاية، يجب أن تبدو المخرجات مشابهة لما يلي:

تهانينا! لقد نجحت في تكوين شبكة الاختبار المحلية الخاصة بك ليكون بها 3 عقد بدلاً من 1. لتشغيل نفس مسارات العمل التي قمت بها من قبل على تطبيقك اللامركزي (النشر والاختبار)، قم بإجراء نفس العمليات التي قمنا بها من قبل عن طريق استبدال <$YOUR_PORT> في بنية localnet في ملف التكوين hardhat.config.ts الخاص بك بمنفذ مخرجات rpc uri من أي خدمة el-client-<num> في شبكة الاختبار المحلية الجديدة المكونة من 3 عقد.

الخاتمة

وهذا كل شيء! لتلخيص هذا الدليل القصير، قمت بما يلي:

  • إنشاء شبكة اختبار إيثيريوم محلية عبر Docker باستخدام Kurtosis
  • ربط بيئة تطوير التطبيق اللامركزي المحلية الخاصة بك بشبكة إيثيريوم المحلية
  • نشر تطبيق لامركزي وتشغيل اختبار بسيط عليه على شبكة إيثيريوم المحلية
  • تكوين شبكة إيثيريوم الأساسية ليكون بها 3 عقد

نود أن نسمع منك عما سار بشكل جيد بالنسبة لك، وما يمكن تحسينه، أو للإجابة على أي من أسئلتك. لا تتردد في التواصل معنا عبر GitHub (opens in a new tab) أو مراسلتنا عبر البريد الإلكتروني (opens email client)!

أمثلة وأدلة أخرى

نشجعك على التحقق من البدء السريع (opens in a new tab) الخاص بنا (حيث ستقوم ببناء قاعدة بيانات Postgres وواجهة برمجة تطبيقات (API) فوقها) وأمثلتنا الأخرى في مستودع awesome-kurtosis (opens in a new tab) الخاص بنا حيث ستجد بعض الأمثلة الرائعة، بما في ذلك حزم لـ: