区块链原理 / 系统课时

配置 Python 区块验证实验环境

配置 Python 区块验证实验环境

本课使用 Python 标准库搭建可重复运行的区块验证实验环境,包括独立虚拟环境、固定脚本入口、JSON 序列化和 SHA-256 哈希计算。完成后,你将获得一个能够稳定生成区块摘要、检测数据变化的最小实验程序,为后续实现区块链接和交易验证提供基础。

学习目标

  • 安装并检查 Python 解释器,创建隔离的实验环境。
  • 使用 json 和 hashlib 实现确定性的区块序列化与 SHA-256 摘要计算。
  • 运行实验脚本,验证字段顺序变化与区块内容修改对哈希结果的影响。

检查 Python 并创建独立环境

实验适用于 Python 3.10 及以上版本,只使用标准库中的 json 和 hashlib,无需安装第三方依赖。建议使用 Python 3.11 或更新的受支持版本。

先确认系统已安装 Python。macOS 或 Linux 在终端执行:

bash
python3 --version
mkdir blockchain-lab
cd blockchain-lab
python3 -m venv .venv
.venv/bin/python --version

预期结果:两次版本检查均显示 Python 3.10 或更高版本,并在 blockchain-lab 目录中生成 .venv 虚拟环境。具体版本号取决于本机安装的解释器。

Windows PowerShell 使用以下命令:

powershell
py -3 --version
New-Item -ItemType Directory -Path blockchain-lab
Set-Location blockchain-lab
py -3 -m venv .venv
.\.venv\Scripts\python.exe --version

预期结果:能够看到 Python 版本信息,当前目录为 blockchain-lab,其中包含 .venv。如果系统没有 py 命令,但已经安装并配置了 Python,可以将 py -3 替换为 python。

虚拟环境用于隔离当前实验与其他项目的依赖。这里直接调用虚拟环境中的 Python 可执行文件,不必激活环境,也可以避开部分 PowerShell 脚本执行策略限制。

在实验目录中创建 verify_block.py。最终需要保留的项目文件只有该脚本;.venv 是可重新生成的本地环境目录。如果使用 Git 管理项目,应将 .venv/ 加入 .gitignore,不要提交虚拟环境文件。

编写确定性的区块摘要脚本

区块哈希计算有一个容易忽略的前提:相同的逻辑数据必须先转换成相同的字节序列。直接依赖字典的插入顺序或默认 JSON 空白格式,可能让语义相同的数据得到不同的哈希值。

本实验使用三个明确的序列化约定:

  1. sort_keys=True:按键名排序,避免字典插入顺序影响序列化结果。
  2. separators=(",", ":"):去掉默认的分隔空格,固定 JSON 字节格式。
  3. ensure_ascii=False:直接保留 Unicode 字符,再统一编码为 UTF-8 字节。

同时使用 allow_nan=False 拒绝 JSON 标准不支持的 NaN 和 Infinity 数值。实验中的交易金额采用整数,避免浮点数表示问题。

将以下完整代码保存到 verify_block.py:

python
import hashlib
import json


def canonical_bytes(block: dict) -> bytes:
    # 固定键顺序与空白规则,保证相同数据生成相同字节。
    return json.dumps(
        block,
        sort_keys=True,
        separators=(",", ":"),
        ensure_ascii=False,
        allow_nan=False,
    ).encode("utf-8")


def digest(block: dict) -> str:
    return hashlib.sha256(canonical_bytes(block)).hexdigest()


def main() -> None:
    block = {
        "index": 0,
        "previous_hash": "0" * 64,
        "transactions": [
            {"sender": "alice", "recipient": "bob", "amount": 5}
        ],
        "nonce": 0,
    }

    # 改变字典键的插入顺序,不应改变区块摘要。
    reordered = dict(reversed(list(block.items())))

    # 修改参与哈希计算的字段,应得到不同的摘要。
    modified = {**block, "nonce": 1}

    print("哈希:", digest(block))
    print("字段重排一致:", digest(block) == digest(reordered))
    print("修改 nonce 后不同:", digest(block) != digest(modified))

    # 验证 JSON 编码与解码能还原实验数据。
    print("JSON 往返一致:", json.loads(canonical_bytes(block)) == block)


if __name__ == "__main__":
    main()

该脚本使用索引为 0 的实验区块,前一区块哈希暂用 64 个字符 0 表示,交易包含一笔从 alice 到 bob、金额为 5 的转账记录。这里的交易只是待验证数据,不表示转账已经得到授权或确认。

hashlib.sha256() 对字节序列计算 SHA-256 摘要,hexdigest() 将其转换为 64 个十六进制字符。对于相同输入字节,摘要必定相同;修改输入后,通常会得到完全不同的摘要。

执行脚本并核对输出

保存文件后,在 blockchain-lab 目录中运行。macOS 或 Linux 使用:

bash
.venv/bin/python -c 'import sys; print(sys.prefix != sys.base_prefix)'
.venv/bin/python verify_block.py

预期输出:

text
True
哈希: 364fddd4351c7d72f345366af9ab937cb3f610ce3c9d516d403a9ea6099250da
字段重排一致: True
修改 nonce 后不同: True
JSON 往返一致: True

第一行 True 表示当前脚本使用的是虚拟环境解释器,而不是系统解释器。

Windows PowerShell 可使用对应的虚拟环境 Python 执行:

powershell
.\.venv\Scripts\python.exe -c "import sys; print(sys.prefix != sys.base_prefix)"
.\.venv\Scripts\python.exe .\verify_block.py

预期输出与上面的 macOS/Linux 示例完全相同。由于区块数据固定且序列化规则确定,不同操作系统上的这一测试应生成相同摘要。

四项结果分别说明:实验使用独立解释器、字典键插入顺序不会改变摘要、修改 nonce 能改变摘要,以及 JSON 编解码能够还原原始数据。

可以再做一次手动验证:将 amount 从 5 改为 6,重新运行脚本。此时第一行哈希摘要应改变,但后三项检查仍应输出 True。恢复金额为 5 后,哈希应重新等于原始值。

排查环境问题与明确验证边界

如果实验没有得到预期结果,按以下顺序检查。

现象 检查与处理
找不到 python3 或 py 检查 Python 是否安装,并确认终端可找到对应命令;安装或调整 PATH 后重新打开终端
创建虚拟环境失败 检查 Python 版本;部分 Linux 发行版需要额外安装与解释器版本匹配的 venv 软件包
找不到 verify_block.py 确认当前工作目录为 blockchain-lab,并检查文件名和扩展名
json 或 hashlib 导入异常 检查目录中是否存在意外命名为 json.py、hashlib.py 的文件,避免覆盖标准库模块
同一数据计算出不同哈希 核对字段类型、交易数组顺序、UTF-8 编码及 json.dumps() 参数是否完全一致

还要区分区块摘要计算与完整区块验证。当前脚本只证明数据可以被确定性编码并计算哈希,没有检查交易签名、账户余额、前一区块是否存在、工作量证明是否满足难度目标,也没有执行节点间共识。

例如,将 previous_hash 设置为 64 个 0 可以计算出合法的 SHA-256 摘要,却不代表它真的指向某个有效的前置区块。后续实现链式验证时,必须独立检查该字段是否等于前一区块实际计算出的摘要。

完成本实验的验收标准是:虚拟环境能独立运行、同一数据重复生成相同的 64 字符摘要、字段插入顺序改变不影响结果、区块内容修改引发摘要变化。保留 verify_block.py,即可继续在此入口上添加区块结构和验证规则。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Python 区块验证实验环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通