TITLE: Python实战：手把手教你完成比特币离线交易签名（代码示例）
Python代码实战：一步步构建比特币交易签名与离线广播
对于希望深入了解比特币底层技术的开发者来说，自己动手用Python实现一次交易签名，无疑是绝佳的学习路径。这不仅能让你摆脱对图形界面的依赖，更能深刻理解“私钥签名、公钥验证”这一非对称加密的核心在区块链中如何落地。截至 2026-02-28，我们就抛开复杂的理论，直接用代码来“盘”它。
一、准备工作：环境与核心库
在开始敲代码之前，我们需要一个清晰的“工具箱”。比特币交易签名并不需要连接网络，但需要正确的库来处理底层协议。
核心选择：bitcoinlib 或 bit
市面上有几个优秀的Python库，这里我倾向于使用bit库（它是bitcoinlib的一个友好分支），因为它接口清晰，对新手更友好。当然，你也可以使用更底层的ecdsa库从头开始，但那会涉及大量椭圆曲线的数学细节，我们暂且绕过。
首先，通过pip安装：
pip install bit
安全须知：
* 本文所有操作均在测试网络（Testnet）进行。绝对不要用主网比特币或真实私钥来练习！
* 离线环境：建议在完全离线的电脑上运行涉及私钥的代码，以确保最高级别的安全。
* 私钥即一切：妥善保管你的私钥，丢失则资产永失，泄露则资产被盗。
二、理解交易签名的“原材料”
一次标准的交易签名，需要准备以下几样“原材料”：
- 未花费的交易输出（UTXO）：你要花掉的那笔“钱”的来源。需要知道它的交易ID（txid）、输出索引（vout）和金额（amount）。
- 接收方地址：钱要转到哪里去。
- 找零地址：通常是你自己的另一个地址，用于接收支付后剩余的钱。
- 私钥：与UTXO所属地址对应的私钥，用于对这笔花费授权。
为了获取测试网的UTXO，你可以使用测试网水龙头获取一些测试币。这里我们假设你已经有了以下信息（均为测试网示例）：
- 来源UTXO:
txid: “abc123...”, vout: 0, amount: 0.001 BTC - 私钥（WIF格式）:
cN4YQ...（测试网私钥） - 接收地址:
tb1qj9pz... - 找零地址:
tb1q0e2l...
三、核心代码：分步签名与构建交易
让我们进入最关键的实操环节。下面的代码将一步步展示如何构建并签名一笔交易。
from bit import PrivateKeyTestnet
from bit.network import NetworkAPI
import hashlib
# 步骤1：用私钥创建密钥对象（这里使用测试网）
my_key = PrivateKeyTestnet('你的测试网私钥_WIF格式')
# 步骤2：创建交易输出列表（你要创建多少个输出）
# 格式：（接收地址， 金额（单位：BTC）， 是否找零）]
outputs =
(‘tb1qj9pz...（接收地址）’， 0.0005, ‘btc’）， # 支付0.0005 BTC给对方
(‘tb1q0e2l...（找零地址）’， None, ‘btc’） # 找零，金额自动计算
]
# 步骤3：准备UTXO列表（你要花费哪些钱）
# 需要知道每个UTXO的 txid, 输出索引， 脚本公钥， 金额
# 这里我们通过查询本地址的UTXO来自动获取（需要联网，仅此步骤需网络）
print(“正在查询未花费输出...”)
unspents = my_key.get_unspents()
print(f“找到 {len(unspents)} 个未花费输出。”)
# 步骤4：创建、签名原始交易
print(“正在创建和签名交易...”)
try:
# 使用私钥对象准备交易
tx_hex = my_key.create_transaction(outputs=outputs, fee=0.0001, absolute_fee=True, unspents=unspents)
print(“交易签名成功！”)
print(“原始交易十六进制（hex）:”)
print(tx_hex)
except Exception as e:
print(f“创建交易失败: {e}”)
代码要点解析：
* PrivateKeyTestnet：专门用于测试网的私钥类。
* create_transaction：这个方法帮我们完成了大量繁重工作，包括自动选择UTXO、计算找零、设置手续费（这里我们固定为0.0001 BTC）以及最重要的签名。
* tx_hex：这就是最终产出的、已签名的原始交易十六进制字符串。它已经包含了所有必要的数字签名，可以被任何比特币节点验证和执行。
四、广播交易：让网络确认
签名后的交易只是一段数据，需要广播到比特币网络，才能被矿工打包确认。bit库也提供了简单的方法。
# 步骤5：广播交易到网络（此步骤需要联网）
print(“正在广播交易...”)
try:
tx_id = NetworkAPI.broadcast_tx(tx_hex)
print(f“广播成功！交易ID（Txid）为： {tx_id}”)
print(f“你可以在区块浏览器查看： https://blockstream.info/testnet/tx/{tx_id}”)
except Exception as e:
print(f“广播失败: {e}”)
# 广播失败可能因为手续费过低、双花等。你可以将tx_hex保存下来，稍后用其他节点重试。
至此，你已经完成了一次从签名到广播的完整比特币交易生命周期。整个过程的核心在于私钥签名，而广播只是一个网络通信动作。
五、进阶思考与手动签名
使用高级库固然方便，但为了真正理解，我们不妨探讨一下手动签名的逻辑。本质上，签名是对交易信息的哈希值用私钥进行加密。
Q： 交易签名到底签了什么？
A： 签名的对象是当前交易的“简化版”数据，主要包括：
* 要花费的UTXO信息。
* 新的输出（收款人、金额）。
* 锁定脚本（ScriptPubKey）等。
对这部分数据做两次SHA256哈希，得到待签名的“消息摘要”。
手动签名流程概览：
1. 构建原始交易数据（未签名）。
2. 对每个输入，生成其对应的待签名哈希（SIGHASH）。
3. 使用私钥对应的椭圆曲线算法（ECDSA）对哈希进行签名，生成（r, s）签名对。
4. 将签名和对应的公钥，按照脚本语言（Script）规则，嵌入到交易的输入脚本中。
这个过程非常复杂且容易出错，这也是为什么我们推荐使用bit或bitcoinlib这类成熟库的原因。它们已经完美地封装了这些细节。
六、主流Python比特币库功能对比
为了帮助你在不同项目中选择合适的工具，这里有一个简单的对比：
| 库名称 | 主要特点 | 适合场景 | 学习曲线 |
|---|---|---|---|
| bit | 接口友好，文档清晰，专注于易用性 | 快速开发、新手学习、钱包功能集成 | 平缓 |
| bitcoinlib | 功能全面，支持多币种，底层控制力强 | 高级开发、需要处理复杂交易、多链应用 | 中等 |
| pycoin | 工具集丰富，支持UTXO操作和交易解析 | 交易分析、教学、底层协议研究 | 较陡 |
| ecdsa | 纯椭圆曲线数字签名库，无比特币特定逻辑 | 密码学研究和教学，需要从最底层构建 | 陡峭 |
我的观点是，对于绝大多数应用和初学者，bit库是平衡易用性与功能性的最佳起点。它能让你快速获得正反馈，理解流程，而不是过早陷入密码学泥潭。
七、安全实践与价格考量（测试网）
虽然我们用的是测试网，但安全习惯必须养成。真正的比特币价值波动剧烈，手续费也随网络拥堵而变化。这里有一个模拟的主网与测试网成本对比，帮助你理解差异：
| 网络 | 币价值 | 典型交易手续费（目标：下一区块） | 交易目的 | 风险 |
|---|---|---|---|---|
| 比特币主网 | 实时市价（数万美金/BTC） | 3-15美元（波动大） | 真实资产转移 | 高（私钥泄露=财产损失） |
| 比特币测试网 | 0美元 | ≈0美元（矿工自愿打包） | 开发、测试、学习 | 无（除时间成本） |
这张表清晰地告诉我们：在主网上操作前，必须在测试网上反复验证你的代码逻辑。任何微小的错误都可能导致真金白银的损失。
通过这次实战，你不仅学会了如何使用Python代码驱动比特币交易，更重要的是，你穿透了钱包软件的黑箱，直接触摸到了区块链价值转移的基石。接下来，你可以尝试更复杂的交易，比如多重签名、时间锁交易，这将为你打开通往更高级区块链开发的大门。记住，在加密世界里，代码即权力，而理解代码背后的逻辑，是安全行使这种权力的前提。
风险与注意事项
- 加密资产波动大，短期涨跌不可预测，请只用可承受损失的闲置资金参与。
- 警惕“保本、带单、内幕消息”等话术；涉及转账私钥/助记词的一律视为高风险。
- 若你参考了平台规则或公告，请以其在 2026-02-28 前后的最新版本为准。
本文仅作信息分享，不构成投资建议。市场有风险，决策需谨慎。
