区块链原理 / 系统课时
手动出块并核对交易确认结果
手动出块并核对交易确认结果
在 Bitcoin regtest 网络中,可以通过 generatetoaddress 主动创建区块,不必等待真实矿工。本课将完成一笔钱包转账,分别查询入块前、首次入块后和继续出块后的确认信息,并核对交易所属区块,判断节点是否正确处理了交易确认。
学习目标
- 使用
generatetoaddress创建区块,并理解区块奖励成熟条件。 - 使用
gettransaction和getrawtransaction核对确认数与区块哈希。 - 根据确认数、区块归属和节点链尖定位确认异常。
准备可控的 regtest 环境
以下操作适用于 Bitcoin Core 25.0~30.0,使用 Linux 或 macOS 的 Bash 终端,要求已安装 bitcoind、bitcoin-cli 和 Python 3。实验使用两个新钱包 miner、receiver,命令假定当前 regtest 节点已启动,且这两个钱包尚未创建。
如果节点未启动,先执行 bitcoind -regtest -daemon,等待 RPC 服务就绪。可以使用 bitcoin-cli -regtest getblockchaininfo 检查:返回中的 chain 应为 regtest,而不是 main 或 test。
regtest 允许节点按需挖矿,但新挖出的 Coinbase 奖励必须达到 100 次确认后才能花费。因此先生成 101 个区块,使最早生成的奖励成熟,再由矿工钱包向接收钱包转账 1 BTC。转账手续费明确设置为 2 sat/vB,避免本地测试链缺少费率估计数据时出现费用估计失败。
创建交易并核对三次确认状态
下面是一份完整的 Bash 实验脚本,可直接在满足前置条件的环境中执行。脚本先建立钱包和交易,再依次验证 0、1、2 次确认,并使用包含交易的区块哈希查询原始交易。
set -euo pipefail
# 两个钱包必须尚未创建,避免覆盖已有实验状态
bitcoin-cli -regtest createwallet "miner" >/dev/null
bitcoin-cli -regtest createwallet "receiver" >/dev/null
MINER_ADDRESS=$(bitcoin-cli -regtest -rpcwallet=miner getnewaddress)
RECEIVER_ADDRESS=$(bitcoin-cli -regtest -rpcwallet=receiver getnewaddress)
# 先挖 101 块,使第一块的 Coinbase 奖励可以花费
bitcoin-cli -regtest generatetoaddress 101 "$MINER_ADDRESS" >/dev/null
TXID=$(bitcoin-cli -regtest -rpcwallet=miner -named sendtoaddress \
address="$RECEIVER_ADDRESS" amount=1 fee_rate=2)
# 接收钱包应当已经看到未确认交易
bitcoin-cli -regtest -rpcwallet=receiver gettransaction "$TXID" \
| python3 -c 'import json,sys; d=json.load(sys.stdin); print("出块前确认数:", d["confirmations"])'
# 新区块包含待确认交易,返回值是区块哈希数组
BLOCKHASH=$(bitcoin-cli -regtest generatetoaddress 1 "$MINER_ADDRESS" \
| python3 -c 'import json,sys; print(json.load(sys.stdin)[0])')
bitcoin-cli -regtest -rpcwallet=receiver gettransaction "$TXID" \
| python3 -c 'import json,sys; d=json.load(sys.stdin); print("首次入块确认数:", d["confirmations"])'
# 指定区块哈希,不依赖节点启用 txindex
bitcoin-cli -regtest getrawtransaction "$TXID" 1 "$BLOCKHASH" \
| python3 -c 'import json,sys; d=json.load(sys.stdin); print("原始交易确认数:", d["confirmations"]); print("区块位于活跃链:", d["in_active_chain"])'
# 再添加一个区块,确认数应当递增
bitcoin-cli -regtest generatetoaddress 1 "$MINER_ADDRESS" >/dev/null
bitcoin-cli -regtest -rpcwallet=receiver gettransaction "$TXID" \
| python3 -c 'import json,sys; d=json.load(sys.stdin); print("再次出块确认数:", d["confirmations"])'预期输出:
出块前确认数: 0
首次入块确认数: 1
原始交易确认数: 1
区块位于活跃链: True
再次出块确认数: 2这里输出的是确定性的确认状态,而不是随机生成的交易 ID。实际 TXID 和 BLOCKHASH 均为 64 位十六进制字符串,每次实验可能不同。脚本通过变量传递真实值,不需要手工替换。
如果运行前已有区块,原始链高不一定从 0 开始,但新建交易的确认数仍应按 0、1、2 变化。如果 regtest 已经存在同名钱包,createwallet 会报错;应使用新的测试钱包名称,或者在确认已有钱包状态后改用 loadwallet,不要直接重复创建。
理解确认数与区块归属
未确认交易通常位于节点内存池,尚无有效的入块位置。第一次挖出包含该交易的区块时,确认数为 1;其上再增加一个有效区块,确认数变成 2。只要交易所在区块仍处于活跃链上,后续每新增一个区块,确认数便增加 1。

对于已确认且位于活跃链中的交易,确认数可按下面的关系计算:
其中, 为当前活跃链高度, 为交易所在区块高度。例如,交易位于高度 102,链尖为 103,则确认数为 2。未确认交易没有有效的入块高度,不能直接套用该公式。
gettransaction 是钱包 RPC,只能查询钱包能够识别的交易。它提供 confirmations、blockhash、blockheight、blockindex 等信息,其中部分区块字段只在交易确认后出现。
getrawtransaction 属于节点原始交易查询接口。Bitcoin Core 25.0~30.0 中,第二个参数 1 表示返回详细 JSON;第三个参数明确指定区块哈希,即使没有启用 txindex,也可以查询该区块内的交易。指定区块时,返回的 in_active_chain 可以帮助判断区块是否属于活跃链。
确认结果不一致时如何定位
如果手动挖矿成功,但确认数仍为 0,按照以下顺序检查,避免直接将问题归因于钱包故障。
- 检查是否使用同一条链。 在查询交易的节点上执行
bitcoin-cli -regtest getblockchaininfo,确认chain为regtest。若是多节点实验,分别执行getblockcount与getbestblockhash;链高相同不代表链尖哈希一定相同。 - 检查新区块是否包含目标交易。 使用
bitcoin-cli -regtest getblock <BLOCKHASH> 1,在返回的tx数组中查找目标交易 ID。若没有找到,说明该区块并未打包这笔交易;需要检查挖矿节点是否已收到交易,以及交易是否被内存池接纳。 - 检查钱包查询范围。
gettransaction必须通过认识该交易的钱包调用。本例使用-rpcwallet=receiver。若查询无关钱包,即使交易已经入块,也可能得到钱包找不到交易的错误。 - 检查原始交易查询条件。 未开启
txindex时,对已经确认的交易直接执行不带区块哈希的getrawtransaction,可能无法找到交易。使用gettransaction提供的blockhash,作为getrawtransaction的第三个参数。 - 检查区块是否位于活跃链。 如果
in_active_chain为false,目标区块不在当前活跃链上。此时不能把历史区块内存在该交易等同于交易在当前活跃链中得到确认,应检查链重组以及交易是否进入新的活跃链。
在多节点实验中,generatetoaddress 只会让执行该命令的节点立即生成区块,并不保证其他节点已经收到并验证新区块。如果两个节点尚未连接或传播存在延迟,矿工节点显示 1 次确认、另一节点仍显示 0 次确认是可能的。应先使用 getpeerinfo 检查连接,再比较双方的 getbestblockhash,最后核对交易状态。
验收时需要同时满足三个条件:接收钱包的确认数从 0 变为 1、再变为 2;getrawtransaction 返回的目标区块处于活跃链;钱包报告的交易区块哈希与实际包含该交易的区块一致。只有确认数、区块归属和链尖状态相互吻合,才能认定这笔交易已在当前节点的活跃链上得到相应次数的确认。