getmininginfo

getmininginfo Returns a json object containing Result: { "blocks" : n, "currentblockweight" : n, "currentblocktx" : n, "bits" : "hex", "difficulty" : n, "target" : "hex", "networkhashps" : n, "pooledtx" : n, "chain" : "str", "signet_challenge" "next" : { "height" : n, "bits" : "hex", "difficulty" : n, "target" : "hex" }, "warnings" : [ "str", ... ] } Examples: > bitcoin-cli getmininginfo > curl --user myusername mining-related information. (json object) (numeric) The current block (numeric, 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) (numeric, optional) The number of block transactions (excluding coinbase) of the last assembled block (only present if a block was ever assembled) (string) The current nBits, compact representation of the block difficulty target (numeric) The current difficulty (string) The current target (numeric) The network hashes per second (numeric) The size of the mempool (string) current network name (main, test, testnet4, signet, regtest, tensor, tensor-test, tensor-reg) : "hex", (string, optional) The block challenge (aka. block script), in hexadecimal (only present if the current network is a signet) (json object) The next block (numeric) The next height (string) The next target nBits (numeric) The next difficulty (string) The next target (json array) any network and blockchain warnings (run with `-deprecatedrpc=warnings` to return the latest warning as a single string) (string) warning --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getmininginfo", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8332/

Signature

getmininginfo() → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"getmininginfo","params":[]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-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:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getmininginfo",
        "params": [],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "getmininginfo",
    params: [],
  }),
});
console.log(await res.json());

Parameters

No parameters.

Result

Type: any

{ (json object) "blocks" : n, (numeric) The current block "currentblockweight" : n, (numeric, 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" : n, (numeric, optional) The number of block transactions (excluding coinbase) of the last assembled block (only present if a block was ever assembled) "bits" : "hex", (string) The current nBits, compact representation of the block difficulty target "difficulty" : n, (numeric) The current difficulty "target" : "hex", (string) The current target "networkhashps" : n, (numeric) The network hashes per second "pooledtx" : n, (numeric) The size of the mempool "chain" : "str", (string) current network name (main, test, testnet4, signet, regtest, tensor, tensor-test, tensor-reg) "signet_challenge" : "hex", (string, optional) The block challenge (aka. block script), in hexadecimal (only present if the current network is a signet) "next" : { (json object) The next block "height" : n, (numeric) The next height "bits" : "hex", (string) The next target nBits "difficulty" : n, (numeric) The next difficulty "target" : "hex" (string) The next target }, "warnings" : [ (json array) any network and blockchain warnings (run with `-deprecatedrpc=warnings` to return the latest warning as a single string) "str", (string) warning ... ] }

Source: services/core-node/bcore/src/rpc/mining.cpp:475

C++ symbol: getmininginfo

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"getmininginfo","params":[]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-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:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getmininginfo",
        "params": [],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "getmininginfo",
    params: [],
  }),
});
console.log(await res.json());