https://github.com/mrkara/casper-era-tracker
A modern, full-stack web application that displays live Casper network era information with real-time countdown timers, dual-mode era calculators, and comprehensive network data visualization.
https://github.com/mrkara/casper-era-tracker
api-proxy blockchain casper-blockchain casper-network dashboard developer-tools era-tracker flask full-stack network-monitoring python react real-time tailwindcss vite web3
Last synced: 4 months ago
JSON representation
A modern, full-stack web application that displays live Casper network era information with real-time countdown timers, dual-mode era calculators, and comprehensive network data visualization.
- Host: GitHub
- URL: https://github.com/mrkara/casper-era-tracker
- Owner: mrkara
- License: apache-2.0
- Created: 2025-09-27T13:27:58.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-09-27T15:14:04.000Z (4 months ago)
- Last Synced: 2025-09-27T15:23:59.293Z (4 months ago)
- Topics: api-proxy, blockchain, casper-blockchain, casper-network, dashboard, developer-tools, era-tracker, flask, full-stack, network-monitoring, python, react, real-time, tailwindcss, vite, web3
- Language: JavaScript
- Homepage:
- Size: 216 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: docs/SECURITY.md
Awesome Lists containing this project
README
# Casper Era Tracker
[](https://github.com/mrkara/casper-era-tracker/stargazers)
A modern, full-stack web application that displays live Casper network era information with real-time countdown timers, dual-mode era calculators, and comprehensive network data visualization.
## ✨ Features
- **Live Era Information**: Current era, block height, and time left to the next era.
- **Dual-Mode Era Calculator**: Predict future eras by era number or date/time.
- **Accurate Network Data**: Combines data from CSPR.cloud and CSPR.live for accuracy.
- **Secure Backend**: Flask API proxy protects API keys and handles CORS.
- **Modern Design**: Responsive and user-friendly interface.
## 🚀 Getting Started
### Prerequisites
- Node.js 18+
- Python 3.13+
- pnpm (or npm/yarn)
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/mrkara/casper-era-tracker.git
cd casper-era-tracker
```
2. **Install dependencies:**
```bash
# Install frontend dependencies
pnpm install
# Install backend dependencies
cd backend
pip install -r requirements.txt
```
3. **Configure API Key:**
```bash
# In the backend directory
cp .env.example .env
# Edit .env and add your CSPR.cloud API key
```
4. **Run the application:**
```bash
# Start the backend server (in /backend)
python app.py
# Start the frontend dev server (in project root)
pnpm run dev
```
## 📚 Documentation
- **[Deployment Guide](DEPLOYMENT.md)**: Instructions for deploying the application to various platforms.
- **[API Integration](docs/API.md)**: Details about the APIs used in the project.
- **[Calculation Logic](docs/CALCULATIONS.md)**: Explanation of the era and block height calculation formulas.
- **[Contributing Guidelines](CONTRIBUTING.md)**: How to contribute to the project.
## 🤖 AI-Generated Content Disclaimer
**Important Notice**: This project contains code and content that was generated with the assistance of artificial intelligence (AI) tools. While the code has been reviewed and tested, users should:
- **Review all code** before using in production environments
- **Test thoroughly** in their specific use cases
- **Verify API integrations** and security implementations
- **Understand the codebase** before making modifications
- **Follow security best practices** when deploying
Users are responsible for ensuring the code meets their security, performance, and functional requirements.
## 📄 License
This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
This application is powered by the fantastic APIs from [CSPR.cloud](https://cspr.cloud/) and [CSPR.live](https://cspr.live/).
The GitHub corner ribbon is based on [GitHub Corners](https://github.com/tholman/github-corners) by [Tim Holman](https://tholman.com/), licensed under the MIT License.
---
*Built with ❤️ for the Casper community.*