Bitcoin LN Statistics

A comprehensive analytics platform for Bitcoin Lightning Network (BLN) statistics, providing detailed insights into network topology, node/entity centralization metrics and trends.

🎯 Overview

BLN Statistics is a multi-service application that collects, processes, and visualizes Bitcoin Lightning Network data. It provides advanced statistical analysis including centralization coefficients, Lorenz curves, network topology metrics, and comparative data source analysis.

Key Features

• Network Analysis: Comprehensive Lightning Network topology analysis
• Centralization Metrics: Gini coefficients, HHI, Theil index, Shannon entropy, and Nakamoto coefficients
• Lorenz Curves: Wealth distribution analysis across nodes and entities
• Multi-source Data: Integration with LNResearch and LND DBReader data sources
• Real-time Visualization: Charts and dashboards
• Workflow Orchestration: Automated data processing with Prefect
• Historical Analysis: Time-series analysis of network evolution

🏗️ Architecture

Services

The application consists of several Docker containers orchestrated via Docker Compose:

Service	Technology	Purpose
WEB UI	Next.js + Material-UI	Web interface and data visualization
Backend	Python Flask	REST API and data processing
Database	MySQL	Lightning Network data storage
Workflow Engine	Prefect	Data pipeline orchestration
Reverse Proxy	Caddy	HTTP endpoint unification
Database Browser	DBGate	Database administration
File Browser	FileBrowser	Raw data file management

🔧 Installation

System Requirements

• RAM: 8GB+
• Storage: 40GB+
• CPU: 4+ cores

Prerequisites

• Ubuntu 22.04+ OS version
• Ready to use Docker and docker-compose CLI tools

Setup

Clone BLN Stats repository:

git clone https://github.com/VUKNF-Fintech-Research-Group/blnstats.git
cd blnstats

Run provided docker compose sample configuration file and start the system:

cp docker-compose.yml.sample docker-compose.yml
./runUpdateThisStack.sh

After docker finishes starting services open your server IP address using WEB browser:

http://<ubuntu-server-ip-address-here>:80

And login into WEB UI using default credentials:

• User: admin@admin.com
• Pass: admin

🔗 External Dependencies

• LNResearch: Lightning Network research data
• Electrum Server: Using electrum.blockstream.info server by default
• LND DBReader: Lightning Network daemon database reader (Optional)

🙏 Acknowledgments

• Lightning Network Research Community - For historical BLN data
• Lightning Network Community - For the amazing Lightning Network ecosystem