chain_getFinalizedHead

Returns the hash of the last finalized block on Bifrost.

Use Cases

• Confirmed state - Query state that cannot be reverted
• Transaction confirmation - Verify transaction finality for omnichain liquid staking (vDOT, vKSM, vGLMR, vMOVR, vASTR), cross-chain vToken governance, and DOT/ETH liquidity bridging
• Safe checkpoints - Use finalized blocks for critical operations

Parameters

This method accepts no parameters.

Request

{
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "params": [],
  "id": 1
}

Code Examples

cURL

curl https://api-bifrost-polkadot.n.dwellir.com/YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getFinalizedHead",
    "params": [],
    "id": 1
  }'

JavaScript

import { ApiPromise, WsProvider } from '@polkadot/api';

const provider = new WsProvider('wss://api-bifrost-polkadot.n.dwellir.com/YOUR_API_KEY');
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();

Python

import requests

def get_finalized_head():
    url = 'https://api-bifrost-polkadot.n.dwellir.com/YOUR_API_KEY'

    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 hash
• chain_getBlockHash - Get block hash by number