ethash

The ethash namespace provides endpoints for accessing and interacting with the Ethash PoW process. It includes methods to retrieve the current mining work package, check the current hashrate, and submit computed proofs-of-work. These endpoints are essential for miners and for monitoring mining performance.

---

ethash_getHashrate

Description: Returns the current mining hashrate as computed by the node, typically represented as a hexadecimal value (in hashes per second).

Sample Request:

{
  "jsonrpc": "2.0",
  "method": "ethash_getHashrate",
  "params": [],
  "id": 1
}

Expected Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x12" // Example: 18 in decimal hashes per second
}

Parameters: None.

---

ethash_getWork

Description: Provides the current work package for miners. The returned array includes:

1. The block header hash (used in the PoW computation)

2. The seed hash for the current epoch (used for dataset generation)

3. The target difficulty (the value that the computed hash must be below)

Sample Request:

{
  "jsonrpc": "2.0",
  "method": "ethash_getWork",
  "params": [],
  "id": 1
}

Expected Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0xheaderhash...", 
    "0xseedhash...", 
    "0xtarget..."
  ]
}

Parameters: None.

---

ethash_submitHashrate

Description: Submits the miner’s computed hashrate to the node. This endpoint is used to report the miner's performance and may be used for monitoring or reward distribution purposes.

Sample Request:

{
  "jsonrpc": "2.0",
  "method": "ethash_submitHashrate",
  "params": ["0x1a", "0xworkerID"],
  "id": 1
}

Expected Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}

Parameters:

• hashrate (string): The miner’s computed hashrate as a hexadecimal string. &#xNAN;Example: "0x1a" (which is 26 in decimal).

• id (string): The worker identifier (typically a hexadecimal string). &#xNAN;Example: "0xworkerID".