getBlockCommitment

getBlockCommitment reports how much validator stake has voted on a given slot, the signal that drives finality in Solana's Proof-of-Stake consensus (SOL is the staked native token). For the requested slot it returns a commitment array — 32 buckets indexed by how many confirmations a portion of stake has cast on the block — alongside totalStake, the total active stake in the current epoch measured in lamports. The deeper the votes concentrate toward the top of the array relative to totalStake, the closer the block is to finalized. Call it against https://solana.therpc.io/YOUR_API_KEY as a JSON-RPC 2.0 POST passing the slot as the single positional param.

Use cases

• Measure how much SOL stake has voted on a slot to gauge how near it is to irreversible finality before acting on its transactions.
• Build a confidence indicator for a recent slot in a wallet or settlement service, surfacing "almost finalized" versus "fully finalized" to users.

Parameters

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getBlockCommitment",
8  "params": [
9    250000000
10  ]
11}'

Errors & troubleshooting

Common pitfalls

• commitment is null for slots outside the node's recent voting window — old slots no longer carry per-slot vote data, so handle the null case rather than assuming an array.
• Read the array relative to totalStake, not as absolute vote counts. The same bucket values mean very different things depending on how much SOL is staked in the epoch.

Supported networks

• Mainnet
• Devnet

See also

• getBlock
• getBlockHeight