区块链原理 / 系统课时

version 握手如何完成

version 握手如何完成

两台 Bitcoin 节点连上网络端口后,还不能立即互传交易和区块。它们必须先交换 version,核对协议版本及服务能力,再用 verack 确认收到对方的声明。本篇用双节点时序和 regtest 实验判断握手何时完成,以及入站、出站连接有什么区别。

学习目标

  • 按时序说明 version、verack 与可选能力协商消息的作用。
  • 解释关键字段及入站、出站方向,不把协议版本与软件版本混淆。
  • 用 Bitcoin Core RPC 验证双方确实收发过握手消息。

从连接到正常消息交换

假设节点 A 主动连接 B:对 A 是出站连接,对 B 是入站连接。建立 TCP 连接后,若使用 BIP324 v2 传输,还会先完成传输层加密握手;无论使用 v1 还是 v2 传输,随后都要完成 Bitcoin P2P 的 version/verack 协商。

  1. A 发送自己的 version;B 接收后检查可接受的协议版本、服务声明等,并发送自己的 version。
  2. 双方收到对方的 version 后,在发送 verack 前可以发送 sendaddrv2(BIP155)和 wtxidrelay(BIP339)等适用的能力协商消息。
  3. A、B 分别发送空载荷的 verack,确认已处理对方的 version。双方各自完成版本交换并收到对端 verack,连接才进入常规消息处理阶段。
  4. 此后才进行通常的 getheaders、headers、inv、getdata 等同步或转发。实际报文可交错到达,并不保证严格按示例的四个主报文先后排序。

两个节点交换 version、可选能力消息和 verack 的握手时序

version 中的字段各自有什么用

version 是开场的能力声明,不是交易,也不代表已经验证对方的区块数据。以 Bitcoin Core 31.0 为例,P2P 协议版本为 70016,软件版本则会显示在 user_agent 中,例如 /Satoshi:31.0.0/;这两者不能直接比较大小。

字段 读取方式与判断
version 4 字节协议版本号;判断能否按兼容的规则继续通信。
services 8 字节位掩码;如 NODE_NETWORK=1 表示提供完整区块数据,NODE_WITNESS=8 表示支持见证数据。
timestamp 节点提供的 Unix 秒级时间,可估计时钟偏差,不是共识时间证明。
nonce 用于识别意外连接到自身,不能当作节点永久身份。
user_agent 软件标识字符串,可以由对方自行填写,不能作为可信身份凭证。
start_height 对方声称的链高度,仅供同步判断,不能据此认定链已验证。
relay 可选的交易公告偏好位,false 不表示断开区块同步。

报文还包含 addr_recv、addr_from 等地址字段。services 告诉对方“我声称能提供什么”,但是否实际发送交易,还受连接类型、转发策略和后续协商影响。见 Bitcoin P2P 协议参考。

入站和出站如何区分

同一条连接,在 A 的 getpeerinfo 中 inbound=false,在 B 中则为 inbound=true。连接方向只表示谁发起连接,不表示只能单向传消息;A 和 B 都必须发送 version 和 verack。

观察 connection_type 时还要区分用途:自动建立的 outbound-full-relay 用于正常传播,block-relay-only 则刻意不进行交易与地址转发;用 addnode 手动发起的连接可能显示为 manual。transport_protocol_type 的 v1 或 v2 指传输格式,与 version=70016 不是一个层级。

在 regtest 上验证双向握手

准备 Bitcoin Core 31.0 的 bitcoind、bitcoin-cli 和 Python 3,在 Linux 或 macOS 终端执行下列完整示例。它使用两个独立的临时数据目录,节点 A 主动拨号 B,并读取 getpeerinfo 中按消息类型统计的收发字节数,而不只看连接总数。

bash
set -euo pipefail
BASE="$(mktemp -d)"
mkdir -p "$BASE/a" "$BASE/b"

# 先启动被连接的 B,再启动主动连接的 A;两者隔离数据和 RPC 端口。
bitcoind -regtest -daemon -datadir="$BASE/b" -port=19445 -rpcport=19446 >/dev/null
bitcoin-cli -regtest -datadir="$BASE/b" -rpcwait getblockcount >/dev/null
bitcoind -regtest -daemon -datadir="$BASE/a" -port=19444 -rpcport=19443 >/dev/null
bitcoin-cli -regtest -datadir="$BASE/a" -rpcwait getblockcount >/dev/null
bitcoin-cli -regtest -datadir="$BASE/a" addnode "127.0.0.1:19445" "onetry" >/dev/null

python3 - "$BASE" <<'PY'
import json
import subprocess
import sys
import time

base = sys.argv[1]

def peers(name):
    raw = subprocess.check_output(
        ["bitcoin-cli", "-regtest", f"-datadir={base}/{name}", "getpeerinfo"],
        text=True,
    )
    return json.loads(raw)

def complete(peer, inbound):
    sent = peer.get("bytessent_per_msg", {})
    recv = peer.get("bytesrecv_per_msg", {})
    # 同时检查版本、方向,以及两个握手消息在收发两侧都有记录。
    return (
        peer.get("inbound") is inbound
        and peer.get("version", 0) >= 70016
        and all(sent.get(k, 0) > 0 and recv.get(k, 0) > 0
                for k in ("version", "verack"))
    )

for _ in range(30):
    if (any(complete(p, False) for p in peers("a"))
            and any(complete(p, True) for p in peers("b"))):
        print("A:出站,version/verack 双向完成")
        print("B:入站,version/verack 双向完成")
        break
    time.sleep(0.2)
else:
    raise SystemExit("握手尚未完成,请检查节点日志")
PY

预期输出:

text
A:出站,version/verack 双向完成
B:入站,version/verack 双向完成

19444、19445 是本实验的 P2P 端口,19443、19446 是 RPC 端口;冲突时请换为空闲的 <PORT>。临时数据目录实际位于 <PATH>,由 mktemp 生成。验证后可对两个节点分别执行 bitcoin-cli -regtest -datadir="$BASE/a" stop 和对应 B 的 stop,待进程退出再删除目录。字段定义见 Bitcoin Core 31.0 getpeerinfo 文档。

握手卡住时检查哪里

先看 B 是否监听实验指定的 P2P 端口,再看 A 的 getpeerinfo 是否出现连接。完全没有连接,通常是端口冲突、节点未启动或地址错误;出现连接但 version/verack 收发不全,才转向版本不兼容、对端主动断开或报文校验问题。

如果 getpeerinfo 已记录双方 version 与 verack,却没有交易公告,先检查 connection_type、relaytxes 和节点的转发策略,而不是重试握手。block-relay-only 本来就不转发交易;刚建立的 regtest 网络没有新交易可公告,也完全正常。

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

目录与阅读设置

阅读设置

17

记录一个想法

version 握手如何完成

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

登录哪都通