在以太坊区块链的庞大生态中，每一笔交易的发生都伴随着一系列复杂的过程，对于用户和开发者而言，了解交易的状态——尤其是确认其是否成功执行并产生了预期效果——至关重要，以太坊收据（Receipt）正是这一关键信息的载体，它不仅仅是一张“交易成功”的回执，更是一个蕴含了丰富状态变更和执行结果的数据结构，深入理解以太坊收据，对于调试DApp、追踪资金流向以及进行区块链数据分析都具有重要意义。
以太坊收据是什么？
以太坊收据是交易被矿工（或验证者）打包进区块并执行后，由以太坊客户端生成的一条记录，它代表了该笔交易在区块中的执行结果，并被永久存储在区块链的某个特定状态中（具体位置与交易哈希相关），每笔成功执行（即使是因gas耗尽而失败，只要被包含在区块中）的交易都会产生一个唯一的收据。
收据的核心构成：解码交易执行的“指纹”
一个典型的以太坊收据包含以下几个关键字段,共同勾勒出交易执行的完整图景：
-
status（状态）：这是最直观的信息之一，它是一个布尔值或状态码（在EIP-658后改为单字节状态码）。
1或true：表示交易执行成功。0或false：表示交易执行失败（通常是合约执行过程中出现异常或gas耗尽）。
-
cumulativeGasUsed（累计gas使用量）：表示从该区块开始到当前交易执行完毕为止，所有已执行交易消耗的gas总量,这对于计算交易在区块中的相对位置和实际gas成本很有帮助。
-
logsBloom（布隆过滤器日志）：这是一个布隆过滤器数据结构，高效地编码了该交易产生的所有日志（Logs）中涉及的地址和主题，虽然它不能直接用于查询特定日志，但作为轻量级索引，使得轻客户端可以快速判断某个地址或主题是否与该笔交易相关,极大地提高了日志查询效率。
-
logs（日志列表）：这是收据中信息量最丰富的部分，尤其对于合约交互而言，当合约执行过程中触发
Log操作码时，就会生成日志条目,每个日志包含：- address：生成日志的合约地址。
- topics：一个32字节哈希的数组，用于日志的索引和分类（通常对应事件签名的哈希）。
- data：任意长度的字节数组,包含日志的具体内容。
- logIndex：该日志在所在区块所有日志中的索引。
- transactionIndex：产生该日志的交易在所在区块中的索引。
- transactionHash：产生该日志的交易哈希。
- blockHash：该日志所在区块的哈希。
- blockNumber：该日志所在区块的编号。 日志是以太坊事件驱动架构的核心,使得外部应用能够监听合约的状态变化。
-
transactionHash（交易哈希）：生成该收据的交易的唯一标识符。
-
contractAddress（合约地址）：仅当交易类型为合约创建（CREATE）时存在，它表示新创建的合约地址，对于其他类型的交易，此字段为
null。 -
gasUsed（实际消耗的gas）：该笔交易自身执行所消耗的gas总量，等于
cumulativeGasUsed减去前一笔交易的cumulativeGasUsed。
收据的重要性与应用场景
以太坊收据之所以重要，是因为它提供了交易执行后的“确定性”证据,其应用场景广泛：
-
交易状态确认：用户可以通过查询收据来确认自己的交易是否已被网络确认、执行成功还是失败,以及实际消耗了多少gas。
-
DApp调试与监控：对于开发者而言，收据中的日志是调试智能合约、追踪合约执行流程、排查错误的宝贵数据，通过解析日志,可以了解合约内部的状态变化和事件触发情况。
-
区块链数据分析与索引：大量区块链浏览器（如Etherscan）、数据分析平台和DeFi协议都依赖收据中的日志来构建索引、提供查询服务，追踪代币转账（ERC-20的Transfer事件）、NFT所有权变更（ERC-721的Transfer事件）等,都是通过解析相关交易的收据日志实现的。
-
事件驱动应用：许多去中心化应用和链下服务通过订阅以太坊新区块中的收据日志，来触发相应的业务逻辑，例如自动更新数据库、发送通知、执行清算等。
-
合约部署验证：部署合约后，通过收据中的
contractAddress可以确认新合约的准确地址,这对于后续与合约交互至关重要。
收据的获取与查询
开发者可以通过以太坊节点的API（如JSON-RPC）来获取收据信息,常用的方法包括：
eth_getTransactionReceipt(transactionHash)：通过交易哈希查询该笔交易的收据。- 遍历区块中的交易,并为每笔交易调用上述方法获取收据。
- 通过事件日志的索引服务间接获取相关收据信息。
收据与交易日志的关系
需要注意的是，收据（Receipt）和交易日志（Log）是两个相关但不同的概念，收据是交易执行结果的“容器”，包含了交易级别的状态信息（如status, gasUsed）以及该交易产生的所有日志的汇总信息（通过logsBloom和logs字段），而日志（Log）则是合约执行过程中产生的事件记录，本身是收据的一个重要组成部分,一个收据可以包含零个或多个日志。
以太坊收绝远非一张简单的交易回执，它是以太坊虚拟机执行交易后产出的结构化数据报告，承载了交易的执行状态、资源消耗以及丰富的状态变更信息（通过日志），对于任何希望深入理解以太坊工作机制、开发复杂DApp或进行区块链数据分析的用户和开发者来说，掌握以太坊收据的结构、意义和查询方法，都是不可或缺的一环，它就像每笔交易在以太坊这个“世界计算机”上留下的详细“执行报告”,为我们洞察区块链的内部运作提供了关键的窗口。