Merge #824: RPC Docs: add 22.0.0

ee81ea6 RPC Docs: add 22.0.0 (Andrew Toth)
aa71246 RPC Docs: update generate.go to use new version scheme (Andrew Toth)

Pull request description:

  Generated using this repo's `contrib/doc-gen/generate.go`. The first commit is updating that script to use the new version scheme introduced in 22.0.0.

  Should be fully deterministic, so anyone wanting to review can install 22.0.0 and run the following:
  ```
  bitcoind --daemon --regtest
  cd contrib/doc-gen
  go run generate.go
  ```

  I lightly tested a local preview and didn't see anything broken this release.

  Closes #820.

ACKs for top commit:
  Sjors:
    tACK ee81ea6
  harding:
    Tested ACK ee81ea6 Thanks!

Tree-SHA512: f0768411b6cc2d28a13f69efa353a0cd70269db2605816de41cd21f229e2860441159b9781a8f71577e2817d88c949b2017d999ae105f8f1e13dfdf323443e55

Author: harding

_doc/en/22.0.0/index.html

@@ -0,0 +1,8 @@
+---
+name: index
+btcversion: 22.0.0
+btcgroup: index
+permalink: en/doc/22.0.0/
+---
+
+

_doc/en/22.0.0/rpc/blockchain/getbestblockhash.html

@@ -0,0 +1,19 @@
+---
+name: getbestblockhash
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getbestblockhash/
+---
+
+getbestblockhash
+
+Returns the hash of the best (tip) block in the most-work fully-validated chain.
+
+Result:
+"hex"    (string) the block hash, hex-encoded
+
+Examples:
+> bitcoin-cli getbestblockhash 
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getbestblockhash", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblock.html

@@ -0,0 +1,63 @@
+---
+name: getblock
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblock/
+---
+
+getblock "blockhash" ( verbosity )
+
+If verbosity is 0, returns a string that is serialized, hex-encoded data for block 'hash'.
+If verbosity is 1, returns an Object with information about block <hash>.
+If verbosity is 2, returns an Object with information about block <hash> and information about each transaction. 
+
+Arguments:
+1. blockhash    (string, required) The block hash
+2. verbosity    (numeric, optional, default=1) 0 for hex-encoded data, 1 for a json object, and 2 for json object with transaction data
+
+Result (for verbosity = 0):
+"hex"    (string) A string that is serialized, hex-encoded data for block 'hash'
+
+Result (for verbosity = 1):
+{                                 (json object)
+  "hash" : "hex",                 (string) the block hash (same as provided)
+  "confirmations" : n,            (numeric) The number of confirmations, or -1 if the block is not on the main chain
+  "size" : n,                     (numeric) The block size
+  "strippedsize" : n,             (numeric) The block size excluding witness data
+  "weight" : n,                   (numeric) The block weight as defined in BIP 141
+  "height" : n,                   (numeric) The block height or index
+  "version" : n,                  (numeric) The block version
+  "versionHex" : "hex",           (string) The block version formatted in hexadecimal
+  "merkleroot" : "hex",           (string) The merkle root
+  "tx" : [                        (json array) The transaction ids
+    "hex",                        (string) The transaction id
+    ...
+  ],
+  "time" : xxx,                   (numeric) The block time expressed in UNIX epoch time
+  "mediantime" : xxx,             (numeric) The median block time expressed in UNIX epoch time
+  "nonce" : n,                    (numeric) The nonce
+  "bits" : "hex",                 (string) The bits
+  "difficulty" : n,               (numeric) The difficulty
+  "chainwork" : "hex",            (string) Expected number of hashes required to produce the chain up to this block (in hex)
+  "nTx" : n,                      (numeric) The number of transactions in the block
+  "previousblockhash" : "hex",    (string, optional) The hash of the previous block (if available)
+  "nextblockhash" : "hex"         (string, optional) The hash of the next block (if available)
+}
+
+Result (for verbosity = 2):
+{                   (json object)
+  ...,              Same output as verbosity = 1
+  "tx" : [          (json array)
+    {               (json object)
+      ...,          The transactions in the format of the getrawtransaction RPC. Different from verbosity = 1 "tx" result
+      "fee" : n     (numeric) The transaction fee in BTC, omitted if block undo data is not available
+    },
+    ...
+  ]
+}
+
+Examples:
+> bitcoin-cli getblock "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblock", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblockchaininfo.html

@@ -0,0 +1,57 @@
+---
+name: getblockchaininfo
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblockchaininfo/
+---
+
+getblockchaininfo
+Returns an object containing various state info regarding blockchain processing.
+
+Result:
+{                                         (json object)
+  "chain" : "str",                        (string) current network name (main, test, signet, regtest)
+  "blocks" : n,                           (numeric) the height of the most-work fully-validated chain. The genesis block has height 0
+  "headers" : n,                          (numeric) the current number of headers we have validated
+  "bestblockhash" : "str",                (string) the hash of the currently best block
+  "difficulty" : n,                       (numeric) the current difficulty
+  "mediantime" : n,                       (numeric) median time for the current best block
+  "verificationprogress" : n,             (numeric) estimate of verification progress [0..1]
+  "initialblockdownload" : true|false,    (boolean) (debug information) estimate of whether this node is in Initial Block Download mode
+  "chainwork" : "hex",                    (string) total amount of work in active chain, in hexadecimal
+  "size_on_disk" : n,                     (numeric) the estimated size of the block and undo files on disk
+  "pruned" : true|false,                  (boolean) if the blocks are subject to pruning
+  "pruneheight" : n,                      (numeric) lowest-height complete block stored (only present if pruning is enabled)
+  "automatic_pruning" : true|false,       (boolean) whether automatic pruning is enabled (only present if pruning is enabled)
+  "prune_target_size" : n,                (numeric) the target size used by pruning (only present if automatic pruning is enabled)
+  "softforks" : {                         (json object) status of softforks
+    "xxxx" : {                            (json object) name of the softfork
+      "type" : "str",                     (string) one of "buried", "bip9"
+      "bip9" : {                          (json object) status of bip9 softforks (only for "bip9" type)
+        "status" : "str",                 (string) one of "defined", "started", "locked_in", "active", "failed"
+        "bit" : n,                        (numeric) the bit (0-28) in the block version field used to signal this softfork (only for "started" status)
+        "start_time" : xxx,               (numeric) the minimum median time past of a block at which the bit gains its meaning
+        "timeout" : xxx,                  (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in
+        "since" : n,                      (numeric) height of the first block to which the status applies
+        "min_activation_height" : n,      (numeric) minimum height of blocks for which the rules may be enforced
+        "statistics" : {                  (json object) numeric statistics about BIP9 signalling for a softfork (only for "started" status)
+          "period" : n,                   (numeric) the length in blocks of the BIP9 signalling period
+          "threshold" : n,                (numeric) the number of blocks with the version bit set required to activate the feature
+          "elapsed" : n,                  (numeric) the number of blocks elapsed since the beginning of the current period
+          "count" : n,                    (numeric) the number of blocks with the version bit set in the current period
+          "possible" : true|false         (boolean) returns false if there are not enough blocks left in this period to pass activation threshold
+        }
+      },
+      "height" : n,                       (numeric) height of the first block which the rules are or will be enforced (only for "buried" type, or "bip9" type with "active" status)
+      "active" : true|false               (boolean) true if the rules are enforced for the mempool and the next block
+    },
+    ...
+  },
+  "warnings" : "str"                      (string) any network and blockchain warnings
+}
+
+Examples:
+> bitcoin-cli getblockchaininfo 
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockchaininfo", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblockcount.html

@@ -0,0 +1,20 @@
+---
+name: getblockcount
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblockcount/
+---
+
+getblockcount
+
+Returns the height of the most-work fully-validated chain.
+The genesis block has height 0.
+
+Result:
+n    (numeric) The current block count
+
+Examples:
+> bitcoin-cli getblockcount 
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockcount", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblockfilter.html

@@ -0,0 +1,26 @@
+---
+name: getblockfilter
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblockfilter/
+---
+
+getblockfilter "blockhash" ( "filtertype" )
+
+Retrieve a BIP 157 content filter for a particular block.
+
+Arguments:
+1. blockhash     (string, required) The hash of the block
+2. filtertype    (string, optional, default="basic") The type name of the filter
+
+Result:
+{                      (json object)
+  "filter" : "hex",    (string) the hex-encoded filter data
+  "header" : "hex"     (string) the hex-encoded filter header
+}
+
+Examples:
+> bitcoin-cli getblockfilter "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09" "basic"
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockfilter", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09", "basic"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblockhash.html

@@ -0,0 +1,22 @@
+---
+name: getblockhash
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblockhash/
+---
+
+getblockhash height
+
+Returns hash of block in best-block-chain at height provided.
+
+Arguments:
+1. height    (numeric, required) The height index
+
+Result:
+"hex"    (string) The block hash
+
+Examples:
+> bitcoin-cli getblockhash 1000
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockhash", "params": [1000]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblockheader.html

@@ -0,0 +1,43 @@
+---
+name: getblockheader
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblockheader/
+---
+
+getblockheader "blockhash" ( verbose )
+
+If verbose is false, returns a string that is serialized, hex-encoded data for blockheader 'hash'.
+If verbose is true, returns an Object with information about blockheader <hash>.
+
+Arguments:
+1. blockhash    (string, required) The block hash
+2. verbose      (boolean, optional, default=true) true for a json object, false for the hex-encoded data
+
+Result (for verbose = true):
+{                                 (json object)
+  "hash" : "hex",                 (string) the block hash (same as provided)
+  "confirmations" : n,            (numeric) The number of confirmations, or -1 if the block is not on the main chain
+  "height" : n,                   (numeric) The block height or index
+  "version" : n,                  (numeric) The block version
+  "versionHex" : "hex",           (string) The block version formatted in hexadecimal
+  "merkleroot" : "hex",           (string) The merkle root
+  "time" : xxx,                   (numeric) The block time expressed in UNIX epoch time
+  "mediantime" : xxx,             (numeric) The median block time expressed in UNIX epoch time
+  "nonce" : n,                    (numeric) The nonce
+  "bits" : "hex",                 (string) The bits
+  "difficulty" : n,               (numeric) The difficulty
+  "chainwork" : "hex",            (string) Expected number of hashes required to produce the current chain
+  "nTx" : n,                      (numeric) The number of transactions in the block
+  "previousblockhash" : "hex",    (string, optional) The hash of the previous block (if available)
+  "nextblockhash" : "hex"         (string, optional) The hash of the next block (if available)
+}
+
+Result (for verbose=false):
+"hex"    (string) A string that is serialized, hex-encoded data for block 'hash'
+
+Examples:
+> bitcoin-cli getblockheader "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockheader", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getblockstats.html

@@ -0,0 +1,67 @@
+---
+name: getblockstats
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getblockstats/
+---
+
+getblockstats hash_or_height ( stats )
+
+Compute per block statistics for a given window. All amounts are in satoshis.
+It won't work for some heights with pruning.
+
+Arguments:
+1. hash_or_height    (string or numeric, required) The block hash or height of the target block
+2. stats             (json array, optional, default=all values) Values to plot (see result below)
+     [
+       "height",     (string) Selected statistic
+       "time",       (string) Selected statistic
+       ...
+     ]
+
+Result:
+{                              (json object)
+  "avgfee" : n,                (numeric) Average fee in the block
+  "avgfeerate" : n,            (numeric) Average feerate (in satoshis per virtual byte)
+  "avgtxsize" : n,             (numeric) Average transaction size
+  "blockhash" : "hex",         (string) The block hash (to check for potential reorgs)
+  "feerate_percentiles" : [    (json array) Feerates at the 10th, 25th, 50th, 75th, and 90th percentile weight unit (in satoshis per virtual byte)
+    n,                         (numeric) The 10th percentile feerate
+    n,                         (numeric) The 25th percentile feerate
+    n,                         (numeric) The 50th percentile feerate
+    n,                         (numeric) The 75th percentile feerate
+    n                          (numeric) The 90th percentile feerate
+  ],
+  "height" : n,                (numeric) The height of the block
+  "ins" : n,                   (numeric) The number of inputs (excluding coinbase)
+  "maxfee" : n,                (numeric) Maximum fee in the block
+  "maxfeerate" : n,            (numeric) Maximum feerate (in satoshis per virtual byte)
+  "maxtxsize" : n,             (numeric) Maximum transaction size
+  "medianfee" : n,             (numeric) Truncated median fee in the block
+  "mediantime" : n,            (numeric) The block median time past
+  "mediantxsize" : n,          (numeric) Truncated median transaction size
+  "minfee" : n,                (numeric) Minimum fee in the block
+  "minfeerate" : n,            (numeric) Minimum feerate (in satoshis per virtual byte)
+  "mintxsize" : n,             (numeric) Minimum transaction size
+  "outs" : n,                  (numeric) The number of outputs
+  "subsidy" : n,               (numeric) The block subsidy
+  "swtotal_size" : n,          (numeric) Total size of all segwit transactions
+  "swtotal_weight" : n,        (numeric) Total weight of all segwit transactions
+  "swtxs" : n,                 (numeric) The number of segwit transactions
+  "time" : n,                  (numeric) The block time
+  "total_out" : n,             (numeric) Total amount in all outputs (excluding coinbase and thus reward [ie subsidy + totalfee])
+  "total_size" : n,            (numeric) Total size of all non-coinbase transactions
+  "total_weight" : n,          (numeric) Total weight of all non-coinbase transactions
+  "totalfee" : n,              (numeric) The fee total
+  "txs" : n,                   (numeric) The number of transactions (including coinbase)
+  "utxo_increase" : n,         (numeric) The increase/decrease in the number of unspent outputs
+  "utxo_size_inc" : n          (numeric) The increase/decrease in size for the utxo index (not discounting op_return and similar)
+}
+
+Examples:
+> bitcoin-cli getblockstats '"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"' '["minfeerate","avgfeerate"]'
+> bitcoin-cli getblockstats 1000 '["minfeerate","avgfeerate"]'
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockstats", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09", ["minfeerate","avgfeerate"]]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockstats", "params": [1000, ["minfeerate","avgfeerate"]]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+

_doc/en/22.0.0/rpc/blockchain/getchaintips.html

@@ -0,0 +1,32 @@
+---
+name: getchaintips
+btcversion: 22.0.0
+btcgroup: blockchain
+permalink: en/doc/22.0.0/rpc/blockchain/getchaintips/
+---
+
+getchaintips
+Return information about all known tips in the block tree, including the main chain as well as orphaned branches.
+
+Result:
+[                        (json array)
+  {                      (json object)
+    "height" : n,        (numeric) height of the chain tip
+    "hash" : "hex",      (string) block hash of the tip
+    "branchlen" : n,     (numeric) zero for main chain, otherwise length of branch connecting the tip to the main chain
+    "status" : "str"     (string) status of the chain, "active" for the main chain
+                         Possible values for status:
+                         1.  "invalid"               This branch contains at least one invalid block
+                         2.  "headers-only"          Not all blocks for this branch are available, but the headers are valid
+                         3.  "valid-headers"         All blocks are available for this branch, but they were never fully validated
+                         4.  "valid-fork"            This branch is not part of the active chain, but is fully validated
+                         5.  "active"                This is the tip of the active main chain, which is certainly valid
+  },
+  ...
+]
+
+Examples:
+> bitcoin-cli getchaintips 
+> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getchaintips", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
+
+