rootSubscribe

Subscribe to root updates on the Solana route (Beta).

Available under Solana WebSocket API (Beta). Use the chain-family pages for handle discovery and this page for exact subscription semantics.

Stage: Beta

Access

Surfaces: raw_rpc_ws
Metering: raw_rpc_ws_target_minute
Scope: Solana root subscription

Handles

Surface	Label	Value
`raw_rpc_ws`	Endpoint	`wss://gw-aql.tomo.services/rpc/solana/wss`
`raw_rpc_ws`	Auth header	`Bearer <api_key>`
`raw_rpc_ws`	Subscribe method	`rootSubscribe`
`raw_rpc_ws`	Notification method	`rootNotification`

Use `rootSubscribe` when the runtime needs the latest rooted slot without polling `getSlot` or parsing richer block notifications.

This beta example uses `/rpc/solana/wss` and the reviewed `rootSubscribe` request shape.

Examples

Connect with wscat


wscat -c "wss://gw-aql.tomo.services/rpc/solana/wss" \  -H "Authorization: Bearer <api_key>"> {>   "jsonrpc": "2.0",>   "id": 1,>   "method": "rootSubscribe",>   "params": []> }

Request fields

Subscription request

Field	Type	Required	Notes
`jsonrpc`	`string`	Required	JSON-RPC version. Use `2.0`.
`id`	`string \| number`	Required	Caller request id.
`method`	`string`	Required	Allowlisted subscription method.
`params`	`array`	Required	Subscription topic or filter arguments.

Response fields

Subscribe result

Field	Type	Notes
`jsonrpc`	`string`	JSON-RPC version.
`id`	`string \| number`	Echoed caller request id.
`result`	`string \| number`	Subscription id returned by the hosted route.

Notification shape

Field	Type	Notes
`method`	`string`	Notification method such as `eth_subscription` or `slotNotification`.
`params.subscription`	`string \| number`	Subscription id tied to the current stream.
`params.result`	`object`	Upstream chain payload for the current notification.