READ THE CODE

Inside Bitcoin

The code behind the network, with room to understand it.

Stable release v32.1bitcoin/bitcoin · f0de87f04062 ↗3,020 source files · 47.5 MB stored on the server440 file guides

Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.

28,256 bytes · SHA-256 111dd1caa0b4c4a8… · View upstream ↗

1#!/usr/bin/env python3
2# Copyright (c) 2014-present The Bitcoin Core developers
3# Distributed under the MIT software license, see the accompanying
4# file COPYING or http://www.opensource.org/licenses/mit-license.php.
5"""Test the rawtransaction RPCs.
6
7Test the following RPCs:
8   - getrawtransaction
9   - createrawtransaction
10   - signrawtransactionwithwallet
11   - sendrawtransaction
12   - decoderawtransaction
13"""
14
15from collections import OrderedDict
16from decimal import Decimal
17from itertools import product
18
19from test_framework.messages import (
20    MAX_BIP125_RBF_SEQUENCE,
21    COIN,
22    TX_MAX_STANDARD_VERSION,
23    TX_MIN_STANDARD_VERSION,
24    CTransaction,
25    CTxOut,
26    tx_from_hex,
27)
28from test_framework.script import (
29    CScript,
30    OP_FALSE,
31    OP_INVALIDOPCODE,
32    OP_RETURN,
33)
34from test_framework.test_framework import BitcoinTestFramework
35from test_framework.util import (
36    assert_equal,
37    assert_greater_than,
38    assert_raises_rpc_error,
39    sync_txindex,
40)
41from test_framework.wallet import (
42    getnewdestination,
43    MiniWallet,
44)
45
46
47TXID = "1d1d4e24ed99057e84c3f80fd8fbec79ed9e1acee37da269356ecea000000000"
48
49
50class multidict(dict):
51    """Dictionary that allows duplicate keys.
52
53    Constructed with a list of (key, value) tuples. When dumped by the json module,
54    will output invalid json with repeated keys, eg:
55    >>> json.dumps(multidict([(1,2),(1,2)])
56    '{"1": 2, "1": 2}'
57
58    Used to test calls to rpc methods with repeated keys in the json object."""
59
60    def __init__(self, x):
61        dict.__init__(self, x)
62        self.x = x
63
64    def items(self):
65        return self.x
66
67
68class RawTransactionsTest(BitcoinTestFramework):
69    def set_test_params(self):
70        self.num_nodes = 3
71        self.extra_args = [
72            ["-txindex"],
73            [],
74            ["-fastprune", "-prune=1"],
75        ]
76        # whitelist peers to speed up tx relay / mempool sync
77        self.noban_tx_relay = True
78        self.supports_cli = False
79
80    def setup_network(self):
81        super().setup_network()
82        self.connect_nodes(0, 2)
83
84    def run_test(self):
85        self.wallet = MiniWallet(self.nodes[0])
86
87        self.getrawtransaction_tests()
88        self.createrawtransaction_tests()
89        self.sendrawtransaction_tests()
90        self.sendrawtransaction_testmempoolaccept_tests()
91        self.decoderawtransaction_tests()
92        self.transaction_version_number_tests()
93        self.getrawtransaction_verbosity_tests()
94
95    def getrawtransaction_tests(self):
96        tx = self.wallet.send_self_transfer(from_node=self.nodes[0])
97        self.generate(self.nodes[0], 1)
98        txId = tx['txid']
99        err_msg = (
100            "No such mempool transaction. Use -txindex or provide a block hash to enable"
101            " blockchain transaction queries. Use gettransaction for wallet transactions."
102        )
103
104        for n in [0, 2]:
105            self.log.info(f"Test getrawtransaction {'with' if n == 0 else 'without'} -txindex")
106
107            if n == 0:
108                sync_txindex(self, self.nodes[n])
109                # With -txindex.
110                # 1. valid parameters - only supply txid
111                assert_equal(self.nodes[n].getrawtransaction(txId), tx['hex'])
112
113                # 2. valid parameters - supply txid and 0 for non-verbose
114                assert_equal(self.nodes[n].getrawtransaction(txId, 0), tx['hex'])
115
116                # 3. valid parameters - supply txid and False for non-verbose
117                assert_equal(self.nodes[n].getrawtransaction(txId, False), tx['hex'])
118
119                # 4. valid parameters - supply txid and 1 for verbose.
120                # We only check the "hex" field of the output so we don't need to update this test every time the output format changes.
121                assert_equal(self.nodes[n].getrawtransaction(txId, 1)["hex"], tx['hex'])
122                assert_equal(self.nodes[n].getrawtransaction(txId, 2)["hex"], tx['hex'])
123
124                # 5. valid parameters - supply txid and True for non-verbose
125                assert_equal(self.nodes[n].getrawtransaction(txId, True)["hex"], tx['hex'])
126            else:
127                # Without -txindex, expect to raise.
128                for verbose in [None, 0, False, 1, True]:
129                    assert_raises_rpc_error(-5, err_msg, self.nodes[n].getrawtransaction, txId, verbose)
130
131            # 6. invalid parameters - supply txid and invalid boolean values (strings) for verbose
132            for value in ["True", "False"]:
133                assert_raises_rpc_error(-3, "not of expected type number", self.nodes[n].getrawtransaction, txid=txId, verbose=value)
134                assert_raises_rpc_error(-3, "not of expected type number", self.nodes[n].getrawtransaction, txid=txId, verbosity=value)
135
136            # 7. invalid parameters - supply txid and empty array
137            assert_raises_rpc_error(-3, "not of expected type number", self.nodes[n].getrawtransaction, txId, [])
138
139            # 8. invalid parameters - supply txid and empty dict
140            assert_raises_rpc_error(-3, "not of expected type number", self.nodes[n].getrawtransaction, txId, {})
141
142        # Make a tx by sending, then generate 2 blocks; block1 has the tx in it
143        tx = self.wallet.send_self_transfer(from_node=self.nodes[2])['txid']
144        block1, block2 = self.generate(self.nodes[2], 2)
145        for n in [0, 2]:
146            self.log.info(f"Test getrawtransaction {'with' if n == 0 else 'without'} -txindex, with blockhash")
147            # We should be able to get the raw transaction by providing the correct block
148            gottx = self.nodes[n].getrawtransaction(txid=tx, verbose=True, blockhash=block1)
149            assert_equal(gottx['txid'], tx)
150            assert_equal(gottx['in_active_chain'], True)
151            if n == 0:
152                self.log.info("Test getrawtransaction with -txindex, without blockhash: 'in_active_chain' should be absent")
153                for v in [1,2]:
154                    gottx = self.nodes[n].getrawtransaction(txid=tx, verbosity=v)
155                    assert_equal(gottx['txid'], tx)
156                    assert 'in_active_chain' not in gottx
157            else:
158                self.log.info("Test getrawtransaction without -txindex, without blockhash: expect the call to raise")
159                assert_raises_rpc_error(-5, err_msg, self.nodes[n].getrawtransaction, txid=tx, verbose=True)
160            # We should not get the tx if we provide an unrelated block
161            assert_raises_rpc_error(-5, "No such transaction found", self.nodes[n].getrawtransaction, txid=tx, blockhash=block2)
162            # An invalid block hash should raise the correct errors
163            assert_raises_rpc_error(-3, "JSON value of type bool is not of expected type string", self.nodes[n].getrawtransaction, txid=tx, blockhash=True)
164            assert_raises_rpc_error(-8, "parameter 3 must be of length 64 (not 6, for 'foobar')", self.nodes[n].getrawtransaction, txid=tx, blockhash="foobar")
165            assert_raises_rpc_error(-8, "parameter 3 must be of length 64 (not 8, for 'abcd1234')", self.nodes[n].getrawtransaction, txid=tx, blockhash="abcd1234")
166            foo = "ZZZ0000000000000000000000000000000000000000000000000000000000000"
167            assert_raises_rpc_error(-8, f"parameter 3 must be hexadecimal string (not '{foo}')", self.nodes[n].getrawtransaction, txid=tx, blockhash=foo)
168            bar = "0000000000000000000000000000000000000000000000000000000000000000"
169            assert_raises_rpc_error(-5, "Block hash not found", self.nodes[n].getrawtransaction, txid=tx, blockhash=bar)
170            # Undo the blocks and verify that "in_active_chain" is false.
171            self.nodes[n].invalidateblock(block1)
172            gottx = self.nodes[n].getrawtransaction(txid=tx, verbose=True, blockhash=block1)
173            assert_equal(gottx['in_active_chain'], False)
174            self.nodes[n].reconsiderblock(block1)
175            assert_equal(self.nodes[n].getbestblockhash(), block2)
176
177        self.log.info("Test getrawtransaction on genesis block coinbase returns an error")
178        block = self.nodes[0].getblock(self.nodes[0].getblockhash(0))
179        assert_raises_rpc_error(-5, "The genesis block coinbase is not considered an ordinary transaction", self.nodes[0].getrawtransaction, block['merkleroot'])
180
181    def getrawtransaction_verbosity_tests(self):
182        tx = self.wallet.send_self_transfer(from_node=self.nodes[1])['txid']
183        [block1] = self.generate(self.nodes[1], 1)
184        fields = [
185            'blockhash',
186            'blocktime',
187            'confirmations',
188            'hash',
189            'hex',
190            'in_active_chain',
191            'locktime',
192            'size',
193            'time',
194            'txid',
195            'vin',
196            'vout',
197            'vsize',
198            'weight',
199        ]
200        prevout_fields = [
201            'generated',
202            'height',
203            'value',
204            'scriptPubKey',
205        ]
206        script_pub_key_fields = [
207            'address',
208            'asm',
209            'hex',
210            'type',
211        ]
212        # node 0 & 2 with verbosity 1 & 2
213        for n, v in product([0, 2], [1, 2]):
214            self.log.info(f"Test getrawtransaction_verbosity {v} {'with' if n == 0 else 'without'} -txindex, with blockhash")
215            gottx = self.nodes[n].getrawtransaction(txid=tx, verbosity=v, blockhash=block1)
216            missing_fields = set(fields).difference(gottx.keys())
217            if missing_fields:
218                raise AssertionError(f"fields {', '.join(missing_fields)} are not in transaction")
219
220            assert len(gottx['vin']) > 0
221            if v == 1:
222                assert 'fee' not in gottx
223                assert 'prevout' not in gottx['vin'][0]
224            if v == 2:
225                assert isinstance(gottx['fee'], Decimal)
226                assert 'prevout' in gottx['vin'][0]
227                prevout = gottx['vin'][0]['prevout']
228                script_pub_key = prevout['scriptPubKey']
229
230                missing_fields = set(prevout_fields).difference(prevout.keys())
231                if missing_fields:
232                    raise AssertionError(f"fields {', '.join(missing_fields)} are not in transaction")
233
234                missing_fields = set(script_pub_key_fields).difference(script_pub_key.keys())
235                if missing_fields:
236                    raise AssertionError(f"fields {', '.join(missing_fields)} are not in transaction")
237
238        # check verbosity 2 without blockhash but with txindex
239        assert 'fee' in self.nodes[0].getrawtransaction(txid=tx, verbosity=2)
240        # check that coinbase has no fee or does not throw any errors for verbosity 2
241        coin_base = self.nodes[1].getblock(block1)['tx'][0]
242        gottx = self.nodes[1].getrawtransaction(txid=coin_base, verbosity=2, blockhash=block1)
243        assert 'fee' not in gottx
244        # check that verbosity 2 for a mempool tx will fallback to verbosity 1
245        # Do this with a pruned chain, as a regression test for https://github.com/bitcoin/bitcoin/pull/29003
246        self.generate(self.nodes[2], 400)
247        assert_greater_than(self.nodes[2].pruneblockchain(250), 0)
248        mempool_tx = self.wallet.send_self_transfer(from_node=self.nodes[2])['txid']
249        gottx = self.nodes[2].getrawtransaction(txid=mempool_tx, verbosity=2)
250        assert 'fee' not in gottx

src/wallet/receive.cpp

src/wallet/coinselection.cpp

src/consensus/validation.h

src/primitives/transaction.cpp

src/script/descriptor.cpp

src/bitcoin-cli.cpp

src/rpc/blockchain.cpp

src/rpc/rawtransaction.cpp

src/init.cpp

src/crypto/sha256.cpp

src/consensus/merkle.h

src/consensus/tx_check.h

src/consensus/tx_verify.h

src/policy/feerate.h

src/policy/feerate.cpp

src/primitives/transaction_identifier.h

src/chainparamsbase.h

src/chainparamsbase.cpp

src/util/moneystr.cpp

src/crypto/ripemd160.h

src/crypto/sha1.h

src/crypto/sha512.h

src/crypto/hmac_sha256.h

src/crypto/hmac_sha512.h

src/crypto/hmac_sha256.cpp

src/crypto/hmac_sha512.cpp

src/crypto/hkdf_sha256_32.h

src/crypto/hkdf_sha256_32.cpp

src/support/cleanse.h

src/support/cleanse.cpp

src/crypto/siphash.cpp

src/crypto/muhash.h

src/crypto/chacha20.h

src/crypto/poly1305.h

src/crypto/chacha20poly1305.h

src/crypto/chacha20poly1305.cpp

src/util/chaintype.cpp

src/util/obfuscation.h

src/util/byte_units.h

src/util/overflow.h

src/blockencodings.cpp

src/net_permissions.cpp

src/policy/packages.cpp

src/policy/rbf.cpp

src/policy/truc_policy.cpp

src/policy/ephemeral_policy.cpp

src/policy/settings.cpp

src/policy/policy.cpp

src/node/transaction.cpp

src/node/coin.cpp

src/rpc/client.cpp

src/rpc/external_signer.cpp

src/rpc/request.cpp

src/rpc/server_util.cpp

src/rpc/fees.cpp

src/rpc/output_script.cpp

src/rpc/rawtransaction_util.cpp

src/rpc/rawtransaction_util.h

src/rpc/register.h

src/rpc/request.h

src/rpc/server_util.h

src/rpc/protocol.h

src/rpc/server.h

src/rpc/signmessage.cpp

src/rpc/txoutproof.cpp

src/rpc/util.cpp

src/rpc/util.h

src/wallet/rpc/addresses.cpp

src/wallet/rpc/backup.cpp

src/wallet/rpc/coins.cpp

src/wallet/rpc/encrypt.cpp

src/wallet/rpc/signmessage.cpp

src/wallet/rpc/util.cpp

src/wallet/rpc/util.h

src/wallet/coincontrol.cpp

src/wallet/coincontrol.h

src/wallet/context.cpp

src/wallet/context.h

src/wallet/crypter.cpp

src/wallet/crypter.h

src/wallet/db.cpp

src/wallet/export.cpp

src/wallet/external_signer_scriptpubkeyman.cpp

src/wallet/rpc/spend.cpp

src/wallet/rpc/transactions.cpp

src/wallet/rpc/wallet.cpp

src/wallet/feebumper.cpp

src/wallet/feebumper.h

src/index/base.h

src/index/base.cpp

src/index/txindex.h

src/index/txindex.cpp

src/index/txindex_key.h

src/index/txospenderindex.h

src/index/txospenderindex.cpp

src/index/blockfilterindex.h

src/index/blockfilterindex.cpp

src/index/coinstatsindex.h

src/index/coinstatsindex.cpp

src/index/db_key.h

src/index/disktxpos.h

src/kernel/chain.cpp

src/kernel/chain.h

src/kernel/checks.cpp

src/kernel/checks.h

src/kernel/context.cpp

src/kernel/context.h

src/kernel/cs_main.cpp

src/kernel/cs_main.h

src/kernel/disconnected_transactions.cpp

src/kernel/disconnected_transactions.h

src/kernel/mempool_removal_reason.cpp

src/kernel/mempool_removal_reason.h

src/kernel/coinstats.cpp

src/kernel/coinstats.h

src/kernel/chainparams.cpp

src/kernel/chainparams.h

src/wallet/sqlite.cpp

src/wallet/sqlite.h

src/wallet/transaction.cpp

src/wallet/transaction.h

src/wallet/dump.cpp

src/wallet/dump.h

src/wallet/init.cpp

src/wallet/walletutil.cpp

src/wallet/walletutil.h

src/wallet/wallettool.cpp

src/wallet/wallettool.h

src/wallet/export.h

src/wallet/migrate.cpp

src/wallet/migrate.h

src/wallet/db.h

src/wallet/walletdb.cpp

src/wallet/interfaces.cpp

src/wallet/scriptpubkeyman.cpp

src/wallet/scriptpubkeyman.h

src/kernel/bitcoinkernel.cpp

src/kernel/bitcoinkernel.h

src/kernel/bitcoinkernel_wrapper.h

src/node/chainstate.cpp

src/node/chainstate.h

src/node/blockstorage.cpp

src/node/blockstorage.h

src/node/mempool_persist.cpp

src/node/mempool_persist.h

src/node/utxo_snapshot.cpp

src/node/utxo_snapshot.h

src/node/kernel_notifications.cpp

src/node/kernel_notifications.h

src/node/blockmanager_args.cpp

src/kernel/blockmanager_opts.h

src/util/expected.cpp

src/policy/settings.h

src/util/types.h

src/kernel/messagestartchars.h

src/kernel/warning.h

src/util/exception.h

src/common/license_info.h

src/node/coins_view_args.h

src/node/database_args.h

src/util/batchpriority.h

src/util/ui_change_type.h

src/node/coins_view_args.cpp

src/node/peerman_args.h

src/util/serfloat.h

src/node/blockmanager_args.h

src/node/database_args.cpp

src/util/overloaded.h

src/interfaces/types.h

src/node/chainstatemanager_args.h

src/node/minisketchwrapper.h

src/util/macros.h

src/util/syserror.h

src/common/run_command.h

src/util/bytevectorhash.cpp

src/node/mempool_persist_args.cpp

src/util/exec.h

src/util/rbf.h

src/crypto/hex_base.h

src/node/mempool_persist_args.h

src/interfaces/echo.h

src/util/any.h

src/util/batchpriority.cpp

src/util/threadnames.h

src/node/coin.h

src/node/mempool_args.h

src/util/asmap.h

src/util/bytevectorhash.h

src/node/context.cpp

src/util/insert.h

src/util/readwritefile.h

src/node/peerman_args.cpp

src/node/interface_ui.cpp

src/interfaces/handler.h

src/node/mining_args.h

src/util/hasher.cpp

src/common/init.h

src/kernel/mempool_limits.h

src/common/system.h

src/crypto/sha3.h

src/util/threadinterrupt.cpp

src/node/protocol_version.h

src/util/exception.cpp

src/common/messages.h

src/node/connection_types.cpp

src/util/bip32.h

src/common/license_info.cpp

src/util/stdmutex.h

src/common/run_command.cpp

src/util/check.cpp

src/util/golombrice.h

src/node/types.h

src/node/timeoffsets.h

src/util/readwritefile.cpp

src/util/fastrange.h

src/util/signalinterrupt.h

src/util/task_runner.h

src/util/syserror.cpp

src/common/interfaces.cpp

src/common/types.h

src/util/threadinterrupt.h

src/kernel/chainstatemanager_opts.h

src/node/psbt.h

src/policy/ephemeral_policy.h

src/util/trace.h

src/common/url.cpp

src/kernel/mempool_options.h

src/util/serfloat.cpp

src/kernel/notifications_interface.h

src/node/timeoffsets.cpp

src/node/warnings.cpp

src/util/hash_type.h

src/crypto/hex_base.cpp

src/node/eviction.h

src/util/tokenbucket.h

src/crypto/aes.h

src/common/pcp.h

src/util/feefrac.cpp

src/node/transaction.h

src/util/threadnames.cpp

src/common/signmessage.h

src/util/exec.cpp

src/util/signalinterrupt.cpp

src/clientversion.cpp

src/common/signmessage.cpp

src/compat/assumptions.h

src/compat/byteswap.h

src/deploymentinfo.cpp

src/deploymentinfo.h

src/deploymentstatus.cpp

src/deploymentstatus.h

src/dummywallet.cpp

src/external_signer.h

src/init/bitcoin-gui.cpp

src/init/bitcoin-node.cpp

src/init/bitcoin-qt.cpp

src/init/bitcoin-wallet.cpp

src/init/bitcoind.cpp

src/init/common.h

src/interfaces/init.h

src/interfaces/ipc.h

src/key_io.h

src/logging/categories.h

src/logging/timer.h

src/mapport.h

src/musig.h

src/net_permissions.h

src/netgroup.h

src/netmessagemaker.h

src/node/chainstatemanager_args.cpp

src/node/connection_types.h

src/node/context.h

src/node/interface_ui.h

src/node/mempool_args.cpp

src/node/mining_args.cpp

src/node/minisketchwrapper.cpp

src/node/txreconciliation.h

src/policy/fees/estimator_args.cpp

src/policy/fees/estimator_args.h

src/policy/fees/estimator_man.cpp

src/policy/fees/estimator_man.h

src/policy/packages.h

src/policy/rbf.h

src/policy/truc_policy.h

src/pow.h

src/primitives/block.cpp

src/randomenv.h

src/rest.h

src/script/keyorigin.h

src/script/parsing.cpp

src/script/parsing.h

src/script/script_error.h

src/script/sigcache.cpp

src/script/sigcache.h

src/script/solver.h

src/script/verify_flags.h

src/semaphore_grant.h

src/signet.h

src/span.h

src/support/allocators/secure.h

src/support/allocators/zeroafterfree.h

src/util/tokenpipe.cpp

src/util/translation.h

src/util/vector.h

src/versionbits.h

src/versionbits_impl.h

src/wallet/external_signer_scriptpubkeyman.h

src/wallet/fees.h

src/wallet/load.h

src/wallet/receive.h

src/wallet/rpc/wallet.h

src/wallet/types.h

src/walletinitinterface.h

src/zmq/zmqabstractnotifier.cpp

Independent explanations by MyBitcoinExplorer. Not affiliated with or endorsed by Bitcoin Core. Guides are educational and do not replace the source or its tests.

Bitcoin Core source © its contributors, distributed under the MIT license. Original notices and bundled third-party licenses are retained in the source tree.