bitcoin/test/functional/rpc_dumptxoutset.py
w0xlt a42303b506 test: add test for dump human-readable dumptxoutset
Co-authored-by: Luke Dashjr <luke-jr+git@utopios.org>
Co-authored-by: brunoerg <brunoely.gc@gmail.com>
2024-09-03 01:14:37 +00:00

112 lines
5.4 KiB
Python
Executable File

#!/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()