从零开始使用 @bsv/sdk：安装、验证与第一步

关于结算设计、数据持久性，以及为什么建设者仍在关注 BSV。

点对点电子现金是理解 Bitcoin 和 BSV 的入口。它强调通过交易、签名和公开账本直接转移数字价值，而不是依赖中心平台账户。本文解释 peer-to-peer、cash、双花、UTXO 以及 BSV 为什么重视低费用、高频交易和链上数据。

区块链不只是账本，更是一台公开的时间排序机器。本文解释 Bitcoin/BSV 中 timestamp server 的含义、区块高度与确认数的作用，以及时间戳在防双花和数据存证场景中的价值。

Proof of Work 通过“计算昂贵、验证便宜”的机制，让矿工在开放网络中竞争新区块，并用累积工作量决定交易历史排序。本文解释 PoW 的工作原理、矿工为何能排序交易、其安全意义，以及 BSV 在大区块、低费用和高交易量方向下的矿工经济逻辑。

本文用最基础的视角解释 BSV 网络的运行机制：交易如何构成、区块如何组织、矿工如何获得激励，以及为什么 BSV 特别强调低手续费、大区块和高吞吐链上交易。

SPV（简化支付验证）让轻客户端无需下载完整区块链，也能验证某笔交易是否被包含在区块中。本文解释 SPV 的工作原理、Merkle proof 的作用、它能证明什么、不能证明什么，以及为什么 SPV 是 BSV 架构中的核心能力。

BTC、BCH、BSV 都源自 Bitcoin，但技术路线明显不同。本文从链上扩容、低费用、稳定协议、SPV、企业数据和现实挑战出发，系统解释 BSV 为什么选择低费高量和大规模链上扩展路线。

WIF、助记词和 HD Wallet 都与密钥保存、恢复和派生有关，但含义不同。本文解释它们的区别、xpub 的作用，以及在 BSV 钱包和应用开发中的安全实践。

主网承载真实价值，测试环境用于学习和开发。本文梳理 BSV mainnet 与测试环境的区别、常见风险、SDK 使用中的注意事项，以及项目配置中的分环境建议。

BSV 钱包不是传统账户系统。链上没有单一余额字段，钱包通过管理私钥、UTXO、交易构造和签名来计算余额并发起交易。理解这一点，有助于正确认识找零、多输入、非托管钱包和应用授权等关键概念。

BRC-100 是 BSV 生态中描述应用与钱包如何通信的接口标准。它强调应用表达业务意图，钱包保留密钥控制权，帮助非托管应用以更安全、统一的方式请求创建交易、签名和返回结果。

Transaction input 是 BSV 交易的资金来源，它引用上一笔交易中的某个未花费 output，并提供解锁数据。理解 input 有助于掌握 UTXO 模型、outpoint、双花冲突、手续费计算和交易调试。

Transaction output 是 BSV 交易创建的新价值单元，通常由金额和 locking script 组成。它既可以表示付款和找零，也可以承载 OP_RETURN 数据、token 状态或业务记录。理解 output、UTXO 和 output index，是理解 BSV 交易与应用协议设计的基础。

TXID 是 BSV 中最常见的交易标识，可用于查询交易、引用 output、保存业务记录和构建 SPV 证明。但 TXID 标识的是整笔交易，不等于 output，也不代表交易已最终完成。实际应用中应结合 output index、状态、raw transaction 和证明材料一起保存。

找零 output 是 BSV UTXO 模型中的关键概念：旧 UTXO 必须整体花费，未用完的金额需要通过新的 output 退回给付款方。本文解释找零的工作方式、手续费关系、找零地址、隐私影响以及 UTXO 管理中的实践问题。

BSV 交易手续费不是独立字段，而是输入总额减去输出总额。理解这个规则有助于正确处理找零、估算费用、管理 UTXO，并避免把余额误作为手续费。

raw transaction 是交易按协议规则序列化后的原始字节表示，通常以十六进制字符串展示。它关系到 TXID、签名、广播和调试，是理解 BSV 交易底层机制的关键概念。

Endian 是 BSV 交易调试中常见的字节序问题，尤其容易出现在 raw transaction、TXID、outpoint、数字字段和 Merkle proof 中。理解显示格式与底层序列化字节的区别，可以避免很多“TXID 不匹配”或“proof 算错”的误判。

UTXO 是“未花费交易输出”，是 BSV 交易模型的基本单位。钱包余额并不是链上的账户字段，而是一组可控制 UTXO 的金额总和。理解 UTXO，有助于理解 BSV 的 input、output、找零、手续费、双花、Script 以及并行处理。

在 BSV 中，花钱不是修改余额，而是消耗旧 UTXO、创建新 UTXO。理解这一点，有助于掌握付款、找零、交易链以及 token 和应用状态转移的基本逻辑。

在 BSV 的 UTXO 模型中，一个地址不是账户，也不是单一余额槽。同一个地址可以关联多个 UTXO，钱包余额只是这些 UTXO 的汇总。理解这一点，有助于正确处理交易构造、手续费、UTXO 碎片化和隐私问题。

UTXO 模型将状态拆分为独立输出，使得交易验证可以并行进行，为 BSV 的链上扩容和高吞吐提供了关键数据结构基础。本文对比账户模型与 UTXO 模型，解释并行性原理、实际限制以及与 Teranode 和应用设计的关系。

双花是数字现金系统的核心问题。本文用通俗语言解释双花的原理、交易结构、矿工作用、0-conf 风险、签名与双花的关系，以及工程实践中的注意事项。

Locking script 是 BSV 交易中不可或缺的部分，它定义了 UTXO 的花费条件。本文从基础概念出发，逐步解析 locking script 的位置、与地址的关系、表达方式及其在应用中的重要性。

Unlocking Script 是交易输入中的解锁材料，用于满足上一笔输出的锁定条件。本文从概念、位置、工作原理到常见误解，全面解析这一关键机制。

P2PKH（Pay to Public Key Hash）是 Bitcoin/BSV 中最基础的普通支付脚本。本文拆解其核心逻辑、工作流程、与地址的关系、解锁条件，并解释为什么 BSV 开发者需要理解它。

了解OP_RETURN的基本概念、与普通支付的区别、数据格式要求、隐私注意事项以及应用场景。

Bitcoin Script是一种基于栈执行的脚本语言，用于验证交易花费条件。本文从栈的概念出发，通过例子说明其执行过程，并探讨P2PKH、受限设计、BSV应用等关键点，帮助理解这一链上验证语言的核心机制。

共识上有效的交易，网络不一定处理。理解标准脚本与矿工策略，避免交易广播失败。

WalletClient 是 BSV 应用中连接钱包的标准化客户端，它让应用描述交易意图，钱包负责授权、签名和 UTXO 管理，从而隔离私钥、UTXO 和签名等复杂度。

createAction() 是 BSV SDK 的核心方法，让应用通过高级接口描述交易动作，钱包自动处理签名、费用和广播。本文带你理解其原理、参数和实际用法。

使用高级SDK时，钱包可以自动选择可花费的UTXO、生成找零output并计算手续费。本文解释这一过程的工作原理、益处和潜在风险。

BSV 交易不仅能转移 satoshis，还能通过数据输出将文本、哈希或业务事件写入链上。本文从第一笔 Hello BSV 交易讲起，介绍数据输出与支付输出的区别、如何使用 SDK 构造 OP_RETURN、十六进制转换原因，以及如何走向结构化协议设计。

本文教你如何使用区块浏览器 WhatsOnChain 查看交易详情，理解 inputs、outputs、脚本、手续费等核心概念，并借助浏览器反向理解 SDK 的底层逻辑。

在 BSV 的 UTXO 模型中，手动指定交易输入是进阶开发的必备技能。本文深入解析输入的本质、所需信息、代码示例和常见误区，帮你避开“地址扣款”的思维陷阱。

理解比特币交易输出（output）的机制，从手动构造交易开始。本文介绍输出的类型、找零规则、索引顺序及常见误区，帮助你从“会发交易”进阶到“会设计 BSV 应用”。

交易手续费并非显式字段，而是输入总额与输出总额的差额。理解手续费计算逻辑、交易大小的影响因素以及BSV网络策略，是构建链上应用的基础。

理解比特币交易中多输入签名的必要性，避免常见误解，并了解 P2PKH 签名的基本逻辑、SDK 使用方法以及签名保护的具体内容。

理解交易序列化是连接应用开发与区块链网络的关键。本文介绍为何需要序列化、标准交易结构、hex 的作用、SDK 中的序列化与反序列化、txid 关系以及常见误区，帮助你从调 SDK 进阶到调试链上数据。

在 BSV 开发中，构造交易只是第一步。本文详细讲解广播交易的意义、常见误区、广播前检查、返回值处理及失败原因，帮助开发者正确将交易提交至网络。

理解交易链，才能真正理解比特币白皮书中“coin 是一条数字签名链”的含义。本文从最小模型出发，介绍 UTXO 在交易之间如何转移，以及交易链在 BSV 应用状态管理中的关键作用。

区块头是比特币区块的80字节摘要，虽不包含完整交易，却是连接工作量证明链和承诺交易集的关键结构。本文解释区块头字段、Merkle root和SPV原理，帮助理解BSV大规模扩展的实现基础。