Branch data Line data Source code
1 : : // Copyright (c) 2010 Satoshi Nakamoto
2 : : // Copyright (c) 2009-2022 The Bitcoin Core developers
3 : : // Distributed under the MIT software license, see the accompanying
4 : : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
5 : :
6 : : #include <bitcoin-build-config.h> // IWYU pragma: keep
7 : :
8 : : #include <rpc/server.h>
9 : :
10 : : #include <common/args.h>
11 : : #include <common/system.h>
12 : : #include <logging.h>
13 : : #include <node/context.h>
14 : : #include <node/kernel_notifications.h>
15 : : #include <rpc/server_util.h>
16 : : #include <rpc/util.h>
17 : : #include <sync.h>
18 : : #include <util/signalinterrupt.h>
19 : : #include <util/strencodings.h>
20 : : #include <util/string.h>
21 : : #include <util/time.h>
22 : : #include <validation.h>
23 : :
24 : : #include <cassert>
25 : : #include <chrono>
26 : : #include <memory>
27 : : #include <mutex>
28 : : #include <unordered_map>
29 : :
30 : : using util::SplitString;
31 : :
32 : : static GlobalMutex g_rpc_warmup_mutex;
33 : : static std::atomic<bool> g_rpc_running{false};
34 : : static bool fRPCInWarmup GUARDED_BY(g_rpc_warmup_mutex) = true;
35 : : static std::string rpcWarmupStatus GUARDED_BY(g_rpc_warmup_mutex) = "RPC server started";
36 : : /* Timer-creating functions */
37 : : static RPCTimerInterface* timerInterface = nullptr;
38 : : /* Map of name to timer. */
39 : : static GlobalMutex g_deadline_timers_mutex;
40 : : static std::map<std::string, std::unique_ptr<RPCTimerBase> > deadlineTimers GUARDED_BY(g_deadline_timers_mutex);
41 : : static bool ExecuteCommand(const CRPCCommand& command, const JSONRPCRequest& request, UniValue& result, bool last_handler);
42 : :
43 : 134 : struct RPCCommandExecutionInfo
44 : : {
45 : : std::string method;
46 : : SteadyClock::time_point start;
47 : : };
48 : :
49 : : struct RPCServerInfo
50 : : {
51 : : Mutex mutex;
52 : : std::list<RPCCommandExecutionInfo> active_commands GUARDED_BY(mutex);
53 : : };
54 : :
55 : : static RPCServerInfo g_rpc_server_info;
56 : :
57 : : struct RPCCommandExecution
58 : : {
59 : : std::list<RPCCommandExecutionInfo>::iterator it;
60 : 67 : explicit RPCCommandExecution(const std::string& method)
61 : 67 : {
62 : 67 : LOCK(g_rpc_server_info.mutex);
63 [ + - + - ]: 67 : it = g_rpc_server_info.active_commands.insert(g_rpc_server_info.active_commands.end(), {method, SteadyClock::now()});
64 [ + - + - ]: 201 : }
65 : 67 : ~RPCCommandExecution()
66 : : {
67 : 67 : LOCK(g_rpc_server_info.mutex);
68 [ + - ]: 67 : g_rpc_server_info.active_commands.erase(it);
69 : 67 : }
70 : : };
71 : :
72 : 0 : std::string CRPCTable::help(const std::string& strCommand, const JSONRPCRequest& helpreq) const
73 : : {
74 [ # # ]: 0 : std::string strRet;
75 : 0 : std::string category;
76 [ # # ]: 0 : std::set<intptr_t> setDone;
77 : 0 : std::vector<std::pair<std::string, const CRPCCommand*> > vCommands;
78 [ # # ]: 0 : vCommands.reserve(mapCommands.size());
79 : :
80 [ # # ]: 0 : for (const auto& entry : mapCommands)
81 [ # # # # ]: 0 : vCommands.emplace_back(entry.second.front()->category + entry.first, entry.second.front());
82 : 0 : sort(vCommands.begin(), vCommands.end());
83 : :
84 [ # # ]: 0 : JSONRPCRequest jreq = helpreq;
85 : 0 : jreq.mode = JSONRPCRequest::GET_HELP;
86 : 0 : jreq.params = UniValue();
87 : :
88 [ # # ]: 0 : for (const std::pair<std::string, const CRPCCommand*>& command : vCommands)
89 : : {
90 : 0 : const CRPCCommand *pcmd = command.second;
91 [ # # ]: 0 : std::string strMethod = pcmd->name;
92 [ # # # # : 0 : if ((strCommand != "" || pcmd->category == "hidden") && strMethod != strCommand)
# # ]
93 : 0 : continue;
94 [ # # ]: 0 : jreq.strMethod = strMethod;
95 : 0 : try
96 : : {
97 [ # # ]: 0 : UniValue unused_result;
98 [ # # # # ]: 0 : if (setDone.insert(pcmd->unique_id).second)
99 [ # # ]: 0 : pcmd->actor(jreq, unused_result, /*last_handler=*/true);
100 : 0 : }
101 [ - - ]: 0 : catch (const std::exception& e)
102 : : {
103 : : // Help text is returned in an exception
104 [ - - ]: 0 : std::string strHelp = std::string(e.what());
105 [ - - ]: 0 : if (strCommand == "")
106 : : {
107 [ - - ]: 0 : if (strHelp.find('\n') != std::string::npos)
108 [ - - ]: 0 : strHelp = strHelp.substr(0, strHelp.find('\n'));
109 : :
110 [ - - ]: 0 : if (category != pcmd->category)
111 : : {
112 [ - - ]: 0 : if (!category.empty())
113 [ - - ]: 0 : strRet += "\n";
114 [ - - ]: 0 : category = pcmd->category;
115 [ - - - - : 0 : strRet += "== " + Capitalize(category) + " ==\n";
- - - - ]
116 : : }
117 : : }
118 [ - - ]: 0 : strRet += strHelp + "\n";
119 : 0 : }
120 : 0 : }
121 [ # # ]: 0 : if (strRet == "")
122 [ # # ]: 0 : strRet = strprintf("help: unknown command: %s\n", strCommand);
123 [ # # ]: 0 : strRet = strRet.substr(0,strRet.size()-1);
124 : 0 : return strRet;
125 : 0 : }
126 : :
127 : 258 : static RPCHelpMan help()
128 : : {
129 : 258 : return RPCHelpMan{"help",
130 : : "\nList all commands, or get help for a specified command.\n",
131 : : {
132 [ + - ]: 516 : {"command", RPCArg::Type::STR, RPCArg::DefaultHint{"all commands"}, "The command to get help on"},
133 : : },
134 : : {
135 [ + - + - : 516 : RPCResult{RPCResult::Type::STR, "", "The help text"},
+ - ]
136 [ + - + - : 516 : RPCResult{RPCResult::Type::ANY, "", ""},
+ - ]
137 : : },
138 [ + - + - ]: 774 : RPCExamples{""},
139 : 0 : [&](const RPCHelpMan& self, const JSONRPCRequest& jsonRequest) -> UniValue
140 : : {
141 [ # # ]: 0 : std::string strCommand;
142 [ # # ]: 0 : if (jsonRequest.params.size() > 0) {
143 [ # # # # : 0 : strCommand = jsonRequest.params[0].get_str();
# # ]
144 : : }
145 [ # # ]: 0 : if (strCommand == "dump_all_command_conversions") {
146 : : // Used for testing only, undocumented
147 [ # # ]: 0 : return tableRPC.dumpArgMap(jsonRequest);
148 : : }
149 : :
150 [ # # # # ]: 0 : return tableRPC.help(strCommand, jsonRequest);
151 : 0 : },
152 [ + - + - : 3612 : };
+ - + - +
- + - + -
+ + + + -
- - - ]
153 [ + - + - : 1548 : }
+ - + - +
- - - ]
154 : :
155 : 258 : static RPCHelpMan stop()
156 : : {
157 [ + + + - : 258 : static const std::string RESULT{CLIENT_NAME " stopping"};
+ - ]
158 : 258 : return RPCHelpMan{"stop",
159 : : // Also accept the hidden 'wait' integer argument (milliseconds)
160 : : // For instance, 'stop 1000' makes the call wait 1 second before returning
161 : : // to the client (intended for testing)
162 : : "\nRequest a graceful shutdown of " CLIENT_NAME ".",
163 : : {
164 [ + - + - ]: 516 : {"wait", RPCArg::Type::NUM, RPCArg::Optional::OMITTED, "how long to wait in ms", RPCArgOptions{.hidden=true}},
165 : : },
166 [ + - + - : 774 : RPCResult{RPCResult::Type::STR, "", "A string with the content '" + RESULT + "'"},
+ - ]
167 [ + - + - ]: 774 : RPCExamples{""},
168 : 0 : [&](const RPCHelpMan& self, const JSONRPCRequest& jsonRequest) -> UniValue
169 : : {
170 : : // Event loop will exit after current HTTP requests have been handled, so
171 : : // this reply will get back to the client.
172 : 0 : CHECK_NONFATAL((CHECK_NONFATAL(EnsureAnyNodeContext(jsonRequest.context).shutdown_request))());
173 [ # # ]: 0 : if (jsonRequest.params[0].isNum()) {
174 : 0 : UninterruptibleSleep(std::chrono::milliseconds{jsonRequest.params[0].getInt<int>()});
175 : : }
176 : 0 : return RESULT;
177 : : },
178 [ + - + - : 2322 : };
+ - + - +
- + - + +
- - ]
179 [ + - + - ]: 516 : }
180 : :
181 : 258 : static RPCHelpMan uptime()
182 : : {
183 : 258 : return RPCHelpMan{"uptime",
184 : : "\nReturns the total uptime of the server.\n",
185 : : {},
186 : 0 : RPCResult{
187 : : RPCResult::Type::NUM, "", "The number of seconds that the server has been running"
188 [ + - + - : 516 : },
+ - ]
189 : 258 : RPCExamples{
190 [ + - + - : 516 : HelpExampleCli("uptime", "")
+ - ]
191 [ + - + - : 1032 : + HelpExampleRpc("uptime", "")
+ - + - ]
192 [ + - ]: 258 : },
193 : 0 : [&](const RPCHelpMan& self, const JSONRPCRequest& request) -> UniValue
194 : : {
195 : 0 : return GetTime() - GetStartupTime();
196 : : }
197 [ + - + - : 1548 : };
+ - + - ]
198 : : }
199 : :
200 : 258 : static RPCHelpMan getrpcinfo()
201 : : {
202 : 258 : return RPCHelpMan{"getrpcinfo",
203 : : "\nReturns details of the RPC server.\n",
204 : : {},
205 : 0 : RPCResult{
206 : : RPCResult::Type::OBJ, "", "",
207 : : {
208 : : {RPCResult::Type::ARR, "active_commands", "All active commands",
209 : : {
210 : : {RPCResult::Type::OBJ, "", "Information about an active command",
211 : : {
212 : : {RPCResult::Type::STR, "method", "The name of the RPC command"},
213 : : {RPCResult::Type::NUM, "duration", "The running time in microseconds"},
214 : : }},
215 : : }},
216 : : {RPCResult::Type::STR, "logpath", "The complete file path to the debug log"},
217 : : }
218 [ + - + - : 2322 : },
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
- + - + -
+ - + - +
+ + + + +
- - - - -
- ]
219 : 258 : RPCExamples{
220 [ + - + - : 516 : HelpExampleCli("getrpcinfo", "")
+ - ]
221 [ + - + - : 1290 : + HelpExampleRpc("getrpcinfo", "")},
+ - + - +
- ]
222 : 0 : [&](const RPCHelpMan& self, const JSONRPCRequest& request) -> UniValue
223 : : {
224 : 0 : LOCK(g_rpc_server_info.mutex);
225 : 0 : UniValue active_commands(UniValue::VARR);
226 [ # # ]: 0 : for (const RPCCommandExecutionInfo& info : g_rpc_server_info.active_commands) {
227 : 0 : UniValue entry(UniValue::VOBJ);
228 [ # # # # : 0 : entry.pushKV("method", info.method);
# # ]
229 [ # # # # : 0 : entry.pushKV("duration", int64_t{Ticks<std::chrono::microseconds>(SteadyClock::now() - info.start)});
# # ]
230 [ # # ]: 0 : active_commands.push_back(std::move(entry));
231 : 0 : }
232 : :
233 : 0 : UniValue result(UniValue::VOBJ);
234 [ # # # # ]: 0 : result.pushKV("active_commands", std::move(active_commands));
235 : :
236 [ # # # # ]: 0 : const std::string path = LogInstance().m_file_path.utf8string();
237 [ # # ]: 0 : UniValue log_path(UniValue::VSTR, path);
238 [ # # # # ]: 0 : result.pushKV("logpath", std::move(log_path));
239 : :
240 : 0 : return result;
241 [ # # ]: 0 : }
242 [ + - + - : 1548 : };
+ - + - ]
243 [ + - + - : 1548 : }
+ - + - +
- + - - -
- - ]
244 : :
245 : : static const CRPCCommand vRPCCommands[]{
246 : : /* Overall control/query calls */
247 : : {"control", &getrpcinfo},
248 : : {"control", &help},
249 : : {"control", &stop},
250 : : {"control", &uptime},
251 : : };
252 : :
253 : 141 : CRPCTable::CRPCTable()
254 : : {
255 [ + + ]: 705 : for (const auto& c : vRPCCommands) {
256 [ + - ]: 564 : appendCommand(c.name, &c);
257 : : }
258 : 141 : }
259 : :
260 : 18978 : void CRPCTable::appendCommand(const std::string& name, const CRPCCommand* pcmd)
261 : : {
262 : 18978 : CHECK_NONFATAL(!IsRPCRunning()); // Only add commands before rpc is running
263 : :
264 : 18978 : mapCommands[name].push_back(pcmd);
265 : 18978 : }
266 : :
267 : 1242 : bool CRPCTable::removeCommand(const std::string& name, const CRPCCommand* pcmd)
268 : : {
269 : 1242 : auto it = mapCommands.find(name);
270 [ + - ]: 1242 : if (it != mapCommands.end()) {
271 : 1242 : auto new_end = std::remove(it->second.begin(), it->second.end(), pcmd);
272 [ + - ]: 1242 : if (it->second.end() != new_end) {
273 : 1242 : it->second.erase(new_end, it->second.end());
274 : 1242 : return true;
275 : : }
276 : : }
277 : : return false;
278 : : }
279 : :
280 : 0 : void StartRPC()
281 : : {
282 [ # # ]: 0 : LogDebug(BCLog::RPC, "Starting RPC\n");
283 : 0 : g_rpc_running = true;
284 : 0 : }
285 : :
286 : 0 : void InterruptRPC()
287 : : {
288 : 0 : static std::once_flag g_rpc_interrupt_flag;
289 : : // This function could be called twice if the GUI has been started with -server=1.
290 : 0 : std::call_once(g_rpc_interrupt_flag, []() {
291 [ # # ]: 0 : LogDebug(BCLog::RPC, "Interrupting RPC\n");
292 : : // Interrupt e.g. running longpolls
293 : 0 : g_rpc_running = false;
294 : 0 : });
295 : 0 : }
296 : :
297 : 0 : void StopRPC()
298 : : {
299 : 0 : static std::once_flag g_rpc_stop_flag;
300 : : // This function could be called twice if the GUI has been started with -server=1.
301 [ # # ]: 0 : assert(!g_rpc_running);
302 : 0 : std::call_once(g_rpc_stop_flag, [&]() {
303 [ # # ]: 0 : LogDebug(BCLog::RPC, "Stopping RPC\n");
304 [ # # ]: 0 : WITH_LOCK(g_deadline_timers_mutex, deadlineTimers.clear());
305 : 0 : DeleteAuthCookie();
306 [ # # ]: 0 : LogDebug(BCLog::RPC, "RPC stopped.\n");
307 : 0 : });
308 : 0 : }
309 : :
310 : 18978 : bool IsRPCRunning()
311 : : {
312 : 18978 : return g_rpc_running;
313 : : }
314 : :
315 : 0 : void RpcInterruptionPoint()
316 : : {
317 [ # # # # : 0 : if (!IsRPCRunning()) throw JSONRPCError(RPC_CLIENT_NOT_CONNECTED, "Shutting down");
# # ]
318 : 0 : }
319 : :
320 : 0 : void SetRPCWarmupStatus(const std::string& newStatus)
321 : : {
322 : 0 : LOCK(g_rpc_warmup_mutex);
323 [ # # # # ]: 0 : rpcWarmupStatus = newStatus;
324 : 0 : }
325 : :
326 : 1 : void SetRPCWarmupFinished()
327 : : {
328 : 1 : LOCK(g_rpc_warmup_mutex);
329 [ - + ]: 1 : assert(fRPCInWarmup);
330 [ + - ]: 1 : fRPCInWarmup = false;
331 : 1 : }
332 : :
333 : 67 : bool RPCIsInWarmup(std::string *outStatus)
334 : : {
335 : 67 : LOCK(g_rpc_warmup_mutex);
336 [ - + ]: 67 : if (outStatus)
337 [ # # ]: 0 : *outStatus = rpcWarmupStatus;
338 [ + - ]: 67 : return fRPCInWarmup;
339 : 67 : }
340 : :
341 : 246 : bool IsDeprecatedRPCEnabled(const std::string& method)
342 : : {
343 [ + - ]: 246 : const std::vector<std::string> enabled_methods = gArgs.GetArgs("-deprecatedrpc");
344 : :
345 : 246 : return find(enabled_methods.begin(), enabled_methods.end(), method) != enabled_methods.end();
346 : 246 : }
347 : :
348 : 0 : UniValue JSONRPCExec(const JSONRPCRequest& jreq, bool catch_errors)
349 : : {
350 [ # # ]: 0 : UniValue result;
351 [ # # ]: 0 : if (catch_errors) {
352 : 0 : try {
353 [ # # ]: 0 : result = tableRPC.execute(jreq);
354 [ - - - ]: 0 : } catch (UniValue& e) {
355 [ - - - - : 0 : return JSONRPCReplyObj(NullUniValue, std::move(e), jreq.id, jreq.m_json_version);
- - ]
356 : 0 : } catch (const std::exception& e) {
357 [ - - - - : 0 : return JSONRPCReplyObj(NullUniValue, JSONRPCError(RPC_MISC_ERROR, e.what()), jreq.id, jreq.m_json_version);
- - - - -
- ]
358 : 0 : }
359 : : } else {
360 [ # # ]: 0 : result = tableRPC.execute(jreq);
361 : : }
362 : :
363 [ # # # # : 0 : return JSONRPCReplyObj(std::move(result), NullUniValue, jreq.id, jreq.m_json_version);
# # ]
364 : 0 : }
365 : :
366 : : /**
367 : : * Process named arguments into a vector of positional arguments, based on the
368 : : * passed-in specification for the RPC call's arguments.
369 : : */
370 : 11 : static inline JSONRPCRequest transformNamedArguments(const JSONRPCRequest& in, const std::vector<std::pair<std::string, bool>>& argNames)
371 : : {
372 : 11 : JSONRPCRequest out = in;
373 : 11 : out.params = UniValue(UniValue::VARR);
374 : : // Build a map of parameters, and remove ones that have been processed, so that we can throw a focused error if
375 : : // there is an unknown one.
376 [ + - ]: 11 : const std::vector<std::string>& keys = in.params.getKeys();
377 [ + - ]: 11 : const std::vector<UniValue>& values = in.params.getValues();
378 : 11 : std::unordered_map<std::string, const UniValue*> argsIn;
379 [ + + ]: 38 : for (size_t i=0; i<keys.size(); ++i) {
380 [ + - + + ]: 28 : auto [_, inserted] = argsIn.emplace(keys[i], &values[i]);
381 [ + + ]: 28 : if (!inserted) {
382 [ + - + - ]: 3 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Parameter " + keys[i] + " specified multiple times");
383 : : }
384 : : }
385 : : // Process expected parameters. If any parameters were left unspecified in
386 : : // the request before a parameter that was specified, null values need to be
387 : : // inserted at the unspecified parameter positions, and the "hole" variable
388 : : // below tracks the number of null values that need to be inserted.
389 : : // The "initial_hole_size" variable stores the size of the initial hole,
390 : : // i.e. how many initial positional arguments were left unspecified. This is
391 : : // used after the for-loop to add initial positional arguments from the
392 : : // "args" parameter, if present.
393 : 10 : int hole = 0;
394 : 10 : int initial_hole_size = 0;
395 : 10 : const std::string* initial_param = nullptr;
396 : 10 : UniValue options{UniValue::VOBJ};
397 [ + - + + ]: 59 : for (const auto& [argNamePattern, named_only]: argNames) {
398 [ + - ]: 50 : std::vector<std::string> vargNames = SplitString(argNamePattern, '|');
399 : 50 : auto fr = argsIn.end();
400 [ + + ]: 79 : for (const std::string & argName : vargNames) {
401 : 50 : fr = argsIn.find(argName);
402 [ + + ]: 50 : if (fr != argsIn.end()) {
403 : : break;
404 : : }
405 : : }
406 : :
407 : : // Handle named-only parameters by pushing them into a temporary options
408 : : // object, and then pushing the accumulated options as the next
409 : : // positional argument.
410 [ + + ]: 50 : if (named_only) {
411 [ + + ]: 10 : if (fr != argsIn.end()) {
412 [ + - - + ]: 4 : if (options.exists(fr->first)) {
413 [ # # # # ]: 0 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Parameter " + fr->first + " specified multiple times");
414 : : }
415 [ + - + - : 8 : options.pushKVEnd(fr->first, *fr->second);
+ - ]
416 : 4 : argsIn.erase(fr);
417 : : }
418 : 10 : continue;
419 : : }
420 : :
421 [ + + + + ]: 40 : if (!options.empty() || fr != argsIn.end()) {
422 [ + + ]: 29 : for (int i = 0; i < hole; ++i) {
423 : : // Fill hole between specified parameters with JSON nulls,
424 : : // but not at the end (for backwards compatibility with calls
425 : : // that act based on number of specified parameters).
426 [ + - ]: 10 : out.params.push_back(UniValue());
427 : : }
428 : 19 : hole = 0;
429 [ + + ]: 19 : if (!initial_param) initial_param = &argNamePattern;
430 : : } else {
431 : 21 : hole += 1;
432 [ + + ]: 21 : if (out.params.empty()) initial_hole_size = hole;
433 : : }
434 : :
435 : : // If named input parameter "fr" is present, push it onto out.params. If
436 : : // options are present, push them onto out.params. If both are present,
437 : : // throw an error.
438 [ + + ]: 40 : if (fr != argsIn.end()) {
439 [ + + ]: 17 : if (!options.empty()) {
440 [ + - + - : 3 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Parameter " + fr->first + " conflicts with parameter " + options.getKeys().front());
+ - + - ]
441 : : }
442 [ + - + - ]: 16 : out.params.push_back(*fr->second);
443 : 16 : argsIn.erase(fr);
444 : : }
445 [ + + ]: 39 : if (!options.empty()) {
446 [ + - ]: 2 : out.params.push_back(std::move(options));
447 : 2 : options = UniValue{UniValue::VOBJ};
448 : : }
449 : 50 : }
450 : : // If leftover "args" param was found, use it as a source of positional
451 : : // arguments and add named arguments after. This is a convenience for
452 : : // clients that want to pass a combination of named and positional
453 : : // arguments as described in doc/JSON-RPC-interface.md#parameter-passing
454 [ + - ]: 18 : auto positional_args{argsIn.extract("args")};
455 [ + + + - ]: 9 : if (positional_args && positional_args.mapped()->isArray()) {
456 [ + + + + ]: 4 : if (initial_hole_size < (int)positional_args.mapped()->size() && initial_param) {
457 [ + - + - ]: 6 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Parameter " + *initial_param + " specified twice both as positional and named argument");
458 : : }
459 : : // Assign positional_args to out.params and append named_args after.
460 : 2 : UniValue named_args{std::move(out.params)};
461 [ + - ]: 2 : out.params = *positional_args.mapped();
462 [ + + ]: 5 : for (size_t i{out.params.size()}; i < named_args.size(); ++i) {
463 [ + - + - : 3 : out.params.push_back(named_args[i]);
+ - ]
464 : : }
465 : 2 : }
466 : : // If there are still arguments in the argsIn map, this is an error.
467 [ + + ]: 7 : if (!argsIn.empty()) {
468 [ + - + - ]: 2 : throw JSONRPCError(RPC_INVALID_PARAMETER, "Unknown named parameter " + argsIn.begin()->first);
469 : : }
470 : : // Return request with named arguments transformed to positional arguments
471 [ + + ]: 6 : return out;
472 : 15 : }
473 : :
474 : 67 : static bool ExecuteCommands(const std::vector<const CRPCCommand*>& commands, const JSONRPCRequest& request, UniValue& result)
475 : : {
476 [ + - ]: 67 : for (const auto& command : commands) {
477 [ - + ]: 67 : if (ExecuteCommand(*command, request, result, &command == &commands.back())) {
478 : : return true;
479 : : }
480 : : }
481 : : return false;
482 : : }
483 : :
484 : 67 : UniValue CRPCTable::execute(const JSONRPCRequest &request) const
485 : : {
486 : : // Return immediately if in warmup
487 : 67 : {
488 : 67 : LOCK(g_rpc_warmup_mutex);
489 [ - + ]: 67 : if (fRPCInWarmup)
490 [ # # ]: 0 : throw JSONRPCError(RPC_IN_WARMUP, rpcWarmupStatus);
491 : 0 : }
492 : :
493 : : // Find method
494 : 67 : auto it = mapCommands.find(request.strMethod);
495 [ + - ]: 67 : if (it != mapCommands.end()) {
496 [ + + ]: 67 : UniValue result;
497 [ + + - + ]: 67 : if (ExecuteCommands(it->second, request, result)) {
498 : 43 : return result;
499 : : }
500 : 24 : }
501 [ # # # # ]: 0 : throw JSONRPCError(RPC_METHOD_NOT_FOUND, "Method not found");
502 : : }
503 : :
504 : 67 : static bool ExecuteCommand(const CRPCCommand& command, const JSONRPCRequest& request, UniValue& result, bool last_handler)
505 : : {
506 : 67 : try {
507 [ + - ]: 67 : RPCCommandExecution execution(request.strMethod);
508 : : // Execute, convert arguments to array if necessary
509 [ + + ]: 67 : if (request.params.isObject()) {
510 [ + + + - ]: 11 : return command.actor(transformNamedArguments(request, command.argNames), result, last_handler);
511 : : } else {
512 [ + + ]: 56 : return command.actor(request, result, last_handler);
513 : : }
514 [ + - + ]: 91 : } catch (const UniValue::type_error& e) {
515 [ - - - - ]: 0 : throw JSONRPCError(RPC_TYPE_ERROR, e.what());
516 : 6 : } catch (const std::exception& e) {
517 [ + - + - ]: 12 : throw JSONRPCError(RPC_MISC_ERROR, e.what());
518 : 6 : }
519 : : }
520 : :
521 : 0 : std::vector<std::string> CRPCTable::listCommands() const
522 : : {
523 : 0 : std::vector<std::string> commandList;
524 [ # # ]: 0 : commandList.reserve(mapCommands.size());
525 [ # # # # ]: 0 : for (const auto& i : mapCommands) commandList.emplace_back(i.first);
526 : 0 : return commandList;
527 : 0 : }
528 : :
529 : 0 : UniValue CRPCTable::dumpArgMap(const JSONRPCRequest& args_request) const
530 : : {
531 : 0 : JSONRPCRequest request = args_request;
532 : 0 : request.mode = JSONRPCRequest::GET_ARGS;
533 : :
534 : 0 : UniValue ret{UniValue::VARR};
535 [ # # ]: 0 : for (const auto& cmd : mapCommands) {
536 [ # # ]: 0 : UniValue result;
537 [ # # # # ]: 0 : if (ExecuteCommands(cmd.second, request, result)) {
538 [ # # # # ]: 0 : for (const auto& values : result.getValues()) {
539 [ # # # # ]: 0 : ret.push_back(values);
540 : : }
541 : : }
542 : 0 : }
543 : 0 : return ret;
544 : 0 : }
545 : :
546 : 0 : void RPCSetTimerInterfaceIfUnset(RPCTimerInterface *iface)
547 : : {
548 [ # # ]: 0 : if (!timerInterface)
549 : 0 : timerInterface = iface;
550 : 0 : }
551 : :
552 : 0 : void RPCSetTimerInterface(RPCTimerInterface *iface)
553 : : {
554 : 0 : timerInterface = iface;
555 : 0 : }
556 : :
557 : 0 : void RPCUnsetTimerInterface(RPCTimerInterface *iface)
558 : : {
559 [ # # ]: 0 : if (timerInterface == iface)
560 : 0 : timerInterface = nullptr;
561 : 0 : }
562 : :
563 : 0 : void RPCRunLater(const std::string& name, std::function<void()> func, int64_t nSeconds)
564 : : {
565 [ # # ]: 0 : if (!timerInterface)
566 [ # # # # ]: 0 : throw JSONRPCError(RPC_INTERNAL_ERROR, "No timer handler registered for RPC");
567 : 0 : LOCK(g_deadline_timers_mutex);
568 : 0 : deadlineTimers.erase(name);
569 [ # # # # : 0 : LogDebug(BCLog::RPC, "queue run of timer %s in %i seconds (using %s)\n", name, nSeconds, timerInterface->Name());
# # # # ]
570 [ # # # # : 0 : deadlineTimers.emplace(name, std::unique_ptr<RPCTimerBase>(timerInterface->NewTimer(func, nSeconds*1000)));
# # ]
571 : 0 : }
572 : :
573 : : CRPCTable tableRPC;
|
