API Reference

eth_getLogs - Linea

Returns an array of all logs matching a given filter object. For more information about eth_getLogs check out our Deep Dive into eth_getLogs page.

Parameters

Object - The filter options:

  • fromBlock: QUANTITY|TAG - (optional, default: "latest") Value:
    • Integer block number
    • "latest" for the last mined block
    • "pending", "earliest" for not yet mined transactions.
  • toBlock: QUANTITY|TAG - (optional, default: "latest") Value:
    • Integer block number
    • "latest" for the last mined block
    • "pending", "earliest" for not yet mined transactions.
  • address: DATA|Array, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
  • topics: Array of DATA, - (optional) Array of 32 Bytes DATA topics.
    • Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
    • Check out more details on how to format topics in eth_newFilter.
  • blockHash: DATA, 32 Bytes - (optional) With the addition of EIP-234 (Geth >= v1.8.13 or Parity >= v2.1.0), blockHash is a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.
curl --location 'https://linea-mainnet.unifra.io/v1/{your-api-key}' \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc": "2.0", "method": "eth_getLogs", "params": [ { "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef" ], "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114" } ], "id": 0 }'

Returns

Array - Array of log objects, or an empty array if nothing has changed since last poll.

  • For filters created with eth_newBlockFilter the return are block hashes (DATA, 32 Bytes), e.g. ["0x3454645634534..."].
  • For filters created with eth_newPendingTransactionFilter the return are transaction hashes (DATA, 32 Bytes), e.g. ["0x6345343454645..."].
  • For filters created with eth_newFilter logs are objects with following params:
    • removed: TAG - True when the log was removed, due to a chain reorganization. False if its a valid log.
    • logIndex: QUANTITY - Integer of the log index position in the block. Null when its pending log.
    • transactionIndex: QUANTITY - Integer of the transactions index position log was created from. Null when its pending log.
    • transactionHash: DATA, 32 Bytes - Hash of the transactions this log was created from. Null when its pending log.
    • blockHash: DATA, 32 Bytes - Hash of the block where this log was in. Null when its pending. Null when its pending log.
    • blockNumber: QUANTITY - The block number where this log was in. Null when its pending. Null when its pending log.
    • address: DATA, 20 Bytes - Address from which this log originated.
    • data: DATA - Contains one or more 32 Bytes non-indexed arguments of the log.
    • topics: Array of DATA - Array of 0 to 4 32 Bytes DATA of indexed log arguments.
      • In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declare the event with the anonymous specifier.

Example

Request

curl --location 'https://linea-mainnet.unifra.io/v1/{your-api-key}' \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc": "2.0", "method": "eth_getLogs", "params": [ { "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef" ], "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114" } ], "id": 0 }'

Result

{ "jsonrpc": "2.0", "id": 0, "result": [ { "address": "0x808d7c71ad2ba3fa531b068a2417c63106bc0949", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000008a12cf9a984f749231f52c8715b53c5dfa0e13ee", "0x0000000000000000000000000000000000000000000000000000000000000000" ], "data": "0x00000000000000000000000000000000000000000000000000470de4df820000", "blockNumber": "0x47ff0", "transactionHash": "0x8b4b28aa23f7aec87df554c9df765e62c372dd4aea392563b944213eed99ee75", "transactionIndex": "0x9", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x20", "removed": false }, { "address": "0x224d8fd7ab6ad4c6eb4611ce56ef35dec2277f03", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000008731d54e9d02c286767d56ac03e8037c07e01e98", "0x000000000000000000000000aad094f6a75a14417d39f04e690fc216f080a41a" ], "data": "0x00000000000000000000000000000000000000000000000000005af3107a4000", "blockNumber": "0x47ff0", "transactionHash": "0x43bce2bdbe802790560546ca8293e8b654cc9e54a1cbb56824805af9bcf635c6", "transactionIndex": "0xa", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x29", "removed": false }, { "address": "0x808d7c71ad2ba3fa531b068a2417c63106bc0949", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000004e7b88f726464944a7524f75a2ca515f9265b3bc", "0x0000000000000000000000000000000000000000000000000000000000000000" ], "data": "0x000000000000000000000000000000000000000000000574c0de7d25cfd3a000", "blockNumber": "0x47ff0", "transactionHash": "0xe9ef4a28b836769bc7aa07d9a71cd71354438f427328d3e18fc7d38d12fc7e3d", "transactionIndex": "0xb", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x30", "removed": false }, { "address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000d5539d0360438a66661148c633a9f0965e482845", "0x000000000000000000000000678aa4bf4e210cf2166753e054d5b7c31cc7fa86" ], "data": "0x000000000000000000000000000000000000000000000000006647eabf63fcf8", "blockNumber": "0x47ff0", "transactionHash": "0xcd36deeb8d87d49878c67752d202f831a3b1d35a0c1beb81385f6625d4b86bfa", "transactionIndex": "0xe", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x37", "removed": false }, { "address": "0x176211869ca2b568f2a7d4ee941e073a821ee1ff", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000099c21c6083c4738b9e1976429455fce80a578729", "0x000000000000000000000000d5539d0360438a66661148c633a9f0965e482845" ], "data": "0x0000000000000000000000000000000000000000000000000000000002d5ccd3", "blockNumber": "0x47ff0", "transactionHash": "0xcd36deeb8d87d49878c67752d202f831a3b1d35a0c1beb81385f6625d4b86bfa", "transactionIndex": "0xe", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x38", "removed": false }, { "address": "0xe5d7c2a44ffddf6b295a15c148167daaaf5cf34f", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000e8190c17f5071b98e3d3ab1d6a8e711884e10d22", "0x000000000000000000000000272e156df8da513c69cb41cc7a99185d53f926bb" ], "data": "0x000000000000000000000000000000000000000000000000000fc35acbd945c5", "blockNumber": "0x47ff0", "transactionHash": "0x2edfd7f88f41d6c106545abf2c049ba253a9231d8e7cb6b5009351efb457b2fb", "transactionIndex": "0x10", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x3c", "removed": false }, { "address": "0x176211869ca2b568f2a7d4ee941e073a821ee1ff", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000d6c994cfc3d38343baf152a25f9ce13580e7e564", "0x000000000000000000000000e8190c17f5071b98e3d3ab1d6a8e711884e10d22" ], "data": "0x00000000000000000000000000000000000000000000000000000000006fcab5", "blockNumber": "0x47ff0", "transactionHash": "0x2edfd7f88f41d6c106545abf2c049ba253a9231d8e7cb6b5009351efb457b2fb", "transactionIndex": "0x10", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x3d", "removed": false }, { "address": "0x5f45cd59ba7f2f6bcd935663f68ee1debe3b8a10", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000005d1f1a39b270852b80a4c09f5aa0b28bd8bf77ff" ], "data": "0x0000000000000000000000000000000000000000000000015af1d78b58c40000", "blockNumber": "0x47ff0", "transactionHash": "0xac64a7fcf20651c861b9dfd68341f07e6344f253b8721a722e9e5e9efa402b1d", "transactionIndex": "0x11", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x40", "removed": false }, { "address": "0x176211869ca2b568f2a7d4ee941e073a821ee1ff", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000009c7c14e61a2b3ce924ac27e6b110c46f255f536", "0x000000000000000000000000bc7f67fa9c72f9fccf917cbcee2a50deb031462a" ], "data": "0x00000000000000000000000000000000000000000000000000000000002dc6c0", "blockNumber": "0x47ff0", "transactionHash": "0x4b6b7fe776a8759e7b1ff4e348d635765bd16a8ab4f39bc7369ade5d3ffe501c", "transactionIndex": "0x12", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x41", "removed": false }, { "address": "0xa219439258ca9da29e9cc4ce5596924745e12b93", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000bc7f67fa9c72f9fccf917cbcee2a50deb031462a", "0x00000000000000000000000009c7c14e61a2b3ce924ac27e6b110c46f255f536" ], "data": "0x00000000000000000000000000000000000000000000000000000000002dcb12", "blockNumber": "0x47ff0", "transactionHash": "0x4b6b7fe776a8759e7b1ff4e348d635765bd16a8ab4f39bc7369ade5d3ffe501c", "transactionIndex": "0x12", "blockHash": "0x375de30db8192560e57ed5c6de13e263f6fb98e725bcc008185ee73c07a9a114", "logIndex": "0x42", "removed": false } ] }
Path Params
string
required
Defaults to demo
Body Params
string
Defaults to 2.0
string
Defaults to eth_getLogs
array
params
int32
Defaults to 0
Responses

Language
Click Try It! to start a request and see the response here! Or choose an example:
application/json