getnetworkhashps

Back to mining

Changed params/results since v30.2 Changed behavior since v30.2

Summary

Returns the estimated network hashes per second (H/s) based on accepted block proof work.

Description

Returns the estimated network hashes per second (H/s) based on accepted block proof work. Pass in [blocks] to override # of blocks, -1 specifies since last difficulty change (or 1 block on ASERT networks). Pass in [height] to estimate the network speed at the time when a certain block was found. Pass in [lane] to estimate all work, permissionless work, or AuxPoW work. Lane-specific estimates filter which block work contributes to the numerator, but keep the same active-chain elapsed-time window as "all"; they do not use a lane-local timestamp window. A lane with no blocks in the selected window returns 0.

Changed behavior since v30.2

Adds lane-aware qbit hashrate estimates for all, permissionless, and AuxPoW work.

Notes

  • The result is an effective chainwork hashrate estimate in H/s.
  • Lane-specific estimates filter which blocks contribute work while using the same active-chain elapsed-time window as the all-lane estimate; they do not use a lane-local timestamp window.

Change Buckets

  • Changed params/results since v30.2
  • Changed behavior since v30.2

Arguments

  • nblocks (NUM): The number of previous blocks to calculate estimate from, or -1 for blocks since last difficulty change (1 block on ASERT networks).
  • height (NUM): To estimate at the time of the given height.
  • lane (STR): Hashrate lane to estimate: "all", "permissionless", or "auxpow".

Results

  • value (NUM): Hashes per second estimated

Examples

qbit-cli getnetworkhashps

qbit-cli getnetworkhashps 120 -1 all

qbit-cli getnetworkhashps 120 -1 permissionless

qbit-cli getnetworkhashps 120 -1 auxpow

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getnetworkhashps", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8352/