Generador de Mnemónicos Milk Sad

Esta herramienta está diseñada para generar frases mnemónicas BIP-39 (frases semilla de 24 palabras) basadas en marcas de tiempo Unix, explorando específicamente frases que podrían generarse a través de la vulnerabilidad "Milk Sad" (CVE_2023-39910).

Qué Hace Esta Herramienta

El Generador de Mnemónicos Milk Sad crea frases mnemónicas BIP-39 de 24 palabras utilizando marcas de tiempo Unix como fuente de entropía. Su objetivo es generar todas las posibles frases semilla que podrían haberse producido debido al defecto específico de recopilación de entropía basada en marcas de tiempo asociado con la vulnerabilidad "Milk Sad".

Características Principales:

Genera mnemónicos BIP-39 de 24 palabras.
Soporta múltiples listas de palabras en varios idiomas (inglés, español, japonés, francés, italiano, portugués, coreano, ruso, ucraniano, checo, chino simplificado, chino tradicional).
Puede generar para fechas específicas, rangos de fechas o el rango completo de marcas de tiempo de 32 bits.
Guarda el progreso automáticamente y puede reanudar generaciones interrumpidas.

Instalación

Tienes dos opciones para instalar y ejecutar en tu sistema:

Opción 1: Usar el Script `install.sh`

Este script automatiza el proceso de compilación y maneja las dependencias comunes para sistemas Linux basados en Debian/Ubuntu.

Abre tu terminal y navega al directorio raíz del proyecto:
```
cd MilkSad-Mnemonic-Generator
```
Haz que el script sea ejecutable:
```
chmod +x install.sh
```
Ejecuta el script de instalación:
```
./install.sh
```
El script verificará si existen las herramientas de compilación necesarias (como g++, make, qmake, libssl-dev, libqt5widgets5-dev). Si falta alguna, intentará instalarlas (solicitando tu contraseña de sudo si es necesario). Tras configurar correctamente las dependencias, compilará tanto las aplicaciones CLI como GUI y las colocará directamente en el directorio raíz del proyecto.

Opción 2: Compilación Manual

Si prefieres compilar las aplicaciones tú mismo, sigue estos pasos manuales:

Requisitos Previos:

Asegúrate de tener instalados los siguientes paquetes de desarrollo en tu sistema Debian/Ubuntu:

g++ (normalmente parte del paquete build-essential)
make (también parte de build-essential)
qmake (proporcionado por qt5-qmake o qtbase5-dev)
libssl-dev (esencial para las funciones criptográficas utilizadas por la herramienta)
libqt5widgets5-dev (requerido para el desarrollo de GUI Qt; este paquete suele incluir qtbase5-dev)

Puedes instalar estos requisitos usando:

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

Compilar la Aplicación CLI:

Navega al directorio fuente de la CLI:
```
cd src/cli
```

Compila la aplicación usando g++:

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

Mueve el ejecutable CLI compilado a la raíz del proyecto:
```
mv milk_sad_generator ../../
```
Vuelve a la raíz del proyecto:
```
cd ../..
```

Compilar la Aplicación GUI:

Navega al directorio fuente de la GUI:
```
cd src/gui
```
Ejecuta qmake para generar el Makefile del proyecto Qt:
```
qmake mnemonic_generator.pro
```
Compila la aplicación GUI usando make:
```
make
```
Mueve el ejecutable GUI compilado a la raíz del proyecto:
```
mv milk_sad_generator_gui ../../
```
Vuelve a la raíz del proyecto:
```
cd ../..
```
Mueve la carpeta Pic/: Para que la GUI encuentre correctamente su imagen de fondo, debes mover la carpeta Pic/ desde src/gui/ a la raíz del proyecto:
```
mv src/gui/Pic .
```

Cómo Usar La Herramienta

Una vez instalado, encontrarás dos ejecutables directamente en el directorio raíz de tu proyecto: ./milk_sad_generator (la versión de interfaz de línea de comandos) y ./milk_sad_generator_gui (la versión de interfaz gráfica de usuario).

Inicia el programa:

./milk_sad_generator_gui  # Para lanzar la aplicación GUI
# O
./milk_sad_generator      # Para lanzar la aplicación CLI

Selecciona el idioma de la frase mnemónica entre las opciones presentadas (por ejemplo, inglés, español, japonés).
Elige uno de los tres modos de generación disponibles:

Opción 1: Marca de Tiempo Única (Para Pruebas)

Este modo genera una única frase mnemónica de 24 palabras para una fecha y hora precisas que tú especifiques.

Ejemplo de Uso:
- Introduce fecha/hora: 1970-01-01 00:00:00 para la primera marca de tiempo. Si eliges inglés, generará el mnemónico "milk sad ...".
- Salida: Se generará una única frase mnemónica y se guardará en mnemonic_[language].txt.

Opción 2: Rango de Fechas

Este modo genera mnemónicos para cada marca de tiempo dentro de un rango de fechas de inicio y fin especificado.

Ejemplo de Uso:
- Introduce el rango de fechas: 2017-01-01:2018-12-31 (Esto generará mnemónicos para todas las marcas de tiempo entre el 1 de enero de 2017 y el 31 de diciembre de 2018, inclusive).
- Salida: Todos los mnemónicos generados para el rango especificado se guardarán en mnemonics_range_[language].txt.
- El progreso se guarda automáticamente cada 100.000 marcas de tiempo. Esta función te permite detener la generación de forma segura (por ejemplo, presionando Ctrl+C) y reanudarla más tarde sin perder el progreso.

Opción 3: Rango Completo

Este modo genera todos los mnemónicos posibles en todo el rango de marcas de tiempo Unix de 32 bits (desde el 1 de enero de 1970 hasta el 19 de enero de 2038).

ADVERTENCIA: El archivo de salida generado por esta opción puede ser extremadamente grande (potencialmente de 300-600 GB). Asegúrate de tener una cantidad significativa de espacio libre en disco antes de iniciar este modo y prueba primero con rangos más pequeños.
Salida: Todos los mnemónicos se guardarán en all_mnemonics_[language].txt.
El progreso se guarda periódicamente. Ten en cuenta que este proceso de generación puede tardar días en completarse, dependiendo del rendimiento de tu sistema.

Archivos de Salida

Generación de un solo mnemónico: mnemonic_[language].txt
Generación por rango de fechas: mnemonics_range_[language].txt
Generación de rango completo: all_mnemonics_[language].txt
Archivos de progreso (para reanudar): generation_progress_range.bin (para la Opción 2) / generation_progress_full.bin (para la Opción 3)

Notas Importantes

La herramienta realiza todos los cálculos de marcas de tiempo usando UTC (Tiempo Universal Coordinado).
Para generaciones a gran escala, particularmente con la opción de "Rango Completo", es crucial asegurarse de tener suficiente espacio en disco disponible.
Puedes detener una generación en cualquier momento de forma segura presionando Ctrl+C. La herramienta guardará automáticamente su progreso actual.
Al completar exitosamente un modo de generación, el archivo de progreso .bin correspondiente se eliminará automáticamente.

Reanudar la Generación Después de una Pausa

Si tuviste que detener un proceso de generación (por ejemplo, usando Ctrl+C), puedes reanudarlo sin problemas desde donde lo dejaste:

MilkSad-Mnemonic-Generator

Más Populares