عن المشروع

## ما هو FlashLoanArbitrage (المنشور تحت اسم المستودع flashloan-data-analyzer) هو أداة سطر أوامر Node.js للتحكيم في العملات الرقمية باستخدام القروض السريعة (flash loans) في DeFi. يصف ملف README نصاً محلياً واحداً، `goflash.js`، يعمل على جهاز المستخدم ويتفاعل مع عقد ذكي يُقال إنه يقوم بالاقتراض والتداول والسداد ضمن معاملة واحدة. ## كيف يعمل، حسب التوثيق 1. يوصف النص بأنه يقوم بمسح أسعار ETH/USDC كل 60 ثانية تقريباً عبر خمسة مصادر: Chainlink (المستخدم كأوراكل أساسي)، Uniswap V2، SushiSwap، Curve Finance و Balancer. 2. ينتظر وجود فرق في السعر بنسبة 0.9% على الأقل (عتبة تبدو قابلة للتكوين ولكن README يعرضها كقيمة ثابتة) قبل اتخاذ أي إجراء، وإلا يستمر في الانتظار لتجنب الخسائر. 3. عند التفعيل، يوصف العقد بأنه يأخذ قرضاً سريعاً بعملة USDC، ويقوم مسبقاً بتحويل ETH الخاص بالمستخدم إلى USDC، ثم يشتري ETH من المنصة الأرخص، ويبيعه في المنصة الأغلى، ويسدد القرض والرسوم، ثم يحول الربح مرة أخرى إلى ETH. ## مزودو القروض السريعة المدرجون - Aave — رسوم 0.05%، سيولة تصل إلى 10,000,000 USDC - dYdX — رسوم 0.05%، تصل إلى 500,000 USDC - Uniswap V3 — رسوم 0.01%، تصل إلى 5,000,000 USDC - Balancer — رسوم 0.02%، تصل إلى 1,000,000 USDC يوصي ملف README باستخدام dYdX أو Uniswap V3 لرسوم أقل، ويحذر من أن القروض الأكبر تعني رسوماً أكبر. ## التشغيل قم بتنزيل `goflash.js` و `package.json` ووضعهما في مجلد، ثم قم بتشغيل `npm install` وبعد ذلك `node goflash.js`. التبعيات المدرجة هي `ethers` ^6.11.1 و `inquirer` ^8.2.6 و `chalk` ^4.1.2. عند التشغيل الأول، يطلب النص إما إنشاء محفظة جديدة أو استيراد محفظة موجودة عبر مفتاح خاص. في كلتا الحالتين، يتم حفظ المفتاح في `wallet.json` في نفس المجلد، ثم تقدم قائمة خيارات: اختيار بروتوكول DeFi، تحديد مبلغ القرض بـ ETH (من 10 حتى الحد الأقصى للبروتوكول)، إعادة إنشاء المحفظة، استيراد المحفظة، بدء التحكيم، أو الخروج. يتم عرض رصيد المحفظة وعنوانها في ترويسة القائمة. ## ملاحظات تشغيلية من README - يجب دفع رسوم الغاز (Gas) بعملة ETH؛ يقترح README رصيداً لا يقل عن 0.1 ETH للقروض التي تزيد عن 10 ETH. - التكاليف المذكورة هي رسوم التداول (0.1%)، والانزلاق السعري (0.05%)، والغاز، ورسوم القرض السريع. - يغطي استكشاف الأخطاء وإصلاحها أخطاء تنسيق الوحدات، والمفاتيح الخاصة غير الصحيحة، وعدم كفاية الأموال للغاز، وإعادة الاتصال بـ RPC، وفقدان أزواج ETH/USDC في إحدى المنصات. ## تحذيرات تجب معرفتها - يذكر ملف README نفسه أن فروق الأسعار بنسبة 0.9% نادرة في الأسواق الحقيقية، وأن النص "يعرض فرصة محاكاة أحياناً لأغراض العرض". وهذا يعني أن الفرص المعروضة ليست بالضرورة قابلة للتنفيذ أو حقيقية. - يتم تخزين المفتاح الخاص بنص صريح في `wallet.json`؛ ينصح README بإضافة هذا الملف إلى `.gitignore` وعدم مشاركته أبداً. ومع ذلك، فإن تشغيل هذا البرنامج على محفظة تحتوي على أموال حقيقية ينطوي على مخاطر واضحة تتعلق بحفظ المفاتيح. - على الرغم من أن README يشير مراراً إلى عقد ذكي ويعرض شجرة المشروع، إلا أن الهيكل المدرج يحتوي فقط على `goflash.js` و `package.json` و `wallet.json` و `README.md`؛ لذا فإن مصدر العقد غير موثق كجزء من المستودع. - لا توجد اختبارات، أو ملفات تكوين، أو شروط ترخيص بخلاف "تمت مشاركته كما هو لأغراض تعليمية"، أو تعليمات لتكوين الرسوم. - يذكر وصف المستودع تحليل بيانات السوق برؤى القروض السريعة، وهو ما يتطابق مع جزء مسح الأسعار في README بدلاً من ادعاءات تنفيذ التداول.