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.

1. Abre tu terminal y navega al directorio raíz del proyecto:
   root@kitploit:~

   cd MilkSad-Mnemonic-Generator
   

2. Haz que el script sea ejecutable:
   root@kitploit:~

   chmod +x install.sh
   

3. Ejecuta el script de instalación:
   root@kitploit:~

   ./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:

1. Navega al directorio fuente de la CLI:
   root@kitploit:~

   cd src/cli
   

2. Compila la aplicación usando g++:
   root@kitploit:~

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

3. Mueve el ejecutable CLI compilado a la raíz del proyecto:
   root@kitploit:~

   mv milk_sad_generator ../../
   

4. Vuelve a la raíz del proyecto:
   root@kitploit:~

   cd ../..
   

Compilar la Aplicación GUI:

1. Navega al directorio fuente de la GUI:
   root@kitploit:~

   cd src/gui
   

2. Ejecuta qmake para generar el Makefile del proyecto Qt:
   root@kitploit:~

   qmake mnemonic_generator.pro
   

3. Compila la aplicación GUI usando make:
   root@kitploit:~

   make
   

4. Mueve el ejecutable GUI compilado a la raíz del proyecto:
   root@kitploit:~

   mv milk_sad_generator_gui ../../
   

5. Vuelve a la raíz del proyecto:
   root@kitploit:~

   cd ../..
   

6. 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:
   root@kitploit:~

   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).

1. Inicia el programa:
   root@kitploit:~

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

2. Selecciona el idioma de la frase mnemónica entre las opciones presentadas (por ejemplo, inglés, español, japonés).
3. 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

1. La herramienta realiza todos los cálculos de marcas de tiempo usando UTC (Tiempo Universal Coordinado).
2. Para generaciones a gran escala, particularmente con la opción de "Rango Completo", es crucial asegurarse de tener suficiente espacio en disco disponible.
3. Puedes detener una generación en cualquier momento de forma segura presionando Ctrl+C. La herramienta guardará automáticamente su progreso actual.
4. 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:

• Para la generación por Rango de Fechas (Opción 2):

  • Simplemente ejecuta el programa nuevamente y selecciona la Opción 2.
  • Introduce el mismo rango de fechas exacto que usaste anteriormente.
  • La herramienta detectará automáticamente el archivo generation_progress_range.bin y continuará generando desde la última marca de tiempo guardada.

• Para la generación de Rango Completo (Opción 3):

  • Ejecuta el programa nuevamente y selecciona la Opción 3.
  • La herramienta localizará automáticamente el archivo generation_progress_full.bin y reanudará la generación desde el punto donde fue interrumpida.

Consideraciones Importantes para Reanudar:

• NO elimines los archivos de progreso .bin (generation_progress_range.bin o generation_progress_full.bin) si tienes intención de reanudar una generación.
• Los archivos de progreso se eliminan automáticamente solo cuando el proceso de generación se completa con éxito.
• Si deseas iniciar una generación desde cero (ignorando el progreso anterior), debes eliminar manualmente el archivo de progreso .bin correspondiente y renombrar/eliminar/mover cualquier archivo de salida existente (mnemonics_range_[language].txt o all_mnemonics_[language].txt) de ejecuciones anteriores antes de iniciar el programa nuevamente.
• Ten en cuenta que si inicias una generación de "Rango de Fechas" (Opción 2) con un rango de fechas diferente, o una generación de "Rango Completo" (Opción 3) con el mismo idioma donde ya existe un archivo all_mnemonics_[language].txt, el archivo de progreso .bin se sobrescribirá y los nuevos mnemónicos se añadirán al archivo de salida existente.

Ejemplo de Salida

Aquí tienes un ejemplo de una frase mnemónica BIP-39 de 24 palabras generada por esta herramienta:

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

Para fines de verificación o consulta rápida, el directorio tests/ de este repositorio contiene ejemplos de frases mnemónicas generadas en varios idiomas para la marca de tiempo 1970-01-01 00:00:00 UTC.

Generar Direcciones de Bitcoin a Partir de Mnemónicos

Para convertir las frases mnemónicas generadas en direcciones de Bitcoin (compatibles con los formatos P2PKH, P2SH-P2WPKH y P2WPKH), puedes usar esta herramienta:

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

Soporte

Si encontraste útil este proyecto y deseas animarme a crear más herramientas como esta, considera donar:

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