استكشاف أصول إثيريوم: كيفية البحث عن جميع عملات ERC-20 في المحفظة

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

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

ستتناول هذه المقالة بالتفصيل ثلاثة خدمات API رئيسية - Chainbase وAlchemy وMoralis، حيث تقدم كل منها حلولاً متخصصة للاستعلام عن عملة ERC-20 لعناوين محددة. سنعرض بطريقة صديقة للمطورين كيفية تحقيق وظيفة استعلام الأصول من خلال هذه الأدوات.

Chainbase: الخيار الفعال لاستعلام بيانات البلوكتشين

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

إعدادات الحساب والأعمال التحضيرية

1. إنشاء حساب والحصول على مفتاح API

   • زيارة موقع Chainbase للتسجيل في حساب مجاني
   • بعد تسجيل الدخول، ادخل إلى وحدة التحكم، وأنشئ مشروعًا جديدًا
   • احصل على وحفظ مفتاح API ، وهو شهادة ضرورية للاستفسارات اللاحقة

2. إعداد بيئة التطوير

   • تأكد من أن بيئة التطوير الخاصة بك قد قامت بتثبيت Node.js
   • استخدم npm لتثبيت مكتبة Axios: npm install axios --save

تنفيذ وظيفة الاستعلام

استخدام JavaScript للتفاعل مع واجهة برمجة التطبيقات Chainbase للحصول على رصيد عملة ERC-20 للعناوين المحددة:

جافا سكريبت const axios = require('axios');

الدالة غير المتزامنة getERC20Tokens() { حاول { استجابة CONST = انتظار axios.get( ' { المعلمات: { chain_id: '1', // شبكة الإيثيريوم الرئيسية العنوان: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', // مثال على العنوان الحد: 5 // إرجاع أول 5 عملات }, رؤوس: { 'x-api-key': 'مفتاح API الخاص بك' // استبدل بمفتاحك الفعلي } } ); console.log(JSON.stringify(response.data, null, 2)); } قبض على (error) { console.error('فشل الاستعلام:', error); } }

getERC20Tokens().

عرض نتائج الاستعلام

بعد تشغيل البرنامج النصي، سترى استجابة JSON مشابهة لما هو موجود أدناه، تعرض تفاصيل عملات ERC-20 التي يمتلكها العنوان المحدد:

{ "البيانات": [ { "chain_id": "1", "العنوان": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "عنوان العقد": "0xc00e94cb662c3520282e6f5717214004a7f26888", "الاسم": "المركب", "رمز": "COMP", "الكسور العشرية": 18, "الرصيد": "10472650474472796",} "balance_in_usd": 0.71 }, ...مزيد من معلومات العملة... ] }

تحتوي بيانات الاستجابة على معلومات أساسية مثل عنوان العقد واسم العملة ورمزها وعدد المنازل العشرية والرصيد والقيمة بالدولار لكل عملة.

Alchemy: منصة تطوير البلوكتشين الاحترافية

Alchemy هي منصة رائدة في مجال تطوير البلوكتشين، تقدم أدوات API قوية لقراءة وكتابة بيانات البلوكتشين. فيما يلي الخطوات التفصيلية لاستعلام عن رصيد عملة ERC-20 من خلال Alchemy:

إعداد البيئة وإعداد الحساب

1. تثبيت الأدوات اللازمة

   • تثبيت Node.js و NPM
   • إنشاء مجلد المشروع وت初始化 البيئة

2. الحصول على شهادات وصول Alchemy

   • تسجيل حساب Alchemy
   • إنشاء تطبيق جديد، اختر شبكة الإيثيريوم الرئيسية
   • حفظ عنوان URL الخاص بالتطبيق ومفتاح API

إعداد المشروع والتطوير

إنشاء هيكل المشروع وتثبيت الاعتماديات:

باش mkdir ETH - التوازن cd رصيد الإيثيريوم npm init -y npm تثبيت Alchemy-SDK المس main.js

اكتب كود الاستعلام في ملف main.js:

جافا سكريبت const { Alchemy, Network } = require("alchemy-sdk");

// تكوين معلمات الوصول const config = { apiKey: "مفتاح API الخاص بك", الشبكة: Network.ETH_MAINNET };

كيمياء const = Alchemy(config) جديدة ؛ عنوان const = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" ؛

// الحصول على رصيد العملة الدالة غير المتزامنة getTokenBalances() { const balances = await alchemy.core.getTokenBalances(address); console.log( "بيانات رصيد الرمز المميز:" ); console.log(balances);

// معالجة عملة الرصيد غير الصفري const nonZeroBalances = balances.tokenBalances.filter(token => { return token.tokenBalance !== "0"; });

console.log( يمتلك هذا العنوان ${nonZeroBalances.length} نوع من ERC-20 عملة ذات رصيد غير صفري);

// الحصول على معلومات أكثر تفصيلاً عن العملة من (let توكن من غيرصفر الأرصدة ) { const metadata = await alchemy.core.getTokenMetadata(token.contractAddress); console.log( الرمز: ${metadata.name}); console.log(الرمز: ${metadata.symbol}); console.log(Balance: ${token.tokenBalance / Math.pow(10, metadata.decimals)}); console.log("-----"); } }

getTokenBalances().

تشغيل الاستعلام وتحليل النتائج

تنفيذ البرنامج النصي لرؤية النتائج:

باش main.js العقدة

ستعرض نتائج الاستعلام معلومات مفصلة عن العملة، بما في ذلك:

• اسم العملة والرمز
• عنوان العقد
• كمية الرصيد بعد التنسيق
• عملة بيانات التعريف (مثل عدد الأرقام العشرية)

تتمثل مزايا Alchemy في أنها لا توفر فقط استعلامات الرصيد الأساسية، ولكنها تدعم أيضًا الحصول على البيانات الوصفية، وتصنيف العملات، وتنسيق الرصيد، مما يمكن المطورين من بناء وظائف إدارة الأصول الكاملة بسهولة.

Moralis: خدمة واجهة برمجة التطبيقات Web3 على مستوى المؤسسات

يوفر Moralis مجموعة أدوات واجهة برمجة التطبيقات Web3 الشاملة، مما يساعد المطورين على دمج وظائف البلوكتشين بسهولة. خطوات استخدام Moralis للاستعلام عن رصيد عملة ERC-20 هي كما يلي:

العمل التحضيري المسبق

1. تكوين البيئة

   • تثبيت Node.js v14+ و NPM
   • تعيين متغيرات بيئة النظام

2. الحصول على مفتاح API

   • إنشاء حساب Moralis
   • بعد تسجيل الدخول، انتقل إلى "الإعدادات" > "السر" للعثور على "مفتاح واجهة برمجة التطبيقات Web3"
   • نسخ المفتاح للاحتياط

تنفيذ الشيفرة

إنشاء ملف JavaScript جديد، وكتابة الكود التالي:

جافا سكريبت const Moralis = require("moralis").default;

// تهيئة Moralis الدالة غير المتزامنة initMoralis() { await Moralis.start({ apiKey: "مفتاح API الخاص بك" }); }

// استعلام عن العملات في المحفظة الدالة غير المتزامنة fetchWalletTokens() { انتظر initMoralis().

حاول { عنوان const = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" ؛

const response = await Moralis.EvmApi.token.getWalletTokenBalances({
  العنوان: العنوان,
  chain: "0x1" // شبكة الإيثريوم الرئيسية
});

console.log(JSON.stringify(response.toJSON(), فارغ, 2));

} (e) الصيد { console.error(e); } }

fetchWalletTokens().

تنفيذ الاستعلام وتحليل النتائج

تشغيل البرنامج النصي للحصول على النتائج:

باش moralis-tokens.js العقدة

مثال على نتيجة الاستعلام:

جي سون [ { "token_address": "0x4d224452801aced8b2f0aebe155379bb5d594381", "الاسم": "ApeCoin", "symbol": "APE", "الشعار": "", "الصورة المصغرة": "", "الكسور العشرية": 18, "الرصيد": "5000000000000000000" }, { "token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "الاسم": "الأثير الملفوف", "رمز": "WETH", "الشعار": null, "الصورة المصغرة": null, "الكسور": 18, "الرصيد": "7050000000000000000" } ]

تقدم استجابة Moralis API معلومات كاملة عن العملات، بما في ذلك الاسم، الرمز، عنوان العقد، URL الشعار والرصيد المعبر عنه بوحدات العملة الدنيا. يمكن استخدام هذه البيانات مباشرة لتطوير تطبيقات إدارة الأصول، أدوات تحليل المحافظ أو أنظمة تصور بيانات البلوكتشين.

مقارنة ميزات خدمات API

| الميزات | قاعدة السلسلة | الكيمياء | موراليس | |---------|----------|---------|---------| | الحد الأقصى المجاني | عدد الطلبات المحدودة | يوجد حزمة مجانية | يوجد مستوى مجاني | | سرعة الاستعلام | سريع | سريع جدًا | سريع | | بيانات العملة | دعم | دعم تفصيلي | دعم شامل | | البيانات التاريخية | دعم جزئي | دعم | دعم | | سهولة الاستخدام | مرتفعة | متوسطة | عالية | | التطبيقات المناسبة | استعلامات أساسية | تطوير محترف | تطبيقات الشركات |

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

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