本頁面使用機器翻譯自英語，可能包含錯誤或不清楚的語言。如需最準確的信息，請參閱英文原文。由於更新頻繁，部分內容可能與英文原文有出入。請加入我們在 Crowdin 上的努力，幫助我們改進本頁面的翻譯。 (Crowdin translation page, Contributing guide)

[Filter] 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.
• To obtain all logs matching the filter created by eth_newFilter, call eth_getFilterLogs.

A note on specifying topic filters: 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)"

NOTE: In versions earlier than Kaia v1.7.0, only integer block number, the string "earliest" and "latest" are available.

JSONRPC: eth_newFilter

Request

application/json

Body

params

object[]

required

Array [

fromBlock

object

(optional, default: "latest") Integer or hexadecimal block number, or the string "earliest", "latest" or "pending" as in the default block parameter.

oneOf

IntegerBlockNumber

the block number with type integer

number

HexadecimalBlockNumber

the block number with type hexadecimal

string

BlockTag

the block tag [latest, pending, earliest]

string

toBlock

object

(optional, default: "latest") Integer or hexadecimal block number, or the string "earliest", "latest" or "pending" as in the default block parameter.

oneOf

IntegerBlockNumber

the block number with type integer

number

HexadecimalBlockNumber

the block number with type hexadecimal

string

BlockTag

the block tag [latest, pending, earliest]

string

address

object

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

oneOf

MOD1

Array [

anyOf

Address

Address

string

]

Address

Address

string

topics 32-byte DATA[]

(optional) Array of 32-byte DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.

]

Responses

200

Returns a filter id

application/json

Schema

Schema

error

object

code int64required

A Number that indicates the error type that occurred. This MUST be an integer.

code	message	description
-32700	Parse error	invalid JSON was received by the server. An error occurred on the server while parsing the JSON text.
-32602	Invalid params	Invalid method parameter(s).

message string

A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.

data string

A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).

result hex

A filter id

Example (from schema)

{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
    "code": -32700,
    "message": "Parse error",
    "data": "string"
  },
  "result": "0xd32fd16b6906e67f6e2b65dcf48fc272"
}

• curl
• python
• nodejs
• java

• Curl

curl -X 'POST' \
  'https://public-en-kairos.node.kaia.io' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "eth_newFilter",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    {
      "fromBlock":"earliest",
      "toBlock":"latest",
      "address":"0x87ac99835e67168d4f9a40580f8f5c33550ba88b",
      "topics":[
        "0xd596fdad182d29130ce218f4c1590c4b5ede105bee36690727baa6592bd2bfc8"
      ]
    }
  ]
}'

• CURL

curl -L 'https://public-en-kairos.node.kaia.io/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "method": "eth_newFilter",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    {
      "fromBlock": "earliest",
      "toBlock": "latest",
      "address": "0x87ac99835e67168d4f9a40580f8f5c33550ba88b",
      "topics": [
        "0xd596fdad182d29130ce218f4c1590c4b5ede105bee36690727baa6592bd2bfc8"
      ]
    }
  ]
}'

Request Collapse all

Base URL

https://public-en-kairos.node.kaia.io

Body

{
  "method": "eth_newFilter",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    {
      "fromBlock": "earliest",
      "toBlock": "latest",
      "address": "0x87ac99835e67168d4f9a40580f8f5c33550ba88b",
      "topics": [
        "0xd596fdad182d29130ce218f4c1590c4b5ede105bee36690727baa6592bd2bfc8"
      ]
    }
  ]
}

ResponseClear

Click the Send API Request button above and see the response here!