今年整理电子设备时我翻出了几块 2013 年的 USB 矿机还有一块 Butterfly Labs 的 Jalapeño ASIC 矿机。这些硬件曾经是比特币挖矿热潮里出镜率很高的“老将”放到今天来看算力几乎可以忽略不计。不过它们让我想通了一个问题与其纠结老矿机还能不能跑不如用纯 Python 从零写一个可运行的挖矿客户端把 Stratum 协议和 SHA-256 工作量证明完整走一遍顺便让手机也参与进来。这篇文章就围绕这条实验链路展开。我们会先回顾 2013 年 USB 矿机和 Jalapeño 的硬件背景然后拆解比特币挖矿与 Stratum 协议的核心概念接着用纯 Python 实现一个本地模拟矿池和一个迷你矿工客户端最后把同样的代码放到手机上运行并补充常见问题、排查思路和工程建议。整个过程只需要 Python 标准库不依赖任何第三方挖矿框架。无论你是对比特币底层机制好奇的开发者还是想理解“矿池、nonce、难度、SHA-256”这些概念到底如何落到代码上的学习者这篇文章都可以作为一次很好的动手实验。1. 背景与核心概念1.1 2013 年的 USB 矿机与 Jalapeño 是什么2013 年比特币挖矿正处于从 GPU 挖矿向 ASIC 矿机过渡的早期阶段。当时市面上出现了两类很具代表性的 ASIC 设备USB 矿机典型代表是 Block Erupter USB算力大约 333 MH/s整机功耗只有 2.5W 左右。它的外形像一个大号 U 盘直接插到电脑 USB 口上由 cgminer、bfgminer 等软件负责与矿池通信并调度挖矿任务。Jalapeño这是 Butterfly Labs 推出的 ASIC 矿机标称算力在 3.5 GH/s 左右功耗约 15W同样通过 USB 连接到电脑。在当年它属于“能真正跑出收益”的入门级设备也一度是矿工追捧的对象。这两种设备本质上都属于专用 ASIC 芯片它们的计算能力远远超过同时代的 CPU 和 GPU。但问题是它们只负责做 SHA-256 哈希计算并不理解比特币网络协议。矿工必须通过 cgminer 这类配套软件把矿池下发的任务转换成芯片可以执行的寄存器指令流。到了今天比特币全网算力已经进入 EH/s 级别一台当年 3.5 GH/s 的 Jalapeño 找到区块的概率几乎为零。因此那些老矿机更多是硬件收藏和协议学习的好素材。1.2 为什么还要用纯 Python 挖矿纯 Python 天然跨平台可以在 Windows、Linux、macOS、Android、iOS 上运行。更关键的是Python 标准库自带hashlib、socket、json、struct、threading不需要安装任何第三方库就能完成模拟 Stratum 协议中的 JSON-RPC 通信解析比特币区块头执行 SHA-256 双重哈希遍历 nonce 并判断是否满足难度目标。所以“纯 Python 挖矿”虽然在实际产出效率上毫无竞争力却是理解挖矿协议细节的最佳教学路径。你可以完整看到矿池如何下发任务、矿工如何构造区块头、nonce 如何递增、满足难度后如何提交。1.3 本文实验链路本文的实验链路如下用 Python 写一个本地模拟矿池服务器监听 3333 端口负责处理mining.subscribe、mining.authorize、mining.submit并主动下发mining.notify。用 Python 写一个纯 Python 矿工客户端连接模拟矿池接收任务计算 SHA-256 双重哈希寻找满足难度的 nonce。先在 PC 上运行验证再把客户端放到 Android 手机Pydroid 3 或 Termux中运行。实验目的是观察完整的挖矿流程而不是生产环境挖矿。2. 环境准备与版本说明2.1 运行环境本文示例使用 Python 3.8需要保证运行环境中已安装 Python。代码本身只依赖标准库所以不涉及pip install。推荐环境运行平台测试工具Python 版本Windows 10/11命令行、PowerShell3.8Linux / macOSTerminal3.8AndroidPydroid 3 / Termux3.8iOSPythonista 3 / Carnets3.8版本需要根据你的项目实际情况调整本文示例以常见环境为例重点演示协议与代码思路。建议在运行代码前执行python --version确认版本。2.2 项目文件结构为了便于阅读本文采用下面的文件结构bitcoin-miner-python/ ├── mock_stratum_server.py # 本地模拟矿池服务器 └── simple_stratum_miner.py # 纯 Python 矿工客户端两个文件放在同一目录下先启动服务器再启动客户端。3. 比特币工作量证明原理拆解3.1 SHA-256 双重哈希比特币工作量证明的核心是不断尝试 nonce使得区块头的 SHA-256 双重哈希结果小于某个目标值。双重哈希的公式是hash SHA256(SHA256(block_header))在 Python 中可以这样实现import hashlib def double_sha256(data: bytes) - bytes: return hashlib.sha256(hashlib.sha256(data).digest()).digest()hashlib是 Python 标准库基于 C 实现运行速度比纯 Python 算法快很多既有“纯 Python 代码”的简单跨平台特性又能保证基本计算速度。3.2 区块头结构比特币区块头固定为 80 字节各字段如下字段字节数说明version4区块版本号prev_block_hash32上一个区块的哈希内部字节序为 little-endianmerkle_root32交易 Merkle 树根哈希内部字节序为 little-endiantimestamp4出块时间Unix 时间戳little-endiannbits4难度目标的紧凑格式nonce4矿工遍历的随机数little-endian需要注意的是区块浏览器中展示的prev_block_hash和merkle_root是大端十六进制字符串而区块头内部存储时使用 little-endian 字节序所以解析时要调用bytes.fromhex(...)[::-1]反转。3.3 难度与 target 换算矿池下发的nbits是 32 位整数其中高 8 位为指数 exponent低 24 位为尾数 mantissa。难度目标 target 的计算方式为target mantissa * 256^(exponent - 3)难度 1 的 nbits 是0x1d00ffff对应 targettarget 0x00ffff * 256^(0x1d - 3)对应的 Python 解析函数如下def nbits_to_target(nbits: int) - int: exponent nbits 24 mantissa nbits 0x007fffff if exponent 3: return mantissa (8 * (3 - exponent)) return mantissa (8 * (exponent - 3))当矿工计算出的区块头哈希整数小于 target 时就代表找到了有效 nonce。3.4 Stratum 协议消息Stratum 协议基于 JSON-RPC矿工和矿池之间通过 TCP 连接传输换行分隔的 JSON 消息。核心方法如下方向方法作用矿工 - 矿池mining.subscribe订阅任务矿工 - 矿池mining.authorize授权矿工账号矿池 - 矿工mining.notify下发挖矿任务矿池 - 矿工mining.set_difficulty设置难度矿工 - 矿池mining.submit提交找到的 noncemining.notify的参数在真实协议中包括job_id、prev_hash、coinbase1、coinbase2、merkle_branch、version、nbits、ntime等字段。矿工需要先构造 coinbase再结合 merkle_branch 计算 merkle_root从而构造出完整的区块头。为了便于教学本文的模拟矿池会直接下发一个预先构造好的merkle_root省去 coinbase 拼接和 merkle 分支哈希计算步骤。这样可以把注意力集中在“区块头构造 nonce 遍历 难度判断”上。真实矿工客户端的 纯Python实现比特币挖矿客户端：从Stratum协议到SHA-256工作量证明
今年整理电子设备时我翻出了几块 2013 年的 USB 矿机还有一块 Butterfly Labs 的 Jalapeño ASIC 矿机。这些硬件曾经是比特币挖矿热潮里出镜率很高的“老将”放到今天来看算力几乎可以忽略不计。不过它们让我想通了一个问题与其纠结老矿机还能不能跑不如用纯 Python 从零写一个可运行的挖矿客户端把 Stratum 协议和 SHA-256 工作量证明完整走一遍顺便让手机也参与进来。这篇文章就围绕这条实验链路展开。我们会先回顾 2013 年 USB 矿机和 Jalapeño 的硬件背景然后拆解比特币挖矿与 Stratum 协议的核心概念接着用纯 Python 实现一个本地模拟矿池和一个迷你矿工客户端最后把同样的代码放到手机上运行并补充常见问题、排查思路和工程建议。整个过程只需要 Python 标准库不依赖任何第三方挖矿框架。无论你是对比特币底层机制好奇的开发者还是想理解“矿池、nonce、难度、SHA-256”这些概念到底如何落到代码上的学习者这篇文章都可以作为一次很好的动手实验。1. 背景与核心概念1.1 2013 年的 USB 矿机与 Jalapeño 是什么2013 年比特币挖矿正处于从 GPU 挖矿向 ASIC 矿机过渡的早期阶段。当时市面上出现了两类很具代表性的 ASIC 设备USB 矿机典型代表是 Block Erupter USB算力大约 333 MH/s整机功耗只有 2.5W 左右。它的外形像一个大号 U 盘直接插到电脑 USB 口上由 cgminer、bfgminer 等软件负责与矿池通信并调度挖矿任务。Jalapeño这是 Butterfly Labs 推出的 ASIC 矿机标称算力在 3.5 GH/s 左右功耗约 15W同样通过 USB 连接到电脑。在当年它属于“能真正跑出收益”的入门级设备也一度是矿工追捧的对象。这两种设备本质上都属于专用 ASIC 芯片它们的计算能力远远超过同时代的 CPU 和 GPU。但问题是它们只负责做 SHA-256 哈希计算并不理解比特币网络协议。矿工必须通过 cgminer 这类配套软件把矿池下发的任务转换成芯片可以执行的寄存器指令流。到了今天比特币全网算力已经进入 EH/s 级别一台当年 3.5 GH/s 的 Jalapeño 找到区块的概率几乎为零。因此那些老矿机更多是硬件收藏和协议学习的好素材。1.2 为什么还要用纯 Python 挖矿纯 Python 天然跨平台可以在 Windows、Linux、macOS、Android、iOS 上运行。更关键的是Python 标准库自带hashlib、socket、json、struct、threading不需要安装任何第三方库就能完成模拟 Stratum 协议中的 JSON-RPC 通信解析比特币区块头执行 SHA-256 双重哈希遍历 nonce 并判断是否满足难度目标。所以“纯 Python 挖矿”虽然在实际产出效率上毫无竞争力却是理解挖矿协议细节的最佳教学路径。你可以完整看到矿池如何下发任务、矿工如何构造区块头、nonce 如何递增、满足难度后如何提交。1.3 本文实验链路本文的实验链路如下用 Python 写一个本地模拟矿池服务器监听 3333 端口负责处理mining.subscribe、mining.authorize、mining.submit并主动下发mining.notify。用 Python 写一个纯 Python 矿工客户端连接模拟矿池接收任务计算 SHA-256 双重哈希寻找满足难度的 nonce。先在 PC 上运行验证再把客户端放到 Android 手机Pydroid 3 或 Termux中运行。实验目的是观察完整的挖矿流程而不是生产环境挖矿。2. 环境准备与版本说明2.1 运行环境本文示例使用 Python 3.8需要保证运行环境中已安装 Python。代码本身只依赖标准库所以不涉及pip install。推荐环境运行平台测试工具Python 版本Windows 10/11命令行、PowerShell3.8Linux / macOSTerminal3.8AndroidPydroid 3 / Termux3.8iOSPythonista 3 / Carnets3.8版本需要根据你的项目实际情况调整本文示例以常见环境为例重点演示协议与代码思路。建议在运行代码前执行python --version确认版本。2.2 项目文件结构为了便于阅读本文采用下面的文件结构bitcoin-miner-python/ ├── mock_stratum_server.py # 本地模拟矿池服务器 └── simple_stratum_miner.py # 纯 Python 矿工客户端两个文件放在同一目录下先启动服务器再启动客户端。3. 比特币工作量证明原理拆解3.1 SHA-256 双重哈希比特币工作量证明的核心是不断尝试 nonce使得区块头的 SHA-256 双重哈希结果小于某个目标值。双重哈希的公式是hash SHA256(SHA256(block_header))在 Python 中可以这样实现import hashlib def double_sha256(data: bytes) - bytes: return hashlib.sha256(hashlib.sha256(data).digest()).digest()hashlib是 Python 标准库基于 C 实现运行速度比纯 Python 算法快很多既有“纯 Python 代码”的简单跨平台特性又能保证基本计算速度。3.2 区块头结构比特币区块头固定为 80 字节各字段如下字段字节数说明version4区块版本号prev_block_hash32上一个区块的哈希内部字节序为 little-endianmerkle_root32交易 Merkle 树根哈希内部字节序为 little-endiantimestamp4出块时间Unix 时间戳little-endiannbits4难度目标的紧凑格式nonce4矿工遍历的随机数little-endian需要注意的是区块浏览器中展示的prev_block_hash和merkle_root是大端十六进制字符串而区块头内部存储时使用 little-endian 字节序所以解析时要调用bytes.fromhex(...)[::-1]反转。3.3 难度与 target 换算矿池下发的nbits是 32 位整数其中高 8 位为指数 exponent低 24 位为尾数 mantissa。难度目标 target 的计算方式为target mantissa * 256^(exponent - 3)难度 1 的 nbits 是0x1d00ffff对应 targettarget 0x00ffff * 256^(0x1d - 3)对应的 Python 解析函数如下def nbits_to_target(nbits: int) - int: exponent nbits 24 mantissa nbits 0x007fffff if exponent 3: return mantissa (8 * (3 - exponent)) return mantissa (8 * (exponent - 3))当矿工计算出的区块头哈希整数小于 target 时就代表找到了有效 nonce。3.4 Stratum 协议消息Stratum 协议基于 JSON-RPC矿工和矿池之间通过 TCP 连接传输换行分隔的 JSON 消息。核心方法如下方向方法作用矿工 - 矿池mining.subscribe订阅任务矿工 - 矿池mining.authorize授权矿工账号矿池 - 矿工mining.notify下发挖矿任务矿池 - 矿工mining.set_difficulty设置难度矿工 - 矿池mining.submit提交找到的 noncemining.notify的参数在真实协议中包括job_id、prev_hash、coinbase1、coinbase2、merkle_branch、version、nbits、ntime等字段。矿工需要先构造 coinbase再结合 merkle_branch 计算 merkle_root从而构造出完整的区块头。为了便于教学本文的模拟矿池会直接下发一个预先构造好的merkle_root省去 coinbase 拼接和 merkle 分支哈希计算步骤。这样可以把注意力集中在“区块头构造 nonce 遍历 难度判断”上。真实矿工客户端的