
先读黄皮书仓库自己的过时声明
GitHub仓库ethereum/yellowpaper把黄皮书定位为以太坊协议的形式化定义(formal definition),并说明其最初由Gavin Wood撰写、现由维护者继续更新。同一README用醒目标题写明“Repository Currently Outdated”:黄皮书已过时,反映的是截至Shanghai网络升级的以太坊规范;Shanghai在主网于区块17,034,870(2023年4月)激活。页面还写明:它尚未包含Cancun升级引入的变更。
因此,检索“区块链黄皮书”时,不能把仓库里的PDF或历史TeX稿自动当成“当前主网全部共识规则的最新完整说明书”。应先固定:你打开的是哪一个仓库URL、README是否仍显示Outdated、它自称覆盖到哪一次升级、以及它明确尚未写入的后续升级名称。
执行层规范是并列的、仍在维护的入口
黄皮书README在过时声明之后直接给出替代提示:另有一份用Python书写的Execution Layer规范正在积极维护且保持更新。对应仓库ethereum/execution-specs自我描述为Ethereum Execution Layer Specifications(EELS):可执行的Python参考实现,并附带用于验证的测试用例;它提供对共识关键行为的共享、可运行描述,测试可生成用于校验执行客户端的fixtures。
把两份资料并读时,宜分成两层对象:一层是黄皮书作为历史/形式化文本(带明确的Shanghai边界与Cancun缺口);另一层是execution-specs作为跟踪网络升级的执行层规范与测试入口。不要把“黄皮书PDF仍可下载”误读成“执行层升级已全部写入黄皮书正文”。

可执行的对照清单
建议核对顺序:打开yellowpaper README,摘录Outdated段落中的Shanghai区块高度/时间与“不含Cancun”句;打开execution-specs README,确认其EELS定位、可执行参考实现与测试/fixtures用途;再决定引用时标注的是哪一份对象、哪一版边界。搜索引擎摘要、第三方解读文不能替代仓库自我声明。
本篇不比较客户端实现优劣,不给出升级时间表投资含义,也不把形式规范写成审计结论。对“区块链黄皮书”资料,先分清过时声明与现行执行层规范入口,再谈能否当作最新规范引用。