Branch data Line data Source code
1 : : // Copyright (c) 2017-present The Bitcoin Core developers
2 : : // Distributed under the MIT software license, see the accompanying
3 : : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
4 : :
5 : : #include <chain.h>
6 : : #include <common/args.h>
7 : : #include <common/messages.h>
8 : : #include <common/types.h>
9 : : #include <consensus/amount.h>
10 : : #include <core_io.h>
11 : : #include <key_io.h>
12 : : #include <node/types.h>
13 : : #include <outputtype.h>
14 : : #include <pow.h>
15 : : #include <rpc/util.h>
16 : : #include <script/descriptor.h>
17 : : #include <script/interpreter.h>
18 : : #include <script/signingprovider.h>
19 : : #include <script/solver.h>
20 : : #include <tinyformat.h>
21 : : #include <uint256.h>
22 : : #include <univalue.h>
23 : : #include <util/bip32.h>
24 : : #include <util/check.h>
25 : : #include <util/result.h>
26 : : #include <util/strencodings.h>
27 : : #include <util/string.h>
28 : : #include <util/translation.h>
29 : :
30 : : #include <algorithm>
31 : : #include <iterator>
32 : : #include <string_view>
33 : : #include <tuple>
34 : : #include <utility>
35 : :
36 : : using common::PSBTError;
37 : : using common::PSBTErrorString;
38 : : using common::TransactionErrorString;
39 : : using node::TransactionError;
40 : : using util::Join;
41 : : using util::SplitString;
42 : : using util::TrimString;
43 : :
44 : : const std::string UNIX_EPOCH_TIME = "UNIX epoch time";
45 : : const std::string EXAMPLE_ADDRESS[2] = {"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl", "bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3"};
46 : :
47 : 74448 : std::string GetAllOutputTypes()
48 : : {
49 : 74448 : std::vector<std::string> ret;
50 : 74448 : using U = std::underlying_type_t<TxoutType>;
51 [ + + ]: 893376 : for (U i = (U)TxoutType::NONSTANDARD; i <= (U)TxoutType::WITNESS_UNKNOWN; ++i) {
52 [ + - + - ]: 1637856 : ret.emplace_back(GetTxnOutputType(static_cast<TxoutType>(i)));
53 : : }
54 [ + - ]: 148896 : return Join(ret, ", ");
55 : 74448 : }
56 : :
57 : 2028 : void RPCTypeCheckObj(const UniValue& o,
58 : : const std::map<std::string, UniValueType>& typesExpected,
59 : : bool fAllowNull,
60 : : bool fStrict)
61 : : {
62 [ + + ]: 23788 : for (const auto& t : typesExpected) {
63 [ - + ]: 21796 : const UniValue& v = o.find_value(t.first);
64 [ + + + + ]: 21796 : if (!fAllowNull && v.isNull())
65 [ + - + - ]: 22 : throw JSONRPCError(RPC_TYPE_ERROR, strprintf("Missing %s", t.first));
66 : :
67 [ + + + + : 38297 : if (!(t.second.typeAny || v.type() == t.second.type || (fAllowNull && v.isNull())))
+ + ]
68 [ + - + - : 50 : throw JSONRPCError(RPC_TYPE_ERROR, strprintf("JSON value of type %s for field %s is not of expected type %s", uvTypeName(v.type()), t.first, uvTypeName(t.second.type)));
+ - + - ]
69 : : }
70 : :
71 [ + + ]: 1992 : if (fStrict)
72 : : {
73 [ + + ]: 3258 : for (const std::string& k : o.getKeys())
74 : : {
75 [ + + ]: 2225 : if (!typesExpected.contains(k))
76 : : {
77 : 4 : std::string err = strprintf("Unexpected key %s", k);
78 [ + - ]: 4 : throw JSONRPCError(RPC_TYPE_ERROR, err);
79 : 4 : }
80 : : }
81 : : }
82 : 1988 : }
83 : :
84 : 13267 : int ParseVerbosity(const UniValue& arg, int default_verbosity, bool allow_bool)
85 : : {
86 [ + + ]: 13267 : if (!arg.isNull()) {
87 [ + + ]: 11275 : if (arg.isBool()) {
88 [ + + ]: 4648 : if (!allow_bool) {
89 [ + - + - ]: 4 : throw JSONRPCError(RPC_TYPE_ERROR, "Verbosity was boolean but only integer allowed");
90 : : }
91 : 4646 : return arg.get_bool(); // true = 1
92 : : } else {
93 : 6627 : return arg.getInt<int>();
94 : : }
95 : : }
96 : : return default_verbosity;
97 : : }
98 : :
99 : 52365 : CAmount AmountFromValue(const UniValue& value, int decimals)
100 : : {
101 [ + + + + ]: 52365 : if (!value.isNum() && !value.isStr())
102 [ + - + - ]: 24 : throw JSONRPCError(RPC_TYPE_ERROR, "Amount is not a number or string");
103 : 52353 : int64_t amount;
104 [ - + + + ]: 52353 : if (!ParseFixedPoint(value.getValStr(), decimals, &amount))
105 [ + - + - ]: 166 : throw JSONRPCError(RPC_TYPE_ERROR, "Invalid amount");
106 [ + + ]: 52270 : if (!MoneyRange(amount))
107 [ + - + - ]: 24 : throw JSONRPCError(RPC_TYPE_ERROR, "Amount out of range");
108 : 52258 : return amount;
109 : : }
110 : :
111 : 35894 : CFeeRate ParseFeeRate(const UniValue& json)
112 : : {
113 : 35894 : CAmount val{AmountFromValue(json)};
114 [ + + + - : 35894 : if (val >= COIN) throw JSONRPCError(RPC_INVALID_PARAMETER, "Fee rates larger than or equal to 1BTC/kvB are not accepted");
+ - ]
115 : 35892 : return CFeeRate{val};
116 : : }
117 : :
118 : 37124 : uint256 ParseHashV(const UniValue& v, std::string_view name)
119 : : {
120 : 37124 : const std::string& strHex(v.get_str());
121 [ - + + + ]: 37123 : if (auto rv{uint256::FromHex(strHex)}) return *rv;
122 [ - + + + ]: 28 : if (auto expected_len{uint256::size() * 2}; strHex.length() != expected_len) {
123 [ - + + - : 32 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("%s must be of length %d (not %d, for '%s')", name, expected_len, strHex.length(), strHex));
+ - ]
124 : : }
125 [ + - + - ]: 24 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("%s must be hexadecimal string (not '%s')", name, strHex));
126 : : }
127 : 6561 : uint256 ParseHashO(const UniValue& o, std::string_view strKey)
128 : : {
129 : 6561 : return ParseHashV(o.find_value(strKey), strKey);
130 : : }
131 : 952 : std::vector<unsigned char> ParseHexV(const UniValue& v, std::string_view name)
132 : : {
133 [ + - ]: 952 : std::string strHex;
134 [ + - ]: 952 : if (v.isStr())
135 [ + - + - ]: 952 : strHex = v.get_str();
136 [ - + + - : 952 : if (!IsHex(strHex))
+ + ]
137 [ + - + - ]: 8 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("%s must be hexadecimal string (not '%s')", name, strHex));
138 [ - + + - ]: 948 : return ParseHex(strHex);
139 : 948 : }
140 : 600 : std::vector<unsigned char> ParseHexO(const UniValue& o, std::string_view strKey)
141 : : {
142 : 600 : return ParseHexV(o.find_value(strKey), strKey);
143 : : }
144 : :
145 : : namespace {
146 : :
147 : : /**
148 : : * Quote an argument for shell.
149 : : *
150 : : * @note This is intended for help, not for security-sensitive purposes.
151 : : */
152 : 3484 : std::string ShellQuote(const std::string& s)
153 : : {
154 [ - + ]: 3484 : std::string result;
155 [ - + + - ]: 3484 : result.reserve(s.size() * 2);
156 [ - + + + ]: 251377 : for (const char ch: s) {
157 [ + + ]: 247893 : if (ch == '\'') {
158 [ + - ]: 1 : result += "'\''";
159 : : } else {
160 [ + - ]: 495785 : result += ch;
161 : : }
162 : : }
163 [ + - ]: 6968 : return "'" + result + "'";
164 : 3484 : }
165 : :
166 : : /**
167 : : * Shell-quotes the argument if it needs quoting, else returns it literally, to save typing.
168 : : *
169 : : * @note This is intended for help, not for security-sensitive purposes.
170 : : */
171 : 15994 : std::string ShellQuoteIfNeeded(const std::string& s)
172 : : {
173 [ - + + + ]: 118660 : for (const char ch: s) {
174 [ + + + + ]: 106150 : if (ch == ' ' || ch == '\'' || ch == '"') {
175 : 3484 : return ShellQuote(s);
176 : : }
177 : : }
178 : :
179 [ - + ]: 12510 : return s;
180 : : }
181 : :
182 : : }
183 : :
184 : 788311 : std::string HelpExampleCli(const std::string& methodname, const std::string& args)
185 : : {
186 [ + - + - ]: 2364933 : return "> bitcoin-cli " + methodname + " " + args + "\n";
187 : : }
188 : :
189 : 6791 : std::string HelpExampleCliNamed(const std::string& methodname, const RPCArgList& args)
190 : : {
191 : 6791 : std::string result = "> bitcoin-cli -named " + methodname;
192 [ + + ]: 22785 : for (const auto& argpair: args) {
193 [ + + ]: 15994 : const auto& value = argpair.second.isStr()
194 [ + + + - : 15994 : ? argpair.second.get_str()
- + ]
195 [ + - ]: 6518 : : argpair.second.write();
196 [ + - + - : 47982 : result += " " + argpair.first + "=" + ShellQuoteIfNeeded(value);
+ - ]
197 : 15994 : }
198 [ + - ]: 6791 : result += "\n";
199 : 6791 : return result;
200 : 0 : }
201 : :
202 : 527534 : std::string HelpExampleRpc(const std::string& methodname, const std::string& args)
203 : : {
204 : 527534 : return "> curl --user myusername --data-binary '{\"jsonrpc\": \"2.0\", \"id\": \"curltest\", "
205 [ + - + - ]: 1582602 : "\"method\": \"" + methodname + "\", \"params\": [" + args + "]}' -H 'content-type: application/json' http://127.0.0.1:8332/\n";
206 : : }
207 : :
208 : 4210 : std::string HelpExampleRpcNamed(const std::string& methodname, const RPCArgList& args)
209 : : {
210 : 4210 : UniValue params(UniValue::VOBJ);
211 [ + + ]: 15045 : for (const auto& param: args) {
212 [ + - - + : 32505 : params.pushKV(param.first, param.second);
+ - ]
213 : : }
214 : :
215 : 4210 : return "> curl --user myusername --data-binary '{\"jsonrpc\": \"2.0\", \"id\": \"curltest\", "
216 [ + - + - : 16840 : "\"method\": \"" + methodname + "\", \"params\": " + params.write() + "}' -H 'content-type: application/json' http://127.0.0.1:8332/\n";
+ - ]
217 : 4210 : }
218 : :
219 : : // Converts a hex string to a public key if possible
220 : 568 : CPubKey HexToPubKey(const std::string& hex_in)
221 : : {
222 [ - + + + ]: 568 : if (!IsHex(hex_in)) {
223 [ + - + - ]: 3 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Pubkey \"" + hex_in + "\" must be a hex string");
224 : : }
225 [ - + + + : 567 : if (hex_in.length() != 66 && hex_in.length() != 130) {
+ + ]
226 [ + - + - ]: 3 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Pubkey \"" + hex_in + "\" must have a length of either 33 or 65 bytes");
227 : : }
228 [ - + ]: 566 : CPubKey vchPubKey(ParseHex(hex_in));
229 [ - + ]: 566 : if (!vchPubKey.IsFullyValid()) {
230 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, "Pubkey \"" + hex_in + "\" must be cryptographically valid.");
231 : : }
232 : 566 : return vchPubKey;
233 : : }
234 : :
235 : : // Creates a multisig address from a given list of public keys, number of signatures required, and the address type
236 : 83 : CTxDestination AddAndGetMultisigDestination(const int required, const std::vector<CPubKey>& pubkeys, OutputType type, FlatSigningProvider& keystore, CScript& script_out)
237 : : {
238 : : // Gather public keys
239 [ - + ]: 83 : if (required < 1) {
240 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_PARAMETER, "a multisignature address must require at least one key to redeem");
241 : : }
242 [ - + - + ]: 83 : if ((int)pubkeys.size() < required) {
243 [ # # # # : 0 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("not enough keys supplied (got %u keys, but need at least %d to redeem)", pubkeys.size(), required));
# # ]
244 : : }
245 [ + + ]: 83 : if (pubkeys.size() > MAX_PUBKEYS_PER_MULTISIG) {
246 [ + - + - ]: 4 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("Number of keys involved in the multisignature address creation > %d\nReduce the number", MAX_PUBKEYS_PER_MULTISIG));
247 : : }
248 : :
249 : 81 : script_out = GetScriptForMultisig(required, pubkeys);
250 : :
251 : : // Check if any keys are uncompressed. If so, the type is legacy
252 [ + + ]: 543 : for (const CPubKey& pk : pubkeys) {
253 [ + + ]: 480 : if (!pk.IsCompressed()) {
254 : : type = OutputType::LEGACY;
255 : : break;
256 : : }
257 : : }
258 : :
259 [ + + + - : 81 : if (type == OutputType::LEGACY && script_out.size() > MAX_SCRIPT_ELEMENT_SIZE) {
+ + ]
260 [ + - + - : 3 : throw JSONRPCError(RPC_INVALID_PARAMETER, (strprintf("redeemScript exceeds size limit: %d > %d", script_out.size(), MAX_SCRIPT_ELEMENT_SIZE)));
+ - ]
261 : : }
262 : :
263 : : // Make the address
264 : 80 : CTxDestination dest = AddAndGetDestinationForScript(keystore, script_out, type);
265 : :
266 : 80 : return dest;
267 : : }
268 : :
269 : : class DescribeAddressVisitor
270 : : {
271 : : public:
272 : : explicit DescribeAddressVisitor() = default;
273 : :
274 : 0 : UniValue operator()(const CNoDestination& dest) const
275 : : {
276 : 0 : return UniValue(UniValue::VOBJ);
277 : : }
278 : :
279 : 0 : UniValue operator()(const PubKeyDestination& dest) const
280 : : {
281 : 0 : return UniValue(UniValue::VOBJ);
282 : : }
283 : :
284 : 141 : UniValue operator()(const PKHash& keyID) const
285 : : {
286 : 141 : UniValue obj(UniValue::VOBJ);
287 [ + - + - : 282 : obj.pushKV("isscript", false);
+ - ]
288 [ + - + - : 282 : obj.pushKV("iswitness", false);
+ - ]
289 : 141 : return obj;
290 : 0 : }
291 : :
292 : 130 : UniValue operator()(const ScriptHash& scriptID) const
293 : : {
294 : 130 : UniValue obj(UniValue::VOBJ);
295 [ + - + - : 260 : obj.pushKV("isscript", true);
+ - ]
296 [ + - + - : 260 : obj.pushKV("iswitness", false);
+ - ]
297 : 130 : return obj;
298 : 0 : }
299 : :
300 : 490 : UniValue operator()(const WitnessV0KeyHash& id) const
301 : : {
302 : 490 : UniValue obj(UniValue::VOBJ);
303 [ + - + - : 980 : obj.pushKV("isscript", false);
+ - ]
304 [ + - + - : 980 : obj.pushKV("iswitness", true);
+ - ]
305 [ + - + - : 980 : obj.pushKV("witness_version", 0);
+ - ]
306 [ + - + - : 980 : obj.pushKV("witness_program", HexStr(id));
+ - + - ]
307 : 490 : return obj;
308 : 0 : }
309 : :
310 : 43 : UniValue operator()(const WitnessV0ScriptHash& id) const
311 : : {
312 : 43 : UniValue obj(UniValue::VOBJ);
313 [ + - + - : 86 : obj.pushKV("isscript", true);
+ - ]
314 [ + - + - : 86 : obj.pushKV("iswitness", true);
+ - ]
315 [ + - + - : 86 : obj.pushKV("witness_version", 0);
+ - ]
316 [ + - + - : 86 : obj.pushKV("witness_program", HexStr(id));
+ - + - ]
317 : 43 : return obj;
318 : 0 : }
319 : :
320 : 119 : UniValue operator()(const WitnessV1Taproot& tap) const
321 : : {
322 : 119 : UniValue obj(UniValue::VOBJ);
323 [ + - + - : 238 : obj.pushKV("isscript", true);
+ - ]
324 [ + - + - : 238 : obj.pushKV("iswitness", true);
+ - ]
325 [ + - + - : 238 : obj.pushKV("witness_version", 1);
+ - ]
326 [ + - + - : 238 : obj.pushKV("witness_program", HexStr(tap));
+ - + - ]
327 : 119 : return obj;
328 : 0 : }
329 : :
330 : 1 : UniValue operator()(const PayToAnchor& anchor) const
331 : : {
332 : 1 : UniValue obj(UniValue::VOBJ);
333 [ + - + - : 2 : obj.pushKV("isscript", true);
+ - ]
334 [ + - + - : 2 : obj.pushKV("iswitness", true);
+ - ]
335 : 1 : return obj;
336 : 0 : }
337 : :
338 : 5 : UniValue operator()(const WitnessUnknown& id) const
339 : : {
340 : 5 : UniValue obj(UniValue::VOBJ);
341 [ + - + - : 10 : obj.pushKV("iswitness", true);
+ - ]
342 [ + - + - : 10 : obj.pushKV("witness_version", id.GetWitnessVersion());
+ - ]
343 [ - + + - : 10 : obj.pushKV("witness_program", HexStr(id.GetWitnessProgram()));
+ - + - +
- ]
344 : 5 : return obj;
345 : 0 : }
346 : : };
347 : :
348 : 929 : UniValue DescribeAddress(const CTxDestination& dest)
349 : : {
350 : 929 : return std::visit(DescribeAddressVisitor(), dest);
351 : : }
352 : :
353 : : /**
354 : : * Returns a sighash value corresponding to the passed in argument.
355 : : *
356 : : * @pre The sighash argument should be string or null.
357 : : */
358 : 1062 : std::optional<int> ParseSighashString(const UniValue& sighash)
359 : : {
360 [ + + ]: 1062 : if (sighash.isNull()) {
361 : 977 : return std::nullopt;
362 : : }
363 : 85 : const auto result{SighashFromStr(sighash.get_str())};
364 [ + + ]: 85 : if (!result) {
365 [ + - + - ]: 8 : throw JSONRPCError(RPC_INVALID_PARAMETER, util::ErrorString(result).original);
366 : : }
367 : 81 : return result.value();
368 : 81 : }
369 : :
370 : 333 : unsigned int ParseConfirmTarget(const UniValue& value, unsigned int max_target)
371 : : {
372 : 333 : const int target{value.getInt<int>()};
373 : 333 : const unsigned int unsigned_target{static_cast<unsigned int>(target)};
374 [ + + + + ]: 333 : if (target < 1 || unsigned_target > max_target) {
375 [ + - + - ]: 62 : throw JSONRPCError(RPC_INVALID_PARAMETER, strprintf("Invalid conf_target, must be between %u and %u", 1, max_target));
376 : : }
377 : 302 : return unsigned_target;
378 : : }
379 : :
380 : 15 : RPCErrorCode RPCErrorFromPSBTError(PSBTError err)
381 : : {
382 [ + + - ]: 15 : switch (err) {
383 : : case PSBTError::UNSUPPORTED:
384 : : return RPC_INVALID_PARAMETER;
385 : 14 : case PSBTError::SIGHASH_MISMATCH:
386 : 14 : return RPC_DESERIALIZATION_ERROR;
387 : 1 : default: break;
388 : : }
389 : 1 : return RPC_TRANSACTION_ERROR;
390 : : }
391 : :
392 : 4299 : RPCErrorCode RPCErrorFromTransactionError(TransactionError terr)
393 : : {
394 [ + + + + ]: 4299 : switch (terr) {
395 : : case TransactionError::MEMPOOL_REJECTED:
396 : : return RPC_TRANSACTION_REJECTED;
397 : 3 : case TransactionError::ALREADY_IN_UTXO_SET:
398 : 3 : return RPC_VERIFY_ALREADY_IN_UTXO_SET;
399 : 5 : case TransactionError::PRIVATE_BROADCAST_FULL:
400 : 5 : return RPC_LIMIT_EXCEEDED;
401 : 12 : default: break;
402 : : }
403 : 12 : return RPC_TRANSACTION_ERROR;
404 : : }
405 : :
406 : 15 : UniValue JSONRPCPSBTError(PSBTError err)
407 : : {
408 [ + - + - ]: 30 : return JSONRPCError(RPCErrorFromPSBTError(err), PSBTErrorString(err).original);
409 : : }
410 : :
411 : 4299 : UniValue JSONRPCTransactionError(TransactionError terr, const std::string& err_string)
412 : : {
413 [ - + + + ]: 4299 : if (err_string.length() > 0) {
414 : 4284 : return JSONRPCError(RPCErrorFromTransactionError(terr), err_string);
415 : : } else {
416 [ + - + - ]: 30 : return JSONRPCError(RPCErrorFromTransactionError(terr), TransactionErrorString(terr).original);
417 : : }
418 : : }
419 : :
420 : : /**
421 : : * A pair of strings that can be aligned (through padding) with other Sections
422 : : * later on
423 : : */
424 : 65465 : struct Section {
425 : 20805 : Section(const std::string& left, const std::string& right)
426 [ - + - + ]: 62415 : : m_left{left}, m_right{right} {}
427 : : std::string m_left;
428 : : const std::string m_right;
429 : : };
430 : :
431 : : /**
432 : : * Keeps track of RPCArgs by transforming them into sections for the purpose
433 : : * of serializing everything to a single string
434 : : */
435 : 0 : struct Sections {
436 : : std::vector<Section> m_sections;
437 : : size_t m_max_pad{0};
438 : :
439 : 18872 : void PushSection(const Section& s)
440 : : {
441 [ - + + + ]: 18872 : m_max_pad = std::max(m_max_pad, s.m_left.size());
442 : 18872 : m_sections.push_back(s);
443 : 18872 : }
444 : :
445 : : /**
446 : : * Recursive helper to translate an RPCArg into sections
447 : : */
448 : : // NOLINTNEXTLINE(misc-no-recursion)
449 : 3203 : void Push(const RPCArg& arg, const size_t current_indent = 5, const OuterType outer_type = OuterType::NONE)
450 : : {
451 [ + - ]: 3203 : const auto indent = std::string(current_indent, ' ');
452 [ + - + + : 3203 : const auto indent_next = std::string(current_indent + 2, ' ');
+ - ]
453 : 3203 : const bool push_name{outer_type == OuterType::OBJ}; // Dictionary keys must have a name
454 : 3203 : const bool is_top_level_arg{outer_type == OuterType::NONE}; // True on the first recursion
455 : :
456 [ + + + - ]: 3203 : switch (arg.m_type) {
457 : 2667 : case RPCArg::Type::STR_HEX:
458 : 2667 : case RPCArg::Type::STR:
459 : 2667 : case RPCArg::Type::NUM:
460 : 2667 : case RPCArg::Type::AMOUNT:
461 : 2667 : case RPCArg::Type::RANGE:
462 : 2667 : case RPCArg::Type::BOOL:
463 : 2667 : case RPCArg::Type::OBJ_NAMED_PARAMS: {
464 [ + + ]: 2667 : if (is_top_level_arg) return; // Nothing more to do for non-recursive types on first recursion
465 [ - + ]: 679 : auto left = indent;
466 [ - + + + : 679 : if (arg.m_opts.type_str.size() != 0 && push_name) {
+ - ]
467 [ + - + - : 9 : left += "\"" + arg.GetName() + "\": " + arg.m_opts.type_str.at(0);
+ - + - ]
468 : : } else {
469 [ + + + - : 1352 : left += push_name ? arg.ToStringObj(/*oneline=*/false) : arg.ToString(/*oneline=*/false);
+ - ]
470 : : }
471 [ + - ]: 679 : left += ",";
472 [ + - + - : 1358 : PushSection({left, arg.ToDescriptionString(/*is_named_arg=*/push_name)});
+ - ]
473 : 679 : break;
474 : 679 : }
475 : 204 : case RPCArg::Type::OBJ:
476 : 204 : case RPCArg::Type::OBJ_USER_KEYS: {
477 [ + + + - : 204 : const auto right = is_top_level_arg ? "" : arg.ToDescriptionString(/*is_named_arg=*/push_name);
+ - ]
478 [ - + - - : 612 : PushSection({indent + (push_name ? "\"" + arg.GetName() + "\": " : "") + "{", right});
- - - - +
- + - + -
+ - - + -
+ - - -
- ]
479 [ + + ]: 680 : for (const auto& arg_inner : arg.m_inner) {
480 [ + - ]: 476 : Push(arg_inner, current_indent + 2, OuterType::OBJ);
481 : : }
482 [ + + ]: 204 : if (arg.m_type != RPCArg::Type::OBJ) {
483 [ + - + - : 80 : PushSection({indent_next + "...", ""});
+ - + - ]
484 : : }
485 [ + + + - : 792 : PushSection({indent + "}" + (is_top_level_arg ? "" : ","), ""});
+ - + - +
- ]
486 : 204 : break;
487 : 204 : }
488 : 332 : case RPCArg::Type::ARR: {
489 [ - + ]: 332 : auto left = indent;
490 [ + + + - : 772 : left += push_name ? "\"" + arg.GetName() + "\": " : "";
+ - + - +
- + + + +
- - - - ]
491 [ + - ]: 332 : left += "[";
492 [ + + + - : 332 : const auto right = is_top_level_arg ? "" : arg.ToDescriptionString(/*is_named_arg=*/push_name);
+ - ]
493 [ + - + - ]: 332 : PushSection({left, right});
494 [ + + ]: 769 : for (const auto& arg_inner : arg.m_inner) {
495 [ + - ]: 437 : Push(arg_inner, current_indent + 2, OuterType::ARR);
496 : : }
497 [ + - + - : 664 : PushSection({indent_next + "...", ""});
+ - + - ]
498 [ + + + - : 1050 : PushSection({indent + "]" + (is_top_level_arg ? "" : ","), ""});
+ - + - +
- ]
499 : 332 : break;
500 : 332 : }
501 : : } // no default case, so the compiler can warn about missing cases
502 : 3203 : }
503 : :
504 : : /**
505 : : * Concatenate all sections with proper padding
506 : : */
507 : 3566 : std::string ToString() const
508 : : {
509 : 3566 : std::string ret;
510 : 3566 : const size_t pad = m_max_pad + 4;
511 [ + + ]: 24371 : for (const auto& s : m_sections) {
512 : : // The left part of a section is assumed to be a single line, usually it is the name of the JSON struct or a
513 : : // brace like {, }, [, or ]
514 [ + - ]: 20805 : CHECK_NONFATAL(s.m_left.find('\n') == std::string::npos);
515 [ + + ]: 20805 : if (s.m_right.empty()) {
516 [ - + ]: 5541 : ret += s.m_left;
517 [ + - ]: 5541 : ret += "\n";
518 : 5541 : continue;
519 : : }
520 : :
521 [ - + ]: 15264 : std::string left = s.m_left;
522 [ + - ]: 15264 : left.resize(pad, ' ');
523 [ - + ]: 15264 : ret += left;
524 : :
525 : : // Properly pad after newlines
526 : 15264 : std::string right;
527 : 15264 : size_t begin = 0;
528 : 15264 : size_t new_line_pos = s.m_right.find_first_of('\n');
529 : 19250 : while (true) {
530 [ + - ]: 34514 : right += s.m_right.substr(begin, new_line_pos - begin);
531 [ + + ]: 17257 : if (new_line_pos == std::string::npos) {
532 : : break; //No new line
533 : : }
534 [ + - + - ]: 4302 : right += "\n" + std::string(pad, ' ');
535 : 2151 : begin = s.m_right.find_first_not_of(' ', new_line_pos + 1);
536 [ + + ]: 2151 : if (begin == std::string::npos) {
537 : : break; // Empty line
538 : : }
539 : 1993 : new_line_pos = s.m_right.find_first_of('\n', begin + 1);
540 : : }
541 [ - + ]: 15264 : ret += right;
542 [ + - ]: 15264 : ret += "\n";
543 : 15264 : }
544 : 3566 : return ret;
545 : 0 : }
546 : : };
547 : :
548 : 19 : RPCMethod::RPCMethod(std::string name, std::string description, std::vector<RPCArg> args, RPCResults results, RPCExamples examples)
549 [ + - - + : 81 : : RPCMethod{std::move(name), std::move(description), std::move(args), std::move(results), std::move(examples), nullptr} {}
+ + ]
550 : :
551 : 577573 : RPCMethod::RPCMethod(std::string name, std::string description, std::vector<RPCArg> args, RPCResults results, RPCExamples examples, RPCMethodImpl fun)
552 : 577581 : : m_name{std::move(name)},
553 : 577581 : m_fun{std::move(fun)},
554 : 577581 : m_description{std::move(description)},
555 [ + - ]: 577573 : m_args{std::move(args)},
556 [ + - ]: 577581 : m_results{std::move(results)},
557 [ - + ]: 577581 : m_examples{std::move(examples)}
558 : : {
559 : : // Map of parameter names and types just used to check whether the names are
560 : : // unique. Parameter names always need to be unique, with the exception that
561 : : // there can be pairs of POSITIONAL and NAMED parameters with the same name.
562 : 577573 : enum ParamType { POSITIONAL = 1, NAMED = 2, NAMED_ONLY = 4 };
563 : 577573 : std::map<std::string, int> param_names;
564 : :
565 [ + + ]: 1649095 : for (const auto& arg : m_args) {
566 [ - + + - ]: 1071530 : std::vector<std::string> names = SplitString(arg.m_names, '|');
567 : : // Should have unique named arguments
568 [ + + ]: 2161074 : for (const std::string& name : names) {
569 [ + - ]: 1089546 : auto& param_type = param_names[name];
570 [ + + ]: 1089546 : CHECK_NONFATAL(!(param_type & POSITIONAL));
571 [ + + ]: 1089545 : CHECK_NONFATAL(!(param_type & NAMED_ONLY));
572 : 1089544 : param_type |= POSITIONAL;
573 : : }
574 [ + + ]: 1071528 : if (arg.m_type == RPCArg::Type::OBJ_NAMED_PARAMS) {
575 [ + + ]: 142022 : for (const auto& inner : arg.m_inner) {
576 [ - + + - ]: 120883 : std::vector<std::string> inner_names = SplitString(inner.m_names, '|');
577 [ + + ]: 241761 : for (const std::string& inner_name : inner_names) {
578 [ + - ]: 120884 : auto& param_type = param_names[inner_name];
579 [ + + + + : 120886 : CHECK_NONFATAL(!(param_type & POSITIONAL) || inner.m_opts.also_positional);
+ + ]
580 [ + + ]: 120882 : CHECK_NONFATAL(!(param_type & NAMED));
581 [ + + ]: 120880 : CHECK_NONFATAL(!(param_type & NAMED_ONLY));
582 [ + + ]: 230955 : param_type |= inner.m_opts.also_positional ? NAMED : NAMED_ONLY;
583 : : }
584 : 120883 : }
585 : : }
586 : : // Default value type should match argument type only when defined
587 [ + + ]: 1071522 : if (arg.m_fallback.index() == 2) {
588 : 363611 : const RPCArg::Type type = arg.m_type;
589 : 727222 : [&]() {
590 [ - + - + : 363611 : switch (std::get<RPCArg::Default>(arg.m_fallback).getType()) {
+ + + -
- ]
591 : 0 : case UniValue::VOBJ:
592 : 0 : CHECK_NONFATAL(type == RPCArg::Type::OBJ);
593 : 0 : return;
594 : 2201 : case UniValue::VARR:
595 : 2201 : CHECK_NONFATAL(type == RPCArg::Type::ARR);
596 : 2201 : return;
597 : 129743 : case UniValue::VSTR:
598 [ + + - + ]: 129743 : CHECK_NONFATAL(type == RPCArg::Type::STR || type == RPCArg::Type::STR_HEX || type == RPCArg::Type::AMOUNT);
599 : 129743 : return;
600 : 83121 : case UniValue::VNUM:
601 [ - + - - ]: 83121 : CHECK_NONFATAL(type == RPCArg::Type::NUM || type == RPCArg::Type::AMOUNT || type == RPCArg::Type::RANGE);
602 : 83121 : return;
603 : 148546 : case UniValue::VBOOL:
604 : 148546 : CHECK_NONFATAL(type == RPCArg::Type::BOOL);
605 : 148546 : return;
606 : : case UniValue::VNULL:
607 : : // Null values are accepted in all arguments
608 : : return;
609 : : } // no default case, so the compiler can warn about missing cases
610 [ # # ]: 0 : NONFATAL_UNREACHABLE();
611 [ + - ]: 363611 : }();
612 : : }
613 : 1071530 : }
614 : 577605 : }
615 : :
616 : 1119 : std::string RPCResults::ToDescriptionString() const
617 : : {
618 : 1119 : std::string result;
619 [ + + ]: 2457 : for (const auto& r : m_results) {
620 : 1338 : Sections sections;
621 [ + - ]: 1338 : r.ToSections(sections);
622 : : // A result can be empty via HelpElisionSkip
623 [ + + ]: 1338 : if (sections.m_sections.empty()) continue;
624 : :
625 [ + + ]: 1328 : if (r.m_cond.empty()) {
626 [ + - ]: 991 : result += "\nResult:\n";
627 : : } else {
628 [ + - - + ]: 1011 : result += "\nResult (" + r.m_cond + "):\n";
629 : : }
630 [ + - ]: 2656 : result += sections.ToString();
631 : 1338 : }
632 : 1119 : return result;
633 : 0 : }
634 : :
635 : 1119 : std::string RPCExamples::ToDescriptionString() const
636 : : {
637 [ + + - + ]: 1119 : return m_examples.empty() ? m_examples : "\nExamples:\n" + m_examples;
638 : : }
639 : :
640 : 235179 : UniValue RPCMethod::HandleRequest(const JSONRPCRequest& request) const
641 : : {
642 [ + + ]: 235179 : if (request.mode == JSONRPCRequest::GET_ARGS) {
643 : 352 : return GetArgMap();
644 : : }
645 : : /*
646 : : * Check if the given request is valid according to this command or if
647 : : * the user is asking for help information, and throw help when appropriate.
648 : : */
649 [ + + - + : 234827 : if (request.mode == JSONRPCRequest::GET_HELP || !IsValidNumArgs(request.params.size())) {
+ + ]
650 [ + - ]: 2232 : throw HelpResult{ToString()};
651 : : }
652 : 233711 : UniValue arg_mismatch{UniValue::VOBJ};
653 [ - + + + ]: 684574 : for (size_t i{0}; i < m_args.size(); ++i) {
654 [ + - ]: 450863 : const auto& arg{m_args.at(i)};
655 [ + - + - ]: 450863 : UniValue match{arg.MatchesType(request.params[i])};
656 [ + + ]: 450863 : if (!match.isTrue()) {
657 [ + - + - ]: 62 : arg_mismatch.pushKV(strprintf("Position %s (%s)", i + 1, arg.m_names), std::move(match));
658 : : }
659 : 450863 : }
660 [ - + + + ]: 233711 : if (!arg_mismatch.empty()) {
661 [ + - + - : 58 : throw JSONRPCError(RPC_TYPE_ERROR, strprintf("Wrong type passed:\n%s", arg_mismatch.write(4)));
+ - ]
662 : : }
663 [ + - ]: 233682 : CHECK_NONFATAL(m_req == nullptr);
664 : 233682 : m_req = &request;
665 [ + + ]: 233682 : UniValue ret = m_fun(*this, request);
666 : 227592 : m_req = nullptr;
667 [ + - + - : 227592 : if (gArgs.GetBoolArg("-rpcdoccheck", DEFAULT_RPC_DOC_CHECK)) {
+ + ]
668 : 227554 : UniValue mismatch{UniValue::VARR};
669 [ + - ]: 248368 : for (const auto& res : m_results.m_results) {
670 [ + - ]: 248368 : UniValue match{res.MatchesType(ret)};
671 [ + + ]: 248368 : if (match.isTrue()) {
672 [ + - ]: 227554 : mismatch.setNull();
673 : 227554 : break;
674 : : }
675 [ + - ]: 20814 : mismatch.push_back(std::move(match));
676 : 248368 : }
677 [ - + ]: 227554 : if (!mismatch.isNull()) {
678 [ # # ]: 0 : std::string explain{
679 [ # # ]: 0 : mismatch.empty() ? "no possible results defined" :
680 [ # # # # ]: 0 : mismatch.size() == 1 ? mismatch[0].write(4) :
681 [ # # # # : 0 : mismatch.write(4)};
# # ]
682 : 0 : throw std::runtime_error{
683 [ # # # # ]: 0 : STR_INTERNAL_BUG(strprintf("RPC call \"%s\" returned incorrect type:\n%s", m_name, explain)),
684 [ # # ]: 0 : };
685 : 0 : }
686 : 227554 : }
687 : 227592 : return ret;
688 : 233711 : }
689 : :
690 : : using CheckFn = void(const RPCArg&);
691 : 48573 : static const UniValue* DetailMaybeArg(CheckFn* check, const std::vector<RPCArg>& params, const JSONRPCRequest* req, size_t i)
692 : : {
693 [ - + ]: 48573 : CHECK_NONFATAL(i < params.size());
694 : 48573 : const UniValue& arg{CHECK_NONFATAL(req)->params[i]};
695 : 48573 : const RPCArg& param{params.at(i)};
696 [ + + ]: 48573 : if (check) check(param);
697 : :
698 [ + + ]: 48573 : if (!arg.isNull()) return &arg;
699 [ + + ]: 22582 : if (!std::holds_alternative<RPCArg::Default>(param.m_fallback)) return nullptr;
700 : 20063 : return &std::get<RPCArg::Default>(param.m_fallback);
701 : : }
702 : :
703 : 44261 : static void CheckRequiredOrDefault(const RPCArg& param)
704 : : {
705 : : // Must use `Arg<Type>(key)` to get the argument or its default value.
706 : 44261 : const bool required{
707 [ + + - + ]: 44261 : std::holds_alternative<RPCArg::Optional>(param.m_fallback) && RPCArg::Optional::NO == std::get<RPCArg::Optional>(param.m_fallback),
708 : 44261 : };
709 [ + + + - ]: 83679 : CHECK_NONFATAL(required || std::holds_alternative<RPCArg::Default>(param.m_fallback));
710 : 44261 : }
711 : :
712 : : #define TMPL_INST(check_param, ret_type, return_code) \
713 : : template <> \
714 : : ret_type RPCMethod::ArgValue<ret_type>(size_t i) const \
715 : : { \
716 : : const UniValue* maybe_arg{ \
717 : : DetailMaybeArg(check_param, m_args, m_req, i), \
718 : : }; \
719 : : return return_code \
720 : : } \
721 : : void force_semicolon(ret_type)
722 : :
723 : : // Optional arg (without default). Can also be called on required args, if needed.
724 : 1353 : TMPL_INST(nullptr, const UniValue*, maybe_arg;);
725 [ + + ]: 723 : TMPL_INST(nullptr, std::optional<double>, maybe_arg ? std::optional{maybe_arg->get_real()} : std::nullopt;);
726 [ + + ]: 815 : TMPL_INST(nullptr, std::optional<bool>, maybe_arg ? std::optional{maybe_arg->get_bool()} : std::nullopt;);
727 [ + + ]: 138 : TMPL_INST(nullptr, std::optional<int64_t>, maybe_arg ? std::optional{maybe_arg->getInt<int64_t>()} : std::nullopt;);
728 [ + + ]: 1283 : TMPL_INST(nullptr, std::optional<std::string_view>, maybe_arg ? std::optional<std::string_view>{maybe_arg->get_str()} : std::nullopt;);
729 : :
730 : : // Required arg or optional arg with default value.
731 : 35897 : TMPL_INST(CheckRequiredOrDefault, const UniValue&, *CHECK_NONFATAL(maybe_arg););
732 : 871 : TMPL_INST(CheckRequiredOrDefault, bool, CHECK_NONFATAL(maybe_arg)->get_bool(););
733 : 1419 : TMPL_INST(CheckRequiredOrDefault, int, CHECK_NONFATAL(maybe_arg)->getInt<int>(););
734 : 829 : TMPL_INST(CheckRequiredOrDefault, uint64_t, CHECK_NONFATAL(maybe_arg)->getInt<uint64_t>(););
735 : 993 : TMPL_INST(CheckRequiredOrDefault, uint32_t, CHECK_NONFATAL(maybe_arg)->getInt<uint32_t>(););
736 [ - + ]: 4252 : TMPL_INST(CheckRequiredOrDefault, std::string_view, CHECK_NONFATAL(maybe_arg)->get_str(););
737 : :
738 : 233754 : bool RPCMethod::IsValidNumArgs(size_t num_args) const
739 : : {
740 : 233754 : size_t num_required_args = 0;
741 [ - + + + ]: 482670 : for (size_t n = m_args.size(); n > 0; --n) {
742 [ + + ]: 409692 : if (!m_args.at(n - 1).IsOptional()) {
743 : : num_required_args = n;
744 : : break;
745 : : }
746 : : }
747 [ + + - + : 233754 : return num_required_args <= num_args && num_args <= m_args.size();
+ + ]
748 : : }
749 : :
750 : 171028 : std::vector<std::pair<std::string, bool>> RPCMethod::GetArgNames() const
751 : : {
752 : 171028 : std::vector<std::pair<std::string, bool>> ret;
753 [ - + + - ]: 171028 : ret.reserve(m_args.size());
754 [ + + ]: 479779 : for (const auto& arg : m_args) {
755 [ + + ]: 308751 : if (arg.m_type == RPCArg::Type::OBJ_NAMED_PARAMS) {
756 [ + + ]: 59988 : for (const auto& inner : arg.m_inner) {
757 [ + - ]: 50358 : ret.emplace_back(inner.m_names, /*named_only=*/true);
758 : : }
759 : : }
760 [ + - ]: 308751 : ret.emplace_back(arg.m_names, /*named_only=*/false);
761 : : }
762 : 171028 : return ret;
763 : 0 : }
764 : :
765 : 48573 : size_t RPCMethod::GetParamIndex(std::string_view key) const
766 : : {
767 : 48573 : auto it{std::find_if(
768 [ - + ]: 100483 : m_args.begin(), m_args.end(), [&key](const auto& arg) { return arg.GetName() == key;}
769 : : )};
770 : :
771 : 48573 : CHECK_NONFATAL(it != m_args.end()); // TODO: ideally this is checked at compile time
772 : 48573 : return std::distance(m_args.begin(), it);
773 : : }
774 : :
775 : 1119 : std::string RPCMethod::ToString() const
776 : : {
777 [ - + ]: 1119 : std::string ret;
778 : :
779 : : // Oneline summary
780 [ - + ]: 1119 : ret += m_name;
781 : 1119 : bool was_optional{false};
782 [ + + ]: 3052 : for (const auto& arg : m_args) {
783 [ + + ]: 1942 : if (arg.m_opts.hidden) break; // Any arg that follows is also hidden
784 [ + - ]: 1933 : const bool optional = arg.IsOptional();
785 [ + - ]: 1933 : ret += " ";
786 [ + + ]: 1933 : if (optional) {
787 [ + + + - ]: 1084 : if (!was_optional) ret += "( ";
788 : : was_optional = true;
789 : : } else {
790 [ + + + - ]: 849 : if (was_optional) ret += ") ";
791 : : was_optional = false;
792 : : }
793 [ + - ]: 3866 : ret += arg.ToString(/*oneline=*/true);
794 : : }
795 [ + + + - ]: 1119 : if (was_optional) ret += " )";
796 : :
797 : : // Description
798 [ - + + - ]: 2238 : CHECK_NONFATAL(!m_description.starts_with('\n')); // Historically \n was required, but reject it for new code.
799 [ - + + - : 3357 : ret += "\n\n" + TrimString(m_description) + "\n";
+ - - + ]
800 : :
801 : : // Arguments
802 : 1119 : Sections sections;
803 : 1119 : Sections named_only_sections;
804 [ - + + + ]: 3052 : for (size_t i{0}; i < m_args.size(); ++i) {
805 [ + - ]: 1942 : const auto& arg = m_args.at(i);
806 [ + + ]: 1942 : if (arg.m_opts.hidden) break; // Any arg that follows is also hidden
807 : :
808 : : // Push named argument name and description
809 [ + - + - : 5799 : sections.m_sections.emplace_back(util::ToString(i + 1) + ". " + arg.GetFirstName(), arg.ToDescriptionString(/*is_named_arg=*/true));
+ - + - +
- ]
810 [ - + + + ]: 1933 : sections.m_max_pad = std::max(sections.m_max_pad, sections.m_sections.back().m_left.size());
811 : :
812 : : // Recursively push nested args
813 [ + - ]: 1933 : sections.Push(arg);
814 : :
815 : : // Push named-only argument sections
816 [ + + ]: 1933 : if (arg.m_type == RPCArg::Type::OBJ_NAMED_PARAMS) {
817 [ + + ]: 426 : for (const auto& arg_inner : arg.m_inner) {
818 [ + - + - : 714 : named_only_sections.PushSection({arg_inner.GetFirstName(), arg_inner.ToDescriptionString(/*is_named_arg=*/true)});
+ - + - ]
819 [ + - ]: 357 : named_only_sections.Push(arg_inner);
820 : : }
821 : : }
822 : : }
823 : :
824 [ + + + - ]: 1119 : if (!sections.m_sections.empty()) ret += "\nArguments:\n";
825 [ + - ]: 2238 : ret += sections.ToString();
826 [ + + + - ]: 1119 : if (!named_only_sections.m_sections.empty()) ret += "\nNamed Arguments:\n";
827 [ + - ]: 2238 : ret += named_only_sections.ToString();
828 : :
829 : : // Result
830 [ + - ]: 2238 : ret += m_results.ToDescriptionString();
831 : :
832 : : // Examples
833 [ + - ]: 2238 : ret += m_examples.ToDescriptionString();
834 : :
835 : 1119 : return ret;
836 : 1119 : }
837 : :
838 : 352 : UniValue RPCMethod::GetArgMap() const
839 : : {
840 : 352 : UniValue arr{UniValue::VARR};
841 : :
842 : 1256 : auto push_back_arg_info = [&arr](const std::string& rpc_name, int pos, const std::string& arg_name, const RPCArg::Type& type) {
843 : 904 : UniValue map{UniValue::VARR};
844 [ + - + - ]: 904 : map.push_back(rpc_name);
845 [ + - + - ]: 904 : map.push_back(pos);
846 [ + - + - ]: 904 : map.push_back(arg_name);
847 [ + - + - ]: 904 : map.push_back(type == RPCArg::Type::STR ||
848 : : type == RPCArg::Type::STR_HEX);
849 [ + - ]: 904 : arr.push_back(std::move(map));
850 : 904 : };
851 : :
852 [ - + + + ]: 1046 : for (int i{0}; i < int(m_args.size()); ++i) {
853 [ + - ]: 694 : const auto& arg = m_args.at(i);
854 [ - + + - ]: 694 : std::vector<std::string> arg_names = SplitString(arg.m_names, '|');
855 [ + + ]: 1392 : for (const auto& arg_name : arg_names) {
856 [ + - ]: 698 : push_back_arg_info(m_name, i, arg_name, arg.m_type);
857 [ + + ]: 698 : if (arg.m_type == RPCArg::Type::OBJ_NAMED_PARAMS) {
858 [ + + ]: 236 : for (const auto& inner : arg.m_inner) {
859 [ - + + - ]: 206 : std::vector<std::string> inner_names = SplitString(inner.m_names, '|');
860 [ + + ]: 412 : for (const std::string& inner_name : inner_names) {
861 [ + - ]: 206 : push_back_arg_info(m_name, i, inner_name, inner.m_type);
862 : : }
863 : 206 : }
864 : : }
865 : : }
866 : 694 : }
867 : 352 : return arr;
868 : 0 : }
869 : :
870 : 235713 : static std::optional<UniValue::VType> ExpectedType(RPCArg::Type type)
871 : : {
872 : 235713 : using Type = RPCArg::Type;
873 [ + + + + : 235713 : switch (type) {
+ + + - ]
874 : 149405 : case Type::STR_HEX:
875 : 149405 : case Type::STR: {
876 : 149405 : return UniValue::VSTR;
877 : : }
878 : 52875 : case Type::NUM: {
879 : 52875 : return UniValue::VNUM;
880 : : }
881 : 20642 : case Type::AMOUNT: {
882 : : // VNUM or VSTR, checked inside AmountFromValue()
883 : 20642 : return std::nullopt;
884 : : }
885 : 80 : case Type::RANGE: {
886 : : // VNUM or VARR, checked inside ParseRange()
887 : 80 : return std::nullopt;
888 : : }
889 : 3623 : case Type::BOOL: {
890 : 3623 : return UniValue::VBOOL;
891 : : }
892 : 3396 : case Type::OBJ:
893 : 3396 : case Type::OBJ_NAMED_PARAMS:
894 : 3396 : case Type::OBJ_USER_KEYS: {
895 : 3396 : return UniValue::VOBJ;
896 : : }
897 : 5692 : case Type::ARR: {
898 : 5692 : return UniValue::VARR;
899 : : }
900 : : } // no default case, so the compiler can warn about missing cases
901 [ # # ]: 0 : NONFATAL_UNREACHABLE();
902 : : }
903 : :
904 : 450863 : UniValue RPCArg::MatchesType(const UniValue& request) const
905 : : {
906 [ + + ]: 450863 : if (m_opts.skip_type_check) return true;
907 [ + + + + ]: 433152 : if (IsOptional() && request.isNull()) return true;
908 : 235713 : const auto exp_type{ExpectedType(m_type)};
909 [ + + ]: 235713 : if (!exp_type) return true; // nothing to check
910 : :
911 [ + + ]: 214991 : if (*exp_type != request.getType()) {
912 [ + - ]: 62 : return strprintf("JSON value of type %s is not of expected type %s", uvTypeName(request.getType()), uvTypeName(*exp_type));
913 : : }
914 : 214960 : return true;
915 : : }
916 : :
917 : 5765 : std::string RPCArg::GetFirstName() const
918 : : {
919 : 5765 : return m_names.substr(0, m_names.find('|'));
920 : : }
921 : :
922 : 100540 : std::string RPCArg::GetName() const
923 : : {
924 : 100540 : CHECK_NONFATAL(std::string::npos == m_names.find('|'));
925 [ - + ]: 100540 : return m_names;
926 : : }
927 : :
928 : 845396 : bool RPCArg::IsOptional() const
929 : : {
930 [ + + ]: 845396 : if (m_fallback.index() != 0) {
931 : : return true;
932 : : } else {
933 : 395729 : return RPCArg::Optional::NO != std::get<RPCArg::Optional>(m_fallback);
934 : : }
935 : : }
936 : :
937 : 3203 : std::string RPCArg::ToDescriptionString(bool is_named_arg) const
938 : : {
939 [ + - ]: 3203 : std::string ret;
940 [ + - ]: 3203 : ret += "(";
941 [ - + + + ]: 3203 : if (m_opts.type_str.size() != 0) {
942 [ + - - + ]: 32 : ret += m_opts.type_str.at(1);
943 : : } else {
944 [ + + + + : 3171 : switch (m_type) {
+ + + - ]
945 : 1319 : case Type::STR_HEX:
946 : 1319 : case Type::STR: {
947 [ + - ]: 1319 : ret += "string";
948 : : break;
949 : : }
950 : 559 : case Type::NUM: {
951 [ + - ]: 559 : ret += "numeric";
952 : : break;
953 : : }
954 : 147 : case Type::AMOUNT: {
955 [ + - ]: 147 : ret += "numeric or string";
956 : : break;
957 : : }
958 : 60 : case Type::RANGE: {
959 [ + - ]: 60 : ret += "numeric or array";
960 : : break;
961 : : }
962 : 481 : case Type::BOOL: {
963 [ + - ]: 481 : ret += "boolean";
964 : : break;
965 : : }
966 : 273 : case Type::OBJ:
967 : 273 : case Type::OBJ_NAMED_PARAMS:
968 : 273 : case Type::OBJ_USER_KEYS: {
969 [ + - ]: 273 : ret += "json object";
970 : : break;
971 : : }
972 : 332 : case Type::ARR: {
973 [ + - + + ]: 3203 : ret += "json array";
974 : : break;
975 : : }
976 : : } // no default case, so the compiler can warn about missing cases
977 : : }
978 [ + + ]: 3203 : if (m_fallback.index() == 1) {
979 [ + - ]: 772 : ret += ", optional, default=" + std::get<RPCArg::DefaultHint>(m_fallback);
980 [ + + ]: 2817 : } else if (m_fallback.index() == 2) {
981 [ + - + - ]: 1802 : ret += ", optional, default=" + std::get<RPCArg::Default>(m_fallback).write();
982 : : } else {
983 [ - + + + : 1916 : switch (std::get<RPCArg::Optional>(m_fallback)) {
- ]
984 : 778 : case RPCArg::Optional::OMITTED: {
985 [ + + + - ]: 778 : if (is_named_arg) ret += ", optional"; // Default value is "null" in dicts. Otherwise,
986 : : // nothing to do. Element is treated as if not present and has no default value
987 : : break;
988 : : }
989 : 1138 : case RPCArg::Optional::NO: {
990 [ + - ]: 1138 : ret += ", required";
991 : : break;
992 : : }
993 : : } // no default case, so the compiler can warn about missing cases
994 : : }
995 [ + - ]: 3203 : ret += ")";
996 [ + + + - ]: 3203 : if (m_type == Type::OBJ_NAMED_PARAMS) ret += " Options object that can be used to pass named arguments, listed below.";
997 [ + + + - : 6406 : ret += m_description.empty() ? "" : " " + m_description;
+ - ]
998 : 3203 : return ret;
999 : 0 : }
1000 : :
1001 : : // NOLINTNEXTLINE(misc-no-recursion)
1002 : 13074 : void RPCResult::ToSections(Sections& sections, const OuterType outer_type, const int current_indent) const
1003 : : {
1004 : : // Indentation
1005 [ + - ]: 13074 : const std::string indent(current_indent, ' ');
1006 [ + - + + ]: 13074 : const std::string indent_next(current_indent + 2, ' ');
1007 : :
1008 : : // Elements in a JSON structure (dictionary or array) are separated by a comma
1009 [ + + + - ]: 14412 : const std::string maybe_separator{outer_type != OuterType::NONE ? "," : ""};
1010 : :
1011 : : // The key name if recursed into a dictionary
1012 : 13074 : const std::string maybe_key{
1013 [ + + ]: 13074 : outer_type == OuterType::OBJ ?
1014 [ + - - - ]: 10540 : "\"" + this->m_key_name + "\" : " :
1015 [ + - + - ]: 23614 : ""};
1016 : :
1017 : : // Format description with type
1018 : 25049 : const auto Description = [&](const std::string& type) {
1019 [ + + + - : 45448 : return "(" + type + (this->m_optional ? ", optional" : "") + ")" +
+ - ]
1020 [ + + + - ]: 35925 : (this->m_description.empty() ? "" : " " + this->m_description);
1021 : 13074 : };
1022 : :
1023 : : // Ensure at least one visible field exists when elision is used
1024 : 16071 : const auto elision_has_description{[](const std::vector<RPCResult>& inner) {
1025 : 6057 : return std::ranges::any_of(inner, [](const auto& res) {
1026 [ + + ]: 3060 : return !std::holds_alternative<HelpElisionSkip>(res.m_opts.print_elision);
1027 : : });
1028 : : }};
1029 : :
1030 : 13074 : if (const auto* text = std::get_if<std::string>(&m_opts.print_elision)) {
1031 [ + - + - : 190 : sections.PushSection({indent + "..." + maybe_separator, *text});
+ - + - ]
1032 : 95 : return;
1033 : : }
1034 [ + + ]: 12979 : if (std::holds_alternative<HelpElisionSkip>(m_opts.print_elision)) {
1035 : : return;
1036 : : }
1037 : :
1038 [ + + + + : 11975 : switch (m_type) {
+ + + + +
+ - ]
1039 : 36 : case Type::ANY: {
1040 [ + - + - : 108 : sections.PushSection({indent + maybe_key + "xxx" + maybe_separator, Description("any")});
+ - + - +
- + - ]
1041 : 36 : return;
1042 : : }
1043 : 139 : case Type::NONE: {
1044 [ + - + - : 278 : sections.PushSection({indent + "null" + maybe_separator, Description("json null")});
+ - + - +
- + - ]
1045 : 139 : return;
1046 : : }
1047 : 2101 : case Type::STR: {
1048 [ + - + - : 6303 : sections.PushSection({indent + maybe_key + "\"str\"" + maybe_separator, Description("string")});
+ - + - +
- + - ]
1049 : 2101 : return;
1050 : : }
1051 : 547 : case Type::STR_AMOUNT: {
1052 [ + - + - : 1641 : sections.PushSection({indent + maybe_key + "n" + maybe_separator, Description("numeric")});
+ - + - +
- + - ]
1053 : 547 : return;
1054 : : }
1055 : 1925 : case Type::STR_HEX: {
1056 [ + - + - : 5775 : sections.PushSection({indent + maybe_key + "\"hex\"" + maybe_separator, Description("string")});
+ - + - +
- + - ]
1057 : 1925 : return;
1058 : : }
1059 : 3127 : case Type::NUM: {
1060 [ + - + - : 9381 : sections.PushSection({indent + maybe_key + "n" + maybe_separator, Description("numeric")});
+ - + - +
- + - ]
1061 : 3127 : return;
1062 : : }
1063 : 357 : case Type::NUM_TIME: {
1064 [ + - + - : 1071 : sections.PushSection({indent + maybe_key + "xxx" + maybe_separator, Description("numeric")});
+ - + - +
- + - ]
1065 : 357 : return;
1066 : : }
1067 : 728 : case Type::BOOL: {
1068 [ + - + - : 2184 : sections.PushSection({indent + maybe_key + "true|false" + maybe_separator, Description("boolean")});
+ - + - +
- + - ]
1069 : 728 : return;
1070 : : }
1071 : 1132 : case Type::ARR_FIXED:
1072 : 1132 : case Type::ARR: {
1073 [ + - + - : 3396 : sections.PushSection({indent + maybe_key + "[", Description("json array")});
+ - + - +
- ]
1074 [ + + ]: 2328 : for (const auto& i : m_inner) {
1075 [ + - ]: 1196 : i.ToSections(sections, OuterType::ARR, current_indent + 2);
1076 : : }
1077 [ + - ]: 1132 : CHECK_NONFATAL(!m_inner.empty());
1078 [ + - ]: 1132 : CHECK_NONFATAL(elision_has_description(m_inner));
1079 [ + + + + ]: 1132 : if (m_type == Type::ARR && !std::holds_alternative<std::string>(m_inner.back().m_opts.print_elision)) {
1080 [ + - + - : 2224 : sections.PushSection({indent_next + "...", ""});
+ - + - ]
1081 : : } else {
1082 : : // Remove final comma, which would be invalid JSON
1083 : 20 : sections.m_sections.back().m_left.pop_back();
1084 : : }
1085 [ + - + - : 2264 : sections.PushSection({indent + "]" + maybe_separator, ""});
+ - + - +
- ]
1086 : 1132 : return;
1087 : : }
1088 : 1883 : case Type::OBJ_DYN:
1089 : 1883 : case Type::OBJ: {
1090 [ + + ]: 1883 : if (m_inner.empty()) {
1091 [ + - + - : 54 : sections.PushSection({indent + maybe_key + "{}", Description("empty JSON object")});
+ - + - +
- ]
1092 : 18 : return;
1093 : : }
1094 [ + - ]: 1865 : CHECK_NONFATAL(elision_has_description(m_inner));
1095 [ + - + - : 5595 : sections.PushSection({indent + maybe_key + "{", Description("json object")});
+ - + - +
- ]
1096 [ + + ]: 12405 : for (const auto& i : m_inner) {
1097 [ + - ]: 10540 : i.ToSections(sections, OuterType::OBJ, current_indent + 2);
1098 : : }
1099 [ + + ]: 1865 : if (m_type == Type::OBJ_DYN) {
1100 : : // If the dictionary keys are dynamic, use three dots for continuation
1101 [ + - + - : 426 : sections.PushSection({indent_next + "...", ""});
+ - + - ]
1102 : : } else {
1103 : : // Remove final comma, which would be invalid JSON
1104 : 1652 : sections.m_sections.back().m_left.pop_back();
1105 : : }
1106 [ + - + - : 3730 : sections.PushSection({indent + "}" + maybe_separator, ""});
+ - + - +
- ]
1107 : 1865 : return;
1108 : : }
1109 : : } // no default case, so the compiler can warn about missing cases
1110 [ # # ]: 0 : NONFATAL_UNREACHABLE();
1111 : 13074 : }
1112 : :
1113 : 5473531 : static std::optional<UniValue::VType> ExpectedType(RPCResult::Type type)
1114 : : {
1115 : 5473531 : using Type = RPCResult::Type;
1116 [ + + + + : 5473531 : switch (type) {
+ + + - ]
1117 : 326 : case Type::ANY: {
1118 : 326 : return std::nullopt;
1119 : : }
1120 : 38793 : case Type::NONE: {
1121 : 38793 : return UniValue::VNULL;
1122 : : }
1123 : 2184655 : case Type::STR:
1124 : 2184655 : case Type::STR_HEX: {
1125 : 2184655 : return UniValue::VSTR;
1126 : : }
1127 : 2068208 : case Type::NUM:
1128 : 2068208 : case Type::STR_AMOUNT:
1129 : 2068208 : case Type::NUM_TIME: {
1130 : 2068208 : return UniValue::VNUM;
1131 : : }
1132 : 386096 : case Type::BOOL: {
1133 : 386096 : return UniValue::VBOOL;
1134 : : }
1135 : 267585 : case Type::ARR_FIXED:
1136 : 267585 : case Type::ARR: {
1137 : 267585 : return UniValue::VARR;
1138 : : }
1139 : 527868 : case Type::OBJ_DYN:
1140 : 527868 : case Type::OBJ: {
1141 : 527868 : return UniValue::VOBJ;
1142 : : }
1143 : : } // no default case, so the compiler can warn about missing cases
1144 [ # # ]: 0 : NONFATAL_UNREACHABLE();
1145 : : }
1146 : :
1147 : : // NOLINTNEXTLINE(misc-no-recursion)
1148 : 5473977 : UniValue RPCResult::MatchesType(const UniValue& result) const
1149 : : {
1150 [ + + ]: 5473977 : if (m_opts.skip_type_check) {
1151 : 446 : return true;
1152 : : }
1153 : :
1154 : 5473531 : const auto exp_type = ExpectedType(m_type);
1155 [ + + ]: 5473531 : if (!exp_type) return true; // can be any type, so nothing to check
1156 : :
1157 [ + + ]: 5473205 : if (*exp_type != result.getType()) {
1158 [ + - ]: 41730 : return strprintf("returned type is %s, but declared as %s in doc", uvTypeName(result.getType()), uvTypeName(*exp_type));
1159 : : }
1160 : :
1161 [ + + ]: 5452340 : if (UniValue::VARR == result.getType()) {
1162 : 266353 : UniValue errors(UniValue::VOBJ);
1163 [ + - - + : 1291844 : for (size_t i{0}; i < result.get_array().size(); ++i) {
+ + ]
1164 : : // If there are more results than documented, reuse the last doc_inner.
1165 [ - + + + : 2049448 : const RPCResult& doc_inner{m_inner.at(std::min(m_inner.size() - 1, i))};
+ - ]
1166 [ + - + - : 1025491 : UniValue match{doc_inner.MatchesType(result.get_array()[i])};
+ - ]
1167 [ + + + - : 1025962 : if (!match.isTrue()) errors.pushKV(strprintf("%d", i), std::move(match));
+ - ]
1168 : 1025491 : }
1169 [ - + + + : 266353 : if (errors.empty()) return true; // empty result array is valid
+ - ]
1170 : 415 : return errors;
1171 : 266353 : }
1172 : :
1173 [ + + ]: 5185987 : if (UniValue::VOBJ == result.getType()) {
1174 : 527379 : UniValue errors(UniValue::VOBJ);
1175 [ + + ]: 527379 : if (m_type == Type::OBJ_DYN) {
1176 [ + - ]: 34846 : const RPCResult& doc_inner{m_inner.at(0)}; // Assume all types are the same, randomly pick the first
1177 [ + - - + : 327180 : for (size_t i{0}; i < result.get_obj().size(); ++i) {
+ + ]
1178 [ + - + - : 292334 : UniValue match{doc_inner.MatchesType(result.get_obj()[i])};
+ - ]
1179 [ + + + - : 292414 : if (!match.isTrue()) errors.pushKV(result.getKeys()[i], std::move(match));
- + + - ]
1180 : 292334 : }
1181 [ - + + + : 34846 : if (errors.empty()) return true; // empty result obj is valid
+ - ]
1182 : 20 : return errors;
1183 : : }
1184 : 492533 : std::set<std::string> doc_keys;
1185 [ + + ]: 4727015 : for (const auto& doc_entry : m_inner) {
1186 [ + - ]: 4234482 : doc_keys.insert(doc_entry.m_key_name);
1187 : : }
1188 [ + - ]: 492533 : std::map<std::string, UniValue> result_obj;
1189 [ + - ]: 492533 : result.getObjMap(result_obj);
1190 [ + + ]: 4400347 : for (const auto& result_entry : result_obj) {
1191 [ + + ]: 3907814 : if (!doc_keys.contains(result_entry.first)) {
1192 [ + - - + : 90 : errors.pushKV(result_entry.first, "key returned that was not in doc");
+ - ]
1193 : : }
1194 : : }
1195 : :
1196 [ + + ]: 4727015 : for (const auto& doc_entry : m_inner) {
1197 : 4234482 : const auto result_it{result_obj.find(doc_entry.m_key_name)};
1198 [ + + ]: 4234482 : if (result_it == result_obj.end()) {
1199 [ - + ]: 326698 : if (!doc_entry.m_optional) {
1200 [ # # # # : 0 : errors.pushKV(doc_entry.m_key_name, "key missing, despite not being optional in doc");
# # ]
1201 : : }
1202 : 326698 : continue;
1203 : : }
1204 [ + - ]: 3907784 : UniValue match{doc_entry.MatchesType(result_it->second)};
1205 [ + + - + : 3908532 : if (!match.isTrue()) errors.pushKV(doc_entry.m_key_name, std::move(match));
+ - ]
1206 : 3907784 : }
1207 [ - + + + : 492533 : if (errors.empty()) return true;
+ - ]
1208 : 399 : return errors;
1209 : 527379 : }
1210 : :
1211 : 4658608 : return true;
1212 : : }
1213 : :
1214 : 7598288 : void RPCResult::CheckInnerDoc() const
1215 : : {
1216 [ + + ]: 7598288 : if (m_type == Type::OBJ) {
1217 : : // May or may not be empty
1218 : : return;
1219 : : }
1220 : : // Everything else must either be empty or not
1221 [ + + + + ]: 6701776 : const bool inner_needed{m_type == Type::ARR || m_type == Type::ARR_FIXED || m_type == Type::OBJ_DYN};
1222 : 6701776 : CHECK_NONFATAL(inner_needed != m_inner.empty());
1223 : : }
1224 : :
1225 : : // NOLINTNEXTLINE(misc-no-recursion)
1226 : 793 : std::string RPCArg::ToStringObj(const bool oneline) const
1227 : : {
1228 [ + - ]: 793 : std::string res;
1229 [ + - ]: 793 : res += "\"";
1230 [ + - ]: 1586 : res += GetFirstName();
1231 [ + + ]: 793 : if (oneline) {
1232 [ + - ]: 374 : res += "\":";
1233 : : } else {
1234 [ + - ]: 419 : res += "\": ";
1235 : : }
1236 [ + + + + : 793 : switch (m_type) {
+ + + -
- ]
1237 : 114 : case Type::STR:
1238 [ + - ]: 114 : return res + "\"str\"";
1239 : 259 : case Type::STR_HEX:
1240 [ + - ]: 259 : return res + "\"hex\"";
1241 : 187 : case Type::NUM:
1242 [ + - ]: 187 : return res + "n";
1243 : 69 : case Type::RANGE:
1244 [ + - ]: 69 : return res + "n or [n,n]";
1245 : 98 : case Type::AMOUNT:
1246 [ + - ]: 98 : return res + "amount";
1247 : 48 : case Type::BOOL:
1248 [ + - ]: 48 : return res + "bool";
1249 : 18 : case Type::ARR:
1250 [ + - ]: 18 : res += "[";
1251 [ + + ]: 45 : for (const auto& i : m_inner) {
1252 [ + - - + ]: 81 : res += i.ToString(oneline) + ",";
1253 : : }
1254 [ + - ]: 18 : return res + "...]";
1255 : 0 : case Type::OBJ:
1256 : 0 : case Type::OBJ_NAMED_PARAMS:
1257 : 0 : case Type::OBJ_USER_KEYS:
1258 : : // Currently unused, so avoid writing dead code
1259 [ # # ]: 0 : NONFATAL_UNREACHABLE();
1260 : : } // no default case, so the compiler can warn about missing cases
1261 [ # # ]: 0 : NONFATAL_UNREACHABLE();
1262 : 793 : }
1263 : :
1264 : : // NOLINTNEXTLINE(misc-no-recursion)
1265 : 2476 : std::string RPCArg::ToString(const bool oneline) const
1266 : : {
1267 [ + + + + ]: 2476 : if (oneline && !m_opts.oneline_description.empty()) {
1268 [ + + + - : 86 : if (m_opts.oneline_description[0] == '\"' && m_type != Type::STR_HEX && m_type != Type::STR && gArgs.GetBoolArg("-rpcdoccheck", DEFAULT_RPC_DOC_CHECK)) {
- + - - -
- - + ]
1269 : 0 : throw std::runtime_error{
1270 [ # # # # ]: 0 : STR_INTERNAL_BUG(strprintf("non-string RPC arg \"%s\" quotes oneline_description:\n%s",
1271 : : m_names, m_opts.oneline_description)
1272 [ # # ]: 0 : )};
1273 : : }
1274 [ - + ]: 86 : return m_opts.oneline_description;
1275 : : }
1276 : :
1277 [ + + + + : 2390 : switch (m_type) {
- ]
1278 : 1225 : case Type::STR_HEX:
1279 : 1225 : case Type::STR: {
1280 [ + - ]: 2450 : return "\"" + GetFirstName() + "\"";
1281 : : }
1282 : 787 : case Type::NUM:
1283 : 787 : case Type::RANGE:
1284 : 787 : case Type::AMOUNT:
1285 : 787 : case Type::BOOL: {
1286 : 787 : return GetFirstName();
1287 : : }
1288 : 168 : case Type::OBJ:
1289 : 168 : case Type::OBJ_NAMED_PARAMS:
1290 : 168 : case Type::OBJ_USER_KEYS: {
1291 : : // NOLINTNEXTLINE(misc-no-recursion)
1292 [ + - ]: 542 : const std::string res = Join(m_inner, ",", [&](const RPCArg& i) { return i.ToStringObj(oneline); });
1293 [ + + ]: 168 : if (m_type == Type::OBJ) {
1294 [ + - ]: 208 : return "{" + res + "}";
1295 : : } else {
1296 [ + - ]: 128 : return "{" + res + ",...}";
1297 : : }
1298 : 168 : }
1299 : 210 : case Type::ARR: {
1300 : 210 : std::string res;
1301 [ + + ]: 469 : for (const auto& i : m_inner) {
1302 [ + - - + ]: 777 : res += i.ToString(oneline) + ",";
1303 : : }
1304 [ + - ]: 420 : return "[" + res + "...]";
1305 : 210 : }
1306 : : } // no default case, so the compiler can warn about missing cases
1307 [ # # ]: 0 : NONFATAL_UNREACHABLE();
1308 : : }
1309 : :
1310 : 301 : static std::pair<int64_t, int64_t> ParseRange(const UniValue& value)
1311 : : {
1312 [ + + ]: 301 : if (value.isNum()) {
1313 : 86 : return {0, value.getInt<int64_t>()};
1314 : : }
1315 [ + - + - : 430 : if (value.isArray() && value.size() == 2 && value[0].isNum() && value[1].isNum()) {
+ - + - ]
1316 : 215 : int64_t low = value[0].getInt<int64_t>();
1317 : 215 : int64_t high = value[1].getInt<int64_t>();
1318 [ + + + - : 219 : if (low > high) throw JSONRPCError(RPC_INVALID_PARAMETER, "Range specified as [begin,end] must not have begin after end");
+ - ]
1319 : 211 : return {low, high};
1320 : : }
1321 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Range must be specified as end or as [begin,end]");
1322 : : }
1323 : :
1324 : 301 : std::pair<int64_t, int64_t> ParseDescriptorRange(const UniValue& value)
1325 : : {
1326 : 301 : int64_t low, high;
1327 [ + + ]: 301 : std::tie(low, high) = ParseRange(value);
1328 [ + + ]: 297 : if (low < 0) {
1329 [ + - + - ]: 8 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Range should be greater or equal than 0");
1330 : : }
1331 [ + + ]: 293 : if ((high >> 31) != 0) {
1332 [ + - + - ]: 12 : throw JSONRPCError(RPC_INVALID_PARAMETER, "End of range is too high");
1333 : : }
1334 [ + + ]: 287 : if (high >= low + 1000000) {
1335 [ + - + - ]: 8 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Range is too large");
1336 : : }
1337 : 283 : return {low, high};
1338 : : }
1339 : :
1340 : 1654 : std::vector<CScript> EvalDescriptorStringOrObject(const UniValue& scanobject, FlatSigningProvider& provider, const bool expand_priv)
1341 : : {
1342 [ + + ]: 1654 : std::string desc_str;
1343 : 1654 : std::pair<int64_t, int64_t> range = {0, 1000};
1344 [ + + ]: 1654 : if (scanobject.isStr()) {
1345 [ + - + - ]: 1543 : desc_str = scanobject.get_str();
1346 [ + - ]: 111 : } else if (scanobject.isObject()) {
1347 [ + - ]: 111 : const UniValue& desc_uni{scanobject.find_value("desc")};
1348 [ - + - - : 111 : if (desc_uni.isNull()) throw JSONRPCError(RPC_INVALID_PARAMETER, "Descriptor needs to be provided in scan object");
- - ]
1349 [ + - + - ]: 111 : desc_str = desc_uni.get_str();
1350 [ + - ]: 111 : const UniValue& range_uni{scanobject.find_value("range")};
1351 [ + + ]: 111 : if (!range_uni.isNull()) {
1352 [ + + ]: 100 : range = ParseDescriptorRange(range_uni);
1353 : : }
1354 : : } else {
1355 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Scan object needs to be either a string or an object");
1356 : : }
1357 : :
1358 [ - + ]: 1649 : std::string error;
1359 [ - + + - ]: 1649 : auto descs = Parse(desc_str, provider, error);
1360 [ + + ]: 1649 : if (descs.empty()) {
1361 [ + - ]: 1 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, error);
1362 : : }
1363 [ + - + - : 1648 : if (!descs.at(0)->IsRange()) {
+ + ]
1364 : 1551 : range.first = 0;
1365 : 1551 : range.second = 0;
1366 : : }
1367 : 1648 : std::vector<CScript> ret;
1368 [ + + ]: 23414 : for (int64_t i = range.first; i <= range.second; ++i) {
1369 [ + + ]: 43533 : for (const auto& desc : descs) {
1370 : 21767 : std::vector<CScript> scripts;
1371 [ + - - + ]: 21767 : if (!desc->Expand(i, provider, scripts, provider)) {
1372 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_ADDRESS_OR_KEY, strprintf("Cannot derive script without private keys: '%s'", desc_str));
1373 : : }
1374 [ + + ]: 21767 : if (expand_priv) {
1375 [ + - ]: 2114 : desc->ExpandPrivate(/*pos=*/i, provider, /*out=*/provider);
1376 : : }
1377 [ + - ]: 21767 : std::move(scripts.begin(), scripts.end(), std::back_inserter(ret));
1378 : 21767 : }
1379 : : }
1380 : 3296 : return ret;
1381 : 1650 : }
1382 : :
1383 : 30 : std::vector<uint32_t> ParsePathBIP32(const std::string& path)
1384 : : {
1385 : 30 : std::vector<uint32_t> out;
1386 [ + - + + ]: 30 : if (!ParseHDKeypath(path, out)) {
1387 [ + - + - ]: 6 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Invalid BIP32 keypath");
1388 : : }
1389 : 27 : return out;
1390 : 3 : }
1391 : :
1392 : : /** Convert a vector of bilingual strings to a UniValue::VARR containing their original untranslated values. */
1393 : 11 : [[nodiscard]] static UniValue BilingualStringsToUniValue(const std::vector<bilingual_str>& bilingual_strings)
1394 : : {
1395 : 11 : CHECK_NONFATAL(!bilingual_strings.empty());
1396 : 11 : UniValue result{UniValue::VARR};
1397 [ + + ]: 22 : for (const auto& s : bilingual_strings) {
1398 [ + - + - ]: 11 : result.push_back(s.original);
1399 : : }
1400 : 11 : return result;
1401 : 0 : }
1402 : :
1403 : 846 : void PushWarnings(const UniValue& warnings, UniValue& obj)
1404 : : {
1405 [ - + + + ]: 846 : if (warnings.empty()) return;
1406 [ + - + - ]: 774 : obj.pushKV("warnings", warnings);
1407 : : }
1408 : :
1409 : 1098 : void PushWarnings(const std::vector<bilingual_str>& warnings, UniValue& obj)
1410 : : {
1411 [ + + ]: 1098 : if (warnings.empty()) return;
1412 [ + - + - ]: 22 : obj.pushKV("warnings", BilingualStringsToUniValue(warnings));
1413 : : }
1414 : :
1415 : 71931 : std::vector<RPCResult> ScriptPubKeyDoc() {
1416 : 71931 : return
1417 : : {
1418 [ + - + - ]: 143862 : {RPCResult::Type::STR, "asm", "Disassembly of the output script"},
1419 [ + - + - ]: 143862 : {RPCResult::Type::STR, "desc", "Inferred descriptor for the output"},
1420 [ + - + - ]: 143862 : {RPCResult::Type::STR_HEX, "hex", "The raw output script bytes, hex-encoded"},
1421 [ + - + - ]: 143862 : {RPCResult::Type::STR, "address", /*optional=*/true, "The Bitcoin address (only if a well-defined address exists)"},
1422 [ + - + - : 143862 : {RPCResult::Type::STR, "type", "The type (one of: " + GetAllOutputTypes() + ")"},
+ - ]
1423 [ + - + + : 935103 : };
- - ]
1424 [ + - + - : 719310 : }
+ - + - +
- - - ]
1425 : :
1426 : 22348 : uint256 GetTarget(const CBlockIndex& blockindex, const uint256 pow_limit)
1427 : : {
1428 : 22348 : arith_uint256 target{*CHECK_NONFATAL(DeriveTarget(blockindex.nBits, pow_limit))};
1429 : 22348 : return ArithToUint256(target);
1430 : : }
1431 : :
1432 : 40852 : std::vector<RPCResult> ElideGroup(std::vector<RPCResult> fields, std::string summary)
1433 : : {
1434 [ - + ]: 40852 : if (fields.empty()) return fields;
1435 : 40852 : std::vector<RPCResult> result;
1436 [ - + + - ]: 40852 : result.reserve(fields.size());
1437 [ - + + + ]: 320862 : for (size_t i = 0; i < fields.size(); ++i) {
1438 [ + - ]: 280010 : RPCResultOptions opts = fields[i].m_opts;
1439 [ + + ]: 280010 : if (i == 0) {
1440 [ + - ]: 40852 : opts.print_elision = summary;
1441 : : } else {
1442 : 239158 : opts.print_elision = HelpElisionSkip{};
1443 : : }
1444 [ + - ]: 280010 : result.emplace_back(fields[i], std::move(opts));
1445 : 280010 : }
1446 : 40852 : return result;
1447 : 40852 : }
|
