كيفية الحصول على جميع رموز ERC-20 المملوكة للعنوان

يعد العثور على أرصدة الرموز المميزة ERC-20 في أي محفظة أمرًا بسيطًا؛ عندما يفتح المستخدمون محافظهم، يقومون تلقائيًا بعرض أرصدة جميع الرموز المميزة المستوردة. ومع ذلك، عندما يحتاج فرد أو كيان، مثل جهات إنفاذ القانون أو الشركات، إلى التأكد من أرصدة رمز ERC-20 لعنوان آخر، فإن الوصول المباشر إلى المحفظة غير ممكن.

في مثل هذه الحالات، يمكن استخدام واجهة برمجة التطبيقات (API) للتحقق من الأرصدة في المحفظة. ستعيد واجهة برمجة التطبيقات (API) جميع أرصدة الرموز المميزة ERC-20 المملوكة للعنوان ويمكنها أتمتة عملية التحقق من أرصدة الرموز المميزة.

تتناول هذه المقالة كيفية استخدام واجهات برمجة التطبيقات الخاصة بـ Chainbase وAlchemy وMoralis للحصول على معلومات حول رموز ERC-20 المملوكة لعنوان ما.

دليل خطوة بخطوة لاستخدام Chainbase للعثور على جميع رموز ERC-20 المملوكة لعنوان ما

تقدم Chainbase – وهي بنية تحتية لطبقة تفاعل blockchain Web3 – خدمات واجهة برمجة التطبيقات (API) لمساعدة المطورين على الوصول بسرعة إلى شبكات blockchain واستخدامها. تسهل واجهات برمجة التطبيقات الخاصة بها استعلامات البيانات على السلسلة.

للعمل مع Chainbase، يحتاج المستخدم إلى حساب على النظام الأساسي يحتوي على مفتاح API وبيئة تطوير متكاملة وعنوان محفظة كمدخل.

الخطوة 1: إنشاء حساب مجاني وتسجيل الدخول

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

الخطوة 2: استخدم Chainbase API لكتابة البرنامج النصي

والخطوة التالية هي إجراء اتصال API بـ Chainbase لاسترداد أرصدة الرموز المميزة لـ ERC-20. تستخدم الأمثلة أدناه Javascript. يستلزم الإجراء اللاحق تنفيذ طلب HTTP باستخدام JavaScript، واستخدام مكتبة Axios للحصول على أرصدة رمز ERC-20 من Chainbase.

استخدم “جلب” لتقديم طلب HTTP لاسترداد البيانات من الخادم، كما هو موضح في مقتطف الكود أدناه:

يستعلم الكود الموجود في المثال أعلاه عن Chainbase لجلب أول خمسة أرصدة رمزية ERC-20 للمحفظة (باستخدام عنوان Vitalik Buterin كمثال) على شبكة Ethereum الرئيسية، ويعرض النتائج أو أي أخطاء تمت مواجهتها.

على الرغم من أن واجهة برمجة التطبيقات Fetch الأصلية هي طريقة شائعة لتنفيذ طلبات HTTP باستخدام JavaScript، إلا أنه في رمز المثال، يتم إجراء “الجلب” من الناحية النظرية بواسطة Axios، وليس بواسطة Fetch API الأصلية. لاستخدام Axios، يجب على المستخدم تثبيته باستخدام “npm install axios –save” في الجهاز.

يستخدم الكود أعلاه Axios في JavaScript للاستعلام عن Chainbase لأول خمسة أرصدة رمزية ERC-20 لمحفظة Vitalik Buterin على شبكة Ethereum الرئيسية.

الخطوة 3: طباعة أرصدة الرموز المميزة

تستخدم واجهة برمجة تطبيقات getAccountTokens الخاصة بـ Chainbase معرف السلسلة وعنوان المحفظة كمعلمات وتقوم بإرجاع جميع أرصدة الرموز المميزة ERC-20 التي تمتلكها المحفظة. يمكن للمستخدمين أيضًا العثور على معلومات حول رمز مميز معين عن طريق ملء ملف “contract_address“ مجال. لطباعة البيانات، يجب على المستخدم تشغيل الأمر “node .js” في الجهاز.

يعرض مقتطف الكود أعلاه أرصدة ومعلومات للعديد من رموز ERC-20، بما في ذلك Eterium وUniswap V2 وdYdX وغيرها، من محفظة معينة.

دليل خطوة بخطوة لاستخدام Alchemy للعثور على جميع رموز ERC-20 المملوكة لعنوان ما

تقدم Alchemy واجهات برمجة التطبيقات (APIs) التي تعمل كطبقة منصة، للقراءة أو الكتابة إلى blockchain وتقديم المعلومات الدقيقة التي يريدها المطورون. فيما يلي الإجراء للحصول على أرصدة الرموز المميزة عبر Alchemy:

الخطوة 1: تثبيت العقدة وNPM

قم بتثبيت Node وNode Package Manager (NPM) على الجهاز المحلي. Node عبارة عن بيئة تشغيل جافا سكريبت مفتوحة المصدر ومتعددة المنصات، بينما يوفر NPM إمكانية الوصول إلى نظام بيئي واسع من المكتبات والأدوات.

الخطوة 2: قم بالتسجيل للحصول على حساب Alchemy وإنشاء تطبيق

على موقع Alchemy، قم بالتسجيل للحصول على حساب مجاني. ثم قم بتسجيل الدخول وانتقل إلى “Alchemy Dashboard” لإنشاء تطبيق جديد. اضبط blockchain على “Ethereum” والشبكة على “Mainnet”. انقر فوق زر “عرض المفتاح” الخاص بالتطبيق على لوحة المعلومات ولاحظ عنوان URL لـ HTTP ومفتاح API.

سيكون عنوان URL بهذا الشكل: https://eth-mainnet.g.alchemy.com/v2/xxxxxxxxx

الخطوة 3: إنشاء مشروع العقدة

تتضمن الخطوة التالية تهيئة مستودع فارغ وتثبيت تبعيات Node.js المطلوبة. بالنسبة لتفاعلات واجهة برمجة التطبيقات (API)، خاصة مع واجهة برمجة التطبيقات (Token API)، يحتاج المستخدمون إلى استخدام مجموعة تطوير برامج Alchemy (SDK)، على الرغم من أن Axios أو Fetch يمكن أن يكونا بمثابة بدائل مناسبة.

Axios هي مكتبة Javascript تستخدم لتقديم طلبات HTTP من العقد. Fetch API عبارة عن وحدة نمطية مضمنة في Node تسهل تقديم طلبات API ومعالجة الاستجابات على الخادم. Alchemy SDK هي مكتبة وظائف برنامج تدعم الوصول إلى نموذج البيانات والتقنيات الأساسية.

الرمز غير معطى:

سيقوم الكود بإنشاء مستودع “eth-balance”، والذي يحتوي على جميع الملفات والتبعيات، وسيتم كتابة الكود في ملف “main.js”.

الخطوة 4: احصل على أرصدة الرمز المميز للعنوان

لاسترداد أرصدة الرموز المميزة، يمكن للمستخدمين استخدام طريقة getTokenBalances، والتي تتطلب وسيطة واحدة: عنوان المحفظة الذي ترغب في الحصول على أرصدة الرموز المميزة له. بعد ذلك، يحتاج المستخدم إلى إضافة التعليمات البرمجية التالية إلى ملف main.js.

استخدم الأمر التالي لتشغيل البرنامج النصي:

سيتم عرض الإخراج على النحو التالي:

يعرض الكود أعلاه أرصدة الرموز المميزة للمحفظة على العنوان 0xd8da6bf26964af9d7eed9e03e53415d37aa96045، مع إدراج كل رمز مميز حسب عنوان العقد الخاص به بالإضافة إلى الرصيد المعني بتنسيق سداسي عشري.

ومع ذلك، فإن نتيجة الخطوة السابقة – التي تسرد عناوين العقود الرمزية والأرصدة في أصغر الوحدات – ليس من السهل فهمها. للحصول على معلومات تفصيلية عن الرمز المميز مثل الاسم والرمز والعدد العشري، يجب على المستخدمين استخدام طريقة getTokenMetadata. تقوم هذه الوظيفة – التي تتطلب عنوان العقد كمدخل – بتوصيل البيانات بتنسيق منظم.

علاوة على ذلك، يمكن للمستخدمين تحسين البرنامج النصي الخاص بهم لدمج getTokenBalances مع أسلوب getTokenMetadata. على سبيل المثال، يمكنهم التخلص من الرموز المميزة للرصيد الصفري وتحويل أرصدة الرموز المميزة إلى نماذج يمكن قراءتها بواسطة الإنسان.

دليل خطوة بخطوة لاستخدام Moralis للعثور على جميع رموز ERC-20 المملوكة لعنوان ما

لدى Moralis واجهات برمجة تطبيقات Web3 على مستوى المؤسسات، مما يسهل تكامل Web3 في أي حزمة تقنية. فيما يلي عملية استخدام Moralis للعثور على جميع رموز ERC-20 المملوكة للعنوان:

الخطوة 1: إعداد موراليس

قم بتثبيت Node.js v14+ وNPM. قم بفك الملف الثنائي إلى مجلد التثبيت وقم بتعيين متغير بيئة النظام لـ Node. يقوم الأمر npm-install بإعداد حزمة NPM وأي حزم أخرى قد تعتمد عليها.

قم بإنشاء حساب Moralis مجاني، وقم بتسجيل الدخول إلى لوحة معلومات Moralis واحصل على مفتاح API. يمكن للمستخدمين العثور عليه في الإعدادات> الأسرار. هنا، يجب على المستخدمين تحديد موقع “مفتاح Web3 API – الافتراضي” أو مفتاح مسمى مشابه ونسخ قيمته لاستخدامه في مشاريعهم.

الخطوة 2: ابحث عن جميع رموز ERC-20 المملوكة للعنوان

يوفر Moralis نقطة نهاية “getWalletTokenBalances” للعثور على جميع رموز ERC-20 المملوكة للعنوان. يتطلب معلمتين: العنوان والسلسلة. في هذا السياق، يمثل العنوان عنوان المحفظة المحدد الذي يتم الاستعلام عنه لأرصدة الرموز المميزة. تشير السلسلة إلى شبكة blockchain المحددة، مثل Ethereum، التي يتم الاحتفاظ بهذه الرموز المميزة عليها.

إليك كود جافا سكريبت الذي يجب استخدامه:

يقوم الكود أعلاه بتهيئة Moralis SDK، وإعداده باستخدام مفتاح API المقدم، ثم الاستعلام عن جميع أرصدة الرموز المميزة ERC-20 المرتبطة بعنوان محفظة Ethereum محدد، وطباعة النتائج بتنسيق JSON على وحدة التحكم.

الخطوة 3: تشغيل البرنامج النصي

الآن، يمكن للمستخدمين تشغيل البرنامج النصي والعثور على عدد الرموز المميزة. في JavaScript، يحتاج المستخدمون إلى إدخال الأمر التالي:

ستعرض المحطة استجابة JSON أدناه:

يوضح مقتطف JSON أعلاه تفاصيل مقتنيات رموز ERC-20 في محفظة blockchain محددة تضم رمزين: ApeCoin (APE) وWrapped Ether (WETH). يتضمن معلومات أساسية مثل عناوين العقود والأسماء والرموز وعناوين URL للشعار (عند توفرها)، والدقة العشرية، وأرصدة الرموز المميزة داخل المحفظة، معبرًا عنها بأصغر فئة من كل رمز مميز.