https://github.com/0xtan1319/rug-checker-bot-solana
solana rug checker bot; parsing transaction, get check pool's safty
https://github.com/0xtan1319/rug-checker-bot-solana
Last synced: 3 months ago
JSON representation
solana rug checker bot; parsing transaction, get check pool's safty
- Host: GitHub
- URL: https://github.com/0xtan1319/rug-checker-bot-solana
- Owner: 0xTan1319
- Created: 2025-02-21T21:41:42.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-21T22:02:56.000Z (3 months ago)
- Last Synced: 2025-02-21T23:19:25.051Z (3 months ago)
- Language: TypeScript
- Size: 265 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Solana Rug Checker
`Solana Rug Checker` is a TypeScript-based tool designed to monitor new token creation events within the **Raydium** decentralized exchange ecosystem on the **Solana blockchain**.
The tool listens to blockchain logs to detect new token signatures associated with Raydium's liquidity pools, stores relevant data (e.g., creator information and token balances), and performs automated risk analysis to help identify potentially fraudulent tokens.
---
## Contact
If you wanna build tg or discord bot with this bot, feel free contact here:
[Telegram](https://t.me/shiny0103)
[Twitter](https://x.com/0xTan1319)
## Potential Use Case: Sniper Bot Development
`Solana Rug Checker` is a powerful tool for developing a **Sniper Bot**. By monitoring **newly created tokens** and assessing their rug pull risk, users can confidently act on early token listings. This combination of real-time detection and risk evaluation is essential for safer and more effective Sniper Bot strategies.
---
## Features
- **Monitors New Tokens**
Tracks new token creation events on Solana by analyzing transaction logs associated with Raydium liquidity pools.
- **Rug Pull Risk Analysis**
Uses `rugcheck.xyz` to evaluate the safety and legitimacy of newly detected tokens.
- **Data Storage**
Collects and stores key details, including:
- **Creator Wallet Address**
- **Safety Score**
- **Transaction Signatures**
- **Dev wallet Token Amount**
- **Dev Has Sold Tokens**
- **Total Bundled Amount**
- **Bundled percentage**
- **Top 10 holder's Amount percentage**
- **Blockchain Integration**
Built using `@solana/web3.js` for efficient interaction with the Solana network.
- **Error Handling and Logging**
Ensures reliable operation with robust error management and detailed logging.
---
## Prerequisites
Before using this tool, make sure you have the following installed:
- [Node.js](https://nodejs.org/) (Recommended version: `v14.x` or higher)
- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/) (for package management)
---
## Installation
Follow these steps to set up the Solana Token Tracker project on your local machine:
### 1. Clone the Repository
```bash
git clone https://github.com/0xTan1319/rug-checker-bot-solana.git
cd rug-checker-bot-solana
```
### 2. Install Dependencies
```bash
npm install
npm install dotenv
```
### 3. Configure RPC Endpoint
Create a `.env` file in the project root:
```env
# Mainnet RPC Endpoint (recommended)
RPC_ENDPOINT=https://mainnet.helius-rpc.com/?api-key=your-api-key
RPC_WEBSOCKET_ENDPOINT=wss://mainnet.helius-rpc.com/?api-key=your-api-key
```
> **💡 Pro Tip:**
> - Obtain an API key from Helius or another Solana RPC provider for optimal performance
> - Default RPC endpoints are available as fallback options
### 4. Run the Project
```bash
npx tsx src/index.ts
```
## Troubleshooting
### Common Issues
- **Installing tsx Globally (Optional)**:
```bash
npm install -g tsx
```
- **Dependency Conflicts**:
```bash
npm cache clean --force
npm install
```
- Ensure you're running the latest version of Node.js
- Check your Solana RPC endpoint configuration
- Verify that `tsx` is correctly installed and configured
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.