EIP-658 解读以太坊如何在交易收据中嵌入执行状态码【免费下载链接】EIPsThe Ethereum Improvement Proposal repository项目地址: https://gitcode.com/GitHub_Trending/ei/EIPs导读EIP-658Embedding transaction status code in receipts交易收据内嵌执行状态码是以太坊 Metropolis 硬分叉中的一项核心协议改进它将交易收据receipt中已废弃的中间状态根字段替换为一个布尔状态码1 表示成功、0 表示失败让所有类型的节点都能在不重放交易的前提下直接判断一笔交易是否成功。本文以仓库中的 EIPS/eip-658.md 为主体结合 EIP-140REVERT 指令、EIP-1474JSON-RPC 规范 与 EIP-6466SSZ 收据 等关联提案完整还原该 EIP 的背景、规范细节、设计取舍与其在现代以太坊中的深远影响。读完本文你将掌握交易状态码的来龙去脉、收据字段的历史变迁以及如何通过 RPC 接口消费这一状态信息。一、提案基本信息项目内容EIP 编号658标题Embedding transaction status code in receipts作者Nick Johnsonnickethereum.org类型Standards Track类别Core状态Final创建时间2017-06-30依赖EIP-140EIP-658 属于影响共识的核心类Core提案已在以太坊主网生效并成为历史事实标准。它依赖 EIP-140因为正是 REVERT 指令的引入打破了交易失败 耗尽全部 Gas这一旧有假设才迫使收据格式做出相应调整。二、背景REVERT 指令如何打破旧的失败判定在 EIP-140 之前智能合约只能通过两种方式主动让一笔交易失败耗尽 Gas或执行一条非法指令。这两种方式的共同代价是消耗掉剩余的全部 Gas因此客户端可以据此推断只要交易没有耗尽所有 Gas它就算成功了。EIP-140 在block.number BYZANTIUM_FORK_BLKNUM的区块上引入了0xfd操作码REVERT它从栈顶取两个操作数memory_offset与memory_length语义与内存计价规则和RETURN完全一致执行REVERT会中止执行、回滚全部状态变更并可在 returndata 缓冲区中携带一段错误消息错误码或错误说明关键在于回滚本身不会消耗剩余的全部 Gas合约只需支付内存费用成本与RETURN相同若 Gas 不足或栈下溢则退化为普通的 out-of-gas 异常此时仍会耗尽全部 Gas。这意味着从拜占庭分叉开始交易失败与耗尽所有 Gas不再等价一笔交易完全可以在 Gas 充裕的情况下通过REVERT主动失败。调用者因此失去了判断交易成败的可靠信号——这正是 EIP-658 要解决的痛点。三、动机失败判定为何必须上链3.1 重放方案的局限性理论上全节点可以通过重放交易来获取返回状态与返回值但这只在特定节点形态下可行全节点Full node可以通过重放交易计算状态与返回值快速同步节点Fast node只能对其同步枢轴点pivot point之后的区块做这件事轻节点Light node根本无法重放交易。因此依赖重放的非共识层解决方案不具普适性——轻客户端和快速同步节点同样需要判断交易成败而这个信息必须由协议本身提供。3.2 收据中已有的空位交易收据receipt原本包含一个中间状态根intermediate state root字段用于记录交易执行后的状态树根。该字段早已被 EIP-98 废弃拜占庭分叉不再使用中间状态根只保留最终状态根但其在收据中的占位依然存在。EIP-658 的核心创意是把这块已被废弃、不再承担共识职责的字段替换为交易的成败状态码。这一改动一举两得让调用者可以确定性地获取交易成败状态顺带弥补了收据此前不含返回数据return data信息的缺憾。四、规范状态码替换中间状态根EIP-658 的规范只有一条改动面极小对于满足block.number BYZANTIUM_FORK_BLKNUM的区块收据中的中间状态根字段被替换为状态码0表示失败由任何导致交易或顶层调用回滚的操作引起1表示成功。这一规范直接写入了拜占庭硬分叉的共识规则。自此收据的 RLP 编码中不再包含中间状态根取而代之的是一个单字节布尔值0x01交易成功交易内的状态变更全部生效0x00交易失败状态变更全部回滚无论失败原因是 out-of-gas、非法指令、REVERT还是其他任何回滚操作。从后续提案的印证看这一替换是彻底的。例如 EIP-6466SSZ 化收据在描述收据字段时明确指出statusEIP-658 交易状态码见 EIP-658并且该提案在 SSZ 收据中不再保留中间状态根Homestead 方案字段——这正是 EIP-658 移除该字段的直接延续。五、设计取舍为什么这是最小可行改动EIP-658 的 Rationale 部分将自身定位为最小可能的改动它复用了收据中已经存在的、被 EIP-98 废弃的字段位没有新增任何收据字段或改变收据的编码结构本身它保持了既有能力状态码不破坏任何原有功能只是让查询交易成败从隐式推断变为显式字段它对 Metropolis拜占庭硬分叉几乎没有额外的实现工作量风险与中断面都降到了最低。这种用废弃字段换新语义的设计思路是协议演进中典型的务实手法不扩展现有结构而是重新赋予已无用字段以新的共识含义。六、链上效果RPC 层如何暴露状态码EIP-658 的链上改动直接体现为 JSON-RPC 接口中的status字段。EIP-1474以太坊 JSON-RPC 规范对eth_getTransactionReceipt的返回值定义如下字段类型说明blockHashData包含该交易的区块哈希blockNumberQuantity包含该交易的区块号contractAddressData新合约地址未创建合约时为nullcumulativeGasUsedQuantity该交易及其之前所有交易累计消耗的 GasgasUsedQuantity该交易消耗的 GasstatusQuantity1表示交易成功0表示交易失败fromData交易发送方toData交易接收方部署合约时为nulltransactionHashData交易哈希transactionIndexQuantity交易在区块中的索引logsBloomData日志布隆过滤器logsArrayLog交易产生的日志列表实际调用示例对应 EIP-1474 中的规范用例# 请求 curl -X POST --data { id: 1337, jsonrpc: 2.0, method: eth_getTransactionReceipt, params: [0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238] } url # 响应 { id: 1337, jsonrpc: 2.0, result: { blockHash: 0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b, blockNumber: 0xb, contractAddress: 0xb60e8dd61c5d32be8058bb8eb970870f07233155, cumulativeGasUsed: 0x33bc, gasUsed: 0x4dc, logs: [], logsBloom: 0x00...0, status: 0x1, transactionHash: 0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238, transactionIndex: 0x1 } }注意响应中的status: 0x1——这正是 EIP-658 写入收据的状态码经 RPC 层原样透出的结果。对于应用层钱包、浏览器、索引器来说判断一笔交易是否成功只需读取该字段而不再依赖Gas 是否耗尽等间接推断。七、现代以太坊中的延续从 RLP 到 SSZEIP-658 的状态码语义不仅在 RLP 收据中存续至今还被新一代收据格式原样继承。以 EIP-6466 为例其在 SSZ 收据中定义了三类收据BasicReceipt、CreateReceipt、SetCodeReceipt每一类的字段列表里都包含status: boolean该提案的字段说明表进一步明确status字段即EIP-658 交易状态码并明确指出 SSZ 收据中不再包含logs_bloom、中间状态根Homestead 方案以及cumulative_gas_used等历史字段。这意味着 EIP-658 移除中间状态根的决定在以太坊收据格式的后续演进中得到了完整贯彻——新一代收据从设计起点就不存在这一字段。从更广的视角看EIP-658 为后续所有需要收据内判定成败的协议层应用如跨链桥、乐观/欺诈证明、索引服务、钱包 UX提供了最基本的共识事实交易成败是链上收据的一等公民字段任何客户端都可直接读取。八、延伸阅读EIP-140REVERT 指令——EIP-658 的前置依赖理解失败不再等于耗尽 Gas的关键EIP-1474以太坊 JSON-RPC 规范——eth_getTransactionReceipt等接口对status字段的标准化定义与示例EIP-6466收据的 SSZ 化——status字段在新收据格式中的延续以及中间状态根的彻底移除LICENSE.md——本仓库相关文档的版权声明CC0 公有领域贡献。本文基于仓库内 EIPS/eip-658.md 原文及其关联 EIP 整理撰写所有引用均来自当前仓库的提案文档未做超出原文与关联提案范围的推测。【免费下载链接】EIPsThe Ethereum Improvement Proposal repository项目地址: https://gitcode.com/GitHub_Trending/ei/EIPs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
EIP-658 解读以太坊如何在交易收据中嵌入执行状态码【免费下载链接】EIPsThe Ethereum Improvement Proposal repository项目地址: https://gitcode.com/GitHub_Trending/ei/EIPs导读EIP-658Embedding transaction status code in receipts交易收据内嵌执行状态码是以太坊 Metropolis 硬分叉中的一项核心协议改进它将交易收据receipt中已废弃的中间状态根字段替换为一个布尔状态码1 表示成功、0 表示失败让所有类型的节点都能在不重放交易的前提下直接判断一笔交易是否成功。本文以仓库中的 EIPS/eip-658.md 为主体结合 EIP-140REVERT 指令、EIP-1474JSON-RPC 规范 与 EIP-6466SSZ 收据 等关联提案完整还原该 EIP 的背景、规范细节、设计取舍与其在现代以太坊中的深远影响。读完本文你将掌握交易状态码的来龙去脉、收据字段的历史变迁以及如何通过 RPC 接口消费这一状态信息。一、提案基本信息项目内容EIP 编号658标题Embedding transaction status code in receipts作者Nick Johnsonnickethereum.org类型Standards Track类别Core状态Final创建时间2017-06-30依赖EIP-140EIP-658 属于影响共识的核心类Core提案已在以太坊主网生效并成为历史事实标准。它依赖 EIP-140因为正是 REVERT 指令的引入打破了交易失败 耗尽全部 Gas这一旧有假设才迫使收据格式做出相应调整。二、背景REVERT 指令如何打破旧的失败判定在 EIP-140 之前智能合约只能通过两种方式主动让一笔交易失败耗尽 Gas或执行一条非法指令。这两种方式的共同代价是消耗掉剩余的全部 Gas因此客户端可以据此推断只要交易没有耗尽所有 Gas它就算成功了。EIP-140 在block.number BYZANTIUM_FORK_BLKNUM的区块上引入了0xfd操作码REVERT它从栈顶取两个操作数memory_offset与memory_length语义与内存计价规则和RETURN完全一致执行REVERT会中止执行、回滚全部状态变更并可在 returndata 缓冲区中携带一段错误消息错误码或错误说明关键在于回滚本身不会消耗剩余的全部 Gas合约只需支付内存费用成本与RETURN相同若 Gas 不足或栈下溢则退化为普通的 out-of-gas 异常此时仍会耗尽全部 Gas。这意味着从拜占庭分叉开始交易失败与耗尽所有 Gas不再等价一笔交易完全可以在 Gas 充裕的情况下通过REVERT主动失败。调用者因此失去了判断交易成败的可靠信号——这正是 EIP-658 要解决的痛点。三、动机失败判定为何必须上链3.1 重放方案的局限性理论上全节点可以通过重放交易来获取返回状态与返回值但这只在特定节点形态下可行全节点Full node可以通过重放交易计算状态与返回值快速同步节点Fast node只能对其同步枢轴点pivot point之后的区块做这件事轻节点Light node根本无法重放交易。因此依赖重放的非共识层解决方案不具普适性——轻客户端和快速同步节点同样需要判断交易成败而这个信息必须由协议本身提供。3.2 收据中已有的空位交易收据receipt原本包含一个中间状态根intermediate state root字段用于记录交易执行后的状态树根。该字段早已被 EIP-98 废弃拜占庭分叉不再使用中间状态根只保留最终状态根但其在收据中的占位依然存在。EIP-658 的核心创意是把这块已被废弃、不再承担共识职责的字段替换为交易的成败状态码。这一改动一举两得让调用者可以确定性地获取交易成败状态顺带弥补了收据此前不含返回数据return data信息的缺憾。四、规范状态码替换中间状态根EIP-658 的规范只有一条改动面极小对于满足block.number BYZANTIUM_FORK_BLKNUM的区块收据中的中间状态根字段被替换为状态码0表示失败由任何导致交易或顶层调用回滚的操作引起1表示成功。这一规范直接写入了拜占庭硬分叉的共识规则。自此收据的 RLP 编码中不再包含中间状态根取而代之的是一个单字节布尔值0x01交易成功交易内的状态变更全部生效0x00交易失败状态变更全部回滚无论失败原因是 out-of-gas、非法指令、REVERT还是其他任何回滚操作。从后续提案的印证看这一替换是彻底的。例如 EIP-6466SSZ 化收据在描述收据字段时明确指出statusEIP-658 交易状态码见 EIP-658并且该提案在 SSZ 收据中不再保留中间状态根Homestead 方案字段——这正是 EIP-658 移除该字段的直接延续。五、设计取舍为什么这是最小可行改动EIP-658 的 Rationale 部分将自身定位为最小可能的改动它复用了收据中已经存在的、被 EIP-98 废弃的字段位没有新增任何收据字段或改变收据的编码结构本身它保持了既有能力状态码不破坏任何原有功能只是让查询交易成败从隐式推断变为显式字段它对 Metropolis拜占庭硬分叉几乎没有额外的实现工作量风险与中断面都降到了最低。这种用废弃字段换新语义的设计思路是协议演进中典型的务实手法不扩展现有结构而是重新赋予已无用字段以新的共识含义。六、链上效果RPC 层如何暴露状态码EIP-658 的链上改动直接体现为 JSON-RPC 接口中的status字段。EIP-1474以太坊 JSON-RPC 规范对eth_getTransactionReceipt的返回值定义如下字段类型说明blockHashData包含该交易的区块哈希blockNumberQuantity包含该交易的区块号contractAddressData新合约地址未创建合约时为nullcumulativeGasUsedQuantity该交易及其之前所有交易累计消耗的 GasgasUsedQuantity该交易消耗的 GasstatusQuantity1表示交易成功0表示交易失败fromData交易发送方toData交易接收方部署合约时为nulltransactionHashData交易哈希transactionIndexQuantity交易在区块中的索引logsBloomData日志布隆过滤器logsArrayLog交易产生的日志列表实际调用示例对应 EIP-1474 中的规范用例# 请求 curl -X POST --data { id: 1337, jsonrpc: 2.0, method: eth_getTransactionReceipt, params: [0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238] } url # 响应 { id: 1337, jsonrpc: 2.0, result: { blockHash: 0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b, blockNumber: 0xb, contractAddress: 0xb60e8dd61c5d32be8058bb8eb970870f07233155, cumulativeGasUsed: 0x33bc, gasUsed: 0x4dc, logs: [], logsBloom: 0x00...0, status: 0x1, transactionHash: 0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238, transactionIndex: 0x1 } }注意响应中的status: 0x1——这正是 EIP-658 写入收据的状态码经 RPC 层原样透出的结果。对于应用层钱包、浏览器、索引器来说判断一笔交易是否成功只需读取该字段而不再依赖Gas 是否耗尽等间接推断。七、现代以太坊中的延续从 RLP 到 SSZEIP-658 的状态码语义不仅在 RLP 收据中存续至今还被新一代收据格式原样继承。以 EIP-6466 为例其在 SSZ 收据中定义了三类收据BasicReceipt、CreateReceipt、SetCodeReceipt每一类的字段列表里都包含status: boolean该提案的字段说明表进一步明确status字段即EIP-658 交易状态码并明确指出 SSZ 收据中不再包含logs_bloom、中间状态根Homestead 方案以及cumulative_gas_used等历史字段。这意味着 EIP-658 移除中间状态根的决定在以太坊收据格式的后续演进中得到了完整贯彻——新一代收据从设计起点就不存在这一字段。从更广的视角看EIP-658 为后续所有需要收据内判定成败的协议层应用如跨链桥、乐观/欺诈证明、索引服务、钱包 UX提供了最基本的共识事实交易成败是链上收据的一等公民字段任何客户端都可直接读取。八、延伸阅读EIP-140REVERT 指令——EIP-658 的前置依赖理解失败不再等于耗尽 Gas的关键EIP-1474以太坊 JSON-RPC 规范——eth_getTransactionReceipt等接口对status字段的标准化定义与示例EIP-6466收据的 SSZ 化——status字段在新收据格式中的延续以及中间状态根的彻底移除LICENSE.md——本仓库相关文档的版权声明CC0 公有领域贡献。本文基于仓库内 EIPS/eip-658.md 原文及其关联 EIP 整理撰写所有引用均来自当前仓库的提案文档未做超出原文与关联提案范围的推测。【免费下载链接】EIPsThe Ethereum Improvement Proposal repository项目地址: https://gitcode.com/GitHub_Trending/ei/EIPs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
