debug_getRawHeader

The debug_getRawHeader method returns the RLP-encoded raw block header data for a specified block number or hash. Unlike debug_getRawBlock which returns the entire block, this method returns only the block header in its encoded format.

This method is particularly useful for lightweight block verification, header chain validation, and implementing light clients for the Kaia network. The block header contains critical information like parent hash, state root, transactions root, receipts root, difficulty, and timestamp without the overhead of full transaction data. Developers can use this to verify proof-of-work, build header-only chains, validate block relationships, and perform header-based synchronization. The smaller size makes it more efficient for operations that only need header information.

This method is available only on the full archive node.

Parameters

parameter	type	description
blockParameter	string (required)	Block number in hexadecimal format (e.g., '0x10d4f') or block hash (32-byte hex string with 0x prefix), or one of the string tags: 'latest' for the most recent block, 'earliest' for the genesis block, or 'pending' for pending state

Return Object

field	type	description
result	string	The RLP-encoded block header data as a hexadecimal string. This contains only the block header fields (parent hash, uncle hash, coinbase, state root, transactions root, receipts root, logs bloom, difficulty, number, gas limit, gas used, timestamp, extra data, mix hash, and nonce) in their raw encoded format

Request Example

Request

Response Example

Response