区块链原理 / 系统课时
为原始交易补齐找零与费用
为原始交易补齐找零与费用
创建原始 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 | 返回钱包控制的地址 |
手续费满足以下关系:
其中 是输入 UTXO 的金额, 是实际创建的全部输出金额。手续费没有专属 vout,节点通过输入与输出的金额差额计算它。

使用 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 实验,所有变量在同一次执行中定义。
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'预期输出:
自动选币通过:收款 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 无关:收款输出和找零输出都可以具有相同的脚本类型,但分别由不同的钱包控制。
核对费用并处理找零边界
完成资金补齐后,需要核对以下关系:
- 通过
vin的txid和vout找到原 UTXO 金额,计算所有输入金额之和。 - 将解码结果
vout中所有value相加,得到实际输出总额。 - 从输入总额中减去输出总额,结果应与
fundrawtransaction返回的fee一致,金额比较应换算成整数 sat,避免浮点精度误差。 - 检查
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 文档。只要能核对输入金额、收款输出、找零输出和隐含手续费,并明确输入选择由谁控制,就可以判断一笔原始交易是否已经完成合理的资金补齐。