Skip to main content

voteSubscribe RPC Method

Subscribe to receive notification anytime a new vote is observed in gossip. These votes are pre-consensus therefore there is no guarantee these votes will enter the ledger.

Unstable Method

This subscription is unstable and only available if the validator was started with the --rpc-pubsub-enable-vote-subscription flag. The format of this subscription may change in the future.

Parameters

None

Result

<integer> - subscription id (needed to unsubscribe)

Code sample

{ "jsonrpc": "2.0", "id": 1, "method": "voteSubscribe" }

Response

{ "jsonrpc": "2.0", "result": 0, "id": 1 }

Notification Format:

The notification will be an object with the following fields:

  • hash: <string> - The vote hash
  • slots: <array> - The slots covered by the vote, as an array of u64 integers
  • timestamp: <i64|null> - The timestamp of the vote
  • signature: <string> - The signature of the transaction that contained this vote
  • votePubkey: <string> - The public key of the vote account, as base-58 encoded string
{
"jsonrpc": "2.0",
"method": "voteNotification",
"params": {
"result": {
"hash": "8Rshv2oMkPu5E4opXTRyuyBeZBqQ4S477VG26wUTFxUM",
"slots": [1, 2],
"timestamp": null
},
"subscription": 0
}
}