PoolScout v0.4.0
A self-custodial LP workstation for Meteora on Solana (DLMM and DAMM v2 only). This site is the public build pack for agents working in the Pearl Forge room: the PRD (Draft 1.5), agent rules, kickoff prompt, UI/UX mockups, design tokens, and a cleaned copy of the deployed v0.3.1 source.
Read the PRD Agent Rules Mockup gallery Downloads
Scope
Chrome MV3 side panel + local Node/TypeScript backend. Future web (M4) and Expo mobile (M5) are UI-only and pair with the extension or the user's own backend. No hosted signer. PumpSwap and other venues are out of scope.
Source of truth
PRD-v0.4.0.md Draft 1.5 defines features and milestones. AGENT-RULES.md defines prohibitions and the design system. If they conflict, Agent Rules win. AGENT-PROMPT.md is the kickoff brief.
Baseline
v0.3.1 is deployed. Migrations must be additive. Do not break existing data or settings. Safe defaults stay: copy master OFF, dry run ON.
Security
Keys are encrypted only on the owner's PC (or the owner's own VPS). No seed phrase, no PIN, no vault, no operator key. Never log or ship secrets. No live mainnet transaction without the owner's approval.
Milestones
| Milestone | Theme | Scope (PRD §7) | Exit criteria (summary) |
|---|---|---|---|
| M0 | Prerequisites | Fresh Helius key; small live smoke test. Owner-run only. | One live position opened and closed cleanly. |
| M1 Parity | Close the gaps | 4.15 Self-hosted VPS, 4.16 Jito, 4.10 Copy quality (plus 4.7 fee-checked filter and 4.11 rugged-token exit), 4.4 Token safety, 4.9 Open positions UI. | P0 parity acceptance criteria pass; 72 h always-on soak in dry run; p50 latency measured. |
| M2 Win | Differentiators | 4.12 Demo, 4.6 Wallet Tracker, 4.1 Create pool, 4.13 PnL card v2, 4.5 New pool alerts, 4.18 Indonesian locale, 4.19 Simulation, 4.20 Daily recap, 4.21 Watchlist, 4.22 Copy backtest. | Acceptance criteria pass; screenshot sign-off; launch free. |
| M3 Depth | Completeness | 4.2 Discover, 4.3 Pools filters, 4.7 Smart LP (rest), 4.8 Portfolio, 4.11 Automation refine (rest), 4.17 Trust / security page. | P1 acceptance criteria pass. |
| M4 Reach | Web | 4.23 / 4a Web app paired with the extension; 4.14 Referral UI and tracking; monorepo. | Pairing security tests pass; referral codes work without rewards. |
| M5 Mobile | Phone | 4.24 Expo app (Android and iOS), UI only. Do not start until the owner explicitly approves M5. | No key on device; pairing and replay protection pass; push dry-run; screenshot sign-off. |
Design system (summary)
Compact native-mobile layout in the side panel. Bottom tabs: Pools, Radar, Copy, Wallets, More. Type scale: titles 17 px, body 13 px, key numbers 15 px (hero 22 px), meta 11 px, tab labels 10 px; max weight 600. One accent colour #ff8649. Green #54d490 and red #e5646e only for PnL. Circular token logos, plain-text pool type labels, 32×18 toggles, fewer borders, soft borderless badges. Full tokens live in mockups/css/styles.css.
Open decisions (owner only)
Fee model, domain, who hosts the web app and referral service, Apple Developer and Google Play accounts, and the mobile push provider remain King's decisions. Do not implement fee collection or referral rewards, and do not start M5, until he decides.
COPY_API_TOKEN or .env contents. Missing data never passes a safety check.