How pratibhanaikk/hiero-mirror-node works
Hiero Mirror Node archives network history: it obtains consensus-node stream files, validates their signatures and hash chain, processes them into indexed storage, and exposes the resulting data through several APIs. The README documents the ingestion and storage flow; the tree and source index identify the API subsystems. Some API-to-storage relationships are documented only at the product level, so those edges cite the README rather than implying specific unsampled calls.
Main entry points: transformer Stream processing · downloader Download and validation · BalanceReconciliationService.java Balance reconciliation · server.js REST API
Components 16
Stream ingestion
- Download and validation
importer/src/main/java/org/hiero/mirror/importer/downloader - Stream processing
importer/src/main/java/org/hiero/mirror/importer/downloader/block/transformer - Balance reconciliation
importer/src/main/java/org/hiero/mirror/importer/reconciliation/BalanceReconciliationService.java
Archive data
- Shared domain model
common/src/main/java/org/hiero/mirror/common/domain - Indexed archive
Data access
- REST API
rest/server.js - GraphQL API
graphql/src/main/java/org/hiero/mirror/graphql - gRPC API
grpc/src/main/java/org/hiero/mirror/grpc - REST Java API
rest-java/src/main/java/org/hiero/mirror/restjava - Rosetta API
rosetta - Web3 API
web3/src/main/java/org/hiero/mirror/web3
Monitoring
- Subscription monitor
monitor/src/main/java/org/hiero/mirror/monitor/subscribe
Other components
- Consensus nodes
- Cloud stream storage
- API clients
- Cloud providers
Connections 21
- Consensus nodes → Cloud stream storage: uploads stream files
- Cloud providers → Cloud stream storage: provide storage
- Cloud stream storage → Download and validation: supplies files
- Download and validation → Stream processing: validates then processes
- Stream processing → Indexed archive: populates
- Indexed archive → Balance reconciliation: provides balances
- Balance reconciliation → Indexed archive: reconciles balances
importer/src/main/java/org/hiero/mirror/importer/reconciliation/BalanceReconciliationService.java - Shared domain model → Stream processing: models stream data
- API clients → REST API: requests data
- API clients → GraphQL API: requests data
- API clients → gRPC API: requests data
- API clients → REST Java API: requests data
- API clients → Rosetta API: requests data
- API clients → Web3 API: requests data
- API clients → Subscription monitor: subscribes
- Indexed archive → REST API: serves indexed data
- Indexed archive → GraphQL API: serves indexed data
- Indexed archive → gRPC API: serves indexed data
- Indexed archive → REST Java API: serves indexed data
- Indexed archive → Rosetta API: serves indexed data
- Indexed archive → Web3 API: serves indexed data