mmgen-wallet/mmgen-addrgen

#!/usr/bin/env python
#
# mmgen = Multi-Mode GENerator, command-line Bitcoin cold storage solution
# Copyright (C) 2013-2014 by philemon <mmgen-py@yandex.com>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.

"""
mmgen-addrgen: Generate a list or range of addresses from a mmgen
               deterministic wallet.
               Call as 'btc-keygen' to allow key generation as well.
"""

import sys

import mmgen.config as g
from mmgen.Opts import *
from mmgen.license import *
from mmgen.util import *
from mmgen.addr import *

gen_what = "addresses" if sys.argv[0].split("-")[-1] == "addrgen" else "keys"

help_data = {
	'prog_name': sys.argv[0].split("/")[-1],
	'desc': """Generate a list or range of {} from an {g.proj_name} wallet,
                  mnemonic, seed or password""".format(gen_what,g=g),
	'usage':"[opts] [infile] <address list>",
	'options': """
-h, --help               Print this help message{}
-d, --outdir=         d  Specify an alternate directory 'd' for output
-e, --echo-passphrase    Echo passphrase or mnemonic to screen upon entry
-H, --show-hash-presets  Show information on available hash presets
-K, --no-keyconv         Use internal libraries for address generation
                         instead of 'keyconv'
-l, --seed-len=       N  Length of seed.  Options: {seed_lens}
                         (default: {g.seed_len})
-p, --hash-preset=    p  Use scrypt.hash() parameters from preset 'p' when
                         hashing password (default: '{g.hash_preset}')
-P, --passwd-file=    f  Get passphrase from file 'f'
-q, --quiet              Suppress warnings; overwrite files without
                         prompting
-S, --stdout             Print {what} to stdout
-v, --verbose            Produce more verbose output{}

-b, --from-brain=    l,p Generate {what} from a user-created password,
                         i.e. a "brainwallet", using seed length 'l' and
                         hash preset 'p' (comma-separated)
-g, --from-incog         Generate {what} from an incognito wallet
-X, --from-incog-hex     Generate {what} from incognito hexadecimal wallet
-G, --from-incog-hidden= f,o,l  Generate {what} from incognito data in file
                         'f' at offset 'o', with seed length of 'l'
-m, --from-mnemonic      Generate {what} from an electrum-like mnemonic
-s, --from-seed          Generate {what} from a seed in .{g.seed_ext} format
""".format(
		*(
		   ("\n-A, --no-addresses       Print only secret keys, no addresses",
		    "\n-x, --b16                Print secret keys in hexadecimal too")
		if gen_what == "keys" else ("","")),
		seed_lens=", ".join([str(i) for i in g.seed_lens]),
		what=gen_what, g=g
),
	'notes': """

Addresses are given in a comma-separated list.  Hyphen-separated ranges are
also allowed.{}

If available, the external 'keyconv' program will be used for address
generation.

Data for the --from-<what> options will be taken from <infile> if <infile>
is specified.  Otherwise, the user will be prompted to enter the data.

For passphrases all combinations of whitespace are equal, and leading and
trailing space are ignored.  This permits reading passphrase data from a
multi-line file with free spacing and indentation.  This is particularly
convenient for long brainwallet passphrases, for example.

BRAINWALLET NOTE:

As brainwallets require especially strong hashing to thwart dictionary
attacks, the brainwallet hash preset must be specified by the user, using
the 'p' parameter of the '--from-brain' option

The '--from-brain' option also requires the user to specify a seed length
(the 'l' parameter)

For a brainwallet passphrase to always generate the same keys and addresses,
the same 'l' and 'p' parameters to '--from-brain' must be used in all future
invocations with that passphrase
""".format("\n\nBy default, both addresses and secret keys are generated."
				if gen_what == "keys" else "")
}

opts,cmd_args = parse_opts(sys.argv,help_data)

if 'show_hash_presets' in opts: show_hash_presets()
if 'verbose' in opts: g.verbose = True
if 'quiet' in opts: g.quiet = True
if 'from_incog_hex' in opts or 'from_incog_hidden' in opts:
	opts['from_incog'] = True

opts['gen_what'] = gen_what

if g.debug: show_opts_and_cmd_args(opts,cmd_args)

if len(cmd_args) == 1 and (
			'from_mnemonic' in opts
			or 'from_brain' in opts
			or 'from_seed' in opts
			or 'from_incog_hidden' in opts
		):
	infile,addr_idx_arg = "",cmd_args[0]
elif len(cmd_args) == 2:
	infile,addr_idx_arg = cmd_args
	check_infile(infile)
else: usage(help_data)

addr_idxs = parse_address_list(addr_idx_arg)

if not addr_idxs: sys.exit(2)

do_license_msg()

# Interact with user:
if gen_what == "keys" and not g.quiet:
	confirm_or_exit(cmessages['unencrypted_secret_keys'], 'continue')

# Generate data:

if gen_what == "addresses":
	opts['print_addresses_only'] = True
else:
	if not 'no_addresses' in opts: opts['print_secret'] = True

seed          = get_seed_retry(infile,opts)
seed_id       = make_chksum_8(seed)

addr_data     = generate_addrs(seed, addr_idxs, opts)
addr_data_chksum = make_chksum_8(
	" ".join(["{} {}".format(a['num'],a['addr']) for a in addr_data]),
	sep=True
)
addr_data_str = format_addr_data(
		addr_data, addr_data_chksum, seed_id, addr_idxs, opts)

# Output data:
if 'stdout' in opts:
	if gen_what == "keys" and not g.quiet:
		confirm = True
	else: confirm = False
	write_to_stdout(addr_data_str,"secret keys",confirm)
elif not sys.stdout.isatty():
	write_to_stdout(addr_data_str,"secret keys",confirm=False)
else:
	write_addr_data_to_file(seed, addr_data_str, addr_idxs, opts)

msg("""
Checksum for address data {}[{}]: {}
Remember this checksum or save it to a secure location
""".format(seed_id, fmt_addr_idxs(addr_idxs), addr_data_chksum).strip())