什么是Transaction Labeling？定义、背景与来源

01什么是Transaction Labeling？

Transaction Labeling 为钱包记录附加用户元数据，例如付款用途或币的来源。标签文本不是 Bitcoin 交易的一部分，本身不能证明对手方身份或所有权。

笔记位于链外，不会仅凭 seed 自动恢复。
类型与引用区分交易、输入和输出；txid:index 单独存在歧义。
spendable:false 是本地选币策略，不是共识层花费禁令。
按具体记录、账户及支持字段验证敏感备份与导入。

02元数据不是新交易

给付款改名只会修改应用数据库，不会改变 txid 或链上历史。因此，从 seed 恢复密钥本身不会恢复用户笔记。标签格式传输钱包间的背景信息，不传输花费权限。 [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]

03标记正确的对象

BIP 329 区分 tx、addr、pubkey、input、output、xpub 和 spscan。input 的 ref 指交易及其输入索引；output 则指创建该输出的交易及输出索引。因此，没有类型的同一个 txid:1 无法区分输入和输出。 [BIP 329 — Wallet Labels Export Format]

04BIP 329 逐条传输记录

JSON Lines 使用 UTF-8，每行一个 JSON 对象。type 和 ref 必填；label、origin、spendable 可选。导入时缺少 label 或 spendable 不应改变已有值。兼容导入器应忽略未知类型，但这并不保证全部数据迁移。 [BIP 329 — Wallet Labels Export Format]

05冻结只是本地规则

spendable 只用于 output，使用布尔值 false 而非字符串 "false"。钱包可据此把币排除在选币之外。这不是 Timelock 或脚本禁令；另一个掌握密钥的钱包，在真实条件满足时仍可花费。 [BIP 329 — Wallet Labels Export Format] [Bitcoin Developer Guide — Transactions]

06Origin 区分钱包而非验证作者

origin 包含带密钥来源信息的简写 descriptor，不含实际密钥、子路径或校验和。它帮助区分不同账户或钱包对同一交易的标签，并不是导出签名，也不证明笔记真实。 [BIP 329 — Wallet Labels Export Format]

07记录观察而非把推测当事实

区分个人笔记、自动关联发票和导入的分析主张。BTCPay 使用 invoice、payout 等标签，也允许自定义。币的来源有助于 Coin Control，但名称本身不能阻止不适当合并；实际输入选择才起作用。 [BIP 329 — Wallet Labels Export Format] [BTCPay Server — Wallet]

08标签备份是独立敏感层

导出文件可能把地址、xpub 和付款历史与姓名连接起来。没有私有花费密钥类型，不代表文件无害。保护传输和存储，核对恢复账户；seed 不备份这层背景信息。 [BIP 329 — Wallet Labels Export Format]

09逐条验证迁移

在测试副本上比较导出和导入后的类型、ref、文本与 spendable。加入特殊字符、多账户、未知类型和缺少的可选值。导入器可能不支持部分记录或截断文本；255 字符是建议默认值，不是通用保证。成功读取文件本身不证明背景信息忠实恢复。 [BIP 329 — Wallet Labels Export Format]

↗结合上下文阅读

要获得更完整的理解，请将本词条与以下词条结合阅读： Coin Control, UTXO, Bitcoin 隐私, Address Clustering, Seed Phrase, Output Descriptor. 反向关联还来自： Chain Surveillance.