# Moonseum — Phased Product Roadmap

**The Collector-First NFT Discovery Experience and Future Marketplace**

---

> **Current availability notice:** Moonseum is live for discovery and account features. Users can browse available provider-backed collection data and use supported profiles, authentication, watchlists, preferences, account export/deletion, and non-executable drafts. Purchases, checkout, offers, platform fees, transaction settlement, and creator minting remain disabled. Execution-related features described below are roadmap targets, not current product availability.

## Strategic Positioning

Moonseum is positioned as the "collector-first" NFT marketplace built around six strategic pillars:

1. **Collector-first** — Every feature decision benefits holders, not just bots
2. **No bot pools** — No AMMs that algorithmically compress floor prices
3. **Transparent pricing** — "Fair Floor" based on real volume-weighted sales
4. **Creator-friendly** — Planned royalty enforcement and creator tools first-class
5. **Multi-chain native** — Solana-first but expanding to ETH/Base/Polygon
6. **Brand-distinctive** — Moonsters mascot identity, neon green/purple theme

---

## Planned Business Model: Hybrid Aggregator + Native Marketplace

Moonseum is planned to operate on a dual-liquidity model after settlement, provider integrations, and security review are complete:

- **Aggregated liquidity** — Read-only market data can be shown from configured providers. Future aggregation would route buyers to an approved execution path; Moonseum does not currently execute purchases.
- **Native liquidity** — A future native marketplace could accept verified listings. Today, creator/listing inputs are drafts only; there are no active native listings or fees.
- **Why this wins** — Tensor used this model to overtake Magic Eden on Solana. If Moonseum launches execution, aggregation could provide discovery while native liquidity grows around a reviewed settlement system.

---

## Phase 1 — Foundation (Complete, non-execution)

Already shipped:

- Brand identity (Moonsters mascot, neon green + purple theme)
- Marketing pages: Home, Trade, Stats, Drops, Create, Watchlist
- Components: Hero, Featured Carousel, Trending Table with sparklines, Biggest Movers (Gainers/Losers split), Latest NFTs, CTA Section, Footer
- Activity ticker with live-feel scrolling animation
- Supabase authentication with email/password
- Database with RLS policies: profiles, watchlist, cart_items, notifications
- Watchlist system (server-synced, optimistic updates)
- Cart system with slide-out drawer
- Notification bell with unread state
- SOL/USD currency toggle (persisted)
- Light/dark theme toggle
- Bottom mobile navigation
- Portfolio quick-view floating widget
- Loading skeletons with shimmer animation
- 404 page with mascot, EmptyState component
- Chain filter pills on trending table

---

## Phase 2 — Wallet Auth + Aggregation Layer

**Goal:** Real wallet identity + aggregated liquidity from major marketplaces. This is the critical phase that turns the demo into a usable product.

### 2.1 Wallet Authentication
- Solana Kit with Wallet Standard discovery (Phantom, Backpack, Solflare, and other compatible wallets)
- Sign-In With Solana (SIWS) flow with nonce verification
- Wallet address as primary identity, email optional for notifications
- Multi-wallet linking (one user, many wallets)
- Bonfida `.sol` domain resolution for display
- Migration path from existing email auth users

### 2.2 Aggregation Infrastructure
- Reservoir API integration for ETH, Base, Polygon, Arbitrum
- Magic Eden API integration for Solana (read-only listings)
- Tensor API integration for Solana (read-only listings)
- OpenSea API integration as fallback
- Unified order book schema in Supabase (source-agnostic)
- Background sync workers (Vercel Cron + edge functions)
- Source attribution on every listing ("Listed on Magic Eden")

### 2.3 Aggregated Buy Flow
- Buy button routes to cheapest source automatically
- Cross-marketplace cart (mix native + ME + Tensor in one checkout)
- Atomic execution via Jito bundles (Solana) or Reservoir router (ETH)
- Fee transparency: show platform fee + source fee + royalty
- Anti-MEV protection routing through Jito private mempool

### 2.4 Blockchain Data Layer
- Helius integration for Solana indexing
- Cached tables: collections, nfts, sales, listings, holders
- Background sync intervals (mints 30s, floors 60s, sales 15s, holders daily)
- 90-day hot retention, archive after

### 2.5 Real-Time Updates
- Supabase Realtime channels for live floor flashes
- WebSocket subscriptions to Helius for instant sale notifications
- Live activity ticker with real on-chain events
- Live mint progress bars on launchpad pages

### 2.6 Search Infrastructure
- Meilisearch or Algolia indexing of collections, NFTs, wallets
- Cmd+K command palette
- Fuzzy search with typo tolerance
- Recent searches, trending searches
- Wire up the existing header search input

---

## Phase 3 — Native Marketplace (No AMM)

**Goal:** Build the native listing/offer/auction system that runs alongside the aggregator. Users prefer native because of better UX and lower fees.

### 3.1 Native Listing Engine
- List NFT for sale (signs message, creates on-chain listing)
- Edit/cancel listings
- Bulk listing (50+ NFTs in single signature batch)
- Bulk delisting
- Listing expiration (1d, 7d, 30d, custom)
- Royalty enforcement (creators always paid, no opt-out)
- Native listings get reduced platform fee
- Required pre-release adapters: classic Metaplex, Core, pNFT, and cNFT
- Arbitrary Token-2022 assets remain fail-closed pending a separately reviewed allowlist

### 3.2 Native Buy Flow
- Single-item buy (instant, atomic)
- Multi-item cart checkout (Jito bundle for Solana)
- Floor sweep tool (buy cheapest N items at once with slippage cap)
- Anti-MEV protection via private mempool
- Transaction status with toast notifications

### 3.3 Offers System (the AMM Replacement)

This is what makes Moonseum different from competitors with AMM pools.

- Item offers: bid on a specific NFT
- Collection offers: bid for "any NFT in this collection" at price X
- Trait offers: bid for "any Cosmic Ape with Gold Fur trait"
- Funds escrow in smart contract (USDC or wrapped SOL)
- Sellers see aggregated highest bid with one-click accept
- Auto-cancel on insufficient balance
- Offer expiration timers
- Visual offer leaderboard per collection (depth chart)

### 3.4 Auction System
- Timed auctions with 5-min extension on last-minute bids (anti-snipe)
- Sealed-bid auctions for high-value items (commit-reveal)
- Auction notifications (outbid, ending soon, won)

### 3.5 "Fair Floor" Display
- Headline metric: 24h volume-weighted average sale price
- Listing floor shown as secondary
- Tooltip educates users on the difference
- Differentiates us from every competitor showing manipulated floors

### 3.6 Anti-Bot Mechanisms
- Per-wallet rate limits (max 10 list/delist changes per minute)
- Optional 5-second hold on listings priced 20%+ below floor
- Wallet reputation badges based on sustained legitimate activity
- No AMM pools (strategic decision, see Possible Future Phase)

---

## Phase 4 — Detail Pages & Discovery

### 4.1 Collection Detail Page (`/collection/[slug]`)
- Hero with banner, stats grid, social links
- Tabs: Items / Activity / Holders / Analytics / Offers
- Items tab with trait filters, price range, listed only, rarity sort
- Activity tab: live feed of sales/listings/offers
- Holders tab: distribution chart, whale alerts, holder list
- Analytics tab: floor history, volume, listing pressure, holder count
- Offers tab: live order book of collection bids and trait bids
- Source-aware listings (ME, Tensor, OpenSea, native badges)

### 4.2 NFT Detail Page (`/nft/[mint]`)
- Large image with zoom/fullscreen
- Full metadata, traits with rarity %
- Price history sparkline
- Ownership history timeline
- Active offers list
- "More from this collection" rail
- "Other NFTs by this owner" rail
- Buy/Make Offer/Place Bid actions
- Source attribution if listing comes from external marketplace

### 4.3 Profile Pages (`/profile/[wallet]`)
- Public portfolio (anyone can visit any wallet)
- Tabs: Holdings / Activity / Listings / Offers Made / Offers Received / Collections Created
- Portfolio value chart over time
- Realized P&L per collection
- Followers/following (social layer)
- Bio, banner image, verified badges

### 4.4 Activity Feed (`/activity`)
- Global sales/mints feed across all collections and sources
- Filter by collection, price range, event type, source
- Whale tracker (sales over X SOL)
- Subscribe to specific wallets

### 4.5 Advanced Filtering
- Floor price range slider, volume range, holder count, listed %, mint date, verified status
- Categories (PFP, Art, Gaming, Music, Photography, etc.)
- Save filter presets
- "Native only" or "All sources" toggle

---

## Phase 5 — Trader Power Tools

### 5.1 Pro Mode
- Toggle in user settings
- Dense data view, multi-pane layout, keyboard shortcuts (B = buy, L = list, F = sweep, ? = help)

### 5.2 Bulk Operations
- Bulk list with trait-based pricing rules ("list all Gold trait at floor + 10%")
- Bulk delist, bulk transfer, bulk burn

### 5.3 Auto-Tools
- Auto-list at floor
- Auto-accept offers above X price
- Floor monitoring alerts (Telegram/Discord webhook)
- Bid bot replacement: "always have an offer X% below floor" rule (safer alternative to AMM, fully under user control)

### 5.4 Analytics Dashboard
- Personal P&L tracker
- Tax export (CoinTracker integration)
- Wallet performance comparison vs. floor
- Trade execution quality scoring

### 5.5 Watchlist Pro
- Price alerts (floor crosses X, sale at Y)
- Custom alert rules
- Multi-channel: push, email, Telegram, Discord

---

## Phase 6 — Creator Launchpad

**Goal:** Replace LaunchMyNFT entirely with a better creator experience.

### 6.1 No-Code Collection Deployer
- Upload art, generate metadata
- Visual trait rarity editor
- Generative art engine in browser
- Configure mint price, supply, royalties
- Deploy to Solana with one click
- Explicit classic Metaplex, Core, pNFT, and cNFT deployment paths
- No arbitrary Token-2022 collection deployment in the first release

### 6.2 Allowlist & Mint Mechanics
- Whitelist management (CSV upload, Discord role sync, NFT holder snapshot)
- Tiered mint phases (OG / Whitelist / Public)
- Per-wallet mint limits
- Reveal mechanics (delayed reveal, gradual reveal)
- Free mints, pay-to-mint, dynamic pricing

### 6.3 Mint Page Builder
- Drag-and-drop landing page builder
- Custom domain support
- Embedded mint widget for external sites
- Live mint stats with progress bar

### 6.4 Creator Dashboard
- Collection performance overview
- Holder analytics
- Royalty earnings tracker
- Treasury management
- Holder communication tools
- Allowlist management for future drops

### 6.5 Verified Creator Program
- KYC for creators (optional, unlocks blue check)
- Verified collections get featured placement
- Anti-rug protections (vesting schedules for treasury)

---

## Phase 7 — Multi-Chain Expansion

### 7.1 Chain Expansion
- Ethereum, Base, Polygon, Arbitrum (via Reservoir)
- Bitcoin Ordinals (via ME API or Hiro)
- Per-chain floor display, unified user portfolio

### 7.2 Cross-Chain Features
- View all your NFTs across chains in one portfolio
- Unified watchlist across chains
- Cross-chain price comparison

### 7.3 Aggregation Depth
- Pull listings from secondary marketplaces (LooksRare, Blur, X2Y2)
- Show unified price, route to cheapest source
- Native listings always preferred when price equal

---

## Phase 8 — Social & Community

### 8.1 Social Features
- Follow wallets, get notifications when they trade
- Comments on NFTs, like/save publicly
- Share NFTs with rich preview cards

### 8.2 Collection Communities
- Holder-only chat per collection (token-gated)
- Holder polls, governance
- Community announcements from creators

### 8.3 Discovery Feed
- Algorithmic feed of NFTs based on holdings, watchlist, follows
- Trending creators, curated editorial picks

### 8.4 Reputation System
- Trader reputation score (volume, longevity, no-rug history)
- Collector badges
- On-chain achievement NFTs

---

## Phase 9 — Mobile & Native Apps

### 9.1 PWA Hardening
- Full offline support for portfolio view
- Push notifications via web push
- Add-to-home-screen flow

### 9.2 Native iOS / React Native App
- Mobile wallet integration through Solana Kit and Wallet Standard
- Biometric auth, native sharing
- App Store / Play Store presence

### 9.3 Mobile-Exclusive Features
- Swipe-to-buy gesture on featured items
- AR view for 3D NFTs
- Camera-based wallet scanning

---

## Phase 10 — Token & Tokenomics (Optional)

### 10.1 $MOON Token
- Trade-to-earn (rewards for legitimate volume, not wash trading)
- Stake for fee discounts
- Stake for premium features
- Governance over treasury and roadmap

### 10.2 Anti-Gaming Mechanisms
- Wash trade detection (no rewards for same wallet cluster)
- Sybil resistance (one identity per verified human)
- Vesting on rewards to prevent dump

---

## Possible Future Phase — AMM Pools

**Reserved for future evaluation.** Currently NOT building AMM pools because they cause systematic floor price compression via bot-driven extraction. If we ever revisit, we would build it differently than competitors.

### What "Better AMM" Would Look Like
- Whitelisted LPs only (verified market makers, no anonymous bot farms)
- TWAP-based pricing (smooths price discovery, harder to manipulate)
- Anti-sandwich routing (all pool trades through Jito bundles)
- Pool deposit cooldowns (24-hour minimum lockup, kills fast LP rotation)
- LP transparency (show who is making the market, reputation, P&L)
- Holder-only pools option (collection treasury can run pools that benefit holders, not external LPs)
- Pool buy-price floor based on volume-weighted average, not LP whim
- Optional opt-in per collection (creators decide if AMM is allowed)
- Royalty enforcement on pool trades (most AMMs skip royalties)

### Why We're Waiting
- AMM bonding curve math is complex and risky (audit-heavy)
- Smart contract exploits in AMMs have drained pools many times
- Dilutes the "no bot pools" brand pillar
- Better to build offer/auction system to maturity first
- We can always add AMM later; we cannot easily remove it once launched

### Trigger Conditions to Reconsider
- Sellers consistently complain about lack of instant liquidity even with strong offers
- Major institutional market makers approach us wanting to LP
- A novel AMM design emerges that genuinely solves bot extraction
- Competitors abandon AMMs and we want to fill the void
- Market shifts toward needing AMMs for stablecoin-priced floor pegging

---

## Recommended Build Order

### Next 4-6 weeks (most impact)
1. Phase 2.1 — Wallet auth
2. Phase 2.2 — Aggregation infrastructure (Reservoir + ME + Tensor APIs)
3. Phase 2.3 — Aggregated buy flow
4. Phase 2.4 — Helius integration + real collection/NFT data
5. Phase 4.1 — Collection detail page with real data

### Next 6-12 weeks (differentiation)
6. Phase 3.1 + 3.2 — Native listings and buy flow
7. Phase 3.3 — Offers system (the AMM replacement)
8. Phase 3.5 — Fair Floor display
9. Phase 4.2 — NFT detail page
10. Phase 4.3 — Profile pages
11. Phase 2.6 — Working search
12. Phase 4.5 — Advanced filtering

### Months 3-6 (depth)
13. Phase 5 — Pro tools
14. Phase 6 — Creator launchpad
15. Phase 7 — Multi-chain expansion

### Months 6-12 (moat)
16. Phase 8 — Social layer
17. Phase 9 — Mobile apps
18. Phase 10 — Token (if it makes sense)

---

## Technical Stack

### Current (Phase 1)
- **Framework:** Next.js 16 with App Router, React 19.2
- **Styling:** Tailwind CSS v4
- **UI:** shadcn/ui components
- **Database:** Supabase (PostgreSQL with RLS)
- **Auth:** Supabase Auth (email/password, will add wallet)
- **Hosting:** Vercel
- **Analytics:** Vercel Analytics

### Planned Additions
- **Wallet:** `@solana/kit`, `@solana/kit-plugin-wallet`, `@solana/react`
- **Solana RPC:** Helius (indexing + webhooks)
- **Multi-chain data:** Reservoir API
- **Marketplace APIs:** Magic Eden, Tensor, OpenSea
- **Search:** Meilisearch (self-hosted) or Algolia
- **Smart contracts:** Anchor framework on Solana
- **MEV protection:** Jito bundles (Solana), Flashbots (ETH)
- **Image CDN:** Cloudflare Images or Vercel Image Optimization
- **Background jobs:** Vercel Cron + Edge Functions
- **Real-time:** Supabase Realtime + Helius WebSockets
- **Mobile:** React Native + Expo (Phase 9)

---

## Key Design Principles

Every feature must pass these tests:

1. Does this benefit holders, not just traders?
2. Does this avoid algorithmic price manipulation?
3. Does this help users see real value?
4. Does this respect royalties and creator economics?
5. Can this work across chains, not just Solana?
6. Does this reinforce the Moonsters brand identity?

### UI/UX Standards
- Mobile-first responsive design
- Maximum 3-5 colors per page
- 0.5rem standard border radius (rounded-lg)
- Tabular nums for all financial figures
- Sparklines/mini-charts wherever floor or volume is shown
- Source attribution on every aggregated listing
- Optimistic UI updates with toast feedback
- Loading skeletons with shimmer for all data-driven sections
- Empty states use Moonsters mascot for personality

---

## Competitive Differentiation Summary

### vs. Magic Eden
- No bot pools (their MMM compresses floors)
- Better creator launchpad than ME Launchpad
- Aggregated liquidity from ME itself + others (we route to best price)
- Stronger brand identity (Moonsters mascot)
- Multi-chain from earlier in roadmap

### vs. Tensor
- No TensorSwap AMM bot extraction
- Better UX for casual collectors (Tensor optimizes only for traders)
- Creator tools (Tensor barely has creator features)
- Multi-chain (Tensor is Solana-only)

### vs. OpenSea
- 10x better speed (OpenSea is famously slow)
- Solana-native from day one
- Better trader tools (OpenSea Pro is acquired Gem, feels bolted-on)
- Aggregation built-in, not a separate product

### vs. LaunchMyNFT
- Better creator launchpad with secondary marketplace built-in
- Verified creator program
- Built-in audience (LaunchMyNFT is just a deployer, no marketplace)

### Unique to Moonseum
- Hybrid aggregator + native marketplace from day one
- "Fair Floor" volume-weighted pricing display
- "No bot pools" positioning (marketing pillar)
- Mascot brand identity
- Trait-based offers system as AMM replacement
- Sealed-bid auctions for high-value items

---

*Document version 1.0 — Last updated April 26, 2026*
