rootUnsubscribe

rootUnsubscribe 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

/

Unsubscribe from root notifications. This method cancels an existing root subscription identified by the subscription ID that was returned from a previous rootSubscribe call. Once unsubscribed, you will no longer receive rootNotification messages when the validator sets new root slots.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Authorization header for API key authentication.

Example:

Authorization: your-api-key-here

Body

application/json

Request object for unsubscribing from root change notifications

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: rootUnsubscribePossible values:

paramsinteger[] · min: 1 · max: 1Required

Method parameters array containing the root subscription ID to cancel

Example: [0]

Responses

200

Unsubscription successful

application/json

Response indicating the success or failure of the root unsubscribe operation

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

idone ofRequired

Request identifier matching the original request

Example: 1

stringOptional

or

numberOptional

resultbooleanOptional

Unsubscribe success indicator. Returns true if the root subscription was successfully cancelled, false otherwise. A successful unsubscribe means you will no longer receive rootNotification messages when new root slots are set by the validator.

Example: true

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');
let subscriptionId = 0; // From previous rootSubscribe call

ws.onopen = function() {
  // Unsubscribe from root notifications
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'rootUnsubscribe',
    params: [subscriptionId]
  }));
};

ws.onmessage = function(event) {
  const data = JSON.parse(event.data);
  
  if (data.result === true) {
    console.log('Successfully unsubscribed from root notifications:', subscriptionId);
  } else if (data.error) {
    console.error('Unsubscribe failed:', data.error);
  }
};

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