web3_clientVersion - HyperEVM

Example code for the web3_clientVersion JSON RPC method. Сomplete guide on how to use web3_clientVersion GetBlock JSON RPC in GetBlock Web3 documentation.

This method returns the current client version.

Parameters

• None

Request

cURL

cURL

curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "web3_clientVersion",
    "params": [],
    "id": "getblock.io"
}'

Axios

JavaScript (Node.js, axios)

const axios = require('axios');

const response = await axios.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', {
    jsonrpc: '2.0',
    method: 'web3_clientVersion',
    params: [],
    id: 'getblock.io'
});

console.log('Client Version:', response.data.result);

Request

Python (requests)

import requests

response = requests.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', json={
    'jsonrpc': '2.0',
    'method': 'web3_clientVersion',
    'params': [],
    'id': 'getblock.io'
})

print(f'Client Version: {response.json()["result"]}')

Rust

Rust (reqwest, async)

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "web3_clientVersion",
            "params": [],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

Response (example)

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "HyperEVM/v1.0.0/linux-amd64"
}

Response Parameters

Field	Type	Description
result	string	Client version string.

Use Case

The web3_clientVersion method is essential for:

• Client identification

• Version verification

• Debugging and diagnostics

• Compatibility checks

Error Handling

Error Code	Message	Cause
-32603	Internal error	Node issue.

Web3 Integration

Ether.js

import { ethers } from "ethers";
const RPC_URL = "https://shared.eu-central-1.getblock.io/<ACCESS_TOKEN>";
const provider = new ethers.JsonRpcProvider(RPC_URL);

async function Call() {
  try {
    // Call the method — this will resolve to a number (promise resolves to number)
    const result = await provider.send("web3_clientVersion", []);
    console.log("The result:", result);
    return result;
  } catch (error) {
    console.error("The error:", error);
    throw error;
  }
}

Viem

import { createPublicClient, http } from "viem";
import { hyperEvm } from "viem/chains";

// Create Viem client with GetBlock
const client = createPublicClient({
  chain: hyperEvm,
  transport: http(import.meta.env.HYPER_ACCESS_TOKEN),
});

// Using the method through Viem
async function Call() {
  try {
    // Method-specific Viem implementation
    const result = await client.request({
      method: "web3_clientVersion",
      params: [],
    });
    return result;
  } catch (error) {
    console.error("Viem Error:", error);
    throw error;
  }
}