更新时间:2023-10-16 GMT+08:00

eth_subscribe

简介

为特定事件创建新订阅。节点返回订阅 ID。对于与订阅匹配的每个事件,将发送包含相关数据的通知以及订阅 ID。该API所消耗的计算单元为10。

参数说明

参数

类型

说明

事件类型

String

指定要侦听的事件类型。

可选参数

String

要包含的可选参数,用于描述要侦听的事件类型,包括newHeads、newPendingTransactions、logs。

返回值

当订阅处于活动状态时,您将收到格式化为如下对象的事件:

事件对象:
  • jsonrpc:始终为“2.0”。
  • method:始终“eth_subscription”。
  • params:具有以下字段的对象:
    • subscription:创建此订阅的调用返回的订阅 ID。此 ID 将附加到所有收到的事件,也可用于使用eth_unsubscribe。
    • result:内容因事件类型而异的对象。

请求样式

wscat -c wss://your-http-endpoint/v1/<API-KEY> -x '{"jsonrpc":"2.0", "id": 1, "method": "eth_subscribe", "params": ["logs"]}'