# DLMM Bot — full summary for LLMs / agents

Product name: DLMM Bot
Domain: https://dlmmbot.com
Repository: https://github.com/CryptoGnome/dlmmbot
License: PolyForm Shield 1.0.0 — you may run, study, and modify it for your own operation; you may not ship a competing bot or hosted copy. https://github.com/CryptoGnome/dlmmbot/blob/main/LICENSE
Brand: DLMM Bot (not “Meteora Farmer”)

## What it is

An automated Solana bot for Meteora DLMM liquidity. It scans hot SOL-quoted meme pools (and majors sleeves where configured), vets the non-SOL token, opens a one-sided SOL LP position shaped for the strategy, manages claims/exits by fixed rules, and records PnL in SQLite. A private ops dashboard ships with the bot.

## Who it is for

Operators who want paper trading first, then a burner wallet for live. Not custody, not a hosted trading service that holds user keys on our servers as a product — keys live on the user’s Railway volume / host.

## Deploy paths

1. Easy — Railway: deploy the repo template/service, attach a persistent volume at `/app/data`, generate a public domain, set `DASH_TOKEN` as a Railway variable (≥24 random chars), open `?token=…`. `railway.toml` builds the dashboard and runs farmer + dash together. Default mode is paper.
2. Advanced — local, VPS, or PM2: see https://dlmmbot.com/setup/advanced

## First-run dashboard

On first login when RPC + wallet are missing, a setup wizard walks through:

- Confirm dash token
- Helius RPC URL (RPC_URL) + Jupiter API key (JUPITER_API_KEY) — see Required secrets below; optional GMGN at https://dlmmbot.com/setup/api-keys
- Create a new Solana keypair or import a Phantom base58 private key; encrypt with a passphrase (AES-256-GCM on volume as wallet.enc.json)
- Choose paper or live (live still needs the double lock)
- Optional unlock into .env for trading

## Required secrets

- RPC_URL — suggested provider: Helius (https://www.helius.dev/). Sign up at dashboard.helius.dev, create a project, copy mainnet HTTPS URL (https://mainnet.helius-rpc.com/?api-key=…).
- JUPITER_API_KEY — Jupiter Developer Portal (https://developers.jup.ag/portal): sign in → team → API Keys → Create → copy once. Free tier OK. Setup: https://developers.jup.ag/docs/portal/setup
- GMGN_API_KEY (optional) — https://gmgn.ai/ai: generate Ed25519 public key, upload, copy API key. Query-only; no private key in bot. Guide: https://dlmmbot.com/setup/api-keys

## Runtime data

Repo `config.toml` is a template. Live knobs, `.env`, and SQLite live under gitignored `data/`
(`FARMER_CONFIG_PATH`, `FARMER_ENV_PATH`, `FARMER_DB_PATH`). On Railway that is the volume at
`/app/data`. Settings writes never dirty the git checkout — DIRTY on the dash means real code drift.

Settings also exposes encrypted wallet create / import / unlock on the Wallet & secrets tab. Set WALLET_PASSPHRASE on Railway to unlock on boot before the farmer starts.

## Dashboard features

- Live watch over WebSocket: positions, heartbeat, cluster brake, build/sync pill
- Activity feed with signed SOL coloring (inflows/wins green, capital deployed blue, losses red)
- Toasts for new entries/exits/fails/cluster/events and link/heartbeat edges (max two visible; pressure shortens TTL)
- Changes tab + toasts when GitHub is ahead, a deploy lands, or the farmer restarts on a new build
- Host updates: auto-update on by default (PM2 `meteora-deploy`); header Auto on/off next to the build pill requires Approve on Changes when off
- Errors tab: live `error_log` over WebSocket (stacks, mint/pool, copy dump, open GitHub issue)
- Token icons/names from Jupiter → Pump.fun → DexScreener, cached in SQLite `tokens` and browser localStorage
- Header ON/OFF soft-pauses trading (PAUSE file; positions stay open); HALT closes opens and idles until cleared
- Changes pending commits tagged by risk (strategy / deps / deploy / dash / docs)
- Settings: Bot settings (sizing, risk, filters, **profiles**) and Wallet & secrets (vault, encrypted wallet)
- Settings profiles: official Conservative / Balanced / Aggressive; private local saves under `data/profiles/`; community gallery from GitHub `profiles/community`. Share guide: https://dlmmbot.com/setup/profiles
- Research page: public X credits (not partners/signals)
- Wiki tab: operator manual (sleeves, P0–P5, follow, sizing, dash map); kept in sync with STRATEGY.md

## Usage fee

See https://dlmmbot.com/setup/fees — 1% of live wins buys/burns GNME (CryptoGnome’s existing mining-game token at gnmemining.com; the bot does not mint its own). Hardcoded product fee, not Settings-tunable.

## Safety model

- Paper: no wallet required (`FARMER_MODE=paper`)
- Live: requires BOTH process env `FARMER_MODE=live` AND config `[exec].mode = "live"`
- Burner wallet only; never main wallet
- Keys must not be committed to git
- One bot process per wallet/DB

## Key links

- Site: https://dlmmbot.com
- Docs hub: https://dlmmbot.com/setup/
- Easy: https://dlmmbot.com/setup/easy
- Advanced: https://dlmmbot.com/setup/advanced
- API keys: https://dlmmbot.com/setup/api-keys
- Profiles: https://dlmmbot.com/setup/profiles
- How it works: https://dlmmbot.com/setup/how-it-works
- Strategy reference: https://dlmmbot.com/setup/strategy
- Risk & sizing: https://dlmmbot.com/setup/risk
- Configuration reference: https://dlmmbot.com/setup/configuration
- Dashboard guide: https://dlmmbot.com/setup/dashboard
- CLI reference: https://dlmmbot.com/setup/cli
- FAQ: https://dlmmbot.com/setup/faq
- Fees: https://dlmmbot.com/setup/fees
- Short LLM map: https://dlmmbot.com/llms.txt
- Railway referral: https://railway.com?referralCode=SCj9lN
- Vultr VPS referral (advanced / local host): https://www.vultr.com/?ref=9917878-9J — suggested plan: 2 vCPU, 4 GB RAM, 80 GB NVMe, Ubuntu 24.04

## Disclaimer

Not financial advice. Memecoin LP can wipe a wallet. Paper first. Burner only.