post https://linea-mainnet.unifra.io/v1/
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
}
]
}
Responses