Bitcoin Core 28.99.0
P2P Digital Currency
notifications_interface.h
Go to the documentation of this file.
1// Copyright (c) 2023 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#ifndef BITCOIN_KERNEL_NOTIFICATIONS_INTERFACE_H
6#define BITCOIN_KERNEL_NOTIFICATIONS_INTERFACE_H
7
8#include <cstdint>
9#include <variant>
10
11class CBlockIndex;
12enum class SynchronizationState;
13struct bilingual_str;
14
15namespace kernel {
16
18struct Interrupted{};
19enum class Warning;
20
21
23using InterruptResult = std::variant<std::monostate, Interrupted>;
24
25template <typename T>
26bool IsInterrupted(const T& result)
27{
28 return std::holds_alternative<kernel::Interrupted>(result);
29}
30
36{
37public:
38 virtual ~Notifications() = default;
39
40 [[nodiscard]] virtual InterruptResult blockTip(SynchronizationState state, CBlockIndex& index) { return {}; }
41 virtual void headerTip(SynchronizationState state, int64_t height, int64_t timestamp, bool presync) {}
42 virtual void progress(const bilingual_str& title, int progress_percent, bool resume_possible) {}
43 virtual void warningSet(Warning id, const bilingual_str& message) {}
44 virtual void warningUnset(Warning id) {}
45
52 virtual void flushError(const bilingual_str& message) {}
53
61 virtual void fatalError(const bilingual_str& message) {}
62};
63} // namespace kernel
64
65#endif // BITCOIN_KERNEL_NOTIFICATIONS_INTERFACE_H
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition: chain.h:141
A base class defining functions for notifying about certain kernel events.
virtual void headerTip(SynchronizationState state, int64_t height, int64_t timestamp, bool presync)
virtual ~Notifications()=default
virtual void fatalError(const bilingual_str &message)
The fatal error notification is sent to notify the user when an error occurs in kernel code that can'...
virtual void warningSet(Warning id, const bilingual_str &message)
virtual void progress(const bilingual_str &title, int progress_percent, bool resume_possible)
virtual void flushError(const bilingual_str &message)
The flush error notification is sent to notify the user that an error occurred while flushing block d...
virtual InterruptResult blockTip(SynchronizationState state, CBlockIndex &index)
virtual void warningUnset(Warning id)
std::variant< std::monostate, Interrupted > InterruptResult
Simple result type for functions that need to propagate an interrupt status and don't have other retu...
bool IsInterrupted(const T &result)
Warning
Definition: warning.h:9
Bilingual messages:
Definition: translation.h:21
Result type for use with std::variant to indicate that an operation should be interrupted.
SynchronizationState
Current sync state passed to tip changed callbacks.
Definition: validation.h:85