mirror of
https://github.com/kvazar-network/kevacoin.git
synced 2025-01-09 14:47:55 +00:00
3192975f1d
Note that the CScheduler thread cant be running at this point, it has already been stopped with the rest of the init threadgroup. Thus, just calling any remaining loose callbacks during Shutdown() is sane.
100 lines
4.4 KiB
C++
100 lines
4.4 KiB
C++
// Copyright (c) 2009-2010 Satoshi Nakamoto
|
|
// Copyright (c) 2009-2016 The Bitcoin Core developers
|
|
// Distributed under the MIT software license, see the accompanying
|
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
|
|
|
#ifndef BITCOIN_VALIDATIONINTERFACE_H
|
|
#define BITCOIN_VALIDATIONINTERFACE_H
|
|
|
|
#include <memory>
|
|
|
|
#include "primitives/transaction.h" // CTransaction(Ref)
|
|
|
|
class CBlock;
|
|
class CBlockIndex;
|
|
struct CBlockLocator;
|
|
class CBlockIndex;
|
|
class CConnman;
|
|
class CReserveScript;
|
|
class CValidationInterface;
|
|
class CValidationState;
|
|
class uint256;
|
|
class CScheduler;
|
|
|
|
// These functions dispatch to one or all registered wallets
|
|
|
|
/** Register a wallet to receive updates from core */
|
|
void RegisterValidationInterface(CValidationInterface* pwalletIn);
|
|
/** Unregister a wallet from core */
|
|
void UnregisterValidationInterface(CValidationInterface* pwalletIn);
|
|
/** Unregister all wallets from core */
|
|
void UnregisterAllValidationInterfaces();
|
|
|
|
class CValidationInterface {
|
|
protected:
|
|
/** Notifies listeners of updated block chain tip */
|
|
virtual void UpdatedBlockTip(const CBlockIndex *pindexNew, const CBlockIndex *pindexFork, bool fInitialDownload) {}
|
|
/** Notifies listeners of a transaction having been added to mempool. */
|
|
virtual void TransactionAddedToMempool(const CTransactionRef &ptxn) {}
|
|
/**
|
|
* Notifies listeners of a block being connected.
|
|
* Provides a vector of transactions evicted from the mempool as a result.
|
|
*/
|
|
virtual void BlockConnected(const std::shared_ptr<const CBlock> &block, const CBlockIndex *pindex, const std::vector<CTransactionRef> &txnConflicted) {}
|
|
/** Notifies listeners of a block being disconnected */
|
|
virtual void BlockDisconnected(const std::shared_ptr<const CBlock> &block) {}
|
|
/** Notifies listeners of the new active block chain on-disk. */
|
|
virtual void SetBestChain(const CBlockLocator &locator) {}
|
|
/** Notifies listeners about an inventory item being seen on the network. */
|
|
virtual void Inventory(const uint256 &hash) {}
|
|
/** Tells listeners to broadcast their data. */
|
|
virtual void ResendWalletTransactions(int64_t nBestBlockTime, CConnman* connman) {}
|
|
/**
|
|
* Notifies listeners of a block validation result.
|
|
* If the provided CValidationState IsValid, the provided block
|
|
* is guaranteed to be the current best block at the time the
|
|
* callback was generated (not necessarily now)
|
|
*/
|
|
virtual void BlockChecked(const CBlock&, const CValidationState&) {}
|
|
/**
|
|
* Notifies listeners that a block which builds directly on our current tip
|
|
* has been received and connected to the headers tree, though not validated yet */
|
|
virtual void NewPoWValidBlock(const CBlockIndex *pindex, const std::shared_ptr<const CBlock>& block) {};
|
|
friend void ::RegisterValidationInterface(CValidationInterface*);
|
|
friend void ::UnregisterValidationInterface(CValidationInterface*);
|
|
friend void ::UnregisterAllValidationInterfaces();
|
|
};
|
|
|
|
struct MainSignalsInstance;
|
|
class CMainSignals {
|
|
private:
|
|
std::unique_ptr<MainSignalsInstance> m_internals;
|
|
|
|
friend void ::RegisterValidationInterface(CValidationInterface*);
|
|
friend void ::UnregisterValidationInterface(CValidationInterface*);
|
|
friend void ::UnregisterAllValidationInterfaces();
|
|
|
|
public:
|
|
/** Register a CScheduler to give callbacks which should run in the background (may only be called once) */
|
|
void RegisterBackgroundSignalScheduler(CScheduler& scheduler);
|
|
/** Unregister a CScheduler to give callbacks which should run in the background - these callbacks will now be dropped! */
|
|
void UnregisterBackgroundSignalScheduler();
|
|
/** Call any remaining callbacks on the calling thread */
|
|
void FlushBackgroundCallbacks();
|
|
|
|
void UpdatedBlockTip(const CBlockIndex *, const CBlockIndex *, bool fInitialDownload);
|
|
void TransactionAddedToMempool(const CTransactionRef &);
|
|
void BlockConnected(const std::shared_ptr<const CBlock> &, const CBlockIndex *pindex, const std::vector<CTransactionRef> &);
|
|
void BlockDisconnected(const std::shared_ptr<const CBlock> &);
|
|
void UpdatedTransaction(const uint256 &);
|
|
void SetBestChain(const CBlockLocator &);
|
|
void Inventory(const uint256 &);
|
|
void Broadcast(int64_t nBestBlockTime, CConnman* connman);
|
|
void BlockChecked(const CBlock&, const CValidationState&);
|
|
void NewPoWValidBlock(const CBlockIndex *, const std::shared_ptr<const CBlock>&);
|
|
};
|
|
|
|
CMainSignals& GetMainSignals();
|
|
|
|
#endif // BITCOIN_VALIDATIONINTERFACE_H
|