README.txt

   1 mkp224o - vanity address generator for ed25519 onion services
   2
   3 This tool generates vanity ed25519 (hidden service version 3) onion addresses.
   4 For context, see <https://gitweb.torproject.org/torspec.git/plain/rend-spec-v3.txt>.
   5
   6 REQUIREMENTS:
   7 libsodium, GNU autoconf, GNU make, UNIX-like platform (currently tested in Linux).
   8
   9 BUILDING:
  10 `./autogen.sh && ./configure && make` (gmake in *BSD platforms).
  11 See `./configure --help` for additional options
  12 which can contribute to better performance.
  13
  14 USAGE:
  15 Generator needs one of more filters to work.
  16 It makes directory with secret/public keys and hostname
  17 for each discovered service. By default root is current
  18 directory, but that can be overridden with -d switch.
  19 Use -h switch to obtain all avaiable options.
  20
  21 ACKNOWLEDGEMENTS & LEGAL:
  22 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.
  23 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/>.
  24
  25 keccak.c is based on <https://github.com/gvanas/KeccakCodePackage/blob/master/Standalone/CompactFIPS202/Keccak-more-compact.c>.
  26 ed25519/{ref10,amd64-51-30k,amd64-64-24k} are adopted from SUPERCOP <https://bench.cr.yp.to/supercop.html>.
  27 idea used in main.c' dofastwork() is stolen from <https://github.com/Yawning/horse25519>.