slotsUpdatesSubscribe RPC Method
Subscribe to receive a notification from the validator on a variety of updates on every slot
Caution
This subscription is unstable. The format of this subscription may change in the future, and may not always be supported.
Parameters #
None
Result #
<integer>
- Subscription id (needed to unsubscribe)
Code sample #
{ "jsonrpc": "2.0", "id": 1, "method": "slotsUpdatesSubscribe" }
Response #
{ "jsonrpc": "2.0", "result": 0, "id": 1 }
Notification Format #
The notification will be an object with the following fields:
err: <string|undefined>
- The error message. Only present if the update is of type "dead".parent: <u64|undefined>
- The parent slot. Only present if the update is of type "createdBank".slot: <u64>
- The newly updated slotstats: <object|undefined>
- The error message. Only present if the update is of type "frozen". An object with the following fields:maxTransactionsPerEntry: <u64>
,numFailedTransactions: <u64>
,numSuccessfulTransactions: <u64>
,numTransactionEntries: <u64>
,
timestamp: <i64>
- The Unix timestamp of the update in millisecondstype: <string>
- The update type, one of:- "firstShredReceived"
- "completed"
- "createdBank"
- "frozen"
- "dead"
- "optimisticConfirmation"
- "root"
{
"jsonrpc": "2.0",
"method": "slotsUpdatesNotification",
"params": {
"result": {
"parent": 75,
"slot": 76,
"timestamp": 1625081266243,
"type": "optimisticConfirmation"
},
"subscription": 0
}
}