#!/usr/bin/env python3 # Copyright (c) 2019-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 the generation of UTXO snapshots using `dumptxoutset`. """ 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, sha256sum_file, ) import hashlib import os class DumptxoutsetTest(BitcoinTestFramework): def set_test_params(self): self.setup_clean_chain = True self.num_nodes = 1 @staticmethod def check_output_file(path, is_human_readable, expected_digest): with open(str(path), 'rb') as f: content = f.read() if is_human_readable: # Normalise platform EOL to \n, while making sure any stray \n becomes a literal backslash+n to avoid a false positive # This ensures the platform EOL and only the platform EOL produces the expected hash linesep = os.linesep.encode('utf8') content = b'\n'.join(line.replace(b'\n', b'\\n') for line in content.split(linesep)) digest = hashlib.sha256(content).hexdigest() # UTXO snapshot hash should be deterministic based on mocked time. assert_equal(digest, expected_digest) def test_dump_file(self, testname, params, expected_digest): node = self.nodes[0] self.log.info(testname) filename = testname + '_txoutset.dat' is_human_readable = not params.get('format') is None out = node.dumptxoutset(path=filename, **params) expected_path = node.datadir_path / self.chain / filename assert expected_path.is_file() assert_equal(out['coins_written'], 100) assert_equal(out['base_height'], 100) assert_equal(out['path'], str(expected_path)) # Blockhash should be deterministic based on mocked time. assert_equal( out['base_hash'], '09abf0e7b510f61ca6cf33bab104e9ee99b3528b371d27a2d4b39abb800fba7e') self.check_output_file(expected_path, is_human_readable, expected_digest) assert_equal( out['txoutset_hash'], 'a0b7baa3bf5ccbd3279728f230d7ca0c44a76e9923fca8f32dbfd08d65ea496a') assert_equal(out['nchaintx'], 101) self.log.info("Test that a path to an existing or invalid file will fail") assert_raises_rpc_error( -8, '{} already exists'.format(filename), node.dumptxoutset, filename) invalid_path = node.datadir_path / "invalid" / "path" assert_raises_rpc_error( -8, "Couldn't open file {}.incomplete for writing".format(invalid_path), node.dumptxoutset, invalid_path) if params.get('format') == (): with open(expected_path, 'r', encoding='utf-8') as f: content = f.readlines() sep = params.get('separator', ',') if params.get('show_header', True): assert_equal(content.pop(0).rstrip(), "#(blockhash 09abf0e7b510f61ca6cf33bab104e9ee99b3528b371d27a2d4b39abb800fba7e ) txid{s}vout{s}value{s}coinbase{s}height{s}scriptPubKey".format(s=sep)) assert_equal(content[0].rstrip(), "b9edce02689692b1cdc3440d03011486a27c46b966248b922cc6e4315e900708{s}0{s}5000000000{s}1{s}78{s}76a9142b4569203694fc997e13f2c0a1383b9e16c77a0d88ac".format(s=sep)) def run_test(self): """Test a trivial usage of the dumptxoutset RPC command.""" node = self.nodes[0] mocktime = node.getblockheader(node.getblockhash(0))['time'] + 1 node.setmocktime(mocktime) self.generate(node, COINBASE_MATURITY) self.test_dump_file('no_option', {}, '31fcdd0cf542a4b1dfc13c3c05106620ce48951ef62907dd8e5e8c15a0aa993b') self.test_dump_file('all_data', {'format': ()}, '50d7bf3ecca8c5daf648aca884b91496386d8269ef001ff95a1db4381d399bfb') self.test_dump_file('partial_data_1', {'format': ('txid',)}, 'f9966db510b46d865a9412da88d17ac2c05c6bfe612ffc7c1b004aec1b508c5c') self.test_dump_file('partial_data_order', {'format': ('height', 'vout')}, '0ef7e361fde77f5c9f3667b1d8ce4351ec8dc81826937da0dab5631e2aedc5fe') self.test_dump_file('partial_data_double', {'format': ('scriptPubKey', 'scriptPubKey')}, '8bd128d326b971ea37bd28c016aae506e29d23dac578edd849636a8ab2ee31a8') self.test_dump_file('no_header', {'format': (), 'show_header': False}, 'af1f38ee1d1b8bbdc117ab7e8353910dab5ab45f18be27aa4fa7d96ccc96a050') self.test_dump_file('separator', {'format': (), 'separator': ':'}, '5bee81096e400d1b3bf02de432e0fd4af8f4d9244907dc1c857ec329c5ce4490') self.test_dump_file('all_options', {'format': (), 'show_header': False, 'separator': ':'}, '5c52c2a9bdb23946eb0f6d088f25ed8f5d9ebc3a3512182287975f1041cdedb4') # Other failing tests assert_raises_rpc_error( -8, 'unable to find item \'sample\'', node.dumptxoutset, path='xxx', format=['sample']) if __name__ == '__main__': DumptxoutsetTest(__file__).main()