rootSubscribe

Subscribe to notifications when the validator sets a new root slot.

Source

root_subscribe

params

None

result

integer

Subscription id. Pass this to rootUnsubscribe.

$ curl https://api.devnet.solana.com -s -X \
>   POST -H "Content-Type: application/json" -d ' 
>   {
>     "jsonrpc": "2.0",
>     "id": 1,
>     "method": "rootSubscribe"
>   }
> '

Response

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

$ curl https://api.devnet.solana.com -s -X \
>   POST -H "Content-Type: application/json" -d ' 
>   {
>     "jsonrpc": "2.0",
>     "id": 1,
>     "method": "rootSubscribe"
>   }
> '

params

None

result

Response

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

integer

Subscription id. Pass this to rootUnsubscribe.

Notification format

Notifications are delivered as rootNotification.

{
  "jsonrpc": "2.0",
  "method": "rootNotification",
  "params": {
    "result": 324,
    "subscription": 3
  }
}

jsonrpc

string

Always "2.0".

method

string

Always "rootNotification".

params

object

Notification wrapper with the latest root and the subscription id.