区块链原理 / 系统课时

地址编码怎样对应到输出脚本

地址编码怎样对应到输出脚本

拿到一个 Bitcoin 收款地址后,不能直接把地址字符串写进交易输出。节点需要先校验并解码地址,再根据地址类型生成 scriptPubKey。本课比较 Base58Check、Bech32 和 Bech32m 三种编码,拆解它们与锁定脚本的映射关系,并通过 Bitcoin Core 验证真实脚本字节。

学习目标

  • 区分 Base58Check、Bech32 和 Bech32m 的编码字段、校验规则及适用输出类型。
  • 根据地址解码后的版本和负载,识别 P2PKH、P2SH、P2WPKH、P2WSH 与 P2TR 输出脚本。
  • 使用 Bitcoin Core 的 validateaddress RPC 验证地址与 scriptPubKey 的对应关系。

地址与输出脚本是什么关系

Bitcoin 交易输出包含金额和 scriptPubKey。金额通常以 satoshi 为单位进行序列化,scriptPubKey 则是一段规定未来如何花费该输出的锁定脚本。

地址是对特定锁定条件的编码表示,便于钱包收款、复制和校验。交易真正写入区块链的是脚本字节,而不是 1...、3... 或 bc1... 形式的地址文本。

例如,原生隔离见证 P2WPKH 地址解码后包含一个 20 字节的公钥哈希。对应的输出脚本使用 OP_0 加上这个 20 字节见证程序,总长度为 22 字节。

这里需要分清三个层次:

  1. 地址文本:提供网络信息、类型或见证版本、负载及校验信息。
  2. 地址解码结果:得到公钥哈希、脚本哈希,或见证版本与见证程序。
  3. 输出脚本:根据解码结果拼装对应的操作码和数据推入指令,形成 scriptPubKey。

地址本身不包含私钥。即使地址校验成功,也只能说明它在指定网络下具有合法的编码及对应脚本,不能证明任何人有权花费该输出。

三种编码分别保存什么

三种地址编码采用不同的校验规则,但最终都要映射成具体的输出脚本。以下以 Bitcoin 主网为例。

编码 常见地址前缀 核心负载 校验规则 典型输出
Base58Check 1、3 版本字节与 20 字节哈希 双重 SHA-256 的前 4 字节 P2PKH、P2SH
Bech32 bc1q 见证版本 0 与 20 或 32 字节程序 6 个校验字符,常量为 1 P2WPKH、P2WSH
Bech32m bc1p(版本 1) 见证版本 1 与见证程序 6 个校验字符,常量为 0x2bc830a3 32 字节程序对应 P2TR

Base58Check 的版本字节

Base58Check 先把版本字节与负载组合,再计算双重 SHA-256,将结果的前 4 字节作为校验和,最后编码为 Base58 字符串。

主网常见版本如下:

  • 0x00:P2PKH,后接 20 字节公钥哈希,地址通常以 1 开头。
  • 0x05:P2SH,后接 20 字节脚本哈希,地址通常以 3 开头。

P2SH 地址只承诺一个赎回脚本的哈希。它可能包装多签脚本,也可能包装隔离见证程序。仅凭 3 开头的地址,不能确定内部具体采用哪一种花费规则。

Bech32 与 Bech32m 的见证版本

两者都采用人类可读部分(HRP)、分隔符 1、见证版本、见证程序编码及校验字符的结构。

主网 HRP 是 bc,测试网和 Signet 通常使用 tb,Regtest 使用 bcrt。其中 bc1q 通常表示版本 0,bc1p 表示版本 1。

按照 BIP 173 和 BIP 350:

  • 见证版本 0 必须使用 Bech32,程序长度只能是 20 或 32 字节。
  • 见证版本 1~16 必须使用 Bech32m,程序允许 2~40 字节。
  • 当前 Taproot 的 P2TR 输出使用版本 1 和恰好 32 字节的见证程序。

Bech32 与 Bech32m 的校验结果不能互换。地址允许全部小写或全部大写,但混合大小写必须拒绝。见证程序还需要经过 5 位数据组到 8 位字节的转换,并检查末尾填充位是否合法。

从解码负载构造 scriptPubKey

校验地址后,节点不需要把地址字符串保留在输出中,而是选择脚本模板,并填入解码得到的哈希或见证程序。

输出类型 解码条件 scriptPubKey 十六进制结构 长度
P2PKH Base58Check 版本 0x00 76 a9 14 [20字节哈希] 88 ac 25 字节
P2SH Base58Check 版本 0x05 a9 14 [20字节哈希] 87 23 字节
P2WPKH 见证版本 0,20 字节 00 14 [20字节程序] 22 字节
P2WSH 见证版本 0,32 字节 00 20 [32字节程序] 34 字节
P2TR 见证版本 1,32 字节 51 20 [32字节程序] 34 字节

表中的空格仅用于展示字节边界,方括号表示实际填入的二进制数据,不是脚本中的字符。

P2PKH 的 76、a9、88、ac 分别表示 OP_DUP、OP_HASH160、OP_EQUALVERIFY、OP_CHECKSIG。P2SH 的 87 对应 OP_EQUAL。

原生见证输出中,00 表示 OP_0,51 表示 OP_1;后面的 14、20 分别表示推入 20、32 字节数据。P2TR 中的 32 字节程序是 Taproot 输出公钥的 x-only 表示,而不是可以直接任意替换的内部公钥。

三种 Bitcoin 地址编码到输出锁定脚本的映射关系

一个常见错误是把地址的校验和拼接进 scriptPubKey。实际上,Base58Check 的 4 字节校验和以及 Bech32 系列的 6 个校验字符都只用于检测地址输入错误,不是交易输出脚本的一部分。

使用 Bitcoin Core 验证真实脚本

Bitcoin Core 的 validateaddress RPC 会校验指定网络的地址,并在合法时返回 scriptPubKey。不需要导入私钥或加载钱包,也不需要为示例地址创建实际交易。

以下示例适用于 Bitcoin Core 31.0 与 Python 3。运行前确保主网节点的 RPC 服务可访问,且 bitcoin-cli 已加入系统 PATH。将代码保存为 check_address.py 后执行 python check_address.py。

python
import json
import subprocess

samples = [
    ("P2PKH/Base58Check", "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"),
    ("P2WPKH/Bech32", "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4"),
    ("P2TR/Bech32m", "bc1p0xlxvlhemja6c4dqv22uapctqupfhlxm9h8z3k2e72q4k9hcz7vqzk5jj0"),
]

for kind, address in samples:
    # 明确使用主网,避免把网络前缀不匹配误判为地址损坏。
    process = subprocess.run(
        ["bitcoin-cli", "-chain=main", "validateaddress", address],
        check=True,
        capture_output=True,
        text=True,
    )
    result = json.loads(process.stdout)

    # 只有通过完整地址校验后才读取锁定脚本。
    if not result["isvalid"]:
        raise ValueError(f"Invalid address: {address}")
    print(f"{kind}: {result['scriptPubKey']}")

预期输出:

text
P2PKH/Base58Check: 76a91462e907b15cbf27d5425399ebf6f0fb50ebb88f188ac
P2WPKH/Bech32: 0014751e76e8199196d454941c45d1b3a323f1433bd6
P2TR/Bech32m: 512079be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798

这三个结果可以按字节直接检查:P2PKH 以 76a914 开头、88ac 结尾;P2WPKH 以 0014 开头;P2TR 以 5120 开头。三者脚本总长依次为 25、22、34 字节。

其中 P2WPKH 和 P2TR 地址来自 BIP 的有效测试向量。第一个地址是著名的主网历史地址,仅用于格式验证。不要向教材示例地址转账。

如果 RPC 连接失败,应先检查 Bitcoin Core 是否运行、是否启用 RPC,以及 -chain=main 是否与正在运行的节点网络一致。RPC 的字段定义可对照 Bitcoin Core 31.0 validateaddress 文档。

哪些地址看起来正确却必须拒绝

接收外部地址时,建议按网络、编码校验、见证版本、程序长度的顺序验证,而不是只看字符串前缀。

  • 网络不匹配:主网钱包收到 tb1... 或 bcrt1... 地址时必须拒绝,不能通过替换前缀来转换网络,因为校验和也覆盖网络信息。
  • 校验算法不匹配:见证版本 0 若错误使用 Bech32m,或版本 1 若错误使用 Bech32,即使字符集和长度看起来合理,也属于无效地址。
  • 程序长度不合法:版本 0 必须是 20 或 32 字节;不能因为前缀是 bc1q 就跳过长度检查。版本 1 只有 32 字节程序对应当前定义的 P2TR 输出。
  • 误判花费权限:validateaddress 返回 isvalid: true,不代表地址有余额、钱包拥有私钥,或未来提供的签名一定能通过脚本验证。

可以用一个小测试验证校验机制:将示例中的合法 Bech32 地址任意修改一个数据字符,再传给 validateaddress。一般会得到 isvalid: false,不能继续读取有效的 scriptPubKey。这也说明地址编码负责可靠地传递锁定条件,而实际花费授权仍由对应的脚本和签名验证规则决定。

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

目录与阅读设置

阅读设置

17

记录一个想法

地址编码怎样对应到输出脚本

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

登录哪都通