|
void | BlockConnected (const std::shared_ptr< const CBlock > &block, const CBlockIndex *pindex) override |
| Notifies listeners of a block being connected. More...
|
|
void | ChainStateFlushed (const CBlockLocator &locator) override |
| Notifies listeners of the new active block chain on-disk. More...
|
|
const CBlockIndex * | CurrentIndex () |
|
virtual bool | Init () |
| Initialize internal state from the database and block index. More...
|
|
virtual bool | WriteBlock (const CBlock &block, const CBlockIndex *pindex) |
| Write update index entries for a newly connected block. More...
|
|
virtual bool | CommitInternal (CDBBatch &batch) |
| Virtual method called internally by Commit that can be overridden to atomically commit more index state. More...
|
|
virtual bool | Rewind (const CBlockIndex *current_tip, const CBlockIndex *new_tip) |
| Rewind index to an earlier chain tip during a chain reorg. More...
|
|
virtual DB & | GetDB () const =0 |
|
virtual const char * | GetName () const =0 |
| Get the name of the index for display in logs. More...
|
|
void | SetBestBlockIndex (const CBlockIndex *block) |
| Update the internal best block index as well as the prune lock. More...
|
|
| ~CValidationInterface ()=default |
| Protected destructor so that instances can only be deleted by derived classes. More...
|
|
virtual void | UpdatedBlockTip (const CBlockIndex *pindexNew, const CBlockIndex *pindexFork, bool fInitialDownload) |
| Notifies listeners when the block chain tip advances. More...
|
|
virtual void | TransactionAddedToMempool (const CTransactionRef &tx, std::shared_ptr< const std::vector< Coin > > spent_coins, uint64_t mempool_sequence) |
| Notifies listeners of a transaction having been added to mempool. More...
|
|
virtual void | TransactionRemovedFromMempool (const CTransactionRef &tx, MemPoolRemovalReason reason, uint64_t mempool_sequence) |
| Notifies listeners of a transaction leaving mempool. More...
|
|
virtual void | BlockConnected (const std::shared_ptr< const CBlock > &block, const CBlockIndex *pindex) |
| Notifies listeners of a block being connected. More...
|
|
virtual void | BlockDisconnected (const std::shared_ptr< const CBlock > &block, const CBlockIndex *pindex) |
| Notifies listeners of a block being disconnected. More...
|
|
virtual void | ChainStateFlushed (const CBlockLocator &locator) |
| Notifies listeners of the new active block chain on-disk. More...
|
|
virtual void | BlockChecked (const CBlock &, const BlockValidationState &) |
| Notifies listeners of a block validation result. More...
|
|
virtual void | NewPoWValidBlock (const CBlockIndex *pindex, const std::shared_ptr< const CBlock > &block) |
| 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. More...
|
|
virtual void | BlockFinalized (const CBlockIndex *pindex) |
|
virtual void | BlockInvalidated (const CBlockIndex *pindex, const std::shared_ptr< const CBlock > &block) |
|
Base class for indices of blockchain data.
This implements CValidationInterface and ensures blocks are indexed sequentially according to their position in the active chain.
Definition at line 27 of file base.h.
void BaseIndex::ChainStateFlushed |
( |
const CBlockLocator & |
locator | ) |
|
|
overrideprotectedvirtual |
Notifies listeners of the new active block chain on-disk.
Prior to this callback, any updates are not guaranteed to persist on disk (ie clients need to handle shutdown/restart safety by being able to understand when some updates were lost due to unclean shutdown).
When this callback is invoked, the validation changes done by any prior callback are guaranteed to exist on disk and survive a restart, including an unclean shutdown.
Provides a locator describing the best chain, which is likely useful for storing current state on disk in client DBs.
Called on a background thread.
Reimplemented from CValidationInterface.
Definition at line 308 of file base.cpp.
bool BaseIndex::Commit |
( |
| ) |
|
|
private |
Write the current index state (eg.
chain block locator and subclass-specific items) to disk.
Recommendations for error handling: If called on a successor of the previous committed best block in the index, the index can continue processing without risk of corruption, though the index state will need to catch up from further behind on reboot. If the new state is not a successor of the previous state (due to a chain reorganization), the index must halt until Commit succeeds or else it could end up getting corrupted.
Definition at line 217 of file base.cpp.
void BaseIndex::Interrupt |
( |
| ) |
|
Blocks the current thread until the index is caught up to the current state of the block chain.
This only blocks if the index has gotten in sync once and only needs to process blocks in the ValidationInterface queue. If the index is catching up from far behind, this method does not block and immediately returns false.
Definition at line 374 of file base.cpp.
void BaseIndex::ThreadSync |
( |
| ) |
|
|
private |
Sync the index with the block index starting from the current best block.
Intended to be run in its own thread, m_thread_sync, and can be interrupted with m_interrupt. Once the index gets in sync, the m_synced flag is set and the BlockConnected ValidationInterface callback takes over and the sync thread exits.
Definition at line 144 of file base.cpp.