https://github.com/patrick-ehimen/chain-alert

A backend-only application that allows users to monitor wallet addresses on EVM-compatible blockchains and Solana. The system tracks wallet balances, detects new token purchases, trades, or transactions, and sends real-time notifications via Telegram.
https://github.com/patrick-ehimen/chain-alert

alchemyapi bun mangoose mongodb

Last synced: about 1 month ago
JSON representation

A backend-only application that allows users to monitor wallet addresses on EVM-compatible blockchains and Solana. The system tracks wallet balances, detects new token purchases, trades, or transactions, and sends real-time notifications via Telegram.

• Host: GitHub
• URL: https://github.com/patrick-ehimen/chain-alert
• Owner: Patrick-Ehimen
• License: apache-2.0
• Created: 2024-12-17T13:32:39.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2024-12-18T08:29:03.000Z (about 1 month ago)
• Last Synced: 2024-12-18T09:31:32.900Z (about 1 month ago)
• Topics: alchemyapi, bun, mangoose, mongodb
• Language: Makefile
• Homepage:
• Size: 43.9 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# chain-alert

## 🚀 **Project Overview**

**Chain-Alert** is a backend-only application that allows users to monitor wallet addresses on **EVM-compatible blockchains** and **Solana**. The system tracks wallet balances, detects new token purchases, trades, or transactions, and sends real-time notifications via Telegram.

This is ideal for users who need a lightweight and automated way to track on-chain wallet activity.

---

## 📋 **Features**

- **Track Multiple Wallets**: Supports monitoring EVM-compatible wallets (Ethereum, Polygon, Optimism, etc.) and Solana wallets.

- **Real-Time Transaction Alerts**: Detects token transfers, trades, and purchases.

- **Wallet Balance Monitoring**: Periodically fetches wallet balances and checks for changes.

- **Telegram Notifications**: Sends instant alerts to a Telegram bot whenever an event is detected.

---

## 🛠 **Tech Stack**

- **Node.js** - Backend server and logic.

- **Alchemy API** - Real-time EVM blockchain data.

- **Solana Web3.js** - Monitor Solana blockchain wallets.

- **Telegram Bot API** - Sends real-time notifications.

- **MongoDB** - Stores wallet addresses and user configurations.

- **Express.js** - Handles API endpoints and webhook listeners.

- **WebSockets** - Listens to blockchain updates (via Alchemy Webhooks for EVM).

---

## 📦 **Setup Instructions**

### **1. Clone the Repository**

```bash

git clone https://github.com/Patrick-Ehimen/chain-alert.git

cd Chain-Alert

```