rpc: include help text for addressindex and related commands

This commit is contained in:
Braydon Fuller 2016-05-11 18:33:22 -04:00 committed by Simon
parent f83d3fe7a8
commit d723656d79
2 changed files with 93 additions and 12 deletions

View File

@ -323,10 +323,12 @@ UniValue getblockhashes(const UniValue& params, bool fHelp)
"1. high (numeric, required) The newer block timestamp\n" "1. high (numeric, required) The newer block timestamp\n"
"2. low (numeric, required) The older block timestamp\n" "2. low (numeric, required) The older block timestamp\n"
"\nResult:\n" "\nResult:\n"
"[" "[\n"
" \"hash\" (string) The block hash\n" " \"hash\" (string) The block hash\n"
"]" "]\n"
"\nExamples:\n" "\nExamples:\n"
+ HelpExampleCli("getblockhashes", "1231614698 1231024505")
+ HelpExampleRpc("getblockhashes", "1231614698, 1231024505")
); );
unsigned int high = params[0].get_int(); unsigned int high = params[0].get_int();

View File

@ -576,7 +576,30 @@ UniValue getaddressmempool(const UniValue& params, bool fHelp)
throw runtime_error( throw runtime_error(
"getaddressmempool\n" "getaddressmempool\n"
"\nReturns all mempool deltas for an address (requires addressindex to be enabled).\n" "\nReturns all mempool deltas for an address (requires addressindex to be enabled).\n"
); "\nArguments:\n"
"{\n"
" \"addresses\"\n"
" [\n"
" \"address\" (string) The base58check encoded address\n"
" ,...\n"
" ]\n"
"}\n"
"\nResult:\n"
"[\n"
" {\n"
" \"address\" (string) The base58check encoded address\n"
" \"txid\" (string) The related txid\n"
" \"index\" (number) The related input or output index\n"
" \"satoshis\" (number) The difference of satoshis\n"
" \"timestamp\" (number) The time the transaction entered the mempool (seconds)\n"
" \"prevtxid\" (string) The previous txid (if spending)\n"
" \"prevout\" (string) The previous transaction output index (if spending)\n"
" }\n"
"]\n"
"\nExamples:\n"
+ HelpExampleCli("getaddressmempool", "'{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}'")
+ HelpExampleRpc("getaddressmempool", "{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}")
);
std::vector<std::pair<uint160, int> > addresses; std::vector<std::pair<uint160, int> > addresses;
@ -624,6 +647,14 @@ UniValue getaddressutxos(const UniValue& params, bool fHelp)
throw runtime_error( throw runtime_error(
"getaddressutxos\n" "getaddressutxos\n"
"\nReturns all unspent outputs for an address (requires addressindex to be enabled).\n" "\nReturns all unspent outputs for an address (requires addressindex to be enabled).\n"
"\nArguments:\n"
"{\n"
" \"addresses\"\n"
" [\n"
" \"address\" (string) The base58check encoded address\n"
" ,...\n"
" ]\n"
"}\n"
"\nResult\n" "\nResult\n"
"[\n" "[\n"
" {\n" " {\n"
@ -635,7 +666,10 @@ UniValue getaddressutxos(const UniValue& params, bool fHelp)
" \"satoshis\" (number) The number of satoshis of the output\n" " \"satoshis\" (number) The number of satoshis of the output\n"
" }\n" " }\n"
"]\n" "]\n"
); "\nExamples:\n"
+ HelpExampleCli("getaddressutxos", "'{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}'")
+ HelpExampleRpc("getaddressutxos", "{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}")
);
std::vector<std::pair<uint160, int> > addresses; std::vector<std::pair<uint160, int> > addresses;
@ -680,7 +714,17 @@ UniValue getaddressdeltas(const UniValue& params, bool fHelp)
throw runtime_error( throw runtime_error(
"getaddressdeltas\n" "getaddressdeltas\n"
"\nReturns all changes for an address (requires addressindex to be enabled).\n" "\nReturns all changes for an address (requires addressindex to be enabled).\n"
"\nResult\n" "\nArguments:\n"
"{\n"
" \"addresses\"\n"
" [\n"
" \"address\" (string) The base58check encoded address\n"
" ,...\n"
" ]\n"
" \"start\" (number) The start block height\n"
" \"end\" (number) The end block height\n"
"}\n"
"\nResult:\n"
"[\n" "[\n"
" {\n" " {\n"
" \"satoshis\" (number) The difference of satoshis\n" " \"satoshis\" (number) The difference of satoshis\n"
@ -690,6 +734,9 @@ UniValue getaddressdeltas(const UniValue& params, bool fHelp)
" \"address\" (string) The base58check encoded address\n" " \"address\" (string) The base58check encoded address\n"
" }\n" " }\n"
"]\n" "]\n"
"\nExamples:\n"
+ HelpExampleCli("getaddressdeltas", "'{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}'")
+ HelpExampleRpc("getaddressdeltas", "{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}")
); );
@ -752,12 +799,23 @@ UniValue getaddressbalance(const UniValue& params, bool fHelp)
if (fHelp || params.size() != 1) if (fHelp || params.size() != 1)
throw runtime_error( throw runtime_error(
"getaddressbalance\n" "getaddressbalance\n"
"\nReturns the balance for an address (requires addressindex to be enabled).\n" "\nReturns the balance for an address(es) (requires addressindex to be enabled).\n"
"\nResult\n" "\nArguments:\n"
"{\n" "{\n"
" \"balance\" (string) The current balance\n" " \"addresses\"\n"
" ,...\n" " [\n"
" \"address\" (string) The base58check encoded address\n"
" ,...\n"
" ]\n"
"}\n" "}\n"
"\nResult:\n"
"{\n"
" \"balance\" (string) The current balance in satoshis\n"
" \"received\" (string) The total number of satoshis received (including change)\n"
"}\n"
"\nExamples:\n"
+ HelpExampleCli("getaddressbalance", "'{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}'")
+ HelpExampleRpc("getaddressbalance", "{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}")
); );
std::vector<std::pair<uint160, int> > addresses; std::vector<std::pair<uint160, int> > addresses;
@ -797,12 +855,25 @@ UniValue getaddresstxids(const UniValue& params, bool fHelp)
if (fHelp || params.size() != 1) if (fHelp || params.size() != 1)
throw runtime_error( throw runtime_error(
"getaddresstxids\n" "getaddresstxids\n"
"\nReturns the txids for an address (requires addressindex to be enabled).\n" "\nReturns the txids for an address(es) (requires addressindex to be enabled).\n"
"\nResult\n" "\nArguments:\n"
"{\n"
" \"addresses\"\n"
" [\n"
" \"address\" (string) The base58check encoded address\n"
" ,...\n"
" ]\n"
" \"start\" (number) The start block height\n"
" \"end\" (number) The end block height\n"
"}\n"
"\nResult:\n"
"[\n" "[\n"
" \"transactionid\" (string) The transaction id\n" " \"transactionid\" (string) The transaction id\n"
" ,...\n" " ,...\n"
"]\n" "]\n"
"\nExamples:\n"
+ HelpExampleCli("getaddresstxids", "'{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}'")
+ HelpExampleRpc("getaddresstxids", "{\"addresses\": [\"12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX\"]}")
); );
std::vector<std::pair<uint160, int> > addresses; std::vector<std::pair<uint160, int> > addresses;
@ -869,12 +940,20 @@ UniValue getspentinfo(const UniValue& params, bool fHelp)
throw runtime_error( throw runtime_error(
"getspentinfo\n" "getspentinfo\n"
"\nReturns the txid and index where an output is spent.\n" "\nReturns the txid and index where an output is spent.\n"
"\nResult\n" "\nArguments:\n"
"{\n"
" \"txid\" (string) The hex string of the txid\n"
" \"index\" (number) The start block height\n"
"}\n"
"\nResult:\n"
"{\n" "{\n"
" \"txid\" (string) The transaction id\n" " \"txid\" (string) The transaction id\n"
" \"index\" (number) The spending input index\n" " \"index\" (number) The spending input index\n"
" ,...\n" " ,...\n"
"}\n" "}\n"
"\nExamples:\n"
+ HelpExampleCli("getspentinfo", "'{\"txid\": \"0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9\", \"index\": 0}'")
+ HelpExampleRpc("getspentinfo", "{\"txid\": \"0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9\", \"index\": 0}")
); );
UniValue txidValue = find_value(params[0].get_obj(), "txid"); UniValue txidValue = find_value(params[0].get_obj(), "txid");