Private Blockchain 1.0.1 API
Packages
Package
Description
Private-network access control — allowlist enforcement, role-based permissions,
and invitation-token issuance for the private-blockchain library.
Allowlist enforcement — gates every inbound network message against a persisted
set of permitted node identifiers (FR-AC-01).
Invitation-token issuance and verification for new-node onboarding (FR-AC-04, FR-AC-05).
Role-Based Access Control (RBAC) — assigns and enforces capability roles for
each connected node address (FR-AC-02, FR-AC-03).
Built-in
ConsensusEngine implementations for the
private-blockchain library.Practical Byzantine Fault Tolerance (PBFT) consensus engine (FR-CONS-04, NFR-REL-03).
Proof of Authority (PoA) consensus engine — accepts blocks only from a configured
set of authorized signer addresses (FR-CONS-03, AC-02).
Proof of Work (PoW) consensus engine — SHA-256 hash mining with configurable
difficulty (FR-CONS-02, AC-03).
Round-Robin consensus engine — deterministic slot-based block production for
development and testing (FR-CONS-05).
Top-level package for the private-blockchain core library.
Assembly layer — the single location where all library modules are composed.
Sealed event hierarchy and the asynchronous publish-subscribe event bus.
Unchecked exception hierarchy rooted at
BlockchainException.In-memory transaction pool with pluggable prioritization and TTL eviction.
Immutable domain objects — the fundamental data model of the private-blockchain library.
Lifecycle interfaces for network subsystems, injected by
blockchain-network.Service Provider Interfaces (SPIs) — the primary extension points of the library.
Cryptographic primitives for the private-blockchain library — hashing, ECDSA
signing, key-pair generation, address derivation, and Merkle trees.
Spring Boot REST demo — exposes a running
BlockchainNode as an HTTP API using
Spring Boot 4.x autoconfiguration (T-075, AC-10).Peer-to-peer networking layer for the private-blockchain library — built on
Netty 4.2 TCP with NDJSON message framing (ADR-001).
Transaction gossip and block broadcast — propagates newly submitted transactions
and mined blocks to connected peers (FR-NET-02, FR-NET-03).
Peer lifecycle management — maintains the list of connected peers, runs heartbeat
checks, and prunes unresponsive connections (FR-NET-01, FR-NET-07).
Netty TCP server, client, and NDJSON message codec — the transport layer of the
P2P networking stack (FR-NET-01, ADR-001).
Chain synchronization and fork resolution — brings a node's local chain up to date
with the network on startup and after a network partition (FR-NET-04, FR-NET-05).
Spring Boot autoconfiguration for the private-blockchain library (FR-CFG-03, AC-10).
BlockchainStorage implementations and chain
export utilities for the private-blockchain library.File-system storage backend — persists each block as an individual JSON file
in a configurable directory (FR-STOR-05).
LevelDB persistent storage backend — crash-safe block persistence via the
leveldbjni native library (FR-STOR-03, NFR-REL-01).In-memory storage backend — ephemeral, zero-dependency block storage backed by
a
LinkedHashMap (FR-STOR-02).RocksDB persistent storage backend — high-throughput block persistence via the
rocksdbjni native library (FR-STOR-04).Wallet and key management — secp256k1 key pairs, transaction signing, balance
computation, and encrypted keystore serialisation (FR-WALLET-01–04).