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