Milk Sad ニーモニックジェネレーター

このツールは、Unixタイムスタンプに基づいてBIP-39ニーモニックフレーズ（24語のシードフレーズ）を生成するために設計されており、特に「Milk Sad」脆弱性（CVE_2023-39910）を通じて生成される可能性のあるフレーズを探索します。

このツールの機能

Milk Sadニーモニックジェネレーターは、Unixタイムスタンプをエントロピー源として利用し、24語のBIP-39ニーモニックフレーズを生成します。これは、「Milk Sad」脆弱性に関連する特定のタイムスタンプベースのエントロピー収集の欠陥によって生成された可能性のあるすべてのシードフレーズを生成することを目的としています。

主な機能:

24語のBIP-39ニーモニックを生成します。
複数の言語ワードリスト（英語、スペイン語、日本語、フランス語、イタリア語、ポルトガル語、韓国語、ロシア語、ウクライナ語、チェコ語、簡体字中国語、繁体字中国語）に対応しています。
特定の日付、日付範囲、または32ビットタイムスタンプ全体の範囲で生成できます。
進行状況を自動的に保存し、中断された生成を再開できます。

インストール

システムにインストールして実行する方法は2つあります。

オプション1: `install.sh`スクリプトを使用する

このスクリプトは、Debian/UbuntuベースのLinuxシステム向けにコンパイルプロセスを自動化し、一般的な依存関係を処理します。

ターミナルを開き、プロジェクトのルートディレクトリに移動します:
```
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を実行してQtプロジェクトのMakefileを生成します:
```
qmake mnemonic_generator.pro
```
makeを使用してGUIアプリケーションをコンパイルします:
```
make
```
コンパイルしたGUI実行ファイルをプロジェクトのルートに移動します:
```
mv milk_sad_generator_gui ../../
```
プロジェクトのルートに戻ります:
```
cd ../..
```
Pic/フォルダを移動します: GUIが背景画像を正しく見つけられるように、Pic/フォルダをsrc/gui/からプロジェクトのルートに移動する必要があります:
```
mv src/gui/Pic .
```

ツールの使用方法

インストールが完了すると、プロジェクトのルートディレクトリに2つの実行ファイルがあります: ./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

表示されるオプションからニーモニックフレーズの言語を選択します（例: 英語、スペイン語、日本語）。
利用可能な3つの生成モードのうち1つを選択します:

オプション1: 単一タイムスタンプ（テスト用）

このモードは、指定した正確な日時に対して単一の24語のニーモニックフレーズを生成します。

使用例:
- 日時を入力: 最初のタイムスタンプとして1970-01-01 00:00:00。英語を選択した場合、"milk sad ..."ニーモニックが生成されます。
- 出力: 単一のニーモニックフレーズが生成され、mnemonic_[language].txtに保存されます。

オプション2: 日付範囲

このモードは、指定された開始日と終了日の範囲内のすべてのタイムスタンプに対してニーモニックを生成します。

使用例:
- 日付範囲を入力: 2017-01-01:2018-12-31（これにより、2017年1月1日から2018年12月31日までのすべてのタイムスタンプのニーモニックが生成されます。両端を含みます。）
- 出力: 指定された範囲の生成済みニーモニックはすべてmnemonics_range_[language].txtに保存されます。
- 進行状況は10万タイムスタンプごとに自動保存されます。この機能により、生成を安全に停止（例: Ctrl+Cを押す）し、進行状況を失うことなく後で再開できます。

オプション3: 全範囲

このモードは、32ビットUnixタイムスタンプ全体の範囲（1970年1月1日から2038年1月19日まで）にわたって、可能なすべてのニーモニックを生成します。

警告: このオプションで生成される出力ファイルは非常に大きくなる可能性があります（潜在的に300〜600GB）。このモードを開始する前に十分な空きディスク容量があることを確認し、まず小さな範囲でテストしてください。
出力: すべてのニーモニックは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ファイルを検出し、最後に保存されたタイムスタンプから生成を続行します。
全範囲生成（オプション3）の場合:
- プログラムを再度実行し、オプション3を選択します。
- ツールは自動的にgeneration_progress_full.binファイルを見つけ、中断された時点から生成を再開します。

再開に関する重要な考慮事項:

生成を再開する予定がある場合は、.bin進行ファイルを削除しないでください（generation_progress_range.binまたはgeneration_progress_full.bin）。
進行ファイルは、生成プロセスが正常に完了した場合にのみ自動的に削除されます。
最初から生成をやり直したい場合（以前の進行状況を無視する場合）は、プログラムを再度開始する前に、対応する.bin進行ファイルを手動で削除し*、かつ*以前の実行で生成された既存の出力ファイル（mnemonics_range_[language].txtまたはall_mnemonics_[language].txt）を名前変更/削除/移動する必要があります。
異なる日付範囲で「日付範囲」生成（オプション2）を開始した場合、またはall_mnemonics_[language].txtが既に存在する同じ言語で「全範囲」生成（オプション3）を開始した場合、.bin進行ファイルは上書きされ、新しいニーモニックが既存の出力ファイルに追加されることに注意してください。

出力例

このツールによって生成された24語のBIP-39ニーモニックフレーズの例を次に示します:

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

検証目的またはクイックリファレンスとして、このリポジトリのtests/ディレクトリには、1970-01-01 00:00:00 UTCタイムスタンプに対するさまざまな言語の生成済みニーモニックフレーズの例が含まれています。

ニーモニックからBitcoinアドレスを生成する

生成したニーモニックフレーズをBitcoinアドレス（P2PKH、P2SH-P2WPKH、P2WPKH形式に対応）に変換するには、次のツールを使用できます:

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

サポート

このプロジェクトが役に立ったと思われた場合、そしてこのようなツールをもっと作成する励みにしたい場合は、寄付をご検討ください:

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

MilkSad-Mnemonic-Generator

人気