AtlasP2P Documentation

Welcome to the AtlasP2P documentation - a professional, production-ready P2P network visualization platform for cryptocurrency blockchains.

🚀 Quick Start

Deploy a node map for your cryptocurrency in 3 simple steps:

1. Edit Configuration

# config/project.config.yaml
chain: yourcoin
chainConfig:
  name: YourCoin
  ticker: YOUR
  p2pPort: 8333
  magicBytes: "f9beb4d9"

2. Replace Logos

# Use template files as guides
cp your-logo.png apps/web/public/logos/logo.png
cp your-favicon.ico apps/web/public/logos/favicon.ico

3. Deploy

make prod

📚 Documentation Sections

⭐ Forking Guide

Complete step-by-step guide to fork AtlasP2P for your cryptocurrency.

Read Guide →

⚙️ Configuration

Complete reference for project.config.yaml customization.

Read Docs →

🌐 API Reference

RESTful API endpoints for node data, statistics, and network health.

API Docs →

🚀 Deployment

Production deployment guides for Docker, Kubernetes, AWS, and VPS.

Deploy Guide →

🕷️ Crawler

P2P network crawler implementation and configuration.

Crawler Docs →

🏗️ Architecture

Technical architecture and system design documentation.

Architecture →

💻 Developer Guide

Contribution guidelines, development setup, and common tasks.

Dev Guide →

✨ Key Features

🌍 Real-time Node Discovery: Bitcoin P2P protocol crawler with DNS seed discovery
🗺️ Interactive Geolocation Map: Leaflet-powered map with clustering and filtering
📊 Performance Metrics: Node tiers (Diamond/Gold/Silver/Bronze) based on uptime and latency
✅ Node Verification: Prove node ownership via message signing or DNS TXT records
👤 Operator Profiles: Custom branding with avatars and social links
💰 Tipping System: Enable tips for verified nodes
📈 Network Statistics: Real-time charts and historical trending
🔔 Alerting: Network health notifications and alerts

🛠️ Tech Stack

Frontend:

Next.js 16 with App Router
React 19 + TypeScript
Tailwind CSS 4
Leaflet for interactive maps

Backend:

Supabase - PostgreSQL + REST API + Real-time
Kong - API Gateway
Python 3.12 - P2P crawler with asyncio

Infrastructure:

Docker Compose
Caddy - Auto HTTPS
Turborepo - Monorepo

🎯 Use Cases

Blockchain Projects: Visualize your network’s global distribution
Node Operators: Showcase your infrastructure and attract more nodes
Community Transparency: Provide real-time network health to users
Research & Analytics: Track network growth and geographic diversity
Decentralization Metrics: Prove your network’s distributed nature

Guide	Description
Forking Guide	Fork this project for your cryptocurrency
Configuration	Complete YAML configuration reference
API Reference	RESTful API documentation
Deployment	Production deployment scenarios
Crawler Guide	P2P crawler implementation
Architecture	Technical architecture deep-dive
Developer Guide	Development setup and contribution guide

🤝 Credits

Built by: RaxTzu Team

Inspired by: Bitnodes.io - Node discovery methodology by Addy Yeow

Core Technologies: Next.js • Supabase • Leaflet • PostgreSQL • Python • Docker • MaxMind GeoIP

📄 License

MIT License - View Full License

AtlasP2P - Professional P2P Network Visualization

Professional P2P network visualization platform for cryptocurrency blockchains