getLogs

Get blockchain logs matching the given filters

Efficiently access the blockchain logs that match your specified filters by using getLogs builder api method. getLogs serves as an access point to blockchain logs empowering developers with a valuable method for monitoring and analyzing events that may occur. This method offers a streamlined approach to access essential log details, including topics and data, making it indispensable for building decentralized applications (dApps) that interact with smart contracts

How to use getBlockReceipts method ?

Below, you'll find an in-depth guide that provides a comprehensive explanation of how to utilize the getLogs Builder API method effectively using Blast.

Any combination of filters is accepted provided that:

• if blockHash is present then neither fromBlock nor toBlock are allowed

• if contractAddress is not present then the specified range of blocks cannot be greater than 2000 blocks; otherwise any block range is allowed

Parameters

Below, you can find the query parameters accepted by the method.

Field	Type	Description
fromBlock	string	Starting block for logs retrieval (default latest)
toBlock	string	Ending block for logs retrieval (default latest)
blockHash	string	Block hash for retrieving all logs within a single block (equivalent to fromBlock = toBlock)
contractAddress	string	The address of the log events sender contract
topic0	string	Topic hash to retrieve logs with
topic1	string	Topic hash to retrieve logs with
topic2	string	Topic hash to retrieve logs with
topic3	string	Topic hash to retrieve logs with
pageSize	integer	Number of records to be retrieved on one page
pageKey	string	Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response

Returns

Discover an insightful explanation of the returned parameters here, offering a deep understanding of their significance and implications.

Returns array of Log objects.

This API is paginated, response items are ordered by:

• blockNumber

• logIndex

Field	Type	Description
count	integer	The number of the logs returned
nextPageKey	string	Key to get the next page of results, if more results are available
logs	array	The array of Log objects
blockHash	string	The hash of the block containing the logs
blockNumber	integer	The height of the block containing the logs
blockTimestamp	string	The timestamp of the block containing the logs
transactionHash	string	Log transaction hash
transactionIndex	integer	Log transaction number
contractAddress	string	The address of the contract generating the log
topic0	string	Topic to describe the log event, usually the first topic is the signature of the event name
topic1	string	Topic to describe the log event
topic2	string	Topic to describe the log event
topic3	string	Topic to describe the log event
data	string	Additional data of the log event

Example Request and Result for getLogs

In this section, we provide an illustrative example of a request made to blockchain logs matching the given filters using the getLogs Builder API method. Additionally, we present the resulting response containing all the information about the returned blocks. Developers can use this as a reference for crafting their own requests and parsing the returned data when working with the getLogs 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!

curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getLogs?blockHash=0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2'

Result

{
    "count": 198,
    "logs": [
        {
            "blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
            "blockNumber": 18375873,
            "blockTimestamp": "2023-10-18T07:51:59.000Z",
            "transactionHash": "0x2c40ee001352cfb73a2047c0ec71f016a1bd02e7fa2ed35adeaee46ca0c7719e",
            "transactionIndex": 0,
            "logIndex": 0,
            "contractAddress": "0xf482d79ae6e8725c199213fc909d6bc30df62815",
            "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "topic1": "0x000000000000000000000000e65f60ae20998b6cb2d2a6edb2e551843e7bb816",
            "topic2": "0x000000000000000000000000c99d5ae8a7c36325294c2424928bd776ab63f8b7",
            "data": "0x000000000000000000000000000000000000000000000000007e5196c1911e00"
        },
        {
            "blockHash": "0x248aac16904eb52e25ff4a594acbea314a216d5fc0968facb0c10366503aaab2",
            "blockNumber": 18375873,
            "blockTimestamp": "2023-10-18T07:51:59.000Z",
            "transactionHash": "0x9befb89d0180358d300180c24530d9a16382ef770ec3eddab641e878d71d64e6",
            "transactionIndex": 1,
            "logIndex": 1,
            "contractAddress": "0x9b1f3625980e6acb153da8b06235923845ecca01",
            "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "topic1": "0x000000000000000000000000e29a909a294896c167adc29a05681ff987a1d145",
            "topic2": "0x000000000000000000000000ca53029a981a807c78c7cde496c5b52ef4532445",
            "data": "0x00000000000000000000000000000000000000000000000000000003866a1100"
        },
```