// Copyright (c) 2015 The btcsuite developers

// Copyright (c) 2015-2016 The Decred developers

// Use of this source code is governed by an ISC

// license that can be found in the LICENSE file.

package main

import (

"errors"

"sort"

"strings"

"sync"

"github.com/decred/dcrd/dcrjson"

)

// helpDescsEnUS defines the English descriptions used for the help strings.

var helpDescsEnUS = map[string]string{

// DebugLevelCmd help.

"debuglevel--synopsis": "Dynamically changes the debug logging level.\n" +

"The levelspec can either a debug level or of the form:\n" +

"<subsystem>=<level>,<subsystem2>=<level2>,...\n" +

"The valid debug levels are trace, debug, info, warn, error, and critical.\n" +

"The valid subsystems are AMGR, ADXR, BCDB, BMGR, DCRD, CHAN, DISC, PEER, RPCS, SCRP, SRVR, and TXMP.\n" +

"Finally the keyword 'show' will return a list of the available subsystems.",

"debuglevel-levelspec": "The debug level(s) to use or the keyword 'show'",

"debuglevel--condition0": "levelspec!=show",

"debuglevel--condition1": "levelspec=show",

"debuglevel--result0": "The string 'Done.'",

"debuglevel--result1": "The list of subsystems",

// AddNodeCmd help.

"addnode--synopsis": "Attempts to add or remove a persistent peer.",

"addnode-addr": "IP address and port of the peer to operate on",

"addnode-subcmd": "'add' to add a persistent peer, 'remove' to remove a persistent peer, or 'onetry' to try a single connection to a peer",

// NodeCmd help.

"node--synopsis": "Attempts to add or remove a peer.",

"node-subcmd": "'disconnect' to remove all matching non-persistent peers, 'remove' to remove a persistent peer, or 'connect' to connect to a peer",

"node-target": "Either the IP address and port of the peer to operate on, or a valid peer ID.",

"node-connectsubcmd": "'perm' to make the connected peer a permanent one, 'temp' to try a single connect to a peer",

// TransactionInput help.

"transactioninput-txid": "The hash of the input transaction",

"transactioninput-vout": "The specific output of the input transaction to redeem",

"transactioninput-tree": "The tree that the transaction input is located",

// TODO review cmd help messages for stake stuff

// CreateRawSSTxCmd help.

"createrawsstx--synopsis": "Returns a new transaction spending the provided inputs and sending to the provided addresses.\n" +

"The transaction inputs are not signed in the created transaction.\n" +

"The signrawtransaction RPC command provided by wallet must be used to sign the resulting transaction.",

"createrawsstx--result0": "Hex-encoded bytes of the serialized transaction",

"createrawsstx-inputs": "The inputs to the transaction of type sstxinput",

"sstxinput-txid": "Unspent tx output hash",

"sstxinput-vout": "Amount of utxo",

"sstxinput-amt": "Amount of utxu",

"sstxinput-tree": "Which tree utxo is located",

"createrawsstx-amount": "JSON object with the destination addresses as keys and amounts as values",

"createrawsstx-amount--key": "address",

"createrawsstx-amount--value": "n.nnn",

"createrawsstx-amount--desc": "The destination address as the key and the amount in DCR as the value",

"createrawsstx-couts": "Array of sstx commit outs to use of type SSTxCommitOut",

"sstxcommitout-addr": "Address to send sstx commit",

"sstxcommitout-commitamt": "Amount to commit",

"sstxcommitout-changeamt": "Amount for change",

"sstxcommitout-changeaddr": "Address for change",

// CreateRawSSGenTxCmd help.

"createrawssgentx--synopsis": "Returns a new transaction spending the provided inputs and sending to the provided addresses.\n" +

"The transaction inputs are not signed in the created transaction.\n" +

"The signrawtransaction RPC command provided by wallet must be used to sign the resulting transaction.",

"createrawssgentx--result0": "Hex-encoded bytes of the serialized transaction",

"createrawssgentx-inputs": "The inputs to the transaction of type sstxinput",

"createrawssgentx-votebits": "The inputs to the transaction of type sstxinput",

// CreateRawSSGenTxCmd help.

"createrawssrtx--synopsis": "Returns a new transaction spending the provided inputs and sending to the provided addresses.\n" +

"The transaction inputs are not signed in the created transaction.\n" +

"The signrawtransaction RPC command provided by wallet must be used to sign the resulting transaction.",

"createrawssrtx--result0": "Hex-encoded bytes of the serialized transaction",

"createrawssrtx-inputs": "The inputs to the transaction of type sstxinput",

// CreateRawTransactionCmd help.

"createrawtransaction--synopsis": "Returns a new transaction spending the provided inputs and sending to the provided addresses.\n" +

"The transaction inputs are not signed in the created transaction.\n" +

"The signrawtransaction RPC command provided by wallet must be used to sign the resulting transaction.",

"createrawtransaction-inputs": "The inputs to the transaction",

"createrawtransaction-amounts": "JSON object with the destination addresses as keys and amounts as values",

"createrawtransaction-amounts--key": "address",

"createrawtransaction-amounts--value": "n.nnn",

"createrawtransaction-amounts--desc": "The destination address as the key and the amount in DCR as the value",

"createrawtransaction--result0": "Hex-encoded bytes of the serialized transaction",

// ScriptSig help.

"scriptsig-asm": "Disassembly of the script",

"scriptsig-hex": "Hex-encoded bytes of the script",

// Vin help.

"vin-coinbase": "The hex-encoded bytes of the signature script (coinbase txns only)",

"vin-txid": "The hash of the origin transaction (non-coinbase txns only)",

"vin-vout": "The index of the output being redeemed from the origin transaction (non-coinbase txns only)",

"vin-scriptSig": "The signature script used to redeem the origin transaction as a JSON object (non-coinbase txns only)",

"vin-sequence": "The script sequence number",

"vin-tree": "The tree of the transaction",

"vin-blockindex": "The block idx of the origin transaction",

"vin-blockheight": "The block height of the origin transaction",

"vin-amountin": "The amount in",

// ScriptPubKeyResult help.

"scriptpubkeyresult-asm": "Disassembly of the script",

"scriptpubkeyresult-hex": "Hex-encoded bytes of the script",

"scriptpubkeyresult-reqSigs": "The number of required signatures",

"scriptpubkeyresult-type": "The type of the script (e.g. 'pubkeyhash')",

"scriptpubkeyresult-addresses": "The decred addresses associated with this script",

// Vout help.

"vout-value": "The amount in DCR",

"vout-n": "The index of this transaction output",

"vout-scriptPubKey": "The public key script used to pay coins as a JSON object",

"vout-version": "The version of the vout",

// TxRawDecodeResult help.

"txrawdecoderesult-txid": "The hash of the transaction",

"txrawdecoderesult-version": "The transaction version",

"txrawdecoderesult-locktime": "The transaction lock time",

"txrawdecoderesult-vin": "The transaction inputs as JSON objects",

"txrawdecoderesult-vout": "The transaction outputs as JSON objects",

"txrawdecoderesult-expiry": "The transaction expiry",

// DecodeRawTransactionCmd help.

"decoderawtransaction--synopsis": "Returns a JSON object representing the provided serialized, hex-encoded transaction.",

"decoderawtransaction-hextx": "Serialized, hex-encoded transaction",

// DecodeScriptResult help.

"decodescriptresult-asm": "Disassembly of the script",

"decodescriptresult-reqSigs": "The number of required signatures",

"decodescriptresult-type": "The type of the script (e.g. 'pubkeyhash')",

"decodescriptresult-addresses": "The decred addresses associated with this script",

"decodescriptresult-p2sh": "The script hash for use in pay-to-script-hash transactions",

// DecodeScriptCmd help.

"decodescript--synopsis": "Returns a JSON object with information about the provided hex-encoded script.",

"decodescript-hexscript": "Hex-encoded script",

// ExistsAddressCmd help.

"existsaddress--synopsis": "Test for the existance of the provided address",

"existsaddress-address": "The address to check",

// ExistsAddressResult help.

"existsaddressresult-exists": "Bool showing if address exists or not",

// GenerateCmd help

"generate--synopsis": "Generates a set number of blocks (simnet or regtest only) and returns a JSON\n" +

" array of their hashes.",

"generate-numblocks": "Number of blocks to generate",

"generate--result0": "The hashes, in order, of blocks generated by the call",

// GetAddedNodeInfoResultAddr help.

"getaddednodeinforesultaddr-address": "The ip address for this DNS entry",

"getaddednodeinforesultaddr-connected": "The connection 'direction' (inbound/outbound/false)",

// GetAddedNodeInfoResult help.

"getaddednodeinforesult-addednode": "The ip address or domain of the added peer",

"getaddednodeinforesult-connected": "Whether or not the peer is currently connected",

"getaddednodeinforesult-addresses": "DNS lookup and connection information about the peer",

// GetAddedNodeInfo help.

"getaddednodeinfo--synopsis": "Returns information about manually added (persistent) peers.",

"getaddednodeinfo-dns": "Specifies whether the returned data is a JSON object including DNS and connection information, or just a list of added peers",

"getaddednodeinfo-node": "Only return information about this specific peer instead of all added peers",

"getaddednodeinfo--condition0": "dns=false",

"getaddednodeinfo--condition1": "dns=true",

"getaddednodeinfo--result0": "List of added peers",

// GetBestBlockResult help.

"getbestblockresult-hash": "Hex-encoded bytes of the best block hash",

"getbestblockresult-height": "Height of the best block",

// GetBestBlockCmd help.

"getbestblock--synopsis": "Get block height and hash of best block in the main chain.",

"getbestblock--result0": "Get block height and hash of best block in the main chain.",

// GetBestBlockHashCmd help.

"getbestblockhash--synopsis": "Returns the hash of the of the best (most recent) block in the longest block chain.",

"getbestblockhash--result0": "The hex-encoded block hash",

// GetBlockCmd help.

"getblock--synopsis": "Returns information about a block given its hash.",

"getblock-hash": "The hash of the block",

"getblock-verbose": "Specifies the block is returned as a JSON object instead of hex-encoded string",

"getblock-verbosetx": "Specifies that each transaction is returned as a JSON object and only applies if the verbose flag is true (dcrd extension)",

"getblock--condition0": "verbose=false",

"getblock--condition1": "verbose=true",

"getblock--result0": "Hex-encoded bytes of the serialized block",

"getblockverboseresult-extradata": "Extra data field for the requested block",

// TxRawResult help.

"txrawresult-hex": "Hex-encoded transaction",

"txrawresult-txid": "The hash of the transaction",

"txrawresult-version": "The transaction version",

"txrawresult-locktime": "The transaction lock time",

"txrawresult-vin": "The transaction inputs as JSON objects",

"txrawresult-vout": "The transaction outputs as JSON objects",

"txrawresult-blockhash": "Hash of the block the transaction is part of",

"txrawresult-confirmations": "Number of confirmations of the block",

"txrawresult-time": "Transaction time in seconds since 1 Jan 1970 GMT",

"txrawresult-blocktime": "Block time in seconds since the 1 Jan 1970 GMT",

"txrawresult-blockindex": "Index of the containing block.",

"txrawresult-blockheight": "Height of the block the transaction is part of",

"txrawresult-expiry": "The transacion expiry",

// GetBlockVerboseResult help.

"getblockverboseresult-hash": "The hash of the block (same as provided)",

"getblockverboseresult-confirmations": "The number of confirmations",

"getblockverboseresult-size": "The size of the block",

"getblockverboseresult-height": "The height of the block in the block chain",

"getblockverboseresult-version": "The block version",

"getblockverboseresult-merkleroot": "Root hash of the merkle tree",

"getblockverboseresult-tx": "The transaction hashes (only when verbosetx=false)",

"getblockverboseresult-rawtx": "The transactions as JSON objects (only when verbosetx=true)",

"getblockverboseresult-time": "The block time in seconds since 1 Jan 1970 GMT",

"getblockverboseresult-nonce": "The block nonce",

"getblockverboseresult-bits": "The bits which represent the block difficulty",

"getblockverboseresult-difficulty": "The proof-of-work difficulty as a multiple of the minimum difficulty",

"getblockverboseresult-previousblockhash": "The hash of the previous block",

"getblockverboseresult-nextblockhash": "The hash of the next block (only if there is one)",

"getblockverboseresult-sbits": "The stake difficulty of theblock",

"getblockverboseresult-poolsize": "The total number of valid, spendable sstx (tickets) in the chain",

"getblockverboseresult-revocations": "The number of new ssrtx (tickets) of the given block",

"getblockverboseresult-freshstake": "The number of new sstx (tickets) of the given block",

"getblockverboseresult-voters": "The number of stake voters (ssgen) of the previous block",

"getblockverboseresult-potential": "The number of potential",

"getblockverboseresult-overflow": "The number of overflow",

"getblockverboseresult-winner": "The winning bucket to determine ssgen",

"getblockverboseresult-votebits": "The block's voting results",

"getblockverboseresult-rawstx": "The block's raw sstx hashes the were included",

"getblockverboseresult-stx": "The block's sstx hashes the were included",

"getblockverboseresult-stakeroot": "The block's sstx hashes the were included",

"getblockverboseresult-finalstate": "The block's finalstate",

// GetBlockCountCmd help.

"getblockcount--synopsis": "Returns the number of blocks in the longest block chain.",

"getblockcount--result0": "The current block count",

// GetBlockHashCmd help.

"getblockhash--synopsis": "Returns hash of the block in best block chain at the given height.",

"getblockhash-index": "The block height",

"getblockhash--result0": "The block hash",

// TemplateRequest help.

"templaterequest-mode": "This is 'template', 'proposal', or omitted",

"templaterequest-capabilities": "List of capabilities",

"templaterequest-longpollid": "The long poll ID of a job to monitor for expiration; required and valid only for long poll requests ",

"templaterequest-sigoplimit": "Number of signature operations allowed in blocks (this parameter is ignored)",

"templaterequest-sizelimit": "Number of bytes allowed in blocks (this parameter is ignored)",

"templaterequest-maxversion": "Highest supported block version number (this parameter is ignored)",

"templaterequest-target": "The desired target for the block template (this parameter is ignored)",

"templaterequest-data": "Hex-encoded block data (only for mode=proposal)",

"templaterequest-workid": "The server provided workid if provided in block template (not applicable)",

// GetBlockTemplateResultTx help.

"getblocktemplateresulttx-data": "Hex-encoded transaction data (byte-for-byte)",

"getblocktemplateresulttx-hash": "Hex-encoded transaction hash (little endian if treated as a 256-bit number)",

"getblocktemplateresulttx-depends": "Other transactions before this one (by 1-based index in the 'transactions' list) that must be present in the final block if this one is",

"getblocktemplateresulttx-fee": "Difference in value between transaction inputs and outputs (in Atoms)",

"getblocktemplateresulttx-sigops": "Total number of signature operations as counted for purposes of block limits",

"getblocktemplateresulttx-txtype": "Type of the transaction",

// GetBlockTemplateResultAux help.

"getblocktemplateresultaux-flags": "Hex-encoded byte-for-byte data to include in the coinbase signature script",

// GetBlockTemplateResult help.

"getblocktemplateresult-bits": "Hex-encoded compressed difficulty",

"getblocktemplateresult-curtime": "Current time as seen by the server (recommended for block time); must fall within mintime/maxtime rules",

"getblocktemplateresult-height": "Height of the block to be solved",

"getblocktemplateresult-previousblockhash": "Hex-encoded big-endian hash of the previous block",

"getblocktemplateresult-sigoplimit": "Number of sigops allowed in blocks ",

"getblocktemplateresult-sizelimit": "Number of bytes allowed in blocks",

"getblocktemplateresult-transactions": "Array of transactions as JSON objects",

"getblocktemplateresult-version": "The block version",

"getblocktemplateresult-coinbaseaux": "Data that should be included in the coinbase signature script",

"getblocktemplateresult-coinbasetxn": "Information about the coinbase transaction",

"getblocktemplateresult-coinbasevalue": "Total amount available for the coinbase in Atoms",

"getblocktemplateresult-workid": "This value must be returned with result if provided (not provided)",

"getblocktemplateresult-longpollid": "Identifier for long poll request which allows monitoring for expiration",

"getblocktemplateresult-longpolluri": "An alternate URI to use for long poll requests if provided (not provided)",

"getblocktemplateresult-submitold": "Not applicable",

"getblocktemplateresult-target": "Hex-encoded big-endian number which valid results must be less than",

"getblocktemplateresult-expires": "Maximum number of seconds (starting from when the server sent the response) this work is valid for",

"getblocktemplateresult-maxtime": "Maximum allowed time",

"getblocktemplateresult-mintime": "Minimum allowed time",

"getblocktemplateresult-mutable": "List of mutations the server explicitly allows",

"getblocktemplateresult-noncerange": "Two concatenated hex-encoded big-endian 32-bit integers which represent the valid ranges of nonces the miner may scan",

"getblocktemplateresult-capabilities": "List of server capabilities including 'proposal' to indicate support for block proposals",

"getblocktemplateresult-reject-reason": "Reason the proposal was invalid as-is (only applies to proposal responses)",

"getblocktemplateresult-stransactions": "Stake transactions",

"getblocktemplateresult-header": "Block header",

// GetBlockTemplateCmd help.

"getblocktemplate--synopsis": "Returns a JSON object with information necessary to construct a block to mine or accepts a proposal to validate.\n" +

"See BIP0022 and BIP0023 for the full specification.",

"getblocktemplate-request": "Request object which controls the mode and several parameters",

"getblocktemplate--condition0": "mode=template",

"getblocktemplate--condition1": "mode=proposal, rejected",

"getblocktemplate--condition2": "mode=proposal, accepted",

"getblocktemplate--result1": "An error string which represents why the proposal was rejected or nothing if accepted",

// GetConnectionCountCmd help.

"getconnectioncount--synopsis": "Returns the number of active connections to other peers.",

"getconnectioncount--result0": "The number of connections",

// GetCurrentNetCmd help.

"getcurrentnet--synopsis": "Get decred network the server is running on.",

"getcurrentnet--result0": "The network identifer",

// GetDifficultyCmd help.

"getdifficulty--synopsis": "Returns the proof-of-work difficulty as a multiple of the minimum difficulty.",

"getdifficulty--result0": "The difficulty",

// GetStakeDifficultyCmd help.

"getstakedifficulty--synopsis": "Returns the proof-of-stake difficulty.",

"getstakedifficultyresult-difficulty": "The stake difficulty",

// GetGenerateCmd help.

"getgenerate--synopsis": "Returns if the server is set to generate coins (mine) or not.",

"getgenerate--result0": "True if mining, false if not",

// GetHashesPerSecCmd help.

"gethashespersec--synopsis": "Returns a recent hashes per second performance measurement while generating coins (mining).",

"gethashespersec--result0": "The number of hashes per second",

// InfoChainResult help.

"infochainresult-version": "The version of the server",

"infochainresult-protocolversion": "The latest supported protocol version",

"infochainresult-blocks": "The number of blocks processed",

"infochainresult-timeoffset": "The time offset",

"infochainresult-connections": "The number of connected peers",

"infochainresult-proxy": "The proxy used by the server",

"infochainresult-difficulty": "The current target difficulty",

"infochainresult-testnet": "Whether or not server is using testnet",

"infochainresult-relayfee": "The minimum relay fee for non-free transactions in DCR/KB",

"infochainresult-errors": "Any current errors",

// InfoWalletResult help.

"infowalletresult-version": "The version of the server",

"infowalletresult-protocolversion": "The latest supported protocol version",

"infowalletresult-walletversion": "The version of the wallet server",

"infowalletresult-balance": "The total decred balance of the wallet",

"infowalletresult-blocks": "The number of blocks processed",

"infowalletresult-timeoffset": "The time offset",

"infowalletresult-connections": "The number of connected peers",

"infowalletresult-proxy": "The proxy used by the server",

"infowalletresult-difficulty": "The current target difficulty",

"infowalletresult-testnet": "Whether or not server is using testnet",

"infowalletresult-keypoololdest": "Seconds since 1 Jan 1970 GMT of the oldest pre-generated key in the key pool",

"infowalletresult-keypoolsize": "The number of new keys that are pre-generated",

"infowalletresult-unlocked_until": "The timestamp in seconds since 1 Jan 1970 GMT that the wallet is unlocked for transfers, or 0 if the wallet is locked",

"infowalletresult-paytxfee": "The transaction fee set in DCR/KB",

"infowalletresult-relayfee": "The minimum relay fee for non-free transactions in DCR/KB",

"infowalletresult-errors": "Any current errors",

// GetInfoCmd help.

"getinfo--synopsis": "Returns a JSON object containing various state info.",

// GetMiningInfoResult help.

"getmininginforesult-blocks": "Height of the latest best block",

"getmininginforesult-currentblocksize": "Size of the latest best block",

"getmininginforesult-currentblocktx": "Number of transactions in the latest best block",

"getmininginforesult-difficulty": "Current target difficulty",

"getmininginforesult-errors": "Any current errors",

"getmininginforesult-generate": "Whether or not server is set to generate coins",

"getmininginforesult-genproclimit": "Number of processors to use for coin generation (-1 when disabled)",

"getmininginforesult-hashespersec": "Recent hashes per second performance measurement while generating coins",

"getmininginforesult-networkhashps": "Estimated network hashes per second for the most recent blocks",

"getmininginforesult-pooledtx": "Number of transactions in the memory pool",

"getmininginforesult-testnet": "Whether or not server is using testnet",

"getmininginforesult-stakedifficulty": "Current estimated stake difficulty",

// GetMiningInfoCmd help.

"getmininginfo--synopsis": "Returns a JSON object containing mining-related information.",

// GetNetworkHashPSCmd help.

"getnetworkhashps--synopsis": "Returns the estimated network hashes per second for the block heights provided by the parameters.",

"getnetworkhashps-blocks": "The number of blocks, or -1 for blocks since last difficulty change",

"getnetworkhashps-height": "Perform estimate ending with this height or -1 for current best chain block height",

"getnetworkhashps--result0": "Estimated hashes per second",

// GetNetTotalsCmd help.

"getnettotals--synopsis": "Returns a JSON object containing network traffic statistics.",

// GetNetTotalsResult help.

"getnettotalsresult-totalbytesrecv": "Total bytes received",

"getnettotalsresult-totalbytessent": "Total bytes sent",

"getnettotalsresult-timemillis": "Number of milliseconds since 1 Jan 1970 GMT",

// GetPeerInfoResult help.

"getpeerinforesult-id": "A unique node ID",

"getpeerinforesult-addr": "The ip address and port of the peer",

"getpeerinforesult-addrlocal": "Local address",

"getpeerinforesult-services": "Services bitmask which represents the services supported by the peer",

"getpeerinforesult-lastsend": "Time the last message was received in seconds since 1 Jan 1970 GMT",

"getpeerinforesult-lastrecv": "Time the last message was sent in seconds since 1 Jan 1970 GMT",

"getpeerinforesult-bytessent": "Total bytes sent",

"getpeerinforesult-bytesrecv": "Total bytes received",

"getpeerinforesult-conntime": "Time the connection was made in seconds since 1 Jan 1970 GMT",

"getpeerinforesult-timeoffset": "The time offset of the peer",

"getpeerinforesult-pingtime": "Number of microseconds the last ping took",

"getpeerinforesult-pingwait": "Number of microseconds a queued ping has been waiting for a response",

"getpeerinforesult-version": "The protocol version of the peer",

"getpeerinforesult-subver": "The user agent of the peer",

"getpeerinforesult-inbound": "Whether or not the peer is an inbound connection",

"getpeerinforesult-startingheight": "The latest block height the peer knew about when the connection was established",

"getpeerinforesult-currentheight": "The current height of the peer",

"getpeerinforesult-banscore": "The ban score",

"getpeerinforesult-syncnode": "Whether or not the peer is the sync peer",

// GetPeerInfoCmd help.

"getpeerinfo--synopsis": "Returns data about each connected network peer as an array of json objects.",

// GetRawMempoolVerboseResult help.

"getrawmempoolverboseresult-size": "Transaction size in bytes",

"getrawmempoolverboseresult-fee": "Transaction fee in decred",

"getrawmempoolverboseresult-time": "Local time transaction entered pool in seconds since 1 Jan 1970 GMT",

"getrawmempoolverboseresult-height": "Block height when transaction entered the pool",

"getrawmempoolverboseresult-startingpriority": "Priority when transaction entered the pool",

"getrawmempoolverboseresult-currentpriority": "Current priority",

"getrawmempoolverboseresult-depends": "Unconfirmed transactions used as inputs for this transaction",

// GetRawMempoolCmd help.

"getrawmempool--synopsis": "Returns information about all of the transactions currently in the memory pool.",

"getrawmempool-verbose": "Returns JSON object when true or an array of transaction hashes when false",

"getrawmempool--condition0": "verbose=false",

"getrawmempool--condition1": "verbose=true",

"getrawmempool--result0": "Array of transaction hashes",

// GetRawTransactionCmd help.

"getrawtransaction--synopsis": "Returns information about a transaction given its hash.",

"getrawtransaction-txid": "The hash of the transaction",

"getrawtransaction-verbose": "Specifies the transaction is returned as a JSON object instead of a hex-encoded string",

"getrawtransaction--condition0": "verbose=false",

"getrawtransaction--condition1": "verbose=true",

"getrawtransaction--result0": "Hex-encoded bytes of the serialized transaction",

// GetTxOutResult help.

"gettxoutresult-bestblock": "The block hash that contains the transaction output",

"gettxoutresult-confirmations": "The number of confirmations",

"gettxoutresult-value": "The transaction amount in DCR",

"gettxoutresult-scriptPubKey": "The public key script used to pay coins as a JSON object",

"gettxoutresult-version": "The transaction version",

"gettxoutresult-coinbase": "Whether or not the transaction is a coinbase",

// GetTxOutCmd help.

"gettxout--synopsis": "Returns information about an unspent transaction output..",

"gettxout-txid": "The hash of the transaction",

"gettxout-vout": "The index of the output",

"gettxout-includemempool": "Include the mempool when true",

// GetWorkResult help.

"getworkresult-data": "Hex-encoded block data",

"getworkresult-hash1": "(DEPRECATED) Hex-encoded formatted hash buffer",

"getworkresult-midstate": "(DEPRECATED) Hex-encoded precomputed hash state after hashing first half of the data",

"getworkresult-target": "Hex-encoded little-endian hash target",

// GetWorkCmd help.

"getwork--synopsis": "(DEPRECATED - Use getblocktemplate instead) Returns formatted hash data to work on or checks and submits solved data.",

"getwork-data": "Hex-encoded data to check",

"getwork--condition0": "no data provided",

"getwork--condition1": "data provided",

"getwork--result1": "Whether or not the solved data is valid and was added to the chain",

// HelpCmd help.

"help--synopsis": "Returns a list of all commands or help for a specified command.",

"help-command": "The command to retrieve help for",

"help--condition0": "no command provided",

"help--condition1": "command specified",

"help--result0": "List of commands",

"help--result1": "Help for specified command",

// PingCmd help.

"ping--synopsis": "Queues a ping to be sent to each connected peer.\n" +

"Ping times are provided by getpeerinfo via the pingtime and pingwait fields.",

// RebroadcastMissed help.

"rebroadcastmissed--synopsis": "Asks the daemon to rebroadcast missed votes.\n",

// RebroadcastWinnerCmd help.

"rebroadcastwinners--synopsis": "Asks the daemon to rebroadcast the winners of the voting lottery.\n",

// SearchRawTransactionsCmd help.

"searchrawtransactions--synopsis": "Returns raw data for transactions involving the passed address.\n" +

"Returned transactions are pulled from both the database, and transactions currently in the mempool.\n" +

"Transactions pulled from the mempool will have the 'confirmations' field set to 0.\n" +

"Usage of this RPC requires the optional --addrindex flag to be activated, otherwise all responses will simply return with an error stating the address index has not yet been built.\n" +

"Similarly, until the address index has caught up with the current best height, all requests will return an error response in order to avoid serving stale data.",

"searchrawtransactions-address": "The Decred address to search for",

"searchrawtransactions-verbose": "Specifies the transaction is returned as a JSON object instead of hex-encoded string",

"searchrawtransactions-skip": "The number of leading transactions to leave out of the final response",

"searchrawtransactions-count": "The maximum number of transactions to return",

"searchrawtransactions--condition0": "verbose=0",

"searchrawtransactions--condition1": "verbose=1",

"searchrawtransactions--result0": "Hex-encoded serialized transaction",

// SendRawTransactionCmd help.

"sendrawtransaction--synopsis": "Submits the serialized, hex-encoded transaction to the local peer and relays it to the network.",

"sendrawtransaction-hextx": "Serialized, hex-encoded signed transaction",

"sendrawtransaction-allowhighfees": "Whether or not to allow insanely high fees (dcrd does not yet implement this parameter, so it has no effect)",

"sendrawtransaction--result0": "The hash of the transaction",

// SetGenerateCmd help.

"setgenerate--synopsis": "Set the server to generate coins (mine) or not.",

"setgenerate-generate": "Use true to enable generation, false to disable it",

"setgenerate-genproclimit": "The number of processors (cores) to limit generation to or -1 for default",

// StopCmd help.

"stop--synopsis": "Shutdown dcrd.",

"stop--result0": "The string 'dcrd stopping.'",

// SubmitBlockOptions help.

"submitblockoptions-workid": "This parameter is currently ignored",

// SubmitBlockCmd help.

"submitblock--synopsis": "Attempts to submit a new serialized, hex-encoded block to the network.",

"submitblock-hexblock": "Serialized, hex-encoded block",

"submitblock-options": "This parameter is currently ignored",

"submitblock--condition0": "Block successfully submitted",

"submitblock--condition1": "Block rejected",

"submitblock--result1": "The reason the block was rejected",

// ValidateAddressResult help.

"validateaddresschainresult-isvalid": "Whether or not the address is valid",

"validateaddresschainresult-address": "The decred address (only when isvalid is true)",

// ValidateAddressCmd help.

"validateaddress--synopsis": "Verify an address is valid.",

"validateaddress-address": "Decred address to validate",

// VerifyChainCmd help.

"verifychain--synopsis": "Verifies the block chain database.\n" +

"The actual checks performed by the checklevel parameter are implementation specific.\n" +

"For dcrd this is:\n" +

"checklevel=0 - Look up each block and ensure it can be loaded from the database.\n" +

"checklevel=1 - Perform basic context-free sanity checks on each block.",

"verifychain-checklevel": "How thorough the block verification is",

"verifychain-checkdepth": "The number of blocks to check",

"verifychain--result0": "Whether or not the chain verified",

// VerifyMessageCmd help.

"verifymessage--synopsis": "Verify a signed message.",

"verifymessage-address": "The decred address to use for the signature",

"verifymessage-signature": "The base-64 encoded signature provided by the signer",

"verifymessage-message": "The signed message",

"verifymessage--result0": "Whether or not the signature verified",

// -------- Websocket-specific help --------

// Session help.

"session--synopsis": "Return details regarding a websocket client's current connection session.",

"sessionresult-sessionid": "The unique session ID for a client's websocket connection.",

// NotifySpentAndMissedTicketsCmd help

"notifyspentandmissedtickets--synopsis": "Request notifications for whenever tickets are spent or missed.",

// NotifyNewTicketsCmd help

"notifynewtickets--synopsis": "Request notifications for whenever new tickets are found.",

// NotifyStakeDifficultyCmd help

"notifystakedifficulty--synopsis": "Request notifications for whenever stake difficulty goes up.",

// NotifyWinningTicketsCmd help

"notifywinningtickets--synopsis": "Request notifications for whenever any tickets is chosen to vote.",

// NotifyBlocksCmd help.

"notifyblocks--synopsis": "Request notifications for whenever a block is connected or disconnected from the main (best) chain.",

// StopNotifyBlocksCmd help.

"stopnotifyblocks--synopsis": "Cancel registered notifications for whenever a block is connected or disconnected from the main (best) chain.",

// NotifyNewTransactionsCmd help.

"notifynewtransactions--synopsis": "Send either a txaccepted or a txacceptedverbose notification when a new transaction is accepted into the mempool.",

"notifynewtransactions-verbose": "Specifies which type of notification to receive. If verbose is true, then the caller receives txacceptedverbose, otherwise the caller receives txaccepted",

// StopNotifyNewTransactionsCmd help.

"stopnotifynewtransactions--synopsis": "Stop sending either a txaccepted or a txacceptedverbose notification when a new transaction is accepted into the mempool.",

// NotifyReceivedCmd help.

"notifyreceived--synopsis": "Send a recvtx notification when a transaction added to mempool or appears in a newly-attached block contains a txout pkScript sending to any of the passed addresses.\n" +

"Matching outpoints are automatically registered for redeemingtx notifications.",

"notifyreceived-addresses": "List of address to receive notifications about",

// StopNotifyReceivedCmd help.

"stopnotifyreceived--synopsis": "Cancel registered receive notifications for each passed address.",

"stopnotifyreceived-addresses": "List of address to cancel receive notifications for",

// OutPoint help.

"outpoint-hash": "The hex-encoded bytes of the outpoint hash",

"outpoint-index": "The index of the outpoint",

"outpoint-tree": "The tree of the outpoint",

// NotifySpentCmd help.

"notifyspent--synopsis": "Send a redeemingtx notification when a transaction spending an outpoint appears in mempool (if relayed to this dcrd instance) and when such a transaction first appears in a newly-attached block.",

"notifyspent-outpoints": "List of transaction outpoints to monitor.",

// StopNotifySpentCmd help.

"stopnotifyspent--synopsis": "Cancel registered spending notifications for each passed outpoint.",

"stopnotifyspent-outpoints": "List of transaction outpoints to stop monitoring.",

// Rescan help.

"rescan--synopsis": "Rescan block chain for transactions to addresses.\n" +

"When the endblock parameter is omitted, the rescan continues through the best block in the main chain.\n" +

"Rescan results are sent as recvtx and redeemingtx notifications.\n" +

"This call returns once the rescan completes.",

"rescan-beginblock": "Hash of the first block to begin rescanning",

"rescan-addresses": "List of addresses to include in the rescan",

"rescan-outpoints": "List of transaction outpoints to include in the rescan",

"rescan-endblock": "Hash of final block to rescan",

// EstimateFee help.

"estimatefee--synopsis": "Returns the estimated fee in dcr/kb.",

"estimatefee-numblocks": "(unused)",

"estimatefee--result0": "Estimated fee.",

// TicketBuckets help.

"ticketbuckets--synopsis": "Request for the number of tickets currently in each bucket of the ticket database.",

"ticketbucket-tickets": "Number of tickets in bucket.",

"ticketbucket-number": "Bucket number.",

// TicketsForAddress help.

"ticketsforaddress--synopsis": "Request all the tickets for an address.",

"ticketsforaddress-address": "Address to look for.",

"ticketsforaddressresult-tickets": "Tickets owned by the specified address.",

// TicketsForBucket help.

"ticketsforbucket--synopsis": "Request all the tickets and owners in a given bucket.",

"ticketsforbucket-bucket": "Bucket to look for.",

"ticketsforbucketresult-tickets": "Result for the ticketsfor bucket command.",

"ticket-owner": "Address owning the ticket.",

"ticket-hash": "Hash of the ticket.",

// MissedTickets help.

"missedtickets--synopsis": "Reguest tickets the client missed",

"missedticketsresult-tickets": "List of missed tickets",

// GetCoinSupply help

"getcoinsupply--synopsis": "Returns current total coin supply in atoms",

"getcoinsupplyresult-coinsupply": "Current coin supply in atoms",

}

// rpcResultTypes specifies the result types that each RPC command can return.

// This information is used to generate the help. Each result type must be a

// pointer to the type (or nil to indicate no return value).

var rpcResultTypes = map[string][]interface{}{

"addnode": nil,

"createrawsstx": []interface{}{(*string)(nil)},

"createrawssgentx": []interface{}{(*string)(nil)},

"createrawssrtx": []interface{}{(*string)(nil)},

"createrawtransaction": []interface{}{(*string)(nil)},

"debuglevel": []interface{}{(*string)(nil), (*string)(nil)},

"decoderawtransaction": []interface{}{(*dcrjson.TxRawDecodeResult)(nil)},

"decodescript": []interface{}{(*dcrjson.DecodeScriptResult)(nil)},

"estimatefee": []interface{}{(*float64)(nil)},

"existsaddress": []interface{}{(*dcrjson.ExistsAddressResult)(nil)},

"getaddednodeinfo": []interface{}{(*[]string)(nil), (*[]dcrjson.GetAddedNodeInfoResult)(nil)},

"getbestblock": []interface{}{(*dcrjson.GetBestBlockResult)(nil)},

"generate": []interface{}{(*[]string)(nil)},

"getbestblockhash": []interface{}{(*string)(nil)},

"getblock": []interface{}{(*string)(nil), (*dcrjson.GetBlockVerboseResult)(nil)},

"getblockcount": []interface{}{(*int64)(nil)},

"getblockhash": []interface{}{(*string)(nil)},

"getblocktemplate": []interface{}{(*dcrjson.GetBlockTemplateResult)(nil), (*string)(nil), nil},

"getconnectioncount": []interface{}{(*int32)(nil)},

"getcurrentnet": []interface{}{(*uint32)(nil)},

"getdifficulty": []interface{}{(*float64)(nil)},

"getstakedifficulty": []interface{}{(*dcrjson.GetStakeDifficultyResult)(nil)},

"getgenerate": []interface{}{(*bool)(nil)},

"gethashespersec": []interface{}{(*float64)(nil)},

"getinfo": []interface{}{(*dcrjson.InfoChainResult)(nil)},

"getmininginfo": []interface{}{(*dcrjson.GetMiningInfoResult)(nil)},

"getnettotals": []interface{}{(*dcrjson.GetNetTotalsResult)(nil)},

"getnetworkhashps": []interface{}{(*int64)(nil)},

"getpeerinfo": []interface{}{(*[]dcrjson.GetPeerInfoResult)(nil)},

"getrawmempool": []interface{}{(*[]string)(nil), (*dcrjson.GetRawMempoolVerboseResult)(nil)},

"getrawtransaction": []interface{}{(*string)(nil), (*dcrjson.TxRawResult)(nil)},

"gettxout": []interface{}{(*dcrjson.GetTxOutResult)(nil)},

"getwork": []interface{}{(*dcrjson.GetWorkResult)(nil), (*bool)(nil)},

"getcoinsupply": []interface{}{(*dcrjson.GetCoinSupplyResult)(nil)},

"missedtickets": []interface{}{(*dcrjson.MissedTicketsResult)(nil)},

"node": nil,

"help": []interface{}{(*string)(nil), (*string)(nil)},

"ping": nil,

"rebroadcastmissed": nil,

"rebroadcastwinners": nil,

"searchrawtransactions": []interface{}{(*string)(nil), (*[]dcrjson.TxRawResult)(nil)},

"sendrawtransaction": []interface{}{(*string)(nil)},

"setgenerate": nil,

"stop": []interface{}{(*string)(nil)},

"submitblock": []interface{}{nil, (*string)(nil)},

"ticketsforaddress": []interface{}{(*dcrjson.TicketsForAddressResult)(nil)},

"validateaddress": []interface{}{(*dcrjson.ValidateAddressChainResult)(nil)},

"verifychain": []interface{}{(*bool)(nil)},

"verifymessage": []interface{}{(*bool)(nil)},

// Websocket commands.

"session": []interface{}{(*dcrjson.SessionResult)(nil)},

"notifywinningtickets": nil,

"notifyspentandmissedtickets": nil,

"notifynewtickets": nil,

"notifystakedifficulty": nil,

"notifyblocks": nil,

"notifynewtransactions": nil,

"notifyreceived": nil,

"notifyspent": nil,

"rescan": nil,

"stopnotifyblocks": nil,

"stopnotifynewtransactions": nil,

"stopnotifyreceived": nil,

"stopnotifyspent": nil,

}

// helpCacher provides a concurrent safe type that provides help and usage for

// the RPC server commands and caches the results for future calls.

type helpCacher struct {

}

// rpcMethodHelp returns an RPC help string for the provided method.

//

// This function is safe for concurrent access.

func (c *helpCacher) rpcMethodHelp(method string) (string, error) {

}

// rpcUsage returns one-line usage for all support RPC commands.

//

// This function is safe for concurrent access.

func (c *helpCacher) rpcUsage(includeWebsockets bool) (string, error) {

}

// newHelpCacher returns a new instance of a help cacher which provides help and

// usage for the RPC server commands and caches the results for future calls.

func newHelpCacher() *helpCacher {

}