Skip to content

WEB_UI_PAGES.md

Latest commit

 

History

History
1016 lines (773 loc) · 34.1 KB

WEB_UI_PAGES.md

File metadata and controls

1016 lines (773 loc) · 34.1 KB

Web UI Pages - Complete 14-Page Reference

📋 Document Summary

What This Document Covers:

  • Complete reference for all 16 HTML pages in the Web UI
  • Page purposes, key features, and keyboard shortcuts
  • API endpoint mappings for each page
  • File locations (HTML + JavaScript controllers)
  • Three-tier memecoin curation workflow (Pending → Approved → Database)

Sections in This Document:

Related Documentation:

Context Tags: #web-ui #pages #keyboard-shortcuts #api-integration #navigation

Navigation & Architecture

Root Path: src/web_ui/static/

Shared Components:

  • Toast Manager: js/shared/toast-manager.js
  • API Client: js/shared/api-client.js
  • Memecoin Browser Base: js/shared/memecoin-browser-base.js
  • Navigation Manager: js/shared/navigation.js
  • Modal Utils: js/shared/modal-utils.js

Page Organization:

  • Dashboard Pages (2): Main hub, Knowledge Base dashboard
  • Memecoin Curation (4): Pending, Approved, Database browser, Generated browser
  • Generation (1): AI-powered RAG generation interface
  • Blockchain Operations (4): Wallets, Funding, Launches, Schedule
  • Analytics (1): Trend tracking
  • Edit Interfaces (3): Edit database, edit generated, edit pending/approved

Dashboard Pages

1. Dashboard Hub

File Location:

  • HTML: src/web_ui/static/index.html
  • JS: None (static navigation hub)

Page Title: Memecoin Management System

Route Path: / or /index.html

Primary Purpose: Central navigation hub providing access to all major system modules with quick-access shortcuts and feature descriptions.

Key Features:

  • Memecoin Knowledge Base Mega-Card with 3 quick-access shortcuts:
    • 🔍 Curate Pending → /pending.html
    • ✅ Browse Approved → /approved.html
    • 🗄️ Browse Database → /database.html
  • 6 Primary Navigation Cards:
    • 🤖 Memecoins Generating → /generated.html
    • 💵 Wallet Management → /wallets.html
    • 💰 Funding Management → /funding.html
    • 🚀 Launches → /launches.html
    • 📊 Trends → /trends.html
  • Visual hierarchy with icons and descriptions
  • Responsive card-based layout

Keyboard Shortcuts: None (navigation only)

API Endpoints Used: None

2. Memecoin Knowledge Base Dashboard

File Location:

  • HTML: src/web_ui/static/meme_dashboard.html
  • JS: src/web_ui/static/js/pages/meme-dashboard.js

Page Title: Memecoin Knowledge Base

Route Path: /meme_dashboard.html

Primary Purpose: Overview dashboard displaying statistics across all three memecoin curation stages (Pending, Approved, Database) with navigation to each stage.

Key Features:

  • Real-time connection status indicator
  • Statistics cards for three curation stages:
    • Pending: Newly detected memecoins awaiting review
    • Approved: Quality tokens ready for database insertion
    • Vector Database: Fully processed with CLIP embeddings
  • Quick navigation buttons to browse each stage
  • Refresh all functionality
  • Informational tooltips about workflow stages

Keyboard Shortcuts: None (dashboard/navigation only)

API Endpoints Used:

  • GET /api/memecoins/pending - Count pending memecoins
  • GET /api/memecoins/approved - Count approved memecoins
  • GET /api/database/memecoins - Count database memecoins

Memecoin Curation Pages

3. Pending Memecoins Browser

File Location:

  • HTML: src/web_ui/static/pending.html
  • JS: src/web_ui/static/js/pages/pending.js

Page Title: Pending Memecoins - Browser Interface

Route Path: /pending.html

Primary Purpose: Review and curate newly detected memecoins from launch monitoring workflow, approving quality tokens for the approved collection.

Key Features:

  • Sequential browser interface with image + metadata display
  • Approve tokens for progression to approved stage
  • Delete unwanted/low-quality tokens
  • Token counter showing position (Meme X of Y)
  • Copy token address to clipboard
  • Connection status indicator
  • Optimistic UI updates (remove from list immediately)

Keyboard Shortcuts:

  • ← / → - Navigate between memecoins
  • Enter - Approve current memecoin
  • Backspace - Delete current memecoin

API Endpoints Used:

  • GET /api/memecoins/pending - Load pending memecoins
  • POST /api/memecoins/approve - Approve memecoin (pending → approved)
  • DELETE /api/memecoins/pending/{token_address} - Delete pending memecoin

Workflow Stage: First stage in three-tier curation (Pending → Approved → Database)

4. Approved Memecoins Browser

File Location:

  • HTML: src/web_ui/static/approved.html
  • JS: src/web_ui/static/js/pages/approved.js

Page Title: Approved Memecoins - Browser Interface

Route Path: /approved.html

Primary Purpose: Browse approved memecoins awaiting database insertion. Tags and captions will be generated during insertion to vector database.

Key Features:

  • Sequential browser interface with image + metadata display
  • Delete option for removing approved tokens
  • Token counter showing position (Meme X of Y)
  • Copy token address to clipboard
  • Back navigation to home
  • Transparent pagination (auto-load next page)

Keyboard Shortcuts:

  • ← / → - Navigate between memecoins
  • Backspace - Delete current memecoin

API Endpoints Used:

  • GET /api/memecoins/approved - Load approved memecoins
  • DELETE /api/memecoins/approved/{token_address} - Delete approved memecoin

Workflow Stage: Second stage in three-tier curation (Pending → Approved → Database)

5. Vector Database Browser

File Location:

  • HTML: src/web_ui/static/database.html
  • JS: src/web_ui/static/js/pages/database.js

Page Title: Memecoin Vector Database Browser

Route Path: /database.html

Primary Purpose: Search and browse the ChromaDB vector database with CLIP embeddings (768-dim). Fully processed memecoins with tags, captions, and semantic search capabilities.

Key Features:

  • Tag-based semantic search with debouncing (500ms)
  • Display comprehensive metadata:
    • Token name, ticker, description
    • 356-category tag system
    • AI-generated image captions (4 types: Entity, Context, Visual, Emotions)
    • Token address with copy button
  • Edit database memecoins (tags + captions only, name/ticker/description immutable)
  • Degrade to approved collection (intentional data loss for reprocessing)
  • Delete from database
  • Search bar with auto-search
  • Token counter with position tracking
  • Return navigation from edit page (preserves page/index state)
  • Transparent pagination

Keyboard Shortcuts:

  • ← / → - Navigate between memecoins
  • / - Focus search input
  • E - Edit current memecoin
  • Escape - Degrade to approved
  • Backspace - Delete current memecoin
  • Ctrl+R - Reload database

API Endpoints Used:

  • GET /api/database/memecoins?search={tags} - Search/load database memecoins
  • POST /api/database/degrade - Degrade to approved collection
  • DELETE /api/database/memecoins/{token_address} - Delete from database

Workflow Stage: Final stage in three-tier curation (Pending → Approved → Database)

Technical Note: Database memecoins have immutable blockchain metadata (name, ticker, description) but editable AI-generated data (tags, captions).

6. Generated Memecoins Browser

File Location:

  • HTML: src/web_ui/static/generated.html
  • JS: src/web_ui/static/js/pages/generated.js

Page Title: Generated Memecoins - Browser Interface

Route Path: /generated.html

Primary Purpose: Browse and manage AI-generated memecoins from RAG workflow, selecting tokens for launch or editing before deployment.

Key Features:

  • Sequential browser with generated memecoins
  • Create new memecoin button (redirects to /generation.html)
  • Select for launch functionality
  • Edit generated memecoin (name, ticker, description, image)
  • Delete generated tokens
  • Refresh gallery button
  • Generation timestamp display
  • Optimistic UI updates
  • Transparent pagination

Keyboard Shortcuts:

  • ← / → - Navigate between memecoins
  • E - Edit current memecoin
  • Backspace - Delete current memecoin

API Endpoints Used:

  • GET /api/generated/memecoins - Load generated memecoins
  • DELETE /api/generated/memecoins/{uuid} - Delete generated memecoin
  • POST /api/generated/select-for-launch - Select for launch

Technical Note: Generated memecoins are fully mutable (pre-blockchain) and stored in res/memecoins/generated/.

Generation Pages

7. Memecoin Generation Interface

File Location:

  • HTML: src/web_ui/static/generation.html
  • JS: src/web_ui/static/js/pages/generation.js

Page Title: Memecoin Generation - RAG Enhanced

Route Path: /generation.html

Primary Purpose: AI-powered memecoin generation using RAG v2 with CLIP-enhanced vector search, leveraging successful examples from approved database.

Key Features:

Input Configuration

  • Text Prompt input (10-500 chars)
    • Tips and examples provided
    • Placeholder suggestions
  • Parameter Configuration:
    • Max Examples (1-10): Number of RAG reference examples to retrieve
    • Generation Count (1-5): Number of variations to generate
    • Temporal Weight (0-100%): Emphasis on recent vs historical examples
  • Advanced Tag Selection (356 categories)
    • Search functionality with debouncing
    • Multi-select with visual indicators
    • Category grouping (19 categories)

Generation Workflow

  • Real-time generation progress tracking with 5 stages:
    1. RAG Validation (20%) - 3s
    2. RAG Retrieval (45%) - 5s
    3. Metadata Generation (70%) - 8s
    4. Image Generation (90%) - 10s
    5. Output Processing (100%) - 2s
  • Cancel generation option
  • Session-based generation tracking

Results Display

  • RAG Examples Display with collection filtering:
    • Entity captions
    • Context captions
    • Visual captions
    • Emotions captions
  • Generated Results Grid with:
    • Image previews
    • Metadata (name, ticker, description)
    • Individual save/regenerate options
  • Save all functionality
  • Generate more variations option

Advanced Features

  • Test mode for UI development (mocked data)
  • Session management with UUID tracking
  • Progress polling with exponential backoff
  • Error handling with retry logic

Keyboard Shortcuts: None (form-based interface)

API Endpoints Used:

  • GET /api/tags/available - Load available tag categories (356 tags)
  • POST /api/generation/start - Start generation workflow
  • GET /api/generation/status/{generation_id} - Poll generation status
  • POST /api/generation/cancel - Cancel ongoing generation
  • POST /api/generated/save-all - Save all generated results

Technical Architecture:

  • RAG System: CLIP-enhanced vector search across 5 collections
  • Weighted Search: 4/3/2/1 weights for Entity/Context/Visual/Emotions
  • Temporal Weighting: Adjustable recency bias for trend sensitivity
  • Generation Pipeline: LiteLLM → Image generation → File storage

Blockchain Operations Pages

8. Wallet Management

File Location:

  • HTML: src/web_ui/static/wallets.html
  • JS: src/web_ui/static/js/pages/wallets.js

Page Title: Wallet Management

Route Path: /wallets.html

Primary Purpose: Monitor and manage Solana wallets for memecoin launch operations, tracking balances and funding status.

Key Features:

Wallet Operations

  • Generate new wallet with private key display (one-time only, secure modal)
  • Import existing wallet by address
  • Remove wallets with confirmation
  • Wallet details modal with token counts

Wallet Table

  • Sortable columns (all columns)
  • Checkbox selection for bulk actions
  • Statistics dashboard:
    • Ready to Launch (funded wallets)
    • Need Funding (unfunded wallets)
    • Total SOL across all wallets

Bulk Operations

  • Schedule funding for selected wallets
  • Refresh balances (blockchain RPC queries)
  • Remove multiple wallets
  • Export wallet data

Table Columns

  • ☑ Checkbox (select for bulk actions)
  • Name (sortable)
  • Address (sortable, copy button, truncated display)
  • SOL Balance (sortable, color-coded: green = funded, red = unfunded)
  • Token Count (sortable)
  • Status (sortable: funded/unfunded)
  • Last Updated (sortable, relative time)
  • Actions (refresh, remove, details)

Keyboard Shortcuts: None (table-based interface)

API Endpoints Used:

  • GET /api/wallets - Load all wallets
  • POST /api/wallets/generate - Generate new wallet
  • POST /api/wallets/import - Import wallet by address
  • DELETE /api/wallets/{address} - Remove wallet
  • POST /api/wallets/refresh - Refresh wallet balances (Solana RPC)
  • POST /api/wallets/bulk-schedule-funding - Schedule funding for selected wallets

Integration: Works with WalletsOrchestrator for Firebase cache and blockchain refresh.

9. Funding Management

File Location:

  • HTML: src/web_ui/static/funding.html
  • JS: src/web_ui/static/js/pages/funding.js

Page Title: Funding Events

Route Path: /funding.html

Primary Purpose: Monitor and manage wallet funding operations with real-time tracking, scheduling, and execution status.

Key Features:

Funding Dashboard

  • Statistics panel:
    • Pending events
    • Completed today
    • Failed events
  • Execution status toggle (Active/Inactive) with visual indicator
  • Plan funding button (opens /plan_funding.html)

Funding Events Table

  • Sortable columns (all columns)
  • Checkbox selection for bulk actions
  • Real-time execution state monitoring
  • Event details modal with full metadata

Bulk Operations

  • Archive selected events
  • Delete selected events
  • Execute selected events
  • Export funding data

Table Columns

  • ☑ Checkbox (select for bulk actions)
  • ID (sortable, unique identifier)
  • Wallet Address (sortable, truncated)
  • Amount (SOL) (sortable)
  • Status (sortable: pending/completed/failed, color-coded)
  • Date (sortable, relative time)
  • Actions (execute, archive, delete, details)

Keyboard Shortcuts: None (table-based interface)

API Endpoints Used:

  • GET /api/funding/events - Load funding events
  • POST /api/funding/schedule - Schedule new funding event
  • POST /api/funding/toggle-execution - Toggle execution state
  • POST /api/funding/execute - Execute funding event immediately
  • DELETE /api/funding/events/{schedule_id} - Delete funding event
  • POST /api/funding/bulk-archive - Archive selected events
  • POST /api/funding/bulk-execute - Execute selected events

Integration: Works with FundingOrchestrator for automated SOL funding with CEX integration.

10. Launch Configurations

File Location:

  • HTML: src/web_ui/static/launches.html
  • JS: src/web_ui/static/js/pages/launches.js

Page Title: Launch Configurations

Route Path: /launches.html

Primary Purpose: Create and manage memecoin launch configurations with wallet setups, SOL amounts, and execution scheduling.

Key Features:

Launch Dashboard

  • Create new launch button (redirects to /plan_launch.html)
  • Statistics panel:
    • Total launches
    • Draft launches (wallets + SOL only)
    • Complete launches (+ memecoin data)
    • Scheduled launches
    • Launched count

Filtering System

  • Launch Type Filters: Draft, Complete
  • Status Filters: Ready, Scheduled, Launching, Launched, Failed, Cancelled
  • Clear filters button

Launch Table

  • Sortable columns (all columns)
  • Checkbox selection for bulk delete
  • Color-coded status indicators
  • Launch/schedule/delete actions

Table Columns

  • ☑ Checkbox (select for bulk actions)
  • Launch Name (sortable)
  • Type (sortable: draft/complete)
  • Status (sortable, color-coded)
  • Dev Wallet (sortable, truncated)
  • Bundle Count (number of bundling wallets)
  • Total SOL (sortable, sum of all wallets)
  • Scheduled (sortable, datetime)
  • Created (sortable, relative time)
  • Actions (view, launch, schedule, delete)

Keyboard Shortcuts: None (table-based interface)

API Endpoints Used:

  • GET /api/launches - Load launch configurations
  • POST /api/launches - Create new launch
  • DELETE /api/launches/{launch_id} - Delete launch
  • POST /api/launches/execute - Execute launch immediately
  • POST /api/launches/schedule - Schedule launch for later
  • POST /api/launches/bulk-delete - Delete selected launches

Integration: Works with LaunchConfigurationOrchestrator for configuration CRUD and scheduling.

11. Plan Launch

File Location:

  • HTML: src/web_ui/static/plan_launch.html
  • JS: src/web_ui/static/js/pages/plan-launch.js

Page Title: Plan Launch

Route Path: /plan_launch.html

Primary Purpose: Configure new launch with developer wallet, bundling wallets, SOL amounts, memecoin selection (for complete launches), and scheduling options.

Key Features:

Launch Type Selection

  • Draft Launch: Wallets + SOL amounts only (no memecoin data)
  • Complete Launch: Draft + memecoin selection

Configuration Sections

1. Basic Configuration

  • Launch name input

2. Developer Wallet

  • Wallet selection dropdown (from Firebase)
  • SOL amount input
  • Wallet details card with balance/status

3. Bundling Wallets

  • Dynamic wallet rows (add/remove)
  • Wallet selection dropdown
  • SOL amount input per wallet
  • Wallet details cards
  • Real-time total SOL calculation

4. Memecoin Selection (Complete Launch Only)

  • Memecoin browser modal with previews
  • Generate new memecoin option (redirects to /generation.html)
  • Selected memecoin preview

5. Scheduling Options

  • Manual: Save for later manual execution
  • Scheduled: Pick specific datetime
  • Immediate: Execute now (complete launches only)

Advanced Features

  • Real-time SOL total calculation
  • Wallet balance validation
  • Preview configuration modal
  • Save as draft functionality
  • Form validation with error messages

Keyboard Shortcuts: None (form-based interface)

API Endpoints Used:

  • GET /api/wallets - Load available wallets for selection
  • GET /api/generated/memecoins - Browse memecoins for complete launch
  • POST /api/launches - Save launch configuration
  • POST /api/launches/draft - Save as draft

Form Validation:

  • Launch name required
  • Developer wallet required
  • SOL amounts must be > 0
  • Memecoin required for complete launches
  • Scheduled datetime must be future

12. Plan Funding

File Location:

  • HTML: src/web_ui/static/plan_funding.html
  • JS: src/web_ui/static/js/pages/plan_funding.js

Page Title: Plan Funding

Route Path: /plan_funding.html

Primary Purpose: Create automated funding schedules with random SOL amounts, random delays, and configurable start times for multiple wallets.

Key Features:

Wallet Selection

  • Wallet selection table with checkboxes
  • Display wallet addresses and current balances
  • Select all / deselect all functionality

Configuration Parameters

  • SOL Amount Range: Dual-range slider
    • Minimum: 0.1 SOL
    • Maximum: 10 SOL
    • Random amount per wallet within range
  • Delay Range: Dual-range slider
    • Minimum: 1 minute
    • Maximum: 120 minutes
    • Random delay between transactions
  • Start Time Options:
    • Immediate: Start now
    • Scheduled: Pick specific datetime

Schedule Preview

  • Generate funding schedule button
  • Preview table with editable rows:
    • Wallet address
    • SOL amount (editable)
    • Scheduled time (editable)
    • Remove option
  • Statistics:
    • Wallet count
    • Total SOL
    • Estimated duration
  • Bulk actions:
    • Reschedule selected
    • Remove selected schedules
  • Regenerate schedule option
  • Confirm & Sync to Firebase button

Keyboard Shortcuts: None (form-based interface)

API Endpoints Used:

  • GET /api/wallets - Load wallets for selection
  • POST /api/funding/generate-schedule - Generate funding schedule
  • POST /api/funding/confirm-schedule - Sync schedule to Firebase
  • DELETE /api/funding/schedule/{schedule_id} - Remove schedule entry
  • PUT /api/funding/schedule/{schedule_id} - Update schedule entry

Integration: Works with FundingOrchestrator for schedule execution and Firebase persistence.

Analytics Pages

13. Trend Tracking

File Location:

  • HTML: src/web_ui/static/trends.html
  • JS: src/web_ui/static/js/pages/trends.js

Page Title: Trend Tracking

Route Path: /trends.html

Primary Purpose: Monitor emerging memecoin trends in real-time with AI-powered classification, tracking potential and confirmed trends with prominence scoring.

Key Features:

Dashboard Layout

  • Two-column layout:
    • Left: Potential Trends (early-stage monitoring)
    • Right: Confirmed Trends (validated trends)
  • Auto-refresh every 10 seconds
  • Detection status toggle (Active/Inactive) with visual indicator
  • Manual refresh button

Statistics Panel

  • Total Trends
  • Potential count
  • Confirmed count
  • Hot Trends (high-prominence confirmed trends)

Trend Cards

  • Trend name/description
  • Prominence score (0-100)
  • Detection timestamp
  • Token count
  • State indicator (Potential/Confirmed/Hot)
  • Click to view details modal

Trend Details Modal

  • Full trend metadata
  • Associated tokens list
  • Prominence history
  • Classification reasons

Keyboard Shortcuts: None (auto-refreshing dashboard)

API Endpoints Used:

  • GET /api/trends - Load all trends
  • POST /api/trends/toggle-detection - Toggle detection state
  • GET /api/trends/{trend_id} - Get trend details

Integration: Works with TrendOrchestrator for reactive Firebase watchers and in-memory cache.

Trend States:

  • Potential: Early-stage trends being monitored (< threshold)
  • Confirmed: Validated trends with sufficient data (≥ threshold)
  • Hot: High-prominence confirmed trends (top 20% of confirmed)

Technical Note: Uses Firebase reactive watchers for real-time updates without manual polling.

Edit Interface Pages

14. Edit Memecoin (Pending/Approved)

File Location:

  • HTML: src/web_ui/static/edit_meme.html
  • JS: src/web_ui/static/js/pages/edit-meme.js

Page Title: Edit Memecoin

Route Path: /edit_meme.html?token_address={address}

Primary Purpose: Edit basic metadata for pending or approved memecoins before database insertion.

Key Features:

Layout

  • Left Side: Image preview
  • Right Side: Editable form

Editable Fields

  • Token Name (required, max 50 chars)
    • Character counter
    • Real-time validation
  • Ticker (required, 3-10 chars, alphanumeric, uppercase)
    • Auto-uppercase transformation
    • Character counter
  • Description (required, max 1000 chars)
    • Multi-line textarea
    • Character counter

Advanced Features (Coming Soon)

  • AI Enhancement Prompt (mocked - future feature)
  • Tags editing (currently read-only)

Actions

  • Save button (validates + saves)
  • Cancel button (returns to previous page)

Keyboard Shortcuts: None (form-based)

API Endpoints Used:

  • GET /api/memecoins/{token_address} - Load memecoin data
  • PUT /api/memecoins/{token_address} - Save changes

Validation Rules:

  • Name: Required, max 50 chars
  • Ticker: Required, 3-10 chars, alphanumeric, uppercase
  • Description: Required, max 1000 chars

Technical Note: Pre-blockchain editing (fully mutable). Used for pending/approved stages.

15. Edit Generated Memecoin

File Location:

  • HTML: src/web_ui/static/edit_generated_meme.html
  • JS: src/web_ui/static/js/pages/edit_generated_meme.js

Page Title: Edit Generated Memecoin

Route Path: /edit_generated_meme.html?uuid={uuid}

Primary Purpose: Edit AI-generated memecoins with optional AI assistance for intelligent regeneration of name/ticker/description or image.

Key Features:

Layout

  • Left Side: Image preview with generation info
  • Right Side: Editable form

Editable Fields

  • Name (required, max 50 chars) - Character counter
  • Ticker (required, 3-10 chars, alphanumeric, uppercase) - Character counter
  • Description (required, max 1000 chars) - Character counter

AI-Powered Editing

  • Optional AI Feedback input (0-2000 chars)
    • Natural language instructions
    • Examples: "Make it more playful", "Change entity to a cat"
  • Smart Action Button:
    • "Update Memecoin" (no AI feedback = manual save)
    • "Request AI Edit" (with AI feedback = generate proposal)

Proposal Review Section (if AI feedback provided)

  • Display proposed changes
  • Edit proposed changes before acceptance
  • Image regeneration notice (when image changes detected)
  • Accept/Reject proposal workflow

Workflow

  1. Load memecoin → Edit fields manually
  2. (Optional) Provide AI feedback → Generate proposal
  3. Review proposal → Edit proposed changes if needed
  4. Accept → Apply changes + regenerate image if needed
  5. Reject → Discard proposal

Keyboard Shortcuts: None (form-based)

API Endpoints Used:

  • GET /api/generated/memecoins/{uuid} - Load generated memecoin
  • PUT /api/generated/memecoins/{uuid} - Save manual edits
  • POST /api/generated/edit-plan - Request AI edit with feedback
  • POST /api/generated/accept-edit - Accept and apply AI proposal
  • POST /api/generated/reject-edit - Reject AI proposal

Technical Note: Pre-blockchain editing (fully mutable). Supports AI-assisted editing with LLM-powered proposal generation.

16. Edit Database Memecoin

File Location:

  • HTML: src/web_ui/static/edit_database_meme.html
  • JS: src/web_ui/static/js/pages/edit_database_meme.js

Page Title: Edit Database Memecoin

Route Path: /edit_database_meme.html?token_address={address}&return_page={page}&return_index={index}

Primary Purpose: Edit tags and captions for database memecoins. Name/ticker/description are immutable (blockchain-based).

Key Features:

Immutability Warning

  • Banner notification: "This memecoin's on-chain metadata (name, ticker, description) cannot be edited. Only tags and captions can be modified."

Layout

  • Left Side: Image preview
  • Right Side: Form with immutable + editable fields

Immutable Fields (Read-Only, Grayed Out)

  • 🔒 Name: Display only, no editing
  • 🔒 Ticker: Display only, no editing
  • 🔒 Description: Display only, no editing

Editable Fields

  • ✅ Tags (comma-separated)
    • Full tag editing with validation
  • ✅ Entity Caption (AI-generated, editable)
    • Regenerates CLIP embeddings on change
  • ✅ Context Caption (AI-generated, editable)
    • Regenerates CLIP embeddings on change
  • ✅ Visual Caption (AI-generated, editable)
    • Regenerates CLIP embeddings on change
  • ✅ Emotions Caption (AI-generated, editable)
    • Regenerates CLIP embeddings on change

AI-Powered Editing

  • Optional AI Feedback for targeted edits
  • Proposal review workflow (similar to generated edit)
  • Caption regeneration notice (CLIP embeddings will regenerate)

Navigation

  • Return to previous page with state preservation
  • Query params: return_page (page number), return_index (item index)

Keyboard Shortcuts: None (form-based)

API Endpoints Used:

  • GET /api/database/memecoins/{token_address} - Load database memecoin
  • PUT /api/database/memecoins/{token_address} - Save manual edits (tags + captions)
  • POST /api/database/edit-plan - Request AI edit with feedback
  • POST /api/database/accept-edit - Accept and apply AI proposal
  • POST /api/database/reject-edit - Reject AI proposal

Technical Note: Post-blockchain editing (partial mutability). Name/ticker/description immutable due to blockchain metadata. Caption changes trigger CLIP embedding regeneration across 5 collections (Entity, Context, Visual, Emotions, Image).

Keyboard Shortcuts Reference

Pending Browser (/pending.html)

Key Action Description
← / → Navigate Previous/Next memecoin
Enter Approve Move to approved collection
Backspace Delete Remove from pending

Approved Browser (/approved.html)

Key Action Description
← / → Navigate Previous/Next memecoin
Backspace Delete Remove from approved

Database Browser (/database.html)

Key Action Description
← / → Navigate Previous/Next memecoin
/ Focus Search Jump to search input
E Edit Open edit interface
Escape Degrade Move to approved collection
Backspace Delete Remove from database
Ctrl+R Reload Refresh database

Generated Browser (/generated.html)

Key Action Description
← / → Navigate Previous/Next memecoin
E Edit Open edit interface
Backspace Delete Remove generated memecoin

API Endpoints Summary

Memecoin Curation

Method Endpoint Purpose Used By
GET /api/memecoins/pending Load pending memecoins Pending browser, Dashboard
GET /api/memecoins/approved Load approved memecoins Approved browser, Dashboard
POST /api/memecoins/approve Approve pending → approved Pending browser
DELETE /api/memecoins/pending/{token_address} Delete pending Pending browser
DELETE /api/memecoins/approved/{token_address} Delete approved Approved browser

Vector Database

Method Endpoint Purpose Used By
GET /api/database/memecoins?search={tags} Search/load database Database browser
GET /api/database/memecoins Count database Dashboard
POST /api/database/degrade Degrade database → approved Database browser
DELETE /api/database/memecoins/{token_address} Delete from database Database browser
PUT /api/database/memecoins/{token_address} Edit tags/captions Edit database meme
POST /api/database/edit-plan AI edit proposal Edit database meme
POST /api/database/accept-edit Accept AI proposal Edit database meme

Generation

Method Endpoint Purpose Used By
GET /api/tags/available Load tag categories Generation
POST /api/generation/start Start RAG generation Generation
GET /api/generation/status/{id} Poll generation status Generation
POST /api/generation/cancel Cancel generation Generation
GET /api/generated/memecoins Load generated memecoins Generated browser, Plan launch
DELETE /api/generated/memecoins/{uuid} Delete generated Generated browser
PUT /api/generated/memecoins/{uuid} Edit generated Edit generated meme
POST /api/generated/edit-plan AI edit proposal Edit generated meme
POST /api/generated/accept-edit Accept AI proposal Edit generated meme
POST /api/generated/save-all Save all results Generation

Wallet & Funding

Method Endpoint Purpose Used By
GET /api/wallets Load wallets Wallets, Schedule, Plan launch
POST /api/wallets/generate Generate new wallet Wallets
POST /api/wallets/import Import wallet Wallets
DELETE /api/wallets/{address} Remove wallet Wallets
POST /api/wallets/refresh Refresh balances Wallets
POST /api/wallets/bulk-schedule-funding Schedule funding Wallets
GET /api/funding/events Load funding events Funding
POST /api/funding/generate-schedule Generate schedule Schedule
POST /api/funding/confirm-schedule Sync to Firebase Schedule
POST /api/funding/toggle-execution Toggle execution Funding
POST /api/funding/execute Execute funding Funding

Launches

Method Endpoint Purpose Used By
GET /api/launches Load launch configs Launches
POST /api/launches Create launch Plan launch
DELETE /api/launches/{launch_id} Delete launch Launches
POST /api/launches/execute Execute launch Launches
POST /api/launches/schedule Schedule launch Launches
POST /api/launches/bulk-delete Delete selected Launches

Trends

Method Endpoint Purpose Used By
GET /api/trends Load trends Trends
POST /api/trends/toggle-detection Toggle detection Trends
GET /api/trends/{trend_id} Get trend details Trends

Page-to-Controller Mapping

HTML File JavaScript Controller Shared Base
index.html None N/A
meme_dashboard.html js/pages/meme-dashboard.js N/A
pending.html js/pages/pending.js memecoin-browser-base.js
approved.html js/pages/approved.js memecoin-browser-base.js
database.html js/pages/database.js memecoin-browser-base.js
generated.html js/pages/generated.js memecoin-browser-base.js
generation.html js/pages/generation.js N/A
wallets.html js/pages/wallets.js N/A
funding.html js/pages/funding.js N/A
launches.html js/pages/launches.js N/A
plan_launch.html js/pages/plan-launch.js N/A
plan_funding.html js/pages/plan_funding.js N/A
trends.html js/pages/trends.js N/A
edit_meme.html js/pages/edit-meme.js N/A
edit_generated_meme.html js/pages/edit_generated_meme.js N/A
edit_database_meme.html js/pages/edit_database_meme.js N/A

Document Status: Complete Last Updated: October 15, 2025 Architecture Version: 16-page Web UI with memecoin browser pattern