Struct bitcoin_net_zmq::ZMQNotificationInterface

pub struct ZMQNotificationInterface { /* private fields */ }

Implementations

impl ZMQNotificationInterface

pub fn get_active_notifiers(&self) -> LinkedList<*const ZMQAbstractNotifier>

pub fn create(&mut self) -> *mut ZMQNotificationInterface

Trait Implementations

impl BlockChecked for ZMQNotificationInterface

fn block_checked(self: Arc<Self>, _0: &Block, _1: &BlockValidationState)

| Notifies listeners of a block validation | result. | | If the provided BlockValidationState | IsValid, the provided block is guaranteed | to be the current best block at the time | the callback was generated (not necessarily | now) |

impl BlockConnected for ZMQNotificationInterface

fn block_connected( &mut self, pblock: Arc<Block>, pindex_connected: Arc<BlockIndex> )

| Notifies listeners of a block being | connected. | | Provides a vector of transactions evicted | from the mempool as a result. | | Called on a background thread. |

impl BlockDisconnected for ZMQNotificationInterface

fn block_disconnected( &mut self, pblock: Arc<Block>, pindex_disconnected: Arc<BlockIndex> )

| Notifies listeners of a block being | disconnected | | Called on a background thread. |

impl ChainStateFlushed for ZMQNotificationInterface

fn chain_state_flushed(&mut self, locator: &BlockLocator)

| 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. |

impl Default for ZMQNotificationInterface

fn default() -> Self

Returns the “default value” for a type.

impl Drop for ZMQNotificationInterface

fn drop(&mut self)

Executes the destructor for this type.

impl Initialize for ZMQNotificationInterface

fn initialize(&mut self, pcontext: *mut c_void) -> bool

| Called at startup to conditionally | set up ZMQ socket(s) |

impl NewPoWValidBlock for ZMQNotificationInterface

fn new_pow_valid_block(&mut self, pindex: Arc<BlockIndex>, block: &Arc<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 |

impl Shutdown for ZMQNotificationInterface

fn shutdown(&mut self)

| Called during shutdown sequence |

impl TransactionAddedToMempool for ZMQNotificationInterface

fn transaction_added_to_mempool( &mut self, ptx: &TransactionRef, mempool_sequence: u64 )

| Notifies listeners of a transaction | having been added to mempool. | | Called on a background thread. |

impl TransactionRemovedFromMempool for ZMQNotificationInterface

fn transaction_removed_from_mempool( &mut self, ptx: &TransactionRef, reason: MemPoolRemovalReason, mempool_sequence: u64 )

| Notifies listeners of a transaction | leaving mempool. | | This notification fires for transactions | that are removed from the mempool for | the following reasons: | | - EXPIRY (expired from mempool after | -mempoolexpiry hours) | | - SIZELIMIT (removed in size limiting | if the mempool exceeds -maxmempool | megabytes) | | - REORG (removed during a reorg) | | - CONFLICT (removed because it conflicts | with in-block transaction) | | - REPLACED (removed due to RBF replacement) | | This does not fire for transactions | that are removed from the mempool because | they have been included in a block. Any | client that is interested in transactions | removed from the mempool for inclusion | in a block can learn about those transactions | from the BlockConnected notification. | | Transactions that are removed from | the mempool because they conflict with | a transaction in the new block will have | | TransactionRemovedFromMempool events | fired before the BlockConnected | event is fired. If multiple blocks are | connected in one step, then the ordering | could be: | | - TransactionRemovedFromMempool(tx1 | from block A) | | - TransactionRemovedFromMempool(tx2 | from block A) | | - TransactionRemovedFromMempool(tx1 | from block B) | | - TransactionRemovedFromMempool(tx2 | from block B) | | - BlockConnected(A) | | - BlockConnected(B) | | Called on a background thread. |

impl UpdatedBlockTip for ZMQNotificationInterface

fn updated_block_tip( &mut self, pindex_new: Option<Arc<BlockIndex>>, pindex_fork: Option<Arc<BlockIndex>>, initial_download: bool )

| Notifies listeners when the block chain | tip advances. | | When multiple blocks are connected | at once, UpdatedBlockTip will be called | on the final tip but may not be called | on every intermediate tip. If the latter | behavior is desired, subscribe to BlockConnected() | instead. | | Called on a background thread. |

impl ValidationInterface for ZMQNotificationInterface