Bitcoin Core 29.99.0
P2P Digital Currency
interfaces.cpp
Go to the documentation of this file.
1// Copyright (c) 2018-2022 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 <addrdb.h>
6#include <banman.h>
7#include <blockfilter.h>
8#include <chain.h>
9#include <chainparams.h>
10#include <common/args.h>
11#include <consensus/merkle.h>
13#include <deploymentstatus.h>
14#include <external_signer.h>
16#include <init.h>
17#include <interfaces/chain.h>
18#include <interfaces/handler.h>
19#include <interfaces/mining.h>
20#include <interfaces/node.h>
21#include <interfaces/types.h>
22#include <interfaces/wallet.h>
23#include <kernel/chain.h>
24#include <kernel/context.h>
26#include <logging.h>
27#include <mapport.h>
28#include <net.h>
29#include <net_processing.h>
30#include <netaddress.h>
31#include <netbase.h>
32#include <node/blockstorage.h>
33#include <node/coin.h>
34#include <node/context.h>
35#include <node/interface_ui.h>
36#include <node/mini_miner.h>
37#include <node/miner.h>
39#include <node/transaction.h>
40#include <node/types.h>
41#include <node/warnings.h>
42#include <policy/feerate.h>
43#include <policy/fees.h>
44#include <policy/policy.h>
45#include <policy/rbf.h>
46#include <policy/settings.h>
47#include <primitives/block.h>
49#include <rpc/blockchain.h>
50#include <rpc/protocol.h>
51#include <rpc/server.h>
53#include <sync.h>
54#include <txmempool.h>
55#include <uint256.h>
56#include <univalue.h>
57#include <util/check.h>
58#include <util/result.h>
60#include <util/string.h>
61#include <util/translation.h>
62#include <validation.h>
63#include <validationinterface.h>
64
65#include <bitcoin-build-config.h> // IWYU pragma: keep
66
67#include <any>
68#include <memory>
69#include <optional>
70#include <utility>
71
72#include <boost/signals2/signal.hpp>
73
86using util::Join;
87
88namespace node {
89// All members of the classes in this namespace are intentionally public, as the
90// classes themselves are private.
91namespace {
92#ifdef ENABLE_EXTERNAL_SIGNER
93class ExternalSignerImpl : public interfaces::ExternalSigner
94{
95public:
96 ExternalSignerImpl(::ExternalSigner signer) : m_signer(std::move(signer)) {}
97 std::string getName() override { return m_signer.m_name; }
99};
100#endif
101
102class NodeImpl : public Node
103{
104public:
105 explicit NodeImpl(NodeContext& context) { setContext(&context); }
106 void initLogging() override { InitLogging(args()); }
107 void initParameterInteraction() override { InitParameterInteraction(args()); }
108 bilingual_str getWarnings() override { return Join(Assert(m_context->warnings)->GetMessages(), Untranslated("<hr />")); }
109 int getExitStatus() override { return Assert(m_context)->exit_status.load(); }
110 BCLog::CategoryMask getLogCategories() override { return LogInstance().GetCategoryMask(); }
111 bool baseInitialize() override
112 {
113 if (!AppInitBasicSetup(args(), Assert(context())->exit_status)) return false;
114 if (!AppInitParameterInteraction(args())) return false;
115
116 m_context->warnings = std::make_unique<node::Warnings>();
117 m_context->kernel = std::make_unique<kernel::Context>();
118 m_context->ecc_context = std::make_unique<ECC_Context>();
119 if (!AppInitSanityChecks(*m_context->kernel)) return false;
120
121 if (!AppInitLockDirectories()) return false;
122 if (!AppInitInterfaces(*m_context)) return false;
123
124 return true;
125 }
126 bool appInitMain(interfaces::BlockAndHeaderTipInfo* tip_info) override
127 {
128 if (AppInitMain(*m_context, tip_info)) return true;
129 // Error during initialization, set exit status before continue
130 m_context->exit_status.store(EXIT_FAILURE);
131 return false;
132 }
133 void appShutdown() override
134 {
137 }
138 void startShutdown() override
139 {
140 NodeContext& ctx{*Assert(m_context)};
141 if (!(Assert(ctx.shutdown_request))()) {
142 LogError("Failed to send shutdown signal\n");
143 }
144
145 // Stop RPC for clean shutdown if any of waitfor* commands is executed.
146 if (args().GetBoolArg("-server", false)) {
147 InterruptRPC();
148 StopRPC();
149 }
150 }
151 bool shutdownRequested() override { return ShutdownRequested(*Assert(m_context)); };
152 bool isSettingIgnored(const std::string& name) override
153 {
154 bool ignored = false;
155 args().LockSettings([&](common::Settings& settings) {
156 if (auto* options = common::FindKey(settings.command_line_options, name)) {
157 ignored = !options->empty();
158 }
159 });
160 return ignored;
161 }
162 common::SettingsValue getPersistentSetting(const std::string& name) override { return args().GetPersistentSetting(name); }
163 void updateRwSetting(const std::string& name, const common::SettingsValue& value) override
164 {
165 args().LockSettings([&](common::Settings& settings) {
166 if (value.isNull()) {
167 settings.rw_settings.erase(name);
168 } else {
169 settings.rw_settings[name] = value;
170 }
171 });
173 }
174 void forceSetting(const std::string& name, const common::SettingsValue& value) override
175 {
176 args().LockSettings([&](common::Settings& settings) {
177 if (value.isNull()) {
178 settings.forced_settings.erase(name);
179 } else {
180 settings.forced_settings[name] = value;
181 }
182 });
183 }
184 void resetSettings() override
185 {
186 args().WriteSettingsFile(/*errors=*/nullptr, /*backup=*/true);
187 args().LockSettings([&](common::Settings& settings) {
188 settings.rw_settings.clear();
189 });
191 }
192 void mapPort(bool enable) override { StartMapPort(enable); }
193 bool getProxy(Network net, Proxy& proxy_info) override { return GetProxy(net, proxy_info); }
194 size_t getNodeCount(ConnectionDirection flags) override
195 {
196 return m_context->connman ? m_context->connman->GetNodeCount(flags) : 0;
197 }
198 bool getNodesStats(NodesStats& stats) override
199 {
200 stats.clear();
201
202 if (m_context->connman) {
203 std::vector<CNodeStats> stats_temp;
204 m_context->connman->GetNodeStats(stats_temp);
205
206 stats.reserve(stats_temp.size());
207 for (auto& node_stats_temp : stats_temp) {
208 stats.emplace_back(std::move(node_stats_temp), false, CNodeStateStats());
209 }
210
211 // Try to retrieve the CNodeStateStats for each node.
212 if (m_context->peerman) {
213 TRY_LOCK(::cs_main, lockMain);
214 if (lockMain) {
215 for (auto& node_stats : stats) {
216 std::get<1>(node_stats) =
217 m_context->peerman->GetNodeStateStats(std::get<0>(node_stats).nodeid, std::get<2>(node_stats));
218 }
219 }
220 }
221 return true;
222 }
223 return false;
224 }
225 bool getBanned(banmap_t& banmap) override
226 {
227 if (m_context->banman) {
228 m_context->banman->GetBanned(banmap);
229 return true;
230 }
231 return false;
232 }
233 bool ban(const CNetAddr& net_addr, int64_t ban_time_offset) override
234 {
235 if (m_context->banman) {
236 m_context->banman->Ban(net_addr, ban_time_offset);
237 return true;
238 }
239 return false;
240 }
241 bool unban(const CSubNet& ip) override
242 {
243 if (m_context->banman) {
244 m_context->banman->Unban(ip);
245 return true;
246 }
247 return false;
248 }
249 bool disconnectByAddress(const CNetAddr& net_addr) override
250 {
251 if (m_context->connman) {
252 return m_context->connman->DisconnectNode(net_addr);
253 }
254 return false;
255 }
256 bool disconnectById(NodeId id) override
257 {
258 if (m_context->connman) {
259 return m_context->connman->DisconnectNode(id);
260 }
261 return false;
262 }
263 std::vector<std::unique_ptr<interfaces::ExternalSigner>> listExternalSigners() override
264 {
265#ifdef ENABLE_EXTERNAL_SIGNER
266 std::vector<ExternalSigner> signers = {};
267 const std::string command = args().GetArg("-signer", "");
268 if (command == "") return {};
269 ExternalSigner::Enumerate(command, signers, Params().GetChainTypeString());
270 std::vector<std::unique_ptr<interfaces::ExternalSigner>> result;
271 result.reserve(signers.size());
272 for (auto& signer : signers) {
273 result.emplace_back(std::make_unique<ExternalSignerImpl>(std::move(signer)));
274 }
275 return result;
276#else
277 // This result is indistinguishable from a successful call that returns
278 // no signers. For the current GUI this doesn't matter, because the wallet
279 // creation dialog disables the external signer checkbox in both
280 // cases. The return type could be changed to std::optional<std::vector>
281 // (or something that also includes error messages) if this distinction
282 // becomes important.
283 return {};
284#endif // ENABLE_EXTERNAL_SIGNER
285 }
286 int64_t getTotalBytesRecv() override { return m_context->connman ? m_context->connman->GetTotalBytesRecv() : 0; }
287 int64_t getTotalBytesSent() override { return m_context->connman ? m_context->connman->GetTotalBytesSent() : 0; }
288 size_t getMempoolSize() override { return m_context->mempool ? m_context->mempool->size() : 0; }
289 size_t getMempoolDynamicUsage() override { return m_context->mempool ? m_context->mempool->DynamicMemoryUsage() : 0; }
290 size_t getMempoolMaxUsage() override { return m_context->mempool ? m_context->mempool->m_opts.max_size_bytes : 0; }
291 bool getHeaderTip(int& height, int64_t& block_time) override
292 {
294 auto best_header = chainman().m_best_header;
295 if (best_header) {
296 height = best_header->nHeight;
297 block_time = best_header->GetBlockTime();
298 return true;
299 }
300 return false;
301 }
302 std::map<CNetAddr, LocalServiceInfo> getNetLocalAddresses() override
303 {
304 if (m_context->connman)
305 return m_context->connman->getNetLocalAddresses();
306 else
307 return {};
308 }
309 int getNumBlocks() override
310 {
312 return chainman().ActiveChain().Height();
313 }
314 uint256 getBestBlockHash() override
315 {
316 const CBlockIndex* tip = WITH_LOCK(::cs_main, return chainman().ActiveChain().Tip());
317 return tip ? tip->GetBlockHash() : chainman().GetParams().GenesisBlock().GetHash();
318 }
319 int64_t getLastBlockTime() override
320 {
322 if (chainman().ActiveChain().Tip()) {
323 return chainman().ActiveChain().Tip()->GetBlockTime();
324 }
325 return chainman().GetParams().GenesisBlock().GetBlockTime(); // Genesis block's time of current network
326 }
327 double getVerificationProgress() override
328 {
329 LOCK(chainman().GetMutex());
330 return chainman().GuessVerificationProgress(chainman().ActiveTip());
331 }
332 bool isInitialBlockDownload() override
333 {
334 return chainman().IsInitialBlockDownload();
335 }
336 bool isLoadingBlocks() override { return chainman().m_blockman.LoadingBlocks(); }
337 void setNetworkActive(bool active) override
338 {
339 if (m_context->connman) {
340 m_context->connman->SetNetworkActive(active);
341 }
342 }
343 bool getNetworkActive() override { return m_context->connman && m_context->connman->GetNetworkActive(); }
344 CFeeRate getDustRelayFee() override
345 {
346 if (!m_context->mempool) return CFeeRate{DUST_RELAY_TX_FEE};
347 return m_context->mempool->m_opts.dust_relay_feerate;
348 }
349 UniValue executeRpc(const std::string& command, const UniValue& params, const std::string& uri) override
350 {
351 JSONRPCRequest req;
352 req.context = m_context;
353 req.params = params;
354 req.strMethod = command;
355 req.URI = uri;
357 }
358 std::vector<std::string> listRpcCommands() override { return ::tableRPC.listCommands(); }
359 std::optional<Coin> getUnspentOutput(const COutPoint& output) override
360 {
362 return chainman().ActiveChainstate().CoinsTip().GetCoin(output);
363 }
364 TransactionError broadcastTransaction(CTransactionRef tx, CAmount max_tx_fee, std::string& err_string) override
365 {
366 return BroadcastTransaction(*m_context, std::move(tx), err_string, max_tx_fee, /*relay=*/ true, /*wait_callback=*/ false);
367 }
368 WalletLoader& walletLoader() override
369 {
370 return *Assert(m_context->wallet_loader);
371 }
372 std::unique_ptr<Handler> handleInitMessage(InitMessageFn fn) override
373 {
374 return MakeSignalHandler(::uiInterface.InitMessage_connect(fn));
375 }
376 std::unique_ptr<Handler> handleMessageBox(MessageBoxFn fn) override
377 {
378 return MakeSignalHandler(::uiInterface.ThreadSafeMessageBox_connect(fn));
379 }
380 std::unique_ptr<Handler> handleQuestion(QuestionFn fn) override
381 {
382 return MakeSignalHandler(::uiInterface.ThreadSafeQuestion_connect(fn));
383 }
384 std::unique_ptr<Handler> handleShowProgress(ShowProgressFn fn) override
385 {
386 return MakeSignalHandler(::uiInterface.ShowProgress_connect(fn));
387 }
388 std::unique_ptr<Handler> handleInitWallet(InitWalletFn fn) override
389 {
390 return MakeSignalHandler(::uiInterface.InitWallet_connect(fn));
391 }
392 std::unique_ptr<Handler> handleNotifyNumConnectionsChanged(NotifyNumConnectionsChangedFn fn) override
393 {
394 return MakeSignalHandler(::uiInterface.NotifyNumConnectionsChanged_connect(fn));
395 }
396 std::unique_ptr<Handler> handleNotifyNetworkActiveChanged(NotifyNetworkActiveChangedFn fn) override
397 {
398 return MakeSignalHandler(::uiInterface.NotifyNetworkActiveChanged_connect(fn));
399 }
400 std::unique_ptr<Handler> handleNotifyAlertChanged(NotifyAlertChangedFn fn) override
401 {
402 return MakeSignalHandler(::uiInterface.NotifyAlertChanged_connect(fn));
403 }
404 std::unique_ptr<Handler> handleBannedListChanged(BannedListChangedFn fn) override
405 {
406 return MakeSignalHandler(::uiInterface.BannedListChanged_connect(fn));
407 }
408 std::unique_ptr<Handler> handleNotifyBlockTip(NotifyBlockTipFn fn) override
409 {
410 return MakeSignalHandler(::uiInterface.NotifyBlockTip_connect([fn](SynchronizationState sync_state, const CBlockIndex& block, double verification_progress) {
411 fn(sync_state, BlockTip{block.nHeight, block.GetBlockTime(), block.GetBlockHash()}, verification_progress);
412 }));
413 }
414 std::unique_ptr<Handler> handleNotifyHeaderTip(NotifyHeaderTipFn fn) override
415 {
416 return MakeSignalHandler(
417 ::uiInterface.NotifyHeaderTip_connect([fn](SynchronizationState sync_state, int64_t height, int64_t timestamp, bool presync) {
418 fn(sync_state, BlockTip{(int)height, timestamp, uint256{}}, presync);
419 }));
420 }
421 NodeContext* context() override { return m_context; }
422 void setContext(NodeContext* context) override
423 {
424 m_context = context;
425 }
426 ArgsManager& args() { return *Assert(Assert(m_context)->args); }
427 ChainstateManager& chainman() { return *Assert(m_context->chainman); }
428 NodeContext* m_context{nullptr};
429};
430
431// NOLINTNEXTLINE(misc-no-recursion)
432bool FillBlock(const CBlockIndex* index, const FoundBlock& block, UniqueLock<RecursiveMutex>& lock, const CChain& active, const BlockManager& blockman) EXCLUSIVE_LOCKS_REQUIRED(cs_main)
433{
434 if (!index) return false;
435 if (block.m_hash) *block.m_hash = index->GetBlockHash();
436 if (block.m_height) *block.m_height = index->nHeight;
437 if (block.m_time) *block.m_time = index->GetBlockTime();
438 if (block.m_max_time) *block.m_max_time = index->GetBlockTimeMax();
439 if (block.m_mtp_time) *block.m_mtp_time = index->GetMedianTimePast();
440 if (block.m_in_active_chain) *block.m_in_active_chain = active[index->nHeight] == index;
441 if (block.m_locator) { *block.m_locator = GetLocator(index); }
442 if (block.m_next_block) FillBlock(active[index->nHeight] == index ? active[index->nHeight + 1] : nullptr, *block.m_next_block, lock, active, blockman);
443 if (block.m_data) {
444 REVERSE_LOCK(lock, cs_main);
445 if (!blockman.ReadBlock(*block.m_data, *index)) block.m_data->SetNull();
446 }
447 block.found = true;
448 return true;
449}
450
451class NotificationsProxy : public CValidationInterface
452{
453public:
454 explicit NotificationsProxy(std::shared_ptr<Chain::Notifications> notifications)
455 : m_notifications(std::move(notifications)) {}
456 virtual ~NotificationsProxy() = default;
457 void TransactionAddedToMempool(const NewMempoolTransactionInfo& tx, uint64_t mempool_sequence) override
458 {
459 m_notifications->transactionAddedToMempool(tx.info.m_tx);
460 }
461 void TransactionRemovedFromMempool(const CTransactionRef& tx, MemPoolRemovalReason reason, uint64_t mempool_sequence) override
462 {
463 m_notifications->transactionRemovedFromMempool(tx, reason);
464 }
465 void BlockConnected(ChainstateRole role, const std::shared_ptr<const CBlock>& block, const CBlockIndex* index) override
466 {
467 m_notifications->blockConnected(role, kernel::MakeBlockInfo(index, block.get()));
468 }
469 void BlockDisconnected(const std::shared_ptr<const CBlock>& block, const CBlockIndex* index) override
470 {
471 m_notifications->blockDisconnected(kernel::MakeBlockInfo(index, block.get()));
472 }
473 void UpdatedBlockTip(const CBlockIndex* index, const CBlockIndex* fork_index, bool is_ibd) override
474 {
475 m_notifications->updatedBlockTip();
476 }
477 void ChainStateFlushed(ChainstateRole role, const CBlockLocator& locator) override {
478 m_notifications->chainStateFlushed(role, locator);
479 }
480 std::shared_ptr<Chain::Notifications> m_notifications;
481};
482
483class NotificationsHandlerImpl : public Handler
484{
485public:
486 explicit NotificationsHandlerImpl(ValidationSignals& signals, std::shared_ptr<Chain::Notifications> notifications)
487 : m_signals{signals}, m_proxy{std::make_shared<NotificationsProxy>(std::move(notifications))}
488 {
490 }
491 ~NotificationsHandlerImpl() override { disconnect(); }
492 void disconnect() override
493 {
494 if (m_proxy) {
496 m_proxy.reset();
497 }
498 }
500 std::shared_ptr<NotificationsProxy> m_proxy;
501};
502
503class RpcHandlerImpl : public Handler
504{
505public:
506 explicit RpcHandlerImpl(const CRPCCommand& command) : m_command(command), m_wrapped_command(&command)
507 {
508 m_command.actor = [this](const JSONRPCRequest& request, UniValue& result, bool last_handler) {
509 if (!m_wrapped_command) return false;
510 try {
511 return m_wrapped_command->actor(request, result, last_handler);
512 } catch (const UniValue& e) {
513 // If this is not the last handler and a wallet not found
514 // exception was thrown, return false so the next handler can
515 // try to handle the request. Otherwise, reraise the exception.
516 if (!last_handler) {
517 const UniValue& code = e["code"];
518 if (code.isNum() && code.getInt<int>() == RPC_WALLET_NOT_FOUND) {
519 return false;
520 }
521 }
522 throw;
523 }
524 };
526 }
527
528 void disconnect() final
529 {
530 if (m_wrapped_command) {
531 m_wrapped_command = nullptr;
533 }
534 }
535
536 ~RpcHandlerImpl() override { disconnect(); }
537
540};
541
542class ChainImpl : public Chain
543{
544public:
545 explicit ChainImpl(NodeContext& node) : m_node(node) {}
546 std::optional<int> getHeight() override
547 {
548 const int height{WITH_LOCK(::cs_main, return chainman().ActiveChain().Height())};
549 return height >= 0 ? std::optional{height} : std::nullopt;
550 }
551 uint256 getBlockHash(int height) override
552 {
554 return Assert(chainman().ActiveChain()[height])->GetBlockHash();
555 }
556 bool haveBlockOnDisk(int height) override
557 {
559 const CBlockIndex* block{chainman().ActiveChain()[height]};
560 return block && ((block->nStatus & BLOCK_HAVE_DATA) != 0) && block->nTx > 0;
561 }
562 std::optional<int> findLocatorFork(const CBlockLocator& locator) override
563 {
565 if (const CBlockIndex* fork = chainman().ActiveChainstate().FindForkInGlobalIndex(locator)) {
566 return fork->nHeight;
567 }
568 return std::nullopt;
569 }
570 bool hasBlockFilterIndex(BlockFilterType filter_type) override
571 {
572 return GetBlockFilterIndex(filter_type) != nullptr;
573 }
574 std::optional<bool> blockFilterMatchesAny(BlockFilterType filter_type, const uint256& block_hash, const GCSFilter::ElementSet& filter_set) override
575 {
576 const BlockFilterIndex* block_filter_index{GetBlockFilterIndex(filter_type)};
577 if (!block_filter_index) return std::nullopt;
578
579 BlockFilter filter;
580 const CBlockIndex* index{WITH_LOCK(::cs_main, return chainman().m_blockman.LookupBlockIndex(block_hash))};
581 if (index == nullptr || !block_filter_index->LookupFilter(index, filter)) return std::nullopt;
582 return filter.GetFilter().MatchAny(filter_set);
583 }
584 bool findBlock(const uint256& hash, const FoundBlock& block) override
585 {
586 WAIT_LOCK(cs_main, lock);
587 return FillBlock(chainman().m_blockman.LookupBlockIndex(hash), block, lock, chainman().ActiveChain(), chainman().m_blockman);
588 }
589 bool findFirstBlockWithTimeAndHeight(int64_t min_time, int min_height, const FoundBlock& block) override
590 {
591 WAIT_LOCK(cs_main, lock);
592 const CChain& active = chainman().ActiveChain();
593 return FillBlock(active.FindEarliestAtLeast(min_time, min_height), block, lock, active, chainman().m_blockman);
594 }
595 bool findAncestorByHeight(const uint256& block_hash, int ancestor_height, const FoundBlock& ancestor_out) override
596 {
597 WAIT_LOCK(cs_main, lock);
598 const CChain& active = chainman().ActiveChain();
599 if (const CBlockIndex* block = chainman().m_blockman.LookupBlockIndex(block_hash)) {
600 if (const CBlockIndex* ancestor = block->GetAncestor(ancestor_height)) {
601 return FillBlock(ancestor, ancestor_out, lock, active, chainman().m_blockman);
602 }
603 }
604 return FillBlock(nullptr, ancestor_out, lock, active, chainman().m_blockman);
605 }
606 bool findAncestorByHash(const uint256& block_hash, const uint256& ancestor_hash, const FoundBlock& ancestor_out) override
607 {
608 WAIT_LOCK(cs_main, lock);
609 const CBlockIndex* block = chainman().m_blockman.LookupBlockIndex(block_hash);
610 const CBlockIndex* ancestor = chainman().m_blockman.LookupBlockIndex(ancestor_hash);
611 if (block && ancestor && block->GetAncestor(ancestor->nHeight) != ancestor) ancestor = nullptr;
612 return FillBlock(ancestor, ancestor_out, lock, chainman().ActiveChain(), chainman().m_blockman);
613 }
614 bool findCommonAncestor(const uint256& block_hash1, const uint256& block_hash2, const FoundBlock& ancestor_out, const FoundBlock& block1_out, const FoundBlock& block2_out) override
615 {
616 WAIT_LOCK(cs_main, lock);
617 const CChain& active = chainman().ActiveChain();
618 const CBlockIndex* block1 = chainman().m_blockman.LookupBlockIndex(block_hash1);
619 const CBlockIndex* block2 = chainman().m_blockman.LookupBlockIndex(block_hash2);
620 const CBlockIndex* ancestor = block1 && block2 ? LastCommonAncestor(block1, block2) : nullptr;
621 // Using & instead of && below to avoid short circuiting and leaving
622 // output uninitialized. Cast bool to int to avoid -Wbitwise-instead-of-logical
623 // compiler warnings.
624 return int{FillBlock(ancestor, ancestor_out, lock, active, chainman().m_blockman)} &
625 int{FillBlock(block1, block1_out, lock, active, chainman().m_blockman)} &
626 int{FillBlock(block2, block2_out, lock, active, chainman().m_blockman)};
627 }
628 void findCoins(std::map<COutPoint, Coin>& coins) override { return FindCoins(m_node, coins); }
629 double guessVerificationProgress(const uint256& block_hash) override
630 {
631 LOCK(chainman().GetMutex());
632 return chainman().GuessVerificationProgress(chainman().m_blockman.LookupBlockIndex(block_hash));
633 }
634 bool hasBlocks(const uint256& block_hash, int min_height, std::optional<int> max_height) override
635 {
636 // hasBlocks returns true if all ancestors of block_hash in specified
637 // range have block data (are not pruned), false if any ancestors in
638 // specified range are missing data.
639 //
640 // For simplicity and robustness, min_height and max_height are only
641 // used to limit the range, and passing min_height that's too low or
642 // max_height that's too high will not crash or change the result.
644 if (const CBlockIndex* block = chainman().m_blockman.LookupBlockIndex(block_hash)) {
645 if (max_height && block->nHeight >= *max_height) block = block->GetAncestor(*max_height);
646 for (; block->nStatus & BLOCK_HAVE_DATA; block = block->pprev) {
647 // Check pprev to not segfault if min_height is too low
648 if (block->nHeight <= min_height || !block->pprev) return true;
649 }
650 }
651 return false;
652 }
653 RBFTransactionState isRBFOptIn(const CTransaction& tx) override
654 {
655 if (!m_node.mempool) return IsRBFOptInEmptyMempool(tx);
656 LOCK(m_node.mempool->cs);
657 return IsRBFOptIn(tx, *m_node.mempool);
658 }
659 bool isInMempool(const Txid& txid) override
660 {
661 if (!m_node.mempool) return false;
662 LOCK(m_node.mempool->cs);
663 return m_node.mempool->exists(txid);
664 }
665 bool hasDescendantsInMempool(const Txid& txid) override
666 {
667 if (!m_node.mempool) return false;
668 LOCK(m_node.mempool->cs);
669 const auto entry{m_node.mempool->GetEntry(txid)};
670 if (entry == nullptr) return false;
671 return entry->GetCountWithDescendants() > 1;
672 }
673 bool broadcastTransaction(const CTransactionRef& tx,
674 const CAmount& max_tx_fee,
675 bool relay,
676 std::string& err_string) override
677 {
678 const TransactionError err = BroadcastTransaction(m_node, tx, err_string, max_tx_fee, relay, /*wait_callback=*/false);
679 // Chain clients only care about failures to accept the tx to the mempool. Disregard non-mempool related failures.
680 // Note: this will need to be updated if BroadcastTransactions() is updated to return other non-mempool failures
681 // that Chain clients do not need to know about.
682 return TransactionError::OK == err;
683 }
684 void getTransactionAncestry(const Txid& txid, size_t& ancestors, size_t& descendants, size_t* ancestorsize, CAmount* ancestorfees) override
685 {
686 ancestors = descendants = 0;
687 if (!m_node.mempool) return;
688 m_node.mempool->GetTransactionAncestry(txid, ancestors, descendants, ancestorsize, ancestorfees);
689 }
690
691 std::map<COutPoint, CAmount> calculateIndividualBumpFees(const std::vector<COutPoint>& outpoints, const CFeeRate& target_feerate) override
692 {
693 if (!m_node.mempool) {
694 std::map<COutPoint, CAmount> bump_fees;
695 for (const auto& outpoint : outpoints) {
696 bump_fees.emplace(outpoint, 0);
697 }
698 return bump_fees;
699 }
700 return MiniMiner(*m_node.mempool, outpoints).CalculateBumpFees(target_feerate);
701 }
702
703 std::optional<CAmount> calculateCombinedBumpFee(const std::vector<COutPoint>& outpoints, const CFeeRate& target_feerate) override
704 {
705 if (!m_node.mempool) {
706 return 0;
707 }
708 return MiniMiner(*m_node.mempool, outpoints).CalculateTotalBumpFees(target_feerate);
709 }
710 void getPackageLimits(unsigned int& limit_ancestor_count, unsigned int& limit_descendant_count) override
711 {
712 const CTxMemPool::Limits default_limits{};
713
714 const CTxMemPool::Limits& limits{m_node.mempool ? m_node.mempool->m_opts.limits : default_limits};
715
716 limit_ancestor_count = limits.ancestor_count;
717 limit_descendant_count = limits.descendant_count;
718 }
719 util::Result<void> checkChainLimits(const CTransactionRef& tx) override
720 {
721 if (!m_node.mempool) return {};
723 CTxMemPoolEntry entry(tx, 0, 0, 0, 0, false, 0, lp);
724 LOCK(m_node.mempool->cs);
725 return m_node.mempool->CheckPackageLimits({tx}, entry.GetTxSize());
726 }
727 CFeeRate estimateSmartFee(int num_blocks, bool conservative, FeeCalculation* calc) override
728 {
729 if (!m_node.fee_estimator) return {};
730 return m_node.fee_estimator->estimateSmartFee(num_blocks, calc, conservative);
731 }
732 unsigned int estimateMaxBlocks() override
733 {
734 if (!m_node.fee_estimator) return 0;
735 return m_node.fee_estimator->HighestTargetTracked(FeeEstimateHorizon::LONG_HALFLIFE);
736 }
737 CFeeRate mempoolMinFee() override
738 {
739 if (!m_node.mempool) return {};
740 return m_node.mempool->GetMinFee();
741 }
742 CFeeRate relayMinFee() override
743 {
744 if (!m_node.mempool) return CFeeRate{DEFAULT_MIN_RELAY_TX_FEE};
745 return m_node.mempool->m_opts.min_relay_feerate;
746 }
747 CFeeRate relayIncrementalFee() override
748 {
749 if (!m_node.mempool) return CFeeRate{DEFAULT_INCREMENTAL_RELAY_FEE};
750 return m_node.mempool->m_opts.incremental_relay_feerate;
751 }
752 CFeeRate relayDustFee() override
753 {
754 if (!m_node.mempool) return CFeeRate{DUST_RELAY_TX_FEE};
755 return m_node.mempool->m_opts.dust_relay_feerate;
756 }
757 bool havePruned() override
758 {
760 return chainman().m_blockman.m_have_pruned;
761 }
762 std::optional<int> getPruneHeight() override
763 {
764 LOCK(chainman().GetMutex());
765 return GetPruneHeight(chainman().m_blockman, chainman().ActiveChain());
766 }
767 bool isReadyToBroadcast() override { return !chainman().m_blockman.LoadingBlocks() && !isInitialBlockDownload(); }
768 bool isInitialBlockDownload() override
769 {
770 return chainman().IsInitialBlockDownload();
771 }
772 bool shutdownRequested() override { return ShutdownRequested(m_node); }
773 void initMessage(const std::string& message) override { ::uiInterface.InitMessage(message); }
774 void initWarning(const bilingual_str& message) override { InitWarning(message); }
775 void initError(const bilingual_str& message) override { InitError(message); }
776 void showProgress(const std::string& title, int progress, bool resume_possible) override
777 {
778 ::uiInterface.ShowProgress(title, progress, resume_possible);
779 }
780 std::unique_ptr<Handler> handleNotifications(std::shared_ptr<Notifications> notifications) override
781 {
782 return std::make_unique<NotificationsHandlerImpl>(validation_signals(), std::move(notifications));
783 }
784 void waitForNotificationsIfTipChanged(const uint256& old_tip) override
785 {
786 if (!old_tip.IsNull() && old_tip == WITH_LOCK(::cs_main, return chainman().ActiveChain().Tip()->GetBlockHash())) return;
787 validation_signals().SyncWithValidationInterfaceQueue();
788 }
789 std::unique_ptr<Handler> handleRpc(const CRPCCommand& command) override
790 {
791 return std::make_unique<RpcHandlerImpl>(command);
792 }
793 bool rpcEnableDeprecated(const std::string& method) override { return IsDeprecatedRPCEnabled(method); }
794 common::SettingsValue getSetting(const std::string& name) override
795 {
796 return args().GetSetting(name);
797 }
798 std::vector<common::SettingsValue> getSettingsList(const std::string& name) override
799 {
800 return args().GetSettingsList(name);
801 }
802 common::SettingsValue getRwSetting(const std::string& name) override
803 {
805 args().LockSettings([&](const common::Settings& settings) {
806 if (const common::SettingsValue* value = common::FindKey(settings.rw_settings, name)) {
807 result = *value;
808 }
809 });
810 return result;
811 }
812 bool updateRwSetting(const std::string& name,
813 const interfaces::SettingsUpdate& update_settings_func) override
814 {
815 std::optional<interfaces::SettingsAction> action;
816 args().LockSettings([&](common::Settings& settings) {
817 if (auto* value = common::FindKey(settings.rw_settings, name)) {
818 action = update_settings_func(*value);
819 if (value->isNull()) settings.rw_settings.erase(name);
820 } else {
821 UniValue new_value;
822 action = update_settings_func(new_value);
823 if (!new_value.isNull()) settings.rw_settings[name] = std::move(new_value);
824 }
825 });
826 if (!action) return false;
827 // Now dump value to disk if requested
829 }
830 bool overwriteRwSetting(const std::string& name, common::SettingsValue value, interfaces::SettingsAction action) override
831 {
832 return updateRwSetting(name, [&](common::SettingsValue& settings) {
833 settings = std::move(value);
834 return action;
835 });
836 }
837 bool deleteRwSettings(const std::string& name, interfaces::SettingsAction action) override
838 {
839 return overwriteRwSetting(name, {}, action);
840 }
841 void requestMempoolTransactions(Notifications& notifications) override
842 {
843 if (!m_node.mempool) return;
844 LOCK2(::cs_main, m_node.mempool->cs);
845 for (const CTxMemPoolEntry& entry : m_node.mempool->entryAll()) {
846 notifications.transactionAddedToMempool(entry.GetSharedTx());
847 }
848 }
849 bool hasAssumedValidChain() override
850 {
851 return chainman().IsSnapshotActive();
852 }
853
854 NodeContext* context() override { return &m_node; }
855 ArgsManager& args() { return *Assert(m_node.args); }
856 ChainstateManager& chainman() { return *Assert(m_node.chainman); }
857 ValidationSignals& validation_signals() { return *Assert(m_node.validation_signals); }
858 NodeContext& m_node;
859};
860
861class BlockTemplateImpl : public BlockTemplate
862{
863public:
864 explicit BlockTemplateImpl(BlockAssembler::Options assemble_options,
865 std::unique_ptr<CBlockTemplate> block_template,
866 NodeContext& node) : m_assemble_options(std::move(assemble_options)),
867 m_block_template(std::move(block_template)),
868 m_node(node)
869 {
871 }
872
873 CBlockHeader getBlockHeader() override
874 {
875 return m_block_template->block;
876 }
877
878 CBlock getBlock() override
879 {
880 return m_block_template->block;
881 }
882
883 std::vector<CAmount> getTxFees() override
884 {
885 return m_block_template->vTxFees;
886 }
887
888 std::vector<int64_t> getTxSigops() override
889 {
890 return m_block_template->vTxSigOpsCost;
891 }
892
893 CTransactionRef getCoinbaseTx() override
894 {
895 return m_block_template->block.vtx[0];
896 }
897
898 std::vector<unsigned char> getCoinbaseCommitment() override
899 {
900 return m_block_template->vchCoinbaseCommitment;
901 }
902
903 int getWitnessCommitmentIndex() override
904 {
906 }
907
908 std::vector<uint256> getCoinbaseMerklePath() override
909 {
910 return TransactionMerklePath(m_block_template->block, 0);
911 }
912
913 bool submitSolution(uint32_t version, uint32_t timestamp, uint32_t nonce, CTransactionRef coinbase) override
914 {
915 AddMerkleRootAndCoinbase(m_block_template->block, std::move(coinbase), version, timestamp, nonce);
916 return chainman().ProcessNewBlock(std::make_shared<const CBlock>(m_block_template->block), /*force_processing=*/true, /*min_pow_checked=*/true, /*new_block=*/nullptr);
917 }
918
919 std::unique_ptr<BlockTemplate> waitNext(BlockWaitOptions options) override
920 {
921 auto new_template = WaitAndCreateNewBlock(chainman(), notifications(), m_node.mempool.get(), m_block_template, options, m_assemble_options);
922 if (new_template) return std::make_unique<BlockTemplateImpl>(m_assemble_options, std::move(new_template), m_node);
923 return nullptr;
924 }
925
926 const BlockAssembler::Options m_assemble_options;
927
928 const std::unique_ptr<CBlockTemplate> m_block_template;
929
930 ChainstateManager& chainman() { return *Assert(m_node.chainman); }
931 KernelNotifications& notifications() { return *Assert(m_node.notifications); }
932 NodeContext& m_node;
933};
934
935class MinerImpl : public Mining
936{
937public:
938 explicit MinerImpl(NodeContext& node) : m_node(node) {}
939
940 bool isTestChain() override
941 {
942 return chainman().GetParams().IsTestChain();
943 }
944
945 bool isInitialBlockDownload() override
946 {
947 return chainman().IsInitialBlockDownload();
948 }
949
950 std::optional<BlockRef> getTip() override
951 {
952 return GetTip(chainman());
953 }
954
955 std::optional<BlockRef> waitTipChanged(uint256 current_tip, MillisecondsDouble timeout) override
956 {
957 return WaitTipChanged(chainman(), notifications(), current_tip, timeout);
958 }
959
960 std::unique_ptr<BlockTemplate> createNewBlock(const BlockCreateOptions& options) override
961 {
962 // Ensure m_tip_block is set so consumers of BlockTemplate can rely on that.
963 if (!waitTipChanged(uint256::ZERO, MillisecondsDouble::max())) return {};
964
965 BlockAssembler::Options assemble_options{options};
966 ApplyArgsManOptions(*Assert(m_node.args), assemble_options);
967 return std::make_unique<BlockTemplateImpl>(assemble_options, BlockAssembler{chainman().ActiveChainstate(), context()->mempool.get(), assemble_options}.CreateNewBlock(), m_node);
968 }
969
970 bool checkBlock(const CBlock& block, const node::BlockCheckOptions& options, std::string& reason, std::string& debug) override
971 {
972 LOCK(chainman().GetMutex());
973 BlockValidationState state{TestBlockValidity(chainman().ActiveChainstate(), block, /*check_pow=*/options.check_pow, /*=check_merkle_root=*/options.check_merkle_root)};
974 reason = state.GetRejectReason();
975 debug = state.GetDebugMessage();
976 return state.IsValid();
977 }
978
979 NodeContext* context() override { return &m_node; }
980 ChainstateManager& chainman() { return *Assert(m_node.chainman); }
981 KernelNotifications& notifications() { return *Assert(m_node.notifications); }
982 NodeContext& m_node;
983};
984} // namespace
985} // namespace node
986
987namespace interfaces {
988std::unique_ptr<Node> MakeNode(node::NodeContext& context) { return std::make_unique<node::NodeImpl>(context); }
989std::unique_ptr<Chain> MakeChain(node::NodeContext& context) { return std::make_unique<node::ChainImpl>(context); }
990std::unique_ptr<Mining> MakeMining(node::NodeContext& context) { return std::make_unique<node::MinerImpl>(context); }
991} // namespace interfaces
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
int flags
Definition: bitcoin-tx.cpp:529
int exit_status
const auto command
ArgsManager & args
Definition: bitcoind.cpp:277
Interrupt(node)
Shutdown(node)
std::optional< int > GetPruneHeight(const BlockManager &blockman, const CChain &chain)
Return height of highest block that has been pruned, or std::nullopt if no blocks have been pruned.
Definition: blockchain.cpp:855
BlockFilterType
Definition: blockfilter.h:93
BlockFilterIndex * GetBlockFilterIndex(BlockFilterType filter_type)
Get a block filter index by type.
CBlockLocator GetLocator(const CBlockIndex *index)
Get a locator for a block index entry.
Definition: chain.cpp:50
const CBlockIndex * LastCommonAncestor(const CBlockIndex *pa, const CBlockIndex *pb)
Find the last common ancestor two blocks have.
Definition: chain.cpp:160
@ BLOCK_HAVE_DATA
full block available in blk*.dat
Definition: chain.h:121
const CChainParams & Params()
Return the currently selected parameters.
#define Assert(val)
Identity function.
Definition: check.h:106
common::SettingsValue GetSetting(const std::string &arg) const
Get setting value.
Definition: args.cpp:834
void LockSettings(Fn &&fn)
Access settings with lock held.
Definition: args.h:409
bool WriteSettingsFile(std::vector< std::string > *errors=nullptr, bool backup=false) const
Write settings file or backup settings file.
Definition: args.cpp:425
std::vector< common::SettingsValue > GetSettingsList(const std::string &arg) const
Get list of setting values.
Definition: args.cpp:842
common::SettingsValue GetPersistentSetting(const std::string &name) const
Get current setting from config file or read/write settings file, ignoring nonpersistent command line...
Definition: args.cpp:445
std::string GetArg(const std::string &strArg, const std::string &strDefault) const
Return string argument or default value.
Definition: args.cpp:457
CategoryMask GetCategoryMask() const
Definition: logging.h:296
Complete block filter struct as defined in BIP 157.
Definition: blockfilter.h:115
const GCSFilter & GetFilter() const LIFETIMEBOUND
Definition: blockfilter.h:136
BlockFilterIndex is used to store and retrieve block filters, hashes, and headers for a range of bloc...
Nodes collect new transactions into a block, hash them into a hash tree, and scan through nonce value...
Definition: block.h:22
Definition: block.h:69
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition: chain.h:141
CBlockIndex * pprev
pointer to the index of the predecessor of this block
Definition: chain.h:147
uint256 GetBlockHash() const
Definition: chain.h:243
int64_t GetBlockTime() const
Definition: chain.h:266
int64_t GetMedianTimePast() const
Definition: chain.h:278
int64_t GetBlockTimeMax() const
Definition: chain.h:271
unsigned int nTx
Number of transactions in this block.
Definition: chain.h:170
CBlockIndex * GetAncestor(int height)
Efficiently find an ancestor of this block.
Definition: chain.cpp:115
int nHeight
height of the entry in the chain. The genesis block has height 0
Definition: chain.h:153
An in-memory indexed chain of blocks.
Definition: chain.h:417
CBlockIndex * FindEarliestAtLeast(int64_t nTime, int height) const
Find the earliest block with timestamp equal or greater than the given time and height equal or great...
Definition: chain.cpp:66
Fee rate in satoshis per virtualbyte: CAmount / vB the feerate is represented internally as FeeFrac.
Definition: feerate.h:35
Network address.
Definition: netaddress.h:112
An outpoint - a combination of a transaction hash and an index n into its vout.
Definition: transaction.h:29
std::string name
Definition: server.h:68
Actor actor
Definition: server.h:69
bool removeCommand(const std::string &name, const CRPCCommand *pcmd)
Definition: server.cpp:262
std::vector< std::string > listCommands() const
Returns a list of registered commands.
Definition: server.cpp:521
UniValue execute(const JSONRPCRequest &request) const
Execute a method.
Definition: server.cpp:484
void appendCommand(const std::string &name, const CRPCCommand *pcmd)
Appends a CRPCCommand to the dispatch table.
Definition: server.cpp:255
The basic transaction that is broadcasted on the network and contained in blocks.
Definition: transaction.h:296
CTxMemPoolEntry stores data about the corresponding transaction, as well as data about all in-mempool...
Definition: mempool_entry.h:66
Implement this to subscribe to events generated in validation and mempool.
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
Definition: validation.h:898
Enables interaction with an external signing device or service, such as a hardware wallet.
std::string m_name
Name of signer.
static bool Enumerate(const std::string &command, std::vector< ExternalSigner > &signers, const std::string chain)
Obtain a list of signers.
std::unordered_set< Element, ByteVectorHash > ElementSet
Definition: blockfilter.h:32
bool MatchAny(const ElementSet &elements) const
Checks if any of the given elements may be in the set.
UniValue params
Definition: request.h:57
std::string strMethod
Definition: request.h:56
std::string URI
Definition: request.h:59
std::any context
Definition: request.h:62
Definition: netbase.h:59
bool isNull() const
Definition: univalue.h:81
Int getInt() const
Definition: univalue.h:140
bool isNum() const
Definition: univalue.h:86
Wrapper around std::unique_lock style lock for MutexType.
Definition: sync.h:147
void RegisterSharedValidationInterface(std::shared_ptr< CValidationInterface > callbacks)
Register subscriber.
void UnregisterSharedValidationInterface(std::shared_ptr< CValidationInterface > callbacks)
Unregister subscriber.
std::string GetRejectReason() const
Definition: validation.h:109
constexpr bool IsNull() const
Definition: uint256.h:48
Block template interface.
Definition: mining.h:32
Interface giving clients (wallet processes, maybe other analysis tools in the future) ability to acce...
Definition: chain.h:130
External signer interface used by the GUI.
Definition: node.h:60
Helper for findBlock to selectively return pieces of block data.
Definition: chain.h:49
Generic interface for managing an event handler or callback function registered with another interfac...
Definition: handler.h:23
Interface giving clients (RPC, Stratum v2 Template Provider in the future) ability to create block te...
Definition: mining.h:80
Top-level interface for a bitcoin node (bitcoind process).
Definition: node.h:70
Wallet chain client that in addition to having chain client methods for starting up,...
Definition: wallet.h:316
Generate a new block, without valid proof-of-work.
Definition: miner.h:151
std::unique_ptr< CBlockTemplate > CreateNewBlock()
Construct a new block template.
Definition: miner.cpp:120
256-bit opaque blob.
Definition: uint256.h:196
static const uint256 ZERO
Definition: uint256.h:204
std::vector< uint256 > TransactionMerklePath(const CBlock &block, uint32_t position)
Compute merkle path to the specified transaction.
Definition: merkle.cpp:183
int GetWitnessCommitmentIndex(const CBlock &block)
Compute at which vout of the block's coinbase transaction the witness commitment occurs,...
Definition: validation.h:147
RecursiveMutex cs_main
Mutex to guard access to validation specific variables, such as reading or changing the chainstate.
Definition: cs_main.cpp:8
static CService ip(uint32_t i)
void InitLogging(const ArgsManager &args)
Initialize global loggers.
Definition: init.cpp:828
bool AppInitBasicSetup(const ArgsManager &args, std::atomic< int > &exit_status)
Initialize bitcoin core: Basic context setup.
Definition: init.cpp:857
bool ShutdownRequested(node::NodeContext &node)
Return whether node shutdown was requested.
Definition: init.cpp:247
bool AppInitParameterInteraction(const ArgsManager &args)
Initialization: parameter interaction.
Definition: init.cpp:894
bool AppInitInterfaces(NodeContext &node)
Initialize node and wallet interface pointers.
Definition: init.cpp:1180
void InitParameterInteraction(ArgsManager &args)
Parameter interaction: change current parameters depending on various rules.
Definition: init.cpp:739
bool AppInitMain(NodeContext &node, interfaces::BlockAndHeaderTipInfo *tip_info)
Bitcoin core main initialization.
Definition: init.cpp:1361
bool AppInitLockDirectories()
Lock bitcoin core critical directories.
Definition: init.cpp:1168
bool AppInitSanityChecks(const kernel::Context &kernel)
Initialization sanity checks.
Definition: init.cpp:1149
CClientUIInterface uiInterface
void InitWarning(const bilingual_str &str)
Show warning message.
bool InitError(const bilingual_str &str)
Show error message.
ChainstateRole
This enum describes the various roles a specific Chainstate instance can take.
Definition: chain.h:25
BCLog::Logger & LogInstance()
Definition: logging.cpp:26
#define LogError(...)
Definition: logging.h:358
void StartMapPort(bool enable)
Definition: mapport.cpp:137
LockPoints lp
MemPoolRemovalReason
Reason why a transaction was removed from the mempool, this is passed to the notification signal.
unsigned int nonce
Definition: miner_tests.cpp:76
uint64_t CategoryMask
Definition: logging.h:63
auto FindKey(Map &&map, Key &&key) -> decltype(&map.at(key))
Map lookup helper.
Definition: settings.h:107
std::unique_ptr< Node > MakeNode(node::NodeContext &context)
Return implementation of Node interface.
Definition: interfaces.cpp:988
std::unique_ptr< Mining > MakeMining(node::NodeContext &node)
Return implementation of Mining interface.
Definition: interfaces.cpp:990
std::unique_ptr< Handler > MakeSignalHandler(boost::signals2::connection connection)
Return handler wrapping a boost signal connection.
Definition: interfaces.cpp:47
SettingsAction
The action to be taken after updating a settings value.
Definition: chain.h:98
std::unique_ptr< Chain > MakeChain(node::NodeContext &node)
Return implementation of Chain interface.
Definition: interfaces.cpp:989
std::function< std::optional< interfaces::SettingsAction >(common::SettingsValue &)> SettingsUpdate
Definition: chain.h:103
interfaces::BlockInfo MakeBlockInfo(const CBlockIndex *index, const CBlock *data)
Return data from block index.
Definition: chain.cpp:14
Definition: messages.h:20
void FindCoins(const NodeContext &node, std::map< COutPoint, Coin > &coins)
Look up unspent output information.
Definition: coin.cpp:12
TransactionError
Definition: types.h:24
TransactionError BroadcastTransaction(NodeContext &node, const CTransactionRef tx, std::string &err_string, const CAmount &max_tx_fee, bool relay, bool wait_callback)
Submit a transaction to the mempool and (optionally) relay it to all P2P peers.
Definition: transaction.cpp:34
util::Result< void > ApplyArgsManOptions(const ArgsManager &args, BlockManager::Options &opts)
std::optional< BlockRef > WaitTipChanged(ChainstateManager &chainman, KernelNotifications &kernel_notifications, const uint256 &current_tip, MillisecondsDouble &timeout)
Definition: miner.cpp:553
std::unique_ptr< CBlockTemplate > WaitAndCreateNewBlock(ChainstateManager &chainman, KernelNotifications &kernel_notifications, CTxMemPool *mempool, const std::unique_ptr< CBlockTemplate > &block_template, const BlockWaitOptions &options, const BlockAssembler::Options &assemble_options)
Return a new block template when fees rise to a certain threshold or after a new tip; return nullopt ...
Definition: miner.cpp:456
void AddMerkleRootAndCoinbase(CBlock &block, CTransactionRef coinbase, uint32_t version, uint32_t timestamp, uint32_t nonce)
Definition: miner.cpp:443
std::optional< BlockRef > GetTip(ChainstateManager &chainman)
Definition: miner.cpp:545
auto Join(const C &container, const S &separator, UnaryOp unary_op)
Join all container items.
Definition: string.h:204
int64_t NodeId
Definition: net.h:98
std::map< CSubNet, CBanEntry > banmap_t
Definition: net_types.h:41
Network
A network type.
Definition: netaddress.h:32
bool GetProxy(enum Network net, Proxy &proxyInfoOut)
Definition: netbase.cpp:713
ConnectionDirection
Definition: netbase.h:33
ValidationSignals & m_signals
Definition: interfaces.cpp:499
::ExternalSigner m_signer
Definition: interfaces.cpp:98
const BlockAssembler::Options m_assemble_options
Definition: interfaces.cpp:926
NodeContext & m_node
Definition: interfaces.cpp:858
NodeContext * m_context
Definition: interfaces.cpp:428
std::shared_ptr< Chain::Notifications > m_notifications
Definition: interfaces.cpp:480
CRPCCommand m_command
Definition: interfaces.cpp:538
const CRPCCommand * m_wrapped_command
Definition: interfaces.cpp:539
const std::unique_ptr< CBlockTemplate > m_block_template
Definition: interfaces.cpp:928
std::shared_ptr< NotificationsProxy > m_proxy
Definition: interfaces.cpp:500
is a home for public enum and struct type definitions that are used internally by node code,...
RBFTransactionState IsRBFOptInEmptyMempool(const CTransaction &tx)
Definition: rbf.cpp:53
RBFTransactionState IsRBFOptIn(const CTransaction &tx, const CTxMemPool &pool)
Determine whether an unconfirmed transaction is signaling opt-in to RBF according to BIP 125 This inv...
Definition: rbf.cpp:24
RBFTransactionState
The rbf state of unconfirmed transactions.
Definition: rbf.h:29
static constexpr unsigned int DEFAULT_INCREMENTAL_RELAY_FEE
Default for -incrementalrelayfee, which sets the minimum feerate increase for mempool limiting or rep...
Definition: policy.h:44
static constexpr unsigned int DUST_RELAY_TX_FEE
Min feerate for defining dust.
Definition: policy.h:64
static constexpr unsigned int DEFAULT_MIN_RELAY_TX_FEE
Default for -minrelaytxfee, minimum relay fee for transactions.
Definition: policy.h:66
std::shared_ptr< const CTransaction > CTransactionRef
Definition: transaction.h:423
const char * name
Definition: rest.cpp:50
@ RPC_WALLET_NOT_FOUND
Invalid wallet specified.
Definition: protocol.h:80
bool IsDeprecatedRPCEnabled(const std::string &method)
Definition: server.cpp:341
void StopRPC()
Definition: server.cpp:292
void InterruptRPC()
Definition: server.cpp:281
CRPCTable tableRPC
Definition: server.cpp:546
Describes a place in the block chain to another node such that if the other node doesn't have the sam...
Definition: block.h:124
const CTransactionRef m_tx
Bilingual messages:
Definition: translation.h:24
Stored settings.
Definition: settings.h:32
std::map< std::string, SettingsValue > rw_settings
Map of setting name to read-write file setting value.
Definition: settings.h:38
std::map< std::string, std::vector< SettingsValue > > command_line_options
Map of setting name to list of command line values.
Definition: settings.h:36
Block and header tip information.
Definition: node.h:50
Hash/height pair to help track and identify blocks.
Definition: types.h:13
Block tip (could be a header or not, depends on the subscribed signal).
Definition: node.h:276
Options struct containing limit options for a CTxMemPool.
bool check_pow
Set false to omit the proof-of-work check.
Definition: types.h:98
bool check_merkle_root
Set false to omit the merkle root check.
Definition: types.h:93
NodeContext struct containing references to chain state and connection state.
Definition: context.h:56
Definition: musig.c:31
#define WAIT_LOCK(cs, name)
Definition: sync.h:265
#define LOCK2(cs1, cs2)
Definition: sync.h:260
#define REVERSE_LOCK(g, cs)
Definition: sync.h:245
#define LOCK(cs)
Definition: sync.h:259
#define WITH_LOCK(cs, code)
Run code while locking a mutex.
Definition: sync.h:290
#define TRY_LOCK(cs, name)
Definition: sync.h:264
#define EXCLUSIVE_LOCKS_REQUIRED(...)
Definition: threadsafety.h:51
bilingual_str Untranslated(std::string original)
Mark a bilingual_str as untranslated.
Definition: translation.h:82
std::chrono::duration< double, std::chrono::milliseconds::period > MillisecondsDouble
Definition: time.h:88
BlockValidationState TestBlockValidity(Chainstate &chainstate, const CBlock &block, const bool check_pow, const bool check_merkle_root)
Verify a block, including transactions.
assert(!tx.IsCoinBase())
SynchronizationState
Current sync state passed to tip changed callbacks.
Definition: validation.h:88
TipBlock getTip(const CChainParams &params, const node::NodeContext &context)