Integra PRD: 21-meme-dex

21-meme-dex.md

Meme DEX

Owner: Nawar | Ship: Week 3 | Est: 0.5d | Chain: integra-testnet-1 (EVM 26218) URL: meme-dex.integralayer.com

Overview

A memecoin trading platform where users create and trade tokens tied to famous buildings worldwide. Tokens like $BURJKHALIFA, $EMPIRE, $SKYHARB, and $TRUMPTOWER are priced purely by social speculation using bonding curve mechanics. No fundamentals, no utility — just vibes and volume. Tying memecoins to iconic buildings gives a unique hook that drives organic sharing and onboards non-DeFi users with massive transaction volume.

Features

• Building Token Creation — Launch a new memecoin tied to any building with a name, ticker, and image in one click
• Bonding Curve Trading — Buy tokens on an ascending curve (price rises with each purchase), sell back to the curve to take profit
• Trending Page — Top building tokens ranked by 24h volume, price change, and market cap with real-time updates
• Token Detail Page — Price chart, recent trades feed, market cap, holder count, and social sharing for each token
• Social Feed — Live activity stream showing recent buys, sells, and new token launches across the platform
• Search & Discovery — Search buildings by name, location, or ticker symbol
• Share to Pump — One-click share to Twitter/Telegram with pre-filled token link and price data
• No Admin Keys — Each bonding curve is permissionless and non-ruggable by design
• Building Metadata — Static metadata (name, image, location, description) sourced from public image libraries
• Mobile-Responsive — Full trading experience on mobile devices
• Holder Leaderboard — Top holders per token and top creators by total volume generated
• Referral Tracking — Verified referral clicks for XP rewards when sharing token links

Functions

• createToken — Deploy a new bonding curve instance for a building with name, symbol, and image URI
• buy — Buy tokens on the curve, price increases with supply
• sell — Sell tokens back to the curve, price decreases with supply
• getPrice — Current spot price for a given token
• getMarketCap — Total value locked in a token's bonding curve

User Flow

1. Connect via Web3Auth (social login or wallet)
2. Land on trending page showing top building tokens by volume
3. Search for a building or click "Create Token" to launch a new memecoin
4. Buy tokens — watch the price rise on the bonding curve
5. Monitor price chart and social feed on the token detail page
6. Sell tokens back to the curve to take profit
7. Share token links on Twitter/Telegram to drive volume

Deliverables

• Bonding curve factory contract deployed on integra-testnet-1 (one curve per building)
• Token creation flow with name, ticker, and image
• Trending page with sortable rankings (volume, price, market cap)
• Token detail page with price chart and trade history
• Buy/sell interface with real-time price updates
• Social activity feed (recent trades, new launches)
• Search and filtering by building name/location
• Share functionality with referral tracking
• Mobile-responsive layout
• Static building metadata catalog

Integration Points

• Depends on: BondingCurve.sol (existing — extended with factory pattern), IRL token for all trades, Web3Auth for authentication
• Used by: Ecosystem Hub (category: Trading), XP system for trade activity
• Explorer: Integra Explorer

XP Rewards

Action	Points
Create a new building token	50 XP
Execute a trade (buy or sell)	10 XP
Token you created reaches 10 unique holders	100 XP
Share a token link (verified referral click)	25 XP

Success Metrics

Metric	Target
Building tokens created	200+ in first month
Total trades	5,000+ transactions
Unique traders	500+ wallets
Tokens with 10+ holders	50+ tokens
Social shares generating clicks	300+ referrals
Daily active traders	50+ on peak days