debug_getRawHeader | Hyperliquid EVM

The debug_getRawHeader JSON-RPC method returns the raw header data for a specific block. Use it on Hyperliquid EVM via Chainstack.

POST /evm

debug_getRawHeader

cURL

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
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xf90211a0..."
}

This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.

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 today

Start 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 your own endpoint in your code. The code examples use a placeholder Chainstack endpoint (YOUR_CHAINSTACK_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the Chainstack console. The curl above uses a shared public endpoint for quick checks only; do not use it in production.

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 · array · 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