chain_getFinalizedHead - Kusama RPC Method
Get the finalized block hash on Kusama. Essential for confirmed state queries on Polkadot's canary network for real-world testing with live economic conditions.
Returns the hash of the last finalized block on Kusama.
Use Cases
- Confirmed state - Query state that cannot be reverted
- Transaction confirmation - Verify transaction finality for parachain experimentation, early feature deployment, and production-grade testing with real value
- Safe checkpoints - Use finalized blocks for critical operations
Request Parameters
This method accepts no parameters.
Response Body
Code Examples
curl \
-X POST \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "chain_getFinalizedHead",
"params": [],
"id": 1
}'import { ApiPromise, WsProvider } from '@polkadot/api';
const provider = new WsProvider('');
const api = await ApiPromise.create({ provider });
const finalizedHash = await api.rpc.chain.getFinalizedHead();
console.log('Finalized block hash:', finalizedHash.toHex());
// Get finalized block details
const block = await api.rpc.chain.getBlock(finalizedHash);
console.log('Finalized block number:', block.block.header.number.toNumber());
await api.disconnect();import requests
def get_finalized_head():
url = ''
payload = {
'jsonrpc': '2.0',
'method': 'chain_getFinalizedHead',
'params': [],
'id': 1
}
response = requests.post(url, json=payload)
return response.json()['result']
finalized_hash = get_finalized_head()
print(f'Finalized block hash: {finalized_hash}')Related Methods
chain_getBlock- Get block by hashchain_getBlockHash- Get block hash by number