更新时间:2024-03-06 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"]}'