Skip to main content

eth_getFilterChanges

Method​

  • JSON-RPC method name: eth_getFilterChanges
  • JSON-RPC version: 2.0

Parameters​

NameTypeRequiredDescription
Filter identifierstringno

Parameter schema​

{
  "Filter identifier": {
    "required": false,
    "schema": {
      "title": "hex encoded unsigned integer",
      "type": "string",
      "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$"
    }
  }
}

Result​

  • Name: Log objects
  • Type: oneOf

Result schema​

{
  "title": "Filter results",
  "oneOf": [
    {
      "title": "new block or transaction hashes",
      "type": "array",
      "items": {
        "title": "32 byte hex value",
        "type": "string",
        "pattern": "^0x[0-9a-f]{64}$"
      }
    },
    {
      "title": "new logs",
      "type": "array",
      "items": {
        "title": "log",
        "type": "object",
        "required": [
          "transactionHash"
        ],
        "additionalProperties": false,
        "properties": {
          "removed": {
            "title": "removed",
            "type": "boolean"
          },
          "logIndex": {
            "title": "log index",
            "type": "string",
            "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$"
          },
          "transactionIndex": {
            "title": "transaction index",
            "type": "string",
            "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$"
          },
          "transactionHash": {
            "title": "transaction hash",
            "type": "string",
            "pattern": "^0x[0-9a-f]{64}$"
          },
          "blockHash": {
            "title": "block hash",
            "type": "string",
            "pattern": "^0x[0-9a-f]{64}$"
          },
          "blockNumber": {
            "title": "block number",
            "type": "string",
            "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$"
          },
          "address": {
            "title": "address",
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{40}$"
          },
          "data": {
            "title": "data",
            "type": "string",
            "pattern": "^0x[0-9a-f]*$"
          },
          "topics": {
            "title": "topics",
            "type": "array",
            "items": {
              "title": "32 hex encoded bytes",
              "type": "string",
              "pattern": "^0x[0-9a-f]{64}$"
            }
          }
        }
      }
    }
  ]
}

Positional parameters​

Parameter order:

  1. Filter identifier

Errors​

This method may return JSON-RPC standard errors (e.g. -32600, -32601, -32602, -32603) as well as application-specific errors.

TODO: Document method-specific error codes and conditions.

Named Parameters
{
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": {
    "Filter identifier": "string"
  },
  "id": 1
}
Successful Response
{
  "jsonrpc": "2.0",
  "result": "example",
  "id": 1
}
Positional Parameters
{
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": [
    "string"
  ],
  "id": 2
}
Successful Response
{
  "jsonrpc": "2.0",
  "result": "example",
  "id": 2
}