Kiosk

​

Event Discovery

​

Event Listings

• Event banner (or generated placeholder)
• Event title and creator information
• Performance category with visual icons
• Event timing (date, duration, time until start)
• Pricing (ticket price, current tip total)
• Capacity (tickets sold vs. available)

​

Filtering & Search

• Standup Comedy
• Poetry Slam
• Performance Art
• Improv
• Live Streaming
• Podcasting

• Text search across event titles and descriptions
• Creator name searching
• Real-time results with highlighting

• Date (Earliest): Upcoming events first
• Date (Latest): Future events first
• Price (Low to High): Most affordable first
• Price (High to Low): Premium events first

• Price range slider: Filter by ticket price (0-50 SEI)
• Show past events: View completed events for reference

​

Event Status Indicators

• Upcoming: Scheduled for future, tickets available
• Live: Currently streaming, may still accept viewers
• Completed: Event finished, NFT may be available
• Sold Out: No tickets remaining

​

Ticket Purchase Flow

​

Access Requirements

1. Connect wallet (MetaMask or WalletConnect)
2. Switch to Sei network (automatic prompt if needed)
3. Have sufficient SEI balance for ticket price + gas fees

​

Purchase Process

​

Ticket Verification

1. Mints NFT ticket with unique ID
2. Updates event capacity in real-time
3. Grants access rights to event room and chat
4. Stores ownership on-chain for verification

​

Purchase States

• “Buy Ticket”: Standard purchase flow
• “Sold Out”: No tickets available
• “You Own Ticket”: Already purchased, show room link
• “Event Started”: May still allow late entry
• “Event Ended”: Ticket sales closed

​

Event Detail Views

​

Expanded Event Information

• Full description from creator
• Creator profile information and past events
• Event timeline (creation date, start time, duration)
• Ticket sales progress (sold vs. available)
• Current tip totals (if event is live)
• Community engagement metrics

​

Curation Status

• Curated events: Show curation scope (Planner/Promoter/Producer)
• Optimization suggestions: Enhanced descriptions, pricing, scheduling
• Community engagement: Improved promotional reach

​

Real-time Updates

• Ticket counts decrease as sales occur
• Tip totals increase during live events
• Status changes (upcoming → live → completed)
• Price adjustments if creators modify settings

​

User Account Integration

​

Ticket History

• Owned tickets highlighted across all events
• Past attendance history with event records
• Upcoming events with reminder capabilities
• Creator following for notification preferences

​

Personalization

• Recommended events based on past attendance
• Category preferences from viewing history
• Price range suggestions based on spending patterns
• Creator notifications for followed performers

​

Technical Implementation

​

Event Data Fetching

// Simplified data flow
async function loadEvents() {
  // 1. Get events from EventFactory contract
  const totalEvents = await eventFactory.totalEvents()
  
  // 2. Load each event's details
  for (let i = 0; i < totalEvents; i++) {
    const eventData = await eventFactory.getEvent(i)
    const kioskData = await ticketKiosk.getSalesInfo()
    const metadata = await fetchFromIPFS(eventData.metadataURI)
    
    // 3. Combine on-chain and IPFS data
    const enrichedEvent = {
      ...eventData,
      ...kioskData, 
      ...metadata,
      status: determineEventStatus(eventData)
    }
  }
}

​

Real-time Synchronization

• Contract event listening: Watch for new events and ticket sales
• Periodic polling: Refresh event data every 30 seconds
• User action updates: Immediate state updates after purchases
• WebSocket connections: Real-time tip updates during live events

​

Performance Optimization

• Lazy loading: Load additional events as users scroll
• Image optimization: Responsive images with fallbacks
• Caching: IPFS metadata cached locally
• Pagination: Server-side pagination for historical events

​

Integration Points

​

Room Access

1. Generate room URLs for event access
2. Initialize XMTP chat group membership
3. Enable tipping permissions during live events
4. Provide streaming access to WebRTC endpoints

​

Creator Dashboard

• Their events highlighted with management options
• Real-time analytics for their events
• Revenue tracking across all events
• Audience engagement metrics

​

Curation Workflow

• Automatic detection of events that could benefit from optimization
• Scope recommendations based on event characteristics
• Integration with agent services for enhanced promotion

​

Error Handling

​

Common Issues

• Clear error messages with current balance display
• Gas fee estimation and total cost breakdown
• Links to exchanges or faucets for acquiring SEI

• Automatic network detection and switching prompts
• Fallback RPC endpoints for reliability
• Retry mechanisms for failed transactions

• Real-time capacity updates to prevent overselling
• Waitlist functionality for high-demand events
• Alternative event recommendations

​

Transaction Failures

• Clear error explanations in user-friendly language
• Recovery suggestions (retry, check balance, contact support)
• Transaction hash for blockchain debugging
• Support contact information for persistent issues

​

Mobile Experience

​

Responsive Design

• Touch-optimized card interactions
• Simplified filtering with mobile-friendly controls
• Optimized images for various screen sizes
• Streamlined purchase flow for smaller screens

​

Performance Considerations

• Reduced data usage with compressed images
• Faster loading with lazy-loaded content
• Offline capability for previously viewed events
• Progressive web app features for native-like experience

​

Next Steps

1. Join the event room at scheduled time
2. Participate in pre-event chat to connect with community
3. Prepare for live interaction through tips and messages
4. Share the event to support creators

​

Related Documentation

• Factory - How events are created
• Room - Live event experience
• Performance Types - Understanding categories