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 slot
  • stats: <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 milliseconds
  • type: <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
  }
}