Solana Memecoin Trade

# Solana Memecoin Guardian v2

## Overview
Solana Memecoin Guardian v2 is an autonomous trading skill designed to discover and trade Solana memecoins while minimizing downside risk.

The system combines several intelligence layers:

- Smart wallet copy trading
- AI-driven market analysis
- Social narrative detection (X / Twitter trends)
- Strict on-chain risk validation

The goal is not to chase every pump, but to selectively enter high‑probability opportunities while avoiding rug pulls and unsafe tokens.

---

## Core Capabilities

### 1. Smart Wallet Copy Trading
The skill monitors high-performing Solana wallets and selectively mirrors their trades.

Features:
- Wallet performance filtering
- Randomized delay before copying trades
- Anti‑FOMO entry protection
- Automatic exit when tracked wallets sell

### 2. AI Market Analysis
The AI engine scans Solana tokens using data sources such as:

- Pump.fun
- DexScreener
- On‑chain liquidity data

Signals are generated using rule‑based scoring models that evaluate:

- Liquidity stability
- Transaction activity
- Volume distribution
- Price volatility
- Market structure

Only tokens passing strict safety filters are considered.

### 3. Narrative Detection Engine
The system monitors viral narratives from social platforms such as X (Twitter).

When influential accounts or trending discussions appear, related tokens are prioritized for analysis.

Narrative signals increase priority but **never bypass risk validation**.

### 4. Risk Gate System
Every trade must pass the Risk Gate.

The system checks:

- Liquidity thresholds
- Mint authority status
- Freeze authority status
- Holder concentration
- Transaction anomalies
- Price impact risk

If any safety rule fails, the trade is rejected.

### 5. Position Management
Positions are automatically managed using:

- Stop Loss
- Multi‑level Take Profit
- Trailing Stop
- Liquidity monitoring
- Emergency exit triggers

### 6. Rug Pull Protection
A Rug Alarm system monitors:

- Liquidi...

# Solana Memecoin Guardian v2 (OpenClaw Skill Project)

This is a **TypeScript project skeleton** implementing BOTH:
1) **Selective Copy-Trade Engine** (smart wallet follower)  
2) **AI Self-Analysis Engine** (rule-based signals)

It runs in **paper mode** by default.

## Quick start
```bash
npm install
cp .env.example .env
npm run dev -- --mode paper --minutes 10
```

## What’s implemented in this bundle
✅ Shared Risk Gate (safe-by-default)  
✅ AI Engine (candidate scan + buy in paper mode)  
✅ Copy-Trade Engine (event handler + filters + anti-chase + budget)  
✅ Position Monitor (SL/TP1/TP2/Trailing)  
✅ Rug Alarms (LP drop proxy + impact proxy + holder spike placeholder)  
✅ Risk Budget Split (copy vs AI daily budget)  

## What is still a stub (you must wire)
- Real Pump.fun candidate feed (endpoints change)
- Real smart wallet stream/polling (Helius/Shyft/RPC logs)
- Real on-chain meta (mint/freeze authority + holders distribution)
- Live swap execution (Jupiter / your router)

Paper mode is safe: it will not send transactions.

---
⚠️ Memecoins are extremely risky. Audit everything.