Gerador de Mnemônicos Milk Sad

Esta ferramenta foi projetada para gerar frases mnemônicas BIP-39 (frases-semente de 24 palavras) com base em timestamps Unix, explorando especificamente frases que poderiam ser geradas por meio da vulnerabilidade "Milk Sad" (CVE_2023-39910).

O que esta ferramenta faz

O Gerador de Mnemônicos Milk Sad cria frases mnemônicas BIP-39 de 24 palavras usando timestamps Unix como fonte de entropia. Ele tem como objetivo gerar todas as possíveis frases-semente que podem ter sido produzidas devido à falha específica de coleta de entropia baseada em timestamp associada à vulnerabilidade "Milk Sad".

Principais recursos:

• Gera mnemônicos BIP-39 de 24 palavras.
• Suporta listas de palavras em vários idiomas (inglês, espanhol, japonês, francês, italiano, português, coreano, russo, ucraniano, tcheco, chinês simplificado, chinês tradicional).
• Pode gerar para datas específicas, intervalos de datas ou todo o intervalo de timestamp de 32 bits.
• Salva o progresso automaticamente e pode retomar gerações interrompidas.

Instalação

Você tem duas opções para instalar e executar no seu sistema:

Opção 1: Usar o script install.sh

Este script automatiza o processo de compilação e lida com dependências comuns para sistemas Linux baseados em Debian/Ubuntu.

1. Abra seu terminal e navegue até o diretório raiz do projeto:
   root@kitploit:~

   cd MilkSad-Mnemonic-Generator
   

2. Torne o script executável:
   root@kitploit:~

   chmod +x install.sh
   

3. Execute o script de instalação:
   root@kitploit:~

   ./install.sh
   

   O script verificará as ferramentas de compilação necessárias (como g++, make, qmake, libssl-dev, libqt5widgets5-dev). Se alguma estiver faltando, ele tentará instalá-las (solicitando sua senha de sudo se necessário). Após configurar as dependências com sucesso, ele compilará os aplicativos CLI e GUI e os colocará diretamente no diretório raiz do projeto.

Opção 2: Compilação manual

Se você preferir compilar os aplicativos manualmente, siga estas etapas:

Pré-requisitos:

Certifique-se de ter os seguintes pacotes de desenvolvimento instalados no seu sistema Debian/Ubuntu:

• g++ (normalmente parte do pacote build-essential)
• make (também parte do build-essential)
• qmake (fornecido por qt5-qmake ou qtbase5-dev)
• libssl-dev (essencial para as funções criptográficas usadas pela ferramenta)
• libqt5widgets5-dev (necessário para o desenvolvimento de GUI Qt; este pacote geralmente inclui qtbase5-dev)

Você pode instalar esses pré-requisitos usando:

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

Compilar o aplicativo CLI:

1. Navegue até o diretório de código-fonte do CLI:
   root@kitploit:~

   cd src/cli
   

2. Compile o aplicativo usando g++:
   root@kitploit:~

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

3. Mova o executável CLI compilado para a raiz do projeto:
   root@kitploit:~

   mv milk_sad_generator ../../
   

4. Retorne à raiz do projeto:
   root@kitploit:~

   cd ../..
   

Compilar o aplicativo GUI:

1. Navegue até o diretório de código-fonte do GUI:
   root@kitploit:~

   cd src/gui
   

2. Execute qmake para gerar o Makefile do projeto Qt:
   root@kitploit:~

   qmake mnemonic_generator.pro
   

3. Compile o aplicativo GUI usando make:
   root@kitploit:~

   make
   

4. Mova o executável GUI compilado para a raiz do projeto:
   root@kitploit:~

   mv milk_sad_generator_gui ../../
   

5. Retorne à raiz do projeto:
   root@kitploit:~

   cd ../..
   

6. Mova a pasta Pic/: Para que o GUI encontre corretamente sua imagem de fundo, você deve mover a pasta Pic/ de src/gui/ para a raiz do projeto:
   root@kitploit:~

   mv src/gui/Pic .
   

Como Usar a Ferramenta

Após a instalação, você encontrará dois executáveis diretamente no diretório raiz do seu projeto: ./milk_sad_generator (a versão de Interface de Linha de Comando) e ./milk_sad_generator_gui (a versão de Interface Gráfica do Usuário).

1. Inicie o programa:
   root@kitploit:~

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

2. Selecione o idioma da frase mnemônica entre as opções apresentadas (por exemplo, inglês, espanhol, japonês).
3. Escolha um dos três modos de geração disponíveis:

Opção 1: Timestamp Único (Para Testes)

Este modo gera uma única frase mnemônica de 24 palavras para uma data e hora precisas que você especificar.

• Exemplo de uso:
  • Digite a data/hora: 1970-01-01 00:00:00 para o primeiro timestamp. Se o inglês for escolhido, ele gerará o mnemônico "milk sad ...".
  • Saída: Uma única frase mnemônica será gerada e salva em mnemonic_[language].txt.

Opção 2: Intervalo de Datas

Este modo gera mnemônicos para cada timestamp dentro de um intervalo de datas inicial e final especificado.

• Exemplo de uso:
  • Digite o intervalo de datas: 2017-01-01:2018-12-31 (Isso gerará mnemônicos para todos os timestamps entre 1º de janeiro de 2017 e 31 de dezembro de 2018, inclusive.)
  • Saída: Todos os mnemônicos gerados para o intervalo especificado serão salvos em mnemonics_range_[language].txt.
  • Progresso é salvo automaticamente a cada 100.000 timestamps. Esse recurso permite interromper a geração com segurança (por exemplo, pressionando Ctrl+C) e retomá-la depois sem perder o progresso.

Opção 3: Faixa Completa

Este modo gera todos os mnemônicos possíveis em todo o intervalo de timestamp Unix de 32 bits (de 1º de janeiro de 1970 a 19 de janeiro de 2038).

• AVISO: O arquivo de saída gerado por esta opção pode ser extremamente grande (potencialmente 300-600GB). Certifique-se de ter uma quantidade significativa de espaço livre em disco antes de iniciar este modo e teste primeiro com intervalos menores.
• Saída: Todos os mnemônicos serão salvos em all_mnemonics_[language].txt.
• Progresso é salvo periodicamente. Esteja ciente de que esse processo de geração pode levar dias para ser concluído, dependendo do desempenho do seu sistema.

Arquivos de Saída

• Geração de mnemônico único: mnemonic_[language].txt
• Geração por intervalo de datas: mnemonics_range_[language].txt
• Geração de faixa completa: all_mnemonics_[language].txt
• Arquivos de progresso (para retomada): generation_progress_range.bin (para a Opção 2) / generation_progress_full.bin (para a Opção 3)

Notas Importantes

1. A ferramenta realiza todos os cálculos de timestamp usando UTC (Tempo Universal Coordenado).
2. Para gerações em grande escala, especialmente a opção "Faixa Completa", é crucial garantir que você tenha espaço em disco suficiente disponível.
3. Você pode parar uma geração com segurança a qualquer momento pressionando Ctrl+C. A ferramenta salvará automaticamente o progresso atual.
4. Após a conclusão bem-sucedida de um modo de geração, o arquivo de progresso .bin correspondente será excluído automaticamente.

Retomando a Geração Após uma Pausa

Se você precisou interromper um processo de geração (por exemplo, usando Ctrl+C), você pode retomar perfeitamente de onde parou:

• Para geração por intervalo de datas (Opção 2):

  • Basta executar o programa novamente e selecionar a Opção 2.
  • Digite o mesmo intervalo de datas exato que você usou anteriormente.
  • A ferramenta detectará automaticamente o arquivo generation_progress_range.bin e continuará gerando a partir do último timestamp salvo.

• Para geração de faixa completa (Opção 3):

  • Execute o programa novamente e selecione a Opção 3.
  • A ferramenta localizará automaticamente o arquivo generation_progress_full.bin e retomará a geração a partir do ponto em que foi interrompida.

Considerações importantes sobre a retomada:

• NÃO exclua os arquivos de progresso .bin (generation_progress_range.bin ou generation_progress_full.bin) se você pretende retomar uma geração.
• Os arquivos de progresso são excluídos automaticamente somente quando o processo de geração é concluído com sucesso.
• Se você desejar recomeçar uma geração do zero (ignorando o progresso anterior), você deve excluir manualmente o arquivo de progresso .bin correspondente e renomear/excluir/mover qualquer arquivo de saída existente (mnemonics_range_[language].txt ou all_mnemonics_[language].txt) de execuções anteriores antes de iniciar o programa novamente.
• Esteja ciente de que, se você iniciar uma geração por "Intervalo de Datas" (Opção 2) com um intervalo diferente, ou uma geração de "Faixa Completa" (Opção 3) com o mesmo idioma em que um all_mnemonics_[language].txt já existe, o arquivo de progresso .bin será sobrescrito e novos mnemônicos serão anexados ao arquivo de saída existente.

Exemplo de Saída

Aqui está um exemplo de uma frase mnemônica BIP-39 de 24 palavras gerada por esta ferramenta:

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 fins de verificação ou referência rápida, o diretório tests/ neste repositório contém exemplos de frases mnemônicas geradas em vários idiomas para o timestamp 1970-01-01 00:00:00 UTC.

Gerar Endereços Bitcoin a partir de Mnemônicos

Para converter as frases mnemônicas geradas em endereços Bitcoin (suportando os formatos P2PKH, P2SH-P2WPKH e P2WPKH), você pode usar esta ferramenta:

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

Apoio

Se você achou este projeto útil e gostaria de me incentivar a criar mais ferramentas como esta, considere fazer uma doação:

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