区块链原理 / 系统课时
先预检再广播原始交易
先预检再广播原始交易
一笔交易完成签名后,不应立即提交到 Bitcoin 网络。先调用 testmempoolaccept 检查节点是否愿意接收,再根据结果决定是否调用 sendrawtransaction,能够在广播前发现手续费、输入引用和脚本验证问题,并留下可追踪的交易标识。
学习目标
- 使用
testmempoolaccept预检已签名交易,读取接收结果和拒收原因。 - 在预检通过后调用
sendrawtransaction,保存返回的txid。 - 区分预检通过、本地交易池接收、网络传播和区块确认,并按拒收原因排查问题。
预检之前准备好签名交易
本节以 Bitcoin Core 31.0、Python 3 和 regtest 网络为实验环境。假设已经构造并签署一笔花费 regtest UTXO 的交易,准备将最终序列化结果提交给节点。
开始前检查以下条件:
bitcoind已在 regtest 模式运行,bitcoin-cli可执行且 RPC 认证正常。- 交易已经完成签名。如果使用
signrawtransactionwithwallet,应确认返回的complete为true;如果使用 PSBT,则应取得finalizepsbt提取的最终交易十六进制字符串。 - 将最终签名交易的完整十六进制字符串保存到当前工作目录的
signed-tx.hex文件中。文件仅包含交易数据,不要包含 JSON 外壳、引号或日志。 - 交易引用的 UTXO 属于当前 regtest 链,并且尚未被其他交易消费。
- 实验期间不主动生成新区块,也不启用
-privatebroadcast,以便观察交易进入本地交易池。
这里使用两个不同的 RPC 方法,它们虽然接受同一份交易数据,但行为不同。
| RPC 方法 | 输入 | 对节点状态的影响 |
|---|---|---|
testmempoolaccept |
已签名交易十六进制字符串组成的 JSON 数组 | 模拟交易池接收检查,不将交易加入交易池 |
sendrawtransaction |
单笔已签名交易的十六进制字符串 | 正式提交交易;普通广播模式下尝试加入本地交易池并向已连接的相关对等节点传播 |
注意第一个方法的参数是数组,即使只检查一笔交易,也不能直接将裸十六进制字符串作为第一个参数。第二个方法则接收裸十六进制字符串。
读取预检结果并判断去向
testmempoolaccept 返回一个与输入交易顺序对应的结果数组。每个结果包含 txid、wtxid 等标识,最重要的是 allowed 字段。
| 返回字段 | 含义 | 处理方法 |
|---|---|---|
allowed: true |
当前检查条件下可被交易池接受 | 检查手续费等信息后允许进入广播步骤 |
allowed: false |
当前检查未通过 | 读取 reject-reason,不要直接广播 |
reject-reason |
拒收原因,拒收时通常提供 | 根据原始字符串定位问题 |
reject-details |
更详细的拒收信息,可选 | 辅助识别脚本或策略验证失败 |
vsize |
交易虚拟大小,单位 vB | 与手续费计算实际费率 |
fees.base |
基础交易手续费,单位 BTC | 检查费用是否符合预期 |
以虚拟大小为 141 vB、基础手续费为 0.00000141 BTC 的交易为例,手续费为 141 sat,费率为 1 sat/vB。这个数值只是计算示例,不代表所有网络环境都能接受该费率。
还要区分两种费率限制:节点的最低接收费率由交易池策略决定;RPC 的 maxfeerate 则是调用者设置的最高允许费率,用于阻止意外支付过高费用。Bitcoin Core 31.0 的这两个 RPC 默认 maxfeerate 为 0.10 BTC/kvB。
本节实验将显式设置 maxfeerate 为 0.00010000 BTC/kvB,相当于 10 sat/vB。预检和广播使用相同上限,避免两次调用的费用保护条件不一致。实际业务必须根据交易金额、目标确认速度和费用预算选择限制。

预检只检查调用时节点看到的交易池和链状态。如果另一个交易随后消费了同一 UTXO,或者交易池策略、费用环境发生变化,之前通过的交易仍然可能在正式广播时失败。
串起预检与广播
下面使用 Python 调用真实的 bitcoin-cli,完成读取交易、预检、拒收保护、广播、记录标识和本地交易池验证。代码采用标准库,不需要额外安装 Python RPC 客户端。
将以下程序保存为 broadcast_checked.py,并与 signed-tx.hex 放在同一个工作目录。确保当前目录可写、Python 3 可用,且 Bitcoin Core 31.0 的 bitcoin-cli 已加入系统 PATH。
from pathlib import Path
import json
import subprocess
import sys
CLI = ["bitcoin-cli", "-regtest"]
FEE_CAP = "0.00010000" # 最高 10 sat/vB,供本次实验使用
def rpc(method, *params):
# 捕获真实 RPC 输出,不从控制台日志猜测交易状态
return subprocess.check_output(
CLI + [method, *params], text=True
).strip()
def main():
raw_hex = Path("signed-tx.hex").read_text(encoding="ascii").strip()
# 预检的第一个 RPC 参数必须是 JSON 数组
result = json.loads(
rpc("testmempoolaccept", json.dumps([raw_hex]), FEE_CAP)
)[0]
if result.get("allowed") is not True:
print("预检拒绝:", result.get("reject-reason", "未完成验证"))
if result.get("reject-details"):
print("详情:", result["reject-details"])
sys.exit(1)
print("预检通过:", result["vsize"], "vB")
# 正式提交后将 txid 单独持久化,方便后续查询
txid = rpc("sendrawtransaction", raw_hex, FEE_CAP)
Path("broadcast-txid.txt").write_text(txid, encoding="ascii")
print("已提交 txid:", txid)
entry = json.loads(rpc("getmempoolentry", txid))
print("本地交易池 vsize:", entry["vsize"], "vB")
if __name__ == "__main__":
main()在程序所在目录执行:
python3 broadcast_checked.py预期输出(假设输入交易有效、满足 10 sat/vB 上限且成功进入本地交易池):
预检通过: <VSIZE> vB
已提交 txid: <ID>
本地交易池 vsize: <VSIZE> vB<VSIZE> 是实际交易虚拟大小,<ID> 是实际返回的 64 位十六进制字符组成的交易标识;不同交易的值不同。程序还会生成 broadcast-txid.txt,内容为这笔交易的真实 txid。
如果预检未通过,程序将在调用 sendrawtransaction 之前退出,不会生成新的广播标识文件。注意旧的 broadcast-txid.txt 不会自动删除,因此不能把文件存在当作本次广播成功的证据;应结合本次程序输出和文件更新时间判断。
sendrawtransaction 本身也可能抛出 RPC 错误。示例通过 Python 的 subprocess 传播失败并停止执行,不会把失败误报为成功。如果要在生产程序中使用,还应捕获调用异常、记录节点返回的错误文本,并为提交过程设计幂等处理。
根据拒收原因修正交易
预检失败时,应先保存 reject-reason 和 reject-details 的原始内容,再定位具体条件。不同 Bitcoin Core 版本和交易池状态下,返回的文字可能不同,不能只依赖某一个固定错误字符串。
| 问题类别 | 典型表现 | 修正方式 |
|---|---|---|
| 手续费超过调用者上限 | max-fee-exceeded |
检查输入金额减去输出金额得到的手续费;修正找零或手续费,而不是直接取消上限 |
| 交易输入不可用 | 节点报告缺少输入、输入已花费或存在冲突 | 检查每个前序 txid 和 vout,确认 UTXO 位于正确网络且未被花费 |
| 签名或脚本不满足要求 | 脚本验证相关拒收信息 | 检查签名是否完整、见证数据是否匹配前序输出,修正后重新签名 |
| 费用不符合交易池策略 | 费率不足或相关策略拒收 | 检查实际 sat/vB 与节点的接收策略,必要时重新构造费用合适的交易 |
| 交易已经存在 | 已在交易池或已被区块链收录的相关提示 | 先查询已有交易状态,不要把重复提交等同于交易损坏 |
对于手续费,最容易出现的错误是遗漏找零。假设一个输入价值 0.01000000 BTC,收款输出为 0.00600000 BTC,本来计划创建 0.00399000 BTC 的找零输出,却在构造交易时漏掉了找零,那么手续费将从预期的 0.00001000 BTC 变成 0.00400000 BTC,即 400000 sat。
若该交易虚拟大小为 200 vB,其实际费率就是 2000 sat/vB,远超示例中 10 sat/vB 的上限。此时正确修复是重新构造找零输出并签名,绝不是将 maxfeerate 设置为 0 来绕过保护。设置为 0 会关闭这一最高费率检查。
用交易标识检查广播结果
sendrawtransaction 成功时返回 txid,而不是区块哈希或确认高度。对于包含见证数据的交易,txid 与 wtxid 可能不同,后者包含见证序列化部分的承诺。本节记录的是广播 RPC 返回的 txid。
要判断当前阶段的状态,可以使用以下验收标准:
- 预检通过:
testmempoolaccept返回allowed: true,说明当前检查条件得到满足,但尚未提交交易。 - 本地接收:
sendrawtransaction返回txid,并且普通广播模式下可通过getmempoolentry查询到交易,说明当前节点的交易池中存在这笔交易。 - 网络传播: 查看节点是否存在支持交易转发的已连接对等节点。在没有 P2P 邻居的单节点 regtest 环境中,即使本地接收成功,也不能证明交易已传播到其他节点。
- 区块确认: 交易被矿工收入区块后,才能依据所在区块和当前链状态计算确认数。交易池中存在交易不等于已经确认。
Bitcoin Core 31.0 还支持可选的 -privatebroadcast 模式。启用后,sendrawtransaction 会通过专用连接发送交易,而不是立即将其加入本地交易池;只有交易从网络返回后才可能在本地交易池中出现。因此,上述立即调用 getmempoolentry 的验证方式仅适用于本节明确采用的普通广播模式。
对于普通广播模式,如果刚才的交易已经被打包进区块,那么后续 getmempoolentry 查不到它也不表示广播失败;应改为查询已确认交易及其所在区块。生产系统应将本地接收、对等节点观察、区块确认分别记录为不同状态。
相关 RPC 的正式参数和返回结构可对照 Bitcoin Core 31.0 testmempoolaccept 文档 与 sendrawtransaction 文档。
最终验收的结果应当是一笔通过预检的交易、一次正式提交产生的 txid,以及能够支持当前状态判断的节点查询记录。不要仅凭 allowed: true 就标记广播成功,也不要仅凭 RPC 返回 txid 就标记交易已经确认。