rootSubscribe

On Solana, a root is the slot the cluster has finalized under its Proof-of-History plus Proof-of-Stake consensus, and rootSubscribe opens a PubSub subscription that pushes the new root slot number each time finalization advances. It is the WebSocket way to follow the settled tip of the chain — the point past which transactions paid for in SOL will not be rolled back — without re-polling getSlot. The matching JSON-RPC endpoint is https://solana.therpc.io/YOUR_API_KEY, and you stop the stream by passing the returned subscription id to rootUnsubscribe.

Use cases

• Track finalization progress on Solana by following each new root, so you know exactly how far the settled tip has advanced.
• Advance a finalized-only cursor in a streaming indexer, processing data only once its slot has been rooted and can no longer be reverted.

Parameters

هذا الأسلوب لا يأخذ أي معاملات. مرر مصفوفة فارغة [].

Response

Example request

1# Open a WebSocket connection (e.g. with wscat) and send the subscribe request:
2wscat -c wss://solana.therpc.io/YOUR_API_KEY
3# then send:
4> {"jsonrpc":"2.0","id":1,"method":"rootSubscribe","params":[]}

Errors & troubleshooting

Common pitfalls

• A root is the finalized point, so it lags the chain's leading edge — expect notifications to arrive more slowly than from slotSubscribe, but each one is fully settled rather than provisional.
• This is a WebSocket-only method — it streams over a wss PubSub connection, and you stop it by passing the subscription id to rootUnsubscribe.

Supported networks

• Mainnet
• Devnet

See also

• slotSubscribe
• getSlot