listunspent怎样筛安全UTXO? 图 1
listunspent怎样筛安全UTXO? · 图 1

Bitcoin Core listunspent可按确认数、地址和查询选项列出钱包UTXO。本文逐项解释safe、spendable、solvable、watch-only与选币锁定,避免把“可见”误当“可安全花费”。

第一轮筛选先固定网络、钱包、确认数和地址范围;随后分别判断钱包能否签名、是否知道脚本解法以及输出是否被节点标记为安全。 本文直接围绕Bitcoin Core listunspent的规范字段、调用样例和失败分支展开;示例中的地址、区块和数值仅用于说明格式,实际操作必须替换成目标网络的原始数据。

一个可复制的 listunspent 请求

listunspent可按最小和最大确认数、地址与查询选项筛选钱包UTXO,并返回txid、vout、amount和确认数等字段。 这个示例筛选至少 6 次确认、金额不少于 0.001 BTC 的钱包输出,并限制返回数量。响应中的 txid 与 vout 组成 outpoint,amount 使用 BTC 单位;confirmations、scriptPubKey、descriptor 和 label 应随选币记录保存。

第一轮筛选先固定网络、钱包、确认数和地址范围;随后分别判断钱包能否签名、是否知道脚本解法以及输出是否被节点标记为安全。 Bitcoin Core listunspent涉及的对象要分成可验证事实、实现假设和业务选择。三类信息混写后,人们常把“规范允许”误读成“当前操作已经成功”。

spendable、solvable、safe 的差别

把复杂流程压到这一条可验证记录:

bitcoin-cli listunspent 6 9999999 '[]' true '{"minimumAmount":0.001,"maximumCount":20}'

spendable表示钱包具备签名能力,solvable表示知道满足脚本的方法,safe用于排除钱包认为不安全的未确认或替换链条输出。 候选UTXO进入交易构造前还要检查金额、脚本、标签、隐私合并、未确认祖先和并发任务,必要时立即用lockunspent占用。 spendable=true 表示当前钱包有能力签名,solvable=true 只表示知道解锁脚本结构,watch-only 输出可能 solvable 但不可签;safe=false 常见于钱包认为存在替换或未确认风险的输出。生产策略应显式要求所需字段,而不是默认所有返回项都可用。

query_options 怎样缩小候选

选币记录至少保存txid、vout、amount、confirmations、scriptPubKey、三个能力字段、标签与锁定状态,不保存私钥。

Bitcoin Core listunspent操作阶段需要的输入完成标志
准备网络、对象、版本与权限环境坐标已冻结
执行原始参数和明确停止线返回值与错误已保存
验证独立来源或本地复算差异已有字段级解释
收尾最终状态回读与审计记录可由第二操作者重放

保存Bitcoin Core listunspent时不要把大整数、十六进制值或精度字段转成浮点数。展示层可以格式化,审计层必须保留无损字符串和单位。

列出以后为何还要锁币

列出UTXO不会锁定它们;并发构造交易前还需使用lockunspent或钱包选币控制避免重复使用。 常见误判是watch-only输出显示在列表中却无法签名、solvable被当成spendable、safe=false被忽略,或多进程同时花同一vout。

listunspent是快照,不会预留 UTXO。构造多笔交易时,先把选中的 outpoint 交给 lockunspent 或统一 coin control,再在广播前检查是否已被花费。钱包类型和版本会影响字段,自动化要保存 bitcoin-cli help listunspent 的版本口径。

当前仍需确认的实现变量是:字段会受钱包类型、watch-only设置和Bitcoin Core版本影响,操作前应核对目标节点help输出。 因此上线记录必须注明实际客户端、合约代码或中间件版本。

复核 Bitcoin Core listunspent 时保存什么

选币记录至少保存txid、vout、amount、confirmations、scriptPubKey、三个能力字段、标签与锁定状态,不保存私钥。

Bitcoin Core listunspent上线前的验收重点是可重放:换一台机器、一个操作者和一个独立节点,仍能从存档输入得到相同判断。 为Bitcoin Core listunspent保留原始错误数据和修正后的新请求,禁止在日志中覆盖第一次失败证据。

Bitcoin Core listunspent的一级资料与适用边界

  1. Bitcoin Core listunspent:在Bitcoin Core listunspent核验中支持定义、接口、当前规范字段和主流程;本文访问日期为2026年7月24日。
  2. Bitcoin Core 30 RPC index:在Bitcoin Core listunspent核验中支持实现来源、边界条件、版本或交叉验证;本文访问日期为2026年7月24日。

UTXO选择涉及隐私、手续费和本金损失风险,广播前必须在硬件设备核对输出;本文不构成投资建议。 关于Bitcoin Core listunspent的结论只对记录中的网络、版本和状态点有效;一级规范与代码镜像来自同一规范体系,镜像用于核对版本,不视为独立事实来源。

与Bitcoin Core listunspent配套的延伸阅读:Solana历史翻页CAR备份核验描述符安全检查