Nolyvatix is an enterprise-grade, open-source Business Intelligence (BI) and observability platform designed specifically for the Stellar blockchain ecosystem.
The platform ingests real-time Stellar ledger Server-Sent Events (SSE), payment corridor telemetry, and Soroban WASM smart contract JSON-RPC events. It synthesizes complex blockchain data into interactive real-time dashboards, natural language AI insights, automated report generation, and enterprise health monitoring.
- Live Ledger Stream: Continuous, low-latency stream of ledger closes, operations count, and base fee metrics via Horizon REST SSE.
- Network Throughput Analytics: Time-series telemetry graphs for Transactions Per Second (TPS) and payment volume velocity.
- Stellar Network Switcher: Seamless toggling between Stellar
MainnetandTestnetenvironments.
- Smart Contract Inspection: Real-time contract lookup by address (
C...), bytecode hash, and metadata. - WASM Gas & Resource Profiling: CPU instruction cycles and memory footprint tracking.
- Contract Event Log Decoder: Streaming contract event topic decoding and invocation success rates.
- Cross-Border Corridor Velocity: Real-time tracking of fiat-pegged stablecoins (USDC, EURC) and anchor settlement speeds.
- Liquidity Pool Intelligence: AMM pool TVL, reserve distribution, volume, and fee analytics.
- 12-Column Responsive Layout Engine: Customizable widget grid supporting KPI cards, time-series charts, bar charts, and data tables.
- User Layout Persistence: Saved layouts with active layout switching and default dashboard configuration.
- Configurable Anomaly Triggers: Rules for TPS drops, fee spikes, ledger close delays, and contract failure rates.
- Multi-Channel Notification History: In-app notifications and webhook dispatch configurations.
- Executive Digests & Custom Reports: Automated metric rollups and scheduled summaries.
- Multi-Format Export Engine: One-click exports in CSV, JSON, and printable/compiled PDF formats.
- Natural Language Querying: Ask plain-English questions about ledger trends, Soroban WASM contract execution, or anchor volumes.
- Dynamic Chart Synthesizer: Powered by
@google/genai(Gemini 2.5 Flash), converting queries into interactive Recharts visualizations. - Intelligent Heuristic Fallback: Deterministic rule-based synthesis using live Horizon metrics when
GEMINI_API_KEYis not provided.
- Identity & Access Management: Firebase ID token authentication middleware with Just-In-Time (JIT) local database user synchronization.
- Development Operator Fallback: Seamless local development mode (
ALLOW_DEV_FALLBACK=true) bypasses mandatory authentication for rapid iteration.
- Real Freighter Integration: Full browser extension handshake using
@stellar/freighter-apiwith zero simulated delays or fake keys. - Cryptographic Validation: Rigorous client-side verification complying with SEP-0023 StrKey specifications and CRC16-XModem checksum validation before any account is accepted.
- Horizon Balance Sync: Live on-chain native XLM balance synchronization for connected accounts.
- Network Mismatch Detection: Real-time cross-network verification comparing the active Freighter wallet network with Nolyvatix's configured network (Mainnet / Testnet).
- Decoupled Architecture: Stellar wallet state is completely decoupled from Firebase multi-tenant workspace authentication.
- Deep Intelligence Hook: One-click "My Connected Wallet" quick-navigation into the Wallet Intelligence analyzer.
(Interface captures from the working Nolyvatix application)
| Real-Time Command Center | Gemini AI Co-Pilot Drawer |
|---|---|
 |
 |
| Soroban WASM APM & Profiler | Assets & Anchor Corridors |
|---|---|
 |
 |
Nolyvatix is built as a full-stack, decoupled modular application combining high-performance blockchain ingestion with an Express API and React 19 client:
┌─────────────────────────────────────────────────────────────────────────┐
│ Client Tier (React 19 + Vite) │
│ • 12 Specialized Views • Tailwind CSS v4 • Motion Transitions │
│ • Zustand Global Store • TanStack React Query • Recharts Visuals │
└────────────────────────────────────┬────────────────────────────────────┘
│ HTTP / REST / SSE Stream
┌────────────────────────────────────▼────────────────────────────────────┐
│ Express API & Data Engine Layer │
│ • 17 Modular API Routers (/api/ledgers, /api/soroban, /api/ai, etc.) │
│ • Server-Sent Events (SSE) Bus (StellarEventBus) │
│ • High-Performance Dual-Tier Caching (MemoryCache + StellarCache) │
│ • Firebase Auth & Tenant Isolation Middleware (with Dev Fallback) │
│ • Google Gemini AI SDK (@google/genai) with Live Horizon Context │
└─────────────────┬─────────────────────────────────────┬─────────────────┘
│ │
┌─────────────────▼─────────────────┐ ┌─────────────────▼─────────────────┐
│ Database Tier (PostgreSQL) │ │ Stellar Network Tier │
│ • 11 Tables via Drizzle ORM │ │ • Stellar Horizon REST / SSE │
│ • Automatic In-Memory Fallback │ │ • Soroban JSON-RPC 2.0 Client │
│ (zero local setup required) │ │ (https://mainnet.sorobanrpc.com)
└───────────────────────────────────┘ └───────────────────────────────────┘
For full technical specifications, refer to ARCHITECTURE.md and PRD.md.
- Frontend Core: React 19, TypeScript 5.8, Vite 6
- Styling & Motion: Tailwind CSS v4, Motion
- State & Data Fetching: Zustand 5, @tanstack/react-query
- Data Visualization: Recharts
- Backend API: Express 4, Node.js
- Database & ORM: Drizzle ORM, PostgreSQL driver (
pg), Drizzle Kit (with in-memory fallback repositories) - Authentication: Firebase Auth & Firebase Admin SDK
- Blockchain Integrations: Stellar Horizon REST/SSE, Soroban JSON-RPC 2.0
- AI Engine: Google Gemini 2.5 Flash SDK (
@google/genai) with fallback heuristic synthesis - Testing: Node.js Test Runner (
tsx --test) - Icons: Lucide React
- Node.js:
v20.xor higher - npm:
v10.xor higher - (Optional) PostgreSQL:
v15+if running with persistent database (otherwise in-memory repositories activate automatically)
-
Clone the Repository:
git clone https://github.com/nolyvatix/nolyvatix.git cd nolyvatix -
Install Dependencies:
npm install
-
Configure Environment Variables: Create a
.envfile from.env.example:cp .env.example .env
Key configuration settings:
# AI Co-Pilot (optional - system falls back to rule-based synthesis if omitted) GEMINI_API_KEY="" # Blockchain Nodes VITE_HORIZON_URL="https://horizon.stellar.org" VITE_SOROBAN_RPC_URL="https://mainnet.sorobanrpc.com" # Local Development Auth Fallback ALLOW_DEV_FALLBACK="true" # Optional PostgreSQL Database (leave blank to use built-in in-memory repositories) SQL_HOST="" SQL_DB_NAME="" SQL_USER="" SQL_PASSWORD=""
-
Start Local Development Server:
npm run dev
Open
http://localhost:3000in your browser. -
Run Backend Test Suite:
npm testExecutes 36 unit and integration test cases across 12 suites via
tsx --test. -
Typecheck & Linting:
npm run lint
-
Production Build & Verification:
npm run build npm run start
/
├── .github/ # GitHub Templates & Workflows
│ ├── ISSUE_TEMPLATE/ # Bug Report, Feature Request, Docs Templates
│ └── PULL_REQUEST_TEMPLATE.md # Pull Request Template
├── docs/ # Technical Documentation
│ ├── ARCHITECTURE.md # System Architecture Blueprint
│ ├── PRD.md # Product Requirements Document
│ ├── LABELS.md # GitHub Label Taxonomy
│ └── PROJECT_BOARD.md # Project Board Structure
├── src/ # Application Source Code
│ ├── components/ # Modular UI Design System
│ │ ├── ai/ # Gemini AI Co-Pilot Drawer
│ │ ├── common/ # StatCard, ChartContainer, CommandPalette, ErrorBoundary
│ │ ├── layout/ # AppHeader, Sidebar, WorkspaceHeader, Footer
│ │ └── ui/ # Button, GlassCard, Badge, Input, StatusChip, Modal
│ ├── db/ # Database Schema & Persistence
│ │ ├── schema.ts # Drizzle ORM Schema (11 Relational Tables)
│ │ ├── index.ts # Connection Pool & In-Memory Fallback Detector
│ │ └── drizzle.config.ts # Drizzle Kit Configuration
│ ├── lib/ # Utility Functions (formatting, cn, storage)
│ ├── router/ # AppRouter navigation & centralized route registry
│ ├── server/ # Modular Express Server Architecture
│ │ ├── __tests__/ # Backend Test Suites (node:test via tsx)
│ │ ├── cache/ # MemoryCache & StellarCache In-Memory Layers
│ │ ├── clients/ # HorizonClient, SorobanClient, FirebaseAdmin
│ │ ├── dataEngine.ts # Dependency Injection & API Gateway Wireup
│ │ ├── middleware/ # Auth, Tenant Isolation, Error Handlers
│ │ ├── repositories/ # Domain & DB Repositories (with In-Memory Fallbacks)
│ │ ├── routes/ # 17 Modular API Express Routers
│ │ ├── services/ # Domain Services (Ledger, Soroban, AI, Alerts, etc.)
│ │ └── utils/ # Structured Logger & Response Wrappers
│ ├── services/ # Frontend API Services & Stream Clients
│ ├── store/ # Zustand Global Application Store
│ ├── types/ # TypeScript Domain Models & Interfaces
│ ├── views/ # 12 Interactive Workspace Views
│ ├── App.tsx # Root Application Component
│ ├── index.css # Tailwind CSS v4 Global Design Tokens
│ └── main.tsx # Frontend Mounting Entrypoint
├── .env.example # Environment Template
├── CONTRIBUTING.md # Development & Contribution Guide
├── LICENSE # MIT License
├── ROADMAP.md # Feature Roadmap (Completed, In-Progress, Planned)
├── SECURITY.md # Security & Vulnerability Disclosure Policy
├── server.ts # Express Server Entrypoint
└── package.json # Dependencies & Build Scripts
Development is organized across clear operational phases:
- Completed: Real-Time Command Center, Soroban WASM APM, Assets & Anchor Corridors, BI Dashboard Builder, Alert Center, Report Builder, Gemini AI with live context and fallback, Express API with 17 routers, Drizzle schema (11 tables) with in-memory fallbacks, and 36 backend tests.
- In Progress: Real cryptographic Web3 wallet integration (Freighter/Albedo browser extension signing), duplicate Soroban client consolidation, database migration runner pipeline.
- Planned: Automated CI/CD pipeline, frontend component tests, external Discord/Slack webhook dispatch workers, production rate limiting, and Kubernetes/Helm charts.
For the full detailed status breakdown, visit ROADMAP.md.
We welcome contributions from the open-source community! Please review our CONTRIBUTING.md guide and CODE_OF_CONDUCT.md before submitting pull requests.
If you discover a security vulnerability, please refer to our SECURITY.md policy and disclose it responsibly via email at security@nolyvatix.org.
This project is licensed under the MIT License.
Nolyvatix — Business Intelligence for the Stellar Blockchain Ecosystem.