BIP39 Key 3D Card Backup

This project allows you to generate a 3D card (in .scad format) from a list of BIP39 words. Once created, this card can be printed using a 3D printer for a physical backup of your key.

Security and Durability Considerations

It's crucial to understand that while this backup method offers some level of durability against common wear and tear, it has inherent limitations when it comes to resilience. Given that the card is printed in plastic, it is not protected against extreme scenarios such as fire, high temperatures, or other natural disasters that might damage or melt the plastic.

On the market, there are titanium solutions designed to withstand such extreme situations. These are specifically manufactured to offer maximum protection against fire, corrosion, and other harsh conditions. However, the cost of these titanium solutions is often high, quickly exceeding 100 euros.

For individuals with high-value cryptocurrency wallets, it might be wise to invest in such solutions to ensure optimal protection. However, for medium-value wallets or those not ready to invest a significant amount into high-end backup solutions, our 3D printed method might suffice. It offers reasonable protection against everyday wear and tear while being cost-effective.

It's essential to weigh the cost-benefit ratio based on the value of your cryptocurrency wallet and the risks you are willing to take in terms of backup.

Prerequisites

You will need Python installed to run this project.

Installation & Dependencies

First, clone this repository:

git clone [repository-url]
cd [repository-directory]

Next, install the necessary Python dependencies. This project requires the solid library for generating .scad files:

pip install solidpython

Functionality

1. WordManager: This class is responsible for reading the file containing the BIP39 words and provides methods to obtain information on these words.
2. CardDessing: This class creates the 3D card design based on the words provided by WordManager. It also allows you to save the design as a .scad file.

Usage

1. Prepare a text file containing your BIP39 key (12, 18, or 24 words, one word per line).
2. Run the application with the following command:

python main.py [key_path] [title] [save_path]

• key_path: Path to the text file containing your BIP39 key.
• title: Title of the card.
• save_path: Save file path where the .scad design will be saved.

Example

Suppose you have a file named myKey.txt containing your BIP39 key, here's how you might use the application:

python main.py myKey.txt "My BIP39 Key" backupCard.scad

⚠️ Warning: The final result will greatly depend on the 3D printer used as well as the print quality. Make sure to test with your printer to achieve the best results.

Contribution

If you have improvements or suggestions for this project, feel free to open an issue or submit a pull request.

---

I hope this meets your requirements! You can further customize it as needed.