eth_newFilter

Creates a filter object, based on filter options, to notify when the state changes (logs).

📘

Supported on Arbitrum One (Nitro) only.

Parameters

  • object - Should contain filter information, all keys are optional:
    • fromBlock - (Optional) Integer block number encoded as a hexadecimal, "latest","pending", or "earliest" tags.
    • toBlock - (Optional) Integer block number encoded as a hexadecimal, "latest","pending", or "earliest" tags.
    • address - (Optional) Contract address or a list of addresses from which logs should originate.
    • topics - (Optional) Array of DATA topics. Topics are order-dependent.

Returns

  • result - A filter id - to be used when calling eth_getFilterChanges.

API Endpoint

The format of an Arbitrum Nova API endpoint is
https://open-platform.nodereal.io/{{apiKey}}/arbitrum-nitro/

Here is an example:
https://open-platform.nodereal.io/4c0a1c23661a4e26bcbcwed461e34ea9/arbitrum-nitro/

Example

Request

curl https://open-platform.nodereal.io/{{apiKey}}/arbitrum-nitro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "0xe20360", "toBlock": "0xe20411", "address": "0x6b175474e89094c44da98b954eedeac495271d0f","topics": []}],"id":1}'

Result

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0xdf42b03fee28d2dd5bdd051a4df9eaef"
}