rpcserverhelp.go

// Copyright (c) 2015-2017 The btcsuite developers
// Copyright (c) 2015-2017 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/blinklabs-io/handshake-node/hnsjson"
)

// 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 ADXR, AMGR, BCDB, CHAN, CMGR, DISC, HNSN, INDX, MINR, PEER, RPCS, SCRP, SRVR, STRM, SYNC, 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",

	// 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 HNS as the value",
	"createrawtransaction-locktime":       "Locktime value; a non-zero value will also locktime-activate the inputs",
	"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",

	// PrevOut help.
	"prevout-addresses": "previous output addresses",
	"prevout-value":     "previous output value",

	// VinPrevOut help.
	"vinprevout-coinbase":    "The hex-encoded bytes of the signature script (coinbase txns only)",
	"vinprevout-txid":        "The hash of the origin transaction (non-coinbase txns only)",
	"vinprevout-vout":        "The index of the output being redeemed from the origin transaction (non-coinbase txns only)",
	"vinprevout-scriptSig":   "The signature script used to redeem the origin transaction as a JSON object (non-coinbase txns only)",
	"vinprevout-txinwitness": "The witness stack of the passed input, encoded as a JSON string array",
	"vinprevout-prevOut":     "Data from the origin transaction output with index vout.",
	"vinprevout-sequence":    "The script sequence number",

	// 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-txinwitness": "The witness used to redeem the input encoded as a string array of its items",
	"vin-sequence":    "The script sequence number",

	// ScriptPubKeyResult help.
	"scriptpubkeyresult-asm":       "Disassembly of the script",
	"scriptpubkeyresult-hex":       "Hex-encoded bytes of the script",
	"scriptpubkeyresult-reqSigs":   "(DEPRECATED) The number of required signatures",
	"scriptpubkeyresult-type":      "The type of the script (e.g. 'pubkeyhash')",
	"scriptpubkeyresult-address":   "The bitcoin address associated with this script (only if a well-defined address exists)",
	"scriptpubkeyresult-addresses": "(DEPRECATED) The bitcoin addresses associated with this script",

	// Vout help.
	"vout-value":        "The amount in BTC",
	"vout-n":            "The index of this transaction output",
	"vout-scriptPubKey": "The public key script used to pay coins as a JSON object",

	// 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",

	// DecodeRawTransactionCmd help.
	"decoderawtransaction--synopsis": "Returns a JSON object representing the provided serialized, hex-encoded transaction.",
	"decoderawtransaction-hextx":     "Serialized, hex-encoded transaction",

	// DecodeResourceCmd help.
	"decoderesource--synopsis":   "Decodes a hex-encoded Handshake DNS resource.",
	"decoderesource-hexresource": "Hex-encoded Handshake DNS resource data",
	"decoderesource--result0":    "Decoded resource data",

	// DecodeScriptResult help.
	"decodescriptresult-asm":       "Disassembly of the script",
	"decodescriptresult-reqSigs":   "(DEPRECATED) The number of required signatures",
	"decodescriptresult-type":      "The type of the script (e.g. 'pubkeyhash')",
	"decodescriptresult-address":   "The bitcoin address associated with this script (only if a well-defined address exists)",
	"decodescriptresult-addresses": "(DEPRECATED) The bitcoin addresses associated with this script",
	"decodescriptresult-p2sh":      "The script hash for use in pay-to-script-hash transactions (only present if the provided redeem script is not already a pay-to-script-hash script)",

	// DecodeScriptCmd help.
	"decodescript--synopsis": "Returns a JSON object with information about the provided hex-encoded script.",
	"decodescript-hexscript": "Hex-encoded script",

	// EstimateFeeCmd help.
	"estimatefee--synopsis": "Estimate the fee per kilobyte in satoshis " +
		"required for a transaction to be mined before a certain number of " +
		"blocks have been generated.",
	"estimatefee-numblocks": "The maximum number of blocks which can be " +
		"generated before the transaction is mined.",
	"estimatefee--result0": "Estimated fee per kilobyte in satoshis for a block to " +
		"be mined in the next NumBlocks blocks.",

	// GenerateCmd help
	"generate--synopsis": "Generates a set number of blocks (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-verbosity":   "Specifies whether the block data should be returned as a hex-encoded string (0), as parsed data with a slice of TXIDs (1), or as parsed data with parsed transaction data (2) ",
	"getblock--condition0": "verbosity=0",
	"getblock--condition1": "verbosity=1",
	"getblock--result0":    "Hex-encoded bytes of the serialized block",

	// GetBlockByHeightCmd help.
	"getblockbyheight--synopsis":   "Returns information about a block given its height.",
	"getblockbyheight-height":      "The block height",
	"getblockbyheight-verbose":     "Whether to return parsed block data instead of hex",
	"getblockbyheight-details":     "Whether to include parsed transaction data when verbose is true",
	"getblockbyheight--condition0": "verbose=false",
	"getblockbyheight--condition1": "verbose=true",
	"getblockbyheight--result0":    "Hex-encoded bytes of the serialized block",
	"getblockbyheight--result1":    "JSON object with information about the block",

	// GetBlockChainInfoCmd help.
	"getblockchaininfo--synopsis": "Returns information about the current blockchain state and the status of any active soft-fork deployments.",

	// GetBlockChainInfoResult help.
	"getblockchaininforesult-chain":                "The name of the chain the daemon is on (testnet, mainnet, etc)",
	"getblockchaininforesult-blocks":               "The number of blocks in the best known chain",
	"getblockchaininforesult-headers":              "The number of headers that we've gathered for in the best known chain",
	"getblockchaininforesult-bestblockhash":        "The block hash for the latest block in the main chain",
	"getblockchaininforesult-difficulty":           "The current chain difficulty",
	"getblockchaininforesult-mediantime":           "The median time from the PoV of the best block in the chain",
	"getblockchaininforesult-verificationprogress": "An estimate for how much of the best chain we've verified",
	"getblockchaininforesult-pruned":               "A bool that indicates if the node is pruned or not",
	"getblockchaininforesult-pruneheight":          "The lowest block retained in the current pruned chain",
	"getblockchaininforesult-chainwork":            "The total cumulative work in the best chain",
	"getblockchaininforesult-size_on_disk":         "The estimated size of the block and undo files on disk",
	"getblockchaininforesult-initialblockdownload": "Estimate of whether this node is in Initial Block Download mode",
	"getblockchaininforesult-softforks":            "The status of the super-majority soft-forks",
	"getblockchaininforesult-unifiedsoftforks":     "The status of the super-majority soft-forks used by bitcoind on or after v0.19.0",

	// SoftForkDescription help.
	"softforkdescription-reject":  "The current activation status of the softfork",
	"softforkdescription-version": "The block version that signals enforcement of this softfork",
	"softforkdescription-id":      "The string identifier for the soft fork",
	"-status":                     "A bool which indicates if the soft fork is active",

	// SoftForks help.
	"softforks-softforks":             "The status of the super-majority soft-forks",
	"softforks-bip9_softforks":        "JSON object describing active BIP0009 deployments",
	"softforks-bip9_softforks--key":   "bip9_softforks",
	"softforks-bip9_softforks--value": "An object describing a particular BIP009 deployment",
	"softforks-bip9_softforks--desc":  "The status of any defined BIP0009 soft-fork deployments",

	// UnifiedSoftForks help.
	"unifiedsoftforks-softforks":        "The status of the super-majority soft-forks used by bitcoind on or after v0.19.0",
	"unifiedsoftforks-softforks--key":   "softforks",
	"unifiedsoftforks-softforks--value": "An object describing an active softfork deployment used by bitcoind on or after v0.19.0",
	"unifiedsoftforks-softforks--desc":  "JSON object describing an active softfork deployment used by bitcoind on or after v0.19.0",

	// 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-size":          "The size of the transaction in bytes",
	"txrawresult-vsize":         "The virtual size of the transaction in bytes",
	"txrawresult-weight":        "The transaction's weight (between vsize*4-3 and vsize*4)",
	"txrawresult-hash":          "The wtxid of the transaction",

	// SearchRawTransactionsResult help.
	"searchrawtransactionsresult-hex":           "Hex-encoded transaction",
	"searchrawtransactionsresult-txid":          "The hash of the transaction",
	"searchrawtransactionsresult-hash":          "The wxtid of the transaction",
	"searchrawtransactionsresult-version":       "The transaction version",
	"searchrawtransactionsresult-locktime":      "The transaction lock time",
	"searchrawtransactionsresult-vin":           "The transaction inputs as JSON objects",
	"searchrawtransactionsresult-vout":          "The transaction outputs as JSON objects",
	"searchrawtransactionsresult-blockhash":     "Hash of the block the transaction is part of",
	"searchrawtransactionsresult-confirmations": "Number of confirmations of the block",
	"searchrawtransactionsresult-time":          "Transaction time in seconds since 1 Jan 1970 GMT",
	"searchrawtransactionsresult-blocktime":     "Block time in seconds since the 1 Jan 1970 GMT",
	"searchrawtransactionsresult-size":          "The size of the transaction in bytes",
	"searchrawtransactionsresult-vsize":         "The virtual size of the transaction in bytes",
	"searchrawtransactionsresult-weight":        "The transaction's weight (between vsize*4-3 and vsize*4)",

	// 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-versionHex":        "The block version in hexadecimal",
	"getblockverboseresult-merkleroot":        "Root hash of the merkle tree",
	"getblockverboseresult-tx":                "The transaction hashes (only when verbosity=1)",
	"getblockverboseresult-rawtx":             "The transactions as JSON objects (only when verbosity=2)",
	"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-strippedsize":      "The size of the block without witness data",
	"getblockverboseresult-weight":            "The weight of the block",

	// 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",

	// GetBlockHeaderCmd help.
	"getblockheader--synopsis":   "Returns information about a block header given its hash.",
	"getblockheader-hash":        "The hash of the block",
	"getblockheader-verbose":     "Specifies the block header is returned as a JSON object instead of hex-encoded string",
	"getblockheader--condition0": "verbose=false",
	"getblockheader--condition1": "verbose=true",
	"getblockheader--result0":    "The block header hash",

	// GetBlockHeaderVerboseResult help.
	"getblockheaderverboseresult-hash":              "The hash of the block (same as provided)",
	"getblockheaderverboseresult-confirmations":     "The number of confirmations",
	"getblockheaderverboseresult-height":            "The height of the block in the block chain",
	"getblockheaderverboseresult-version":           "The block version",
	"getblockheaderverboseresult-versionHex":        "The block version in hexadecimal",
	"getblockheaderverboseresult-merkleroot":        "Root hash of the merkle tree",
	"getblockheaderverboseresult-time":              "The block time in seconds since 1 Jan 1970 GMT",
	"getblockheaderverboseresult-nonce":             "The block nonce",
	"getblockheaderverboseresult-bits":              "The bits which represent the block difficulty",
	"getblockheaderverboseresult-difficulty":        "The proof-of-work difficulty as a multiple of the minimum difficulty",
	"getblockheaderverboseresult-previousblockhash": "The hash of the previous block",
	"getblockheaderverboseresult-nextblockhash":     "The hash of the next block (only if there is one)",

	// 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)",
	"templaterequest-rules":        "Specific block rules that are to be enforced e.g. '[\"segwit\"]",

	// 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 Satoshi)",
	"getblocktemplateresulttx-sigops":  "Total number of signature operations as counted for purposes of block limits",
	"getblocktemplateresulttx-txid":    "The transaction id, can be different from hash.",
	"getblocktemplateresulttx-weight":  "The weight of the transaction",

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

	// GetBlockTemplateResultClaim help.
	"getblocktemplateresultclaim-data":         "Hex-encoded serialized reserved-name ownership proof",
	"getblocktemplateresultclaim-name":         "Reserved name proven by the claim",
	"getblocktemplateresultclaim-namehash":     "Hex-encoded hash of the claimed name",
	"getblocktemplateresultclaim-version":      "Handshake address version receiving the claim output",
	"getblocktemplateresultclaim-hash":         "Hex-encoded claim output address hash",
	"getblocktemplateresultclaim-value":        "Claim value included in the coinbase",
	"getblocktemplateresultclaim-fee":          "Claim fee credited to the miner payout",
	"getblocktemplateresultclaim-weak":         "Whether the claim is weak",
	"getblocktemplateresultclaim-commitHash":   "Hex-encoded committed block hash",
	"getblocktemplateresultclaim-commitHeight": "Committed block height",
	"getblocktemplateresultclaim-weight":       "Additional block weight reserved for the claim",

	// GetBlockTemplateResultAirdrop help.
	"getblocktemplateresultairdrop-data":     "Hex-encoded serialized airdrop proof",
	"getblocktemplateresultairdrop-position": "Airdrop spent-field position",
	"getblocktemplateresultairdrop-version":  "Handshake address version receiving the airdrop output",
	"getblocktemplateresultairdrop-address":  "Hex-encoded airdrop output address hash",
	"getblocktemplateresultairdrop-value":    "Airdrop value included in the coinbase",
	"getblocktemplateresultairdrop-fee":      "Airdrop fee credited to the miner payout",
	"getblocktemplateresultairdrop-rate":     "Airdrop proof fee rate in dollarydoos per kvB",
	"getblocktemplateresultairdrop-weak":     "Whether the airdrop proof uses weak key material",

	// 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 Satoshi",
	"getblocktemplateresult-workid":            "This value must be returned with result if provided (not provided)",
	"getblocktemplateresult-merkleroot":        "Hex-encoded root hash of the transaction merkle tree",
	"getblocktemplateresult-witnessroot":       "Hex-encoded root hash of the witness tree",
	"getblocktemplateresult-treeroot":          "Hex-encoded root hash of the Handshake name tree",
	"getblocktemplateresult-reservedroot":      "Hex-encoded reserved root field from the Handshake block header",
	"getblocktemplateresult-mask":              "Hex-encoded Handshake block mask",
	"getblocktemplateresult-claims":            "Array of reserved-name claim proof metadata",
	"getblocktemplateresult-airdrops":          "Array of airdrop proof metadata",
	"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-weightlimit":       "The current limit on the max allowed weight of a block",

	// 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",

	// GetChainTipsResult help.
	"getchaintipsresult-chaintips": "The chaintips that this node is aware of",
	"getchaintipsresult-height":    "The height of the chain tip",
	"getchaintipsresult-hash":      "The block hash of the chain tip",
	"getchaintipsresult-branchlen": "Returns zero for main chain. Otherwise is the length of branch connecting the tip to the main chain",
	"getchaintipsresult-status":    "Status of the chain. Returns \"active\" for the main chain",
	// GetChainTipsCmd help.
	"getchaintips--synopsis": "Returns information about all known tips in the block tree, including the main chain as well as orphaned branches.",

	// GetCFilterCmd help.
	"getcfilter--synopsis":  "Returns a block's committed filter given its hash.",
	"getcfilter-filtertype": "The type of filter to return (0=regular)",
	"getcfilter-hash":       "The hash of the block",
	"getcfilter--result0":   "The block's committed filter",

	// GetCFilterHeaderCmd help.
	"getcfilterheader--synopsis":  "Returns a block's compact filter header given its hash.",
	"getcfilterheader-filtertype": "The type of filter header to return (0=regular)",
	"getcfilterheader-hash":       "The hash of the block",
	"getcfilterheader--result0":   "The block's gcs filter header",

	// GetConnectionCountCmd help.
	"getconnectioncount--synopsis": "Returns the number of active connections to other peers.",
	"getconnectioncount--result0":  "The number of connections",

	// GetCurrentNetCmd help.
	"getcurrentnet--synopsis": "Get bitcoin network the server is running on.",
	"getcurrentnet--result0":  "The network identifier",

	// GetDifficultyCmd help.
	"getdifficulty--synopsis": "Returns the proof-of-work difficulty as a multiple of the minimum difficulty.",
	"getdifficulty--result0":  "The 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 BTC/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 bitcoin 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 BTC/KB",
	"infowalletresult-relayfee":        "The minimum relay fee for non-free transactions in BTC/KB",
	"infowalletresult-errors":          "Any current errors",

	// GetHeadersCmd help.
	"getheaders--synopsis":     "Returns block headers starting with the first known block hash from the request",
	"getheaders-blocklocators": "JSON array of hex-encoded hashes of blocks.  Headers are returned starting from the first known hash in this list",
	"getheaders-hashstop":      "Block hash to stop including block headers for; if not found, all headers to the latest known block are returned.",
	"getheaders--result0":      "Serialized block headers of all located blocks, limited to some arbitrary maximum number of hashes (currently 2000, which matches the wire protocol headers message, but this is not guaranteed)",

	// NameStateResult help.
	"namestateresult-name":       "The raw Handshake name, when known",
	"namestateresult-namehash":   "Hex-encoded consensus hash of the name",
	"namestateresult-height":     "Height at which the current lifecycle began",
	"namestateresult-renewal":    "Height of the most recent renewal",
	"namestateresult-ownerhash":  "Transaction hash of the current owner outpoint",
	"namestateresult-ownerindex": "Output index of the current owner outpoint",
	"namestateresult-value":      "Current name value in dollarydoos",
	"namestateresult-highest":    "Highest bid value tracked for this name",
	"namestateresult-data":       "Hex-encoded resource data",
	"namestateresult-transfer":   "Transfer height, or zero when no transfer is pending",
	"namestateresult-revoked":    "Revoke height, or zero when the name is not revoked",
	"namestateresult-claimed":    "Claim height, or zero when the name was not claimed",
	"namestateresult-renewals":   "Number of renewals tracked for this name",
	"namestateresult-registered": "Whether the name has been registered",
	"namestateresult-expired":    "Whether the name is marked expired",
	"namestateresult-weak":       "Whether the name was claimed with the weak flag",

	// Covenant transaction construction command help.
	"createopen--synopsis":           "Returns an unsigned transaction hex with an OPEN covenant output.",
	"createopen-inputs":              "Transaction inputs to include; input 0 is used for linked covenant spends when required",
	"createopen-address":             "Output address",
	"createopen-amount":              "Output amount in HNS",
	"createopen-name":                "Handshake name to open",
	"createopen-locktime":            "Optional transaction lock time",
	"createopen--result0":            "Hex-encoded unsigned transaction",
	"createbid--synopsis":            "Returns an unsigned transaction hex with a BID covenant output.",
	"createbid-inputs":               "Transaction inputs to include",
	"createbid-address":              "Output address",
	"createbid-amount":               "Output lockup amount in HNS",
	"createbid-name":                 "Handshake name being bid on",
	"createbid-start":                "Auction start height",
	"createbid-blind":                "Hex-encoded blinded bid hash",
	"createbid-locktime":             "Optional transaction lock time",
	"createbid--result0":             "Hex-encoded unsigned transaction",
	"createreveal--synopsis":         "Returns an unsigned transaction hex with a REVEAL covenant output.",
	"createreveal-inputs":            "Transaction inputs to include; input 0 should spend the BID output",
	"createreveal-address":           "Output address",
	"createreveal-amount":            "Revealed bid value in HNS",
	"createreveal-namehash":          "Hex-encoded consensus hash of the name",
	"createreveal-start":             "Auction start height",
	"createreveal-nonce":             "Hex-encoded reveal nonce",
	"createreveal-locktime":          "Optional transaction lock time",
	"createreveal--result0":          "Hex-encoded unsigned transaction",
	"createredeem--synopsis":         "Returns an unsigned transaction hex with a REDEEM covenant output.",
	"createredeem-inputs":            "Transaction inputs to include; input 0 should spend a losing REVEAL output",
	"createredeem-address":           "Output address",
	"createredeem-amount":            "Output amount in HNS",
	"createredeem-namehash":          "Hex-encoded consensus hash of the name",
	"createredeem-start":             "Auction start height",
	"createredeem-locktime":          "Optional transaction lock time",
	"createredeem--result0":          "Hex-encoded unsigned transaction",
	"createregister--synopsis":       "Returns an unsigned transaction hex with a REGISTER covenant output.",
	"createregister-inputs":          "Transaction inputs to include; input 0 should spend the winning REVEAL output",
	"createregister-address":         "Output address",
	"createregister-amount":          "Registered name value in HNS",
	"createregister-namehash":        "Hex-encoded consensus hash of the name",
	"createregister-start":           "Auction start height",
	"createregister-resource":        "Hex-encoded resource data",
	"createregister-renewalhash":     "Optional hex-encoded renewal block hash; defaults to a valid current renewal hash when possible",
	"createregister-locktime":        "Optional transaction lock time",
	"createregister--result0":        "Hex-encoded unsigned transaction",
	"createupdate--synopsis":         "Returns an unsigned transaction hex with an UPDATE covenant output.",
	"createupdate-inputs":            "Transaction inputs to include; input 0 should spend the current owner output",
	"createupdate-address":           "Output address",
	"createupdate-amount":            "Name value in HNS",
	"createupdate-namehash":          "Hex-encoded consensus hash of the name",
	"createupdate-start":             "Auction start height",
	"createupdate-resource":          "Hex-encoded resource data",
	"createupdate-locktime":          "Optional transaction lock time",
	"createupdate--result0":          "Hex-encoded unsigned transaction",
	"createrenew--synopsis":          "Returns an unsigned transaction hex with a RENEW covenant output.",
	"createrenew-inputs":             "Transaction inputs to include; input 0 should spend the current owner output",
	"createrenew-address":            "Output address",
	"createrenew-amount":             "Name value in HNS",
	"createrenew-namehash":           "Hex-encoded consensus hash of the name",
	"createrenew-start":              "Auction start height",
	"createrenew-renewalhash":        "Optional hex-encoded renewal block hash; defaults to a valid current renewal hash when possible",
	"createrenew-locktime":           "Optional transaction lock time",
	"createrenew--result0":           "Hex-encoded unsigned transaction",
	"createtransfer--synopsis":       "Returns an unsigned transaction hex with a TRANSFER covenant output.",
	"createtransfer-inputs":          "Transaction inputs to include; input 0 should spend the current owner output",
	"createtransfer-address":         "Current owner output address",
	"createtransfer-amount":          "Name value in HNS",
	"createtransfer-namehash":        "Hex-encoded consensus hash of the name",
	"createtransfer-start":           "Auction start height",
	"createtransfer-transferaddress": "Recipient address encoded into the TRANSFER covenant",
	"createtransfer-locktime":        "Optional transaction lock time",
	"createtransfer--result0":        "Hex-encoded unsigned transaction",
	"createfinalize--synopsis":       "Returns an unsigned transaction hex with a FINALIZE covenant output.",
	"createfinalize-inputs":          "Transaction inputs to include; input 0 should spend the mature TRANSFER output",
	"createfinalize-address":         "Recipient output address",
	"createfinalize-amount":          "Name value in HNS",
	"createfinalize-name":            "Handshake name being finalized",
	"createfinalize-start":           "Auction start height",
	"createfinalize-flags":           "Name state flags",
	"createfinalize-claimed":         "Claim height carried by the name state",
	"createfinalize-renewals":        "Renewal count carried by the name state",
	"createfinalize-renewalhash":     "Optional hex-encoded renewal block hash; defaults to a valid current renewal hash when possible",
	"createfinalize-locktime":        "Optional transaction lock time",
	"createfinalize--result0":        "Hex-encoded unsigned transaction",
	"createrevoke--synopsis":         "Returns an unsigned transaction hex with a REVOKE covenant output.",
	"createrevoke-inputs":            "Transaction inputs to include; input 0 should spend the current owner output",
	"createrevoke-address":           "Output address",
	"createrevoke-amount":            "Name value in HNS",
	"createrevoke-namehash":          "Hex-encoded consensus hash of the name",
	"createrevoke-start":             "Auction start height",
	"createrevoke-locktime":          "Optional transaction lock time",
	"createrevoke--result0":          "Hex-encoded unsigned transaction",

	// GetNameInfoCmd help.
	"getnameinfo--synopsis": "Returns the current chain state for a Handshake name.",
	"getnameinfo-name":      "Handshake name to query",
	"getnameinfo--result0":  "Name lookup result",

	// GetNameByHashCmd help.
	"getnamebyhash--synopsis": "Returns the current chain state for a Handshake name hash.",
	"getnamebyhash-namehash":  "Hex-encoded consensus hash of the name",
	"getnamebyhash--result0":  "Name lookup result",

	// GetNameInfoResult help.
	"getnameinforesult-found": "Whether the name state was found",
	"getnameinforesult-state": "Name state when found",

	// NameResourceRecordResult help.
	"nameresourcerecordresult-type":       "Handshake resource record type name",
	"nameresourcerecordresult-typeid":     "Handshake resource record type identifier",
	"nameresourcerecordresult-name":       "DNS name carried by the record",
	"nameresourcerecordresult-address":    "IP address carried by the record",
	"nameresourcerecordresult-keytag":     "DNSSEC DS key tag",
	"nameresourcerecordresult-algorithm":  "DNSSEC DS algorithm",
	"nameresourcerecordresult-digesttype": "DNSSEC DS digest type",
	"nameresourcerecordresult-digest":     "Hex-encoded DNSSEC DS digest",
	"nameresourcerecordresult-items":      "Hex-encoded TXT record items",

	// NameResourceDataResult help.
	"nameresourcedataresult-version": "Handshake resource data version",
	"nameresourcedataresult-records": "Decoded Handshake DNS resource records",

	// GetNameResourceCmd help.
	"getnameresource--synopsis": "Returns raw and decoded resource data for a Handshake name.",
	"getnameresource-name":      "Handshake name to query",
	"getnameresource--result0":  "Name resource data result",

	// GetNameResourceResult help.
	"getnameresourceresult-name":     "The queried Handshake name",
	"getnameresourceresult-namehash": "Hex-encoded consensus hash of the name",
	"getnameresourceresult-found":    "Whether the name state was found",
	"getnameresourceresult-data":     "Hex-encoded resource data",
	"getnameresourceresult-resource": "Decoded resource data when present",

	// GetNameProofCmd help.
	"getnameproof--synopsis": "Returns an hsd-compatible Urkel proof for a Handshake name.",
	"getnameproof-name":      "Handshake name to prove",
	"getnameproof-root":      "Optional hex-encoded name tree root; defaults to the current committed root",
	"getnameproof--result0":  "Name proof result",

	// GetNameProofResult help.
	"getnameproofresult-name":     "The queried Handshake name",
	"getnameproofresult-namehash": "Hex-encoded consensus hash of the name",
	"getnameproofresult-root":     "Hex-encoded name tree root used for the proof",
	"getnameproofresult-proof":    "Hex-encoded serialized Urkel proof",

	// GetNamesCmd help.
	"getnames--synopsis": "Returns all currently persisted Handshake name states.",
	"getnames-offset":    "Optional zero-based result offset",
	"getnames-limit":     "Optional maximum number of results; zero returns all remaining names",
	"getnames--result0":  "All current name states",

	// GetNamesByHashCmd help.
	"getnamesbyhash--synopsis":  "Returns current chain states for Handshake name hashes.",
	"getnamesbyhash-namehashes": "JSON array of hex-encoded name hashes",
	"getnamesbyhash--result0":   "Name lookup results in request order",

	// GetAuctionInfoCmd help.
	"getauctioninfo--synopsis": "Returns the current auction lifecycle summary for a Handshake name.",
	"getauctioninfo-name":      "Handshake name to query",
	"getauctioninfo--result0":  "Auction lifecycle summary",

	// GetAuctionInfoResult help.
	"getauctioninforesult-name":                 "The queried Handshake name",
	"getauctioninforesult-namehash":             "Hex-encoded consensus hash of the name",
	"getauctioninforesult-found":                "Whether persisted name state was found",
	"getauctioninforesult-phase":                "Current lifecycle phase",
	"getauctioninforesult-currentheight":        "Current best chain height used for phase calculation",
	"getauctioninforesult-startheight":          "Height at which the current lifecycle began",
	"getauctioninforesult-biddingstart":         "Height at which bidding starts",
	"getauctioninforesult-revealstart":          "Height at which reveals start",
	"getauctioninforesult-closeheight":          "Height at which the auction or lockup closes",
	"getauctioninforesult-nextheight":           "Next relevant lifecycle boundary height",
	"getauctioninforesult-ownerhash":            "Transaction hash of the current owner outpoint",
	"getauctioninforesult-ownerindex":           "Output index of the current owner outpoint",
	"getauctioninforesult-value":                "Current name value in dollarydoos",
	"getauctioninforesult-highest":              "Highest bid value tracked for this name",
	"getauctioninforesult-renewalheight":        "Height of the most recent renewal",
	"getauctioninforesult-expirationheight":     "Height at which the current registration expires",
	"getauctioninforesult-transferunlockheight": "Height at which a pending transfer can finalize",
	"getauctioninforesult-revokematurityheight": "Height at which a revoked name matures",
	"getauctioninforesult-registered":           "Whether the name has been registered",
	"getauctioninforesult-expired":              "Whether the name is marked expired",
	"getauctioninforesult-weak":                 "Whether the name was claimed with the weak flag",

	// VerifyNameProofCmd help.
	"verifynameproof--synopsis": "Verifies a serialized Handshake Urkel name proof.",
	"verifynameproof-root":      "Hex-encoded name tree root",
	"verifynameproof-namehash":  "Hex-encoded consensus hash of the name",
	"verifynameproof-proof":     "Hex-encoded serialized Urkel proof",
	"verifynameproof--result0":  "Proof verification result",

	// VerifyNameProofResult help.
	"verifynameproofresult-root":     "Hex-encoded name tree root used for verification",
	"verifynameproofresult-namehash": "Hex-encoded consensus hash of the name",
	"verifynameproofresult-exists":   "Whether the proof is an inclusion proof",
	"verifynameproofresult-value":    "Hex-encoded proven leaf value for inclusion proofs",

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

	// GetMempoolInfoCmd help.
	"getmempoolinfo--synopsis": "Returns memory pool information",

	// GetMempoolAncestorsCmd help.
	"getmempoolancestors--synopsis":   "Returns mempool ancestors for a transaction.",
	"getmempoolancestors-txid":        "Transaction hash to query",
	"getmempoolancestors-verbose":     "Whether to return verbose entry objects instead of hashes",
	"getmempoolancestors--condition0": "verbose=false",
	"getmempoolancestors--condition1": "verbose=true",
	"getmempoolancestors--result0":    "Ancestor transaction hashes",
	"getmempoolancestors--result1":    "Verbose ancestor entries",

	// GetMempoolDescendantsCmd help.
	"getmempooldescendants--synopsis":   "Returns mempool descendants for a transaction.",
	"getmempooldescendants-txid":        "Transaction hash to query",
	"getmempooldescendants-verbose":     "Whether to return verbose entry objects instead of hashes",
	"getmempooldescendants--condition0": "verbose=false",
	"getmempooldescendants--condition1": "verbose=true",
	"getmempooldescendants--result0":    "Descendant transaction hashes",
	"getmempooldescendants--result1":    "Verbose descendant entries",

	// GetMempoolEntryCmd help.
	"getmempoolentry--synopsis": "Returns mempool information for a transaction.",
	"getmempoolentry-txid":      "Transaction hash to query",
	"getmempoolentry--result0":  "Verbose mempool entry",

	// GetMempoolEntryResult help.
	"getmempoolentryresult-vsize":           "Transaction virtual size",
	"getmempoolentryresult-size":            "Transaction size in bytes",
	"getmempoolentryresult-weight":          "Transaction weight",
	"getmempoolentryresult-fee":             "Transaction fee in HNS",
	"getmempoolentryresult-modifiedfee":     "Modified transaction fee in HNS",
	"getmempoolentryresult-time":            "Local time transaction entered the pool in seconds since 1 Jan 1970 GMT",
	"getmempoolentryresult-height":          "Block height when transaction entered the pool",
	"getmempoolentryresult-descendantcount": "Number of in-mempool descendants including this transaction",
	"getmempoolentryresult-descendantsize":  "Virtual size of in-mempool descendants including this transaction",
	"getmempoolentryresult-descendantfees":  "Fees of in-mempool descendants including this transaction",
	"getmempoolentryresult-ancestorcount":   "Number of in-mempool ancestors including this transaction",
	"getmempoolentryresult-ancestorsize":    "Virtual size of in-mempool ancestors including this transaction",
	"getmempoolentryresult-ancestorfees":    "Fees of in-mempool ancestors including this transaction",
	"getmempoolentryresult-wtxid":           "Witness transaction hash when available",
	"getmempoolentryresult-fees":            "Fee summary",
	"getmempoolentryresult-depends":         "Unconfirmed transactions used as inputs for this transaction",
	"mempoolfees-base":                      "Base transaction fee in HNS",
	"mempoolfees-modified":                  "Modified transaction fee in HNS",
	"mempoolfees-ancestor":                  "Ancestor package fees in HNS",
	"mempoolfees-descendant":                "Descendant package fees in HNS",

	// GetMempoolInfoResult help.
	"getmempoolinforesult-bytes": "Size in bytes of the mempool",
	"getmempoolinforesult-size":  "Number of transactions in the mempool",

	// GetMiningInfoResult help.
	"getmininginforesult-blocks":             "Height of the latest best block",
	"getmininginforesult-currentblocksize":   "Size of the latest best block",
	"getmininginforesult-currentblockweight": "Weight 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",

	// 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",

	// GetNetworkInfoCmd help.
	"getnetworkinfo--synopsis": "Returns network state and local service information.",
	"getnetworkinfo--result0":  "Network information",

	// GetNetworkInfoResult help.
	"getnetworkinforesult-version":               "The server version",
	"getnetworkinforesult-subversion":            "The server user agent",
	"getnetworkinforesult-protocolversion":       "The highest supported Handshake protocol version",
	"getnetworkinforesult-identitykey":           "The local Brontide identity key when available",
	"getnetworkinforesult-localservices":         "Hex-encoded local service flags",
	"getnetworkinforesult-localservicenames":     "Human-readable local service names",
	"getnetworkinforesult-localrelay":            "Whether transaction relay is enabled",
	"getnetworkinforesult-timeoffset":            "The local clock offset in seconds",
	"getnetworkinforesult-connections":           "Number of connected peers",
	"getnetworkinforesult-connections_in":        "Number of inbound peers",
	"getnetworkinforesult-connections_out":       "Number of outbound peers",
	"getnetworkinforesult-networkactive":         "Whether networking is active",
	"getnetworkinforesult-networks":              "Network reachability details",
	"getnetworkinforesult-relayfee":              "Minimum relay fee in HNS per kB",
	"getnetworkinforesult-incrementalfee":        "Incremental relay fee in HNS per kB",
	"getnetworkinforesult-localaddresses":        "Advertised local addresses",
	"getnetworkinforesult-warnings":              "Network warnings",
	"networksresult-name":                        "Network name",
	"networksresult-limited":                     "Whether the network is limited",
	"networksresult-reachable":                   "Whether the network is reachable",
	"networksresult-proxy":                       "Configured proxy",
	"networksresult-proxy_randomize_credentials": "Whether proxy credentials are randomized",
	"localaddressesresult-address":               "Advertised local address",
	"localaddressesresult-port":                  "Advertised local port",
	"localaddressesresult-score":                 "Local address discovery score",

	// 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",

	// GetNodeAddressesResult help.
	"getnodeaddressesresult-time":     "Timestamp in seconds since epoch (Jan 1 1970 GMT) keeping track of when the node was last seen",
	"getnodeaddressesresult-services": "The services offered",
	"getnodeaddressesresult-address":  "The address of the node",
	"getnodeaddressesresult-port":     "The port of the node",

	// GetNodeAddressesCmd help.
	"getnodeaddresses--synopsis": "Return known addresses which can potentially be used to find new nodes in the network",
	"getnodeaddresses-count":     "How many addresses to return. Limited to the smaller of 2500 or 23% of all known addresses",
	"getnodeaddresses--result0":  "List of node addresses",

	// 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-relaytxes":      "Peer has requested transactions be relayed to it",
	"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-feefilter":      "The requested minimum fee a transaction must have to be announced to the peer",
	"getpeerinforesult-syncnode":       "Whether or not the peer is the sync peer",
	"getpeerinforesult-v2_connection":  "Whether or not the peer is a v2 connection",

	// 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 bitcoins",
	"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",
	"getrawmempoolverboseresult-vsize":            "The virtual size of a transaction",
	"getrawmempoolverboseresult-weight":           "The transaction's weight (between vsize*4-3 and vsize*4)",

	// 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 BTC",
	"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",

	// InvalidateBlockCmd help.
	"invalidateblock--synopsis": "Invalidates the block of the given block hash. To re-validate the invalidated block, use the reconsiderblock rpc",
	"invalidateblock-blockhash": "The block hash of the block to invalidate",

	// 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.",

	// 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 Bitcoin address to search for",
	"searchrawtransactions-verbose":     "Specifies the transaction is returned as a JSON object instead of hex-encoded string",
	"searchrawtransactions--condition0": "verbose=0",
	"searchrawtransactions--condition1": "verbose=1",
	"searchrawtransactions-skip":        "The number of leading transactions to leave out of the final response",
	"searchrawtransactions-count":       "The maximum number of transactions to return",
	"searchrawtransactions-vinextra":    "Specify that extra data from previous output will be returned in vin",
	"searchrawtransactions-reverse":     "Specifies that the transactions should be returned in reverse chronological order",
	"searchrawtransactions-filteraddrs": "Address list.  Only inputs or outputs with matching address will be returned",
	"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-feesetting":   "Whether or not to allow insanely high fees in bitcoind < v0.19.0 or the max fee rate for bitcoind v0.19.0 and later (handshake-node does not yet implement this parameter, so it has no effect)",
	"sendrawtransaction--result0":     "The hash of the transaction",
	"allowhighfeesormaxfeerate-value": "Either the boolean value for the allowhighfees parameter in bitcoind < v0.19.0 or the numerical value for the maxfeerate field in bitcoind v0.19.0 and later",

	// SendRawClaimCmd help.
	"sendrawclaim--synopsis":   "Submits the base64-encoded raw Handshake claim proof and relays it to the network.",
	"sendrawclaim-base64proof": "Base64-encoded raw claim proof",
	"sendrawclaim--result0":    "The proof hash",

	// SendRawAirdropCmd help.
	"sendrawairdrop--synopsis":   "Submits the base64-encoded raw Handshake airdrop proof and relays it to the network.",
	"sendrawairdrop-base64proof": "Base64-encoded raw airdrop proof",
	"sendrawairdrop--result0":    "The proof hash",

	// 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",

	// SignMessageWithPrivKeyCmd help.
	"signmessagewithprivkey--synopsis": "Sign a message with the private key of an address",
	"signmessagewithprivkey-privkey":   "The private key to sign the message with",
	"signmessagewithprivkey-message":   "The message to create a signature of",
	"signmessagewithprivkey--result0":  "The signature of the message encoded in base 64",

	// StopCmd help.
	"stop--synopsis": "Shutdown handshake-node.",
	"stop--result0":  "The string 'handshake-node 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 bitcoin address (only when isvalid is true)",
	"validateaddresschainresult-isscript":        "If the key is a script",
	"validateaddresschainresult-iswitness":       "If the address is a witness address",
	"validateaddresschainresult-witness_version": "The version number of the witness program",
	"validateaddresschainresult-witness_program": "The hex value of the witness program",

	// ValidateAddressCmd help.
	"validateaddress--synopsis": "Verify an address is valid.",
	"validateaddress-address":   "Bitcoin 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 handshake-node 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 bitcoin 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.",

	// 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.",

	// NotifyNamesCmd help.
	"notifynames--synopsis":  "Send a nameupdated notification when a mempool transaction or newly-attached block contains a matching Handshake name covenant.",
	"notifynames-names":      "Optional names to receive notifications about. When omitted along with namehashes, all name covenant updates are sent.",
	"notifynames-namehashes": "Optional name hashes to receive notifications about. When omitted along with names, all name covenant updates are sent.",

	// StopNotifyNamesCmd help.
	"stopnotifynames--synopsis": "Cancel registered Handshake name covenant update notifications.",

	// 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",

	// NameUpdatedNtfn help.
	"nameupdatedntfn-name":         "The raw Handshake name when available",
	"nameupdatedntfn-namehash":     "The consensus name hash",
	"nameupdatedntfn-covenant":     "The covenant type name",
	"nameupdatedntfn-covenanttype": "The numeric covenant type",
	"nameupdatedntfn-txid":         "The transaction hash",
	"nameupdatedntfn-vout":         "The transaction output index containing the covenant",
	"nameupdatedntfn-block":        "The block details when the covenant is confirmed",

	// NotifySpentCmd help.
	"notifyspent--synopsis": "Send a redeemingtx notification when a transaction spending an outpoint appears in mempool (if relayed to this handshake-node 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.",

	// LoadTxFilterCmd help.
	"loadtxfilter--synopsis": "Load, add to, or reload a websocket client's transaction filter for mempool transactions, new blocks and rescanblocks.",
	"loadtxfilter-reload":    "Load a new filter instead of adding data to an existing one",
	"loadtxfilter-addresses": "Array of addresses to add to the transaction filter",
	"loadtxfilter-outpoints": "Array of outpoints to add to the transaction filter",

	// ReconsiderBlockCmd help.
	"reconsiderblock--synopsis": "Reconsiders the block of the given block hash. Can be used to re-validate blocks invalidated with invalidateblock",
	"reconsiderblock-blockhash": "The block hash of the block to reconsider",

	// 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",

	// RescanBlocks help.
	"rescanblocks--synopsis":   "Rescan blocks for transactions matching the loaded transaction filter.",
	"rescanblocks-blockhashes": "List of hashes to rescan.  Each next block must be a child of the previous.",
	"rescanblocks--result0":    "List of matching blocks.",

	// RescannedBlock help.
	"rescannedblock-hash":         "Hash of the matching block.",
	"rescannedblock-transactions": "List of matching transactions, serialized and hex-encoded.",

	// Uptime help.
	"uptime--synopsis": "Returns the total uptime of the server.",
	"uptime--result0":  "The number of seconds that the server has been running",

	// Version help.
	"version--synopsis":       "Returns the JSON-RPC API version (semver)",
	"version--result0--desc":  "Version objects keyed by the program or API name",
	"version--result0--key":   "Program or API name",
	"version--result0--value": "Object containing the semantic version",

	// VersionResult help.
	"versionresult-versionstring": "The JSON-RPC API version (semver)",
	"versionresult-major":         "The major component of the JSON-RPC API version",
	"versionresult-minor":         "The minor component of the JSON-RPC API version",
	"versionresult-patch":         "The patch component of the JSON-RPC API version",
	"versionresult-prerelease":    "Prerelease info about the current build",
	"versionresult-buildmetadata": "Metadata about the current build",

	// TestMempoolAcceptCmd help.
	"testmempoolaccept--synopsis":  "Returns result of mempool acceptance tests indicating if raw transaction(s) would be accepted by mempool.",
	"testmempoolaccept-rawtxns":    "Serialized transactions to test.",
	"testmempoolaccept-maxfeerate": "Maximum acceptable fee rate in BTC/kB",

	// TestMempoolAcceptCmd result help.
	"testmempoolacceptresult-txid":             "The transaction hash in hex.",
	"testmempoolacceptresult-wtxid":            "The transaction witness hash in hex.",
	"testmempoolacceptresult-package-error":    "Package validation error, if any (only possible if rawtxs had more than 1 transaction).",
	"testmempoolacceptresult-allowed":          "Whether the transaction would be accepted to the mempool.",
	"testmempoolacceptresult-vsize":            "Virtual transaction size as defined in BIP 141.(only present when 'allowed' is true)",
	"testmempoolacceptresult-reject-reason":    "Rejection string (only present when 'allowed' is false).",
	"testmempoolacceptresult-fees":             "Transaction fees (only present if 'allowed' is true).",
	"testmempoolacceptfees-base":               "Transaction fees (only present if 'allowed' is true).",
	"testmempoolacceptfees-effective-feerate":  "The effective feerate in BTC per KvB.",
	"testmempoolacceptfees-effective-includes": "Transactions whose fees and vsizes are included in effective-feerate. Each item is a transaction wtxid in hex.",

	// GetTxSpendingPrevOutCmd help.
	"gettxspendingprevout--synopsis": "Scans the mempool to find transactions spending any of the given outputs",
	"gettxspendingprevout-outputs":   "The transaction outputs that we want to check, and within each, the txid (string) vout (numeric).",
	"gettxspendingprevout-txid":      "The transaction id",
	"gettxspendingprevout-vout":      "The output number",

	// GetTxSpendingPrevOutCmd result help.
	"gettxspendingprevoutresult-txid":         "The transaction hash in hex.",
	"gettxspendingprevoutresult-vout":         "The output index.",
	"gettxspendingprevoutresult-spendingtxid": "The hash of the transaction that spends the output.",
}

// 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,
	"createbid":              {(*string)(nil)},
	"createfinalize":         {(*string)(nil)},
	"createopen":             {(*string)(nil)},
	"createrawtransaction":   {(*string)(nil)},
	"createregister":         {(*string)(nil)},
	"createredeem":           {(*string)(nil)},
	"createrenew":            {(*string)(nil)},
	"createreveal":           {(*string)(nil)},
	"createrevoke":           {(*string)(nil)},
	"createtransfer":         {(*string)(nil)},
	"createupdate":           {(*string)(nil)},
	"debuglevel":             {(*string)(nil), (*string)(nil)},
	"decoderawtransaction":   {(*hnsjson.TxRawDecodeResult)(nil)},
	"decoderesource":         {(*hnsjson.NameResourceDataResult)(nil)},
	"decodescript":           {(*hnsjson.DecodeScriptResult)(nil)},
	"estimatefee":            {(*float64)(nil)},
	"generate":               {(*[]string)(nil)},
	"getaddednodeinfo":       {(*[]string)(nil), (*[]hnsjson.GetAddedNodeInfoResult)(nil)},
	"getbestblock":           {(*hnsjson.GetBestBlockResult)(nil)},
	"getbestblockhash":       {(*string)(nil)},
	"getblock":               {(*string)(nil), (*hnsjson.GetBlockVerboseResult)(nil)},
	"getblockbyheight":       {(*string)(nil), (*hnsjson.GetBlockVerboseResult)(nil)},
	"getblockcount":          {(*int64)(nil)},
	"getblockhash":           {(*string)(nil)},
	"getblockheader":         {(*string)(nil), (*hnsjson.GetBlockHeaderVerboseResult)(nil)},
	"getblocktemplate":       {(*hnsjson.GetBlockTemplateResult)(nil), (*string)(nil), nil},
	"getblockchaininfo":      {(*hnsjson.GetBlockChainInfoResult)(nil)},
	"getchaintips":           {(*[]hnsjson.GetChainTipsResult)(nil)},
	"getcfilter":             {(*string)(nil)},
	"getcfilterheader":       {(*string)(nil)},
	"getconnectioncount":     {(*int32)(nil)},
	"getcurrentnet":          {(*uint32)(nil)},
	"getdifficulty":          {(*float64)(nil)},
	"getgenerate":            {(*bool)(nil)},
	"gethashespersec":        {(*float64)(nil)},
	"getheaders":             {(*[]string)(nil)},
	"getinfo":                {(*hnsjson.InfoChainResult)(nil)},
	"getmempoolancestors":    {(*[]string)(nil), (*[]hnsjson.GetMempoolEntryResult)(nil)},
	"getmempooldescendants":  {(*[]string)(nil), (*[]hnsjson.GetMempoolEntryResult)(nil)},
	"getmempoolentry":        {(*hnsjson.GetMempoolEntryResult)(nil)},
	"getmempoolinfo":         {(*hnsjson.GetMempoolInfoResult)(nil)},
	"getmininginfo":          {(*hnsjson.GetMiningInfoResult)(nil)},
	"getauctioninfo":         {(*hnsjson.GetAuctionInfoResult)(nil)},
	"getnamebyhash":          {(*hnsjson.GetNameInfoResult)(nil)},
	"getnameinfo":            {(*hnsjson.GetNameInfoResult)(nil)},
	"getnameproof":           {(*hnsjson.GetNameProofResult)(nil)},
	"getnameresource":        {(*hnsjson.GetNameResourceResult)(nil)},
	"getnames":               {(*[]hnsjson.NameStateResult)(nil)},
	"getnamesbyhash":         {(*[]hnsjson.GetNameInfoResult)(nil)},
	"getnettotals":           {(*hnsjson.GetNetTotalsResult)(nil)},
	"getnetworkinfo":         {(*hnsjson.GetNetworkInfoResult)(nil)},
	"getnetworkhashps":       {(*float64)(nil)},
	"getnodeaddresses":       {(*[]hnsjson.GetNodeAddressesResult)(nil)},
	"getpeerinfo":            {(*[]hnsjson.GetPeerInfoResult)(nil)},
	"getrawmempool":          {(*[]string)(nil), (*hnsjson.GetRawMempoolVerboseResult)(nil)},
	"getrawtransaction":      {(*string)(nil), (*hnsjson.TxRawResult)(nil)},
	"gettxout":               {(*hnsjson.GetTxOutResult)(nil)},
	"node":                   nil,
	"help":                   {(*string)(nil), (*string)(nil)},
	"invalidateblock":        nil,
	"ping":                   nil,
	"reconsiderblock":        nil,
	"searchrawtransactions":  {(*string)(nil), (*[]hnsjson.SearchRawTransactionsResult)(nil)},
	"sendrawairdrop":         {(*string)(nil)},
	"sendrawclaim":           {(*string)(nil)},
	"sendrawtransaction":     {(*string)(nil)},
	"setgenerate":            nil,
	"signmessagewithprivkey": {(*string)(nil)},
	"stop":                   {(*string)(nil)},
	"submitblock":            {nil, (*string)(nil)},
	"uptime":                 {(*int64)(nil)},
	"validateaddress":        {(*hnsjson.ValidateAddressChainResult)(nil)},
	"verifychain":            {(*bool)(nil)},
	"verifynameproof":        {(*hnsjson.VerifyNameProofResult)(nil)},
	"verifymessage":          {(*bool)(nil)},
	"version":                {(*map[string]hnsjson.VersionResult)(nil)},
	"testmempoolaccept":      {(*[]hnsjson.TestMempoolAcceptResult)(nil)},
	"gettxspendingprevout":   {(*[]hnsjson.GetTxSpendingPrevOutResult)(nil)},

	// Websocket commands.
	"loadtxfilter":              nil,
	"session":                   {(*hnsjson.SessionResult)(nil)},
	"notifyblocks":              nil,
	"notifynames":               nil,
	"stopnotifyblocks":          nil,
	"stopnotifynames":           nil,
	"notifynewtransactions":     nil,
	"stopnotifynewtransactions": nil,
	"notifyreceived":            nil,
	"stopnotifyreceived":        nil,
	"notifyspent":               nil,
	"stopnotifyspent":           nil,
	"rescan":                    nil,
	"rescanblocks":              {(*[]hnsjson.RescannedBlock)(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 {
	sync.Mutex
	usage      string
	methodHelp map[string]string
}

// 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) {
	c.Lock()
	defer c.Unlock()

	// Return the cached method help if it exists.
	if help, exists := c.methodHelp[method]; exists {
		return help, nil
	}

	// Look up the result types for the method.
	resultTypes, ok := rpcResultTypes[method]
	if !ok {
		return "", errors.New("no result types specified for method " +
			method)
	}

	// Generate, cache, and return the help.
	help, err := hnsjson.GenerateHelp(method, helpDescsEnUS, resultTypes...)
	if err != nil {
		return "", err
	}
	c.methodHelp[method] = help
	return help, nil
}

// 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) {
	c.Lock()
	defer c.Unlock()

	// Return the cached usage if it is available.
	if c.usage != "" {
		return c.usage, nil
	}

	// Generate a list of one-line usage for every command.
	usageTexts := make([]string, 0, len(rpcHandlers))
	for k := range rpcHandlers {
		usage, err := hnsjson.MethodUsageText(k)
		if err != nil {
			return "", err
		}
		usageTexts = append(usageTexts, usage)
	}

	// Include websockets commands if requested.
	if includeWebsockets {
		for k := range wsHandlers {
			usage, err := hnsjson.MethodUsageText(k)
			if err != nil {
				return "", err
			}
			usageTexts = append(usageTexts, usage)
		}
	}

	sort.Strings(usageTexts)
	c.usage = strings.Join(usageTexts, "\n")
	return c.usage, nil
}

// 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 {
	return &helpCacher{
		methodHelp: make(map[string]string),
	}
}