Генератор мнемонических фраз Milk Sad

Этот инструмент предназначен для генерации BIP-39 мнемонических фраз (сид-фраз из 24 слов) на основе меток времени Unix, а именно для поиска фраз, которые могли быть сгенерированы через уязвимость «Milk Sad» (CVE_2023-39910).

Что делает этот инструмент

Генератор мнемонических фраз Milk Sad создаёт 24-словные BIP-39 мнемонические фразы, используя метки времени Unix в качестве источника энтропии. Его цель — сгенерировать все возможные сид-фразы, которые могли быть получены из-за конкретного дефекта сбора энтропии на основе меток времени, связанного с уязвимостью «Milk Sad».

Ключевые возможности:

• Генерирует 24-словные BIP-39 мнемоники.
• Поддерживает несколько языковых списков слов (английский, испанский, японский, французский, итальянский, португальский, корейский, русский, украинский, чешский, упрощённый китайский, традиционный китайский).
• Может генерировать для конкретных дат, диапазонов дат или всего 32-битного диапазона меток времени.
• Автоматически сохраняет прогресс и может возобновлять прерванные генерации.

Установка

У вас есть два варианта установки и запуска на вашей системе:

Вариант 1: использование скрипта install.sh

Этот скрипт автоматизирует процесс компиляции и обрабатывает общие зависимости для Linux-систем на базе Debian/Ubuntu.

1. Откройте терминал и перейдите в корневой каталог проекта:
   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 GUI; этот пакет часто включает 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 будет перезаписан, а новые мнемоники будут добавлены в конец существующего выходного файла.

Пример выходных данных

Вот пример 24-словной BIP-39 мнемонической фразы, сгенерированной этим инструментом:

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

Поддержка

Если вы нашли этот проект полезным и хотите поддержать меня в создании подобных инструментов, рассмотрите возможность пожертвования:

• Bitcoin (BTC): bc1qg7xmlsdxfgu3muxherh4eee2ywj3gz8qfgct3s
• Ethereum (ETH): 0x1B449E1D545bD0dc50f361d96706F6C904553929
• Solana (SOL): F776tt1it7vifCzD9icrsby3ujkZdJ8EY9917GUM3skr
• Tron (TRX): TJj96B4SukPJSC4M2FyssoxduVyviv9aGr
• Polygon (POL): 0x1B449E1D545bD0dc50f361d96706F6C904553929
• Monero (XMR): 48aaDb1g4Ms7PB3WMj6ttbMWuEwe171d6Yjao59uFJR38tHa75nKwPqYoPAYmWZPUhXmDbDvqtE6d2FX3YaF1dVE7zhD9Dt