Architecture Blueprint
Comprehensive enterprise architecture plan detailing all core systems, integration points, scaling strategies, and data flows
Core Systems
6
Production-grade
Total Services
24
Containerized
Data Engines
3
PG + CH + Redis
Uptime SLA
99.97%
Multi-AZ deployment
System Architecture Overview
Click a component to explore its blueprint
System Integration Matrix
| Source | Target | Integration | Status |
|---|---|---|---|
| Indexed Data | Active | ||
| Events | Active | ||
| Real-time | Active | ||
| Queries | Active | ||
| API Responses | Active | ||
| Orchestration | Active | ||
| Orchestration | Active | ||
| Orchestration | Active | ||
| Orchestration | Active | ||
| Deployment | Active |
Architecture Design Principles
Horizontal Scalability
Every component is designed to scale out, not up. Stateless workers coordinate via Redis locks. API pods scale on CPU/request rate. Kafka partitions enable parallel consumption. K8s HPA automates scaling based on custom metrics.
Event-Driven Decoupling
Systems communicate through events, not direct calls. The indexer publishes to Kafka; consumers are independent. This allows adding new consumers (alerting, webhooks, analytics) without modifying the producer. Backpressure is handled at each stage.
Polyglot Persistence
Each data store is chosen for its strengths: PostgreSQL for transactional integrity and relational queries, ClickHouse for sub-second analytics over billions of rows, Redis for microsecond cache lookups and ephemeral state.
Defense in Depth Security
TLS everywhere. API keys hashed with bcrypt. Rate limiting at NGINX edge and application layer. Multi-tenant isolation via namespace partitioning. All secrets managed through K8s Secrets with external secret operator integration.
Observability First
Every service exposes Prometheus metrics. Structured JSON logging ships to Loki. Distributed traces propagate through the full request path. Grafana dashboards provide real-time visibility. AlertManager triggers PagerDuty on SLO violations.
GitOps & Immutable Infrastructure
All infrastructure is defined as code in Helm charts. ArgoCD syncs desired state from Git. Docker images are immutable and tagged with commit SHA. Blue-green and canary deployments ensure zero-downtime releases with automatic rollback.
Complete Technology Stack
| Layer | Technology | Purpose | Version |
|---|---|---|---|
| Runtime | Node.js | Indexer workers, API servers, WS gateway | 22 LTS |
| Framework | Next.js | Frontend SSR, API routes, RSC streaming | 16.x |
| Styling | Tailwind CSS | Utility-first CSS framework | 4.x |
| OLTP Database | PostgreSQL | Core relational data (blocks, txs, balances) | 16.x |
| OLAP Database | ClickHouse | Analytics, aggregation, time-series | 24.x |
| Cache / Queue | Redis | Caching, BullMQ jobs, rate limits, locks | 7.x |
| Event Streaming | Apache Kafka | Durable event backbone (KRaft mode) | 3.7 |
| GraphQL | Apollo Server | Flexible data querying, subscriptions | 4.x |
| REST | Express.js | High-volume machine API endpoints | 5.x |
| Blockchain | ethers.js | RPC interaction, ABI decoding | 6.x |
| Container | Docker | Service containerization | 25.x |
| Orchestration | Kubernetes | Container orchestration, auto-scaling | 1.30 |
| Ingress | NGINX | Reverse proxy, TLS, WS upgrade, rate limit | 1.27 |
| CI/CD | GitHub Actions + ArgoCD | Build, test, deploy pipeline | Latest |
| Monitoring | Prometheus + Grafana | Metrics, dashboards, alerting | Latest |
| Logging | Loki + Tempo | Log aggregation, distributed tracing | Latest |
| CDC | Debezium | Change Data Capture from PostgreSQL WAL | 2.x |
| TLS | cert-manager + Let's Encrypt | Automatic SSL certificate management | 1.x |