Генератор мнемонических фраз 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.

Откройте терминал и перейдите в корневой каталог проекта:
```
cd MilkSad-Mnemonic-Generator
```
Сделайте скрипт исполняемым:
```
chmod +x install.sh
```
Запустите скрипт установки:
```
./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-приложения:

Перейдите в каталог исходного кода CLI:
```
cd src/cli
```

Скомпилируйте приложение с помощью g++:

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

Переместите скомпилированный исполняемый файл CLI в корень проекта:
```
mv milk_sad_generator ../../
```
Вернитесь в корень проекта:
```
cd ../..
```

Компиляция GUI-приложения:

Перейдите в каталог исходного кода GUI:
```
cd src/gui
```
Запустите qmake, чтобы сгенерировать Makefile для проекта Qt:
```
qmake mnemonic_generator.pro
```
Скомпилируйте GUI-приложение с помощью make:
```
make
```
Переместите скомпилированный исполняемый файл GUI в корень проекта:
```
mv milk_sad_generator_gui ../../
```
Вернитесь в корень проекта:
```
cd ../..
```
Переместите папку Pic/: чтобы GUI правильно находил своё фоновое изображение, необходимо переместить папку Pic/ из src/gui/ в корень проекта:
```
mv src/gui/Pic .
```

Как использовать инструмент

После установки вы найдёте два исполняемых файла непосредственно в корневом каталоге проекта: ./milk_sad_generator (версия с интерфейсом командной строки) и ./milk_sad_generator_gui (версия с графическим интерфейсом).

Запустите программу:

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

Выберите язык мнемонической фразы из представленных вариантов (например, английский, испанский, японский).
Выберите один из трёх доступных режимов генерации:

Вариант 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)

Важные замечания

Инструмент выполняет все расчёты меток времени с использованием UTC (всемирного координированного времени).
Для крупномасштабных генераций, особенно в режиме «Полный диапазон», крайне важно обеспечить достаточное свободное место на диске.
Вы можете безопасно остановить генерацию в любой момент, нажав Ctrl+C. Инструмент автоматически сохранит текущий прогресс.
После успешного завершения режима генерации соответствующий файл прогресса .bin будет автоматически удалён.

Возобновление генерации после паузы

Если вам пришлось остановить процесс генерации (например, с помощью Ctrl+C), вы можете без проблем возобновить его с того места, где остановились:

Для генерации диапазона дат (Вариант 2):
- Просто запустите программу снова и выберите Вариант 2.
- Введите точно такой же диапазон дат, который вы использовали ранее.
- Инструмент автоматически обнаружит файл generation_progress_range.bin и продолжит генерацию с последней сохранённой метки времени.

MilkSad-Mnemonic-Generator

Популярное