https://github.com/dracor22/handi-cat_wallet-tracker
Solana wallet tracker Telegram Bot, follow any wallet and get detailed information about every transaction in Raydium, Jupiter, Pump.fun and PumpSwap 😺
https://github.com/dracor22/handi-cat_wallet-tracker
crypto pumpfun pumpfun-bot raydium solana solana-wallet-tracker telegram-bot web3
Last synced: 6 months ago
JSON representation
Solana wallet tracker Telegram Bot, follow any wallet and get detailed information about every transaction in Raydium, Jupiter, Pump.fun and PumpSwap 😺
- Host: GitHub
- URL: https://github.com/dracor22/handi-cat_wallet-tracker
- Owner: DracoR22
- Created: 2024-07-03T04:38:03.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-28T00:16:48.000Z (over 1 year ago)
- Last Synced: 2025-03-28T17:02:04.205Z (over 1 year ago)
- Topics: crypto, pumpfun, pumpfun-bot, raydium, solana, solana-wallet-tracker, telegram-bot, web3
- Language: TypeScript
- Homepage: https://t.me/handi_cat_bot
- Size: 2.69 MB
- Stars: 159
- Watchers: 5
- Forks: 70
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## About The Project
[![Product Name Screen Shot][product-screenshot]](https://t.me/handi_cat_bot)
Handi Cat is a Telegram bot that can track any Solana wallet in real time, it provides relevant information
of each transaction made in Raydium, Jupiter, Pump.fun and Pump AMM(PumpSwap) including transaction hash, tokens and amount swapped, price of the token in SOL, token market cap and much more.
## Features
- 📈 Tracks in Real-Time any SOL transfer
- 🔍 Detects Raydium, Jupiter, Pump.fun and PumpSwap transactions
- 💰 Gets SOL price of the token swapped
- 📊 Gets token market cap at the time swapped
- 💰 Gets token amount and supply percentage owned by each tracked wallet
- 🤖 Each transaction message includes links to popular Solana trading bots to quickly buy the token
- 🔗 Each transaction provides links to Photon, GMGN and Dex Screener to quickly see the token chart
## Bot Commands
- `/start` – Opens the bot's main menu
- `/add` – Add a new wallet address
- `/delete` – Delete a wallet addresss
- `/upgrade` – Access the subscription menu
- `/ban_wallet` – Flag a wallet as BANNED and remove it from the wallet pool **(admin only)**
- `/help_notify` – Learn how bot notifications work
- `/help_group` – Instructions for adding the bot to group chats
## Built With
- 🌐 Node.JS
- 📘 TypeScript
- 📊 Prisma ORM
- 🪙 Solana Web3.js
## Getting Started
Follow these simple steps to setup Handi Cat locally on your machine
### Prerequisites
**Node version 14.x**
### Steps
1. Clone the repo
```sh
git clone https://github.com/DracoR22/handi-cat_wallet-tracker.git
```
2. Install NPM packages
```sh
pnpm install
```
3. Rename `.env.example` file to `.env`
4. Create a Postgres database and paste the connection string into `DATABASE_URL` in .env
5. Create a new `Telegram Bot` using `Bot Father` and get your `BOT_TOKEN`. Paste it into the corresponding variable in `.env`
6. Run the migration command to push the database schemas and generate all types
```sh
pnpm db:migrate
```
7. `(Optional)` To use a webhook connection instead of polling, set your .env like this:
```env
ENVIRONMENT=production
APP_URL=https://your-domain.com
# APP_URL must be the public HTTPS URL where your bot is deployed.
# The bot will automatically register its webhook at `APP_URL/webhook/telegram.
```
8. `(Optional)` Set up custom RPC providers by adding them to the RPC_ENDPOINTS environment variable.
You can list multiple endpoints separated by commas, e.g.:
```env
RPC_ENDPOINTS=https://rpc1.com,https://rpc2.com
```
9. Start the bot
```sh
pnpm start
```
10. That's it! now your local version of Handi Cat is ready to use.
>
## Contact
- rdraco039@gmail.com
My solana wallet for the struggles - `5EVQsbVErvJruJvi3v8i3sDSy58GUnGfewwRb8pJk8N1`
Project Link: [https://github.com/DracoR22/handi-cat_wallet-tracker](https://github.com/DracoR22/handi-cat_wallet-tracker)
[contributors-shield]: https://img.shields.io/github/contributors/othneildrew/Best-README-Template.svg?style=for-the-badge
[contributors-url]: https://github.com/othneildrew/Best-README-Template/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/othneildrew/Best-README-Template.svg?style=for-the-badge
[forks-url]: https://github.com/othneildrew/Best-README-Template/network/members
[stars-shield]: https://img.shields.io/github/stars/othneildrew/Best-README-Template.svg?style=for-the-badge
[stars-url]: https://github.com/othneildrew/Best-README-Template/stargazers
[issues-shield]: https://img.shields.io/github/issues/othneildrew/Best-README-Template.svg?style=for-the-badge
[issues-url]: https://github.com/othneildrew/Best-README-Template/issues
[license-shield]: https://img.shields.io/github/license/othneildrew/Best-README-Template.svg?style=for-the-badge
[license-url]: https://github.com/othneildrew/Best-README-Template/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/othneildrew
[telegram-bot]: https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white
[product-screenshot]: showcase/notifications-new.png
