区块链原理 / 系统课时

在 regtest 双节点追踪交易广播

在 regtest 双节点追踪交易广播

本实操在一台电脑上运行两个数据目录完全独立的 Bitcoin Core regtest 节点。节点 A 挖矿并向节点 B 的地址发送 1 BTC;通过 P2P 连接信息、区块高度和各自的 mempool,确认交易确实经过网络转发,并观察入块后的变化。

学习目标

  • 用不同数据目录、P2P 端口和 RPC 端口运行两个节点。
  • 追踪同一笔未确认交易在两个节点本地 mempool 中的出现。
  • 区分连接故障、区块未同步和交易尚未传播,并验证交易确认。

启动两套隔离节点

以下命令适用于 Linux/macOS 的 Bash,以及带钱包功能的 Bitcoin Core 30.x。先确保 bitcoind、bitcoin-cli 和 python3 在 PATH 中,实验端口 19443、19444、19445、19446 未被占用。全部命令在同一个 Bash 终端依次执行,以保留后续使用的变量。

bash
set -euo pipefail
command -v bitcoind >/dev/null
command -v bitcoin-cli >/dev/null
command -v python3 >/dev/null

BASE="$(mktemp -d)"
NODE_A="$BASE/node-a"
NODE_B="$BASE/node-b"
mkdir -p "$NODE_A" "$NODE_B"

# 分别指定数据目录与 RPC 端口,避免命令误发给另一个节点。
CLI_A=(bitcoin-cli -regtest -datadir="$NODE_A" -rpcport=19443)
CLI_B=(bitcoin-cli -regtest -datadir="$NODE_B" -rpcport=19446)

bitcoind -regtest -datadir="$NODE_A" -bind=127.0.0.1:19444 \
  -port=19444 -rpcport=19443 -fallbackfee=0.0002 \
  -discover=0 -daemonwait >/dev/null
bitcoind -regtest -datadir="$NODE_B" -bind=127.0.0.1:19445 \
  -port=19445 -rpcport=19446 -fallbackfee=0.0002 \
  -discover=0 -daemonwait >/dev/null

printf 'A=%s, B=%s\n' \
  "$("${CLI_A[@]}" getblockcount)" "$("${CLI_B[@]}" getblockcount)"

预期输出:

text
A=0, B=0

两个目录各自保存链数据、钱包、日志和 RPC cookie。-bind 将 P2P 监听限制在本机回环地址;-rpcport 是调用管理接口的端口,不能拿来做 addnode 连接。-fallbackfee=0.0002 单位是 BTC/kvB,用于 regtest 尚无可靠费率估计时的钱包发送;它不是强制所有交易采用这一费率。

连接对等节点并读取 peer 信息

让 A 主动拨号 B 的 P2P 端口,再读取双方的 getpeerinfo。addnode ... add 把目标加入 A 的手工连接列表,不会把两套数据目录合并。

bash
"${CLI_A[@]}" addnode 127.0.0.1:19445 add

# 建连是异步过程,最多等待约 30 秒。
for attempt in {1..30}; do
  if [ "$("${CLI_A[@]}" getconnectioncount)" -ge 1 ]; then break; fi
  sleep 1
done

printf 'A peers: '
"${CLI_A[@]}" getpeerinfo | python3 -c \
  'import json,sys; print([(p["inbound"],p["connection_type"]) for p in json.load(sys.stdin)])'
printf 'B peers: '
"${CLI_B[@]}" getpeerinfo | python3 -c \
  'import json,sys; print([(p["inbound"],p["connection_type"]) for p in json.load(sys.stdin)])'

预期输出(当前仅连接这两个节点时):

text
A peers: [(False, 'manual')]
B peers: [(True, 'inbound')]

A 的 inbound=false 表示它主动发起连接;B 的 inbound=true 表示接受传入连接。进一步看原始 getpeerinfo 的 addr:A 应指向 127.0.0.1:19445,而 B 看到的是 A 的临时源端口,不一定是 19444。

两个 regtest 节点的 P2P 连接与本地内存池关系

生成成熟余额并发送交易

分别创建钱包。A 挖出 101 个区块,使最早的 coinbase 奖励达到 100 次后续区块确认、可以被花费;B 在收到这些区块后才能可靠验证花费该奖励的交易。B 的接收地址在发送前创建,便于钱包跟踪收款。

bash
"${CLI_A[@]}" createwallet sender >/dev/null
"${CLI_B[@]}" createwallet receiver >/dev/null

MINER_ADDR=$("${CLI_A[@]}" -rpcwallet=sender getnewaddress)
RECEIVER_ADDR=$("${CLI_B[@]}" -rpcwallet=receiver getnewaddress)
"${CLI_A[@]}" generatetoaddress 101 "$MINER_ADDR" >/dev/null

# 等待 B 同步到相同高度,避免把链落后误判为交易拒收。
for attempt in {1..30}; do
  if [ "$("${CLI_B[@]}" getblockcount)" -eq 101 ]; then break; fi
  sleep 1
done
printf 'A height=%s, B height=%s, A balance=%s BTC\n' \
  "$("${CLI_A[@]}" getblockcount)" \
  "$("${CLI_B[@]}" getblockcount)" \
  "$("${CLI_A[@]}" -rpcwallet=sender getbalance)"

TXID=$("${CLI_A[@]}" -rpcwallet=sender sendtoaddress "$RECEIVER_ADDR" 1)
printf 'txid=%s\n' "$TXID"

预期输出:

text
A height=101, B height=101, A balance=50.00000000 BTC
txid=<ID>

<ID> 表示本次生成的 64 位十六进制交易 ID,每次实验不同。sendtoaddress 会选择钱包 UTXO、计算手续费、签名并提交本地节点广播;B 的地址并不需要与 A 共用钱包。

比较本地 mempool 并排查传播差异

交易刚发送后,先比较 A 和 B 的未确认交易集合,而非只检查 A 钱包的发送记录。getrawmempool 默认返回本节点接纳的 txid 列表;两节点没有共享 mempool,B 必须通过 P2P 单独接收并校验交易。

bash
# 传播存在短暂延迟,最多轮询 30 次。
for attempt in {1..30}; do
  if "${CLI_B[@]}" getrawmempool | grep -Fq "$TXID"; then break; fi
  sleep 1
done

printf 'A mempool: '
"${CLI_A[@]}" getrawmempool | python3 -c 'import json,sys; print(json.load(sys.stdin))'
printf 'B mempool: '
"${CLI_B[@]}" getrawmempool | python3 -c 'import json,sys; print(json.load(sys.stdin))'

预期输出(尚未挖出新区块时):

text
A mempool: ['<ID>']
B mempool: ['<ID>']

如果 A 有 txid 而 B 没有,按以下顺序判断,不要立即把 B 的 mempool 为空认作交易无效:

观察到的现象 检查位置 下一步
A 或 B 没有 peer getpeerinfo、监听 P2P 端口 检查是否误连 RPC 19446 或节点未启动
B 的区块高度低于 A 两端 getblockcount 先等待同步,再重新查询 mempool
高度相同、peer 存在但 B 仍无交易 B 的 getmempoolinfo、debug.log 查看本地最低接纳费率、脚本或策略拒收信息
两端 mempool 都为空 getblockcount、接收钱包 gettransaction 排除交易已经被区块确认的情况

节点日志位于各自数据目录下的 regtest/debug.log。getpeerinfo 证明连接存在,不能单独证明某笔交易已经被另一端接纳。

挖块确认交易并安全停机

最后由 A 再挖一个区块,检查 B 是否同步到高度 102、接收钱包是否看到 1 次确认。入块后,正常情况下该交易不再位于两端 mempool。

bash
"${CLI_A[@]}" generatetoaddress 1 "$MINER_ADDR" >/dev/null
for attempt in {1..30}; do
  if [ "$("${CLI_B[@]}" getblockcount)" -eq 102 ]; then break; fi
  sleep 1
done

printf 'A mempool count=%s\n' \
  "$("${CLI_A[@]}" getmempoolinfo | python3 -c 'import json,sys; print(json.load(sys.stdin)["size"])')"
printf 'B mempool count=%s\n' \
  "$("${CLI_B[@]}" getmempoolinfo | python3 -c 'import json,sys; print(json.load(sys.stdin)["size"])')"
"${CLI_B[@]}" -rpcwallet=receiver gettransaction "$TXID" |
  python3 -c 'import json,sys; print("B confirmations=%s" % json.load(sys.stdin)["confirmations"])'

"${CLI_A[@]}" stop >/dev/null
"${CLI_B[@]}" stop >/dev/null

预期输出:

text
A mempool count=0
B mempool count=0
B confirmations=1

停机后保留 $BASE 对应的临时目录,可继续查看两份日志;确认进程退出且不再需要实验数据时再删除。若两节点同高但 mempool 不同,应优先看 B 的本地接纳条件和传播日志,而不是假定全网存在一个统一的交易池。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 regtest 双节点追踪交易广播

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通