SYSTEM DOCUMENTATION

RightWhale Protocol /// Technical Reference v1.1

Protocol Overview

RightWhale is an autonomous liquidity engine launched on pump.fun (Solana). Unlike traditional bots, it actively manages its own economy by harvesting creator fees and redistributing them based on real-time market analysis.

  • Pump.fun NativeLeverages the bonding curve mechanics for initial liquidity.
  • Deflationary CoreSystematic buy-back and burns reduce supply over time.

System Architecture

The Brain

AI_TRADER.TS

Algorithmic Market Maker that decides to 'Attack' (Burn) or 'Defend' (LP) based on volatility.

The Heart

STRATEGY.TS

Infinite Flywheel engine that routes fees into virtual pots, saving unused capital for the next cycle.

The Hands

HARVESTER.TS

Autonomous interaction layer that claims pump.fun dividends and executes on-chain swaps.

Autonomous Cycle

1

Harvest

The engine monitors trading activity to collect accumulated Creator Fees. These SOL dividends form the basis of the protocol's buying power.

2

Analysis

The Decision Core analyzes market depth, volatility and volume. It decides the optimal timing and size for the next action to maximize impact and sustain the chart.

3

Distro

The Bot claims creator fees into its own Engine Wallet first. Then, during the Distribution cycle, the 10% Dev Fee is sent to DEV OPS Wallet, while the rest is executed by the protocol.

The Infinite Flywheel

Unlike static splitters, RightWhale uses a Dynamic Savings Mechanism. Unused capital is not wasted; it is stored in "Virtual Pots" for future high-impact deployment.

Bullish Scenario

Bot executes Buy & Burn to chase momentum. The LP allocation (30%) is SAVED into the Liquidity Pot.

Bearish Scenario

Bot executes Auto-LP to harden the floor. The Burn allocation (30%) is SAVED into the Buyback Pot.

Fee Allocation

30%
Burn

Bubacked & burned to reduce supply.

30%
Liquidity

Added to LP to deepen market depth.

30%
RevShare

Revenue sharing for holders.

10%
Dev Ops

10% sent to DEV OPS Wallet.

RevShare Program Architecture

Operational Mechanics

  • Automated DistributionNo claiming required. Rewards are airdropped directly to wallets every cycle.
  • Real-Time SnapshotsThe engine scans the blockchain for all holders instantly before every payout.

Eligibility Criteria

  • Min-Whale ThresholdHolders must own at least 0.05% of the supply to qualify.

Bot Command Ledger

/analysisReal-time AI Market Scans
/reservesAudit Strategic Pots (War Chest)
/harvestFee Collection Ledger
/burnsBuyback & Burn History
/lpsLiquidity Injection Log
/statusSystem Health & Monitor
/flywheelExplain the Infinite Loop
/payoutsRevShare Transaction Log

System Roadmap

Phase 1: Genesis (Current)

Core engine deployment, dashboard launch, initial LP establishment.

Phase 2: Expansion

Claude AI implementation, advanced analytics modules, community governance, RightWhaleProtocol Launchpad.