@@ -10,22 +10,23 @@ Generate wallets whose public keys match an optional prefix and/or suffix, encry
1010- Periodic progress stats per worker.
1111- AES-256 OpenPGP symmetric encryption of the JSON output file.
1212- Decryption command to recover the clear JSON.
13- +
14- +## Leet Similarity Mapping
15- +
16- +When using ` -similar ` , characters are considered equivalent to these visually similar substitutions:
17- +| Character | Similar Characters |
18- +|-----------|--------------------|
19- +| a | 4 |
20- +| b | 8, 6 |
21- +| e | 3 |
22- +| g | 6, 9 |
23- +| i | 1, l |
24- +| l | 1, i |
25- +| o | 0 |
26- +| s | 5, z |
27- +| t | 7 |
28- +| z | 2 |
13+
14+ ## Leet Similarity Mapping
15+
16+ When using ` -similar ` , characters are considered equivalent to these visually similar substitutions:
17+
18+ | Character | Similar Characters |
19+ | -----------| --------------------|
20+ | a | 4 |
21+ | b | 8, 6 |
22+ | e | 3 |
23+ | g | 6, 9 |
24+ | i | 1, l |
25+ | l | 1, i |
26+ | o | 0 |
27+ | s | 5, z |
28+ | t | 7 |
29+ | z | 2 |
2930
3031## Requirements
3132
6970- ` -ignore-case ` Ignore letter case when matching prefix/suffix
7071- ` -similar ` Accept visually similar chars (leet substitutions)
7172- ` -timeout duration ` Maximum search duration (e.g., ` 10s ` , ` 1m ` , ` 2h ` ); cancels search and saves any found wallets before exit
73+ - ` -pass string ` Passphrase (unsafe on CLI; prefer setting ` HIVE_WALLET_PASSPHRASE ` env var)
7274
7375Examples:
7476
@@ -81,28 +83,33 @@ Examples:
8183
8284# Generate wallets for up to 1 minute; saves any found wallets before timeout
8385./hive-wallet new -prefix HIVE -timeout 1m
84- +
85- +# Advanced Examples
86- +` ` ` bash
87- +# Multi-prefix list, match any of the three prefixes:
88- +./hive-wallet new -n 3 -prefix HIVE,ETH,SOL
89- +
90- +# Multi-suffix list, match any of the two suffixes:
91- +./hive-wallet new -n 2 -suffix abc,xyz
92- +
93- +# Combine multiple prefixes and suffixes:
94- +./hive-wallet new -n 1 -prefix HIVE,ETH -suffix AAA,BBB
95- +
96- +# Case-insensitive + leet similarity with lists:
97- +./hive-wallet new -prefix h1v3,swap -ignore-case -similar
98- +
99- +# Generate for up to 30 seconds, saving any found wallets before timeout:
100- +./hive-wallet new -prefix HIVE -timeout 30s
101- + ` ` `
10286```
10387
104- You will be prompted to set and confirm a passphrase (min 8 characters).
105- A status line prints every 5 seconds per worker, and each found wallet is logged immediately.
88+ <!-- Example: hive-wallet in action -->
89+ ![ Screenshot of hive-wallet running] ( docs/example.png )
90+
91+ ``` bash
92+ # Advanced Examples
93+
94+ # Multi-prefix list, match any of the three prefixes:
95+ ./hive-wallet new -n 3 -prefix HIVE,ETH,SOL
96+
97+ # Multi-suffix list, match any of the two suffixes:
98+ ./hive-wallet new -n 2 -suffix abc,xyz
99+
100+ # Combine multiple prefixes and suffixes:
101+ ./hive-wallet new -n 1 -prefix HIVE,ETH -suffix AAA,BBB
102+
103+ # Case-insensitive + leet similarity with lists:
104+ ./hive-wallet new -prefix h1v3,swap -ignore-case -similar
105+
106+ # Generate for up to 30 seconds, saving any found wallets before timeout:
107+ ./hive-wallet new -prefix HIVE -timeout 30s
108+ ```
109+
110+ A passphrase is required before writing the encrypted file.
111+ You may supply it non-interactively via ` -pass ` or the ` HIVE_WALLET_PASSPHRASE ` environment variable;
112+ otherwise you will be prompted to set and confirm one (min 8 characters).
106113
107114### Decrypt file (` decrypt ` )
108115
@@ -114,6 +121,7 @@ Flags:
114121
115122- ` -in string ` Encrypted input file (default ` wallets.json.gpg ` )
116123- ` -out string ` Decrypted JSON output file (stdout if omitted)
124+ - ` -pass string ` Passphrase (or set ` HIVE_WALLET_PASSPHRASE ` to avoid prompt)
117125
118126Examples:
119127
0 commit comments