Milk Sad Mnemonik-Generator

Dieses Tool wurde entwickelt, um BIP-39-Mnemonik-Phrasen (24-Wort-Seed-Phrasen) basierend auf Unix-Zeitstempeln zu generieren, wobei speziell Phrasen untersucht werden, die durch die "Milk Sad"-Sicherheitslücke (CVE_2023-39910) erzeugt werden könnten.

Was dieses Tool macht

Der Milk Sad Mnemonik-Generator erstellt 24-Wort-BIP-39-Mnemonik-Phrasen, indem er Unix-Zeitstempel als Entropiequelle nutzt. Ziel ist es, alle möglichen Seed-Phrasen zu generieren, die aufgrund des spezifischen, auf Zeitstempeln basierenden Entropiesammlungsfehlers im Zusammenhang mit der "Milk Sad"-Sicherheitslücke entstanden sein könnten.

Hauptfunktionen:

Erzeugt 24-Wort-BIP-39-Mnemoniken.
Unterstützt mehrere Sprach-Wortlisten (Englisch, Spanisch, Japanisch, Französisch, Italienisch, Portugiesisch, Koreanisch, Russisch, Ukrainisch, Tschechisch, Chinesisch vereinfacht, Chinesisch traditionell).
Kann für bestimmte Daten, Datumsbereiche oder den gesamten 32-Bit-Zeitstempelbereich generieren.
Speichert den Fortschritt automatisch und kann unterbrochene Generierungen fortsetzen.

Installation

Sie haben zwei Möglichkeiten, das Tool auf Ihrem System zu installieren und auszuführen:

Option 1: Das `install.sh`-Skript verwenden

Dieses Skript automatisiert den Kompilierungsprozess und kümmert sich um übliche Abhängigkeiten für Debian/Ubuntu-basierte Linux-Systeme.

Öffnen Sie Ihr Terminal und navigieren Sie zum Stammverzeichnis des Projekts:
```
cd MilkSad-Mnemonic-Generator
```
Machen Sie das Skript ausführbar:
```
chmod +x install.sh
```
Führen Sie das Installationsskript aus:
```
./install.sh
```
Das Skript prüft auf notwendige Build-Tools (wie g++, make, qmake, libssl-dev, libqt5widgets5-dev). Falls welche fehlen, wird versucht, sie zu installieren (dabei wird nach Ihrem sudo-Passwort gefragt). Nach erfolgreicher Einrichtung der Abhängigkeiten werden sowohl die CLI- als auch die GUI-Anwendung kompiliert und direkt im Stammverzeichnis des Projekts platziert.

Option 2: Manuelle Kompilierung

Wenn Sie die Anwendungen lieber selbst kompilieren möchten, folgen Sie diesen manuellen Schritten:

Voraussetzungen:

Stellen Sie sicher, dass die folgenden Entwicklungspakete auf Ihrem Debian/Ubuntu-System installiert sind:

g++ (normalerweise Teil des build-essential-Pakets)
make (ebenfalls Teil von build-essential)
qmake (bereitgestellt durch qt5-qmake oder qtbase5-dev)
libssl-dev (essentiell für die vom Tool verwendeten kryptografischen Funktionen)
libqt5widgets5-dev (erforderlich für die Qt-GUI-Entwicklung; dieses Paket enthält oft qtbase5-dev)

Sie können diese Voraussetzungen mit folgendem Befehl installieren:

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

CLI-Anwendung kompilieren:

Navigieren Sie zum CLI-Quellverzeichnis:
```
cd src/cli
```

Kompilieren Sie die Anwendung mit g++:

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

Verschieben Sie die kompilierte CLI-Ausführungsdatei in das Projekt-Stammverzeichnis:
```
mv milk_sad_generator ../../
```
Kehren Sie zum Projekt-Stammverzeichnis zurück:
```
cd ../..
```

GUI-Anwendung kompilieren:

Navigieren Sie zum GUI-Quellverzeichnis:
```
cd src/gui
```
Führen Sie qmake aus, um die Makefile für das Qt-Projekt zu erstellen:
```
qmake mnemonic_generator.pro
```
Kompilieren Sie die GUI-Anwendung mit make:
```
make
```
Verschieben Sie die kompilierte GUI-Ausführungsdatei in das Projekt-Stammverzeichnis:
```
mv milk_sad_generator_gui ../../
```
Kehren Sie zum Projekt-Stammverzeichnis zurück:
```
cd ../..
```
Verschieben Sie den Pic/-Ordner: Damit die GUI ihr Hintergrundbild korrekt findet, müssen Sie den Pic/-Ordner von src/gui/ in das Projekt-Stammverzeichnis verschieben:
```
mv src/gui/Pic .
```

Wie man das Tool verwendet

Nach der Installation finden Sie zwei ausführbare Dateien direkt im Stammverzeichnis Ihres Projekts: ./milk_sad_generator (die Kommandozeilenversion) und ./milk_sad_generator_gui (die grafische Benutzeroberflächenversion).

Starten Sie das Programm:

./milk_sad_generator_gui  # Zum Starten der GUI-Anwendung
# ODER
./milk_sad_generator      # Zum Starten der CLI-Anwendung

Wählen Sie die Sprache der Mnemonik-Phrase aus den angebotenen Optionen (z. B. Englisch, Spanisch, Japanisch).
Wählen Sie einen der drei verfügbaren Generierungsmodi:

Option 1: Einzelner Zeitstempel (zum Testen)

Dieser Modus generiert eine einzelne 24-Wort-Mnemonik-Phrase für ein präzises Datum und eine Uhrzeit Ihrer Wahl.

Beispielverwendung:
- Datum/Uhrzeit eingeben: 1970-01-01 00:00:00 für den ersten Zeitstempel. Wenn Englisch gewählt wurde, wird die Mnemonik "milk sad ..." generiert.
- Ausgabe: Eine einzelne Mnemonik-Phrase wird generiert und in mnemonic_[language].txt gespeichert.

Option 2: Datumsbereich

Dieser Modus generiert Mnemoniken für jeden Zeitstempel innerhalb eines angegebenen Start- und Enddatumsbereichs.

Beispielverwendung:
- Datumsbereich eingeben: 2017-01-01:2018-12-31 (Dies generiert Mnemoniken für alle Zeitstempel zwischen dem 1. Januar 2017 und dem 31. Dezember 2018, inklusive.)
- Ausgabe: Alle generierten Mnemoniken für den angegebenen Bereich werden in mnemonics_range_[language].txt gespeichert.
- Der Fortschritt wird automatisch alle 100.000 Zeitstempel gespeichert. Diese Funktion ermöglicht es Ihnen, die Generierung sicher zu stoppen (z. B. durch Drücken von Strg+C) und später ohne Datenverlust fortzusetzen.

Option 3: Gesamter Bereich

Dieser Modus generiert alle möglichen Mnemoniken über den gesamten 32-Bit-Unix-Zeitstempelbereich (vom 1. Januar 1970 bis zum 19. Januar 2038).

WARNUNG: Die von dieser Option erzeugte Ausgabedatei kann extrem groß sein (möglicherweise 300-600 GB). Stellen Sie sicher, dass Sie ausreichend freien Speicherplatz haben, bevor Sie diesen Modus starten, und testen Sie zuerst mit kleineren Bereichen.
Ausgabe: Alle Mnemoniken werden in all_mnemonics_[language].txt gespeichert.
Der Fortschritt wird regelmäßig gespeichert. Beachten Sie, dass dieser Generierungsprozess je nach Systemleistung Tage dauern kann.

Ausgabedateien

Einzelne Mnemonik-Generierung: mnemonic_[language].txt
Datumsbereichs-Generierung: mnemonics_range_[language].txt
Gesamtbereichs-Generierung: all_mnemonics_[language].txt
Fortschrittsdateien (zum Fortsetzen): generation_progress_range.bin (für Option 2) / generation_progress_full.bin (für Option 3)

Wichtige Hinweise

Das Tool führt alle Zeitstempelberechnungen in UTC (Koordinierte Weltzeit) durch.
Für umfangreiche Generierungen, insbesondere die Option "Gesamter Bereich", ist es entscheidend, dass Sie über ausreichend Speicherplatz verfügen.
Sie können eine Generierung jederzeit durch Drücken von Strg+C sicher stoppen. Das Tool speichert automatisch den aktuellen Fortschritt.
Nach erfolgreichem Abschluss eines Generierungsmodus wird die entsprechende .bin-Fortschrittsdatei automatisch gelöscht.

Fortsetzen der Generierung nach einer Unterbrechung

Falls Sie die Generierung unterbrechen mussten (z. B. mit Strg+C), können Sie nahtlos an der Stelle weitermachen, an der Sie aufgehört haben:

Für Datumsbereichs-Generierung (Option 2):
- Starten Sie das Programm erneut und wählen Sie Option 2.
- Geben Sie den exakt gleichen Datumsbereich ein, den Sie zuvor verwendet haben.
- Das Tool erkennt automatisch die Datei generation_progress_range.bin und setzt die Generierung ab dem letzten gespeicherten Zeitstempel fort.
Für Gesamtbereichs-Generierung (Option 3):
- Starten Sie das Programm erneut und wählen Sie Option 3.
- Das Tool findet automatisch die Datei generation_progress_full.bin und setzt die Generierung an der Stelle fort, an der sie unterbrochen wurde.

Wichtige Hinweise zur Fortsetzung:

Löschen Sie NICHT die .bin-Fortschrittsdateien (generation_progress_range.bin oder generation_progress_full.bin), wenn Sie eine Generierung fortsetzen möchten.
Die Fortschrittsdateien werden automatisch gelöscht, sobald der Generierungsprozess erfolgreich abgeschlossen ist.
Wenn Sie eine Generierung ganz von vorne beginnen möchten (unter Ignorierung des bisherigen Fortschritts), müssen Sie die entsprechende .bin-Fortschrittsdatei manuell löschen und eine vorhandene Ausgabedatei (mnemonics_range_[language].txt oder all_mnemonics_[language].txt) aus vorherigen Läufen umbenennen/löschen/verschieben, bevor Sie das Programm erneut starten.
Beachten Sie, dass die .bin-Fortschrittsdatei überschrieben wird, wenn Sie eine "Datumsbereichs"-Generierung (Option 2) mit einem anderen Datumsbereich starten, oder eine "Gesamtbereichs"-Generierung (Option 3) mit derselben Sprache, bei der bereits eine all_mnemonics_[language].txt existiert. Neue Mnemoniken werden dann an die bestehende Ausgabedatei angehängt.

Beispielausgabe

Hier ist ein Beispiel einer 24-Wort-BIP-39-Mnemonik-Phrase, die von diesem Tool generiert wurde:

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

Zu Überprüfungszwecken oder als schnelle Referenz enthält das tests/-Verzeichnis in diesem Repository Beispiele generierter Mnemonik-Phrasen für verschiedene Sprachen für den Zeitstempel 1970-01-01 00:00:00 UTC.

Bitcoin-Adressen aus Mnemonik-Phrasen generieren

Um die generierten Mnemonik-Phrasen in Bitcoin-Adressen umzuwandeln (unterstützt P2PKH-, P2SH-P2WPKH- und P2WPKH-Formate), können Sie dieses Tool verwenden:

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

Unterstützung

Wenn Sie dieses Projekt nützlich fanden und mich ermutigen möchten, weitere Tools wie dieses zu erstellen, erwägen Sie eine Spende:

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

MilkSad-Mnemonic-Generator

Beliebteste