mmgen-wallet/test/altcointest.py

464 lines
13 KiB
Python
Executable file

#!/usr/bin/env python3
#
# MMGen Wallet, a terminal-based cryptocurrency wallet
# Copyright (C)2013-2026 The MMGen Project <mmgen@tuta.io>
# Licensed under the GNU General Public License, Version 3:
# https://www.gnu.org/licenses
# Public project repositories:
# https://github.com/mmgen/mmgen-wallet
# https://gitlab.com/mmgen/mmgen-wallet
"""
altcointest.py - Test constants for Bitcoin-derived altcoins
"""
import sys
try:
from include import test_init
except ImportError:
from test.include import test_init
from mmgen.cfg import gc, Config
from mmgen.util import msg
from mmgen.altcoin.params import CoinInfo
def test_equal(desc, a, b, *cdata):
if type(a) is int:
a = hex(a)
b = hex(b)
(network, coin, _, b_desc, verbose) = cdata
if verbose:
msg(f' {desc:20}: {a!r}')
if a != b:
raise ValueError(
f'{desc.capitalize()}s for {coin.upper()} {network} do not match:\n CoinInfo: {a}\n {b_desc}: {b}')
class TestCoinInfo(CoinInfo):
# Sources (see CoinInfo) that are in agreement for these coins
# No check for segwit, p2sh check skipped if source doesn't support it
cross_checks = {
'2GIVE': ['wn'],
'42': ['vg', 'wn'],
'611': ['wn'],
'AC': ['lb', 'vg'],
'ACOIN': ['wn'],
'ALF': ['wn'],
'ANC': ['vg', 'wn'],
'APEX': ['wn'],
'ARCO': ['wn'],
'ARG': ['pc'],
'AUR': ['vg', 'wn'],
'BCH': ['wn'],
'BLK': ['lb', 'vg', 'wn'],
'BQC': ['vg', 'wn'],
'BSTY': ['wn'],
'BTC': ['lb', 'vg', 'wn'],
'BTCD': ['lb', 'vg', 'wn'],
'BUCKS': ['wn'],
'CASH': ['wn'],
'CBX': ['wn'],
'CCN': ['lb', 'vg', 'wn'],
'CDN': ['lb', 'vg', 'wn'],
'CHC': ['wn'],
'CLAM': ['lb', 'vg'],
'CON': ['vg', 'wn'],
'CPC': ['wn'],
'DASH': ['lb', 'pc', 'vg', 'wn'],
'DCR': ['pc'],
'DFC': ['pc'],
'DGB': ['lb', 'vg'],
'DGC': ['lb', 'vg', 'wn'],
'DOGE': ['lb', 'pc', 'vg', 'wn'],
'DOGED': ['lb', 'vg', 'wn'],
'DOPE': ['lb', 'vg'],
'DVC': ['vg', 'wn'],
'EFL': ['lb', 'vg', 'wn'],
'EMC': ['vg'],
'EMD': ['wn'],
'ESP': ['wn'],
'FAI': ['pc'],
'FC2': ['wn'],
'FIBRE': ['wn'],
'FJC': ['wn'],
'FLO': ['wn'],
'FLT': ['wn'],
'FST': ['wn'],
'FTC': ['lb', 'pc', 'vg', 'wn'],
'GCR': ['lb', 'vg'],
'GOOD': ['wn'],
'GRC': ['vg', 'wn'],
'GUN': ['vg', 'wn'],
'HAM': ['vg', 'wn'],
'HTML5': ['wn'],
'HYP': ['wn'],
'ICASH': ['wn'],
'INFX': ['wn'],
'IPC': ['wn'],
'JBS': ['lb', 'pc', 'vg', 'wn'],
'JUDGE': ['wn'],
'LANA': ['wn'],
'LAT': ['wn'],
'LDOGE': ['wn'],
'LMC': ['wn'],
'LTC': ['lb', 'vg', 'wn'],
'MARS': ['wn'],
'MEC': ['pc', 'wn'],
'MINT': ['wn'],
'MOBI': ['wn'],
'MONA': ['lb', 'vg'],
'MOON': ['wn'],
'MUE': ['lb', 'vg'],
'MXT': ['wn'],
'MYR': ['pc'],
'MYRIAD': ['vg', 'wn'],
'MZC': ['lb', 'pc', 'vg', 'wn'],
'NEOS': ['lb', 'vg'],
'NEVA': ['wn'],
'NKA': ['wn'],
'NLG': ['vg', 'wn'],
'NMC': ['lb', 'vg'],
'NVC': ['lb', 'vg', 'wn'],
'OK': ['lb', 'vg'],
'OMC': ['vg', 'wn'],
'ONION': ['vg', 'wn'],
'PART': ['wn'],
'PINK': ['vg', 'wn'],
'PIVX': ['wn'],
'PKB': ['lb', 'vg', 'wn'],
'PND': ['lb', 'vg', 'wn'],
'POT': ['lb', 'vg', 'wn'],
'PPC': ['lb', 'vg', 'wn'],
'PTC': ['vg', 'wn'],
'PXC': ['wn'],
'QRK': ['wn'],
'RAIN': ['wn'],
'RBT': ['wn'],
'RBY': ['lb', 'vg'],
'RDD': ['vg', 'wn'],
'RIC': ['pc', 'vg', 'wn'],
'SDC': ['lb', 'vg'],
'SIB': ['wn'],
'SMLY': ['wn'],
'SONG': ['wn'],
'SPR': ['vg', 'wn'],
'START': ['lb', 'vg'],
'SYS': ['wn'],
'TAJ': ['wn'],
'TIT': ['wn'],
'TPC': ['lb', 'vg'],
'TRC': ['wn'],
'TTC': ['wn'],
'TX': ['wn'],
'UNO': ['pc', 'vg', 'wn'],
'VIA': ['lb', 'pc', 'vg', 'wn'],
'VPN': ['lb', 'vg'],
'VTC': ['lb', 'vg', 'wn'],
'WDC': ['vg', 'wn'],
'WISC': ['wn'],
'WKC': ['vg', 'wn'],
'WSX': ['wn'],
'XCN': ['wn'],
'XGB': ['wn'],
'XPM': ['lb', 'vg', 'wn'],
'XST': ['wn'],
'XVC': ['wn'],
'ZET': ['wn'],
'ZOOM': ['lb', 'vg'],
'ZRC': ['lb', 'vg']
}
@classmethod
def verify_leading_symbols(cls, quiet=False, verbose=False):
for network in ('mainnet', 'testnet'):
for coin in [e.symbol for e in cls.coin_constants[network]]:
e = cls.get_entry(coin, network)
cdata = (network, coin, e, 'Computed value', verbose)
if not quiet:
msg(f'{coin} {network}')
vn_info = e.p2pkh_info
ret = cls.find_addr_leading_symbol(vn_info[0])
test_equal('P2PKH leading symbol', vn_info[1], ret, *cdata)
vn_info = e.p2sh_info
if vn_info:
ret = cls.find_addr_leading_symbol(vn_info[0])
test_equal('P2SH leading symbol', vn_info[1], ret, *cdata)
@classmethod
def verify_core_coin_data(cls, cfg, quiet=False, verbose=False):
from mmgen.protocol import CoinProtocol, init_proto
for network in ('mainnet', 'testnet'):
for coin in gc.core_coins:
e = cls.get_entry(coin, network)
if e:
proto = init_proto(cfg, coin, network=network)
cdata = (network, coin, e, type(proto).__name__, verbose)
if not quiet:
msg(f'Verifying {coin.upper()} {network}')
if coin != 'bch': # TODO
test_equal('coin name', e.name, proto.name, *cdata)
if e.trust_level != -1:
test_equal('Trust level', e.trust_level, CoinProtocol.coins[coin].trust_level, *cdata)
test_equal(
'WIF version number',
e.wif_ver_num,
int.from_bytes(proto.wif_ver_bytes['std'], 'big'),
*cdata)
test_equal(
'P2PKH version number',
e.p2pkh_info[0],
int.from_bytes(proto.addr_fmt_to_ver_bytes['p2pkh'], 'big'),
*cdata)
test_equal(
'P2SH version number',
e.p2sh_info[0],
int.from_bytes(proto.addr_fmt_to_ver_bytes['p2sh'], 'big'),
*cdata)
# Data is one of the coin_constants lists above. Normalize ints to hex of correct width, add
# missing leading letters, set trust level from external_tests.
# Insert a coin entry from outside source, set version info leading letters to '?' and trust level
# to 0, then run TestCoinInfo.fix_table(data). 'has_segwit' field is updated manually for now.
@classmethod
def fix_table(cls, data):
import re
def myhex(n):
return '0x{:0{}x}'.format(n, 2 if n < 256 else 4)
def fix_ver_info(e, k):
e[k] = list(e[k])
e[k][0] = myhex(e[k][0])
s1 = cls.find_addr_leading_symbol(int(e[k][0][2:], 16))
m = f'Fixing leading address letter for coin {e["symbol"]} ({e[k][1]!r} --> {s1})'
if e[k][1] != '?':
assert s1 == e[k][1], f'First letters do not match! {m}'
else:
msg(m)
e[k][1] = s1
e[k] = tuple(e[k])
old_sym = None
for sym in sorted([e.symbol for e in data]):
if sym == old_sym:
msg(f'{sym!r}: duplicate coin symbol in data!')
sys.exit(2)
old_sym = sym
tt = cls.create_trust_table()
name_w = max(len(e.name) for e in data)
fs = '\t({:%s} {:10} {:7} {:17} {:17} {:6} {}),' % (name_w+3)
for e in data:
e = e._asdict()
e['wif_ver_num'] = myhex(e['wif_ver_num'])
sym, trust = e['symbol'], e['trust_level']
fix_ver_info(e, 'p2pkh_info')
if isinstance(e['p2sh_info'], tuple):
fix_ver_info(e, 'p2sh_info')
for k in e.keys():
e[k] = repr(e[k])
e[k] = re.sub(r"'0x(..)'", r'0x\1', e[k])
e[k] = re.sub(r"'0x(....)'", r'0x\1', e[k])
e[k] = re.sub(r' ', r'', e[k]) + ('', ',')[k != 'trust_level']
if trust != -1:
if sym in tt:
src = tt[sym]
if src != trust:
msg(f'Updating trust for coin {sym!r}: {trust} -> {src}')
e['trust_level'] = src
else:
if trust != 0:
msg(f'Downgrading trust for coin {sym!r}: {trust} -> 0')
e['trust_level'] = 0
if sym in cls.cross_checks:
if int(e['trust_level']) == 0 and len(cls.cross_checks[sym]) > 1:
msg(f'Upgrading trust for coin {sym!r}: {e["trust_level"]} -> 1')
e['trust_level'] = 1
print(fs.format(*e.values()))
msg(f'Processed {len(data)} entries')
@classmethod
def find_addr_leading_symbol(cls, ver_num, verbose=False):
if ver_num == 0:
return '1'
def phash2addr(ver_num, pk_hash):
from mmgen.proto.btc.common import b58chk_encode
bl = ver_num.bit_length()
ver_bytes = int.to_bytes(ver_num, bl//8 + bool(bl%8), 'big')
return b58chk_encode(ver_bytes + pk_hash)
low = phash2addr(ver_num, b'\x00'*20)
high = phash2addr(ver_num, b'\xff'*20)
if verbose:
print('low address: ' + low)
print('high address: ' + high)
l1, h1 = low[0], high[0]
return (l1, h1) if l1 != h1 else l1
@classmethod
def print_symbols(cls, include_names=False, reverse=False):
for e in cls.coin_constants['mainnet']:
if reverse:
print(f'{e.symbol:6} {e.name}')
else:
name_w = max(len(e.name) for e in cls.coin_constants['mainnet'])
print((f'{e.name:{name_w}} ' if include_names else '') + e.symbol)
@classmethod
def create_trust_table(cls):
tt = {}
mn = cls.external_tests['mainnet']
for ext_prog in mn:
assert len(set(mn[ext_prog])) == len(mn[ext_prog]), f'Duplicate entry in {ext_prog!r}!'
for coin in mn[ext_prog]:
if coin in tt:
tt[coin] += 1
else:
tt[coin] = 1
for k in cls.trust_override:
tt[k] = cls.trust_override[k]
return tt
trust_override = {'BTC':3, 'BCH':3, 'LTC':3, 'DASH':1, 'EMC':2}
@classmethod
def get_test_support(cls, coin, addr_type, network, toolname=None, verbose=False):
"""
If requested tool supports coin/addr_type/network triplet, return tool name.
If 'tool' is None, return tool that supports coin/addr_type/network triplet.
Return None on failure.
"""
all_tools = [toolname] if toolname else list(cls.external_tests[network].keys())
coin = coin.upper()
for tool in all_tools:
if coin in cls.external_tests[network][tool]:
break
else:
if verbose:
m1 = 'Requested tool {t!r} does not support coin {c} on network {n}'
m2 = 'No test tool found for coin {c} on network {n}'
msg((m1 if toolname else m2).format(t=tool, c=coin, n=network))
return None
if addr_type == 'zcash_z':
if toolname in (None, 'zcash-mini'):
return 'zcash-mini'
else:
if verbose:
msg(f"Address type {addr_type!r} supported only by tool 'zcash-mini'")
return None
try:
bl = cls.external_tests_blacklist[addr_type][tool]
except:
pass
else:
if bl is True or coin in bl:
if verbose:
msg(f'Tool {tool!r} blacklisted for coin {coin}, addr_type {addr_type!r}')
return None
if toolname: # skip whitelists
return tool
if addr_type in ('segwit', 'bech32'):
st = cls.external_tests_segwit_whitelist
if addr_type in st and coin in st[addr_type]:
return tool
else:
if verbose:
m1 = 'Requested tool {t!r} does not support coin {c}, addr_type {a!r}, on network {n}'
m2 = 'No test tool found supporting coin {c}, addr_type {a!r}, on network {n}'
msg((m1 if toolname else m2).format(t=tool, c=coin, n=network, a=addr_type))
return None
return tool
external_tests = {
'mainnet': {
# List in order of preference.
# If 'tool' is not specified, the first tool supporting the coin will be selected.
'pycoin': (
'DASH', # only compressed
'BCH',
'BTC', 'LTC', 'VIA', 'FTC', 'DOGE', 'MEC',
'JBS', 'MZC', 'RIC', 'DFC', 'FAI', 'ARG', 'ZEC', 'DCR'),
'keyconv': ( # broken: PIVX
'BCH', '42', 'AC', 'AIB', 'ANC', 'ARS', 'ATMOS', 'AUR', 'BLK', 'BQC', 'BTC', 'TEST',
'BTCD', 'CCC', 'CCN', 'CDN', 'CLAM', 'CNC', 'CNOTE', 'CON', 'CRW', 'DEEPONION', 'DGB',
'DGC', 'DMD', 'DOGED', 'DOGE', 'DOPE', 'DVC', 'EFL', 'EMC', 'EXCL', 'FAIR', 'FLOZ', 'FTC',
'GAME', 'GAP', 'GCR', 'GRC', 'GRS', 'GUN', 'HAM', 'HODL', 'IXC', 'JBS', 'LBRY', 'LEAF',
'LTC', 'MMC', 'MONA', 'MUE', 'MYRIAD', 'MZC', 'NEOS', 'NLG', 'NMC', 'NVC', 'NYAN', 'OK',
'OMC', 'PIGGY', 'PINK', 'PKB', 'PND', 'POT', 'PPC', 'PTC', 'PTS', 'QTUM', 'RBY', 'RDD',
'RIC', 'SCA', 'SDC', 'SKC', 'SPR', 'START', 'SXC', 'TPC', 'UIS', 'UNO', 'VIA', 'VPN',
'VTC', 'WDC', 'WKC', 'WUBS', 'XC', 'XPM', 'YAC', 'ZOOM', 'ZRC'),
'eth-keys': ('ETH', 'ETC'),
'zcash-mini': ('ZEC',),
'monero-python': ('XMR',),
},
'testnet': {
'pycoin': {
'DASH':'tDASH', # only compressed
'BCH':'XTN',
'BTC':'XTN', 'LTC':'XLT', 'VIA':'TVI', 'FTC':'FTX', 'DOGE':'XDT', 'DCR':'DCRT'
},
'eth-keys': {},
'keyconv': {}
}
}
external_tests_segwit_whitelist = {
# Whitelists apply to the *first* tool in cls.external_tests supporting the given coin/addr_type.
# They're ignored if specific tool is requested.
'segwit': ('BTC',), # LTC Segwit broken on pycoin: uses old fmt
'bech32': ('BTC', 'LTC'),
'compressed': (
'BTC', 'LTC', 'VIA', 'FTC', 'DOGE', 'DASH', 'MEC', 'MYR', 'UNO',
'JBS', 'MZC', 'RIC', 'DFC', 'FAI', 'ARG', 'ZEC', 'DCR', 'ZEC'
),
}
external_tests_blacklist = {
# Unconditionally block testing of the given coin/addr_type with given tool, or all coins if True
'legacy': {},
'segwit': {'keyconv': True},
'bech32': {'keyconv': True},
}
if __name__ == '__main__':
opts_data = {
'text': {
'desc': 'Check altcoin data',
'usage':'[opts]',
'options': '-q, --quiet Be quieter\n-v, --verbose Be more verbose'
}
}
cfg = Config(opts_data=opts_data, need_amt=False)
msg('Checking CoinInfo WIF/P2PKH/P2SH version numbers and trust levels against protocol.py')
TestCoinInfo.verify_core_coin_data(cfg, cfg.quiet, cfg.verbose)
msg('Checking CoinInfo address leading symbols')
TestCoinInfo.verify_leading_symbols(cfg.quiet, cfg.verbose)