Struct BlockchainService 

pub struct BlockchainService { /* private fields */ }

Blockchain validation and acceptance service

Orchestrates block validation, chain updates, UTXO set management, and consensus enforcement.

Implementations

impl BlockchainService

pub fn new( block_store: Arc<dyn BlockStore>, chain_state: Arc<dyn ChainStateStore>, peer_manager: Arc<dyn PeerManager>, ) -> Self

Create a new blockchain service

pub fn with_params( block_store: Arc<dyn BlockStore>, chain_state: Arc<dyn ChainStateStore>, peer_manager: Arc<dyn PeerManager>, consensus_params: ConsensusParams, ) -> Self

Create a new blockchain service with explicit consensus parameters.

pub async fn validate_and_accept_block( &self, block: &Block, ) -> Result<(), String>

Validate and accept a block into the blockchain

This performs:

1. Duplicate block check
2. Merkle root verification
3. Consensus rule validation (block structure, transaction validity)
4. UTXO set update (remove spent, add new outputs)
5. Chain tip update
6. Broadcast to peers

pub async fn process_new_transaction( &self, tx: &Transaction, ) -> Result<(), String>

Process a new transaction (validate and prepare for mempool)

Performs:

1. Basic consensus validation (structure, sizes, amounts)
2. Double-spend check against UTXO set
3. Input value verification (all inputs exist in UTXO set)

pub async fn get_chain_info(&self) -> Result<ChainInfo, String>

Get current chain information

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

Get a block by hash