getmininginfo

Back to mining

Changed behavior since v30.2

Summary

Returns a json object containing mining-related information.

Description

Returns a json object containing mining-related information.

Changed behavior since v30.2

networkhashps is the default total qbit chainwork hashrate estimate, and next is the permissionless/native candidate.

Notes

  • networkhashps is equivalent to getnetworkhashps with lane="all".
  • next is the next permissionless/native Cadence candidate. AuxPoW candidate bits and target are returned by createauxblock.

Change Buckets

  • Changed behavior since v30.2

Arguments

None.

Results

  • value (OBJ): No description.
  • blocks (NUM): The current block
  • currentblockweight (NUM, optional): The block weight (including reserved weight for block header, txs count and coinbase tx) of the last assembled block (only present if a block was ever assembled)
  • currentblocktx (NUM, optional): The number of block transactions (excluding coinbase) of the last assembled block (only present if a block was ever assembled)
  • bits (STR_HEX): The current nBits, compact representation of the block difficulty target
  • difficulty (NUM): The current difficulty
  • target (STR_HEX): The current target
  • networkhashps (NUM): The total active-chain network hashes per second (H/s), equivalent to getnetworkhashps with lane="all"
  • pooledtx (NUM): The size of the mempool
  • blockmintxfee (STR_AMOUNT): Minimum feerate of packages selected for block inclusion in QBT/kvB
  • chain (STR): current network name (main, test, testnet4, signet, regtest)
  • signet_challenge (STR_HEX, optional): The block challenge (aka. block script), in hexadecimal (only present if the current network is a signet)
  • next (OBJ): The next permissionless/native Cadence block candidate
    • height (NUM): The next permissionless/native candidate height
    • bits (STR_HEX): The next permissionless/native candidate target nBits
    • difficulty (NUM): The next permissionless/native candidate difficulty
    • target (STR_HEX): The next permissionless/native candidate target
  • warnings (ARR): any network and blockchain warnings (run with -deprecatedrpc=warnings to return the latest warning as a single string)
    • value (STR): warning

Examples

qbit-cli getmininginfo

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