Beginning with this commit, every MMGen wallet now has a two sets of associated subwallets with “long“ and “short” seeds. MMGen wallets and subwallets are functionally equivalent and externally indistinguishable. This has benefits, especially for real-world security, as well as drawbacks. For more information, see the `mmgen-subwalletgen` help screen: https://github.com/mmgen/mmgen/wiki/subwalletgen-[MMGen-command-help] This patch provides subwallet generation functionality and subseed display utilities. Support for transaction signing and address generation using a subwallet's parent wallet will be added in a forthcoming patch. Examples: # Create a bogus wallet in mnemonic format for testing purposes: $ echo $(yes bee | head -n24) > bogus.mmwords # List the wallet's first five subseed pairs: $ mmgen-tool list_subseeds 1-5 wallet=bogus.mmwords Parent Seed: DF449DA4 (256 bits) Long Subseeds Short Subseeds ------------- -------------- 1L: FC9A8735 1S: 930E1AD5 2L: 62B02F54 2S: DF14AB49 3L: 9E884E99 3S: AD3ABD98 4L: DB595AE1 4S: 3E885EC4 5L: 36D5A0D1 5S: 30D66FF5 # Generate the 5th short (128-bit) subwallet from the wallet: $ mmgen-subwalletgen bogus.mmwords 5S # Same as above, but output subwallet to mnemonic (seed phrase) format: $ mmgen-subwalletgen -o mn bogus.mmwords 5S ... Mnemonic data written to file '30D66FF5[128].mmwords' # View the subwallet's seed phrase: $ cat 30D66FF5[128].mmwords object capture field heart page observe road bond mother loser really army # Generate 10 addresses from the subwallet seed phrase: $ mmgen-addrgen 30D66FF5[128].mmwords 1-10 ... Addresses written to file '30D66FF5[1-10].addrs'
228 lines
7.1 KiB
Python
Executable file
228 lines
7.1 KiB
Python
Executable file
#!/usr/bin/env python3
|
|
#
|
|
# mmgen = Multi-Mode GENerator, command-line Bitcoin cold storage solution
|
|
# Copyright (C)2013-2019 The MMGen Project <mmgen@tuta.io>
|
|
#
|
|
# 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/>.
|
|
|
|
"""
|
|
globalvars.py: Constants and configuration options for the MMGen suite
|
|
"""
|
|
|
|
import sys,os
|
|
|
|
# Global vars are set to dfl values in class g.
|
|
# They're overridden in this order:
|
|
# 1 - config file
|
|
# 2 - environmental vars
|
|
# 3 - command line
|
|
|
|
class g(object):
|
|
|
|
def die(ev=0,s=''):
|
|
if s: sys.stderr.write(s+'\n')
|
|
sys.exit(ev)
|
|
|
|
# Constants:
|
|
|
|
version = '0.10.099'
|
|
release_date = 'February 2019'
|
|
|
|
proj_name = 'MMGen'
|
|
proj_url = 'https://github.com/mmgen/mmgen'
|
|
prog_name = os.path.basename(sys.argv[0])
|
|
author = 'The MMGen Project'
|
|
email = '<mmgen@tuta.io>'
|
|
Cdates = '2013-2019'
|
|
keywords = 'Bitcoin, BTC, Ethereum, ETH, Monero, XMR, ERC20, cryptocurrency, wallet, BIP32, cold storage, offline, online, spending, open-source, command-line, Python, Linux, Bitcoin Core, bitcoind, hd, deterministic, hierarchical, secure, anonymous, Electrum, seed, mnemonic, brainwallet, Scrypt, utility, script, scriptable, blockchain, raw, transaction, permissionless, console, terminal, curses, ansi, color, tmux, remote, client, daemon, RPC, json, entropy, xterm, rxvt, PowerShell, MSYS, MSYS2, MinGW, MinGW64, MSWin, Armbian, Raspbian, Raspberry Pi, Orange Pi, BCash, BCH, Litecoin, LTC, altcoin, ZEC, Zcash, DASH, Dashpay, SHA256Compress, monerod, EMC, Emercoin, token, deploy, contract, gas, fee, smart contract, solidity, Parity, testnet, devmode, Kovan'
|
|
max_int = 0xffffffff
|
|
|
|
stdin_tty = bool(sys.stdin.isatty() or os.getenv('MMGEN_TEST_SUITE_POPEN_SPAWN'))
|
|
stdout = sys.stdout
|
|
stderr = sys.stderr
|
|
|
|
http_timeout = 60
|
|
|
|
# Variables - these might be altered at runtime:
|
|
|
|
user_entropy = ''
|
|
hash_preset = '3'
|
|
usr_randchars = 30
|
|
|
|
tx_fee_adj = 1.0
|
|
tx_confs = 3
|
|
seed_len = 256
|
|
|
|
# Constant vars - some of these might be overriden in opts.py, but they don't change thereafter
|
|
|
|
coin = 'BTC'
|
|
dcoin = None # the display coin unit
|
|
token = ''
|
|
debug = False
|
|
debug_opts = False
|
|
debug_rpc = False
|
|
debug_addrlist = False
|
|
debug_subseed = False
|
|
quiet = False
|
|
no_license = False
|
|
force_256_color = False
|
|
testnet = False
|
|
regtest = False
|
|
accept_defaults = False
|
|
use_internal_keccak_module = False
|
|
|
|
chain = None # set by first call to rpc_init()
|
|
chains = 'mainnet','testnet','regtest'
|
|
|
|
# rpc:
|
|
rpc_host = ''
|
|
rpc_port = 0
|
|
rpc_user = ''
|
|
rpc_password = ''
|
|
rpc_fail_on_command = ''
|
|
rpch = None # global RPC handle
|
|
|
|
# regtest:
|
|
bob = False
|
|
alice = False
|
|
|
|
# test suite:
|
|
bogus_wallet_data = ''
|
|
bogus_send = False
|
|
debug_utf8 = False
|
|
traceback = False
|
|
test_suite = False
|
|
test_suite_popen_spawn = False
|
|
|
|
for k in ('linux','win','msys'):
|
|
if sys.platform[:len(k)] == k:
|
|
platform = { 'linux':'linux', 'win':'win', 'msys':'win' }[k]
|
|
break
|
|
else:
|
|
die(1,"'{}': platform not supported by {}\n".format(sys.platform,proj_name))
|
|
|
|
color = sys.stdout.isatty()
|
|
|
|
if os.getenv('HOME'): # Linux or MSYS
|
|
home_dir = os.getenv('HOME')
|
|
elif platform == 'win': # Windows native:
|
|
die(1,'$HOME not set! {} for Windows must be run in MSYS environment'.format(proj_name))
|
|
else:
|
|
die(2,'$HOME is not set! Unable to determine home directory')
|
|
|
|
data_dir_root,data_dir,cfg_file = None,None,None
|
|
daemon_data_dir = '' # set by user or protocol
|
|
|
|
# global var sets user opt:
|
|
global_sets_opt = ( 'minconf','seed_len','hash_preset','usr_randchars','debug',
|
|
'quiet','tx_confs','tx_fee_adj','key_generator' )
|
|
|
|
# user opt sets global var:
|
|
opt_sets_global = ( 'use_internal_keccak_module','subseeds' )
|
|
|
|
# 'long' opts - opt sets global var
|
|
common_opts = (
|
|
'color','no_license','rpc_host','rpc_port','testnet','rpc_user','rpc_password',
|
|
'daemon_data_dir','force_256_color','regtest','coin','bob','alice',
|
|
'accept_defaults','token'
|
|
)
|
|
# opts initialized to None by opts.init() if not set by user
|
|
required_opts = (
|
|
'quiet','verbose','debug','outdir','echo_passphrase','passwd_file','stdout',
|
|
'show_hash_presets','label','keep_passphrase','keep_hash_preset','yes',
|
|
'brain_params','b16','usr_randchars','coin','bob','alice','key_generator',
|
|
'hidden_incog_input_params','in_fmt'
|
|
)
|
|
incompatible_opts = (
|
|
('base32','hex'), # mmgen-passgen
|
|
('bob','alice'),
|
|
('quiet','verbose'),
|
|
('label','keep_label'),
|
|
('tx_id','info'),
|
|
('tx_id','terse_info'),
|
|
('batch','rescan') # still incompatible as of Core 0.15.0
|
|
)
|
|
cfg_file_opts = (
|
|
'color','debug','hash_preset','http_timeout','no_license','rpc_host','rpc_port',
|
|
'quiet','tx_fee_adj','usr_randchars','testnet','rpc_user','rpc_password',
|
|
'daemon_data_dir','force_256_color','regtest','subseeds',
|
|
'btc_max_tx_fee','ltc_max_tx_fee','bch_max_tx_fee','eth_max_tx_fee',
|
|
'eth_mainnet_chain_name','eth_testnet_chain_name',
|
|
'max_tx_file_size','max_input_size'
|
|
)
|
|
# Supported environmental vars
|
|
# The corresponding vars (lowercase, minus 'mmgen_') must be initialized in g
|
|
# 'DISABLE_' env vars disable the corresponding var in g
|
|
env_opts = (
|
|
'MMGEN_DEBUG_ALL', # special: there is no g.debug_all var
|
|
|
|
'MMGEN_TEST_SUITE',
|
|
'MMGEN_TEST_SUITE_POPEN_SPAWN',
|
|
'MMGEN_BOGUS_WALLET_DATA',
|
|
'MMGEN_BOGUS_SEND',
|
|
'MMGEN_DEBUG',
|
|
'MMGEN_DEBUG_OPTS',
|
|
'MMGEN_DEBUG_RPC',
|
|
'MMGEN_DEBUG_ADDRLIST',
|
|
'MMGEN_DEBUG_UTF8',
|
|
'MMGEN_DEBUG_SUBSEED',
|
|
'MMGEN_QUIET',
|
|
'MMGEN_FORCE_256_COLOR',
|
|
'MMGEN_MIN_URANDCHARS',
|
|
'MMGEN_NO_LICENSE',
|
|
'MMGEN_RPC_HOST',
|
|
'MMGEN_RPC_FAIL_ON_COMMAND',
|
|
'MMGEN_TESTNET',
|
|
'MMGEN_REGTEST',
|
|
'MMGEN_TRACEBACK',
|
|
'MMGEN_USE_STANDALONE_SCRYPT_MODULE',
|
|
|
|
'MMGEN_DISABLE_COLOR',
|
|
)
|
|
|
|
min_screen_width = 80
|
|
minconf = 1
|
|
max_tx_file_size = 100000
|
|
max_input_size = 1024 * 1024
|
|
|
|
passwd_max_tries = 5
|
|
|
|
max_urandchars = 80
|
|
min_urandchars = 10
|
|
|
|
seed_lens = 128,192,256
|
|
scramble_hash_rounds = 10
|
|
subseeds = 100
|
|
|
|
mmenc_ext = 'mmenc'
|
|
salt_len = 16
|
|
aesctr_iv_len = 16
|
|
aesctr_dfl_iv = b'\x00' * (aesctr_iv_len-1) + b'\x01'
|
|
hincog_chk_len = 8
|
|
|
|
key_generators = 'python-ecdsa','secp256k1' # '1','2'
|
|
key_generator = 2 # secp256k1 is default
|
|
|
|
use_standalone_scrypt_module = False
|
|
hash_presets = {
|
|
# Scrypt params:
|
|
# ID N p r (N is an exponent of two)
|
|
'1': [12, 8, 1],
|
|
'2': [13, 8, 4],
|
|
'3': [14, 8, 8],
|
|
'4': [15, 8, 12],
|
|
'5': [16, 8, 16],
|
|
'6': [17, 8, 20],
|
|
'7': [18, 8, 24],
|
|
}
|