Struct ChainState 

pub struct ChainState { /* private fields */ }

The chain state manager.

Owns the block index (header tree), UTXO set, and the undo data needed to disconnect blocks during a reorg.

Implementations

impl ChainState

pub fn new( genesis: Block, params: ConsensusParams, ) -> Result<Self, ChainStateError>

Create a new chain state, initialised with a genesis block.

The genesis block is connected immediately (its coinbase outputs are added to the UTXO set).

pub fn set_verify_scripts(&mut self, verify: bool)

Enable or disable script verification (useful for fast-sync / IBD).

pub fn process_block( &mut self, block: Block, ) -> Result<ProcessBlockResult, ChainStateError>

Process a new block. This is the main entry point.

Determines whether the block extends the tip, causes a reorg, or sits on a side chain, and acts accordingly.

pub fn tip(&self) -> BlockHash

Current active chain tip hash.

pub fn tip_height(&self) -> u32

Current active chain tip height.

pub fn index(&self) -> &BlockIndex

Reference to the block index.

pub fn index_mut(&mut self) -> &mut BlockIndex

Mutable reference to the block index.

pub fn utxo_set(&self) -> &MemoryUtxoSet

Reference to the UTXO set.

pub fn get_block(&self, hash: &BlockHash) -> Option<&Block>

Get a stored block by hash.

pub fn params(&self) -> &ConsensusParams

Get the consensus parameters.

pub fn block_count(&self) -> usize

Number of blocks in the block store.

pub fn utxo_count(&self) -> usize

Number of UTXOs in the active set.

pub fn has_utxo(&self, outpoint: &OutPoint) -> bool

Check if a specific UTXO exists in the active set.

pub fn get_block_hash_at_height(&self, height: u32) -> Option<BlockHash>

Get the block hash at a given height on the active chain.

pub async fn flush_to_store( &self, store: &dyn ChainStateStore, ) -> Result<(), Box<dyn Error + Send + Sync>>

Flush the current UTXO set and chain tip to persistent storage.

This writes a full snapshot of all UTXOs created/spent since the last flush, plus the chain tip. Call this after connecting a batch of blocks (e.g. at the end of IBD or periodically during normal operation).

pub async fn flush_block_delta( &self, result: &BlockConnectResult, store: &dyn ChainStateStore, ) -> Result<(), Box<dyn Error + Send + Sync>>

Flush only the UTXO changes from a single block connect/disconnect.

More efficient than a full flush — writes only the delta.

pub async fn load_tip_from_store( store: &dyn ChainStateStore, ) -> Result<Option<(BlockHash, u32)>, Box<dyn Error + Send + Sync>>

Load chain tip from a persistent store and verify consistency.

Returns the stored (tip_hash, tip_height), or None if the store is empty.