Meme Executor - Solana Trade Execution Layer Skill

Meme Executor - Solana Trade Execution Layer

Solana-focused execution skill that turns high‑level trade plans into concrete orders.

Current Status: Phase 1 (Safe Mode)

| Component | Status | Risk Level | |-----------|--------|------------| | execute-trade.ts | DRY RUN only | None | | auto-trader.ts | DRY RUN only | None | | jupiter-client.ts | Quote-only | None | | wallet-manager.ts | Read-only | None | | position-tracker.ts | Local tracking | None |

No real transactions are sent in Phase 1.

When to Use

You already have a TradePlan from other agents/skills:
- meme-trader (signals + sizing)
- flow-tracker (liquidity + position sizing)
- degen-savant (narrative / conviction)
- contract-surgeon (rug/safety cleared)
You want to:
- Simulate trades and log PnL without sending real transactions
- Eventually route real orders via a configured Solana wallet + DEX router

Core Responsibilities

Parse a structured trade plan (token, side, size %, target size, SL/TP, slippage).
Apply simple risk checks (max position %, max concurrent positions hooks).
DRY‑RUN by default – log what would be traded and why.
Provide clear TODO hooks for wiring:
- Jupiter swap routing
- Wallet private key / signer configuration
- Trade log storage (JSONL or database)

TradePlan Interface

The executor expects a JSON payload matching this shape:

export interface TradePlan {
  tokenAddress: string;
  symbol?: string;
  chain: 'solana';
  side: 'buy' | 'sell';
  // either percentage of portfolio or absolute amount in SOL
  sizing: {
    mode: 'percent' | 'absolute';
    value: number; // e.g. 2 = 2% or 0.5 = 0.5 SOL
  };
  riskMode: 'degen' | 'moderate' | 'conservative';
  entryLimitPrice?: number; // optional, for limit-style behavior
  maxSlippageBps: number; // e.g. 1000 = 10%
  stopLossPrice?: number;
  takeProfit1?: number;
  takeProfit2?: number;
  notes?: string; // free-form rationale from upstream agents
  dryRun?: boolean; // default true; set false only once wired to real wallet
}

Usage (Simulation First)

From the repo root, a typical simulated execution call will look like:

npx tsx .claude/skills/meme-executor/scripts/execute-trade.ts \
  --plan-file /path/to/trade-plan.json

Where trade-plan.json contains a single TradePlan object.

Output Formats

Simulation Log (default) – human-friendly summary:
- What would be bought/sold
- Position size and notional exposure
- SL/TP levels and implied RR
- Any risk rule violations
JSON Log (--json) – machine-friendly output for chaining into other tools.

New Phase 1 Components

Jupiter Client (Quote-Only)

Get swap quotes without executing:

# Get a quote for swapping SOL to a token
npx tsx .claude/skills/meme-executor/scripts/jupiter-client.ts \
  --quote --input SOL --output <TOKEN_MINT> --amount 0.1

# JSON output
npx tsx .claude/skills/meme-executor/scripts/jupiter-client.ts \
  --quote --input SOL --output BONK --amount 0.5 --json

Wallet Manager (Read-Only)

Check wallet balances without signing:

# Check balance of any wallet
npx tsx .claude/skills/meme-executor/scripts/wallet-manager.ts \
  --balance --address <WALLET_ADDRESS>

# Use devnet
npx tsx .claude/skills/meme-executor/scripts/wallet-manager.ts \
  --balance --address <WALLET_ADDRESS> --devnet

Position Tracker

Track open positions locally:

# Add a position (after buy)
npx tsx .claude/skills/meme-executor/scripts/position-tracker.ts \
  --add --token <MINT> --symbol MEME --entry-price 0.001 --amount 1000 \
  --sl 0.0007 --tp 0.002

# List positions
npx tsx .claude/skills/meme-executor/scripts/position-tracker.ts --list

# Check stop-loss/take-profit triggers
npx tsx .claude/skills/meme-executor/scripts/position-tracker.ts \
  --check --prices '{"<MINT>": 0.0015}'

# Close a position
npx tsx .claude/skills/meme-executor/scripts/position-tracker.ts \
  --close --token <MINT> --exit-price 0.002

Phase Roadmap

| Phase | Components | Risk | |-------|------------|------| | 1 (Current) | Quote, balance, tracking | None | | 2 | Devnet swap execution | Low (fake SOL) | | 3 | Mainnet paper trading | None (simulated) | | 4 | Mainnet live (small size) | High |

Data Quality Validation Layer

<data_validation> Pre-Execution Data Requirements: All trades (even simulated) require validated data to ensure backtesting fidelity.

interface ExecutionDataQuality {
  price_quality: {
    score: number;           // Min 90 for execution
    sources_count: number;   // Min 2
    max_deviation: number;   // Max 5% between sources
    freshness_ms: number;    // Max 30000 (30s)
  };
  liquidity_check: {
    available: number;       // Must support trade size
    slippage_estimate: number;
    depth_ratio: number;     // Our size / available liquidity
  };
  risk_clearance: {
    rug_score: number;       // From meme-trader
    position_approved: boolean; // From risk-portfolio-manager
    kill_switch_status: 'active' | 'paused' | 'halted';
  };
}

interface ValidationResult {
  approved: boolean;
  quality_score: number;
  warnings: string[];
  blockers: string[];
}

Validation Pipeline:

Trade Plan → Price Validation → Liquidity Check → Risk Clearance → Execute/Reject
                 ↓                    ↓                 ↓
            Min 2 sources      Size < 5% pool    No kill switch
            Max 5% deviation   Slippage < limit   Position approved
            Max 30s stale      Depth sufficient   Rug score < 7

Validation Output (included in dry-run):

DATA VALIDATION REPORT
═════════════════════════════════════

PRICE DATA: PASSED (94/100)
├─ Sources: 3/3 (dexscreener, birdeye, jupiter)
├─ Prices: $0.00042 | $0.000418 | $0.000421
├─ Deviation: 0.48% (< 5% threshold)
├─ Freshness: 8 seconds ago
└─ Status: VALID

LIQUIDITY CHECK: PASSED
├─ Available Liquidity: $127,000
├─ Trade Size: $500 (0.39% of pool)
├─ Estimated Slippage: 0.8%
├─ Depth Ratio: HEALTHY
└─ Status: SUFFICIENT

RISK CLEARANCE: PASSED
├─ Rug Score: 4/10 (acceptable)
├─ Position Sizing: APPROVED (2.3% of portfolio)
├─ Kill Switch: ACTIVE
├─ Daily Loss Buffer: $1,260 remaining
└─ Status: CLEARED

OVERALL: APPROVED FOR EXECUTION
Quality Score: 92/100
Warnings: None
Blockers: None

Rejection Scenarios: | Condition | Action | Message | |-----------|--------|---------| | Price quality < 90 | REJECT | "Insufficient price data quality" | | Single source only | WARN | "Low confidence - single source" | | Price deviation > 5% | REJECT | "Price disagreement - investigate" | | Stale data > 60s | REJECT | "Data too old for execution" | | Size > 5% of pool | WARN | "High slippage expected" | | Rug score > 7 | REJECT | "Token failed safety check" | | Kill switch halted | REJECT | "Trading halted - risk limit" | </data_validation>

Real-Time Data Integration

<real_time_data> Data Sources for Execution:

const executionDataSources = {
  price: {
    primary: 'jupiter',      // Most accurate for Solana swaps
    fallback: ['dexscreener', 'birdeye'],
    refresh_interval: 5000,  // 5 seconds
    max_age: 30000,          // 30 seconds
  },
  liquidity: {
    primary: 'jupiter',      // Direct pool data
    fallback: ['raydium-api', 'dexscreener'],
    refresh_interval: 10000,
  },
  execution: {
    rpc: 'helius',
    backup_rpc: 'triton',
    commitment: 'confirmed',
  },
};

Pre-Execution Price Fetch:

# Fetch validated price before execution
npx tsx .claude/skills/meme-executor/scripts/pre-execution-check.ts \
  --token <MINT> \
  --size 500 \
  --validate-liquidity \
  --output json

</real_time_data>

Safety & TODOs

This skill MUST remain DRY‑RUN ONLY until:
- A secure wallet management pattern is agreed
- Jupiter / router integration is properly tested on devnet
- Data validation pipeline is production-tested
When enabling live trading:
- Add explicit --live flag and environment guardrails
- Require confirmation in higher‑level orchestration agents
- Implement daily loss limits via risk-portfolio-manager
- Add kill switch command integration
- Require minimum data quality score of 90/100
- Log all executions for audit and backtesting validation

Agent Skills: Meme Executor - Solana Trade Execution Layer

Install this agent skill to your local

Skill Files