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.

8,466 bytes · SHA-256 89c365280321b805… · View upstream ↗

1#!/usr/bin/env python3
2# Copyright (c) 2016-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 NULLDUMMY softfork.
6
7Connect to a single node.
8Generate 2 blocks (save the coinbases for later).
9Generate COINBASE_MATURITY (CB) more blocks to ensure the coinbases are mature.
10[Policy/Consensus] Check that NULLDUMMY compliant transactions are accepted in block CB + 3.
11[Policy] Check that non-NULLDUMMY transactions are rejected before activation.
12[Consensus] Check that the new NULLDUMMY rules are not enforced on block CB + 4.
13[Policy/Consensus] Check that the new NULLDUMMY rules are enforced on block CB + 5.
14"""
15import time
16
17from test_framework.address import address_to_scriptpubkey
18from test_framework.blocktools import (
19    COINBASE_MATURITY,
20    NORMAL_GBT_REQUEST_PARAMS,
21    add_witness_commitment,
22    create_block,
23)
24from test_framework.messages import (
25    CTransaction,
26    tx_from_hex,
27)
28from test_framework.script import (
29    OP_0,
30    OP_TRUE,
31)
32from test_framework.test_framework import BitcoinTestFramework
33from test_framework.util import (
34    assert_equal,
35    assert_raises_rpc_error,
36)
37from test_framework.wallet import getnewdestination
38from test_framework.wallet_util import generate_keypair
39
40NULLDUMMY_TX_ERROR = "mempool-script-verify-flag-failed (Dummy CHECKMULTISIG argument must be zero)"
41NULLDUMMY_BLK_ERROR = "block-script-verify-flag-failed (Dummy CHECKMULTISIG argument must be zero)"
42
43def invalidate_nulldummy_tx(tx):
44    """Transform a NULLDUMMY compliant tx (i.e. scriptSig starts with OP_0)
45    to be non-NULLDUMMY compliant by replacing the dummy with OP_TRUE"""
46    assert_equal(tx.vin[0].scriptSig[0], OP_0)
47    tx.vin[0].scriptSig = bytes([OP_TRUE]) + tx.vin[0].scriptSig[1:]
48
49
50class NULLDUMMYTest(BitcoinTestFramework):
51    def set_test_params(self):
52        self.num_nodes = 1
53        self.setup_clean_chain = True
54        # This script tests NULLDUMMY activation, which is part of the 'segwit' deployment, so we go through
55        # normal segwit activation here (and don't use the default always-on behaviour).
56        self.extra_args = [[
57            f'-testactivationheight=segwit@{COINBASE_MATURITY + 5}',
58            '-addresstype=legacy',
59        ]]
60
61    def create_transaction(self, *, txid, input_details=None, addr, amount, privkey):
62        input = {"txid": txid, "vout": 0}
63        output = {addr: amount}
64        rawtx = self.nodes[0].createrawtransaction([input], output)
65        # Details only needed for scripthash or witness spends
66        input = None if not input_details else [{**input, **input_details}]
67        signedtx = self.nodes[0].signrawtransactionwithkey(rawtx, [privkey], input)
68        return tx_from_hex(signedtx["hex"])
69
70    def run_test(self):
71        self.privkey, self.pubkey = generate_keypair(wif=True)
72        cms = self.nodes[0].createmultisig(1, [self.pubkey.hex()])
73        wms = self.nodes[0].createmultisig(1, [self.pubkey.hex()], 'p2sh-segwit')
74        self.ms_address = cms["address"]
75        ms_unlock_details = {"scriptPubKey": address_to_scriptpubkey(self.ms_address).hex(),
76                             "redeemScript": cms["redeemScript"]}
77        self.wit_ms_address = wms['address']
78
79        self.coinbase_blocks = self.generate(self.nodes[0], 2)  # block height = 2
80        coinbase_txid = []
81        for i in self.coinbase_blocks:
82            coinbase_txid.append(self.nodes[0].getblock(i)['tx'][0])
83        self.generate(self.nodes[0], COINBASE_MATURITY)  # block height = COINBASE_MATURITY + 2
84        self.lastblockhash = self.nodes[0].getbestblockhash()
85        self.lastblockheight = COINBASE_MATURITY + 2
86        self.lastblocktime = int(time.time()) + self.lastblockheight
87
88        self.log.info(f"Test 1: NULLDUMMY compliant base transactions should be accepted to mempool and mined before activation [{COINBASE_MATURITY + 3}]")
89        test1txs = [self.create_transaction(txid=coinbase_txid[0], addr=self.ms_address, amount=49,
90                                            privkey=self.nodes[0].get_deterministic_priv_key().key)]
91        txid1 = self.nodes[0].sendrawtransaction(test1txs[0].serialize_with_witness().hex(), 0)
92        test1txs.append(self.create_transaction(txid=txid1, input_details=ms_unlock_details,
93                                                addr=self.ms_address, amount=48,
94                                                privkey=self.privkey))
95        txid2 = self.nodes[0].sendrawtransaction(test1txs[1].serialize_with_witness().hex(), 0)
96        test1txs.append(self.create_transaction(txid=coinbase_txid[1],
97                                                addr=self.wit_ms_address, amount=49,
98                                                privkey=self.nodes[0].get_deterministic_priv_key().key))
99        txid3 = self.nodes[0].sendrawtransaction(test1txs[2].serialize_with_witness().hex(), 0)
100        self.block_submit(self.nodes[0], test1txs, accept=True)
101
102        self.log.info("Test 2: Non-NULLDUMMY base multisig transaction should not be accepted to mempool before activation")
103        test2tx = self.create_transaction(txid=txid2, input_details=ms_unlock_details,
104                                          addr=self.ms_address, amount=47,
105                                          privkey=self.privkey)
106        invalidate_nulldummy_tx(test2tx)
107        assert_raises_rpc_error(-26, NULLDUMMY_TX_ERROR, self.nodes[0].sendrawtransaction, test2tx.serialize_with_witness().hex(), 0)
108
109        self.log.info(f"Test 3: Non-NULLDUMMY base transactions should be accepted in a block before activation [{COINBASE_MATURITY + 4}]")
110        self.block_submit(self.nodes[0], [test2tx], accept=True)
111
112        self.log.info("Test 4: Non-NULLDUMMY base multisig transaction is invalid after activation")
113        test4tx = self.create_transaction(txid=test2tx.txid_hex, input_details=ms_unlock_details,
114                                          addr=getnewdestination()[2], amount=46,
115                                          privkey=self.privkey)
116        test6txs = [CTransaction(test4tx)]
117        invalidate_nulldummy_tx(test4tx)
118        assert_raises_rpc_error(-26, NULLDUMMY_TX_ERROR, self.nodes[0].sendrawtransaction, test4tx.serialize_with_witness().hex(), 0)
119        self.block_submit(self.nodes[0], [test4tx], accept=False)
120
121        self.log.info("Test 5: Non-NULLDUMMY P2WSH multisig transaction invalid after activation")
122        test5tx = self.create_transaction(txid=txid3, input_details={"scriptPubKey": test1txs[2].vout[0].scriptPubKey.hex(),
123                                          "amount": 49, "witnessScript": wms["redeemScript"]},
124                                          addr=getnewdestination(address_type='p2sh-segwit')[2], amount=48,
125                                          privkey=self.privkey)
126        test6txs.append(CTransaction(test5tx))
127        test5tx.wit.vtxinwit[0].scriptWitness.stack[0] = b'\x01'
128        assert_raises_rpc_error(-26, NULLDUMMY_TX_ERROR, self.nodes[0].sendrawtransaction, test5tx.serialize_with_witness().hex(), 0)
129        self.block_submit(self.nodes[0], [test5tx], with_witness=True, accept=False)
130
131        self.log.info(f"Test 6: NULLDUMMY compliant base/witness transactions should be accepted to mempool and in block after activation [{COINBASE_MATURITY + 5}]")
132        for i in test6txs:
133            self.nodes[0].sendrawtransaction(i.serialize_with_witness().hex(), 0)
134        self.block_submit(self.nodes[0], test6txs, with_witness=True, accept=True)
135
136    def block_submit(self, node, txs, *, with_witness=False, accept):
137        tmpl = node.getblocktemplate(NORMAL_GBT_REQUEST_PARAMS)
138        assert_equal(tmpl['previousblockhash'], self.lastblockhash)
139        assert_equal(tmpl['height'], self.lastblockheight + 1)
140        block = create_block(tmpl=tmpl, ntime=self.lastblocktime + 1, txlist=txs)
141        if with_witness:
142            add_witness_commitment(block)
143        block.solve()
144        assert_equal(None if accept else NULLDUMMY_BLK_ERROR, node.submitblock(block.serialize().hex()))
145        if accept:
146            assert_equal(node.getbestblockhash(), block.hash_hex)
147            self.lastblockhash = block.hash_hex
148            self.lastblocktime += 1
149            self.lastblockheight += 1
150        else:
151            assert_equal(node.getbestblockhash(), self.lastblockhash)
152
153
154if __name__ == '__main__':
155    NULLDUMMYTest(__file__).main()
156

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.