مولّد عبارات الاسترداد (Milk Sad)

هذه الأداة مصممة لتوليد عبارات استرداد BIP-39 (عبارات أولية من 24 كلمة) استناداً إلى طوابع Unix الزمنية، مع التركيز بشكل خاص على استكشاف العبارات التي قد تُولَّد من خلال ثغرة "Milk Sad" (CVE_2023-39910).

ماذا تفعل هذه الأداة

يقوم مولّد عبارات الاسترداد (Milk Sad) بإنشاء عبارات BIP-39 من 24 كلمة من خلال استخدام طوابع Unix الزمنية كمصدر للإنتروبيا. ويهدف إلى توليد جميع عبارات الاسترداد الممكنة التي ربما أُنتجت بسبب الخلل المحدد في جمع الإنتروبيا المعتمد على الطابع الزمني والمرتبط بثغرة "Milk Sad".

الميزات الرئيسية:

• يولّد عبارات BIP-39 من 24 كلمة.
• يدعم قوائم كلمات متعددة اللغات (الإنجليزية، الإسبانية، اليابانية، الفرنسية، الإيطالية، البرتغالية، الكورية، الروسية، الأوكرانية، التشيكية، الصينية المبسطة، الصينية التقليدية).
• يمكنه التوليد لـتواريخ محددة، أو نطاقات تواريخ، أو نطاق الطابع الزمني 32-بت بالكامل.
• يحفظ التقدم تلقائياً ويمكنه استئناف التوليدات المتقطعة.

التثبيت

لديك خياران لتثبيت الأداة وتشغيلها على نظامك:

الخيار 1: استخدام سكربت install.sh

يعمل هذا السكربت على أتمتة عملية الترجمة (Compilation) ويتعامل مع الاعتماديات الشائعة لأنظمة لينكس القائمة على Debian/Ubuntu.

1. افتح الطرفية (Terminal) وانتقل إلى الدليل الجذر للمشروع:
   root@kitploit:~

   cd MilkSad-Mnemonic-Generator
   

2. اجعل السكربت قابلاً للتنفيذ:
   root@kitploit:~

   chmod +x install.sh
   

3. شغّل سكربت التثبيت:
   root@kitploit:~

   ./install.sh
   

   سيتحقق السكربت من أدوات البناء الضرورية (مثل g++، make، qmake، libssl-dev، libqt5widgets5-dev). إذا كان أي منها مفقوداً، فسيحاول تثبيتها (مع طلب كلمة مرور sudo إذا لزم الأمر). بعد إعداد الاعتماديات بنجاح، سيقوم بتجميع تطبيقي CLI وGUI ووضعهما مباشرة في الدليل الجذر للمشروع.

الخيار 2: الترجمة اليدوية

إذا كنت تفضل تجميع التطبيقات بنفسك، فاتبع هذه الخطوات اليدوية:

المتطلبات الأساسية:

تأكد من تثبيت حزم التطوير التالية على نظام Debian/Ubuntu لديك:

• g++ (عادةً جزء من حزمة build-essential)
• make (جزء أيضاً من build-essential)
• qmake (يوفَّر بواسطة qt5-qmake أو qtbase5-dev)
• libssl-dev (أساسي للدوال التشفيرية التي تستخدمها الأداة)
• libqt5widgets5-dev (مطلوب لتطوير واجهة Qt الرسومية؛ غالباً ما تتضمن هذه الحزمة qtbase5-dev)

يمكنك تثبيت هذه المتطلبات باستخدام:

sudo apt update
sudo apt install build-essential qt5-qmake libssl-dev qtbase5-dev

تجميع تطبيق CLI:

1. انتقل إلى دليل مصدر CLI:
   root@kitploit:~

   cd src/cli
   

2. قم بتجميع التطبيق باستخدام g++:
   root@kitploit:~

   g++ -std=gnu++11 -Wall -Wextra -O2 milk_sad_generator.cpp -o milk_sad_generator -lcrypto -lssl
   

3. انقل الملف التنفيذي CLI المُجمَّع إلى جذر المشروع:
   root@kitploit:~

   mv milk_sad_generator ../../
   

4. عد إلى جذر المشروع:
   root@kitploit:~

   cd ../..
   

تجميع تطبيق GUI:

1. انتقل إلى دليل مصدر GUI:
   root@kitploit:~

   cd src/gui
   

2. شغّل qmake لإنشاء ملف Makefile لمشروع Qt:
   root@kitploit:~

   qmake mnemonic_generator.pro
   

3. قم بتجميع تطبيق GUI باستخدام make:
   root@kitploit:~

   make
   

4. انقل الملف التنفيذي GUI المُجمَّع إلى جذر المشروع:
   root@kitploit:~

   mv milk_sad_generator_gui ../../
   

5. عد إلى جذر المشروع:
   root@kitploit:~

   cd ../..
   

6. انقل مجلد Pic/: لكي يتمكن تطبيق GUI من العثور على صورة الخلفية بشكل صحيح، يجب عليك نقل مجلد Pic/ من src/gui/ إلى جذر المشروع:
   root@kitploit:~

   mv src/gui/Pic .
   

كيفية استخدام الأداة

بعد التثبيت، ستجد ملفين تنفيذيين مباشرة في الدليل الجذر لمشروعك: ./milk_sad_generator (نسخة واجهة سطر الأوامر) و./milk_sad_generator_gui (نسخة الواجهة الرسومية).

1. شغّل البرنامج:
   root@kitploit:~

   ./milk_sad_generator_gui  # To launch the GUI application
   # OR
   ./milk_sad_generator      # To launch the CLI application
   

2. اختر لغة عبارة الاسترداد من الخيارات المعروضة (مثل الإنجليزية، الإسبانية، اليابانية).
3. اختر أحد أوضاع التوليد الثلاثة المتاحة:

الخيار 1: طابع زمني واحد (للاختبار)

يولّد هذا الوضع عبارة استرداد واحدة من 24 كلمة لتاريخ ووقت محدد تحدده أنت.

• مثال للاستخدام:
  • أدخل التاريخ/الوقت: 1970-01-01 00:00:00 للطابع الزمني الأول. إذا اخترت الإنجليزية، فسيولّد عبارة استرداد "milk sad ...".
  • المخرجات: سيتم توليد عبارة استرداد واحدة وحفظها في mnemonic_[language].txt.

الخيار 2: نطاق تواريخ

يولّد هذا الوضع عبارات استرداد لكل طابع زمني ضمن نطاق تاريخي محدد للبداية والنهاية.

• مثال للاستخدام:
  • أدخل نطاق التواريخ: 2017-01-01:2018-12-31 (سيؤدي هذا إلى توليد عبارات استرداد لجميع الطوابع الزمنية بين 1 يناير 2017 و31 ديسمبر 2018، شاملاً الطرفين.)
  • المخرجات: سيتم حفظ جميع عبارات الاسترداد المولّدة للنطاق المحدد في mnemonics_range_[language].txt.
  • يتم حفظ التقدم تلقائياً كل 100,000 طابع زمني. تتيح لك هذه الميزة إيقاف التوليد بأمان (مثل الضغط على Ctrl+C) واستئنافه لاحقاً دون فقدان التقدم.

الخيار 3: النطاق الكامل

يولّد هذا الوضع جميع عبارات الاسترداد الممكنة عبر نطاق الطابع الزمني 32-بت لنظام Unix بالكامل (من 1 يناير 1970 إلى 19 يناير 2038).

• تحذير: يمكن أن يكون ملف المخرجات الناتج عن هذا الخيار ضخماً للغاية (ربما 300-600 جيجابايت). تأكد من توفر مساحة كبيرة من القرص الحر قبل بدء هذا الوضع، واختبر بنطاقات أصغر أولاً.
• المخرجات: سيتم حفظ جميع عبارات الاسترداد في all_mnemonics_[language].txt.
• يتم حفظ التقدم بشكل دوري. انتبه إلى أن عملية التوليد هذه قد تستغرق أياماً لاكتمالها، اعتماداً على أداء نظامك.

ملفات المخرجات

• توليد عبارة استرداد واحدة: mnemonic_[language].txt
• توليد نطاق تواريخ: mnemonics_range_[language].txt
• توليد النطاق الكامل: all_mnemonics_[language].txt
• ملفات التقدم (لاستئناف التوليد): generation_progress_range.bin (للخيار 2) / generation_progress_full.bin (للخيار 3)

ملاحظات مهمة

1. تنفذ الأداة جميع حسابات الطوابع الزمنية باستخدام UTC (التوقيت العالمي المنسق).
2. بالنسبة للتوليدات واسعة النطاق، ولا سيما خيار "النطاق الكامل"، من الضروري التأكد من توفر مساحة كافية على القرص.
3. يمكنك إيقاف التوليد بأمان في أي وقت بالضغط على Ctrl+C. ستحفظ الأداة تلقائياً تقدمها الحالي.
4. عند اكتمال أحد أوضاع التوليد بنجاح، سيتم حذف ملف التقدم .bin المقابل تلقائياً.

استئناف التوليد بعد الإيقاف المؤقت

إذا اضطررت إلى إيقاف عملية توليد (مثل استخدام Ctrl+C)، يمكنك الاستئناف بسلاسة من حيث توقفت:

• لتوليد نطاق التواريخ (الخيار 2):

  • ما عليك سوى تشغيل البرنامج مرة أخرى واختيار الخيار 2.
  • أدخل نفس نطاق التواريخ تماماً الذي استخدمته سابقاً.
  • ستكتشف الأداة تلقائياً ملف generation_progress_range.bin وتواصل التوليد من آخر طابع زمني محفوظ.

• لتوليد النطاق الكامل (الخيار 3):

  • شغّل البرنامج مرة أخرى واختر الخيار 3.
  • ستحدد الأداة تلقائياً موقع ملف generation_progress_full.bin وتستأنف التوليد من النقطة التي توقف عندها.

اعتبارات مهمة للاستئناف:

• لا تحذف ملفات التقدم .bin (generation_progress_range.bin أو generation_progress_full.bin) إذا كنت تنوي استئناف التوليد.
• يتم حذف ملفات التقدم تلقائياً فقط عند اكتمال عملية التوليد بنجاح.
• إذا كنت ترغب في بدء التوليد من جديد من البداية تماماً (متجاهلاً التقدم السابق)، يجب عليك حذف ملف التقدم .bin المقابل يدوياً و إعادة تسمية/حذف/نقل أي ملف مخرجات موجود (mnemonics_range_[language].txt أو all_mnemonics_[language].txt) من التشغيلات السابقة قبل تشغيل البرنامج مرة أخرى.
• انتبه إلى أنه إذا بدأت توليد "نطاق تواريخ" (الخيار 2) بنطاق تواريخ مختلف، أو توليد "نطاق كامل" (الخيار 3) بنفس اللغة حيث يوجد بالفعل ملف all_mnemonics_[language].txt، فسيتم استبدال ملف التقدم .bin، وستتم إضافة عبارات الاسترداد الجديدة إلى ملف المخرجات الموجود.

مثال على المخرجات

فيما يلي مثال على عبارة استرداد BIP-39 من 24 كلمة تم توليدها بواسطة هذه الأداة:

vault alarm sad mass witness property virus style good flower rice alpha viable evidence run glare pretty scout evil judge offer refuse another breeze

لأغراض التحقق أو كمرجع سريع، يحتوي دليل tests/ في هذا المستودع على أمثلة لعبارات استرداد مولّدة بلغات مختلفة للطابع الزمني 1970-01-01 00:00:00 UTC.

توليد عناوين بيتكوين من عبارات الاسترداد

لتحويل عبارات الاسترداد المولّدة إلى عناوين بيتكوين (مع دعم صيغ P2PKH وP2SH-P2WPKH وP2WPKH)، يمكنك استخدام هذه الأداة:

• z1ph1us/btc-address-generator: https://github.com/z1ph1us/btc-address-generator

الدعم

إذا وجدت هذا المشروع مفيداً وترغب في تشجيعي على إنشاء المزيد من الأدوات المشابهة، فكر في التبرع:

• بيتكوين (BTC): bc1qg7xmlsdxfgu3muxherh4eee2ywj3gz8qfgct3s
• إيثيريوم (ETH): 0x1B449E1D545bD0dc50f361d96706F6C904553929
• سولانا (SOL): F776tt1it7vifCzD9icrsby3ujkZdJ8EY9917GUM3skr
• ترون (TRX): TJj96B4SukPJSC4M2FyssoxduVyviv9aGr
• بوليجون (POL): 0x1B449E1D545bD0dc50f361d96706F6C904553929
• مونيرو (XMR): 48aaDb1g4Ms7PB3WMj6ttbMWuEwe171d6Yjao59uFJR38tHa75nKwPqYoPAYmWZPUhXmDbDvqtE6d2FX3YaF1dVE7zhD9Dt