🐱 Handi Cat | Wallet Tracker

Track any Solana transaction in Real-Time

Use the Telegram bot ->

About The Project

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

(back to top)

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

(back to top)

Built With

• 🌐 Node.JS
• 📘 TypeScript
• 📊 Prisma ORM
• 🪙 Solana Web3.js

(back to top)

Getting Started

Follow these simple steps to setup Handi Cat locally on your machine

Prerequisites

Node version 14.x

Steps

1. Clone the repo

   git clone https://github.com/DracoR22/handi-cat_wallet-tracker.git

2. Install NPM packages

   pnpm install

3. Rename .env.example file to .env

4. Create a Postgres database and paste the connection string into DATABASE_URL

5. Create a new Telegram Bot using Bot Father and get your BOT_TOKEN, then paste it in the environment variable

6. Run migrate command to push the database schemas and generate all types

  pnpm db:migrate

7. Go to src/providers/telegram.ts and uncomment line 13, you will also need to comment everything after this line. We use this polling connection for local environments, if you decide to deploy the bot, then change it back to webhook connection

8. (Optional) setup a custom RPC provider inside of RPC_ENDPOINTS environment variable, you can place as many endpoints as you want if you folow them up with a comma. e.g: https://rpc1.com,https://rpc2.com

9. Start the bot

  pnpm start

10. That's it! now your local version of Handi Cat is ready to use.

(back to top)

Contact

- [email protected]

My solana wallet for the struggles - 5EVQsbVErvJruJvi3v8i3sDSy58GUnGfewwRb8pJk8N1

Project Link: https://github.com/DracoR22/handi-cat_wallet-tracker

(back to top)