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

بدء استخدام تطوير إيثريوم

JavaScript
ethers.js
العُقَد
استفسار
Alchemy
المستوى المبتدئ
إيلان هالبرن
30 أكتوبر 2020
4 دقيقة قراءة

شعارات إيثريوم وألكيمي

هذا دليل للمبتدئين لبدء تطوير إيثريوم. في هذا الدرس التعليمي، سنستخدم ألكيمي (opens in a new tab)، وهي منصة تطوير بلوكتشين رائدة تدعم ملايين المستخدمين من 70% من أفضل تطبيقات بلوكتشين، بما في ذلك Maker، و0x، وMyEtherWallet، وDharma، وKyber. سوف تمنحنا ألكيمي إمكانية الوصول إلى نقطة نهاية واجهة برمجة تطبيقات على سلسلة إيثريوم حتى نتمكن من قراءة المعاملات وكتابتها.

سنأخذك من التسجيل مع ألكيمي إلى كتابة أول نص برمجي لك على الويب 3! لا تلزم خبرة في تطوير بلوكتشين!

١. التسجيل للحصول على حساب ألكيمي مجاني

إنشاء حساب مع ألكيمي أمر سهل، سجّل مجانًا هنا (opens in a new tab).

٢. إنشاء تطبيق ألكيمي

للتواصل مع سلسلة إيثريوم واستخدام منتجات ألكيمي، تحتاج إلى مفتاح واجهة برمجة تطبيقات (API) لمصادقة طلباتك.

يمكنك إنشاء مفاتيح واجهة برمجة التطبيقات من لوحة المعلومات (opens in a new tab). لإنشاء مفتاح جديد، انتقل إلى "إنشاء تطبيق" كما هو موضح أدناه:

شكر خاص لـ ShapeShift (opens in a new tab) لسماحهم لنا بعرض لوحة معلوماتهم!

لوحة معلومات ألكيمي

املأ التفاصيل تحت قسم "إنشاء تطبيق" للحصول على مفتاحك الجديد. يمكنك أيضًا رؤية التطبيقات التي أنشأتها مسبقًا وتلك التي أنشأها فريقك هنا. اسحب المفاتيح الموجودة بالنقر على "عرض المفتاح" لأي تطبيق.

لقطة شاشة لإنشاء تطبيق باستخدام ألكيمي

يمكنك أيضًا سحب مفاتيح واجهة برمجة التطبيقات (API) الموجودة عن طريق التمرير فوق "التطبيقات" وتحديد أحدها. يمكنك "عرض المفتاح" هنا، وكذلك "تعديل التطبيق" لإدراج نطاقات معينة في القائمة البيضاء، والاطلاع على العديد من أدوات المطورين، وعرض التحليلات.

صورة Gif تُظهر لمستخدم كيفية سحب مفاتيح واجهة برمجة التطبيقات

3. تقديم طلب من سطر الأوامر

تفاعل مع بلوكتشين إيثريوم من خلال ألكيمي باستخدام JSON-RPC وcurl.

للطلبات اليدوية، نوصي بالتفاعل مع JSON-RPC عبر طلبات POST. ببساطة، مرر رأس Content-Type: application/json واستعلامك كجزء POST الأساسي مع الحقول التالية:

  • jsonrpc: إصدار JSON-RPC — حاليًا، يتم دعم 2.0 فقط.
  • method: طريقة واجهة برمجة تطبيقات ETH. راجع مرجع واجهة برمجة التطبيقات. (opens in a new tab)
  • params: قائمة بالمعلمات التي يجب تمريرها إلى الطريقة.
  • id: مُعرّف طلبك. سيتم إرجاعها عن طريق الاستجابة حتى تتمكن من تتبع الطلب الذي تنتمي إليه الاستجابة.

فيما يلي مثال يمكنك تشغيله من سطر الأوامر لاسترداد سعر الغاز الحالي:

curl https://eth-mainnet.alchemyapi.io/v2/demo \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'

ملاحظة: استبدل https://eth-mainnet.alchemyapi.io/v2/demo (opens in a new tab) بمفتاح واجهة برمجة التطبيقات الخاص بك https://eth-mainnet.alchemyapi.io/v2/**your-api-key.

النتائج:

1{ "id": 73,"jsonrpc": "2.0","result": "0x09184e72a000" // 10000000000000 }

4. إعداد عميل الويب 3 الخاص بك

إذا كان لديك عميل حالي، فغيّر عنوان URL لمزوّد العقدة الحالي إلى عنوان URL الخاص بـ ألكيمي مع مفتاح واجهة برمجة التطبيقات الخاص بك: “https://eth-mainnet.alchemyapi.io/v2/your-api-key"

ملاحظة: يجب تشغيل البرامج النصية أدناه في سياق عقدة أو حفظها في ملف، وليس تشغيلها من سطر الأوامر. إذا لم يكن لديك Node أو npm مثبتين بالفعل، فراجع دليل الإعداد السريع لأجهزة Mac (opens in a new tab) هذا.

هناك الكثير من مكتبات الويب 3 (opens in a new tab) التي يمكنك دمجها مع ألكيمي، ومع ذلك، نوصي باستخدام ألكيمي ويب3 (opens in a new tab)، وهو بديل مباشر لـ web3.js، تم إنشاؤه وتهيئته للعمل بسلاسة مع ألكيمي. يوفر هذا مزايا متعددة مثل عمليات إعادة المحاولة التلقائية ودعم WebSocket القوي.

لتثبيت AlchemyWeb3.js، انتقل إلى دليل مشروعك وقم بتشغيل:

باستخدام Yarn:

1yarn add @alch/alchemy-web3

باستخدام NPM:

1npm install @alch/alchemy-web3

للتفاعل مع البنية التحتية لعقدة ألكيمي، قم بالتشغيل في NodeJS أو أضف هذا إلى ملف جافا سكريبت:

1const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
2const web3 = createAlchemyWeb3(
3 "https://eth-mainnet.alchemyapi.io/v2/your-api-key"
4)

5. اكتب أول نص برمجي لك على الويب 3!

الآن، لنبدأ التطبيق العملي ببعض البرمجة على الويب 3، سنكتب نصًا برمجيًا بسيطًا يطبع رقم أحدث كتلة من شبكة إيثريوم الرئيسية.

**1. إذا لم تكن قد فعلت ذلك بالفعل، فأنشئ دليل مشروع جديدًا في الطرفية الخاصة بك وانتقل إليه:

1mkdir web3-example
2cd web3-example

**2. قم بتثبيت تبعية ألكيمي web3 (أو أي تبعية للويب 3) في مشروعك إذا لم تكن قد فعلت ذلك بالفعل:

1npm install @alch/alchemy-web3

**3. أنشئ ملفًا باسم index.js وأضف المحتويات التالية:

يجب عليك في النهاية استبدال demo بمفتاح واجهة برمجة تطبيقات HTTP الخاص بـ ألكيمي.

1async function main() {
2 const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
3 const web3 = createAlchemyWeb3("https://eth-mainnet.alchemyapi.io/v2/demo")
4 const blockNumber = await web3.eth.getBlockNumber()
5 console.log("أحدث رقم كتلة هو " + blockNumber)
6}
7main()

غير معتاد على استخدام async؟ اطلع على منشور Medium هذا (opens in a new tab).

**4. شغّله في الطرفية باستخدام node

1node index.js

**5. يجب أن ترى الآن أحدث رقم للكتلة في وحدة التحكم الخاصة بك!

1أحدث رقم للكتلة هو 11043912

يا للروعة! تهانينا! لقد كتبت للتو أول نص برمجي لك على الويب 3 باستخدام ألكيمي 🎉

لست متأكداً مما يجب فعله بعد ذلك؟ جرّب نشر أول عقد ذكي لك، وتدرّب على بعض برمجة سوليديتي في دليل عقد Hello World الذكي (opens in a new tab)، أو اختبر معلوماتك في لوحة المعلومات باستخدام تطبيق العرض التوضيحي للوحة المعلومات (opens in a new tab)!

سجّل مع ألكيمي مجانًا (opens in a new tab)، واطلع على وثائقنا (opens in a new tab)، وللحصول على آخر الأخبار، تابعنا على تويتر (opens in a new tab).

آخر تحديث للصفحة: 3 مارس 2026

هل كانت تعليمات الاستخدام هذه مفيدة؟