eth_getFilterLogs

🚧

Limits:

The filter expires if it remains inactive (no queries) for 5 minutes.
This method is only used to get logs for filters that are created using eth_newFilter.

Request Parameters

• FILTER ID: a hexadecimal string.

Response

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

Result Fields

• LOG OBJECT ARRAY: an array of log objects, or an empty array if nothing has changed since the last poll.
  Parameters of log objects:
  • removed: returns true when the log was removed due to a chain reorganization. The value is false for a valid log.
  • logIndex: the hexadecimal position of the log index in the block. For a pending log, null is returned.
  • transactionIndex: the hexadecimal number of the transaction index position where the log was created. For a pending log, null is returned.
  • transactionHash: the 32-byte hash of the transaction from which the log was created. For a pending log, null is returned.
  • blockHash: the 32-byte hash of the block where the log is located. For a pending log, null is returned.
  • blockNumber: the number of the block where the log is located. For a pending log, null is returned.
  • address: the 20-byte address from which the log originated.
  • data: contains non-indexed parameters of the log.
  • topics: an array of zero to four 32-byte DATA of indexed log arguments. (In Solidity, the first topic is the hash of the event signature, such as Deposit(address, bytes32, uint256), unless you have declared the event with the anonymous specifier.)

Examples

Example Responses

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [{
    "address": "0xb5a5f22694352c15b00323844ad545abb2b11028",
    "blockHash": "0x99e8663c7b6d8bba3c7627a17d774238eae3e793dee30008debb2699666657de",
    "blockNumber": "0x5d12ab",
    "data": "0x0000000000000000000000000000000000000000000000a247d7a2955b61d000",
    "logIndex": "0x0",
    "removed": false,
    "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000bdc0afe57b8e9468aa95396da2ab2063e595f37e", "0x0000000000000000000000007503e090dc2b64a88f034fb45e247cbd82b8741e"],
    "transactionHash": "0xa74c2432c9cf7dbb875a385a2411fd8f13ca9ec12216864b1a1ead3c99de99cd",
    "transactionIndex": "0x3"
  }, {
    "address": "0xe38165c9f6deb144afc9c32c206b024817e1496d",
    "blockHash": "0x99e8663c7b6d8bba3c7627a17d774238eae3e793dee30008debb2699666657de",
    "blockNumber": "0x5d12ab",
    "data": "0x0000000000000000000000000000000000000000000000000000000025c6b720",
    "logIndex": "0x3",
    "removed": false,
    "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000080e73e47173b2d00b531bf83bc39e710157125c3", "0x0000000000000000000000008f6cc93795969e5bbbf07c66dfee7d41ad24f1ef"],
    "transactionHash": "0x9e8f1cb1facb9a11a1cf947634053a0b2d557399f926b12127aa10497a2f0153",
    "transactionIndex": "0x5"
  }]
}