you_newFilter

描述:基于给定的选项创建一个过滤器对象,接收状态变化时的通知。要检查状态是否变化, 请调用 you_getFilterChanges

关于特定主题过滤器的说明:主题是顺序相关的。如果一个交易的日志有主题[A, B],那么将被 以下的主题过滤器匹配:

举例 描述
[] 任何主题
[A] 先匹配 A 主题
[null, B] 先匹配其他主题,再匹配 B 主题
[A, B] 先匹配 A 主题,再匹配 B 主题,最后匹配其他主题
[[A, B], [A, B]] 先匹配 A 主题或 B 主题,再匹配 A 主题或 B 主题,最后匹配其他主题

parameter

Object - 过滤器选项对象:

参数名 数据类型 备注
fromBlock String 可选,默认值:"latest"。整数块编号,或字符串"latesr"表示最后挖出的块,"pending"或"earliest"用于未挖出的交易。
toBlock String 可选,默认值:"latest"。整数块编号,或字符串"latesr"表示最后挖出的块,"pending"或"earliest"用于未挖出的交易。
address String, Array, 20 字节 可选,合约地址或生成日志的一组地址
topics Array of String - 可选,32 字节主题数组,每个主题可以是数组或使用或选项连接
"params": [
        {
            "fromBlock": "0x1",
            "toBlock": "0x200000",
            "address": "0xcF9F5007AA1A9ae7b8092DBE3E12B3B97fD5b18D"
        }
    ]

return

数据类型 备注
String 过滤器编号

example

Request:

curl -X POST \
  http://127.0.0.1:8283 \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "you_newFilter",
    "params": [
        {
            "fromBlock": "0x1",
            "toBlock": "0x200000",
            "address": "0xcF9F5007AA1A9ae7b8092DBE3E12B3B97fD5b18D"
        }
    ]
}'

Response:

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