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.

    • "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.

    • "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": [
    {
      "fromBlock": "earliest",
      "toBlock": "0x5",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ]
    }
  ],
  "id": 1
}'

Sample Response

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

Last updated