org.bitcoinj.core.listeners

Interface NewBestBlockListener

All Known Implementing Classes:

NativeBlockChainListener, Wallet

public interface NewBestBlockListener

Listener interface for when a new block on the best chain is seen.

Method Summary

Modifier and Type

Method and Description

void

notifyNewBestBlock(StoredBlock block) Called when a new block on the best chain is seen, after relevant transactions are extracted and sent to us via either TransactionReceivedInBlockListener.receiveFromBlock(Transaction, StoredBlock, AbstractBlockChain.NewBlockType, int) or TransactionReceivedInBlockListener.notifyTransactionIsInBlock(Sha256Hash, StoredBlock, AbstractBlockChain.NewBlockType, int).

Method Detail

notifyNewBestBlock

void notifyNewBestBlock(StoredBlock block)
                 throws VerificationException

Called when a new block on the best chain is seen, after relevant transactions are extracted and sent to us via either TransactionReceivedInBlockListener.receiveFromBlock(Transaction, StoredBlock, AbstractBlockChain.NewBlockType, int) or TransactionReceivedInBlockListener.notifyTransactionIsInBlock(Sha256Hash, StoredBlock, AbstractBlockChain.NewBlockType, int). If this block is causing a re-organise to a new chain, this method is NOT called even though the block may be the new best block: your reorganize implementation is expected to do whatever would normally be done do for a new best block in this case.

Throws:

VerificationException