|
|
|
|
@@ -42,9 +42,9 @@ double GetDifficulty(const CBlockIndex* blockindex)
|
|
|
|
|
{
|
|
|
|
|
// Floating point number that is a multiple of the minimum difficulty,
|
|
|
|
|
// minimum difficulty = 1.0.
|
|
|
|
|
if (blockindex == NULL)
|
|
|
|
|
if (blockindex == nullptr)
|
|
|
|
|
{
|
|
|
|
|
if (chainActive.Tip() == NULL)
|
|
|
|
|
if (chainActive.Tip() == nullptr)
|
|
|
|
|
return 1.0;
|
|
|
|
|
else
|
|
|
|
|
blockindex = GetLastBlockIndex(chainActive.Tip(), false);
|
|
|
|
|
@@ -185,14 +185,14 @@ UniValue getblockcount(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 0)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getblockcount\n"
|
|
|
|
|
"\nReturns the number of blocks in the longest block chain.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"n (numeric) The current block count\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockcount", "")
|
|
|
|
|
+ HelpExampleRpc("getblockcount", "")
|
|
|
|
|
);
|
|
|
|
|
"getblockcount\n"
|
|
|
|
|
"\nReturns the number of blocks in the longest block chain.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"n (numeric) The current block count\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockcount", "")
|
|
|
|
|
+ HelpExampleRpc("getblockcount", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
return chainActive.Height();
|
|
|
|
|
@@ -202,14 +202,14 @@ UniValue getbestblockhash(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 0)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getbestblockhash\n"
|
|
|
|
|
"\nReturns the hash of the best (tip) block in the longest block chain.\n"
|
|
|
|
|
"\nResult\n"
|
|
|
|
|
"\"hex\" (string) the block hash hex encoded\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getbestblockhash", "")
|
|
|
|
|
+ HelpExampleRpc("getbestblockhash", "")
|
|
|
|
|
);
|
|
|
|
|
"getbestblockhash\n"
|
|
|
|
|
"\nReturns the hash of the best (tip) block in the longest block chain.\n"
|
|
|
|
|
"\nResult\n"
|
|
|
|
|
"\"hex\" (string) the block hash hex encoded\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getbestblockhash", "")
|
|
|
|
|
+ HelpExampleRpc("getbestblockhash", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
return chainActive.Tip()->GetBlockHash().GetHex();
|
|
|
|
|
@@ -229,7 +229,7 @@ UniValue getdifficulty(const UniValue& params, bool fHelp)
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getdifficulty", "")
|
|
|
|
|
+ HelpExampleRpc("getdifficulty", "")
|
|
|
|
|
);
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -243,20 +243,20 @@ std::string EntryDescriptionString()
|
|
|
|
|
{
|
|
|
|
|
return " \"size\" : n, (numeric) transaction size in bytes\n"
|
|
|
|
|
" \"fee\" : n, (numeric) transaction fee in " + CURRENCY_UNIT + "\n"
|
|
|
|
|
" \"modifiedfee\" : n, (numeric) transaction fee with fee deltas used for mining priority\n"
|
|
|
|
|
" \"time\" : n, (numeric) local time transaction entered pool in seconds since 1 Jan 1970 GMT\n"
|
|
|
|
|
" \"height\" : n, (numeric) block height when transaction entered pool\n"
|
|
|
|
|
" \"startingpriority\" : n, (numeric) priority when transaction entered pool\n"
|
|
|
|
|
" \"currentpriority\" : n, (numeric) transaction priority now\n"
|
|
|
|
|
" \"descendantcount\" : n, (numeric) number of in-mempool descendant transactions (including this one)\n"
|
|
|
|
|
" \"descendantsize\" : n, (numeric) size of in-mempool descendants (including this one)\n"
|
|
|
|
|
" \"descendantfees\" : n, (numeric) modified fees (see above) of in-mempool descendants (including this one)\n"
|
|
|
|
|
" \"ancestorcount\" : n, (numeric) number of in-mempool ancestor transactions (including this one)\n"
|
|
|
|
|
" \"ancestorsize\" : n, (numeric) size of in-mempool ancestors (including this one)\n"
|
|
|
|
|
" \"ancestorfees\" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one)\n"
|
|
|
|
|
" \"depends\" : [ (array) unconfirmed transactions used as inputs for this transaction\n"
|
|
|
|
|
" \"transactionid\", (string) parent transaction id\n"
|
|
|
|
|
" ... ]\n";
|
|
|
|
|
" \"modifiedfee\" : n, (numeric) transaction fee with fee deltas used for mining priority\n"
|
|
|
|
|
" \"time\" : n, (numeric) local time transaction entered pool in seconds since 1 Jan 1970 GMT\n"
|
|
|
|
|
" \"height\" : n, (numeric) block height when transaction entered pool\n"
|
|
|
|
|
" \"startingpriority\" : n, (numeric) priority when transaction entered pool\n"
|
|
|
|
|
" \"currentpriority\" : n, (numeric) transaction priority now\n"
|
|
|
|
|
" \"descendantcount\" : n, (numeric) number of in-mempool descendant transactions (including this one)\n"
|
|
|
|
|
" \"descendantsize\" : n, (numeric) size of in-mempool descendants (including this one)\n"
|
|
|
|
|
" \"descendantfees\" : n, (numeric) modified fees (see above) of in-mempool descendants (including this one)\n"
|
|
|
|
|
" \"ancestorcount\" : n, (numeric) number of in-mempool ancestor transactions (including this one)\n"
|
|
|
|
|
" \"ancestorsize\" : n, (numeric) size of in-mempool ancestors (including this one)\n"
|
|
|
|
|
" \"ancestorfees\" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one)\n"
|
|
|
|
|
" \"depends\" : [ (array) unconfirmed transactions used as inputs for this transaction\n"
|
|
|
|
|
" \"transactionid\", (string) parent transaction id\n"
|
|
|
|
|
" ... ]\n";
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
void entryToJSON(UniValue &info, const CTxMemPoolEntry &e)
|
|
|
|
|
@@ -325,25 +325,25 @@ UniValue getrawmempool(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() > 1)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getrawmempool ( verbose )\n"
|
|
|
|
|
"\nReturns all transaction ids in memory pool as a json array of string transaction ids.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. verbose (boolean, optional, default=false) true for a json object, false for array of transaction ids\n"
|
|
|
|
|
"\nResult: (for verbose = false):\n"
|
|
|
|
|
"[ (json array of string)\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"\nResult: (for verbose = true):\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
" \"transactionid\" : { (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ " }, ...\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getrawmempool", "true")
|
|
|
|
|
+ HelpExampleRpc("getrawmempool", "true")
|
|
|
|
|
);
|
|
|
|
|
"getrawmempool ( verbose )\n"
|
|
|
|
|
"\nReturns all transaction ids in memory pool as a json array of string transaction ids.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. verbose (boolean, optional, default=false) true for a json object, false for array of transaction ids\n"
|
|
|
|
|
"\nResult: (for verbose = false):\n"
|
|
|
|
|
"[ (json array of string)\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"\nResult: (for verbose = true):\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
" \"transactionid\" : { (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ " }, ...\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getrawmempool", "true")
|
|
|
|
|
+ HelpExampleRpc("getrawmempool", "true")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
bool fVerbose = false;
|
|
|
|
|
if (params.size() > 0)
|
|
|
|
|
@@ -356,26 +356,26 @@ UniValue getmempoolancestors(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() < 1 || params.size() > 2) {
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getmempoolancestors txid (verbose)\n"
|
|
|
|
|
"\nIf txid is in the mempool, returns all in-mempool ancestors.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id (must be in mempool)\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=false) true for a json object, false for array of transaction ids\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"[ (json array of strings)\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id of an in-mempool ancestor transaction\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"\nResult (for verbose=true):\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
" \"transactionid\" : { (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ " }, ...\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getmempoolancestors", "\"mytxid\"")
|
|
|
|
|
+ HelpExampleRpc("getmempoolancestors", "\"mytxid\"")
|
|
|
|
|
);
|
|
|
|
|
"getmempoolancestors txid (verbose)\n"
|
|
|
|
|
"\nIf txid is in the mempool, returns all in-mempool ancestors.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id (must be in mempool)\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=false) true for a json object, false for array of transaction ids\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"[ (json array of strings)\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id of an in-mempool ancestor transaction\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"\nResult (for verbose=true):\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
" \"transactionid\" : { (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ " }, ...\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getmempoolancestors", "\"mytxid\"")
|
|
|
|
|
+ HelpExampleRpc("getmempoolancestors", "\"mytxid\"")
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool fVerbose = false;
|
|
|
|
|
@@ -420,26 +420,26 @@ UniValue getmempooldescendants(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() < 1 || params.size() > 2) {
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getmempooldescendants txid (verbose)\n"
|
|
|
|
|
"\nIf txid is in the mempool, returns all in-mempool descendants.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id (must be in mempool)\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=false) true for a json object, false for array of transaction ids\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"[ (json array of strings)\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id of an in-mempool descendant transaction\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"\nResult (for verbose=true):\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
" \"transactionid\" : { (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ " }, ...\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getmempooldescendants", "\"mytxid\"")
|
|
|
|
|
+ HelpExampleRpc("getmempooldescendants", "\"mytxid\"")
|
|
|
|
|
);
|
|
|
|
|
"getmempooldescendants txid (verbose)\n"
|
|
|
|
|
"\nIf txid is in the mempool, returns all in-mempool descendants.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id (must be in mempool)\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=false) true for a json object, false for array of transaction ids\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"[ (json array of strings)\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id of an in-mempool descendant transaction\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"\nResult (for verbose=true):\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
" \"transactionid\" : { (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ " }, ...\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getmempooldescendants", "\"mytxid\"")
|
|
|
|
|
+ HelpExampleRpc("getmempooldescendants", "\"mytxid\"")
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool fVerbose = false;
|
|
|
|
|
@@ -484,18 +484,18 @@ UniValue getmempoolentry(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 1) {
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getmempoolentry txid\n"
|
|
|
|
|
"\nReturns mempool data for given transaction\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id (must be in mempool)\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ "}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getmempoolentry", "\"mytxid\"")
|
|
|
|
|
+ HelpExampleRpc("getmempoolentry", "\"mytxid\"")
|
|
|
|
|
);
|
|
|
|
|
"getmempoolentry txid\n"
|
|
|
|
|
"\nReturns mempool data for given transaction\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id (must be in mempool)\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{ (json object)\n"
|
|
|
|
|
+ EntryDescriptionString()
|
|
|
|
|
+ "}\n"
|
|
|
|
|
"\nExamples\n"
|
|
|
|
|
+ HelpExampleCli("getmempoolentry", "\"mytxid\"")
|
|
|
|
|
+ HelpExampleRpc("getmempoolentry", "\"mytxid\"")
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
uint256 hash = ParseHashV(params[0], "parameter 1");
|
|
|
|
|
@@ -517,16 +517,16 @@ UniValue getblockhash(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 1)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getblockhash index\n"
|
|
|
|
|
"\nReturns hash of block in best-block-chain at index provided.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. index (numeric, required) The block index\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"\"hash\" (string) The block hash\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockhash", "1000")
|
|
|
|
|
+ HelpExampleRpc("getblockhash", "1000")
|
|
|
|
|
);
|
|
|
|
|
"getblockhash index\n"
|
|
|
|
|
"\nReturns hash of block in best-block-chain at index provided.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. index (numeric, required) The block index\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"\"hash\" (string) The block hash\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockhash", "1000")
|
|
|
|
|
+ HelpExampleRpc("getblockhash", "1000")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -542,35 +542,35 @@ UniValue getblockheader(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() < 1 || params.size() > 2)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getblockheader \"hash\" ( verbose )\n"
|
|
|
|
|
"\nIf verbose is false, returns a string that is serialized, hex-encoded data for blockheader 'hash'.\n"
|
|
|
|
|
"If verbose is true, returns an Object with information about blockheader <hash>.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"hash\" (string, required) The block hash\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=true) true for a json object, false for the hex encoded data\n"
|
|
|
|
|
"\nResult (for verbose = true):\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"hash\" : \"hash\", (string) the block hash (same as provided)\n"
|
|
|
|
|
" \"confirmations\" : n, (numeric) The number of confirmations, or -1 if the block is not on the main chain\n"
|
|
|
|
|
" \"height\" : n, (numeric) The block height or index\n"
|
|
|
|
|
" \"version\" : n, (numeric) The block version\n"
|
|
|
|
|
" \"versionHex\" : \"00000000\", (string) The block version formatted in hexadecimal\n"
|
|
|
|
|
" \"merkleroot\" : \"xxxx\", (string) The merkle root\n"
|
|
|
|
|
" \"time\" : ttt, (numeric) The block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"mediantime\" : ttt, (numeric) The median block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"nonce\" : n, (numeric) The nonce\n"
|
|
|
|
|
" \"bits\" : \"1d00ffff\", (string) The bits\n"
|
|
|
|
|
" \"difficulty\" : x.xxx, (numeric) The difficulty\n"
|
|
|
|
|
" \"previousblockhash\" : \"hash\", (string) The hash of the previous block\n"
|
|
|
|
|
" \"nextblockhash\" : \"hash\", (string) The hash of the next block\n"
|
|
|
|
|
" \"chainwork\" : \"0000...1f3\" (string) Expected number of hashes required to produce the current chain (in hex)\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"\"data\" (string) A string that is serialized, hex-encoded data for block 'hash'.\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockheader", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
+ HelpExampleRpc("getblockheader", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
);
|
|
|
|
|
"getblockheader \"hash\" ( verbose )\n"
|
|
|
|
|
"\nIf verbose is false, returns a string that is serialized, hex-encoded data for blockheader 'hash'.\n"
|
|
|
|
|
"If verbose is true, returns an Object with information about blockheader <hash>.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"hash\" (string, required) The block hash\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=true) true for a json object, false for the hex encoded data\n"
|
|
|
|
|
"\nResult (for verbose = true):\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"hash\" : \"hash\", (string) the block hash (same as provided)\n"
|
|
|
|
|
" \"confirmations\" : n, (numeric) The number of confirmations, or -1 if the block is not on the main chain\n"
|
|
|
|
|
" \"height\" : n, (numeric) The block height or index\n"
|
|
|
|
|
" \"version\" : n, (numeric) The block version\n"
|
|
|
|
|
" \"versionHex\" : \"00000000\", (string) The block version formatted in hexadecimal\n"
|
|
|
|
|
" \"merkleroot\" : \"xxxx\", (string) The merkle root\n"
|
|
|
|
|
" \"time\" : ttt, (numeric) The block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"mediantime\" : ttt, (numeric) The median block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"nonce\" : n, (numeric) The nonce\n"
|
|
|
|
|
" \"bits\" : \"1d00ffff\", (string) The bits\n"
|
|
|
|
|
" \"difficulty\" : x.xxx, (numeric) The difficulty\n"
|
|
|
|
|
" \"previousblockhash\" : \"hash\", (string) The hash of the previous block\n"
|
|
|
|
|
" \"nextblockhash\" : \"hash\", (string) The hash of the next block\n"
|
|
|
|
|
" \"chainwork\" : \"0000...1f3\" (string) Expected number of hashes required to produce the current chain (in hex)\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"\"data\" (string) A string that is serialized, hex-encoded data for block 'hash'.\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockheader", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
+ HelpExampleRpc("getblockheader", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -601,40 +601,40 @@ UniValue getblock(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() < 1 || params.size() > 2)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getblock \"hash\" ( verbose )\n"
|
|
|
|
|
"\nIf verbose is false, returns a string that is serialized, hex-encoded data for block 'hash'.\n"
|
|
|
|
|
"If verbose is true, returns an Object with information about block <hash>.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"hash\" (string, required) The block hash\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=true) true for a json object, false for the hex encoded data\n"
|
|
|
|
|
"\nResult (for verbose = true):\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"hash\" : \"hash\", (string) the block hash (same as provided)\n"
|
|
|
|
|
" \"confirmations\" : n, (numeric) The number of confirmations, or -1 if the block is not on the main chain\n"
|
|
|
|
|
" \"size\" : n, (numeric) The block size\n"
|
|
|
|
|
" \"height\" : n, (numeric) The block height or index\n"
|
|
|
|
|
" \"version\" : n, (numeric) The block version\n"
|
|
|
|
|
" \"versionHex\" : \"00000000\", (string) The block version formatted in hexadecimal\n"
|
|
|
|
|
" \"merkleroot\" : \"xxxx\", (string) The merkle root\n"
|
|
|
|
|
" \"tx\" : [ (array of string) The transaction ids\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
" ],\n"
|
|
|
|
|
" \"time\" : ttt, (numeric) The block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"mediantime\" : ttt, (numeric) The median block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"nonce\" : n, (numeric) The nonce\n"
|
|
|
|
|
" \"bits\" : \"1d00ffff\", (string) The bits\n"
|
|
|
|
|
" \"difficulty\" : x.xxx, (numeric) The difficulty\n"
|
|
|
|
|
" \"chainwork\" : \"xxxx\", (string) Expected number of hashes required to produce the chain up to this block (in hex)\n"
|
|
|
|
|
" \"previousblockhash\" : \"hash\", (string) The hash of the previous block\n"
|
|
|
|
|
" \"nextblockhash\" : \"hash\" (string) The hash of the next block\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"\"data\" (string) A string that is serialized, hex-encoded data for block 'hash'.\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblock", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
+ HelpExampleRpc("getblock", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
);
|
|
|
|
|
"getblock \"hash\" ( verbose )\n"
|
|
|
|
|
"\nIf verbose is false, returns a string that is serialized, hex-encoded data for block 'hash'.\n"
|
|
|
|
|
"If verbose is true, returns an Object with information about block <hash>.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"hash\" (string, required) The block hash\n"
|
|
|
|
|
"2. verbose (boolean, optional, default=true) true for a json object, false for the hex encoded data\n"
|
|
|
|
|
"\nResult (for verbose = true):\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"hash\" : \"hash\", (string) the block hash (same as provided)\n"
|
|
|
|
|
" \"confirmations\" : n, (numeric) The number of confirmations, or -1 if the block is not on the main chain\n"
|
|
|
|
|
" \"size\" : n, (numeric) The block size\n"
|
|
|
|
|
" \"height\" : n, (numeric) The block height or index\n"
|
|
|
|
|
" \"version\" : n, (numeric) The block version\n"
|
|
|
|
|
" \"versionHex\" : \"00000000\", (string) The block version formatted in hexadecimal\n"
|
|
|
|
|
" \"merkleroot\" : \"xxxx\", (string) The merkle root\n"
|
|
|
|
|
" \"tx\" : [ (array of string) The transaction ids\n"
|
|
|
|
|
" \"transactionid\" (string) The transaction id\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
" ],\n"
|
|
|
|
|
" \"time\" : ttt, (numeric) The block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"mediantime\" : ttt, (numeric) The median block time in seconds since epoch (Jan 1 1970 GMT)\n"
|
|
|
|
|
" \"nonce\" : n, (numeric) The nonce\n"
|
|
|
|
|
" \"bits\" : \"1d00ffff\", (string) The bits\n"
|
|
|
|
|
" \"difficulty\" : x.xxx, (numeric) The difficulty\n"
|
|
|
|
|
" \"chainwork\" : \"xxxx\", (string) Expected number of hashes required to produce the chain up to this block (in hex)\n"
|
|
|
|
|
" \"previousblockhash\" : \"hash\", (string) The hash of the previous block\n"
|
|
|
|
|
" \"nextblockhash\" : \"hash\" (string) The hash of the next block\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nResult (for verbose=false):\n"
|
|
|
|
|
"\"data\" (string) A string that is serialized, hex-encoded data for block 'hash'.\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblock", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
+ HelpExampleRpc("getblock", "\"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09\"")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -726,23 +726,23 @@ UniValue gettxoutsetinfo(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 0)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"gettxoutsetinfo\n"
|
|
|
|
|
"\nReturns statistics about the unspent transaction output set.\n"
|
|
|
|
|
"Note this call may take some time.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"height\":n, (numeric) The current block height (index)\n"
|
|
|
|
|
" \"bestblock\": \"hex\", (string) the best block hash hex\n"
|
|
|
|
|
" \"transactions\": n, (numeric) The number of transactions\n"
|
|
|
|
|
" \"txouts\": n, (numeric) The number of output transactions\n"
|
|
|
|
|
" \"bytes_serialized\": n, (numeric) The serialized size\n"
|
|
|
|
|
" \"hash_serialized\": \"hash\", (string) The serialized hash\n"
|
|
|
|
|
" \"total_amount\": x.xxx (numeric) The total amount\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("gettxoutsetinfo", "")
|
|
|
|
|
+ HelpExampleRpc("gettxoutsetinfo", "")
|
|
|
|
|
);
|
|
|
|
|
"gettxoutsetinfo\n"
|
|
|
|
|
"\nReturns statistics about the unspent transaction output set.\n"
|
|
|
|
|
"Note this call may take some time.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"height\":n, (numeric) The current block height (index)\n"
|
|
|
|
|
" \"bestblock\": \"hex\", (string) the best block hash hex\n"
|
|
|
|
|
" \"transactions\": n, (numeric) The number of transactions\n"
|
|
|
|
|
" \"txouts\": n, (numeric) The number of output transactions\n"
|
|
|
|
|
" \"bytes_serialized\": n, (numeric) The serialized size\n"
|
|
|
|
|
" \"hash_serialized\": \"hash\", (string) The serialized hash\n"
|
|
|
|
|
" \"total_amount\": x.xxx (numeric) The total amount\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("gettxoutsetinfo", "")
|
|
|
|
|
+ HelpExampleRpc("gettxoutsetinfo", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
UniValue ret(UniValue::VOBJ);
|
|
|
|
|
|
|
|
|
|
@@ -766,40 +766,39 @@ UniValue gettxout(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() < 2 || params.size() > 3)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"gettxout \"txid\" n ( includemempool )\n"
|
|
|
|
|
"\nReturns details about an unspent transaction output.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id\n"
|
|
|
|
|
"2. n (numeric, required) vout number\n"
|
|
|
|
|
"3. includemempool (boolean, optional) Whether to include the mempool\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"bestblock\" : \"hash\", (string) the block hash\n"
|
|
|
|
|
" \"confirmations\" : n, (numeric) The number of confirmations\n"
|
|
|
|
|
" \"value\" : x.xxx, (numeric) The transaction value in " + CURRENCY_UNIT + "\n"
|
|
|
|
|
" \"scriptPubKey\" : { (json object)\n"
|
|
|
|
|
" \"asm\" : \"code\", (string) \n"
|
|
|
|
|
" \"hex\" : \"hex\", (string) \n"
|
|
|
|
|
" \"reqSigs\" : n, (numeric) Number of required signatures\n"
|
|
|
|
|
" \"type\" : \"pubkeyhash\", (string) The type, eg pubkeyhash\n"
|
|
|
|
|
" \"addresses\" : [ (array of string) array of blackcoin addresses\n"
|
|
|
|
|
" \"blackcoinaddress\" (string) blackcoin address\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
" ]\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" \"version\" : n, (numeric) The version\n"
|
|
|
|
|
" \"coinbase\" : true|false (boolean) Coinbase or not\n"
|
|
|
|
|
" \"coinstake\" : true|false (boolean) Coinstake or not\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"gettxout \"txid\" n ( includemempool )\n"
|
|
|
|
|
"\nReturns details about an unspent transaction output.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. \"txid\" (string, required) The transaction id\n"
|
|
|
|
|
"2. n (numeric, required) vout number\n"
|
|
|
|
|
"3. includemempool (boolean, optional) Whether to include the mem pool\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"bestblock\" : \"hash\", (string) the block hash\n"
|
|
|
|
|
" \"confirmations\" : n, (numeric) The number of confirmations\n"
|
|
|
|
|
" \"value\" : x.xxx, (numeric) The transaction value in " + CURRENCY_UNIT + "\n"
|
|
|
|
|
" \"scriptPubKey\" : { (json object)\n"
|
|
|
|
|
" \"asm\" : \"code\", (string) \n"
|
|
|
|
|
" \"hex\" : \"hex\", (string) \n"
|
|
|
|
|
" \"reqSigs\" : n, (numeric) Number of required signatures\n"
|
|
|
|
|
" \"type\" : \"pubkeyhash\", (string) The type, eg pubkeyhash\n"
|
|
|
|
|
" \"addresses\" : [ (array of string) array of navcoin addresses\n"
|
|
|
|
|
" \"navcoinaddress\" (string) navcoin address\n"
|
|
|
|
|
" ,...\n"
|
|
|
|
|
" ]\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" \"version\" : n, (numeric) The version\n"
|
|
|
|
|
" \"coinbase\" : true|false (boolean) Coinbase or not\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
"\nGet unspent transactions\n"
|
|
|
|
|
+ HelpExampleCli("listunspent", "") +
|
|
|
|
|
"\nView the details\n"
|
|
|
|
|
+ HelpExampleCli("gettxout", "\"txid\" 1") +
|
|
|
|
|
"\nAs a json rpc call\n"
|
|
|
|
|
+ HelpExampleRpc("gettxout", "\"txid\", 1")
|
|
|
|
|
);
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
"\nGet unspent transactions\n"
|
|
|
|
|
+ HelpExampleCli("listunspent", "") +
|
|
|
|
|
"\nView the details\n"
|
|
|
|
|
+ HelpExampleCli("gettxout", "\"txid\" 1") +
|
|
|
|
|
"\nAs a json rpc call\n"
|
|
|
|
|
+ HelpExampleRpc("gettxout", "\"txid\", 1")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -850,17 +849,17 @@ UniValue verifychain(const UniValue& params, bool fHelp)
|
|
|
|
|
int nCheckDepth = GetArg("-checkblocks", DEFAULT_CHECKBLOCKS);
|
|
|
|
|
if (fHelp || params.size() > 2)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"verifychain ( checklevel numblocks )\n"
|
|
|
|
|
"\nVerifies blockchain database.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. checklevel (numeric, optional, 0-4, default=" + strprintf("%d", nCheckLevel) + ") How thorough the block verification is.\n"
|
|
|
|
|
"2. numblocks (numeric, optional, default=" + strprintf("%d", nCheckDepth) + ", 0=all) The number of blocks to check.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"true|false (boolean) Verified or not\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("verifychain", "")
|
|
|
|
|
+ HelpExampleRpc("verifychain", "")
|
|
|
|
|
);
|
|
|
|
|
"verifychain ( checklevel numblocks )\n"
|
|
|
|
|
"\nVerifies blockchain database.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. checklevel (numeric, optional, 0-4, default=" + strprintf("%d", nCheckLevel) + ") How thorough the block verification is.\n"
|
|
|
|
|
"2. numblocks (numeric, optional, default=" + strprintf("%d", nCheckDepth) + ", 0=all) The number of blocks to check.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"true|false (boolean) Verified or not\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("verifychain", "")
|
|
|
|
|
+ HelpExampleRpc("verifychain", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -935,49 +934,49 @@ UniValue getblockchaininfo(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 0)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getblockchaininfo\n"
|
|
|
|
|
"Returns an object containing various state info regarding block chain processing.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"chain\": \"xxxx\", (string) current network name as defined in BIP70 (main, test, regtest)\n"
|
|
|
|
|
" \"blocks\": xxxxxx, (numeric) the current number of blocks processed in the server\n"
|
|
|
|
|
" \"headers\": xxxxxx, (numeric) the current number of headers we have validated\n"
|
|
|
|
|
" \"bestblockhash\": \"...\", (string) the hash of the currently best block\n"
|
|
|
|
|
"getblockchaininfo\n"
|
|
|
|
|
"Returns an object containing various state info regarding block chain processing.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"chain\": \"xxxx\", (string) current network name as defined in BIP70 (main, test, regtest)\n"
|
|
|
|
|
" \"blocks\": xxxxxx, (numeric) the current number of blocks processed in the server\n"
|
|
|
|
|
" \"headers\": xxxxxx, (numeric) the current number of headers we have validated\n"
|
|
|
|
|
" \"bestblockhash\": \"...\", (string) the hash of the currently best block\n"
|
|
|
|
|
" \"difficulty\": { (json object)\n"
|
|
|
|
|
" \"proof-of-work\": xxxxxx, (numeric) the current proof-of-work difficulty\n"
|
|
|
|
|
" \"proof-of-stake\": xxxxxx (numeric) the current proof-of-stake difficulty\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" \"mediantime\": xxxxxx, (numeric) median time for the current best block\n"
|
|
|
|
|
" \"verificationprogress\": xxxx, (numeric) estimate of verification progress [0..1]\n"
|
|
|
|
|
" \"chainwork\": \"xxxx\" (string) total amount of work in active chain, in hexadecimal\n"
|
|
|
|
|
" \"pruned\": xx, (boolean) if the blocks are subject to pruning\n"
|
|
|
|
|
" \"pruneheight\": xxxxxx, (numeric) lowest-height complete block stored\n"
|
|
|
|
|
" \"softforks\": [ (array) status of softforks in progress\n"
|
|
|
|
|
" {\n"
|
|
|
|
|
" \"id\": \"xxxx\", (string) name of softfork\n"
|
|
|
|
|
" \"version\": xx, (numeric) block version\n"
|
|
|
|
|
" \"enforce\": { (object) progress toward enforcing the softfork rules for new-version blocks\n"
|
|
|
|
|
" \"status\": xx, (boolean) true if threshold reached\n"
|
|
|
|
|
" \"found\": xx, (numeric) number of blocks with the new version found\n"
|
|
|
|
|
" \"required\": xx, (numeric) number of blocks required to trigger\n"
|
|
|
|
|
" \"window\": xx, (numeric) maximum size of examined window of recent blocks\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" \"reject\": { ... } (object) progress toward rejecting pre-softfork blocks (same fields as \"enforce\")\n"
|
|
|
|
|
" }, ...\n"
|
|
|
|
|
" ],\n"
|
|
|
|
|
" \"bip9_softforks\": { (object) status of BIP9 softforks in progress\n"
|
|
|
|
|
" \"xxxx\" : { (string) name of the softfork\n"
|
|
|
|
|
" \"status\": \"xxxx\", (string) one of \"defined\", \"started\", \"locked_in\", \"active\", \"failed\"\n"
|
|
|
|
|
" \"bit\": xx, (numeric) the bit (0-28) in the block version field used to signal this softfork (only for \"started\" status)\n"
|
|
|
|
|
" \"startTime\": xx, (numeric) the minimum median time past of a block at which the bit gains its meaning\n"
|
|
|
|
|
" \"timeout\": xx (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in\n"
|
|
|
|
|
" }\n"
|
|
|
|
|
" }\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockchaininfo", "")
|
|
|
|
|
+ HelpExampleRpc("getblockchaininfo", "")
|
|
|
|
|
);
|
|
|
|
|
" \"mediantime\": xxxxxx, (numeric) median time for the current best block\n"
|
|
|
|
|
" \"verificationprogress\": xxxx, (numeric) estimate of verification progress [0..1]\n"
|
|
|
|
|
" \"chainwork\": \"xxxx\" (string) total amount of work in active chain, in hexadecimal\n"
|
|
|
|
|
" \"pruned\": xx, (boolean) if the blocks are subject to pruning\n"
|
|
|
|
|
" \"pruneheight\": xxxxxx, (numeric) heighest block available\n"
|
|
|
|
|
" \"softforks\": [ (array) status of softforks in progress\n"
|
|
|
|
|
" {\n"
|
|
|
|
|
" \"id\": \"xxxx\", (string) name of softfork\n"
|
|
|
|
|
" \"version\": xx, (numeric) block version\n"
|
|
|
|
|
" \"enforce\": { (object) progress toward enforcing the softfork rules for new-version blocks\n"
|
|
|
|
|
" \"status\": xx, (boolean) true if threshold reached\n"
|
|
|
|
|
" \"found\": xx, (numeric) number of blocks with the new version found\n"
|
|
|
|
|
" \"required\": xx, (numeric) number of blocks required to trigger\n"
|
|
|
|
|
" \"window\": xx, (numeric) maximum size of examined window of recent blocks\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" \"reject\": { ... } (object) progress toward rejecting pre-softfork blocks (same fields as \"enforce\")\n"
|
|
|
|
|
" }, ...\n"
|
|
|
|
|
" ],\n"
|
|
|
|
|
" \"bip9_softforks\": { (object) status of BIP9 softforks in progress\n"
|
|
|
|
|
" \"xxxx\" : { (string) name of the softfork\n"
|
|
|
|
|
" \"status\": \"xxxx\", (string) one of \"defined\", \"started\", \"locked_in\", \"active\", \"failed\"\n"
|
|
|
|
|
" \"bit\": xx, (numeric) the bit (0-28) in the block version field used to signal this softfork (only for \"started\" status)\n"
|
|
|
|
|
" \"startTime\": xx, (numeric) the minimum median time past of a block at which the bit gains its meaning\n"
|
|
|
|
|
" \"timeout\": xx (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in\n"
|
|
|
|
|
" }\n"
|
|
|
|
|
" }\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getblockchaininfo", "")
|
|
|
|
|
+ HelpExampleRpc("getblockchaininfo", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
@@ -1034,39 +1033,39 @@ UniValue getchaintips(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 0)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getchaintips\n"
|
|
|
|
|
"Return information about all known tips in the block tree,"
|
|
|
|
|
" including the main chain as well as orphaned branches.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"[\n"
|
|
|
|
|
" {\n"
|
|
|
|
|
" \"height\": xxxx, (numeric) height of the chain tip\n"
|
|
|
|
|
" \"hash\": \"xxxx\", (string) block hash of the tip\n"
|
|
|
|
|
" \"branchlen\": 0 (numeric) zero for main chain\n"
|
|
|
|
|
" \"status\": \"active\" (string) \"active\" for the main chain\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" {\n"
|
|
|
|
|
" \"height\": xxxx,\n"
|
|
|
|
|
" \"hash\": \"xxxx\",\n"
|
|
|
|
|
" \"branchlen\": 1 (numeric) length of branch connecting the tip to the main chain\n"
|
|
|
|
|
" \"status\": \"xxxx\" (string) status of the chain (active, valid-fork, valid-headers, headers-only, invalid)\n"
|
|
|
|
|
" }\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"Possible values for status:\n"
|
|
|
|
|
"1. \"invalid\" This branch contains at least one invalid block\n"
|
|
|
|
|
"2. \"headers-only\" Not all blocks for this branch are available, but the headers are valid\n"
|
|
|
|
|
"3. \"valid-headers\" All blocks are available for this branch, but they were never fully validated\n"
|
|
|
|
|
"4. \"valid-fork\" This branch is not part of the active chain, but is fully validated\n"
|
|
|
|
|
"5. \"active\" This is the tip of the active main chain, which is certainly valid\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getchaintips", "")
|
|
|
|
|
+ HelpExampleRpc("getchaintips", "")
|
|
|
|
|
);
|
|
|
|
|
"getchaintips\n"
|
|
|
|
|
"Return information about all known tips in the block tree,"
|
|
|
|
|
" including the main chain as well as orphaned branches.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"[\n"
|
|
|
|
|
" {\n"
|
|
|
|
|
" \"height\": xxxx, (numeric) height of the chain tip\n"
|
|
|
|
|
" \"hash\": \"xxxx\", (string) block hash of the tip\n"
|
|
|
|
|
" \"branchlen\": 0 (numeric) zero for main chain\n"
|
|
|
|
|
" \"status\": \"active\" (string) \"active\" for the main chain\n"
|
|
|
|
|
" },\n"
|
|
|
|
|
" {\n"
|
|
|
|
|
" \"height\": xxxx,\n"
|
|
|
|
|
" \"hash\": \"xxxx\",\n"
|
|
|
|
|
" \"branchlen\": 1 (numeric) length of branch connecting the tip to the main chain\n"
|
|
|
|
|
" \"status\": \"xxxx\" (string) status of the chain (active, valid-fork, valid-headers, headers-only, invalid)\n"
|
|
|
|
|
" }\n"
|
|
|
|
|
"]\n"
|
|
|
|
|
"Possible values for status:\n"
|
|
|
|
|
"1. \"invalid\" This branch contains at least one invalid block\n"
|
|
|
|
|
"2. \"headers-only\" Not all blocks for this branch are available, but the headers are valid\n"
|
|
|
|
|
"3. \"valid-headers\" All blocks are available for this branch, but they were never fully validated\n"
|
|
|
|
|
"4. \"valid-fork\" This branch is not part of the active chain, but is fully validated\n"
|
|
|
|
|
"5. \"active\" This is the tip of the active main chain, which is certainly valid\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getchaintips", "")
|
|
|
|
|
+ HelpExampleRpc("getchaintips", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
LOCK(cs_main);
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Idea: the set of chain tips is chainActive.tip, plus orphan blocks which do not have another orphan building off of them.
|
|
|
|
|
* Idea: the set of chain tips is chainActive.tip, plus orphan blocks which do not have another orphan building off of them.
|
|
|
|
|
* Algorithm:
|
|
|
|
|
* - Make one pass through mapBlockIndex, picking out the orphan blocks, and also storing a set of the orphan block's pprev pointers.
|
|
|
|
|
* - Iterate through the orphan blocks. If the block isn't pointed to by another orphan, it is a chain tip.
|
|
|
|
|
@@ -1150,20 +1149,20 @@ UniValue getmempoolinfo(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 0)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"getmempoolinfo\n"
|
|
|
|
|
"\nReturns details on the active state of the TX memory pool.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"size\": xxxxx, (numeric) Current tx count\n"
|
|
|
|
|
" \"bytes\": xxxxx, (numeric) Sum of all tx sizes\n"
|
|
|
|
|
" \"usage\": xxxxx, (numeric) Total memory usage for the mempool\n"
|
|
|
|
|
" \"maxmempool\": xxxxx, (numeric) Maximum memory usage for the mempool\n"
|
|
|
|
|
" \"mempoolminfee\": xxxxx (numeric) Minimum fee for tx to be accepted\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getmempoolinfo", "")
|
|
|
|
|
+ HelpExampleRpc("getmempoolinfo", "")
|
|
|
|
|
);
|
|
|
|
|
"getmempoolinfo\n"
|
|
|
|
|
"\nReturns details on the active state of the TX memory pool.\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"{\n"
|
|
|
|
|
" \"size\": xxxxx, (numeric) Current tx count\n"
|
|
|
|
|
" \"bytes\": xxxxx, (numeric) Sum of all tx sizes\n"
|
|
|
|
|
" \"usage\": xxxxx, (numeric) Total memory usage for the mempool\n"
|
|
|
|
|
" \"maxmempool\": xxxxx, (numeric) Maximum memory usage for the mempool\n"
|
|
|
|
|
" \"mempoolminfee\": xxxxx (numeric) Minimum fee for tx to be accepted\n"
|
|
|
|
|
"}\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("getmempoolinfo", "")
|
|
|
|
|
+ HelpExampleRpc("getmempoolinfo", "")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
return mempoolInfoToJSON();
|
|
|
|
|
}
|
|
|
|
|
@@ -1172,15 +1171,15 @@ UniValue invalidateblock(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 1)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"invalidateblock \"hash\"\n"
|
|
|
|
|
"\nPermanently marks a block as invalid, as if it violated a consensus rule.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. hash (string, required) the hash of the block to mark as invalid\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("invalidateblock", "\"blockhash\"")
|
|
|
|
|
+ HelpExampleRpc("invalidateblock", "\"blockhash\"")
|
|
|
|
|
);
|
|
|
|
|
"invalidateblock \"hash\"\n"
|
|
|
|
|
"\nPermanently marks a block as invalid, as if it violated a consensus rule.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. hash (string, required) the hash of the block to mark as invalid\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("invalidateblock", "\"blockhash\"")
|
|
|
|
|
+ HelpExampleRpc("invalidateblock", "\"blockhash\"")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
std::string strHash = params[0].get_str();
|
|
|
|
|
uint256 hash(uint256S(strHash));
|
|
|
|
|
@@ -1210,16 +1209,16 @@ UniValue reconsiderblock(const UniValue& params, bool fHelp)
|
|
|
|
|
{
|
|
|
|
|
if (fHelp || params.size() != 1)
|
|
|
|
|
throw runtime_error(
|
|
|
|
|
"reconsiderblock \"hash\"\n"
|
|
|
|
|
"\nRemoves invalidity status of a block and its descendants, reconsider them for activation.\n"
|
|
|
|
|
"This can be used to undo the effects of invalidateblock.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. hash (string, required) the hash of the block to reconsider\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("reconsiderblock", "\"blockhash\"")
|
|
|
|
|
+ HelpExampleRpc("reconsiderblock", "\"blockhash\"")
|
|
|
|
|
);
|
|
|
|
|
"reconsiderblock \"hash\"\n"
|
|
|
|
|
"\nRemoves invalidity status of a block and its descendants, reconsider them for activation.\n"
|
|
|
|
|
"This can be used to undo the effects of invalidateblock.\n"
|
|
|
|
|
"\nArguments:\n"
|
|
|
|
|
"1. hash (string, required) the hash of the block to reconsider\n"
|
|
|
|
|
"\nResult:\n"
|
|
|
|
|
"\nExamples:\n"
|
|
|
|
|
+ HelpExampleCli("reconsiderblock", "\"blockhash\"")
|
|
|
|
|
+ HelpExampleRpc("reconsiderblock", "\"blockhash\"")
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
std::string strHash = params[0].get_str();
|
|
|
|
|
uint256 hash(uint256S(strHash));
|
|
|
|
|
@@ -1246,26 +1245,26 @@ UniValue reconsiderblock(const UniValue& params, bool fHelp)
|
|
|
|
|
static const CRPCCommand commands[] =
|
|
|
|
|
{ // category name actor (function) okSafeMode
|
|
|
|
|
// --------------------- ------------------------ ----------------------- ----------
|
|
|
|
|
{ "blockchain", "getblockchaininfo", &getblockchaininfo, true },
|
|
|
|
|
{ "blockchain", "getbestblockhash", &getbestblockhash, true },
|
|
|
|
|
{ "blockchain", "getblockcount", &getblockcount, true },
|
|
|
|
|
{ "blockchain", "getblock", &getblock, true },
|
|
|
|
|
{ "blockchain", "getblockhash", &getblockhash, true },
|
|
|
|
|
{ "blockchain", "getblockheader", &getblockheader, true },
|
|
|
|
|
{ "blockchain", "getchaintips", &getchaintips, true },
|
|
|
|
|
{ "blockchain", "getdifficulty", &getdifficulty, true },
|
|
|
|
|
{ "blockchain", "getmempoolancestors", &getmempoolancestors, true },
|
|
|
|
|
{ "blockchain", "getmempooldescendants", &getmempooldescendants, true },
|
|
|
|
|
{ "blockchain", "getmempoolentry", &getmempoolentry, true },
|
|
|
|
|
{ "blockchain", "getmempoolinfo", &getmempoolinfo, true },
|
|
|
|
|
{ "blockchain", "getrawmempool", &getrawmempool, true },
|
|
|
|
|
{ "blockchain", "gettxout", &gettxout, true },
|
|
|
|
|
{ "blockchain", "gettxoutsetinfo", &gettxoutsetinfo, true },
|
|
|
|
|
{ "blockchain", "verifychain", &verifychain, true },
|
|
|
|
|
{ "blockchain", "getblockchaininfo", &getblockchaininfo, true },
|
|
|
|
|
{ "blockchain", "getbestblockhash", &getbestblockhash, true },
|
|
|
|
|
{ "blockchain", "getblockcount", &getblockcount, true },
|
|
|
|
|
{ "blockchain", "getblock", &getblock, true },
|
|
|
|
|
{ "blockchain", "getblockhash", &getblockhash, true },
|
|
|
|
|
{ "blockchain", "getblockheader", &getblockheader, true },
|
|
|
|
|
{ "blockchain", "getchaintips", &getchaintips, true },
|
|
|
|
|
{ "blockchain", "getdifficulty", &getdifficulty, true },
|
|
|
|
|
{ "blockchain", "getmempoolancestors", &getmempoolancestors, true },
|
|
|
|
|
{ "blockchain", "getmempooldescendants", &getmempooldescendants, true },
|
|
|
|
|
{ "blockchain", "getmempoolentry", &getmempoolentry, true },
|
|
|
|
|
{ "blockchain", "getmempoolinfo", &getmempoolinfo, true },
|
|
|
|
|
{ "blockchain", "getrawmempool", &getrawmempool, true },
|
|
|
|
|
{ "blockchain", "gettxout", &gettxout, true },
|
|
|
|
|
{ "blockchain", "gettxoutsetinfo", &gettxoutsetinfo, true },
|
|
|
|
|
{ "blockchain", "verifychain", &verifychain, true },
|
|
|
|
|
|
|
|
|
|
/* Not shown in help */
|
|
|
|
|
{ "hidden", "invalidateblock", &invalidateblock, true },
|
|
|
|
|
{ "hidden", "reconsiderblock", &reconsiderblock, true },
|
|
|
|
|
/* Not shown in help */
|
|
|
|
|
{ "hidden", "invalidateblock", &invalidateblock, true },
|
|
|
|
|
{ "hidden", "reconsiderblock", &reconsiderblock, true },
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
void RegisterBlockchainRPCCommands(CRPCTable &tableRPC)
|
|
|
|
|
|