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的一级资料与适用边界
- Bitcoin Core listunspent:在Bitcoin Core listunspent核验中支持定义、接口、当前规范字段和主流程;本文访问日期为2026年7月24日。
- Bitcoin Core 30 RPC index:在Bitcoin Core listunspent核验中支持实现来源、边界条件、版本或交叉验证;本文访问日期为2026年7月24日。
UTXO选择涉及隐私、手续费和本金损失风险,广播前必须在硬件设备核对输出;本文不构成投资建议。 关于Bitcoin Core listunspent的结论只对记录中的网络、版本和状态点有效;一级规范与代码镜像来自同一规范体系,镜像用于核对版本,不视为独立事实来源。
与Bitcoin Core listunspent配套的延伸阅读:Solana历史翻页、CAR备份核验、描述符安全检查。
发表评论
还没有评论,来说两句吧。
评论区为展示样式,提交不会被处理。