|
|
#!/usr/bin/env python3
|
|
|
# Copyright (c) 2016-2022 The Bitcoin Core developers
|
|
|
# Distributed under the MIT software license, see the accompanying
|
|
|
# file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
|
|
"""Test label RPCs.
|
|
|
|
|
|
RPCs tested are:
|
|
|
- getaddressesbylabel
|
|
|
- listaddressgroupings
|
|
|
- setlabel
|
|
|
"""
|
|
|
from collections import defaultdict
|
|
|
|
|
|
from test_framework.blocktools import COINBASE_MATURITY
|
|
|
from test_framework.test_framework import BitcoinTestFramework
|
|
|
from test_framework.util import assert_equal, assert_raises_rpc_error
|
|
|
from test_framework.wallet_util import test_address
|
|
|
|
|
|
|
|
|
class WalletLabelsTest(BitcoinTestFramework):
|
|
|
def add_options(self, parser):
|
|
|
self.add_wallet_options(parser)
|
|
|
|
|
|
def set_test_params(self):
|
|
|
self.setup_clean_chain = True
|
|
|
self.num_nodes = 2
|
|
|
|
|
|
def skip_test_if_missing_module(self):
|
|
|
self.skip_if_no_wallet()
|
|
|
|
|
|
def invalid_label_name_test(self):
|
|
|
node = self.nodes[0]
|
|
|
address = node.getnewaddress()
|
|
|
pubkey = node.getaddressinfo(address)['pubkey']
|
|
|
rpc_calls = [
|
|
|
[node.getnewaddress],
|
|
|
[node.setlabel, address],
|
|
|
[node.getaddressesbylabel],
|
|
|
[node.importpubkey, pubkey],
|
|
|
[node.addmultisigaddress, 1, [pubkey]],
|
|
|
[node.getreceivedbylabel],
|
|
|
[node.listsinceblock, node.getblockhash(0), 1, False, True, False],
|
|
|
]
|
|
|
if self.options.descriptors:
|
|
|
response = node.importdescriptors([{
|
|
|
'desc': f'pkh({pubkey})',
|
|
|
'label': '*',
|
|
|
'timestamp': 'now',
|
|
|
}])
|
|
|
else:
|
|
|
rpc_calls.extend([
|
|
|
[node.importprivkey, node.dumpprivkey(address)],
|
|
|
[node.importaddress, address],
|
|
|
])
|
|
|
|
|
|
response = node.importmulti([{
|
|
|
'scriptPubKey': {'address': address},
|
|
|
'label': '*',
|
|
|
'timestamp': 'now',
|
|
|
}])
|
|
|
|
|
|
assert_equal(response[0]['success'], False)
|
|
|
assert_equal(response[0]['error']['code'], -11)
|
|
|
assert_equal(response[0]['error']['message'], "Invalid label name")
|
|
|
|
|
|
for rpc_call in rpc_calls:
|
|
|
assert_raises_rpc_error(-11, "Invalid label name", *rpc_call, "*")
|
|
|
|
|
|
def run_test(self):
|
|
|
# Check that there's no UTXO on the node
|
|
|
node = self.nodes[0]
|
|
|
assert_equal(len(node.listunspent()), 0)
|
|
|
|
|
|
self.log.info("Checking listlabels' invalid parameters")
|
|
|
assert_raises_rpc_error(-8, "Invalid 'purpose' argument, must be a known purpose string, typically 'send', or 'receive'.", node.listlabels, "notavalidpurpose")
|
|
|
assert_raises_rpc_error(-8, "Invalid 'purpose' argument, must be a known purpose string, typically 'send', or 'receive'.", node.listlabels, "unknown")
|
|
|
|
|
|
# Note each time we call generate, all generated coins go into
|
|
|
# the same address, so we call twice to get two addresses w/50 each
|
|
|
self.generatetoaddress(node, nblocks=1, address=node.getnewaddress(label='coinbase'))
|
|
|
self.generatetoaddress(node, nblocks=COINBASE_MATURITY + 1, address=node.getnewaddress(label='coinbase'))
|
|
|
assert_equal(node.getbalance(), 100)
|
|
|
|
|
|
# there should be 2 address groups
|
|
|
# each with 1 address with a balance of 50 Bitcoins
|
|
|
address_groups = node.listaddressgroupings()
|
|
|
assert_equal(len(address_groups), 2)
|
|
|
# the addresses aren't linked now, but will be after we send to the
|
|
|
# common address
|
|
|
linked_addresses = set()
|
|
|
for address_group in address_groups:
|
|
|
assert_equal(len(address_group), 1)
|
|
|
assert_equal(len(address_group[0]), 3)
|
|
|
assert_equal(address_group[0][1], 50)
|
|
|
assert_equal(address_group[0][2], 'coinbase')
|
|
|
linked_addresses.add(address_group[0][0])
|
|
|
|
|
|
# send 50 from each address to a third address not in this wallet
|
|
|
common_address = "msf4WtN1YQKXvNtvdFYt9JBnUD2FB41kjr"
|
|
|
node.sendmany(
|
|
|
amounts={common_address: 100},
|
|
|
subtractfeefrom=[common_address],
|
|
|
minconf=1,
|
|
|
)
|
|
|
# there should be 1 address group, with the previously
|
|
|
# unlinked addresses now linked (they both have 0 balance)
|
|
|
address_groups = node.listaddressgroupings()
|
|
|
assert_equal(len(address_groups), 1)
|
|
|
assert_equal(len(address_groups[0]), 2)
|
|
|
assert_equal(set([a[0] for a in address_groups[0]]), linked_addresses)
|
|
|
assert_equal([a[1] for a in address_groups[0]], [0, 0])
|
|
|
|
|
|
self.generate(node, 1)
|
|
|
|
|
|
# we want to reset so that the "" label has what's expected.
|
|
|
# otherwise we're off by exactly the fee amount as that's mined
|
|
|
# and matures in the next 100 blocks
|
|
|
amount_to_send = 1.0
|
|
|
|
|
|
# Create labels and make sure subsequent label API calls
|
|
|
# recognize the label/address associations.
|
|
|
labels = [Label(name) for name in ("a", "b", "c", "d", "e")]
|
|
|
for label in labels:
|
|
|
address = node.getnewaddress(label.name)
|
|
|
label.add_receive_address(address)
|
|
|
label.verify(node)
|
|
|
|
|
|
# Check listlabels when passing 'purpose'
|
|
|
node2_addr = self.nodes[1].getnewaddress()
|
|
|
node.setlabel(node2_addr, "node2_addr")
|
|
|
assert_equal(node.listlabels(purpose="send"), ["node2_addr"])
|
|
|
assert_equal(node.listlabels(purpose="receive"), sorted(['coinbase'] + [label.name for label in labels]))
|
|
|
|
|
|
# Check all labels are returned by listlabels.
|
|
|
assert_equal(node.listlabels(), sorted(['coinbase'] + [label.name for label in labels] + ["node2_addr"]))
|
|
|
|
|
|
# Send a transaction to each label.
|
|
|
for label in labels:
|
|
|
node.sendtoaddress(label.addresses[0], amount_to_send)
|
|
|
label.verify(node)
|
|
|
|
|
|
# Check the amounts received.
|
|
|
self.generate(node, 1)
|
|
|
for label in labels:
|
|
|
assert_equal(
|
|
|
node.getreceivedbyaddress(label.addresses[0]), amount_to_send)
|
|
|
assert_equal(node.getreceivedbylabel(label.name), amount_to_send)
|
|
|
|
|
|
for i, label in enumerate(labels):
|
|
|
to_label = labels[(i + 1) % len(labels)]
|
|
|
node.sendtoaddress(to_label.addresses[0], amount_to_send)
|
|
|
self.generate(node, 1)
|
|
|
for label in labels:
|
|
|
address = node.getnewaddress(label.name)
|
|
|
label.add_receive_address(address)
|
|
|
label.verify(node)
|
|
|
assert_equal(node.getreceivedbylabel(label.name), 2)
|
|
|
label.verify(node)
|
|
|
self.generate(node, COINBASE_MATURITY + 1)
|
|
|
|
|
|
# Check that setlabel can assign a label to a new unused address.
|
|
|
for label in labels:
|
|
|
address = node.getnewaddress()
|
|
|
node.setlabel(address, label.name)
|
|
|
label.add_address(address)
|
|
|
label.verify(node)
|
|
|
assert_raises_rpc_error(-11, "No addresses with label", node.getaddressesbylabel, "")
|
|
|
|
|
|
# Check that addmultisigaddress can assign labels.
|
|
|
if not self.options.descriptors:
|
|
|
for label in labels:
|
|
|
addresses = []
|
|
|
for _ in range(10):
|
|
|
addresses.append(node.getnewaddress())
|
|
|
multisig_address = node.addmultisigaddress(5, addresses, label.name)['address']
|
|
|
label.add_address(multisig_address)
|
|
|
label.purpose[multisig_address] = "send"
|
|
|
label.verify(node)
|
|
|
self.generate(node, COINBASE_MATURITY + 1)
|
|
|
|
|
|
# Check that setlabel can change the label of an address from a
|
|
|
# different label.
|
|
|
change_label(node, labels[0].addresses[0], labels[0], labels[1])
|
|
|
|
|
|
# Check that setlabel can set the label of an address already
|
|
|
# in the label. This is a no-op.
|
|
|
change_label(node, labels[2].addresses[0], labels[2], labels[2])
|
|
|
|
|
|
self.invalid_label_name_test()
|
|
|
|
|
|
if self.options.descriptors:
|
|
|
# This is a descriptor wallet test because of segwit v1+ addresses
|
|
|
self.log.info('Check watchonly labels')
|
|
|
node.createwallet(wallet_name='watch_only', disable_private_keys=True)
|
|
|
wallet_watch_only = node.get_wallet_rpc('watch_only')
|
|
|
BECH32_VALID = {
|
|
|
'✔️_VER15_PROG40': 'bcrt10qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqxkg7fn',
|
|
|
'✔️_VER16_PROG03': 'bcrt1sqqqqq8uhdgr',
|
|
|
'✔️_VER16_PROB02': 'bcrt1sqqqq4wstyw',
|
|
|
}
|
|
|
BECH32_INVALID = {
|
|
|
'❌_VER15_PROG41': 'bcrt1sqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqajlxj8',
|
|
|
'❌_VER16_PROB01': 'bcrt1sqq5r4036',
|
|
|
}
|
|
|
for l in BECH32_VALID:
|
|
|
ad = BECH32_VALID[l]
|
|
|
wallet_watch_only.importaddress(label=l, rescan=False, address=ad)
|
|
|
self.generatetoaddress(node, 1, ad)
|
|
|
assert_equal(wallet_watch_only.getaddressesbylabel(label=l), {ad: {'purpose': 'receive'}})
|
|
|
assert_equal(wallet_watch_only.getreceivedbylabel(label=l), 0)
|
|
|
for l in BECH32_INVALID:
|
|
|
ad = BECH32_INVALID[l]
|
|
|
assert_raises_rpc_error(
|
|
|
-5,
|
|
|
"Address is not valid" if self.options.descriptors else "Invalid Bitcoin address or script",
|
|
|
lambda: wallet_watch_only.importaddress(label=l, rescan=False, address=ad),
|
|
|
)
|
|
|
|
|
|
|
|
|
class Label:
|
|
|
def __init__(self, name):
|
|
|
# Label name
|
|
|
self.name = name
|
|
|
# Current receiving address associated with this label.
|
|
|
self.receive_address = None
|
|
|
# List of all addresses assigned with this label
|
|
|
self.addresses = []
|
|
|
# Map of address to address purpose
|
|
|
self.purpose = defaultdict(lambda: "receive")
|
|
|
|
|
|
def add_address(self, address):
|
|
|
assert_equal(address not in self.addresses, True)
|
|
|
self.addresses.append(address)
|
|
|
|
|
|
def add_receive_address(self, address):
|
|
|
self.add_address(address)
|
|
|
|
|
|
def verify(self, node):
|
|
|
if self.receive_address is not None:
|
|
|
assert self.receive_address in self.addresses
|
|
|
for address in self.addresses:
|
|
|
test_address(node, address, labels=[self.name])
|
|
|
assert self.name in node.listlabels()
|
|
|
assert_equal(
|
|
|
node.getaddressesbylabel(self.name),
|
|
|
{address: {"purpose": self.purpose[address]} for address in self.addresses})
|
|
|
|
|
|
def change_label(node, address, old_label, new_label):
|
|
|
assert_equal(address in old_label.addresses, True)
|
|
|
node.setlabel(address, new_label.name)
|
|
|
|
|
|
old_label.addresses.remove(address)
|
|
|
new_label.add_address(address)
|
|
|
|
|
|
old_label.verify(node)
|
|
|
new_label.verify(node)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
|
WalletLabelsTest(__file__).main()
|
