---

Solana Ghost Bot: Wallet Watcher & Copy Trader

This Telegram bot enables users to monitor specified Solana wallets for transactions and execute copy trades automatically. It's designed to be user-friendly and customizable, making it ideal for traders looking to streamline their workflow.

Features

• Wallet Monitoring: Watch target wallets for transactions in real time.
• Copy Trading: Automatically replicate trades from monitored wallets to a designated wallet.
• Notifications: Get detailed trade alerts via Telegram messages, including trade type, amount, and token pairs.
• Customizable Filters: Monitor specific wallets or transactions involving a specific program ID.
• Error Handling: Handles rate limits and provides descriptive error messages.

---

How it's look like now

Requirements

Environment

• Node.js: v18+
• Telegram Bot API Key: Obtain from BotFather.
• Solana RPC Endpoint: Use a reliable RPC provider (e.g., Alchemy, QuickNode).

Dependencies

• @solana/web3.js: Interact with Solana blockchain.
• telegraf: Interface with Telegram Bot API.
• dotenv: Manage environment variables.
• prisma: For database management and migrations.
• jest: For testing the application.

---

Installation

Step 1: Clone the Repository

git clone https://github.com/variablevar/probable-adventure.git
cd probable-adventure

Step 2: Install Dependencies

npm install

Step 3: Configure Environment Variables

Create a .env file in the project root and populate it with your configuration:

TELEGRAM_BOT_TOKEN=
SOLANA_RPC_URL=
DATABASE_URL=
ADMIN_USER_NAME=

Step 4: Run Database Migrations

Generate and deploy the database schema using Prisma:

npm run migrate:dev
npm run prisma:generate

Step 6: Start the Bot

npm run dev

---

Scripts

The following scripts are available in the package.json file:

Script	Description
npm run dev	Runs the application in development mode using ts-node.
npm run build	Builds the application for production using TypeScript.
npm run start	Starts the built application from the dist directory.
npm run migrate:dev	Applies Prisma migrations in development mode.
npm run migrate:deploy	Deploys Prisma migrations in production.
npm run prisma:generate	Generates Prisma client based on the schema.
npm run test	Runs tests using Jest.

---

Usage

Add the Bot to Telegram

• Search for your bot's username in Telegram.
• Start a chat by clicking "Start".

Sample Trade Notification

💼 *Trade Alert!*
👤 *From*: `TargetWalletPublicKey`
🔄 *Pair*: `USDC/SOL`
📈 *Amount In*: `💰 500 USDC`
📉 *Amount Out*: `💎 25 SOL`
⏰ *Time*: `2025-01-08 12:34:56`
🔗 [View Transaction on Solscan](https://solscan.io/tx/TransactionHash)

---

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository.
2. Create a new branch: Use a descriptive name like feature/my-feature.
3. Commit your changes: Write clear and concise commit messages.
4. Open a pull request: Provide details about the changes and their purpose.

Thank you for helping improve the project!

License

This project is licensed under the MIT License. See the LICENSE file for details.

---