eth_getFilterChanges

Polling method for a filter, which returns an array of events that have occurred since the last poll.

📘

Supported on Polygon zkEVM (mainnet) only.

Parameters

  • filter ID - string - The filter id that is returned from eth_newFilter, eth_newBlockFilter or eth_newPendingTransactionFilter

Returns

  • array- An array of one of the following, depending on the filter type, or empty if there were no changes since the last poll:
    • eth_newBlockFilter:
      • blockHash- The 32 byte hash of a block that meets your filter requirements
    • eth_newPendingTransactionFilter:
      • transactionHash- The 32 byte hash of a transaction that meets your filter requirements
    • eth_newFilter:
      • address- An address from which this log originated
      • topics- An array of zero to four 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
      • data- It contains one or more 32 Bytes non-indexed arguments of the log
      • blockNumber- The block number where this log was in. null when its a pending log
      • transactionHash- The hash of the transactions this log was created from. null when its a pending log
      • transactionIndex- The integer of the transaction's index position that the log was created from. null when it's a pending log
      • blockHash- The hash of the block where this log was in. null when its a pending log
      • logIndex- The integer of the log index position in the block. null when it's a pending log
      • removed- It is true when the log was removed due to a chain reorganization, and false if it's a valid log

API Endpoint

The format of a polygon-zkevm-rpc API endpoint is
https://open-platform.nodereal.io/{{apiKey}}/polygon-zkevm-rpc/

Here is an example:
https://open-platform.nodereal.io/4c0a1c23661a4e26bcbcwed461e34ea9/polygon-zkevm-rpc/

Example

Request

curl https://open-platform.nodereal.io/{{apiKey}}/polygon-zkevm-rpc/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getFilterChanges","params":["YOUR_FILTER_ID"],"id":1,"jsonrpc":"2.0"}'

Result