StellarPulse

StellarPulse is an open-source real-time analytics and monitoring platform for the Stellar blockchain. It combines a network overview dashboard, asset explorer, DEX insights, Soroban contract analytics, account tracking, transaction monitoring, and alerting in one integrated experience.

Why StellarPulse?

The goal is to provide developers, traders, anchor operators, and researchers with a single dashboard for:

• Live Stellar network health and throughput
• Historical analytics across ledgers, transactions, and assets
• DEX, Soroban, and account-level intelligence
• Alerting for wallets, contracts, and network anomalies
• Public data access through an embeddable analytics experience

Architecture

+----------------------------------------------------------------------------------+
|                            Stellar Horizon / Core APIs                              |
|  Horizon REST / SSE / Streaming Endpoints                                          |
+-------------------------------------------+--------------------------------------+
                                            |
                                            v
                                +---------------------+
                                |  Indexer Workers     |
                                |  - Ledger ingestion  |
                                |  - Asset indexing    |
                                |  - Account tracking  |
                                |  - Soroban calls     |
                                +----------+----------+
                                           |
                                           v
                   +------------------------------+-------------------------------+
                   |                                                               |
                   v                                                               v
         +---------------------+                                     +---------------------+
         | PostgreSQL + TimescaleDB |                                     | Redis + BullMQ     |
         | - Historical data       |                                     | - Cache             |
         | - Metrics              |                                     | - Rate limiting     |
         | - Search + exports     |                                     | - Live event bus    |
         +-----------+-----------+                                     +-----------+---------+
                     |                                                        |
                     v                                                        v
         +-----------------------------------------------------------------+
         |                           API Layer                             |
         | Express REST + WebSocket + Public API + Alerting               |
         +---------------------+-------------------------------------------+
                               |
                               v
                     +--------------------+
                     | Next.js Dashboard  |
                     | React + Tailwind   |
                     | Recharts widgets   |
                     +--------------------+

Features

• Real-time network overview dashboard
• Asset explorer with sortable tables and detailed views
• DEX and liquidity analytics
• Soroban contract tracking
• Account and transaction explorers
• Anchors, payment corridors, and cross-border flow analytics
• Configurable alerts for wallet and network behavior
• CSV export, date range controls, and public API access
• Dark mode by default with a light mode toggle

Repository structure

.
├── apps
│   ├── api
│   ├── indexer
│   └── web
├── packages
│   ├── stellar-client
│   └── ui-components
├── docs
│   ├── api-reference
│   └── self-hosting
├── .env.example
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
├── docker-compose.yml
├── package.json
├── README.md
└── .github
    └── issues

Quick start

1. Install dependencies:

npm install

2. Copy the environment file and adjust values:

cp .env.example .env

3. Start the stack:

npm run dev

4. Open the dashboard:

• Frontend: http://localhost:3000
• API: http://localhost:4000
• WebSocket: ws://localhost:4000

Docker

docker compose up --build

Development notes

• Development uses the Stellar testnet.
• Production deployments should target Stellar mainnet.
• Horizon API calls are designed to handle rate limits gracefully.
• The indexer is structured so it can resume from the last indexed ledger.

License

This project is licensed under the MIT License. See LICENSE.

Contributing

Please read CONTRIBUTING.md before submitting a PR.

Public API and docs

The public API reference is available under docs/api-reference.