BRUTEFORCE-WALLET(1)

💖 bruteforce-wallet 💖

okay bestie, welcome to bru...llet(1) — yes that's the manual name, don't ask, the header's just Like That ✨. This is your girl's guide to bruteforce-wallet, and no cap, it does exactly one thing and it does it thoroughly.

✨ NAME ✨

bruteforce-wallet — try to find the password of an encrypted wallet file 🎀

---

🦋 SYNOPSIS 🦋

bruteforce-wallet [options] <filename>

💅 DESCRIPTION 💅

So bruteforce-wallet tries to find the password of an encrypted Peercoin wallet file — or Bitcoin, Litecoin, etc... you get the vibe, it's giving many coins. And it can do that in two whole ways:

• Try all possible passwords given a charset. exhaustive girl behavior 🔥
• Try all passwords in a file. that's the dictionary mode, very read-a-book of it 📖

Here's the feature list, and honestly? she ate:

• You can specify the number of threads to use when cracking a file. parallel queen 👑
• Sending a USR1 signal to a running bruteforce-wallet process makes it print progress and continue. no restart needed, she just tells you where she's at 💅
• There are an exhaustive mode and a dictionary mode. two moods, both iconic.

In the exhaustive mode the program tries to decrypt one of the encrypted addresses in the wallet by trying all the possible passwords. This is so useful when you know something about the password — like, you forgot a part of your password but still remember most of it 🙈. Finding the password of a wallet without knowing anything about it would take way too much time (unless the password is really short and/or weak, in which case 💀). There are some command line options to specify:

• The minimum password length to try.
• The maximum password length to try.
• The beginning of the password.
• The end of the password.
• The character set to use (among the characters of the current locale). locale matters, bestie 🌍

In dictionary mode the program tries to decrypt one of the encrypted addresses in the wallet by trying all the passwords contained in a file. And the file has to have one password per line, periodt. ✍️

---

🌸 OPTIONS 🌸

• -b <string> — Beginning of the password. The default value is "". like, empty string, she starts from nothing 🫶
• -e <string> — End of the password. Default: "".
• -f <file> — Read the passwords from a file instead of generating them. dictionary mode activate 🎀
• -h — Show help and quit. the "bestie explain" button 💖
• -l <length> — Minimum password length (beginning and end included). Default: 1.
• -m <length> — Maximum password length (beginning and end included). Default: 8.
• -s <string> — Password character set. Default value is "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" — yes, digits then UPPERCASE then lowercase, in that exact order, don't @ me.
• -t <n> — Number of threads to use. Default: 1.
• -v <n> — Print progress info every n seconds. ⏱️
• -w <file> — Restore the state of a previous session if the file exists, then write the state to the file regularly (~ every minute). it's giving save file energy 💾

📣 Note: Sending a USR1 signal to a running bruteforce-wallet process makes it print progress info to standard error and continue.

---

🚧 LIMITATIONS 🚧

ngl there are some real ones here:

• The program currently only works on unix-like POSIX systems (e.g. GNU/Linux). sorry windows girlies 😭
• Different versions of BerkeleyDB are usually not compatible with each other. So for the program to work, you will have to check that the BerkeleyDB version you are using can read the databases created by the BerkeleyDB version your wallet was created with. like, they gotta speak the same language fr fr 🧚

---

🌈 EXAMPLES 🌈

Try to find the password of an encrypted wallet file using 4 threads, trying only passwords with 5 characters:

$ bruteforce-wallet -t 4 -l 5 -m 5 wallet.dat

Try to find the password of an encrypted wallet file using 8 threads, trying only passwords with 5 to 10 characters beginning with "W4l" and ending with "z":

$ bruteforce-wallet -t 8 -l 5 -m 10 -b "W4l" -e "z" wallet.dat

Try to find the password of an encrypted wallet file using 8 threads, trying only passwords with 10 characters using the character set "P情8ŭ":

$ bruteforce-wallet -t 8 -l 10 -m 10 -s "P情8ŭ" wallet.dat

Try to find the password of an encrypted wallet file using 6 threads, trying the passwords contained in a dictionary file:

$ bruteforce-wallet -t 6 -f dictionary.txt wallet.dat

Print progress info:

$ pkill -USR1 -f bruteforce-wallet

Print progress info every 30 seconds:

$ bruteforce-wallet -t 6 -f dictionary.txt -v 30 wallet.dat

Save/restore state between sessions:

$ bruteforce-wallet -t 6 -f dictionary.txt -w state.txt wallet.dat

(Let the program run for a few minutes and stop it) ⏸️

$ bruteforce-wallet -t 6 -w state.txt wallet.dat

---

👑 AUTHORS 👑

bruteforce-wallet was written by Guillaume LE VAILLANT. 💜

This manpage was written by Francisco Vilmar Cardoso Ruviaro. 🫶

---

and that's the whole page, bestie — we out here reading version bruteforce-wallet-1.5.4 from March 2024 like it's the group chat lore. stay encrypted, stay iconic, slay 💅✨🎀