The eth_getBlockReceipts method fetches transaction receipts from within a block. It seamlessly accepts either the block height or block hash as a parameter, providing flexibility in accessing the desired data.
How to use getBlockReceipts method ?
Below, you'll find an in-depth guide that provides a comprehensive explanation of how to utilize the getBlockReceipts Builder API method effectively using Blast.
Parameters
Below, you can find the query parameters accepted by the method.
Returns
Discover an insightful explanation of the returned parameters here, offering a deep understanding of their significance and implications.
Example Request and Result for getBlockReceipts
In this section, we provide an illustrative example of a request made to retrieve the receipts for all transactions in a block contents using the getBlockReceipts Builder API method. Additionally, we present the resulting response containing information about the specified receipts. Developers can use this as a reference for crafting their own requests and parsing the returned data when working with the getBlockReceipts method.
The example in this section uses a non-existing project id.
Make sure you replace it with your Starknet endpoint when issuing the Builder API calls.
Don't have a project id? Here's a straightforward guide on how to obtain one!
Returns the receipt objects, ordered by transactionIndex.
This parameter is essential and must be provided. Depending on the value you specify, whether it's the block height or block hash, it will initiate the retrieval of the receipt objects, ordered by transactionIndex.
blockHash
string
The hash of the block
blockNumber
integer
The height of the block
blockTimestamp
string
The timestamp of the block
transactionCount
integer
The number of transactions for which receipts were returned
receipts
array
The array of Receipts objects
transactionHash
string
The hash of the transaction
transactionIndex
integer
The index of the transaction
from
string
The address of the sender
to
string
The address of the receiver. Null when it's a contract creation transaction
contractAddress
string
The contract address created, if the transaction was a contract creation, otherwise null
cumulativeGasUsed
string
The sum of gas used by this transaction and all preceding transactions in the same block
effectiveGasPrice
string
Price paid for each unit of gas used in this transaction, denoted in wei
gasUsed
string
The amount of gas used in this transaction
gasUsedForL1
string
Arbitrum The amount of gas used on L1 in units of L2 gas
l1BlockNumber
string
Arbitrum The L1 block number that would be used for block.number calls
l1Fee
string
Arbitrum, Base, Optimism Fee paid on L1 to post the transaction, denoted in wei
l1FeeScalar
string
Base, Optimism L1 fee scalar
l1GasPrice
string
Base, Optimism Price paid for each unit of L1 gas, denoted in wei
l1GasUsed
string
Base, Optimism The amount of gas used on L1
cumulativeGasUsed
string
The total amount of gas used when this transaction was executed in the block
effectiveGasPrice
string
The amount of gas used by this specific transaction alone
gasUsed
string
The amount of gas used by this specific transaction alone
logsBloom
string
Bloom filter for light clients to quickly retrieve related logs
logs
array
Array of Log objects
address
string
Contract address from which logs should originate
topics
array
Topic to describe the log event
data
string
Additional data of the log event
blockNumber
integer
The block height where the log event occurred
transactionHash
string
The hash of the transaction
transactionIndex
integer
The index of the transaction
blockHash
string
The hash of the block where the log event occurred
logIndex
integer
The index of the log
removed
boolean
true when the log was removed, due to a chain reorganization. false if it's a valid log