add faq to readme

README.txt

@@ -3,7 +3,9 @@ mkp224o - vanity address generator for ed25519 onion services
 This tool generates vanity ed25519 (hidden service version 3, formely known as proposal 224) onion addresses.
 For context, see <https://gitweb.torproject.org/torspec.git/plain/rend-spec-v3.txt>.
 
+
 REQUIREMENTS:
+
 C99 compatible compiler (gcc and clang should work),
 libsodium (including headers), GNU make,
 GNU autoconf (to generate configure script, needed only if not using release tarball),
@@ -11,7 +13,9 @@ UNIX-like platform (currently tested in Linux and OpenBSD, but should also build
 For debian-like linux distros, this should be enough to prepare for building:
 `apt install gcc libsodium-dev make autoconf`.
 
+
 BUILDING:
+
 `./autogen.sh` to generate configure script, if it's not there already.
 `./configure` to generate makefile; in *BSD platforms you probably want to use
 `./configure CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib"`.
@@ -20,7 +24,9 @@ or "--enable-donna" to configure script for faster key generation;
 run `./configure --help` to see all available options.
 Finally, `make` to start building (`gmake` in *BSD platforms).
 
+
 USAGE:
+
 Generator needs one or more filters to work.
 It makes directory with secret/public keys and hostname
 for each discovered service. By default root is current
@@ -30,11 +36,47 @@ when benchmarking different ed25519 implementations on your machine.
 Use -h switch to obtain all available options.
 I highly recommend reading OPTIMISATION.txt for performance-related tips.
 
+FAQ AND OTHER USEFUL INFO:
+
+ * How do I generate address?
+ - Once compiled, run it like `./mkp224o neko`, and it will try creating keys
+   for onions starting with "neko" in this example; use `./mkp224o -d nekokeys neko` to
+   not litter current directory and put all discovered keys in directory named "nekokeys".
+
+ * How do I make tor use generated keys?
+ - Copy key folder (though technically only hs_ed25519_secret_key is required)
+   to where you want your service keys to reside:
+   `sudo cp -r neko54as6d54....onion /var/lib/tor/nekosvc`.
+   You may need to adjust owner and permissions:
+   `sudo chown -R tor: /var/lib/tor/nekosvc`,
+   `sudo chmod -R u+rwX,og-rwx /var/lib/tor/nekosvc`.
+   Then edit torrc and add new service with that folder.
+   After reload/restart tor should pick it up.
+
+ * Generate addresses with 1-2 and 7-9 digits?
+ - onion addresses use base32 encoding which does not include 1,2,7,8,9 numbers.
+   so no, that's not possible to generate these, and mkp224o tries to detect invalid filters containing them early on.
+
+ * How long is it going to take?
+ - Because of probablistic nature of brute force key generation, and varience of hardware it's going to run on,
+   it's hard to make promisses about how long it's going to take, especially when the most of users want just a few keys.
+   See <https://github.com/cathugger/mkp224o/issues/27> for very valuable discussion about this.
+   If your machine is powerful enough, 6 character prefix shouldn't take more than few tens of minutes,
+   if using batch mode (read OPTIMISATION.txt). 7 characters can take hours to days.
+   No promisses though, it depends on pure luck.
+
+ * Will this work with onionbalance?
+ - It appears that onionbalance supports loading usual hs_ed25519_secret_key key so it should work.
+
+
 CONTACT:
+
 For bug reports/questions/whatever else, email cathugger at cock dot li.
 PGP key, if needed, can be found at <http://cathug2kyi4ilneggumrenayhuhsvrgn6qv2y47bgeet42iivkpynqad.onion/contact.html>.
 
+
 ACKNOWLEDGEMENTS & LEGAL:
+
 To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.
 You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.