eth_newFilter

Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges or eth_getFilterLogs.

Parameters

Object - filter options:

1. fromBlock: Quantity or tag (optional, default is "latest" if not specified)

   - choose 1 of the following options:

   • A hexadecimal block number.

   • "earliest" - the earliest/genesis block.

   • "latest" - the latest mined block.

   • "safe" - the latest safe head block.

   • "finalized" - the latest finalized block.

   • "pending" - the pending state/transactions.

2. toBlock: Quantity or tag (optional, default is "latest" if not specified)

   - choose 1 of the following options:

   • A hexadecimal block number.

   • "latest" - the latest mined block.

   • "safe" - the latest safe head block.

   • "finalized" - the latest finalized block.

   • "pending" - the pending state/transactions.

3. address: (optional) Contract address or a list of addresses from which logs should originate.

4. topics: (optional) Array of Data topics. Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:

   • [] "anything"

   • [A] "A in first position (and anything after)"

   • [null, B] "anything in first position AND B in second position (and anything after)"

   • [A, B] "A in first position AND B in second position (and anything after)"

   • [[A, B], [A, B]] "(A OR B) in first position AND (A OR B) in second position (and anything after)"

Sample Request

curl https://lb.nodies.app/v1/<INSERT URL> \
   -H "x-api-key: <API-KEY>" \
   -X POST \
   -H "Content-Type: application/json" \
   -d '{ 
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ]
    }
  ],
  "id": 1
}'

Sample Response

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