Package com.privatechain.spring

Class BlockchainAutoConfiguration

java.lang.Object

com.privatechain.spring.BlockchainAutoConfiguration

@AutoConfiguration
@EnableConfigurationProperties(BlockchainProperties.class)
@ConditionalOnProperty(prefix="blockchain",
                       name="enabled",
                       havingValue="true",
                       matchIfMissing=true)
public class BlockchainAutoConfiguration
extends Object

Spring Boot autoconfiguration for the private-blockchain library.

This class is the single assembly point for all blockchain Spring beans, mirroring the non-Spring assembly model in BlockchainConfig but adapting it to dependency injection (FR-CFG-01, FR-CFG-03).

Activation

Active by default. Disable completely with:

 blockchain:
   enabled: false
 

Zero-configuration start (AC-10)

No blockchain.* properties required. Defaults: ProofOfWorkEngine (difficulty 4) + InMemoryStorage.

Override points (T-072)

Every bean is guarded by @ConditionalOnMissingBean. Provide any of the following in your @Configuration to replace the default:

• BlockchainNode — replaces the entire node
• ConsensusEngine — replaces ProofOfWorkEngine
• BlockchainStorage — replaces InMemoryStorage
• BlockchainHealthIndicator — replaces the status bean

Multiple validators and listeners

All TransactionValidator and BlockchainEventListener beans are discovered and registered automatically in declaration order.

Node lifecycle

The BlockchainNode bean uses initMethod = "start" and destroyMethod = "stop". Spring calls start() after all beans are wired and stop() on context close.

Actuator integration

BlockchainHealthIndicator is a plain status-provider bean with no compile-time dependency on spring-boot-actuator. To wire it into the Actuator health endpoint, add this to your @Configuration:

 @Bean
 HealthIndicator blockchainHealth(BlockchainHealthIndicator indicator) {
     return () -> indicator.isUp()
         ? Health.up().withDetails(indicator.getDetails()).build()
         : Health.down().withDetails(indicator.getDetails()).build();
 }
 

Since:

1.0.0

See Also:

• BlockchainProperties
• BlockchainHealthIndicator

Constructor Summary

Constructors

Constructor	Description
BlockchainAutoConfiguration()

Method Summary

Modifier and Type	Method	Description
BlockchainHealthIndicator	blockchainHealthIndicator(BlockchainNode node)	Creates the BlockchainHealthIndicator status bean.
BlockchainNode	blockchainNode(BlockchainProperties properties, org.springframework.beans.factory.ObjectProvider<ConsensusEngine> engineProvider, org.springframework.beans.factory.ObjectProvider<BlockchainStorage> storageProvider, org.springframework.beans.factory.ObjectProvider<TransactionValidator> validatorProvider, org.springframework.beans.factory.ObjectProvider<BlockchainEventListener> listenerProvider)	Creates and wires the BlockchainNode bean from bound properties and any user-provided override beans (T-070, T-072).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

BlockchainAutoConfiguration

public BlockchainAutoConfiguration()

Method Details

blockchainNode

@Bean(initMethod="start",
      destroyMethod="stop")
@ConditionalOnMissingBean
public BlockchainNode blockchainNode(BlockchainProperties properties,
 org.springframework.beans.factory.ObjectProvider<ConsensusEngine> engineProvider,
 org.springframework.beans.factory.ObjectProvider<BlockchainStorage> storageProvider,
 org.springframework.beans.factory.ObjectProvider<TransactionValidator> validatorProvider,
 org.springframework.beans.factory.ObjectProvider<BlockchainEventListener> listenerProvider)

Creates and wires the BlockchainNode bean from bound properties and any user-provided override beans (T-070, T-072).

Dependency resolution order

1. ConsensusEngine — user bean if present; else ProofOfWorkEngine with configured difficulty.
2. BlockchainStorage — user bean if present; else InMemoryStorage (ephemeral, for dev/demo).
3. TransactionValidator — all beans, chained in order (FR-TX-03).
4. BlockchainEventListener — all beans, registered in order (FR-EVENT-02).

The node is not started here. Spring calls start() via initMethod after all beans are fully wired.

Parameters:

properties - bound blockchain.* properties

engineProvider - optional ConsensusEngine override

storageProvider - optional BlockchainStorage override

validatorProvider - zero or more TransactionValidator beans

listenerProvider - zero or more BlockchainEventListener beans

Returns:

configured, not-yet-started BlockchainNode

blockchainHealthIndicator

@Bean
@ConditionalOnMissingBean
public BlockchainHealthIndicator blockchainHealthIndicator(BlockchainNode node)

Creates the BlockchainHealthIndicator status bean.

This is a plain POJO — it does not implement spring-boot-actuator's HealthIndicator interface, keeping this module free of a mandatory Actuator dependency. See BlockchainHealthIndicator for instructions on bridging it to Actuator's health endpoint (T-070).

Guarded by @ConditionalOnMissingBean so applications can replace it without touching library sources (T-072).

Parameters:

node - the autoconfigured or user-provided BlockchainNode

Returns:

status provider for the running node