区块链原理 / 系统课时

为原始交易补齐找零与费用

为原始交易补齐找零与费用

创建原始 Bitcoin 交易时,指定收款金额并不等于完成资金分配,还需要选择足够的 UTXO、估算矿工手续费,并决定剩余金额如何找零。本课使用 Bitcoin Core 的 fundrawtransaction,在 regtest 网络中对比自动选币和手工指定输入,最终验证输入、收款输出、找零脚本与手续费之间的金额关系。

学习目标

  • 使用 fundrawtransaction 自动选择 UTXO、添加找零输出并计算手续费。
  • 对比自动选币与手工指定输入时,add_inputs 和找零参数的实际行为。
  • 通过 decoderawtransaction 检查输入、输出脚本和金额守恒,并识别手续费及找零边界。

找零与手续费怎样决定输出金额

Bitcoin 使用 UTXO 模型。一笔普通交易引用一个或多个尚未花费的交易输出作为输入,并创建新的输出。输入 UTXO 会被整体消费,不能只从原 UTXO 中扣除部分金额并保留原来的余额。

假设钱包有一个 50 BTC 的 UTXO,需要支付 0.1 BTC。如果交易预计占用 141 vB,目标费率为 2 sat/vB,则手续费为 282 sat,也就是 0.00000282 BTC。

金额项目 数值 处理方式
输入 UTXO 50.00000000 BTC 整体消费
收款输出 0.10000000 BTC 支付给收款地址
矿工手续费 0.00000282 BTC 不创建独立输出
找零输出 49.89999718 BTC 返回钱包控制的地址

手续费满足以下关系:

F=∑Vin−∑VoutF=\sum V_{in}-\sum V_{out}

其中 VinV_{in} 是输入 UTXO 的金额,VoutV_{out} 是实际创建的全部输出金额。手续费没有专属 vout,节点通过输入与输出的金额差额计算它。

UTXO 输入经过交易资金分配形成收款、找零与隐含手续费

使用 fundrawtransaction 对比两种选币方式

以下实验适用于 Bitcoin Core 31.0,使用 Bash、bitcoin-cli 和 jq。开始前应已启动启用钱包功能的 regtest 节点,并确认本机安装 jq。实验使用全新的 regtest 环境,钱包名称此前未被创建。

fundrawtransaction 的关键选项如下:

选项 本例取值 行为
fee_rate 2 按 2 sat/vB 计算目标费率
change_type bech32 使用原生 SegWit 找零地址类型
changePosition 1 将新增的找零输出放在索引 1
add_inputs 自动方案使用默认值 true 允许钱包补充输入
add_inputs 手工方案设为 false 禁止追加其他 UTXO

先创建发送钱包和接收钱包,挖出 102 个区块,使发送钱包获得足够成熟的 coinbase UTXO。随后创建同一收款金额的两笔未签名交易:第一笔不指定输入,第二笔从 listunspent 中明确指定一个输入。

以下为完整 Bash 实验,所有变量在同一次执行中定义。

bash
set -euo pipefail

# 准备两个钱包及已经成熟的挖矿奖励 UTXO
bitcoin-cli -regtest createwallet 'fund-lab' >/dev/null
bitcoin-cli -regtest createwallet 'receive-lab' >/dev/null
MINER=$(bitcoin-cli -regtest -rpcwallet=fund-lab getnewaddress '' bech32)
DEST=$(bitcoin-cli -regtest -rpcwallet=receive-lab getnewaddress '' bech32)
bitcoin-cli -regtest generatetoaddress 102 "$MINER" >/dev/null

OUTPUTS=$(jq -cn --arg addr "$DEST" '{($addr):0.1}')

# 自动方案:不指定输入,钱包自行选币并补齐找零
RAW=$(bitcoin-cli -regtest createrawtransaction '[]' "$OUTPUTS")
AUTO=$(bitcoin-cli -regtest -rpcwallet=fund-lab fundrawtransaction "$RAW" '{"fee_rate":2,"change_type":"bech32","changePosition":1}')
AUTO_TX=$(bitcoin-cli -regtest decoderawtransaction "$(jq -r '.hex' <<< "$AUTO")")
jq -e '.changepos == 1 and .fee > 0' <<< "$AUTO" >/dev/null
jq -e --arg addr "$DEST" '(.vin | length) >= 1 and (.vout | length) == 2 and .vout[0].scriptPubKey.address == $addr and .vout[1].scriptPubKey.type == "witness_v0_keyhash"' <<< "$AUTO_TX" >/dev/null
printf '自动选币通过:收款 vout[0],找零 vout[1]\n'

# 手工方案:选定一个已成熟的 UTXO,禁止追加其他输入
COIN=$(bitcoin-cli -regtest -rpcwallet=fund-lab listunspent 100 | jq '.[0]')
TXID=$(jq -r '.txid' <<< "$COIN")
VOUT=$(jq -r '.vout' <<< "$COIN")
INPUTS=$(jq -cn --arg txid "$TXID" --argjson vout "$VOUT" '[{txid:$txid,vout:$vout}]')
MANUAL_RAW=$(bitcoin-cli -regtest createrawtransaction "$INPUTS" "$OUTPUTS")
MANUAL=$(bitcoin-cli -regtest -rpcwallet=fund-lab fundrawtransaction "$MANUAL_RAW" '{"add_inputs":false,"fee_rate":2,"change_type":"bech32","changePosition":1}')
MANUAL_TX=$(bitcoin-cli -regtest decoderawtransaction "$(jq -r '.hex' <<< "$MANUAL")")
jq -e '.changepos == 1 and .fee > 0' <<< "$MANUAL" >/dev/null
jq -e --arg txid "$TXID" --argjson vout "$VOUT" '(.vin | length) == 1 and .vin[0].txid == $txid and .vin[0].vout == $vout' <<< "$MANUAL_TX" >/dev/null
printf '手工选币通过:仅使用指定 UTXO,找零 vout[1]\n'

预期输出:

text
自动选币通过:收款 vout[0],找零 vout[1]
手工选币通过:仅使用指定 UTXO,找零 vout[1]

实验使用的地址和交易 ID 每次可能不同。由于金额远小于成熟 coinbase UTXO 的价值,两种方案都能覆盖收款金额及预计费用,不需要广播交易。

检查自动找零与手工输入的差异

fundrawtransaction 返回三个关键字段:hex 是补齐资金后的未签名原始交易,fee 是预计手续费(BTC),changepos 是新增找零输出的位置。如果没有创建找零输出,changepos 为 -1。

实验中的 AUTO_TX 与 MANUAL_TX 都是调用 decoderawtransaction 后得到的解码结果,可以直接观察其 vin 和 vout。

自动方案的原始交易输入数组为空,钱包通过选币算法从可用 UTXO 中选择足够的资金,实际选中哪个输入并没有事先指定。手工方案则使用明确的 txid 和 vout 引用 UTXO,并将 add_inputs 设置为 false。

两种方案的区别如下:

检查点 自动选币 手工指定输入
原始交易输入 [] 明确的 txid、vout
输入选择权 钱包选币算法 构造交易的调用方
资金不足时 可继续选择其他 UTXO 报错,不自动追加
手续费计算 钱包估算 钱包估算
找零输出 可自动添加 可自动添加
是否已经签名 否 否

changePosition 固定为 1,使本例的收款输出保持在 vout[0],找零输出位于 vout[1]。该索引从 0 开始计数,仅适用于确实创建了找零输出的情况。未显式设置时,钱包可以自行决定找零位置,不能假设最后一个输出始终是找零。

特别注意,decoderawtransaction 只能展示 scriptPubKey、地址和金额等交易结构。识别哪个输出属于钱包找零,应结合 fundrawtransaction 返回的 changepos,而不是仅凭输出地址格式判断。

本例指定 change_type 为 bech32,因此找零输出使用 P2WPKH 类型,解码后 scriptPubKey.type 应为 witness_v0_keyhash。这与收款地址是否同样采用 Bech32 无关:收款输出和找零输出都可以具有相同的脚本类型,但分别由不同的钱包控制。

核对费用并处理找零边界

完成资金补齐后,需要核对以下关系:

  1. 通过 vin 的 txid 和 vout 找到原 UTXO 金额,计算所有输入金额之和。
  2. 将解码结果 vout 中所有 value 相加,得到实际输出总额。
  3. 从输入总额中减去输出总额,结果应与 fundrawtransaction 返回的 fee 一致,金额比较应换算成整数 sat,避免浮点精度误差。
  4. 检查 changepos 指向的输出金额和 scriptPubKey,确认找零属于预期的钱包控制范围。

例如输入金额为 50.00000000 BTC、收款为 0.10000000 BTC,若实际手续费为 0.00000282 BTC,那么找零必须等于 49.89999718 BTC。若差额不符,应首先检查是否遗漏了一个输入或输出。

以下边界在真实交易构造中尤其容易出错:

  • 手续费单位混淆:fee_rate 使用 sat/vB,而旧式参数 feeRate 使用 BTC/kvB,两者不能按相同数字解释。Bitcoin Core 31.0 应优先使用 fee_rate。
  • 找零太小:当可用剩余金额不足以形成符合钱包策略的经济找零输出时,钱包可能不创建找零,剩余金额并入手续费。因此不能无条件要求 changepos 必须为 1。
  • 输入不足:手工指定的 UTXO 金额小于收款额加手续费时,add_inputs:false 会让资金补齐失败。需要增加明确的输入,或者允许钱包补充输入。
  • 接收者承担手续费:默认手续费从发送方的输入与找零中承担。设置 subtractFeeFromOutputs:[0] 则会从原始第 0 个收款输出扣除相应费用,收款人的实际金额会小于构造交易时填写的金额。
  • 重复使用 UTXO:默认 lockUnspents:false,资金补齐本身不会永久占用输入。并行构造交易时可以考虑 lockUnspents:true 临时锁定选中的 UTXO,但应用仍需管理解锁和交易状态。

另外,实际手续费可能受未确认父交易及交易包费率要求影响。Bitcoin Core 31.0 在设置明确费率时,也可能为了使交易包满足目标费率而提高当前交易支付的手续费,因此验证时应以 RPC 返回值和实际输入输出金额为准。

本课对应的参数名称及返回结构可参考 Bitcoin Core 31.0 的 fundrawtransaction RPC 文档。只要能核对输入金额、收款输出、找零输出和隐含手续费,并明确输入选择由谁控制,就可以判断一笔原始交易是否已经完成合理的资金补齐。

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

目录与阅读设置

阅读设置

17

记录一个想法

为原始交易补齐找零与费用

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

登录哪都通