rootSubscribe

rootSubscribe WebSocket Method

post

wss://public.rpc.solanavibestation.comwss://basic.rpc.solanavibestation.comwss://ultra.rpc.solanavibestation.comwss://elite.rpc.solanavibestation.comwss://epic.rpc.solanavibestation.comwss://basic.swqos.solanavibestation.comwss://ultra.swqos.solanavibestation.comwss://elite.swqos.solanavibestation.com

/

Subscribe to receive notification anytime a new root is set by the validator. This method establishes a persistent WebSocket connection that will send real-time notifications whenever the validator updates the root slot. The root represents the most recent slot that has been finalized and committed to the ledger. This subscription is useful for tracking the overall progress of the blockchain and understanding when transactions become irreversibly confirmed.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Authorization header for API key authentication.

Example:

Authorization: your-api-key-here

Body

application/json

Request object for subscribing to root change notifications via WebSocket

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

idone ofRequired

Request identifier that will be returned in the response

Example: 1

stringOptional

or

numberOptional

methodstring · enumRequired

The WebSocket method name

Example: rootSubscribePossible values:

Responses

101

WebSocket notification for root changes

application/json

WebSocket notification sent when a new root is set by the validator

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

methodstring · enumRequired

Notification method name indicating this is a root notification

Example: rootNotificationPossible values:

200

Subscription successfully created

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized

text/plain

403

Forbidden

text/plain

429

Too Many Requests

text/plain

500

Internal Server Error

text/plain

post

/

WebSocket (Browser)Node.js WebSocketSolana Web3.jsRustPython

const ws = new WebSocket('wss://public.rpc.solanavibestation.com');

ws.onopen = function() {
  // Subscribe to root notifications
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'rootSubscribe'
  }));
};

ws.onmessage = function(event) {
  const data = JSON.parse(event.data);
  
  if (data.method === 'rootNotification') {
    const rootSlot = data.params.result;
    const subscriptionId = data.params.subscription;
    console.log(`New root set at slot ${rootSlot} (subscription: ${subscriptionId})`);
  } else if (data.result !== undefined) {
    console.log('Root subscription ID:', data.result);
  }
};

{
  "jsonrpc": "2.0",
  "method": "rootNotification",
  "params": {
    "result": 42,
    "subscription": 0
  }
}