Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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 and pump.fun 😺
https://github.com/dracor22/handi-cat_wallet-tracker
crypto pumpfun pumpfun-bot raydium solana solana-wallet-tracker telegram-bot web3
Last synced: 7 days ago
JSON representation
Solana wallet tracker Telegram Bot, follow any wallet and get detailed information about every transaction in Raydium, Jupiter and pump.fun 😺
- Host: GitHub
- URL: https://github.com/dracor22/handi-cat_wallet-tracker
- Owner: DracoR22
- Created: 2024-07-03T04:38:03.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-01-18T00:47:20.000Z (17 days ago)
- Last Synced: 2025-01-21T00:11:24.212Z (14 days ago)
- Topics: crypto, pumpfun, pumpfun-bot, raydium, solana, solana-wallet-tracker, telegram-bot, web3
- Language: TypeScript
- Homepage: https://t.me/handi_cat_bot
- Size: 925 KB
- Stars: 109
- Watchers: 3
- Forks: 43
- Open Issues: 6
-
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, providing relevant information
of each transaction made in Pump.fun, Raydium and Jupiter including transaction hash, tokens and amount swapped, price of the token in SOL, token market cap and much more.
## Features
- 📈 Real-time tracking of any transaction
- 🔍 Detects Pump.fun, Raydium and Jupiter transactions
- 💰 Gets SOL price of the token swapped
- 📊 Get tokens 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
## Built With
- 🌐 Node.JS
- 📘 TypeScript
- 📊 Prisma and Prisma Pulse
- 🪙 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. Go to `supabase.com` and create a free database
5. In your `Supabase` dashboard go to `Project Settings` -> `Database` paste the connection string into `SUPABASE_DATABASE_URL` environment variable. Make sure you activate the `pooler connection` and set the
port to `5432` your connection string should look like this: `postgresql://postgres.[PROJECT_URL]:[YOUR-PASSWORD]@aws-0-[YOUR-DB-REGION].pooler.supabase.com:5432/postgres?pgbouncer=true
`
6. Now you need to [Setup Prisma Pulse with a Supabase database](https://medium.com/@dilsharahasanka/prisma-pulse-hands-on-guide-b220954b3245) for real time database logs
7. After you get your `Prisma Pulse` API key, paste it in the `PULSE_API_KEY` environment variable
8. Create a new `Telegram Bot` using `Bot Father` and get your `BOT_TOKEN`, then paste it in the environment variable
9. Run migrate command to push the database schemas and generate all types
```sh
pnpm db:migrate
```
10. Now you have to setup an rpc provider in `src/providers/solana.ts`, you can change all NETWORKS to `SOLANA_NETWORK` if you dont have one
11. Start the bot
```sh
pnpm start
```
11. That's it! now your local version of Handi Cat is ready, you can also fill the other environment variables to setup an RPC of your choice
>
## Contact
My solana wallet for the struggles - `2MqEFduTn5Kux334v7EBeBWuChyPdNLJ94r7PZzUqWJw`
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
