Skip to content

Repository files navigation

hex_to_wif banner

🔐 HEX TO WIF CONVERTER

hex_to_wif is a multithreaded tool for converting Bitcoin private keys from HEX format to Wallet Import Format (WIF), supporting both compressed and uncompressed keys. It reads a list of HEX keys and outputs: - WIF (compressed & uncompressed) - Two output text files with results


⚙️ Features

  • 🔁 Converts HEX private keys to WIF
  • 🔐 Supports both compressed and uncompressed formats
  • 🚀 Multi-core CPU processing (via multiprocessing)
  • 📊 Live progress bar with tqdm
  • 🎨 Colored terminal output with colorama
  • 🪟 Windows .bat launcher included

📁 File Overview

  • hex_to_wif.py – Main conversion script
  • hex_to_wif.bat – Windows launcher for quick use
  • .vscode/
    • settings.json – Editor preferences
    • launch.json – Debugging configuration
    • tasks.json – Task runner integration
    • extensions.json – Recommended VS Code extensions
  • assets/
    • banner.png – Project banner
  • README.md – This documentation
  • LICENSEApache 2.0 License
  • NOTICEAttribution and notices
  • ETHICS.mdResponsible use notice
  • requirements.txt – Python dependencies
  • RELEASE_v1.0.0.md – Initial release changelog
  • RELEASE_v2.0.0.md – Updated release notes

🛠️ Dependencies

base58
tqdm
colorama

Install with:
pip install -r requirements.txt

Python 3.8+ is recommended.


🚀 Usage

Option 1 – via Python (Linux/macOS/WSL):

python hex_to_wif.py

Option 2 – via .bat launcher (Windows):

hex_to_wif.bat

You will be prompted to:

  1. Enter the input HEX file (default: hex.txt)
  2. Select number of CPU threads

The script will generate:

  • btc_wif_keys_uncompressed.txt
  • btc_wif_keys_compressed.txt

📦 Example Output

[INFO] Found 1000 keys. Starting conversion using 8 CPU threads...
[OK] Conversion completed successfully!
=> Uncompressed WIF keys saved to: btc_wif_keys_uncompressed.txt
=> Compressed WIF keys saved to: btc_wif_keys_compressed.txt


📂 Project Structure

hex_to_wif/
├── assets/
│ └── banner.png
├── .vscode/
│ ├── settings.json
│ ├── launch.json
│ ├── tasks.json
│ └── extensions.json
├── hex_to_wif.py
├── hex_to_wif.bat
├── LICENSE
├── NOTICE
├── ETHICS.md
├── README.md
├── requirements.txt
├── RELEASE_v1.0.0.md
└── RELEASE_v2.0.0.md


⚠️ DISCLAIMER

This software is provided strictly for educational, analytical, and research purposes only. The author does not promote or condone any unethical behavior, unauthorized access, or abuse of blockchain systems or cryptographic tools. This project does not include or generate any real private keys linked to actual cryptocurrency holdings. It is designed to operate in offline environments or for simulation/testing purposes. The author accepts no liability for any damages, losses, or illegal use resulting from this software. All responsibility lies solely with the end user.

Use responsibly. Learn ethically. Contribute honestly.


⚖️ Ethical Use

This tool is created strictly for research and educational purposes.
See ETHICS.md for the full statement.


📜 License

Licensed under the Apache 2.0 License


📣 NOTICE

See NOTICE for important information about attribution, DMCA protection, and reuse permissions.


🍱 Support

Bitcoin (BTC)
1MorphXyhHpgmYSfvwUpWojphfLTjrNXc7

Monero (XMR)
86VAmEogaZF5WDwR3SKtEC6HSEUh6JPA1gVGcny68XmSJ1pYBbGLmdzEB1ZzGModLBXkG3WbRv12mSKv4KnD8i9w7VTg2uu

Dash (DASH)
XtNuNfgaEXFKhtfxAKuDkdysxUqaZm7TDX

We also value early privacy coins such as:
Bytecoin (BCN)
bcnZNMyrDrweQgoKH6zpWaE2kW1VZRsX3aDEqnxBVEQfjNnPK6vvNMNRPA4S7YxfhsStzyJeP16woK6G7cRBydZm2TvLFB2eeR

🙏 Thank you for supporting independent research and ethical technology.


👤 Author & Contact

🔗 GitHub: https://github.com/BitMorphX
✉️ Email: BitMorphX@proton.me
💬 Telegram: https://t.me/BitMorphX

“I morph bits, not to break, but to understand.” — BitMorphX


© BitMorphX – All rights reserved.

About

🔐 Convert Bitcoin HEX private keys to WIF format (compressed & uncompressed) with multiprocessing and progress bar support.

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages