> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Info>
  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](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

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.

## 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

```javascript theme={"system"}
// 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

<CodeGroup>
  ```shell Shell theme={"system"}
  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
  ```

  ```python web3.py theme={"system"}
  from web3 import Web3

  w3 = Web3(Web3.HTTPProvider("YOUR_CHAINSTACK_ENDPOINT"))

  # debug_getRawHeader has no first-class web3.py wrapper, so call it through the provider
  response = w3.provider.make_request("debug_getRawHeader", ["latest"])
  print(response["result"])
  ```

  ```javascript ethers.js theme={"system"}
  import { JsonRpcProvider } from "ethers";

  const provider = new JsonRpcProvider("YOUR_CHAINSTACK_ENDPOINT");

  // send() reaches methods that have no high-level API in the Provider
  const rawHeader = await provider.send("debug_getRawHeader", ["latest"]);
  console.log(rawHeader);
  ```

  ```typescript viem theme={"system"}
  import { createPublicClient, http } from "viem";

  const client = createPublicClient({
    transport: http("YOUR_CHAINSTACK_ENDPOINT"),
  });

  // request() issues a raw JSON-RPC call for methods without a built-in action
  const rawHeader = await client.request({
    method: "debug_getRawHeader",
    params: ["latest"],
  });
  console.log(rawHeader);
  ```
</CodeGroup>

<Note>
  **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](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## 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.


## OpenAPI

````yaml openapi/hyperliquid_node_api/hyperevm/evm_debug_get_raw_header.json post /evm
openapi: 3.0.0
info:
  title: Hyperliquid EVM API - debug_getRawHeader
  version: 1.0.0
servers:
  - url: >-
      https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274
security: []
paths:
  /evm:
    post:
      summary: debug_getRawHeader
      description: >-
        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 and debugging.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - method
                - params
                - id
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  default: '2.0'
                  description: JSON-RPC version
                method:
                  type: string
                  enum:
                    - debug_getRawHeader
                  default: debug_getRawHeader
                  description: The RPC method name
                params:
                  type: array
                  description: >-
                    Parameters: [block identifier (block number, hash, or
                    'latest'/'earliest'/'pending')]
                  default:
                    - latest
                id:
                  type: integer
                  default: 1
                  description: Request identifier
            example:
              jsonrpc: '2.0'
              method: debug_getRawHeader
              params:
                - latest
              id: 1
      responses:
        '200':
          description: Successful response with raw header data
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: JSON-RPC version
                  id:
                    type: integer
                    description: Request identifier
                  result:
                    type: string
                    description: Raw header data in hexadecimal format
              example:
                jsonrpc: '2.0'
                id: 1
                result: 0xf90211a0...

````