POST
/
evm
debug_getRawHeader
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "method": "debug_getRawHeader",
  "params": [
    "latest"
  ],
  "id": 1
}'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xf90211a0..."
}
The debug_getRawHeader JSON-RPC method returns the raw header data for a specific block. This method provides the complete block header in its raw encoded format, useful for low-level blockchain analysis, debugging, and applications that need direct access to the block header’s binary representation.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  1. Block identifier (string, required): Block number, hash, or “latest”/“earliest”/“pending”

​
Response

The method returns the raw header data in hexadecimal format for the specified block.

​
Response structure

Raw header data:
  • result — Complete raw header data encoded in hexadecimal format

​
Usage example

​
Basic implementation

// Get raw header for a specific block
const getRawHeader = async (blockIdentifier = 'latest') => {
  const response = await fetch('https://hyperliquid-mainnet.core.chainstack.com/YOUR_ENDPOINT/evm', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'debug_getRawHeader',
      params: [blockIdentifier],
      id: 1
    })
  });
  
  const data = await response.json();
  return data.result;
};

// Usage
getRawHeader('latest').then(header => {
  console.log('Raw header:', header);
  console.log('Header size:', header.length / 2 - 1, 'bytes');
});

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_getRawHeader",
    "params": [
      "latest"
    ],
    "id": 1
  }' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm

​
Use cases

The debug_getRawHeader method is essential for applications that need to:
  • Low-level analysis: Perform direct analysis of block header binary data
  • Protocol research: Research blockchain protocol details and header structure
  • Custom parsing: Implement custom header parsing and validation logic
  • Development tools: Build blockchain development and debugging tools
  • Data archival: Archive raw blockchain data for historical analysis
  • Cross-chain verification: Verify block headers across different blockchain systems
  • Academic research: Support academic blockchain research projects
  • Forensic analysis: Perform forensic investigation of blockchain data
  • Compliance tools: Build regulatory compliance and auditing tools
  • Testing frameworks: Create comprehensive blockchain testing suites
This method provides direct access to raw block header data, enabling low-level blockchain analysis and custom tooling on the Hyperliquid EVM platform.

Body

application/json
​
jsonrpc
enum<string>
default:2.0
required

JSON-RPC version

Available options:
2.0
​
method
enum<string>
default:debug_getRawHeader
required

The RPC method name

Available options:
debug_getRawHeader
​
params
any[]
required

Parameters: [block identifier (block number, hash, or 'latest'/'earliest'/'pending')]

​
id
integer
default:1
required

Request identifier

Response

200 - application/json

Successful response with raw header data

​
jsonrpc
string

JSON-RPC version

​
id
integer

Request identifier

​
result
string

Raw header data in hexadecimal format