文档首页/ Web3节点引擎服务 NES/ 开发指南/ Polygon PoS/ Polygon PoS API列表/ 共享版/ Ethereum JSON-RPC API/ eth_subscribe
更新时间：2024-03-06 GMT+08:00
查看PDF
分享

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"]}'
父主题： Ethereum JSON-RPC API